@typokit/errors 0.1.4

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import type { ErrorResponse } from "@typokit/types";
+/**
+ * Base error class for all TypoKit errors.
+ * Extends native Error with structured fields for status, code, and details.
+ */
+export declare class AppError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: string, status: number, message: string, details?: Record<string, unknown> | undefined);
+    /** Serialize to the ErrorResponse schema from @typokit/types */
+    toJSON(): ErrorResponse;
+}
+/** 404 Not Found */
+export declare class NotFoundError extends AppError {
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+/** 400 Bad Request / Validation */
+export declare class ValidationError extends AppError {
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+/** 401 Unauthorized */
+export declare class UnauthorizedError extends AppError {
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+/** 403 Forbidden */
+export declare class ForbiddenError extends AppError {
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+/** 409 Conflict */
+export declare class ConflictError extends AppError {
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+/**
+ * Factory function that returns the correct AppError subclass based on status code.
+ */
+export declare function createAppError(status: number, code: string, message: string, details?: Record<string, unknown>): AppError;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;aAEd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAHjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAOnD,gEAAgE;IAChE,MAAM,IAAI,aAAa;CASxB;AAED,oBAAoB;AACpB,qBAAa,aAAc,SAAQ,QAAQ;gBAEvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED,mCAAmC;AACnC,qBAAa,eAAgB,SAAQ,QAAQ;gBAEzC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED,uBAAuB;AACvB,qBAAa,iBAAkB,SAAQ,QAAQ;gBAE3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED,oBAAoB;AACpB,qBAAa,cAAe,SAAQ,QAAQ;gBAExC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED,mBAAmB;AACnB,qBAAa,aAAc,SAAQ,QAAQ;gBAEvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,QAAQ,CAeV"}

package/dist/index.js

@@ -0,0 +1,83 @@
+// @typokit/errors — Structured Error Class Hierarchy
+/**
+ * Base error class for all TypoKit errors.
+ * Extends native Error with structured fields for status, code, and details.
+ */
+export class AppError extends Error {
+    code;
+    status;
+    details;
+    constructor(code, status, message, details) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.details = details;
+        this.name = "AppError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    /** Serialize to the ErrorResponse schema from @typokit/types */
+    toJSON() {
+        return {
+            error: {
+                code: this.code,
+                message: this.message,
+                ...(this.details !== undefined ? { details: this.details } : {}),
+            },
+        };
+    }
+}
+/** 404 Not Found */
+export class NotFoundError extends AppError {
+    constructor(code, message, details) {
+        super(code, 404, message, details);
+        this.name = "NotFoundError";
+    }
+}
+/** 400 Bad Request / Validation */
+export class ValidationError extends AppError {
+    constructor(code, message, details) {
+        super(code, 400, message, details);
+        this.name = "ValidationError";
+    }
+}
+/** 401 Unauthorized */
+export class UnauthorizedError extends AppError {
+    constructor(code, message, details) {
+        super(code, 401, message, details);
+        this.name = "UnauthorizedError";
+    }
+}
+/** 403 Forbidden */
+export class ForbiddenError extends AppError {
+    constructor(code, message, details) {
+        super(code, 403, message, details);
+        this.name = "ForbiddenError";
+    }
+}
+/** 409 Conflict */
+export class ConflictError extends AppError {
+    constructor(code, message, details) {
+        super(code, 409, message, details);
+        this.name = "ConflictError";
+    }
+}
+/**
+ * Factory function that returns the correct AppError subclass based on status code.
+ */
+export function createAppError(status, code, message, details) {
+    switch (status) {
+        case 400:
+            return new ValidationError(code, message, details);
+        case 401:
+            return new UnauthorizedError(code, message, details);
+        case 403:
+            return new ForbiddenError(code, message, details);
+        case 404:
+            return new NotFoundError(code, message, details);
+        case 409:
+            return new ConflictError(code, message, details);
+        default:
+            return new AppError(code, status, message, details);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@typokit/errors",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "version": "0.1.4",
+  "type": "module",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@typokit/types": "0.1.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KyleBastien/typokit",
+    "directory": "packages/errors"
+  },
+  "scripts": {
+    "test": "rstest run --passWithNoTests"
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,168 @@
+import { describe, it, expect } from "@rstest/core";
+import {
+  AppError,
+  NotFoundError,
+  ValidationError,
+  UnauthorizedError,
+  ForbiddenError,
+  ConflictError,
+  createAppError,
+} from "./index.js";
+
+describe("AppError", () => {
+  it("should set code, status, message, and details", () => {
+    const err = new AppError("TEST_ERROR", 500, "Something failed", {
+      key: "value",
+    });
+    expect(err.code).toBe("TEST_ERROR");
+    expect(err.status).toBe(500);
+    expect(err.message).toBe("Something failed");
+    expect(err.details).toEqual({ key: "value" });
+    expect(err.name).toBe("AppError");
+  });
+
+  it("should be an instance of Error", () => {
+    const err = new AppError("CODE", 500, "msg");
+    expect(err instanceof Error).toBe(true);
+    expect(err instanceof AppError).toBe(true);
+  });
+
+  it("should serialize to ErrorResponse JSON", () => {
+    const err = new AppError("INTERNAL", 500, "Internal error", { foo: "bar" });
+    const json = err.toJSON();
+    expect(json).toEqual({
+      error: {
+        code: "INTERNAL",
+        message: "Internal error",
+        details: { foo: "bar" },
+      },
+    });
+  });
+
+  it("should omit details from JSON when undefined", () => {
+    const err = new AppError("INTERNAL", 500, "Internal error");
+    const json = err.toJSON();
+    expect(json).toEqual({
+      error: {
+        code: "INTERNAL",
+        message: "Internal error",
+      },
+    });
+    expect("details" in json.error).toBe(false);
+  });
+});
+
+describe("NotFoundError", () => {
+  it("should have status 404", () => {
+    const err = new NotFoundError("NOT_FOUND", "Resource not found");
+    expect(err.status).toBe(404);
+    expect(err.code).toBe("NOT_FOUND");
+    expect(err.message).toBe("Resource not found");
+    expect(err.name).toBe("NotFoundError");
+    expect(err instanceof AppError).toBe(true);
+  });
+
+  it("should serialize correctly", () => {
+    const err = new NotFoundError("USER_NOT_FOUND", "User not found", {
+      id: "123",
+    });
+    expect(err.toJSON()).toEqual({
+      error: {
+        code: "USER_NOT_FOUND",
+        message: "User not found",
+        details: { id: "123" },
+      },
+    });
+  });
+});
+
+describe("ValidationError", () => {
+  it("should have status 400", () => {
+    const err = new ValidationError("VALIDATION_FAILED", "Invalid input", {
+      field: "email",
+    });
+    expect(err.status).toBe(400);
+    expect(err.code).toBe("VALIDATION_FAILED");
+    expect(err.message).toBe("Invalid input");
+    expect(err.details).toEqual({ field: "email" });
+    expect(err.name).toBe("ValidationError");
+    expect(err instanceof AppError).toBe(true);
+  });
+});
+
+describe("UnauthorizedError", () => {
+  it("should have status 401", () => {
+    const err = new UnauthorizedError("UNAUTHORIZED", "Not authenticated");
+    expect(err.status).toBe(401);
+    expect(err.code).toBe("UNAUTHORIZED");
+    expect(err.name).toBe("UnauthorizedError");
+    expect(err instanceof AppError).toBe(true);
+  });
+});
+
+describe("ForbiddenError", () => {
+  it("should have status 403", () => {
+    const err = new ForbiddenError("FORBIDDEN", "Access denied");
+    expect(err.status).toBe(403);
+    expect(err.code).toBe("FORBIDDEN");
+    expect(err.name).toBe("ForbiddenError");
+    expect(err instanceof AppError).toBe(true);
+  });
+});
+
+describe("ConflictError", () => {
+  it("should have status 409", () => {
+    const err = new ConflictError("CONFLICT", "Already exists");
+    expect(err.status).toBe(409);
+    expect(err.code).toBe("CONFLICT");
+    expect(err.name).toBe("ConflictError");
+    expect(err instanceof AppError).toBe(true);
+  });
+});
+
+describe("createAppError", () => {
+  it("should return ValidationError for status 400", () => {
+    const err = createAppError(400, "BAD_REQUEST", "Invalid");
+    expect(err instanceof ValidationError).toBe(true);
+    expect(err.status).toBe(400);
+  });
+
+  it("should return UnauthorizedError for status 401", () => {
+    const err = createAppError(401, "UNAUTH", "Unauthorized");
+    expect(err instanceof UnauthorizedError).toBe(true);
+    expect(err.status).toBe(401);
+  });
+
+  it("should return ForbiddenError for status 403", () => {
+    const err = createAppError(403, "FORBIDDEN", "Forbidden");
+    expect(err instanceof ForbiddenError).toBe(true);
+    expect(err.status).toBe(403);
+  });
+
+  it("should return NotFoundError for status 404", () => {
+    const err = createAppError(404, "NOT_FOUND", "Not found");
+    expect(err instanceof NotFoundError).toBe(true);
+    expect(err.status).toBe(404);
+  });
+
+  it("should return ConflictError for status 409", () => {
+    const err = createAppError(409, "CONFLICT", "Conflict");
+    expect(err instanceof ConflictError).toBe(true);
+    expect(err.status).toBe(409);
+  });
+
+  it("should return generic AppError for other status codes", () => {
+    const err = createAppError(503, "SERVICE_UNAVAILABLE", "Down", {
+      retry: true,
+    });
+    expect(err instanceof AppError).toBe(true);
+    expect(err.status).toBe(503);
+    expect(err.code).toBe("SERVICE_UNAVAILABLE");
+    expect(err.details).toEqual({ retry: true });
+  });
+
+  it("should pass details through", () => {
+    const err = createAppError(400, "CODE", "msg", { field: "name" });
+    expect(err.details).toEqual({ field: "name" });
+  });
+});

package/src/index.ts

@@ -0,0 +1,116 @@
+// @typokit/errors — Structured Error Class Hierarchy
+
+import type { ErrorResponse } from "@typokit/types";
+
+/**
+ * Base error class for all TypoKit errors.
+ * Extends native Error with structured fields for status, code, and details.
+ */
+export class AppError extends Error {
+  constructor(
+    public readonly code: string,
+    public readonly status: number,
+    message: string,
+    public readonly details?: Record<string, unknown>,
+  ) {
+    super(message);
+    this.name = "AppError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+
+  /** Serialize to the ErrorResponse schema from @typokit/types */
+  toJSON(): ErrorResponse {
+    return {
+      error: {
+        code: this.code,
+        message: this.message,
+        ...(this.details !== undefined ? { details: this.details } : {}),
+      },
+    };
+  }
+}
+
+/** 404 Not Found */
+export class NotFoundError extends AppError {
+  constructor(
+    code: string,
+    message: string,
+    details?: Record<string, unknown>,
+  ) {
+    super(code, 404, message, details);
+    this.name = "NotFoundError";
+  }
+}
+
+/** 400 Bad Request / Validation */
+export class ValidationError extends AppError {
+  constructor(
+    code: string,
+    message: string,
+    details?: Record<string, unknown>,
+  ) {
+    super(code, 400, message, details);
+    this.name = "ValidationError";
+  }
+}
+
+/** 401 Unauthorized */
+export class UnauthorizedError extends AppError {
+  constructor(
+    code: string,
+    message: string,
+    details?: Record<string, unknown>,
+  ) {
+    super(code, 401, message, details);
+    this.name = "UnauthorizedError";
+  }
+}
+
+/** 403 Forbidden */
+export class ForbiddenError extends AppError {
+  constructor(
+    code: string,
+    message: string,
+    details?: Record<string, unknown>,
+  ) {
+    super(code, 403, message, details);
+    this.name = "ForbiddenError";
+  }
+}
+
+/** 409 Conflict */
+export class ConflictError extends AppError {
+  constructor(
+    code: string,
+    message: string,
+    details?: Record<string, unknown>,
+  ) {
+    super(code, 409, message, details);
+    this.name = "ConflictError";
+  }
+}
+
+/**
+ * Factory function that returns the correct AppError subclass based on status code.
+ */
+export function createAppError(
+  status: number,
+  code: string,
+  message: string,
+  details?: Record<string, unknown>,
+): AppError {
+  switch (status) {
+    case 400:
+      return new ValidationError(code, message, details);
+    case 401:
+      return new UnauthorizedError(code, message, details);
+    case 403:
+      return new ForbiddenError(code, message, details);
+    case 404:
+      return new NotFoundError(code, message, details);
+    case 409:
+      return new ConflictError(code, message, details);
+    default:
+      return new AppError(code, status, message, details);
+  }
+}