@viu/emporix-sdk 4.0.1 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/README.md +1 -0
  3. package/dist/cart.cjs +85 -0
  4. package/dist/cart.cjs.map +1 -1
  5. package/dist/cart.d.cts +352 -1
  6. package/dist/cart.d.ts +352 -1
  7. package/dist/cart.js +1 -1
  8. package/dist/{chunk-QQMLN76U.js → chunk-2OTFVTG6.js} +7 -4
  9. package/dist/chunk-2OTFVTG6.js.map +1 -0
  10. package/dist/{chunk-CSYXGTOH.js → chunk-5MPL4XBD.js} +68 -4
  11. package/dist/chunk-5MPL4XBD.js.map +1 -0
  12. package/dist/{chunk-P3RANRGB.js → chunk-IYNT5BQW.js} +16 -2
  13. package/dist/chunk-IYNT5BQW.js.map +1 -0
  14. package/dist/{chunk-ZOFGDNSX.js → chunk-K4KXT6NX.js} +12 -6
  15. package/dist/chunk-K4KXT6NX.js.map +1 -0
  16. package/dist/{chunk-XJJDCK2Z.js → chunk-N2CE3J4M.js} +12 -7
  17. package/dist/chunk-N2CE3J4M.js.map +1 -0
  18. package/dist/{chunk-YVZ6GOLE.js → chunk-S2ERKGYL.js} +48 -3
  19. package/dist/chunk-S2ERKGYL.js.map +1 -0
  20. package/dist/{chunk-5XZ6MSXW.js → chunk-VXORPTMP.js} +19 -2
  21. package/dist/chunk-VXORPTMP.js.map +1 -0
  22. package/dist/chunk-ZWJUDXTK.js +15 -0
  23. package/dist/chunk-ZWJUDXTK.js.map +1 -0
  24. package/dist/companies.cjs +15 -2
  25. package/dist/companies.cjs.map +1 -1
  26. package/dist/companies.d.cts +5 -3
  27. package/dist/companies.d.ts +5 -3
  28. package/dist/companies.js +2 -1
  29. package/dist/customer-groups.cjs +17 -0
  30. package/dist/customer-groups.cjs.map +1 -1
  31. package/dist/customer-groups.js +1 -1
  32. package/dist/index.cjs +259 -58
  33. package/dist/index.cjs.map +1 -1
  34. package/dist/index.d.cts +150 -28
  35. package/dist/index.d.ts +150 -28
  36. package/dist/index.js +99 -59
  37. package/dist/index.js.map +1 -1
  38. package/dist/media.cjs +66 -2
  39. package/dist/media.cjs.map +1 -1
  40. package/dist/media.d.cts +184 -5
  41. package/dist/media.d.ts +184 -5
  42. package/dist/media.js +1 -1
  43. package/dist/orders.cjs +14 -0
  44. package/dist/orders.cjs.map +1 -1
  45. package/dist/orders.d.cts +6 -0
  46. package/dist/orders.d.ts +6 -0
  47. package/dist/orders.js +1 -1
  48. package/dist/price.cjs +20 -4
  49. package/dist/price.cjs.map +1 -1
  50. package/dist/price.d.cts +12 -4
  51. package/dist/price.d.ts +12 -4
  52. package/dist/price.js +2 -1
  53. package/dist/search-DU6tE356.d.cts +15 -0
  54. package/dist/search-DU6tE356.d.ts +15 -0
  55. package/dist/segment.cjs +21 -5
  56. package/dist/segment.cjs.map +1 -1
  57. package/dist/segment.d.cts +16 -6
  58. package/dist/segment.d.ts +16 -6
  59. package/dist/segment.js +2 -1
  60. package/package.json +1 -1
  61. package/dist/chunk-5XZ6MSXW.js.map +0 -1
  62. package/dist/chunk-CSYXGTOH.js.map +0 -1
  63. package/dist/chunk-P3RANRGB.js.map +0 -1
  64. package/dist/chunk-QQMLN76U.js.map +0 -1
  65. package/dist/chunk-XJJDCK2Z.js.map +0 -1
  66. package/dist/chunk-YVZ6GOLE.js.map +0 -1
  67. package/dist/chunk-ZOFGDNSX.js.map +0 -1
package/dist/index.d.cts CHANGED
@@ -1,5 +1,6 @@
1
1
  import { q as StoredAnonymousSession, b as AuthContext, C as ClientContext, P as PaginatedItems, T as TokenProvider, o as ResolvedConfig, E as EmporixConfig, k as LogLevel, p as ServiceName, e as CustomerTokenRefresher } from './context-5lt8Q0MT.cjs';
2
2
  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, h as HttpResult, L as LEVEL, i as LevelResolver, j as LogFields, l as Logger, m as LoggerConfig, n as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, r as StorefrontCredentials, s as auth, t as createConsoleLogger, u as createNoopLogger, v as iterateAll, w as redact, x as resolveToken, y as validateConfig } from './context-5lt8Q0MT.cjs';
3
+ import { S as SearchPaging } from './search-DU6tE356.cjs';
3
4
  import { CustomerService } from './customer.cjs';
4
5
  export { Address, AddressCreateInput, AddressUpdateInput, ChangeEmailInput, ConfirmEmailChangeInput, Customer, CustomerSession, CustomerSignupInput, CustomerUpdateInput, PasswordChangeInput, PasswordResetConfirmInput, PasswordResetRequestInput, ResendActivationInput } from './customer.cjs';
5
6
  import { ProductService } from './product.cjs';
@@ -7,7 +8,7 @@ export { Media, Product, ProductBulkCreateInput, ProductBulkResult, ProductBulkU
7
8
  import { CategoryService } from './category.cjs';
8
9
  export { Category, CategoryAssignment, CategoryAssignmentBulkInput, CategoryAssignmentBulkResult, CategoryAssignmentCreated, CategoryAssignmentInput, CategoryAssignmentRefBulkInput, CategoryCreateInput, CategoryCreated, CategoryNode, CategoryPatchInput, CategoryTreeSearchInput, CategoryUpdateInput } from './category.cjs';
9
10
  import { CartService } from './cart.cjs';
10
- export { Cart, CartAddress, CartCreated, CartDeliveryRestrictions, CartDiscount, CartItem, CartItemInput, CartItemUpdate, CartItemsBatchUpdateInput, CartItemsBatchUpdateResult, CartSearchInput, CartSummary, CartUpdateInput, CartValidationResult, CreateCartInput } from './cart.cjs';
11
+ export { Cart, CartAddress, CartCommand, CartCommandBodies, CartCommandResult, CartCreated, CartDeliveryRestrictions, CartDiscount, CartDiscountInput, CartExecuteOptions, CartExecuteResult, CartItem, CartItemInput, CartItemUpdate, CartItemsBatchUpdateInput, CartItemsBatchUpdateResult, CartSearchInput, CartSummary, CartUpdateInput, CartValidationResult, CreateCartInput } from './cart.cjs';
11
12
  import { CheckoutService } from './checkout.cjs';
12
13
  export { CheckoutInput, CheckoutOptions, CheckoutResult, QuoteCheckoutInput } from './checkout.cjs';
13
14
  import { PaymentGatewayService } from './payment.cjs';
@@ -15,7 +16,7 @@ export { AuthorizePaymentInput, AuthorizePaymentResult, InitializePaymentInput,
15
16
  import { PriceService } from './price.cjs';
16
17
  export { MatchByContextChunkedOptions, Price, PriceBulkResult, PriceCreateInput, PriceList, PriceListInput, PriceListPrice, PriceListPriceInput, PriceListPriceUpdateInput, PriceListUpdateInput, PriceMatch, PriceMatchByContextInput, PriceMatchInput, PriceMatchItemRef, PriceModel, PriceModelInput } from './price.cjs';
17
18
  import { MediaService } from './media.cjs';
18
- export { Asset, AssetCreateBlobInput, AssetCreateLinkInput, AssetRefId, AssetUpdateBlobInput, AssetUpdateInput, AssetUpdateLinkInput, DownloadResult, ListAssetsQuery } from './media.cjs';
19
+ export { Asset, AssetCreateBlobInput, AssetCreateLinkInput, AssetDownloadUrl, AssetDownloadUrlQuery, AssetPatch, AssetRefId, AssetUpdateBlobInput, AssetUpdateInput, AssetUpdateLinkInput, AssetUploadSession, AssetUploadSessionInput, DownloadResult, ListAssetsQuery } from './media.cjs';
19
20
  import { SegmentService } from './segment.cjs';
20
21
  export { Segment, SegmentAssignmentBulkResult, SegmentBulkItem, SegmentBulkResult, SegmentCategoryTree, SegmentCategoryTreeNode, SegmentCustomer, SegmentCustomerBulkInput, SegmentCustomerInput, SegmentInput, SegmentItem, SegmentItemBulkInput, SegmentItemInput, SegmentMatchInput, SegmentPatchInput, SegmentSearchQuery, SegmentServiceDeps, SegmentUpdateInput } from './segment.cjs';
21
22
  import { CompaniesService } from './companies.cjs';
@@ -482,13 +483,13 @@ type SiteDto = {
482
483
  */
483
484
  includesTax?: boolean;
484
485
  /**
485
- * Site's default language, compliant with the ISO 639-1 standard.
486
+ * Site's default language, compliant with the IETF BCP-47 standard. Regional variants such as `fr-ca` are supported.
486
487
  */
487
488
  defaultLanguage: string;
488
489
  /**
489
490
  * Languages supported by the site.
490
491
  *
491
- * **Note**: The languages must be compliant with the ISO 639-1 standard.
492
+ * **Note**: The languages must be compliant with the IETF BCP-47 standard. Regional variants such as `fr-ca` are supported.
492
493
  */
493
494
  languages: Array<string>;
494
495
  currency: CurrencyDto;
@@ -908,7 +909,14 @@ declare class IamService {
908
909
  getMe: (auth: AuthContext) => Promise<IamUserDetail>;
909
910
  update: (userId: string, input: IamUserUpdate, auth: AuthContext) => Promise<void>;
910
911
  delete: (userId: string, auth: AuthContext) => Promise<void>;
912
+ /**
913
+ * Lists one vendor's Management Dashboard users, with their groups
914
+ * (`GET /users/vendors/{vendorId}`).
915
+ */
916
+ listForVendor: (vendorId: string, auth: AuthContext) => Promise<IamUser[]>;
911
917
  getGroups: (userId: string, auth: AuthContext) => Promise<IamGroup[]>;
918
+ /** Removes a user from every group at once (`DELETE /users/{userId}/groups`, `204`). */
919
+ removeFromAllGroups: (userId: string, auth: AuthContext) => Promise<void>;
912
920
  /**
913
921
  * Reads one of a user's groups (`GET /users/{userId}/groups/{groupId}`).
914
922
  * The collection read above returns the same shape per entry; this exists
@@ -1116,10 +1124,21 @@ declare class ShoppingListService {
1116
1124
  static readonly channel: "shopping-list";
1117
1125
  constructor(ctx: ClientContext);
1118
1126
  private base;
1119
- /** The caller's lists (or, with employee scope, all), normalized to an array. */
1127
+ /**
1128
+ * The caller's lists, normalized to an array. With employee scope Emporix
1129
+ * returns **every customer's** lists and ignores `name` — read one customer's
1130
+ * with {@link getForCustomer} instead.
1131
+ */
1120
1132
  list(auth: AuthContext, opts?: {
1121
1133
  name?: string;
1122
1134
  }): Promise<ShoppingList[]>;
1135
+ /**
1136
+ * One customer's lists (`GET /shopping-lists/{customerId}`), normalized to an
1137
+ * array — the employee read; `name` narrows it to one list.
1138
+ */
1139
+ getForCustomer(customerId: string, auth: AuthContext, opts?: {
1140
+ name?: string;
1141
+ }): Promise<ShoppingList[]>;
1123
1142
  /** Create a list; returns the new list id. */
1124
1143
  create(draft: ShoppingListDraft, auth: AuthContext): Promise<{
1125
1144
  id: string;
@@ -1544,15 +1563,18 @@ interface ItemFeeSearchByProductId {
1544
1563
  pageSize?: number;
1545
1564
  }
1546
1565
  /**
1547
- * Body of `POST /itemFees/searchByProductIds` — several products, one site.
1566
+ * Input for `POST /itemFees/searchByProductIds` — several products, one site.
1548
1567
  * `productIds` is a **single string** (comma-separated), not an array — see the
1549
- * note on {@link ItemFeeSearchByProductId}.
1568
+ * note on {@link ItemFeeSearchByProductId}. Unlike most searches, this one takes
1569
+ * its paging in the body.
1550
1570
  */
1551
1571
  interface ItemFeeSearchByProductIds {
1552
1572
  productIds: string;
1553
1573
  siteCode: string;
1554
1574
  pageNumber?: number;
1555
1575
  pageSize?: number;
1576
+ /** Sent as the `siteFallback` query parameter, not in the body. */
1577
+ siteFallback?: boolean;
1556
1578
  }
1557
1579
  /**
1558
1580
  * Query for the paginated `GET /fees` list. Explicit fields are typed for
@@ -1655,6 +1677,7 @@ declare class FeeService {
1655
1677
  * Finds item fees for several products on one site
1656
1678
  * (`POST /itemFees/searchByProductIds`). Note the upstream asymmetry:
1657
1679
  * `productIds` is a comma-separated **string** and `siteCode` is singular.
1680
+ * `siteFallback` goes in the query string, everything else in the body.
1658
1681
  */
1659
1682
  searchItemFeesByProductIds(search: ItemFeeSearchByProductIds, auth?: AuthContext): Promise<ItemFee[]>;
1660
1683
  }
@@ -3858,7 +3881,12 @@ type AgentRequest = BaseForAgentRequestAndResponse & {
3858
3881
  nativeTools?: Array<NativeToolReferenceRequest>;
3859
3882
  llmConfig: EmporixLlm | ApiKeyLlmRequest | SelfHostedLlmRequest;
3860
3883
  mcpServers: AgentMcpServersRequest;
3861
- metadata?: MetadataRequest;
3884
+ metadata?: MetadataRequest & {
3885
+ /**
3886
+ * Optional note stored on this version. A blank value clears the live note. The next successful update archives the note with this version.
3887
+ */
3888
+ changeNote?: string;
3889
+ };
3862
3890
  };
3863
3891
  type AgentResponse = BaseForAgentRequestAndResponse & {
3864
3892
  /**
@@ -3877,7 +3905,58 @@ type AgentResponse = BaseForAgentRequestAndResponse & {
3877
3905
  * Prompt which is inherited from the template (if agent is created based on the template). The prompt provided by the user is then concatenated with this prompt.
3878
3906
  */
3879
3907
  templatePrompt?: string;
3880
- metadata?: MetadataResponse$1;
3908
+ metadata?: AgentMetadataResponse;
3909
+ /**
3910
+ * Stored history of previous agent configurations. Present only when the request sets `allVersions=true`. Omitted otherwise.
3911
+ */
3912
+ versions?: Array<AgentVersion>;
3913
+ };
3914
+ type AgentVersion = BaseForAgentRequestAndResponse & {
3915
+ /**
3916
+ * Prompt inherited from the template at the time of this version.
3917
+ */
3918
+ templatePrompt?: string;
3919
+ nativeTools?: NativeToolsResponse;
3920
+ llmConfig?: EmporixLlm | ApiKeyLlmResponse | SelfHostedLlmResponse;
3921
+ mcpServers?: AgentMcpServersResponse;
3922
+ metadata: AgentVersionMetadata;
3923
+ };
3924
+ type AgentVersionMetadata = {
3925
+ /**
3926
+ * Version number of this archived snapshot.
3927
+ */
3928
+ version: number;
3929
+ /**
3930
+ * Date and time when this version was stored. The value is an ISO-8601 instant. For example: `2022-04-30T13:18:02.379Z`
3931
+ */
3932
+ modifiedAt?: string;
3933
+ modifiedBy?: ModifiedBy;
3934
+ /**
3935
+ * Note stored with this snapshot.
3936
+ */
3937
+ changeNote?: string;
3938
+ };
3939
+ /**
3940
+ * Who last changed the agent.
3941
+ */
3942
+ type ModifiedBy = {
3943
+ /**
3944
+ * Identity recorded for the change. `EXTERNAL` is assigned when the request authenticates with an API token. `SYSTEM` is used for automatic updates.
3945
+ *
3946
+ */
3947
+ type: 'CUSTOMER' | 'EMPLOYEE' | 'EXTERNAL' | 'SYSTEM';
3948
+ /**
3949
+ * Identifier of the customer or employee. Omitted for `EXTERNAL` and `SYSTEM`. `id` is the `Hybris-User-Id` header value when `CUSTOMER` or `EMPLOYEE`.
3950
+ */
3951
+ id?: string;
3952
+ /**
3953
+ * First name of the customer or employee.
3954
+ */
3955
+ firstName?: string;
3956
+ /**
3957
+ * Last name of the customer or employee.
3958
+ */
3959
+ lastName?: string;
3881
3960
  };
3882
3961
  type MetadataRequest = {
3883
3962
  /**
@@ -3887,14 +3966,21 @@ type MetadataRequest = {
3887
3966
  };
3888
3967
  type MetadataResponse$1 = MetadataRequest & {
3889
3968
  /**
3890
- * Date and time when the object was created. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-31T13:18:02.379Z`
3969
+ * 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`
3891
3970
  */
3892
3971
  createdAt: string;
3893
3972
  /**
3894
- * 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-31T13:18:02.379Z`
3973
+ * 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`
3895
3974
  */
3896
3975
  modifiedAt: string;
3897
3976
  };
3977
+ type AgentMetadataResponse = MetadataResponse$1 & {
3978
+ modifiedBy?: ModifiedBy;
3979
+ /**
3980
+ * Note stored for this live version.
3981
+ */
3982
+ changeNote?: string;
3983
+ };
3898
3984
  /**
3899
3985
  * Status of the job.
3900
3986
  */
@@ -4022,6 +4108,10 @@ type AgentLogMessageResponse = {
4022
4108
  * Unique identifier of the agent that generated the log.
4023
4109
  */
4024
4110
  agentId?: string;
4111
+ /**
4112
+ * Version of the agent that wrote this log message.
4113
+ */
4114
+ agentVersion?: number;
4025
4115
  /**
4026
4116
  * Unique identifier of the request associated with the log.
4027
4117
  */
@@ -4069,6 +4159,10 @@ type AgentRequestResponse = {
4069
4159
  * Cumulative LLM completion token count for this request.
4070
4160
  */
4071
4161
  completionTokens?: number;
4162
+ /**
4163
+ * Version of the agent which triggered the request.
4164
+ */
4165
+ agentVersion?: number;
4072
4166
  metadata?: MetadataResponse$1;
4073
4167
  };
4074
4168
  type AgentSessionResponse = {
@@ -4322,8 +4416,8 @@ type AgentInput = AgentRequest;
4322
4416
  * (`ADD | REMOVE | REPLACE`) — NOT RFC-6902 lowercase. Passed verbatim.
4323
4417
  */
4324
4418
  type AgentPatchOp = PatchRequest[number];
4325
- /** Request body for `POST /agentic/agents/search` (`{ q? }`). */
4326
- type AgentSearchQuery = QParamSearchBody;
4419
+ /** Input for `POST /agentic/agents/search`: the body (`{ q? }`) plus {@link SearchPaging}. */
4420
+ type AgentSearchQuery = QParamSearchBody & SearchPaging;
4327
4421
  /** Request body for `chat` / `chatAsync` — `{ agentId, message }`. */
4328
4422
  type ChatRequest = AgenticRequest;
4329
4423
  /**
@@ -4360,8 +4454,8 @@ interface ChatOptions {
4360
4454
  type ChatStreamOptions = ChatOptions;
4361
4455
  /** A stored agentic conversation (Teams-backed). */
4362
4456
  type Conversation = ConversationResponse;
4363
- /** Request body for `searchConversations` (`{ q? }`) — same shape as agent search. */
4364
- type ConversationSearchQuery = QParamSearchBody2;
4457
+ /** Input for `searchConversations` — same shape as {@link AgentSearchQuery}. */
4458
+ type ConversationSearchQuery = QParamSearchBody2 & SearchPaging;
4365
4459
  /** `{ id? }` — returned by an upsert on create (HTTP 201). */
4366
4460
  type Created = IdResponse;
4367
4461
  /**
@@ -4391,8 +4485,8 @@ interface MutateOptions {
4391
4485
  /** Cascade even if the entity is referenced elsewhere (`?force=true`). */
4392
4486
  force?: boolean;
4393
4487
  }
4394
- /** Body for any agentic `/search` endpoint. */
4395
- interface SearchQuery {
4488
+ /** Input for any agentic `/search` endpoint: `q` goes in the body, {@link SearchPaging} in the query string. */
4489
+ interface SearchQuery extends SearchPaging {
4396
4490
  q?: string;
4397
4491
  }
4398
4492
  /** An OAuth 2.0 client-credentials configuration (read shape). */
@@ -4480,7 +4574,7 @@ declare class AgenticCrudResource<Read, Write> {
4480
4574
  private item;
4481
4575
  /** List the collection (`GET {path}`). Optional `q`/paging/sort/fields/expand. */
4482
4576
  list(query?: ListQuery, auth?: AuthContext): Promise<Read[]>;
4483
- /** Structured search (`POST {path}/search`). Body is `{ q? }`. */
4577
+ /** Structured search (`POST {path}/search`): `q` in the body, paging/sort/fields in the query. */
4484
4578
  search(query: SearchQuery, auth?: AuthContext): Promise<Read[]>;
4485
4579
  /** Retrieve one entry by id (`GET {path}/{id}`). */
4486
4580
  get(id: string, opts?: GetOptions, auth?: AuthContext): Promise<Read>;
@@ -4605,8 +4699,13 @@ declare class AiService {
4605
4699
  generateText(input: TextRequest, auth?: AuthContext): Promise<TextResponse>;
4606
4700
  /** Run a chat completion over a message list (`POST /completions`). No `maxTokens`. */
4607
4701
  complete(input: CompletionRequest, auth?: AuthContext): Promise<CompletionResponse>;
4608
- /** List all agentic agents. */
4702
+ /**
4703
+ * List agents (`GET /agentic/agents`). `q`, `pageNumber`, `pageSize`, `sort`,
4704
+ * `fields` and `expand` go in the query string; without paging keys the
4705
+ * server returns its first page. The original `listAgents(auth)` still works.
4706
+ */
4609
4707
  listAgents(auth?: AuthContext): Promise<Agent[]>;
4708
+ listAgents(query: ListQuery, auth?: AuthContext): Promise<Agent[]>;
4610
4709
  /** Retrieve one agent by id. */
4611
4710
  getAgent(id: string, auth?: AuthContext): Promise<Agent>;
4612
4711
  /** Create-or-replace an agent by id (`PUT`). Takes the agent write shape. */
@@ -4622,7 +4721,10 @@ declare class AiService {
4622
4721
  * still referenced elsewhere (`?force=true`).
4623
4722
  */
4624
4723
  deleteAgent(id: string, auth?: AuthContext, opts?: DeleteAgentOptions): Promise<void>;
4625
- /** Server-side agent search (`POST /agentic/agents/search`). */
4724
+ /**
4725
+ * Server-side agent search (`POST /agentic/agents/search`). `q` goes in the
4726
+ * body; `pageNumber`, `pageSize`, `sort` and `fields` in the query string.
4727
+ */
4626
4728
  searchAgents(query: AgentSearchQuery, auth?: AuthContext): Promise<Agent[]>;
4627
4729
  /**
4628
4730
  * Synchronous agent chat (`POST /agentic/chat`). Returns the response
@@ -4646,9 +4748,13 @@ declare class AiService {
4646
4748
  * objects. Consume with `for await`. `opts` as for {@link chat}.
4647
4749
  */
4648
4750
  chatStream(input: ChatRequest, opts?: ChatOptions, auth?: AuthContext): AsyncIterable<string>;
4649
- /** List stored agentic conversations (`GET /agentic/conversations`). */
4751
+ /**
4752
+ * List stored agentic conversations (`GET /agentic/conversations`), paged
4753
+ * like {@link listAgents}. The original `listConversations(auth)` still works.
4754
+ */
4650
4755
  listConversations(auth?: AuthContext): Promise<Conversation[]>;
4651
- /** Server-side conversation search (`POST /agentic/conversations/search`). */
4756
+ listConversations(query: ListQuery, auth?: AuthContext): Promise<Conversation[]>;
4757
+ /** Server-side conversation search (`POST /agentic/conversations/search`), paged like {@link searchAgents}. */
4652
4758
  searchConversations(query: ConversationSearchQuery, auth?: AuthContext): Promise<Conversation[]>;
4653
4759
  /** List models available to the tenant, grouped by provider (`GET /agentic/models`). */
4654
4760
  listModels(auth?: AuthContext): Promise<ProviderModels[]>;
@@ -11401,8 +11507,11 @@ type VendorInput = VendorCreate;
11401
11507
  type VendorUpdate = VendorUpdate$1;
11402
11508
  /** Create response — a resource id. */
11403
11509
  type VendorCreated = ResourceId;
11404
- /** Search body (`POST /vendors/search`). `q` accepts a raw DSL string or a built filter. */
11405
- type VendorSearchQuery = Record<string, unknown> & {
11510
+ /**
11511
+ * Input for `POST /vendors/search`. `q` — a raw DSL string or a built filter —
11512
+ * goes in the body; {@link SearchPaging} in the query string.
11513
+ */
11514
+ type VendorSearchQuery = Record<string, unknown> & SearchPaging & {
11406
11515
  q?: QueryFor<"VENDOR">;
11407
11516
  };
11408
11517
  /** A vendor location (read shape). */
@@ -11429,7 +11538,10 @@ declare class VendorService {
11429
11538
  listVendors(query?: Record<string, string | number>, auth?: AuthContext): Promise<VendorList>;
11430
11539
  /** Retrieve a vendor by id. */
11431
11540
  getVendor(vendorId: string, auth?: AuthContext): Promise<Vendor>;
11432
- /** Search vendors (`POST /vendors/search`). A built filter in `q` is resolved to a string. */
11541
+ /**
11542
+ * Search vendors (`POST /vendors/search`). A built filter in `q` is resolved to
11543
+ * a string; paging, sort and fields go in the query string.
11544
+ */
11433
11545
  searchVendors(query: VendorSearchQuery, auth?: AuthContext): Promise<VendorList>;
11434
11546
  /** Create a vendor. */
11435
11547
  createVendor(input: VendorInput, auth?: AuthContext): Promise<VendorCreated>;
@@ -11876,9 +11988,16 @@ type AdminCustomerUpdate = CustomerUpdateBySellerDto;
11876
11988
  type AdminCustomerPatch = CustomerPatchBySellerDto;
11877
11989
  /** Create/upsert response — a resource location. */
11878
11990
  type AdminCustomerCreated = ResourceLocation;
11879
- /** Search body (`POST /customers/search`). `q` accepts a raw DSL string or a built filter. */
11991
+ /**
11992
+ * Input for `POST /customers/search`. `q` — a raw DSL string or a built filter —
11993
+ * goes in the body; `pageNumber`, `pageSize`, `sort` and `expand` in the query string.
11994
+ */
11880
11995
  type AdminCustomerSearchQuery = Record<string, unknown> & {
11881
11996
  q?: QueryFor<"CUSTOMER">;
11997
+ pageNumber?: number;
11998
+ pageSize?: number;
11999
+ sort?: string;
12000
+ expand?: string;
11882
12001
  };
11883
12002
  /** A customer address (read). */
11884
12003
  type AdminCustomerAddress = Address$1;
@@ -11933,7 +12052,10 @@ declare class CustomerAdminService {
11933
12052
  private addressPath;
11934
12053
  /** List customers. */
11935
12054
  listCustomers(query?: Record<string, string | number>, auth?: AuthContext): Promise<AdminCustomerList>;
11936
- /** Search customers (`POST /customers/search`). A built filter in `q` is resolved to a string. */
12055
+ /**
12056
+ * Search customers (`POST /customers/search`). A built filter in `q` is resolved
12057
+ * to a string; `pageNumber`, `pageSize`, `sort` and `expand` go in the query string.
12058
+ */
11937
12059
  searchCustomers(query: AdminCustomerSearchQuery, auth?: AuthContext): Promise<AdminCustomerList>;
11938
12060
  /** Retrieve a customer profile by number. */
11939
12061
  getCustomer(customerNumber: string, auth?: AuthContext): Promise<AdminCustomer>;
@@ -12741,4 +12863,4 @@ declare function productIdFromYrn(yrn: string | undefined): string;
12741
12863
  */
12742
12864
  declare function productYrn(tenant: string, productId: string): string;
12743
12865
 
12744
- export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerImport, type AdminCustomerImportAccount, type AdminCustomerImportResult, type AdminCustomerInput, type AdminCustomerLegacyAuth, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type AdminPasswordMigrationRetention, type AdminPasswordMigrationRetentionInput, type Agent, type AgentAnalytics, type AgentExecutions, type AgentFromTemplate, type AgentInput, type AgentPatchOp, type AgentRequestLog, type AgentSearchQuery, type AgentSessionLog, type AgentTemplate, type AgenticPatchOp, type AgentsExport, type AgentsExportRequest, type AgentsImport, type AgentsImportRequest, AiService, type AnalyticsQuery, type Approval, type ApprovalCreated, type ApprovalDecision, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Attachment, type AttachmentOptions, type AttachmentReuseOptions, type AuditLogChangeType, type AuditLogEntry, type AuditLogPage, type AuditLogPathChange, type AuditLogQuery, type AuditLogRelatedEntity, AuditLogService, 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 ChatOptions, type ChatRequest, type ChatResponse, type ChatStreamOptions, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, type CommerceEvents, 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 CookieIo, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Created, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSessionState, type CustomerSessionStore, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$1 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, type EmporixStorage, type EmporixStorageKey, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type ExecutionsQuery, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type GetOptions, type IamAccessControl, type IamAccessControlCreated, type IamAccessControlUpsert, type IamGroup, type IamGroupCreate, type IamGroupCreated, AssignmentCreateRequest as IamGroupMemberAssignment, type IamGroupMemberCreated, type IamGroupMemberInput, type IamGroupUpdate, type IamScope, type IamScopeCreated, type IamScopeUpsert, IamService, type IamUser, type IamUserCreate, type IamUserCreated, type IamUserDetail, type IamUserScopes, type IamUserUpdate, type ImportCancelResult, type ImportConfig, type ImportDiagnosticKind, type ImportDiagnosticRecord, type ImportErrorRecord, type ImportPage, type ImportPageOptions, type ImportRecordOutcome, type ImportRun, type ImportRunDetail, type ImportRunDiagnostics, type ImportRunDiagnosticsQuery, type ImportRunEvent, type ImportRunInput, type ImportRunMode, type ImportRunStatus, type ImportRunStream, type ImportSchedule, ImportService, type ImportStream, type ImportStreamOrder, type ImportedRecord, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvoiceJob, type InvoiceJobCreated, type InvoiceJobDraft, InvoiceService, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type ItemFeeSearchByProductId, type ItemFeeSearchByProductIds, type Job, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListQuery, type ListQuoteReasonsQuery, type ListQuotesQuery, type ListReindexJobsOptions, type ListSchemaReferencesQuery, type ListSchemasQuery, LocationsService, LogLevel, type McpServer, type McpServerInput, MediaService, type MetadataFilter, type MinimumFee, type MutateOptions, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OAuthConfig, type OAuthInput, OrdersService, PaginatedItems, PaymentGatewayService, type PersistedAnonymousSession, type PointsSummary, PriceService, ProductService, type ProviderModels, QueryFor, type Quote, type QuoteCreated, type QuoteDraft, type QuoteHistory, type QuoteInput, type QuoteReason, type QuoteReasonCreated, type QuoteReasonDraft, type QuoteReasonUpdate, type QuoteResult, QuoteService, type QuoteSlotInput, type QuoteUpdate, RagIndexerService, type RagType, 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, STORAGE_KEYS, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, type SchemaExport, type SchemaImportInput, type SchemaInstanceBulkCreateItem, type SchemaInstanceBulkUpsertItem, type SchemaReference, type SchemaReferenceCreated, type SchemaReferenceInput, type SchemaReferenceUpdateInput, SchemaService, type SchemaTypeName, type SchemaUpdate, type SearchImportedRecordsOptions, type SearchInstancesQuery, type SearchQuery, type SearchStreamRecordsOptions, SegmentService, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServerCookieJar, type ServiceClass, ServiceName, type SessionAttributeInput, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingFee, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteCreated, type SiteFields, type SiteInput, type SiteList, type SiteMixin, type SiteMixinCreated, type SiteMixins, SiteService, StoredAnonymousSession, 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, type Token, type TokenInput, TokenProvider, type TokenStorage, type Tool, type ToolInput, 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, approvalStatusPatch, createCookieBackedStorage, createCookieStorage, createCore, createEmporixClient, createListenerSet, createLocalStorage, createLocalStorageStorage, createMemoryStorage, createServerStorage, createSessionStorage, emporixKey, errorFromResponse, fromWebStorage, getCustomerSessionStore, parseAnonymousSession, pickFee, productIdFromYrn, productYrn, resolveZone, serverAuth, siteMeta };
12866
+ export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerImport, type AdminCustomerImportAccount, type AdminCustomerImportResult, type AdminCustomerInput, type AdminCustomerLegacyAuth, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type AdminPasswordMigrationRetention, type AdminPasswordMigrationRetentionInput, type Agent, type AgentAnalytics, type AgentExecutions, type AgentFromTemplate, type AgentInput, type AgentPatchOp, type AgentRequestLog, type AgentSearchQuery, type AgentSessionLog, type AgentTemplate, type AgenticPatchOp, type AgentsExport, type AgentsExportRequest, type AgentsImport, type AgentsImportRequest, AiService, type AnalyticsQuery, type Approval, type ApprovalCreated, type ApprovalDecision, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Attachment, type AttachmentOptions, type AttachmentReuseOptions, type AuditLogChangeType, type AuditLogEntry, type AuditLogPage, type AuditLogPathChange, type AuditLogQuery, type AuditLogRelatedEntity, AuditLogService, 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 ChatOptions, type ChatRequest, type ChatResponse, type ChatStreamOptions, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, type CommerceEvents, 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 CookieIo, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Created, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSessionState, type CustomerSessionStore, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$1 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, type EmporixStorage, type EmporixStorageKey, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type ExecutionsQuery, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type GetOptions, type IamAccessControl, type IamAccessControlCreated, type IamAccessControlUpsert, type IamGroup, type IamGroupCreate, type IamGroupCreated, AssignmentCreateRequest as IamGroupMemberAssignment, type IamGroupMemberCreated, type IamGroupMemberInput, type IamGroupUpdate, type IamScope, type IamScopeCreated, type IamScopeUpsert, IamService, type IamUser, type IamUserCreate, type IamUserCreated, type IamUserDetail, type IamUserScopes, type IamUserUpdate, type ImportCancelResult, type ImportConfig, type ImportDiagnosticKind, type ImportDiagnosticRecord, type ImportErrorRecord, type ImportPage, type ImportPageOptions, type ImportRecordOutcome, type ImportRun, type ImportRunDetail, type ImportRunDiagnostics, type ImportRunDiagnosticsQuery, type ImportRunEvent, type ImportRunInput, type ImportRunMode, type ImportRunStatus, type ImportRunStream, type ImportSchedule, ImportService, type ImportStream, type ImportStreamOrder, type ImportedRecord, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvoiceJob, type InvoiceJobCreated, type InvoiceJobDraft, InvoiceService, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type ItemFeeSearchByProductId, type ItemFeeSearchByProductIds, type Job, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListQuery, type ListQuoteReasonsQuery, type ListQuotesQuery, type ListReindexJobsOptions, type ListSchemaReferencesQuery, type ListSchemasQuery, LocationsService, LogLevel, type McpServer, type McpServerInput, MediaService, type MetadataFilter, type MinimumFee, type MutateOptions, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OAuthConfig, type OAuthInput, OrdersService, PaginatedItems, PaymentGatewayService, type PersistedAnonymousSession, type PointsSummary, PriceService, ProductService, type ProviderModels, QueryFor, type Quote, type QuoteCreated, type QuoteDraft, type QuoteHistory, type QuoteInput, type QuoteReason, type QuoteReasonCreated, type QuoteReasonDraft, type QuoteReasonUpdate, type QuoteResult, QuoteService, type QuoteSlotInput, type QuoteUpdate, RagIndexerService, type RagType, 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, STORAGE_KEYS, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, type SchemaExport, type SchemaImportInput, type SchemaInstanceBulkCreateItem, type SchemaInstanceBulkUpsertItem, type SchemaReference, type SchemaReferenceCreated, type SchemaReferenceInput, type SchemaReferenceUpdateInput, SchemaService, type SchemaTypeName, type SchemaUpdate, type SearchImportedRecordsOptions, type SearchInstancesQuery, SearchPaging, type SearchQuery, type SearchStreamRecordsOptions, SegmentService, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServerCookieJar, type ServiceClass, ServiceName, type SessionAttributeInput, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingFee, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteCreated, type SiteFields, type SiteInput, type SiteList, type SiteMixin, type SiteMixinCreated, type SiteMixins, SiteService, StoredAnonymousSession, 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, type Token, type TokenInput, TokenProvider, type TokenStorage, type Tool, type ToolInput, 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, approvalStatusPatch, createCookieBackedStorage, createCookieStorage, createCore, createEmporixClient, createListenerSet, createLocalStorage, createLocalStorageStorage, createMemoryStorage, createServerStorage, createSessionStorage, emporixKey, errorFromResponse, fromWebStorage, getCustomerSessionStore, parseAnonymousSession, pickFee, productIdFromYrn, productYrn, resolveZone, serverAuth, siteMeta };