@proappstore/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { SubscriptionApi } from './subscription.js';
+import { LicenseApi } from './license.js';
+import type { ProInitOptions } from './types.js';
+export type { ProInitOptions, Subscription, SubscriptionStatus, CheckoutRequest, LicenseInfo, } from './types.js';
+export declare class ProAppStore {
+    readonly subscription: SubscriptionApi;
+    readonly license: LicenseApi;
+    constructor(opts: ProInitOptions);
+}
+export declare function initPro(opts: ProInitOptions): ProAppStore;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAW;IACtB,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;gBAEjB,IAAI,EAAE,cAAc;CAOjC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CAEzD"}

package/dist/index.js

@@ -0,0 +1,16 @@
+import { SubscriptionApi } from './subscription.js';
+import { LicenseApi } from './license.js';
+export class ProAppStore {
+    subscription;
+    license;
+    constructor(opts) {
+        const apiBase = opts.apiBase ?? 'https://api.proappstore.online';
+        const tokenFn = typeof opts.authToken === 'function' ? opts.authToken : () => opts.authToken;
+        this.subscription = new SubscriptionApi(opts.appId, apiBase, tokenFn);
+        this.license = new LicenseApi(opts.appId, apiBase, tokenFn);
+    }
+}
+export function initPro(opts) {
+    return new ProAppStore(opts);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAW1C,MAAM,OAAO,WAAW;IACb,YAAY,CAAkB;IAC9B,OAAO,CAAa;IAE7B,YAAY,IAAoB;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,gCAAgC,CAAC;QACjE,MAAM,OAAO,GACX,OAAO,IAAI,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAmB,CAAC;QACzF,IAAI,CAAC,YAAY,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,MAAM,UAAU,OAAO,CAAC,IAAoB;IAC1C,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/license.d.ts

@@ -0,0 +1,15 @@
+import type { LicenseInfo } from './types.js';
+export declare class LicenseApi {
+    private readonly appId;
+    private readonly apiBase;
+    private readonly token;
+    constructor(appId: string, apiBase: string, token: () => string | null);
+    /** Returns the license info for the signed-in user, or null. */
+    current(): Promise<LicenseInfo | null>;
+    /**
+     * Validate an arbitrary license key against the server. Useful for cases
+     * where the key is delivered out-of-band (email, manual entry).
+     */
+    validate(key: string): Promise<boolean>;
+}
+//# sourceMappingURL=license.d.ts.map

package/dist/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,MAAM,GAAG,IAAI;IAG7C,gEAAgE;IAC1D,OAAO,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAY5C;;;OAGG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAU9C"}

package/dist/license.js

@@ -0,0 +1,38 @@
+export class LicenseApi {
+    appId;
+    apiBase;
+    token;
+    constructor(appId, apiBase, token) {
+        this.appId = appId;
+        this.apiBase = apiBase;
+        this.token = token;
+    }
+    /** Returns the license info for the signed-in user, or null. */
+    async current() {
+        const token = this.token();
+        if (!token)
+            return null;
+        const res = await fetch(new URL(`/v1/apps/${encodeURIComponent(this.appId)}/license`, this.apiBase), { headers: { Authorization: `Bearer ${token}` } });
+        if (res.status === 404)
+            return null;
+        if (!res.ok)
+            throw new Error(`license.current failed: ${res.status}`);
+        return (await res.json());
+    }
+    /**
+     * Validate an arbitrary license key against the server. Useful for cases
+     * where the key is delivered out-of-band (email, manual entry).
+     */
+    async validate(key) {
+        const res = await fetch(new URL('/v1/license/validate', this.apiBase), {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ appId: this.appId, key }),
+        });
+        if (!res.ok)
+            return false;
+        const { valid } = (await res.json());
+        return valid;
+    }
+}
+//# sourceMappingURL=license.js.map

package/dist/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAU;IAEF;IACA;IACA;IAHnB,YACmB,KAAa,EACb,OAAe,EACf,KAA0B;QAF1B,UAAK,GAAL,KAAK,CAAQ;QACb,YAAO,GAAP,OAAO,CAAQ;QACf,UAAK,GAAL,KAAK,CAAqB;IAC1C,CAAC;IAEJ,gEAAgE;IAChE,KAAK,CAAC,OAAO;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,IAAI,GAAG,CAAC,YAAY,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,EAC3E,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,EAAE,CAClD,CAAC;QACF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAgB,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;YACrE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;SACjD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAC1B,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuB,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/subscription.d.ts

@@ -0,0 +1,18 @@
+import type { CheckoutRequest, Subscription } from './types.js';
+export declare class SubscriptionApi {
+    private readonly appId;
+    private readonly apiBase;
+    private readonly token;
+    constructor(appId: string, apiBase: string, token: () => string | null);
+    /** Returns the user's current subscription, or null if they have none. */
+    status(): Promise<Subscription | null>;
+    /**
+     * Redirects the user to a Stripe-hosted checkout for the given price.
+     * Returns nothing — the page navigates away.
+     */
+    openCheckout(req: CheckoutRequest): Promise<void>;
+    /** Redirects the user to the Stripe customer portal to manage billing. */
+    openPortal(returnUrl: string): Promise<void>;
+    private req;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../src/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,MAAM,GAAG,IAAI;IAG7C,0EAA0E;IACpE,MAAM,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAO5C;;;OAGG;IACG,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD,0EAA0E;IACpE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAOpC,GAAG;CAalB"}

package/dist/subscription.js

@@ -0,0 +1,54 @@
+export class SubscriptionApi {
+    appId;
+    apiBase;
+    token;
+    constructor(appId, apiBase, token) {
+        this.appId = appId;
+        this.apiBase = apiBase;
+        this.token = token;
+    }
+    /** Returns the user's current subscription, or null if they have none. */
+    async status() {
+        const res = await this.req('GET', '/v1/subscription');
+        if (res.status === 404)
+            return null;
+        if (!res.ok)
+            throw new Error(`subscription.status failed: ${res.status}`);
+        return (await res.json());
+    }
+    /**
+     * Redirects the user to a Stripe-hosted checkout for the given price.
+     * Returns nothing — the page navigates away.
+     */
+    async openCheckout(req) {
+        const res = await this.req('POST', '/v1/checkout', req);
+        if (!res.ok)
+            throw new Error(`subscription.openCheckout failed: ${res.status}`);
+        const { url } = (await res.json());
+        window.location.assign(url);
+    }
+    /** Redirects the user to the Stripe customer portal to manage billing. */
+    async openPortal(returnUrl) {
+        const res = await this.req('POST', '/v1/portal', { returnUrl });
+        if (!res.ok)
+            throw new Error(`subscription.openPortal failed: ${res.status}`);
+        const { url } = (await res.json());
+        window.location.assign(url);
+    }
+    async req(method, path, body) {
+        const token = this.token();
+        if (!token)
+            throw new Error('Not signed in. Pass fas.auth.token to initPro().');
+        const init = {
+            method,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+            },
+        };
+        if (body !== undefined)
+            init.body = JSON.stringify(body);
+        return fetch(new URL(path, this.apiBase), init);
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../src/subscription.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;IAEP;IACA;IACA;IAHnB,YACmB,KAAa,EACb,OAAe,EACf,KAA0B;QAF1B,UAAK,GAAL,KAAK,CAAQ;QACb,YAAO,GAAP,OAAO,CAAQ;QACf,UAAK,GAAL,KAAK,CAAqB;IAC1C,CAAC;IAEJ,0EAA0E;IAC1E,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;QACtD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiB,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,GAAoB;QACrC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAC;QACtD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9E,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAC;QACtD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,IAAc;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAChF,MAAM,IAAI,GAAgB;YACxB,MAAM;YACN,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,KAAK,EAAE;gBAChC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtE;SACF,CAAC;QACF,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+export interface ProInitOptions {
+    appId: string;
+    /** Defaults to https://api.proappstore.online */
+    apiBase?: string;
+    /**
+     * Bearer token from @freeappstore/sdk. Pro builds on top of free identity —
+     * the user is the same; pro just adds subscription state. Pass
+     * `fas.auth.token` here once the free auth flow has signed the user in.
+     */
+    authToken: string | (() => string | null);
+}
+export type SubscriptionStatus = 'active' | 'past_due' | 'canceled' | 'incomplete';
+export interface Subscription {
+    status: SubscriptionStatus;
+    tier: string;
+    /** Stripe price id of the active plan, or null if cancelled. */
+    priceId: string | null;
+    /** Unix ms — when the current billing period ends. */
+    currentPeriodEnd: number;
+    /** True if the user has cancelled and won't auto-renew. */
+    cancelAtPeriodEnd: boolean;
+}
+export interface CheckoutRequest {
+    priceId: string;
+    /** Where to send the user after success. Must be on an allowlisted origin. */
+    successUrl: string;
+    /** Where to send the user if they cancel checkout. */
+    cancelUrl: string;
+}
+export interface LicenseInfo {
+    key: string;
+    appId: string;
+    issuedAt: number;
+    expiresAt: number | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAEnF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@proappstore/sdk",
+  "version": "0.1.0",
+  "description": "Browser SDK for paid apps on proappstore.online — subscriptions, license keys, premium modules.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "sideEffects": false
+}