@lowerdeck/error 1.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,12 @@
+
+$ microbundle
+No name was provided for external module '@lowerdeck/case' in output.globals – guessing '_case'
+Build "@lowerdeck/error" to dist:
+      2.02 kB: index.cjs.gz
+      1.73 kB: index.cjs.br
+       1332 B: index.modern.js.gz
+       1080 B: index.modern.js.br
+      2.03 kB: index.module.js.gz
+      1.73 kB: index.module.js.br
+       2.1 kB: index.umd.js.gz
+      1.79 kB: index.umd.js.br

package/.turbo/turbo-test.log

@@ -0,0 +1,21 @@
+
+$ vitest run --passWithNoTests
+[?25l
+ RUN  v3.2.4 /Users/tobias/code/metorial/metorial-enterprise/oss/src/packages/shared/error
+
+[?2026h
+ ❯ src/defaultErrors.test.ts [queued]
+
+ Test Files 0 passed (2)
+      Tests 0 passed (0)
+   Start at 10:23:43
+   Duration 101ms
+[?2026l ✓ src/error.test.ts (6 tests) 2ms
+ ✓ src/defaultErrors.test.ts (1 test) 1ms
+
+ Test Files  2 passed (2)
+      Tests  7 passed (7)
+   Start at  10:23:43
+   Duration  242ms (transform 57ms, setup 0ms, collect 75ms, tests 4ms, environment 0ms, prepare 83ms)
+
+[?25h

package/README.md

@@ -0,0 +1,66 @@
+# `@lowerdeck/error`
+
+Type-safe error handling with structured error objects. Create consistent error responses with status codes, error codes, messages, hints, and descriptions.
+
+## Installation
+
+```bash
+npm install @lowerdeck/error
+yarn add @lowerdeck/error
+bun add @lowerdeck/error
+pnpm add @lowerdeck/error
+```
+
+## Usage
+
+```typescript
+import { createError, ServiceError, isServiceError } from '@lowerdeck/error';
+
+// Define error types
+const Errors = {
+  UserNotFound: new ServiceError(createError({
+    statusCode: 404,
+    errorCode: 'USER_NOT_FOUND',
+    message: 'User not found',
+    hint: 'The requested user does not exist',
+    description: 'Check the user ID and try again'
+  })),
+
+  Unauthorized: new ServiceError(createError({
+    statusCode: 401,
+    errorCode: 'UNAUTHORIZED',
+    message: 'Unauthorized',
+    hint: 'You must be logged in to access this resource'
+  }))
+};
+
+// Throw errors
+function getUser(id: string) {
+  const user = findUser(id);
+  if (!user) {
+    throw Errors.UserNotFound();
+  }
+  return user;
+}
+
+// Handle errors
+try {
+  const user = getUser('123');
+} catch (error) {
+  if (isServiceError(error)) {
+    console.log(error.statusCode); // 404
+    console.log(error.data.errorCode); // 'USER_NOT_FOUND'
+
+    // Convert to HTTP response
+    return error.toResponse();
+  }
+}
+```
+
+## License
+
+This project is licensed under the Apache License 2.0.
+
+<div align="center">
+  <sub>Built with ❤️ by <a href="https://metorial.com">Metorial</a></sub>
+</div>

package/dist/defaultErrors.d.ts

@@ -0,0 +1,26 @@
+import { ValidationError } from '@lowerdeck/validation';
+import { ErrorData, createError } from './error';
+export declare let validationError: (d: {
+    errors: ValidationError[];
+    entity: string;
+} & Partial<ErrorData<"invalid_data", 400>>) => import("./error").ErrorRecord<"invalid_data", 400>;
+export declare let internalServerError: import("./error").ErrorRecord<"internal_server_error", 500>;
+export declare let badRequestError: import("./error").ErrorRecord<"bad_request", 400>;
+export declare function notFoundError(p1: {
+    entity: string;
+    id?: string;
+} & Partial<ErrorData<'not_found', 404>>): ReturnType<typeof createError>;
+export declare function notFoundError(p1: string, p2?: string | null): ReturnType<typeof createError>;
+export declare let unauthorizedError: import("./error").ErrorRecord<"unauthorized", 401>;
+export declare let forbiddenError: import("./error").ErrorRecord<"forbidden", 403>;
+export declare let invalidVersion: import("./error").ErrorRecord<"invalid_version", 400>;
+export declare let conflictError: import("./error").ErrorRecord<"conflict", 409>;
+export declare let goneError: import("./error").ErrorRecord<"gone", 410>;
+export declare let paymentRequiredError: import("./error").ErrorRecord<"payment_required", 402>;
+export declare let preconditionFailedError: import("./error").ErrorRecord<"precondition_failed", 412>;
+export declare let notAcceptableError: import("./error").ErrorRecord<"not_acceptable", 406>;
+export declare let notImplementedError: import("./error").ErrorRecord<"not_implemented", 501>;
+export declare let tooManyRequestsError: import("./error").ErrorRecord<"too_many_requests", 429>;
+export declare let timeoutError: import("./error").ErrorRecord<"timeout", 504>;
+export declare let methodNotAllowedError: import("./error").ErrorRecord<"method_not_allowed", 405>;
+//# sourceMappingURL=defaultErrors.d.ts.map

package/dist/defaultErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultErrors.d.ts","sourceRoot":"","sources":["../src/defaultErrors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEjD,eAAO,IAAI,eAAe,GACxB,GAAG;IAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,uDAQxF,CAAC;AAEL,eAAO,IAAI,mBAAmB,6DAI5B,CAAC;AAEH,eAAO,IAAI,eAAe,mDAIxB,CAAC;AAEH,wBAAgB,aAAa,CAAC,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAC1I,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAiB9F,eAAO,IAAI,iBAAiB,oDAK1B,CAAC;AAEH,eAAO,IAAI,cAAc,iDAIvB,CAAC;AAEH,eAAO,IAAI,cAAc,uDAIvB,CAAC;AAEH,eAAO,IAAI,aAAa,gDAItB,CAAC;AAEH,eAAO,IAAI,SAAS,4CAIlB,CAAC;AAEH,eAAO,IAAI,oBAAoB,wDAI7B,CAAC;AAEH,eAAO,IAAI,uBAAuB,2DAIhC,CAAC;AAEH,eAAO,IAAI,kBAAkB,sDAI3B,CAAC;AAEH,eAAO,IAAI,mBAAmB,uDAI5B,CAAC;AAEH,eAAO,IAAI,oBAAoB,yDAK7B,CAAC;AAEH,eAAO,IAAI,YAAY,+CAIrB,CAAC;AAEH,eAAO,IAAI,qBAAqB,0DAI9B,CAAC"}

package/dist/defaultErrors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defaultErrors.test.d.ts.map

package/dist/defaultErrors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultErrors.test.d.ts","sourceRoot":"","sources":["../src/defaultErrors.test.ts"],"names":[],"mappings":""}

package/dist/error.d.ts

@@ -0,0 +1,34 @@
+export interface ErrorData<Code extends string, Status extends number> {
+    status: Status;
+    code: Code;
+    message: string;
+    hint?: string;
+    description?: string;
+    reason?: string;
+    [key: string]: any;
+}
+export type ErrorRecord<Code extends string, Status extends number> = {
+    __typename: 'error';
+    data: ErrorData<Code, Status>;
+    toResponse: () => ErrorData<Code, Status> & {
+        __typename: 'error';
+        ok: false;
+    };
+} & ((extension?: Partial<ErrorData<Code, Status>>) => ErrorRecord<Code, Status>);
+export declare let createError: <Code extends string, Status extends number>(data: ErrorData<Code, Status>) => ErrorRecord<Code, Status>;
+export declare class ServiceError<InnerError extends ErrorRecord<any, any>> extends Error {
+    private readonly error;
+    __typename: "ServiceError";
+    private _parent;
+    get parent(): Error | null;
+    constructor(error: InnerError);
+    setParent(parent: Error): this;
+    get data(): ErrorData<any, any>;
+    toResponse(): ErrorData<any, any> & {
+        __typename: "error";
+        ok: false;
+    };
+    static fromResponse(raw: ErrorData<any, any>): ServiceError<ErrorRecord<any, any>>;
+}
+export declare let isServiceError: (e: any) => e is ServiceError<any>;
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,KAAK,CAAA;KAAE,CAAC;CAChF,GAAG,CAAC,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAElF,eAAO,IAAI,WAAW,GAAI,IAAI,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,EAClE,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,KAC5B,WAAW,CAAC,IAAI,EAAE,MAAM,CAa1B,CAAC;AAEF,qBAAa,YAAY,CAAC,UAAU,SAAS,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAE,SAAQ,KAAK;IASnE,OAAO,CAAC,QAAQ,CAAC,KAAK;IARlC,UAAU,EAAG,cAAc,CAAU;IAErC,OAAO,CAAC,OAAO,CAAsB;IAErC,IAAW,MAAM,iBAEhB;gBAE4B,KAAK,EAAE,UAAU;IAI9C,SAAS,CAAC,MAAM,EAAE,KAAK;IAKvB,IAAI,IAAI,wBAEP;IAED,UAAU;oBA1CgD,OAAO;YAAM,KAAK;;IA8C5E,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;CAO7C;AAED,eAAO,IAAI,cAAc,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,YAAY,CAAC,GAAG,CAE1D,CAAC"}

package/dist/error.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error.test.d.ts.map

package/dist/error.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.test.d.ts","sourceRoot":"","sources":["../src/error.test.ts"],"names":[],"mappings":""}

package/dist/index.cjs

@@ -0,0 +1,2 @@
+var e=require("@lowerdeck/case");function t(){return t=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var o in r)({}).hasOwnProperty.call(r,o)&&(e[o]=r[o])}return e},t.apply(null,arguments)}function r(e){return r=Object.setPrototypeOf?Object.getPrototypeOf.bind():function(e){return e.__proto__||Object.getPrototypeOf(e)},r(e)}function o(){try{var e=!Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],function(){}))}catch(e){}return(o=function(){return!!e})()}function n(e,t){return n=Object.setPrototypeOf?Object.setPrototypeOf.bind():function(e,t){return e.__proto__=t,e},n(e,t)}function s(e){var t=function(e){if("object"!=typeof e||!e)return e;var t=e[Symbol.toPrimitive];if(void 0!==t){var r=t.call(e,"string");if("object"!=typeof r)return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return String(e)}(e);return"symbol"==typeof t?t:t+""}function i(e){var t="function"==typeof Map?new Map:void 0;return i=function(e){if(null===e||!function(e){try{return-1!==Function.toString.call(e).indexOf("[native code]")}catch(t){return"function"==typeof e}}(e))return e;if("function"!=typeof e)throw new TypeError("Super expression must either be null or a function");if(void 0!==t){if(t.has(e))return t.get(e);t.set(e,s)}function s(){return function(e,t,r){if(o())return Reflect.construct.apply(null,arguments);var s=[null];s.push.apply(s,t);var i=new(e.bind.apply(e,s));return r&&n(i,r.prototype),i}(e,arguments,r(this).constructor)}return s.prototype=Object.create(e.prototype,{constructor:{value:s,enumerable:!1,writable:!0,configurable:!0}}),n(s,e)},i(e)}var a=function(e){return Object.assign(function(r){return void 0===r&&(r={}),a(t({},e,r))},{__typename:"error",data:e,toResponse:function(){return t({__typename:"error",ok:!1},e)}})},u=/*#__PURE__*/function(e){function t(t){var r;return(r=e.call(this,t.data.message)||this).error=void 0,r.__typename="ServiceError",r._parent=null,r.error=t,r}var r,o;o=e,(r=t).prototype=Object.create(o.prototype),r.prototype.constructor=r,n(r,o);var i,u,c=t.prototype;return c.setParent=function(e){return this._parent=e,this},c.toResponse=function(){return this.error.toResponse()},t.fromResponse=function(e){var r=e;return delete r.ok,delete r.__typename,new t(a(r))},i=t,(u=[{key:"parent",get:function(){return this._parent}},{key:"data",get:function(){return this.error.data}}])&&function(e,t){for(var r=0;r<t.length;r++){var o=t[r];o.enumerable=o.enumerable||!1,o.configurable=!0,"value"in o&&(o.writable=!0),Object.defineProperty(e,s(o.key),o)}}(i.prototype,u),Object.defineProperty(i,"prototype",{writable:!1}),i}(/*#__PURE__*/i(Error)),c=a({status:500,code:"internal_server_error",message:"An internal server error occurred."}),d=a({status:400,code:"bad_request",message:"The request is invalid."}),p=a({status:401,code:"unauthorized",message:"You are not authorized to access this resource.",hint:"Make sure you are logged in and have the correct permissions to access this resource."}),l=a({status:403,code:"forbidden",message:"You do not have permission to access this resource."}),f=a({status:400,code:"invalid_version",message:"The endpoint does not support the requested version."}),y=a({status:409,code:"conflict",message:"A similar resource already exists."}),m=a({status:410,code:"gone",message:"The requested resource is no longer available."}),h=a({status:402,code:"payment_required",message:"Payment is required to access this resource."}),v=a({status:412,code:"precondition_failed",message:"The precondition of the request failed."}),g=a({status:406,code:"not_acceptable",message:"The requested resource is not acceptable."}),b=a({status:501,code:"not_implemented",message:"The requested resource is not implemented."}),_=a({status:429,code:"too_many_requests",message:"You have made too many requests in a short period of time.",hint:"Please wait a moment and try again."}),E=a({status:504,code:"timeout",message:"The request timed out."}),x=a({status:405,code:"method_not_allowed",message:"The requested method is not allowed for this resource."});exports.ServiceError=u,exports.badRequestError=d,exports.conflictError=y,exports.createError=a,exports.forbiddenError=l,exports.goneError=m,exports.internalServerError=c,exports.invalidVersion=f,exports.isServiceError=function(e){return"ServiceError"===(null==e?void 0:e.__typename)||"ErrorRecord"===(null==e?void 0:e.__typename)},exports.methodNotAllowedError=x,exports.notAcceptableError=g,exports.notFoundError=function(r,o){var n="string"==typeof r?r:r.entity,s="string"==typeof r?o:r.id;return a(t({status:404,code:"not_found",message:"The requested "+e.Cases.toKebabCase(n)+" could not be found.",hint:"Make sure the resource you are trying to access exists, that you have access to it and that it has not been deleted.",entity:n,id:null!=s?s:void 0},"string"==typeof r?{}:r))},exports.notImplementedError=b,exports.paymentRequiredError=h,exports.preconditionFailedError=v,exports.timeoutError=E,exports.tooManyRequestsError=_,exports.unauthorizedError=p,exports.validationError=function(e){return a(t({status:400,code:"invalid_data",message:"The provided data is invalid.",hint:"Make sure the data you are sending follows the specification outlined in the documentation."},e))};
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/error.ts","../src/defaultErrors.ts"],"sourcesContent":["export interface ErrorData<Code extends string, Status extends number> {\n  status: Status;\n  code: Code;\n  message: string;\n  hint?: string;\n  description?: string;\n  reason?: string;\n  [key: string]: any;\n}\n\nexport type ErrorRecord<Code extends string, Status extends number> = {\n  __typename: 'error';\n  data: ErrorData<Code, Status>;\n  toResponse: () => ErrorData<Code, Status> & { __typename: 'error'; ok: false };\n} & ((extension?: Partial<ErrorData<Code, Status>>) => ErrorRecord<Code, Status>);\n\nexport let createError = <Code extends string, Status extends number>(\n  data: ErrorData<Code, Status>\n): ErrorRecord<Code, Status> => {\n  return Object.assign(\n    (extension: Partial<ErrorData<Code, Status>> = {}): ErrorRecord<Code, Status> =>\n      createError({\n        ...data,\n        ...extension\n      }),\n    {\n      __typename: 'error' as const,\n      data,\n      toResponse: () => ({ __typename: 'error' as const, ok: false as const, ...data })\n    }\n  );\n};\n\nexport class ServiceError<InnerError extends ErrorRecord<any, any>> extends Error {\n  __typename = 'ServiceError' as const;\n\n  private _parent: Error | null = null;\n\n  public get parent() {\n    return this._parent;\n  }\n\n  constructor(private readonly error: InnerError) {\n    super(error.data.message);\n  }\n\n  setParent(parent: Error) {\n    this._parent = parent;\n    return this;\n  }\n\n  get data() {\n    return this.error.data;\n  }\n\n  toResponse() {\n    return this.error.toResponse();\n  }\n\n  static fromResponse(raw: ErrorData<any, any>) {\n    let data = raw;\n    delete data.ok;\n    delete data.__typename;\n\n    return new ServiceError(createError(data));\n  }\n}\n\nexport let isServiceError = (e: any): e is ServiceError<any> => {\n  return e?.__typename === 'ServiceError' || e?.__typename === 'ErrorRecord';\n};\n","import { Cases } from '@lowerdeck/case';\nimport { ValidationError } from '@lowerdeck/validation';\nimport { ErrorData, createError } from './error';\n\nexport let validationError = (\n  d: { errors: ValidationError[]; entity: string } & Partial<ErrorData<'invalid_data', 400>>\n) =>\n  createError({\n    status: 400,\n    code: 'invalid_data',\n    message: 'The provided data is invalid.',\n    hint: 'Make sure the data you are sending follows the specification outlined in the documentation.',\n    ...d\n  });\n\nexport let internalServerError = createError({\n  status: 500,\n  code: 'internal_server_error',\n  message: 'An internal server error occurred.'\n});\n\nexport let badRequestError = createError({\n  status: 400,\n  code: 'bad_request',\n  message: 'The request is invalid.'\n});\n\nexport function notFoundError(p1: { entity: string; id?: string } & Partial<ErrorData<'not_found', 404>>): ReturnType<typeof createError>;\nexport function notFoundError(p1: string, p2?: string | null): ReturnType<typeof createError>;\nexport function notFoundError(p1: any, p2?: any): ReturnType<typeof createError> {\n  let entity = typeof p1 == 'string' ? p1 : p1.entity;\n  let id = typeof p1 == 'string' ? p2 : p1.id;\n\n  return createError({\n    status: 404,\n    code: 'not_found',\n    message: `The requested ${Cases.toKebabCase(entity)} could not be found.`,\n    hint: 'Make sure the resource you are trying to access exists, that you have access to it and that it has not been deleted.',\n    entity,\n    id: id ?? undefined,\n\n    ...(typeof p1 == 'string' ? {} : p1)\n  });\n}\n\nexport let unauthorizedError = createError({\n  status: 401,\n  code: 'unauthorized',\n  message: 'You are not authorized to access this resource.',\n  hint: 'Make sure you are logged in and have the correct permissions to access this resource.'\n});\n\nexport let forbiddenError = createError({\n  status: 403,\n  code: 'forbidden',\n  message: 'You do not have permission to access this resource.'\n});\n\nexport let invalidVersion = createError({\n  status: 400,\n  code: 'invalid_version',\n  message: 'The endpoint does not support the requested version.'\n});\n\nexport let conflictError = createError({\n  status: 409,\n  code: 'conflict',\n  message: 'A similar resource already exists.'\n});\n\nexport let goneError = createError({\n  status: 410,\n  code: 'gone',\n  message: 'The requested resource is no longer available.'\n});\n\nexport let paymentRequiredError = createError({\n  status: 402,\n  code: 'payment_required',\n  message: 'Payment is required to access this resource.'\n});\n\nexport let preconditionFailedError = createError({\n  status: 412,\n  code: 'precondition_failed',\n  message: 'The precondition of the request failed.'\n});\n\nexport let notAcceptableError = createError({\n  status: 406,\n  code: 'not_acceptable',\n  message: 'The requested resource is not acceptable.'\n});\n\nexport let notImplementedError = createError({\n  status: 501,\n  code: 'not_implemented',\n  message: 'The requested resource is not implemented.'\n});\n\nexport let tooManyRequestsError = createError({\n  status: 429,\n  code: 'too_many_requests',\n  message: 'You have made too many requests in a short period of time.',\n  hint: 'Please wait a moment and try again.'\n});\n\nexport let timeoutError = createError({\n  status: 504,\n  code: 'timeout',\n  message: 'The request timed out.'\n});\n\nexport let methodNotAllowedError = createError({\n  status: 405,\n  code: 'method_not_allowed',\n  message: 'The requested method is not allowed for this resource.'\n});\n"],"names":["createError","data","Object","assign","extension","_extends","__typename","toResponse","ok","ServiceError","_Error","error","_this","call","message","_parent","_proto","prototype","_createClass","setParent","parent","this","fromResponse","raw","key","get","_wrapNativeSuper","Error","internalServerError","status","code","badRequestError","unauthorizedError","hint","forbiddenError","invalidVersion","conflictError","goneError","paymentRequiredError","preconditionFailedError","notAcceptableError","notImplementedError","tooManyRequestsError","timeoutError","methodNotAllowedError","e","p1","p2","entity","id","Cases","toKebabCase","undefined","d"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './defaultErrors';
+export * from './error';
+//# 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,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/dist/index.modern.js

@@ -0,0 +1,2 @@
+import{Cases as e}from"@lowerdeck/case";function t(){return t=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var s=arguments[t];for(var r in s)({}).hasOwnProperty.call(s,r)&&(e[r]=s[r])}return e},t.apply(null,arguments)}let s=e=>Object.assign((r={})=>s(t({},e,r)),{__typename:"error",data:e,toResponse:()=>t({__typename:"error",ok:!1},e)});class r extends Error{get parent(){return this._parent}constructor(e){super(e.data.message),this.error=void 0,this.__typename="ServiceError",this._parent=null,this.error=e}setParent(e){return this._parent=e,this}get data(){return this.error.data}toResponse(){return this.error.toResponse()}static fromResponse(e){let t=e;return delete t.ok,delete t.__typename,new r(s(t))}}let o=e=>"ServiceError"===(null==e?void 0:e.__typename)||"ErrorRecord"===(null==e?void 0:e.__typename),a=e=>s(t({status:400,code:"invalid_data",message:"The provided data is invalid.",hint:"Make sure the data you are sending follows the specification outlined in the documentation."},e)),n=s({status:500,code:"internal_server_error",message:"An internal server error occurred."}),i=s({status:400,code:"bad_request",message:"The request is invalid."});function d(r,o){let a="string"==typeof r?r:r.entity,n="string"==typeof r?o:r.id;return s(t({status:404,code:"not_found",message:`The requested ${e.toKebabCase(a)} could not be found.`,hint:"Make sure the resource you are trying to access exists, that you have access to it and that it has not been deleted.",entity:a,id:null!=n?n:void 0},"string"==typeof r?{}:r))}let u=s({status:401,code:"unauthorized",message:"You are not authorized to access this resource.",hint:"Make sure you are logged in and have the correct permissions to access this resource."}),c=s({status:403,code:"forbidden",message:"You do not have permission to access this resource."}),l=s({status:400,code:"invalid_version",message:"The endpoint does not support the requested version."}),h=s({status:409,code:"conflict",message:"A similar resource already exists."}),m=s({status:410,code:"gone",message:"The requested resource is no longer available."}),p=s({status:402,code:"payment_required",message:"Payment is required to access this resource."}),g=s({status:412,code:"precondition_failed",message:"The precondition of the request failed."}),_=s({status:406,code:"not_acceptable",message:"The requested resource is not acceptable."}),y=s({status:501,code:"not_implemented",message:"The requested resource is not implemented."}),v=s({status:429,code:"too_many_requests",message:"You have made too many requests in a short period of time.",hint:"Please wait a moment and try again."}),f=s({status:504,code:"timeout",message:"The request timed out."}),q=s({status:405,code:"method_not_allowed",message:"The requested method is not allowed for this resource."});export{r as ServiceError,i as badRequestError,h as conflictError,s as createError,c as forbiddenError,m as goneError,n as internalServerError,l as invalidVersion,o as isServiceError,q as methodNotAllowedError,_ as notAcceptableError,d as notFoundError,y as notImplementedError,p as paymentRequiredError,g as preconditionFailedError,f as timeoutError,v as tooManyRequestsError,u as unauthorizedError,a as validationError};
+//# sourceMappingURL=index.modern.js.map

package/dist/index.modern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.modern.js","sources":["../src/error.ts","../src/defaultErrors.ts"],"sourcesContent":["export interface ErrorData<Code extends string, Status extends number> {\n  status: Status;\n  code: Code;\n  message: string;\n  hint?: string;\n  description?: string;\n  reason?: string;\n  [key: string]: any;\n}\n\nexport type ErrorRecord<Code extends string, Status extends number> = {\n  __typename: 'error';\n  data: ErrorData<Code, Status>;\n  toResponse: () => ErrorData<Code, Status> & { __typename: 'error'; ok: false };\n} & ((extension?: Partial<ErrorData<Code, Status>>) => ErrorRecord<Code, Status>);\n\nexport let createError = <Code extends string, Status extends number>(\n  data: ErrorData<Code, Status>\n): ErrorRecord<Code, Status> => {\n  return Object.assign(\n    (extension: Partial<ErrorData<Code, Status>> = {}): ErrorRecord<Code, Status> =>\n      createError({\n        ...data,\n        ...extension\n      }),\n    {\n      __typename: 'error' as const,\n      data,\n      toResponse: () => ({ __typename: 'error' as const, ok: false as const, ...data })\n    }\n  );\n};\n\nexport class ServiceError<InnerError extends ErrorRecord<any, any>> extends Error {\n  __typename = 'ServiceError' as const;\n\n  private _parent: Error | null = null;\n\n  public get parent() {\n    return this._parent;\n  }\n\n  constructor(private readonly error: InnerError) {\n    super(error.data.message);\n  }\n\n  setParent(parent: Error) {\n    this._parent = parent;\n    return this;\n  }\n\n  get data() {\n    return this.error.data;\n  }\n\n  toResponse() {\n    return this.error.toResponse();\n  }\n\n  static fromResponse(raw: ErrorData<any, any>) {\n    let data = raw;\n    delete data.ok;\n    delete data.__typename;\n\n    return new ServiceError(createError(data));\n  }\n}\n\nexport let isServiceError = (e: any): e is ServiceError<any> => {\n  return e?.__typename === 'ServiceError' || e?.__typename === 'ErrorRecord';\n};\n","import { Cases } from '@lowerdeck/case';\nimport { ValidationError } from '@lowerdeck/validation';\nimport { ErrorData, createError } from './error';\n\nexport let validationError = (\n  d: { errors: ValidationError[]; entity: string } & Partial<ErrorData<'invalid_data', 400>>\n) =>\n  createError({\n    status: 400,\n    code: 'invalid_data',\n    message: 'The provided data is invalid.',\n    hint: 'Make sure the data you are sending follows the specification outlined in the documentation.',\n    ...d\n  });\n\nexport let internalServerError = createError({\n  status: 500,\n  code: 'internal_server_error',\n  message: 'An internal server error occurred.'\n});\n\nexport let badRequestError = createError({\n  status: 400,\n  code: 'bad_request',\n  message: 'The request is invalid.'\n});\n\nexport function notFoundError(p1: { entity: string; id?: string } & Partial<ErrorData<'not_found', 404>>): ReturnType<typeof createError>;\nexport function notFoundError(p1: string, p2?: string | null): ReturnType<typeof createError>;\nexport function notFoundError(p1: any, p2?: any): ReturnType<typeof createError> {\n  let entity = typeof p1 == 'string' ? p1 : p1.entity;\n  let id = typeof p1 == 'string' ? p2 : p1.id;\n\n  return createError({\n    status: 404,\n    code: 'not_found',\n    message: `The requested ${Cases.toKebabCase(entity)} could not be found.`,\n    hint: 'Make sure the resource you are trying to access exists, that you have access to it and that it has not been deleted.',\n    entity,\n    id: id ?? undefined,\n\n    ...(typeof p1 == 'string' ? {} : p1)\n  });\n}\n\nexport let unauthorizedError = createError({\n  status: 401,\n  code: 'unauthorized',\n  message: 'You are not authorized to access this resource.',\n  hint: 'Make sure you are logged in and have the correct permissions to access this resource.'\n});\n\nexport let forbiddenError = createError({\n  status: 403,\n  code: 'forbidden',\n  message: 'You do not have permission to access this resource.'\n});\n\nexport let invalidVersion = createError({\n  status: 400,\n  code: 'invalid_version',\n  message: 'The endpoint does not support the requested version.'\n});\n\nexport let conflictError = createError({\n  status: 409,\n  code: 'conflict',\n  message: 'A similar resource already exists.'\n});\n\nexport let goneError = createError({\n  status: 410,\n  code: 'gone',\n  message: 'The requested resource is no longer available.'\n});\n\nexport let paymentRequiredError = createError({\n  status: 402,\n  code: 'payment_required',\n  message: 'Payment is required to access this resource.'\n});\n\nexport let preconditionFailedError = createError({\n  status: 412,\n  code: 'precondition_failed',\n  message: 'The precondition of the request failed.'\n});\n\nexport let notAcceptableError = createError({\n  status: 406,\n  code: 'not_acceptable',\n  message: 'The requested resource is not acceptable.'\n});\n\nexport let notImplementedError = createError({\n  status: 501,\n  code: 'not_implemented',\n  message: 'The requested resource is not implemented.'\n});\n\nexport let tooManyRequestsError = createError({\n  status: 429,\n  code: 'too_many_requests',\n  message: 'You have made too many requests in a short period of time.',\n  hint: 'Please wait a moment and try again.'\n});\n\nexport let timeoutError = createError({\n  status: 504,\n  code: 'timeout',\n  message: 'The request timed out.'\n});\n\nexport let methodNotAllowedError = createError({\n  status: 405,\n  code: 'method_not_allowed',\n  message: 'The requested method is not allowed for this resource.'\n});\n"],"names":["createError","data","Object","assign","extension","_extends","__typename","toResponse","ok","ServiceError","Error","parent","this","_parent","constructor","error","super","message","setParent","fromResponse","raw","isServiceError","e","validationError","d","status","code","hint","internalServerError","badRequestError","notFoundError","p1","p2","entity","id","Cases","toKebabCase","undefined","unauthorizedError","forbiddenError","invalidVersion","conflictError","goneError","paymentRequiredError","preconditionFailedError","notAcceptableError","notImplementedError","tooManyRequestsError","timeoutError","methodNotAllowedError"],"mappings":"gQAgBW,IAAAA,EACTC,GAEOC,OAAOC,OACZ,CAACC,EAA8C,CAAA,IAC7CJ,EAAWK,EACNJ,CAAAA,EAAAA,EACAG,IAEP,CACEE,WAAY,QACZL,OACAM,WAAYA,IAAAF,EAAA,CAASC,WAAY,QAAkBE,IAAI,GAAmBP,WAKnEQ,UAA+DC,MAK1E,UAAWC,GACT,OAAWC,KAACC,OACd,CAEAC,WAAAA,CAA6BC,GAC3BC,MAAMD,EAAMd,KAAKgB,SAASL,KADCG,WAR7BT,EAAAA,KAAAA,WAAa,eAELO,KAAAA,QAAwB,KAMHD,KAAKG,MAALA,CAE7B,CAEAG,SAAAA,CAAUP,GAER,OADAC,KAAKC,QAAUF,EAEjBC,IAAA,CAEA,QAAIX,GACF,OAAOW,KAAKG,MAAMd,IACpB,CAEAM,UAAAA,GACE,OAAOK,KAAKG,MAAMR,YACpB,CAEA,mBAAOY,CAAaC,GAClB,IAAInB,EAAOmB,EAIX,cAHOnB,EAAKO,UACLP,EAAKK,WAEL,IAAIG,EAAaT,EAAYC,GACtC,EAGS,IAAAoB,EAAkBC,GACF,kBAAjB,MAADA,OAAC,EAADA,EAAGhB,aAAmD,iBAAjB,MAADgB,OAAC,EAADA,EAAGhB,YCjErCiB,EACTC,GAEAxB,EAAWK,GACToB,OAAQ,IACRC,KAAM,eACNT,QAAS,gCACTU,KAAM,+FACHH,IAGII,EAAsB5B,EAAY,CAC3CyB,OAAQ,IACRC,KAAM,wBACNT,QAAS,uCAGAY,EAAkB7B,EAAY,CACvCyB,OAAQ,IACRC,KAAM,cACNT,QAAS,4BAKK,SAAAa,EAAcC,EAASC,GACrC,IAAIC,EAAsB,iBAANF,EAAiBA,EAAKA,EAAGE,OACzCC,EAAkB,iBAANH,EAAiBC,EAAKD,EAAGG,GAEzC,OAAOlC,EAAWK,EAAA,CAChBoB,OAAQ,IACRC,KAAM,YACNT,QAAS,iBAAiBkB,EAAMC,YAAYH,yBAC5CN,KAAM,uHACNM,SACAC,SAAIA,EAAAA,OAAMG,GAEO,iBAANN,EAAiB,CAAE,EAAGA,GAErC,CAEW,IAAAO,EAAoBtC,EAAY,CACzCyB,OAAQ,IACRC,KAAM,eACNT,QAAS,kDACTU,KAAM,0FAGGY,EAAiBvC,EAAY,CACtCyB,OAAQ,IACRC,KAAM,YACNT,QAAS,wDAGAuB,EAAiBxC,EAAY,CACtCyB,OAAQ,IACRC,KAAM,kBACNT,QAAS,yDAGAwB,EAAgBzC,EAAY,CACrCyB,OAAQ,IACRC,KAAM,WACNT,QAAS,uCAGAyB,EAAY1C,EAAY,CACjCyB,OAAQ,IACRC,KAAM,OACNT,QAAS,mDAGA0B,EAAuB3C,EAAY,CAC5CyB,OAAQ,IACRC,KAAM,mBACNT,QAAS,iDAGA2B,EAA0B5C,EAAY,CAC/CyB,OAAQ,IACRC,KAAM,sBACNT,QAAS,4CAGA4B,EAAqB7C,EAAY,CAC1CyB,OAAQ,IACRC,KAAM,iBACNT,QAAS,8CAGA6B,EAAsB9C,EAAY,CAC3CyB,OAAQ,IACRC,KAAM,kBACNT,QAAS,+CAGA8B,EAAuB/C,EAAY,CAC5CyB,OAAQ,IACRC,KAAM,oBACNT,QAAS,6DACTU,KAAM,wCAGGqB,EAAehD,EAAY,CACpCyB,OAAQ,IACRC,KAAM,UACNT,QAAS,2BAGAgC,EAAwBjD,EAAY,CAC7CyB,OAAQ,IACRC,KAAM,qBACNT,QAAS"}

package/dist/index.module.js

@@ -0,0 +1,2 @@
+import{Cases as e}from"@lowerdeck/case";function t(){return t=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var o in r)({}).hasOwnProperty.call(r,o)&&(e[o]=r[o])}return e},t.apply(null,arguments)}function r(e){return r=Object.setPrototypeOf?Object.getPrototypeOf.bind():function(e){return e.__proto__||Object.getPrototypeOf(e)},r(e)}function o(){try{var e=!Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],function(){}))}catch(e){}return(o=function(){return!!e})()}function n(e,t){return n=Object.setPrototypeOf?Object.setPrototypeOf.bind():function(e,t){return e.__proto__=t,e},n(e,t)}function s(e){var t=function(e){if("object"!=typeof e||!e)return e;var t=e[Symbol.toPrimitive];if(void 0!==t){var r=t.call(e,"string");if("object"!=typeof r)return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return String(e)}(e);return"symbol"==typeof t?t:t+""}function a(e){var t="function"==typeof Map?new Map:void 0;return a=function(e){if(null===e||!function(e){try{return-1!==Function.toString.call(e).indexOf("[native code]")}catch(t){return"function"==typeof e}}(e))return e;if("function"!=typeof e)throw new TypeError("Super expression must either be null or a function");if(void 0!==t){if(t.has(e))return t.get(e);t.set(e,s)}function s(){return function(e,t,r){if(o())return Reflect.construct.apply(null,arguments);var s=[null];s.push.apply(s,t);var a=new(e.bind.apply(e,s));return r&&n(a,r.prototype),a}(e,arguments,r(this).constructor)}return s.prototype=Object.create(e.prototype,{constructor:{value:s,enumerable:!1,writable:!0,configurable:!0}}),n(s,e)},a(e)}var i=function(e){return Object.assign(function(r){return void 0===r&&(r={}),i(t({},e,r))},{__typename:"error",data:e,toResponse:function(){return t({__typename:"error",ok:!1},e)}})},u=/*#__PURE__*/function(e){function t(t){var r;return(r=e.call(this,t.data.message)||this).error=void 0,r.__typename="ServiceError",r._parent=null,r.error=t,r}var r,o;o=e,(r=t).prototype=Object.create(o.prototype),r.prototype.constructor=r,n(r,o);var a,u,c=t.prototype;return c.setParent=function(e){return this._parent=e,this},c.toResponse=function(){return this.error.toResponse()},t.fromResponse=function(e){var r=e;return delete r.ok,delete r.__typename,new t(i(r))},a=t,(u=[{key:"parent",get:function(){return this._parent}},{key:"data",get:function(){return this.error.data}}])&&function(e,t){for(var r=0;r<t.length;r++){var o=t[r];o.enumerable=o.enumerable||!1,o.configurable=!0,"value"in o&&(o.writable=!0),Object.defineProperty(e,s(o.key),o)}}(a.prototype,u),Object.defineProperty(a,"prototype",{writable:!1}),a}(/*#__PURE__*/a(Error)),c=function(e){return"ServiceError"===(null==e?void 0:e.__typename)||"ErrorRecord"===(null==e?void 0:e.__typename)},d=function(e){return i(t({status:400,code:"invalid_data",message:"The provided data is invalid.",hint:"Make sure the data you are sending follows the specification outlined in the documentation."},e))},p=i({status:500,code:"internal_server_error",message:"An internal server error occurred."}),l=i({status:400,code:"bad_request",message:"The request is invalid."});function f(r,o){var n="string"==typeof r?r:r.entity,s="string"==typeof r?o:r.id;return i(t({status:404,code:"not_found",message:"The requested "+e.toKebabCase(n)+" could not be found.",hint:"Make sure the resource you are trying to access exists, that you have access to it and that it has not been deleted.",entity:n,id:null!=s?s:void 0},"string"==typeof r?{}:r))}var y=i({status:401,code:"unauthorized",message:"You are not authorized to access this resource.",hint:"Make sure you are logged in and have the correct permissions to access this resource."}),h=i({status:403,code:"forbidden",message:"You do not have permission to access this resource."}),m=i({status:400,code:"invalid_version",message:"The endpoint does not support the requested version."}),v=i({status:409,code:"conflict",message:"A similar resource already exists."}),g=i({status:410,code:"gone",message:"The requested resource is no longer available."}),b=i({status:402,code:"payment_required",message:"Payment is required to access this resource."}),_=i({status:412,code:"precondition_failed",message:"The precondition of the request failed."}),O=i({status:406,code:"not_acceptable",message:"The requested resource is not acceptable."}),w=i({status:501,code:"not_implemented",message:"The requested resource is not implemented."}),j=i({status:429,code:"too_many_requests",message:"You have made too many requests in a short period of time.",hint:"Please wait a moment and try again."}),q=i({status:504,code:"timeout",message:"The request timed out."}),P=i({status:405,code:"method_not_allowed",message:"The requested method is not allowed for this resource."});export{u as ServiceError,l as badRequestError,v as conflictError,i as createError,h as forbiddenError,g as goneError,p as internalServerError,m as invalidVersion,c as isServiceError,P as methodNotAllowedError,O as notAcceptableError,f as notFoundError,w as notImplementedError,b as paymentRequiredError,_ as preconditionFailedError,q as timeoutError,j as tooManyRequestsError,y as unauthorizedError,d as validationError};
+//# sourceMappingURL=index.module.js.map

package/dist/index.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.module.js","sources":["../src/error.ts","../src/defaultErrors.ts"],"sourcesContent":["export interface ErrorData<Code extends string, Status extends number> {\n  status: Status;\n  code: Code;\n  message: string;\n  hint?: string;\n  description?: string;\n  reason?: string;\n  [key: string]: any;\n}\n\nexport type ErrorRecord<Code extends string, Status extends number> = {\n  __typename: 'error';\n  data: ErrorData<Code, Status>;\n  toResponse: () => ErrorData<Code, Status> & { __typename: 'error'; ok: false };\n} & ((extension?: Partial<ErrorData<Code, Status>>) => ErrorRecord<Code, Status>);\n\nexport let createError = <Code extends string, Status extends number>(\n  data: ErrorData<Code, Status>\n): ErrorRecord<Code, Status> => {\n  return Object.assign(\n    (extension: Partial<ErrorData<Code, Status>> = {}): ErrorRecord<Code, Status> =>\n      createError({\n        ...data,\n        ...extension\n      }),\n    {\n      __typename: 'error' as const,\n      data,\n      toResponse: () => ({ __typename: 'error' as const, ok: false as const, ...data })\n    }\n  );\n};\n\nexport class ServiceError<InnerError extends ErrorRecord<any, any>> extends Error {\n  __typename = 'ServiceError' as const;\n\n  private _parent: Error | null = null;\n\n  public get parent() {\n    return this._parent;\n  }\n\n  constructor(private readonly error: InnerError) {\n    super(error.data.message);\n  }\n\n  setParent(parent: Error) {\n    this._parent = parent;\n    return this;\n  }\n\n  get data() {\n    return this.error.data;\n  }\n\n  toResponse() {\n    return this.error.toResponse();\n  }\n\n  static fromResponse(raw: ErrorData<any, any>) {\n    let data = raw;\n    delete data.ok;\n    delete data.__typename;\n\n    return new ServiceError(createError(data));\n  }\n}\n\nexport let isServiceError = (e: any): e is ServiceError<any> => {\n  return e?.__typename === 'ServiceError' || e?.__typename === 'ErrorRecord';\n};\n","import { Cases } from '@lowerdeck/case';\nimport { ValidationError } from '@lowerdeck/validation';\nimport { ErrorData, createError } from './error';\n\nexport let validationError = (\n  d: { errors: ValidationError[]; entity: string } & Partial<ErrorData<'invalid_data', 400>>\n) =>\n  createError({\n    status: 400,\n    code: 'invalid_data',\n    message: 'The provided data is invalid.',\n    hint: 'Make sure the data you are sending follows the specification outlined in the documentation.',\n    ...d\n  });\n\nexport let internalServerError = createError({\n  status: 500,\n  code: 'internal_server_error',\n  message: 'An internal server error occurred.'\n});\n\nexport let badRequestError = createError({\n  status: 400,\n  code: 'bad_request',\n  message: 'The request is invalid.'\n});\n\nexport function notFoundError(p1: { entity: string; id?: string } & Partial<ErrorData<'not_found', 404>>): ReturnType<typeof createError>;\nexport function notFoundError(p1: string, p2?: string | null): ReturnType<typeof createError>;\nexport function notFoundError(p1: any, p2?: any): ReturnType<typeof createError> {\n  let entity = typeof p1 == 'string' ? p1 : p1.entity;\n  let id = typeof p1 == 'string' ? p2 : p1.id;\n\n  return createError({\n    status: 404,\n    code: 'not_found',\n    message: `The requested ${Cases.toKebabCase(entity)} could not be found.`,\n    hint: 'Make sure the resource you are trying to access exists, that you have access to it and that it has not been deleted.',\n    entity,\n    id: id ?? undefined,\n\n    ...(typeof p1 == 'string' ? {} : p1)\n  });\n}\n\nexport let unauthorizedError = createError({\n  status: 401,\n  code: 'unauthorized',\n  message: 'You are not authorized to access this resource.',\n  hint: 'Make sure you are logged in and have the correct permissions to access this resource.'\n});\n\nexport let forbiddenError = createError({\n  status: 403,\n  code: 'forbidden',\n  message: 'You do not have permission to access this resource.'\n});\n\nexport let invalidVersion = createError({\n  status: 400,\n  code: 'invalid_version',\n  message: 'The endpoint does not support the requested version.'\n});\n\nexport let conflictError = createError({\n  status: 409,\n  code: 'conflict',\n  message: 'A similar resource already exists.'\n});\n\nexport let goneError = createError({\n  status: 410,\n  code: 'gone',\n  message: 'The requested resource is no longer available.'\n});\n\nexport let paymentRequiredError = createError({\n  status: 402,\n  code: 'payment_required',\n  message: 'Payment is required to access this resource.'\n});\n\nexport let preconditionFailedError = createError({\n  status: 412,\n  code: 'precondition_failed',\n  message: 'The precondition of the request failed.'\n});\n\nexport let notAcceptableError = createError({\n  status: 406,\n  code: 'not_acceptable',\n  message: 'The requested resource is not acceptable.'\n});\n\nexport let notImplementedError = createError({\n  status: 501,\n  code: 'not_implemented',\n  message: 'The requested resource is not implemented.'\n});\n\nexport let tooManyRequestsError = createError({\n  status: 429,\n  code: 'too_many_requests',\n  message: 'You have made too many requests in a short period of time.',\n  hint: 'Please wait a moment and try again.'\n});\n\nexport let timeoutError = createError({\n  status: 504,\n  code: 'timeout',\n  message: 'The request timed out.'\n});\n\nexport let methodNotAllowedError = createError({\n  status: 405,\n  code: 'method_not_allowed',\n  message: 'The requested method is not allowed for this resource.'\n});\n"],"names":["createError","data","Object","assign","extension","_extends","__typename","toResponse","ok","ServiceError","_Error","error","_this","call","message","_parent","_proto","prototype","_createClass","setParent","parent","this","fromResponse","raw","key","get","_wrapNativeSuper","Error","isServiceError","e","validationError","d","status","code","hint","internalServerError","badRequestError","notFoundError","p1","p2","entity","id","Cases","toKebabCase","undefined","unauthorizedError","forbiddenError","invalidVersion","conflictError","goneError","paymentRequiredError","preconditionFailedError","notAcceptableError","notImplementedError","tooManyRequestsError","timeoutError","methodNotAllowedError"],"mappings":"unDAgBW,IAAAA,EAAc,SACvBC,GAEA,OAAOC,OAAOC,OACZ,SAACC,GACC,YADDA,IAAAA,IAAAA,EAA8C,CAAA,GAC7CJ,EAAWK,EAAA,CAAA,EACNJ,EACAG,GACH,EACJ,CACEE,WAAY,QACZL,KAAAA,EACAM,WAAY,WAAFF,OAAAA,EAAWC,CAAAA,WAAY,QAAkBE,IAAI,GAAmBP,EAAI,GAGpF,EAEaQ,eAAuDC,SAAAA,GASlE,SAAAD,EAA6BE,GAAiB,IAAAC,EAAA,OAC5CA,EAAAF,EAAAG,KAAMF,KAAAA,EAAMV,KAAKa,UAASF,MADCD,aAAAC,EAR7BN,WAAa,eAAuBM,EAE5BG,QAAwB,KAMHH,EAAKD,MAALA,EAAiBC,CAE9C,WAACF,KAAAD,iFAAAO,EAAAP,EAAAQ,UAqBAC,OArBAF,EAEDG,UAAA,SAAUC,GAER,OADAC,KAAKN,QAAUK,EACRC,IACT,EAACL,EAMDT,WAAA,WACE,OAAWc,KAACV,MAAMJ,YACpB,EAACE,EAEMa,aAAP,SAAoBC,GAClB,IAAItB,EAAOsB,EAIX,cAHOtB,EAAKO,UACLP,EAAKK,WAEL,IAAIG,EAAaT,EAAYC,GACtC,IAACQ,OAAAe,IAAA,SAAAC,IA3BD,WACE,OAAWJ,KAACN,OACd,GAACS,CAAAA,IAAAC,OAAAA,IAWD,WACE,OAAOJ,KAAKV,MAAMV,IACpB,iPAACyB,CApBiEhB,cAoBjEgB,EApByEC,QAmCjEC,EAAiB,SAACC,GAC3B,MAAyB,kBAAlBA,MAAAA,OAAAA,EAAAA,EAAGvB,aAAmD,uBAAlBuB,SAAAA,EAAGvB,WAChD,EClEWwB,EAAkB,SAC3BC,UAEA/B,EAAWK,EACT2B,CAAAA,OAAQ,IACRC,KAAM,eACNnB,QAAS,gCACToB,KAAM,+FACHH,GACH,EAEOI,EAAsBnC,EAAY,CAC3CgC,OAAQ,IACRC,KAAM,wBACNnB,QAAS,uCAGAsB,EAAkBpC,EAAY,CACvCgC,OAAQ,IACRC,KAAM,cACNnB,QAAS,qCAKKuB,EAAcC,EAASC,GACrC,IAAIC,EAAsB,iBAANF,EAAiBA,EAAKA,EAAGE,OACzCC,EAAkB,iBAANH,EAAiBC,EAAKD,EAAGG,GAEzC,OAAOzC,EAAWK,EAChB2B,CAAAA,OAAQ,IACRC,KAAM,YACNnB,QAAO,iBAAmB4B,EAAMC,YAAYH,GAAO,uBACnDN,KAAM,uHACNM,OAAAA,EACAC,GAAM,MAAFA,EAAAA,OAAMG,GAEO,iBAANN,EAAiB,CAAA,EAAKA,GAErC,CAEW,IAAAO,EAAoB7C,EAAY,CACzCgC,OAAQ,IACRC,KAAM,eACNnB,QAAS,kDACToB,KAAM,0FAGGY,EAAiB9C,EAAY,CACtCgC,OAAQ,IACRC,KAAM,YACNnB,QAAS,wDAGAiC,EAAiB/C,EAAY,CACtCgC,OAAQ,IACRC,KAAM,kBACNnB,QAAS,yDAGAkC,EAAgBhD,EAAY,CACrCgC,OAAQ,IACRC,KAAM,WACNnB,QAAS,uCAGAmC,EAAYjD,EAAY,CACjCgC,OAAQ,IACRC,KAAM,OACNnB,QAAS,mDAGAoC,EAAuBlD,EAAY,CAC5CgC,OAAQ,IACRC,KAAM,mBACNnB,QAAS,iDAGAqC,EAA0BnD,EAAY,CAC/CgC,OAAQ,IACRC,KAAM,sBACNnB,QAAS,4CAGAsC,EAAqBpD,EAAY,CAC1CgC,OAAQ,IACRC,KAAM,iBACNnB,QAAS,8CAGAuC,EAAsBrD,EAAY,CAC3CgC,OAAQ,IACRC,KAAM,kBACNnB,QAAS,+CAGAwC,EAAuBtD,EAAY,CAC5CgC,OAAQ,IACRC,KAAM,oBACNnB,QAAS,6DACToB,KAAM,wCAGGqB,EAAevD,EAAY,CACpCgC,OAAQ,IACRC,KAAM,UACNnB,QAAS,2BAGA0C,EAAwBxD,EAAY,CAC7CgC,OAAQ,IACRC,KAAM,qBACNnB,QAAS"}

package/dist/index.umd.js

@@ -0,0 +1,2 @@
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("@lowerdeck/case")):"function"==typeof define&&define.amd?define(["exports","@lowerdeck/case"],t):t((e||self).error={},e._case)}(this,function(e,t){function r(){return r=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var o in r)({}).hasOwnProperty.call(r,o)&&(e[o]=r[o])}return e},r.apply(null,arguments)}function o(e){return o=Object.setPrototypeOf?Object.getPrototypeOf.bind():function(e){return e.__proto__||Object.getPrototypeOf(e)},o(e)}function n(){try{var e=!Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],function(){}))}catch(e){}return(n=function(){return!!e})()}function s(e,t){return s=Object.setPrototypeOf?Object.setPrototypeOf.bind():function(e,t){return e.__proto__=t,e},s(e,t)}function i(e){var t=function(e){if("object"!=typeof e||!e)return e;var t=e[Symbol.toPrimitive];if(void 0!==t){var r=t.call(e,"string");if("object"!=typeof r)return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return String(e)}(e);return"symbol"==typeof t?t:t+""}function a(e){var t="function"==typeof Map?new Map:void 0;return a=function(e){if(null===e||!function(e){try{return-1!==Function.toString.call(e).indexOf("[native code]")}catch(t){return"function"==typeof e}}(e))return e;if("function"!=typeof e)throw new TypeError("Super expression must either be null or a function");if(void 0!==t){if(t.has(e))return t.get(e);t.set(e,r)}function r(){return function(e,t,r){if(n())return Reflect.construct.apply(null,arguments);var o=[null];o.push.apply(o,t);var i=new(e.bind.apply(e,o));return r&&s(i,r.prototype),i}(e,arguments,o(this).constructor)}return r.prototype=Object.create(e.prototype,{constructor:{value:r,enumerable:!1,writable:!0,configurable:!0}}),s(r,e)},a(e)}var u=function(e){return Object.assign(function(t){return void 0===t&&(t={}),u(r({},e,t))},{__typename:"error",data:e,toResponse:function(){return r({__typename:"error",ok:!1},e)}})},c=/*#__PURE__*/function(e){function t(t){var r;return(r=e.call(this,t.data.message)||this).error=void 0,r.__typename="ServiceError",r._parent=null,r.error=t,r}var r,o;o=e,(r=t).prototype=Object.create(o.prototype),r.prototype.constructor=r,s(r,o);var n,a,c=t.prototype;return c.setParent=function(e){return this._parent=e,this},c.toResponse=function(){return this.error.toResponse()},t.fromResponse=function(e){var r=e;return delete r.ok,delete r.__typename,new t(u(r))},n=t,(a=[{key:"parent",get:function(){return this._parent}},{key:"data",get:function(){return this.error.data}}])&&function(e,t){for(var r=0;r<t.length;r++){var o=t[r];o.enumerable=o.enumerable||!1,o.configurable=!0,"value"in o&&(o.writable=!0),Object.defineProperty(e,i(o.key),o)}}(n.prototype,a),Object.defineProperty(n,"prototype",{writable:!1}),n}(/*#__PURE__*/a(Error)),d=u({status:500,code:"internal_server_error",message:"An internal server error occurred."}),l=u({status:400,code:"bad_request",message:"The request is invalid."}),p=u({status:401,code:"unauthorized",message:"You are not authorized to access this resource.",hint:"Make sure you are logged in and have the correct permissions to access this resource."}),f=u({status:403,code:"forbidden",message:"You do not have permission to access this resource."}),y=u({status:400,code:"invalid_version",message:"The endpoint does not support the requested version."}),h=u({status:409,code:"conflict",message:"A similar resource already exists."}),m=u({status:410,code:"gone",message:"The requested resource is no longer available."}),v=u({status:402,code:"payment_required",message:"Payment is required to access this resource."}),g=u({status:412,code:"precondition_failed",message:"The precondition of the request failed."}),b=u({status:406,code:"not_acceptable",message:"The requested resource is not acceptable."}),_=u({status:501,code:"not_implemented",message:"The requested resource is not implemented."}),E=u({status:429,code:"too_many_requests",message:"You have made too many requests in a short period of time.",hint:"Please wait a moment and try again."}),O=u({status:504,code:"timeout",message:"The request timed out."}),q=u({status:405,code:"method_not_allowed",message:"The requested method is not allowed for this resource."});e.ServiceError=c,e.badRequestError=l,e.conflictError=h,e.createError=u,e.forbiddenError=f,e.goneError=m,e.internalServerError=d,e.invalidVersion=y,e.isServiceError=function(e){return"ServiceError"===(null==e?void 0:e.__typename)||"ErrorRecord"===(null==e?void 0:e.__typename)},e.methodNotAllowedError=q,e.notAcceptableError=b,e.notFoundError=function(e,o){var n="string"==typeof e?e:e.entity,s="string"==typeof e?o:e.id;return u(r({status:404,code:"not_found",message:"The requested "+t.Cases.toKebabCase(n)+" could not be found.",hint:"Make sure the resource you are trying to access exists, that you have access to it and that it has not been deleted.",entity:n,id:null!=s?s:void 0},"string"==typeof e?{}:e))},e.notImplementedError=_,e.paymentRequiredError=v,e.preconditionFailedError=g,e.timeoutError=O,e.tooManyRequestsError=E,e.unauthorizedError=p,e.validationError=function(e){return u(r({status:400,code:"invalid_data",message:"The provided data is invalid.",hint:"Make sure the data you are sending follows the specification outlined in the documentation."},e))}});
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../src/error.ts","../src/defaultErrors.ts"],"sourcesContent":["export interface ErrorData<Code extends string, Status extends number> {\n  status: Status;\n  code: Code;\n  message: string;\n  hint?: string;\n  description?: string;\n  reason?: string;\n  [key: string]: any;\n}\n\nexport type ErrorRecord<Code extends string, Status extends number> = {\n  __typename: 'error';\n  data: ErrorData<Code, Status>;\n  toResponse: () => ErrorData<Code, Status> & { __typename: 'error'; ok: false };\n} & ((extension?: Partial<ErrorData<Code, Status>>) => ErrorRecord<Code, Status>);\n\nexport let createError = <Code extends string, Status extends number>(\n  data: ErrorData<Code, Status>\n): ErrorRecord<Code, Status> => {\n  return Object.assign(\n    (extension: Partial<ErrorData<Code, Status>> = {}): ErrorRecord<Code, Status> =>\n      createError({\n        ...data,\n        ...extension\n      }),\n    {\n      __typename: 'error' as const,\n      data,\n      toResponse: () => ({ __typename: 'error' as const, ok: false as const, ...data })\n    }\n  );\n};\n\nexport class ServiceError<InnerError extends ErrorRecord<any, any>> extends Error {\n  __typename = 'ServiceError' as const;\n\n  private _parent: Error | null = null;\n\n  public get parent() {\n    return this._parent;\n  }\n\n  constructor(private readonly error: InnerError) {\n    super(error.data.message);\n  }\n\n  setParent(parent: Error) {\n    this._parent = parent;\n    return this;\n  }\n\n  get data() {\n    return this.error.data;\n  }\n\n  toResponse() {\n    return this.error.toResponse();\n  }\n\n  static fromResponse(raw: ErrorData<any, any>) {\n    let data = raw;\n    delete data.ok;\n    delete data.__typename;\n\n    return new ServiceError(createError(data));\n  }\n}\n\nexport let isServiceError = (e: any): e is ServiceError<any> => {\n  return e?.__typename === 'ServiceError' || e?.__typename === 'ErrorRecord';\n};\n","import { Cases } from '@lowerdeck/case';\nimport { ValidationError } from '@lowerdeck/validation';\nimport { ErrorData, createError } from './error';\n\nexport let validationError = (\n  d: { errors: ValidationError[]; entity: string } & Partial<ErrorData<'invalid_data', 400>>\n) =>\n  createError({\n    status: 400,\n    code: 'invalid_data',\n    message: 'The provided data is invalid.',\n    hint: 'Make sure the data you are sending follows the specification outlined in the documentation.',\n    ...d\n  });\n\nexport let internalServerError = createError({\n  status: 500,\n  code: 'internal_server_error',\n  message: 'An internal server error occurred.'\n});\n\nexport let badRequestError = createError({\n  status: 400,\n  code: 'bad_request',\n  message: 'The request is invalid.'\n});\n\nexport function notFoundError(p1: { entity: string; id?: string } & Partial<ErrorData<'not_found', 404>>): ReturnType<typeof createError>;\nexport function notFoundError(p1: string, p2?: string | null): ReturnType<typeof createError>;\nexport function notFoundError(p1: any, p2?: any): ReturnType<typeof createError> {\n  let entity = typeof p1 == 'string' ? p1 : p1.entity;\n  let id = typeof p1 == 'string' ? p2 : p1.id;\n\n  return createError({\n    status: 404,\n    code: 'not_found',\n    message: `The requested ${Cases.toKebabCase(entity)} could not be found.`,\n    hint: 'Make sure the resource you are trying to access exists, that you have access to it and that it has not been deleted.',\n    entity,\n    id: id ?? undefined,\n\n    ...(typeof p1 == 'string' ? {} : p1)\n  });\n}\n\nexport let unauthorizedError = createError({\n  status: 401,\n  code: 'unauthorized',\n  message: 'You are not authorized to access this resource.',\n  hint: 'Make sure you are logged in and have the correct permissions to access this resource.'\n});\n\nexport let forbiddenError = createError({\n  status: 403,\n  code: 'forbidden',\n  message: 'You do not have permission to access this resource.'\n});\n\nexport let invalidVersion = createError({\n  status: 400,\n  code: 'invalid_version',\n  message: 'The endpoint does not support the requested version.'\n});\n\nexport let conflictError = createError({\n  status: 409,\n  code: 'conflict',\n  message: 'A similar resource already exists.'\n});\n\nexport let goneError = createError({\n  status: 410,\n  code: 'gone',\n  message: 'The requested resource is no longer available.'\n});\n\nexport let paymentRequiredError = createError({\n  status: 402,\n  code: 'payment_required',\n  message: 'Payment is required to access this resource.'\n});\n\nexport let preconditionFailedError = createError({\n  status: 412,\n  code: 'precondition_failed',\n  message: 'The precondition of the request failed.'\n});\n\nexport let notAcceptableError = createError({\n  status: 406,\n  code: 'not_acceptable',\n  message: 'The requested resource is not acceptable.'\n});\n\nexport let notImplementedError = createError({\n  status: 501,\n  code: 'not_implemented',\n  message: 'The requested resource is not implemented.'\n});\n\nexport let tooManyRequestsError = createError({\n  status: 429,\n  code: 'too_many_requests',\n  message: 'You have made too many requests in a short period of time.',\n  hint: 'Please wait a moment and try again.'\n});\n\nexport let timeoutError = createError({\n  status: 504,\n  code: 'timeout',\n  message: 'The request timed out.'\n});\n\nexport let methodNotAllowedError = createError({\n  status: 405,\n  code: 'method_not_allowed',\n  message: 'The requested method is not allowed for this resource.'\n});\n"],"names":["createError","data","Object","assign","extension","_extends","__typename","toResponse","ok","ServiceError","_Error","error","_this","call","message","_parent","_proto","prototype","_createClass","setParent","parent","this","fromResponse","raw","key","get","_wrapNativeSuper","Error","internalServerError","status","code","badRequestError","unauthorizedError","hint","forbiddenError","invalidVersion","conflictError","goneError","paymentRequiredError","preconditionFailedError","notAcceptableError","notImplementedError","tooManyRequestsError","timeoutError","methodNotAllowedError","e","p1","p2","entity","id","Cases","toKebabCase","undefined","d"],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@lowerdeck/error",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Tobias Herber",
+  "license": "Apache 2",
+  "type": "module",
+  "source": "src/index.ts",
+  "exports": {
+    "require": "./dist/index.cjs",
+    "default": "./dist/index.modern.js"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.module.js",
+  "types": "dist/index.d.ts",
+  "unpkg": "./dist/index.umd.js",
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "lint": "prettier src/**/*.ts --check",
+    "build": "microbundle"
+  },
+  "dependencies": {
+    "@lowerdeck/case": "^1.0.0",
+    "@lowerdeck/validation": "^1.0.0"
+  },
+  "devDependencies": {
+    "microbundle": "^0.15.1",
+    "@lowerdeck/tsconfig": "^1.0.0",
+    "typescript": "5.8.2",
+    "vitest": "^3.1.2"
+  }
+}

package/src/defaultErrors.test.ts

@@ -0,0 +1,10 @@
+import { describe, expect, test } from 'vitest';
+import { validationError } from './defaultErrors';
+
+describe('validationError', () => {
+  test("should return an error object with status 400 and code 'invalid_data'", () => {
+    let error = validationError({ errors: [], entity: 'params' });
+    expect(error.data.status).toBe(400);
+    expect(error.data.code).toBe('invalid_data');
+  });
+});

package/src/defaultErrors.ts

@@ -0,0 +1,118 @@
+import { Cases } from '@lowerdeck/case';
+import { ValidationError } from '@lowerdeck/validation';
+import { ErrorData, createError } from './error';
+
+export let validationError = (
+  d: { errors: ValidationError[]; entity: string } & Partial<ErrorData<'invalid_data', 400>>
+) =>
+  createError({
+    status: 400,
+    code: 'invalid_data',
+    message: 'The provided data is invalid.',
+    hint: 'Make sure the data you are sending follows the specification outlined in the documentation.',
+    ...d
+  });
+
+export let internalServerError = createError({
+  status: 500,
+  code: 'internal_server_error',
+  message: 'An internal server error occurred.'
+});
+
+export let badRequestError = createError({
+  status: 400,
+  code: 'bad_request',
+  message: 'The request is invalid.'
+});
+
+export function notFoundError(p1: { entity: string; id?: string } & Partial<ErrorData<'not_found', 404>>): ReturnType<typeof createError>;
+export function notFoundError(p1: string, p2?: string | null): ReturnType<typeof createError>;
+export function notFoundError(p1: any, p2?: any): ReturnType<typeof createError> {
+  let entity = typeof p1 == 'string' ? p1 : p1.entity;
+  let id = typeof p1 == 'string' ? p2 : p1.id;
+
+  return createError({
+    status: 404,
+    code: 'not_found',
+    message: `The requested ${Cases.toKebabCase(entity)} could not be found.`,
+    hint: 'Make sure the resource you are trying to access exists, that you have access to it and that it has not been deleted.',
+    entity,
+    id: id ?? undefined,
+
+    ...(typeof p1 == 'string' ? {} : p1)
+  });
+}
+
+export let unauthorizedError = createError({
+  status: 401,
+  code: 'unauthorized',
+  message: 'You are not authorized to access this resource.',
+  hint: 'Make sure you are logged in and have the correct permissions to access this resource.'
+});
+
+export let forbiddenError = createError({
+  status: 403,
+  code: 'forbidden',
+  message: 'You do not have permission to access this resource.'
+});
+
+export let invalidVersion = createError({
+  status: 400,
+  code: 'invalid_version',
+  message: 'The endpoint does not support the requested version.'
+});
+
+export let conflictError = createError({
+  status: 409,
+  code: 'conflict',
+  message: 'A similar resource already exists.'
+});
+
+export let goneError = createError({
+  status: 410,
+  code: 'gone',
+  message: 'The requested resource is no longer available.'
+});
+
+export let paymentRequiredError = createError({
+  status: 402,
+  code: 'payment_required',
+  message: 'Payment is required to access this resource.'
+});
+
+export let preconditionFailedError = createError({
+  status: 412,
+  code: 'precondition_failed',
+  message: 'The precondition of the request failed.'
+});
+
+export let notAcceptableError = createError({
+  status: 406,
+  code: 'not_acceptable',
+  message: 'The requested resource is not acceptable.'
+});
+
+export let notImplementedError = createError({
+  status: 501,
+  code: 'not_implemented',
+  message: 'The requested resource is not implemented.'
+});
+
+export let tooManyRequestsError = createError({
+  status: 429,
+  code: 'too_many_requests',
+  message: 'You have made too many requests in a short period of time.',
+  hint: 'Please wait a moment and try again.'
+});
+
+export let timeoutError = createError({
+  status: 504,
+  code: 'timeout',
+  message: 'The request timed out.'
+});
+
+export let methodNotAllowedError = createError({
+  status: 405,
+  code: 'method_not_allowed',
+  message: 'The requested method is not allowed for this resource.'
+});

package/src/error.test.ts

@@ -0,0 +1,74 @@
+import { describe, expect, test } from 'vitest';
+import { ServiceError, createError } from './error';
+
+describe('createError', () => {
+  test('should create an error record with the provided data', () => {
+    let data = {
+      code: '404',
+      message: 'Not Found',
+      status: 404
+    };
+    let errorRecord = createError(data);
+    expect(errorRecord.data).toEqual(data);
+  });
+
+  test('should create an error record with a response function', () => {
+    let data = {
+      code: '404',
+      message: 'Not Found',
+      status: 404
+    };
+    let errorRecord = createError(data);
+    let response = errorRecord.toResponse();
+    expect(response).toEqual({ ...data, __typename: 'error', ok: false });
+  });
+
+  test('should create an error record with a response function that can be extended', () => {
+    let data = {
+      code: '404',
+      message: 'Not Found',
+      status: 404
+    };
+    let errorRecord = createError(data);
+    let response = errorRecord({ hint: 'This is a hint' }).toResponse();
+    expect(response).toEqual({
+      ...data,
+      __typename: 'error',
+      ok: false,
+      hint: 'This is a hint'
+    });
+  });
+});
+
+describe('ServiceError', () => {
+  test('should create an ServiceError with the provided error', () => {
+    let errorRecord = createError({
+      code: '404',
+      message: 'Not Found',
+      status: 404
+    });
+    let apiError = new ServiceError(errorRecord);
+    expect(apiError.data).toEqual(errorRecord.data);
+  });
+
+  test('should create an ServiceError with the provided error message', () => {
+    let errorRecord = createError({
+      code: '404',
+      message: 'Not Found',
+      status: 404
+    });
+    let apiError = new ServiceError(errorRecord);
+    expect(apiError.message).toEqual(errorRecord.data.message);
+  });
+
+  test('should return the error response', () => {
+    let errorRecord = createError({
+      code: '404',
+      message: 'Not Found',
+      status: 404
+    });
+    let apiError = new ServiceError(errorRecord);
+    let response = apiError.toResponse();
+    expect(response).toEqual({ ...errorRecord.data, __typename: 'error', ok: false });
+  });
+});

package/src/error.ts

@@ -0,0 +1,71 @@
+export interface ErrorData<Code extends string, Status extends number> {
+  status: Status;
+  code: Code;
+  message: string;
+  hint?: string;
+  description?: string;
+  reason?: string;
+  [key: string]: any;
+}
+
+export type ErrorRecord<Code extends string, Status extends number> = {
+  __typename: 'error';
+  data: ErrorData<Code, Status>;
+  toResponse: () => ErrorData<Code, Status> & { __typename: 'error'; ok: false };
+} & ((extension?: Partial<ErrorData<Code, Status>>) => ErrorRecord<Code, Status>);
+
+export let createError = <Code extends string, Status extends number>(
+  data: ErrorData<Code, Status>
+): ErrorRecord<Code, Status> => {
+  return Object.assign(
+    (extension: Partial<ErrorData<Code, Status>> = {}): ErrorRecord<Code, Status> =>
+      createError({
+        ...data,
+        ...extension
+      }),
+    {
+      __typename: 'error' as const,
+      data,
+      toResponse: () => ({ __typename: 'error' as const, ok: false as const, ...data })
+    }
+  );
+};
+
+export class ServiceError<InnerError extends ErrorRecord<any, any>> extends Error {
+  __typename = 'ServiceError' as const;
+
+  private _parent: Error | null = null;
+
+  public get parent() {
+    return this._parent;
+  }
+
+  constructor(private readonly error: InnerError) {
+    super(error.data.message);
+  }
+
+  setParent(parent: Error) {
+    this._parent = parent;
+    return this;
+  }
+
+  get data() {
+    return this.error.data;
+  }
+
+  toResponse() {
+    return this.error.toResponse();
+  }
+
+  static fromResponse(raw: ErrorData<any, any>) {
+    let data = raw;
+    delete data.ok;
+    delete data.__typename;
+
+    return new ServiceError(createError(data));
+  }
+}
+
+export let isServiceError = (e: any): e is ServiceError<any> => {
+  return e?.__typename === 'ServiceError' || e?.__typename === 'ErrorRecord';
+};

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './defaultErrors';
+export * from './error';

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@lowerdeck/tsconfig/base.json",
+  "exclude": ["dist"],
+  "include": ["src"],
+  "compilerOptions": {
+    "outDir": "dist",
+    "lib": ["es2021"],
+    "target": "ES2019"
+  }
+}