@final-commerce/command-frame 0.2.0-beta.1 → 0.2.0-beta.6

package/dist/CommonTypes.d.ts

@@ -60,7 +60,7 @@ export declare enum CFUserTypes {
     CASHIER = "cashier",
     RESELLER = "reseller"
 }
-export type CFActiveEntity = object;
+export type CFActiveEntity = Record<string, unknown>;
 export interface CFDiscount {
     value: number;
     label?: string;
@@ -96,8 +96,26 @@ export interface CFTax {
     amount: number;
     taxTableName: string;
     taxTableId: string;
+    /** Whether this tax compounds on top of others. */
+    compounding?: boolean;
+    /** Application order; lower numbers apply first. */
+    priority?: number;
+}
+/** Per-rate tax entry on a cart fee (gst, hst, etc.). Same shape as `CFTax`; declared
+ *  separately to match the host's distinct `CartFeeTaxEntry` type. */
+export interface CFCartFeeTaxEntry {
+    id: string;
+    name: string;
+    percentage: number;
+    amount: number;
+    taxTableId: string;
+    taxTableName: string;
+    compounding?: boolean;
+    priority?: number;
 }
 export interface CFInventory {
+    /** Warehouse identifier the stock is held at. */
+    warehouse: string;
     outletId: string;
     stock?: number | null;
     _id?: string;
@@ -115,6 +133,29 @@ export interface CFOrderNote {
     addedByUser?: string;
     dateCreated?: string;
 }
+export interface CFAttributeOption {
+    name: string;
+    order?: number;
+}
+export interface CFAttribute {
+    _id: string;
+    companyId?: string;
+    optionName: string;
+    sortingOrder: number;
+    options: CFAttributeOption[];
+}
+export interface CFTransaction {
+    _id: string;
+    companyId?: string;
+    orderId?: string;
+    amount: number;
+    currency?: string;
+    status?: string;
+    paymentMethod?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
 export interface CFCategory {
     _id: string;
     companyId: string;
@@ -131,7 +172,8 @@ export interface CFProductVariant {
     barcode?: string;
     costPrice?: number;
     manageStock: boolean;
-    externalId?: string;
+    /** External variant identifier — required by host. */
+    externalId: string;
     inventory?: CFInventory[];
     allowBackorder?: boolean;
     images?: string[];
@@ -144,11 +186,15 @@ export interface CFProductVariant {
         value: string;
     }[];
     _id: string;
+    isDeleted?: boolean;
+    currency?: CurrencyCode;
+    minorUnits?: number;
 }
 export interface CFProduct {
     _id: string;
     companyId?: string;
-    externalId?: string;
+    /** External product identifier — required by host. */
+    externalId: string;
     taxTable: string;
     name: string;
     description?: string;
@@ -168,8 +214,12 @@ export interface CFProduct {
     minorUnits: number;
     minPrice?: number;
     maxPrice?: number;
+    /** Catalog-level price (rare; usually only on simple products). */
+    price?: number;
     status?: string;
     isDeleted?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
 }
 export interface CFActiveProduct extends CFActiveEntity {
     id: string;
@@ -195,6 +245,13 @@ export interface CFActiveProduct extends CFActiveEntity {
     isUnlimited?: boolean;
     attributes?: string;
     localQuantity?: number;
+    /** Mongo-style id when the active product retains the catalog `_id`. */
+    _id?: string;
+    productType?: CFProductType;
+    /** Currency code for the line price. */
+    currency?: CurrencyCode;
+    /** Number of minor units (decimal places) for the line currency. */
+    minorUnits?: number;
 }
 export interface CFCustomer {
     _id: string;
@@ -245,6 +302,8 @@ export interface CFCartFeeItem {
     taxTableId?: string;
     tax?: number;
     taxName: string;
+    /** Per-rate breakdown so summary/refund views can show correct amounts per rate. */
+    taxes?: CFCartFeeTaxEntry[];
 }
 export interface CFTipPayment {
     amount: number;
@@ -268,6 +327,8 @@ export interface CFPaymentMethod {
     tip?: CFTipPayment | null;
     cashRounding?: number;
     emv?: string | null;
+    /** Processor fee charged on this payment. */
+    processorFee?: number | null;
 }
 export interface CFPosDataItem {
     outlet: string;
@@ -408,6 +469,10 @@ export interface CFOrder {
     refund?: CFRefundItem[];
     balance: number;
     signature?: string | null;
+    /** ISO timestamp at which a parked order's stock reservation expires. */
+    parkExpiryDate?: string;
+    /** Park stock-reduction policy (host-defined string flag). */
+    parkReduceStock?: string;
 }
 export interface CFActiveUserRole {
     id?: string;
@@ -469,6 +534,12 @@ export interface CFActiveStation {
     createdAt?: string;
     updatedAt?: string;
     stripeTerminalId?: string;
+    /** Stripe serial-reader identifier when paired. */
+    serialReaderId?: string;
+    /** User id of whoever enrolled the station. */
+    enrolledBy?: string;
+    /** Whether the station is virtual (no physical terminal). */
+    isVirtual?: boolean;
 }
 /** Cash register session (station session), aligned with Render `Session`. */
 export interface CFSession {
@@ -534,6 +605,8 @@ export interface CFNonRevenueItem {
 }
 export interface CFActiveCart extends CFActiveEntity {
     tax?: number;
+    /** Per-rate tax breakdown for the cart. Same shape as line item taxes. */
+    taxes?: CFTax[];
     total: number;
     subtotal: number;
     discount?: CFDiscount;
@@ -549,6 +622,22 @@ export interface CFActiveCart extends CFActiveEntity {
     cartTotal?: number;
     orderTotal?: number;
     orderId?: string;
+    /** Currency code for amounts on this cart. */
+    currency?: CurrencyCode;
+    /** Number of minor units (decimal places) for the cart's currency. */
+    minorUnits?: number;
+}
+/** A parked order. Extends `CFActiveCart` with parking-specific fields. */
+export interface CFActivePark extends CFActiveCart {
+    /** Required on parked orders (overrides the optional `orderId` on the parent). */
+    orderId: string;
+    receiptId: string;
+    servedBy: string | {
+        _id?: string;
+        firstName: string;
+        lastName: string;
+    } | undefined;
+    createdAt: string | number;
 }
 export interface CFActiveCompany extends CFActiveEntity {
     id?: string;
@@ -572,6 +661,12 @@ export interface CFContextRender {
     buildSourceId: string | null;
     buildIsPremium: boolean;
     isOffline: boolean;
+    currency: string | null;
+    currencySymbol: string | null;
+    currencyPrefix: string | null;
+    currencySuffix: string | null;
+    thousandSeparator: string | null;
+    decimalSeparator: string | null;
     user: Record<string, unknown> | null;
     company: Omit<Record<string, unknown>, "settings"> | null;
     station: Record<string, unknown> | null;

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

@@ -1,23 +1,32 @@
-import { MOCK_CUSTOMERS } from "../../demo/database";
+import { MOCK_CUSTOMERS, mockPublishEvent } from "../../demo/database";
+function generateNoteId() {
+    return `mock_note_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
 export const mockAddCustomerNote = (params) => {
     console.log("[Mock] addCustomerNote called", params);
-    if (params?.customerId && params.note) {
-        const customer = MOCK_CUSTOMERS.find(c => c._id === params.customerId);
-        if (customer) {
-            if (!customer.notes) {
-                customer.notes = [];
-            }
-            customer.notes.push({
-                _id: `mock_note_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`,
-                message: params.note,
-                createdAt: new Date().toISOString()
-            });
-        }
+    if (!params?.note) {
+        throw new Error("addCustomerNote: note is required");
     }
+    const target = params.customerId ? MOCK_CUSTOMERS.find(c => c._id === params.customerId) : MOCK_CUSTOMERS[0];
+    if (!target) {
+        throw new Error("addCustomerNote: no target customer (provide customerId or seed at least one mock customer)");
+    }
+    const noteId = generateNoteId();
+    const note = {
+        _id: noteId,
+        message: params.note,
+        createdAt: new Date().toISOString()
+    };
+    target.notes = [...(target.notes || []), note];
+    mockPublishEvent("customers", "customer-note-added", {
+        customer: target,
+        note
+    });
     return Promise.resolve({
         success: true,
-        customerId: params?.customerId || "",
-        note: params?.note || "",
+        customerId: target._id,
+        noteId,
+        note: params.note,
         timestamp: new Date().toISOString()
     });
 };

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

@@ -1,11 +1,12 @@
 export interface AddCustomerNoteParams {
-    customerId: string;
     note: string;
+    customerId?: string;
 }
 export interface AddCustomerNoteResponse {
     success: boolean;
     customerId: string;
+    noteId: string;
     note: string;
     timestamp: string;
 }
-export type AddCustomerNote = (params?: AddCustomerNoteParams) => Promise<AddCustomerNoteResponse>;
+export type AddCustomerNote = (params: AddCustomerNoteParams) => Promise<AddCustomerNoteResponse>;

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

@@ -1,10 +1,13 @@
 import { CFProductType, CurrencyCode } from "../../CommonTypes";
+// eslint-disable-next-line @typescript-eslint/require-await
 export const mockAddProduct = async (params) => {
     console.log("[Mock] addProduct called", params);
     const hasVariants = params.variants && params.variants.length > 0;
+    const productId = "mock_product_" + Date.now();
     return {
         product: {
-            _id: "mock_product_" + Date.now(),
+            _id: productId,
+            externalId: `ext_${productId}`,
             currency: CurrencyCode.USD,
             minorUnits: 2,
             name: params.name,
@@ -20,16 +23,19 @@ export const mockAddProduct = async (params) => {
             maxPrice: params.price || 0,
             variants: hasVariants
                 ? params.variants.map((v, i) => ({ ...v, _id: `mock_variant_${Date.now()}_${i}` }))
-                : [{
+                : [
+                    {
                         _id: `mock_variant_${Date.now()}_0`,
+                        externalId: `ext_variant_${Date.now()}_0`,
                         sku: params.sku || "",
                         price: params.price || 0,
                         salePrice: 0,
                         isOnSale: false,
                         manageStock: params.manageStock || false,
-                        attributes: [],
-                    }],
+                        attributes: []
+                    }
+                ]
         },
-        timestamp: new Date().toISOString(),
+        timestamp: new Date().toISOString()
     };
 };

package/dist/actions/edit-product/mock.js

@@ -1,9 +1,11 @@
 import { CFProductType, CurrencyCode } from "../../CommonTypes";
+// eslint-disable-next-line @typescript-eslint/require-await
 export const mockEditProduct = async (params) => {
     console.log("[Mock] editProduct called", params);
     return {
         product: {
             _id: params.productId,
+            externalId: `ext_${params.productId}`,
             currency: CurrencyCode.USD,
             minorUnits: 2,
             name: params.changes.name || "Updated Product",
@@ -14,8 +16,8 @@ export const mockEditProduct = async (params) => {
             status: params.changes.status || "active",
             productType: CFProductType.SIMPLE,
             attributes: [],
-            variants: [],
+            variants: []
         },
-        timestamp: new Date().toISOString(),
+        timestamp: new Date().toISOString()
     };
 };

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

@@ -1,8 +1,8 @@
 import { MOCK_COMPANY, MOCK_OUTLET, MOCK_STATION, MOCK_USER } from "../../demo/database";
 // Mock for Render context (POS terminal)
-export const mockGetContext = async () => {
+export const mockGetContext = () => {
     console.log("[Mock] getContext called (Render)");
-    return {
+    return Promise.resolve({
         userId: MOCK_USER.id || null,
         companyId: MOCK_COMPANY.id || null,
         companyName: MOCK_COMPANY.name || null,
@@ -17,17 +17,23 @@ export const mockGetContext = async () => {
         buildSourceId: "mock_source_id",
         buildIsPremium: true,
         isOffline: false,
+        currency: "USD",
+        currencySymbol: "$",
+        currencyPrefix: "$",
+        currencySuffix: "",
+        thousandSeparator: ",",
+        decimalSeparator: ".",
         user: null,
         company: null,
         station: null,
         outlet: null,
         timestamp: new Date().toISOString()
-    };
+    });
 };
 // Mock for Manage context (Hub/BuilderHub)
-export const mockGetContextManage = async () => {
+export const mockGetContextManage = () => {
     console.log("[Mock] getContext called (Manage)");
-    return {
+    return Promise.resolve({
         user: {
             _id: MOCK_USER.id,
             id: MOCK_USER.id,
@@ -47,5 +53,5 @@ export const mockGetContextManage = async () => {
         extensionId: "mock_extension_id",
         outlets: [MOCK_OUTLET],
         timestamp: new Date().toISOString()
-    };
+    });
 };

package/dist/actions/print/mock.js

@@ -1,4 +1,4 @@
-export const mockPrint = async (params) => {
+export const mockPrint = (params) => {
     console.log("[Mock] print called", params);
     if (!params) {
         throw new Error("Print parameters are required");
@@ -11,16 +11,13 @@ export const mockPrint = async (params) => {
         case "html":
             console.log("[Mock] Would print HTML:", params.data.html?.substring(0, 100) + "...");
             break;
-        case "selector":
-            console.log("[Mock] Would print element with selector:", params.data.selector);
-            break;
         case "receipt":
             console.log("[Mock] Would print receipt for order:", params.data.order);
             break;
     }
-    return {
+    return Promise.resolve({
         success: true,
         timestamp: new Date().toISOString(),
         type: params.type
-    };
+    });
 };

package/dist/actions/print/types.d.ts

@@ -1,5 +1,5 @@
 import type { CFActiveOrder } from "../../CommonTypes";
-export type PrintType = "image" | "html" | "selector" | "receipt";
+export type PrintType = "image" | "html" | "receipt";
 export type PrintParams = {
     type: "image";
     data: {
@@ -12,12 +12,6 @@ export type PrintParams = {
         html: string;
     };
     options?: PrintOptions;
-} | {
-    type: "selector";
-    data: {
-        selector: string;
-    };
-    options?: PrintOptions;
 } | {
     type: "receipt";
     data: {

package/dist/actions/remove-customer-note/mock.js

@@ -1,3 +1,4 @@
+import { MOCK_CUSTOMERS, mockPublishEvent } from "../../demo/database";
 export const mockRemoveCustomerNote = (params) => {
     console.log("[Mock] removeCustomerNote called", params);
     const noteId = params?.noteId ?? "";
@@ -5,9 +6,17 @@ export const mockRemoveCustomerNote = (params) => {
     if (!noteId) {
         return Promise.resolve({ success: false, noteId, timestamp });
     }
-    return Promise.resolve({
-        success: true,
-        noteId,
-        timestamp
-    });
+    for (const customer of MOCK_CUSTOMERS) {
+        const before = customer.notes?.length ?? 0;
+        const removed = (customer.notes || []).find(n => n._id === noteId);
+        customer.notes = (customer.notes || []).filter(n => n._id !== noteId);
+        if ((customer.notes?.length ?? 0) !== before) {
+            mockPublishEvent("customers", "customer-note-deleted", {
+                customer,
+                note: removed
+            });
+            return Promise.resolve({ success: true, noteId, timestamp });
+        }
+    }
+    return Promise.resolve({ success: false, noteId, timestamp });
 };

package/dist/demo/database.js

@@ -202,7 +202,7 @@ export const MOCK_CATEGORY_SPICY = {
     parentId: null
 };
 // --- PRODUCTS ---
-const createInventory = (stock) => [{ outletId: MOCK_OUTLET_MAIN.id, stock }];
+const createInventory = (stock) => [{ warehouse: "main", outletId: MOCK_OUTLET_MAIN.id, stock }];
 // Helper for Simple Product
 const createSimpleProduct = (id, name, price, image, categories, description) => {
     const sku = `SKU-${id.toUpperCase()}`;
@@ -369,10 +369,7 @@ export const MOCK_ORDER_1 = {
     metadata: [],
     billing: MOCK_CUSTOMER_1.billing || null,
     shipping: null,
-    lineItems: [
-        createLineItem(MOCK_PRODUCT_GARLIC, 0, 1),
-        createLineItem(MOCK_PRODUCT_BASIL_ALMOND, 0, 1)
-    ],
+    lineItems: [createLineItem(MOCK_PRODUCT_GARLIC, 0, 1), createLineItem(MOCK_PRODUCT_BASIL_ALMOND, 0, 1)],
     customSales: [],
     balance: 0,
     user: MOCK_USER_LUIGI,
@@ -422,9 +419,7 @@ export const MOCK_ORDER_2 = {
     metadata: [],
     billing: null,
     shipping: null,
-    lineItems: [
-        createLineItem(MOCK_PRODUCT_BEER, 0, 2)
-    ],
+    lineItems: [createLineItem(MOCK_PRODUCT_BEER, 0, 2)],
     customSales: [],
     balance: 0,
     user: MOCK_USER_MARIO,
@@ -436,20 +431,8 @@ export const MOCK_ORDER_2 = {
 export const MOCK_USERS = [MOCK_USER_MARIO, MOCK_USER_LUIGI];
 export const MOCK_STATIONS = [MOCK_STATION_1, MOCK_STATION_2];
 export const MOCK_OUTLETS = [MOCK_OUTLET_MAIN];
-export const MOCK_CUSTOMERS = [
-    MOCK_CUSTOMER_1,
-    MOCK_CUSTOMER_2,
-    MOCK_CUSTOMER_3,
-    MOCK_CUSTOMER_4,
-    MOCK_CUSTOMER_5
-];
-export const MOCK_CATEGORIES = [
-    MOCK_CATEGORY_PASTES,
-    MOCK_CATEGORY_SPECIALTY,
-    MOCK_CATEGORY_BASIC,
-    MOCK_CATEGORY_VEGAN,
-    MOCK_CATEGORY_SPICY
-];
+export const MOCK_CUSTOMERS = [MOCK_CUSTOMER_1, MOCK_CUSTOMER_2, MOCK_CUSTOMER_3, MOCK_CUSTOMER_4, MOCK_CUSTOMER_5];
+export const MOCK_CATEGORIES = [MOCK_CATEGORY_PASTES, MOCK_CATEGORY_SPECIALTY, MOCK_CATEGORY_BASIC, MOCK_CATEGORY_VEGAN, MOCK_CATEGORY_SPICY];
 export const MOCK_PRODUCTS = [
     MOCK_PRODUCT_BASIL_ALMOND,
     MOCK_PRODUCT_BEER,
@@ -500,7 +483,8 @@ export const resetMockCart = () => {
     };
 };
 function resolveMockOrderCurrency() {
-    const raw = MOCK_COMPANY.settings?.currency;
+    const settings = MOCK_COMPANY.settings;
+    const raw = settings?.currency;
     if (typeof raw === "string" && Object.values(CurrencyCode).includes(raw)) {
         return raw;
     }
@@ -560,6 +544,7 @@ export const safeSerialize = (data) => {
     return JSON.parse(JSON.stringify(data));
 };
 const mockTopicSubscribers = {};
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const mockPublishEvent = (topic, eventType, data) => {
     const subscribers = mockTopicSubscribers[topic] || [];
     const event = {
@@ -669,6 +654,6 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
     MOCK_ORDERS.push(newOrder);
     resetMockCart();
     // Publish cart-created event after cart is reset (simulates new empty cart)
-    mockPublishEvent('cart', 'cart-created', {});
+    mockPublishEvent("cart", "cart-created", {});
     return newOrder;
 };

package/dist/index.d.ts

@@ -228,6 +228,10 @@ export { outletTopic } from "./pubsub/topics/outlet";
 export { stationTopic } from "./pubsub/topics/station";
 export { sessionTopic } from "./pubsub/topics/session";
 export { usersTopic } from "./pubsub/topics/users";
+export { variantsTopic } from "./pubsub/topics/variants";
+export { transactionsTopic } from "./pubsub/topics/transactions";
+export { categoriesTopic } from "./pubsub/topics/categories";
+export { attributesTopic } from "./pubsub/topics/attributes";
 export type { CustomerCreatedPayload, CustomerUpdatedPayload, CustomerNoteAddedPayload, CustomerNoteDeletedPayload, CustomerAssignedPayload, CustomerUnassignedPayload, CustomerActiveSetPayload, CustomerActiveGetPayload, CustomerCreatedEvent, CustomerUpdatedEvent, CustomerNoteAddedEvent, CustomerNoteDeletedEvent, CustomerAssignedEvent, CustomerUnassignedEvent, CustomerActiveSetEvent, CustomerActiveGetEvent, CustomersEventType, CustomersEventPayload } from "./pubsub/topics/customers/types";
 export type { OrderCreatedPayload, OrderUpdatedPayload, OrderActiveSetPayload, OrderActiveGetPayload, OrderCreatedEvent, OrderUpdatedEvent, OrderActiveSetEvent, OrderActiveGetEvent, OrderStateTransitionCompletedPayload, OrderStateTransitionBlockedPayload, OrderStateTransitionCompletedEvent, OrderStateTransitionBlockedEvent, OrdersEventType, OrdersEventPayload } from "./pubsub/topics/orders/types";
 export type { RefundCreatedPayload, RefundUpdatedPayload, RefundActiveSetPayload, RefundActiveGetPayload, RefundCreatedEvent, RefundUpdatedEvent, RefundActiveSetEvent, RefundActiveGetEvent, RefundsEventType, RefundsEventPayload } from "./pubsub/topics/refunds/types";
@@ -235,7 +239,11 @@ export type { ProductCreatedPayload, ProductUpdatedPayload, ProductSetActivePayl
 export type { OutletActiveSetPayload, OutletActiveGetPayload, OutletActiveSetEvent, OutletActiveGetEvent, OutletEventType, OutletEventPayload } from "./pubsub/topics/outlet/types";
 export type { StationActiveSetPayload, StationActiveGetPayload, StationActiveSetEvent, StationActiveGetEvent, StationEventType, StationEventPayload } from "./pubsub/topics/station/types";
 export type { SessionActiveSetPayload, SessionActiveGetPayload, SessionActiveSetEvent, SessionActiveGetEvent, SessionEventType, SessionEventPayload } from "./pubsub/topics/session/types";
-export type { UserActiveSetPayload, UserActiveGetPayload, UserActiveSetEvent, UserActiveGetEvent, UsersEventType, UsersEventPayload } from "./pubsub/topics/users/types";
+export type { UserActiveSetPayload, UserActiveGetPayload, UserActiveSetEvent, UserActiveGetEvent, UserCreatedPayload, UserCreatedEvent, UserUpdatedPayload, UserUpdatedEvent, UsersEventType, UsersEventPayload } from "./pubsub/topics/users/types";
+export type { VariantCreatedPayload, VariantCreatedEvent, VariantUpdatedPayload, VariantUpdatedEvent, VariantsEventType, VariantsEventPayload } from "./pubsub/topics/variants/types";
+export type { TransactionCreatedPayload, TransactionCreatedEvent, TransactionUpdatedPayload, TransactionUpdatedEvent, TransactionsEventType, TransactionsEventPayload } from "./pubsub/topics/transactions/types";
+export type { CategoryCreatedPayload, CategoryCreatedEvent, CategoryUpdatedPayload, CategoryUpdatedEvent, CategoriesEventType, CategoriesEventPayload } from "./pubsub/topics/categories/types";
+export type { AttributeCreatedPayload, AttributeCreatedEvent, AttributeUpdatedPayload, AttributeUpdatedEvent, AttributesEventType, AttributesEventPayload } from "./pubsub/topics/attributes/types";
 export type { CartCreatedPayload, CartCustomerAssignedPayload, ProductAddedPayload, ProductDeletedPayload, CartDiscountAddedPayload, CartDiscountRemovedPayload, CartFeeAddedPayload, CartFeeRemovedPayload, ProductDiscountAddedPayload, ProductDiscountRemovedPayload, ProductFeeAddedPayload, ProductFeeRemovedPayload, ProductNoteAddedPayload, ProductNoteRemovedPayload, CartCreatedEvent, CartCustomerAssignedEvent, ProductAddedEvent, ProductDeletedEvent, CartDiscountAddedEvent, CartDiscountRemovedEvent, CartFeeAddedEvent, CartFeeRemovedEvent, ProductDiscountAddedEvent, ProductDiscountRemovedEvent, ProductFeeAddedEvent, ProductFeeRemovedEvent, ProductNoteAddedEvent, ProductNoteRemovedEvent, CartEventType, CartEventPayload } from "./pubsub/topics/cart/types";
 export type { PaymentDonePayload, PaymentErrPayload, PaymentDoneEvent, PaymentErrEvent, PaymentsEventType, PaymentsEventPayload } from "./pubsub/topics/payments/types";
 export type { RowCreatedPayload, RowUpdatedPayload, RowDeletedPayload, RowCreatedEvent, RowUpdatedEvent, RowDeletedEvent, CustomTablesEventType, CustomTablesEventPayload } from "./pubsub/topics/custom-tables/types";

package/dist/index.js

@@ -276,6 +276,10 @@ export { outletTopic } from "./pubsub/topics/outlet";
 export { stationTopic } from "./pubsub/topics/station";
 export { sessionTopic } from "./pubsub/topics/session";
 export { usersTopic } from "./pubsub/topics/users";
+export { variantsTopic } from "./pubsub/topics/variants";
+export { transactionsTopic } from "./pubsub/topics/transactions";
+export { categoriesTopic } from "./pubsub/topics/categories";
+export { attributesTopic } from "./pubsub/topics/attributes";
 // Export Custom Tables Types
 export { AttributeType } from "./common-types/attribute-type";
 // State Machine Fragments

package/dist/pubsub/topics/attributes/attribute-created/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFAttribute } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface AttributeCreatedPayload {
+    attribute: CFAttribute;
+}
+export type AttributeCreatedEvent = TopicEvent<AttributeCreatedPayload>;

package/dist/pubsub/topics/attributes/attribute-created/types.js

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

package/dist/pubsub/topics/attributes/attribute-updated/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFAttribute } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface AttributeUpdatedPayload {
+    attribute: CFAttribute;
+}
+export type AttributeUpdatedEvent = TopicEvent<AttributeUpdatedPayload>;

package/dist/pubsub/topics/attributes/attribute-updated/types.js

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

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

@@ -0,0 +1,3 @@
+import type { TopicDefinition } from "../../types";
+export declare const attributesTopic: TopicDefinition;
+export * from "./types";

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

@@ -0,0 +1,18 @@
+export const attributesTopic = {
+    id: "attributes",
+    name: "Attributes",
+    description: "Topic for product attribute definition changes synced from the database",
+    eventTypes: [
+        {
+            id: "attribute-created",
+            name: "Attribute Created",
+            description: "Published when a new attribute definition is synced/created"
+        },
+        {
+            id: "attribute-updated",
+            name: "Attribute Updated",
+            description: "Published when an attribute definition is synced/updated"
+        }
+    ]
+};
+export * from "./types";

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

@@ -0,0 +1,6 @@
+export * from "./attribute-created/types";
+export * from "./attribute-updated/types";
+import type { AttributeCreatedPayload } from "./attribute-created/types";
+import type { AttributeUpdatedPayload } from "./attribute-updated/types";
+export type AttributesEventPayload = AttributeCreatedPayload | AttributeUpdatedPayload;
+export type AttributesEventType = "attribute-created" | "attribute-updated";

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

@@ -0,0 +1,2 @@
+export * from "./attribute-created/types";
+export * from "./attribute-updated/types";

package/dist/pubsub/topics/categories/category-created/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFCategory } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface CategoryCreatedPayload {
+    category: CFCategory;
+}
+export type CategoryCreatedEvent = TopicEvent<CategoryCreatedPayload>;

package/dist/pubsub/topics/categories/category-created/types.js

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

package/dist/pubsub/topics/categories/category-updated/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFCategory } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface CategoryUpdatedPayload {
+    category: CFCategory;
+}
+export type CategoryUpdatedEvent = TopicEvent<CategoryUpdatedPayload>;

package/dist/pubsub/topics/categories/category-updated/types.js

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

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

@@ -0,0 +1,3 @@
+import type { TopicDefinition } from "../../types";
+export declare const categoriesTopic: TopicDefinition;
+export * from "./types";

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

@@ -0,0 +1,18 @@
+export const categoriesTopic = {
+    id: "categories",
+    name: "Categories",
+    description: "Topic for product category changes synced from the database",
+    eventTypes: [
+        {
+            id: "category-created",
+            name: "Category Created",
+            description: "Published when a new category is synced/created"
+        },
+        {
+            id: "category-updated",
+            name: "Category Updated",
+            description: "Published when a category is synced/updated"
+        }
+    ]
+};
+export * from "./types";

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

@@ -0,0 +1,6 @@
+export * from "./category-created/types";
+export * from "./category-updated/types";
+import type { CategoryCreatedPayload } from "./category-created/types";
+import type { CategoryUpdatedPayload } from "./category-updated/types";
+export type CategoriesEventPayload = CategoryCreatedPayload | CategoryUpdatedPayload;
+export type CategoriesEventType = "category-created" | "category-updated";

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

@@ -0,0 +1,2 @@
+export * from "./category-created/types";
+export * from "./category-updated/types";

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

@@ -14,3 +14,7 @@ export * from "./outlet";
 export * from "./station";
 export * from "./session";
 export * from "./users";
+export * from "./variants";
+export * from "./transactions";
+export * from "./categories";
+export * from "./attributes";

package/dist/pubsub/topics/index.js

@@ -14,3 +14,7 @@ export * from "./outlet";
 export * from "./station";
 export * from "./session";
 export * from "./users";
+export * from "./variants";
+export * from "./transactions";
+export * from "./categories";
+export * from "./attributes";

package/dist/pubsub/topics/print/print-completed/types.d.ts

@@ -3,7 +3,7 @@ import type { TopicEvent } from "../../../types";
  * Payload for print-completed event
  */
 export interface PrintCompletedPayload {
-    type: "image" | "html" | "selector" | "receipt";
+    type: "image" | "html" | "receipt";
     orderId?: string;
     globalBlockId?: string;
 }

package/dist/pubsub/topics/print/print-error/types.d.ts

@@ -3,7 +3,7 @@ import type { TopicEvent } from "../../../types";
  * Payload for print-error event
  */
 export interface PrintErrorPayload {
-    type: "image" | "html" | "selector" | "receipt";
+    type: "image" | "html" | "receipt";
     error: string;
     orderId?: string;
     globalBlockId?: string;

package/dist/pubsub/topics/print/print-started/types.d.ts

@@ -3,7 +3,7 @@ import type { TopicEvent } from "../../../types";
  * Payload for print-started event
  */
 export interface PrintStartedPayload {
-    type: "image" | "html" | "selector" | "receipt";
+    type: "image" | "html" | "receipt";
     options?: {
         margins?: {
             top?: number;

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

@@ -0,0 +1,3 @@
+import type { TopicDefinition } from "../../types";
+export declare const transactionsTopic: TopicDefinition;
+export * from "./types";

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

@@ -0,0 +1,18 @@
+export const transactionsTopic = {
+    id: "transactions",
+    name: "Transactions",
+    description: "Topic for payment transaction events",
+    eventTypes: [
+        {
+            id: "transaction-created",
+            name: "Transaction Created",
+            description: "Published when a new transaction is created"
+        },
+        {
+            id: "transaction-updated",
+            name: "Transaction Updated",
+            description: "Published when a transaction is updated"
+        }
+    ]
+};
+export * from "./types";

package/dist/pubsub/topics/transactions/transaction-created/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFTransaction } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface TransactionCreatedPayload {
+    transaction: CFTransaction;
+}
+export type TransactionCreatedEvent = TopicEvent<TransactionCreatedPayload>;

package/dist/pubsub/topics/transactions/transaction-created/types.js

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

package/dist/pubsub/topics/transactions/transaction-updated/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFTransaction } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface TransactionUpdatedPayload {
+    transaction: CFTransaction;
+}
+export type TransactionUpdatedEvent = TopicEvent<TransactionUpdatedPayload>;

package/dist/pubsub/topics/transactions/transaction-updated/types.js

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

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

@@ -0,0 +1,6 @@
+export * from "./transaction-created/types";
+export * from "./transaction-updated/types";
+import type { TransactionCreatedPayload } from "./transaction-created/types";
+import type { TransactionUpdatedPayload } from "./transaction-updated/types";
+export type TransactionsEventPayload = TransactionCreatedPayload | TransactionUpdatedPayload;
+export type TransactionsEventType = "transaction-created" | "transaction-updated";

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

@@ -0,0 +1,2 @@
+export * from "./transaction-created/types";
+export * from "./transaction-updated/types";

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

@@ -10,6 +10,10 @@ import { OutletEventType, OutletEventPayload } from "./outlet/types";
 import { StationEventType, StationEventPayload } from "./station/types";
 import { SessionEventType, SessionEventPayload } from "./session/types";
 import { UsersEventType, UsersEventPayload } from "./users/types";
+import { VariantsEventType, VariantsEventPayload } from "./variants/types";
+import { TransactionsEventType, TransactionsEventPayload } from "./transactions/types";
+import { CategoriesEventType, CategoriesEventPayload } from "./categories/types";
+import { AttributesEventType, AttributesEventPayload } from "./attributes/types";
 export interface TopicEventPayloadMap {
     customers: Record<CustomersEventType, CustomersEventPayload>;
     orders: Record<OrdersEventType, OrdersEventPayload>;
@@ -23,4 +27,8 @@ export interface TopicEventPayloadMap {
     station: Record<StationEventType, StationEventPayload>;
     session: Record<SessionEventType, SessionEventPayload>;
     users: Record<UsersEventType, UsersEventPayload>;
+    variants: Record<VariantsEventType, VariantsEventPayload>;
+    transactions: Record<TransactionsEventType, TransactionsEventPayload>;
+    categories: Record<CategoriesEventType, CategoriesEventPayload>;
+    attributes: Record<AttributesEventType, AttributesEventPayload>;
 }

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

@@ -12,6 +12,16 @@ export const usersTopic = {
             id: "get-active-user",
             name: "Get Active User",
             description: "Published when the active user is published to listeners"
+        },
+        {
+            id: "user-created",
+            name: "User Created",
+            description: "Published when a new user record is synced/created in the database"
+        },
+        {
+            id: "user-updated",
+            name: "User Updated",
+            description: "Published when any user record is synced/updated in the database"
         }
     ]
 };

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

@@ -1,6 +1,10 @@
 export * from "./set-active-user/types";
 export * from "./get-active-user/types";
+export * from "./user-created/types";
+export * from "./user-updated/types";
 import type { UserActiveSetPayload } from "./set-active-user/types";
 import type { UserActiveGetPayload } from "./get-active-user/types";
-export type UsersEventPayload = UserActiveSetPayload | UserActiveGetPayload;
-export type UsersEventType = "set-active-user" | "get-active-user";
+import type { UserCreatedPayload } from "./user-created/types";
+import type { UserUpdatedPayload } from "./user-updated/types";
+export type UsersEventPayload = UserActiveSetPayload | UserActiveGetPayload | UserCreatedPayload | UserUpdatedPayload;
+export type UsersEventType = "set-active-user" | "get-active-user" | "user-created" | "user-updated";

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

@@ -1,2 +1,4 @@
 export * from "./set-active-user/types";
 export * from "./get-active-user/types";
+export * from "./user-created/types";
+export * from "./user-updated/types";

package/dist/pubsub/topics/users/user-created/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFActiveUser } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface UserCreatedPayload {
+    user: CFActiveUser;
+}
+export type UserCreatedEvent = TopicEvent<UserCreatedPayload>;

package/dist/pubsub/topics/users/user-created/types.js

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

package/dist/pubsub/topics/users/user-updated/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFActiveUser } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface UserUpdatedPayload {
+    user: CFActiveUser;
+}
+export type UserUpdatedEvent = TopicEvent<UserUpdatedPayload>;

package/dist/pubsub/topics/users/user-updated/types.js

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

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

@@ -0,0 +1,3 @@
+import type { TopicDefinition } from "../../types";
+export declare const variantsTopic: TopicDefinition;
+export * from "./types";

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

@@ -0,0 +1,18 @@
+export const variantsTopic = {
+    id: "variants",
+    name: "Variants",
+    description: "Topic for product variant changes synced from the database",
+    eventTypes: [
+        {
+            id: "variant-created",
+            name: "Variant Created",
+            description: "Published when a new product variant is synced/created"
+        },
+        {
+            id: "variant-updated",
+            name: "Variant Updated",
+            description: "Published when a product variant is synced/updated"
+        }
+    ]
+};
+export * from "./types";

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

@@ -0,0 +1,6 @@
+export * from "./variant-created/types";
+export * from "./variant-updated/types";
+import type { VariantCreatedPayload } from "./variant-created/types";
+import type { VariantUpdatedPayload } from "./variant-updated/types";
+export type VariantsEventPayload = VariantCreatedPayload | VariantUpdatedPayload;
+export type VariantsEventType = "variant-created" | "variant-updated";

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

@@ -0,0 +1,2 @@
+export * from "./variant-created/types";
+export * from "./variant-updated/types";

package/dist/pubsub/topics/variants/variant-created/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFProductVariant } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface VariantCreatedPayload {
+    variant: CFProductVariant;
+}
+export type VariantCreatedEvent = TopicEvent<VariantCreatedPayload>;

package/dist/pubsub/topics/variants/variant-created/types.js

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

package/dist/pubsub/topics/variants/variant-updated/types.d.ts

@@ -0,0 +1,6 @@
+import type { CFProductVariant } from "../../../../CommonTypes";
+import type { TopicEvent } from "../../../types";
+export interface VariantUpdatedPayload {
+    variant: CFProductVariant;
+}
+export type VariantUpdatedEvent = TopicEvent<VariantUpdatedPayload>;

package/dist/pubsub/topics/variants/variant-updated/types.js

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

package/package.json

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