@veruna/api-contracts 1.0.39 → 1.0.41

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

@@ -4,6 +4,7 @@ exports.UpdatePostRequestSchema = void 0;
 const zod_1 = require("zod");
 const regex_1 = require("../../../shared/regex");
 const blog_post_status_enum_1 = require("./blog-post-status.enum");
+const blog_post_mark_enum_1 = require("./blog-post-mark.enum");
 exports.UpdatePostRequestSchema = zod_1.z
     .object({
     alias: zod_1.z
@@ -14,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(),
@@ -22,15 +24,16 @@ exports.UpdatePostRequestSchema = zod_1.z
     categoryIds: zod_1.z.array(zod_1.z.string().regex(regex_1.UUID_REGEX)).min(1).optional(),
     status: zod_1.z.nativeEnum(blog_post_status_enum_1.BlogPostStatus).optional(),
     pageId: zod_1.z.string().regex(regex_1.UUID_REGEX).nullable().optional(),
-    aiWidgetEnabled: zod_1.z.boolean().optional(),
+    marks: zod_1.z.array(zod_1.z.nativeEnum(blog_post_mark_enum_1.BlogPostMark)).optional(),
     aiWidgetPlaceholder: zod_1.z.string().max(500).nullable().optional(),
     aiWidgetPrompt: zod_1.z.string().max(2000).nullable().optional(),
 })
     .refine((data) => {
-    if (data.aiWidgetEnabled === true) {
+    var _a;
+    if ((_a = data.marks) === null || _a === void 0 ? void 0 : _a.includes(blog_post_mark_enum_1.BlogPostMark.AI_WIDGET)) {
         return data.pageId && data.aiWidgetPlaceholder && data.aiWidgetPrompt;
     }
     return true;
 }, {
-    message: 'pageId, aiWidgetPlaceholder and aiWidgetPrompt are required when aiWidgetEnabled is true',
+    message: 'pageId, aiWidgetPlaceholder and aiWidgetPrompt are required when AI_WIDGET mark is present',
 });

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>;