@outfitter/contracts 0.4.2 → 0.5.0

package/dist/{shared/@outfitter/contracts-5k6q4n48.js → internal/error-serialization.js}

@@ -13,15 +13,9 @@ import {
   RateLimitError,
   TimeoutError,
   ValidationError
-} from "./contracts-phjhz5q3.js";
-import {
-  DEFAULT_PATTERNS,
-  DEFAULT_SENSITIVE_KEYS,
-  createRedactor
-} from "./contracts-s15x2rs4.js";
+} from "../shared/@outfitter/contracts-vhr2ep6b.js";
 
-// packages/contracts/src/serialization.ts
-import { Result } from "better-result";
+// packages/contracts/src/internal/error-serialization.ts
 var errorRegistry = {
   ValidationError,
   AmbiguousError,
@@ -45,6 +39,9 @@ function extractContext(error) {
   switch (error._tag) {
     case "ValidationError": {
       const ve = error;
+      if (ve.context !== undefined) {
+        Object.assign(context, ve.context);
+      }
       if (ve.field !== undefined) {
         context["field"] = ve.field;
       }
@@ -90,6 +87,9 @@ function extractContext(error) {
     }
     case "AmbiguousError": {
       const amb = error;
+      if (amb.context !== undefined) {
+        Object.assign(context, amb.context);
+      }
       context["candidates"] = amb.candidates;
       break;
     }
@@ -110,9 +110,9 @@ function extractContext(error) {
   }
   return Object.keys(context).length > 0 ? context : undefined;
 }
-function serializeError(error, options) {
-  const isProduction = process.env["NODE_ENV"] === "production";
-  const includeStack = options?.includeStack ?? !isProduction;
+function serializeError(error, options, isProduction) {
+  const production = isProduction ?? process.env["NODE_ENV"] === "production";
+  const includeStack = options?.includeStack ?? !production;
   const context = extractContext(error);
   const serialized = {
     _tag: error._tag,
@@ -151,6 +151,10 @@ function deserializeError(data) {
       if (field !== undefined) {
         props.field = field;
       }
+      const contextWithoutField = Object.fromEntries(Object.entries(context).filter(([key]) => key !== "field"));
+      if (Object.keys(contextWithoutField).length > 0) {
+        props.context = contextWithoutField;
+      }
       return new ValidationError(props);
     }
     case "NotFoundError": {
@@ -239,11 +243,17 @@ function deserializeError(data) {
       }
       return new AuthError(props);
     }
-    case "AmbiguousError":
-      return new AmbiguousError({
+    case "AmbiguousError": {
+      const props = {
         message: data.message,
         candidates: context["candidates"] ?? []
-      });
+      };
+      const contextWithoutCandidates = Object.fromEntries(Object.entries(context).filter(([key]) => key !== "candidates"));
+      if (Object.keys(contextWithoutCandidates).length > 0) {
+        props.context = contextWithoutCandidates;
+      }
+      return new AmbiguousError(props);
+    }
     case "AssertionError":
       return new AssertionError({
         message: data.message
@@ -263,56 +273,7 @@ function deserializeError(data) {
     }
   }
 }
-function safeStringify(value, space) {
-  const seen = new WeakSet;
-  const redactor = createRedactor({
-    patterns: [...DEFAULT_PATTERNS],
-    keys: [...DEFAULT_SENSITIVE_KEYS]
-  });
-  const replacer = (key, val) => {
-    if (typeof val === "bigint") {
-      return val.toString();
-    }
-    if (typeof val === "object" && val !== null) {
-      if (seen.has(val)) {
-        return "[Circular]";
-      }
-      seen.add(val);
-    }
-    if (key !== "" && redactor.isSensitiveKey(key) && val !== null && val !== undefined) {
-      return "[REDACTED]";
-    }
-    if (typeof val === "string") {
-      return redactor.redactString(val);
-    }
-    return val;
-  };
-  return JSON.stringify(value, replacer, space);
-}
-function safeParse(json, schema) {
-  let parsed;
-  try {
-    parsed = JSON.parse(json);
-  } catch (err) {
-    const errorMessage = err instanceof Error ? err.message : "Unknown parse error";
-    return Result.err(new ValidationError({
-      message: `JSON parse error: ${errorMessage}`
-    }));
-  }
-  if (schema === undefined) {
-    return Result.ok(parsed);
-  }
-  const parseResult = schema.safeParse(parsed);
-  if (parseResult.success) {
-    return Result.ok(parseResult.data);
-  }
-  const issues = parseResult.error.issues.map((issue) => {
-    const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
-    return `${path}: ${issue.message}`;
-  }).join("; ");
-  return Result.err(new ValidationError({
-    message: `Schema validation failed: ${issues}`
-  }));
-}
-
-export { serializeError, deserializeError, safeStringify, safeParse };
+export {
+  serializeError,
+  deserializeError
+};

package/dist/internal/error-taxonomy.d.ts

@@ -0,0 +1,2 @@
+import { ERROR_CODES, ErrorCategory, ErrorCategoryMeta, ErrorCode, KitErrorProps, SerializedError, errorCategoryMeta, exitCodeMap, getExitCode, getStatusCode, jsonRpcCodeMap, retryableMap, statusCodeMap } from "../shared/@outfitter/contracts-njb2art4.js";
+export { statusCodeMap, retryableMap, jsonRpcCodeMap, getStatusCode, getExitCode, exitCodeMap, errorCategoryMeta, SerializedError, KitErrorProps, ErrorCode, ErrorCategoryMeta, ErrorCategory, ERROR_CODES };

package/dist/internal/error-taxonomy.js

@@ -0,0 +1,21 @@
+// @bun
+import {
+  ERROR_CODES,
+  errorCategoryMeta,
+  exitCodeMap,
+  getExitCode,
+  getStatusCode,
+  jsonRpcCodeMap,
+  retryableMap,
+  statusCodeMap
+} from "../shared/@outfitter/contracts-sawwfgb5.js";
+export {
+  statusCodeMap,
+  retryableMap,
+  jsonRpcCodeMap,
+  getStatusCode,
+  getExitCode,
+  exitCodeMap,
+  errorCategoryMeta,
+  ERROR_CODES
+};

package/dist/internal/error-validation.d.ts

@@ -0,0 +1,3 @@
+import { AlreadyExistsError, AmbiguousError, AssertionError, ConflictError, NotFoundError, ValidationError } from "../shared/@outfitter/contracts-mehpmvwp.js";
+import "../shared/@outfitter/contracts-qpbv29bg.js";
+export { ValidationError, NotFoundError, ConflictError, AssertionError, AmbiguousError, AlreadyExistsError };

package/dist/internal/error-validation.js

@@ -0,0 +1,121 @@
+// @bun
+import {
+  AlreadyExistsErrorBase,
+  AmbiguousErrorBase,
+  AssertionErrorBase,
+  ConflictErrorBase,
+  NotFoundErrorBase,
+  ValidationErrorBase
+} from "../shared/@outfitter/contracts-jtn6b927.js";
+import {
+  getExitCode,
+  getStatusCode
+} from "../shared/@outfitter/contracts-sawwfgb5.js";
+
+// packages/contracts/src/internal/error-validation.ts
+class ValidationError extends ValidationErrorBase {
+  category = "validation";
+  static create(field, reason, context) {
+    return new ValidationError({
+      message: `${field}: ${reason}`,
+      field,
+      ...context != null && { context }
+    });
+  }
+  static fromMessage(message, context) {
+    return new ValidationError({
+      message,
+      ...context != null && { context }
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class AmbiguousError extends AmbiguousErrorBase {
+  category = "validation";
+  static create(what, candidates, context) {
+    return new AmbiguousError({
+      message: `Ambiguous ${what}: ${candidates.length} matches found`,
+      candidates,
+      ...context != null && { context }
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class AssertionError extends AssertionErrorBase {
+  category = "internal";
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class NotFoundError extends NotFoundErrorBase {
+  category = "not_found";
+  static create(resourceType, resourceId, context) {
+    return new NotFoundError({
+      message: `${resourceType} not found: ${resourceId}`,
+      resourceType,
+      resourceId,
+      ...context != null && { context }
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class AlreadyExistsError extends AlreadyExistsErrorBase {
+  category = "conflict";
+  static create(resourceType, resourceId, context) {
+    return new AlreadyExistsError({
+      message: `${resourceType} already exists: ${resourceId}`,
+      resourceType,
+      resourceId,
+      ...context != null && { context }
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class ConflictError extends ConflictErrorBase {
+  category = "conflict";
+  static create(message, context) {
+    return new ConflictError({ message, ...context != null && { context } });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+export {
+  ValidationError,
+  NotFoundError,
+  ConflictError,
+  AssertionError,
+  AmbiguousError,
+  AlreadyExistsError
+};

package/dist/internal/safe-json.d.ts

@@ -0,0 +1,7 @@
+import { safeParse, safeStringify } from "../shared/@outfitter/contracts-1zzcpfyg.js";
+import "../shared/@outfitter/contracts-7a0xmwbg.js";
+import "../shared/@outfitter/contracts-735ecmbq.js";
+import "../shared/@outfitter/contracts-mehpmvwp.js";
+import "../shared/@outfitter/contracts-qpbv29bg.js";
+import "../shared/@outfitter/contracts-njb2art4.js";
+export { safeStringify, safeParse };

package/dist/internal/safe-json.js

@@ -0,0 +1,66 @@
+// @bun
+import {
+  DEFAULT_PATTERNS,
+  DEFAULT_SENSITIVE_KEYS,
+  createRedactor
+} from "../shared/@outfitter/contracts-s15x2rs4.js";
+import {
+  formatZodIssues
+} from "../shared/@outfitter/contracts-hgh47193.js";
+import {
+  ValidationError
+} from "../shared/@outfitter/contracts-vhr2ep6b.js";
+
+// packages/contracts/src/internal/safe-json.ts
+import { Result } from "better-result";
+var defaultRedactor = createRedactor({
+  patterns: [...DEFAULT_PATTERNS],
+  keys: [...DEFAULT_SENSITIVE_KEYS]
+});
+function safeStringify(value, space) {
+  const seen = new WeakSet;
+  const replacer = (key, val) => {
+    if (typeof val === "bigint") {
+      return val.toString();
+    }
+    if (typeof val === "object" && val !== null) {
+      if (seen.has(val)) {
+        return "[Circular]";
+      }
+      seen.add(val);
+    }
+    if (key !== "" && defaultRedactor.isSensitiveKey(key) && val !== null && val !== undefined) {
+      return "[REDACTED]";
+    }
+    if (typeof val === "string") {
+      return defaultRedactor.redactString(val);
+    }
+    return val;
+  };
+  return JSON.stringify(value, replacer, space);
+}
+function safeParse(json, schema) {
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch (err) {
+    const errorMessage = err instanceof Error ? err.message : "Unknown parse error";
+    return Result.err(new ValidationError({
+      message: `JSON parse error: ${errorMessage}`
+    }));
+  }
+  if (schema === undefined) {
+    return Result.ok(parsed);
+  }
+  const parseResult = schema.safeParse(parsed);
+  if (parseResult.success) {
+    return Result.ok(parseResult.data);
+  }
+  return Result.err(new ValidationError({
+    message: `Schema validation failed: ${formatZodIssues(parseResult.error.issues)}`
+  }));
+}
+export {
+  safeStringify,
+  safeParse
+};

package/dist/internal/schema-converters.d.ts

@@ -0,0 +1,26 @@
+import { JsonSchema } from "../shared/@outfitter/contracts-w7nvcwrp.js";
+import { z } from "zod";
+/**
+* Converter function type for the main dispatch function.
+*
+* This is injected to avoid circular dependencies between the converters
+* and the dispatcher in schema.ts.
+*/
+type ZodTypeConverter = (schema: z.ZodType<unknown>) => JsonSchema;
+/**
+* Convert Zod array schema.
+*/
+declare function convertArray(def: any, convertZodType: ZodTypeConverter): JsonSchema;
+/**
+* Check if a Zod field is optional by unwrapping wrapper types.
+*
+* This handles cases where optional fields are wrapped in ZodEffects
+* (refinements, transforms) or ZodPipeline, which would otherwise
+* incorrectly appear as required.
+*/
+declare function isFieldOptional(fieldDef: any): boolean;
+/**
+* Convert Zod object schema.
+*/
+declare function convertObject(def: any, convertZodType: ZodTypeConverter): JsonSchema;
+export { isFieldOptional, convertObject, convertArray, ZodTypeConverter };

package/dist/internal/schema-converters.js

@@ -0,0 +1,12 @@
+// @bun
+import {
+  convertArray,
+  convertObject,
+  isFieldOptional
+} from "../shared/@outfitter/contracts-hrepwwne.js";
+import"../shared/@outfitter/contracts-jyhqr766.js";
+export {
+  isFieldOptional,
+  convertObject,
+  convertArray
+};

package/dist/internal/schema-primitives.d.ts

@@ -0,0 +1,10 @@
+import { JsonSchema } from "../shared/@outfitter/contracts-w7nvcwrp.js";
+/**
+* Convert Zod string schema with checks.
+*/
+declare function convertString(def: any): JsonSchema;
+/**
+* Convert Zod number schema with checks.
+*/
+declare function convertNumber(def: any): JsonSchema;
+export { convertString, convertNumber };

package/dist/internal/schema-primitives.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  convertNumber,
+  convertString
+} from "../shared/@outfitter/contracts-3re9d4bp.js";
+export {
+  convertString,
+  convertNumber
+};

package/dist/internal/schema-types.d.ts

@@ -0,0 +1,2 @@
+import { JsonSchema, getDef, getDescription } from "../shared/@outfitter/contracts-w7nvcwrp.js";
+export { getDescription, getDef, JsonSchema };

package/dist/internal/schema-types.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  getDef,
+  getDescription
+} from "../shared/@outfitter/contracts-jyhqr766.js";
+export {
+  getDescription,
+  getDef
+};

package/dist/recovery.d.ts

@@ -1,3 +1,7 @@
-import { BackoffOptions, getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./shared/@outfitter/contracts-k71jqd1m.js";
-import "./shared/@outfitter/contracts-3gswmhb1.js";
+import { BackoffOptions, getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./shared/@outfitter/contracts-10p5q75w.js";
+import "./shared/@outfitter/contracts-7a0xmwbg.js";
+import "./shared/@outfitter/contracts-735ecmbq.js";
+import "./shared/@outfitter/contracts-mehpmvwp.js";
+import "./shared/@outfitter/contracts-qpbv29bg.js";
+import "./shared/@outfitter/contracts-njb2art4.js";
 export { shouldRetry, isRetryable, isRecoverable, getBackoffDelay, BackoffOptions };

package/dist/resilience.d.ts

@@ -1,3 +1,7 @@
-import { RetryOptions, TimeoutOptions, retry, withTimeout } from "./shared/@outfitter/contracts-95cc3y06.js";
-import "./shared/@outfitter/contracts-3gswmhb1.js";
+import { RetryOptions, TimeoutOptions, retry, withTimeout } from "./shared/@outfitter/contracts-mt027fqj.js";
+import "./shared/@outfitter/contracts-7a0xmwbg.js";
+import "./shared/@outfitter/contracts-735ecmbq.js";
+import "./shared/@outfitter/contracts-mehpmvwp.js";
+import "./shared/@outfitter/contracts-qpbv29bg.js";
+import "./shared/@outfitter/contracts-njb2art4.js";
 export { withTimeout, retry, TimeoutOptions, RetryOptions };

package/dist/resilience.js

@@ -1,7 +1,8 @@
 // @bun
 import {
+  InternalError,
   TimeoutError
-} from "./shared/@outfitter/contracts-phjhz5q3.js";
+} from "./shared/@outfitter/contracts-vhr2ep6b.js";
 
 // packages/contracts/src/resilience.ts
 import { Result } from "better-result";
@@ -22,6 +23,9 @@ function sleep(ms) {
 }
 async function retry(fn, options) {
   const maxAttempts = options?.maxAttempts ?? 3;
+  if (!(maxAttempts >= 1)) {
+    return Result.err(InternalError.create("maxAttempts must be >= 1", { maxAttempts }));
+  }
   const initialDelayMs = options?.initialDelayMs ?? 1000;
   const maxDelayMs = options?.maxDelayMs ?? 30000;
   const backoffMultiplier = options?.backoffMultiplier ?? 2;
@@ -54,7 +58,7 @@ async function retry(fn, options) {
     }
     await sleep(delayMs);
   }
-  throw new Error("Unexpected: retry loop completed without returning a result");
+  return Result.err(InternalError.create("Unexpected: retry loop completed without returning a result"));
 }
 async function withTimeout(fn, options) {
   const { timeoutMs, operation = "operation" } = options;

package/dist/schema.d.ts

@@ -1,2 +1,3 @@
-import { JsonSchema, zodToJsonSchema } from "./shared/@outfitter/contracts-t79engf9.js";
+import { zodToJsonSchema } from "./shared/@outfitter/contracts-8cmkh2db.js";
+import { JsonSchema } from "./shared/@outfitter/contracts-w7nvcwrp.js";
 export { zodToJsonSchema, JsonSchema };