@c15t/backend 0.0.1-rc.10

package/dist/error/error.d.ts

@@ -0,0 +1,79 @@
+import { type ErrorCategory, type ErrorMessage } from './codes';
+/**
+ * Custom error class for c15t consent management errors.
+ *
+ * This class extends the standard Error object with additional properties
+ * specific to the c15t consent management system, such as error codes,
+ * status codes, and contextual data.
+ *
+ * @example
+ * ```typescript
+ * // Create and throw a c15t error
+ * throw new C15TError('Failed to update subject preferences', {
+ *   code: BASE_ERROR_CODES.FAILED_TO_UPDATE_CONSENT,
+ *   status: 400,
+ *   data: { subjectId: 'sub_x1pftyoufsm7xgo1kv', preferences: { analytics: true } }
+ * });
+ *
+ * // Create an error from an HTTP response
+ * const error = C15TError.fromResponse(response, await response.json());
+ * ```
+ */
+export declare class C15TError extends Error {
+    /**
+     * The error code identifying the type of error
+     */
+    code?: ErrorMessage;
+    /**
+     * HTTP status code associated with this error
+     */
+    status?: number;
+    /**
+     * Additional data providing context about the error
+     */
+    data?: Record<string, unknown>;
+    /**
+     * Category of the error for better organization
+     */
+    category?: ErrorCategory;
+    /**
+     * Creates a new C15TError instance.
+     *
+     * @param message - Human-readable error message
+     * @param options - Additional error options including code, status, and data
+     */
+    constructor(message: string, options?: {
+        /**
+         * The error code identifying the type of error
+         */
+        code?: ErrorMessage;
+        /**
+         * HTTP status code associated with this error
+         */
+        status?: number;
+        /**
+         * Additional data providing context about the error
+         */
+        data?: Record<string, unknown>;
+        /**
+         * Category of the error for better organization
+         */
+        category?: ErrorCategory;
+    });
+    /**
+     * Creates a C15TError from an HTTP response and optional response data.
+     *
+     * @param response - The HTTP Response object
+     * @param data - Optional parsed response data
+     * @returns A new C15TError instance with appropriate properties
+     */
+    static fromResponse(response: Response, data?: unknown): C15TError;
+    /**
+     * Determines if an unknown error is a C15TError.
+     *
+     * @param error - The error to check
+     * @returns True if the error is a C15TError instance
+     */
+    static isC15TError(error: unknown): error is C15TError;
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAU,SAAQ,KAAK;IACnC;;OAEG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB;;;;;OAKG;gBAEF,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT;;WAEG;QACH,IAAI,CAAC,EAAE,YAAY,CAAC;QAEpB;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAE/B;;WAEG;QACH,QAAQ,CAAC,EAAE,aAAa,CAAC;KACzB;IAgBF;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS;IAqClE;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS;CAGtD"}

package/dist/error/index.cjs

@@ -0,0 +1,172 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = function(exports1) {
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    C15TError: ()=>C15TError,
+    fromPromise: ()=>external_neverthrow_namespaceObject.fromPromise,
+    okAsync: ()=>external_neverthrow_namespaceObject.okAsync,
+    logError: ()=>logError,
+    BASE_ERROR_CODES: ()=>BASE_ERROR_CODES,
+    validationPipeline: ()=>validationPipeline,
+    retrievalPipeline: ()=>retrievalPipeline,
+    fail: ()=>fail,
+    recoverFromCodes: ()=>recoverFromCodes,
+    failAsync: ()=>failAsync,
+    safeResult: ()=>safeResult,
+    logErrorAsync: ()=>logErrorAsync,
+    ok: ()=>external_neverthrow_namespaceObject.ok,
+    recoverFromCategory: ()=>recoverFromCategory,
+    Result: ()=>external_neverthrow_namespaceObject.Result,
+    safeResultAsync: ()=>safeResultAsync
+});
+const BASE_ERROR_CODES = {
+    NOT_FOUND: 'Resource not found',
+    BAD_REQUEST: 'Bad request',
+    CONFLICT: 'Conflict with current state',
+    CONSENT_NOT_FOUND: 'Consent not found',
+    CONSENT_EXPIRED: 'Consent has expired',
+    FAILED_TO_CREATE_CONSENT: 'Failed to create consent',
+    FAILED_TO_UPDATE_CONSENT: 'Failed to update consent',
+    FAILED_TO_GET_CONSENT: 'Failed to get consent',
+    FAILED_TO_CREATE_PURPOSE: 'Failed to create consentPurpose',
+    PURPOSE_NOT_FOUND: 'Consent Purpose not found',
+    INVALID_CONFIGURATION: 'Invalid configuration',
+    MISSING_REQUIRED_PARAMETER: 'Missing required parameter',
+    UNAUTHORIZED: 'Unauthorized',
+    FORBIDDEN: 'Forbidden',
+    INTERNAL_SERVER_ERROR: 'Internal server error',
+    INITIALIZATION_FAILED: 'Initialization failed',
+    PLUGIN_INITIALIZATION_FAILED: 'Plugin initialization failed',
+    DATABASE_CONNECTION_ERROR: 'Database connection error',
+    DATABASE_QUERY_ERROR: 'Database query error',
+    REQUEST_HANDLER_ERROR: 'Request handler error',
+    API_RETRIEVAL_ERROR: 'API retrieval error',
+    INVALID_REQUEST: 'Invalid request',
+    UNKNOWN_ERROR: 'Unknown error'
+};
+class C15TError extends Error {
+    code;
+    status;
+    data;
+    category;
+    constructor(message, options){
+        super(message);
+        this.name = 'C15TError';
+        if (options) {
+            this.code = options.code;
+            this.status = options.status;
+            this.data = options.data;
+            this.category = options.category;
+        }
+        Object.setPrototypeOf(this, C15TError.prototype);
+    }
+    static fromResponse(response, data) {
+        let message = `HTTP error ${response.status}`;
+        let code;
+        let errorData;
+        if (data && 'object' == typeof data && null !== data) {
+            const errorObj = data;
+            if ('string' == typeof errorObj.message) message = errorObj.message;
+            if ('string' == typeof errorObj.code) {
+                const isKnownCode = Object.values(BASE_ERROR_CODES).includes(errorObj.code);
+                if (isKnownCode) code = errorObj.code;
+            }
+            if ('object' == typeof errorObj.data && null !== errorObj.data) errorData = errorObj.data;
+        }
+        return new C15TError(message, {
+            code,
+            status: response.status,
+            data: errorData
+        });
+    }
+    static isC15TError(error) {
+        return error instanceof C15TError;
+    }
+}
+const external_neverthrow_namespaceObject = require("neverthrow");
+const ok = (value)=>(0, external_neverthrow_namespaceObject.ok)(value);
+const fail = (message, options)=>(0, external_neverthrow_namespaceObject.err)(new C15TError(message, options));
+const failAsync = (message, options)=>external_neverthrow_namespaceObject.ResultAsync.fromSafePromise(Promise.reject(new C15TError(message, options)));
+const safeResult = (fn, errorCode = BASE_ERROR_CODES.UNKNOWN_ERROR)=>{
+    try {
+        return ok(fn());
+    } catch (error) {
+        return (0, external_neverthrow_namespaceObject.err)(new C15TError(error instanceof Error ? error.message : String(error), {
+            code: errorCode,
+            data: {
+                originalError: error
+            }
+        }));
+    }
+};
+const safeResultAsync = (promise, errorCode = BASE_ERROR_CODES.UNKNOWN_ERROR)=>external_neverthrow_namespaceObject.ResultAsync.fromPromise(promise, (error)=>new C15TError(error instanceof Error ? error.message : String(error), {
+            code: errorCode,
+            data: {
+                originalError: error
+            }
+        }));
+const recoverFromCodes = (result, errorCodes, defaultValue)=>result.orElse((error)=>{
+        if (error.code && errorCodes.includes(error.code)) return (0, external_neverthrow_namespaceObject.ok)(defaultValue);
+        return (0, external_neverthrow_namespaceObject.err)(error);
+    });
+const recoverFromCategory = (result, category, defaultValue)=>result.orElse((error)=>{
+        if (error.category === category) return (0, external_neverthrow_namespaceObject.ok)(defaultValue);
+        return (0, external_neverthrow_namespaceObject.err)(error);
+    });
+const logError = (result, logger, message = 'Error occurred:')=>result.mapErr((error)=>{
+        logger.error(`${message} ${error.message}`, {
+            code: error.code,
+            status: error.status,
+            data: error.data,
+            category: error.category,
+            stack: error.stack
+        });
+        return error;
+    });
+const logErrorAsync = (resultAsync, logger, message = 'Error occurred:')=>resultAsync.mapErr((error)=>{
+        logger.error(`${message} ${error.message}`, {
+            code: error.code,
+            status: error.status,
+            data: error.data,
+            category: error.category,
+            stack: error.stack
+        });
+        return error;
+    });
+const validationPipeline = (validator, processor)=>(input)=>{
+        const validationResult = safeResult(()=>{
+            const validationOutcome = validator(input);
+            if (false === validationOutcome) throw new Error('Validation failed');
+            if ('string' == typeof validationOutcome) throw new Error(validationOutcome);
+            return input;
+        }, BASE_ERROR_CODES.INVALID_REQUEST);
+        return validationResult.andThen((validInput)=>safeResult(()=>processor(validInput)));
+    };
+const retrievalPipeline = (fetcher, transformer)=>()=>safeResultAsync(fetcher(), BASE_ERROR_CODES.FAILED_TO_GET_CONSENT).andThen((data)=>safeResult(()=>transformer(data), BASE_ERROR_CODES.INVALID_CONFIGURATION));
+var __webpack_export_target__ = exports;
+for(var __webpack_i__ in __webpack_exports__)__webpack_export_target__[__webpack_i__] = __webpack_exports__[__webpack_i__];
+if (__webpack_exports__.__esModule) Object.defineProperty(__webpack_export_target__, '__esModule', {
+    value: true
+});

package/dist/error/index.d.ts

@@ -0,0 +1,9 @@
+export { BASE_ERROR_CODES } from './codes';
+export type { ErrorCategory, ErrorCode, ErrorMessage } from './codes';
+export { C15TError } from './error';
+export { fail, failAsync, safeResult, safeResultAsync, } from './results';
+export { recoverFromCodes, recoverFromCategory, } from './recovery';
+export { logError, logErrorAsync, } from './logging';
+export { validationPipeline, retrievalPipeline, } from './pipeline';
+export { fromPromise, okAsync, ok, Result } from 'neverthrow';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EACN,IAAI,EACJ,SAAS,EACT,UAAU,EACV,eAAe,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,gBAAgB,EAChB,mBAAmB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,QAAQ,EACR,aAAa,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/error/index.js

@@ -0,0 +1,129 @@
+import * as __WEBPACK_EXTERNAL_MODULE_neverthrow__ from "neverthrow";
+const BASE_ERROR_CODES = {
+    NOT_FOUND: 'Resource not found',
+    BAD_REQUEST: 'Bad request',
+    CONFLICT: 'Conflict with current state',
+    CONSENT_NOT_FOUND: 'Consent not found',
+    CONSENT_EXPIRED: 'Consent has expired',
+    FAILED_TO_CREATE_CONSENT: 'Failed to create consent',
+    FAILED_TO_UPDATE_CONSENT: 'Failed to update consent',
+    FAILED_TO_GET_CONSENT: 'Failed to get consent',
+    FAILED_TO_CREATE_PURPOSE: 'Failed to create consentPurpose',
+    PURPOSE_NOT_FOUND: 'Consent Purpose not found',
+    INVALID_CONFIGURATION: 'Invalid configuration',
+    MISSING_REQUIRED_PARAMETER: 'Missing required parameter',
+    UNAUTHORIZED: 'Unauthorized',
+    FORBIDDEN: 'Forbidden',
+    INTERNAL_SERVER_ERROR: 'Internal server error',
+    INITIALIZATION_FAILED: 'Initialization failed',
+    PLUGIN_INITIALIZATION_FAILED: 'Plugin initialization failed',
+    DATABASE_CONNECTION_ERROR: 'Database connection error',
+    DATABASE_QUERY_ERROR: 'Database query error',
+    REQUEST_HANDLER_ERROR: 'Request handler error',
+    API_RETRIEVAL_ERROR: 'API retrieval error',
+    INVALID_REQUEST: 'Invalid request',
+    UNKNOWN_ERROR: 'Unknown error'
+};
+class C15TError extends Error {
+    code;
+    status;
+    data;
+    category;
+    constructor(message, options){
+        super(message);
+        this.name = 'C15TError';
+        if (options) {
+            this.code = options.code;
+            this.status = options.status;
+            this.data = options.data;
+            this.category = options.category;
+        }
+        Object.setPrototypeOf(this, C15TError.prototype);
+    }
+    static fromResponse(response, data) {
+        let message = `HTTP error ${response.status}`;
+        let code;
+        let errorData;
+        if (data && 'object' == typeof data && null !== data) {
+            const errorObj = data;
+            if ('string' == typeof errorObj.message) message = errorObj.message;
+            if ('string' == typeof errorObj.code) {
+                const isKnownCode = Object.values(BASE_ERROR_CODES).includes(errorObj.code);
+                if (isKnownCode) code = errorObj.code;
+            }
+            if ('object' == typeof errorObj.data && null !== errorObj.data) errorData = errorObj.data;
+        }
+        return new C15TError(message, {
+            code,
+            status: response.status,
+            data: errorData
+        });
+    }
+    static isC15TError(error) {
+        return error instanceof C15TError;
+    }
+}
+const ok = (value)=>(0, __WEBPACK_EXTERNAL_MODULE_neverthrow__.ok)(value);
+const fail = (message, options)=>(0, __WEBPACK_EXTERNAL_MODULE_neverthrow__.err)(new C15TError(message, options));
+const failAsync = (message, options)=>__WEBPACK_EXTERNAL_MODULE_neverthrow__.ResultAsync.fromSafePromise(Promise.reject(new C15TError(message, options)));
+const safeResult = (fn, errorCode = BASE_ERROR_CODES.UNKNOWN_ERROR)=>{
+    try {
+        return ok(fn());
+    } catch (error) {
+        return (0, __WEBPACK_EXTERNAL_MODULE_neverthrow__.err)(new C15TError(error instanceof Error ? error.message : String(error), {
+            code: errorCode,
+            data: {
+                originalError: error
+            }
+        }));
+    }
+};
+const safeResultAsync = (promise, errorCode = BASE_ERROR_CODES.UNKNOWN_ERROR)=>__WEBPACK_EXTERNAL_MODULE_neverthrow__.ResultAsync.fromPromise(promise, (error)=>new C15TError(error instanceof Error ? error.message : String(error), {
+            code: errorCode,
+            data: {
+                originalError: error
+            }
+        }));
+const recoverFromCodes = (result, errorCodes, defaultValue)=>result.orElse((error)=>{
+        if (error.code && errorCodes.includes(error.code)) return (0, __WEBPACK_EXTERNAL_MODULE_neverthrow__.ok)(defaultValue);
+        return (0, __WEBPACK_EXTERNAL_MODULE_neverthrow__.err)(error);
+    });
+const recoverFromCategory = (result, category, defaultValue)=>result.orElse((error)=>{
+        if (error.category === category) return (0, __WEBPACK_EXTERNAL_MODULE_neverthrow__.ok)(defaultValue);
+        return (0, __WEBPACK_EXTERNAL_MODULE_neverthrow__.err)(error);
+    });
+const logError = (result, logger, message = 'Error occurred:')=>result.mapErr((error)=>{
+        logger.error(`${message} ${error.message}`, {
+            code: error.code,
+            status: error.status,
+            data: error.data,
+            category: error.category,
+            stack: error.stack
+        });
+        return error;
+    });
+const logErrorAsync = (resultAsync, logger, message = 'Error occurred:')=>resultAsync.mapErr((error)=>{
+        logger.error(`${message} ${error.message}`, {
+            code: error.code,
+            status: error.status,
+            data: error.data,
+            category: error.category,
+            stack: error.stack
+        });
+        return error;
+    });
+const validationPipeline = (validator, processor)=>(input)=>{
+        const validationResult = safeResult(()=>{
+            const validationOutcome = validator(input);
+            if (false === validationOutcome) throw new Error('Validation failed');
+            if ('string' == typeof validationOutcome) throw new Error(validationOutcome);
+            return input;
+        }, BASE_ERROR_CODES.INVALID_REQUEST);
+        return validationResult.andThen((validInput)=>safeResult(()=>processor(validInput)));
+    };
+const retrievalPipeline = (fetcher, transformer)=>()=>safeResultAsync(fetcher(), BASE_ERROR_CODES.FAILED_TO_GET_CONSENT).andThen((data)=>safeResult(()=>transformer(data), BASE_ERROR_CODES.INVALID_CONFIGURATION));
+var __webpack_exports__Result = __WEBPACK_EXTERNAL_MODULE_neverthrow__.Result;
+var __webpack_exports__fromPromise = __WEBPACK_EXTERNAL_MODULE_neverthrow__.fromPromise;
+var __webpack_exports__ok = __WEBPACK_EXTERNAL_MODULE_neverthrow__.ok;
+var __webpack_exports__okAsync = __WEBPACK_EXTERNAL_MODULE_neverthrow__.okAsync;
+export { BASE_ERROR_CODES, C15TError, fail, failAsync, logError, logErrorAsync, recoverFromCategory, recoverFromCodes, retrievalPipeline, safeResult, safeResultAsync, validationPipeline, __webpack_exports__Result as Result, __webpack_exports__fromPromise as fromPromise, __webpack_exports__ok as ok, __webpack_exports__okAsync as okAsync };

package/dist/error/logging.d.ts

@@ -0,0 +1,25 @@
+import type { Result, ResultAsync } from 'neverthrow';
+import type { C15TError } from './error';
+/**
+ * Logs any errors in a Result without changing the Result
+ *
+ * @param result - The Result that may contain an error
+ * @param logger - Logger instance
+ * @param message - Optional message prefix
+ * @returns The original Result unchanged
+ */
+export declare const logError: <T>(result: Result<T, C15TError>, logger: {
+    error: (message: string, ...args: unknown[]) => void;
+}, message?: string) => Result<T, C15TError>;
+/**
+ * Logs any errors in a ResultAsync without changing the ResultAsync
+ *
+ * @param resultAsync - The ResultAsync that may contain an error
+ * @param logger - Logger instance
+ * @param message - Optional message prefix
+ * @returns The original ResultAsync unchanged
+ */
+export declare const logErrorAsync: <T>(resultAsync: ResultAsync<T, C15TError>, logger: {
+    error: (message: string, ...args: unknown[]) => void;
+}, message?: string) => ResultAsync<T, C15TError>;
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/error/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACzB,QAAQ,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,EAC5B,QAAQ;IAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAAE,EAChE,gBAA2B,KACzB,MAAM,CAAC,CAAC,EAAE,SAAS,CAWrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAC9B,aAAa,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,EACtC,QAAQ;IAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAAE,EAChE,gBAA2B,KACzB,WAAW,CAAC,CAAC,EAAE,SAAS,CAW1B,CAAC"}

package/dist/error/pipeline.d.ts

@@ -0,0 +1,19 @@
+import type { Result, ResultAsync } from 'neverthrow';
+import type { C15TError } from './error';
+/**
+ * Creates a standard validation pipeline
+ *
+ * @param validator - Function that validates input
+ * @param processor - Function that processes validated input
+ * @returns A function that validates and processes input in a Result chain
+ */
+export declare const validationPipeline: <Input, Output>(validator: (input: Input) => boolean | string, processor: (input: Input) => Output) => ((input: Input) => Result<Output, C15TError>);
+/**
+ * Creates a standard async data retrieval pipeline
+ *
+ * @param fetcher - Function that fetches data
+ * @param transformer - Function that transforms fetched data
+ * @returns A function that fetches and transforms data in a ResultAsync chain
+ */
+export declare const retrievalPipeline: <RawData, TransformedData>(fetcher: () => Promise<RawData>, transformer: (data: RawData) => TransformedData) => (() => ResultAsync<TransformedData, C15TError>);
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/error/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,EAAE,MAAM,EAC/C,WAAW,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,MAAM,EAC7C,WAAW,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,KACjC,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAiB9C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,EAAE,eAAe,EACzD,SAAS,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,aAAa,CAAC,IAAI,EAAE,OAAO,KAAK,eAAe,KAC7C,CAAC,MAAM,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,CAYhD,CAAC"}

package/dist/error/recovery.d.ts

@@ -0,0 +1,22 @@
+import { type Result } from 'neverthrow';
+import type { ErrorCategory, ErrorMessage } from './codes';
+import type { C15TError } from './error';
+/**
+ * Recovers from specific error codes by transforming to a default value
+ *
+ * @param result - The result that may contain an error
+ * @param errorCodes - Array of error codes to recover from
+ * @param defaultValue - Value to use if error matches specified codes
+ * @returns A new Result with the error recovered if it matches specified codes
+ */
+export declare const recoverFromCodes: <T>(result: Result<T, C15TError>, errorCodes: ErrorMessage[], defaultValue: T) => Result<T, C15TError>;
+/**
+ * Recovers from errors of a specific category
+ *
+ * @param result - The result that may contain an error
+ * @param category - Error category to recover from
+ * @param defaultValue - Value to use if error matches specified category
+ * @returns A new Result with the error recovered if it matches the category
+ */
+export declare const recoverFromCategory: <T>(result: Result<T, C15TError>, category: ErrorCategory, defaultValue: T) => Result<T, C15TError>;
+//# sourceMappingURL=recovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/error/recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EACjC,QAAQ,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,EAC5B,YAAY,YAAY,EAAE,EAC1B,cAAc,CAAC,KACb,MAAM,CAAC,CAAC,EAAE,SAAS,CAOrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,EACpC,QAAQ,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,EAC5B,UAAU,aAAa,EACvB,cAAc,CAAC,KACb,MAAM,CAAC,CAAC,EAAE,SAAS,CAOrB,CAAC"}

package/dist/error/results.d.ts

@@ -0,0 +1,56 @@
+import { type Result, ResultAsync } from 'neverthrow';
+import { type ErrorMessage } from './codes';
+import { C15TError } from './error';
+/**
+ * Type for C15T results that can contain any error
+ */
+export type C15TResult<T> = Result<T, C15TError>;
+/**
+ * Type for C15T async results that can contain any error
+ */
+export type C15TResultAsync<T> = ResultAsync<T, C15TError>;
+/**
+ * Creates a successful result
+ */
+export declare const ok: <T>(value: T) => C15TResult<T>;
+/**
+ * Creates a standardized failure Result with a C15TError
+ *
+ * @param message - Error message
+ * @param options - Additional error options
+ * @returns A Result containing the error
+ */
+export declare const fail: <T>(message: string, options?: {
+    code?: ErrorMessage;
+    status?: number;
+    data?: Record<string, unknown>;
+}) => Result<T, C15TError>;
+/**
+ * Creates a standardized failure ResultAsync with a C15TError
+ *
+ * @param message - Error message
+ * @param options - Additional error options
+ * @returns A ResultAsync containing the error
+ */
+export declare const failAsync: <T>(message: string, options?: {
+    code?: ErrorMessage;
+    status?: number;
+    data?: Record<string, unknown>;
+}) => ResultAsync<T, C15TError>;
+/**
+ * Wraps a potentially throwing function in a Result
+ *
+ * @param fn - Function that might throw
+ * @param errorCode - Optional error code to use if fn throws
+ * @returns A Result containing either the function result or a C15TError
+ */
+export declare const safeResult: <T>(fn: () => T, errorCode?: ErrorMessage) => Result<T, C15TError>;
+/**
+ * Wraps a Promise in a ResultAsync
+ *
+ * @param promise - Promise that might reject
+ * @param errorCode - Optional error code to use if promise rejects
+ * @returns A ResultAsync containing either the promise result or a C15TError
+ */
+export declare const safeResultAsync: <T>(promise: Promise<T>, errorCode?: ErrorMessage) => ResultAsync<T, C15TError>;
+//# sourceMappingURL=results.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/error/results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,WAAW,EAAsB,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,UAAU,CAAC,CAAC,CAAmB,CAAC;AAEjE;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EACrB,SAAS,MAAM,EACf,UAAU;IACT,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,KACC,MAAM,CAAC,CAAC,EAAE,SAAS,CAErB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAC1B,SAAS,MAAM,EACf,UAAU;IACT,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,KACC,WAAW,CAAC,CAAC,EAAE,SAAS,CAI1B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAC3B,IAAI,MAAM,CAAC,EACX,YAAW,YAA6C,KACtD,MAAM,CAAC,CAAC,EAAE,SAAS,CAWrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAChC,SAAS,OAAO,CAAC,CAAC,CAAC,EACnB,YAAW,YAA6C,KACtD,WAAW,CAAC,CAAC,EAAE,SAAS,CAS1B,CAAC"}