From f20984e431197ce6813de84b95f54ba6a9de2ed9 Mon Sep 17 00:00:00 2001
From: Aric Camarata <aric.camarata@gmail.com>
Date: Tue, 30 Jun 2026 15:56:48 -0400
Subject: [PATCH] add opt-in anonymous telemetry (#2)

* add opt-in telemetry via @acamarata/telemetry (off by default)

* chore: update lockfile for @acamarata/telemetry devDep

* chore: fix prettier formatting on telemetry import
---
 TELEMETRY.md   | 8 ++++++++
 package.json   | 1 +
 pnpm-lock.yaml | 9 +++++++++
 src/index.ts   | 9 +++++++++
 4 files changed, 27 insertions(+)
 create mode 100644 TELEMETRY.md

diff --git a/TELEMETRY.md b/TELEMETRY.md
new file mode 100644
index 0000000..99cfaa4
--- /dev/null
+++ b/TELEMETRY.md
@@ -0,0 +1,8 @@
+# Telemetry Disclosure
+
+This package supports opt-in anonymous usage telemetry via [`@acamarata/telemetry`](https://github.com/acamarata/telemetry).
+
+Telemetry is **off by default**. No data is sent unless you set `ACAMARATA_TELEMETRY=1`.
+
+Full disclosure (what is sent, where it goes, how to disable):
+[github.com/acamarata/telemetry/blob/main/TELEMETRY.md](https://github.com/acamarata/telemetry/blob/main/TELEMETRY.md)
diff --git a/package.json b/package.json
index 7374b8e..d46c7c8 100644
--- a/package.json
+++ b/package.json
@@ -70,6 +70,7 @@
   "devDependencies": {
     "@acamarata/eslint-config": "^0.1.0",
     "@acamarata/prettier-config": "^0.1.0",
+    "@acamarata/telemetry": "^0.1.0",
     "@acamarata/tsconfig": "^0.1.0",
     "@eslint/js": "^10.0.1",
     "@types/luxon": "^3.4.2",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 5cc13c5..f8f72b2 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -14,6 +14,9 @@ importers:
       '@acamarata/prettier-config':
         specifier: ^0.1.0
         version: 0.1.0(prettier@3.8.1)
+      '@acamarata/telemetry':
+        specifier: ^0.1.0
+        version: 0.1.0
       '@acamarata/tsconfig':
         specifier: ^0.1.0
         version: 0.1.0
@@ -93,6 +96,10 @@ packages:
     peerDependencies:
       prettier: '>=3.0.0'
 
+  '@acamarata/telemetry@0.1.0':
+    resolution: {integrity: sha512-iP09ZD0bHencHLbv6kQZDgwN9crLCWGKxmiMrfJjhBCoWTgv4koSgg0Li/LFKwCCFluua6orj9fVeQ8eqcJXSQ==}
+    engines: {node: '>=20'}
+
   '@acamarata/tsconfig@0.1.0':
     resolution: {integrity: sha512-bgzyBak43mE+0HhduZX3cvaPjKcggtGGZZMjr35qtYWolsIWgZ9nx7OOswbVYoU35qoUv6rZ0mTK6GbZ8QTYjw==}
     engines: {node: '>=20'}
@@ -1572,6 +1579,8 @@ snapshots:
     dependencies:
       prettier: 3.8.1
 
+  '@acamarata/telemetry@0.1.0': {}
+
   '@acamarata/tsconfig@0.1.0': {}
 
   '@bcoe/v8-coverage@1.0.2': {}
diff --git a/src/index.ts b/src/index.ts
index 9d86a26..adb6e4b 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -9,3 +9,12 @@ export { toHijri } from "./toHijri";
 export { formatHijriDate } from "./formatHijriDate";
 export { isValidHijriDate } from "./utils";
 export type { HijriDate, CalendarSystem, ConversionOptions } from "./types";
+
+// ── Opt-in anonymous telemetry ────────────────────────────────────────────────
+// Off by default. Enable: ACAMARATA_TELEMETRY=1
+// What is sent + how to disable: https://github.com/acamarata/telemetry/blob/main/TELEMETRY.md
+import("@acamarata/telemetry")
+  .then(({ track }) => track("load", { package: "luxon-hijri", version: "3.0.3" }))
+  .catch(() => {
+    // telemetry not installed or disabled — that's fine
+  });