@wix/agent-skills 1.36.0 → 1.36.1

package/skills/wix-replatform/resources/rp-target-wix/lib/stores-verification.js

@@ -1,321 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const w = require('./wix-writers');
-const verification = require('./write-verification');
-
-const DEFAULT_VERIFIED_SUBSCRIPTION_PATHS = [
-  'product.subscriptionDetails',
-  'product.subscriptionDetails.allowOneTimePurchases',
-  'product.subscriptionDetails.subscriptions[]',
-  'product.subscriptionDetails.subscriptions[].id',
-  'product.subscriptionDetails.subscriptions[].title',
-  'product.subscriptionDetails.subscriptions[].description',
-  'product.subscriptionDetails.subscriptions[].frequency',
-  'product.subscriptionDetails.subscriptions[].interval',
-  'product.subscriptionDetails.subscriptions[].autoRenewal',
-];
-
-function timestamp() {
-  return new Date().toISOString();
-}
-
-function defaultProbeProduct({ marker, name } = {}) {
-  const suffix = marker || `rp-probe-${Date.now()}`;
-  return {
-    name: name || `RePlatform subscription probe ${suffix}`,
-    productType: 'PHYSICAL',
-    visible: false,
-    sku: suffix,
-    price: { actualPrice: { amount: '1.00' } },
-    subscriptionDetails: {
-      allowOneTimePurchases: true,
-      subscriptions: [{
-        title: 'Monthly delivery',
-        description: 'Ships every month',
-        frequency: 'MONTH',
-        interval: 1,
-        autoRenewal: true,
-      }],
-    },
-  };
-}
-
-function artifactBase({ command, siteId, endpoint, method }) {
-  return {
-    schemaVersion: 1,
-    command,
-    targetSiteIdentifier: siteId || null,
-    endpoint,
-    method,
-    status: 'unknown',
-    verifiedPaths: [],
-    constraintsDiscovered: [],
-    probeRecordId: null,
-    cleanup: { attempted: false, status: 'not_applicable' },
-    warnings: [],
-    recoveryInstructions: [],
-    timestamp: timestamp(),
-  };
-}
-
-function valueAtPath(root, pathExpr) {
-  const parts = String(pathExpr).split('.');
-  let values = [root];
-  for (const part of parts) {
-    const arrayPart = part.endsWith('[]') ? part.slice(0, -2) : null;
-    const key = arrayPart || part;
-    const next = [];
-    for (const value of values) {
-      if (!value || typeof value !== 'object') continue;
-      const child = value[key];
-      if (arrayPart) {
-        if (Array.isArray(child)) next.push(...child);
-      } else {
-        next.push(child);
-      }
-    }
-    values = next;
-  }
-  return values.filter((value) => value !== undefined && value !== null);
-}
-
-function verifyPaths(root, paths) {
-  return paths.map((pathExpr) => ({
-    path: pathExpr,
-    present: valueAtPath(root, pathExpr).length > 0,
-  }));
-}
-
-function queryFilterByMarker({ markerPath, markerValue }) {
-  if (!markerPath || markerValue == null) {
-    throw new Error('product-by-source-marker requires --marker-path and --marker-value');
-  }
-  return {
-    filter: { [markerPath]: { $eq: markerValue } },
-    paging: { limit: 100, offset: 0 },
-  };
-}
-
-async function writeArtifact(file, result) {
-  if (!file) return result;
-  fs.mkdirSync(path.dirname(file), { recursive: true });
-  fs.writeFileSync(file, `${JSON.stringify(result, null, 2)}\n`);
-  return result;
-}
-
-async function verifyStoresSubscriptionCreate({ wix, siteId, artifactPath, probeProduct, marker, cleanup = true } = {}) {
-  const createRequest = w.buildCreateStoresProductRequest(probeProduct || defaultProbeProduct({ marker }));
-  const artifact = artifactBase({
-    command: 'stores subscription-create',
-    siteId,
-    endpoint: createRequest.url,
-    method: createRequest.method,
-  });
-
-  let createdProduct;
-  try {
-    const expected = verification.subscriptionExpected(createRequest.body.product);
-    createdProduct = (await wix.send(createRequest)).product;
-    artifact.probeRecordId = createdProduct && createdProduct.id;
-    if (!require('./bulk-results').opaqueId(artifact.probeRecordId) || createdProduct._dryRunPlaceholder) throw new Error('create response did not include a live product.id');
-    artifact.valueEvidence = { expected, targetId: artifact.probeRecordId, actual: null };
-    await writeArtifact(artifactPath, artifact);
-
-    const getRequest = w.buildGetStoresProductRequest(artifact.probeRecordId);
-    artifact.readback = { endpoint: getRequest.url, method: getRequest.method };
-    const readProduct = (await wix.send(getRequest)).product;
-    artifact.verifiedPaths = verifyPaths({ product: readProduct }, DEFAULT_VERIFIED_SUBSCRIPTION_PATHS);
-    artifact.constraintsDiscovered = w.STORES_SUBSCRIPTION_CONTRACT.constraints.map((constraint) => ({ ...constraint }));
-    artifact.valueEvidence.actual = readProduct;
-    artifact.comparison = verification.verifySubscriptionEvidence(artifact.valueEvidence);
-    artifact.status = artifact.comparison.verified ? 'passed' : 'failed';
-    if (artifact.status === 'failed') {
-      artifact.warnings.push('Subscription readback identity or values do not match the submitted product.');
-    }
-  } catch (error) {
-    artifact.status = 'failed';
-    artifact.error = error && error.message ? error.message : String(error);
-  } finally {
-    if (cleanup && artifact.probeRecordId) {
-      artifact.cleanup.attempted = true;
-      artifact.cleanup.endpoint = w.buildDeleteStoresProductRequest(artifact.probeRecordId).url;
-      artifact.cleanup.method = 'DELETE';
-      try {
-        await wix.send(w.buildDeleteStoresProductRequest(artifact.probeRecordId));
-        artifact.cleanup.status = 'deleted';
-      } catch (error) {
-        artifact.cleanup.status = 'failed';
-        artifact.cleanup.error = error && error.message ? error.message : String(error);
-        artifact.warnings.push(`Probe product cleanup failed for ${artifact.probeRecordId}.`);
-        artifact.recoveryInstructions.push(
-          `Delete probe product ${artifact.probeRecordId} from Wix Stores or run: verify stores delete-probe --product-id ${artifact.probeRecordId}`,
-        );
-      }
-    }
-  }
-
-  return writeArtifact(artifactPath, artifact);
-}
-
-async function verifyStoresProductCount({ wix, siteId, artifactPath, query = { paging: { limit: 1, offset: 0 } } } = {}) {
-  const request = w.buildQueryStoresProductsRequest(query);
-  const artifact = artifactBase({
-    command: 'stores product-count',
-    siteId,
-    endpoint: request.url,
-    method: request.method,
-  });
-  try {
-    const response = await wix.send(request);
-    const products = response.products || [];
-    artifact.count = Number.isInteger(response.totalCount) ? response.totalCount : products.length;
-    artifact.status = 'passed';
-  } catch (error) {
-    artifact.status = 'failed';
-    artifact.error = error && error.message ? error.message : String(error);
-  }
-  return writeArtifact(artifactPath, artifact);
-}
-
-async function verifyStoresProductBySourceMarker({ wix, siteId, artifactPath, markerPath, markerValue } = {}) {
-  const query = queryFilterByMarker({ markerPath, markerValue });
-  const request = w.buildQueryStoresProductsRequest(query);
-  const artifact = artifactBase({
-    command: 'stores product-by-source-marker',
-    siteId,
-    endpoint: request.url,
-    method: request.method,
-  });
-  artifact.marker = { path: markerPath, value: markerValue };
-  try {
-    const response = await wix.send(request);
-    artifact.products = (response.products || []).map((product) => ({
-      id: product.id,
-      name: product.name,
-      slug: product.slug,
-      revision: product.revision,
-    }));
-    artifact.count = artifact.products.length;
-    artifact.status = 'passed';
-  } catch (error) {
-    artifact.status = 'failed';
-    artifact.error = error && error.message ? error.message : String(error);
-  }
-  return writeArtifact(artifactPath, artifact);
-}
-
-async function verifyStoresDeleteProbe({ wix, siteId, artifactPath, productId } = {}) {
-  if (!productId) throw new Error('delete-probe requires --product-id');
-  const request = w.buildDeleteStoresProductRequest(productId);
-  const artifact = artifactBase({
-    command: 'stores delete-probe',
-    siteId,
-    endpoint: request.url,
-    method: request.method,
-  });
-  artifact.probeRecordId = productId;
-  artifact.cleanup = { attempted: true, endpoint: request.url, method: request.method, status: 'unknown' };
-  try {
-    await wix.send(request);
-    artifact.cleanup.status = 'deleted';
-    artifact.status = 'passed';
-  } catch (error) {
-    artifact.cleanup.status = 'failed';
-    artifact.status = 'failed';
-    artifact.error = error && error.message ? error.message : String(error);
-    artifact.warnings.push(`Probe product cleanup failed for ${productId}.`);
-    artifact.recoveryInstructions.push(`Delete probe product ${productId} manually in Wix Stores and keep this artifact with the cleanup evidence.`);
-  }
-  return writeArtifact(artifactPath, artifact);
-}
-
-// Runs only against an explicitly selected, already-muted test target. All products are
-// synthetic and hidden. The artifact is saved as IDs are acquired so cleanup is recoverable.
-async function verifyStoresInventoryImport({ wix, siteId, artifactPath } = {}) {
-  const inventory = require('./stores-inventory.js');
-  const build = require('./wix-build.js');
-  const artifact = artifactBase({ command: 'stores inventory-import', siteId, endpoint: '/stores/v3/bulk/inventory-items/create', method: 'POST' });
-  artifact.probeProductIds = [];
-  artifact.checks = [];
-  let stockWrites = 0;
-  const client = wix;
-  wix = { ...client, send(request) {
-    if (request.method !== 'GET' && /\/inventory-items(?:\/|$)/.test(request.url) && !request.url.endsWith('/query')) stockWrites++;
-    return client.send(request);
-  } };
-  const check = (name, passed, detail) => {
-    artifact.checks.push({ name, passed, detail });
-    writeArtifact(artifactPath, artifact);
-    if (!passed) throw new Error(`Inventory probe failed: ${name}`);
-  };
-  const marker = `inventory-probe-${Date.now()}`;
-  const payload = (index, stock) => build.buildProduct({ name: `${marker}-${index}`, visible: false, productType: 'PHYSICAL', variants: [{ price: 1, ...(stock || {}) }] });
-  try {
-    const mute = await w.getSiteMuteState(wix);
-    if (!mute || mute.muted !== true) throw new Error('Inventory probe requires an already-muted disposable test target');
-    const locationId = await inventory.resolveInventoryLocation(wix);
-    const rows = [];
-    for (const [index, state] of [{ inStock: true }, { inStock: false }, { quantity: 0 }, { quantity: 7 }].entries()) {
-      const product = await w.createStoresProduct(wix, payload(index));
-      if (!product || !product.id) throw new Error('Probe product create returned no identity');
-      artifact.probeProductIds.push(product.id); writeArtifact(artifactPath, artifact);
-      const variants = product.variantsInfo && product.variantsInfo.variants;
-      if (!Array.isArray(variants) || variants.length !== 1 || !variants[0].id) throw new Error('Probe product did not return one variant identity');
-      rows.push({ productId: product.id, variantId: variants[0].id, inventory: state });
-    }
-    const created = await inventory.reconcileInventory(wix, rows, { locationId, expectedCount: 4, verifyAttempts: 5 });
-    check('mixed stock create and read-back', created.complete && created.counts.created === 4, created);
-    const changed = rows.map((r, i) => ({ ...r, inventory: i % 2 ? { inStock: false } : { quantity: 3 } }));
-    const updated = await inventory.reconcileInventory(wix, changed, { locationId, expectedCount: 4, verifyAttempts: 5 });
-    check('revisioned updates and tracking-mode changes', updated.complete && updated.counts.updated === 3, updated);
-    const beforeRerun = stockWrites;
-    const rerun = await inventory.reconcileInventory(wix, changed, { locationId, expectedCount: 4 });
-    check('matching rerun performs no stock writes', rerun.complete && rerun.counts.reconciled === 4 && stockWrites === beforeRerun, { ...rerun, observedStockWrites: stockWrites - beforeRerun });
-    const singleProduct = await w.createStoresProduct(wix, payload('single'));
-    if (!singleProduct || !singleProduct.id) throw new Error('Single probe missing product identity');
-    artifact.probeProductIds.push(singleProduct.id); writeArtifact(artifactPath, artifact);
-    const singleRow = { productId: singleProduct.id, variantId: singleProduct.variantsInfo.variants[0].id, inventory: { inStock: false } };
-    await w.createInventoryItem(wix, { productId: singleRow.productId, variantId: singleRow.variantId, inStock: false, trackQuantity: false });
-    const single = await inventory.reconcileInventory(wix, [singleRow], { locationId, expectedCount: 1 });
-    check('single-create helper and read-back', single.complete && single.counts.reconciled === 1, single);
-    const bulk = await w.bulkCreateStoresProductsWithInventory(wix, [payload('inline-false', { inStock: false }), payload('inline-quantity', { inventoryTracked: true, inventoryQuantity: 5 })], { returnEntity: true });
-    for (const result of bulk.results) if (result.success && result.productId) artifact.probeProductIds.push(result.productId);
-    writeArtifact(artifactPath, artifact);
-    check('inline bulk product creation', bulk.succeeded.length === 2 && bulk.unaccounted === 0, { successes: bulk.succeeded.length, unaccounted: bulk.unaccounted });
-    const inlineRows = bulk.succeeded.map((r) => {
-      const variants = r.product && r.product.variantsInfo && r.product.variantsInfo.variants;
-      if (!variants || variants.length !== 1 || !variants[0].id) throw new Error('Inline probe missing variant identity');
-      return { productId: r.productId, variantId: variants[0].id, inventory: r.inputProduct.variantsInfo.variants[0].inventoryItem };
-    });
-    const inline = await inventory.reconcileInventory(wix, inlineRows, { locationId, expectedCount: 2 });
-    check('inline stock persisted without repair', inline.complete && inline.counts.reconciled === 2, inline);
-    artifact.status = 'passed';
-  } catch (error) { artifact.status = 'failed'; artifact.error = error.message; }
-  finally {
-    artifact.cleanup = { attempted: artifact.probeProductIds.length > 0, status: artifact.probeProductIds.length ? 'deleted' : 'not_applicable', failedProductIds: [] };
-    for (const id of artifact.probeProductIds) {
-      try { await w.deleteStoresProduct(wix, id); }
-      catch (_) { artifact.cleanup.failedProductIds.push(id); }
-    }
-    if (artifact.cleanup.failedProductIds.length) {
-      artifact.cleanup.status = 'failed'; artifact.status = 'failed';
-      artifact.recoveryInstructions.push('Delete only the probe product IDs listed in cleanup.failedProductIds.');
-    }
-  }
-  return writeArtifact(artifactPath, artifact);
-}
-
-module.exports = {
-  DEFAULT_VERIFIED_SUBSCRIPTION_PATHS,
-  defaultProbeProduct,
-  queryFilterByMarker,
-  valueAtPath,
-  verifyPaths,
-  verifyStoresSubscriptionCreate,
-  verifyStoresProductCount,
-  verifyStoresProductBySourceMarker,
-  verifyStoresDeleteProbe,
-  verifyStoresInventoryImport,
-};

package/skills/wix-replatform/resources/rp-target-wix/lib/tax-build.js

@@ -1,231 +0,0 @@
-'use strict';
-
-const { isBlank } = require('./value-utils.js');
-
-// rp-target-wix — the DETERMINISTIC WooCommerce tax-rate -> Wix Tax payload builder.
-//
-// Mirrors wix-build.js's role for Stores products: everything here implements, as plain code,
-// the mapping rules already recorded as prose in domains/tax/{domain.json,entities/*.json}. Do
-// not re-derive these rules by LLM judgement per project — read them here, and if a rule changes,
-// change it here and in the domain JSON's mappingGuidance together, since they must stay the same
-// fact stated twice (once for humans, once as code).
-//
-// Scope: Tax Groups / Tax Regions / Manual Tax Mappings only. Tax Settings is a single
-// site-level upsert (see domains/tax/entities/tax-settings.json) with no payload-shaping
-// logic worth a builder — just a boolean passthrough.
-
-// ISO 3166-1 alpha-2 countries Wix accepts a `subdivision` for (dev.wix.com Tax Region object,
-// verified live 2026-08-12). Any other country must omit subdivision (or pass '*').
-const SUBDIVISION_ELIGIBLE_COUNTRIES = new Set([
-  'AU', 'BR', 'CA', 'FR', 'DE', 'IN', 'IT', 'MX', 'NL', 'PT', 'ES', 'AE', 'GB', 'US',
-]);
-
-// Countries Tax Region create rejects outright (dev.wix.com, "embargoed-countries-rejected").
-const EMBARGOED_COUNTRIES = new Set(['CU', 'IR', 'KP', 'SY']);
-
-// WooCommerce's `state` column format varies by version/site — sometimes bare ("NY"), sometimes
-// country-prefixed ("US-NY"). Wix stores ISO 3166-2 WITHOUT the country prefix. Never invent a
-// subdivision for a country outside the eligible set — pass none (country-level region) instead.
-function normalizeSubdivision(country, rawState) {
-  const countryCode = String(country || '').trim().toUpperCase();
-  if (isBlank(rawState)) return undefined;
-  if (!SUBDIVISION_ELIGIBLE_COUNTRIES.has(countryCode)) return undefined;
-  const raw = String(rawState).trim().toUpperCase();
-  const prefix = `${countryCode}-`;
-  return raw.startsWith(prefix) ? raw.slice(prefix.length) : raw;
-}
-
-// WooCommerce `rate` is a PERCENTAGE (e.g. "7.5000"). Wix `taxRate` is a decimal-string FRACTION
-// with at most 6 decimal places (e.g. "0.075"). A number, integer, or percent-string all 400.
-function toWixTaxRateFraction(percentage) {
-  const n = Number(percentage);
-  if (!Number.isFinite(n)) {
-    throw new Error(`toWixTaxRateFraction: "${percentage}" is not a finite number`);
-  }
-  let fixed = (n / 100).toFixed(6);
-  if (fixed.includes('.')) {
-    fixed = fixed.replace(/0+$/, '');
-    if (fixed.endsWith('.')) fixed += '0';
-  }
-  return fixed;
-}
-
-// One Wix Tax Region per distinct (country, subdivision) pair — a source can have several rate
-// rows (standard/reduced/zero) sharing one region, which fan out to separate Manual Tax Mappings
-// against that ONE region rather than one region each.
-function groupTaxRatesByRegion(taxRates) {
-  const regions = new Map();
-  for (const rate of taxRates || []) {
-    const country = String(rate.country || '').trim().toUpperCase();
-    if (!country) continue;
-    const subdivision = normalizeSubdivision(country, rate.state);
-    const key = taxRegionDedupeKey({ country, subdivision });
-    if (!regions.has(key)) {
-      regions.set(key, { country, subdivision, rates: [] });
-    }
-    regions.get(key).rates.push(rate);
-  }
-  return [...regions.values()];
-}
-
-function taxRegionDedupeKey({ country, subdivision }) {
-  return `${String(country || '').trim().toUpperCase()}|${subdivision || ''}`;
-}
-
-function isEmbargoedCountry(country) {
-  return EMBARGOED_COUNTRIES.has(String(country || '').trim().toUpperCase());
-}
-
-// `appId` must be resolved live per site via listTaxCalculators/resolveManualTaxCalculatorAppId
-// in wix-writers.js — never hardcoded here, since it's installation-scoped and differs per site.
-function buildTaxRegionInput({ country, subdivision }, { appId, taxIncludedInPrice = false }) {
-  if (!appId) throw new Error('buildTaxRegionInput: appId is required (resolve live, never hardcode)');
-  const taxRegion = { country: String(country).trim().toUpperCase(), appId, taxIncludedInPrice };
-  if (subdivision) taxRegion.subdivision = subdivision;
-  return taxRegion;
-}
-
-function buildTaxGroupInput({ name }) {
-  if (isBlank(name)) throw new Error('buildTaxGroupInput: name is required');
-  return { name: String(name).trim() };
-}
-
-// `taxGroupId`/`taxRegionId` must already exist — resolve both from their own crosswalks before
-// calling. `taxName` is cosmetic (shown at checkout) and never affects the calculated amount.
-function buildManualTaxMappingInput(rate, { taxGroupId, taxRegionId }) {
-  if (!taxGroupId) throw new Error('buildManualTaxMappingInput: taxGroupId is required');
-  if (!taxRegionId) throw new Error('buildManualTaxMappingInput: taxRegionId is required');
-  const mapping = {
-    taxGroupId,
-    taxRegionId,
-    taxRate: toWixTaxRateFraction(rate.rate),
-  };
-  if (!isBlank(rate.name)) mapping.taxName = String(rate.name).trim();
-  return mapping;
-}
-
-// Create Manual Tax Mapping 409s on a duplicate (taxRegionId, taxGroupId, taxName, taxType,
-// jurisdiction, jurisdictionType) — dedupe on that composite key before creating, since
-// WooCommerce rows differing only in `priority` (no Wix equivalent) would otherwise re-collide.
-//
-// LIVE-VERIFIED 2026-08-15: Query Manual Tax Mapping returns the STRING "UNDEFINED" for an unset
-// `jurisdictionType` (not "" and not the field's absence), while a freshly-built mappingInput that
-// never sets the field is plain JS `undefined` — so comparing a fetched mapping against a
-// newly-built one for the same (region, group) 409'd instead of correctly deduping. Normalize both
-// "" and "UNDEFINED" to the same bucket so a fetched existing mapping and a freshly-built one that
-// both mean "no jurisdictionType" produce the same key.
-function normalizeDedupeField(value) {
-  const s = String(value || '').trim();
-  return s === 'UNDEFINED' ? '' : s;
-}
-function manualTaxMappingDedupeKey({ taxRegionId, taxGroupId, taxName, taxType, jurisdiction, jurisdictionType }) {
-  return [
-    taxRegionId,
-    taxGroupId,
-    normalizeDedupeField(taxName),
-    normalizeDedupeField(taxType),
-    normalizeDedupeField(jurisdiction),
-    normalizeDedupeField(jurisdictionType),
-  ].join('|');
-}
-
-// The four Wix "default" tax groups every site has (VERIFIED live 2026-08-12 via
-// List Default Tax Groups: "Shipping and delivery", "Products", "Services", "Cancellation
-// fees" — see tax-group.json's query-tax-groups-excludes-defaults pitfall). WooCommerce has no
-// equivalent split: a `class: "standard"` rate (or a blank class) is the store's ONE general
-// rate, not a products-only rate — WooCommerce's own `shipping` boolean on a tax rate row
-// exists specifically because the rate is meant to reach beyond products. Wix's
-// Products/Shipping and delivery/Services/Cancellation fees groups are BILLING categories, not
-// TAX-RATE categories, so mapping a standard rate to "Products" only silently zero-rates every
-// other category in that region — a group with no manual tax mapping calculates to EXACTLY
-// ZERO tax (VERIFIED live 2026-08-12, see manual-tax-mapping.json's
-// unmapped-tax-group-calculates-to-exactly-zero-tax finding). That is undercharging, not a
-// faithful migration, so a standard-class rate must get one mapping per default group.
-const DEFAULT_GROUP_NAMES = ['Products', 'Shipping and delivery', 'Services', 'Cancellation fees'];
-
-// Which already-created Wix tax groups a WooCommerce rate's Manual Tax Mapping(s) should
-// target. `defaultGroups` is List Default Tax Groups' result; `customGroups` is this project's
-// own created-group tracking, each carrying the `sourceTaxClass` it was created for (from
-// planCustomTaxGroups's plan — a plain Query Tax Groups result has no such field, since Wix
-// itself doesn't know why a custom group exists).
-//
-// A `standard` (or blank) class rate targets every DEFAULT group — never a class-specific
-// custom group (a reduced-rate/zero-rate group exists so a product TAGGED with that class gets
-// a different rate than the store's general one, not the same rate broadened everywhere), and
-// never the Tax Exempt group (no mapping is how exempt is represented at all — this falls out
-// naturally here since Tax Exempt's `sourceTaxClass` is null and no rate's class is ever null).
-// A non-standard class rate targets ONLY its own matching custom group.
-//
-// List Default Tax Groups' own schema (dev.wix.com, checked 2026-08-15) has no locale-invariant
-// key for "which billing category is this" — a TaxGroup is only {id, name, revision, dates}, and
-// the docs' own worked example returns a completely different default set ("Standard Tax") than
-// a live site returns, confirming `name` genuinely varies per site/locale and isn't a fixed
-// constant. `name` is matched here anyway because it's the ONLY field the API offers for this —
-// but matching zero (or some but not all four) of DEFAULT_GROUP_NAMES on a translated or
-// differently-configured site must never fall through to a silent partial fan-out: that would
-// reproduce the exact silent-undercharging bug this function exists to fix, just triggered by
-// site language/config instead of an incomplete implementation. Fail loudly instead, so a human
-// resolves the real name mismatch before any mapping is created.
-function groupsForRate(rate, { defaultGroups = [], customGroups = [] } = {}) {
-  const taxClass = String(rate?.class || 'standard').trim() || 'standard';
-  if (taxClass === 'standard') {
-    const matched = defaultGroups.filter((group) => DEFAULT_GROUP_NAMES.includes(String(group?.name || '').trim()));
-    if (matched.length !== DEFAULT_GROUP_NAMES.length) {
-      const foundNames = matched.map((group) => group.name);
-      const missing = DEFAULT_GROUP_NAMES.filter((name) => !foundNames.includes(name));
-      throw new Error(
-        `groupsForRate: expected all ${DEFAULT_GROUP_NAMES.length} default tax groups (${DEFAULT_GROUP_NAMES.join(', ')}), `
-        + `found only ${matched.length} (missing: ${missing.join(', ')}). This site's default tax group names may be `
-        + 'translated or otherwise non-standard -- resolve the real names via List Default Tax Groups before mapping, '
-        + 'do not silently map to a partial set.',
-      );
-    }
-    return matched;
-  }
-  return customGroups.filter((group) => group?.sourceTaxClass === taxClass);
-}
-
-// Only create a custom tax group when a real per-product signal exists — never speculatively,
-// just because wc/v3/taxes/classes lists WooCommerce's unused defaults (reduced-rate/zero-rate).
-// `products` here is the discovered wc/v3/products record shape (`tax_class`, `tax_status`).
-function planCustomTaxGroups(products) {
-  const plans = [];
-  const classesInUse = new Set();
-  let hasExempt = false;
-  for (const product of products || []) {
-    const taxClass = String(product.tax_class || 'standard').trim() || 'standard';
-    if (taxClass !== 'standard') classesInUse.add(taxClass);
-    if (String(product.tax_status || 'taxable').trim() === 'none') hasExempt = true;
-  }
-  for (const taxClass of classesInUse) {
-    plans.push({ name: taxClass, sourceTaxClass: taxClass, reason: 'non-default WooCommerce tax_class actually assigned to at least one product' });
-  }
-  if (hasExempt) {
-    plans.push({ name: 'Tax Exempt', sourceTaxClass: null, exempt: true, reason: 'at least one product has tax_status=none — dedicated group, deliberately no manual tax mapping in any region' });
-  }
-  return plans;
-}
-
-// "No source has any tax-rate rows" is the majority case — the
-// correct action is to create nothing speculative, not to pre-create empty regions/mappings.
-function shouldSkipTaxDomain(taxRates) {
-  return !Array.isArray(taxRates) || taxRates.length === 0;
-}
-
-module.exports = {
-  SUBDIVISION_ELIGIBLE_COUNTRIES,
-  EMBARGOED_COUNTRIES,
-  normalizeSubdivision,
-  toWixTaxRateFraction,
-  groupTaxRatesByRegion,
-  taxRegionDedupeKey,
-  isEmbargoedCountry,
-  buildTaxRegionInput,
-  buildTaxGroupInput,
-  buildManualTaxMappingInput,
-  manualTaxMappingDedupeKey,
-  DEFAULT_GROUP_NAMES,
-  groupsForRate,
-  planCustomTaxGroups,
-  shouldSkipTaxDomain,
-};

package/skills/wix-replatform/resources/rp-target-wix/lib/url-mapper-transport.js

@@ -1,28 +0,0 @@
-'use strict';
-
-const WRITER_ROOT = '/_api/url-mapper/writer/v1/url-mapping';
-
-function createUrlMapperTransport({ send, inspectDestination }) {
-  if (typeof send !== 'function' || typeof inspectDestination !== 'function') throw new Error('authenticated sender and destination inspection required');
-  return {
-    inspectDestination,
-    async read(key) {
-      const result = await send({ method: 'GET', path: `${WRITER_ROOT}/${encodeURIComponent(key)}` });
-      if (result && (result.code === 'URL_MAPPER_NOT_FOUND' || result.status === 404)) return null;
-      const mapping = result && (result.urlMapping || result.mappingRecord || result);
-      if (!mapping || typeof mapping.mapping !== 'string' || typeof mapping.pageIdentifier !== 'string') {
-        throw new Error(`URL Mapper read-back for ${key} lacks saved mapping or page identifier`);
-      }
-      return mapping;
-    },
-    async write(payload, capability, { mode }) {
-      if (!capability || payload.key !== capability.key || payload.urlMapping?.pageIdentifier !== capability.pageIdentifier) {
-        throw new Error('URL Mapper payload differs from capability knowledge');
-      }
-      if (!['create', 'update'].includes(mode)) throw new Error('URL Mapper write mode required');
-      return send({ method: mode === 'create' ? 'POST' : 'PUT', path: `${WRITER_ROOT}/${encodeURIComponent(payload.key)}`, body: payload });
-    },
-  };
-}
-
-module.exports = { WRITER_ROOT, createUrlMapperTransport };

package/skills/wix-replatform/resources/rp-target-wix/lib/value-utils.js

@@ -1,14 +0,0 @@
-'use strict';
-
-// Shared scalar-value helpers used across the rp-target-wix builders (tax-build.js,
-// shipping-build.js, gift-card-build.js, ...). Kept tiny and dependency-free on purpose — this is
-// not a general utils dumping ground, just the one helper that was independently duplicated
-// byte-for-byte in three builder files.
-
-function isBlank(value) {
-  return value == null || String(value).trim() === '';
-}
-
-module.exports = {
-  isBlank,
-};

package/skills/wix-replatform/resources/rp-target-wix/lib/variant-correlation.js

@@ -1,34 +0,0 @@
-'use strict';
-
-// Shared deterministic one-to-one comparison; response order is never an identity.
-function resolveInventoryRows(canonical, target) {
-  if (!target || !target.id || !Array.isArray(target.variantsInfo?.variants)) throw new Error('Target product omitted variant identities');
-  // Stores V3 may re-case option and choice names on write ("ALTERNATIV" reads back
-  // "Alternativ", "10m" reads back "10M"; LIVE-VERIFIED 2026-10-15), so names match
-  // case-insensitively. A case-only collision still fails below as an ambiguous match.
-  const key = (choices) => JSON.stringify(choices.map(c => [String(c.optionName).toLowerCase(), String(c.choiceName).toLowerCase()]).sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b))));
-  const targetByChoices = new Map();
-  for (const variant of target.variantsInfo.variants) {
-    if (!variant.id) throw new Error('Target variant omitted identity');
-    const choices = (variant.choices || []).map(c => {
-      if (c.optionChoiceNames) return c.optionChoiceNames;
-      const options = (target.options || []).filter(o => o.id === c.optionChoiceIds?.optionId);
-      if (options.length !== 1) throw new Error('Target option identity is missing or ambiguous');
-      const values = (options[0].choicesSettings?.choices || []).filter(v => v.choiceId === c.optionChoiceIds.choiceId);
-      if (values.length !== 1) throw new Error('Target choice identity is missing or ambiguous');
-      return { optionName: options[0].name, choiceName: values[0].name };
-    });
-    const identity = key(choices);
-    if (targetByChoices.has(identity)) throw new Error('Ambiguous target variant choices');
-    targetByChoices.set(identity, variant.id);
-  }
-  const matched = new Set();
-  return canonical.variants.map(variant => {
-    const variantId = targetByChoices.get(key(variant.choices));
-    if (!variantId || matched.has(variantId)) throw new Error('Source variant has no unique target match');
-    matched.add(variantId);
-    return { productId: target.id, variantId, inventory: { inStock: variant.inStock } };
-  });
-}
-
-module.exports = { resolveInventoryRows };