@veruna/api-contracts 20.0.0 → 20.1.0

package/build/v1/wallet/schemas/balance-type-code.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"balance-type-code.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/balance-type-code.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,eA6CX;AA7CD,WAAY,eAAe;IACvB,gDAA6B,CAAA;IAC7B,8CAA2B,CAAA;IAQ3B,kDAA+B,CAAA;IAO/B,4DAAyC,CAAA;IAMzC,kDAA+B,CAAA;IAO/B,8CAA2B,CAAA;IAO3B,wCAAqB,CAAA;IAOrB,8CAA2B,CAAA;AAC/B,CAAC,EA7CW,eAAe,+BAAf,eAAe,QA6C1B"}
+{"version":3,"file":"balance-type-code.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/balance-type-code.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,eA6CX;AA7CD,WAAY,eAAe;IACvB,gDAA6B,CAAA;IAC7B,8CAA2B,CAAA;IAC3B;;;;;;OAMG;IACH,kDAA+B,CAAA;IAC/B;;;;;OAKG;IACH,4DAAyC,CAAA;IACzC;;;;OAIG;IACH,kDAA+B,CAAA;IAC/B;;;;;OAKG;IACH,8CAA2B,CAAA;IAC3B;;;;;OAKG;IACH,wCAAqB,CAAA;IACrB;;;;;OAKG;IACH,8CAA2B,CAAA;AAC/B,CAAC,EA7CW,eAAe,+BAAf,eAAe,QA6C1B"}

package/build/v1/wallet/schemas/hold-status.enum.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Hold Status Enum
+ * See WALLET_API.md section 2.3
+ */
 export declare enum HoldStatus {
     PENDING = "PENDING",
     CONFIRMED = "CONFIRMED",

package/build/v1/wallet/schemas/hold-status.enum.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HoldStatus = void 0;
+/**
+ * Hold Status Enum
+ * See WALLET_API.md section 2.3
+ */
 var HoldStatus;
 (function (HoldStatus) {
     HoldStatus["PENDING"] = "PENDING";

package/build/v1/wallet/schemas/hold-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"hold-status.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/hold-status.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,UAKX;AALD,WAAY,UAAU;IAClB,iCAAmB,CAAA;IACnB,qCAAuB,CAAA;IACvB,mCAAqB,CAAA;IACrB,iCAAmB,CAAA;AACvB,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB"}
+{"version":3,"file":"hold-status.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/hold-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,UAKX;AALD,WAAY,UAAU;IAClB,iCAAmB,CAAA;IACnB,qCAAuB,CAAA;IACvB,mCAAqB,CAAA;IACrB,iCAAmB,CAAA;AACvB,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB"}

package/build/v1/wallet/schemas/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_METADATA_KEYS = exports.MAX_NESTING_DEPTH = exports.MAX_METADATA_SIZE = exports.validateMetadata = exports.MetadataSchema = exports.WalletEventBreakdownItemSchema = exports.WalletEventsListRequestSchema = exports.WalletEventsListResponseSchema = exports.WalletEventItemSchema = exports.BalanceSummaryResponseSchema = exports.BalanceActiveHoldSchema = exports.BalanceItemResponseSchema = exports.WalletEventKind = exports.WalletEventDirection = exports.InitiatorType = exports.SourceType = exports.isValidTransactionType = exports.TransactionType = exports.HoldStatus = exports.BalanceTypeCode = exports.BalanceStatus = void 0;
+// Enums
 var balance_status_enum_1 = require("./balance-status.enum");
 Object.defineProperty(exports, "BalanceStatus", { enumerable: true, get: function () { return balance_status_enum_1.BalanceStatus; } });
 var balance_type_code_enum_1 = require("./balance-type-code.enum");
@@ -18,6 +19,7 @@ var wallet_event_direction_enum_1 = require("./wallet-event-direction.enum");
 Object.defineProperty(exports, "WalletEventDirection", { enumerable: true, get: function () { return wallet_event_direction_enum_1.WalletEventDirection; } });
 var wallet_event_kind_enum_1 = require("./wallet-event-kind.enum");
 Object.defineProperty(exports, "WalletEventKind", { enumerable: true, get: function () { return wallet_event_kind_enum_1.WalletEventKind; } });
+// Response schemas
 var balance_response_schema_1 = require("./balance-response.schema");
 Object.defineProperty(exports, "BalanceItemResponseSchema", { enumerable: true, get: function () { return balance_response_schema_1.BalanceItemResponseSchema; } });
 Object.defineProperty(exports, "BalanceActiveHoldSchema", { enumerable: true, get: function () { return balance_response_schema_1.BalanceActiveHoldSchema; } });
@@ -28,6 +30,7 @@ Object.defineProperty(exports, "WalletEventsListResponseSchema", { enumerable: t
 Object.defineProperty(exports, "WalletEventsListRequestSchema", { enumerable: true, get: function () { return wallet_event_schema_1.WalletEventsListRequestSchema; } });
 var wallet_event_breakdown_schema_1 = require("./wallet-event-breakdown.schema");
 Object.defineProperty(exports, "WalletEventBreakdownItemSchema", { enumerable: true, get: function () { return wallet_event_breakdown_schema_1.WalletEventBreakdownItemSchema; } });
+// Metadata validation
 var metadata_schema_1 = require("./metadata.schema");
 Object.defineProperty(exports, "MetadataSchema", { enumerable: true, get: function () { return metadata_schema_1.MetadataSchema; } });
 Object.defineProperty(exports, "validateMetadata", { enumerable: true, get: function () { return metadata_schema_1.validateMetadata; } });

package/build/v1/wallet/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/index.ts"],"names":[],"mappings":";;;AACA,6DAAsD;AAA7C,oHAAA,aAAa,OAAA;AACtB,mEAA2D;AAAlD,yHAAA,eAAe,OAAA;AACxB,uDAAgD;AAAvC,8GAAA,UAAU,OAAA;AACnB,iEAAkF;AAAzE,wHAAA,eAAe,OAAA;AAAE,+HAAA,sBAAsB,OAAA;AAChD,uDAAgD;AAAvC,8GAAA,UAAU,OAAA;AACnB,6DAAsD;AAA7C,oHAAA,aAAa,OAAA;AACtB,6EAAqE;AAA5D,mIAAA,oBAAoB,OAAA;AAC7B,mEAA2D;AAAlD,yHAAA,eAAe,OAAA;AAGxB,qEAOmC;AAN/B,oIAAA,yBAAyB,OAAA;AACzB,kIAAA,uBAAuB,OAAA;AACvB,uIAAA,4BAA4B,OAAA;AAMhC,6DAO+B;AAN3B,4HAAA,qBAAqB,OAAA;AACrB,qIAAA,8BAA8B,OAAA;AAC9B,oIAAA,6BAA6B,OAAA;AAMjC,iFAGyC;AAFrC,+IAAA,8BAA8B,OAAA;AAKlC,qDAO2B;AANvB,iHAAA,cAAc,OAAA;AACd,mHAAA,gBAAgB,OAAA;AAChB,oHAAA,iBAAiB,OAAA;AACjB,oHAAA,iBAAiB,OAAA;AACjB,oHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/index.ts"],"names":[],"mappings":";;;AAAA,QAAQ;AACR,6DAAsD;AAA7C,oHAAA,aAAa,OAAA;AACtB,mEAA2D;AAAlD,yHAAA,eAAe,OAAA;AACxB,uDAAgD;AAAvC,8GAAA,UAAU,OAAA;AACnB,iEAAkF;AAAzE,wHAAA,eAAe,OAAA;AAAE,+HAAA,sBAAsB,OAAA;AAChD,uDAAgD;AAAvC,8GAAA,UAAU,OAAA;AACnB,6DAAsD;AAA7C,oHAAA,aAAa,OAAA;AACtB,6EAAqE;AAA5D,mIAAA,oBAAoB,OAAA;AAC7B,mEAA2D;AAAlD,yHAAA,eAAe,OAAA;AAExB,mBAAmB;AACnB,qEAOmC;AAN/B,oIAAA,yBAAyB,OAAA;AACzB,kIAAA,uBAAuB,OAAA;AACvB,uIAAA,4BAA4B,OAAA;AAMhC,6DAO+B;AAN3B,4HAAA,qBAAqB,OAAA;AACrB,qIAAA,8BAA8B,OAAA;AAC9B,oIAAA,6BAA6B,OAAA;AAMjC,iFAGyC;AAFrC,+IAAA,8BAA8B,OAAA;AAIlC,sBAAsB;AACtB,qDAO2B;AANvB,iHAAA,cAAc,OAAA;AACd,mHAAA,gBAAgB,OAAA;AAChB,oHAAA,iBAAiB,OAAA;AACjB,oHAAA,iBAAiB,OAAA;AACjB,oHAAA,iBAAiB,OAAA"}

package/build/v1/wallet/schemas/initiator-type.enum.d.ts

@@ -1,5 +1,12 @@
+/**
+ * Type of entity that initiated the wallet operation
+ * Used for audit tracking
+ */
 export declare enum InitiatorType {
+    /** Operation initiated by end user */
     USER = "USER",
+    /** Operation initiated by system (background jobs, automated processes) */
     SYSTEM = "SYSTEM",
+    /** Operation initiated by admin */
     ADMIN = "ADMIN"
 }

package/build/v1/wallet/schemas/initiator-type.enum.js

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InitiatorType = void 0;
+/**
+ * Type of entity that initiated the wallet operation
+ * Used for audit tracking
+ */
 var InitiatorType;
 (function (InitiatorType) {
+    /** Operation initiated by end user */
     InitiatorType["USER"] = "USER";
+    /** Operation initiated by system (background jobs, automated processes) */
     InitiatorType["SYSTEM"] = "SYSTEM";
+    /** Operation initiated by admin */
     InitiatorType["ADMIN"] = "ADMIN";
 })(InitiatorType || (exports.InitiatorType = InitiatorType = {}));
 //# sourceMappingURL=initiator-type.enum.js.map

package/build/v1/wallet/schemas/initiator-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"initiator-type.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/initiator-type.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,aAOX;AAPD,WAAY,aAAa;IAErB,8BAAa,CAAA;IAEb,kCAAiB,CAAA;IAEjB,gCAAe,CAAA;AACnB,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB"}
+{"version":3,"file":"initiator-type.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/initiator-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,aAOX;AAPD,WAAY,aAAa;IACrB,sCAAsC;IACtC,8BAAa,CAAA;IACb,2EAA2E;IAC3E,kCAAiB,CAAA;IACjB,mCAAmC;IACnC,gCAAe,CAAA;AACnB,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB"}

package/build/v1/wallet/schemas/metadata.schema.d.ts

@@ -1,9 +1,32 @@
 import { z } from 'zod';
+/**
+ * Maximum size of metadata JSON in bytes.
+ */
 export declare const MAX_METADATA_SIZE = 4096;
+/**
+ * Maximum nesting depth for metadata objects.
+ */
 export declare const MAX_NESTING_DEPTH = 3;
+/**
+ * Maximum number of keys in metadata.
+ */
 export declare const MAX_METADATA_KEYS = 20;
+/**
+ * Public wallet metadata schema used by request payloads. Accepts
+ * `undefined` (field omitted) and `null` (explicitly cleared) in
+ * addition to a valid metadata object.
+ */
 export declare const MetadataSchema: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
 export type Metadata = z.infer<typeof MetadataSchema>;
+/**
+ * Validate unknown metadata input and return either a sanitised
+ * record or an error message. Accepts `null` / `undefined` as
+ * "no metadata".
+ *
+ * Thin wallet-facing wrapper around the shared `validateMetadataWith`
+ * helper so existing callers (`TransactionMetadata.create`) keep
+ * working unchanged.
+ */
 export declare function validateMetadata(metadata: unknown): {
     valid: true;
     data: Record<string, unknown> | null;

package/build/v1/wallet/schemas/metadata.schema.js

@@ -3,15 +3,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetadataSchema = exports.MAX_METADATA_KEYS = exports.MAX_NESTING_DEPTH = exports.MAX_METADATA_SIZE = void 0;
 exports.validateMetadata = validateMetadata;
 const metadata_schema_1 = require("../../../shared/metadata.schema");
-exports.MAX_METADATA_SIZE = 4096;
+/**
+ * Maximum size of metadata JSON in bytes.
+ */
+exports.MAX_METADATA_SIZE = 4096; // 4KB
+/**
+ * Maximum nesting depth for metadata objects.
+ */
 exports.MAX_NESTING_DEPTH = 3;
+/**
+ * Maximum number of keys in metadata.
+ */
 exports.MAX_METADATA_KEYS = 20;
+/**
+ * Base wallet metadata schema (non-nullable). All security
+ * protections — prototype pollution guard, safe key names, typed
+ * primitive values, bounded strings / arrays — come from the shared
+ * factory.
+ */
 const BaseMetadataSchema = (0, metadata_schema_1.createMetadataSchema)({
     maxBytes: exports.MAX_METADATA_SIZE,
     maxDepth: exports.MAX_NESTING_DEPTH,
     maxKeys: exports.MAX_METADATA_KEYS,
 });
+/**
+ * Public wallet metadata schema used by request payloads. Accepts
+ * `undefined` (field omitted) and `null` (explicitly cleared) in
+ * addition to a valid metadata object.
+ */
 exports.MetadataSchema = BaseMetadataSchema.optional().nullable();
+/**
+ * Validate unknown metadata input and return either a sanitised
+ * record or an error message. Accepts `null` / `undefined` as
+ * "no metadata".
+ *
+ * Thin wallet-facing wrapper around the shared `validateMetadataWith`
+ * helper so existing callers (`TransactionMetadata.create`) keep
+ * working unchanged.
+ */
 function validateMetadata(metadata) {
     return (0, metadata_schema_1.validateMetadataWith)(BaseMetadataSchema, metadata);
 }

package/build/v1/wallet/schemas/metadata.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.schema.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/metadata.schema.ts"],"names":[],"mappings":";;;AAmDA,4CAIC;AAtDD,qEAGyC;AAK5B,QAAA,iBAAiB,GAAG,IAAI,CAAC;AAKzB,QAAA,iBAAiB,GAAG,CAAC,CAAC;AAKtB,QAAA,iBAAiB,GAAG,EAAE,CAAC;AAQpC,MAAM,kBAAkB,GAAG,IAAA,sCAAoB,EAAC;IAC5C,QAAQ,EAAE,yBAAiB;IAC3B,QAAQ,EAAE,yBAAiB;IAC3B,OAAO,EAAE,yBAAiB;CAC7B,CAAC,CAAC;AAOU,QAAA,cAAc,GAAG,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;AAavE,SAAgB,gBAAgB,CAC5B,QAAiB;IAEjB,OAAO,IAAA,sCAAoB,EAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"metadata.schema.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/metadata.schema.ts"],"names":[],"mappings":";;;AAmDA,4CAIC;AAtDD,qEAGyC;AAEzC;;GAEG;AACU,QAAA,iBAAiB,GAAG,IAAI,CAAC,CAAC,MAAM;AAE7C;;GAEG;AACU,QAAA,iBAAiB,GAAG,CAAC,CAAC;AAEnC;;GAEG;AACU,QAAA,iBAAiB,GAAG,EAAE,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,IAAA,sCAAoB,EAAC;IAC5C,QAAQ,EAAE,yBAAiB;IAC3B,QAAQ,EAAE,yBAAiB;IAC3B,OAAO,EAAE,yBAAiB;CAC7B,CAAC,CAAC;AAEH;;;;GAIG;AACU,QAAA,cAAc,GAAG,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;AAIvE;;;;;;;;GAQG;AACH,SAAgB,gBAAgB,CAC5B,QAAiB;IAEjB,OAAO,IAAA,sCAAoB,EAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC"}

package/build/v1/wallet/schemas/source-type.enum.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Source Type Enum
+ * Indicates the origin of balance credit
+ * See WALLET_API.md section 2.2
+ */
 export declare enum SourceType {
     PURCHASE = "PURCHASE",
     PROMO = "PROMO",
@@ -5,5 +10,9 @@ export declare enum SourceType {
     ADMIN = "ADMIN",
     SUBSCRIPTION = "SUBSCRIPTION",
     REFUND = "REFUND",
+    /**
+     * Source for one-time package grant credits.
+     * sourceId = UserPackage.id.
+     */
     PACKAGE = "PACKAGE"
 }

package/build/v1/wallet/schemas/source-type.enum.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SourceType = void 0;
+/**
+ * Source Type Enum
+ * Indicates the origin of balance credit
+ * See WALLET_API.md section 2.2
+ */
 var SourceType;
 (function (SourceType) {
     SourceType["PURCHASE"] = "PURCHASE";
@@ -9,6 +14,10 @@ var SourceType;
     SourceType["ADMIN"] = "ADMIN";
     SourceType["SUBSCRIPTION"] = "SUBSCRIPTION";
     SourceType["REFUND"] = "REFUND";
+    /**
+     * Source for one-time package grant credits.
+     * sourceId = UserPackage.id.
+     */
     SourceType["PACKAGE"] = "PACKAGE";
 })(SourceType || (exports.SourceType = SourceType = {}));
 //# sourceMappingURL=source-type.enum.js.map

package/build/v1/wallet/schemas/source-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-type.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/source-type.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,UAYX;AAZD,WAAY,UAAU;IAClB,mCAAqB,CAAA;IACrB,6BAAe,CAAA;IACf,mCAAqB,CAAA;IACrB,6BAAe,CAAA;IACf,2CAA6B,CAAA;IAC7B,+BAAiB,CAAA;IAKjB,iCAAmB,CAAA;AACvB,CAAC,EAZW,UAAU,0BAAV,UAAU,QAYrB"}
+{"version":3,"file":"source-type.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/source-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,UAYX;AAZD,WAAY,UAAU;IAClB,mCAAqB,CAAA;IACrB,6BAAe,CAAA;IACf,mCAAqB,CAAA;IACrB,6BAAe,CAAA;IACf,2CAA6B,CAAA;IAC7B,+BAAiB,CAAA;IACjB;;;OAGG;IACH,iCAAmB,CAAA;AACvB,CAAC,EAZW,UAAU,0BAAV,UAAU,QAYrB"}

package/build/v1/wallet/schemas/transaction-type.enum.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Transaction Type Enum
+ * See WALLET_API.md section 2.5
+ */
 export declare enum TransactionType {
     CREDIT = "CREDIT",
     DEBIT = "DEBIT",
@@ -12,4 +16,11 @@ export declare enum TransactionType {
     TRANSFER_OUT = "TRANSFER_OUT",
     TRANSFER_IN = "TRANSFER_IN"
 }
+/**
+ * Type guard for raw DB strings. Use this when reading
+ * `balance_transactions.type` from Prisma — the column is stored as
+ * VARCHAR, so the runtime value can in principle drift from the enum
+ * (legacy data, schema migration, etc.). Callers should fall back to a
+ * safe default rather than silent-cast unknown values.
+ */
 export declare function isValidTransactionType(value: string): value is TransactionType;

package/build/v1/wallet/schemas/transaction-type.enum.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransactionType = void 0;
 exports.isValidTransactionType = isValidTransactionType;
+/**
+ * Transaction Type Enum
+ * See WALLET_API.md section 2.5
+ */
 var TransactionType;
 (function (TransactionType) {
     TransactionType["CREDIT"] = "CREDIT";
@@ -18,6 +22,13 @@ var TransactionType;
     TransactionType["TRANSFER_IN"] = "TRANSFER_IN";
 })(TransactionType || (exports.TransactionType = TransactionType = {}));
 const TRANSACTION_TYPE_VALUES = new Set(Object.values(TransactionType));
+/**
+ * Type guard for raw DB strings. Use this when reading
+ * `balance_transactions.type` from Prisma — the column is stored as
+ * VARCHAR, so the runtime value can in principle drift from the enum
+ * (legacy data, schema migration, etc.). Callers should fall back to a
+ * safe default rather than silent-cast unknown values.
+ */
 function isValidTransactionType(value) {
     return TRANSACTION_TYPE_VALUES.has(value);
 }

package/build/v1/wallet/schemas/transaction-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-type.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/transaction-type.enum.ts"],"names":[],"mappings":";;;AA4BA,wDAEC;AA1BD,IAAY,eAaX;AAbD,WAAY,eAAe;IACvB,oCAAiB,CAAA;IACjB,kCAAe,CAAA;IACf,8CAA2B,CAAA;IAC3B,kDAA+B,CAAA;IAC/B,gDAA6B,CAAA;IAC7B,gDAA6B,CAAA;IAC7B,8CAA2B,CAAA;IAC3B,oDAAiC,CAAA;IACjC,oCAAiB,CAAA;IACjB,4CAAyB,CAAA;IACzB,gDAA6B,CAAA;IAC7B,8CAA2B,CAAA;AAC/B,CAAC,EAbW,eAAe,+BAAf,eAAe,QAa1B;AAED,MAAM,uBAAuB,GAAgB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;AASrF,SAAgB,sBAAsB,CAAC,KAAa;IAChD,OAAO,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"transaction-type.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/transaction-type.enum.ts"],"names":[],"mappings":";;;AA4BA,wDAEC;AA9BD;;;GAGG;AACH,IAAY,eAaX;AAbD,WAAY,eAAe;IACvB,oCAAiB,CAAA;IACjB,kCAAe,CAAA;IACf,8CAA2B,CAAA;IAC3B,kDAA+B,CAAA;IAC/B,gDAA6B,CAAA;IAC7B,gDAA6B,CAAA;IAC7B,8CAA2B,CAAA;IAC3B,oDAAiC,CAAA;IACjC,oCAAiB,CAAA;IACjB,4CAAyB,CAAA;IACzB,gDAA6B,CAAA;IAC7B,8CAA2B,CAAA;AAC/B,CAAC,EAbW,eAAe,+BAAf,eAAe,QAa1B;AAED,MAAM,uBAAuB,GAAgB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;AAErF;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAC,KAAa;IAChD,OAAO,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/build/v1/wallet/schemas/wallet-event-breakdown.schema.d.ts

@@ -1,5 +1,22 @@
 import { z } from 'zod';
 import { BalanceTypeCode } from './balance-type-code.enum';
+/**
+ * Per-bucket entry inside a wallet event.
+ *
+ * A single user-facing event can touch multiple `user_balances`
+ * (multi-bucket allocation: see `BalanceAllocator.decide` →
+ * `wallet-hold.service.ts`). Each entry here describes exactly one
+ * `user_balance` that participated in the event, identified by its
+ * `BalanceTypeCode`:
+ *   - `amount` is the signed move on that bucket (negative on a debit).
+ *     The event-level `amount` is the absolute net of these.
+ *   - `balanceAfter` is that bucket's post-state — non-negative,
+ *     mirrors `balance_transactions.balance_after` for the latest row
+ *     touching this bucket within the event group.
+ *
+ * Ordering is server-side: largest-magnitude buckets first, ties
+ * broken by `code` ascending.
+ */
 export declare const WalletEventBreakdownItemSchema: z.ZodObject<{
     balanceTypeCode: z.ZodEnum<typeof BalanceTypeCode>;
     amount: z.ZodNumber;

package/build/v1/wallet/schemas/wallet-event-breakdown.schema.js

@@ -3,6 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WalletEventBreakdownItemSchema = void 0;
 const zod_1 = require("zod");
 const balance_type_code_enum_1 = require("./balance-type-code.enum");
+/**
+ * Per-bucket entry inside a wallet event.
+ *
+ * A single user-facing event can touch multiple `user_balances`
+ * (multi-bucket allocation: see `BalanceAllocator.decide` →
+ * `wallet-hold.service.ts`). Each entry here describes exactly one
+ * `user_balance` that participated in the event, identified by its
+ * `BalanceTypeCode`:
+ *   - `amount` is the signed move on that bucket (negative on a debit).
+ *     The event-level `amount` is the absolute net of these.
+ *   - `balanceAfter` is that bucket's post-state — non-negative,
+ *     mirrors `balance_transactions.balance_after` for the latest row
+ *     touching this bucket within the event group.
+ *
+ * Ordering is server-side: largest-magnitude buckets first, ties
+ * broken by `code` ascending.
+ */
 exports.WalletEventBreakdownItemSchema = zod_1.z.object({
     balanceTypeCode: zod_1.z.enum(balance_type_code_enum_1.BalanceTypeCode),
     amount: zod_1.z.number().int(),

package/build/v1/wallet/schemas/wallet-event-breakdown.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-event-breakdown.schema.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/wallet-event-breakdown.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAA2D;AAmB9C,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,eAAe,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,CAAC;IACxC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC/C,CAAC,CAAC"}
+{"version":3,"file":"wallet-event-breakdown.schema.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/wallet-event-breakdown.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAA2D;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,eAAe,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,CAAC;IACxC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC/C,CAAC,CAAC"}

package/build/v1/wallet/schemas/wallet-event-direction.enum.d.ts

@@ -1,3 +1,13 @@
+/**
+ * User-facing direction of a wallet event. Derived from the sign of the
+ * net amount produced by `v_wallet_events`:
+ *   - INCOMING → net_amount > 0 (top-up, refund, transfer in, …)
+ *   - OUTGOING → net_amount < 0 (generation, expiry, transfer out, …)
+ *
+ * Net-zero groups (cancelled holds) never reach the wire — the view's
+ * `HAVING SUM(amount) <> 0` clause filters them out before rows are
+ * returned.
+ */
 export declare enum WalletEventDirection {
     INCOMING = "INCOMING",
     OUTGOING = "OUTGOING"

package/build/v1/wallet/schemas/wallet-event-direction.enum.js

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WalletEventDirection = void 0;
+/**
+ * User-facing direction of a wallet event. Derived from the sign of the
+ * net amount produced by `v_wallet_events`:
+ *   - INCOMING → net_amount > 0 (top-up, refund, transfer in, …)
+ *   - OUTGOING → net_amount < 0 (generation, expiry, transfer out, …)
+ *
+ * Net-zero groups (cancelled holds) never reach the wire — the view's
+ * `HAVING SUM(amount) <> 0` clause filters them out before rows are
+ * returned.
+ */
 var WalletEventDirection;
 (function (WalletEventDirection) {
     WalletEventDirection["INCOMING"] = "INCOMING";

package/build/v1/wallet/schemas/wallet-event-direction.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-event-direction.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/wallet-event-direction.enum.ts"],"names":[],"mappings":";;;AAUA,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC5B,6CAAqB,CAAA;IACrB,6CAAqB,CAAA;AACzB,CAAC,EAHW,oBAAoB,oCAApB,oBAAoB,QAG/B"}
+{"version":3,"file":"wallet-event-direction.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/wallet-event-direction.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC5B,6CAAqB,CAAA;IACrB,6CAAqB,CAAA;AACzB,CAAC,EAHW,oBAAoB,oCAApB,oBAAoB,QAG/B"}

package/build/v1/wallet/schemas/wallet-event-kind.enum.d.ts

@@ -1,3 +1,25 @@
+/**
+ * User-facing label for a wallet event. Inferred in the domain layer
+ * from the structural BOOL_OR flags projected on `v_wallet_events` —
+ * the view never emits raw `TransactionType` literals to the wire and
+ * the application never branches on them. New ledger types added
+ * upstream surface as `ADJUSTMENT` until the inference matrix is
+ * extended (defensive, not silent).
+ *
+ * Mapping (single-direction, non-overlapping by construction):
+ *   - TOPUP         → has_credit && INCOMING (CREDIT-only group)
+ *   - BONUS         → reserved for future split — TODO: depends on
+ *                     joining `user_balances.source_type` into the view;
+ *                     today every CREDIT-only group is reported as
+ *                     TOPUP
+ *   - REFUND        → has_refund (any direction)
+ *   - GENERATION    → has_spend && OUTGOING (HOLD_CREATE + HOLD_CONFIRM
+ *                     + DEBIT round-trip rolled up by correlation_id)
+ *   - ADJUSTMENT    → has_adjustment, OR fallthrough on malformed flags
+ *   - EXPIRY        → has_expiry (BALANCE_EXPIRE, OUTGOING by sign)
+ *   - TRANSFER_IN   → has_transfer_in
+ *   - TRANSFER_OUT  → has_transfer_out
+ */
 export declare enum WalletEventKind {
     TOPUP = "TOPUP",
     BONUS = "BONUS",

package/build/v1/wallet/schemas/wallet-event-kind.enum.js

@@ -1,6 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WalletEventKind = void 0;
+/**
+ * User-facing label for a wallet event. Inferred in the domain layer
+ * from the structural BOOL_OR flags projected on `v_wallet_events` —
+ * the view never emits raw `TransactionType` literals to the wire and
+ * the application never branches on them. New ledger types added
+ * upstream surface as `ADJUSTMENT` until the inference matrix is
+ * extended (defensive, not silent).
+ *
+ * Mapping (single-direction, non-overlapping by construction):
+ *   - TOPUP         → has_credit && INCOMING (CREDIT-only group)
+ *   - BONUS         → reserved for future split — TODO: depends on
+ *                     joining `user_balances.source_type` into the view;
+ *                     today every CREDIT-only group is reported as
+ *                     TOPUP
+ *   - REFUND        → has_refund (any direction)
+ *   - GENERATION    → has_spend && OUTGOING (HOLD_CREATE + HOLD_CONFIRM
+ *                     + DEBIT round-trip rolled up by correlation_id)
+ *   - ADJUSTMENT    → has_adjustment, OR fallthrough on malformed flags
+ *   - EXPIRY        → has_expiry (BALANCE_EXPIRE, OUTGOING by sign)
+ *   - TRANSFER_IN   → has_transfer_in
+ *   - TRANSFER_OUT  → has_transfer_out
+ */
 var WalletEventKind;
 (function (WalletEventKind) {
     WalletEventKind["TOPUP"] = "TOPUP";

package/build/v1/wallet/schemas/wallet-event-kind.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-event-kind.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/wallet-event-kind.enum.ts"],"names":[],"mappings":";;;AAsBA,IAAY,eASX;AATD,WAAY,eAAe;IACvB,kCAAe,CAAA;IACf,kCAAe,CAAA;IACf,oCAAiB,CAAA;IACjB,4CAAyB,CAAA;IACzB,4CAAyB,CAAA;IACzB,oCAAiB,CAAA;IACjB,8CAA2B,CAAA;IAC3B,gDAA6B,CAAA;AACjC,CAAC,EATW,eAAe,+BAAf,eAAe,QAS1B"}
+{"version":3,"file":"wallet-event-kind.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/wallet-event-kind.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,IAAY,eASX;AATD,WAAY,eAAe;IACvB,kCAAe,CAAA;IACf,kCAAe,CAAA;IACf,oCAAiB,CAAA;IACjB,4CAAyB,CAAA;IACzB,4CAAyB,CAAA;IACzB,oCAAiB,CAAA;IACjB,8CAA2B,CAAA;IAC3B,gDAA6B,CAAA;AACjC,CAAC,EATW,eAAe,+BAAf,eAAe,QAS1B"}

package/build/v1/wallet/schemas/wallet-event.schema.d.ts

@@ -1,6 +1,28 @@
 import { z } from 'zod';
 import { WalletEventDirection } from './wallet-event-direction.enum';
 import { WalletEventKind } from './wallet-event-kind.enum';
+/**
+ * One row of the user-facing wallet events feed.
+ *
+ * SECURITY CONTRACT — internal ledger fields MUST NEVER reach the wire:
+ *   - per-row `transactionId` / `holdId`
+ *   - raw `TransactionType` literal (HOLD_CREATE / HOLD_CONFIRM / …)
+ *   - `initiatorType` / `initiatorId`
+ *   - `ipAddress` / `userAgent`
+ *   - `metadata`
+ *   - `idempotencyKey`
+ *   - `balanceBefore`
+ *
+ * `eventId` is the only id surfaced — the FE uses it as a stable
+ * row key. It is opaque text (server-side it's `hold_id` for
+ * hold-bearing events, else `correlation_id`); the FE MUST NOT
+ * parse it. `amount` is the absolute value of the rolled-up net
+ * (always non-negative); the sign is conveyed by `direction`.
+ *
+ * `breakdown` is the per-bucket detail of which `user_balances` this
+ * event touched and their post-states. Always non-empty (the view
+ * cannot produce an event without at least one bucket row).
+ */
 export declare const WalletEventItemSchema: z.ZodObject<{
     eventId: z.ZodString;
     direction: z.ZodEnum<typeof WalletEventDirection>;
@@ -14,6 +36,10 @@ export declare const WalletEventItemSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type WalletEventItem = z.infer<typeof WalletEventItemSchema>;
+/**
+ * Cursor-paginated list response. Stable key:
+ * `(event_at DESC, event_id DESC)`.
+ */
 export declare const WalletEventsListResponseSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         eventId: z.ZodString;
@@ -31,6 +57,12 @@ export declare const WalletEventsListResponseSchema: z.ZodObject<{
     hasMore: z.ZodBoolean;
 }, z.core.$strip>;
 export type WalletEventsListResponse = z.infer<typeof WalletEventsListResponseSchema>;
+/**
+ * List request. Cursor is a small base64 envelope (≤256 chars) — the
+ * cap defends against a base64-bomb that would force the server to
+ * allocate before validation kicks in. Direction filter is optional;
+ * absence means "both directions".
+ */
 export declare const WalletEventsListRequestSchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodNumber>;

package/build/v1/wallet/schemas/wallet-event.schema.js

@@ -5,6 +5,28 @@ const zod_1 = require("zod");
 const wallet_event_direction_enum_1 = require("./wallet-event-direction.enum");
 const wallet_event_kind_enum_1 = require("./wallet-event-kind.enum");
 const wallet_event_breakdown_schema_1 = require("./wallet-event-breakdown.schema");
+/**
+ * One row of the user-facing wallet events feed.
+ *
+ * SECURITY CONTRACT — internal ledger fields MUST NEVER reach the wire:
+ *   - per-row `transactionId` / `holdId`
+ *   - raw `TransactionType` literal (HOLD_CREATE / HOLD_CONFIRM / …)
+ *   - `initiatorType` / `initiatorId`
+ *   - `ipAddress` / `userAgent`
+ *   - `metadata`
+ *   - `idempotencyKey`
+ *   - `balanceBefore`
+ *
+ * `eventId` is the only id surfaced — the FE uses it as a stable
+ * row key. It is opaque text (server-side it's `hold_id` for
+ * hold-bearing events, else `correlation_id`); the FE MUST NOT
+ * parse it. `amount` is the absolute value of the rolled-up net
+ * (always non-negative); the sign is conveyed by `direction`.
+ *
+ * `breakdown` is the per-bucket detail of which `user_balances` this
+ * event touched and their post-states. Always non-empty (the view
+ * cannot produce an event without at least one bucket row).
+ */
 exports.WalletEventItemSchema = zod_1.z.object({
     eventId: zod_1.z.string(),
     direction: zod_1.z.enum(wallet_event_direction_enum_1.WalletEventDirection),
@@ -13,11 +35,21 @@ exports.WalletEventItemSchema = zod_1.z.object({
     eventAt: zod_1.z.string().datetime(),
     breakdown: zod_1.z.array(wallet_event_breakdown_schema_1.WalletEventBreakdownItemSchema).min(1),
 });
+/**
+ * Cursor-paginated list response. Stable key:
+ * `(event_at DESC, event_id DESC)`.
+ */
 exports.WalletEventsListResponseSchema = zod_1.z.object({
     items: zod_1.z.array(exports.WalletEventItemSchema),
     nextCursor: zod_1.z.string().nullable(),
     hasMore: zod_1.z.boolean(),
 });
+/**
+ * List request. Cursor is a small base64 envelope (≤256 chars) — the
+ * cap defends against a base64-bomb that would force the server to
+ * allocate before validation kicks in. Direction filter is optional;
+ * absence means "both directions".
+ */
 exports.WalletEventsListRequestSchema = zod_1.z.object({
     cursor: zod_1.z
         .string({ error: 'WalletEventsListRequest.cursor.invalid' })

package/build/v1/wallet/schemas/wallet-event.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-event.schema.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/wallet-event.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+EAAqE;AACrE,qEAA2D;AAC3D,mFAAiF;AAwBpE,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,kDAAoB,CAAC;IACvC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,CAAC;IAC7B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,8DAA8B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5D,CAAC,CAAC;AAOU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,6BAAqB,CAAC;IACrC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC;AAWU,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;SAC3D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SAC3D,QAAQ,EAAE;IACf,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;SAC1D,GAAG,CAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SACrD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SACxD,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SACzD,OAAO,CAAC,EAAE,CAAC;IAChB,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,kDAAoB,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC"}
+{"version":3,"file":"wallet-event.schema.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/wallet-event.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+EAAqE;AACrE,qEAA2D;AAC3D,mFAAiF;AAEjF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,kDAAoB,CAAC;IACvC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,CAAC;IAC7B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,8DAA8B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5D,CAAC,CAAC;AAGH;;;GAGG;AACU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,6BAAqB,CAAC;IACrC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC;AAKH;;;;;GAKG;AACU,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;SAC3D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SAC3D,QAAQ,EAAE;IACf,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;SAC1D,GAAG,CAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SACrD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SACxD,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SACzD,OAAO,CAAC,EAAE,CAAC;IAChB,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,kDAAoB,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC"}

package/build/v1/wallet/unreg/queries/get-balance-summary.query.d.ts

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../../shared/http-method.enum';
+/**
+ * Unreg Get Balance Summary Query
+ * Public API — returns balance summary for an unregistered (anonymous)
+ * session. Auth via unreg JWT; owner derived from token's `sub`.
+ *
+ * Wire shape mirrors the reg counterpart (`GetBalanceSummaryQuery`)
+ * because the wallet service is owner-polymorphic.
+ */
 export declare namespace UnregGetBalanceSummaryQuery {
     const Request: z.ZodVoid;
     const Response: z.ZodObject<{

package/build/v1/wallet/unreg/queries/get-balance-summary.query.js

@@ -5,6 +5,14 @@ const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
 const rest_api_1 = require("../../../../rest-api");
 const http_method_enum_1 = require("../../../../shared/http-method.enum");
+/**
+ * Unreg Get Balance Summary Query
+ * Public API — returns balance summary for an unregistered (anonymous)
+ * session. Auth via unreg JWT; owner derived from token's `sub`.
+ *
+ * Wire shape mirrors the reg counterpart (`GetBalanceSummaryQuery`)
+ * because the wallet service is owner-polymorphic.
+ */
 var UnregGetBalanceSummaryQuery;
 (function (UnregGetBalanceSummaryQuery) {
     UnregGetBalanceSummaryQuery.Request = zod_1.z.void();

package/build/v1/wallet/unreg/queries/get-balance-summary.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-balance-summary.query.js","sourceRoot":"","sources":["../../../../../v1/wallet/unreg/queries/get-balance-summary.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,2CAA6D;AAC7D,mDAAgD;AAChD,0EAAiE;AAUjE,IAAiB,2BAA2B,CAS3C;AATD,WAAiB,2BAA2B;IAC3B,mCAAO,GAAG,OAAC,CAAC,IAAI,EAAE,CAAC;IACnB,oCAAQ,GAAG,sCAA4B,CAAC;IAExC,+BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IACvC,kCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,2BAA2B,2CAA3B,2BAA2B,QAS3C"}
+{"version":3,"file":"get-balance-summary.query.js","sourceRoot":"","sources":["../../../../../v1/wallet/unreg/queries/get-balance-summary.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,2CAA6D;AAC7D,mDAAgD;AAChD,0EAAiE;AAEjE;;;;;;;GAOG;AACH,IAAiB,2BAA2B,CAS3C;AATD,WAAiB,2BAA2B;IAC3B,mCAAO,GAAG,OAAC,CAAC,IAAI,EAAE,CAAC;IACnB,oCAAQ,GAAG,sCAA4B,CAAC;IAExC,+BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IACvC,kCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,2BAA2B,2CAA3B,2BAA2B,QAS3C"}

package/build/v1/wallet/wallet.errors.d.ts

@@ -1,6 +1,11 @@
 import { ErrorMetadata } from '../../shared';
+/**
+ * Wallet Error Codes
+ * See WALLET_API.md section 7 for error specifications
+ */
 export declare enum WalletErrorCode {
     INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    /** Spendable buckets emptied by the antifraud freeze (trust status), not by a zero balance. */
     BALANCE_RESTRICTED = "BALANCE_RESTRICTED",
     BALANCE_NOT_FOUND = "BALANCE_NOT_FOUND",
     BALANCE_TYPE_NOT_FOUND = "BALANCE_TYPE_NOT_FOUND",