@venizia/ignis 0.0.10-4 → 0.1.0

package/dist/connectors/postgres/supabase/rls.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withAuthContext = void 0;
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const drizzle_orm_1 = require("drizzle-orm");
+/** A bare Postgres role identifier. Anything else cannot be safely interpolated. */
+const ROLE_PATTERN = /^[a-z_][a-z0-9_]*$/;
+/**
+ * Sets the Supabase auth context for the remainder of THIS transaction, so `auth.uid()` resolves in
+ * RLS policies. `SET LOCAL` is transaction-scoped, which is precisely what makes it safe under a
+ * transaction-mode pooler; plain `SET` would leak the identity to the next borrower of the
+ * connection, and is deliberately not offered.
+ *
+ * `role` defaults to the JWT's own `role` claim - PostgREST semantics, and the only default that
+ * cannot contradict `request.jwt.claims`. Pass it explicitly only when the session role must
+ * deliberately differ from the claims.
+ */
+const withAuthContext = async (opts) => {
+    const { transaction, claims } = opts;
+    const roleClaim = claims['role'];
+    const role = opts.role ?? (typeof roleClaim === 'string' ? roleClaim : undefined);
+    // `set local role $1` is not valid SQL, so the role is interpolated. A role taken from a JWT and
+    // interpolated unvalidated would be a privilege-escalation vector. Validated before any statement
+    // runs, so a rejected call leaves the session untouched.
+    if (!role || !ROLE_PATTERN.test(role)) {
+        throw (0, ignis_helpers_1.getError)({
+            message: `[withAuthContext] Invalid role '${role ?? ''}' | Pass role explicitly or include a string 'role' claim | A role must match ${String(ROLE_PATTERN)}`,
+        });
+    }
+    // `claims` IS parameterizable, so it is bound rather than interpolated.
+    await transaction.connector.execute((0, drizzle_orm_1.sql) `select set_config('request.jwt.claims', ${JSON.stringify(claims)}, true)`);
+    await transaction.connector.execute(drizzle_orm_1.sql.raw(`set local role ${role}`));
+};
+exports.withAuthContext = withAuthContext;
+//# sourceMappingURL=rls.js.map

package/dist/connectors/postgres/supabase/rls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rls.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/supabase/rls.ts"],"names":[],"mappings":";;;AACA,0DAAkD;AAClD,6CAAkC;AAElC,oFAAoF;AACpF,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C;;;;;;;;;GASG;AACI,MAAM,eAAe,GAAG,KAAK,EAAE,IAIrC,EAAiB,EAAE;IAClB,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAErC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAElF,iGAAiG;IACjG,kGAAkG;IAClG,yDAAyD;IACzD,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAA,wBAAQ,EAAC;YACb,OAAO,EAAE,mCAAmC,IAAI,IAAI,EAAE,iFAAiF,MAAM,CAAC,YAAY,CAAC,EAAE;SAC9J,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,MAAM,WAAW,CAAC,SAAS,CAAC,OAAO,CACjC,IAAA,iBAAG,EAAA,2CAA2C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAC9E,CAAC;IAEF,MAAM,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAG,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC,CAAC;AAzBW,QAAA,eAAe,mBAyB1B"}

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

@@ -0,0 +1,252 @@
+import type { ISynonym } from '../../connectors/search/models';
+import type { ValueOrPromise } from '@venizia/ignis-helpers';
+import { BaseHelper } from '@venizia/ignis-helpers';
+export interface IImportResult<TResponse = unknown> {
+    count: {
+        success: number;
+        fail: number;
+    };
+    responses: TResponse[];
+}
+export interface IAliasInfo {
+    name: string;
+    collection: string;
+}
+export interface ISearchConnectorCallbacks {
+    onInitialized?: (opts: {
+        name: string;
+    }) => void;
+    onError?: (opts: {
+        name: string;
+        error: unknown;
+    }) => void;
+}
+/**
+ * Search-response envelope - the read-path counterpart to IImportResult, consumed by
+ * ReadableSearchRepository without a boundary cast.
+ *
+ * `score` is the engine's own relevance number (Typesense `text_match`, Meilisearch
+ * `_rankingScore`). The scales are unrelated - never compare or threshold one against the other.
+ * `isFoundExact` is false when the engine reports an approximate `found`.
+ */
+export interface ISearchResult<DocumentType extends object = object, HighlightType = unknown, FacetCountType = unknown, GroupedHitType = unknown> {
+    found: number;
+    isFoundExact: boolean;
+    outOf?: number;
+    searchTimeMs?: number;
+    hits?: Array<{
+        document: DocumentType;
+        highlight?: HighlightType;
+        highlights?: HighlightType[];
+        score?: number;
+    }>;
+    facetCounts?: FacetCountType[];
+    groupedHits?: GroupedHitType[];
+}
+export interface ISearchCollectionScoped<CreateSchema = unknown, Schema = unknown, FieldSchema = unknown> {
+    create(opts: {
+        schema: CreateSchema;
+    }): Promise<Schema | void>;
+    ensure(opts: {
+        schema: CreateSchema;
+    }): Promise<Schema>;
+    get(opts: {
+        name: string;
+    }): Promise<Schema>;
+    list(): Promise<Schema[]>;
+    exists(opts: {
+        name: string;
+    }): Promise<boolean>;
+    patchSchema(opts: {
+        name: string;
+        fields: FieldSchema[];
+    }): Promise<void>;
+    delete(opts: {
+        name: string;
+    }): Promise<boolean>;
+}
+/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */
+export interface ISearchAliasScoped {
+    upsert(opts: {
+        name: string;
+        collection: string;
+    }): Promise<void>;
+    get(opts: {
+        name: string;
+    }): Promise<IAliasInfo | null>;
+}
+/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */
+export interface ISearchSwapScoped {
+    indexes(opts: {
+        pairs: Array<[string, string]>;
+    }): Promise<void>;
+}
+export interface ISearchSynonymSetScoped {
+    upsert(opts: {
+        name: string;
+        items: ISynonym[];
+    }): Promise<void>;
+    get(opts: {
+        name: string;
+    }): Promise<ISynonym[] | null>;
+    list(): Promise<string[]>;
+    delete(opts: {
+        name: string;
+    }): Promise<boolean>;
+    link(opts: {
+        collection: string;
+        synonymSets: string[];
+    }): Promise<void>;
+}
+/** A flat per-collection synonym dictionary - no named, linkable set resource. */
+export interface ISearchSynonymScoped {
+    set(opts: {
+        collection: string;
+        items: ISynonym[];
+    }): Promise<void>;
+    get(opts: {
+        collection: string;
+    }): Promise<ISynonym[]>;
+    reset(opts: {
+        collection: string;
+    }): Promise<void>;
+}
+export interface ISearchDocumentScoped {
+    get<T extends object>(opts: {
+        collection: string;
+        id: string;
+    }): Promise<T>;
+    /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates
+     * its total must answer this from a document-listing endpoint instead, so the count never lies. */
+    count(opts: {
+        collection: string;
+        filterBy?: string;
+    }): Promise<number>;
+    create<T extends object>(opts: {
+        collection: string;
+        document: T;
+    }): Promise<T>;
+    upsert<T extends object>(opts: {
+        collection: string;
+        document: T;
+    }): Promise<T>;
+    update<T extends object>(opts: {
+        collection: string;
+        id: string;
+        document: Partial<T>;
+    }): Promise<T>;
+    updateBy<T extends object>(opts: {
+        collection: string;
+        document: Partial<T>;
+        filterBy: string;
+    }): Promise<{
+        updatedCount: number;
+    }>;
+    delete(opts: {
+        collection: string;
+        id: string;
+    }): Promise<boolean>;
+    deleteBy(opts: {
+        collection: string;
+        filterBy: string;
+    }): Promise<number>;
+    deleteAll(opts: {
+        collection: string;
+    }): Promise<boolean>;
+    import<T extends object>(opts: {
+        collection: string;
+        documents: T[];
+        batchSize?: number;
+    }): Promise<IImportResult<unknown>>;
+    export(opts: {
+        collection: string;
+        filterBy?: string;
+        includeFields?: string[];
+    }): Promise<string>;
+}
+/**
+ * The verb contract every search engine implements. `collection` and `document` are the true
+ * intersection. `alias`/`synonymSet`/`synonyms`/`swap` are optional because no engine has all four,
+ * so an engine-agnostic caller is forced by the compiler to write `connector.alias?.…`, while a
+ * repository bound to a concrete datasource sees that connector's required members and needs no
+ * narrowing. Kept as an interface so tests can fake one without a real engine client.
+ */
+export interface ISearchConnector {
+    getHealth(): Promise<{
+        ok: boolean;
+    }>;
+    ping(): Promise<boolean>;
+    collection: ISearchCollectionScoped;
+    document: ISearchDocumentScoped;
+    alias?: ISearchAliasScoped;
+    synonymSet?: ISearchSynonymSetScoped;
+    synonyms?: ISearchSynonymScoped;
+    swap?: ISearchSwapScoped;
+    search<TDocument extends object = object>(opts: {
+        collection: string;
+        params: unknown;
+    }): Promise<ISearchResult<TDocument>>;
+    multiSearch(opts: {
+        searches: unknown[];
+        union?: boolean;
+        commonParams?: unknown;
+        options?: unknown;
+    }): Promise<unknown>;
+}
+export declare abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {
+    constructor(opts: {
+        scope: string;
+        identifier: string;
+    });
+    ping(): Promise<boolean>;
+    protected assertNonEmpty(opts: {
+        value?: string | null;
+        name: string;
+        method: string;
+    }): void;
+    protected runEngineCall<T>(opts: {
+        method: string;
+        run: () => ValueOrPromise<T>;
+        tolerate?: {
+            when: (error: unknown) => boolean;
+            handle: (error: unknown) => ValueOrPromise<T>;
+        };
+    }): Promise<T>;
+    /** Which errors mean "not found" is engine-specific classification; the sanitized throw and the benign fallback are not. */
+    protected abstract isNotFoundError(opts: {
+        error: unknown;
+    }): boolean;
+    /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */
+    protected notFoundTolerance(opts: {
+        method: string;
+        subject: string;
+    }): {
+        when: (error: unknown) => boolean;
+        handle: (error: unknown) => never;
+    };
+    /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */
+    protected notFoundFallback<T>(opts: {
+        method: string;
+        message: string;
+        args?: unknown[];
+        fallback: T;
+    }): {
+        when: (error: unknown) => boolean;
+        handle: (error: unknown) => T;
+    };
+    abstract getHealth(): Promise<{
+        ok: boolean;
+    }>;
+    abstract collection: ISearchCollectionScoped;
+    abstract document: ISearchDocumentScoped;
+    abstract search<TDocument extends object = object>(opts: {
+        collection: string;
+        params: unknown;
+    }): Promise<ISearchResult<TDocument>>;
+    abstract multiSearch(opts: {
+        searches: unknown[];
+        union?: boolean;
+        commonParams?: unknown;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=connector.d.ts.map

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

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

package/dist/connectors/search/connector.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSearchConnector = void 0;
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const internal_1 = require("./internal");
+class BaseSearchConnector extends ignis_helpers_1.BaseHelper {
+    constructor(opts) {
+        super(opts);
+    }
+    async ping() {
+        const health = await this.getHealth();
+        return health.ok;
+    }
+    assertNonEmpty(opts) {
+        const { value, name, method } = opts;
+        if (!value || value.trim().length === 0) {
+            throw (0, ignis_helpers_1.getError)({ message: `[${method}] Missing or empty value | name: ${name}` });
+        }
+    }
+    // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.
+    async runEngineCall(opts) {
+        const { method, run, tolerate } = opts;
+        try {
+            const rs = await run();
+            return rs;
+        }
+        catch (error) {
+            if (tolerate?.when(error)) {
+                const rs = await tolerate.handle(error);
+                return rs;
+            }
+            // An ApplicationError was raised by the framework, not the engine: it is already sanitized and
+            // carries its own statusCode/messageCode (a task timeout, a not-supported verb). Re-wrapping it
+            // as a generic 503 would destroy that. Only raw engine failures get sanitized here.
+            if ((0, ignis_helpers_1.isApplicationError)(error)) {
+                throw error;
+            }
+            internal_1.SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });
+        }
+    }
+    /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */
+    notFoundTolerance(opts) {
+        const { method, subject } = opts;
+        return {
+            when: error => this.isNotFoundError({ error }),
+            handle: () => {
+                this.logger.for(method).debug('%s not found', subject);
+                internal_1.SearchConnectorInternal.throwNotFoundError({ method, subject });
+            },
+        };
+    }
+    /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */
+    notFoundFallback(opts) {
+        const { method, message, args, fallback } = opts;
+        return {
+            when: error => this.isNotFoundError({ error }),
+            handle: () => {
+                this.logger.for(method).debug(message, ...(args ?? []));
+                return fallback;
+            },
+        };
+    }
+}
+exports.BaseSearchConnector = BaseSearchConnector;
+//# sourceMappingURL=connector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../src/connectors/search/connector.ts"],"names":[],"mappings":";;;AAEA,0DAAkF;AAClF,yCAAqD;AA+JrD,MAAsB,mBAAoB,SAAQ,0BAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAA,wBAAQ,EAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,+FAA+F;YAC/F,gGAAgG;YAChG,oFAAoF;YACpF,IAAI,IAAA,kCAAkB,EAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,kCAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAC9C,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,kCAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAC9C,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CAmBF;AAnGD,kDAmGC"}

package/dist/connectors/search/controllers/abstract.d.ts

@@ -0,0 +1,30 @@
+import type { TEntityDataObject, TRouteContext } from '../../../base/controllers';
+import { BaseRestController } from '../../../base/controllers';
+import type { AbstractEntity } from '../../../base/models';
+import type { TAnyObjectSchema } from '../../../utilities/schema.utility';
+import type { AnyType } from '@venizia/ignis-helpers';
+import type { Env, Schema } from 'hono';
+import type { ReadableSearchRepository } from '../repositories/core/readable';
+/**
+ * Base tier of a generated search controller: the repository handle plus the search / multi-search verbs.
+ * SearchControllerFactory returns a thin subclass that only builds route configs and wires them.
+ */
+export declare abstract class AbstractSearchController<TEntity extends AbstractEntity<TAnyObjectSchema> = AbstractEntity<TAnyObjectSchema>, RouteEnv extends Env = Env, RouteSchema extends Schema = {}, BasePath extends string = '/', ConfigurableOptions extends object = {}, TDataObject extends object = TEntityDataObject<TEntity>> extends BaseRestController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions> {
+    repository: ReadableSearchRepository<TDataObject>;
+    constructor(opts: {
+        scope: string;
+        path: string;
+        isStrict?: boolean;
+        repository: ReadableSearchRepository<TDataObject>;
+        definitions: AnyType;
+    });
+    /** POST /search - single-collection keyword/semantic/hybrid/raw search. */
+    search(opts: {
+        context: TRouteContext<RouteEnv>;
+    }): Promise<import("../../../base/controllers").TJsonResponse<unknown, 200>>;
+    /** POST /multi-search - cross-collection search, forwarded verbatim to the engine. */
+    multiSearch(opts: {
+        context: TRouteContext<RouteEnv>;
+    }): Promise<import("../../../base/controllers").TJsonResponse<unknown, 200>>;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/connectors/search/controllers/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAExC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E;;;GAGG;AACH,8BAAsB,wBAAwB,CAC5C,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC,EACnF,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,GAAG,iBAAiB,CAAC,OAAO,CAAC,CACvD,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAChF,UAAU,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;gBAEtC,IAAI,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;QAClD,WAAW,EAAE,OAAO,CAAC;KACtB;IAMD,2EAA2E;IACrE,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;KAAE;IAkBvD,sFAAsF;IAChF,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;KAAE;CAY7D"}

package/dist/connectors/search/controllers/abstract.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractSearchController = void 0;
+const controllers_1 = require("../../../base/controllers");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+/**
+ * Base tier of a generated search controller: the repository handle plus the search / multi-search verbs.
+ * SearchControllerFactory returns a thin subclass that only builds route configs and wires them.
+ */
+class AbstractSearchController extends controllers_1.BaseRestController {
+    constructor(opts) {
+        super({ scope: opts.scope, path: opts.path, isStrict: opts.isStrict });
+        this.repository = opts.repository;
+        this.definitions = opts.definitions;
+    }
+    /** POST /search - single-collection keyword/semantic/hybrid/raw search. */
+    async search(opts) {
+        const { context } = opts;
+        const input = context.req.valid('json');
+        const rs = await this.measure({
+            scope: 'search',
+            args: input,
+            task: async () => {
+                // `isFoundExact` travels to the caller: an engine whose `found` is an estimate must not
+                // look exhaustive once it crosses the HTTP boundary.
+                const { found, isFoundExact, hits } = await this.repository.search(input);
+                return { found, isFoundExact, hits: hits ?? [] };
+            },
+        });
+        return context.json(rs, ignis_helpers_1.HTTP.ResultCodes.RS_2.Ok);
+    }
+    /** POST /multi-search - cross-collection search, forwarded verbatim to the engine. */
+    async multiSearch(opts) {
+        const { context } = opts;
+        const input = context.req.valid('json');
+        const rs = await this.measure({
+            scope: 'multiSearch',
+            args: input,
+            task: () => this.repository.multiSearch(input),
+        });
+        return context.json(rs, ignis_helpers_1.HTTP.ResultCodes.RS_2.Ok);
+    }
+}
+exports.AbstractSearchController = AbstractSearchController;
+//# sourceMappingURL=abstract.js.map

package/dist/connectors/search/controllers/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/abstract.ts"],"names":[],"mappings":";;;AACA,oDAAwD;AAIxD,0DAA8C;AAK9C;;;GAGG;AACH,MAAsB,wBAOpB,SAAQ,gCAAwE;IAGhF,YAAY,IAMX;QACC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,MAAM,CAAC,IAA0C;QACrD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAe,MAAM,CAAC,CAAC;QAEtD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAC5B,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,wFAAwF;gBACxF,qDAAqD;gBACrD,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC1E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;YACnD,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,WAAW,CAAC,IAA0C;QAC1D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAoB,MAAM,CAAC,CAAC;QAE3D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAC5B,KAAK,EAAE,aAAa;YACpB,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC;SAC/C,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AAtDD,4DAsDC"}