@viu/emporix-sdk 2.22.0 → 2.23.0

package/dist/index.d.cts

@@ -3,30 +3,29 @@ export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, d as
 import { CustomerService } from './customer.cjs';
 export { Address, AddressCreateInput, AddressUpdateInput, ChangeEmailInput, ConfirmEmailChangeInput, Customer, CustomerSession, CustomerSignupInput, CustomerUpdateInput, PasswordChangeInput, PasswordResetConfirmInput, PasswordResetRequestInput, ResendActivationInput } from './customer.cjs';
 import { ProductService } from './product.cjs';
-export { Media, Product } from './product.cjs';
+export { Media, Product, ProductBulkCreateInput, ProductBulkResult, ProductBulkUpdateInput, ProductCreateInput, ProductCreated, ProductPatchInput, ProductRecalculationInput, ProductRecalculationJob, ProductRecalculationJobStatus, ProductRecalculationResult, ProductTemplate, ProductTemplateCreateInput, ProductTemplateCreated, ProductTemplateUpdateInput, ProductUpdateInput, ProductWriteOptions } from './product.cjs';
 import { CategoryService } from './category.cjs';
-export { Category, CategoryNode } from './category.cjs';
+export { Category, CategoryAssignment, CategoryAssignmentBulkInput, CategoryAssignmentBulkResult, CategoryAssignmentCreated, CategoryAssignmentInput, CategoryAssignmentRefBulkInput, CategoryCreateInput, CategoryCreated, CategoryNode, CategoryPatchInput, CategoryTreeSearchInput, CategoryUpdateInput } from './category.cjs';
 import { CartService } from './cart.cjs';
-export { Cart, CartAddress, CartCreated, CartItem, CartItemInput, CartItemUpdate, CartItemsBatchUpdateInput, CartItemsBatchUpdateResult, CartValidationResult, CreateCartInput } from './cart.cjs';
+export { Cart, CartAddress, CartCreated, CartDeliveryRestrictions, CartDiscount, CartItem, CartItemInput, CartItemUpdate, CartItemsBatchUpdateInput, CartItemsBatchUpdateResult, CartSearchInput, CartSummary, CartUpdateInput, CartValidationResult, CreateCartInput } from './cart.cjs';
 import { CheckoutService } from './checkout.cjs';
 export { CheckoutInput, CheckoutOptions, CheckoutResult, QuoteCheckoutInput } from './checkout.cjs';
 import { PaymentGatewayService } from './payment.cjs';
-export { AuthorizePaymentInput, AuthorizePaymentResult, InitializePaymentInput, InitializePaymentResult, PaymentMode } from './payment.cjs';
+export { AuthorizePaymentInput, AuthorizePaymentResult, InitializePaymentInput, InitializePaymentResult, PaymentActionResult, PaymentAuthorizeResult, PaymentCaptureInput, PaymentCaptureResult, PaymentMode, PaymentModeConfig, PaymentModeCreateInput, PaymentModeUpdateInput, PaymentRefundInput, PaymentTransaction } from './payment.cjs';
 import { PriceService } from './price.cjs';
-export { MatchByContextChunkedOptions, PriceMatch, PriceMatchByContextInput, PriceMatchInput, PriceMatchItemRef } from './price.cjs';
+export { MatchByContextChunkedOptions, Price, PriceBulkResult, PriceCreateInput, PriceList, PriceListInput, PriceListPrice, PriceListPriceInput, PriceListPriceUpdateInput, PriceListUpdateInput, PriceMatch, PriceMatchByContextInput, PriceMatchInput, PriceMatchItemRef, PriceModel, PriceModelInput } from './price.cjs';
 import { MediaService } from './media.cjs';
 export { Asset, AssetCreateBlobInput, AssetCreateLinkInput, AssetRefId, AssetUpdateBlobInput, AssetUpdateInput, AssetUpdateLinkInput, DownloadResult, ListAssetsQuery } from './media.cjs';
 import { SegmentService } from './segment.cjs';
-export { Segment, SegmentCategoryTree, SegmentCategoryTreeNode, SegmentItem, SegmentServiceDeps } from './segment.cjs';
+export { Segment, SegmentAssignmentBulkResult, SegmentBulkItem, SegmentBulkResult, SegmentCategoryTree, SegmentCategoryTreeNode, SegmentCustomer, SegmentCustomerBulkInput, SegmentCustomerInput, SegmentInput, SegmentItem, SegmentItemBulkInput, SegmentItemInput, SegmentMatchInput, SegmentPatchInput, SegmentSearchQuery, SegmentServiceDeps, SegmentUpdateInput } from './segment.cjs';
 import { CompaniesService } from './companies.cjs';
 import { ContactsService } from './contacts.cjs';
 import { LocationsService } from './locations.cjs';
-import { CustomerGroupsService } from './customer-groups.cjs';
-export { IamGroup, IamGroupMemberAssignment } from './customer-groups.cjs';
+import { m as UserResponse, U as UserCreateRequest, l as UserIdResponse, k as UserExtendedResponse, o as UserUpdateRequest, j as GroupsQueryDocument, n as UserScopesResponse, a as AccessControlQueryDocument, G as GroupCreateRequest, h as GroupIdResponse, i as GroupUpdateRequest, c as AssignmentCreateRequest, d as AssignmentIdResponse, b as AccessControlUpsertRequest, A as AccessControlIdResponse, e as CustomScopeQueryDocument, f as CustomScopeUpsertRequest, C as CustomScopeIdResponse, g as CustomerGroupsService } from './customer-groups-BxSNFHq1.cjs';
 import { OrdersService, SalesOrdersService } from './orders.cjs';
-export { GetOrderOptions, ListMyOrdersOptions, Order, OrderEntry, OrderStatus, OrderTransitionOptions, SalesOrder, SalesOrderPatch, Transition, UpdateSalesOrderOptions } from './orders.cjs';
+export { GetOrderOptions, ListLegalEntityOrdersOptions, ListMyOrdersOptions, ListSalesOrdersOptions, Order, OrderEntry, OrderStatus, OrderTransitionOptions, SalesOrder, SalesOrderCalculationInput, SalesOrderCreateInput, SalesOrderCreated, SalesOrderEntriesInput, SalesOrderHistoricalTransitions, SalesOrderPatch, SalesOrderReplaceInput, SalesOrderSearchInput, SalesOrderSplitInput, SalesOrderSplitResult, Transition, UpdateSalesOrderOptions } from './orders.cjs';
 import { AvailabilityService } from './availability.cjs';
-export { Availability, AvailabilityOptions } from './availability.cjs';
+export { Availability, AvailabilityBulkDeleteInput, AvailabilityBulkInput, AvailabilityBulkResult, AvailabilityCreated, AvailabilityInput, AvailabilityOptions } from './availability.cjs';
 import { a as QueryFor } from './query-mLQs2WFr.cjs';
 export { B as BuiltQuery, Q as QueryCapability, r as resolveQuery } from './query-mLQs2WFr.cjs';
 export { A as AccountLimit, C as ContactAssignment, a as ContactAssignmentCreate, b as ContactAssignmentUpdate, c as ContactDetails, d as CustomerGroup, L as LegalEntity, e as LegalEntityCreate, f as LegalEntityUpdate, g as LegalInfo, h as Location, i as LocationCreate, j as LocationUpdate } from './types.gen-C_wOXYZB.cjs';
@@ -228,6 +227,24 @@ type ServiceSettingsDto = {
         [key: string]: unknown;
     };
 };
+type ResourceLocation$2 = {
+    /**
+     * Resource identifier.
+     */
+    id?: string;
+};
+/**
+ * Represents a single mixin. The payload is represented as a map with a single key and value, where key represents a mixin group name and value represents a map with keys and values.
+ */
+type Mixin = {
+    [key: string]: unknown;
+};
+/**
+ * Represents mixins. The object is represented as a map with keys and values, where key represents a mixin group name and value represents a map with keys and values.
+ */
+type Mixins = {
+    [key: string]: unknown;
+};
 type AssistedBuying$1 = {
     /**
      * Storefront URL, where an employee should be redirected when the assisted buying mechanism is used.
@@ -248,6 +265,23 @@ type Site$1 = Omit<SiteDto, "active" | "default"> & {
     active: boolean;
     default: boolean;
 };
+/**
+ * Body for creating or updating a site. This is the raw generated `SiteDto`
+ * (with `active`/`default` optional) — unlike the read-side {@link Site},
+ * which re-tightens both to required.
+ */
+type SiteInput = SiteDto;
+/** Id/location envelope returned when a site is created. */
+type SiteCreated = ResourceLocation$2;
+/**
+ * A single site mixin group's content. The spec defines no structure — it is an
+ * open map of keys to values.
+ */
+type SiteMixin = Mixin;
+/** All mixin groups of a site, as a map of group name to content. */
+type SiteMixins = Mixins;
+/** Id/location envelope returned when a site mixin is created. */
+type SiteMixinCreated = ResourceLocation$2;
 
 /**
  * Read-only access to the tenant's site catalog. List returns active sites
@@ -267,6 +301,48 @@ declare class SiteService {
      * Throws if no default is configured — a tenant should always have one.
      */
     current(authCtx?: AuthContext): Promise<Site$1>;
+    /** Lists just the tenant's site codes (`GET /siteslist`). Default auth: anonymous. */
+    listCodes(authCtx?: AuthContext): Promise<string[]>;
+    /** Creates a site (`POST /sites`). Default auth: service. */
+    create(input: SiteInput, authCtx?: AuthContext): Promise<SiteCreated>;
+    /**
+     * Partially updates a site (`PATCH /sites/{siteCode}`). The endpoint responds
+     * 200 without a defined body, so nothing is returned — re-read with
+     * {@link get} when the updated site is needed. Default auth: service.
+     */
+    update(siteCode: string, input: SiteInput, authCtx?: AuthContext): Promise<void>;
+    /**
+     * Full-replaces a site (`PUT /sites/{siteCode}`). Like {@link update} it
+     * returns nothing (200 with no defined body). `options.expand` is forwarded as
+     * a query parameter. Default auth: service.
+     */
+    replace(siteCode: string, input: SiteInput, options?: {
+        expand?: string;
+    }, authCtx?: AuthContext): Promise<void>;
+    /** Deletes a site (`DELETE /sites/{siteCode}`). Default auth: service. */
+    delete(siteCode: string, authCtx?: AuthContext): Promise<void>;
+    /**
+     * Site mixins (`/sites/{siteCode}/mixins`). Mixin content is an open map —
+     * the spec defines no structure. Reads default to anonymous, writes to
+     * service auth.
+     */
+    readonly mixins: {
+        /** All mixin groups of a site, as a map of group name to content. */
+        list: (siteCode: string, authCtx?: AuthContext) => Promise<SiteMixins>;
+        /** One mixin group's content by name. */
+        get: (siteCode: string, mixinName: string, authCtx?: AuthContext) => Promise<SiteMixin>;
+        /** Adds a mixin to a site. Default auth: service. */
+        create: (siteCode: string, input: SiteMixin, authCtx?: AuthContext) => Promise<SiteMixinCreated>;
+        /**
+         * Partially updates a mixin (PATCH). Responds 200 without a defined body,
+         * so nothing is returned. Default auth: service.
+         */
+        update: (siteCode: string, mixinName: string, input: SiteMixin, authCtx?: AuthContext) => Promise<void>;
+        /** Full-replaces a mixin (PUT). Returns nothing, like {@link update}. Default auth: service. */
+        replace: (siteCode: string, mixinName: string, input: SiteMixin, authCtx?: AuthContext) => Promise<void>;
+        /** Removes a mixin from a site. Default auth: service. */
+        delete: (siteCode: string, mixinName: string, authCtx?: AuthContext) => Promise<void>;
+    };
 }
 
 /**
@@ -424,6 +500,79 @@ declare class SessionContextService {
     removeAttribute(name: string, authCtx?: AuthContext): Promise<void>;
 }
 
+/** A user as returned by IAM (list item / summary). */
+type IamUser = UserResponse;
+/** A user with its group memberships (single-user GET). */
+type IamUserDetail = UserExtendedResponse;
+type IamUserCreate = UserCreateRequest;
+type IamUserUpdate = UserUpdateRequest;
+type IamUserScopes = UserScopesResponse;
+type IamUserCreated = UserIdResponse;
+/** A user group. */
+type IamGroup = GroupsQueryDocument;
+type IamGroupCreate = GroupCreateRequest;
+type IamGroupUpdate = GroupUpdateRequest;
+type IamGroupCreated = GroupIdResponse;
+/** Body to add/assign a user to a group. */
+type IamGroupMemberInput = AssignmentCreateRequest;
+type IamGroupMemberCreated = AssignmentIdResponse;
+type IamAccessControl = AccessControlQueryDocument;
+type IamAccessControlUpsert = AccessControlUpsertRequest;
+type IamAccessControlCreated = AccessControlIdResponse;
+type IamScope = CustomScopeQueryDocument;
+type IamScopeUpsert = CustomScopeUpsertRequest;
+type IamScopeCreated = CustomScopeIdResponse;
+
+/**
+ * IAM admin CRUD: users, user-groups, access-controls, scopes. Every method
+ * requires an explicit `auth` (admin/service token; `getMe*` take the caller's
+ * customer token). The deprecated legacy-RBAC model (roles/permissions/
+ * resources/templates) is intentionally not wrapped.
+ */
+declare class IamService {
+    private readonly ctx;
+    static readonly channel: "iam";
+    constructor(ctx: ClientContext);
+    private base;
+    readonly users: {
+        list: (auth: AuthContext, query?: Record<string, string | number>) => Promise<IamUser[]>;
+        create: (input: IamUserCreate, auth: AuthContext) => Promise<IamUserCreated>;
+        get: (userId: string, auth: AuthContext) => Promise<IamUserDetail>;
+        getMe: (auth: AuthContext) => Promise<IamUserDetail>;
+        update: (userId: string, input: IamUserUpdate, auth: AuthContext) => Promise<void>;
+        delete: (userId: string, auth: AuthContext) => Promise<void>;
+        getGroups: (userId: string, auth: AuthContext) => Promise<IamGroup[]>;
+        getScopes: (userId: string, auth: AuthContext) => Promise<IamUserScopes>;
+        getMyScopes: (auth: AuthContext) => Promise<IamUserScopes>;
+        getAccessControls: (userId: string, auth: AuthContext) => Promise<IamAccessControl[]>;
+        getMyAccessControls: (auth: AuthContext) => Promise<IamAccessControl[]>;
+    };
+    readonly groups: {
+        list: (auth: AuthContext, query?: Record<string, string | number>) => Promise<IamGroup[]>;
+        create: (input: IamGroupCreate, auth: AuthContext) => Promise<IamGroupCreated>;
+        get: (groupId: string, auth: AuthContext) => Promise<IamGroup>;
+        update: (groupId: string, input: IamGroupUpdate, auth: AuthContext) => Promise<void>;
+        delete: (groupId: string, auth: AuthContext) => Promise<void>;
+        listUsers: (groupId: string, auth: AuthContext) => Promise<IamUser[]>;
+        addUser: (groupId: string, input: IamGroupMemberInput, auth: AuthContext) => Promise<IamGroupMemberCreated>;
+        updateUser: (groupId: string, userType: string, userId: string, input: IamGroupMemberInput, auth: AuthContext) => Promise<IamGroupMemberCreated>;
+        removeAllUsers: (groupId: string, auth: AuthContext) => Promise<void>;
+        listAccessControls: (groupId: string, auth: AuthContext) => Promise<IamAccessControl[]>;
+    };
+    readonly accessControls: {
+        list: (auth: AuthContext) => Promise<IamAccessControl[]>;
+        get: (id: string, auth: AuthContext) => Promise<IamAccessControl>;
+        upsert: (id: string, input: IamAccessControlUpsert, auth: AuthContext) => Promise<IamAccessControlCreated>;
+        delete: (id: string, auth: AuthContext) => Promise<void>;
+    };
+    readonly scopes: {
+        list: (auth: AuthContext) => Promise<IamScope[]>;
+        get: (scopeId: string, auth: AuthContext) => Promise<IamScope>;
+        upsertCustom: (scopeId: string, input: IamScopeUpsert, auth: AuthContext) => Promise<IamScopeCreated>;
+        deleteCustom: (scopeId: string, auth: AuthContext) => Promise<void>;
+    };
+}
+
 type BaseConfiguration = {
     /**
      * Configuration key.
@@ -516,6 +665,12 @@ declare class TenantConfigService {
     update<T = unknown>(key: string, draft: ConfigurationDraft<T>, auth?: AuthContext): Promise<Configuration$1<T>>;
     /** Delete one tenant configuration by key. */
     delete(key: string, auth?: AuthContext): Promise<void>;
+    /**
+     * List the platform-wide global configurations
+     * (`GET /global-configurations`) — a separate resource from the tenant's own
+     * `/configurations`.
+     */
+    listGlobal<T = unknown>(auth?: AuthContext): Promise<Configuration$1<T>[]>;
 }
 
 /**
@@ -540,6 +695,12 @@ declare class ClientConfigService {
     update<T = unknown>(client: string, key: string, draft: ConfigurationDraft<T>, auth?: AuthContext): Promise<ClientConfiguration<T>>;
     /** Delete one client configuration by key. */
     delete(client: string, key: string, auth?: AuthContext): Promise<void>;
+    /**
+     * List the client ids that have configurations (`GET /clients`). Note this
+     * targets `/configuration/{tenant}/clients` directly — the private `base`
+     * helper appends `/configurations` for a specific client.
+     */
+    listClients(auth?: AuthContext): Promise<string[]>;
 }
 
 /** A single shopping-list line item. */
@@ -965,6 +1126,31 @@ interface ItemFeeSearch {
     itemYrns: string[];
     siteCode: string;
 }
+/**
+ * Body of `POST /itemFees/searchByProductId` — one product, several sites.
+ *
+ * **Note:** this and {@link ItemFeeSearchByProductIds} are asymmetric in the
+ * upstream spec (singular here takes `siteCodes: string[]`, plural takes a
+ * single `siteCode` and a comma-joined `productIds` **string**). The SDK mirrors
+ * the schema verbatim rather than normalizing it.
+ */
+interface ItemFeeSearchByProductId {
+    productId: string;
+    siteCodes: string[];
+    pageNumber?: number;
+    pageSize?: number;
+}
+/**
+ * Body of `POST /itemFees/searchByProductIds` — several products, one site.
+ * `productIds` is a **single string** (comma-separated), not an array — see the
+ * note on {@link ItemFeeSearchByProductId}.
+ */
+interface ItemFeeSearchByProductIds {
+    productIds: string;
+    siteCode: string;
+    pageNumber?: number;
+    pageSize?: number;
+}
 /**
  * Query for the paginated `GET /fees` list. Explicit fields are typed for
  * autocomplete; the index signature stays open so Emporix `q`-syntax filters
@@ -1046,6 +1232,23 @@ declare class FeeService {
     setProductFees(productId: string, feeIds: string[], opts?: SetItemFeesOptions, auth?: AuthContext): Promise<ItemFee>;
     /** Delete all fee mappings for a product id. */
     deleteProductFees(productId: string, auth?: AuthContext): Promise<void>;
+    /**
+     * Removes **one** fee from a product
+     * (`DELETE /productFees/{productId}/fees/{feeId}`). Use
+     * {@link deleteProductFees} to clear every fee of a product.
+     */
+    deleteProductFee(productId: string, feeId: string, auth?: AuthContext): Promise<void>;
+    /**
+     * Finds item fees for one product across several sites
+     * (`POST /itemFees/searchByProductId`).
+     */
+    searchItemFeesByProductId(search: ItemFeeSearchByProductId, auth?: AuthContext): Promise<ItemFee[]>;
+    /**
+     * Finds item fees for several products on one site
+     * (`POST /itemFees/searchByProductIds`). Note the upstream asymmetry:
+     * `productIds` is a comma-separated **string** and `siteCode` is singular.
+     */
+    searchItemFeesByProductIds(search: ItemFeeSearchByProductIds, auth?: AuthContext): Promise<ItemFee[]>;
 }
 
 /** Options for {@link CloudFunctionsService.invoke}. */
@@ -1423,6 +1626,31 @@ declare class WebhookService {
     getDashboardAccess(auth?: AuthContext): Promise<WebhookDashboardAccess>;
 }
 
+type ExportImportRequest = {
+    /**
+     * Base64 representation of custom entities with corresponding schemas.
+     */
+    data: string;
+};
+type ExportImportResponse = ExportImportRequest & {
+    /**
+     * Date and time when the object was created, compliant with the ISO 8601 standard. For example: `2022-03-31T09:52:15.423Z`
+     */
+    exportedAt?: string;
+    /**
+     * Base64 representation of custom entities with corresponding schemas.
+     */
+    data: string;
+};
+/**
+ * Id of the created schema.
+ */
+type IdResponse$1 = {
+    /**
+     * ID of the generated document.
+     */
+    id?: string;
+};
 /**
  * Type which the schema should be assigned to. Can be one of the predefined values or any custom schema type id.
  */
@@ -1509,6 +1737,27 @@ type SchemaAttribute$1 = {
         localized?: Localized;
     };
 };
+type AbstractSchemaRequest = {
+    /**
+     * Localized schema name in a form of a map of translations.
+     */
+    name: {
+        [key: string]: unknown;
+    };
+    /**
+     * List of types which schema should be assigned to.
+     */
+    types: Array<SchemaType>;
+};
+type ReferenceCreation = AbstractSchemaRequest & {
+    /**
+     * Identifier of the schema.
+     */
+    id?: string;
+};
+type ReferenceUpdate = AbstractSchemaRequest & {
+    metadata?: SchemaMetadataUpdate;
+};
 type SchemaMetadataUpdate = {
     /**
      * Version of the object. The value is required during update operation.
@@ -1552,6 +1801,7 @@ type SchemaResponse = AbstractSchemaResponse & {
      */
     attributes?: Array<SchemaAttribute$1>;
 };
+type ReferenceResponse = AbstractSchemaResponse;
 type CustomSchemaTypeResponse = {
     /**
      * Unique id of the custom schema type.
@@ -1581,6 +1831,56 @@ type CustomSchemaTypeResponse = {
         version?: number;
     };
 };
+type CustomInstanceCreation = {
+    /**
+     * Id of the custom instance.
+     */
+    id?: string;
+    /**
+     * Localized custom type name in a form of a map of translations.
+     */
+    name?: {
+        [key: string]: unknown;
+    };
+    owner?: CustomInstanceOwnerRequest;
+    /**
+     * A key-value map of additional attributes.
+     */
+    mixins?: string;
+    metadata?: {
+        /**
+         * A key-value map, where key is a mixin name and value is a link to the mixin schema.
+         */
+        mixins?: {
+            [key: string]: unknown;
+        };
+    };
+};
+type CustomInstanceUpdate = {
+    /**
+     * Localized custom type name in a form of a map of translations.
+     */
+    name?: {
+        [key: string]: unknown;
+    };
+    owner?: CustomInstanceOwnerRequest;
+    /**
+     * A key-value map of additional attributes.
+     */
+    mixins?: string;
+    metadata?: {
+        /**
+         * Version of the custom instance.  If provided, it will be validated against the current entity version.
+         */
+        version?: number;
+        /**
+         * A key-value map, where key is a mixin name and value is a link to the mixin schema.
+         */
+        mixins?: {
+            [key: string]: unknown;
+        };
+    };
+};
 /**
  * Ownership of the custom instance. It can be assigned explicitly during creation by users with a `manage` scope, or populated automatically based on who created the custom instance. Once set, the owner is immutable and cannot be modified.
  *
@@ -1601,6 +1901,26 @@ type CustomInstanceOwner = {
      */
     legalEntityId?: string | null;
 };
+/**
+ * Ownership of the custom instance that can be provided when creating a custom instance.
+ * The `owner` field can be set explicitly only by users with a `manage` scope, when the request is authorized with a `manage_own` scope, this field is ignored and ownership is set automatically to the user who created the custom instance.
+ * When the user has a `manage` scope but this field is not provided, ownership is set automatically to the user who created the custom instance.
+ *
+ */
+type CustomInstanceOwnerRequest = {
+    /**
+     * Type of the owner.
+     */
+    type: 'EMPLOYEE' | 'CUSTOMER';
+    /**
+     * Identifier of the employee or customer associated with the owner.
+     */
+    userId: string;
+    /**
+     * Legal entity identifier. Can be provided only when `type` is `CUSTOMER`.
+     */
+    legalEntityId?: string;
+};
 type CustomInstanceResponse = {
     /**
      * Unique identifier of the custom instance.
@@ -1779,6 +2099,34 @@ interface ListCustomEntitiesOptions {
 }
 /** Structured search filter body for {@link SchemaService.searchInstances}. */
 type InstanceSearchBody = Record<string, unknown>;
+/** A reference entity (a schema attached to an uploaded JSON file). */
+type SchemaReference = ReferenceResponse;
+/** Metadata part for creating a reference. */
+type SchemaReferenceInput = ReferenceCreation;
+/** Metadata part for updating a reference. */
+type SchemaReferenceUpdateInput = ReferenceUpdate;
+/** Id envelope returned when a reference is created. */
+type SchemaReferenceCreated = IdResponse$1;
+/** One item for {@link SchemaService.bulkCreateInstances}. */
+type SchemaInstanceBulkCreateItem = CustomInstanceCreation;
+/** One item for {@link SchemaService.bulkUpsertInstances} — an update plus its id. */
+type SchemaInstanceBulkUpsertItem = {
+    id: string;
+} & CustomInstanceUpdate;
+/** Result of a custom-entity export — base64 `data` plus `exportedAt`. */
+type SchemaExport = ExportImportResponse;
+/** Body for a custom-entity import — the base64 `data` produced by an export. */
+type SchemaImportInput = ExportImportRequest;
+/** Filter / pagination options for `schema.references.list`. */
+interface ListSchemaReferencesQuery {
+    pageNumber?: number;
+    pageSize?: number;
+    sort?: string;
+    q?: string;
+    fields?: string;
+    /** Restrict to references attached to this entity type (e.g. `PRODUCT`). */
+    type?: string;
+}
 
 /**
  * Schema Service (`/schema/{tenant}/…`): schemas, entity types, custom
@@ -1793,6 +2141,7 @@ declare class SchemaService {
     private schemasBase;
     private entitiesBase;
     private instancesBase;
+    private referencesBase;
     /**
      * List schemas, wrapped in the shared {@link PaginatedItems} envelope.
      * `hasNextPage` is the standard SDK heuristic (`items.length === pageSize`).
@@ -1855,6 +2204,43 @@ declare class SchemaService {
      * each item's `code`/`status`.
      */
     bulkPatchInstances(type: string, items: BulkPatchInstanceItem[], auth?: AuthContext): Promise<BulkInstanceResult>;
+    /**
+     * Create multiple instances in one request
+     * (`POST /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`.
+     */
+    bulkCreateInstances(type: string, items: SchemaInstanceBulkCreateItem[], auth?: AuthContext): Promise<BulkInstanceResult>;
+    /**
+     * Upsert multiple instances in one request
+     * (`PUT /custom-entities/{type}/instances/bulk`). Each item carries its `id`.
+     * Returns the same 207 per-item envelope as {@link bulkCreateInstances}.
+     */
+    bulkUpsertInstances(type: string, items: SchemaInstanceBulkUpsertItem[], auth?: AuthContext): Promise<BulkInstanceResult>;
+    /**
+     * Delete multiple instances by id
+     * (`DELETE /custom-entities/{type}/instances/bulk`). Returns the same 207
+     * per-item envelope as {@link bulkCreateInstances}.
+     *
+     * **Note:** the OpenAPI schema declares no request body for this operation,
+     * but its description mandates one — "The IDs of items should be defined in
+     * the request body as an array of strings" (example
+     * `["firstId", "secondId"]`). The SDK follows the description and sends the
+     * id array. Unverified against the live API.
+     */
+    bulkDeleteInstances(type: string, ids: string[], auth?: AuthContext): Promise<BulkInstanceResult>;
+    /**
+     * Export custom entities and their schemas
+     * (`POST /custom-entities/export`). Pass the entity types to include; the
+     * result carries a base64 `data` payload plus `exportedAt`.
+     */
+    exportCustomEntities(types: string[], auth?: AuthContext): Promise<SchemaExport>;
+    /**
+     * Import custom entities and their schemas
+     * (`POST /custom-entities/import`) from the base64 `data` produced by
+     * {@link exportCustomEntities}.
+     */
+    importCustomEntities(input: SchemaImportInput, auth?: AuthContext): Promise<void>;
     /** Delete an instance by id. */
     deleteInstance(type: string, id: string, auth?: AuthContext): Promise<void>;
     /**
@@ -1862,6 +2248,41 @@ declare class SchemaService {
      * (`POST /instances/search`), wrapped in {@link PaginatedItems}.
      */
     searchInstances<T = Record<string, unknown>>(type: string, body: InstanceSearchBody, auth?: AuthContext): Promise<PaginatedItems<CustomInstance<T>>>;
+    /**
+     * Reference entities (`/references`) — a schema plus an uploaded JSON file.
+     * Create/update are `multipart/form-data` (parts `file` and `body`), like
+     * the media service's blob upload. Default auth: service.
+     */
+    readonly references: {
+        /**
+         * List references, wrapped in {@link PaginatedItems}. Pagination defaults
+         * match the rest of this service (`pageNumber: 1`, `pageSize: 60`).
+         */
+        list: (query?: ListSchemaReferencesQuery, auth?: AuthContext) => Promise<PaginatedItems<SchemaReference>>;
+        /** Retrieve one reference by id. */
+        get: (id: string, auth?: AuthContext) => Promise<SchemaReference>;
+        /**
+         * Create a reference. `file` is the reference's JSON content — pass a
+         * `Blob` to upload as-is, or a plain object to have it serialized into a
+         * JSON blob. `body` carries the metadata.
+         */
+        create: (input: {
+            file: Blob | Record<string, unknown>;
+            body: SchemaReferenceInput;
+        }, auth?: AuthContext) => Promise<SchemaReferenceCreated>;
+        /**
+         * Update a reference (multipart, like {@link create}). `options.version`
+         * enables optimistic locking — the server answers 409 on a stale version.
+         */
+        update: (id: string, input: {
+            file: Blob | Record<string, unknown>;
+            body: SchemaReferenceUpdateInput;
+        }, options?: {
+            version?: number;
+        }, auth?: AuthContext) => Promise<void>;
+        /** Delete a reference by id. */
+        delete: (id: string, auth?: AuthContext) => Promise<void>;
+    };
 }
 
 type AgenticRequest = {
@@ -9570,6 +9991,7 @@ declare class EmporixClient {
     readonly contacts: ContactsService;
     readonly locations: LocationsService;
     readonly customerGroups: CustomerGroupsService;
+    readonly iam: IamService;
     readonly orders: OrdersService;
     readonly salesOrders: SalesOrdersService;
     readonly availability: AvailabilityService;
@@ -9704,4 +10126,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 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 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 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, 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 IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvoiceJob, type InvoiceJobCreated, type InvoiceJobDraft, InvoiceService, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, 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 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 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, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, SchemaService, type SchemaTypeName, type SchemaUpdate, type SearchQuery, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServiceClass, ServiceName, type SessionAttributeInput, 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, type Token, type TokenInput, TokenProvider, 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, 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 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 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 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, 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 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 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, 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 SearchQuery, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServiceClass, ServiceName, type SessionAttributeInput, 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 SiteCreated, type SiteInput, type SiteList, type SiteMixin, type SiteMixinCreated, type SiteMixins, 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, type Token, type TokenInput, TokenProvider, 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, createCore, createEmporixClient, errorFromResponse, productIdFromYrn };