@arcraz/common 1.0.0

package/dist/aws/s3/operations.js

@@ -0,0 +1,234 @@
+import { PutObjectCommand, GetObjectCommand, DeleteObjectCommand, DeleteObjectsCommand, HeadObjectCommand, ListObjectsV2Command, CopyObjectCommand } from '@aws-sdk/client-s3';
+import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+/**
+ * Uploads data to S3
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param key Object key
+ * @param body Data to upload
+ * @param options Upload options
+ */
+export async function upload(s3, bucket, key, body, options = {}) {
+    const command = new PutObjectCommand({
+        Bucket: bucket,
+        Key: key,
+        Body: body,
+        ContentType: options.contentType,
+        CacheControl: options.cacheControl,
+        ContentDisposition: options.contentDisposition,
+        Metadata: options.metadata,
+        ACL: options.acl,
+        ServerSideEncryption: options.serverSideEncryption,
+        StorageClass: options.storageClass
+    });
+    await s3.client.send(command);
+}
+/**
+ * Downloads an object from S3
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param key Object key
+ * @param options Download options
+ * @returns Object body as a readable stream
+ */
+export async function download(s3, bucket, key, options = {}) {
+    const command = new GetObjectCommand({
+        Bucket: bucket,
+        Key: key,
+        Range: options.range,
+        IfModifiedSince: options.ifModifiedSince,
+        IfUnmodifiedSince: options.ifUnmodifiedSince
+    });
+    const response = await s3.client.send(command);
+    return response.Body || null;
+}
+/**
+ * Downloads an object as a buffer
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param key Object key
+ * @returns Object body as a buffer
+ */
+export async function downloadAsBuffer(s3, bucket, key) {
+    const stream = await download(s3, bucket, key);
+    if (!stream)
+        return null;
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks);
+}
+/**
+ * Downloads an object as a string
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param key Object key
+ * @param encoding String encoding
+ * @returns Object body as a string
+ */
+export async function downloadAsString(s3, bucket, key, encoding = 'utf-8') {
+    const buffer = await downloadAsBuffer(s3, bucket, key);
+    return buffer ? buffer.toString(encoding) : null;
+}
+/**
+ * Deletes an object from S3
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param key Object key
+ */
+export async function deleteObject(s3, bucket, key) {
+    const command = new DeleteObjectCommand({
+        Bucket: bucket,
+        Key: key
+    });
+    await s3.client.send(command);
+}
+/**
+ * Deletes multiple objects from S3
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param keys Object keys to delete
+ */
+export async function deleteObjects(s3, bucket, keys) {
+    if (keys.length === 0)
+        return;
+    const command = new DeleteObjectsCommand({
+        Bucket: bucket,
+        Delete: {
+            Objects: keys.map((key) => ({ Key: key }))
+        }
+    });
+    await s3.client.send(command);
+}
+/**
+ * Checks if an object exists in S3
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param key Object key
+ * @returns True if object exists
+ */
+export async function exists(s3, bucket, key) {
+    try {
+        const command = new HeadObjectCommand({
+            Bucket: bucket,
+            Key: key
+        });
+        await s3.client.send(command);
+        return true;
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'name' in error && error.name === 'NotFound') {
+            return false;
+        }
+        throw error;
+    }
+}
+/**
+ * Gets object metadata from S3
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param key Object key
+ * @returns Object metadata or null if not found
+ */
+export async function getMetadata(s3, bucket, key) {
+    try {
+        const command = new HeadObjectCommand({
+            Bucket: bucket,
+            Key: key
+        });
+        const response = await s3.client.send(command);
+        return {
+            key,
+            size: response.ContentLength,
+            lastModified: response.LastModified,
+            etag: response.ETag,
+            storageClass: response.StorageClass
+        };
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'name' in error && error.name === 'NotFound') {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Lists objects in an S3 bucket
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param options List options
+ * @returns List of object metadata and continuation token
+ */
+export async function listObjects(s3, bucket, options = {}) {
+    const command = new ListObjectsV2Command({
+        Bucket: bucket,
+        Prefix: options.prefix,
+        Delimiter: options.delimiter,
+        MaxKeys: options.maxKeys,
+        ContinuationToken: options.continuationToken
+    });
+    const response = await s3.client.send(command);
+    const objects = (response.Contents || []).map((item) => ({
+        key: item.Key || '',
+        size: item.Size,
+        lastModified: item.LastModified,
+        etag: item.ETag,
+        storageClass: item.StorageClass
+    }));
+    return {
+        objects,
+        continuationToken: response.NextContinuationToken
+    };
+}
+/**
+ * Copies an object within S3
+ * @param s3 S3 instance
+ * @param sourceBucket Source bucket
+ * @param sourceKey Source key
+ * @param destBucket Destination bucket
+ * @param destKey Destination key
+ */
+export async function copyObject(s3, sourceBucket, sourceKey, destBucket, destKey) {
+    const command = new CopyObjectCommand({
+        CopySource: `${sourceBucket}/${sourceKey}`,
+        Bucket: destBucket,
+        Key: destKey
+    });
+    await s3.client.send(command);
+}
+/**
+ * Generates a presigned URL for downloading
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param key Object key
+ * @param options Presigned URL options
+ * @returns Presigned URL
+ */
+export async function getPresignedDownloadUrl(s3, bucket, key, options = {}) {
+    const command = new GetObjectCommand({
+        Bucket: bucket,
+        Key: key
+    });
+    return getSignedUrl(s3.client, command, {
+        expiresIn: options.expiresIn || 3600
+    });
+}
+/**
+ * Generates a presigned URL for uploading
+ * @param s3 S3 instance
+ * @param bucket Bucket name
+ * @param key Object key
+ * @param options Presigned URL options
+ * @returns Presigned URL
+ */
+export async function getPresignedUploadUrl(s3, bucket, key, options = {}) {
+    const command = new PutObjectCommand({
+        Bucket: bucket,
+        Key: key,
+        ContentType: options.contentType
+    });
+    return getSignedUrl(s3.client, command, {
+        expiresIn: options.expiresIn || 3600
+    });
+}

package/dist/aws/s3/types.d.ts

@@ -0,0 +1,88 @@
+import type { S3Client } from '@aws-sdk/client-s3';
+/**
+ * S3 client configuration
+ */
+export interface S3ClientConfig {
+    /** AWS region */
+    region: string;
+    /** AWS credentials (optional - uses default credential chain if not provided) */
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+        sessionToken?: string;
+    };
+    /** Custom endpoint URL (for S3-compatible services like MinIO) */
+    endpoint?: string;
+    /** Force path style URLs (required for some S3-compatible services) */
+    forcePathStyle?: boolean;
+}
+/**
+ * S3 instance wrapper
+ */
+export interface S3Instance {
+    client: S3Client;
+    region: string;
+}
+/**
+ * Options for upload operations
+ */
+export interface UploadOptions {
+    /** Content type of the file */
+    contentType?: string;
+    /** Cache-Control header */
+    cacheControl?: string;
+    /** Content-Disposition header */
+    contentDisposition?: string;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+    /** Access control list */
+    acl?: 'private' | 'public-read' | 'public-read-write' | 'authenticated-read';
+    /** Server-side encryption */
+    serverSideEncryption?: 'AES256' | 'aws:kms';
+    /** Storage class */
+    storageClass?: 'STANDARD' | 'REDUCED_REDUNDANCY' | 'STANDARD_IA' | 'ONEZONE_IA' | 'INTELLIGENT_TIERING' | 'GLACIER' | 'DEEP_ARCHIVE';
+}
+/**
+ * Options for download operations
+ */
+export interface DownloadOptions {
+    /** Byte range to download */
+    range?: string;
+    /** Only return if modified since this date */
+    ifModifiedSince?: Date;
+    /** Only return if not modified since this date */
+    ifUnmodifiedSince?: Date;
+}
+/**
+ * Options for presigned URL generation
+ */
+export interface PresignedUrlOptions {
+    /** URL expiration in seconds */
+    expiresIn?: number;
+    /** Content type for upload URLs */
+    contentType?: string;
+}
+/**
+ * Options for listing objects
+ */
+export interface ListObjectsOptions {
+    /** Prefix to filter objects */
+    prefix?: string;
+    /** Delimiter for grouping */
+    delimiter?: string;
+    /** Maximum number of keys to return */
+    maxKeys?: number;
+    /** Continuation token for pagination */
+    continuationToken?: string;
+}
+/**
+ * S3 object metadata
+ */
+export interface S3ObjectMetadata {
+    key: string;
+    size?: number;
+    lastModified?: Date;
+    etag?: string;
+    storageClass?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/aws/s3/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/aws/s3/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,WAAW,CAAC,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,0BAA0B;IAC1B,GAAG,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;IAC7E,6BAA6B;IAC7B,oBAAoB,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5C,oBAAoB;IACpB,YAAY,CAAC,EAAE,UAAU,GAAG,oBAAoB,GAAG,aAAa,GAAG,YAAY,GAAG,qBAAqB,GAAG,SAAS,GAAG,cAAc,CAAC;CACtI;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/aws/s3/types.js

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

package/dist/caches/api-cache.d.ts

@@ -0,0 +1,40 @@
+import type { RedisInstance } from '../redis/types.js';
+/**
+ * API response cache using Redis
+ * Caches API call results with configurable TTL
+ */
+export declare class ApiCache<T = unknown> {
+    private redis;
+    private cacheType;
+    private apiFunction;
+    private cacheLength;
+    /**
+     * Creates an ApiCache instance
+     * @param redis Redis instance for caching
+     * @param cacheType Type identifier for cache keys
+     * @param apiFunction Function to call when cache misses
+     * @param cacheLength TTL in seconds (default: 1 hour)
+     */
+    constructor(redis: RedisInstance, cacheType: string, apiFunction: () => Promise<T>, cacheLength?: number);
+    /**
+     * Gets cached value or fetches from API
+     * @param cacheId Unique identifier for this cache entry
+     * @param parse Whether to JSON parse the cached value
+     * @returns Cached or fresh data
+     */
+    getCached(cacheId: string, parse?: boolean): Promise<T | string | null>;
+    /**
+     * Forces a refresh of the cached value
+     * @param cacheId Unique identifier for this cache entry
+     * @param parse Whether to JSON parse the cached value
+     * @returns Fresh data from API
+     */
+    refreshCached(cacheId: string, parse?: boolean): Promise<T | null>;
+    /**
+     * Deletes a cached entry
+     * @param cacheId Unique identifier for this cache entry
+     */
+    deleteCached(cacheId: string): Promise<void>;
+    private getAndCache;
+}
+//# sourceMappingURL=api-cache.d.ts.map

package/dist/caches/api-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-cache.d.ts","sourceRoot":"","sources":["../../src/caches/api-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD;;;GAGG;AACH,qBAAa,QAAQ,CAAC,CAAC,GAAG,OAAO;IAC/B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;OAMG;gBACS,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,GAAE,MAAa;IAO9G;;;;;OAKG;IACU,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAc,GAAG,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAU1F;;;;;OAKG;IACU,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAc,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIrF;;;OAGG;IACU,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAI3C,WAAW;CAa1B"}

package/dist/caches/api-cache.js

@@ -0,0 +1,65 @@
+import { get, set, del } from '../redis/operations/standard.js';
+const generateKey = (type, cacheId) => `api-cache:${type}:${cacheId}`;
+/**
+ * API response cache using Redis
+ * Caches API call results with configurable TTL
+ */
+export class ApiCache {
+    redis;
+    cacheType;
+    apiFunction;
+    cacheLength;
+    /**
+     * Creates an ApiCache instance
+     * @param redis Redis instance for caching
+     * @param cacheType Type identifier for cache keys
+     * @param apiFunction Function to call when cache misses
+     * @param cacheLength TTL in seconds (default: 1 hour)
+     */
+    constructor(redis, cacheType, apiFunction, cacheLength = 3600) {
+        this.redis = redis;
+        this.cacheType = cacheType;
+        this.apiFunction = apiFunction;
+        this.cacheLength = cacheLength;
+    }
+    /**
+     * Gets cached value or fetches from API
+     * @param cacheId Unique identifier for this cache entry
+     * @param parse Whether to JSON parse the cached value
+     * @returns Cached or fresh data
+     */
+    async getCached(cacheId, parse = true) {
+        const cachedObject = await get(this.redis, generateKey(this.cacheType, cacheId));
+        if (cachedObject) {
+            return parse ? JSON.parse(cachedObject) : cachedObject;
+        }
+        return this.getAndCache(cacheId, parse);
+    }
+    /**
+     * Forces a refresh of the cached value
+     * @param cacheId Unique identifier for this cache entry
+     * @param parse Whether to JSON parse the cached value
+     * @returns Fresh data from API
+     */
+    async refreshCached(cacheId, parse = true) {
+        return this.getAndCache(cacheId, parse);
+    }
+    /**
+     * Deletes a cached entry
+     * @param cacheId Unique identifier for this cache entry
+     */
+    async deleteCached(cacheId) {
+        await del(this.redis, generateKey(this.cacheType, cacheId));
+    }
+    async getAndCache(cacheId, parse) {
+        const record = await this.apiFunction();
+        if (record) {
+            const data = parse ? JSON.stringify(record) : record;
+            await set(this.redis, generateKey(this.cacheType, cacheId), data, {
+                ttl: this.cacheLength
+            });
+            return record;
+        }
+        return null;
+    }
+}

package/dist/caches/database-cache.d.ts

@@ -0,0 +1,40 @@
+import type { RedisInstance } from '../redis/types.js';
+/**
+ * Database query cache using Redis
+ * Caches database query results with configurable TTL
+ */
+export declare class DatabaseCache<T = unknown> {
+    private redis;
+    private cacheType;
+    private databaseFunction;
+    private cacheLength;
+    /**
+     * Creates a DatabaseCache instance
+     * @param redis Redis instance for caching
+     * @param cacheType Type identifier for cache keys
+     * @param databaseFunction Function to call when cache misses
+     * @param cacheLength TTL in seconds (default: 1 hour)
+     */
+    constructor(redis: RedisInstance, cacheType: string, databaseFunction: () => Promise<T>, cacheLength?: number);
+    /**
+     * Gets cached value or fetches from database
+     * @param cacheId Unique identifier for this cache entry
+     * @param parse Whether to JSON parse the cached value
+     * @returns Cached or fresh data
+     */
+    getCached(cacheId: string, parse?: boolean): Promise<T | string | null>;
+    /**
+     * Forces a refresh of the cached value
+     * @param cacheId Unique identifier for this cache entry
+     * @param parse Whether to JSON parse the cached value
+     * @returns Fresh data from database
+     */
+    refreshCached(cacheId: string, parse?: boolean): Promise<T | string | null>;
+    /**
+     * Deletes a cached entry
+     * @param cacheId Unique identifier for this cache entry
+     */
+    deleteCached(cacheId: string): Promise<void>;
+    private getAndCache;
+}
+//# sourceMappingURL=database-cache.d.ts.map

package/dist/caches/database-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-cache.d.ts","sourceRoot":"","sources":["../../src/caches/database-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;IACpC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;OAMG;gBACS,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,GAAE,MAAa;IAOnH;;;;;OAKG;IACU,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAc,GAAG,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAU1F;;;;;OAKG;IACU,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAc,GAAG,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAI9F;;;OAGG;IACU,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAI3C,WAAW;CAa1B"}

package/dist/caches/database-cache.js

@@ -0,0 +1,65 @@
+import { get, set, del } from '../redis/operations/standard.js';
+const generateKey = (type, cacheId) => `database-cache:${type}:${cacheId}`;
+/**
+ * Database query cache using Redis
+ * Caches database query results with configurable TTL
+ */
+export class DatabaseCache {
+    redis;
+    cacheType;
+    databaseFunction;
+    cacheLength;
+    /**
+     * Creates a DatabaseCache instance
+     * @param redis Redis instance for caching
+     * @param cacheType Type identifier for cache keys
+     * @param databaseFunction Function to call when cache misses
+     * @param cacheLength TTL in seconds (default: 1 hour)
+     */
+    constructor(redis, cacheType, databaseFunction, cacheLength = 3600) {
+        this.redis = redis;
+        this.cacheType = cacheType;
+        this.databaseFunction = databaseFunction;
+        this.cacheLength = cacheLength;
+    }
+    /**
+     * Gets cached value or fetches from database
+     * @param cacheId Unique identifier for this cache entry
+     * @param parse Whether to JSON parse the cached value
+     * @returns Cached or fresh data
+     */
+    async getCached(cacheId, parse = true) {
+        const cachedObject = await get(this.redis, generateKey(this.cacheType, cacheId));
+        if (cachedObject) {
+            return parse ? JSON.parse(cachedObject) : cachedObject;
+        }
+        return this.getAndCache(cacheId, parse);
+    }
+    /**
+     * Forces a refresh of the cached value
+     * @param cacheId Unique identifier for this cache entry
+     * @param parse Whether to JSON parse the cached value
+     * @returns Fresh data from database
+     */
+    async refreshCached(cacheId, parse = true) {
+        return this.getAndCache(cacheId, parse);
+    }
+    /**
+     * Deletes a cached entry
+     * @param cacheId Unique identifier for this cache entry
+     */
+    async deleteCached(cacheId) {
+        await del(this.redis, generateKey(this.cacheType, cacheId));
+    }
+    async getAndCache(cacheId, parse) {
+        const record = await this.databaseFunction();
+        if (record) {
+            const data = parse ? JSON.stringify(record) : record;
+            await set(this.redis, generateKey(this.cacheType, cacheId), data, {
+                ttl: this.cacheLength
+            });
+            return record;
+        }
+        return null;
+    }
+}

package/dist/caches/index.d.ts

@@ -0,0 +1,3 @@
+export { DatabaseCache } from './database-cache.js';
+export { ApiCache } from './api-cache.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/caches/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/caches/index.js

@@ -0,0 +1,2 @@
+export { DatabaseCache } from './database-cache.js';
+export { ApiCache } from './api-cache.js';

package/dist/config/env-loader.d.ts

@@ -0,0 +1,28 @@
+export interface LoadEnvOptions {
+    path?: string;
+    override?: boolean;
+}
+/**
+ * Loads environment variables from .env file
+ * @param options Configuration options for loading env
+ * @returns Object with parsed env variables or error
+ */
+export declare function loadEnv(options?: LoadEnvOptions): {
+    success: boolean;
+    error?: Error;
+};
+/**
+ * Gets an environment variable with optional default
+ * @param key The environment variable key
+ * @param defaultValue Optional default value if not set
+ * @returns The environment variable value or default
+ */
+export declare function getEnv(key: string, defaultValue?: string): string | undefined;
+/**
+ * Gets a required environment variable, throws if not set
+ * @param key The environment variable key
+ * @returns The environment variable value
+ * @throws Error if the environment variable is not set
+ */
+export declare function requireEnv(key: string): string;
+//# sourceMappingURL=env-loader.d.ts.map

package/dist/config/env-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.d.ts","sourceRoot":"","sources":["../../src/config/env-loader.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAWzF;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C"}

package/dist/config/env-loader.js

@@ -0,0 +1,39 @@
+import { config as dotenvConfig } from 'dotenv';
+import { resolve } from 'path';
+/**
+ * Loads environment variables from .env file
+ * @param options Configuration options for loading env
+ * @returns Object with parsed env variables or error
+ */
+export function loadEnv(options = {}) {
+    const result = dotenvConfig({
+        path: options.path ? resolve(options.path) : undefined,
+        override: options.override ?? false
+    });
+    if (result.error) {
+        return { success: false, error: result.error };
+    }
+    return { success: true };
+}
+/**
+ * Gets an environment variable with optional default
+ * @param key The environment variable key
+ * @param defaultValue Optional default value if not set
+ * @returns The environment variable value or default
+ */
+export function getEnv(key, defaultValue) {
+    return process.env[key] ?? defaultValue;
+}
+/**
+ * Gets a required environment variable, throws if not set
+ * @param key The environment variable key
+ * @returns The environment variable value
+ * @throws Error if the environment variable is not set
+ */
+export function requireEnv(key) {
+    const value = process.env[key];
+    if (value === undefined) {
+        throw new Error(`Required environment variable ${key} is not set`);
+    }
+    return value;
+}

package/dist/config/index.d.ts

@@ -0,0 +1,5 @@
+export { loadEnv, getEnv, requireEnv } from './env-loader.js';
+export type { LoadEnvOptions } from './env-loader.js';
+export { DatabaseConfigSchema, RedisConfigSchema, RedisClusterConfigSchema, RabbitMQConfigSchema, LoggingConfigSchema, validateConfig, safeValidateConfig } from './schemas.js';
+export type { DatabaseConfig, RedisConfig, RedisClusterConfig, RabbitMQConfig, LoggingConfig } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { loadEnv, getEnv, requireEnv } from './env-loader.js';
+export { DatabaseConfigSchema, RedisConfigSchema, RedisClusterConfigSchema, RabbitMQConfigSchema, LoggingConfigSchema, validateConfig, safeValidateConfig } from './schemas.js';