@api-client/core 0.19.15 → 0.19.17

package/build/src/data/XmlReader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"XmlReader.d.ts","sourceRoot":"","sources":["../../../src/data/XmlReader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C;;;GAGG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO;IAuBnD,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IA8BzC,WAAW,IAAI,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAQ5C,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAOhE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAS3D,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;CA+BnE"}
+{"version":3,"file":"XmlReader.d.ts","sourceRoot":"","sources":["../../../src/data/XmlReader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C;;;GAGG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO;IAuBnD,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IA8BzC,WAAW,IAAI,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAQ5C,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAOhE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAS3D,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;CAgCnE"}

package/build/src/data/XmlReader.js

@@ -92,7 +92,8 @@ export class XmlReader extends DataReader {
         xResult = xpath.default.XPathResult;
         let errored = false;
         const parser = new DOMParser({
-            errorHandler: () => {
+            onError: (level, msg) => {
+                console.error(`[${level}] ${msg}`);
                 errored = true;
             },
         });
@@ -100,8 +101,8 @@ export class XmlReader extends DataReader {
         try {
             dom = parser.parseFromString(data, 'text/xml');
         }
-        catch {
-            //
+        catch (e) {
+            console.error(e);
         }
         if (!dom || errored) {
             return undefined;

package/build/src/data/XmlReader.js.map

@@ -1 +1 @@
-{"version":3,"file":"XmlReader.js","sourceRoot":"","sources":["../../../src/data/XmlReader.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-console */\nimport { DataReader } from './DataReader.js'\n\nlet xResult: typeof XPathResult | undefined = typeof XPathResult !== 'undefined' ? XPathResult : undefined\n\n/**\n * Reads the data from an XML using the xpath.\n * See https://www.w3schools.com/xml/xpath_syntax.asp.\n */\nexport class XmlReader extends DataReader {\n  async getValue(path: string): Promise<unknown> {\n    const doc = await this.getDocument()\n    if (!doc) {\n      return undefined\n    }\n    return this.queryDocument(path, doc)\n  }\n\n  queryDocument(path: string, doc: Document): unknown {\n    try {\n      const result = doc.evaluate(path, doc)\n      switch (result.resultType) {\n        case (xResult as typeof XPathResult).NUMBER_TYPE:\n          return result.numberValue\n        case (xResult as typeof XPathResult).STRING_TYPE:\n          return result.stringValue\n        case (xResult as typeof XPathResult).BOOLEAN_TYPE:\n          return result.booleanValue\n        case (xResult as typeof XPathResult).UNORDERED_NODE_ITERATOR_TYPE:\n        case (xResult as typeof XPathResult).ORDERED_NODE_ITERATOR_TYPE:\n          return this.processNodeResult(result)\n        default:\n          console.error(`Unsupported xpath result type: [${result.resultType}]`)\n          return undefined\n      }\n    } catch (e) {\n      console.error(e)\n      return undefined\n    }\n  }\n\n  processNodeResult(result: XPathResult): unknown {\n    const results: unknown[] = []\n    let next = result.iterateNext()\n    while (next) {\n      const value = next.textContent\n      if (value) {\n        results.push(value.trim())\n      }\n      next = result.iterateNext()\n    }\n    if (!results.length) {\n      return undefined\n    }\n\n    const mapped = results.map((item) => {\n      if (item === 'true') {\n        return true\n      }\n      if (item === 'true') {\n        return false\n      }\n      const typedNumber = Number(item)\n      if (!Number.isNaN(typedNumber)) {\n        return typedNumber\n      }\n      return item\n    })\n    return mapped.length === 1 ? mapped[0] : mapped\n  }\n\n  async getDocument(): Promise<Document | undefined> {\n    const body = await this.readPayloadAsString()\n    if (!body) {\n      return undefined\n    }\n    return this.getDocumentWithBody(body)\n  }\n\n  async getDocumentWithBody(body: string): Promise<Document | undefined> {\n    if (typeof DOMParser === 'undefined') {\n      return this.getNodeDocument(body)\n    }\n    return this.getWebDocument(body)\n  }\n\n  async getWebDocument(data: string): Promise<Document | undefined> {\n    const parser = new DOMParser()\n    const dom = parser.parseFromString(data, 'text/xml')\n    if (dom.querySelector('parsererror')) {\n      return undefined\n    }\n    return dom\n  }\n\n  async getNodeDocument(data: string): Promise<Document | undefined> {\n    const { DOMParser } = await import('@xmldom/xmldom')\n    const xpath = await import('xpath')\n    // @ts-expect-error The xpath has invalid types defined.\n    xResult = xpath.default.XPathResult\n    let errored = false\n    const parser = new DOMParser({\n      errorHandler: (): void => {\n        errored = true\n      },\n    })\n    let dom: Document | undefined\n    try {\n      dom = parser.parseFromString(data, 'text/xml') as unknown as Document\n    } catch {\n      //\n    }\n    if (!dom || errored) {\n      return undefined\n    }\n    Object.defineProperty(dom, 'evaluate', {\n      value: function (expression: string, contextNode: Node) {\n        // @ts-expect-error The xpath library has invalid types\n        return xpath.default.evaluate(expression, contextNode, null, 0, null)\n      },\n      enumerable: true, // Make the method visible in loops\n      configurable: true, // Allow the method to be deleted or redefined\n      writable: true, // Allow the method's value to be changed\n    })\n    return dom as unknown as Document\n  }\n}\n"]}
+{"version":3,"file":"XmlReader.js","sourceRoot":"","sources":["../../../src/data/XmlReader.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-console */\nimport { DataReader } from './DataReader.js'\n\nlet xResult: typeof XPathResult | undefined = typeof XPathResult !== 'undefined' ? XPathResult : undefined\n\n/**\n * Reads the data from an XML using the xpath.\n * See https://www.w3schools.com/xml/xpath_syntax.asp.\n */\nexport class XmlReader extends DataReader {\n  async getValue(path: string): Promise<unknown> {\n    const doc = await this.getDocument()\n    if (!doc) {\n      return undefined\n    }\n    return this.queryDocument(path, doc)\n  }\n\n  queryDocument(path: string, doc: Document): unknown {\n    try {\n      const result = doc.evaluate(path, doc)\n      switch (result.resultType) {\n        case (xResult as typeof XPathResult).NUMBER_TYPE:\n          return result.numberValue\n        case (xResult as typeof XPathResult).STRING_TYPE:\n          return result.stringValue\n        case (xResult as typeof XPathResult).BOOLEAN_TYPE:\n          return result.booleanValue\n        case (xResult as typeof XPathResult).UNORDERED_NODE_ITERATOR_TYPE:\n        case (xResult as typeof XPathResult).ORDERED_NODE_ITERATOR_TYPE:\n          return this.processNodeResult(result)\n        default:\n          console.error(`Unsupported xpath result type: [${result.resultType}]`)\n          return undefined\n      }\n    } catch (e) {\n      console.error(e)\n      return undefined\n    }\n  }\n\n  processNodeResult(result: XPathResult): unknown {\n    const results: unknown[] = []\n    let next = result.iterateNext()\n    while (next) {\n      const value = next.textContent\n      if (value) {\n        results.push(value.trim())\n      }\n      next = result.iterateNext()\n    }\n    if (!results.length) {\n      return undefined\n    }\n\n    const mapped = results.map((item) => {\n      if (item === 'true') {\n        return true\n      }\n      if (item === 'true') {\n        return false\n      }\n      const typedNumber = Number(item)\n      if (!Number.isNaN(typedNumber)) {\n        return typedNumber\n      }\n      return item\n    })\n    return mapped.length === 1 ? mapped[0] : mapped\n  }\n\n  async getDocument(): Promise<Document | undefined> {\n    const body = await this.readPayloadAsString()\n    if (!body) {\n      return undefined\n    }\n    return this.getDocumentWithBody(body)\n  }\n\n  async getDocumentWithBody(body: string): Promise<Document | undefined> {\n    if (typeof DOMParser === 'undefined') {\n      return this.getNodeDocument(body)\n    }\n    return this.getWebDocument(body)\n  }\n\n  async getWebDocument(data: string): Promise<Document | undefined> {\n    const parser = new DOMParser()\n    const dom = parser.parseFromString(data, 'text/xml')\n    if (dom.querySelector('parsererror')) {\n      return undefined\n    }\n    return dom\n  }\n\n  async getNodeDocument(data: string): Promise<Document | undefined> {\n    const { DOMParser } = await import('@xmldom/xmldom')\n    const xpath = await import('xpath')\n    // @ts-expect-error The xpath has invalid types defined.\n    xResult = xpath.default.XPathResult\n    let errored = false\n    const parser = new DOMParser({\n      onError: (level, msg): void => {\n        console.error(`[${level}] ${msg}`)\n        errored = true\n      },\n    })\n    let dom: Document | undefined\n    try {\n      dom = parser.parseFromString(data, 'text/xml') as unknown as Document\n    } catch (e) {\n      console.error(e)\n    }\n    if (!dom || errored) {\n      return undefined\n    }\n    Object.defineProperty(dom, 'evaluate', {\n      value: function (expression: string, contextNode: Node) {\n        // @ts-expect-error The xpath library has invalid types\n        return xpath.default.evaluate(expression, contextNode, null, 0, null)\n      },\n      enumerable: true, // Make the method visible in loops\n      configurable: true, // Allow the method to be deleted or redefined\n      writable: true, // Allow the method's value to be changed\n    })\n    return dom as unknown as Document\n  }\n}\n"]}

package/build/src/exceptions/exception.d.ts

@@ -1,3 +1,8 @@
+/**
+ * A serialized representation of an Exception.
+ * Provides a standardized structure for pure data objects,
+ * typically used when converting errors for JSON responses.
+ */
 export interface ExceptionSchema {
     name: string;
     message: string;
@@ -68,16 +73,67 @@ export declare class Exception extends Error {
      * ```
      */
     static fromRawException(init: object, defaultMessage: string): Exception;
+    /**
+     * Initializes a new Exception instance.
+     *
+     * @param message - The primary human-readable error message.
+     * @param options - Additional properties configuration. Accepts standard `ErrorOptions`
+     * (like `cause`), plus custom `code`, `status`, and `help`.
+     */
     constructor(message?: string, options?: ErrorOptions & {
         code?: string;
         status?: number;
         help?: string;
     });
+    /**
+     * Assigns a human-readable help description for troubleshooting and returns
+     * the exception instance to allow for method chaining.
+     *
+     * @param help - The detailed help informational text.
+     * @returns The current exception instance.
+     */
     setHelp(help: string): this;
+    /**
+     * Assigns a programmatic error code and returns the exception instance
+     * to allow for method chaining.
+     *
+     * @param code - The string error code (e.g., 'E_FILE_NOT_FOUND').
+     * @returns The current exception instance.
+     */
     setCode(code: string): this;
+    /**
+     * Assigns an HTTP-style status code and returns the exception instance
+     * to allow for method chaining.
+     *
+     * @param status - The numeric status code (e.g., 404, 500).
+     * @returns The current exception instance.
+     */
     setStatus(status: number): this;
+    /**
+     * Provides the string tag used by `Object.prototype.toString`.
+     */
     get [Symbol.toStringTag](): string;
+    /**
+     * Computes a string representation of the exception, including the
+     * programmatic code if one is defined.
+     */
     toString(): string;
+    /**
+     * Serializes the exception into a plain JavaScript object.
+     * This ensures safe passing across boundaries and correct format in JSON responses.
+     *
+     * @returns The serialized exception object matching `ExceptionSchema`.
+     */
     toJSON(): ExceptionSchema;
 }
+/**
+ * Converts a standard Error object (or thrown primitive) into an Exception instance.
+ * This function extracts relevant properties from the raw error
+ * and sets them on the Exception instance, allowing for a more
+ * consistent error handling experience across the application.
+ * @param error The unknown error value to convert.
+ * @param defaults Optional default properties to apply if they are missing on the Error object.
+ * @returns An Exception instance with properties set from the Error object.
+ */
+export declare function fromError(error: unknown, defaults?: Partial<ExceptionSchema>): Exception;
 //# sourceMappingURL=exception.d.ts.map

package/build/src/exceptions/exception.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exception.d.ts","sourceRoot":"","sources":["../../../src/exceptions/exception.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC3C;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC;;;OAGG;IACH,OAAe,IAAI,CAAC,EAAE,MAAM,CAAA;IAC5B,OAAe,IAAI,CAAC,EAAE,MAAM,CAAA;IAC5B,OAAe,MAAM,CAAC,EAAE,MAAM,CAAA;IAC9B,OAAe,OAAO,CAAC,EAAE,MAAM,CAAA;IAE/B;;OAEG;IACM,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACK,IAAI,CAAC,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACK,IAAI,CAAC,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS;gBAoB5D,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAsBxG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAEvB;IAEQ,QAAQ,IAAI,MAAM;IAO3B,MAAM,IAAI,eAAe;CAgB1B"}
+{"version":3,"file":"exception.d.ts","sourceRoot":"","sources":["../../../src/exceptions/exception.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC3C;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC;;;OAGG;IACH,OAAe,IAAI,CAAC,EAAE,MAAM,CAAA;IAC5B,OAAe,IAAI,CAAC,EAAE,MAAM,CAAA;IAC5B,OAAe,MAAM,CAAC,EAAE,MAAM,CAAA;IAC9B,OAAe,OAAO,CAAC,EAAE,MAAM,CAAA;IAE/B;;OAEG;IACM,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACK,IAAI,CAAC,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACK,IAAI,CAAC,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS;IAuBxE;;;;;;OAMG;gBACS,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAsBxG;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAEvB;IAED;;;OAGG;IACM,QAAQ,IAAI,MAAM;IAO3B;;;;;OAKG;IACH,MAAM,IAAI,eAAe;CAgB1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,SAAS,CA4C5F"}

package/build/src/exceptions/exception.js

@@ -43,59 +43,103 @@ export class Exception extends Error {
     static fromRawException(init, defaultMessage) {
         const typed = init;
         const options = {};
-        if (typed.code) {
-            options.code = typed.code;
+        if (typed.code !== undefined) {
+            options.code = String(typed.code);
         }
-        if (typed.status) {
-            options.status = Number(typed.status);
+        if (typed.status !== undefined) {
+            const parsedStatus = Number(typed.status);
+            if (!isNaN(parsedStatus)) {
+                options.status = parsedStatus;
+            }
         }
-        const message = typed.message ?? defaultMessage;
-        const result = new this(message, options);
-        if (typed.help) {
-            result.setHelp(typed.help);
+        if (typed.help !== undefined) {
+            options.help = String(typed.help);
         }
-        if (typed.name) {
-            result.name = typed.name;
+        const message = typed.message !== undefined ? String(typed.message) : defaultMessage;
+        const result = new this(message, options);
+        if (typed.name !== undefined) {
+            result.name = String(typed.name);
         }
         return result;
     }
+    /**
+     * Initializes a new Exception instance.
+     *
+     * @param message - The primary human-readable error message.
+     * @param options - Additional properties configuration. Accepts standard `ErrorOptions`
+     * (like `cause`), plus custom `code`, `status`, and `help`.
+     */
     constructor(message, options) {
         super(message, options);
         const ErrorConstructor = this.constructor;
         this.name = ErrorConstructor.name;
-        this.message = message || ErrorConstructor.message || '';
-        this.status = options?.status || ErrorConstructor.status || 500;
-        const code = options?.code || ErrorConstructor.code;
+        this.message = message ?? ErrorConstructor.message ?? '';
+        this.status = options?.status ?? ErrorConstructor.status ?? 500;
+        const code = options?.code ?? ErrorConstructor.code;
         if (code !== undefined) {
             this.code = code;
         }
-        const help = options?.help || ErrorConstructor.help;
+        const help = options?.help ?? ErrorConstructor.help;
         if (help !== undefined) {
             this.help = help;
         }
         Error.captureStackTrace(this, ErrorConstructor);
     }
+    /**
+     * Assigns a human-readable help description for troubleshooting and returns
+     * the exception instance to allow for method chaining.
+     *
+     * @param help - The detailed help informational text.
+     * @returns The current exception instance.
+     */
     setHelp(help) {
         this.help = help;
         return this;
     }
+    /**
+     * Assigns a programmatic error code and returns the exception instance
+     * to allow for method chaining.
+     *
+     * @param code - The string error code (e.g., 'E_FILE_NOT_FOUND').
+     * @returns The current exception instance.
+     */
     setCode(code) {
         this.code = code;
         return this;
     }
+    /**
+     * Assigns an HTTP-style status code and returns the exception instance
+     * to allow for method chaining.
+     *
+     * @param status - The numeric status code (e.g., 404, 500).
+     * @returns The current exception instance.
+     */
     setStatus(status) {
         this.status = status;
         return this;
     }
+    /**
+     * Provides the string tag used by `Object.prototype.toString`.
+     */
     get [Symbol.toStringTag]() {
         return this.constructor.name;
     }
+    /**
+     * Computes a string representation of the exception, including the
+     * programmatic code if one is defined.
+     */
     toString() {
         if (this.code) {
             return `${this.name} [${this.code}]: ${this.message}`;
         }
         return `${this.name}: ${this.message}`;
     }
+    /**
+     * Serializes the exception into a plain JavaScript object.
+     * This ensures safe passing across boundaries and correct format in JSON responses.
+     *
+     * @returns The serialized exception object matching `ExceptionSchema`.
+     */
     toJSON() {
         const result = {
             name: this.name,
@@ -113,4 +157,57 @@ export class Exception extends Error {
         return result;
     }
 }
+/**
+ * Converts a standard Error object (or thrown primitive) into an Exception instance.
+ * This function extracts relevant properties from the raw error
+ * and sets them on the Exception instance, allowing for a more
+ * consistent error handling experience across the application.
+ * @param error The unknown error value to convert.
+ * @param defaults Optional default properties to apply if they are missing on the Error object.
+ * @returns An Exception instance with properties set from the Error object.
+ */
+export function fromError(error, defaults = {}) {
+    let message;
+    let typed = {};
+    if (error instanceof Error) {
+        message = error.message;
+        typed = error;
+    }
+    else if (typeof error === 'string') {
+        message = error;
+    }
+    else if (error !== null && typeof error === 'object') {
+        typed = error;
+        if (typeof typed.message === 'string') {
+            message = typed.message;
+        }
+    }
+    const e = new Exception(message || defaults.message || 'An error occurred');
+    if (typed.code !== undefined) {
+        e.code = String(typed.code);
+    }
+    else if (defaults.code !== undefined) {
+        e.code = defaults.code;
+    }
+    if (typed.status !== undefined) {
+        const status = Number(typed.status);
+        e.status = isNaN(status) ? (defaults.status ?? 500) : status;
+    }
+    else if (defaults.status !== undefined) {
+        e.status = defaults.status;
+    }
+    if (typed.help !== undefined) {
+        e.setHelp(String(typed.help));
+    }
+    else if (defaults.help !== undefined) {
+        e.setHelp(defaults.help);
+    }
+    if (typed.name !== undefined) {
+        e.name = String(typed.name);
+    }
+    else if (defaults.name !== undefined) {
+        e.name = defaults.name;
+    }
+    return e;
+}
 //# sourceMappingURL=exception.js.map

package/build/src/exceptions/exception.js.map

@@ -1 +1 @@
-{"version":3,"file":"exception.js","sourceRoot":"","sources":["../../../src/exceptions/exception.ts"],"names":[],"mappings":"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","sourcesContent":["export interface ExceptionSchema {\n  name: string\n  message: string\n  status?: number\n  code?: string\n  help?: string\n  stack?: string\n  [key: string]: string | number | undefined\n}\n\n/**\n * Create a custom error class with the ability to define the error\n * code, status, and the help text.\n *\n * ```js\n * export class FileNotFoundException extends Exception {\n *   static status = 500\n *   static code = 'E_FILE_NOT_FOUND'\n * }\n *\n * throw new FileNotFoundException(\n *  `Unable to find file from ${filePath} location`\n * )\n * ```\n */\nexport class Exception extends Error {\n  /**\n   * Define the error metadata as static properties to avoid\n   * setting them repeatedly on the error instance\n   */\n  declare static help?: string\n  declare static code?: string\n  declare static status?: number\n  declare static message?: string\n\n  /**\n   * Name of the class that raised the exception.\n   */\n  override name: string\n\n  /**\n   * Optional help description for the error. You can use it to define additional\n   * human readable information for the error.\n   */\n  declare help?: string\n\n  /**\n   * A machine readable error code. This will allow the error handling logic\n   * to narrow down exceptions based upon the error code.\n   */\n  declare code?: string\n\n  /**\n   * A status code for the error. Usually helpful when converting errors\n   * to HTTP responses.\n   */\n  status: number\n\n  /**\n   * Create a new exception instance.\n   * It tries to extract the error code and status from the\n   * `init` object. If not found, it uses the default message.\n   * @param init - An object containing error details\n   * @param defaultMessage - A default message to use if `init.message` is not provided\n   * @returns An instance of the Exception class\n   * @example\n   * ```js\n   * const error = Exception.fromApiError({\n   *   code: 'E_FILE_NOT_FOUND',\n   *   status: 404,\n   *   message: 'File not found',\n   *   help: 'Please check the file path and try again'\n   * }, 'An error occurred while processing your request')\n   * ```\n   */\n  static fromRawException(init: object, defaultMessage: string): Exception {\n    const typed = init as Record<string, string | number>\n    const options: ErrorOptions & { code?: string; status?: number } = {}\n    if (typed.code) {\n      options.code = typed.code as string\n    }\n    if (typed.status) {\n      options.status = Number(typed.status)\n    }\n    const message = typed.message ?? defaultMessage\n    const result = new this(message as string, options)\n    if (typed.help) {\n      result.setHelp(typed.help as string)\n    }\n    if (typed.name) {\n      result.name = typed.name as string\n    }\n    return result\n  }\n\n  constructor(message?: string, options?: ErrorOptions & { code?: string; status?: number; help?: string }) {\n    super(message, options)\n\n    const ErrorConstructor = this.constructor as typeof Exception\n\n    this.name = ErrorConstructor.name\n    this.message = message || ErrorConstructor.message || ''\n    this.status = options?.status || ErrorConstructor.status || 500\n\n    const code = options?.code || ErrorConstructor.code\n    if (code !== undefined) {\n      this.code = code\n    }\n\n    const help = options?.help || ErrorConstructor.help\n    if (help !== undefined) {\n      this.help = help\n    }\n\n    Error.captureStackTrace(this, ErrorConstructor)\n  }\n\n  setHelp(help: string): this {\n    this.help = help\n    return this\n  }\n\n  setCode(code: string): this {\n    this.code = code\n    return this\n  }\n\n  setStatus(status: number): this {\n    this.status = status\n    return this\n  }\n\n  get [Symbol.toStringTag]() {\n    return this.constructor.name\n  }\n\n  override toString(): string {\n    if (this.code) {\n      return `${this.name} [${this.code}]: ${this.message}`\n    }\n    return `${this.name}: ${this.message}`\n  }\n\n  toJSON(): ExceptionSchema {\n    const result: ExceptionSchema = {\n      name: this.name,\n      message: this.message,\n    }\n    if (this.status) {\n      result.status = this.status\n    }\n    if (this.code) {\n      result.code = this.code\n    }\n    if (this.help) {\n      result.help = this.help\n    }\n    return result\n  }\n}\n"]}
+{"version":3,"file":"exception.js","sourceRoot":"","sources":["../../../src/exceptions/exception.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A serialized representation of an Exception.\n * Provides a standardized structure for pure data objects,\n * typically used when converting errors for JSON responses.\n */\nexport interface ExceptionSchema {\n  name: string\n  message: string\n  status?: number\n  code?: string\n  help?: string\n  stack?: string\n  [key: string]: string | number | undefined\n}\n\n/**\n * Create a custom error class with the ability to define the error\n * code, status, and the help text.\n *\n * ```js\n * export class FileNotFoundException extends Exception {\n *   static status = 500\n *   static code = 'E_FILE_NOT_FOUND'\n * }\n *\n * throw new FileNotFoundException(\n *  `Unable to find file from ${filePath} location`\n * )\n * ```\n */\nexport class Exception extends Error {\n  /**\n   * Define the error metadata as static properties to avoid\n   * setting them repeatedly on the error instance\n   */\n  declare static help?: string\n  declare static code?: string\n  declare static status?: number\n  declare static message?: string\n\n  /**\n   * Name of the class that raised the exception.\n   */\n  override name: string\n\n  /**\n   * Optional help description for the error. You can use it to define additional\n   * human readable information for the error.\n   */\n  declare help?: string\n\n  /**\n   * A machine readable error code. This will allow the error handling logic\n   * to narrow down exceptions based upon the error code.\n   */\n  declare code?: string\n\n  /**\n   * A status code for the error. Usually helpful when converting errors\n   * to HTTP responses.\n   */\n  status: number\n\n  /**\n   * Create a new exception instance.\n   * It tries to extract the error code and status from the\n   * `init` object. If not found, it uses the default message.\n   * @param init - An object containing error details\n   * @param defaultMessage - A default message to use if `init.message` is not provided\n   * @returns An instance of the Exception class\n   * @example\n   * ```js\n   * const error = Exception.fromApiError({\n   *   code: 'E_FILE_NOT_FOUND',\n   *   status: 404,\n   *   message: 'File not found',\n   *   help: 'Please check the file path and try again'\n   * }, 'An error occurred while processing your request')\n   * ```\n   */\n  static fromRawException(init: object, defaultMessage: string): Exception {\n    const typed = init as Record<string, string | number>\n    const options: ErrorOptions & { code?: string; status?: number; help?: string } = {}\n    if (typed.code !== undefined) {\n      options.code = String(typed.code)\n    }\n    if (typed.status !== undefined) {\n      const parsedStatus = Number(typed.status)\n      if (!isNaN(parsedStatus)) {\n        options.status = parsedStatus\n      }\n    }\n    if (typed.help !== undefined) {\n      options.help = String(typed.help)\n    }\n    const message = typed.message !== undefined ? String(typed.message) : defaultMessage\n    const result = new this(message, options)\n    if (typed.name !== undefined) {\n      result.name = String(typed.name)\n    }\n    return result\n  }\n\n  /**\n   * Initializes a new Exception instance.\n   *\n   * @param message - The primary human-readable error message.\n   * @param options - Additional properties configuration. Accepts standard `ErrorOptions`\n   * (like `cause`), plus custom `code`, `status`, and `help`.\n   */\n  constructor(message?: string, options?: ErrorOptions & { code?: string; status?: number; help?: string }) {\n    super(message, options)\n\n    const ErrorConstructor = this.constructor as typeof Exception\n\n    this.name = ErrorConstructor.name\n    this.message = message ?? ErrorConstructor.message ?? ''\n    this.status = options?.status ?? ErrorConstructor.status ?? 500\n\n    const code = options?.code ?? ErrorConstructor.code\n    if (code !== undefined) {\n      this.code = code\n    }\n\n    const help = options?.help ?? ErrorConstructor.help\n    if (help !== undefined) {\n      this.help = help\n    }\n\n    Error.captureStackTrace(this, ErrorConstructor)\n  }\n\n  /**\n   * Assigns a human-readable help description for troubleshooting and returns\n   * the exception instance to allow for method chaining.\n   *\n   * @param help - The detailed help informational text.\n   * @returns The current exception instance.\n   */\n  setHelp(help: string): this {\n    this.help = help\n    return this\n  }\n\n  /**\n   * Assigns a programmatic error code and returns the exception instance\n   * to allow for method chaining.\n   *\n   * @param code - The string error code (e.g., 'E_FILE_NOT_FOUND').\n   * @returns The current exception instance.\n   */\n  setCode(code: string): this {\n    this.code = code\n    return this\n  }\n\n  /**\n   * Assigns an HTTP-style status code and returns the exception instance\n   * to allow for method chaining.\n   *\n   * @param status - The numeric status code (e.g., 404, 500).\n   * @returns The current exception instance.\n   */\n  setStatus(status: number): this {\n    this.status = status\n    return this\n  }\n\n  /**\n   * Provides the string tag used by `Object.prototype.toString`.\n   */\n  get [Symbol.toStringTag]() {\n    return this.constructor.name\n  }\n\n  /**\n   * Computes a string representation of the exception, including the\n   * programmatic code if one is defined.\n   */\n  override toString(): string {\n    if (this.code) {\n      return `${this.name} [${this.code}]: ${this.message}`\n    }\n    return `${this.name}: ${this.message}`\n  }\n\n  /**\n   * Serializes the exception into a plain JavaScript object.\n   * This ensures safe passing across boundaries and correct format in JSON responses.\n   *\n   * @returns The serialized exception object matching `ExceptionSchema`.\n   */\n  toJSON(): ExceptionSchema {\n    const result: ExceptionSchema = {\n      name: this.name,\n      message: this.message,\n    }\n    if (this.status) {\n      result.status = this.status\n    }\n    if (this.code) {\n      result.code = this.code\n    }\n    if (this.help) {\n      result.help = this.help\n    }\n    return result\n  }\n}\n\n/**\n * Converts a standard Error object (or thrown primitive) into an Exception instance.\n * This function extracts relevant properties from the raw error\n * and sets them on the Exception instance, allowing for a more\n * consistent error handling experience across the application.\n * @param error The unknown error value to convert.\n * @param defaults Optional default properties to apply if they are missing on the Error object.\n * @returns An Exception instance with properties set from the Error object.\n */\nexport function fromError(error: unknown, defaults: Partial<ExceptionSchema> = {}): Exception {\n  let message: string | undefined\n  let typed: Record<string, string | number> = {}\n\n  if (error instanceof Error) {\n    message = error.message\n    typed = error as unknown as Record<string, string | number>\n  } else if (typeof error === 'string') {\n    message = error\n  } else if (error !== null && typeof error === 'object') {\n    typed = error as Record<string, string | number>\n    if (typeof typed.message === 'string') {\n      message = typed.message\n    }\n  }\n\n  const e = new Exception(message || defaults.message || 'An error occurred')\n\n  if (typed.code !== undefined) {\n    e.code = String(typed.code)\n  } else if (defaults.code !== undefined) {\n    e.code = defaults.code\n  }\n\n  if (typed.status !== undefined) {\n    const status = Number(typed.status)\n    e.status = isNaN(status) ? (defaults.status ?? 500) : status\n  } else if (defaults.status !== undefined) {\n    e.status = defaults.status\n  }\n\n  if (typed.help !== undefined) {\n    e.setHelp(String(typed.help))\n  } else if (defaults.help !== undefined) {\n    e.setHelp(defaults.help)\n  }\n\n  if (typed.name !== undefined) {\n    e.name = String(typed.name)\n  } else if (defaults.name !== undefined) {\n    e.name = defaults.name\n  }\n\n  return e\n}\n"]}