@arcraz/common 1.1.0 → 1.2.0

package/dist/config/index.d.ts

@@ -1,5 +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';
+export { DatabaseConfigSchema, RedisConfigSchema, RedisClusterConfigSchema, RabbitMQConfigSchema, LoggingConfigSchema, SocketIOConfigSchema, SocketIORedisAdapterConfigSchema, validateConfig, safeValidateConfig } from './schemas.js';
+export type { DatabaseConfig, RedisConfig, RedisClusterConfig, RabbitMQConfig, LoggingConfig, SocketIOConfig, SocketIORedisAdapterConfig } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,oBAAoB,EACpB,gCAAgC,EAChC,cAAc,EACd,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC"}

package/dist/config/index.js

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

package/dist/config/schemas.d.ts

@@ -169,6 +169,73 @@ export declare const LoggingConfigSchema: z.ZodObject<{
     timestamp?: boolean | undefined;
     colorize?: boolean | undefined;
 }>;
+/**
+ * Socket.IO configuration schema
+ */
+export declare const SocketIOConfigSchema: z.ZodObject<{
+    path: z.ZodDefault<z.ZodString>;
+    pingTimeout: z.ZodDefault<z.ZodNumber>;
+    pingInterval: z.ZodDefault<z.ZodNumber>;
+    maxHttpBufferSize: z.ZodDefault<z.ZodNumber>;
+    transports: z.ZodDefault<z.ZodArray<z.ZodEnum<["websocket", "polling"]>, "many">>;
+    cors: z.ZodOptional<z.ZodObject<{
+        origin: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">, z.ZodBoolean]>>;
+        methods: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        credentials: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        origin?: string | boolean | string[] | undefined;
+        methods?: string[] | undefined;
+        credentials?: boolean | undefined;
+    }, {
+        origin?: string | boolean | string[] | undefined;
+        methods?: string[] | undefined;
+        credentials?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    pingTimeout: number;
+    pingInterval: number;
+    maxHttpBufferSize: number;
+    transports: ("websocket" | "polling")[];
+    cors?: {
+        origin?: string | boolean | string[] | undefined;
+        methods?: string[] | undefined;
+        credentials?: boolean | undefined;
+    } | undefined;
+}, {
+    path?: string | undefined;
+    pingTimeout?: number | undefined;
+    pingInterval?: number | undefined;
+    maxHttpBufferSize?: number | undefined;
+    transports?: ("websocket" | "polling")[] | undefined;
+    cors?: {
+        origin?: string | boolean | string[] | undefined;
+        methods?: string[] | undefined;
+        credentials?: boolean | undefined;
+    } | undefined;
+}>;
+/**
+ * Socket.IO Redis adapter configuration schema
+ */
+export declare const SocketIORedisAdapterConfigSchema: z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    password: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodNumber>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    host: string;
+    port: number;
+    db: number;
+    password?: string | undefined;
+    keyPrefix?: string | undefined;
+}, {
+    host?: string | undefined;
+    port?: number | undefined;
+    password?: string | undefined;
+    db?: number | undefined;
+    keyPrefix?: string | undefined;
+}>;
 /**
  * Validates configuration against a schema
  * @param schema The Zod schema to validate against

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/config/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAExF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAM7J"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/config/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;EAM3C,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAExF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAM7J"}

package/dist/config/schemas.js

@@ -67,6 +67,33 @@ export const LoggingConfigSchema = z.object({
     timestamp: z.boolean().default(true),
     colorize: z.boolean().default(false)
 });
+/**
+ * Socket.IO configuration schema
+ */
+export const SocketIOConfigSchema = z.object({
+    path: z.string().default('/socket.io'),
+    pingTimeout: z.number().int().positive().default(20000),
+    pingInterval: z.number().int().positive().default(25000),
+    maxHttpBufferSize: z.number().positive().default(1e6),
+    transports: z.array(z.enum(['websocket', 'polling'])).default(['websocket', 'polling']),
+    cors: z
+        .object({
+        origin: z.union([z.string(), z.array(z.string()), z.boolean()]).optional(),
+        methods: z.array(z.string()).optional(),
+        credentials: z.boolean().optional()
+    })
+        .optional()
+});
+/**
+ * Socket.IO Redis adapter configuration schema
+ */
+export const SocketIORedisAdapterConfigSchema = z.object({
+    host: z.string().min(1).default('localhost'),
+    port: z.number().int().positive().default(6379),
+    password: z.string().optional(),
+    db: z.number().int().nonnegative().default(0),
+    keyPrefix: z.string().optional()
+});
 /**
  * Validates configuration against a schema
  * @param schema The Zod schema to validate against

package/dist/config/types.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { DatabaseConfigSchema, RedisConfigSchema, RedisClusterConfigSchema, RabbitMQConfigSchema, LoggingConfigSchema } from './schemas.js';
+import { DatabaseConfigSchema, RedisConfigSchema, RedisClusterConfigSchema, RabbitMQConfigSchema, LoggingConfigSchema, SocketIOConfigSchema, SocketIORedisAdapterConfigSchema } from './schemas.js';
 /**
  * Database configuration type
  */
@@ -20,4 +20,12 @@ export type RabbitMQConfig = z.infer<typeof RabbitMQConfigSchema>;
  * Logging configuration type
  */
 export type LoggingConfig = z.infer<typeof LoggingConfigSchema>;
+/**
+ * Socket.IO configuration type
+ */
+export type SocketIOConfig = z.infer<typeof SocketIOConfigSchema>;
+/**
+ * Socket.IO Redis adapter configuration type
+ */
+export type SocketIORedisAdapterConfig = z.infer<typeof SocketIORedisAdapterConfigSchema>;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE5I;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,gCAAgC,EACjC,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}

package/dist/config/types.js

@@ -1,2 +1,2 @@
 import { z } from 'zod';
-import { DatabaseConfigSchema, RedisConfigSchema, RedisClusterConfigSchema, RabbitMQConfigSchema, LoggingConfigSchema } from './schemas.js';
+import { DatabaseConfigSchema, RedisConfigSchema, RedisClusterConfigSchema, RabbitMQConfigSchema, LoggingConfigSchema, SocketIOConfigSchema, SocketIORedisAdapterConfigSchema } from './schemas.js';

package/dist/constants/defaults.d.ts

@@ -47,4 +47,14 @@ export declare const PAGINATION_DEFAULTS: {
     readonly MAX_PAGE_SIZE: 1000;
     readonly DEFAULT_PAGE: 1;
 };
+/**
+ * Default Socket.IO configuration values
+ */
+export declare const SOCKETIO_DEFAULTS: {
+    readonly PATH: "/socket.io";
+    readonly PING_TIMEOUT_MS: 20000;
+    readonly PING_INTERVAL_MS: 25000;
+    readonly MAX_HTTP_BUFFER_SIZE: 1000000;
+    readonly TRANSPORTS: readonly ["websocket", "polling"];
+};
 //# sourceMappingURL=defaults.d.ts.map

package/dist/constants/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/constants/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;CAQpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/constants/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;CAQpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC"}

package/dist/constants/defaults.js

@@ -47,3 +47,13 @@ export const PAGINATION_DEFAULTS = {
     MAX_PAGE_SIZE: 1000,
     DEFAULT_PAGE: 1
 };
+/**
+ * Default Socket.IO configuration values
+ */
+export const SOCKETIO_DEFAULTS = {
+    PATH: '/socket.io',
+    PING_TIMEOUT_MS: 20000,
+    PING_INTERVAL_MS: 25000,
+    MAX_HTTP_BUFFER_SIZE: 1e6,
+    TRANSPORTS: ['websocket', 'polling']
+};

package/dist/constants/index.d.ts

@@ -1,4 +1,4 @@
 export { CACHE_DURATION } from './cache-durations.js';
 export type { CacheDuration } from './cache-durations.js';
-export { DATABASE_DEFAULTS, REDIS_DEFAULTS, RABBITMQ_DEFAULTS, RETRY_DEFAULTS, PAGINATION_DEFAULTS } from './defaults.js';
+export { DATABASE_DEFAULTS, REDIS_DEFAULTS, RABBITMQ_DEFAULTS, RETRY_DEFAULTS, PAGINATION_DEFAULTS, SOCKETIO_DEFAULTS } from './defaults.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/constants/index.js

@@ -1,2 +1,2 @@
 export { CACHE_DURATION } from './cache-durations.js';
-export { DATABASE_DEFAULTS, REDIS_DEFAULTS, RABBITMQ_DEFAULTS, RETRY_DEFAULTS, PAGINATION_DEFAULTS } from './defaults.js';
+export { DATABASE_DEFAULTS, REDIS_DEFAULTS, RABBITMQ_DEFAULTS, RETRY_DEFAULTS, PAGINATION_DEFAULTS, SOCKETIO_DEFAULTS } from './defaults.js';

package/dist/index.d.ts

@@ -7,5 +7,6 @@ export * from './caches/index.js';
 export * from './logging/index.js';
 export * from './security/index.js';
 export * from './helpers/index.js';
+export * from './socketio/index.js';
 export * from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -16,5 +16,7 @@ export * from './logging/index.js';
 export * from './security/index.js';
 // Helpers
 export * from './helpers/index.js';
+// Socket.IO
+export * from './socketio/index.js';
 // Types
 export * from './types/index.js';

package/dist/socketio/index.d.ts

@@ -0,0 +1,3 @@
+export { createSocketIOServer } from './server-factory.js';
+export type { Server, Socket, Namespace, BroadcastOperator, RemoteSocket, DisconnectReason, AuthVerifyFunction, AuthenticatedSocket, SocketIOServerConfig, SocketIOInstance } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/socketio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,YAAY,EACV,MAAM,EACN,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,YAAY,CAAC"}

package/dist/socketio/index.js

@@ -0,0 +1 @@
+export { createSocketIOServer } from './server-factory.js';

package/dist/socketio/server-factory.d.ts

@@ -0,0 +1,9 @@
+import type { SocketIOServerConfig, SocketIOInstance } from './types.js';
+/**
+ * Creates a Socket.IO server instance with optional auth middleware and Redis adapter
+ *
+ * @param config Server configuration
+ * @returns SocketIOInstance with server, namespace, and helper methods
+ */
+export declare function createSocketIOServer<TUser = unknown>(config: SocketIOServerConfig<TUser>): Promise<SocketIOInstance<TUser>>;
+//# sourceMappingURL=server-factory.d.ts.map

package/dist/socketio/server-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-factory.d.ts","sourceRoot":"","sources":["../../src/socketio/server-factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CA2IjI"}

package/dist/socketio/server-factory.js

@@ -0,0 +1,129 @@
+import { Server } from 'socket.io';
+import { SOCKETIO_DEFAULTS } from '../constants/defaults.js';
+/**
+ * Creates a Socket.IO server instance with optional auth middleware and Redis adapter
+ *
+ * @param config Server configuration
+ * @returns SocketIOInstance with server, namespace, and helper methods
+ */
+export async function createSocketIOServer(config) {
+    let connected = false;
+    // userId -> Set<socketId>
+    const userSockets = new Map();
+    // socketId -> userId
+    const socketUsers = new Map();
+    const server = new Server(config.httpServer, {
+        cors: config.cors,
+        path: config.path ?? SOCKETIO_DEFAULTS.PATH,
+        pingTimeout: config.pingTimeout ?? SOCKETIO_DEFAULTS.PING_TIMEOUT_MS,
+        pingInterval: config.pingInterval ?? SOCKETIO_DEFAULTS.PING_INTERVAL_MS,
+        maxHttpBufferSize: config.maxHttpBufferSize ?? SOCKETIO_DEFAULTS.MAX_HTTP_BUFFER_SIZE,
+        transports: config.transports ?? [...SOCKETIO_DEFAULTS.TRANSPORTS]
+    });
+    // Set up Redis adapter if configured
+    if (config.redisAdapter) {
+        const { Redis } = await import('ioredis');
+        const { createAdapter } = await import('@socket.io/redis-adapter');
+        const redisOpts = {
+            host: config.redisAdapter.host,
+            port: config.redisAdapter.port,
+            password: config.redisAdapter.password,
+            db: config.redisAdapter.db ?? 0
+        };
+        const pubClient = new Redis(redisOpts);
+        const subClient = pubClient.duplicate();
+        await Promise.all([
+            new Promise((resolve, reject) => {
+                pubClient.on('ready', resolve);
+                pubClient.on('error', reject);
+            }),
+            new Promise((resolve, reject) => {
+                subClient.on('ready', resolve);
+                subClient.on('error', reject);
+            })
+        ]);
+        const prefix = config.redisAdapter.keyPrefix ?? 'socketio';
+        server.adapter(createAdapter(pubClient, subClient, { key: prefix }));
+    }
+    const namespace = server.of(config.namespace ?? '/');
+    // Apply auth middleware if provided
+    if (config.authVerify) {
+        const verify = config.authVerify;
+        namespace.use(async (socket, next) => {
+            try {
+                const user = await verify(socket.handshake.auth);
+                socket.data.user = user;
+                next();
+            }
+            catch (err) {
+                next(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+    }
+    connected = true;
+    async function close() {
+        connected = false;
+        userSockets.clear();
+        socketUsers.clear();
+        await server.close();
+    }
+    function trackConnection(userId, socketId) {
+        if (!userSockets.has(userId)) {
+            userSockets.set(userId, new Set());
+        }
+        userSockets.get(userId).add(socketId);
+        socketUsers.set(socketId, userId);
+    }
+    function untrackConnection(socketId) {
+        const userId = socketUsers.get(socketId);
+        if (userId) {
+            const sockets = userSockets.get(userId);
+            if (sockets) {
+                sockets.delete(socketId);
+                if (sockets.size === 0) {
+                    userSockets.delete(userId);
+                }
+            }
+            socketUsers.delete(socketId);
+        }
+    }
+    function emitToUser(userId, event, ...args) {
+        const sockets = userSockets.get(userId);
+        if (sockets) {
+            for (const socketId of sockets) {
+                namespace.to(socketId).emit(event, ...args);
+            }
+        }
+    }
+    function broadcast(event, ...args) {
+        namespace.emit(event, ...args);
+    }
+    function emitToRoom(room, event, ...args) {
+        namespace.to(room).emit(event, ...args);
+    }
+    function isUserOnline(userId) {
+        const sockets = userSockets.get(userId);
+        return sockets !== undefined && sockets.size > 0;
+    }
+    function getUserSocketIds(userId) {
+        const sockets = userSockets.get(userId);
+        return sockets ? [...sockets] : [];
+    }
+    function getConnectionCount() {
+        return socketUsers.size;
+    }
+    return {
+        server,
+        namespace,
+        close,
+        isConnected: () => connected,
+        trackConnection,
+        untrackConnection,
+        emitToUser,
+        broadcast,
+        emitToRoom,
+        isUserOnline,
+        getUserSocketIds,
+        getConnectionCount
+    };
+}

package/dist/socketio/types.d.ts

@@ -0,0 +1,74 @@
+import type { Server, Socket, Namespace, BroadcastOperator, RemoteSocket, DisconnectReason, DefaultEventsMap } from 'socket.io';
+import type { SocketIORedisAdapterConfig } from '../config/types.js';
+export type { Server, Socket, Namespace, BroadcastOperator, RemoteSocket, DisconnectReason };
+/**
+ * Pluggable auth verification function — consumer provides the implementation
+ */
+export type AuthVerifyFunction<TUser> = (auth: Record<string, unknown>) => Promise<TUser> | TUser;
+/**
+ * Socket with authenticated user data attached
+ */
+export type AuthenticatedSocket<TUser> = Socket<DefaultEventsMap, DefaultEventsMap, DefaultEventsMap, {
+    user: TUser;
+}>;
+/**
+ * Configuration for createSocketIOServer factory
+ */
+export interface SocketIOServerConfig<TUser> {
+    /** HTTP server to attach to */
+    httpServer: Parameters<typeof Server.prototype.attach>[0];
+    /** CORS configuration */
+    cors?: {
+        origin?: string | string[] | boolean;
+        methods?: string[];
+        credentials?: boolean;
+    };
+    /** Socket.IO path (default: /socket.io) */
+    path?: string;
+    /** Ping timeout in ms (default: 20000) */
+    pingTimeout?: number;
+    /** Ping interval in ms (default: 25000) */
+    pingInterval?: number;
+    /** Max HTTP buffer size in bytes (default: 1e6) */
+    maxHttpBufferSize?: number;
+    /** Allowed transports (default: ['websocket', 'polling']) */
+    transports?: ('websocket' | 'polling')[];
+    /** Auth verification callback — called on every connection handshake */
+    authVerify?: AuthVerifyFunction<TUser>;
+    /** Redis adapter config for horizontal scaling — omit for single-instance mode */
+    redisAdapter?: SocketIORedisAdapterConfig;
+    /** Namespace to use (default: /) */
+    namespace?: string;
+}
+/**
+ * Return type of createSocketIOServer factory
+ */
+export interface SocketIOInstance<TUser> {
+    /** The underlying Socket.IO server (generic preserves TUser for consumer type safety) */
+    server: Server<DefaultEventsMap, DefaultEventsMap, DefaultEventsMap, {
+        user: TUser;
+    }>;
+    /** The active namespace */
+    namespace: Namespace;
+    /** Gracefully close the server */
+    close(): Promise<void>;
+    /** Check if the server is running */
+    isConnected(): boolean;
+    /** Track a user's socket connection */
+    trackConnection(userId: string, socketId: string): void;
+    /** Remove a socket from tracking */
+    untrackConnection(socketId: string): void;
+    /** Emit an event to all sockets for a specific user */
+    emitToUser(userId: string, event: string, ...args: unknown[]): void;
+    /** Broadcast an event to all connected sockets */
+    broadcast(event: string, ...args: unknown[]): void;
+    /** Emit an event to all sockets in a room */
+    emitToRoom(room: string, event: string, ...args: unknown[]): void;
+    /** Check if a user has any active socket connections */
+    isUserOnline(userId: string): boolean;
+    /** Get all socket IDs for a user */
+    getUserSocketIds(userId: string): string[];
+    /** Get total number of tracked connections */
+    getConnectionCount(): number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/socketio/types.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcraz/common",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Common utilities for the arcraz ecosystem",
   "type": "module",
   "engines": {
@@ -64,6 +64,10 @@
     "./types": {
       "import": "./dist/types/index.js",
       "types": "./dist/types/index.d.ts"
+    },
+    "./socketio": {
+      "import": "./dist/socketio/index.js",
+      "types": "./dist/socketio/index.d.ts"
     }
   },
   "license": "Apache-2.0",
@@ -104,6 +108,7 @@
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^11.0.1",
     "@semantic-release/npm": "^12.0.1",
+    "@socket.io/redis-adapter": "^8.3.0",
     "@types/amqplib": "^0.10.5",
     "@types/eslint": "^9.6.1",
     "@types/humps": "^2.0.6",
@@ -119,6 +124,7 @@
     "globals": "^16.0.0",
     "prettier": "^3.2.5",
     "semantic-release": "^24.2.0",
+    "socket.io": "^4.8.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.6.3",
     "vitest": "^4.0.18"
@@ -128,8 +134,10 @@
     "@aws-sdk/client-s3": "^3.0.0",
     "@aws-sdk/cloudfront-signer": "^3.0.0",
     "@aws-sdk/s3-request-presigner": "^3.0.0",
+    "@socket.io/redis-adapter": "^8.0.0",
     "cors": "^2.8.5",
-    "helmet": "^8.0.0"
+    "helmet": "^8.0.0",
+    "socket.io": "^4.7.0"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-bedrock-runtime": {
@@ -144,11 +152,17 @@
     "@aws-sdk/s3-request-presigner": {
       "optional": true
     },
+    "@socket.io/redis-adapter": {
+      "optional": true
+    },
     "cors": {
       "optional": true
     },
     "helmet": {
       "optional": true
+    },
+    "socket.io": {
+      "optional": true
     }
   }
 }