@outfitter/contracts 0.4.1 → 0.5.0

package/dist/index.js

@@ -1,153 +1,17 @@
-// @bun
-import"./shared/@outfitter/contracts-37gpc56f.js";
-import {
-  assertDefined,
-  assertMatches,
-  assertNonEmpty,
-  isNonEmptyArray
-} from "./shared/@outfitter/contracts-cp5c6dws.js";
-import {
-  createValidator,
-  validateInput
-} from "./shared/@outfitter/contracts-0snpmkdt.js";
-import {
-  ACTION_CAPABILITIES,
-  CAPABILITY_SURFACES,
-  DEFAULT_ACTION_SURFACES,
-  capability,
-  capabilityAll,
-  getActionsForSurface
-} from "./shared/@outfitter/contracts-d0tq2adf.js";
-import {
-  getBackoffDelay,
-  isRecoverable,
-  isRetryable,
-  shouldRetry
-} from "./shared/@outfitter/contracts-4zaj7ejb.js";
-import {
-  zodToJsonSchema
-} from "./shared/@outfitter/contracts-wfht4q2b.js";
-import {
-  ACTION_SURFACES,
-  DEFAULT_REGISTRY_SURFACES,
-  createActionRegistry,
-  defineAction
-} from "./shared/@outfitter/contracts-q0v44kef.js";
-import {
-  retry,
-  withTimeout
-} from "./shared/@outfitter/contracts-r21yet6j.js";
-import {
-  combine2,
-  combine3,
-  expect,
-  orElse,
-  unwrapOrElse
-} from "./shared/@outfitter/contracts-zx72gyh1.js";
-import {
-  toEnvelope,
-  toHttpResponse
-} from "./shared/@outfitter/contracts-85nd53s9.js";
-import {
-  deserializeError,
-  safeParse,
-  safeStringify,
-  serializeError
-} from "./shared/@outfitter/contracts-3wj7xghe.js";
-import {
-  DEFAULT_PATTERNS,
-  DEFAULT_SENSITIVE_KEYS,
-  createRedactor
-} from "./shared/@outfitter/contracts-s15x2rs4.js";
-import {
-  AlreadyExistsError,
-  AmbiguousError,
-  AssertionError,
-  AuthError,
-  CancelledError,
-  ConflictError,
-  ERROR_CODES,
-  InternalError,
-  NetworkError,
-  NotFoundError,
-  PermissionError,
-  RateLimitError,
-  TimeoutError,
-  ValidationError,
-  exitCodeMap,
-  getExitCode,
-  getStatusCode,
-  statusCodeMap
-} from "./shared/@outfitter/contracts-phjhz5q3.js";
-import {
-  createContext,
-  generateRequestId
-} from "./shared/@outfitter/contracts-agmt8915.js";
-import {
-  createLoggerFactory
-} from "./shared/@outfitter/contracts-sm6vak1a.js";
-
-// packages/contracts/src/index.ts
-import { Result, TaggedError } from "better-result";
-export {
-  zodToJsonSchema,
-  withTimeout,
-  validateInput,
-  unwrapOrElse,
-  toHttpResponse,
-  toEnvelope,
-  statusCodeMap,
-  shouldRetry,
-  serializeError,
-  safeStringify,
-  safeParse,
-  retry,
-  orElse,
-  isRetryable,
-  isRecoverable,
-  isNonEmptyArray,
-  getStatusCode,
-  getExitCode,
-  getBackoffDelay,
-  getActionsForSurface,
-  generateRequestId,
-  expect,
-  exitCodeMap,
-  deserializeError,
-  defineAction,
-  createValidator,
-  createRedactor,
-  createLoggerFactory,
-  createContext,
-  createActionRegistry,
-  combine3,
-  combine2,
-  capabilityAll,
-  capability,
-  assertNonEmpty,
-  assertMatches,
-  assertDefined,
-  ValidationError,
-  TimeoutError,
-  TaggedError,
-  Result,
-  RateLimitError,
-  PermissionError,
-  NotFoundError,
-  NetworkError,
-  InternalError,
-  ERROR_CODES,
-  DEFAULT_SENSITIVE_KEYS,
-  DEFAULT_REGISTRY_SURFACES,
-  DEFAULT_PATTERNS,
-  DEFAULT_ACTION_SURFACES,
-  ConflictError,
-  CancelledError,
-  CAPABILITY_SURFACES,
-  AuthError,
-  AssertionError,
-  AmbiguousError,
-  AlreadyExistsError,
-  ACTION_SURFACES,
-  ACTION_CAPABILITIES
-};
+export { Result, TaggedError } from "better-result";
+export { ACTION_SURFACES, createActionRegistry, DEFAULT_REGISTRY_SURFACES, defineAction } from "./actions.js";
+export { assertDefined, assertMatches, assertNonEmpty, expectErr, expectOk, isNonEmptyArray } from "./assert/index.js";
+export { ACTION_CAPABILITIES, CAPABILITY_SURFACES, capability, capabilityAll, DEFAULT_ACTION_SURFACES, getActionsForSurface } from "./capabilities.js";
+export { createContext, generateRequestId } from "./context.js";
+export { toEnvelope, toHttpResponse } from "./envelope.js";
+export { fromFetch } from "./from-fetch.js";
+export { AlreadyExistsError, AmbiguousError, AssertionError, AuthError, CancelledError, ConflictError, ERROR_CODES, errorCategoryMeta, exitCodeMap, getExitCode, getStatusCode, InternalError, jsonRpcCodeMap, NetworkError, NotFoundError, PermissionError, RateLimitError, retryableMap, statusCodeMap, TimeoutError, ValidationError } from "./errors.js";
+export { createLoggerFactory } from "./logging.js";
+export { getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./recovery.js";
+export { createRedactor, DEFAULT_PATTERNS, DEFAULT_SENSITIVE_KEYS } from "./redactor.js";
+export { retry, withTimeout } from "./resilience.js";
+export { combine2, combine3, expect, orElse, unwrapOrElse } from "./result/index.js";
+export { zodToJsonSchema } from "./schema.js";
+export { deserializeError, safeParse, safeStringify, serializeError } from "./serialization.js";
+export { createValidator, formatZodIssues, parseInput, validateInput } from "./validation.js";
+export { composeMappers, extractMessage, isOutfitterError, wrapError } from "./wrap-error.js";

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

@@ -0,0 +1,2 @@
+import { AlreadyExistsErrorBase, AmbiguousErrorBase, AssertionErrorBase, AuthErrorBase, CancelledErrorBase, ConflictErrorBase, InternalErrorBase, NetworkErrorBase, NotFoundErrorBase, PermissionErrorBase, RateLimitErrorBase, TimeoutErrorBase, ValidationErrorBase } from "../shared/@outfitter/contracts-qpbv29bg.js";
+export { ValidationErrorBase, TimeoutErrorBase, RateLimitErrorBase, PermissionErrorBase, NotFoundErrorBase, NetworkErrorBase, InternalErrorBase, ConflictErrorBase, CancelledErrorBase, AuthErrorBase, AssertionErrorBase, AmbiguousErrorBase, AlreadyExistsErrorBase };

package/dist/internal/error-base.js

@@ -0,0 +1,31 @@
+// @bun
+import {
+  AlreadyExistsErrorBase,
+  AmbiguousErrorBase,
+  AssertionErrorBase,
+  AuthErrorBase,
+  CancelledErrorBase,
+  ConflictErrorBase,
+  InternalErrorBase,
+  NetworkErrorBase,
+  NotFoundErrorBase,
+  PermissionErrorBase,
+  RateLimitErrorBase,
+  TimeoutErrorBase,
+  ValidationErrorBase
+} from "../shared/@outfitter/contracts-jtn6b927.js";
+export {
+  ValidationErrorBase,
+  TimeoutErrorBase,
+  RateLimitErrorBase,
+  PermissionErrorBase,
+  NotFoundErrorBase,
+  NetworkErrorBase,
+  InternalErrorBase,
+  ConflictErrorBase,
+  CancelledErrorBase,
+  AuthErrorBase,
+  AssertionErrorBase,
+  AmbiguousErrorBase,
+  AlreadyExistsErrorBase
+};

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

@@ -0,0 +1,3 @@
+import { AuthError, CancelledError, InternalError, NetworkError, PermissionError, RateLimitError, TimeoutError } from "../shared/@outfitter/contracts-735ecmbq.js";
+import "../shared/@outfitter/contracts-qpbv29bg.js";
+export { TimeoutError, RateLimitError, PermissionError, NetworkError, InternalError, CancelledError, AuthError };

package/dist/internal/error-operational.js

@@ -0,0 +1,125 @@
+// @bun
+import {
+  AuthErrorBase,
+  CancelledErrorBase,
+  InternalErrorBase,
+  NetworkErrorBase,
+  PermissionErrorBase,
+  RateLimitErrorBase,
+  TimeoutErrorBase
+} from "../shared/@outfitter/contracts-jtn6b927.js";
+import {
+  getExitCode,
+  getStatusCode
+} from "../shared/@outfitter/contracts-sawwfgb5.js";
+
+// packages/contracts/src/internal/error-operational.ts
+class PermissionError extends PermissionErrorBase {
+  category = "permission";
+  static create(message, context) {
+    return new PermissionError({
+      message,
+      ...context != null && { context }
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class TimeoutError extends TimeoutErrorBase {
+  category = "timeout";
+  static create(operation, timeoutMs) {
+    return new TimeoutError({
+      message: `${operation} timed out after ${timeoutMs}ms`,
+      operation,
+      timeoutMs
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class RateLimitError extends RateLimitErrorBase {
+  category = "rate_limit";
+  static create(message, retryAfterSeconds) {
+    return new RateLimitError({
+      message,
+      ...retryAfterSeconds != null && { retryAfterSeconds }
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class NetworkError extends NetworkErrorBase {
+  category = "network";
+  static create(message, context) {
+    return new NetworkError({ message, ...context != null && { context } });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class InternalError extends InternalErrorBase {
+  category = "internal";
+  static create(message, context) {
+    return new InternalError({ message, ...context != null && { context } });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class AuthError extends AuthErrorBase {
+  category = "auth";
+  static create(message, reason) {
+    return new AuthError({ message, ...reason != null && { reason } });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class CancelledError extends CancelledErrorBase {
+  category = "cancelled";
+  static create(message) {
+    return new CancelledError({ message });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+export {
+  TimeoutError,
+  RateLimitError,
+  PermissionError,
+  NetworkError,
+  InternalError,
+  CancelledError,
+  AuthError
+};

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

@@ -0,0 +1,7 @@
+import { SerializeErrorOptions, deserializeError, serializeError } from "../shared/@outfitter/contracts-p77yjs4g.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 { serializeError, deserializeError, SerializeErrorOptions };

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

@@ -1,9 +1,4 @@
 // @bun
-import {
-  DEFAULT_PATTERNS,
-  DEFAULT_SENSITIVE_KEYS,
-  createRedactor
-} from "./contracts-s15x2rs4.js";
 import {
   AlreadyExistsError,
   AmbiguousError,
@@ -18,10 +13,9 @@ import {
   RateLimitError,
   TimeoutError,
   ValidationError
-} from "./contracts-phjhz5q3.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 };