@revenexx/sdk 0.0.7 → 0.0.10

package/src/services/inventories.ts

@@ -60,7 +60,7 @@ export class Inventories {
         const apiPath = '/v1/inventories/adjust';
         const apiPayload: Payload = {};
         if (typeof items !== 'undefined') {
-            apiPayload['items'] = items;
+            apiPayload['items'] = Client.toWireKeys(items, {"productId":{"wire":"product_id","children":null}});
         }
         if (typeof locationCode !== 'undefined') {
             apiPayload['location_code'] = locationCode;
@@ -124,7 +124,7 @@ export class Inventories {
         const apiPath = '/v1/inventories/availability';
         const apiPayload: Payload = {};
         if (typeof items !== 'undefined') {
-            apiPayload['items'] = items;
+            apiPayload['items'] = Client.toWireKeys(items, {"productId":{"wire":"product_id","children":null}});
         }
         if (typeof locationCode !== 'undefined') {
             apiPayload['location_code'] = locationCode;
@@ -668,7 +668,7 @@ export class Inventories {
         const apiPath = '/v1/inventories/receive';
         const apiPayload: Payload = {};
         if (typeof items !== 'undefined') {
-            apiPayload['items'] = items;
+            apiPayload['items'] = Client.toWireKeys(items, {"productId":{"wire":"product_id","children":null}});
         }
         if (typeof locationCode !== 'undefined') {
             apiPayload['location_code'] = locationCode;
@@ -866,7 +866,7 @@ export class Inventories {
             apiPayload['expires_at'] = expiresAt;
         }
         if (typeof items !== 'undefined') {
-            apiPayload['items'] = items;
+            apiPayload['items'] = Client.toWireKeys(items, {"productId":{"wire":"product_id","children":null}});
         }
         if (typeof orderRef !== 'undefined') {
             apiPayload['order_ref'] = orderRef;
@@ -935,7 +935,7 @@ export class Inventories {
         const apiPath = '/v1/inventories/restock';
         const apiPayload: Payload = {};
         if (typeof items !== 'undefined') {
-            apiPayload['items'] = items;
+            apiPayload['items'] = Client.toWireKeys(items, {"productId":{"wire":"product_id","children":null}});
         }
         if (typeof locationCode !== 'undefined') {
             apiPayload['location_code'] = locationCode;

package/src/services/orderlists.ts

@@ -105,7 +105,7 @@ export class Orderlists {
         const apiPath = '/v1/orderlists';
         const apiPayload: Payload = {};
         if (typeof items !== 'undefined') {
-            apiPayload['items'] = items;
+            apiPayload['items'] = Client.toWireKeys(items, {"categorySlug":{"wire":"category_slug","children":null},"costCenterId":{"wire":"cost_center_id","children":null},"customSku":{"wire":"custom_sku","children":null},"positionTexts":{"wire":"position_texts","children":null},"productId":{"wire":"product_id","children":null},"subcategorySlug":{"wire":"subcategory_slug","children":null},"taxRate":{"wire":"tax_rate","children":null}});
         }
         if (typeof kind !== 'undefined') {
             apiPayload['kind'] = kind;
@@ -594,7 +594,7 @@ export class Orderlists {
         const apiPath = '/v1/orderlists/{list_id}/items'.replace('{list_id}', listId);
         const apiPayload: Payload = {};
         if (typeof items !== 'undefined') {
-            apiPayload['items'] = items;
+            apiPayload['items'] = Client.toWireKeys(items, {"categorySlug":{"wire":"category_slug","children":null},"costCenterId":{"wire":"cost_center_id","children":null},"customSku":{"wire":"custom_sku","children":null},"positionTexts":{"wire":"position_texts","children":null},"productId":{"wire":"product_id","children":null},"subcategorySlug":{"wire":"subcategory_slug","children":null},"taxRate":{"wire":"tax_rate","children":null}});
         }
         const uri = new URL(this.client.config.endpoint + apiPath);
 

package/src/services/orders.ts

@@ -2,8 +2,10 @@ import { Service } from '../service';
 import { RevenexxException, Client, type Payload, UploadProgress } from '../client';
 import type { Models } from '../models';
 
-import { OrderCommentVisibility } from '../enums/order-comment-visibility';
+import { OrderStatus } from '../enums/order-status';
 import { OrderPaymentStatus } from '../enums/order-payment-status';
+import { OrderFulfillmentStatus } from '../enums/order-fulfillment-status';
+import { OrderCommentVisibility } from '../enums/order-comment-visibility';
 
 export class Orders {
     client: Client;
@@ -14,13 +16,111 @@ export class Orders {
 
     /**
      *
+     * @param {OrderStatus} params.status - Filter by order status (exact match).
+     * @param {OrderPaymentStatus} params.paymentStatus - Filter by payment status (exact match).
+     * @param {OrderFulfillmentStatus} params.fulfillmentStatus - Filter by fulfillment status (exact match).
+     * @param {string} params.contactId - Filter to one ordering contact.
+     * @param {string} params.organizationId - Filter to one B2B organization.
+     * @param {string} params.channelId - Filter to one sales channel.
+     * @param {string} params.marketId - Filter to one market.
+     * @param {string} params.number - Filter by exact order number.
+     * @param {number} params.limit - Page size (default 50, max 200).
+     * @param {number} params.offset - Row offset for pagination (default 0).
+     * @param {string} params.order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
+     * @throws {RevenexxException}
+     * @returns {Promise<{}>}
+     */
+    ordersList(params?: { status?: OrderStatus, paymentStatus?: OrderPaymentStatus, fulfillmentStatus?: OrderFulfillmentStatus, contactId?: string, organizationId?: string, channelId?: string, marketId?: string, number?: string, limit?: number, offset?: number, order?: string }): Promise<{}>;
+    /**
+     *
+     * @param {OrderStatus} status - Filter by order status (exact match).
+     * @param {OrderPaymentStatus} paymentStatus - Filter by payment status (exact match).
+     * @param {OrderFulfillmentStatus} fulfillmentStatus - Filter by fulfillment status (exact match).
+     * @param {string} contactId - Filter to one ordering contact.
+     * @param {string} organizationId - Filter to one B2B organization.
+     * @param {string} channelId - Filter to one sales channel.
+     * @param {string} marketId - Filter to one market.
+     * @param {string} number - Filter by exact order number.
+     * @param {number} limit - Page size (default 50, max 200).
+     * @param {number} offset - Row offset for pagination (default 0).
+     * @param {string} order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
      * @throws {RevenexxException}
      * @returns {Promise<{}>}
+     * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersList(): Promise<{}> {
+    ordersList(status?: OrderStatus, paymentStatus?: OrderPaymentStatus, fulfillmentStatus?: OrderFulfillmentStatus, contactId?: string, organizationId?: string, channelId?: string, marketId?: string, number?: string, limit?: number, offset?: number, order?: string): Promise<{}>;
+    ordersList(
+        paramsOrFirst?: { status?: OrderStatus, paymentStatus?: OrderPaymentStatus, fulfillmentStatus?: OrderFulfillmentStatus, contactId?: string, organizationId?: string, channelId?: string, marketId?: string, number?: string, limit?: number, offset?: number, order?: string } | OrderStatus,
+        ...rest: [(OrderPaymentStatus)?, (OrderFulfillmentStatus)?, (string)?, (string)?, (string)?, (string)?, (string)?, (number)?, (number)?, (string)?]    
+    ): Promise<{}> {
+        let params: { status?: OrderStatus, paymentStatus?: OrderPaymentStatus, fulfillmentStatus?: OrderFulfillmentStatus, contactId?: string, organizationId?: string, channelId?: string, marketId?: string, number?: string, limit?: number, offset?: number, order?: string };
+        
+        if (!paramsOrFirst || (paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('status' in paramsOrFirst || 'paymentStatus' in paramsOrFirst || 'fulfillmentStatus' in paramsOrFirst || 'contactId' in paramsOrFirst || 'organizationId' in paramsOrFirst || 'channelId' in paramsOrFirst || 'marketId' in paramsOrFirst || 'number' in paramsOrFirst || 'limit' in paramsOrFirst || 'offset' in paramsOrFirst || 'order' in paramsOrFirst))) {
+            params = (paramsOrFirst || {}) as { status?: OrderStatus, paymentStatus?: OrderPaymentStatus, fulfillmentStatus?: OrderFulfillmentStatus, contactId?: string, organizationId?: string, channelId?: string, marketId?: string, number?: string, limit?: number, offset?: number, order?: string };
+        } else {
+            params = {
+                status: paramsOrFirst as OrderStatus,
+                paymentStatus: rest[0] as OrderPaymentStatus,
+                fulfillmentStatus: rest[1] as OrderFulfillmentStatus,
+                contactId: rest[2] as string,
+                organizationId: rest[3] as string,
+                channelId: rest[4] as string,
+                marketId: rest[5] as string,
+                number: rest[6] as string,
+                limit: rest[7] as number,
+                offset: rest[8] as number,
+                order: rest[9] as string            
+            };
+        }
+        
+        const status = params.status;
+        const paymentStatus = params.paymentStatus;
+        const fulfillmentStatus = params.fulfillmentStatus;
+        const contactId = params.contactId;
+        const organizationId = params.organizationId;
+        const channelId = params.channelId;
+        const marketId = params.marketId;
+        const number = params.number;
+        const limit = params.limit;
+        const offset = params.offset;
+        const order = params.order;
+
 
         const apiPath = '/v1/orders';
         const apiPayload: Payload = {};
+        if (typeof status !== 'undefined') {
+            apiPayload['status'] = status;
+        }
+        if (typeof paymentStatus !== 'undefined') {
+            apiPayload['payment_status'] = paymentStatus;
+        }
+        if (typeof fulfillmentStatus !== 'undefined') {
+            apiPayload['fulfillment_status'] = fulfillmentStatus;
+        }
+        if (typeof contactId !== 'undefined') {
+            apiPayload['contact_id'] = contactId;
+        }
+        if (typeof organizationId !== 'undefined') {
+            apiPayload['organization_id'] = organizationId;
+        }
+        if (typeof channelId !== 'undefined') {
+            apiPayload['channel_id'] = channelId;
+        }
+        if (typeof marketId !== 'undefined') {
+            apiPayload['market_id'] = marketId;
+        }
+        if (typeof number !== 'undefined') {
+            apiPayload['number'] = number;
+        }
+        if (typeof limit !== 'undefined') {
+            apiPayload['limit'] = limit;
+        }
+        if (typeof offset !== 'undefined') {
+            apiPayload['offset'] = offset;
+        }
+        if (typeof order !== 'undefined') {
+            apiPayload['order'] = order;
+        }
         const uri = new URL(this.client.config.endpoint + apiPath);
 
         const apiHeaders: { [header: string]: string } = {
@@ -526,7 +626,7 @@ export class Orders {
             apiPayload['grand_total'] = grandTotal;
         }
         if (typeof items !== 'undefined') {
-            apiPayload['items'] = items;
+            apiPayload['items'] = Client.toWireKeys(items, {"costCenter":{"wire":"cost_center","children":null},"positionText":{"wire":"position_text","children":null},"productId":{"wire":"product_id","children":null},"taxAmount":{"wire":"tax_amount","children":null},"taxRate":{"wire":"tax_rate","children":null},"unitPrice":{"wire":"unit_price","children":null},"userData":{"wire":"user_data","children":null}});
         }
         if (typeof marketId !== 'undefined') {
             apiPayload['market_id'] = marketId;
@@ -1118,7 +1218,7 @@ export class Orders {
             apiPayload['cancelled_by'] = cancelledBy;
         }
         if (typeof positions !== 'undefined') {
-            apiPayload['positions'] = positions;
+            apiPayload['positions'] = Client.toWireKeys(positions, {"orderItemId":{"wire":"order_item_id","children":null}});
         }
         if (typeof reason !== 'undefined') {
             apiPayload['reason'] = reason;
@@ -1261,7 +1361,7 @@ export class Orders {
             apiPayload['metadata'] = metadata;
         }
         if (typeof positions !== 'undefined') {
-            apiPayload['positions'] = positions;
+            apiPayload['positions'] = Client.toWireKeys(positions, {"orderItemId":{"wire":"order_item_id","children":null}});
         }
         if (typeof reason !== 'undefined') {
             apiPayload['reason'] = reason;
@@ -1560,7 +1660,7 @@ export class Orders {
             apiPayload['number'] = number;
         }
         if (typeof positions !== 'undefined') {
-            apiPayload['positions'] = positions;
+            apiPayload['positions'] = Client.toWireKeys(positions, {"orderItemId":{"wire":"order_item_id","children":null}});
         }
         if (typeof shippedAt !== 'undefined') {
             apiPayload['shipped_at'] = shippedAt;

package/src/services/prices.ts

@@ -687,7 +687,7 @@ export class Prices {
         const apiPath = '/v1/prices/lists/{list_id}/entries'.replace('{list_id}', listId);
         const apiPayload: Payload = {};
         if (typeof entries !== 'undefined') {
-            apiPayload['entries'] = entries;
+            apiPayload['entries'] = Client.toWireKeys(entries, {"priceType":{"wire":"price_type","children":null},"productId":{"wire":"product_id","children":null},"quantityMin":{"wire":"quantity_min","children":null},"unitPrice":{"wire":"unit_price","children":null},"validFrom":{"wire":"valid_from","children":null},"validUntil":{"wire":"valid_until","children":null}});
         }
         const uri = new URL(this.client.config.endpoint + apiPath);
 
@@ -748,7 +748,7 @@ export class Prices {
         const apiPath = '/v1/prices/lists/{list_id}/entries/bulk'.replace('{list_id}', listId);
         const apiPayload: Payload = {};
         if (typeof entries !== 'undefined') {
-            apiPayload['entries'] = entries;
+            apiPayload['entries'] = Client.toWireKeys(entries, {"priceType":{"wire":"price_type","children":null},"productId":{"wire":"product_id","children":null},"quantityMin":{"wire":"quantity_min","children":null},"unitPrice":{"wire":"unit_price","children":null},"validFrom":{"wire":"valid_from","children":null},"validUntil":{"wire":"valid_until","children":null}});
         }
         const uri = new URL(this.client.config.endpoint + apiPath);
 
@@ -1073,7 +1073,7 @@ export class Prices {
             apiPayload['currency'] = currency;
         }
         if (typeof items !== 'undefined') {
-            apiPayload['items'] = items;
+            apiPayload['items'] = Client.toWireKeys(items, {"productId":{"wire":"product_id","children":null}});
         }
         if (typeof marketId !== 'undefined') {
             apiPayload['market_id'] = marketId;

package/src/services/search.ts

@@ -328,7 +328,7 @@ export class Search {
         const apiPath = '/v1/search/multi_search';
         const apiPayload: Payload = {};
         if (typeof searches !== 'undefined') {
-            apiPayload['searches'] = searches;
+            apiPayload['searches'] = Client.toWireKeys(searches, {"facetBy":{"wire":"facet_by","children":null},"filterBy":{"wire":"filter_by","children":null},"perPage":{"wire":"per_page","children":null},"queryBy":{"wire":"query_by","children":null},"sortBy":{"wire":"sort_by","children":null}});
         }
         const uri = new URL(this.client.config.endpoint + apiPath);
 

package/src/services/shipping.ts

@@ -659,7 +659,7 @@ export class Shipping {
         const apiPath = '/v1/shipping/methods/{method_id}/tiers'.replace('{method_id}', methodId);
         const apiPayload: Payload = {};
         if (typeof tiers !== 'undefined') {
-            apiPayload['tiers'] = tiers;
+            apiPayload['tiers'] = Client.toWireKeys(tiers, {"fromValue":{"wire":"from_value","children":null}});
         }
         const uri = new URL(this.client.config.endpoint + apiPath);
 

package/types/client.d.ts

@@ -202,6 +202,17 @@ declare class Client {
     chunkedUpload(method: string, url: URL, headers: Headers | undefined, originalPayload: Payload | undefined, onProgress: (progress: UploadProgress) => void): Promise<any>;
     ping(): Promise<string>;
     call(method: string, url: URL, headers?: Headers, params?: Payload, responseType?: string): Promise<any>;
+    /**
+     * Recursively renames an argument's DECLARED keys to their snake_case wire
+     * names, using a map generated from the API contract. Free-form subtrees
+     * (metadata / user_data — keys absent from the map, with no `children`) are
+     * passed through untouched, so user data is never mangled. For arrays the
+     * same element map is applied to every item.
+     */
+    static toWireKeys(value: any, map: Record<string, {
+        wire: string;
+        children: any;
+    }>): any;
     static flatten(data: Payload, prefix?: string): Payload;
 }
 export { Client, RevenexxException };

package/types/enums/fulfillment-status.d.ts

@@ -0,0 +1,5 @@
+export declare enum FulfillmentStatus {
+    Unfulfilled = "unfulfilled",
+    Partial = "partial",
+    Fulfilled = "fulfilled"
+}

package/types/enums/order-fulfillment-status.d.ts

@@ -0,0 +1,5 @@
+export declare enum OrderFulfillmentStatus {
+    Unfulfilled = "unfulfilled",
+    Partial = "partial",
+    Fulfilled = "fulfilled"
+}

package/types/enums/order-status.d.ts

@@ -0,0 +1,7 @@
+export declare enum OrderStatus {
+    Pending = "pending",
+    Placed = "placed",
+    InFulfillment = "in_fulfillment",
+    Completed = "completed",
+    Cancelled = "cancelled"
+}

package/types/enums/payment-status.d.ts

@@ -0,0 +1,9 @@
+export declare enum PaymentStatus {
+    Open = "open",
+    Pending = "pending",
+    Authorized = "authorized",
+    Paid = "paid",
+    PartiallyPaid = "partially_paid",
+    Refunded = "refunded",
+    Failed = "failed"
+}

package/types/enums/status.d.ts

@@ -0,0 +1,7 @@
+export declare enum Status {
+    Pending = "pending",
+    Placed = "placed",
+    InFulfillment = "in_fulfillment",
+    Completed = "completed",
+    Cancelled = "cancelled"
+}

package/types/index.d.ts

@@ -64,8 +64,10 @@ export { LocationType } from './enums/location-type';
 export { MarketStatus } from './enums/market-status';
 export { Priority } from './enums/priority';
 export { OrderListKind } from './enums/order-list-kind';
-export { OrderCommentVisibility } from './enums/order-comment-visibility';
+export { OrderStatus } from './enums/order-status';
 export { OrderPaymentStatus } from './enums/order-payment-status';
+export { OrderFulfillmentStatus } from './enums/order-fulfillment-status';
+export { OrderCommentVisibility } from './enums/order-comment-visibility';
 export { PageStatus } from './enums/page-status';
 export { PaymentFeeType } from './enums/payment-fee-type';
 export { PaymentMethodKind } from './enums/payment-method-kind';

package/types/services/orders.d.ts

@@ -1,16 +1,59 @@
 import { Client } from '../client';
 import type { Models } from '../models';
-import { OrderCommentVisibility } from '../enums/order-comment-visibility';
+import { OrderStatus } from '../enums/order-status';
 import { OrderPaymentStatus } from '../enums/order-payment-status';
+import { OrderFulfillmentStatus } from '../enums/order-fulfillment-status';
+import { OrderCommentVisibility } from '../enums/order-comment-visibility';
 export declare class Orders {
     client: Client;
     constructor(client: Client);
     /**
      *
+     * @param {OrderStatus} params.status - Filter by order status (exact match).
+     * @param {OrderPaymentStatus} params.paymentStatus - Filter by payment status (exact match).
+     * @param {OrderFulfillmentStatus} params.fulfillmentStatus - Filter by fulfillment status (exact match).
+     * @param {string} params.contactId - Filter to one ordering contact.
+     * @param {string} params.organizationId - Filter to one B2B organization.
+     * @param {string} params.channelId - Filter to one sales channel.
+     * @param {string} params.marketId - Filter to one market.
+     * @param {string} params.number - Filter by exact order number.
+     * @param {number} params.limit - Page size (default 50, max 200).
+     * @param {number} params.offset - Row offset for pagination (default 0).
+     * @param {string} params.order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
+     * @throws {RevenexxException}
+     * @returns {Promise<{}>}
+     */
+    ordersList(params?: {
+        status?: OrderStatus;
+        paymentStatus?: OrderPaymentStatus;
+        fulfillmentStatus?: OrderFulfillmentStatus;
+        contactId?: string;
+        organizationId?: string;
+        channelId?: string;
+        marketId?: string;
+        number?: string;
+        limit?: number;
+        offset?: number;
+        order?: string;
+    }): Promise<{}>;
+    /**
+     *
+     * @param {OrderStatus} status - Filter by order status (exact match).
+     * @param {OrderPaymentStatus} paymentStatus - Filter by payment status (exact match).
+     * @param {OrderFulfillmentStatus} fulfillmentStatus - Filter by fulfillment status (exact match).
+     * @param {string} contactId - Filter to one ordering contact.
+     * @param {string} organizationId - Filter to one B2B organization.
+     * @param {string} channelId - Filter to one sales channel.
+     * @param {string} marketId - Filter to one market.
+     * @param {string} number - Filter by exact order number.
+     * @param {number} limit - Page size (default 50, max 200).
+     * @param {number} offset - Row offset for pagination (default 0).
+     * @param {string} order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
      * @throws {RevenexxException}
      * @returns {Promise<{}>}
+     * @deprecated Use the object parameter style method for a better developer experience.
      */
-    ordersList(): Promise<{}>;
+    ordersList(status?: OrderStatus, paymentStatus?: OrderPaymentStatus, fulfillmentStatus?: OrderFulfillmentStatus, contactId?: string, organizationId?: string, channelId?: string, marketId?: string, number?: string, limit?: number, offset?: number, order?: string): Promise<{}>;
     /**
      *
      * @throws {RevenexxException}