@molecule/app-iap 1.0.0

package/LICENSE

@@ -0,0 +1,115 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship.
+
+      "Contribution" shall mean any work of authorship, including the
+      original version of the Work and any modifications or additions
+      to that Work, that is intentionally submitted to the Licensor for
+      inclusion in the Work by the copyright owner or by an individual or
+      Legal Entity authorized to submit on behalf of the copyright owner.
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      patent license to make, have made, use, offer to sell, sell, import,
+      and otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+   8. Limitation of Liability. In no event and under no legal theory shall
+      any Contributor be liable to You for damages.
+
+   9. Accepting Warranty or Additional Liability.
+
+   Copyright 2026 Molecule Dev, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/iap.d.ts

@@ -0,0 +1,12 @@
+/**
+ * No-op IAP provider implementation for molecule.dev.
+ *
+ * @module
+ */
+import type { IAPProvider } from './types.js';
+/**
+ * Creates a no-op IAP provider for web/testing.
+ * @returns A no-op IAP provider that stubs all purchase operations.
+ */
+export declare const createNoopIAPProvider: () => IAPProvider;
+//# sourceMappingURL=iap.d.ts.map

package/dist/iap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iap.d.ts","sourceRoot":"","sources":["../src/iap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAA6B,WAAW,EAA8B,MAAM,YAAY,CAAA;AAEpG;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,WA4GxC,CAAA"}

package/dist/iap.js

@@ -0,0 +1,103 @@
+/**
+ * No-op IAP provider implementation for molecule.dev.
+ *
+ * @module
+ */
+import { t } from '@molecule/app-i18n';
+/**
+ * Creates a no-op IAP provider for web/testing.
+ * @returns A no-op IAP provider that stubs all purchase operations.
+ */
+export const createNoopIAPProvider = () => {
+    const products = new Map();
+    const handlers = new Map();
+    return {
+        async initialize() {
+            // No-op
+        },
+        register(definitions) {
+            for (const def of definitions) {
+                products.set(def.id, {
+                    id: def.id,
+                    alias: def.alias,
+                    type: def.type,
+                    state: 'registered',
+                    title: def.alias,
+                    description: '',
+                    price: '$0.00',
+                    priceMicros: 0,
+                    currency: 'USD',
+                    canPurchase: false,
+                    owned: false,
+                    group: def.group,
+                });
+                products.set(def.alias, products.get(def.id));
+            }
+        },
+        async refresh() {
+            // No-op
+        },
+        get(idOrAlias) {
+            return products.get(idOrAlias);
+        },
+        getAll() {
+            return Array.from(new Set(products.values()));
+        },
+        canPurchase() {
+            return false;
+        },
+        async order() {
+            return {
+                success: false,
+                error: {
+                    code: 'E_NOT_AVAILABLE',
+                    message: t('iap.error.E_NOT_AVAILABLE', undefined, {
+                        defaultValue: 'In-app purchases are not available.',
+                    }),
+                },
+            };
+        },
+        finish() {
+            // No-op
+        },
+        async verify() {
+            return { valid: false };
+        },
+        async restore() {
+            return [];
+        },
+        manageSubscriptions() {
+            // No-op
+        },
+        when() {
+            return {
+                updated: () => { },
+                approved: () => { },
+                finished: () => { },
+                cancelled: () => { },
+                error: () => { },
+            };
+        },
+        on(event, handler) {
+            if (!handlers.has(event)) {
+                handlers.set(event, new Set());
+            }
+            handlers.get(event).add(handler);
+            return () => handlers.get(event)?.delete(handler);
+        },
+        off(handler) {
+            handlers.forEach((set) => set.delete(handler));
+        },
+        getPlatform() {
+            return 'web';
+        },
+        isAvailable() {
+            return false;
+        },
+        destroy() {
+            products.clear();
+            handlers.clear();
+        },
+    };
+};
+//# sourceMappingURL=iap.js.map

package/dist/iap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iap.js","sourceRoot":"","sources":["../src/iap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAA;AAItC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAgB,EAAE;IACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAA;IAExD,OAAO;QACL,KAAK,CAAC,UAAU;YACd,QAAQ;QACV,CAAC;QAED,QAAQ,CAAC,WAAgC;YACvC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;gBAC9B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE;oBACnB,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,KAAK,EAAE,YAAY;oBACnB,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,WAAW,EAAE,EAAE;oBACf,KAAK,EAAE,OAAO;oBACd,WAAW,EAAE,CAAC;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,KAAK;oBAClB,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,GAAG,CAAC,KAAK;iBACjB,CAAC,CAAA;gBACF,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAA;YAChD,CAAC;QACH,CAAC;QAED,KAAK,CAAC,OAAO;YACX,QAAQ;QACV,CAAC;QAED,GAAG,CAAC,SAAiB;YACnB,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAChC,CAAC;QAED,MAAM;YACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QAC/C,CAAC;QAED,WAAW;YACT,OAAO,KAAK,CAAA;QACd,CAAC;QAED,KAAK,CAAC,KAAK;YACT,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,CAAC,CAAC,2BAA2B,EAAE,SAAS,EAAE;wBACjD,YAAY,EAAE,qCAAqC;qBACpD,CAAC;iBACH;aACF,CAAA;QACH,CAAC;QAED,MAAM;YACJ,QAAQ;QACV,CAAC;QAED,KAAK,CAAC,MAAM;YACV,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;QACzB,CAAC;QAED,KAAK,CAAC,OAAO;YACX,OAAO,EAAE,CAAA;QACX,CAAC;QAED,mBAAmB;YACjB,QAAQ;QACV,CAAC;QAED,IAAI;YACF,OAAO;gBACL,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;gBACjB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;gBAClB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;gBAClB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;gBACnB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;aAChB,CAAA;QACH,CAAC;QAED,EAAE,CAAC,KAAe,EAAE,OAAwB;YAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;YAChC,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACjC,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACnD,CAAC;QAED,GAAG,CAAC,OAAwB;YAC1B,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;QAChD,CAAC;QAED,WAAW;YACT,OAAO,KAAK,CAAA;QACd,CAAC;QAED,WAAW;YACT,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO;YACL,QAAQ,CAAC,KAAK,EAAE,CAAA;YAChB,QAAQ,CAAC,KAAK,EAAE,CAAA;QAClB,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * In-App Purchases interface for molecule.dev.
+ *
+ * Provides a unified API for in-app purchases that works across
+ * different platforms (iOS App Store, Google Play, web Stripe).
+ *
+ * @example
+ * ```tsx
+ * import { createNoopIAPProvider, initialize, order, finish,
+ *   register, refresh, setProvider, verify } from '@molecule/app-iap'
+ *
+ * // Wire the provider at app startup (swap for an iOS/Android bond in production)
+ * setProvider(createNoopIAPProvider())
+ * await initialize()
+ * register([{ id: 'com.example.pro_monthly', alias: 'pro_monthly', type: 'subscription' }])
+ * await refresh()
+ *
+ * const result = await order('pro_monthly')
+ * if (result.success && result.product) {
+ *   await verify(result.product, '/api/iap/verify')
+ *   finish(result.product)
+ * }
+ * ```
+ * @remarks
+ * - NO store provider ships with the fleet yet: the only built-in
+ *   implementation is `createNoopIAPProvider()`, and `getProvider()` silently
+ *   self-bonds it when nothing is wired — so without a real provider
+ *   `order()` ALWAYS fails with `E_NOT_AVAILABLE`, `verify()` returns
+ *   `{ valid: false }`, and `isAvailable()` is `false`. To sell on iOS /
+ *   Android, implement `IAPProvider` yourself (e.g. wrapping
+ *   cordova-plugin-purchase, StoreKit 2, or Play Billing) and wire it with
+ *   `setProvider()` at startup.
+ * - `verify()` POSTs the purchase to YOUR server: implement the endpoint with
+ *   `@molecule/api-payments-apple` / `@molecule/api-payments-google` (receipt
+ *   validation) and call `finish()` only after the server says the receipt is
+ *   valid — finishing first loses the purchase if validation fails.
+ * - Error messages route through `t('iap.error.*')` with English fallbacks;
+ *   the `@molecule/app-locales-iap` bond supplies 79 translations.
+ *
+ * @module
+ */
+export * from './iap.js';
+export * from './provider.js';
+export * from './types.js';
+export * from './utilities.js';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,46 @@
+/**
+ * In-App Purchases interface for molecule.dev.
+ *
+ * Provides a unified API for in-app purchases that works across
+ * different platforms (iOS App Store, Google Play, web Stripe).
+ *
+ * @example
+ * ```tsx
+ * import { createNoopIAPProvider, initialize, order, finish,
+ *   register, refresh, setProvider, verify } from '@molecule/app-iap'
+ *
+ * // Wire the provider at app startup (swap for an iOS/Android bond in production)
+ * setProvider(createNoopIAPProvider())
+ * await initialize()
+ * register([{ id: 'com.example.pro_monthly', alias: 'pro_monthly', type: 'subscription' }])
+ * await refresh()
+ *
+ * const result = await order('pro_monthly')
+ * if (result.success && result.product) {
+ *   await verify(result.product, '/api/iap/verify')
+ *   finish(result.product)
+ * }
+ * ```
+ * @remarks
+ * - NO store provider ships with the fleet yet: the only built-in
+ *   implementation is `createNoopIAPProvider()`, and `getProvider()` silently
+ *   self-bonds it when nothing is wired — so without a real provider
+ *   `order()` ALWAYS fails with `E_NOT_AVAILABLE`, `verify()` returns
+ *   `{ valid: false }`, and `isAvailable()` is `false`. To sell on iOS /
+ *   Android, implement `IAPProvider` yourself (e.g. wrapping
+ *   cordova-plugin-purchase, StoreKit 2, or Play Billing) and wire it with
+ *   `setProvider()` at startup.
+ * - `verify()` POSTs the purchase to YOUR server: implement the endpoint with
+ *   `@molecule/api-payments-apple` / `@molecule/api-payments-google` (receipt
+ *   validation) and call `finish()` only after the server says the receipt is
+ *   valid — finishing first loses the purchase if validation fails.
+ * - Error messages route through `t('iap.error.*')` with English fallbacks;
+ *   the `@molecule/app-locales-iap` bond supplies 79 translations.
+ *
+ * @module
+ */
+export * from './iap.js';
+export * from './provider.js';
+export * from './types.js';
+export * from './utilities.js';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,87 @@
+/**
+ * IAP provider management for molecule.dev.
+ *
+ * @module
+ */
+import type { IAPProvider, Product, ProductDefinition, PurchaseResult, VerificationResult } from './types.js';
+/**
+ * Sets the IAP provider.
+ * @param provider - The IAP provider implementation to bond.
+ */
+export declare const setProvider: (provider: IAPProvider) => void;
+/**
+ * Gets the current IAP provider. Falls back to a no-op provider if none has been
+ * bonded — on web this is correct (no store exists), but on iOS/Android a missing
+ * real provider means every `order()` reports unavailable. The fallback warns when
+ * it engages so the omission is visible rather than a silent failure.
+ * @returns The active IAP provider instance.
+ */
+export declare const getProvider: () => IAPProvider;
+/**
+ * Checks if an IAP provider has been bonded.
+ * @returns Whether an IAP provider is currently registered.
+ */
+export declare const hasProvider: () => boolean;
+/**
+ * Initializes the IAP system via the active provider.
+ * @returns A promise that resolves when initialization is complete.
+ */
+export declare const initialize: () => Promise<void>;
+/**
+ * Registers product definitions with the IAP provider.
+ * @param products - The product definitions to register for purchase availability.
+ * @returns Nothing.
+ */
+export declare const register: (products: ProductDefinition[]) => void;
+/**
+ * Refreshes product information from the store.
+ * @returns A promise that resolves when product data has been refreshed.
+ */
+export declare const refresh: () => Promise<void>;
+/**
+ * Gets a product by its store ID or registered alias.
+ * @param idOrAlias - The product store ID or alias to look up.
+ * @returns The matching product, or undefined if not found.
+ */
+export declare const get: (idOrAlias: string) => Product | undefined;
+/**
+ * Gets all registered products.
+ * @returns An array of all available products.
+ */
+export declare const getAll: () => Product[];
+/**
+ * Initiates a purchase order for a product.
+ * @param idOrAlias - The product store ID or alias to purchase.
+ * @returns A promise that resolves with the purchase result.
+ */
+export declare const order: (idOrAlias: string) => Promise<PurchaseResult>;
+/**
+ * Finishes a pending transaction, acknowledging delivery to the store.
+ * @param product - The product whose transaction should be finalized.
+ * @returns Nothing.
+ */
+export declare const finish: (product: Product) => void;
+/**
+ * Verifies a purchase receipt with a server endpoint.
+ * @param product - The product whose purchase receipt to verify.
+ * @param verifyUrl - The server URL to send the verification request to.
+ * @param additionalData - Extra data to include in the verification payload.
+ * @returns A promise that resolves with the server verification result.
+ */
+export declare const verify: (product: Product, verifyUrl: string, additionalData?: Record<string, unknown>) => Promise<VerificationResult>;
+/**
+ * Restores previously completed purchases from the store.
+ * @returns A promise that resolves with an array of restored products.
+ */
+export declare const restore: () => Promise<Product[]>;
+/**
+ * Opens the platform's subscription management UI.
+ * @returns Nothing.
+ */
+export declare const manageSubscriptions: () => void;
+/**
+ * Checks if in-app purchases are available on the current platform.
+ * @returns Whether the IAP system is available and functional.
+ */
+export declare const isAvailable: () => boolean;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAInB;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,WAAW,KAAG,IAEnD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,QAAO,WAW9B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAO,OAE9B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAO,OAAO,CAAC,IAAI,CAA+B,CAAA;AAEzE;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,UAAU,iBAAiB,EAAE,KAAG,IAAwC,CAAA;AAEjG;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAO,OAAO,CAAC,IAAI,CAA4B,CAAA;AAEnE;;;;GAIG;AACH,eAAO,MAAM,GAAG,GAAI,WAAW,MAAM,KAAG,OAAO,GAAG,SAAyC,CAAA;AAE3F;;;GAGG;AACH,eAAO,MAAM,MAAM,QAAO,OAAO,EAA4B,CAAA;AAE7D;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,WAAW,MAAM,KAAG,OAAO,CAAC,cAAc,CAAmC,CAAA;AAEnG;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,SAAS,OAAO,KAAG,IAAqC,CAAA;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GACjB,SAAS,OAAO,EAChB,WAAW,MAAM,EACjB,iBAAiB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACvC,OAAO,CAAC,kBAAkB,CAA6D,CAAA;AAE1F;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAO,OAAO,CAAC,OAAO,EAAE,CAA4B,CAAA;AAExE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,IAA2C,CAAA;AAElF;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAO,OAAsC,CAAA"}

package/dist/provider.js

@@ -0,0 +1,102 @@
+/**
+ * IAP provider management for molecule.dev.
+ *
+ * @module
+ */
+import { bond, get as bondGet, isBonded } from '@molecule/app-bond';
+import { createNoopIAPProvider } from './iap.js';
+const BOND_TYPE = 'iap';
+/**
+ * Sets the IAP provider.
+ * @param provider - The IAP provider implementation to bond.
+ */
+export const setProvider = (provider) => {
+    bond(BOND_TYPE, provider);
+};
+/**
+ * Gets the current IAP provider. Falls back to a no-op provider if none has been
+ * bonded — on web this is correct (no store exists), but on iOS/Android a missing
+ * real provider means every `order()` reports unavailable. The fallback warns when
+ * it engages so the omission is visible rather than a silent failure.
+ * @returns The active IAP provider instance.
+ */
+export const getProvider = () => {
+    if (!isBonded(BOND_TYPE)) {
+        console.warn('[@molecule/app-iap] No IAP provider bonded — using the no-op provider, so ' +
+            'purchases report unavailable and order() always fails. No store provider ' +
+            'ships with the fleet: implement the IAPProvider interface (StoreKit 2 / ' +
+            'Play Billing / cordova-plugin-purchase) and call setProvider() at startup.');
+        bond(BOND_TYPE, createNoopIAPProvider());
+    }
+    return bondGet(BOND_TYPE);
+};
+/**
+ * Checks if an IAP provider has been bonded.
+ * @returns Whether an IAP provider is currently registered.
+ */
+export const hasProvider = () => {
+    return isBonded(BOND_TYPE);
+};
+/**
+ * Initializes the IAP system via the active provider.
+ * @returns A promise that resolves when initialization is complete.
+ */
+export const initialize = () => getProvider().initialize();
+/**
+ * Registers product definitions with the IAP provider.
+ * @param products - The product definitions to register for purchase availability.
+ * @returns Nothing.
+ */
+export const register = (products) => getProvider().register(products);
+/**
+ * Refreshes product information from the store.
+ * @returns A promise that resolves when product data has been refreshed.
+ */
+export const refresh = () => getProvider().refresh();
+/**
+ * Gets a product by its store ID or registered alias.
+ * @param idOrAlias - The product store ID or alias to look up.
+ * @returns The matching product, or undefined if not found.
+ */
+export const get = (idOrAlias) => getProvider().get(idOrAlias);
+/**
+ * Gets all registered products.
+ * @returns An array of all available products.
+ */
+export const getAll = () => getProvider().getAll();
+/**
+ * Initiates a purchase order for a product.
+ * @param idOrAlias - The product store ID or alias to purchase.
+ * @returns A promise that resolves with the purchase result.
+ */
+export const order = (idOrAlias) => getProvider().order(idOrAlias);
+/**
+ * Finishes a pending transaction, acknowledging delivery to the store.
+ * @param product - The product whose transaction should be finalized.
+ * @returns Nothing.
+ */
+export const finish = (product) => getProvider().finish(product);
+/**
+ * Verifies a purchase receipt with a server endpoint.
+ * @param product - The product whose purchase receipt to verify.
+ * @param verifyUrl - The server URL to send the verification request to.
+ * @param additionalData - Extra data to include in the verification payload.
+ * @returns A promise that resolves with the server verification result.
+ */
+export const verify = (product, verifyUrl, additionalData) => getProvider().verify(product, verifyUrl, additionalData);
+/**
+ * Restores previously completed purchases from the store.
+ * @returns A promise that resolves with an array of restored products.
+ */
+export const restore = () => getProvider().restore();
+/**
+ * Opens the platform's subscription management UI.
+ * @returns Nothing.
+ */
+export const manageSubscriptions = () => getProvider().manageSubscriptions();
+/**
+ * Checks if in-app purchases are available on the current platform.
+ * @returns Whether the IAP system is available and functional.
+ */
+export const isAvailable = () => getProvider().isAvailable();
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAShD,MAAM,SAAS,GAAG,KAAK,CAAA;AAEvB;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAqB,EAAQ,EAAE;IACzD,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;AAC3B,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAgB,EAAE;IAC3C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CACV,4EAA4E;YAC1E,2EAA2E;YAC3E,0EAA0E;YAC1E,4EAA4E,CAC/E,CAAA;QACD,IAAI,CAAC,SAAS,EAAE,qBAAqB,EAAE,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,OAAO,CAAc,SAAS,CAAE,CAAA;AACzC,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAY,EAAE;IACvC,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAA;AAC5B,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAkB,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,CAAA;AAEzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAA6B,EAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAEjG;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,GAAkB,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAA;AAEnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,SAAiB,EAAuB,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;AAE3F;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,GAAc,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,CAAA;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,SAAiB,EAA2B,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AAEnG;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,OAAgB,EAChB,SAAiB,EACjB,cAAwC,EACX,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAA;AAE1F;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,GAAuB,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAA;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAS,EAAE,CAAC,WAAW,EAAE,CAAC,mBAAmB,EAAE,CAAA;AAElF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAY,EAAE,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAA"}

package/dist/translations.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Default English translations for IAP error utilities.
+ *
+ * Used as inline fallbacks when no i18n provider is available.
+ *
+ * @module
+ */
+/**
+ * The default translations.
+ */
+export declare const defaultTranslations: {
+    readonly en: {
+        readonly 'iap.error.E_UNKNOWN': "An unknown error occurred.";
+        readonly 'iap.error.E_NOT_AVAILABLE': "In-app purchases are not available.";
+        readonly 'iap.error.E_USER_CANCELLED': "Purchase was cancelled.";
+        readonly 'iap.error.E_ITEM_UNAVAILABLE': "This item is not available for purchase.";
+        readonly 'iap.error.E_NETWORK': "A network error occurred. Please try again.";
+        readonly 'iap.error.E_SERVICE_ERROR': "The store service encountered an error.";
+        readonly 'iap.error.E_ALREADY_OWNED': "You already own this item.";
+        readonly 'iap.error.E_NOT_OWNED': "You do not own this item.";
+        readonly 'iap.error.E_VERIFICATION_FAILED': "Purchase verification failed.";
+        readonly 'iap.error.E_DEFERRED': "Purchase is pending approval.";
+    };
+};
+//# sourceMappingURL=translations.d.ts.map

package/dist/translations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../src/translations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;CAatB,CAAA"}

package/dist/translations.js

@@ -0,0 +1,25 @@
+/**
+ * Default English translations for IAP error utilities.
+ *
+ * Used as inline fallbacks when no i18n provider is available.
+ *
+ * @module
+ */
+/**
+ * The default translations.
+ */
+export const defaultTranslations = {
+    en: {
+        'iap.error.E_UNKNOWN': 'An unknown error occurred.',
+        'iap.error.E_NOT_AVAILABLE': 'In-app purchases are not available.',
+        'iap.error.E_USER_CANCELLED': 'Purchase was cancelled.',
+        'iap.error.E_ITEM_UNAVAILABLE': 'This item is not available for purchase.',
+        'iap.error.E_NETWORK': 'A network error occurred. Please try again.',
+        'iap.error.E_SERVICE_ERROR': 'The store service encountered an error.',
+        'iap.error.E_ALREADY_OWNED': 'You already own this item.',
+        'iap.error.E_NOT_OWNED': 'You do not own this item.',
+        'iap.error.E_VERIFICATION_FAILED': 'Purchase verification failed.',
+        'iap.error.E_DEFERRED': 'Purchase is pending approval.',
+    },
+};
+//# sourceMappingURL=translations.js.map

package/dist/translations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.js","sourceRoot":"","sources":["../src/translations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE;QACF,qBAAqB,EAAE,4BAA4B;QACnD,2BAA2B,EAAE,qCAAqC;QAClE,4BAA4B,EAAE,yBAAyB;QACvD,8BAA8B,EAAE,0CAA0C;QAC1E,qBAAqB,EAAE,6CAA6C;QACpE,2BAA2B,EAAE,yCAAyC;QACtE,2BAA2B,EAAE,4BAA4B;QACzD,uBAAuB,EAAE,2BAA2B;QACpD,iCAAiC,EAAE,+BAA+B;QAClE,sBAAsB,EAAE,+BAA+B;KACxD;CACO,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,311 @@
+/**
+ * In-App Purchases types for molecule.dev.
+ *
+ * @module
+ */
+/**
+ * In-app purchase product categories: one-time consumable, permanent non-consumable, or recurring subscription.
+ */
+export type ProductType = 'consumable' | 'non-consumable' | 'subscription';
+/**
+ * Purchase lifecycle state of an in-app product (registered, valid, approved, owned, cancelled, etc.).
+ */
+export type ProductState = 'registered' | 'valid' | 'invalid' | 'requested' | 'initiated' | 'approved' | 'finished' | 'owned' | 'cancelled' | 'downloading';
+/**
+ * Subscription billing interval: weekly, monthly, yearly, or lifetime.
+ */
+export type SubscriptionPeriod = 'weekly' | 'monthly' | 'yearly' | 'lifetime';
+/**
+ * Product definition for registration.
+ */
+export interface ProductDefinition {
+    /**
+     * Product ID (SKU) - platform-specific identifier.
+     */
+    id: string;
+    /**
+     * Product alias - cross-platform identifier.
+     */
+    alias: string;
+    /**
+     * Product type.
+     */
+    type: ProductType;
+    /**
+     * Product group (for subscription grouping).
+     */
+    group?: string;
+}
+/**
+ * Full in-app product details (ID, type, state, pricing, ownership, transaction, subscription info).
+ */
+export interface Product {
+    /**
+     * Product ID (SKU).
+     */
+    id: string;
+    /**
+     * Product alias.
+     */
+    alias: string;
+    /**
+     * Product type.
+     */
+    type: ProductType;
+    /**
+     * Product state.
+     */
+    state: ProductState;
+    /**
+     * Product title.
+     */
+    title: string;
+    /**
+     * Product description.
+     */
+    description: string;
+    /**
+     * Formatted price string.
+     */
+    price: string;
+    /**
+     * Price in micros (cents * 10000).
+     */
+    priceMicros: number;
+    /**
+     * Currency code (ISO 4217).
+     */
+    currency: string;
+    /**
+     * Whether the product can be purchased.
+     */
+    canPurchase: boolean;
+    /**
+     * Whether the product is owned.
+     */
+    owned: boolean;
+    /**
+     * Transaction information (if applicable).
+     */
+    transaction?: Transaction;
+    /**
+     * Subscription period (for subscriptions).
+     */
+    subscriptionPeriod?: SubscriptionPeriod;
+    /**
+     * Introductory price (for subscriptions with trial).
+     */
+    introPrice?: string;
+    /**
+     * Trial period in days.
+     */
+    trialPeriodDays?: number;
+    /**
+     * Product group.
+     */
+    group?: string;
+    /**
+     * Raw platform-specific data.
+     */
+    raw?: unknown;
+}
+/**
+ * Purchase transaction record (ID, receipt, purchase token, timestamps, validity).
+ */
+export interface Transaction {
+    /**
+     * Transaction ID.
+     */
+    id: string;
+    /**
+     * Platform-specific receipt.
+     */
+    receipt?: string;
+    /**
+     * App Store receipt (iOS).
+     */
+    appStoreReceipt?: string;
+    /**
+     * Purchase token (Android).
+     */
+    purchaseToken?: string;
+    /**
+     * Purchase time.
+     */
+    purchaseTime?: Date;
+    /**
+     * Expiration time (for subscriptions).
+     */
+    expirationTime?: Date;
+    /**
+     * Whether the purchase is valid.
+     */
+    isValid?: boolean;
+    /**
+     * Raw platform-specific data.
+     */
+    raw?: unknown;
+}
+/**
+ * In-app purchase error with error code, product ID, and platform-specific details.
+ */
+export interface IAPError {
+    /**
+     * Error code.
+     */
+    code: string | number;
+    /**
+     * Error message.
+     */
+    message: string;
+    /**
+     * Product ID (if applicable).
+     */
+    productId?: string;
+    /**
+     * Raw error.
+     */
+    raw?: unknown;
+}
+/**
+ * Outcome of a purchase attempt (success flag, product, transaction, or error).
+ */
+export interface PurchaseResult {
+    /**
+     * Whether the purchase was successful.
+     */
+    success: boolean;
+    /**
+     * The purchased product.
+     */
+    product?: Product;
+    /**
+     * Transaction information.
+     */
+    transaction?: Transaction;
+    /**
+     * Error (if purchase failed).
+     */
+    error?: IAPError;
+}
+/**
+ * Verification result from server.
+ */
+export interface VerificationResult {
+    /**
+     * Whether the receipt is valid.
+     */
+    valid: boolean;
+    /**
+     * Subscription expiration time.
+     */
+    expirationTime?: Date;
+    /**
+     * Whether the subscription is active.
+     */
+    isActive?: boolean;
+    /**
+     * Plan/tier information.
+     */
+    plan?: string;
+    /**
+     * Server response data.
+     */
+    data?: unknown;
+}
+/**
+ * IAP lifecycle events: ready, product-updated, approved, finished, cancelled, error, pending, expired, restored.
+ */
+export type IAPEvent = 'ready' | 'product-updated' | 'approved' | 'finished' | 'cancelled' | 'error' | 'pending' | 'expired' | 'restored';
+/**
+ * Generic event handler for IAP events.
+ */
+export type IAPEventHandler<T = unknown> = (data: T) => void;
+/**
+ * Event handler called with a Product when a product-related event occurs.
+ */
+export type ProductEventHandler = (product: Product) => void;
+/**
+ * Event handler called with an IAPError when a purchase error occurs.
+ */
+export type ErrorEventHandler = (error: IAPError) => void;
+/**
+ * In-App Purchases provider interface.
+ */
+export interface IAPProvider {
+    /**
+     * Initializes the IAP system.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Registers products for purchase.
+     */
+    register(products: ProductDefinition[]): void;
+    /**
+     * Refreshes product information from the store.
+     */
+    refresh(): Promise<void>;
+    /**
+     * Gets a product by ID or alias.
+     */
+    get(idOrAlias: string): Product | undefined;
+    /**
+     * Gets all registered products.
+     */
+    getAll(): Product[];
+    /**
+     * Checks if a product can be purchased.
+     */
+    canPurchase(idOrAlias: string): boolean;
+    /**
+     * Initiates a purchase.
+     */
+    order(idOrAlias: string): Promise<PurchaseResult>;
+    /**
+     * Finishes a transaction (must be called after successful verification).
+     */
+    finish(product: Product): void;
+    /**
+     * Verifies a purchase with the server.
+     */
+    verify(product: Product, verifyUrl: string, additionalData?: Record<string, unknown>): Promise<VerificationResult>;
+    /**
+     * Restores previous purchases.
+     */
+    restore(): Promise<Product[]>;
+    /**
+     * Opens the subscription management page.
+     */
+    manageSubscriptions(): void;
+    /**
+     * Subscribes to product events.
+     */
+    when(idOrAlias: string): {
+        updated: (handler: ProductEventHandler) => void;
+        approved: (handler: ProductEventHandler) => void;
+        finished: (handler: ProductEventHandler) => void;
+        cancelled: (handler: ProductEventHandler) => void;
+        error: (handler: ErrorEventHandler) => void;
+    };
+    /**
+     * Subscribes to global events.
+     */
+    on(event: IAPEvent, handler: IAPEventHandler): () => void;
+    /**
+     * Unsubscribes from events.
+     */
+    off(handler: IAPEventHandler): void;
+    /**
+     * Gets the platform name.
+     */
+    getPlatform(): 'ios' | 'android' | 'web' | 'unknown';
+    /**
+     * Checks if IAP is available.
+     */
+    isAvailable(): boolean;
+    /**
+     * Destroys the IAP system.
+     */
+    destroy(): void;
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * In-App Purchases types for molecule.dev.
+ *
+ * @module
+ */
+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":"AAAA;;;;GAIG"}

package/dist/utilities.d.ts

@@ -0,0 +1,21 @@
+/**
+ * In-App Purchases utilities for molecule.dev.
+ *
+ * @module
+ */
+import type { IAPError } from './types.js';
+/**
+ * Error code mapping for user-friendly messages.
+ * Derived from defaultTranslations to avoid duplicating strings.
+ */
+export declare const errorMessages: Record<string, string>;
+/**
+ * Gets a user-friendly error message.
+ * @param error - The IAP error object or unknown thrown value to translate.
+ * @param t - Optional i18n translation function for localized messages.
+ * @returns A user-friendly error message string.
+ */
+export declare const getErrorMessage: (error: IAPError | unknown, t?: (key: string, values?: Record<string, unknown>, options?: {
+    defaultValue?: string;
+}) => string) => string;
+//# sourceMappingURL=utilities.d.ts.map

package/dist/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKhD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,QAAQ,GAAG,OAAO,EACzB,IAAI,CACF,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KAChC,MAAM,KACV,MAqBF,CAAA"}

package/dist/utilities.js

@@ -0,0 +1,39 @@
+/**
+ * In-App Purchases utilities for molecule.dev.
+ *
+ * @module
+ */
+import { defaultTranslations } from './translations.js';
+/**
+ * Error code mapping for user-friendly messages.
+ * Derived from defaultTranslations to avoid duplicating strings.
+ */
+export const errorMessages = Object.fromEntries(Object.entries(defaultTranslations.en).map(([key, value]) => [
+    key.replace('iap.error.', ''),
+    value,
+]));
+/**
+ * Gets a user-friendly error message.
+ * @param error - The IAP error object or unknown thrown value to translate.
+ * @param t - Optional i18n translation function for localized messages.
+ * @returns A user-friendly error message string.
+ */
+export const getErrorMessage = (error, t) => {
+    if (typeof error === 'object' && error !== null) {
+        const e = error;
+        const code = String(e.code || '');
+        if (errorMessages[code]) {
+            const defaultMsg = errorMessages[code];
+            return t ? t(`iap.error.${code}`, undefined, { defaultValue: defaultMsg }) : defaultMsg;
+        }
+        if (e.message) {
+            return e.message;
+        }
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    const fallback = errorMessages.E_UNKNOWN;
+    return t ? t('iap.error.E_UNKNOWN', undefined, { defaultValue: fallback }) : fallback;
+};
+//# sourceMappingURL=utilities.js.map

package/dist/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAGvD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B,MAAM,CAAC,WAAW,CACrE,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;IAC3D,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;IAC7B,KAAK;CACN,CAAC,CACH,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAyB,EACzB,CAIW,EACH,EAAE;IACV,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,KAAiB,CAAA;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;QAEjC,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;YACtC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;QACzF,CAAC;QAED,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,CAAC,CAAC,OAAO,CAAA;QAClB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAS,CAAA;IACxC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;AACvF,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@molecule/app-iap",
+  "version": "1.0.0",
+  "description": "In-App Purchases interface for molecule.dev",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "molecule",
+    "iap",
+    "in-app-purchases",
+    "app-store",
+    "play-store",
+    "subscriptions"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@molecule/app-bond": "^1.0.0",
+    "@molecule/app-i18n": "^1.0.0"
+  },
+  "devDependencies": {
+    "@molecule/app-bond": "1.0.0",
+    "@molecule/app-i18n": "1.0.0",
+    "@types/node": "26.1.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/app/features/iap"
+  },
+  "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/app/features/iap",
+  "bugs": "https://github.com/molecule-dev/molecule/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}