@medusajs/search 0.0.1 → 2.18.0

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AAGtC,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAGD,eAAO,MAAM,0BAA0B,MAAM,CAAA;AAI7C,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,WAAW,CAAC,qBAAqB,CAAA;CACzC,CAAA;AAID,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,qBAAqB,CAAC,EACzD,MAAM,SAAK,GACV,eAAe,EAAE,CAanB;AAQD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,CAAC,qBAAqB,GACvC,OAAO,CAET;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,CAAC,qBAAqB,EACxC,IAAI,EAAE,WAAW,CAAC,eAAe,GAChC,OAAO,CAQT;AAiBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,qBAAqB,CAAC,GACxD,MAAM,EAAE,CAMV;AA2DD,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,KAAK,GACN,EAAE;IACD,KAAK,EAAE,WAAW,CAAC,WAAW,CAAA;IAC9B,KAAK,EAAE,WAAW,CAAC,6BAA6B,CAAA;CACjD,GAAG,WAAW,CAAC,mBAAmB,CAiClC;AA+CD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,WAAW,CAAC,mBAAmB,GACrC;IACD,IAAI,EAAE,WAAW,CAAC,mBAAmB,CAAA;IACrC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,mBAAmB,CAAC,CAAA;CACxD,CA6BA;AAED,wBAAgB,4BAA4B,CAAC,EAC3C,IAAI,EACJ,SAAS,GACV,EAAE;IACD,IAAI,EAAE,WAAW,CAAC,YAAY,CAAA;IAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,CAAA;CACjD,GAAG,WAAW,CAAC,YAAY,CAe3B;AAsBD,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,KAAK,GACN,EAAE;IACD,KAAK,EAAE,WAAW,CAAC,6BAA6B,CAAA;IAGhD,KAAK,EAAE,IAAI,CACT,WAAW,CAAC,WAAW,EACvB,SAAS,GAAG,YAAY,GAAG,gBAAgB,CAC5C,CAAA;CACF,GAAG,IAAI,CA8DP;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,WAAW,EACX,gBAAgB,EAChB,YAAY,GACb,EAAE;IACD,WAAW,EAAE,WAAW,CAAC,qBAAqB,EAAE,CAAA;IAChD,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,aAAa,CAoDhB;AAgED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,6BAA6B,CAa3C;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,CAAC,UAAU,EAC5B,KAAK,EAAE,MAAM,GACZ,WAAW,CAAC,UAAU,CAWxB"}

package/dist/utils/index.js

@@ -1,19 +1,386 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./query-builder"), exports);
-__exportStar(require("./create-partitions"), exports);
-__exportStar(require("./build-config"), exports);
+exports.DEFAULT_REINDEX_BATCH_SIZE = exports.SearchSyncStatus = exports.SearchIndexState = void 0;
+exports.flattenFields = flattenFields;
+exports.isSearchable = isSearchable;
+exports.isFacetable = isFacetable;
+exports.listRetrievablePaths = listRetrievablePaths;
+exports.normalizeSearchQuery = normalizeSearchQuery;
+exports.buildDisjunctiveFacetQueries = buildDisjunctiveFacetQueries;
+exports.mergeDisjunctiveFacetResults = mergeDisjunctiveFacetResults;
+exports.validateFieldUsage = validateFieldUsage;
+exports.resolveIndexDefinitions = resolveIndexDefinitions;
+exports.retrieveIndexDefinition = retrieveIndexDefinition;
+exports.assertTaskAccepted = assertTaskAccepted;
+const utils_1 = require("@medusajs/framework/utils");
+const crypto_1 = require("crypto");
+var SearchIndexState;
+(function (SearchIndexState) {
+    SearchIndexState["PENDING"] = "pending";
+    SearchIndexState["BUILDING"] = "building";
+    SearchIndexState["READY"] = "ready";
+    SearchIndexState["ERROR"] = "error";
+})(SearchIndexState || (exports.SearchIndexState = SearchIndexState = {}));
+var SearchSyncStatus;
+(function (SearchSyncStatus) {
+    SearchSyncStatus["PENDING"] = "pending";
+    SearchSyncStatus["PROCESSING"] = "processing";
+    SearchSyncStatus["DONE"] = "done";
+    SearchSyncStatus["FAILED"] = "failed";
+    SearchSyncStatus["CANCELED"] = "canceled";
+})(SearchSyncStatus || (exports.SearchSyncStatus = SearchSyncStatus = {}));
+const DEFAULT_TAKE = 20;
+exports.DEFAULT_REINDEX_BATCH_SIZE = 100;
+// Walks fields into dotted paths. Object fields yield themselves and their
+// descendants, so `retrievable` can be asked about either.
+function flattenFields(fields, prefix = "") {
+    const flat = [];
+    for (const [name, field] of Object.entries(fields)) {
+        const path = prefix ? `${prefix}.${name}` : name;
+        flat.push({ path, field });
+        if (field.type === "object" && field.fields) {
+            flat.push(...flattenFields(field.fields, path));
+        }
+    }
+    return flat;
+}
+function buildFieldMap(definition) {
+    return new Map(flattenFields(definition.fields).map((f) => [f.path, f]));
+}
+function isSearchable(field) {
+    return field.searchable === true || typeof field.searchable === "object";
+}
+function isFacetable(field, kind) {
+    if (field.facetable === true) {
+        return defaultFacetKinds(field).includes(kind);
+    }
+    if (typeof field.facetable === "object") {
+        return (field.facetable.types ?? defaultFacetKinds(field)).includes(kind);
+    }
+    return false;
+}
+// `stats` is opt-in: it is the least widely supported facet kind, so implying
+// it would make numeric fields unusable on providers that lack aggregations.
+function defaultFacetKinds(field) {
+    switch (field.type) {
+        case "integer":
+        case "float":
+        case "date":
+            return ["range"];
+        default:
+            return ["value"];
+    }
+}
+/**
+ * The dotted paths an index can hand back on hits. Object containers are
+ * excluded — only their declared leaves are stored, so returning the container
+ * would silently hand back a partial object.
+ */
+function listRetrievablePaths(fields) {
+    return flattenFields(fields)
+        .filter(({ field }) => field.type !== "object" && field.retrievable !== false)
+        .map(({ path }) => path);
+}
+// Key order must not change the hash, so object keys are emitted sorted.
+function stableStringify(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value) ?? "null";
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(",")}]`;
+    }
+    const entries = Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+        .map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`);
+    return `{${entries.join(",")}}`;
+}
+/**
+ * Stable hash over what affects the physical index. `events`, `consume` and
+ * `seed` are excluded: how documents are produced is not the index' shape.
+ * `primary_key` and `physical_name` are included even though they are not
+ * strictly shape, because changing either strands the index the record points
+ * at — the mismatch is what makes `db:migrate` rebuild.
+ */
+function buildDefinitionHash(definition) {
+    return (0, crypto_1.createHash)("sha256")
+        .update(stableStringify({
+        fields: definition.fields,
+        settings: definition.settings ?? {},
+        primary_key: definition.primary_key,
+        physical_name: definition.physical_name,
+    }))
+        .digest("hex")
+        .slice(0, 32);
+}
+// Accounts for `index_prefix` and, for a shadow index, the schema suffix.
+function buildPhysicalIndexName({ name, prefix, suffix, }) {
+    return [prefix, name, suffix].filter(Boolean).join("_");
+}
+// Lifts `q` out of the filters, applies pagination defaults, and expands
+// shorthand facets. When `attributes_to_search_on` is omitted the provider
+// matches on every field marked `searchable`.
+function normalizeSearchQuery({ query, index, }) {
+    const filters = { ...(query.filters ?? {}) };
+    // `q` travels with the filters so that a `query.graph` call converts to a
+    // `query.search` one unchanged, but it is not a field — lift it out before the
+    // rest is compiled into a provider filter DSL.
+    const q = filters.q;
+    delete filters.q;
+    const searchOptions = { ...(query.search_options ?? {}) };
+    searchOptions.facets = searchOptions.facets?.map((facet) => typeof facet === "string" ? { field: facet, type: "value" } : facet);
+    return {
+        index,
+        // Taken as given when set: `query.search` has already dropped anything the
+        // index cannot return and left only what the provider should project. A
+        // direct caller that names no fields gets everything retrievable.
+        attributes_to_retrieve: query.fields ?? listRetrievablePaths(index.fields),
+        q,
+        filters: Object.keys(filters).length
+            ? filters
+            : undefined,
+        pagination: {
+            skip: query.pagination?.skip ?? 0,
+            take: query.pagination?.take ?? DEFAULT_TAKE,
+            order: query.pagination?.order,
+            cursor: query.pagination?.cursor,
+        },
+        search_options: searchOptions,
+    };
+}
+// Drops every predicate on `field`, including inside `$and` / `$or` / `$not`.
+function withoutFieldFilter(filters, field) {
+    if (!filters) {
+        return undefined;
+    }
+    const next = {};
+    for (const [key, value] of Object.entries(filters)) {
+        if (key === field) {
+            continue;
+        }
+        if ((key === "$and" || key === "$or") && Array.isArray(value)) {
+            const branches = value
+                .map((branch) => withoutFieldFilter(branch, field))
+                .filter((branch) => branch && Object.keys(branch).length);
+            if (branches.length) {
+                next[key] = branches;
+            }
+            continue;
+        }
+        if (key === "$not") {
+            const stripped = withoutFieldFilter(value, field);
+            if (stripped && Object.keys(stripped).length) {
+                next.$not = stripped;
+            }
+            continue;
+        }
+        next[key] = value;
+    }
+    return Object.keys(next).length
+        ? next
+        : undefined;
+}
+/**
+ * The base query plus one per faceted field with that field's own filter dropped.
+ * Every engine reviewed needs a query per facet, so the fan-out lives here rather
+ * than in each provider. `disjunctive_facets` is stripped from what is handed on —
+ * a provider should never see an option it is not expected to act on.
+ */
+function buildDisjunctiveFacetQueries(query) {
+    const perFacet = new Map();
+    const facets = (query.search_options?.facets ??
+        []);
+    const { disjunctive_facets: _, ...searchOptions } = query.search_options ?? {};
+    const base = {
+        ...query,
+        search_options: searchOptions,
+    };
+    for (const facet of facets) {
+        const relaxed = withoutFieldFilter(query.filters, facet.field);
+        // Nothing filters this field, so the base result's facet is already right.
+        if (stableStringify(relaxed) === stableStringify(query.filters)) {
+            continue;
+        }
+        perFacet.set(facet.field, {
+            ...base,
+            filters: relaxed,
+            // Only the facet is wanted; skip the hits.
+            pagination: { ...query.pagination, skip: 0, take: 0 },
+            search_options: { ...searchOptions, facets: [facet] },
+        });
+    }
+    return { base, per_facet: perFacet };
+}
+function mergeDisjunctiveFacetResults({ base, per_facet, }) {
+    if (!per_facet.size) {
+        return base;
+    }
+    const facets = { ...(base.facets ?? {}) };
+    for (const [field, result] of per_facet) {
+        const relaxed = result.facets?.[field];
+        if (relaxed) {
+            facets[field] = relaxed;
+        }
+    }
+    return { ...base, facets };
+}
+function collectFilterPaths(filters, into = new Set()) {
+    for (const [key, value] of Object.entries(filters)) {
+        if (key === "$and" || key === "$or") {
+            for (const branch of (value ?? [])) {
+                collectFilterPaths(branch, into);
+            }
+        }
+        else if (key === "$not") {
+            collectFilterPaths(value, into);
+        }
+        else {
+            into.add(key);
+        }
+    }
+    return into;
+}
+// Checks a field is declared for the use the query puts it to. Engines reject
+// these too, but with errors that do not name the definition to fix.
+function validateFieldUsage({ index, query, }) {
+    const fieldMap = buildFieldMap(index);
+    const fail = (message) => {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, message);
+    };
+    const lookup = (path, usage) => {
+        const known = fieldMap.get(path);
+        if (!known) {
+            fail(`Unknown field "${path}" used in ${usage} on search index "${index.name}"`);
+        }
+        return known.field;
+    };
+    if (query.filters) {
+        for (const path of collectFilterPaths(query.filters)) {
+            const field = lookup(path, "filters");
+            if (!field.filterable) {
+                fail(`Field "${path}" is not filterable on search index "${index.name}"`);
+            }
+        }
+    }
+    for (const path of Object.keys(query.pagination?.order ?? {})) {
+        if (path === "_score") {
+            continue;
+        }
+        const field = lookup(path, "pagination.order");
+        if (!field.sortable) {
+            fail(`Field "${path}" is not sortable on search index "${index.name}"`);
+        }
+    }
+    for (const facet of query.search_options?.facets ?? []) {
+        const request = typeof facet === "string"
+            ? { field: facet, type: "value" }
+            : facet;
+        const field = lookup(request.field, "search_options.facets");
+        const kind = request.type ?? "value";
+        if (!isFacetable(field, kind)) {
+            fail(`Field "${request.field}" does not support "${kind}" facets on search index "${index.name}"`);
+        }
+    }
+    for (const path of query.search_options?.attributes_to_search_on ?? []) {
+        const field = lookup(path, "search_options.attributes_to_search_on");
+        if (!isSearchable(field)) {
+            fail(`Field "${path}" is not searchable on search index "${index.name}"`);
+        }
+    }
+    if (query.search_options?.distinct) {
+        lookup(query.search_options.distinct, "search_options.distinct");
+    }
+}
+/**
+ * Resolves every definition once, at construction. Duplicates and incoherent
+ * definitions fail here, so everything downstream can treat the result as given.
+ */
+function resolveIndexDefinitions({ definitions, default_provider, index_prefix, }) {
+    const resolved = new Map();
+    for (const definition of definitions) {
+        const primaryKey = definition.primary_key ?? "id";
+        if (!definition.name) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "A search index definition requires a name");
+        }
+        if (resolved.has(definition.name)) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Duplicate search index definition for "${definition.name}"`);
+        }
+        if (!definition.fields?.[primaryKey]) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Search index "${definition.name}" must declare its primary key field "${primaryKey}"`);
+        }
+        const physicalName = buildPhysicalIndexName({
+            name: definition.name,
+            prefix: index_prefix,
+        });
+        const entry = {
+            ...definition,
+            primary_key: primaryKey,
+            provider: definition.provider ?? default_provider,
+            settings: definition.settings ?? {},
+            definition_hash: buildDefinitionHash({
+                fields: definition.fields,
+                settings: definition.settings,
+                primary_key: primaryKey,
+                physical_name: physicalName,
+            }),
+            physical_name: physicalName,
+        };
+        validateIndexDefinition({ definition: entry });
+        resolved.set(entry.name, entry);
+    }
+    return resolved;
+}
+/**
+ * Checks a definition is internally coherent regardless of provider — a field
+ * asking for something that makes no sense for its type. Whether a *particular*
+ * provider can serve it is settled in `upsertIndex`, which runs for every
+ * definition at startup, so it still fails at boot but with a better error.
+ */
+function validateIndexDefinition({ definition, }) {
+    const fail = (message) => {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, `Invalid search index definition "${definition.name}": ${message}`);
+    };
+    const hasEvents = !!definition.events?.length;
+    const hasConsume = !!definition.consume;
+    if (hasEvents && !hasConsume) {
+        fail(`declares "events" but no "consume" to turn them into documents`);
+    }
+    if (hasConsume && !hasEvents) {
+        fail(`declares "consume" but no "events" for it to be called on`);
+    }
+    for (const { path, field } of flattenFields(definition.fields)) {
+        if (field.correlated && !(field.type === "object" && field.array)) {
+            fail(`field "${path}" sets "correlated", which only applies to an array of objects`);
+        }
+        if (field.type === "vector" && !field.dimensions) {
+            fail(`vector field "${path}" must declare its "dimensions"`);
+        }
+        if (field.type === "object" && !field.fields) {
+            fail(`object field "${path}" must declare its "fields"`);
+        }
+        const numeric = ["integer", "float", "date"].includes(field.type);
+        if (isFacetable(field, "range") && !numeric) {
+            fail(`field "${path}" is not numeric, so it cannot have range facets`);
+        }
+        if (isFacetable(field, "stats") && !numeric) {
+            fail(`field "${path}" is not numeric, so it cannot have stats facets`);
+        }
+        if (isSearchable(field) && !["text", "keyword"].includes(field.type)) {
+            fail(`field "${path}" is of type "${field.type}", which cannot be searched as free text`);
+        }
+    }
+}
+function retrieveIndexDefinition(indexes, name) {
+    const definition = indexes.get(name);
+    if (!definition) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_FOUND, `No search index registered for "${name}". Registered indexes: ${[...indexes.keys()].join(", ") || "(none)"}`);
+    }
+    return definition;
+}
+function assertTaskAccepted(task, index) {
+    if (task.status === "failed") {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `Search write failed on index "${index}": ${task.error?.message ?? "unknown error"}`);
+    }
+    return task;
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/dist/utils/ingestion.d.ts

@@ -0,0 +1,12 @@
+import { Event, SearchTypes } from "@medusajs/framework/types";
+import { SearchEventRoutes, SearchIndexes, SearchIngestionRuntime } from "../types";
+export declare function buildEventRoutes(indexes: SearchIndexes): SearchEventRoutes;
+/**
+ * Turns one event into writes. Every write is waited on as far as its provider allows,
+ * so awaiting this is an acknowledgement.
+ */
+export declare function ingestEvent(context: SearchIngestionRuntime, { event, routes }: {
+    event: Event<any>;
+    routes: SearchEventRoutes;
+}): Promise<SearchTypes.SearchTask[]>;
+//# sourceMappingURL=ingestion.d.ts.map

package/dist/utils/ingestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestion.d.ts","sourceRoot":"","sources":["../../src/utils/ingestion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACvB,MAAM,QAAQ,CAAA;AAIf,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAgB1E;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,sBAAsB,EAC/B,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAClE,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CA2CnC"}

package/dist/utils/ingestion.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildEventRoutes = buildEventRoutes;
+exports.ingestEvent = ingestEvent;
+const index_1 = require("./index");
+// Built once so routing a delivered event is a lookup, not a scan.
+function buildEventRoutes(indexes) {
+    const routes = new Map();
+    for (const definition of indexes.values()) {
+        for (const event of definition.events ?? []) {
+            const names = routes.get(event);
+            if (names) {
+                names.push(definition.name);
+            }
+            else {
+                routes.set(event, [definition.name]);
+            }
+        }
+    }
+    return routes;
+}
+/**
+ * Turns one event into writes. Every write is waited on as far as its provider allows,
+ * so awaiting this is an acknowledgement.
+ */
+async function ingestEvent(context, { event, routes }) {
+    const names = routes.get(event.name);
+    // Only reachable by a direct call — the subscriber enrolls in declared events.
+    if (!names?.length) {
+        return [];
+    }
+    const tasks = [];
+    for (const name of names) {
+        const definition = (0, index_1.retrieveIndexDefinition)(context.indexes, name);
+        const provider = context.providers.retrieve(definition.provider);
+        // Resolving a definition rejects `events` without `consume`, so there is one.
+        const mutations = await definition.consume(event, {
+            container: context.container,
+            index: definition,
+        });
+        for (const mutation of mutations) {
+            if (mutation.action === "upsert" && !mutation.documents.length) {
+                continue;
+            }
+            const task = mutation.action === "upsert"
+                ? await provider.upsertDocuments({
+                    index: definition.physical_name,
+                    documents: mutation.documents,
+                })
+                : await provider.deleteDocuments({
+                    index: definition.physical_name,
+                    filters: mutation.filters,
+                });
+            tasks.push(await settleTask(provider, (0, index_1.assertTaskAccepted)(task, name), name));
+        }
+    }
+    return tasks;
+}
+/**
+ * A deferred write is not in the index yet, so waiting is what makes the result an
+ * acknowledgement. Inline providers come back `succeeded` with nothing to wait for.
+ */
+async function settleTask(provider, task, index) {
+    if (task.status === "succeeded" || !provider.waitForTask) {
+        return task;
+    }
+    return (0, index_1.assertTaskAccepted)(await provider.waitForTask(task), index);
+}
+//# sourceMappingURL=ingestion.js.map

package/dist/utils/ingestion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestion.js","sourceRoot":"","sources":["../../src/utils/ingestion.ts"],"names":[],"mappings":";;AASA,4CAgBC;AAMD,kCA8CC;AAvED,mCAAqE;AAErE,mEAAmE;AACnE,SAAgB,gBAAgB,CAAC,OAAsB;IACrD,MAAM,MAAM,GAAsB,IAAI,GAAG,EAAE,CAAA;IAE3C,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAE/B,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,WAAW,CAC/B,OAA+B,EAC/B,EAAE,KAAK,EAAE,MAAM,EAAoD;IAEnE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAEpC,+EAA+E;IAC/E,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAA6B,EAAE,CAAA;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAA,+BAAuB,EAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QAEhE,8EAA8E;QAC9E,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,OAAQ,CAAC,KAAK,EAAE;YACjD,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK,EAAE,UAAU;SAClB,CAAC,CAAA;QAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;gBAC/D,SAAQ;YACV,CAAC;YAED,MAAM,IAAI,GACR,QAAQ,CAAC,MAAM,KAAK,QAAQ;gBAC1B,CAAC,CAAC,MAAM,QAAQ,CAAC,eAAe,CAAC;oBAC7B,KAAK,EAAE,UAAU,CAAC,aAAa;oBAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;iBAC9B,CAAC;gBACJ,CAAC,CAAC,MAAM,QAAQ,CAAC,eAAe,CAAC;oBAC7B,KAAK,EAAE,UAAU,CAAC,aAAa;oBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;iBAC1B,CAAC,CAAA;YAER,KAAK,CAAC,IAAI,CACR,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAA,0BAAkB,EAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CACjE,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,UAAU,CACvB,QAAqC,EACrC,IAA4B,EAC5B,KAAa;IAEb,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,IAAA,0BAAkB,EAAC,MAAM,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAA;AACpE,CAAC"}

package/dist/utils/migrations.d.ts

@@ -0,0 +1,11 @@
+import { SearchTypes } from "@medusajs/framework/types";
+import { SearchIndexRegistry } from "../types";
+/**
+ * The index a schema change is built into. Derived from the definition hash rather
+ * than a job id, so a migration and the boot that finishes it agree on the name
+ * without persisting it, and an interrupted build is resumed rather than orphaned.
+ */
+export declare function shadowIndexName(definition: SearchTypes.ResolvedSearchIndexDefinition): string;
+export declare function createIndexMigrationPlan(context: SearchIndexRegistry): Promise<SearchTypes.SearchIndexMigrationAction[]>;
+export declare function executeIndexMigrationPlan(context: SearchIndexRegistry, actions: SearchTypes.SearchIndexMigrationAction[]): Promise<void>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/utils/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/utils/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAG5C;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,WAAW,CAAC,6BAA6B,GACpD,MAAM,CAIR;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,0BAA0B,EAAE,CAAC,CAyDnD;AAGD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,WAAW,CAAC,0BAA0B,EAAE,GAChD,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/utils/migrations.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shadowIndexName = shadowIndexName;
+exports.createIndexMigrationPlan = createIndexMigrationPlan;
+exports.executeIndexMigrationPlan = executeIndexMigrationPlan;
+const index_1 = require("./index");
+/**
+ * The index a schema change is built into. Derived from the definition hash rather
+ * than a job id, so a migration and the boot that finishes it agree on the name
+ * without persisting it, and an interrupted build is resumed rather than orphaned.
+ */
+function shadowIndexName(definition) {
+    // `physical_name` already carries the module's index prefix, so appending the
+    // schema fingerprint is enough — the prefix never has to be passed in.
+    return `${definition.physical_name}_${definition.definition_hash.slice(0, 8)}`;
+}
+async function createIndexMigrationPlan(context) {
+    const definitions = [...context.indexes.values()];
+    if (!definitions.length) {
+        return [];
+    }
+    const records = await context.indexService.list({ name: definitions.map((definition) => definition.name) }, { take: null });
+    const byName = new Map(records.map((record) => [record.name, record]));
+    return definitions.map((definition) => {
+        const record = byName.get(definition.name);
+        const shared = {
+            index: definition.name,
+            definition_hash: definition.definition_hash,
+        };
+        if (!record) {
+            return {
+                ...shared,
+                action: "create",
+                physical_name: definition.physical_name,
+            };
+        }
+        // A provider change with an untouched schema drifts too: the hash still
+        // matches, but no physical index exists on the new provider yet.
+        if (record.definition_hash === definition.definition_hash &&
+            record.provider === definition.provider) {
+            return {
+                ...shared,
+                action: "noop",
+                physical_name: definition.physical_name,
+            };
+        }
+        const provider = context.providers.retrieve(definition.provider);
+        return {
+            ...shared,
+            action: "migrate",
+            // With an alias, build the new schema alongside and swap it in once
+            // seeded. Without one there is nowhere to build, so the live index is
+            // replaced and stays empty until the seed at application start.
+            physical_name: provider.swapIndex
+                ? shadowIndexName(definition)
+                : definition.physical_name,
+            live_physical_name: definition.physical_name,
+            live_definition_hash: record.definition_hash,
+        };
+    });
+}
+// Note: Seeding data is done by the application start hook, migrations are reserved for schema changes.
+async function executeIndexMigrationPlan(context, actions) {
+    for (const action of actions) {
+        if (action.action === "noop") {
+            continue;
+        }
+        const definition = (0, index_1.retrieveIndexDefinition)(context.indexes, action.index);
+        const provider = context.providers.retrieve(definition.provider);
+        if (action.action === "create") {
+            await provider.upsertIndex({ index: definition });
+            await context.indexService.create([
+                {
+                    name: definition.name,
+                    provider: definition.provider,
+                    // Created but not filled; the seed at startup makes it ready.
+                    status: index_1.SearchIndexState.PENDING,
+                    definition_hash: definition.definition_hash,
+                },
+            ]);
+            continue;
+        }
+        await provider.upsertIndex({
+            index: { ...definition, physical_name: action.physical_name },
+        });
+        // The record deliberately keeps the old hash — that mismatch is what tells
+        // application start there is a seed to finish. But when the build replaced
+        // the live index rather than standing beside it, the index now holds
+        // nothing, so the record should stop claiming it is ready.
+        if (action.physical_name === action.live_physical_name) {
+            await context.indexService.update({
+                selector: { name: definition.name },
+                data: { status: index_1.SearchIndexState.PENDING },
+            });
+        }
+    }
+}
+//# sourceMappingURL=migrations.js.map

package/dist/utils/migrations.js.map

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