@contractspec/example.marketplace 3.7.6 → 3.8.2

package/dist/node/marketplace.feature.js

@@ -1,3 +1,177 @@
+// src/visualizations/catalog.ts
+import {
+  defineVisualization,
+  VisualizationRegistry
+} from "@contractspec/lib.contracts-spec/visualizations";
+var ORDER_LIST_REF = {
+  key: "marketplace.order.list",
+  version: "1.0.0"
+};
+var PRODUCT_LIST_REF = {
+  key: "marketplace.product.list",
+  version: "1.0.0"
+};
+var META = {
+  version: "1.0.0",
+  domain: "marketplace",
+  stability: "experimental",
+  owners: ["@example.marketplace"],
+  tags: ["marketplace", "visualization", "commerce"]
+};
+var MarketplaceOrderStatusVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.order-status",
+    title: "Order Status Breakdown",
+    description: "Distribution of current order states.",
+    goal: "Expose delivery and backlog mix at a glance.",
+    context: "Marketplace operations overview."
+  },
+  source: { primary: ORDER_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "pie",
+    nameDimension: "status",
+    valueMeasure: "orders",
+    dimensions: [
+      { key: "status", label: "Status", dataPath: "status", type: "category" }
+    ],
+    measures: [
+      { key: "orders", label: "Orders", dataPath: "orders", format: "number" }
+    ],
+    table: { caption: "Order counts by status." }
+  }
+});
+var MarketplaceCategoryValueVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.category-value",
+    title: "Category Value Comparison",
+    description: "Catalog value by product category derived from current pricing and stock.",
+    goal: "Compare where the marketplace catalog is concentrated.",
+    context: "Merchandising overview."
+  },
+  source: { primary: PRODUCT_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "bar",
+    xDimension: "category",
+    yMeasures: ["catalogValue"],
+    dimensions: [
+      {
+        key: "category",
+        label: "Category",
+        dataPath: "category",
+        type: "category"
+      }
+    ],
+    measures: [
+      {
+        key: "catalogValue",
+        label: "Catalog Value",
+        dataPath: "catalogValue",
+        format: "currency",
+        color: "#1d4ed8"
+      }
+    ],
+    table: { caption: "Catalog value by product category." }
+  }
+});
+var MarketplaceOrderActivityVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "marketplace.visualization.order-activity",
+    title: "Recent Order Activity",
+    description: "Daily order volume from recent order creation timestamps.",
+    goal: "Show recent order activity trends.",
+    context: "Commerce operations trend monitoring."
+  },
+  source: { primary: ORDER_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "line",
+    xDimension: "day",
+    yMeasures: ["orders"],
+    dimensions: [{ key: "day", label: "Day", dataPath: "day", type: "time" }],
+    measures: [
+      {
+        key: "orders",
+        label: "Orders",
+        dataPath: "orders",
+        format: "number",
+        color: "#0f766e"
+      }
+    ],
+    table: { caption: "Daily order counts." }
+  }
+});
+var MarketplaceVisualizationSpecs = [
+  MarketplaceOrderStatusVisualization,
+  MarketplaceCategoryValueVisualization,
+  MarketplaceOrderActivityVisualization
+];
+var MarketplaceVisualizationRegistry = new VisualizationRegistry([
+  ...MarketplaceVisualizationSpecs
+]);
+var MarketplaceVisualizationRefs = MarketplaceVisualizationSpecs.map((spec) => ({
+  key: spec.meta.key,
+  version: spec.meta.version
+}));
+
+// src/visualizations/selectors.ts
+function toDayKey(value) {
+  const date = value instanceof Date ? value : new Date(value);
+  return date.toISOString().slice(0, 10);
+}
+function createMarketplaceVisualizationItems(products, orders) {
+  const orderStatus = new Map;
+  const orderActivity = new Map;
+  const categoryValue = new Map;
+  for (const order of orders) {
+    orderStatus.set(order.status, (orderStatus.get(order.status) ?? 0) + 1);
+    const day = toDayKey(order.createdAt);
+    orderActivity.set(day, (orderActivity.get(day) ?? 0) + 1);
+  }
+  for (const product of products) {
+    const category = product.category ?? "Uncategorized";
+    categoryValue.set(category, (categoryValue.get(category) ?? 0) + product.price * product.stock);
+  }
+  return [
+    {
+      key: "marketplace-order-status",
+      spec: MarketplaceOrderStatusVisualization,
+      data: {
+        data: Array.from(orderStatus.entries()).map(([status, count]) => ({
+          status,
+          orders: count
+        }))
+      },
+      title: "Order Status Breakdown",
+      description: "Status mix across the current order set.",
+      height: 260
+    },
+    {
+      key: "marketplace-category-value",
+      spec: MarketplaceCategoryValueVisualization,
+      data: {
+        data: Array.from(categoryValue.entries()).sort(([, left], [, right]) => right - left).map(([category, value]) => ({
+          category,
+          catalogValue: value
+        }))
+      },
+      title: "Category Value Comparison",
+      description: "Derived from current product pricing and stock."
+    },
+    {
+      key: "marketplace-order-activity",
+      spec: MarketplaceOrderActivityVisualization,
+      data: {
+        data: Array.from(orderActivity.entries()).sort(([left], [right]) => left.localeCompare(right)).map(([day, count]) => ({ day, orders: count }))
+      },
+      title: "Recent Order Activity",
+      description: "Daily order count from current order history."
+    }
+  ];
+}
 // src/marketplace.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var MarketplaceFeature = defineFeature({
@@ -117,6 +291,7 @@ var MarketplaceFeature = defineFeature({
       targets: ["react", "markdown"]
     }
   ],
+  visualizations: MarketplaceVisualizationRefs,
   capabilities: {
     requires: [
       { key: "identity", version: "1.0.0" },

package/dist/node/order/index.js

@@ -13,62 +13,187 @@ var OrderStatusEnum = defineEnum("OrderStatus", [
   "DISPUTED"
 ]);
 
-// src/order/order.schema.ts
+// src/order/order.event.ts
+import { defineEvent } from "@contractspec/lib.contracts-spec";
 import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var OrderItemModel = defineSchemaModel({
-  name: "OrderItemModel",
+var OrderCreatedPayload = defineSchemaModel({
+  name: "OrderCreatedEventPayload",
   fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    productId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    productName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    unitPrice: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
-    quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    subtotal: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false }
+    orderId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    orderNumber: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    buyerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    total: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    itemCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
   }
 });
-var OrderModel = defineSchemaModel({
-  name: "OrderModel",
-  description: "An order",
+var OrderPaidPayload = defineSchemaModel({
+  name: "OrderPaidEventPayload",
+  fields: {
+    orderId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    orderNumber: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    total: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    paymentMethod: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var OrderStatusUpdatedPayload = defineSchemaModel({
+  name: "OrderStatusUpdatedEventPayload",
+  fields: {
+    orderId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    orderNumber: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    previousStatus: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    updatedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var OrderShippedPayload = defineSchemaModel({
+  name: "OrderShippedEventPayload",
+  fields: {
+    orderId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    orderNumber: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    trackingNumber: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    trackingUrl: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    carrier: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var OrderCompletedPayload = defineSchemaModel({
+  name: "OrderCompletedEventPayload",
   fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    orderId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     orderNumber: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     buyerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: OrderStatusEnum, isOptional: false },
-    subtotal: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
-    shippingTotal: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
-    taxTotal: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
     total: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
-    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sellerPayout: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var OrderCreatedEvent = defineEvent({
+  meta: {
+    key: "marketplace.order.created",
+    version: "1.0.0",
+    description: "A new order has been created.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "order"]
+  },
+  payload: OrderCreatedPayload
+});
+var OrderPaidEvent = defineEvent({
+  meta: {
+    key: "marketplace.order.paid",
+    version: "1.0.0",
+    description: "An order has been paid.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "order"]
+  },
+  payload: OrderPaidPayload
+});
+var OrderStatusUpdatedEvent = defineEvent({
+  meta: {
+    key: "marketplace.order.statusUpdated",
+    version: "1.0.0",
+    description: "An order status has been updated.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "order"]
+  },
+  payload: OrderStatusUpdatedPayload
+});
+var OrderShippedEvent = defineEvent({
+  meta: {
+    key: "marketplace.order.shipped",
+    version: "1.0.0",
+    description: "An order has been shipped.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "order"]
+  },
+  payload: OrderShippedPayload
+});
+var OrderCompletedEvent = defineEvent({
+  meta: {
+    key: "marketplace.order.completed",
+    version: "1.0.0",
+    description: "An order has been completed.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "order"]
+  },
+  payload: OrderCompletedPayload
+});
+
+// src/order/order.schema.ts
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
+var OrderItemModel = defineSchemaModel2({
+  name: "OrderItemModel",
+  fields: {
+    id: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    productId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    productName: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    unitPrice: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    quantity: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
+    subtotal: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false }
+  }
+});
+var OrderModel = defineSchemaModel2({
+  name: "OrderModel",
+  description: "An order",
+  fields: {
+    id: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    orderNumber: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    buyerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    status: { type: OrderStatusEnum, isOptional: false },
+    subtotal: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    shippingTotal: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    taxTotal: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    total: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
     items: { type: OrderItemModel, isArray: true, isOptional: true },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+    createdAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
   }
 });
-var CreateOrderInputModel = defineSchemaModel({
+var CreateOrderInputModel = defineSchemaModel2({
   name: "CreateOrderInput",
   fields: {
-    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
     items: {
-      type: ScalarTypeEnum.JSON(),
+      type: ScalarTypeEnum2.JSON(),
       isOptional: false,
       description: "Array of {productId, variantId?, quantity}"
     },
-    shippingAddress: { type: ScalarTypeEnum.JSON(), isOptional: true },
-    billingAddress: { type: ScalarTypeEnum.JSON(), isOptional: true },
-    buyerNote: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+    shippingAddress: { type: ScalarTypeEnum2.JSON(), isOptional: true },
+    billingAddress: { type: ScalarTypeEnum2.JSON(), isOptional: true },
+    buyerNote: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
   }
 });
-var UpdateOrderStatusInputModel = defineSchemaModel({
+var UpdateOrderStatusInputModel = defineSchemaModel2({
   name: "UpdateOrderStatusInput",
   fields: {
-    orderId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    orderId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
     status: { type: OrderStatusEnum, isOptional: false },
     trackingNumber: {
-      type: ScalarTypeEnum.String_unsecure(),
+      type: ScalarTypeEnum2.String_unsecure(),
       isOptional: true
     },
-    trackingUrl: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    note: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+    trackingUrl: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    note: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
   }
 });
 
@@ -166,131 +291,6 @@ var UpdateOrderStatusContract = defineCommand({
     ]
   }
 });
-
-// src/order/order.event.ts
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
-import { defineEvent } from "@contractspec/lib.contracts-spec";
-var OrderCreatedPayload = defineSchemaModel2({
-  name: "OrderCreatedEventPayload",
-  fields: {
-    orderId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    orderNumber: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    buyerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    storeId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    total: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
-    currency: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    itemCount: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
-  }
-});
-var OrderPaidPayload = defineSchemaModel2({
-  name: "OrderPaidEventPayload",
-  fields: {
-    orderId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    orderNumber: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    total: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
-    paymentMethod: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: false
-    },
-    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
-  }
-});
-var OrderStatusUpdatedPayload = defineSchemaModel2({
-  name: "OrderStatusUpdatedEventPayload",
-  fields: {
-    orderId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    orderNumber: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    previousStatus: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: false
-    },
-    newStatus: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    updatedBy: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
-  }
-});
-var OrderShippedPayload = defineSchemaModel2({
-  name: "OrderShippedEventPayload",
-  fields: {
-    orderId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    orderNumber: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    trackingNumber: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    trackingUrl: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    carrier: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
-  }
-});
-var OrderCompletedPayload = defineSchemaModel2({
-  name: "OrderCompletedEventPayload",
-  fields: {
-    orderId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    orderNumber: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    buyerId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    storeId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    total: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
-    sellerPayout: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
-    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
-  }
-});
-var OrderCreatedEvent = defineEvent({
-  meta: {
-    key: "marketplace.order.created",
-    version: "1.0.0",
-    description: "A new order has been created.",
-    stability: "experimental",
-    owners: ["@marketplace-team"],
-    tags: ["marketplace", "order"]
-  },
-  payload: OrderCreatedPayload
-});
-var OrderPaidEvent = defineEvent({
-  meta: {
-    key: "marketplace.order.paid",
-    version: "1.0.0",
-    description: "An order has been paid.",
-    stability: "experimental",
-    owners: ["@marketplace-team"],
-    tags: ["marketplace", "order"]
-  },
-  payload: OrderPaidPayload
-});
-var OrderStatusUpdatedEvent = defineEvent({
-  meta: {
-    key: "marketplace.order.statusUpdated",
-    version: "1.0.0",
-    description: "An order status has been updated.",
-    stability: "experimental",
-    owners: ["@marketplace-team"],
-    tags: ["marketplace", "order"]
-  },
-  payload: OrderStatusUpdatedPayload
-});
-var OrderShippedEvent = defineEvent({
-  meta: {
-    key: "marketplace.order.shipped",
-    version: "1.0.0",
-    description: "An order has been shipped.",
-    stability: "experimental",
-    owners: ["@marketplace-team"],
-    tags: ["marketplace", "order"]
-  },
-  payload: OrderShippedPayload
-});
-var OrderCompletedEvent = defineEvent({
-  meta: {
-    key: "marketplace.order.completed",
-    version: "1.0.0",
-    description: "An order has been completed.",
-    stability: "experimental",
-    owners: ["@marketplace-team"],
-    tags: ["marketplace", "order"]
-  },
-  payload: OrderCompletedPayload
-});
 export {
   UpdateOrderStatusInputModel,
   UpdateOrderStatusContract,

package/dist/node/order/order.event.js

@@ -1,6 +1,6 @@
 // src/order/order.event.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OrderCreatedPayload = defineSchemaModel({
   name: "OrderCreatedEventPayload",
   fields: {