@asstio-dev/storefront 0.19.0 → 0.21.0

package/README.md

@@ -243,6 +243,28 @@ config. Holes in the data never throw: a missing image, description or price onl
 
 hreflang sets are only as reciprocal as the API's `alternateUrls`; the SDK renders what the API gives.
 
+### Search events
+
+`trackSearchEvents(client, events, { consent })` posts search exposures, product clicks and add-to-carts to
+`POST /v1/events`, for measuring search quality. It sends **nothing** unless `consent === true`: the storefront stores
+no PII and cannot verify consent, so the frontend decides, and passes `sessionId` (opaque, frontend-generated) only
+under the same consent.
+
+```ts
+const exposure = { type: "search_exposure", occurredAt: new Date().toISOString(), resultId: listing.search!.resultId, query, page: 1, productIds };
+await trackSearchEvents(client, [exposure], { consent: shopperAcceptedMeasurement });
+await trackSearchEvents(client, [{ type: "product_click", occurredAt: new Date().toISOString(), exposureId: exposure.eventId, productId, position: 3 }], { consent });
+```
+
+- An event without `eventId` gets a UUID **written into the object**. Retry the same objects after an uncertain
+  answer (a timeout, a dropped connection) and the ids are reused, so the server counts the repeats as `duplicates`.
+  A second click from the same exposure is a new event: build a new object.
+- `occurredAt` is UTC ISO-8601 (`new Date().toISOString()`), within 7 days back and 5 minutes ahead.
+- At most 50 events per call (a larger batch throws `RangeError`), 64 KB per body. The answer lists `rejected`
+  events with their `index` and `member`; the others are kept. Any non-2xx answer throws: a malformed envelope (a
+  `400` problem) and a bare `5xx` alike, so a failed send is never mistaken for "no consent" (`null`).
+- Exposures come only from the client; a catalog GET is never one.
+
 ### Product facts and GA4
 
 Cards and cart lines carry the product facts the product page has: `brand`, `categories`, `shortDescription` and

package/dist/analytics/events.d.ts

@@ -0,0 +1,20 @@
+import type { Client } from "openapi-fetch";
+import type { components } from "../schema";
+import type { StorefrontPaths } from "../index.js";
+type Schemas = components["schemas"];
+/** One search event. `eventId` may be left out: `trackSearchEvents` writes a UUID into the object. */
+export type SearchEvent = Omit<Schemas["SearchEventDto"], "eventId"> & {
+    eventId?: string | null;
+};
+export type SearchEventsResponse = Schemas["SearchEventsResponse"];
+/**
+ * `POST /v1/events` (spec 2026-10-13 §9.2). A no-op unless `consent` is exactly `true`: the storefront cannot verify
+ * consent, so the caller decides (and sends `sessionId` only under the same consent). An event without `eventId` gets
+ * a UUID written into the object, so retrying the same objects after an uncertain response reuses the ids and the
+ * server counts them as duplicates. Throws a `RangeError` for more than 50 events (split the batch) and an `Error` on any
+ * non-2xx answer (a problem body or none). Build `occurredAt` with `new Date().toISOString()`: the server wants UTC.
+ */
+export declare function trackSearchEvents(client: Client<StorefrontPaths>, events: SearchEvent[], options: {
+    consent: boolean;
+}): Promise<SearchEventsResponse | null>;
+export {};

package/dist/analytics/events.js

@@ -0,0 +1,23 @@
+/** The server's per-envelope cap (spec 2026-10-13 §9.2); a larger batch is a `400` that stores nothing. */
+const MAX_EVENTS_PER_REQUEST = 50;
+/**
+ * `POST /v1/events` (spec 2026-10-13 §9.2). A no-op unless `consent` is exactly `true`: the storefront cannot verify
+ * consent, so the caller decides (and sends `sessionId` only under the same consent). An event without `eventId` gets
+ * a UUID written into the object, so retrying the same objects after an uncertain response reuses the ids and the
+ * server counts them as duplicates. Throws a `RangeError` for more than 50 events (split the batch) and an `Error` on any
+ * non-2xx answer (a problem body or none). Build `occurredAt` with `new Date().toISOString()`: the server wants UTC.
+ */
+export async function trackSearchEvents(client, events, options) {
+    if (options?.consent !== true || events.length === 0)
+        return null;
+    if (events.length > MAX_EVENTS_PER_REQUEST)
+        throw new RangeError(`trackSearchEvents takes at most ${MAX_EVENTS_PER_REQUEST} events per call, got ${events.length}`);
+    for (const e of events)
+        if (!e.eventId)
+            e.eventId = crypto.randomUUID();
+    const { data, error, response } = await client.POST("/v1/events", { body: { events: events } });
+    // `error` is undefined for an empty-body 5xx (openapi-fetch parses nothing), so the status decides: a non-2xx always throws.
+    if (!response.ok)
+        throw new Error(`trackSearchEvents failed: ${response.status} ${error === undefined ? "" : JSON.stringify(error)}`.trimEnd());
+    return data ?? null;
+}

package/dist/index.d.ts

@@ -58,5 +58,6 @@ export { productJsonLd } from "./seo/product.js";
 export { jsonLdScript } from "./seo/serialize.js";
 export { productFacts } from "./analytics/facts.js";
 export { toGa4Ecommerce, toGa4Item } from "./analytics/ga4.js";
+export { trackSearchEvents, type SearchEvent, type SearchEventsResponse } from "./analytics/events.js";
 export { AnalyticsError, type Ga4Ecommerce, type Ga4Item, type Ga4ItemOptions, type Ga4ItemSource, type Ga4Purchase, type Ga4SharedOptions, type ProductFacts, type SelectedVariant, } from "./analytics/types.js";
 export { SeoError, type BreadcrumbLink, type CollectionHeadOptions, type HeadOptions, type JsonLd, type NextMetadataLike, type ProductJsonLdOptions, type SchemaProperty, type SeoContext, type SeoHead, type SeoMeta, type VariantAvailability, } from "./seo/types.js";

package/dist/index.js

@@ -47,5 +47,6 @@ export { productJsonLd } from "./seo/product.js";
 export { jsonLdScript } from "./seo/serialize.js";
 export { productFacts } from "./analytics/facts.js";
 export { toGa4Ecommerce, toGa4Item } from "./analytics/ga4.js";
+export { trackSearchEvents } from "./analytics/events.js";
 export { AnalyticsError, } from "./analytics/types.js";
 export { SeoError, } from "./seo/types.js";

package/dist/schema.d.ts

@@ -249,6 +249,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Search exposures, clicks and add-to-carts for measurement (spec 2026-10-13 §9.2). Send only with the shopper's consent. Each event is validated on its own: a bad one is listed in rejected and the others are kept; an eventId the site already has is a duplicate and changes nothing. */
+        post: operations["TrackSearchEvents"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/orders/{orderId}": {
         parameters: {
             query?: never;
@@ -422,6 +439,8 @@ export interface components {
         AppliedFilterDto: {
             facet: string;
             label: string;
+            /** @default filter */
+            source: string;
             value: string;
         };
         AttributeDto: {
@@ -752,6 +771,7 @@ export interface components {
             pageSize: number | string;
             queryCorrection: null | string;
             redirect: null | string;
+            search?: null | components["schemas"]["SearchInfoDto"];
             sort: components["schemas"]["SortDto"];
             /** Format: int64 */
             total: number | string;
@@ -1020,6 +1040,60 @@ export interface components {
             importer: null | components["schemas"]["PartyDto"];
             manufacturer: null | components["schemas"]["PartyDto"];
         };
+        SearchEventDto: {
+            eventId: null | string;
+            exposureId?: null | string;
+            /** Format: date-time */
+            occurredAt: null | string;
+            /** Format: int32 */
+            page?: number | null;
+            /** Format: int32 */
+            position?: number | null;
+            productId?: null | string;
+            productIds?: string[] | null;
+            /** Format: int32 */
+            quantity?: number | null;
+            query?: null | string;
+            resultId?: null | string;
+            sessionId?: null | string;
+            type: null | string;
+            variantId?: null | string;
+        };
+        SearchEventRejection: {
+            code: string;
+            /** Format: int32 */
+            index: number | string;
+            member: null | string;
+        };
+        SearchEventsRequest: {
+            events: components["schemas"]["SearchEventDto"][] | null;
+        };
+        SearchEventsResponse: {
+            /** Format: int32 */
+            accepted: number | string;
+            /** Format: int32 */
+            duplicates: number | string;
+            rejected: components["schemas"]["SearchEventRejection"][];
+            /** Format: int32 */
+            stored: number | string;
+        };
+        SearchInfoDto: {
+            codeMatch: boolean;
+            intents: components["schemas"]["SearchIntentDto"][];
+            rescue: null | components["schemas"]["SearchRescueDto"];
+            resultId: string;
+            tier: string;
+        };
+        SearchIntentDto: {
+            facet: string;
+            queryWithout: string;
+            values: string[];
+        };
+        SearchRescueDto: {
+            collectionId: string;
+            name: string;
+            slug: string;
+        };
         SellabilityDto: {
             mode: components["schemas"]["SiteSellabilityMode"];
         };
@@ -2612,7 +2686,7 @@ export interface operations {
     GetCollection: {
         parameters: {
             query?: {
-                /** @description Free-text search. Omit to browse rather than search. */
+                /** @description Free-text search. Omit to browse rather than search; a q of separators only (such as !!!) browses too. A search answers with search (how it was answered), and may set queryCorrection and redirect. */
                 q?: string;
                 /** @description 1-based page. page × pageSize must not exceed 10000 (default pageSize 24, max 100). */
                 page?: number;
@@ -2624,6 +2698,8 @@ export interface operations {
                 filter?: {
                     [key: string]: string;
                 };
+                /** @description Where a search came from, for measurement only: typed, suggestion, recent or other. It never changes the answer. Anything else is ignored with an ORIGIN_UNKNOWN warning. */
+                origin?: "other" | "recent" | "suggestion" | "typed";
             };
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
@@ -2788,6 +2864,91 @@ export interface operations {
             };
         };
     };
+    TrackSearchEvents: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
+                "X-Site-Key": string;
+                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                "X-Market"?: string;
+                /** @description BCP-47 language tag. Omit to use the market's language. */
+                "Accept-Language"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SearchEventsRequest"];
+            };
+        };
+        responses: {
+            /** @description Accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SearchEventsResponse"];
+                };
+            };
+            /** @description problem+json. EVENTS_INVALID (not JSON, not { "events": [ … ] }, no event or more than 50, or a body over 64 KB; nothing is stored), or MARKET_UNKNOWN. One bad event is not a 400: it is listed in the 202's rejected. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. SITE_INACTIVE, or NOT_FOUND for an unrouted path. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. RATE_LIMITED; retryAfterSeconds and the Retry-After header say how long to wait. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+        };
+    };
     GetOrder: {
         parameters: {
             query?: never;
@@ -2878,7 +3039,7 @@ export interface operations {
     ListProducts: {
         parameters: {
             query?: {
-                /** @description Free-text search. Omit to browse rather than search. */
+                /** @description Free-text search. Omit to browse rather than search; a q of separators only (such as !!!) browses too. A search answers with search (how it was answered), and may set queryCorrection and redirect. */
                 q?: string;
                 /** @description 1-based page. page × pageSize must not exceed 10000 (default pageSize 24, max 100). */
                 page?: number;
@@ -2890,6 +3051,8 @@ export interface operations {
                 filter?: {
                     [key: string]: string;
                 };
+                /** @description Where a search came from, for measurement only: typed, suggestion, recent or other. It never changes the answer. Anything else is ignored with an ORIGIN_UNKNOWN warning. */
+                origin?: "other" | "recent" | "suggestion" | "typed";
                 /** @description Narrow to a collection by slug path or id. An unknown one is answered with a COLLECTION_UNKNOWN warning, not a 404. */
                 collection?: string;
             };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asstio-dev/storefront",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "Typed client for the Asstio Storefront API (generated from OpenAPI).",
   "repository": {
     "type": "git",
@@ -21,7 +21,7 @@
     "test": "vitest run",
     "test:browser": "playwright test -c browser/playwright.config.ts",
     "check": "npm run generate && npm run typecheck-examples && npm test && git diff --exit-code -- src/schema.d.ts && test -z \"$(git status --porcelain -- src/schema.d.ts)\"",
-    "smoke": "node --input-type=module -e \"import(\\\"./dist/index.js\\\").then(m => { for (const f of [\\\"createStorefrontClient\\\", \\\"filterQuery\\\", \\\"encodeFilterValues\\\", \\\"decodeFilterValues\\\", \\\"pictureSources\\\", \\\"mediaUrl\\\", \\\"formatImage\\\", \\\"styleToCss\\\", \\\"startCheckout\\\", \\\"syncCheckout\\\", \\\"completeCheckout\\\", \\\"getCheckoutStatus\\\", \\\"liveShippingFor\\\", \\\"getOrder\\\", \\\"awaitCompletion\\\", \\\"mountCheckout\\\", \\\"productJsonLd\\\", \\\"gtinJsonLd\\\", \\\"breadcrumbJsonLd\\\", \\\"productHead\\\", \\\"collectionHead\\\", \\\"brandHead\\\", \\\"toNextMetadata\\\", \\\"jsonLdScript\\\", \\\"SeoError\\\", \\\"productFacts\\\", \\\"toGa4Item\\\", \\\"toGa4Ecommerce\\\", \\\"AnalyticsError\\\"]) if (typeof m[f] !== \\\"function\\\") throw new Error(\\\"missing export \\\" + f) })\""
+    "smoke": "node --input-type=module -e \"import(\\\"./dist/index.js\\\").then(m => { for (const f of [\\\"createStorefrontClient\\\", \\\"filterQuery\\\", \\\"encodeFilterValues\\\", \\\"decodeFilterValues\\\", \\\"pictureSources\\\", \\\"mediaUrl\\\", \\\"formatImage\\\", \\\"styleToCss\\\", \\\"startCheckout\\\", \\\"syncCheckout\\\", \\\"completeCheckout\\\", \\\"getCheckoutStatus\\\", \\\"liveShippingFor\\\", \\\"getOrder\\\", \\\"awaitCompletion\\\", \\\"mountCheckout\\\", \\\"productJsonLd\\\", \\\"gtinJsonLd\\\", \\\"breadcrumbJsonLd\\\", \\\"productHead\\\", \\\"collectionHead\\\", \\\"brandHead\\\", \\\"toNextMetadata\\\", \\\"jsonLdScript\\\", \\\"SeoError\\\", \\\"productFacts\\\", \\\"toGa4Item\\\", \\\"toGa4Ecommerce\\\", \\\"AnalyticsError\\\", \\\"trackSearchEvents\\\"]) if (typeof m[f] !== \\\"function\\\") throw new Error(\\\"missing export \\\" + f) })\""
   },
   "dependencies": {
     "openapi-fetch": "0.17.0"

package/src/schema.d.ts

@@ -249,6 +249,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Search exposures, clicks and add-to-carts for measurement (spec 2026-10-13 §9.2). Send only with the shopper's consent. Each event is validated on its own: a bad one is listed in rejected and the others are kept; an eventId the site already has is a duplicate and changes nothing. */
+        post: operations["TrackSearchEvents"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/orders/{orderId}": {
         parameters: {
             query?: never;
@@ -422,6 +439,8 @@ export interface components {
         AppliedFilterDto: {
             facet: string;
             label: string;
+            /** @default filter */
+            source: string;
             value: string;
         };
         AttributeDto: {
@@ -752,6 +771,7 @@ export interface components {
             pageSize: number | string;
             queryCorrection: null | string;
             redirect: null | string;
+            search?: null | components["schemas"]["SearchInfoDto"];
             sort: components["schemas"]["SortDto"];
             /** Format: int64 */
             total: number | string;
@@ -1020,6 +1040,60 @@ export interface components {
             importer: null | components["schemas"]["PartyDto"];
             manufacturer: null | components["schemas"]["PartyDto"];
         };
+        SearchEventDto: {
+            eventId: null | string;
+            exposureId?: null | string;
+            /** Format: date-time */
+            occurredAt: null | string;
+            /** Format: int32 */
+            page?: number | null;
+            /** Format: int32 */
+            position?: number | null;
+            productId?: null | string;
+            productIds?: string[] | null;
+            /** Format: int32 */
+            quantity?: number | null;
+            query?: null | string;
+            resultId?: null | string;
+            sessionId?: null | string;
+            type: null | string;
+            variantId?: null | string;
+        };
+        SearchEventRejection: {
+            code: string;
+            /** Format: int32 */
+            index: number | string;
+            member: null | string;
+        };
+        SearchEventsRequest: {
+            events: components["schemas"]["SearchEventDto"][] | null;
+        };
+        SearchEventsResponse: {
+            /** Format: int32 */
+            accepted: number | string;
+            /** Format: int32 */
+            duplicates: number | string;
+            rejected: components["schemas"]["SearchEventRejection"][];
+            /** Format: int32 */
+            stored: number | string;
+        };
+        SearchInfoDto: {
+            codeMatch: boolean;
+            intents: components["schemas"]["SearchIntentDto"][];
+            rescue: null | components["schemas"]["SearchRescueDto"];
+            resultId: string;
+            tier: string;
+        };
+        SearchIntentDto: {
+            facet: string;
+            queryWithout: string;
+            values: string[];
+        };
+        SearchRescueDto: {
+            collectionId: string;
+            name: string;
+            slug: string;
+        };
         SellabilityDto: {
             mode: components["schemas"]["SiteSellabilityMode"];
         };
@@ -2612,7 +2686,7 @@ export interface operations {
     GetCollection: {
         parameters: {
             query?: {
-                /** @description Free-text search. Omit to browse rather than search. */
+                /** @description Free-text search. Omit to browse rather than search; a q of separators only (such as !!!) browses too. A search answers with search (how it was answered), and may set queryCorrection and redirect. */
                 q?: string;
                 /** @description 1-based page. page × pageSize must not exceed 10000 (default pageSize 24, max 100). */
                 page?: number;
@@ -2624,6 +2698,8 @@ export interface operations {
                 filter?: {
                     [key: string]: string;
                 };
+                /** @description Where a search came from, for measurement only: typed, suggestion, recent or other. It never changes the answer. Anything else is ignored with an ORIGIN_UNKNOWN warning. */
+                origin?: "other" | "recent" | "suggestion" | "typed";
             };
             header: {
                 /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
@@ -2788,6 +2864,91 @@ export interface operations {
             };
         };
     };
+    TrackSearchEvents: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Publishable, preview or secret site key. Required on every request; secret keys are server-side only. */
+                "X-Site-Key": string;
+                /** @description Market code (e.g. "se"). Omit for the site's default market. */
+                "X-Market"?: string;
+                /** @description BCP-47 language tag. Omit to use the market's language. */
+                "Accept-Language"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SearchEventsRequest"];
+            };
+        };
+        responses: {
+            /** @description Accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SearchEventsResponse"];
+                };
+            };
+            /** @description problem+json. EVENTS_INVALID (not JSON, not { "events": [ … ] }, no event or more than 50, or a body over 64 KB; nothing is stored), or MARKET_UNKNOWN. One bad event is not a 400: it is listed in the 202's rejected. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. SITE_KEY_MISSING or SITE_KEY_INVALID. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. SECRET_KEY_FROM_BROWSER: a secret key was sent from a browser. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. SITE_INACTIVE, or NOT_FOUND for an unrouted path. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. RATE_LIMITED; retryAfterSeconds and the Retry-After header say how long to wait. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+            /** @description problem+json. SITE_REGISTRY_WARMING or INDEX_UNAVAILABLE — retry, the request was not wrong. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["StorefrontProblem"];
+                };
+            };
+        };
+    };
     GetOrder: {
         parameters: {
             query?: never;
@@ -2878,7 +3039,7 @@ export interface operations {
     ListProducts: {
         parameters: {
             query?: {
-                /** @description Free-text search. Omit to browse rather than search. */
+                /** @description Free-text search. Omit to browse rather than search; a q of separators only (such as !!!) browses too. A search answers with search (how it was answered), and may set queryCorrection and redirect. */
                 q?: string;
                 /** @description 1-based page. page × pageSize must not exceed 10000 (default pageSize 24, max 100). */
                 page?: number;
@@ -2890,6 +3051,8 @@ export interface operations {
                 filter?: {
                     [key: string]: string;
                 };
+                /** @description Where a search came from, for measurement only: typed, suggestion, recent or other. It never changes the answer. Anything else is ignored with an ORIGIN_UNKNOWN warning. */
+                origin?: "other" | "recent" | "suggestion" | "typed";
                 /** @description Narrow to a collection by slug path or id. An unknown one is answered with a COLLECTION_UNKNOWN warning, not a 404. */
                 collection?: string;
             };