@arcraz/common 1.0.0

package/dist/redis/operations/list.js

@@ -0,0 +1,136 @@
+import { ListPosition } from '../types.js';
+import { processKey } from '../namespace-helpers.js';
+/**
+ * Adds an element to a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param position Where to add (front or back)
+ * @param data The data to add
+ * @param useNamespace Whether to apply namespace
+ * @returns Length of list after operation
+ */
+export async function listPush(redis, key, position, data, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    if (position === ListPosition.FrontOfList) {
+        return redis.client.lpush(finalKey, data);
+    }
+    return redis.client.rpush(finalKey, data);
+}
+/**
+ * Adds an element to the front of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param data The data to add
+ * @param useNamespace Whether to apply namespace
+ * @returns Length of list after operation
+ */
+export async function lpush(redis, key, data, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.lpush(finalKey, data);
+}
+/**
+ * Adds an element to the back of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param data The data to add
+ * @param useNamespace Whether to apply namespace
+ * @returns Length of list after operation
+ */
+export async function rpush(redis, key, data, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.rpush(finalKey, data);
+}
+/**
+ * Removes and returns the first element of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param useNamespace Whether to apply namespace
+ * @returns The element or null if list is empty
+ */
+export async function lpop(redis, key, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.lpop(finalKey);
+}
+/**
+ * Removes and returns the last element of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param useNamespace Whether to apply namespace
+ * @returns The element or null if list is empty
+ */
+export async function rpop(redis, key, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.rpop(finalKey);
+}
+/**
+ * Gets a range of elements from a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param start Start index (0-based)
+ * @param stop Stop index (inclusive, -1 for end)
+ * @param useNamespace Whether to apply namespace
+ * @returns Array of elements
+ */
+export async function lrange(redis, key, start, stop, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.lrange(finalKey, start, stop);
+}
+/**
+ * Gets all elements from a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param useNamespace Whether to apply namespace
+ * @returns Array of all elements
+ */
+export async function lgetall(redis, key, useNamespace = true) {
+    return lrange(redis, key, 0, -1, useNamespace);
+}
+/**
+ * Gets the length of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param useNamespace Whether to apply namespace
+ * @returns Length of list
+ */
+export async function llen(redis, key, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.llen(finalKey);
+}
+/**
+ * Gets an element at a specific index
+ * @param redis Redis instance
+ * @param key The list key
+ * @param index The index
+ * @param useNamespace Whether to apply namespace
+ * @returns The element or null
+ */
+export async function lindex(redis, key, index, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.lindex(finalKey, index);
+}
+/**
+ * Sets an element at a specific index
+ * @param redis Redis instance
+ * @param key The list key
+ * @param index The index
+ * @param value The new value
+ * @param useNamespace Whether to apply namespace
+ * @returns 'OK' on success
+ */
+export async function lset(redis, key, index, value, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.lset(finalKey, index, value);
+}
+/**
+ * Trims a list to the specified range
+ * @param redis Redis instance
+ * @param key The list key
+ * @param start Start index
+ * @param stop Stop index
+ * @param useNamespace Whether to apply namespace
+ * @returns 'OK' on success
+ */
+export async function ltrim(redis, key, start, stop, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.ltrim(finalKey, start, stop);
+}

package/dist/redis/operations/standard.d.ts

@@ -0,0 +1,85 @@
+import type { RedisInstance, RedisData, SetOptions, GetOptions } from '../types.js';
+/**
+ * Sets a key with optional expiration
+ * @param redis Redis instance
+ * @param key The key to set
+ * @param data The data to store
+ * @param options Set options including TTL and namespace
+ * @returns 'OK' on success, null if conditional set failed
+ */
+export declare function set(redis: RedisInstance, key: string, data: RedisData, options?: SetOptions): Promise<string | null>;
+/**
+ * Gets the value of a key
+ * @param redis Redis instance
+ * @param key The key to get
+ * @param options Get options
+ * @returns The value or null if not found
+ */
+export declare function get(redis: RedisInstance, key: string, options?: GetOptions): Promise<string | null>;
+/**
+ * Deletes one or more keys
+ * @param redis Redis instance
+ * @param keys Keys to delete
+ * @param useNamespace Whether to apply namespace
+ * @returns Number of keys deleted
+ */
+export declare function del(redis: RedisInstance, keys: string | string[], useNamespace?: boolean): Promise<number>;
+/**
+ * Checks if a key exists
+ * @param redis Redis instance
+ * @param key The key to check
+ * @param useNamespace Whether to apply namespace
+ * @returns true if key exists
+ */
+export declare function exists(redis: RedisInstance, key: string, useNamespace?: boolean): Promise<boolean>;
+/**
+ * Gets all keys matching a pattern
+ * @param redis Redis instance
+ * @param pattern Pattern to match
+ * @param useNamespace Whether to apply namespace
+ * @returns Array of matching keys
+ */
+export declare function keys(redis: RedisInstance, pattern: string, useNamespace?: boolean): Promise<string[]>;
+/**
+ * Sets a key's time to live in seconds
+ * @param redis Redis instance
+ * @param key The key
+ * @param seconds TTL in seconds
+ * @param useNamespace Whether to apply namespace
+ * @returns true if TTL was set
+ */
+export declare function expire(redis: RedisInstance, key: string, seconds: number, useNamespace?: boolean): Promise<boolean>;
+/**
+ * Gets the remaining TTL of a key
+ * @param redis Redis instance
+ * @param key The key
+ * @param useNamespace Whether to apply namespace
+ * @returns TTL in seconds, -1 if no expiry, -2 if key doesn't exist
+ */
+export declare function ttl(redis: RedisInstance, key: string, useNamespace?: boolean): Promise<number>;
+/**
+ * Increments a key's integer value
+ * @param redis Redis instance
+ * @param key The key
+ * @param useNamespace Whether to apply namespace
+ * @returns New value after increment
+ */
+export declare function incr(redis: RedisInstance, key: string, useNamespace?: boolean): Promise<number>;
+/**
+ * Increments a key's integer value by a specific amount
+ * @param redis Redis instance
+ * @param key The key
+ * @param increment Amount to increment by
+ * @param useNamespace Whether to apply namespace
+ * @returns New value after increment
+ */
+export declare function incrBy(redis: RedisInstance, key: string, increment: number, useNamespace?: boolean): Promise<number>;
+/**
+ * Decrements a key's integer value
+ * @param redis Redis instance
+ * @param key The key
+ * @param useNamespace Whether to apply namespace
+ * @returns New value after decrement
+ */
+export declare function decr(redis: RedisInstance, key: string, useNamespace?: boolean): Promise<number>;
+//# sourceMappingURL=standard.d.ts.map

package/dist/redis/operations/standard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard.d.ts","sourceRoot":"","sources":["../../../src/redis/operations/standard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGpF;;;;;;;GAOG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyB9H;AAED;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG7G;AAED;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAItH;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAI9G;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGjH;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAI/H;AAED;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1G;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3G;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhI;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3G"}

package/dist/redis/operations/standard.js

@@ -0,0 +1,136 @@
+import { processKey } from '../namespace-helpers.js';
+/**
+ * Sets a key with optional expiration
+ * @param redis Redis instance
+ * @param key The key to set
+ * @param data The data to store
+ * @param options Set options including TTL and namespace
+ * @returns 'OK' on success, null if conditional set failed
+ */
+export async function set(redis, key, data, options = {}) {
+    const finalKey = processKey(key, options.useNamespace ?? true, redis.namespace);
+    if (options.ttl) {
+        if (options.nx) {
+            const result = await redis.client.set(finalKey, data, 'EX', options.ttl, 'NX');
+            return result;
+        }
+        if (options.xx) {
+            const result = await redis.client.set(finalKey, data, 'EX', options.ttl, 'XX');
+            return result;
+        }
+        return redis.client.setex(finalKey, options.ttl, data);
+    }
+    if (options.nx) {
+        const result = await redis.client.setnx(finalKey, data);
+        return result === 1 ? 'OK' : null;
+    }
+    if (options.xx) {
+        const result = await redis.client.set(finalKey, data, 'XX');
+        return result;
+    }
+    return redis.client.set(finalKey, data);
+}
+/**
+ * Gets the value of a key
+ * @param redis Redis instance
+ * @param key The key to get
+ * @param options Get options
+ * @returns The value or null if not found
+ */
+export async function get(redis, key, options = {}) {
+    const finalKey = processKey(key, options.useNamespace ?? true, redis.namespace);
+    return redis.client.get(finalKey);
+}
+/**
+ * Deletes one or more keys
+ * @param redis Redis instance
+ * @param keys Keys to delete
+ * @param useNamespace Whether to apply namespace
+ * @returns Number of keys deleted
+ */
+export async function del(redis, keys, useNamespace = true) {
+    const keysArray = Array.isArray(keys) ? keys : [keys];
+    const finalKeys = keysArray.map((k) => processKey(k, useNamespace, redis.namespace));
+    return redis.client.del(...finalKeys);
+}
+/**
+ * Checks if a key exists
+ * @param redis Redis instance
+ * @param key The key to check
+ * @param useNamespace Whether to apply namespace
+ * @returns true if key exists
+ */
+export async function exists(redis, key, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    const result = await redis.client.exists(finalKey);
+    return result === 1;
+}
+/**
+ * Gets all keys matching a pattern
+ * @param redis Redis instance
+ * @param pattern Pattern to match
+ * @param useNamespace Whether to apply namespace
+ * @returns Array of matching keys
+ */
+export async function keys(redis, pattern, useNamespace = true) {
+    const finalPattern = processKey(pattern, useNamespace, redis.namespace);
+    return redis.client.keys(finalPattern);
+}
+/**
+ * Sets a key's time to live in seconds
+ * @param redis Redis instance
+ * @param key The key
+ * @param seconds TTL in seconds
+ * @param useNamespace Whether to apply namespace
+ * @returns true if TTL was set
+ */
+export async function expire(redis, key, seconds, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    const result = await redis.client.expire(finalKey, seconds);
+    return result === 1;
+}
+/**
+ * Gets the remaining TTL of a key
+ * @param redis Redis instance
+ * @param key The key
+ * @param useNamespace Whether to apply namespace
+ * @returns TTL in seconds, -1 if no expiry, -2 if key doesn't exist
+ */
+export async function ttl(redis, key, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.ttl(finalKey);
+}
+/**
+ * Increments a key's integer value
+ * @param redis Redis instance
+ * @param key The key
+ * @param useNamespace Whether to apply namespace
+ * @returns New value after increment
+ */
+export async function incr(redis, key, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.incr(finalKey);
+}
+/**
+ * Increments a key's integer value by a specific amount
+ * @param redis Redis instance
+ * @param key The key
+ * @param increment Amount to increment by
+ * @param useNamespace Whether to apply namespace
+ * @returns New value after increment
+ */
+export async function incrBy(redis, key, increment, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.incrby(finalKey, increment);
+}
+/**
+ * Decrements a key's integer value
+ * @param redis Redis instance
+ * @param key The key
+ * @param useNamespace Whether to apply namespace
+ * @returns New value after decrement
+ */
+export async function decr(redis, key, useNamespace = true) {
+    const finalKey = processKey(key, useNamespace, redis.namespace);
+    return redis.client.decr(finalKey);
+}

package/dist/redis/types.d.ts

@@ -0,0 +1,81 @@
+import type { Redis, Cluster } from 'ioredis';
+/**
+ * Redis client type - either single instance or cluster
+ */
+export type RedisClient = Redis | Cluster;
+/**
+ * Data types that can be stored in Redis
+ */
+export type RedisData = Buffer | number | string;
+/**
+ * List position for lpush/rpush operations
+ */
+export declare enum ListPosition {
+    FrontOfList = "FRONT",
+    BackOfList = "BACK"
+}
+/**
+ * Redis instance interface wrapping the client with helper methods
+ */
+export interface RedisInstance {
+    /** The underlying ioredis client */
+    client: RedisClient;
+    /** Whether this is a cluster connection */
+    isCluster: boolean;
+    /** Default namespace for keys */
+    namespace: string;
+    /** Close the connection */
+    close(): Promise<void>;
+    /** Check if connected */
+    isConnected(): boolean;
+}
+/**
+ * Configuration for single Redis instance
+ */
+export interface RedisInstanceConfig {
+    host: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    keyPrefix?: string;
+    tls?: boolean;
+    connectTimeout?: number;
+    commandTimeout?: number;
+    namespace?: string;
+}
+/**
+ * Configuration for Redis cluster
+ */
+export interface RedisClusterInstanceConfig {
+    nodes: {
+        host: string;
+        port: number;
+    }[];
+    password?: string;
+    keyPrefix?: string;
+    tls?: boolean;
+    connectTimeout?: number;
+    commandTimeout?: number;
+    namespace?: string;
+}
+/**
+ * Options for Redis set operations
+ */
+export interface SetOptions {
+    /** Time to live in seconds */
+    ttl?: number;
+    /** Only set if key doesn't exist */
+    nx?: boolean;
+    /** Only set if key exists */
+    xx?: boolean;
+    /** Whether to append environment namespace */
+    useNamespace?: boolean;
+}
+/**
+ * Options for Redis get operations
+ */
+export interface GetOptions {
+    /** Whether to append environment namespace */
+    useNamespace?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/redis/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/redis/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD;;GAEG;AACH,oBAAY,YAAY;IACtB,WAAW,UAAU;IACrB,UAAU,SAAS;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,yBAAyB;IACzB,WAAW,IAAI,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,6BAA6B;IAC7B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/redis/types.js

@@ -0,0 +1,8 @@
+/**
+ * List position for lpush/rpush operations
+ */
+export var ListPosition;
+(function (ListPosition) {
+    ListPosition["FrontOfList"] = "FRONT";
+    ListPosition["BackOfList"] = "BACK";
+})(ListPosition || (ListPosition = {}));

package/dist/security/cors-factory.d.ts

@@ -0,0 +1,28 @@
+import type { CorsConfig } from './types.js';
+/**
+ * Creates a CORS configuration object
+ * @param overrides Optional configuration overrides
+ * @returns CORS configuration
+ */
+export declare function createCorsConfig(overrides?: Partial<CorsConfig>): CorsConfig;
+/**
+ * Creates a permissive CORS configuration for development
+ * WARNING: Do not use in production!
+ * @returns Permissive CORS configuration
+ */
+export declare function createDevCorsConfig(): CorsConfig;
+/**
+ * Creates a CORS configuration for specific origins
+ * @param origins Allowed origins
+ * @param options Additional options
+ * @returns CORS configuration
+ */
+export declare function createOriginCorsConfig(origins: string | string[], options?: Partial<Omit<CorsConfig, 'origin'>>): CorsConfig;
+/**
+ * Creates a CORS configuration with a dynamic origin validator
+ * @param validator Function that returns true if origin is allowed
+ * @param options Additional options
+ * @returns CORS configuration
+ */
+export declare function createDynamicCorsConfig(validator: (origin: string | undefined) => boolean, options?: Partial<Omit<CorsConfig, 'origin'>>): CorsConfig;
+//# sourceMappingURL=cors-factory.d.ts.map

package/dist/security/cors-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors-factory.d.ts","sourceRoot":"","sources":["../../src/security/cors-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAe7C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CAKhF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,CAUhD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAM,GAAG,UAAU,CAOhI;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,EAAE,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAM,GAAG,UAAU,CAYzJ"}

package/dist/security/cors-factory.js

@@ -0,0 +1,73 @@
+/**
+ * Default CORS configuration (restrictive)
+ */
+const DEFAULT_CORS_CONFIG = {
+    origin: false,
+    methods: ['GET', 'HEAD', 'PUT', 'PATCH', 'POST', 'DELETE'],
+    allowedHeaders: ['Content-Type', 'Authorization'],
+    credentials: false,
+    maxAge: 86400, // 24 hours
+    preflightContinue: false,
+    optionsSuccessStatus: 204
+};
+/**
+ * Creates a CORS configuration object
+ * @param overrides Optional configuration overrides
+ * @returns CORS configuration
+ */
+export function createCorsConfig(overrides = {}) {
+    return {
+        ...DEFAULT_CORS_CONFIG,
+        ...overrides
+    };
+}
+/**
+ * Creates a permissive CORS configuration for development
+ * WARNING: Do not use in production!
+ * @returns Permissive CORS configuration
+ */
+export function createDevCorsConfig() {
+    return {
+        origin: true,
+        methods: ['GET', 'HEAD', 'PUT', 'PATCH', 'POST', 'DELETE', 'OPTIONS'],
+        allowedHeaders: ['Content-Type', 'Authorization', 'X-Requested-With'],
+        credentials: true,
+        maxAge: 86400,
+        preflightContinue: false,
+        optionsSuccessStatus: 204
+    };
+}
+/**
+ * Creates a CORS configuration for specific origins
+ * @param origins Allowed origins
+ * @param options Additional options
+ * @returns CORS configuration
+ */
+export function createOriginCorsConfig(origins, options = {}) {
+    return {
+        ...DEFAULT_CORS_CONFIG,
+        origin: origins,
+        credentials: true,
+        ...options
+    };
+}
+/**
+ * Creates a CORS configuration with a dynamic origin validator
+ * @param validator Function that returns true if origin is allowed
+ * @param options Additional options
+ * @returns CORS configuration
+ */
+export function createDynamicCorsConfig(validator, options = {}) {
+    return {
+        ...DEFAULT_CORS_CONFIG,
+        ...options,
+        origin: (origin, callback) => {
+            if (!origin || validator(origin)) {
+                callback(null, true);
+            }
+            else {
+                callback(new Error('Not allowed by CORS'));
+            }
+        }
+    };
+}

package/dist/security/helmet-factory.d.ts

@@ -0,0 +1,14 @@
+import type { HelmetConfig } from './types.js';
+/**
+ * Creates a Helmet configuration object
+ * @param overrides Optional configuration overrides
+ * @returns Helmet configuration
+ */
+export declare function createHelmetConfig(overrides?: Partial<HelmetConfig>): HelmetConfig;
+/**
+ * Creates a Helmet configuration for API-only services
+ * @param overrides Optional configuration overrides
+ * @returns Helmet configuration for APIs
+ */
+export declare function createApiHelmetConfig(overrides?: Partial<HelmetConfig>): HelmetConfig;
+//# sourceMappingURL=helmet-factory.d.ts.map

package/dist/security/helmet-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helmet-factory.d.ts","sourceRoot":"","sources":["../../src/security/helmet-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA8D/C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAKtF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAKzF"}

package/dist/security/helmet-factory.js

@@ -0,0 +1,80 @@
+/**
+ * Default secure Helmet configuration
+ */
+const DEFAULT_HELMET_CONFIG = {
+    contentSecurityPolicy: {
+        directives: {
+            defaultSrc: ["'self'"], // eslint-disable-line quotes
+            scriptSrc: ["'self'"], // eslint-disable-line quotes
+            styleSrc: ["'self'", "'unsafe-inline'"], // eslint-disable-line quotes
+            imgSrc: ["'self'", 'data:', 'https:'], // eslint-disable-line quotes
+            fontSrc: ["'self'"], // eslint-disable-line quotes
+            objectSrc: ["'none'"], // eslint-disable-line quotes
+            frameAncestors: ["'none'"], // eslint-disable-line quotes
+            formAction: ["'self'"], // eslint-disable-line quotes
+            upgradeInsecureRequests: []
+        }
+    },
+    crossOriginEmbedderPolicy: true,
+    crossOriginOpenerPolicy: { policy: 'same-origin' },
+    crossOriginResourcePolicy: { policy: 'same-origin' },
+    dnsPrefetchControl: { allow: false },
+    frameguard: { action: 'deny' },
+    hidePoweredBy: true,
+    hsts: {
+        maxAge: 31536000, // 1 year
+        includeSubDomains: true,
+        preload: true
+    },
+    ieNoOpen: true,
+    noSniff: true,
+    originAgentCluster: true,
+    permittedCrossDomainPolicies: { permittedPolicies: 'none' },
+    referrerPolicy: { policy: 'strict-origin-when-cross-origin' },
+    xssFilter: true
+};
+/**
+ * Helmet configuration for API-only services (no CSP needed)
+ */
+const API_HELMET_CONFIG = {
+    contentSecurityPolicy: false,
+    crossOriginEmbedderPolicy: false,
+    crossOriginOpenerPolicy: false,
+    crossOriginResourcePolicy: { policy: 'cross-origin' },
+    dnsPrefetchControl: { allow: false },
+    frameguard: { action: 'deny' },
+    hidePoweredBy: true,
+    hsts: {
+        maxAge: 31536000,
+        includeSubDomains: true,
+        preload: true
+    },
+    ieNoOpen: true,
+    noSniff: true,
+    originAgentCluster: true,
+    permittedCrossDomainPolicies: { permittedPolicies: 'none' },
+    referrerPolicy: { policy: 'strict-origin-when-cross-origin' },
+    xssFilter: true
+};
+/**
+ * Creates a Helmet configuration object
+ * @param overrides Optional configuration overrides
+ * @returns Helmet configuration
+ */
+export function createHelmetConfig(overrides = {}) {
+    return {
+        ...DEFAULT_HELMET_CONFIG,
+        ...overrides
+    };
+}
+/**
+ * Creates a Helmet configuration for API-only services
+ * @param overrides Optional configuration overrides
+ * @returns Helmet configuration for APIs
+ */
+export function createApiHelmetConfig(overrides = {}) {
+    return {
+        ...API_HELMET_CONFIG,
+        ...overrides
+    };
+}

package/dist/security/index.d.ts

@@ -0,0 +1,4 @@
+export { createHelmetConfig, createApiHelmetConfig } from './helmet-factory.js';
+export { createCorsConfig, createDevCorsConfig, createOriginCorsConfig, createDynamicCorsConfig } from './cors-factory.js';
+export type { HelmetConfig, ContentSecurityPolicyConfig, HstsConfig, CorsConfig, CorsOriginCallback, RateLimitConfig } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC3H,YAAY,EAAE,YAAY,EAAE,2BAA2B,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/security/index.js

@@ -0,0 +1,2 @@
+export { createHelmetConfig, createApiHelmetConfig } from './helmet-factory.js';
+export { createCorsConfig, createDevCorsConfig, createOriginCorsConfig, createDynamicCorsConfig } from './cors-factory.js';