@turystack/exceptions 1.0.2

package/README.md

@@ -0,0 +1,25 @@
+# @turystack/exceptions
+
+Type-safe HTTP-semantic application exception classes with stable domain codes and metadata.
+
+## Installation
+
+```bash
+pnpm add @turystack/exceptions
+```
+
+## Documentation
+
+Options, API reference and examples:
+
+**https://tury.dev/libs/exceptions**
+
+## Development
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm check
+pnpm test
+pnpm build
+```

package/dist/error-handling/error-handling.d.ts

@@ -0,0 +1,53 @@
+export declare class AppError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    readonly metadata?: Record<string, unknown>;
+    constructor(message: string, statusCode: number, code: string, metadata?: Record<string, unknown>);
+}
+export declare class BadRequestError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class ValidationError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class UnauthorizedError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class ForbiddenError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class NotFoundError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class MethodNotAllowedError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class ConflictError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class ConcurrentUpdateError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class GoneError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class UnprocessableEntityError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class TooManyRequestsError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class InternalServerError extends AppError {
+    constructor(message?: string, metadata?: Record<string, unknown>);
+}
+export declare class BadGatewayError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class ServiceUnavailableError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare class GatewayTimeoutError extends AppError {
+    constructor(message: string, metadata?: Record<string, unknown>);
+}
+export declare function isAppError(error: unknown): error is AppError;
+//# sourceMappingURL=error-handling.d.ts.map

package/dist/error-handling/error-handling.d.ts.map

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

package/dist/error-handling/error-handling.js

@@ -0,0 +1,91 @@
+export class AppError extends Error {
+    statusCode;
+    code;
+    metadata;
+    constructor(message, statusCode, code, metadata) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.metadata = metadata;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class BadRequestError extends AppError {
+    constructor(message, metadata) {
+        super(message, 400, 'BAD_REQUEST', metadata);
+    }
+}
+export class ValidationError extends AppError {
+    constructor(message, metadata) {
+        super(message, 400, 'VALIDATION_ERROR', metadata);
+    }
+}
+export class UnauthorizedError extends AppError {
+    constructor(message, metadata) {
+        super(message, 401, 'UNAUTHORIZED', metadata);
+    }
+}
+export class ForbiddenError extends AppError {
+    constructor(message, metadata) {
+        super(message, 403, 'FORBIDDEN', metadata);
+    }
+}
+export class NotFoundError extends AppError {
+    constructor(message, metadata) {
+        super(message, 404, 'NOT_FOUND', metadata);
+    }
+}
+export class MethodNotAllowedError extends AppError {
+    constructor(message, metadata) {
+        super(message, 405, 'METHOD_NOT_ALLOWED', metadata);
+    }
+}
+export class ConflictError extends AppError {
+    constructor(message, metadata) {
+        super(message, 409, 'CONFLICT', metadata);
+    }
+}
+export class ConcurrentUpdateError extends AppError {
+    constructor(message, metadata) {
+        super(message, 409, 'CONCURRENT_UPDATE', metadata);
+    }
+}
+export class GoneError extends AppError {
+    constructor(message, metadata) {
+        super(message, 410, 'GONE', metadata);
+    }
+}
+export class UnprocessableEntityError extends AppError {
+    constructor(message, metadata) {
+        super(message, 422, 'UNPROCESSABLE_ENTITY', metadata);
+    }
+}
+export class TooManyRequestsError extends AppError {
+    constructor(message, metadata) {
+        super(message, 429, 'TOO_MANY_REQUESTS', metadata);
+    }
+}
+export class InternalServerError extends AppError {
+    constructor(message = 'Internal server error', metadata) {
+        super(message, 500, 'INTERNAL_SERVER_ERROR', metadata);
+    }
+}
+export class BadGatewayError extends AppError {
+    constructor(message, metadata) {
+        super(message, 502, 'BAD_GATEWAY', metadata);
+    }
+}
+export class ServiceUnavailableError extends AppError {
+    constructor(message, metadata) {
+        super(message, 503, 'SERVICE_UNAVAILABLE', metadata);
+    }
+}
+export class GatewayTimeoutError extends AppError {
+    constructor(message, metadata) {
+        super(message, 504, 'GATEWAY_TIMEOUT', metadata);
+    }
+}
+export function isAppError(error) {
+    return error instanceof AppError;
+}
+//# sourceMappingURL=error-handling.js.map

package/dist/error-handling/error-handling.js.map

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

package/dist/error-handling/index.d.ts

@@ -0,0 +1,2 @@
+export * from './error-handling.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/error-handling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error-handling/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}

package/dist/error-handling/index.js

@@ -0,0 +1,2 @@
+export * from './error-handling.js';
+//# sourceMappingURL=index.js.map

package/dist/error-handling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/error-handling/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}

package/dist/exceptions/exceptions.d.ts

@@ -0,0 +1,3 @@
+import type { ExceptionBuilder } from './exceptions.types.js';
+export declare function createExceptions<T>(factory: (e: ExceptionBuilder) => T): T;
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/exceptions/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../src/exceptions/exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAIhB,MAAM,uBAAuB,CAAA;AAkG9B,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,CAAC,GAAG,CAAC,CAwB1E"}

package/dist/exceptions/exceptions.js

@@ -0,0 +1,54 @@
+import { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, GatewayTimeoutError, GoneError, InternalServerError, MethodNotAllowedError, NotFoundError, ServiceUnavailableError, TooManyRequestsError, UnauthorizedError, UnprocessableEntityError, } from '../error-handling/index.js';
+function makeExceptionClass(code, Base) {
+    const Exception = class extends Base {
+        static code = code;
+        constructor(metadata) {
+            super(code, metadata);
+        }
+    };
+    Object.defineProperty(Exception, Symbol.toPrimitive, {
+        value: () => code,
+    });
+    Object.defineProperty(Exception, 'toString', {
+        value: () => code,
+    });
+    return Exception;
+}
+function snakeToCamel(input) {
+    return input.replace(/_([a-z0-9])/g, (_, character) => character.toUpperCase());
+}
+const groupBaseByName = {
+    badGateway: BadGatewayError,
+    badRequest: BadRequestError,
+    conflict: ConflictError,
+    forbidden: ForbiddenError,
+    gatewayTimeout: GatewayTimeoutError,
+    gone: GoneError,
+    internalServerError: InternalServerError,
+    methodNotAllowed: MethodNotAllowedError,
+    notFound: NotFoundError,
+    serviceUnavailable: ServiceUnavailableError,
+    tooManyRequests: TooManyRequestsError,
+    unauthorized: UnauthorizedError,
+    unprocessableEntity: UnprocessableEntityError,
+};
+function addExceptionCode(exceptions, prefix, code, Base) {
+    exceptions[snakeToCamel(code)] = makeExceptionClass(`${prefix}.${code}`, Base);
+}
+export function createExceptions(factory) {
+    const builder = {
+        module(prefix, groups) {
+            const exceptions = {
+                notFound: makeExceptionClass(`${prefix}.not_found`, NotFoundError),
+            };
+            for (const [groupName, codes] of Object.entries(groups)) {
+                for (const code of codes ?? []) {
+                    addExceptionCode(exceptions, prefix, code, groupBaseByName[groupName]);
+                }
+            }
+            return exceptions;
+        },
+    };
+    return factory(builder);
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/exceptions/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../src/exceptions/exceptions.ts"],"names":[],"mappings":"AAOA,OAAO,EAEN,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,GACxB,MAAM,2BAA2B,CAAA;AAOlC,SAAS,kBAAkB,CAC1B,IAAO,EACP,IAAmB;IAEnB,MAAM,SAAS,GAAG,KAAM,SAAQ,IAAI;QACnC,MAAM,CAAU,IAAI,GAAG,IAAI,CAAA;QAE3B,YAAY,QAAkC;YAC7C,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACtB,CAAC;KACD,CAAA;IAED,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE;QACpD,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;KACjB,CAAC,CAAA;IACF,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE;QAC5C,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;KACjB,CAAC,CAAA;IAEF,OAAO,SAAyC,CAAA;AACjD,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,SAAiB,EAAE,EAAE,CAC7D,SAAS,CAAC,WAAW,EAAE,CACvB,CAAA;AACF,CAAC;AAED,MAAM,eAAe,GAAG;IACvB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE,eAAe;IAC3B,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,cAAc;IACzB,cAAc,EAAE,mBAAmB;IACnC,IAAI,EAAE,SAAS;IACf,mBAAmB,EAAE,mBAAmB;IACxC,gBAAgB,EAAE,qBAAqB;IACvC,QAAQ,EAAE,aAAa;IACvB,kBAAkB,EAAE,uBAAuB;IAC3C,eAAe,EAAE,oBAAoB;IACrC,YAAY,EAAE,iBAAiB;IAC/B,mBAAmB,EAAE,wBAAwB;CACS,CAAA;AAEvD,SAAS,gBAAgB,CACxB,UAA0C,EAC1C,MAAc,EACd,IAAY,EACZ,IAAmB;IAEnB,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,kBAAkB,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAA;AAC/E,CAAC;AAuBD,MAAM,UAAU,gBAAgB,CAAI,OAAmC;IACtE,MAAM,OAAO,GAAqB;QACjC,MAAM,CACL,MAAS,EACT,MAAS;YAET,MAAM,UAAU,GAAmC;gBAClD,QAAQ,EAAE,kBAAkB,CAAC,GAAG,MAAM,YAAY,EAAE,aAAa,CAAC;aAClE,CAAA;YAED,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAGnD,EAAE,CAAC;gBACL,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;oBAChC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,CAAA;gBACvE,CAAC;YACF,CAAC;YAED,OAAO,UAA0C,CAAA;QAClD,CAAC;KACD,CAAA;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,CAAA;AACxB,CAAC"}

package/dist/exceptions/exceptions.types.d.ts

@@ -0,0 +1,43 @@
+import type { AppError } from '../error-handling/index.js';
+export type ExceptionGroup = {
+    badRequest?: readonly string[];
+    notFound?: readonly string[];
+    unauthorized?: readonly string[];
+    forbidden?: readonly string[];
+    methodNotAllowed?: readonly string[];
+    conflict?: readonly string[];
+    gone?: readonly string[];
+    unprocessableEntity?: readonly string[];
+    tooManyRequests?: readonly string[];
+    internalServerError?: readonly string[];
+    badGateway?: readonly string[];
+    serviceUnavailable?: readonly string[];
+    gatewayTimeout?: readonly string[];
+};
+type GroupCodeUnion<T extends ExceptionGroup> = {
+    [K in keyof T]: T[K] extends readonly (infer Code)[] ? Code : never;
+}[keyof T] & string;
+export type ExceptionClass<C extends string = string> = (new (metadata?: Record<string, unknown>) => AppError) & {
+    readonly code: C;
+};
+type CamelCaseKey<S extends string> = S extends `${infer Head}_${infer Tail}` ? `${Head}${Capitalize<CamelCaseKey<Tail>>}` : S;
+export type NotFoundMetadata = Record<string, unknown>;
+export type NotFoundExceptionClass<P extends string> = (new (metadata: NotFoundMetadata) => AppError) & {
+    readonly code: `${P}.not_found`;
+};
+export type ExceptionGroupedModule<P extends string, T extends ExceptionGroup> = {
+    notFound: NotFoundExceptionClass<P>;
+} & {
+    [K in GroupCodeUnion<T> as CamelCaseKey<K>]: ExceptionClass<`${P}.${K}`>;
+};
+export type ExceptionBuilder = {
+    module<P extends string, const T extends ExceptionGroup>(prefix: P, groups: T): ExceptionGroupedModule<P, T>;
+};
+export type InferCreateExceptions<T> = {
+    [K in keyof T]: T[K] extends ExceptionClass<infer C> ? C : T[K] extends NotFoundExceptionClass<infer P> ? `${P}.not_found` : never;
+}[keyof T];
+export type InferExceptionCodes<T> = {
+    [M in keyof T]: InferCreateExceptions<T[M]>;
+}[keyof T];
+export {};
+//# sourceMappingURL=exceptions.types.d.ts.map

package/dist/exceptions/exceptions.types.d.ts.map

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

package/dist/exceptions/exceptions.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exceptions.types.js.map

package/dist/exceptions/exceptions.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.types.js","sourceRoot":"","sources":["../../src/exceptions/exceptions.types.ts"],"names":[],"mappings":""}

package/dist/exceptions/index.d.ts

@@ -0,0 +1,3 @@
+export * from './exceptions.js';
+export type * from './exceptions.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/exceptions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,mBAAmB,uBAAuB,CAAA"}

package/dist/exceptions/index.js

@@ -0,0 +1,2 @@
+export * from './exceptions.js';
+//# sourceMappingURL=index.js.map

package/dist/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './error-handling/index.js';
+export * from './exceptions/index.js';
+//# 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":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './error-handling/index.js';
+export * from './exceptions/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,uBAAuB,CAAA"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@turystack/exceptions",
+  "description": "Type-safe HTTP-semantic application exception classes with stable domain codes and metadata.",
+  "private": false,
+  "version": "1.0.2",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/turystack/exceptions.git"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.4",
+    "@vitest/coverage-v8": "^4.1.10",
+    "tsc-alias": "^1.9.1",
+    "typescript": "^7.0.2",
+    "vite": "^8.1.5",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:cov": "vitest run --coverage",
+    "lint": "biome lint ./src",
+    "format": "biome format --write ./src",
+    "check": "biome check ./src",
+    "check:fix": "biome check --write ./src"
+  }
+}