@viu/emporix-sdk 2.34.0 → 2.36.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.
package/dist/index.d.ts CHANGED
@@ -3004,10 +3004,7 @@ type McpServerConfigRequest = McpServerConfig & {
3004
3004
  type McpServerConfigResponse = McpServerConfig & {
3005
3005
  authorizationHeaderToken?: ExpandableTokenResponse;
3006
3006
  };
3007
- /**
3008
- * An object representing customer's own implementation of the MCP server.
3009
- */
3010
- type BaseMcpServer = {
3007
+ type BaseManagedMcpServer = {
3011
3008
  /**
3012
3009
  * Name of the MCP server.
3013
3010
  */
@@ -3018,14 +3015,160 @@ type BaseMcpServer = {
3018
3015
  enabled?: boolean;
3019
3016
  transport?: CustomMcpServerTransportType;
3020
3017
  };
3021
- type McpServerRequest = BaseMcpServer & {
3018
+ /**
3019
+ * Type of the managed MCP server resource. Possible values:
3020
+ * * `custom`
3021
+ * * `dynamic`
3022
+ *
3023
+ * **The `dynamic` value is in preview mode** - some of the features may not be fully operational yet.
3024
+ */
3025
+ type ManagedMcpServerType = 'custom' | 'dynamic';
3026
+ /**
3027
+ * HTTP method used to invoke the Automation function.
3028
+ */
3029
+ type McpToolInvocationMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
3030
+ /**
3031
+ * Location of the tool arguments in the HTTP request. Defaults to `body` when omitted.
3032
+ */
3033
+ type McpToolInvocationArgsLocation = 'body' | 'query';
3034
+ type McpToolInvocationRequest = {
3035
+ /**
3036
+ * Identifier of the Automation function to invoke when the tool is called.
3037
+ */
3038
+ functionId: string;
3039
+ method: McpToolInvocationMethod;
3040
+ argsLocation?: McpToolInvocationArgsLocation;
3041
+ };
3042
+ type McpToolInvocationResponse = {
3043
+ /**
3044
+ * Identifier of the Automation function to invoke when the tool is called.
3045
+ */
3046
+ functionId?: string;
3047
+ method?: McpToolInvocationMethod;
3048
+ argsLocation?: McpToolInvocationArgsLocation;
3049
+ };
3050
+ type McpToolConfigRequest = {
3051
+ /**
3052
+ * OAuth scopes required to invoke the tool.
3053
+ */
3054
+ requiredScopes?: Array<string>;
3055
+ /**
3056
+ * JSON Schema document describing the tool input, provided as a JSON string.
3057
+ */
3058
+ inputSchema: string;
3059
+ invocation: McpToolInvocationRequest;
3060
+ };
3061
+ type McpToolConfigResponse = {
3062
+ /**
3063
+ * OAuth scopes required to invoke the tool.
3064
+ */
3065
+ requiredScopes?: Array<string>;
3066
+ /**
3067
+ * JSON Schema document describing the tool input, provided as a JSON string.
3068
+ */
3069
+ inputSchema?: string;
3070
+ invocation?: McpToolInvocationResponse;
3071
+ };
3072
+ /**
3073
+ * Tool definition for a dynamic MCP server.
3074
+ *
3075
+ * **Dynamic MCP tools are in preview mode** - some of the features may not be fully operational yet.
3076
+ */
3077
+ type McpToolRequest = {
3078
+ /**
3079
+ * Unique name of the tool. Must not contain whitespace characters.
3080
+ */
3081
+ name: string;
3082
+ /**
3083
+ * Human-readable description of the tool.
3084
+ */
3085
+ description?: string;
3086
+ /**
3087
+ * Prompt that defines when and why the agent should call this tool.
3088
+ */
3089
+ prompt: string;
3090
+ /**
3091
+ * An indicator whether the tool is enabled.
3092
+ */
3093
+ enabled?: boolean;
3094
+ config: McpToolConfigRequest;
3095
+ };
3096
+ /**
3097
+ * Tool definition for a dynamic MCP server.
3098
+ *
3099
+ * **Dynamic MCP tools are in preview mode** - some of the features may not be fully operational yet.
3100
+ */
3101
+ type McpToolResponse = {
3102
+ /**
3103
+ * Unique name of the tool.
3104
+ */
3105
+ name?: string;
3106
+ /**
3107
+ * Human-readable description of the tool.
3108
+ */
3109
+ description?: string;
3110
+ /**
3111
+ * Prompt that defines when and why the agent should call this tool.
3112
+ */
3113
+ prompt?: string;
3114
+ /**
3115
+ * An indicator whether the tool is enabled.
3116
+ */
3117
+ enabled?: boolean;
3118
+ config?: McpToolConfigResponse;
3119
+ };
3120
+ type CustomMcpServerRequest = BaseManagedMcpServer & {
3121
+ /**
3122
+ * For custom MCP servers it has to be set to `custom` or omitted. Defaults to `custom`.
3123
+ */
3124
+ type?: ManagedMcpServerType;
3022
3125
  config: McpServerConfigRequest;
3023
3126
  metadata?: MetadataRequest;
3024
3127
  };
3025
- type McpServerResponse = BaseMcpServer & {
3128
+ type DynamicMcpServerRequest = BaseManagedMcpServer & {
3129
+ /**
3130
+ * For dynamic MCP servers it has to be set to `dynamic`.
3131
+ */
3132
+ type: ManagedMcpServerType;
3133
+ /**
3134
+ * List of tools exposed by this MCP server.
3135
+ *
3136
+ * **The `tools` field is in preview mode** - some of the features may not be fully operational yet.
3137
+ */
3138
+ tools: Array<McpToolRequest>;
3139
+ metadata?: MetadataRequest;
3140
+ };
3141
+ type McpServerRequest = CustomMcpServerRequest | DynamicMcpServerRequest;
3142
+ type CustomMcpServerResponse = BaseManagedMcpServer & {
3143
+ /**
3144
+ * Unique identifier of the MCP server.
3145
+ */
3146
+ id?: string;
3147
+ /**
3148
+ * Type of the managed MCP server resource.
3149
+ */
3150
+ type?: ManagedMcpServerType;
3026
3151
  config?: McpServerConfigResponse;
3027
3152
  metadata?: MetadataResponse$1;
3028
3153
  };
3154
+ type DynamicMcpServerResponse = BaseManagedMcpServer & {
3155
+ /**
3156
+ * Unique identifier of the MCP server.
3157
+ */
3158
+ id?: string;
3159
+ /**
3160
+ * For dynamic MCP servers it has to be set to `dynamic`.
3161
+ */
3162
+ type?: ManagedMcpServerType;
3163
+ /**
3164
+ * List of tools exposed by this MCP server.
3165
+ *
3166
+ * **The `tools` field is in preview mode** - some of the features may not be fully operational yet.
3167
+ */
3168
+ tools?: Array<McpToolResponse>;
3169
+ metadata?: MetadataResponse$1;
3170
+ };
3171
+ type McpServerResponse = CustomMcpServerResponse | DynamicMcpServerResponse;
3029
3172
  type CommerceEventsResponse = {
3030
3173
  /**
3031
3174
  * List of events available to use by an agent with the `COMMERCE_EVENTS` trigger.
@@ -3033,9 +3176,9 @@ type CommerceEventsResponse = {
3033
3176
  events?: Array<string>;
3034
3177
  };
3035
3178
  /**
3036
- * Type of the MCP server. The `custom` type allows you to integrate with your own MCP server instance, while the `predefined` type allows you to integrate with one of the instances provided by Emporix.
3179
+ * Type of the MCP server attachment on an agent. The `custom` type references a tenant-managed MCP server with a URL. The `predefined` type references an Emporix domain MCP server. The `dynamic` type references a tenant-managed dynamic MCP server and may include an optional tool-name allow-list.
3037
3180
  */
3038
- type McpServerType = 'custom' | 'predefined';
3181
+ type McpServerType = 'custom' | 'predefined' | 'dynamic';
3039
3182
  /**
3040
3183
  * Type of the communication between the agent and the MCP server. The `streamable_http` protocol is recommended, since the `sse` protocol is deprecated.
3041
3184
  */
@@ -3066,17 +3209,42 @@ type CustomAgentMcpServerRequest = BaseAgentMcpServer & {
3066
3209
  id: string;
3067
3210
  };
3068
3211
  };
3069
- type CustomAgentMcpServerResponse = CustomAgentMcpServerRequest & {
3212
+ type DynamicAgentMcpServerRequest = BaseAgentMcpServer & {
3213
+ /**
3214
+ * For a dynamic MCP server attachment it has to be set to `dynamic`.
3215
+ */
3216
+ type?: unknown;
3217
+ mcpServer: {
3218
+ /**
3219
+ * ID of the dynamic MCP server.
3220
+ */
3221
+ id: string;
3222
+ };
3223
+ /**
3224
+ * Optional allow-list of tool names from the dynamic MCP server.
3225
+ */
3226
+ tools?: Array<string>;
3227
+ };
3228
+ type AgentMcpServerResponse = {
3229
+ type: McpServerType;
3070
3230
  mcpServer?: McpServerResponse & unknown;
3231
+ /**
3232
+ * Present for `predefined` attachments.
3233
+ */
3234
+ domain?: 'customer' | 'extensibility' | 'order' | 'product' | 'frontend';
3235
+ /**
3236
+ * Tool-name allow-list. Present for `predefined` attachments and for `dynamic` attachments when a subset is configured. Omitted on `dynamic` means all enabled tools on the MCP server.
3237
+ */
3238
+ tools?: Array<string>;
3071
3239
  };
3072
3240
  /**
3073
3241
  * List of MCP servers which agents should have access to.
3074
3242
  */
3075
- type AgentMcpServersRequest = Array<CustomAgentMcpServerRequest | PredefinedAgentMcpServer>;
3243
+ type AgentMcpServersRequest = Array<CustomAgentMcpServerRequest | DynamicAgentMcpServerRequest | PredefinedAgentMcpServer>;
3076
3244
  /**
3077
3245
  * List of MCP servers which agents should have access to.
3078
3246
  */
3079
- type AgentMcpServersResponse = Array<CustomAgentMcpServerResponse | PredefinedAgentMcpServer>;
3247
+ type AgentMcpServersResponse = Array<AgentMcpServerResponse>;
3080
3248
  type BaseLlm = {
3081
3249
  /**
3082
3250
  * The exact name of the model.
@@ -10287,6 +10455,115 @@ type CustomerSignupBySellerDto = CustomerCreateDto & {
10287
10455
  */
10288
10456
  password?: string;
10289
10457
  };
10458
+ type CustomerImportDto = CustomerCreateDto & {
10459
+ /**
10460
+ * Custom customer identifier. If not provided, it is automatically generated.
10461
+ */
10462
+ id?: string;
10463
+ /**
10464
+ * Optional contact email. When provided, it must match `account.email` (case-insensitive).
10465
+ * If omitted, `account.email` is used as the contact email.
10466
+ *
10467
+ */
10468
+ contactEmail?: string;
10469
+ account: CustomerImportAccountDto;
10470
+ };
10471
+ type CustomerImportAccountDto = {
10472
+ /**
10473
+ * Customer account email address. Used as the account identifier.
10474
+ */
10475
+ email: string;
10476
+ /**
10477
+ * Precomputed Emporix native password hash.
10478
+ *
10479
+ * Provide exactly one of `passwordHash` or `legacyAuth`.
10480
+ * Please, contact Emporix support to determine if your existing password hashing strategy is compatible with the Emporix native password hashing strategy.
10481
+ *
10482
+ */
10483
+ passwordHash?: string;
10484
+ legacyAuth?: LegacyAuth;
10485
+ };
10486
+ type LegacyAuth = {
10487
+ /**
10488
+ * Identifier of the legacy password verifier to use during login. Please, contact Emporix support to determine the correct value for your case.
10489
+ */
10490
+ algorithm: 'hybris-sha512-uid-salt';
10491
+ /**
10492
+ * Raw password hash exported from the source system. Stored only in `legacyAuth`, never in the native password field.
10493
+ */
10494
+ hash: string;
10495
+ /**
10496
+ * Algorithm-specific metadata required for verification.
10497
+ * Please, contact Emporix support to determine the correct values for your case.
10498
+ *
10499
+ */
10500
+ context?: {
10501
+ [key: string]: string;
10502
+ };
10503
+ };
10504
+ type PasswordMigrationRetentionConfigRequest = {
10505
+ /**
10506
+ * Future date when the password migration retention window ends.
10507
+ */
10508
+ retentionEndDate: string;
10509
+ /**
10510
+ * Optional date on or after today and before `retentionEndDate` when reminder emails are sent to unmigrated customers.
10511
+ * When omitted, defaults to 7 days before `retentionEndDate`, or to tomorrow when that default would fall on or before today.
10512
+ *
10513
+ */
10514
+ emailReminderDate?: string;
10515
+ /**
10516
+ * Optional flag indicating whether customers receive email notifications about the migration process.
10517
+ * When `true`, customers receive reminder and password reset emails. When `false`, customers do not receive any emails regarding the migration.
10518
+ * When omitted, defaults to `true`.
10519
+ *
10520
+ */
10521
+ emailNotificationsEnabled?: boolean;
10522
+ };
10523
+ type PasswordMigrationRetentionConfigResponse = {
10524
+ /**
10525
+ * Date when the password migration retention window ends.
10526
+ */
10527
+ retentionEndDate?: string;
10528
+ /**
10529
+ * Date when reminder emails are sent to unmigrated customers.
10530
+ */
10531
+ emailReminderDate?: string;
10532
+ /**
10533
+ * Flag indicating whether customers receive email notifications about the migration process.
10534
+ * When `true`, customers receive reminder and password reset emails. When `false`, customers do not receive any emails regarding the migration.
10535
+ *
10536
+ */
10537
+ emailNotificationsEnabled?: boolean;
10538
+ };
10539
+ type CustomerBulkItemResponse = {
10540
+ /**
10541
+ * Index of the processed item, matching the item position in the request body.
10542
+ */
10543
+ index?: number;
10544
+ /**
10545
+ * Customer number generated for a successfully imported customer.
10546
+ */
10547
+ id?: string;
10548
+ /**
10549
+ * HTTP status code for the processed item.
10550
+ */
10551
+ code?: number;
10552
+ /**
10553
+ * HTTP status description for the processed item.
10554
+ */
10555
+ status?: string;
10556
+ /**
10557
+ * Error message when the item failed.
10558
+ */
10559
+ message?: string;
10560
+ /**
10561
+ * List of problems causing the error.
10562
+ */
10563
+ details?: Array<{
10564
+ message?: string;
10565
+ }>;
10566
+ };
10290
10567
  type CustomerUpdateBySellerDto = CustomerCommonDto & {
10291
10568
  contactEmail?: string;
10292
10569
  active?: boolean;
@@ -10388,6 +10665,35 @@ type AdminCustomerAddressList = AdminCustomerAddress[];
10388
10665
  type AdminCustomerAddressInput = Address2;
10389
10666
  /** Upsert/patch address body (`PUT`/`PATCH …/addresses/{id}`). */
10390
10667
  type AdminCustomerAddressUpdate = AddressUpdateDto;
10668
+ /**
10669
+ * The tenant's password-migration retention window (read shape). Every field is
10670
+ * optional upstream — an unconfigured tenant answers with an empty object.
10671
+ */
10672
+ type AdminPasswordMigrationRetention = PasswordMigrationRetentionConfigResponse;
10673
+ /**
10674
+ * Body for `configurePasswordMigrationRetention`. `retentionEndDate` is required.
10675
+ * `emailReminderDate` defaults to 7 days before it (or tomorrow, when that would
10676
+ * already be past); `emailNotificationsEnabled` defaults to `true`.
10677
+ */
10678
+ type AdminPasswordMigrationRetentionInput = PasswordMigrationRetentionConfigRequest;
10679
+ /**
10680
+ * One customer of the bulk-import body. Extends the create shape with an `account`
10681
+ * block; every inherited profile field is optional, so `account.email` is the only
10682
+ * hard requirement.
10683
+ */
10684
+ type AdminCustomerImport = CustomerImportDto;
10685
+ /**
10686
+ * The `account` block of an import item. Provide **exactly one** of `passwordHash`
10687
+ * or `legacyAuth` — the type permits both, the service does not.
10688
+ */
10689
+ type AdminCustomerImportAccount = CustomerImportAccountDto;
10690
+ /** A legacy password hash carried by an import item. */
10691
+ type AdminCustomerLegacyAuth = LegacyAuth;
10692
+ /**
10693
+ * One entry of the `207` import result. `code` is the per-item HTTP status, so a
10694
+ * `409` here is a rejected customer inside an otherwise successful call.
10695
+ */
10696
+ type AdminCustomerImportResult = CustomerBulkItemResponse;
10391
10697
 
10392
10698
  /**
10393
10699
  * Emporix Customer Service — tenant/seller-managed customer profiles and
@@ -10400,6 +10706,7 @@ declare class CustomerAdminService {
10400
10706
  constructor(ctx: ClientContext);
10401
10707
  private base;
10402
10708
  private customerPath;
10709
+ private configPath;
10403
10710
  private addressPath;
10404
10711
  /** List customers. */
10405
10712
  listCustomers(query?: Record<string, string | number>, auth?: AuthContext): Promise<AdminCustomerList>;
@@ -10431,6 +10738,35 @@ declare class CustomerAdminService {
10431
10738
  addAddressTags(customerNumber: string, addressId: string, tags: string[], auth?: AuthContext): Promise<void>;
10432
10739
  /** Remove tags from an address (`?tags=` query). */
10433
10740
  removeAddressTags(customerNumber: string, addressId: string, tags: string[], auth?: AuthContext): Promise<void>;
10741
+ /**
10742
+ * Retrieves the tenant's password-migration retention config. Requires the
10743
+ * `customer.import_read` scope. An unconfigured tenant answers with an empty
10744
+ * object rather than a 404.
10745
+ */
10746
+ getPasswordMigrationRetention(auth?: AuthContext): Promise<AdminPasswordMigrationRetention>;
10747
+ /**
10748
+ * Creates or updates the retention config (`POST`). Requires the
10749
+ * `customer.import_manage` scope. **Call this before importing customers with
10750
+ * `legacyAuth`** — that import is rejected without an active config. Re-POST with
10751
+ * an earlier `retentionEndDate` to shorten a running window.
10752
+ */
10753
+ configurePasswordMigrationRetention(input: AdminPasswordMigrationRetentionInput, auth?: AuthContext): Promise<AdminPasswordMigrationRetention>;
10754
+ /**
10755
+ * Removes the retention config. Requires the `customer.import_manage` scope.
10756
+ * Intended for after the migration window: when the window ends, unmigrated
10757
+ * accounts need a password reset and their legacy credentials are cleared.
10758
+ */
10759
+ deletePasswordMigrationRetention(auth?: AuthContext): Promise<void>;
10760
+ /**
10761
+ * Bulk-imports customers (`POST /customers/import`). Requires the
10762
+ * `customer.import_manage` scope.
10763
+ *
10764
+ * Responds **207 Multi-Status**: per-item failures do **not** throw — inspect each
10765
+ * entry's `code`. Each item must carry exactly one of `account.passwordHash` or
10766
+ * `account.legacyAuth`, and importing `legacyAuth` requires an active retention
10767
+ * config (see `configurePasswordMigrationRetention`).
10768
+ */
10769
+ importCustomers(input: AdminCustomerImport[], auth?: AuthContext): Promise<AdminCustomerImportResult[]>;
10434
10770
  }
10435
10771
 
10436
10772
  /**
@@ -11120,4 +11456,4 @@ declare function productIdFromYrn(yrn: string | undefined): string;
11120
11456
  */
11121
11457
  declare function productYrn(tenant: string, productId: string): string;
11122
11458
 
11123
- 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 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 Assignee, type Attachment, type AttachmentOptions, 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, 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 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, 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 ImportErrorRecord, type ImportPage, type ImportPageOptions, type ImportRecordOutcome, type ImportRun, type ImportRunDetail, type ImportRunEvent, type ImportRunInput, type ImportRunMode, type ImportRunStatus, type ImportRunStream, type ImportSchedule, ImportService, type ImportStream, 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, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PersistedAnonymousSession, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, 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 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, 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, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, 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 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, createCore, createEmporixClient, createServerStorage, errorFromResponse, parseAnonymousSession, pickFee, productIdFromYrn, productYrn, resolveZone, serverAuth };
11459
+ 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 Assignee, type Attachment, type AttachmentOptions, 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, 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 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, 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 ImportErrorRecord, type ImportPage, type ImportPageOptions, type ImportRecordOutcome, type ImportRun, type ImportRunDetail, type ImportRunEvent, type ImportRunInput, type ImportRunMode, type ImportRunStatus, type ImportRunStream, type ImportSchedule, ImportService, type ImportStream, 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, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PersistedAnonymousSession, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, 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 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, 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, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, 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 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, createCore, createEmporixClient, createServerStorage, errorFromResponse, parseAnonymousSession, pickFee, productIdFromYrn, productYrn, resolveZone, serverAuth };
package/dist/index.js CHANGED
@@ -698,7 +698,7 @@ var HttpClient = class {
698
698
  };
699
699
 
700
700
  // package.json
701
- var version = "2.34.0";
701
+ var version = "2.36.0";
702
702
 
703
703
  // src/version.ts
704
704
  var SDK_VERSION = version;
@@ -4616,6 +4616,9 @@ var CustomerAdminService = class {
4616
4616
  customerPath(customerNumber) {
4617
4617
  return `${this.base()}/${encodeURIComponent(customerNumber)}`;
4618
4618
  }
4619
+ configPath() {
4620
+ return `/customer/${this.ctx.tenant}/config/password-migration-retention`;
4621
+ }
4619
4622
  addressPath(customerNumber, addressId) {
4620
4623
  return `${this.customerPath(customerNumber)}/addresses/${encodeURIComponent(addressId)}`;
4621
4624
  }
@@ -4706,6 +4709,59 @@ var CustomerAdminService = class {
4706
4709
  query: { tags: tags.join(",") }
4707
4710
  });
4708
4711
  }
4712
+ // --- Password-migration retention ---
4713
+ /**
4714
+ * Retrieves the tenant's password-migration retention config. Requires the
4715
+ * `customer.import_read` scope. An unconfigured tenant answers with an empty
4716
+ * object rather than a 404.
4717
+ */
4718
+ async getPasswordMigrationRetention(auth2 = SERVICE28) {
4719
+ return this.ctx.http.request({
4720
+ method: "GET",
4721
+ path: this.configPath(),
4722
+ auth: auth2
4723
+ });
4724
+ }
4725
+ /**
4726
+ * Creates or updates the retention config (`POST`). Requires the
4727
+ * `customer.import_manage` scope. **Call this before importing customers with
4728
+ * `legacyAuth`** — that import is rejected without an active config. Re-POST with
4729
+ * an earlier `retentionEndDate` to shorten a running window.
4730
+ */
4731
+ async configurePasswordMigrationRetention(input, auth2 = SERVICE28) {
4732
+ return this.ctx.http.request({
4733
+ method: "POST",
4734
+ path: this.configPath(),
4735
+ auth: auth2,
4736
+ body: input
4737
+ });
4738
+ }
4739
+ /**
4740
+ * Removes the retention config. Requires the `customer.import_manage` scope.
4741
+ * Intended for after the migration window: when the window ends, unmigrated
4742
+ * accounts need a password reset and their legacy credentials are cleared.
4743
+ */
4744
+ async deletePasswordMigrationRetention(auth2 = SERVICE28) {
4745
+ await this.ctx.http.request({ method: "DELETE", path: this.configPath(), auth: auth2 });
4746
+ }
4747
+ // --- Bulk import ---
4748
+ /**
4749
+ * Bulk-imports customers (`POST /customers/import`). Requires the
4750
+ * `customer.import_manage` scope.
4751
+ *
4752
+ * Responds **207 Multi-Status**: per-item failures do **not** throw — inspect each
4753
+ * entry's `code`. Each item must carry exactly one of `account.passwordHash` or
4754
+ * `account.legacyAuth`, and importing `legacyAuth` requires an active retention
4755
+ * config (see `configurePasswordMigrationRetention`).
4756
+ */
4757
+ async importCustomers(input, auth2 = SERVICE28) {
4758
+ return this.ctx.http.request({
4759
+ method: "POST",
4760
+ path: `${this.base()}/import`,
4761
+ auth: auth2,
4762
+ body: input
4763
+ });
4764
+ }
4709
4765
  };
4710
4766
 
4711
4767
  // src/services/approval.ts