@mpgd/platform 0.20.0 → 0.22.0

package/dist/commerce.d.ts

@@ -1,6 +1,6 @@
 import { type tags } from 'typia';
 import { PlatformOperationError, type CommerceAdapter, type CommerceCapabilities } from './index.js';
-import type { ActiveSubscription, CommerceErrorCode, CommerceErrorInfo, CommerceEvent, CommerceLogicalProductId, CommerceProvider, FetchProductsInput, FinishTransactionInput, FinishTransactionResult, GetAvailablePurchasesInput, IsoTimestamp, NonEmptyString, NonNegativeInteger, PurchaseKind, RequestPurchaseInput, RequestPurchaseResult, StoreId, StoreProduct, StorePurchase } from './commerce-contract.js';
+import type { ActiveSubscription, CommerceErrorCode, CommerceErrorInfo, CommerceEvent, CommerceLogicalProductId, CommerceProvider, CommerceServiceCapabilities, FetchProductsInput, FinishTransactionInput, FinishTransactionResult, GetAvailablePurchasesInput, IsoTimestamp, NonEmptyString, NonNegativeInteger, PositiveQuantity, PurchaseKind, RequestPurchaseInput, RequestPurchaseResult, StoreId, StoreProduct, StorePurchase } from './commerce-contract.js';
 export { createUnsupportedCommerceCapabilities, deriveLegacyCommerceCapabilities, type LegacyCommerceCapabilities, } from './commerce-capabilities.js';
 export type { CommerceAccountBindingPolicy, CommerceAuthorityCapabilities, CommerceCapabilities, CommerceCatalogCapabilities, CommerceEvidenceAuthority, CommerceFinishOwner, CommerceLifecycleCapabilities, CommercePurchaseCapabilities, } from './index.js';
 /**
@@ -11,7 +11,7 @@ export type { CommerceAccountBindingPolicy, CommerceAuthorityCapabilities, Comme
 */
 export declare const commerceProtocolVersion: '2.0.0-draft.1';
 export declare const commerceProtocol: 'mpgd.commerce.v2';
-export type { ActiveSubscription, ActiveSubscriptionState, CommerceErrorCode, CommerceErrorInfo, CommerceEvent, CommerceLogicalProductId, CommerceProvider, FetchProductsInput, FetchProductsType, FinishTransactionInput, FinishTransactionResult, GetAvailablePurchasesInput, PurchaseKind, PurchaseSource, RequestPurchaseInput, RequestPurchaseResult, StoreId, StoreOffer, StorePrice, StoreProduct, StorePurchase, StorePurchaseAccountBinding, StorePurchaseState, } from './commerce-contract.js';
+export type { ActiveSubscription, ActiveSubscriptionState, CommerceErrorCode, CommerceErrorInfo, CommerceEvent, CommerceLogicalProductId, CommerceProvider, CommerceServiceCapabilities, CommerceServiceStoreCapabilities, FetchProductsInput, FetchProductsType, FinishTransactionInput, FinishTransactionResult, GetAvailablePurchasesInput, PurchaseKind, PurchaseSource, RequestPurchaseInput, RequestPurchaseResult, StoreId, StoreOffer, StorePrice, StoreProduct, StorePurchase, StorePurchaseAccountBinding, StorePurchaseState, } from './commerce-contract.js';
 export declare const commerceErrorCodes: readonly ["USER_CANCELLED", "OUTCOME_UNKNOWN", "ALREADY_OWNED", "IN_PROGRESS", "ITEM_UNAVAILABLE", "NOT_PREPARED", "NETWORK", "STORE_UNAVAILABLE", "CONFIGURATION_REQUIRED", "ACTION_REQUIRED", "ACCOUNT_BINDING_REQUIRED", "INSUFFICIENT_BALANCE", "INVALID_RESPONSE", "UNKNOWN"];
 /** Bridge event envelope; `sequence` is per session and starts at 0. */
 export interface CommerceEventEnvelope {
@@ -46,6 +46,12 @@ export interface CreditSpendInput {
   readonly currency: NonEmptyString;
   readonly amount: number & tags.ExclusiveMinimum<0>;
   readonly idempotencyKey: NonEmptyString;
+  /**
+  * The offer being bought; the wallet prices the spend against it and issues
+  * an entitlement. Without it the spend is a plain debit of `amount` with no
+  * entitlement, an owner-side form the conformance vectors use; a wallet
+  * service should require it from game clients.
+  */
   readonly logicalId?: CommerceLogicalProductId;
 }
 export interface CreditDebit {
@@ -56,6 +62,8 @@ export type CreditSpendResult = {
   readonly status: 'debited';
   readonly entitlementId: NonEmptyString;
   readonly debits: readonly CreditDebit[];
+  /** When the wallet settled the spend; a replay repeats the original time. */
+  readonly createdAt?: IsoTimestamp;
   /** A repeated idempotency key returns the original debits. */
   readonly alreadyProcessed?: boolean;
 } | {
@@ -69,6 +77,8 @@ export interface CreditEntitlement {
   readonly idempotencyKey: NonEmptyString;
   readonly createdAt: IsoTimestamp;
   readonly debits: readonly CreditDebit[];
+  /** Units bought at spend time; the provider reports it rather than deriving one from today's price. */
+  readonly quantity?: PositiveQuantity;
 }
 export interface CreditBalance {
   readonly titleId: NonEmptyString;
@@ -99,6 +109,13 @@ export interface CreditLot {
   /** Derived from the origin, never supplied by the caller. */
   readonly spendScope: CreditLotSpendScope;
 }
+/**
+* The client a consuming project implements against its wallet service.
+* `createCreditCommerceProvider` (`@mpgd/platform/commerce-wallet`) turns it
+* into a `CommerceProvider`. A `spend` of a membership offer starts the
+* membership under the spend's idempotency key as its subscription id; the
+* wallet service alone renews, lapses, and expires it.
+*/
 export interface CreditWalletClient {
   readonly store: StoreId;
   listOffers(input: {
@@ -108,6 +125,7 @@ export interface CreditWalletClient {
   listUnredeemed(input: {
     readonly titleId: string;
   }): Promise<readonly CreditEntitlement[]>;
+  /** Redeems an entitlement for the ledger entry that granted it; the wallet service verifies the pair. */
   redeem(input: {
     readonly entitlementId: string;
     readonly ledgerEntryId: string;
@@ -117,7 +135,15 @@ export interface CreditWalletClient {
   getBalance(input: {
     readonly titleId: string;
   }): Promise<CreditBalance>;
-  subscribe?(listener: (event: CommerceEvent) => void): () => void;
+  /** Memberships the wallet service reports as active for the title; absent when the wallet sells none. */
+  getActiveSubscriptions?(input: {
+    readonly titleId: string;
+  }): Promise<readonly ActiveSubscription[]>;
+  /** With `input.titleId`, only events that concern that title (platform memberships concern every title). */
+  subscribe?(listener: (event: CommerceEvent) => void, input?: CreditWalletSubscribeInput): () => void;
+}
+export interface CreditWalletSubscribeInput {
+  readonly titleId?: string;
 }
 export interface CommerceBridgeGetCapabilitiesPayload {
   readonly protocol: typeof commerceProtocol;
@@ -224,8 +250,9 @@ export interface DerivedPurchaseIdempotencyKeyInput {
 * the same key: `store:<storeId>:<transactionId>` by default, with each
 * component percent-encoded (`encodeURIComponent`) so ids containing `:`
 * cannot collide, and the forms v1 ledgers already use for Google Play
-* (`play-token-sha256:<hex>`) and Apps in Toss (`apps-in-toss:purchase:<orderId>`),
-* which stay byte-identical.
+* (`play-token-sha256:<hex>`) and Apps in Toss
+* (`apps-in-toss:purchase:<encodeURIComponent(orderId)>`), which stay
+* byte-identical.
 */
 export declare function createDerivedPurchaseIdempotencyKey(input: DerivedPurchaseIdempotencyKeyInput): Promise<string>;
 /** Byte-for-byte the v1 `createGooglePlayTokenTransactionId` form; A4 replaces the two copies with this helper. */
@@ -266,6 +293,8 @@ export declare const isActiveSubscription: (input: unknown) => input is ActiveSu
 export declare const assertFetchProductsInput: (input: unknown) => FetchProductsInput;
 export declare const assertCommerceCapabilities: (input: unknown) => CommerceCapabilities;
 export declare const isCommerceCapabilities: (input: unknown) => input is CommerceCapabilities;
+export declare const assertCommerceServiceCapabilities: (input: unknown) => CommerceServiceCapabilities;
+export declare const isCommerceServiceCapabilities: (input: unknown) => input is CommerceServiceCapabilities;
 export declare const assertCommerceErrorInfo: (input: unknown) => CommerceErrorInfo;
 export declare const assertCreditOffer: (input: unknown) => CreditOffer;
 export declare const assertCreditSpendInput: (input: unknown) => CreditSpendInput;

package/dist/commerce.js

@@ -204,8 +204,9 @@ export function assertRequestPurchaseSupported(capabilities, input, kind) {
  * the same key: `store:<storeId>:<transactionId>` by default, with each
  * component percent-encoded (`encodeURIComponent`) so ids containing `:`
  * cannot collide, and the forms v1 ledgers already use for Google Play
- * (`play-token-sha256:<hex>`) and Apps in Toss (`apps-in-toss:purchase:<orderId>`),
- * which stay byte-identical.
+ * (`play-token-sha256:<hex>`) and Apps in Toss
+ * (`apps-in-toss:purchase:<encodeURIComponent(orderId)>`), which stay
+ * byte-identical.
  */
 export async function createDerivedPurchaseIdempotencyKey(input) {
     const store = readIdentifier(input.store, 128);
@@ -220,7 +221,8 @@ export async function createDerivedPurchaseIdempotencyKey(input) {
         throw new TypeError('Derived purchase keys require a transaction id.');
     }
     if (store === 'apps-in-toss') {
-        return `apps-in-toss:purchase:${transactionId}`;
+        // Byte for byte the v1 `createAppsInTossPurchaseIdempotencyKey` form.
+        return `apps-in-toss:purchase:${encodeURIComponent(transactionId)}`;
     }
     return `store:${encodeURIComponent(store)}:${encodeURIComponent(transactionId)}`;
 }
@@ -3307,6 +3309,207 @@ export const isCommerceCapabilities = (() => {
     }));
     return (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true);
 })();
+export const assertCommerceServiceCapabilities = (() => {
+    const _ao0 = (input, _path, _exceptionable = true) => ("string" === typeof input.commerceProtocolVersion && (1 <= input.commerceProtocolVersion.length || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".commerceProtocolVersion",
+        expected: "string & CommerceMinLength<1>",
+        value: input.commerceProtocolVersion
+    }, _errorFactory)) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".commerceProtocolVersion",
+        expected: "(string & CommerceMinLength<1>)",
+        value: input.commerceProtocolVersion
+    }, _errorFactory)) && ((Array.isArray(input.stores) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".stores",
+        expected: "ReadonlyArray<CommerceServiceStoreCapabilities>",
+        value: input.stores
+    }, _errorFactory)) && input.stores.every((elem, _index3) => ("object" === typeof elem && null !== elem || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".stores[" + _index3 + "]",
+        expected: "CommerceServiceStoreCapabilities",
+        value: elem
+    }, _errorFactory)) && _ao1(elem, _path + ".stores[" + _index3 + "]", true && _exceptionable) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".stores[" + _index3 + "]",
+        expected: "CommerceServiceStoreCapabilities",
+        value: elem
+    }, _errorFactory)) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".stores",
+        expected: "ReadonlyArray<CommerceServiceStoreCapabilities>",
+        value: input.stores
+    }, _errorFactory)) && (2 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).every(key => {
+        if (["commerceProtocolVersion", "stores"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return _assertGuard_1._assertGuard(_exceptionable, {
+            method: "typia.createAssertEquals",
+            path: _path + _accessExpressionAsString_1._accessExpressionAsString(key),
+            expected: "undefined",
+            value: value
+        }, _errorFactory);
+    })));
+    const _ao1 = (input, _path, _exceptionable = true) => ("string" === typeof input.store && (1 <= input.store.length || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".store",
+        expected: "string & CommerceMinLength<1>",
+        value: input.store
+    }, _errorFactory)) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".store",
+        expected: "(string & CommerceMinLength<1>)",
+        value: input.store
+    }, _errorFactory)) && ((Array.isArray(input.schemas) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".schemas",
+        expected: "ReadonlyArray<NonEmptyString>",
+        value: input.schemas
+    }, _errorFactory)) && input.schemas.every((elem, _index4) => "string" === typeof elem && (1 <= elem.length || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".schemas[" + _index4 + "]",
+        expected: "string & CommerceMinLength<1>",
+        value: elem
+    }, _errorFactory)) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".schemas[" + _index4 + "]",
+        expected: "(string & CommerceMinLength<1>)",
+        value: elem
+    }, _errorFactory)) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".schemas",
+        expected: "ReadonlyArray<NonEmptyString>",
+        value: input.schemas
+    }, _errorFactory)) && ("client" === input.finish || "host" === input.finish || "none" === input.finish || "server" === input.finish || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".finish",
+        expected: "(\"client\" | \"host\" | \"none\" | \"server\")",
+        value: input.finish
+    }, _errorFactory)) && (("object" === typeof input.purchase && null !== input.purchase || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".purchase",
+        expected: "{ readonly consumable: boolean; readonly durable: boolean; readonly subscription: boolean; }",
+        value: input.purchase
+    }, _errorFactory)) && _ao2(input.purchase, _path + ".purchase", true && _exceptionable) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".purchase",
+        expected: "{ readonly consumable: boolean; readonly durable: boolean; readonly subscription: boolean; }",
+        value: input.purchase
+    }, _errorFactory)) && (4 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).every(key => {
+        if (["store", "schemas", "finish", "purchase"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return _assertGuard_1._assertGuard(_exceptionable, {
+            method: "typia.createAssertEquals",
+            path: _path + _accessExpressionAsString_1._accessExpressionAsString(key),
+            expected: "undefined",
+            value: value
+        }, _errorFactory);
+    })));
+    const _ao2 = (input, _path, _exceptionable = true) => ("boolean" === typeof input.consumable || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".consumable",
+        expected: "boolean",
+        value: input.consumable
+    }, _errorFactory)) && ("boolean" === typeof input.durable || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".durable",
+        expected: "boolean",
+        value: input.durable
+    }, _errorFactory)) && ("boolean" === typeof input.subscription || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".subscription",
+        expected: "boolean",
+        value: input.subscription
+    }, _errorFactory)) && (3 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).every(key => {
+        if (["consumable", "durable", "subscription"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return _assertGuard_1._assertGuard(_exceptionable, {
+            method: "typia.createAssertEquals",
+            path: _path + _accessExpressionAsString_1._accessExpressionAsString(key),
+            expected: "undefined",
+            value: value
+        }, _errorFactory);
+    })));
+    const _io0 = (input, _exceptionable = true) => "string" === typeof input.commerceProtocolVersion && 1 <= input.commerceProtocolVersion.length && (Array.isArray(input.stores) && input.stores.every((elem, _index1) => "object" === typeof elem && null !== elem && _io1(elem, true && _exceptionable))) && (2 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["commerceProtocolVersion", "stores"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    }));
+    const _io1 = (input, _exceptionable = true) => "string" === typeof input.store && 1 <= input.store.length && (Array.isArray(input.schemas) && input.schemas.every((elem, _index2) => "string" === typeof elem && 1 <= elem.length)) && ("client" === input.finish || "host" === input.finish || "none" === input.finish || "server" === input.finish) && ("object" === typeof input.purchase && null !== input.purchase && _io2(input.purchase, true && _exceptionable)) && (4 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["store", "schemas", "finish", "purchase"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    }));
+    const _io2 = (input, _exceptionable = true) => "boolean" === typeof input.consumable && "boolean" === typeof input.durable && "boolean" === typeof input.subscription && (3 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["consumable", "durable", "subscription"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    }));
+    const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true);
+    let _errorFactory;
+    return (input, errorFactory) => {
+        if (false === __is(input)) {
+            _errorFactory = errorFactory;
+            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _assertGuard_1._assertGuard(true, {
+                method: "typia.createAssertEquals",
+                path: _path + "",
+                expected: "CommerceServiceCapabilities",
+                value: input
+            }, _errorFactory)) && _ao0(input, _path + "", true) || _assertGuard_1._assertGuard(true, {
+                method: "typia.createAssertEquals",
+                path: _path + "",
+                expected: "CommerceServiceCapabilities",
+                value: input
+            }, _errorFactory))(input, "$input", true);
+        }
+        return input;
+    };
+})();
+export const isCommerceServiceCapabilities = (() => {
+    const _io0 = (input, _exceptionable = true) => "string" === typeof input.commerceProtocolVersion && 1 <= input.commerceProtocolVersion.length && (Array.isArray(input.stores) && input.stores.every((elem, _index1) => "object" === typeof elem && null !== elem && _io1(elem, true && _exceptionable))) && (2 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["commerceProtocolVersion", "stores"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    }));
+    const _io1 = (input, _exceptionable = true) => "string" === typeof input.store && 1 <= input.store.length && (Array.isArray(input.schemas) && input.schemas.every((elem, _index2) => "string" === typeof elem && 1 <= elem.length)) && ("client" === input.finish || "host" === input.finish || "none" === input.finish || "server" === input.finish) && ("object" === typeof input.purchase && null !== input.purchase && _io2(input.purchase, true && _exceptionable)) && (4 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["store", "schemas", "finish", "purchase"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    }));
+    const _io2 = (input, _exceptionable = true) => "boolean" === typeof input.consumable && "boolean" === typeof input.durable && "boolean" === typeof input.subscription && (3 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["consumable", "durable", "subscription"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    }));
+    return (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true);
+})();
 export const assertCommerceErrorInfo = (() => {
     const _iv0 = new Set(["ACCOUNT_BINDING_REQUIRED", "ACTION_REQUIRED", "ALREADY_OWNED", "CONFIGURATION_REQUIRED", "INSUFFICIENT_BALANCE", "INVALID_RESPONSE", "IN_PROGRESS", "ITEM_UNAVAILABLE", "NETWORK", "NOT_PREPARED", "OUTCOME_UNKNOWN", "STORE_UNAVAILABLE", "UNKNOWN", "USER_CANCELLED"]);
     const _av0 = new Set(["ACCOUNT_BINDING_REQUIRED", "ACTION_REQUIRED", "ALREADY_OWNED", "CONFIGURATION_REQUIRED", "INSUFFICIENT_BALANCE", "INVALID_RESPONSE", "IN_PROGRESS", "ITEM_UNAVAILABLE", "NETWORK", "NOT_PREPARED", "OUTCOME_UNKNOWN", "STORE_UNAVAILABLE", "UNKNOWN", "USER_CANCELLED"]);
@@ -3650,7 +3853,7 @@ export const assertCreditSpendInput = (() => {
 })();
 export const assertCreditSpendResult = (() => {
     const _iv0 = new Set(["ACCOUNT_BINDING_REQUIRED", "ACTION_REQUIRED", "ALREADY_OWNED", "CONFIGURATION_REQUIRED", "INSUFFICIENT_BALANCE", "INVALID_RESPONSE", "IN_PROGRESS", "ITEM_UNAVAILABLE", "NETWORK", "NOT_PREPARED", "OUTCOME_UNKNOWN", "STORE_UNAVAILABLE", "UNKNOWN", "USER_CANCELLED"]);
-    const _ae0 = "({ readonly status: \"debited\"; readonly entitlementId: NonEmptyString; readonly debits: readonly CreditDebit[]; readonly alreadyProcessed?: boolean; } | { readonly status: \"rejected\"; readonly error: CommerceErrorInfo; })";
+    const _ae0 = "({ readonly status: \"debited\"; readonly entitlementId: NonEmptyString; readonly debits: readonly CreditDebit[]; readonly createdAt?: IsoTimestamp; readonly alreadyProcessed?: boolean; } | { readonly status: \"rejected\"; readonly error: CommerceErrorInfo; })";
     const _av0 = new Set(["ACCOUNT_BINDING_REQUIRED", "ACTION_REQUIRED", "ALREADY_OWNED", "CONFIGURATION_REQUIRED", "INSUFFICIENT_BALANCE", "INVALID_RESPONSE", "IN_PROGRESS", "ITEM_UNAVAILABLE", "NETWORK", "NOT_PREPARED", "OUTCOME_UNKNOWN", "STORE_UNAVAILABLE", "UNKNOWN", "USER_CANCELLED"]);
     const _ae1 = "(\"ACCOUNT_BINDING_REQUIRED\" | \"ACTION_REQUIRED\" | \"ALREADY_OWNED\" | \"CONFIGURATION_REQUIRED\" | \"INSUFFICIENT_BALANCE\" | \"INVALID_RESPONSE\" | \"IN_PROGRESS\" | \"ITEM_UNAVAILABLE\" | \"NETWORK\" | \"NOT_PREPARED\" | \"OUTCOME_UNKNOWN\" | \"STORE_UNAVAILABLE\" | \"UNKNOWN\" | \"USER_CANCELLED\")";
     const _ao0 = (input, _path, _exceptionable = true) => ("debited" === input.status || _assertGuard_1._assertGuard(_exceptionable, {
@@ -3688,13 +3891,23 @@ export const assertCreditSpendResult = (() => {
         path: _path + ".debits",
         expected: "ReadonlyArray<CreditDebit>",
         value: input.debits
+    }, _errorFactory)) && (undefined === input.createdAt || "string" === typeof input.createdAt && (_isFormatDateTime_1._isFormatDateTime(input.createdAt) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".createdAt",
+        expected: "string & CommerceDateTimeFormat",
+        value: input.createdAt
+    }, _errorFactory)) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".createdAt",
+        expected: "((string & CommerceDateTimeFormat) | undefined)",
+        value: input.createdAt
     }, _errorFactory)) && (undefined === input.alreadyProcessed || "boolean" === typeof input.alreadyProcessed || _assertGuard_1._assertGuard(_exceptionable, {
         method: "typia.createAssertEquals",
         path: _path + ".alreadyProcessed",
         expected: "(boolean | undefined)",
         value: input.alreadyProcessed
     }, _errorFactory)) && (3 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).every(key => {
-        if (["status", "entitlementId", "debits", "alreadyProcessed"].some(prop => key === prop))
+        if (["status", "entitlementId", "debits", "createdAt", "alreadyProcessed"].some(prop => key === prop))
             return true;
         const value = input[key];
         if (undefined === value)
@@ -3813,8 +4026,8 @@ export const assertCreditSpendResult = (() => {
                 value: input
             }, _errorFactory);
     })();
-    const _io0 = (input, _exceptionable = true) => "debited" === input.status && ("string" === typeof input.entitlementId && 1 <= input.entitlementId.length) && (Array.isArray(input.debits) && input.debits.every((elem, _index1) => "object" === typeof elem && null !== elem && _io1(elem, true && _exceptionable))) && (undefined === input.alreadyProcessed || "boolean" === typeof input.alreadyProcessed) && (3 === Object.keys(input).length || Object.keys(input).every(key => {
-        if (["status", "entitlementId", "debits", "alreadyProcessed"].some(prop => key === prop))
+    const _io0 = (input, _exceptionable = true) => "debited" === input.status && ("string" === typeof input.entitlementId && 1 <= input.entitlementId.length) && (Array.isArray(input.debits) && input.debits.every((elem, _index1) => "object" === typeof elem && null !== elem && _io1(elem, true && _exceptionable))) && (undefined === input.createdAt || "string" === typeof input.createdAt && _isFormatDateTime_1._isFormatDateTime(input.createdAt)) && (undefined === input.alreadyProcessed || "boolean" === typeof input.alreadyProcessed) && (3 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["status", "entitlementId", "debits", "createdAt", "alreadyProcessed"].some(prop => key === prop))
             return true;
         const value = input[key];
         if (undefined === value)
@@ -3944,8 +4157,23 @@ export const assertCreditEntitlement = (() => {
         path: _path + ".debits",
         expected: "ReadonlyArray<CreditDebit>",
         value: input.debits
+    }, _errorFactory)) && (undefined === input.quantity || "number" === typeof input.quantity && (_isTypeUint32_1._isTypeUint32(input.quantity) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".quantity",
+        expected: "number & CommerceUint32",
+        value: input.quantity
+    }, _errorFactory)) && (1 <= input.quantity || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".quantity",
+        expected: "number & CommerceMinimum<1>",
+        value: input.quantity
+    }, _errorFactory)) || _assertGuard_1._assertGuard(_exceptionable, {
+        method: "typia.createAssertEquals",
+        path: _path + ".quantity",
+        expected: "((number & CommerceUint32 & CommerceMinimum<1>) | undefined)",
+        value: input.quantity
     }, _errorFactory)) && (6 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).every(key => {
-        if (["entitlementId", "titleId", "logicalId", "idempotencyKey", "createdAt", "debits"].some(prop => key === prop))
+        if (["entitlementId", "titleId", "logicalId", "idempotencyKey", "createdAt", "debits", "quantity"].some(prop => key === prop))
             return true;
         const value = input[key];
         if (undefined === value)
@@ -3990,8 +4218,8 @@ export const assertCreditEntitlement = (() => {
             value: value
         }, _errorFactory);
     })));
-    const _io0 = (input, _exceptionable = true) => "string" === typeof input.entitlementId && 1 <= input.entitlementId.length && ("string" === typeof input.titleId && 1 <= input.titleId.length) && ("string" === typeof input.logicalId && 1 <= input.logicalId.length) && ("string" === typeof input.idempotencyKey && 1 <= input.idempotencyKey.length) && ("string" === typeof input.createdAt && _isFormatDateTime_1._isFormatDateTime(input.createdAt)) && (Array.isArray(input.debits) && input.debits.every((elem, _index1) => "object" === typeof elem && null !== elem && _io1(elem, true && _exceptionable))) && (6 === Object.keys(input).length || Object.keys(input).every(key => {
-        if (["entitlementId", "titleId", "logicalId", "idempotencyKey", "createdAt", "debits"].some(prop => key === prop))
+    const _io0 = (input, _exceptionable = true) => "string" === typeof input.entitlementId && 1 <= input.entitlementId.length && ("string" === typeof input.titleId && 1 <= input.titleId.length) && ("string" === typeof input.logicalId && 1 <= input.logicalId.length) && ("string" === typeof input.idempotencyKey && 1 <= input.idempotencyKey.length) && ("string" === typeof input.createdAt && _isFormatDateTime_1._isFormatDateTime(input.createdAt)) && (Array.isArray(input.debits) && input.debits.every((elem, _index1) => "object" === typeof elem && null !== elem && _io1(elem, true && _exceptionable))) && (undefined === input.quantity || "number" === typeof input.quantity && (_isTypeUint32_1._isTypeUint32(input.quantity) && 1 <= input.quantity)) && (6 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["entitlementId", "titleId", "logicalId", "idempotencyKey", "createdAt", "debits", "quantity"].some(prop => key === prop))
             return true;
         const value = input[key];
         if (undefined === value)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/platform",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Shared platform gateway, monetization, ads, leaderboard, identity, lifecycle, and storage contracts for mpgd games.",
   "license": "MIT",
   "repository": {
@@ -56,6 +56,10 @@
     "./commerce-conformance": {
       "types": "./dist/commerce-conformance.d.ts",
       "default": "./dist/commerce-conformance.js"
+    },
+    "./commerce-wallet": {
+      "types": "./dist/commerce-wallet.d.ts",
+      "default": "./dist/commerce-wallet.js"
     }
   },
   "files": [
@@ -80,6 +84,6 @@
     "lint": "ttsc --noEmit",
     "format": "ttsc format",
     "fix": "ttsc fix",
-    "test": "vitest run && node test/capability-conformance-dist-import.mjs && node test/storage-conformance-dist-import.mjs && node test/ads-dist-import.mjs && node test/commerce-dist-import.mjs && node test/commerce-conformance-dist-import.mjs && cd ../.. && node tools/run-ttsx.mjs packages/platform/test/commerce-derived-key-parity.ts"
+    "test": "vitest run && node test/capability-conformance-dist-import.mjs && node test/storage-conformance-dist-import.mjs && node test/ads-dist-import.mjs && node test/commerce-dist-import.mjs && node test/commerce-conformance-dist-import.mjs && node test/wallet-commerce-dist-import.mjs && cd ../.. && node tools/run-ttsx.mjs packages/platform/test/commerce-derived-key-parity.ts"
   }
 }