@unifiedcommerce/adapter-pg-search 0.0.1

package/dist/src/index.d.ts

@@ -0,0 +1,13 @@
+import { type SearchAdapter } from "@unifiedcommerce/core";
+export interface PgSearchQueryResultRow {
+    [key: string]: unknown;
+}
+export interface PgSearchAdapterOptions {
+    query: (sql: string, params: unknown[]) => Promise<{
+        rows: PgSearchQueryResultRow[];
+    }>;
+    tableName?: string;
+    dictionary?: string;
+}
+export declare function pgSearchAdapter(options: PgSearchAdapterOptions): SearchAdapter;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAKnB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,sBAAsB;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,sBAAsB,EAAE,CAAA;KAAE,CAAC,CAAC;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4ID,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CA8J9E"}

package/dist/src/index.js

@@ -0,0 +1,248 @@
+import { Err, Ok, } from "@unifiedcommerce/core";
+function safeIdentifier(value) {
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(value)) {
+        throw new Error(`Invalid SQL identifier: ${value}`);
+    }
+    return value;
+}
+function parseCategories(value) {
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === "string");
+    }
+    if (typeof value === "string") {
+        try {
+            const parsed = JSON.parse(value);
+            if (Array.isArray(parsed)) {
+                return parsed.filter((item) => typeof item === "string");
+            }
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+function parseBrands(value) {
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === "string");
+    }
+    if (typeof value === "string") {
+        try {
+            const parsed = JSON.parse(value);
+            if (Array.isArray(parsed)) {
+                return parsed.filter((item) => typeof item === "string");
+            }
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+function toDocument(row) {
+    return {
+        id: String(row.id ?? ""),
+        type: String(row.type ?? ""),
+        slug: String(row.slug ?? ""),
+        title: String(row.title ?? ""),
+        ...(row.description ? { description: String(row.description) } : {}),
+        ...(row.status ? { status: String(row.status) } : {}),
+        categories: parseCategories(row.categories),
+        brands: parseBrands(row.brands),
+        text: String(row.text ?? ""),
+        ...(row.payload && typeof row.payload === "object" ? { payload: row.payload } : {}),
+    };
+}
+function buildWhere(params, dictionary) {
+    const clauses = [];
+    const values = [];
+    if (params.query.trim().length > 0) {
+        values.push(params.query);
+        clauses.push(`to_tsvector('${dictionary}', text) @@ plainto_tsquery('${dictionary}', $${values.length})`);
+    }
+    if (params.filters?.type) {
+        values.push(params.filters.type);
+        clauses.push(`type = $${values.length}`);
+    }
+    if (params.filters?.status) {
+        values.push(params.filters.status);
+        clauses.push(`status = $${values.length}`);
+    }
+    if (params.filters?.category) {
+        values.push(params.filters.category);
+        clauses.push(`$${values.length} = ANY(categories)`);
+    }
+    if (params.filters?.brand) {
+        values.push(params.filters.brand);
+        clauses.push(`$${values.length} = ANY(brands)`);
+    }
+    return {
+        sql: clauses.length > 0 ? `WHERE ${clauses.join(" AND ")}` : "",
+        values,
+    };
+}
+function computeFacets(documents, requested) {
+    const facets = requested && requested.length > 0 ? requested : ["type", "status", "category", "brand"];
+    const output = {};
+    if (facets.includes("type")) {
+        output.type = {};
+        for (const document of documents) {
+            output.type[document.type] = (output.type[document.type] ?? 0) + 1;
+        }
+    }
+    if (facets.includes("status")) {
+        output.status = {};
+        for (const document of documents) {
+            const status = document.status ?? "unknown";
+            output.status[status] = (output.status[status] ?? 0) + 1;
+        }
+    }
+    if (facets.includes("category") || facets.includes("categories")) {
+        output.category = {};
+        for (const document of documents) {
+            for (const category of document.categories) {
+                output.category[category] = (output.category[category] ?? 0) + 1;
+            }
+        }
+    }
+    if (facets.includes("brand") || facets.includes("brands")) {
+        output.brand = {};
+        for (const document of documents) {
+            for (const brand of document.brands) {
+                output.brand[brand] = (output.brand[brand] ?? 0) + 1;
+            }
+        }
+    }
+    return output;
+}
+export function pgSearchAdapter(options) {
+    const table = safeIdentifier(options.tableName ?? "search_index");
+    const dictionary = options.dictionary ?? "english";
+    return {
+        providerId: "pg-search",
+        async index(documents) {
+            try {
+                if (documents.length === 0)
+                    return Ok(undefined);
+                for (const document of documents) {
+                    await options.query(`INSERT INTO ${table} (id, type, slug, title, description, status, categories, brands, text, payload)
+             VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10::jsonb)
+             ON CONFLICT (id)
+             DO UPDATE SET
+               type = EXCLUDED.type,
+               slug = EXCLUDED.slug,
+               title = EXCLUDED.title,
+               description = EXCLUDED.description,
+               status = EXCLUDED.status,
+               categories = EXCLUDED.categories,
+               brands = EXCLUDED.brands,
+               text = EXCLUDED.text,
+               payload = EXCLUDED.payload`, [
+                        document.id,
+                        document.type,
+                        document.slug,
+                        document.title,
+                        document.description ?? null,
+                        document.status ?? null,
+                        document.categories,
+                        document.brands,
+                        document.text,
+                        JSON.stringify(document.payload ?? {}),
+                    ]);
+                }
+                return Ok(undefined);
+            }
+            catch (error) {
+                return Err({
+                    code: "PG_SEARCH_INDEX_FAILED",
+                    message: error instanceof Error ? error.message : "pg-search indexing failed.",
+                });
+            }
+        },
+        async remove(ids) {
+            try {
+                if (ids.length === 0)
+                    return Ok(undefined);
+                await options.query(`DELETE FROM ${table} WHERE id = ANY($1::text[])`, [ids]);
+                return Ok(undefined);
+            }
+            catch (error) {
+                return Err({
+                    code: "PG_SEARCH_DELETE_FAILED",
+                    message: error instanceof Error ? error.message : "pg-search delete failed.",
+                });
+            }
+        },
+        async search(params) {
+            try {
+                const page = Math.max(1, params.page ?? 1);
+                const limit = Math.max(1, Math.min(100, params.limit ?? 20));
+                const offset = (page - 1) * limit;
+                const where = buildWhere(params, dictionary);
+                const scoreExpr = params.query.trim().length > 0
+                    ? `ts_rank(to_tsvector('${dictionary}', text), plainto_tsquery('${dictionary}', $1))`
+                    : "0";
+                const rows = await options.query(`SELECT id, type, slug, title, description, status, categories, brands, text, payload, ${scoreExpr} AS score
+           FROM ${table}
+           ${where.sql}
+           ORDER BY score DESC, title ASC
+           LIMIT $${where.values.length + 1}
+           OFFSET $${where.values.length + 2}`, [...where.values, limit, offset]);
+                const countRows = await options.query(`SELECT COUNT(*)::int AS total FROM ${table} ${where.sql}`, where.values);
+                const facetRows = await options.query(`SELECT id, type, slug, title, description, status, categories, brands, text, payload
+           FROM ${table}
+           ${where.sql}`, where.values);
+                const documents = facetRows.rows.map((row) => toDocument(row));
+                const hits = rows.rows.map((row) => ({
+                    id: String(row.id ?? ""),
+                    score: Number(row.score ?? 0),
+                    document: toDocument(row),
+                }));
+                return Ok({
+                    hits,
+                    total: Number(countRows.rows[0]?.total ?? hits.length),
+                    page,
+                    limit,
+                    facets: computeFacets(documents, params.facets),
+                });
+            }
+            catch (error) {
+                return Err({
+                    code: "PG_SEARCH_QUERY_FAILED",
+                    message: error instanceof Error ? error.message : "pg-search query failed.",
+                });
+            }
+        },
+        async suggest(params) {
+            try {
+                const limit = Math.max(1, Math.min(25, params.limit ?? 10));
+                const prefix = params.prefix.trim().toLowerCase();
+                if (!prefix)
+                    return Ok([]);
+                const conditions = ["LOWER(title) LIKE $1"];
+                const values = [`${prefix}%`];
+                if (params.type) {
+                    values.push(params.type);
+                    conditions.push(`type = $${values.length}`);
+                }
+                values.push(limit);
+                const rows = await options.query(`SELECT DISTINCT title
+           FROM ${table}
+           WHERE ${conditions.join(" AND ")}
+           ORDER BY title ASC
+           LIMIT $${values.length}`, values);
+                const suggestions = rows.rows
+                    .map((row) => String(row.title ?? ""))
+                    .filter(Boolean)
+                    .slice(0, limit);
+                return Ok(suggestions);
+            }
+            catch (error) {
+                return Err({
+                    code: "PG_SEARCH_SUGGEST_FAILED",
+                    message: error instanceof Error ? error.message : "pg-search suggest failed.",
+                });
+            }
+        },
+    };
+}