@contractspec/example.marketplace 1.56.1 → 1.58.0

package/dist/node/example.js

@@ -0,0 +1,42 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "marketplace",
+    version: "1.0.0",
+    title: "Marketplace (2-sided)",
+    description: "Two-sided marketplace with stores, products, orders, payouts, and reviews (multi-actor flows).",
+    kind: "template",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["marketplace", "orders", "payouts", "reviews"]
+  },
+  docs: {
+    rootDocId: "docs.examples.marketplace",
+    goalDocId: "docs.examples.marketplace.goal",
+    usageDocId: "docs.examples.marketplace.usage",
+    constraintsDocId: "docs.examples.marketplace.constraints"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.marketplace",
+    feature: "./feature",
+    contracts: "./contracts",
+    presentations: "./presentations",
+    handlers: "./handlers",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: {
+      enabled: true,
+      modes: ["playground", "specs", "builder", "markdown", "evolution"]
+    },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/node/handlers/index.js

@@ -0,0 +1,303 @@
+// src/handlers/marketplace.handlers.ts
+import { web } from "@contractspec/lib.runtime-sandbox";
+var { generateId } = web;
+function rowToStore(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    organizationId: row.organizationId,
+    name: row.name,
+    description: row.description ?? undefined,
+    status: row.status,
+    rating: row.rating,
+    reviewCount: row.reviewCount,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function rowToProduct(row) {
+  return {
+    id: row.id,
+    storeId: row.storeId,
+    name: row.name,
+    description: row.description ?? undefined,
+    price: row.price,
+    currency: row.currency,
+    status: row.status,
+    stock: row.stock,
+    category: row.category ?? undefined,
+    imageUrl: row.imageUrl ?? undefined,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function rowToOrder(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    storeId: row.storeId,
+    customerId: row.customerId,
+    status: row.status,
+    total: row.total,
+    currency: row.currency,
+    shippingAddress: row.shippingAddress ?? undefined,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function rowToOrderItem(row) {
+  return {
+    id: row.id,
+    orderId: row.orderId,
+    productId: row.productId,
+    quantity: row.quantity,
+    price: row.price,
+    createdAt: new Date(row.createdAt)
+  };
+}
+function rowToPayout(row) {
+  return {
+    id: row.id,
+    storeId: row.storeId,
+    amount: row.amount,
+    currency: row.currency,
+    status: row.status,
+    processedAt: row.processedAt ? new Date(row.processedAt) : undefined,
+    createdAt: new Date(row.createdAt)
+  };
+}
+function rowToReview(row) {
+  return {
+    id: row.id,
+    productId: row.productId,
+    customerId: row.customerId,
+    orderId: row.orderId ?? undefined,
+    rating: row.rating,
+    comment: row.comment ?? undefined,
+    createdAt: new Date(row.createdAt)
+  };
+}
+function createMarketplaceHandlers(db) {
+  async function listStores(input) {
+    const { projectId, status, search, limit = 20, offset = 0 } = input;
+    let whereClause = "WHERE projectId = ?";
+    const params = [projectId];
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    if (search) {
+      whereClause += " AND name LIKE ?";
+      params.push(`%${search}%`);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM marketplace_store ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const rows = (await db.query(`SELECT * FROM marketplace_store ${whereClause} ORDER BY rating DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      stores: rows.map(rowToStore),
+      total
+    };
+  }
+  async function createStore(input, context) {
+    const id = generateId("store");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO marketplace_store (id, projectId, organizationId, name, description, status, rating, reviewCount, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      context.projectId,
+      context.organizationId,
+      input.name,
+      input.description ?? null,
+      "PENDING",
+      0,
+      0,
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM marketplace_store WHERE id = ?`, [id])).rows;
+    return rowToStore(rows[0]);
+  }
+  async function listProducts(input) {
+    const { storeId, status, category, search, limit = 20, offset = 0 } = input;
+    let whereClause = "WHERE 1=1";
+    const params = [];
+    if (storeId) {
+      whereClause += " AND storeId = ?";
+      params.push(storeId);
+    }
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    if (category) {
+      whereClause += " AND category = ?";
+      params.push(category);
+    }
+    if (search) {
+      whereClause += " AND name LIKE ?";
+      params.push(`%${search}%`);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM marketplace_product ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const rows = (await db.query(`SELECT * FROM marketplace_product ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      products: rows.map(rowToProduct),
+      total
+    };
+  }
+  async function addProduct(input) {
+    const id = generateId("prod");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO marketplace_product (id, storeId, name, description, price, currency, status, stock, category, imageUrl, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      input.storeId,
+      input.name,
+      input.description ?? null,
+      input.price,
+      input.currency ?? "USD",
+      "DRAFT",
+      input.stock ?? 0,
+      input.category ?? null,
+      input.imageUrl ?? null,
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM marketplace_product WHERE id = ?`, [id])).rows;
+    return rowToProduct(rows[0]);
+  }
+  async function listOrders(input) {
+    const {
+      projectId,
+      storeId,
+      customerId,
+      status,
+      limit = 20,
+      offset = 0
+    } = input;
+    let whereClause = "WHERE projectId = ?";
+    const params = [projectId];
+    if (storeId) {
+      whereClause += " AND storeId = ?";
+      params.push(storeId);
+    }
+    if (customerId) {
+      whereClause += " AND customerId = ?";
+      params.push(customerId);
+    }
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM marketplace_order ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const revenueResult = (await db.query(`SELECT COALESCE(SUM(total), 0) as revenue FROM marketplace_order ${whereClause}`, params)).rows;
+    const totalRevenue = revenueResult[0]?.revenue ?? 0;
+    const rows = (await db.query(`SELECT * FROM marketplace_order ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      orders: rows.map(rowToOrder),
+      total,
+      totalRevenue
+    };
+  }
+  async function placeOrder(input, context) {
+    const orderId = generateId("order");
+    const now = new Date().toISOString();
+    let total = 0;
+    const itemsToCreate = [];
+    for (const item of input.items) {
+      const products = (await db.query(`SELECT * FROM marketplace_product WHERE id = ?`, [
+        item.productId
+      ])).rows;
+      if (!products[0]) {
+        throw new Error(`Product not found: ${item.productId}`);
+      }
+      const itemPrice = products[0].price * item.quantity;
+      total += itemPrice;
+      itemsToCreate.push({
+        productId: item.productId,
+        quantity: item.quantity,
+        price: products[0].price
+      });
+    }
+    await db.execute(`INSERT INTO marketplace_order (id, projectId, storeId, customerId, status, total, currency, shippingAddress, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      orderId,
+      context.projectId,
+      input.storeId,
+      context.customerId,
+      "PENDING",
+      total,
+      "USD",
+      input.shippingAddress ?? null,
+      now,
+      now
+    ]);
+    for (const item of itemsToCreate) {
+      await db.execute(`INSERT INTO marketplace_order_item (id, orderId, productId, quantity, price, createdAt)
+         VALUES (?, ?, ?, ?, ?, ?)`, [
+        generateId("orditem"),
+        orderId,
+        item.productId,
+        item.quantity,
+        item.price,
+        now
+      ]);
+    }
+    const rows = (await db.query(`SELECT * FROM marketplace_order WHERE id = ?`, [orderId])).rows;
+    return rowToOrder(rows[0]);
+  }
+  async function getOrderItems(orderId) {
+    const rows = (await db.query(`SELECT * FROM marketplace_order_item WHERE orderId = ?`, [
+      orderId
+    ])).rows;
+    return rows.map(rowToOrderItem);
+  }
+  async function updateOrderStatus(orderId, status) {
+    const now = new Date().toISOString();
+    await db.execute(`UPDATE marketplace_order SET status = ?, updatedAt = ? WHERE id = ?`, [status, now, orderId]);
+    const rows = (await db.query(`SELECT * FROM marketplace_order WHERE id = ?`, [orderId])).rows;
+    return rowToOrder(rows[0]);
+  }
+  async function listPayouts(storeId) {
+    const rows = (await db.query(`SELECT * FROM marketplace_payout WHERE storeId = ? ORDER BY createdAt DESC`, [storeId])).rows;
+    return rows.map(rowToPayout);
+  }
+  async function listReviews(productId) {
+    const rows = (await db.query(`SELECT * FROM marketplace_review WHERE productId = ? ORDER BY createdAt DESC`, [productId])).rows;
+    return rows.map(rowToReview);
+  }
+  async function submitReview(input) {
+    const id = generateId("review");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO marketplace_review (id, productId, customerId, orderId, rating, comment, createdAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      input.productId,
+      input.customerId,
+      input.orderId ?? null,
+      input.rating,
+      input.comment ?? null,
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM marketplace_review WHERE id = ?`, [id])).rows;
+    return rowToReview(rows[0]);
+  }
+  return {
+    listStores,
+    createStore,
+    listProducts,
+    addProduct,
+    listOrders,
+    placeOrder,
+    getOrderItems,
+    updateOrderStatus,
+    listPayouts,
+    listReviews,
+    submitReview
+  };
+}
+export {
+  createMarketplaceHandlers
+};

package/dist/node/handlers/marketplace.handlers.js

@@ -0,0 +1,303 @@
+// src/handlers/marketplace.handlers.ts
+import { web } from "@contractspec/lib.runtime-sandbox";
+var { generateId } = web;
+function rowToStore(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    organizationId: row.organizationId,
+    name: row.name,
+    description: row.description ?? undefined,
+    status: row.status,
+    rating: row.rating,
+    reviewCount: row.reviewCount,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function rowToProduct(row) {
+  return {
+    id: row.id,
+    storeId: row.storeId,
+    name: row.name,
+    description: row.description ?? undefined,
+    price: row.price,
+    currency: row.currency,
+    status: row.status,
+    stock: row.stock,
+    category: row.category ?? undefined,
+    imageUrl: row.imageUrl ?? undefined,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function rowToOrder(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    storeId: row.storeId,
+    customerId: row.customerId,
+    status: row.status,
+    total: row.total,
+    currency: row.currency,
+    shippingAddress: row.shippingAddress ?? undefined,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function rowToOrderItem(row) {
+  return {
+    id: row.id,
+    orderId: row.orderId,
+    productId: row.productId,
+    quantity: row.quantity,
+    price: row.price,
+    createdAt: new Date(row.createdAt)
+  };
+}
+function rowToPayout(row) {
+  return {
+    id: row.id,
+    storeId: row.storeId,
+    amount: row.amount,
+    currency: row.currency,
+    status: row.status,
+    processedAt: row.processedAt ? new Date(row.processedAt) : undefined,
+    createdAt: new Date(row.createdAt)
+  };
+}
+function rowToReview(row) {
+  return {
+    id: row.id,
+    productId: row.productId,
+    customerId: row.customerId,
+    orderId: row.orderId ?? undefined,
+    rating: row.rating,
+    comment: row.comment ?? undefined,
+    createdAt: new Date(row.createdAt)
+  };
+}
+function createMarketplaceHandlers(db) {
+  async function listStores(input) {
+    const { projectId, status, search, limit = 20, offset = 0 } = input;
+    let whereClause = "WHERE projectId = ?";
+    const params = [projectId];
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    if (search) {
+      whereClause += " AND name LIKE ?";
+      params.push(`%${search}%`);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM marketplace_store ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const rows = (await db.query(`SELECT * FROM marketplace_store ${whereClause} ORDER BY rating DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      stores: rows.map(rowToStore),
+      total
+    };
+  }
+  async function createStore(input, context) {
+    const id = generateId("store");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO marketplace_store (id, projectId, organizationId, name, description, status, rating, reviewCount, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      context.projectId,
+      context.organizationId,
+      input.name,
+      input.description ?? null,
+      "PENDING",
+      0,
+      0,
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM marketplace_store WHERE id = ?`, [id])).rows;
+    return rowToStore(rows[0]);
+  }
+  async function listProducts(input) {
+    const { storeId, status, category, search, limit = 20, offset = 0 } = input;
+    let whereClause = "WHERE 1=1";
+    const params = [];
+    if (storeId) {
+      whereClause += " AND storeId = ?";
+      params.push(storeId);
+    }
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    if (category) {
+      whereClause += " AND category = ?";
+      params.push(category);
+    }
+    if (search) {
+      whereClause += " AND name LIKE ?";
+      params.push(`%${search}%`);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM marketplace_product ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const rows = (await db.query(`SELECT * FROM marketplace_product ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      products: rows.map(rowToProduct),
+      total
+    };
+  }
+  async function addProduct(input) {
+    const id = generateId("prod");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO marketplace_product (id, storeId, name, description, price, currency, status, stock, category, imageUrl, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      input.storeId,
+      input.name,
+      input.description ?? null,
+      input.price,
+      input.currency ?? "USD",
+      "DRAFT",
+      input.stock ?? 0,
+      input.category ?? null,
+      input.imageUrl ?? null,
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM marketplace_product WHERE id = ?`, [id])).rows;
+    return rowToProduct(rows[0]);
+  }
+  async function listOrders(input) {
+    const {
+      projectId,
+      storeId,
+      customerId,
+      status,
+      limit = 20,
+      offset = 0
+    } = input;
+    let whereClause = "WHERE projectId = ?";
+    const params = [projectId];
+    if (storeId) {
+      whereClause += " AND storeId = ?";
+      params.push(storeId);
+    }
+    if (customerId) {
+      whereClause += " AND customerId = ?";
+      params.push(customerId);
+    }
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM marketplace_order ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const revenueResult = (await db.query(`SELECT COALESCE(SUM(total), 0) as revenue FROM marketplace_order ${whereClause}`, params)).rows;
+    const totalRevenue = revenueResult[0]?.revenue ?? 0;
+    const rows = (await db.query(`SELECT * FROM marketplace_order ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      orders: rows.map(rowToOrder),
+      total,
+      totalRevenue
+    };
+  }
+  async function placeOrder(input, context) {
+    const orderId = generateId("order");
+    const now = new Date().toISOString();
+    let total = 0;
+    const itemsToCreate = [];
+    for (const item of input.items) {
+      const products = (await db.query(`SELECT * FROM marketplace_product WHERE id = ?`, [
+        item.productId
+      ])).rows;
+      if (!products[0]) {
+        throw new Error(`Product not found: ${item.productId}`);
+      }
+      const itemPrice = products[0].price * item.quantity;
+      total += itemPrice;
+      itemsToCreate.push({
+        productId: item.productId,
+        quantity: item.quantity,
+        price: products[0].price
+      });
+    }
+    await db.execute(`INSERT INTO marketplace_order (id, projectId, storeId, customerId, status, total, currency, shippingAddress, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      orderId,
+      context.projectId,
+      input.storeId,
+      context.customerId,
+      "PENDING",
+      total,
+      "USD",
+      input.shippingAddress ?? null,
+      now,
+      now
+    ]);
+    for (const item of itemsToCreate) {
+      await db.execute(`INSERT INTO marketplace_order_item (id, orderId, productId, quantity, price, createdAt)
+         VALUES (?, ?, ?, ?, ?, ?)`, [
+        generateId("orditem"),
+        orderId,
+        item.productId,
+        item.quantity,
+        item.price,
+        now
+      ]);
+    }
+    const rows = (await db.query(`SELECT * FROM marketplace_order WHERE id = ?`, [orderId])).rows;
+    return rowToOrder(rows[0]);
+  }
+  async function getOrderItems(orderId) {
+    const rows = (await db.query(`SELECT * FROM marketplace_order_item WHERE orderId = ?`, [
+      orderId
+    ])).rows;
+    return rows.map(rowToOrderItem);
+  }
+  async function updateOrderStatus(orderId, status) {
+    const now = new Date().toISOString();
+    await db.execute(`UPDATE marketplace_order SET status = ?, updatedAt = ? WHERE id = ?`, [status, now, orderId]);
+    const rows = (await db.query(`SELECT * FROM marketplace_order WHERE id = ?`, [orderId])).rows;
+    return rowToOrder(rows[0]);
+  }
+  async function listPayouts(storeId) {
+    const rows = (await db.query(`SELECT * FROM marketplace_payout WHERE storeId = ? ORDER BY createdAt DESC`, [storeId])).rows;
+    return rows.map(rowToPayout);
+  }
+  async function listReviews(productId) {
+    const rows = (await db.query(`SELECT * FROM marketplace_review WHERE productId = ? ORDER BY createdAt DESC`, [productId])).rows;
+    return rows.map(rowToReview);
+  }
+  async function submitReview(input) {
+    const id = generateId("review");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO marketplace_review (id, productId, customerId, orderId, rating, comment, createdAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      input.productId,
+      input.customerId,
+      input.orderId ?? null,
+      input.rating,
+      input.comment ?? null,
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM marketplace_review WHERE id = ?`, [id])).rows;
+    return rowToReview(rows[0]);
+  }
+  return {
+    listStores,
+    createStore,
+    listProducts,
+    addProduct,
+    listOrders,
+    placeOrder,
+    getOrderItems,
+    updateOrderStatus,
+    listPayouts,
+    listReviews,
+    submitReview
+  };
+}
+export {
+  createMarketplaceHandlers
+};