@unifiedcommerce/core 0.0.1

package/dist/kernel/result.d.ts

@@ -0,0 +1,36 @@
+import type { CommerceError } from "./errors";
+export type Result<T, E = CommerceError> = {
+    ok: true;
+    value: T;
+    meta?: Record<string, unknown>;
+} | {
+    ok: false;
+    error: E;
+};
+/**
+ * Simplified Result types for plugin services.
+ * Plugin services return `PluginResult<T>` instead of `Result<T, CommerceError>`.
+ * This matches the `{ ok: true; value: T } | { ok: false; error: string }` pattern
+ * that every plugin has been copy-pasting.
+ */
+export type PluginResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+    code?: string;
+};
+export type PluginResultErr = {
+    ok: false;
+    error: string;
+    code?: string;
+};
+export declare function Ok<T>(value: T, meta?: Record<string, unknown>): Result<T, never>;
+export declare function Err<E>(error: E): Result<never, E>;
+/**
+ * String-based Err for plugin services.
+ * Usage: `return PluginErr("Not found", "NOT_FOUND")`
+ */
+export declare function PluginErr(error: string, code?: string): PluginResultErr;
+//# sourceMappingURL=result.d.ts.map

package/dist/kernel/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/kernel/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,aAAa,IACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACnG,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAKhF;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAEvE"}

package/dist/kernel/result.js

@@ -0,0 +1,16 @@
+export function Ok(value, meta) {
+    if (meta !== undefined) {
+        return { ok: true, value, meta };
+    }
+    return { ok: true, value };
+}
+export function Err(error) {
+    return { ok: false, error };
+}
+/**
+ * String-based Err for plugin services.
+ * Usage: `return PluginErr("Not found", "NOT_FOUND")`
+ */
+export function PluginErr(error, code) {
+    return code ? { ok: false, error, code } : { ok: false, error };
+}

package/dist/kernel/schema/extra-columns.d.ts

@@ -0,0 +1,23 @@
+import type { PgColumnBuilderBase } from "drizzle-orm/pg-core";
+/**
+ * Options for modules that support schema extension via extra columns.
+ *
+ * Usage:
+ * ```typescript
+ * const catalogModule = createCatalogModule({
+ *   extraColumns: (base) => ({
+ *     supplierCode: text("supplier_code"),
+ *     gtin: text("gtin").unique(),
+ *   }),
+ * });
+ * ```
+ */
+export interface ExtraColumnsOption<TBaseColumns extends Record<string, unknown>> {
+    extraColumns?: (baseColumns: TBaseColumns) => Record<string, PgColumnBuilderBase>;
+}
+/**
+ * Merges base columns with optional extra columns from configuration.
+ * Returns the combined column definitions for use in `pgTable()`.
+ */
+export declare function mergeExtraColumns<TBase extends Record<string, unknown>>(baseColumns: TBase, extraColumnsFn?: (base: TBase) => Record<string, PgColumnBuilderBase>): TBase & Record<string, PgColumnBuilderBase>;
+//# sourceMappingURL=extra-columns.d.ts.map

package/dist/kernel/schema/extra-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extra-columns.d.ts","sourceRoot":"","sources":["../../../src/kernel/schema/extra-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9E,YAAY,CAAC,EAAE,CACb,WAAW,EAAE,YAAY,KACtB,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAErC,WAAW,EAAE,KAAK,EAClB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACpE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAI7C"}

package/dist/kernel/schema/extra-columns.js

@@ -0,0 +1,10 @@
+/**
+ * Merges base columns with optional extra columns from configuration.
+ * Returns the combined column definitions for use in `pgTable()`.
+ */
+export function mergeExtraColumns(baseColumns, extraColumnsFn) {
+    if (!extraColumnsFn)
+        return baseColumns;
+    const extra = extraColumnsFn(baseColumns);
+    return { ...baseColumns, ...extra };
+}

package/dist/kernel/service-registry.d.ts

@@ -0,0 +1,109 @@
+/**
+ * ServiceRegistry -- typed surface of the kernel service container
+ * for plugin-to-plugin communication.
+ *
+ * Plugin services accept this as an optional constructor parameter
+ * to call core services without resorting to raw SQL.
+ *
+ * Core services are loosely typed here (method signatures use `unknown`)
+ * to avoid plugin packages depending on core's internal service types.
+ * Plugin authors cast the return values at the call site.
+ *
+ * Usage in a plugin service:
+ *
+ *   import type { ServiceRegistry } from "@unifiedcommerce/core";
+ *
+ *   class MyService {
+ *     constructor(private db: PluginDb, private services?: ServiceRegistry) {}
+ *
+ *     async doWork() {
+ *       const result = await this.services?.inventory.adjust({
+ *         entityId: "...", adjustment: -5, reason: "recipe deduction"
+ *       }, actor);
+ *     }
+ *   }
+ */
+export interface ServiceRegistry {
+    inventory: {
+        adjust(input: {
+            entityId: string;
+            variantId?: string;
+            warehouseId?: string;
+            adjustment: number;
+            reason?: string;
+        }, actor?: unknown): Promise<{
+            ok: boolean;
+            value?: unknown;
+            error?: unknown;
+        }>;
+        createWarehouse(input: {
+            name: string;
+            code: string;
+        }, actor?: unknown): Promise<{
+            ok: boolean;
+            value?: unknown;
+            error?: unknown;
+        }>;
+        reserve(input: unknown, actor?: unknown): Promise<unknown>;
+        release(input: unknown, actor?: unknown): Promise<unknown>;
+        getAvailable(input: unknown, actor?: unknown): Promise<unknown>;
+        [method: string]: unknown;
+    };
+    catalog: {
+        create(input: unknown, actor?: unknown): Promise<{
+            ok: boolean;
+            value?: unknown;
+            error?: unknown;
+        }>;
+        getById(id: string, options?: unknown): Promise<{
+            ok: boolean;
+            value?: unknown;
+            error?: unknown;
+        }>;
+        publish(id: string, actor?: unknown): Promise<unknown>;
+        list(input?: unknown): Promise<unknown>;
+        [method: string]: unknown;
+    };
+    customers: {
+        getByUserId(userId: string, actor?: unknown): Promise<{
+            ok: boolean;
+            value?: unknown;
+            error?: unknown;
+        }>;
+        getById(id: string, actor?: unknown): Promise<{
+            ok: boolean;
+            value?: unknown;
+            error?: unknown;
+        }>;
+        [method: string]: unknown;
+    };
+    orders: {
+        create(input: unknown, actor?: unknown): Promise<{
+            ok: boolean;
+            value?: unknown;
+            error?: unknown;
+        }>;
+        changeStatus(input: unknown, actor?: unknown): Promise<unknown>;
+        [method: string]: unknown;
+    };
+    cart: {
+        create(input: unknown, actor?: unknown): Promise<{
+            ok: boolean;
+            value?: unknown;
+            error?: unknown;
+        }>;
+        [method: string]: unknown;
+    };
+    organization: {
+        create(input: unknown): Promise<{
+            ok: boolean;
+            value?: unknown;
+            error?: unknown;
+        }>;
+        getById(id: string): Promise<unknown>;
+        [method: string]: unknown;
+    };
+    /** Access plugin-registered services by plugin ID or service name */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=service-registry.d.ts.map

package/dist/kernel/service-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry.d.ts","sourceRoot":"","sources":["../../src/kernel/service-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE;QACT,MAAM,CACJ,KAAK,EAAE;YACL,QAAQ,EAAE,MAAM,CAAC;YACjB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE,MAAM,CAAC;YACnB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,EACD,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAC9D,eAAe,CACb,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EACrC,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3D,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;KAC3B,CAAC;IACF,OAAO,EAAE;QACP,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACpG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACnG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;KAC3B,CAAC;IACF,SAAS,EAAE;QACT,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACzG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACjG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;KAC3B,CAAC;IACF,MAAM,EAAE;QACN,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACpG,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;KAC3B,CAAC;IACF,IAAI,EAAE;QACJ,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACpG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;KAC3B,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACnF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;KAC3B,CAAC;IACF,qEAAqE;IACrE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/kernel/service-registry.js

@@ -0,0 +1,26 @@
+/**
+ * ServiceRegistry -- typed surface of the kernel service container
+ * for plugin-to-plugin communication.
+ *
+ * Plugin services accept this as an optional constructor parameter
+ * to call core services without resorting to raw SQL.
+ *
+ * Core services are loosely typed here (method signatures use `unknown`)
+ * to avoid plugin packages depending on core's internal service types.
+ * Plugin authors cast the return values at the call site.
+ *
+ * Usage in a plugin service:
+ *
+ *   import type { ServiceRegistry } from "@unifiedcommerce/core";
+ *
+ *   class MyService {
+ *     constructor(private db: PluginDb, private services?: ServiceRegistry) {}
+ *
+ *     async doWork() {
+ *       const result = await this.services?.inventory.adjust({
+ *         entityId: "...", adjustment: -5, reason: "recipe deduction"
+ *       }, actor);
+ *     }
+ *   }
+ */
+export {};

package/dist/kernel/service-timing.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Service method observability via ES Proxy.
+ *
+ * Wraps a service object so that every async method call is timed.
+ * Slow calls (above threshold) are logged with service name, method name,
+ * and duration. Failed calls always log with the error.
+ *
+ * Usage at kernel boot:
+ *   services.inventory = withTiming(inventoryService, "inventory", logger);
+ *   services.catalog = withTiming(catalogService, "catalog", logger);
+ *
+ * Produces log entries like:
+ *   { service: "inventory", method: "adjust", durationMs: 245 } "slow service call"
+ *   { service: "catalog", method: "create", durationMs: 12, err: ... } "service call failed"
+ *
+ * Only wraps own methods (not inherited). Synchronous property access
+ * (e.g., reading a field) passes through unchanged with zero overhead.
+ */
+interface TimingLogger {
+    info(obj: Record<string, unknown>, msg: string): void;
+    error(obj: Record<string, unknown>, msg: string): void;
+}
+export declare function withTiming<T extends object>(service: T, serviceName: string, logger: TimingLogger, slowThresholdMs?: number): T;
+export {};
+//# sourceMappingURL=service-timing.d.ts.map

package/dist/kernel/service-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-timing.d.ts","sourceRoot":"","sources":["../../src/kernel/service-timing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,UAAU,YAAY;IACpB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxD;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,YAAY,EACpB,eAAe,SAAM,GACpB,CAAC,CA2DH"}

package/dist/kernel/service-timing.js

@@ -0,0 +1,62 @@
+/**
+ * Service method observability via ES Proxy.
+ *
+ * Wraps a service object so that every async method call is timed.
+ * Slow calls (above threshold) are logged with service name, method name,
+ * and duration. Failed calls always log with the error.
+ *
+ * Usage at kernel boot:
+ *   services.inventory = withTiming(inventoryService, "inventory", logger);
+ *   services.catalog = withTiming(catalogService, "catalog", logger);
+ *
+ * Produces log entries like:
+ *   { service: "inventory", method: "adjust", durationMs: 245 } "slow service call"
+ *   { service: "catalog", method: "create", durationMs: 12, err: ... } "service call failed"
+ *
+ * Only wraps own methods (not inherited). Synchronous property access
+ * (e.g., reading a field) passes through unchanged with zero overhead.
+ */
+export function withTiming(service, serviceName, logger, slowThresholdMs = 100) {
+    return new Proxy(service, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            // Only wrap functions, skip symbols and non-function props
+            if (typeof value !== "function" || typeof prop === "symbol") {
+                return value;
+            }
+            // Skip internal/private-looking methods
+            const methodName = String(prop);
+            if (methodName.startsWith("_"))
+                return value;
+            return function proxiedMethod(...args) {
+                const start = performance.now();
+                // Call the original method
+                let result;
+                try {
+                    result = value.apply(target, args);
+                }
+                catch (err) {
+                    // Synchronous throw
+                    const durationMs = Math.round(performance.now() - start);
+                    logger.error({ service: serviceName, method: methodName, durationMs, err }, `${serviceName}.${methodName} failed (${durationMs}ms)`);
+                    throw err;
+                }
+                // If result is a promise, attach timing to its resolution
+                if (result && typeof result.then === "function") {
+                    return result.then((resolved) => {
+                        const durationMs = Math.round(performance.now() - start);
+                        if (durationMs > slowThresholdMs) {
+                            logger.info({ service: serviceName, method: methodName, durationMs }, `${serviceName}.${methodName} slow (${durationMs}ms)`);
+                        }
+                        return resolved;
+                    }, (err) => {
+                        const durationMs = Math.round(performance.now() - start);
+                        logger.error({ service: serviceName, method: methodName, durationMs, err }, `${serviceName}.${methodName} failed (${durationMs}ms)`);
+                        throw err;
+                    });
+                }
+                return result;
+            };
+        },
+    });
+}

package/dist/kernel/state-machine/machine.d.ts

@@ -0,0 +1,24 @@
+export interface StateDefinition<TState extends string> {
+    states: readonly TState[];
+    initial: TState;
+    transitions: Record<TState, readonly TState[]>;
+    terminal: readonly TState[];
+}
+export type OrderState = string;
+export declare const orderStateMachine: StateDefinition<string>;
+/**
+ * Extend the order state machine with custom transitions.
+ * New states are added automatically. Existing state transition arrays
+ * are merged (union, not replaced) with the custom ones.
+ *
+ * Usage:
+ *   const extended = extendOrderStateMachine({
+ *     pending: ["payment_initiated"],
+ *     payment_initiated: ["payment_authorized", "payment_failed"],
+ *     payment_authorized: ["processing"],
+ *   });
+ */
+export declare function extendOrderStateMachine(customTransitions: Record<string, string[]>): StateDefinition<string>;
+export declare function canTransition<TState extends string>(machine: StateDefinition<TState>, from: TState, to: TState): boolean;
+export declare function assertTransition<TState extends string>(machine: StateDefinition<TState>, from: TState, to: TState): void;
+//# sourceMappingURL=machine.d.ts.map

package/dist/kernel/state-machine/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../src/kernel/state-machine/machine.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,MAAM;IACpD,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAC/C,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAmBhC,eAAO,MAAM,iBAAiB,EAAE,eAAe,CAAC,MAAM,CAKrD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC1C,eAAe,CAAC,MAAM,CAAC,CA6BzB;AAED,wBAAgB,aAAa,CAAC,MAAM,SAAS,MAAM,EACjD,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,OAAO,CAET;AAED,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,MAAM,EACpD,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,IAAI,CAQN"}

package/dist/kernel/state-machine/machine.js

@@ -0,0 +1,70 @@
+import { CommerceInvalidTransitionError } from "../errors";
+const DEFAULT_TRANSITIONS = {
+    pending: ["confirmed", "cancelled"],
+    confirmed: ["processing", "cancelled"],
+    processing: ["partially_fulfilled", "fulfilled", "cancelled"],
+    partially_fulfilled: ["fulfilled", "cancelled"],
+    fulfilled: ["refunded"],
+    cancelled: [],
+    refunded: [],
+};
+const DEFAULT_STATES = [
+    "pending", "confirmed", "processing", "partially_fulfilled",
+    "fulfilled", "cancelled", "refunded",
+];
+const DEFAULT_TERMINAL = ["cancelled", "refunded"];
+export const orderStateMachine = {
+    states: DEFAULT_STATES,
+    initial: "pending",
+    transitions: DEFAULT_TRANSITIONS,
+    terminal: DEFAULT_TERMINAL,
+};
+/**
+ * Extend the order state machine with custom transitions.
+ * New states are added automatically. Existing state transition arrays
+ * are merged (union, not replaced) with the custom ones.
+ *
+ * Usage:
+ *   const extended = extendOrderStateMachine({
+ *     pending: ["payment_initiated"],
+ *     payment_initiated: ["payment_authorized", "payment_failed"],
+ *     payment_authorized: ["processing"],
+ *   });
+ */
+export function extendOrderStateMachine(customTransitions) {
+    const merged = {};
+    // Copy defaults
+    for (const [state, targets] of Object.entries(DEFAULT_TRANSITIONS)) {
+        merged[state] = [...targets];
+    }
+    // Merge custom
+    for (const [state, targets] of Object.entries(customTransitions)) {
+        if (!merged[state])
+            merged[state] = [];
+        for (const t of targets) {
+            if (!merged[state].includes(t))
+                merged[state].push(t);
+        }
+        // Ensure target states also exist in the map
+        for (const t of targets) {
+            if (!merged[t])
+                merged[t] = [];
+        }
+    }
+    const allStates = Object.keys(merged);
+    const terminal = allStates.filter((s) => merged[s].length === 0);
+    return {
+        states: allStates,
+        initial: "pending",
+        transitions: merged,
+        terminal,
+    };
+}
+export function canTransition(machine, from, to) {
+    return machine.transitions[from].includes(to);
+}
+export function assertTransition(machine, from, to) {
+    if (!canTransition(machine, from, to)) {
+        throw new CommerceInvalidTransitionError(`Cannot transition from "${from}" to "${to}". Allowed transitions from "${from}": [${machine.transitions[from].join(", ")}]`);
+    }
+}

package/dist/modules/analytics/cubes.d.ts

@@ -0,0 +1,19 @@
+import type { CubeDefinition } from "./types";
+/**
+ * Built-in cube definitions for the 4 core analytics models.
+ *
+ * Each cube maps a Cube.js-shaped name (e.g., "Orders.revenue") to a
+ * PostgreSQL table + column. The DrizzleAnalyticsAdapter compiles these
+ * into parameterized SQL queries.
+ */
+export declare const ORDERS_CUBE: CubeDefinition;
+export declare const ORDER_LINE_ITEMS_CUBE: CubeDefinition;
+export declare const INVENTORY_CUBE: CubeDefinition;
+export declare const CUSTOMERS_CUBE: CubeDefinition;
+export declare const VENDOR_ORDERS_CUBE: CubeDefinition;
+export declare const VENDOR_BALANCE_CUBE: CubeDefinition;
+export declare const VENDOR_REVIEWS_CUBE: CubeDefinition;
+export declare const BUILTIN_CUBES: CubeDefinition[];
+/** Marketplace cubes — registered when marketplace plugin is active */
+export declare const MARKETPLACE_CUBES: CubeDefinition[];
+//# sourceMappingURL=cubes.d.ts.map

package/dist/modules/analytics/cubes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cubes.d.ts","sourceRoot":"","sources":["../../../src/modules/analytics/cubes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,SAAS,CAAC;AAE7D;;;;;;GAMG;AAEH,eAAO,MAAM,WAAW,EAAE,cAwBzB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cA6BnC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cA2B5B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cA0B5B,CAAC;AAIF,eAAO,MAAM,kBAAkB,EAAE,cAmBhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAkBjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAiBjC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAAc,EAKzC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAI7C,CAAC"}

package/dist/modules/analytics/cubes.js

@@ -0,0 +1,187 @@
+/**
+ * Built-in cube definitions for the 4 core analytics models.
+ *
+ * Each cube maps a Cube.js-shaped name (e.g., "Orders.revenue") to a
+ * PostgreSQL table + column. The DrizzleAnalyticsAdapter compiles these
+ * into parameterized SQL queries.
+ */
+export const ORDERS_CUBE = {
+    name: "Orders",
+    table: "orders",
+    scopeRules: [
+        { role: "vendor", filter: "id IN (SELECT order_id FROM marketplace_vendor_sub_orders WHERE vendor_id = :vendorId)" },
+        { role: "customer", filter: "customer_id = :customerId" },
+    ],
+    measures: {
+        count: { type: "count" },
+        revenue: { sql: "grand_total", type: "sum" },
+        averageOrderValue: { sql: "grand_total", type: "avg" },
+        subtotalRevenue: { sql: "subtotal", type: "sum" },
+        taxCollected: { sql: "tax_total", type: "sum" },
+        shippingRevenue: { sql: "shipping_total", type: "sum" },
+        discountsGiven: { sql: "discount_total", type: "sum" },
+        uniqueCustomers: { sql: "customer_id", type: "countDistinct" },
+    },
+    dimensions: {
+        id: { sql: "id", type: "string" },
+        orderNumber: { sql: "order_number", type: "string" },
+        status: { sql: "status", type: "string" },
+        currency: { sql: "currency", type: "string" },
+        placedAt: { sql: "placed_at", type: "time" },
+    },
+};
+export const ORDER_LINE_ITEMS_CUBE = {
+    name: "OrderLineItems",
+    table: "order_line_items",
+    scopeRules: [
+        // Vendors see line items only from orders that contain their products
+        { role: "vendor", filter: "order_id IN (SELECT order_id FROM marketplace_vendor_sub_orders WHERE vendor_id = :vendorId)" },
+        // Customers see line items only from their own orders
+        { role: "customer", filter: "order_id IN (SELECT id FROM orders WHERE customer_id = :customerId)" },
+    ],
+    joins: [
+        {
+            table: "orders",
+            type: "left",
+            on: "order_line_items.order_id = orders.id",
+        },
+    ],
+    measures: {
+        count: { type: "count" },
+        itemsSold: { sql: "order_line_items.quantity", type: "sum" },
+        lineItemRevenue: { sql: "order_line_items.total_price", type: "sum" },
+        averageUnitPrice: { sql: "order_line_items.unit_price", type: "avg" },
+    },
+    dimensions: {
+        id: { sql: "order_line_items.id", type: "string" },
+        entityType: { sql: "order_line_items.entity_type", type: "string" },
+        sku: { sql: "order_line_items.sku", type: "string" },
+        title: { sql: "order_line_items.title", type: "string" },
+        fulfillmentStatus: { sql: "order_line_items.fulfillment_status", type: "string" },
+    },
+};
+export const INVENTORY_CUBE = {
+    name: "Inventory",
+    table: "inventory_levels",
+    scopeRules: [
+        // Vendors see inventory only for their own products
+        { role: "vendor", filter: "entity_id IN (SELECT entity_id FROM marketplace_vendor_entities WHERE vendor_id = :vendorId)" },
+    ],
+    measures: {
+        totalOnHand: { sql: "quantity_on_hand", type: "sum" },
+        totalReserved: { sql: "quantity_reserved", type: "sum" },
+        totalAvailable: { sql: "(quantity_on_hand - quantity_reserved)", type: "sum" },
+        inventoryValue: { sql: "(quantity_on_hand * COALESCE(unit_cost, 0))", type: "sum" },
+        lowStockCount: {
+            type: "count",
+            filter: "reorder_threshold IS NOT NULL AND (quantity_on_hand - quantity_reserved) <= reorder_threshold",
+        },
+    },
+    dimensions: {
+        entityId: { sql: "entity_id", type: "string" },
+        warehouseId: { sql: "warehouse_id", type: "string" },
+        lastRestockedAt: { sql: "last_restocked_at", type: "time" },
+    },
+    segments: {
+        lowStock: {
+            sql: "reorder_threshold IS NOT NULL AND (quantity_on_hand - quantity_reserved) <= reorder_threshold",
+        },
+    },
+};
+export const CUSTOMERS_CUBE = {
+    name: "Customers",
+    table: "customers",
+    scopeRules: [
+        // Vendors see customers who placed orders containing their products
+        { role: "vendor", filter: "id IN (SELECT DISTINCT customer_id FROM orders WHERE id IN (SELECT order_id FROM marketplace_vendor_sub_orders WHERE vendor_id = :vendorId) AND customer_id IS NOT NULL)" },
+        // Customers see only themselves
+        { role: "customer", filter: "id = :customerId" },
+    ],
+    measures: {
+        customerCount: { type: "count" },
+        newCustomers: { type: "count" },
+        returningCustomers: {
+            type: "count",
+            filter: "(SELECT COUNT(*) FROM orders WHERE orders.customer_id = customers.id) > 1",
+        },
+    },
+    dimensions: {
+        createdAt: { sql: "created_at", type: "time" },
+        customerGroup: { sql: "COALESCE(metadata->>'customerGroup', 'default')", type: "string" },
+    },
+    segments: {
+        returning: {
+            sql: "(SELECT COUNT(*) FROM orders WHERE orders.customer_id = customers.id) > 1",
+        },
+    },
+};
+// ─── Marketplace Vendor-Scoped Cubes ─────────────────────────────────────────
+export const VENDOR_ORDERS_CUBE = {
+    name: "VendorOrders",
+    table: "marketplace_vendor_sub_orders",
+    scopeRules: [
+        { role: "vendor", filter: "vendor_id = :vendorId" },
+    ],
+    measures: {
+        count: { type: "count" },
+        revenue: { sql: "subtotal", type: "sum" },
+        commissionPaid: { sql: "commission_amount", type: "sum" },
+        netPayout: { sql: "payout_amount", type: "sum" },
+    },
+    dimensions: {
+        id: { sql: "id", type: "string" },
+        vendorId: { sql: "vendor_id", type: "string" },
+        orderId: { sql: "order_id", type: "string" },
+        status: { sql: "status", type: "string" },
+        createdAt: { sql: "created_at", type: "time" },
+    },
+};
+export const VENDOR_BALANCE_CUBE = {
+    name: "VendorBalance",
+    table: "marketplace_vendor_balances",
+    scopeRules: [
+        { role: "vendor", filter: "vendor_id = :vendorId" },
+    ],
+    measures: {
+        totalCredits: { sql: "CASE WHEN amount_cents > 0 THEN amount_cents ELSE 0 END", type: "sum" },
+        totalDebits: { sql: "CASE WHEN amount_cents < 0 THEN ABS(amount_cents) ELSE 0 END", type: "sum" },
+        netBalance: { sql: "amount_cents", type: "sum" },
+        entryCount: { type: "count" },
+    },
+    dimensions: {
+        id: { sql: "id", type: "string" },
+        vendorId: { sql: "vendor_id", type: "string" },
+        type: { sql: "type", type: "string" },
+        createdAt: { sql: "created_at", type: "time" },
+    },
+};
+export const VENDOR_REVIEWS_CUBE = {
+    name: "VendorReviews",
+    table: "marketplace_vendor_reviews",
+    scopeRules: [
+        { role: "vendor", filter: "vendor_id = :vendorId" },
+    ],
+    measures: {
+        count: { type: "count" },
+        averageRating: { sql: "rating", type: "avg" },
+    },
+    dimensions: {
+        id: { sql: "id", type: "string" },
+        vendorId: { sql: "vendor_id", type: "string" },
+        rating: { sql: "rating", type: "number" },
+        status: { sql: "status", type: "string" },
+        createdAt: { sql: "created_at", type: "time" },
+    },
+};
+export const BUILTIN_CUBES = [
+    ORDERS_CUBE,
+    ORDER_LINE_ITEMS_CUBE,
+    INVENTORY_CUBE,
+    CUSTOMERS_CUBE,
+];
+/** Marketplace cubes — registered when marketplace plugin is active */
+export const MARKETPLACE_CUBES = [
+    VENDOR_ORDERS_CUBE,
+    VENDOR_BALANCE_CUBE,
+    VENDOR_REVIEWS_CUBE,
+];

package/dist/modules/analytics/drizzle-adapter.d.ts

@@ -0,0 +1,13 @@
+import type { DrizzleDatabase } from "../../kernel/database/drizzle-db";
+import { type Result } from "../../kernel/result";
+import type { AnalyticsAdapter, AnalyticsMeta, AnalyticsModel, AnalyticsQueryParams, AnalyticsQueryResult, AnalyticsScope } from "./types";
+export declare class DrizzleAnalyticsAdapter implements AnalyticsAdapter {
+    private db;
+    private models;
+    constructor(db: DrizzleDatabase);
+    registerModel(model: AnalyticsModel): void;
+    query(params: AnalyticsQueryParams, scope: AnalyticsScope): Promise<Result<AnalyticsQueryResult>>;
+    getMeta(_scope: AnalyticsScope): Promise<Result<AnalyticsMeta>>;
+    private executeQuery;
+}
+//# sourceMappingURL=drizzle-adapter.d.ts.map