@outfitter/contracts 0.4.0 → 0.4.2

package/dist/shared/@outfitter/{contracts-bdwg55c5.d.ts → contracts-95cc3y06.d.ts}

@@ -1,34 +1,34 @@
-import { OutfitterError, TimeoutError } from "./contracts-r35bn9p6";
+import { OutfitterError, TimeoutError } from "./contracts-3gswmhb1.js";
 import { Result } from "better-result";
 /**
 * Options for retry behavior.
 */
 interface RetryOptions {
-	/** Maximum number of retry attempts (default: 3) */
-	maxAttempts?: number;
-	/** Initial delay in milliseconds (default: 1000) */
-	initialDelayMs?: number;
-	/** Maximum delay in milliseconds (default: 30000) */
-	maxDelayMs?: number;
 	/** Exponential backoff multiplier (default: 2) */
 	backoffMultiplier?: number;
-	/** Whether to add jitter to delays (default: true) */
-	jitter?: boolean;
+	/** Initial delay in milliseconds (default: 1000) */
+	initialDelayMs?: number;
 	/** Predicate to determine if error is retryable */
 	isRetryable?: (error: OutfitterError) => boolean;
-	/** Abort signal for cancellation */
-	signal?: AbortSignal;
+	/** Whether to add jitter to delays (default: true) */
+	jitter?: boolean;
+	/** Maximum number of retry attempts (default: 3) */
+	maxAttempts?: number;
+	/** Maximum delay in milliseconds (default: 30000) */
+	maxDelayMs?: number;
 	/** Callback invoked before each retry */
 	onRetry?: (attempt: number, error: OutfitterError, delayMs: number) => void;
+	/** Abort signal for cancellation */
+	signal?: AbortSignal;
 }
 /**
 * Options for timeout behavior.
 */
 interface TimeoutOptions {
-	/** Timeout duration in milliseconds */
-	timeoutMs: number;
 	/** Operation name for error context */
 	operation?: string;
+	/** Timeout duration in milliseconds */
+	timeoutMs: number;
 }
 /**
 * Retry an async operation with exponential backoff.

package/dist/shared/@outfitter/{contracts-6j6z9dsd.d.ts → contracts-9wtm5nsw.d.ts}

@@ -1,4 +1,4 @@
-import { ValidationError } from "./contracts-r35bn9p6";
+import { ValidationError } from "./contracts-3gswmhb1.js";
 import { Result } from "better-result";
 import { z } from "zod";
 /**

package/dist/shared/@outfitter/{contracts-jggbn5tn.d.ts → contracts-e4m948m7.d.ts}

@@ -1,45 +1,45 @@
-import { OutfitterError, SerializedError } from "./contracts-r35bn9p6";
+import { OutfitterError, SerializedError } from "./contracts-3gswmhb1.js";
 import { Result } from "better-result";
 /**
 * Metadata attached to every response envelope.
 */
 interface EnvelopeMeta {
+	/** Operation duration in milliseconds */
+	durationMs?: number;
 	/** Unique request identifier for tracing */
 	requestId: string;
 	/** ISO timestamp of response generation */
 	timestamp: string;
-	/** Operation duration in milliseconds */
-	durationMs?: number;
 }
 /**
 * Pagination metadata for list responses.
 */
 interface PaginationMeta {
-	/** Total number of items (if known) */
-	total?: number;
 	/** Number of items returned */
 	count: number;
-	/** Cursor for next page (null if no more pages) */
-	nextCursor: string | null;
 	/** Whether more pages exist */
 	hasMore: boolean;
+	/** Cursor for next page (null if no more pages) */
+	nextCursor: string | null;
+	/** Total number of items (if known) */
+	total?: number;
 }
 /**
 * Success envelope structure.
 */
 interface SuccessEnvelope<T> {
-	ok: true;
 	data: T;
 	meta: EnvelopeMeta;
+	ok: true;
 	pagination?: PaginationMeta;
 }
 /**
 * Error envelope structure.
 */
 interface ErrorEnvelope {
-	ok: false;
 	error: SerializedError;
 	meta: EnvelopeMeta;
+	ok: false;
 }
 /**
 * Response envelope - consistent wrapper for all handler responses.
@@ -49,8 +49,8 @@ type Envelope<T> = SuccessEnvelope<T> | ErrorEnvelope;
 * HTTP-style response with status code.
 */
 interface HttpResponse<T> {
-	status: number;
 	body: Envelope<T>;
+	status: number;
 }
 /**
 * Convert a Result to a response envelope.

package/dist/shared/@outfitter/{contracts-evxky148.d.ts → contracts-k71jqd1m.d.ts}

@@ -1,4 +1,4 @@
-import { ErrorCategory } from "./contracts-r35bn9p6";
+import { ErrorCategory } from "./contracts-3gswmhb1.js";
 /**
 * Backoff strategy configuration options
 */

package/dist/shared/@outfitter/{contracts-18vcxecr.d.ts → contracts-mmg0npfk.d.ts}

@@ -1,4 +1,4 @@
-import { AssertionError } from "./contracts-r35bn9p6";
+import { AssertionError } from "./contracts-3gswmhb1.js";
 import { Result } from "better-result";
 /**
 * Array type guaranteed to have at least one element.

package/dist/validation.d.ts

@@ -1,3 +1,3 @@
-import { createValidator, validateInput } from "./shared/@outfitter/contracts-6j6z9dsd";
-import "./shared/@outfitter/contracts-r35bn9p6";
+import { createValidator, validateInput } from "./shared/@outfitter/contracts-9wtm5nsw.js";
+import "./shared/@outfitter/contracts-3gswmhb1.js";
 export { validateInput, createValidator };

package/dist/validation.js

@@ -1,9 +1,41 @@
 // @bun
 import {
-  createValidator,
-  validateInput
-} from "./shared/@outfitter/contracts-0snpmkdt.js";
-import"./shared/@outfitter/contracts-phjhz5q3.js";
+  ValidationError
+} from "./shared/@outfitter/contracts-phjhz5q3.js";
+
+// packages/contracts/src/validation.ts
+import { Result } from "better-result";
+function formatZodIssues(issues) {
+  return issues.map((issue) => {
+    const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+    return `${path}: ${issue.message}`;
+  }).join("; ");
+}
+function extractField(issues) {
+  const firstIssue = issues[0];
+  if (firstIssue && firstIssue.path.length > 0) {
+    return firstIssue.path.join(".");
+  }
+  return;
+}
+function createValidator(schema) {
+  return (input) => {
+    return validateInput(schema, input);
+  };
+}
+function validateInput(schema, input) {
+  const parseResult = schema.safeParse(input);
+  if (parseResult.success) {
+    return Result.ok(parseResult.data);
+  }
+  const message = formatZodIssues(parseResult.error.issues);
+  const field = extractField(parseResult.error.issues);
+  const errorProps = { message };
+  if (field !== undefined) {
+    errorProps.field = field;
+  }
+  return Result.err(new ValidationError(errorProps));
+}
 export {
   validateInput,
   createValidator

package/package.json

@@ -1,11 +1,25 @@
 {
   "name": "@outfitter/contracts",
+  "version": "0.4.2",
   "description": "Result/Error patterns, error taxonomy, and handler contracts for Outfitter",
-  "version": "0.4.0",
-  "type": "module",
+  "keywords": [
+    "contracts",
+    "errors",
+    "outfitter",
+    "result",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/outfitter-dev/outfitter.git",
+    "directory": "packages/contracts"
+  },
   "files": [
     "dist"
   ],
+  "type": "module",
+  "sideEffects": false,
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -119,37 +133,24 @@
       }
     }
   },
-  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "cd ../.. && bunup --filter @outfitter/contracts",
-    "lint": "biome lint ./src",
-    "lint:fix": "biome lint --write ./src",
+    "lint": "oxlint ./src",
+    "lint:fix": "oxlint --fix ./src",
     "test": "bun test",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun ../../scripts/check-publish-manifest.ts"
   },
   "dependencies": {
-    "better-result": "^2.5.0",
+    "better-result": "^2.5.1",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.8.0"
-  },
-  "keywords": [
-    "outfitter",
-    "contracts",
-    "errors",
-    "result",
-    "typescript"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/outfitter-dev/outfitter.git",
-    "directory": "packages/contracts"
-  },
-  "publishConfig": {
-    "access": "public"
+    "@types/bun": "^1.3.9",
+    "typescript": "^5.9.3"
   }
 }

package/dist/shared/@outfitter/contracts-0snpmkdt.js

@@ -1,40 +0,0 @@
-// @bun
-import {
-  ValidationError
-} from "./contracts-phjhz5q3.js";
-
-// packages/contracts/src/validation.ts
-import { Result } from "better-result";
-function formatZodIssues(issues) {
-  return issues.map((issue) => {
-    const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
-    return `${path}: ${issue.message}`;
-  }).join("; ");
-}
-function extractField(issues) {
-  const firstIssue = issues[0];
-  if (firstIssue && firstIssue.path.length > 0) {
-    return firstIssue.path.join(".");
-  }
-  return;
-}
-function createValidator(schema) {
-  return (input) => {
-    return validateInput(schema, input);
-  };
-}
-function validateInput(schema, input) {
-  const parseResult = schema.safeParse(input);
-  if (parseResult.success) {
-    return Result.ok(parseResult.data);
-  }
-  const message = formatZodIssues(parseResult.error.issues);
-  const field = extractField(parseResult.error.issues);
-  const errorProps = { message };
-  if (field !== undefined) {
-    errorProps.field = field;
-  }
-  return Result.err(new ValidationError(errorProps));
-}
-
-export { createValidator, validateInput };

package/dist/shared/@outfitter/contracts-37gpc56f.js

@@ -1 +0,0 @@
-// @bun

package/dist/shared/@outfitter/contracts-4zaj7ejb.js

@@ -1,52 +0,0 @@
-// @bun
-// packages/contracts/src/recovery.ts
-var RECOVERABLE_CATEGORIES = [
-  "network",
-  "timeout",
-  "rate_limit",
-  "conflict"
-];
-var RETRYABLE_CATEGORIES = ["network", "timeout"];
-var isRecoverable = (error) => {
-  return RECOVERABLE_CATEGORIES.includes(error.category);
-};
-var isRetryable = (error) => {
-  return RETRYABLE_CATEGORIES.includes(error.category);
-};
-var getBackoffDelay = (attempt, options = {}) => {
-  const {
-    baseDelayMs = 100,
-    maxDelayMs = 30000,
-    strategy = "exponential",
-    useJitter = true
-  } = options;
-  let delay;
-  switch (strategy) {
-    case "constant": {
-      delay = baseDelayMs;
-      break;
-    }
-    case "linear": {
-      delay = baseDelayMs * (attempt + 1);
-      break;
-    }
-    default: {
-      delay = baseDelayMs * 2 ** attempt;
-    }
-  }
-  delay = Math.min(delay, maxDelayMs);
-  if (useJitter) {
-    const jitterFactor = 0.1;
-    const jitter = delay * jitterFactor * (Math.random() * 2 - 1);
-    delay = Math.round(delay + jitter);
-  }
-  return Math.min(delay, maxDelayMs);
-};
-var shouldRetry = (error, attempt, maxAttempts = 3) => {
-  if (attempt >= maxAttempts) {
-    return false;
-  }
-  return isRetryable(error);
-};
-
-export { isRecoverable, isRetryable, getBackoffDelay, shouldRetry };

package/dist/shared/@outfitter/contracts-btg89x4h.js

@@ -1,53 +0,0 @@
-// @bun
-import {
-  serializeError
-} from "./contracts-5k6q4n48.js";
-import {
-  generateRequestId
-} from "./contracts-agmt8915.js";
-import {
-  statusCodeMap
-} from "./contracts-phjhz5q3.js";
-
-// packages/contracts/src/envelope.ts
-function buildMeta(overrides) {
-  const meta = {
-    requestId: overrides?.requestId ?? generateRequestId(),
-    timestamp: new Date().toISOString()
-  };
-  if (overrides?.durationMs !== undefined) {
-    meta.durationMs = overrides.durationMs;
-  }
-  return meta;
-}
-function toEnvelope(result, meta) {
-  const envelopeMeta = buildMeta(meta);
-  if (result.isOk()) {
-    return {
-      ok: true,
-      data: result.value,
-      meta: envelopeMeta
-    };
-  }
-  return {
-    ok: false,
-    error: serializeError(result.error),
-    meta: envelopeMeta
-  };
-}
-function toHttpResponse(result) {
-  const envelope = toEnvelope(result);
-  if (envelope.ok) {
-    return {
-      status: 200,
-      body: envelope
-    };
-  }
-  const status = statusCodeMap[envelope.error.category];
-  return {
-    status,
-    body: envelope
-  };
-}
-
-export { toEnvelope, toHttpResponse };

package/dist/shared/@outfitter/contracts-cp5c6dws.js

@@ -1,32 +0,0 @@
-// @bun
-import {
-  AssertionError
-} from "./contracts-phjhz5q3.js";
-
-// packages/contracts/src/assert/index.ts
-import { Result } from "better-result";
-var isNonEmptyArray = (arr) => {
-  return arr.length > 0;
-};
-var assertDefined = (value, message) => {
-  if (value === null || value === undefined) {
-    return Result.err(new AssertionError({ message: message ?? "Value is null or undefined" }));
-  }
-  return Result.ok(value);
-};
-var assertNonEmpty = (arr, message) => {
-  if (arr.length === 0) {
-    return Result.err(new AssertionError({ message: message ?? "Array is empty" }));
-  }
-  return Result.ok(arr);
-};
-function assertMatches(value, predicate, message) {
-  if (!predicate(value)) {
-    return Result.err(new AssertionError({
-      message: message ?? "Value does not match predicate"
-    }));
-  }
-  return Result.ok(value);
-}
-
-export { isNonEmptyArray, assertDefined, assertNonEmpty, assertMatches };

package/dist/shared/@outfitter/contracts-d0tq2adf.js

@@ -1,60 +0,0 @@
-// @bun
-// packages/contracts/src/capabilities.ts
-var CAPABILITY_SURFACES = ["cli", "mcp", "api", "server"];
-var DEFAULT_ACTION_SURFACES = ["cli", "mcp"];
-function capability(surfaces = DEFAULT_ACTION_SURFACES, notes) {
-  return notes ? { surfaces, notes } : { surfaces };
-}
-function capabilityAll(notes) {
-  return capability(CAPABILITY_SURFACES, notes);
-}
-var ACTION_CAPABILITIES = {
-  navigate: capability(),
-  back: capability(),
-  forward: capability(),
-  reload: capability(),
-  tab: capability(),
-  tabs: capability(),
-  newTab: capability(),
-  closeTab: capability(),
-  click: capability(),
-  type: capability(),
-  select: capability(),
-  hover: capability(),
-  focus: capability(["mcp"]),
-  scroll: capability(),
-  press: capability(),
-  fill: capability(),
-  find: capability(),
-  check: capability(),
-  uncheck: capability(),
-  upload: capability(),
-  download: capability(["server"], "Server-only for now"),
-  dialog: capability(),
-  waitFor: capability(["mcp"]),
-  waitForNavigation: capability(["mcp"]),
-  wait: capability(["mcp"]),
-  snap: capability(),
-  screenshot: capability(),
-  html: capability(["mcp"]),
-  text: capability(["mcp"]),
-  marker: capability(),
-  markers: capability(),
-  markerGet: capability(),
-  markerRead: capability(["mcp"]),
-  markerCompare: capability(),
-  markerDelete: capability(),
-  markerResolve: capability(["cli"], "CLI-only for now"),
-  viewport: capability(),
-  colorScheme: capability(),
-  mode: capability(["mcp"]),
-  evaluate: capability(["mcp"]),
-  session: capability(),
-  sessions: capability(["mcp"]),
-  steps: capability()
-};
-function getActionsForSurface(surface) {
-  return Object.entries(ACTION_CAPABILITIES).filter(([, capability2]) => capability2.surfaces.includes(surface)).map(([action]) => action);
-}
-
-export { CAPABILITY_SURFACES, DEFAULT_ACTION_SURFACES, capability, capabilityAll, ACTION_CAPABILITIES, getActionsForSurface };

package/dist/shared/@outfitter/contracts-q0v44kef.js

@@ -1,28 +0,0 @@
-// @bun
-// packages/contracts/src/actions.ts
-var ACTION_SURFACES = ["cli", "mcp", "api", "server"];
-var DEFAULT_REGISTRY_SURFACES = ACTION_SURFACES;
-function defineAction(action) {
-  return action;
-}
-function createActionRegistry() {
-  const actions = new Map;
-  return {
-    add(action) {
-      actions.set(action.id, action);
-      return this;
-    },
-    list() {
-      return Array.from(actions.values());
-    },
-    get(id) {
-      return actions.get(id);
-    },
-    forSurface(surface) {
-      const defaults = DEFAULT_REGISTRY_SURFACES;
-      return Array.from(actions.values()).filter((action) => (action.surfaces ?? defaults).includes(surface));
-    }
-  };
-}
-
-export { ACTION_SURFACES, DEFAULT_REGISTRY_SURFACES, defineAction, createActionRegistry };

package/dist/shared/@outfitter/contracts-r21yet6j.js

@@ -1,80 +0,0 @@
-// @bun
-import {
-  TimeoutError
-} from "./contracts-phjhz5q3.js";
-
-// packages/contracts/src/resilience.ts
-import { Result } from "better-result";
-function defaultIsRetryable(error) {
-  return error.category === "network" || error.category === "timeout" || error.category === "rate_limit";
-}
-function calculateDelay(attempt, initialDelayMs, maxDelayMs, backoffMultiplier, jitter) {
-  const baseDelay = initialDelayMs * backoffMultiplier ** (attempt - 1);
-  const cappedDelay = Math.min(baseDelay, maxDelayMs);
-  if (jitter) {
-    const jitterFactor = 0.5 + Math.random();
-    return Math.floor(cappedDelay * jitterFactor);
-  }
-  return cappedDelay;
-}
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function retry(fn, options) {
-  const maxAttempts = options?.maxAttempts ?? 3;
-  const initialDelayMs = options?.initialDelayMs ?? 1000;
-  const maxDelayMs = options?.maxDelayMs ?? 30000;
-  const backoffMultiplier = options?.backoffMultiplier ?? 2;
-  const jitter = options?.jitter ?? true;
-  const isRetryable = options?.isRetryable ?? defaultIsRetryable;
-  const onRetry = options?.onRetry;
-  const signal = options?.signal;
-  let lastError;
-  let attempt = 0;
-  while (attempt < maxAttempts) {
-    attempt++;
-    if (signal?.aborted) {
-      return Result.err(lastError ?? new TimeoutError({
-        message: "Operation cancelled",
-        operation: "retry",
-        timeoutMs: 0
-      }));
-    }
-    const result = await fn();
-    if (result.isOk()) {
-      return result;
-    }
-    lastError = result.error;
-    if (attempt >= maxAttempts || !isRetryable(lastError)) {
-      return result;
-    }
-    const delayMs = calculateDelay(attempt, initialDelayMs, maxDelayMs, backoffMultiplier, jitter);
-    if (onRetry) {
-      onRetry(attempt, lastError, delayMs);
-    }
-    await sleep(delayMs);
-  }
-  throw new Error("Unexpected: retry loop completed without returning a result");
-}
-async function withTimeout(fn, options) {
-  const { timeoutMs, operation = "operation" } = options;
-  let timeoutId;
-  const timeoutPromise = new Promise((resolve) => {
-    timeoutId = setTimeout(() => {
-      resolve(Result.err(new TimeoutError({
-        message: `${operation} timed out after ${timeoutMs}ms`,
-        operation,
-        timeoutMs
-      })));
-    }, timeoutMs);
-  });
-  try {
-    return await Promise.race([fn(), timeoutPromise]);
-  } finally {
-    if (timeoutId !== undefined) {
-      clearTimeout(timeoutId);
-    }
-  }
-}
-
-export { retry, withTimeout };

package/dist/shared/@outfitter/contracts-sm6vak1a.js

@@ -1,14 +0,0 @@
-// @bun
-// packages/contracts/src/logging.ts
-function createLoggerFactory(adapter) {
-  return {
-    createLogger(config) {
-      return adapter.createLogger(config);
-    },
-    async flush() {
-      await adapter.flush?.();
-    }
-  };
-}
-
-export { createLoggerFactory };