@voyantjs/products 0.28.3 → 0.29.0

package/dist/schema-taxonomy.d.ts

@@ -360,6 +360,178 @@ export declare const productCategories: import("drizzle-orm/pg-core").PgTableWit
 }>;
 export type ProductCategory = typeof productCategories.$inferSelect;
 export type NewProductCategory = typeof productCategories.$inferInsert;
+/**
+ * Locale-aware category labels. Mirrors `destinationTranslations`.
+ *
+ * The catalog plane's taxonomy projection (`catalog-policy-taxonomy.ts` +
+ * `service-catalog-plane-taxonomy.ts`) reads this table per-slice locale
+ * and falls back to `productCategories.name` when no row exists for a
+ * given `(categoryId, languageTag)`. Slug stays single-locale on
+ * `productCategories.slug` per #502 non-goals — operators want stable
+ * URLs that don't shift when translations are edited.
+ */
+export declare const productCategoryTranslations: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "product_category_translations";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "product_category_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: true;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        categoryId: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "product_category_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        languageTag: import("drizzle-orm/pg-core").PgColumn<{
+            name: "language_tag";
+            tableName: "product_category_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        name: import("drizzle-orm/pg-core").PgColumn<{
+            name: "name";
+            tableName: "product_category_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        description: import("drizzle-orm/pg-core").PgColumn<{
+            name: "description";
+            tableName: "product_category_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        seoTitle: import("drizzle-orm/pg-core").PgColumn<{
+            name: "seo_title";
+            tableName: "product_category_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        seoDescription: import("drizzle-orm/pg-core").PgColumn<{
+            name: "seo_description";
+            tableName: "product_category_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "product_category_translations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "product_category_translations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export type ProductCategoryTranslation = typeof productCategoryTranslations.$inferSelect;
+export type NewProductCategoryTranslation = typeof productCategoryTranslations.$inferInsert;
 export declare const productTags: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "product_tags";
     schema: undefined;
@@ -437,6 +609,121 @@ export declare const productTags: import("drizzle-orm/pg-core").PgTableWithColum
 }>;
 export type ProductTag = typeof productTags.$inferSelect;
 export type NewProductTag = typeof productTags.$inferInsert;
+/**
+ * Locale-aware tag labels. Slimmer than category translations — tags are
+ * short labels with no description / SEO blurbs (per #502 non-goals).
+ */
+export declare const productTagTranslations: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "product_tag_translations";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "product_tag_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: true;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        tagId: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "product_tag_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        languageTag: import("drizzle-orm/pg-core").PgColumn<{
+            name: "language_tag";
+            tableName: "product_tag_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        name: import("drizzle-orm/pg-core").PgColumn<{
+            name: "name";
+            tableName: "product_tag_translations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "product_tag_translations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "product_tag_translations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export type ProductTagTranslation = typeof productTagTranslations.$inferSelect;
+export type NewProductTagTranslation = typeof productTagTranslations.$inferInsert;
 export declare const destinations: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "destinations";
     schema: undefined;

package/dist/schema-taxonomy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-taxonomy.d.ts","sourceRoot":"","sources":["../src/schema-taxonomy.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBxB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,YAAY,CAAA;AAC1D,MAAM,MAAM,cAAc,GAAG,OAAO,YAAY,CAAC,YAAY,CAAA;AAE7D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuC7B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,iBAAiB,CAAC,YAAY,CAAA;AACnE,MAAM,MAAM,kBAAkB,GAAG,OAAO,iBAAiB,CAAC,YAAY,CAAA;AAEtE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASvB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,YAAY,CAAA;AACxD,MAAM,MAAM,aAAa,GAAG,OAAO,WAAW,CAAC,YAAY,CAAA;AAE3D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBxB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,YAAY,CAAA;AAC1D,MAAM,MAAM,cAAc,GAAG,OAAO,YAAY,CAAC,YAAY,CAAA;AAE7D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBnC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,uBAAuB,CAAC,YAAY,CAAA;AAChF,MAAM,MAAM,yBAAyB,GAAG,OAAO,uBAAuB,CAAC,YAAY,CAAA;AAEnF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBnC,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe9B,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB/B,CAAA"}
+{"version":3,"file":"schema-taxonomy.d.ts","sourceRoot":"","sources":["../src/schema-taxonomy.ts"],"names":[],"mappings":"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"}

package/dist/schema-taxonomy.js

@@ -49,12 +49,59 @@ export const productCategories = pgTable("product_categories", {
     index("idx_product_categories_active_sort_name").on(table.active, table.sortOrder, table.name),
     index("idx_product_categories_parent_sort_name").on(table.parentId, table.sortOrder, table.name),
 ]);
+/**
+ * Locale-aware category labels. Mirrors `destinationTranslations`.
+ *
+ * The catalog plane's taxonomy projection (`catalog-policy-taxonomy.ts` +
+ * `service-catalog-plane-taxonomy.ts`) reads this table per-slice locale
+ * and falls back to `productCategories.name` when no row exists for a
+ * given `(categoryId, languageTag)`. Slug stays single-locale on
+ * `productCategories.slug` per #502 non-goals — operators want stable
+ * URLs that don't shift when translations are edited.
+ */
+export const productCategoryTranslations = pgTable("product_category_translations", {
+    id: typeId("product_category_translations"),
+    categoryId: typeIdRef("category_id")
+        .notNull()
+        .references(() => productCategories.id, { onDelete: "cascade" }),
+    languageTag: text("language_tag").notNull(),
+    name: text("name").notNull(),
+    description: text("description"),
+    seoTitle: text("seo_title"),
+    seoDescription: text("seo_description"),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+}, (table) => [
+    uniqueIndex("uidx_product_category_translations_locale").on(table.categoryId, table.languageTag),
+    index("idx_product_category_translations_language").on(table.languageTag),
+    index("idx_product_category_translations_category_language_created").on(table.categoryId, table.languageTag, table.createdAt),
+    index("idx_product_category_translations_language_created").on(table.languageTag, table.createdAt),
+]);
 export const productTags = pgTable("product_tags", {
     id: typeId("product_tags"),
     name: text("name").notNull(),
     createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
 }, (table) => [uniqueIndex("uidx_product_tags_name").on(table.name)]);
+/**
+ * Locale-aware tag labels. Slimmer than category translations — tags are
+ * short labels with no description / SEO blurbs (per #502 non-goals).
+ */
+export const productTagTranslations = pgTable("product_tag_translations", {
+    id: typeId("product_tag_translations"),
+    tagId: typeIdRef("tag_id")
+        .notNull()
+        .references(() => productTags.id, { onDelete: "cascade" }),
+    languageTag: text("language_tag").notNull(),
+    name: text("name").notNull(),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+}, (table) => [
+    uniqueIndex("uidx_product_tag_translations_locale").on(table.tagId, table.languageTag),
+    index("idx_product_tag_translations_language").on(table.languageTag),
+    index("idx_product_tag_translations_tag_language_created").on(table.tagId, table.languageTag, table.createdAt),
+    index("idx_product_tag_translations_language_created").on(table.languageTag, table.createdAt),
+]);
 export const destinations = pgTable("destinations", {
     id: typeId("destinations"),
     parentId: typeIdRef("parent_id"),

package/dist/service-catalog-plane-destinations.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Projection extension that joins product → destinations and contributes
+ * locale-aware destination fields (regions, countries, cities, slugs, ids)
+ * onto the product search document.
+ *
+ * Wire via `createProductDocumentBuilder({ extensions: [destinationsExtension] })`.
+ * Requires the registry to include `productDestinationsCatalogPolicy` —
+ * otherwise the contributed fields are silently dropped by the indexer's
+ * field-policy filter.
+ *
+ * Locale handling: `destination_translations` is keyed by `(destination_id,
+ * language_tag)`. The projection looks up the slice's locale; missing
+ * translations fall back to the destination's canonical `slug`. Operators
+ * who want the locale lookup to fall back to a different language (e.g.
+ * `fr-CA` → `fr` → `en`) should pre-populate the translation row;
+ * multi-tier fallback isn't built into the joins.
+ *
+ * Today's destinations table has no coordinate columns — geopoints come
+ * from `product_locations` and will ship as a separate projection
+ * extension once that policy lands.
+ */
+import type { ProductProjectionExtension } from "./service-catalog-plane.js";
+/**
+ * Construct the destinations projection extension.
+ *
+ * Returns a `ProductProjectionExtension` ready to pass to
+ * `createProductDocumentBuilder`.
+ */
+export declare function createProductDestinationsProjectionExtension(): ProductProjectionExtension;
+//# sourceMappingURL=service-catalog-plane-destinations.d.ts.map

package/dist/service-catalog-plane-destinations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-catalog-plane-destinations.d.ts","sourceRoot":"","sources":["../src/service-catalog-plane-destinations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AAgG5E;;;;;GAKG;AACH,wBAAgB,4CAA4C,IAAI,0BAA0B,CAyBzF"}

package/dist/service-catalog-plane-destinations.js

@@ -0,0 +1,119 @@
+/**
+ * Projection extension that joins product → destinations and contributes
+ * locale-aware destination fields (regions, countries, cities, slugs, ids)
+ * onto the product search document.
+ *
+ * Wire via `createProductDocumentBuilder({ extensions: [destinationsExtension] })`.
+ * Requires the registry to include `productDestinationsCatalogPolicy` —
+ * otherwise the contributed fields are silently dropped by the indexer's
+ * field-policy filter.
+ *
+ * Locale handling: `destination_translations` is keyed by `(destination_id,
+ * language_tag)`. The projection looks up the slice's locale; missing
+ * translations fall back to the destination's canonical `slug`. Operators
+ * who want the locale lookup to fall back to a different language (e.g.
+ * `fr-CA` → `fr` → `en`) should pre-populate the translation row;
+ * multi-tier fallback isn't built into the joins.
+ *
+ * Today's destinations table has no coordinate columns — geopoints come
+ * from `product_locations` and will ship as a separate projection
+ * extension once that policy lands.
+ */
+import { and, eq, inArray } from "drizzle-orm";
+import { destinations, destinationTranslations, productDestinations } from "./schema-taxonomy.js";
+async function joinProductDestinations(db, productId, languageTag) {
+    // Sub-query the linked destination ids first so the locale lookup is
+    // single-shot. Drizzle's join builder doesn't compose left joins on
+    // composite predicates cleanly across all dialects, so two queries +
+    // an in-memory merge keeps the contract obvious.
+    const links = await db
+        .select({
+        destinationId: productDestinations.destinationId,
+        destinationType: destinations.destinationType,
+        slug: destinations.slug,
+        active: destinations.active,
+    })
+        .from(productDestinations)
+        .innerJoin(destinations, eq(productDestinations.destinationId, destinations.id))
+        .where(eq(productDestinations.productId, productId));
+    const activeLinks = links.filter((row) => row.active);
+    if (activeLinks.length === 0)
+        return [];
+    const destinationIds = activeLinks.map((row) => row.destinationId);
+    const translations = await db
+        .select({
+        destinationId: destinationTranslations.destinationId,
+        name: destinationTranslations.name,
+    })
+        .from(destinationTranslations)
+        .where(and(inArray(destinationTranslations.destinationId, destinationIds), eq(destinationTranslations.languageTag, languageTag)));
+    const nameByDestinationId = new Map();
+    for (const row of translations) {
+        nameByDestinationId.set(row.destinationId, row.name);
+    }
+    return activeLinks.map((row) => ({
+        destinationId: row.destinationId,
+        destinationType: row.destinationType,
+        slug: row.slug,
+        translatedName: nameByDestinationId.get(row.destinationId) ?? null,
+    }));
+}
+/** Bucket destinations by `destinationType` and return locale-aware names. */
+function bucketByType(rows) {
+    const regions = [];
+    const countries = [];
+    const cities = [];
+    const slugs = [];
+    const ids = [];
+    for (const row of rows) {
+        const label = row.translatedName ?? row.slug;
+        switch (row.destinationType) {
+            case "region":
+                regions.push(label);
+                break;
+            case "country":
+                countries.push(label);
+                break;
+            case "city":
+                cities.push(label);
+                break;
+            // "destination" (the catch-all default) doesn't bucket into any of
+            // the typed lists. Its slug + id still land in the doc so storefronts
+            // can filter generically.
+        }
+        slugs.push(row.slug);
+        ids.push(row.destinationId);
+    }
+    return { regions, countries, cities, slugs, ids };
+}
+/**
+ * Construct the destinations projection extension.
+ *
+ * Returns a `ProductProjectionExtension` ready to pass to
+ * `createProductDocumentBuilder`.
+ */
+export function createProductDestinationsProjectionExtension() {
+    return {
+        name: "products:destinations",
+        async project(db, productId, slice) {
+            const rows = await joinProductDestinations(db, productId, slice.locale);
+            if (rows.length === 0) {
+                return new Map([
+                    ["regions[]", []],
+                    ["countries[]", []],
+                    ["cities[]", []],
+                    ["destinationSlugs[]", []],
+                    ["destinationIds[]", []],
+                ]);
+            }
+            const { regions, countries, cities, slugs, ids } = bucketByType(rows);
+            return new Map([
+                ["regions[]", regions],
+                ["countries[]", countries],
+                ["cities[]", cities],
+                ["destinationSlugs[]", slugs],
+                ["destinationIds[]", ids],
+            ]);
+        },
+    };
+}

package/dist/service-catalog-plane-taxonomy.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Projection extension that joins product → categories (with ancestor walk)
+ * and product → tags, contributing taxonomy fields onto the product search
+ * document.
+ *
+ * Wire via `createProductDocumentBuilder({ extensions: [taxonomyExtension] })`.
+ * Requires the registry to include `productTaxonomyCatalogPolicy` —
+ * otherwise the contributed fields are silently dropped by the indexer's
+ * field-policy filter.
+ *
+ * Hierarchy denormalization: Typesense can't recurse, so a product linked
+ * to "Hiking" (parent: "Adventure") needs both labels in `categories[]` for
+ * the "Adventure" filter to match. The projection walks the parent chain
+ * iteratively, filtering inactive ancestors (so an operator-paused parent
+ * stops surfacing its still-active children under the parent filter).
+ *
+ * Localization (#502): when a `product_category_translations` /
+ * `product_tag_translations` row exists for the slice's locale, its `name`
+ * wins. Otherwise the projection falls back to the canonical
+ * `productCategories.name` / `productTags.name` (the legacy single-locale
+ * column). This makes the upgrade non-breaking — operators that haven't
+ * created translations keep seeing the English label on every locale slice
+ * exactly as before.
+ *
+ * Slugs stay single-locale on `productCategories.slug` (per #502 non-goals
+ * — operators want stable URLs that don't shift when translations are
+ * edited).
+ */
+import type { ProductProjectionExtension } from "./service-catalog-plane.js";
+interface CategoryRow {
+    id: string;
+    parentId: string | null;
+    name: string;
+    slug: string;
+    active: boolean;
+}
+interface DirectCategoryLink {
+    categoryId: string;
+    sortOrder: number;
+}
+interface TagRow {
+    id: string;
+    name: string;
+}
+interface TaxonomyProjection {
+    categoryIds: string[];
+    categoryNames: string[];
+    categorySlugs: string[];
+    primaryCategoryId: string | null;
+    primaryCategoryName: string | null;
+    primaryCategorySlug: string | null;
+    tagIds: string[];
+    tagLabels: string[];
+}
+/**
+ * Pure aggregation kernel. `categoryNameByLocale` and `tagNameByLocale`
+ * carry slice-locale translations; entries override the canonical name on
+ * the row. Missing entries fall back to the canonical name. Slug stays
+ * canonical regardless — there's no per-locale slug.
+ */
+declare function buildTaxonomyProjection(directLinks: ReadonlyArray<DirectCategoryLink>, resolvedCategories: ReadonlyMap<string, CategoryRow>, tags: ReadonlyArray<TagRow>, categoryNameByLocale?: ReadonlyMap<string, string>, tagNameByLocale?: ReadonlyMap<string, string>): TaxonomyProjection;
+/**
+ * Construct the taxonomy projection extension.
+ *
+ * Returns a `ProductProjectionExtension` ready to pass to
+ * `createProductDocumentBuilder`.
+ */
+export declare function createProductTaxonomyProjectionExtension(): ProductProjectionExtension;
+export declare const __test__: {
+    buildTaxonomyProjection: typeof buildTaxonomyProjection;
+};
+export {};
+//# sourceMappingURL=service-catalog-plane-taxonomy.d.ts.map

package/dist/service-catalog-plane-taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-catalog-plane-taxonomy.d.ts","sourceRoot":"","sources":["../src/service-catalog-plane-taxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAaH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AAE5E,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,UAAU,kBAAkB;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAkED,UAAU,MAAM;IACd,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AA8DD,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,iBAAS,uBAAuB,CAC9B,WAAW,EAAE,aAAa,CAAC,kBAAkB,CAAC,EAC9C,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,EACpD,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,oBAAoB,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,EAC7D,eAAe,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GACvD,kBAAkB,CAmEpB;AAED;;;;;GAKG;AACH,wBAAgB,wCAAwC,IAAI,0BAA0B,CA6CrF;AAGD,eAAO,MAAM,QAAQ;;CAEpB,CAAA"}