@venizia/ignis 0.1.1 → 0.2.0-0

package/dist/base/controllers/rest/abstract.js

@@ -1,142 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractRestController = void 0;
-const constants_1 = require("../../../components/auth/authenticate/common/constants");
-const authenticate_middleware_1 = require("../../../components/auth/authenticate/middlewares/authenticate.middleware");
-const authorize_middleware_1 = require("../../../components/auth/authorize/middlewares/authorize.middleware");
-const common_1 = require("../../../base/metadata/routes/common");
-const registry_1 = require("../../../helpers/inversion/registry");
-const jsx_utility_1 = require("../../../utilities/jsx.utility");
-const zod_openapi_1 = require("@hono/zod-openapi");
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-/** True for a route path carrying a path parameter, in either supported syntax: `/{id}` or `/:id`. */
-const hasPathParam = (opts) => {
-    return /\{[^}]+\}|:[^/]+/.test(opts.path);
-};
-/** Abstract base class for all REST controllers, providing route registration and auth middleware integration. */
-class AbstractRestController extends ignis_helpers_1.BaseHelper {
-    constructor(opts) {
-        super(opts);
-        this.isConfigured = false;
-        const { isStrict = true } = opts;
-        const decoratorMetadata = registry_1.MetadataRegistry.getInstance().getControllerMetadata({
-            target: new.target,
-        });
-        const resolvedPath = decoratorMetadata?.path ?? opts.path;
-        if (!resolvedPath) {
-            throw (0, ignis_helpers_1.getError)({
-                message: `[${new.target.name}] Controller path is required. Provide path via @controller decorator or constructor options.`,
-            });
-        }
-        this.path = resolvedPath;
-        this.router = new zod_openapi_1.OpenAPIHono({
-            strict: isStrict,
-            defaultHook: (result, _context) => {
-                if (!result.success) {
-                    throw result.error;
-                }
-            },
-        });
-    }
-    /** Returns the OpenAPIHono router instance for this controller. */
-    getRouter() {
-        return this.router;
-    }
-    /** Registers decorator-defined routes from the metadata registry; `paths` selects them by shape - see the two-phase call in {@link configure}. */
-    registerRoutesFromRegistry(opts) {
-        const { paths = 'all' } = opts ?? {};
-        const logger = this.logger.for(this.registerRoutesFromRegistry.name);
-        (0, common_1.reportDroppedRouteDecorators)({ logger });
-        const routes = registry_1.MetadataRegistry.getInstance().getRoutes({
-            target: Object.getPrototypeOf(this),
-        });
-        if (!routes?.size) {
-            return;
-        }
-        const routeDefs = routes.entries();
-        for (const [methodName, routeConfigs] of routeDefs) {
-            if (paths !== 'all' && hasPathParam({ path: routeConfigs.path }) !== (paths === 'param')) {
-                continue;
-            }
-            // Dynamic dispatch by decorator-recorded method name - the controller class has no static index signature, so this read cannot be typed narrower than `unknown`.
-            const handler = this[methodName];
-            if (typeof handler !== 'function') {
-                logger.warn('Route method "%s" not found on controller', String(methodName));
-                continue;
-            }
-            this.bindRoute({ configs: routeConfigs }).to({
-                handler: handler.bind(this),
-            });
-        }
-    }
-    /** Configures the controller by binding all routes and registering decorator-based routes. Idempotent. */
-    async configure(opts) {
-        if (this.isConfigured) {
-            return this.router;
-        }
-        const t = performance.now();
-        const logger = this.logger.for(this.configure.name);
-        const configureOptions = opts ?? {};
-        logger.info('START | Binding controller | Options: %j', configureOptions);
-        // Hono matches in registration order, so registration runs by SHAPE not source: every static path first, then binding()'s routes, then decorator param routes last (`/{id}` early would eat `/count`).
-        this.registerRoutesFromRegistry({ paths: 'static' });
-        await this.binding();
-        this.registerRoutesFromRegistry({ paths: 'param' });
-        this.isConfigured = true;
-        logger.info('DONE | Binding controller | Took: %s (ms)', performance.now() - t);
-        return this.router;
-    }
-    /** @internal Builds auth + custom middlewares and security specs from route config. */
-    buildRouteMiddlewares(opts) {
-        const { authenticate = {}, authorize, ...restConfig } = opts.configs;
-        const { strategies = [], mode = constants_1.AuthenticationModes.ANY } = authenticate;
-        const security = strategies.map((strategy) => ({ [strategy]: [] }));
-        const mws = [];
-        if (strategies.length > 0) {
-            mws.push((0, authenticate_middleware_1.authenticate)({ strategies, mode }));
-        }
-        // Inject authorize middleware AFTER authenticate
-        if (authorize) {
-            const specs = Array.isArray(authorize) ? authorize : [authorize];
-            for (const spec of specs) {
-                mws.push((0, authorize_middleware_1.authorize)({ spec }));
-            }
-        }
-        const configuredMiddleware = restConfig.middleware;
-        const extraMws = Array.isArray(configuredMiddleware)
-            ? configuredMiddleware
-            : [configuredMiddleware];
-        for (const mw of extraMws) {
-            if (!mw) {
-                continue;
-            }
-            mws.push(mw);
-        }
-        return { restConfig, security, mws };
-    }
-    /** Processes route config, injecting auth middleware and OpenAPI security specs. */
-    getRouteConfigs(opts) {
-        const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);
-        const { tags = [] } = restConfig;
-        // `restConfig` already omitted `authenticate`/`authorize` (this library's fields, not Hono's `createRoute` ones); reassembled with the injected middleware/tags/security it no longer structurally overlaps RouteConfig enough to assert directly.
-        return (0, zod_openapi_1.createRoute)(Object.assign({}, restConfig, {
-            middleware: mws,
-            tags: [...tags, this.scope],
-            security,
-        }));
-    }
-    /** Like getRouteConfigs but adds HTML response schema for JSX rendering. */
-    getJSXRouteConfigs(opts) {
-        const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);
-        const { responses, tags = [] } = restConfig;
-        // Same reassembled-vs-RouteConfig boundary as getRouteConfigs above.
-        return (0, zod_openapi_1.createRoute)(Object.assign({}, restConfig, {
-            middleware: mws,
-            responses: Object.assign({}, (0, jsx_utility_1.htmlResponse)({ description: 'HTML page' }), responses),
-            tags: [...tags, this.scope],
-            security,
-        }));
-    }
-}
-exports.AbstractRestController = AbstractRestController;
-//# sourceMappingURL=abstract.js.map

package/dist/base/controllers/rest/abstract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/base/controllers/rest/abstract.ts"],"names":[],"mappings":";;;AAAA,+EAAsF;AACtF,gHAAoH;AAEpH,uGAAwG;AACxG,0DAA6E;AAC7E,2DAAgE;AAChE,yDAAuD;AAEvD,mDAA6D;AAE7D,0DAA8D;AAW9D,sGAAsG;AACtG,MAAM,YAAY,GAAG,CAAC,IAAsB,EAAW,EAAE;IACvD,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,kHAAkH;AAClH,MAAsB,sBAOpB,SAAQ,0BAAU;IAQlB,YAAY,IAAwB;QAClC,KAAK,CAAC,IAAI,CAAC,CAAC;QANd,iBAAY,GAAG,KAAK,CAAC;QAOnB,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEjC,MAAM,iBAAiB,GAAG,2BAAgB,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC;YAC7E,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,iBAAiB,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;QAE1D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,+FAA+F;aAC5H,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QAEzB,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAW,CAAkC;YAC7D,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;gBAChC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,MAAM,CAAC,KAAK,CAAC;gBACrB,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,kJAAkJ;IAClJ,0BAA0B,CAAC,IAA6C;QACtE,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACrE,IAAA,qCAA4B,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,2BAAgB,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC;YACtD,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;YACnD,IAAI,KAAK,KAAK,KAAK,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,EAAE,CAAC;gBACzF,SAAS;YACX,CAAC;YAED,iKAAiK;YACjK,MAAM,OAAO,GAAI,IAAyC,CAAC,UAAU,CAAC,CAAC;YACvE,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC7E,SAAS;YACX,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC3C,OAAO,EAAG,OAA4C,CAAC,IAAI,CAAC,IAAI,CAAC;aAClE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,SAAS,CACb,IAA0B;QAE1B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAEpD,MAAM,gBAAgB,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,gBAAgB,CAAC,CAAC;QAE1E,uMAAuM;QACvM,IAAI,CAAC,0BAA0B,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,0BAA0B,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAEpD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,uFAAuF;IACvF,qBAAqB,CAAuC,IAA8B;QACxF,MAAM,EAAE,YAAY,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACrE,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,IAAI,GAAG,+BAAmB,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;QAEzE,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAwC,EAAE,CAAC;QAEpD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,IAAA,sCAAc,EAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,iDAAiD;QACjD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAyB,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACvF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,GAAG,CAAC,IAAI,CAAC,IAAA,gCAAW,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,MAAM,oBAAoB,GAAG,UAAU,CAAC,UAAU,CAAC;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;YAClD,CAAC,CAAC,oBAAoB;YACtB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAE3B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,SAAS;YACX,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IACvC,CAAC;IAED,oFAAoF;IACpF,eAAe,CAAuC,IAA8B;QAClF,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC;QAEjC,mPAAmP;QACnP,OAAO,IAAA,yBAAW,EAChB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE;YAC5B,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC3B,QAAQ;SACT,CAAQ,CACV,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,kBAAkB,CAAuC,IAA8B;QACrF,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC;QAE5C,qEAAqE;QACrE,OAAO,IAAA,yBAAW,EAChB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE;YAC5B,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAA,0BAAY,EAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,CAAC;YACnF,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC3B,QAAQ;SACT,CAAQ,CACV,CAAC;IACJ,CAAC;CAeF;AAzLD,wDAyLC"}

package/dist/base/controllers/rest/base.d.ts

@@ -1,35 +0,0 @@
-import type { Hook, OpenAPIHono } from '@hono/zod-openapi';
-import type { ValueOrPromise } from '@venizia/ignis-helpers';
-import type { Env, Schema } from 'hono';
-import type { IAuthRouteConfig, IBindRouteOptions, IDefineRouteOptions, TRouteHandler } from '../common/types';
-import { AbstractRestController } from './abstract';
-/** Recommended base class for REST controllers with concrete bindRoute and defineRoute implementations. */
-export declare abstract class BaseRestController<RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, Definitions extends Record<string, IAuthRouteConfig> = Record<string, IAuthRouteConfig>> extends AbstractRestController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions, Definitions> {
-    /** Runs a handler task under performance measurement (fixed logger/level/description). */
-    measure<R>(opts: {
-        scope: string;
-        args: unknown;
-        task: () => Promise<R>;
-    }): Promise<any>;
-    /** TRouteHandler's TRouteContext is a lightweight custom shape (different `json`/`req.valid` signatures) built on Hono's real Context, not a subtype of the RouteHandler `.openapi()` expects - genuinely different handler types bridged here. */
-    toHonoHandler<ResponseType = unknown>(opts: {
-        handler: TRouteHandler<ResponseType, RouteEnv>;
-    }): Parameters<OpenAPIHono<RouteEnv>["openapi"]>[1];
-    /** Creates a fluent binding for registering a route (call .to() to attach handler). */
-    bindRoute<RouteConfig extends IAuthRouteConfig>(opts: {
-        configs: RouteConfig;
-    }): IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
-    /** Defines and registers a route with its handler in a single call. */
-    defineRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {
-        configs: RouteConfig;
-        handler: TRouteHandler<ResponseType, RouteEnv>;
-        hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
-    }): IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
-    /** Defines a JSX route that renders server-side HTML via c.html(). */
-    defineJSXRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {
-        configs: RouteConfig;
-        handler: TRouteHandler<ResponseType, RouteEnv>;
-        hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;
-    }): IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;
-}
-//# sourceMappingURL=base.d.ts.map

package/dist/base/controllers/rest/base.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/rest/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,2GAA2G;AAC3G,8BAAsB,kBAAkB,CACtC,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CACvF,SAAQ,sBAAsB,CAC9B,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,WAAW,CACZ;IACC,0FAA0F;IAC1F,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE;IAWzE,mPAAmP;IACnP,aAAa,CAAC,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;KAAE,GACrE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAGxE,uFAAuF;IACvF,SAAS,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QACpD,OAAO,EAAE,WAAW,CAAC;KACtB,GAAG,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAcnE,uEAAuE;IACvE,WAAW,CAAC,WAAW,SAAS,gBAAgB,EAAE,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QAC9E,OAAO,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAarE,sEAAsE;IACtE,cAAc,CAAC,WAAW,SAAS,gBAAgB,EAAE,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QACjF,OAAO,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;CAYtE"}

package/dist/base/controllers/rest/base.js

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseRestController = void 0;
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const abstract_1 = require("./abstract");
-/** Recommended base class for REST controllers with concrete bindRoute and defineRoute implementations. */
-class BaseRestController extends abstract_1.AbstractRestController {
-    /** Runs a handler task under performance measurement (fixed logger/level/description). */
-    measure(opts) {
-        return (0, ignis_helpers_1.executeWithPerformanceMeasure)({
-            logger: this.logger,
-            level: 'debug',
-            scope: opts.scope,
-            description: `execute ${opts.scope}`,
-            args: opts.args,
-            task: opts.task,
-        });
-    }
-    /** TRouteHandler's TRouteContext is a lightweight custom shape (different `json`/`req.valid` signatures) built on Hono's real Context, not a subtype of the RouteHandler `.openapi()` expects - genuinely different handler types bridged here. */
-    toHonoHandler(opts) {
-        return opts.handler;
-    }
-    /** Creates a fluent binding for registering a route (call .to() to attach handler). */
-    bindRoute(opts) {
-        const routeConfigs = this.getRouteConfigs({ configs: opts.configs });
-        return {
-            configs: routeConfigs,
-            to: ({ handler }) => {
-                return {
-                    configs: routeConfigs,
-                    route: this.router.openapi(routeConfigs, this.toHonoHandler({ handler })),
-                };
-            },
-        };
-    }
-    /** Defines and registers a route with its handler in a single call. */
-    defineRoute(opts) {
-        const routeConfigs = this.getRouteConfigs({ configs: opts.configs });
-        return {
-            configs: routeConfigs,
-            route: this.router.openapi(routeConfigs, this.toHonoHandler({ handler: opts.handler }), opts.hook),
-        };
-    }
-    /** Defines a JSX route that renders server-side HTML via c.html(). */
-    defineJSXRoute(opts) {
-        const routeConfigs = this.getJSXRouteConfigs({ configs: opts.configs });
-        return {
-            configs: routeConfigs,
-            route: this.router.openapi(routeConfigs, this.toHonoHandler({ handler: opts.handler }), opts.hook),
-        };
-    }
-}
-exports.BaseRestController = BaseRestController;
-//# sourceMappingURL=base.js.map

package/dist/base/controllers/rest/base.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/base/controllers/rest/base.ts"],"names":[],"mappings":";;;AAEA,0DAAuE;AAQvE,yCAAoD;AAEpD,2GAA2G;AAC3G,MAAsB,kBAMpB,SAAQ,iCAMT;IACC,0FAA0F;IAC1F,OAAO,CAAI,IAA8D;QACvE,OAAO,IAAA,6CAA6B,EAAC;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,OAAO;YACd,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,WAAW,IAAI,CAAC,KAAK,EAAE;YACpC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED,mPAAmP;IACnP,aAAa,CAAyB,IAAwD;QAC5F,OAAO,IAAI,CAAC,OAA0D,CAAC;IACzE,CAAC;IAED,uFAAuF;IACvF,SAAS,CAAuC,IAE/C;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAElF,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;gBAClB,OAAO;oBACL,OAAO,EAAE,YAAY;oBACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;iBAC1E,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,WAAW,CAA+D,IAIzE;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAElF,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,YAAY,EACZ,IAAI,CAAC,aAAa,CAAe,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAC3D,IAAI,CAAC,IAAI,CACV;SACF,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,cAAc,CAA+D,IAI5E;QACC,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAErF,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,YAAY,EACZ,IAAI,CAAC,aAAa,CAAe,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAC3D,IAAI,CAAC,IAAI,CACV;SACF,CAAC;IACJ,CAAC;CACF;AAlFD,gDAkFC"}

package/dist/base/controllers/rest/index.d.ts

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

package/dist/base/controllers/rest/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/controllers/rest/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}

package/dist/base/controllers/rest/index.js

@@ -1,19 +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("./abstract"), exports);
-__exportStar(require("./base"), exports);
-//# sourceMappingURL=index.js.map

package/dist/base/controllers/rest/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/controllers/rest/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,yCAAuB"}

package/dist/base/datasources/abstract.d.ts

@@ -1,26 +0,0 @@
-import type { TClass, ValueOrPromise } from '@venizia/ignis-helpers';
-import { BaseHelper } from '@venizia/ignis-helpers';
-import type { IDataSource, IDataSourceCapabilities, ITransaction, ITransactionOptions, TAnyDataSourceSchema } from './common';
-/** Engine-neutral datasource root - NO SQL members. Every connector family extends this. */
-export declare abstract class AbstractDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}> extends BaseHelper implements IDataSource<Settings, Schema, ConfigurableOptions> {
-    name: string;
-    settings: Settings;
-    schema: Schema;
-    abstract configure(opts?: ConfigurableOptions): ValueOrPromise<void>;
-    getSettings(): Settings;
-    getSchema(): Schema;
-    /** Capability probe, overridden by connectors that support it (e.g. postgres reports `{ transactions: true }`). */
-    getCapabilities(): IDataSourceCapabilities;
-    /** Defaults to throwing NotSupported - only connectors with real transaction support override this; async so callers get a rejected promise, not a synchronous throw that skips try/catch. */
-    beginTransaction(_opts?: ITransactionOptions): Promise<ITransaction>;
-    /** Model classes bound to this datasource via `@repository` metadata - paradigm-free (no schema/relation resolution). */
-    protected getBoundModelClasses(): Array<TClass<unknown>>;
-    /** Walks model classes bound to this datasource, reads a connector-specific artifact via `read`, and returns a name-keyed registry - skips undefined reads, throws on duplicate names, honors `autoDiscovery: false`. */
-    protected discoverDefinitions<TDefinition extends {
-        name: string;
-    }>(opts: {
-        read: (modelClass: TClass<unknown>) => TDefinition | undefined;
-        kind: string;
-    }): Record<string, TDefinition>;
-}
-//# sourceMappingURL=abstract.d.ts.map

package/dist/base/datasources/abstract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../src/base/datasources/abstract.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAY,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB,4FAA4F;AAC5F,8BAAsB,kBAAkB,CACtC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CAEvC,SAAQ,UACR,YAAW,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC;IAE7D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,cAAc,CAAC,IAAI,CAAC;IAEpE,WAAW;IAIX,SAAS,IAAI,MAAM;IASnB,mHAAmH;IACnH,eAAe,IAAI,uBAAuB;IAI1C,8LAA8L;IACxL,gBAAgB,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ1E,yHAAyH;IACzH,SAAS,CAAC,oBAAoB,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAMxD,yNAAyN;IACzN,SAAS,CAAC,mBAAmB,CAAC,WAAW,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,EAAE;QACxE,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,WAAW,GAAG,SAAS,CAAC;QAC/D,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;CAmDhC"}

package/dist/base/datasources/abstract.js

@@ -1,72 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractDataSource = void 0;
-const inversion_1 = require("../../helpers/inversion");
-const utilities_1 = require("../../utilities");
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-/** Engine-neutral datasource root - NO SQL members. Every connector family extends this. */
-class AbstractDataSource extends ignis_helpers_1.BaseHelper {
-    getSettings() {
-        return this.settings;
-    }
-    getSchema() {
-        if (!this.schema) {
-            throw (0, ignis_helpers_1.getError)({
-                message: `[${this.constructor.name}] Schema not initialized. Override getSchema() or provide schema in constructor.`,
-            });
-        }
-        return this.schema;
-    }
-    /** Capability probe, overridden by connectors that support it (e.g. postgres reports `{ transactions: true }`). */
-    getCapabilities() {
-        return { transactions: false };
-    }
-    /** Defaults to throwing NotSupported - only connectors with real transaction support override this; async so callers get a rejected promise, not a synchronous throw that skips try/catch. */
-    async beginTransaction(_opts) {
-        return (0, utilities_1.throwNotSupported)({
-            scope: this.constructor.name,
-            feature: 'Transactions',
-            logger: this.logger,
-        });
-    }
-    /** Model classes bound to this datasource via `@repository` metadata - paradigm-free (no schema/relation resolution). */
-    getBoundModelClasses() {
-        return inversion_1.MetadataRegistry.getInstance().getModelClasses({
-            dataSource: this.constructor,
-        });
-    }
-    /** Walks model classes bound to this datasource, reads a connector-specific artifact via `read`, and returns a name-keyed registry - skips undefined reads, throws on duplicate names, honors `autoDiscovery: false`. */
-    discoverDefinitions(opts) {
-        const { read, kind } = opts;
-        const logger = this.logger.for(this.discoverDefinitions.name);
-        const registry = inversion_1.MetadataRegistry.getInstance();
-        const metadata = registry.getDataSourceMetadata({ target: this.constructor });
-        if (metadata?.autoDiscovery === false) {
-            logger.debug('Auto-discovery disabled for %s', this.name);
-            return {};
-        }
-        const modelClasses = this.getBoundModelClasses();
-        const definitions = {};
-        const definitionOwners = new Map();
-        for (const modelClass of modelClasses) {
-            const definition = read(modelClass);
-            if (!definition) {
-                logger.warn('Model has no %s definition | Skipping | Name: %s | Model: %s', kind, this.name, modelClass.name);
-                continue;
-            }
-            const existingOwner = definitionOwners.get(definition.name);
-            if (existingOwner !== undefined && existingOwner !== modelClass.name) {
-                throw (0, ignis_helpers_1.getError)({
-                    message: `[${this.constructor.name}][discoverDefinitions] Duplicate ${kind} name '${definition.name}' | Name: ${this.name} | Classes: ${existingOwner}, ${modelClass.name}`,
-                });
-            }
-            definitionOwners.set(definition.name, modelClass.name);
-            definitions[definition.name] = definition;
-        }
-        const names = Object.keys(definitions);
-        logger.debug('Detected %s(s) | Name: %s | Count: %s | Names: %j', kind, this.name, names.length, names);
-        return definitions;
-    }
-}
-exports.AbstractDataSource = AbstractDataSource;
-//# sourceMappingURL=abstract.js.map

package/dist/base/datasources/abstract.js.map

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

package/dist/base/datasources/common/index.d.ts

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

package/dist/base/datasources/common/index.d.ts.map

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

package/dist/base/datasources/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/base/datasources/common/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/base/datasources/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}

package/dist/base/datasources/common/types.d.ts

@@ -1,58 +0,0 @@
-import type { AnyType, IConfigurable, TClass, TConstValue } from '@venizia/ignis-helpers';
-export declare class DataSourceDrivers {
-    static readonly NODE_POSTGRES = "node-postgres";
-    static readonly POSTGRES_JS = "postgres-js";
-    static readonly PGLITE = "pglite";
-    static readonly LIBSQL = "libsql";
-    static readonly TYPESENSE = "typesense";
-    static readonly MEILISEARCH = "meilisearch";
-    static readonly RELATIONAL_SCHEME_SET: Set<string>;
-    static readonly SEARCH_SCHEME_SET: Set<string>;
-    static readonly SCHEME_SET: Set<string>;
-    static isValid(value: string): boolean;
-}
-export type TDataSourceDriver = TConstValue<typeof DataSourceDrivers> | (string & {});
-/**
- * A driver CLASS, named by `@datasource({ driver })`. The class reference is what pulls the peer
- * package into a bundle - a name string pulls nothing, and a bare side-effect import may be
- * dropped. Untyped because `IRelationalDriver` lives under `connectors/`, off-limits to `base/`.
- */
-export type TDataSourceDriverClass = TClass<AnyType>;
-export type TAnyDataSourceSchema = Record<string, any>;
-/** Engine-neutral datasource contract - the root every connector family implements. */
-export interface IDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}> extends IConfigurable<ConfigurableOptions> {
-    name: string;
-    settings: Settings;
-    schema: Schema;
-    getSettings(): Settings;
-    getSchema(): Schema;
-}
-/**
- * Neutral transaction options - isolation levels are engine vocabulary, so `isolationLevel` stays
- * a loose string here and connectors narrow it in their own `ITransactionOptions` extension.
- */
-export interface ITransactionOptions {
-    isolationLevel?: string;
-}
-/** Neutral transaction handle - the minimum shape every connector's transaction satisfies. */
-export interface ITransaction {
-    isActive: boolean;
-    commit(): Promise<void>;
-    rollback(): Promise<void>;
-}
-export interface IDataSourceCapabilities {
-    transactions: boolean;
-}
-export interface ISearchableDataSourceCapabilities extends IDataSourceCapabilities {
-    search?: {
-        /** Vector / semantic / hybrid search (search engines). */
-        vector?: boolean;
-        /** Batched multi-query search across collections. */
-        multi?: boolean;
-        /** Merged (union) result set across a multi-search. */
-        union?: boolean;
-        /** Synonym sets (multi-way / one-way). */
-        synonyms?: boolean;
-    };
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/base/datasources/common/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1F,qBAAa,iBAAiB;IAE5B,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAChD,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAGlC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,qBAAqB,cAKlC;IACH,MAAM,CAAC,QAAQ,CAAC,iBAAiB,cAA+C;IAEhF,MAAM,CAAC,QAAQ,CAAC,UAAU,cAUvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAID,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEtF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEvD,uFAAuF;AACvF,MAAM,WAAW,WAAW,CAC1B,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,aAAa,CAAC,mBAAmB,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,IAAI,QAAQ,CAAC;IACxB,SAAS,IAAI,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iCAAkC,SAAQ,uBAAuB;IAChF,MAAM,CAAC,EAAE;QACP,0DAA0D;QAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;QAEjB,qDAAqD;QACrD,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB,uDAAuD;QACvD,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB,0CAA0C;QAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH"}

package/dist/base/datasources/common/types.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataSourceDrivers = void 0;
-class DataSourceDrivers {
-    // Relational - PGlite is a Postgres DRIVER (Postgres compiled to WASM), not a separate engine.
-    static { this.NODE_POSTGRES = 'node-postgres'; }
-    static { this.POSTGRES_JS = 'postgres-js'; }
-    static { this.PGLITE = 'pglite'; }
-    static { this.LIBSQL = 'libsql'; }
-    // Search
-    static { this.TYPESENSE = 'typesense'; }
-    static { this.MEILISEARCH = 'meilisearch'; }
-    static { this.RELATIONAL_SCHEME_SET = new Set([
-        this.NODE_POSTGRES,
-        this.POSTGRES_JS,
-        this.PGLITE,
-        this.LIBSQL,
-    ]); }
-    static { this.SEARCH_SCHEME_SET = new Set([this.TYPESENSE, this.MEILISEARCH]); }
-    static { this.SCHEME_SET = new Set([
-        // Relational
-        this.NODE_POSTGRES,
-        this.POSTGRES_JS,
-        this.PGLITE,
-        this.LIBSQL,
-        // Search
-        this.TYPESENSE,
-        this.MEILISEARCH,
-    ]); }
-    static isValid(value) {
-        return this.SCHEME_SET.has(value);
-    }
-}
-exports.DataSourceDrivers = DataSourceDrivers;
-//# sourceMappingURL=types.js.map

package/dist/base/datasources/common/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAC5B,+FAA+F;aAC/E,kBAAa,GAAG,eAAe,CAAC;aAChC,gBAAW,GAAG,aAAa,CAAC;aAC5B,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;IAElC,SAAS;aACO,cAAS,GAAG,WAAW,CAAC;aACxB,gBAAW,GAAG,aAAa,CAAC;aAE5B,0BAAqB,GAAG,IAAI,GAAG,CAAC;QAC9C,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;KACZ,CAAC,CAAC;aACa,sBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;aAEhE,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,aAAa;QACb,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QAEX,SAAS;QACT,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,WAAW;KACjB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAjCH,8CAkCC"}

package/dist/base/datasources/index.d.ts

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

package/dist/base/datasources/index.d.ts.map

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

package/dist/base/datasources/index.js

@@ -1,19 +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("./abstract"), exports);
-__exportStar(require("./common"), exports);
-//# sourceMappingURL=index.js.map

package/dist/base/datasources/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/datasources/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,2CAAyB"}

package/dist/base/metadata/injectors.d.ts

@@ -1,7 +0,0 @@
-import type { TBindingKey } from '../../helpers/inversion';
-/** Marks a property or constructor parameter for dependency injection. */
-export declare const inject: (opts: {
-    key: TBindingKey;
-    isOptional?: boolean;
-}) => (target: any, propertyName: string | symbol | undefined, parameterIndex?: number) => void;
-//# sourceMappingURL=injectors.d.ts.map

package/dist/base/metadata/injectors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"injectors.d.ts","sourceRoot":"","sources":["../../../src/base/metadata/injectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,0EAA0E;AAC1E,eAAO,MAAM,MAAM,GAAI,MAAM;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,8FAEtE,CAAC"}

package/dist/base/metadata/injectors.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.inject = void 0;
-const inversion_1 = require("../../helpers/inversion");
-const ignis_inversion_1 = require("@venizia/ignis-inversion");
-/** Marks a property or constructor parameter for dependency injection. */
-const inject = (opts) => {
-    return (0, ignis_inversion_1.inject)({ ...opts, registry: inversion_1.MetadataRegistry.getInstance() });
-};
-exports.inject = inject;
-//# sourceMappingURL=injectors.js.map

package/dist/base/metadata/injectors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"injectors.js","sourceRoot":"","sources":["../../../src/base/metadata/injectors.ts"],"names":[],"mappings":";;;AACA,mDAAuD;AACvD,8DAAgE;AAEhE,0EAA0E;AACnE,MAAM,MAAM,GAAG,CAAC,IAAgD,EAAE,EAAE;IACzE,OAAO,IAAA,wBAAU,EAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,4BAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC;AAFW,QAAA,MAAM,UAEjB"}

package/dist/base/metadata/persistents.d.ts

@@ -1,10 +0,0 @@
-import type { IDataSourceMetadata, IModelMetadata, IRepositoryMetadata } from '../../helpers/inversion';
-import type { IDataSource } from '../datasources';
-import type { AbstractEntity } from '../models';
-/** Registers a model class with its static schema and relations. */
-export declare const model: (metadata: IModelMetadata) => ClassDecorator;
-/** Registers a datasource with driver and auto-discovery settings. */
-export declare const datasource: (metadata?: IDataSourceMetadata) => ClassDecorator;
-/** Binds a repository to a model and datasource for schema auto-discovery. */
-export declare const repository: <Model extends AbstractEntity = AbstractEntity, DataSource extends IDataSource = IDataSource>(metadata: IRepositoryMetadata<Model, DataSource>) => ClassDecorator;
-//# sourceMappingURL=persistents.d.ts.map

package/dist/base/metadata/persistents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"persistents.d.ts","sourceRoot":"","sources":["../../../src/base/metadata/persistents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACd,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,oEAAoE;AACpE,eAAO,MAAM,KAAK,GAAI,UAAU,cAAc,KAAG,cA0BhD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,WAAW,mBAAmB,KAAG,cAI3D,CAAC;AAgJF,8EAA8E;AAC9E,eAAO,MAAM,UAAU,GACrB,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,WAAW,GAAG,WAAW,EAE5C,UAAU,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,KAC/C,cAaF,CAAC"}