@virtocommerce/mcp-onx 0.0.1-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (131) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +360 -0
  3. package/dist/adapter.d.ts +53 -0
  4. package/dist/adapter.d.ts.map +1 -0
  5. package/dist/adapter.js +205 -0
  6. package/dist/adapter.js.map +1 -0
  7. package/dist/index.d.ts +9 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +8 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/mappers/filter.mappers.d.ts +16 -0
  12. package/dist/mappers/filter.mappers.d.ts.map +1 -0
  13. package/dist/mappers/filter.mappers.js +209 -0
  14. package/dist/mappers/filter.mappers.js.map +1 -0
  15. package/dist/mappers/index.d.ts +2 -0
  16. package/dist/mappers/index.d.ts.map +1 -0
  17. package/dist/mappers/index.js +2 -0
  18. package/dist/mappers/index.js.map +1 -0
  19. package/dist/models/base.d.ts +133 -0
  20. package/dist/models/base.d.ts.map +1 -0
  21. package/dist/models/base.js +2 -0
  22. package/dist/models/base.js.map +1 -0
  23. package/dist/models/catalog.d.ts +180 -0
  24. package/dist/models/catalog.d.ts.map +1 -0
  25. package/dist/models/catalog.js +2 -0
  26. package/dist/models/catalog.js.map +1 -0
  27. package/dist/models/customer.d.ts +148 -0
  28. package/dist/models/customer.d.ts.map +1 -0
  29. package/dist/models/customer.js +2 -0
  30. package/dist/models/customer.js.map +1 -0
  31. package/dist/models/index.d.ts +10 -0
  32. package/dist/models/index.d.ts.map +1 -0
  33. package/dist/models/index.js +2 -0
  34. package/dist/models/index.js.map +1 -0
  35. package/dist/models/inventory.d.ts +34 -0
  36. package/dist/models/inventory.d.ts.map +1 -0
  37. package/dist/models/inventory.js +2 -0
  38. package/dist/models/inventory.js.map +1 -0
  39. package/dist/models/order.d.ts +158 -0
  40. package/dist/models/order.d.ts.map +1 -0
  41. package/dist/models/order.js +2 -0
  42. package/dist/models/order.js.map +1 -0
  43. package/dist/models/payment.d.ts +145 -0
  44. package/dist/models/payment.d.ts.map +1 -0
  45. package/dist/models/payment.js +2 -0
  46. package/dist/models/payment.js.map +1 -0
  47. package/dist/models/return.d.ts +31 -0
  48. package/dist/models/return.d.ts.map +1 -0
  49. package/dist/models/return.js +2 -0
  50. package/dist/models/return.js.map +1 -0
  51. package/dist/models/search.d.ts +143 -0
  52. package/dist/models/search.d.ts.map +1 -0
  53. package/dist/models/search.js +2 -0
  54. package/dist/models/search.js.map +1 -0
  55. package/dist/models/shipment.d.ts +70 -0
  56. package/dist/models/shipment.d.ts.map +1 -0
  57. package/dist/models/shipment.js +2 -0
  58. package/dist/models/shipment.js.map +1 -0
  59. package/dist/services/base.service.d.ts +10 -0
  60. package/dist/services/base.service.d.ts.map +1 -0
  61. package/dist/services/base.service.js +25 -0
  62. package/dist/services/base.service.js.map +1 -0
  63. package/dist/services/customer.service.d.ts +16 -0
  64. package/dist/services/customer.service.d.ts.map +1 -0
  65. package/dist/services/customer.service.js +78 -0
  66. package/dist/services/customer.service.js.map +1 -0
  67. package/dist/services/fulfillment.service.d.ts +17 -0
  68. package/dist/services/fulfillment.service.d.ts.map +1 -0
  69. package/dist/services/fulfillment.service.js +94 -0
  70. package/dist/services/fulfillment.service.js.map +1 -0
  71. package/dist/services/index.d.ts +7 -0
  72. package/dist/services/index.d.ts.map +1 -0
  73. package/dist/services/index.js +7 -0
  74. package/dist/services/index.js.map +1 -0
  75. package/dist/services/order.service.d.ts +22 -0
  76. package/dist/services/order.service.d.ts.map +1 -0
  77. package/dist/services/order.service.js +153 -0
  78. package/dist/services/order.service.js.map +1 -0
  79. package/dist/services/product.service.d.ts +25 -0
  80. package/dist/services/product.service.d.ts.map +1 -0
  81. package/dist/services/product.service.js +116 -0
  82. package/dist/services/product.service.js.map +1 -0
  83. package/dist/services/return.service.d.ts +17 -0
  84. package/dist/services/return.service.d.ts.map +1 -0
  85. package/dist/services/return.service.js +148 -0
  86. package/dist/services/return.service.js.map +1 -0
  87. package/dist/transformers/address.transformer.d.ts +11 -0
  88. package/dist/transformers/address.transformer.d.ts.map +1 -0
  89. package/dist/transformers/address.transformer.js +75 -0
  90. package/dist/transformers/address.transformer.js.map +1 -0
  91. package/dist/transformers/base.d.ts +14 -0
  92. package/dist/transformers/base.d.ts.map +1 -0
  93. package/dist/transformers/base.js +44 -0
  94. package/dist/transformers/base.js.map +1 -0
  95. package/dist/transformers/customer.transformer.d.ts +16 -0
  96. package/dist/transformers/customer.transformer.d.ts.map +1 -0
  97. package/dist/transformers/customer.transformer.js +84 -0
  98. package/dist/transformers/customer.transformer.js.map +1 -0
  99. package/dist/transformers/fulfillment.transformer.d.ts +13 -0
  100. package/dist/transformers/fulfillment.transformer.d.ts.map +1 -0
  101. package/dist/transformers/fulfillment.transformer.js +93 -0
  102. package/dist/transformers/fulfillment.transformer.js.map +1 -0
  103. package/dist/transformers/index.d.ts +8 -0
  104. package/dist/transformers/index.d.ts.map +1 -0
  105. package/dist/transformers/index.js +8 -0
  106. package/dist/transformers/index.js.map +1 -0
  107. package/dist/transformers/order.transformer.d.ts +26 -0
  108. package/dist/transformers/order.transformer.d.ts.map +1 -0
  109. package/dist/transformers/order.transformer.js +201 -0
  110. package/dist/transformers/order.transformer.js.map +1 -0
  111. package/dist/transformers/product.transformer.d.ts +19 -0
  112. package/dist/transformers/product.transformer.d.ts.map +1 -0
  113. package/dist/transformers/product.transformer.js +202 -0
  114. package/dist/transformers/product.transformer.js.map +1 -0
  115. package/dist/transformers/return.transformer.d.ts +12 -0
  116. package/dist/transformers/return.transformer.d.ts.map +1 -0
  117. package/dist/transformers/return.transformer.js +83 -0
  118. package/dist/transformers/return.transformer.js.map +1 -0
  119. package/dist/types.d.ts +135 -0
  120. package/dist/types.d.ts.map +1 -0
  121. package/dist/types.js +47 -0
  122. package/dist/types.js.map +1 -0
  123. package/dist/utils/api-client.d.ts +31 -0
  124. package/dist/utils/api-client.d.ts.map +1 -0
  125. package/dist/utils/api-client.js +226 -0
  126. package/dist/utils/api-client.js.map +1 -0
  127. package/dist/utils/type-guards.d.ts +9 -0
  128. package/dist/utils/type-guards.d.ts.map +1 -0
  129. package/dist/utils/type-guards.js +21 -0
  130. package/dist/utils/type-guards.js.map +1 -0
  131. package/package.json +60 -0
@@ -0,0 +1,202 @@
1
+ import { BaseTransformer } from './base.js';
2
+ export class ProductTransformer extends BaseTransformer {
3
+ fromCatalogProduct(product) {
4
+ const description = product.reviews?.find((r) => r.reviewType === 'FullReview')?.content ??
5
+ product.reviews?.[0]?.content;
6
+ const imageURLs = product.images
7
+ ?.map((img) => img.url ?? img.relativeUrl)
8
+ .filter((url) => !!url);
9
+ const categories = product.categories
10
+ ?.map((cat) => cat.name)
11
+ .filter((name) => !!name);
12
+ return {
13
+ id: product.id ?? '',
14
+ externalId: product.outerId,
15
+ externalProductId: product.code,
16
+ name: product.name ?? '',
17
+ description,
18
+ handle: product.path ?? product.code,
19
+ status: this.mapProductStatus(product),
20
+ tags: this.extractTags(product.properties),
21
+ vendor: product.vendor,
22
+ categories,
23
+ options: this.extractOptions(product),
24
+ imageURLs,
25
+ customFields: this.extractCustomFields(product.properties),
26
+ createdAt: product.createdDate ?? this.now(),
27
+ updatedAt: product.modifiedDate ?? this.now(),
28
+ tenantId: this.tenantId,
29
+ };
30
+ }
31
+ fromCatalogProducts(products) {
32
+ return products.map((product) => this.fromCatalogProduct(product));
33
+ }
34
+ fromCatalogProductVariant(variation, parentProduct) {
35
+ const imageURLs = variation.images
36
+ ?.map((img) => img.url ?? img.relativeUrl)
37
+ .filter((url) => !!url);
38
+ const selectedOptions = this.extractSelectedOptions(variation);
39
+ const weight = this.extractWeight(variation);
40
+ const dimensions = this.extractDimensions(variation);
41
+ const taxType = variation.taxType ?? parentProduct?.taxType;
42
+ const taxable = taxType ? true : undefined;
43
+ return {
44
+ id: variation.id ?? '',
45
+ externalId: variation.outerId,
46
+ externalProductId: parentProduct?.code ?? variation.code,
47
+ productId: variation.mainProductId ?? parentProduct?.id ?? '',
48
+ sku: variation.code ?? '',
49
+ barcode: variation.gtin,
50
+ title: variation.name ?? parentProduct?.name ?? '',
51
+ selectedOptions,
52
+ taxable,
53
+ inventoryNotTracked: variation.trackInventory === false ? true : undefined,
54
+ weight,
55
+ dimensions,
56
+ imageURLs: imageURLs?.length ? imageURLs : undefined,
57
+ customFields: this.extractCustomFields(variation.properties),
58
+ createdAt: variation.createdDate ?? this.now(),
59
+ updatedAt: variation.modifiedDate ?? this.now(),
60
+ tenantId: this.tenantId,
61
+ };
62
+ }
63
+ fromCatalogProductVariants(products) {
64
+ return products.flatMap((product) => {
65
+ if (product.variations?.length) {
66
+ return product.variations.map((v) => this.fromCatalogProductVariant(v, product));
67
+ }
68
+ return [this.fromCatalogProductVariant(product)];
69
+ });
70
+ }
71
+ extractSelectedOptions(variation) {
72
+ if (!variation.properties?.length) {
73
+ return undefined;
74
+ }
75
+ const options = variation.properties
76
+ .filter((p) => p.type === 'Variation' && p.name && p.values?.length)
77
+ .map((p) => ({
78
+ name: p.name,
79
+ value: String(p.values[0].value ?? ''),
80
+ }))
81
+ .filter((o) => o.value);
82
+ return options.length ? options : undefined;
83
+ }
84
+ extractWeight(product) {
85
+ if (product.weight == null) {
86
+ return undefined;
87
+ }
88
+ const unitMap = {
89
+ lb: 'lb', lbs: 'lb', pound: 'lb', pounds: 'lb',
90
+ oz: 'oz', ounce: 'oz', ounces: 'oz',
91
+ kg: 'kg', kilogram: 'kg', kilograms: 'kg',
92
+ g: 'g', gram: 'g', grams: 'g',
93
+ };
94
+ const rawUnit = (product.weightUnit ?? 'kg').toLowerCase();
95
+ const unit = unitMap[rawUnit] ?? 'kg';
96
+ return { value: product.weight, unit };
97
+ }
98
+ extractDimensions(product) {
99
+ if (product.length == null && product.width == null && product.height == null) {
100
+ return undefined;
101
+ }
102
+ const unitMap = {
103
+ cm: 'cm', centimeter: 'cm', centimeters: 'cm',
104
+ in: 'in', inch: 'in', inches: 'in',
105
+ ft: 'ft', foot: 'ft', feet: 'ft',
106
+ };
107
+ const rawUnit = (product.measureUnit ?? 'cm').toLowerCase();
108
+ const unit = unitMap[rawUnit] ?? 'cm';
109
+ return {
110
+ length: product.length ?? 0,
111
+ width: product.width ?? 0,
112
+ height: product.height ?? 0,
113
+ unit,
114
+ };
115
+ }
116
+ fromInventoryInfo(info, sku) {
117
+ const inStock = info.inStockQuantity ?? 0;
118
+ const reserved = info.reservedQuantity ?? 0;
119
+ const available = inStock - reserved;
120
+ return {
121
+ sku,
122
+ locationId: info.fulfillmentCenterId ?? '',
123
+ available: Math.max(available, 0),
124
+ onHand: inStock,
125
+ unavailable: reserved,
126
+ tenantId: this.tenantId,
127
+ };
128
+ }
129
+ fromInventoryInfos(records, skuMap) {
130
+ return records
131
+ .map((info) => {
132
+ const sku = info.productId ? skuMap.get(info.productId) : undefined;
133
+ if (!sku) {
134
+ return undefined;
135
+ }
136
+ return this.fromInventoryInfo(info, sku);
137
+ })
138
+ .filter((item) => item != null);
139
+ }
140
+ mapProductStatus(product) {
141
+ if (!product.isActive) {
142
+ return 'inactive';
143
+ }
144
+ if (!product.isBuyable) {
145
+ return 'draft';
146
+ }
147
+ return 'active';
148
+ }
149
+ extractOptions(product) {
150
+ if (!product.variations?.length) {
151
+ return [];
152
+ }
153
+ const optionMap = new Map();
154
+ for (const variation of product.variations) {
155
+ if (!variation.properties) {
156
+ continue;
157
+ }
158
+ for (const prop of variation.properties) {
159
+ if (prop.type === 'Variation' && prop.name && prop.values?.length) {
160
+ const values = optionMap.get(prop.name) ?? new Set();
161
+ for (const val of prop.values) {
162
+ if (val.value != null) {
163
+ values.add(String(val.value));
164
+ }
165
+ }
166
+ optionMap.set(prop.name, values);
167
+ }
168
+ }
169
+ }
170
+ return Array.from(optionMap.entries()).map(([name, valuesSet]) => ({
171
+ name,
172
+ values: Array.from(valuesSet),
173
+ }));
174
+ }
175
+ extractTags(properties) {
176
+ if (!properties?.length) {
177
+ return undefined;
178
+ }
179
+ const tagProp = properties.find((p) => p.name?.toLowerCase() === 'tags' || p.name?.toLowerCase() === 'tag');
180
+ if (tagProp?.values?.length) {
181
+ const tags = tagProp.values
182
+ .map((v) => (v.value != null ? String(v.value) : ''))
183
+ .filter(Boolean);
184
+ return tags.length ? tags : undefined;
185
+ }
186
+ return undefined;
187
+ }
188
+ extractCustomFields(properties) {
189
+ if (!properties?.length) {
190
+ return undefined;
191
+ }
192
+ const fields = properties
193
+ .filter((p) => p.type === 'Product' && p.values?.length)
194
+ .map((p) => ({
195
+ name: p.name ?? '',
196
+ value: String(p.values?.[0]?.value ?? ''),
197
+ }))
198
+ .filter((f) => f.name && f.value);
199
+ return fields.length ? fields : undefined;
200
+ }
201
+ }
202
+ //# sourceMappingURL=product.transformer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"product.transformer.js","sourceRoot":"","sources":["../../src/transformers/product.transformer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { Return, CreateReturnInput } from '@virtocommerce/cof-mcp';
2
+ import type { VcReturn, CustomerOrder } from '../models/index.js';
3
+ import { BaseTransformer } from './base.js';
4
+ export declare class ReturnTransformer extends BaseTransformer {
5
+ toMcpReturn(vcReturn: VcReturn, order?: CustomerOrder): Return;
6
+ toMcpReturns(vcReturns: VcReturn[], orderMap: Map<string, CustomerOrder>): Return[];
7
+ private toMcpReturnLineItem;
8
+ fromCreateReturnInput(input: CreateReturnInput, order: CustomerOrder): VcReturn;
9
+ private mapReturnStatus;
10
+ private reverseMapReturnStatus;
11
+ }
12
+ //# sourceMappingURL=return.transformer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"return.transformer.d.ts","sourceRoot":"","sources":["../../src/transformers/return.transformer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAkB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,KAAK,EAAE,QAAQ,EAAoB,aAAa,EAAY,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA2B5C,qBAAa,iBAAkB,SAAQ,eAAe;IAIpD,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM;IAoB9D,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,EAAE;IAUnF,OAAO,CAAC,mBAAmB;IAiB3B,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,aAAa,GAAG,QAAQ;IAyB/E,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,sBAAsB;CAM/B"}
@@ -0,0 +1,83 @@
1
+ import { BaseTransformer } from './base.js';
2
+ const RETURN_STATUS_MAP = {
3
+ New: 'requested',
4
+ Approved: 'approved',
5
+ Processing: 'processing',
6
+ Completed: 'completed',
7
+ Canceled: 'cancelled',
8
+ };
9
+ const REVERSE_RETURN_STATUS_MAP = {
10
+ requested: 'New',
11
+ pending: 'New',
12
+ approved: 'Approved',
13
+ processing: 'Processing',
14
+ completed: 'Completed',
15
+ cancelled: 'Canceled',
16
+ canceled: 'Canceled',
17
+ declined: 'Canceled',
18
+ };
19
+ export class ReturnTransformer extends BaseTransformer {
20
+ toMcpReturn(vcReturn, order) {
21
+ const orderItems = order?.items ?? vcReturn.order?.items ?? [];
22
+ return {
23
+ id: vcReturn.id ?? '',
24
+ returnNumber: vcReturn.number,
25
+ orderId: vcReturn.orderId ?? '',
26
+ status: this.mapReturnStatus(vcReturn.status),
27
+ outcome: vcReturn.resolution ?? '',
28
+ returnLineItems: (vcReturn.lineItems ?? []).map((item) => this.toMcpReturnLineItem(item, orderItems)),
29
+ createdAt: vcReturn.createdDate ?? this.now(),
30
+ updatedAt: vcReturn.modifiedDate ?? this.now(),
31
+ requestedAt: vcReturn.createdDate,
32
+ tenantId: this.tenantId,
33
+ };
34
+ }
35
+ toMcpReturns(vcReturns, orderMap) {
36
+ return vcReturns.map((vcReturn) => {
37
+ const order = vcReturn.orderId ? orderMap.get(vcReturn.orderId) : undefined;
38
+ return this.toMcpReturn(vcReturn, order);
39
+ });
40
+ }
41
+ toMcpReturnLineItem(vcItem, orderItems) {
42
+ const orderLineItem = orderItems.find((li) => li.id === vcItem.orderLineItemId);
43
+ return {
44
+ id: vcItem.id,
45
+ orderLineItemId: vcItem.orderLineItemId ?? '',
46
+ sku: orderLineItem?.sku ?? '',
47
+ quantityReturned: vcItem.quantity ?? 0,
48
+ returnReason: vcItem.reason ?? 'unknown',
49
+ unitPrice: vcItem.price,
50
+ name: orderLineItem?.name,
51
+ };
52
+ }
53
+ fromCreateReturnInput(input, order) {
54
+ const orderItems = order.items ?? [];
55
+ return {
56
+ orderId: input.return.orderId,
57
+ status: this.reverseMapReturnStatus(input.return.status) ?? 'New',
58
+ resolution: input.return.outcome,
59
+ lineItems: (input.return.returnLineItems ?? []).map((item) => {
60
+ const orderLineItem = orderItems.find((li) => li.id === item.orderLineItemId || li.sku === item.sku);
61
+ return {
62
+ orderLineItemId: item.orderLineItemId ?? orderLineItem?.id,
63
+ quantity: item.quantityReturned,
64
+ reason: item.returnReason,
65
+ price: item.unitPrice ?? orderLineItem?.price ?? 0,
66
+ };
67
+ }),
68
+ };
69
+ }
70
+ mapReturnStatus(status) {
71
+ if (!status) {
72
+ return 'requested';
73
+ }
74
+ return RETURN_STATUS_MAP[status] ?? status.toLowerCase();
75
+ }
76
+ reverseMapReturnStatus(status) {
77
+ if (!status) {
78
+ return undefined;
79
+ }
80
+ return REVERSE_RETURN_STATUS_MAP[status] ?? undefined;
81
+ }
82
+ }
83
+ //# sourceMappingURL=return.transformer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"return.transformer.js","sourceRoot":"","sources":["../../src/transformers/return.transformer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,135 @@
1
+ export interface AdapterOptions {
2
+ apiUrl: string;
3
+ apiKey: string;
4
+ workspace?: string;
5
+ catalogId?: string;
6
+ timeout?: number;
7
+ retryAttempts?: number;
8
+ debugMode?: boolean;
9
+ }
10
+ export interface YourFulfillmentApiResponse<T = any> {
11
+ success: boolean;
12
+ data?: T;
13
+ error?: {
14
+ code: string;
15
+ message: string;
16
+ details?: Record<string, unknown>;
17
+ };
18
+ metadata?: {
19
+ timestamp: string;
20
+ requestId: string;
21
+ version: string;
22
+ };
23
+ }
24
+ export interface YourFulfillmentOrder {
25
+ id: string;
26
+ number: string;
27
+ external_id: string;
28
+ status: string;
29
+ customer: {
30
+ id: string;
31
+ email: string;
32
+ first_name: string;
33
+ last_name: string;
34
+ phone?: string;
35
+ };
36
+ items: YourFulfillmentOrderItem[];
37
+ total: number;
38
+ currency: string;
39
+ created_at: string;
40
+ updated_at: string;
41
+ shipping_address?: YourFulfillmentAddress;
42
+ billing_address?: YourFulfillmentAddress;
43
+ metadata?: Record<string, any>;
44
+ }
45
+ export interface YourFulfillmentOrderItem {
46
+ sku: string;
47
+ name: string;
48
+ quantity: number;
49
+ price: number;
50
+ discount?: number;
51
+ tax?: number;
52
+ subtotal: number;
53
+ }
54
+ export interface YourFulfillmentAddress {
55
+ street1: string;
56
+ street2?: string;
57
+ city: string;
58
+ state: string;
59
+ postal_code: string;
60
+ country: string;
61
+ phone?: string;
62
+ email?: string;
63
+ name?: string;
64
+ company?: string;
65
+ }
66
+ export interface YourFulfillmentProduct {
67
+ id: string;
68
+ sku: string;
69
+ name: string;
70
+ description?: string;
71
+ price: number;
72
+ inventory: number;
73
+ status: 'active' | 'inactive' | 'archived';
74
+ created_at: string;
75
+ updated_at: string;
76
+ attributes?: Record<string, any>;
77
+ }
78
+ export interface YourFulfillmentInventory {
79
+ sku: string;
80
+ available: number;
81
+ reserved: number;
82
+ total: number;
83
+ warehouse_locations?: {
84
+ location_id: string;
85
+ available: number;
86
+ reserved: number;
87
+ }[];
88
+ updated_at: string;
89
+ }
90
+ export interface YourFulfillmentCustomer {
91
+ id: string;
92
+ email: string;
93
+ first_name: string;
94
+ last_name: string;
95
+ phone?: string;
96
+ created_at: string;
97
+ updated_at: string;
98
+ addresses?: YourFulfillmentAddress[];
99
+ tags?: string[];
100
+ metadata?: Record<string, any>;
101
+ }
102
+ export interface YourFulfillmentShipment {
103
+ id: string;
104
+ order_id: string;
105
+ tracking_number: string;
106
+ carrier: string;
107
+ service: string;
108
+ status: string;
109
+ shipped_at?: string;
110
+ delivered_at?: string;
111
+ tracking_url?: string;
112
+ items: {
113
+ sku: string;
114
+ quantity: number;
115
+ }[];
116
+ from_address?: YourFulfillmentAddress;
117
+ to_address?: YourFulfillmentAddress;
118
+ }
119
+ export declare const STATUS_MAP: Record<string, string>;
120
+ export declare const REVERSE_STATUS_MAP: Record<string, string>;
121
+ export declare enum ErrorCode {
122
+ CONNECTION_FAILED = "CONNECTION_FAILED",
123
+ AUTHENTICATION_FAILED = "AUTHENTICATION_FAILED",
124
+ INVALID_REQUEST = "INVALID_REQUEST",
125
+ ORDER_NOT_FOUND = "ORDER_NOT_FOUND",
126
+ PRODUCT_NOT_FOUND = "PRODUCT_NOT_FOUND",
127
+ CUSTOMER_NOT_FOUND = "CUSTOMER_NOT_FOUND",
128
+ INSUFFICIENT_INVENTORY = "INSUFFICIENT_INVENTORY",
129
+ INVALID_ORDER_STATE = "INVALID_ORDER_STATE",
130
+ RETURN_NOT_FOUND = "RETURN_NOT_FOUND",
131
+ API_ERROR = "API_ERROR",
132
+ TIMEOUT = "TIMEOUT",
133
+ UNKNOWN_ERROR = "UNKNOWN_ERROR"
134
+ }
135
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,47 @@
1
+ export const STATUS_MAP = {
2
+ New: 'pending',
3
+ 'Not payed': 'not_payed',
4
+ Pending: 'pending_approval',
5
+ Processing: 'processing',
6
+ 'Ready to send': 'ready_to_send',
7
+ Cancelled: 'cancelled',
8
+ 'Partially sent': 'partially_shipped',
9
+ Completed: 'completed',
10
+ Shipped: 'shipped',
11
+ Delivered: 'delivered',
12
+ OnHold: 'on_hold',
13
+ Refunded: 'refunded',
14
+ PartiallyShipped: 'partially_shipped',
15
+ PartiallyDelivered: 'partially_delivered',
16
+ };
17
+ export const REVERSE_STATUS_MAP = {
18
+ pending: 'New',
19
+ not_payed: 'Not payed',
20
+ pending_approval: 'Pending',
21
+ processing: 'Processing',
22
+ ready_to_send: 'Ready to send',
23
+ cancelled: 'Cancelled',
24
+ partially_shipped: 'Partially sent',
25
+ completed: 'Completed',
26
+ shipped: 'Shipped',
27
+ delivered: 'Delivered',
28
+ on_hold: 'OnHold',
29
+ refunded: 'Refunded',
30
+ partially_delivered: 'PartiallyDelivered',
31
+ };
32
+ export var ErrorCode;
33
+ (function (ErrorCode) {
34
+ ErrorCode["CONNECTION_FAILED"] = "CONNECTION_FAILED";
35
+ ErrorCode["AUTHENTICATION_FAILED"] = "AUTHENTICATION_FAILED";
36
+ ErrorCode["INVALID_REQUEST"] = "INVALID_REQUEST";
37
+ ErrorCode["ORDER_NOT_FOUND"] = "ORDER_NOT_FOUND";
38
+ ErrorCode["PRODUCT_NOT_FOUND"] = "PRODUCT_NOT_FOUND";
39
+ ErrorCode["CUSTOMER_NOT_FOUND"] = "CUSTOMER_NOT_FOUND";
40
+ ErrorCode["INSUFFICIENT_INVENTORY"] = "INSUFFICIENT_INVENTORY";
41
+ ErrorCode["INVALID_ORDER_STATE"] = "INVALID_ORDER_STATE";
42
+ ErrorCode["RETURN_NOT_FOUND"] = "RETURN_NOT_FOUND";
43
+ ErrorCode["API_ERROR"] = "API_ERROR";
44
+ ErrorCode["TIMEOUT"] = "TIMEOUT";
45
+ ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
46
+ })(ErrorCode || (ErrorCode = {}));
47
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA6IA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAEhD,GAAG,EAAE,SAAS;IACd,WAAW,EAAE,WAAW;IACxB,OAAO,EAAE,kBAAkB;IAC3B,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,eAAe;IAChC,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,mBAAmB;IACrC,SAAS,EAAE,WAAW;IAEtB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,UAAU;IACpB,gBAAgB,EAAE,mBAAmB;IACrC,kBAAkB,EAAE,qBAAqB;CAC1C,CAAC;AAGF,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,SAAS;IAC3B,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,eAAe;IAC9B,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,gBAAgB;IACnC,SAAS,EAAE,WAAW;IAEtB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,UAAU;IACpB,mBAAmB,EAAE,oBAAoB;CAC1C,CAAC;AAGF,MAAM,CAAN,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB,oDAAuC,CAAA;IACvC,4DAA+C,CAAA;IAC/C,gDAAmC,CAAA;IACnC,gDAAmC,CAAA;IACnC,oDAAuC,CAAA;IACvC,sDAAyC,CAAA;IACzC,8DAAiD,CAAA;IACjD,wDAA2C,CAAA;IAC3C,kDAAqC,CAAA;IACrC,oCAAuB,CAAA;IACvB,gCAAmB,CAAA;IACnB,4CAA+B,CAAA;AACjC,CAAC,EAbW,SAAS,KAAT,SAAS,QAapB"}
@@ -0,0 +1,31 @@
1
+ import type { YourFulfillmentApiResponse } from '../types.js';
2
+ export interface ApiClientConfig {
3
+ baseUrl: string;
4
+ apiKey: string;
5
+ timeout?: number;
6
+ retryAttempts?: number;
7
+ debugMode?: boolean;
8
+ headers?: Record<string, string>;
9
+ }
10
+ export declare class ApiClient {
11
+ private client;
12
+ private config;
13
+ private retryAttempts;
14
+ private debugMode;
15
+ constructor(config: ApiClientConfig);
16
+ get<T = unknown>(path: string, params?: unknown): Promise<YourFulfillmentApiResponse<T>>;
17
+ post<T = unknown>(path: string, data?: unknown, params?: unknown): Promise<YourFulfillmentApiResponse<T>>;
18
+ put<T = unknown>(path: string, data?: unknown, params?: unknown): Promise<YourFulfillmentApiResponse<T>>;
19
+ patch<T = unknown>(path: string, data?: unknown, params?: unknown): Promise<YourFulfillmentApiResponse<T>>;
20
+ delete<T = unknown>(path: string, params?: unknown): Promise<YourFulfillmentApiResponse<T>>;
21
+ private request;
22
+ private handleAxiosError;
23
+ private shouldRetry;
24
+ private getErrorCode;
25
+ private getErrorMessage;
26
+ private sleep;
27
+ updateApiKey(apiKey: string): void;
28
+ getConfig(): ApiClientConfig;
29
+ setDebugMode(enabled: boolean): void;
30
+ }
31
+ //# sourceMappingURL=api-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/utils/api-client.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,EAAE,eAAe;IA6E7B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAWxF,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAYzG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAYxG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAY1G,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;YAWnF,OAAO;YA6BP,gBAAgB;IAyC9B,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,KAAK;IAOb,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWlC,SAAS,IAAI,eAAe;IAO5B,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAGrC"}