@veruna/api-contracts 20.0.0 → 20.1.0

package/build/v1/vk-auth/queries/get-vk-auth-status.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-vk-auth-status.query.js","sourceRoot":"","sources":["../../../../v1/vk-auth/queries/get-vk-auth-status.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAwD;AACxD,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,oBAAoB,CASpC;AATD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,6BAAQ,GAAG,oCAA0B,CAAC;IAEtC,wBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;IACxC,2BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,oBAAoB,oCAApB,oBAAoB,QASpC"}
+{"version":3,"file":"get-vk-auth-status.query.js","sourceRoot":"","sources":["../../../../v1/vk-auth/queries/get-vk-auth-status.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAwD;AACxD,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,oBAAoB,CASpC;AATD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,6BAAQ,GAAG,oCAA0B,CAAC;IAEtC,wBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;IACxC,2BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,oBAAoB,oCAApB,oBAAoB,QASpC"}

package/build/v1/vk-auth/queries/handle-vk-auth-callback.query.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Handle VK Auth Callback Query
+ * GET /api/v1/auth/vk/callback
+ */
 export declare namespace HandleVkAuthCallbackQuery {
     const Request: z.ZodObject<{
         code: z.ZodOptional<z.ZodString>;

package/build/v1/vk-auth/queries/handle-vk-auth-callback.query.js

@@ -5,6 +5,10 @@ const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Handle VK Auth Callback Query
+ * GET /api/v1/auth/vk/callback
+ */
 var HandleVkAuthCallbackQuery;
 (function (HandleVkAuthCallbackQuery) {
     HandleVkAuthCallbackQuery.Request = schemas_1.VkAuthCallbackQuerySchema;

package/build/v1/vk-auth/queries/handle-vk-auth-callback.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle-vk-auth-callback.query.js","sourceRoot":"","sources":["../../../../v1/vk-auth/queries/handle-vk-auth-callback.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAuD;AACvD,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,yBAAyB,CASzC;AATD,WAAiB,yBAAyB;IACzB,iCAAO,GAAG,mCAAyB,CAAC;IACpC,kCAAQ,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAExB,6BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC1C,gCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,yBAAyB,yCAAzB,yBAAyB,QASzC"}
+{"version":3,"file":"handle-vk-auth-callback.query.js","sourceRoot":"","sources":["../../../../v1/vk-auth/queries/handle-vk-auth-callback.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAuD;AACvD,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,yBAAyB,CASzC;AATD,WAAiB,yBAAyB;IACzB,iCAAO,GAAG,mCAAyB,CAAC;IACpC,kCAAQ,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAExB,6BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC1C,gCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,yBAAyB,yCAAzB,yBAAyB,QASzC"}

package/build/v1/vk-auth/schemas/vk-auth-callback-query.schema.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * VK OAuth callback query params.
+ * Provider may return an error scenario without code, so fields are optional.
+ */
 export declare const VkAuthCallbackQuerySchema: z.ZodObject<{
     code: z.ZodOptional<z.ZodString>;
     state: z.ZodOptional<z.ZodString>;

package/build/v1/vk-auth/schemas/vk-auth-callback-query.schema.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VkAuthCallbackQuerySchema = void 0;
 const zod_1 = require("zod");
+/**
+ * VK OAuth callback query params.
+ * Provider may return an error scenario without code, so fields are optional.
+ */
 exports.VkAuthCallbackQuerySchema = zod_1.z.object({
     code: zod_1.z.string({ error: 'VkAuthCallbackQuery.code.invalid' }).optional(),
     state: zod_1.z.string({ error: 'VkAuthCallbackQuery.state.invalid' }).optional(),

package/build/v1/vk-auth/schemas/vk-auth-callback-query.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"vk-auth-callback-query.schema.js","sourceRoot":"","sources":["../../../../v1/vk-auth/schemas/vk-auth-callback-query.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAMX,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxE,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1E,SAAS,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrF,CAAC,CAAC"}
+{"version":3,"file":"vk-auth-callback-query.schema.js","sourceRoot":"","sources":["../../../../v1/vk-auth/schemas/vk-auth-callback-query.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;GAGG;AACU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxE,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1E,SAAS,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrF,CAAC,CAAC"}

package/build/v1/vk-profile/commands/link-vk.command.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Link VK Command
+ * POST /api/v1/profiles/vk/link
+ */
 export declare namespace LinkVkCommand {
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodObject<{

package/build/v1/vk-profile/commands/link-vk.command.js

@@ -5,6 +5,10 @@ const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Link VK Command
+ * POST /api/v1/profiles/vk/link
+ */
 var LinkVkCommand;
 (function (LinkVkCommand) {
     LinkVkCommand.Request = zod_1.z.object({});

package/build/v1/vk-profile/commands/link-vk.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"link-vk.command.js","sourceRoot":"","sources":["../../../../v1/vk-profile/commands/link-vk.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAkD;AAClD,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,aAAa,CAS7B;AATD,WAAiB,aAAa;IACb,qBAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,sBAAQ,GAAG,8BAAoB,CAAC;IAEhC,iBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;IACtC,oBAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,aAAa,6BAAb,aAAa,QAS7B"}
+{"version":3,"file":"link-vk.command.js","sourceRoot":"","sources":["../../../../v1/vk-profile/commands/link-vk.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAkD;AAClD,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,aAAa,CAS7B;AATD,WAAiB,aAAa;IACb,qBAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,sBAAQ,GAAG,8BAAoB,CAAC;IAEhC,iBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;IACtC,oBAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,aAAa,6BAAb,aAAa,QAS7B"}

package/build/v1/vk-profile/queries/get-vk-link-status.query.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Get VK Link Status Query
+ * GET /api/v1/profiles/vk/link/:uuid
+ */
 export declare namespace GetVkLinkStatusQuery {
     const Response: z.ZodObject<{
         status: z.ZodEnum<typeof import("../..").VkAuthStatus>;

package/build/v1/vk-profile/queries/get-vk-link-status.query.js

@@ -4,6 +4,10 @@ exports.GetVkLinkStatusQuery = void 0;
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Get VK Link Status Query
+ * GET /api/v1/profiles/vk/link/:uuid
+ */
 var GetVkLinkStatusQuery;
 (function (GetVkLinkStatusQuery) {
     GetVkLinkStatusQuery.Response = schemas_1.VkLinkStatusResponseSchema;

package/build/v1/vk-profile/queries/get-vk-link-status.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-vk-link-status.query.js","sourceRoot":"","sources":["../../../../v1/vk-profile/queries/get-vk-link-status.query.ts"],"names":[],"mappings":";;;AACA,wCAAwD;AACxD,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,oBAAoB,CAOpC;AAPD,WAAiB,oBAAoB;IACpB,6BAAQ,GAAG,oCAA0B,CAAC;IAEtC,wBAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACrE,2BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,oBAAoB,oCAApB,oBAAoB,QAOpC"}
+{"version":3,"file":"get-vk-link-status.query.js","sourceRoot":"","sources":["../../../../v1/vk-profile/queries/get-vk-link-status.query.ts"],"names":[],"mappings":";;;AACA,wCAAwD;AACxD,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,oBAAoB,CAOpC;AAPD,WAAiB,oBAAoB;IACpB,6BAAQ,GAAG,oCAA0B,CAAC;IAEtC,wBAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACrE,2BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,oBAAoB,oCAApB,oBAAoB,QAOpC"}

package/build/v1/vk-profile/queries/get-vk-profile.query.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Get VK Profile Query
+ * GET /api/v1/profiles/vk
+ */
 export declare namespace GetVkProfileQuery {
     const Response: z.ZodObject<{
         vkId: z.ZodString;

package/build/v1/vk-profile/queries/get-vk-profile.query.js

@@ -4,6 +4,10 @@ exports.GetVkProfileQuery = void 0;
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Get VK Profile Query
+ * GET /api/v1/profiles/vk
+ */
 var GetVkProfileQuery;
 (function (GetVkProfileQuery) {
     GetVkProfileQuery.Response = schemas_1.VkProfileResponseSchema;

package/build/v1/vk-profile/queries/get-vk-profile.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-vk-profile.query.js","sourceRoot":"","sources":["../../../../v1/vk-profile/queries/get-vk-profile.query.ts"],"names":[],"mappings":";;;AACA,wCAAqD;AACrD,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,iBAAiB,CAOjC;AAPD,WAAiB,iBAAiB;IACjB,0BAAQ,GAAG,iCAAuB,CAAC;IAEnC,qBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;IAC7C,wBAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,iBAAiB,iCAAjB,iBAAiB,QAOjC"}
+{"version":3,"file":"get-vk-profile.query.js","sourceRoot":"","sources":["../../../../v1/vk-profile/queries/get-vk-profile.query.ts"],"names":[],"mappings":";;;AACA,wCAAqD;AACrD,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,iBAAiB,CAOjC;AAPD,WAAiB,iBAAiB;IACjB,0BAAQ,GAAG,iCAAuB,CAAC;IAEnC,qBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;IAC7C,wBAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,iBAAiB,iCAAjB,iBAAiB,QAOjC"}

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

@@ -1,3 +1,14 @@
+/**
+ * Direction of an admin-issued balance adjustment.
+ *
+ * CREDIT — top-up: creates a new ACTIVE UserBalance bucket. Caller
+ * must supply `balanceTypeCode` (e.g. DAILY_REWARD, TASK_REWARD).
+ *
+ * DEBIT  — write-off: FIFO across the user's active balances. No
+ * `balanceTypeCode` needed; the wallet's debit handler picks
+ * buckets by expiry / priority. Returns INSUFFICIENT_BALANCE
+ * if the available total is below the requested amount.
+ */
 export declare enum AdminAdjustmentDirection {
     CREDIT = "CREDIT",
     DEBIT = "DEBIT"

package/build/v1/wallet/admin/schemas/admin-adjustment-direction.enum.js

@@ -1,6 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdminAdjustmentDirection = void 0;
+/**
+ * Direction of an admin-issued balance adjustment.
+ *
+ * CREDIT — top-up: creates a new ACTIVE UserBalance bucket. Caller
+ * must supply `balanceTypeCode` (e.g. DAILY_REWARD, TASK_REWARD).
+ *
+ * DEBIT  — write-off: FIFO across the user's active balances. No
+ * `balanceTypeCode` needed; the wallet's debit handler picks
+ * buckets by expiry / priority. Returns INSUFFICIENT_BALANCE
+ * if the available total is below the requested amount.
+ */
 var AdminAdjustmentDirection;
 (function (AdminAdjustmentDirection) {
     AdminAdjustmentDirection["CREDIT"] = "CREDIT";

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

@@ -1 +1 @@
-{"version":3,"file":"admin-adjustment-direction.enum.js","sourceRoot":"","sources":["../../../../../v1/wallet/admin/schemas/admin-adjustment-direction.enum.ts"],"names":[],"mappings":";;;AAWA,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAChC,6CAAiB,CAAA;IACjB,2CAAe,CAAA;AACnB,CAAC,EAHW,wBAAwB,wCAAxB,wBAAwB,QAGnC"}
+{"version":3,"file":"admin-adjustment-direction.enum.js","sourceRoot":"","sources":["../../../../../v1/wallet/admin/schemas/admin-adjustment-direction.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAChC,6CAAiB,CAAA;IACjB,2CAAe,CAAA;AACnB,CAAC,EAHW,wBAAwB,wCAAxB,wBAAwB,QAGnC"}

package/build/v1/wallet/admin/schemas/admin-adjustment.schema.js

@@ -9,10 +9,20 @@ exports.AdminAdjustBalanceRequestSchema = zod_1.z
     direction: zod_1.z.enum(admin_adjustment_direction_enum_1.AdminAdjustmentDirection, {
         error: 'AdminAdjustBalanceRequest.direction.invalid',
     }),
+    /**
+     * Положительное значение в kopeks (string для BigInt-совместимости).
+     * Bound at 15 digits — comfortably above any realistic balance
+     * (10^15 kopeks ≈ 10 trillion units) but well below typical
+     * `numeric` column precision so we never overflow downstream.
+     */
     amount: zod_1.z
         .string({ error: 'AdminAdjustBalanceRequest.amount.required' })
         .regex(/^[1-9]\d*$/, { message: 'AdminAdjustBalanceRequest.amount.positive' })
         .max(15, { message: 'AdminAdjustBalanceRequest.amount.max' }),
+    /**
+     * Балансовый тип-код (только для CREDIT). DEBIT списывается FIFO
+     * по всем активным balance buckets, balance type не нужен.
+     */
     balanceTypeCode: zod_1.z
         .string({ error: 'AdminAdjustBalanceRequest.balanceTypeCode.required' })
         .min(1, { message: 'AdminAdjustBalanceRequest.balanceTypeCode.min' })
@@ -23,6 +33,7 @@ exports.AdminAdjustBalanceRequestSchema = zod_1.z
         .min(1, { message: 'AdminAdjustBalanceRequest.reason.min' })
         .max(100, { message: 'AdminAdjustBalanceRequest.reason.max' }),
     description: zod_1.z.string().max(2000).optional(),
+    /** Опциональный TTL в ISO datetime — только для CREDIT. */
     expiresAt: zod_1.z
         .string()
         .datetime({ message: 'AdminAdjustBalanceRequest.expiresAt.invalid' })

package/build/v1/wallet/admin/schemas/admin-adjustment.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-adjustment.schema.js","sourceRoot":"","sources":["../../../../../v1/wallet/admin/schemas/admin-adjustment.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAAwD;AACxD,uFAA6E;AAEhE,QAAA,+BAA+B,GAAG,OAAC;KAC3C,MAAM,CAAC;IACJ,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,0DAAwB,EAAE;QACxC,KAAK,EAAE,6CAA6C;KACvD,CAAC;IAOF,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,KAAK,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;SAC7E,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;IAKjE,eAAe,EAAE,OAAC;SACb,MAAM,CAAC,EAAE,KAAK,EAAE,oDAAoD,EAAE,CAAC;SACvE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;SACpE,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;SACrE,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;SAC3D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;IAClE,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAE5C,SAAS,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SACpE,QAAQ,EAAE;CAClB,CAAC;KACD,MAAM,EAAE,CAAC;AAGD,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,0DAAwB,CAAC;IAC3C,MAAM,EAAE,2BAAkB;IAC1B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;CAC5B,CAAC,CAAC"}
+{"version":3,"file":"admin-adjustment.schema.js","sourceRoot":"","sources":["../../../../../v1/wallet/admin/schemas/admin-adjustment.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAAwD;AACxD,uFAA6E;AAEhE,QAAA,+BAA+B,GAAG,OAAC;KAC3C,MAAM,CAAC;IACJ,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,0DAAwB,EAAE;QACxC,KAAK,EAAE,6CAA6C;KACvD,CAAC;IACF;;;;;OAKG;IACH,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,KAAK,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;SAC7E,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;IACjE;;;OAGG;IACH,eAAe,EAAE,OAAC;SACb,MAAM,CAAC,EAAE,KAAK,EAAE,oDAAoD,EAAE,CAAC;SACvE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;SACpE,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;SACrE,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;SAC3D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;IAClE,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC5C,2DAA2D;IAC3D,SAAS,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SACpE,QAAQ,EAAE;CAClB,CAAC;KACD,MAAM,EAAE,CAAC;AAGD,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,0DAAwB,CAAC;IAC3C,MAAM,EAAE,2BAAkB;IAC1B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;CAC5B,CAAC,CAAC"}

package/build/v1/wallet/admin/schemas/admin-balance.schema.d.ts

@@ -1,4 +1,9 @@
 import { z } from 'zod';
+/**
+ * Balance summary for admin view — same shape as the user-facing
+ * `BalanceSummaryResponseSchema` minus the `userId` envelope (the
+ * admin route already carries `:userId` in the URL).
+ */
 export declare const AdminBalanceSummarySchema: z.ZodObject<{
     totalAvailable: z.ZodString;
     totalLocked: z.ZodString;

package/build/v1/wallet/admin/schemas/admin-balance.schema.js

@@ -2,6 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdminGetWalletBalanceResponseSchema = exports.AdminBalanceSummarySchema = void 0;
 const balance_response_schema_1 = require("../../schemas/balance-response.schema");
+/**
+ * Balance summary for admin view — same shape as the user-facing
+ * `BalanceSummaryResponseSchema` minus the `userId` envelope (the
+ * admin route already carries `:userId` in the URL).
+ */
 exports.AdminBalanceSummarySchema = balance_response_schema_1.BalanceSummaryResponseSchema.omit({
     userId: true,
 });

package/build/v1/wallet/admin/schemas/admin-balance.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-balance.schema.js","sourceRoot":"","sources":["../../../../../v1/wallet/admin/schemas/admin-balance.schema.ts"],"names":[],"mappings":";;;AACA,mFAAqF;AAOxE,QAAA,yBAAyB,GAAG,sDAA4B,CAAC,IAAI,CAAC;IACvE,MAAM,EAAE,IAAI;CACf,CAAC,CAAC;AAGU,QAAA,mCAAmC,GAAG,iCAAyB,CAAC"}
+{"version":3,"file":"admin-balance.schema.js","sourceRoot":"","sources":["../../../../../v1/wallet/admin/schemas/admin-balance.schema.ts"],"names":[],"mappings":";;;AACA,mFAAqF;AAErF;;;;GAIG;AACU,QAAA,yBAAyB,GAAG,sDAA4B,CAAC,IAAI,CAAC;IACvE,MAAM,EAAE,IAAI;CACf,CAAC,CAAC;AAGU,QAAA,mCAAmC,GAAG,iCAAyB,CAAC"}

package/build/v1/wallet/admin/schemas/admin-transactions.schema.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { TransactionType } from '../../schemas/transaction-type.enum';
+/**
+ * Single transaction row for admin view. Mirrors `BalanceTransaction`
+ * with full audit fields exposed (admin needs to see initiator/IP/UA).
+ */
 export declare const AdminTransactionItemSchema: z.ZodObject<{
     uuid: z.ZodString;
     type: z.ZodEnum<typeof TransactionType>;
@@ -19,6 +23,10 @@ export declare const AdminTransactionItemSchema: z.ZodObject<{
     createdAt: z.ZodString;
 }, z.core.$strip>;
 export type AdminTransactionItem = z.infer<typeof AdminTransactionItemSchema>;
+/**
+ * GET /v1/admin/users/:userId/wallet/transactions — cursor pagination
+ * over balance_transactions (DESC by createdAt, then uuid).
+ */
 export declare const AdminListTransactionsRequestSchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;

package/build/v1/wallet/admin/schemas/admin-transactions.schema.js

@@ -5,6 +5,10 @@ const zod_1 = require("zod");
 const regex_1 = require("../../../../shared/regex");
 const shared_1 = require("../../../../shared");
 const transaction_type_enum_1 = require("../../schemas/transaction-type.enum");
+/**
+ * Single transaction row for admin view. Mirrors `BalanceTransaction`
+ * with full audit fields exposed (admin needs to see initiator/IP/UA).
+ */
 exports.AdminTransactionItemSchema = zod_1.z.object({
     uuid: zod_1.z.string().regex(regex_1.UUID_REGEX),
     type: zod_1.z.enum(transaction_type_enum_1.TransactionType),
@@ -23,6 +27,10 @@ exports.AdminTransactionItemSchema = zod_1.z.object({
     userBalanceId: zod_1.z.string().nullable(),
     createdAt: zod_1.z.string().regex(regex_1.DATETIME_REGEX),
 });
+/**
+ * GET /v1/admin/users/:userId/wallet/transactions — cursor pagination
+ * over balance_transactions (DESC by createdAt, then uuid).
+ */
 exports.AdminListTransactionsRequestSchema = zod_1.z.object({
     cursor: zod_1.z
         .string({ error: 'AdminListTransactionsRequest.cursor.invalid' })

package/build/v1/wallet/admin/schemas/admin-transactions.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-transactions.schema.js","sourceRoot":"","sources":["../../../../../v1/wallet/admin/schemas/admin-transactions.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oDAAsE;AACtE,+CAAwD;AACxD,+EAAsE;AAMzD,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,uCAAe,CAAC;IAC7B,MAAM,EAAE,2BAAkB;IAC1B,aAAa,EAAE,2BAAkB;IACjC,YAAY,EAAE,2BAAkB;IAChC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC;CAC9C,CAAC,CAAC;AAOU,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC;IACvD,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,QAAQ,CAAC,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SACpE,QAAQ,EAAE;IACf,KAAK,EAAE,OAAC,CAAC,MAAM;SACV,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SAC9D,QAAQ,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SACnE,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;SAC/D,OAAO,CAAC,EAAE,CAAC;CACnB,CAAC,CAAC;AAGU,QAAA,mCAAmC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,kCAA0B,CAAC;IAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC"}
+{"version":3,"file":"admin-transactions.schema.js","sourceRoot":"","sources":["../../../../../v1/wallet/admin/schemas/admin-transactions.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oDAAsE;AACtE,+CAAwD;AACxD,+EAAsE;AAEtE;;;GAGG;AACU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,uCAAe,CAAC;IAC7B,MAAM,EAAE,2BAAkB;IAC1B,aAAa,EAAE,2BAAkB;IACjC,YAAY,EAAE,2BAAkB;IAChC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC;CAC9C,CAAC,CAAC;AAGH;;;GAGG;AACU,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC;IACvD,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,QAAQ,CAAC,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SACpE,QAAQ,EAAE;IACf,KAAK,EAAE,OAAC,CAAC,MAAM;SACV,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SAC9D,QAAQ,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SACnE,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;SAC/D,OAAO,CAAC,EAAE,CAAC;CACnB,CAAC,CAAC;AAGU,QAAA,mCAAmC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,kCAA0B,CAAC;IAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC"}

package/build/v1/wallet/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./wallet.errors"), exports);
 __exportStar(require("./queries"), exports);
 __exportStar(require("./unreg"), exports);
 __exportStar(require("./admin"), exports);
+// Re-export from centralized locations
 var controllers_1 = require("../../controllers");
 Object.defineProperty(exports, "WALLET_CONTROLLER", { enumerable: true, get: function () { return controllers_1.WALLET_CONTROLLER; } });
 var routes_1 = require("../../routes");

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/wallet/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,kDAAgC;AAChC,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AAExB,iDAAsD;AAA7C,gHAAA,iBAAiB,OAAA;AAC1B,uCAA6C;AAApC,uGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/wallet/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,kDAAgC;AAChC,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,uCAAuC;AACvC,iDAAsD;AAA7C,gHAAA,iBAAiB,OAAA;AAC1B,uCAA6C;AAApC,uGAAA,aAAa,OAAA"}

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

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Get Balance Summary Query
+ * Public API - returns user's balance summary
+ */
 export declare namespace GetBalanceSummaryQuery {
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodObject<{

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

@@ -5,6 +5,10 @@ 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");
+/**
+ * Get Balance Summary Query
+ * Public API - returns user's balance summary
+ */
 var GetBalanceSummaryQuery;
 (function (GetBalanceSummaryQuery) {
     GetBalanceSummaryQuery.Request = zod_1.z.object({});

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

@@ -1 +1 @@
-{"version":3,"file":"get-balance-summary.query.js","sourceRoot":"","sources":["../../../../v1/wallet/queries/get-balance-summary.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA0D;AAC1D,gDAA6C;AAC7C,uEAA8D;AAM9D,IAAiB,sBAAsB,CAStC;AATD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,+BAAQ,GAAG,sCAA4B,CAAC;IAExC,0BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;IACrC,6BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,sBAAsB,sCAAtB,sBAAsB,QAStC"}
+{"version":3,"file":"get-balance-summary.query.js","sourceRoot":"","sources":["../../../../v1/wallet/queries/get-balance-summary.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA0D;AAC1D,gDAA6C;AAC7C,uEAA8D;AAE9D;;;GAGG;AACH,IAAiB,sBAAsB,CAStC;AATD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,+BAAQ,GAAG,sCAA4B,CAAC;IAExC,0BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;IACrC,6BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,sBAAsB,sCAAtB,sBAAsB,QAStC"}

package/build/v1/wallet/queries/list-wallet-events.query.d.ts

@@ -1,5 +1,14 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * GET /api/v1/wallet/events
+ *
+ * Cursor-paginated user-facing wallet events. Reads from the
+ * `v_wallet_events` view which rolls up `balance_transactions` by
+ * `correlation_id`, drops net-zero round-trips (cancelled holds), and
+ * projects only structural flags + final balance — internal HOLD_*
+ * mechanics never reach the wire.
+ */
 export declare namespace WalletListEventsQuery {
     const Request: z.ZodObject<{
         cursor: z.ZodOptional<z.ZodString>;

package/build/v1/wallet/queries/list-wallet-events.query.js

@@ -4,6 +4,15 @@ exports.WalletListEventsQuery = void 0;
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * GET /api/v1/wallet/events
+ *
+ * Cursor-paginated user-facing wallet events. Reads from the
+ * `v_wallet_events` view which rolls up `balance_transactions` by
+ * `correlation_id`, drops net-zero round-trips (cancelled holds), and
+ * projects only structural flags + final balance — internal HOLD_*
+ * mechanics never reach the wire.
+ */
 var WalletListEventsQuery;
 (function (WalletListEventsQuery) {
     WalletListEventsQuery.Request = schemas_1.WalletEventsListRequestSchema;

package/build/v1/wallet/queries/list-wallet-events.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-wallet-events.query.js","sourceRoot":"","sources":["../../../../v1/wallet/queries/list-wallet-events.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAW9D,IAAiB,qBAAqB,CASrC;AATD,WAAiB,qBAAqB;IACrB,6BAAO,GAAG,uCAA6B,CAAC;IACxC,8BAAQ,GAAG,wCAA8B,CAAC;IAE1C,yBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;IACpC,4BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,qBAAqB,qCAArB,qBAAqB,QASrC"}
+{"version":3,"file":"list-wallet-events.query.js","sourceRoot":"","sources":["../../../../v1/wallet/queries/list-wallet-events.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;;;;;GAQG;AACH,IAAiB,qBAAqB,CASrC;AATD,WAAiB,qBAAqB;IACrB,6BAAO,GAAG,uCAA6B,CAAC;IACxC,8BAAQ,GAAG,wCAA8B,CAAC;IAE1C,yBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;IACpC,4BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,qBAAqB,qCAArB,qBAAqB,QASrC"}

package/build/v1/wallet/schemas/balance-response.schema.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { BalanceStatus } from './balance-status.enum';
+/**
+ * Single Balance Item Response Schema
+ * Note: amount, held, available are strings to preserve BigInt precision
+ */
 export declare const BalanceItemResponseSchema: z.ZodObject<{
     id: z.ZodString;
     typeCode: z.ZodString;
@@ -12,6 +16,15 @@ export declare const BalanceItemResponseSchema: z.ZodObject<{
     expiresAt: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodString;
 }, z.core.$strip>;
+/**
+ * Active hold visible on the balance summary. PENDING-status hold
+ * carrying the operation it was opened for, plus its expiry. Lets
+ * the UI show "what's currently reserved" alongside the totals
+ * without a second roundtrip.
+ *
+ * `amount` is `BigIntStringSchema` for consistency with the rest
+ * of the wallet wire surface — preserves precision over the wire.
+ */
 export declare const BalanceActiveHoldSchema: z.ZodObject<{
     holdId: z.ZodString;
     amount: z.ZodString;
@@ -21,6 +34,11 @@ export declare const BalanceActiveHoldSchema: z.ZodObject<{
     createdAt: z.ZodString;
     expiresAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * Balance Summary Response Schema
+ * See WALLET_API.md section 4.6
+ * Note: totalAvailable, totalHeld are strings to preserve BigInt precision
+ */
 export declare const BalanceSummaryResponseSchema: z.ZodObject<{
     userId: z.ZodString;
     totalAvailable: z.ZodString;

package/build/v1/wallet/schemas/balance-response.schema.js

@@ -4,6 +4,10 @@ exports.BalanceSummaryResponseSchema = exports.BalanceActiveHoldSchema = exports
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const balance_status_enum_1 = require("./balance-status.enum");
+/**
+ * Single Balance Item Response Schema
+ * Note: amount, held, available are strings to preserve BigInt precision
+ */
 exports.BalanceItemResponseSchema = zod_1.z.object({
     id: zod_1.z.string().uuid(),
     typeCode: zod_1.z.string(),
@@ -11,11 +15,25 @@ exports.BalanceItemResponseSchema = zod_1.z.object({
     amount: shared_1.BigIntStringSchema,
     held: shared_1.BigIntStringSchema,
     available: shared_1.BigIntStringSchema,
+    /**
+     * False when the antifraud restriction blocks this bucket for the owner:
+     * the money is visible but cannot be spent until the account is verified
+     * (see the verification-status endpoint for the unlock ladder).
+     */
     spendable: zod_1.z.boolean(),
     status: zod_1.z.enum(balance_status_enum_1.BalanceStatus),
     expiresAt: zod_1.z.string().datetime().nullable(),
     createdAt: zod_1.z.string().datetime(),
 });
+/**
+ * Active hold visible on the balance summary. PENDING-status hold
+ * carrying the operation it was opened for, plus its expiry. Lets
+ * the UI show "what's currently reserved" alongside the totals
+ * without a second roundtrip.
+ *
+ * `amount` is `BigIntStringSchema` for consistency with the rest
+ * of the wallet wire surface — preserves precision over the wire.
+ */
 exports.BalanceActiveHoldSchema = zod_1.z.object({
     holdId: zod_1.z.string().regex(shared_1.UUID_REGEX),
     amount: shared_1.BigIntStringSchema,
@@ -25,9 +43,16 @@ exports.BalanceActiveHoldSchema = zod_1.z.object({
     createdAt: zod_1.z.string().datetime(),
     expiresAt: zod_1.z.string().datetime().nullable(),
 });
+/**
+ * Balance Summary Response Schema
+ * See WALLET_API.md section 4.6
+ * Note: totalAvailable, totalHeld are strings to preserve BigInt precision
+ */
 exports.BalanceSummaryResponseSchema = zod_1.z.object({
     userId: zod_1.z.string().uuid(),
+    /** Sum over spendable buckets only — the number the user can actually spend. */
     totalAvailable: shared_1.BigIntStringSchema,
+    /** Restriction-locked remainder — what unlocks after account verification. */
     totalLocked: shared_1.BigIntStringSchema,
     totalHeld: shared_1.BigIntStringSchema,
     balances: zod_1.z.array(exports.BalanceItemResponseSchema),

package/build/v1/wallet/schemas/balance-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"balance-response.schema.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/balance-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAiE;AACjE,+DAAsD;AAMzC,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,2BAAkB;IAC1B,IAAI,EAAE,2BAAkB;IACxB,SAAS,EAAE,2BAAkB;IAM7B,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE;IACtB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,mCAAa,CAAC;IAC7B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAWU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IACpC,MAAM,EAAE,2BAAkB;IAC1B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAOU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAEzB,cAAc,EAAE,2BAAkB;IAElC,WAAW,EAAE,2BAAkB;IAC/B,SAAS,EAAE,2BAAkB;IAC7B,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,iCAAyB,CAAC;IAC5C,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,+BAAuB,CAAC;CAChD,CAAC,CAAC"}
+{"version":3,"file":"balance-response.schema.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/balance-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAiE;AACjE,+DAAsD;AAEtD;;;GAGG;AACU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,2BAAkB;IAC1B,IAAI,EAAE,2BAAkB;IACxB,SAAS,EAAE,2BAAkB;IAC7B;;;;OAIG;IACH,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE;IACtB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,mCAAa,CAAC;IAC7B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IACpC,MAAM,EAAE,2BAAkB;IAC1B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAEH;;;;GAIG;AACU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzB,gFAAgF;IAChF,cAAc,EAAE,2BAAkB;IAClC,8EAA8E;IAC9E,WAAW,EAAE,2BAAkB;IAC/B,SAAS,EAAE,2BAAkB;IAC7B,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,iCAAyB,CAAC;IAC5C,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,+BAAuB,CAAC;CAChD,CAAC,CAAC"}

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

@@ -1,3 +1,7 @@
+/**
+ * Balance Status Enum
+ * See WALLET_API.md section 2.2
+ */
 export declare enum BalanceStatus {
     ACTIVE = "ACTIVE",
     DEPLETED = "DEPLETED",

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"balance-status.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/balance-status.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,aAMX;AAND,WAAY,aAAa;IACrB,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,wCAAuB,CAAA;AAC3B,CAAC,EANW,aAAa,6BAAb,aAAa,QAMxB"}
+{"version":3,"file":"balance-status.enum.js","sourceRoot":"","sources":["../../../../v1/wallet/schemas/balance-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,aAMX;AAND,WAAY,aAAa;IACrB,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,wCAAuB,CAAA;AAC3B,CAAC,EANW,aAAa,6BAAb,aAAa,QAMxB"}

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

@@ -1,10 +1,46 @@
 export declare enum BalanceTypeCode {
     DAILY_REWARD = "DAILY_REWARD",
     TASK_REWARD = "TASK_REWARD",
+    /**
+     * One-time bonus credited to an unregistered (anonymous) user when
+     * their session is first created. Used by the welcome-credit event
+     * handler to seed a UserBalance row attached to the unreg session
+     * via UserBalance.unregisteredUserId. The amount is configured in
+     * env (UNREG_WELCOME_KOPEKS, default 1500 = 15 RUB).
+     */
     UNREG_WELCOME = "UNREG_WELCOME",
+    /**
+     * Monthly grant credited at the start of each subscription cycle.
+     * Rolled over each month according to plan rolloverPercent (only this bucket rolls).
+     * priority=75 so it burns before DAILY_REWARD (higher priority = burns first).
+     * spend-order: priority DESC, expires_at ASC — burns nearest-to-expiry first within same priority.
+     */
     SUBSCRIPTION_GRANT = "SUBSCRIPTION_GRANT",
+    /**
+     * One-time package grant credited when a package purchase is fulfilled.
+     * Expires 1 year from purchase. No rollover.
+     * priority=75 — same as SUBSCRIPTION_GRANT so spend-order uses expires_at ASC.
+     */
     PACKAGE_GRANT = "PACKAGE_GRANT",
+    /**
+     * Bonus portion of a subscription grant (bonusPercent of monthly grant).
+     * Credited alongside SUBSCRIPTION_GRANT but in a separate bucket.
+     * Does NOT roll over (blueprint §2 decision 6).
+     * priority=75.
+     */
     TOPUP_BONUS = "TOPUP_BONUS",
+    /**
+     * Rollover bucket — unused SUBSCRIPTION_GRANT remainder carried forward
+     * at the cycle boundary.  Expires at end of next cycle.
+     * Does NOT compound (blueprint §2 decision 6).
+     * priority=75.
+     */
     ROLLOVER = "ROLLOVER",
+    /**
+     * Bonus credited via a promo code (ACCOUNT_BONUS kind).
+     * Expires after N days configured on the promo code (own TTL, no rollover).
+     * priority=75 — same bucket as subscription grants; spend-order uses expires_at ASC.
+     * sourceType=PROMO, sourceId=promoCodeId.
+     */
     PROMO_BONUS = "PROMO_BONUS"
 }

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

@@ -5,11 +5,47 @@ var BalanceTypeCode;
 (function (BalanceTypeCode) {
     BalanceTypeCode["DAILY_REWARD"] = "DAILY_REWARD";
     BalanceTypeCode["TASK_REWARD"] = "TASK_REWARD";
+    /**
+     * One-time bonus credited to an unregistered (anonymous) user when
+     * their session is first created. Used by the welcome-credit event
+     * handler to seed a UserBalance row attached to the unreg session
+     * via UserBalance.unregisteredUserId. The amount is configured in
+     * env (UNREG_WELCOME_KOPEKS, default 1500 = 15 RUB).
+     */
     BalanceTypeCode["UNREG_WELCOME"] = "UNREG_WELCOME";
+    /**
+     * Monthly grant credited at the start of each subscription cycle.
+     * Rolled over each month according to plan rolloverPercent (only this bucket rolls).
+     * priority=75 so it burns before DAILY_REWARD (higher priority = burns first).
+     * spend-order: priority DESC, expires_at ASC — burns nearest-to-expiry first within same priority.
+     */
     BalanceTypeCode["SUBSCRIPTION_GRANT"] = "SUBSCRIPTION_GRANT";
+    /**
+     * One-time package grant credited when a package purchase is fulfilled.
+     * Expires 1 year from purchase. No rollover.
+     * priority=75 — same as SUBSCRIPTION_GRANT so spend-order uses expires_at ASC.
+     */
     BalanceTypeCode["PACKAGE_GRANT"] = "PACKAGE_GRANT";
+    /**
+     * Bonus portion of a subscription grant (bonusPercent of monthly grant).
+     * Credited alongside SUBSCRIPTION_GRANT but in a separate bucket.
+     * Does NOT roll over (blueprint §2 decision 6).
+     * priority=75.
+     */
     BalanceTypeCode["TOPUP_BONUS"] = "TOPUP_BONUS";
+    /**
+     * Rollover bucket — unused SUBSCRIPTION_GRANT remainder carried forward
+     * at the cycle boundary.  Expires at end of next cycle.
+     * Does NOT compound (blueprint §2 decision 6).
+     * priority=75.
+     */
     BalanceTypeCode["ROLLOVER"] = "ROLLOVER";
+    /**
+     * Bonus credited via a promo code (ACCOUNT_BONUS kind).
+     * Expires after N days configured on the promo code (own TTL, no rollover).
+     * priority=75 — same bucket as subscription grants; spend-order uses expires_at ASC.
+     * sourceType=PROMO, sourceId=promoCodeId.
+     */
     BalanceTypeCode["PROMO_BONUS"] = "PROMO_BONUS";
 })(BalanceTypeCode || (exports.BalanceTypeCode = BalanceTypeCode = {}));
 //# sourceMappingURL=balance-type-code.enum.js.map