@commerce-ai-tool/core 2.4.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# @commerce-ai-tool/core
+
+## 2.4.0
+
+### Initial public release
+
+First published version of the Commerce AI Tool plugin (product roadmap through v2.4).
+
+- AI-powered commercetools Product Search (OpenRouter or AWS Bedrock) with voice, text, and image input
+- Autocomplete via Search Term Suggestions, AI suggestion fallback, and AI-suggested facets
+- Optional `primaryTerm` boosting, multi-keyword OR search, and empty-result retries (drop soft filters, then match the primary phrase)
+- Product-card hydrate via GraphQL after ID-only Product Search
+- Anonymous and authenticated carts, host-routed checkout, payment provider hooks, and order confirmation
+- Multi-item shopping missions (compound queries split into parallel Product Search calls)
+- Opt-in Langfuse observability
+- Browser-safe `@commerce-ai-tool/core/client` export for widgets (types, messages, facet helpers). Do not install `core` in a frontend-only app; `@commerce-ai-tool/server` pulls the full package on the backend.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Commerce AI Tool Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @commerce-ai-tool/core
+
+Framework-agnostic search logic, AI adapters, and the commercetools client for [Commerce AI Tool](https://github.com/tomasz-miller/commerce-ai-tool).
+
+Host storefronts should not install this package in the browser app. Install `@commerce-ai-tool/server` on the backend; it depends on `core`. The React and Angular widgets bundle a small client-safe surface and do not declare `core` as a runtime dependency.
+
+```bash
+pnpm add @commerce-ai-tool/server
+```
+
+Setup: [Getting started](https://github.com/tomasz-miller/commerce-ai-tool/blob/main/docs/GETTING-STARTED.md).

package/dist/ai/factory.d.ts

@@ -0,0 +1,5 @@
+import type { AIConfig } from "../types/index.js";
+import type { AIProvider } from "./types.js";
+export type { AIProvider } from "./types.js";
+export declare function createAIProvider(config: AIConfig): AIProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/ai/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/ai/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAa7D"}

package/dist/ai/index.d.ts

@@ -0,0 +1,3 @@
+export type { AIProvider } from "./types.js";
+export { createAIProvider } from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/ai/json-schema-errors.d.ts

@@ -0,0 +1,4 @@
+/** Detect when OpenRouter rejected `json_schema` so we can retry `json_object`. */
+export declare function isJsonSchemaUnsupportedMessage(body: string): boolean;
+export declare function isJsonSchemaUnsupportedError(error: unknown): boolean;
+//# sourceMappingURL=json-schema-errors.d.ts.map

package/dist/ai/json-schema-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-errors.d.ts","sourceRoot":"","sources":["../../src/ai/json-schema-errors.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAapE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGpE"}

package/dist/ai/providers/bedrock.d.ts

@@ -0,0 +1,19 @@
+import type { BedrockConfig, FacetAttributeDefinition, SearchLocaleContext, VoiceAudioInterpretation } from "../../types/index.js";
+import type { AIProvider } from "../types.js";
+export declare class BedrockProvider implements AIProvider {
+    private readonly client;
+    private readonly modelId;
+    private readonly visionModelId;
+    constructor(config: BedrockConfig);
+    interpretTextQuery(text: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<import("../../client.js").InterpretedSearchQuery>;
+    interpretRefineQuery(text: string, context: Parameters<AIProvider["interpretRefineQuery"]>[1], locales: SearchLocaleContext): Promise<import("../../client.js").InterpretedSearchQuery>;
+    interpretImageQuery(imageBase64: string, mimeType: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<import("../../client.js").InterpretedSearchQuery>;
+    interpretVoiceAudio(_audio: Uint8Array, _mimeType: string, _locales: SearchLocaleContext, _attributeCatalog?: FacetAttributeDefinition[]): Promise<VoiceAudioInterpretation>;
+    enhanceVoiceTranscript(transcript: string, locales: SearchLocaleContext): Promise<string>;
+    suggestSearchTerms(query: string, locales: SearchLocaleContext, limit?: number): Promise<string[]>;
+    summarizeVoiceResults(count: number, topProductName: string | undefined, locales: SearchLocaleContext): Promise<string>;
+    decomposeShoppingMission(text: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<import("../../client.js").DecomposedShoppingMission>;
+    private converse;
+    private extractText;
+}
+//# sourceMappingURL=bedrock.d.ts.map

package/dist/ai/providers/bedrock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/bedrock.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuB9C,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,YAAY,MAAM,EAAE,aAAa,EAIhC;IAEK,kBAAkB,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,GAAE,wBAAwB,EAAO,6DAoBlD;IAEK,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,EAC1D,OAAO,EAAE,mBAAmB,6DAkB7B;IAEK,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,GAAE,wBAAwB,EAAO,6DA2BlD;IAEK,mBAAmB,CACvB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,mBAAmB,EAC7B,iBAAiB,CAAC,EAAE,wBAAwB,EAAE,GAC7C,OAAO,CAAC,wBAAwB,CAAC,CAInC;IAEK,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,mBAc5E;IAEK,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,SAAI,qBAiB9E;IAEK,qBAAqB,CACzB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,mBAAmB,mBAe7B;IAEK,wBAAwB,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,GAAE,wBAAwB,EAAO,gEAkBlD;YAEa,QAAQ;IAUtB,OAAO,CAAC,WAAW;CAWpB"}

package/dist/ai/providers/openrouter.d.ts

@@ -0,0 +1,27 @@
+import type { FacetAttributeDefinition, OpenRouterConfig, SearchLocaleContext } from "../../types/index.js";
+import type { AIProvider, GenerationMetrics } from "../types.js";
+export declare class OpenRouterProvider implements AIProvider {
+    private readonly client;
+    private readonly apiKey;
+    private readonly model;
+    private readonly visionModel;
+    private readonly voiceModel;
+    private readonly useJsonSchema;
+    private lastMetrics;
+    constructor(config: OpenRouterConfig);
+    getLastGenerationMetrics(): GenerationMetrics | undefined;
+    interpretTextQuery(text: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<import("../../client.js").InterpretedSearchQuery>;
+    interpretRefineQuery(text: string, context: Parameters<AIProvider["interpretRefineQuery"]>[1], locales: SearchLocaleContext): Promise<import("../../client.js").InterpretedSearchQuery>;
+    interpretImageQuery(imageBase64: string, mimeType: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<import("../../client.js").InterpretedSearchQuery>;
+    interpretVoiceAudio(audio: Uint8Array, mimeType: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<import("../../client.js").VoiceAudioInterpretation>;
+    enhanceVoiceTranscript(transcript: string, locales: SearchLocaleContext): Promise<string>;
+    suggestSearchTerms(query: string, locales: SearchLocaleContext, limit?: number): Promise<string[]>;
+    summarizeVoiceResults(count: number, topProductName: string | undefined, locales: SearchLocaleContext): Promise<string>;
+    decomposeShoppingMission(text: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<import("../../client.js").DecomposedShoppingMission>;
+    private sendStructured;
+    private toApiResponseFormat;
+    private sendChatCompletion;
+    private captureUsage;
+    private extractContent;
+}
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/ai/providers/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/openrouter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoCjE,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,WAAW,CAAgC;IAEnD,YAAY,MAAM,EAAE,gBAAgB,EAOnC;IAED,wBAAwB,IAAI,iBAAiB,GAAG,SAAS,CAExD;IAEK,kBAAkB,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,GAAE,wBAAwB,EAAO,6DAiBlD;IAEK,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,EAC1D,OAAO,EAAE,mBAAmB,6DAY7B;IAEK,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,GAAE,wBAAwB,EAAO,6DAsBlD;IAEK,mBAAmB,CACvB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,GAAE,wBAAwB,EAAO,+DAsClD;IAEK,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,mBAe5E;IAEK,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,SAAI,qBAc9E;IAEK,qBAAqB,CACzB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,mBAAmB,mBAgB7B;IAEK,wBAAwB,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,GAAE,wBAAwB,EAAO,gEAelD;YAEa,cAAc;IAsC5B,OAAO,CAAC,mBAAmB;YAcb,kBAAkB;IAwChC,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;CAqBvB"}

package/dist/ai/types.d.ts

@@ -0,0 +1,23 @@
+import type { DecomposedShoppingMission, FacetAttributeDefinition, InterpretedSearchFilters, InterpretedSearchQuery, SearchLocaleContext, VoiceAudioInterpretation } from "../types/index.js";
+export interface GenerationMetrics {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    cost?: number;
+}
+export interface AIProvider {
+    interpretTextQuery(text: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<InterpretedSearchQuery>;
+    interpretRefineQuery(text: string, context: {
+        searchTerms: string[];
+        filters: InterpretedSearchFilters;
+        attributeCatalog: FacetAttributeDefinition[];
+    }, locales: SearchLocaleContext): Promise<InterpretedSearchQuery>;
+    interpretImageQuery(imageBase64: string, mimeType: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<InterpretedSearchQuery>;
+    interpretVoiceAudio(audio: Uint8Array, mimeType: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<VoiceAudioInterpretation>;
+    enhanceVoiceTranscript(transcript: string, locales: SearchLocaleContext): Promise<string>;
+    suggestSearchTerms(query: string, locales: SearchLocaleContext, limit?: number): Promise<string[]>;
+    summarizeVoiceResults(count: number, topProductName: string | undefined, locales: SearchLocaleContext): Promise<string>;
+    decomposeShoppingMission(text: string, locales: SearchLocaleContext, attributeCatalog?: FacetAttributeDefinition[]): Promise<DecomposedShoppingMission>;
+    getLastGenerationMetrics?(): GenerationMetrics | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,CAAC,EAAE,wBAAwB,EAAE,GAC5C,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC,oBAAoB,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,wBAAwB,CAAC;QAClC,gBAAgB,EAAE,wBAAwB,EAAE,CAAC;KAC9C,EACD,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC,mBAAmB,CACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,CAAC,EAAE,wBAAwB,EAAE,GAC5C,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC,mBAAmB,CACjB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,CAAC,EAAE,wBAAwB,EAAE,GAC5C,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1F,kBAAkB,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,EAC5B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrB,qBAAqB,CACnB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,wBAAwB,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,CAAC,EAAE,wBAAwB,EAAE,GAC5C,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtC,wBAAwB,CAAC,IAAI,iBAAiB,GAAG,SAAS,CAAC;CAC5D"}

package/dist/cache/search-cache.d.ts

@@ -0,0 +1,19 @@
+export interface SearchCacheConfig {
+    ttlMs?: number;
+    maxEntries?: number;
+}
+export declare class SearchCache<T> {
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private readonly store;
+    constructor(config?: SearchCacheConfig);
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+}
+export declare function normalizeCacheKeyPart(value: string): string;
+export declare function buildTextSearchCacheKey(query: string, queryLocale: string, catalogLocale: string, limit: number): string;
+export declare function buildInterpretedSearchCacheKey(interpretedKey: string, catalogLocale: string, limit: number): string;
+export declare function buildSuggestionsCacheKey(query: string, suggestLocale: string, limit: number): string;
+export declare function buildImageSearchCacheKey(imageHash: string, mimeType: string, queryLocale: string, catalogLocale: string, limit: number, missionsEnabled?: boolean): string;
+export declare function buildVoiceSearchCacheKey(audioHash: string, mimeType: string, voiceMode: string, queryLocale: string, catalogLocale: string, limit: number, enableTts: boolean, missionsEnabled?: boolean): string;
+//# sourceMappingURL=search-cache.d.ts.map

package/dist/cache/search-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-cache.d.ts","sourceRoot":"","sources":["../../src/cache/search-cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,qBAAa,WAAW,CAAC,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAE1D,YAAY,MAAM,CAAC,EAAE,iBAAiB,EAGrC;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAY9B;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAY/B;CACF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAED,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,MAAM,CAOR;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,eAAe,UAAQ,GACtB,MAAM,CAUR;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,EAClB,eAAe,UAAQ,GACtB,MAAM,CAYR"}

package/dist/client.cjs

@@ -0,0 +1,423 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  CART_SESSION_HEADER: () => CART_SESSION_HEADER,
+  DEFAULT_COMMERCE_AI_SEARCH_MESSAGES: () => DEFAULT_COMMERCE_AI_SEARCH_MESSAGES,
+  MAX_LINE_ITEM_QUANTITY: () => MAX_LINE_ITEM_QUANTITY,
+  hexColorSwatchValue: () => hexColorSwatchValue,
+  isColorLikeFacetName: () => isColorLikeFacetName,
+  isFacetFilterSelected: () => isFacetFilterSelected,
+  looksLikeCompoundShoppingList: () => looksLikeCompoundShoppingList,
+  resolveCommerceAISearchMessages: () => resolveCommerceAISearchMessages,
+  toggleFacetFilter: () => toggleFacetFilter
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/types/index.ts
+var CART_SESSION_HEADER = "x-commerce-ai-cart-session";
+var MAX_LINE_ITEM_QUANTITY = 99;
+
+// src/messages/index.ts
+var DEFAULT_COMMERCE_AI_SEARCH_MESSAGES = {
+  placeholder: "What are you looking for?",
+  searchAriaLabel: "Search query",
+  productSearchAriaLabel: "Product search",
+  searchResultsAriaLabel: "Search results",
+  searching: "Searching...",
+  noProductsFound: "No products found",
+  searchedFor: "Searched for:",
+  dropImageToSearch: "Drop image to search",
+  voiceSearch: "Voice search",
+  stopRecording: "Stop recording",
+  searchByCamera: "Search by camera",
+  searchByImage: "Search by image",
+  replayVoiceSummary: "Replay voice result summary",
+  listening: "Listening\u2026",
+  tapMicToStop: "Tap mic to stop",
+  understandingQuery: "Understanding your query\u2026",
+  preparingAudioSummary: "Preparing audio summary\u2026",
+  cameraCapture: "Camera capture",
+  cameraPreview: "Camera preview",
+  capturePhoto: "Capture",
+  cancel: "Cancel",
+  dismiss: "Dismiss",
+  searchFailed: "Search failed",
+  imageSearchFailed: "Image search failed",
+  couldNotCapturePhoto: "Could not capture photo",
+  suggestionsAriaLabel: "Search suggestions",
+  loadingSuggestions: "Loading suggestions...",
+  noSuggestions: "No suggestions",
+  filtersAriaLabel: "Search filters",
+  clearFilters: "Clear filters",
+  narrowResults: "Narrow your results",
+  newSearch: "New search",
+  addToCart: "Add to cart",
+  cart: "Cart",
+  emptyCart: "Your cart is empty",
+  removeItem: "Remove item",
+  total: "Total",
+  each: "each",
+  cartAriaLabel: "Shopping cart",
+  itemAdded: "Added to cart",
+  increaseQuantity: "Increase quantity",
+  decreaseQuantity: "Decrease quantity",
+  closeCart: "Close cart",
+  unableToAddToCart: "This product cannot be added to the cart",
+  missionTitle: "Shopping list",
+  missionQuantity: "Looking for",
+  missionAddAll: "Add {count} top picks to cart",
+  missionItemsAdded: "Added to cart",
+  missionSelectProduct: "Select this product",
+  missionIntentEmpty: "No matching products",
+  missionIntentFailed: "Couldn't search this item",
+  signIn: "Sign in",
+  signInToSyncCart: "Sign in to sync your cart",
+  signOut: "Sign out",
+  email: "Email",
+  password: "Password",
+  signedInAs: "Signed in as",
+  invalidCredentials: "Invalid email or password",
+  signInFailed: "Sign in failed",
+  checkout: "Checkout",
+  checkoutTitle: "Complete your order",
+  orderSummary: "Order summary",
+  shippingAddress: "Shipping address",
+  billingAddress: "Billing address",
+  billingSameAsShipping: "Billing address is the same as shipping",
+  continueToDelivery: "Continue to delivery",
+  shippingMethod: "Delivery method",
+  selectShippingMethod: "Select a delivery method",
+  noShippingMethods: "No delivery methods are available for this address",
+  completeAddressToContinue: "Add a shipping address to continue",
+  selectDeliveryToContinue: "Select a delivery method to continue",
+  selectPaymentToContinue: "Select a payment method to continue",
+  checkoutStepAddress: "Address",
+  checkoutStepDelivery: "Delivery",
+  checkoutStepPayment: "Payment",
+  paymentMethod: "Payment method",
+  selectPaymentMethod: "Select a payment method",
+  paymentAuthorized: "Payment authorized",
+  paymentDeclined: "Payment was declined",
+  continueToPayment: "Continue to payment",
+  placeOrder: "Place order",
+  placingOrder: "Placing order\u2026",
+  orderPlaced: "Order placed",
+  viewOrderStatus: "View order status",
+  continueShopping: "Continue shopping",
+  checkoutFailed: "Checkout failed",
+  orderStatus: "Order status",
+  orderPlacedAt: "Placed",
+  paymentStateLabel: "Payment",
+  shipmentStateLabel: "Shipment",
+  trackingNumber: "Tracking number",
+  carrier: "Carrier",
+  noTrackingYet: "Tracking details will appear when the order ships",
+  orderNotFound: "Order not found",
+  noOrdersYet: "No orders yet",
+  yourOrders: "Your orders",
+  firstName: "First name",
+  lastName: "Last name",
+  streetName: "Street address",
+  additionalAddress: "Apartment, suite, etc. (optional)",
+  postalCode: "Postal code",
+  city: "City",
+  region: "State or region (optional)",
+  country: "Country"
+};
+function resolveCommerceAISearchMessages(overrides) {
+  return {
+    ...DEFAULT_COMMERCE_AI_SEARCH_MESSAGES,
+    ...overrides
+  };
+}
+
+// src/search/compound-shopping-list.ts
+var COMPOUND_SHOPPING_LIST_PATTERN = /\band\b|,|\bplus\b|\boraz\b/i;
+function looksLikeCompoundShoppingList(query) {
+  return COMPOUND_SHOPPING_LIST_PATTERN.test(query.trim());
+}
+
+// src/commercetools/facet-color.ts
+var CSS_NAMED_COLOR_TABLE = `
+Alice Blue:f0f8ff
+Antique White:faebd7
+Aqua:00ffff
+Aquamarine:7fffd4
+Azure:f0ffff
+Beige:f5f5dc
+Bisque:ffe4c4
+Black:000000
+Blanched Almond:ffebcd
+Blue:0000ff
+Blue Violet:8a2be2
+Brown:a52a2a
+Burlywood:deb887
+Cadet Blue:5f9ea0
+Chartreuse:7fff00
+Chocolate:d2691e
+Coral:ff7f50
+Cornflower Blue:6495ed
+Cornsilk:fff8dc
+Crimson:dc143c
+Dark Blue:00008b
+Dark Cyan:008b8b
+Dark Goldenrod:b8860b
+Dark Gray:a9a9a9
+Dark Green:006400
+Dark Khaki:bdb76b
+Dark Magenta:8b008b
+Dark Olive Green:556b2f
+Dark Orange:ff8c00
+Dark Orchid:9932cc
+Dark Red:8b0000
+Dark Salmon:e9967a
+Dark Sea Green:8fbc8f
+Dark Slate Blue:483d8b
+Dark Slate Gray:2f4f4f
+Dark Turquoise:00ced1
+Dark Violet:9400d3
+Deep Pink:ff1493
+Deep Sky Blue:00bfff
+Dim Gray:696969
+Dodger Blue:1e90ff
+Firebrick:b22222
+Floral White:fffaf0
+Forest Green:228b22
+Gainsboro:dcdcdc
+Ghost White:f8f8ff
+Gold:ffd700
+Goldenrod:daa520
+Gray:808080
+Green:008000
+Green Yellow:adff2f
+Honeydew:f0fff0
+Hot Pink:ff69b4
+Indian Red:cd5c5c
+Indigo:4b0082
+Ivory:fffff0
+Khaki:f0e68c
+Lavender:e6e6fa
+Lavender Blush:fff0f5
+Lawn Green:7cfc00
+Lemon Chiffon:fffacd
+Light Blue:add8e6
+Light Coral:f08080
+Light Cyan:e0ffff
+Light Goldenrod Yellow:fafad2
+Light Gray:d3d3d3
+Light Green:90ee90
+Light Pink:ffb6c1
+Light Salmon:ffa07a
+Light Sea Green:20b2aa
+Light Sky Blue:87cefa
+Light Slate Gray:778899
+Light Steel Blue:b0c4de
+Light Yellow:ffffe0
+Lime:00ff00
+Lime Green:32cd32
+Linen:faf0e6
+Magenta:ff00ff
+Maroon:800000
+Medium Aquamarine:66cdaa
+Medium Blue:0000cd
+Medium Orchid:ba55d3
+Medium Purple:9370db
+Medium Sea Green:3cb371
+Medium Slate Blue:7b68ee
+Medium Spring Green:00fa9a
+Medium Turquoise:48d1cc
+Medium Violet Red:c71585
+Midnight Blue:191970
+Mint Cream:f5fffa
+Misty Rose:ffe4e1
+Moccasin:ffe4b5
+Navajo White:ffdead
+Navy:000080
+Old Lace:fdf5e6
+Olive:808000
+Olive Drab:6b8e23
+Orange:ffa500
+Orange Red:ff4500
+Orchid:da70d6
+Pale Goldenrod:eee8aa
+Pale Green:98fb98
+Pale Turquoise:afeeee
+Pale Violet Red:db7093
+Papaya Whip:ffefd5
+Peach Puff:ffdab9
+Peru:cd853f
+Pink:ffc0cb
+Plum:dda0dd
+Powder Blue:b0e0e6
+Purple:800080
+Rebecca Purple:663399
+Red:ff0000
+Rosy Brown:bc8f8f
+Royal Blue:4169e1
+Saddle Brown:8b4513
+Salmon:fa8072
+Sandy Brown:f4a460
+Sea Green:2e8b57
+Seashell:fff5ee
+Sienna:a0522d
+Silver:c0c0c0
+Sky Blue:87ceeb
+Slate Blue:6a5acd
+Slate Gray:708090
+Snow:fffafa
+Spring Green:00ff7f
+Steel Blue:4682b4
+Tan:d2b48c
+Teal:008080
+Thistle:d8bfd8
+Tomato:ff6347
+Turquoise:40e0d0
+Violet:ee82ee
+Wheat:f5deb3
+White:ffffff
+White Smoke:f5f5f5
+Yellow:ffff00
+Yellow Green:9acd32
+`;
+var HEX_COLOR_RE = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;
+var NAMED_COLORS = CSS_NAMED_COLOR_TABLE.trim().split("\n").flatMap((line) => {
+  const separator = line.indexOf(":");
+  if (separator <= 0) {
+    return [];
+  }
+  const name = line.slice(0, separator);
+  const hex = line.slice(separator + 1);
+  const n = Number.parseInt(hex, 16);
+  if (!name || !Number.isFinite(n)) {
+    return [];
+  }
+  return [{ name, r: n >> 16 & 255, g: n >> 8 & 255, b: n & 255 }];
+});
+function parseHexRgb(value) {
+  const match = HEX_COLOR_RE.exec(value.trim());
+  const captured = match?.[1];
+  if (!captured) {
+    return null;
+  }
+  const hex = captured.length === 3 ? `${captured[0]}${captured[0]}${captured[1]}${captured[1]}${captured[2]}${captured[2]}` : captured;
+  const n = Number.parseInt(hex, 16);
+  return [n >> 16 & 255, n >> 8 & 255, n & 255];
+}
+var MAX_NAMED_COLOR_DISTANCE_SQ = 40 * 40;
+var COLOR_LIKE_FACET_NAME = /(?:^|[-_])colou?r(?:[-_]|$)|(?:^|[-_])finish(?:[-_]|$)/i;
+function isColorLikeFacetName(name) {
+  return COLOR_LIKE_FACET_NAME.test(name.trim());
+}
+function hexColorSwatchValue(value) {
+  const rgb = parseHexRgb(value);
+  if (!rgb) {
+    return void 0;
+  }
+  return `#${rgb.map((channel) => channel.toString(16).padStart(2, "0")).join("")}`;
+}
+
+// src/commercetools/facets.ts
+var PRICE_FACET_ID = "price";
+var CATEGORIES_FACET_ID = "categories";
+var DEFAULT_PRICE_RANGES = [
+  { key: "under-50", to: 5e3 },
+  { key: "50-to-100", from: 5e3, to: 1e4 },
+  { key: "100-plus", from: 1e4 }
+];
+function priceRangeToFilterValues(range) {
+  const filters = {};
+  if ("from" in range && range.from !== void 0) {
+    filters.priceMin = String(range.from / 100);
+  }
+  if ("to" in range && range.to !== void 0) {
+    filters.priceMax = String(range.to / 100);
+  }
+  return filters;
+}
+function priceBucketKeyFromFilters(filters) {
+  const minCents = parseMajorToCents(filters.priceMin);
+  const maxCents = parseMajorToCents(filters.priceMax);
+  for (const range of DEFAULT_PRICE_RANGES) {
+    const from = "from" in range ? range.from : void 0;
+    const to = "to" in range ? range.to : void 0;
+    if (minCents === from && maxCents === to) {
+      return range.key;
+    }
+  }
+  return void 0;
+}
+function isFacetFilterSelected(filters, facetId, bucketKey) {
+  if (facetId === CATEGORIES_FACET_ID) {
+    return filters.category === bucketKey;
+  }
+  if (facetId === PRICE_FACET_ID) {
+    return priceBucketKeyFromFilters(filters) === bucketKey;
+  }
+  return filters[facetId] === bucketKey;
+}
+function toggleFacetFilter(filters, facetId, bucketKey) {
+  const next = { ...filters };
+  if (facetId === PRICE_FACET_ID) {
+    if (priceBucketKeyFromFilters(next) === bucketKey) {
+      delete next.priceMin;
+      delete next.priceMax;
+      return next;
+    }
+    delete next.priceMin;
+    delete next.priceMax;
+    const range = DEFAULT_PRICE_RANGES.find((candidate) => candidate.key === bucketKey);
+    if (!range) {
+      return next;
+    }
+    return { ...next, ...priceRangeToFilterValues(range) };
+  }
+  const filterKey = facetId === CATEGORIES_FACET_ID ? "category" : facetId;
+  if (next[filterKey] === bucketKey) {
+    delete next[filterKey];
+  } else {
+    next[filterKey] = bucketKey;
+  }
+  return next;
+}
+function parseMajorToCents(value) {
+  if (!value) {
+    return void 0;
+  }
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || parsed < 0) {
+    return void 0;
+  }
+  return Math.round(parsed * 100);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CART_SESSION_HEADER,
+  DEFAULT_COMMERCE_AI_SEARCH_MESSAGES,
+  MAX_LINE_ITEM_QUANTITY,
+  hexColorSwatchValue,
+  isColorLikeFacetName,
+  isFacetFilterSelected,
+  looksLikeCompoundShoppingList,
+  resolveCommerceAISearchMessages,
+  toggleFacetFilter
+});
+//# sourceMappingURL=client.cjs.map