@proappstore/sdk 1.7.0 → 1.9.0

package/dist/usage.js

@@ -0,0 +1,205 @@
+/**
+ * Usage telemetry — heartbeats `POST /v1/usage/ping` while the tab is visible.
+ *
+ * Auto-started by `initPro()` unless `usage.auto === false` in the options.
+ * The collected (app, user, day) counts drive the usage-proportional creator
+ * payouts described in proappstore.online/pricing.
+ *
+ * Design notes:
+ *
+ * - **Visible-time only.** We start a stopwatch when the tab is visible and
+ *   pause on `visibilitychange`. A tab that's been hidden for 90s contributes
+ *   0 seconds for that interval.
+ * - **Browser-only.** All methods no-op when `document` or `window` is
+ *   undefined so the import is SSR-safe.
+ * - **Silent failures.** Telemetry must never break an app. Every network
+ *   path catches + ignores errors.
+ * - **Page-close flush.** On `pagehide` we send a final ping with the
+ *   residual elapsed seconds via `navigator.sendBeacon` (survives unload)
+ *   falling back to `fetch(..., { keepalive: true })`.
+ */
+const HEARTBEAT_MS = 60_000;
+const MAX_DELTA_SECONDS = 90;
+function hasBrowser() {
+    return typeof document !== 'undefined' && typeof window !== 'undefined';
+}
+export class Usage {
+    appId;
+    apiBase;
+    auth;
+    running = false;
+    timer = null;
+    visibleSince = null;
+    /** Accumulated visible-time since the last successful ping, in milliseconds. */
+    accruedMs = 0;
+    pendingApiCalls = 0;
+    onVisibility = null;
+    onPageHide = null;
+    constructor(appId, apiBase, auth) {
+        this.appId = appId;
+        this.apiBase = apiBase;
+        this.auth = auth;
+    }
+    /** Begin heartbeat reporting. Idempotent — calling twice is a no-op. */
+    start() {
+        if (this.running)
+            return;
+        if (!hasBrowser())
+            return;
+        this.running = true;
+        // Initial visibility snapshot.
+        if (document.visibilityState === 'visible') {
+            this.visibleSince = performance.now();
+        }
+        this.onVisibility = () => {
+            if (document.visibilityState === 'visible') {
+                if (this.visibleSince == null)
+                    this.visibleSince = performance.now();
+            }
+            else {
+                this.bankVisible();
+            }
+        };
+        document.addEventListener('visibilitychange', this.onVisibility);
+        this.onPageHide = () => {
+            this.flush();
+        };
+        window.addEventListener('pagehide', this.onPageHide);
+        this.timer = setInterval(() => {
+            this.tick().catch(() => { });
+        }, HEARTBEAT_MS);
+    }
+    /** Stop heartbeats. Idempotent. Doesn't flush; call `flush()` if you need to. */
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (hasBrowser()) {
+            if (this.onVisibility)
+                document.removeEventListener('visibilitychange', this.onVisibility);
+            if (this.onPageHide)
+                window.removeEventListener('pagehide', this.onPageHide);
+        }
+        this.onVisibility = null;
+        this.onPageHide = null;
+        this.visibleSince = null;
+        this.accruedMs = 0;
+        this.pendingApiCalls = 0;
+    }
+    /**
+     * Record API calls. Bumps a local counter that piggybacks on the next
+     * heartbeat. Cheap to call from hot paths — no network until the next tick.
+     */
+    recordApiCall(n = 1) {
+        if (!Number.isFinite(n) || n <= 0)
+            return;
+        this.pendingApiCalls += Math.floor(n);
+    }
+    /**
+     * Send a final ping (intended for page-close paths). Best-effort,
+     * fire-and-forget. Uses sendBeacon when available so the request survives
+     * unload; falls back to keepalive fetch otherwise.
+     */
+    flush() {
+        if (!hasBrowser())
+            return;
+        this.bankVisible();
+        const seconds = this.drainSeconds();
+        const apiCalls = this.drainApiCalls();
+        if (seconds === 0 && apiCalls === 0)
+            return;
+        this.send(seconds, apiCalls, /* keepalive */ true);
+    }
+    // ── internal ──────────────────────────────────────────────────────────────
+    /** Add any in-progress visible-time to the running accrual. */
+    bankVisible() {
+        if (this.visibleSince == null)
+            return;
+        const now = performance.now();
+        this.accruedMs += Math.max(0, now - this.visibleSince);
+        this.visibleSince = null;
+    }
+    /** Round accrued ms to whole seconds, clamp to MAX_DELTA_SECONDS, return + reset. */
+    drainSeconds() {
+        const whole = Math.floor(this.accruedMs / 1000);
+        if (whole <= 0)
+            return 0;
+        const sent = Math.min(MAX_DELTA_SECONDS, whole);
+        this.accruedMs -= sent * 1000;
+        // Cap residual so a long-hidden flush after a long visible run doesn't
+        // ride along on the next ping forever.
+        if (this.accruedMs < 0)
+            this.accruedMs = 0;
+        return sent;
+    }
+    drainApiCalls() {
+        const n = this.pendingApiCalls;
+        this.pendingApiCalls = 0;
+        return n;
+    }
+    async tick() {
+        this.bankVisible();
+        if (document.visibilityState === 'visible') {
+            this.visibleSince = performance.now();
+        }
+        const seconds = this.drainSeconds();
+        const apiCalls = this.drainApiCalls();
+        if (seconds === 0 && apiCalls === 0)
+            return;
+        if (!this.auth.token) {
+            // Re-pocket the work — the user may sign in later and we'd like the
+            // accrued time to count from then. Note: a session-token signin BEFORE
+            // any visible time was banked won't have anything to attribute, and
+            // that's fine — anonymous usage isn't part of the payout math anyway.
+            this.accruedMs += seconds * 1000;
+            this.pendingApiCalls += apiCalls;
+            return;
+        }
+        await this.send(seconds, apiCalls, /* keepalive */ false);
+    }
+    async send(seconds, apiCalls, keepalive) {
+        const token = this.auth.token;
+        if (!token)
+            return;
+        const body = JSON.stringify({
+            appId: this.appId,
+            deltaSeconds: seconds,
+            deltaApiCalls: apiCalls,
+        });
+        const url = `${this.apiBase}/v1/usage/ping`;
+        // Prefer sendBeacon for keepalive (unload survivor) paths. sendBeacon
+        // doesn't allow setting an Authorization header, so we encode the token
+        // into the URL only for keepalive — server accepts it as a fallback.
+        // (If your server doesn't support that, fall through to keepalive fetch.)
+        if (keepalive && typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
+            try {
+                const blob = new Blob([body], { type: 'application/json' });
+                const ok = navigator.sendBeacon(url, blob);
+                if (ok)
+                    return;
+            }
+            catch {
+                // fall through
+            }
+        }
+        try {
+            await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${token}`,
+                },
+                body,
+                keepalive,
+            });
+        }
+        catch {
+            // Telemetry never breaks an app.
+        }
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAWH,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,SAAS,UAAU;IACjB,OAAO,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,MAAM,KAAK,WAAW,CAAC;AAC1E,CAAC;AAED,MAAM,OAAO,KAAK;IAWG;IACA;IACA;IAZX,OAAO,GAAG,KAAK,CAAC;IAChB,KAAK,GAA0C,IAAI,CAAC;IACpD,YAAY,GAAkB,IAAI,CAAC;IAC3C,gFAAgF;IACxE,SAAS,GAAG,CAAC,CAAC;IACd,eAAe,GAAG,CAAC,CAAC;IACpB,YAAY,GAAwB,IAAI,CAAC;IACzC,UAAU,GAAwB,IAAI,CAAC;IAE/C,YACmB,KAAa,EACb,OAAe,EACf,IAAc;QAFd,UAAK,GAAL,KAAK,CAAQ;QACb,YAAO,GAAP,OAAO,CAAQ;QACf,SAAI,GAAJ,IAAI,CAAU;IAC9B,CAAC;IAEJ,wEAAwE;IACxE,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,UAAU,EAAE;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,+BAA+B;QAC/B,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC3C,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,GAAG,EAAE;YACvB,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;gBAC3C,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;oBAAE,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACvE,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,CAAC;QACH,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAEjE,IAAI,CAAC,UAAU,GAAG,GAAG,EAAE;YACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAErD,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9B,CAAC,EAAE,YAAY,CAAC,CAAC;IACnB,CAAC;IAED,iFAAiF;IACjF,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,IAAI,IAAI,CAAC,YAAY;gBAAE,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3F,IAAI,IAAI,CAAC,UAAU;gBAAE,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,IAAY,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAC1C,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,EAAE;YAAE,OAAO;QAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACtC,IAAI,OAAO,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,6EAA6E;IAE7E,+DAA+D;IACvD,WAAW;QACjB,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;YAAE,OAAO;QACtC,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,qFAAqF;IAC7E,YAAY;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;QAChD,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,IAAI,IAAI,GAAG,IAAI,CAAC;QAC9B,uEAAuE;QACvE,uCAAuC;QACvC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC;YAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,aAAa;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QACzB,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC3C,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACtC,IAAI,OAAO,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,oEAAoE;YACpE,uEAAuE;YACvE,oEAAoE;YACpE,sEAAsE;YACtE,IAAI,CAAC,SAAS,IAAI,OAAO,GAAG,IAAI,CAAC;YACjC,IAAI,CAAC,eAAe,IAAI,QAAQ,CAAC;YACjC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,QAAgB,EAAE,SAAkB;QACtE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,OAAO;YACrB,aAAa,EAAE,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,gBAAgB,CAAC;QAE5C,sEAAsE;QACtE,wEAAwE;QACxE,qEAAqE;QACrE,0EAA0E;QAC1E,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAChG,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC5D,MAAM,EAAE,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC3C,IAAI,EAAE;oBAAE,OAAO;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe;YACjB,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,GAAG,EAAE;gBACf,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,KAAK,EAAE;iBACjC;gBACD,IAAI;gBACJ,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proappstore/sdk",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "Browser SDK for paid apps on proappstore.online — subscriptions, license keys, premium modules.",
   "license": "MIT",
   "type": "module",
@@ -29,12 +29,8 @@
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit"
-  },
   "dependencies": {
-    "@freeappstore/sdk": "^0.6.0"
+    "@freeappstore/sdk": "^0.7.1"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
@@ -49,5 +45,9 @@
     "react": "^19.0.0",
     "typescript": "^5.7.0"
   },
-  "sideEffects": false
-}
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}