@contractspec/example.marketplace 1.56.1 → 1.58.0

package/dist/node/payout/payout.operations.js

@@ -0,0 +1,94 @@
+// src/payout/payout.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var PayoutStatusEnum = defineEnum("PayoutStatus", [
+  "PENDING",
+  "PROCESSING",
+  "PAID",
+  "FAILED",
+  "CANCELLED"
+]);
+
+// src/payout/payout.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var PayoutModel = defineSchemaModel({
+  name: "PayoutModel",
+  description: "A payout to seller",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    payoutNumber: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: PayoutStatusEnum, isOptional: false },
+    grossAmount: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    platformFees: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    netAmount: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    periodStart: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    periodEnd: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    orderCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    paidAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
+  }
+});
+var ListPayoutsInputModel = defineSchemaModel({
+  name: "ListPayoutsInput",
+  fields: {
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: PayoutStatusEnum, isOptional: true },
+    limit: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 20
+    },
+    offset: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 0
+    }
+  }
+});
+var ListPayoutsOutputModel = defineSchemaModel({
+  name: "ListPayoutsOutput",
+  fields: {
+    payouts: { type: PayoutModel, isArray: true, isOptional: false },
+    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    totalPending: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false }
+  }
+});
+
+// src/payout/payout.operations.ts
+import { defineQuery } from "@contractspec/lib.contracts/operations";
+var OWNERS = ["@example.marketplace"];
+var ListPayoutsContract = defineQuery({
+  meta: {
+    key: "marketplace.payout.list",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["marketplace", "payout", "list"],
+    description: "List payouts for a store.",
+    goal: "View payout history.",
+    context: "Seller dashboard."
+  },
+  io: { input: ListPayoutsInputModel, output: ListPayoutsOutputModel },
+  policy: { auth: "user" },
+  acceptance: {
+    scenarios: [
+      {
+        key: "list-payouts-happy-path",
+        given: ["Store has payout history"],
+        when: ["Seller lists payouts"],
+        then: ["List of payouts is returned"]
+      }
+    ],
+    examples: [
+      {
+        key: "list-recent",
+        input: { limit: 10, offset: 0 },
+        output: { items: [], total: 5, hasMore: false }
+      }
+    ]
+  }
+});
+export {
+  ListPayoutsContract
+};

package/dist/node/payout/payout.presentation.js

@@ -0,0 +1,111 @@
+// src/payout/payout.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var PayoutStatusEnum = defineEnum("PayoutStatus", [
+  "PENDING",
+  "PROCESSING",
+  "PAID",
+  "FAILED",
+  "CANCELLED"
+]);
+
+// src/payout/payout.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var PayoutModel = defineSchemaModel({
+  name: "PayoutModel",
+  description: "A payout to seller",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    payoutNumber: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: PayoutStatusEnum, isOptional: false },
+    grossAmount: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    platformFees: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    netAmount: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    periodStart: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    periodEnd: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    orderCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    paidAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
+  }
+});
+var ListPayoutsInputModel = defineSchemaModel({
+  name: "ListPayoutsInput",
+  fields: {
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: PayoutStatusEnum, isOptional: true },
+    limit: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 20
+    },
+    offset: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 0
+    }
+  }
+});
+var ListPayoutsOutputModel = defineSchemaModel({
+  name: "ListPayoutsOutput",
+  fields: {
+    payouts: { type: PayoutModel, isArray: true, isOptional: false },
+    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    totalPending: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false }
+  }
+});
+
+// src/payout/payout.presentation.ts
+import { definePresentation, StabilityEnum } from "@contractspec/lib.contracts";
+var PayoutListPresentation = definePresentation({
+  meta: {
+    key: "marketplace.payout.viewList",
+    version: "1.0.0",
+    title: "Payout List",
+    description: "List of payouts for sellers",
+    domain: "marketplace",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "payout", "list"],
+    stability: StabilityEnum.Experimental,
+    goal: "Show sellers their historical and pending payouts.",
+    context: "Financial dashboard for sellers."
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "PayoutList",
+    props: PayoutModel
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["marketplace.payouts.enabled"]
+  }
+});
+var PayoutDetailPresentation = definePresentation({
+  meta: {
+    key: "marketplace.payout.detail",
+    version: "1.0.0",
+    title: "Payout Details",
+    description: "Payout detail with breakdown",
+    domain: "marketplace",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "payout", "detail"],
+    stability: StabilityEnum.Experimental,
+    goal: "Show the breakdown of a specific payout including fees and orders.",
+    context: "Accessed from the payout list."
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "PayoutDetail",
+    props: PayoutModel
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["marketplace.payouts.enabled"]
+  }
+});
+export {
+  PayoutListPresentation,
+  PayoutDetailPresentation
+};

package/dist/node/payout/payout.schema.js

@@ -0,0 +1,61 @@
+// src/payout/payout.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var PayoutStatusEnum = defineEnum("PayoutStatus", [
+  "PENDING",
+  "PROCESSING",
+  "PAID",
+  "FAILED",
+  "CANCELLED"
+]);
+
+// src/payout/payout.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var PayoutModel = defineSchemaModel({
+  name: "PayoutModel",
+  description: "A payout to seller",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    payoutNumber: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: PayoutStatusEnum, isOptional: false },
+    grossAmount: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    platformFees: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    netAmount: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    periodStart: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    periodEnd: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    orderCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    paidAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
+  }
+});
+var ListPayoutsInputModel = defineSchemaModel({
+  name: "ListPayoutsInput",
+  fields: {
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: PayoutStatusEnum, isOptional: true },
+    limit: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 20
+    },
+    offset: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 0
+    }
+  }
+});
+var ListPayoutsOutputModel = defineSchemaModel({
+  name: "ListPayoutsOutput",
+  fields: {
+    payouts: { type: PayoutModel, isArray: true, isOptional: false },
+    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    totalPending: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false }
+  }
+});
+export {
+  PayoutModel,
+  ListPayoutsOutputModel,
+  ListPayoutsInputModel
+};

package/dist/node/product/index.js

@@ -0,0 +1,249 @@
+// src/product/product.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var ProductStatusEnum = defineEnum("ProductStatus", [
+  "DRAFT",
+  "PENDING_REVIEW",
+  "ACTIVE",
+  "OUT_OF_STOCK",
+  "DISCONTINUED",
+  "REJECTED"
+]);
+
+// src/product/product.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var ProductModel = defineSchemaModel({
+  name: "ProductModel",
+  description: "A product listing",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: ProductStatusEnum, isOptional: false },
+    price: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    categoryId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    primaryImageId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    averageRating: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    totalSold: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var CreateProductInputModel = defineSchemaModel({
+  name: "CreateProductInput",
+  fields: {
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    price: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    categoryId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    sku: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var ListProductsInputModel = defineSchemaModel({
+  name: "ListProductsInput",
+  fields: {
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    categoryId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: ProductStatusEnum, isOptional: true },
+    search: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    minPrice: { type: ScalarTypeEnum.Float_unsecure(), isOptional: true },
+    maxPrice: { type: ScalarTypeEnum.Float_unsecure(), isOptional: true },
+    limit: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 20
+    },
+    offset: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 0
+    }
+  }
+});
+var ListProductsOutputModel = defineSchemaModel({
+  name: "ListProductsOutput",
+  fields: {
+    products: { type: ProductModel, isArray: true, isOptional: false },
+    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
+  }
+});
+
+// src/product/product.operations.ts
+import {
+  defineCommand,
+  defineQuery
+} from "@contractspec/lib.contracts/operations";
+var OWNERS = ["@example.marketplace"];
+var CreateProductContract = defineCommand({
+  meta: {
+    key: "marketplace.product.create",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["marketplace", "product", "create"],
+    description: "Create a new product listing.",
+    goal: "Allow sellers to list products.",
+    context: "Product management."
+  },
+  io: { input: CreateProductInputModel, output: ProductModel },
+  policy: { auth: "user" },
+  sideEffects: {
+    emits: [
+      {
+        key: "marketplace.product.created",
+        version: "1.0.0",
+        when: "Product is created",
+        payload: ProductModel
+      }
+    ],
+    audit: ["marketplace.product.created"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "create-product-happy-path",
+        given: ["User is a seller"],
+        when: ["User creates a product listing"],
+        then: ["Product is created", "ProductCreated event is emitted"]
+      }
+    ],
+    examples: [
+      {
+        key: "create-t-shirt",
+        input: {
+          title: "Classic T-Shirt",
+          price: 25,
+          stock: 100,
+          storeId: "store-123"
+        },
+        output: {
+          id: "prod-456",
+          title: "Classic T-Shirt",
+          status: "published"
+        }
+      }
+    ]
+  }
+});
+var ListProductsContract = defineQuery({
+  meta: {
+    key: "marketplace.product.list",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["marketplace", "product", "list"],
+    description: "List products with filters.",
+    goal: "Browse products on the marketplace.",
+    context: "Product catalog, search."
+  },
+  io: { input: ListProductsInputModel, output: ListProductsOutputModel },
+  policy: { auth: "anonymous" },
+  acceptance: {
+    scenarios: [
+      {
+        key: "list-products-happy-path",
+        given: ["Products exist"],
+        when: ["User searches for products"],
+        then: ["List of products is returned"]
+      }
+    ],
+    examples: [
+      {
+        key: "search-t-shirts",
+        input: { search: "t-shirt", limit: 20 },
+        output: { items: [], total: 50, hasMore: true }
+      }
+    ]
+  }
+});
+
+// src/product/product.event.ts
+import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+var ProductCreatedPayload = defineSchemaModel2({
+  name: "ProductCreatedEventPayload",
+  fields: {
+    productId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    price: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var ProductPublishedPayload = defineSchemaModel2({
+  name: "ProductPublishedEventPayload",
+  fields: {
+    productId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var InventoryUpdatedPayload = defineSchemaModel2({
+  name: "InventoryUpdatedEventPayload",
+  fields: {
+    productId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    variantId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    previousQuantity: {
+      type: ScalarTypeEnum2.Int_unsecure(),
+      isOptional: false
+    },
+    newQuantity: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    timestamp: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var ProductCreatedEvent = defineEvent({
+  meta: {
+    key: "marketplace.product.created",
+    version: "1.0.0",
+    description: "A new product has been created.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "product"]
+  },
+  payload: ProductCreatedPayload
+});
+var ProductPublishedEvent = defineEvent({
+  meta: {
+    key: "marketplace.product.published",
+    version: "1.0.0",
+    description: "A product has been published.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "product"]
+  },
+  payload: ProductPublishedPayload
+});
+var InventoryUpdatedEvent = defineEvent({
+  meta: {
+    key: "marketplace.inventory.updated",
+    version: "1.0.0",
+    description: "Product inventory has been updated.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "product", "inventory"]
+  },
+  payload: InventoryUpdatedPayload
+});
+export {
+  ProductStatusEnum,
+  ProductPublishedEvent,
+  ProductModel,
+  ProductCreatedEvent,
+  ListProductsOutputModel,
+  ListProductsInputModel,
+  ListProductsContract,
+  InventoryUpdatedEvent,
+  CreateProductInputModel,
+  CreateProductContract
+};

package/dist/node/product/product.enum.js

@@ -0,0 +1,13 @@
+// src/product/product.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var ProductStatusEnum = defineEnum("ProductStatus", [
+  "DRAFT",
+  "PENDING_REVIEW",
+  "ACTIVE",
+  "OUT_OF_STOCK",
+  "DISCONTINUED",
+  "REJECTED"
+]);
+export {
+  ProductStatusEnum
+};

package/dist/node/product/product.event.js

@@ -0,0 +1,74 @@
+// src/product/product.event.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+var ProductCreatedPayload = defineSchemaModel({
+  name: "ProductCreatedEventPayload",
+  fields: {
+    productId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    price: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    currency: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ProductPublishedPayload = defineSchemaModel({
+  name: "ProductPublishedEventPayload",
+  fields: {
+    productId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    storeId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var InventoryUpdatedPayload = defineSchemaModel({
+  name: "InventoryUpdatedEventPayload",
+  fields: {
+    productId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    variantId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    previousQuantity: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false
+    },
+    newQuantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ProductCreatedEvent = defineEvent({
+  meta: {
+    key: "marketplace.product.created",
+    version: "1.0.0",
+    description: "A new product has been created.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "product"]
+  },
+  payload: ProductCreatedPayload
+});
+var ProductPublishedEvent = defineEvent({
+  meta: {
+    key: "marketplace.product.published",
+    version: "1.0.0",
+    description: "A product has been published.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "product"]
+  },
+  payload: ProductPublishedPayload
+});
+var InventoryUpdatedEvent = defineEvent({
+  meta: {
+    key: "marketplace.inventory.updated",
+    version: "1.0.0",
+    description: "Product inventory has been updated.",
+    stability: "experimental",
+    owners: ["@marketplace-team"],
+    tags: ["marketplace", "product", "inventory"]
+  },
+  payload: InventoryUpdatedPayload
+});
+export {
+  ProductPublishedEvent,
+  ProductCreatedEvent,
+  InventoryUpdatedEvent
+};