@c15t/backend 0.0.1-rc.10

package/dist/db/schema/subject/table.d.ts

@@ -0,0 +1,136 @@
+import type { Field } from '../../core/fields';
+import type { C15TOptions } from '../../../types';
+/**
+ * Generates the database table configuration for the subject entity.
+ *
+ * This function creates a schema definition that includes all standard subject fields
+ * and any additional fields from plugins or configuration. The resulting schema is used
+ * for database migrations, schema validation, and query building.
+ *
+ * @param options - C15T configuration options that may contain subject table customizations
+ * @param subjectFields - Additional fields from plugins to include in the subject table
+ * @returns A complete table schema definition with fields, model name, and metadata
+ *
+ * @example
+ * ```typescript
+ * const subjectTableSchema = getSubjectTable(c15tOptions);
+ * // Use the schema for migrations or data access
+ * const migrationPlans = generateMigrations(subjectTableSchema);
+ * ```
+ */
+export declare function getSubjectTable(options: C15TOptions, subjectFields?: Record<string, Field>): {
+    /**
+     * The name of the subject table in the database, configurable through options
+     */
+    entityName: string;
+    /**
+     * The ID prefix for the subject table
+     * Used to generate unique prefixed IDs for subjects
+     */
+    entityPrefix: string;
+    /**
+     * The Zod schema for the subject table
+     */
+    schema: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        isIdentified: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        externalId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        identityProvider: import("zod").ZodOptional<import("zod").ZodString>;
+        lastIpAddress: import("zod").ZodOptional<import("zod").ZodString>;
+        createdAt: import("zod").ZodDefault<import("zod").ZodDate>;
+        updatedAt: import("zod").ZodDefault<import("zod").ZodDate>;
+    }, "strip", import("zod").ZodTypeAny, {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        isIdentified: boolean;
+        externalId?: string | null | undefined;
+        identityProvider?: string | undefined;
+        lastIpAddress?: string | undefined;
+    }, {
+        id: string;
+        createdAt?: Date | undefined;
+        updatedAt?: Date | undefined;
+        isIdentified?: boolean | undefined;
+        externalId?: string | null | undefined;
+        identityProvider?: string | undefined;
+        lastIpAddress?: string | undefined;
+    }>;
+    /**
+     * Field definitions for the subject table
+     */
+    fields: {
+        /**
+         * Whether the subject has been identified/verified
+         * Default: false
+         */
+        isIdentified: {
+            type: string;
+            defaultValue: () => boolean;
+            required: boolean;
+            fieldName: string;
+        };
+        /**
+         * External identifier for the subject (from auth providers)
+         * Optional field
+         */
+        externalId: {
+            type: string;
+            required: boolean;
+            fieldName: string;
+        };
+        /**
+         * The provider that identified this subject (e.g., 'auth0', 'okta')
+         * Optional field
+         */
+        identityProvider: {
+            type: string;
+            required: boolean;
+            fieldName: string;
+        };
+        /**
+         * Last known IP address of the subject
+         * Optional field, useful for security and audit purposes
+         */
+        lastIpAddress: {
+            type: string;
+            required: boolean;
+            fieldName: string;
+        };
+        /**
+         * When the subject was created
+         * Automatically set to current time by default
+         */
+        createdAt: {
+            type: string;
+            defaultValue: () => Date;
+            required: boolean;
+            fieldName: string;
+        };
+        /**
+         * When the subject was last updated
+         * Automatically set to current time on update
+         */
+        updatedAt: {
+            type: string;
+            defaultValue: () => Date;
+            required: boolean;
+            fieldName: string;
+        };
+        /**
+         * Subject's local timezone, stored as IANA timezone identifier
+         */
+        subjectTimezone: {
+            type: string;
+            required: boolean;
+            defaultValue: "UTC";
+            fieldName: string;
+        };
+    };
+    /**
+     * Execution order during migrations (lower numbers run first)
+     * Subject table needs to be created early as other tables reference it
+     */
+    order: number;
+};
+//# sourceMappingURL=table.d.ts.map

package/dist/db/schema/subject/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/db/schema/subject/table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,WAAW,EACpB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAMpC;;OAEG;;IAGH;;;OAGG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH;;OAEG;;QAEF;;;WAGG;;;;;;;QAQH;;;WAGG;;;;;;QAOH;;;WAGG;;;;;;QAQH;;;WAGG;;;;;;QAOH;;;WAGG;;;;;;;QAQH;;;WAGG;;;;;;;QAQH;;WAEG;;;;;;;;IAeJ;;;OAGG;;EAGJ"}

package/dist/db/schema/subject/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Subject Entity Type Definitions
+ *
+ * This module contains type definitions specific to the subject entity.
+ */
+import type { TimestampedEntityConfig } from '../types';
+/**
+ * Subject entity configuration
+ * @default entityName: "subject", entityPrefix: "sub"
+ */
+export interface SubjectEntityConfig extends TimestampedEntityConfig {
+    fields?: Record<string, string> & {
+        id?: string;
+        isIdentified?: string;
+        externalId?: string;
+        identityProvider?: string;
+        lastIpAddress?: string;
+        createdAt?: string;
+        updatedAt?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/db/schema/subject/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/db/schema/subject/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QACjC,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACF"}

package/dist/db/schema/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Database Schema Type Definitions
+ *
+ * This module contains base type definitions for database schema configuration.
+ * These types define the common structure of entity configurations used throughout
+ * the c15t consent management system.
+ */
+import type { Field } from '../core/fields';
+import type { AuditLogEntityConfig } from './audit-log/types';
+import type { ConsentGeoLocationEntityConfig } from './consent-geo-location/types';
+import type { ConsentPolicyEntityConfig } from './consent-policy/types';
+import type { ConsentPurposeJunctionEntityConfig } from './consent-purpose-junction/types';
+import type { ConsentPurposeEntityConfig } from './consent-purpose/types';
+import type { ConsentRecordEntityConfig } from './consent-record/types';
+import type { ConsentWithdrawalEntityConfig } from './consent-withdrawal/types';
+import type { ConsentEntityConfig } from './consent/types';
+import type { DomainEntityConfig } from './domain/types';
+import type { GeoLocationEntityConfig } from './geo-location/types';
+import type { SubjectEntityConfig } from './subject/types';
+/**
+ * Base entity configuration shared by all entities
+ * Provides common configuration options for database entities
+ */
+export interface BaseEntityConfig {
+    /**
+     * Custom model name for the entity table
+     */
+    entityName?: string;
+    /**
+     * The ID prefix for the entity table
+     * Used to generate unique prefixed IDs
+     */
+    entityPrefix?: string;
+    /**
+     * Custom field names for the entity table
+     */
+    fields?: Record<string, string>;
+    /**
+     * Additional fields for the entity table
+     */
+    additionalFields?: Record<string, Field>;
+}
+/**
+ * Entity configuration with standard timestamps
+ * Extends base configuration with created/updated timestamp fields
+ */
+export interface TimestampedEntityConfig extends BaseEntityConfig {
+    fields?: Record<string, string> & {
+        createdAt?: string;
+        updatedAt?: string;
+    };
+}
+/**
+ * Entity configuration for entities with active status
+ * Extends timestamped configuration with isActive field
+ */
+export interface ActiveEntityConfig extends TimestampedEntityConfig {
+    fields?: Record<string, string> & {
+        createdAt?: string;
+        updatedAt?: string;
+        isActive?: string;
+    };
+}
+/**
+ * Database tables configuration
+ * Contains all entity table configurations in one unified object
+ */
+export interface TablesConfig {
+    /**
+     * Subject entity configuration
+     * @default entityName: "subject", entityPrefix: "sub"
+     */
+    subject?: SubjectEntityConfig;
+    /**
+     * Domain configuration
+     * @default entityName: "domain", entityPrefix: "dom"
+     */
+    domain?: DomainEntityConfig;
+    /**
+     * Geo location configuration
+     * @default entityName: "geoLocation", entityPrefix: "geo"
+     */
+    geoLocation?: GeoLocationEntityConfig;
+    /**
+     * ConsentPurpose entity configuration
+     * @default entityName: "consentPurpose", entityPrefix: "pur"
+     */
+    consentPurpose?: ConsentPurposeEntityConfig;
+    /**
+     * Consent policy configuration
+     * @default entityName: "consentPolicy", entityPrefix: "pol"
+     */
+    consentPolicy?: ConsentPolicyEntityConfig;
+    /**
+     * Consent configuration
+     * @default entityName: "consent", entityPrefix: "cns"
+     */
+    consent?: ConsentEntityConfig;
+    /**
+     * ConsentPurpose junction configuration
+     * @default entityName: "consentPurposeJunction", entityPrefix: "pjx"
+     */
+    consentPurposeJunction?: ConsentPurposeJunctionEntityConfig;
+    /**
+     * Consent geo location configuration
+     * @default entityName: "consentGeoLocation", entityPrefix: "cgl"
+     */
+    consentGeoLocation?: ConsentGeoLocationEntityConfig;
+    /**
+     * Record entity configuration
+     * @default entityName: "record", entityPrefix: "rec"
+     */
+    record?: ConsentRecordEntityConfig;
+    /**
+     * Withdrawal configuration
+     * @default entityName: "consentWithdrawal", entityPrefix: "wdr"
+     */
+    consentWithdrawal?: ConsentWithdrawalEntityConfig;
+    /**
+     * Audit log configuration
+     * @default entityName: "auditLog", entityPrefix: "log"
+     */
+    auditLog?: AuditLogEntityConfig;
+}
+export type { AuditLogEntityConfig } from './audit-log/types';
+export type { ConsentEntityConfig } from './consent/types';
+export type { ConsentGeoLocationEntityConfig } from './consent-geo-location/types';
+export type { ConsentPolicyEntityConfig } from './consent-policy/types';
+export type { ConsentPurposeEntityConfig } from './consent-purpose/types';
+export type { ConsentPurposeJunctionEntityConfig } from './consent-purpose-junction/types';
+export type { ConsentRecordEntityConfig } from './consent-record/types';
+export type { ConsentWithdrawalEntityConfig } from './consent-withdrawal/types';
+export type { DomainEntityConfig } from './domain/types';
+export type { GeoLocationEntityConfig } from './geo-location/types';
+export type { SubjectEntityConfig } from './subject/types';
+//# sourceMappingURL=types.d.ts.map

package/dist/db/schema/types.d.ts.map

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

package/dist/db/utils/adapter-factory.d.ts

@@ -0,0 +1,21 @@
+import type { C15TOptions } from '../../types';
+/**
+ * Creates and configures the appropriate database adapter based on C15T options
+ *
+ * This function handles several scenarios:
+ * 1. No database configuration - creates an in-memory adapter (development only)
+ * 2. Custom database function - uses the provided function to create an adapter
+ * 3. Standard database config - creates a Kysely adapter with the specified database
+ *
+ * @param options - The C15T configuration options
+ * @returns A configured database adapter instance
+ * @throws {C15TError} If the database adapter initialization fails
+ *
+ * @example
+ * ```typescript
+ * const adapter = await getAdapter(config);
+ * const subjects = await adapter.findMany('subject', { where: { active: true } });
+ * ```
+ */
+export declare function getAdapter(options: C15TOptions): Promise<import("../adapters/types").Adapter>;
+//# sourceMappingURL=adapter-factory.d.ts.map

package/dist/db/utils/adapter-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-factory.d.ts","sourceRoot":"","sources":["../../../src/db/utils/adapter-factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,gDAqCpD"}

package/dist/db/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Database Utilities Module
+ *
+ * This module provides various utility functions for database operations,
+ * including adapter creation and data conversion between application and database formats.
+ *
+ * @module db/utils
+ */
+export { getAdapter } from './adapter-factory';
+//# sourceMappingURL=index.d.ts.map

package/dist/db/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/db/utils.d.ts

@@ -0,0 +1,4 @@
+import type { C15TOptions } from '../types';
+import type { Adapter } from './adapters/types';
+export declare function getAdapter(options: C15TOptions): Promise<Adapter>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/db/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/db/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAK3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCvE"}

package/dist/error/codes.cjs

@@ -0,0 +1,68 @@
+"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__, {
+    BASE_ERROR_CODES: ()=>BASE_ERROR_CODES,
+    ERROR_CATEGORIES: ()=>ERROR_CATEGORIES
+});
+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'
+};
+const ERROR_CATEGORIES = {
+    VALIDATION: 'validation',
+    AUTHORIZATION: 'authorization',
+    STORAGE: 'storage',
+    NETWORK: 'network',
+    PLUGIN: 'plugin',
+    CONFIGURATION: 'configuration',
+    UNEXPECTED: 'unexpected'
+};
+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/codes.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Standardized error codes for the c15t consent management system.
+ *
+ * These error codes are used throughout the application to provide consistent
+ * error messages and enable proper error handling in client applications.
+ * Each error code represents a specific type of error that can occur during
+ * consent management operations.
+ *
+ * @example
+ * ```typescript
+ * import { BASE_ERROR_CODES, C15TError } from '@c15t/error';
+ *
+ * // Handle a specific error
+ * try {
+ *   await consentManager.updateConsent(consentId, preferences);
+ * } catch (error) {
+ *   if (error instanceof C15TError && error.code === BASE_ERROR_CODES.CONSENT_NOT_FOUND) {
+ *     // Handle the specific case where consent is not found
+ *     console.error('Cannot update: consent record does not exist');
+ *   } else {
+ *     // Handle other errors
+ *     console.error('Failed to update consent:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export declare const BASE_ERROR_CODES: {
+    /**
+     * The requested resource could not be found.
+     * This is a general error for when a requested entity does not exist.
+     */
+    readonly NOT_FOUND: "Resource not found";
+    /**
+     * The request is invalid or malformed.
+     * This is a general error for requests that do not meet the expected format.
+     */
+    readonly BAD_REQUEST: "Bad request";
+    /**
+     * The request conflicts with the current state of the server.
+     * This may occur when trying to create a resource that already exists or
+     * when attempting to modify a resource in a way that conflicts with its current state.
+     */
+    readonly CONFLICT: "Conflict with current state";
+    /**
+     * The requested consent record could not be found.
+     * This may occur when attempting to retrieve, update, or delete a non-existent consent record.
+     */
+    readonly CONSENT_NOT_FOUND: "Consent not found";
+    /**
+     * The consent record has expired and is no longer valid.
+     * This may occur when attempting to use a consent record after its expiration date.
+     */
+    readonly CONSENT_EXPIRED: "Consent has expired";
+    /**
+     * An error occurred while attempting to create a new consent record.
+     * This may be due to validation errors, storage issues, or other internal errors.
+     */
+    readonly FAILED_TO_CREATE_CONSENT: "Failed to create consent";
+    /**
+     * An error occurred while attempting to update an existing consent record.
+     * This may be due to validation errors, storage issues, or concurrent modifications.
+     */
+    readonly FAILED_TO_UPDATE_CONSENT: "Failed to update consent";
+    /**
+     * An error occurred while attempting to retrieve a consent record.
+     * This may be due to storage issues, permissions, or other internal errors.
+     */
+    readonly FAILED_TO_GET_CONSENT: "Failed to get consent";
+    /**
+     * An error occurred while attempting to create a new consent consentPurpose.
+     * This may be due to validation errors, duplicate consentPurpose IDs, or other internal errors.
+     */
+    readonly FAILED_TO_CREATE_PURPOSE: "Failed to create consentPurpose";
+    /**
+     * The requested consent consentPurpose could not be found.
+     * This may occur when attempting to retrieve, update, or delete a non-existent consentPurpose.
+     */
+    readonly PURPOSE_NOT_FOUND: "Consent Purpose not found";
+    /**
+     * The provided configuration is invalid or contains errors.
+     * This may occur when initializing the system with incorrect settings.
+     */
+    readonly INVALID_CONFIGURATION: "Invalid configuration";
+    /**
+     * A required parameter is missing from the request.
+     * This may occur when API calls are made without all necessary data.
+     */
+    readonly MISSING_REQUIRED_PARAMETER: "Missing required parameter";
+    /**
+     * The request requires authentication that was not provided or is invalid.
+     * This may occur when attempting to access protected resources without proper credentials.
+     */
+    readonly UNAUTHORIZED: "Unauthorized";
+    /**
+     * The requester does not have permission to perform the requested operation.
+     * This may occur when authenticated subjects attempt operations beyond their permission level.
+     */
+    readonly FORBIDDEN: "Forbidden";
+    /**
+     * An unexpected internal error occurred on the server.
+     * This is a general error for unexpected exceptions during request processing.
+     */
+    readonly INTERNAL_SERVER_ERROR: "Internal server error";
+    /**
+     * Initialization of the system failed.
+     * This may occur when the system cannot be initialized due to configuration
+     * errors, missing dependencies, or other setup issues.
+     */
+    readonly INITIALIZATION_FAILED: "Initialization failed";
+    /**
+     * Plugin initialization failed.
+     * This may occur when a plugin cannot be initialized due to configuration
+     * errors, missing dependencies, or other setup issues.
+     */
+    readonly PLUGIN_INITIALIZATION_FAILED: "Plugin initialization failed";
+    /**
+     * Database connection error.
+     * This may occur when the system cannot connect to the database due to
+     * connection issues, authentication failures, or other database-related problems.
+     */
+    readonly DATABASE_CONNECTION_ERROR: "Database connection error";
+    /**
+     * Database query error.
+     * This may occur when a database query fails due to syntax errors,
+     * constraint violations, or other database-related issues.
+     */
+    readonly DATABASE_QUERY_ERROR: "Database query error";
+    /**
+     * An error occurred while attempting to handle a request.
+     * This may occur when a request cannot be processed due to invalid input,
+     * internal errors, or other issues.
+     */
+    readonly REQUEST_HANDLER_ERROR: "Request handler error";
+    /**
+     * Error retrieving API endpoints.
+     * This may occur when the system cannot retrieve API endpoints due to
+     * configuration errors or other internal issues.
+     */
+    readonly API_RETRIEVAL_ERROR: "API retrieval error";
+    /**
+     * The request is invalid or malformed.
+     * This is a specific error for requests that do not meet the expected format.
+     */
+    readonly INVALID_REQUEST: "Invalid request";
+    /**
+     * Unknown or unclassified error.
+     * Used when an error occurs that doesn't match any other error code.
+     */
+    readonly UNKNOWN_ERROR: "Unknown error";
+};
+/**
+ * Error categories for organizing errors by domain
+ */
+export declare const ERROR_CATEGORIES: {
+    readonly VALIDATION: "validation";
+    readonly AUTHORIZATION: "authorization";
+    readonly STORAGE: "storage";
+    readonly NETWORK: "network";
+    readonly PLUGIN: "plugin";
+    readonly CONFIGURATION: "configuration";
+    readonly UNEXPECTED: "unexpected";
+};
+/**
+ * Type for error categories
+ */
+export type ErrorCategory = (typeof ERROR_CATEGORIES)[keyof typeof ERROR_CATEGORIES];
+/**
+ * Type containing all possible error codes from the BASE_ERROR_CODES object
+ */
+export type ErrorCode = keyof typeof BASE_ERROR_CODES;
+/**
+ * Type for the error message values in BASE_ERROR_CODES
+ */
+export type ErrorMessage = (typeof BASE_ERROR_CODES)[ErrorCode];
+//# sourceMappingURL=codes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/error/codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,gBAAgB;IAC5B;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;;OAIG;;IAGH;;;;OAIG;;IAGH;;;;OAIG;;IAGH;;;;OAIG;;IAGH;;;;OAIG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEM,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;CAQnB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,aAAa,GACxB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC"}

package/dist/error/codes.js

@@ -0,0 +1,35 @@
+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'
+};
+const ERROR_CATEGORIES = {
+    VALIDATION: 'validation',
+    AUTHORIZATION: 'authorization',
+    STORAGE: 'storage',
+    NETWORK: 'network',
+    PLUGIN: 'plugin',
+    CONFIGURATION: 'configuration',
+    UNEXPECTED: 'unexpected'
+};
+export { BASE_ERROR_CODES, ERROR_CATEGORIES };