@venizia/ignis-kernel 0.4.2 → 0.4.4

package/dist/cjs/base/middlewares/not-found/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./not-found.middleware"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/base/middlewares/not-found/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/not-found/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC","sourcesContent":["export * from './not-found.middleware';\n"]}

package/dist/cjs/base/middlewares/not-found/not-found.middleware.d.ts

@@ -1,6 +0,0 @@
-import type { ILogger } from '@venizia/ignis-helpers/core';
-import type { NotFoundHandler } from 'hono/types';
-export declare const notFoundHandler: (opts: {
-    logger?: ILogger;
-}) => NotFoundHandler;
-//# sourceMappingURL=not-found.middleware.d.ts.map

package/dist/cjs/base/middlewares/not-found/not-found.middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"not-found.middleware.d.ts","sourceRoot":"","sources":["../../../../../src/base/middlewares/not-found/not-found.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,eAAO,MAAM,eAAe,GAAI,MAAM;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,oBA6BzD,CAAC"}

package/dist/cjs/base/middlewares/not-found/not-found.middleware.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.notFoundHandler = void 0;
-const common_1 = require("@venizia/ignis-helpers/common");
-const common_2 = require("../common");
-const notFoundHandler = (opts) => {
-    const { logger = console } = opts;
-    const mw = async (context) => {
-        const requestId = context.get(common_2.REQUEST_ID_KEY);
-        // WARN, not ERROR: an unrouted path is the callers mistake, and this middleware is installed
-        // unconditionally - so scanner traffic filled the dedicated error log and tripped error-volume
-        // alerting. The same reasoning is already applied to an expired token elsewhere in the tree.
-        logger.warn('[%s] URL NOT FOUND | path: %s | url: %s', requestId, context.req.path, context.req.url);
-        return context.json({
-            message: 'URL NOT FOUND',
-            statusCode: common_1.HTTP.ResultCodes.RS_4.NotFound,
-            requestId,
-            path: context.req.path,
-            url: context.req.url,
-        }, common_1.HTTP.ResultCodes.RS_4.NotFound);
-    };
-    return mw;
-};
-exports.notFoundHandler = notFoundHandler;
-//# sourceMappingURL=not-found.middleware.js.map

package/dist/cjs/base/middlewares/not-found/not-found.middleware.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"not-found.middleware.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/not-found/not-found.middleware.ts"],"names":[],"mappings":";;;AACA,0DAAqD;AAErD,sCAA2C;AAEpC,MAAM,eAAe,GAAG,CAAC,IAA0B,EAAE,EAAE;IAC5D,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;IAElC,MAAM,EAAE,GAAoB,KAAK,EAAE,OAAO,EAAE,EAAE;QAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAc,CAAC,CAAC;QAE9C,6FAA6F;QAC7F,+FAA+F;QAC/F,6FAA6F;QAC7F,MAAM,CAAC,IAAI,CACT,yCAAyC,EACzC,SAAS,EACT,OAAO,CAAC,GAAG,CAAC,IAAI,EAChB,OAAO,CAAC,GAAG,CAAC,GAAG,CAChB,CAAC;QAEF,OAAO,OAAO,CAAC,IAAI,CACjB;YACE,OAAO,EAAE,eAAe;YACxB,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ;YAC1C,SAAS;YACT,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG;SACrB,EACD,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAC/B,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AA7BW,QAAA,eAAe,mBA6B1B","sourcesContent":["import type { ILogger } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport type { NotFoundHandler } from 'hono/types';\nimport { REQUEST_ID_KEY } from '../common';\n\nexport const notFoundHandler = (opts: { logger?: ILogger }) => {\n  const { logger = console } = opts;\n\n  const mw: NotFoundHandler = async (context) => {\n    const requestId = context.get(REQUEST_ID_KEY);\n\n    // WARN, not ERROR: an unrouted path is the callers mistake, and this middleware is installed\n    // unconditionally - so scanner traffic filled the dedicated error log and tripped error-volume\n    // alerting. The same reasoning is already applied to an expired token elsewhere in the tree.\n    logger.warn(\n      '[%s] URL NOT FOUND | path: %s | url: %s',\n      requestId,\n      context.req.path,\n      context.req.url,\n    );\n\n    return context.json(\n      {\n        message: 'URL NOT FOUND',\n        statusCode: HTTP.ResultCodes.RS_4.NotFound,\n        requestId,\n        path: context.req.path,\n        url: context.req.url,\n      },\n      HTTP.ResultCodes.RS_4.NotFound,\n    );\n  };\n\n  return mw;\n};\n"]}

package/dist/cjs/base/mixins/common/index.d.ts

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

package/dist/cjs/base/mixins/common/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/mixins/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/cjs/base/mixins/common/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./types"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/base/mixins/common/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/mixins/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB","sourcesContent":["export * from './types';\n"]}

package/dist/cjs/base/mixins/common/types.d.ts

@@ -1,54 +0,0 @@
-import type { Binding } from '../../../helpers/inversion';
-import type { TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';
-import type { IApplication, TArtifactIndexInput } from '../../applications';
-import type { BaseComponent } from '../../components';
-import type { BaseConfiguration } from '../../configurations';
-import type { IDataSource } from '../../datasources';
-import type { IRepository } from '../../repositories';
-import type { IService } from '../../services';
-/** Options of the registration itself, never of the artifact - what the artifact needs goes on its class. */
-export type TMixinOpts<Options extends object = {}> = {
-    binding?: {
-        namespace: string;
-        key: string;
-    };
-    /** Default true, matching `bind()`'s overwrite behavior; false makes a same-key re-registration throw. */
-    allowOverride?: boolean;
-    /** Options passed directly to `instance.configure(options)` during initialization. */
-    options?: Options;
-};
-export interface IConfigurationMixin {
-    configuration<Base extends BaseConfiguration<Options>, Options extends object = {}>(target: TClass<Base>, opts?: TMixinOpts<Options>): Binding<Base>;
-    registerConfigurations(): ValueOrPromise<void>;
-}
-export interface IComponentMixin {
-    component<Base extends BaseComponent<Options>, Options extends object = {}>(target: TClass<Base>, opts?: TMixinOpts<Options>): Binding<Base>;
-    registerComponents(): ValueOrPromise<void>;
-}
-export interface IServerConfigMixin {
-    staticConfigure(): ValueOrPromise<void>;
-    preConfigure(): ValueOrPromise<void>;
-    postConfigure(): ValueOrPromise<void>;
-    getApplicationVersion(): ValueOrPromise<string>;
-}
-export interface IControllerMixin {
-    controller<Base>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
-    registerControllers(): ValueOrPromise<void>;
-}
-export interface IRepositoryMixin {
-    dataSource<Base extends IDataSource<Options>, Options extends object = {}>(target: TClass<Base>, opts?: TMixinOpts<Options>): Binding<Base>;
-    repository<Base extends IRepository>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
-}
-export interface IServiceMixin {
-    service<Base extends IService>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
-}
-export interface IArtifactRegistrationMixin {
-    registerArtifacts(index: TArtifactIndexInput): Promise<void>;
-}
-export interface IStaticServeMixin {
-    static(opts: {
-        restPath?: string;
-        folderPath: string;
-    }): IApplication;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/cjs/base/mixins/common/types.d.ts.map

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

package/dist/cjs/base/mixins/common/types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/cjs/base/mixins/common/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/base/mixins/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Binding } from '@/helpers/inversion';\nimport type { TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport type { IApplication, TArtifactIndexInput } from '../../applications';\nimport type { BaseComponent } from '../../components';\nimport type { BaseConfiguration } from '../../configurations';\nimport type { IDataSource } from '../../datasources';\nimport type { IRepository } from '../../repositories';\nimport type { IService } from '../../services';\n/** Options of the registration itself, never of the artifact - what the artifact needs goes on its class. */\nexport type TMixinOpts<Options extends object = {}> = {\n  binding?: { namespace: string; key: string };\n  /** Default true, matching `bind()`'s overwrite behavior; false makes a same-key re-registration throw. */\n  allowOverride?: boolean;\n  /** Options passed directly to `instance.configure(options)` during initialization. */\n  options?: Options;\n};\n\nexport interface IConfigurationMixin {\n  configuration<Base extends BaseConfiguration<Options>, Options extends object = {}>(\n    target: TClass<Base>,\n    opts?: TMixinOpts<Options>,\n  ): Binding<Base>;\n  registerConfigurations(): ValueOrPromise<void>;\n}\n\nexport interface IComponentMixin {\n  component<Base extends BaseComponent<Options>, Options extends object = {}>(\n    target: TClass<Base>,\n    opts?: TMixinOpts<Options>,\n  ): Binding<Base>;\n  registerComponents(): ValueOrPromise<void>;\n}\n\nexport interface IServerConfigMixin {\n  staticConfigure(): ValueOrPromise<void>;\n  preConfigure(): ValueOrPromise<void>;\n  postConfigure(): ValueOrPromise<void>;\n  getApplicationVersion(): ValueOrPromise<string>;\n}\n\nexport interface IControllerMixin {\n  controller<Base>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;\n  registerControllers(): ValueOrPromise<void>;\n}\n\nexport interface IRepositoryMixin {\n  dataSource<Base extends IDataSource<Options>, Options extends object = {}>(\n    target: TClass<Base>,\n    opts?: TMixinOpts<Options>,\n  ): Binding<Base>;\n  repository<Base extends IRepository>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;\n}\nexport interface IServiceMixin {\n  service<Base extends IService>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;\n}\n\nexport interface IArtifactRegistrationMixin {\n  registerArtifacts(index: TArtifactIndexInput): Promise<void>;\n}\n\nexport interface IStaticServeMixin {\n  static(opts: { restPath?: string; folderPath: string }): IApplication;\n}\n"]}

package/dist/cjs/base/mixins/index.d.ts

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

package/dist/cjs/base/mixins/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/mixins/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/cjs/base/mixins/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./common"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/base/mixins/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/mixins/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB","sourcesContent":["export * from './common';\n"]}

package/dist/cjs/base/models/base.d.ts

@@ -1,19 +0,0 @@
-import { BaseHelper } from '@venizia/ignis-helpers/core';
-import type { TIdSchemaType, TSchemaType } from './common';
-/** Engine-neutral entity root: named, scoped-logged, zod-schema-capable. */
-export declare abstract class AbstractEntity<Schema = unknown> extends BaseHelper {
-    name: string;
-    constructor(opts: {
-        name: string;
-    });
-    abstract getSchema<T = Schema>(opts: {
-        type: TSchemaType;
-    }): T;
-    /** Path-param id shape for this entity - default 'string' (every document-family id, e.g. Typesense's). */
-    getIdType(): TIdSchemaType;
-    /** Keys the server fills on every write, which a generated create or update body leaves out. None here. */
-    getServerStampedKeys(): string[];
-    toObject(): this;
-    toJSON(): this;
-}
-//# sourceMappingURL=base.d.ts.map

package/dist/cjs/base/models/base.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/base/models/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3D,4EAA4E;AAC5E,8BAAsB,cAAc,CAAC,MAAM,GAAG,OAAO,CAAE,SAAQ,UAAU;IACvE,IAAI,EAAE,MAAM,CAAC;gBAED,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAKlC,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,CAAC;IAE9D,2GAA2G;IAC3G,SAAS,IAAI,aAAa;IAI1B,2GAA2G;IAC3G,oBAAoB,IAAI,MAAM,EAAE;IAIhC,QAAQ;IAIR,MAAM;CAGP"}

package/dist/cjs/base/models/base.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractEntity = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
-/** Engine-neutral entity root: named, scoped-logged, zod-schema-capable. */
-class AbstractEntity extends core_1.BaseHelper {
-    constructor(opts) {
-        super({ scope: opts.name });
-        this.name = opts.name;
-    }
-    /** Path-param id shape for this entity - default 'string' (every document-family id, e.g. Typesense's). */
-    getIdType() {
-        return 'string';
-    }
-    /** Keys the server fills on every write, which a generated create or update body leaves out. None here. */
-    getServerStampedKeys() {
-        return [];
-    }
-    toObject() {
-        return { ...this };
-    }
-    toJSON() {
-        return this.toObject();
-    }
-}
-exports.AbstractEntity = AbstractEntity;
-//# sourceMappingURL=base.js.map

package/dist/cjs/base/models/base.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/base/models/base.ts"],"names":[],"mappings":";;;AAAA,sDAAyD;AAGzD,4EAA4E;AAC5E,MAAsB,cAAiC,SAAQ,iBAAU;IAGvE,YAAY,IAAsB;QAChC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAID,2GAA2G;IAC3G,SAAS;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,2GAA2G;IAC3G,oBAAoB;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;CACF;AA3BD,wCA2BC","sourcesContent":["import { BaseHelper } from '@venizia/ignis-helpers/core';\nimport type { TIdSchemaType, TSchemaType } from './common';\n\n/** Engine-neutral entity root: named, scoped-logged, zod-schema-capable. */\nexport abstract class AbstractEntity<Schema = unknown> extends BaseHelper {\n  name: string;\n\n  constructor(opts: { name: string }) {\n    super({ scope: opts.name });\n    this.name = opts.name;\n  }\n\n  abstract getSchema<T = Schema>(opts: { type: TSchemaType }): T;\n\n  /** Path-param id shape for this entity - default 'string' (every document-family id, e.g. Typesense's). */\n  getIdType(): TIdSchemaType {\n    return 'string';\n  }\n\n  /** Keys the server fills on every write, which a generated create or update body leaves out. None here. */\n  getServerStampedKeys(): string[] {\n    return [];\n  }\n\n  toObject() {\n    return { ...this };\n  }\n\n  toJSON() {\n    return this.toObject();\n  }\n}\n"]}

package/dist/cjs/base/models/common/constants.d.ts

@@ -1,11 +0,0 @@
-import type { TConstValue } from '@venizia/ignis-helpers/common';
-export declare class SchemaTypes {
-    static readonly SELECT = "select";
-    static readonly UPDATE = "update";
-    static readonly CREATE = "create";
-    static readonly EXECUTE = "execute";
-    static readonly SCHEME_SET: Set<string>;
-    static isValid(input: string): input is TSchemaType;
-}
-export type TSchemaType = TConstValue<typeof SchemaTypes>;
-//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/base/models/common/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IAEpC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAkE;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/cjs/base/models/common/constants.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaTypes = void 0;
-class SchemaTypes {
-    static { this.SELECT = 'select'; }
-    static { this.UPDATE = 'update'; }
-    static { this.CREATE = 'create'; }
-    static { this.EXECUTE = 'execute'; }
-    static { this.SCHEME_SET = new Set([this.SELECT, this.UPDATE, this.CREATE, this.EXECUTE]); }
-    static isValid(input) {
-        return this.SCHEME_SET.has(input);
-    }
-}
-exports.SchemaTypes = SchemaTypes;
-//# sourceMappingURL=constants.js.map

package/dist/cjs/base/models/common/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/models/common/constants.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;aACN,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aAEpB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAVH,kCAWC","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers/common';\n\nexport class SchemaTypes {\n  static readonly SELECT = 'select';\n  static readonly UPDATE = 'update';\n  static readonly CREATE = 'create';\n  static readonly EXECUTE = 'execute';\n\n  static readonly SCHEME_SET = new Set([this.SELECT, this.UPDATE, this.CREATE, this.EXECUTE]);\n\n  static isValid(input: string): input is TSchemaType {\n    return this.SCHEME_SET.has(input);\n  }\n}\n\nexport type TSchemaType = TConstValue<typeof SchemaTypes>;\n"]}

package/dist/cjs/base/models/common/index.d.ts

@@ -1,5 +0,0 @@
-export * from './constants';
-export * from './schemas';
-export * from './types';
-export * from './utilities';
-//# sourceMappingURL=index.d.ts.map

package/dist/cjs/base/models/common/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/cjs/base/models/common/index.js

@@ -1,21 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./constants"), exports);
-__exportStar(require("./schemas"), exports);
-__exportStar(require("./types"), exports);
-__exportStar(require("./utilities"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/base/models/common/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/base/models/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4CAA0B;AAC1B,0CAAwB;AACxB,8CAA4B","sourcesContent":["export * from './constants';\nexport * from './schemas';\nexport * from './types';\nexport * from './utilities';\n"]}

package/dist/cjs/base/models/common/schemas.d.ts

@@ -1,160 +0,0 @@
-import { z } from '@hono/zod-openapi';
-import type { TIdSchemaType } from './types';
-/**
- * The error RESPONSE for OpenAPI docs - here, beside the REST layer that already needs `@hono/zod-openapi`.
- * Named, so every route's `4XX` and `5XX` reference one `ErrorResponse` component.
- */
-export declare const ErrorSchema: z.ZodObject<{
-    statusCode: z.ZodOptional<z.ZodNumber>;
-    message: z.ZodString;
-    normalized: z.ZodOptional<z.ZodObject<{
-        text: z.ZodString;
-        code: z.ZodString;
-        args: z.ZodRecord<z.ZodString, z.ZodAny>;
-    }, z.core.$strip>>;
-    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    requestId: z.ZodOptional<z.ZodString>;
-    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-}, z.core.$strip>;
-export type TErrorResponse = z.infer<typeof ErrorSchema>;
-export declare const idParamsSchema: (opts?: {
-    idType: TIdSchemaType;
-}) => z.ZodObject<{
-    id: z.ZodNumber;
-}, z.core.$strip> | z.ZodObject<{
-    id: z.ZodString;
-}, z.core.$strip>;
-export declare const jsonContent: <T extends z.ZodType>(opts: {
-    schema: T;
-    description: string;
-    required?: boolean;
-}) => {
-    description: string;
-    content: {
-        'application/json': {
-            schema: T;
-        };
-    };
-    required: boolean | undefined;
-};
-/** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */
-export declare const errorResponses: () => {
-    '4XX': {
-        description: string;
-        content: {
-            'application/json': {
-                schema: z.ZodObject<{
-                    statusCode: z.ZodOptional<z.ZodNumber>;
-                    message: z.ZodString;
-                    normalized: z.ZodOptional<z.ZodObject<{
-                        text: z.ZodString;
-                        code: z.ZodString;
-                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                    }, z.core.$strip>>;
-                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                    requestId: z.ZodOptional<z.ZodString>;
-                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                }, z.core.$strip>;
-            };
-        };
-        required: boolean | undefined;
-    };
-    '5XX': {
-        description: string;
-        content: {
-            'application/json': {
-                schema: z.ZodObject<{
-                    statusCode: z.ZodOptional<z.ZodNumber>;
-                    message: z.ZodString;
-                    normalized: z.ZodOptional<z.ZodObject<{
-                        text: z.ZodString;
-                        code: z.ZodString;
-                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                    }, z.core.$strip>>;
-                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                    requestId: z.ZodOptional<z.ZodString>;
-                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                }, z.core.$strip>;
-            };
-        };
-        required: boolean | undefined;
-    };
-};
-/** OpenAPI Header Object format */
-type THeaderObject = {
-    description?: string;
-    schema: {
-        type: string;
-        examples?: Array<string>;
-    };
-};
-/** Map of header names to Header Objects */
-type TResponseHeaders = Record<string, THeaderObject>;
-type TJsonResponseOpts<T extends z.ZodType, H extends TResponseHeaders | undefined> = {
-    schema: T;
-    description?: string;
-    required?: boolean;
-    headers?: H;
-};
-export declare const jsonResponse: <ContentSchema extends z.ZodType, HeaderSchema extends TResponseHeaders | undefined = undefined>(opts: TJsonResponseOpts<ContentSchema, HeaderSchema>) => {
-    '4XX': {
-        description: string;
-        content: {
-            'application/json': {
-                schema: z.ZodObject<{
-                    statusCode: z.ZodOptional<z.ZodNumber>;
-                    message: z.ZodString;
-                    normalized: z.ZodOptional<z.ZodObject<{
-                        text: z.ZodString;
-                        code: z.ZodString;
-                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                    }, z.core.$strip>>;
-                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                    requestId: z.ZodOptional<z.ZodString>;
-                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                }, z.core.$strip>;
-            };
-        };
-        required: boolean | undefined;
-    };
-    '5XX': {
-        description: string;
-        content: {
-            'application/json': {
-                schema: z.ZodObject<{
-                    statusCode: z.ZodOptional<z.ZodNumber>;
-                    message: z.ZodString;
-                    normalized: z.ZodOptional<z.ZodObject<{
-                        text: z.ZodString;
-                        code: z.ZodString;
-                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                    }, z.core.$strip>>;
-                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                    requestId: z.ZodOptional<z.ZodString>;
-                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                }, z.core.$strip>;
-            };
-        };
-        required: boolean | undefined;
-    };
-    200: {
-        description: string;
-        content: {
-            'application/json': {
-                schema: ContentSchema;
-            };
-        };
-        required: boolean | undefined;
-    } | {
-        headers: NonNullable<HeaderSchema>;
-        description: string;
-        content: {
-            'application/json': {
-                schema: ContentSchema;
-            };
-        };
-        required: boolean | undefined;
-    };
-};
-export {};
-//# sourceMappingURL=schemas.d.ts.map

package/dist/cjs/base/models/common/schemas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;iBA6BpB,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD,eAAO,MAAM,cAAc,GAAI,OAAO;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE;;;;iBAkC9D,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM;IACrD,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;;;;;;;;CAMA,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI1B,CAAC;AAEF,mCAAmC;AACnC,KAAK,aAAa,GAAG;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,4CAA4C;AAC5C,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEtD,KAAK,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,gBAAgB,GAAG,SAAS,IAAI;IACpF,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,aAAa,SAAS,CAAC,CAAC,OAAO,EAC/B,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,MAAM,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcrD,CAAC"}

package/dist/cjs/base/models/common/schemas.js

@@ -1,103 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.jsonResponse = exports.errorResponses = exports.jsonContent = exports.idParamsSchema = exports.ErrorSchema = void 0;
-const zod_openapi_1 = require("@hono/zod-openapi");
-const common_1 = require("@venizia/ignis-helpers/common");
-const core_1 = require("@venizia/ignis-helpers/core");
-/**
- * The error RESPONSE for OpenAPI docs - here, beside the REST layer that already needs `@hono/zod-openapi`.
- * Named, so every route's `4XX` and `5XX` reference one `ErrorResponse` component.
- */
-exports.ErrorSchema = zod_openapi_1.z
-    .object({
-    statusCode: zod_openapi_1.z.number().optional(),
-    message: zod_openapi_1.z.string(),
-    normalized: zod_openapi_1.z
-        .object({
-        text: zod_openapi_1.z.string(),
-        code: zod_openapi_1.z.string(),
-        args: zod_openapi_1.z.record(zod_openapi_1.z.string(), zod_openapi_1.z.any()),
-    })
-        .optional(),
-    extra: zod_openapi_1.z.record(zod_openapi_1.z.string(), zod_openapi_1.z.any()).optional(),
-    requestId: zod_openapi_1.z.string().optional(),
-    details: zod_openapi_1.z.record(zod_openapi_1.z.string(), zod_openapi_1.z.any()).optional(),
-})
-    .openapi('ErrorResponse', {
-    description: 'Error Schema',
-    example: {
-        statusCode: common_1.HTTP.ResultCodes.RS_4.Conflict,
-        message: 'A category named %{name} already exists.',
-        normalized: {
-            text: 'A category named %{name} already exists.',
-            code: 'server.commerce.category.create.duplicate_name',
-            args: { name: 'Ticket' },
-        },
-        extra: { categoryId: 42 },
-        requestId: 'abc-123-def',
-        details: { url: 'http://localhost:3000/categories', path: '/categories' },
-    },
-});
-const idParamsSchema = (opts) => {
-    const { idType = 'number' } = opts ?? {};
-    switch (idType) {
-        case 'number': {
-            return zod_openapi_1.z.object({
-                id: zod_openapi_1.z.number().openapi({
-                    param: {
-                        name: 'id',
-                        in: 'path',
-                        description: 'The unique id of the resource',
-                    },
-                    examples: [1, 2, 3],
-                }),
-            });
-        }
-        case 'string': {
-            return zod_openapi_1.z.object({
-                id: zod_openapi_1.z.string().openapi({
-                    param: {
-                        name: 'id',
-                        in: 'path',
-                        description: 'The unique id of the resource',
-                    },
-                    examples: ['4651e634-a530-4484-9b09-9616a28f35e3', 'some_unique_id'],
-                }),
-            });
-        }
-        default: {
-            throw (0, core_1.getError)({
-                message: `[idParamsSchema] Invalid input idType | valid: [string | number] | idType: ${idType}`,
-            });
-        }
-    }
-};
-exports.idParamsSchema = idParamsSchema;
-const jsonContent = (opts) => {
-    return {
-        description: opts.description,
-        content: { 'application/json': { schema: opts.schema } },
-        required: opts.required,
-    };
-};
-exports.jsonContent = jsonContent;
-/** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */
-const errorResponses = () => {
-    const errorResponse = (0, exports.jsonContent)({ description: 'Error Response', schema: exports.ErrorSchema });
-    return { '4XX': errorResponse, '5XX': errorResponse };
-};
-exports.errorResponses = errorResponses;
-const jsonResponse = (opts) => {
-    const baseResponse = (0, exports.jsonContent)({
-        required: opts.required,
-        description: opts.description ?? 'Success Response',
-        schema: opts.schema,
-    });
-    const successResponse = opts.headers ? { ...baseResponse, headers: opts.headers } : baseResponse;
-    return {
-        [common_1.HTTP.ResultCodes.RS_2.Ok]: successResponse,
-        ...(0, exports.errorResponses)(),
-    };
-};
-exports.jsonResponse = jsonResponse;
-//# sourceMappingURL=schemas.js.map

package/dist/cjs/base/models/common/schemas.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from '@hono/zod-openapi';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { TIdSchemaType } from './types';\n\n/**\n * The error RESPONSE for OpenAPI docs - here, beside the REST layer that already needs `@hono/zod-openapi`.\n * Named, so every route's `4XX` and `5XX` reference one `ErrorResponse` component.\n */\nexport const ErrorSchema = z\n  .object({\n    statusCode: z.number().optional(),\n    message: z.string(),\n    normalized: z\n      .object({\n        text: z.string(),\n        code: z.string(),\n        args: z.record(z.string(), z.any()),\n      })\n      .optional(),\n    extra: z.record(z.string(), z.any()).optional(),\n    requestId: z.string().optional(),\n    details: z.record(z.string(), z.any()).optional(),\n  })\n  .openapi('ErrorResponse', {\n    description: 'Error Schema',\n    example: {\n      statusCode: HTTP.ResultCodes.RS_4.Conflict,\n      message: 'A category named %{name} already exists.',\n      normalized: {\n        text: 'A category named %{name} already exists.',\n        code: 'server.commerce.category.create.duplicate_name',\n        args: { name: 'Ticket' },\n      },\n      extra: { categoryId: 42 },\n      requestId: 'abc-123-def',\n      details: { url: 'http://localhost:3000/categories', path: '/categories' },\n    },\n  });\n\nexport type TErrorResponse = z.infer<typeof ErrorSchema>;\n\nexport const idParamsSchema = (opts?: { idType: TIdSchemaType }) => {\n  const { idType = 'number' } = opts ?? {};\n\n  switch (idType) {\n    case 'number': {\n      return z.object({\n        id: z.number().openapi({\n          param: {\n            name: 'id',\n            in: 'path',\n            description: 'The unique id of the resource',\n          },\n          examples: [1, 2, 3],\n        }),\n      });\n    }\n    case 'string': {\n      return z.object({\n        id: z.string().openapi({\n          param: {\n            name: 'id',\n            in: 'path',\n            description: 'The unique id of the resource',\n          },\n          examples: ['4651e634-a530-4484-9b09-9616a28f35e3', 'some_unique_id'],\n        }),\n      });\n    }\n    default: {\n      throw getError({\n        message: `[idParamsSchema] Invalid input idType | valid: [string | number] | idType: ${idType}`,\n      });\n    }\n  }\n};\n\nexport const jsonContent = <T extends z.ZodType>(opts: {\n  schema: T;\n  description: string;\n  required?: boolean;\n}) => {\n  return {\n    description: opts.description,\n    content: { 'application/json': { schema: opts.schema } },\n    required: opts.required,\n  };\n};\n\n/** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */\nexport const errorResponses = () => {\n  const errorResponse = jsonContent({ description: 'Error Response', schema: ErrorSchema });\n\n  return { '4XX': errorResponse, '5XX': errorResponse };\n};\n\n/** OpenAPI Header Object format */\ntype THeaderObject = {\n  description?: string;\n  schema: { type: string; examples?: Array<string> };\n};\n\n/** Map of header names to Header Objects */\ntype TResponseHeaders = Record<string, THeaderObject>;\n\ntype TJsonResponseOpts<T extends z.ZodType, H extends TResponseHeaders | undefined> = {\n  schema: T;\n  description?: string;\n  required?: boolean;\n  headers?: H;\n};\n\nexport const jsonResponse = <\n  ContentSchema extends z.ZodType,\n  HeaderSchema extends TResponseHeaders | undefined = undefined,\n>(\n  opts: TJsonResponseOpts<ContentSchema, HeaderSchema>,\n) => {\n  const baseResponse = jsonContent({\n    required: opts.required,\n    description: opts.description ?? 'Success Response',\n    schema: opts.schema,\n  });\n\n  const successResponse = opts.headers ? { ...baseResponse, headers: opts.headers } : baseResponse;\n\n  return {\n    [HTTP.ResultCodes.RS_2.Ok]: successResponse,\n    ...errorResponses(),\n  };\n};\n"]}