@seekora-ai/search-sdk 0.2.21 → 0.2.23

package/dist/analytics/types.gen.d.ts

@@ -0,0 +1,781 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    readonly "/v1/batch": {
+        readonly parameters: {
+            readonly query?: never;
+            readonly header?: never;
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        readonly get?: never;
+        readonly put?: never;
+        /**
+         * Storefront analytics batch ingest
+         * @description Per Segment Spec — wraps an array of events. Bulker batches by
+         *     `frequency: 1` minute (or `BatchSize` event count, whichever first).
+         */
+        readonly post: operations["ingestBatch"];
+        readonly delete?: never;
+        readonly options?: never;
+        readonly head?: never;
+        readonly patch?: never;
+        readonly trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /**
+         * Format: uuid
+         * @description Canonical search-tree root. UUID v4 minted by go-backend `/v1/search`
+         *     (`SearchRoute.go:324`). Threaded onto every downstream clickstream event
+         *     emitted within 30 min of the originating search via in-memory →
+         *     sessionStorage → URL `?seekora_sid=` resolution chain.
+         *     NULL/absent for events outside any search context.
+         * @example a1b2c3d4-e5f6-4a5b-9c8d-7e6f5a4b3c2d
+         */
+        readonly SearchId: string;
+        /**
+         * Format: uuid
+         * @description Client-minted UUID v4 stamped on Suggestion Clicked. Subsequent
+         *     Search Submitted that was triggered by this suggestion carries
+         *     this value in `triggered_by_suggestion_id` for attribution.
+         */
+        readonly SuggestionEventId: string;
+        /**
+         * Format: uuid
+         * @description On `Search Refined` events only. The previous (now-replaced) search_id
+         *     that this refinement evolved FROM. Together with `search_id` (the new
+         *     one), captures the search-refinement chain.
+         */
+        readonly FromSearchId: string;
+        /**
+         * @description Segment Spec unique-event identifier. Acts as PRIMARY KEY in
+         *     ReplicatedReplacingMergeTree event tables — duplicate inserts collapse.
+         *     Auto-set by analytics-next/-node SDKs if not provided.
+         */
+        readonly MessageId: string;
+        /**
+         * @description Segment Spec per-device identifier. Pattern matches Algolia's userToken
+         *     constraint for cross-tool compatibility.
+         */
+        readonly AnonymousId: string;
+        /**
+         * @description Segment Spec authenticated-user identifier. NULL for anonymous users.
+         *     Same pattern as anonymousId (Algolia's authenticatedUserToken constraint).
+         */
+        readonly UserId: string | null;
+        /**
+         * @description Seekora org-level tenant code. Stamped by `seekora-tenant-stamp` Rotor
+         *     function from `ctx.stream.orgcode`. Lands in `context_orgcode` column.
+         */
+        readonly OrgCode: string;
+        /**
+         * @description Seekora store-level tenant identifier. Stamped by `seekora-tenant-stamp`
+         *     from `ctx.stream.xstoreid`. Lands in `context_xstoreid` column. Required
+         *     on every event for tenant isolation in queries.
+         */
+        readonly XStoreId: string;
+        /**
+         * @description Producer-surface discriminator. Set by `seekora-source-infer` if not
+         *     already present on the event.
+         * @enum {string}
+         */
+        readonly Source: "shopify_web_pixel" | "search_sdk" | "ui_sdk" | "theme_embed" | "rotor_synthesized_orderline" | "unknown";
+        /**
+         * @description Engine-agnostic item identifier. Examples: Shopify SKU/product_id,
+         *     document UUID, article slug, video ID. Replaces Algolia's `objectIDs[]`
+         *     with a scalar (we emit per-row events for 1:N query friendliness).
+         */
+        readonly ObjectId: string;
+        /**
+         * @description Vertical discriminator. Lets analytics queries filter by item kind
+         *     when needed without splitting tables.
+         * @enum {string}
+         */
+        readonly ObjectType: "product" | "document" | "article" | "video" | "service" | "recipe" | "listing" | "content" | "other";
+        /**
+         * Format: uint16
+         * @description 1-indexed result-list position (matches Algolia's positions[] convention).
+         *     Position 13 = 3rd result on page 2 (10/page) — absolute across pages,
+         *     NOT page-relative.
+         */
+        readonly Position: number;
+        /**
+         * @description Where in the storefront UI the event fired.
+         * @enum {string}
+         */
+        readonly Surface: "results_page" | "dropdown" | "recommendation_widget" | "pdp_related" | "cart_recommendation" | "shopify_pdp" | "shopify_collection" | "shopify_cart" | "shopify_checkout";
+        /**
+         * @description User-entered search query. Stripped of leading/trailing whitespace by
+         *     the producer before emission.
+         */
+        readonly Query: string;
+        /**
+         * Format: uint32
+         * @description Number of hits returned by the search engine for this query.
+         */
+        readonly NumFound: number;
+        /**
+         * Format: uint32
+         * @description 1-indexed page number for paginated searches.
+         * @default 1
+         */
+        readonly Page: number;
+        /**
+         * @description Sort key applied (e.g. "price:asc", "relevance", "newest").
+         *     Free-form per merchant configuration.
+         */
+        readonly SortBy: string;
+        /**
+         * @description Active filter set at search time. Small array (typical < 10),
+         *     OK to carry inline. Per-filter-change events fire separately
+         *     as `Facet Applied` (1:N querying via JOIN).
+         * @example [
+         *       "brand:Nike",
+         *       "color:Red",
+         *       "price:100%3A200"
+         *     ]
+         */
+        readonly Filters: readonly string[];
+        /** @description Facet name (e.g. "brand", "color", "price"). */
+        readonly FilterAttribute: string;
+        /** @description Facet value (e.g. "Nike", "Red", "100:200"). URL-encoded. */
+        readonly FilterValue: string;
+        /**
+         * @description Whether the user applied or removed this facet.
+         * @enum {string}
+         */
+        readonly FilterAction: "apply" | "remove";
+        /**
+         * Format: decimal
+         * @description Decimal(18, 4) in ClickHouse. Always positive.
+         */
+        readonly Price: number;
+        /** Format: uint32 */
+        readonly Quantity: number;
+        /**
+         * @description ISO 4217 currency code.
+         * @example USD
+         */
+        readonly Currency: string;
+        readonly OrderId: string;
+        readonly CartId: string;
+        /**
+         * @description Conversion subtype taxonomy. Aligns with Algolia's Insights API
+         *     `eventSubtype` enum for the two primary values (`addToCart`,
+         *     `purchase`) so events can flow into Algolia-compatible pipelines
+         *     without remap. Extended with three Seekora-only values
+         *     (`wishlist`, `quick_view`, `save_for_later`) to capture
+         *     soft-conversion intents Algolia does not model — keeping these
+         *     as a typed extension (rather than free-form text) preserves
+         *     richness when funnel queries JOIN on this field.
+         *
+         *     Mapping:
+         *       - `addToCart`      — Algolia parity (Algolia: addToCart)
+         *       - `purchase`       — Algolia parity (Algolia: purchase)
+         *       - `wishlist`       — [Seekora extension] save-for-later list add
+         *       - `quick_view`     — [Seekora extension] quick-view modal open
+         *       - `save_for_later` — [Seekora extension] move-from-cart to later
+         *
+         *     Downstream funnel queries can JOIN on either subset:
+         *       - Algolia-compatible: `WHERE conversion_type IN ('addToCart','purchase')`
+         *       - Full Seekora taxonomy: any value above.
+         * @enum {string}
+         */
+        readonly ConversionType: "addToCart" | "purchase" | "wishlist" | "quick_view" | "save_for_later";
+        readonly OrderLineItem: {
+            readonly object_id: components["schemas"]["ObjectId"];
+            /** @description Algolia objectData[].price equivalent. Decimal(18,4). */
+            readonly price: components["schemas"]["Price"];
+            /** @description Algolia objectData[].quantity equivalent. */
+            readonly quantity: components["schemas"]["Quantity"];
+            /** @description Algolia objectData[].discount equivalent. Absolute discount per line (NOT a percentage). Optional. */
+            readonly discount?: components["schemas"]["Price"];
+            /** @description Algolia objectData[].queryID equivalent — per-item search attribution. Closes the multi-search-order gap: when a cart contains items from different searches, each carries its own search_id. Optional (null for organic / non-attributable line items). */
+            readonly search_id?: components["schemas"]["SearchId"];
+            /** @description [Seekora extension] Vertical discriminator. Defaults to 'product' for ecommerce carts. */
+            readonly object_type?: components["schemas"]["ObjectType"];
+            /** @description [Seekora extension] ISO 4217 currency. Typically inherited from parent OrderCompleted.currency; override allowed for multi-currency carts. */
+            readonly currency?: components["schemas"]["Currency"];
+            /** @description Segment Spec ecommerce v2 line-item field. Optional. */
+            readonly sku?: string;
+            /** @description Segment Spec ecommerce v2 line-item field. Optional. */
+            readonly variant?: string;
+        };
+        readonly SuggestionText: string;
+        /** @enum {string} */
+        readonly SuggestionType: "query" | "product" | "category" | "brand";
+        /**
+         * @description The text the user had typed when the suggestion was clicked.
+         *     Useful for autocomplete relevance analytics.
+         */
+        readonly QueryPrefix: string;
+        readonly Url: string;
+        readonly ImageUrl: string;
+        /**
+         * @description Segment Spec context block + Seekora additions. The tenant-stamp Rotor
+         *     function fills `orgcode` and `xstoreid` from `ctx.props` (Rotor surfaces
+         *     `link.data.functionsEnv` as `ctx.props` to UDFs); producer fills the
+         *     rest. The search-id-infer Rotor function may also stamp
+         *     `search_id_inferred` here when it recovers attribution via cross-event
+         *     correlation.
+         */
+        readonly EventContext: {
+            readonly orgcode: components["schemas"]["OrgCode"];
+            readonly xstoreid: components["schemas"]["XStoreId"];
+            /** @description Numeric org id stamped by tenant-stamp from ctx.props */
+            readonly seekora_org_id?: number;
+            /**
+             * @description Marker stamped by the `seekora-search-id-infer` Rotor function when the
+             *     event arrived WITHOUT a producer-resolved search_id but a matching
+             *     (xstoreid, anonymous_id, object_id) tuple was found in the
+             *     1-hour-TTL Redis cache (populated by prior Object Clicked / Object
+             *     Viewed / Search Impression events). Absent/false on events whose
+             *     search_id came from the 3-layer producer chain (in-memory ->
+             *     sessionStorage -> URL ?seekora_sid). V4 read endpoints accept
+             *     `?include_inferred_attribution=false` to filter these out for
+             *     strict last-click attribution.
+             */
+            readonly search_id_inferred?: boolean;
+            /** @description Client IP (analytics-next auto-fills via fetch) */
+            readonly ip?: string;
+            readonly userAgent?: string;
+            readonly locale?: string;
+            readonly page?: {
+                readonly url?: string;
+                readonly referrer?: string;
+                readonly title?: string;
+                readonly path?: string;
+                /** @description URL query-string portion */
+                readonly search?: string;
+            };
+            readonly campaign?: {
+                readonly source?: string;
+                readonly medium?: string;
+                readonly name?: string;
+                readonly term?: string;
+                readonly content?: string;
+            };
+        };
+        readonly BaseTrackEvent: {
+            /** @enum {string} */
+            readonly type: "track";
+            readonly event: string;
+            readonly messageId: components["schemas"]["MessageId"];
+            /** Format: date-time */
+            readonly timestamp: string;
+            /** Format: date-time */
+            readonly sentAt?: string | null;
+            readonly anonymousId: components["schemas"]["AnonymousId"];
+            readonly userId?: components["schemas"]["UserId"];
+            readonly context: components["schemas"]["EventContext"];
+            /** @description Event-specific properties (specialized per event schema below) */
+            readonly properties: Record<string, never>;
+        };
+        readonly ObjectClickedProperties: {
+            readonly object_id: components["schemas"]["ObjectId"];
+            readonly position: components["schemas"]["Position"];
+            readonly search_id: components["schemas"]["SearchId"];
+            /** @description [Seekora extension] Vertical discriminator. */
+            readonly object_type?: components["schemas"]["ObjectType"];
+            /** @description [Seekora extension] Storefront UI surface. */
+            readonly surface?: components["schemas"]["Surface"];
+            /** @description [Seekora extension] Pipeline provenance, set by source-infer Rotor function. */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly ObjectClicked: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Object Clicked";
+            readonly properties?: components["schemas"]["ObjectClickedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Object Clicked";
+        };
+        readonly ObjectClickedOutsideSearchProperties: {
+            readonly object_id: components["schemas"]["ObjectId"];
+            /** @description [Seekora extension] */
+            readonly object_type?: components["schemas"]["ObjectType"];
+            /** @description [Seekora extension] */
+            readonly surface?: components["schemas"]["Surface"];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly ObjectClickedOutsideSearch: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Object Clicked (Outside Search)";
+            readonly properties?: components["schemas"]["ObjectClickedOutsideSearchProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Object Clicked (Outside Search)";
+        };
+        readonly FacetAppliedProperties: {
+            readonly filter_attribute: components["schemas"]["FilterAttribute"];
+            readonly filter_value: components["schemas"]["FilterValue"];
+            /** @description [Seekora extension] Algolia only models clicks; we capture apply/remove distinction. */
+            readonly action: components["schemas"]["FilterAction"];
+            /** @description [Seekora extension] Joins facet to its originating search for funnel queries. */
+            readonly search_id?: components["schemas"]["SearchId"];
+            /** @description [Seekora extension] */
+            readonly surface?: components["schemas"]["Surface"];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly FacetApplied: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Facet Applied";
+            readonly properties?: components["schemas"]["FacetAppliedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Facet Applied";
+        };
+        readonly ObjectConvertedProperties: {
+            readonly object_id: components["schemas"]["ObjectId"];
+            readonly search_id: components["schemas"]["SearchId"];
+            readonly value?: components["schemas"]["Price"];
+            readonly currency?: components["schemas"]["Currency"];
+            /** @description Algolia eventSubtype equivalent. Two values align with Algolia (addToCart, purchase); Seekora extends with wishlist/quick_view/save_for_later for soft-conversion intents Algolia doesn't model. Optional — absent on bare conversion events. */
+            readonly conversion_type?: components["schemas"]["ConversionType"];
+            /** @description [Seekora extension] */
+            readonly object_type?: components["schemas"]["ObjectType"];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly ObjectConverted: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Object Converted";
+            readonly properties?: components["schemas"]["ObjectConvertedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Object Converted";
+        };
+        readonly ObjectConvertedOutsideSearchProperties: {
+            readonly object_id: components["schemas"]["ObjectId"];
+            readonly value?: components["schemas"]["Price"];
+            readonly currency?: components["schemas"]["Currency"];
+            /** @description Algolia eventSubtype equivalent. Two values align with Algolia (addToCart, purchase); Seekora extends with wishlist/quick_view/save_for_later for soft-conversion intents Algolia doesn't model. Optional. */
+            readonly conversion_type?: components["schemas"]["ConversionType"];
+            /** @description [Seekora extension] */
+            readonly object_type?: components["schemas"]["ObjectType"];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly ObjectConvertedOutsideSearch: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Object Converted (Outside Search)";
+            readonly properties?: components["schemas"]["ObjectConvertedOutsideSearchProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Object Converted (Outside Search)";
+        };
+        readonly FilterConvertedProperties: {
+            readonly filter_attribute: components["schemas"]["FilterAttribute"];
+            readonly filter_value: components["schemas"]["FilterValue"];
+            readonly value?: components["schemas"]["Price"];
+            readonly currency?: components["schemas"]["Currency"];
+            /** @description Algolia eventSubtype equivalent. Two values align with Algolia (addToCart, purchase); Seekora extends with wishlist/quick_view/save_for_later for soft-conversion intents Algolia doesn't model. Optional. */
+            readonly conversion_type?: components["schemas"]["ConversionType"];
+            /** @description [Seekora extension] queryID not present on ConvertedFilters in Algolia; added for funnel attribution. */
+            readonly search_id?: components["schemas"]["SearchId"];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly FilterConverted: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Filter Converted";
+            readonly properties?: components["schemas"]["FilterConvertedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Filter Converted";
+        };
+        readonly ProductAddedProperties: {
+            /** @description Segment Spec ecommerce v2 field — Shopify Web Pixel emits this name. */
+            readonly product_id: components["schemas"]["ObjectId"];
+            readonly variant?: string;
+            readonly sku?: string;
+            readonly name?: string;
+            readonly price: components["schemas"]["Price"];
+            readonly quantity: components["schemas"]["Quantity"];
+            readonly currency: components["schemas"]["Currency"];
+            readonly cart_id?: components["schemas"]["CartId"];
+            readonly brand?: string;
+            readonly category?: string;
+            readonly image_url?: components["schemas"]["ImageUrl"];
+            readonly url?: components["schemas"]["Url"];
+            /** @description [Seekora extension] Canonical item identifier — set to product_id by Layer 2 object-canonicalize Rotor function. */
+            readonly object_id?: components["schemas"]["ObjectId"];
+            /** @description [Seekora extension] Always 'product' for Shopify Web Pixel events. */
+            readonly object_type?: components["schemas"]["ObjectType"];
+            /** @description [Seekora extension] Stamped by Web Pixel mapper if URL ?seekora_sid is present + within 30-min TTL. */
+            readonly search_id?: components["schemas"]["SearchId"];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly ProductAdded: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Product Added";
+            readonly properties?: components["schemas"]["ProductAddedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Product Added";
+        };
+        /**
+         * @description Segment Spec ecommerce v2 products[] line-item shape. Used inside Order Completed.products[].
+         *     Source: https://segment.com/docs/connections/spec/ecommerce/v2/#order-completed
+         *     Rotor's orderline-explode function fans these out into Order Line Completed events.
+         *     NOTE: search_id field is a Seekora extension (carried from Product Added attribution).
+         */
+        readonly OrderProduct: {
+            readonly product_id: components["schemas"]["ObjectId"];
+            readonly name?: string;
+            readonly sku?: string;
+            readonly variant?: string;
+            readonly quantity: components["schemas"]["Quantity"];
+            readonly price: components["schemas"]["Price"];
+            readonly category?: string;
+            readonly brand?: string;
+            readonly url?: components["schemas"]["Url"];
+            /** @description [Seekora extension] Search attribution for this line item, carried forward from Product Added time. */
+            readonly search_id?: components["schemas"]["SearchId"];
+        };
+        readonly OrderCompletedProperties: {
+            readonly order_id: components["schemas"]["OrderId"];
+            readonly total: components["schemas"]["Price"];
+            readonly currency: components["schemas"]["Currency"];
+            readonly revenue?: components["schemas"]["Price"];
+            readonly tax?: components["schemas"]["Price"];
+            readonly shipping?: components["schemas"]["Price"];
+            readonly discount?: components["schemas"]["Price"];
+            readonly coupon?: string;
+            readonly products: readonly components["schemas"]["OrderProduct"][];
+            /**
+             * @description [Seekora extension of Algolia objectData[]] Per-line item detail with
+             *     optional per-line search_id (Algolia queryID equivalent) for
+             *     multi-search order attribution. When a cart contains items from
+             *     different searches, each line carries its own search_id; the parent
+             *     `search_ids[]` field below is the dedup'd aggregate of these values.
+             *
+             *     The rotor's `seekora-orderline-explode` function fans this array
+             *     into per-row `Order Line Completed` events; consumers querying the
+             *     parent `Order Completed` can read `object_data` directly without
+             *     JOINing back to the per-line event table.
+             *
+             *     NOT required (legacy emitters without line-item depth keep working).
+             *     When present, `object_data[i].currency` may override the parent
+             *     `currency` for multi-currency carts; otherwise it is inherited.
+             */
+            readonly object_data?: readonly components["schemas"]["OrderLineItem"][];
+            /**
+             * @description [Seekora extension] Derived aggregate: distinct, non-null search_ids
+             *     across `object_data[]` (and `products[].search_id` for legacy
+             *     payloads). Useful for the quick boolean "was this order
+             *     search-attributed at all?" filter without unnesting object_data.
+             *     For per-item attribution detail (which item came from which
+             *     search), read `object_data[].search_id` instead.
+             */
+            readonly search_ids?: readonly components["schemas"]["SearchId"][];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly OrderCompleted: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Order Completed";
+            readonly properties?: components["schemas"]["OrderCompletedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Order Completed";
+        };
+        readonly OrderLineCompletedProperties: {
+            readonly order_id: components["schemas"]["OrderId"];
+            readonly object_id: components["schemas"]["ObjectId"];
+            readonly object_type?: components["schemas"]["ObjectType"];
+            /**
+             * Format: uint16
+             * @description 0-indexed position in the parent Order Completed.products[]
+             */
+            readonly line_position: number;
+            readonly quantity: components["schemas"]["Quantity"];
+            readonly price: components["schemas"]["Price"];
+            readonly currency: components["schemas"]["Currency"];
+            /** @description Search attribution for this line item (carried from Product Added). Nullable if no attributable search. */
+            readonly search_id?: components["schemas"]["SearchId"];
+            /**
+             * @description Always rotor_synthesized_orderline. Distinguishes from any client-emitted line events.
+             * @enum {string}
+             */
+            readonly _source: "rotor_synthesized_orderline";
+        };
+        readonly OrderLineCompleted: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Order Line Completed";
+            readonly properties?: components["schemas"]["OrderLineCompletedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Order Line Completed";
+        };
+        readonly ProductViewedProperties: {
+            readonly product_id: components["schemas"]["ObjectId"];
+            readonly variant?: string;
+            readonly sku?: string;
+            readonly name?: string;
+            readonly price?: components["schemas"]["Price"];
+            readonly currency?: components["schemas"]["Currency"];
+            readonly brand?: string;
+            readonly category?: string;
+            readonly url?: components["schemas"]["Url"];
+            readonly image_url?: components["schemas"]["ImageUrl"];
+            /** @description [Seekora extension] Canonical = product_id (set by Layer 2 Rotor function). */
+            readonly object_id?: components["schemas"]["ObjectId"];
+            /** @description [Seekora extension] Always 'product' for Shopify Web Pixel events. */
+            readonly object_type?: components["schemas"]["ObjectType"];
+            /** @description [Seekora extension] Stamped from URL ?seekora_sid if within 30-min TTL. */
+            readonly search_id?: components["schemas"]["SearchId"];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly ProductViewed: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Product Viewed";
+            readonly properties?: components["schemas"]["ProductViewedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Product Viewed";
+        };
+        readonly ObjectViewedProperties: {
+            readonly object_id: components["schemas"]["ObjectId"];
+            /** @description [Seekora extension] */
+            readonly object_type?: components["schemas"]["ObjectType"];
+            /** @description [Seekora extension] Search-tree attribution. */
+            readonly search_id?: components["schemas"]["SearchId"];
+            /** @description [Seekora extension] */
+            readonly surface?: components["schemas"]["Surface"];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly ObjectViewed: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Object Viewed";
+            readonly properties?: components["schemas"]["ObjectViewedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Object Viewed";
+        };
+        readonly FilterViewedProperties: {
+            readonly filter_attribute: components["schemas"]["FilterAttribute"];
+            readonly filter_value?: components["schemas"]["FilterValue"];
+            /** @description [Seekora extension] */
+            readonly search_id?: components["schemas"]["SearchId"];
+            /** @description [Seekora extension] */
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly FilterViewed: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Filter Viewed";
+            readonly properties?: components["schemas"]["FilterViewedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Filter Viewed";
+        };
+        readonly SearchSubmittedProperties: {
+            readonly search_id: components["schemas"]["SearchId"];
+            readonly query: components["schemas"]["Query"];
+            readonly num_found: components["schemas"]["NumFound"];
+            readonly page?: components["schemas"]["Page"];
+            readonly sort_by?: components["schemas"]["SortBy"];
+            readonly filters?: components["schemas"]["Filters"];
+            readonly surface?: components["schemas"]["Surface"];
+            /** @description Nullable. Present if user reached this search by clicking an autocomplete suggestion. */
+            readonly triggered_by_suggestion_id?: components["schemas"]["SuggestionEventId"];
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly SearchSubmitted: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Search Submitted";
+            readonly properties?: components["schemas"]["SearchSubmittedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Search Submitted";
+        };
+        readonly SearchImpressionProperties: {
+            readonly search_id: components["schemas"]["SearchId"];
+            readonly object_id: components["schemas"]["ObjectId"];
+            readonly object_type?: components["schemas"]["ObjectType"];
+            readonly position: components["schemas"]["Position"];
+            readonly surface: components["schemas"]["Surface"];
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly SearchImpression: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Search Impression";
+            readonly properties?: components["schemas"]["SearchImpressionProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Search Impression";
+        };
+        readonly SearchRefinedProperties: {
+            /** @description The NEW search_id minted for the refined search */
+            readonly search_id: components["schemas"]["SearchId"];
+            /** @description The PREVIOUS search_id that this refinement evolved FROM */
+            readonly from_search_id: components["schemas"]["FromSearchId"];
+            readonly from_query: components["schemas"]["Query"];
+            readonly to_query: components["schemas"]["Query"];
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly SearchRefined: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Search Refined";
+            readonly properties?: components["schemas"]["SearchRefinedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Search Refined";
+        };
+        readonly SearchEmptyProperties: {
+            readonly search_id: components["schemas"]["SearchId"];
+            readonly query: components["schemas"]["Query"];
+            readonly filters?: components["schemas"]["Filters"];
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly SearchEmpty: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Search Empty";
+            readonly properties?: components["schemas"]["SearchEmptyProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Search Empty";
+        };
+        readonly SuggestionClickedProperties: {
+            readonly suggestion_event_id: components["schemas"]["SuggestionEventId"];
+            readonly suggestion_text: components["schemas"]["SuggestionText"];
+            /** Format: uint16 */
+            readonly suggestion_position: number;
+            readonly suggestion_type: components["schemas"]["SuggestionType"];
+            readonly query_prefix?: components["schemas"]["QueryPrefix"];
+            /** @description Nullable. Only set when the suggestion click happened DURING an active search (clicking a related-suggestion below the results, for example). */
+            readonly search_id?: components["schemas"]["SearchId"];
+            readonly _source: components["schemas"]["Source"];
+        };
+        readonly SuggestionClicked: components["schemas"]["BaseTrackEvent"] & {
+            /** @enum {string} */
+            readonly event?: "Suggestion Clicked";
+            readonly properties?: components["schemas"]["SuggestionClickedProperties"];
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            readonly event: "Suggestion Clicked";
+        };
+        readonly AnalyticsEvent: components["schemas"]["ObjectClicked"] | components["schemas"]["ObjectClickedOutsideSearch"] | components["schemas"]["FacetApplied"] | components["schemas"]["ObjectConverted"] | components["schemas"]["ObjectConvertedOutsideSearch"] | components["schemas"]["FilterConverted"] | components["schemas"]["ProductAdded"] | components["schemas"]["OrderCompleted"] | components["schemas"]["OrderLineCompleted"] | components["schemas"]["ProductViewed"] | components["schemas"]["ObjectViewed"] | components["schemas"]["FilterViewed"] | components["schemas"]["SearchSubmitted"] | components["schemas"]["SearchImpression"] | components["schemas"]["SearchRefined"] | components["schemas"]["SearchEmpty"] | components["schemas"]["SuggestionClicked"];
+        readonly BatchEnvelope: {
+            readonly batch: readonly components["schemas"]["AnalyticsEvent"][];
+            /**
+             * @description Stream-level write key (== Jitsu Stream.ID per SCRUM-263 convention).
+             *     Per-tenant; provisioned by `RegisterJitsuHook`.
+             */
+            readonly writeKey: string;
+            /** Format: date-time */
+            readonly sentAt?: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    readonly ingestBatch: {
+        readonly parameters: {
+            readonly query?: never;
+            readonly header?: never;
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        readonly requestBody: {
+            readonly content: {
+                readonly "application/json": components["schemas"]["BatchEnvelope"];
+            };
+        };
+        readonly responses: {
+            /** @description Accepted (events queued; downstream processing async) */
+            readonly 200: {
+                headers: {
+                    readonly [name: string]: unknown;
+                };
+                content: {
+                    readonly "application/json": {
+                        readonly ok?: boolean;
+                        /** @description count dropped by stream.deduplicateWindowMs */
+                        readonly deduplicatedEvents?: number;
+                    };
+                };
+            };
+            /** @description Invalid writeKey */
+            readonly 401: {
+                headers: {
+                    readonly [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Throttled — stream.throttle dropped this request */
+            readonly 402: {
+                headers: {
+                    readonly [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+}