@venizia/ignis-kernel 0.2.0-0

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

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractRestController = void 0;
+const constants_1 = require("../../../base/auth/authenticate/common/constants");
+const authenticate_middleware_1 = require("../../../base/auth/authenticate/middlewares/authenticate.middleware");
+const authorize_middleware_1 = require("../../../base/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 core_1 = require("@venizia/ignis-helpers/core");
+/** 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 core_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, core_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);
+        common_1.DroppedRouteDecorators.report({ 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/cjs/base/controllers/rest/abstract.js.map

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

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

@@ -0,0 +1,35 @@
+import type { Hook, OpenAPIHono } from '@hono/zod-openapi';
+import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
+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/cjs/base/controllers/rest/base.d.ts.map

@@ -0,0 +1 @@
+{"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,+BAA+B,CAAC;AAEpE,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/cjs/base/controllers/rest/base.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseRestController = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+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, core_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/cjs/base/controllers/rest/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/base/controllers/rest/base.ts"],"names":[],"mappings":";;;AAEA,sDAA4E;AAQ5E,yCAAoD;AAEpD,2GAA2G;AAC3G,MAAsB,kBAMpB,SAAQ,iCAMT;IACC,0FAA0F;IAC1F,OAAO,CAAI,IAA8D;QACvE,OAAO,IAAA,oCAA6B,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/cjs/base/controllers/rest/index.d.ts

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

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

@@ -0,0 +1 @@
+{"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/cjs/base/controllers/rest/index.js

@@ -0,0 +1,19 @@
+"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/cjs/base/controllers/rest/index.js.map

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

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

@@ -0,0 +1,39 @@
+import type { AnyType, TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { IDataSource, IDataSourceCapabilities, ITransaction, ITransactionOptions, TAnyDataSourceSchema } from './common';
+/**
+ * Brands the datasource root so `@repository` can recognise a subclass WITHOUT `instanceof`.
+ *
+ * Two copies of this package give two `AbstractDataSource` classes, and `instanceof` across them is
+ * false - the same trap `isApplicationError` exists to avoid for `ApplicationError`. `Symbol.for` is
+ * realm-keyed, so both copies produce this exact symbol, and a static is inherited by every
+ * subclass however deep.
+ */
+export declare const DATA_SOURCE_BRAND: unique symbol;
+/** True for `AbstractDataSource` itself and for any class extending it, across package copies. */
+export declare const isDataSourceClass: (value: unknown) => value is TClass<AnyType>;
+/** 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> {
+    /** Read by {@link isDataSourceClass}. Static, so every subclass inherits it. */
+    static readonly [DATA_SOURCE_BRAND] = true;
+    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/cjs/base/datasources/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/base/datasources/abstract.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,eAA2D,CAAC;AAE1F,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAEzE,CAAC;AAEF,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,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,QAAQ;IAE3C,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/cjs/base/datasources/abstract.js

@@ -0,0 +1,90 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractDataSource = exports.isDataSourceClass = exports.DATA_SOURCE_BRAND = void 0;
+const inversion_1 = require("../../helpers/inversion");
+const utilities_1 = require("../../utilities");
+const core_1 = require("@venizia/ignis-helpers/core");
+/**
+ * Brands the datasource root so `@repository` can recognise a subclass WITHOUT `instanceof`.
+ *
+ * Two copies of this package give two `AbstractDataSource` classes, and `instanceof` across them is
+ * false - the same trap `isApplicationError` exists to avoid for `ApplicationError`. `Symbol.for` is
+ * realm-keyed, so both copies produce this exact symbol, and a static is inherited by every
+ * subclass however deep.
+ */
+exports.DATA_SOURCE_BRAND = Symbol.for('@venizia/ignis-kernel:abstract-data-source');
+/** True for `AbstractDataSource` itself and for any class extending it, across package copies. */
+const isDataSourceClass = (value) => {
+    return typeof value === 'function' && exports.DATA_SOURCE_BRAND in value;
+};
+exports.isDataSourceClass = isDataSourceClass;
+/** Engine-neutral datasource root - NO SQL members. Every connector family extends this. */
+class AbstractDataSource extends core_1.BaseHelper {
+    static { _a = exports.DATA_SOURCE_BRAND; }
+    /** Read by {@link isDataSourceClass}. Static, so every subclass inherits it. */
+    static { this[_a] = true; }
+    getSettings() {
+        return this.settings;
+    }
+    getSchema() {
+        if (!this.schema) {
+            throw (0, core_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, core_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/cjs/base/datasources/abstract.js.map

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

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

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

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

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

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

@@ -0,0 +1,18 @@
+"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/datasources/common/index.js.map

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

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

@@ -0,0 +1,58 @@
+import type { AnyType, IConfigurable, TClass, TConstValue } from '@venizia/ignis-helpers/common';
+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/cjs/base/datasources/common/types.d.ts.map

@@ -0,0 +1 @@
+{"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,+BAA+B,CAAC;AAEjG,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/cjs/base/datasources/common/types.js

@@ -0,0 +1,35 @@
+"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/cjs/base/datasources/common/types.js.map

@@ -0,0 +1 @@
+{"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/cjs/base/datasources/index.d.ts

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

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

@@ -0,0 +1 @@
+{"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/cjs/base/datasources/index.js

@@ -0,0 +1,19 @@
+"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/cjs/base/datasources/index.js.map

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

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

@@ -0,0 +1,14 @@
+export * from './applications';
+export * from './auth';
+export * from './components';
+export * from './controllers';
+export * from './datasources';
+export * from './metadata';
+export * from './middlewares';
+export * from './mixins';
+export * from './models';
+export * from './providers';
+export * from './repositories';
+export * from './request-context';
+export * from './services';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAM3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}