@final-commerce/command-frame 0.1.6 → 0.1.8

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
@@ -37,12 +38,11 @@ The library provides a `command` namespace object containing all available actio
 - **[getFinalContext](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/get-final-context/README.md)** - Get final context information (project name)
 
 #### Product Actions
-- **[setProductActive](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/set-product-active/README.md)** - Set a product variant as the active product
-- **[addProductDiscount](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-discount/README.md)** - Add a discount to the currently active product
-- **[addProductToCart](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-to-cart/README.md)** - Add the currently active product to the cart
-- **[addProductNote](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-note/README.md)** - Add a note to the currently active product
-- **[addProductFee](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-fee/README.md)** - Add a fee to the currently active product
-- **[adjustInventory](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/adjust-inventory/README.md)** - Adjust inventory/stock level for the currently active product
+- **[addProductToCart](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-to-cart/README.md)** - Add a product to the cart with optional discounts, fees, and notes
+- **[addProductDiscount](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-discount/README.md)** - Add a discount to a specific product in the cart (using `cartItemId`)
+- **[addProductNote](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-note/README.md)** - Add a note to a specific product in the cart (using `cartItemId`)
+- **[addProductFee](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-fee/README.md)** - Add a fee to a specific product in the cart (using `cartItemId`)
+- **[adjustInventory](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/adjust-inventory/README.md)** - Adjust inventory/stock level for a specific product variant
 
 #### Order Actions
 - **[addCustomSale](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-custom-sale/README.md)** - Add a custom sale item to the cart
@@ -94,7 +94,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
 
@@ -115,19 +115,24 @@ const variants = await command.getProductVariants({
     productId: '691df9c6c478bada1fb23d31'
 });
 
-// Set a variant as active, add discount, then add to cart
-await command.setProductActive({
-    variantId: '691df9c6c478bada1fb23d55'
+// Add product to cart with optional discounts and fees
+const addedProduct = await command.addProductToCart({
+    variantId: '691df9c6c478bada1fb23d55',
+    quantity: 1,
+    discounts: [{
+        amount: 10,
+        isPercent: false,
+        label: 'Discount'
+    }],
+    notes: 'No onions'
 });
 
+// Add a discount to the specific item just added (if you didn't add it during creation)
 await command.addProductDiscount({
-    amount: 10,
-    isPercent: false,
-    label: 'Discount'
-});
-
-await command.addProductToCart({
-    quantity: 1
+    cartItemId: addedProduct.internalId,
+    amount: 5,
+    isPercent: true,
+    label: 'Extra 5% Off'
 });
 
 // Add cart discount
@@ -144,347 +149,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.
-
-## 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.
-
-**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)`
+For complete usage examples and detailed parameter descriptions, see the documentation for each command in the [Commands Documentation](#commands-documentation) section.
 
-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
+## Commands Documentation
 
-**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)
 
@@ -522,17 +192,13 @@ Retrieves the current cart object with all its contents including products, cust
 
 Adds a custom sale item to the cart in the parent window. Useful for adding non-product items like service fees, discounts, or custom charges.
 
-### [setProductActive](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/set-product-active/README.md)
+### [addProductToCart](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-to-cart/README.md)
 
-Sets a product variant as the active product in the parent application. Required before adding discounts or adding products to cart.
+Adds a product to the cart. Supports specifying quantity, applying discounts, fees, and notes in a single atomic operation.
 
 ### [addProductDiscount](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-discount/README.md)
 
-Adds a discount to the currently active product. Supports both fixed amount and percentage discounts. The product must be set as active first.
-
-### [addProductToCart](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-to-cart/README.md)
-
-Adds the currently active product to the cart. Supports specifying quantity. The product must be set as active first.
+Adds a discount to a specific product in the cart (identified by `cartItemId`). Supports both fixed amount and percentage discounts.
 
 ### [addCartDiscount](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-cart-discount/README.md)
 
@@ -546,15 +212,15 @@ Retrieves the current environment/context information from the parent applicatio
 
 ### [addProductNote](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-note/README.md)
 
-Adds a note to the currently active product in the cart. Requires a product to be set as active first.
+Adds a note to a specific product in the cart (identified by `cartItemId`).
 
 ### [addProductFee](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/add-product-fee/README.md)
 
-Adds a fee to the currently active product. Supports both fixed amount and percentage-based fees. Requires a product to be set as active first.
+Adds a fee to a specific product in the cart (identified by `cartItemId`). Supports both fixed amount and percentage-based fees.
 
 ### [adjustInventory](https://github.com/Final-Commerce/command-frame/blob/main/src/actions/adjust-inventory/README.md)
 
-Adjusts the inventory/stock level for the currently active product. Supports adding, subtracting, or setting stock to a specific value.
+Adjusts the inventory/stock level for a specific product variant. Supports adding, subtracting, or setting stock to a specific value.
 
 ### Order Actions
 
@@ -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 {
@@ -747,7 +461,6 @@ import type {
     GetFinalContext, GetFinalContextResponse,
     GetCurrentCart, GetCurrentCartResponse,
     // Product Actions
-    SetProductActiveParams, SetProductActiveResponse, SetProductActive,
     AddProductDiscountParams, AddProductDiscountResponse, AddProductDiscount,
     AddProductToCartParams, AddProductToCartResponse, AddProductToCart,
     AddProductNoteParams, AddProductNoteResponse, AddProductNote,
@@ -786,12 +499,12 @@ import type {
     SwitchUserParams, SwitchUserResponse, SwitchUser,
     // Refund Actions
     GetLineItemsByOrderParams, GetLineItemsByOrderResponse, GetLineItemsByOrder,
-    SelectAllRefundItemsResponse, SelectAllRefundItems,
+    SelectAllRefundItemsParams, SelectAllRefundItemsResponse, SelectAllRefundItems,
     ResetRefundDetailsResponse, ResetRefundDetails,
     SetRefundStockActionParams, SetRefundStockActionResponse, SetRefundStockAction,
     CalculateRefundTotalResponse, CalculateRefundTotal,
     ProcessPartialRefundParams, ProcessPartialRefundResponse, ProcessPartialRefund,
-    GetRemainingRefundableQuantitiesResponse, GetRemainingRefundableQuantities,
+    GetRemainingRefundableQuantitiesParams, GetRemainingRefundableQuantitiesResponse, GetRemainingRefundableQuantities,
     // Integration Actions
     TriggerWebhookParams, TriggerWebhookResponse, TriggerWebhook,
     TriggerZapierWebhookParams, TriggerZapierWebhookResponse, TriggerZapierWebhook,

package/dist/actions/add-custom-sale/mock.js

@@ -2,8 +2,11 @@ export const mockAddCustomSale = async (params) => {
     console.log("[Mock] addCustomSale called", params);
     if (!params)
         throw new Error("Params required");
+    // Simple mock ID generation
+    const mockId = 'sale_' + Math.random().toString(36).substr(2, 9);
     return {
         success: true,
+        customSaleId: mockId,
         label: params.label,
         price: Number(params.price),
         applyTaxes: params.applyTaxes ?? false,

package/dist/actions/add-custom-sale/types.d.ts

@@ -5,6 +5,7 @@ export interface AddCustomSaleParams {
 }
 export interface AddCustomSaleResponse {
     success: boolean;
+    customSaleId: string;
     label: string;
     price: number;
     applyTaxes: boolean;

package/dist/actions/add-product-discount/mock.js

@@ -5,6 +5,7 @@ export const mockAddProductDiscount = async (params) => {
         amount: params?.amount || 0,
         isPercent: params?.isPercent || false,
         label: params?.label || "",
+        cartItemId: params?.cartItemId,
         timestamp: new Date().toISOString()
     };
 };

package/dist/actions/add-product-discount/types.d.ts

@@ -2,12 +2,14 @@ export interface AddProductDiscountParams {
     amount: number;
     isPercent?: boolean;
     label?: string;
+    cartItemId?: string;
 }
 export interface AddProductDiscountResponse {
     success: boolean;
     amount: number;
     isPercent: boolean;
     label: string;
+    cartItemId?: string;
     timestamp: string;
 }
 export type AddProductDiscount = (params?: AddProductDiscountParams) => Promise<AddProductDiscountResponse>;

package/dist/actions/add-product-fee/mock.js

@@ -6,6 +6,7 @@ export const mockAddProductFee = async (params) => {
         isPercent: params?.isPercent || false,
         label: params?.label || "",
         applyTaxes: params?.applyTaxes || false,
+        cartItemId: params?.cartItemId,
         timestamp: new Date().toISOString()
     };
 };

package/dist/actions/add-product-fee/types.d.ts

@@ -4,6 +4,7 @@ export interface AddProductFeeParams {
     label?: string;
     applyTaxes?: boolean;
     taxTableId?: string;
+    cartItemId?: string;
 }
 export interface AddProductFeeResponse {
     success: boolean;
@@ -11,6 +12,7 @@ export interface AddProductFeeResponse {
     isPercent: boolean;
     label: string;
     applyTaxes: boolean;
+    cartItemId?: string;
     timestamp: string;
 }
 export type AddProductFee = (params?: AddProductFeeParams) => Promise<AddProductFeeResponse>;

package/dist/actions/add-product-note/mock.js

@@ -3,6 +3,7 @@ export const mockAddProductNote = async (params) => {
     return {
         success: true,
         note: params?.note || "",
+        cartItemId: params?.cartItemId,
         timestamp: new Date().toISOString()
     };
 };

package/dist/actions/add-product-note/types.d.ts

@@ -1,9 +1,11 @@
 export interface AddProductNoteParams {
     note: string;
+    cartItemId?: string;
 }
 export interface AddProductNoteResponse {
     success: boolean;
     note: string;
+    cartItemId?: string;
     timestamp: string;
 }
 export type AddProductNote = (params?: AddProductNoteParams) => Promise<AddProductNoteResponse>;

package/dist/actions/add-product-to-cart/mock.js

@@ -1,32 +1,33 @@
 import { MOCK_CART, MOCK_PRODUCTS } from "../../demo/database";
 export const mockAddProductToCart = async (params) => {
     console.log("[Mock] addProductToCart called", params);
-    const productId = params?.productId;
     const variantId = params?.variantId;
     const quantity = params?.quantity || 1;
     let product = MOCK_PRODUCTS[0]; // Default fallback
-    if (productId) {
-        const found = MOCK_PRODUCTS.find(p => p._id === productId);
-        if (found) {
-            product = found;
-        }
-        else {
-            console.warn(`[Mock] Product with ID ${productId} not found, using default.`);
-        }
-    }
-    // Determine variant
     let variant = product.variants[0];
+    // Determine variant and product from variantId
     if (variantId) {
-        const foundVariant = product.variants.find(v => v._id === variantId);
-        if (foundVariant) {
-            variant = foundVariant;
+        // Search through all products to find the one containing this variant
+        for (const p of MOCK_PRODUCTS) {
+            const foundVariant = p.variants.find(v => v._id === variantId);
+            if (foundVariant) {
+                product = p;
+                variant = foundVariant;
+                break;
+            }
         }
     }
     // Add to MOCK_CART
+    const internalId = product._id + "_" + Date.now();
+    // Process optional fields for mock
+    let note = undefined;
+    if (params?.notes) {
+        note = Array.isArray(params.notes) ? params.notes.join(", ") : params.notes;
+    }
     const activeProduct = {
         ...product,
         id: product._id,
-        internalId: product._id + "_" + Date.now(), // unique ID for cart item
+        internalId: internalId, // unique ID for cart item
         variantId: variant._id,
         quantity: quantity,
         price: Number(variant.price),
@@ -35,7 +36,9 @@ export const mockAddProductToCart = async (params) => {
         images: product.images || [],
         localQuantity: quantity,
         sku: variant.sku,
-        attributes: variant.attributes.map(a => `${a.name}: ${a.value}`).join(", ")
+        attributes: variant.attributes.map(a => `${a.name}: ${a.value}`).join(", "),
+        note: note
+        // discount/fee could be added here to mock object if CFActiveProduct supports it
     };
     MOCK_CART.products.push(activeProduct);
     // Recalculate totals
@@ -49,6 +52,7 @@ export const mockAddProductToCart = async (params) => {
         success: true,
         productId: activeProduct.id,
         variantId: activeProduct.variantId,
+        internalId: activeProduct.internalId,
         name: activeProduct.name,
         quantity: quantity,
         timestamp: new Date().toISOString()

package/dist/actions/add-product-to-cart/types.d.ts

@@ -1,12 +1,17 @@
+import type { AddProductDiscountParams } from "../add-product-discount/types";
+import type { AddProductFeeParams } from "../add-product-fee/types";
 export interface AddProductToCartParams {
-    productId?: string;
     variantId?: string;
     quantity?: number;
+    discounts?: AddProductDiscountParams[];
+    fees?: AddProductFeeParams[];
+    notes?: string | string[];
 }
 export interface AddProductToCartResponse {
     success: boolean;
     productId: string;
     variantId: string;
+    internalId: string;
     name: string;
     quantity: number;
     timestamp: string;

package/dist/actions/adjust-inventory/types.d.ts

@@ -1,6 +1,7 @@
 export interface AdjustInventoryParams {
     amount: string;
     stockType: 'add' | 'subtract' | 'set';
+    variantId?: string;
 }
 export interface AdjustInventoryResponse {
     success: boolean;

package/dist/actions/calculate-refund-total/mock.js

@@ -1,5 +1,5 @@
-export const mockCalculateRefundTotal = async () => {
-    console.log("[Mock] calculateRefundTotal called");
+export const mockCalculateRefundTotal = async (_params) => {
+    console.log("[Mock] calculateRefundTotal called", _params);
     return {
         success: true,
         summary: {

package/dist/actions/calculate-refund-total/types.d.ts

@@ -1,4 +1,7 @@
 import { CFRefundedLineItem, CFRefundedCustomSale } from "../../CommonTypes";
+export interface CalculateRefundTotalParams {
+    orderId?: string;
+}
 export interface CalculateRefundTotalResponse {
     success: boolean;
     summary: {
@@ -10,4 +13,4 @@ export interface CalculateRefundTotalResponse {
     refundedCustomSales: CFRefundedCustomSale[];
     timestamp: string;
 }
-export type CalculateRefundTotal = () => Promise<CalculateRefundTotalResponse>;
+export type CalculateRefundTotal = (params?: CalculateRefundTotalParams) => Promise<CalculateRefundTotalResponse>;

package/dist/actions/get-final-context/mock.d.ts

@@ -0,0 +1,2 @@
+import { GetFinalContext } from "./types";
+export declare const mockGetFinalContext: GetFinalContext;

package/dist/actions/get-final-context/mock.js

@@ -0,0 +1,6 @@
+export const mockGetFinalContext = async () => {
+    console.log("[Mock] getFinalContext called");
+    return {
+        projectName: "Mock Project"
+    };
+};

package/dist/actions/get-remaining-refundable-quantities/mock.js

@@ -1,5 +1,5 @@
-export const mockGetRemainingRefundableQuantities = async () => {
-    console.log("[Mock] getRemainingRefundableQuantities called");
+export const mockGetRemainingRefundableQuantities = async (_params) => {
+    console.log("[Mock] getRemainingRefundableQuantities called", _params);
     return {
         success: true,
         lineItems: {},

package/dist/actions/get-remaining-refundable-quantities/types.d.ts

@@ -1,7 +1,10 @@
+export interface GetRemainingRefundableQuantitiesParams {
+    orderId?: string;
+}
 export interface GetRemainingRefundableQuantitiesResponse {
     success: boolean;
     lineItems: Record<string, number>;
     customSales: Record<string, number>;
     timestamp: string;
 }
-export type GetRemainingRefundableQuantities = () => Promise<GetRemainingRefundableQuantitiesResponse>;
+export type GetRemainingRefundableQuantities = (params?: GetRemainingRefundableQuantitiesParams) => Promise<GetRemainingRefundableQuantitiesResponse>;

package/dist/actions/process-partial-refund/mock.js

@@ -2,7 +2,7 @@ export const mockProcessPartialRefund = async (params) => {
     console.log("[Mock] processPartialRefund called", params);
     return {
         success: true,
-        refundId: "mock_refund_id",
+        refundId: 'mock_refund_' + Date.now(),
         timestamp: new Date().toISOString()
     };
 };

package/dist/actions/process-partial-refund/types.d.ts

@@ -1,5 +1,11 @@
 export interface ProcessPartialRefundParams {
     reason?: string;
+    orderId?: string;
+    items?: {
+        itemKey: string;
+        quantity: number;
+        type?: 'product' | 'customSale' | 'fee' | 'tip';
+    }[];
 }
 export interface ProcessPartialRefundResponse {
     success: boolean;

package/dist/actions/select-all-refund-items/mock.js

@@ -1,5 +1,5 @@
-export const mockSelectAllRefundItems = async () => {
-    console.log("[Mock] selectAllRefundItems called");
+export const mockSelectAllRefundItems = async (_params) => {
+    console.log("[Mock] selectAllRefundItems called", _params);
     return {
         success: true,
         selectedItemsCount: 5,

package/dist/actions/select-all-refund-items/types.d.ts

@@ -1,6 +1,9 @@
+export interface SelectAllRefundItemsParams {
+    orderId?: string;
+}
 export interface SelectAllRefundItemsResponse {
     success: boolean;
     selectedItemsCount: number;
     timestamp: string;
 }
-export type SelectAllRefundItems = () => Promise<SelectAllRefundItemsResponse>;
+export type SelectAllRefundItems = (params?: SelectAllRefundItemsParams) => Promise<SelectAllRefundItemsResponse>;

package/dist/actions/set-refund-stock-action/mock.js

@@ -2,6 +2,7 @@ export const mockSetRefundStockAction = async (params) => {
     console.log("[Mock] setRefundStockAction called", params);
     return {
         success: true,
+        orderId: params?.orderId,
         itemKey: params?.itemKey || "",
         action: params?.action || "RESTOCK",
         timestamp: new Date().toISOString()

package/dist/actions/set-refund-stock-action/types.d.ts

@@ -1,9 +1,11 @@
 export interface SetRefundStockActionParams {
+    orderId?: string;
     itemKey: string;
     action: 'RESTOCK' | 'REFUND_DAMAGE';
 }
 export interface SetRefundStockActionResponse {
     success: boolean;
+    orderId?: string;
     itemKey: string;
     action: string;
     timestamp: string;

package/dist/actions/trigger-webhook/types.d.ts

@@ -1,12 +1,13 @@
+export type TriggerWebhookPresetType = 'product' | 'cart' | 'order' | 'customer';
 export interface TriggerWebhookParams {
     webhookUrl: string;
     publicKey?: string;
     presetData?: boolean;
-    presetType?: string;
+    presetType?: TriggerWebhookPresetType;
     isCustomHook?: boolean;
     customHookData?: string;
     payloadType?: string;
-    dynamicDataFields?: any[];
+    dynamicDataFields?: unknown[];
 }
 export interface TriggerWebhookResponse {
     success: boolean;

package/dist/actions/trigger-webhook/types.js

@@ -1 +1,2 @@
+// Trigger Webhook Types
 export {};

package/dist/demo/registry.js

@@ -38,7 +38,6 @@ import { mockRemoveCustomerFromCart } from "../actions/remove-customer-from-cart
 import { mockResetRefundDetails } from "../actions/reset-refund-details/mock";
 import { mockResumeParkedOrder } from "../actions/resume-parked-order/mock";
 import { mockSelectAllRefundItems } from "../actions/select-all-refund-items/mock";
-import { mockSetProductActive } from "../actions/set-product-active/mock";
 import { mockSetRefundStockAction } from "../actions/set-refund-stock-action/mock";
 import { mockShowConfirmation } from "../actions/show-confirmation/mock";
 import { mockShowNotification } from "../actions/show-notification/mock";
@@ -50,6 +49,7 @@ import { mockTriggerWebhook } from "../actions/trigger-webhook/mock";
 import { mockTriggerZapierWebhook } from "../actions/trigger-zapier-webhook/mock";
 import { mockUpdateCustomerFacingDisplay } from "../actions/update-customer-facing-display/mock";
 import { mockVendaraPayment } from "../actions/vendara-payment/mock";
+import { mockGetFinalContext } from "../actions/get-final-context/mock";
 export const MOCK_REGISTRY = {
     "addCartDiscount": mockAddCartDiscount,
     "addCartFee": mockAddCartFee,
@@ -91,7 +91,6 @@ export const MOCK_REGISTRY = {
     "resetRefundDetails": mockResetRefundDetails,
     "resumeParkedOrder": mockResumeParkedOrder,
     "selectAllRefundItems": mockSelectAllRefundItems,
-    "setProductActive": mockSetProductActive,
     "setRefundStockAction": mockSetRefundStockAction,
     "showConfirmation": mockShowConfirmation,
     "showNotification": mockShowNotification,
@@ -103,4 +102,5 @@ export const MOCK_REGISTRY = {
     "triggerZapierWebhook": mockTriggerZapierWebhook,
     "updateCustomerFacingDisplay": mockUpdateCustomerFacingDisplay,
     "vendaraPayment": mockVendaraPayment,
+    "getFinalContext": mockGetFinalContext,
 };

package/dist/index.d.ts

@@ -9,11 +9,11 @@ export declare const command: {
     readonly getProductVariants: import("./actions/get-product-variants/types").GetProductVariants;
     readonly getOrders: import("./actions/get-orders/types").GetOrders;
     readonly getRefunds: import("./actions/get-refunds/types").GetRefunds;
-    readonly setProductActive: import("./actions/set-product-active/types").SetProductActive;
     readonly addProductDiscount: import("./actions/add-product-discount/types").AddProductDiscount;
     readonly addProductToCart: import("./actions/add-product-to-cart/types").AddProductToCart;
     readonly addCartDiscount: import("./actions/add-cart-discount/types").AddCartDiscount;
     readonly getContext: import("./actions/get-context/types").GetContext;
+    readonly getFinalContext: import("./actions/get-final-context/types").GetFinalContext;
     readonly addProductNote: import("./actions/add-product-note/types").AddProductNote;
     readonly addProductFee: import("./actions/add-product-fee/types").AddProductFee;
     readonly adjustInventory: import("./actions/adjust-inventory/types").AdjustInventory;
@@ -64,13 +64,12 @@ export type { GetOrders, GetOrdersParams, GetOrdersResponse } from "./actions/ge
 export type { GetRefunds, GetRefundsParams, GetRefundsResponse } from "./actions/get-refunds/types";
 export type { GetLineItemsByOrder, GetLineItemsByOrderParams, GetLineItemsByOrderResponse } from "./actions/get-line-items-by-order/types";
 export type { SetRefundStockAction, SetRefundStockActionParams, SetRefundStockActionResponse } from "./actions/set-refund-stock-action/types";
-export type { SelectAllRefundItems, SelectAllRefundItemsResponse } from "./actions/select-all-refund-items/types";
+export type { SelectAllRefundItems, SelectAllRefundItemsParams, SelectAllRefundItemsResponse } from "./actions/select-all-refund-items/types";
 export type { ResetRefundDetails, ResetRefundDetailsResponse } from "./actions/reset-refund-details/types";
-export type { CalculateRefundTotal, CalculateRefundTotalResponse } from "./actions/calculate-refund-total/types";
-export type { GetRemainingRefundableQuantities, GetRemainingRefundableQuantitiesResponse } from "./actions/get-remaining-refundable-quantities/types";
+export type { CalculateRefundTotal, CalculateRefundTotalParams, CalculateRefundTotalResponse } from "./actions/calculate-refund-total/types";
+export type { GetRemainingRefundableQuantities, GetRemainingRefundableQuantitiesParams, GetRemainingRefundableQuantitiesResponse } from "./actions/get-remaining-refundable-quantities/types";
 export type { ProcessPartialRefund, ProcessPartialRefundParams, ProcessPartialRefundResponse } from "./actions/process-partial-refund/types";
 export type { GetCurrentCart, GetCurrentCartResponse } from "./actions/get-current-cart/types";
-export type { SetProductActive, SetProductActiveParams, SetProductActiveResponse } from "./actions/set-product-active/types";
 export type { AddProductDiscount, AddProductDiscountParams, AddProductDiscountResponse } from "./actions/add-product-discount/types";
 export type { AddProductToCart, AddProductToCartParams, AddProductToCartResponse } from "./actions/add-product-to-cart/types";
 export type { AddCartDiscount, AddCartDiscountParams, AddCartDiscountResponse } from "./actions/add-cart-discount/types";
@@ -103,7 +102,7 @@ export type { AuthenticateUser, AuthenticateUserParams, AuthenticateUserResponse
 export type { UpdateCustomerFacingDisplay, UpdateCustomerFacingDisplayParams, UpdateCustomerFacingDisplayResponse } from "./actions/update-customer-facing-display/types";
 export type { PartialPayment, PartialPaymentParams, PartialPaymentResponse } from "./actions/partial-payment/types";
 export type { SwitchUser, SwitchUserParams, SwitchUserResponse } from "./actions/switch-user/types";
-export type { TriggerWebhook, TriggerWebhookParams, TriggerWebhookResponse } from "./actions/trigger-webhook/types";
+export type { TriggerWebhook, TriggerWebhookPresetType, TriggerWebhookParams, TriggerWebhookResponse } from "./actions/trigger-webhook/types";
 export type { TriggerZapierWebhook, TriggerZapierWebhookParams, TriggerZapierWebhookResponse } from "./actions/trigger-zapier-webhook/types";
 export * from "./CommonTypes";
 export { commandFrameClient, CommandFrameClient } from "./client";

package/dist/index.js

@@ -10,8 +10,8 @@ import { getProductVariants } from "./actions/get-product-variants/action";
 import { getOrders } from "./actions/get-orders/action";
 import { getRefunds } from "./actions/get-refunds/action";
 import { addCartDiscount } from "./actions/add-cart-discount/action";
-import { setProductActive } from "./actions/set-product-active/action";
 import { getContext } from "./actions/get-context/action";
+import { getFinalContext } from "./actions/get-final-context/action";
 import { addProductDiscount } from "./actions/add-product-discount/action";
 import { addProductToCart } from "./actions/add-product-to-cart/action";
 // Product Actions
@@ -68,11 +68,11 @@ export const command = {
     getProductVariants,
     getOrders,
     getRefunds,
-    setProductActive,
     addProductDiscount,
     addProductToCart,
     addCartDiscount,
     getContext,
+    getFinalContext,
     // Product Actions
     addProductNote,
     addProductFee,

package/package.json

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

package/dist/actions/set-product-active/action.d.ts

@@ -1,6 +0,0 @@
-/**
- * Set product active action
- * Calls the setProductActive action on the parent window
- */
-import type { SetProductActive } from "./types";
-export declare const setProductActive: SetProductActive;

package/dist/actions/set-product-active/action.js

@@ -1,8 +0,0 @@
-/**
- * Set product active action
- * Calls the setProductActive action on the parent window
- */
-import { commandFrameClient } from "../../client";
-export const setProductActive = async (params) => {
-    return await commandFrameClient.call("setProductActive", params);
-};

package/dist/actions/set-product-active/mock.d.ts

@@ -1,2 +0,0 @@
-import { SetProductActive } from "./types";
-export declare const mockSetProductActive: SetProductActive;

package/dist/actions/set-product-active/mock.js

@@ -1,8 +0,0 @@
-export const mockSetProductActive = async (params) => {
-    console.log("[Mock] setProductActive called", params);
-    return {
-        success: true,
-        variantId: params?.variantId || "",
-        timestamp: new Date().toISOString()
-    };
-};

package/dist/actions/set-product-active/types.d.ts

@@ -1,9 +0,0 @@
-export interface SetProductActiveParams {
-    variantId: string;
-}
-export interface SetProductActiveResponse {
-    success: boolean;
-    variantId: string;
-    timestamp: string;
-}
-export type SetProductActive = (params?: SetProductActiveParams) => Promise<SetProductActiveResponse>;

package/dist/actions/set-product-active/types.js

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