@tallyui/connector-woocommerce 3.0.1 → 3.0.3

package/dist/index.d.ts

@@ -1,7 +1,39 @@
-import { ProductTraits, CollectionSync, ReplicationAdapter, ReconcileFeed, CatalogueReconcileAdapter, ConnectorUnauthorizedError, TallyConnector } from '@tallyui/core';
+import { OrderCreateEnvelope, CommandResult, ProductTraits, CollectionSync, ReplicationAdapter, ReconcileFeed, CatalogueReconcileAdapter, ConnectorUnauthorizedError, TallyConnector } from '@tallyui/core';
 export { ConnectorUnauthorizedError } from '@tallyui/core';
 import { RxJsonSchema } from 'rxdb';
 
+type WooTransportOutcome = {
+    kind: 'results';
+    results: CommandResult[];
+} | {
+    kind: 'unauthorized';
+} | {
+    kind: 'refused';
+    status: number;
+    reason: string;
+} | {
+    kind: 'retry';
+    reason: string;
+    retryAfterMs?: number;
+};
+interface WooCommandTransportOptions {
+    baseUrl: string;
+    getHeaders: () => Record<string, string> | Promise<Record<string, string>>;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+declare function toWooOrderPayload(envelope: OrderCreateEnvelope): {
+    payload: Record<string, unknown>;
+} | {
+    error: {
+        code: string;
+        message: string;
+    };
+};
+declare function createWooCommandTransport(options: WooCommandTransportOptions): {
+    send(batch: OrderCreateEnvelope[]): Promise<WooTransportOutcome>;
+};
+
 /**
  * WooCommerce Product RxDB schema.
  * Closely mirrors the WooCommerce REST API product shape.
@@ -139,4 +171,4 @@ declare function createWooCommerceConnector(): TallyConnector;
  */
 declare const woocommerceConnector: TallyConnector;
 
-export { WooDateFilterError, WooMissingTokenError, WooMissingUuidError, WooTillUpdateRequiredError, WooTokenRefusedError, createWooCommerceConnector, wcposClientPart, wooCatalogueReconcile, wooProductReplication, wooProductSchema, wooProductSync, wooProductTraits, wooReconcileFingerprint, woocommerceConnector };
+export { type WooCommandTransportOptions, WooDateFilterError, WooMissingTokenError, WooMissingUuidError, WooTillUpdateRequiredError, WooTokenRefusedError, createWooCommandTransport, createWooCommerceConnector, toWooOrderPayload, wcposClientPart, wooCatalogueReconcile, wooProductReplication, wooProductSchema, wooProductSync, wooProductTraits, wooReconcileFingerprint, woocommerceConnector };

package/dist/index.js

@@ -4,7 +4,7 @@ import { combinePullAdapters, ConnectorUnauthorizedError as ConnectorUnauthorize
 // src/schemas/products.ts
 var wooProductSchema = {
   title: "WooCommerce Product",
-  version: 0,
+  version: 1,
   type: "object",
   primaryKey: "uuid",
   properties: {
@@ -127,6 +127,22 @@ var wooProductSchema = {
       type: "array",
       items: { type: "integer" }
     },
+    // Embedded from wcpos/v2/variations; WCPOS 1.10.x has no per-product route.
+    variation_docs: { type: "array", items: { type: "object", properties: {
+      id: { type: "integer" },
+      sku: { type: "string" },
+      barcode: { type: "string" },
+      price: { type: "string" },
+      regular_price: { type: "string" },
+      sale_price: { type: "string" },
+      on_sale: { type: "boolean" },
+      stock_status: { type: "string" },
+      stock_quantity: { type: ["number", "null"] },
+      manage_stock: { type: "boolean" },
+      status: { type: "string" },
+      purchasable: { type: "boolean" },
+      attributes: { type: "array", items: { type: "object", properties: { name: { type: "string" }, option: { type: "string" } } } }
+    } } },
     meta_data: {
       type: "array",
       items: {
@@ -202,6 +218,36 @@ function wooProductBarcode(product) {
   if (typeof product.global_unique_id === "string" && product.global_unique_id.length > 0) return product.global_unique_id;
   return void 0;
 }
+function toVariationDocument(payload) {
+  const {
+    id,
+    sku,
+    price,
+    regular_price,
+    sale_price,
+    on_sale,
+    stock_status,
+    stock_quantity,
+    manage_stock,
+    status,
+    purchasable
+  } = payload;
+  return Object.fromEntries(Object.entries({
+    id,
+    sku,
+    barcode: wooProductBarcode(payload),
+    price,
+    regular_price,
+    sale_price,
+    on_sale,
+    stock_status,
+    stock_quantity,
+    manage_stock,
+    status,
+    purchasable,
+    attributes: (payload.attributes ?? []).map(({ name, option }) => ({ name, option }))
+  }).filter(([, value]) => value !== void 0));
+}
 function toProductDocument(product) {
   const uuid = wooProductUuid(product);
   if (uuid === void 0) throw new WooMissingUuidError(product.id);
@@ -290,6 +336,28 @@ var wooProductReplication = {
         }
         return document;
       });
+      const variableProducts = documents.filter((doc) => doc.type === "variable" && !doc._deleted);
+      const variationIds = variableProducts.flatMap((doc) => doc.variations ?? []);
+      const variations = /* @__PURE__ */ new Map();
+      for (let i = 0; i < variationIds.length; i += 100) {
+        const chunk = variationIds.slice(i, i + 100);
+        const variationParams = new URLSearchParams({ include: chunk.join(","), per_page: String(chunk.length), orderby: "id", order: "asc" });
+        const response2 = await fetch(`${context.baseUrl}/variations?${variationParams}`, {
+          headers: { ...context.headers, "Content-Type": "application/json" },
+          signal: context.signal
+        });
+        await checkResponse(response2);
+        const body = await response2.json();
+        for (const doc of body.documents) {
+          const parentId = doc.parent_id ?? doc.payload.parent_id;
+          const group = variations.get(parentId) ?? [];
+          group.push(toVariationDocument(doc.payload));
+          variations.set(parentId, group);
+        }
+      }
+      for (const doc of variableProducts) {
+        doc.variation_docs = (variations.get(doc.id) ?? []).sort((a, b) => a.id - b.id);
+      }
       const complete = count === void 0 ? products.length < batchSize : offset + products.length >= count;
       const checkpoint = complete ? { modified: passMark, offset: 0, pass_mark: void 0, pass_count: void 0 } : { modified, offset: offset + products.length, pass_mark: passMark, pass_count: count };
       if (complete && products.length === 0) {
@@ -340,6 +408,21 @@ var wooProductTraits = {
   },
   getStockQuantity: (doc) => doc.stock_quantity ?? null,
   hasVariants: (doc) => doc.type === "variable",
+  // Variable products carry their synced variations for synchronous, offline traits.
+  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,
+    sku: v.sku || void 0,
+    barcode: v.barcode || void 0,
+    prices: wooProductTraits.getPrices(v, context),
+    stock: wooProductTraits.getStock(v)
+  })) : [{
+    id: String(doc.id),
+    sku: doc.sku || void 0,
+    barcode: wooProductBarcode(doc),
+    prices: wooProductTraits.getPrices(doc, context),
+    stock: wooProductTraits.getStock(doc)
+  }],
   isSellable: (doc) => doc.status === void 0 || doc.status === "publish",
   getVariantCount: (doc) => doc.type === "variable" ? doc.variations?.length ?? 0 : 1,
   getType: (doc) => doc.type ?? "simple",
@@ -510,7 +593,137 @@ function createWooReconcileFeed() {
 }
 
 // package.json
-var version = "3.0.1";
+var version = "3.0.3";
+
+// src/commands/transport.ts
+import { minorUnitDigits, moneyFromDecimalString, moneyFromMajor as moneyFromMajor2 } from "@tallyui/core";
+function wooMinorFromDecimal(text, currency) {
+  const trimmed = text.trim();
+  if (!/^\d+(\.\d+)?$/.test(trimmed)) return void 0;
+  const digits = minorUnitDigits(currency);
+  const [whole, fraction = ""] = trimmed.split(".");
+  let end = fraction.length;
+  while (end > digits && fraction[end - 1] === "0") end--;
+  if (end > digits) return moneyFromMajor2(trimmed, currency)?.amount;
+  return moneyFromDecimalString(end ? `${whole}.${fraction.slice(0, end)}` : whole, currency)?.amount;
+}
+function toWooOrderPayload(envelope) {
+  const p = envelope.payload;
+  if (p.pricesIncludeTax || p.lines.some((line) => line.taxInclusive === true)) {
+    return { error: { code: "unsupported_tax_mode", message: "Prices that include tax are not supported for WooCommerce yet." } };
+  }
+  if (p.payments.length !== 1) {
+    return { error: { code: "invalid_payload", message: "WooCommerce orders take one payment." } };
+  }
+  for (const line of p.lines) {
+    if (!/^[1-9]\d*$/.test(line.variantId) || !Number.isSafeInteger(Number(line.variantId))) {
+      return { error: { code: "invalid_payload", message: `Line ${line.clientLineId} has no WooCommerce product id.` } };
+    }
+  }
+  const digits = p.display?.exponent ?? minorUnitDigits(p.currency);
+  const major = (minor) => (minor / 10 ** digits).toFixed(digits);
+  const cash = p.payments[0].method === "cash";
+  return { payload: {
+    status: "completed",
+    set_paid: true,
+    currency: p.currency,
+    payment_method: cash ? "pos_cash" : "pos_card",
+    payment_method_title: cash ? "Cash" : "Card",
+    line_items: p.lines.map((line) => ({
+      product_id: Number(line.variantId),
+      quantity: line.quantity,
+      subtotal: major(line.unitPriceMinor * line.quantity),
+      total: major(line.unitPriceMinor * line.quantity - (line.discountMinor ?? 0))
+    })),
+    meta_data: [{ key: "_woocommerce_pos_uuid", value: p.clientOrderId }],
+    ...p.customer?.customerId && /^\d+$/.test(p.customer.customerId) ? { customer_id: Number(p.customer.customerId) } : {},
+    ...p.customer?.email ? { billing: { email: p.customer.email } } : {}
+  } };
+}
+function createWooCommandTransport(options) {
+  const fetch2 = options.fetch ?? globalThis.fetch;
+  let baseUrl = options.baseUrl;
+  while (baseUrl.endsWith("/")) baseUrl = baseUrl.slice(0, -1);
+  return {
+    async send(batch) {
+      const results = [];
+      for (const envelope of batch) {
+        const mapped = toWooOrderPayload(envelope);
+        if ("error" in mapped) {
+          results.push({ id: envelope.id, status: "rejected", error: mapped.error });
+          continue;
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? 3e4);
+        let outcome;
+        try {
+          const response = await fetch2(`${baseUrl}/push/orders`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...await options.getHeaders() },
+            body: JSON.stringify({
+              mutationId: envelope.id,
+              operation: "create",
+              collection: "orders",
+              recordId: envelope.payload.clientOrderId,
+              baseRevision: null,
+              payload: mapped.payload
+            }),
+            signal: controller.signal
+          });
+          const status = response.status;
+          const retryAfter = response.headers.get("Retry-After");
+          const seconds = retryAfter === null ? NaN : Number(retryAfter);
+          const retry = (reason) => ({
+            kind: "retry",
+            reason,
+            ...Number.isFinite(seconds) && seconds >= 0 ? { retryAfterMs: seconds * 1e3 } : {}
+          });
+          if (status === 401) outcome = { kind: "unauthorized" };
+          else if (![200, 201, 400, 422, 403, 413, 415].includes(status)) outcome = retry(`status_${status}`);
+          else {
+            let body;
+            try {
+              body = await response.json();
+            } catch {
+            }
+            if (status === 200 || status === 201) {
+              const doc = body?.document;
+              const totalMinor = wooMinorFromDecimal(String(doc?.total), envelope.payload.currency);
+              if (doc?.id == null || totalMinor === void 0) {
+                outcome = retry(controller.signal.aborted ? "timeout" : "bad_body");
+              } else {
+                results.push({ id: envelope.id, status: "applied", serverRefs: {
+                  orderId: String(doc.id),
+                  displayId: String(doc.number ?? doc.id),
+                  totalMinor
+                }, ...totalMinor !== envelope.payload.totalMinor ? { warnings: [{
+                  code: "total_mismatch",
+                  expectedMinor: envelope.payload.totalMinor,
+                  serverMinor: totalMinor
+                }] } : {} });
+                continue;
+              }
+            } else if (status === 400 || status === 422) {
+              results.push({ id: envelope.id, status: "rejected", error: {
+                code: status === 400 && body?.code === "wcpos_insufficient_stock" ? "insufficient_stock" : "invalid_payload",
+                message: body?.message ?? `status_${status}`
+              } });
+              continue;
+            } else {
+              outcome = { kind: "refused", status, reason: body?.message ?? body?.code ?? `status_${status}` };
+            }
+          }
+        } catch {
+          outcome = { kind: "retry", reason: controller.signal.aborted ? "timeout" : "network" };
+        } finally {
+          clearTimeout(timeout);
+        }
+        return results.length ? { kind: "results", results } : outcome;
+      }
+      return { kind: "results", results };
+    }
+  };
+}
 
 // src/index.ts
 import { ConnectorUnauthorizedError as ConnectorUnauthorizedError3 } from "@tallyui/core";
@@ -594,7 +807,9 @@ export {
   WooMissingUuidError,
   WooTillUpdateRequiredError,
   WooTokenRefusedError,
+  createWooCommandTransport,
   createWooCommerceConnector,
+  toWooOrderPayload,
   wcposClientPart,
   wooCatalogueReconcile,
   wooProductReplication,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/connector-woocommerce",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "type": "module",
   "description": "WooCommerce connector for Tally UI",
   "main": "./dist/index.js",
@@ -26,10 +26,10 @@
     "directory": "connectors/woocommerce"
   },
   "peerDependencies": {
-    "@tallyui/core": "^3.0.1"
+    "@tallyui/core": "^3.0.3"
   },
   "devDependencies": {
-    "@tallyui/database": "3.0.1",
+    "@tallyui/database": "3.0.3",
     "rxdb": "17.5.0"
   },
   "scripts": {

package/src/commands/transport.ts

@@ -0,0 +1,126 @@
+// ADR-073; M3-spike-paid-push.md proves paid order pushes against WCPOS 1.10.20.
+import { minorUnitDigits, moneyFromDecimalString, moneyFromMajor, type CommandResult, type OrderCreateEnvelope } from '@tallyui/core';
+
+export type WooTransportOutcome =
+  | { kind: 'results'; results: CommandResult[] }
+  | { kind: 'unauthorized' }
+  | { kind: 'refused'; status: number; reason: string }
+  | { kind: 'retry'; reason: string; retryAfterMs?: number };
+
+export interface WooCommandTransportOptions {
+  baseUrl: string;
+  getHeaders: () => Record<string, string> | Promise<Record<string, string>>;
+  fetch?: typeof fetch;
+  timeoutMs?: number;
+}
+
+export function wooMinorFromDecimal(text: string, currency: string): number | undefined {
+  const trimmed = text.trim();
+  if (!/^\d+(\.\d+)?$/.test(trimmed)) return undefined;
+  const digits = minorUnitDigits(currency);
+  const [whole, fraction = ''] = trimmed.split('.');
+  let end = fraction.length;
+  while (end > digits && fraction[end - 1] === '0') end--;
+  if (end > digits) return moneyFromMajor(trimmed, currency)?.amount;
+  return moneyFromDecimalString(end ? `${whole}.${fraction.slice(0, end)}` : whole, currency)?.amount;
+}
+
+export function toWooOrderPayload(envelope: OrderCreateEnvelope): { payload: Record<string, unknown> } | { error: { code: string; message: string } } {
+  const p = envelope.payload;
+  if (p.pricesIncludeTax || p.lines.some((line) => line.taxInclusive === true)) {
+    return { error: { code: 'unsupported_tax_mode', message: 'Prices that include tax are not supported for WooCommerce yet.' } };
+  }
+  if (p.payments.length !== 1) {
+    return { error: { code: 'invalid_payload', message: 'WooCommerce orders take one payment.' } };
+  }
+  for (const line of p.lines) {
+    if (!/^[1-9]\d*$/.test(line.variantId) || !Number.isSafeInteger(Number(line.variantId))) {
+      return { error: { code: 'invalid_payload', message: `Line ${line.clientLineId} has no WooCommerce product id.` } };
+    }
+  }
+  const digits = p.display?.exponent ?? minorUnitDigits(p.currency);
+  const major = (minor: number) => (minor / 10 ** digits).toFixed(digits);
+  const cash = p.payments[0].method === 'cash';
+  return { payload: {
+    status: 'completed', set_paid: true, currency: p.currency,
+    payment_method: cash ? 'pos_cash' : 'pos_card', payment_method_title: cash ? 'Cash' : 'Card',
+    line_items: p.lines.map((line) => ({
+      product_id: Number(line.variantId), quantity: line.quantity,
+      subtotal: major(line.unitPriceMinor * line.quantity),
+      total: major(line.unitPriceMinor * line.quantity - (line.discountMinor ?? 0)),
+    })),
+    meta_data: [{ key: '_woocommerce_pos_uuid', value: p.clientOrderId }],
+    ...(p.customer?.customerId && /^\d+$/.test(p.customer.customerId) ? { customer_id: Number(p.customer.customerId) } : {}),
+    ...(p.customer?.email ? { billing: { email: p.customer.email } } : {}),
+  } };
+}
+
+export function createWooCommandTransport(options: WooCommandTransportOptions): { send(batch: OrderCreateEnvelope[]): Promise<WooTransportOutcome> } {
+  const fetch = options.fetch ?? globalThis.fetch;
+  let baseUrl = options.baseUrl;
+  while (baseUrl.endsWith('/')) baseUrl = baseUrl.slice(0, -1);
+  return {
+    async send(batch) {
+      const results: CommandResult[] = [];
+      for (const envelope of batch) {
+        const mapped = toWooOrderPayload(envelope);
+        if ('error' in mapped) {
+          results.push({ id: envelope.id, status: 'rejected', error: mapped.error });
+          continue;
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? 30000);
+        let outcome: WooTransportOutcome;
+        try {
+          const response = await fetch(`${baseUrl}/push/orders`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...await options.getHeaders() },
+            body: JSON.stringify({ mutationId: envelope.id, operation: 'create', collection: 'orders',
+              recordId: envelope.payload.clientOrderId, baseRevision: null, payload: mapped.payload }),
+            signal: controller.signal,
+          });
+          const status = response.status;
+          const retryAfter = response.headers.get('Retry-After');
+          const seconds = retryAfter === null ? NaN : Number(retryAfter);
+          const retry = (reason: string): WooTransportOutcome => ({ kind: 'retry', reason,
+            ...(Number.isFinite(seconds) && seconds >= 0 ? { retryAfterMs: seconds * 1000 } : {}),
+          });
+          if (status === 401) outcome = { kind: 'unauthorized' };
+          else if (![200, 201, 400, 422, 403, 413, 415].includes(status)) outcome = retry(`status_${status}`);
+          else {
+            let body;
+            try { body = await response.json(); } catch {}
+            if (status === 200 || status === 201) {
+              const doc = body?.document;
+              const totalMinor = wooMinorFromDecimal(String(doc?.total), envelope.payload.currency);
+              if (doc?.id == null || totalMinor === undefined) {
+                outcome = retry(controller.signal.aborted ? 'timeout' : 'bad_body');
+              } else {
+                results.push({ id: envelope.id, status: 'applied', serverRefs: {
+                  orderId: String(doc.id), displayId: String(doc.number ?? doc.id), totalMinor,
+                }, ...(totalMinor !== envelope.payload.totalMinor ? { warnings: [{
+                  code: 'total_mismatch' as const, expectedMinor: envelope.payload.totalMinor, serverMinor: totalMinor,
+                }] } : {}) });
+                continue;
+              }
+            } else if (status === 400 || status === 422) {
+              results.push({ id: envelope.id, status: 'rejected', error: {
+                code: status === 400 && body?.code === 'wcpos_insufficient_stock' ? 'insufficient_stock' : 'invalid_payload',
+                message: body?.message ?? `status_${status}`,
+              } });
+              continue;
+            } else {
+              outcome = { kind: 'refused', status, reason: body?.message ?? body?.code ?? `status_${status}` };
+            }
+          }
+        } catch {
+          outcome = { kind: 'retry', reason: controller.signal.aborted ? 'timeout' : 'network' };
+        } finally {
+          clearTimeout(timeout);
+        }
+        return results.length ? { kind: 'results', results } : outcome;
+      }
+      return { kind: 'results', results };
+    },
+  };
+}

package/src/index.ts

@@ -115,6 +115,7 @@ const wooConnectorParts = {
 export const woocommerceConnector: TallyConnector = createWooCommerceConnector();
 
 // Re-export pieces for advanced usage
+export { createWooCommandTransport, toWooOrderPayload, type WooCommandTransportOptions } from './commands/transport';
 export { ConnectorUnauthorizedError } from '@tallyui/core';
 export { wooProductSchema } from './schemas/products';
 export { wooProductTraits } from './traits/product';

package/src/replication/products.ts

@@ -13,7 +13,7 @@ export type WooProductCheckpoint = {
 };
 
 // RxDB drops the checkpoint of an empty result, so the handler moves on to the next useful request
-// in the same call instead; every fetch in one call, mark requests included, counts against this.
+// in the same call instead; product and mark requests in one call count against this.
 const MAX_REQUESTS_PER_CALL = 4;
 
 /** The most of a foreign 426's message kept in the error, so a store's long page never floods the log; longer is cut with "…". */
@@ -83,6 +83,16 @@ export function wooProductBarcode(product: any): string | undefined {
   return undefined;
 }
 
+export function toVariationDocument(payload: any) {
+  const { id, sku, price, regular_price, sale_price, on_sale, stock_status,
+    stock_quantity, manage_stock, status, purchasable } = payload;
+  return Object.fromEntries(Object.entries({
+    id, sku, barcode: wooProductBarcode(payload), price, regular_price, sale_price, on_sale,
+    stock_status, stock_quantity, manage_stock, status, purchasable,
+    attributes: (payload.attributes ?? []).map(({ name, option }: any) => ({ name, option })),
+  }).filter(([, value]) => value !== undefined));
+}
+
 /**
  * One product row as the till stores it, the rule the pull and the reconcile feed share: a uuid is
  * required (WooMissingUuidError), and a product that is not published arrives deleted (#229).
@@ -205,6 +215,29 @@ export const wooProductReplication: ReplicationAdapter<any, WooProductCheckpoint
         return document;
       });
 
+      const variableProducts = documents.filter((doc) => doc.type === 'variable' && !doc._deleted);
+      const variationIds = variableProducts.flatMap((doc) => doc.variations ?? []);
+      const variations = new Map<number, ReturnType<typeof toVariationDocument>[]>();
+      // Hydration requests complete the page already fetched, outside MAX_REQUESTS_PER_CALL.
+      for (let i = 0; i < variationIds.length; i += 100) {
+        const chunk = variationIds.slice(i, i + 100);
+        const variationParams = new URLSearchParams({ include: chunk.join(','), per_page: String(chunk.length), orderby: 'id', order: 'asc' });
+        const response = await fetch(`${context.baseUrl}/variations?${variationParams}`, {
+          headers: { ...context.headers, 'Content-Type': 'application/json' }, signal: context.signal,
+        });
+        await checkResponse(response);
+        const body = await response.json();
+        for (const doc of body.documents) {
+          const parentId = doc.parent_id ?? doc.payload.parent_id;
+          const group = variations.get(parentId) ?? [];
+          group.push(toVariationDocument(doc.payload));
+          variations.set(parentId, group);
+        }
+      }
+      for (const doc of variableProducts) {
+        doc.variation_docs = (variations.get(doc.id) ?? []).sort((a, b) => a.id - b.id);
+      }
+
       // RxDB merges checkpoints, so clear pass state explicitly at completion.
       const complete = count === undefined ? products.length < batchSize : offset + products.length >= count;
       const checkpoint: WooProductCheckpoint = complete

package/src/schemas/products.ts

@@ -7,7 +7,7 @@ import type { RxJsonSchema } from 'rxdb';
  */
 export const wooProductSchema: RxJsonSchema<any> = {
   title: 'WooCommerce Product',
-  version: 0,
+  version: 1,
   type: 'object',
   primaryKey: 'uuid',
   properties: {
@@ -130,6 +130,14 @@ export const wooProductSchema: RxJsonSchema<any> = {
       type: 'array',
       items: { type: 'integer' },
     },
+    // Embedded from wcpos/v2/variations; WCPOS 1.10.x has no per-product route.
+    variation_docs: { type: 'array', items: { type: 'object', properties: {
+      id: { type: 'integer' }, sku: { type: 'string' }, barcode: { type: 'string' },
+      price: { type: 'string' }, regular_price: { type: 'string' }, sale_price: { type: 'string' },
+      on_sale: { type: 'boolean' }, stock_status: { type: 'string' }, stock_quantity: { type: ['number', 'null'] },
+      manage_stock: { type: 'boolean' }, status: { type: 'string' }, purchasable: { type: 'boolean' },
+      attributes: { type: 'array', items: { type: 'object', properties: { name: { type: 'string' }, option: { type: 'string' } } } },
+    } } },
     meta_data: {
       type: 'array',
       items: {

package/src/traits/product.ts

@@ -64,6 +64,23 @@ export const wooProductTraits: ProductTraits = {
 
   hasVariants: (doc) => doc.type === 'variable',
 
+  // Variable products carry their synced variations for synchronous, offline traits.
+  getVariants: (doc, context) => doc.type === 'variable' ? (doc.variation_docs ?? [])
+    .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,
+      sku: v.sku || undefined,
+      barcode: v.barcode || undefined,
+      prices: wooProductTraits.getPrices(v, context),
+      stock: wooProductTraits.getStock(v),
+    })) : [{
+    id: String(doc.id),
+    sku: doc.sku || undefined,
+    barcode: wooProductBarcode(doc),
+    prices: wooProductTraits.getPrices(doc, context),
+    stock: wooProductTraits.getStock(doc),
+  }],
+
   isSellable: (doc) => doc.status === undefined || doc.status === 'publish',
 
   getVariantCount: (doc) => doc.type === 'variable' ? doc.variations?.length ?? 0 : 1,