@viu/emporix-sdk 1.0.0

package/dist/checkout.d.ts

@@ -0,0 +1,252 @@
+import { C as ClientContext, b as AuthContext } from './context-vKgzZ-5f.js';
+
+/**
+ * Information about the customer's address.
+ */
+type AddressJson = {
+    /**
+     * Contact name
+     */
+    contactName: string;
+    /**
+     * Company name
+     */
+    companyName?: string;
+    /**
+     * Street
+     */
+    street: string;
+    /**
+     * Street number
+     */
+    streetNumber?: string;
+    /**
+     * Street appendix
+     */
+    streetAppendix?: string;
+    /**
+     * zip code
+     */
+    zipCode: string;
+    /**
+     * City
+     */
+    city: string;
+    /**
+     * Country
+     */
+    country: string;
+    /**
+     * State
+     */
+    state?: string;
+    /**
+     * Contact phone
+     */
+    contactPhone?: string;
+    /**
+     * Type of the address data, for example `BILLING` or `SHIPPING`.
+     */
+    type: string;
+    metadata?: MixinMetadataJson;
+    /**
+     * Mixins object
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Information about the customer.
+ */
+type CustomerJson = {
+    /**
+     * Customers’s unique identifier generated when a customer’s account is created. Required only when checkout is done by a logged in customer.
+     */
+    id?: string;
+    /**
+     * Name
+     */
+    name?: string;
+    /**
+     * Title
+     */
+    title?: string;
+    /**
+     * First name. Providing either `firstName` or `lastName` is required.
+     */
+    firstName?: string;
+    /**
+     * Middle name
+     */
+    middleName?: string;
+    /**
+     * Last name. Providing either `firstName` or `lastName` is required.
+     */
+    lastName?: string;
+    /**
+     * Contact phone
+     */
+    contactPhone?: string;
+    /**
+     * Email
+     */
+    email: string;
+    /**
+     * Company name
+     */
+    company?: string;
+    metadata?: MixinMetadataJson;
+    /**
+     * Mixins object
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Indicates if the checkout is done by an anonymous customer (if true) or logged in customer (if false). Required only for guest checkout.
+     */
+    guest?: boolean;
+};
+type MixinMetadataJson = {
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Schema for triggering a checkout.
+ */
+type RequestCheckout = {
+    /**
+     * Customer cart’s unique identifier generated when a cart is created.
+     */
+    cartId: string;
+    /**
+     * Methods chosen to process the payment for the order.
+     */
+    paymentMethods: Array<RequestPaymentMethodJson>;
+    /**
+     * Three-letter currency code, compliant with the ISO 4217 standard.
+     */
+    currency?: string;
+    shipping: ShippingJson;
+    /**
+     * List of addresses associated with the order. There must be at least one address of type `SHIPPING` and one address of type `BILLING`.
+     */
+    addresses: Array<AddressJson>;
+    customer: CustomerJson;
+};
+/**
+ * Schema for triggering a checkout from the quote.
+ */
+type RequestFromQuoteCheckout = {
+    /**
+     * The identifier of the quote.
+     */
+    quoteId: string;
+    /**
+     * Methods chosen to process the payment for the order.
+     */
+    paymentMethods: Array<RequestPaymentMethodJson>;
+    /**
+     * Delivery window's unique identifier.
+     */
+    deliveryWindowId?: string;
+};
+type RequestPaymentMethodJson = {
+    /**
+     * Payment provider, possible values:
+     * * `payment-gateway` - When the Emporix Payment-Gateway service should be used to handle a payment. For details about custom attributes that are required for a particular payment mode, check https://developer.emporix.io/user-guides/system-management/payment-gateway/payments.
+     * * `custom` - When a custom provider is used. In this case the created order has the `IN_CHECKOUT` status.
+     * * `none` - For payment by cash or invoice.
+     *
+     */
+    provider: string;
+    /**
+     * Additional information about the payment method.
+     */
+    customAttributes?: {
+        /**
+         * Payment token used for the tokenized credit card flows. The field is used when provider type is `payment-gateway`. For more details, check https://developer.emporix.io/user-guides/system-management/payment-gateway/payments
+         */
+        token?: string;
+        /**
+         * Identifier of a payment mode. The payment mode has to be configured in the Emporix Payment Gateway service beforehand. For more details, check https://developer.emporix.io/user-guides/system-management/payment-gateway/payments
+         */
+        modeId?: string;
+        /**
+         * Payment type chosen by the customer, for example `paymentByCredit` or `paymentByDebit`.
+         */
+        paymentType?: string;
+    };
+    /**
+     * Payment method chosen by the customer, for example `invoice` or `cash-on-delivery`.
+     */
+    method?: string;
+    /**
+     * Amount to be paid by the customer.
+     */
+    amount?: number;
+};
+type ResponseCheckout = {
+    /**
+     * Order’s unique identifier generated when a checkout is triggered.
+     */
+    orderId?: string;
+    paymentDetails?: {
+        [key: string]: unknown;
+    } | null;
+    checkoutId?: string | null;
+};
+/**
+ * Information about the shipping.
+ */
+type ShippingJson = {
+    /**
+     * Shipping method's unique identifier.
+     */
+    methodId: string;
+    /**
+     * Shipping zone identifier.
+     */
+    zoneId: string;
+    /**
+     * Shipping method chosen by the customer.
+     */
+    methodName: string;
+    /**
+     * Shipping cost.
+     */
+    amount: number;
+    /**
+     * The tax code of the shipping
+     */
+    shippingTaxCode?: string;
+};
+
+/** `requestCheckout` body (cart-based, generated). */
+type CheckoutInput = RequestCheckout;
+/** `requestFromQuoteCheckout` body (quote-based, generated). */
+type QuoteCheckoutInput = RequestFromQuoteCheckout;
+/** `responseCheckout` — the full generated checkout response. */
+type CheckoutResult = ResponseCheckout;
+/** Options for a checkout call. */
+interface CheckoutOptions {
+    /** Customer `saasToken` from `customers.login()` — required for logged-in checkout. */
+    saasToken?: string;
+    /** Site code (`?siteCode=`). */
+    siteCode?: string;
+}
+/** Triggers Emporix checkout (atomic: validate → order → payment → close cart). */
+declare class CheckoutService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private headers;
+    private query;
+    /** Checkout from a cart. Requires customer/raw auth (or anonymous for guest). */
+    placeOrder(input: CheckoutInput, auth?: AuthContext, opts?: CheckoutOptions): Promise<CheckoutResult>;
+    /** Checkout from a quote. */
+    placeOrderFromQuote(input: QuoteCheckoutInput, auth?: AuthContext, opts?: CheckoutOptions): Promise<CheckoutResult>;
+}
+
+export { type CheckoutInput, type CheckoutOptions, type CheckoutResult, CheckoutService, type QuoteCheckoutInput };

package/dist/checkout.js

@@ -0,0 +1,4 @@
+export { CheckoutService } from './chunk-OMYVOOSX.js';
+import './chunk-KTODT6DV.js';
+//# sourceMappingURL=checkout.js.map
+//# sourceMappingURL=checkout.js.map

package/dist/checkout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"checkout.js"}

package/dist/chunk-4BJUCCKJ.js

@@ -0,0 +1,86 @@
+import { iterateAll } from './chunk-GWJ2U2CP.js';
+
+// src/services/category.ts
+var ANON = { kind: "anonymous" };
+var CategoryService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  /** Fetches one category by id. */
+  async get(categoryId, auth = ANON) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `/category/${this.ctx.tenant}/categories/${categoryId}`,
+      auth
+    });
+  }
+  /** One page of categories. */
+  async list(params = {}, auth = ANON) {
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/category/${this.ctx.tenant}/categories`,
+      query: { pageNumber, pageSize },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  /** Async-iterates every category across pages. */
+  listAll(params = {}, auth = ANON) {
+    const pageSize = params.pageSize ?? 50;
+    return iterateAll((pageNumber) => this.list({ pageNumber, pageSize }, auth));
+  }
+  /** Fetches the category tree, optionally rooted at `rootId`. */
+  async tree(rootId, auth = ANON) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `/category/${this.ctx.tenant}/categories/tree`,
+      query: rootId ? { rootId } : {},
+      auth
+    });
+  }
+  /** One page of products in a category. */
+  async productsIn(categoryId, params = {}, auth = ANON) {
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/category/${this.ctx.tenant}/categories/${categoryId}/products`,
+      query: { pageNumber, pageSize },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  /**
+   * Bulk fetch by id. POSTs `/categories/search` with `q="id:(id1,id2,…)"`,
+   * chunking when the list is larger than `options.chunkSize` (default
+   * 100). An empty list short-circuits with no HTTP call. **Order is not
+   * guaranteed** across chunks — re-index by `id` if order matters.
+   */
+  async searchByIds(ids, options = {}, auth = ANON) {
+    if (ids.length === 0) return [];
+    const chunkSize = options.chunkSize ?? 100;
+    const chunks = [];
+    for (let i = 0; i < ids.length; i += chunkSize) {
+      chunks.push(ids.slice(i, i + chunkSize));
+    }
+    const pages = await Promise.all(
+      chunks.map(
+        (chunk) => this.ctx.http.request({
+          method: "POST",
+          path: `/category/${this.ctx.tenant}/categories/search`,
+          query: { pageSize: chunk.length },
+          auth,
+          body: { q: `id:(${chunk.join(",")})` }
+        })
+      )
+    );
+    return pages.flat();
+  }
+};
+
+export { CategoryService };
+//# sourceMappingURL=chunk-4BJUCCKJ.js.map
+//# sourceMappingURL=chunk-4BJUCCKJ.js.map

package/dist/chunk-4BJUCCKJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/category.ts"],"names":[],"mappings":";;;AAMA,IAAM,IAAA,GAAoB,EAAE,IAAA,EAAM,WAAA,EAAY;AASvC,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAA6B,GAAA,EAAoB;AAApB,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAAA,EAAqB;AAAA,EAArB,GAAA;AAAA;AAAA,EAG7B,MAAM,GAAA,CAAI,UAAA,EAAoB,IAAA,GAAoB,IAAA,EAAyB;AACzE,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAkB;AAAA,MACrC,MAAA,EAAQ,KAAA;AAAA,MACR,MAAM,CAAA,UAAA,EAAa,IAAA,CAAK,GAAA,CAAI,MAAM,eAAe,UAAU,CAAA,CAAA;AAAA,MAC3D;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,IAAA,CACJ,MAAA,GAAqD,EAAC,EACtD,OAAoB,IAAA,EACe;AACnC,IAAA,MAAM,UAAA,GAAa,OAAO,UAAA,IAAc,CAAA;AACxC,IAAA,MAAM,QAAA,GAAW,OAAO,QAAA,IAAY,EAAA;AACpC,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,GAAA,CAAI,KAAK,OAAA,CAAoB;AAAA,MACpD,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,CAAA,UAAA,EAAa,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,WAAA,CAAA;AAAA,MAClC,KAAA,EAAO,EAAE,UAAA,EAAY,QAAA,EAAS;AAAA,MAC9B;AAAA,KACD,CAAA;AACD,IAAA,OAAO,EAAE,KAAA,EAAO,UAAA,EAAY,UAAU,WAAA,EAAa,KAAA,CAAM,WAAW,QAAA,EAAS;AAAA,EAC/E;AAAA;AAAA,EAGA,OAAA,CAAQ,MAAA,GAAgC,EAAC,EAAG,OAAoB,IAAA,EAA+B;AAC7F,IAAA,MAAM,QAAA,GAAW,OAAO,QAAA,IAAY,EAAA;AACpC,IAAA,OAAO,UAAA,CAAqB,CAAC,UAAA,KAAe,IAAA,CAAK,IAAA,CAAK,EAAE,UAAA,EAAY,QAAA,EAAS,EAAG,IAAI,CAAC,CAAA;AAAA,EACvF;AAAA;AAAA,EAGA,MAAM,IAAA,CAAK,MAAA,EAAiB,IAAA,GAAoB,IAAA,EAA6B;AAC3E,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAsB;AAAA,MACzC,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,CAAA,UAAA,EAAa,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,gBAAA,CAAA;AAAA,MAClC,KAAA,EAAO,MAAA,GAAS,EAAE,MAAA,KAAW,EAAC;AAAA,MAC9B;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,UAAA,CACJ,UAAA,EACA,SAAqD,EAAC,EACtD,OAAoB,IAAA,EACc;AAClC,IAAA,MAAM,UAAA,GAAa,OAAO,UAAA,IAAc,CAAA;AACxC,IAAA,MAAM,QAAA,GAAW,OAAO,QAAA,IAAY,EAAA;AACpC,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,GAAA,CAAI,KAAK,OAAA,CAAmB;AAAA,MACnD,MAAA,EAAQ,KAAA;AAAA,MACR,MAAM,CAAA,UAAA,EAAa,IAAA,CAAK,GAAA,CAAI,MAAM,eAAe,UAAU,CAAA,SAAA,CAAA;AAAA,MAC3D,KAAA,EAAO,EAAE,UAAA,EAAY,QAAA,EAAS;AAAA,MAC9B;AAAA,KACD,CAAA;AACD,IAAA,OAAO,EAAE,KAAA,EAAO,UAAA,EAAY,UAAU,WAAA,EAAa,KAAA,CAAM,WAAW,QAAA,EAAS;AAAA,EAC/E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,WAAA,CACJ,GAAA,EACA,UAAkC,EAAC,EACnC,OAAoB,IAAA,EACC;AACrB,IAAA,IAAI,GAAA,CAAI,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAC9B,IAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,GAAA;AACvC,IAAA,MAAM,SAAqB,EAAC;AAC5B,IAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,MAAA,EAAQ,KAAK,SAAA,EAAW;AAC9C,MAAA,MAAA,CAAO,KAAK,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,CAAA,GAAI,SAAS,CAAC,CAAA;AAAA,IACzC;AACA,IAAA,MAAM,KAAA,GAAQ,MAAM,OAAA,CAAQ,GAAA;AAAA,MAC1B,MAAA,CAAO,GAAA;AAAA,QAAI,CAAC,KAAA,KACV,IAAA,CAAK,GAAA,CAAI,KAAK,OAAA,CAAoB;AAAA,UAChC,MAAA,EAAQ,MAAA;AAAA,UACR,IAAA,EAAM,CAAA,UAAA,EAAa,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,kBAAA,CAAA;AAAA,UAClC,KAAA,EAAO,EAAE,QAAA,EAAU,KAAA,CAAM,MAAA,EAAO;AAAA,UAChC,IAAA;AAAA,UACA,IAAA,EAAM,EAAE,CAAA,EAAG,CAAA,IAAA,EAAO,MAAM,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA,CAAA;AAAI,SACtC;AAAA;AACH,KACF;AACA,IAAA,OAAO,MAAM,IAAA,EAAK;AAAA,EACpB;AACF","file":"chunk-4BJUCCKJ.js","sourcesContent":["import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport { iterateAll } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type { Product } from \"./product\";\nimport type { Category as GeneratedCategory, CategoryTree } from \"../generated/category\";\n\nconst ANON: AuthContext = { kind: \"anonymous\" };\n\n/** A category as returned by the Category service (all generated fields). */\nexport type Category = GeneratedCategory;\n\n/** The category tree as returned by the Category service. */\nexport type CategoryNode = CategoryTree;\n\n/** Category reads. Default auth: anonymous. */\nexport class CategoryService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  /** Fetches one category by id. */\n  async get(categoryId: string, auth: AuthContext = ANON): Promise<Category> {\n    return this.ctx.http.request<Category>({\n      method: \"GET\",\n      path: `/category/${this.ctx.tenant}/categories/${categoryId}`,\n      auth,\n    });\n  }\n\n  /** One page of categories. */\n  async list(\n    params: { pageNumber?: number; pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Category>> {\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Category[]>({\n      method: \"GET\",\n      path: `/category/${this.ctx.tenant}/categories`,\n      query: { pageNumber, pageSize },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  /** Async-iterates every category across pages. */\n  listAll(params: { pageSize?: number } = {}, auth: AuthContext = ANON): AsyncIterable<Category> {\n    const pageSize = params.pageSize ?? 50;\n    return iterateAll<Category>((pageNumber) => this.list({ pageNumber, pageSize }, auth));\n  }\n\n  /** Fetches the category tree, optionally rooted at `rootId`. */\n  async tree(rootId?: string, auth: AuthContext = ANON): Promise<CategoryNode> {\n    return this.ctx.http.request<CategoryNode>({\n      method: \"GET\",\n      path: `/category/${this.ctx.tenant}/categories/tree`,\n      query: rootId ? { rootId } : {},\n      auth,\n    });\n  }\n\n  /** One page of products in a category. */\n  async productsIn(\n    categoryId: string,\n    params: { pageNumber?: number; pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Product>> {\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Product[]>({\n      method: \"GET\",\n      path: `/category/${this.ctx.tenant}/categories/${categoryId}/products`,\n      query: { pageNumber, pageSize },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  /**\n   * Bulk fetch by id. POSTs `/categories/search` with `q=\"id:(id1,id2,…)\"`,\n   * chunking when the list is larger than `options.chunkSize` (default\n   * 100). An empty list short-circuits with no HTTP call. **Order is not\n   * guaranteed** across chunks — re-index by `id` if order matters.\n   */\n  async searchByIds(\n    ids: string[],\n    options: { chunkSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<Category[]> {\n    if (ids.length === 0) return [];\n    const chunkSize = options.chunkSize ?? 100;\n    const chunks: string[][] = [];\n    for (let i = 0; i < ids.length; i += chunkSize) {\n      chunks.push(ids.slice(i, i + chunkSize));\n    }\n    const pages = await Promise.all(\n      chunks.map((chunk) =>\n        this.ctx.http.request<Category[]>({\n          method: \"POST\",\n          path: `/category/${this.ctx.tenant}/categories/search`,\n          query: { pageSize: chunk.length },\n          auth,\n          body: { q: `id:(${chunk.join(\",\")})` },\n        }),\n      ),\n    );\n    return pages.flat();\n  }\n}\n"]}

package/dist/chunk-6UNFMCHZ.js

@@ -0,0 +1,95 @@
+// src/services/orders.ts
+function setIfDefined(q, key, value) {
+  if (value !== void 0 && value !== "") {
+    q[key] = value;
+  }
+}
+var OrdersService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/order-v2/${this.ctx.tenant}/orders`;
+  }
+  saasHeader(saasToken) {
+    return saasToken ? { "saas-token": saasToken } : void 0;
+  }
+  /** Lists the calling customer's orders. */
+  async listMine(auth, opts = {}) {
+    const query = {};
+    setIfDefined(query, "pageNumber", opts.pageNumber);
+    setIfDefined(query, "pageSize", opts.pageSize);
+    setIfDefined(query, "status", opts.status);
+    setIfDefined(query, "legalEntityId", opts.legalEntityId);
+    setIfDefined(query, "siteCode", opts.siteCode);
+    const headers = this.saasHeader(opts.saasToken);
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(),
+      query,
+      auth,
+      ...headers ? { headers } : {}
+    });
+  }
+  /** Fetches one of the calling customer's orders by id. */
+  async get(orderId, auth, opts = {}) {
+    const headers = this.saasHeader(opts.saasToken);
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${orderId}`,
+      auth,
+      ...headers ? { headers } : {}
+    });
+  }
+  /** Transitions an order to a new status. Server enforces legal transitions. */
+  async transition(orderId, status, auth, opts = {}) {
+    const body = { status };
+    if (opts.comment !== void 0) body.comment = opts.comment;
+    const headers = this.saasHeader(opts.saasToken);
+    await this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/${orderId}/transitions`,
+      auth,
+      body,
+      ...headers ? { headers } : {}
+    });
+  }
+  /** Convenience: transitions to `DECLINED` (customer cancel). */
+  async cancel(orderId, auth, opts = {}) {
+    await this.transition(orderId, "DECLINED", auth, opts);
+  }
+};
+var SalesOrdersService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/order-v2/${this.ctx.tenant}/salesorders`;
+  }
+  /** Fetches a single sales-order by id. */
+  async get(orderId, auth) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${orderId}`,
+      auth
+    });
+  }
+  /** Patches an existing order (status, mixins, customAttributes, metadata). */
+  async update(orderId, patch, auth, opts = {}) {
+    const query = {};
+    if (opts.recalculate === false) query.recalculate = "false";
+    return this.ctx.http.request({
+      method: "PATCH",
+      path: `${this.base()}/${orderId}`,
+      auth,
+      ...Object.keys(query).length > 0 ? { query } : {},
+      body: patch
+    });
+  }
+};
+
+export { OrdersService, SalesOrdersService };
+//# sourceMappingURL=chunk-6UNFMCHZ.js.map
+//# sourceMappingURL=chunk-6UNFMCHZ.js.map

package/dist/chunk-6UNFMCHZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/orders.ts"],"names":[],"mappings":"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","file":"chunk-6UNFMCHZ.js","sourcesContent":["import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type {\n  Order,\n  OrderStatus,\n  SalesOrderPatch,\n} from \"../generated/order-v2\";\n\n/** Optional fields supported by the order-v2 list endpoint. */\nexport interface ListMyOrdersOptions {\n  pageNumber?: number;\n  pageSize?: number;\n  status?: OrderStatus;\n  legalEntityId?: string;\n  siteCode?: string;\n  saasToken?: string;\n}\n\n/** Options for single-order reads (saas-token only). */\nexport interface GetOrderOptions {\n  saasToken?: string;\n}\n\n/** Options for status transitions. */\nexport interface OrderTransitionOptions {\n  saasToken?: string;\n  comment?: string;\n}\n\n/** Options for `salesOrders.update`. */\nexport interface UpdateSalesOrderOptions {\n  /** Forwarded as `?recalculate=`. Omit to use the server default (true). */\n  recalculate?: boolean;\n}\n\nfunction setIfDefined<V>(\n  q: Record<string, string | number | undefined>,\n  key: string,\n  value: V | undefined,\n): void {\n  if (value !== undefined && value !== \"\") {\n    q[key] = value as unknown as string | number;\n  }\n}\n\n/**\n * Storefront-customer access to Order-v2's customer endpoints.\n *\n * `listMine`/`get` require `order.order_read_own`; transitions require\n * `order.order_manage_own`. All methods accept an optional `saasToken` that\n * is passed as the `saas-token` header (mirrors `checkout.placeOrder`).\n */\nexport class OrdersService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  private base(): string {\n    return `/order-v2/${this.ctx.tenant}/orders`;\n  }\n\n  private saasHeader(saasToken: string | undefined): Record<string, string> | undefined {\n    return saasToken ? { \"saas-token\": saasToken } : undefined;\n  }\n\n  /** Lists the calling customer's orders. */\n  async listMine(\n    auth: AuthContext,\n    opts: ListMyOrdersOptions = {},\n  ): Promise<PaginatedItems<Order>> {\n    const query: Record<string, string | number | undefined> = {};\n    setIfDefined(query, \"pageNumber\", opts.pageNumber);\n    setIfDefined(query, \"pageSize\", opts.pageSize);\n    setIfDefined(query, \"status\", opts.status);\n    setIfDefined(query, \"legalEntityId\", opts.legalEntityId);\n    setIfDefined(query, \"siteCode\", opts.siteCode);\n    const headers = this.saasHeader(opts.saasToken);\n    return this.ctx.http.request<PaginatedItems<Order>>({\n      method: \"GET\",\n      path: this.base(),\n      query,\n      auth,\n      ...(headers ? { headers } : {}),\n    });\n  }\n\n  /** Fetches one of the calling customer's orders by id. */\n  async get(\n    orderId: string,\n    auth: AuthContext,\n    opts: GetOrderOptions = {},\n  ): Promise<Order> {\n    const headers = this.saasHeader(opts.saasToken);\n    return this.ctx.http.request<Order>({\n      method: \"GET\",\n      path: `${this.base()}/${orderId}`,\n      auth,\n      ...(headers ? { headers } : {}),\n    });\n  }\n\n  /** Transitions an order to a new status. Server enforces legal transitions. */\n  async transition(\n    orderId: string,\n    status: OrderStatus,\n    auth: AuthContext,\n    opts: OrderTransitionOptions = {},\n  ): Promise<void> {\n    const body: { status: OrderStatus; comment?: string } = { status };\n    if (opts.comment !== undefined) body.comment = opts.comment;\n    const headers = this.saasHeader(opts.saasToken);\n    await this.ctx.http.request<void>({\n      method: \"POST\",\n      path: `${this.base()}/${orderId}/transitions`,\n      auth,\n      body,\n      ...(headers ? { headers } : {}),\n    });\n  }\n\n  /** Convenience: transitions to `DECLINED` (customer cancel). */\n  async cancel(\n    orderId: string,\n    auth: AuthContext,\n    opts: { saasToken?: string } = {},\n  ): Promise<void> {\n    await this.transition(orderId, \"DECLINED\", auth, opts);\n  }\n}\n\n/**\n * Backend / service-account access to the merchant-facing\n * `/salesorders/{id}` resource. Requires `order.order_read` (read) /\n * `order.order_manage` (update) scopes on a service token.\n *\n * The full admin list + filter surface is deferred to a follow-up\n * sub-spec. This service ships only single-resource read + patch — the\n * common backend use case (e.g. mixin updates after fulfilment).\n */\nexport class SalesOrdersService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  private base(): string {\n    return `/order-v2/${this.ctx.tenant}/salesorders`;\n  }\n\n  /** Fetches a single sales-order by id. */\n  async get(orderId: string, auth: AuthContext): Promise<Order> {\n    return this.ctx.http.request<Order>({\n      method: \"GET\",\n      path: `${this.base()}/${orderId}`,\n      auth,\n    });\n  }\n\n  /** Patches an existing order (status, mixins, customAttributes, metadata). */\n  async update(\n    orderId: string,\n    patch: SalesOrderPatch,\n    auth: AuthContext,\n    opts: UpdateSalesOrderOptions = {},\n  ): Promise<Order> {\n    const query: Record<string, string> = {};\n    if (opts.recalculate === false) query.recalculate = \"false\";\n    return this.ctx.http.request<Order>({\n      method: \"PATCH\",\n      path: `${this.base()}/${orderId}`,\n      auth,\n      ...(Object.keys(query).length > 0 ? { query } : {}),\n      body: patch,\n    });\n  }\n}\n"]}

package/dist/chunk-B56JZNI7.js

@@ -0,0 +1,49 @@
+// src/services/contacts.ts
+var ContactsService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/customer-management/${this.ctx.tenant}/contact-assignments`;
+  }
+  /** Lists contact assignments for one legal entity. */
+  async listForCompany(legalEntityId, auth) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(),
+      query: { legalEntityId },
+      auth
+    });
+  }
+  /** Creates a contact assignment. */
+  async assign(input, auth) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: this.base(),
+      auth,
+      body: input
+    });
+  }
+  /** Patches a contact assignment. */
+  async update(contactAssignmentId, patch, auth) {
+    return this.ctx.http.request({
+      method: "PATCH",
+      path: `${this.base()}/${contactAssignmentId}`,
+      auth,
+      body: patch
+    });
+  }
+  /** Deletes a contact assignment. */
+  async unassign(contactAssignmentId, auth) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${contactAssignmentId}`,
+      auth
+    });
+  }
+};
+
+export { ContactsService };
+//# sourceMappingURL=chunk-B56JZNI7.js.map
+//# sourceMappingURL=chunk-B56JZNI7.js.map

package/dist/chunk-B56JZNI7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/contacts.ts"],"names":[],"mappings":";AAeO,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAA6B,GAAA,EAAoB;AAApB,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAAA,EAAqB;AAAA,EAArB,GAAA;AAAA,EAErB,IAAA,GAAe;AACrB,IAAA,OAAO,CAAA,qBAAA,EAAwB,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,oBAAA,CAAA;AAAA,EAChD;AAAA;AAAA,EAGA,MAAM,cAAA,CAAe,aAAA,EAAuB,IAAA,EAAiD;AAC3F,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAA6B;AAAA,MAChD,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,KAAK,IAAA,EAAK;AAAA,MAChB,KAAA,EAAO,EAAE,aAAA,EAAc;AAAA,MACvB;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,KAAA,EAAgC,IAAA,EAA4C;AACvF,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAwB;AAAA,MAC3C,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,KAAK,IAAA,EAAK;AAAA,MAChB,IAAA;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAA,CACJ,mBAAA,EACA,KAAA,EACA,IAAA,EAC4B;AAC5B,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAA2B;AAAA,MAC9C,MAAA,EAAQ,OAAA;AAAA,MACR,MAAM,CAAA,EAAG,IAAA,CAAK,IAAA,EAAM,IAAI,mBAAmB,CAAA,CAAA;AAAA,MAC3C,IAAA;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,QAAA,CAAS,mBAAA,EAA6B,IAAA,EAAkC;AAC5E,IAAA,MAAM,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAc;AAAA,MAChC,MAAA,EAAQ,QAAA;AAAA,MACR,MAAM,CAAA,EAAG,IAAA,CAAK,IAAA,EAAM,IAAI,mBAAmB,CAAA,CAAA;AAAA,MAC3C;AAAA,KACD,CAAA;AAAA,EACH;AACF","file":"chunk-B56JZNI7.js","sourcesContent":["import type { ClientContext } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type {\n  ContactAssignment,\n  ContactAssignmentCreate,\n  ContactAssignmentUpdate,\n} from \"../generated/customer-management\";\n\n/**\n * Manages contact assignments linking customers to legal entities.\n *\n * `listForCompany` requires `customermanagement.contactassignment_read`;\n * `assign`/`update`/`unassign` require `_manage`. The query param\n * `legalEntityId` scopes the list to one company.\n */\nexport class ContactsService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  private base(): string {\n    return `/customer-management/${this.ctx.tenant}/contact-assignments`;\n  }\n\n  /** Lists contact assignments for one legal entity. */\n  async listForCompany(legalEntityId: string, auth: AuthContext): Promise<ContactAssignment[]> {\n    return this.ctx.http.request<ContactAssignment[]>({\n      method: \"GET\",\n      path: this.base(),\n      query: { legalEntityId },\n      auth,\n    });\n  }\n\n  /** Creates a contact assignment. */\n  async assign(input: ContactAssignmentCreate, auth: AuthContext): Promise<{ id: string }> {\n    return this.ctx.http.request<{ id: string }>({\n      method: \"POST\",\n      path: this.base(),\n      auth,\n      body: input,\n    });\n  }\n\n  /** Patches a contact assignment. */\n  async update(\n    contactAssignmentId: string,\n    patch: ContactAssignmentUpdate,\n    auth: AuthContext,\n  ): Promise<ContactAssignment> {\n    return this.ctx.http.request<ContactAssignment>({\n      method: \"PATCH\",\n      path: `${this.base()}/${contactAssignmentId}`,\n      auth,\n      body: patch,\n    });\n  }\n\n  /** Deletes a contact assignment. */\n  async unassign(contactAssignmentId: string, auth: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `${this.base()}/${contactAssignmentId}`,\n      auth,\n    });\n  }\n}\n"]}

package/dist/chunk-BFQ732VZ.js

@@ -0,0 +1,11 @@
+import { EmporixAuthError } from './chunk-KTODT6DV.js';
+
+// src/core/require-customer.ts
+function requireCustomer(auth) {
+  if (auth && (auth.kind === "customer" || auth.kind === "raw")) return auth;
+  throw new EmporixAuthError("This operation requires a customer or raw AuthContext");
+}
+
+export { requireCustomer };
+//# sourceMappingURL=chunk-BFQ732VZ.js.map
+//# sourceMappingURL=chunk-BFQ732VZ.js.map

package/dist/chunk-BFQ732VZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/require-customer.ts"],"names":[],"mappings":";;;AASO,SAAS,gBAAgB,IAAA,EAA4C;AAC1E,EAAA,IAAI,SAAS,IAAA,CAAK,IAAA,KAAS,cAAc,IAAA,CAAK,IAAA,KAAS,QAAQ,OAAO,IAAA;AACtE,EAAA,MAAM,IAAI,iBAAiB,uDAAuD,CAAA;AACpF","file":"chunk-BFQ732VZ.js","sourcesContent":["import type { AuthContext } from \"./auth\";\nimport { EmporixAuthError } from \"./errors\";\n\n/**\n * Enforces a caller-owned customer or raw token. Throws `EmporixAuthError`\n * for any other `AuthContext` kind (or when `auth` is missing). Shared by\n * services whose endpoints require a customer scope (`/me`, payments,\n * customer-segments…).\n */\nexport function requireCustomer(auth: AuthContext | undefined): AuthContext {\n  if (auth && (auth.kind === \"customer\" || auth.kind === \"raw\")) return auth;\n  throw new EmporixAuthError(\"This operation requires a customer or raw AuthContext\");\n}\n"]}

package/dist/chunk-F3WAQH2E.js

@@ -0,0 +1,120 @@
+// src/services/media.ts
+var SERVICE = { kind: "service" };
+function isProductRef(r, productId) {
+  return r.type === "PRODUCT" && r.id === productId;
+}
+var MediaService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/media/${this.ctx.tenant}/assets`;
+  }
+  /** Create an asset. BLOB uploads via multipart; LINK via JSON. */
+  async create(input, auth = SERVICE) {
+    if (input.kind === "blob") {
+      const fd = new FormData();
+      fd.set("file", input.file);
+      fd.set("body", JSON.stringify(input.body));
+      return this.ctx.http.request({
+        method: "POST",
+        path: this.base(),
+        auth,
+        body: fd
+      });
+    }
+    return this.ctx.http.request({
+      method: "POST",
+      path: this.base(),
+      auth,
+      body: input.body
+    });
+  }
+  /** List assets. Optional `query` is passed through to Emporix verbatim. */
+  async list(query, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(),
+      auth,
+      ...query ? { query } : {}
+    });
+  }
+  /** Fetch an asset by id. */
+  async get(assetId, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${assetId}`,
+      auth
+    });
+  }
+  /** Update an asset (e.g. swap `refIds` or `access`). */
+  async update(assetId, patch, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/${assetId}`,
+      auth,
+      body: patch
+    });
+  }
+  /** Remove an asset. */
+  async remove(assetId, auth = SERVICE) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${assetId}`,
+      auth
+    });
+  }
+  /** Multipart upload sugar: builds `AssetCreateBlob` from input. */
+  async uploadFile(input, auth = SERVICE) {
+    const body = {
+      type: "BLOB",
+      access: input.access ?? "PUBLIC",
+      ...input.productId ? { refIds: [{ type: "PRODUCT", id: input.productId }] } : {},
+      ...input.filename || input.mimeType ? {
+        details: {
+          ...input.filename ? { filename: input.filename } : {},
+          ...input.mimeType ? { mimeType: input.mimeType } : {}
+        }
+      } : {}
+    };
+    return this.create({ kind: "blob", file: input.file, body }, auth);
+  }
+  /** External-URL sugar: builds `AssetCreateLink`. */
+  async link(input, auth = SERVICE) {
+    const body = {
+      type: "LINK",
+      access: input.access ?? "PUBLIC",
+      url: input.url,
+      ...input.productId ? { refIds: [{ type: "PRODUCT", id: input.productId }] } : {}
+    };
+    return this.create({ kind: "link", body }, auth);
+  }
+  /** Idempotently add a PRODUCT refId to an asset. */
+  async attachToProduct(assetId, productId, auth = SERVICE) {
+    const a = await this.get(assetId, auth);
+    const refIds = a.refIds ?? [];
+    if (refIds.some((r) => isProductRef(r, productId))) return a;
+    const next = [...refIds, { type: "PRODUCT", id: productId }];
+    const patch = { type: a.type, refIds: next };
+    return this.update(assetId, patch, auth);
+  }
+  /** Remove a PRODUCT refId from an asset (no-op if absent). */
+  async detachFromProduct(assetId, productId, auth = SERVICE) {
+    const a = await this.get(assetId, auth);
+    const refIds = a.refIds ?? [];
+    const next = refIds.filter((r) => !isProductRef(r, productId));
+    if (next.length === refIds.length) return a;
+    const patch = { type: a.type, refIds: next };
+    return this.update(assetId, patch, auth);
+  }
+  /** Convenience: list assets attached to a product (server-side filter). */
+  async listForProduct(productId, auth = SERVICE) {
+    return this.list({ "refIds.id": productId }, auth);
+  }
+};
+var _internalMedia = { isProductRef };
+
+export { MediaService, _internalMedia };
+//# sourceMappingURL=chunk-F3WAQH2E.js.map
+//# sourceMappingURL=chunk-F3WAQH2E.js.map