@medusajs/search-postgres 2.19.0-snapshot-20260811095123

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +131 -0
  2. package/dist/index.d.ts +3 -0
  3. package/dist/index.d.ts.map +1 -0
  4. package/dist/index.js +9 -0
  5. package/dist/index.js.map +1 -0
  6. package/dist/migrations/Migration20260807120000.d.ts +17 -0
  7. package/dist/migrations/Migration20260807120000.d.ts.map +1 -0
  8. package/dist/migrations/Migration20260807120000.js +56 -0
  9. package/dist/migrations/Migration20260807120000.js.map +1 -0
  10. package/dist/services/postgres-search.d.ts +200 -0
  11. package/dist/services/postgres-search.d.ts.map +1 -0
  12. package/dist/services/postgres-search.js +1054 -0
  13. package/dist/services/postgres-search.js.map +1 -0
  14. package/dist/tsconfig.tsbuildinfo +1 -0
  15. package/dist/utils/documents.d.ts +19 -0
  16. package/dist/utils/documents.d.ts.map +1 -0
  17. package/dist/utils/documents.js +97 -0
  18. package/dist/utils/documents.js.map +1 -0
  19. package/dist/utils/extensions.d.ts +50 -0
  20. package/dist/utils/extensions.d.ts.map +1 -0
  21. package/dist/utils/extensions.js +129 -0
  22. package/dist/utils/extensions.js.map +1 -0
  23. package/dist/utils/facets.d.ts +31 -0
  24. package/dist/utils/facets.d.ts.map +1 -0
  25. package/dist/utils/facets.js +198 -0
  26. package/dist/utils/facets.js.map +1 -0
  27. package/dist/utils/filters.d.ts +17 -0
  28. package/dist/utils/filters.d.ts.map +1 -0
  29. package/dist/utils/filters.js +237 -0
  30. package/dist/utils/filters.js.map +1 -0
  31. package/dist/utils/index.d.ts +6 -0
  32. package/dist/utils/index.d.ts.map +1 -0
  33. package/dist/utils/index.js +22 -0
  34. package/dist/utils/index.js.map +1 -0
  35. package/dist/utils/plan.d.ts +86 -0
  36. package/dist/utils/plan.d.ts.map +1 -0
  37. package/dist/utils/plan.js +238 -0
  38. package/dist/utils/plan.js.map +1 -0
  39. package/package.json +50 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"facets.js","sourceRoot":"","sources":["../../src/utils/facets.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import { SearchTypes } from "@medusajs/framework/types";
2
+ import { IndexPlan } from "./plan";
3
+ export type SqlFragment = {
4
+ sql: string;
5
+ params: unknown[];
6
+ };
7
+ /**
8
+ * Builds a JSONB path expression against the `indexed` column for a dotted
9
+ * field path. `variants.color` becomes `indexed->'variants'->'color'`.
10
+ */
11
+ export declare function jsonbPath(path: string, asText?: boolean): string;
12
+ /**
13
+ * Compiles the filter tree into a SQL boolean expression. Unlike the local
14
+ * provider, `$or` and `$not` are supported — Postgres can express them.
15
+ */
16
+ export declare function toWhereClause(filters: SearchTypes.SearchFilters | undefined, plan: IndexPlan): SqlFragment | undefined;
17
+ //# sourceMappingURL=filters.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/utils/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAgB,MAAM,QAAQ,CAAA;AAMhD,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAe9D;AAyQD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,WAAW,CAAC,aAAa,GAAG,SAAS,EAC9C,IAAI,EAAE,SAAS,GACd,WAAW,GAAG,SAAS,CAmDzB"}
@@ -0,0 +1,237 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.jsonbPath = jsonbPath;
4
+ exports.toWhereClause = toWhereClause;
5
+ const utils_1 = require("@medusajs/framework/utils");
6
+ function fail(message) {
7
+ throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_ALLOWED, message);
8
+ }
9
+ /**
10
+ * Builds a JSONB path expression against the `indexed` column for a dotted
11
+ * field path. `variants.color` becomes `indexed->'variants'->'color'`.
12
+ */
13
+ function jsonbPath(path, asText = false) {
14
+ const segments = path.split(".");
15
+ let expr = "indexed";
16
+ for (let i = 0; i < segments.length; i++) {
17
+ const segment = segments[i].replace(/'/g, "''");
18
+ const isLast = i === segments.length - 1;
19
+ if (isLast && asText) {
20
+ expr += `->>'${segment}'`;
21
+ }
22
+ else {
23
+ expr += `->'${segment}'`;
24
+ }
25
+ }
26
+ return expr;
27
+ }
28
+ function castScalar(planned, value) {
29
+ if (value === null || value === undefined) {
30
+ return null;
31
+ }
32
+ switch (planned.kind) {
33
+ case "number": {
34
+ const num = planned.is_date && value instanceof Date
35
+ ? value.getTime()
36
+ : typeof value === "number"
37
+ ? value
38
+ : Number(value);
39
+ if (Number.isNaN(num)) {
40
+ fail(`Cannot cast filter value for "${planned.path}" to a number`);
41
+ }
42
+ return num;
43
+ }
44
+ case "boolean":
45
+ if (typeof value === "boolean") {
46
+ return value;
47
+ }
48
+ if (value === "true" || value === "false") {
49
+ return value === "true";
50
+ }
51
+ return Boolean(value);
52
+ default:
53
+ return typeof value === "string" ? value : String(value);
54
+ }
55
+ }
56
+ function nextParam(params, value) {
57
+ params.push(value);
58
+ return `?`;
59
+ }
60
+ /**
61
+ * Builds `"indexed" @> '{"a":{"b":<leaf>}}'` for a dotted path. Containment is
62
+ * the one predicate the `jsonb_path_ops` GIN index accelerates, it compares
63
+ * numbers and booleans natively (unlike `?|`, which only matches string array
64
+ * elements), and on a collapsed leaf array it means "array contains".
65
+ */
66
+ function containmentSql(path, leaf, params) {
67
+ const doc = path
68
+ .split(".")
69
+ .reduceRight((acc, segment) => ({ [segment]: acc }), leaf);
70
+ return `"indexed" @> ${nextParam(params, JSON.stringify(doc))}::jsonb`;
71
+ }
72
+ function existsSql(planned, exists) {
73
+ const expr = jsonbPath(planned.path);
74
+ return exists
75
+ ? `(${expr} IS NOT NULL AND ${expr} <> 'null'::jsonb)`
76
+ : `(${expr} IS NULL OR ${expr} = 'null'::jsonb)`;
77
+ }
78
+ function equalitySql(planned, value, params) {
79
+ const cast = castScalar(planned, value);
80
+ if (cast === null) {
81
+ // `indexed` never stores nulls, so equality with null means absence.
82
+ return existsSql(planned, false);
83
+ }
84
+ const leaf = planned.is_array ? [cast] : cast;
85
+ return containmentSql(planned.path, leaf, params);
86
+ }
87
+ /** Matches when the field equals (or, on arrays, contains) any of the values. */
88
+ function anyOfSql(planned, values, params) {
89
+ if (!values.length) {
90
+ return "FALSE";
91
+ }
92
+ const parts = values.map((value) => equalitySql(planned, value, params));
93
+ return parts.length === 1 ? parts[0] : `(${parts.join(" OR ")})`;
94
+ }
95
+ function comparisonSql(planned, operator, value, params) {
96
+ if (planned.is_array) {
97
+ fail(`Operator "${operator}" is not supported on array field "${planned.path}"`);
98
+ }
99
+ const cast = castScalar(planned, value);
100
+ if (planned.kind === "number") {
101
+ return `(${jsonbPath(planned.path, true)})::float8 ${operator} ${nextParam(params, cast)}`;
102
+ }
103
+ if (planned.kind === "boolean") {
104
+ return `(${jsonbPath(planned.path, true)})::boolean ${operator} ${nextParam(params, cast)}`;
105
+ }
106
+ return `${jsonbPath(planned.path, true)} ${operator} ${nextParam(params, cast)}`;
107
+ }
108
+ function arrayContainsSql(planned, values, mode, params) {
109
+ if (!planned.is_array) {
110
+ fail(`Operator $${mode === "all" ? "contains" : "overlaps"} on "${planned.path}" needs an array field`);
111
+ }
112
+ if (mode === "any") {
113
+ return anyOfSql(planned, values, params);
114
+ }
115
+ // Contains-all is a single containment with every value in the leaf array.
116
+ const castValues = values.map((value) => castScalar(planned, value));
117
+ return containmentSql(planned.path, castValues, params);
118
+ }
119
+ function fieldPredicate(path, raw, plan, params) {
120
+ const planned = plan.fields.get(path);
121
+ if (!planned) {
122
+ fail(`Unknown filter field "${path}" on the postgres search provider`);
123
+ }
124
+ // Shorthand: bare value or list of values. On array fields this means
125
+ // membership ("array contains the value"), matching the local provider.
126
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
127
+ const values = Array.isArray(raw) ? raw : [raw];
128
+ return anyOfSql(planned, values, params);
129
+ }
130
+ const operators = raw;
131
+ const keys = Object.keys(operators).filter((key) => key.startsWith("$"));
132
+ if (!keys.length) {
133
+ fail(`Empty operator map on filter field "${path}"`);
134
+ }
135
+ const parts = [];
136
+ for (const operator of keys) {
137
+ const value = operators[operator];
138
+ switch (operator) {
139
+ case "$eq":
140
+ parts.push(equalitySql(planned, value, params));
141
+ break;
142
+ case "$ne":
143
+ // Documents missing the field satisfy "not equal".
144
+ parts.push(value === null || value === undefined
145
+ ? existsSql(planned, true)
146
+ : `NOT ${equalitySql(planned, value, params)}`);
147
+ break;
148
+ case "$in":
149
+ parts.push(anyOfSql(planned, Array.isArray(value) ? value : [value], params));
150
+ break;
151
+ case "$nin":
152
+ parts.push(`NOT ${anyOfSql(planned, Array.isArray(value) ? value : [value], params)}`);
153
+ break;
154
+ case "$gt":
155
+ parts.push(comparisonSql(planned, ">", value, params));
156
+ break;
157
+ case "$gte":
158
+ parts.push(comparisonSql(planned, ">=", value, params));
159
+ break;
160
+ case "$lt":
161
+ parts.push(comparisonSql(planned, "<", value, params));
162
+ break;
163
+ case "$lte":
164
+ parts.push(comparisonSql(planned, "<=", value, params));
165
+ break;
166
+ case "$exists":
167
+ parts.push(existsSql(planned, Boolean(value)));
168
+ break;
169
+ case "$contains":
170
+ parts.push(arrayContainsSql(planned, Array.isArray(value) ? value : [value], "all", params));
171
+ break;
172
+ case "$overlaps":
173
+ parts.push(arrayContainsSql(planned, Array.isArray(value) ? value : [value], "any", params));
174
+ break;
175
+ case "$prefix":
176
+ case "$like": {
177
+ if (planned.is_array) {
178
+ fail(`Operator "${operator}" is not supported on array field "${path}"`);
179
+ }
180
+ const pattern = operator === "$prefix" ? `${String(value)}%` : String(value);
181
+ parts.push(`${jsonbPath(planned.path, true)} LIKE ${nextParam(params, pattern)}`);
182
+ break;
183
+ }
184
+ default:
185
+ fail(`The postgres search provider does not support operator "${operator}" on "${path}"`);
186
+ }
187
+ }
188
+ return parts.length === 1 ? parts[0] : `(${parts.join(" AND ")})`;
189
+ }
190
+ /**
191
+ * Compiles the filter tree into a SQL boolean expression. Unlike the local
192
+ * provider, `$or` and `$not` are supported — Postgres can express them.
193
+ */
194
+ function toWhereClause(filters, plan) {
195
+ if (!filters) {
196
+ return undefined;
197
+ }
198
+ const params = [];
199
+ const compile = (branch) => {
200
+ const parts = [];
201
+ for (const [key, value] of Object.entries(branch)) {
202
+ if (key === "q") {
203
+ continue;
204
+ }
205
+ if (key === "$and") {
206
+ const nested = (value ?? [])
207
+ .map(compile)
208
+ .filter(Boolean);
209
+ if (nested.length) {
210
+ parts.push(`(${nested.join(" AND ")})`);
211
+ }
212
+ continue;
213
+ }
214
+ if (key === "$or") {
215
+ const nested = (value ?? [])
216
+ .map(compile)
217
+ .filter(Boolean);
218
+ if (nested.length) {
219
+ parts.push(`(${nested.join(" OR ")})`);
220
+ }
221
+ continue;
222
+ }
223
+ if (key === "$not") {
224
+ const nested = compile(value);
225
+ if (nested) {
226
+ parts.push(`NOT (${nested})`);
227
+ }
228
+ continue;
229
+ }
230
+ parts.push(fieldPredicate(key, value, plan, params));
231
+ }
232
+ return parts.join(" AND ");
233
+ };
234
+ const sql = compile(filters);
235
+ return sql ? { sql, params } : undefined;
236
+ }
237
+ //# sourceMappingURL=filters.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filters.js","sourceRoot":"","sources":["../../src/utils/filters.ts"],"names":[],"mappings":";;AAiBA,8BAeC;AA6QD,sCAsDC;AAlWD,qDAAuD;AAGvD,SAAS,IAAI,CAAC,OAAe;IAC3B,MAAM,IAAI,mBAAW,CAAC,mBAAW,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;AAC/D,CAAC;AAOD;;;GAGG;AACH,SAAgB,SAAS,CAAC,IAAY,EAAE,MAAM,GAAG,KAAK;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,IAAI,GAAG,SAAS,CAAA;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC/C,MAAM,MAAM,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;QACxC,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YACrB,IAAI,IAAI,OAAO,OAAO,GAAG,CAAA;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,MAAM,OAAO,GAAG,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,UAAU,CACjB,OAAqB,EACrB,KAAc;IAEd,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GACP,OAAO,CAAC,OAAO,IAAI,KAAK,YAAY,IAAI;gBACtC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE;gBACjB,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;oBAC3B,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACnB,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,iCAAiC,OAAO,CAAC,IAAI,eAAe,CAAC,CAAA;YACpE,CAAC;YACD,OAAO,GAAG,CAAA;QACZ,CAAC;QACD,KAAK,SAAS;YACZ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,OAAO,KAAK,CAAA;YACd,CAAC;YACD,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBAC1C,OAAO,KAAK,KAAK,MAAM,CAAA;YACzB,CAAC;YACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA;QACvB;YACE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC5D,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAAiB,EAAE,KAAc;IAClD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CACrB,IAAY,EACZ,IAAa,EACb,MAAiB;IAEjB,MAAM,GAAG,GAAG,IAAI;SACb,KAAK,CAAC,GAAG,CAAC;SACV,WAAW,CAAU,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;IACrE,OAAO,gBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,CAAA;AACxE,CAAC;AAED,SAAS,SAAS,CAAC,OAAqB,EAAE,MAAe;IACvD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,OAAO,MAAM;QACX,CAAC,CAAC,IAAI,IAAI,oBAAoB,IAAI,oBAAoB;QACtD,CAAC,CAAC,IAAI,IAAI,eAAe,IAAI,mBAAmB,CAAA;AACpD,CAAC;AAED,SAAS,WAAW,CAClB,OAAqB,EACrB,KAAc,EACd,MAAiB;IAEjB,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACvC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,qEAAqE;QACrE,OAAO,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC7C,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACnD,CAAC;AAED,iFAAiF;AACjF,SAAS,QAAQ,CACf,OAAqB,EACrB,MAAiB,EACjB,MAAiB;IAEjB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IACxE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAA;AAClE,CAAC;AAED,SAAS,aAAa,CACpB,OAAqB,EACrB,QAAgB,EAChB,KAAc,EACd,MAAiB;IAEjB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,IAAI,CACF,aAAa,QAAQ,sCAAsC,OAAO,CAAC,IAAI,GAAG,CAC3E,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAEvC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,QAAQ,IAAI,SAAS,CACxE,MAAM,EACN,IAAI,CACL,EAAE,CAAA;IACL,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,QAAQ,IAAI,SAAS,CACzE,MAAM,EACN,IAAI,CACL,EAAE,CAAA;IACL,CAAC;IAED,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,QAAQ,IAAI,SAAS,CAC9D,MAAM,EACN,IAAI,CACL,EAAE,CAAA;AACL,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAqB,EACrB,MAAiB,EACjB,IAAmB,EACnB,MAAiB;IAEjB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,IAAI,CACF,aACE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAChC,QAAQ,OAAO,CAAC,IAAI,wBAAwB,CAC7C,CAAA;IACH,CAAC;IAED,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC;IAED,2EAA2E;IAC3E,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IACpE,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAA;AACzD,CAAC;AAED,SAAS,cAAc,CACrB,IAAY,EACZ,GAAY,EACZ,IAAe,EACf,MAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAErC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,CAAC,yBAAyB,IAAI,mCAAmC,CAAC,CAAA;IACxE,CAAC;IAED,sEAAsE;IACtE,wEAAwE;IACxE,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC/C,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,SAAS,GAAG,GAA8B,CAAA;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;IAExE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,uCAAuC,IAAI,GAAG,CAAC,CAAA;IACtD,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;QAEjC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,KAAK;gBACR,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;gBAC/C,MAAK;YACP,KAAK,KAAK;gBACR,mDAAmD;gBACnD,KAAK,CAAC,IAAI,CACR,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;oBACnC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC;oBAC1B,CAAC,CAAC,OAAO,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CACjD,CAAA;gBACD,MAAK;YACP,KAAK,KAAK;gBACR,KAAK,CAAC,IAAI,CACR,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAClE,CAAA;gBACD,MAAK;YACP,KAAK,MAAM;gBACT,KAAK,CAAC,IAAI,CACR,OAAO,QAAQ,CACb,OAAO,EACP,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EACtC,MAAM,CACP,EAAE,CACJ,CAAA;gBACD,MAAK;YACP,KAAK,KAAK;gBACR,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;gBACtD,MAAK;YACP,KAAK,MAAM;gBACT,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;gBACvD,MAAK;YACP,KAAK,KAAK;gBACR,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;gBACtD,MAAK;YACP,KAAK,MAAM;gBACT,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;gBACvD,MAAK;YACP,KAAK,SAAS;gBACZ,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;gBAC9C,MAAK;YACP,KAAK,WAAW;gBACd,KAAK,CAAC,IAAI,CACR,gBAAgB,CACd,OAAO,EACP,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EACtC,KAAK,EACL,MAAM,CACP,CACF,CAAA;gBACD,MAAK;YACP,KAAK,WAAW;gBACd,KAAK,CAAC,IAAI,CACR,gBAAgB,CACd,OAAO,EACP,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EACtC,KAAK,EACL,MAAM,CACP,CACF,CAAA;gBACD,MAAK;YACP,KAAK,SAAS,CAAC;YACf,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;oBACrB,IAAI,CACF,aAAa,QAAQ,sCAAsC,IAAI,GAAG,CACnE,CAAA;gBACH,CAAC;gBACD,MAAM,OAAO,GACX,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC9D,KAAK,CAAC,IAAI,CACR,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CACtE,CAAA;gBACD,MAAK;YACP,CAAC;YACD;gBACE,IAAI,CACF,2DAA2D,QAAQ,SAAS,IAAI,GAAG,CACpF,CAAA;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAA;AACnE,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAC3B,OAA8C,EAC9C,IAAe;IAEf,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,MAAM,GAAc,EAAE,CAAA;IAE5B,MAAM,OAAO,GAAG,CAAC,MAAiC,EAAU,EAAE;QAC5D,MAAM,KAAK,GAAa,EAAE,CAAA;QAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAChB,SAAQ;YACV,CAAC;YAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAI,CAAC,KAAK,IAAI,EAAE,CAAiC;qBAC1D,GAAG,CAAC,OAAO,CAAC;qBACZ,MAAM,CAAC,OAAO,CAAC,CAAA;gBAClB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClB,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;gBACzC,CAAC;gBACD,SAAQ;YACV,CAAC;YAED,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAI,CAAC,KAAK,IAAI,EAAE,CAAiC;qBAC1D,GAAG,CAAC,OAAO,CAAC;qBACZ,MAAM,CAAC,OAAO,CAAC,CAAA;gBAClB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClB,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBACxC,CAAC;gBACD,SAAQ;YACV,CAAC;YAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAkC,CAAC,CAAA;gBAC1D,IAAI,MAAM,EAAE,CAAC;oBACX,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,GAAG,CAAC,CAAA;gBAC/B,CAAC;gBACD,SAAQ;YACV,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QACtD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC,CAAA;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5B,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1C,CAAC"}
@@ -0,0 +1,6 @@
1
+ export * from "./plan";
2
+ export * from "./documents";
3
+ export * from "./filters";
4
+ export * from "./facets";
5
+ export * from "./extensions";
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA"}
@@ -0,0 +1,22 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./plan"), exports);
18
+ __exportStar(require("./documents"), exports);
19
+ __exportStar(require("./filters"), exports);
20
+ __exportStar(require("./facets"), exports);
21
+ __exportStar(require("./extensions"), exports);
22
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB;AACtB,8CAA2B;AAC3B,4CAAyB;AACzB,2CAAwB;AACxB,+CAA4B"}
@@ -0,0 +1,86 @@
1
+ import { SearchTypes } from "@medusajs/framework/types";
2
+ export type PostgresSearchEngine = "native" | "lakebase";
3
+ export type PostgresFieldKind = "text" | "keyword" | "number" | "boolean" | "geo" | "vector";
4
+ export type PostgresVectorDistance = "cosine" | "l2" | "inner_product";
5
+ export type PostgresSearchEmbedder = (text: string) => Promise<number[]>;
6
+ export type PlannedField = {
7
+ path: string;
8
+ kind: PostgresFieldKind;
9
+ is_array: boolean;
10
+ is_date: boolean;
11
+ dimensions?: number;
12
+ field: SearchTypes.SearchFieldDefinition;
13
+ };
14
+ export type IndexPlan = {
15
+ fields: Map<string, PlannedField>;
16
+ searchable: string[];
17
+ /** Vector field paths declared on the index. */
18
+ vectors: string[];
19
+ primary_key: string;
20
+ /**
21
+ * Stable fingerprint of the physical schema this plan implies. Used to decide
22
+ * whether an existing table can be reused or must be rebuilt empty.
23
+ */
24
+ schema_hash: string;
25
+ };
26
+ export type PostgresSearchProviderOptions = {
27
+ /**
28
+ * Text search configuration language passed to `to_tsvector` / `plainto_tsquery`.
29
+ * @default "english"
30
+ */
31
+ language?: string;
32
+ /**
33
+ * Search engine backend.
34
+ * - `native` — portable Postgres FTS (GIN + `ts_rank`) + `pg_trgm`. Default.
35
+ * - `lakebase` — Neon Lakebase Search (`lakebase_text` BM25 + `lakebase_vector` ANN).
36
+ * @default "native"
37
+ */
38
+ engine?: PostgresSearchEngine;
39
+ /**
40
+ * Embeds text for `search_options.vector.query`. Required on the lakebase
41
+ * engine when callers pass a query string instead of a pre-computed `value`.
42
+ */
43
+ embedder?: PostgresSearchEmbedder;
44
+ /**
45
+ * Distance metric for `lakebase_ann` / pgvector indexes.
46
+ * @default "cosine"
47
+ */
48
+ vector_distance?: PostgresVectorDistance;
49
+ };
50
+ export declare function isSearchable(field: SearchTypes.SearchFieldDefinition): boolean;
51
+ export declare function isFacetable(field: SearchTypes.SearchFieldDefinition): boolean;
52
+ /**
53
+ * Refuses a definition this engine cannot honour.
54
+ */
55
+ export declare function assertIndexSupported(definition: SearchTypes.ResolvedSearchIndexDefinition, engine?: PostgresSearchEngine): void;
56
+ /**
57
+ * Refuses a query this engine cannot honour without answering incorrectly.
58
+ */
59
+ export declare function assertQuerySupported(query: SearchTypes.ProviderSearchQuery, engine?: PostgresSearchEngine): void;
60
+ /**
61
+ * Flattens a definition into per-leaf field metadata. Nested objects become
62
+ * dotted paths; arrays of objects collapse to per-leaf arrays, matching the
63
+ * local provider's shape so definitions stay portable.
64
+ */
65
+ export declare function buildIndexPlan(definition: SearchTypes.ResolvedSearchIndexDefinition): IndexPlan;
66
+ export declare function sameSchema(a: IndexPlan, b: IndexPlan): boolean;
67
+ /**
68
+ * Maps a field weight onto Postgres `setweight` labels. Higher weights land in
69
+ * denser buckets so `ts_rank` prefers title matches over body matches.
70
+ */
71
+ export declare function weightLabel(searchable: SearchTypes.SearchFieldDefinition["searchable"]): "A" | "B" | "C" | "D";
72
+ /**
73
+ * Turns a physical index name into a safe Postgres table identifier.
74
+ */
75
+ export declare function tableNameForIndex(physicalName: string): string;
76
+ /** BM25 index name for a document table (lakebase engine). */
77
+ export declare function bm25IndexName(table: string): string;
78
+ /**
79
+ * Physical column name for a vector field path.
80
+ * `embedding` → `v_embedding`, `meta.vec` → `v_meta_vec`.
81
+ */
82
+ export declare function vectorColumnName(path: string): string;
83
+ export declare function vectorOpClass(distance: PostgresVectorDistance): string;
84
+ export declare function vectorDistanceOperator(distance: PostgresVectorDistance): string;
85
+ export declare const CATALOG_TABLE = "search_postgres_index";
86
+ //# sourceMappingURL=plan.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/utils/plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAGvD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,CAAA;AAExD,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,SAAS,GACT,QAAQ,GACR,SAAS,GACT,KAAK,GACL,QAAQ,CAAA;AAEZ,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,IAAI,GAAG,eAAe,CAAA;AAEtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AAExE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,iBAAiB,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,WAAW,CAAC,qBAAqB,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAA;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,sBAAsB,CAAA;CACzC,CAAA;AAMD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,CAAC,qBAAqB,GACvC,OAAO,CAET;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,CAAC,qBAAqB,GACvC,OAAO,CAET;AA2BD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,WAAW,CAAC,6BAA6B,EACrD,MAAM,GAAE,oBAA+B,GACtC,IAAI,CA2CN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,CAAC,mBAAmB,EACtC,MAAM,GAAE,oBAA+B,GACtC,IAAI,CA4BN;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,WAAW,CAAC,6BAA6B,GACpD,SAAS,CAwEX;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAE9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,WAAW,CAAC,qBAAqB,CAAC,YAAY,CAAC,GAC1D,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAgBvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAY9D;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAUR;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAUR;AAED,eAAO,MAAM,aAAa,0BAA0B,CAAA"}
@@ -0,0 +1,238 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.CATALOG_TABLE = void 0;
4
+ exports.isSearchable = isSearchable;
5
+ exports.isFacetable = isFacetable;
6
+ exports.assertIndexSupported = assertIndexSupported;
7
+ exports.assertQuerySupported = assertQuerySupported;
8
+ exports.buildIndexPlan = buildIndexPlan;
9
+ exports.sameSchema = sameSchema;
10
+ exports.weightLabel = weightLabel;
11
+ exports.tableNameForIndex = tableNameForIndex;
12
+ exports.bm25IndexName = bm25IndexName;
13
+ exports.vectorColumnName = vectorColumnName;
14
+ exports.vectorOpClass = vectorOpClass;
15
+ exports.vectorDistanceOperator = vectorDistanceOperator;
16
+ const crypto_1 = require("crypto");
17
+ const utils_1 = require("@medusajs/framework/utils");
18
+ function fail(message) {
19
+ throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_ALLOWED, message);
20
+ }
21
+ function isSearchable(field) {
22
+ return field.searchable === true || typeof field.searchable === "object";
23
+ }
24
+ function isFacetable(field) {
25
+ return field.facetable === true || typeof field.facetable === "object";
26
+ }
27
+ function fieldKind(field) {
28
+ switch (field.type) {
29
+ case "text":
30
+ return "text";
31
+ case "keyword":
32
+ return "keyword";
33
+ case "integer":
34
+ case "float":
35
+ case "date":
36
+ return "number";
37
+ case "boolean":
38
+ return "boolean";
39
+ case "geo":
40
+ return "geo";
41
+ case "vector":
42
+ return "vector";
43
+ default:
44
+ return fail(`The postgres search provider does not support fields of type "${field.type}"`);
45
+ }
46
+ }
47
+ /**
48
+ * Refuses a definition this engine cannot honour.
49
+ */
50
+ function assertIndexSupported(definition, engine = "native") {
51
+ const walk = (group, prefix) => {
52
+ for (const [name, field] of Object.entries(group)) {
53
+ const path = prefix ? `${prefix}.${name}` : name;
54
+ if (field.correlated) {
55
+ fail(`The postgres search provider cannot correlate predicates per element, so "${path}" cannot set "correlated". Arrays of objects are collapsed to per-leaf arrays.`);
56
+ }
57
+ if (field.type === "vector") {
58
+ if (engine !== "lakebase") {
59
+ fail(`Vector fields ("${path}") require engine: "lakebase". The native engine does not support vector search.`);
60
+ }
61
+ if (!field.dimensions || field.dimensions < 1) {
62
+ fail(`Vector field "${path}" must declare a positive "dimensions" value`);
63
+ }
64
+ if (field.array) {
65
+ fail(`Vector field "${path}" cannot be an array`);
66
+ }
67
+ }
68
+ if (field.type === "geo") {
69
+ fail(`The postgres search provider does not support geo fields ("${path}")`);
70
+ }
71
+ if (field.type === "object" && field.fields) {
72
+ walk(field.fields, path);
73
+ }
74
+ }
75
+ };
76
+ walk(definition.fields, "");
77
+ }
78
+ /**
79
+ * Refuses a query this engine cannot honour without answering incorrectly.
80
+ */
81
+ function assertQuerySupported(query, engine = "native") {
82
+ const options = query.search_options ?? {};
83
+ if (options.highlight) {
84
+ fail("The postgres search provider does not support highlighting");
85
+ }
86
+ if (options.vector && engine !== "lakebase") {
87
+ fail(`Vector search requires engine: "lakebase". The native engine does not support search_options.vector.`);
88
+ }
89
+ if (options.locales?.length) {
90
+ fail("The postgres search provider does not support query-time locales; configure `language` on the provider options instead");
91
+ }
92
+ if (options.match_strategy === "last") {
93
+ fail(`The postgres search provider does not support match_strategy: "last". Use "all" (default) or "any".`);
94
+ }
95
+ if (query.pagination?.cursor !== undefined) {
96
+ fail("The postgres search provider does not support cursor pagination");
97
+ }
98
+ }
99
+ /**
100
+ * Flattens a definition into per-leaf field metadata. Nested objects become
101
+ * dotted paths; arrays of objects collapse to per-leaf arrays, matching the
102
+ * local provider's shape so definitions stay portable.
103
+ */
104
+ function buildIndexPlan(definition) {
105
+ const fields = new Map();
106
+ const searchable = [];
107
+ const vectors = [];
108
+ const walk = (group, prefix, inArray) => {
109
+ for (const [name, field] of Object.entries(group)) {
110
+ const path = prefix ? `${prefix}.${name}` : name;
111
+ const isArray = inArray || field.array === true;
112
+ if (field.type === "object") {
113
+ if (field.fields) {
114
+ walk(field.fields, path, isArray);
115
+ }
116
+ continue;
117
+ }
118
+ const kind = fieldKind(field);
119
+ const planned = {
120
+ path,
121
+ kind,
122
+ is_array: isArray,
123
+ is_date: field.type === "date",
124
+ dimensions: field.dimensions,
125
+ field,
126
+ };
127
+ fields.set(path, planned);
128
+ if (kind === "vector") {
129
+ vectors.push(path);
130
+ continue;
131
+ }
132
+ if (isSearchable(field)) {
133
+ searchable.push(path);
134
+ }
135
+ }
136
+ };
137
+ walk(definition.fields, "", false);
138
+ const schemaPayload = {
139
+ primary_key: definition.primary_key,
140
+ fields: [...fields.values()].map((planned) => ({
141
+ path: planned.path,
142
+ kind: planned.kind,
143
+ is_array: planned.is_array,
144
+ is_date: planned.is_date,
145
+ dimensions: planned.dimensions,
146
+ searchable: isSearchable(planned.field),
147
+ filterable: !!planned.field.filterable,
148
+ sortable: !!planned.field.sortable,
149
+ facetable: isFacetable(planned.field),
150
+ })),
151
+ searchable: [...searchable].sort(),
152
+ vectors: [...vectors].sort(),
153
+ };
154
+ return {
155
+ fields,
156
+ searchable,
157
+ vectors,
158
+ primary_key: definition.primary_key,
159
+ schema_hash: (0, crypto_1.createHash)("sha256")
160
+ .update(JSON.stringify(schemaPayload))
161
+ .digest("hex"),
162
+ };
163
+ }
164
+ function sameSchema(a, b) {
165
+ return a.schema_hash === b.schema_hash;
166
+ }
167
+ /**
168
+ * Maps a field weight onto Postgres `setweight` labels. Higher weights land in
169
+ * denser buckets so `ts_rank` prefers title matches over body matches.
170
+ */
171
+ function weightLabel(searchable) {
172
+ const weight = typeof searchable === "object" && searchable.weight !== undefined
173
+ ? searchable.weight
174
+ : 1;
175
+ if (weight >= 3) {
176
+ return "A";
177
+ }
178
+ if (weight >= 2) {
179
+ return "B";
180
+ }
181
+ if (weight > 1) {
182
+ return "C";
183
+ }
184
+ return "D";
185
+ }
186
+ /**
187
+ * Turns a physical index name into a safe Postgres table identifier.
188
+ */
189
+ function tableNameForIndex(physicalName) {
190
+ const safe = physicalName
191
+ .toLowerCase()
192
+ .replace(/[^a-z0-9_]/g, "_")
193
+ .replace(/_+/g, "_")
194
+ .replace(/^_|_$/g, "");
195
+ if (!safe) {
196
+ fail(`Cannot derive a table name from index "${physicalName}"`);
197
+ }
198
+ return `search_pg_${safe}`;
199
+ }
200
+ /** BM25 index name for a document table (lakebase engine). */
201
+ function bm25IndexName(table) {
202
+ return `${table}_bm25`;
203
+ }
204
+ /**
205
+ * Physical column name for a vector field path.
206
+ * `embedding` → `v_embedding`, `meta.vec` → `v_meta_vec`.
207
+ */
208
+ function vectorColumnName(path) {
209
+ const safe = path
210
+ .toLowerCase()
211
+ .replace(/[^a-z0-9_]/g, "_")
212
+ .replace(/_+/g, "_");
213
+ return `v_${safe}`;
214
+ }
215
+ function vectorOpClass(distance) {
216
+ switch (distance) {
217
+ case "l2":
218
+ return "vector_l2_ops";
219
+ case "inner_product":
220
+ return "vector_ip_ops";
221
+ case "cosine":
222
+ default:
223
+ return "vector_cosine_ops";
224
+ }
225
+ }
226
+ function vectorDistanceOperator(distance) {
227
+ switch (distance) {
228
+ case "l2":
229
+ return "<->";
230
+ case "inner_product":
231
+ return "<#>";
232
+ case "cosine":
233
+ default:
234
+ return "<=>";
235
+ }
236
+ }
237
+ exports.CATALOG_TABLE = "search_postgres_index";
238
+ //# sourceMappingURL=plan.js.map