@venizia/ignis 0.4.3 → 0.4.5

package/dist/esm/components/socket-io/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/socket-io/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/esm/components/socket-io/common/index.js

@@ -0,0 +1,3 @@
+export * from './keys.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/socket-io/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/socket-io/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC","sourcesContent":["export * from './keys';\nexport * from './types';\n"]}

package/dist/esm/components/socket-io/common/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../../src/components/socket-io/common/keys.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,kBAAkB,6BAA6B;IAE/D,MAAM,CAAC,QAAQ,CAAC,cAAc,mCAAmC;IACjE,MAAM,CAAC,QAAQ,CAAC,gBAAgB,qCAAqC;IAErE,MAAM,CAAC,QAAQ,CAAC,oBAAoB,yCAAyC;IAC7E,MAAM,CAAC,QAAQ,CAAC,qBAAqB,0CAA0C;IAC/E,MAAM,CAAC,QAAQ,CAAC,wBAAwB,6CAA6C;CACtF"}

package/dist/esm/components/socket-io/common/keys.js

@@ -0,0 +1,9 @@
+export class SocketIOBindingKeys {
+    static { this.SOCKET_IO_INSTANCE = '@app/socket-io/instance'; }
+    static { this.SERVER_OPTIONS = '@app/socket-io/server-options'; }
+    static { this.REDIS_CONNECTION = '@app/socket-io/redis-connection'; }
+    static { this.AUTHENTICATE_HANDLER = '@app/socket-io/authenticate-handler'; }
+    static { this.VALIDATE_ROOM_HANDLER = '@app/socket-io/validate-room-handler'; }
+    static { this.CLIENT_CONNECTED_HANDLER = '@app/socket-io/client-connected-handler'; }
+}
+//# sourceMappingURL=keys.js.map

package/dist/esm/components/socket-io/common/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../../src/components/socket-io/common/keys.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAmB;aACd,uBAAkB,GAAG,yBAAyB,CAAC;aAE/C,mBAAc,GAAG,+BAA+B,CAAC;aACjD,qBAAgB,GAAG,iCAAiC,CAAC;aAErD,yBAAoB,GAAG,qCAAqC,CAAC;aAC7D,0BAAqB,GAAG,sCAAsC,CAAC;aAC/D,6BAAwB,GAAG,yCAAyC,CAAC","sourcesContent":["export class SocketIOBindingKeys {\n  static readonly SOCKET_IO_INSTANCE = '@app/socket-io/instance';\n\n  static readonly SERVER_OPTIONS = '@app/socket-io/server-options';\n  static readonly REDIS_CONNECTION = '@app/socket-io/redis-connection';\n\n  static readonly AUTHENTICATE_HANDLER = '@app/socket-io/authenticate-handler';\n  static readonly VALIDATE_ROOM_HANDLER = '@app/socket-io/validate-room-handler';\n  static readonly CLIENT_CONNECTED_HANDLER = '@app/socket-io/client-connected-handler';\n}\n"]}

package/dist/esm/components/socket-io/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/socket-io/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,cAAc,CAmB1D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,YAAY,CAAC;IAC9B,cAAc,EAAE,uBAAuB,CAAC;IACxC,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;CAChD"}

package/dist/esm/components/socket-io/common/types.js

@@ -0,0 +1,21 @@
+export const DEFAULT_SERVER_OPTIONS = {
+    identifier: 'SOCKET_IO_SERVER',
+    path: '/io',
+    cors: {
+        origin: '*',
+        methods: ['GET', 'POST'],
+        preflightContinue: false,
+        optionsSuccessStatus: 204,
+        credentials: true,
+    },
+    perMessageDeflate: {
+        threshold: 4096,
+        zlibDeflateOptions: { chunkSize: 10 * 1024 },
+        zlibInflateOptions: { windowBits: 12, memLevel: 8 },
+        clientNoContextTakeover: true,
+        serverNoContextTakeover: true,
+        serverMaxWindowBits: 10,
+        concurrencyLimit: 20,
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/components/socket-io/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/components/socket-io/common/types.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,sBAAsB,GAA4B;IAC7D,UAAU,EAAE,kBAAkB;IAC9B,IAAI,EAAE,KAAK;IACX,IAAI,EAAE;QACJ,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,KAAK;QACxB,oBAAoB,EAAE,GAAG;QACzB,WAAW,EAAE,IAAI;KAClB;IACD,iBAAiB,EAAE;QACjB,SAAS,EAAE,IAAI;QACf,kBAAkB,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,EAAE;QAC5C,kBAAkB,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;QACnD,uBAAuB,EAAE,IAAI;QAC7B,uBAAuB,EAAE,IAAI;QAC7B,mBAAmB,EAAE,EAAE;QACvB,gBAAgB,EAAE,EAAE;KACrB;CACF,CAAC","sourcesContent":["import type { IRedisHelper } from '@venizia/ignis-helpers';\nimport type {\n  TSocketIOAuthenticateFn,\n  TSocketIOClientConnectedFn,\n  TSocketIOValidateRoomFn,\n} from '@venizia/ignis-helpers/socket-io';\nimport type { ServerOptions } from 'socket.io';\n\nexport interface IServerOptions extends ServerOptions {\n  identifier: string;\n}\n\nexport const DEFAULT_SERVER_OPTIONS: Partial<IServerOptions> = {\n  identifier: 'SOCKET_IO_SERVER',\n  path: '/io',\n  cors: {\n    origin: '*',\n    methods: ['GET', 'POST'],\n    preflightContinue: false,\n    optionsSuccessStatus: 204,\n    credentials: true,\n  },\n  perMessageDeflate: {\n    threshold: 4096,\n    zlibDeflateOptions: { chunkSize: 10 * 1024 },\n    zlibInflateOptions: { windowBits: 12, memLevel: 8 },\n    clientNoContextTakeover: true,\n    serverNoContextTakeover: true,\n    serverMaxWindowBits: 10,\n    concurrencyLimit: 20,\n  },\n};\n\nexport interface IResolvedBindings {\n  redisConnection: IRedisHelper;\n  authenticateFn: TSocketIOAuthenticateFn;\n  validateRoomFn?: TSocketIOValidateRoomFn;\n  clientConnectedFn?: TSocketIOClientConnectedFn;\n}\n"]}

package/dist/esm/components/socket-io/component.d.ts

@@ -0,0 +1,13 @@
+import { type BaseApplication } from '../../base/applications/index.js';
+import { BaseComponent } from '@venizia/ignis-kernel';
+import { type ValueOrPromise } from '@venizia/ignis-helpers/common';
+import { type IServerOptions } from './common/index.js';
+export declare class SocketIOComponent extends BaseComponent {
+    private application;
+    protected serverOptions: Partial<IServerOptions>;
+    constructor(application: BaseApplication);
+    private resolveBindings;
+    private registerBunHook;
+    binding(): ValueOrPromise<void>;
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/esm/components/socket-io/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../../src/components/socket-io/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAKtD,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAS1F,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAGlB,qBAAa,iBAAkB,SAAQ,aAAa;IAII,OAAO,CAAC,WAAW;IAHzE,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;gBAGa,WAAW,EAAE,eAAe;IA8B1F,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,eAAe;IAwCd,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;CAiBzC"}

package/dist/esm/components/socket-io/component.js

@@ -0,0 +1,131 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var SocketIOComponent_1;
+import { BaseComponent } from '@venizia/ignis-kernel';
+import { inject } from '../../base/metadata/index.js';
+import { CoreBindings } from '@venizia/ignis-kernel';
+import { Binding } from '@venizia/ignis-kernel';
+import { getError } from '@venizia/ignis-helpers/core';
+import { HTTP, RuntimeModules } from '@venizia/ignis-helpers/common';
+import { isRedisHelper } from '@venizia/ignis-helpers';
+import { SocketIOServerHelper, } from '@venizia/ignis-helpers/socket-io';
+import { SocketIOBindingKeys, DEFAULT_SERVER_OPTIONS, } from './common/index.js';
+import { createBunEngine, createBunFetchHandler } from './handlers/index.js';
+let SocketIOComponent = SocketIOComponent_1 = class SocketIOComponent extends BaseComponent {
+    constructor(application) {
+        super({
+            scope: SocketIOComponent_1.name,
+            initDefault: { enable: true, container: application },
+            bindings: {
+                [SocketIOBindingKeys.SERVER_OPTIONS]: Binding.bind({
+                    key: SocketIOBindingKeys.SERVER_OPTIONS,
+                }).toValue(DEFAULT_SERVER_OPTIONS),
+                [SocketIOBindingKeys.REDIS_CONNECTION]: Binding.bind({
+                    key: SocketIOBindingKeys.REDIS_CONNECTION,
+                }).toValue(null),
+                [SocketIOBindingKeys.AUTHENTICATE_HANDLER]: Binding.bind({
+                    key: SocketIOBindingKeys.AUTHENTICATE_HANDLER,
+                }).toValue(null),
+                [SocketIOBindingKeys.VALIDATE_ROOM_HANDLER]: Binding.bind({
+                    key: SocketIOBindingKeys.VALIDATE_ROOM_HANDLER,
+                }).toValue(null),
+                [SocketIOBindingKeys.CLIENT_CONNECTED_HANDLER]: Binding.bind({
+                    key: SocketIOBindingKeys.CLIENT_CONNECTED_HANDLER,
+                }).toValue(null),
+            },
+        });
+        this.application = application;
+    }
+    resolveBindings() {
+        const extraServerOptions = this.application.get({
+            key: SocketIOBindingKeys.SERVER_OPTIONS,
+            isOptional: true,
+        }) ?? {};
+        this.serverOptions = Object.assign({}, DEFAULT_SERVER_OPTIONS, extraServerOptions);
+        const redisConnection = this.application.get({
+            key: SocketIOBindingKeys.REDIS_CONNECTION,
+        });
+        if (!isRedisHelper(redisConnection)) {
+            throw getError({
+                message: '[SocketIOComponent][resolveBindings] Invalid instance of redisConnection | Please init connection with RedisSingleHelper (single), RedisClusterHelper (cluster), or RedisSentinelHelper (sentinel)!',
+            });
+        }
+        const authenticateFn = this.application.get({
+            key: SocketIOBindingKeys.AUTHENTICATE_HANDLER,
+        });
+        if (!authenticateFn) {
+            throw getError({
+                message: '[DANGER][SocketIOComponent] Invalid authenticateFn to setup io socket server!',
+            });
+        }
+        const validateRoomFn = this.application.get({
+            key: SocketIOBindingKeys.VALIDATE_ROOM_HANDLER,
+        }) ?? undefined;
+        const clientConnectedFn = this.application.get({
+            key: SocketIOBindingKeys.CLIENT_CONNECTED_HANDLER,
+        }) ?? undefined;
+        return { redisConnection, authenticateFn, validateRoomFn, clientConnectedFn };
+    }
+    registerBunHook(opts) {
+        const { redisConnection, authenticateFn, validateRoomFn, clientConnectedFn } = opts;
+        const serverOptions = this.serverOptions;
+        const logger = this.logger.for(this.registerBunHook.name);
+        this.application.registerPostStartHook({
+            identifier: 'socket-io-initialize',
+            hook: async () => {
+                const { engine, engineHandler } = await createBunEngine({ serverOptions });
+                const socketIOHelper = new SocketIOServerHelper({
+                    runtime: RuntimeModules.BUN,
+                    identifier: serverOptions.identifier,
+                    engine,
+                    serverOptions,
+                    redisConnection,
+                    authenticateFn,
+                    validateRoomFn,
+                    clientConnectedFn,
+                });
+                await socketIOHelper.configure();
+                this.application
+                    .bind({ key: SocketIOBindingKeys.SOCKET_IO_INSTANCE })
+                    .toValue(socketIOHelper);
+                const serverInstance = this.application.getServerInstance();
+                const honoServer = this.application.getServer();
+                const enginePath = serverOptions.path ?? '/socket.io/';
+                serverInstance.reload({
+                    fetch: createBunFetchHandler({ engine, enginePath, honoServer }),
+                    websocket: engineHandler.websocket,
+                });
+                logger.info('SocketIO initialized for Bun runtime');
+            },
+        });
+    }
+    binding() {
+        const logger = this.logger.for(this.binding.name);
+        if (!this.application) {
+            throw getError({
+                statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
+                message: '[binding] Invalid application to bind SocketIOComponent',
+            });
+        }
+        logger.info('Binding SocketIO for application...');
+        const resolved = this.resolveBindings();
+        logger.debug('Socket.IO Server Options: %j', this.serverOptions);
+        this.registerBunHook(resolved);
+    }
+};
+SocketIOComponent = SocketIOComponent_1 = __decorate([
+    __param(0, inject({ key: CoreBindings.APPLICATION_INSTANCE })),
+    __metadata("design:paramtypes", [Function])
+], SocketIOComponent);
+export { SocketIOComponent };
+//# sourceMappingURL=component.js.map

package/dist/esm/components/socket-io/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../../src/components/socket-io/component.ts"],"names":[],"mappings":"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","sourcesContent":["import { type BaseApplication, type TBunServerInstance } from '@/base/applications';\nimport { BaseComponent } from '@venizia/ignis-kernel';\nimport { inject } from '@/base/metadata';\nimport { CoreBindings } from '@venizia/ignis-kernel';\nimport { Binding } from '@venizia/ignis-kernel';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HTTP, RuntimeModules, type ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { type AbstractRedisHelper, isRedisHelper } from '@venizia/ignis-helpers';\nimport {\n  SocketIOServerHelper,\n  type TSocketIOAuthenticateFn,\n  type TSocketIOClientConnectedFn,\n  type TSocketIOValidateRoomFn,\n} from '@venizia/ignis-helpers/socket-io';\nimport type { ServerOptions } from 'socket.io';\nimport {\n  SocketIOBindingKeys,\n  DEFAULT_SERVER_OPTIONS,\n  type IResolvedBindings,\n  type IServerOptions,\n} from './common';\nimport { createBunEngine, createBunFetchHandler } from './handlers';\n\nexport class SocketIOComponent extends BaseComponent {\n  protected serverOptions: Partial<IServerOptions>;\n\n  constructor(\n    @inject({ key: CoreBindings.APPLICATION_INSTANCE }) private application: BaseApplication,\n  ) {\n    super({\n      scope: SocketIOComponent.name,\n      initDefault: { enable: true, container: application },\n      bindings: {\n        [SocketIOBindingKeys.SERVER_OPTIONS]: Binding.bind<Partial<ServerOptions>>({\n          key: SocketIOBindingKeys.SERVER_OPTIONS,\n        }).toValue(DEFAULT_SERVER_OPTIONS),\n\n        [SocketIOBindingKeys.REDIS_CONNECTION]: Binding.bind<AbstractRedisHelper | null>({\n          key: SocketIOBindingKeys.REDIS_CONNECTION,\n        }).toValue(null),\n\n        [SocketIOBindingKeys.AUTHENTICATE_HANDLER]: Binding.bind<TSocketIOAuthenticateFn | null>({\n          key: SocketIOBindingKeys.AUTHENTICATE_HANDLER,\n        }).toValue(null),\n\n        [SocketIOBindingKeys.VALIDATE_ROOM_HANDLER]: Binding.bind<TSocketIOValidateRoomFn | null>({\n          key: SocketIOBindingKeys.VALIDATE_ROOM_HANDLER,\n        }).toValue(null),\n\n        [SocketIOBindingKeys.CLIENT_CONNECTED_HANDLER]:\n          Binding.bind<TSocketIOClientConnectedFn | null>({\n            key: SocketIOBindingKeys.CLIENT_CONNECTED_HANDLER,\n          }).toValue(null),\n      },\n    });\n  }\n\n  private resolveBindings(): IResolvedBindings {\n    const extraServerOptions =\n      this.application.get<Partial<ServerOptions>>({\n        key: SocketIOBindingKeys.SERVER_OPTIONS,\n        isOptional: true,\n      }) ?? {};\n    this.serverOptions = Object.assign({}, DEFAULT_SERVER_OPTIONS, extraServerOptions);\n\n    const redisConnection = this.application.get<AbstractRedisHelper>({\n      key: SocketIOBindingKeys.REDIS_CONNECTION,\n    });\n    if (!isRedisHelper(redisConnection)) {\n      throw getError({\n        message:\n          '[SocketIOComponent][resolveBindings] Invalid instance of redisConnection | Please init connection with RedisSingleHelper (single), RedisClusterHelper (cluster), or RedisSentinelHelper (sentinel)!',\n      });\n    }\n\n    const authenticateFn = this.application.get<TSocketIOAuthenticateFn>({\n      key: SocketIOBindingKeys.AUTHENTICATE_HANDLER,\n    });\n    if (!authenticateFn) {\n      throw getError({\n        message: '[DANGER][SocketIOComponent] Invalid authenticateFn to setup io socket server!',\n      });\n    }\n\n    const validateRoomFn =\n      this.application.get<TSocketIOValidateRoomFn | null>({\n        key: SocketIOBindingKeys.VALIDATE_ROOM_HANDLER,\n      }) ?? undefined;\n\n    const clientConnectedFn =\n      this.application.get<TSocketIOClientConnectedFn | null>({\n        key: SocketIOBindingKeys.CLIENT_CONNECTED_HANDLER,\n      }) ?? undefined;\n\n    return { redisConnection, authenticateFn, validateRoomFn, clientConnectedFn };\n  }\n\n  private registerBunHook(opts: IResolvedBindings) {\n    const { redisConnection, authenticateFn, validateRoomFn, clientConnectedFn } = opts;\n    const serverOptions = this.serverOptions;\n    const logger = this.logger.for(this.registerBunHook.name);\n\n    this.application.registerPostStartHook({\n      identifier: 'socket-io-initialize',\n      hook: async () => {\n        const { engine, engineHandler } = await createBunEngine({ serverOptions });\n\n        const socketIOHelper = new SocketIOServerHelper({\n          runtime: RuntimeModules.BUN,\n          identifier: serverOptions.identifier!,\n          engine,\n          serverOptions,\n          redisConnection,\n          authenticateFn,\n          validateRoomFn,\n          clientConnectedFn,\n        });\n        await socketIOHelper.configure();\n\n        this.application\n          .bind({ key: SocketIOBindingKeys.SOCKET_IO_INSTANCE })\n          .toValue(socketIOHelper);\n\n        const serverInstance = this.application.getServerInstance<TBunServerInstance>();\n        const honoServer = this.application.getServer();\n        const enginePath = serverOptions.path ?? '/socket.io/';\n\n        serverInstance!.reload({\n          fetch: createBunFetchHandler({ engine, enginePath, honoServer }),\n          websocket: engineHandler.websocket,\n        });\n\n        logger.info('SocketIO initialized for Bun runtime');\n      },\n    });\n  }\n\n  override binding(): ValueOrPromise<void> {\n    const logger = this.logger.for(this.binding.name);\n\n    if (!this.application) {\n      throw getError({\n        statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n        message: '[binding] Invalid application to bind SocketIOComponent',\n      });\n    }\n\n    logger.info('Binding SocketIO for application...');\n\n    const resolved = this.resolveBindings();\n    logger.debug('Socket.IO Server Options: %j', this.serverOptions);\n\n    this.registerBunHook(resolved);\n  }\n}\n"]}

package/dist/esm/components/socket-io/handlers/bun.handler.d.ts

@@ -0,0 +1,15 @@
+import type { OpenAPIHono } from '@hono/zod-openapi';
+import type { TBunServerInstance } from '../../../base/applications/index.js';
+import type { ServerOptions } from 'socket.io';
+export declare function createBunEngine(opts: {
+    serverOptions: Partial<ServerOptions>;
+}): Promise<{
+    engine: any;
+    engineHandler: any;
+}>;
+export declare function createBunFetchHandler(opts: {
+    engine: any;
+    enginePath: string;
+    honoServer: OpenAPIHono;
+}): (req: Request, server: TBunServerInstance) => Response | Promise<Response>;
+//# sourceMappingURL=bun.handler.d.ts.map

package/dist/esm/components/socket-io/handlers/bun.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.handler.d.ts","sourceRoot":"","sources":["../../../../../src/components/socket-io/handlers/bun.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACvC,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,aAAa,EAAE,GAAG,CAAA;CAAE,CAAC,CAuB/C;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC;CACzB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAY7E"}

package/dist/esm/components/socket-io/handlers/bun.handler.js

@@ -0,0 +1,32 @@
+export async function createBunEngine(opts) {
+    const { serverOptions } = opts;
+    const { Server: BunEngine } = await import('@socket.io/bun-engine');
+    // Extract cors fields explicitly to bridge socket.io/bun-engine type differences
+    const corsConfig = typeof serverOptions.cors === 'object' ? serverOptions.cors : undefined;
+    const engine = new BunEngine({
+        path: serverOptions.path ?? '/socket.io/',
+        ...(corsConfig && {
+            cors: {
+                origin: corsConfig.origin,
+                methods: corsConfig.methods,
+                credentials: corsConfig.credentials,
+                allowedHeaders: corsConfig.allowedHeaders,
+                exposedHeaders: corsConfig.exposedHeaders,
+                maxAge: corsConfig.maxAge,
+            },
+        }),
+    });
+    const engineHandler = engine.handler();
+    return { engine, engineHandler };
+}
+export function createBunFetchHandler(opts) {
+    const { engine, enginePath, honoServer } = opts;
+    return (req, server) => {
+        const url = new URL(req.url);
+        if (!url.pathname.startsWith(enginePath)) {
+            return honoServer.fetch(req, server);
+        }
+        return engine.handleRequest(req, server) ?? new Response(null, { status: 404 });
+    };
+}
+//# sourceMappingURL=bun.handler.js.map

package/dist/esm/components/socket-io/handlers/bun.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.handler.js","sourceRoot":"","sources":["../../../../../src/components/socket-io/handlers/bun.handler.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAErC;IACC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAEpE,iFAAiF;IACjF,MAAM,UAAU,GAAG,OAAO,aAAa,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,aAAa,CAAC,IAAI,IAAI,aAAa;QACzC,GAAG,CAAC,UAAU,IAAI;YAChB,IAAI,EAAE;gBACJ,MAAM,EAAE,UAAU,CAAC,MAA2D;gBAC9E,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,cAAc,EAAE,UAAU,CAAC,cAAc;gBACzC,cAAc,EAAE,UAAU,CAAC,cAAc;gBACzC,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B;SACF,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAEvC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAIrC;IACC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEhD,OAAO,CAAC,GAAY,EAAE,MAA0B,EAAgC,EAAE;QAChF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACzC,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { OpenAPIHono } from '@hono/zod-openapi';\nimport type { TBunServerInstance } from '@/base/applications';\nimport type { ServerOptions } from 'socket.io';\n\nexport async function createBunEngine(opts: {\n  serverOptions: Partial<ServerOptions>;\n}): Promise<{ engine: any; engineHandler: any }> {\n  const { serverOptions } = opts;\n  const { Server: BunEngine } = await import('@socket.io/bun-engine');\n\n  // Extract cors fields explicitly to bridge socket.io/bun-engine type differences\n  const corsConfig = typeof serverOptions.cors === 'object' ? serverOptions.cors : undefined;\n  const engine = new BunEngine({\n    path: serverOptions.path ?? '/socket.io/',\n    ...(corsConfig && {\n      cors: {\n        origin: corsConfig.origin as string | RegExp | (string | RegExp)[] | undefined,\n        methods: corsConfig.methods,\n        credentials: corsConfig.credentials,\n        allowedHeaders: corsConfig.allowedHeaders,\n        exposedHeaders: corsConfig.exposedHeaders,\n        maxAge: corsConfig.maxAge,\n      },\n    }),\n  });\n\n  const engineHandler = engine.handler();\n\n  return { engine, engineHandler };\n}\n\nexport function createBunFetchHandler(opts: {\n  engine: any;\n  enginePath: string;\n  honoServer: OpenAPIHono;\n}): (req: Request, server: TBunServerInstance) => Response | Promise<Response> {\n  const { engine, enginePath, honoServer } = opts;\n\n  return (req: Request, server: TBunServerInstance): Response | Promise<Response> => {\n    const url = new URL(req.url);\n\n    if (!url.pathname.startsWith(enginePath)) {\n      return honoServer.fetch(req, server);\n    }\n\n    return engine.handleRequest(req, server) ?? new Response(null, { status: 404 });\n  };\n}\n"]}

package/dist/esm/components/socket-io/handlers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './bun.handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/socket-io/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/socket-io/handlers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/esm/components/socket-io/handlers/index.js

@@ -0,0 +1,2 @@
+export * from './bun.handler.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/socket-io/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/socket-io/handlers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC","sourcesContent":["export * from './bun.handler';\n"]}

package/dist/esm/components/socket-io/index.d.ts

@@ -0,0 +1,3 @@
+export * from './common/keys.js';
+export * from './component.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/socket-io/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/socket-io/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/esm/components/socket-io/index.js

@@ -0,0 +1,3 @@
+export * from './common/keys.js';
+export * from './component.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/socket-io/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/socket-io/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC","sourcesContent":["export * from './common/keys';\nexport * from './component';\n"]}

package/dist/esm/components/static-asset/common/commit-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-token.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/common/commit-token.ts"],"names":[],"mappings":"AAIA,yNAAyN;AACzN,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB,KAAG,MAGH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,mBAsBH,CAAC"}

package/dist/esm/components/static-asset/common/commit-token.js

@@ -0,0 +1,35 @@
+import { getError } from '@venizia/ignis-helpers/core';
+import { createHmac, timingSafeEqual } from 'node:crypto';
+import { StaticAssetErrors } from './errors.js';
+const encode = (payload) => Buffer.from(JSON.stringify(payload)).toString('base64url');
+const sign = (opts) => createHmac('sha256', opts.secretKey).update(opts.body).digest('base64url');
+/** Signs `{ bucket, key, expiresAt }` so the commit route can trust the key it is handed. */
+export const buildCommitToken = (opts) => {
+    const body = encode(opts.payload);
+    return `${body}.${sign({ body, secretKey: opts.secretKey })}`;
+};
+/**
+ * Reads a commit token back, or throws.
+ *
+ * Verification happens BEFORE any storage call, which is what makes the commit route refuse to be a
+ * name prober: a forged token fails without a round trip, so timing says nothing about what exists.
+ */
+export const readCommitToken = (opts) => {
+    const { token, secretKey, now = Date.now() } = opts;
+    const [body, signature] = token.split('.');
+    if (!body || !signature) {
+        throw getError(StaticAssetErrors.INVALID_COMMIT_TOKEN);
+    }
+    const expected = Buffer.from(sign({ body, secretKey }));
+    const given = Buffer.from(signature);
+    // Length-checked first: `timingSafeEqual` throws on a length mismatch instead of answering false.
+    if (expected.length !== given.length || !timingSafeEqual(expected, given)) {
+        throw getError(StaticAssetErrors.INVALID_COMMIT_TOKEN);
+    }
+    const payload = JSON.parse(Buffer.from(body, 'base64url').toString('utf8'));
+    if (payload.expiresAt <= now) {
+        throw getError(StaticAssetErrors.EXPIRED_COMMIT_TOKEN);
+    }
+    return payload;
+};
+//# sourceMappingURL=commit-token.js.map

package/dist/esm/components/static-asset/common/commit-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-token.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/common/commit-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAS7C,MAAM,MAAM,GAAG,CAAC,OAA4B,EAAU,EAAE,CACtD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAE7D,MAAM,IAAI,GAAG,CAAC,IAAyC,EAAU,EAAE,CACjE,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAE7E,6FAA6F;AAC7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAGhC,EAAU,EAAE;IACX,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAI/B,EAAuB,EAAE;IACxB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IACpD,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE3C,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACxB,MAAM,QAAQ,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAErC,kGAAkG;IAClG,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,QAAQ,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,OAAO,GAAwB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACjG,IAAI,OAAO,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;QAC7B,MAAM,QAAQ,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["import { getError } from '@venizia/ignis-helpers/core';\nimport { createHmac, timingSafeEqual } from 'node:crypto';\nimport { StaticAssetErrors } from './errors';\n\n/** What a commit token binds. Business fields are deliberately absent - which order or tenant an upload belongs to is the application's, and a token the framework signs is the wrong place to put its authorization. */\nexport interface ICommitTokenPayload {\n  bucket: string;\n  key: string;\n  expiresAt: number;\n}\n\nconst encode = (payload: ICommitTokenPayload): string =>\n  Buffer.from(JSON.stringify(payload)).toString('base64url');\n\nconst sign = (opts: { body: string; secretKey: string }): string =>\n  createHmac('sha256', opts.secretKey).update(opts.body).digest('base64url');\n\n/** Signs `{ bucket, key, expiresAt }` so the commit route can trust the key it is handed. */\nexport const buildCommitToken = (opts: {\n  payload: ICommitTokenPayload;\n  secretKey: string;\n}): string => {\n  const body = encode(opts.payload);\n  return `${body}.${sign({ body, secretKey: opts.secretKey })}`;\n};\n\n/**\n * Reads a commit token back, or throws.\n *\n * Verification happens BEFORE any storage call, which is what makes the commit route refuse to be a\n * name prober: a forged token fails without a round trip, so timing says nothing about what exists.\n */\nexport const readCommitToken = (opts: {\n  token: string;\n  secretKey: string;\n  now?: number;\n}): ICommitTokenPayload => {\n  const { token, secretKey, now = Date.now() } = opts;\n  const [body, signature] = token.split('.');\n\n  if (!body || !signature) {\n    throw getError(StaticAssetErrors.INVALID_COMMIT_TOKEN);\n  }\n\n  const expected = Buffer.from(sign({ body, secretKey }));\n  const given = Buffer.from(signature);\n\n  // Length-checked first: `timingSafeEqual` throws on a length mismatch instead of answering false.\n  if (expected.length !== given.length || !timingSafeEqual(expected, given)) {\n    throw getError(StaticAssetErrors.INVALID_COMMIT_TOKEN);\n  }\n\n  const payload: ICommitTokenPayload = JSON.parse(Buffer.from(body, 'base64url').toString('utf8'));\n  if (payload.expiresAt <= now) {\n    throw getError(StaticAssetErrors.EXPIRED_COMMIT_TOKEN);\n  }\n\n  return payload;\n};\n"]}

package/dist/esm/components/static-asset/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGjE,uGAAuG;AACvG,eAAO,MAAM,iBAAiB,yEAKpB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,aAgBnC,CAAC;AAEH,qBAAa,uBAAuB;IAClC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,wGAAwG;IACxG,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAElC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAiD;IAE3E,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAElF,+FAA+F;AAC/F,qBAAa,uBAAuB;IAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IAExC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA2C;IAErE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAElF,yHAAyH;AACzH,eAAO,MAAM,sBAAsB,aAAa,CAAC;AAEjD,2LAA2L;AAC3L,eAAO,MAAM,uBAAuB,4BAA4B,CAAC"}

package/dist/esm/components/static-asset/common/constants.js

@@ -0,0 +1,54 @@
+import { HTTP } from '@venizia/ignis-helpers/common';
+/** `content-type` is absent on purpose: it is decided from the object name, never from the backend. */
+export const WHITELIST_HEADERS = [
+    HTTP.Headers.CONTENT_ENCODING,
+    HTTP.Headers.CACHE_CONTROL,
+    HTTP.Headers.ETAG,
+    HTTP.Headers.LAST_MODIFIED,
+];
+/**
+ * Types the controller will let a browser render, keyed off the object name. Anything absent here is
+ * served as an attachment, because a renderable upload on the API origin is stored XSS - and `nosniff`
+ * cannot stop a type we declared ourselves. `image/svg+xml` is deliberately excluded: SVG carries script.
+ */
+export const RENDERABLE_CONTENT_TYPES = new Set([
+    'image/png',
+    'image/jpeg',
+    'image/gif',
+    'image/webp',
+    'image/avif',
+    'image/bmp',
+    'image/x-icon',
+    'video/mp4',
+    'video/webm',
+    'audio/mpeg',
+    'audio/wav',
+    'audio/ogg',
+    'application/pdf',
+    'text/plain',
+    'text/csv',
+]);
+export class StaticAssetStorageTypes {
+    static { this.DISK = 'disk'; }
+    /** @deprecated Use {@link StaticAssetStorageTypes.BUN_S3}, which reaches MinIO over the same S3 API. */
+    static { this.MINIO = 'minio'; }
+    static { this.BUN_S3 = 'bun-s3'; }
+    static { this.SCHEME_SET = new Set([this.DISK, this.MINIO, this.BUN_S3]); }
+    static isValid(orgType) {
+        return this.SCHEME_SET.has(orgType);
+    }
+}
+/** What `recreate-metalink` did: refreshed the rows of an object, or created its first one. */
+export class MetaLinkRecreateActions {
+    static { this.CREATED = 'created'; }
+    static { this.REFRESHED = 'refreshed'; }
+    static { this.SCHEME_SET = new Set([this.CREATED, this.REFRESHED]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+/** Where a signed policy may write. The final key is never inside it, so content cannot be replaced after the commit. */
+export const DEFAULT_PENDING_PREFIX = 'pending/';
+/** Reported in the body, never thrown: the bytes are stored, only the row is not. A CODE, because a 200 bypasses the middleware that strips the driver's `detail`/`table`/`constraint`. */
+export const META_LINK_CREATE_FAILED = 'META_LINK_CREATE_FAILED';
+//# sourceMappingURL=constants.js.map

package/dist/esm/components/static-asset/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAErD,uGAAuG;AACvG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,CAAC,OAAO,CAAC,gBAAgB;IAC7B,IAAI,CAAC,OAAO,CAAC,aAAa;IAC1B,IAAI,CAAC,OAAO,CAAC,IAAI;IACjB,IAAI,CAAC,OAAO,CAAC,aAAa;CAClB,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAS;IACtD,WAAW;IACX,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,cAAc;IACd,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,WAAW;IACX,iBAAiB;IACjB,YAAY;IACZ,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,OAAO,uBAAuB;aAClB,SAAI,GAAG,MAAM,CAAC;IAC9B,wGAAwG;aACxF,UAAK,GAAG,OAAO,CAAC;aAChB,WAAM,GAAG,QAAQ,CAAC;aAElB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAE3E,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;;AAKH,+FAA+F;AAC/F,MAAM,OAAO,uBAAuB;aAClB,YAAO,GAAG,SAAS,CAAC;aACpB,cAAS,GAAG,WAAW,CAAC;aAExB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAErE,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAKH,yHAAyH;AACzH,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEjD,2LAA2L;AAC3L,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers/common';\nimport { HTTP } from '@venizia/ignis-helpers/common';\n\n/** `content-type` is absent on purpose: it is decided from the object name, never from the backend. */\nexport const WHITELIST_HEADERS = [\n  HTTP.Headers.CONTENT_ENCODING,\n  HTTP.Headers.CACHE_CONTROL,\n  HTTP.Headers.ETAG,\n  HTTP.Headers.LAST_MODIFIED,\n] as const;\n\n/**\n * Types the controller will let a browser render, keyed off the object name. Anything absent here is\n * served as an attachment, because a renderable upload on the API origin is stored XSS - and `nosniff`\n * cannot stop a type we declared ourselves. `image/svg+xml` is deliberately excluded: SVG carries script.\n */\nexport const RENDERABLE_CONTENT_TYPES = new Set<string>([\n  'image/png',\n  'image/jpeg',\n  'image/gif',\n  'image/webp',\n  'image/avif',\n  'image/bmp',\n  'image/x-icon',\n  'video/mp4',\n  'video/webm',\n  'audio/mpeg',\n  'audio/wav',\n  'audio/ogg',\n  'application/pdf',\n  'text/plain',\n  'text/csv',\n]);\n\nexport class StaticAssetStorageTypes {\n  static readonly DISK = 'disk';\n  /** @deprecated Use {@link StaticAssetStorageTypes.BUN_S3}, which reaches MinIO over the same S3 API. */\n  static readonly MINIO = 'minio';\n  static readonly BUN_S3 = 'bun-s3';\n\n  static readonly SCHEME_SET = new Set([this.DISK, this.MINIO, this.BUN_S3]);\n\n  static isValid(orgType: string): boolean {\n    return this.SCHEME_SET.has(orgType);\n  }\n}\n\nexport type TStaticAssetStorageType = TConstValue<typeof StaticAssetStorageTypes>;\n\n/** What `recreate-metalink` did: refreshed the rows of an object, or created its first one. */\nexport class MetaLinkRecreateActions {\n  static readonly CREATED = 'created';\n  static readonly REFRESHED = 'refreshed';\n\n  static readonly SCHEME_SET = new Set([this.CREATED, this.REFRESHED]);\n\n  static isValid(value: string): boolean {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\nexport type TMetaLinkRecreateAction = TConstValue<typeof MetaLinkRecreateActions>;\n\n/** Where a signed policy may write. The final key is never inside it, so content cannot be replaced after the commit. */\nexport const DEFAULT_PENDING_PREFIX = 'pending/';\n\n/** Reported in the body, never thrown: the bytes are stored, only the row is not. A CODE, because a 200 bypasses the middleware that strips the driver's `detail`/`table`/`constraint`. */\nexport const META_LINK_CREATE_FAILED = 'META_LINK_CREATE_FAILED';\n"]}

package/dist/esm/components/static-asset/common/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/common/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAIrF,uIAAuI;AACvI,eAAO,MAAM,iBAAiB;;;;;;;;;IAS5B,gEAAgE;;;;;;;;;IAShE,kJAAkJ;;;;;;;;;;;;;;;;;IAWlJ,oGAAoG;;;;;;;;;;;;;;;;;;;;;;;;;IAsBpG,uGAAuG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CpD,CAAC;AAEtD,2GAA2G;AAC3G,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,iBAAkB,SAAQ,eAAe,CAAC,OAAO,iBAAiB,CAAC;KAAG;CACjF"}

package/dist/esm/components/static-asset/common/errors.js

@@ -0,0 +1,99 @@
+import { ErrorScopes } from '@venizia/ignis-helpers/core';
+import { HTTP } from '@venizia/ignis-helpers/common';
+/** Codes a client branches on for a rejected static-asset request. A throw site may override `message` to name the offending value. */
+export const StaticAssetErrors = {
+    UPLOAD_NOT_AUTHORIZED: {
+        message: {
+            text: 'Not allowed to request an upload policy',
+            code: 'core.static_asset.upload_not_authorized',
+        },
+        statusCode: HTTP.ResultCodes.RS_4.Forbidden,
+        category: ErrorScopes.VALIDATION,
+    },
+    /** Both upload paths - one condition, one code to branch on. */
+    UPLOAD_TOO_LARGE: {
+        message: {
+            text: 'File is larger than the maximum allowed',
+            code: 'core.static_asset.upload_too_large',
+        },
+        statusCode: HTTP.ResultCodes.RS_4.ContentTooLarge,
+        category: ErrorScopes.VALIDATION,
+    },
+    /** Deliberately not 404 and deliberately not "expired": a caller learns only that the token is no good, never whether the key it names exists. */
+    INVALID_COMMIT_TOKEN: {
+        message: { text: 'Invalid commit token', code: 'core.static_asset.invalid_commit_token' },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    EXPIRED_COMMIT_TOKEN: {
+        message: { text: 'Commit token has expired', code: 'core.static_asset.expired_commit_token' },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    /** Labels ride the body; one in the URL would otherwise leave the row unlabelled without a word. */
+    LABELS_IN_QUERY: {
+        message: {
+            text: 'Upload labels belong in the request body, not the query',
+            code: 'core.static_asset.labels_in_query',
+        },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    BUCKET_NAME_INVALID: {
+        message: { text: 'Invalid bucket name', code: 'core.static_asset.bucket_name_invalid' },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    OBJECT_NAME_INVALID: {
+        message: {
+            text: 'Invalid object name or path',
+            code: 'core.static_asset.object_name_invalid',
+        },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    /** The application's naming hook produced a key outside `controller.keyPrefix`; nothing is written. */
+    OBJECT_KEY_OUT_OF_SCOPE: {
+        message: {
+            text: 'Object key is outside the key prefix of this controller',
+            code: 'core.static_asset.object_key_out_of_scope',
+        },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    FOLDER_PATH_INVALID: {
+        message: { text: 'Invalid folder path', code: 'core.static_asset.folder_path_invalid' },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    FOLDER_SEGMENT_INVALID: {
+        message: {
+            text: 'Invalid folder path segment',
+            code: 'core.static_asset.folder_segment_invalid',
+        },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    FOLDER_DEPTH_EXCEEDED: {
+        message: {
+            text: 'Folder path exceeds the maximum depth',
+            code: 'core.static_asset.folder_depth_exceeded',
+        },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    FILE_EMPTY: {
+        message: { text: 'Empty file content', code: 'core.static_asset.file_empty' },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+    MAX_KEYS_INVALID: {
+        message: {
+            text: 'Invalid maxKeys - expected a positive integer',
+            code: 'core.static_asset.max_keys_invalid',
+        },
+        statusCode: HTTP.ResultCodes.RS_4.BadRequest,
+        category: ErrorScopes.VALIDATION,
+    },
+};
+//# sourceMappingURL=errors.js.map

package/dist/esm/components/static-asset/common/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/common/errors.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TErrorDefinition, TRegisterErrors } from '@venizia/ignis-helpers/core';\nimport { ErrorScopes } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\n\n/** Codes a client branches on for a rejected static-asset request. A throw site may override `message` to name the offending value. */\nexport const StaticAssetErrors = {\n  UPLOAD_NOT_AUTHORIZED: {\n    message: {\n      text: 'Not allowed to request an upload policy',\n      code: 'core.static_asset.upload_not_authorized',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.Forbidden,\n    category: ErrorScopes.VALIDATION,\n  },\n  /** Both upload paths - one condition, one code to branch on. */\n  UPLOAD_TOO_LARGE: {\n    message: {\n      text: 'File is larger than the maximum allowed',\n      code: 'core.static_asset.upload_too_large',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.ContentTooLarge,\n    category: ErrorScopes.VALIDATION,\n  },\n  /** Deliberately not 404 and deliberately not \"expired\": a caller learns only that the token is no good, never whether the key it names exists. */\n  INVALID_COMMIT_TOKEN: {\n    message: { text: 'Invalid commit token', code: 'core.static_asset.invalid_commit_token' },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  EXPIRED_COMMIT_TOKEN: {\n    message: { text: 'Commit token has expired', code: 'core.static_asset.expired_commit_token' },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  /** Labels ride the body; one in the URL would otherwise leave the row unlabelled without a word. */\n  LABELS_IN_QUERY: {\n    message: {\n      text: 'Upload labels belong in the request body, not the query',\n      code: 'core.static_asset.labels_in_query',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  BUCKET_NAME_INVALID: {\n    message: { text: 'Invalid bucket name', code: 'core.static_asset.bucket_name_invalid' },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  OBJECT_NAME_INVALID: {\n    message: {\n      text: 'Invalid object name or path',\n      code: 'core.static_asset.object_name_invalid',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  /** The application's naming hook produced a key outside `controller.keyPrefix`; nothing is written. */\n  OBJECT_KEY_OUT_OF_SCOPE: {\n    message: {\n      text: 'Object key is outside the key prefix of this controller',\n      code: 'core.static_asset.object_key_out_of_scope',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  FOLDER_PATH_INVALID: {\n    message: { text: 'Invalid folder path', code: 'core.static_asset.folder_path_invalid' },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  FOLDER_SEGMENT_INVALID: {\n    message: {\n      text: 'Invalid folder path segment',\n      code: 'core.static_asset.folder_segment_invalid',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  FOLDER_DEPTH_EXCEEDED: {\n    message: {\n      text: 'Folder path exceeds the maximum depth',\n      code: 'core.static_asset.folder_depth_exceeded',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  FILE_EMPTY: {\n    message: { text: 'Empty file content', code: 'core.static_asset.file_empty' },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  MAX_KEYS_INVALID: {\n    message: {\n      text: 'Invalid maxKeys - expected a positive integer',\n      code: 'core.static_asset.max_keys_invalid',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n} as const satisfies Record<string, TErrorDefinition>;\n\n/** Registers these codes with the shared key registry so a consumer gets autocomplete on `messageCode`. */\ndeclare module '@venizia/ignis-helpers' {\n  interface IErrorKeyRegistry extends TRegisterErrors<typeof StaticAssetErrors> {}\n}\n"]}

package/dist/esm/components/static-asset/common/index.d.ts

@@ -0,0 +1,6 @@
+export * from './errors.js';
+export * from './constants.js';
+export * from './keys.js';
+export * from './types.js';
+export * from './commit-token.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/static-asset/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}

package/dist/esm/components/static-asset/common/index.js

@@ -0,0 +1,6 @@
+export * from './errors.js';
+export * from './constants.js';
+export * from './keys.js';
+export * from './types.js';
+export * from './commit-token.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/static-asset/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC","sourcesContent":["export * from './errors';\nexport * from './constants';\nexport * from './keys';\nexport * from './types';\nexport * from './commit-token';\n"]}

package/dist/esm/components/static-asset/common/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/common/keys.ts"],"names":[],"mappings":"AAAA,qBAAa,+BAA+B;IAC1C,oPAAoP;IACpP,MAAM,CAAC,QAAQ,CAAC,8BAA8B,yCAAyC;CACxF"}

package/dist/esm/components/static-asset/common/keys.js

@@ -0,0 +1,5 @@
+export class StaticAssetComponentBindingKeys {
+    /** The options an application registers through `configs.artifacts` land here, because an artifact index carries classes and no options. `application.component(StaticAssetComponent, { options })` passes them directly and wins over this key. */
+    static { this.STATIC_ASSET_COMPONENT_OPTIONS = '@app/static-asset-component/options'; }
+}
+//# sourceMappingURL=keys.js.map