@pvh-afl/core 1.2.14 → 1.2.15

package/dist/common/circuit-breaker.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Circuit Breaker
+ *
+ * Wraps a flaky upstream at the *call site* so a failing vendor is skipped
+ * instead of being waited on. Two states only; the "probe" that tests recovery
+ * is claimed with a timestamp, never a lock, so no code path can leave the
+ * breaker stuck (see SEARCH-FALLBACK-IMPLEMENTATION.md §7.9).
+ *
+ * Failure classification stays with the caller — this class only counts
+ * outcomes it is told about, which keeps it vendor-agnostic.
+ */
+export type BreakerState = 'CLOSED' | 'OPEN';
+export interface CircuitBreakerOptions {
+    /** Identifier used in logs and metrics, e.g. 'wizzy'. */
+    name: string;
+    /** Absolute failures inside windowMs that trip the breaker. */
+    failureThreshold: number;
+    /** Failure fraction (0-1) that trips the breaker once minimumCalls is met. */
+    failureRateThreshold: number;
+    /** Minimum recorded calls before the rate rule applies. */
+    minimumCalls: number;
+    /** Rolling window for failure counting. */
+    windowMs: number;
+    /** First cooldown after tripping. */
+    openMs: number;
+    /** Upper bound on the doubling cooldown. */
+    maxOpenMs: number;
+    /** Minimum gap between probes. Must exceed the upstream's own timeout. */
+    probeIntervalMs: number;
+}
+export declare const DEFAULT_BREAKER_OPTIONS: Omit<CircuitBreakerOptions, 'name'>;
+export interface BreakerDecision {
+    allowed: boolean;
+    state: BreakerState;
+    reason: 'closed' | 'cooling-down' | 'probe-recent' | 'probe';
+}
+export declare class CircuitBreaker {
+    private readonly opts;
+    private readonly bucketMs;
+    private state;
+    private openedAt;
+    private lastProbeAt;
+    private consecutiveOpens;
+    private buckets;
+    constructor(options: Partial<CircuitBreakerOptions> & {
+        name: string;
+    });
+    get name(): string;
+    /**
+     * Decide whether the upstream may be called. In OPEN this also claims the
+     * probe window when one is due — claiming is a timestamp write, so there is
+     * nothing to release afterwards.
+     */
+    canAttempt(now?: number): BreakerDecision;
+    /** Upstream answered correctly. A success while OPEN closes the breaker. */
+    recordSuccess(now?: number): void;
+    /** Upstream is broken. May trip the breaker, or extend the cooldown. */
+    recordFailure(now?: number): void;
+    getState(): BreakerState;
+    getLastProbeAt(): number;
+    /** Snapshot for /health and logs. */
+    getSnapshot(now?: number): {
+        name: string;
+        state: BreakerState;
+        openedAt: number;
+        lastProbeAt: number;
+        consecutiveOpens: number;
+        cooldownMs: number;
+        msUntilNextProbe: number;
+        failures: number;
+        successes: number;
+    };
+    /** Cooldown doubles per consecutive open, capped at maxOpenMs. */
+    private currentOpenMs;
+    private shouldTrip;
+    /** Bucket for `now`, reset if the slot has rotated past its window. */
+    private bucketFor;
+    private windowTotals;
+    private resetWindow;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/common/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/common/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,uBAAuB,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAQvE,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,OAAO,CAAC;CAC9D;AAWD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,OAAO,CAAW;gBAEd,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAUtE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,UAAU,CAAC,GAAG,GAAE,MAAmB,GAAG,eAAe;IAiBrD,4EAA4E;IAC5E,aAAa,CAAC,GAAG,GAAE,MAAmB,GAAG,IAAI;IAW7C,wEAAwE;IACxE,aAAa,CAAC,GAAG,GAAE,MAAmB,GAAG,IAAI;IAkB7C,QAAQ,IAAI,YAAY;IAIxB,cAAc,IAAI,MAAM;IAIxB,qCAAqC;IACrC,WAAW,CAAC,GAAG,GAAE,MAAmB,GAAG;QACrC,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,YAAY,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB;IAuBD,kEAAkE;IAClE,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,UAAU;IAclB,uEAAuE;IACvE,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,WAAW;CAOpB"}

package/dist/common/circuit-breaker.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Circuit Breaker
+ *
+ * Wraps a flaky upstream at the *call site* so a failing vendor is skipped
+ * instead of being waited on. Two states only; the "probe" that tests recovery
+ * is claimed with a timestamp, never a lock, so no code path can leave the
+ * breaker stuck (see SEARCH-FALLBACK-IMPLEMENTATION.md §7.9).
+ *
+ * Failure classification stays with the caller — this class only counts
+ * outcomes it is told about, which keeps it vendor-agnostic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.DEFAULT_BREAKER_OPTIONS = void 0;
+exports.DEFAULT_BREAKER_OPTIONS = {
+    failureThreshold: 5,
+    failureRateThreshold: 0.5,
+    minimumCalls: 10,
+    windowMs: 30_000,
+    openMs: 60_000,
+    maxOpenMs: 300_000,
+    probeIntervalMs: 15_000,
+};
+/** Fixed ring of buckets so recording is O(1) and memory never grows. */
+const BUCKET_COUNT = 6;
+class CircuitBreaker {
+    opts;
+    bucketMs;
+    state = 'CLOSED';
+    openedAt = 0;
+    lastProbeAt = 0;
+    consecutiveOpens = 0;
+    buckets;
+    constructor(options) {
+        this.opts = { ...exports.DEFAULT_BREAKER_OPTIONS, ...options };
+        this.bucketMs = Math.max(1, Math.floor(this.opts.windowMs / BUCKET_COUNT));
+        this.buckets = Array.from({ length: BUCKET_COUNT }, () => ({
+            startedAt: 0,
+            successes: 0,
+            failures: 0,
+        }));
+    }
+    get name() {
+        return this.opts.name;
+    }
+    /**
+     * Decide whether the upstream may be called. In OPEN this also claims the
+     * probe window when one is due — claiming is a timestamp write, so there is
+     * nothing to release afterwards.
+     */
+    canAttempt(now = Date.now()) {
+        if (this.state === 'CLOSED') {
+            return { allowed: true, state: 'CLOSED', reason: 'closed' };
+        }
+        if (now - this.openedAt < this.currentOpenMs()) {
+            return { allowed: false, state: 'OPEN', reason: 'cooling-down' };
+        }
+        if (now - this.lastProbeAt < this.opts.probeIntervalMs) {
+            return { allowed: false, state: 'OPEN', reason: 'probe-recent' };
+        }
+        this.lastProbeAt = now;
+        return { allowed: true, state: 'OPEN', reason: 'probe' };
+    }
+    /** Upstream answered correctly. A success while OPEN closes the breaker. */
+    recordSuccess(now = Date.now()) {
+        this.bucketFor(now).successes++;
+        if (this.state === 'OPEN') {
+            this.state = 'CLOSED';
+            this.openedAt = 0;
+            this.consecutiveOpens = 0;
+            this.resetWindow();
+        }
+    }
+    /** Upstream is broken. May trip the breaker, or extend the cooldown. */
+    recordFailure(now = Date.now()) {
+        this.bucketFor(now).failures++;
+        if (this.state === 'OPEN') {
+            // A failed probe restarts the cooldown, one step longer.
+            this.openedAt = now;
+            this.consecutiveOpens = Math.min(this.consecutiveOpens + 1, 16);
+            return;
+        }
+        if (this.shouldTrip(now)) {
+            this.state = 'OPEN';
+            this.openedAt = now;
+            this.consecutiveOpens = 1;
+            this.resetWindow();
+        }
+    }
+    getState() {
+        return this.state;
+    }
+    getLastProbeAt() {
+        return this.lastProbeAt;
+    }
+    /** Snapshot for /health and logs. */
+    getSnapshot(now = Date.now()) {
+        const { successes, failures } = this.windowTotals(now);
+        const cooldownMs = this.state === 'OPEN' ? this.currentOpenMs() : 0;
+        const cooldownRemaining = this.state === 'OPEN' ? Math.max(0, this.openedAt + cooldownMs - now) : 0;
+        const probeRemaining = this.state === 'OPEN'
+            ? Math.max(0, this.lastProbeAt + this.opts.probeIntervalMs - now)
+            : 0;
+        return {
+            name: this.opts.name,
+            state: this.state,
+            openedAt: this.openedAt,
+            lastProbeAt: this.lastProbeAt,
+            consecutiveOpens: this.consecutiveOpens,
+            cooldownMs,
+            msUntilNextProbe: Math.max(cooldownRemaining, probeRemaining),
+            failures,
+            successes,
+        };
+    }
+    /** Cooldown doubles per consecutive open, capped at maxOpenMs. */
+    currentOpenMs() {
+        const factor = 2 ** Math.max(0, this.consecutiveOpens - 1);
+        return Math.min(this.opts.openMs * factor, this.opts.maxOpenMs);
+    }
+    shouldTrip(now) {
+        const { successes, failures } = this.windowTotals(now);
+        if (failures >= this.opts.failureThreshold) {
+            return true;
+        }
+        const total = successes + failures;
+        return (total >= this.opts.minimumCalls &&
+            failures / total > this.opts.failureRateThreshold);
+    }
+    /** Bucket for `now`, reset if the slot has rotated past its window. */
+    bucketFor(now) {
+        const index = Math.floor(now / this.bucketMs) % BUCKET_COUNT;
+        const startedAt = Math.floor(now / this.bucketMs) * this.bucketMs;
+        const bucket = this.buckets[index];
+        if (bucket.startedAt !== startedAt) {
+            bucket.startedAt = startedAt;
+            bucket.successes = 0;
+            bucket.failures = 0;
+        }
+        return bucket;
+    }
+    windowTotals(now) {
+        const cutoff = now - this.opts.windowMs;
+        let successes = 0;
+        let failures = 0;
+        for (const bucket of this.buckets) {
+            if (bucket.startedAt > cutoff) {
+                successes += bucket.successes;
+                failures += bucket.failures;
+            }
+        }
+        return { successes, failures };
+    }
+    resetWindow() {
+        for (const bucket of this.buckets) {
+            bucket.startedAt = 0;
+            bucket.successes = 0;
+            bucket.failures = 0;
+        }
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/common/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/common/circuit-breaker.ts"],"names":[],"mappings":"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"}

package/dist/common/index.d.ts

@@ -1,3 +1,4 @@
 export * from './logger';
 export * from './guards/tenant.guard';
+export * from './circuit-breaker';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/common/index.js

@@ -3,4 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./logger"), exports);
 tslib_1.__exportStar(require("./guards/tenant.guard"), exports);
+tslib_1.__exportStar(require("./circuit-breaker"), exports);
 //# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,gEAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,gEAAsC;AACtC,4DAAkC"}

package/dist/integrations/commerce/commerce.types.d.ts

@@ -371,6 +371,65 @@ export interface CommerceProductRecommendation {
     featuredImage: CommerceImage | null;
     priceRange: CommercePriceRange;
 }
+export interface CommerceFilterValue {
+    id: string;
+    label: string;
+    count: number;
+    /** JSON-encoded ProductFilter input that reproduces this value. */
+    input: string;
+}
+export interface CommerceFilter {
+    id: string;
+    label: string;
+    type: 'LIST' | 'PRICE_RANGE' | 'BOOLEAN';
+    values: CommerceFilterValue[];
+}
+export interface CommerceProductSearchResult {
+    products: CommerceProduct[];
+    totalCount: number;
+    filters: CommerceFilter[];
+}
+export interface CommercePredictiveSearchResult {
+    products: CommerceProduct[];
+    queries: string[];
+    collections: Array<{
+        title: string;
+        handle: string;
+    }>;
+    pages: Array<{
+        title: string;
+        handle: string;
+    }>;
+}
+/** Shopify ProductFilter input — only the shapes the fallback builds. */
+export interface CommerceProductFilterInput {
+    available?: boolean;
+    price?: {
+        min?: number;
+        max?: number;
+    };
+    productType?: string;
+    productVendor?: string;
+    variantOption?: {
+        name: string;
+        value: string;
+    };
+}
+export interface CommerceSearchParams {
+    query: string;
+    first?: number;
+    filters?: CommerceProductFilterInput[];
+    /** SearchSortKeys; descending is expressed with `reverse`, not a key. */
+    sortKey?: 'RELEVANCE' | 'PRICE';
+    reverse?: boolean;
+}
+export interface CommerceCollectionProductsParams {
+    handle: string;
+    first?: number;
+    filters?: CommerceProductFilterInput[];
+    sortKey?: 'BEST_SELLING' | 'COLLECTION_DEFAULT' | 'CREATED' | 'PRICE' | 'RELEVANCE' | 'TITLE';
+    reverse?: boolean;
+}
 /**
  * Commerce Service Interface
  *

package/dist/integrations/commerce/commerce.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commerce.types.d.ts","sourceRoot":"","sources":["../../../src/integrations/commerce/commerce.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commerce.types.d.ts","sourceRoot":"","sources":["../../../src/integrations/commerce/commerce.types.ts"],"names":[],"mappings":"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"}

package/dist/integrations/commerce/shopify.service.d.ts

@@ -1,6 +1,6 @@
 import { BaseIntegrationService } from "../base-integration.service";
 import { IntegrationResponse } from "../integration.types";
-import { ICommerceService, CommerceProduct, CommerceCollection, CommerceCart, CommerceMenu, CommercePage, CommerceConnection, CommerceProductRecommendation, ProductsParams, CollectionsParams, CartLineInput, CartLineUpdateInput, CartBuyerIdentityInput, CartAttributeInput, CartCreateInput, CommerceCustomer, CommerceCustomerAccessToken } from "./commerce.types";
+import { ICommerceService, CommerceProduct, CommerceCollection, CommerceCart, CommerceMenu, CommercePage, CommerceConnection, CommerceProductRecommendation, ProductsParams, CollectionsParams, CartLineInput, CartLineUpdateInput, CartBuyerIdentityInput, CartAttributeInput, CartCreateInput, CommerceCustomer, CommerceCustomerAccessToken, CommerceProductSearchResult, CommercePredictiveSearchResult, CommerceSearchParams, CommerceCollectionProductsParams } from "./commerce.types";
 /**
  * Shopify Commerce Service
  *
@@ -19,6 +19,22 @@ export declare class ShopifyCommerceService extends BaseIntegrationService imple
     getProductRecommendations(productId: string, count?: number): Promise<IntegrationResponse<CommerceProductRecommendation[]>>;
     getCollections(params?: CollectionsParams): Promise<IntegrationResponse<CommerceConnection<CommerceCollection>>>;
     getCollectionByHandle(handle: string, productsFirst?: number): Promise<IntegrationResponse<CommerceCollection | null>>;
+    /**
+     * Keyword search via the Storefront `search` query.
+     * The shopper's text is passed through untouched as a GraphQL variable.
+     */
+    searchProducts(params: CommerceSearchParams): Promise<IntegrationResponse<CommerceProductSearchResult>>;
+    /**
+     * Collection listing with Shopify-native filters, for the filter fallback.
+     * Returns null when the collection handle does not exist.
+     */
+    getCollectionProducts(params: CommerceCollectionProductsParams): Promise<IntegrationResponse<(CommerceProductSearchResult & {
+        title: string;
+    }) | null>>;
+    /**
+     * Type-ahead suggestions via `predictiveSearch`, for the autocomplete fallback.
+     */
+    predictiveSearch(query: string, limit?: number): Promise<IntegrationResponse<CommercePredictiveSearchResult>>;
     getMenu(handle: string): Promise<IntegrationResponse<CommerceMenu | null>>;
     getPage(handle: string): Promise<IntegrationResponse<CommercePage | null>>;
     createCart(input?: CartCreateInput): Promise<IntegrationResponse<CommerceCart>>;

package/dist/integrations/commerce/shopify.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shopify.service.d.ts","sourceRoot":"","sources":["../../../src/integrations/commerce/shopify.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shopify.service.d.ts","sourceRoot":"","sources":["../../../src/integrations/commerce/shopify.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,2BAA2B,EAE3B,2BAA2B,EAC3B,8BAA8B,EAC9B,oBAAoB,EACpB,gCAAgC,EACjC,MAAM,kBAAkB,CAAC;AAwvB1B;;;;;GAKG;AACH,qBACa,sBACX,SAAQ,sBACR,YAAW,gBAAgB;IAE3B,QAAQ,CAAC,IAAI,sBAAsB;IAEnC;;OAEG;YACW,YAAY;IAoCpB,WAAW,CACf,MAAM,GAAE,cAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC;IAY9D,cAAc,CAClB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,mBAAmB,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAYjD,kBAAkB,CACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAajD,yBAAyB,CAC7B,SAAS,EAAE,MAAM,EACjB,KAAK,SAAI,GACR,OAAO,CAAC,mBAAmB,CAAC,6BAA6B,EAAE,CAAC,CAAC;IAc1D,cAAc,CAClB,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAYjE,qBAAqB,CACzB,MAAM,EAAE,MAAM,EACd,aAAa,SAAK,GACjB,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IA2C1D;;;OAGG;IACG,cAAc,CAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,2BAA2B,CAAC,CAAC;IAiC5D;;;OAGG;IACG,qBAAqB,CACzB,MAAM,EAAE,gCAAgC,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAAC,2BAA2B,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IA4CzF;;OAEG;IACG,gBAAgB,CACpB,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,mBAAmB,CAAC,8BAA8B,CAAC,CAAC;IAgCzD,OAAO,CACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAa9C,OAAO,CACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAc9C,UAAU,CACd,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAgCvC,OAAO,CACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAa9C,SAAS,CACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IA2BvC,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,mBAAmB,EAAE,GAC3B,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IA2BvC,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IA2BvC,uBAAuB,CAC3B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IA2BvC,uBAAuB,CAC3B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,sBAAsB,GACpC,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IA2BvC,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IA2BvC,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,kBAAkB,EAAE,GAC/B,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IA2BvC,uBAAuB,CAC3B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IA2B7C;;;;;OAKG;IACG,yBAAyB,CAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,2BAA2B,CAAC,CAAC;IAiD5D;;;;;;OAMG;IACG,wBAAwB,CAC5B,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,mBAAmB,CAAC,2BAA2B,CAAC,CAAC;IA6C5D;;OAEG;IACG,WAAW,CACf,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAsBjD;;OAEG;IACG,WAAW;;;;;CAWlB"}

package/dist/integrations/commerce/shopify.service.js

@@ -123,6 +123,125 @@ const PRODUCTS_QUERY = `
     }
   }
 `;
+// Lightweight product selection for search/collection fallback results. Kept
+// separate from PRODUCTS_QUERY so the fallback stays cheap on query cost: no
+// media, no size charts, no metafields the search grid does not render.
+const SEARCH_PRODUCT_SELECTION = `
+    id
+    handle
+    title
+    description
+    descriptionHtml
+    vendor
+    productType
+    tags
+    featuredImage { url altText width height }
+    images(first: 10) {
+      edges { node { url altText width height } }
+    }
+    options { id name values }
+    variants(first: 100) {
+      edges {
+        node {
+          id
+          title
+          availableForSale
+          barcode
+          sku
+          price { amount currencyCode }
+          compareAtPrice { amount currencyCode }
+          selectedOptions { name value }
+          image { url altText width height }
+        }
+      }
+    }
+    priceRange {
+      minVariantPrice { amount currencyCode }
+      maxVariantPrice { amount currencyCode }
+    }`;
+const FILTER_SELECTION = `
+      id
+      label
+      type
+      values { id label count input }`;
+// Keyword search fallback. `$query` is a variable, so the shopper's text is
+// transported as data and never parsed as query syntax.
+const SEARCH_PRODUCTS_QUERY = `
+  query SearchProducts(
+    $query: String!
+    $first: Int!
+    $filters: [ProductFilter!]
+    $sortKey: SearchSortKeys
+    $reverse: Boolean
+  ) {
+    search(
+      query: $query
+      types: [PRODUCT]
+      first: $first
+      prefix: LAST
+      productFilters: $filters
+      sortKey: $sortKey
+      reverse: $reverse
+      unavailableProducts: LAST
+    ) {
+      totalCount
+      productFilters {${FILTER_SELECTION}
+      }
+      nodes {
+        ... on Product {${SEARCH_PRODUCT_SELECTION}
+        }
+      }
+    }
+  }
+`;
+// Collection listing fallback. Separate from COLLECTION_BY_HANDLE_QUERY, which
+// selects only handles for the collection-title lookup.
+const COLLECTION_PRODUCTS_QUERY = `
+  query CollectionProducts(
+    $handle: String!
+    $first: Int!
+    $filters: [ProductFilter!]
+    $sortKey: ProductCollectionSortKeys
+    $reverse: Boolean
+  ) {
+    collection(handle: $handle) {
+      id
+      handle
+      title
+      products(first: $first, filters: $filters, sortKey: $sortKey, reverse: $reverse) {
+        filters {${FILTER_SELECTION}
+        }
+        edges {
+          node {${SEARCH_PRODUCT_SELECTION}
+          }
+        }
+      }
+      # Ids only, purely to size the result set: the collection connection has
+      # no totalCount, and without it the page count would be computed from the
+      # fetched slice and under-paginate. Same request, so no extra round trip.
+      countWindow: products(first: 250, filters: $filters) {
+        edges { node { id } }
+      }
+    }
+  }
+`;
+// Autocomplete fallback.
+const PREDICTIVE_SEARCH_QUERY = `
+  query PredictiveSearch($query: String!, $limit: Int!) {
+    predictiveSearch(
+      query: $query
+      limit: $limit
+      types: [PRODUCT, QUERY, COLLECTION, PAGE]
+      limitScope: EACH
+    ) {
+      queries { text }
+      collections { title handle }
+      pages { title handle }
+      products {${SEARCH_PRODUCT_SELECTION}
+      }
+    }
+  }
+`;
 const PRODUCT_BY_ID_QUERY = `
   query ProductById($id: ID!) {
     product(id: $id) {
@@ -707,6 +826,89 @@ let ShopifyCommerceService = class ShopifyCommerceService extends base_integrati
         };
         return { success: true, data: collection };
     }
+    // Search / filter fallback (used when the search vendor is unavailable)
+    /**
+     * Keyword search via the Storefront `search` query.
+     * The shopper's text is passed through untouched as a GraphQL variable.
+     */
+    async searchProducts(params) {
+        const response = await this.graphqlQuery(SEARCH_PRODUCTS_QUERY, {
+            query: params.query,
+            first: params.first ?? 20,
+            filters: params.filters,
+            sortKey: params.sortKey ?? 'RELEVANCE',
+            reverse: params.reverse ?? false,
+        });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        const search = response.data.search;
+        return {
+            success: true,
+            data: {
+                // `nodes` is typed as SearchResultItem; non-product types are filtered
+                // out by the inline fragment and arrive as empty objects.
+                products: (search?.nodes ?? []).filter((node) => Boolean(node?.handle)),
+                totalCount: search?.totalCount ?? 0,
+                filters: search?.productFilters ?? [],
+            },
+        };
+    }
+    /**
+     * Collection listing with Shopify-native filters, for the filter fallback.
+     * Returns null when the collection handle does not exist.
+     */
+    async getCollectionProducts(params) {
+        const response = await this.graphqlQuery(COLLECTION_PRODUCTS_QUERY, {
+            handle: params.handle,
+            first: params.first ?? 20,
+            filters: params.filters,
+            sortKey: params.sortKey ?? 'COLLECTION_DEFAULT',
+            reverse: params.reverse ?? false,
+        });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        const collection = response.data.collection;
+        if (!collection) {
+            return { success: true, data: null };
+        }
+        const products = collection.products.edges.map((edge) => edge.node);
+        return {
+            success: true,
+            data: {
+                title: collection.title,
+                products,
+                // Real size of the filtered collection, counted in the same request.
+                // Saturates at the 250 window; beyond that pagination is capped anyway.
+                totalCount: collection.countWindow?.edges.length ?? products.length,
+                filters: collection.products.filters ?? [],
+            },
+        };
+    }
+    /**
+     * Type-ahead suggestions via `predictiveSearch`, for the autocomplete fallback.
+     */
+    async predictiveSearch(query, limit = 10) {
+        const response = await this.graphqlQuery(PREDICTIVE_SEARCH_QUERY, {
+            query,
+            // Shopify caps limit at 10.
+            limit: Math.min(Math.max(limit, 1), 10),
+        });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        const result = response.data.predictiveSearch;
+        return {
+            success: true,
+            data: {
+                products: result?.products ?? [],
+                queries: (result?.queries ?? []).map((q) => q.text),
+                collections: result?.collections ?? [],
+                pages: result?.pages ?? [],
+            },
+        };
+    }
     // CMS
     async getMenu(handle) {
         const response = await this.graphqlQuery(MENU_QUERY, { handle });