@venizia/ignis 0.0.10-5 → 0.1.0

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

@@ -0,0 +1,33 @@
+"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 });
+exports.supabaseAuthAdminRole = exports.serviceRole = exports.realtimeTopic = exports.realtimeMessages = exports.postgresRole = exports.authUsers = exports.authUid = exports.authenticatedRole = exports.anonRole = void 0;
+__exportStar(require("./pooler"), exports);
+__exportStar(require("./rls"), exports);
+// Supabase's own roles and table definitions, re-exported so a schema author has one import.
+var supabase_1 = require("drizzle-orm/supabase");
+Object.defineProperty(exports, "anonRole", { enumerable: true, get: function () { return supabase_1.anonRole; } });
+Object.defineProperty(exports, "authenticatedRole", { enumerable: true, get: function () { return supabase_1.authenticatedRole; } });
+Object.defineProperty(exports, "authUid", { enumerable: true, get: function () { return supabase_1.authUid; } });
+Object.defineProperty(exports, "authUsers", { enumerable: true, get: function () { return supabase_1.authUsers; } });
+Object.defineProperty(exports, "postgresRole", { enumerable: true, get: function () { return supabase_1.postgresRole; } });
+Object.defineProperty(exports, "realtimeMessages", { enumerable: true, get: function () { return supabase_1.realtimeMessages; } });
+Object.defineProperty(exports, "realtimeTopic", { enumerable: true, get: function () { return supabase_1.realtimeTopic; } });
+Object.defineProperty(exports, "serviceRole", { enumerable: true, get: function () { return supabase_1.serviceRole; } });
+Object.defineProperty(exports, "supabaseAuthAdminRole", { enumerable: true, get: function () { return supabase_1.supabaseAuthAdminRole; } });
+// Reachable only via `@venizia/ignis/postgres/supabase`. `connectors/postgres/index.ts` must not
+// re-export this module, or every entry point would pull in `drizzle-orm/supabase`.
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/supabase/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,wCAAsB;AAEtB,6FAA6F;AAC7F,iDAU8B;AAT5B,oGAAA,QAAQ,OAAA;AACR,6GAAA,iBAAiB,OAAA;AACjB,mGAAA,OAAO,OAAA;AACP,qGAAA,SAAS,OAAA;AACT,wGAAA,YAAY,OAAA;AACZ,4GAAA,gBAAgB,OAAA;AAChB,yGAAA,aAAa,OAAA;AACb,uGAAA,WAAW,OAAA;AACX,iHAAA,qBAAqB,OAAA;AAGvB,iGAAiG;AACjG,oFAAoF"}

package/dist/connectors/postgres/supabase/pooler.d.ts

@@ -0,0 +1,27 @@
+import type { TConstValue } from '@venizia/ignis-helpers';
+/** How the app reaches Supabase. Direct and session pooler are 5432; transaction pooler is 6543. */
+export declare class PoolerModes {
+    static readonly DIRECT = "direct";
+    static readonly SESSION = "session";
+    static readonly TRANSACTION = "transaction";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): value is TPoolerMode;
+}
+export type TPoolerMode = TConstValue<typeof PoolerModes>;
+export interface IPostgresJsOptions {
+    prepare: boolean;
+    max?: number;
+}
+/**
+ * Supavisor's TRANSACTION pool mode rebinds the backend connection per transaction, so a server-side
+ * prepared statement created on one backend will not exist on the next. `prepare: false` is not a
+ * tuning knob there - it is required.
+ *
+ * `max` is forwarded only when supplied: postgres-js has its own default, and inventing one here
+ * would silently override it.
+ */
+export declare const buildPostgresJsOptions: (opts: {
+    mode: TPoolerMode;
+    max?: number;
+}) => IPostgresJsOptions;
+//# sourceMappingURL=pooler.d.ts.map

package/dist/connectors/postgres/supabase/pooler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pooler.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/supabase/pooler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,oGAAoG;AACpG,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAkE;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAC3C,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,kBAgBH,CAAC"}

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPostgresJsOptions = exports.PoolerModes = void 0;
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+/** How the app reaches Supabase. Direct and session pooler are 5432; transaction pooler is 6543. */
+class PoolerModes {
+    static { this.DIRECT = 'direct'; }
+    static { this.SESSION = 'session'; }
+    static { this.TRANSACTION = 'transaction'; }
+    static { this.SCHEME_SET = new Set([this.DIRECT, this.SESSION, this.TRANSACTION]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.PoolerModes = PoolerModes;
+/**
+ * Supavisor's TRANSACTION pool mode rebinds the backend connection per transaction, so a server-side
+ * prepared statement created on one backend will not exist on the next. `prepare: false` is not a
+ * tuning knob there - it is required.
+ *
+ * `max` is forwarded only when supplied: postgres-js has its own default, and inventing one here
+ * would silently override it.
+ */
+const buildPostgresJsOptions = (opts) => {
+    const { mode, max } = opts;
+    if (!PoolerModes.isValid(mode)) {
+        throw (0, ignis_helpers_1.getError)({
+            message: `[buildPostgresJsOptions] Unknown pooler mode '${mode}' | Expected one of: ${[...PoolerModes.SCHEME_SET].join(', ')}`,
+        });
+    }
+    const options = { prepare: mode !== PoolerModes.TRANSACTION };
+    if (max !== undefined) {
+        options.max = max;
+    }
+    return options;
+};
+exports.buildPostgresJsOptions = buildPostgresJsOptions;
+//# sourceMappingURL=pooler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pooler.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/supabase/pooler.ts"],"names":[],"mappings":";;;AACA,0DAAkD;AAElD,oGAAoG;AACpG,MAAa,WAAW;aACN,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aACpB,gBAAW,GAAG,aAAa,CAAC;aAE5B,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AATH,kCAUC;AASD;;;;;;;GAOG;AACI,MAAM,sBAAsB,GAAG,CAAC,IAGtC,EAAsB,EAAE;IACvB,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3B,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAA,wBAAQ,EAAC;YACb,OAAO,EAAE,iDAAiD,IAAI,wBAAwB,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC/H,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAuB,EAAE,OAAO,EAAE,IAAI,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC;IAElF,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;IACpB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAnBW,QAAA,sBAAsB,0BAmBjC"}

package/dist/connectors/postgres/supabase/rls.d.ts

@@ -0,0 +1,17 @@
+import type { IDatabaseTransaction } from '../../../connectors/postgres/datasources';
+/**
+ * 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.
+ */
+export declare const withAuthContext: (opts: {
+    transaction: IDatabaseTransaction;
+    claims: Record<string, unknown>;
+    role?: string;
+}) => Promise<void>;
+//# sourceMappingURL=rls.d.ts.map

package/dist/connectors/postgres/supabase/rls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rls.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/supabase/rls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAO9E;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAU,MAAM;IAC1C,WAAW,EAAE,oBAAoB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,KAAG,OAAO,CAAC,IAAI,CAqBf,CAAC"}

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/{typesense → search}/controllers/abstract.d.ts

@@ -18,12 +18,6 @@ export declare abstract class AbstractSearchController<TEntity extends AbstractE
         repository: ReadableSearchRepository<TDataObject>;
         definitions: AnyType;
     });
-    /** Runs a handler task under performance measurement (fixed logger/level/description). */
-    measure<R>(opts: {
-        scope: string;
-        args: unknown;
-        task: () => Promise<R>;
-    }): Promise<any>;
     /** POST /search - single-collection keyword/semantic/hybrid/raw search. */
     search(opts: {
         context: TRouteContext<RouteEnv>;

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/{typesense → search}/controllers/abstract.js

@@ -13,17 +13,6 @@ class AbstractSearchController extends controllers_1.BaseRestController {
         this.repository = opts.repository;
         this.definitions = opts.definitions;
     }
-    /** Runs a handler task under performance measurement (fixed logger/level/description). */
-    measure(opts) {
-        return (0, ignis_helpers_1.executeWithPerformanceMeasure)({
-            logger: this.logger,
-            level: 'debug',
-            scope: opts.scope,
-            description: `execute ${opts.scope}`,
-            args: opts.args,
-            task: opts.task,
-        });
-    }
     /** POST /search - single-collection keyword/semantic/hybrid/raw search. */
     async search(opts) {
         const { context } = opts;
@@ -32,8 +21,10 @@ class AbstractSearchController extends controllers_1.BaseRestController {
             scope: 'search',
             args: input,
             task: async () => {
-                const { found, hits } = await this.repository.search(input);
-                return { found, hits: hits ?? [] };
+                // `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);

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"}