@velajs/errors 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.0.1
+
+### Patch Changes
+
+- 49f72ad: Modernize the package build, validation, and release toolchain.
+
 All notable changes to `@velajs/errors` are documented here. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## 1.0.0

package/dist/index.d.ts

@@ -1,11 +1,179 @@
-export { VelaError } from './error';
-export type { VelaErrorOptions } from './error';
-export { CORE_ENTRIES } from './catalog-data';
-export type { CoreErrorCode, ErrorCatalogEntry } from './catalog-data';
-export { CORE_CATALOG, STATUS_TO_CODE, composeCatalogs, defineErrorCatalog } from './catalog';
-export type { Catalog } from './catalog';
-export { isVelaError } from './guard';
-export type { VelaErrorLike } from './guard';
-export { toErrorBody } from './to-error-body';
-export type { ErrorBodyResult, ToErrorBodyOptions, WireErrorObject } from './to-error-body';
-export { invariant, unreachable } from './invariant';
+//#region src/catalog-data.d.ts
+interface ErrorCatalogEntry {
+  status: number;
+  title: string;
+  hint?: string;
+  docsUrl?: string;
+  /** Redaction posture: true → message/hint/data are never echoed to clients. */
+  internal?: boolean;
+}
+declare const CORE_ENTRIES: {
+  readonly bad_request: {
+    readonly status: 400;
+    readonly title: 'Bad Request';
+  };
+  readonly unauthorized: {
+    readonly status: 401;
+    readonly title: 'Unauthorized';
+  };
+  readonly forbidden: {
+    readonly status: 403;
+    readonly title: 'Forbidden';
+  };
+  readonly not_found: {
+    readonly status: 404;
+    readonly title: 'Not Found';
+  };
+  readonly method_not_allowed: {
+    readonly status: 405;
+    readonly title: 'Method Not Allowed';
+  };
+  readonly conflict: {
+    readonly status: 409;
+    readonly title: 'Conflict';
+  };
+  readonly gone: {
+    readonly status: 410;
+    readonly title: 'Gone';
+  };
+  readonly payload_too_large: {
+    readonly status: 413;
+    readonly title: 'Payload Too Large';
+  };
+  readonly unsupported_media_type: {
+    readonly status: 415;
+    readonly title: 'Unsupported Media Type';
+  };
+  readonly unprocessable: {
+    readonly status: 422;
+    readonly title: 'Unprocessable Entity';
+  };
+  readonly too_many_requests: {
+    readonly status: 429;
+    readonly title: 'Too Many Requests';
+  };
+  readonly internal: {
+    readonly status: 500;
+    readonly title: 'Internal Server Error';
+    readonly internal: true;
+  };
+  readonly not_implemented: {
+    readonly status: 501;
+    readonly title: 'Not Implemented';
+  };
+  readonly bad_gateway: {
+    readonly status: 502;
+    readonly title: 'Bad Gateway';
+  };
+  readonly service_unavailable: {
+    readonly status: 503;
+    readonly title: 'Service Unavailable';
+  };
+  readonly gateway_timeout: {
+    readonly status: 504;
+    readonly title: 'Gateway Timeout';
+  };
+};
+type CoreErrorCode = keyof typeof CORE_ENTRIES;
+//#endregion
+//#region src/error.d.ts
+interface VelaErrorOptions {
+  message?: string;
+  status?: number;
+  hint?: string;
+  docsUrl?: string;
+  data?: unknown;
+  cause?: unknown;
+}
+/**
+ * The one Vela error. Every field is an OWN ENUMERABLE property so the error
+ * rides any wire codec / structuredClone / DO-RPC prop-copy with no special
+ * serialization path. `type` is the brand `isVelaError` checks — it must
+ * survive serialization, which own+enumerable guarantees.
+ */
+declare class VelaError extends Error {
+  readonly type = "VelaError";
+  readonly code: string;
+  readonly status: number;
+  readonly hint?: string;
+  readonly docsUrl?: string;
+  readonly data?: unknown;
+  constructor(code: CoreErrorCode, options?: VelaErrorOptions);
+  constructor(code: string, options: VelaErrorOptions & {
+    status: number;
+  });
+}
+//#endregion
+//#region src/catalog.d.ts
+interface Catalog<C extends string = string> {
+  readonly entries: Readonly<Record<C, ErrorCatalogEntry>>;
+  /** Typed thrower bound to this catalog's defaults. */
+  error(code: C | (string & {}), options?: VelaErrorOptions): VelaError;
+  has(code: string): boolean;
+  get(code: string): ErrorCatalogEntry | undefined;
+}
+declare const defineErrorCatalog: <const T extends Record<string, ErrorCatalogEntry>>(entries: T) => Catalog<Extract<keyof T, string>>;
+declare const composeCatalogs: (...catalogs: Array<Catalog<string>>) => Catalog<string>;
+declare const CORE_CATALOG: Catalog<CoreErrorCode>;
+declare const STATUS_TO_CODE: Readonly<Record<number, CoreErrorCode>>;
+//#endregion
+//#region src/guard.d.ts
+/**
+ * Structural, realm-safe, BRANDED guard. `instanceof VelaError` is unreliable
+ * across DO↔worker RPC and for wire-decoded twins; a bare code+status shape
+ * check lets foreign driver errors ride the client-echo path. The brand
+ * (`type === 'VelaError'`, an own enumerable prop that survives serialization)
+ * closes both failure modes. Nothing load-bearing may use `instanceof`.
+ */
+interface VelaErrorLike extends Error {
+  type: 'VelaError';
+  code: string;
+  status: number;
+  hint?: string;
+  docsUrl?: string;
+  data?: unknown;
+}
+declare const isVelaError: (error: unknown) => error is VelaErrorLike;
+//#endregion
+//#region src/to-error-body.d.ts
+interface WireErrorObject {
+  code: string;
+  message: string;
+  hint?: string;
+  docsUrl?: string;
+  details?: unknown;
+}
+interface ErrorBodyResult {
+  body: {
+    error: WireErrorObject;
+  };
+  status: number;
+  redacted: boolean;
+}
+interface ToErrorBodyOptions {
+  /** Composed catalog; defaults to the core catalog. */
+  catalog?: Catalog<string>;
+  /** Status used for unbranded errors. Default 500. */
+  fallbackStatus?: number;
+  redactedMessage?: (status: number) => string;
+  /** Injectable wire codec for `data` → `details` (bigint/bytes etc.). */
+  encodeData?: (data: unknown) => unknown;
+  /** Default true. */
+  includeHint?: boolean;
+}
+/**
+ * THE single wire-redaction seam. Every transport edge (HTTP, WS, live, queue
+ * reporting) builds its client-bound error content here, so the invariant
+ * "unbranded or internal-coded errors never echo their message" holds
+ * identically everywhere. `redacted: true` is the caller's signal to log the
+ * raw error server-side — this function never logs (zero-dep purity).
+ */
+declare const toErrorBody: (error: unknown, options?: ToErrorBodyOptions) => ErrorBodyResult;
+//#endregion
+//#region src/invariant.d.ts
+/** Throws an internal-coded VelaError — rich in server logs, redacted on the wire. */
+declare function invariant(condition: unknown, message: string, data?: unknown): asserts condition;
+declare function unreachable(value: never, message?: string): never;
+//#endregion
+export { CORE_CATALOG, CORE_ENTRIES, type Catalog, type CoreErrorCode, type ErrorBodyResult, type ErrorCatalogEntry, STATUS_TO_CODE, type ToErrorBodyOptions, VelaError, type VelaErrorLike, type VelaErrorOptions, type WireErrorObject, composeCatalogs, defineErrorCatalog, invariant, isVelaError, toErrorBody, unreachable };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,6 +1,197 @@
-export { VelaError } from "./error.js";
-export { CORE_ENTRIES } from "./catalog-data.js";
-export { CORE_CATALOG, STATUS_TO_CODE, composeCatalogs, defineErrorCatalog } from "./catalog.js";
-export { isVelaError } from "./guard.js";
-export { toErrorBody } from "./to-error-body.js";
-export { invariant, unreachable } from "./invariant.js";
+//#region src/catalog-data.ts
+const CORE_ENTRIES = {
+	bad_request: {
+		status: 400,
+		title: "Bad Request"
+	},
+	unauthorized: {
+		status: 401,
+		title: "Unauthorized"
+	},
+	forbidden: {
+		status: 403,
+		title: "Forbidden"
+	},
+	not_found: {
+		status: 404,
+		title: "Not Found"
+	},
+	method_not_allowed: {
+		status: 405,
+		title: "Method Not Allowed"
+	},
+	conflict: {
+		status: 409,
+		title: "Conflict"
+	},
+	gone: {
+		status: 410,
+		title: "Gone"
+	},
+	payload_too_large: {
+		status: 413,
+		title: "Payload Too Large"
+	},
+	unsupported_media_type: {
+		status: 415,
+		title: "Unsupported Media Type"
+	},
+	unprocessable: {
+		status: 422,
+		title: "Unprocessable Entity"
+	},
+	too_many_requests: {
+		status: 429,
+		title: "Too Many Requests"
+	},
+	internal: {
+		status: 500,
+		title: "Internal Server Error",
+		internal: true
+	},
+	not_implemented: {
+		status: 501,
+		title: "Not Implemented"
+	},
+	bad_gateway: {
+		status: 502,
+		title: "Bad Gateway"
+	},
+	service_unavailable: {
+		status: 503,
+		title: "Service Unavailable"
+	},
+	gateway_timeout: {
+		status: 504,
+		title: "Gateway Timeout"
+	}
+};
+//#endregion
+//#region src/error.ts
+/**
+* The one Vela error. Every field is an OWN ENUMERABLE property so the error
+* rides any wire codec / structuredClone / DO-RPC prop-copy with no special
+* serialization path. `type` is the brand `isVelaError` checks — it must
+* survive serialization, which own+enumerable guarantees.
+*/
+var VelaError = class extends Error {
+	type = "VelaError";
+	code;
+	status;
+	hint;
+	docsUrl;
+	data;
+	constructor(code, options = {}) {
+		const entry = CORE_ENTRIES[code];
+		super(options.message ?? entry?.title ?? code, options.cause !== void 0 ? { cause: options.cause } : void 0);
+		this.name = "VelaError";
+		this.code = code;
+		this.status = options.status ?? entry?.status ?? 500;
+		const hint = options.hint ?? entry?.hint;
+		const docsUrl = options.docsUrl ?? entry?.docsUrl;
+		if (hint !== void 0) this.hint = hint;
+		if (docsUrl !== void 0) this.docsUrl = docsUrl;
+		if (options.data !== void 0) this.data = options.data;
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+//#endregion
+//#region src/catalog.ts
+const makeCatalog = (entries) => ({
+	entries,
+	error(code, options = {}) {
+		const entry = entries[code];
+		const hint = options.hint ?? entry?.hint;
+		const docsUrl = options.docsUrl ?? entry?.docsUrl;
+		return new VelaError(code, {
+			...options,
+			status: options.status ?? entry?.status ?? 500,
+			...hint === void 0 ? {} : { hint },
+			...docsUrl === void 0 ? {} : { docsUrl }
+		});
+	},
+	has: (code) => Object.hasOwn(entries, code),
+	get: (code) => Object.hasOwn(entries, code) ? entries[code] : void 0
+});
+const defineErrorCatalog = (entries) => makeCatalog(entries);
+const composeCatalogs = (...catalogs) => {
+	const merged = {};
+	for (const catalog of catalogs) for (const [code, entry] of Object.entries(catalog.entries)) {
+		if (Object.hasOwn(merged, code)) throw new VelaError("internal", { message: `duplicate error code '${code}' while composing catalogs` });
+		merged[code] = entry;
+	}
+	return makeCatalog(merged);
+};
+const CORE_CATALOG = makeCatalog(CORE_ENTRIES);
+const STATUS_TO_CODE = Object.fromEntries(Object.entries(CORE_ENTRIES).map(([code, e]) => [e.status, code]));
+//#endregion
+//#region src/guard.ts
+const isVelaError = (error) => {
+	if (!(error instanceof Error)) return false;
+	const candidate = error;
+	return typeof candidate.code === "string" && typeof candidate.status === "number" && candidate.type === "VelaError";
+};
+//#endregion
+//#region src/to-error-body.ts
+const defaultRedactedMessage = (status, catalog) => {
+	const code = STATUS_TO_CODE[status];
+	return code && catalog.get(code)?.title || "Internal Server Error";
+};
+/**
+* THE single wire-redaction seam. Every transport edge (HTTP, WS, live, queue
+* reporting) builds its client-bound error content here, so the invariant
+* "unbranded or internal-coded errors never echo their message" holds
+* identically everywhere. `redacted: true` is the caller's signal to log the
+* raw error server-side — this function never logs (zero-dep purity).
+*/
+const toErrorBody = (error, options = {}) => {
+	const catalog = options.catalog ?? CORE_CATALOG;
+	const message = options.redactedMessage ?? ((s) => defaultRedactedMessage(s, catalog));
+	const redact = (status, code) => ({
+		body: { error: {
+			code,
+			message: message(status)
+		} },
+		status,
+		redacted: true
+	});
+	if (!isVelaError(error)) {
+		const status = options.fallbackStatus ?? 500;
+		return redact(status, STATUS_TO_CODE[status] ?? "internal");
+	}
+	const entry = catalog.get(error.code);
+	if (error.code === "internal" || entry?.internal === true) return redact(error.status, error.code);
+	const wire = {
+		code: error.code,
+		message: error.message
+	};
+	const hint = error.hint ?? entry?.hint;
+	if (options.includeHint !== false && hint !== void 0) wire.hint = hint;
+	const docsUrl = error.docsUrl ?? entry?.docsUrl;
+	if (docsUrl !== void 0) wire.docsUrl = docsUrl;
+	if (error.data !== void 0) wire.details = options.encodeData ? options.encodeData(error.data) : error.data;
+	return {
+		body: { error: wire },
+		status: error.status,
+		redacted: false
+	};
+};
+//#endregion
+//#region src/invariant.ts
+/** Throws an internal-coded VelaError — rich in server logs, redacted on the wire. */
+function invariant(condition, message, data) {
+	if (!condition) throw new VelaError("internal", {
+		message: `Invariant violation: ${message}`,
+		data
+	});
+}
+function unreachable(value, message = "unreachable code reached") {
+	throw new VelaError("internal", {
+		message,
+		data: { value }
+	});
+}
+//#endregion
+export { CORE_CATALOG, CORE_ENTRIES, STATUS_TO_CODE, VelaError, composeCatalogs, defineErrorCatalog, invariant, isVelaError, toErrorBody, unreachable };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/catalog-data.ts","../src/error.ts","../src/catalog.ts","../src/guard.ts","../src/to-error-body.ts","../src/invariant.ts"],"sourcesContent":["export interface ErrorCatalogEntry {\n  status: number;\n  title: string;\n  hint?: string;\n  docsUrl?: string;\n  /** Redaction posture: true → message/hint/data are never echoed to clients. */\n  internal?: boolean;\n}\n\nexport const CORE_ENTRIES = {\n  bad_request: { status: 400, title: 'Bad Request' },\n  unauthorized: { status: 401, title: 'Unauthorized' },\n  forbidden: { status: 403, title: 'Forbidden' },\n  not_found: { status: 404, title: 'Not Found' },\n  method_not_allowed: { status: 405, title: 'Method Not Allowed' },\n  conflict: { status: 409, title: 'Conflict' },\n  gone: { status: 410, title: 'Gone' },\n  payload_too_large: { status: 413, title: 'Payload Too Large' },\n  unsupported_media_type: { status: 415, title: 'Unsupported Media Type' },\n  unprocessable: { status: 422, title: 'Unprocessable Entity' },\n  too_many_requests: { status: 429, title: 'Too Many Requests' },\n  internal: { status: 500, title: 'Internal Server Error', internal: true },\n  not_implemented: { status: 501, title: 'Not Implemented' },\n  bad_gateway: { status: 502, title: 'Bad Gateway' },\n  service_unavailable: { status: 503, title: 'Service Unavailable' },\n  gateway_timeout: { status: 504, title: 'Gateway Timeout' },\n} as const satisfies Record<string, ErrorCatalogEntry>;\n\nexport type CoreErrorCode = keyof typeof CORE_ENTRIES;\n","import { CORE_ENTRIES, type CoreErrorCode } from './catalog-data';\n\nexport interface VelaErrorOptions {\n  message?: string;\n  status?: number;\n  hint?: string;\n  docsUrl?: string;\n  data?: unknown;\n  cause?: unknown;\n}\n\n/**\n * The one Vela error. Every field is an OWN ENUMERABLE property so the error\n * rides any wire codec / structuredClone / DO-RPC prop-copy with no special\n * serialization path. `type` is the brand `isVelaError` checks — it must\n * survive serialization, which own+enumerable guarantees.\n */\nexport class VelaError extends Error {\n  readonly type = 'VelaError';\n  readonly code: string;\n  readonly status: number;\n  readonly hint?: string;\n  readonly docsUrl?: string;\n  readonly data?: unknown;\n\n  constructor(code: CoreErrorCode, options?: VelaErrorOptions);\n  constructor(code: string, options: VelaErrorOptions & { status: number });\n  constructor(code: string, options: VelaErrorOptions = {}) {\n    const entry = (\n      CORE_ENTRIES as Record<\n        string,\n        { status: number; title: string; hint?: string; docsUrl?: string }\n      >\n    )[code];\n    super(\n      options.message ?? entry?.title ?? code,\n      options.cause !== undefined ? { cause: options.cause } : undefined,\n    );\n    this.name = 'VelaError';\n    this.code = code;\n    this.status = options.status ?? entry?.status ?? 500;\n    const hint = options.hint ?? entry?.hint;\n    const docsUrl = options.docsUrl ?? entry?.docsUrl;\n    if (hint !== undefined) this.hint = hint;\n    if (docsUrl !== undefined) this.docsUrl = docsUrl;\n    if (options.data !== undefined) this.data = options.data;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { CORE_ENTRIES, type CoreErrorCode, type ErrorCatalogEntry } from './catalog-data';\nimport { VelaError, type VelaErrorOptions } from './error';\n\nexport type { CoreErrorCode, ErrorCatalogEntry } from './catalog-data';\nexport { CORE_ENTRIES } from './catalog-data';\n\nexport interface Catalog<C extends string = string> {\n  readonly entries: Readonly<Record<C, ErrorCatalogEntry>>;\n  /** Typed thrower bound to this catalog's defaults. */\n  error(code: C | (string & {}), options?: VelaErrorOptions): VelaError;\n  has(code: string): boolean;\n  get(code: string): ErrorCatalogEntry | undefined;\n}\n\nconst makeCatalog = <C extends string>(\n  entries: Readonly<Record<C, ErrorCatalogEntry>>,\n): Catalog<C> => ({\n  entries,\n  error(code, options = {}) {\n    const entry = (entries as Record<string, ErrorCatalogEntry>)[code];\n    const hint = options.hint ?? entry?.hint;\n    const docsUrl = options.docsUrl ?? entry?.docsUrl;\n    return new VelaError(code, {\n      ...options,\n      status: options.status ?? entry?.status ?? 500,\n      ...(hint === undefined ? {} : { hint }),\n      ...(docsUrl === undefined ? {} : { docsUrl }),\n    });\n  },\n  has: (code) => Object.hasOwn(entries, code),\n  get: (code) =>\n    Object.hasOwn(entries, code) ? (entries as Record<string, ErrorCatalogEntry>)[code] : undefined,\n});\n\nexport const defineErrorCatalog = <const T extends Record<string, ErrorCatalogEntry>>(\n  entries: T,\n): Catalog<Extract<keyof T, string>> => makeCatalog(entries);\n\nexport const composeCatalogs = (...catalogs: Array<Catalog<string>>): Catalog<string> => {\n  const merged: Record<string, ErrorCatalogEntry> = {};\n  for (const catalog of catalogs) {\n    for (const [code, entry] of Object.entries<ErrorCatalogEntry>(catalog.entries)) {\n      if (Object.hasOwn(merged, code)) {\n        throw new VelaError('internal', {\n          message: `duplicate error code '${code}' while composing catalogs`,\n        });\n      }\n      merged[code] = entry;\n    }\n  }\n  return makeCatalog(merged);\n};\n\nexport const CORE_CATALOG: Catalog<CoreErrorCode> = makeCatalog(CORE_ENTRIES);\n\nexport const STATUS_TO_CODE: Readonly<Record<number, CoreErrorCode>> = Object.fromEntries(\n  (Object.entries(CORE_ENTRIES) as Array<[CoreErrorCode, ErrorCatalogEntry]>).map(([code, e]) => [\n    e.status,\n    code,\n  ]),\n) as Record<number, CoreErrorCode>;\n","/**\n * Structural, realm-safe, BRANDED guard. `instanceof VelaError` is unreliable\n * across DO↔worker RPC and for wire-decoded twins; a bare code+status shape\n * check lets foreign driver errors ride the client-echo path. The brand\n * (`type === 'VelaError'`, an own enumerable prop that survives serialization)\n * closes both failure modes. Nothing load-bearing may use `instanceof`.\n */\nexport interface VelaErrorLike extends Error {\n  type: 'VelaError';\n  code: string;\n  status: number;\n  hint?: string;\n  docsUrl?: string;\n  data?: unknown;\n}\n\nexport const isVelaError = (error: unknown): error is VelaErrorLike => {\n  if (!(error instanceof Error)) return false;\n  const candidate = error as Partial<VelaErrorLike>;\n  return (\n    typeof candidate.code === 'string' &&\n    typeof candidate.status === 'number' &&\n    candidate.type === 'VelaError'\n  );\n};\n","import { CORE_CATALOG, STATUS_TO_CODE, type Catalog } from './catalog';\nimport { isVelaError } from './guard';\n\nexport interface WireErrorObject {\n  code: string;\n  message: string;\n  hint?: string;\n  docsUrl?: string;\n  details?: unknown;\n}\n\nexport interface ErrorBodyResult {\n  body: { error: WireErrorObject };\n  status: number;\n  redacted: boolean;\n}\n\nexport interface ToErrorBodyOptions {\n  /** Composed catalog; defaults to the core catalog. */\n  catalog?: Catalog<string>;\n  /** Status used for unbranded errors. Default 500. */\n  fallbackStatus?: number;\n  redactedMessage?: (status: number) => string;\n  /** Injectable wire codec for `data` → `details` (bigint/bytes etc.). */\n  encodeData?: (data: unknown) => unknown;\n  /** Default true. */\n  includeHint?: boolean;\n}\n\nconst defaultRedactedMessage = (status: number, catalog: Catalog<string>): string => {\n  const code = STATUS_TO_CODE[status];\n  return (code && catalog.get(code)?.title) || 'Internal Server Error';\n};\n\n/**\n * THE single wire-redaction seam. Every transport edge (HTTP, WS, live, queue\n * reporting) builds its client-bound error content here, so the invariant\n * \"unbranded or internal-coded errors never echo their message\" holds\n * identically everywhere. `redacted: true` is the caller's signal to log the\n * raw error server-side — this function never logs (zero-dep purity).\n */\nexport const toErrorBody = (error: unknown, options: ToErrorBodyOptions = {}): ErrorBodyResult => {\n  const catalog = options.catalog ?? CORE_CATALOG;\n  const message = options.redactedMessage ?? ((s: number) => defaultRedactedMessage(s, catalog));\n\n  const redact = (status: number, code: string): ErrorBodyResult => ({\n    body: { error: { code, message: message(status) } },\n    status,\n    redacted: true,\n  });\n\n  if (!isVelaError(error)) {\n    const status = options.fallbackStatus ?? 500;\n    return redact(status, STATUS_TO_CODE[status] ?? 'internal');\n  }\n\n  const entry = catalog.get(error.code);\n  if (error.code === 'internal' || entry?.internal === true) {\n    return redact(error.status, error.code);\n  }\n\n  const wire: WireErrorObject = { code: error.code, message: error.message };\n  const hint = error.hint ?? entry?.hint;\n  if (options.includeHint !== false && hint !== undefined) wire.hint = hint;\n  const docsUrl = error.docsUrl ?? entry?.docsUrl;\n  if (docsUrl !== undefined) wire.docsUrl = docsUrl;\n  if (error.data !== undefined)\n    wire.details = options.encodeData ? options.encodeData(error.data) : error.data;\n  return { body: { error: wire }, status: error.status, redacted: false };\n};\n","import { VelaError } from './error';\n\n/** Throws an internal-coded VelaError — rich in server logs, redacted on the wire. */\nexport function invariant(condition: unknown, message: string, data?: unknown): asserts condition {\n  if (!condition) {\n    throw new VelaError('internal', { message: `Invariant violation: ${message}`, data });\n  }\n}\n\nexport function unreachable(value: never, message = 'unreachable code reached'): never {\n  throw new VelaError('internal', { message, data: { value } });\n}\n"],"mappings":"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"}

package/package.json

@@ -1,53 +1,65 @@
 {
   "name": "@velajs/errors",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Unified error layer for Vela: branded VelaError, composable error catalogs, and the single toErrorBody wire-redaction seam",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "sideEffects": false,
   "keywords": [
-    "vela",
-    "errors",
     "error-catalog",
+    "errors",
+    "framework",
     "redaction",
-    "framework"
+    "vela"
   ],
-  "author": "ksh",
+  "homepage": "https://github.com/velajs/errors#readme",
+  "bugs": {
+    "url": "https://github.com/velajs/errors/issues"
+  },
   "license": "MIT",
+  "author": "ksh",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/velajs/errors.git"
   },
-  "homepage": "https://github.com/velajs/errors#readme",
-  "bugs": {
-    "url": "https://github.com/velajs/errors/issues"
-  },
-  "engines": {
-    "node": ">=20"
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
   },
   "devDependencies": {
-    "@swc/cli": "^0.8.1",
-    "@swc/core": "^1.15.43",
-    "typescript": "^6.0.3",
-    "unplugin-swc": "^1.5.9",
-    "vitest": "^4.1.9"
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@changesets/cli": "^2.31.0",
+    "oxfmt": "^0.58.0",
+    "oxlint": "^1.73.0",
+    "publint": "^0.3.21",
+    "tsdown": "^0.22.4",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=24"
   },
   "scripts": {
-    "build": "rm -rf dist && swc src -d dist --strip-leading-paths && tsc --emitDeclarationOnly",
+    "build": "tsdown",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit -p tsconfig.test.json"
+    "typecheck": "tsc --noEmit -p tsconfig.test.json",
+    "lint": "oxlint .",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "publint": "publint",
+    "attw": "attw --pack . --profile esm-only",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "pnpm build && changeset publish",
+    "verify": "pnpm lint && pnpm format:check && pnpm build && pnpm typecheck && pnpm test && pnpm publint && pnpm attw"
   }
 }

package/dist/catalog-data.d.ts

@@ -1,76 +0,0 @@
-export interface ErrorCatalogEntry {
-    status: number;
-    title: string;
-    hint?: string;
-    docsUrl?: string;
-    /** Redaction posture: true → message/hint/data are never echoed to clients. */
-    internal?: boolean;
-}
-export declare const CORE_ENTRIES: {
-    readonly bad_request: {
-        readonly status: 400;
-        readonly title: "Bad Request";
-    };
-    readonly unauthorized: {
-        readonly status: 401;
-        readonly title: "Unauthorized";
-    };
-    readonly forbidden: {
-        readonly status: 403;
-        readonly title: "Forbidden";
-    };
-    readonly not_found: {
-        readonly status: 404;
-        readonly title: "Not Found";
-    };
-    readonly method_not_allowed: {
-        readonly status: 405;
-        readonly title: "Method Not Allowed";
-    };
-    readonly conflict: {
-        readonly status: 409;
-        readonly title: "Conflict";
-    };
-    readonly gone: {
-        readonly status: 410;
-        readonly title: "Gone";
-    };
-    readonly payload_too_large: {
-        readonly status: 413;
-        readonly title: "Payload Too Large";
-    };
-    readonly unsupported_media_type: {
-        readonly status: 415;
-        readonly title: "Unsupported Media Type";
-    };
-    readonly unprocessable: {
-        readonly status: 422;
-        readonly title: "Unprocessable Entity";
-    };
-    readonly too_many_requests: {
-        readonly status: 429;
-        readonly title: "Too Many Requests";
-    };
-    readonly internal: {
-        readonly status: 500;
-        readonly title: "Internal Server Error";
-        readonly internal: true;
-    };
-    readonly not_implemented: {
-        readonly status: 501;
-        readonly title: "Not Implemented";
-    };
-    readonly bad_gateway: {
-        readonly status: 502;
-        readonly title: "Bad Gateway";
-    };
-    readonly service_unavailable: {
-        readonly status: 503;
-        readonly title: "Service Unavailable";
-    };
-    readonly gateway_timeout: {
-        readonly status: 504;
-        readonly title: "Gateway Timeout";
-    };
-};
-export type CoreErrorCode = keyof typeof CORE_ENTRIES;

package/dist/catalog-data.js

@@ -1,67 +0,0 @@
-export const CORE_ENTRIES = {
-    bad_request: {
-        status: 400,
-        title: 'Bad Request'
-    },
-    unauthorized: {
-        status: 401,
-        title: 'Unauthorized'
-    },
-    forbidden: {
-        status: 403,
-        title: 'Forbidden'
-    },
-    not_found: {
-        status: 404,
-        title: 'Not Found'
-    },
-    method_not_allowed: {
-        status: 405,
-        title: 'Method Not Allowed'
-    },
-    conflict: {
-        status: 409,
-        title: 'Conflict'
-    },
-    gone: {
-        status: 410,
-        title: 'Gone'
-    },
-    payload_too_large: {
-        status: 413,
-        title: 'Payload Too Large'
-    },
-    unsupported_media_type: {
-        status: 415,
-        title: 'Unsupported Media Type'
-    },
-    unprocessable: {
-        status: 422,
-        title: 'Unprocessable Entity'
-    },
-    too_many_requests: {
-        status: 429,
-        title: 'Too Many Requests'
-    },
-    internal: {
-        status: 500,
-        title: 'Internal Server Error',
-        internal: true
-    },
-    not_implemented: {
-        status: 501,
-        title: 'Not Implemented'
-    },
-    bad_gateway: {
-        status: 502,
-        title: 'Bad Gateway'
-    },
-    service_unavailable: {
-        status: 503,
-        title: 'Service Unavailable'
-    },
-    gateway_timeout: {
-        status: 504,
-        title: 'Gateway Timeout'
-    }
-};

package/dist/catalog.d.ts

@@ -1,15 +0,0 @@
-import { type CoreErrorCode, type ErrorCatalogEntry } from './catalog-data';
-import { VelaError, type VelaErrorOptions } from './error';
-export type { CoreErrorCode, ErrorCatalogEntry } from './catalog-data';
-export { CORE_ENTRIES } from './catalog-data';
-export interface Catalog<C extends string = string> {
-    readonly entries: Readonly<Record<C, ErrorCatalogEntry>>;
-    /** Typed thrower bound to this catalog's defaults. */
-    error(code: C | (string & {}), options?: VelaErrorOptions): VelaError;
-    has(code: string): boolean;
-    get(code: string): ErrorCatalogEntry | undefined;
-}
-export declare const defineErrorCatalog: <const T extends Record<string, ErrorCatalogEntry>>(entries: T) => Catalog<Extract<keyof T, string>>;
-export declare const composeCatalogs: (...catalogs: Array<Catalog<string>>) => Catalog<string>;
-export declare const CORE_CATALOG: Catalog<CoreErrorCode>;
-export declare const STATUS_TO_CODE: Readonly<Record<number, CoreErrorCode>>;

package/dist/catalog.js

@@ -1,37 +0,0 @@
-import { CORE_ENTRIES } from "./catalog-data.js";
-import { VelaError } from "./error.js";
-export { CORE_ENTRIES } from "./catalog-data.js";
-const makeCatalog = (entries)=>({
-        entries,
-        error (code, options = {}) {
-            const entry = entries[code];
-            return new VelaError(code, {
-                ...options,
-                status: options.status ?? entry?.status ?? 500,
-                hint: options.hint ?? entry?.hint,
-                docsUrl: options.docsUrl ?? entry?.docsUrl
-            });
-        },
-        has: (code)=>Object.hasOwn(entries, code),
-        get: (code)=>Object.hasOwn(entries, code) ? entries[code] : undefined
-    });
-export const defineErrorCatalog = (entries)=>makeCatalog(entries);
-export const composeCatalogs = (...catalogs)=>{
-    const merged = {};
-    for (const catalog of catalogs){
-        for (const [code, entry] of Object.entries(catalog.entries)){
-            if (Object.hasOwn(merged, code)) {
-                throw new VelaError('internal', {
-                    message: `duplicate error code '${code}' while composing catalogs`
-                });
-            }
-            merged[code] = entry;
-        }
-    }
-    return makeCatalog(merged);
-};
-export const CORE_CATALOG = makeCatalog(CORE_ENTRIES);
-export const STATUS_TO_CODE = Object.fromEntries(Object.entries(CORE_ENTRIES).map(([code, e])=>[
-        e.status,
-        code
-    ]));

package/dist/error.d.ts

@@ -1,27 +0,0 @@
-import { type CoreErrorCode } from './catalog-data';
-export interface VelaErrorOptions {
-    message?: string;
-    status?: number;
-    hint?: string;
-    docsUrl?: string;
-    data?: unknown;
-    cause?: unknown;
-}
-/**
- * The one Vela error. Every field is an OWN ENUMERABLE property so the error
- * rides any wire codec / structuredClone / DO-RPC prop-copy with no special
- * serialization path. `type` is the brand `isVelaError` checks — it must
- * survive serialization, which own+enumerable guarantees.
- */
-export declare class VelaError extends Error {
-    readonly type = "VelaError";
-    readonly code: string;
-    readonly status: number;
-    readonly hint?: string;
-    readonly docsUrl?: string;
-    readonly data?: unknown;
-    constructor(code: CoreErrorCode, options?: VelaErrorOptions);
-    constructor(code: string, options: VelaErrorOptions & {
-        status: number;
-    });
-}

package/dist/error.js

@@ -1,27 +0,0 @@
-import { CORE_ENTRIES } from "./catalog-data.js";
-/**
- * The one Vela error. Every field is an OWN ENUMERABLE property so the error
- * rides any wire codec / structuredClone / DO-RPC prop-copy with no special
- * serialization path. `type` is the brand `isVelaError` checks — it must
- * survive serialization, which own+enumerable guarantees.
- */ export class VelaError extends Error {
-    type = 'VelaError';
-    code;
-    status;
-    hint;
-    docsUrl;
-    data;
-    constructor(code, options = {}){
-        const entry = CORE_ENTRIES[code];
-        super(options.message ?? entry?.title ?? code, options.cause !== undefined ? {
-            cause: options.cause
-        } : undefined);
-        this.name = 'VelaError';
-        this.code = code;
-        this.status = options.status ?? entry?.status ?? 500;
-        if (options.hint ?? entry?.hint) this.hint = options.hint ?? entry?.hint;
-        if (options.docsUrl ?? entry?.docsUrl) this.docsUrl = options.docsUrl ?? entry?.docsUrl;
-        if (options.data !== undefined) this.data = options.data;
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}

package/dist/guard.d.ts

@@ -1,16 +0,0 @@
-/**
- * Structural, realm-safe, BRANDED guard. `instanceof VelaError` is unreliable
- * across DO↔worker RPC and for wire-decoded twins; a bare code+status shape
- * check lets foreign driver errors ride the client-echo path. The brand
- * (`type === 'VelaError'`, an own enumerable prop that survives serialization)
- * closes both failure modes. Nothing load-bearing may use `instanceof`.
- */
-export interface VelaErrorLike extends Error {
-    type: 'VelaError';
-    code: string;
-    status: number;
-    hint?: string;
-    docsUrl?: string;
-    data?: unknown;
-}
-export declare const isVelaError: (error: unknown) => error is VelaErrorLike;

package/dist/guard.js

@@ -1,11 +0,0 @@
-/**
- * Structural, realm-safe, BRANDED guard. `instanceof VelaError` is unreliable
- * across DO↔worker RPC and for wire-decoded twins; a bare code+status shape
- * check lets foreign driver errors ride the client-echo path. The brand
- * (`type === 'VelaError'`, an own enumerable prop that survives serialization)
- * closes both failure modes. Nothing load-bearing may use `instanceof`.
- */ export const isVelaError = (error)=>{
-    if (!(error instanceof Error)) return false;
-    const candidate = error;
-    return typeof candidate.code === 'string' && typeof candidate.status === 'number' && candidate.type === 'VelaError';
-};

package/dist/invariant.d.ts

@@ -1,3 +0,0 @@
-/** Throws an internal-coded VelaError — rich in server logs, redacted on the wire. */
-export declare function invariant(condition: unknown, message: string, data?: unknown): asserts condition;
-export declare function unreachable(value: never, message?: string): never;

package/dist/invariant.js

@@ -1,17 +0,0 @@
-import { VelaError } from "./error.js";
-/** Throws an internal-coded VelaError — rich in server logs, redacted on the wire. */ export function invariant(condition, message, data) {
-    if (!condition) {
-        throw new VelaError('internal', {
-            message: `Invariant violation: ${message}`,
-            data
-        });
-    }
-}
-export function unreachable(value, message = 'unreachable code reached') {
-    throw new VelaError('internal', {
-        message,
-        data: {
-            value
-        }
-    });
-}

package/dist/to-error-body.d.ts

@@ -1,34 +0,0 @@
-import { type Catalog } from './catalog';
-export interface WireErrorObject {
-    code: string;
-    message: string;
-    hint?: string;
-    docsUrl?: string;
-    details?: unknown;
-}
-export interface ErrorBodyResult {
-    body: {
-        error: WireErrorObject;
-    };
-    status: number;
-    redacted: boolean;
-}
-export interface ToErrorBodyOptions {
-    /** Composed catalog; defaults to the core catalog. */
-    catalog?: Catalog<string>;
-    /** Status used for unbranded errors. Default 500. */
-    fallbackStatus?: number;
-    redactedMessage?: (status: number) => string;
-    /** Injectable wire codec for `data` → `details` (bigint/bytes etc.). */
-    encodeData?: (data: unknown) => unknown;
-    /** Default true. */
-    includeHint?: boolean;
-}
-/**
- * THE single wire-redaction seam. Every transport edge (HTTP, WS, live, queue
- * reporting) builds its client-bound error content here, so the invariant
- * "unbranded or internal-coded errors never echo their message" holds
- * identically everywhere. `redacted: true` is the caller's signal to log the
- * raw error server-side — this function never logs (zero-dep purity).
- */
-export declare const toErrorBody: (error: unknown, options?: ToErrorBodyOptions) => ErrorBodyResult;

package/dist/to-error-body.js

@@ -1,50 +0,0 @@
-import { CORE_CATALOG, STATUS_TO_CODE } from "./catalog.js";
-import { isVelaError } from "./guard.js";
-const defaultRedactedMessage = (status, catalog)=>{
-    const code = STATUS_TO_CODE[status];
-    return code && catalog.get(code)?.title || 'Internal Server Error';
-};
-/**
- * THE single wire-redaction seam. Every transport edge (HTTP, WS, live, queue
- * reporting) builds its client-bound error content here, so the invariant
- * "unbranded or internal-coded errors never echo their message" holds
- * identically everywhere. `redacted: true` is the caller's signal to log the
- * raw error server-side — this function never logs (zero-dep purity).
- */ export const toErrorBody = (error, options = {})=>{
-    const catalog = options.catalog ?? CORE_CATALOG;
-    const message = options.redactedMessage ?? ((s)=>defaultRedactedMessage(s, catalog));
-    const redact = (status, code)=>({
-            body: {
-                error: {
-                    code,
-                    message: message(status)
-                }
-            },
-            status,
-            redacted: true
-        });
-    if (!isVelaError(error)) {
-        const status = options.fallbackStatus ?? 500;
-        return redact(status, STATUS_TO_CODE[status] ?? 'internal');
-    }
-    const entry = catalog.get(error.code);
-    if (error.code === 'internal' || entry?.internal === true) {
-        return redact(error.status, error.code);
-    }
-    const wire = {
-        code: error.code,
-        message: error.message
-    };
-    const hint = error.hint ?? entry?.hint;
-    if (options.includeHint !== false && hint !== undefined) wire.hint = hint;
-    const docsUrl = error.docsUrl ?? entry?.docsUrl;
-    if (docsUrl !== undefined) wire.docsUrl = docsUrl;
-    if (error.data !== undefined) wire.details = options.encodeData ? options.encodeData(error.data) : error.data;
-    return {
-        body: {
-            error: wire
-        },
-        status: error.status,
-        redacted: false
-    };
-};