@viu/emporix-sdk 4.0.1 → 4.2.0

package/dist/media.d.ts

@@ -147,6 +147,21 @@ type AssetCreateBlob = Asset$1 & {
      */
     access: 'PUBLIC' | 'PRIVATE';
 };
+/**
+ * Upload Session Request
+ *
+ * Payload for creating a direct-storage upload session.
+ */
+type UploadSessionRequest = AssetCreateBlob & {
+    /**
+     * Upload flow requested for a private Google Cloud Storage asset.
+     * * `put`: Returns a signed `PUT` request. This is the default when the property is omitted.
+     * * `form`: Returns a multipart `POST` policy.
+     * Public Cloudinary assets always use a multipart `POST` form, regardless of this value.
+     *
+     */
+    uploadType?: 'put' | 'form';
+};
 /**
  * Get Asset
  */
@@ -170,6 +185,86 @@ type GetAsset = Asset$1 & {
     details?: AssetDetailsGet;
     metadata?: MetadataGet;
 };
+/**
+ * Upload Session
+ *
+ * Instruction for sending a file directly to storage.
+ */
+type UploadSession = {
+    /**
+     * Unique identifier of the asset, generated when the upload session is created.
+     */
+    id: string;
+    /**
+     * Storage that receives the file.
+     * * `GCS` — private asset. Upload with the returned `PUT` headers or multipart `POST` fields.
+     * * `CLOUDINARY` — public asset. Upload with `POST` and the returned multipart form fields.
+     *
+     */
+    provider: 'GCS' | 'CLOUDINARY';
+    /**
+     * The asset stays `PENDING` until the file is stored.
+     */
+    status: 'PENDING';
+    /**
+     * Date and time when the unused upload session expires. Returned as an ISO-8601 string.
+     */
+    expiresAt: string;
+    /**
+     * The request the caller sends to storage.
+     */
+    upload: {
+        /**
+         * HTTP method of the storage request.
+         */
+        method: 'PUT' | 'POST';
+        /**
+         * Storage URL that receives the file.
+         */
+        url: string;
+        /**
+         * Headers required by a private Google Cloud Storage `PUT` upload. Send every returned header unchanged with the file.
+         * Returned only for the Google Cloud Storage `PUT` flow.
+         *
+         */
+        headers?: {
+            [key: string]: string;
+        };
+        /**
+         * Fields required by a Google Cloud Storage or Cloudinary multipart `POST`. Send every returned field unchanged, then append the file part last.
+         * Google Cloud Storage fields do not include `x-goog-if-generation-match`. Cloudinary fields include `api_key` and `signature` but never include the API secret.
+         *
+         */
+        fields?: {
+            [key: string]: string;
+        };
+    };
+};
+/**
+ * Download URL
+ *
+ * URL that returns the stored file.
+ */
+type DownloadUrl = {
+    /**
+     * Storage that holds the file.
+     * * `GCS` — private blob. The URL is a signed download and includes `expiresAt`.
+     * * `CLOUDINARY` — public blob. The URL is permanent.
+     * * `LINK` — the URL stored on the asset.
+     *
+     */
+    provider: 'GCS' | 'CLOUDINARY' | 'LINK';
+    /**
+     * URL of the stored file.
+     */
+    url: string;
+    /**
+     * Date and time when a private signed URL stops working. Returned as an ISO-8601 string.
+     * Present for `GCS` only.
+     *
+     */
+    expiresAt?: string;
+};
 /**
  * Asset Update Link Payload
  */
@@ -209,6 +304,31 @@ type AssetUpdateBlob = Asset$1 & {
      */
     access: 'PUBLIC' | 'PRIVATE';
 };
+type GetMediaRetrieveDownloadUrlData = {
+    body?: never;
+    path: {
+        /**
+         * The tenant that the caller is acting upon.
+         *
+         * **Note**: The tenant name should always be written in lowercase.
+         *
+         */
+        tenant: string;
+        /**
+         * Unique identifier of an asset.
+         */
+        assetId: string;
+    };
+    query?: {
+        /**
+         * Content disposition for a private Google Cloud Storage signed URL. The default is `attachment`.
+         * The value does not change public Cloudinary or `LINK` URLs.
+         *
+         */
+        disposition?: 'inline' | 'attachment';
+    };
+    url: '/media/{tenant}/assets/{assetId}/download-url';
+};
 
 /** Generated media types (caller sends the exact wire shape). */
 type AssetCreateBlobInput = AssetCreateBlob;
@@ -220,6 +340,14 @@ type Asset = GetAsset;
 type AssetRefId = RefId;
 /** Partial-update body (`PATCH /assets/{id}`) — an RFC-6902 JSON-Patch op-array. */
 type AssetPatch = PatchOperation[];
+/** Result of {@link MediaService.getDownloadUrl} — `{ provider, url, expiresAt? }`. */
+type AssetDownloadUrl = DownloadUrl;
+/** Query for {@link MediaService.getDownloadUrl} — `{ disposition? }`. */
+type AssetDownloadUrlQuery = NonNullable<GetMediaRetrieveDownloadUrlData["query"]>;
+/** Body for {@link MediaService.startUploadSession}: a BLOB create payload plus `uploadType`. */
+type AssetUploadSessionInput = UploadSessionRequest;
+/** The storage instruction {@link MediaService.startUploadSession} returns. */
+type AssetUploadSession = UploadSession;
 /**
  * Filter / pagination options for {@link MediaService.list}. The explicit
  * fields are typed for autocomplete; the index signature stays open so
@@ -246,8 +374,9 @@ interface ListAssetsQuery {
  *   carries the externally-cacheable storage URL — useful when the
  *   storefront wants to send the user there directly.
  * - `PRIVATE` assets respond with the raw bytes (plus an `ETag` header
- *   for caching). The asset is delivered through Cloudinary behind the
- *   server-side service token, never publicly addressable.
+ *   for caching). The file lives in Google Cloud Storage and is reachable
+ *   without the service token only through a signed URL from
+ *   {@link MediaService.getDownloadUrl}.
  */
 type DownloadResult = {
     kind: "redirect";
@@ -268,7 +397,10 @@ declare class MediaService {
     static readonly channel: "media";
     constructor(ctx: ClientContext);
     private base;
-    /** Create an asset. BLOB uploads via multipart; LINK via JSON. */
+    /**
+     * Create an asset. BLOB uploads via multipart (max 30 MB); LINK via JSON.
+     * {@link startUploadSession} sends the file straight to storage instead.
+     */
     create(input: {
         kind: "blob";
         file: Blob;
@@ -297,7 +429,7 @@ declare class MediaService {
      *   Sends `application/json`. Used for `refIds`, `details`, `metadata`,
      *   or `url` changes.
      * - `{ kind: "blob", file, body }` — replaces the BLOB file content
-     *   (max 10MB) AND patches metadata in the same request. Sends
+     *   (max 30 MB) AND patches metadata in the same request. Sends
      *   `multipart/form-data`.
      *
      * `type` and `access` are immutable per Emporix — they must match the
@@ -347,6 +479,12 @@ declare class MediaService {
      *   an `ArrayBuffer` transparently; binary Content-Types are passed
      *   through verbatim.
      *
+     * Emporix recommends {@link getDownloadUrl} for every download: here the file
+     * passes through the Media API. A `413` means the asset's known size exceeds
+     * the streaming limit (30 MB by default) — only {@link getDownloadUrl} can
+     * serve it. A `409` means the asset is still `PENDING` from a direct upload
+     * whose file has not reached storage.
+     *
      * Implementation note: uses `redirect: "manual"` so the redirect-location
      * is observable. In Node.js this works; in a browser the redirect Location
      * is intentionally hidden by fetch — there, `PUBLIC` downloads will
@@ -356,6 +494,47 @@ declare class MediaService {
      * an `<img>` tag rather than `download()`).
      */
     download(assetId: string, auth?: AuthContext): Promise<DownloadResult>;
+    /**
+     * Get a URL that serves the stored file straight from storage
+     * (`GET /assets/{assetId}/download-url`). Emporix recommends it for every
+     * download: the file never passes through the Media API, there is no size
+     * limit, and the URL can be handed to a browser as it is.
+     *
+     * - `PRIVATE` BLOB → `provider: "GCS"`, a signed Google Cloud Storage URL that
+     *   works without an Emporix token until `expiresAt` (15 minutes by default).
+     * - `PUBLIC` BLOB → `provider: "CLOUDINARY"`, the permanent URL.
+     * - `LINK` → `provider: "LINK"`, the stored URL.
+     *
+     * `disposition` (`attachment` by default, or `inline`) affects private URLs
+     * only. Unlike {@link startUploadSession}, this works whether or not direct
+     * upload is enabled for the tenant. A `409` means a direct upload is still
+     * `PENDING` and its file has not reached storage; once it has, this call
+     * completes the asset before answering.
+     */
+    getDownloadUrl(assetId: string, query?: AssetDownloadUrlQuery, auth?: AuthContext): Promise<AssetDownloadUrl>;
+    /**
+     * Start a direct upload of a `BLOB` asset (`POST /assets/upload-session`,
+     * `201`). Emporix creates the asset as `PENDING` — `id` is its id — and
+     * returns where to send the file. **This method does not send it**:
+     *
+     * - `upload.method === "PUT"` (a `PRIVATE` asset, `uploadType: "put"` or
+     *   omitted): `PUT` the file to `upload.url` with every `upload.headers` entry.
+     * - `upload.method === "POST"` (every `PUBLIC` asset, or `uploadType: "form"`):
+     *   a multipart `POST` to `upload.url` with every `upload.fields` entry
+     *   unchanged and the file part last.
+     *
+     * That request goes to Google Cloud Storage or Cloudinary, not to Emporix, so
+     * it must not carry the Emporix token — which is also why a browser can make
+     * it. The asset turns `READY` once storage confirms; until then, calls that
+     * need the file answer `409`. The instruction is valid for 15 minutes (GCS) or
+     * an hour (Cloudinary), and an unused session expires at `expiresAt`.
+     *
+     * Direct upload is enabled per tenant by Emporix Support. Without it the call
+     * throws an `EmporixForbiddenError` whose `body.message` is `direct upload is
+     * not enabled for this tenant`, and nothing is created — the same status as a
+     * missing scope, so read the message.
+     */
+    startUploadSession(input: AssetUploadSessionInput, auth?: AuthContext): Promise<AssetUploadSession>;
     /** Multipart upload sugar: builds `AssetCreateBlob` from input. */
     uploadFile(input: {
         file: Blob;
@@ -399,4 +578,4 @@ declare const _internalMedia: {
     isProductRef: typeof isProductRef;
 };
 
-export { type Asset, type AssetCreateBlobInput, type AssetCreateLinkInput, type AssetPatch, type AssetRefId, type AssetUpdateBlobInput, type AssetUpdateInput, type AssetUpdateLinkInput, type DownloadResult, type ListAssetsQuery, MediaService, _internalMedia };
+export { type Asset, type AssetCreateBlobInput, type AssetCreateLinkInput, type AssetDownloadUrl, type AssetDownloadUrlQuery, type AssetPatch, type AssetRefId, type AssetUpdateBlobInput, type AssetUpdateInput, type AssetUpdateLinkInput, type AssetUploadSession, type AssetUploadSessionInput, type DownloadResult, type ListAssetsQuery, MediaService, _internalMedia };

package/dist/media.js

@@ -1,4 +1,4 @@
-export { MediaService, _internalMedia } from './chunk-CSYXGTOH.js';
+export { MediaService, _internalMedia } from './chunk-5MPL4XBD.js';
 import './chunk-LKHKFF7B.js';
 import './chunk-UWGGF4MC.js';
 //# sourceMappingURL=media.js.map

package/dist/orders.cjs

@@ -97,6 +97,20 @@ var OrdersService = class {
       ...headers ? { headers } : {}
     });
   }
+  /**
+   * The status transitions the customer may trigger on one of their orders
+   * (`GET /orders/{orderId}/transitions`) — for example whether it can still be
+   * cancelled, before offering {@link cancel}.
+   */
+  async listTransitions(orderId, auth, opts = {}) {
+    const headers = this.saasHeader(opts.saasToken);
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${encodeURIComponent(orderId)}/transitions`,
+      auth,
+      ...headers ? { headers } : {}
+    });
+  }
   /** Transitions an order to a new status. Server enforces legal transitions. */
   async transition(orderId, status, auth, opts = {}) {
     const body = { status };

package/dist/orders.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/paged.ts","../src/core/query.ts","../src/services/orders.ts"],"names":[],"mappings":"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","file":"orders.cjs","sourcesContent":["import type { PaginatedItems } from \"./context\";\nimport type { HttpClient, RequestOptions } from \"./http\";\n\n/** Pagination inputs for {@link requestPage}. */\nexport interface PageParams {\n  /** 1-based, as Emporix counts. */\n  pageNumber: number;\n  pageSize: number;\n  /**\n   * Ask Emporix for the absolute match count via the `X-Total-Count: true`\n   * request header.\n   *\n   * Off by default and opt-in per call, not a client-wide setting: the count\n   * costs the server a second query, and defaulting it on would put that cost\n   * on every list every storefront issues.\n   */\n  totalCount?: boolean;\n}\n\n/**\n * Reads a non-negative integer header, or `undefined` when it is missing or is\n * not one. A malformed value must not reach the `hasNextPage` arithmetic —\n * `Number(\"lots\")` is `NaN`, and every comparison against `NaN` is `false`,\n * which would silently report \"last page\" on every page.\n */\nfunction intHeader(headers: Headers, name: string): number | undefined {\n  const raw = headers.get(name);\n  if (raw === null || raw.trim() === \"\") return undefined;\n  const n = Number(raw);\n  return Number.isInteger(n) && n >= 0 ? n : undefined;\n}\n\n/**\n * Issues one page of a list endpoint and assembles {@link PaginatedItems} from\n * the body plus Emporix's pagination response headers.\n *\n * Cursors travel in opposite directions: the caller sends one as the `next` or\n * `prev` **query parameter** (so it belongs in `o.query`), and the server\n * returns the following one as the `X-Next-Cursor` **response header**. This\n * helper only ever reads them.\n */\nexport async function requestPage<T>(\n  http: HttpClient,\n  o: RequestOptions,\n  page: PageParams,\n): Promise<PaginatedItems<T>> {\n  const { data, headers } = await http.requestWithMeta<T[]>(\n    page.totalCount === true\n      ? { ...o, headers: { ...(o.headers ?? {}), \"X-Total-Count\": \"true\" } }\n      : o,\n  );\n\n  // A 204 or empty body parses to `undefined`. Facades used to index straight\n  // into the result and would throw; an empty page is the honest answer.\n  const items = data ?? [];\n  const totalCount = intHeader(headers, \"X-Total-Count\");\n  const nextCursor = headers.get(\"X-Next-Cursor\") ?? undefined;\n  const prevCursor = headers.get(\"X-Prev-Cursor\") ?? undefined;\n\n  // Three tiers, most precise first. Tier 1 is ONE-DIRECTIONAL on purpose: only\n  // two endpoints in the whole API emit a cursor header, so its absence says\n  // nothing at all and has to fall through to the other two.\n  const hasNextPage =\n    nextCursor !== undefined\n      ? true\n      : totalCount !== undefined\n        ? page.pageNumber * page.pageSize < totalCount\n        : items.length === page.pageSize;\n\n  // Spread conditionally — `exactOptionalPropertyTypes` rejects an explicit\n  // `undefined` for an optional property.\n  return {\n    items,\n    pageNumber: page.pageNumber,\n    pageSize: page.pageSize,\n    hasNextPage,\n    ...(totalCount === undefined ? {} : { totalCount }),\n    ...(nextCursor === undefined ? {} : { nextCursor }),\n    ...(prevCursor === undefined ? {} : { prevCursor }),\n  };\n}\n","/**\n * A built query filter — structurally matched, NOT imported, so the SDK stays\n * decoupled from `@viu/emporix-mixins` (which lists the SDK as an optional\n * peer; a real import would be circular). `@viu/emporix-mixins`' `MixinFilter<E>`\n * satisfies this shape.\n */\nexport interface BuiltQuery<E extends string = string> {\n  toString(): string;\n  readonly usesCompound?: boolean;\n  /** Phantom entity tag — gates which service a filter may be passed to. */\n  readonly __entity?: E;\n}\n\n/** A `q` value a service method accepts: a raw DSL string or a built filter for entity `E`. */\nexport type QueryFor<E extends string = string> = string | BuiltQuery<E>;\n\n/** Per-service capability flags consulted by {@link resolveQuery}. */\nexport interface QueryCapability {\n  /** Whether the target service supports the `compoundLogicalQuery` (OR) operator. */\n  compoundLogicalQuery: boolean;\n}\n\n/**\n * Normalizes a `string | BuiltQuery` into a `q` string and enforces the\n * `compoundLogicalQuery` capability gate: an `or()`-built filter passed to a\n * service that does not support it throws rather than silently producing a\n * query the backend cannot execute.\n */\nexport function resolveQuery(q: QueryFor, cap: QueryCapability): string {\n  if (typeof q === \"string\") return q;\n  if (q.usesCompound === true && !cap.compoundLogicalQuery) {\n    throw new Error(\n      \"This filter uses or()/compoundLogicalQuery, which the target service does not support. \" +\n        \"Combine conditions with and() (space-separated AND) instead.\",\n    );\n  }\n  return q.toString();\n}\n","import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport { requestPage } from \"../core/paged\";\nimport type { AuthContext } from \"../core/auth\";\nimport { resolveQuery, type QueryFor } from \"../core/query\";\nimport type {\n  Order,\n  OrderStatus,\n  OrderUpdateDto,\n  SalesOrder,\n  Transition,\n  SalesOrderCreationDto,\n  ResourceLocation,\n  SearchRequest,\n  HistoricalTransitionsResponse,\n  OrderCalculationDto,\n  OrderEntriesDto,\n  OrderSplitRequest,\n  OrderSplitResponse,\n} from \"../generated/order-v2\";\n\n/**\n * Salesorder PATCH body. The generated `orderUpdateDto` models a full order\n * (it requires `entries`/`customer`), but `PATCH /salesorders/{id}` accepts a\n * subset — so the SDK exposes a partial of it.\n */\nexport type SalesOrderPatch = Partial<OrderUpdateDto>;\n\n/** Body for creating a sales-order as an employee (`POST /salesorders`). */\nexport type SalesOrderCreateInput = SalesOrderCreationDto;\n\n/** Id/location envelope returned when a sales-order is created. */\nexport type SalesOrderCreated = ResourceLocation;\n\n/** Body for a full sales-order replace (`PUT /salesorders/{id}`). */\nexport type SalesOrderReplaceInput = OrderUpdateDto;\n\n/** Body for `salesOrders.search` (`POST /salesorders/search`). */\nexport type SalesOrderSearchInput = SearchRequest;\n\n/** Response of `salesOrders.listHistoricalTransitions`. */\nexport type SalesOrderHistoricalTransitions = HistoricalTransitionsResponse;\n\n/** Body for `salesOrders.calculate` (`POST /salesorders/{id}/calculations`). */\nexport type SalesOrderCalculationInput = OrderCalculationDto;\n\n/** Body for `salesOrders.updateEntries` (`POST /salesorders/{id}/entries`). */\nexport type SalesOrderEntriesInput = OrderEntriesDto;\n\n/** Body for `salesOrders.split` (`POST /salesorders/{id}/split`). */\nexport type SalesOrderSplitInput = OrderSplitRequest;\n\n/** Response of `salesOrders.split`. */\nexport type SalesOrderSplitResult = OrderSplitResponse;\n\n/** Options for `salesOrders.list`. */\nexport interface ListSalesOrdersOptions {\n  pageNumber?: number;\n  pageSize?: number;\n  sort?: string;\n  fields?: string;\n  /** A `q` filter — raw DSL string or a built filter for entity \"ORDER\". */\n  q?: QueryFor<\"ORDER\">;\n  /** Ask for `X-Total-Count` — becomes a request header, not a query parameter. */\n  totalCount?: boolean;\n}\n\n/** Options for `orders.listForLegalEntity`. */\nexport interface ListLegalEntityOrdersOptions {\n  pageNumber?: number;\n  pageSize?: number;\n  sort?: string;\n  saasToken?: string;\n  /** A `q` filter — raw DSL string or a built filter for entity \"ORDER\". */\n  q?: QueryFor<\"ORDER\">;\n  /** Ask for `X-Total-Count` — becomes a request header, not a query parameter. */\n  totalCount?: boolean;\n}\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  /** A `q` filter — raw DSL string or a built filter (e.g. mixinQuery for entity \"ORDER\"). */\n  q?: QueryFor<\"ORDER\">;\n  /** Ask for `X-Total-Count` — becomes a request header, not a query parameter. */\n  totalCount?: boolean;\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  static readonly channel = \"orders\" as const;\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 pageNumber = opts.pageNumber ?? 1;\n    const pageSize = opts.pageSize ?? 50;\n    const query: Record<string, string | number | undefined> = {\n      pageNumber,\n      pageSize,\n    };\n    setIfDefined(query, \"status\", opts.status);\n    setIfDefined(query, \"legalEntityId\", opts.legalEntityId);\n    setIfDefined(query, \"siteCode\", opts.siteCode);\n    if (opts.q !== undefined) {\n      setIfDefined(query, \"q\", resolveQuery(opts.q, { compoundLogicalQuery: false }));\n    }\n    const headers = this.saasHeader(opts.saasToken);\n    // order-v2 returns a bare JSON array, not a {items,...} envelope — the total\n    // lives in the X-Total-Count header, which `requestPage` reads when the\n    // caller opts in with `totalCount: true`.\n    return requestPage<Order>(\n      this.ctx.http,\n      {\n        method: \"GET\",\n        path: this.base(),\n        query,\n        auth,\n        ...(headers ? { headers } : {}),\n      },\n      {\n        pageNumber,\n        pageSize,\n        ...(opts.totalCount === undefined ? {} : { totalCount: opts.totalCount }),\n      },\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   * Lists a legal entity's orders (`GET /legal-entity-orders/{legalEntityId}`),\n   * wrapped into `PaginatedItems`. B2B storefront view — requires a customer\n   * token with access to the legal entity.\n   */\n  async listForLegalEntity(\n    legalEntityId: string,\n    auth: AuthContext,\n    opts: ListLegalEntityOrdersOptions = {},\n  ): Promise<PaginatedItems<SalesOrder>> {\n    const pageNumber = opts.pageNumber ?? 1;\n    const pageSize = opts.pageSize ?? 50;\n    const query: Record<string, string | number | undefined> = { pageNumber, pageSize };\n    setIfDefined(query, \"sort\", opts.sort);\n    if (opts.q !== undefined) {\n      setIfDefined(query, \"q\", resolveQuery(opts.q, { compoundLogicalQuery: false }));\n    }\n    const headers = this.saasHeader(opts.saasToken);\n    return requestPage<SalesOrder>(\n      this.ctx.http,\n      {\n        method: \"GET\",\n        path: `/order-v2/${this.ctx.tenant}/legal-entity-orders/${legalEntityId}`,\n        query,\n        auth,\n        ...(headers ? { headers } : {}),\n      },\n      {\n        pageNumber,\n        pageSize,\n        ...(opts.totalCount === undefined ? {} : { totalCount: opts.totalCount }),\n      },\n    );\n  }\n\n  /**\n   * Fetches one order within a legal entity\n   * (`GET /legal-entity-orders/{legalEntityId}/{orderId}`).\n   */\n  async getForLegalEntity(\n    legalEntityId: string,\n    orderId: string,\n    auth: AuthContext,\n    opts: { saasToken?: string } = {},\n  ): Promise<SalesOrder> {\n    const headers = this.saasHeader(opts.saasToken);\n    return this.ctx.http.request<SalesOrder>({\n      method: \"GET\",\n      path: `/order-v2/${this.ctx.tenant}/legal-entity-orders/${legalEntityId}/${orderId}`,\n      auth,\n      ...(headers ? { headers } : {}),\n    });\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  static readonly channel = \"sales-orders\" as const;\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  /** Lists tenant sales-orders (`GET /salesorders`), wrapped into `PaginatedItems`. */\n  async list(auth: AuthContext, opts: ListSalesOrdersOptions = {}): Promise<PaginatedItems<SalesOrder>> {\n    const pageNumber = opts.pageNumber ?? 1;\n    const pageSize = opts.pageSize ?? 50;\n    const query: Record<string, string | number | undefined> = { pageNumber, pageSize };\n    setIfDefined(query, \"sort\", opts.sort);\n    setIfDefined(query, \"fields\", opts.fields);\n    if (opts.q !== undefined) {\n      setIfDefined(query, \"q\", resolveQuery(opts.q, { compoundLogicalQuery: false }));\n    }\n    return requestPage<SalesOrder>(\n      this.ctx.http,\n      {\n        method: \"GET\",\n        path: this.base(),\n        query,\n        auth,\n      },\n      {\n        pageNumber,\n        pageSize,\n        ...(opts.totalCount === undefined ? {} : { totalCount: opts.totalCount }),\n      },\n    );\n  }\n\n  /** Searches tenant sales-orders (`POST /salesorders/search`, body carries the `q` filter). */\n  async search(\n    query: SalesOrderSearchInput,\n    auth: AuthContext,\n    opts: { pageNumber?: number; pageSize?: number; sort?: string; fields?: string } = {},\n  ): Promise<SalesOrder[]> {\n    const q: Record<string, string | number | undefined> = {};\n    setIfDefined(q, \"pageNumber\", opts.pageNumber);\n    setIfDefined(q, \"pageSize\", opts.pageSize);\n    setIfDefined(q, \"sort\", opts.sort);\n    setIfDefined(q, \"fields\", opts.fields);\n    return this.ctx.http.request<SalesOrder[]>({\n      method: \"POST\",\n      path: `${this.base()}/search`,\n      ...(Object.keys(q).length > 0 ? { query: q } : {}),\n      body: query,\n      idempotent: true, // pure read over POST — safe to replay on 5xx/429\n      auth,\n    });\n  }\n\n  /** Creates a sales-order as an employee (`POST /salesorders`). Returns the created resource location. */\n  async create(input: SalesOrderCreateInput, auth: AuthContext): Promise<SalesOrderCreated> {\n    return this.ctx.http.request<SalesOrderCreated>({\n      method: \"POST\",\n      path: this.base(),\n      auth,\n      body: input,\n    });\n  }\n\n  /**\n   * Full-replaces a sales-order (`PUT /salesorders/{orderId}`, body `OrderUpdateDto`).\n   * The endpoint returns 204, so the order is re-fetched (direct GET) and returned.\n   * Note: `update` on this class is the PATCH (partial); `replace` is the PUT (full).\n   */\n  async replace(orderId: string, input: SalesOrderReplaceInput, auth: AuthContext): Promise<SalesOrder> {\n    await this.ctx.http.request<void>({\n      method: \"PUT\",\n      path: `${this.base()}/${orderId}`,\n      auth,\n      body: input,\n    });\n    return this.ctx.http.request<SalesOrder>({\n      method: \"GET\",\n      path: `${this.base()}/${orderId}`,\n      auth,\n    });\n  }\n\n  /** Deletes a sales-order (`DELETE /salesorders/{orderId}`). */\n  async delete(orderId: string, auth: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `${this.base()}/${orderId}`,\n      auth,\n    });\n  }\n\n  /** Lists the available transitions for a sales-order (`GET /salesorders/{orderId}/transitions`). */\n  async listTransitions(orderId: string, auth: AuthContext): Promise<Transition[]> {\n    return this.ctx.http.request<Transition[]>({\n      method: \"GET\",\n      path: `${this.base()}/${orderId}/transitions`,\n      auth,\n    });\n  }\n\n  /** Transitions a sales-order to a new status (`POST /salesorders/{orderId}/transitions`). */\n  async transition(orderId: string, input: Transition, auth: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"POST\",\n      path: `${this.base()}/${orderId}/transitions`,\n      auth,\n      body: input,\n    });\n  }\n\n  /** Lists the historical transitions of a sales-order (`GET /salesorders/{orderId}/historical-transitions`). */\n  async listHistoricalTransitions(orderId: string, auth: AuthContext): Promise<SalesOrderHistoricalTransitions> {\n    return this.ctx.http.request<SalesOrderHistoricalTransitions>({\n      method: \"GET\",\n      path: `${this.base()}/${orderId}/historical-transitions`,\n      auth,\n    });\n  }\n\n  /** Calculates order-entry totals for a sales-order (`POST /salesorders/{orderId}/calculations`). */\n  async calculate(orderId: string, input: SalesOrderCalculationInput, auth: AuthContext): Promise<unknown> {\n    return this.ctx.http.request<unknown>({\n      method: \"POST\",\n      path: `${this.base()}/${orderId}/calculations`,\n      auth,\n      body: input,\n    });\n  }\n\n  /** Updates a sales-order's entries (`POST /salesorders/{orderId}/entries`). Returns the updated order. */\n  async updateEntries(orderId: string, input: SalesOrderEntriesInput, auth: AuthContext): Promise<SalesOrder> {\n    return this.ctx.http.request<SalesOrder>({\n      method: \"POST\",\n      path: `${this.base()}/${orderId}/entries`,\n      auth,\n      body: input,\n    });\n  }\n\n  /** Splits a sales-order (`POST /salesorders/{orderId}/split`). */\n  async split(orderId: string, input: SalesOrderSplitInput, auth: AuthContext): Promise<SalesOrderSplitResult> {\n    return this.ctx.http.request<SalesOrderSplitResult>({\n      method: \"POST\",\n      path: `${this.base()}/${orderId}/split`,\n      auth,\n      body: input,\n    });\n  }\n}\n"]}
+{"version":3,"sources":["../src/core/paged.ts","../src/core/query.ts","../src/services/orders.ts"],"names":[],"mappings":"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","file":"orders.cjs","sourcesContent":["import type { PaginatedItems } from \"./context\";\nimport type { HttpClient, RequestOptions } from \"./http\";\n\n/** Pagination inputs for {@link requestPage}. */\nexport interface PageParams {\n  /** 1-based, as Emporix counts. */\n  pageNumber: number;\n  pageSize: number;\n  /**\n   * Ask Emporix for the absolute match count via the `X-Total-Count: true`\n   * request header.\n   *\n   * Off by default and opt-in per call, not a client-wide setting: the count\n   * costs the server a second query, and defaulting it on would put that cost\n   * on every list every storefront issues.\n   */\n  totalCount?: boolean;\n}\n\n/**\n * Reads a non-negative integer header, or `undefined` when it is missing or is\n * not one. A malformed value must not reach the `hasNextPage` arithmetic —\n * `Number(\"lots\")` is `NaN`, and every comparison against `NaN` is `false`,\n * which would silently report \"last page\" on every page.\n */\nfunction intHeader(headers: Headers, name: string): number | undefined {\n  const raw = headers.get(name);\n  if (raw === null || raw.trim() === \"\") return undefined;\n  const n = Number(raw);\n  return Number.isInteger(n) && n >= 0 ? n : undefined;\n}\n\n/**\n * Issues one page of a list endpoint and assembles {@link PaginatedItems} from\n * the body plus Emporix's pagination response headers.\n *\n * Cursors travel in opposite directions: the caller sends one as the `next` or\n * `prev` **query parameter** (so it belongs in `o.query`), and the server\n * returns the following one as the `X-Next-Cursor` **response header**. This\n * helper only ever reads them.\n */\nexport async function requestPage<T>(\n  http: HttpClient,\n  o: RequestOptions,\n  page: PageParams,\n): Promise<PaginatedItems<T>> {\n  const { data, headers } = await http.requestWithMeta<T[]>(\n    page.totalCount === true\n      ? { ...o, headers: { ...(o.headers ?? {}), \"X-Total-Count\": \"true\" } }\n      : o,\n  );\n\n  // A 204 or empty body parses to `undefined`. Facades used to index straight\n  // into the result and would throw; an empty page is the honest answer.\n  const items = data ?? [];\n  const totalCount = intHeader(headers, \"X-Total-Count\");\n  const nextCursor = headers.get(\"X-Next-Cursor\") ?? undefined;\n  const prevCursor = headers.get(\"X-Prev-Cursor\") ?? undefined;\n\n  // Three tiers, most precise first. Tier 1 is ONE-DIRECTIONAL on purpose: only\n  // two endpoints in the whole API emit a cursor header, so its absence says\n  // nothing at all and has to fall through to the other two.\n  const hasNextPage =\n    nextCursor !== undefined\n      ? true\n      : totalCount !== undefined\n        ? page.pageNumber * page.pageSize < totalCount\n        : items.length === page.pageSize;\n\n  // Spread conditionally — `exactOptionalPropertyTypes` rejects an explicit\n  // `undefined` for an optional property.\n  return {\n    items,\n    pageNumber: page.pageNumber,\n    pageSize: page.pageSize,\n    hasNextPage,\n    ...(totalCount === undefined ? {} : { totalCount }),\n    ...(nextCursor === undefined ? {} : { nextCursor }),\n    ...(prevCursor === undefined ? {} : { prevCursor }),\n  };\n}\n","/**\n * A built query filter — structurally matched, NOT imported, so the SDK stays\n * decoupled from `@viu/emporix-mixins` (which lists the SDK as an optional\n * peer; a real import would be circular). `@viu/emporix-mixins`' `MixinFilter<E>`\n * satisfies this shape.\n */\nexport interface BuiltQuery<E extends string = string> {\n  toString(): string;\n  readonly usesCompound?: boolean;\n  /** Phantom entity tag — gates which service a filter may be passed to. */\n  readonly __entity?: E;\n}\n\n/** A `q` value a service method accepts: a raw DSL string or a built filter for entity `E`. */\nexport type QueryFor<E extends string = string> = string | BuiltQuery<E>;\n\n/** Per-service capability flags consulted by {@link resolveQuery}. */\nexport interface QueryCapability {\n  /** Whether the target service supports the `compoundLogicalQuery` (OR) operator. */\n  compoundLogicalQuery: boolean;\n}\n\n/**\n * Normalizes a `string | BuiltQuery` into a `q` string and enforces the\n * `compoundLogicalQuery` capability gate: an `or()`-built filter passed to a\n * service that does not support it throws rather than silently producing a\n * query the backend cannot execute.\n */\nexport function resolveQuery(q: QueryFor, cap: QueryCapability): string {\n  if (typeof q === \"string\") return q;\n  if (q.usesCompound === true && !cap.compoundLogicalQuery) {\n    throw new Error(\n      \"This filter uses or()/compoundLogicalQuery, which the target service does not support. \" +\n        \"Combine conditions with and() (space-separated AND) instead.\",\n    );\n  }\n  return q.toString();\n}\n","import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport { requestPage } from \"../core/paged\";\nimport type { AuthContext } from \"../core/auth\";\nimport { resolveQuery, type QueryFor } from \"../core/query\";\nimport type {\n  Order,\n  OrderStatus,\n  OrderUpdateDto,\n  SalesOrder,\n  Transition,\n  SalesOrderCreationDto,\n  ResourceLocation,\n  SearchRequest,\n  HistoricalTransitionsResponse,\n  OrderCalculationDto,\n  OrderEntriesDto,\n  OrderSplitRequest,\n  OrderSplitResponse,\n} from \"../generated/order-v2\";\n\n/**\n * Salesorder PATCH body. The generated `orderUpdateDto` models a full order\n * (it requires `entries`/`customer`), but `PATCH /salesorders/{id}` accepts a\n * subset — so the SDK exposes a partial of it.\n */\nexport type SalesOrderPatch = Partial<OrderUpdateDto>;\n\n/** Body for creating a sales-order as an employee (`POST /salesorders`). */\nexport type SalesOrderCreateInput = SalesOrderCreationDto;\n\n/** Id/location envelope returned when a sales-order is created. */\nexport type SalesOrderCreated = ResourceLocation;\n\n/** Body for a full sales-order replace (`PUT /salesorders/{id}`). */\nexport type SalesOrderReplaceInput = OrderUpdateDto;\n\n/** Body for `salesOrders.search` (`POST /salesorders/search`). */\nexport type SalesOrderSearchInput = SearchRequest;\n\n/** Response of `salesOrders.listHistoricalTransitions`. */\nexport type SalesOrderHistoricalTransitions = HistoricalTransitionsResponse;\n\n/** Body for `salesOrders.calculate` (`POST /salesorders/{id}/calculations`). */\nexport type SalesOrderCalculationInput = OrderCalculationDto;\n\n/** Body for `salesOrders.updateEntries` (`POST /salesorders/{id}/entries`). */\nexport type SalesOrderEntriesInput = OrderEntriesDto;\n\n/** Body for `salesOrders.split` (`POST /salesorders/{id}/split`). */\nexport type SalesOrderSplitInput = OrderSplitRequest;\n\n/** Response of `salesOrders.split`. */\nexport type SalesOrderSplitResult = OrderSplitResponse;\n\n/** Options for `salesOrders.list`. */\nexport interface ListSalesOrdersOptions {\n  pageNumber?: number;\n  pageSize?: number;\n  sort?: string;\n  fields?: string;\n  /** A `q` filter — raw DSL string or a built filter for entity \"ORDER\". */\n  q?: QueryFor<\"ORDER\">;\n  /** Ask for `X-Total-Count` — becomes a request header, not a query parameter. */\n  totalCount?: boolean;\n}\n\n/** Options for `orders.listForLegalEntity`. */\nexport interface ListLegalEntityOrdersOptions {\n  pageNumber?: number;\n  pageSize?: number;\n  sort?: string;\n  saasToken?: string;\n  /** A `q` filter — raw DSL string or a built filter for entity \"ORDER\". */\n  q?: QueryFor<\"ORDER\">;\n  /** Ask for `X-Total-Count` — becomes a request header, not a query parameter. */\n  totalCount?: boolean;\n}\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  /** A `q` filter — raw DSL string or a built filter (e.g. mixinQuery for entity \"ORDER\"). */\n  q?: QueryFor<\"ORDER\">;\n  /** Ask for `X-Total-Count` — becomes a request header, not a query parameter. */\n  totalCount?: boolean;\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  static readonly channel = \"orders\" as const;\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 pageNumber = opts.pageNumber ?? 1;\n    const pageSize = opts.pageSize ?? 50;\n    const query: Record<string, string | number | undefined> = {\n      pageNumber,\n      pageSize,\n    };\n    setIfDefined(query, \"status\", opts.status);\n    setIfDefined(query, \"legalEntityId\", opts.legalEntityId);\n    setIfDefined(query, \"siteCode\", opts.siteCode);\n    if (opts.q !== undefined) {\n      setIfDefined(query, \"q\", resolveQuery(opts.q, { compoundLogicalQuery: false }));\n    }\n    const headers = this.saasHeader(opts.saasToken);\n    // order-v2 returns a bare JSON array, not a {items,...} envelope — the total\n    // lives in the X-Total-Count header, which `requestPage` reads when the\n    // caller opts in with `totalCount: true`.\n    return requestPage<Order>(\n      this.ctx.http,\n      {\n        method: \"GET\",\n        path: this.base(),\n        query,\n        auth,\n        ...(headers ? { headers } : {}),\n      },\n      {\n        pageNumber,\n        pageSize,\n        ...(opts.totalCount === undefined ? {} : { totalCount: opts.totalCount }),\n      },\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  /**\n   * The status transitions the customer may trigger on one of their orders\n   * (`GET /orders/{orderId}/transitions`) — for example whether it can still be\n   * cancelled, before offering {@link cancel}.\n   */\n  async listTransitions(\n    orderId: string,\n    auth: AuthContext,\n    opts: GetOrderOptions = {},\n  ): Promise<Transition[]> {\n    const headers = this.saasHeader(opts.saasToken);\n    return this.ctx.http.request<Transition[]>({\n      method: \"GET\",\n      path: `${this.base()}/${encodeURIComponent(orderId)}/transitions`,\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   * Lists a legal entity's orders (`GET /legal-entity-orders/{legalEntityId}`),\n   * wrapped into `PaginatedItems`. B2B storefront view — requires a customer\n   * token with access to the legal entity.\n   */\n  async listForLegalEntity(\n    legalEntityId: string,\n    auth: AuthContext,\n    opts: ListLegalEntityOrdersOptions = {},\n  ): Promise<PaginatedItems<SalesOrder>> {\n    const pageNumber = opts.pageNumber ?? 1;\n    const pageSize = opts.pageSize ?? 50;\n    const query: Record<string, string | number | undefined> = { pageNumber, pageSize };\n    setIfDefined(query, \"sort\", opts.sort);\n    if (opts.q !== undefined) {\n      setIfDefined(query, \"q\", resolveQuery(opts.q, { compoundLogicalQuery: false }));\n    }\n    const headers = this.saasHeader(opts.saasToken);\n    return requestPage<SalesOrder>(\n      this.ctx.http,\n      {\n        method: \"GET\",\n        path: `/order-v2/${this.ctx.tenant}/legal-entity-orders/${legalEntityId}`,\n        query,\n        auth,\n        ...(headers ? { headers } : {}),\n      },\n      {\n        pageNumber,\n        pageSize,\n        ...(opts.totalCount === undefined ? {} : { totalCount: opts.totalCount }),\n      },\n    );\n  }\n\n  /**\n   * Fetches one order within a legal entity\n   * (`GET /legal-entity-orders/{legalEntityId}/{orderId}`).\n   */\n  async getForLegalEntity(\n    legalEntityId: string,\n    orderId: string,\n    auth: AuthContext,\n    opts: { saasToken?: string } = {},\n  ): Promise<SalesOrder> {\n    const headers = this.saasHeader(opts.saasToken);\n    return this.ctx.http.request<SalesOrder>({\n      method: \"GET\",\n      path: `/order-v2/${this.ctx.tenant}/legal-entity-orders/${legalEntityId}/${orderId}`,\n      auth,\n      ...(headers ? { headers } : {}),\n    });\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  static readonly channel = \"sales-orders\" as const;\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  /** Lists tenant sales-orders (`GET /salesorders`), wrapped into `PaginatedItems`. */\n  async list(auth: AuthContext, opts: ListSalesOrdersOptions = {}): Promise<PaginatedItems<SalesOrder>> {\n    const pageNumber = opts.pageNumber ?? 1;\n    const pageSize = opts.pageSize ?? 50;\n    const query: Record<string, string | number | undefined> = { pageNumber, pageSize };\n    setIfDefined(query, \"sort\", opts.sort);\n    setIfDefined(query, \"fields\", opts.fields);\n    if (opts.q !== undefined) {\n      setIfDefined(query, \"q\", resolveQuery(opts.q, { compoundLogicalQuery: false }));\n    }\n    return requestPage<SalesOrder>(\n      this.ctx.http,\n      {\n        method: \"GET\",\n        path: this.base(),\n        query,\n        auth,\n      },\n      {\n        pageNumber,\n        pageSize,\n        ...(opts.totalCount === undefined ? {} : { totalCount: opts.totalCount }),\n      },\n    );\n  }\n\n  /** Searches tenant sales-orders (`POST /salesorders/search`, body carries the `q` filter). */\n  async search(\n    query: SalesOrderSearchInput,\n    auth: AuthContext,\n    opts: { pageNumber?: number; pageSize?: number; sort?: string; fields?: string } = {},\n  ): Promise<SalesOrder[]> {\n    const q: Record<string, string | number | undefined> = {};\n    setIfDefined(q, \"pageNumber\", opts.pageNumber);\n    setIfDefined(q, \"pageSize\", opts.pageSize);\n    setIfDefined(q, \"sort\", opts.sort);\n    setIfDefined(q, \"fields\", opts.fields);\n    return this.ctx.http.request<SalesOrder[]>({\n      method: \"POST\",\n      path: `${this.base()}/search`,\n      ...(Object.keys(q).length > 0 ? { query: q } : {}),\n      body: query,\n      idempotent: true, // pure read over POST — safe to replay on 5xx/429\n      auth,\n    });\n  }\n\n  /** Creates a sales-order as an employee (`POST /salesorders`). Returns the created resource location. */\n  async create(input: SalesOrderCreateInput, auth: AuthContext): Promise<SalesOrderCreated> {\n    return this.ctx.http.request<SalesOrderCreated>({\n      method: \"POST\",\n      path: this.base(),\n      auth,\n      body: input,\n    });\n  }\n\n  /**\n   * Full-replaces a sales-order (`PUT /salesorders/{orderId}`, body `OrderUpdateDto`).\n   * The endpoint returns 204, so the order is re-fetched (direct GET) and returned.\n   * Note: `update` on this class is the PATCH (partial); `replace` is the PUT (full).\n   */\n  async replace(orderId: string, input: SalesOrderReplaceInput, auth: AuthContext): Promise<SalesOrder> {\n    await this.ctx.http.request<void>({\n      method: \"PUT\",\n      path: `${this.base()}/${orderId}`,\n      auth,\n      body: input,\n    });\n    return this.ctx.http.request<SalesOrder>({\n      method: \"GET\",\n      path: `${this.base()}/${orderId}`,\n      auth,\n    });\n  }\n\n  /** Deletes a sales-order (`DELETE /salesorders/{orderId}`). */\n  async delete(orderId: string, auth: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `${this.base()}/${orderId}`,\n      auth,\n    });\n  }\n\n  /** Lists the available transitions for a sales-order (`GET /salesorders/{orderId}/transitions`). */\n  async listTransitions(orderId: string, auth: AuthContext): Promise<Transition[]> {\n    return this.ctx.http.request<Transition[]>({\n      method: \"GET\",\n      path: `${this.base()}/${orderId}/transitions`,\n      auth,\n    });\n  }\n\n  /** Transitions a sales-order to a new status (`POST /salesorders/{orderId}/transitions`). */\n  async transition(orderId: string, input: Transition, auth: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"POST\",\n      path: `${this.base()}/${orderId}/transitions`,\n      auth,\n      body: input,\n    });\n  }\n\n  /** Lists the historical transitions of a sales-order (`GET /salesorders/{orderId}/historical-transitions`). */\n  async listHistoricalTransitions(orderId: string, auth: AuthContext): Promise<SalesOrderHistoricalTransitions> {\n    return this.ctx.http.request<SalesOrderHistoricalTransitions>({\n      method: \"GET\",\n      path: `${this.base()}/${orderId}/historical-transitions`,\n      auth,\n    });\n  }\n\n  /** Calculates order-entry totals for a sales-order (`POST /salesorders/{orderId}/calculations`). */\n  async calculate(orderId: string, input: SalesOrderCalculationInput, auth: AuthContext): Promise<unknown> {\n    return this.ctx.http.request<unknown>({\n      method: \"POST\",\n      path: `${this.base()}/${orderId}/calculations`,\n      auth,\n      body: input,\n    });\n  }\n\n  /** Updates a sales-order's entries (`POST /salesorders/{orderId}/entries`). Returns the updated order. */\n  async updateEntries(orderId: string, input: SalesOrderEntriesInput, auth: AuthContext): Promise<SalesOrder> {\n    return this.ctx.http.request<SalesOrder>({\n      method: \"POST\",\n      path: `${this.base()}/${orderId}/entries`,\n      auth,\n      body: input,\n    });\n  }\n\n  /** Splits a sales-order (`POST /salesorders/{orderId}/split`). */\n  async split(orderId: string, input: SalesOrderSplitInput, auth: AuthContext): Promise<SalesOrderSplitResult> {\n    return this.ctx.http.request<SalesOrderSplitResult>({\n      method: \"POST\",\n      path: `${this.base()}/${orderId}/split`,\n      auth,\n      body: input,\n    });\n  }\n}\n"]}

package/dist/orders.d.cts

@@ -2091,6 +2091,12 @@ declare class OrdersService {
     listMine(auth: AuthContext, opts?: ListMyOrdersOptions): Promise<PaginatedItems<Order>>;
     /** Fetches one of the calling customer's orders by id. */
     get(orderId: string, auth: AuthContext, opts?: GetOrderOptions): Promise<Order>;
+    /**
+     * The status transitions the customer may trigger on one of their orders
+     * (`GET /orders/{orderId}/transitions`) — for example whether it can still be
+     * cancelled, before offering {@link cancel}.
+     */
+    listTransitions(orderId: string, auth: AuthContext, opts?: GetOrderOptions): Promise<Transition[]>;
     /** Transitions an order to a new status. Server enforces legal transitions. */
     transition(orderId: string, status: OrderStatus, auth: AuthContext, opts?: OrderTransitionOptions): Promise<void>;
     /** Convenience: transitions to `DECLINED` (customer cancel). */

package/dist/orders.d.ts

@@ -2091,6 +2091,12 @@ declare class OrdersService {
     listMine(auth: AuthContext, opts?: ListMyOrdersOptions): Promise<PaginatedItems<Order>>;
     /** Fetches one of the calling customer's orders by id. */
     get(orderId: string, auth: AuthContext, opts?: GetOrderOptions): Promise<Order>;
+    /**
+     * The status transitions the customer may trigger on one of their orders
+     * (`GET /orders/{orderId}/transitions`) — for example whether it can still be
+     * cancelled, before offering {@link cancel}.
+     */
+    listTransitions(orderId: string, auth: AuthContext, opts?: GetOrderOptions): Promise<Transition[]>;
     /** Transitions an order to a new status. Server enforces legal transitions. */
     transition(orderId: string, status: OrderStatus, auth: AuthContext, opts?: OrderTransitionOptions): Promise<void>;
     /** Convenience: transitions to `DECLINED` (customer cancel). */

package/dist/orders.js

@@ -1,4 +1,4 @@
-export { OrdersService, SalesOrdersService } from './chunk-P3RANRGB.js';
+export { OrdersService, SalesOrdersService } from './chunk-IYNT5BQW.js';
 import './chunk-S5HEIQDK.js';
 import './chunk-LKHKFF7B.js';
 //# sourceMappingURL=orders.js.map

package/dist/price.cjs

@@ -41,6 +41,17 @@ var EmporixError = class extends Error {
 var EmporixAuthError = class extends EmporixError {
 };
 
+// src/core/search.ts
+function splitQuery(input, queryKeys) {
+  const body = {};
+  const query = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (queryKeys.includes(key)) query[key] = value;
+    else body[key] = value;
+  }
+  return { body, query };
+}
+
 // src/services/price.ts
 function normalizeMatch(raw) {
   const itemId = raw.itemId ?? raw.itemRef;
@@ -186,13 +197,16 @@ var PriceService = class {
       auth: authCtx
     });
   }
-  /** Searches flat prices (POST body query). Default auth: service. */
+  /**
+   * Searches flat prices: the criteria go in the body, `expand` in the query
+   * string. Default auth: service.
+   */
   async search(query, authCtx = SERVICE) {
     return this.ctx.http.request({
       method: "POST",
       path: `/price/${this.ctx.tenant}/prices/search`,
       auth: authCtx,
-      body: query
+      ...splitQuery(query, ["expand"])
     });
   }
   /** Creates multiple flat prices in one request. Default auth: service. */
@@ -260,11 +274,12 @@ var PriceService = class {
       auth: authCtx,
       body: input
     }),
+    /** `q` in the body; `pageNumber`, `pageSize` and `sort` in the query string. */
     search: async (query, authCtx = SERVICE) => this.ctx.http.request({
       method: "POST",
       path: `/price/${this.ctx.tenant}/price-lists/search`,
       auth: authCtx,
-      body: query
+      ...splitQuery(query, ["pageNumber", "pageSize", "sort"])
     }),
     get: async (listId, authCtx = SERVICE) => this.ctx.http.request({
       method: "GET",
@@ -314,11 +329,12 @@ var PriceService = class {
         auth: authCtx
       });
     },
+    /** `q` in the body; `pageNumber`, `pageSize` and `sort` in the query string. */
     searchPrices: async (listId, query, authCtx = SERVICE) => this.ctx.http.request({
       method: "POST",
       path: `/price/${this.ctx.tenant}/price-lists/${listId}/prices/search`,
       auth: authCtx,
-      body: query
+      ...splitQuery(query, ["pageNumber", "pageSize", "sort"])
     }),
     bulkCreatePrices: async (listId, inputs, authCtx = SERVICE) => this.ctx.http.request({
       method: "POST",