@tallyui/connector-woocommerce 3.20.0 → 4.0.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.
package/dist/index.js CHANGED
@@ -1,10 +1,11 @@
1
1
  // src/index.ts
2
- import { combinePullAdapters, ConnectorUnauthorizedError as ConnectorUnauthorizedError4 } from "@tallyui/core";
2
+ import { combinePullAdapters, ConnectorUnauthorizedError as ConnectorUnauthorizedError5 } from "@tallyui/core";
3
3
 
4
4
  // src/schemas/products.ts
5
5
  var wooProductSchema = {
6
6
  title: "WooCommerce Product",
7
- version: 2,
7
+ version: 4,
8
+ // 3: backorders (A16); 4: low_stock_amount; a till resyncs its products once
8
9
  type: "object",
9
10
  primaryKey: "uuid",
10
11
  properties: {
@@ -68,6 +69,9 @@ var wooProductSchema = {
68
69
  stock_quantity: {
69
70
  type: ["number", "null"]
70
71
  },
72
+ low_stock_amount: {
73
+ type: ["number", "null"]
74
+ },
71
75
  stock_status: {
72
76
  type: "string",
73
77
  default: "instock",
@@ -78,6 +82,7 @@ var wooProductSchema = {
78
82
  type: "boolean",
79
83
  default: false
80
84
  },
85
+ backorders: { type: "string" },
81
86
  categories: {
82
87
  type: "array",
83
88
  items: {
@@ -146,7 +151,9 @@ var wooProductSchema = {
146
151
  on_sale: { type: "boolean" },
147
152
  stock_status: { type: "string" },
148
153
  stock_quantity: { type: ["number", "null"] },
154
+ low_stock_amount: { type: ["number", "null"] },
149
155
  manage_stock: { type: "boolean" },
156
+ backorders: { type: "string" },
150
157
  status: { type: "string" },
151
158
  purchasable: { type: "boolean" },
152
159
  attributes: { type: "array", items: { type: "object", properties: { name: { type: "string" }, option: { type: "string" } } } }
@@ -354,7 +361,9 @@ function toVariationDocument(payload) {
354
361
  on_sale,
355
362
  stock_status,
356
363
  stock_quantity,
364
+ low_stock_amount,
357
365
  manage_stock,
366
+ backorders,
358
367
  status,
359
368
  purchasable,
360
369
  tax_class,
@@ -370,7 +379,9 @@ function toVariationDocument(payload) {
370
379
  on_sale,
371
380
  stock_status,
372
381
  stock_quantity,
382
+ low_stock_amount,
373
383
  manage_stock,
384
+ backorders,
374
385
  status,
375
386
  purchasable,
376
387
  tax_class,
@@ -407,9 +418,9 @@ var WooDateFilterError = class extends Error {
407
418
  minVersion = "5.8";
408
419
  };
409
420
  var WooTokenRefusedError = class extends Error {
410
- constructor(storeCode) {
421
+ constructor(storeCode2) {
411
422
  super("The store refused the sign-in token (403). Ask the store owner to check the JWT Authentication plugin's settings, or pair the till again.");
412
- this.storeCode = storeCode;
423
+ this.storeCode = storeCode2;
413
424
  }
414
425
  name = "WooTokenRefusedError";
415
426
  code = "store_misconfigured";
@@ -483,7 +494,9 @@ var wooProductReplication = {
483
494
  });
484
495
  await checkResponse(response2);
485
496
  const body = await response2.json();
486
- for (const doc of body.documents) {
497
+ const docs = Array.isArray(body) ? body.map((payload) => ({ parent_id: payload.parent_id, payload })) : Array.isArray(body?.documents) ? body.documents : void 0;
498
+ if (!docs) throw new Error(`Unexpected /variations response: ${JSON.stringify(body)?.slice(0, 100)}`);
499
+ for (const doc of docs) {
487
500
  const parentId = doc.parent_id ?? doc.payload.parent_id;
488
501
  const group = variations.get(parentId) ?? [];
489
502
  group.push(toVariationDocument(doc.payload));
@@ -510,6 +523,7 @@ var WOO_STOCK_STATUS = {
510
523
  outofstock: "out_of_stock",
511
524
  onbackorder: "backorder"
512
525
  };
526
+ var WOO_BACKORDERS = /* @__PURE__ */ new Set(["no", "notify", "yes"]);
513
527
  var wooProductTraits = {
514
528
  getId: (doc) => String(doc.id),
515
529
  getName: (doc) => doc.name ?? "",
@@ -536,7 +550,8 @@ var wooProductTraits = {
536
550
  },
537
551
  getStock: (doc) => ({
538
552
  status: WOO_STOCK_STATUS[doc.stock_status] ?? "unknown",
539
- quantity: doc.manage_stock === false ? void 0 : doc.stock_quantity ?? void 0
553
+ quantity: doc.manage_stock === false ? void 0 : doc.stock_quantity ?? void 0,
554
+ ...WOO_BACKORDERS.has(doc.backorders) ? { backorders: doc.backorders } : {}
540
555
  }),
541
556
  getPrice: (doc) => doc.price || void 0,
542
557
  getRegularPrice: (doc) => doc.regular_price || void 0,
@@ -843,6 +858,14 @@ var WOO_ADDRESS = [
843
858
  ["email", "email"],
844
859
  ["phone", "phone"]
845
860
  ];
861
+ function fromWooAddress(raw, kind) {
862
+ const address = {};
863
+ for (const [key, field] of WOO_ADDRESS) {
864
+ const value = raw?.[key];
865
+ if ((kind === "billing" || key !== "email") && typeof value === "string" && value.length > 0) address[field] = value;
866
+ }
867
+ return Object.keys(address).length > 0 ? address : void 0;
868
+ }
846
869
  function toWooAddress(address, kind) {
847
870
  return Object.fromEntries(WOO_ADDRESS.filter(([key]) => kind === "billing" || key !== "email").map(([key, field]) => [key, address[field] ?? ""]));
848
871
  }
@@ -877,6 +900,10 @@ function toWooCustomer(raw) {
877
900
  ]) {
878
901
  if (typeof value === "string" && value.length > 0) customer[key] = value;
879
902
  }
903
+ const billing = fromWooAddress(raw.billing, "billing");
904
+ if (billing) customer.billing = billing;
905
+ const shipping = fromWooAddress(raw.shipping, "shipping");
906
+ if (shipping) customer.shipping = shipping;
880
907
  const created = raw.date_created_gmt;
881
908
  if (typeof created === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/.test(created)) customer.createdAt = `${created}Z`;
882
909
  customer.name = [customer.firstName, customer.lastName].filter(Boolean).join(" ") || customer.company || customer.email || customer.id;
@@ -911,6 +938,12 @@ async function customerRequest(context, route, init = {}) {
911
938
  }
912
939
  function createWooCustomers(options) {
913
940
  const newId = options?.newId ?? newWooId;
941
+ const readCustomerRow = async (context, id) => {
942
+ const params = new URLSearchParams({ include: id, per_page: "1", role: "all" });
943
+ const { body } = await customerRequest(context, `customers?${params}`, { method: "GET" });
944
+ if (!Array.isArray(body)) throw new CustomerServiceError("server", "unexpected response");
945
+ return body.find((row) => String(row.id) === id);
946
+ };
914
947
  const api = {
915
948
  async searchCustomers(context, query, options2) {
916
949
  return (await api.searchCustomersPage(context, query, { limit: options2?.limit })).customers;
@@ -929,10 +962,7 @@ function createWooCustomers(options) {
929
962
  },
930
963
  async getCustomer(context, id) {
931
964
  if (!/^\d+$/.test(id)) return null;
932
- const params = new URLSearchParams({ include: id, per_page: "1", role: "all" });
933
- const { body } = await customerRequest(context, `customers?${params}`, { method: "GET" });
934
- if (!Array.isArray(body)) throw new CustomerServiceError("server", "unexpected response");
935
- const raw = body.find((row) => String(row.id) === id);
965
+ const raw = await readCustomerRow(context, id);
936
966
  return raw ? toWooCustomer(raw) : null;
937
967
  },
938
968
  async createCustomer(context, input) {
@@ -967,12 +997,9 @@ function createWooCustomers(options) {
967
997
  async updateCustomer(context, id, patch) {
968
998
  if (!/^\d+$/.test(id)) throw new CustomerServiceError("invalid", "Unknown customer");
969
999
  if (patch.shipping?.email) throw new CustomerServiceError("invalid", "WooCommerce shipping addresses have no email");
970
- const params = new URLSearchParams({ include: id, per_page: "1", role: "all" });
971
- const { body: rows2 } = await customerRequest(context, `customers?${params}`, { method: "GET" });
972
- if (!Array.isArray(rows2)) throw new CustomerServiceError("server", "unexpected response");
973
- const row = rows2.find((raw) => String(raw.id) === id);
1000
+ const row = await readCustomerRow(context, id);
974
1001
  if (!row) throw new CustomerServiceError("invalid", "Unknown customer");
975
- const uuid = row.meta_data?.find((entry) => entry.key === "_woocommerce_pos_uuid")?.value;
1002
+ const uuid = row.meta_data?.find((entry) => entry.key === WCPOS_UUID_META_KEY)?.value;
976
1003
  if (typeof uuid !== "string" || !uuid) throw new CustomerServiceError("server", "unexpected response");
977
1004
  const payload = toWooPatch(patch);
978
1005
  if (Object.keys(payload).length === 0) return toWooCustomer(row);
@@ -1012,7 +1039,47 @@ import {
1012
1039
  } from "@tallyui/core";
1013
1040
 
1014
1041
  // src/commands/transport.ts
1015
- import { minorUnitDigits, moneyFromDecimalString, moneyFromMajor as moneyFromMajor2 } from "@tallyui/core";
1042
+ import { minorUnitDigits, moneyFromDecimalString, moneyFromMajor as moneyFromMajor2, woocommerceTax } from "@tallyui/core";
1043
+
1044
+ // src/commands/http.ts
1045
+ function createWooCall(options) {
1046
+ const fetch = options.fetch ?? globalThis.fetch;
1047
+ let baseUrl = options.baseUrl;
1048
+ while (baseUrl.endsWith("/")) baseUrl = baseUrl.slice(0, -1);
1049
+ const call = async (path, init) => {
1050
+ const controller = new AbortController();
1051
+ const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? 3e4);
1052
+ try {
1053
+ const response = await fetch(`${baseUrl}/${path}`, {
1054
+ method: init.method,
1055
+ headers: { ...init.body === void 0 ? {} : { "Content-Type": "application/json" }, ...await options.getHeaders() },
1056
+ ...init.body === void 0 ? {} : { body: JSON.stringify(init.body) },
1057
+ signal: controller.signal
1058
+ });
1059
+ let body;
1060
+ try {
1061
+ body = await response.json();
1062
+ } catch {
1063
+ }
1064
+ return { status: response.status, body, retryAfter: response.headers.get("Retry-After"), aborted: controller.signal.aborted };
1065
+ } catch {
1066
+ return { status: 0, aborted: controller.signal.aborted };
1067
+ } finally {
1068
+ clearTimeout(timeout);
1069
+ }
1070
+ };
1071
+ const retry = (answer, reason) => {
1072
+ if (answer.status === 0) return { kind: "retry", reason: answer.aborted ? "timeout" : "network" };
1073
+ const seconds = answer.retryAfter == null ? NaN : Number(answer.retryAfter);
1074
+ return { kind: "retry", reason, ...Number.isFinite(seconds) && seconds >= 0 ? { retryAfterMs: seconds * 1e3 } : {} };
1075
+ };
1076
+ return { call, retry };
1077
+ }
1078
+
1079
+ // src/commands/transport.ts
1080
+ var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
1081
+ var wooDigits = (p) => p.display?.exponent ?? minorUnitDigits(p.currency);
1082
+ var wooMajor = (minor2, digits) => (minor2 / 10 ** digits).toFixed(digits);
1016
1083
  function wooMinorFromDecimal(text, currency) {
1017
1084
  const trimmed = text.trim();
1018
1085
  if (!/^\d+(\.\d+)?$/.test(trimmed)) return void 0;
@@ -1023,6 +1090,20 @@ function wooMinorFromDecimal(text, currency) {
1023
1090
  if (end > digits) return moneyFromMajor2(trimmed, currency)?.amount;
1024
1091
  return moneyFromDecimalString(end ? `${whole}.${fraction.slice(0, end)}` : whole, currency)?.amount;
1025
1092
  }
1093
+ function preCouponNetMicros(minor2, digits, stored) {
1094
+ if (!stored || stored.taxLines?.some((tax) => typeof tax.rateId !== "number" || typeof tax.compound !== "boolean")) return void 0;
1095
+ const factor = 10 ** digits, precision = woocommerceTax.getRoundingPrecision(digits);
1096
+ const input = { amount: Number(minor2) / factor, rates: (stored.taxLines ?? []).map((tax, index) => ({
1097
+ id: tax.rateId,
1098
+ rate: String(tax.ratePpm / 1e4),
1099
+ compound: tax.compound,
1100
+ priority: index,
1101
+ order: index
1102
+ })), amountIncludesTax: true, dp: digits, perRatePrecision: precision };
1103
+ const result = woocommerceTax.calculateTaxes(input);
1104
+ const net = woocommerceTax.roundHalfUp(input.amount - result.total, precision);
1105
+ return String(Math.round(net * factor * 1e6));
1106
+ }
1026
1107
  function stripTags(text) {
1027
1108
  let previous;
1028
1109
  do {
@@ -1060,6 +1141,15 @@ function toWooOrderPayload(envelope, local, options) {
1060
1141
  if (p.payments.length === 0 || p.payments.length > 1 && !options?.paymentsList) {
1061
1142
  return { error: { code: "invalid_payload", message: "WooCommerce orders take one payment." } };
1062
1143
  }
1144
+ const ledger = options?.ledger === true;
1145
+ const closes = p.totalMinor === 0 && !p.payments.some((payment) => payment.amountMinor > 0);
1146
+ if (ledger && p.payments.some((payment) => !UUID.test(payment.clientPaymentId))) {
1147
+ return { error: { code: "invalid_payload", message: "WooCommerce POS 2.0 records each payment by a UUID; this sale has a payment without one." } };
1148
+ }
1149
+ if (ledger && closes && !UUID.test(envelope.id)) return { error: { code: "invalid_payload", message: "WooCommerce POS 2.0 closes a free sale by a UUID command id; this sale's id is not one." } };
1150
+ if (ledger && !closes && p.payments.some((payment) => payment.amountMinor <= 0)) {
1151
+ return { error: { code: "invalid_payload", message: "Every payment on a WooCommerce POS 2.0 sale must be more than zero." } };
1152
+ }
1063
1153
  if (p.payments.length > 20) {
1064
1154
  return { error: { code: "invalid_payload", message: "WooCommerce records at most 20 payments." } };
1065
1155
  }
@@ -1071,8 +1161,8 @@ function toWooOrderPayload(envelope, local, options) {
1071
1161
  return { error: { code: "invalid_payload", message: `Line ${line.clientLineId} has no WooCommerce product id.` } };
1072
1162
  }
1073
1163
  }
1074
- const digits = p.display?.exponent ?? minorUnitDigits(p.currency);
1075
- const major = (minor2) => (minor2 / 10 ** digits).toFixed(digits);
1164
+ const digits = wooDigits(p);
1165
+ const major = (minor2) => wooMajor(minor2, digits);
1076
1166
  const inclusiveNet = (netMicros, id) => {
1077
1167
  if (netMicros === void 0) {
1078
1168
  return { error: { code: "unsupported_tax_mode", message: "Tax-inclusive prices need the till's WooCommerce tax figures; update the till." } };
@@ -1087,21 +1177,29 @@ function toWooOrderPayload(envelope, local, options) {
1087
1177
  const micros = net / divisor;
1088
1178
  return `${micros / 1000000n}.${(micros % 1000000n).toString().padStart(6, "0")}`;
1089
1179
  };
1180
+ const chargeTotal = (amountMinor, netMicros, id) => p.pricesIncludeTax || netMicros !== void 0 && BigInt(netMicros) !== BigInt(amountMinor) * 1000000n ? inclusiveNet(netMicros, id) : major(amountMinor);
1090
1181
  const line_items = [];
1091
1182
  for (const line of p.lines) {
1183
+ const inclusive = line.taxInclusive ?? p.pricesIncludeTax;
1184
+ const stored = local?.lines.find((entry) => entry.id === line.clientLineId);
1092
1185
  let total = major(line.unitPriceMinor * line.quantity - (line.discountMinor ?? 0));
1093
1186
  let subtotal = total;
1094
- if (line.taxInclusive ?? p.pricesIncludeTax) {
1095
- const net = inclusiveNet(local?.lines.find((stored) => stored.id === line.clientLineId)?.netMicros, line.clientLineId);
1187
+ if (inclusive) {
1188
+ const net = inclusiveNet(stored?.netMicros, line.clientLineId);
1096
1189
  if (typeof net !== "string") return net;
1097
1190
  subtotal = total = net;
1098
1191
  }
1099
1192
  const custom = line.custom;
1100
1193
  let price = major(line.unitPriceMinor);
1101
1194
  if (p.coupons?.length) {
1102
- const discount = (line.taxInclusive ?? p.pricesIncludeTax) && (line.discountMinor ?? 0) > 0 ? local?.lines.find((stored) => stored.id === line.clientLineId)?.discountMinor : line.discountMinor ?? 0;
1195
+ const discount = inclusive && (line.discountMinor ?? 0) > 0 ? stored?.discountMinor : line.discountMinor ?? 0;
1103
1196
  if (discount === void 0) return { error: { code: "unsupported_tax_mode", message: "Tax-inclusive prices need the till's WooCommerce tax figures; update the till." } };
1104
1197
  const quantity = BigInt(line.quantity), minor2 = BigInt(line.unitPriceMinor) * quantity - BigInt(discount);
1198
+ if (inclusive) {
1199
+ const net = inclusiveNet(preCouponNetMicros(minor2, digits, stored), line.clientLineId);
1200
+ if (typeof net !== "string") return net;
1201
+ subtotal = total = net;
1202
+ }
1105
1203
  const divisor = quantity * 10n ** BigInt(digits), micros = (minor2 * 1000000n * 2n + divisor) / (divisor * 2n);
1106
1204
  price = minor2 % quantity === 0n ? major(Number(minor2 / quantity)) : `${micros / 1000000n}.${(micros % 1000000n).toString().padStart(6, "0")}`;
1107
1205
  }
@@ -1134,19 +1232,28 @@ function toWooOrderPayload(envelope, local, options) {
1134
1232
  }
1135
1233
  const fee_lines = [], shipping_lines = [];
1136
1234
  for (const fee of p.fees ?? []) {
1137
- const total = p.pricesIncludeTax ? inclusiveNet(local?.fees?.find((stored) => stored.id === fee.clientFeeId)?.netMicros, fee.clientFeeId) : major(fee.amountMinor);
1235
+ const total = chargeTotal(fee.amountMinor, local?.fees?.find((stored) => stored.id === fee.clientFeeId)?.netMicros, fee.clientFeeId);
1138
1236
  if (typeof total !== "string") return total;
1139
1237
  fee_lines.push({ name: fee.name, total, tax_status: fee.taxStatus, tax_class: fee.taxClass ?? "" });
1140
1238
  }
1141
1239
  for (const shipping2 of p.shipping ?? []) {
1142
- const total = p.pricesIncludeTax ? inclusiveNet(local?.shipping?.find((stored) => stored.id === shipping2.clientShippingId)?.netMicros, shipping2.clientShippingId) : major(shipping2.amountMinor);
1240
+ const total = chargeTotal(
1241
+ shipping2.amountMinor,
1242
+ local?.shipping?.find((stored) => stored.id === shipping2.clientShippingId)?.netMicros,
1243
+ shipping2.clientShippingId
1244
+ );
1143
1245
  if (typeof total !== "string") return total;
1144
- shipping_lines.push({ method_id: shipping2.methodId ?? "pos", method_title: shipping2.name, total });
1246
+ shipping_lines.push({
1247
+ method_id: shipping2.methodId ?? "pos",
1248
+ method_title: shipping2.name,
1249
+ total,
1250
+ ...shipping2.taxStatus === "none" ? { meta_data: [{ key: "_woocommerce_pos_data", value: JSON.stringify({ tax_status: "none" }) }] } : {}
1251
+ });
1145
1252
  }
1146
1253
  const primary = p.payments.reduce((largest, payment) => payment.amountMinor > largest.amountMinor ? payment : largest);
1147
1254
  const cash = primary.method === "cash";
1148
- const meta_data = [{ key: "_woocommerce_pos_uuid", value: p.clientOrderId }];
1149
- if (p.payments.length > 1) {
1255
+ const meta_data = [{ key: WCPOS_UUID_META_KEY, value: p.clientOrderId }];
1256
+ if (p.payments.length > 1 && !ledger) {
1150
1257
  meta_data.push({ key: "_woocommerce_pos_payments", value: JSON.stringify(p.payments.map((payment) => ({
1151
1258
  method: payment.method === "cash" ? "pos_cash" : "pos_card",
1152
1259
  title: payment.method === "cash" ? "Cash" : "Card",
@@ -1159,12 +1266,21 @@ function toWooOrderPayload(envelope, local, options) {
1159
1266
  if (p.taxAddress) meta_data.push({ key: "_woocommerce_pos_tax_based_on", value: p.taxAddress });
1160
1267
  const billing = { ...p.customer?.email ? { email: p.customer.email } : {}, ...p.taxAddress ? wooAddress(p.customer?.billing) : {} };
1161
1268
  const shipping = p.taxAddress && p.customer?.shipping ? wooAddress(p.customer.shipping) : void 0;
1162
- return { payload: {
1163
- status: "completed",
1164
- set_paid: true,
1269
+ const money = !ledger ? void 0 : closes ? [{ path: "close", body: { command_id: `${envelope.id.slice(0, 14)}8${envelope.id.slice(15)}` } }] : p.payments.map((payment) => ({ path: "payments", body: { payment: {
1270
+ id: payment.clientPaymentId,
1271
+ method_id: payment.method === "cash" ? "pos_cash" : "pos_card",
1272
+ amount: major(payment.amountMinor),
1165
1273
  currency: p.currency,
1166
- payment_method: cash ? "pos_cash" : "pos_card",
1167
- payment_method_title: cash ? "Cash" : "Card",
1274
+ ...payment.method === "cash" && payment.tenderedMinor !== void 0 ? { tendered: major(payment.tenderedMinor) } : {}
1275
+ } } }));
1276
+ return { ...money ? { money } : {}, payload: {
1277
+ ...ledger ? { status: "pending", currency: p.currency } : {
1278
+ status: "completed",
1279
+ set_paid: true,
1280
+ currency: p.currency,
1281
+ payment_method: cash ? "pos_cash" : "pos_card",
1282
+ payment_method_title: cash ? "Cash" : "Card"
1283
+ },
1168
1284
  line_items,
1169
1285
  ...fee_lines.length ? { fee_lines } : {},
1170
1286
  ...shipping_lines.length ? { shipping_lines } : {},
@@ -1177,14 +1293,28 @@ function toWooOrderPayload(envelope, local, options) {
1177
1293
  ...typeof p.note === "string" && p.note.length > 0 ? { customer_note: p.note } : {}
1178
1294
  } };
1179
1295
  }
1296
+ function capability(flag) {
1297
+ return typeof flag === "function" ? flag() : flag ?? false;
1298
+ }
1180
1299
  function createWooCommandTransport(options) {
1181
- const fetch = options.fetch ?? globalThis.fetch;
1182
- let baseUrl = options.baseUrl;
1183
- while (baseUrl.endsWith("/")) baseUrl = baseUrl.slice(0, -1);
1300
+ const { call, retry } = createWooCall(options);
1301
+ let siteLedger;
1302
+ const ledgerStore = async () => {
1303
+ if (options.ledgerPayments !== void 0) return capability(options.ledgerPayments);
1304
+ if (siteLedger === void 0) {
1305
+ const version2 = (await call("site", { method: "GET" })).body?.wcpos_version;
1306
+ const major = typeof version2 === "string" ? /^(\d+)\.\d+(?:\.\d+)?(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.exec(version2.trim())?.[1] : void 0;
1307
+ if (major !== void 0) siteLedger = Number(major) >= 2;
1308
+ }
1309
+ return siteLedger;
1310
+ };
1184
1311
  return {
1185
1312
  async send(batch, context) {
1186
- const paymentsList = typeof options.acceptsPaymentsList === "function" ? await options.acceptsPaymentsList() : options.acceptsPaymentsList ?? false;
1187
- const coupons = batch.some((envelope) => envelope.payload.coupons?.length) && (typeof options.acceptsCoupons === "function" ? await options.acceptsCoupons() : options.acceptsCoupons ?? false);
1313
+ if (batch.length === 0) return { kind: "results", results: [] };
1314
+ const ledger = await ledgerStore();
1315
+ if (ledger === void 0) return { kind: "retry", reason: "store_version_unknown" };
1316
+ const paymentsList = await capability(options.acceptsPaymentsList);
1317
+ const coupons = batch.some((envelope) => envelope.payload.coupons?.length) && await capability(options.acceptsCoupons);
1188
1318
  const results = [];
1189
1319
  for (const envelope of batch) {
1190
1320
  if (envelope.payload.coupons?.length && !coupons) {
@@ -1195,84 +1325,106 @@ function createWooCommandTransport(options) {
1195
1325
  } });
1196
1326
  continue;
1197
1327
  }
1198
- const mapped = toWooOrderPayload(envelope, context?.local?.orders?.get(envelope.id), { paymentsList });
1328
+ const mapped = toWooOrderPayload(envelope, context?.local?.orders?.get(envelope.id), { paymentsList, ledger });
1199
1329
  if ("error" in mapped) {
1200
1330
  results.push({ id: envelope.id, status: "rejected", error: mapped.error });
1201
1331
  continue;
1202
1332
  }
1203
- const controller = new AbortController();
1204
- const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? 3e4);
1205
1333
  let outcome;
1206
- try {
1207
- const response = await fetch(`${baseUrl}/push/orders`, {
1208
- method: "POST",
1209
- headers: { "Content-Type": "application/json", ...await options.getHeaders() },
1210
- body: JSON.stringify({
1211
- mutationId: envelope.id,
1212
- operation: "create",
1213
- collection: "orders",
1214
- recordId: envelope.payload.clientOrderId,
1215
- baseRevision: null,
1216
- payload: mapped.payload
1217
- }),
1218
- signal: controller.signal
1219
- });
1220
- const status = response.status;
1221
- const retryAfter = response.headers.get("Retry-After");
1222
- const seconds = retryAfter === null ? NaN : Number(retryAfter);
1223
- const retry = (reason) => ({
1224
- kind: "retry",
1225
- reason,
1226
- ...Number.isFinite(seconds) && seconds >= 0 ? { retryAfterMs: seconds * 1e3 } : {}
1227
- });
1228
- if (status === 401) outcome = { kind: "unauthorized" };
1229
- else if (![200, 201, 400, 422, 403, 413, 415].includes(status)) outcome = retry(`status_${status}`);
1230
- else {
1231
- let body;
1232
- try {
1233
- body = await response.json();
1234
- } catch {
1334
+ const pushed = await call("push/orders", { method: "POST", body: {
1335
+ mutationId: envelope.id,
1336
+ operation: "create",
1337
+ collection: "orders",
1338
+ recordId: envelope.payload.clientOrderId,
1339
+ baseRevision: null,
1340
+ payload: mapped.payload
1341
+ } });
1342
+ const { status, body } = pushed;
1343
+ if (status === 0) outcome = retry(pushed, "network");
1344
+ else if (status === 401) outcome = { kind: "unauthorized" };
1345
+ else if (status === 426 && body?.code === "wcpos_update_required") outcome = { kind: "refused", status, reason: body?.message ?? body.code };
1346
+ else if (!ledger && status === 422 && body?.code === "wcpos_status_not_pushable" && options.ledgerPayments === void 0) {
1347
+ siteLedger = void 0;
1348
+ outcome = retry(pushed, "ledger_store_detected");
1349
+ } else if (![200, 201, 400, 422, 403, 413, 415].includes(status)) outcome = retry(pushed, `status_${status}`);
1350
+ else if (status === 200 || status === 201) {
1351
+ const doc = body?.document;
1352
+ const totalMinor = wooMinorFromDecimal(String(doc?.total), envelope.payload.currency);
1353
+ let revision = body?.currentRevision;
1354
+ if (doc?.id == null || totalMinor === void 0 || mapped.money && (typeof revision !== "string" || !revision)) {
1355
+ outcome = retry(pushed, pushed.aborted ? "timeout" : "bad_body");
1356
+ } else {
1357
+ const orderId = String(doc.id), displayId = String(doc.number ?? doc.id);
1358
+ if (ledger && totalMinor !== envelope.payload.totalMinor) {
1359
+ const tillMinor = envelope.payload.totalMinor, digits = wooDigits(envelope.payload);
1360
+ results.push({ id: envelope.id, status: "rejected", error: {
1361
+ code: "invalid_payload",
1362
+ message: `WooCommerce order #${displayId} totals ${wooMajor(totalMinor, digits)} but the till charged ${wooMajor(tillMinor, digits)}; no payment was recorded on it.`,
1363
+ data: { orderId, storeCode: "total_mismatch", tillMinor, serverMinor: totalMinor }
1364
+ } });
1365
+ continue;
1366
+ }
1367
+ let failed;
1368
+ let recorded = 0;
1369
+ for (const command of mapped.money ?? []) {
1370
+ const path = `orders/${orderId}/${command.path}`;
1371
+ let answer = await call(path, { method: "POST", body: { ...command.body, revision } });
1372
+ const stale = answer.status === 409 && answer.body?.code === "wcpos_revision_stale" ? answer.body?.data?.currentRevision : void 0;
1373
+ if (typeof stale === "string" && stale) answer = await call(path, { method: "POST", body: { ...command.body, revision: stale } });
1374
+ if (answer.status >= 200 && answer.status < 300 && typeof answer.body?.revision === "string" && answer.body.revision) {
1375
+ revision = answer.body.revision;
1376
+ recorded += 1;
1377
+ continue;
1378
+ }
1379
+ failed = answer;
1380
+ break;
1235
1381
  }
1236
- if (status === 200 || status === 201) {
1237
- const doc = body?.document;
1238
- const totalMinor = wooMinorFromDecimal(String(doc?.total), envelope.payload.currency);
1239
- if (doc?.id == null || totalMinor === void 0) {
1240
- outcome = retry(controller.signal.aborted ? "timeout" : "bad_body");
1241
- } else {
1242
- results.push({ id: envelope.id, status: "applied", serverRefs: {
1243
- orderId: String(doc.id),
1244
- displayId: String(doc.number ?? doc.id),
1245
- totalMinor
1246
- }, ...totalMinor !== envelope.payload.totalMinor ? { warnings: [{
1382
+ const code = failed?.body?.code;
1383
+ const terminal = typeof code === "string" && (code.startsWith("wcpos_") || code === "rest_invalid_param" || code === "rest_forbidden");
1384
+ if (!failed) {
1385
+ results.push({
1386
+ id: envelope.id,
1387
+ status: "applied",
1388
+ serverRefs: { orderId, displayId, totalMinor },
1389
+ ...totalMinor !== envelope.payload.totalMinor ? { warnings: [{
1247
1390
  code: "total_mismatch",
1248
1391
  expectedMinor: envelope.payload.totalMinor,
1249
1392
  serverMinor: totalMinor
1250
- }] } : {} });
1251
- continue;
1252
- }
1253
- } else if (status === 400 && body?.code === "woocommerce_rest_invalid_coupon") {
1254
- const message = decodeCouponMessage(body?.message), quoted = /"([^"]*)"/.exec(message)?.[1];
1255
- const couponCode = envelope.payload.coupons?.find(({ code }) => code.toLowerCase() === quoted?.toLowerCase())?.code;
1256
- results.push({ id: envelope.id, status: "rejected", error: {
1257
- code: "coupon_invalid",
1258
- message,
1259
- data: { storeCode: body.code, ...couponCode ? { couponCode } : {} }
1260
- } });
1393
+ }] } : {}
1394
+ });
1261
1395
  continue;
1262
- } else if (status === 400 || status === 422) {
1396
+ } else if (failed.status === 401) outcome = { kind: "unauthorized" };
1397
+ else if (failed.status === 404 && code === "rest_no_route") {
1398
+ siteLedger = void 0;
1399
+ outcome = retry(failed, "ledger_route_missing");
1400
+ } else if (failed.status < 400 || failed.status >= 500 || failed.status === 409 && ["wcpos_revision_stale", "wcpos_payment_locked", "woo_rxdb_sync_record_locked"].includes(code) || !terminal) {
1401
+ outcome = retry(failed, failed.status >= 200 && failed.status < 300 ? failed.aborted ? "timeout" : "bad_body" : code ?? `status_${failed.status}`);
1402
+ } else {
1263
1403
  results.push({ id: envelope.id, status: "rejected", error: {
1264
- code: status === 400 && body?.code === "wcpos_insufficient_stock" ? "insufficient_stock" : "invalid_payload",
1265
- message: body?.message ?? `status_${status}`
1404
+ code: failed.status === 400 && code === "wcpos_insufficient_stock" ? "insufficient_stock" : "invalid_payload",
1405
+ message: `WooCommerce order #${displayId} was ${recorded === 0 ? "created but not paid" : `created and part paid (${recorded} of ${mapped.money.length} payments recorded)`}: ${failed.body?.message ?? code ?? `status_${failed.status}`}`,
1406
+ data: { orderId, storeCode: code ?? `status_${failed.status}`, ...recorded ? { recorded } : {} }
1266
1407
  } });
1267
1408
  continue;
1268
- } else {
1269
- outcome = { kind: "refused", status, reason: body?.message ?? body?.code ?? `status_${status}` };
1270
1409
  }
1271
1410
  }
1272
- } catch {
1273
- outcome = { kind: "retry", reason: controller.signal.aborted ? "timeout" : "network" };
1274
- } finally {
1275
- clearTimeout(timeout);
1411
+ } else if (status === 400 && body?.code === "woocommerce_rest_invalid_coupon") {
1412
+ const message = decodeCouponMessage(body?.message), quoted = /"([^"]*)"/.exec(message)?.[1];
1413
+ const couponCode = envelope.payload.coupons?.find(({ code }) => code.toLowerCase() === quoted?.toLowerCase())?.code;
1414
+ results.push({ id: envelope.id, status: "rejected", error: {
1415
+ code: "coupon_invalid",
1416
+ message,
1417
+ data: { storeCode: body.code, ...couponCode ? { couponCode } : {} }
1418
+ } });
1419
+ continue;
1420
+ } else if (status === 400 || status === 422) {
1421
+ results.push({ id: envelope.id, status: "rejected", error: {
1422
+ code: status === 400 && body?.code === "wcpos_insufficient_stock" ? "insufficient_stock" : "invalid_payload",
1423
+ message: body?.message ?? `status_${status}`
1424
+ } });
1425
+ continue;
1426
+ } else {
1427
+ outcome = { kind: "refused", status, reason: body?.message ?? body?.code ?? `status_${status}` };
1276
1428
  }
1277
1429
  return results.length ? { kind: "results", results } : outcome;
1278
1430
  }
@@ -1310,10 +1462,45 @@ function decimalSumMinor(a, b, currency) {
1310
1462
  }
1311
1463
  var grossTax = (net, tax, currency) => decimalSumMinor(net, tax, currency) - minor(net, currency);
1312
1464
  function posUuid(metaData) {
1313
- const entry = rows(metaData).find((meta) => meta.key === "_woocommerce_pos_uuid" && nonEmpty(meta.value));
1465
+ const entry = rows(metaData).find((meta) => meta.key === WCPOS_UUID_META_KEY && nonEmpty(meta.value));
1314
1466
  return entry ? entry.value : void 0;
1315
1467
  }
1316
1468
  var PAYMENT_KINDS = { pos_cash: "cash", pos_card: "external" };
1469
+ function paymentLedger(metaData) {
1470
+ const entry = rows(metaData).find((meta) => meta.key === "_wcpos_payments");
1471
+ if (!entry) return { present: false, payments: null };
1472
+ const value = entry.value;
1473
+ return { present: true, payments: isRow(value) && value.schema === 1 && Array.isArray(value.payments) ? value.payments : null };
1474
+ }
1475
+ function storePayments(raw, currency, totalMinor) {
1476
+ const { payments } = paymentLedger(raw.meta_data);
1477
+ const captured = payments ? rows(payments).filter((row) => row.status === "captured") : [];
1478
+ if (captured.length) {
1479
+ const title2 = captured.every((row) => row.method_id === raw.payment_method) ? nonEmpty(raw.payment_method_title) : void 0;
1480
+ return captured.map((row) => {
1481
+ const method2 = nonEmpty(row.method_id);
1482
+ if (!method2 || typeof row.currency === "string" && row.currency !== currency) throw unexpected();
1483
+ const kind2 = PAYMENT_KINDS[method2];
1484
+ const id = nonEmpty(row.id);
1485
+ return {
1486
+ ...id ? { id } : {},
1487
+ method: method2,
1488
+ ...title2 ? { title: title2 } : {},
1489
+ ...kind2 ? { kind: kind2 } : {},
1490
+ amountMinor: minor(row.amount, currency)
1491
+ };
1492
+ });
1493
+ }
1494
+ const method = nonEmpty(raw.payment_method);
1495
+ const title = nonEmpty(raw.payment_method_title);
1496
+ const kind = method ? PAYMENT_KINDS[method] : void 0;
1497
+ return method && (nonEmpty(raw.date_paid_gmt) || nonEmpty(raw.date_paid)) ? [{
1498
+ method,
1499
+ ...title ? { title } : {},
1500
+ ...kind ? { kind } : {},
1501
+ amountMinor: totalMinor
1502
+ }] : [];
1503
+ }
1317
1504
  function toWooStoreOrder(raw) {
1318
1505
  if (!isRow(raw) || raw.id === void 0 || raw.id === null || typeof raw.currency !== "string" || typeof raw.date_created_gmt !== "string") {
1319
1506
  throw unexpected();
@@ -1328,14 +1515,15 @@ function toWooStoreOrder(raw) {
1328
1515
  const email = nonEmpty(billing.email);
1329
1516
  const customer = customerId || name || email ? { ...customerId ? { id: customerId } : {}, ...name ? { name } : {}, ...email ? { email } : {} } : null;
1330
1517
  const clientOrderId = posUuid(raw.meta_data);
1518
+ const revision = nonEmpty(raw._rxdb_revision);
1331
1519
  const totalMinor = minor(raw.total, currency);
1332
- const paymentMethod = nonEmpty(raw.payment_method);
1333
- const paymentTitle = nonEmpty(raw.payment_method_title);
1334
- const paymentKind = paymentMethod ? PAYMENT_KINDS[paymentMethod] : void 0;
1520
+ const ledger = paymentLedger(raw.meta_data);
1521
+ const paymentRecordUnreadable = ledger.present && ledger.payments === null;
1335
1522
  return {
1336
1523
  id: String(raw.id),
1337
1524
  reference: String(raw.number ?? raw.id),
1338
1525
  ...clientOrderId ? { clientOrderId } : {},
1526
+ ...revision ? { revision } : {},
1339
1527
  status: String(raw.status),
1340
1528
  placedAt: placed.toISOString(),
1341
1529
  currency,
@@ -1361,11 +1549,17 @@ function toWooStoreOrder(raw) {
1361
1549
  };
1362
1550
  }),
1363
1551
  fees: rows(raw.fee_lines).map((fee) => ({
1552
+ ...positiveId(fee.id) ? { id: positiveId(fee.id) } : {},
1553
+ ...fee.tax_status === "taxable" || fee.tax_status === "none" ? { taxStatus: fee.tax_status } : {},
1554
+ ...nonEmpty(fee.tax_class) ? { taxClass: nonEmpty(fee.tax_class) } : {},
1364
1555
  name: String(fee.name),
1365
1556
  totalMinor: minor(fee.total, currency),
1366
1557
  taxMinor: grossTax(fee.total, fee.total_tax, currency)
1367
1558
  })),
1368
1559
  shipping: rows(raw.shipping_lines).map((line) => ({
1560
+ ...positiveId(line.id) ? { id: positiveId(line.id) } : {},
1561
+ ...line.tax_status === "taxable" || line.tax_status === "none" ? { taxStatus: line.tax_status } : {},
1562
+ ...nonEmpty(line.method_id) ? { methodId: nonEmpty(line.method_id) } : {},
1369
1563
  name: String(line.method_title),
1370
1564
  totalMinor: minor(line.total, currency),
1371
1565
  taxMinor: grossTax(line.total, line.total_tax, currency)
@@ -1388,12 +1582,8 @@ function toWooStoreOrder(raw) {
1388
1582
  discountTaxMinor: minor(raw.discount_tax, currency),
1389
1583
  taxMinor: minor(raw.total_tax, currency),
1390
1584
  totalMinor,
1391
- payments: paymentMethod ? [{
1392
- method: paymentMethod,
1393
- ...paymentTitle ? { title: paymentTitle } : {},
1394
- ...paymentKind ? { kind: paymentKind } : {},
1395
- amountMinor: totalMinor
1396
- }] : [],
1585
+ payments: storePayments(raw, currency, totalMinor),
1586
+ ...paymentRecordUnreadable ? { paymentRecordUnreadable: true } : {},
1397
1587
  refunds: rows(raw.refunds).map((refund) => {
1398
1588
  const reason = nonEmpty(refund.reason);
1399
1589
  return { id: String(refund.id), amountMinor: Math.abs(minor(refund.total, currency)), ...reason ? { reason } : {} };
@@ -1434,11 +1624,20 @@ function createWooOrders() {
1434
1624
  if (before !== void 0) params.set("before", wooGmtSecond(before, 0));
1435
1625
  const { body, headers } = await customerRequest(context, `orders?${params}`, { method: "GET" });
1436
1626
  if (!Array.isArray(body)) throw unexpected();
1437
- const orders = body.map(toWooStoreOrder);
1627
+ let unreadable = 0;
1628
+ const orders = body.flatMap((row) => {
1629
+ try {
1630
+ return [toWooStoreOrder(row)];
1631
+ } catch (error) {
1632
+ if (!(error instanceof CustomerServiceError2)) throw error;
1633
+ unreadable += 1;
1634
+ return [];
1635
+ }
1636
+ });
1438
1637
  const totalPages = headers.get("X-WP-TotalPages");
1439
- const hasMore = totalPages !== null && /^\d+$/.test(totalPages.trim()) ? page < Number.parseInt(totalPages, 10) : orders.length === perPage;
1638
+ const hasMore = totalPages !== null && /^\d+$/.test(totalPages.trim()) ? page < Number.parseInt(totalPages, 10) : body.length === perPage;
1440
1639
  const total = headers.get("X-WP-Total");
1441
- return { orders, hasMore, ...total && /^\d+$/.test(total) ? { total: Number(total) } : {} };
1640
+ return { orders, hasMore, ...unreadable ? { unreadable } : {}, ...total && /^\d+$/.test(total) ? { total: Number(total) } : {} };
1442
1641
  },
1443
1642
  async getOrders(context, ids) {
1444
1643
  const wanted = [...new Set(ids.filter((id) => /^[1-9]\d*$/.test(id)))];
@@ -1455,43 +1654,236 @@ function createWooOrders() {
1455
1654
  }
1456
1655
 
1457
1656
  // src/store-settings.ts
1458
- import { ConnectorUnauthorizedError as ConnectorUnauthorizedError2, StoreSettingsError, minorUnitDigits as minorUnitDigits3, woocommerceTax } from "@tallyui/core";
1657
+ import { ConnectorUnauthorizedError as ConnectorUnauthorizedError3, StoreSettingsError, minorUnitDigits as minorUnitDigits3, woocommerceTax as woocommerceTax2 } from "@tallyui/core";
1658
+
1659
+ // src/currency-symbols.ts
1660
+ var WOO_CURRENCY_SYMBOLS = {
1661
+ AED: "\u062F.\u0625",
1662
+ AFN: "\u060B",
1663
+ ALL: "L",
1664
+ AMD: "AMD",
1665
+ ANG: "\u0192",
1666
+ AOA: "Kz",
1667
+ ARS: "$",
1668
+ AUD: "$",
1669
+ AWG: "Afl.",
1670
+ AZN: "\u20BC",
1671
+ BAM: "KM",
1672
+ BBD: "$",
1673
+ BDT: "\u09F3\xA0",
1674
+ BGN: "\u043B\u0432.",
1675
+ BHD: ".\u062F.\u0628",
1676
+ BIF: "Fr",
1677
+ BMD: "$",
1678
+ BND: "$",
1679
+ BOB: "Bs.",
1680
+ BRL: "R$",
1681
+ BSD: "$",
1682
+ BTC: "\u0E3F",
1683
+ BTN: "Nu.",
1684
+ BWP: "P",
1685
+ BYN: "Br",
1686
+ BYR: "Br",
1687
+ BZD: "$",
1688
+ CAD: "$",
1689
+ CDF: "Fr",
1690
+ CHF: "CHF",
1691
+ CLP: "$",
1692
+ CNY: "\xA5",
1693
+ COP: "$",
1694
+ CRC: "\u20A1",
1695
+ CUC: "$",
1696
+ CUP: "$",
1697
+ CVE: "$",
1698
+ CZK: "K\u010D",
1699
+ DJF: "Fr",
1700
+ DKK: "kr.",
1701
+ DOP: "RD$",
1702
+ DZD: "\u062F.\u062C",
1703
+ EGP: "EGP",
1704
+ ERN: "Nfk",
1705
+ ETB: "Br",
1706
+ EUR: "\u20AC",
1707
+ FJD: "$",
1708
+ FKP: "\xA3",
1709
+ GBP: "\xA3",
1710
+ GEL: "\u20BE",
1711
+ GGP: "\xA3",
1712
+ GHS: "\u20B5",
1713
+ GIP: "\xA3",
1714
+ GMD: "D",
1715
+ GNF: "Fr",
1716
+ GTQ: "Q",
1717
+ GYD: "$",
1718
+ HKD: "$",
1719
+ HNL: "L",
1720
+ HRK: "kn",
1721
+ HTG: "G",
1722
+ HUF: "Ft",
1723
+ IDR: "Rp",
1724
+ ILS: "\u20AA",
1725
+ IMP: "\xA3",
1726
+ INR: "\u20B9",
1727
+ IQD: "\u062F.\u0639",
1728
+ IRR: "\uFDFC",
1729
+ IRT: "\u062A\u0648\u0645\u0627\u0646",
1730
+ ISK: "kr.",
1731
+ JEP: "\xA3",
1732
+ JMD: "$",
1733
+ JOD: "\u062F.\u0627",
1734
+ JPY: "\xA5",
1735
+ KES: "KSh",
1736
+ KGS: "\u0441\u043E\u043C",
1737
+ KHR: "\u17DB",
1738
+ KMF: "Fr",
1739
+ KPW: "\u20A9",
1740
+ KRW: "\u20A9",
1741
+ KWD: "\u062F.\u0643",
1742
+ KYD: "$",
1743
+ KZT: "\u20B8",
1744
+ LAK: "\u20AD",
1745
+ LBP: "\u0644.\u0644",
1746
+ LKR: "\u0DBB\u0DD4",
1747
+ LRD: "$",
1748
+ LSL: "L",
1749
+ LYD: "\u062F.\u0644",
1750
+ MAD: "\u062F.\u0645.",
1751
+ MDL: "MDL",
1752
+ MGA: "Ar",
1753
+ MKD: "\u0434\u0435\u043D",
1754
+ MMK: "Ks",
1755
+ MNT: "\u20AE",
1756
+ MOP: "P",
1757
+ MRU: "UM",
1758
+ MUR: "\u20A8",
1759
+ MVR: ".\u0783",
1760
+ MWK: "MK",
1761
+ MXN: "$",
1762
+ MYR: "RM",
1763
+ MZN: "MT",
1764
+ NAD: "N$",
1765
+ NGN: "\u20A6",
1766
+ NIO: "C$",
1767
+ NOK: "kr",
1768
+ NPR: "\u20A8",
1769
+ NZD: "$",
1770
+ OMR: "\u0631.\u0639.",
1771
+ PAB: "B/.",
1772
+ PEN: "S/",
1773
+ PGK: "K",
1774
+ PHP: "\u20B1",
1775
+ PKR: "\u20A8",
1776
+ PLN: "z\u0142",
1777
+ PRB: "\u0440.",
1778
+ PYG: "\u20B2",
1779
+ QAR: "\u0631.\u0642",
1780
+ RON: "lei",
1781
+ RSD: "\u0440\u0441\u0434",
1782
+ RUB: "\u20BD",
1783
+ RWF: "Fr",
1784
+ SAR: "\u0631.\u0633",
1785
+ SBD: "$",
1786
+ SCR: "\u20A8",
1787
+ SDG: "\u062C.\u0633.",
1788
+ SEK: "kr",
1789
+ SGD: "$",
1790
+ SHP: "\xA3",
1791
+ SLL: "Le",
1792
+ SOS: "Sh",
1793
+ SRD: "$",
1794
+ SSP: "\xA3",
1795
+ STN: "Db",
1796
+ SYP: "\u0644.\u0633",
1797
+ SZL: "E",
1798
+ THB: "\u0E3F",
1799
+ TJS: "\u0405\u041C",
1800
+ TMT: "m",
1801
+ TND: "\u062F.\u062A",
1802
+ TOP: "T$",
1803
+ TRY: "\u20BA",
1804
+ TTD: "$",
1805
+ TWD: "NT$",
1806
+ TZS: "Sh",
1807
+ UAH: "\u20B4",
1808
+ UGX: "UGX",
1809
+ USD: "$",
1810
+ UYU: "$",
1811
+ UZS: "UZS",
1812
+ VEF: "Bs F",
1813
+ VES: "Bs.S",
1814
+ VND: "\u20AB",
1815
+ VUV: "Vt",
1816
+ WST: "T",
1817
+ XAF: "CFA",
1818
+ XCD: "$",
1819
+ XOF: "CFA",
1820
+ XPF: "Fr",
1821
+ YER: "\uFDFC",
1822
+ ZAR: "R",
1823
+ ZMW: "ZK"
1824
+ };
1825
+
1826
+ // src/unauthorized.ts
1827
+ import { ConnectorUnauthorizedError as ConnectorUnauthorizedError2 } from "@tallyui/core";
1828
+ function throwIfUnauthorized(response, what) {
1829
+ if (response?.status === 401 || response?.status === 403) {
1830
+ throw new ConnectorUnauthorizedError2(`WooCommerce ${what}: HTTP ${response.status}`, response.status);
1831
+ }
1832
+ }
1833
+
1834
+ // src/store-settings.ts
1459
1835
  var WOO_ORDER_CREATE_VERSION = 5;
1460
1836
  var WOO_NOTE_ORDER_CREATE_VERSION = 7;
1461
1837
  var WOO_TAX_ADDRESS_ORDER_CREATE_VERSION = 8;
1462
1838
  var WOO_BASE_ORDER_CREATE_VERSION = 3;
1463
1839
  var WOO_COUPONS_MIN_PLUGIN = [1, 9, 0];
1464
- function wooPluginSupportsCoupons(version2) {
1840
+ var WOO_ORDER_LINES_FLOOR = [1, 10, 20];
1841
+ var WOO_ORDER_LINES_VERSION_CAP = 7;
1842
+ var WOO_ORDER_LINES_20_FLOOR = [2, 0, 4];
1843
+ var WOO_ORDER_LINES_20_CAP = 6;
1844
+ function atLeast(version2, floor) {
1465
1845
  if (typeof version2 !== "string") return false;
1466
1846
  const match = /^(\d+)\.(\d+)(?:\.(\d+))?(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$/.exec(version2.trim());
1467
1847
  if (!match) return false;
1468
1848
  const parts = [Number(match[1]), Number(match[2]), Number(match[3] ?? 0)];
1469
1849
  for (let index = 0; index < parts.length; index++) {
1470
- if (parts[index] > WOO_COUPONS_MIN_PLUGIN[index]) return true;
1471
- if (parts[index] < WOO_COUPONS_MIN_PLUGIN[index]) return false;
1850
+ if (parts[index] > floor[index]) return true;
1851
+ if (parts[index] < floor[index]) return false;
1472
1852
  }
1473
1853
  return !match[4];
1474
1854
  }
1855
+ function wooPluginSupportsCoupons(version2) {
1856
+ return atLeast(version2, WOO_COUPONS_MIN_PLUGIN);
1857
+ }
1858
+ function wooOnOrderLinesLine(version2) {
1859
+ return typeof version2 === "string" && /^1\.10\.\d+$/.test(version2.trim()) && atLeast(version2, WOO_ORDER_LINES_FLOOR);
1860
+ }
1861
+ function wooOnOrderLines20Line(version2) {
1862
+ return typeof version2 === "string" && /^2\.0\.\d+$/.test(version2.trim()) && atLeast(version2, WOO_ORDER_LINES_20_FLOOR);
1863
+ }
1475
1864
  async function wooStoreSettings(context) {
1476
1865
  try {
1477
1866
  const init = { method: "GET", headers: context.headers, signal: context.signal };
1478
1867
  const storesResponse = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/stores`, init);
1479
- if (storesResponse.status === 401 || storesResponse.status === 403) {
1480
- throw new ConnectorUnauthorizedError2(`WooCommerce stores: HTTP ${storesResponse.status}`, storesResponse.status);
1481
- }
1868
+ throwIfUnauthorized(storesResponse, "stores");
1482
1869
  if (!storesResponse.ok) throw new Error(`WooCommerce stores: HTTP ${storesResponse.status}`);
1483
1870
  const stores = await storesResponse.json();
1484
1871
  if (!Array.isArray(stores) || stores.length === 0) throw new Error("WooCommerce stores: expected a non-empty array");
1485
1872
  const store = stores[0];
1486
1873
  const currency = store.currency.toUpperCase();
1874
+ const moneyFormat = {
1875
+ ...["left", "right", "left_space", "right_space"].includes(store.currency_pos) ? { position: store.currency_pos } : {},
1876
+ ...typeof store.price_thousand_sep === "string" ? { thousandSeparator: store.price_thousand_sep } : {},
1877
+ ...typeof store.price_decimal_sep === "string" ? { decimalSeparator: store.price_decimal_sep } : {},
1878
+ ...Number.isInteger(store.price_num_decimals) && store.price_num_decimals >= 0 ? { decimals: store.price_num_decimals } : {},
1879
+ ...WOO_CURRENCY_SYMBOLS[currency] !== void 0 ? { symbol: WOO_CURRENCY_SYMBOLS[currency] } : {}
1880
+ };
1487
1881
  const digits = minorUnitDigits3(currency);
1488
1882
  if (typeof store.price_num_decimals === "number" && store.price_num_decimals !== digits) {
1489
1883
  console.warn(`WooCommerce price_num_decimals is ${store.price_num_decimals}; the till rounds ${currency} to ${digits} digits`);
1490
1884
  }
1491
1885
  const classesResponse = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/taxes/classes`, init);
1492
- if (classesResponse.status === 401 || classesResponse.status === 403) {
1493
- throw new ConnectorUnauthorizedError2(`WooCommerce tax classes: HTTP ${classesResponse.status}`, classesResponse.status);
1494
- }
1886
+ throwIfUnauthorized(classesResponse, "tax classes");
1495
1887
  if (!classesResponse.ok) throw new Error(`WooCommerce tax classes: HTTP ${classesResponse.status}`);
1496
1888
  const classes = await classesResponse.json();
1497
1889
  if (!Array.isArray(classes)) throw new Error("WooCommerce tax classes: expected an array");
@@ -1502,6 +1894,8 @@ async function wooStoreSettings(context) {
1502
1894
  pricesIncludeTax: store.prices_include_tax === "yes",
1503
1895
  taxRoundAtSubtotal: store.tax_round_at_subtotal === "yes",
1504
1896
  calcDiscountsSequentially: (store.woocommerce_calc_discounts_sequentially ?? store.calc_discounts_sequentially) === "yes",
1897
+ preventOverselling: store.prevent_overselling === true,
1898
+ ...Object.keys(moneyFormat).length > 0 ? { moneyFormat } : {},
1505
1899
  ...typeof store.shipping_tax_class === "string" ? { shippingTaxClass: store.shipping_tax_class } : {},
1506
1900
  taxClassSlugs: classes.map((row) => row.slug),
1507
1901
  taxClasses: classes.map((row) => ({ slug: row.slug, name: typeof row.name === "string" && row.name !== "" ? row.name : row.slug })),
@@ -1509,13 +1903,11 @@ async function wooStoreSettings(context) {
1509
1903
  taxRatesPpm
1510
1904
  };
1511
1905
  if (store.calc_taxes !== "yes") return settings;
1512
- settings.taxBasedOn = woocommerceTax.normalizeTaxBasedOn(store.tax_based_on);
1906
+ settings.taxBasedOn = woocommerceTax2.normalizeTaxBasedOn(store.tax_based_on);
1513
1907
  const rates = [];
1514
1908
  for (let page = 1; page <= 100; page++) {
1515
1909
  const response = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/taxes?per_page=100&page=${page}&orderby=order&order=asc`, init);
1516
- if (response.status === 401 || response.status === 403) {
1517
- throw new ConnectorUnauthorizedError2(`WooCommerce taxes: HTTP ${response.status}`, response.status);
1518
- }
1910
+ throwIfUnauthorized(response, "taxes");
1519
1911
  if (!response.ok) throw new Error(`WooCommerce taxes: HTTP ${response.status}`);
1520
1912
  const rows2 = await response.json();
1521
1913
  if (!Array.isArray(rows2)) throw new Error("WooCommerce taxes: expected an array");
@@ -1536,7 +1928,7 @@ async function wooStoreSettings(context) {
1536
1928
  ...rate.postcodes.length > 0 ? { postcodes: rate.postcodes } : {},
1537
1929
  ...rate.cities.length > 0 ? { cities: rate.cities } : {}
1538
1930
  },
1539
- taxClass: woocommerceTax.normalizeTaxClass(rate.class),
1931
+ taxClass: woocommerceTax2.normalizeTaxClass(rate.class),
1540
1932
  priority: rate.priority,
1541
1933
  compound: rate.compound,
1542
1934
  shipping: rate.shipping
@@ -1551,9 +1943,9 @@ async function wooStoreSettings(context) {
1551
1943
  const baseTaxAddress = { country: text(address.country), state: text(address.state), city: text(address.city), postcode: text(address.postcode) };
1552
1944
  if (baseTaxAddress.country) settings.baseTaxAddress = baseTaxAddress;
1553
1945
  if (baseTaxAddress.country) settings.taxRateTable = rates;
1554
- const matched = woocommerceTax.filterTaxRates(rates, address.country, address.state, address.postcode, address.city);
1946
+ const matched = woocommerceTax2.filterTaxRates(rates, address.country, address.state, address.postcode, address.city);
1555
1947
  for (const rate of matched) {
1556
- const slug = woocommerceTax.normalizeTaxClass(rate.class);
1948
+ const slug = woocommerceTax2.normalizeTaxClass(rate.class);
1557
1949
  (taxRates[slug] ??= []).push({
1558
1950
  id: rate.id,
1559
1951
  code: [rate.country, rate.state, rate.name || "TAX", String(rate.priority)].filter(Boolean).join("-").toUpperCase(),
@@ -1568,10 +1960,17 @@ async function wooStoreSettings(context) {
1568
1960
  }
1569
1961
  return settings;
1570
1962
  } catch (error) {
1571
- if (error instanceof ConnectorUnauthorizedError2) throw error;
1963
+ if (error instanceof ConnectorUnauthorizedError3) throw error;
1572
1964
  throw new StoreSettingsError("failed", error instanceof Error ? error.message : String(error));
1573
1965
  }
1574
1966
  }
1967
+ function wooThresholdMinor(value, currency) {
1968
+ if (typeof value !== "string" || typeof currency !== "string" || !/^\d+(\.\d+)?$/.test(value)) return void 0;
1969
+ const digits = minorUnitDigits3(currency);
1970
+ const [whole, fraction = ""] = value.split(".");
1971
+ const minor2 = Number(whole + fraction.slice(0, digits).padEnd(digits, "0"));
1972
+ return Number.isSafeInteger(minor2) ? minor2 : void 0;
1973
+ }
1575
1974
  async function readWooCapabilities(context) {
1576
1975
  try {
1577
1976
  const response = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/stores`, {
@@ -1579,32 +1978,31 @@ async function readWooCapabilities(context) {
1579
1978
  headers: context.headers,
1580
1979
  signal: context.signal
1581
1980
  });
1582
- if (response.status === 401 || response.status === 403) {
1583
- throw new ConnectorUnauthorizedError2(`WooCommerce stores: HTTP ${response.status}`, response.status);
1584
- }
1981
+ throwIfUnauthorized(response, "stores");
1585
1982
  if (!response.ok) return void 0;
1586
1983
  const stores = await response.json();
1587
1984
  if (!Array.isArray(stores) || !stores[0] || typeof stores[0] !== "object" || Array.isArray(stores[0])) return void 0;
1588
1985
  let multiplePayments = false;
1589
1986
  let capabilities = [];
1987
+ let flagged;
1590
1988
  try {
1591
1989
  const status = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/status`, {
1592
1990
  method: "GET",
1593
1991
  headers: context.headers,
1594
1992
  signal: context.signal
1595
1993
  });
1596
- if (status.status === 401 || status.status === 403) {
1597
- throw new ConnectorUnauthorizedError2(`WooCommerce status: HTTP ${status.status}`, status.status);
1598
- }
1994
+ throwIfUnauthorized(status, "status");
1599
1995
  if (status.ok) {
1600
1996
  const body = await status.json();
1601
- capabilities = Array.isArray(body?.capabilities) ? body.capabilities : [];
1997
+ flagged = Array.isArray(body?.capabilities);
1998
+ capabilities = flagged ? body.capabilities : [];
1602
1999
  multiplePayments = capabilities.includes("order_payments_list");
1603
2000
  }
1604
2001
  } catch (error) {
1605
- if (error instanceof ConnectorUnauthorizedError2) throw error;
2002
+ if (error instanceof ConnectorUnauthorizedError3) throw error;
1606
2003
  }
1607
2004
  let coupons = false;
2005
+ let wcposVersion;
1608
2006
  try {
1609
2007
  const site = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/site`, {
1610
2008
  method: "GET",
@@ -1613,28 +2011,432 @@ async function readWooCapabilities(context) {
1613
2011
  });
1614
2012
  if (site.ok) {
1615
2013
  const body = await site.json();
1616
- coupons = wooPluginSupportsCoupons(body?.wcpos_version);
2014
+ wcposVersion = body?.wcpos_version;
2015
+ coupons = wooPluginSupportsCoupons(wcposVersion);
1617
2016
  }
1618
2017
  } catch {
1619
2018
  coupons = false;
1620
2019
  }
1621
- const orderCreate = capabilities.includes("order_create_v5") ? coupons ? WOO_TAX_ADDRESS_ORDER_CREATE_VERSION : WOO_ORDER_CREATE_VERSION : WOO_BASE_ORDER_CREATE_VERSION;
2020
+ const linesVersion = coupons ? WOO_TAX_ADDRESS_ORDER_CREATE_VERSION : WOO_ORDER_CREATE_VERSION;
2021
+ const orderCreate = flagged === void 0 ? WOO_BASE_ORDER_CREATE_VERSION : capabilities.includes("order_create_v5") ? linesVersion : wooOnOrderLines20Line(wcposVersion) ? Math.min(WOO_ORDER_LINES_20_CAP, linesVersion) : !flagged && wooOnOrderLinesLine(wcposVersion) ? Math.min(WOO_ORDER_LINES_VERSION_CAP, linesVersion) : WOO_BASE_ORDER_CREATE_VERSION;
2022
+ const thresholdMinor = wooThresholdMinor(stores[0].variance_threshold, stores[0].currency);
1622
2023
  return {
1623
2024
  orderCreate,
1624
2025
  taxRounding: { granularity: "woocommerce", roundAtSubtotal: stores[0].tax_round_at_subtotal === "yes" },
1625
2026
  multiplePayments,
1626
2027
  coupons,
1627
2028
  // WCPOS v5 takes a fee's, shipping line's and custom line's tax_status and tax_class (orders #146, #161); it has no /tally/v1/info.
1628
- lineTax: { none: true, classes: true }
2029
+ lineTax: { none: true, classes: true },
2030
+ ...thresholdMinor !== void 0 ? { registerApproval: { thresholdMinor } } : {},
2031
+ // WCPOS 2.0's per-store register_sessions setting: the register transport sends to sessions, movements and closures.
2032
+ ...stores[0].register_sessions === true ? { register: 3 } : {}
1629
2033
  };
1630
2034
  } catch (error) {
1631
- if (error instanceof ConnectorUnauthorizedError2) throw error;
2035
+ if (error instanceof ConnectorUnauthorizedError3) throw error;
1632
2036
  return void 0;
1633
2037
  }
1634
2038
  }
1635
2039
 
2040
+ // src/registers.ts
2041
+ async function wooFirstStore(context) {
2042
+ const init = { method: "GET", headers: context.headers, signal: context.signal };
2043
+ const storesResponse = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/stores`, init);
2044
+ throwIfUnauthorized(storesResponse, "stores");
2045
+ if (!storesResponse.ok) throw new Error(`WooCommerce stores: HTTP ${storesResponse.status}`);
2046
+ const stores = await storesResponse.json();
2047
+ if (!Array.isArray(stores) || stores.length === 0) throw new Error("WooCommerce stores: expected a non-empty array");
2048
+ const store = stores[0];
2049
+ if (typeof store?.currency !== "string") throw new Error("WooCommerce stores: expected a currency");
2050
+ return { currency: store.currency.toUpperCase(), store };
2051
+ }
2052
+ async function wooStoreCurrency(context) {
2053
+ return (await wooFirstStore(context)).currency;
2054
+ }
2055
+ async function wooListRegisters(context) {
2056
+ const init = { method: "GET", headers: context.headers, signal: context.signal };
2057
+ const response = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/registers`, init);
2058
+ throwIfUnauthorized(response, "registers");
2059
+ if (response.status === 404) return [];
2060
+ if (!response.ok) throw new Error(`WooCommerce registers: HTTP ${response.status}`);
2061
+ const { currency, store } = await wooFirstStore(context);
2062
+ const closeTime = typeof store.expected_close_time === "string" && /^\d{2}:\d{2}$/.test(store.expected_close_time) ? store.expected_close_time : void 0;
2063
+ const rows2 = await response.json();
2064
+ if (!Array.isArray(rows2)) throw new Error("WooCommerce registers: expected an array");
2065
+ const registers = [];
2066
+ for (const row of rows2) {
2067
+ if (typeof row?.id !== "string" || row.id === "" || typeof row.name !== "string" || row.name === "") {
2068
+ console.warn("WooCommerce registers: skipping a register without an id or name");
2069
+ continue;
2070
+ }
2071
+ const float = typeof row.default_float === "string" ? wooMinorFromDecimal(row.default_float, currency) : void 0;
2072
+ registers.push({
2073
+ id: row.id,
2074
+ name: row.name,
2075
+ ...float !== void 0 ? { defaultFloatMinor: float } : {},
2076
+ ...closeTime !== void 0 ? { expectedCloseTime: closeTime } : {}
2077
+ });
2078
+ }
2079
+ return registers;
2080
+ }
2081
+
2082
+ // src/closures.ts
2083
+ import { ConnectorUnauthorizedError as ConnectorUnauthorizedError4, minorUnitDigits as minorUnitDigits5 } from "@tallyui/core";
2084
+
2085
+ // src/commands/register-transport.ts
2086
+ import {
2087
+ minorUnitDigits as minorUnitDigits4
2088
+ } from "@tallyui/core";
2089
+ var TENDER_KEY = /^[a-zA-Z0-9_-]{1,191}$/;
2090
+ function wooDecimal(minor2, digits) {
2091
+ const text = String(Math.abs(minor2)).padStart(digits + 1, "0");
2092
+ return `${minor2 < 0 ? "-" : ""}${digits ? `${text.slice(0, -digits)}.${text.slice(-digits)}` : text}`;
2093
+ }
2094
+ function wooSignedMinor(value, currency) {
2095
+ if (typeof value !== "string") return void 0;
2096
+ const text = value.trim();
2097
+ if (!text.startsWith("-")) return wooMinorFromDecimal(text, currency);
2098
+ const minor2 = wooMinorFromDecimal(text.slice(1), currency);
2099
+ return minor2 === void 0 ? void 0 : 0 - minor2;
2100
+ }
2101
+ function wooTenders(map, digits) {
2102
+ return Object.fromEntries(Object.entries({ cash: 0, ...map }).map(([key, minor2]) => [key, wooDecimal(minor2, digits)]));
2103
+ }
2104
+ function rejected(id, code, message, data) {
2105
+ return { id, status: "rejected", error: { code, message: typeof message === "string" && message ? message : code, ...data ? { data } : {} } };
2106
+ }
2107
+ function storeCode(answer) {
2108
+ return typeof answer.body?.code === "string" ? { storeCode: answer.body.code } : void 0;
2109
+ }
2110
+ function sessionResult(id, status) {
2111
+ const known = status === "open" || status === "counting" || status === "closed";
2112
+ return { session: { id: String(id), ...known ? { status } : {} } };
2113
+ }
2114
+ function createWooRegisterTransport(options) {
2115
+ const { call, retry } = createWooCall(options);
2116
+ const post = (path, body) => call(path, { method: "POST", body });
2117
+ const shared = (answer, id) => {
2118
+ const { status, body } = answer;
2119
+ if (status === 0) return retry(answer, "network");
2120
+ if (status === 401 || status === 403 && body?.code === "rest_forbidden") return { kind: "unauthorized" };
2121
+ if (status === 426) return { kind: "refused", status, reason: typeof body?.code === "string" ? body.code : "update_required" };
2122
+ if (status === 400) return rejected(id, "invalid_payload", body?.message, storeCode(answer));
2123
+ return void 0;
2124
+ };
2125
+ const sendOne = async (envelope, currency) => {
2126
+ const id = envelope.id, digits = minorUnitDigits4(currency);
2127
+ const decimal = (minor2) => wooDecimal(minor2, digits);
2128
+ const answered = (answer, own) => shared(answer, id) ?? own(answer) ?? retry(answer, `status_${answer.status}`);
2129
+ switch (envelope.type) {
2130
+ case "register.session.open": {
2131
+ const p = envelope.payload;
2132
+ return answered(await post("sessions", {
2133
+ id: p.sessionId,
2134
+ register_id: p.registerId,
2135
+ opened_at: p.openedAt,
2136
+ counted_float: decimal(p.countedFloatMinor),
2137
+ ...typeof p.expectedFloatMinor === "number" ? { expected_float: decimal(p.expectedFloatMinor) } : {},
2138
+ ...typeof p.businessDay === "string" && p.businessDay ? { business_day: p.businessDay } : {}
2139
+ }), (answer) => {
2140
+ const { status, body } = answer;
2141
+ if (status === 201 || status === 200) return { id, status: "applied", register: sessionResult(body?.id, body?.status) };
2142
+ if (status === 409 && body?.code === "wcpos_session_already_open") {
2143
+ return rejected(
2144
+ id,
2145
+ "register_session_already_open",
2146
+ body?.message,
2147
+ { sessionId: typeof body?.data?.session_id === "string" ? body.data.session_id : p.sessionId }
2148
+ );
2149
+ }
2150
+ if (status === 409) return rejected(id, "register_session_open_refused", body?.message, storeCode(answer));
2151
+ return void 0;
2152
+ });
2153
+ }
2154
+ case "register.session.transition": {
2155
+ const p = envelope.payload;
2156
+ if (p.status === "closed") return { id, status: "applied" };
2157
+ return answered(await post(`sessions/${p.sessionId}/status`, { status: p.status, at: p.at }), (answer) => {
2158
+ if (answer.status === 200) return { id, status: "applied", register: sessionResult(answer.body?.id, answer.body?.status) };
2159
+ if (answer.status === 409) return rejected(id, "register_session_transition_refused", answer.body?.message, storeCode(answer));
2160
+ if (answer.status === 404) return rejected(id, "register_session_unknown", answer.body?.message);
2161
+ return void 0;
2162
+ });
2163
+ }
2164
+ case "register.movement.record":
2165
+ case "register.movement.void": {
2166
+ let body;
2167
+ if (envelope.type === "register.movement.record") {
2168
+ const p = envelope.payload;
2169
+ if (!Number.isSafeInteger(p.amountMinor) || p.amountMinor < 0) {
2170
+ return rejected(id, "invalid_payload", "A cash movement amount must be a whole number of minor units, 0 or more.");
2171
+ }
2172
+ body = { id: p.movementId, session_id: p.sessionId, type: p.type, amount: decimal(p.amountMinor), reason: p.reason, created_at: p.createdAt };
2173
+ } else {
2174
+ const p = envelope.payload;
2175
+ body = { id: p.movementId, session_id: p.sessionId, type: "void", amount: "0", reason: "", voids: p.voids, created_at: p.createdAt };
2176
+ }
2177
+ return answered(await post("movements", body), (answer) => {
2178
+ if (answer.status === 201 || answer.status === 200) return { id, status: "applied" };
2179
+ if (answer.status === 409) return rejected(id, "register_movement_refused", answer.body?.message, storeCode(answer));
2180
+ return void 0;
2181
+ });
2182
+ }
2183
+ case "register.closure.submit": {
2184
+ const p = envelope.payload;
2185
+ const keys = [...Object.keys(p.tillExpected), ...Object.keys(p.counted)];
2186
+ if (keys.some((key) => !TENDER_KEY.test(key)) || Object.values(p.counted).some((minor2) => minor2 < 0)) {
2187
+ return rejected(id, "invalid_payload", "A closure tender must be named with letters, digits, _ or -, and counted at 0 or more.");
2188
+ }
2189
+ const counting = await post(`sessions/${p.sessionId}/status`, { status: "counting", at: p.closedAt });
2190
+ if (counting.status !== 200 && counting.status !== 409) {
2191
+ return answered(counting, (answer) => answer.status === 404 ? rejected(id, "register_session_unknown", answer.body?.message) : void 0);
2192
+ }
2193
+ return answered(await post("closures", {
2194
+ id: p.closureId,
2195
+ session_id: p.sessionId,
2196
+ number: p.number,
2197
+ opened_at: p.openedAt,
2198
+ closed_at: p.closedAt,
2199
+ ...typeof p.businessDay === "string" && p.businessDay ? { business_day: p.businessDay } : {},
2200
+ software_version: p.softwareVersion,
2201
+ breakdowns: {},
2202
+ till_expected: wooTenders(p.tillExpected, digits),
2203
+ counted: wooTenders(p.counted, digits),
2204
+ period_sales_total: decimal(p.periodSalesTotalMinor),
2205
+ period_refunds_total: decimal(p.periodRefundsTotalMinor),
2206
+ perpetual_sales_total: decimal(p.perpetualSalesTotalMinor),
2207
+ perpetual_refunds_total: decimal(p.perpetualRefundsTotalMinor),
2208
+ unsynced_total: decimal(p.unsyncedTotalMinor),
2209
+ unsynced_count: p.unsyncedCount
2210
+ }), (answer) => {
2211
+ const { status, body } = answer;
2212
+ if (status === 201 || status === 200) {
2213
+ return { id, status: "applied", register: {
2214
+ session: { id: p.sessionId, status: "closed" },
2215
+ closure: { serverClosureId: String(body?.id), number: body?.number }
2216
+ } };
2217
+ }
2218
+ if (status === 404) return rejected(id, "register_session_unknown", body?.message, storeCode(answer));
2219
+ if (status === 403 && body?.code === "wcpos_override_refused") {
2220
+ const variance = wooSignedMinor(body?.data?.variance, currency);
2221
+ const thresholdMinor = wooThresholdMinor(body?.data?.threshold, currency);
2222
+ return variance === void 0 || typeof body?.data?.variance !== "string" ? rejected(id, "register_approval_invalid", body?.message, { reason: "unknown" }) : rejected(id, "register_approval_required", body?.message, { sessionId: p.sessionId, thresholdMinor, variance: { cash: variance } });
2223
+ }
2224
+ if (status === 409 && body?.code === "wcpos_closure_exists") return rejected(id, "register_closure_exists", body?.message);
2225
+ if (status === 409 && body?.code === "wcpos_closure_number_invalid") return rejected(id, "register_closure_number_invalid", body?.message);
2226
+ if (status === 409) return rejected(id, "register_closure_refused", body?.message, storeCode(answer));
2227
+ return void 0;
2228
+ });
2229
+ }
2230
+ default:
2231
+ return rejected(id, "invalid_payload", `unsupported register command ${String(envelope.type)}`);
2232
+ }
2233
+ };
2234
+ return {
2235
+ async send(batch) {
2236
+ if (batch.length === 0) return { kind: "results", results: [] };
2237
+ const currency = typeof options.currency === "function" ? await options.currency() : options.currency;
2238
+ const results = [];
2239
+ for (const envelope of batch) {
2240
+ const outcome = await sendOne(envelope, currency);
2241
+ if ("kind" in outcome) return results.length ? { kind: "results", results } : outcome;
2242
+ results.push(outcome);
2243
+ }
2244
+ return { kind: "results", results };
2245
+ }
2246
+ };
2247
+ }
2248
+ async function wooApproveSession(context, input) {
2249
+ const post = async (path, body2) => {
2250
+ const response2 = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/${path}`, {
2251
+ method: "POST",
2252
+ headers: { "Content-Type": "application/json", ...context.headers },
2253
+ body: JSON.stringify(body2),
2254
+ signal: context.signal
2255
+ });
2256
+ let json;
2257
+ try {
2258
+ json = await response2.json();
2259
+ } catch {
2260
+ }
2261
+ return { response: response2, body: json };
2262
+ };
2263
+ const fail = (response2) => {
2264
+ throwIfUnauthorized(response2, "approve");
2265
+ throw new Error(`WooCommerce approve: HTTP ${response2.status}`);
2266
+ };
2267
+ const counting = await post(`sessions/${input.sessionId}/status`, { status: "counting", at: (/* @__PURE__ */ new Date()).toISOString() });
2268
+ if (counting.response.status === 404) return { refused: "not_counting" };
2269
+ if (counting.response.status !== 200 && counting.response.status !== 409) fail(counting.response);
2270
+ const counted = wooTenders(input.counted, minorUnitDigits4(input.currency));
2271
+ const { response, body } = await post(
2272
+ `sessions/${input.sessionId}/approve`,
2273
+ { username: input.credentials.username, password: input.credentials.password, counted }
2274
+ );
2275
+ if (response.status === 403) return { refused: "override_refused" };
2276
+ if (response.status === 404 || response.status === 409) return { refused: "not_counting" };
2277
+ if (response.status !== 200) fail(response);
2278
+ const approved = body?.approved_counted, approvedBy = body?.approved_by;
2279
+ const expected = { cash: 0, ...input.counted };
2280
+ const matches = approved !== null && typeof approved === "object" && !Array.isArray(approved) && Object.keys(approved).length === Object.keys(expected).length && Object.entries(expected).every(([key, minor2]) => wooSignedMinor(approved[key], input.currency) === minor2);
2281
+ if (typeof approvedBy !== "number" || !Number.isInteger(approvedBy) || !matches) return { refused: "override_refused" };
2282
+ return { approval: `wcpos-approve:${input.sessionId}:${approvedBy}`, approvedBy: String(approvedBy) };
2283
+ }
2284
+
2285
+ // src/closures.ts
2286
+ var TENDER_KEY2 = /^[a-zA-Z0-9_-]{1,191}$/;
2287
+ var STORE_TIME = /^(\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2})$/;
2288
+ var isRow2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
2289
+ var unexpected2 = () => new Error("WooCommerce closures: unexpected body");
2290
+ function request(context, path, body) {
2291
+ const init = body ? { method: "POST", headers: { "Content-Type": "application/json", ...context.headers }, body: JSON.stringify(body), signal: context.signal } : { method: "GET", headers: context.headers, signal: context.signal };
2292
+ return (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/${path}`, init);
2293
+ }
2294
+ var errorCode = (response) => response.json().then((body) => typeof body?.code === "string" ? body.code : void 0, () => void 0);
2295
+ function amount(value, currency, field) {
2296
+ const minor2 = wooSignedMinor(value, currency);
2297
+ if (minor2 === void 0) throw new Error(`WooCommerce closures: bad amount ${field}`);
2298
+ return minor2;
2299
+ }
2300
+ function tenders(value, currency, field) {
2301
+ if (Array.isArray(value) && value.length === 0) return {};
2302
+ if (!isRow2(value)) throw new Error(`WooCommerce closures: bad amount ${field}`);
2303
+ return Object.fromEntries(Object.entries(value).map(([tender, text]) => [tender, amount(text, currency, `${field}.${tender}`)]));
2304
+ }
2305
+ var storeTime = (value) => value.replace(STORE_TIME, "$1T$2Z");
2306
+ function toCorrection(row, currency) {
2307
+ if (!isRow2(row) || typeof row.id !== "number" || !isRow2(row.actor) || !isRow2(row.figures)) throw unexpected2();
2308
+ const figures = {};
2309
+ for (const key of ["expected_delta", "counted", "variance"])
2310
+ if (row.figures[key] != null) figures[key] = tenders(row.figures[key], currency, key);
2311
+ for (const key of ["cash_delta", "sales_delta", "refunds_delta"])
2312
+ if (row.figures[key] != null) figures[key] = amount(row.figures[key], currency, key);
2313
+ const approver = isRow2(row.approver) ? { id: String(row.approver.id), name: String(row.approver.name) } : null;
2314
+ return {
2315
+ id: row.id,
2316
+ type: row.type,
2317
+ created_at: row.created_at,
2318
+ actor: { id: String(row.actor.id), name: String(row.actor.name) },
2319
+ approver,
2320
+ reason: row.reason,
2321
+ figures
2322
+ };
2323
+ }
2324
+ function toClosure(row, currency) {
2325
+ if (!isRow2(row) || typeof row.id !== "string" || typeof row.register_id !== "string" || typeof row.session_id !== "string" || typeof row.number !== "number" || typeof row.opened_at_gmt !== "string" || typeof row.closed_at_gmt !== "string") throw unexpected2();
2326
+ const closure = {
2327
+ id: row.id,
2328
+ number: row.number,
2329
+ registerId: row.register_id,
2330
+ sessionId: row.session_id,
2331
+ reason: typeof row.reason === "string" ? row.reason : "end_of_day",
2332
+ openedAt: storeTime(row.opened_at_gmt),
2333
+ closedAt: storeTime(row.closed_at_gmt),
2334
+ printCount: typeof row.print_count === "number" ? row.print_count : 0,
2335
+ unsyncedCount: typeof row.unsynced_count === "number" ? row.unsynced_count : 0
2336
+ };
2337
+ const map = (key) => row[key] == null ? void 0 : tenders(row[key], currency, key);
2338
+ const total = (key) => row[key] == null ? void 0 : amount(row[key], currency, key);
2339
+ const optional = {
2340
+ storeId: typeof row.store_id === "number" ? String(row.store_id) : void 0,
2341
+ businessDay: typeof row.business_day === "string" ? row.business_day : void 0,
2342
+ printedAt: typeof row.printed_at_gmt === "string" ? storeTime(row.printed_at_gmt) : void 0,
2343
+ lastPrintedAt: typeof row.last_printed_at_gmt === "string" ? storeTime(row.last_printed_at_gmt) : void 0,
2344
+ expected: map("expected"),
2345
+ tillExpected: map("till_expected"),
2346
+ counted: map("counted"),
2347
+ variance: map("variance"),
2348
+ periodSalesTotalMinor: total("period_sales_total"),
2349
+ periodRefundsTotalMinor: total("period_refunds_total"),
2350
+ perpetualSalesTotalMinor: total("perpetual_sales_total"),
2351
+ perpetualRefundsTotalMinor: total("perpetual_refunds_total"),
2352
+ unsyncedTotalMinor: total("unsynced_total"),
2353
+ correctionsCount: typeof row.corrections_count === "number" ? row.corrections_count : void 0,
2354
+ corrections: Array.isArray(row.corrections) ? row.corrections.map((correction) => toCorrection(correction, currency)) : void 0
2355
+ };
2356
+ for (const [key, value] of Object.entries(optional)) if (value !== void 0) Object.assign(closure, { [key]: value });
2357
+ return closure;
2358
+ }
2359
+ async function read(context, path) {
2360
+ const response = await request(context, path);
2361
+ throwIfUnauthorized(response, "closures");
2362
+ if (response.status === 404) return null;
2363
+ if (!response.ok) throw new Error(`WooCommerce closures: HTTP ${response.status}`);
2364
+ return response.json().catch(() => {
2365
+ throw unexpected2();
2366
+ });
2367
+ }
2368
+ async function getClosure(context, id, currency) {
2369
+ const body = await read(context, `closures/${encodeURIComponent(id)}`);
2370
+ return body === null ? null : toClosure(body, currency ?? await wooStoreCurrency(context));
2371
+ }
2372
+ var wooClosures = {
2373
+ async list(context, query = {}) {
2374
+ const perPage = Math.min(query.perPage ?? 50, 100);
2375
+ const params = new URLSearchParams();
2376
+ if (query.registerId !== void 0) params.set("register_id", query.registerId);
2377
+ if (query.after !== void 0) params.set("after", query.after);
2378
+ if (query.before !== void 0) params.set("before", query.before);
2379
+ if (query.page !== void 0) params.set("page", String(query.page));
2380
+ params.set("per_page", String(perPage));
2381
+ const body = await read(context, `closures?${params}`);
2382
+ if (body === null) return { items: [], hasMore: false };
2383
+ if (!Array.isArray(body)) throw unexpected2();
2384
+ const currency = await wooStoreCurrency(context);
2385
+ return { items: body.map((row) => toClosure(row, currency)), hasMore: body.length === perPage };
2386
+ },
2387
+ async get(context, id) {
2388
+ return getClosure(context, id);
2389
+ },
2390
+ async last(context, registerId) {
2391
+ const body = await read(context, `closures/last?${new URLSearchParams({ register_id: registerId })}`);
2392
+ return body === null ? null : toClosure(body, await wooStoreCurrency(context));
2393
+ },
2394
+ async recount(context, id, input) {
2395
+ const { correctionId, counted, reason, approval } = input;
2396
+ if (!Object.hasOwn(counted, "cash") || !Object.entries(counted).every(([tender, minor2]) => TENDER_KEY2.test(tender) && Number.isInteger(minor2) && minor2 >= 0)) {
2397
+ throw new Error("WooCommerce closure recount: invalid counted");
2398
+ }
2399
+ const currency = await wooStoreCurrency(context);
2400
+ const digits = minorUnitDigits5(currency);
2401
+ const response = await request(context, `closures/${encodeURIComponent(id)}/recount`, {
2402
+ id: correctionId,
2403
+ counted: Object.fromEntries(Object.entries(counted).map(([tender, minor2]) => [tender, wooDecimal(minor2, digits)])),
2404
+ reason,
2405
+ ...approval ? { approval: { username: approval.username, password: approval.password } } : {}
2406
+ });
2407
+ if (response.status === 200 || response.status === 201) {
2408
+ try {
2409
+ const closure = await getClosure(context, id, currency);
2410
+ return closure ? { closure } : { refused: "not_found" };
2411
+ } catch (error) {
2412
+ if (error instanceof ConnectorUnauthorizedError4 && error.status === 403) return {};
2413
+ throw error;
2414
+ }
2415
+ }
2416
+ const code = await errorCode(response);
2417
+ if (response.status === 403 && code === "rest_forbidden" && !approval) return { refused: "approval_required" };
2418
+ if (response.status === 403 && code === "wcpos_recount_approval_invalid") return { refused: "approval_invalid" };
2419
+ if (response.status === 403 && code === "wcpos_recount_approval_forbidden") return { refused: "approval_forbidden" };
2420
+ if (response.status === 404) return { refused: "not_found" };
2421
+ throwIfUnauthorized(response, "closure recount");
2422
+ throw new Error(`WooCommerce closure recount: HTTP ${response.status}${code ? ` ${code}` : ""}`);
2423
+ },
2424
+ async markPrinted(context, id) {
2425
+ const currency = await wooStoreCurrency(context);
2426
+ const response = await request(context, `closures/${encodeURIComponent(id)}/print`, {});
2427
+ if (response.status === 200) return toClosure(await response.json().catch(() => {
2428
+ throw unexpected2();
2429
+ }), currency);
2430
+ const code = await errorCode(response);
2431
+ if (response.status === 403 && code === "rest_forbidden") return { refused: "forbidden" };
2432
+ if (response.status === 404) return { refused: "not_found" };
2433
+ if (response.status === 401) throwIfUnauthorized(response, "closure print");
2434
+ throw new Error(`WooCommerce closure print: HTTP ${response.status}`);
2435
+ }
2436
+ };
2437
+
1636
2438
  // src/payment-methods.ts
1637
- import { ConnectorUnauthorizedError as ConnectorUnauthorizedError3, defaultPaymentMethods } from "@tallyui/core";
2439
+ import { defaultPaymentMethods } from "@tallyui/core";
1638
2440
  var WOO_DEFAULT_ORDER = 999;
1639
2441
  var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
1640
2442
  var objectOr = (value) => isObject(value) ? value : {};
@@ -1658,12 +2460,12 @@ function toCaptureEntry(value) {
1658
2460
  return { mode: value.mode, provider: stringOr(value.provider, null), hardware: toHardware(value.hardware) };
1659
2461
  }
1660
2462
  function hasMoneyString(row) {
1661
- const amount = objectOr(row.capabilities.amount), rounding = objectOr(objectOr(row.defaults).rounding);
1662
- return typeof amount.min === "string" || typeof amount.max === "string" || typeof rounding.increment === "string";
2463
+ const amount2 = objectOr(row.capabilities.amount), rounding = objectOr(objectOr(row.defaults).rounding);
2464
+ return typeof amount2.min === "string" || typeof amount2.max === "string" || typeof rounding.increment === "string";
1663
2465
  }
1664
2466
  async function storeCurrency(context) {
1665
2467
  const response = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/stores`, { method: "GET", headers: context.headers, signal: context.signal }).catch(() => void 0);
1666
- if (response?.status === 401 || response?.status === 403) throw new ConnectorUnauthorizedError3(`WooCommerce stores: HTTP ${response.status}`, response.status);
2468
+ throwIfUnauthorized(response, "stores");
1667
2469
  const stores = response?.ok ? await response.json().catch(() => void 0) : void 0;
1668
2470
  const currency = Array.isArray(stores) ? objectOr(stores[0]).currency : void 0;
1669
2471
  if (typeof currency !== "string") throw new Error("WooCommerce payment methods: no store currency");
@@ -1679,10 +2481,10 @@ function toRounding(value, currency, id) {
1679
2481
  }
1680
2482
  return { incrementMinor, mode };
1681
2483
  }
1682
- function toAmount(amount, currency) {
1683
- const result = { partial: amount.partial === true };
2484
+ function toAmount(amount2, currency) {
2485
+ const result = { partial: amount2.partial === true };
1684
2486
  for (const [wire, key] of [["min", "minMinor"], ["max", "maxMinor"]]) {
1685
- const text = amount[wire];
2487
+ const text = amount2[wire];
1686
2488
  if (text === void 0) continue;
1687
2489
  const minor2 = typeof text === "string" ? wooMinorFromDecimal(text, currency) : void 0;
1688
2490
  if (minor2 === void 0) return void 0;
@@ -1692,8 +2494,8 @@ function toAmount(amount, currency) {
1692
2494
  }
1693
2495
  function toDescriptor(row, currency) {
1694
2496
  const caps = row.capabilities, defaults = objectOr(row.defaults);
1695
- const amount = toAmount(objectOr(caps.amount), currency);
1696
- if (!amount) {
2497
+ const amount2 = toAmount(objectOr(caps.amount), currency);
2498
+ if (!amount2) {
1697
2499
  console.warn(`WooCommerce payment method ${row.id}: unreadable amount limit; dropped`);
1698
2500
  return void 0;
1699
2501
  }
@@ -1707,7 +2509,7 @@ function toDescriptor(row, currency) {
1707
2509
  ...Array.isArray(row.capture.modes) ? { modes: row.capture.modes.filter(isModeEntry).map(toCaptureEntry) } : {}
1708
2510
  },
1709
2511
  capabilities: {
1710
- amount,
2512
+ amount: amount2,
1711
2513
  change: caps.change === true,
1712
2514
  void: caps.void === true,
1713
2515
  refunds: { via: stringOr(refunds.via, "none"), partial: refunds.partial === true },
@@ -1720,7 +2522,7 @@ function toDescriptor(row, currency) {
1720
2522
  async function wooPaymentMethods(context) {
1721
2523
  const response = await (context.fetch ?? globalThis.fetch)(`${context.baseUrl}/payment-methods`, { method: "GET", headers: context.headers, signal: context.signal });
1722
2524
  if (response.status === 404) return defaultPaymentMethods();
1723
- if (response.status === 401 || response.status === 403) throw new ConnectorUnauthorizedError3(`WooCommerce payment methods: HTTP ${response.status}`, response.status);
2525
+ throwIfUnauthorized(response, "payment methods");
1724
2526
  if (!response.ok) throw new Error(`WooCommerce payment methods: HTTP ${response.status}`);
1725
2527
  const body = await response.json();
1726
2528
  if (!isObject(body) || !Number.isInteger(body.schema) || typeof body.contract !== "string" || !Array.isArray(body.methods)) {
@@ -1788,14 +2590,14 @@ async function wooReceiptTemplates(context, kind = "receipt") {
1788
2590
  }
1789
2591
 
1790
2592
  // package.json
1791
- var version = "3.20.0";
2593
+ var version = "4.0.0";
1792
2594
 
1793
2595
  // src/index.ts
1794
- import { ConnectorUnauthorizedError as ConnectorUnauthorizedError5 } from "@tallyui/core";
2596
+ import { ConnectorUnauthorizedError as ConnectorUnauthorizedError6 } from "@tallyui/core";
1795
2597
  function wcposClientPart(part) {
1796
2598
  return part.toLowerCase().replace(/[^a-z0-9._-]/g, "").slice(0, 32);
1797
2599
  }
1798
- var WooMissingTokenError = class extends ConnectorUnauthorizedError4 {
2600
+ var WooMissingTokenError = class extends ConnectorUnauthorizedError5 {
1799
2601
  constructor() {
1800
2602
  super("WooCommerce credentials have no WCPOS access token: sign in again", 401);
1801
2603
  this.name = "WooMissingTokenError";
@@ -1835,6 +2637,8 @@ var wooConnectorParts = {
1835
2637
  storeSettings: wooStoreSettings,
1836
2638
  paymentMethods: wooPaymentMethods,
1837
2639
  capabilities: readWooCapabilities,
2640
+ listRegisters: wooListRegisters,
2641
+ closures: wooClosures,
1838
2642
  receiptTemplates: wooReceiptTemplates,
1839
2643
  auth: {
1840
2644
  type: "WCPOS token",
@@ -1860,8 +2664,8 @@ var wooConnectorParts = {
1860
2664
  return {
1861
2665
  Authorization: `Bearer ${credentials.token}`,
1862
2666
  "X-WCPOS": "1",
1863
- // WCPOS 2.0 refuses a POS request below protocol 2 (HTTP 426); the connector already speaks 2.
1864
- "X-WCPOS-Protocol": "2",
2667
+ // WCPOS 2.0.4 refuses a POS request below protocol 3 with HTTP 426 (Services/Protocol_Gate.php:15-17).
2668
+ "X-WCPOS-Protocol": "3",
1865
2669
  // For WCPOS's consent-gated telemetry only.
1866
2670
  "X-WCPOS-Client": `tallyui/${wcposClientPart(version)}`
1867
2671
  };
@@ -1880,7 +2684,7 @@ var wooConnectorParts = {
1880
2684
  };
1881
2685
  var woocommerceConnector = createWooCommerceConnector();
1882
2686
  export {
1883
- ConnectorUnauthorizedError5 as ConnectorUnauthorizedError,
2687
+ ConnectorUnauthorizedError6 as ConnectorUnauthorizedError,
1884
2688
  WOO_NOTE_ORDER_CREATE_VERSION,
1885
2689
  WOO_ORDER_CREATE_VERSION,
1886
2690
  WooDateFilterError,
@@ -1893,12 +2697,14 @@ export {
1893
2697
  createWooCouponFeed,
1894
2698
  createWooCustomers,
1895
2699
  createWooOrders,
2700
+ createWooRegisterTransport,
1896
2701
  readWooCapabilities,
1897
2702
  toCouponDocument,
1898
2703
  toWooCustomer,
1899
2704
  toWooOrderPayload,
1900
2705
  toWooStoreOrder,
1901
2706
  wcposClientPart,
2707
+ wooApproveSession,
1902
2708
  wooCatalogueReconcile,
1903
2709
  wooCouponFingerprint,
1904
2710
  wooCouponReconcile,