@revenexx/node 0.0.1 → 0.1.0

package/dist/services/shipping-carriers.js

@@ -0,0 +1,373 @@
+'use strict';
+
+var client = require('../client');
+
+class ShippingCarriers {
+  constructor(client) {
+    this.client = client;
+  }
+  shippingCarriersList(paramsOrFirst, ...rest) {
+    let params;
+    if (!paramsOrFirst || paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst)) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        limit: paramsOrFirst,
+        offset: rest[0],
+        order: rest[1],
+        code: rest[2],
+        status: rest[3],
+        serviceLevel: rest[4]
+      };
+    }
+    const limit = params.limit;
+    const offset = params.offset;
+    const order = params.order;
+    const code = params.code;
+    const status = params.status;
+    const serviceLevel = params.serviceLevel;
+    const apiPath = "/v1/shipping/carriers";
+    const apiPayload = {};
+    if (typeof limit !== "undefined") {
+      apiPayload["limit"] = limit;
+    }
+    if (typeof offset !== "undefined") {
+      apiPayload["offset"] = offset;
+    }
+    if (typeof order !== "undefined") {
+      apiPayload["order"] = order;
+    }
+    if (typeof code !== "undefined") {
+      apiPayload["code"] = code;
+    }
+    if (typeof status !== "undefined") {
+      apiPayload["status"] = status;
+    }
+    if (typeof serviceLevel !== "undefined") {
+      apiPayload["service_level"] = serviceLevel;
+    }
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {};
+    return this.client.call(
+      "get",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  shippingCarriersCreate(paramsOrFirst, ...rest) {
+    let params;
+    if (paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst)) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        code: paramsOrFirst,
+        name: rest[0],
+        countries: rest[1],
+        cutoffTime: rest[2],
+        etaDaysMax: rest[3],
+        etaDaysMin: rest[4],
+        handlingDays: rest[5],
+        labels: rest[6],
+        metadata: rest[7],
+        position: rest[8],
+        serviceLevel: rest[9],
+        status: rest[10],
+        trackingUrlTemplate: rest[11]
+      };
+    }
+    const code = params.code;
+    const name = params.name;
+    const countries = params.countries;
+    const cutoffTime = params.cutoffTime;
+    const etaDaysMax = params.etaDaysMax;
+    const etaDaysMin = params.etaDaysMin;
+    const handlingDays = params.handlingDays;
+    const labels = params.labels;
+    const metadata = params.metadata;
+    const position = params.position;
+    const serviceLevel = params.serviceLevel;
+    const status = params.status;
+    const trackingUrlTemplate = params.trackingUrlTemplate;
+    if (typeof code === "undefined") {
+      throw new client.RevenexxException('Missing required parameter: "code"');
+    }
+    if (typeof name === "undefined") {
+      throw new client.RevenexxException('Missing required parameter: "name"');
+    }
+    const apiPath = "/v1/shipping/carriers";
+    const apiPayload = {};
+    if (typeof code !== "undefined") {
+      apiPayload["code"] = code;
+    }
+    if (typeof countries !== "undefined") {
+      apiPayload["countries"] = countries;
+    }
+    if (typeof cutoffTime !== "undefined") {
+      apiPayload["cutoff_time"] = cutoffTime;
+    }
+    if (typeof etaDaysMax !== "undefined") {
+      apiPayload["eta_days_max"] = etaDaysMax;
+    }
+    if (typeof etaDaysMin !== "undefined") {
+      apiPayload["eta_days_min"] = etaDaysMin;
+    }
+    if (typeof handlingDays !== "undefined") {
+      apiPayload["handling_days"] = handlingDays;
+    }
+    if (typeof labels !== "undefined") {
+      apiPayload["labels"] = labels;
+    }
+    if (typeof metadata !== "undefined") {
+      apiPayload["metadata"] = metadata;
+    }
+    if (typeof name !== "undefined") {
+      apiPayload["name"] = name;
+    }
+    if (typeof position !== "undefined") {
+      apiPayload["position"] = position;
+    }
+    if (typeof serviceLevel !== "undefined") {
+      apiPayload["service_level"] = serviceLevel;
+    }
+    if (typeof status !== "undefined") {
+      apiPayload["status"] = status;
+    }
+    if (typeof trackingUrlTemplate !== "undefined") {
+      apiPayload["tracking_url_template"] = trackingUrlTemplate;
+    }
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {
+      "content-type": "application/json"
+    };
+    return this.client.call(
+      "post",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  /**
+   * The DACH set — the three German parcel networks, the express carriers, the AT/CH incumbents and the pallet forwarders — each with the tracking template, service level, transit time and pickup cut-off it would be created with. `seeded` marks the four a fresh install already has. Adding a carrier is a data change, never a code change, and a merchant may of course create one that is not in here at all.
+   *
+   * @throws {RevenexxException}
+   * @returns {Promise<{}>}
+   */
+  shippingCarriersCatalog() {
+    const apiPath = "/v1/shipping/carriers/catalog";
+    const apiPayload = {};
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {};
+    return this.client.call(
+      "get",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  /**
+   * The four networks a DACH shop is expected to have — DHL, DPD, GLS and UPS — created by code, and only the ones that are missing. The app runs this itself on `app.installed`, so a fresh install already has them; calling it by hand afterwards is how a tenant that predates a catalog entry catches up, and calling it twice costs nothing, because it reconciles rather than seeds. An existing row belongs to the merchant: only columns that are genuinely EMPTY are filled in (a tracking template added to the catalog after their install), never a value they set. Nothing is deleted.
+   *
+   * @throws {RevenexxException}
+   * @returns {Promise<{}>}
+   */
+  shippingCarriersDefaults() {
+    const apiPath = "/v1/shipping/carriers/defaults";
+    const apiPayload = {};
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {};
+    return this.client.call(
+      "post",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  shippingCarriersDelete(paramsOrFirst) {
+    let params;
+    if (paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst)) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        id: paramsOrFirst
+      };
+    }
+    const id = params.id;
+    if (typeof id === "undefined") {
+      throw new client.RevenexxException('Missing required parameter: "id"');
+    }
+    const apiPath = "/v1/shipping/carriers/{id}".replace("{id}", id);
+    const apiPayload = {};
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {};
+    return this.client.call(
+      "delete",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  shippingCarriersGet(paramsOrFirst) {
+    let params;
+    if (paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst)) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        id: paramsOrFirst
+      };
+    }
+    const id = params.id;
+    if (typeof id === "undefined") {
+      throw new client.RevenexxException('Missing required parameter: "id"');
+    }
+    const apiPath = "/v1/shipping/carriers/{id}".replace("{id}", id);
+    const apiPayload = {};
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {};
+    return this.client.call(
+      "get",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  shippingCarriersUpdate(paramsOrFirst, ...rest) {
+    let params;
+    if (paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst)) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        id: paramsOrFirst,
+        code: rest[0],
+        countries: rest[1],
+        cutoffTime: rest[2],
+        etaDaysMax: rest[3],
+        etaDaysMin: rest[4],
+        handlingDays: rest[5],
+        labels: rest[6],
+        metadata: rest[7],
+        name: rest[8],
+        position: rest[9],
+        serviceLevel: rest[10],
+        status: rest[11],
+        trackingUrlTemplate: rest[12]
+      };
+    }
+    const id = params.id;
+    const code = params.code;
+    const countries = params.countries;
+    const cutoffTime = params.cutoffTime;
+    const etaDaysMax = params.etaDaysMax;
+    const etaDaysMin = params.etaDaysMin;
+    const handlingDays = params.handlingDays;
+    const labels = params.labels;
+    const metadata = params.metadata;
+    const name = params.name;
+    const position = params.position;
+    const serviceLevel = params.serviceLevel;
+    const status = params.status;
+    const trackingUrlTemplate = params.trackingUrlTemplate;
+    if (typeof id === "undefined") {
+      throw new client.RevenexxException('Missing required parameter: "id"');
+    }
+    const apiPath = "/v1/shipping/carriers/{id}".replace("{id}", id);
+    const apiPayload = {};
+    if (typeof code !== "undefined") {
+      apiPayload["code"] = code;
+    }
+    if (typeof countries !== "undefined") {
+      apiPayload["countries"] = countries;
+    }
+    if (typeof cutoffTime !== "undefined") {
+      apiPayload["cutoff_time"] = cutoffTime;
+    }
+    if (typeof etaDaysMax !== "undefined") {
+      apiPayload["eta_days_max"] = etaDaysMax;
+    }
+    if (typeof etaDaysMin !== "undefined") {
+      apiPayload["eta_days_min"] = etaDaysMin;
+    }
+    if (typeof handlingDays !== "undefined") {
+      apiPayload["handling_days"] = handlingDays;
+    }
+    if (typeof labels !== "undefined") {
+      apiPayload["labels"] = labels;
+    }
+    if (typeof metadata !== "undefined") {
+      apiPayload["metadata"] = metadata;
+    }
+    if (typeof name !== "undefined") {
+      apiPayload["name"] = name;
+    }
+    if (typeof position !== "undefined") {
+      apiPayload["position"] = position;
+    }
+    if (typeof serviceLevel !== "undefined") {
+      apiPayload["service_level"] = serviceLevel;
+    }
+    if (typeof status !== "undefined") {
+      apiPayload["status"] = status;
+    }
+    if (typeof trackingUrlTemplate !== "undefined") {
+      apiPayload["tracking_url_template"] = trackingUrlTemplate;
+    }
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {
+      "content-type": "application/json"
+    };
+    return this.client.call(
+      "put",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  shippingTracking(paramsOrFirst, ...rest) {
+    let params;
+    if (paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst)) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        carrier: paramsOrFirst,
+        country: rest[0],
+        postalCode: rest[1],
+        trackingCode: rest[2]
+      };
+    }
+    const carrier = params.carrier;
+    const country = params.country;
+    const postalCode = params.postalCode;
+    const trackingCode = params.trackingCode;
+    if (typeof carrier === "undefined") {
+      throw new client.RevenexxException('Missing required parameter: "carrier"');
+    }
+    const apiPath = "/v1/shipping/tracking";
+    const apiPayload = {};
+    if (typeof carrier !== "undefined") {
+      apiPayload["carrier"] = carrier;
+    }
+    if (typeof country !== "undefined") {
+      apiPayload["country"] = country;
+    }
+    if (typeof postalCode !== "undefined") {
+      apiPayload["postal_code"] = postalCode;
+    }
+    if (typeof trackingCode !== "undefined") {
+      apiPayload["tracking_code"] = trackingCode;
+    }
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {
+      "content-type": "application/json"
+    };
+    return this.client.call(
+      "post",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+}
+
+exports.ShippingCarriers = ShippingCarriers;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=shipping-carriers.js.map

package/dist/services/shipping-carriers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/shipping-carriers.ts"],"names":[],"mappings":"AAAA,SAAS,yBAA+D;AAMjE,MAAM,iBAAiB;AAAA,EAG1B,YAAY,QAAgB;AACxB,SAAK,SAAS;AAAA,EAClB;AAAA,EA6BA,qBACI,kBACG,MACkB;AACrB,QAAI;AAEJ,QAAI,CAAC,iBAAkB,iBAAiB,OAAO,kBAAkB,YAAY,CAAC,MAAM,QAAQ,aAAa,GAAI;AACzG,eAAU,iBAAiB,CAAC;AAAA,IAChC,OAAO;AACH,eAAS;AAAA,QACL,OAAO;AAAA,QACP,QAAQ,KAAK,CAAC;AAAA,QACd,OAAO,KAAK,CAAC;AAAA,QACb,MAAM,KAAK,CAAC;AAAA,QACZ,QAAQ,KAAK,CAAC;AAAA,QACd,cAAc,KAAK,CAAC;AAAA,MACxB;AAAA,IACJ;AAEA,UAAM,QAAQ,OAAO;AACrB,UAAM,SAAS,OAAO;AACtB,UAAM,QAAQ,OAAO;AACrB,UAAM,OAAO,OAAO;AACpB,UAAM,SAAS,OAAO;AACtB,UAAM,eAAe,OAAO;AAG5B,UAAM,UAAU;AAChB,UAAM,aAAsB,CAAC;AAC7B,QAAI,OAAO,UAAU,aAAa;AAC9B,iBAAW,OAAO,IAAI;AAAA,IAC1B;AACA,QAAI,OAAO,WAAW,aAAa;AAC/B,iBAAW,QAAQ,IAAI;AAAA,IAC3B;AACA,QAAI,OAAO,UAAU,aAAa;AAC9B,iBAAW,OAAO,IAAI;AAAA,IAC1B;AACA,QAAI,OAAO,SAAS,aAAa;AAC7B,iBAAW,MAAM,IAAI;AAAA,IACzB;AACA,QAAI,OAAO,WAAW,aAAa;AAC/B,iBAAW,QAAQ,IAAI;AAAA,IAC3B;AACA,QAAI,OAAO,iBAAiB,aAAa;AACrC,iBAAW,eAAe,IAAI;AAAA,IAClC;AACA,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,OAAO,WAAW,OAAO;AAEzD,UAAM,aAA2C,CACjD;AAEA,WAAO,KAAK,OAAO;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AAAA,EA2CA,uBACI,kBACG,MACkB;AACrB,QAAI;AAEJ,QAAK,iBAAiB,OAAO,kBAAkB,YAAY,CAAC,MAAM,QAAQ,aAAa,GAAI;AACvF,eAAU,iBAAiB,CAAC;AAAA,IAChC,OAAO;AACH,eAAS;AAAA,QACL,MAAM;AAAA,QACN,MAAM,KAAK,CAAC;AAAA,QACZ,WAAW,KAAK,CAAC;AAAA,QACjB,YAAY,KAAK,CAAC;AAAA,QAClB,YAAY,KAAK,CAAC;AAAA,QAClB,YAAY,KAAK,CAAC;AAAA,QAClB,cAAc,KAAK,CAAC;AAAA,QACpB,QAAQ,KAAK,CAAC;AAAA,QACd,UAAU,KAAK,CAAC;AAAA,QAChB,UAAU,KAAK,CAAC;AAAA,QAChB,cAAc,KAAK,CAAC;AAAA,QACpB,QAAQ,KAAK,EAAE;AAAA,QACf,qBAAqB,KAAK,EAAE;AAAA,MAChC;AAAA,IACJ;AAEA,UAAM,OAAO,OAAO;AACpB,UAAM,OAAO,OAAO;AACpB,UAAM,YAAY,OAAO;AACzB,UAAM,aAAa,OAAO;AAC1B,UAAM,aAAa,OAAO;AAC1B,UAAM,aAAa,OAAO;AAC1B,UAAM,eAAe,OAAO;AAC5B,UAAM,SAAS,OAAO;AACtB,UAAM,WAAW,OAAO;AACxB,UAAM,WAAW,OAAO;AACxB,UAAM,eAAe,OAAO;AAC5B,UAAM,SAAS,OAAO;AACtB,UAAM,sBAAsB,OAAO;AAEnC,QAAI,OAAO,SAAS,aAAa;AAC7B,YAAM,IAAI,kBAAkB,oCAAoC;AAAA,IACpE;AACA,QAAI,OAAO,SAAS,aAAa;AAC7B,YAAM,IAAI,kBAAkB,oCAAoC;AAAA,IACpE;AAEA,UAAM,UAAU;AAChB,UAAM,aAAsB,CAAC;AAC7B,QAAI,OAAO,SAAS,aAAa;AAC7B,iBAAW,MAAM,IAAI;AAAA,IACzB;AACA,QAAI,OAAO,cAAc,aAAa;AAClC,iBAAW,WAAW,IAAI;AAAA,IAC9B;AACA,QAAI,OAAO,eAAe,aAAa;AACnC,iBAAW,aAAa,IAAI;AAAA,IAChC;AACA,QAAI,OAAO,eAAe,aAAa;AACnC,iBAAW,cAAc,IAAI;AAAA,IACjC;AACA,QAAI,OAAO,eAAe,aAAa;AACnC,iBAAW,cAAc,IAAI;AAAA,IACjC;AACA,QAAI,OAAO,iBAAiB,aAAa;AACrC,iBAAW,eAAe,IAAI;AAAA,IAClC;AACA,QAAI,OAAO,WAAW,aAAa;AAC/B,iBAAW,QAAQ,IAAI;AAAA,IAC3B;AACA,QAAI,OAAO,aAAa,aAAa;AACjC,iBAAW,UAAU,IAAI;AAAA,IAC7B;AACA,QAAI,OAAO,SAAS,aAAa;AAC7B,iBAAW,MAAM,IAAI;AAAA,IACzB;AACA,QAAI,OAAO,aAAa,aAAa;AACjC,iBAAW,UAAU,IAAI;AAAA,IAC7B;AACA,QAAI,OAAO,iBAAiB,aAAa;AACrC,iBAAW,eAAe,IAAI;AAAA,IAClC;AACA,QAAI,OAAO,WAAW,aAAa;AAC/B,iBAAW,QAAQ,IAAI;AAAA,IAC3B;AACA,QAAI,OAAO,wBAAwB,aAAa;AAC5C,iBAAW,uBAAuB,IAAI;AAAA,IAC1C;AACA,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,OAAO,WAAW,OAAO;AAEzD,UAAM,aAA2C;AAAA,MAC7C,gBAAgB;AAAA,IACpB;AAEA,WAAO,KAAK,OAAO;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,0BAAuC;AAEnC,UAAM,UAAU;AAChB,UAAM,aAAsB,CAAC;AAC7B,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,OAAO,WAAW,OAAO;AAEzD,UAAM,aAA2C,CACjD;AAEA,WAAO,KAAK,OAAO;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,2BAAwC;AAEpC,UAAM,UAAU;AAChB,UAAM,aAAsB,CAAC;AAC7B,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,OAAO,WAAW,OAAO;AAEzD,UAAM,aAA2C,CACjD;AAEA,WAAO,KAAK,OAAO;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AAAA,EAmBA,uBACI,eACqB;AACrB,QAAI;AAEJ,QAAK,iBAAiB,OAAO,kBAAkB,YAAY,CAAC,MAAM,QAAQ,aAAa,GAAI;AACvF,eAAU,iBAAiB,CAAC;AAAA,IAChC,OAAO;AACH,eAAS;AAAA,QACL,IAAI;AAAA,MACR;AAAA,IACJ;AAEA,UAAM,KAAK,OAAO;AAElB,QAAI,OAAO,OAAO,aAAa;AAC3B,YAAM,IAAI,kBAAkB,kCAAkC;AAAA,IAClE;AAEA,UAAM,UAAU,6BAA6B,QAAQ,QAAQ,EAAE;AAC/D,UAAM,aAAsB,CAAC;AAC7B,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,OAAO,WAAW,OAAO;AAEzD,UAAM,aAA2C,CACjD;AAEA,WAAO,KAAK,OAAO;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AAAA,EAmBA,oBACI,eACqB;AACrB,QAAI;AAEJ,QAAK,iBAAiB,OAAO,kBAAkB,YAAY,CAAC,MAAM,QAAQ,aAAa,GAAI;AACvF,eAAU,iBAAiB,CAAC;AAAA,IAChC,OAAO;AACH,eAAS;AAAA,QACL,IAAI;AAAA,MACR;AAAA,IACJ;AAEA,UAAM,KAAK,OAAO;AAElB,QAAI,OAAO,OAAO,aAAa;AAC3B,YAAM,IAAI,kBAAkB,kCAAkC;AAAA,IAClE;AAEA,UAAM,UAAU,6BAA6B,QAAQ,QAAQ,EAAE;AAC/D,UAAM,aAAsB,CAAC;AAC7B,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,OAAO,WAAW,OAAO;AAEzD,UAAM,aAA2C,CACjD;AAEA,WAAO,KAAK,OAAO;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AAAA,EA6CA,uBACI,kBACG,MACkB;AACrB,QAAI;AAEJ,QAAK,iBAAiB,OAAO,kBAAkB,YAAY,CAAC,MAAM,QAAQ,aAAa,GAAI;AACvF,eAAU,iBAAiB,CAAC;AAAA,IAChC,OAAO;AACH,eAAS;AAAA,QACL,IAAI;AAAA,QACJ,MAAM,KAAK,CAAC;AAAA,QACZ,WAAW,KAAK,CAAC;AAAA,QACjB,YAAY,KAAK,CAAC;AAAA,QAClB,YAAY,KAAK,CAAC;AAAA,QAClB,YAAY,KAAK,CAAC;AAAA,QAClB,cAAc,KAAK,CAAC;AAAA,QACpB,QAAQ,KAAK,CAAC;AAAA,QACd,UAAU,KAAK,CAAC;AAAA,QAChB,MAAM,KAAK,CAAC;AAAA,QACZ,UAAU,KAAK,CAAC;AAAA,QAChB,cAAc,KAAK,EAAE;AAAA,QACrB,QAAQ,KAAK,EAAE;AAAA,QACf,qBAAqB,KAAK,EAAE;AAAA,MAChC;AAAA,IACJ;AAEA,UAAM,KAAK,OAAO;AAClB,UAAM,OAAO,OAAO;AACpB,UAAM,YAAY,OAAO;AACzB,UAAM,aAAa,OAAO;AAC1B,UAAM,aAAa,OAAO;AAC1B,UAAM,aAAa,OAAO;AAC1B,UAAM,eAAe,OAAO;AAC5B,UAAM,SAAS,OAAO;AACtB,UAAM,WAAW,OAAO;AACxB,UAAM,OAAO,OAAO;AACpB,UAAM,WAAW,OAAO;AACxB,UAAM,eAAe,OAAO;AAC5B,UAAM,SAAS,OAAO;AACtB,UAAM,sBAAsB,OAAO;AAEnC,QAAI,OAAO,OAAO,aAAa;AAC3B,YAAM,IAAI,kBAAkB,kCAAkC;AAAA,IAClE;AAEA,UAAM,UAAU,6BAA6B,QAAQ,QAAQ,EAAE;AAC/D,UAAM,aAAsB,CAAC;AAC7B,QAAI,OAAO,SAAS,aAAa;AAC7B,iBAAW,MAAM,IAAI;AAAA,IACzB;AACA,QAAI,OAAO,cAAc,aAAa;AAClC,iBAAW,WAAW,IAAI;AAAA,IAC9B;AACA,QAAI,OAAO,eAAe,aAAa;AACnC,iBAAW,aAAa,IAAI;AAAA,IAChC;AACA,QAAI,OAAO,eAAe,aAAa;AACnC,iBAAW,cAAc,IAAI;AAAA,IACjC;AACA,QAAI,OAAO,eAAe,aAAa;AACnC,iBAAW,cAAc,IAAI;AAAA,IACjC;AACA,QAAI,OAAO,iBAAiB,aAAa;AACrC,iBAAW,eAAe,IAAI;AAAA,IAClC;AACA,QAAI,OAAO,WAAW,aAAa;AAC/B,iBAAW,QAAQ,IAAI;AAAA,IAC3B;AACA,QAAI,OAAO,aAAa,aAAa;AACjC,iBAAW,UAAU,IAAI;AAAA,IAC7B;AACA,QAAI,OAAO,SAAS,aAAa;AAC7B,iBAAW,MAAM,IAAI;AAAA,IACzB;AACA,QAAI,OAAO,aAAa,aAAa;AACjC,iBAAW,UAAU,IAAI;AAAA,IAC7B;AACA,QAAI,OAAO,iBAAiB,aAAa;AACrC,iBAAW,eAAe,IAAI;AAAA,IAClC;AACA,QAAI,OAAO,WAAW,aAAa;AAC/B,iBAAW,QAAQ,IAAI;AAAA,IAC3B;AACA,QAAI,OAAO,wBAAwB,aAAa;AAC5C,iBAAW,uBAAuB,IAAI;AAAA,IAC1C;AACA,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,OAAO,WAAW,OAAO;AAEzD,UAAM,aAA2C;AAAA,MAC7C,gBAAgB;AAAA,IACpB;AAEA,WAAO,KAAK,OAAO;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AAAA,EAyBA,iBACI,kBACG,MACkB;AACrB,QAAI;AAEJ,QAAK,iBAAiB,OAAO,kBAAkB,YAAY,CAAC,MAAM,QAAQ,aAAa,GAAI;AACvF,eAAU,iBAAiB,CAAC;AAAA,IAChC,OAAO;AACH,eAAS;AAAA,QACL,SAAS;AAAA,QACT,SAAS,KAAK,CAAC;AAAA,QACf,YAAY,KAAK,CAAC;AAAA,QAClB,cAAc,KAAK,CAAC;AAAA,MACxB;AAAA,IACJ;AAEA,UAAM,UAAU,OAAO;AACvB,UAAM,UAAU,OAAO;AACvB,UAAM,aAAa,OAAO;AAC1B,UAAM,eAAe,OAAO;AAE5B,QAAI,OAAO,YAAY,aAAa;AAChC,YAAM,IAAI,kBAAkB,uCAAuC;AAAA,IACvE;AAEA,UAAM,UAAU;AAChB,UAAM,aAAsB,CAAC;AAC7B,QAAI,OAAO,YAAY,aAAa;AAChC,iBAAW,SAAS,IAAI;AAAA,IAC5B;AACA,QAAI,OAAO,YAAY,aAAa;AAChC,iBAAW,SAAS,IAAI;AAAA,IAC5B;AACA,QAAI,OAAO,eAAe,aAAa;AACnC,iBAAW,aAAa,IAAI;AAAA,IAChC;AACA,QAAI,OAAO,iBAAiB,aAAa;AACrC,iBAAW,eAAe,IAAI;AAAA,IAClC;AACA,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,OAAO,WAAW,OAAO;AAEzD,UAAM,aAA2C;AAAA,MAC7C,gBAAgB;AAAA,IACpB;AAEA,WAAO,KAAK,OAAO;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AACJ","sourcesContent":["import { RevenexxException, Client, type Payload, UploadProgress } from '../client';\nimport type { Models } from '../models';\n\nimport { ShippingCarriersListStatus } from '../enums/shipping-carriers-list-status';\nimport { ShippingCarrierStatus } from '../enums/shipping-carrier-status';\n\nexport class ShippingCarriers {\n    client: Client;\n\n    constructor(client: Client) {\n        this.client = client;\n    }\n\n    /**\n     * Filterable by exact column value — `?code=`, `?status=` and `?service_level=` are applied as equalities and echoed back in `filter`. A query key that names no column of this entity is SILENTLY IGNORED: the page comes back unfiltered, 200, with an empty `filter`, so compare the echo against what you sent rather than trusting the status.\n     *\n     * @param {number} params.limit - Page size (default 50, max 200). A value outside the range is clamped rather than refused, and `page.limit` echoes what was applied.\n     * @param {number} params.offset - Row offset for pagination (default 0). The next page is `page.offset + page.returned`.\n     * @param {string} params.order - Sort as 'column.asc' | 'column.desc' — a bare 'column' sorts ascending. The column must be one this entity has; anything else is a 400 from the data plane.\n     * @param {string} params.code - Exact-match filter on `code`. Unique per tenant, so this resolves a code an order shipment already stores without paging the whole list.\n     * @param {ShippingCarriersListStatus} params.status - Exact-match filter on `status`. Quoting state — the cheap way to list only the carriers that may currently be quoted.\n     * @param {string} params.serviceLevel - Exact-match filter on `service_level`. A code into the tenant's own service levels (GET /shipping/service-levels).\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    shippingCarriersList(params?: { limit?: number, offset?: number, order?: string, code?: string, status?: ShippingCarriersListStatus, serviceLevel?: string }): Promise<Models.Error>;\n    /**\n     * Filterable by exact column value — `?code=`, `?status=` and `?service_level=` are applied as equalities and echoed back in `filter`. A query key that names no column of this entity is SILENTLY IGNORED: the page comes back unfiltered, 200, with an empty `filter`, so compare the echo against what you sent rather than trusting the status.\n     *\n     * @param {number} limit - Page size (default 50, max 200). A value outside the range is clamped rather than refused, and `page.limit` echoes what was applied.\n     * @param {number} offset - Row offset for pagination (default 0). The next page is `page.offset + page.returned`.\n     * @param {string} order - Sort as 'column.asc' | 'column.desc' — a bare 'column' sorts ascending. The column must be one this entity has; anything else is a 400 from the data plane.\n     * @param {string} code - Exact-match filter on `code`. Unique per tenant, so this resolves a code an order shipment already stores without paging the whole list.\n     * @param {ShippingCarriersListStatus} status - Exact-match filter on `status`. Quoting state — the cheap way to list only the carriers that may currently be quoted.\n     * @param {string} serviceLevel - Exact-match filter on `service_level`. A code into the tenant's own service levels (GET /shipping/service-levels).\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    shippingCarriersList(limit?: number, offset?: number, order?: string, code?: string, status?: ShippingCarriersListStatus, serviceLevel?: string): Promise<Models.Error>;\n    shippingCarriersList(\n        paramsOrFirst?: { limit?: number, offset?: number, order?: string, code?: string, status?: ShippingCarriersListStatus, serviceLevel?: string } | number,\n        ...rest: [(number)?, (string)?, (string)?, (ShippingCarriersListStatus)?, (string)?]    \n    ): Promise<Models.Error> {\n        let params: { limit?: number, offset?: number, order?: string, code?: string, status?: ShippingCarriersListStatus, serviceLevel?: string };\n        \n        if (!paramsOrFirst || (paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { limit?: number, offset?: number, order?: string, code?: string, status?: ShippingCarriersListStatus, serviceLevel?: string };\n        } else {\n            params = {\n                limit: paramsOrFirst as number,\n                offset: rest[0] as number,\n                order: rest[1] as string,\n                code: rest[2] as string,\n                status: rest[3] as ShippingCarriersListStatus,\n                serviceLevel: rest[4] as string            \n            };\n        }\n        \n        const limit = params.limit;\n        const offset = params.offset;\n        const order = params.order;\n        const code = params.code;\n        const status = params.status;\n        const serviceLevel = params.serviceLevel;\n\n\n        const apiPath = '/v1/shipping/carriers';\n        const apiPayload: Payload = {};\n        if (typeof limit !== 'undefined') {\n            apiPayload['limit'] = limit;\n        }\n        if (typeof offset !== 'undefined') {\n            apiPayload['offset'] = offset;\n        }\n        if (typeof order !== 'undefined') {\n            apiPayload['order'] = order;\n        }\n        if (typeof code !== 'undefined') {\n            apiPayload['code'] = code;\n        }\n        if (typeof status !== 'undefined') {\n            apiPayload['status'] = status;\n        }\n        if (typeof serviceLevel !== 'undefined') {\n            apiPayload['service_level'] = serviceLevel;\n        }\n        const uri = new URL(this.client.config.endpoint + apiPath);\n\n        const apiHeaders: { [header: string]: string } = {\n        }\n\n        return this.client.call(\n            'get',\n            uri,\n            apiHeaders,\n            apiPayload,\n        );\n    }\n\n    /**\n     * A carrier row is one company shipping one class of service: it owns the tracking-URL template, the service level, the transit days, the pickup cut-off and the handling days, and every method that ships with it inherits all of those unless it states its own. A carrier selling both a parcel and an express product is two rows. Reach for it for a carrier this app does not describe — a regional courier, a forwarder, an own fleet; for the DACH networks read GET /shipping/carriers/catalog and let POST /shipping/carriers/defaults write them. A create cannot omit `code` and `name`; every other column is optional or defaulted by the database. Two rows of this tenant may not share `code` — that is the 409. `service_level` has to name one of the tenant's own levels and `cutoff_time` has to be HH:MM in 24-hour UTC — both are refused rather than stored, because a cut-off the estimator cannot read would be dropped in silence and the shop would keep promising a ship date nobody computed. Creating a carrier quotes nothing on its own: a method has to reference it (`carrier_id`, or a `carrier` text equal to this code) before any of it is inherited.\n     *\n     * @param {string} params.code - Stable carrier code, unique per tenant (e.g. dhl, dpd, gls). A method whose `carrier` text equals this code resolves to this carrier — that is the migration path off the free-text field. Deliberately no slug pattern: the column asks only for a non-empty string, and a contract stricter than the implementation would refuse codes merchants already keep.\n     * @param {string} params.name - Display name, as an operator typed it.\n     * @param {string[]} params.countries - The countries this carrier serves. ISO 3166-1 alpha-2 codes; null or an empty array means no restriction. Compared upper-cased, so a lower-case entry still matches. Declared as an array rather than the bare object a jsonb column derives to — this one is always a list. ANDed with the method's own restriction: a method may not be offered into a country its carrier does not reach.\n     * @param {string} params.cutoffTime - This carrier's own daily pickup cut-off, HH:MM in 24-hour form, UTC. Overrides the tenant's cutoff_time for methods on this carrier — one shop-wide time cannot be both DHL's 16:00 and a forwarder's 12:00. Null or the empty string means this carrier declares none; any other shape is a 400, because a cut-off the estimator cannot read is a delivery promise silently computed without one.\n     * @param {number} params.etaDaysMax - Transit time upper bound, in calendar days from the ship date.\n     * @param {number} params.etaDaysMin - Transit time lower bound, in calendar days from the ship date — inherited by any method on this carrier that states no ETA of its own.\n     * @param {number} params.handlingDays - Days needed to make a consignment ready for THIS carrier, added to the ship date before the transit days. Overrides the tenant's handling_days.\n     * @param {object} params.labels - Localized display names. A flat map keyed by locale — the Cockpit falls back to `en`. Null means the row has no translations and every client shows the untranslated column instead.\n     * @param {object} params.metadata - Free-form jsonb the platform never reads or validates — whatever the merchant or their integration needs to keep beside the row (a customer number with the carrier, an ERP key, a label-printer id). The shape varies BY INTEGRATION, not by anything this app knows, so no key is declared and none is reserved; the example is one plausible instance rather than a schema. A flat map of scalars is the convention, and nothing enforces it.\n     * @param {number} params.position - Sort order among the carriers; ties fall back to whatever the database returns.\n     * @param {string} params.serviceLevel - The class of service this row represents (default 'standard'), as a CODE into the tenant's own service levels (GET /shipping/service-levels). One row is one class: a carrier selling both a parcel and an express product is two rows. Deliberately not an enum here — the set is the merchant's, so a fixed list in this contract would make the gateway reject a level they created. A code the tenant does not keep is a 400 naming the codes they do.\n     * @param {ShippingCarrierStatus} params.status - Whether this carrier may be quoted (default 'active'). Anything else excludes every method that ships with it from POST /shipping/rates, with a reason. Tracking links are NOT gated on it — a retired carrier's old shipments stay resolvable.\n     * @param {string} params.trackingUrlTemplate - Tracking page URL with {tracking_code} where the number goes; {postal_code} and {country} are also substituted, URL-encoded. Null for a carrier with no public tracking page.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    shippingCarriersCreate(params: { code: string, name: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string }): Promise<Models.Error>;\n    /**\n     * A carrier row is one company shipping one class of service: it owns the tracking-URL template, the service level, the transit days, the pickup cut-off and the handling days, and every method that ships with it inherits all of those unless it states its own. A carrier selling both a parcel and an express product is two rows. Reach for it for a carrier this app does not describe — a regional courier, a forwarder, an own fleet; for the DACH networks read GET /shipping/carriers/catalog and let POST /shipping/carriers/defaults write them. A create cannot omit `code` and `name`; every other column is optional or defaulted by the database. Two rows of this tenant may not share `code` — that is the 409. `service_level` has to name one of the tenant's own levels and `cutoff_time` has to be HH:MM in 24-hour UTC — both are refused rather than stored, because a cut-off the estimator cannot read would be dropped in silence and the shop would keep promising a ship date nobody computed. Creating a carrier quotes nothing on its own: a method has to reference it (`carrier_id`, or a `carrier` text equal to this code) before any of it is inherited.\n     *\n     * @param {string} code - Stable carrier code, unique per tenant (e.g. dhl, dpd, gls). A method whose `carrier` text equals this code resolves to this carrier — that is the migration path off the free-text field. Deliberately no slug pattern: the column asks only for a non-empty string, and a contract stricter than the implementation would refuse codes merchants already keep.\n     * @param {string} name - Display name, as an operator typed it.\n     * @param {string[]} countries - The countries this carrier serves. ISO 3166-1 alpha-2 codes; null or an empty array means no restriction. Compared upper-cased, so a lower-case entry still matches. Declared as an array rather than the bare object a jsonb column derives to — this one is always a list. ANDed with the method's own restriction: a method may not be offered into a country its carrier does not reach.\n     * @param {string} cutoffTime - This carrier's own daily pickup cut-off, HH:MM in 24-hour form, UTC. Overrides the tenant's cutoff_time for methods on this carrier — one shop-wide time cannot be both DHL's 16:00 and a forwarder's 12:00. Null or the empty string means this carrier declares none; any other shape is a 400, because a cut-off the estimator cannot read is a delivery promise silently computed without one.\n     * @param {number} etaDaysMax - Transit time upper bound, in calendar days from the ship date.\n     * @param {number} etaDaysMin - Transit time lower bound, in calendar days from the ship date — inherited by any method on this carrier that states no ETA of its own.\n     * @param {number} handlingDays - Days needed to make a consignment ready for THIS carrier, added to the ship date before the transit days. Overrides the tenant's handling_days.\n     * @param {object} labels - Localized display names. A flat map keyed by locale — the Cockpit falls back to `en`. Null means the row has no translations and every client shows the untranslated column instead.\n     * @param {object} metadata - Free-form jsonb the platform never reads or validates — whatever the merchant or their integration needs to keep beside the row (a customer number with the carrier, an ERP key, a label-printer id). The shape varies BY INTEGRATION, not by anything this app knows, so no key is declared and none is reserved; the example is one plausible instance rather than a schema. A flat map of scalars is the convention, and nothing enforces it.\n     * @param {number} position - Sort order among the carriers; ties fall back to whatever the database returns.\n     * @param {string} serviceLevel - The class of service this row represents (default 'standard'), as a CODE into the tenant's own service levels (GET /shipping/service-levels). One row is one class: a carrier selling both a parcel and an express product is two rows. Deliberately not an enum here — the set is the merchant's, so a fixed list in this contract would make the gateway reject a level they created. A code the tenant does not keep is a 400 naming the codes they do.\n     * @param {ShippingCarrierStatus} status - Whether this carrier may be quoted (default 'active'). Anything else excludes every method that ships with it from POST /shipping/rates, with a reason. Tracking links are NOT gated on it — a retired carrier's old shipments stay resolvable.\n     * @param {string} trackingUrlTemplate - Tracking page URL with {tracking_code} where the number goes; {postal_code} and {country} are also substituted, URL-encoded. Null for a carrier with no public tracking page.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    shippingCarriersCreate(code: string, name: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string): Promise<Models.Error>;\n    shippingCarriersCreate(\n        paramsOrFirst: { code: string, name: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string } | string,\n        ...rest: [(string)?, (string[])?, (string)?, (number)?, (number)?, (number)?, (object)?, (object)?, (number)?, (string)?, (ShippingCarrierStatus)?, (string)?]    \n    ): Promise<Models.Error> {\n        let params: { code: string, name: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string };\n        \n        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { code: string, name: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string };\n        } else {\n            params = {\n                code: paramsOrFirst as string,\n                name: rest[0] as string,\n                countries: rest[1] as string[],\n                cutoffTime: rest[2] as string,\n                etaDaysMax: rest[3] as number,\n                etaDaysMin: rest[4] as number,\n                handlingDays: rest[5] as number,\n                labels: rest[6] as object,\n                metadata: rest[7] as object,\n                position: rest[8] as number,\n                serviceLevel: rest[9] as string,\n                status: rest[10] as ShippingCarrierStatus,\n                trackingUrlTemplate: rest[11] as string            \n            };\n        }\n        \n        const code = params.code;\n        const name = params.name;\n        const countries = params.countries;\n        const cutoffTime = params.cutoffTime;\n        const etaDaysMax = params.etaDaysMax;\n        const etaDaysMin = params.etaDaysMin;\n        const handlingDays = params.handlingDays;\n        const labels = params.labels;\n        const metadata = params.metadata;\n        const position = params.position;\n        const serviceLevel = params.serviceLevel;\n        const status = params.status;\n        const trackingUrlTemplate = params.trackingUrlTemplate;\n\n        if (typeof code === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"code\"');\n        }\n        if (typeof name === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"name\"');\n        }\n\n        const apiPath = '/v1/shipping/carriers';\n        const apiPayload: Payload = {};\n        if (typeof code !== 'undefined') {\n            apiPayload['code'] = code;\n        }\n        if (typeof countries !== 'undefined') {\n            apiPayload['countries'] = countries;\n        }\n        if (typeof cutoffTime !== 'undefined') {\n            apiPayload['cutoff_time'] = cutoffTime;\n        }\n        if (typeof etaDaysMax !== 'undefined') {\n            apiPayload['eta_days_max'] = etaDaysMax;\n        }\n        if (typeof etaDaysMin !== 'undefined') {\n            apiPayload['eta_days_min'] = etaDaysMin;\n        }\n        if (typeof handlingDays !== 'undefined') {\n            apiPayload['handling_days'] = handlingDays;\n        }\n        if (typeof labels !== 'undefined') {\n            apiPayload['labels'] = labels;\n        }\n        if (typeof metadata !== 'undefined') {\n            apiPayload['metadata'] = metadata;\n        }\n        if (typeof name !== 'undefined') {\n            apiPayload['name'] = name;\n        }\n        if (typeof position !== 'undefined') {\n            apiPayload['position'] = position;\n        }\n        if (typeof serviceLevel !== 'undefined') {\n            apiPayload['service_level'] = serviceLevel;\n        }\n        if (typeof status !== 'undefined') {\n            apiPayload['status'] = status;\n        }\n        if (typeof trackingUrlTemplate !== 'undefined') {\n            apiPayload['tracking_url_template'] = trackingUrlTemplate;\n        }\n        const uri = new URL(this.client.config.endpoint + apiPath);\n\n        const apiHeaders: { [header: string]: string } = {\n            'content-type': 'application/json',\n        }\n\n        return this.client.call(\n            'post',\n            uri,\n            apiHeaders,\n            apiPayload,\n        );\n    }\n\n    /**\n     * The DACH set — the three German parcel networks, the express carriers, the AT/CH incumbents and the pallet forwarders — each with the tracking template, service level, transit time and pickup cut-off it would be created with. `seeded` marks the four a fresh install already has. Adding a carrier is a data change, never a code change, and a merchant may of course create one that is not in here at all.\n     *\n     * @throws {RevenexxException}\n     * @returns {Promise<{}>}\n     */\n    shippingCarriersCatalog(): Promise<{}> {\n\n        const apiPath = '/v1/shipping/carriers/catalog';\n        const apiPayload: Payload = {};\n        const uri = new URL(this.client.config.endpoint + apiPath);\n\n        const apiHeaders: { [header: string]: string } = {\n        }\n\n        return this.client.call(\n            'get',\n            uri,\n            apiHeaders,\n            apiPayload,\n        );\n    }\n\n    /**\n     * The four networks a DACH shop is expected to have — DHL, DPD, GLS and UPS — created by code, and only the ones that are missing. The app runs this itself on `app.installed`, so a fresh install already has them; calling it by hand afterwards is how a tenant that predates a catalog entry catches up, and calling it twice costs nothing, because it reconciles rather than seeds. An existing row belongs to the merchant: only columns that are genuinely EMPTY are filled in (a tracking template added to the catalog after their install), never a value they set. Nothing is deleted.\n     *\n     * @throws {RevenexxException}\n     * @returns {Promise<{}>}\n     */\n    shippingCarriersDefaults(): Promise<{}> {\n\n        const apiPath = '/v1/shipping/carriers/defaults';\n        const apiPayload: Payload = {};\n        const uri = new URL(this.client.config.endpoint + apiPath);\n\n        const apiHeaders: { [header: string]: string } = {\n        }\n\n        return this.client.call(\n            'post',\n            uri,\n            apiHeaders,\n            apiPayload,\n        );\n    }\n\n    /**\n     * Deleting one clears `shipping_methods.carrier_id` rather than deleting those rows — the foreign keys decide that, not this route. So a method that referenced this carrier keeps working and resolves through its `carrier` code instead, which is also why this never answers a conflict — and it is the reason to prefer `status: 'retired'` where the carrier is merely finished. What the method silently LOSES is everything it was inheriting: the tracking template, the pickup cut-off, the handling days and the transit days. Unless its `carrier` text still matches another carrier, its ship date is recomputed on the market's own cut-off and handling settings, and a method that stated no `eta_days_min`/`max` of its own stops carrying a `delivery` estimate altogether. Nothing errors; the promise in the checkout just changes.\n     *\n     * @param {string} params.id - The row id.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    shippingCarriersDelete(params: { id: string }): Promise<Models.Error>;\n    /**\n     * Deleting one clears `shipping_methods.carrier_id` rather than deleting those rows — the foreign keys decide that, not this route. So a method that referenced this carrier keeps working and resolves through its `carrier` code instead, which is also why this never answers a conflict — and it is the reason to prefer `status: 'retired'` where the carrier is merely finished. What the method silently LOSES is everything it was inheriting: the tracking template, the pickup cut-off, the handling days and the transit days. Unless its `carrier` text still matches another carrier, its ship date is recomputed on the market's own cut-off and handling settings, and a method that stated no `eta_days_min`/`max` of its own stops carrying a `delivery` estimate altogether. Nothing errors; the promise in the checkout just changes.\n     *\n     * @param {string} id - The row id.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    shippingCarriersDelete(id: string): Promise<Models.Error>;\n    shippingCarriersDelete(\n        paramsOrFirst: { id: string } | string    \n    ): Promise<Models.Error> {\n        let params: { id: string };\n        \n        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { id: string };\n        } else {\n            params = {\n                id: paramsOrFirst as string            \n            };\n        }\n        \n        const id = params.id;\n\n        if (typeof id === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"id\"');\n        }\n\n        const apiPath = '/v1/shipping/carriers/{id}'.replace('{id}', id);\n        const apiPayload: Payload = {};\n        const uri = new URL(this.client.config.endpoint + apiPath);\n\n        const apiHeaders: { [header: string]: string } = {\n        }\n\n        return this.client.call(\n            'delete',\n            uri,\n            apiHeaders,\n            apiPayload,\n        );\n    }\n\n    /**\n     * A carrier row is one company shipping one class of service: it owns the tracking-URL template, the service level, the transit days, the pickup cut-off and the handling days, and every method that ships with it inherits all of those unless it states its own. A carrier selling both a parcel and an express product is two rows. Read it when you need to know what a method's delivery promise really is: `cutoff_time`, `handling_days` and `eta_days_min`/`max` are inherited from here, so a shop that seems to promise the wrong ship date is usually explained by this row rather than by the method. It does NOT say which methods ship with it — that is GET /shipping/methods?carrier_id=… for the ones holding a reference and ?carrier=… for the ones still resolving through the legacy code text.\n     *\n     * @param {string} params.id - The row id.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    shippingCarriersGet(params: { id: string }): Promise<Models.Error>;\n    /**\n     * A carrier row is one company shipping one class of service: it owns the tracking-URL template, the service level, the transit days, the pickup cut-off and the handling days, and every method that ships with it inherits all of those unless it states its own. A carrier selling both a parcel and an express product is two rows. Read it when you need to know what a method's delivery promise really is: `cutoff_time`, `handling_days` and `eta_days_min`/`max` are inherited from here, so a shop that seems to promise the wrong ship date is usually explained by this row rather than by the method. It does NOT say which methods ship with it — that is GET /shipping/methods?carrier_id=… for the ones holding a reference and ?carrier=… for the ones still resolving through the legacy code text.\n     *\n     * @param {string} id - The row id.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    shippingCarriersGet(id: string): Promise<Models.Error>;\n    shippingCarriersGet(\n        paramsOrFirst: { id: string } | string    \n    ): Promise<Models.Error> {\n        let params: { id: string };\n        \n        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { id: string };\n        } else {\n            params = {\n                id: paramsOrFirst as string            \n            };\n        }\n        \n        const id = params.id;\n\n        if (typeof id === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"id\"');\n        }\n\n        const apiPath = '/v1/shipping/carriers/{id}'.replace('{id}', id);\n        const apiPayload: Payload = {};\n        const uri = new URL(this.client.config.endpoint + apiPath);\n\n        const apiHeaders: { [header: string]: string } = {\n        }\n\n        return this.client.call(\n            'get',\n            uri,\n            apiHeaders,\n            apiPayload,\n        );\n    }\n\n    /**\n     * A carrier row is one company shipping one class of service: it owns the tracking-URL template, the service level, the transit days, the pickup cut-off and the handling days, and every method that ships with it inherits all of those unless it states its own. A carrier selling both a parcel and an express product is two rows. A partial update — send only what changes, which is where a carrier is paused, given a different tracking template, or moved to another pickup cut-off or transit time. This is the one switch that acts on several methods at once, in both directions. Moving `status` off 'active' takes every method that ships with this carrier out of POST /shipping/rates with a reason, which beats disabling each of them and forgetting one; tracking links are deliberately not gated on it, so a retired carrier's old shipments stay resolvable. Editing `cutoff_time`, `handling_days` or `eta_days_min`/`max` MOVES THE PROMISED SHIP DATE of every method that states none of its own: the estimator adds the handling days, then one further day when the cut-off has already passed at the instant being evaluated — compared at or after, in UTC, and as calendar days that do not skip a weekend. Two rows of this tenant may not share `code` — that is the 409.\n     *\n     * @param {string} params.id - The row id.\n     * @param {string} params.code - Stable carrier code, unique per tenant (e.g. dhl, dpd, gls). A method whose `carrier` text equals this code resolves to this carrier — that is the migration path off the free-text field. Deliberately no slug pattern: the column asks only for a non-empty string, and a contract stricter than the implementation would refuse codes merchants already keep.\n     * @param {string[]} params.countries - The countries this carrier serves. ISO 3166-1 alpha-2 codes; null or an empty array means no restriction. Compared upper-cased, so a lower-case entry still matches. Declared as an array rather than the bare object a jsonb column derives to — this one is always a list. ANDed with the method's own restriction: a method may not be offered into a country its carrier does not reach.\n     * @param {string} params.cutoffTime - This carrier's own daily pickup cut-off, HH:MM in 24-hour form, UTC. Overrides the tenant's cutoff_time for methods on this carrier — one shop-wide time cannot be both DHL's 16:00 and a forwarder's 12:00. Null or the empty string means this carrier declares none; any other shape is a 400, because a cut-off the estimator cannot read is a delivery promise silently computed without one.\n     * @param {number} params.etaDaysMax - Transit time upper bound, in calendar days from the ship date.\n     * @param {number} params.etaDaysMin - Transit time lower bound, in calendar days from the ship date — inherited by any method on this carrier that states no ETA of its own.\n     * @param {number} params.handlingDays - Days needed to make a consignment ready for THIS carrier, added to the ship date before the transit days. Overrides the tenant's handling_days.\n     * @param {object} params.labels - Localized display names. A flat map keyed by locale — the Cockpit falls back to `en`. Null means the row has no translations and every client shows the untranslated column instead.\n     * @param {object} params.metadata - Free-form jsonb the platform never reads or validates — whatever the merchant or their integration needs to keep beside the row (a customer number with the carrier, an ERP key, a label-printer id). The shape varies BY INTEGRATION, not by anything this app knows, so no key is declared and none is reserved; the example is one plausible instance rather than a schema. A flat map of scalars is the convention, and nothing enforces it.\n     * @param {string} params.name - Display name, as an operator typed it.\n     * @param {number} params.position - Sort order among the carriers; ties fall back to whatever the database returns.\n     * @param {string} params.serviceLevel - The class of service this row represents (default 'standard'), as a CODE into the tenant's own service levels (GET /shipping/service-levels). One row is one class: a carrier selling both a parcel and an express product is two rows. Deliberately not an enum here — the set is the merchant's, so a fixed list in this contract would make the gateway reject a level they created. A code the tenant does not keep is a 400 naming the codes they do.\n     * @param {ShippingCarrierStatus} params.status - Whether this carrier may be quoted (default 'active'). Anything else excludes every method that ships with it from POST /shipping/rates, with a reason. Tracking links are NOT gated on it — a retired carrier's old shipments stay resolvable.\n     * @param {string} params.trackingUrlTemplate - Tracking page URL with {tracking_code} where the number goes; {postal_code} and {country} are also substituted, URL-encoded. Null for a carrier with no public tracking page.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    shippingCarriersUpdate(params: { id: string, code?: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, name?: string, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string }): Promise<Models.Error>;\n    /**\n     * A carrier row is one company shipping one class of service: it owns the tracking-URL template, the service level, the transit days, the pickup cut-off and the handling days, and every method that ships with it inherits all of those unless it states its own. A carrier selling both a parcel and an express product is two rows. A partial update — send only what changes, which is where a carrier is paused, given a different tracking template, or moved to another pickup cut-off or transit time. This is the one switch that acts on several methods at once, in both directions. Moving `status` off 'active' takes every method that ships with this carrier out of POST /shipping/rates with a reason, which beats disabling each of them and forgetting one; tracking links are deliberately not gated on it, so a retired carrier's old shipments stay resolvable. Editing `cutoff_time`, `handling_days` or `eta_days_min`/`max` MOVES THE PROMISED SHIP DATE of every method that states none of its own: the estimator adds the handling days, then one further day when the cut-off has already passed at the instant being evaluated — compared at or after, in UTC, and as calendar days that do not skip a weekend. Two rows of this tenant may not share `code` — that is the 409.\n     *\n     * @param {string} id - The row id.\n     * @param {string} code - Stable carrier code, unique per tenant (e.g. dhl, dpd, gls). A method whose `carrier` text equals this code resolves to this carrier — that is the migration path off the free-text field. Deliberately no slug pattern: the column asks only for a non-empty string, and a contract stricter than the implementation would refuse codes merchants already keep.\n     * @param {string[]} countries - The countries this carrier serves. ISO 3166-1 alpha-2 codes; null or an empty array means no restriction. Compared upper-cased, so a lower-case entry still matches. Declared as an array rather than the bare object a jsonb column derives to — this one is always a list. ANDed with the method's own restriction: a method may not be offered into a country its carrier does not reach.\n     * @param {string} cutoffTime - This carrier's own daily pickup cut-off, HH:MM in 24-hour form, UTC. Overrides the tenant's cutoff_time for methods on this carrier — one shop-wide time cannot be both DHL's 16:00 and a forwarder's 12:00. Null or the empty string means this carrier declares none; any other shape is a 400, because a cut-off the estimator cannot read is a delivery promise silently computed without one.\n     * @param {number} etaDaysMax - Transit time upper bound, in calendar days from the ship date.\n     * @param {number} etaDaysMin - Transit time lower bound, in calendar days from the ship date — inherited by any method on this carrier that states no ETA of its own.\n     * @param {number} handlingDays - Days needed to make a consignment ready for THIS carrier, added to the ship date before the transit days. Overrides the tenant's handling_days.\n     * @param {object} labels - Localized display names. A flat map keyed by locale — the Cockpit falls back to `en`. Null means the row has no translations and every client shows the untranslated column instead.\n     * @param {object} metadata - Free-form jsonb the platform never reads or validates — whatever the merchant or their integration needs to keep beside the row (a customer number with the carrier, an ERP key, a label-printer id). The shape varies BY INTEGRATION, not by anything this app knows, so no key is declared and none is reserved; the example is one plausible instance rather than a schema. A flat map of scalars is the convention, and nothing enforces it.\n     * @param {string} name - Display name, as an operator typed it.\n     * @param {number} position - Sort order among the carriers; ties fall back to whatever the database returns.\n     * @param {string} serviceLevel - The class of service this row represents (default 'standard'), as a CODE into the tenant's own service levels (GET /shipping/service-levels). One row is one class: a carrier selling both a parcel and an express product is two rows. Deliberately not an enum here — the set is the merchant's, so a fixed list in this contract would make the gateway reject a level they created. A code the tenant does not keep is a 400 naming the codes they do.\n     * @param {ShippingCarrierStatus} status - Whether this carrier may be quoted (default 'active'). Anything else excludes every method that ships with it from POST /shipping/rates, with a reason. Tracking links are NOT gated on it — a retired carrier's old shipments stay resolvable.\n     * @param {string} trackingUrlTemplate - Tracking page URL with {tracking_code} where the number goes; {postal_code} and {country} are also substituted, URL-encoded. Null for a carrier with no public tracking page.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    shippingCarriersUpdate(id: string, code?: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, name?: string, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string): Promise<Models.Error>;\n    shippingCarriersUpdate(\n        paramsOrFirst: { id: string, code?: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, name?: string, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string } | string,\n        ...rest: [(string)?, (string[])?, (string)?, (number)?, (number)?, (number)?, (object)?, (object)?, (string)?, (number)?, (string)?, (ShippingCarrierStatus)?, (string)?]    \n    ): Promise<Models.Error> {\n        let params: { id: string, code?: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, name?: string, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string };\n        \n        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { id: string, code?: string, countries?: string[], cutoffTime?: string, etaDaysMax?: number, etaDaysMin?: number, handlingDays?: number, labels?: object, metadata?: object, name?: string, position?: number, serviceLevel?: string, status?: ShippingCarrierStatus, trackingUrlTemplate?: string };\n        } else {\n            params = {\n                id: paramsOrFirst as string,\n                code: rest[0] as string,\n                countries: rest[1] as string[],\n                cutoffTime: rest[2] as string,\n                etaDaysMax: rest[3] as number,\n                etaDaysMin: rest[4] as number,\n                handlingDays: rest[5] as number,\n                labels: rest[6] as object,\n                metadata: rest[7] as object,\n                name: rest[8] as string,\n                position: rest[9] as number,\n                serviceLevel: rest[10] as string,\n                status: rest[11] as ShippingCarrierStatus,\n                trackingUrlTemplate: rest[12] as string            \n            };\n        }\n        \n        const id = params.id;\n        const code = params.code;\n        const countries = params.countries;\n        const cutoffTime = params.cutoffTime;\n        const etaDaysMax = params.etaDaysMax;\n        const etaDaysMin = params.etaDaysMin;\n        const handlingDays = params.handlingDays;\n        const labels = params.labels;\n        const metadata = params.metadata;\n        const name = params.name;\n        const position = params.position;\n        const serviceLevel = params.serviceLevel;\n        const status = params.status;\n        const trackingUrlTemplate = params.trackingUrlTemplate;\n\n        if (typeof id === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"id\"');\n        }\n\n        const apiPath = '/v1/shipping/carriers/{id}'.replace('{id}', id);\n        const apiPayload: Payload = {};\n        if (typeof code !== 'undefined') {\n            apiPayload['code'] = code;\n        }\n        if (typeof countries !== 'undefined') {\n            apiPayload['countries'] = countries;\n        }\n        if (typeof cutoffTime !== 'undefined') {\n            apiPayload['cutoff_time'] = cutoffTime;\n        }\n        if (typeof etaDaysMax !== 'undefined') {\n            apiPayload['eta_days_max'] = etaDaysMax;\n        }\n        if (typeof etaDaysMin !== 'undefined') {\n            apiPayload['eta_days_min'] = etaDaysMin;\n        }\n        if (typeof handlingDays !== 'undefined') {\n            apiPayload['handling_days'] = handlingDays;\n        }\n        if (typeof labels !== 'undefined') {\n            apiPayload['labels'] = labels;\n        }\n        if (typeof metadata !== 'undefined') {\n            apiPayload['metadata'] = metadata;\n        }\n        if (typeof name !== 'undefined') {\n            apiPayload['name'] = name;\n        }\n        if (typeof position !== 'undefined') {\n            apiPayload['position'] = position;\n        }\n        if (typeof serviceLevel !== 'undefined') {\n            apiPayload['service_level'] = serviceLevel;\n        }\n        if (typeof status !== 'undefined') {\n            apiPayload['status'] = status;\n        }\n        if (typeof trackingUrlTemplate !== 'undefined') {\n            apiPayload['tracking_url_template'] = trackingUrlTemplate;\n        }\n        const uri = new URL(this.client.config.endpoint + apiPath);\n\n        const apiHeaders: { [header: string]: string } = {\n            'content-type': 'application/json',\n        }\n\n        return this.client.call(\n            'put',\n            uri,\n            apiHeaders,\n            apiPayload,\n        );\n    }\n\n    /**\n     * Hand in a carrier code and the tracking number printed on the label, and this answers the URL a buyer follows. The carrier owns the URL format, so nobody else has to. `order_shipments` stores a tracking_url per shipment today, which is one carrier's URL shape copied into every row — the day it changes, every historic link is wrong. Ask here instead. Tracking is NOT gated on carrier status: a retired carrier's old shipments stay resolvable.\n     *\n     * @param {string} params.carrier - Carrier code (what an order shipment already stores) or the carrier row id — a value matching the uuid form is read as the id, anything else as a code, case-insensitively. Must name a carrier THIS tenant keeps; one that does not is a 404.\n     * @param {string} params.country - Destination ISO 3166-1 alpha-2 code — only needed by a template that names {country}. Upper-cased before substitution.\n     * @param {string} params.postalCode - Destination postcode — only needed by a template that names {postal_code}.\n     * @param {string} params.trackingCode - The carrier's tracking number. Required by every template that names {tracking_code}, which is all of them in the shipped catalog. URL-encoded before substitution, so a code with a space or a slash cannot reshape the link.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    shippingTracking(params: { carrier: string, country?: string, postalCode?: string, trackingCode?: string }): Promise<Models.Error>;\n    /**\n     * Hand in a carrier code and the tracking number printed on the label, and this answers the URL a buyer follows. The carrier owns the URL format, so nobody else has to. `order_shipments` stores a tracking_url per shipment today, which is one carrier's URL shape copied into every row — the day it changes, every historic link is wrong. Ask here instead. Tracking is NOT gated on carrier status: a retired carrier's old shipments stay resolvable.\n     *\n     * @param {string} carrier - Carrier code (what an order shipment already stores) or the carrier row id — a value matching the uuid form is read as the id, anything else as a code, case-insensitively. Must name a carrier THIS tenant keeps; one that does not is a 404.\n     * @param {string} country - Destination ISO 3166-1 alpha-2 code — only needed by a template that names {country}. Upper-cased before substitution.\n     * @param {string} postalCode - Destination postcode — only needed by a template that names {postal_code}.\n     * @param {string} trackingCode - The carrier's tracking number. Required by every template that names {tracking_code}, which is all of them in the shipped catalog. URL-encoded before substitution, so a code with a space or a slash cannot reshape the link.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    shippingTracking(carrier: string, country?: string, postalCode?: string, trackingCode?: string): Promise<Models.Error>;\n    shippingTracking(\n        paramsOrFirst: { carrier: string, country?: string, postalCode?: string, trackingCode?: string } | string,\n        ...rest: [(string)?, (string)?, (string)?]    \n    ): Promise<Models.Error> {\n        let params: { carrier: string, country?: string, postalCode?: string, trackingCode?: string };\n        \n        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { carrier: string, country?: string, postalCode?: string, trackingCode?: string };\n        } else {\n            params = {\n                carrier: paramsOrFirst as string,\n                country: rest[0] as string,\n                postalCode: rest[1] as string,\n                trackingCode: rest[2] as string            \n            };\n        }\n        \n        const carrier = params.carrier;\n        const country = params.country;\n        const postalCode = params.postalCode;\n        const trackingCode = params.trackingCode;\n\n        if (typeof carrier === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"carrier\"');\n        }\n\n        const apiPath = '/v1/shipping/tracking';\n        const apiPayload: Payload = {};\n        if (typeof carrier !== 'undefined') {\n            apiPayload['carrier'] = carrier;\n        }\n        if (typeof country !== 'undefined') {\n            apiPayload['country'] = country;\n        }\n        if (typeof postalCode !== 'undefined') {\n            apiPayload['postal_code'] = postalCode;\n        }\n        if (typeof trackingCode !== 'undefined') {\n            apiPayload['tracking_code'] = trackingCode;\n        }\n        const uri = new URL(this.client.config.endpoint + apiPath);\n\n        const apiHeaders: { [header: string]: string } = {\n            'content-type': 'application/json',\n        }\n\n        return this.client.call(\n            'post',\n            uri,\n            apiHeaders,\n            apiPayload,\n        );\n    }\n}\n"]}