@revenexx/node 0.0.1 → 0.1.0

package/dist/services/customers-roles.d.ts

@@ -0,0 +1,279 @@
+import { Client } from '../client.js';
+import { Models } from '../models.js';
+import '../query.js';
+import '../enums/address-type-row-tone.js';
+import '../enums/address-type-row-create-request-tone.js';
+import '../enums/address-type-row-update-request-tone.js';
+import '../enums/assets-source.js';
+import '../enums/attribute-value-bucket.js';
+import '../enums/auth-mail-source.js';
+import '../enums/recovery-mail-source.js';
+import '../enums/registration-status.js';
+import '../enums/budget-change-reason.js';
+import '../enums/budget-movement-result-status.js';
+import '../enums/cart-status.js';
+import '../enums/cart-merge-strategy.js';
+import '../enums/cart-price-snapshot-mode.js';
+import '../enums/cart-io-format.js';
+import '../enums/cart-export-format.js';
+import '../enums/cart-item-type.js';
+import '../enums/cart-vocabulary-tone.js';
+import '../enums/cart-vocabulary-name.js';
+import '../enums/cart-vocabulary-source.js';
+import '../enums/cart-vocabulary-ref-name.js';
+import '../enums/categories-rule-match.js';
+import '../enums/category-rule-operator.js';
+import '../enums/category-rule-match.js';
+import '../enums/channel-status.js';
+import '../enums/channel-unassigned-visibility.js';
+import '../enums/channel-unresolved-reason.js';
+import '../enums/channel-context-source.js';
+import '../enums/channel-inactive-behavior.js';
+import '../enums/channel-policy-source.js';
+import '../enums/channel-policy-tenant-default.js';
+import '../enums/channel-unassigned-policy.js';
+import '../enums/channel-type-tone.js';
+import '../enums/channel-visibility-reason.js';
+import '../enums/channel-vocabulary-tone.js';
+import '../enums/channel-vocabulary-name.js';
+import '../enums/channel-vocabulary-source.js';
+import '../enums/channel-vocabulary-ref-name.js';
+import '../enums/contact-registration-status.js';
+import '../enums/contact-status.js';
+import '../enums/contact-activity-kind.js';
+import '../enums/contact-create-request-registration-status.js';
+import '../enums/contact-event-kind-tone.js';
+import '../enums/contact-event-kind-create-request-tone.js';
+import '../enums/contact-event-kind-update-request-tone.js';
+import '../enums/contact-update-request-registration-status.js';
+import '../enums/cost-center-budget-type.js';
+import '../enums/cost-center-restriction-type.js';
+import '../enums/cost-center-restriction-create-request-type.js';
+import '../enums/cost-center-restriction-update-request-type.js';
+import '../enums/payment-fee-type.js';
+import '../enums/payment-method-kind.js';
+import '../enums/form-status.js';
+import '../enums/form-submission-status.js';
+import '../enums/form-notify-source.js';
+import '../enums/form-submission-prune-request-status.js';
+import '../enums/forms-vocabulary-tone.js';
+import '../enums/forms-vocabulary-name.js';
+import '../enums/forms-vocabulary-summary-name.js';
+import '../enums/inventory-vocabulary-default-tone.js';
+import '../enums/inventory-vocabulary-source.js';
+import '../enums/cart-io-apply-mode.js';
+import '../enums/cart-io-direction.js';
+import '../enums/cart-io-entity.js';
+import '../enums/io-profile-resource-apply-mode.js';
+import '../enums/io-profile-resource-direction.js';
+import '../enums/lifecycle-stage-tone.js';
+import '../enums/lifecycle-stage-create-request-tone.js';
+import '../enums/lifecycle-stage-update-request-tone.js';
+import '../enums/location-type.js';
+import '../enums/market-status.js';
+import '../enums/market-default-locale-source.js';
+import '../enums/market-locale-fallback.js';
+import '../enums/market-locale-granularity.js';
+import '../enums/market-pricing-source.js';
+import '../enums/market-tax-basis.js';
+import '../enums/market-readiness-check-id.js';
+import '../enums/market-readiness-severity.js';
+import '../enums/markets-vocabulary-tone.js';
+import '../enums/markets-vocabulary-name.js';
+import '../enums/markets-vocabulary-source.js';
+import '../enums/markets-vocabulary-summary-name.js';
+import '../enums/order-fulfillment-status.js';
+import '../enums/order-payment-status.js';
+import '../enums/order-status.js';
+import '../enums/order-cancellation-scope.js';
+import '../enums/order-comment-visibility.js';
+import '../enums/order-item-type.js';
+import '../enums/order-list-kind-tone.js';
+import '../enums/order-list-kind-row-tone.js';
+import '../enums/order-list-cart-mode.js';
+import '../enums/order-list-vocabulary-default-tone.js';
+import '../enums/order-list-vocabulary-name.js';
+import '../enums/order-list-vocabulary-source.js';
+import '../enums/order-list-vocabulary-tone.js';
+import '../enums/order-return-status.js';
+import '../enums/order-return-settlement.js';
+import '../enums/order-return-refusal.js';
+import '../enums/order-vocabulary-tone.js';
+import '../enums/order-vocabulary-name.js';
+import '../enums/order-vocabulary-source.js';
+import '../enums/order-vocabulary-summary-name.js';
+import '../enums/order-resolution-stage.js';
+import '../enums/organization-status.js';
+import '../enums/page-status.js';
+import '../enums/pages-vocabulary-app.js';
+import '../enums/pages-vocabulary-tone.js';
+import '../enums/pages-vocabulary-name.js';
+import '../enums/pages-vocabulary-source.js';
+import '../enums/pages-vocabulary-index-app.js';
+import '../enums/payment-dunning-stage.js';
+import '../enums/payment-failure-code.js';
+import '../enums/payment-status.js';
+import '../enums/payment-term-tone.js';
+import '../enums/payment-term-create-request-tone.js';
+import '../enums/payment-term-update-request-tone.js';
+import '../enums/payment-vocabulary-tone.js';
+import '../enums/price-ending-rule.js';
+import '../enums/price-entries-adjust-response-rounding.js';
+import '../enums/price-entries-adjust-response-rounding-mode.js';
+import '../enums/price-entries-bulk-mode.js';
+import '../enums/price-rounding-mode.js';
+import '../enums/price-entry-type.js';
+import '../enums/price-list-status.js';
+import '../enums/price-list-tax-basis.js';
+import '../enums/price-currency-source.js';
+import '../enums/price-list-tiebreak.js';
+import '../enums/price-tax-inclusive-default.js';
+import '../enums/price-tax-unresolved-reason.js';
+import '../enums/price-tax-market-source.js';
+import '../enums/price-vocabulary-tone.js';
+import '../enums/price-vocabulary-name.js';
+import '../enums/price-vocabulary-source.js';
+import '../enums/price-vocabulary-ref-name.js';
+import '../enums/product-categories-source.js';
+import '../enums/product-grid-column-source.js';
+import '../enums/product-label-source.js';
+import '../enums/product-label-attribute-source.js';
+import '../enums/products-kind.js';
+import '../enums/reorder-point-source.js';
+import '../enums/reservation-status.js';
+import '../enums/price-on-request-reason.js';
+import '../enums/price-tax-basis.js';
+import '../enums/price-tax-basis-source.js';
+import '../enums/role-catalog-response-source.js';
+import '../enums/segment-rule-match.js';
+import '../enums/segment-member-source.js';
+import '../enums/segment-rule-operator.js';
+import '../enums/segment-rule-preview-request-rule-match.js';
+import '../enums/segment-rule-preview-request-target.js';
+import '../enums/segment-rule-preview-response-rule-match.js';
+import '../enums/segment-rule-preview-response-target.js';
+import '../enums/segment-rules-target.js';
+import '../enums/shipping-carrier-status.js';
+import '../enums/shipping-method-matrix-basis.js';
+import '../enums/shipping-method-pricing-type.js';
+import '../enums/shipping-carrier-source.js';
+import '../enums/shipping-rate-pricing-type.js';
+import '../enums/shipping-tax-source.js';
+import '../enums/shipping-free-above-basis.js';
+import '../enums/shipping-rates-basis-matrix-basis-default.js';
+import '../enums/shipping-service-level-create-request-tone.js';
+import '../enums/shipping-service-level-row-tone.js';
+import '../enums/shipping-service-level-update-request-tone.js';
+import '../enums/shipping-tax-unresolved-reason.js';
+import '../enums/shipping-tax-market-source.js';
+import '../enums/shipping-tax-context-via.js';
+import '../enums/shipping-tracking-carrier-status.js';
+import '../enums/shipping-vocabulary-default-tone.js';
+import '../enums/shipping-vocabulary-source.js';
+import '../enums/shipping-vocabulary-tone.js';
+import '../enums/shipping-weight-unit-create-request-tone.js';
+import '../enums/shipping-weight-unit-row-tone.js';
+import '../enums/shipping-weight-unit-update-request-tone.js';
+import '../enums/stock-movement-type.js';
+import '../enums/store-asset-request-visibility.js';
+import '../enums/validation-failed-response-status.js';
+import '../enums/vocabulary-default-tone.js';
+import '../enums/vocabulary-source.js';
+import '../enums/vocabulary-tone.js';
+import '../enums/attribute-boolean-status.js';
+import '../enums/attribute-datetime-status.js';
+import '../enums/attribute-email-status.js';
+import '../enums/attribute-enum-status.js';
+import '../enums/attribute-float-status.js';
+import '../enums/attribute-integer-status.js';
+import '../enums/attribute-ip-status.js';
+import '../enums/attribute-line-status.js';
+import '../enums/attribute-longtext-status.js';
+import '../enums/attribute-mediumtext-status.js';
+import '../enums/attribute-point-status.js';
+import '../enums/attribute-polygon-status.js';
+import '../enums/attribute-relationship-status.js';
+import '../enums/attribute-string-status.js';
+import '../enums/attribute-text-status.js';
+import '../enums/attribute-url-status.js';
+import '../enums/attribute-varchar-status.js';
+import '../enums/column-boolean-status.js';
+import '../enums/column-datetime-status.js';
+import '../enums/column-email-status.js';
+import '../enums/column-enum-status.js';
+import '../enums/column-float-status.js';
+import '../enums/column-integer-status.js';
+import '../enums/column-ip-status.js';
+import '../enums/column-line-status.js';
+import '../enums/column-longtext-status.js';
+import '../enums/column-mediumtext-status.js';
+import '../enums/column-point-status.js';
+import '../enums/column-polygon-status.js';
+import '../enums/column-relationship-status.js';
+import '../enums/column-string-status.js';
+import '../enums/column-text-status.js';
+import '../enums/column-url-status.js';
+import '../enums/column-varchar-status.js';
+import '../enums/database-type.js';
+import '../enums/deployment-status.js';
+import '../enums/execution-status.js';
+import '../enums/execution-trigger.js';
+import '../enums/health-antivirus-status.js';
+import '../enums/health-status-status.js';
+import '../enums/index-status.js';
+import '../enums/message-2-status.js';
+
+declare class CustomersRoles {
+    client: Client;
+    constructor(client: Client);
+    /**
+     * The whole catalogue in one read: every role a contact of this tenant can hold, the permissions each one grants, and the built-in permission vocabulary those grants are drawn from. Roles are held by a CONTACT and apply inside that contact's organization; there is no global customer role. Permissions are derived from the role at read time and never stored per contact, so a role change takes effect immediately and cannot leave a stale grant. The role to permission MAPPING is per tenant and configurable (PUT /customers/roles/{key}/permissions); a tenant that has not configured anything gets the built-ins and 'source' says which of the two answered. Built-in roles, least to most privileged: viewer (Viewer), requester (Requester), buyer (Buyer), approver (Approver), admin (Administrator). The permission KEYS themselves come from the cross-app ledger — every installed app declares what it enforces — so a tenant may grant a key this list does not mention.
+     *
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.RoleCatalogResponse>}
+     */
+    customersRolesList(): Promise<Models.RoleCatalogResponse>;
+    /**
+     * Idempotent: a role that already exists is left completely alone, its permissions included, so re-seeding never undoes a merchant's edits. Creates viewer, requester, buyer, approver, admin with the built-in mapping. A tenant that never calls this still behaves correctly — the catalogue and every permission read fall back to the same built-ins.
+     *
+     * @param {object} params.data - Request body
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Error>}
+     */
+    customersRolesDefaults(params: {
+        data: object;
+    }): Promise<Models.Error>;
+    /**
+     * Idempotent: a role that already exists is left completely alone, its permissions included, so re-seeding never undoes a merchant's edits. Creates viewer, requester, buyer, approver, admin with the built-in mapping. A tenant that never calls this still behaves correctly — the catalogue and every permission read fall back to the same built-ins.
+     *
+     * @param {object} data - Request body
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Error>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    customersRolesDefaults(data: object): Promise<Models.Error>;
+    /**
+     * The whole new set in one call — the shape a role editor actually produces, and the one that cannot leave a half-applied grant behind if a second call fails. Seeds the built-in roles first when the tenant has none, so editing works without calling /defaults. Permission keys are free text on purpose: they belong to whichever app declared them, and a grant for an app that is not installed simply has nothing to act on.
+     *
+     * @param {string} params.key - The role key — one of the tenant's own roles (GET /customers/roles).
+     * @param {string[]} params.permissions - The complete new set. Duplicates and blanks are ignored; an empty array revokes everything.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Error>}
+     */
+    customersRolesPermissionsReplace(params: {
+        key: string;
+        permissions: string[];
+    }): Promise<Models.Error>;
+    /**
+     * The whole new set in one call — the shape a role editor actually produces, and the one that cannot leave a half-applied grant behind if a second call fails. Seeds the built-in roles first when the tenant has none, so editing works without calling /defaults. Permission keys are free text on purpose: they belong to whichever app declared them, and a grant for an app that is not installed simply has nothing to act on.
+     *
+     * @param {string} key - The role key — one of the tenant's own roles (GET /customers/roles).
+     * @param {string[]} permissions - The complete new set. Duplicates and blanks are ignored; an empty array revokes everything.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Error>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    customersRolesPermissionsReplace(key: string, permissions: string[]): Promise<Models.Error>;
+}
+
+export { CustomersRoles };

package/dist/services/customers-roles.js

@@ -0,0 +1,94 @@
+'use strict';
+
+var client = require('../client');
+
+class CustomersRoles {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * The whole catalogue in one read: every role a contact of this tenant can hold, the permissions each one grants, and the built-in permission vocabulary those grants are drawn from. Roles are held by a CONTACT and apply inside that contact's organization; there is no global customer role. Permissions are derived from the role at read time and never stored per contact, so a role change takes effect immediately and cannot leave a stale grant. The role to permission MAPPING is per tenant and configurable (PUT /customers/roles/{key}/permissions); a tenant that has not configured anything gets the built-ins and 'source' says which of the two answered. Built-in roles, least to most privileged: viewer (Viewer), requester (Requester), buyer (Buyer), approver (Approver), admin (Administrator). The permission KEYS themselves come from the cross-app ledger — every installed app declares what it enforces — so a tenant may grant a key this list does not mention.
+   *
+   * @throws {RevenexxException}
+   * @returns {Promise<Models.RoleCatalogResponse>}
+   */
+  customersRolesList() {
+    const apiPath = "/v1/customers/roles";
+    const apiPayload = {};
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {};
+    return this.client.call(
+      "get",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  customersRolesDefaults(paramsOrFirst) {
+    let params;
+    if (paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst) && "data" in paramsOrFirst) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        data: paramsOrFirst
+      };
+    }
+    const data = params.data;
+    if (typeof data === "undefined") {
+      throw new client.RevenexxException('Missing required parameter: "data"');
+    }
+    const apiPath = "/v1/customers/roles/defaults";
+    const apiPayload = {};
+    if (typeof data !== "undefined") {
+      Object.assign(apiPayload, data);
+    }
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {
+      "content-type": "application/json"
+    };
+    return this.client.call(
+      "post",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  customersRolesPermissionsReplace(paramsOrFirst, ...rest) {
+    let params;
+    if (paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst)) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        key: paramsOrFirst,
+        permissions: rest[0]
+      };
+    }
+    const key = params.key;
+    const permissions = params.permissions;
+    if (typeof key === "undefined") {
+      throw new client.RevenexxException('Missing required parameter: "key"');
+    }
+    if (typeof permissions === "undefined") {
+      throw new client.RevenexxException('Missing required parameter: "permissions"');
+    }
+    const apiPath = "/v1/customers/roles/{key}/permissions".replace("{key}", key);
+    const apiPayload = {};
+    if (typeof permissions !== "undefined") {
+      apiPayload["permissions"] = permissions;
+    }
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {
+      "content-type": "application/json"
+    };
+    return this.client.call(
+      "put",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+}
+
+exports.CustomersRoles = CustomersRoles;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=customers-roles.js.map

package/dist/services/customers-roles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/customers-roles.ts"],"names":[],"mappings":"AAAA,SAAS,yBAA+D;AAIjE,MAAM,eAAe;AAAA,EAGxB,YAAY,QAAgB;AACxB,SAAK,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,qBAA0D;AAEtD,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,KAAM,UAAU,eAAiB;AACpH,eAAU,iBAAiB,CAAC;AAAA,IAChC,OAAO;AACH,eAAS;AAAA,QACL,MAAM;AAAA,MACV;AAAA,IACJ;AAEA,UAAM,OAAO,OAAO;AAEpB,QAAI,OAAO,SAAS,aAAa;AAC7B,YAAM,IAAI,kBAAkB,oCAAoC;AAAA,IACpE;AAEA,UAAM,UAAU;AAChB,UAAM,aAAsB,CAAC;AAC7B,QAAI,OAAO,SAAS,aAAa;AAC7B,aAAO,OAAO,YAAY,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;AAAA,EAqBA,iCACI,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,KAAK;AAAA,QACL,aAAa,KAAK,CAAC;AAAA,MACvB;AAAA,IACJ;AAEA,UAAM,MAAM,OAAO;AACnB,UAAM,cAAc,OAAO;AAE3B,QAAI,OAAO,QAAQ,aAAa;AAC5B,YAAM,IAAI,kBAAkB,mCAAmC;AAAA,IACnE;AACA,QAAI,OAAO,gBAAgB,aAAa;AACpC,YAAM,IAAI,kBAAkB,2CAA2C;AAAA,IAC3E;AAEA,UAAM,UAAU,wCAAwC,QAAQ,SAAS,GAAG;AAC5E,UAAM,aAAsB,CAAC;AAC7B,QAAI,OAAO,gBAAgB,aAAa;AACpC,iBAAW,aAAa,IAAI;AAAA,IAChC;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\n\nexport class CustomersRoles {\n    client: Client;\n\n    constructor(client: Client) {\n        this.client = client;\n    }\n\n    /**\n     * The whole catalogue in one read: every role a contact of this tenant can hold, the permissions each one grants, and the built-in permission vocabulary those grants are drawn from. Roles are held by a CONTACT and apply inside that contact's organization; there is no global customer role. Permissions are derived from the role at read time and never stored per contact, so a role change takes effect immediately and cannot leave a stale grant. The role to permission MAPPING is per tenant and configurable (PUT /customers/roles/{key}/permissions); a tenant that has not configured anything gets the built-ins and 'source' says which of the two answered. Built-in roles, least to most privileged: viewer (Viewer), requester (Requester), buyer (Buyer), approver (Approver), admin (Administrator). The permission KEYS themselves come from the cross-app ledger — every installed app declares what it enforces — so a tenant may grant a key this list does not mention.\n     *\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.RoleCatalogResponse>}\n     */\n    customersRolesList(): Promise<Models.RoleCatalogResponse> {\n\n        const apiPath = '/v1/customers/roles';\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     * Idempotent: a role that already exists is left completely alone, its permissions included, so re-seeding never undoes a merchant's edits. Creates viewer, requester, buyer, approver, admin with the built-in mapping. A tenant that never calls this still behaves correctly — the catalogue and every permission read fall back to the same built-ins.\n     *\n     * @param {object} params.data - Request body\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    customersRolesDefaults(params: { data: object }): Promise<Models.Error>;\n    /**\n     * Idempotent: a role that already exists is left completely alone, its permissions included, so re-seeding never undoes a merchant's edits. Creates viewer, requester, buyer, approver, admin with the built-in mapping. A tenant that never calls this still behaves correctly — the catalogue and every permission read fall back to the same built-ins.\n     *\n     * @param {object} data - Request body\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    customersRolesDefaults(data: object): Promise<Models.Error>;\n    customersRolesDefaults(\n        paramsOrFirst: { data: object } | object    \n    ): Promise<Models.Error> {\n        let params: { data: object };\n        \n        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('data' in paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { data: object };\n        } else {\n            params = {\n                data: paramsOrFirst as object            \n            };\n        }\n        \n        const data = params.data;\n\n        if (typeof data === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"data\"');\n        }\n\n        const apiPath = '/v1/customers/roles/defaults';\n        const apiPayload: Payload = {};\n        if (typeof data !== 'undefined') {\n            Object.assign(apiPayload, data);\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 whole new set in one call — the shape a role editor actually produces, and the one that cannot leave a half-applied grant behind if a second call fails. Seeds the built-in roles first when the tenant has none, so editing works without calling /defaults. Permission keys are free text on purpose: they belong to whichever app declared them, and a grant for an app that is not installed simply has nothing to act on.\n     *\n     * @param {string} params.key - The role key — one of the tenant's own roles (GET /customers/roles).\n     * @param {string[]} params.permissions - The complete new set. Duplicates and blanks are ignored; an empty array revokes everything.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    customersRolesPermissionsReplace(params: { key: string, permissions: string[] }): Promise<Models.Error>;\n    /**\n     * The whole new set in one call — the shape a role editor actually produces, and the one that cannot leave a half-applied grant behind if a second call fails. Seeds the built-in roles first when the tenant has none, so editing works without calling /defaults. Permission keys are free text on purpose: they belong to whichever app declared them, and a grant for an app that is not installed simply has nothing to act on.\n     *\n     * @param {string} key - The role key — one of the tenant's own roles (GET /customers/roles).\n     * @param {string[]} permissions - The complete new set. Duplicates and blanks are ignored; an empty array revokes everything.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    customersRolesPermissionsReplace(key: string, permissions: string[]): Promise<Models.Error>;\n    customersRolesPermissionsReplace(\n        paramsOrFirst: { key: string, permissions: string[] } | string,\n        ...rest: [(string[])?]    \n    ): Promise<Models.Error> {\n        let params: { key: string, permissions: string[] };\n        \n        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { key: string, permissions: string[] };\n        } else {\n            params = {\n                key: paramsOrFirst as string,\n                permissions: rest[0] as string[]            \n            };\n        }\n        \n        const key = params.key;\n        const permissions = params.permissions;\n\n        if (typeof key === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"key\"');\n        }\n        if (typeof permissions === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"permissions\"');\n        }\n\n        const apiPath = '/v1/customers/roles/{key}/permissions'.replace('{key}', key);\n        const apiPayload: Payload = {};\n        if (typeof permissions !== 'undefined') {\n            apiPayload['permissions'] = permissions;\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"]}

package/dist/services/customers-roles.mjs

@@ -0,0 +1,93 @@
+import { RevenexxException } from '../client.mjs';
+
+// src/services/customers-roles.ts
+var CustomersRoles = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * The whole catalogue in one read: every role a contact of this tenant can hold, the permissions each one grants, and the built-in permission vocabulary those grants are drawn from. Roles are held by a CONTACT and apply inside that contact's organization; there is no global customer role. Permissions are derived from the role at read time and never stored per contact, so a role change takes effect immediately and cannot leave a stale grant. The role to permission MAPPING is per tenant and configurable (PUT /customers/roles/{key}/permissions); a tenant that has not configured anything gets the built-ins and 'source' says which of the two answered. Built-in roles, least to most privileged: viewer (Viewer), requester (Requester), buyer (Buyer), approver (Approver), admin (Administrator). The permission KEYS themselves come from the cross-app ledger — every installed app declares what it enforces — so a tenant may grant a key this list does not mention.
+   *
+   * @throws {RevenexxException}
+   * @returns {Promise<Models.RoleCatalogResponse>}
+   */
+  customersRolesList() {
+    const apiPath = "/v1/customers/roles";
+    const apiPayload = {};
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {};
+    return this.client.call(
+      "get",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  customersRolesDefaults(paramsOrFirst) {
+    let params;
+    if (paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst) && "data" in paramsOrFirst) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        data: paramsOrFirst
+      };
+    }
+    const data = params.data;
+    if (typeof data === "undefined") {
+      throw new RevenexxException('Missing required parameter: "data"');
+    }
+    const apiPath = "/v1/customers/roles/defaults";
+    const apiPayload = {};
+    if (typeof data !== "undefined") {
+      Object.assign(apiPayload, data);
+    }
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {
+      "content-type": "application/json"
+    };
+    return this.client.call(
+      "post",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+  customersRolesPermissionsReplace(paramsOrFirst, ...rest) {
+    let params;
+    if (paramsOrFirst && typeof paramsOrFirst === "object" && !Array.isArray(paramsOrFirst)) {
+      params = paramsOrFirst || {};
+    } else {
+      params = {
+        key: paramsOrFirst,
+        permissions: rest[0]
+      };
+    }
+    const key = params.key;
+    const permissions = params.permissions;
+    if (typeof key === "undefined") {
+      throw new RevenexxException('Missing required parameter: "key"');
+    }
+    if (typeof permissions === "undefined") {
+      throw new RevenexxException('Missing required parameter: "permissions"');
+    }
+    const apiPath = "/v1/customers/roles/{key}/permissions".replace("{key}", key);
+    const apiPayload = {};
+    if (typeof permissions !== "undefined") {
+      apiPayload["permissions"] = permissions;
+    }
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {
+      "content-type": "application/json"
+    };
+    return this.client.call(
+      "put",
+      uri,
+      apiHeaders,
+      apiPayload
+    );
+  }
+};
+
+export { CustomersRoles };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=customers-roles.mjs.map

package/dist/services/customers-roles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/customers-roles.ts"],"names":[],"mappings":";AAAA,SAAS,yBAA+D;AAIjE,IAAM,iBAAN,MAAqB;AAAA,EAGxB,YAAY,QAAgB;AACxB,SAAK,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,qBAA0D;AAEtD,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,KAAM,UAAU,eAAiB;AACpH,eAAU,iBAAiB,CAAC;AAAA,IAChC,OAAO;AACH,eAAS;AAAA,QACL,MAAM;AAAA,MACV;AAAA,IACJ;AAEA,UAAM,OAAO,OAAO;AAEpB,QAAI,OAAO,SAAS,aAAa;AAC7B,YAAM,IAAI,kBAAkB,oCAAoC;AAAA,IACpE;AAEA,UAAM,UAAU;AAChB,UAAM,aAAsB,CAAC;AAC7B,QAAI,OAAO,SAAS,aAAa;AAC7B,aAAO,OAAO,YAAY,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;AAAA,EAqBA,iCACI,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,KAAK;AAAA,QACL,aAAa,KAAK,CAAC;AAAA,MACvB;AAAA,IACJ;AAEA,UAAM,MAAM,OAAO;AACnB,UAAM,cAAc,OAAO;AAE3B,QAAI,OAAO,QAAQ,aAAa;AAC5B,YAAM,IAAI,kBAAkB,mCAAmC;AAAA,IACnE;AACA,QAAI,OAAO,gBAAgB,aAAa;AACpC,YAAM,IAAI,kBAAkB,2CAA2C;AAAA,IAC3E;AAEA,UAAM,UAAU,wCAAwC,QAAQ,SAAS,GAAG;AAC5E,UAAM,aAAsB,CAAC;AAC7B,QAAI,OAAO,gBAAgB,aAAa;AACpC,iBAAW,aAAa,IAAI;AAAA,IAChC;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\n\nexport class CustomersRoles {\n    client: Client;\n\n    constructor(client: Client) {\n        this.client = client;\n    }\n\n    /**\n     * The whole catalogue in one read: every role a contact of this tenant can hold, the permissions each one grants, and the built-in permission vocabulary those grants are drawn from. Roles are held by a CONTACT and apply inside that contact's organization; there is no global customer role. Permissions are derived from the role at read time and never stored per contact, so a role change takes effect immediately and cannot leave a stale grant. The role to permission MAPPING is per tenant and configurable (PUT /customers/roles/{key}/permissions); a tenant that has not configured anything gets the built-ins and 'source' says which of the two answered. Built-in roles, least to most privileged: viewer (Viewer), requester (Requester), buyer (Buyer), approver (Approver), admin (Administrator). The permission KEYS themselves come from the cross-app ledger — every installed app declares what it enforces — so a tenant may grant a key this list does not mention.\n     *\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.RoleCatalogResponse>}\n     */\n    customersRolesList(): Promise<Models.RoleCatalogResponse> {\n\n        const apiPath = '/v1/customers/roles';\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     * Idempotent: a role that already exists is left completely alone, its permissions included, so re-seeding never undoes a merchant's edits. Creates viewer, requester, buyer, approver, admin with the built-in mapping. A tenant that never calls this still behaves correctly — the catalogue and every permission read fall back to the same built-ins.\n     *\n     * @param {object} params.data - Request body\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    customersRolesDefaults(params: { data: object }): Promise<Models.Error>;\n    /**\n     * Idempotent: a role that already exists is left completely alone, its permissions included, so re-seeding never undoes a merchant's edits. Creates viewer, requester, buyer, approver, admin with the built-in mapping. A tenant that never calls this still behaves correctly — the catalogue and every permission read fall back to the same built-ins.\n     *\n     * @param {object} data - Request body\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    customersRolesDefaults(data: object): Promise<Models.Error>;\n    customersRolesDefaults(\n        paramsOrFirst: { data: object } | object    \n    ): Promise<Models.Error> {\n        let params: { data: object };\n        \n        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('data' in paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { data: object };\n        } else {\n            params = {\n                data: paramsOrFirst as object            \n            };\n        }\n        \n        const data = params.data;\n\n        if (typeof data === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"data\"');\n        }\n\n        const apiPath = '/v1/customers/roles/defaults';\n        const apiPayload: Payload = {};\n        if (typeof data !== 'undefined') {\n            Object.assign(apiPayload, data);\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 whole new set in one call — the shape a role editor actually produces, and the one that cannot leave a half-applied grant behind if a second call fails. Seeds the built-in roles first when the tenant has none, so editing works without calling /defaults. Permission keys are free text on purpose: they belong to whichever app declared them, and a grant for an app that is not installed simply has nothing to act on.\n     *\n     * @param {string} params.key - The role key — one of the tenant's own roles (GET /customers/roles).\n     * @param {string[]} params.permissions - The complete new set. Duplicates and blanks are ignored; an empty array revokes everything.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     */\n    customersRolesPermissionsReplace(params: { key: string, permissions: string[] }): Promise<Models.Error>;\n    /**\n     * The whole new set in one call — the shape a role editor actually produces, and the one that cannot leave a half-applied grant behind if a second call fails. Seeds the built-in roles first when the tenant has none, so editing works without calling /defaults. Permission keys are free text on purpose: they belong to whichever app declared them, and a grant for an app that is not installed simply has nothing to act on.\n     *\n     * @param {string} key - The role key — one of the tenant's own roles (GET /customers/roles).\n     * @param {string[]} permissions - The complete new set. Duplicates and blanks are ignored; an empty array revokes everything.\n     * @throws {RevenexxException}\n     * @returns {Promise<Models.Error>}\n     * @deprecated Use the object parameter style method for a better developer experience.\n     */\n    customersRolesPermissionsReplace(key: string, permissions: string[]): Promise<Models.Error>;\n    customersRolesPermissionsReplace(\n        paramsOrFirst: { key: string, permissions: string[] } | string,\n        ...rest: [(string[])?]    \n    ): Promise<Models.Error> {\n        let params: { key: string, permissions: string[] };\n        \n        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {\n            params = (paramsOrFirst || {}) as { key: string, permissions: string[] };\n        } else {\n            params = {\n                key: paramsOrFirst as string,\n                permissions: rest[0] as string[]            \n            };\n        }\n        \n        const key = params.key;\n        const permissions = params.permissions;\n\n        if (typeof key === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"key\"');\n        }\n        if (typeof permissions === 'undefined') {\n            throw new RevenexxException('Missing required parameter: \"permissions\"');\n        }\n\n        const apiPath = '/v1/customers/roles/{key}/permissions'.replace('{key}', key);\n        const apiPayload: Payload = {};\n        if (typeof permissions !== 'undefined') {\n            apiPayload['permissions'] = permissions;\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"]}