arkos 2.0.0-next.2 → 2.0.0-next.21

package/dist/esm/components/arkos-gateway/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/arkos-gateway/types.ts"],"names":[],"mappings":"AA8dA,MAAM,OAAO,sBAAsB;CAAG","sourcesContent":["import { BroadcastOperator, Socket } from \"socket.io\";\nimport { User } from \"../../types\";\nimport { DefaultEventsMap } from \"socket.io\";\nimport { Validator } from \"../../types/validation/validator\";\nimport { Options as RateLimitOptions } from \"express-rate-limit\";\nimport { DetailedAccessControlRule } from \"../../types/auth\";\n///@ts-ignore\nimport {\n  AllButLast,\n  DecorateAcknowledgements,\n  DecorateAcknowledgementsWithMultipleResponses,\n  EventNames,\n  EventNamesWithAck,\n  EventNamesWithError,\n  EventParams,\n  FirstNonErrorArg,\n  Last,\n  ///@ts-ignore\n} from \"socket.io/dist/typed-events\";\n\nexport interface EventsMap {\n  [event: string]: any;\n}\n\nexport interface ArkosSocket<\n  ListenEvents extends EventsMap = DefaultEventsMap,\n  EmitEvents extends EventsMap = ListenEvents,\n  ServerSideEvents extends EventsMap = DefaultEventsMap,\n  SocketData extends Validator = any,\n  SocketLocals extends Record<string, any> = Record<string, any>,\n> extends Socket<ListenEvents, EmitEvents, ServerSideEvents, SocketData> {\n  /**\n   * Populated by Arkos after successful authentication on connection.\n   * Available in all event handlers when `authentication: true` on the gateway.\n   */\n  currentUser?: User;\n\n  /**\n   * Populated by Arkos after successful validation.\n   * Typed to the event's validation schema when using TypeScript.\n   */\n  data: SocketData;\n\n  /** User access token. */\n  accessToken?: string;\n\n  /**\n   * Metadata from the incoming message, extracted from `_meta` by Arkos.\n   *\n   * - `mid`: Unique message ID used for deduplication.\n   * - `timestamp`: When the message was sent by the client.\n   */\n  meta?: {\n    mid?: string;\n    timestamp?: string | number | Date;\n  };\n\n  /**\n   * Per-event local storage, scoped to the current event pipeline.\n   * Use to pass data between pipes and the event handler — like Express's `res.locals`.\n   * Reset automatically on each event.\n   *\n   * @example\n   * chatGateway.pipe((socket, data) => {\n   *   socket.locals.enriched = enrichUser(socket.currentUser)\n   * })\n   *\n   * chatGateway.on({ event: \"send_message\" }, (socket, data) => {\n   *   console.log(socket.locals.enriched)\n   * })\n   */\n  locals?: SocketLocals;\n\n  /**\n   * Internal Arkos context injected by the gateway at connection time.\n   *\n   * @internal\n   */\n  _arkos: {\n    store: ArkosGatewayStore;\n    gatewayConfig: ArkosGatewayConfig;\n  };\n\n  /**\n   * Targets all active socket connections of a user by their user ID.\n   * Uses the internal `arkos::user:{userId}` room convention.\n   *\n   * Supports emit, management, and exclusion operations across all of the\n   * user's active connections.\n   *\n   * @example\n   * socket.user(userId).emit(\"notification\", data)\n   * socket.user(userId).except({ user: otherUserId }).emit(\"sync\", data)\n   * const sockets = await socket.user(userId).fetchSockets()\n   * const online = await socket.user(userId).isOnline()\n   *\n   * @since 1.7.0-canary.29\n   */\n  user(userId: string): ArkosUserTarget;\n\n  /**\n   * Wraps the next `emit` or `emitWithAck` with exponential backoff retry logic.\n   * Chain `.timeout(ms)` before `.emitWithAck()` as usual.\n   *\n   * @example\n   * socket.retry(3).emit(\"event\", data)\n   * socket.retry(3).timeout(5000).emitWithAck(\"event\", data)\n   *\n   * @since 1.7.0-canary.29\n   */\n  retry(\n    times: number,\n    initialDelay?: number,\n    multiplier?: number\n  ): ArkosRetryTarget;\n\n  /**\n   * Emits an event to this client.\n   * Arkos automatically injects `_meta` (`mid` + `timestamp`) into every outgoing payload\n   * for client-side deduplication and freshness checks.\n   *\n   * @example\n   * socket.emit(\"message\", { text: \"hello\" })\n   * socket.emit(\"notification\", { title: \"New order\" })\n   */\n  emit<Ev extends EventNames<EmitEvents>>(\n    ev: Ev,\n    ...args: EventParams<EmitEvents, Ev>\n  ): true;\n\n  /**\n   * Emits an event and waits for an acknowledgement from the client.\n   * Arkos injects `_meta` automatically. Use `.timeout(ms)` to avoid hanging indefinitely.\n   *\n   * @example\n   * const response = await socket.timeout(5000).emitWithAck(\"confirm\", data)\n   */\n  emitWithAck<Ev extends EventNamesWithAck<EmitEvents>>(\n    ev: Ev,\n    ...args: AllButLast<EventParams<EmitEvents, Ev>>\n  ): Promise<FirstNonErrorArg<Last<EventParams<EmitEvents, Ev>>>>;\n\n  /**\n   * Targets a room when broadcasting — excludes the sender.\n   * Returns an {@link ArkosBroadcastOperator} with enhanced `.except({ user })` support\n   * and automatic `_meta` injection on every `.emit()`.\n   *\n   * @example\n   * socket.to(\"room-101\").emit(\"message\", data)\n   * socket.to(\"room-101\").except({ user: userId }).emit(\"message\", data)\n   * socket.to(\"room-101\").volatile.emit(\"typing\", data)\n   * await socket.to(\"room-101\").timeout(3000).emitWithAck(\"confirm\", data)\n   *\n   * @since 1.7.0-canary.29\n   */\n  to(\n    room: string | string[]\n  ): ArkosBroadcastOperator<\n    DecorateAcknowledgementsWithMultipleResponses<EmitEvents>,\n    SocketData\n  > &\n    BroadcastOperator<EmitEvents, SocketData>;\n  /**\n   * Broadcasts to all connected clients except the sender.\n   * Returns an {@link ArkosBroadcastOperator} with enhanced `.except({ user })` support\n   * and automatic `_meta` injection on every `.emit()`.\n   *\n   * @example\n   * socket.broadcast.emit(\"announcement\", data)\n   * socket.broadcast.except({ user: userId }).emit(\"announcement\", data)\n   * socket.broadcast.volatile.emit(\"ping\", data)\n   *\n   * @since 1.7.0-canary.29\n   */\n  get broadcast(): ArkosBroadcastOperator<\n    DecorateAcknowledgementsWithMultipleResponses<EmitEvents>,\n    SocketData\n  > &\n    BroadcastOperator<EmitEvents, SocketData>;\n}\n\n/**\n * Enhanced broadcast/room target returned by `socket.to()` and `socket.broadcast`.\n * Extends the native `BroadcastOperator` with `{ user }` exclusion support\n * and automatic `_meta` injection on emit.\n *\n * @since 1.7.0-canary.29\n */\nexport interface ArkosBroadcastOperator<\n  EmitEvents extends EventsMap = DefaultEventsMap,\n  SocketData extends Validator = any,\n> extends BroadcastOperator<EmitEvents, SocketData> {\n  /**\n   * Exclude sockets from the broadcast.\n   * Accepts a room name, socket ID, or `{ user: string | string[] }` to exclude\n   * all sockets belonging to one or more users.\n   *\n   * @example\n   * socket.to(\"room-101\").except(\"room-102\").emit(\"foo\", data)\n   * socket.broadcast.except({ user: userId }).emit(\"foo\", data)\n   * socket.broadcast.except({ user: [userId1, userId2] }).emit(\"foo\", data)\n   */\n  except(\n    room: string | string[] | { user: string | string[] }\n  ): ArkosBroadcastOperator<EmitEvents, SocketData>;\n\n  /**\n   * Emits to all clients,`_meta` is injected automatically.\n   *\n   * @example\n   * // the “foo” event will be broadcast to all connected clients\n   * io.emit(\"foo\", \"bar\");\n   *\n   * // the “foo” event will be broadcast to all connected clients in the “room-101” room\n   * io.to(\"room-101\").emit(\"foo\", \"bar\");\n   *\n   * // with an acknowledgement expected from all connected clients\n   * io.timeout(1000).emit(\"some-event\", (err, responses) => {\n   *   if (err) {\n   *     // some clients did not acknowledge the event in the given delay\n   *   } else {\n   *     console.log(responses); // one response per client\n   *   }\n   * });\n   *\n   * @return Always true\n   */\n  emit<Ev extends EventNames<EmitEvents>>(\n    ev: Ev,\n    ...args: EventParams<EmitEvents, Ev>\n  ): true;\n\n  /** Chain volatile flag — event may be lost if client is not ready. */\n  get volatile(): ArkosBroadcastOperator<EmitEvents, SocketData>;\n\n  /** Chain compress flag. */\n  compress(value: boolean): ArkosBroadcastOperator<EmitEvents, SocketData>;\n\n  /** Chain timeout for `emitWithAck`. */\n  timeout(\n    ms: number\n  ): ArkosBroadcastOperator<DecorateAcknowledgements<EmitEvents>, SocketData>;\n\n  /**\n   * Emits an event and waits for an acknowledgement from all clients.\n   * `_meta` is injected automatically\n   * @example\n   * try {\n   *   const responses = await io.timeout(1000).emitWithAck(\"some-event\");\n   *   console.log(responses); // one response per client\n   * } catch (e) {\n   *   // some clients did not acknowledge the event in the given delay\n   * }\n   *\n   * @return a Promise that will be fulfilled when all clients have acknowledged the event\n   */\n  emitWithAck<Ev extends EventNamesWithError<EmitEvents>>(\n    ev: Ev,\n    ...args: AllButLast<EventParams<EmitEvents, Ev>>\n  ): Promise<FirstNonErrorArg<Last<EventParams<EmitEvents, Ev>>>>;\n  /**\n   * Returns all unique user IDs currently in the target room(s).\n   *\n   * @example\n   * const users = await socket.to(\"room-123\").users()\n   */\n  users(): Promise<string[]>;\n}\n\n/**\n * Returned by `socket.retry(n)`. Wraps `emit` and `emitWithAck`\n * with exponential backoff. Chain `.timeout(ms)` before `.emitWithAck()` as usual.\n *\n * @since 1.7.0-canary.29\n */\nexport interface ArkosRetryTarget {\n  /** Emit with ack and retry. `_meta` is injected automatically. */\n  emitWithAck(event: string, data: any, ...rest: any[]): Promise<any>;\n\n  /**\n   * Chain a timeout before `emitWithAck`.\n   *\n   * @example\n   * socket.retry(3).timeout(5000).emitWithAck(\"event\", data)\n   */\n  timeout(ms: number): ArkosRetryTarget;\n}\n\n/**\n * Returned by `socket.user(userId)`.\n * Targets all active socket connections of a user.\n *\n * @since 1.7.0-canary.29\n */\nexport interface ArkosUserTarget extends ArkosBroadcastOperator {\n  /**\n   * Returns all active rooms for this user.\n   *\n   * @example\n   * const rooms = await socket.user(userId).activeRooms()\n   * console.log(rooms.length) // number of active tabs/connections\n   */\n  activeRooms(): Promise<string[]>;\n}\n\nexport type ArkosGatewayPipe = (\n  socket: ArkosSocket,\n  data: any\n) => void | Promise<void>;\n\nexport type ArkosGatewayEventConfig<TSchema extends Validator = any> = {\n  /** The Socket.io event name to listen for. */\n  event: string;\n\n  /** Zod schema or class-validator DTO to validate the incoming event payload. */\n  validation?: TSchema;\n\n  /** Per-event rate limiting. Overrides gateway-level `rateLimit` for this event. */\n  rateLimit?: Partial<RateLimitOptions> | false;\n\n  /**\n   * Authorization configuration.\n   *\n   * @remarks Gateway `authentication` must NOT be `false` or this throws at registration time.\n   */\n  authorization?: {\n    resource: string;\n    action: string;\n    rule?: DetailedAccessControlRule | string[] | \"*\";\n  };\n\n  /**\n   * When `true`, Arkos automatically calls `ack({ success: true })` after the handler\n   * finishes, unless the handler already called ack manually.\n   */\n  ack?: boolean;\n\n  /** Disables this event handler without removing it. */\n  disabled?: boolean;\n\n  /**\n   * Maximum age in milliseconds for incoming messages.\n   * Requires `data._meta.timestamp`. Events older than this are rejected.\n   */\n  maxAge?: number;\n\n  /** Per-event deduplication. Overrides gateway-level `dedup`. */\n  dedup?:\n    | {\n        /** @default true */\n        enabled?: boolean;\n        /** Time-to-live in seconds for the dedup key. @default 3600 */\n        ttl?: number;\n      }\n    | false;\n};\n\nexport type ArkosGatewayAckFn = (response: any) => void;\n\nexport type ArkosGatewayHandler<TData = any> = (\n  socket: ArkosSocket,\n  data: TData,\n  ack?: ArkosGatewayAckFn\n) => void | Promise<void>;\n\nexport type ArkosGatewayEventEntry = {\n  config: ArkosGatewayEventConfig;\n  handler: ArkosGatewayHandler;\n  pipes: ArkosGatewayPipe[];\n};\n\nexport type ArkosGatewayConnectionHandler = (\n  socket: ArkosSocket\n) => void | Promise<void>;\n\nexport type ArkosGatewayHookHandler =\n  | ArkosGatewayConnectionHandler\n  | ArkosGatewayErrorHandler;\n\nexport type ArkosGatewayErrorHandler = (\n  error: any,\n  socket: ArkosSocket\n) => void | Promise<void>;\n\nexport type ArkosGatewayHookType = \"connection\" | \"disconnect\" | \"error\";\n\nexport type ArkosGatewayConfig = {\n  /**\n   * Socket.io namespace for this gateway.\n   *\n   * @example\n   * name: \"/chat\"\n   */\n  name: string;\n\n  /**\n   * When `true`, Arkos runs auth middleware on connection and populates `socket.currentUser`.\n   * Unauthenticated sockets are rejected.\n   *\n   * @default false\n   */\n  authentication?: boolean;\n\n  /** Gateway-level rate limiting, applied per socket. Can be overridden per event. */\n  rateLimit?: Partial<RateLimitOptions>;\n\n  /**\n   * Gateway-level deduplication. Drills down to child gateways and can be overridden\n   * per child or per event listener.\n   */\n  dedup?:\n    | {\n        /** @default true */\n        enabled?: boolean;\n        /** @default 3600 */\n        ttl?: number;\n      }\n    | false;\n\n  /**\n   * Maximum age in milliseconds for incoming messages.\n   * Can be overridden per event via `maxAge` in `gateway.on()`.\n   */\n  maxAge?: number;\n};\n\n/**\n * Options for `gateway.register()`.\n * Passed once at the root — applies to all child gateways.\n */\nexport type ArkosGatewayRegisterOptions = {\n  /**\n   * Unified store for rate limiting and deduplication.\n   * Defaults to an in-memory store — zero config for single-instance deployments.\n   * For distributed deployments plug in a Redis-backed store.\n   *\n   * @example\n   * store: new RedisArkosStore(redis)\n   */\n  store?: ArkosGatewayStore;\n};\n\n/**\n * Unified store interface for rate limiting and deduplication.\n * Implement this to plug in Redis, Valkey, or any distributed store.\n *\n * @example\n * class RedisArkosStore implements ArkosGatewayStore {\n *   async increment(key, windowMs) { ... }\n *   async clear(prefix) { ... }\n *   async has(key) { ... }\n *   async set(key, ttl) { ... }\n *   async setIfNotExists(key, ttl) { ... }\n * }\n */\nexport interface ArkosGatewayStore {\n  /** Increment a rate limit counter. Key format: `arkos::rl:{socketId}:{event}` */\n  increment(\n    key: string,\n    windowMs: number\n  ): Promise<{ count: number; resetAt: number }>;\n\n  /** Clear all rate limit entries matching a prefix. Key format: `arkos::rl:{socketId}` */\n  clear(prefix: string): Promise<void>;\n\n  /** Check if a dedup key exists. */\n  has(key: string): Promise<boolean>;\n\n  /** Store a dedup key with TTL in seconds. */\n  set(key: string, ttl: number): Promise<void>;\n\n  /**\n   * Atomically store a dedup key only if it does not already exist.\n   * Returns `true` if created (process the message), `false` if duplicate (skip).\n   */\n  setIfNotExists(key: string, ttl: number): Promise<boolean>;\n}\n\nexport class ArkosGatewayController {}\n"]}

package/dist/esm/components/arkos-gateway/utils/helpers.js

@@ -0,0 +1,105 @@
+import { isProduction } from "../../../utils/helpers/arkos-config.helpers.js";
+import { getHandledError } from "../../../modules/error-handler/utils/get-handled-error.js";
+export async function handleArkosGatewayErrors(err, socket, errorHandlers = [], loggerMeta, ack) {
+    let emitCalled = false;
+    const originalEmit = socket.emit.bind(socket);
+    socket.emit = (...args) => {
+        emitCalled = true;
+        return originalEmit(...args);
+    };
+    if (errorHandlers.length) {
+        try {
+            for (const handler of errorHandlers)
+                await handler(err, socket);
+        }
+        catch (catchedErr) {
+            err = catchedErr;
+            emitCalled = false;
+        }
+    }
+    socket.emit = originalEmit;
+    if (!emitCalled) {
+        console.error("[\x1b[31mError\x1b[0m]:", err);
+        err = getHandledError(err);
+        const payload = {
+            message: err?.message ?? "Internal server error",
+            ...(err.isOperational
+                ? err
+                : { code: "InternalServerError", statusCode: 500 }),
+        };
+        if (isProduction())
+            sendProductionError(err, socket);
+        else
+            sendDevelopmentError(payload, socket);
+        ack?.({ error: payload.message, ...(payload.meta || {}) });
+        handleGatewayEventLog(loggerMeta.namespace, loggerMeta.event, payload.statusCode, loggerMeta.startTime);
+    }
+}
+function sendDevelopmentError(err, socket) {
+    socket.emit("error", {
+        ...err,
+        message: err.message?.split?.("\n")[err.message?.split?.("\n").length - 1],
+        stack: err?.originalError?.stack?.split?.("\n"),
+    });
+}
+function sendProductionError(err, socket) {
+    if (err.isOperational)
+        socket.emit("event", {
+            status: err.status,
+            message: err.message,
+            meta: err.meta || {},
+            code: err.code || "Unknown",
+            statusCode: err.statusCode || 500,
+        });
+    else
+        socket.emit("error", {
+            status: "error",
+            message: "Internal server error, please try again later.",
+            code: "InternalServerError",
+            meta: {},
+            statusCode: 500,
+        });
+}
+export async function runArkosGatewayPipes(pipes, socket, data) {
+    for (const pipe of pipes) {
+        await pipe(socket, data);
+    }
+}
+export function handleGatewayEventLog(namespace, event, statusCode, startTime) {
+    const getStatusColor = (statusCode) => {
+        if (statusCode >= 100 && statusCode < 200)
+            return "\x1b[36m";
+        if (statusCode >= 200 && statusCode < 300)
+            return "\x1b[32m";
+        if (statusCode >= 300 && statusCode < 400)
+            return "\x1b[33m";
+        if (statusCode >= 400 && statusCode < 500)
+            return "\x1b[33m";
+        if (statusCode >= 500)
+            return "\x1b[31m";
+        return "\x1b[0m";
+    };
+    const duration = Date.now() - startTime;
+    const now = new Date();
+    const date = now.toISOString().split("T")[0];
+    const time = now.toTimeString().split(" ")[0];
+    const timestamp = isProduction() ? `${date} ${time}` : time;
+    const statusColor = getStatusColor(statusCode);
+    console.info(`[\x1b[36mInfo\x1b[0m] \x1b[90m${timestamp}\x1b[0m \x1b[35mWS\x1b[0m ${namespace} ${event} ${statusColor}${statusCode}\x1b[0m \x1b[35m${duration}ms\x1b[0m`);
+}
+export function handleGatewayLifecycleLog(namespace, event, socketId, errorType) {
+    const isProduction = process.env.ARKOS_BUILD == "true";
+    const now = new Date();
+    const date = now.toISOString().split("T")[0];
+    const time = now.toTimeString().split(" ")[0];
+    const timestamp = isProduction ? `${date} ${time}` : time;
+    const eventColors = {
+        connected: "\x1b[32m",
+        disconnected: "\x1b[33m",
+        error: "\x1b[31m",
+    };
+    const eventColor = eventColors[event];
+    const extra = errorType ? ` ${errorType}` : "";
+    console.info(`[\x1b[36mInfo\x1b[0m] \x1b[90m${timestamp}\x1b[0m \x1b[35mWS\x1b[0m ${namespace} ${eventColor}${event}\x1b[0m ${socketId}${extra}`);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/esm/components/arkos-gateway/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../src/components/arkos-gateway/utils/helpers.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,wDAAwD,CAAC;AAEzF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAQ,EACR,MAAmB,EACnB,gBAA4C,EAAE,EAC9C,UAIC,EACD,GAA6B;IAE7B,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,MAAM,YAAY,GAAQ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnD,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;QAC/B,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,KAAK,MAAM,OAAO,IAAI,aAAa;gBAAE,MAAM,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,UAAe,EAAE,CAAC;YACzB,GAAG,GAAG,UAAU,CAAC;YACjB,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC;IAE3B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;QAC9C,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAE3B,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,uBAAuB;YAChD,GAAG,CAAC,GAAG,CAAC,aAAa;gBACnB,CAAC,CAAC,GAAG;gBACL,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;SACtD,CAAC;QAEF,IAAI,YAAY,EAAE;YAAE,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;;YAChD,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE3C,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAE3D,qBAAqB,CACnB,UAAU,CAAC,SAAS,EACpB,UAAU,CAAC,KAAK,EAChB,OAAO,CAAC,UAAU,EAClB,UAAU,CAAC,SAAS,CACrB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAQ,EAAE,MAAmB;IACzD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;QACnB,GAAG,GAAG;QACN,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1E,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC;KAChD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAQ,EAAE,MAAmB;IACxD,IAAI,GAAG,CAAC,aAAa;QACnB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACnB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,SAAS;YAC3B,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG;SAClC,CAAC,CAAC;;QAEH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACnB,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,gDAAgD;YACzD,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,EAAE;YACR,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAyB,EACzB,MAAmB,EACnB,IAAS;IAET,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,KAAa,EACb,UAAkB,EAClB,SAAiB;IAEjB,MAAM,cAAc,GAAG,CAAC,UAAkB,EAAE,EAAE;QAC5C,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;YAAE,OAAO,UAAU,CAAC;QAC7D,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;YAAE,OAAO,UAAU,CAAC;QAC7D,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;YAAE,OAAO,UAAU,CAAC;QAC7D,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG;YAAE,OAAO,UAAU,CAAC;QAC7D,IAAI,UAAU,IAAI,GAAG;YAAE,OAAO,UAAU,CAAC;QACzC,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,MAAM,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAE/C,OAAO,CAAC,IAAI,CACV,iCAAiC,SAAS,6BAA6B,SAAS,IAAI,KAAK,IAAI,WAAW,GAAG,UAAU,mBAAmB,QAAQ,WAAW,CAC5J,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,SAAiB,EACjB,KAA6C,EAC7C,QAAgB,EAChB,SAAkB;IAElB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IACvD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1D,MAAM,WAAW,GAAG;QAClB,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,UAAU;QACxB,KAAK,EAAE,UAAU;KAClB,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/C,OAAO,CAAC,IAAI,CACV,iCAAiC,SAAS,6BAA6B,SAAS,IAAI,UAAU,GAAG,KAAK,WAAW,QAAQ,GAAG,KAAK,EAAE,CACpI,CAAC;AACJ,CAAC","sourcesContent":["import {\n  ArkosGatewayErrorHandler,\n  ArkosGatewayPipe,\n  ArkosSocket,\n} from \"../types\";\nimport { isProduction } from \"../../../utils/helpers/arkos-config.helpers\";\nimport { getHandledError } from \"../../../modules/error-handler/utils/get-handled-error\";\n\nexport async function handleArkosGatewayErrors(\n  err: any,\n  socket: ArkosSocket,\n  errorHandlers: ArkosGatewayErrorHandler[] = [],\n  loggerMeta: {\n    namespace: string;\n    event: string;\n    startTime: number;\n  },\n  ack?: (response: any) => void\n) {\n  let emitCalled = false;\n  const originalEmit: any = socket.emit.bind(socket);\n\n  socket.emit = (...args: any[]) => {\n    emitCalled = true;\n    return originalEmit(...args);\n  };\n\n  if (errorHandlers.length) {\n    try {\n      for (const handler of errorHandlers) await handler(err, socket);\n    } catch (catchedErr: any) {\n      err = catchedErr;\n      emitCalled = false;\n    }\n  }\n\n  socket.emit = originalEmit;\n\n  if (!emitCalled) {\n    console.error(\"[\\x1b[31mError\\x1b[0m]:\", err);\n    err = getHandledError(err);\n\n    const payload = {\n      message: err?.message ?? \"Internal server error\",\n      ...(err.isOperational\n        ? err\n        : { code: \"InternalServerError\", statusCode: 500 }),\n    };\n\n    if (isProduction()) sendProductionError(err, socket);\n    else sendDevelopmentError(payload, socket);\n\n    ack?.({ error: payload.message, ...(payload.meta || {}) });\n\n    handleGatewayEventLog(\n      loggerMeta.namespace,\n      loggerMeta.event,\n      payload.statusCode,\n      loggerMeta.startTime\n    );\n  }\n}\n\nfunction sendDevelopmentError(err: any, socket: ArkosSocket): void {\n  socket.emit(\"error\", {\n    ...err,\n    message: err.message?.split?.(\"\\n\")[err.message?.split?.(\"\\n\").length - 1],\n    stack: err?.originalError?.stack?.split?.(\"\\n\"),\n  });\n}\n\nfunction sendProductionError(err: any, socket: ArkosSocket): void {\n  if (err.isOperational)\n    socket.emit(\"event\", {\n      status: err.status,\n      message: err.message,\n      meta: err.meta || {},\n      code: err.code || \"Unknown\",\n      statusCode: err.statusCode || 500,\n    });\n  else\n    socket.emit(\"error\", {\n      status: \"error\",\n      message: \"Internal server error, please try again later.\",\n      code: \"InternalServerError\",\n      meta: {},\n      statusCode: 500,\n    });\n}\n\nexport async function runArkosGatewayPipes(\n  pipes: ArkosGatewayPipe[],\n  socket: ArkosSocket,\n  data: any\n) {\n  for (const pipe of pipes) {\n    await pipe(socket, data);\n  }\n}\n\nexport function handleGatewayEventLog(\n  namespace: string,\n  event: string,\n  statusCode: number,\n  startTime: number\n) {\n  const getStatusColor = (statusCode: number) => {\n    if (statusCode >= 100 && statusCode < 200) return \"\\x1b[36m\";\n    if (statusCode >= 200 && statusCode < 300) return \"\\x1b[32m\";\n    if (statusCode >= 300 && statusCode < 400) return \"\\x1b[33m\";\n    if (statusCode >= 400 && statusCode < 500) return \"\\x1b[33m\";\n    if (statusCode >= 500) return \"\\x1b[31m\";\n    return \"\\x1b[0m\";\n  };\n\n  const duration = Date.now() - startTime;\n  const now = new Date();\n  const date = now.toISOString().split(\"T\")[0];\n  const time = now.toTimeString().split(\" \")[0];\n  const timestamp = isProduction() ? `${date} ${time}` : time;\n  const statusColor = getStatusColor(statusCode);\n\n  console.info(\n    `[\\x1b[36mInfo\\x1b[0m] \\x1b[90m${timestamp}\\x1b[0m \\x1b[35mWS\\x1b[0m ${namespace} ${event} ${statusColor}${statusCode}\\x1b[0m \\x1b[35m${duration}ms\\x1b[0m`\n  );\n}\n\nexport function handleGatewayLifecycleLog(\n  namespace: string,\n  event: \"connected\" | \"disconnected\" | \"error\",\n  socketId: string,\n  errorType?: string\n) {\n  const isProduction = process.env.ARKOS_BUILD == \"true\";\n  const now = new Date();\n  const date = now.toISOString().split(\"T\")[0];\n  const time = now.toTimeString().split(\" \")[0];\n  const timestamp = isProduction ? `${date} ${time}` : time;\n\n  const eventColors = {\n    connected: \"\\x1b[32m\",\n    disconnected: \"\\x1b[33m\",\n    error: \"\\x1b[31m\",\n  };\n\n  const eventColor = eventColors[event];\n  const extra = errorType ? ` ${errorType}` : \"\";\n\n  console.info(\n    `[\\x1b[36mInfo\\x1b[0m] \\x1b[90m${timestamp}\\x1b[0m \\x1b[35mWS\\x1b[0m ${namespace} ${eventColor}${event}\\x1b[0m ${socketId}${extra}`\n  );\n}\n"]}

package/dist/esm/components/arkos-gateway/utils/memory-gateway-store.js

@@ -0,0 +1,45 @@
+export class MemoryGatewayStore {
+    rl = new Map();
+    dedup = new Map();
+    async increment(key, windowMs) {
+        const now = Date.now();
+        const entry = this.rl.get(key);
+        if (!entry || entry.resetAt <= now) {
+            const next = { count: 1, resetAt: now + windowMs };
+            this.rl.set(key, next);
+            return next;
+        }
+        entry.count++;
+        return entry;
+    }
+    async clear(prefix) {
+        for (const key of this.rl.keys())
+            if (key.startsWith(prefix))
+                this.rl.delete(key);
+        for (const [key, timer] of this.dedup)
+            if (key.startsWith(prefix)) {
+                clearTimeout(timer);
+                this.dedup.delete(key);
+            }
+    }
+    async has(key) {
+        return this.dedup.has(key);
+    }
+    async set(key, ttl) {
+        if (this.dedup.has(key))
+            clearTimeout(this.dedup.get(key));
+        const timer = setTimeout(() => this.dedup.delete(key), ttl * 1000);
+        timer.unref();
+        this.dedup.set(key, timer);
+    }
+    async setIfNotExists(key, ttl) {
+        if (this.dedup.has(key))
+            return false;
+        const timer = setTimeout(() => this.dedup.delete(key), ttl * 1000);
+        timer.unref();
+        this.dedup.set(key, timer);
+        return true;
+    }
+}
+export const defaultGatewayStore = new MemoryGatewayStore();
+//# sourceMappingURL=memory-gateway-store.js.map

package/dist/esm/components/arkos-gateway/utils/memory-gateway-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-gateway-store.js","sourceRoot":"","sources":["../../../../../src/components/arkos-gateway/utils/memory-gateway-store.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IACrB,EAAE,GAAG,IAAI,GAAG,EAA8C,CAAC;IAC3D,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,QAAgB;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,QAAQ,EAAE,CAAC;YACnD,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc;QACxB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;YAC9B,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK;YACnC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,GAAW;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,GAAW;QAC3C,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAEtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,KAAK,EAAE,CAAC;QAEd,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE3B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,kBAAkB,EAAE,CAAC","sourcesContent":["import { ArkosGatewayStore } from \"../types\";\n\nexport class MemoryGatewayStore implements ArkosGatewayStore {\n  private rl = new Map<string, { count: number; resetAt: number }>();\n  private dedup = new Map<string, NodeJS.Timeout>();\n\n  async increment(key: string, windowMs: number) {\n    const now = Date.now();\n    const entry = this.rl.get(key);\n    if (!entry || entry.resetAt <= now) {\n      const next = { count: 1, resetAt: now + windowMs };\n      this.rl.set(key, next);\n      return next;\n    }\n    entry.count++;\n    return entry;\n  }\n\n  async clear(prefix: string) {\n    for (const key of this.rl.keys())\n      if (key.startsWith(prefix)) this.rl.delete(key);\n    for (const [key, timer] of this.dedup)\n      if (key.startsWith(prefix)) {\n        clearTimeout(timer);\n        this.dedup.delete(key);\n      }\n  }\n\n  async has(key: string) {\n    return this.dedup.has(key);\n  }\n\n  async set(key: string, ttl: number) {\n    if (this.dedup.has(key)) clearTimeout(this.dedup.get(key)!);\n    const timer = setTimeout(() => this.dedup.delete(key), ttl * 1000);\n    timer.unref();\n    this.dedup.set(key, timer);\n  }\n\n  async setIfNotExists(key: string, ttl: number): Promise<boolean> {\n    if (this.dedup.has(key)) return false;\n\n    const timer = setTimeout(() => this.dedup.delete(key), ttl * 1000);\n    timer.unref();\n\n    this.dedup.set(key, timer);\n\n    return true;\n  }\n}\n\nexport const defaultGatewayStore = new MemoryGatewayStore();\n"]}

package/dist/esm/components/arkos-gateway/utils/multi-tier-arkos-gateway-store.js

@@ -0,0 +1,40 @@
+export class MultiTierArkosGatewayStore {
+    tiers;
+    constructor(tiers) {
+        this.tiers = tiers;
+    }
+    async increment(key, windowMs) {
+        const l1 = await this.tiers[0].increment(key, windowMs);
+        for (const tier of this.tiers.slice(1))
+            tier.increment(key, windowMs);
+        return l1;
+    }
+    async clear(prefix) {
+        await Promise.all(this.tiers.map((t) => t.clear(prefix)));
+    }
+    async has(key) {
+        for (const tier of this.tiers) {
+            if (await tier.has(key))
+                return true;
+        }
+        return false;
+    }
+    async set(key, ttl) {
+        await Promise.all(this.tiers.map((t) => t.set(key, ttl)));
+    }
+    async setIfNotExists(key, ttl) {
+        for (const tier of this.tiers) {
+            const acquired = await tier.setIfNotExists(key, ttl);
+            if (acquired) {
+                for (const t of this.tiers) {
+                    if (t !== tier) {
+                        t.set(key, ttl).catch(() => { });
+                    }
+                }
+                return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=multi-tier-arkos-gateway-store.js.map

package/dist/esm/components/arkos-gateway/utils/multi-tier-arkos-gateway-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-tier-arkos-gateway-store.js","sourceRoot":"","sources":["../../../../../src/components/arkos-gateway/utils/multi-tier-arkos-gateway-store.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,0BAA0B;IACjB;IAApB,YAAoB,KAA0B;QAA1B,UAAK,GAAL,KAAK,CAAqB;IAAG,CAAC;IAElD,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,QAAgB;QAE3C,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACxD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACtE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc;QACxB,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,GAAW;QAChC,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,GAAW;QAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAErD,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC3B,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;wBACf,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBAClC,CAAC;gBACH,CAAC;gBAED,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF","sourcesContent":["import { ArkosGatewayStore } from \"../types\";\n\n/**\n * Multi-tier store that chains multiple stores together.\n * Writes go to all tiers. Reads check tiers in order, promoting hits to faster tiers.\n *\n * @example\n * new MultiTierArkosStore([new MemoryArkosStore(), new RedisArkosStore(redis)])\n */\nexport class MultiTierArkosGatewayStore implements ArkosGatewayStore {\n  constructor(private tiers: ArkosGatewayStore[]) {}\n\n  async increment(key: string, windowMs: number) {\n    // L1 first — if valid, sync to slower tiers and return\n    const l1 = await this.tiers[0].increment(key, windowMs);\n    for (const tier of this.tiers.slice(1)) tier.increment(key, windowMs);\n    return l1;\n  }\n\n  async clear(prefix: string) {\n    await Promise.all(this.tiers.map((t) => t.clear(prefix)));\n  }\n\n  async has(key: string) {\n    for (const tier of this.tiers) {\n      if (await tier.has(key)) return true;\n    }\n    return false;\n  }\n\n  async set(key: string, ttl: number) {\n    await Promise.all(this.tiers.map((t) => t.set(key, ttl)));\n  }\n\n  async setIfNotExists(key: string, ttl: number): Promise<boolean> {\n    for (const tier of this.tiers) {\n      const acquired = await tier.setIfNotExists(key, ttl);\n\n      if (acquired) {\n        for (const t of this.tiers) {\n          if (t !== tier) {\n            t.set(key, ttl).catch(() => {});\n          }\n        }\n\n        return true;\n      }\n    }\n\n    return false;\n  }\n}\n"]}

package/dist/esm/components/arkos-gateway/utils/rate-limiter.js

@@ -0,0 +1,13 @@
+export async function checkRateLimit(socketId, event, options, store) {
+    const windowMs = options.windowMs ?? 60_000;
+    const max = options.max ?? 100;
+    const key = `arkos::rl:${socketId}:${event}`;
+    const { count, resetAt } = await store.increment(key, windowMs);
+    if (count > max)
+        return { allowed: false, retryAfter: resetAt - Date.now() };
+    return { allowed: true };
+}
+export async function clearRateLimitForSocket(socketId, store) {
+    await store.clear(`arkos::rl:${socketId}`);
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/esm/components/arkos-gateway/utils/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../../../../src/components/arkos-gateway/utils/rate-limiter.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,KAAa,EACb,OAAkC,EAClC,KAAwB;IAExB,MAAM,QAAQ,GAAI,OAAO,CAAC,QAAmB,IAAI,MAAM,CAAC;IACxD,MAAM,GAAG,GAAI,OAAO,CAAC,GAAc,IAAI,GAAG,CAAC;IAC3C,MAAM,GAAG,GAAG,aAAa,QAAQ,IAAI,KAAK,EAAE,CAAC;IAE7C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEhE,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAE7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAgB,EAChB,KAAwB;IAExB,MAAM,KAAK,CAAC,KAAK,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import { Options as RateLimitOptions } from \"express-rate-limit\";\nimport { ArkosGatewayStore } from \"../types\";\n\n/**\n * Checks whether a socket has exceeded the rate limit for a given event.\n * Returns true if the request is allowed, false if rate limited.\n */\nexport async function checkRateLimit(\n  socketId: string,\n  event: string,\n  options: Partial<RateLimitOptions>,\n  store: ArkosGatewayStore\n): Promise<{ allowed: boolean; retryAfter?: number }> {\n  const windowMs = (options.windowMs as number) ?? 60_000;\n  const max = (options.max as number) ?? 100;\n  const key = `arkos::rl:${socketId}:${event}`;\n\n  const { count, resetAt } = await store.increment(key, windowMs);\n\n  if (count > max) return { allowed: false, retryAfter: resetAt - Date.now() };\n\n  return { allowed: true };\n}\n\nexport async function clearRateLimitForSocket(\n  socketId: string,\n  store: ArkosGatewayStore\n) {\n  await store.clear(`arkos::rl:${socketId}`);\n}\n"]}

package/dist/esm/components/arkos-loadable-registry/index.js

@@ -1,8 +1,6 @@
 const LOADABLES = ["ArkosRouteHook", "ArkosServiceHook"];
 export class ArkosLoadableRegistry {
-    constructor() {
-        this.items = new Map();
-    }
+    items = new Map();
     register(item) {
         const type = item.__type;
         const moduleName = item.moduleName;

package/dist/esm/components/arkos-loadable-registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/arkos-loadable-registry/index.ts"],"names":[],"mappings":"AAGA,MAAM,SAAS,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;AAMzD,MAAM,OAAO,qBAAqB;IAAlC;QACmB,UAAK,GAA4C,IAAI,GAAG,EAAE,CAAC;IAuC9E,CAAC;IAjCC,QAAQ,CAAC,IAAmB;QAC1B,MAAM,IAAI,GAAI,IAAY,CAAC,MAAM,CAAC;QAClC,MAAM,UAAU,GAAI,IAAY,CAAC,UAAU,CAAC;QAE5C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC3B,MAAM,KAAK,CACT,8CAA8C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,GAAG,CAC5F,CAAC;QAEJ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAKD,OAAO,CACL,YAAmD,EACnD,UAA2B;QAE3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAC/D,CAAC;IAKD,OAAO,CACL,YAAmD,EACnD,UAAkB;QAElB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;IAChE,CAAC;CACF;AAED,MAAM,gBAAgB,GAAG,IAAI,qBAAqB,EAAE,CAAC;AAErD,eAAe,gBAAgB,CAAC","sourcesContent":["import { ArkosLoadable } from \"../../types/arkos\";\nimport { ArkosModuleType } from \"../arkos-route-hook/types\";\n\nconst LOADABLES = [\"ArkosRouteHook\", \"ArkosServiceHook\"];\n\n/**\n * Registry for all items loaded via `app.load()`.\n * Instantiated once at app start and passed through the entire Arkos chain.\n */\nexport class ArkosLoadableRegistry {\n  private readonly items: Map<string, Map<string, ArkosLoadable>> = new Map();\n\n  /**\n   * Registers a loadable item into the registry.\n   * Called internally by `app.load()`.\n   */\n  register(item: ArkosLoadable): void {\n    const type = (item as any).__type;\n    const moduleName = (item as any).moduleName;\n\n    if (!LOADABLES.includes(type))\n      throw Error(\n        `Invalid loadable component, expected on of ${LOADABLES.join(\", \")} but received \"${item}\"`\n      );\n\n    if (!this.items.has(type)) this.items.set(type, new Map());\n\n    this.items.get(type)!.set(moduleName, item);\n  }\n\n  /**\n   * Returns the interceptor for the given module name, or `null` if not registered.\n   */\n  getItem(\n    loadableType: \"ArkosRouteHook\" | \"ArkosServiceHook\",\n    moduleName: ArkosModuleType\n  ): ArkosLoadable | null {\n    return this.items.get(loadableType)?.get(moduleName) ?? null;\n  }\n\n  /**\n   * Returns true if an interceptor is registered for the given module name.\n   */\n  hasItem(\n    loadableType: \"ArkosRouteHook\" | \"ArkosServiceHook\",\n    moduleName: string\n  ): boolean {\n    return this.items.get(loadableType)?.has(moduleName) ?? false;\n  }\n}\n\nconst loadableRegistry = new ArkosLoadableRegistry();\n\nexport default loadableRegistry;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/arkos-loadable-registry/index.ts"],"names":[],"mappings":"AAGA,MAAM,SAAS,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;AAMzD,MAAM,OAAO,qBAAqB;IACf,KAAK,GAA4C,IAAI,GAAG,EAAE,CAAC;IAM5E,QAAQ,CAAC,IAAmB;QAC1B,MAAM,IAAI,GAAI,IAAY,CAAC,MAAM,CAAC;QAClC,MAAM,UAAU,GAAI,IAAY,CAAC,UAAU,CAAC;QAE5C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC3B,MAAM,KAAK,CACT,8CAA8C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,GAAG,CAC5F,CAAC;QAEJ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAKD,OAAO,CACL,YAAmD,EACnD,UAA2B;QAE3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAC/D,CAAC;IAKD,OAAO,CACL,YAAmD,EACnD,UAAkB;QAElB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;IAChE,CAAC;CACF;AAED,MAAM,gBAAgB,GAAG,IAAI,qBAAqB,EAAE,CAAC;AAErD,eAAe,gBAAgB,CAAC","sourcesContent":["import { ArkosLoadable } from \"../../types/arkos\";\nimport { ArkosModuleType } from \"../arkos-route-hook/types\";\n\nconst LOADABLES = [\"ArkosRouteHook\", \"ArkosServiceHook\"];\n\n/**\n * Registry for all items loaded via `app.load()`.\n * Instantiated once at app start and passed through the entire Arkos chain.\n */\nexport class ArkosLoadableRegistry {\n  private readonly items: Map<string, Map<string, ArkosLoadable>> = new Map();\n\n  /**\n   * Registers a loadable item into the registry.\n   * Called internally by `app.load()`.\n   */\n  register(item: ArkosLoadable): void {\n    const type = (item as any).__type;\n    const moduleName = (item as any).moduleName;\n\n    if (!LOADABLES.includes(type))\n      throw Error(\n        `Invalid loadable component, expected on of ${LOADABLES.join(\", \")} but received \"${item}\"`\n      );\n\n    if (!this.items.has(type)) this.items.set(type, new Map());\n\n    this.items.get(type)!.set(moduleName, item);\n  }\n\n  /**\n   * Returns the interceptor for the given module name, or `null` if not registered.\n   */\n  getItem(\n    loadableType: \"ArkosRouteHook\" | \"ArkosServiceHook\",\n    moduleName: ArkosModuleType\n  ): ArkosLoadable | null {\n    return this.items.get(loadableType)?.get(moduleName) ?? null;\n  }\n\n  /**\n   * Returns true if an interceptor is registered for the given module name.\n   */\n  hasItem(\n    loadableType: \"ArkosRouteHook\" | \"ArkosServiceHook\",\n    moduleName: string\n  ): boolean {\n    return this.items.get(loadableType)?.has(moduleName) ?? false;\n  }\n}\n\nconst loadableRegistry = new ArkosLoadableRegistry();\n\nexport default loadableRegistry;\n"]}

package/dist/esm/components/arkos-policy/index.js

@@ -13,7 +13,9 @@ function buildPolicy(resource, store) {
             action,
             rule: config,
         };
-        const checker = (user) => authService.permission(action, resource, { [action]: config || {} })(user);
+        const checker = authService.permission(action, resource, {
+            [action]: config || {},
+        });
         const canKey = `can${action.charAt(0).toUpperCase()}${action.slice(1)}`;
         return [
             [action, authEntry],

package/dist/esm/components/arkos-policy/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/arkos-policy/index.ts"],"names":[],"mappings":"AAQA,OAAO,WAAW,MAAM,iCAAiC,CAAC;AA+B1D,MAAM,UAAU,WAAW,CACzB,QAAmB;IAEnB,OAAO,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,WAAW,CAClB,QAAmB,EACnB,KAAsC;IAEtC,MAAM,IAAI,GAAG,CACX,MAAe,EACf,MAAuB,EAC2B,EAAE;QACpD,MAAM,QAAQ,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAChD,OAAO,WAAW,CAAgC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxE,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CACtC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE;QACjD,MAAM,SAAS,GAA8C;YAC3D,QAAQ;YACR,MAAM;YACN,IAAI,EAAE,MAAM;SACb,CAAC;QAEF,MAAM,OAAO,GAAkB,CAAC,IAAW,EAAoB,EAAE,CAC/D,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,CAClE,IAAI,CACL,CAAC;QAEJ,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAExE,OAAO;YACL,CAAC,MAAM,EAAE,SAAS,CAAC;YACnB,CAAC,MAAM,EAAE,OAAO,CAAC;SAClB,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,aAAsB;QAC9B,QAAQ;QACR,IAAI;QACJ,GAAG,aAAa;KACoC,CAAC;AACzD,CAAC","sourcesContent":["import { User } from \"../../types\";\nimport {\n  ArkosPolicyRule,\n  IArkosPolicy,\n  PolicyAuthEntry,\n  PolicyChecker,\n  PolicyWithActions,\n} from \"./types\";\nimport authService from \"../../modules/auth/auth.service\";\n\n/**\n * Creates a typed policy for a Prisma model resource.\n *\n * Each `.rule()` call registers an action and returns the policy\n * with a typed `can{Action}` permission checker and a typed `{Action}`\n * entry — both passable to the `authentication` field on `ArkosRouteHook`\n * and `ArkosRouter`, and callable for fine-grained permission checks.\n *\n * @param resource - The resource name in kebab-case (e.g. `\"user\"`, `\"blog-post\"`)\n *\n * @example\n * ```ts\n * const userPolicy = ArkosPolicy(\"user\")\n *   .rule(\"Create\", [\"Admin\", \"Editor\"])\n *   .rule(\"View\", \"*\")\n *   .rule(\"Delete\", [\"Admin\"]);\n *\n * // Pass to authentication field\n * userRouter.post({ path: \"/users\", authentication: userPolicy.Create });\n * userRouteHook.deleteOne({ authentication: userPolicy.Delete });\n *\n * // Fine-grained check\n * if (userPolicy.canCreate(req.user)) { ... }\n *\n * export default userPolicy;\n * ```\n *\n * @see {@link https://www.arkosjs.com/docs/api-referency/arkos-policy}\n */\nexport function ArkosPolicy<TResource extends string>(\n  resource: TResource\n): IArkosPolicy<TResource, never> {\n  return buildPolicy(resource, {});\n}\n\nfunction buildPolicy<TResource extends string, TActions extends string>(\n  resource: TResource,\n  store: Record<string, ArkosPolicyRule>\n): PolicyWithActions<TResource, TActions> {\n  const rule = <TAction extends string>(\n    action: TAction,\n    config: ArkosPolicyRule\n  ): PolicyWithActions<TResource, TActions | TAction> => {\n    const newStore = { ...store, [action]: config };\n    return buildPolicy<TResource, TActions | TAction>(resource, newStore);\n  };\n\n  const actionEntries = Object.fromEntries(\n    Object.entries(store).flatMap(([action, config]) => {\n      const authEntry: PolicyAuthEntry<TResource, typeof action> = {\n        resource,\n        action,\n        rule: config,\n      };\n\n      const checker: PolicyChecker = (user?: User): Promise<boolean> =>\n        authService.permission(action, resource, { [action]: config || {} })(\n          user\n        );\n\n      const canKey = `can${action.charAt(0).toUpperCase()}${action.slice(1)}`;\n\n      return [\n        [action, authEntry],\n        [canKey, checker],\n      ];\n    })\n  );\n\n  return {\n    __type: \"ArkosPolicy\" as const,\n    resource,\n    rule,\n    ...actionEntries,\n  } as unknown as PolicyWithActions<TResource, TActions>;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/arkos-policy/index.ts"],"names":[],"mappings":"AAOA,OAAO,WAAW,MAAM,iCAAiC,CAAC;AA+B1D,MAAM,UAAU,WAAW,CACzB,QAAmB;IAEnB,OAAO,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,WAAW,CAClB,QAAmB,EACnB,KAAsC;IAEtC,MAAM,IAAI,GAAG,CACX,MAAe,EACf,MAAuB,EAC2B,EAAE;QACpD,MAAM,QAAQ,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAChD,OAAO,WAAW,CAAgC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxE,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CACtC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE;QACjD,MAAM,SAAS,GAA8C;YAC3D,QAAQ;YACR,MAAM;YACN,IAAI,EAAE,MAAM;SACb,CAAC;QAEF,MAAM,OAAO,GAAkB,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE;YACtE,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,EAAE;SACvB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAExE,OAAO;YACL,CAAC,MAAM,EAAE,SAAS,CAAC;YACnB,CAAC,MAAM,EAAE,OAAO,CAAC;SAClB,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,aAAsB;QAC9B,QAAQ;QACR,IAAI;QACJ,GAAG,aAAa;KACoC,CAAC;AACzD,CAAC","sourcesContent":["import {\n  ArkosPolicyRule,\n  IArkosPolicy,\n  PolicyAuthEntry,\n  PolicyChecker,\n  PolicyWithActions,\n} from \"./types\";\nimport authService from \"../../modules/auth/auth.service\";\n\n/**\n * Creates a typed policy for a Prisma model resource.\n *\n * Each `.rule()` call registers an action and returns the policy\n * with a typed `can{Action}` permission checker and a typed `{Action}`\n * entry — both passable to the `authentication` field on `ArkosRouteHook`\n * and `ArkosRouter`, and callable for fine-grained permission checks.\n *\n * @param resource - The resource name in kebab-case (e.g. `\"user\"`, `\"blog-post\"`)\n *\n * @example\n * ```ts\n * const userPolicy = ArkosPolicy(\"user\")\n *   .rule(\"Create\", [\"Admin\", \"Editor\"])\n *   .rule(\"View\", \"*\")\n *   .rule(\"Delete\", [\"Admin\"]);\n *\n * // Pass to authentication field\n * userRouter.post({ path: \"/users\", authentication: userPolicy.Create });\n * userRouteHook.deleteOne({ authentication: userPolicy.Delete });\n *\n * // Fine-grained check\n * if (userPolicy.canCreate(req.user)) { ... }\n *\n * export default userPolicy;\n * ```\n *\n * @see {@link https://www.arkosjs.com/docs/api-referency/arkos-policy}\n */\nexport function ArkosPolicy<TResource extends string>(\n  resource: TResource\n): IArkosPolicy<TResource, never> {\n  return buildPolicy(resource, {});\n}\n\nfunction buildPolicy<TResource extends string, TActions extends string>(\n  resource: TResource,\n  store: Record<string, ArkosPolicyRule>\n): PolicyWithActions<TResource, TActions> {\n  const rule = <TAction extends string>(\n    action: TAction,\n    config: ArkosPolicyRule\n  ): PolicyWithActions<TResource, TActions | TAction> => {\n    const newStore = { ...store, [action]: config };\n    return buildPolicy<TResource, TActions | TAction>(resource, newStore);\n  };\n\n  const actionEntries = Object.fromEntries(\n    Object.entries(store).flatMap(([action, config]) => {\n      const authEntry: PolicyAuthEntry<TResource, typeof action> = {\n        resource,\n        action,\n        rule: config,\n      };\n\n      const checker: PolicyChecker = authService.permission(action, resource, {\n        [action]: config || {},\n      });\n\n      const canKey = `can${action.charAt(0).toUpperCase()}${action.slice(1)}`;\n\n      return [\n        [action, authEntry],\n        [canKey, checker],\n      ];\n    })\n  );\n\n  return {\n    __type: \"ArkosPolicy\" as const,\n    resource,\n    rule,\n    ...actionEntries,\n  } as unknown as PolicyWithActions<TResource, TActions>;\n}\n"]}

package/dist/esm/components/arkos-route-hook/index.js

@@ -1,4 +1,4 @@
-export function ArkosRouteHook(moduleName) {
+export function ArkosRouteHook(moduleName, configs) {
     const store = {};
     const makeMethod = (name) => (config) => {
         store[name] = config;
@@ -8,6 +8,7 @@ export function ArkosRouteHook(moduleName) {
         __type: "ArkosRouteHook",
         moduleName,
         _store: store,
+        _configs: configs || {},
     };
     const methods = {};
     if (moduleName === "auth") {

package/dist/esm/components/arkos-route-hook/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/arkos-route-hook/index.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,cAAc,CAC5B,UAAa;IAEb,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,MAAM,UAAU,GACd,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,MAAkC,EAAE,EAAE;QACvD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEJ,MAAM,IAAI,GAAG;QACX,MAAM,EAAE,gBAAyB;QACjC,UAAU;QACV,MAAM,EAAE,KAAK;KACd,CAAC;IAEF,MAAM,OAAO,GAGT,EAAE,CAAC;IAEP,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI;YACjB,OAAO;YACP,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,UAAU;YACV,gBAAgB;SACjB,EAAE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;SAAM,IAAI,UAAU,KAAK,aAAa,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;QACvE,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;YAC1E,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI;YACjB,WAAW;YACX,SAAS;YACT,UAAU;YACV,WAAW;YACX,WAAW;YACX,YAAY;YACZ,YAAY;YACZ,YAAY;SACb,EAAE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE3C,OAAO,KAA2C,CAAC;AACrD,CAAC","sourcesContent":["import {\n  ArkosModuleType,\n  ArkosRouteHookReturn,\n  ArkosRouteHookMethodConfig,\n} from \"./types\";\n\ninterface InterceptorStore {\n  [methodName: string]: ArkosRouteHookMethodConfig;\n}\n\n/**\n * Creates an interceptor for a built-in Arkos module or a generated model route.\n *\n * The returned instance exposes only the methods relevant to that module,\n * and is registered into the app via `app.load()`.\n *\n * @param moduleName - The module to intercept. Use `\"auth\"` or `\"file-upload\"`\n * for built-in modules, or any prisma model name string for generated CRUD routes.\n *\n * @example\n * ```ts\n * const userInterceptor = ArkosRouteHook(\"user\");\n *\n * userInterceptor.createOne({\n *   validation: { body: CreateUserSchema },\n *   before: [sanitize],\n *   after: [notify]\n * });\n *\n * app.load(userInterceptor);\n * ```\n * @see {@link https://www.arkosjs.com/docs/core-concepts/components/interceptors}\n */\nexport function ArkosRouteHook<T extends ArkosModuleType>(\n  moduleName: T\n): ArkosRouteHookReturn<T> {\n  const store: InterceptorStore = {};\n\n  const makeMethod =\n    (name: string) => (config: ArkosRouteHookMethodConfig) => {\n      store[name] = config;\n      return proxy;\n    };\n\n  const base = {\n    __type: \"ArkosRouteHook\" as const,\n    moduleName,\n    _store: store,\n  };\n\n  const methods: Record<\n    string,\n    (config: ArkosRouteHookMethodConfig) => unknown\n  > = {};\n\n  if (moduleName === \"auth\") {\n    for (const name of [\n      \"getMe\",\n      \"login\",\n      \"logout\",\n      \"signup\",\n      \"updateMe\",\n      \"updatePassword\",\n    ]) {\n      methods[name] = makeMethod(name);\n    }\n  } else if (moduleName === \"file-upload\" || moduleName === \"fileUpload\") {\n    for (const name of [\"findFile\", \"uploadFile\", \"updateFile\", \"deleteFile\"]) {\n      methods[name] = makeMethod(name);\n    }\n  } else {\n    for (const name of [\n      \"createOne\",\n      \"findOne\",\n      \"findMany\",\n      \"updateOne\",\n      \"deleteOne\",\n      \"createMany\",\n      \"updateMany\",\n      \"deleteMany\",\n    ]) {\n      methods[name] = makeMethod(name);\n    }\n  }\n\n  const proxy = Object.assign(base, methods);\n\n  return proxy as unknown as ArkosRouteHookReturn<T>;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/arkos-route-hook/index.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,cAAc,CAC5B,UAAa,EAAE,OAKd;IAED,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,MAAM,UAAU,GACd,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,MAAkC,EAAE,EAAE;QACvD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEJ,MAAM,IAAI,GAAG;QACX,MAAM,EAAE,gBAAyB;QACjC,UAAU;QACV,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,OAAO,IAAI,EAAE;KACxB,CAAC;IAEF,MAAM,OAAO,GAGT,EAAE,CAAC;IAEP,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI;YACjB,OAAO;YACP,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,UAAU;YACV,gBAAgB;SACjB,EAAE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;SAAM,IAAI,UAAU,KAAK,aAAa,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;QACvE,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;YAC1E,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI;YACjB,WAAW;YACX,SAAS;YACT,UAAU;YACV,WAAW;YACX,WAAW;YACX,YAAY;YACZ,YAAY;YACZ,YAAY;SACb,EAAE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE3C,OAAO,KAA2C,CAAC;AACrD,CAAC","sourcesContent":["import { ArkosPrismaService } from \"../../exports/services\";\nimport {\n  ArkosModuleType,\n  ArkosRouteHookReturn,\n  ArkosRouteHookMethodConfig,\n} from \"./types\";\n\ninterface InterceptorStore {\n  [methodName: string]: ArkosRouteHookMethodConfig;\n}\n\n/**\n * Creates an interceptor for a built-in Arkos module or a generated model route.\n *\n * The returned instance exposes only the methods relevant to that module,\n * and is registered into the app via `app.load()`.\n *\n * @param moduleName - The module to intercept. Use `\"auth\"` or `\"file-upload\"`\n * for built-in modules, or any prisma model name string for generated CRUD routes.\n *\n * @example\n * ```ts\n * const userRouteHook = ArkosRouteHook(\"user\");\n *\n * userRouteHook.createOne({\n *   validation: { body: CreateUserSchema },\n *   before: [sanitize],\n *   after: [notify]\n * });\n *\n * app.load(userRouteHook);\n * ```\n * @see {@link https://www.arkosjs.com/docs/core-concepts/components/route-hooks}\n */\nexport function ArkosRouteHook<T extends ArkosModuleType>(\n  moduleName: T, configs?: {\n    /**\n     * ArkosPrismaService instace for such model\n     */\n    service?: ArkosPrismaService<T>\n  }\n): ArkosRouteHookReturn<T> {\n  const store: InterceptorStore = {};\n\n  const makeMethod =\n    (name: string) => (config: ArkosRouteHookMethodConfig) => {\n      store[name] = config;\n      return proxy;\n    };\n\n  const base = {\n    __type: \"ArkosRouteHook\" as const,\n    moduleName,\n    _store: store,\n    _configs: configs || {},\n  };\n\n  const methods: Record<\n    string,\n    (config: ArkosRouteHookMethodConfig) => unknown\n  > = {};\n\n  if (moduleName === \"auth\") {\n    for (const name of [\n      \"getMe\",\n      \"login\",\n      \"logout\",\n      \"signup\",\n      \"updateMe\",\n      \"updatePassword\",\n    ]) {\n      methods[name] = makeMethod(name);\n    }\n  } else if (moduleName === \"file-upload\" || moduleName === \"fileUpload\") {\n    for (const name of [\"findFile\", \"uploadFile\", \"updateFile\", \"deleteFile\"]) {\n      methods[name] = makeMethod(name);\n    }\n  } else {\n    for (const name of [\n      \"createOne\",\n      \"findOne\",\n      \"findMany\",\n      \"updateOne\",\n      \"deleteOne\",\n      \"createMany\",\n      \"updateMany\",\n      \"deleteMany\",\n    ]) {\n      methods[name] = makeMethod(name);\n    }\n  }\n\n  const proxy = Object.assign(base, methods);\n\n  return proxy as unknown as ArkosRouteHookReturn<T>;\n}\n"]}

package/dist/esm/components/arkos-route-hook/reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../../src/components/arkos-route-hook/reader.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,0CAA0C,CAAC;AAUxE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA4BhD,MAAM,oBAAoB;IAChB,YAAY,CAAC,UAA2B;QAC9C,OAAO,gBAAgB,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3E,CAAC;IAEO,QAAQ,CACd,UAA2B;QAE3B,OAAQ,IAAI,CAAC,YAAY,CAAC,UAAU,CAAS,EAAE,MAAM,IAAI,EAAE,CAAC;IAC9D,CAAC;IAKD,YAAY,CACV,UAAmB,EACnB,SAAqC;QAErC,OAAO,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAKD,aAAa,CACX,UAAmB,EACnB,SAAqC;QAErC,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,SAAmB,CAAC,IAAI,IAAI,CAAC;IAChE,CAAC;IAKD,QAAQ,CACN,UAAmB,EACnB,SAAqC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,SAAmB,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACvB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;IAMD,cAAc,CACZ,UAAmB,EACnB,SAAqC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,SAAmB,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC;QACtE,OAAO,WAAW,CAAC;IACrB,CAAC;IAKD,aAAa,CACX,UAAmB,EACnB,SAAqC;QAErC,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,SAAmB,CAAC,EAAE,UAAU,CAAC;IACpE,CAAC;IAKD,YAAY,CACV,UAAmB,EACnB,SAAqC;QAQrC,MAAM,EACJ,MAAM,GAAG,EAAE,EACX,KAAK,GAAG,EAAE,EACV,OAAO,GAAG,EAAE,GACb,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QACrE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,oBAAoB,EAAE,CAAC","sourcesContent":["import loadableRegistry from \"../../components/arkos-loadable-registry\";\nimport {\n  ArkosModuleType,\n  ArkosRouteHookHooks,\n  ArkosRouteHookMethodConfig,\n  ArkosRouteHookInstance,\n  ArkosAuthRouteHookInstance,\n  ArkosFileUploadRouteHookInstance,\n} from \"./types\";\nimport { ArkosRequestHandler, ArkosRouteConfig } from \"../../exports\";\nimport { kebabCase } from \"../../exports/utils\";\n\ntype PrismaOperations = keyof Omit<\n  ArkosRouteHookInstance<any>,\n  \"__type\" | \"moduleName\"\n>;\n\nexport type OperationByModule<TModule extends ArkosModuleType> =\n  TModule extends \"file-upload\"\n    ? keyof Omit<ArkosFileUploadRouteHookInstance, \"__type\" | \"moduleName\">\n    : TModule extends \"auth\"\n      ? keyof Omit<ArkosAuthRouteHookInstance, \"__type\" | \"moduleName\">\n      : PrismaOperations;\n\n/**\n * Reader for `ArkosRouteHook` instances.\n * Reads config from the global loadable registry by module name.\n *\n * @example\n * ```ts\n * routeHookReader.getHooks(\"user\", \"findMany\")        // { before, after, onError }\n * routeHookReader.getRouteConfig(\"user\", \"findMany\")  // ArkosRouteConfig minus path and hooks\n * routeHookReader.getPrismaArgs(\"user\", \"findMany\")   // prismaArgs for that operation\n * routeHookReader.getFullConfig(\"user\", \"findMany\")   // full raw config object\n * routeHookReader.hasOperation(\"user\", \"findMany\")    // true | false\n * routeHookReader.forOperation(\"user\", \"findMany\")    // { before, after, onError, prismaArgs, routeConfig }\n * ```\n */\nclass ArkosRouteHookReader {\n  private getRouteHook(moduleName: ArkosModuleType) {\n    return loadableRegistry.getItem(\"ArkosRouteHook\", kebabCase(moduleName));\n  }\n\n  private getStore(\n    moduleName: ArkosModuleType\n  ): Record<string, ArkosRouteHookMethodConfig> {\n    return (this.getRouteHook(moduleName) as any)?._store ?? {};\n  }\n\n  /**\n   * Returns true if the routeHook has a config registered for the given operation.\n   */\n  hasOperation<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): boolean {\n    return operation in this.getStore(moduleName);\n  }\n\n  /**\n   * Returns the full raw config for the given operation, or `null` if not registered.\n   */\n  getFullConfig<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): ArkosRouteHookMethodConfig | null {\n    return this.getStore(moduleName)[operation as string] ?? null;\n  }\n\n  /**\n   * Returns only the lifecycle hooks (`before`, `after`, `onError`) for the given operation.\n   */\n  getHooks<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): ArkosRouteHookHooks | undefined {\n    const config = this.getStore(moduleName)[operation as string];\n    if (!config) return {};\n    const { before, after, onError } = config;\n    return { before, after, onError };\n  }\n\n  /**\n   * Returns the `ArkosRouteConfig` portion of the config (excludes `path`, hooks, and `prismaArgs`)\n   * for the given operation.\n   */\n  getRouteConfig<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): Omit<ArkosRouteConfig, \"path\"> | null {\n    const config = this.getStore(moduleName)[operation as string];\n    if (!config) return null;\n    const { before, after, onError, prismaArgs, ...routeConfig } = config;\n    return routeConfig;\n  }\n\n  /**\n   * Returns the `prismaArgs` for the given operation, or `undefined` if not set.\n   */\n  getPrismaArgs<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): Record<string, any> | undefined {\n    return this.getStore(moduleName)[operation as string]?.prismaArgs;\n  }\n\n  /**\n   * Returns all extracted slices for a given operation in one call.\n   */\n  forOperation<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): {\n    before: ArkosRequestHandler[];\n    after: ArkosRequestHandler[];\n    onError: ArkosRequestHandler[];\n    prismaArgs?: Record<string, any>;\n    routeConfig: Omit<ArkosRouteConfig, \"path\">;\n  } {\n    const {\n      before = [],\n      after = [],\n      onError = [],\n    } = this.getHooks(moduleName, operation) || {};\n    const prismaArgs = this.getPrismaArgs(moduleName, operation);\n    const routeConfig = this.getRouteConfig(moduleName, operation) ?? {};\n    return { before, after, onError, prismaArgs, routeConfig };\n  }\n}\n\nexport const routeHookReader = new ArkosRouteHookReader();\n"]}
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../../src/components/arkos-route-hook/reader.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,0CAA0C,CAAC;AAUxE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA4BhD,MAAM,oBAAoB;IAChB,YAAY,CAAC,UAA2B;QAC9C,OAAO,gBAAgB,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3E,CAAC;IAEO,QAAQ,CACd,UAA2B;QAE3B,OAAQ,IAAI,CAAC,YAAY,CAAC,UAAU,CAAS,EAAE,MAAM,IAAI,EAAE,CAAC;IAC9D,CAAC;IAKD,YAAY,CACV,UAAmB,EACnB,SAAqC;QAErC,OAAO,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAKD,aAAa,CACX,UAAmB,EACnB,SAAqC;QAErC,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,SAAmB,CAAC,IAAI,IAAI,CAAC;IAChE,CAAC;IAKD,QAAQ,CACN,UAAmB,EACnB,SAAqC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,SAAmB,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACvB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;IAMD,cAAc,CACZ,UAAmB,EACnB,SAAqC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,SAAmB,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC;QACtE,OAAO,WAAW,CAAC;IACrB,CAAC;IAKD,aAAa,CACX,UAAmB,EACnB,SAAqC;QAErC,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,SAAmB,CAAC,EAAE,UAAU,CAAC;IACpE,CAAC;IAKD,YAAY,CACV,UAAmB,EACnB,SAAqC;QAKrC,MAAM,EACJ,MAAM,GAAG,EAAE,EACX,KAAK,GAAG,EAAE,EACV,OAAO,GAAG,EAAE,GACb,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QACrE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,oBAAoB,EAAE,CAAC","sourcesContent":["import loadableRegistry from \"../../components/arkos-loadable-registry\";\nimport {\n  ArkosModuleType,\n  ArkosRouteHookHooks,\n  ArkosRouteHookMethodConfig,\n  ArkosRouteHookInstance,\n  ArkosAuthRouteHookInstance,\n  ArkosFileUploadRouteHookInstance,\n} from \"./types\";\nimport { ArkosRouteConfig } from \"../../exports\";\nimport { kebabCase } from \"../../exports/utils\";\n\ntype PrismaOperations = keyof Omit<\n  ArkosRouteHookInstance<any>,\n  \"__type\" | \"moduleName\" | \"_configs\"\n>;\n\nexport type OperationByModule<TModule extends ArkosModuleType> =\n  TModule extends \"file-upload\"\n  ? keyof Omit<ArkosFileUploadRouteHookInstance, \"__type\" | \"moduleName\" | \"service\">\n  : TModule extends \"auth\"\n  ? keyof Omit<ArkosAuthRouteHookInstance, \"__type\" | \"moduleName\" | \"service\">\n  : PrismaOperations;\n\n/**\n * Reader for `ArkosRouteHook` instances.\n * Reads config from the global loadable registry by module name.\n *\n * @example\n * ```ts\n * routeHookReader.getHooks(\"user\", \"findMany\")        // { before, after, onError }\n * routeHookReader.getRouteConfig(\"user\", \"findMany\")  // ArkosRouteConfig minus path and hooks\n * routeHookReader.getPrismaArgs(\"user\", \"findMany\")   // prismaArgs for that operation\n * routeHookReader.getFullConfig(\"user\", \"findMany\")   // full raw config object\n * routeHookReader.hasOperation(\"user\", \"findMany\")    // true | false\n * routeHookReader.forOperation(\"user\", \"findMany\")    // { before, after, onError, prismaArgs, routeConfig }\n * ```\n */\nclass ArkosRouteHookReader {\n  private getRouteHook(moduleName: ArkosModuleType) {\n    return loadableRegistry.getItem(\"ArkosRouteHook\", kebabCase(moduleName));\n  }\n\n  private getStore(\n    moduleName: ArkosModuleType\n  ): Record<string, ArkosRouteHookMethodConfig> {\n    return (this.getRouteHook(moduleName) as any)?._store ?? {};\n  }\n\n  /**\n   * Returns true if the routeHook has a config registered for the given operation.\n   */\n  hasOperation<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): boolean {\n    return operation in this.getStore(moduleName);\n  }\n\n  /**\n   * Returns the full raw config for the given operation, or `null` if not registered.\n   */\n  getFullConfig<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): ArkosRouteHookMethodConfig | null {\n    return this.getStore(moduleName)[operation as string] ?? null;\n  }\n\n  /**\n   * Returns only the lifecycle hooks (`before`, `after`, `onError`) for the given operation.\n   */\n  getHooks<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): ArkosRouteHookHooks | undefined {\n    const config = this.getStore(moduleName)[operation as string];\n    if (!config) return {};\n    const { before, after, onError } = config;\n    return { before, after, onError };\n  }\n\n  /**\n   * Returns the `ArkosRouteConfig` portion of the config (excludes `path`, hooks, and `prismaArgs`)\n   * for the given operation.\n   */\n  getRouteConfig<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): Omit<ArkosRouteConfig, \"path\"> | null {\n    const config = this.getStore(moduleName)[operation as string];\n    if (!config) return null;\n    const { before, after, onError, prismaArgs, ...routeConfig } = config;\n    return routeConfig;\n  }\n\n  /**\n   * Returns the `prismaArgs` for the given operation, or `undefined` if not set.\n   */\n  getPrismaArgs<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): Record<string, any> | undefined {\n    return this.getStore(moduleName)[operation as string]?.prismaArgs;\n  }\n\n  /**\n   * Returns all extracted slices for a given operation in one call.\n   */\n  forOperation<TModule extends ArkosModuleType>(\n    moduleName: TModule,\n    operation: OperationByModule<TModule>\n  ): ArkosRouteHookHooks & {\n    prismaArgs?: Record<string, any>;\n    routeConfig: Omit<ArkosRouteConfig, \"path\">;\n  } {\n    const {\n      before = [],\n      after = [],\n      onError = [],\n    } = this.getHooks(moduleName, operation) || {};\n    const prismaArgs = this.getPrismaArgs(moduleName, operation);\n    const routeConfig = this.getRouteConfig(moduleName, operation) ?? {};\n    return { before, after, onError, prismaArgs, routeConfig };\n  }\n}\n\nexport const routeHookReader = new ArkosRouteHookReader();\n"]}

package/dist/esm/components/arkos-route-hook/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/arkos-route-hook/types.ts"],"names":[],"mappings":"","sourcesContent":["import { ArkosRouteConfig } from \"../../exports\";\nimport { PrismaModels } from \"../../generated\";\nimport { ArkosRequestHandler } from \"../../types\";\n\nexport type Models = keyof PrismaModels<any>;\n\nexport interface ArkosRouteHookHooks {\n  before?: ArkosRequestHandler[];\n  after?: ArkosRequestHandler[];\n  onError?: ArkosRequestHandler[];\n}\n\n/**\n * Extracts the correct Prisma args type for a given model and operation.\n * Falls back to `Record<string, any>` if the model or operation is not found.\n */\ntype PrismaQueryFor<\n  TModel extends string,\n  TOp extends string,\n> = TModel extends keyof PrismaModels<any>\n  ? TOp extends keyof PrismaModels<any>[TModel]\n    ? Partial<PrismaModels<any>[TModel][TOp]>\n    : Record<string, any>\n  : Record<string, any>;\n\n/**\n * Full config for an interceptor method — inherits all ArkosRouteConfig options\n * (validation, auth, rate limiting, etc.) minus `path`, plus lifecycle hooks,\n * plus `prismaQuery` typed to the specific model and operation's Prisma args.\n */\nexport type ArkosRouteHookMethodConfig<\n  TModel extends string = string,\n  TOp extends string = string,\n> = Omit<ArkosRouteConfig, \"path\"> &\n  ArkosRouteHookHooks & {\n    /**\n     * Prisma options merged into this operation's query.\n     * Typed against the model's actual Prisma args for this operation.\n     */\n    prismaArgs?: PrismaQueryFor<TModel, TOp>;\n  };\n\n/**\n * Union of all valid module name types for ArkosRouteHook.\n * `string & {}` preserves autocomplete for \"auth\" and \"file-upload\"\n * while still accepting arbitrary model names.\n */\nexport type ArkosModuleType = \"auth\" | \"file-upload\" | Models;\n\n/**\n * Route hook instance for standard CRUD model routes.\n * Each method's `prismaQuery` is typed against the model's actual Prisma args.\n */\nexport interface ArkosRouteHookInstance<TModel extends Models> {\n  readonly __type: \"ArkosRouteHook\";\n  readonly moduleName: TModel;\n\n  createOne(config: ArkosRouteHookMethodConfig<TModel, \"CreateArgs\">): this;\n  findOne(config: ArkosRouteHookMethodConfig<TModel, \"FindFirstArgs\">): this;\n  findMany(config: ArkosRouteHookMethodConfig<TModel, \"FindManyArgs\">): this;\n  updateOne(config: ArkosRouteHookMethodConfig<TModel, \"UpdateArgs\">): this;\n  deleteOne(config: ArkosRouteHookMethodConfig<TModel, \"DeleteArgs\">): this;\n  createMany(\n    config: ArkosRouteHookMethodConfig<TModel, \"CreateManyArgs\">\n  ): this;\n  updateMany(\n    config: ArkosRouteHookMethodConfig<TModel, \"UpdateManyArgs\">\n  ): this;\n  deleteMany(\n    config: ArkosRouteHookMethodConfig<TModel, \"DeleteManyArgs\">\n  ): this;\n}\n\n/**\n * Route hook instance for the built-in auth module.\n * Only exposes methods relevant to auth routes.\n */\nexport interface ArkosAuthRouteHookInstance {\n  readonly __type: \"ArkosRouteHook\";\n  readonly moduleName: \"auth\";\n\n  getMe(config: ArkosRouteHookMethodConfig): this;\n  login(config: ArkosRouteHookMethodConfig): this;\n  logout(config: ArkosRouteHookMethodConfig): this;\n  signup(config: ArkosRouteHookMethodConfig): this;\n  updateMe(config: ArkosRouteHookMethodConfig): this;\n  deleteMe(config: ArkosRouteHookMethodConfig): this;\n  updatePassword(config: ArkosRouteHookMethodConfig): this;\n  findOneAuthAction(config: ArkosRouteHookMethodConfig): this;\n  findManyAuthAction(config: ArkosRouteHookMethodConfig): this;\n}\n\n/**\n * Route hook instance for the built-in file-upload module.\n * Only exposes methods relevant to file routes.\n */\nexport interface ArkosFileUploadRouteHookInstance {\n  readonly __type: \"ArkosRouteHook\";\n  readonly moduleName: \"file-upload\";\n\n  findFile(config: Omit<ArkosRouteHookMethodConfig, \"after\">): this;\n  uploadFile(config: ArkosRouteHookMethodConfig): this;\n  updateFile(config: ArkosRouteHookMethodConfig): this;\n  deleteFile(config: ArkosRouteHookMethodConfig): this;\n}\n\n/**\n * Maps the module type string to its corresponding interceptor instance type.\n * Enables ArkosRouteHook() to return a narrowed type based on the argument.\n */\nexport type ArkosRouteHookReturn<T extends ArkosModuleType> = T extends \"auth\"\n  ? ArkosAuthRouteHookInstance\n  : T extends \"file-upload\"\n    ? ArkosFileUploadRouteHookInstance\n    : ArkosRouteHookInstance<T>;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/arkos-route-hook/types.ts"],"names":[],"mappings":"","sourcesContent":["import { ArkosRouteConfig } from \"../../exports\";\nimport { ArkosPrismaService } from \"../../exports/services\";\nimport { PrismaModels } from \"../../generated\";\nimport { ArkosErrorRequestHandler, ArkosRequestHandler } from \"../../types\";\n\nexport type Models = keyof PrismaModels<any>;\n\nexport interface ArkosRouteHookHooks {\n  before?: ArkosRequestHandler[] | ArkosRequestHandler;\n  after?: ArkosRequestHandler[] | ArkosRequestHandler;\n  onError?: ArkosErrorRequestHandler[] | ArkosErrorRequestHandler;\n}\n\n/**\n * Extracts the correct Prisma args type for a given model and operation.\n * Falls back to `Record<string, any>` if the model or operation is not found.\n */\ntype PrismaQueryFor<\n  TModel extends string,\n  TOp extends string,\n> = TModel extends keyof PrismaModels<any>\n  ? TOp extends keyof PrismaModels<any>[TModel]\n  ? Partial<PrismaModels<any>[TModel][TOp]>\n  : Record<string, any>\n  : Record<string, any>;\n\n/**\n * Full config for an interceptor method — inherits all ArkosRouteConfig options\n * (validation, auth, rate limiting, etc.) minus `path`, plus lifecycle hooks,\n * plus `prismaArgs` typed to the specific model and operation's Prisma args.\n */\nexport type ArkosRouteHookMethodConfig<\n  TModel extends string = string,\n  TOp extends string = string,\n> = Omit<ArkosRouteConfig, \"path\"> &\n  ArkosRouteHookHooks & {\n    /**\n     * Prisma options merged into this operation's query.\n     * Typed against the model's actual Prisma args for this operation.\n     */\n    prismaArgs?: PrismaQueryFor<TModel, TOp>;\n  };\n\n/**\n * Union of all valid module name types for ArkosRouteHook.\n * `string & {}` preserves autocomplete for \"auth\" and \"file-upload\"\n * while still accepting arbitrary model names.\n */\nexport type ArkosModuleType = \"auth\" | \"file-upload\" | Models;\n\n/**\n * Route hook instance for standard CRUD model routes.\n * Each method's `prismaQuery` is typed against the model's actual Prisma args.\n */\nexport interface ArkosRouteHookInstance<TModel extends Models> {\n  readonly __type: \"ArkosRouteHook\";\n  readonly moduleName: TModel;\n  readonly _configs: {\n    readonly service?: ArkosPrismaService;\n  }\n\n  createOne(config: ArkosRouteHookMethodConfig<TModel, \"CreateArgs\">): this;\n  findOne(config: ArkosRouteHookMethodConfig<TModel, \"FindFirstArgs\">): this;\n  findMany(config: ArkosRouteHookMethodConfig<TModel, \"FindManyArgs\">): this;\n  updateOne(config: ArkosRouteHookMethodConfig<TModel, \"UpdateArgs\">): this;\n  deleteOne(config: ArkosRouteHookMethodConfig<TModel, \"DeleteArgs\">): this;\n  createMany(\n    config: ArkosRouteHookMethodConfig<TModel, \"CreateManyArgs\">\n  ): this;\n  updateMany(\n    config: ArkosRouteHookMethodConfig<TModel, \"UpdateManyArgs\">\n  ): this;\n  deleteMany(\n    config: ArkosRouteHookMethodConfig<TModel, \"DeleteManyArgs\">\n  ): this;\n}\n\n/**\n * Route hook instance for the built-in auth module.\n * Only exposes methods relevant to auth routes.\n */\nexport interface ArkosAuthRouteHookInstance {\n  readonly __type: \"ArkosRouteHook\";\n  readonly moduleName: \"auth\";\n\n  getMe(config: ArkosRouteHookMethodConfig): this;\n  login(config: ArkosRouteHookMethodConfig): this;\n  logout(config: ArkosRouteHookMethodConfig): this;\n  signup(config: ArkosRouteHookMethodConfig): this;\n  updateMe(config: ArkosRouteHookMethodConfig): this;\n  deleteMe(config: ArkosRouteHookMethodConfig): this;\n  updatePassword(config: ArkosRouteHookMethodConfig): this;\n  findOneAuthAction(config: ArkosRouteHookMethodConfig): this;\n  findManyAuthAction(config: ArkosRouteHookMethodConfig): this;\n}\n\n/**\n * Route hook instance for the built-in file-upload module.\n * Only exposes methods relevant to file routes.\n */\nexport interface ArkosFileUploadRouteHookInstance {\n  readonly __type: \"ArkosRouteHook\";\n  readonly moduleName: \"file-upload\";\n\n  findFile(config: Omit<ArkosRouteHookMethodConfig, \"after\">): this;\n  uploadFile(config: ArkosRouteHookMethodConfig): this;\n  updateFile(config: ArkosRouteHookMethodConfig): this;\n  deleteFile(config: ArkosRouteHookMethodConfig): this;\n}\n\n/**\n * Maps the module type string to its corresponding interceptor instance type.\n * Enables ArkosRouteHook() to return a narrowed type based on the argument.\n */\nexport type ArkosRouteHookReturn<T extends ArkosModuleType> = T extends \"auth\"\n  ? ArkosAuthRouteHookInstance\n  : T extends \"file-upload\"\n  ? ArkosFileUploadRouteHookInstance\n  : ArkosRouteHookInstance<T>;\n"]}

package/dist/esm/exports/error-handler/index.js

@@ -1,4 +1,5 @@
 import catchAsync from "../../modules/error-handler/utils/catch-async.js";
 import AppError from "../../modules/error-handler/utils/app-error.js";
+export * from "../../modules/error-handler/utils/errors.js";
 export { catchAsync, AppError };
 //# sourceMappingURL=index.js.map

package/dist/esm/exports/error-handler/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/exports/error-handler/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,+CAA+C,CAAC;AACvE,OAAO,QAAQ,MAAM,6CAA6C,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC","sourcesContent":["import catchAsync from \"../../modules/error-handler/utils/catch-async\";\nimport AppError from \"../../modules/error-handler/utils/app-error\";\n\nexport { catchAsync, AppError };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/exports/error-handler/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,+CAA+C,CAAC;AACvE,OAAO,QAAQ,MAAM,6CAA6C,CAAC;AAEnE,cAAc,0CAA0C,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC","sourcesContent":["import catchAsync from \"../../modules/error-handler/utils/catch-async\";\nimport AppError from \"../../modules/error-handler/utils/app-error\";\n\nexport * from \"../../modules/error-handler/utils/errors\";\nexport { catchAsync, AppError };\n"]}

package/dist/esm/exports/index.js

@@ -2,10 +2,10 @@ import { BaseController } from "./../modules/base/base.controller.js";
 import { getArkosConfig } from "../server.js";
 import ArkosRouter from "../utils/arkos-router/index.js";
 import { loadEnvironmentVariables } from "../utils/dotenv.helpers.js";
-import { arkos } from "../app.js";
+import arkos from "../app.js";
 import { ArkosRouteHook } from "../components/arkos-route-hook/index.js";
-import { ArkosServiceHook } from "../components/arkos-service-hook/index.js";
 import { ArkosPolicy } from "../components/arkos-policy/index.js";
-export { BaseController, loadEnvironmentVariables, getArkosConfig, ArkosRouteHook, ArkosServiceHook, ArkosRouter, ArkosPolicy, };
+import { isProduction } from "../utils/helpers/arkos-config.helpers.js";
+export { BaseController, loadEnvironmentVariables, getArkosConfig, ArkosRouteHook, ArkosRouter, ArkosPolicy, isProduction, };
 export default arkos;
 //# sourceMappingURL=index.js.map

package/dist/esm/exports/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/exports/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAUhD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAIzD,OAAO,EAOL,cAAc,EAGd,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,WAAW,EAGX,WAAW,GAEZ,CAAC;AAEF,eAAe,KAAK,CAAC","sourcesContent":["import { RouterConfig } from \"../types/router-config\";\nimport { BaseController } from \"./../modules/base/base.controller\";\nimport { getArkosConfig } from \"../server\";\nimport ArkosRouter from \"../utils/arkos-router\";\nimport { IArkosRouter } from \"../utils/arkos-router/types\";\nimport { ArkosRouteConfig } from \"../utils/arkos-router/types\";\nimport {\n  ArkosRequest,\n  ArkosResponse,\n  ArkosNextFunction,\n  ArkosRequestHandler,\n} from \"../types\";\nimport { ArkosConfig } from \"../types/new-arkos-config\";\nimport { loadEnvironmentVariables } from \"../utils/dotenv.helpers\";\nimport { arkos } from \"../app\";\nimport { ArkosRouteHook } from \"../components/arkos-route-hook\";\nimport { ArkosServiceHook } from \"../components/arkos-service-hook\";\nimport { ArkosRouteHookInstance } from \"../components/arkos-route-hook/types\";\nimport { ArkosPolicy } from \"../components/arkos-policy\";\nimport { IArkosPolicy } from \"../components/arkos-policy/types\";\nimport type { ArkosLoadable } from \"../types/arkos\";\n\nexport {\n  ArkosLoadable,\n  ArkosRequest,\n  ArkosResponse,\n  ArkosNextFunction,\n  ArkosRequestHandler,\n  IArkosRouter,\n  BaseController,\n  ArkosConfig,\n  RouterConfig,\n  loadEnvironmentVariables,\n  getArkosConfig,\n  ArkosRouteHook,\n  ArkosServiceHook,\n  ArkosRouter,\n  ArkosRouteConfig,\n  ArkosRouteHookInstance,\n  ArkosPolicy,\n  IArkosPolicy,\n};\n\nexport default arkos;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/exports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAUhD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAIzD,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAErE,OAAO,EAOL,cAAc,EAEd,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,WAAW,EAGX,WAAW,EAGX,YAAY,GACb,CAAC;AAEF,eAAe,KAAK,CAAC","sourcesContent":["import { BaseController } from \"./../modules/base/base.controller\";\nimport { getArkosConfig } from \"../server\";\nimport ArkosRouter from \"../utils/arkos-router\";\nimport { IArkosRouter } from \"../utils/arkos-router/types\";\nimport { ArkosRouteConfig } from \"../utils/arkos-router/types\";\nimport {\n  ArkosRequest,\n  ArkosResponse,\n  ArkosNextFunction,\n  ArkosRequestHandler,\n} from \"../types\";\nimport { ArkosConfig } from \"../types/new-arkos-config\";\nimport { loadEnvironmentVariables } from \"../utils/dotenv.helpers\";\nimport arkos from \"../app\";\nimport { ArkosRouteHook } from \"../components/arkos-route-hook\";\nimport { ArkosRouteHookInstance } from \"../components/arkos-route-hook/types\";\nimport { ArkosPolicy } from \"../components/arkos-policy\";\nimport { IArkosPolicy } from \"../components/arkos-policy/types\";\nimport type { ArkosLoadable } from \"../types/arkos\";\nimport { ArkosFile } from \"../types/upload\";\nimport { isProduction } from \"../utils/helpers/arkos-config.helpers\";\n\nexport {\n  ArkosLoadable,\n  ArkosRequest,\n  ArkosResponse,\n  ArkosNextFunction,\n  ArkosRequestHandler,\n  IArkosRouter,\n  BaseController,\n  ArkosConfig,\n  loadEnvironmentVariables,\n  getArkosConfig,\n  ArkosRouteHook,\n  ArkosRouter,\n  ArkosRouteConfig,\n  ArkosRouteHookInstance,\n  ArkosPolicy,\n  IArkosPolicy,\n  ArkosFile,\n  isProduction,\n};\n\nexport default arkos;\n"]}

package/dist/esm/exports/middlewares/index.js

@@ -1,2 +1,2 @@
-export { addPrismaQueryOptionsToRequest, handleRequestBodyValidationAndTransformation, } from "../../modules/base/base.middlewares.js";
+export { addPrismaQueryOptionsToRequest, } from "../../modules/base/base.middlewares.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/exports/middlewares/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/exports/middlewares/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,4CAA4C,GAC7C,MAAM,qCAAqC,CAAC","sourcesContent":["export {\n  addPrismaQueryOptionsToRequest,\n  handleRequestBodyValidationAndTransformation,\n} from \"../../modules/base/base.middlewares\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/exports/middlewares/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,GAC/B,MAAM,qCAAqC,CAAC","sourcesContent":["export {\n  addPrismaQueryOptionsToRequest,\n} from \"../../modules/base/base.middlewares\";\n"]}

package/dist/esm/exports/services/index.js

@@ -1,10 +1,10 @@
 import { getFileUploadServices, FileUploadService, } from "../../modules/file-upload/file-upload.service.js";
 import authService, { AuthService } from "../../modules/auth/auth.service.js";
 import emailService, { EmailService } from "../../modules/email/email.service.js";
-import { BaseService } from "../../modules/base/base.service.js";
+import { ArkosPrismaService } from "../../modules/base/base.service.js";
 import authActionService from "../../modules/auth/utils/services/auth-action.service.js";
 export { authService, AuthService, authActionService };
-export { BaseService, };
+export { ArkosPrismaService, };
 export { emailService, EmailService };
 export { getFileUploadServices, FileUploadService };
 //# sourceMappingURL=index.js.map

package/dist/esm/exports/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/exports/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,+CAA+C,CAAC;AAEvD,OAAO,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,YAAY,EAAE,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,iBAAiB,MAAM,uDAAuD,CAAC;AAoCtF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AAKvD,OAAO,EACL,WAAW,GA8BZ,CAAC;AAKF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAgB,CAAC;AAKpD,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import {\n  getFileUploadServices,\n  FileUploadService,\n} from \"../../modules/file-upload/file-upload.service\";\nimport { EmailOptions } from \"../../modules/email/email.service\";\nimport authService, { AuthService } from \"../../modules/auth/auth.service\";\nimport emailService, { EmailService } from \"../../modules/email/email.service\";\nimport { BaseService } from \"../../modules/base/base.service\";\nimport authActionService from \"../../modules/auth/utils/services/auth-action.service\";\nimport {\n  ServiceHookContext,\n  BeforeCreateOneHookArgs,\n  AfterCreateOneHookArgs,\n  BeforeCreateManyHookArgs,\n  AfterCreateManyHookArgs,\n  BeforeCountHookArgs,\n  AfterCountHookArgs,\n  BeforeFindManyHookArgs,\n  AfterFindManyHookArgs,\n  BeforeFindOneHookArgs,\n  AfterFindOneHookArgs,\n  BeforeUpdateOneHookArgs,\n  AfterUpdateOneHookArgs,\n  BeforeUpdateManyHookArgs,\n  AfterUpdateManyHookArgs,\n  BeforeDeleteOneHookArgs,\n  AfterDeleteOneHookArgs,\n  BeforeDeleteManyHookArgs,\n  AfterDeleteManyHookArgs,\n  OnCreateOneErrorHookArgs,\n  OnCreateManyErrorHookArgs,\n  OnCountErrorHookArgs,\n  OnFindManyErrorHookArgs,\n  OnFindByIdErrorHookArgs,\n  OnFindOneErrorHookArgs,\n  OnUpdateOneErrorHookArgs,\n  OnUpdateManyErrorHookArgs,\n  OnDeleteOneErrorHookArgs,\n  OnDeleteManyErrorHookArgs,\n} from \"../../components/arkos-service-hook/types\";\n\n/**\n * Authentication service.\n */\nexport { authService, AuthService, authActionService };\n\n/**\n * Base service.\n */\nexport {\n  BaseService,\n  ServiceHookContext,\n  BeforeCreateOneHookArgs,\n  AfterCreateOneHookArgs,\n  BeforeCreateManyHookArgs,\n  AfterCreateManyHookArgs,\n  BeforeCountHookArgs,\n  AfterCountHookArgs,\n  BeforeFindManyHookArgs,\n  AfterFindManyHookArgs,\n  BeforeFindOneHookArgs,\n  AfterFindOneHookArgs,\n  BeforeUpdateOneHookArgs,\n  AfterUpdateOneHookArgs,\n  BeforeUpdateManyHookArgs,\n  AfterUpdateManyHookArgs,\n  BeforeDeleteOneHookArgs,\n  AfterDeleteOneHookArgs,\n  BeforeDeleteManyHookArgs,\n  AfterDeleteManyHookArgs,\n  OnCreateOneErrorHookArgs,\n  OnCreateManyErrorHookArgs,\n  OnCountErrorHookArgs,\n  OnFindManyErrorHookArgs,\n  OnFindByIdErrorHookArgs,\n  OnFindOneErrorHookArgs,\n  OnUpdateOneErrorHookArgs,\n  OnUpdateManyErrorHookArgs,\n  OnDeleteOneErrorHookArgs,\n  OnDeleteManyErrorHookArgs,\n};\n\n/**\n * Email service.\n */\nexport { emailService, EmailService, EmailOptions };\n\n/**\n * File upload services.\n */\nexport { getFileUploadServices, FileUploadService };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/exports/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,+CAA+C,CAAC;AAEvD,OAAO,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,YAAY,EAAE,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,iBAAiB,MAAM,uDAAuD,CAAC;AAMtF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AAKvD,OAAO,EACL,kBAAkB,GAEnB,CAAC;AAKF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAgB,CAAC;AAKpD,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import {\n  getFileUploadServices,\n  FileUploadService,\n} from \"../../modules/file-upload/file-upload.service\";\nimport { EmailOptions } from \"../../modules/email/email.service\";\nimport authService, { AuthService } from \"../../modules/auth/auth.service\";\nimport emailService, { EmailService } from \"../../modules/email/email.service\";\nimport { ArkosPrismaService } from \"../../modules/base/base.service\";\nimport authActionService from \"../../modules/auth/utils/services/auth-action.service\";\nimport { ServiceHookContext } from \"../../modules/base/types/base.service.types\";\n\n/**\n * Authentication service.\n */\nexport { authService, AuthService, authActionService };\n\n/**\n * Base service.\n */\nexport {\n  ArkosPrismaService,\n  ServiceHookContext,\n};\n\n/**\n * Email service.\n */\nexport { emailService, EmailService, EmailOptions };\n\n/**\n * File upload services.\n */\nexport { getFileUploadServices, FileUploadService };\n"]}

package/dist/esm/exports/websockets.js

@@ -0,0 +1,5 @@
+import ArkosGateway from "../components/arkos-gateway/arkos-gateway.js";
+export { IArkosGateway } from "../components/arkos-gateway/arkos-gateway.js";
+export { ArkosGatewayController } from "../components/arkos-gateway/types.js";
+export { ArkosGateway };
+//# sourceMappingURL=websockets.js.map

package/dist/esm/exports/websockets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websockets.js","sourceRoot":"","sources":["../../../src/exports/websockets.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,2CAA2C,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAa3E,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import ArkosGateway from \"../components/arkos-gateway/arkos-gateway\";\n\nexport { IArkosGateway } from \"../components/arkos-gateway/arkos-gateway\";\nexport { ArkosGatewayController } from \"../components/arkos-gateway/types\";\nexport type {\n  ArkosSocket,\n  ArkosGatewayConfig,\n  ArkosGatewayEventConfig,\n  ArkosGatewayHandler,\n  ArkosGatewayPipe,\n  ArkosGatewayConnectionHandler,\n  ArkosGatewayErrorHandler,\n  ArkosGatewayAckFn,\n  ArkosBroadcastOperator,\n} from \"../components/arkos-gateway/types\";\n\nexport { ArkosGateway };\n"]}

package/dist/esm/generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"generated.js","sourceRoot":"","sources":["../../src/generated.ts"],"names":[],"mappings":"AAyIA,MAAM,OAAO,YAAY;CAExB","sourcesContent":["/**\n * @maintainers THIS FILE IS A STUB — DO NOT PUT REAL LOGIC HERE.\n *\n * This file exists only so the Arkos source compiles during development.\n * It is completely overwritten at build time by `scripts/generate-post-build-types.ts`,\n * which replaces it with re-exports from `@arkosjs/types` — a folder generated\n * in the user's `node_modules` by `npx arkos prisma generate`.\n *\n * This is the single gateway for all Prisma-dependent types and values.\n * DO NOT import from `@prisma/client` or any user-project-specific module\n * anywhere else in the codebase — add it here instead.\n *\n * To add a new generated type or value:\n *   1. Add a stub export here\n *   2. Add the real export to the `npx arkos prisma generate` output in\n *      `src/utils/cli/commands/prisma-generate.command.ts`\n *   3. Add it to the overwrite in `scripts/generate-post-build-types.ts`\n */\n\n/**\n * A map of all Prisma models in the user's project.\n * Each key is a kebab-case model name, each value contains the full\n * Prisma delegate, payload, and args types for that model.\n *\n * Stub during Arkos development — replaced with real generated types\n * after `npx arkos prisma generate`.\n *\n * @example\n * ```ts\n * class BaseService<TModelName extends keyof PrismaModels<any>> {}\n * ```\n */\n\ninterface StubWhereArgs {\n  where?: { id?: any; [key: string]: any };\n  [key: string]: any;\n}\n\ninterface StubWhereUniqueArgs {\n  where: { id?: any; [key: string]: any };\n  [key: string]: any;\n}\n\ninterface StubDataArgs {\n  data: Record<string, any>;\n  [key: string]: any;\n}\n\ninterface StubWhereDataArgs {\n  where: { id?: any; [key: string]: any };\n  data: Record<string, any>;\n  [key: string]: any;\n}\n\ninterface StubPaginationArgs extends StubWhereArgs {\n  orderBy?: Record<string, any>;\n  select?: Record<string, any>;\n  include?: Record<string, any>;\n  skip?: number;\n  take?: number;\n  cursor?: Record<string, any>;\n}\n\ninterface StubCountArgs extends StubWhereArgs {\n  select?: Record<string, any>;\n  orderBy?: Record<string, any>;\n  skip?: number;\n  take?: number;\n  cursor?: Record<string, any>;\n}\n\n/**\n * Extracts the `where` filter type from a Prisma args type.\n * @example ExtractPrismaFilters<PrismaModels<any>['user']['FindManyArgs']>\n */\nexport type ExtractPrismaFilters<T> = T extends {\n  where?: infer W;\n  [key: string]: any;\n}\n  ? W\n  : any;\n\n/**\n * Extracts the `data` type from a Prisma args type.\n * @example ExtractPrismaData<PrismaModels<any>['user']['CreateArgs']>\n */\nexport type ExtractPrismaData<T> = T extends {\n  data: infer D;\n  [key: string]: any;\n}\n  ? D\n  : any;\n\n/**\n * Extracts query options from a Prisma args type by omitting the specified keys.\n * @example ExtractPrismaQueryOptions<PrismaModels<any>['user']['CreateArgs'], 'data'>\n */\nexport type ExtractPrismaQueryOptions<T, K extends keyof T = never> = Omit<\n  T,\n  K\n>;\n\n/**\n * A map of all Prisma models in the user's project.\n * Each key is a kebab-case model name, each value contains the full\n * Prisma delegate, payload, and args types for that model.\n *\n * Stub during Arkos development — replaced with real generated types\n * after `npx arkos prisma generate`.\n *\n * @example\n * ```ts\n * class BaseService<TModelName extends keyof PrismaModels<any>> {}\n * ```\n */\nexport type PrismaModels<T extends Record<string, any>> = Record<\n  string,\n  {\n    Delegate: Record<string, (...args: any[]) => any>;\n    GetPayload: Record<string, any>;\n    FindManyArgs: StubPaginationArgs;\n    FindFirstArgs: StubPaginationArgs;\n    CreateArgs: StubDataArgs;\n    CreateManyArgs: StubDataArgs;\n    UpdateArgs: StubWhereDataArgs;\n    UpdateManyArgs: StubWhereDataArgs;\n    DeleteArgs: StubWhereUniqueArgs;\n    DeleteManyArgs: StubWhereArgs;\n    CountArgs: StubCountArgs;\n  }\n>;\n\n/**\n * Stub PrismaClient for Arkos development.\n * Replaced with the real `PrismaClient` from `@prisma/client` after\n * `npx arkos prisma generate`.\n */\nexport class PrismaClient {\n  [key: string]: any;\n}\n"]}
+{"version":3,"file":"generated.js","sourceRoot":"","sources":["../../src/generated.ts"],"names":[],"mappings":"AAyIA,MAAM,OAAO,YAAY;CAExB","sourcesContent":["/**\n * @maintainers THIS FILE IS A STUB — DO NOT PUT REAL LOGIC HERE.\n *\n * This file exists only so the Arkos source compiles during development.\n * It is completely overwritten at build time by `scripts/generate-post-build-types.ts`,\n * which replaces it with re-exports from `@arkosjs/types` — a folder generated\n * in the user's `node_modules` by `npx arkos prisma generate`.\n *\n * This is the single gateway for all Prisma-dependent types and values.\n * DO NOT import from `@prisma/client` or any user-project-specific module\n * anywhere else in the codebase — add it here instead.\n *\n * To add a new generated type or value:\n *   1. Add a stub export here\n *   2. Add the real export to the `npx arkos prisma generate` output in\n *      `src/utils/cli/commands/prisma-generate.command.ts`\n *   3. Add it to the overwrite in `scripts/generate-post-build-types.ts`\n */\n\n/**\n * A map of all Prisma models in the user's project.\n * Each key is a kebab-case model name, each value contains the full\n * Prisma delegate, payload, and args types for that model.\n *\n * Stub during Arkos development — replaced with real generated types\n * after `npx arkos prisma generate`.\n *\n * @example\n * ```ts\n * class ArkosPrismaService<TModelName extends keyof PrismaModels<any>> {}\n * ```\n */\n\ninterface StubWhereArgs {\n  where?: { id?: any; [key: string]: any };\n  [key: string]: any;\n}\n\ninterface StubWhereUniqueArgs {\n  where: { id?: any; [key: string]: any };\n  [key: string]: any;\n}\n\ninterface StubDataArgs {\n  data: Record<string, any>;\n  [key: string]: any;\n}\n\ninterface StubWhereDataArgs {\n  where: { id?: any; [key: string]: any };\n  data: Record<string, any>;\n  [key: string]: any;\n}\n\ninterface StubPaginationArgs extends StubWhereArgs {\n  orderBy?: Record<string, any>;\n  select?: Record<string, any>;\n  include?: Record<string, any>;\n  skip?: number;\n  take?: number;\n  cursor?: Record<string, any>;\n}\n\ninterface StubCountArgs extends StubWhereArgs {\n  select?: Record<string, any>;\n  orderBy?: Record<string, any>;\n  skip?: number;\n  take?: number;\n  cursor?: Record<string, any>;\n}\n\n/**\n * Extracts the `where` filter type from a Prisma args type.\n * @example ExtractPrismaFilters<PrismaModels<any>['user']['FindManyArgs']>\n */\nexport type ExtractPrismaFilters<T> = T extends {\n  where?: infer W;\n  [key: string]: any;\n}\n  ? W\n  : any;\n\n/**\n * Extracts the `data` type from a Prisma args type.\n * @example ExtractPrismaData<PrismaModels<any>['user']['CreateArgs']>\n */\nexport type ExtractPrismaData<T> = T extends {\n  data: infer D;\n  [key: string]: any;\n}\n  ? D\n  : any;\n\n/**\n * Extracts query options from a Prisma args type by omitting the specified keys.\n * @example ExtractPrismaQueryOptions<PrismaModels<any>['user']['CreateArgs'], 'data'>\n */\nexport type ExtractPrismaQueryOptions<T, K extends keyof T = never> = Omit<\n  T,\n  K\n>;\n\n/**\n * A map of all Prisma models in the user's project.\n * Each key is a kebab-case model name, each value contains the full\n * Prisma delegate, payload, and args types for that model.\n *\n * Stub during Arkos development — replaced with real generated types\n * after `npx arkos prisma generate`.\n *\n * @example\n * ```ts\n * class ArkosPrismaService<TModelName extends keyof PrismaModels<any>> {}\n * ```\n */\nexport type PrismaModels<T extends Record<string, any>> = Record<\n  string,\n  {\n    Delegate: Record<string, (...args: any[]) => any>;\n    GetPayload: Record<string, any>;\n    FindManyArgs: StubPaginationArgs;\n    FindFirstArgs: StubPaginationArgs;\n    CreateArgs: StubDataArgs;\n    CreateManyArgs: StubDataArgs;\n    UpdateArgs: StubWhereDataArgs;\n    UpdateManyArgs: StubWhereDataArgs;\n    DeleteArgs: StubWhereUniqueArgs;\n    DeleteManyArgs: StubWhereArgs;\n    CountArgs: StubCountArgs;\n  }\n>;\n\n/**\n * Stub PrismaClient for Arkos development.\n * Replaced with the real `PrismaClient` from `@prisma/client` after\n * `npx arkos prisma generate`.\n */\nexport class PrismaClient {\n  [key: string]: any;\n}\n"]}