@contractspec/example.marketplace 1.57.0 → 1.59.0

package/dist/browser/ui/renderers/index.js

@@ -0,0 +1,248 @@
+// src/ui/renderers/marketplace.markdown.ts
+var mockStores = [
+  {
+    id: "store-1",
+    name: "Tech Gadgets Store",
+    status: "ACTIVE",
+    productCount: 45,
+    rating: 4.8
+  },
+  {
+    id: "store-2",
+    name: "Home & Garden",
+    status: "ACTIVE",
+    productCount: 120,
+    rating: 4.5
+  },
+  {
+    id: "store-3",
+    name: "Fashion Boutique",
+    status: "PENDING",
+    productCount: 0,
+    rating: 0
+  }
+];
+var mockProducts = [
+  {
+    id: "prod-1",
+    name: "Wireless Earbuds",
+    storeId: "store-1",
+    price: 79.99,
+    currency: "USD",
+    status: "ACTIVE",
+    stock: 150
+  },
+  {
+    id: "prod-2",
+    name: "Smart Watch",
+    storeId: "store-1",
+    price: 249.99,
+    currency: "USD",
+    status: "ACTIVE",
+    stock: 50
+  },
+  {
+    id: "prod-3",
+    name: "Garden Tools Set",
+    storeId: "store-2",
+    price: 89.99,
+    currency: "USD",
+    status: "ACTIVE",
+    stock: 30
+  },
+  {
+    id: "prod-4",
+    name: "Indoor Plant Kit",
+    storeId: "store-2",
+    price: 45.99,
+    currency: "USD",
+    status: "ACTIVE",
+    stock: 75
+  },
+  {
+    id: "prod-5",
+    name: "LED Desk Lamp",
+    storeId: "store-1",
+    price: 34.99,
+    currency: "USD",
+    status: "OUT_OF_STOCK",
+    stock: 0
+  }
+];
+var mockOrders = [
+  {
+    id: "ord-1",
+    storeId: "store-1",
+    customerId: "cust-1",
+    total: 329.98,
+    currency: "USD",
+    status: "DELIVERED",
+    itemCount: 2,
+    createdAt: "2024-01-15T10:00:00Z"
+  },
+  {
+    id: "ord-2",
+    storeId: "store-2",
+    customerId: "cust-2",
+    total: 135.98,
+    currency: "USD",
+    status: "SHIPPED",
+    itemCount: 2,
+    createdAt: "2024-01-14T14:00:00Z"
+  },
+  {
+    id: "ord-3",
+    storeId: "store-1",
+    customerId: "cust-3",
+    total: 79.99,
+    currency: "USD",
+    status: "PROCESSING",
+    itemCount: 1,
+    createdAt: "2024-01-16T08:00:00Z"
+  },
+  {
+    id: "ord-4",
+    storeId: "store-2",
+    customerId: "cust-4",
+    total: 45.99,
+    currency: "USD",
+    status: "PENDING",
+    itemCount: 1,
+    createdAt: "2024-01-16T12:00:00Z"
+  }
+];
+function formatCurrency(value, currency = "USD") {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency,
+    minimumFractionDigits: 2
+  }).format(value);
+}
+var marketplaceDashboardMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "MarketplaceDashboard") {
+      throw new Error("marketplaceDashboardMarkdownRenderer: not MarketplaceDashboard");
+    }
+    const stores = mockStores;
+    const products = mockProducts;
+    const orders = mockOrders;
+    const activeStores = stores.filter((s) => s.status === "ACTIVE");
+    const activeProducts = products.filter((p) => p.status === "ACTIVE");
+    const totalRevenue = orders.reduce((sum, o) => sum + o.total, 0);
+    const pendingOrders = orders.filter((o) => o.status === "PENDING" || o.status === "PROCESSING");
+    const lines = [
+      "# Marketplace Dashboard",
+      "",
+      "> Two-sided marketplace overview",
+      "",
+      "## Summary",
+      "",
+      "| Metric | Value |",
+      "|--------|-------|",
+      `| Active Stores | ${activeStores.length} |`,
+      `| Active Products | ${activeProducts.length} |`,
+      `| Total Orders | ${orders.length} |`,
+      `| Total Revenue | ${formatCurrency(totalRevenue)} |`,
+      `| Pending Orders | ${pendingOrders.length} |`,
+      "",
+      "## Top Stores",
+      "",
+      "| Store | Products | Rating | Status |",
+      "|-------|----------|--------|--------|"
+    ];
+    for (const store of stores.slice(0, 5)) {
+      lines.push(`| ${store.name} | ${store.productCount} | ⭐ ${store.rating || "N/A"} | ${store.status} |`);
+    }
+    lines.push("");
+    lines.push("## Recent Orders");
+    lines.push("");
+    lines.push("| Order | Items | Total | Status | Date |");
+    lines.push("|-------|-------|-------|--------|------|");
+    for (const order of orders.slice(0, 10)) {
+      const date = new Date(order.createdAt).toLocaleDateString();
+      lines.push(`| ${order.id} | ${order.itemCount} | ${formatCurrency(order.total, order.currency)} | ${order.status} | ${date} |`);
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+var productCatalogMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "ProductCatalog") {
+      throw new Error("productCatalogMarkdownRenderer: not ProductCatalog");
+    }
+    const products = mockProducts;
+    const stores = mockStores;
+    const lines = [
+      "# Product Catalog",
+      "",
+      "> Browse products across all marketplace stores",
+      ""
+    ];
+    for (const store of stores.filter((s) => s.status === "ACTIVE")) {
+      const storeProducts = products.filter((p) => p.storeId === store.id);
+      if (storeProducts.length === 0)
+        continue;
+      lines.push(`## ${store.name}`);
+      lines.push("");
+      lines.push("| Product | Price | Stock | Status |");
+      lines.push("|---------|-------|-------|--------|");
+      for (const product of storeProducts) {
+        const stockStatus = product.stock > 0 ? `${product.stock} in stock` : "Out of stock";
+        lines.push(`| ${product.name} | ${formatCurrency(product.price, product.currency)} | ${stockStatus} | ${product.status} |`);
+      }
+      lines.push("");
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+var orderListMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "OrderList") {
+      throw new Error("orderListMarkdownRenderer: not OrderList");
+    }
+    const orders = mockOrders;
+    const stores = mockStores;
+    const lines = [
+      "# Orders",
+      "",
+      "> Manage marketplace orders",
+      "",
+      "| Order ID | Store | Items | Total | Status | Created |",
+      "|----------|-------|-------|-------|--------|---------|"
+    ];
+    for (const order of orders) {
+      const store = stores.find((s) => s.id === order.storeId);
+      const date = new Date(order.createdAt).toLocaleDateString();
+      lines.push(`| ${order.id} | ${store?.name ?? "Unknown"} | ${order.itemCount} | ${formatCurrency(order.total, order.currency)} | ${order.status} | ${date} |`);
+    }
+    lines.push("");
+    lines.push("## Order Status Legend");
+    lines.push("");
+    lines.push("- **PENDING**: Awaiting payment confirmation");
+    lines.push("- **PROCESSING**: Being prepared");
+    lines.push("- **SHIPPED**: In transit");
+    lines.push("- **DELIVERED**: Order completed");
+    lines.push("- **CANCELLED**: Order cancelled");
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+export {
+  productCatalogMarkdownRenderer,
+  orderListMarkdownRenderer,
+  marketplaceDashboardMarkdownRenderer
+};

package/dist/browser/ui/renderers/marketplace.markdown.js

@@ -0,0 +1,248 @@
+// src/ui/renderers/marketplace.markdown.ts
+var mockStores = [
+  {
+    id: "store-1",
+    name: "Tech Gadgets Store",
+    status: "ACTIVE",
+    productCount: 45,
+    rating: 4.8
+  },
+  {
+    id: "store-2",
+    name: "Home & Garden",
+    status: "ACTIVE",
+    productCount: 120,
+    rating: 4.5
+  },
+  {
+    id: "store-3",
+    name: "Fashion Boutique",
+    status: "PENDING",
+    productCount: 0,
+    rating: 0
+  }
+];
+var mockProducts = [
+  {
+    id: "prod-1",
+    name: "Wireless Earbuds",
+    storeId: "store-1",
+    price: 79.99,
+    currency: "USD",
+    status: "ACTIVE",
+    stock: 150
+  },
+  {
+    id: "prod-2",
+    name: "Smart Watch",
+    storeId: "store-1",
+    price: 249.99,
+    currency: "USD",
+    status: "ACTIVE",
+    stock: 50
+  },
+  {
+    id: "prod-3",
+    name: "Garden Tools Set",
+    storeId: "store-2",
+    price: 89.99,
+    currency: "USD",
+    status: "ACTIVE",
+    stock: 30
+  },
+  {
+    id: "prod-4",
+    name: "Indoor Plant Kit",
+    storeId: "store-2",
+    price: 45.99,
+    currency: "USD",
+    status: "ACTIVE",
+    stock: 75
+  },
+  {
+    id: "prod-5",
+    name: "LED Desk Lamp",
+    storeId: "store-1",
+    price: 34.99,
+    currency: "USD",
+    status: "OUT_OF_STOCK",
+    stock: 0
+  }
+];
+var mockOrders = [
+  {
+    id: "ord-1",
+    storeId: "store-1",
+    customerId: "cust-1",
+    total: 329.98,
+    currency: "USD",
+    status: "DELIVERED",
+    itemCount: 2,
+    createdAt: "2024-01-15T10:00:00Z"
+  },
+  {
+    id: "ord-2",
+    storeId: "store-2",
+    customerId: "cust-2",
+    total: 135.98,
+    currency: "USD",
+    status: "SHIPPED",
+    itemCount: 2,
+    createdAt: "2024-01-14T14:00:00Z"
+  },
+  {
+    id: "ord-3",
+    storeId: "store-1",
+    customerId: "cust-3",
+    total: 79.99,
+    currency: "USD",
+    status: "PROCESSING",
+    itemCount: 1,
+    createdAt: "2024-01-16T08:00:00Z"
+  },
+  {
+    id: "ord-4",
+    storeId: "store-2",
+    customerId: "cust-4",
+    total: 45.99,
+    currency: "USD",
+    status: "PENDING",
+    itemCount: 1,
+    createdAt: "2024-01-16T12:00:00Z"
+  }
+];
+function formatCurrency(value, currency = "USD") {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency,
+    minimumFractionDigits: 2
+  }).format(value);
+}
+var marketplaceDashboardMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "MarketplaceDashboard") {
+      throw new Error("marketplaceDashboardMarkdownRenderer: not MarketplaceDashboard");
+    }
+    const stores = mockStores;
+    const products = mockProducts;
+    const orders = mockOrders;
+    const activeStores = stores.filter((s) => s.status === "ACTIVE");
+    const activeProducts = products.filter((p) => p.status === "ACTIVE");
+    const totalRevenue = orders.reduce((sum, o) => sum + o.total, 0);
+    const pendingOrders = orders.filter((o) => o.status === "PENDING" || o.status === "PROCESSING");
+    const lines = [
+      "# Marketplace Dashboard",
+      "",
+      "> Two-sided marketplace overview",
+      "",
+      "## Summary",
+      "",
+      "| Metric | Value |",
+      "|--------|-------|",
+      `| Active Stores | ${activeStores.length} |`,
+      `| Active Products | ${activeProducts.length} |`,
+      `| Total Orders | ${orders.length} |`,
+      `| Total Revenue | ${formatCurrency(totalRevenue)} |`,
+      `| Pending Orders | ${pendingOrders.length} |`,
+      "",
+      "## Top Stores",
+      "",
+      "| Store | Products | Rating | Status |",
+      "|-------|----------|--------|--------|"
+    ];
+    for (const store of stores.slice(0, 5)) {
+      lines.push(`| ${store.name} | ${store.productCount} | ⭐ ${store.rating || "N/A"} | ${store.status} |`);
+    }
+    lines.push("");
+    lines.push("## Recent Orders");
+    lines.push("");
+    lines.push("| Order | Items | Total | Status | Date |");
+    lines.push("|-------|-------|-------|--------|------|");
+    for (const order of orders.slice(0, 10)) {
+      const date = new Date(order.createdAt).toLocaleDateString();
+      lines.push(`| ${order.id} | ${order.itemCount} | ${formatCurrency(order.total, order.currency)} | ${order.status} | ${date} |`);
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+var productCatalogMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "ProductCatalog") {
+      throw new Error("productCatalogMarkdownRenderer: not ProductCatalog");
+    }
+    const products = mockProducts;
+    const stores = mockStores;
+    const lines = [
+      "# Product Catalog",
+      "",
+      "> Browse products across all marketplace stores",
+      ""
+    ];
+    for (const store of stores.filter((s) => s.status === "ACTIVE")) {
+      const storeProducts = products.filter((p) => p.storeId === store.id);
+      if (storeProducts.length === 0)
+        continue;
+      lines.push(`## ${store.name}`);
+      lines.push("");
+      lines.push("| Product | Price | Stock | Status |");
+      lines.push("|---------|-------|-------|--------|");
+      for (const product of storeProducts) {
+        const stockStatus = product.stock > 0 ? `${product.stock} in stock` : "Out of stock";
+        lines.push(`| ${product.name} | ${formatCurrency(product.price, product.currency)} | ${stockStatus} | ${product.status} |`);
+      }
+      lines.push("");
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+var orderListMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "OrderList") {
+      throw new Error("orderListMarkdownRenderer: not OrderList");
+    }
+    const orders = mockOrders;
+    const stores = mockStores;
+    const lines = [
+      "# Orders",
+      "",
+      "> Manage marketplace orders",
+      "",
+      "| Order ID | Store | Items | Total | Status | Created |",
+      "|----------|-------|-------|-------|--------|---------|"
+    ];
+    for (const order of orders) {
+      const store = stores.find((s) => s.id === order.storeId);
+      const date = new Date(order.createdAt).toLocaleDateString();
+      lines.push(`| ${order.id} | ${store?.name ?? "Unknown"} | ${order.itemCount} | ${formatCurrency(order.total, order.currency)} | ${order.status} | ${date} |`);
+    }
+    lines.push("");
+    lines.push("## Order Status Legend");
+    lines.push("");
+    lines.push("- **PENDING**: Awaiting payment confirmation");
+    lines.push("- **PROCESSING**: Being prepared");
+    lines.push("- **SHIPPED**: In transit");
+    lines.push("- **DELIVERED**: Order completed");
+    lines.push("- **CANCELLED**: Order cancelled");
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+export {
+  productCatalogMarkdownRenderer,
+  orderListMarkdownRenderer,
+  marketplaceDashboardMarkdownRenderer
+};

package/dist/docs/index.d.ts

@@ -1 +1,2 @@
-export { };
+import './marketplace.docblock';
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,CAAC"}

package/dist/docs/index.js

@@ -1 +1,104 @@
-import "./marketplace.docblock.js";
+// @bun
+// src/docs/marketplace.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var marketplaceDocBlocks = [
+  {
+    id: "docs.examples.marketplace",
+    title: "Marketplace (2-sided)",
+    summary: "Two-sided marketplace with stores, products, orders, payouts, and reviews. Demonstrates multi-actor flows, payments, and attachments.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/marketplace",
+    tags: ["marketplace", "orders", "payouts", "reviews"],
+    body: `## Entities
+
+- Store, Product, Order, OrderItem, Payout, Review.
+- Uses Files module for product media and receipt attachments.
+
+## Contracts
+
+- \`marketplace.store.create\`, \`marketplace.product.add\`, \`marketplace.order.place\`, \`marketplace.payout.process\`, \`marketplace.review.submit\`.
+- Policy guards via Identity/RBAC for provider vs client actions.
+
+## Events
+
+- order.created/completed/cancelled, payout.queued/completed, review.submitted.
+- Hooked into Notifications and Audit Trail modules.
+
+## UI / Presentations
+
+- Dashboard, product catalog, order list/detail, store management.
+- Templates registered under \`marketplace\` in Studio Template Registry.
+
+## Notes
+
+- Commission model encoded in spec; payouts scheduled via Jobs module.
+- Feature flags can gate beta checkout or new reviews flow.
+`
+  },
+  {
+    id: "docs.examples.marketplace.goal",
+    title: "Marketplace \u2014 Goal",
+    summary: "Why this marketplace template exists and the outcomes it targets.",
+    kind: "goal",
+    visibility: "public",
+    route: "/docs/examples/marketplace/goal",
+    tags: ["marketplace", "goal"],
+    body: `## Why it matters
+- Provides a regenerable 2-sided marketplace baseline without bespoke glue.
+- Keeps payouts, catalog, orders, and reviews consistent across surfaces.
+
+## Business/Product goal
+- Safe provider/client flows with auditable payouts and moderation-ready reviews.
+- Staged rollouts for payments/reviews via feature flags; explicit commission/tax fields.
+
+## Success criteria
+- Orders/payouts regenerate cleanly after spec changes.
+- Events emit for lifecycle + audit; PII is scoped/redacted in presentations.`
+  },
+  {
+    id: "docs.examples.marketplace.usage",
+    title: "Marketplace \u2014 Usage",
+    summary: "How to seed, extend, and safely regenerate the marketplace.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/marketplace/usage",
+    tags: ["marketplace", "usage"],
+    body: `## Setup
+1) Seed sample stores/products/orders via template registry (or create via UI).
+2) Configure Files storage for media/receipts; set policy.pii for sensitive fields.
+
+## Extend & regenerate
+1) Adjust schemas for commission/tax/payout states or review moderation in the spec.
+2) Regenerate to sync UI, API, events, notifications.
+3) Gate risky changes (new payment providers) behind Feature Flags.
+
+## Guardrails
+- Emit events for order/payout state changes; log via Audit Trail.
+- Avoid hidden commission math\u2014keep explicit fields.
+- Redact buyer/provider PII in markdown/JSON presentations.`
+  },
+  {
+    id: "docs.examples.marketplace.constraints",
+    title: "Marketplace \u2014 Constraints & Safety",
+    summary: "Internal guardrails for payouts, order states, and regeneration semantics.",
+    kind: "reference",
+    visibility: "internal",
+    route: "/docs/examples/marketplace/constraints",
+    tags: ["marketplace", "constraints", "internal"],
+    body: `## Constraints
+- Commission logic and order states must stay spec-defined; never adjust in code-only patches.
+- Events to emit: order.created, order.completed, payout.queued, review.posted (minimum).
+- Regeneration must not change payment semantics without explicit spec diff.
+
+## Safety & PII
+- Redact buyer/provider identifiers in markdown/JSON outputs; scope payouts per tenant/org.
+- For MCP/web surfaces, avoid exposing raw payout calc inputs; use summaries.
+
+## Testing/Verification
+- Add fixtures covering order lifecycle and payout queueing.
+- Run regeneration diff when changing commission/tax fields; verify presentations updated.
+- Ensure Notifications/Audit wiring remains intact for order/payout/review events.`
+  }
+];
+registerDocBlocks(marketplaceDocBlocks);

package/dist/docs/marketplace.docblock.d.ts

@@ -1 +1,2 @@
-export { };
+export {};
+//# sourceMappingURL=marketplace.docblock.d.ts.map

package/dist/docs/marketplace.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.docblock.d.ts","sourceRoot":"","sources":["../../src/docs/marketplace.docblock.ts"],"names":[],"mappings":""}