@venizia/ignis 0.4.2 → 0.4.4

package/dist/esm/components/static-asset/controller/base.definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.definition.js","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/base.definition.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IAuthRouteConfig } from '@/base';\nimport { errorResponses, jsonResponse } from '@venizia/ignis-kernel';\nimport { z } from '@hono/zod-openapi';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { MetaLinkRecreateActions } from '../common/constants';\n\ntype TRouteRequest = NonNullable<IAuthRouteConfig['request']>;\n\n/** The labels both upload paths take. They ride the BODY, not the URL - an identifier in a query string lands in every access log between the client and here. */\nconst uploadLabels = () => ({\n  principalType: z.string().optional(),\n  principalId: z.string().or(z.number()).optional(),\n  variant: z.string().optional(),\n  sequence: z.coerce.number().int().optional(),\n});\n\nconst MultipartBodySchema = z.object({\n  files: z.union([z.instanceof(File), z.array(z.instanceof(File))]).openapi({\n    type: 'array',\n    items: {\n      type: 'string',\n      format: 'binary',\n    },\n  }),\n  ...uploadLabels(),\n  folderPath: z.string().optional().openapi({\n    description: 'Target folder path for uploaded files (e.g., \"photos/2024\")',\n    example: 'photos/2024',\n  }),\n});\n\nconst bucketNameParam = () =>\n  z.string().openapi({\n    param: {\n      name: 'bucketName',\n      in: 'path',\n    },\n    example: 'images',\n  });\n\nconst objectNameParam = () =>\n  z.string().openapi({\n    param: {\n      name: 'objectName',\n      in: 'path',\n      description: 'Object name or path (e.g., \"photo.jpg\" or \"photos/2024/photo.jpg\")',\n    },\n    example: 'photos/2024/photo.jpg',\n  });\n\nconst fileStreamResponses = (): IAuthRouteConfig['responses'] => ({\n  [HTTP.ResultCodes.RS_2.Ok]: {\n    description: 'File stream response',\n    content: {\n      'application/octet-stream': {\n        schema: {\n          type: 'string',\n          format: 'binary',\n        },\n      },\n    },\n  },\n  ...errorResponses(),\n});\n\n/** The ten built-in asset routes. Only `path` and `request.params` differ between option combinations. */\nexport interface IAssetDefinitions {\n  GET_BUCKETS: IAuthRouteConfig;\n  GET_BUCKET_BY_NAME: IAuthRouteConfig;\n  CREATE_BUCKET: IAuthRouteConfig;\n  DELETE_BUCKET: IAuthRouteConfig;\n  GET_OBJECT_BY_NAME: IAuthRouteConfig;\n  DOWNLOAD_OBJECT_BY_NAME: IAuthRouteConfig;\n  UPLOAD_POLICY: IAuthRouteConfig;\n  UPLOAD_COMMIT: IAuthRouteConfig;\n  UPLOAD: IAuthRouteConfig;\n  DELETE_OBJECT: IAuthRouteConfig;\n  LIST_OBJECTS: IAuthRouteConfig;\n  RECREATE_METALINK: IAuthRouteConfig;\n}\n\n/**\n * Builds the route configs of one asset controller.\n * `hasConfiguredBucket` drops `/buckets/{bucketName}` and its param from every object route.\n * `rawObjectPath` appends the `{.+}` catch-all, the spelling `@hono/zod-openapi` translates.\n */\nexport const buildAssetDefinitions = (opts: {\n  hasConfiguredBucket?: boolean;\n  rawObjectPath?: boolean;\n}): IAssetDefinitions => {\n  const { hasConfiguredBucket = false, rawObjectPath = false } = opts;\n\n  const bucketPrefix = hasConfiguredBucket ? '' : '/buckets/{bucketName}';\n\n  // `{objectName}` is ONE segment: a folder path travels percent-encoded (`photos%2F2024%2Ff.jpg`).\n  // The catch-all also matches a RAW nested path; the encoded form keeps working either way.\n  const objectSegment = rawObjectPath ? '{objectName}{.+}' : '{objectName}';\n\n  // A configured bucket is never in the URL, so a route whose only param was `bucketName` carries none.\n  const bucketRequest = (): Pick<TRouteRequest, 'params'> =>\n    hasConfiguredBucket ? {} : { params: z.object({ bucketName: bucketNameParam() }) };\n\n  const objectRequest = (): TRouteRequest => ({\n    params: hasConfiguredBucket\n      ? z.object({ objectName: objectNameParam() })\n      : z.object({ bucketName: bucketNameParam(), objectName: objectNameParam() }),\n  });\n\n  return {\n    GET_BUCKETS: {\n      method: 'get',\n      path: '/buckets',\n      responses: jsonResponse({\n        schema: z.array(\n          z.object({\n            name: z.string(),\n            creationDate: z.iso.datetime(),\n          }),\n        ),\n      }),\n    },\n    GET_BUCKET_BY_NAME: {\n      method: 'get',\n      path: bucketPrefix,\n      request: {\n        params: z.object({ bucketName: bucketNameParam() }),\n      },\n      responses: jsonResponse({\n        schema: z\n          .object({\n            name: z.string(),\n            creationDate: z.iso.datetime(),\n          })\n          .nullable(),\n      }),\n    },\n    CREATE_BUCKET: {\n      method: 'post',\n      path: bucketPrefix,\n      request: {\n        params: z.object({ bucketName: bucketNameParam() }),\n      },\n      responses: jsonResponse({\n        schema: z\n          .object({\n            name: z.string(),\n            creationDate: z.iso.datetime(),\n          })\n          .nullable(),\n      }),\n    },\n    DELETE_BUCKET: {\n      method: 'delete',\n      path: bucketPrefix,\n      request: {\n        params: z.object({ bucketName: bucketNameParam() }),\n      },\n      responses: jsonResponse({\n        schema: z.object({\n          isDeleted: z.boolean(),\n        }),\n      }),\n    },\n    GET_OBJECT_BY_NAME: {\n      method: 'get',\n      path: `${bucketPrefix}/objects/${objectSegment}`,\n      request: objectRequest(),\n      responses: fileStreamResponses(),\n    },\n    DOWNLOAD_OBJECT_BY_NAME: {\n      method: 'get',\n      path: `${bucketPrefix}/download/${objectSegment}`,\n      request: objectRequest(),\n      responses: fileStreamResponses(),\n    },\n    UPLOAD_POLICY: {\n      method: 'post',\n      path: `${bucketPrefix}/upload-policy`,\n      request: {\n        body: {\n          content: {\n            'application/json': {\n              schema: z.object({\n                files: z.array(\n                  z.object({\n                    fileName: z.string().min(1),\n                    contentType: z.string().optional(),\n                    size: z.number().int().nonnegative().optional(),\n                  }),\n                ),\n              }),\n            },\n          },\n        },\n      },\n      responses: jsonResponse({\n        schema: z.array(\n          z.object({\n            postURL: z.string(),\n            formData: z.record(z.string(), z.string()),\n            objectName: z.string(),\n            commitToken: z.string(),\n            expiresAt: z.string(),\n          }),\n        ),\n        description: 'One signed POST policy per file, plus the token its commit is claimed with',\n      }),\n    },\n    UPLOAD_COMMIT: {\n      method: 'post',\n      path: `${bucketPrefix}/upload-commit`,\n      request: {\n        body: {\n          content: {\n            'application/json': {\n              // The labels sit beside the token, not inside it: the token is an HMAC over\n              // { bucket, key, expiresAt } and deliberately carries no business fields.\n              schema: z.object({ commitToken: z.string().min(1), ...uploadLabels() }),\n            },\n          },\n        },\n      },\n      responses: jsonResponse({\n        schema: z.object({\n          bucket: z.object({ name: z.string() }),\n          object: z.object({ key: z.string() }),\n          link: z.string(),\n          metaLink: z\n            .union([z.object({ data: z.any() }), z.object({ error: z.string() })])\n            .optional(),\n        }),\n        description: 'The object at its final key, copied out of the pending prefix',\n      }),\n    },\n    UPLOAD: {\n      method: 'post',\n      path: `${bucketPrefix}/objects`,\n      request: {\n        ...bucketRequest(),\n        body: {\n          content: {\n            'multipart/form-data': {\n              schema: MultipartBodySchema,\n            },\n          },\n        },\n      },\n      responses: jsonResponse({\n        schema: z.array(\n          z.object({\n            bucket: z.object({ name: z.string() }),\n            object: z.object({\n              key: z.string(),\n              size: z.number(),\n              contentType: z.string(),\n            }),\n            link: z.string(),\n            metaLink: z\n              .union([z.object({ data: z.any() }), z.object({ error: z.string() })])\n              .optional(),\n          }),\n        ),\n      }),\n    },\n    DELETE_OBJECT: {\n      method: 'delete',\n      path: `${bucketPrefix}/objects/${objectSegment}`,\n      request: objectRequest(),\n      responses: jsonResponse({\n        schema: z.object({\n          success: z.boolean(),\n        }),\n      }),\n    },\n    LIST_OBJECTS: {\n      method: 'get',\n      path: `${bucketPrefix}/objects`,\n      request: {\n        ...bucketRequest(),\n        query: z.object({\n          prefix: z\n            .string()\n            .optional()\n            .openapi({\n              param: {\n                name: 'prefix',\n                in: 'query',\n                description: 'Filter objects by prefix',\n              },\n              example: 'folder/',\n            }),\n          recursive: z\n            .string()\n            .optional()\n            .openapi({\n              param: {\n                name: 'recursive',\n                in: 'query',\n                description: 'Recursive listing',\n              },\n              example: 'true',\n            }),\n          maxKeys: z\n            .string()\n            .optional()\n            .openapi({\n              param: {\n                name: 'maxKeys',\n                in: 'query',\n                description: 'Maximum number of objects to return',\n              },\n              example: '100',\n            }),\n        }),\n      },\n      responses: jsonResponse({\n        schema: z.array(\n          z.object({\n            name: z.string().optional(),\n            size: z.number().optional(),\n            lastModified: z.iso.datetime().optional(),\n            etag: z.string().optional(),\n            prefix: z.string().optional(),\n          }),\n        ),\n      }),\n    },\n    RECREATE_METALINK: {\n      method: 'put',\n      path: `${bucketPrefix}/meta-links/${objectSegment}`,\n      request: objectRequest(),\n      responses: jsonResponse({\n        schema: z.object({\n          success: z.boolean(),\n          action: z\n            .enum([MetaLinkRecreateActions.REFRESHED, MetaLinkRecreateActions.CREATED])\n            .openapi({\n              description: '`refreshed` when rows for the object existed, `created` when none did',\n              example: 'refreshed',\n            }),\n          count: z.number().openapi({ description: 'Rows refreshed or created' }),\n          metaLink: z.any().optional().openapi({ description: 'The first of `metaLinks`' }),\n          metaLinks: z.array(z.any()),\n        }),\n      }),\n    },\n  };\n};\n\n/** The bucket-in-path shape, unchanged - every existing importer keeps working. */\nexport const StaticAssetDefinitions = buildAssetDefinitions({});\n"]}

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

@@ -0,0 +1,203 @@
+import { type TRouteContext } from '../../../base/controllers/index.js';
+import { type IObjectLocation, type IObjectRef, type IStorageHelper } from '@venizia/ignis-helpers';
+import { type ValueOrPromise } from '@venizia/ignis-helpers/common';
+import type { AnyType } from '@venizia/ignis-helpers/common';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import { type Env } from 'hono';
+import { type TDefineExtraRoutes, type TMetaLinkConfig, type TObjectNameResolver, type TStaticAssetExtraOptions, type TStaticAssetsComponentOptions, type TStaticAssetStorageType } from '../common/index.js';
+export interface IAssetControllerOptions {
+    controller: TStaticAssetsComponentOptions[string]['controller'];
+    storage: TStaticAssetStorageType;
+    helper: IStorageHelper;
+    useMetaLink?: boolean;
+    /** The table is erased at this seam on purpose. The public option types carry the real `Schema` and check it; inside the controller every read and write is on MetaLink COLUMNS, and threading a table type nobody here constrains through 700 lines of handler buys nothing. */
+    metaLink?: TMetaLinkConfig<AnyType>;
+    options?: TStaticAssetExtraOptions;
+    /** Decides the stored object name of each uploaded file. Absent leaves the storage helper's own naming untouched. */
+    resolveObjectName?: TObjectNameResolver;
+    /** Registers the application's own routes on the generated controller, after every built-in one. */
+    /** Registers the application's own routes BEFORE every built-in one, so a literal path wins over the catch-all `rawObjectPath` produces. */
+    defineRoutesBefore?: TDefineExtraRoutes;
+    defineExtraRoutes?: TDefineExtraRoutes;
+}
+/** Hono ALREADY percent-decodes path params - a second decodeURIComponent throws on `report_100%.pdf` and turns `a%2Fb.png` into a DIFFERENT object; `isValidName`/`isValidPath` still run on this value, so traversal is still rejected. */
+/** The upload labels, read off the multipart form. Every value arrives as text, so `sequence` is the one that needs converting. */
+/** One list: the reader below and the stale-caller warning must agree. */
+declare const UPLOAD_LABEL_NAMES: readonly ["principalType", "principalId", "variant", "sequence", "folderPath"];
+/** Names any label a caller put in the query - where the upload routes refuse it. */
+export declare const findLabelsInQuery: (opts: {
+    query: Record<string, string>;
+    names?: ReadonlyArray<(typeof UPLOAD_LABEL_NAMES)[number]>;
+}) => string[];
+/** The URL of one object, in the shape its controller serves: no `/buckets/<name>` with a configured bucket, and a raw path with `rawObjectPath`. */
+export declare const buildObjectLink: (opts: IObjectLocation & {
+    basePath: string;
+    hasConfiguredBucket?: boolean;
+    rawObjectPath?: boolean;
+}) => string;
+/**
+ * The served type comes from the object NAME, never the backend or the uploader: a renderable type on
+ * the API origin is stored XSS. Exported so a hand-written route makes the same decision - the
+ * backend's own content-type is dropped by `WHITELIST_HEADERS`.
+ */
+export declare const resolveServedContentType: (opts: {
+    helper: IStorageHelper;
+    object: IObjectRef;
+}) => {
+    contentType: string;
+    isRenderable: boolean;
+};
+export declare class AssetControllerFactory extends BaseHelper {
+    constructor();
+    static defineAssetController(opts: IAssetControllerOptions): {
+        new (): {
+            /** Clears the multipart spool files written by `parseMultipartBody({ storage: 'disk' })`. */
+            removeSpoolFiles(spoolOptions: {
+                paths: string[];
+            }): void;
+            binding(): ValueOrPromise<void>;
+            measure<R>(opts: {
+                scope: string;
+                args: unknown;
+                task: () => Promise<R>;
+            }): Promise<any>;
+            normalizeCountData<ResponseSchema extends unknown, RequestContext extends TRouteContext<Env> = TRouteContext<Env>, ResponseData extends {
+                count: number;
+                data?: import("@venizia/ignis-helpers").TNullable<ResponseSchema>;
+            } = {
+                count: number;
+                data?: import("@venizia/ignis-helpers").TNullable<ResponseSchema>;
+            }>(opts: {
+                context: RequestContext;
+                payload: ResponseData;
+            }): ResponseData | import("@venizia/ignis-helpers").TNullable<ResponseSchema>;
+            getRequestedExtras(opts: {
+                context: TRouteContext<Env>;
+            }): Array<import("@venizia/ignis-kernel").IRequestedExtra>;
+            respond<R>(opts: {
+                context: TRouteContext<Env>;
+                format: import("@venizia/ignis-kernel").TResponseFormat;
+                payload: {
+                    count: number;
+                    data?: import("@venizia/ignis-helpers").TNullable<R>;
+                };
+                range?: import("@venizia/ignis-kernel").TDataRange;
+                extra?: never;
+            }): R | {
+                count: number;
+                data?: import("@venizia/ignis-helpers").TNullable<R>;
+            } | null | undefined;
+            respond<R, Extra extends Record<string, import("@venizia/ignis-kernel").TResponseExtra>>(opts: {
+                context: TRouteContext<Env>;
+                format: import("@venizia/ignis-kernel").TResponseFormat;
+                payload: {
+                    count: number;
+                    data?: import("@venizia/ignis-helpers").TNullable<R>;
+                };
+                range?: import("@venizia/ignis-kernel").TDataRange;
+                extra: Extra;
+            }): Promise<R | {
+                count: number;
+                data?: import("@venizia/ignis-helpers").TNullable<R>;
+            } | {
+                count?: number;
+                data?: import("@venizia/ignis-helpers").TNullable<R>;
+                extra: Partial<Record<keyof Extra, unknown>>;
+            } | null | undefined>;
+            respond<R>(opts: {
+                context: TRouteContext<Env>;
+                format: import("@venizia/ignis-kernel").TResponseFormat;
+                payload: {
+                    count: number;
+                    data?: import("@venizia/ignis-helpers").TNullable<R>;
+                };
+                range?: import("@venizia/ignis-kernel").TDataRange;
+                extra?: Record<string, import("@venizia/ignis-kernel").TResponseExtra>;
+            }): ValueOrPromise<R | {
+                count?: number;
+                data?: import("@venizia/ignis-helpers").TNullable<R>;
+                extra?: Record<string, unknown>;
+            } | null | undefined>;
+            respondWithExtra<R>(opts: {
+                context: TRouteContext<Env>;
+                payload: {
+                    count: number;
+                    data?: import("@venizia/ignis-helpers").TNullable<R>;
+                };
+                extra: Record<string, import("@venizia/ignis-kernel").TResponseExtra>;
+            }): Promise<R | {
+                count: number;
+                data?: import("@venizia/ignis-helpers").TNullable<R>;
+            } | {
+                count: number;
+                data: import("@venizia/ignis-helpers").TNullable<R>;
+                extra: Record<string, unknown>;
+            } | {
+                data: import("@venizia/ignis-helpers").TNullable<R>;
+                extra: Record<string, unknown>;
+                count?: undefined;
+            } | null | undefined>;
+            setListHeaders(opts: {
+                context: TRouteContext<Env>;
+                count: number;
+            } & ({
+                range: import("@venizia/ignis-kernel").TDataRange;
+            } | {
+                offset: number;
+                total: number;
+            })): void;
+            toHonoHandler<ResponseType = unknown>(opts: {
+                handler: import("@venizia/ignis-kernel").TRouteHandler<ResponseType, Env>;
+            }): import("hono").Handler<Env, string, import("hono").Input, (Response | Promise<Response>) | (import("@hono/zod-openapi").RouteConfigToTypedResponse<import("@hono/zod-openapi").RouteConfig> | Promise<import("@hono/zod-openapi").RouteConfigToTypedResponse<import("@hono/zod-openapi").RouteConfig>>)>;
+            bindRoute<RouteConfig extends import("@venizia/ignis-kernel").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): import("@venizia/ignis-kernel").IBindRouteOptions<RouteConfig, Env, {}, "/">;
+            defineRoute<RouteConfig extends import("@venizia/ignis-kernel").IAuthRouteConfig, ResponseType = unknown>(opts: {
+                configs: RouteConfig;
+                handler: import("@venizia/ignis-kernel").TRouteHandler<ResponseType, Env>;
+                hook?: import("@hono/zod-openapi").Hook<any, Env, string, any> | undefined;
+            }): import("@venizia/ignis-kernel").IDefineRouteOptions<RouteConfig, Env, {}, "/">;
+            defineJSXRoute<RouteConfig extends import("@venizia/ignis-kernel").IAuthRouteConfig, ResponseType = unknown>(opts: {
+                configs: RouteConfig;
+                handler: import("@venizia/ignis-kernel").TRouteHandler<ResponseType, Env>;
+                hook?: import("@hono/zod-openapi").Hook<any, Env, string, any> | undefined;
+            }): import("@venizia/ignis-kernel").IDefineRouteOptions<RouteConfig, Env, {}, "/">;
+            isConfigured: boolean;
+            router: import("@hono/zod-openapi").OpenAPIHono<Env, {}, "/">;
+            path: string;
+            definitions: Record<string, import("@venizia/ignis-kernel").IAuthRouteConfig>;
+            getRouter(): import("@hono/zod-openapi").OpenAPIHono<Env, {}, "/">;
+            registerRoutesFromRegistry(opts?: {
+                paths?: import("@venizia/ignis-kernel").TRoutePathScope;
+            }): void;
+            configure(opts?: {} | undefined): Promise<import("@hono/zod-openapi").OpenAPIHono<Env, {}, "/">>;
+            buildRouteMiddlewares<RouteConfig extends import("@venizia/ignis-kernel").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): {
+                restConfig: Omit<RouteConfig, "authenticate" | "authorize">;
+                security: {
+                    [x: string]: never[];
+                }[];
+                mws: import("hono").MiddlewareHandler<Env>[];
+            };
+            getRouteConfigs<RouteConfig extends import("@venizia/ignis-kernel").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): RouteConfig & {
+                getRoutingPath(): RouteConfig["path"] extends infer T ? T extends RouteConfig["path"] ? T extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start_1}/{${infer Param_1}}${infer Rest_1}` ? `${Start_1}/:${Param_1}${Rest_1 extends `${infer Start_2}/{${infer Param_2}}${infer Rest_2}` ? `${Start_2}/:${Param_2}${Rest_2 extends `${infer Start_3}/{${infer Param_3}}${infer Rest_3}` ? `${Start_3}/:${Param_3}${Rest_3 extends `${infer Start_4}/{${infer Param_4}}${infer Rest_4}` ? `${Start_4}/:${Param_4}${Rest_4 extends `${infer Start_5}/{${infer Param_5}}${infer Rest_5}` ? `${Start_5}/:${Param_5}${Rest_5 extends `${infer Start_6}/{${infer Param_6}}${infer Rest_6}` ? `${Start_6}/:${Param_6}${Rest_6 extends `${infer Start_7}/{${infer Param_7}}${infer Rest_7}` ? `${Start_7}/:${Param_7}${Rest_7 extends `${infer Start_8}/{${infer Param_8}}${infer Rest_8}` ? `${Start_8}/:${Param_8}${Rest_8 extends `${infer Start_9}/{${infer Param_9}}${infer Rest_9}` ? `${Start_9}/:${Param_9}${Rest_9 extends `${infer Start_10}/{${infer Param_10}}${infer Rest_10}` ? `${Start_10}/:${Param_10}${any}` : Rest_9}` : Rest_8}` : Rest_7}` : Rest_6}` : Rest_5}` : Rest_4}` : Rest_3}` : Rest_2}` : Rest_1}` : Rest}` : T : never : never;
+            };
+            getJSXRouteConfigs<RouteConfig extends import("@venizia/ignis-kernel").IAuthRouteConfig>(opts: {
+                configs: RouteConfig;
+            }): RouteConfig & {
+                getRoutingPath(): RouteConfig["path"] extends infer T ? T extends RouteConfig["path"] ? T extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${Rest extends `${infer Start_1}/{${infer Param_1}}${infer Rest_1}` ? `${Start_1}/:${Param_1}${Rest_1 extends `${infer Start_2}/{${infer Param_2}}${infer Rest_2}` ? `${Start_2}/:${Param_2}${Rest_2 extends `${infer Start_3}/{${infer Param_3}}${infer Rest_3}` ? `${Start_3}/:${Param_3}${Rest_3 extends `${infer Start_4}/{${infer Param_4}}${infer Rest_4}` ? `${Start_4}/:${Param_4}${Rest_4 extends `${infer Start_5}/{${infer Param_5}}${infer Rest_5}` ? `${Start_5}/:${Param_5}${Rest_5 extends `${infer Start_6}/{${infer Param_6}}${infer Rest_6}` ? `${Start_6}/:${Param_6}${Rest_6 extends `${infer Start_7}/{${infer Param_7}}${infer Rest_7}` ? `${Start_7}/:${Param_7}${Rest_7 extends `${infer Start_8}/{${infer Param_8}}${infer Rest_8}` ? `${Start_8}/:${Param_8}${Rest_8 extends `${infer Start_9}/{${infer Param_9}}${infer Rest_9}` ? `${Start_9}/:${Param_9}${Rest_9 extends `${infer Start_10}/{${infer Param_10}}${infer Rest_10}` ? `${Start_10}/:${Param_10}${any}` : Rest_9}` : Rest_8}` : Rest_7}` : Rest_6}` : Rest_5}` : Rest_4}` : Rest_3}` : Rest_2}` : Rest_1}` : Rest}` : T : never : never;
+            };
+            scope: string;
+            identifier: string;
+            get logger(): import("@venizia/ignis-helpers").ILogger;
+            set logger(value: import("@venizia/ignis-helpers").ILogger);
+            getIdentifier(): string;
+            getLogger(): import("@venizia/ignis-helpers").ILogger;
+        };
+    };
+}
+export {};
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/components/static-asset/controller/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EAGL,KAAK,eAAe,EAEpB,KAAK,UAAU,EAEf,KAAK,cAAc,EAMpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,KAAK,EAAE,OAAO,EAAyB,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,UAAU,EAAwB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC,OAAO,EAIL,KAAK,kBAAkB,EAEvB,KAAK,eAAe,EAKpB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAG7B,MAAM,WAAW,CAAC;AAYnB,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAChE,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iRAAiR;IACjR,QAAQ,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,wBAAwB,CAAC;IAEnC,qHAAqH;IACrH,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;IAExC,oGAAoG;IACpG,4IAA4I;IAC5I,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAED,6OAA6O;AAC7O,mIAAmI;AACnI,0EAA0E;AAC1E,QAAA,MAAM,kBAAkB,gFAMd,CAAC;AAEX,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,GAAI,MAAM;IACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5D,KAAG,MAAM,EAAyF,CAAC;AA8DpG,qJAAqJ;AACrJ,eAAO,MAAM,eAAe,GAC1B,MAAM,eAAe,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,KACA,MAQF,CAAC;AAcF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAC7C,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB,KAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAS/C,CAAC;AAyDF,qBAAa,sBAAuB,SAAQ,UAAU;;IAKpD,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,uBAAuB;;YAwDtD,6FAA6F;2CAC9D;gBAAE,KAAK,EAAE,MAAM,EAAE,CAAA;aAAE,GAAG,IAAI;uBAYrC,cAAc,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBArRrB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsmCzB"}