@final-commerce/command-frame 0.1.5 → 0.1.7

package/README.md

@@ -14,7 +14,8 @@ This package is available on the public NPM registry.
 
 - [API Overview](#api-overview)
 - [Quick Start](#quick-start)
-- [Actions Documentation](#actions-documentation)
+- [Commands Documentation](#commands-documentation)
+- [Pub/Sub System](#pubsub-system)
 - [Examples](#examples)
 - [Debugging](#debugging)
 - [Type Safety](#type-safety)
@@ -22,9 +23,9 @@ This package is available on the public NPM registry.
 
 ## API Overview
 
-The library provides a `command` namespace object containing all available actions. Each action is a typed function that communicates with the parent window via postMessage.
+The library provides a `command` namespace object containing all available commands. Each command is a typed function that communicates with the parent window via postMessage.
 
-### Available Actions
+### Available Commands
 
 #### Data Retrieval
 - **[getCustomers](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-customers/README.md)** - Retrieve a list of customers from the parent application
@@ -94,7 +95,7 @@ The library provides a `command` namespace object containing all available actio
 #### Reference
 - **[exampleFunction](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/example-function/README.md)** - Example/template function (for reference only)
 
-For detailed documentation on each action, including parameter descriptions, response structures, and usage examples, see the [Actions Documentation](#actions-documentation) section below.
+For detailed documentation on each command, including parameter descriptions, response structures, and usage examples, see the [Commands Documentation](#commands-documentation) section below.
 
 ## Quick Start
 
@@ -144,347 +145,12 @@ console.log('Current company:', context.companyName);
 console.log('Current build:', context.buildName);
 ```
 
-For complete usage examples and detailed parameter descriptions, see the documentation for each action in the [Actions Documentation](#actions-documentation) section.
+For complete usage examples and detailed parameter descriptions, see the documentation for each command in the [Commands Documentation](#commands-documentation) section.
 
-## Pub/Sub System
-
-The library includes a pub/sub system that allows iframe apps to subscribe to topics and receive events published by the host application (Render).
-
-### Quick Start - Pub/Sub
-
-```typescript
-import { topics } from '@final-commerce/command-frame';
-
-// Get available topics
-const availableTopics = await topics.getTopics();
-console.log('Available topics:', availableTopics);
-
-// Subscribe to a topic with a callback
-const subscriptionId = topics.subscribe('customers', (event) => {
-  if (event.type === 'customer-created') {
-    console.log('New customer created:', event.data);
-    // Handle the event
-  }
-});
-
-// Later, unsubscribe when done
-topics.unsubscribe('customers', subscriptionId);
-```
-
-### Pub/Sub API
-
-#### `topics.getTopics()`
 
-Retrieves the list of available topics from the host application.
+## Commands Documentation
 
-**Returns:** `Promise<TopicDefinition[]>`
-
-**Example:**
-```typescript
-const topics = await topics.getTopics();
-topics.forEach(topic => {
-  console.log(`Topic: ${topic.name} (${topic.id})`);
-  console.log(`Event types: ${topic.eventTypes.map(et => et.id).join(', ')}`);
-});
-```
-
-#### `topics.subscribe(topic, callback)`
-
-Subscribes to a topic and receives events via the callback function.
-
-**Parameters:**
-- `topic: string` - The topic ID to subscribe to
-- `callback: (event: TopicEvent) => void` - Function called when an event is received
-
-**Returns:** `string` - Subscription ID (use this to unsubscribe)
-
-**Example:**
-```typescript
-const subscriptionId = topics.subscribe('customers', (event) => {
-  console.log('Received event:', event.type);
-  console.log('Event data:', event.data);
-  console.log('Timestamp:', event.timestamp);
-});
-```
-
-#### `topics.unsubscribe(topic, subscriptionId)`
-
-Unsubscribes from a topic using the subscription ID returned from `subscribe()`.
-
-**Parameters:**
-- `topic: string` - The topic ID
-- `subscriptionId: string` - The subscription ID returned from `subscribe()`
-
-**Returns:** `boolean` - `true` if successfully unsubscribed
-
-**Example:**
-```typescript
-const success = topics.unsubscribe('customers', subscriptionId);
-```
-
-#### `topics.unsubscribeAll(topic)`
-
-Unsubscribes all callbacks for a specific topic.
-
-**Parameters:**
-- `topic: string` - The topic ID
-
-**Returns:** `number` - Number of subscriptions removed
-
-**Example:**
-```typescript
-const removed = topics.unsubscribeAll('customers');
-console.log(`Removed ${removed} subscriptions`);
-```
-
-### Topic and Event Types
-
-```typescript
-interface TopicDefinition {
-  id: string;
-  name: string;
-  description?: string;
-  eventTypes: TopicEventType[];
-}
-
-interface TopicEvent<T = any> {
-  topic: string;
-  type: string;
-  data: T;
-  timestamp: string;
-}
-```
-
-### Example: React Component with Pub/Sub
-
-```typescript
-import { useEffect, useState } from 'react';
-import { topics, type TopicEvent } from '@final-commerce/command-frame';
-
-function CustomerEvents() {
-  const [events, setEvents] = useState<TopicEvent[]>([]);
-
-  useEffect(() => {
-    // Subscribe on mount
-    const subscriptionId = topics.subscribe('customers', (event) => {
-      if (event.type === 'customer-created') {
-        setEvents(prev => [event, ...prev]);
-      }
-    });
-
-    // Unsubscribe on unmount
-    return () => {
-      topics.unsubscribe('customers', subscriptionId);
-    };
-  }, []);
-
-  return (
-    <div>
-      <h2>Customer Events ({events.length})</h2>
-      {events.map((event, index) => (
-        <div key={index}>
-          <p>Type: {event.type}</p>
-          <pre>{JSON.stringify(event.data, null, 2)}</pre>
-        </div>
-      ))}
-    </div>
-  );
-}
-```
-
-### Available Topics
-
-#### Customers Topic (`customers`)
-
-The customers topic provides events related to customer lifecycle and cart assignment.
-
-**Event Types:**
-
-1. **`customer-created`** - Fired when a new customer is created
-   - **Event Data:**
-     ```typescript
-     {
-       customer: {
-         _id: string;
-         companyId: string;
-         email: string;
-         firstName: string;
-         lastName: string;
-         phone?: string;
-         tags?: string[];
-         metadata?: Record<string, string>[];
-         notes?: CustomerNote[];
-         billing: Address | null;
-         shipping: Address | null;
-         createdAt: string;
-         updatedAt: string;
-         // ... other customer fields
-       }
-     }
-     ```
-
-2. **`customer-updated`** - Fired when a customer's information is updated
-   - **Event Data:**
-     ```typescript
-     {
-       customer: {
-         // Updated customer object with all fields
-       }
-     }
-     ```
-
-3. **`customer-note-added`** - Fired when a note is added to a customer
-   - **Event Data:**
-     ```typescript
-     {
-       customer: {
-         // Customer object with updated notes array
-       },
-       note: {
-         createdAt: string;
-         message: string;
-       }
-     }
-     ```
-
-4. **`customer-note-deleted`** - Fired when a note is deleted from a customer
-   - **Event Data:**
-     ```typescript
-     {
-       customer: {
-         // Customer object with updated notes array
-       },
-       note: {
-         createdAt: string;
-         message: string;
-       }
-     }
-     ```
-
-5. **`customer-assigned`** - Fired when a customer is assigned to the cart
-   - **Event Data:**
-     ```typescript
-     {
-       customer: {
-         // Full customer object
-       }
-     }
-     ```
-
-6. **`customer-unassigned`** - Fired when a customer is unassigned from the cart
-   - **Event Data:**
-     ```typescript
-     {
-       customer: {
-         // Full customer object (before removal)
-       }
-     }
-     ```
-
-**Example: Subscribing to Customer Events**
-
-```typescript
-import { topics, type TopicEvent } from '@final-commerce/command-frame';
-
-// Subscribe to all customer events
-const subscriptionId = topics.subscribe('customers', (event: TopicEvent) => {
-  switch (event.type) {
-    case 'customer-created':
-      console.log('New customer created:', event.data.customer);
-      // Update your customer list, show notification, etc.
-      break;
-    
-    case 'customer-updated':
-      console.log('Customer updated:', event.data.customer);
-      // Refresh customer details in your UI
-      break;
-    
-    case 'customer-note-added':
-      console.log('Note added to customer:', event.data.customer._id);
-      console.log('Note:', event.data.note);
-      // Update customer notes display
-      break;
-    
-    case 'customer-note-deleted':
-      console.log('Note deleted from customer:', event.data.customer._id);
-      // Update customer notes display
-      break;
-    
-    case 'customer-assigned':
-      console.log('Customer assigned to cart:', event.data.customer);
-      // Update cart UI to show customer info
-      break;
-    
-    case 'customer-unassigned':
-      console.log('Customer unassigned from cart:', event.data.customer);
-      // Clear customer info from cart UI
-      break;
-  }
-});
-
-// Later, unsubscribe
-topics.unsubscribe('customers', subscriptionId);
-```
-
-**Example: Filtering Specific Event Types**
-
-```typescript
-import { topics, type TopicEvent } from '@final-commerce/command-frame';
-
-// Only listen for customer assignment/unassignment
-const subscriptionId = topics.subscribe('customers', (event: TopicEvent) => {
-  if (event.type === 'customer-assigned' || event.type === 'customer-unassigned') {
-    console.log(`Customer ${event.type}:`, event.data.customer);
-    // Update your cart UI accordingly
-  }
-});
-```
-
-### Host Application (Render) - Publishing Events
-
-In the Render application, use the `topicPublisher` to publish events:
-
-```typescript
-import { topicPublisher } from '@render/command-frame';
-
-// When a customer is created
-topicPublisher.publish('customers', 'customer-created', {
-  customer: newCustomer
-});
-
-// When a customer is updated
-topicPublisher.publish('customers', 'customer-updated', {
-  customer: updatedCustomer
-});
-
-// When a note is added to a customer
-topicPublisher.publish('customers', 'customer-note-added', {
-  customer: updatedCustomer,
-  note: newNote
-});
-
-// When a note is deleted from a customer
-topicPublisher.publish('customers', 'customer-note-deleted', {
-  customer: updatedCustomer,
-  note: deletedNote
-});
-
-// When a customer is assigned to the cart
-topicPublisher.publish('customers', 'customer-assigned', {
-  customer: customer
-});
-
-// When a customer is unassigned from the cart
-topicPublisher.publish('customers', 'customer-unassigned', {
-  customer: customer
-});
-```
-
-The host application must register topics before they can be used. Topics are registered automatically when the `TopicPublisher` is initialized. See the Render application's pub/sub implementation for details on topic registration.
-
-## Actions Documentation
-
-Each action has detailed documentation with complete parameter descriptions, response structures, and multiple usage examples:
+Each command has detailed documentation with complete parameter descriptions, response structures, and multiple usage examples:
 
 ### [getCustomers](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-customers/README.md)
 
@@ -702,7 +368,55 @@ Triggers a Zapier webhook with the current context data (cart, customer, order,
 
 ### [exampleFunction](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/example-function/README.md)
 
-An example/template function for reference. See the documentation for the structure to follow when creating new actions.
+An example/template function for reference. See the documentation for the structure to follow when creating new commands.
+
+## Pub/Sub System
+
+The library includes a pub/sub system that allows iframe apps to subscribe to topics and receive events published by the host application (Render).
+
+### Available Topics
+
+#### Customer Events
+- **[customers](https://github.com/Final-Commerce/command-frame/blob/main/src/pubsub/topics/customers/README.md)** - Customer lifecycle events
+  - `customer-created` - Fired when a new customer is created
+  - `customer-updated` - Fired when a customer's information is updated
+  - `customer-note-added` - Fired when a note is added to a customer
+  - `customer-note-deleted` - Fired when a note is deleted from a customer
+  - `customer-assigned` - Fired when a customer is assigned to the cart
+  - `customer-unassigned` - Fired when a customer is unassigned from the cart
+
+#### Order Events
+- **[orders](https://github.com/Final-Commerce/command-frame/blob/main/src/pubsub/topics/orders/README.md)** - Order lifecycle events
+  - `order-created` - Fired when a new order is created
+  - `order-updated` - Fired when an order is updated
+
+#### Refund Events
+- **[refunds](https://github.com/Final-Commerce/command-frame/blob/main/src/pubsub/topics/refunds/README.md)** - Refund lifecycle events
+  - `refund-created` - Fired when a refund is created
+  - `refund-updated` - Fired when a refund is updated
+
+#### Product Events
+- **[products](https://github.com/Final-Commerce/command-frame/blob/main/src/pubsub/topics/products/README.md)** - Product sync events
+  - `product-created` - Fired when a product is created
+  - `product-updated` - Fired when a product is updated
+
+#### Cart Events
+- **[cart](https://github.com/Final-Commerce/command-frame/blob/main/src/pubsub/topics/cart/README.md)** - Cart operation events
+  - `cart-created` - Fired when a cart is created
+  - `customer-assigned` - Fired when a customer is assigned to the cart
+  - `product-added` - Fired when a product is added to the cart
+  - `product-deleted` - Fired when a product is removed from the cart
+  - `cart-discount-added` - Fired when a discount is added to the cart
+  - `cart-discount-removed` - Fired when a discount is removed from the cart
+  - `cart-fee-added` - Fired when a fee is added to the cart
+  - `cart-fee-removed` - Fired when a fee is removed from the cart
+
+#### Payment Events
+- **[payments](https://github.com/Final-Commerce/command-frame/blob/main/src/pubsub/topics/payments/README.md)** - Payment processing events
+  - `payment-done` - Fired when a payment is successfully completed
+  - `payment-err` - Fired when a payment fails
+
+For detailed documentation on each topic and its events, including payload structures and usage examples, see the [Pub/Sub Documentation](https://github.com/Final-Commerce/command-frame/blob/main/src/pubsub/README.md).
 
 ## Examples
 
@@ -733,7 +447,7 @@ This will log all postMessage communication to the console, including:
 
 ## Type Safety
 
-All actions are fully typed with TypeScript. Import types for use in your code:
+All commands are fully typed with TypeScript. Import types for use in your code:
 
 ```typescript
 import type {

package/dist/index.d.ts

@@ -111,4 +111,14 @@ export type { PostMessageRequest, PostMessageResponse } from "./client";
 export { topics } from "./pubsub/topic";
 export type { TopicDefinition, TopicEvent, TopicEventType, TopicSubscriptionCallback, TopicSubscription } from "./pubsub/types";
 export { customersTopic } from "./pubsub/topics/customers";
+export { ordersTopic } from "./pubsub/topics/orders";
+export { refundsTopic } from "./pubsub/topics/refunds";
+export { productsTopic } from "./pubsub/topics/products";
+export { cartTopic } from "./pubsub/topics/cart";
+export { paymentsTopic } from "./pubsub/topics/payments";
 export type { CustomerCreatedPayload, CustomerUpdatedPayload, CustomerNoteAddedPayload, CustomerNoteDeletedPayload, CustomerAssignedPayload, CustomerUnassignedPayload, CustomerCreatedEvent, CustomerUpdatedEvent, CustomerNoteAddedEvent, CustomerNoteDeletedEvent, CustomerAssignedEvent, CustomerUnassignedEvent, CustomersEventType, CustomersEventPayload } from "./pubsub/topics/customers/types";
+export type { OrderCreatedPayload, OrderUpdatedPayload, OrderCreatedEvent, OrderUpdatedEvent, OrdersEventType, OrdersEventPayload } from "./pubsub/topics/orders/types";
+export type { RefundCreatedPayload, RefundUpdatedPayload, RefundCreatedEvent, RefundUpdatedEvent, RefundsEventType, RefundsEventPayload } from "./pubsub/topics/refunds/types";
+export type { ProductCreatedPayload, ProductUpdatedPayload, ProductCreatedEvent, ProductUpdatedEvent, ProductsEventType, ProductsEventPayload } from "./pubsub/topics/products/types";
+export type { CartCreatedPayload, CartCustomerAssignedPayload, ProductAddedPayload, ProductDeletedPayload, CartDiscountAddedPayload, CartDiscountRemovedPayload, CartFeeAddedPayload, CartFeeRemovedPayload, CartCreatedEvent, CartCustomerAssignedEvent, ProductAddedEvent, ProductDeletedEvent, CartDiscountAddedEvent, CartDiscountRemovedEvent, CartFeeAddedEvent, CartFeeRemovedEvent, CartEventType, CartEventPayload } from "./pubsub/topics/cart/types";
+export type { PaymentDonePayload, PaymentErrPayload, PaymentDoneEvent, PaymentErrEvent, PaymentsEventType, PaymentsEventPayload } from "./pubsub/topics/payments/types";

package/dist/index.js

@@ -125,3 +125,8 @@ export { commandFrameClient, CommandFrameClient } from "./client";
 export { topics } from "./pubsub/topic";
 // Export Pub/Sub Topics
 export { customersTopic } from "./pubsub/topics/customers";
+export { ordersTopic } from "./pubsub/topics/orders";
+export { refundsTopic } from "./pubsub/topics/refunds";
+export { productsTopic } from "./pubsub/topics/products";
+export { cartTopic } from "./pubsub/topics/cart";
+export { paymentsTopic } from "./pubsub/topics/payments";

package/dist/pubsub/topics/cart/cart-created/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFActiveCart } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for cart-created event
+ */
+export interface CartCreatedPayload {
+    cart: CFActiveCart;
+}
+/**
+ * Typed event for cart-created
+ */
+export type CartCreatedEvent = TopicEvent<CartCreatedPayload>;

package/dist/pubsub/topics/cart/cart-created/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/cart/cart-discount-added/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFDiscount } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for cart-discount-added event
+ */
+export interface CartDiscountAddedPayload {
+    discount: CFDiscount;
+}
+/**
+ * Typed event for cart-discount-added
+ */
+export type CartDiscountAddedEvent = TopicEvent<CartDiscountAddedPayload>;

package/dist/pubsub/topics/cart/cart-discount-added/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/cart/cart-discount-removed/types.d.ts

@@ -0,0 +1,10 @@
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for cart-discount-removed event
+ */
+export interface CartDiscountRemovedPayload {
+}
+/**
+ * Typed event for cart-discount-removed
+ */
+export type CartDiscountRemovedEvent = TopicEvent<CartDiscountRemovedPayload>;

package/dist/pubsub/topics/cart/cart-discount-removed/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/cart/cart-fee-added/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFCustomFee } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for cart-fee-added event
+ */
+export interface CartFeeAddedPayload {
+    fee: CFCustomFee;
+}
+/**
+ * Typed event for cart-fee-added
+ */
+export type CartFeeAddedEvent = TopicEvent<CartFeeAddedPayload>;

package/dist/pubsub/topics/cart/cart-fee-added/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/cart/cart-fee-removed/types.d.ts

@@ -0,0 +1,11 @@
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for cart-fee-removed event
+ */
+export interface CartFeeRemovedPayload {
+    feeIndex: number;
+}
+/**
+ * Typed event for cart-fee-removed
+ */
+export type CartFeeRemovedEvent = TopicEvent<CartFeeRemovedPayload>;

package/dist/pubsub/topics/cart/cart-fee-removed/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/cart/customer-assigned/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFCustomer } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for customer-assigned event (in cart context)
+ */
+export interface CartCustomerAssignedPayload {
+    customer: CFCustomer;
+}
+/**
+ * Typed event for customer-assigned (in cart context)
+ */
+export type CartCustomerAssignedEvent = TopicEvent<CartCustomerAssignedPayload>;

package/dist/pubsub/topics/cart/customer-assigned/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/cart/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Cart Topic Definition
+ * Defines the cart topic and its available event types
+ */
+import type { TopicDefinition } from "../../types";
+export declare const cartTopic: TopicDefinition;
+export * from "./types";

package/dist/pubsub/topics/cart/index.js

@@ -0,0 +1,53 @@
+/**
+ * Cart Topic Definition
+ * Defines the cart topic and its available event types
+ */
+export const cartTopic = {
+    id: "cart",
+    name: "Cart",
+    description: "Topic for cart-related events",
+    eventTypes: [
+        {
+            id: "cart-created",
+            name: "Cart Created",
+            description: "Fired when a new cart is created"
+        },
+        {
+            id: "customer-assigned",
+            name: "Customer Assigned",
+            description: "Fired when a customer is assigned to the cart"
+        },
+        {
+            id: "product-added",
+            name: "Product Added",
+            description: "Fired when a product is added to the cart"
+        },
+        {
+            id: "product-deleted",
+            name: "Product Deleted",
+            description: "Fired when a product is removed from the cart"
+        },
+        {
+            id: "cart-discount-added",
+            name: "Cart Discount Added",
+            description: "Fired when a discount is added to the cart"
+        },
+        {
+            id: "cart-discount-removed",
+            name: "Cart Discount Removed",
+            description: "Fired when a discount is removed from the cart"
+        },
+        {
+            id: "cart-fee-added",
+            name: "Cart Fee Added",
+            description: "Fired when a fee is added to the cart"
+        },
+        {
+            id: "cart-fee-removed",
+            name: "Cart Fee Removed",
+            description: "Fired when a fee is removed from the cart"
+        }
+    ]
+};
+// Re-export types
+export * from "./types";

package/dist/pubsub/topics/cart/product-added/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFActiveProduct } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for product-added event
+ */
+export interface ProductAddedPayload {
+    product: CFActiveProduct;
+}
+/**
+ * Typed event for product-added
+ */
+export type ProductAddedEvent = TopicEvent<ProductAddedPayload>;

package/dist/pubsub/topics/cart/product-added/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/cart/product-deleted/types.d.ts

@@ -0,0 +1,13 @@
+import type { CFActiveProduct } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for product-deleted event
+ */
+export interface ProductDeletedPayload {
+    product: CFActiveProduct;
+    internalId: string;
+}
+/**
+ * Typed event for product-deleted
+ */
+export type ProductDeletedEvent = TopicEvent<ProductDeletedPayload>;

package/dist/pubsub/topics/cart/product-deleted/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/cart/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Cart Topic Types
+ * Aggregated types for all cart-related events
+ */
+export * from "./cart-created/types";
+export * from "./customer-assigned/types";
+export * from "./product-added/types";
+export * from "./product-deleted/types";
+export * from "./cart-discount-added/types";
+export * from "./cart-discount-removed/types";
+export * from "./cart-fee-added/types";
+export * from "./cart-fee-removed/types";
+import type { CartCreatedPayload } from "./cart-created/types";
+import type { CartCustomerAssignedPayload } from "./customer-assigned/types";
+import type { ProductAddedPayload } from "./product-added/types";
+import type { ProductDeletedPayload } from "./product-deleted/types";
+import type { CartDiscountAddedPayload } from "./cart-discount-added/types";
+import type { CartDiscountRemovedPayload } from "./cart-discount-removed/types";
+import type { CartFeeAddedPayload } from "./cart-fee-added/types";
+import type { CartFeeRemovedPayload } from "./cart-fee-removed/types";
+export type CartEventPayload = CartCreatedPayload | CartCustomerAssignedPayload | ProductAddedPayload | ProductDeletedPayload | CartDiscountAddedPayload | CartDiscountRemovedPayload | CartFeeAddedPayload | CartFeeRemovedPayload;
+export type CartEventType = "cart-created" | "customer-assigned" | "product-added" | "product-deleted" | "cart-discount-added" | "cart-discount-removed" | "cart-fee-added" | "cart-fee-removed";

package/dist/pubsub/topics/cart/types.js

@@ -0,0 +1,13 @@
+/**
+ * Cart Topic Types
+ * Aggregated types for all cart-related events
+ */
+// Re-export all event types
+export * from "./cart-created/types";
+export * from "./customer-assigned/types";
+export * from "./product-added/types";
+export * from "./product-deleted/types";
+export * from "./cart-discount-added/types";
+export * from "./cart-discount-removed/types";
+export * from "./cart-fee-added/types";
+export * from "./cart-fee-removed/types";

package/dist/pubsub/topics/index.d.ts

@@ -3,3 +3,8 @@
  * Export all available topics and their types
  */
 export * from "./customers";
+export * from "./orders";
+export * from "./refunds";
+export * from "./products";
+export * from "./cart";
+export * from "./payments";

package/dist/pubsub/topics/index.js

@@ -3,3 +3,8 @@
  * Export all available topics and their types
  */
 export * from "./customers";
+export * from "./orders";
+export * from "./refunds";
+export * from "./products";
+export * from "./cart";
+export * from "./payments";

package/dist/pubsub/topics/orders/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Orders Topic Definition
+ * Defines the orders topic and its available event types
+ */
+import type { TopicDefinition } from "../../types";
+export declare const ordersTopic: TopicDefinition;
+export * from "./types";

package/dist/pubsub/topics/orders/index.js

@@ -0,0 +1,23 @@
+/**
+ * Orders Topic Definition
+ * Defines the orders topic and its available event types
+ */
+export const ordersTopic = {
+    id: "orders",
+    name: "Orders",
+    description: "Topic for order-related events",
+    eventTypes: [
+        {
+            id: "order-created",
+            name: "Order Created",
+            description: "Fired when a new order is created"
+        },
+        {
+            id: "order-updated",
+            name: "Order Updated",
+            description: "Fired when an order is updated"
+        }
+    ]
+};
+// Re-export types
+export * from "./types";

package/dist/pubsub/topics/orders/order-created/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFOrder } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for order-created event
+ */
+export interface OrderCreatedPayload {
+    order: CFOrder;
+}
+/**
+ * Typed event for order-created
+ */
+export type OrderCreatedEvent = TopicEvent<OrderCreatedPayload>;

package/dist/pubsub/topics/orders/order-created/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/orders/order-updated/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFOrder } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for order-updated event
+ */
+export interface OrderUpdatedPayload {
+    order: CFOrder;
+}
+/**
+ * Typed event for order-updated
+ */
+export type OrderUpdatedEvent = TopicEvent<OrderUpdatedPayload>;

package/dist/pubsub/topics/orders/order-updated/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/orders/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Orders Topic Types
+ * Aggregated types for all order-related events
+ */
+export * from "./order-created/types";
+export * from "./order-updated/types";
+import type { OrderCreatedPayload } from "./order-created/types";
+import type { OrderUpdatedPayload } from "./order-updated/types";
+export type OrdersEventPayload = OrderCreatedPayload | OrderUpdatedPayload;
+export type OrdersEventType = "order-created" | "order-updated";

package/dist/pubsub/topics/orders/types.js

@@ -0,0 +1,7 @@
+/**
+ * Orders Topic Types
+ * Aggregated types for all order-related events
+ */
+// Re-export all event types
+export * from "./order-created/types";
+export * from "./order-updated/types";

package/dist/pubsub/topics/payments/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Payments Topic Definition
+ * Defines the payments topic and its available event types
+ */
+import type { TopicDefinition } from "../../types";
+export declare const paymentsTopic: TopicDefinition;
+export * from "./types";

package/dist/pubsub/topics/payments/index.js

@@ -0,0 +1,23 @@
+/**
+ * Payments Topic Definition
+ * Defines the payments topic and its available event types
+ */
+export const paymentsTopic = {
+    id: "payments",
+    name: "Payments",
+    description: "Topic for payment-related events",
+    eventTypes: [
+        {
+            id: "payment-done",
+            name: "Payment Done",
+            description: "Fired when a payment is successfully completed"
+        },
+        {
+            id: "payment-err",
+            name: "Payment Error",
+            description: "Fired when a payment error occurs"
+        }
+    ]
+};
+// Re-export types
+export * from "./types";

package/dist/pubsub/topics/payments/payment-done/types.d.ts

@@ -0,0 +1,14 @@
+import type { CFPaymentMethod, CFOrder } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for payment-done event
+ */
+export interface PaymentDonePayload {
+    payment: CFPaymentMethod;
+    order: CFOrder;
+    amount: string;
+}
+/**
+ * Typed event for payment-done
+ */
+export type PaymentDoneEvent = TopicEvent<PaymentDonePayload>;

package/dist/pubsub/topics/payments/payment-done/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/payments/payment-err/types.d.ts

@@ -0,0 +1,14 @@
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for payment-err event
+ */
+export interface PaymentErrPayload {
+    error: string;
+    errorCode?: string;
+    paymentType?: string;
+    amount?: string;
+}
+/**
+ * Typed event for payment-err
+ */
+export type PaymentErrEvent = TopicEvent<PaymentErrPayload>;

package/dist/pubsub/topics/payments/payment-err/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/payments/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Payments Topic Types
+ * Aggregated types for all payment-related events
+ */
+export * from "./payment-done/types";
+export * from "./payment-err/types";
+import type { PaymentDonePayload } from "./payment-done/types";
+import type { PaymentErrPayload } from "./payment-err/types";
+export type PaymentsEventPayload = PaymentDonePayload | PaymentErrPayload;
+export type PaymentsEventType = "payment-done" | "payment-err";

package/dist/pubsub/topics/payments/types.js

@@ -0,0 +1,7 @@
+/**
+ * Payments Topic Types
+ * Aggregated types for all payment-related events
+ */
+// Re-export all event types
+export * from "./payment-done/types";
+export * from "./payment-err/types";

package/dist/pubsub/topics/products/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Products Topic Definition
+ * Defines the products topic and its available event types
+ */
+import type { TopicDefinition } from "../../types";
+export declare const productsTopic: TopicDefinition;
+export * from "./types";

package/dist/pubsub/topics/products/index.js

@@ -0,0 +1,23 @@
+/**
+ * Products Topic Definition
+ * Defines the products topic and its available event types
+ */
+export const productsTopic = {
+    id: "products",
+    name: "Products",
+    description: "Topic for product-related events",
+    eventTypes: [
+        {
+            id: "product-created",
+            name: "Product Created",
+            description: "Fired when a new product is synced/created"
+        },
+        {
+            id: "product-updated",
+            name: "Product Updated",
+            description: "Fired when a product is synced/updated"
+        }
+    ]
+};
+// Re-export types
+export * from "./types";

package/dist/pubsub/topics/products/product-created/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFProduct } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for product-created event
+ */
+export interface ProductCreatedPayload {
+    product: CFProduct;
+}
+/**
+ * Typed event for product-created
+ */
+export type ProductCreatedEvent = TopicEvent<ProductCreatedPayload>;

package/dist/pubsub/topics/products/product-created/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/products/product-updated/types.d.ts

@@ -0,0 +1,12 @@
+import type { CFProduct } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for product-updated event
+ */
+export interface ProductUpdatedPayload {
+    product: CFProduct;
+}
+/**
+ * Typed event for product-updated
+ */
+export type ProductUpdatedEvent = TopicEvent<ProductUpdatedPayload>;

package/dist/pubsub/topics/products/product-updated/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/products/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Products Topic Types
+ * Aggregated types for all product-related events
+ */
+export * from "./product-created/types";
+export * from "./product-updated/types";
+import type { ProductCreatedPayload } from "./product-created/types";
+import type { ProductUpdatedPayload } from "./product-updated/types";
+export type ProductsEventPayload = ProductCreatedPayload | ProductUpdatedPayload;
+export type ProductsEventType = "product-created" | "product-updated";

package/dist/pubsub/topics/products/types.js

@@ -0,0 +1,7 @@
+/**
+ * Products Topic Types
+ * Aggregated types for all product-related events
+ */
+// Re-export all event types
+export * from "./product-created/types";
+export * from "./product-updated/types";

package/dist/pubsub/topics/refunds/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Refunds Topic Definition
+ * Defines the refunds topic and its available event types
+ */
+import type { TopicDefinition } from "../../types";
+export declare const refundsTopic: TopicDefinition;
+export * from "./types";

package/dist/pubsub/topics/refunds/index.js

@@ -0,0 +1,23 @@
+/**
+ * Refunds Topic Definition
+ * Defines the refunds topic and its available event types
+ */
+export const refundsTopic = {
+    id: "refunds",
+    name: "Refunds",
+    description: "Topic for refund-related events",
+    eventTypes: [
+        {
+            id: "refund-created",
+            name: "Refund Created",
+            description: "Fired when a new refund is created"
+        },
+        {
+            id: "refund-updated",
+            name: "Refund Updated",
+            description: "Fired when a refund is updated"
+        }
+    ]
+};
+// Re-export types
+export * from "./types";

package/dist/pubsub/topics/refunds/refund-created/types.d.ts

@@ -0,0 +1,13 @@
+import type { CFRefundItem } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for refund-created event
+ */
+export interface RefundCreatedPayload {
+    refund: CFRefundItem;
+    orderId: string;
+}
+/**
+ * Typed event for refund-created
+ */
+export type RefundCreatedEvent = TopicEvent<RefundCreatedPayload>;

package/dist/pubsub/topics/refunds/refund-created/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/refunds/refund-updated/types.d.ts

@@ -0,0 +1,13 @@
+import type { CFRefundItem } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+/**
+ * Payload for refund-updated event
+ */
+export interface RefundUpdatedPayload {
+    refund: CFRefundItem;
+    orderId: string;
+}
+/**
+ * Typed event for refund-updated
+ */
+export type RefundUpdatedEvent = TopicEvent<RefundUpdatedPayload>;

package/dist/pubsub/topics/refunds/refund-updated/types.js

@@ -0,0 +1 @@
+export {};

package/dist/pubsub/topics/refunds/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Refunds Topic Types
+ * Aggregated types for all refund-related events
+ */
+export * from "./refund-created/types";
+export * from "./refund-updated/types";
+import type { RefundCreatedPayload } from "./refund-created/types";
+import type { RefundUpdatedPayload } from "./refund-updated/types";
+export type RefundsEventPayload = RefundCreatedPayload | RefundUpdatedPayload;
+export type RefundsEventType = "refund-created" | "refund-updated";

package/dist/pubsub/topics/refunds/types.js

@@ -0,0 +1,7 @@
+/**
+ * Refunds Topic Types
+ * Aggregated types for all refund-related events
+ */
+// Re-export all event types
+export * from "./refund-created/types";
+export * from "./refund-updated/types";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@final-commerce/command-frame",
-    "version": "0.1.5",
+    "version": "0.1.7",
     "description": "Commands Frame library",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",