@venizia/ignis 0.0.10-4 → 0.1.0

package/dist/connectors/search/datasources/base.d.ts

@@ -0,0 +1,73 @@
+import type { ISearchConnector } from '../../../connectors/search/connector';
+import type { ISearchCollectionDefinition, TSearchSchema } from '../../../connectors/search/models';
+import type { ISearchDataSourceOptions } from '../../../connectors/search/datasources/common';
+import type { TMultiSearchEntry } from '../../../connectors/search/repositories/common';
+import { AbstractSearchDataSource } from './abstract';
+/**
+ * Collection discovery/provisioning + connector lifecycle over AbstractSearchDataSource's engine
+ * contract - mirrors BasePostgresDataSource's schema auto-discovery over AbstractPostgresDataSource.
+ *
+ * The connector is held through the `ISearchConnector`-bounded generic, never as an engine type: this
+ * tier is the paradigm seam and must not import Typesense/Meilisearch. Engines supply only
+ * `createConnector()`.
+ */
+export declare abstract class BaseSearchDataSource<Settings extends object = {}, TConnector extends ISearchConnector = ISearchConnector> extends AbstractSearchDataSource<Settings> {
+    protected autoProvision: boolean;
+    protected hiddenFieldsByCollectionMap?: Record<string, string[]>;
+    protected connector?: TConnector;
+    private readonly injectedConnector?;
+    constructor(opts: ISearchDataSourceOptions<Settings> & {
+        connector?: TConnector;
+    });
+    /** The engine's connector instance - the ONLY engine-specific step of the lifecycle. */
+    protected abstract createConnector(): TConnector;
+    /** Builds the connector (unless injected, e.g. for tests), then provisions collections. Re-entrant-safe: a second call is a logged no-op, not a re-provision. */
+    configure(): Promise<void>;
+    getConnector(): TConnector;
+    /** Auto-discovers collections from repositories if not manually provided. */
+    getSchema(): TSearchSchema;
+    hasDiscoverableModels(): boolean;
+    /**
+     * Cross-collection search - lives on the datasource (not a single-collection repository) since it
+     * spans many collections at once. The envelope is engine-specific, so the neutral return is
+     * `unknown`; `TypesenseDataSource` narrows it to its results/union shapes.
+     */
+    multiSearch(opts: {
+        searches: TMultiSearchEntry[];
+        union?: boolean;
+        commonParams?: Omit<TMultiSearchEntry, 'collection'>;
+        options?: unknown;
+    }): Promise<unknown>;
+    /**
+     * Reads `static searchCollection` (dual-schema escape: a postgres entity carrying a search index
+     * beside its pgTable), falling back to `static schema` (shape-guarded so a
+     * pgTable's `schema` is never mistaken for a collection definition); skips classes with
+     * neither. Honors `@datasource({ autoDiscovery: false })` same as the postgres branch.
+     */
+    protected discoverCollections(): TSearchSchema;
+    /** Reads a bound model class's collection definition (dual-schema `searchCollection` first, then the
+     * shape-guarded `schema`); returns undefined for a class carrying neither. */
+    private readCollectionDefinition;
+    /** Collection name -> its `@model` hiddenProperties, for datasource-level operations (multiSearch)
+     * that span collections and so cannot read a single repository's `hiddenFields`. Collections with
+     * no hidden properties are omitted; callers own exclusion for any collection absent from this map.
+     *
+     * Memoized per instance like `getSchema()`: `@model` settings and `@repository` bindings are frozen
+     * once boot completes, so the walk is computed on first use and never invalidated. */
+    protected hiddenFieldsByCollection(): Record<string, string[]>;
+    /** The registry/model walk behind `hiddenFieldsByCollection` - mirrors the
+     * `getSchema()` / `discoverCollections()` split. */
+    protected discoverHiddenFieldsByCollection(): Record<string, string[]>;
+    /** Unions a collection's hidden fields into one multiSearch entry's excludeFields. An entry whose
+     * collection is unknown (not a discovered definition) passes through untouched - the caller owns
+     * exclusion there, exactly as the raw connector escape hatch does. */
+    private applyHiddenExclusion;
+    /** Provisions discovered collections via ensureCollection (additive-only; destructive migration is caller policy). Skipped if autoProvision is false; failures propagate so boot fails loudly. */
+    protected provisionCollections(): Promise<void>;
+    /** Engines expose synonyms as either named linkable sets or a flat per-collection dictionary, and
+     * some expose neither - so both groups are optional on `ISearchConnector` and are branched on here. */
+    protected provisionSynonyms(opts: {
+        definition: ISearchCollectionDefinition;
+    }): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/connectors/search/datasources/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/datasources/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE7F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAGjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAuBtD;;;;;;;GAOG;AACH,8BAAsB,oBAAoB,CACxC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,UAAU,SAAS,gBAAgB,GAAG,gBAAgB,CACtD,SAAQ,wBAAwB,CAAC,QAAQ,CAAC;IAC1C,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC;IACjC,SAAS,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,SAAS,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAa;gBAEpC,IAAI,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,UAAU,CAAA;KAAE;IAejF,wFAAwF;IACxF,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,UAAU;IAEhD,iKAAiK;IAC3J,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAahC,YAAY,IAAI,UAAU;IAU1B,6EAA6E;IACpE,SAAS,IAAI,aAAa;IAOnC,qBAAqB,IAAI,OAAO;IAKhC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE;QAChB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,YAAY,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;QACrD,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBpB;;;;;OAKG;IACH,SAAS,CAAC,mBAAmB,IAAI,aAAa;IAO9C;kFAC8E;IAC9E,OAAO,CAAC,wBAAwB;IAYhC;;;;;0FAKsF;IACtF,SAAS,CAAC,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAK9D;wDACoD;IACpD,SAAS,CAAC,gCAAgC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAoBtE;;0EAEsE;IACtE,OAAO,CAAC,oBAAoB;IAe5B,kMAAkM;cAClL,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrD;2GACuG;cACvF,iBAAiB,CAAC,IAAI,EAAE;QACtC,UAAU,EAAE,2BAA2B,CAAC;KACzC,GAAG,OAAO,CAAC,IAAI,CAAC;CA8BlB"}

package/dist/connectors/search/datasources/base.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSearchDataSource = void 0;
+const common_1 = require("../../../connectors/search/repositories/common");
+const inversion_1 = require("../../../helpers/inversion");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const abstract_1 = require("./abstract");
+/** A pg entity's `schema` is a pgTable, not an `ISearchCollectionDefinition` - narrows by shape so
+ * a pgTable is never mistaken for (and provisioned as) a search collection. */
+const isSearchCollectionDefinition = (value) => {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.name === 'string' &&
+        Array.isArray(value.fields));
+};
+/**
+ * Collection discovery/provisioning + connector lifecycle over AbstractSearchDataSource's engine
+ * contract - mirrors BasePostgresDataSource's schema auto-discovery over AbstractPostgresDataSource.
+ *
+ * The connector is held through the `ISearchConnector`-bounded generic, never as an engine type: this
+ * tier is the paradigm seam and must not import Typesense/Meilisearch. Engines supply only
+ * `createConnector()`.
+ */
+class BaseSearchDataSource extends abstract_1.AbstractSearchDataSource {
+    constructor(opts) {
+        super({ scope: opts.name });
+        this.name = opts.name;
+        this.settings = opts.config;
+        this.injectedConnector = opts.connector;
+        const autoProvision = (process.env.APP_ENV_AUTO_PROVISION_COLLECTION ?? 'false').toLowerCase();
+        this.autoProvision = opts.autoProvision ?? (autoProvision === 'true' || autoProvision === '1');
+        this.logger.info('[constructor] Auto Provision Collection - autoProvision: %s', this.autoProvision);
+    }
+    /** Builds the connector (unless injected, e.g. for tests), then provisions collections. Re-entrant-safe: a second call is a logged no-op, not a re-provision. */
+    async configure() {
+        if (this.connector) {
+            this.logger
+                .for(this.configure.name)
+                .info('Already configured | Name: %s | Skipping re-provisioning', this.name);
+            return;
+        }
+        this.connector = this.injectedConnector ?? this.createConnector();
+        await this.provisionCollections();
+    }
+    getConnector() {
+        if (!this.connector) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}] Connector not initialized | Name: ${this.name} | Call configure() first`,
+            });
+        }
+        return this.connector;
+    }
+    /** Auto-discovers collections from repositories if not manually provided. */
+    getSchema() {
+        if (!this.schema) {
+            this.schema = this.discoverCollections();
+        }
+        return this.schema;
+    }
+    hasDiscoverableModels() {
+        const registry = inversion_1.MetadataRegistry.getInstance();
+        return registry.hasModels({ dataSource: this.constructor });
+    }
+    /**
+     * Cross-collection search - lives on the datasource (not a single-collection repository) since it
+     * spans many collections at once. The envelope is engine-specific, so the neutral return is
+     * `unknown`; `TypesenseDataSource` narrows it to its results/union shapes.
+     */
+    multiSearch(opts) {
+        const { searches, union: isUnion, commonParams, options } = opts;
+        const dialect = this.getQueryDialect();
+        const hiddenByCollection = this.hiddenFieldsByCollection();
+        // Same friendly -> wire mapping search() uses; unions each entry's hidden fields into
+        // excludeFields per collection, exactly as search() does for @model hiddenProperties.
+        const wireSearches = searches.map(entry => ({
+            collection: entry.collection,
+            ...dialect.toWireParams({
+                query: (0, common_1.toSearchQueryParams)(this.applyHiddenExclusion({ entry, hiddenByCollection })),
+            }),
+        }));
+        const wireCommonParams = commonParams
+            ? dialect.toWireParams({ query: (0, common_1.toSearchQueryParams)(commonParams) })
+            : undefined;
+        return this.getConnector().multiSearch({
+            searches: wireSearches,
+            union: isUnion,
+            commonParams: wireCommonParams,
+            options,
+        });
+    }
+    /**
+     * Reads `static searchCollection` (dual-schema escape: a postgres entity carrying a search index
+     * beside its pgTable), falling back to `static schema` (shape-guarded so a
+     * pgTable's `schema` is never mistaken for a collection definition); skips classes with
+     * neither. Honors `@datasource({ autoDiscovery: false })` same as the postgres branch.
+     */
+    discoverCollections() {
+        return this.discoverDefinitions({
+            kind: 'collection',
+            read: modelClass => this.readCollectionDefinition(modelClass),
+        });
+    }
+    /** Reads a bound model class's collection definition (dual-schema `searchCollection` first, then the
+     * shape-guarded `schema`); returns undefined for a class carrying neither. */
+    readCollectionDefinition(modelClass) {
+        const model = modelClass;
+        if (model.searchCollection) {
+            return model.searchCollection;
+        }
+        return isSearchCollectionDefinition(model.schema) ? model.schema : undefined;
+    }
+    /** Collection name -> its `@model` hiddenProperties, for datasource-level operations (multiSearch)
+     * that span collections and so cannot read a single repository's `hiddenFields`. Collections with
+     * no hidden properties are omitted; callers own exclusion for any collection absent from this map.
+     *
+     * Memoized per instance like `getSchema()`: `@model` settings and `@repository` bindings are frozen
+     * once boot completes, so the walk is computed on first use and never invalidated. */
+    hiddenFieldsByCollection() {
+        this.hiddenFieldsByCollectionMap ??= this.discoverHiddenFieldsByCollection();
+        return this.hiddenFieldsByCollectionMap;
+    }
+    /** The registry/model walk behind `hiddenFieldsByCollection` - mirrors the
+     * `getSchema()` / `discoverCollections()` split. */
+    discoverHiddenFieldsByCollection() {
+        const registry = inversion_1.MetadataRegistry.getInstance();
+        const result = {};
+        for (const modelClass of this.getBoundModelClasses()) {
+            const definition = this.readCollectionDefinition(modelClass);
+            if (!definition) {
+                continue;
+            }
+            const hiddenProperties = registry.getModelMetadata({ target: modelClass })?.settings
+                ?.hiddenProperties;
+            if (hiddenProperties && hiddenProperties.length > 0) {
+                result[definition.name] = hiddenProperties;
+            }
+        }
+        return result;
+    }
+    /** Unions a collection's hidden fields into one multiSearch entry's excludeFields. An entry whose
+     * collection is unknown (not a discovered definition) passes through untouched - the caller owns
+     * exclusion there, exactly as the raw connector escape hatch does. */
+    applyHiddenExclusion(opts) {
+        const { entry, hiddenByCollection } = opts;
+        const hiddenFields = hiddenByCollection[entry.collection];
+        if (!hiddenFields || hiddenFields.length === 0) {
+            return entry;
+        }
+        const excludeFields = Array.from(new Set([...(entry.excludeFields ?? []), ...hiddenFields]));
+        return { ...entry, excludeFields };
+    }
+    /** Provisions discovered collections via ensureCollection (additive-only; destructive migration is caller policy). Skipped if autoProvision is false; failures propagate so boot fails loudly. */
+    async provisionCollections() {
+        const logger = this.logger.for(this.provisionCollections.name);
+        if (!this.autoProvision) {
+            logger.info('autoProvision disabled | Skipping collection provisioning | Name: %s', this.name);
+            return;
+        }
+        const definitions = Object.values(this.getSchema());
+        for (const definition of definitions) {
+            await this.ensureCollection({ definition });
+            if (!definition.synonyms?.length) {
+                continue;
+            }
+            await this.provisionSynonyms({ definition });
+        }
+        logger.info('Provisioned collection(s) | Name: %s | Count: %s', this.name, definitions.length);
+    }
+    /** Engines expose synonyms as either named linkable sets or a flat per-collection dictionary, and
+     * some expose neither - so both groups are optional on `ISearchConnector` and are branched on here. */
+    async provisionSynonyms(opts) {
+        const { definition } = opts;
+        const logger = this.logger.for(this.provisionSynonyms.name);
+        const connector = this.getConnector();
+        const items = definition.synonyms ?? [];
+        if (connector.synonymSet) {
+            // Set name stays distinct from Typesense's own auto-migration name
+            // (`<collection>_synonyms_index`) so the two never clash.
+            const synonymSetName = `${definition.name}_synonyms`;
+            await connector.synonymSet.upsert({ name: synonymSetName, items });
+            await connector.synonymSet.link({
+                collection: definition.name,
+                synonymSets: [synonymSetName],
+            });
+            return;
+        }
+        if (connector.synonyms) {
+            await connector.synonyms.set({ collection: definition.name, items });
+            return;
+        }
+        logger.warn('Collection declares synonyms but the engine exposes no synonym API | Name: %s | Collection: %s', this.name, definition.name);
+    }
+}
+exports.BaseSearchDataSource = BaseSearchDataSource;
+//# sourceMappingURL=base.js.map

package/dist/connectors/search/datasources/base.js.map

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

package/dist/connectors/search/datasources/common/index.d.ts

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

package/dist/connectors/search/datasources/common/index.d.ts.map

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

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

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

package/dist/connectors/search/datasources/common/types.d.ts

@@ -0,0 +1,8 @@
+export interface ISearchDataSourceOptions<Settings extends object = {}> {
+    name: string;
+    config: Settings;
+    /** Auto-provision discovered collections on configure(). Defaults to the
+     * `APP_ENV_AUTO_PROVISION_COLLECTION` env flag, which is off unless set to 'true' or '1'. */
+    autoProvision?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/search/datasources/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/datasources/common/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;IAEjB;iGAC6F;IAC7F,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/connectors/search/datasources/common/types.js

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

package/dist/connectors/search/datasources/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/connectors/search/datasources/common/types.ts"],"names":[],"mappings":""}

package/dist/connectors/search/datasources/index.d.ts

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

package/dist/connectors/search/datasources/index.d.ts.map

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

package/dist/connectors/search/datasources/index.js

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

package/dist/connectors/search/datasources/index.js.map

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

package/dist/connectors/search/index.d.ts

@@ -0,0 +1,6 @@
+export * from './connector';
+export * from './controllers';
+export * from './datasources';
+export * from './models';
+export * from './repositories';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/search/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/dist/connectors/search/index.js

@@ -0,0 +1,22 @@
+"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("./connector"), exports);
+__exportStar(require("./controllers"), exports);
+__exportStar(require("./datasources"), exports);
+__exportStar(require("./models"), exports);
+__exportStar(require("./repositories"), exports);
+//# sourceMappingURL=index.js.map

package/dist/connectors/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/connectors/search/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,gDAA8B;AAC9B,gDAA8B;AAC9B,2CAAyB;AACzB,iDAA+B"}

package/dist/connectors/search/internal/index.d.ts

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

package/dist/connectors/search/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/connectors/search/internal/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("./search-connector-internal"), exports);
+//# sourceMappingURL=index.js.map

package/dist/connectors/search/internal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/search/internal/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C"}

package/dist/connectors/{typesense/internal/search-driver-internal.d.ts → search/internal/search-connector-internal.d.ts}

@@ -1,6 +1,6 @@
-import { Logger } from '@venizia/ignis-helpers';
-/** Engine-agnostic error plumbing shared by every search driver; backend-specific classification (what counts as 404/409) lives in each backend's own internal helper. */
-export declare class SearchDriverInternal {
+import type { Logger } from '@venizia/ignis-helpers';
+/** Engine-agnostic error plumbing shared by every search connector; backend-specific classification (what counts as 404/409) lives in each backend's own internal helper. */
+export declare class SearchConnectorInternal {
     static describeError(opts: {
         error: unknown;
     }): unknown;
@@ -15,4 +15,4 @@ export declare class SearchDriverInternal {
         subject: string;
     }): never;
 }
-//# sourceMappingURL=search-driver-internal.d.ts.map
+//# sourceMappingURL=search-connector-internal.d.ts.map

package/dist/connectors/search/internal/search-connector-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-connector-internal.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/internal/search-connector-internal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGrD,6KAA6K;AAC7K,qBAAa,uBAAuB;IAElC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAOvD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,KAAK;IA6BT,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK;CAS5E"}

package/dist/connectors/search/internal/search-connector-internal.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchConnectorInternal = void 0;
+const common_1 = require("../../../common");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+/** Engine-agnostic error plumbing shared by every search connector; backend-specific classification (what counts as 404/409) lives in each backend's own internal helper. */
+class SearchConnectorInternal {
+    // Error/stack are non-enumerable, so `%j` on a raw Error yields `{}` — extract them so logs retain detail.
+    static describeError(opts) {
+        const { error } = opts;
+        return error instanceof Error ? (error.stack ?? error.message) : error;
+    }
+    // Logs the full error internally; throws a sanitized 503 with zero internal leakage.
+    // `details` is for caller-actionable progress info (counts, offsets) only, never engine detail.
+    static wrapDependencyError(opts) {
+        const { method, error, logger, details } = opts;
+        logger
+            .for(method)
+            .error('Search engine dependency error | detail: %s', SearchConnectorInternal.describeError({ error }));
+        const wrapped = (0, ignis_helpers_1.getError)({
+            statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_5.ServiceUnavailable,
+            messageCode: common_1.SearchErrorCodes.DEPENDENCY_UNAVAILABLE,
+            message: `[${method}] Search engine is temporarily unavailable.`,
+            ...(details ? { details } : {}),
+        });
+        // The original engine error carries the code the CALLER may need to classify on - Meilisearch
+        // reports `index_already_exists` as a failed TASK, and a connector that tolerates it (an
+        // idempotent createCollection on the second boot) can only see it through here.
+        //
+        // Assigned AFTER construction on purpose: passing `cause` to getError() would land it in
+        // `extra`, which the error middleware puts on the WIRE. As a plain `cause` it reaches the
+        // response only in a development environment, where stack and cause are already exposed.
+        wrapped.cause = error;
+        throw wrapped;
+    }
+    // Throws a sanitized 404; `subject` must only contain caller-provided identifiers, never engine internals.
+    static throwNotFoundError(opts) {
+        const { method, subject } = opts;
+        throw (0, ignis_helpers_1.getError)({
+            statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_4.NotFound,
+            messageCode: common_1.SearchErrorCodes.NOT_FOUND,
+            message: `[${method}] ${subject} not found.`,
+        });
+    }
+}
+exports.SearchConnectorInternal = SearchConnectorInternal;
+//# sourceMappingURL=search-connector-internal.js.map

package/dist/connectors/search/internal/search-connector-internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-connector-internal.js","sourceRoot":"","sources":["../../../../src/connectors/search/internal/search-connector-internal.ts"],"names":[],"mappings":";;;AAAA,qCAA4C;AAE5C,0DAAwD;AAExD,6KAA6K;AAC7K,MAAa,uBAAuB;IAClC,2GAA2G;IAC3G,MAAM,CAAC,aAAa,CAAC,IAAwB;QAC3C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACzE,CAAC;IAED,qFAAqF;IACrF,gGAAgG;IAChG,MAAM,CAAC,mBAAmB,CAAC,IAK1B;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEhD,MAAM;aACH,GAAG,CAAC,MAAM,CAAC;aACX,KAAK,CACJ,6CAA6C,EAC7C,uBAAuB,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,CACjD,CAAC;QAEJ,MAAM,OAAO,GAAG,IAAA,wBAAQ,EAAC;YACvB,UAAU,EAAE,oBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB;YACpD,WAAW,EAAE,yBAAgB,CAAC,sBAAsB;YACpD,OAAO,EAAE,IAAI,MAAM,6CAA6C;YAChE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAC;QAEH,8FAA8F;QAC9F,yFAAyF;QACzF,gFAAgF;QAChF,EAAE;QACF,yFAAyF;QACzF,0FAA0F;QAC1F,yFAAyF;QACxF,OAA+B,CAAC,KAAK,GAAG,KAAK,CAAC;QAC/C,MAAM,OAAO,CAAC;IAChB,CAAC;IAED,2GAA2G;IAC3G,MAAM,CAAC,kBAAkB,CAAC,IAAyC;QACjE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,MAAM,IAAA,wBAAQ,EAAC;YACb,UAAU,EAAE,oBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ;YAC1C,WAAW,EAAE,yBAAgB,CAAC,SAAS;YACvC,OAAO,EAAE,IAAI,MAAM,KAAK,OAAO,aAAa;SAC7C,CAAC,CAAC;IACL,CAAC;CACF;AApDD,0DAoDC"}

package/dist/connectors/{typesense → search}/models/base.d.ts

@@ -1,6 +1,7 @@
-import { z } from '@hono/zod-openapi';
-import { AbstractEntity, TSchemaType } from '../../../base/models';
-import { ISearchCollectionDefinition, TInferSearchDocument } from './types';
+import type { z } from '@hono/zod-openapi';
+import type { TSchemaType } from '../../../base/models';
+import { AbstractEntity } from '../../../base/models';
+import type { ISearchCollectionDefinition, TSearchDocument } from './types';
 /**
  * Engine-neutral search-document entity: derives zod schemas from an `ISearchCollectionDefinition`.
  * The `Schema` generic is instance-side only, so the `schema` field carries the caller's literal
@@ -9,8 +10,8 @@ import { ISearchCollectionDefinition, TInferSearchDocument } from './types';
  */
 export declare class BaseSearchEntity<Schema extends ISearchCollectionDefinition = ISearchCollectionDefinition> extends AbstractEntity {
     schema: Schema;
-    readonly $inferData?: TInferSearchDocument<Schema>;
-    readonly $inferPersist?: TInferSearchDocument<Schema>;
+    readonly $inferData?: TSearchDocument<Schema>;
+    readonly $inferPersist?: TSearchDocument<Schema>;
     static COLLECTION_NAME?: string;
     static AUTHORIZATION_SUBJECT?: string;
     static schema: ISearchCollectionDefinition;
@@ -20,9 +21,8 @@ export declare class BaseSearchEntity<Schema extends ISearchCollectionDefinition
         name?: string;
         schema?: Schema;
     });
-    getSchema(opts: {
+    getSchema<T = unknown>(opts: {
         type: TSchemaType;
-    }): z.ZodTypeAny;
-    private static _deriveSchema;
+    }): T;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/connectors/search/models/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/models/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG5E;;;;;GAKG;AACH,qBAAa,gBAAgB,CAC3B,MAAM,SAAS,2BAA2B,GAAG,2BAA2B,CACxE,SAAQ,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IAGf,SAAiB,UAAU,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACtD,SAAiB,aAAa,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAEzD,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAEtC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE3C,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAuD;gBAE/E,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IASrD,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,CAAC;CAgCvD"}

package/dist/connectors/{typesense → search}/models/base.js

@@ -29,7 +29,7 @@ class BaseSearchEntity extends models_1.AbstractEntity {
             });
         }
         if (this.schema !== ctor.schema) {
-            return BaseSearchEntity._deriveSchema({ definition: this.schema, type: opts.type });
+            return (0, zod_derivation_1.deriveSearchDocumentSchema)({ definition: this.schema, type: opts.type });
         }
         let byType = BaseSearchEntity._schemaCache.get(ctor);
         if (!byType) {
@@ -40,24 +40,10 @@ class BaseSearchEntity extends models_1.AbstractEntity {
         if (cached) {
             return cached;
         }
-        const derived = BaseSearchEntity._deriveSchema({ definition: this.schema, type: opts.type });
+        const derived = (0, zod_derivation_1.deriveSearchDocumentSchema)({ definition: this.schema, type: opts.type });
         byType.set(opts.type, derived);
         return derived;
     }
-    static _deriveSchema(opts) {
-        switch (opts.type) {
-            case models_1.SchemaTypes.SELECT:
-            case models_1.SchemaTypes.CREATE:
-            case models_1.SchemaTypes.UPDATE: {
-                return (0, zod_derivation_1.deriveSearchDocumentSchema)({ definition: opts.definition, type: opts.type });
-            }
-            default: {
-                throw (0, ignis_helpers_1.getError)({
-                    message: `[BaseSearchEntity] Invalid schema type | type: ${opts.type} | valid: ${[models_1.SchemaTypes.SELECT, models_1.SchemaTypes.UPDATE, models_1.SchemaTypes.CREATE]}`,
-                });
-            }
-        }
-    }
 }
 exports.BaseSearchEntity = BaseSearchEntity;
 //# sourceMappingURL=base.js.map

package/dist/connectors/search/models/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/connectors/search/models/base.ts"],"names":[],"mappings":";;;AACA,0DAAkD;AAGlD,0CAA+C;AAE/C,qDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,gBAEX,SAAQ,uBAAc;aAaE,iBAAY,GAAG,IAAI,GAAG,EAA4C,CAAC;IAE3F,YAAY,IAAyC;QACnD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAiC,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;QAElF,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhB,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAK,IAAI,CAAC,MAAiB,CAAC;IACxD,CAAC;IAED,SAAS,CAAc,IAA2B;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAsC,CAAC;QAEzD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAmB,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,4DAA4D,IAAI,CAAC,IAAI,yFAAyF;aACxK,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO,IAAA,2CAA0B,EAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAM,CAAC;QACvF,CAAC;QAED,IAAI,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;YAC9C,gBAAgB,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAW,CAAC;QACrB,CAAC;QAED,MAAM,OAAO,GAAG,IAAA,2CAA0B,EAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACzF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAY,CAAC;IACtB,CAAC;;AAzDH,4CA0DC"}