@venizia/ignis 0.1.1-9 → 0.2.0-0

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

@@ -1,188 +0,0 @@
-import type { IImportResult, ISearchCollectionScoped, ISearchDocumentScoped, ISearchResult, ISearchSwapScoped, ISearchSynonymScoped } from '../../connectors/search';
-import { BaseSearchConnector } from '../../connectors/search';
-import type { ISynonym } from '../../connectors/search/models';
-import { Meilisearch } from 'meilisearch';
-import type { IMeilisearchIndexPlan } from './compiler';
-import type { IMeilisearchConnectorOptions } from './types';
-interface IMeilisearchTask {
-    taskUid: number;
-    status: string;
-    error?: unknown;
-    /** A finished task reports what it actually did, e.g. `deletedDocuments` on a documentDeletion. */
-    details?: Record<string, unknown>;
-}
-interface IMeilisearchDocumentsPage {
-    results: unknown[];
-    total: number;
-}
-/** Narrow structural view of the client surface this connector needs - the real client and the in-test fake both satisfy it. */
-interface IMeilisearchIndexApi {
-    addDocuments(documents: unknown[], options?: unknown): Promise<IMeilisearchTask>;
-    updateDocuments(documents: unknown[], options?: unknown): Promise<IMeilisearchTask>;
-    getDocument(id: string, options?: unknown): Promise<unknown>;
-    getDocuments(params: unknown): Promise<IMeilisearchDocumentsPage>;
-    deleteDocument(id: string): Promise<IMeilisearchTask>;
-    deleteDocuments(params: unknown): Promise<IMeilisearchTask>;
-    deleteAllDocuments(): Promise<IMeilisearchTask>;
-    search(query: string | null, params?: unknown): Promise<unknown>;
-    updateSettings(settings: unknown): Promise<IMeilisearchTask>;
-    getSettings(): Promise<Record<string, unknown>>;
-    updateSynonyms(synonyms: Record<string, string[]>): Promise<IMeilisearchTask>;
-    resetSynonyms(): Promise<IMeilisearchTask>;
-}
-export interface IMeilisearchClientLike {
-    index(uid: string): IMeilisearchIndexApi;
-    createIndex(uid: string, options?: unknown): Promise<IMeilisearchTask>;
-    getIndex(uid: string): Promise<unknown>;
-    getIndexes(params?: unknown): Promise<{
-        results: unknown[];
-    }>;
-    deleteIndex(uid: string): Promise<IMeilisearchTask>;
-    swapIndexes(pairs: Array<{
-        indexes: string[];
-    }>): Promise<IMeilisearchTask>;
-    getTask(taskUid: number): Promise<IMeilisearchTask>;
-    health(): Promise<{
-        status: string;
-    }>;
-    multiSearch(params: unknown): Promise<unknown>;
-}
-/** Meilisearch-backed search connector. Every write awaits its task, so `create()` resolves only once the document is retrievable. */
-export declare class MeilisearchConnector extends BaseSearchConnector {
-    private readonly client;
-    private readonly rawClient?;
-    private readonly taskTimeoutMs;
-    private readonly taskIntervalMs;
-    private readonly primaryKeyByCollection;
-    constructor(opts: IMeilisearchConnectorOptions & {
-        client?: IMeilisearchClientLike;
-    });
-    /** The raw SDK client - the escape hatch for anything this connector does not model (fire-and-forget writes, federation, facet search). */
-    getClient(): Meilisearch;
-    protected isNotFoundError(opts: {
-        error: unknown;
-    }): boolean;
-    readonly collection: ISearchCollectionScoped<IMeilisearchIndexPlan, unknown, never>;
-    /** Meilisearch has no alias layer; a zero-downtime reindex swaps two index uids atomically. */
-    readonly swap: ISearchSwapScoped;
-    /** A flat per-index dictionary. There is no named, linkable synonym-set resource. */
-    readonly synonyms: ISearchSynonymScoped;
-    readonly document: ISearchDocumentScoped;
-    getHealth(): Promise<{
-        ok: boolean;
-    }>;
-    /** Writes are invisible until their task succeeds; polls manually against a caller-configured ceiling because the SDK's own `waitForTask` 5 s default is too short for bulk imports. */
-    private waitForTask;
-    /** Runs the write, awaits its task, and returns the FINISHED task so callers reading `details` (`deletedDocuments`) get the terminal record. */
-    private awaitWrite;
-    createCollection(opts: {
-        schema: IMeilisearchIndexPlan;
-    }): Promise<void>;
-    /** Create-if-absent, then apply settings. Both steps await their task, so the index is queryable on return. */
-    ensureCollection(opts: {
-        schema: IMeilisearchIndexPlan;
-    }): Promise<unknown>;
-    getCollection(opts: {
-        name: string;
-    }): Promise<unknown>;
-    listCollections(): Promise<unknown[]>;
-    collectionExists(opts: {
-        name: string;
-    }): Promise<boolean>;
-    /** Meilisearch is schemaless: there is no field schema to patch. Settings are applied by ensureCollection. */
-    patchCollectionSchema(): Promise<void>;
-    deleteCollection(opts: {
-        name: string;
-    }): Promise<boolean>;
-    swapIndexes(opts: {
-        pairs: Array<[string, string]>;
-    }): Promise<void>;
-    setSynonyms(opts: {
-        collection: string;
-        items: ISynonym[];
-    }): Promise<void>;
-    getSynonyms(opts: {
-        collection: string;
-    }): Promise<ISynonym[]>;
-    resetSynonyms(opts: {
-        collection: string;
-    }): Promise<void>;
-    getDocument<T extends object>(opts: {
-        collection: string;
-        id: string;
-    }): Promise<T>;
-    /** Exact and uncapped: `pagination.maxTotalHits` bounds the SEARCH route only, so `total` from `documents/fetch` never lies on large filtered sets. */
-    countDocuments(opts: {
-        collection: string;
-        filterBy?: string;
-    }): Promise<number>;
-    /** Create-only per the neutral contract. `addDocuments` is add-or-REPLACE, so the id is checked first; that check is NOT atomic - concurrent creates can both pass it and the second write wins. Use `upsert` for last-write-wins. */
-    createDocument<T extends object>(opts: {
-        collection: string;
-        document: T;
-    }): Promise<T>;
-    private documentExists;
-    /** Add-or-replace by primary key. Awaits the task, so the document is retrievable when this resolves. */
-    upsertDocument<T extends object>(opts: {
-        collection: string;
-        document: T;
-    }): Promise<T>;
-    /** Merge-update by primary key, preserving absent patch fields. The write returns only a task, so the merged document is read back - NOT atomic: a concurrent write between task success and read-back means the return is not necessarily what this call wrote. */
-    updateDocument<T extends object>(opts: {
-        collection: string;
-        id: string;
-        document: Partial<T>;
-    }): Promise<T>;
-    /** No native update-by-filter (`documents/edit` is experimental and buggy), so ids are paged out of the uncapped `documents/fetch` route and merged back in batches. NOT atomic: a concurrent write to a matched document may be overwritten. */
-    updateByFilter<T extends object>(opts: {
-        collection: string;
-        document: Partial<T>;
-        filterBy: string;
-    }): Promise<{
-        updatedCount: number;
-    }>;
-    /** Walks `documents/fetch` until exhausted. Not bounded by `pagination.maxTotalHits`. */
-    private fetchAllDocuments;
-    private collectMatchingIds;
-    deleteDocument(opts: {
-        collection: string;
-        id: string;
-    }): Promise<boolean>;
-    /** Native delete-by-filter; count is read from the FINISHED task's `details.deletedDocuments` because a pre-count would be wrong under concurrent writes. */
-    deleteByFilter(opts: {
-        collection: string;
-        filterBy: string;
-    }): Promise<number>;
-    deleteAllDocuments(opts: {
-        collection: string;
-    }): Promise<boolean>;
-    /** Re-throws an import failure with partial progress attached. An error the framework already shaped (waitForTask's 504 task_timeout, its task-failed 503, a sanitized 4xx) keeps its statusCode/messageCode - re-wrapping would erase those semantics behind a generic 503, so progress is merged onto it instead. */
-    private throwImportFailure;
-    /** Batches through addDocuments, awaiting each task. Import is batch-atomic, so `count.fail` is always 0 - a batch lands whole or throws, and a thrown import carries `processedCount` in the error's `details` so callers can resume past the batches that already landed. */
-    importDocuments<T extends object>(opts: {
-        collection: string;
-        documents: T[];
-        batchSize?: number;
-    }): Promise<IImportResult<unknown>>;
-    /** Newline-delimited JSON, matching the Typesense connector's export contract. */
-    exportDocuments(opts: {
-        collection: string;
-        filterBy?: string;
-        includeFields?: string[];
-    }): Promise<string>;
-    search<TDocument extends object = object>(opts: {
-        collection: string;
-        params: unknown;
-    }): Promise<ISearchResult<TDocument>>;
-    /** Batched, non-federated: N queries in one round trip, N result sets back. `commonParams` are defaults - a per-query param always wins over them, so a query's own `q` is never clobbered. */
-    multiSearch(opts: {
-        searches: unknown[];
-        union?: boolean;
-        commonParams?: unknown;
-        options?: unknown;
-    }): Promise<unknown>;
-    /** Meilisearch infers the primary key from the first document; the compiler pins it, and the index reports it. */
-    private resolvePrimaryKey;
-}
-export {};
-//# sourceMappingURL=connector.d.ts.map

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

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