@contractspec/example.marketplace 1.56.1 → 1.58.0

package/dist/marketplace.capability.d.ts

@@ -1,9 +1,4 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-
-//#region src/marketplace.capability.d.ts
-declare const MarketplaceCapability: _contractspec_lib_contracts0.CapabilitySpec;
-declare const EcommerceCapability: _contractspec_lib_contracts0.CapabilitySpec;
-declare const PaymentsCapability: _contractspec_lib_contracts0.CapabilitySpec;
-//#endregion
-export { EcommerceCapability, MarketplaceCapability, PaymentsCapability };
+export declare const MarketplaceCapability: import("@contractspec/lib.contracts").CapabilitySpec;
+export declare const EcommerceCapability: import("@contractspec/lib.contracts").CapabilitySpec;
+export declare const PaymentsCapability: import("@contractspec/lib.contracts").CapabilitySpec;
 //# sourceMappingURL=marketplace.capability.d.ts.map

package/dist/marketplace.capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marketplace.capability.d.ts","names":[],"sources":["../src/marketplace.capability.ts"],"sourcesContent":[],"mappings":";;;cAEa,uBAUX,4BAAA,CAVgC;cAYrB,qBAUX,4BAAA,CAV8B;cAYnB,oBAUX,4BAAA,CAV6B"}
+{"version":3,"file":"marketplace.capability.d.ts","sourceRoot":"","sources":["../src/marketplace.capability.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,sDAUhC,CAAC;AAEH,eAAO,MAAM,mBAAmB,sDAU9B,CAAC;AAEH,eAAO,MAAM,kBAAkB,sDAU7B,CAAC"}

package/dist/marketplace.capability.js

@@ -1,34 +1,41 @@
-import { StabilityEnum, defineCapability } from "@contractspec/lib.contracts";
-
-//#region src/marketplace.capability.ts
-const MarketplaceCapability = defineCapability({ meta: {
-	key: "marketplace",
-	version: "1.0.0",
-	kind: "ui",
-	stability: StabilityEnum.Experimental,
-	description: "Multi-vendor marketplace platform",
-	owners: ["platform.marketplace"],
-	tags: ["marketplace", "ecommerce"]
-} });
-const EcommerceCapability = defineCapability({ meta: {
-	key: "ecommerce",
-	version: "1.0.0",
-	kind: "api",
-	stability: StabilityEnum.Experimental,
-	description: "E-commerce operations and product catalog",
-	owners: ["platform.marketplace"],
-	tags: ["ecommerce", "products"]
-} });
-const PaymentsCapability = defineCapability({ meta: {
-	key: "payments",
-	version: "1.0.0",
-	kind: "integration",
-	stability: StabilityEnum.Experimental,
-	description: "Payment processing and payouts",
-	owners: ["platform.finance"],
-	tags: ["payments", "finance"]
-} });
-
-//#endregion
-export { EcommerceCapability, MarketplaceCapability, PaymentsCapability };
-//# sourceMappingURL=marketplace.capability.js.map
+// @bun
+// src/marketplace.capability.ts
+import { defineCapability, StabilityEnum } from "@contractspec/lib.contracts";
+var MarketplaceCapability = defineCapability({
+  meta: {
+    key: "marketplace",
+    version: "1.0.0",
+    kind: "ui",
+    stability: StabilityEnum.Experimental,
+    description: "Multi-vendor marketplace platform",
+    owners: ["platform.marketplace"],
+    tags: ["marketplace", "ecommerce"]
+  }
+});
+var EcommerceCapability = defineCapability({
+  meta: {
+    key: "ecommerce",
+    version: "1.0.0",
+    kind: "api",
+    stability: StabilityEnum.Experimental,
+    description: "E-commerce operations and product catalog",
+    owners: ["platform.marketplace"],
+    tags: ["ecommerce", "products"]
+  }
+});
+var PaymentsCapability = defineCapability({
+  meta: {
+    key: "payments",
+    version: "1.0.0",
+    kind: "integration",
+    stability: StabilityEnum.Experimental,
+    description: "Payment processing and payouts",
+    owners: ["platform.finance"],
+    tags: ["payments", "finance"]
+  }
+});
+export {
+  PaymentsCapability,
+  MarketplaceCapability,
+  EcommerceCapability
+};

package/dist/marketplace.feature.d.ts

@@ -1,12 +1,6 @@
-import * as _contractspec_lib_contracts3 from "@contractspec/lib.contracts";
-
-//#region src/marketplace.feature.d.ts
-
 /**
  * Marketplace feature module that bundles multi-vendor marketplace
  * capabilities including stores, products, orders, payouts, and reviews.
  */
-declare const MarketplaceFeature: _contractspec_lib_contracts3.FeatureModuleSpec;
-//#endregion
-export { MarketplaceFeature };
+export declare const MarketplaceFeature: import("@contractspec/lib.contracts").FeatureModuleSpec;
 //# sourceMappingURL=marketplace.feature.d.ts.map

package/dist/marketplace.feature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marketplace.feature.d.ts","names":[],"sources":["../src/marketplace.feature.ts"],"sourcesContent":[],"mappings":";;;;;;;AASA;cAAa,oBAqKX,4BAAA,CArK6B"}
+{"version":3,"file":"marketplace.feature.d.ts","sourceRoot":"","sources":["../src/marketplace.feature.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yDAqK7B,CAAC"}

package/dist/marketplace.feature.js

@@ -1,315 +1,138 @@
+// @bun
+// src/marketplace.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts";
-
-//#region src/marketplace.feature.ts
-/**
-* Marketplace Feature Module Specification
-*/
-/**
-* Marketplace feature module that bundles multi-vendor marketplace
-* capabilities including stores, products, orders, payouts, and reviews.
-*/
-const MarketplaceFeature = defineFeature({
-	meta: {
-		key: "marketplace",
-		version: "1.0.0",
-		title: "Multi-Vendor Marketplace",
-		description: "Full-featured marketplace with stores, products, orders, payouts, and reviews",
-		domain: "marketplace",
-		owners: ["@marketplace-team"],
-		tags: [
-			"marketplace",
-			"ecommerce",
-			"multi-vendor",
-			"payments"
-		],
-		stability: "experimental"
-	},
-	operations: [
-		{
-			key: "marketplace.store.create",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.product.create",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.product.list",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.order.create",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.order.updateStatus",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.payout.list",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.review.create",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.review.list",
-			version: "1.0.0"
-		}
-	],
-	events: [
-		{
-			key: "marketplace.store.created",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.store.statusChanged",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.product.created",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.product.published",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.inventory.updated",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.order.created",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.order.paid",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.order.statusUpdated",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.order.shipped",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.order.completed",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.payout.created",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.payout.paid",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.review.created",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.review.responded",
-			version: "1.0.0"
-		}
-	],
-	presentations: [
-		{
-			key: "marketplace.store.profile",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.seller.dashboard",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.product.catalog",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.product.detail",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.product.editor",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.order.list",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.order.detail",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.checkout",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.payout.viewList",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.payout.detail",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.review.viewList",
-			version: "1.0.0"
-		},
-		{
-			key: "marketplace.review.form",
-			version: "1.0.0"
-		}
-	],
-	opToPresentation: [
-		{
-			op: {
-				key: "marketplace.product.list",
-				version: "1.0.0"
-			},
-			pres: {
-				key: "marketplace.product.catalog",
-				version: "1.0.0"
-			}
-		},
-		{
-			op: {
-				key: "marketplace.order.create",
-				version: "1.0.0"
-			},
-			pres: {
-				key: "marketplace.checkout",
-				version: "1.0.0"
-			}
-		},
-		{
-			op: {
-				key: "marketplace.payout.list",
-				version: "1.0.0"
-			},
-			pres: {
-				key: "marketplace.payout.viewList",
-				version: "1.0.0"
-			}
-		},
-		{
-			op: {
-				key: "marketplace.review.list",
-				version: "1.0.0"
-			},
-			pres: {
-				key: "marketplace.review.viewList",
-				version: "1.0.0"
-			}
-		},
-		{
-			op: {
-				key: "marketplace.review.create",
-				version: "1.0.0"
-			},
-			pres: {
-				key: "marketplace.review.form",
-				version: "1.0.0"
-			}
-		}
-	],
-	presentationsTargets: [
-		{
-			key: "marketplace.store.profile",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "marketplace.seller.dashboard",
-			version: "1.0.0",
-			targets: ["react"]
-		},
-		{
-			key: "marketplace.product.catalog",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "marketplace.product.detail",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "marketplace.product.editor",
-			version: "1.0.0",
-			targets: ["react"]
-		},
-		{
-			key: "marketplace.order.list",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "marketplace.order.detail",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "marketplace.checkout",
-			version: "1.0.0",
-			targets: ["react"]
-		},
-		{
-			key: "marketplace.payout.viewList",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "marketplace.review.viewList",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		}
-	],
-	capabilities: {
-		requires: [
-			{
-				key: "identity",
-				version: "1.0.0"
-			},
-			{
-				key: "audit-trail",
-				version: "1.0.0"
-			},
-			{
-				key: "notifications",
-				version: "1.0.0"
-			},
-			{
-				key: "files",
-				version: "1.0.0"
-			},
-			{
-				key: "metering",
-				version: "1.0.0"
-			}
-		],
-		provides: [
-			{
-				key: "marketplace",
-				version: "1.0.0"
-			},
-			{
-				key: "ecommerce",
-				version: "1.0.0"
-			},
-			{
-				key: "payments",
-				version: "1.0.0"
-			}
-		]
-	}
+var MarketplaceFeature = defineFeature({
+  meta: {
+    key: "marketplace",
+    version: "1.0.0",
+    title: "Multi-Vendor Marketplace",
+    description: "Full-featured marketplace with stores, products, orders, payouts, and reviews",
+    domain: "marketplace",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "ecommerce", "multi-vendor", "payments"],
+    stability: "experimental"
+  },
+  operations: [
+    { key: "marketplace.store.create", version: "1.0.0" },
+    { key: "marketplace.product.create", version: "1.0.0" },
+    { key: "marketplace.product.list", version: "1.0.0" },
+    { key: "marketplace.order.create", version: "1.0.0" },
+    { key: "marketplace.order.updateStatus", version: "1.0.0" },
+    { key: "marketplace.payout.list", version: "1.0.0" },
+    { key: "marketplace.review.create", version: "1.0.0" },
+    { key: "marketplace.review.list", version: "1.0.0" }
+  ],
+  events: [
+    { key: "marketplace.store.created", version: "1.0.0" },
+    { key: "marketplace.store.statusChanged", version: "1.0.0" },
+    { key: "marketplace.product.created", version: "1.0.0" },
+    { key: "marketplace.product.published", version: "1.0.0" },
+    { key: "marketplace.inventory.updated", version: "1.0.0" },
+    { key: "marketplace.order.created", version: "1.0.0" },
+    { key: "marketplace.order.paid", version: "1.0.0" },
+    { key: "marketplace.order.statusUpdated", version: "1.0.0" },
+    { key: "marketplace.order.shipped", version: "1.0.0" },
+    { key: "marketplace.order.completed", version: "1.0.0" },
+    { key: "marketplace.payout.created", version: "1.0.0" },
+    { key: "marketplace.payout.paid", version: "1.0.0" },
+    { key: "marketplace.review.created", version: "1.0.0" },
+    { key: "marketplace.review.responded", version: "1.0.0" }
+  ],
+  presentations: [
+    { key: "marketplace.store.profile", version: "1.0.0" },
+    { key: "marketplace.seller.dashboard", version: "1.0.0" },
+    { key: "marketplace.product.catalog", version: "1.0.0" },
+    { key: "marketplace.product.detail", version: "1.0.0" },
+    { key: "marketplace.product.editor", version: "1.0.0" },
+    { key: "marketplace.order.list", version: "1.0.0" },
+    { key: "marketplace.order.detail", version: "1.0.0" },
+    { key: "marketplace.checkout", version: "1.0.0" },
+    { key: "marketplace.payout.viewList", version: "1.0.0" },
+    { key: "marketplace.payout.detail", version: "1.0.0" },
+    { key: "marketplace.review.viewList", version: "1.0.0" },
+    { key: "marketplace.review.form", version: "1.0.0" }
+  ],
+  opToPresentation: [
+    {
+      op: { key: "marketplace.product.list", version: "1.0.0" },
+      pres: { key: "marketplace.product.catalog", version: "1.0.0" }
+    },
+    {
+      op: { key: "marketplace.order.create", version: "1.0.0" },
+      pres: { key: "marketplace.checkout", version: "1.0.0" }
+    },
+    {
+      op: { key: "marketplace.payout.list", version: "1.0.0" },
+      pres: { key: "marketplace.payout.viewList", version: "1.0.0" }
+    },
+    {
+      op: { key: "marketplace.review.list", version: "1.0.0" },
+      pres: { key: "marketplace.review.viewList", version: "1.0.0" }
+    },
+    {
+      op: { key: "marketplace.review.create", version: "1.0.0" },
+      pres: { key: "marketplace.review.form", version: "1.0.0" }
+    }
+  ],
+  presentationsTargets: [
+    {
+      key: "marketplace.store.profile",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    {
+      key: "marketplace.seller.dashboard",
+      version: "1.0.0",
+      targets: ["react"]
+    },
+    {
+      key: "marketplace.product.catalog",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    {
+      key: "marketplace.product.detail",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    { key: "marketplace.product.editor", version: "1.0.0", targets: ["react"] },
+    {
+      key: "marketplace.order.list",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    {
+      key: "marketplace.order.detail",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    { key: "marketplace.checkout", version: "1.0.0", targets: ["react"] },
+    {
+      key: "marketplace.payout.viewList",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    {
+      key: "marketplace.review.viewList",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    }
+  ],
+  capabilities: {
+    requires: [
+      { key: "identity", version: "1.0.0" },
+      { key: "audit-trail", version: "1.0.0" },
+      { key: "notifications", version: "1.0.0" },
+      { key: "files", version: "1.0.0" },
+      { key: "metering", version: "1.0.0" }
+    ],
+    provides: [
+      { key: "marketplace", version: "1.0.0" },
+      { key: "ecommerce", version: "1.0.0" },
+      { key: "payments", version: "1.0.0" }
+    ]
+  }
 });
-
-//#endregion
-export { MarketplaceFeature };
-//# sourceMappingURL=marketplace.feature.js.map
+export {
+  MarketplaceFeature
+};

package/dist/node/docs/index.js

@@ -0,0 +1,103 @@
+// 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 — 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 — 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—keep explicit fields.
+- Redact buyer/provider PII in markdown/JSON presentations.`
+  },
+  {
+    id: "docs.examples.marketplace.constraints",
+    title: "Marketplace — 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);