@venizia/ignis-connectors 0.2.0-0

package/dist/esm/search/core/repositories/core/base.d.ts

@@ -0,0 +1,91 @@
+import type { ITransaction } from '@venizia/ignis-kernel';
+import type { TFilter, TLockOptions, TWhere } from '@venizia/ignis-kernel';
+import { AbstractRepository } from '@venizia/ignis-kernel';
+import type { AbstractSearchDataSource } from '../../../../search/core/datasources/index.js';
+import type { BaseSearchEntity } from '../../../../search/core/models/index.js';
+import type { TClass } from '@venizia/ignis-helpers/common';
+import type { ISearchQuery, ISearchQueryDialect, TCompiledWhere } from '../../../../search/core/repositories/common/index.js';
+/** Search-repository plumbing on `AbstractRepository`. `TDataSource` carries the concrete connector type through `this.connector`, so a concretely-bound repository reaches its engine's verbs uncast while an engine-agnostic one is forced to write `connector.alias?.…`. */
+export declare abstract class SearchBaseRepository<TDocument extends object = object, TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource> extends AbstractRepository<TDocument, TDocument> {
+    constructor(dataSource?: TDataSource, opts?: {
+        scope?: string;
+        entityClass?: TClass<BaseSearchEntity>;
+    });
+    get dataSource(): TDataSource;
+    set dataSource(value: TDataSource);
+    get entity(): BaseSearchEntity;
+    set entity(value: BaseSearchEntity);
+    get collectionName(): string;
+    protected get connector(): ReturnType<TDataSource['getConnector']>;
+    protected get queryDialect(): ISearchQueryDialect;
+    get multiSearch(): TDataSource['multiSearch'];
+    setDataSource(opts: {
+        dataSource: TDataSource;
+    }): void;
+    /** WRITE responses never pass through the engine's exclude-fields filter, so hiddenProperties are stripped here - the relational branch gets the same guarantee from `.returning(visibleProperties)`. */
+    protected omitHiddenFields<R>(document: R): R;
+    protected omitHiddenFieldsAll<R>(documents: R[]): R[];
+    /** No search engine here has a transaction primitive (this tier is engine-neutral - Typesense and Meilisearch both inherit it) - a caller-supplied options.transaction is rejected loudly instead of silently running outside the transaction the caller expects. */
+    protected assertNoTransaction(opts?: {
+        transaction?: ITransaction;
+    }): void;
+    /** Row-level locking (SELECT ... FOR UPDATE) has no search-engine equivalent - same NotSupported convention as assertNoTransaction. */
+    protected assertNoLock(opts?: {
+        lock?: TLockOptions;
+    }): void;
+    private _collectionFields?;
+    /**
+     * Field names the collection declares, or undefined when it declares none - which means
+     * "unvalidated", not "no fields": an entity carrying no `ISearchCollectionDefinition` must
+     * compile exactly as it did before field checking existed.
+     *
+     * Read from the entity's own typed `schema` rather than by casting into `entity.constructor`;
+     * `BaseSearchEntity.schema` is instance-side and already an `ISearchCollectionDefinition`.
+     * Memoized per repository instance - the definition is frozen after boot.
+     */
+    protected get collectionFields(): ReadonlySet<string> | undefined;
+    /**
+     * Builds a dialect-translated query, always stripping hiddenFields.
+     *
+     * The caller's `where` and the repository-owned `defaultWhere` are compiled SEPARATELY and
+     * combined after, rather than merged into one tree first. Merging first makes the two
+     * indistinguishable, and the repository's own clause would then have to satisfy the
+     * caller-facing field check: `SprocketDocument` in integration-wiring.test.ts declares
+     * [title, secretCode] but carries `defaultFilter: { where: { isActive: true } }`, so every
+     * request through it would 400 ITSELF. Compiling separately makes the trust boundary a matter
+     * of WHICH CALL IS MADE, which - unlike a flag threaded through the recursion - cannot be wrong
+     * at a nested level.
+     */
+    protected buildQuery(opts: {
+        filter?: TFilter;
+        shouldSkipDefaultFilter?: boolean;
+    }): ISearchQuery;
+    /**
+     * Refuses a caller-supplied page larger than this model allows.
+     *
+     * POLICY, and the counterweight to a guardrail this tier removed: an engine used to refuse more
+     * than 250 hits per page, so an unreasonable `limit` failed fast and cheap. Now that such a page
+     * is served, something has to decide when it is unreasonable, and the framework would otherwise
+     * be less safe than before it could satisfy the request.
+     *
+     * It lives in `buildQuery` because that is the one point BOTH `find()` and `search()` pass
+     * through - enforcing in `find()` alone would leave `search()` as a way around it, which is not
+     * a ceiling. `mode: 'raw'` bypasses `buildQuery` and therefore bypasses this deliberately: raw
+     * is the documented escape hatch and its callers own the consequences. They still cannot exceed
+     * the connector's physical ceiling, which is the intended layering - policy is opt-out-able,
+     * physics is not.
+     */
+    protected assertLimitWithinCeiling(opts: {
+        limit?: number;
+    }): void;
+    /**
+     * Compiles the caller clause (field-checked) and the repository-owned default clause
+     * (unchecked), then ANDs them via the dialect - `defaultWhere` first, preserving the order the
+     * previous `{ and: [defaultWhere, where] }` merge produced.
+     */
+    protected compileEffectiveWhere(opts: {
+        where?: TWhere;
+        defaultWhere?: TWhere;
+    }): TCompiledWhere;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/search/core/repositories/core/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/core/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAG3C,+QAA+Q;AAC/Q,8BAAsB,oBAAoB,CACxC,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,WAAW,SAAS,wBAAwB,GAAG,wBAAwB,CACvE,SAAQ,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC;gBAE9C,UAAU,CAAC,EAAE,WAAW,EACxB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAA;KAAE;IAKnE,IAAa,UAAU,IAAI,WAAW,CAErC;IAED,IAAa,UAAU,CAAC,KAAK,EAAE,WAAW,EAEzC;IAED,IAAa,MAAM,IAAI,gBAAgB,CAEtC;IAED,IAAa,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAE1C;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAEjE;IAED,SAAS,KAAK,YAAY,IAAI,mBAAmB,CAEhD;IAED,IAAI,WAAW,IAAI,WAAW,CAAC,aAAa,CAAC,CAE5C;IAEQ,aAAa,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI;IAI/D,yMAAyM;IACzM,SAAS,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAgB7C,SAAS,CAAC,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAQrD,qQAAqQ;IACrQ,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAY1E,uIAAuI;IACvI,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAY5D,OAAO,CAAC,iBAAiB,CAAC,CAAc;IAExC;;;;;;;;OAQG;IACH,SAAS,KAAK,gBAAgB,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAOhE;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE;QACzB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC,GAAG,YAAY;IAoChB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,wBAAwB,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAclE;;;;OAIG;IACH,SAAS,CAAC,qBAAqB,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc;CAiBjG"}

package/dist/esm/search/core/repositories/core/base.js

@@ -0,0 +1,181 @@
+import { AbstractRepository } from '@venizia/ignis-kernel';
+import { DEFAULT_MAX_LIMIT } from '@venizia/ignis-kernel';
+import { SearchErrors } from '../../../../search/core/common/index.js';
+import { getError } from '@venizia/ignis-helpers/core';
+import { throwNotSupported } from '@venizia/ignis-kernel';
+import { SearchFilterOutcomes } from '../../../../search/core/repositories/common/index.js';
+/** Search-repository plumbing on `AbstractRepository`. `TDataSource` carries the concrete connector type through `this.connector`, so a concretely-bound repository reaches its engine's verbs uncast while an engine-agnostic one is forced to write `connector.alias?.…`. */
+export class SearchBaseRepository extends AbstractRepository {
+    constructor(dataSource, opts) {
+        super(dataSource, opts);
+    }
+    get dataSource() {
+        return super.dataSource;
+    }
+    set dataSource(value) {
+        super.dataSource = value;
+    }
+    get entity() {
+        return super.entity;
+    }
+    set entity(value) {
+        super.entity = value;
+    }
+    get collectionName() {
+        return this.entity.name;
+    }
+    get connector() {
+        return this.dataSource.getConnector();
+    }
+    get queryDialect() {
+        return this.dataSource.getQueryDialect();
+    }
+    get multiSearch() {
+        return this.dataSource.multiSearch.bind(this.dataSource);
+    }
+    setDataSource(opts) {
+        super.setDataSource(opts);
+    }
+    /** WRITE responses never pass through the engine's exclude-fields filter, so hiddenProperties are stripped here - the relational branch gets the same guarantee from `.returning(visibleProperties)`. */
+    omitHiddenFields(document) {
+        const hiddenFields = this.hiddenFields;
+        if (hiddenFields.length === 0 || document === null || typeof document !== 'object') {
+            return document;
+        }
+        const visible = { ...document };
+        for (const field of hiddenFields) {
+            delete visible[field];
+        }
+        return visible;
+    }
+    omitHiddenFieldsAll(documents) {
+        if (this.hiddenFields.length === 0) {
+            return documents;
+        }
+        return documents.map(document => this.omitHiddenFields(document));
+    }
+    /** No search engine here has a transaction primitive (this tier is engine-neutral - Typesense and Meilisearch both inherit it) - a caller-supplied options.transaction is rejected loudly instead of silently running outside the transaction the caller expects. */
+    assertNoTransaction(opts) {
+        if (!opts?.transaction) {
+            return;
+        }
+        throwNotSupported({
+            scope: this.dataSource.constructor.name,
+            feature: 'Transactions',
+            logger: this.logger,
+        });
+    }
+    /** Row-level locking (SELECT ... FOR UPDATE) has no search-engine equivalent - same NotSupported convention as assertNoTransaction. */
+    assertNoLock(opts) {
+        if (!opts?.lock) {
+            return;
+        }
+        throwNotSupported({
+            scope: this.dataSource.constructor.name,
+            feature: 'Row-level locking',
+            logger: this.logger,
+        });
+    }
+    /**
+     * Field names the collection declares, or undefined when it declares none - which means
+     * "unvalidated", not "no fields": an entity carrying no `ISearchCollectionDefinition` must
+     * compile exactly as it did before field checking existed.
+     *
+     * Read from the entity's own typed `schema` rather than by casting into `entity.constructor`;
+     * `BaseSearchEntity.schema` is instance-side and already an `ISearchCollectionDefinition`.
+     * Memoized per repository instance - the definition is frozen after boot.
+     */
+    get collectionFields() {
+        if (!this._collectionFields) {
+            const fields = this.entity?.schema?.fields;
+            this._collectionFields = new Set((fields ?? []).map(field => field.name));
+        }
+        return this._collectionFields.size > 0 ? this._collectionFields : undefined;
+    }
+    /**
+     * Builds a dialect-translated query, always stripping hiddenFields.
+     *
+     * The caller's `where` and the repository-owned `defaultWhere` are compiled SEPARATELY and
+     * combined after, rather than merged into one tree first. Merging first makes the two
+     * indistinguishable, and the repository's own clause would then have to satisfy the
+     * caller-facing field check: `SprocketDocument` in integration-wiring.test.ts declares
+     * [title, secretCode] but carries `defaultFilter: { where: { isActive: true } }`, so every
+     * request through it would 400 ITSELF. Compiling separately makes the trust boundary a matter
+     * of WHICH CALL IS MADE, which - unlike a flag threaded through the recursion - cannot be wrong
+     * at a nested level.
+     */
+    buildQuery(opts) {
+        const { filter, shouldSkipDefaultFilter } = opts;
+        const defaultWhere = shouldSkipDefaultFilter ? undefined : this.defaultWhere;
+        this.assertLimitWithinCeiling({ limit: filter?.limit });
+        // `where` is withheld from `build` and compiled below: handing it over merged would field-check
+        // the repository's own clause along with the caller's.
+        const query = this.queryDialect.build({
+            filter: filter ? { ...filter, where: undefined } : undefined,
+            hiddenFields: this.hiddenFields,
+            capabilities: { fields: this.collectionFields },
+        });
+        const compiled = this.compileEffectiveWhere({ where: filter?.where, defaultWhere });
+        switch (compiled.outcome) {
+            case SearchFilterOutcomes.FILTER: {
+                query.filterBy = compiled.filterBy;
+                break;
+            }
+            case SearchFilterOutcomes.MATCH_NONE: {
+                query.matchNone = true;
+                break;
+            }
+            case SearchFilterOutcomes.MATCH_ALL:
+            default: {
+                // Vacuously true - nothing to set and nothing to short-circuit. Spelled out rather than
+                // left as an unwritten else, so all three outcomes are visibly accounted for.
+                break;
+            }
+        }
+        return query;
+    }
+    /**
+     * Refuses a caller-supplied page larger than this model allows.
+     *
+     * POLICY, and the counterweight to a guardrail this tier removed: an engine used to refuse more
+     * than 250 hits per page, so an unreasonable `limit` failed fast and cheap. Now that such a page
+     * is served, something has to decide when it is unreasonable, and the framework would otherwise
+     * be less safe than before it could satisfy the request.
+     *
+     * It lives in `buildQuery` because that is the one point BOTH `find()` and `search()` pass
+     * through - enforcing in `find()` alone would leave `search()` as a way around it, which is not
+     * a ceiling. `mode: 'raw'` bypasses `buildQuery` and therefore bypasses this deliberately: raw
+     * is the documented escape hatch and its callers own the consequences. They still cannot exceed
+     * the connector's physical ceiling, which is the intended layering - policy is opt-out-able,
+     * physics is not.
+     */
+    assertLimitWithinCeiling(opts) {
+        const { limit } = opts;
+        const ceiling = this.maxLimit ?? DEFAULT_MAX_LIMIT;
+        if (limit === undefined || limit <= ceiling) {
+            return;
+        }
+        throw getError({
+            error: SearchErrors.PAGE_TOO_LARGE,
+            message: `[${this.constructor.name}][buildQuery] Requested page exceeds this model's limit | collection: '${this.collectionName}' | requested: ${limit} | maximum: ${ceiling} | raise it with @model settings.maxLimit if larger pages are genuinely needed`,
+        });
+    }
+    /**
+     * Compiles the caller clause (field-checked) and the repository-owned default clause
+     * (unchecked), then ANDs them via the dialect - `defaultWhere` first, preserving the order the
+     * previous `{ and: [defaultWhere, where] }` merge produced.
+     */
+    compileEffectiveWhere(opts) {
+        const { where, defaultWhere } = opts;
+        const dialect = this.queryDialect;
+        const clauses = [];
+        if (defaultWhere) {
+            clauses.push(dialect.compileWhere({ where: defaultWhere }));
+        }
+        if (where) {
+            clauses.push(dialect.compileWhere({ where, capabilities: { fields: this.collectionFields } }));
+        }
+        return dialect.conjoin({ clauses });
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/search/core/repositories/core/base.js.map

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

package/dist/esm/search/core/repositories/core/default.d.ts

@@ -0,0 +1,6 @@
+import type { AbstractSearchDataSource } from '../../../../search/core/datasources/index.js';
+import { PersistableSearchRepository } from './persistable.js';
+/** Full CRUD search-repository tier - convenience alias over `PersistableSearchRepository` (which already carries every write, including delete). */
+export declare class DefaultSearchRepository<TDocument extends object = object, TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource> extends PersistableSearchRepository<TDocument, TDataSource> {
+}
+//# sourceMappingURL=default.d.ts.map

package/dist/esm/search/core/repositories/core/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/core/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAE5D,qJAAqJ;AACrJ,qBAAa,uBAAuB,CAClC,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,WAAW,SAAS,wBAAwB,GAAG,wBAAwB,CACvE,SAAQ,2BAA2B,CAAC,SAAS,EAAE,WAAW,CAAC;CAAG"}

package/dist/esm/search/core/repositories/core/default.js

@@ -0,0 +1,5 @@
+import { PersistableSearchRepository } from './persistable.js';
+/** Full CRUD search-repository tier - convenience alias over `PersistableSearchRepository` (which already carries every write, including delete). */
+export class DefaultSearchRepository extends PersistableSearchRepository {
+}
+//# sourceMappingURL=default.js.map

package/dist/esm/search/core/repositories/core/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/core/default.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAE5D,qJAAqJ;AACrJ,MAAM,OAAO,uBAGX,SAAQ,2BAAmD;CAAG"}

package/dist/esm/search/core/repositories/core/index.d.ts

@@ -0,0 +1,6 @@
+export { SearchBaseRepository as TypesenseBaseRepository } from './base.js';
+export * from './base.js';
+export * from './readable.js';
+export * from './persistable.js';
+export * from './default.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/search/core/repositories/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,IAAI,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACzE,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/dist/esm/search/core/repositories/core/index.js

@@ -0,0 +1,6 @@
+export { SearchBaseRepository as TypesenseBaseRepository } from './base.js';
+export * from './base.js';
+export * from './readable.js';
+export * from './persistable.js';
+export * from './default.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/search/core/repositories/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,IAAI,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACzE,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/dist/esm/search/core/repositories/core/persistable.d.ts

@@ -0,0 +1,126 @@
+import type { IdType } from '@venizia/ignis-kernel';
+import type { IExtraOptions, TCount, TWhere } from '@venizia/ignis-kernel';
+import type { AbstractSearchDataSource } from '../../../../search/core/datasources/index.js';
+import type { BaseSearchEntity } from '../../../../search/core/models/index.js';
+import type { TClass } from '@venizia/ignis-helpers/common';
+import type { IImportResult } from '../../../../search/core/index.js';
+import { ReadableSearchRepository } from './readable.js';
+/** Write-tier search-repository - creates/updates through the connector, dialect-translating `where` clauses. */
+export declare class PersistableSearchRepository<TDocument extends object = object, TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource> extends ReadableSearchRepository<TDocument, TDataSource> {
+    constructor(ds?: TDataSource, opts?: {
+        scope?: string;
+        entityClass?: TClass<BaseSearchEntity>;
+    });
+    create(opts: {
+        data: TDocument;
+        options: IExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    create<R = TDocument>(opts: {
+        data: TDocument;
+        options?: IExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    createAll(opts: {
+        data: Array<TDocument>;
+        options: IExtraOptions & {
+            shouldReturn: false;
+            batchSize?: number;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    createAll<R = TDocument>(opts: {
+        data: Array<TDocument>;
+        options?: IExtraOptions & {
+            shouldReturn?: true;
+            batchSize?: number;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+    updateById(opts: {
+        id: IdType;
+        data: Partial<TDocument>;
+        options: IExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    updateById<R = TDocument>(opts: {
+        id: IdType;
+        data: Partial<TDocument>;
+        options?: IExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    /** Count-only: search engines have no RETURNING and no extra read is bolted on, so `data` is always `null` and `shouldReturn` is rejected at the type level - callers wanting the affected documents read them before updating. */
+    updateAll(opts: {
+        data: Partial<TDocument>;
+        where?: TWhere;
+        options?: Omit<IExtraOptions, 'shouldReturn'> & {
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: null;
+    }>;
+    deleteById(opts: {
+        id: IdType;
+        options: IExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteById<R = TDocument>(opts: {
+        id: IdType;
+        options?: IExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    /** Count-only like updateAll: filter-delete when there is an effective where, truncating the whole collection only when neither where nor defaultFilter is present - truncate reports no per-document count, so that path returns { count: 0, data: null }. */
+    deleteAll(opts?: {
+        where?: TWhere;
+        options?: Omit<IExtraOptions, 'shouldReturn'> & {
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: null;
+    }>;
+    /** Bulk import through the neutral document facade. Per-row write `action` is Typesense-only vocabulary - callers needing it use `dataSource.getConnector().importDocuments(...)` directly. */
+    import(opts: {
+        documents: TDocument[];
+        batchSize?: number;
+    }): Promise<IImportResult<unknown>>;
+    /** Resolves filterBy, AND-merging defaultWhere unless shouldSkipDefaultFilter. Returns undefined when there's no effective where - callers decide (updateAll refuses; deleteAll truncates). */
+    protected buildFilterBy(opts: {
+        where?: TWhere;
+        shouldSkipDefaultFilter?: boolean;
+    }): string | undefined;
+    /**
+     * The write-path filter as THREE outcomes, because two of them are catastrophically different
+     * here: `filterBy: undefined` means "no effective where", which `deleteAll` treats as licence to
+     * truncate when `force` is set. An absorbing where must never land there -
+     * `deleteAll({ where: { or: permittedIds.map(...) } })` on an EMPTY permission list has to
+     * delete nothing, not the entire collection. `matchNone` is what keeps the two apart.
+     */
+    protected buildScopedFilter(opts: {
+        where?: TWhere;
+        shouldSkipDefaultFilter?: boolean;
+    }): {
+        filterBy?: string;
+        matchNone: boolean;
+    };
+}
+//# sourceMappingURL=persistable.d.ts.map

package/dist/esm/search/core/repositories/core/persistable.d.ts.map

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

package/dist/esm/search/core/repositories/core/persistable.js

@@ -0,0 +1,183 @@
+import { SearchErrors } from '../../../../search/core/common/index.js';
+import { RepositoryOperationScopes } from '@venizia/ignis-kernel';
+import { getError } from '@venizia/ignis-helpers/core';
+import { ReadableSearchRepository } from './readable.js';
+/** Narrows one `unknown` `IImportResult.responses` row enough to read the per-row `success` flag `createAll` filters on. */
+const isImportRowLike = (value) => {
+    return typeof value === 'object' && value !== null;
+};
+/** Write-tier search-repository - creates/updates through the connector, dialect-translating `where` clauses. */
+export class PersistableSearchRepository extends ReadableSearchRepository {
+    constructor(ds, opts) {
+        super(ds, opts);
+        this._operationScope = RepositoryOperationScopes.READ_WRITE;
+    }
+    async create(opts) {
+        this.assertNoTransaction(opts.options);
+        this.assertNoLock(opts.options);
+        const created = await this.connector.document.create({
+            collection: this.collectionName,
+            document: opts.data,
+        });
+        if (opts.options?.shouldReturn === false) {
+            return { count: 1, data: null };
+        }
+        return { count: 1, data: this.omitHiddenFields(created) };
+    }
+    /** Delegates to import(). Typesense's bulk import reports only per-row success/fail with no echoed document, so "created" is the caller's input rows filtered to the accepted ones. */
+    async createAll(opts) {
+        this.assertNoTransaction(opts.options);
+        this.assertNoLock(opts.options);
+        const { data, options } = opts;
+        const rs = await this.import({ documents: data, batchSize: options?.batchSize });
+        if (options?.shouldReturn === false) {
+            return { count: rs.count.success, data: null };
+        }
+        const created = data.filter((_document, index) => {
+            const response = rs.responses[index];
+            return isImportRowLike(response) ? response.success !== false : true;
+        });
+        // `created` is the caller's own input rows (bulk import echoes nothing back), so R is the caller's unchecked assertion, as on the non-hidden path.
+        return { count: rs.count.success, data: this.omitHiddenFieldsAll(created) };
+    }
+    /** Guards against defaultWhere by re-reading via findById first (costs one read; skippable via shouldSkipDefaultFilter). A guard failure throws the same sanitized 404 as a missing document. */
+    async updateById(opts) {
+        this.assertNoTransaction(opts.options);
+        this.assertNoLock(opts.options);
+        const { id, data, options } = opts;
+        if (this.defaultWhere && !options?.shouldSkipDefaultFilter) {
+            const found = await this.findById({ id, options });
+            if (!found) {
+                throw getError({
+                    error: SearchErrors.NOT_FOUND,
+                    message: `[${this.constructor.name}][updateById] Document not found or excluded by the default filter | Collection: ${this.collectionName} | Id: ${id}`,
+                });
+            }
+        }
+        const updated = await this.connector.document.update({
+            collection: this.collectionName,
+            id: String(id),
+            document: data,
+        });
+        if (options?.shouldReturn === false) {
+            return { count: 1, data: null };
+        }
+        return { count: 1, data: this.omitHiddenFields(updated) };
+    }
+    /** Count-only: search engines have no RETURNING and no extra read is bolted on, so `data` is always `null` and `shouldReturn` is rejected at the type level - callers wanting the affected documents read them before updating. */
+    async updateAll(opts) {
+        this.assertNoTransaction(opts.options);
+        this.assertNoLock(opts.options);
+        const { data, where, options } = opts;
+        const { filterBy, matchNone } = this.buildScopedFilter({
+            where,
+            shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
+        });
+        // Checked BEFORE the undefined guard: an absorbing where selects no document, which is a
+        // well-formed request to update nothing - not the "no effective where" the guard refuses.
+        if (matchNone) {
+            return { count: 0, data: null };
+        }
+        if (filterBy === undefined) {
+            throw getError({
+                message: `[${this.constructor.name}][updateAll] DENY to perform | Collection: ${this.collectionName} | No effective where condition (no where and no @model defaultFilter) - refusing an unfiltered bulk update`,
+            });
+        }
+        const result = await this.connector.document.updateBy({
+            collection: this.collectionName,
+            document: data,
+            filterBy,
+        });
+        return { count: result.updatedCount, data: null };
+    }
+    /** Guards against defaultWhere same as updateById: an excluded document reports { count: 0 }, same as a genuinely missing one. Skippable via shouldSkipDefaultFilter. */
+    async deleteById(opts) {
+        this.assertNoTransaction(opts.options);
+        this.assertNoLock(opts.options);
+        const { id, options } = opts;
+        let found = null;
+        if (this.defaultWhere && !options?.shouldSkipDefaultFilter) {
+            found = await this.findById({ id, options });
+            if (!found) {
+                return { count: 0, data: null };
+            }
+        }
+        const didDelete = await this.connector.document.delete({
+            collection: this.collectionName,
+            id: String(id),
+        });
+        if (!didDelete) {
+            return { count: 0, data: null };
+        }
+        // Typesense's delete has no RETURNING equivalent - `data` is populated only when the defaultFilter guard above already read the document; no extra read is done for shouldReturn.
+        const data = options?.shouldReturn === false ? null : (found ?? null);
+        return { count: 1, data };
+    }
+    /** Count-only like updateAll: filter-delete when there is an effective where, truncating the whole collection only when neither where nor defaultFilter is present - truncate reports no per-document count, so that path returns { count: 0, data: null }. */
+    async deleteAll(opts) {
+        this.assertNoTransaction(opts?.options);
+        this.assertNoLock(opts?.options);
+        const logger = this.logger.for(this.deleteAll.name);
+        const { where, options } = opts ?? {};
+        const { filterBy, matchNone } = this.buildScopedFilter({
+            where,
+            shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
+        });
+        // Checked BEFORE the undefined guard, and the reason `matchNone` exists as a distinct outcome:
+        // an absorbing where selects no document. Collapsing it to `undefined` would enter the branch
+        // below and, with `force`, TRUNCATE the collection - the exact inversion of what was asked.
+        if (matchNone) {
+            return { count: 0, data: null };
+        }
+        if (filterBy === undefined) {
+            // `where: {}` compiles to NO filter; wiping a collection must be asked for explicitly, exactly as Postgres demands `force` for an empty-where delete.
+            if (!options?.force) {
+                throw getError({
+                    message: `[${this.constructor.name}][deleteAll] DENY to perform | Collection: ${this.collectionName} | No effective where condition (no where and no @model defaultFilter) - pass options.force to truncate the collection`,
+                });
+            }
+            const didTruncate = await this.connector.document.deleteAll({
+                collection: this.collectionName,
+            });
+            logger.warn('TRUNCATED collection on explicit force (engine reports no per-document count) | Collection: %s | Truncated: %s', this.collectionName, didTruncate);
+            return { count: 0, data: null };
+        }
+        const deletedCount = await this.connector.document.deleteBy({
+            collection: this.collectionName,
+            filterBy,
+        });
+        return { count: deletedCount, data: null };
+    }
+    /** Bulk import through the neutral document facade. Per-row write `action` is Typesense-only vocabulary - callers needing it use `dataSource.getConnector().importDocuments(...)` directly. */
+    import(opts) {
+        const { documents, batchSize } = opts;
+        const importOpts = {
+            collection: this.collectionName,
+            documents,
+        };
+        if (batchSize !== undefined) {
+            importOpts.batchSize = batchSize;
+        }
+        return this.connector.document.import(importOpts);
+    }
+    /** Resolves filterBy, AND-merging defaultWhere unless shouldSkipDefaultFilter. Returns undefined when there's no effective where - callers decide (updateAll refuses; deleteAll truncates). */
+    buildFilterBy(opts) {
+        return this.buildScopedFilter(opts).filterBy;
+    }
+    /**
+     * The write-path filter as THREE outcomes, because two of them are catastrophically different
+     * here: `filterBy: undefined` means "no effective where", which `deleteAll` treats as licence to
+     * truncate when `force` is set. An absorbing where must never land there -
+     * `deleteAll({ where: { or: permittedIds.map(...) } })` on an EMPTY permission list has to
+     * delete nothing, not the entire collection. `matchNone` is what keeps the two apart.
+     */
+    buildScopedFilter(opts) {
+        const { where, shouldSkipDefaultFilter } = opts;
+        const query = this.buildQuery({
+            filter: where !== undefined ? { where } : undefined,
+            shouldSkipDefaultFilter,
+        });
+        return { filterBy: query.filterBy, matchNone: query.matchNone === true };
+    }
+}
+//# sourceMappingURL=persistable.js.map