@gjsify/store 0.0.0-stage → 0.64.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,74 @@
1
- # Temporary Holding Version
1
+ # @gjsify/store
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Store purchase and entitlement interface for gjsify apps ([ADR 0139](../../../docs/adr/0139-support-and-purchase-in-stores.md)).
4
+ Pure TypeScript, identical on GJS, Node and the browser.
5
+
6
+ This package does **not** talk to real stores. Native providers (`@gjsify/store-microsoft`,
7
+ `@gjsify/store-apple`) are separate packages. `@gjsify/store/testing` ships a scriptable in-memory
8
+ provider and a shared fixture suite.
9
+
10
+ ```ts
11
+ import { registerCatalog, registerProvider, resolveSupport, owns } from '@gjsify/store';
12
+ import { MemoryStoreProvider } from '@gjsify/store/testing';
13
+
14
+ registerCatalog([
15
+ { id: 'support.small', kind: 'tip', stores: { microsoft: '9NSMALL', apple: 'eu.jumplink.small' } },
16
+ ]);
17
+
18
+ registerProvider(
19
+ new MemoryStoreProvider({
20
+ id: 'microsoft',
21
+ products: [{ id: 'support.small', storeId: '9NSMALL', kind: 'tip', localizedPrice: '€1.09' }],
22
+ purchaseResults: {
23
+ 'support.small': {
24
+ status: 'purchased',
25
+ entitlement: { productId: 'support.small', obtainedAt: new Date().toISOString() },
26
+ },
27
+ },
28
+ }),
29
+ );
30
+
31
+ const offer = await resolveSupport();
32
+ if (offer) {
33
+ console.log(`Support via ${offer.provider}:`, offer.products);
34
+ }
35
+
36
+ if (await owns('support.small')) {
37
+ console.log('User owns the tip product');
38
+ }
39
+ ```
40
+
41
+ ## Provider interface
42
+
43
+ ```ts
44
+ export interface StoreProvider {
45
+ readonly id: Commerce;
46
+ products(ids: readonly string[]): Promise<readonly StoreProduct[]>;
47
+ purchase(id: string, ctx: PurchaseContext): Promise<PurchaseResult>;
48
+ entitlements(): Promise<readonly Entitlement[]>;
49
+ restore(): Promise<readonly Entitlement[]>;
50
+ }
51
+ ```
52
+
53
+ A cancelled purchase returns `{ status: 'cancelled' }`; only programming errors throw
54
+ `StoreConfigError`.
55
+
56
+ ## Catalogue
57
+
58
+ `registerCatalog()` accepts the app's product declarations. Step 3 exposes a programmatic API;
59
+ `gjsify.store.products` in `package.json` is wired by the CLI in a later step.
60
+
61
+ ## Entitlements
62
+
63
+ `owns(id)` consults the entitlement cache first, then the registered provider. The default cache is
64
+ in-memory; persistence can be injected via `createEntitlementCache(storage)` or
65
+ `getEntitlementCache(storage)`.
66
+
67
+ ## Testing
68
+
69
+ ```ts
70
+ import { createStoreSharedSuite, MemoryStoreProvider } from '@gjsify/store/testing';
71
+ ```
72
+
73
+ The shared suite exercises the six outcomes (successful purchase, already-owned, cancelled,
74
+ unavailable, pending, and cross-device restore) against any `StoreProvider` implementation.
@@ -0,0 +1 @@
1
+ var e=Object.defineProperty,__name=(t,n)=>e(t,`name`,{value:n,configurable:!0});export{__name};
@@ -0,0 +1 @@
1
+ import"./_virtual/_rolldown/runtime.js";import{StoreConfigError as e}from"./errors.js";let t=Object.freeze([]);function registerCatalog(e){validateCatalog(e),t=Object.freeze(e.slice())}function getCatalog(){return t}function productsForCommerce(e){return t.filter(t=>{let n=t.stores[e];return typeof n==`string`&&n.length>0})}function validateCatalog(t){for(let n of t){if(n.stores.none)throw new e(`Product ${n.id} is declared for commerce 'none', which has no store backend`);for(let[t,r]of Object.entries(n.stores))if(t!==`none`&&typeof r==`string`&&r.length===0)throw new e(`Product ${n.id} has an empty store id for ${t}`)}}export{getCatalog,productsForCommerce,registerCatalog,validateCatalog};
@@ -0,0 +1 @@
1
+ import"./_virtual/_rolldown/runtime.js";import{getProvider as e}from"./registry.js";import{unavailableProvider as t}from"./unavailable.js";import{CHANNEL_CAPABILITIES as n,channel as r}from"@gjsify/distribution";var InMemoryStorage=class{entitlements=[];load(){return this.entitlements.slice()}save(e){this.entitlements=e.slice()}},EntitlementCacheImpl=class{storage;cache=new Map;loaded=!1;constructor(e){this.storage=e}async ensureLoaded(){if(this.loaded)return;let e=await this.storage.load();for(let t of e)this.cache.set(t.productId,t);this.loaded=!0}async flush(){await this.storage.save([...this.cache.values()])}async has(e){return await this.ensureLoaded(),this.cache.has(e)}async get(e){return await this.ensureLoaded(),this.cache.get(e)}async set(e){await this.ensureLoaded(),this.cache.set(e.productId,e),await this.flush()}async setMany(e){await this.ensureLoaded();for(let t of e)this.cache.set(t.productId,t);await this.flush()}async all(){return await this.ensureLoaded(),[...this.cache.values()]}};let i;function createEntitlementCache(e){return new EntitlementCacheImpl(e??new InMemoryStorage)}function getEntitlementCache(e){return i||=createEntitlementCache(e),i}function resetEntitlementCache(){i=void 0}function commerceForChannel(){return n[r].commerce}async function owns(n){let r=getEntitlementCache();if(await r.has(n))return!0;let i=await(e(commerceForChannel())??t).entitlements();return await r.setMany(i),i.some(e=>e.productId===n)}export{createEntitlementCache,getEntitlementCache,owns,resetEntitlementCache};
@@ -0,0 +1 @@
1
+ import"./_virtual/_rolldown/runtime.js";var StoreConfigError=class extends Error{constructor(e){super(e),this.name=`StoreConfigError`}};export{StoreConfigError};
@@ -0,0 +1 @@
1
+ import{StoreConfigError as e}from"./errors.js";import{getCatalog as t,productsForCommerce as n,registerCatalog as r,validateCatalog as i}from"./catalog.js";import{clearProviders as a,getProvider as o,registerProvider as s}from"./registry.js";import{UNAVAILABLE_PROVIDER_ID as c,unavailableProvider as l}from"./unavailable.js";import{createEntitlementCache as u,getEntitlementCache as d,owns as f,resetEntitlementCache as p}from"./entitlements.js";import"./types.js";import{resolveSupport as m,supportPath as h}from"./support.js";export{e as StoreConfigError,c as UNAVAILABLE_PROVIDER_ID,a as clearProviders,u as createEntitlementCache,t as getCatalog,d as getEntitlementCache,o as getProvider,f as owns,n as productsForCommerce,r as registerCatalog,s as registerProvider,p as resetEntitlementCache,m as resolveSupport,h as supportPath,l as unavailableProvider,i as validateCatalog};
@@ -0,0 +1 @@
1
+ import"./_virtual/_rolldown/runtime.js";const e=new Map;function registerProvider(t){e.set(t.id,t)}function getProvider(t){return e.get(t)}function clearProviders(){e.clear()}export{clearProviders,getProvider,registerProvider};
@@ -0,0 +1 @@
1
+ import"./_virtual/_rolldown/runtime.js";import{productsForCommerce as e}from"./catalog.js";import{getProvider as t}from"./registry.js";import{CHANNEL_CAPABILITIES as n,channel as r}from"@gjsify/distribution";function supportPath(){return n[r].support}async function resolveSupport(){let i=n[r];if(i.support!==`store-purchase`||i.commerce===`none`)return null;let a=i.commerce,o=t(a);if(!o)return null;let s=e(a);if(s.length===0)return null;let c=await o.products(s.map(e=>e.id));return{provider:o.id,products:c}}export{resolveSupport,supportPath};
@@ -0,0 +1 @@
1
+ import{MemoryStoreProvider as e}from"./memory-provider.js";import{SHARED_SUITE_PRODUCTS as t,createStoreSharedSuite as n}from"./shared-suite.js";export{e as MemoryStoreProvider,t as SHARED_SUITE_PRODUCTS,n as createStoreSharedSuite};
@@ -0,0 +1 @@
1
+ import"../_virtual/_rolldown/runtime.js";import{StoreConfigError as e}from"../errors.js";var MemoryStoreProvider=class{id;productsById=new Map;entitlementMap=new Map;purchaseResults=new Map;restoreEntitlements;constructor(e){this.id=e.id??`microsoft`;for(let t of e.products)this.productsById.set(t.id,t);for(let t of e.entitlements??[])this.entitlementMap.set(t.productId,t);for(let[t,n]of Object.entries(e.purchaseResults??{}))this.purchaseResults.set(t,typeof n==`function`?n:()=>n);this.restoreEntitlements=e.restoreEntitlements??[]}async products(e){return e.map(e=>this.productsById.get(e)).filter(e=>e!==void 0)}async purchase(t,n){if(!this.productsById.has(t))throw new e(`Unknown product id: ${t}`);let r=this.purchaseResults.get(t);if(!r)return{status:`unavailable`,reason:`unknown`};let i=await r();return(i.status===`purchased`||i.status===`already-owned`)&&this.entitlementMap.set(t,i.entitlement),i}async entitlements(){return[...this.entitlementMap.values()]}async restore(){for(let e of this.restoreEntitlements)this.entitlementMap.set(e.productId,e);return this.restoreEntitlements.slice()}};export{MemoryStoreProvider};
@@ -0,0 +1 @@
1
+ import"../_virtual/_rolldown/runtime.js";import{StoreConfigError as e}from"../errors.js";import{describe as t,expect as n,it as r}from"@gjsify/unit";const i={purchased:`outcome.purchased`,alreadyOwned:`outcome.already-owned`,cancelled:`outcome.cancelled`,unavailable:`outcome.unavailable`,pending:`outcome.pending`,unknown:`outcome.unknown`};function createStoreSharedSuite(a){return async()=>{await t(a.label??`@gjsify/store shared suite`,async()=>{await r(`lists configured products`,async()=>{let e=await a.createProvider(),t=Object.values(i).filter(e=>e!==i.unknown),r=await e.products(t);n(r.length).toBe(t.length);for(let e=0;e<t.length;e++)n(r[e]?.id).toBe(t[e])}),await r(`returns a purchased entitlement on a successful purchase`,async()=>{let e=await(await a.createProvider()).purchase(i.purchased,{});n(e.status).toBe(`purchased`),e.status===`purchased`&&(n(e.entitlement.productId).toBe(i.purchased),n(typeof e.entitlement.obtainedAt).toBe(`string`))}),await r(`reports an already-owned product`,async()=>{let e=await(await a.createProvider()).purchase(i.alreadyOwned,{});n(e.status).toBe(`already-owned`),e.status===`already-owned`&&n(e.entitlement.productId).toBe(i.alreadyOwned)}),await r(`reports a cancelled purchase as a result, not an exception`,async()=>{n((await(await a.createProvider()).purchase(i.cancelled,{})).status).toBe(`cancelled`)}),await r(`reports an unreachable store as unavailable`,async()=>{let e=await(await a.createProvider()).purchase(i.unavailable,{});n(e.status).toBe(`unavailable`),e.status===`unavailable`&&n(typeof e.reason).toBe(`string`)}),await r(`reports a pending purchase`,async()=>{n((await(await a.createProvider()).purchase(i.pending,{})).status).toBe(`pending`)}),await r(`restores a purchase made on another machine`,async()=>{let e=await a.createProvider(),t=await e.entitlements();n((await e.restore()).some(e=>e.transactionId===a.restoredEntitlement.transactionId)).toBe(!0),n((await e.entitlements()).length).toBeGreaterThanOrEqual(t.length)}),await r(`throws StoreConfigError for an unknown product id`,async()=>{let t=await a.createProvider(),r=!1;try{await t.purchase(i.unknown,{})}catch(t){r=t instanceof e}n(r).toBe(!0)})})}}export{i as SHARED_SUITE_PRODUCTS,createStoreSharedSuite};
File without changes
@@ -0,0 +1 @@
1
+ import"./_virtual/_rolldown/runtime.js";const e=`none`,t={id:e,async products(){return[]},async purchase(e,t){return{status:`unavailable`,reason:`not-registered`}},async entitlements(){return[]},async restore(){return[]}};export{e as UNAVAILABLE_PROVIDER_ID,t as unavailableProvider};
@@ -0,0 +1 @@
1
+ {"fileNames":["../../../../node_modules/@gjsify/tsc/lib/lib.es5.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2016.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2017.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2018.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2019.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2020.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2021.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2022.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2023.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2024.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2025.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.dom.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.dom.iterable.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.dom.asynciterable.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.webworker.importscripts.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.scripthost.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.core.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.collection.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.generator.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.iterable.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.promise.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.proxy.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.reflect.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.symbol.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2015.symbol.wellknown.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2016.array.include.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2016.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2017.arraybuffer.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2017.date.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2017.object.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2017.sharedmemory.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2017.string.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2017.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2017.typedarrays.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2018.asyncgenerator.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2018.asynciterable.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2018.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2018.promise.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2018.regexp.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2019.array.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2019.object.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2019.string.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2019.symbol.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2019.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2020.bigint.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2020.date.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2020.promise.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2020.sharedmemory.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2020.string.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2020.symbol.wellknown.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2020.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2020.number.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2021.promise.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2021.string.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2021.weakref.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2021.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2022.array.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2022.error.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2022.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2022.object.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2022.string.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2022.regexp.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2023.array.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2023.collection.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2023.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2024.arraybuffer.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2024.collection.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2024.object.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2024.promise.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2024.regexp.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2024.sharedmemory.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2024.string.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2025.collection.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2025.float16.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2025.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2025.iterator.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2025.promise.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.es2025.regexp.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.array.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.collection.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.date.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.decorators.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.disposable.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.error.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.intl.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.sharedmemory.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.temporal.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.typedarrays.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.decorators.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.decorators.legacy.d.ts","../../../../node_modules/@gjsify/tsc/lib/lib.esnext.full.d.ts","../../distribution/lib/types/index.d.ts","../src/types.ts","../src/errors.ts","../src/catalog.ts","../src/registry.ts","../src/unavailable.ts","../src/entitlements.ts","../src/support.ts","../src/index.ts","../src/testing/memory-provider.ts","../../../../node_modules/@girs/gjs/gettext.d.ts","../../../../node_modules/@girs/gobject-2.0/gobject-2.0-ambient.d.ts","../../../../node_modules/@girs/gobject-2.0/gobject-2.0-import.d.ts","../../../../node_modules/@girs/glib-2.0/glib-2.0-ambient.d.ts","../../../../node_modules/@girs/glib-2.0/glib-2.0-import.d.ts","../../../../node_modules/@girs/glib-2.0/glib-2.0.d.ts","../../../../node_modules/@girs/glib-2.0/index.d.ts","../../../../node_modules/@girs/gobject-2.0/gobject-2.0.d.ts","../../../../node_modules/@girs/gobject-2.0/index.d.ts","../../../../node_modules/@girs/gjs/system.d.ts","../../../../node_modules/@girs/cairo-1.0/cairo-1.0-ambient.d.ts","../../../../node_modules/@girs/cairo-1.0/cairo-1.0-import.d.ts","../../../../node_modules/@girs/cairo-1.0/cairo-1.0.d.ts","../../../../node_modules/@girs/cairo-1.0/index.d.ts","../../../../node_modules/@girs/gjs/cairo.d.ts","../../../../node_modules/@girs/gjs/console.d.ts","../../../../node_modules/@girs/gjs/gi.d.ts","../../../../node_modules/@girs/gjs/gjs-ambient.d.ts","../../../../node_modules/@girs/gjs/gjs.d.ts","../../../../node_modules/@girs/gjs/index.d.ts","../../../gjs/unit/lib/types/spy.d.ts","../../../gjs/unit/lib/types/index.d.ts","../src/testing/shared-suite.ts","../src/testing/index.ts"],"fileIdsList":[[114,117],[117],[110,112,123],[115,116],[112,117],[104,113,118,119,120],[104,110,112,113,118],[122],[112],[107,110],[110],[112,123],[108,109],[105,112],[110,123],[106,111],[95,96],[94,95,98,99],[95,96,97,98,99,100,101],[95],[94,95,97,98],[103,126],[95,96,125],[94],[110,123,124]],"fileInfos":[{"version":"bcd24271a113971ba9eb71ff8cb01bc6b0f872a85c23fdbe5d93065b375933cd","affectsGlobalScope":true,"impliedFormat":99},{"version":"3f88bedbeb09c6f5a6645cb24c7c55f1aa22d19ae96c8e6959cbd8b85a707bc6","impliedFormat":99},{"version":"7fe93b39b810eadd916be8db880dd7f0f7012a5cc6ffb62de8f62a2117fa6f1f","impliedFormat":99},{"version":"bb0074cc08b84a2374af33d8bf044b80851ccc9e719a5e202eacf40db2c31600","impliedFormat":99},{"version":"1a7daebe4f45fb03d9ec53d60008fbf9ac45a697fdc89e4ce218bc94b94f94d6","impliedFormat":99},{"version":"f94b133a3cb14a288803be545ac2683e0d0ff6661bcd37e31aaaec54fc382aed","impliedFormat":99},{"version":"f59d0650799f8782fd74cf73c19223730c6d1b9198671b1c5b3a38e1188b5953","impliedFormat":99},{"version":"8a15b4607d9a499e2dbeed9ec0d3c0d7372c850b2d5f1fb259e8f6d41d468a84","impliedFormat":99},{"version":"26e0fe14baee4e127f4365d1ae0b276f400562e45e19e35fd2d4c296684715e6","impliedFormat":99},{"version":"1e9332c23e9a907175e0ffc6a49e236f97b48838cc8aec9ce7e4cec21e544b65","impliedFormat":99},{"version":"3753fbc1113dc511214802a2342280a8b284ab9094f6420e7aa171e868679f91","impliedFormat":99},{"version":"999ca32883495a866aa5737fe1babc764a469e4cde6ee6b136a4b9ae68853e4b","impliedFormat":99},{"version":"17f13ecb98cbc39243f2eee1f16d45cd8ec4706b03ee314f1915f1a8b42f6984","impliedFormat":99},{"version":"d6b1eba8496bdd0eed6fc8a685768fe01b2da4a0388b5fe7df558290bffcf32f","affectsGlobalScope":true,"impliedFormat":99},{"version":"7f57fc4404ff020bc45b9c620aff2b40f700b95fe31164024c453a5e3c163c54","impliedFormat":99},{"version":"7f57fc4404ff020bc45b9c620aff2b40f700b95fe31164024c453a5e3c163c54","impliedFormat":99},{"version":"2a2de5b9459b3fc44decd9ce6100b72f1b002ef523126c1d3d8b2a4a63d74d78","affectsGlobalScope":true,"impliedFormat":99},{"version":"f13f4b465c99041e912db5c44129a94588e1aafee35a50eab51044833f50b4ee","affectsGlobalScope":true,"impliedFormat":99},{"version":"eadcffda2aa84802c73938e589b9e58248d74c59cb7fcbca6474e3435ac15504","affectsGlobalScope":true,"impliedFormat":99},{"version":"105ba8ff7ba746404fe1a2e189d1d3d2e0eb29a08c18dded791af02f29fb4711","affectsGlobalScope":true,"impliedFormat":99},{"version":"00343ca5b2e3d48fa5df1db6e32ea2a59afab09590274a6cccb1dbae82e60c7c","affectsGlobalScope":true,"impliedFormat":99},{"version":"ebd9f816d4002697cb2864bea1f0b70a103124e18a8cd9645eeccc09bdf80ab4","affectsGlobalScope":true,"impliedFormat":99},{"version":"2c1afac30a01772cd2a9a298a7ce7706b5892e447bb46bdbeef720f7b5da77ad","affectsGlobalScope":true,"impliedFormat":99},{"version":"7b0225f483e4fa685625ebe43dd584bb7973bbd84e66a6ba7bbe175ee1048b4f","affectsGlobalScope":true,"impliedFormat":99},{"version":"c0a4b8ac6ce74679c1da2b3795296f5896e31c38e888469a8e0f99dc3305de60","affectsGlobalScope":true,"impliedFormat":99},{"version":"3084a7b5f569088e0146533a00830e206565de65cae2239509168b11434cd84f","affectsGlobalScope":true,"impliedFormat":99},{"version":"c5079c53f0f141a0698faa903e76cb41cd664e3efb01cc17a5c46ec2eb0bef42","affectsGlobalScope":true,"impliedFormat":99},{"version":"32cafbc484dea6b0ab62cf8473182bbcb23020d70845b406f80b7526f38ae862","affectsGlobalScope":true,"impliedFormat":99},{"version":"fca4cdcb6d6c5ef18a869003d02c9f0fd95df8cfaf6eb431cd3376bc034cad36","affectsGlobalScope":true,"impliedFormat":99},{"version":"b93ec88115de9a9dc1b602291b85baf825c85666bf25985cc5f698073892b467","affectsGlobalScope":true,"impliedFormat":99},{"version":"f5c06dcc3fe849fcb297c247865a161f995cc29de7aa823afdd75aaaddc1419b","affectsGlobalScope":true,"impliedFormat":99},{"version":"b77e16112127a4b169ef0b8c3a4d730edf459c5f25fe52d5e436a6919206c4d7","affectsGlobalScope":true,"impliedFormat":99},{"version":"fbffd9337146eff822c7c00acbb78b01ea7ea23987f6c961eba689349e744f8c","affectsGlobalScope":true,"impliedFormat":99},{"version":"a995c0e49b721312f74fdfb89e4ba29bd9824c770bbb4021d74d2bf560e4c6bd","affectsGlobalScope":true,"impliedFormat":99},{"version":"c7b3542146734342e440a84b213384bfa188835537ddbda50d30766f0593aff9","affectsGlobalScope":true,"impliedFormat":99},{"version":"ce6180fa19b1cccd07ee7f7dbb9a367ac19c0ed160573e4686425060b6df7f57","affectsGlobalScope":true,"impliedFormat":99},{"version":"3f02e2476bccb9dbe21280d6090f0df17d2f66b74711489415a8aa4df73c9675","affectsGlobalScope":true,"impliedFormat":99},{"version":"45e3ab34c1c013c8ab2dc1ba4c80c780744b13b5676800ae2e3be27ae862c40c","affectsGlobalScope":true,"impliedFormat":99},{"version":"805c86f6cca8d7702a62a844856dbaa2a3fd2abef0536e65d48732441dde5b5b","affectsGlobalScope":true,"impliedFormat":99},{"version":"e42e397f1a5a77994f0185fd1466520691456c772d06bf843e5084ceb879a0ad","affectsGlobalScope":true,"impliedFormat":99},{"version":"f4c2b41f90c95b1c532ecc874bd3c111865793b23aebcc1c3cbbabcd5d76ffb0","affectsGlobalScope":true,"impliedFormat":99},{"version":"ab26191cfad5b66afa11b8bf935ef1cd88fabfcb28d30b2dfa6fad877d050332","affectsGlobalScope":true,"impliedFormat":99},{"version":"2088bc26531e38fb05eedac2951480db5309f6be3fa4a08d2221abb0f5b4200d","affectsGlobalScope":true,"impliedFormat":99},{"version":"cb9d366c425fea79716a8fb3af0d78e6b22ebbab3bd64d25063b42dc9f531c1e","affectsGlobalScope":true,"impliedFormat":99},{"version":"500934a8089c26d57ebdb688fc9757389bb6207a3c8f0674d68efa900d2abb34","affectsGlobalScope":true,"impliedFormat":99},{"version":"689da16f46e647cef0d64b0def88910e818a5877ca5379ede156ca3afb780ac3","affectsGlobalScope":true,"impliedFormat":99},{"version":"bc21cc8b6fee4f4c2440d08035b7ea3c06b3511314c8bab6bef7a92de58a2593","affectsGlobalScope":true,"impliedFormat":99},{"version":"7ca53d13d2957003abb47922a71866ba7cb2068f8d154877c596d63c359fed25","affectsGlobalScope":true,"impliedFormat":99},{"version":"54725f8c4df3d900cb4dac84b64689ce29548da0b4e9b7c2de61d41c79293611","affectsGlobalScope":true,"impliedFormat":99},{"version":"e5594bc3076ac29e6c1ebda77939bc4c8833de72f654b6e376862c0473199323","affectsGlobalScope":true,"impliedFormat":99},{"version":"2f3eb332c2d73e729f3364fcc0c2b375e72a121e8157d25a82d67a138c83a95c","affectsGlobalScope":true,"impliedFormat":99},{"version":"6f4427f9642ce8d500970e4e69d1397f64072ab73b97e476b4002a646ac743b1","affectsGlobalScope":true,"impliedFormat":99},{"version":"48915f327cd1dea4d7bd358d9dc7732f58f9e1626a29cc0c05c8c692419d9bb7","affectsGlobalScope":true,"impliedFormat":99},{"version":"b7bf9377723203b5a6a4b920164df22d56a43f593269ba6ae1fdc97774b68855","affectsGlobalScope":true,"impliedFormat":99},{"version":"db9709688f82c9e5f65a119c64d835f906efe5f559d08b11642d56eb85b79357","affectsGlobalScope":true,"impliedFormat":99},{"version":"4b25b8c874acd1a4cf8444c3617e037d444d19080ac9f634b405583fd10ce1f7","affectsGlobalScope":true,"impliedFormat":99},{"version":"37be57d7c90cf1f8112ee2636a068d8fd181289f82b744160ec56a7dc158a9f5","affectsGlobalScope":true,"impliedFormat":99},{"version":"a917a49ac94cd26b754ab84e113369a75d1a47a710661d7cd25e961cc797065f","affectsGlobalScope":true,"impliedFormat":99},{"version":"6d3261badeb7843d157ef3e6f5d1427d0eeb0af0cf9df84a62cfd29fd47ac86e","affectsGlobalScope":true,"impliedFormat":99},{"version":"195daca651dde22f2167ac0d0a05e215308119a3100f5e6268e8317d05a92526","affectsGlobalScope":true,"impliedFormat":99},{"version":"8b11e4285cd2bb164a4dc09248bdec69e9842517db4ca47c1ba913011e44ff2f","affectsGlobalScope":true,"impliedFormat":99},{"version":"0508571a52475e245b02bc50fa1394065a0a3d05277fbf5120c3784b85651799","affectsGlobalScope":true,"impliedFormat":99},{"version":"8f9af488f510c3015af3cc8c267a9e9d96c4dd38a1fdff0e11dc5a544711415b","affectsGlobalScope":true,"impliedFormat":99},{"version":"fc611fea8d30ea72c6bbfb599c9b4d393ce22e2f5bfef2172534781e7d138104","affectsGlobalScope":true,"impliedFormat":99},{"version":"0bd714129fca875f7d4c477a1a392200b0bcd13fb2e80928cd334b63830ea047","affectsGlobalScope":true,"impliedFormat":99},{"version":"e2c9037ae6cd2c52d80ceef0b3c5ffdb488627d71529cf4f63776daf11161c9a","affectsGlobalScope":true,"impliedFormat":99},{"version":"135d5cf4d345f59f1a9caadfafcd858d3d9cc68290db616cc85797224448cccc","affectsGlobalScope":true,"impliedFormat":99},{"version":"bc238c3f81c2984751932b6aab223cd5b830e0ac6cad76389e5e9d2ffc03287d","affectsGlobalScope":true,"impliedFormat":99},{"version":"4a07f9b76d361f572620927e5735b77d6d2101c23cdd94383eb5b706e7b36357","affectsGlobalScope":true,"impliedFormat":99},{"version":"7c4e8dc6ab834cc6baa0227e030606d29e3e8449a9f67cdf5605ea5493c4db29","affectsGlobalScope":true,"impliedFormat":99},{"version":"de7ba0fd02e06cd9a5bd4ab441ed0e122735786e67dde1e849cced1cd8b46b78","affectsGlobalScope":true,"impliedFormat":99},{"version":"6148e4e88d720a06855071c3db02069434142a8332cf9c182cda551adedf3156","affectsGlobalScope":true,"impliedFormat":99},{"version":"d63dba625b108316a40c95a4425f8d4294e0deeccfd6c7e59d819efa19e23409","affectsGlobalScope":true,"impliedFormat":99},{"version":"0568d6befee03dd435bed4fc25c4e46865b24bdcb8c563fdc21f580a2c301904","affectsGlobalScope":true,"impliedFormat":99},{"version":"30d62269b05b584741f19a5369852d5d34895aa2ac4fd948956f886d15f9cc0d","affectsGlobalScope":true,"impliedFormat":99},{"version":"f128dae7c44d8f35ee42e0a437000a57c9f06cc04f8b4fb42eebf44954d53dc8","affectsGlobalScope":true,"impliedFormat":99},{"version":"ffbe6d7b295306b2ba88030f65b74c107d8d99bdcf596ea99c62a02f606108b0","affectsGlobalScope":true,"impliedFormat":99},{"version":"996fb27b15277369c68a4ba46ed138b4e9e839a02fb4ec756f7997629242fd9f","affectsGlobalScope":true,"impliedFormat":99},{"version":"79b712591b270d4778c89706ca2cfc56ddb8c3f895840e477388f1710dc5eda9","affectsGlobalScope":true,"impliedFormat":99},{"version":"20884846cef428b992b9bd032e70a4ef88e349263f63aeddf04dda837a7dba26","affectsGlobalScope":true,"impliedFormat":99},{"version":"5fcab789c73a97cd43828ee3cc94a61264cf24d4c44472ce64ced0e0f148bdb2","affectsGlobalScope":true,"impliedFormat":99},{"version":"db59a81f070c1880ad645b2c0275022baa6a0c4f0acdc58d29d349c6efcf0903","affectsGlobalScope":true,"impliedFormat":99},{"version":"673294292640f5722b700e7d814e17aaf7d93f83a48a2c9b38f33cbc940ad8b0","affectsGlobalScope":true,"impliedFormat":99},{"version":"d786b48f934cbca483b3c6d0a798cb43bbb4ada283e76fb22c28e53ae05b9e69","affectsGlobalScope":true,"impliedFormat":99},{"version":"1ecb8e347cb6b2a8927c09b86263663289418df375f5e68e11a0ae683776978f","affectsGlobalScope":true,"impliedFormat":99},{"version":"142efd4ce210576f777dc34df121777be89eda476942d6d6663b03dcb53be3ff","affectsGlobalScope":true,"impliedFormat":99},{"version":"379bc41580c2d774f82e828c70308f24a005b490c25ba34d679d84bcf05c3d9d","affectsGlobalScope":true,"impliedFormat":99},{"version":"ed484fb2aa8a1a23d0277056ec3336e0a0b52f9b8d6a961f338a642faf43235d","affectsGlobalScope":true,"impliedFormat":99},{"version":"4ffedae1d1c2d53fdbca1c96d3c7dda544281f7d262f99b6880634f8fd8d9820","affectsGlobalScope":true,"impliedFormat":99},{"version":"83a730b125d477dd264df8ba479afab27a3dae7152b005c214ab94dc7ee44fd3","affectsGlobalScope":true,"impliedFormat":99},{"version":"1ce14b81c5cc821994aa8ec1d42b220dd41b27fcc06373bce3958af7421b77d4","affectsGlobalScope":true,"impliedFormat":99},{"version":"b3a048b3e9302ef9a34ef4ebb9aecfb28b66abb3bce577206a79fee559c230da","affectsGlobalScope":true,"impliedFormat":99},{"version":"ef4a897cd2a3f91000c10264e400b3667c7e51e1b7365f03b62e8081dc53bde6","impliedFormat":99},"d9d88e947d1deabc3981479f2d4dfbb19bbf1aefaa099adf3359f325ae7ca067",{"version":"fe992d1db7a2ce5be54d0aff993da723fed7f4d44383fd665f3fd71e2ffea89f","signature":"1beb195993af557e4c98d1f4bb8593560654b768790c3cb164e3334be1ab6fe3"},{"version":"b9d842215d8ee128ee4fac1951e740393bfa0dc8c4cf1c5ebe5c076a92fd2cb5","signature":"4ac6006aca64a87f765032dfad961e3d003e93fe3a26fbe067e4683537fc91a2"},{"version":"a4307c142129ffecce37e428d33408a4711e21b7de857554e0093ee0a2b73746","signature":"2879ea5b1758076bacc1ffa2b42ebbc7dc08b284752c27cd1c75e78e3494208a"},{"version":"f4bf94b12228167c1f54b52a9eb47a799872cbf2ae44e86e09d6d571c80488b6","signature":"5397ee3cf5523614e73258027ea1c5545fc03a7cb18d99ee073d1cb8811770a0"},{"version":"6067a074755915ed4b9d9bcfa8c6ab29d700cb1b2bea82eb8cadd9d19024aab6","signature":"67d95a4640bb7ed2bd0c9f7325cceac3790f5caf56106f43aa4bde5c47a384a7"},{"version":"e58544816710f554b5dfa5073816fb8b65b6299f6202ff87a49269d4d2afecec","signature":"840731be114e198b469dd613c9178cfb3b7a54add665e47746c4e5f6b17a0935"},{"version":"1f7b0c511f493c15d2d054a91c99aa1042a52b9325c3420059631d716bdf9377","signature":"964a60157659335bfcffcaf00d748c31734260b4f907f0e934bf3e9ed0624422"},{"version":"f1887f8fcb980a216bd5550462b9ae6b55e9f0982e7a5e43320f7b42d013b312","signature":"4edc2b891fb3f8442cd6dce6ac2aa048176b8abdaaa8c56396c8b08cfbfbee51"},{"version":"fb759dea008f935711fc75b9009d89ea298d8f1b825dee419f978169fd97452f","signature":"2b3d81380f94214f5910af9f55e023442f68263fb530d1154d9c534dae980986"},{"version":"4936d25ba31379ce4e3d4289f6c0ea936510e111f823ec377015de6ba7047adf","impliedFormat":99},{"version":"1ffa53902f87f288dbaebc1dd9c754a0f0f1c4af2733fc7e173022209e7d4ef8","impliedFormat":99},{"version":"d7801240a49920afb07e1a83597b05a26e5e3758163a70448ba14df3f7ab5286","affectsGlobalScope":true,"impliedFormat":99},{"version":"2aed5de224f5094280addfaf59e82b362b3680083917cfa7f066c4b89cc58b74","impliedFormat":99},{"version":"86ecf772256f9205f72c768dc9b47d27b4254a64a1dd94f61c8c2f29219c24e1","affectsGlobalScope":true,"impliedFormat":99},{"version":"734aadaaad53c18d3999974d7a38582dd8b68cc806303b5e506d388c125f5c6a","impliedFormat":99},{"version":"9462f849ff8d50a61639f09a8e369f7584c623a8cbcf9d99c6b81aacbca91fd2","impliedFormat":99},{"version":"0ce457159ee15209cbd5078361807343dbd2d2d17440df6041adf2e1a77d5131","impliedFormat":99},{"version":"048a292f9fb06d0aab8c52cabd81bc820c70d68500530afe1867c08e431d4e46","impliedFormat":99},{"version":"e2f9944677cba1c7f636dde67d7ca77982da3b52134c617bd86d3a4d8607b498","impliedFormat":99},{"version":"ceaf67c6cb2df4f38f466bd3709a72199d1d98377dcf215bf760b2a383fc73a8","impliedFormat":99},{"version":"c5f89dedf8e238012d580d16ee2286bf0681f1389f14d419c87711070430995c","affectsGlobalScope":true,"impliedFormat":99},{"version":"d67d6caa44ae7aaaca8e3d5bd65be122bb9ba0212daeb239a5cdb3e9d8f7aebb","impliedFormat":99},{"version":"cdd5245a59183386c7b465ad56e2353a0a1b49c32733520ec5c0eeb718781012","impliedFormat":99},{"version":"0ed2b96609c33c3676fb356c5ab3f4d80cab289732556629049d4d264059fe04","impliedFormat":99},{"version":"7b607f4711c496c7c4f57abddfc7b9912059e1f264417ff8f4280b65f756bf4d","impliedFormat":99},{"version":"17122ddf1e2ff9f0538a06af6edc8d2666d7e1a428239e86358afc09ac7a8779","impliedFormat":99},{"version":"c4d291f0956ebd9ae0c900c840be4c4de753cb959249b70ef74b773404322d3d","impliedFormat":99},{"version":"8384e3ab082eecd9d0faa07ddf7e9ff3879bfac60216e47328f799600e47ea80","affectsGlobalScope":true,"impliedFormat":99},{"version":"715e7c015d2f3f4de0da107d9be2db02b52cea3d2d446ad11d2e732848d8e3e7","impliedFormat":99},"6025163eb18e7e9ae36b32b3eb5e67c69ff15bfb7b4d0c7b6b3305c51f1c1e5e","edb3e1617571bdf714fa22ba569db0f0c4a6a931e371217c85ad532b4cf04a58",{"version":"eaef70173654e0b0f5d70cb1f4f9aea1738ad5d4185c7709c9a63ed46363eacc","signature":"2244daeacd386ba2a9a5b7f621cc5f0d8fba9054db878844f96c84327f07d910"},{"version":"674dc9ae81e84c4f1e83e4467378519d04f242a1f1efe799b3a391ec80bf7a6b","signature":"7b2354df9a269c30662ff93b4ffc53367ae19be75478503e814ab823e8243a6a"}],"root":[[95,103],126,127],"options":{"composite":true,"declaration":true,"declarationDir":"./types","emitDeclarationOnly":true,"module":99,"outDir":"./esm","rootDir":"../src","skipLibCheck":true,"strict":true,"target":99},"referencedMap":[[114,1],[115,2],[116,3],[117,4],[118,5],[121,6],[122,7],[123,8],[113,9],[107,10],[108,11],[109,12],[110,13],[105,14],[106,9],[111,15],[112,16],[97,17],[100,18],[102,19],[98,20],[101,21],[127,22],[103,17],[126,23],[95,24],[99,20],[125,25]],"latestChangedDtsFile":"./types/testing/index.d.ts","version":"6.0.3"}
@@ -0,0 +1,9 @@
1
+ import type { Commerce, ProductDeclaration } from './types.js';
2
+ /** Register the app's product catalog. */
3
+ export declare function registerCatalog(products: readonly ProductDeclaration[]): void;
4
+ /** The currently registered catalog. */
5
+ export declare function getCatalog(): readonly ProductDeclaration[];
6
+ /** Products that have a store id for `commerce`. */
7
+ export declare function productsForCommerce(commerce: Commerce): readonly ProductDeclaration[];
8
+ /** Validate a catalog declaration. Throws {@link StoreConfigError} on mistakes. */
9
+ export declare function validateCatalog(products: readonly ProductDeclaration[]): void;
@@ -0,0 +1,25 @@
1
+ import type { Entitlement } from './types.js';
2
+ /** Pluggable persistence for the entitlement cache. */
3
+ export interface EntitlementCacheStorage {
4
+ load(): Promise<readonly Entitlement[]> | readonly Entitlement[];
5
+ save(entitlements: readonly Entitlement[]): Promise<void> | void;
6
+ }
7
+ /** The entitlement cache. */
8
+ export interface EntitlementCache {
9
+ has(productId: string): Promise<boolean>;
10
+ get(productId: string): Promise<Entitlement | undefined>;
11
+ set(entitlement: Entitlement): Promise<void>;
12
+ setMany(entitlements: readonly Entitlement[]): Promise<void>;
13
+ all(): Promise<readonly Entitlement[]>;
14
+ }
15
+ /** Create a new entitlement cache backed by `storage` (in-memory by default). */
16
+ export declare function createEntitlementCache(storage?: EntitlementCacheStorage): EntitlementCache;
17
+ /** The process-wide default cache. */
18
+ export declare function getEntitlementCache(storage?: EntitlementCacheStorage): EntitlementCache;
19
+ /** Reset the default cache. Mainly for tests. */
20
+ export declare function resetEntitlementCache(): void;
21
+ /**
22
+ * Whether the current user owns `productId`. Uses the entitlement cache first, then the registered
23
+ * provider for the current channel's commerce backend.
24
+ */
25
+ export declare function owns(productId: string): Promise<boolean>;
@@ -0,0 +1,4 @@
1
+ /** Thrown for configuration mistakes such as an unknown product id or an invalid catalog entry. */
2
+ export declare class StoreConfigError extends Error {
3
+ constructor(message: string);
4
+ }
@@ -0,0 +1,7 @@
1
+ export * from './types.js';
2
+ export * from './errors.js';
3
+ export { registerProvider, getProvider, clearProviders } from './registry.js';
4
+ export { unavailableProvider, UNAVAILABLE_PROVIDER_ID } from './unavailable.js';
5
+ export { registerCatalog, getCatalog, productsForCommerce, validateCatalog } from './catalog.js';
6
+ export { createEntitlementCache, getEntitlementCache, resetEntitlementCache, owns, type EntitlementCache, type EntitlementCacheStorage, } from './entitlements.js';
7
+ export { resolveSupport, supportPath } from './support.js';
@@ -0,0 +1,7 @@
1
+ import type { Commerce, StoreProvider } from './types.js';
2
+ /** Register a store provider. Last registration wins. */
3
+ export declare function registerProvider(provider: StoreProvider): void;
4
+ /** Return the registered provider for `id`, or `undefined` if none. */
5
+ export declare function getProvider(id: Commerce): StoreProvider | undefined;
6
+ /** Remove all registered providers. Mainly for tests. */
7
+ export declare function clearProviders(): void;
@@ -0,0 +1,11 @@
1
+ import { type SupportPath } from '@gjsify/distribution';
2
+ import type { SupportOffer } from './types.js';
3
+ /** The support path declared for the current build. */
4
+ export declare function supportPath(): SupportPath;
5
+ /**
6
+ * Resolve what store purchase UI can be offered in this build.
7
+ *
8
+ * - Returns `null` when the channel does not allow store purchases or no provider is registered.
9
+ * - Returns the provider's available products otherwise.
10
+ */
11
+ export declare function resolveSupport(): Promise<SupportOffer | null>;
@@ -0,0 +1,2 @@
1
+ export { MemoryStoreProvider, type MemoryStoreProviderOptions, type PurchaseResultFactory } from './memory-provider.js';
2
+ export { createStoreSharedSuite, SHARED_SUITE_PRODUCTS, type SharedSuiteOptions } from './shared-suite.js';
@@ -0,0 +1,30 @@
1
+ import type { Commerce, Entitlement, PurchaseContext, PurchaseResult, StoreProduct, StoreProvider } from '../types.js';
2
+ export type PurchaseResultFactory = () => PurchaseResult | Promise<PurchaseResult>;
3
+ export interface MemoryStoreProviderOptions {
4
+ /** Commerce backend this provider pretends to be. Defaults to `'microsoft'`. */
5
+ readonly id?: Commerce;
6
+ /** Products this provider answers for. */
7
+ readonly products: readonly StoreProduct[];
8
+ /** Entitlements already held on this device. */
9
+ readonly entitlements?: readonly Entitlement[];
10
+ /** Per-product purchase result. A missing product returns `unavailable`. */
11
+ readonly purchaseResults?: Readonly<Record<string, PurchaseResult | PurchaseResultFactory>>;
12
+ /** Entitlements returned by {@link MemoryStoreProvider.restore}. */
13
+ readonly restoreEntitlements?: readonly Entitlement[];
14
+ }
15
+ /**
16
+ * A store provider scripted by fixtures. It is the provider every test and CI leg uses, because
17
+ * real store APIs have no simulator.
18
+ */
19
+ export declare class MemoryStoreProvider implements StoreProvider {
20
+ readonly id: Commerce;
21
+ private readonly productsById;
22
+ private readonly entitlementMap;
23
+ private readonly purchaseResults;
24
+ private readonly restoreEntitlements;
25
+ constructor(options: MemoryStoreProviderOptions);
26
+ products(ids: readonly string[]): Promise<readonly StoreProduct[]>;
27
+ purchase(id: string, _ctx: PurchaseContext): Promise<PurchaseResult>;
28
+ entitlements(): Promise<readonly Entitlement[]>;
29
+ restore(): Promise<readonly Entitlement[]>;
30
+ }
@@ -0,0 +1,31 @@
1
+ import type { Entitlement, StoreProvider } from '../types.js';
2
+ /** Product ids the shared suite exercises. A provider factory must map each to the named outcome. */
3
+ export declare const SHARED_SUITE_PRODUCTS: {
4
+ readonly purchased: "outcome.purchased";
5
+ readonly alreadyOwned: "outcome.already-owned";
6
+ readonly cancelled: "outcome.cancelled";
7
+ readonly unavailable: "outcome.unavailable";
8
+ readonly pending: "outcome.pending";
9
+ readonly unknown: "outcome.unknown";
10
+ };
11
+ export interface SharedSuiteOptions {
12
+ /** Factory that creates a fresh provider for each test run. */
13
+ readonly createProvider: () => StoreProvider | Promise<StoreProvider>;
14
+ /** Entitlement the restore fixture is expected to return. */
15
+ readonly restoredEntitlement: Entitlement;
16
+ /** Description shown in test output. */
17
+ readonly label?: string;
18
+ }
19
+ /**
20
+ * Creates the six-outcome shared fixture suite every app support UI should pass.
21
+ *
22
+ * The factory must return a provider configured so that:
23
+ * - `purchase('outcome.purchased')` returns `{ status: 'purchased' }`,
24
+ * - `purchase('outcome.already-owned')` returns `{ status: 'already-owned' }`,
25
+ * - `purchase('outcome.cancelled')` returns `{ status: 'cancelled' }`,
26
+ * - `purchase('outcome.unavailable')` returns `{ status: 'unavailable' }`,
27
+ * - `purchase('outcome.pending')` returns `{ status: 'pending' }`,
28
+ * - `purchase('outcome.unknown')` throws {@link StoreConfigError},
29
+ * - `restore()` returns at least {@link SharedSuiteOptions.restoredEntitlement}.
30
+ */
31
+ export declare function createStoreSharedSuite(options: SharedSuiteOptions): () => Promise<void>;
@@ -0,0 +1,75 @@
1
+ import type { Commerce } from '@gjsify/distribution';
2
+ export type { Commerce } from '@gjsify/distribution';
3
+ /** What a product is for in the UI. */
4
+ export type ProductKind = 'tip' | 'unlock';
5
+ /**
6
+ * How a product is mapped in each store console. Per-store ids live in config because they are
7
+ * assigned by Partner Center and App Store Connect; app code only uses {@link ProductDeclaration.id}.
8
+ */
9
+ export type StoreIds = Partial<Record<Commerce, string>>;
10
+ /** A product the app offers, declared in `gjsify.store.products`. */
11
+ export interface ProductDeclaration {
12
+ /** The app's own name for the product; the only string used in app code. */
13
+ readonly id: string;
14
+ readonly kind: ProductKind;
15
+ /** Per-store product/add-on identifiers. */
16
+ readonly stores: StoreIds;
17
+ }
18
+ /** A product as the running store provider reports it, including localised price data. */
19
+ export interface StoreProduct {
20
+ /** The app's own product id. */
21
+ readonly id: string;
22
+ readonly kind: ProductKind;
23
+ /** The store's identifier for this product. */
24
+ readonly storeId: string;
25
+ /** Localised price string from the store, if available. */
26
+ readonly localizedPrice?: string;
27
+ }
28
+ /** A right the user has obtained, typically by purchase. */
29
+ export interface Entitlement {
30
+ readonly productId: string;
31
+ readonly obtainedAt: string;
32
+ readonly transactionId?: string;
33
+ }
34
+ /** Window/surface handle the store's native dialog should be modal to. */
35
+ export interface PurchaseContext {
36
+ /** The parent window or surface; type is platform-neutral on purpose. */
37
+ readonly parentWindow?: unknown;
38
+ }
39
+ /** Why a store provider cannot answer right now. */
40
+ export type StoreUnavailable = 'not-registered' | 'store-error' | 'network' | 'unknown';
41
+ /** The possible outcomes of a purchase call. */
42
+ export type PurchaseResult = {
43
+ readonly status: 'purchased';
44
+ readonly entitlement: Entitlement;
45
+ } | {
46
+ readonly status: 'already-owned';
47
+ readonly entitlement: Entitlement;
48
+ } | {
49
+ readonly status: 'cancelled';
50
+ } | {
51
+ readonly status: 'pending';
52
+ } | {
53
+ readonly status: 'unavailable';
54
+ readonly reason: StoreUnavailable;
55
+ };
56
+ /** One store backend. */
57
+ export interface StoreProvider {
58
+ /** Which commerce backend this provider talks to. */
59
+ readonly id: Commerce;
60
+ /** Load the subset of products the app declares for this provider. */
61
+ products(ids: readonly string[]): Promise<readonly StoreProduct[]>;
62
+ /** Start a purchase flow for `id`. */
63
+ purchase(id: string, ctx: PurchaseContext): Promise<PurchaseResult>;
64
+ /** Current entitlements for this user on this device. */
65
+ entitlements(): Promise<readonly Entitlement[]>;
66
+ /** Pull entitlements from the store, e.g. for a new device. */
67
+ restore(): Promise<readonly Entitlement[]>;
68
+ }
69
+ /** What {@link resolveSupport} offers when the channel allows store purchases. */
70
+ export interface SupportOffer {
71
+ /** The commerce backend that answered. */
72
+ readonly provider: Commerce;
73
+ /** Products available for purchase in this channel. */
74
+ readonly products: readonly StoreProduct[];
75
+ }
@@ -0,0 +1,8 @@
1
+ import type { Commerce, StoreProvider } from './types.js';
2
+ /** The commerce value used by the fallback provider. */
3
+ export declare const UNAVAILABLE_PROVIDER_ID: Commerce;
4
+ /**
5
+ * Fallback provider. It answers `unavailable` and empty entitlements, so an app that has no real
6
+ * store backend stays quiet rather than crashing.
7
+ */
8
+ export declare const unavailableProvider: StoreProvider;
package/package.json CHANGED
@@ -1,6 +1,69 @@
1
1
  {
2
- "name": "@gjsify/store",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
2
+ "name": "@gjsify/store",
3
+ "version": "0.64.32",
4
+ "description": "Store purchase and entitlement interface for gjsify apps (ADR 0139). Pure TypeScript, identical on GJS, Node and the browser.",
5
+ "type": "module",
6
+ "module": "lib/esm/index.js",
7
+ "types": "lib/types/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "types": "./lib/types/index.d.ts",
11
+ "default": "./lib/esm/index.js"
12
+ },
13
+ "./testing": {
14
+ "types": "./lib/types/testing/index.d.ts",
15
+ "default": "./lib/esm/testing/index.js"
16
+ }
17
+ },
18
+ "files": [
19
+ "lib"
20
+ ],
21
+ "scripts": {
22
+ "clear": "gjsify clear lib tmp *.tsbuildinfo test.gjs.mjs test.node.mjs",
23
+ "check": "gjsify tsc --noEmit",
24
+ "build": "gjsify run build:gjsify && gjsify run build:types",
25
+ "build:gjsify": "gjsify build --library 'src/**/*.{ts,js}' --exclude 'src/**/*.spec.{mts,ts}' 'src/test.{mts,ts}'",
26
+ "build:types": "gjsify tsc -p tsconfig.build.json",
27
+ "build:test": "gjsify run build:test:gjs && gjsify run build:test:node",
28
+ "build:test:gjs": "gjsify build src/test.mts --app gjs --outfile test.gjs.mjs",
29
+ "build:test:node": "gjsify build src/test.mts --app node --outfile test.node.mjs",
30
+ "build:test:browser": "gjsify build src/test.browser.mts --app browser --outfile dist/test.browser.mjs",
31
+ "test": "gjsify run build:gjsify && gjsify run build:test && gjsify run test:node && gjsify run test:gjs",
32
+ "test:gjs": "gjsify run test.gjs.mjs",
33
+ "test:node": "node test.node.mjs"
34
+ },
35
+ "keywords": [
36
+ "gjs",
37
+ "store",
38
+ "in-app-purchase",
39
+ "entitlement"
40
+ ],
41
+ "dependencies": {
42
+ "@gjsify/distribution": "^0.64.32"
43
+ },
44
+ "devDependencies": {
45
+ "@gjsify/cli": "^0.64.32",
46
+ "@gjsify/unit": "^0.64.32",
47
+ "@types/node": "^25.9.2",
48
+ "typescript": "^6.0.3"
49
+ },
50
+ "gjsify": {
51
+ "runtimes": {
52
+ "gjs": "polyfill",
53
+ "node": "polyfill",
54
+ "browser": "polyfill",
55
+ "nativescript": "polyfill"
56
+ },
57
+ "tier": 2
58
+ },
59
+ "license": "MIT",
60
+ "repository": {
61
+ "type": "git",
62
+ "url": "git+https://github.com/gjsify/gjsify.git",
63
+ "directory": "packages/framework/store"
64
+ },
65
+ "bugs": {
66
+ "url": "https://github.com/gjsify/gjsify/issues"
67
+ },
68
+ "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/framework/store#readme"
69
+ }