@viu/emporix-sdk 2.18.0 → 2.20.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems, T as TokenProvider, n as ResolvedConfig, E as EmporixConfig, j as LogLevel, o as ServiceName, e as CustomerTokenRefresher } from './context-DhoFgoKf.js';
-export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, d as CustomerRefreshRegistry, D as DEFAULT_HOST, f as DefaultTokenProvider, H as HttpClient, g as HttpClientOptions, L as LEVEL, h as LevelResolver, i as LogFields, k as Logger, l as LoggerConfig, m as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, p as StorefrontCredentials, q as auth, r as createConsoleLogger, s as createNoopLogger, t as iterateAll, u as redact, v as resolveToken, w as validateConfig } from './context-DhoFgoKf.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems, T as TokenProvider, n as ResolvedConfig, E as EmporixConfig, j as LogLevel, o as ServiceName, e as CustomerTokenRefresher } from './context-Dawv2AtS.js';
+export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, d as CustomerRefreshRegistry, D as DEFAULT_HOST, f as DefaultTokenProvider, H as HttpClient, g as HttpClientOptions, L as LEVEL, h as LevelResolver, i as LogFields, k as Logger, l as LoggerConfig, m as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, p as StorefrontCredentials, q as auth, r as createConsoleLogger, s as createNoopLogger, t as iterateAll, u as redact, v as resolveToken, w as validateConfig } from './context-Dawv2AtS.js';
 import { CustomerService } from './customer.js';
 export { Address, AddressCreateInput, AddressUpdateInput, Customer, CustomerSession, CustomerSignupInput, CustomerUpdateInput, PasswordChangeInput, PasswordResetConfirmInput, PasswordResetRequestInput } from './customer.js';
 import { ProductService } from './product.js';
@@ -421,6 +421,8 @@ declare class RagIndexerService {
      * Schedule a full asynchronous re-index for `type` (default `"PRODUCT"`).
      * Resolves once the rebuild is *scheduled* (HTTP 204); there is no progress
      * to await or poll. Costly — avoid calling on a hot path.
+     * @deprecated since 2026-06-18, removal 2026-12-01 — use the indexing service:
+     * `client.indexing.createReindexJob({ entityType: "PRODUCT", rag: true })`.
      */
     reindex(type?: RagType, auth?: AuthContext): Promise<void>;
 }
@@ -832,7 +834,7 @@ declare class CloudFunctionsService {
 
 type AbstractWebhookConfig = {
     /**
-     * Indicates whether a given configuration is active. Only one configuration can be active.
+     * Indicates whether a given configuration is active. Only one configuration can be active at a time.
      */
     active?: boolean;
     provider?: Provider;
@@ -940,9 +942,16 @@ type ConfigurationGet = {
     }>;
 };
 /**
- * Unique identifier of webhook configuration.
+ * Unique identifier of the webhook configuration type.
  */
 type ConfigCode = string;
+/**
+ * Webhook provider strategy. Maps to configuration types as follows:
+ *
+ * * `SVIX` – `svix`
+ * * `SVIX_SHARED` – `svix_shared`
+ * * `HTTP` – `http`
+ */
 type Provider = 'SVIX_SHARED' | 'SVIX' | 'HTTP';
 type WebhookConfigUpdate = AbstractWebhookConfig & {
     configuration?: Configuration;
@@ -988,7 +997,7 @@ type WebhookEvent = {
  */
 type WebhookSubscription$1 = {
     event?: WebhookEvent;
-    metadata?: Metadata$7;
+    metadata?: Metadata$8;
     /**
      * Status of the subscription.
      */
@@ -1023,7 +1032,7 @@ type WebhookSubscriptionUpdateItem$1 = {
 /**
  * Auditing details.
  */
-type Metadata$7 = {
+type Metadata$8 = {
     /**
      * Date and time when the document was created.
      */
@@ -1175,7 +1184,7 @@ declare class WebhookService {
 /**
  * Type which the schema should be assigned to. Can be one of the predefined values or any custom schema type id.
  */
-type SchemaType = 'CART' | 'CART_ITEM' | 'CATEGORY' | 'COMPANY' | 'COUPON' | 'CUSTOMER' | 'CUSTOMER_ADDRESS' | 'ORDER' | 'ORDER_ENTRY' | 'PRODUCT' | 'QUOTE' | 'RETURN' | 'PRICE_LIST' | 'SITE' | 'CUSTOM_ENTITY' | 'VENDOR';
+type SchemaType = 'CART' | 'CART_ITEM' | 'CATEGORY' | 'COMPANY' | 'COUPON' | 'CUSTOMER' | 'CUSTOMER_ADDRESS' | 'ORDER' | 'ORDER_ENTRY' | 'PRODUCT' | 'QUOTE' | 'RETURN' | 'PRICE_LIST' | 'SITE' | 'CUSTOM_ENTITY' | 'VENDOR' | 'MEDIA';
 /**
  * Type of the attribute.
  *
@@ -1376,6 +1385,42 @@ type CustomInstanceResponse = {
     media?: Array<string>;
     metadata?: CustomInstanceMetadata;
 };
+type BulkPatchCustomInstanceRequest = {
+    /**
+     * Unique identifier of the custom instance to patch.
+     */
+    id: string;
+    /**
+     * List of patch operations to apply to the custom instance.
+     */
+    data: Array<{
+        [key: string]: unknown;
+    }>;
+};
+type BulkResponse = Array<{
+    /**
+     * Index of the processed item, matching the item position in request body.
+     */
+    index?: number;
+    /**
+     * HTTP Status Code.
+     */
+    code?: number;
+    /**
+     * HTTP Status description
+     */
+    status?: string;
+    /**
+     * Error message.
+     */
+    message?: string;
+    details?: Array<{
+        /**
+         * Error details.
+         */
+        message?: string;
+    }>;
+}>;
 type CustomInstanceMetadata = {
     /**
      * Date and time when the object was created, compliant with the ISO 8601 standard. For example: `2022-03-31T09:52:15.423Z`
@@ -1397,6 +1442,10 @@ type CustomInstanceMetadata = {
     };
 };
 
+/** One item for {@link SchemaService.bulkPatchInstances} — `{ id, data: op[] }`. */
+type BulkPatchInstanceItem = BulkPatchCustomInstanceRequest;
+/** Per-item results of a bulk operation (207) — `{ index?, code?, status?, message?, details? }[]`. */
+type BulkInstanceResult = BulkResponse;
 /** A schema definition (typed attributes attached to one or more entity types). */
 type Schema = SchemaResponse;
 /** A single typed attribute within a schema (recursive for `OBJECT`). */
@@ -1539,6 +1588,13 @@ declare class SchemaService {
     replaceInstance<T = Record<string, unknown>>(type: string, id: string, draft: CustomInstanceDraft<T>, auth?: AuthContext): Promise<CustomInstance<T>>;
     /** Partially update an instance (`PATCH`). */
     patchInstance<T = Record<string, unknown>>(type: string, id: string, patch: Partial<CustomInstanceDraft<T>>, auth?: AuthContext): Promise<CustomInstance<T>>;
+    /**
+     * Patch up to 200 custom instances of `type` in one call
+     * (`PATCH /custom-entities/{type}/instances/bulk`). Returns a 207 envelope:
+     * a per-item result array — a 207 is success, individual failures live in
+     * each item's `code`/`status`.
+     */
+    bulkPatchInstances(type: string, items: BulkPatchInstanceItem[], auth?: AuthContext): Promise<BulkInstanceResult>;
     /** Delete an instance by id. */
     deleteInstance(type: string, id: string, auth?: AuthContext): Promise<void>;
     /**
@@ -1557,6 +1613,20 @@ type AgenticRequest = {
      * The user message to the agent.
      */
     message: string;
+    attachments?: Array<{
+        /**
+         * Id of the attachment.
+         */
+        attachmentId: string;
+        /**
+         * Caption of the attachment.
+         */
+        caption?: string;
+        /**
+         * Purpose of the attachment.
+         */
+        purpose?: string;
+    }>;
 };
 /**
  * Type of the agent handling the request.
@@ -1603,9 +1673,9 @@ type ExpandedTokenResponse = InnerTokenResponse & {
  */
 type ExpandableTokenResponse = InnerTokenResponse | ExpandedTokenResponse;
 /**
- * Type of the native tool.
+ * Type of the native tool. Value `teams` is in preview.
  */
-type NativeToolType = 'slack' | 'rag_custom' | 'rag_emporix';
+type NativeToolType = 'slack' | 'rag_custom' | 'rag_emporix' | 'teams';
 type BaseNativeTool = {
     type: NativeToolType;
     /**
@@ -1733,15 +1803,11 @@ type RagEmporixNativeToolConfig = {
     /**
      * This field specifies the fields of the given entityType that are used for filtering the data before performing actual search.
      */
-    filterFields: Array<{
+    filterFields?: Array<{
         /**
          * It should contain the description of the field, so LLM is able to know when to use this field in order to filter the data. For enums, possible values should be specified here.
          */
         description?: string;
-        /**
-         * It can act as an alias for the field key.
-         */
-        name?: string;
         /**
          * Unique value representing the entityType key.
          */
@@ -1769,6 +1835,49 @@ type SlackNativeToolResponse = BaseNativeTool & {
     config?: SlackNativeToolConfigResponse;
     metadata?: MetadataResponse$1;
 };
+/**
+ * MS Teams native tool operation identifier.
+ */
+type TeamsAllowedOperations = 'sendMessage' | 'createChat' | 'createChannel' | 'inviteParticipants' | 'collaborateOnChannel' | 'collaborateOnChat';
+/**
+ * ![Preview](https://res.cloudinary.com/saas-ag/image/upload/v1752824268/emporix/icons/preview_api1.png)
+ *
+ * {% hint style="danger" %}
+ * This functionality is in preview mode - some of the features may not be fully operational yet.
+ * {% endhint %}
+ *
+ * Configuration of an MS Teams native tool instance.
+ */
+type TeamsNativeToolConfigResponse = {
+    /**
+     * Microsoft Teams team ID the tool is bound to.
+     */
+    teamId: string;
+    /**
+     * Customer Azure AD tenant ID for the Teams workspace.
+     */
+    tenantId?: string;
+    /**
+     * Agent ID that handles inbound Teams replies when no conversation-specific owner is set.
+     */
+    defaultInboundAgentId?: string;
+    /**
+     * Operations the tool instance exposes to assigned agents. At least one value is required when the tool is enabled.
+     */
+    allowedOperations?: Array<TeamsAllowedOperations>;
+};
+type TeamsNativeToolResponse = BaseNativeTool & {
+    /**
+     * Unique identifier of the tool.
+     */
+    id?: string;
+    /**
+     * For TeamsNativeTool it has to be set to `teams`.
+     */
+    type?: unknown;
+    config?: TeamsNativeToolConfigResponse;
+    metadata?: MetadataResponse$1;
+};
 type RagCustomNativeToolResponse = BaseNativeTool & {
     /**
      * Unique identifier of the tool.
@@ -1796,7 +1905,40 @@ type RagEmporixNativeToolResponse = BaseNativeTool & {
 /**
  * List of native tools which agents should have access to.
  */
-type NativeToolsResponse = Array<SlackNativeToolResponse | RagCustomNativeToolResponse | RagEmporixNativeToolResponse>;
+type NativeToolsResponse = Array<SlackNativeToolResponse | RagCustomNativeToolResponse | RagEmporixNativeToolResponse | TeamsNativeToolResponse>;
+/**
+ * Represents an active agent conversation context (MS Teams channel or group chat).
+ */
+type ConversationResponse = {
+    /**
+     * Provider-side conversation identifier (Teams conversation ID).
+     */
+    conversationId?: string;
+    /**
+     * Human-readable name of the conversation channel or group chat.
+     */
+    conversationName?: string;
+    /**
+     * Caller-supplied reference key used to reuse an existing conversation.
+     */
+    contextRef?: string;
+    /**
+     * Teams channel or chat identifier.
+     */
+    channelId?: string;
+    /**
+     * Identifier of the agent that owns this conversation.
+     */
+    agentId?: string;
+    /**
+     * LangGraph session (checkpointer) ID for agent continuity.
+     */
+    sessionId?: string;
+    /**
+     * Timestamp of the last message activity in this conversation.
+     */
+    lastMessageAt?: string;
+};
 type McpServerConfig = {
     /**
      * URL of the MCP server.
@@ -1881,11 +2023,11 @@ type BaseLlm = {
     /**
      * Value between 0.1 and 1.0 (inclusive), in steps of 0.1. The lower value the more creative (but less stable) the model is.
      */
-    temperature: 0.1 | 0.2 | 0.3 | 0.4 | 0.5 | 0.6 | 0.7 | 0.8 | 0.9 | 1;
+    temperature?: 0.1 | 0.2 | 0.3 | 0.4 | 0.5 | 0.6 | 0.7 | 0.8 | 0.9 | 1;
     /**
      * The limit of tokens which agent can burn during one request session.
      */
-    maxTokens: number;
+    maxTokens?: number;
 };
 type EmporixLlm = BaseLlm & {
     /**
@@ -1893,6 +2035,35 @@ type EmporixLlm = BaseLlm & {
      */
     provider: 'emporix_openai';
 };
+/**
+ * OAuth 2.0 client-credentials settings for authenticating with a self-hosted LLM backend.
+ */
+type OAuthParams = {
+    /**
+     * Base URL of the OAuth 2.0 authorization server. The access token is requested from `{url}/token`.
+     */
+    url: string;
+    /**
+     * OAuth 2.0 client identifier registered with the authorization server.
+     */
+    clientId: string;
+    /**
+     * OAuth 2.0 grant type used to obtain an access token.
+     */
+    grantType: 'client_credentials';
+    /**
+     * Optional space-separated list of scopes to request for the access token.
+     */
+    scope?: string;
+};
+type OAuthParamsRequest = OAuthParams & {
+    [key: string]: unknown;
+} & {
+    clientSecret?: InnerTokenRequest;
+};
+type OAuthParamsResponse = OAuthParams & {
+    clientSecret?: ExpandableTokenResponse;
+};
 type SelfHostedParams = {
     /**
      * Url of the self-hosted LLM.
@@ -1907,9 +2078,11 @@ type SelfHostedParamsRequest = SelfHostedParams & {
     [key: string]: unknown;
 } & {
     authorizationHeaderToken?: InnerTokenRequest;
+    oAuthParams?: OAuthParamsRequest;
 };
 type SelfHostedParamsResponse = SelfHostedParams & {
     authorizationHeaderToken?: ExpandableTokenResponse;
+    oAuthParams?: OAuthParamsResponse;
 };
 type SelfHostedLlm = BaseLlm & {
     /**
@@ -1936,8 +2109,24 @@ type ApiKeyLlmRequest = ApiKeyLlm & {
 type ApiKeyLlmResponse = ApiKeyLlm & {
     token?: ExpandableTokenResponse;
 };
-type IdWrapper = {
+/**
+ * ![Preview](https://res.cloudinary.com/saas-ag/image/upload/v1752824268/emporix/icons/preview_api1.png)
+ *
+ * {% hint style="danger" %}
+ * This functionality is in preview mode - some of the features may not be fully operational yet.
+ * {% endhint %}
+ *
+ * Reference to a native tool assigned to an agent.
+ */
+type NativeToolReferenceRequest = {
+    /**
+     * Identifier of the native tool.
+     */
     id: string;
+    /**
+     * Optional per-agent override of allowed MS Teams operations. When omitted, the tool instance defaults apply.
+     */
+    allowedOperations?: Array<TeamsAllowedOperations>;
 };
 /**
  * List of agent collaborations which allows an agent to hand off its task to other agents.
@@ -1960,6 +2149,68 @@ type TriggerType = 'endpoint' | 'slack';
  * Type of the trigger.
  */
 type CommerceEventsTriggerType = 'commerce_events';
+/**
+ * Logical operator used to combine multiple filter conditions.
+ */
+type CommerceEventTriggerFilterLogicalOperator = '$and' | '$or';
+/**
+ * Scalar value used in commerce event filter comparisons.
+ */
+type CommerceEventTriggerFilterScalarValue = string | number | boolean;
+/**
+ * Array value used by list-based operators in commerce event filters.
+ */
+type CommerceEventTriggerFilterScalarArrayValue = Array<CommerceEventTriggerFilterScalarValue>;
+/**
+ * Filter condition for unary operators that do not accept `right`.
+ */
+type CommerceEventTriggerLeafFilterNoRight = {
+    /**
+     * Dot-notation path to a field in the commerce event payload.
+     */
+    left: string;
+    op: '$exists' | '$notExists' | '$isEmpty' | '$notEmpty';
+};
+/**
+ * Filter condition for scalar comparison operators.
+ */
+type CommerceEventTriggerLeafFilterScalarRight = {
+    /**
+     * Dot-notation path to a field in the commerce event payload.
+     */
+    left: string;
+    op: '$eq' | '$ne';
+    right: CommerceEventTriggerFilterScalarValue;
+};
+/**
+ * Filter condition for array membership operators.
+ */
+type CommerceEventTriggerLeafFilterArrayRight = {
+    /**
+     * Dot-notation path to a field in the commerce event payload.
+     */
+    left: string;
+    op: '$in' | '$notIn';
+    right: CommerceEventTriggerFilterScalarArrayValue;
+};
+/**
+ * Filter condition applied to a single field in the commerce event payload.
+ */
+type CommerceEventTriggerLeafFilter = CommerceEventTriggerLeafFilterNoRight | CommerceEventTriggerLeafFilterScalarRight | CommerceEventTriggerLeafFilterArrayRight;
+/**
+ * Filter that combines multiple conditions using logical operators.
+ */
+type CommerceEventTriggerCompoundFilter = {
+    op: CommerceEventTriggerFilterLogicalOperator;
+    /**
+     * Nested filter conditions combined by the logical operator.
+     */
+    conditions: Array<CommerceEventTriggerFilter>;
+};
+/**
+ * Optional filter expression applied to commerce event payloads. When set, the agent is triggered only if the event payload matches the filter.
+ */
+type CommerceEventTriggerFilter = CommerceEventTriggerLeafFilter | CommerceEventTriggerCompoundFilter;
 type AgentTrigger = {
     type: TriggerType;
 } | {
@@ -1972,6 +2223,7 @@ type AgentTrigger = {
          * List of events that trigger the agent.
          */
         events: string;
+        filter?: CommerceEventTriggerFilter;
     };
 };
 /**
@@ -2018,6 +2270,11 @@ type BaseForAgentAndTemplate = BaseForAgentAndTemplateAndHandOff & {
      */
     icon?: string;
     tags?: Array<string>;
+    /**
+     * Optional JSON Schema (provided as a JSON string) that constrains the structure of the agent's generated output. Use this when you need predictable, machine-readable output instead of free-form text.
+     *
+     */
+    outputFormat?: string;
     /**
      * Indicates whether the agent is enabled.
      */
@@ -2037,9 +2294,9 @@ type BaseForAgentRequestAndResponse = BaseForAgentAndTemplate & {
 };
 type AgentRequest = BaseForAgentRequestAndResponse & {
     /**
-     * ID of the native tools.
+     * Native tools assigned to the agent, optionally with per-agent `allowedOperations` overrides.
      */
-    nativeTools?: Array<IdWrapper>;
+    nativeTools?: Array<NativeToolReferenceRequest>;
     llmConfig: EmporixLlm | ApiKeyLlmRequest | SelfHostedLlmRequest;
     mcpServers: AgentMcpServersRequest;
     metadata?: MetadataRequest;
@@ -2111,6 +2368,7 @@ type PatchRequest = Array<{
         [key: string]: unknown;
     };
 }>;
+type QParamSearchBody2 = QParamSearchBody;
 
 /** Single-shot text generation request (`POST /texts`). Has `maxTokens`. */
 type TextRequest = TextGenerationRequest;
@@ -2166,6 +2424,18 @@ interface DeleteAgentOptions {
     /** Force deletion even if the agent is referenced elsewhere (`?force=true`). */
     force?: boolean;
 }
+/** Options for {@link AiService.chatStream}. */
+interface ChatStreamOptions {
+    /**
+     * Reuse an existing chat context (sent as the `session-id` header). If
+     * omitted, the server generates a new session id.
+     */
+    sessionId?: string;
+}
+/** A stored agentic conversation (Teams-backed). */
+type Conversation = ConversationResponse;
+/** Request body for `searchConversations` (`{ q? }`) — same shape as agent search. */
+type ConversationSearchQuery = QParamSearchBody2;
 
 /**
  * Emporix AI Service (`/ai-service/{tenant}/…`): text generation, chat
@@ -2217,9 +2487,20 @@ declare class AiService {
      * Returns the job-id ARRAY verbatim.
      */
     chatAsync(input: ChatRequest, auth?: AuthContext): Promise<JobIdResponse[]>;
+    /**
+     * Streaming agent chat (`POST /agentic/chat-stream`, `text/event-stream`).
+     * Yields each SSE `data` payload verbatim — the upstream contract types the
+     * stream body as an opaque string, so chunks are raw strings, not parsed
+     * objects. Consume with `for await`.
+     */
+    chatStream(input: ChatRequest, opts?: ChatStreamOptions, auth?: AuthContext): AsyncIterable<string>;
+    /** List stored agentic conversations (`GET /agentic/conversations`). */
+    listConversations(auth?: AuthContext): Promise<Conversation[]>;
+    /** Server-side conversation search (`POST /agentic/conversations/search`). */
+    searchConversations(query: ConversationSearchQuery, auth?: AuthContext): Promise<Conversation[]>;
 }
 
-type Metadata$6 = {
+type Metadata$7 = {
     /**
      * Date and time when the object was created.
      */
@@ -2253,7 +2534,7 @@ type TaxRetrieval = {
      * List of tax classes applicable in the specified country.
      */
     taxClasses?: Array<TaxClass>;
-    metadata?: Metadata$6;
+    metadata?: Metadata$7;
 };
 /**
  * Single tax class.
@@ -2426,7 +2707,7 @@ type Location$2 = {
     countryCode: string;
 };
 type TaxUpdate = TaxCreation & {
-    metadata: Metadata$6;
+    metadata: Metadata$7;
 };
 
 /**
@@ -3428,7 +3709,7 @@ type Label$1 = {
     description?: string | {
         [key: string]: string;
     };
-    metadata?: Metadata$5;
+    metadata?: Metadata$6;
 };
 /**
  * If present and `isTrue` is actually true the label should be printed on associated products on the described position.
@@ -3440,7 +3721,7 @@ type Overlay = {
 /**
  * Metadata
  */
-type Metadata$5 = {
+type Metadata$6 = {
     /**
      * The creation date.
      */
@@ -3494,7 +3775,7 @@ declare class LabelService {
     deleteLabel(labelId: string, auth?: AuthContext): Promise<void>;
 }
 
-type Metadata$4 = {
+type Metadata$5 = {
     /**
      * Date and time when the document was created.
      */
@@ -3527,7 +3808,7 @@ type Country$1 = {
      * The field indicating whether the given country is active for the tenant or not. Only active countries are visible in the system.
      */
     active?: boolean;
-    metadata?: Metadata$4;
+    metadata?: Metadata$5;
 };
 type Region$1 = {
     /**
@@ -3540,7 +3821,7 @@ type Region$1 = {
     name?: {
         [key: string]: string;
     };
-    metadata?: Metadata$4;
+    metadata?: Metadata$5;
 };
 type CountryUpdate$1 = {
     /**
@@ -3594,7 +3875,7 @@ declare class CountryService {
     getRegion(regionCode: string, auth?: AuthContext): Promise<Region>;
 }
 
-type Metadata$3 = {
+type Metadata$4 = {
     /**
      * Time of document creation.
      */
@@ -3684,7 +3965,7 @@ type CurrencyRetrieval = {
     name?: string | {
         [key: string]: string;
     };
-    metadata?: Metadata$3;
+    metadata?: Metadata$4;
 };
 type ExchangeRateUpdateRequest = {
     /**
@@ -3730,7 +4011,7 @@ type ExchangeRateRetrieval = {
      * The value of the field is represented by a number where the cent part is separated by a dot. For example `1.09`. The cent part is not limited just to two digits. A rate with any precision can be returned. For example: `1.091934212`
      */
     rate?: string;
-    metadata?: Metadata$3;
+    metadata?: Metadata$4;
 };
 
 /**
@@ -5010,6 +5291,9 @@ type SepaJobCreated = JobId;
 /**
  * Emporix SEPA Export Service (`/sepa-export/{tenant}/…`): export jobs and file
  * retrieval. Server-side; defaults to the service token.
+ *
+ * @deprecated since 2026-05-25, removal 2026-08-24 — the SEPA Export service is
+ * being sunset by Emporix; all endpoints are no longer maintained.
  */
 declare class SepaExportService {
     private readonly ctx;
@@ -5024,6 +5308,52 @@ declare class SepaExportService {
     createJob(input: SepaJobInput, auth?: AuthContext): Promise<SepaJobCreated>;
 }
 
+/**
+ * Informs about status of reindex job. `PENDING` means that the maximum number of parallel `IN_PROGRESS` jobs is reached and such job will be processed when one of current `IN_PROGRESS` jobs is released. `PUBLISHED` means that all the indexing events were emitted. `SUCCESS` means that all the indexing events were consumed.
+ */
+type ReindexJobStatus$1 = 'FAILURE' | 'IN_PROGRESS' | 'PENDING' | 'PUBLISHED' | 'SUCCESS';
+type Metadata$3 = {
+    /**
+     * Date and time when the object was created. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-30T13:18:02.379Z`
+     */
+    createdAt?: string;
+    /**
+     * Date and time when the object was last modified. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-30T13:18:02.379Z`
+     */
+    modifiedAt?: string;
+};
+/**
+ * Entity type which should be reindexed. For now, it supports only `PRODUCT` and custom schema types.
+ */
+type ReindexEntityType$1 = string;
+type ReindexJob$1 = {
+    /**
+     * Unique identifier of the reindex job.
+     */
+    id?: string;
+    entityType?: ReindexEntityType$1;
+    /**
+     * In case if reindex job finishes with `FAILURE` status, the message is populated with information what was the reason of the failure.
+     */
+    message?: string;
+    status?: ReindexJobStatus$1;
+    /**
+     * Expected number of entities which need to be indexed.
+     */
+    expectedCount?: number;
+    /**
+     * Actual number of entities which were indexed. Allows to track the progress of reindexing process.
+     */
+    processedCount?: number;
+    metadata?: Metadata$3;
+};
+type ReindexRequest = {
+    entityType: ReindexEntityType$1;
+    /**
+     * Whether products should be reindexed for RAG. This property is applicable only when `entityType` is `PRODUCT`.
+     */
+    rag?: boolean;
+};
 type IndexPublicConfiguration = {
     /**
      * API Key used for search purposes.
@@ -5052,9 +5382,16 @@ type IndexConfiguration = IndexPublicConfiguration & {
      */
     writeKey?: string;
     /**
-     * Optional list of root product mixin keys to exclude from indexing. When set, the specified mixin keys are omitted from both the non-localized and localized portions of the indexed document. Applies only to the `BATTERY_INCLUDED` provider; ignored for `ALGOLIA`.
+     * Optional list of root product mixin keys to exclude from indexing. When set, the specified mixin keys are omitted from both the non-localized and localized portions of the indexed document. Applies only to the `BATTERY_INCLUDED` provider.
      */
     excludedMixinKeys?: Array<string>;
+    /**
+     * Optional allowlist of product mixin paths to include in indexing for the `BATTERY_INCLUDED` provider. Patterns are matched against full dot-notation paths rooted at the mixin key, for example `class_EA673_toolsClassification.sk.OnlineIsService_P`.
+     * `*` matches within a single path segment, `**` matches across one or more path segments, and matching is case sensitive.
+     * If a matched path points to an object, the entire subtree under that object is included. When this field is absent or an empty list, path filtering is inactive and existing `excludedMixinKeys` behavior applies.
+     * `includedMixinPaths` and `excludedMixinKeys` are mutually exclusive when `includedMixinPaths` is non-empty. Malformed glob patterns are rejected with a validation error on configuration writes.
+     */
+    includedMixinPaths?: Array<string>;
 };
 type IndexCreationResponse = {
     /**
@@ -5080,9 +5417,28 @@ type IndexConfig = IndexConfiguration;
 type IndexConfigCreated = IndexCreationResponse;
 /** A public indexing configuration. */
 type IndexPublicConfig = IndexPublicConfiguration;
-/** Body for `reindex`. */
+/** A reindex job — tracks the progress of a `FULL` reindex. */
+type ReindexJob = ReindexJob$1;
+/** Body for `createReindexJob`: `{ entityType, rag? }` (`entityType` required). */
+type ReindexJobInput = ReindexRequest;
+/** Entity type to reindex — `"PRODUCT"` or a custom schema type. */
+type ReindexEntityType = ReindexEntityType$1;
+/** Lifecycle status of a {@link ReindexJob}. */
+type ReindexJobStatus = ReindexJobStatus$1;
+/**
+ * Body for the legacy `reindex` endpoint.
+ * @deprecated since 2026-06-18, removal 2026-12-01 — use {@link ReindexJobInput} with
+ * `IndexingService.createReindexJob`.
+ */
 type ReindexInput = Reindex;
 
+/** Options for {@link IndexingService.listReindexJobs}. */
+interface ListReindexJobsOptions {
+    pageNumber?: number;
+    pageSize?: number;
+    /** Raw Emporix `q` filter string. */
+    q?: string;
+}
 /**
  * Emporix Indexing Service (`/indexing/{tenant}/…`): search-index provider
  * configurations and reindex. Server-side; defaults to the service token.
@@ -5106,7 +5462,22 @@ declare class IndexingService {
     listPublicConfigurations(auth?: AuthContext): Promise<IndexPublicConfig[]>;
     /** Get a public configuration by provider name. */
     getPublicConfiguration(provider: string, auth?: AuthContext): Promise<IndexPublicConfig>;
-    /** Trigger a reindex. */
+    /**
+     * Create a reindex job (replaces {@link reindex}). A `FULL` reindex of the
+     * given `entityType`; set `rag: true` to also rebuild the RAG vector index
+     * (PRODUCT only). Resolves to the created job (`201`) or, when a job for that
+     * `entityType` is already `IN_PROGRESS`, that running job (`200`).
+     */
+    createReindexJob(input: ReindexJobInput, auth?: AuthContext): Promise<ReindexJob>;
+    /** List reindex jobs (paginated). */
+    listReindexJobs(opts?: ListReindexJobsOptions, auth?: AuthContext): Promise<PaginatedItems<ReindexJob>>;
+    /** Fetch one reindex job by id. */
+    getReindexJob(reindexJobId: string, auth?: AuthContext): Promise<ReindexJob>;
+    /**
+     * Trigger a reindex.
+     * @deprecated since 2026-06-18, removal 2026-12-01 — use {@link createReindexJob}
+     * (`createReindexJob({ entityType: "PRODUCT" })`), which returns a trackable job.
+     */
     reindex(input: ReindexInput, auth?: AuthContext): Promise<void>;
 }
 
@@ -6250,6 +6621,9 @@ interface RecalculationJobCreated {
  * orders, assignees, packaging, packing events, and recalculation jobs.
  * Server-side; defaults to the service token. Several mutating endpoints return
  * an acknowledgement (`{ message?, code? }`).
+ *
+ * @deprecated since 2026-05-25, removal 2026-08-24 — the Pick-Pack service is
+ * being sunset by Emporix; all endpoints are no longer maintained.
  */
 declare class PickPackService {
     private readonly ctx;
@@ -6824,8 +7198,32 @@ type GetApprovalResponse = BasicApproval & {
     approver?: User;
     status?: ApprovalStatus;
     expiryDate?: ExpiryDate;
+    legalEntity?: LegalEntity;
+    createdResource?: CreatedResource;
     metadata?: Metadata;
 };
+/**
+ * Legal entity (company) the approval belongs to. Set when the approval is created from the customer token.
+ *
+ */
+type LegalEntity = {
+    /**
+     * Identifier of the legal entity.
+     */
+    id: string;
+};
+/**
+ * Resource created when the approval flow completes and the approved action is executed. Present once the downstream system has created the linked entity; omitted until then.
+ *
+ * For checkout approvals (`action: CHECKOUT`), `id` is typically the order identifier (for example, from Order Service).
+ *
+ */
+type CreatedResource = {
+    /**
+     * Identifier of the created resource (for checkout approvals, typically an order ID).
+     */
+    id: string;
+};
 /**
  * Base schema for approval permitted response.
  */
@@ -7060,6 +7458,12 @@ type SearchUsersRequest = {
  * `approval-service` types (single source of truth; faithful required/optional flags).
  *
  * Every endpoint is CustomerAccessToken-only (B2B cart/quote approval workflows).
+ *
+ * Deprecated upstream (since 2026-05-26, removal 2026-11-30) — these fields carry
+ * `@deprecated` in the generated types; prefer the replacements:
+ * - `totalPrice.amount` / `subTotalPrice.amount` → `netValue` / `grossValue` / `taxValue`
+ * - `itemYrn` → `itemId`
+ * - `itemPrice.amount` → `calculatedPrice` and `unitPrice`
  */
 
 /** An approval document (read shape). */
@@ -7261,4 +7665,4 @@ declare function createEmporixClient<S extends Record<string, ServiceClass<unkno
  */
 declare function productIdFromYrn(yrn: string | undefined): string;
 
-export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerInput, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type Agent, type AgentInput, type AgentPatchOp, type AgentSearchQuery, AiService, type Approval, type ApprovalCreated, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Assignee, AuthContext, AvailabilityService, type BatchNextIdEntry, type Brand, type BrandInput, type BrandList, BrandService, type BrandUpdate, CartService, type Catalog, type CatalogCreated, type CatalogInput, type CatalogList, type CatalogPatch, CatalogService, type CatalogUpdate, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type ConversionFactorInput, type ConversionFactorResult, type ConvertUnitInput, type ConvertUnitResult, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime$1 as DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$2 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListSchemasQuery, LocationsService, LogLevel, MediaService, type MetadataFilter, type MinimumFee, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, type PointsSummary, PriceService, ProductService, QueryFor, type QuoteInput, type QuoteResult, type QuoteSlotInput, RagIndexerService, type RagType, type RecalculationJob, type RecalculationJobCreated, type RecalculationJobInput, type RedeemCouponResult, type RedeemMyPointsInput, type RedeemOption, type RedeemOptionList, type RedeemedPoints, type Redemption, type RedemptionCreated, type RedemptionInput, type ReferralCoupon, type Region, type RegionList, type ReindexInput, ResolvedConfig, type ResourceCreated, type Return, type ReturnCreated, type ReturnInput, type ReturnList, type ReturnPatch, type ReturnUpdate, ReturnsService, RewardPointsService, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, SchemaService, type SchemaTypeName, type SchemaUpdate, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServiceClass, ServiceName, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteList, SiteService, type TaxCalculationInput, type TaxCalculationRequest, type TaxCalculationResult, type TaxClass, type TaxConfig, type TaxConfigCreated, type TaxCreation as TaxConfigInput, type TaxUpdate as TaxConfigUpdate, type TaxLocation, TaxService, TenantConfigService, type TextRequest, type TextResponse, TokenProvider, type Unit, type UnitCreated, UnitHandlingService, type UnitInput, type UnitUpdate, type Vendor, type VendorCreated, type VendorInput, type VendorList, type VendorLocation, type VendorLocationInput, type VendorLocationList, type VendorLocationUpdate, type VendorSearchQuery, VendorService, type VendorUpdate, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, type Zone, type ZoneList, createCore, createEmporixClient, errorFromResponse, productIdFromYrn };
+export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerInput, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type Agent, type AgentInput, type AgentPatchOp, type AgentSearchQuery, AiService, type Approval, type ApprovalCreated, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Assignee, AuthContext, AvailabilityService, type BatchNextIdEntry, type Brand, type BrandInput, type BrandList, BrandService, type BrandUpdate, type BulkInstanceResult, type BulkPatchInstanceItem, CartService, type Catalog, type CatalogCreated, type CatalogInput, type CatalogList, type CatalogPatch, CatalogService, type CatalogUpdate, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, type ChatStreamOptions, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type Conversation, type ConversationSearchQuery, type ConversionFactorInput, type ConversionFactorResult, type ConvertUnitInput, type ConvertUnitResult, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime$1 as DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$2 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListReindexJobsOptions, type ListSchemasQuery, LocationsService, LogLevel, MediaService, type MetadataFilter, type MinimumFee, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, type PointsSummary, PriceService, ProductService, QueryFor, type QuoteInput, type QuoteResult, type QuoteSlotInput, RagIndexerService, type RagType, type RecalculationJob, type RecalculationJobCreated, type RecalculationJobInput, type RedeemCouponResult, type RedeemMyPointsInput, type RedeemOption, type RedeemOptionList, type RedeemedPoints, type Redemption, type RedemptionCreated, type RedemptionInput, type ReferralCoupon, type Region, type RegionList, type ReindexEntityType, type ReindexInput, type ReindexJob, type ReindexJobInput, type ReindexJobStatus, ResolvedConfig, type ResourceCreated, type Return, type ReturnCreated, type ReturnInput, type ReturnList, type ReturnPatch, type ReturnUpdate, ReturnsService, RewardPointsService, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, SchemaService, type SchemaTypeName, type SchemaUpdate, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServiceClass, ServiceName, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteList, SiteService, type TaxCalculationInput, type TaxCalculationRequest, type TaxCalculationResult, type TaxClass, type TaxConfig, type TaxConfigCreated, type TaxCreation as TaxConfigInput, type TaxUpdate as TaxConfigUpdate, type TaxLocation, TaxService, TenantConfigService, type TextRequest, type TextResponse, TokenProvider, type Unit, type UnitCreated, UnitHandlingService, type UnitInput, type UnitUpdate, type Vendor, type VendorCreated, type VendorInput, type VendorList, type VendorLocation, type VendorLocationInput, type VendorLocationList, type VendorLocationUpdate, type VendorSearchQuery, VendorService, type VendorUpdate, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, type Zone, type ZoneList, createCore, createEmporixClient, errorFromResponse, productIdFromYrn };