@viu/emporix-sdk 2.4.0 → 2.6.0

package/dist/index.cjs

@@ -366,6 +366,26 @@ async function resolveToken(ctx, provider) {
       return ctx.token;
   }
 }
+var CustomerRefreshRegistry = class {
+  refresher = null;
+  inflight = null;
+  set(refresher) {
+    this.refresher = refresher;
+  }
+  get enabled() {
+    return this.refresher !== null;
+  }
+  /** Concurrent callers share one in-flight refresh. */
+  refresh(expiredToken) {
+    if (!this.refresher) return Promise.resolve(null);
+    if (this.inflight) return this.inflight;
+    const p = Promise.resolve(this.refresher.refresh(expiredToken)).finally(() => {
+      this.inflight = null;
+    });
+    this.inflight = p;
+    return p;
+  }
+};
 var DefaultTokenProvider = class {
   constructor(cfg) {
     this.cfg = cfg;
@@ -567,8 +587,10 @@ var HttpClient = class {
     const sdkManaged = o.auth.kind === "service" || o.auth.kind === "anonymous";
     const maxAttempts = this.opts.retry.maxAttempts;
     let reauthed = false;
+    let customerToken = o.auth.kind === "customer" ? o.auth.token : void 0;
+    let customerReauthed = false;
     for (let attempt = 1; ; attempt++) {
-      const token = await resolveToken(o.auth, this.opts.provider);
+      const token = customerToken ?? await resolveToken(o.auth, this.opts.provider);
       log.debug("http request", {
         authKind: o.auth.kind,
         method: o.method,
@@ -620,6 +642,15 @@ var HttpClient = class {
           log.warn("sdk-managed 401, re-authing once", { authKind: o.auth.kind });
           continue;
         }
+        if (o.auth.kind === "customer" && !customerReauthed && this.opts.customerRefresh?.enabled) {
+          customerReauthed = true;
+          const fresh = await this.opts.customerRefresh.refresh(customerToken);
+          if (fresh) {
+            customerToken = fresh;
+            log.warn("customer 401, refreshed once", { authKind: o.auth.kind });
+            continue;
+          }
+        }
         throw errorFromResponse(res.status, `${o.method} ${o.path} \u2192 401`, parsed);
       }
       const retryable = res.status >= 500 || res.status === 429;
@@ -4507,8 +4538,442 @@ var UnitHandlingService = class {
   }
 };
 
+// src/services/catalog.ts
+var SERVICE23 = { kind: "service" };
+var CatalogService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/catalog/${this.ctx.tenant}/catalogs`;
+  }
+  /** List catalogs (filtered/sorted). */
+  async listCatalogs(query = {}, auth2 = SERVICE23) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(),
+      auth: auth2,
+      ...Object.keys(query).length ? { query } : {}
+    });
+  }
+  /** Retrieve a catalog by id. */
+  async getCatalog(catalogId, auth2 = SERVICE23) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${encodeURIComponent(catalogId)}`,
+      auth: auth2
+    });
+  }
+  /** Retrieve all catalogs that contain a category. */
+  async getCatalogsForCategory(categoryId, auth2 = SERVICE23) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/categories/${encodeURIComponent(categoryId)}`,
+      auth: auth2
+    });
+  }
+  /** Create a catalog. */
+  async createCatalog(input, auth2 = SERVICE23) {
+    return this.ctx.http.request({ method: "POST", path: this.base(), auth: auth2, body: input });
+  }
+  /** Upsert a catalog by id (`PUT`). */
+  async updateCatalog(catalogId, input, auth2 = SERVICE23) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/${encodeURIComponent(catalogId)}`,
+      auth: auth2,
+      body: input
+    });
+  }
+  /** Partially update a catalog by id (`PATCH`). */
+  async patchCatalog(catalogId, patch, auth2 = SERVICE23) {
+    await this.ctx.http.request({
+      method: "PATCH",
+      path: `${this.base()}/${encodeURIComponent(catalogId)}`,
+      auth: auth2,
+      body: patch
+    });
+  }
+  /** Remove a catalog by id. */
+  async deleteCatalog(catalogId, auth2 = SERVICE23) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${encodeURIComponent(catalogId)}`,
+      auth: auth2
+    });
+  }
+};
+
+// src/services/vendor.ts
+var SERVICE24 = { kind: "service" };
+var VendorService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/vendor/${this.ctx.tenant}`;
+  }
+  // --- Vendors ---
+  /** List all vendors. */
+  async listVendors(query = {}, auth2 = SERVICE24) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/vendors`,
+      auth: auth2,
+      ...Object.keys(query).length ? { query } : {}
+    });
+  }
+  /** Retrieve a vendor by id. */
+  async getVendor(vendorId, auth2 = SERVICE24) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/vendors/${encodeURIComponent(vendorId)}`,
+      auth: auth2
+    });
+  }
+  /** Search vendors (`POST /vendors/search`). */
+  async searchVendors(query, auth2 = SERVICE24) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/vendors/search`,
+      auth: auth2,
+      body: query
+    });
+  }
+  /** Create a vendor. */
+  async createVendor(input, auth2 = SERVICE24) {
+    return this.ctx.http.request({ method: "POST", path: `${this.base()}/vendors`, auth: auth2, body: input });
+  }
+  /** Upsert a vendor by id (`PUT`). */
+  async updateVendor(vendorId, input, auth2 = SERVICE24) {
+    await this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/vendors/${encodeURIComponent(vendorId)}`,
+      auth: auth2,
+      body: input
+    });
+  }
+  /** Delete a vendor by id. */
+  async deleteVendor(vendorId, auth2 = SERVICE24) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/vendors/${encodeURIComponent(vendorId)}`,
+      auth: auth2
+    });
+  }
+  // --- Vendor locations ---
+  /** List all vendor locations. */
+  async listVendorLocations(query = {}, auth2 = SERVICE24) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/locations`,
+      auth: auth2,
+      ...Object.keys(query).length ? { query } : {}
+    });
+  }
+  /** Retrieve a vendor location by id. */
+  async getVendorLocation(locationId, auth2 = SERVICE24) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/locations/${encodeURIComponent(locationId)}`,
+      auth: auth2
+    });
+  }
+  /** Create a vendor location. */
+  async createVendorLocation(input, auth2 = SERVICE24) {
+    return this.ctx.http.request({ method: "POST", path: `${this.base()}/locations`, auth: auth2, body: input });
+  }
+  /** Upsert a vendor location by id (`PUT`). */
+  async updateVendorLocation(locationId, input, auth2 = SERVICE24) {
+    await this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/locations/${encodeURIComponent(locationId)}`,
+      auth: auth2,
+      body: input
+    });
+  }
+  /** Delete a vendor location by id. */
+  async deleteVendorLocation(locationId, auth2 = SERVICE24) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/locations/${encodeURIComponent(locationId)}`,
+      auth: auth2
+    });
+  }
+};
+
+// src/services/pick-pack.ts
+var SERVICE25 = { kind: "service" };
+var PickPackService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/pick-pack/${this.ctx.tenant}`;
+  }
+  orderPath(orderId) {
+    return `${this.base()}/orders/${encodeURIComponent(orderId)}`;
+  }
+  /** List packlist orders. */
+  async listOrders(query = {}, auth2 = SERVICE25) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/orders`,
+      auth: auth2,
+      ...Object.keys(query).length ? { query } : {}
+    });
+  }
+  /** Retrieve a packlist order by id. */
+  async getOrder(orderId, auth2 = SERVICE25) {
+    return this.ctx.http.request({ method: "GET", path: this.orderPath(orderId), auth: auth2 });
+  }
+  /** Update an order's status (`PATCH`). Returns an acknowledgement. */
+  async updateOrder(orderId, change, auth2 = SERVICE25) {
+    return this.ctx.http.request({ method: "PATCH", path: this.orderPath(orderId), auth: auth2, body: change });
+  }
+  /** Finish an order. Returns an acknowledgement. */
+  async finishOrder(orderId, auth2 = SERVICE25) {
+    return this.ctx.http.request({ method: "POST", path: `${this.orderPath(orderId)}/finish`, auth: auth2 });
+  }
+  /** List order cycles (ids). */
+  async listOrderCycles(query = {}, auth2 = SERVICE25) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/orderCycles`,
+      auth: auth2,
+      ...Object.keys(query).length ? { query } : {}
+    });
+  }
+  /** Add an assignee to an order. Returns an acknowledgement. */
+  async addAssignee(orderId, assignee, auth2 = SERVICE25) {
+    return this.ctx.http.request({ method: "POST", path: `${this.orderPath(orderId)}/assignees`, auth: auth2, body: assignee });
+  }
+  /** Remove an assignee from an order. */
+  async removeAssignee(orderId, assigneeId, auth2 = SERVICE25) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.orderPath(orderId)}/assignees/${encodeURIComponent(assigneeId)}`,
+      auth: auth2
+    });
+  }
+  /** Update packaging products for an order (`PUT`). Returns an acknowledgement. */
+  async updatePackaging(orderId, change, auth2 = SERVICE25) {
+    return this.ctx.http.request({ method: "PUT", path: `${this.orderPath(orderId)}/packaging`, auth: auth2, body: change });
+  }
+  /** Create a packing event. Returns an acknowledgement. */
+  async createEvent(event, auth2 = SERVICE25) {
+    return this.ctx.http.request({ method: "POST", path: `${this.base()}/events`, auth: auth2, body: event });
+  }
+  /** List packing events. */
+  async listEvents(query = {}, auth2 = SERVICE25) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/events`,
+      auth: auth2,
+      ...Object.keys(query).length ? { query } : {}
+    });
+  }
+  /** Trigger an order recalculation. Returns the created job's id. */
+  async triggerRecalculation(input, auth2 = SERVICE25) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/jobs/recalculations`,
+      auth: auth2,
+      body: input
+    });
+  }
+  /** Retrieve a recalculation job by id. */
+  async getRecalculationJob(jobId, auth2 = SERVICE25) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/jobs/recalculations/${encodeURIComponent(jobId)}`,
+      auth: auth2
+    });
+  }
+};
+
+// src/services/customer-admin.ts
+var SERVICE26 = { kind: "service" };
+var CustomerAdminService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/customer/${this.ctx.tenant}/customers`;
+  }
+  customerPath(customerNumber) {
+    return `${this.base()}/${encodeURIComponent(customerNumber)}`;
+  }
+  addressPath(customerNumber, addressId) {
+    return `${this.customerPath(customerNumber)}/addresses/${encodeURIComponent(addressId)}`;
+  }
+  // --- Customers ---
+  /** List customers. */
+  async listCustomers(query = {}, auth2 = SERVICE26) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(),
+      auth: auth2,
+      ...Object.keys(query).length ? { query } : {}
+    });
+  }
+  /** Search customers (`POST /customers/search`). */
+  async searchCustomers(query, auth2 = SERVICE26) {
+    return this.ctx.http.request({ method: "POST", path: `${this.base()}/search`, auth: auth2, body: query });
+  }
+  /** Retrieve a customer profile by number. */
+  async getCustomer(customerNumber, auth2 = SERVICE26) {
+    return this.ctx.http.request({ method: "GET", path: this.customerPath(customerNumber), auth: auth2 });
+  }
+  /** Create a customer. */
+  async createCustomer(input, auth2 = SERVICE26) {
+    return this.ctx.http.request({ method: "POST", path: this.base(), auth: auth2, body: input });
+  }
+  /** Upsert a customer profile by number (`PUT`). */
+  async upsertCustomer(customerNumber, input, auth2 = SERVICE26) {
+    return this.ctx.http.request({ method: "PUT", path: this.customerPath(customerNumber), auth: auth2, body: input });
+  }
+  /** Partially update a customer profile (`PATCH`). */
+  async patchCustomer(customerNumber, patch, auth2 = SERVICE26) {
+    await this.ctx.http.request({ method: "PATCH", path: this.customerPath(customerNumber), auth: auth2, body: patch });
+  }
+  /** Delete a customer profile. */
+  async deleteCustomer(customerNumber, auth2 = SERVICE26) {
+    await this.ctx.http.request({ method: "DELETE", path: this.customerPath(customerNumber), auth: auth2 });
+  }
+  // --- Addresses ---
+  /** List a customer's addresses. */
+  async listAddresses(customerNumber, auth2 = SERVICE26) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.customerPath(customerNumber)}/addresses`,
+      auth: auth2
+    });
+  }
+  /** Retrieve one address. */
+  async getAddress(customerNumber, addressId, auth2 = SERVICE26) {
+    return this.ctx.http.request({ method: "GET", path: this.addressPath(customerNumber, addressId), auth: auth2 });
+  }
+  /** Add an address. */
+  async addAddress(customerNumber, input, auth2 = SERVICE26) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.customerPath(customerNumber)}/addresses`,
+      auth: auth2,
+      body: input
+    });
+  }
+  /** Upsert an address by id (`PUT`). */
+  async upsertAddress(customerNumber, addressId, input, auth2 = SERVICE26) {
+    return this.ctx.http.request({ method: "PUT", path: this.addressPath(customerNumber, addressId), auth: auth2, body: input });
+  }
+  /** Partially update an address by id (`PATCH`). */
+  async patchAddress(customerNumber, addressId, patch, auth2 = SERVICE26) {
+    await this.ctx.http.request({ method: "PATCH", path: this.addressPath(customerNumber, addressId), auth: auth2, body: patch });
+  }
+  /** Delete an address by id. */
+  async deleteAddress(customerNumber, addressId, auth2 = SERVICE26) {
+    await this.ctx.http.request({ method: "DELETE", path: this.addressPath(customerNumber, addressId), auth: auth2 });
+  }
+  /** Add tags to an address (`?tags=` query). */
+  async addAddressTags(customerNumber, addressId, tags, auth2 = SERVICE26) {
+    await this.ctx.http.request({
+      method: "POST",
+      path: `${this.addressPath(customerNumber, addressId)}/tags`,
+      auth: auth2,
+      query: { tags: tags.join(",") }
+    });
+  }
+  /** Remove tags from an address (`?tags=` query). */
+  async removeAddressTags(customerNumber, addressId, tags, auth2 = SERVICE26) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.addressPath(customerNumber, addressId)}/tags`,
+      auth: auth2,
+      query: { tags: tags.join(",") }
+    });
+  }
+};
+
+// src/services/approval.ts
+var SERVICE27 = { kind: "service" };
+var ApprovalService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/approval/${this.ctx.tenant}`;
+  }
+  /** List approvals (paged via `pageNumber`/`pageSize`/`sort`/`q`). Returns an array. */
+  async listApprovals(query = {}, auth2 = SERVICE27) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/approvals`,
+      auth: auth2,
+      ...Object.keys(query).length ? { query } : {}
+    });
+  }
+  /** Retrieve a single approval by id. */
+  async getApproval(approvalId, auth2 = SERVICE27) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/approvals/${encodeURIComponent(approvalId)}`,
+      auth: auth2
+    });
+  }
+  /** Create an approval request (cart or quote). Returns the created `{ id }`. */
+  async createApproval(input, auth2 = SERVICE27) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/approvals`,
+      auth: auth2,
+      body: input
+    });
+  }
+  /** Approve/reject/amend an approval via a JSON-Patch op-array (`PATCH`). */
+  async updateApproval(approvalId, ops, auth2 = SERVICE27) {
+    await this.ctx.http.request({
+      method: "PATCH",
+      path: `${this.base()}/approvals/${encodeURIComponent(approvalId)}`,
+      auth: auth2,
+      body: ops
+    });
+  }
+  /** Delete an approval by id. */
+  async deleteApproval(approvalId, auth2 = SERVICE27) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/approvals/${encodeURIComponent(approvalId)}`,
+      auth: auth2
+    });
+  }
+  /** Check whether an operation on a resource is permitted / needs approval. */
+  async checkPermitted(input, auth2 = SERVICE27) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/approval/permitted`,
+      auth: auth2,
+      body: input
+    });
+  }
+  /** Search for users eligible to approve a resource. Returns an array. */
+  async searchApprovers(input, auth2 = SERVICE27) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/search/users`,
+      auth: auth2,
+      body: input
+    });
+  }
+};
+
 // package.json
-var version = "2.4.0";
+var version = "2.6.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -4554,6 +5019,11 @@ var EmporixClient = class {
   sepaExport;
   indexing;
   units;
+  catalogs;
+  vendors;
+  pickPack;
+  customerAdmin;
+  approvals;
   /** The validated tenant this client is bound to. */
   tenant;
   /**
@@ -4570,6 +5040,7 @@ var EmporixClient = class {
    */
   config;
   resolver;
+  customerRefresh;
   constructor(config) {
     const cfg = validateConfig(config);
     this.tenant = cfg.tenant;
@@ -4591,6 +5062,8 @@ var EmporixClient = class {
     });
     const tokenProvider = cfg.tokenProvider ?? new DefaultTokenProvider(cfg);
     this.tokenProvider = tokenProvider;
+    const customerRefresh = new CustomerRefreshRegistry();
+    this.customerRefresh = customerRefresh;
     const mk = (service) => ({
       tenant: cfg.tenant,
       tokenProvider,
@@ -4600,7 +5073,8 @@ var EmporixClient = class {
         provider: tokenProvider,
         logger: root.child({ service: "http" }),
         retry: cfg.retry,
-        timeouts: cfg.timeouts
+        timeouts: cfg.timeouts,
+        customerRefresh
       })
     });
     this.customers = new CustomerService(mk("customer"));
@@ -4645,6 +5119,11 @@ var EmporixClient = class {
     this.sepaExport = new SepaExportService(mk("sepa-export"));
     this.indexing = new IndexingService(mk("indexing"));
     this.units = new UnitHandlingService(mk("unit-handling"));
+    this.catalogs = new CatalogService(mk("catalog"));
+    this.vendors = new VendorService(mk("vendor"));
+    this.pickPack = new PickPackService(mk("pick-pack"));
+    this.customerAdmin = new CustomerAdminService(mk("customer-admin"));
+    this.approvals = new ApprovalService(mk("approval"));
   }
   /** Sets the runtime log level globally or for one service. */
   setLogLevel(level, opts = {}) {
@@ -4654,12 +5133,23 @@ var EmporixClient = class {
   getLogLevel(service) {
     return this.resolver.get(service);
   }
+  /**
+   * Registers (or clears with `null`) a customer-token refresher. When set, a
+   * `customer`-kind 401 triggers one refresh-and-retry. Off by default — the
+   * customer token stays caller-owned. The React `EmporixProvider` wires this
+   * automatically via `autoRefreshCustomerToken`.
+   */
+  setCustomerTokenRefresher(refresher) {
+    this.customerRefresh.set(refresher);
+  }
 };
 
 exports.AiService = AiService;
+exports.ApprovalService = ApprovalService;
 exports.AvailabilityService = AvailabilityService;
 exports.BrandService = BrandService;
 exports.CartService = CartService;
+exports.CatalogService = CatalogService;
 exports.CategoryService = CategoryService;
 exports.CheckoutService = CheckoutService;
 exports.ClientConfigService = ClientConfigService;
@@ -4668,7 +5158,9 @@ exports.ContactsService = ContactsService;
 exports.CountryService = CountryService;
 exports.CouponService = CouponService;
 exports.CurrencyService = CurrencyService;
+exports.CustomerAdminService = CustomerAdminService;
 exports.CustomerGroupsService = CustomerGroupsService;
+exports.CustomerRefreshRegistry = CustomerRefreshRegistry;
 exports.CustomerService = CustomerService;
 exports.DEFAULT_HOST = DEFAULT_HOST;
 exports.DefaultTokenProvider = DefaultTokenProvider;
@@ -4690,6 +5182,7 @@ exports.LocationsService = LocationsService;
 exports.MediaService = MediaService;
 exports.OrdersService = OrdersService;
 exports.PaymentGatewayService = PaymentGatewayService;
+exports.PickPackService = PickPackService;
 exports.PriceService = PriceService;
 exports.ProductService = ProductService;
 exports.RagIndexerService = RagIndexerService;
@@ -4707,6 +5200,7 @@ exports.SiteService = SiteService;
 exports.TaxService = TaxService;
 exports.TenantConfigService = TenantConfigService;
 exports.UnitHandlingService = UnitHandlingService;
+exports.VendorService = VendorService;
 exports.WebhookService = WebhookService;
 exports.auth = auth;
 exports.createConsoleLogger = createConsoleLogger;