@veruna/api-contracts 1.0.40 → 1.0.41

package/build/controllers/index.d.ts

@@ -13,3 +13,5 @@ export { CHAT_PROJECT_CONTROLLER } from './chat-project.controllers';
 export { CHAT_UNREG_CONTROLLER, CHAT_REG_CONTROLLER, CHAT_HISTORY_CONTROLLER, } from './chat.controllers';
 export { MESSAGE_UNREG_CONTROLLER, MESSAGE_REG_CONTROLLER } from './message.controllers';
 export { VERIFICATION_CONTROLLER } from './verification.controllers';
+export { SITEMAP_CONTROLLER } from './sitemap.controllers';
+export { WALLET_CONTROLLER } from './wallet.controllers';

package/build/controllers/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERIFICATION_CONTROLLER = exports.MESSAGE_REG_CONTROLLER = exports.MESSAGE_UNREG_CONTROLLER = exports.CHAT_HISTORY_CONTROLLER = exports.CHAT_REG_CONTROLLER = exports.CHAT_UNREG_CONTROLLER = exports.CHAT_PROJECT_CONTROLLER = exports.FILE_CONTROLLER = exports.AI_MODEL_PUBLIC_CONTROLLER = exports.AI_MODEL_ADMIN_CONTROLLER = exports.AI_PROVIDER_PUBLIC_CONTROLLER = exports.AI_PROVIDER_ADMIN_CONTROLLER = exports.SEO_PAGES_PUBLIC_CONTROLLER = exports.SEO_PAGES_ADMIN_CONTROLLER = exports.BLOG_PUBLIC_POSTS_CONTROLLER = exports.BLOG_PUBLIC_CATEGORIES_CONTROLLER = exports.BLOG_ADMIN_POSTS_CONTROLLER = exports.BLOG_ADMIN_CATEGORIES_CONTROLLER = exports.UNREG_USERS_CONTROLLER = exports.USERS_CONTROLLER = exports.AUTH_CONTROLLER = void 0;
+exports.WALLET_CONTROLLER = exports.SITEMAP_CONTROLLER = exports.VERIFICATION_CONTROLLER = exports.MESSAGE_REG_CONTROLLER = exports.MESSAGE_UNREG_CONTROLLER = exports.CHAT_HISTORY_CONTROLLER = exports.CHAT_REG_CONTROLLER = exports.CHAT_UNREG_CONTROLLER = exports.CHAT_PROJECT_CONTROLLER = exports.FILE_CONTROLLER = exports.AI_MODEL_PUBLIC_CONTROLLER = exports.AI_MODEL_ADMIN_CONTROLLER = exports.AI_PROVIDER_PUBLIC_CONTROLLER = exports.AI_PROVIDER_ADMIN_CONTROLLER = exports.SEO_PAGES_PUBLIC_CONTROLLER = exports.SEO_PAGES_ADMIN_CONTROLLER = exports.BLOG_PUBLIC_POSTS_CONTROLLER = exports.BLOG_PUBLIC_CATEGORIES_CONTROLLER = exports.BLOG_ADMIN_POSTS_CONTROLLER = exports.BLOG_ADMIN_CATEGORIES_CONTROLLER = exports.UNREG_USERS_CONTROLLER = exports.USERS_CONTROLLER = exports.AUTH_CONTROLLER = void 0;
 /**
  * Centralized exports for all controllers
  */
@@ -37,3 +37,7 @@ Object.defineProperty(exports, "MESSAGE_UNREG_CONTROLLER", { enumerable: true, g
 Object.defineProperty(exports, "MESSAGE_REG_CONTROLLER", { enumerable: true, get: function () { return message_controllers_1.MESSAGE_REG_CONTROLLER; } });
 var verification_controllers_1 = require("./verification.controllers");
 Object.defineProperty(exports, "VERIFICATION_CONTROLLER", { enumerable: true, get: function () { return verification_controllers_1.VERIFICATION_CONTROLLER; } });
+var sitemap_controllers_1 = require("./sitemap.controllers");
+Object.defineProperty(exports, "SITEMAP_CONTROLLER", { enumerable: true, get: function () { return sitemap_controllers_1.SITEMAP_CONTROLLER; } });
+var wallet_controllers_1 = require("./wallet.controllers");
+Object.defineProperty(exports, "WALLET_CONTROLLER", { enumerable: true, get: function () { return wallet_controllers_1.WALLET_CONTROLLER; } });

package/build/controllers/sitemap.controllers.d.ts

@@ -0,0 +1 @@
+export declare const SITEMAP_CONTROLLER: "xml/sitemap";

package/build/controllers/sitemap.controllers.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITEMAP_CONTROLLER = void 0;
+exports.SITEMAP_CONTROLLER = 'xml/sitemap';

package/build/controllers/wallet.controllers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Wallet Controller path for NestJS @Controller decorator
+ *
+ * Only public controller for user balance viewing.
+ * All wallet operations (Credit, Debit, Hold) are internal service calls.
+ */
+export declare const WALLET_CONTROLLER: "v1/wallet";

package/build/controllers/wallet.controllers.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WALLET_CONTROLLER = void 0;
+/**
+ * Wallet Controller path for NestJS @Controller decorator
+ *
+ * Only public controller for user balance viewing.
+ * All wallet operations (Credit, Debit, Hold) are internal service calls.
+ */
+exports.WALLET_CONTROLLER = 'v1/wallet';

package/build/rest-api.d.ts

@@ -152,5 +152,8 @@ export declare const REST_API: {
             readonly ACTIVE: "/api/v1/verification/active";
             readonly CANCEL: (requestId: string) => string;
         };
+        readonly WALLET: {
+            readonly BALANCE: "/api/v1/wallet/balance";
+        };
     };
 };

package/build/rest-api.js

@@ -169,5 +169,9 @@ exports.REST_API = {
             ACTIVE: `${exports.ROOT}/${controllers_1.VERIFICATION_CONTROLLER}/${routes_1.VERIFICATION_ROUTES.ACTIVE}`,
             CANCEL: (requestId) => `${exports.ROOT}/${controllers_1.VERIFICATION_CONTROLLER}/${requestId}/cancel`,
         },
+        // Wallet module (only public balance endpoint)
+        WALLET: {
+            BALANCE: `${exports.ROOT}/${controllers_1.WALLET_CONTROLLER}/${routes_1.WALLET_ROUTES.BALANCE}`,
+        },
     },
 };

package/build/routes/index.d.ts

@@ -18,3 +18,5 @@ export { CHAT_PROJECT_ROUTES } from './chat-project.routes';
 export { CHAT_UNREG_ROUTES, CHAT_REG_ROUTES, CHAT_HISTORY_ROUTES } from './chat.routes';
 export { MESSAGE_UNREG_ROUTES, MESSAGE_REG_ROUTES } from './message.routes';
 export { VERIFICATION_ROUTES } from './verification.routes';
+export { SITEMAP_ROUTES } from './sitemap.routes';
+export { WALLET_ROUTES } from './wallet.routes';

package/build/routes/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERIFICATION_ROUTES = exports.MESSAGE_REG_ROUTES = exports.MESSAGE_UNREG_ROUTES = exports.CHAT_HISTORY_ROUTES = exports.CHAT_REG_ROUTES = exports.CHAT_UNREG_ROUTES = exports.CHAT_PROJECT_ROUTES = exports.FILE_ROUTES = exports.AI_MODEL_PUBLIC_ROUTES = exports.AI_MODEL_ADMIN_ROUTES = exports.AI_PROVIDER_PUBLIC_ROUTES = exports.AI_PROVIDER_ADMIN_ROUTES = exports.SEO_PAGES_PUBLIC_ROUTES = exports.SEO_PAGES_ADMIN_ROUTES = exports.BLOG_PUBLIC_POSTS_ROUTES = exports.BLOG_PUBLIC_CATEGORIES_ROUTES = exports.BLOG_ADMIN_POSTS_ROUTES = exports.BLOG_ADMIN_CATEGORIES_ROUTES = exports.UNREG_USERS_ROUTES = exports.USERS_ROUTES = exports.AUTH_ROUTES = void 0;
+exports.WALLET_ROUTES = exports.SITEMAP_ROUTES = exports.VERIFICATION_ROUTES = exports.MESSAGE_REG_ROUTES = exports.MESSAGE_UNREG_ROUTES = exports.CHAT_HISTORY_ROUTES = exports.CHAT_REG_ROUTES = exports.CHAT_UNREG_ROUTES = exports.CHAT_PROJECT_ROUTES = exports.FILE_ROUTES = exports.AI_MODEL_PUBLIC_ROUTES = exports.AI_MODEL_ADMIN_ROUTES = exports.AI_PROVIDER_PUBLIC_ROUTES = exports.AI_PROVIDER_ADMIN_ROUTES = exports.SEO_PAGES_PUBLIC_ROUTES = exports.SEO_PAGES_ADMIN_ROUTES = exports.BLOG_PUBLIC_POSTS_ROUTES = exports.BLOG_PUBLIC_CATEGORIES_ROUTES = exports.BLOG_ADMIN_POSTS_ROUTES = exports.BLOG_ADMIN_CATEGORIES_ROUTES = exports.UNREG_USERS_ROUTES = exports.USERS_ROUTES = exports.AUTH_ROUTES = void 0;
 /**
  * Centralized exports for all routes
  */
@@ -42,3 +42,7 @@ Object.defineProperty(exports, "MESSAGE_UNREG_ROUTES", { enumerable: true, get:
 Object.defineProperty(exports, "MESSAGE_REG_ROUTES", { enumerable: true, get: function () { return message_routes_1.MESSAGE_REG_ROUTES; } });
 var verification_routes_1 = require("./verification.routes");
 Object.defineProperty(exports, "VERIFICATION_ROUTES", { enumerable: true, get: function () { return verification_routes_1.VERIFICATION_ROUTES; } });
+var sitemap_routes_1 = require("./sitemap.routes");
+Object.defineProperty(exports, "SITEMAP_ROUTES", { enumerable: true, get: function () { return sitemap_routes_1.SITEMAP_ROUTES; } });
+var wallet_routes_1 = require("./wallet.routes");
+Object.defineProperty(exports, "WALLET_ROUTES", { enumerable: true, get: function () { return wallet_routes_1.WALLET_ROUTES; } });

package/build/routes/sitemap.routes.d.ts

@@ -0,0 +1,3 @@
+export declare const SITEMAP_ROUTES: {
+    readonly GET: "";
+};

package/build/routes/sitemap.routes.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITEMAP_ROUTES = void 0;
+exports.SITEMAP_ROUTES = {
+    GET: '',
+};

package/build/routes/wallet.routes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Wallet Routes
+ * For NestJS method decorators (@Get, @Post, etc.)
+ *
+ * Only public route for getting balance.
+ * All other operations (Credit, Debit, Hold) are internal service calls,
+ * not exposed via HTTP endpoints.
+ */
+export declare const WALLET_ROUTES: {
+    readonly BALANCE: "balance";
+};

package/build/routes/wallet.routes.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WALLET_ROUTES = void 0;
+/**
+ * Wallet Routes
+ * For NestJS method decorators (@Get, @Post, etc.)
+ *
+ * Only public route for getting balance.
+ * All other operations (Credit, Debit, Hold) are internal service calls,
+ * not exposed via HTTP endpoints.
+ */
+exports.WALLET_ROUTES = {
+    BALANCE: 'balance',
+};

package/build/shared/common-schemas.d.ts

@@ -15,3 +15,8 @@ export declare const EmptyResponseSchema: z.ZodObject<{}, z.core.$strip>;
 export declare const DeleteResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
 }, z.core.$strip>;
+/**
+ * BigInt as string schema (for JSON serialization of bigint values)
+ * Validates that string contains only digits (non-negative integer)
+ */
+export declare const BigIntStringSchema: z.ZodString;

package/build/shared/common-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeleteResponseSchema = exports.EmptyResponseSchema = exports.queryArraySchema = void 0;
+exports.BigIntStringSchema = exports.DeleteResponseSchema = exports.EmptyResponseSchema = exports.queryArraySchema = void 0;
 const zod_1 = require("zod");
 const regex_1 = require("./regex");
 /**
@@ -9,9 +9,7 @@ const regex_1 = require("./regex");
  * Usage: queryArraySchema() for optional, queryArraySchema(false) for required
  */
 const queryArraySchema = (optional = true) => {
-    const schema = zod_1.z
-        .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
-        .transform((val) => {
+    const schema = zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).transform((val) => {
         if (Array.isArray(val))
             return val;
         return [val];
@@ -29,3 +27,10 @@ exports.EmptyResponseSchema = zod_1.z.object({});
 exports.DeleteResponseSchema = zod_1.z.object({
     uuid: zod_1.z.string().regex(regex_1.UUID_REGEX),
 });
+/**
+ * BigInt as string schema (for JSON serialization of bigint values)
+ * Validates that string contains only digits (non-negative integer)
+ */
+exports.BigIntStringSchema = zod_1.z
+    .string()
+    .regex(regex_1.BIGINT_STRING_REGEX, 'Must be a non-negative integer string');

package/build/shared/regex.d.ts

@@ -7,3 +7,4 @@ export declare const DATETIME_REGEX: RegExp;
 export declare const PASSWORD_STRENGTH_REGEX: RegExp;
 export declare const SLUG_REGEX: RegExp;
 export declare const HEX_COLOR_REGEX: RegExp;
+export declare const BIGINT_STRING_REGEX: RegExp;

package/build/shared/regex.js

@@ -3,7 +3,7 @@
  * Common regex patterns for validation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HEX_COLOR_REGEX = exports.SLUG_REGEX = exports.PASSWORD_STRENGTH_REGEX = exports.DATETIME_REGEX = exports.UUID_REGEX = exports.EMAIL_REGEX = void 0;
+exports.BIGINT_STRING_REGEX = exports.HEX_COLOR_REGEX = exports.SLUG_REGEX = exports.PASSWORD_STRENGTH_REGEX = exports.DATETIME_REGEX = exports.UUID_REGEX = exports.EMAIL_REGEX = void 0;
 // RFC 5322 email regex (simplified)
 exports.EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
 // UUID v4 regex
@@ -16,3 +16,5 @@ exports.PASSWORD_STRENGTH_REGEX = /[0-9!@#$%^&*(),.?":{}|<>]/;
 exports.SLUG_REGEX = /^[a-z0-9-]+$/;
 // Hex color regex: #RRGGBB
 exports.HEX_COLOR_REGEX = /^#[0-9A-Fa-f]{6}$/;
+// BigInt string regex (non-negative integer as string)
+exports.BIGINT_STRING_REGEX = /^\d+$/;

package/build/v1/blog/admin/commands/create-post.command.d.ts

@@ -4,6 +4,7 @@ export declare namespace AdminBlogCreatePostCommand {
     const Request: z.ZodObject<{
         alias: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
         title: z.ZodString;
+        description: z.ZodString;
         metaTitle: z.ZodString;
         metaDescription: z.ZodString;
         content: z.ZodString;
@@ -20,6 +21,7 @@ export declare namespace AdminBlogCreatePostCommand {
         uuid: z.ZodString;
         alias: z.ZodString;
         title: z.ZodString;
+        description: z.ZodString;
         metaTitle: z.ZodString;
         metaDescription: z.ZodString;
         content: z.ZodString;

package/build/v1/blog/admin/commands/update-post.command.d.ts

@@ -4,6 +4,7 @@ export declare namespace AdminBlogUpdatePostCommand {
     const Request: z.ZodObject<{
         alias: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         metaTitle: z.ZodOptional<z.ZodString>;
         metaDescription: z.ZodOptional<z.ZodString>;
         content: z.ZodOptional<z.ZodString>;
@@ -20,6 +21,7 @@ export declare namespace AdminBlogUpdatePostCommand {
         uuid: z.ZodString;
         alias: z.ZodString;
         title: z.ZodString;
+        description: z.ZodString;
         metaTitle: z.ZodString;
         metaDescription: z.ZodString;
         content: z.ZodString;

package/build/v1/blog/admin/queries/get-post.query.d.ts

@@ -8,6 +8,7 @@ export declare namespace AdminBlogGetPostQuery {
         uuid: z.ZodString;
         alias: z.ZodString;
         title: z.ZodString;
+        description: z.ZodString;
         metaTitle: z.ZodString;
         metaDescription: z.ZodString;
         content: z.ZodString;

package/build/v1/blog/admin/queries/get-posts.query.d.ts

@@ -12,6 +12,7 @@ export declare namespace AdminBlogGetPostsQuery {
             uuid: z.ZodString;
             alias: z.ZodString;
             title: z.ZodString;
+            description: z.ZodString;
             metaTitle: z.ZodString;
             metaDescription: z.ZodString;
             content: z.ZodString;

package/build/v1/blog/public/queries/get-post-by-alias.query.d.ts

@@ -8,6 +8,7 @@ export declare namespace BlogGetPostByAliasQuery {
         uuid: z.ZodString;
         alias: z.ZodString;
         title: z.ZodString;
+        description: z.ZodString;
         metaTitle: z.ZodString;
         metaDescription: z.ZodString;
         content: z.ZodString;

package/build/v1/blog/public/queries/get-posts.query.d.ts

@@ -11,6 +11,7 @@ export declare namespace BlogGetPostsQuery {
             uuid: z.ZodString;
             alias: z.ZodString;
             title: z.ZodString;
+            description: z.ZodString;
             metaTitle: z.ZodString;
             metaDescription: z.ZodString;
             content: z.ZodString;

package/build/v1/blog/schemas/create-post-request.schema.d.ts

@@ -4,6 +4,7 @@ import { BlogPostMark } from './blog-post-mark.enum';
 export declare const CreatePostRequestSchema: z.ZodObject<{
     alias: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     title: z.ZodString;
+    description: z.ZodString;
     metaTitle: z.ZodString;
     metaDescription: z.ZodString;
     content: z.ZodString;

package/build/v1/blog/schemas/create-post-request.schema.js

@@ -14,6 +14,7 @@ exports.CreatePostRequestSchema = zod_1.z
         .regex(shared_1.SLUG_REGEX)
         .transform((val) => val.toLowerCase().trim()),
     title: zod_1.z.string().min(1).max(300),
+    description: zod_1.z.string().max(1000),
     metaTitle: zod_1.z.string().min(1).max(100),
     metaDescription: zod_1.z.string().min(1).max(200),
     content: zod_1.z.string().min(1).max(1000000),

package/build/v1/blog/schemas/post-response.schema.d.ts

@@ -8,6 +8,7 @@ export declare const PostResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
     alias: z.ZodString;
     title: z.ZodString;
+    description: z.ZodString;
     metaTitle: z.ZodString;
     metaDescription: z.ZodString;
     content: z.ZodString;

package/build/v1/blog/schemas/post-response.schema.js

@@ -13,6 +13,7 @@ exports.PostResponseSchema = zod_1.z.object({
     uuid: zod_1.z.string().regex(regex_1.UUID_REGEX),
     alias: zod_1.z.string(),
     title: zod_1.z.string(),
+    description: zod_1.z.string(),
     metaTitle: zod_1.z.string(),
     metaDescription: zod_1.z.string(),
     content: zod_1.z.string(),

package/build/v1/blog/schemas/public-post-response.schema.d.ts

@@ -14,6 +14,7 @@ export declare const PublicPostResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
     alias: z.ZodString;
     title: z.ZodString;
+    description: z.ZodString;
     metaTitle: z.ZodString;
     metaDescription: z.ZodString;
     content: z.ZodString;

package/build/v1/blog/schemas/update-post-request.schema.d.ts

@@ -4,6 +4,7 @@ import { BlogPostMark } from './blog-post-mark.enum';
 export declare const UpdatePostRequestSchema: z.ZodObject<{
     alias: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
     title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
     metaTitle: z.ZodOptional<z.ZodString>;
     metaDescription: z.ZodOptional<z.ZodString>;
     content: z.ZodOptional<z.ZodString>;

package/build/v1/blog/schemas/update-post-request.schema.js

@@ -15,6 +15,7 @@ exports.UpdatePostRequestSchema = zod_1.z
         .transform((val) => val.toLowerCase().trim())
         .optional(),
     title: zod_1.z.string().min(1).max(300).optional(),
+    description: zod_1.z.string().max(1000).optional(),
     metaTitle: zod_1.z.string().min(1).max(100).optional(),
     metaDescription: zod_1.z.string().min(1).max(200).optional(),
     content: zod_1.z.string().min(1).max(1000000).optional(),

package/build/v1/index.d.ts

@@ -12,3 +12,5 @@ export * from './chat';
 export * from './message';
 export * from './ai';
 export * from './verification';
+export * from './sitemap';
+export * from './wallet';

package/build/v1/index.js

@@ -28,3 +28,5 @@ __exportStar(require("./chat"), exports);
 __exportStar(require("./message"), exports);
 __exportStar(require("./ai"), exports);
 __exportStar(require("./verification"), exports);
+__exportStar(require("./sitemap"), exports);
+__exportStar(require("./wallet"), exports);

package/build/v1/sitemap/index.d.ts

@@ -0,0 +1 @@
+export { SitemapChangefreq } from './sitemap-changefreq.enum';

package/build/v1/sitemap/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SitemapChangefreq = void 0;
+var sitemap_changefreq_enum_1 = require("./sitemap-changefreq.enum");
+Object.defineProperty(exports, "SitemapChangefreq", { enumerable: true, get: function () { return sitemap_changefreq_enum_1.SitemapChangefreq; } });

package/build/v1/sitemap/sitemap-changefreq.enum.d.ts

@@ -0,0 +1,9 @@
+export declare enum SitemapChangefreq {
+    ALWAYS = "always",
+    HOURLY = "hourly",
+    DAILY = "daily",
+    WEEKLY = "weekly",
+    MONTHLY = "monthly",
+    YEARLY = "yearly",
+    NEVER = "never"
+}

package/build/v1/sitemap/sitemap-changefreq.enum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SitemapChangefreq = void 0;
+var SitemapChangefreq;
+(function (SitemapChangefreq) {
+    SitemapChangefreq["ALWAYS"] = "always";
+    SitemapChangefreq["HOURLY"] = "hourly";
+    SitemapChangefreq["DAILY"] = "daily";
+    SitemapChangefreq["WEEKLY"] = "weekly";
+    SitemapChangefreq["MONTHLY"] = "monthly";
+    SitemapChangefreq["YEARLY"] = "yearly";
+    SitemapChangefreq["NEVER"] = "never";
+})(SitemapChangefreq || (exports.SitemapChangefreq = SitemapChangefreq = {}));

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

@@ -0,0 +1,5 @@
+export * from './schemas';
+export * from './wallet.errors';
+export * from './queries';
+export { WALLET_CONTROLLER } from '../../controllers';
+export { WALLET_ROUTES } from '../../routes';

package/build/v1/wallet/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WALLET_ROUTES = exports.WALLET_CONTROLLER = void 0;
+__exportStar(require("./schemas"), exports);
+__exportStar(require("./wallet.errors"), exports);
+__exportStar(require("./queries"), 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");
+Object.defineProperty(exports, "WALLET_ROUTES", { enumerable: true, get: function () { return routes_1.WALLET_ROUTES; } });

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

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { HttpMethod } from '../../../shared/http-method';
+/**
+ * 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<{
+        userId: z.ZodString;
+        totalAvailable: z.ZodString;
+        totalHeld: z.ZodString;
+        balances: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            typeCode: z.ZodString;
+            typeName: z.ZodString;
+            amount: z.ZodString;
+            held: z.ZodString;
+            available: z.ZodString;
+            status: z.ZodEnum<typeof import("../schemas").BalanceStatus>;
+            expiresAt: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    const URL: "/api/v1/wallet/balance";
+    const METHOD = HttpMethod.GET;
+    type RequestType = z.infer<typeof Request>;
+    type ResponseType = z.infer<typeof Response>;
+}

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetBalanceSummaryQuery = void 0;
+const zod_1 = require("zod");
+const schemas_1 = require("../schemas");
+const rest_api_1 = require("../../../rest-api");
+const http_method_1 = require("../../../shared/http-method");
+/**
+ * Get Balance Summary Query
+ * Public API - returns user's balance summary
+ */
+var GetBalanceSummaryQuery;
+(function (GetBalanceSummaryQuery) {
+    GetBalanceSummaryQuery.Request = zod_1.z.object({});
+    GetBalanceSummaryQuery.Response = schemas_1.BalanceSummaryResponseSchema;
+    GetBalanceSummaryQuery.URL = rest_api_1.REST_API.V1.WALLET.BALANCE;
+    GetBalanceSummaryQuery.METHOD = http_method_1.HttpMethod.GET;
+})(GetBalanceSummaryQuery || (exports.GetBalanceSummaryQuery = GetBalanceSummaryQuery = {}));

package/build/v1/wallet/queries/index.d.ts

@@ -0,0 +1 @@
+export { GetBalanceSummaryQuery } from './get-balance-summary.query';

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

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetBalanceSummaryQuery = void 0;
+var get_balance_summary_query_1 = require("./get-balance-summary.query");
+Object.defineProperty(exports, "GetBalanceSummaryQuery", { enumerable: true, get: function () { return get_balance_summary_query_1.GetBalanceSummaryQuery; } });

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

@@ -0,0 +1,40 @@
+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;
+    typeName: z.ZodString;
+    amount: z.ZodString;
+    held: z.ZodString;
+    available: z.ZodString;
+    status: z.ZodEnum<typeof BalanceStatus>;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    createdAt: 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;
+    totalHeld: z.ZodString;
+    balances: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        typeCode: z.ZodString;
+        typeName: z.ZodString;
+        amount: z.ZodString;
+        held: z.ZodString;
+        available: z.ZodString;
+        status: z.ZodEnum<typeof BalanceStatus>;
+        expiresAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BalanceItemResponse = z.infer<typeof BalanceItemResponseSchema>;
+export type BalanceSummaryResponse = z.infer<typeof BalanceSummaryResponseSchema>;

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BalanceSummaryResponseSchema = exports.BalanceItemResponseSchema = void 0;
+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(),
+    typeName: zod_1.z.string(),
+    amount: shared_1.BigIntStringSchema,
+    held: shared_1.BigIntStringSchema,
+    available: shared_1.BigIntStringSchema,
+    status: zod_1.z.nativeEnum(balance_status_enum_1.BalanceStatus),
+    expiresAt: zod_1.z.string().datetime().nullable(),
+    createdAt: zod_1.z.string().datetime(),
+});
+/**
+ * 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(),
+    totalAvailable: shared_1.BigIntStringSchema,
+    totalHeld: shared_1.BigIntStringSchema,
+    balances: zod_1.z.array(exports.BalanceItemResponseSchema),
+});

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

@@ -0,0 +1,11 @@
+/**
+ * Balance Status Enum
+ * See WALLET_API.md section 2.2
+ */
+export declare enum BalanceStatus {
+    ACTIVE = "ACTIVE",
+    DEPLETED = "DEPLETED",
+    EXPIRED = "EXPIRED",
+    CANCELLED = "CANCELLED",
+    SUSPENDED = "SUSPENDED"
+}

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

@@ -0,0 +1,15 @@
+"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";
+    BalanceStatus["DEPLETED"] = "DEPLETED";
+    BalanceStatus["EXPIRED"] = "EXPIRED";
+    BalanceStatus["CANCELLED"] = "CANCELLED";
+    BalanceStatus["SUSPENDED"] = "SUSPENDED";
+})(BalanceStatus || (exports.BalanceStatus = BalanceStatus = {}));

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

@@ -0,0 +1,10 @@
+/**
+ * Hold Status Enum
+ * See WALLET_API.md section 2.3
+ */
+export declare enum HoldStatus {
+    PENDING = "PENDING",
+    CONFIRMED = "CONFIRMED",
+    RELEASED = "RELEASED",
+    EXPIRED = "EXPIRED"
+}

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

@@ -0,0 +1,14 @@
+"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";
+    HoldStatus["CONFIRMED"] = "CONFIRMED";
+    HoldStatus["RELEASED"] = "RELEASED";
+    HoldStatus["EXPIRED"] = "EXPIRED";
+})(HoldStatus || (exports.HoldStatus = HoldStatus = {}));

package/build/v1/wallet/schemas/index.d.ts

@@ -0,0 +1,7 @@
+export { BalanceStatus } from './balance-status.enum';
+export { HoldStatus } from './hold-status.enum';
+export { TransactionType } from './transaction-type.enum';
+export { SourceType } from './source-type.enum';
+export { InitiatorType } from './initiator-type.enum';
+export { BalanceItemResponseSchema, BalanceSummaryResponseSchema, type BalanceItemResponse, type BalanceSummaryResponse, } from './balance-response.schema';
+export { MetadataSchema, validateMetadata, MAX_METADATA_SIZE, MAX_NESTING_DEPTH, MAX_METADATA_KEYS, type Metadata, } from './metadata.schema';

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

@@ -0,0 +1,25 @@
+"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.BalanceSummaryResponseSchema = exports.BalanceItemResponseSchema = exports.InitiatorType = exports.SourceType = exports.TransactionType = exports.HoldStatus = 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 hold_status_enum_1 = require("./hold-status.enum");
+Object.defineProperty(exports, "HoldStatus", { enumerable: true, get: function () { return hold_status_enum_1.HoldStatus; } });
+var transaction_type_enum_1 = require("./transaction-type.enum");
+Object.defineProperty(exports, "TransactionType", { enumerable: true, get: function () { return transaction_type_enum_1.TransactionType; } });
+var source_type_enum_1 = require("./source-type.enum");
+Object.defineProperty(exports, "SourceType", { enumerable: true, get: function () { return source_type_enum_1.SourceType; } });
+var initiator_type_enum_1 = require("./initiator-type.enum");
+Object.defineProperty(exports, "InitiatorType", { enumerable: true, get: function () { return initiator_type_enum_1.InitiatorType; } });
+// 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, "BalanceSummaryResponseSchema", { enumerable: true, get: function () { return balance_response_schema_1.BalanceSummaryResponseSchema; } });
+// 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; } });
+Object.defineProperty(exports, "MAX_METADATA_SIZE", { enumerable: true, get: function () { return metadata_schema_1.MAX_METADATA_SIZE; } });
+Object.defineProperty(exports, "MAX_NESTING_DEPTH", { enumerable: true, get: function () { return metadata_schema_1.MAX_NESTING_DEPTH; } });
+Object.defineProperty(exports, "MAX_METADATA_KEYS", { enumerable: true, get: function () { return metadata_schema_1.MAX_METADATA_KEYS; } });

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

@@ -0,0 +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

@@ -0,0 +1,16 @@
+"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 = {}));

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

@@ -0,0 +1,29 @@
+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;
+/**
+ * Metadata schema with all security validations
+ */
+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 metadata and return sanitized version or null
+ * Use this function in services before storing metadata
+ */
+export declare function validateMetadata(metadata: unknown): {
+    valid: true;
+    data: Record<string, unknown> | null;
+} | {
+    valid: false;
+    error: string;
+};

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

@@ -0,0 +1,105 @@
+"use strict";
+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 zod_1 = require("zod");
+/**
+ * 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;
+/**
+ * Forbidden keys that could be used for prototype pollution
+ */
+const FORBIDDEN_KEYS = ['__proto__', 'constructor', 'prototype'];
+/**
+ * Validate key names - alphanumeric, underscore, dash, starting with letter or underscore
+ */
+const SafeKeySchema = zod_1.z.string().regex(/^[a-zA-Z_][a-zA-Z0-9_-]{0,63}$/);
+/**
+ * Recursive schema for metadata values
+ */
+const MetadataValueSchema = zod_1.z.lazy(() => zod_1.z.union([
+    zod_1.z.string().max(1000),
+    zod_1.z.number(),
+    zod_1.z.boolean(),
+    zod_1.z.null(),
+    zod_1.z.array(MetadataValueSchema).max(50),
+    zod_1.z.record(SafeKeySchema, MetadataValueSchema),
+]));
+/**
+ * Check if object contains forbidden keys (prototype pollution protection)
+ * Note: Depth check is handled separately by getDepth(), so we just stop recursion here
+ */
+function hasForbiddenKeys(obj, depth = 0) {
+    if (depth > exports.MAX_NESTING_DEPTH)
+        return false; // Stop recursion, let getDepth() handle depth validation
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    if (Array.isArray(obj)) {
+        return obj.some((item) => hasForbiddenKeys(item, depth + 1));
+    }
+    for (const key of Object.keys(obj)) {
+        if (FORBIDDEN_KEYS.includes(key))
+            return true;
+        const value = obj[key];
+        if (hasForbiddenKeys(value, depth + 1))
+            return true;
+    }
+    return false;
+}
+/**
+ * Calculate nesting depth of an object
+ */
+function getDepth(obj, currentDepth = 0) {
+    if (currentDepth > exports.MAX_NESTING_DEPTH + 1)
+        return currentDepth;
+    if (typeof obj !== 'object' || obj === null)
+        return currentDepth;
+    if (Array.isArray(obj)) {
+        return Math.max(currentDepth, ...obj.map((item) => getDepth(item, currentDepth + 1)));
+    }
+    const depths = Object.values(obj).map((value) => getDepth(value, currentDepth + 1));
+    return Math.max(currentDepth, ...depths);
+}
+/**
+ * Metadata schema with all security validations
+ */
+exports.MetadataSchema = zod_1.z
+    .record(SafeKeySchema, MetadataValueSchema)
+    .refine((obj) => JSON.stringify(obj).length <= exports.MAX_METADATA_SIZE, {
+    message: `Metadata must be less than ${exports.MAX_METADATA_SIZE} bytes`,
+})
+    .refine((obj) => Object.keys(obj).length <= exports.MAX_METADATA_KEYS, {
+    message: `Metadata must have at most ${exports.MAX_METADATA_KEYS} keys`,
+})
+    .refine((obj) => !hasForbiddenKeys(obj), {
+    message: 'Metadata contains forbidden keys',
+})
+    .refine((obj) => getDepth(obj) <= exports.MAX_NESTING_DEPTH, {
+    message: `Metadata nesting depth must not exceed ${exports.MAX_NESTING_DEPTH}`,
+})
+    .optional()
+    .nullable();
+/**
+ * Validate metadata and return sanitized version or null
+ * Use this function in services before storing metadata
+ */
+function validateMetadata(metadata) {
+    var _a, _b;
+    if (metadata === undefined || metadata === null) {
+        return { valid: true, data: null };
+    }
+    const result = exports.MetadataSchema.safeParse(metadata);
+    if (!result.success) {
+        return { valid: false, error: (_b = (_a = result.error.issues[0]) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : 'Invalid metadata' };
+    }
+    return { valid: true, data: result.data };
+}

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

@@ -0,0 +1,13 @@
+/**
+ * Source Type Enum
+ * Indicates the origin of balance credit
+ * See WALLET_API.md section 2.2
+ */
+export declare enum SourceType {
+    PURCHASE = "purchase",
+    PROMO = "promo",
+    REFERRAL = "referral",
+    ADMIN = "admin",
+    SUBSCRIPTION = "subscription",
+    REFUND = "refund"
+}

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

@@ -0,0 +1,17 @@
+"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";
+    SourceType["PROMO"] = "promo";
+    SourceType["REFERRAL"] = "referral";
+    SourceType["ADMIN"] = "admin";
+    SourceType["SUBSCRIPTION"] = "subscription";
+    SourceType["REFUND"] = "refund";
+})(SourceType || (exports.SourceType = SourceType = {}));

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

@@ -0,0 +1,17 @@
+/**
+ * Transaction Type Enum
+ * See WALLET_API.md section 2.5
+ */
+export declare enum TransactionType {
+    CREDIT = "CREDIT",
+    DEBIT = "DEBIT",
+    HOLD_CREATE = "HOLD_CREATE",
+    HOLD_CONFIRM = "HOLD_CONFIRM",
+    HOLD_RELEASE = "HOLD_RELEASE",
+    HOLD_EXPIRE = "HOLD_EXPIRE",
+    BALANCE_EXPIRE = "BALANCE_EXPIRE",
+    REFUND = "REFUND",
+    ADJUSTMENT = "ADJUSTMENT",
+    TRANSFER_OUT = "TRANSFER_OUT",
+    TRANSFER_IN = "TRANSFER_IN"
+}

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionType = void 0;
+/**
+ * Transaction Type Enum
+ * See WALLET_API.md section 2.5
+ */
+var TransactionType;
+(function (TransactionType) {
+    TransactionType["CREDIT"] = "CREDIT";
+    TransactionType["DEBIT"] = "DEBIT";
+    TransactionType["HOLD_CREATE"] = "HOLD_CREATE";
+    TransactionType["HOLD_CONFIRM"] = "HOLD_CONFIRM";
+    TransactionType["HOLD_RELEASE"] = "HOLD_RELEASE";
+    TransactionType["HOLD_EXPIRE"] = "HOLD_EXPIRE";
+    TransactionType["BALANCE_EXPIRE"] = "BALANCE_EXPIRE";
+    TransactionType["REFUND"] = "REFUND";
+    TransactionType["ADJUSTMENT"] = "ADJUSTMENT";
+    TransactionType["TRANSFER_OUT"] = "TRANSFER_OUT";
+    TransactionType["TRANSFER_IN"] = "TRANSFER_IN";
+})(TransactionType || (exports.TransactionType = TransactionType = {}));

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

@@ -0,0 +1,37 @@
+import { ErrorMetadata } from '../../shared';
+/**
+ * Wallet Error Codes
+ * See WALLET_API.md section 7 for error specifications
+ */
+export declare enum WalletErrorCode {
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    BALANCE_NOT_FOUND = "BALANCE_NOT_FOUND",
+    BALANCE_TYPE_NOT_FOUND = "BALANCE_TYPE_NOT_FOUND",
+    BALANCE_NOT_ACTIVE = "BALANCE_NOT_ACTIVE",
+    BALANCE_HAS_PENDING_HOLD = "BALANCE_HAS_PENDING_HOLD",
+    HOLD_NOT_FOUND = "HOLD_NOT_FOUND",
+    HOLD_ALREADY_PROCESSED = "HOLD_ALREADY_PROCESSED",
+    HOLD_NOT_PENDING = "HOLD_NOT_PENDING",
+    HOLD_EXPIRED = "HOLD_EXPIRED",
+    DUPLICATE_HOLD = "DUPLICATE_HOLD",
+    INSUFFICIENT_AVAILABLE_BALANCE = "INSUFFICIENT_AVAILABLE_BALANCE",
+    BALANCE_STATE_CHANGED = "BALANCE_STATE_CHANGED",
+    INVALID_AMOUNT = "INVALID_AMOUNT",
+    AMOUNT_OVERFLOW = "AMOUNT_OVERFLOW",
+    INVALID_TTL = "INVALID_TTL",
+    INVALID_METADATA = "INVALID_METADATA",
+    INVALID_INITIATOR_TYPE = "INVALID_INITIATOR_TYPE",
+    INVALID_BALANCE_STATUS = "INVALID_BALANCE_STATUS",
+    INVALID_HOLD_STATUS = "INVALID_HOLD_STATUS",
+    INVALID_TRANSACTION_TYPE = "INVALID_TRANSACTION_TYPE",
+    INVALID_SOURCE_TYPE = "INVALID_SOURCE_TYPE",
+    INVALID_VERSION = "INVALID_VERSION",
+    INVALID_OPERATION_TYPE = "INVALID_OPERATION_TYPE",
+    INVALID_OPERATION_ID = "INVALID_OPERATION_ID",
+    INVALID_HOLD_ID = "INVALID_HOLD_ID",
+    INVALID_BALANCE_ID = "INVALID_BALANCE_ID",
+    DATA_INTEGRITY_ERROR = "DATA_INTEGRITY_ERROR",
+    CONCURRENT_MODIFICATION = "CONCURRENT_MODIFICATION",
+    DUPLICATE_IDEMPOTENCY_KEY = "DUPLICATE_IDEMPOTENCY_KEY"
+}
+export declare const WALLET_ERRORS: Record<WalletErrorCode, ErrorMetadata>;

package/build/v1/wallet/wallet.errors.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WALLET_ERRORS = exports.WalletErrorCode = void 0;
+/**
+ * Wallet Error Codes
+ * See WALLET_API.md section 7 for error specifications
+ */
+var WalletErrorCode;
+(function (WalletErrorCode) {
+    // Balance errors
+    WalletErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
+    WalletErrorCode["BALANCE_NOT_FOUND"] = "BALANCE_NOT_FOUND";
+    WalletErrorCode["BALANCE_TYPE_NOT_FOUND"] = "BALANCE_TYPE_NOT_FOUND";
+    WalletErrorCode["BALANCE_NOT_ACTIVE"] = "BALANCE_NOT_ACTIVE";
+    WalletErrorCode["BALANCE_HAS_PENDING_HOLD"] = "BALANCE_HAS_PENDING_HOLD";
+    // Hold errors
+    WalletErrorCode["HOLD_NOT_FOUND"] = "HOLD_NOT_FOUND";
+    WalletErrorCode["HOLD_ALREADY_PROCESSED"] = "HOLD_ALREADY_PROCESSED";
+    WalletErrorCode["HOLD_NOT_PENDING"] = "HOLD_NOT_PENDING";
+    WalletErrorCode["HOLD_EXPIRED"] = "HOLD_EXPIRED";
+    WalletErrorCode["DUPLICATE_HOLD"] = "DUPLICATE_HOLD";
+    // Available balance errors
+    WalletErrorCode["INSUFFICIENT_AVAILABLE_BALANCE"] = "INSUFFICIENT_AVAILABLE_BALANCE";
+    WalletErrorCode["BALANCE_STATE_CHANGED"] = "BALANCE_STATE_CHANGED";
+    // Validation errors
+    WalletErrorCode["INVALID_AMOUNT"] = "INVALID_AMOUNT";
+    WalletErrorCode["AMOUNT_OVERFLOW"] = "AMOUNT_OVERFLOW";
+    WalletErrorCode["INVALID_TTL"] = "INVALID_TTL";
+    WalletErrorCode["INVALID_METADATA"] = "INVALID_METADATA";
+    WalletErrorCode["INVALID_INITIATOR_TYPE"] = "INVALID_INITIATOR_TYPE";
+    WalletErrorCode["INVALID_BALANCE_STATUS"] = "INVALID_BALANCE_STATUS";
+    WalletErrorCode["INVALID_HOLD_STATUS"] = "INVALID_HOLD_STATUS";
+    WalletErrorCode["INVALID_TRANSACTION_TYPE"] = "INVALID_TRANSACTION_TYPE";
+    WalletErrorCode["INVALID_SOURCE_TYPE"] = "INVALID_SOURCE_TYPE";
+    WalletErrorCode["INVALID_VERSION"] = "INVALID_VERSION";
+    WalletErrorCode["INVALID_OPERATION_TYPE"] = "INVALID_OPERATION_TYPE";
+    WalletErrorCode["INVALID_OPERATION_ID"] = "INVALID_OPERATION_ID";
+    WalletErrorCode["INVALID_HOLD_ID"] = "INVALID_HOLD_ID";
+    WalletErrorCode["INVALID_BALANCE_ID"] = "INVALID_BALANCE_ID";
+    // Data integrity errors
+    WalletErrorCode["DATA_INTEGRITY_ERROR"] = "DATA_INTEGRITY_ERROR";
+    // Concurrency errors
+    WalletErrorCode["CONCURRENT_MODIFICATION"] = "CONCURRENT_MODIFICATION";
+    // Idempotency
+    WalletErrorCode["DUPLICATE_IDEMPOTENCY_KEY"] = "DUPLICATE_IDEMPOTENCY_KEY";
+})(WalletErrorCode || (exports.WalletErrorCode = WalletErrorCode = {}));
+exports.WALLET_ERRORS = {
+    // Balance errors - 4xx
+    [WalletErrorCode.INSUFFICIENT_BALANCE]: {
+        code: WalletErrorCode.INSUFFICIENT_BALANCE,
+        statusCode: 402,
+    },
+    [WalletErrorCode.BALANCE_NOT_FOUND]: {
+        code: WalletErrorCode.BALANCE_NOT_FOUND,
+        statusCode: 404,
+    },
+    [WalletErrorCode.BALANCE_TYPE_NOT_FOUND]: {
+        code: WalletErrorCode.BALANCE_TYPE_NOT_FOUND,
+        statusCode: 400,
+    },
+    [WalletErrorCode.BALANCE_NOT_ACTIVE]: {
+        code: WalletErrorCode.BALANCE_NOT_ACTIVE,
+        statusCode: 409,
+    },
+    [WalletErrorCode.BALANCE_HAS_PENDING_HOLD]: {
+        code: WalletErrorCode.BALANCE_HAS_PENDING_HOLD,
+        statusCode: 409,
+    },
+    // Hold errors
+    [WalletErrorCode.HOLD_NOT_FOUND]: {
+        code: WalletErrorCode.HOLD_NOT_FOUND,
+        statusCode: 404,
+    },
+    [WalletErrorCode.HOLD_ALREADY_PROCESSED]: {
+        code: WalletErrorCode.HOLD_ALREADY_PROCESSED,
+        statusCode: 409,
+    },
+    [WalletErrorCode.HOLD_NOT_PENDING]: {
+        code: WalletErrorCode.HOLD_NOT_PENDING,
+        statusCode: 409,
+    },
+    [WalletErrorCode.HOLD_EXPIRED]: {
+        code: WalletErrorCode.HOLD_EXPIRED,
+        statusCode: 410,
+    },
+    [WalletErrorCode.DUPLICATE_HOLD]: {
+        code: WalletErrorCode.DUPLICATE_HOLD,
+        statusCode: 409,
+    },
+    // Available balance errors
+    [WalletErrorCode.INSUFFICIENT_AVAILABLE_BALANCE]: {
+        code: WalletErrorCode.INSUFFICIENT_AVAILABLE_BALANCE,
+        statusCode: 402,
+    },
+    [WalletErrorCode.BALANCE_STATE_CHANGED]: {
+        code: WalletErrorCode.BALANCE_STATE_CHANGED,
+        statusCode: 409,
+    },
+    // Validation errors
+    [WalletErrorCode.INVALID_AMOUNT]: {
+        code: WalletErrorCode.INVALID_AMOUNT,
+        statusCode: 400,
+    },
+    [WalletErrorCode.AMOUNT_OVERFLOW]: {
+        code: WalletErrorCode.AMOUNT_OVERFLOW,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_TTL]: {
+        code: WalletErrorCode.INVALID_TTL,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_METADATA]: {
+        code: WalletErrorCode.INVALID_METADATA,
+        statusCode: 400,
+    },
+    // Concurrency errors
+    [WalletErrorCode.CONCURRENT_MODIFICATION]: {
+        code: WalletErrorCode.CONCURRENT_MODIFICATION,
+        statusCode: 409,
+    },
+    // Idempotency
+    [WalletErrorCode.DUPLICATE_IDEMPOTENCY_KEY]: {
+        code: WalletErrorCode.DUPLICATE_IDEMPOTENCY_KEY,
+        statusCode: 409,
+    },
+    // Value Object validation errors
+    [WalletErrorCode.INVALID_INITIATOR_TYPE]: {
+        code: WalletErrorCode.INVALID_INITIATOR_TYPE,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_BALANCE_STATUS]: {
+        code: WalletErrorCode.INVALID_BALANCE_STATUS,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_HOLD_STATUS]: {
+        code: WalletErrorCode.INVALID_HOLD_STATUS,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_TRANSACTION_TYPE]: {
+        code: WalletErrorCode.INVALID_TRANSACTION_TYPE,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_SOURCE_TYPE]: {
+        code: WalletErrorCode.INVALID_SOURCE_TYPE,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_VERSION]: {
+        code: WalletErrorCode.INVALID_VERSION,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_OPERATION_TYPE]: {
+        code: WalletErrorCode.INVALID_OPERATION_TYPE,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_OPERATION_ID]: {
+        code: WalletErrorCode.INVALID_OPERATION_ID,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_HOLD_ID]: {
+        code: WalletErrorCode.INVALID_HOLD_ID,
+        statusCode: 400,
+    },
+    [WalletErrorCode.INVALID_BALANCE_ID]: {
+        code: WalletErrorCode.INVALID_BALANCE_ID,
+        statusCode: 400,
+    },
+    [WalletErrorCode.DATA_INTEGRITY_ERROR]: {
+        code: WalletErrorCode.DATA_INTEGRITY_ERROR,
+        statusCode: 500,
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veruna/api-contracts",
-  "version": "1.0.40",
+  "version": "1.0.41",
   "description": "API contracts for Veruna project - Zod schemas, types, and paths",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",