@base44/app-plugin-commerce 0.1.0

package/base44/functions/commerce/seed-store/entry.ts

@@ -0,0 +1,310 @@
+/**
+ * commerce/seed-store — idempotent store initialization.
+ *
+ * Flow: (1) canary schema validation (probe create+delete per entity; abort
+ * with 422 schema_incompatible and write nothing on any failure), (2) seed
+ * required defaults (settings groups, gateways, tax classes, fallback zone),
+ * (3) optional sample catalog (~12 products across every product type, with
+ * images and descriptions, plus three variable products with variants) — only
+ * when with_sample_data=true and the store has zero products, with best-effort
+ * rollback on mid-failure.
+ *
+ * Body: { with_sample_data?: boolean, store_name?: string }
+ *
+ * `store_name` is required on a first seed: a function's env is only
+ * BASE44_APP_ID, so it cannot read the app's name, and subjects need one.
+ */
+import { createClientFromRequest } from "npm:@base44/sdk";
+import { HttpError, requireAdmin } from "../../../shared/commerce/auth.ts";
+import { round2 } from "../../../shared/commerce/money.ts";
+import {
+  GATEWAY_DEFAULTS,
+  REST_OF_WORLD_EXAMPLE_METHOD,
+  REST_OF_WORLD_ZONE,
+  SETTINGS_DEFAULTS,
+  TAX_CLASS_DEFAULTS,
+} from "./defaults.ts";
+import {
+  SAMPLE_ATTRIBUTE_TERMS,
+  SAMPLE_ATTRIBUTES,
+  SAMPLE_CATEGORIES,
+  SAMPLE_COUPONS,
+  SAMPLE_PRODUCTS,
+  SAMPLE_TAX_RATES,
+} from "./sample-data.ts";
+
+const ok = (data: unknown, status = 200) => Response.json({ success: true, data }, { status });
+const fail = (status: number, error: string, code?: string, extra?: Record<string, unknown>) =>
+  Response.json({ success: false, error, code, ...extra }, { status });
+
+Deno.serve(async (req) => {
+  try {
+    const base44 = createClientFromRequest(req);
+    await requireAdmin(base44);
+    const sr = base44.asServiceRole;
+    const body = await req.json().catch(() => ({}));
+    const withSample = !!body.with_sample_data;
+    const storeName = String(body.store_name ?? "").trim();
+
+    // ── 1. canary schema validation — abort before writing anything real ────
+    const canaryErrors = await runCanaries(sr, withSample);
+    if (canaryErrors.length) {
+      return fail(422,
+        "Entity schemas have been modified and are incompatible with the seeder.",
+        "schema_incompatible",
+        { errors: canaryErrors });
+    }
+
+    // ── 2. required defaults (idempotent) ────────────────────────────────────
+    const seeded = { settings_groups: 0, gateways: 0, tax_classes: 0, zones: 0, zone_methods: 0 };
+
+    const existingSettings = (await sr.entities["commerce.StoreSettings"].list(undefined, 100)) ?? [];
+    const existingGroups = new Set(existingSettings.map((s: any) => s.group_id));
+    // A nameless store renders subjects like "[]: New order #1002", so refuse to
+    // create one rather than seeding a blank the caller never sees.
+    if (!existingGroups.has("general") && !storeName) {
+      return fail(400, "store_name is required — pass the app's name as the platform shows it.", "store_name_required");
+    }
+    for (const group of SETTINGS_DEFAULTS) {
+      if (existingGroups.has(group.group_id)) continue;
+      const values = group.group_id === "general"
+        ? { ...group.values, store_name: storeName }
+        : group.values;
+      await sr.entities["commerce.StoreSettings"].create({ ...group, values });
+      seeded.settings_groups++;
+    }
+
+    // A passed store_name must never be silently dropped: fill a blank one on an
+    // already-seeded store, but never overwrite a name the merchant chose.
+    let storeNameAction = storeName ? "created" : "unchanged";
+    if (storeName && existingGroups.has("general")) {
+      const general = existingSettings.find((r: any) => r.group_id === "general");
+      const current = String(general?.values?.store_name ?? "").trim();
+      if (!current) {
+        await sr.entities["commerce.StoreSettings"].update(general.id, {
+          values: { ...(general.values ?? {}), store_name: storeName },
+        });
+        storeNameAction = "filled";
+      } else {
+        storeNameAction = current === storeName ? "unchanged" : "kept_existing";
+      }
+    }
+
+    for (const gw of GATEWAY_DEFAULTS) {
+      const hits = (await sr.entities["commerce.PaymentGateway"].filter({ slug: gw.slug }, undefined, 1)) ?? [];
+      if (hits.length) continue;
+      await sr.entities["commerce.PaymentGateway"].create(gw);
+      seeded.gateways++;
+    }
+
+    for (const tc of TAX_CLASS_DEFAULTS) {
+      const hits = (await sr.entities["commerce.TaxClass"].filter({ slug: tc.slug }, undefined, 1)) ?? [];
+      if (hits.length) continue;
+      await sr.entities["commerce.TaxClass"].create(tc);
+      seeded.tax_classes++;
+    }
+
+    let zone = ((await sr.entities["commerce.ShippingZone"].filter({ name: REST_OF_WORLD_ZONE.name }, undefined, 1)) ?? [])[0];
+    if (!zone) {
+      zone = await sr.entities["commerce.ShippingZone"].create(REST_OF_WORLD_ZONE);
+      seeded.zones++;
+    }
+    const zoneMethods = (await sr.entities["commerce.ShippingZoneMethod"].filter({ zone_id: zone.id }, undefined, 5)) ?? [];
+    if (!zoneMethods.length) {
+      await sr.entities["commerce.ShippingZoneMethod"].create({ ...REST_OF_WORLD_EXAMPLE_METHOD, zone_id: zone.id });
+      seeded.zone_methods++;
+    }
+
+    // ── 3. optional sample catalog ───────────────────────────────────────────
+    let sampleResult: Record<string, number> | null = null;
+    if (withSample) {
+      const anyProduct = (await sr.entities["commerce.Product"].list(undefined, 1)) ?? [];
+      if (!anyProduct.length) {
+        sampleResult = await seedSampleData(sr);
+      }
+    }
+
+    const currentName = String(
+      (existingSettings.find((r: any) => r.group_id === "general")?.values?.store_name ?? storeName) || storeName,
+    );
+    return ok({
+      seeded,
+      sample_data: sampleResult ?? false,
+      store_name: { value: storeNameAction === "kept_existing" ? currentName : storeName, action: storeNameAction },
+    });
+  } catch (e) {
+    if (e instanceof HttpError) return fail(e.status, e.message, e.code);
+    console.error("commerce/seed-store error:", e);
+    return fail(500, (e as Error).message ?? "Internal error");
+  }
+});
+
+// ── canaries ─────────────────────────────────────────────────────────────────
+
+/** Minimal-valid probe records per entity the seeder writes. */
+function canarySpecs(withSample: boolean): Array<{ entity: string; record: Record<string, any> }> {
+  const base = [
+    { entity: "commerce.StoreSettings", record: { group_id: "general", values: { __canary: true } } },
+    { entity: "commerce.PaymentGateway", record: { slug: "__canary", title: "Canary", enabled: false, order: 999, settings: {} } },
+    { entity: "commerce.TaxClass", record: { slug: "__canary", name: "Canary" } },
+    { entity: "commerce.ShippingZone", record: { name: "__canary", order: 998, locations: [] } },
+    { entity: "commerce.ShippingZoneMethod", record: { zone_id: "__canary", method_id: "flat_rate", title: "Canary", enabled: false, order: 0, settings: { cost: 0 } } },
+  ];
+  const sample = [
+    { entity: "commerce.ProductCategory", record: { name: "__canary", slug: "__canary", count: 0 } },
+    { entity: "commerce.ProductAttribute", record: { name: "__canary", slug: "__canary", type: "select" } },
+    { entity: "commerce.ProductAttributeTerm", record: { attribute_id: "__canary", name: "__canary", slug: "__canary" } },
+    { entity: "commerce.Product", record: { name: "__canary", type: "simple", status: "draft", regular_price: 1, price: 1 } },
+    { entity: "commerce.ProductVariation", record: { product_id: "__canary", attributes: [], status: "draft" } },
+    { entity: "commerce.Coupon", record: { code: "__canary", discount_type: "percent", amount: 1, usage_count: 0, used_by: [] } },
+    { entity: "commerce.TaxRate", record: { country: "ZZ", rate: 1, name: "__canary", priority: 1, compound: false, shipping: true, tax_class: "standard" } },
+  ];
+  return withSample ? [...base, ...sample] : base;
+}
+
+async function runCanaries(sr: any, withSample: boolean): Promise<Array<{ entity: string; error: string }>> {
+  const errors: Array<{ entity: string; error: string }> = [];
+  for (const spec of canarySpecs(withSample)) {
+    let created: any = null;
+    try {
+      created = await sr.entities[spec.entity].create(spec.record);
+    } catch (e) {
+      errors.push({ entity: spec.entity, error: String((e as Error)?.message ?? e) });
+    } finally {
+      if (created?.id) {
+        try { await sr.entities[spec.entity].delete(created.id); } catch { /* orphaned canary is harmless */ }
+      }
+    }
+  }
+  return errors;
+}
+
+// ── sample catalog ───────────────────────────────────────────────────────────
+
+/** price/on_sale/stock_status derivation for seeded products (mirrors commerce/admin-products). */
+function deriveSeedProduct(p: any): any {
+  const out = { ...p };
+  out.on_sale = out.sale_price != null;
+  const effective = out.on_sale ? out.sale_price : out.regular_price;
+  if (effective != null) out.price = round2(Number(effective));
+  if (out.manage_stock) {
+    const qty = Number(out.stock_quantity ?? 0);
+    out.stock_status = qty > 0 ? "instock" : (out.backorders && out.backorders !== "no" ? "onbackorder" : "outofstock");
+  } else if (!out.stock_status) {
+    out.stock_status = "instock";
+  }
+  return out;
+}
+
+async function seedSampleData(sr: any): Promise<Record<string, number>> {
+  // rollback ledger — delete in reverse order on failure
+  const created: Array<{ entity: string; id: string }> = [];
+  const track = async (entity: string, record: Record<string, any>) => {
+    const rec = await sr.entities[entity].create(record);
+    created.push({ entity, id: rec.id });
+    return rec;
+  };
+
+  try {
+    // categories
+    const categoryBySlug: Record<string, any> = {};
+    for (const cat of SAMPLE_CATEGORIES) {
+      categoryBySlug[cat.slug] = await track("commerce.ProductCategory", cat);
+    }
+
+    // attributes + terms
+    const attributeBySlug: Record<string, any> = {};
+    for (const attr of SAMPLE_ATTRIBUTES) {
+      const rec = await track("commerce.ProductAttribute", attr);
+      attributeBySlug[attr.slug] = rec;
+      for (const term of SAMPLE_ATTRIBUTE_TERMS[attr.slug] ?? []) {
+        await track("commerce.ProductAttributeTerm", { ...term, attribute_id: rec.id, count: 0 });
+      }
+    }
+
+    // products (two passes: grouped references resolved after simple products exist)
+    const productByKey: Record<string, any> = {};
+    let variationCount = 0;
+    const specs = [...SAMPLE_PRODUCTS].sort((a, b) => (a.type === "grouped" ? 1 : 0) - (b.type === "grouped" ? 1 : 0));
+
+    for (const spec of specs) {
+      const { key, categories, attributes, default_attributes, variations, grouped_keys, options: _o, ...fields } = spec;
+      const record: any = deriveSeedProduct({
+        ...fields,
+        slug: fields.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, ""),
+        category_ids: (categories ?? []).map((slug: string) => categoryBySlug[slug]?.id).filter(Boolean),
+        tag_ids: [],
+        images: fields.images ?? [],
+        meta_data: [],
+        total_sales: 0,
+      });
+      if (attributes) {
+        record.attributes = attributes.map((a: any, i: number) => ({
+          attribute_id: attributeBySlug[a.slug]?.id ?? "",
+          name: attributeBySlug[a.slug]?.name ?? a.slug,
+          position: i,
+          visible: a.visible !== false,
+          variation: !!a.variation,
+          options: a.options ?? [],
+        }));
+      }
+      if (default_attributes) {
+        record.default_attributes = default_attributes.map((d: any) => ({
+          attribute_id: attributeBySlug[d.slug]?.id ?? "",
+          name: attributeBySlug[d.slug]?.name ?? d.slug,
+          option: d.option,
+        }));
+      }
+      if (grouped_keys) {
+        record.grouped_products = grouped_keys.map((k: string) => productByKey[k]?.id).filter(Boolean);
+      }
+      const product = await track("commerce.Product", record);
+      productByKey[key] = product;
+
+      for (const v of variations ?? []) {
+        const attrs = Object.entries(v.options).map(([slug, option]) => ({
+          attribute_id: attributeBySlug[slug]?.id ?? "",
+          name: attributeBySlug[slug]?.name ?? slug,
+          option,
+        }));
+        await track("commerce.ProductVariation", deriveSeedProduct({
+          product_id: product.id,
+          attributes: attrs,
+          status: "publish",
+          sku: `${record.sku}-${Object.values(v.options).join("-").toUpperCase()}`,
+          regular_price: v.regular_price,
+          ...(v.sale_price != null ? { sale_price: v.sale_price } : {}),
+          manage_stock: "yes",
+          stock_quantity: v.stock_quantity,
+          backorders: v.backorders ?? "no",
+          ...(v.image ? { image: v.image } : {}),
+        }));
+        variationCount++;
+      }
+    }
+
+    // taxonomy counts for the seeded catalog
+    for (const cat of Object.values(categoryBySlug) as any[]) {
+      const count = specs.filter((s) => (s.categories ?? []).some((slug: string) => categoryBySlug[slug]?.id === cat.id)).length;
+      await sr.entities["commerce.ProductCategory"].update(cat.id, { count });
+    }
+
+    for (const coupon of SAMPLE_COUPONS) await track("commerce.Coupon", coupon);
+    for (const rate of SAMPLE_TAX_RATES) await track("commerce.TaxRate", rate);
+
+    return {
+      categories: SAMPLE_CATEGORIES.length,
+      attributes: SAMPLE_ATTRIBUTES.length,
+      products: SAMPLE_PRODUCTS.length,
+      variations: variationCount,
+      coupons: SAMPLE_COUPONS.length,
+      tax_rates: SAMPLE_TAX_RATES.length,
+    };
+  } catch (e) {
+    // best-effort rollback, newest first
+    for (const { entity, id } of created.reverse()) {
+      try { await sr.entities[entity].delete(id); } catch { /* leave orphans; commerce/admin-tools can clean */ }
+    }
+    throw new HttpError(500, `Sample data seeding failed and was rolled back: ${(e as Error).message}`, "sample_seed_failed");
+  }
+}

package/base44/functions/commerce/seed-store/sample-data.ts

@@ -0,0 +1,349 @@
+/**
+ * Optional demo catalog: 3 categories, 2 global attributes (+terms),
+ * ~12 products covering every product type (including 3 variable products
+ * with variants), 2 coupons, 2 tax rates. Every product ships with a
+ * description, short description and a small image gallery so the storefront
+ * and admin look populated out of the box.
+ * Only installed when with_sample_data=true AND the store has no products.
+ */
+
+/**
+ * Demo photography is served from the Unsplash CDN, referenced by immutable
+ * photo id. Unlike a random-image service, every id below was picked to actually
+ * depict the product it illustrates, and it resolves to the same photo on every
+ * seed run with no upload step. Swap these for Core.UploadFile URLs in a real
+ * store.
+ */
+const IMG = (photoId: string, w = 800, h = 800) =>
+  `https://images.unsplash.com/${photoId}?w=${w}&h=${h}&fit=crop&q=80`;
+
+const gallery = (name: string, photoIds: string[]) =>
+  photoIds.map((photoId, position) => ({
+    src: IMG(photoId),
+    name,
+    alt: position === 0 ? name : `${name} — view ${position + 1}`,
+    position,
+  }));
+
+export const SAMPLE_CATEGORIES = [
+  { name: "Clothing", slug: "clothing", description: "Apparel and wearables", display: "default", menu_order: 0, count: 0 },
+  { name: "Accessories", slug: "accessories", description: "Small goods and extras", display: "default", menu_order: 1, count: 0 },
+  { name: "Downloads", slug: "downloads", description: "Digital products", display: "default", menu_order: 2, count: 0 },
+];
+
+export const SAMPLE_ATTRIBUTES = [
+  { name: "Color", slug: "color", type: "select", order_by: "menu_order", has_archives: false },
+  { name: "Size", slug: "size", type: "select", order_by: "menu_order", has_archives: false },
+];
+
+export const SAMPLE_ATTRIBUTE_TERMS: Record<string, Array<{ name: string; slug: string; menu_order: number }>> = {
+  color: [
+    { name: "Red", slug: "red", menu_order: 0 },
+    { name: "Blue", slug: "blue", menu_order: 1 },
+    { name: "Black", slug: "black", menu_order: 2 },
+    { name: "Green", slug: "green", menu_order: 3 },
+  ],
+  size: [
+    { name: "S", slug: "s", menu_order: 0 },
+    { name: "M", slug: "m", menu_order: 1 },
+    { name: "L", slug: "l", menu_order: 2 },
+    { name: "XL", slug: "xl", menu_order: 3 },
+  ],
+};
+
+/**
+ * Per-colour variation photos, keyed by product: a colour swatch is only useful
+ * if it shows the right *garment* in that colour, so these can't be shared
+ * across product types. Products with no colour-accurate photo available (the
+ * tote) are deliberately absent — their variations fall back to the product
+ * gallery, which beats showing an unrelated item.
+ */
+const VARIATION_IMAGES: Record<string, Record<string, string>> = {
+  "V-Neck T-Shirt": {
+    Red: "photo-1634849112476-88cb7e60392b",
+    Blue: "photo-1650590122055-576096fde8f9",
+  },
+  "Colorblock Pullover Hoodie": {
+    Black: "photo-1636170030727-11b73d53e1eb",
+    Blue: "photo-1617171594202-100a53bdfe04",
+    Green: "photo-1536992266094-82847e1fd431",
+  },
+};
+
+/** Variation image for a colour, or undefined to inherit the product gallery. */
+const colorImage = (name: string, color: string) => {
+  const photoId = VARIATION_IMAGES[name]?.[color];
+  return photoId
+    ? { src: IMG(photoId), name: `${name} — ${color}`, alt: `${name} in ${color}` }
+    : undefined;
+};
+
+/**
+ * Product specs — category/attribute references are by slug and resolved to
+ * ids at seed time. `variations` uses attribute slug→option pairs and may carry
+ * a per-variation `image`.
+ */
+export const SAMPLE_PRODUCTS: any[] = [
+  {
+    key: "tshirt",
+    name: "Classic T-Shirt",
+    type: "simple",
+    status: "publish",
+    categories: ["clothing"],
+    regular_price: 19.99,
+    sku: "DEMO-TSHIRT",
+    manage_stock: true,
+    stock_quantity: 50,
+    weight: 0.2,
+    dimensions: { length: 30, width: 25, height: 2 },
+    images: gallery("Classic T-Shirt", ["photo-1521572163474-6864f9cf17ab", "photo-1581655353564-df123a1eb820"]),
+    short_description: "A soft, breathable everyday classic tee.",
+    description:
+      "<p>Our best-selling everyday tee, cut from 100% combed cotton for a soft hand-feel that only gets better with every wash.</p>" +
+      "<ul><li>100% combed ring-spun cotton</li><li>Pre-shrunk, tagless collar</li><li>Reinforced double-stitched hems</li></ul>",
+  },
+  {
+    key: "hoodie",
+    name: "Zip Hoodie",
+    type: "simple",
+    status: "publish",
+    categories: ["clothing"],
+    regular_price: 44.99,
+    sale_price: 34.99,
+    sku: "DEMO-HOODIE",
+    manage_stock: true,
+    stock_quantity: 30,
+    weight: 0.6,
+    images: gallery("Zip Hoodie", ["photo-1622866654199-d36cf0709720", "photo-1556821840-3a63f95609a7"]),
+    short_description: "Cozy fleece-lined zip-up hoodie, currently on sale.",
+    description:
+      "<p>Stay warm without the bulk. This fleece-lined zip hoodie pairs a brushed-soft interior with a durable outer shell.</p>" +
+      "<ul><li>Brushed fleece interior</li><li>Full-length YKK zipper</li><li>Split kangaroo front pockets</li></ul>",
+  },
+  {
+    key: "cap",
+    name: "Logo Cap",
+    type: "simple",
+    status: "publish",
+    categories: ["accessories"],
+    regular_price: 14.99,
+    sku: "DEMO-CAP",
+    sold_individually: true,
+    manage_stock: true,
+    stock_quantity: 40,
+    images: gallery("Logo Cap", ["photo-1588850561407-ed78c282e89b", "photo-1575428652377-a2d80e2277fc"]),
+    short_description: "One per customer — adjustable embroidered logo cap.",
+    description:
+      "<p>A six-panel cotton cap with a low-profile fit and an embroidered front logo. Sold individually.</p>" +
+      "<ul><li>100% cotton twill</li><li>Adjustable metal buckle strap</li><li>Curved, pre-shaped brim</li></ul>",
+  },
+  {
+    key: "stickers",
+    name: "Sticker Pack",
+    type: "simple",
+    status: "publish",
+    categories: ["accessories"],
+    regular_price: 4.99,
+    sku: "DEMO-STICKERS",
+    manage_stock: true,
+    stock_quantity: 200,
+    images: gallery("Sticker Pack", ["photo-1452860606245-08befc0ff44b"]),
+    short_description: "10 assorted weatherproof vinyl stickers.",
+    description:
+      "<p>Ten assorted die-cut vinyl stickers — perfect for laptops, water bottles and notebooks.</p>" +
+      "<ul><li>Weatherproof, UV-resistant vinyl</li><li>Dishwasher-safe adhesive</li><li>Residue-free removal</li></ul>",
+  },
+  {
+    key: "album",
+    name: "Demo Album (Digital Download)",
+    type: "simple",
+    status: "publish",
+    categories: ["downloads"],
+    regular_price: 9.99,
+    sku: "DEMO-ALBUM",
+    virtual: true,
+    downloadable: true,
+    downloads: [{ name: "Album ZIP", file_url: "https://example.com/downloads/demo-album.zip" }],
+    download_limit: 3,
+    download_expiry: 30,
+    images: gallery("Demo Album", ["photo-1619983081563-430f63602796"]),
+    short_description: "Instant digital download — ten tracks in high quality.",
+    description:
+      "<p>A demo digital product delivered as an instant download. Ten tracks in lossless quality, DRM-free.</p>" +
+      "<ul><li>Download limit: 3 times per purchase</li><li>Access expires 30 days after purchase</li><li>DRM-free FLAC + MP3</li></ul>",
+  },
+  {
+    key: "poster",
+    name: "Art Print Poster",
+    type: "simple",
+    status: "publish",
+    categories: ["accessories"],
+    regular_price: 12.99,
+    sku: "DEMO-POSTER",
+    manage_stock: true,
+    stock_quantity: 3, // demonstrates the low-stock dashboard list
+    images: gallery("Art Print Poster", ["photo-1513519245088-0e12902e5a38", "photo-1541961017774-22349e4a1262"]),
+    short_description: "A3 gallery-grade art print — nearly sold out!",
+    description:
+      "<p>An A3 matte art print on heavyweight archival stock. A limited run, so grab one while stock lasts.</p>" +
+      "<ul><li>200 gsm acid-free matte paper</li><li>Fade-resistant giclée inks</li><li>Ships flat in a rigid mailer</li></ul>",
+  },
+  {
+    key: "vneck",
+    name: "V-Neck T-Shirt",
+    type: "variable",
+    status: "publish",
+    categories: ["clothing"],
+    sku: "DEMO-VNECK",
+    images: gallery("V-Neck T-Shirt", ["photo-1583743814966-8936f5b7be1a", "photo-1618453292610-4119319e5ac7"]),
+    short_description: "Fitted v-neck tee available in two colors and three sizes.",
+    description:
+      "<p>A fitted v-neck tee in a lightweight jersey knit, available across multiple colors and sizes.</p>" +
+      "<ul><li>Slim, tailored fit</li><li>Lightweight 150 gsm jersey</li><li>Six color/size combinations</li></ul>",
+    attributes: [
+      { slug: "color", visible: true, variation: true, options: ["Red", "Blue"] },
+      { slug: "size", visible: true, variation: true, options: ["S", "M", "L"] },
+    ],
+    default_attributes: [{ slug: "color", option: "Red" }, { slug: "size", option: "M" }],
+    variations: [
+      { options: { color: "Red", size: "S" }, regular_price: 21.99, stock_quantity: 10, image: colorImage("V-Neck T-Shirt", "Red") },
+      { options: { color: "Red", size: "M" }, regular_price: 21.99, stock_quantity: 10, image: colorImage("V-Neck T-Shirt", "Red") },
+      { options: { color: "Red", size: "L" }, regular_price: 23.99, stock_quantity: 10, image: colorImage("V-Neck T-Shirt", "Red") },
+      { options: { color: "Blue", size: "S" }, regular_price: 21.99, stock_quantity: 10, image: colorImage("V-Neck T-Shirt", "Blue") },
+      { options: { color: "Blue", size: "M" }, regular_price: 21.99, stock_quantity: 10, image: colorImage("V-Neck T-Shirt", "Blue") },
+      { options: { color: "Blue", size: "L" }, regular_price: 23.99, stock_quantity: 10, image: colorImage("V-Neck T-Shirt", "Blue") },
+    ],
+  },
+  {
+    key: "pullover",
+    name: "Colorblock Pullover Hoodie",
+    type: "variable",
+    status: "publish",
+    categories: ["clothing"],
+    sku: "DEMO-PULLOVER",
+    images: gallery("Colorblock Pullover Hoodie", ["photo-1617171594202-100a53bdfe04", "photo-1515886657613-9f3515b0c78f"]),
+    short_description: "Heavyweight pullover hoodie in three colors and three sizes.",
+    description:
+      "<p>A heavyweight brushed-back pullover hoodie with a double-layer hood and ribbed cuffs. Some combinations are on sale.</p>" +
+      "<ul><li>380 gsm brushed-back fleece</li><li>Double-layer drawcord hood</li><li>Nine color/size combinations</li></ul>",
+    attributes: [
+      { slug: "color", visible: true, variation: true, options: ["Black", "Blue", "Green"] },
+      { slug: "size", visible: true, variation: true, options: ["M", "L", "XL"] },
+    ],
+    default_attributes: [{ slug: "color", option: "Black" }, { slug: "size", option: "L" }],
+    variations: [
+      { options: { color: "Black", size: "M" }, regular_price: 49.99, stock_quantity: 12, image: colorImage("Colorblock Pullover Hoodie", "Black") },
+      { options: { color: "Black", size: "L" }, regular_price: 49.99, stock_quantity: 12, image: colorImage("Colorblock Pullover Hoodie", "Black") },
+      { options: { color: "Black", size: "XL" }, regular_price: 52.99, stock_quantity: 8, image: colorImage("Colorblock Pullover Hoodie", "Black") },
+      { options: { color: "Blue", size: "M" }, regular_price: 49.99, sale_price: 42.99, stock_quantity: 10, image: colorImage("Colorblock Pullover Hoodie", "Blue") },
+      { options: { color: "Blue", size: "L" }, regular_price: 49.99, sale_price: 42.99, stock_quantity: 10, image: colorImage("Colorblock Pullover Hoodie", "Blue") },
+      { options: { color: "Blue", size: "XL" }, regular_price: 52.99, sale_price: 45.99, stock_quantity: 6, image: colorImage("Colorblock Pullover Hoodie", "Blue") },
+      { options: { color: "Green", size: "M" }, regular_price: 49.99, stock_quantity: 9, image: colorImage("Colorblock Pullover Hoodie", "Green") },
+      { options: { color: "Green", size: "L" }, regular_price: 49.99, stock_quantity: 9, image: colorImage("Colorblock Pullover Hoodie", "Green") },
+      { options: { color: "Green", size: "XL" }, regular_price: 52.99, stock_quantity: 4, image: colorImage("Colorblock Pullover Hoodie", "Green") },
+    ],
+  },
+  {
+    key: "tote",
+    name: "Canvas Tote Bag",
+    type: "variable",
+    status: "publish",
+    categories: ["accessories"],
+    sku: "DEMO-TOTE",
+    images: gallery("Canvas Tote Bag", ["photo-1544816155-12df9643f363"]),
+    short_description: "Sturdy canvas tote — a single-attribute variable product in three colors.",
+    description:
+      "<p>A roomy, sturdy cotton-canvas tote with reinforced handles. Demonstrates a variable product driven by a single attribute (color).</p>" +
+      "<ul><li>12 oz heavyweight cotton canvas</li><li>Reinforced 28 cm handles</li><li>Interior slip pocket</li></ul>",
+    attributes: [
+      { slug: "color", visible: true, variation: true, options: ["Black", "Blue", "Green"] },
+    ],
+    default_attributes: [{ slug: "color", option: "Black" }],
+    variations: [
+      { options: { color: "Black" }, regular_price: 18.99, stock_quantity: 25, image: colorImage("Canvas Tote Bag", "Black") },
+      { options: { color: "Blue" }, regular_price: 18.99, stock_quantity: 20, image: colorImage("Canvas Tote Bag", "Blue") },
+      { options: { color: "Green" }, regular_price: 18.99, stock_quantity: 0, backorders: "notify", image: colorImage("Canvas Tote Bag", "Green") },
+    ],
+  },
+  {
+    key: "mug",
+    name: "Partner Mug (External)",
+    type: "external",
+    status: "publish",
+    categories: ["accessories"],
+    regular_price: 11.99,
+    sku: "DEMO-MUG",
+    external_url: "https://example.com/partner/mug",
+    button_text: "Buy at partner store",
+    images: gallery("Partner Mug", ["photo-1514228742587-6b1558fcca3d", "photo-1516390118834-21602d501886"]),
+    short_description: "Sold on our partner's site — an external/affiliate product.",
+    description:
+      "<p>A 350 ml ceramic mug sold through our partner store. An example of an external/affiliate product whose buy button links off-site.</p>" +
+      "<ul><li>350 ml ceramic body</li><li>Dishwasher &amp; microwave safe</li><li>Fulfilled by our partner</li></ul>",
+  },
+  {
+    key: "bundle",
+    name: "Starter Bundle",
+    type: "grouped",
+    status: "publish",
+    categories: ["clothing", "accessories"],
+    grouped_keys: ["tshirt", "cap", "stickers"], // resolved to grouped_products ids at seed time
+    images: gallery("Starter Bundle", ["photo-1479064555552-3ef4979f8908"]),
+    short_description: "Tee, cap and sticker pack together in one grouped listing.",
+    description:
+      "<p>A grouped product that bundles the Classic T-Shirt, Logo Cap and Sticker Pack into a single listing. Customers pick quantities for each item.</p>",
+  },
+  {
+    key: "beanie",
+    name: "Wool Beanie",
+    type: "simple",
+    status: "publish",
+    categories: ["accessories"],
+    regular_price: 16.99,
+    sku: "DEMO-BEANIE",
+    manage_stock: true,
+    stock_quantity: 0,
+    backorders: "notify", // demonstrates onbackorder status
+    images: gallery("Wool Beanie", ["photo-1576871337632-b9aef4c17ab9", "photo-1510598969022-c4c6c5d05769"]),
+    short_description: "Out of stock — available on backorder.",
+    description:
+      "<p>A warm, double-layer knit beanie in a soft merino-blend yarn. Currently out of stock but available to order on backorder.</p>" +
+      "<ul><li>Merino wool blend</li><li>Double-layer ribbed knit</li><li>One size, stretch fit</li></ul>",
+  },
+];
+
+export const SAMPLE_COUPONS = [
+  {
+    code: "welcome10",
+    discount_type: "percent",
+    amount: 10,
+    description: "10% off your first order (demo coupon)",
+    free_shipping: false,
+    individual_use: true,
+    usage_limit_per_user: 1,
+    usage_count: 0,
+    used_by: [] as string[],
+  },
+  {
+    code: "save5",
+    discount_type: "fixed_cart",
+    amount: 5,
+    description: "$5 off orders over $25 (demo coupon)",
+    minimum_amount: 25,
+    usage_count: 0,
+    used_by: [] as string[],
+  },
+];
+
+export const SAMPLE_TAX_RATES = [
+  {
+    country: "US", state: "CA", postcodes: [] as string[], cities: [] as string[],
+    rate: 7.25, name: "CA State Tax", priority: 1, compound: false, shipping: true,
+    tax_class: "standard", menu_order: 0,
+  },
+  {
+    country: "GB", state: "", postcodes: [] as string[], cities: [] as string[],
+    rate: 20, name: "VAT", priority: 1, compound: false, shipping: true,
+    tax_class: "standard", menu_order: 1,
+  },
+];