@commerce-ai-tool/angular 2.4.0

package/dist/vendor-core/types/index.d.ts

@@ -0,0 +1,510 @@
+import type { PaymentProvider } from "../payments/types.js";
+export type { PaymentMethodOption } from "../payments/types.js";
+export type ThemeMode = "auto" | "light" | "dark";
+export type AIProviderName = "openrouter" | "bedrock";
+export type VoiceMode = "openrouter-audio" | "elevenlabs-stt";
+export interface SearchCacheConfig {
+    ttlMs?: number;
+    maxEntries?: number;
+}
+export interface FacetConfig {
+    enabled?: boolean;
+    schemaTtlMs?: number;
+    include?: string[];
+    exclude?: string[];
+    maxAttributes?: number;
+}
+export interface SearchTimeoutsConfig {
+    aiTextMs?: number;
+    aiVoiceAudioMs?: number;
+    aiImageMs?: number;
+    commercetoolsMs?: number;
+    commercetoolsSuggestMs?: number;
+    elevenLabsTtsMs?: number;
+}
+export declare const SUGGESTIONS_MIN_PREFIX_LENGTH = 2;
+export declare const SUGGESTIONS_DEFAULT_LIMIT = 8;
+export declare const SUGGESTIONS_MAX_LIMIT = 20;
+export interface CommercetoolsConfig {
+    projectKey: string;
+    clientId: string;
+    clientSecret: string;
+    region: string;
+    scopes?: string[];
+}
+export interface OpenRouterConfig {
+    apiKey: string;
+    model?: string;
+    visionModel?: string;
+    /** Audio-capable model for direct voice search (OpenRouter input_audio). */
+    voiceModel?: string;
+    /**
+     * Use OpenRouter `json_schema` (strict) for structured interpretation.
+     * Falls back to `json_object` when the model rejects json_schema.
+     * Default: true.
+     */
+    jsonSchema?: boolean;
+}
+export interface BedrockConfig {
+    region: string;
+    modelId?: string;
+    visionModelId?: string;
+}
+export interface AIConfig {
+    provider: AIProviderName;
+    openrouter?: OpenRouterConfig;
+    bedrock?: BedrockConfig;
+}
+export interface ElevenLabsConfig {
+    apiKey: string;
+    sttModel?: string;
+    ttsVoiceId?: string;
+    ttsModel?: string;
+}
+export interface CommerceAIDefaults {
+    /** Language products are indexed in within commercetools */
+    catalogLocale?: string;
+    /** @deprecated Use catalogLocale */
+    locale?: string;
+    storeKey?: string;
+    limit?: number;
+    currency?: string;
+    /** ISO country code for cart and product-card price selection (optional). */
+    country?: string;
+}
+export interface PaymentConfig {
+    provider?: PaymentProvider;
+    /** Block order creation without a successful authorization. Defaults to true when a provider is set. */
+    requiredForOrder?: boolean;
+}
+export interface LangfuseConfig {
+    /** Derived from LANGFUSE_PUBLIC_KEY + LANGFUSE_SECRET_KEY when loading from env. */
+    enabled?: boolean;
+    /**
+     * Fetch system prompts from Langfuse at runtime.
+     * Applied via `configureLangfusePrompts` when creating the search orchestrator
+     * (or set `LANGFUSE_PROMPTS=true` when config omits this field).
+     * Local catalog remains the fallback and the source of truth for evals.
+     */
+    promptsEnabled?: boolean;
+    /** Langfuse prompt label (default `production`). From LANGFUSE_PROMPT_LABEL or this field. */
+    promptLabel?: string;
+    /** Client-side prompt cache TTL in seconds (default 60). From LANGFUSE_PROMPT_CACHE_TTL_SECONDS or this field. */
+    promptCacheTtlSeconds?: number;
+}
+export interface MissionsConfig {
+    /** Opt-in. When true, every fresh text search also runs mission decomposition. */
+    enabled?: boolean;
+    /** Maximum product intents kept from a decomposed mission. Default 5. */
+    maxIntents?: number;
+    /** Product Search limit per intent. Default 4. */
+    perIntentLimit?: number;
+    /** Minimum AI confidence (0–1) required to keep a mission. Default 0.6. */
+    minConfidence?: number;
+}
+export interface CommerceAIConfig {
+    commercetools: CommercetoolsConfig;
+    ai: AIConfig;
+    elevenlabs?: ElevenLabsConfig;
+    defaults?: CommerceAIDefaults;
+    voiceMode?: VoiceMode;
+    cache?: SearchCacheConfig;
+    timeouts?: SearchTimeoutsConfig;
+    facets?: FacetConfig;
+    langfuse?: LangfuseConfig;
+    payments?: PaymentConfig;
+    missions?: MissionsConfig;
+}
+export interface ProductCard {
+    id: string;
+    key?: string;
+    name: string;
+    description?: string;
+    imageUrl?: string;
+    /** SKU of the master variant — used for add-to-cart. */
+    sku?: string;
+    /** Master variant id — fallback when `sku` is missing. */
+    variantId?: number;
+    price?: {
+        amount: number;
+        currency: string;
+        formatted: string;
+    };
+    slug?: string;
+}
+export interface MoneyAmount {
+    amount: number;
+    currency: string;
+    formatted: string;
+}
+export interface CartLineItemSnapshot {
+    id: string;
+    name: string;
+    sku?: string;
+    productId: string;
+    quantity: number;
+    imageUrl?: string;
+    price?: MoneyAmount;
+    totalPrice?: MoneyAmount;
+}
+export interface CheckoutAddress {
+    firstName: string;
+    lastName: string;
+    streetName: string;
+    additionalStreetInfo?: string;
+    postalCode: string;
+    city: string;
+    region?: string;
+    country: string;
+    email?: string;
+    phone?: string;
+}
+export interface ShippingMethodSnapshot {
+    id: string;
+    name: string;
+    description?: string;
+    price?: MoneyAmount;
+}
+export interface PaymentSnapshot {
+    id: string;
+    key?: string;
+    interfaceId?: string;
+    paymentInterface: string;
+    method: string;
+    status: "authorized" | "pending" | "failed";
+    amount: MoneyAmount;
+    clientData?: Record<string, string>;
+}
+export interface DeliverySnapshot {
+    id: string;
+    trackingId?: string;
+    carrier?: string;
+    provider?: string;
+}
+/** Client-safe cart shape — never the raw commercetools Cart object. */
+export interface CartSnapshot {
+    id: string;
+    version: number;
+    anonymousId?: string;
+    customerId?: string;
+    lineItems: CartLineItemSnapshot[];
+    totalPrice: MoneyAmount;
+    totalQuantity: number;
+    shippingAddress?: CheckoutAddress;
+    billingAddress?: CheckoutAddress;
+    shippingMethod?: ShippingMethodSnapshot;
+    payments?: PaymentSnapshot[];
+}
+export interface OrderSnapshot {
+    id: string;
+    orderNumber?: string;
+    orderState: string;
+    createdAt?: string;
+    paymentState?: string;
+    shipmentState?: string;
+    customerEmail?: string;
+    totalPrice: MoneyAmount;
+    lineItems: CartLineItemSnapshot[];
+    shippingAddress?: CheckoutAddress;
+    billingAddress?: CheckoutAddress;
+    shippingMethod?: ShippingMethodSnapshot;
+    payments?: PaymentSnapshot[];
+    deliveries?: DeliverySnapshot[];
+}
+/** Public customer identity — never includes credentials. */
+export interface CustomerSnapshot {
+    id: string;
+    email: string;
+}
+/** HMAC cart session header for GET /cart — never send the token in the query string. */
+export declare const CART_SESSION_HEADER = "x-commerce-ai-cart-session";
+/** Upper bound for a single add-to-cart line quantity (mission add-all and batch add). */
+export declare const MAX_LINE_ITEM_QUANTITY = 99;
+export interface CartLoginRequest {
+    email: string;
+    password: string;
+    anonymousId?: string;
+    cartId?: string;
+    catalogLocale?: string;
+}
+export interface CartLoginResult {
+    cart: CartSnapshot | null;
+    customer: CustomerSnapshot;
+}
+export interface AddToCartLineItem {
+    sku?: string;
+    productId?: string;
+    variantId?: number;
+    quantity?: number;
+}
+export interface AddToCartRequest {
+    anonymousId?: string;
+    customerId?: string;
+    sku?: string;
+    productId?: string;
+    variantId?: number;
+    quantity?: number;
+    currency?: string;
+    country?: string;
+    catalogLocale?: string;
+    /** When set, add to this cart instead of looking up by anonymousId / customerId. */
+    cartId?: string;
+    sessionToken?: string;
+}
+export interface AddItemsToCartRequest {
+    anonymousId?: string;
+    customerId?: string;
+    items: AddToCartLineItem[];
+    currency?: string;
+    country?: string;
+    catalogLocale?: string;
+    cartId?: string;
+    sessionToken?: string;
+}
+export interface CartMutationRequest {
+    anonymousId?: string;
+    customerId?: string;
+    lineItemId: string;
+    cartId?: string;
+    cartVersion?: number;
+    catalogLocale?: string;
+    sessionToken?: string;
+}
+export interface UpdateCartQuantityRequest extends CartMutationRequest {
+    quantity: number;
+}
+export interface GetCartRequest {
+    anonymousId?: string;
+    customerId?: string;
+    catalogLocale?: string;
+    sessionToken?: string;
+}
+export interface CheckoutRequest {
+    anonymousId?: string;
+    customerId?: string;
+    cartId?: string;
+    catalogLocale?: string;
+    sessionToken?: string;
+}
+export interface SetCartAddressesRequest extends CheckoutRequest {
+    shippingAddress: CheckoutAddress;
+    billingAddress?: CheckoutAddress;
+}
+export interface SetShippingMethodRequest extends CheckoutRequest {
+    shippingMethodId: string;
+}
+export interface CreateOrderRequest extends CheckoutRequest {
+    orderNumber?: string;
+}
+export interface AuthorizePaymentRequest extends CheckoutRequest {
+    method: string;
+    orderNumber?: string;
+}
+export interface GetOrderRequest {
+    orderNumber?: string;
+    anonymousId?: string;
+    customerId?: string;
+    catalogLocale?: string;
+    sessionToken?: string;
+}
+export interface ListOrdersRequest {
+    anonymousId?: string;
+    customerId?: string;
+    catalogLocale?: string;
+    sessionToken?: string;
+    limit?: number;
+}
+export type SearchRelaxationLevel = "none" | "drop_soft_filters" | "primary_any_match";
+export interface SearchMeta {
+    total: number;
+    limit: number;
+    offset: number;
+    /** @deprecated Use catalogLocale */
+    locale: string;
+    catalogLocale: string;
+    queryLocale: string;
+    queryInterpretation?: string;
+    searchTerms?: string[];
+    /** Catalog-language phrase closest to the user's intent, when the model supplied one. */
+    primaryTerm?: string;
+    appliedFilters?: InterpretedSearchFilters;
+    /**
+     * How far Product Search was relaxed after an empty first result.
+     * Omitted when no relaxation ran (`none`).
+     */
+    relaxation?: SearchRelaxationLevel;
+    sort?: "relevance" | "price_asc" | "price_desc";
+    schemaEtag?: string;
+    /** Per-step durations in milliseconds (dev / CAT_DEBUG only) */
+    timings?: Record<string, number>;
+    /** Total pipeline duration in milliseconds (dev / CAT_DEBUG only) */
+    totalMs?: number;
+    /**
+     * Active OpenTelemetry / Langfuse trace id when Langfuse is enabled or CAT_DEBUG=true.
+     * Non-stable for client contracts — intended for local/dev linking.
+     */
+    traceId?: string;
+}
+export interface SearchResult {
+    products: ProductCard[];
+    meta: SearchMeta;
+    facets?: SearchFacetGroup[];
+    suggestedFacets?: SuggestedFacet[];
+    facetSchema?: FacetAttributeDefinition[];
+    /** Present when a compound shopping mission was executed. */
+    mission?: MissionSearchResult;
+}
+export interface SuggestionsRequest extends SearchLocaleOptions {
+    query: string;
+    limit?: number;
+}
+export interface SuggestionsResult {
+    suggestions: string[];
+    /**
+     * True when this request invoked AI `suggestSearchTerms` (not a cache hit).
+     * Used by the server to flush Langfuse on serverless hosts.
+     */
+    aiFallbackUsed?: boolean;
+}
+export interface TextSearchRequest {
+    query: string;
+    /** Language of the user query (AI input) */
+    queryLocale?: string;
+    /** Language products are indexed in commercetools */
+    catalogLocale?: string;
+    /** @deprecated Use queryLocale */
+    locale?: string;
+    limit?: number;
+    offset?: number;
+    filters?: InterpretedSearchFilters;
+    searchTerms?: string[];
+    sort?: "relevance" | "price_asc" | "price_desc";
+    refineQuery?: string;
+    includeFacets?: boolean;
+    /** AI-suggested facets from the active search session (chip refine). */
+    suggestedFacets?: SuggestedFacet[];
+    /** Per-request override of `CommerceAIConfig.missions.enabled`. */
+    enableMissions?: boolean;
+}
+export interface SearchLocaleOptions {
+    queryLocale?: string;
+    catalogLocale?: string;
+    /** @deprecated Use queryLocale */
+    locale?: string;
+}
+export interface SearchLocaleContext {
+    queryLocale: string;
+    catalogLocale: string;
+}
+export interface VoiceSearchResult extends SearchResult {
+    transcript: string;
+    enhancedQuery?: string;
+}
+export interface ImageSearchResult extends SearchResult {
+    interpretation: string;
+}
+/** Standard filter keys returned by AI interpretation (all optional). */
+export interface InterpretedSearchFilters {
+    color?: string;
+    brand?: string;
+    category?: string;
+    priceMin?: string;
+    priceMax?: string;
+    [key: string]: string | undefined;
+}
+export interface InterpretedSearchQuery {
+    /**
+     * Catalog-language phrase closest to the user's intent.
+     * Product Search boosts this phrase above the other `searchTerms`.
+     * Kept separate from `searchTerms[0]` because same-language query passthrough
+     * prepends the typed query without changing intent priority.
+     */
+    primaryTerm?: string;
+    /**
+     * Catalog-language search phrases. Product Search matches any phrase (OR).
+     * Each element is a complete phrase (e.g. `"red shoes"`), not a split word.
+     * Broad intents may include 3–5 synonym or hyponym phrases.
+     */
+    searchTerms: string[];
+    filters?: InterpretedSearchFilters;
+    suggestedFacets?: SuggestedFacet[];
+    sort?: "relevance" | "price_asc" | "price_desc";
+    interpretation: string;
+}
+export interface ShoppingIntent {
+    /** Stable id for UI keys and selection (`intent-0`, `intent-1`, …). */
+    id: string;
+    /** Short catalog-language label, e.g. "tennis racket". */
+    label: string;
+    /** Requested quantity, always >= 1. */
+    quantity: number;
+    /** Catalog-language phrase closest to this intent, boosted above alternates. */
+    primaryTerm?: string;
+    searchTerms: string[];
+    filters?: InterpretedSearchFilters;
+    sort?: "relevance" | "price_asc" | "price_desc";
+}
+export interface DecomposedShoppingMission {
+    isMission: boolean;
+    /** 0–1. Missions below the configured minConfidence fall back to standard search. */
+    confidence: number;
+    intents: ShoppingIntent[];
+    interpretation: string;
+}
+export interface MissionIntentGroup {
+    intent: ShoppingIntent;
+    products: ProductCard[];
+    total: number;
+    /** True when this intent's Product Search failed; other groups still render. */
+    failed?: boolean;
+}
+export interface MissionSearchResult {
+    intents: MissionIntentGroup[];
+    interpretation: string;
+}
+export type FacetAttributeType = "enum" | "lenum" | "boolean" | "text" | "number";
+export interface FacetAttributeDefinition {
+    name: string;
+    label: string;
+    kind: "distinct" | "range";
+    attributeType: FacetAttributeType;
+    field: string;
+    fieldType?: string;
+}
+export interface ResolvedFacetSchema {
+    attributes: FacetAttributeDefinition[];
+    systemFacets: Array<"categories" | "price">;
+    etag: string;
+    resolvedAt: string;
+}
+export interface SuggestedFacet {
+    name: string;
+    reason?: string;
+}
+export interface SearchFacetBucket {
+    key: string;
+    label: string;
+    count: number;
+}
+export interface SearchFacetGroup {
+    id: string;
+    label: string;
+    type: "distinct" | "range";
+    buckets: SearchFacetBucket[];
+    selectedKey?: string;
+}
+export interface SearchSessionState {
+    query: string;
+    searchTerms: string[];
+    appliedFilters: InterpretedSearchFilters;
+    suggestedFacets: SuggestedFacet[];
+    facetSchema?: FacetAttributeDefinition[];
+    schemaEtag?: string;
+}
+export interface VoiceAudioInterpretation extends InterpretedSearchQuery {
+    transcript: string;
+    enhancedQuery: string;
+}
+/** @deprecated Use ProductSearchRequest from query-builder / platform-sdk */
+export type { ProductSearchRequest as ProductSearchQueryBody } from "@commercetools/platform-sdk";
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@commerce-ai-tool/angular",
+  "version": "2.4.0",
+  "description": "Angular component for Commerce AI Tool — glass morphism product search widget",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./styles.css": "./dist/index.css"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "peerDependencies": {
+    "@angular/common": ">=17",
+    "@angular/core": ">=17",
+    "@angular/forms": ">=17",
+    "rxjs": ">=7"
+  },
+  "devDependencies": {
+    "@angular/common": "^20.3.27",
+    "@angular/compiler": "^20.3.27",
+    "@angular/core": "^20.3.27",
+    "@angular/forms": "^19.2.3",
+    "@angular/platform-browser": "^19.2.3",
+    "rxjs": "^7.8.2",
+    "tsup": "^8.4.0",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "vitest": "^3.0.9",
+    "zone.js": "^0.15.0",
+    "@commerce-ai-tool/core": "2.4.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": {
+    "name": "Tomasz Miller",
+    "url": "https://github.com/tomasz-miller"
+  },
+  "homepage": "https://github.com/tomasz-miller/commerce-ai-tool#readme",
+  "bugs": {
+    "url": "https://github.com/tomasz-miller/commerce-ai-tool/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tomasz-miller/commerce-ai-tool.git",
+    "directory": "packages/angular"
+  },
+  "keywords": [
+    "commercetools",
+    "ai",
+    "search",
+    "angular",
+    "widget"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "tsup && node ../../scripts/emit-package-dts.mjs dist/index.d.ts && node ../../scripts/inline-core-client-dts.mjs",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}