@crewhaus/errors 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/errors",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "Typed error hierarchy shared across factory layers",
   "main": "src/index.ts",

package/src/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Typed error hierarchy for factory.
+ * Catalog F-foundations (`error-types`) — every later layer imports this
+ * for structured error reporting instead of throwing raw `Error`s.
+ *
+ * Each error carries a stable `code` for programmatic dispatch and serializes
+ * its full cause chain via `toJSON()` for the logging layer.
+ */
+export type ErrorCode = "spec_parse" | "compiler" | "runtime" | "config" | "tool" | "mcp" | "adapter" | "channel";
+export type SerializedError = {
+    name: string;
+    code: ErrorCode;
+    message: string;
+    cause?: SerializedError | {
+        name?: string;
+        message: string;
+    };
+};
+export declare class CrewhausError extends Error {
+    readonly name: string;
+    readonly code: ErrorCode;
+    constructor(code: ErrorCode, message: string, cause?: unknown);
+    toJSON(): SerializedError;
+}
+export declare class SpecParseError extends CrewhausError {
+    readonly name = "SpecParseError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class CompilerError extends CrewhausError {
+    readonly name = "CompilerError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class RuntimeError extends CrewhausError {
+    readonly name = "RuntimeError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class ConfigError extends CrewhausError {
+    readonly name = "ConfigError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class McpError extends CrewhausError {
+    readonly name: string;
+    constructor(message: string, cause?: unknown);
+}
+export declare class McpConnectionError extends McpError {
+    readonly name = "McpConnectionError";
+    constructor(message: string, cause?: unknown);
+}
+export declare class McpProtocolError extends McpError {
+    readonly name = "McpProtocolError";
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Section 17 — base for all model-provider adapter failures (auth, request
+ * marshalling, stream parsing, network). Carries `providerId` so callers can
+ * branch on which adapter raised; `cause` keeps the underlying SDK error
+ * accessible via `toJSON()` for the trace/log layer.
+ */
+export declare class AdapterError extends CrewhausError {
+    readonly name: string;
+    readonly providerId: string;
+    constructor(providerId: string, message: string, cause?: unknown);
+}
+/**
+ * Section 17 — missing or invalid credentials for a model provider. Surfaces
+ * with a setup hint pointing at the relevant env var.
+ */
+export declare class ProviderAuthError extends AdapterError {
+    readonly name = "ProviderAuthError";
+    constructor(providerId: string, message: string, cause?: unknown);
+}
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,UAAU,GACV,SAAS,GACT,QAAQ,GACR,MAAM,GACN,KAAK,GACL,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,eAAe,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAkB,IAAI,EAAE,MAAM,CAAmB;IACjD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAEb,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;IAK7D,MAAM,IAAI,eAAe;CAQ1B;AASD,qBAAa,cAAe,SAAQ,aAAa;IAC/C,SAAkB,IAAI,oBAAoB;gBAC9B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,SAAkB,IAAI,mBAAmB;gBAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,YAAa,SAAQ,aAAa;IAC7C,SAAkB,IAAI,kBAAkB;gBAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,WAAY,SAAQ,aAAa;IAC5C,SAAkB,IAAI,iBAAiB;gBAC3B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,QAAS,SAAQ,aAAa;IACzC,SAAkB,IAAI,EAAE,MAAM,CAAc;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAkB,IAAI,wBAAwB;gBAElC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,SAAkB,IAAI,sBAAsB;gBAEhC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,SAAkB,IAAI,EAAE,MAAM,CAAkB;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAChB,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAIjE;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,SAAkB,IAAI,uBAAuB;gBAEjC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAGjE"}

package/src/index.js

@@ -0,0 +1,103 @@
+/**
+ * Typed error hierarchy for factory.
+ * Catalog F-foundations (`error-types`) — every later layer imports this
+ * for structured error reporting instead of throwing raw `Error`s.
+ *
+ * Each error carries a stable `code` for programmatic dispatch and serializes
+ * its full cause chain via `toJSON()` for the logging layer.
+ */
+export class CrewhausError extends Error {
+    name = "CrewhausError";
+    code;
+    constructor(code, message, cause) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.code = code;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            cause: serializeCause(this.cause),
+        };
+    }
+}
+function serializeCause(cause) {
+    if (cause === undefined)
+        return undefined;
+    if (cause instanceof CrewhausError)
+        return cause.toJSON();
+    if (cause instanceof Error)
+        return { name: cause.name, message: cause.message };
+    return { message: String(cause) };
+}
+export class SpecParseError extends CrewhausError {
+    name = "SpecParseError";
+    constructor(message, cause) {
+        super("spec_parse", message, cause);
+    }
+}
+export class CompilerError extends CrewhausError {
+    name = "CompilerError";
+    constructor(message, cause) {
+        super("compiler", message, cause);
+    }
+}
+export class RuntimeError extends CrewhausError {
+    name = "RuntimeError";
+    constructor(message, cause) {
+        super("runtime", message, cause);
+    }
+}
+export class ConfigError extends CrewhausError {
+    name = "ConfigError";
+    constructor(message, cause) {
+        super("config", message, cause);
+    }
+}
+export class McpError extends CrewhausError {
+    name = "McpError";
+    constructor(message, cause) {
+        super("mcp", message, cause);
+    }
+}
+export class McpConnectionError extends McpError {
+    name = "McpConnectionError";
+    // biome-ignore lint/complexity/noUselessConstructor: explicit constructor so Bun --coverage counts it as a covered function (field-initializer-only classes can't hit 100% function coverage otherwise)
+    constructor(message, cause) {
+        super(message, cause);
+    }
+}
+export class McpProtocolError extends McpError {
+    name = "McpProtocolError";
+    // biome-ignore lint/complexity/noUselessConstructor: explicit constructor so Bun --coverage counts it as a covered function (field-initializer-only classes can't hit 100% function coverage otherwise)
+    constructor(message, cause) {
+        super(message, cause);
+    }
+}
+/**
+ * Section 17 — base for all model-provider adapter failures (auth, request
+ * marshalling, stream parsing, network). Carries `providerId` so callers can
+ * branch on which adapter raised; `cause` keeps the underlying SDK error
+ * accessible via `toJSON()` for the trace/log layer.
+ */
+export class AdapterError extends CrewhausError {
+    name = "AdapterError";
+    providerId;
+    constructor(providerId, message, cause) {
+        super("adapter", message, cause);
+        this.providerId = providerId;
+    }
+}
+/**
+ * Section 17 — missing or invalid credentials for a model provider. Surfaces
+ * with a setup hint pointing at the relevant env var.
+ */
+export class ProviderAuthError extends AdapterError {
+    name = "ProviderAuthError";
+    // biome-ignore lint/complexity/noUselessConstructor: explicit constructor so Bun --coverage counts it as a covered function (field-initializer-only classes can't hit 100% function coverage otherwise)
+    constructor(providerId, message, cause) {
+        super(providerId, message, cause);
+    }
+}
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}