@venizia/ignis 0.4.7-0 → 0.4.7-2

package/dist/esm/components/static-asset/controller/meta-link.d.ts

@@ -1,37 +1,41 @@
 import type { IBucketRef, IFileStat, IObjectRef, IStorageHelper, IUploadResult } from '@venizia/ignis-helpers';
 import type { AnyType } from '@venizia/ignis-helpers/common';
 import type { TMetaLinkConfig, TStaticAssetStorageType, TUploadQuery } from '../common/index.js';
-/** The upload result of an object already in storage, so a commit or a recreate writes its row the way an upload does. */
-export declare const buildStoredUploadResult: (opts: {
-    helper: IStorageHelper;
-    bucket: IBucketRef;
-    object: IObjectRef;
-    link: string;
-    fileStat: IFileStat;
-}) => IUploadResult;
-/** The MetaLink row for one stored object. Every path that creates a row goes through here, so each lands exactly the row an ordinary upload does. */
-export declare const createMetaLinkRow: (opts: {
-    metaLink: TMetaLinkConfig<AnyType>;
-    helper: IStorageHelper;
-    storage: TStaticAssetStorageType;
-    uploadResult: IUploadResult;
-    fileStat: IFileStat;
-    query: TUploadQuery;
-}) => Promise<AnyType>;
-/**
- * Rewrites the stored-object facts on every row of the pair. Rows per pair are deliberately not
- * unique, and each keeps its own labels and storage type. A `createMetaLink` hook owns `link` and
- * `metadata`, so with one only the stat columns change; without one, `metadata` is merged per row.
- */
-export declare const refreshMetaLinkRows: (opts: {
-    metaLink: TMetaLinkConfig<AnyType>;
-    helper: IStorageHelper;
-    bucket: IBucketRef;
-    object: IObjectRef;
-    link: string;
-    fileStat: IFileStat;
-}) => Promise<{
-    count: number;
-    data: AnyType[];
-}>;
+export declare class AssetMetaLink {
+    /** What a stat says about one stored object: the columns a refresh rewrites and a new row starts from. */
+    private static buildStoredObjectFacts;
+    /** The upload result of an object already in storage, so a commit or a recreate writes its row the way an upload does. */
+    static buildStoredUploadResult(opts: {
+        helper: IStorageHelper;
+        bucket: IBucketRef;
+        object: IObjectRef;
+        link: string;
+        fileStat: IFileStat;
+    }): IUploadResult;
+    /** The MetaLink row for one stored object. Every path that creates a row goes through here, so each lands exactly the row an ordinary upload does. */
+    static createRow(opts: {
+        metaLink: TMetaLinkConfig<AnyType>;
+        helper: IStorageHelper;
+        storage: TStaticAssetStorageType;
+        uploadResult: IUploadResult;
+        fileStat: IFileStat;
+        query: TUploadQuery;
+    }): Promise<AnyType>;
+    /**
+     * Rewrites the stored-object facts on every row of the pair. Rows per pair are deliberately not
+     * unique, and each keeps its own labels and storage type. A `createMetaLink` hook owns `link` and
+     * `metadata`, so with one only the stat columns change; without one, `metadata` is merged per row.
+     */
+    static refreshRows(opts: {
+        metaLink: TMetaLinkConfig<AnyType>;
+        helper: IStorageHelper;
+        bucket: IBucketRef;
+        object: IObjectRef;
+        link: string;
+        fileStat: IFileStat;
+    }): Promise<{
+        count: number;
+        data: AnyType[];
+    }>;
+}
 //# sourceMappingURL=meta-link.d.ts.map

package/dist/esm/components/static-asset/controller/meta-link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta-link.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/meta-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,cAAc,EACd,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAsBxF,0HAA0H;AAC1H,eAAO,MAAM,uBAAuB,GAAI,MAAM;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;CACrB,KAAG,aAYH,CAAC;AAEF,sJAAsJ;AACtJ,eAAO,MAAM,iBAAiB,GAAU,MAAM;IAC5C,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,uBAAuB,CAAC;IACjC,YAAY,EAAE,aAAa,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;CACrB,KAAG,OAAO,CAAC,OAAO,CA+BlB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAU,MAAM;IAC9C,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;CACrB,KAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAkC7C,CAAC"}
+{"version":3,"file":"meta-link.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/meta-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,cAAc,EACd,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAExF,qBAAa,aAAa;IACxB,0GAA0G;IAC1G,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAmBrC,0HAA0H;IAC1H,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE;QACnC,MAAM,EAAE,cAAc,CAAC;QACvB,MAAM,EAAE,UAAU,CAAC;QACnB,MAAM,EAAE,UAAU,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,SAAS,CAAC;KACrB,GAAG,aAAa;IAcjB,sJAAsJ;WACzI,SAAS,CAAC,IAAI,EAAE;QAC3B,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,EAAE,cAAc,CAAC;QACvB,OAAO,EAAE,uBAAuB,CAAC;QACjC,YAAY,EAAE,aAAa,CAAC;QAC5B,QAAQ,EAAE,SAAS,CAAC;QACpB,KAAK,EAAE,YAAY,CAAC;KACrB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiCpB;;;;OAIG;WACU,WAAW,CAAC,IAAI,EAAE;QAC7B,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,EAAE,cAAc,CAAC;QACvB,MAAM,EAAE,UAAU,CAAC;QACnB,MAAM,EAAE,UAAU,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,SAAS,CAAC;KACrB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CAmChD"}

package/dist/esm/components/static-asset/controller/meta-link.js

@@ -1,89 +1,91 @@
-import { resolveValueAsync } from '@venizia/ignis-helpers/common';
-/** What a stat says about one stored object: the columns a refresh rewrites and a new row starts from. */
-const buildStoredObjectFacts = (opts) => {
-    const { helper, object, link, fileStat } = opts;
-    return {
-        link,
-        // The column is NOT NULL and a backend may report nothing.
-        mimetype: fileStat.metadata?.mimetype ?? helper.getMimeType({ filename: object.key }),
-        size: fileStat.size,
-        etag: fileStat.etag,
-        metadata: fileStat.metadata,
-        isSynced: true,
-    };
-};
-/** The upload result of an object already in storage, so a commit or a recreate writes its row the way an upload does. */
-export const buildStoredUploadResult = (opts) => {
-    const { helper, bucket, object, link, fileStat } = opts;
-    return {
-        bucket,
-        object: {
-            key: object.key,
+import { ResolverUtility } from '@venizia/ignis-helpers/common';
+export class AssetMetaLink {
+    /** What a stat says about one stored object: the columns a refresh rewrites and a new row starts from. */
+    static buildStoredObjectFacts(opts) {
+        const { helper, object, link, fileStat } = opts;
+        return {
+            link,
+            // The column is NOT NULL and a backend may report nothing.
+            mimetype: fileStat.metadata?.mimetype ?? helper.getMimeType({ filename: object.key }),
             size: fileStat.size,
-            contentType: fileStat.metadata?.mimetype ?? helper.getMimeType({ filename: object.key }),
-        },
-        link,
-    };
-};
-/** The MetaLink row for one stored object. Every path that creates a row goes through here, so each lands exactly the row an ordinary upload does. */
-export const createMetaLinkRow = async (opts) => {
-    const { metaLink, helper, storage, uploadResult, fileStat, query } = opts;
-    if (metaLink.createMetaLink) {
-        const created = await metaLink.createMetaLink({ uploadResult, fileStat, query });
+            etag: fileStat.etag,
+            metadata: fileStat.metadata,
+            isSynced: true,
+        };
+    }
+    /** The upload result of an object already in storage, so a commit or a recreate writes its row the way an upload does. */
+    static buildStoredUploadResult(opts) {
+        const { helper, bucket, object, link, fileStat } = opts;
+        return {
+            bucket,
+            object: {
+                key: object.key,
+                size: fileStat.size,
+                contentType: fileStat.metadata?.mimetype ?? helper.getMimeType({ filename: object.key }),
+            },
+            link,
+        };
+    }
+    /** The MetaLink row for one stored object. Every path that creates a row goes through here, so each lands exactly the row an ordinary upload does. */
+    static async createRow(opts) {
+        const { metaLink, helper, storage, uploadResult, fileStat, query } = opts;
+        if (metaLink.createMetaLink) {
+            const created = await metaLink.createMetaLink({ uploadResult, fileStat, query });
+            return created.data;
+        }
+        // Resolved per call so an application that swaps the repository is not pinned to the first one.
+        const repository = await ResolverUtility.resolveValueAsync({ value: metaLink.repository });
+        const created = await repository.create({
+            data: {
+                bucketName: uploadResult.bucket.name,
+                objectName: uploadResult.object.key,
+                ...AssetMetaLink.buildStoredObjectFacts({
+                    helper,
+                    object: uploadResult.object,
+                    link: uploadResult.link,
+                    fileStat,
+                }),
+                storageType: storage,
+                principalId: query.principalId ? String(query.principalId) : undefined,
+                principalType: query.principalType ? String(query.principalType) : undefined,
+                variant: query.variant ? String(query.variant) : undefined,
+                // Absent leaves the column default rather than writing 0, so a row the caller never
+                // ordered is indistinguishable from a legacy one.
+                sequence: query.sequence === undefined ? undefined : Number(query.sequence),
+            },
+        });
         return created.data;
     }
-    // Resolved per call so an application that swaps the repository is not pinned to the first one.
-    const repository = await resolveValueAsync({ value: metaLink.repository });
-    const created = await repository.create({
-        data: {
-            bucketName: uploadResult.bucket.name,
-            objectName: uploadResult.object.key,
-            ...buildStoredObjectFacts({
-                helper,
-                object: uploadResult.object,
-                link: uploadResult.link,
-                fileStat,
-            }),
-            storageType: storage,
-            principalId: query.principalId ? String(query.principalId) : undefined,
-            principalType: query.principalType ? String(query.principalType) : undefined,
-            variant: query.variant ? String(query.variant) : undefined,
-            // Absent leaves the column default rather than writing 0, so a row the caller never
-            // ordered is indistinguishable from a legacy one.
-            sequence: query.sequence === undefined ? undefined : Number(query.sequence),
-        },
-    });
-    return created.data;
-};
-/**
- * Rewrites the stored-object facts on every row of the pair. Rows per pair are deliberately not
- * unique, and each keeps its own labels and storage type. A `createMetaLink` hook owns `link` and
- * `metadata`, so with one only the stat columns change; without one, `metadata` is merged per row.
- */
-export const refreshMetaLinkRows = async (opts) => {
-    const { metaLink, helper, bucket, object, link, fileStat } = opts;
-    const repository = await resolveValueAsync({ value: metaLink.repository });
-    const { mimetype, size, etag, isSynced } = buildStoredObjectFacts({
-        helper,
-        object,
-        link,
-        fileStat,
-    });
-    const statColumns = { mimetype, size, etag, isSynced };
-    const updated = await repository.updateAll({
-        data: metaLink.createMetaLink ? statColumns : { ...statColumns, link },
-        where: { bucketName: bucket.name, objectName: object.key },
-    });
-    const rows = updated.data ?? [];
-    if (metaLink.createMetaLink || !fileStat.metadata) {
-        return { count: updated.count, data: rows };
+    /**
+     * Rewrites the stored-object facts on every row of the pair. Rows per pair are deliberately not
+     * unique, and each keeps its own labels and storage type. A `createMetaLink` hook owns `link` and
+     * `metadata`, so with one only the stat columns change; without one, `metadata` is merged per row.
+     */
+    static async refreshRows(opts) {
+        const { metaLink, helper, bucket, object, link, fileStat } = opts;
+        const repository = await ResolverUtility.resolveValueAsync({ value: metaLink.repository });
+        const { mimetype, size, etag, isSynced } = AssetMetaLink.buildStoredObjectFacts({
+            helper,
+            object,
+            link,
+            fileStat,
+        });
+        const statColumns = { mimetype, size, etag, isSynced };
+        const updated = await repository.updateAll({
+            data: metaLink.createMetaLink ? statColumns : { ...statColumns, link },
+            where: { bucketName: bucket.name, objectName: object.key },
+        });
+        const rows = updated.data ?? [];
+        if (metaLink.createMetaLink || !fileStat.metadata) {
+            return { count: updated.count, data: rows };
+        }
+        // One UPDATE per row: each merge starts from that row's own keys, which the statement above
+        // returned untouched and which no single engine-neutral statement over the pair can express.
+        const merged = await Promise.all(rows.map((row) => repository.updateById({
+            id: row.id,
+            data: { metadata: { ...row.metadata, ...fileStat.metadata } },
+        })));
+        return { count: updated.count, data: merged.map((result) => result.data) };
     }
-    // One UPDATE per row: each merge starts from that row's own keys, which the statement above
-    // returned untouched and which no single engine-neutral statement over the pair can express.
-    const merged = await Promise.all(rows.map((row) => repository.updateById({
-        id: row.id,
-        data: { metadata: { ...row.metadata, ...fileStat.metadata } },
-    })));
-    return { count: updated.count, data: merged.map((result) => result.data) };
-};
+}
 //# sourceMappingURL=meta-link.js.map

package/dist/esm/components/static-asset/controller/meta-link.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta-link.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/meta-link.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  IBucketRef,\n  IFileStat,\n  IObjectRef,\n  IStorageHelper,\n  IUploadResult,\n} from '@venizia/ignis-helpers';\nimport { resolveValueAsync } from '@venizia/ignis-helpers/common';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport type { TMetaLinkConfig, TStaticAssetStorageType, TUploadQuery } from '../common';\n\n/** What a stat says about one stored object: the columns a refresh rewrites and a new row starts from. */\nconst buildStoredObjectFacts = (opts: {\n  helper: IStorageHelper;\n  object: IObjectRef;\n  link: string;\n  fileStat: IFileStat;\n}) => {\n  const { helper, object, link, fileStat } = opts;\n\n  return {\n    link,\n    // The column is NOT NULL and a backend may report nothing.\n    mimetype: fileStat.metadata?.mimetype ?? helper.getMimeType({ filename: object.key }),\n    size: fileStat.size,\n    etag: fileStat.etag,\n    metadata: fileStat.metadata,\n    isSynced: true,\n  };\n};\n\n/** The upload result of an object already in storage, so a commit or a recreate writes its row the way an upload does. */\nexport const buildStoredUploadResult = (opts: {\n  helper: IStorageHelper;\n  bucket: IBucketRef;\n  object: IObjectRef;\n  link: string;\n  fileStat: IFileStat;\n}): IUploadResult => {\n  const { helper, bucket, object, link, fileStat } = opts;\n\n  return {\n    bucket,\n    object: {\n      key: object.key,\n      size: fileStat.size,\n      contentType: fileStat.metadata?.mimetype ?? helper.getMimeType({ filename: object.key }),\n    },\n    link,\n  };\n};\n\n/** The MetaLink row for one stored object. Every path that creates a row goes through here, so each lands exactly the row an ordinary upload does. */\nexport const createMetaLinkRow = async (opts: {\n  metaLink: TMetaLinkConfig<AnyType>;\n  helper: IStorageHelper;\n  storage: TStaticAssetStorageType;\n  uploadResult: IUploadResult;\n  fileStat: IFileStat;\n  query: TUploadQuery;\n}): Promise<AnyType> => {\n  const { metaLink, helper, storage, uploadResult, fileStat, query } = opts;\n\n  if (metaLink.createMetaLink) {\n    const created = await metaLink.createMetaLink({ uploadResult, fileStat, query });\n    return created.data;\n  }\n\n  // Resolved per call so an application that swaps the repository is not pinned to the first one.\n  const repository = await resolveValueAsync({ value: metaLink.repository });\n  const created = await repository.create({\n    data: {\n      bucketName: uploadResult.bucket.name,\n      objectName: uploadResult.object.key,\n      ...buildStoredObjectFacts({\n        helper,\n        object: uploadResult.object,\n        link: uploadResult.link,\n        fileStat,\n      }),\n      storageType: storage,\n      principalId: query.principalId ? String(query.principalId) : undefined,\n      principalType: query.principalType ? String(query.principalType) : undefined,\n      variant: query.variant ? String(query.variant) : undefined,\n      // Absent leaves the column default rather than writing 0, so a row the caller never\n      // ordered is indistinguishable from a legacy one.\n      sequence: query.sequence === undefined ? undefined : Number(query.sequence),\n    },\n  });\n\n  return created.data;\n};\n\n/**\n * Rewrites the stored-object facts on every row of the pair. Rows per pair are deliberately not\n * unique, and each keeps its own labels and storage type. A `createMetaLink` hook owns `link` and\n * `metadata`, so with one only the stat columns change; without one, `metadata` is merged per row.\n */\nexport const refreshMetaLinkRows = async (opts: {\n  metaLink: TMetaLinkConfig<AnyType>;\n  helper: IStorageHelper;\n  bucket: IBucketRef;\n  object: IObjectRef;\n  link: string;\n  fileStat: IFileStat;\n}): Promise<{ count: number; data: AnyType[] }> => {\n  const { metaLink, helper, bucket, object, link, fileStat } = opts;\n\n  const repository = await resolveValueAsync({ value: metaLink.repository });\n  const { mimetype, size, etag, isSynced } = buildStoredObjectFacts({\n    helper,\n    object,\n    link,\n    fileStat,\n  });\n  const statColumns = { mimetype, size, etag, isSynced };\n\n  const updated = await repository.updateAll({\n    data: metaLink.createMetaLink ? statColumns : { ...statColumns, link },\n    where: { bucketName: bucket.name, objectName: object.key },\n  });\n  const rows = updated.data ?? [];\n\n  if (metaLink.createMetaLink || !fileStat.metadata) {\n    return { count: updated.count, data: rows };\n  }\n\n  // One UPDATE per row: each merge starts from that row's own keys, which the statement above\n  // returned untouched and which no single engine-neutral statement over the pair can express.\n  const merged = await Promise.all(\n    rows.map((row) =>\n      repository.updateById({\n        id: row.id,\n        data: { metadata: { ...row.metadata, ...fileStat.metadata } },\n      }),\n    ),\n  );\n\n  return { count: updated.count, data: merged.map((result) => result.data) };\n};\n"]}
+{"version":3,"file":"meta-link.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/meta-link.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  IBucketRef,\n  IFileStat,\n  IObjectRef,\n  IStorageHelper,\n  IUploadResult,\n} from '@venizia/ignis-helpers';\nimport { ResolverUtility } from '@venizia/ignis-helpers/common';\nimport type { AnyType } from '@venizia/ignis-helpers/common';\nimport type { TMetaLinkConfig, TStaticAssetStorageType, TUploadQuery } from '../common';\n\nexport class AssetMetaLink {\n  /** What a stat says about one stored object: the columns a refresh rewrites and a new row starts from. */\n  private static buildStoredObjectFacts(opts: {\n    helper: IStorageHelper;\n    object: IObjectRef;\n    link: string;\n    fileStat: IFileStat;\n  }) {\n    const { helper, object, link, fileStat } = opts;\n\n    return {\n      link,\n      // The column is NOT NULL and a backend may report nothing.\n      mimetype: fileStat.metadata?.mimetype ?? helper.getMimeType({ filename: object.key }),\n      size: fileStat.size,\n      etag: fileStat.etag,\n      metadata: fileStat.metadata,\n      isSynced: true,\n    };\n  }\n\n  /** The upload result of an object already in storage, so a commit or a recreate writes its row the way an upload does. */\n  static buildStoredUploadResult(opts: {\n    helper: IStorageHelper;\n    bucket: IBucketRef;\n    object: IObjectRef;\n    link: string;\n    fileStat: IFileStat;\n  }): IUploadResult {\n    const { helper, bucket, object, link, fileStat } = opts;\n\n    return {\n      bucket,\n      object: {\n        key: object.key,\n        size: fileStat.size,\n        contentType: fileStat.metadata?.mimetype ?? helper.getMimeType({ filename: object.key }),\n      },\n      link,\n    };\n  }\n\n  /** The MetaLink row for one stored object. Every path that creates a row goes through here, so each lands exactly the row an ordinary upload does. */\n  static async createRow(opts: {\n    metaLink: TMetaLinkConfig<AnyType>;\n    helper: IStorageHelper;\n    storage: TStaticAssetStorageType;\n    uploadResult: IUploadResult;\n    fileStat: IFileStat;\n    query: TUploadQuery;\n  }): Promise<AnyType> {\n    const { metaLink, helper, storage, uploadResult, fileStat, query } = opts;\n\n    if (metaLink.createMetaLink) {\n      const created = await metaLink.createMetaLink({ uploadResult, fileStat, query });\n      return created.data;\n    }\n\n    // Resolved per call so an application that swaps the repository is not pinned to the first one.\n    const repository = await ResolverUtility.resolveValueAsync({ value: metaLink.repository });\n    const created = await repository.create({\n      data: {\n        bucketName: uploadResult.bucket.name,\n        objectName: uploadResult.object.key,\n        ...AssetMetaLink.buildStoredObjectFacts({\n          helper,\n          object: uploadResult.object,\n          link: uploadResult.link,\n          fileStat,\n        }),\n        storageType: storage,\n        principalId: query.principalId ? String(query.principalId) : undefined,\n        principalType: query.principalType ? String(query.principalType) : undefined,\n        variant: query.variant ? String(query.variant) : undefined,\n        // Absent leaves the column default rather than writing 0, so a row the caller never\n        // ordered is indistinguishable from a legacy one.\n        sequence: query.sequence === undefined ? undefined : Number(query.sequence),\n      },\n    });\n\n    return created.data;\n  }\n\n  /**\n   * Rewrites the stored-object facts on every row of the pair. Rows per pair are deliberately not\n   * unique, and each keeps its own labels and storage type. A `createMetaLink` hook owns `link` and\n   * `metadata`, so with one only the stat columns change; without one, `metadata` is merged per row.\n   */\n  static async refreshRows(opts: {\n    metaLink: TMetaLinkConfig<AnyType>;\n    helper: IStorageHelper;\n    bucket: IBucketRef;\n    object: IObjectRef;\n    link: string;\n    fileStat: IFileStat;\n  }): Promise<{ count: number; data: AnyType[] }> {\n    const { metaLink, helper, bucket, object, link, fileStat } = opts;\n\n    const repository = await ResolverUtility.resolveValueAsync({ value: metaLink.repository });\n    const { mimetype, size, etag, isSynced } = AssetMetaLink.buildStoredObjectFacts({\n      helper,\n      object,\n      link,\n      fileStat,\n    });\n    const statColumns = { mimetype, size, etag, isSynced };\n\n    const updated = await repository.updateAll({\n      data: metaLink.createMetaLink ? statColumns : { ...statColumns, link },\n      where: { bucketName: bucket.name, objectName: object.key },\n    });\n    const rows = updated.data ?? [];\n\n    if (metaLink.createMetaLink || !fileStat.metadata) {\n      return { count: updated.count, data: rows };\n    }\n\n    // One UPDATE per row: each merge starts from that row's own keys, which the statement above\n    // returned untouched and which no single engine-neutral statement over the pair can express.\n    const merged = await Promise.all(\n      rows.map((row) =>\n        repository.updateById({\n          id: row.id,\n          data: { metadata: { ...row.metadata, ...fileStat.metadata } },\n        }),\n      ),\n    );\n\n    return { count: updated.count, data: merged.map((result) => result.data) };\n  }\n}\n"]}

package/dist/esm/components/static-asset/controller/route-options.d.ts

@@ -1,18 +1,20 @@
 import { type TStaticAssetRouteConfig } from '../common/index.js';
-/** Splits the `enabled` switch off the route config: it is this component's field, never a Hono one. */
-export declare const readRouteOverride: (opts: {
-    route?: TStaticAssetRouteConfig;
-}) => {
-    isEnabled: boolean;
-    override: Omit<TStaticAssetRouteConfig, "enabled">;
-};
-/**
- * The route's body validator reads the whole multipart body, so a declared length checked in the
- * handler arrives too late to save any memory. Appended after the application's own middleware, so
- * a check of its own still answers first.
- */
-export declare const appendDeclaredLengthGuard: (opts: {
-    middleware: TStaticAssetRouteConfig["middleware"];
-    maxBytes: number;
-}) => NonNullable<TStaticAssetRouteConfig["middleware"]>;
+export declare class AssetRouteOptions {
+    /** Splits the `enabled` switch off the route config: it is this component's field, never a Hono one. */
+    static readOverride(opts: {
+        route?: TStaticAssetRouteConfig;
+    }): {
+        isEnabled: boolean;
+        override: Omit<TStaticAssetRouteConfig, 'enabled'>;
+    };
+    /**
+     * The route's body validator reads the whole multipart body, so a declared length checked in the
+     * handler arrives too late to save any memory. Appended after the application's own middleware, so
+     * a check of its own still answers first.
+     */
+    static appendLengthGuard(opts: {
+        middleware: TStaticAssetRouteConfig['middleware'];
+        maxBytes: number;
+    }): NonNullable<TStaticAssetRouteConfig['middleware']>;
+}
 //# sourceMappingURL=route-options.d.ts.map

package/dist/esm/components/static-asset/controller/route-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-options.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/route-options.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAE5E,wGAAwG;AACxG,eAAO,MAAM,iBAAiB,GAAI,MAAM;IACtC,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC,KAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAA;CAG3E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAC9C,UAAU,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB,KAAG,WAAW,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAsBpD,CAAC"}
+{"version":3,"file":"route-options.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/route-options.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAE5E,qBAAa,iBAAiB;IAC5B,wGAAwG;IACxG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,uBAAuB,CAAA;KAAE,GAAG;QAC9D,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;KACpD;IAKD;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC7B,UAAU,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAC;QAClD,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,WAAW,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC;CAuBvD"}

package/dist/esm/components/static-asset/controller/route-options.js

@@ -1,32 +1,34 @@
 import { HTTP } from '@venizia/ignis-helpers/common';
 import { getError } from '@venizia/ignis-helpers/core';
 import { StaticAssetErrors } from '../common/index.js';
-/** Splits the `enabled` switch off the route config: it is this component's field, never a Hono one. */
-export const readRouteOverride = (opts) => {
-    const { enabled, ...override } = opts.route ?? {};
-    return { isEnabled: enabled !== false, override };
-};
-/**
- * The route's body validator reads the whole multipart body, so a declared length checked in the
- * handler arrives too late to save any memory. Appended after the application's own middleware, so
- * a check of its own still answers first.
- */
-export const appendDeclaredLengthGuard = (opts) => {
-    const { middleware, maxBytes } = opts;
-    const guard = async (context, next) => {
-        const declaredLength = Number(context.req.header(HTTP.Headers.CONTENT_LENGTH));
-        // Not authoritative: a multipart envelope is larger than its files, so the per-file check in the handler decides.
-        if (Number.isFinite(declaredLength) && declaredLength > maxBytes) {
-            throw getError({
-                error: StaticAssetErrors.UPLOAD_TOO_LARGE,
-                message: `Request body of ${declaredLength} bytes exceeds the maximum of ${maxBytes}`,
-            });
+export class AssetRouteOptions {
+    /** Splits the `enabled` switch off the route config: it is this component's field, never a Hono one. */
+    static readOverride(opts) {
+        const { enabled, ...override } = opts.route ?? {};
+        return { isEnabled: enabled !== false, override };
+    }
+    /**
+     * The route's body validator reads the whole multipart body, so a declared length checked in the
+     * handler arrives too late to save any memory. Appended after the application's own middleware, so
+     * a check of its own still answers first.
+     */
+    static appendLengthGuard(opts) {
+        const { middleware, maxBytes } = opts;
+        const guard = async (context, next) => {
+            const declaredLength = Number(context.req.header(HTTP.Headers.CONTENT_LENGTH));
+            // Not authoritative: a multipart envelope is larger than its files, so the per-file check in the handler decides.
+            if (Number.isFinite(declaredLength) && declaredLength > maxBytes) {
+                throw getError({
+                    error: StaticAssetErrors.UPLOAD_TOO_LARGE,
+                    message: `Request body of ${declaredLength} bytes exceeds the maximum of ${maxBytes}`,
+                });
+            }
+            await next();
+        };
+        if (!middleware) {
+            return [guard];
         }
-        await next();
-    };
-    if (!middleware) {
-        return [guard];
+        return Array.isArray(middleware) ? [...middleware, guard] : [middleware, guard];
     }
-    return Array.isArray(middleware) ? [...middleware, guard] : [middleware, guard];
-};
+}
 //# sourceMappingURL=route-options.js.map

package/dist/esm/components/static-asset/controller/route-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-options.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/route-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAgC,MAAM,WAAW,CAAC;AAE5E,wGAAwG;AACxG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAEjC,EAA8E,EAAE;IAC/E,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAClD,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,KAAK,EAAE,QAAQ,EAAE,CAAC;AACpD,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAGzC,EAAsD,EAAE;IACvD,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAEtC,MAAM,KAAK,GAAsB,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACvD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;QAE/E,kHAAkH;QAClH,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;YACjE,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,iBAAiB,CAAC,gBAAgB;gBACzC,OAAO,EAAE,mBAAmB,cAAc,iCAAiC,QAAQ,EAAE;aACtF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;IAEF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAClF,CAAC,CAAC","sourcesContent":["import { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { MiddlewareHandler } from 'hono';\nimport { StaticAssetErrors, type TStaticAssetRouteConfig } from '../common';\n\n/** Splits the `enabled` switch off the route config: it is this component's field, never a Hono one. */\nexport const readRouteOverride = (opts: {\n  route?: TStaticAssetRouteConfig;\n}): { isEnabled: boolean; override: Omit<TStaticAssetRouteConfig, 'enabled'> } => {\n  const { enabled, ...override } = opts.route ?? {};\n  return { isEnabled: enabled !== false, override };\n};\n\n/**\n * The route's body validator reads the whole multipart body, so a declared length checked in the\n * handler arrives too late to save any memory. Appended after the application's own middleware, so\n * a check of its own still answers first.\n */\nexport const appendDeclaredLengthGuard = (opts: {\n  middleware: TStaticAssetRouteConfig['middleware'];\n  maxBytes: number;\n}): NonNullable<TStaticAssetRouteConfig['middleware']> => {\n  const { middleware, maxBytes } = opts;\n\n  const guard: MiddlewareHandler = async (context, next) => {\n    const declaredLength = Number(context.req.header(HTTP.Headers.CONTENT_LENGTH));\n\n    // Not authoritative: a multipart envelope is larger than its files, so the per-file check in the handler decides.\n    if (Number.isFinite(declaredLength) && declaredLength > maxBytes) {\n      throw getError({\n        error: StaticAssetErrors.UPLOAD_TOO_LARGE,\n        message: `Request body of ${declaredLength} bytes exceeds the maximum of ${maxBytes}`,\n      });\n    }\n\n    await next();\n  };\n\n  if (!middleware) {\n    return [guard];\n  }\n\n  return Array.isArray(middleware) ? [...middleware, guard] : [middleware, guard];\n};\n"]}
+{"version":3,"file":"route-options.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/route-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAgC,MAAM,WAAW,CAAC;AAE5E,MAAM,OAAO,iBAAiB;IAC5B,wGAAwG;IACxG,MAAM,CAAC,YAAY,CAAC,IAAyC;QAI3D,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,KAAK,EAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAGxB;QACC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEtC,MAAM,KAAK,GAAsB,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YACvD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;YAE/E,kHAAkH;YAClH,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;gBACjE,MAAM,QAAQ,CAAC;oBACb,KAAK,EAAE,iBAAiB,CAAC,gBAAgB;oBACzC,OAAO,EAAE,mBAAmB,cAAc,iCAAiC,QAAQ,EAAE;iBACtF,CAAC,CAAC;YACL,CAAC;YAED,MAAM,IAAI,EAAE,CAAC;QACf,CAAC,CAAC;QAEF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;CACF","sourcesContent":["import { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { MiddlewareHandler } from 'hono';\nimport { StaticAssetErrors, type TStaticAssetRouteConfig } from '../common';\n\nexport class AssetRouteOptions {\n  /** Splits the `enabled` switch off the route config: it is this component's field, never a Hono one. */\n  static readOverride(opts: { route?: TStaticAssetRouteConfig }): {\n    isEnabled: boolean;\n    override: Omit<TStaticAssetRouteConfig, 'enabled'>;\n  } {\n    const { enabled, ...override } = opts.route ?? {};\n    return { isEnabled: enabled !== false, override };\n  }\n\n  /**\n   * The route's body validator reads the whole multipart body, so a declared length checked in the\n   * handler arrives too late to save any memory. Appended after the application's own middleware, so\n   * a check of its own still answers first.\n   */\n  static appendLengthGuard(opts: {\n    middleware: TStaticAssetRouteConfig['middleware'];\n    maxBytes: number;\n  }): NonNullable<TStaticAssetRouteConfig['middleware']> {\n    const { middleware, maxBytes } = opts;\n\n    const guard: MiddlewareHandler = async (context, next) => {\n      const declaredLength = Number(context.req.header(HTTP.Headers.CONTENT_LENGTH));\n\n      // Not authoritative: a multipart envelope is larger than its files, so the per-file check in the handler decides.\n      if (Number.isFinite(declaredLength) && declaredLength > maxBytes) {\n        throw getError({\n          error: StaticAssetErrors.UPLOAD_TOO_LARGE,\n          message: `Request body of ${declaredLength} bytes exceeds the maximum of ${maxBytes}`,\n        });\n      }\n\n      await next();\n    };\n\n    if (!middleware) {\n      return [guard];\n    }\n\n    return Array.isArray(middleware) ? [...middleware, guard] : [middleware, guard];\n  }\n}\n"]}

package/dist/esm/components/static-asset/models/base.model.js

@@ -5,13 +5,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { model } from '../../../base/metadata/index.js';
-import { BaseRelationalEntity, generateIdColumnDefs, generateTzColumnDefs, } from '@venizia/ignis-connectors/postgres';
+import { BaseRelationalEntity, PostgresIdEnricher, PostgresTzEnricher, } from '@venizia/ignis-connectors/postgres';
 import { boolean, index, integer, jsonb, pgTable, text } from 'drizzle-orm/pg-core';
 /** One row per (object, owner) pairing, NOT per object: one product image attached to the product and to each variant is the common case, so `(bucketName, objectName)` is indexed and deliberately NOT unique. */
 let BaseMetaLinkModel = class BaseMetaLinkModel extends BaseRelationalEntity {
     static { this.schema = pgTable('MetaLink', {
-        ...generateIdColumnDefs({ id: { dataType: 'string' } }),
-        ...generateTzColumnDefs(),
+        ...PostgresIdEnricher.generateColumnDefs({ id: { dataType: 'string' } }),
+        ...PostgresTzEnricher.generateColumnDefs(),
         bucketName: text('bucket_name').notNull(),
         objectName: text('object_name').notNull(),
         link: text().notNull(),

package/dist/esm/components/static-asset/models/base.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.model.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/models/base.model.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEpF,mNAAmN;AAE5M,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,oBAAqD;aAC1E,WAAM,GAAG,OAAO,CAC9B,UAAU,EACV;QACE,GAAG,oBAAoB,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC;QACvD,GAAG,oBAAoB,EAAE;QACzB,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;QACzC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;QACzC,IAAI,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;QACtB,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;QAC1B,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE;QACzB,IAAI,EAAE,IAAI,EAAE;QACZ,QAAQ,EAAE,KAAK,EAAE,CAAC,KAAK,EAAuB;QAC9C,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;QAC3C,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAEvD,+IAA+I;QAC/I,OAAO,EAAE,IAAI,EAAE;QAEf,qJAAqJ;QACrJ,QAAQ,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAExC,uKAAuK;QACvK,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACrC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;KAClC,EACD,CAAC,GAAG,EAAE,EAAE,CAAC;QACP,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;QACnD,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;QACnD,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;QACrD,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC/C,8FAA8F;QAC9F,KAAK,CAAC,iCAAiC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC;KAC9F,CACF,AAjCqB,CAiCpB;aAEc,cAAS,GAAG,GAAG,EAAE,CAAC,EAAE,AAAX,CAAY;;AApC1B,iBAAiB;IAD7B,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;GACxB,iBAAiB,CAqC7B","sourcesContent":["import { model } from '@/base/metadata';\nimport {\n  BaseRelationalEntity,\n  generateIdColumnDefs,\n  generateTzColumnDefs,\n  type TTableObject,\n  type TTableSchemaWithId,\n} from '@venizia/ignis-connectors/postgres';\nimport { boolean, index, integer, jsonb, pgTable, text } from 'drizzle-orm/pg-core';\n\n/** One row per (object, owner) pairing, NOT per object: one product image attached to the product and to each variant is the common case, so `(bucketName, objectName)` is indexed and deliberately NOT unique. */\n@model({ migration: { use: false } })\nexport class BaseMetaLinkModel extends BaseRelationalEntity<typeof BaseMetaLinkModel.schema> {\n  static override schema = pgTable(\n    'MetaLink',\n    {\n      ...generateIdColumnDefs({ id: { dataType: 'string' } }),\n      ...generateTzColumnDefs(),\n      bucketName: text('bucket_name').notNull(),\n      objectName: text('object_name').notNull(),\n      link: text().notNull(),\n      mimetype: text().notNull(),\n      size: integer().notNull(),\n      etag: text(),\n      metadata: jsonb().$type<Record<string, any>>(),\n      storageType: text('storage_type').notNull(),\n      isSynced: boolean('is_synced').notNull().default(false),\n\n      /** An opaque label the caller chooses - a size, a role, a rendition name. The component stores and returns it and reads no meaning into it. */\n      variant: text(),\n\n      /** Display order within ONE principal. Defaults to 0 so legacy rows tie and `ORDER BY sequence, createdAt` reproduces the order they already had. */\n      sequence: integer().notNull().default(0),\n\n      /** A polymorphic owner: the type names the table, the id the row. Both nullable - an object may belong to nothing yet, which is how `recreate-metalink` writes one. */\n      principalType: text('principal_type'),\n      principalId: text('principal_id'),\n    },\n    (def) => [\n      index(`IDX_MetaLink_bucketName`).on(def.bucketName),\n      index(`IDX_MetaLink_objectName`).on(def.objectName),\n      index(`IDX_MetaLink_storageType`).on(def.storageType),\n      index(`IDX_MetaLink_isSynced`).on(def.isSynced),\n      // Ordering runs inside a principal filter, so filter columns lead and the sort column trails.\n      index(`IDX_MetaLink_principal_sequence`).on(def.principalType, def.principalId, def.sequence),\n    ],\n  );\n\n  static override relations = () => [];\n}\n\nexport type TMetaLinkSchema = typeof BaseMetaLinkModel.schema;\nexport type TMetaLink = TTableObject<TMetaLinkSchema>;\n\n/** Any table whose row carries the MetaLink fields. The component reads and writes the ROW, so the table is free to carry another name or to live in another Postgres schema. */\nexport type TMetaLinkCompatibleSchema = TTableSchemaWithId & { $inferSelect: TMetaLink };\n"]}
+{"version":3,"file":"base.model.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/models/base.model.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GAGnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEpF,mNAAmN;AAE5M,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,oBAAqD;aAC1E,WAAM,GAAG,OAAO,CAC9B,UAAU,EACV;QACE,GAAG,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC;QACxE,GAAG,kBAAkB,CAAC,kBAAkB,EAAE;QAC1C,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;QACzC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;QACzC,IAAI,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;QACtB,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;QAC1B,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE;QACzB,IAAI,EAAE,IAAI,EAAE;QACZ,QAAQ,EAAE,KAAK,EAAE,CAAC,KAAK,EAAuB;QAC9C,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;QAC3C,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAEvD,+IAA+I;QAC/I,OAAO,EAAE,IAAI,EAAE;QAEf,qJAAqJ;QACrJ,QAAQ,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAExC,uKAAuK;QACvK,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACrC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;KAClC,EACD,CAAC,GAAG,EAAE,EAAE,CAAC;QACP,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;QACnD,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;QACnD,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;QACrD,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC/C,8FAA8F;QAC9F,KAAK,CAAC,iCAAiC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC;KAC9F,CACF,AAjCqB,CAiCpB;aAEc,cAAS,GAAG,GAAG,EAAE,CAAC,EAAE,AAAX,CAAY;;AApC1B,iBAAiB;IAD7B,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;GACxB,iBAAiB,CAqC7B","sourcesContent":["import { model } from '@/base/metadata';\nimport {\n  BaseRelationalEntity,\n  PostgresIdEnricher,\n  PostgresTzEnricher,\n  type TTableObject,\n  type TTableSchemaWithId,\n} from '@venizia/ignis-connectors/postgres';\nimport { boolean, index, integer, jsonb, pgTable, text } from 'drizzle-orm/pg-core';\n\n/** One row per (object, owner) pairing, NOT per object: one product image attached to the product and to each variant is the common case, so `(bucketName, objectName)` is indexed and deliberately NOT unique. */\n@model({ migration: { use: false } })\nexport class BaseMetaLinkModel extends BaseRelationalEntity<typeof BaseMetaLinkModel.schema> {\n  static override schema = pgTable(\n    'MetaLink',\n    {\n      ...PostgresIdEnricher.generateColumnDefs({ id: { dataType: 'string' } }),\n      ...PostgresTzEnricher.generateColumnDefs(),\n      bucketName: text('bucket_name').notNull(),\n      objectName: text('object_name').notNull(),\n      link: text().notNull(),\n      mimetype: text().notNull(),\n      size: integer().notNull(),\n      etag: text(),\n      metadata: jsonb().$type<Record<string, any>>(),\n      storageType: text('storage_type').notNull(),\n      isSynced: boolean('is_synced').notNull().default(false),\n\n      /** An opaque label the caller chooses - a size, a role, a rendition name. The component stores and returns it and reads no meaning into it. */\n      variant: text(),\n\n      /** Display order within ONE principal. Defaults to 0 so legacy rows tie and `ORDER BY sequence, createdAt` reproduces the order they already had. */\n      sequence: integer().notNull().default(0),\n\n      /** A polymorphic owner: the type names the table, the id the row. Both nullable - an object may belong to nothing yet, which is how `recreate-metalink` writes one. */\n      principalType: text('principal_type'),\n      principalId: text('principal_id'),\n    },\n    (def) => [\n      index(`IDX_MetaLink_bucketName`).on(def.bucketName),\n      index(`IDX_MetaLink_objectName`).on(def.objectName),\n      index(`IDX_MetaLink_storageType`).on(def.storageType),\n      index(`IDX_MetaLink_isSynced`).on(def.isSynced),\n      // Ordering runs inside a principal filter, so filter columns lead and the sort column trails.\n      index(`IDX_MetaLink_principal_sequence`).on(def.principalType, def.principalId, def.sequence),\n    ],\n  );\n\n  static override relations = () => [];\n}\n\nexport type TMetaLinkSchema = typeof BaseMetaLinkModel.schema;\nexport type TMetaLink = TTableObject<TMetaLinkSchema>;\n\n/** Any table whose row carries the MetaLink fields. The component reads and writes the ROW, so the table is free to carry another name or to live in another Postgres schema. */\nexport type TMetaLinkCompatibleSchema = TTableSchemaWithId & { $inferSelect: TMetaLink };\n"]}

package/dist/esm/components/websocket/component.js

@@ -19,7 +19,7 @@ import { getError } from '@venizia/ignis-helpers/core';
 import { HTTP } from '@venizia/ignis-helpers/common';
 import { isRedisHelper, WebSocketDefaults, WebSocketServerHelper, } from '@venizia/ignis-helpers';
 import { WebSocketBindingKeys, DEFAULT_SERVER_OPTIONS, } from './common/index.js';
-import { createBunFetchHandler } from './handlers/index.js';
+import { WebSocketBunHandler } from './handlers/index.js';
 let WebSocketComponent = WebSocketComponent_1 = class WebSocketComponent extends BaseComponent {
     constructor(application) {
         super({
@@ -144,7 +144,7 @@ let WebSocketComponent = WebSocketComponent_1 = class WebSocketComponent extends
                 this.application.bind({ key: WebSocketBindingKeys.WEBSOCKET_INSTANCE }).toValue(wsHelper);
                 const wsPath = serverOptions.path ?? WebSocketDefaults.PATH;
                 serverInstance.reload({
-                    fetch: createBunFetchHandler({ wsPath, honoServer }),
+                    fetch: WebSocketBunHandler.createFetchHandler({ wsPath, honoServer }),
                     websocket: wsHelper.getBunWebSocketHandler(),
                 });
                 logger.info('WebSocket initialized for Bun runtime');

package/dist/esm/components/websocket/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../../src/components/websocket/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, type ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport {\n  type AbstractRedisHelper,\n  isRedisHelper,\n  type TWebSocketAuthenticateFn,\n  type TWebSocketClientConnectedFn,\n  type TWebSocketClientDisconnectedFn,\n  type TWebSocketMessageHandler,\n  type TWebSocketHandshakeFn,\n  type TWebSocketOutboundTransformer,\n  type TWebSocketValidateRoomFn,\n  WebSocketDefaults,\n  WebSocketServerHelper,\n} from '@venizia/ignis-helpers';\nimport {\n  WebSocketBindingKeys,\n  DEFAULT_SERVER_OPTIONS,\n  type IResolvedBindings,\n  type IServerOptions,\n} from './common';\nimport { createBunFetchHandler } from './handlers';\n\nexport class WebSocketComponent extends BaseComponent {\n  protected serverOptions: IServerOptions;\n\n  constructor(\n    @inject({ key: CoreBindings.APPLICATION_INSTANCE }) private application: BaseApplication,\n  ) {\n    super({\n      scope: WebSocketComponent.name,\n      initDefault: { enable: true, container: application },\n      bindings: {\n        [WebSocketBindingKeys.SERVER_OPTIONS]: Binding.bind<Partial<IServerOptions>>({\n          key: WebSocketBindingKeys.SERVER_OPTIONS,\n        }).toValue(DEFAULT_SERVER_OPTIONS),\n\n        [WebSocketBindingKeys.REDIS_CONNECTION]: Binding.bind<AbstractRedisHelper | null>({\n          key: WebSocketBindingKeys.REDIS_CONNECTION,\n        }).toValue(null),\n\n        [WebSocketBindingKeys.AUTHENTICATE_HANDLER]: Binding.bind<TWebSocketAuthenticateFn | null>({\n          key: WebSocketBindingKeys.AUTHENTICATE_HANDLER,\n        }).toValue(null),\n\n        [WebSocketBindingKeys.VALIDATE_ROOM_HANDLER]: Binding.bind<TWebSocketValidateRoomFn | null>(\n          {\n            key: WebSocketBindingKeys.VALIDATE_ROOM_HANDLER,\n          },\n        ).toValue(null),\n\n        [WebSocketBindingKeys.CLIENT_CONNECTED_HANDLER]:\n          Binding.bind<TWebSocketClientConnectedFn | null>({\n            key: WebSocketBindingKeys.CLIENT_CONNECTED_HANDLER,\n          }).toValue(null),\n\n        [WebSocketBindingKeys.CLIENT_DISCONNECTED_HANDLER]:\n          Binding.bind<TWebSocketClientDisconnectedFn | null>({\n            key: WebSocketBindingKeys.CLIENT_DISCONNECTED_HANDLER,\n          }).toValue(null),\n\n        [WebSocketBindingKeys.MESSAGE_HANDLER]: Binding.bind<TWebSocketMessageHandler | null>({\n          key: WebSocketBindingKeys.MESSAGE_HANDLER,\n        }).toValue(null),\n\n        [WebSocketBindingKeys.OUTBOUND_TRANSFORMER]:\n          Binding.bind<TWebSocketOutboundTransformer | null>({\n            key: WebSocketBindingKeys.OUTBOUND_TRANSFORMER,\n          }).toValue(null),\n\n        [WebSocketBindingKeys.HANDSHAKE_HANDLER]: Binding.bind<TWebSocketHandshakeFn | null>({\n          key: WebSocketBindingKeys.HANDSHAKE_HANDLER,\n        }).toValue(null),\n      },\n    });\n  }\n\n  private resolveBindings(): IResolvedBindings {\n    const extraServerOptions =\n      this.application.get<Partial<IServerOptions>>({\n        key: WebSocketBindingKeys.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: WebSocketBindingKeys.REDIS_CONNECTION,\n    });\n    if (!isRedisHelper(redisConnection)) {\n      throw getError({\n        message:\n          '[WebSocketComponent][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<TWebSocketAuthenticateFn>({\n      key: WebSocketBindingKeys.AUTHENTICATE_HANDLER,\n    });\n    if (!authenticateFn) {\n      throw getError({\n        message: '[WebSocketComponent] Invalid authenticateFn to setup WebSocket server!',\n      });\n    }\n\n    const validateRoomFn =\n      this.application.get<TWebSocketValidateRoomFn | null>({\n        key: WebSocketBindingKeys.VALIDATE_ROOM_HANDLER,\n      }) ?? undefined;\n    const clientConnectedFn =\n      this.application.get<TWebSocketClientConnectedFn | null>({\n        key: WebSocketBindingKeys.CLIENT_CONNECTED_HANDLER,\n      }) ?? undefined;\n    const clientDisconnectedFn =\n      this.application.get<TWebSocketClientDisconnectedFn | null>({\n        key: WebSocketBindingKeys.CLIENT_DISCONNECTED_HANDLER,\n      }) ?? undefined;\n    const messageHandler =\n      this.application.get<TWebSocketMessageHandler | null>({\n        key: WebSocketBindingKeys.MESSAGE_HANDLER,\n      }) ?? undefined;\n    const outboundTransformer =\n      this.application.get<TWebSocketOutboundTransformer | null>({\n        key: WebSocketBindingKeys.OUTBOUND_TRANSFORMER,\n      }) ?? undefined;\n    const handshakeFn =\n      this.application.get<TWebSocketHandshakeFn | null>({\n        key: WebSocketBindingKeys.HANDSHAKE_HANDLER,\n      }) ?? undefined;\n\n    return {\n      redisConnection,\n      authenticateFn,\n      validateRoomFn,\n      clientConnectedFn,\n      clientDisconnectedFn,\n      messageHandler,\n      outboundTransformer,\n      handshakeFn,\n    };\n  }\n\n  private registerBunHook(opts: IResolvedBindings) {\n    const {\n      redisConnection,\n      authenticateFn,\n      validateRoomFn,\n      clientConnectedFn,\n      clientDisconnectedFn,\n      messageHandler,\n      outboundTransformer,\n      handshakeFn,\n    } = opts;\n    const serverOptions = this.serverOptions;\n\n    const logger = this.logger.for(this.registerBunHook.name);\n\n    this.application.registerPostStartHook({\n      identifier: 'websocket-initialize',\n      hook: async () => {\n        const serverInstance = this.application.getServerInstance<TBunServerInstance>();\n        const honoServer = this.application.getServer();\n\n        if (!serverInstance) {\n          throw getError({\n            message: '[WebSocketComponent] Bun server instance not available!',\n          });\n        }\n\n        const wsHelper = new WebSocketServerHelper({\n          identifier: serverOptions.identifier,\n          path: serverOptions.path,\n          defaultRooms: serverOptions.defaultRooms,\n          serverOptions: serverOptions.serverOptions,\n          heartbeatInterval: serverOptions.heartbeatInterval,\n          heartbeatTimeout: serverOptions.heartbeatTimeout,\n          server: serverInstance,\n          redisConnection,\n          authenticateFn,\n          validateRoomFn,\n          clientConnectedFn,\n          clientDisconnectedFn,\n          messageHandler,\n          outboundTransformer,\n          handshakeFn,\n          requireEncryption: serverOptions.requireEncryption,\n        });\n        await wsHelper.configure();\n\n        this.application.bind({ key: WebSocketBindingKeys.WEBSOCKET_INSTANCE }).toValue(wsHelper);\n\n        const wsPath = serverOptions.path ?? WebSocketDefaults.PATH;\n\n        serverInstance.reload({\n          fetch: createBunFetchHandler({ wsPath, honoServer }),\n          websocket: wsHelper.getBunWebSocketHandler(),\n        });\n\n        logger.info('WebSocket 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 WebSocketComponent',\n      });\n    }\n\n    logger.info('Binding WebSocket for application...');\n\n    const resolved = this.resolveBindings();\n    logger.debug('WebSocket Server Options: %j', this.serverOptions);\n\n    this.registerBunHook(resolved);\n  }\n}\n"]}
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../../src/components/websocket/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, type ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport {\n  type AbstractRedisHelper,\n  isRedisHelper,\n  type TWebSocketAuthenticateFn,\n  type TWebSocketClientConnectedFn,\n  type TWebSocketClientDisconnectedFn,\n  type TWebSocketMessageHandler,\n  type TWebSocketHandshakeFn,\n  type TWebSocketOutboundTransformer,\n  type TWebSocketValidateRoomFn,\n  WebSocketDefaults,\n  WebSocketServerHelper,\n} from '@venizia/ignis-helpers';\nimport {\n  WebSocketBindingKeys,\n  DEFAULT_SERVER_OPTIONS,\n  type IResolvedBindings,\n  type IServerOptions,\n} from './common';\nimport { WebSocketBunHandler } from './handlers';\n\nexport class WebSocketComponent extends BaseComponent {\n  protected serverOptions: IServerOptions;\n\n  constructor(\n    @inject({ key: CoreBindings.APPLICATION_INSTANCE }) private application: BaseApplication,\n  ) {\n    super({\n      scope: WebSocketComponent.name,\n      initDefault: { enable: true, container: application },\n      bindings: {\n        [WebSocketBindingKeys.SERVER_OPTIONS]: Binding.bind<Partial<IServerOptions>>({\n          key: WebSocketBindingKeys.SERVER_OPTIONS,\n        }).toValue(DEFAULT_SERVER_OPTIONS),\n\n        [WebSocketBindingKeys.REDIS_CONNECTION]: Binding.bind<AbstractRedisHelper | null>({\n          key: WebSocketBindingKeys.REDIS_CONNECTION,\n        }).toValue(null),\n\n        [WebSocketBindingKeys.AUTHENTICATE_HANDLER]: Binding.bind<TWebSocketAuthenticateFn | null>({\n          key: WebSocketBindingKeys.AUTHENTICATE_HANDLER,\n        }).toValue(null),\n\n        [WebSocketBindingKeys.VALIDATE_ROOM_HANDLER]: Binding.bind<TWebSocketValidateRoomFn | null>(\n          {\n            key: WebSocketBindingKeys.VALIDATE_ROOM_HANDLER,\n          },\n        ).toValue(null),\n\n        [WebSocketBindingKeys.CLIENT_CONNECTED_HANDLER]:\n          Binding.bind<TWebSocketClientConnectedFn | null>({\n            key: WebSocketBindingKeys.CLIENT_CONNECTED_HANDLER,\n          }).toValue(null),\n\n        [WebSocketBindingKeys.CLIENT_DISCONNECTED_HANDLER]:\n          Binding.bind<TWebSocketClientDisconnectedFn | null>({\n            key: WebSocketBindingKeys.CLIENT_DISCONNECTED_HANDLER,\n          }).toValue(null),\n\n        [WebSocketBindingKeys.MESSAGE_HANDLER]: Binding.bind<TWebSocketMessageHandler | null>({\n          key: WebSocketBindingKeys.MESSAGE_HANDLER,\n        }).toValue(null),\n\n        [WebSocketBindingKeys.OUTBOUND_TRANSFORMER]:\n          Binding.bind<TWebSocketOutboundTransformer | null>({\n            key: WebSocketBindingKeys.OUTBOUND_TRANSFORMER,\n          }).toValue(null),\n\n        [WebSocketBindingKeys.HANDSHAKE_HANDLER]: Binding.bind<TWebSocketHandshakeFn | null>({\n          key: WebSocketBindingKeys.HANDSHAKE_HANDLER,\n        }).toValue(null),\n      },\n    });\n  }\n\n  private resolveBindings(): IResolvedBindings {\n    const extraServerOptions =\n      this.application.get<Partial<IServerOptions>>({\n        key: WebSocketBindingKeys.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: WebSocketBindingKeys.REDIS_CONNECTION,\n    });\n    if (!isRedisHelper(redisConnection)) {\n      throw getError({\n        message:\n          '[WebSocketComponent][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<TWebSocketAuthenticateFn>({\n      key: WebSocketBindingKeys.AUTHENTICATE_HANDLER,\n    });\n    if (!authenticateFn) {\n      throw getError({\n        message: '[WebSocketComponent] Invalid authenticateFn to setup WebSocket server!',\n      });\n    }\n\n    const validateRoomFn =\n      this.application.get<TWebSocketValidateRoomFn | null>({\n        key: WebSocketBindingKeys.VALIDATE_ROOM_HANDLER,\n      }) ?? undefined;\n    const clientConnectedFn =\n      this.application.get<TWebSocketClientConnectedFn | null>({\n        key: WebSocketBindingKeys.CLIENT_CONNECTED_HANDLER,\n      }) ?? undefined;\n    const clientDisconnectedFn =\n      this.application.get<TWebSocketClientDisconnectedFn | null>({\n        key: WebSocketBindingKeys.CLIENT_DISCONNECTED_HANDLER,\n      }) ?? undefined;\n    const messageHandler =\n      this.application.get<TWebSocketMessageHandler | null>({\n        key: WebSocketBindingKeys.MESSAGE_HANDLER,\n      }) ?? undefined;\n    const outboundTransformer =\n      this.application.get<TWebSocketOutboundTransformer | null>({\n        key: WebSocketBindingKeys.OUTBOUND_TRANSFORMER,\n      }) ?? undefined;\n    const handshakeFn =\n      this.application.get<TWebSocketHandshakeFn | null>({\n        key: WebSocketBindingKeys.HANDSHAKE_HANDLER,\n      }) ?? undefined;\n\n    return {\n      redisConnection,\n      authenticateFn,\n      validateRoomFn,\n      clientConnectedFn,\n      clientDisconnectedFn,\n      messageHandler,\n      outboundTransformer,\n      handshakeFn,\n    };\n  }\n\n  private registerBunHook(opts: IResolvedBindings) {\n    const {\n      redisConnection,\n      authenticateFn,\n      validateRoomFn,\n      clientConnectedFn,\n      clientDisconnectedFn,\n      messageHandler,\n      outboundTransformer,\n      handshakeFn,\n    } = opts;\n    const serverOptions = this.serverOptions;\n\n    const logger = this.logger.for(this.registerBunHook.name);\n\n    this.application.registerPostStartHook({\n      identifier: 'websocket-initialize',\n      hook: async () => {\n        const serverInstance = this.application.getServerInstance<TBunServerInstance>();\n        const honoServer = this.application.getServer();\n\n        if (!serverInstance) {\n          throw getError({\n            message: '[WebSocketComponent] Bun server instance not available!',\n          });\n        }\n\n        const wsHelper = new WebSocketServerHelper({\n          identifier: serverOptions.identifier,\n          path: serverOptions.path,\n          defaultRooms: serverOptions.defaultRooms,\n          serverOptions: serverOptions.serverOptions,\n          heartbeatInterval: serverOptions.heartbeatInterval,\n          heartbeatTimeout: serverOptions.heartbeatTimeout,\n          server: serverInstance,\n          redisConnection,\n          authenticateFn,\n          validateRoomFn,\n          clientConnectedFn,\n          clientDisconnectedFn,\n          messageHandler,\n          outboundTransformer,\n          handshakeFn,\n          requireEncryption: serverOptions.requireEncryption,\n        });\n        await wsHelper.configure();\n\n        this.application.bind({ key: WebSocketBindingKeys.WEBSOCKET_INSTANCE }).toValue(wsHelper);\n\n        const wsPath = serverOptions.path ?? WebSocketDefaults.PATH;\n\n        serverInstance.reload({\n          fetch: WebSocketBunHandler.createFetchHandler({ wsPath, honoServer }),\n          websocket: wsHelper.getBunWebSocketHandler(),\n        });\n\n        logger.info('WebSocket 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 WebSocketComponent',\n      });\n    }\n\n    logger.info('Binding WebSocket for application...');\n\n    const resolved = this.resolveBindings();\n    logger.debug('WebSocket Server Options: %j', this.serverOptions);\n\n    this.registerBunHook(resolved);\n  }\n}\n"]}

package/dist/esm/components/websocket/handlers/bun.handler.d.ts

@@ -1,7 +1,9 @@
 import type { TBunServerInstance } from '../../../base/applications/index.js';
 import type { OpenAPIHono } from '@hono/zod-openapi';
-export declare function createBunFetchHandler(opts: {
-    wsPath: string;
-    honoServer: OpenAPIHono;
-}): (req: Request, server: TBunServerInstance) => Promise<Response | undefined>;
+export declare class WebSocketBunHandler {
+    static createFetchHandler(opts: {
+        wsPath: string;
+        honoServer: OpenAPIHono;
+    }): (req: Request, server: TBunServerInstance) => Promise<Response | undefined>;
+}
 //# sourceMappingURL=bun.handler.d.ts.map

package/dist/esm/components/websocket/handlers/bun.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bun.handler.d.ts","sourceRoot":"","sources":["../../../../../src/components/websocket/handlers/bun.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,CAAC;CACzB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAyB9E"}
+{"version":3,"file":"bun.handler.d.ts","sourceRoot":"","sources":["../../../../../src/components/websocket/handlers/bun.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,WAAW,CAAC;KACzB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;CA0BhF"}