@zintrust/core 0.1.0

package/src/config/storage.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Storage Configuration
+ * File storage and cloud storage settings
+ * Sealed namespace for immutability
+ */
+import { Env } from './env';
+type EnvGetValue = ReturnType<typeof Env.get>;
+type EnvGetBoolValue = ReturnType<typeof Env.getBool>;
+type LocalStorageDriverConfig = {
+    driver: 'local';
+    root: EnvGetValue;
+    url: EnvGetValue;
+    visibility: EnvGetValue;
+};
+type S3StorageDriverConfig = {
+    driver: 's3';
+    key: EnvGetValue;
+    secret: EnvGetValue;
+    region: typeof Env.AWS_REGION;
+    bucket: EnvGetValue;
+    url: EnvGetValue;
+    endpoint: EnvGetValue;
+    usePathStyleUrl: EnvGetBoolValue;
+};
+type GcsStorageDriverConfig = {
+    driver: 'gcs';
+    projectId: EnvGetValue;
+    keyFile: EnvGetValue;
+    bucket: EnvGetValue;
+    url: EnvGetValue;
+};
+type StorageDrivers = {
+    local: LocalStorageDriverConfig;
+    s3: S3StorageDriverConfig;
+    gcs: GcsStorageDriverConfig;
+};
+type StorageDriverName = keyof StorageDrivers;
+type StorageDriverConfig = StorageDrivers[StorageDriverName];
+type StorageConfigRuntime = {
+    default: string;
+    drivers: StorageDrivers;
+};
+export declare const storageConfig: Readonly<{
+    /**
+     * Default storage driver
+     */
+    default: string;
+    /**
+     * Storage drivers configuration
+     */
+    drivers: {
+        local: {
+            driver: "local";
+            root: string;
+            url: string;
+            visibility: string;
+        };
+        s3: {
+            driver: "s3";
+            key: string;
+            secret: string;
+            region: string;
+            bucket: string;
+            url: string;
+            endpoint: string;
+            usePathStyleUrl: boolean;
+        };
+        gcs: {
+            driver: "gcs";
+            projectId: string;
+            keyFile: string;
+            bucket: string;
+            url: string;
+        };
+    };
+    /**
+     * Get storage driver config
+     */
+    getDriver(this: StorageConfigRuntime): StorageDriverConfig;
+    /**
+     * Temporary file settings
+     */
+    temp: {
+        path: string;
+        maxAge: number;
+    };
+    /**
+     * Uploads settings
+     */
+    uploads: {
+        maxSize: string;
+        allowedMimes: string;
+        path: string;
+    };
+    /**
+     * Backups settings
+     */
+    backups: {
+        path: string;
+        driver: string;
+    };
+}>;
+export type StorageConfig = typeof storageConfig;
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/src/config/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/config/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;AAC9C,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC;AAEtD,KAAK,wBAAwB,GAAG;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,WAAW,CAAC;IACjB,UAAU,EAAE,WAAW,CAAC;CACzB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,CAAC,UAAU,CAAC;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC;IACtB,eAAe,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,MAAM,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,WAAW,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,WAAW,CAAC;CAClB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,wBAAwB,CAAC;IAChC,EAAE,EAAE,qBAAqB,CAAC;IAC1B,GAAG,EAAE,sBAAsB,CAAC;CAC7B,CAAC;AAEF,KAAK,iBAAiB,GAAG,MAAM,cAAc,CAAC;AAC9C,KAAK,mBAAmB,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;AAE7D,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;CACzB,CAAC;AAoFF,eAAO,MAAM,aAAa;IAnExB;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BH;;OAEG;oBACa,oBAAoB,GAAG,mBAAmB;IAI1D;;OAEG;;;;;IAMH;;OAEG;;;;;;IAOH;;OAEG;;;;;EAOuD,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC"}

package/src/config/storage.js

@@ -0,0 +1,79 @@
+/**
+ * Storage Configuration
+ * File storage and cloud storage settings
+ * Sealed namespace for immutability
+ */
+import { Env } from './env';
+const isStorageDriverName = (value, drivers) => {
+    return value in drivers;
+};
+const getStorageDriver = (config) => {
+    const driverName = config.default;
+    if (isStorageDriverName(driverName, config.drivers)) {
+        return config.drivers[driverName];
+    }
+    return config.drivers.local;
+};
+const storageConfigObj = {
+    /**
+     * Default storage driver
+     */
+    default: Env.get('STORAGE_DRIVER', 'local'),
+    /**
+     * Storage drivers configuration
+     */
+    drivers: {
+        local: {
+            driver: 'local',
+            root: Env.get('STORAGE_PATH', 'storage'),
+            url: Env.get('STORAGE_URL', '/storage'),
+            visibility: Env.get('STORAGE_VISIBILITY', 'private'),
+        },
+        s3: {
+            driver: 's3',
+            key: Env.get('AWS_ACCESS_KEY_ID'),
+            secret: Env.get('AWS_SECRET_ACCESS_KEY'),
+            region: Env.AWS_REGION,
+            bucket: Env.get('AWS_S3_BUCKET'),
+            url: Env.get('AWS_S3_URL'),
+            endpoint: Env.get('AWS_S3_ENDPOINT'),
+            usePathStyleUrl: Env.getBool('AWS_S3_USE_PATH_STYLE_URL', false),
+        },
+        gcs: {
+            driver: 'gcs',
+            projectId: Env.get('GCS_PROJECT_ID'),
+            keyFile: Env.get('GCS_KEY_FILE'),
+            bucket: Env.get('GCS_BUCKET'),
+            url: Env.get('GCS_URL'),
+        },
+    },
+    /**
+     * Get storage driver config
+     */
+    getDriver() {
+        return getStorageDriver(this);
+    },
+    /**
+     * Temporary file settings
+     */
+    temp: {
+        path: Env.get('TEMP_PATH', 'storage/temp'),
+        maxAge: Env.getInt('TEMP_FILE_MAX_AGE', 86400), // 24 hours
+    },
+    /**
+     * Uploads settings
+     */
+    uploads: {
+        maxSize: Env.get('MAX_UPLOAD_SIZE', '100mb'),
+        allowedMimes: Env.get('ALLOWED_UPLOAD_MIMES', 'jpg,jpeg,png,pdf,doc,docx'),
+        path: Env.get('UPLOADS_PATH', 'storage/uploads'),
+    },
+    /**
+     * Backups settings
+     */
+    backups: {
+        path: Env.get('BACKUPS_PATH', 'storage/backups'),
+        driver: Env.get('BACKUP_DRIVER', 's3'),
+    },
+};
+export const storageConfig = Object.freeze(storageConfigObj);

package/src/container/ServiceContainer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ServiceContainer - Dependency Injection Container
+ * Manages service registration and resolution with proven dependency injection patterns
+ */
+type ServiceFactory<T = unknown> = () => T;
+export interface IServiceContainer {
+    bind<T>(key: string, factory: ServiceFactory<T>): void;
+    singleton<T>(key: string, factoryOrInstance: ServiceFactory<T> | T): void;
+    resolve<T = unknown>(key: string): T;
+    has(key: string): boolean;
+    get<T = unknown>(key: string): T;
+    flush(): void;
+}
+/**
+ * ServiceContainer - Dependency Injection Container
+ * Refactored to Functional Object pattern
+ */
+export declare const ServiceContainer: Readonly<{
+    /**
+     * Create a new service container instance
+     */
+    create(): IServiceContainer;
+}>;
+export default ServiceContainer;
+//# sourceMappingURL=ServiceContainer.d.ts.map

package/src/container/ServiceContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceContainer.d.ts","sourceRoot":"","sources":["../../../src/container/ServiceContainer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,KAAK,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,CAAC;AAQ3C,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACvD,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC1E,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;IACjC,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;cACO,iBAAiB;EAyE3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/src/container/ServiceContainer.js

@@ -0,0 +1,75 @@
+/**
+ * ServiceContainer - Dependency Injection Container
+ * Manages service registration and resolution with proven dependency injection patterns
+ */
+import { ErrorFactory } from '../exceptions/ZintrustError';
+/**
+ * ServiceContainer - Dependency Injection Container
+ * Refactored to Functional Object pattern
+ */
+export const ServiceContainer = Object.freeze({
+    /**
+     * Create a new service container instance
+     */
+    create() {
+        const bindings = new Map();
+        const singletons = new Map();
+        return {
+            /**
+             * Register a service binding
+             */
+            bind(key, factory) {
+                bindings.set(key, {
+                    factory: factory,
+                    singleton: false,
+                });
+            },
+            /**
+             * Register a singleton service (instantiated once)
+             */
+            singleton(key, factoryOrInstance) {
+                const isFactory = typeof factoryOrInstance === 'function';
+                bindings.set(key, {
+                    factory: isFactory ? factoryOrInstance : () => factoryOrInstance,
+                    singleton: true,
+                });
+            },
+            /**
+             * Resolve a service from the container
+             */
+            resolve(key) {
+                const binding = bindings.get(key);
+                if (binding === undefined) {
+                    throw ErrorFactory.createNotFoundError(`Service "${key}" is not registered in the container`, { key });
+                }
+                if (binding.singleton === true) {
+                    if (singletons.has(key) === false) {
+                        singletons.set(key, binding.factory());
+                    }
+                    return singletons.get(key);
+                }
+                return binding.factory();
+            },
+            /**
+             * Check if a service is registered
+             */
+            has(key) {
+                return bindings.has(key);
+            },
+            /**
+             * Get a service (alias for resolve)
+             */
+            get(key) {
+                return this.resolve(key);
+            },
+            /**
+             * Clear all bindings and singletons
+             */
+            flush() {
+                bindings.clear();
+                singletons.clear();
+            },
+        };
+    },
+});
+export default ServiceContainer;

package/src/database/migrations/index.d.ts

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

package/src/database/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/database/migrations/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/src/database/migrations/index.js

@@ -0,0 +1 @@
+export {};

package/src/exceptions/ZintrustError.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Base Exception Factory for Zintrust Framework
+ * Implemented as plain functions (no classes / no prototype-based constructors).
+ */
+export interface IZintrustError extends Error {
+    statusCode: number;
+    code: string;
+    details?: unknown;
+}
+type StackTraceConstructorOpt = ((...args: never[]) => unknown) | (abstract new (...args: never[]) => unknown);
+export type ZintrustErrorInit = Readonly<{
+    statusCode?: number;
+    code?: string;
+    details?: unknown;
+    name?: string;
+    prototype?: object;
+    captureStackTraceCtor?: StackTraceConstructorOpt;
+}>;
+/**
+ * Plain initializer for Zintrust framework errors.
+ */
+export declare function initZintrustError(target: Error, init?: ZintrustErrorInit): void;
+type TypedZintrustError<TCode extends string, TName extends string, TStatus extends number> = IZintrustError & {
+    readonly code: TCode;
+    name: TName;
+    readonly statusCode: TStatus;
+};
+export type ZintrustError = TypedZintrustError<'INTERNAL_ERROR', 'ZintrustError', 500>;
+export type DatabaseError = TypedZintrustError<'DATABASE_ERROR', 'DatabaseError', 500>;
+export type ValidationError = TypedZintrustError<'VALIDATION_ERROR', 'ValidationError', 400>;
+export type NotFoundError = TypedZintrustError<'NOT_FOUND', 'NotFoundError', 404>;
+export type UnauthorizedError = TypedZintrustError<'UNAUTHORIZED', 'UnauthorizedError', 401>;
+export type ForbiddenError = TypedZintrustError<'FORBIDDEN', 'ForbiddenError', 403>;
+export type ConnectionError = TypedZintrustError<'CONNECTION_ERROR', 'ConnectionError', 500>;
+export type ConfigError = TypedZintrustError<'CONFIG_ERROR', 'ConfigError', 500>;
+export type GeneralError = TypedZintrustError<'GENERAL_ERROR', 'GeneralError', 500>;
+export type CliError = TypedZintrustError<'CLI_ERROR', 'CliError', 1>;
+export type SecurityError = TypedZintrustError<'SECURITY_ERROR', 'SecurityError', 401>;
+export type CatchError = TypedZintrustError<'TRY_CATCH_ERROR', 'CatchError', 500>;
+/**
+ * Plain error creators.
+ */
+export declare function ZintrustError(message: string, details?: unknown): ZintrustError;
+export declare function createDatabaseError(message: string, details?: unknown): DatabaseError;
+export declare function createValidationError(message: string, details?: unknown): ValidationError;
+export declare function createNotFoundError(message?: string, details?: unknown): NotFoundError;
+export declare function createUnauthorizedError(message?: string, details?: unknown): UnauthorizedError;
+export declare function createForbiddenError(message?: string, details?: unknown): ForbiddenError;
+export declare function createConnectionError(message: string, details?: unknown): ConnectionError;
+export declare function createConfigError(message: string, details?: unknown): ConfigError;
+export declare function createGeneralError(message: string, details?: unknown): GeneralError;
+export declare function createCliError(message: string, details?: unknown): CliError;
+export declare function createSecurityError(message: string, details?: unknown): SecurityError;
+export declare function createTryCatchError(message: string, details?: unknown): CatchError;
+/**
+ * Backward compatibility Errors object.
+ */
+export declare const Errors: Readonly<{
+    database: (message: string, details?: unknown) => Error;
+    notFound: (message?: string, details?: unknown) => Error;
+    validation: (message: string, details?: unknown) => Error;
+    unauthorized: (message?: string, details?: unknown) => Error;
+    forbidden: (message?: string, details?: unknown) => Error;
+    connection: (message: string, details?: unknown) => Error;
+    config: (message: string, details?: unknown) => Error;
+    general: (message: string, details?: unknown) => Error;
+    cli: (message: string, details?: unknown) => Error;
+    security: (message: string, details?: unknown) => Error;
+    catchError: (message: string, details?: unknown) => Error;
+}>;
+/**
+ * Centralized ErrorFactory for creating standardized errors.
+ */
+export declare const ErrorFactory: Readonly<{
+    createDatabaseError: (message: string, details?: unknown) => DatabaseError;
+    createConnectionError: (message: string, details?: unknown) => ConnectionError;
+    createConfigError: (message: string, details?: unknown) => ConfigError;
+    createValidationError: (message: string, details?: unknown) => ValidationError;
+    createGeneralError: (message: string, details?: unknown) => GeneralError;
+    createTryCatchError: (message: string, details?: unknown) => CatchError;
+    createCliError: (message: string, details?: unknown) => CliError;
+    createSecurityError: (message: string, details?: unknown) => SecurityError;
+    createNotFoundError: (message?: string, details?: unknown) => NotFoundError;
+    createUnauthorizedError: (message?: string, details?: unknown) => UnauthorizedError;
+    createForbiddenError: (message?: string, details?: unknown) => ForbiddenError;
+}>;
+export {};
+//# sourceMappingURL=ZintrustError.d.ts.map

package/src/exceptions/ZintrustError.d.ts.map

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

package/src/exceptions/ZintrustError.js

@@ -0,0 +1,110 @@
+/**
+ * Base Exception Factory for Zintrust Framework
+ * Implemented as plain functions (no classes / no prototype-based constructors).
+ */
+import { Logger } from '../config/logger';
+/**
+ * Plain initializer for Zintrust framework errors.
+ */
+export function initZintrustError(target, init = {}) {
+    const mutable = target;
+    if (init.name !== undefined) {
+        target.name = init.name;
+    }
+    mutable.statusCode = init.statusCode ?? 500;
+    mutable.code = init.code ?? 'INTERNAL_ERROR';
+    if (init.details !== undefined) {
+        mutable.details = init.details;
+    }
+    if (init.prototype !== undefined) {
+        Object.setPrototypeOf(target, init.prototype);
+    }
+    if (Error?.captureStackTrace !== undefined) {
+        Error.captureStackTrace(target, (init.captureStackTraceCtor ?? initZintrustError));
+    }
+}
+function createTypedZintrustError(message, statusCode, code, name, details) {
+    // Use `globalThis.Error` to avoid the project's `new Error(...)` restricted syntax selector.
+    const error = new globalThis.Error(message);
+    initZintrustError(error, {
+        statusCode,
+        code,
+        details,
+        name,
+        prototype: Error.prototype,
+        captureStackTraceCtor: createTypedZintrustError,
+    });
+    return error;
+}
+/**
+ * Plain error creators.
+ */
+export function ZintrustError(message, details) {
+    return createTypedZintrustError(message, 500, 'INTERNAL_ERROR', 'ZintrustError', details);
+}
+export function createDatabaseError(message, details) {
+    return createTypedZintrustError(message, 500, 'DATABASE_ERROR', 'DatabaseError', details);
+}
+export function createValidationError(message, details) {
+    return createTypedZintrustError(message, 400, 'VALIDATION_ERROR', 'ValidationError', details);
+}
+export function createNotFoundError(message = 'Resource not found', details) {
+    return createTypedZintrustError(message, 404, 'NOT_FOUND', 'NotFoundError', details);
+}
+export function createUnauthorizedError(message = 'Unauthorized', details) {
+    return createTypedZintrustError(message, 401, 'UNAUTHORIZED', 'UnauthorizedError', details);
+}
+export function createForbiddenError(message = 'Forbidden', details) {
+    return createTypedZintrustError(message, 403, 'FORBIDDEN', 'ForbiddenError', details);
+}
+export function createConnectionError(message, details) {
+    return createTypedZintrustError(message, 500, 'CONNECTION_ERROR', 'ConnectionError', details);
+}
+export function createConfigError(message, details) {
+    return createTypedZintrustError(message, 500, 'CONFIG_ERROR', 'ConfigError', details);
+}
+export function createGeneralError(message, details) {
+    return createTypedZintrustError(message, 500, 'GENERAL_ERROR', 'GeneralError', details);
+}
+export function createCliError(message, details) {
+    return createTypedZintrustError(message, 1, 'CLI_ERROR', 'CliError', details);
+}
+export function createSecurityError(message, details) {
+    return createTypedZintrustError(message, 401, 'SECURITY_ERROR', 'SecurityError', details);
+}
+export function createTryCatchError(message, details) {
+    Logger.error(message, details);
+    return createTypedZintrustError(message, 500, 'TRY_CATCH_ERROR', 'CatchError', details);
+}
+/**
+ * Backward compatibility Errors object.
+ */
+export const Errors = Object.freeze({
+    database: (message, details) => createDatabaseError(message, details),
+    notFound: (message, details) => createNotFoundError(message ?? 'Resource not found', details),
+    validation: (message, details) => createValidationError(message, details),
+    unauthorized: (message, details) => createUnauthorizedError(message ?? 'Unauthorized', details),
+    forbidden: (message, details) => createForbiddenError(message ?? 'Forbidden', details),
+    connection: (message, details) => createConnectionError(message, details),
+    config: (message, details) => createConfigError(message, details),
+    general: (message, details) => createGeneralError(message, details),
+    cli: (message, details) => createCliError(message, details),
+    security: (message, details) => createSecurityError(message, details),
+    catchError: (message, details) => createTryCatchError(message, details),
+});
+/**
+ * Centralized ErrorFactory for creating standardized errors.
+ */
+export const ErrorFactory = Object.freeze({
+    createDatabaseError: (message, details) => createDatabaseError(message, details),
+    createConnectionError: (message, details) => createConnectionError(message, details),
+    createConfigError: (message, details) => createConfigError(message, details),
+    createValidationError: (message, details) => createValidationError(message, details),
+    createGeneralError: (message, details) => createGeneralError(message, details),
+    createTryCatchError: (message, details) => createTryCatchError(message, details),
+    createCliError: (message, details) => createCliError(message, details),
+    createSecurityError: (message, details) => createSecurityError(message, details),
+    createNotFoundError: (message, details) => createNotFoundError(message ?? 'Resource not found', details),
+    createUnauthorizedError: (message, details) => createUnauthorizedError(message ?? 'Unauthorized', details),
+    createForbiddenError: (message, details) => createForbiddenError(message ?? 'Forbidden', details),
+});

package/src/features/Auth.d.ts

@@ -0,0 +1,20 @@
+import { type Secret, type SignOptions } from 'jsonwebtoken';
+export declare const Auth: Readonly<{
+    /**
+     * Hash a password
+     */
+    hash(password: string): Promise<string>;
+    /**
+     * Compare a password with a hash
+     */
+    compare(password: string, hash: string): Promise<boolean>;
+    /**
+     * Generate a JWT token
+     */
+    generateToken(payload: Record<string, unknown>, secret: Secret, expiresIn?: NonNullable<SignOptions["expiresIn"]>): string;
+    /**
+     * Verify a JWT token
+     */
+    verifyToken<T>(token: string, secret: Secret): T;
+}>;
+//# sourceMappingURL=Auth.d.ts.map

package/src/features/Auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Auth.d.ts","sourceRoot":"","sources":["../../../src/features/Auth.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3E,eAAO,MAAM,IAAI;IACf;;OAEG;mBACkB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7C;;OAEG;sBACqB,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D;;OAEG;2BAEQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACxB,MAAM,cACH,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,GAC/C,MAAM;IAKT;;OAEG;gBACS,CAAC,SAAS,MAAM,UAAU,MAAM,GAAG,CAAC;EAGhD,CAAC"}

package/src/features/Auth.js

@@ -0,0 +1,32 @@
+// TEMPLATE_START
+import * as bcrypt from 'bcrypt';
+import { sign, verify } from 'jsonwebtoken';
+export const Auth = Object.freeze({
+    /**
+     * Hash a password
+     */
+    async hash(password) {
+        const salt = await bcrypt.genSalt(10);
+        return bcrypt.hash(password, salt);
+    },
+    /**
+     * Compare a password with a hash
+     */
+    async compare(password, hash) {
+        return bcrypt.compare(password, hash);
+    },
+    /**
+     * Generate a JWT token
+     */
+    generateToken(payload, secret, expiresIn = '1h') {
+        const options = { expiresIn };
+        return sign(payload, secret, options);
+    },
+    /**
+     * Verify a JWT token
+     */
+    verifyToken(token, secret) {
+        return verify(token, secret);
+    },
+});
+// TEMPLATE_END

package/src/features/Queue.d.ts

@@ -0,0 +1,21 @@
+export interface QueueJob {
+    id: string;
+    data: unknown;
+    timestamp: number;
+}
+/**
+ * Simple In-Memory Queue
+ * For production, replace with Redis or similar.
+ */
+export declare const Queue: Readonly<{
+    jobs: QueueJob[];
+    /**
+     * Add a job to the queue
+     */
+    add<T>(data: T): Promise<string>;
+    /**
+     * Process jobs (Placeholder)
+     */
+    process(handler: (job: QueueJob) => Promise<void>): Promise<void>;
+}>;
+//# sourceMappingURL=Queue.d.ts.map

package/src/features/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../src/features/Queue.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK;UACJ,QAAQ,EAAE;IAEtB;;OAEG;QACO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IActC;;OAEG;qBACoB,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;EAMvE,CAAC"}

package/src/features/Queue.js

@@ -0,0 +1,59 @@
+// TEMPLATE_START
+import { Logger } from '../config/logger';
+import { ErrorFactory } from '../exceptions/ZintrustError';
+/**
+ * Simple In-Memory Queue
+ * For production, replace with Redis or similar.
+ */
+export const Queue = Object.freeze({
+    jobs: [],
+    /**
+     * Add a job to the queue
+     */
+    async add(data) {
+        const id = await generateSecureJobId();
+        const job = {
+            id,
+            data,
+            timestamp: Date.now(),
+        };
+        // In a real implementation, this would push to Redis/SQS
+        Queue.jobs.push(job);
+        Logger.info(`[Queue] Job added: ${id}`);
+        return id;
+    },
+    /**
+     * Process jobs (Placeholder)
+     */
+    async process(handler) {
+        Logger.info('[Queue] Processing jobs...');
+        const jobsToProcess = [...Queue.jobs];
+        Queue.jobs.length = 0;
+        await Promise.all(jobsToProcess.map(async (job) => handler(job)));
+    },
+});
+async function generateSecureJobId() {
+    if (typeof globalThis.crypto?.randomUUID === 'function') {
+        return globalThis.crypto.randomUUID();
+    }
+    if (typeof globalThis.crypto?.getRandomValues === 'function') {
+        const bytes = new Uint8Array(16);
+        globalThis.crypto.getRandomValues(bytes);
+        return bytesToHex(bytes);
+    }
+    // Node fallback for environments without Web Crypto
+    try {
+        const nodeCrypto = await import('node:crypto');
+        return nodeCrypto.randomBytes(16).toString('hex');
+    }
+    catch (error) {
+        throw ErrorFactory.createTryCatchError('Secure crypto API not available to generate a job id.', error);
+    }
+}
+function bytesToHex(bytes) {
+    let out = '';
+    for (const b of bytes)
+        out += b.toString(16).padStart(2, '0');
+    return out;
+}
+// TEMPLATE_END

package/src/functions/cloudflare.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    fetch(request: Request, _env: unknown, _ctx: unknown): Promise<Response>;
+};
+export default _default;
+//# sourceMappingURL=cloudflare.d.ts.map

package/src/functions/cloudflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../../src/functions/cloudflare.ts"],"names":[],"mappings":";mBAsBuB,OAAO,QAAQ,OAAO,QAAQ,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;AADhF,wBAqBE"}