@waiaas/core 2.11.0-rc.8 → 2.12.0-rc

package/dist/utils/index.js

@@ -1,3 +1,9 @@
+// v32.4 Chain constants SSoT (SSOT-01)
+export { NATIVE_DECIMALS, NATIVE_SYMBOLS, nativeDecimals, nativeSymbol } from './chain-constants.js';
+// v32.4 Sleep utility SSoT (SSOT-02)
+export { sleep } from './sleep.js';
+// v32.4 Safe JSON parse with Zod validation (ZOD-01)
+export { safeJsonParse } from './safe-json-parse.js';
 // v1.5.3 Currency formatting utilities
 export { formatDisplayCurrency, formatRatePreview } from './format-currency.js';
 // v1.7 Blockchain amount formatting utilities (NOTE-01)

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,wDAAwD;AACxD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/D,mCAAmC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErG,qCAAqC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,qDAAqD;AACrD,OAAO,EAAE,aAAa,EAAqD,MAAM,sBAAsB,CAAC;AAExG,uCAAuC;AACvC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,wDAAwD;AACxD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/D,mCAAmC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/utils/safe-json-parse.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Safe JSON parse utility with Zod schema validation.
+ *
+ * Single source of truth for parsing JSON strings with type-safe validation.
+ * Used by policy engine, notification service, and daemon to safely parse
+ * JSON data from database or external sources.
+ *
+ * @since v32.4 (Phase 427, ZOD-01)
+ */
+import type { z, ZodIssue } from 'zod';
+/**
+ * Error detail from safeJsonParse.
+ *
+ * - `json_parse`: Input is not valid JSON (or null/undefined)
+ * - `validation`: JSON parsed but failed Zod schema validation
+ */
+export interface SafeJsonParseError {
+    type: 'json_parse' | 'validation';
+    message: string;
+    issues?: ZodIssue[];
+}
+/**
+ * Discriminated union result type for safeJsonParse.
+ */
+export type SafeJsonParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: SafeJsonParseError;
+};
+/**
+ * Parse a JSON string and validate against a Zod schema.
+ *
+ * Never throws -- all errors are captured in the result.
+ *
+ * @param json - JSON string to parse (gracefully handles null/undefined)
+ * @param schema - Zod schema to validate the parsed data against
+ * @returns Discriminated union with parsed data or structured error
+ *
+ * @example
+ * ```ts
+ * const result = safeJsonParse(rawJson, SpendingLimitRulesSchema);
+ * if (result.success) {
+ *   // result.data is typed as SpendingLimitRules
+ * } else {
+ *   // result.error.type is 'json_parse' | 'validation'
+ * }
+ * ```
+ */
+export declare function safeJsonParse<T>(json: string, schema: z.ZodType<T>): SafeJsonParseResult<T>;
+//# sourceMappingURL=safe-json-parse.d.ts.map

package/dist/utils/safe-json-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-json-parse.d.ts","sourceRoot":"","sources":["../../src/utils/safe-json-parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAC7B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAElD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,mBAAmB,CAAC,CAAC,CAAC,CAwCxB"}

package/dist/utils/safe-json-parse.js

@@ -0,0 +1,68 @@
+/**
+ * Safe JSON parse utility with Zod schema validation.
+ *
+ * Single source of truth for parsing JSON strings with type-safe validation.
+ * Used by policy engine, notification service, and daemon to safely parse
+ * JSON data from database or external sources.
+ *
+ * @since v32.4 (Phase 427, ZOD-01)
+ */
+/**
+ * Parse a JSON string and validate against a Zod schema.
+ *
+ * Never throws -- all errors are captured in the result.
+ *
+ * @param json - JSON string to parse (gracefully handles null/undefined)
+ * @param schema - Zod schema to validate the parsed data against
+ * @returns Discriminated union with parsed data or structured error
+ *
+ * @example
+ * ```ts
+ * const result = safeJsonParse(rawJson, SpendingLimitRulesSchema);
+ * if (result.success) {
+ *   // result.data is typed as SpendingLimitRules
+ * } else {
+ *   // result.error.type is 'json_parse' | 'validation'
+ * }
+ * ```
+ */
+export function safeJsonParse(json, schema) {
+    // Handle null/undefined gracefully
+    if (json == null) {
+        return {
+            success: false,
+            error: {
+                type: 'json_parse',
+                message: `Cannot parse ${json === null ? 'null' : 'undefined'} as JSON`,
+            },
+        };
+    }
+    // Step 1: Parse JSON
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: {
+                type: 'json_parse',
+                message: err instanceof Error ? err.message : 'Invalid JSON',
+            },
+        };
+    }
+    // Step 2: Validate against schema
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        return {
+            success: false,
+            error: {
+                type: 'validation',
+                message: result.error.issues.map((i) => i.message).join('; '),
+                issues: result.error.issues,
+            },
+        };
+    }
+    return { success: true, data: result.data };
+}
+//# sourceMappingURL=safe-json-parse.js.map

package/dist/utils/safe-json-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-json-parse.js","sourceRoot":"","sources":["../../src/utils/safe-json-parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,MAAoB;IAEpB,mCAAmC;IACnC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,gBAAgB,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,UAAU;aACxE;SACF,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc;aAC7D;SACF,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC7D,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;aAC5B;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC"}

package/dist/utils/sleep.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sleep utility -- single source of truth.
+ * All packages import from @waiaas/core instead of defining locally.
+ *
+ * @since v32.4 (Phase 427, SSOT-02)
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/utils/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils/sleep.js

@@ -0,0 +1,10 @@
+/**
+ * Sleep utility -- single source of truth.
+ * All packages import from @waiaas/core instead of defining locally.
+ *
+ * @since v32.4 (Phase 427, SSOT-02)
+ */
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sleep.js.map

package/dist/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waiaas/core",
-  "version": "2.11.0-rc.8",
+  "version": "2.12.0-rc",
   "description": "WAIaaS core types, schemas, and shared utilities",
   "license": "MIT",
   "type": "module",
@@ -35,7 +35,7 @@
     "@x402/core": "^2.3.1",
     "viem": "^2.21.0",
     "zod": "^3.24.0",
-    "@waiaas/shared": "2.11.0-rc.8"
+    "@waiaas/shared": "2.12.0-rc"
   },
   "devDependencies": {
     "@types/node": "^25.2.3"