@tallyui/connector-woocommerce 3.7.1 → 3.9.0

package/README.md

@@ -35,6 +35,18 @@ The incremental pull can miss an edit: a `modified_after` that over-excludes (in
 - When `wcpos/v2/status` lists `products_id_fast_path` in `capabilities`, the whole catalogue is listed in one request (`per_page=-1` with `_fields=id,date_modified_gmt,stock_quantity,stock_status`) instead of pages of 100; a store that refuses it (a 400) is listed page by page in the same pass.
 - Both listings key on the numeric product id, never the till-local uuid; the adapter's `matchKey` is how the runner finds the till's copy.
 
+## Capabilities
+
+`readWooCapabilities` (the connector's `capabilities`) runs when the till signs in or restores a session. The app keeps the result with the session.
+- **`GET wcpos/v2/stores`** gives the tax rounding (`tax_round_at_subtotal`). A failed or malformed read returns `undefined`: nothing new is known, and the stored capabilities stay.
+- **`GET wcpos/v2/status`.** The strings in its `capabilities` decide two fields:
+  - `order_create_v5` sets `orderCreate` to 5; without it, `orderCreate` is 3. Only the TallyUI fork of the plugin advertises it, and the site version never decides it.
+  - `order_payments_list` sets `multiplePayments`.
+- **`GET wcpos/v2/site`.** Its `wcpos_version` decides `coupons` (ADR-077, ruling R3). It is true only for woocommerce-pos 1.9.0 or later; a 1.9.0 pre-release does not count. Any failed or unclear read gives false, and the till then refuses to apply a coupon.
+- **`lineTax`** is always `{ none: true, classes: true }`.
+- **Unauthorised reads.** A 401 or 403 from `/stores` or `/status` throws `ConnectorUnauthorizedError`. A 401 or 403 from `/site` only closes the coupon gate.
+- **`products_id_fast_path`** is read by the reconcile pass, not here (see Reconciliation).
+
 ## Customers
 
 On WCPOS 1.10.x, `searchCustomers` uses `GET wcpos/v2/customers` with `role=customer`.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { SyncContext, ServerCapabilities, StoreSettings, Customer, CustomerInput, OrderCreateEnvelope, CommandResult, ProductTraits, CollectionSync, ReplicationAdapter, ReconcileFeed, CatalogueReconcileAdapter, ConnectorUnauthorizedError, TallyConnector } from '@tallyui/core';
+import { SyncContext, ServerCapabilities, StoreSettings, Customer, CustomerInput, OrderCreateEnvelope, CommandResult, ReconcileFeed, CatalogueReconcileAdapter, ProductTraits, CollectionSync, ReplicationAdapter, ConnectorUnauthorizedError, TallyConnector } from '@tallyui/core';
 export { ConnectorUnauthorizedError } from '@tallyui/core';
 import { RxJsonSchema } from 'rxdb';
 
@@ -96,6 +96,32 @@ declare function createWooCommandTransport(options: WooCommandTransportOptions):
  */
 declare const wooProductSchema: RxJsonSchema<any>;
 
+/**
+ * WooCommerce Coupon RxDB schema (ADR-077 amendment 2).
+ * Mirrors the coupon listing; the catalogue reconcile is its only source.
+ */
+declare const wooCouponSchema: RxJsonSchema<any>;
+
+/**
+ * One coupon row as the till stores it: a coupon without a uuid cannot be keyed and is skipped, never thrown,
+ * so one bad row cannot stall the coupons' pull. A coupon that is not published arrives deleted.
+ */
+declare function toCouponDocument(coupon: any): any | undefined;
+
+/** Coupon usage never moves the modified time (ADR-077 amendment 2); numeric used_by ids match stored strings. */
+declare const wooCouponFingerprint: (c: {
+    date_modified_gmt?: string | null;
+    usage_count?: number | null;
+    used_by?: readonly unknown[] | null;
+}) => string;
+/** Coupons reach the collection only through this feed, keyed by uuid and matched to new listing entries by id. */
+declare function createWooCouponFeed(): ReconcileFeed<any>;
+/**
+ * The coupons' only source (ADR-077 amendment 2): page through published coupons, with no date filter,
+ * and hand differences to the feed. confirmGone proves deletion by re-reading the published listing by id.
+ */
+declare function wooCouponReconcile(feed: Pick<ReconcileFeed<any>, 'enqueue'>): CatalogueReconcileAdapter<any, number>;
+
 /**
  * WooCommerce product trait implementations.
  *
@@ -226,4 +252,4 @@ declare function createWooCommerceConnector(): TallyConnector;
  */
 declare const woocommerceConnector: TallyConnector;
 
-export { WOO_ORDER_CREATE_VERSION, type WooCommandTransportOptions, WooDateFilterError, WooMissingTokenError, WooMissingUuidError, WooTillUpdateRequiredError, WooTokenRefusedError, createWooCommandTransport, createWooCommerceConnector, createWooCustomers, readWooCapabilities, toWooCustomer, toWooOrderPayload, wcposClientPart, wooCatalogueReconcile, wooProductReplication, wooProductSchema, wooProductSync, wooProductTraits, wooReconcileFingerprint, wooStoreSettings, woocommerceConnector };
+export { WOO_ORDER_CREATE_VERSION, type WooCommandTransportOptions, WooDateFilterError, WooMissingTokenError, WooMissingUuidError, WooTillUpdateRequiredError, WooTokenRefusedError, createWooCommandTransport, createWooCommerceConnector, createWooCouponFeed, createWooCustomers, readWooCapabilities, toCouponDocument, toWooCustomer, toWooOrderPayload, wcposClientPart, wooCatalogueReconcile, wooCouponFingerprint, wooCouponReconcile, wooCouponSchema, wooProductReplication, wooProductSchema, wooProductSync, wooProductTraits, wooReconcileFingerprint, wooStoreSettings, woocommerceConnector };

package/dist/index.js

@@ -170,6 +170,124 @@ var wooProductSchema = {
   required: ["uuid"]
 };
 
+// src/schemas/coupons.ts
+var wooCouponSchema = {
+  title: "WooCommerce Coupon",
+  version: 0,
+  type: "object",
+  primaryKey: "uuid",
+  properties: {
+    uuid: {
+      type: "string",
+      maxLength: 36
+    },
+    id: {
+      type: "integer",
+      multipleOf: 1,
+      minimum: 0,
+      maximum: 2147483647
+    },
+    code: {
+      type: "string",
+      maxLength: 255
+    },
+    status: {
+      type: "string"
+    },
+    amount: {
+      type: "string"
+    },
+    discount_type: {
+      type: "string"
+    },
+    description: {
+      type: "string"
+    },
+    date_created: {
+      type: "string"
+    },
+    date_created_gmt: {
+      type: "string"
+    },
+    date_modified: {
+      type: "string"
+    },
+    date_modified_gmt: {
+      type: "string"
+    },
+    minimum_amount: {
+      type: "string"
+    },
+    maximum_amount: {
+      type: "string"
+    },
+    date_expires: {
+      type: ["string", "null"]
+    },
+    date_expires_gmt: {
+      type: ["string", "null"]
+    },
+    usage_count: {
+      type: "integer"
+    },
+    usage_limit: {
+      type: ["integer", "null"]
+    },
+    usage_limit_per_user: {
+      type: ["integer", "null"]
+    },
+    limit_usage_to_x_items: {
+      type: ["integer", "null"]
+    },
+    individual_use: {
+      type: "boolean"
+    },
+    free_shipping: {
+      type: "boolean"
+    },
+    exclude_sale_items: {
+      type: "boolean"
+    },
+    product_ids: {
+      type: "array",
+      items: { type: "integer" }
+    },
+    excluded_product_ids: {
+      type: "array",
+      items: { type: "integer" }
+    },
+    product_categories: {
+      type: "array",
+      items: { type: "integer" }
+    },
+    excluded_product_categories: {
+      type: "array",
+      items: { type: "integer" }
+    },
+    email_restrictions: {
+      type: "array",
+      items: { type: "string" }
+    },
+    used_by: {
+      type: "array",
+      items: { type: "string" }
+    },
+    meta_data: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          id: { type: "integer" },
+          key: { type: "string" },
+          value: {}
+        }
+      }
+    }
+  },
+  indexes: ["code"],
+  required: ["uuid"]
+};
+
 // src/traits/product.ts
 import { moneyFromMajor } from "@tallyui/core";
 
@@ -257,7 +375,11 @@ function toVariationDocument(payload) {
     purchasable,
     tax_class,
     tax_status,
-    attributes: (payload.attributes ?? []).map(({ name, option }) => ({ name, option }))
+    attributes: (payload.attributes ?? []).map(({ id: id2, name, option }) => ({
+      ...typeof id2 === "number" ? { id: id2 } : {},
+      name,
+      option
+    }))
   }).filter(([, value]) => value !== void 0));
 }
 function toProductDocument(product) {
@@ -435,6 +557,12 @@ var wooProductTraits = {
   getVariants: (doc, context) => doc.type === "variable" ? (doc.variation_docs ?? []).filter((v) => v.status === "publish" && v.purchasable !== false).map((v) => ({
     id: String(v.id),
     title: (v.attributes ?? []).map((attribute) => attribute.option).join(" / ") || void 0,
+    options: (v.attributes ?? []).reduce((options, attribute) => {
+      if (typeof attribute.name === "string" && attribute.name.length > 0 && typeof attribute.option === "string" && attribute.option.length > 0 && !Object.prototype.hasOwnProperty.call(options, attribute.name)) {
+        return { ...options, [attribute.name]: attribute.option };
+      }
+      return options;
+    }, {}),
     sku: v.sku || void 0,
     barcode: v.barcode || void 0,
     prices: wooProductTraits.getPrices(v, context),
@@ -446,6 +574,11 @@ var wooProductTraits = {
     prices: wooProductTraits.getPrices(doc, context),
     stock: wooProductTraits.getStock(doc)
   }],
+  getVariantOptions: (doc) => doc.type !== "variable" ? [] : (doc.attributes ?? []).filter((attribute) => attribute.variation === true && typeof attribute.name === "string" && attribute.name.length > 0).sort((a, b) => (typeof a.position === "number" ? a.position : Infinity) - (typeof b.position === "number" ? b.position : Infinity)).map((attribute) => ({
+    ...Number.isInteger(attribute.id) && attribute.id > 0 ? { id: String(attribute.id) } : {},
+    name: attribute.name,
+    values: (attribute.options ?? []).filter((value) => typeof value === "string" && value.length > 0)
+  })),
   isSellable: (doc) => doc.status === void 0 || doc.status === "publish",
   getVariantCount: (doc) => doc.type === "variable" ? doc.variations?.length ?? 0 : 1,
   getType: (doc) => doc.type ?? "simple",
@@ -616,6 +749,82 @@ function createWooReconcileFeed() {
   return createReconcileFeed({ key: (doc) => doc.uuid, remote: (doc) => doc.id, fetchByIds: wooFetchByIds });
 }
 
+// src/reconcile/coupons.ts
+import { createReconcileFeed as createReconcileFeed2 } from "@tallyui/core";
+
+// src/replication/coupons.ts
+function toCouponDocument(coupon) {
+  const uuid = wooProductUuid(coupon);
+  if (uuid === void 0) return void 0;
+  const projected = Object.fromEntries(Object.keys(wooCouponSchema.properties).filter((key) => Object.prototype.hasOwnProperty.call(coupon, key)).map((key) => [key, coupon[key]]));
+  if (Array.isArray(projected.used_by)) projected.used_by = projected.used_by.map(String);
+  return { ...projected, uuid, _deleted: coupon.status !== "publish" };
+}
+
+// src/reconcile/coupons.ts
+var PAGE_SIZE2 = 100;
+var LISTING_FIELDS2 = "id,date_modified_gmt,usage_count,used_by";
+var wooCouponFingerprint = (c) => [c.date_modified_gmt ?? "", c.usage_count ?? "", JSON.stringify((c.used_by ?? []).map(String))].join("|");
+async function get2(path, context) {
+  const response = await fetch(`${context.baseUrl}${path}`, {
+    headers: { ...context.headers, "Content-Type": "application/json" },
+    signal: context.signal
+  });
+  await checkResponse(response);
+  return response.json();
+}
+async function wooFetchCouponsByIds(entries, context) {
+  const ids = entries.map((e) => e.local?.id ?? e.remote).filter((id) => Number.isInteger(id));
+  const documents = [];
+  for (let i = 0; i < ids.length; i += MAX_IDS_PER_REQUEST) {
+    const chunk = ids.slice(i, i + MAX_IDS_PER_REQUEST);
+    const params = new URLSearchParams({ include: chunk.join(","), per_page: String(MAX_IDS_PER_REQUEST), status: "any" });
+    const rows = await get2(`/coupons?${params}`, context);
+    documents.push(...rows.map(toCouponDocument).filter((doc) => doc !== void 0));
+  }
+  return documents;
+}
+function createWooCouponFeed() {
+  return createReconcileFeed2({ key: (doc) => doc.uuid, remote: (doc) => doc.id, fetchByIds: wooFetchCouponsByIds });
+}
+var toEntries2 = (rows) => rows.filter((row) => Number.isInteger(row?.id)).map((row) => ({ key: String(row.id), fingerprint: wooCouponFingerprint(row), remote: row.id }));
+function wooCouponReconcile(feed) {
+  return {
+    async *fetchPages(context, from = 1) {
+      for (let page = from; ; page++) {
+        const params = new URLSearchParams({
+          per_page: String(PAGE_SIZE2),
+          page: String(page),
+          orderby: "id",
+          order: "asc",
+          status: "publish",
+          _fields: LISTING_FIELDS2
+        });
+        const rows = await get2(`/coupons?${params}`, context);
+        yield { entries: toEntries2(rows), cursor: page + 1 };
+        if (rows.length < PAGE_SIZE2) return;
+      }
+    },
+    fingerprint: wooCouponFingerprint,
+    // The listing keys on the numeric id, never the till-local uuid.
+    matchKey: (doc) => Number.isInteger(doc.id) ? String(doc.id) : void 0,
+    async confirmGone(locals, context) {
+      const ids = locals.map((doc) => doc.id).filter((id) => Number.isInteger(id));
+      if (!ids.length) return [];
+      const live = /* @__PURE__ */ new Map();
+      for (let i = 0; i < ids.length; i += MAX_IDS_PER_REQUEST) {
+        const chunk = ids.slice(i, i + MAX_IDS_PER_REQUEST);
+        const params = new URLSearchParams({ include: chunk.join(","), per_page: String(MAX_IDS_PER_REQUEST), _fields: "id,meta_data" });
+        const rows = await get2(`/coupons?${params}`, context);
+        for (const row of rows) live.set(row.id, wooProductUuid(row));
+      }
+      return locals.filter((doc) => Number.isInteger(doc.id) && (!live.has(doc.id) || typeof live.get(doc.id) === "string" && live.get(doc.id) !== doc.uuid)).map((doc) => doc.uuid);
+    },
+    // Without an integer id, the feed would find nothing and tombstone without proof; proven tombstones pass.
+    enqueue: (entries) => feed.enqueue(entries.filter((e) => e.tombstone || Number.isInteger(e.local?.id) || Number.isInteger(e.remote)))
+  };
+}
+
 // src/customers.ts
 import { CustomerServiceError } from "@tallyui/core";
 function toWooCustomer(raw) {
@@ -721,6 +930,18 @@ function createWooCustomers(options) {
 import { ConnectorUnauthorizedError as ConnectorUnauthorizedError2, StoreSettingsError, minorUnitDigits, woocommerceTax } from "@tallyui/core";
 var WOO_ORDER_CREATE_VERSION = 5;
 var WOO_BASE_ORDER_CREATE_VERSION = 3;
+var WOO_COUPONS_MIN_PLUGIN = [1, 9, 0];
+function wooPluginSupportsCoupons(version2) {
+  if (typeof version2 !== "string") return false;
+  const match = /^(\d+)\.(\d+)(?:\.(\d+))?(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$/.exec(version2.trim());
+  if (!match) return false;
+  const parts = [Number(match[1]), Number(match[2]), Number(match[3] ?? 0)];
+  for (let index = 0; index < parts.length; index++) {
+    if (parts[index] > WOO_COUPONS_MIN_PLUGIN[index]) return true;
+    if (parts[index] < WOO_COUPONS_MIN_PLUGIN[index]) return false;
+  }
+  return !match[4];
+}
 async function wooStoreSettings(context) {
   try {
     const init = { method: "GET", headers: context.headers, signal: context.signal };
@@ -750,6 +971,7 @@ async function wooStoreSettings(context) {
       currency,
       pricesIncludeTax: store.prices_include_tax === "yes",
       taxRoundAtSubtotal: store.tax_round_at_subtotal === "yes",
+      calcDiscountsSequentially: (store.woocommerce_calc_discounts_sequentially ?? store.calc_discounts_sequentially) === "yes",
       ...typeof store.shipping_tax_class === "string" ? { shippingTaxClass: store.shipping_tax_class } : {},
       taxClassSlugs: classes.map((row) => row.slug),
       taxRates,
@@ -831,11 +1053,26 @@ async function readWooCapabilities(context) {
     } catch (error) {
       if (error instanceof ConnectorUnauthorizedError2) throw error;
     }
+    let coupons = false;
+    try {
+      const site = await fetch(`${context.baseUrl}/site`, {
+        method: "GET",
+        headers: context.headers,
+        signal: context.signal
+      });
+      if (site.ok) {
+        const body = await site.json();
+        coupons = wooPluginSupportsCoupons(body?.wcpos_version);
+      }
+    } catch {
+      coupons = false;
+    }
     const orderCreate = capabilities.includes("order_create_v5") ? WOO_ORDER_CREATE_VERSION : WOO_BASE_ORDER_CREATE_VERSION;
     return {
       orderCreate,
       taxRounding: { granularity: "woocommerce", roundAtSubtotal: stores[0].tax_round_at_subtotal === "yes" },
       multiplePayments,
+      coupons,
       // 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.
       lineTax: { none: true, classes: true }
     };
@@ -846,7 +1083,7 @@ async function readWooCapabilities(context) {
 }
 
 // package.json
-var version = "3.7.1";
+var version = "3.9.0";
 
 // src/commands/transport.ts
 import { minorUnitDigits as minorUnitDigits2, moneyFromDecimalString, moneyFromMajor as moneyFromMajor2 } from "@tallyui/core";
@@ -1054,6 +1291,7 @@ var WooMissingTokenError = class extends ConnectorUnauthorizedError3 {
 };
 function createWooCommerceConnector() {
   const catalogueFeed = createWooReconcileFeed();
+  const couponFeed = createWooCouponFeed();
   const customers = createWooCustomers();
   return {
     ...wooConnectorParts,
@@ -1063,11 +1301,13 @@ function createWooCommerceConnector() {
       // One replication per collection; the reconcile feed is last, so its fetch wins duplicates;
       // duplicates are matched by uuid, the primary key, not the store id (#331). legacyKey
       // reads an existing install's plain pull checkpoint as the product feed's, so it does not resync.
-      products: combinePullAdapters({ products: wooProductReplication, reconcile: catalogueFeed.adapter }, { legacyKey: "products", key: (doc) => doc.uuid })
+      products: combinePullAdapters({ products: wooProductReplication, reconcile: catalogueFeed.adapter }, { legacyKey: "products", key: (doc) => doc.uuid }),
+      coupons: couponFeed.adapter
     },
     reconcile: {
       // The feed's fetchByIds asks for at most this many ids per request; the runner budgets by requests.
-      catalogue: { ...wooCatalogueReconcile(catalogueFeed), refetchBatchSize: MAX_IDS_PER_REQUEST }
+      catalogue: { ...wooCatalogueReconcile(catalogueFeed), refetchBatchSize: MAX_IDS_PER_REQUEST },
+      coupons: { ...wooCouponReconcile(couponFeed), refetchBatchSize: MAX_IDS_PER_REQUEST }
     }
   };
 }
@@ -1111,7 +1351,8 @@ var wooConnectorParts = {
     }
   },
   schemas: {
-    products: wooProductSchema
+    products: wooProductSchema,
+    coupons: wooCouponSchema
   },
   traits: {
     product: wooProductTraits
@@ -1131,12 +1372,17 @@ export {
   WooTokenRefusedError,
   createWooCommandTransport,
   createWooCommerceConnector,
+  createWooCouponFeed,
   createWooCustomers,
   readWooCapabilities,
+  toCouponDocument,
   toWooCustomer,
   toWooOrderPayload,
   wcposClientPart,
   wooCatalogueReconcile,
+  wooCouponFingerprint,
+  wooCouponReconcile,
+  wooCouponSchema,
   wooProductReplication,
   wooProductSchema,
   wooProductSync,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/connector-woocommerce",
-  "version": "3.7.1",
+  "version": "3.9.0",
   "type": "module",
   "description": "WooCommerce connector for Tally UI",
   "main": "./dist/index.js",
@@ -10,7 +10,8 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "source": "./src/index.ts"
+      "source": "./src/index.ts",
+      "default": "./dist/index.js"
     }
   },
   "files": [
@@ -26,10 +27,10 @@
     "directory": "connectors/woocommerce"
   },
   "peerDependencies": {
-    "@tallyui/core": "^3.7.1"
+    "@tallyui/core": "^3.9.0"
   },
   "devDependencies": {
-    "@tallyui/database": "3.7.1",
+    "@tallyui/database": "3.9.0",
     "rxdb": "17.5.0"
   },
   "scripts": {

package/src/index.ts

@@ -1,11 +1,13 @@
 import { combinePullAdapters, ConnectorUnauthorizedError, type TallyConnector } from '@tallyui/core';
 
 import { wooProductSchema } from './schemas/products';
+import { wooCouponSchema } from './schemas/coupons';
 import { wooProductTraits } from './traits/product';
 import { wooProductSync } from './sync/products';
 import { wooProductReplication } from './replication/products';
 import { wooCatalogueReconcile } from './reconcile/catalogue';
 import { createWooReconcileFeed, MAX_IDS_PER_REQUEST } from './reconcile/feed';
+import { createWooCouponFeed, wooCouponReconcile } from './reconcile/coupons';
 import { createWooCustomers } from './customers';
 import { wooStoreSettings, readWooCapabilities } from './store-settings';
 import { version } from '../package.json';
@@ -43,6 +45,7 @@ export class WooMissingTokenError extends ConnectorUnauthorizedError {
 export function createWooCommerceConnector(): TallyConnector {
   // The catalogue reconcile's corrections reach `products` only through this pull adapter (#248).
   const catalogueFeed = createWooReconcileFeed();
+  const couponFeed = createWooCouponFeed();
   const customers = createWooCustomers();
   return {
     ...wooConnectorParts,
@@ -53,10 +56,12 @@ export function createWooCommerceConnector(): TallyConnector {
       // duplicates are matched by uuid, the primary key, not the store id (#331). legacyKey
       // reads an existing install's plain pull checkpoint as the product feed's, so it does not resync.
       products: combinePullAdapters({ products: wooProductReplication, reconcile: catalogueFeed.adapter }, { legacyKey: 'products', key: (doc: any) => doc.uuid }),
+      coupons: couponFeed.adapter,
     },
     reconcile: {
       // The feed's fetchByIds asks for at most this many ids per request; the runner budgets by requests.
       catalogue: { ...wooCatalogueReconcile(catalogueFeed), refetchBatchSize: MAX_IDS_PER_REQUEST },
+      coupons: { ...wooCouponReconcile(couponFeed), refetchBatchSize: MAX_IDS_PER_REQUEST },
     },
   };
 }
@@ -104,6 +109,7 @@ const wooConnectorParts = {
 
   schemas: {
     products: wooProductSchema,
+    coupons: wooCouponSchema,
   },
 
   traits: {
@@ -127,6 +133,9 @@ export { createWooCustomers, toWooCustomer } from './customers';
 export { createWooCommandTransport, toWooOrderPayload, type WooCommandTransportOptions } from './commands/transport';
 export { ConnectorUnauthorizedError } from '@tallyui/core';
 export { wooProductSchema } from './schemas/products';
+export { wooCouponSchema } from './schemas/coupons';
+export { toCouponDocument } from './replication/coupons';
+export { wooCouponReconcile, wooCouponFingerprint, createWooCouponFeed } from './reconcile/coupons';
 export { wooProductTraits } from './traits/product';
 export { wooProductSync } from './sync/products';
 export { wooProductReplication, WooDateFilterError, WooTokenRefusedError, WooMissingUuidError, WooTillUpdateRequiredError } from './replication/products';

package/src/reconcile/coupons.ts

@@ -0,0 +1,85 @@
+import { createReconcileFeed, type CatalogueReconcileAdapter, type CatalogueReconcileEntry, type ReconcileFeed, type ReconcileFetchEntry, type SyncContext } from '@tallyui/core';
+import { toCouponDocument } from '../replication/coupons';
+import { checkResponse, wooProductUuid } from '../replication/products';
+import { MAX_IDS_PER_REQUEST } from './feed';
+
+/** The listing's page size, WordPress's per_page maximum. */
+const PAGE_SIZE = 100;
+/** The numeric id for refetching, and the fingerprint's fields. */
+const LISTING_FIELDS = 'id,date_modified_gmt,usage_count,used_by';
+
+/** Coupon usage never moves the modified time (ADR-077 amendment 2); numeric used_by ids match stored strings. */
+export const wooCouponFingerprint = (c: { date_modified_gmt?: string | null; usage_count?: number | null; used_by?: readonly unknown[] | null }): string =>
+  [c.date_modified_gmt ?? '', c.usage_count ?? '', JSON.stringify((c.used_by ?? []).map(String))].join('|');
+
+async function get(path: string, context: SyncContext): Promise<any> {
+  const response = await fetch(`${context.baseUrl}${path}`, {
+    headers: { ...context.headers, 'Content-Type': 'application/json' },
+    signal: context.signal,
+  });
+  await checkResponse(response);
+  return response.json();
+}
+
+/**
+ * Full coupons by numeric id (the till's own id, else the listing's remote). A draft arrives deleted;
+ * a trashed coupon is absent from status=any, so the feed tombstones its local copy.
+ */
+export async function wooFetchCouponsByIds(entries: Array<ReconcileFetchEntry<any>>, context: SyncContext): Promise<any[]> {
+  const ids = entries.map((e) => e.local?.id ?? e.remote).filter((id): id is number => Number.isInteger(id));
+  const documents: any[] = [];
+  for (let i = 0; i < ids.length; i += MAX_IDS_PER_REQUEST) {
+    const chunk = ids.slice(i, i + MAX_IDS_PER_REQUEST);
+    const params = new URLSearchParams({ include: chunk.join(','), per_page: String(MAX_IDS_PER_REQUEST), status: 'any' });
+    const rows: any[] = await get(`/coupons?${params}`, context);
+    documents.push(...rows.map(toCouponDocument).filter((doc) => doc !== undefined));
+  }
+  return documents;
+}
+
+/** Coupons reach the collection only through this feed, keyed by uuid and matched to new listing entries by id. */
+export function createWooCouponFeed(): ReconcileFeed<any> {
+  return createReconcileFeed<any>({ key: (doc) => doc.uuid, remote: (doc) => doc.id, fetchByIds: wooFetchCouponsByIds });
+}
+
+/** Listing rows keyed by numeric id; a row without an integer id cannot be asked about, and is dropped. */
+const toEntries = (rows: any[]) => rows.filter((row) => Number.isInteger(row?.id))
+  .map((row): CatalogueReconcileEntry => ({ key: String(row.id), fingerprint: wooCouponFingerprint(row), remote: row.id }));
+
+/**
+ * The coupons' only source (ADR-077 amendment 2): page through published coupons, with no date filter,
+ * and hand differences to the feed. confirmGone proves deletion by re-reading the published listing by id.
+ */
+export function wooCouponReconcile(feed: Pick<ReconcileFeed<any>, 'enqueue'>): CatalogueReconcileAdapter<any, number> {
+  return {
+    async *fetchPages(context, from = 1) {
+      for (let page = from; ; page++) {
+        const params = new URLSearchParams({
+          per_page: String(PAGE_SIZE), page: String(page), orderby: 'id', order: 'asc', status: 'publish', _fields: LISTING_FIELDS,
+        });
+        const rows: any[] = await get(`/coupons?${params}`, context);
+        yield { entries: toEntries(rows), cursor: page + 1 };
+        if (rows.length < PAGE_SIZE) return;
+      }
+    },
+    fingerprint: wooCouponFingerprint,
+    // The listing keys on the numeric id, never the till-local uuid.
+    matchKey: (doc) => (Number.isInteger(doc.id) ? String(doc.id) : undefined),
+    async confirmGone(locals, context) {
+      const ids = locals.map((doc) => doc.id).filter((id) => Number.isInteger(id));
+      // An empty include= would list the whole store; a local without a numeric id has no proof and is kept.
+      if (!ids.length) return [];
+      const live = new Map<number, string | undefined>();
+      for (let i = 0; i < ids.length; i += MAX_IDS_PER_REQUEST) {
+        const chunk = ids.slice(i, i + MAX_IDS_PER_REQUEST);
+        const params = new URLSearchParams({ include: chunk.join(','), per_page: String(MAX_IDS_PER_REQUEST), _fields: 'id,meta_data' });
+        const rows: any[] = await get(`/coupons?${params}`, context);
+        for (const row of rows) live.set(row.id, wooProductUuid(row));
+      }
+      // A live id backs only the store's uuid (#369); a live row without a uuid keeps the local copy.
+      return locals.filter((doc) => Number.isInteger(doc.id) && (!live.has(doc.id) || (typeof live.get(doc.id) === 'string' && live.get(doc.id) !== doc.uuid))).map((doc) => doc.uuid);
+    },
+    // Without an integer id, the feed would find nothing and tombstone without proof; proven tombstones pass.
+    enqueue: (entries) => feed.enqueue(entries.filter((e) => e.tombstone || Number.isInteger(e.local?.id) || Number.isInteger(e.remote))),
+  };
+}

package/src/replication/coupons.ts

@@ -0,0 +1,16 @@
+import { wooCouponSchema } from '../schemas/coupons';
+import { wooProductUuid } from './products';
+
+/**
+ * One coupon row as the till stores it: a coupon without a uuid cannot be keyed and is skipped, never thrown,
+ * so one bad row cannot stall the coupons' pull. A coupon that is not published arrives deleted.
+ */
+export function toCouponDocument(coupon: any): any | undefined {
+  const uuid = wooProductUuid(coupon);
+  if (uuid === undefined) return undefined;
+  const projected = Object.fromEntries(Object.keys(wooCouponSchema.properties)
+    .filter((key) => Object.prototype.hasOwnProperty.call(coupon, key))
+    .map((key) => [key, coupon[key]]));
+  if (Array.isArray(projected.used_by)) projected.used_by = projected.used_by.map(String);
+  return { ...projected, uuid, _deleted: coupon.status !== 'publish' };
+}

package/src/replication/products.ts

@@ -90,7 +90,9 @@ export function toVariationDocument(payload: any) {
     id, sku, barcode: wooProductBarcode(payload), price, regular_price, sale_price, on_sale,
     stock_status, stock_quantity, manage_stock, status, purchasable,
     tax_class, tax_status,
-    attributes: (payload.attributes ?? []).map(({ name, option }: any) => ({ name, option })),
+    attributes: (payload.attributes ?? []).map(({ id, name, option }: any) => ({
+      ...(typeof id === 'number' ? { id } : {}), name, option,
+    })),
   }).filter(([, value]) => value !== undefined));
 }
 

package/src/schemas/coupons.ts

@@ -0,0 +1,122 @@
+import type { RxJsonSchema } from 'rxdb';
+
+/**
+ * WooCommerce Coupon RxDB schema (ADR-077 amendment 2).
+ * Mirrors the coupon listing; the catalogue reconcile is its only source.
+ */
+export const wooCouponSchema: RxJsonSchema<any> = {
+  title: 'WooCommerce Coupon',
+  version: 0,
+  type: 'object',
+  primaryKey: 'uuid',
+  properties: {
+    uuid: {
+      type: 'string',
+      maxLength: 36,
+    },
+    id: {
+      type: 'integer',
+      multipleOf: 1,
+      minimum: 0,
+      maximum: 2147483647,
+    },
+    code: {
+      type: 'string',
+      maxLength: 255,
+    },
+    status: {
+      type: 'string',
+    },
+    amount: {
+      type: 'string',
+    },
+    discount_type: {
+      type: 'string',
+    },
+    description: {
+      type: 'string',
+    },
+    date_created: {
+      type: 'string',
+    },
+    date_created_gmt: {
+      type: 'string',
+    },
+    date_modified: {
+      type: 'string',
+    },
+    date_modified_gmt: {
+      type: 'string',
+    },
+    minimum_amount: {
+      type: 'string',
+    },
+    maximum_amount: {
+      type: 'string',
+    },
+    date_expires: {
+      type: ['string', 'null'],
+    },
+    date_expires_gmt: {
+      type: ['string', 'null'],
+    },
+    usage_count: {
+      type: 'integer',
+    },
+    usage_limit: {
+      type: ['integer', 'null'],
+    },
+    usage_limit_per_user: {
+      type: ['integer', 'null'],
+    },
+    limit_usage_to_x_items: {
+      type: ['integer', 'null'],
+    },
+    individual_use: {
+      type: 'boolean',
+    },
+    free_shipping: {
+      type: 'boolean',
+    },
+    exclude_sale_items: {
+      type: 'boolean',
+    },
+    product_ids: {
+      type: 'array',
+      items: { type: 'integer' },
+    },
+    excluded_product_ids: {
+      type: 'array',
+      items: { type: 'integer' },
+    },
+    product_categories: {
+      type: 'array',
+      items: { type: 'integer' },
+    },
+    excluded_product_categories: {
+      type: 'array',
+      items: { type: 'integer' },
+    },
+    email_restrictions: {
+      type: 'array',
+      items: { type: 'string' },
+    },
+    used_by: {
+      type: 'array',
+      items: { type: 'string' },
+    },
+    meta_data: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          id: { type: 'integer' },
+          key: { type: 'string' },
+          value: {},
+        },
+      },
+    },
+  },
+  indexes: ['code'],
+  required: ['uuid'],
+};

package/src/store-settings.ts

@@ -5,6 +5,20 @@ import type { ServerCapabilities, StoreSettings, SyncContext } from '@tallyui/co
 export const WOO_ORDER_CREATE_VERSION = 5;
 // The order.create version a store gets unless /status lists order_create_v5, which only the TallyUI fork of the plugin advertises.
 const WOO_BASE_ORDER_CREATE_VERSION = 3;
+// The first woocommerce-pos release whose coupon recalculation keeps the POS price (ADR-077 amendment 4, R2: 1.9.0, 2026-05-15).
+const WOO_COUPONS_MIN_PLUGIN: readonly [number, number, number] = [1, 9, 0];
+
+export function wooPluginSupportsCoupons(version: unknown): boolean {
+  if (typeof version !== 'string') return false;
+  const match = /^(\d+)\.(\d+)(?:\.(\d+))?(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$/.exec(version.trim());
+  if (!match) return false;
+  const parts: readonly [number, number, number] = [Number(match[1]), Number(match[2]), Number(match[3] ?? 0)];
+  for (let index = 0; index < parts.length; index++) {
+    if (parts[index] > WOO_COUPONS_MIN_PLUGIN[index]) return true;
+    if (parts[index] < WOO_COUPONS_MIN_PLUGIN[index]) return false;
+  }
+  return !match[4];
+}
 
 export async function wooStoreSettings(context: SyncContext): Promise<StoreSettings> {
   try {
@@ -38,6 +52,7 @@ export async function wooStoreSettings(context: SyncContext): Promise<StoreSetti
       currency,
       pricesIncludeTax: store.prices_include_tax === 'yes',
       taxRoundAtSubtotal: store.tax_round_at_subtotal === 'yes',
+      calcDiscountsSequentially: (store.woocommerce_calc_discounts_sequentially ?? store.calc_discounts_sequentially) === 'yes',
       ...(typeof store.shipping_tax_class === 'string' ? { shippingTaxClass: store.shipping_tax_class } : {}),
       taxClassSlugs: classes.map((row) => row.slug),
       taxRates,
@@ -118,11 +133,24 @@ export async function readWooCapabilities(context: SyncContext): Promise<ServerC
     } catch (error) {
       if (error instanceof ConnectorUnauthorizedError) throw error;
     }
+    let coupons = false;
+    try {
+      const site = await fetch(`${context.baseUrl}/site`, {
+        method: 'GET', headers: context.headers, signal: context.signal,
+      });
+      if (site.ok) {
+        const body = await site.json();
+        coupons = wooPluginSupportsCoupons(body?.wcpos_version);
+      }
+    } catch {
+      coupons = false;
+    }
     const orderCreate = capabilities.includes('order_create_v5') ? WOO_ORDER_CREATE_VERSION : WOO_BASE_ORDER_CREATE_VERSION;
     return {
       orderCreate,
       taxRounding: { granularity: 'woocommerce', roundAtSubtotal: stores[0].tax_round_at_subtotal === 'yes' },
       multiplePayments,
+      coupons,
       // 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.
       lineTax: { none: true, classes: true },
     };

package/src/traits/product.ts

@@ -85,6 +85,14 @@ export const wooProductTraits: ProductTraits = {
     .filter((v: any) => v.status === 'publish' && v.purchasable !== false).map((v: any) => ({
       id: String(v.id),
       title: (v.attributes ?? []).map((attribute: any) => attribute.option).join(' / ') || undefined,
+      options: (v.attributes ?? []).reduce((options: Record<string, string>, attribute: any) => {
+        if (typeof attribute.name === 'string' && attribute.name.length > 0
+          && typeof attribute.option === 'string' && attribute.option.length > 0
+          && !Object.prototype.hasOwnProperty.call(options, attribute.name)) {
+          return { ...options, [attribute.name]: attribute.option };
+        }
+        return options;
+      }, {}),
       sku: v.sku || undefined,
       barcode: v.barcode || undefined,
       prices: wooProductTraits.getPrices(v, context),
@@ -97,6 +105,17 @@ export const wooProductTraits: ProductTraits = {
     stock: wooProductTraits.getStock(doc),
   }],
 
+  getVariantOptions: (doc) => doc.type !== 'variable' ? [] : (doc.attributes ?? [])
+    .filter((attribute: any) => attribute.variation === true
+      && typeof attribute.name === 'string' && attribute.name.length > 0)
+    .sort((a: any, b: any) => (typeof a.position === 'number' ? a.position : Infinity)
+      - (typeof b.position === 'number' ? b.position : Infinity))
+    .map((attribute: any) => ({
+      ...(Number.isInteger(attribute.id) && attribute.id > 0 ? { id: String(attribute.id) } : {}),
+      name: attribute.name,
+      values: (attribute.options ?? []).filter((value: any) => typeof value === 'string' && value.length > 0),
+    })),
+
   isSellable: (doc) => doc.status === undefined || doc.status === 'publish',
 
   getVariantCount: (doc) => doc.type === 'variable' ? doc.variations?.length ?? 0 : 1,