mythik 0.0.1 → 0.1.0

package/dist/actions/dispatcher.js

@@ -0,0 +1,366 @@
+import { createUploadHandler, createDeleteHandler } from '../storage/upload-action.js';
+import { formatExportValue } from '../export/format.js';
+import { generateCSV } from '../export/csv.js';
+import { downloadBlob } from '../export/download.js';
+import { createMiddlewareChain } from './middleware.js';
+import { deepResolveExpressionValue } from '../expressions/deep-resolve.js';
+/**
+ * Built-in actions that ship with the framework.
+ * Custom actions can be added via registerAction.
+ */
+/** Recursively resolve expressions in nested objects/arrays */
+export const deepResolve = deepResolveExpressionValue;
+/** Resolve all expression values in params (deeply) */
+export function resolveParams(params, resolve) {
+    if (!params)
+        return {};
+    const resolved = {};
+    for (const [key, value] of Object.entries(params)) {
+        resolved[key] = deepResolve(value, resolve);
+    }
+    return resolved;
+}
+export function createActionDispatcher(config) {
+    const { store } = config;
+    const customActions = config.customActions ?? new Map();
+    // Lazy fetch binding — resolves at call time so test mocks work
+    const fetcher = config.fetcher ?? ((url, opts) => globalThis.fetch(url, opts));
+    // Middleware chain — before/after/onError hooks on all actions
+    const middlewareChain = createMiddlewareChain(config.middleware ?? []);
+    /** Built-in action handlers */
+    const builtinActions = {
+        setState: (params) => {
+            const path = params.statePath;
+            const value = params.value;
+            if (!path)
+                throw new Error('setState action requires "statePath" param');
+            store.set(path, value);
+        },
+        navigate: (params) => {
+            // Navigation is handled by the renderer layer (React Navigation, etc.)
+            // Here we just set the navigation intent in state
+            store.set('/navigation/intent', {
+                screen: params.screen,
+                params: params,
+                timestamp: Date.now(),
+            });
+        },
+        openModal: (params) => {
+            const id = params.id ?? params.modal;
+            if (id)
+                store.set(`/ui/modals/${id}`, true);
+        },
+        closeModal: (params) => {
+            const id = params.id ?? params.modal;
+            if (id)
+                store.set(`/ui/modals/${id}`, false);
+        },
+        openDrawer: (params) => {
+            const id = params.id ?? 'default';
+            store.set(`/ui/drawers/${id}`, true);
+        },
+        closeDrawer: (params) => {
+            const id = params.id ?? 'default';
+            store.set(`/ui/drawers/${id}`, false);
+        },
+        goBack: () => {
+            store.set('/navigation/intent', { action: 'goBack', timestamp: Date.now() });
+        },
+        showNotification: (params) => {
+            const notifications = store.get('/ui/notifications') ?? [];
+            store.set('/ui/notifications', [
+                ...notifications,
+                {
+                    id: crypto.randomUUID(),
+                    message: params.message,
+                    type: params.type ?? 'info',
+                    title: params.title,
+                    duration: params.duration,
+                    timestamp: Date.now(),
+                },
+            ]);
+        },
+        dismissNotification: (params) => {
+            const notifications = store.get('/ui/notifications') ?? [];
+            store.set('/ui/notifications', notifications.filter((n) => n.id !== params.id));
+        },
+        validateForm: (params) => {
+            const formId = params.formId;
+            if (!formId)
+                throw new Error('validateForm action requires "formId" param');
+            if (config.formEngine) {
+                config.formEngine.validateForm(formId);
+            }
+        },
+        touchField: (params) => {
+            const formId = params.formId;
+            const field = params.field;
+            if (!formId || !field)
+                throw new Error('touchField action requires "formId" and "field" params');
+            if (config.formEngine) {
+                config.formEngine.touchField(formId, field);
+            }
+        },
+        resetForm: (params) => {
+            const formId = params.formId;
+            if (!formId)
+                throw new Error('resetForm action requires "formId" param');
+            if (config.formEngine) {
+                config.formEngine.resetForm(formId);
+            }
+        },
+        uploadFile: async (params) => {
+            if (!config.storage) {
+                console.warn('[Mythik] uploadFile action called but no storage adapter configured');
+                return;
+            }
+            const handler = createUploadHandler(config.storage, store, config.storageConfig ?? {});
+            await handler({
+                files: params.files,
+                bucket: params.bucket,
+                target: params.target,
+                elementId: params.elementId,
+                path: params.path,
+                accept: params.accept ?? '*',
+                maxSize: params.maxSize ?? 10_485_760,
+            });
+        },
+        deleteFile: async (params) => {
+            if (!config.storage) {
+                console.warn('[Mythik] deleteFile action called but no storage adapter configured');
+                return;
+            }
+            const handler = createDeleteHandler(config.storage);
+            await handler({
+                path: params.path,
+                bucket: params.bucket,
+            });
+        },
+        export: async (params) => {
+            const source = params.source;
+            const columns = params.columns;
+            const filename = params.filename;
+            const format = params.format ?? 'csv';
+            const title = params.title;
+            const rows = store.get(source) ?? [];
+            const formattedRows = rows.map((row) => {
+                const formatted = {};
+                for (const col of columns) {
+                    formatted[col.field] = formatExportValue(row[col.field], col);
+                }
+                return formatted;
+            });
+            const data = { columns, rows, formattedRows, title };
+            if (format === 'csv') {
+                const blob = generateCSV(data);
+                downloadBlob(blob, `${filename}.csv`);
+                return;
+            }
+            const adapter = config.exportAdapters?.[format];
+            if (!adapter) {
+                console.warn(`[Mythik] No export adapter registered for format "${format}". Register via exportAdapters prop.`);
+                return;
+            }
+            const blob = await adapter.generate(data, format);
+            downloadBlob(blob, `${filename}.${format}`);
+        },
+        toggleTheme: () => {
+            const current = store.get('/preferences/theme');
+            store.set('/preferences/theme', current === 'dark' ? 'light' : 'dark');
+        },
+        setLocale: (params) => {
+            if (params.locale)
+                store.set('/preferences/locale', params.locale);
+        },
+        copyToClipboard: (params) => {
+            // Clipboard access is handled by the renderer layer
+            const value = typeof params.value === 'object' && params.value !== null
+                ? JSON.stringify(params.value, null, 2)
+                : params.value;
+            store.set('/ui/clipboard', { value, timestamp: Date.now() });
+        },
+        openUrl: (params) => {
+            // URL opening is handled by the renderer layer
+            store.set('/ui/openUrl', { url: params.url, timestamp: Date.now() });
+        },
+        fetch: async (params) => {
+            const url = params.url;
+            const method = params.method ?? 'GET';
+            const body = params.body;
+            const target = params.target;
+            const headers = params.headers ?? {};
+            if (!url)
+                throw new Error('fetch action requires "url" param');
+            store.set('/ui/loading', true);
+            try {
+                const options = {
+                    method,
+                    headers: { 'Content-Type': 'application/json', ...headers },
+                };
+                if (body && method !== 'GET') {
+                    // Sanitize body: convert empty strings to null (databases reject "" for typed columns)
+                    const sanitized = {};
+                    for (const [k, v] of Object.entries(body)) {
+                        sanitized[k] = v === '' ? null : v;
+                    }
+                    options.body = JSON.stringify(sanitized);
+                }
+                const response = await fetcher(url, options);
+                const data = await response.json().catch(() => null);
+                if (!response.ok) {
+                    store.set('/ui/loading', false);
+                    store.set('/ui/lastError', { status: response.status, message: `HTTP ${response.status}`, data });
+                    return;
+                }
+                if (target) {
+                    store.set(target, data);
+                }
+                store.set('/ui/loading', false);
+                store.set('/ui/lastError', null);
+            }
+            catch (err) {
+                store.set('/ui/loading', false);
+                store.set('/ui/lastError', { message: err instanceof Error ? err.message : 'Network error' });
+            }
+        },
+        toggleSelection: (params) => {
+            const statePath = params.statePath;
+            const value = params.value;
+            if (!statePath)
+                throw new Error('toggleSelection action requires "statePath" param');
+            const current = store.get(statePath) ?? [];
+            const idx = current.indexOf(value);
+            if (idx === -1) {
+                // Single mode: replace; multiple mode: append
+                if (params.mode === 'single') {
+                    store.set(statePath, [value]);
+                }
+                else {
+                    store.set(statePath, [...current, value]);
+                }
+            }
+            else {
+                store.set(statePath, current.filter((_, i) => i !== idx));
+            }
+        },
+        selectAll: (params) => {
+            const statePath = params.statePath;
+            const values = params.values;
+            if (!statePath)
+                throw new Error('selectAll action requires "statePath" param');
+            store.set(statePath, values ?? []);
+        },
+        selectNone: (params) => {
+            const statePath = params.statePath;
+            if (!statePath)
+                throw new Error('selectNone action requires "statePath" param');
+            store.set(statePath, []);
+        },
+        submitForm: async (params) => {
+            // Form validation gate
+            const formId = params.formId;
+            if (formId) {
+                let isValid;
+                if (config.formEngine) {
+                    isValid = config.formEngine.validateForm(formId);
+                }
+                else {
+                    isValid = store.get(`/ui/forms/${formId}/isValid`) !== false;
+                }
+                if (!isValid) {
+                    builtinActions.showNotification({ message: 'Please fix the errors before submitting', type: 'error' });
+                    return;
+                }
+            }
+            // Combines validation + fetch in one action
+            const url = params.url;
+            const method = params.method ?? 'POST';
+            const body = params.body;
+            const target = params.target;
+            const successMessage = params.successMessage;
+            if (!url)
+                throw new Error('submitForm action requires "url" param');
+            store.set('/ui/submitting', true);
+            try {
+                const response = await fetcher(url, {
+                    method,
+                    headers: { 'Content-Type': 'application/json' },
+                    body: body ? JSON.stringify(Object.fromEntries(Object.entries(body).map(([k, v]) => [k, v === '' ? null : v]))) : undefined,
+                });
+                const data = await response.json().catch(() => null);
+                if (!response.ok) {
+                    store.set('/ui/submitting', false);
+                    store.set('/ui/lastError', { status: response.status, data });
+                    return;
+                }
+                if (target)
+                    store.set(target, data);
+                store.set('/ui/submitting', false);
+                store.set('/ui/lastError', null);
+                if (successMessage) {
+                    builtinActions.showNotification({ message: successMessage, type: 'success' });
+                }
+            }
+            catch (err) {
+                store.set('/ui/submitting', false);
+                store.set('/ui/lastError', { message: err instanceof Error ? err.message : 'Network error' });
+            }
+        },
+    };
+    async function dispatch(binding, resolve) {
+        const { action, params } = binding;
+        const resolvedParams = resolveParams(params, resolve);
+        // Build middleware context
+        const mwContext = {
+            action,
+            params: resolvedParams,
+            getState: (path) => store.get(path),
+            setParam: (key, value) => { resolvedParams[key] = value; },
+        };
+        // Execute before middleware
+        await middlewareChain.executeBefore(mwContext);
+        // Security: rate limiting
+        if (config.rateLimiter) {
+            config.rateLimiter.assertAllowed();
+        }
+        // Security: URL whitelist for fetch/submitForm
+        if ((action === 'fetch' || action === 'submitForm') && config.urlGuard && resolvedParams.url) {
+            config.urlGuard.assertAllowed(resolvedParams.url);
+        }
+        // Security: state path protection for setState
+        if (action === 'setState' && config.stateGuard && resolvedParams.statePath) {
+            config.stateGuard.assertCanWrite(resolvedParams.statePath);
+        }
+        try {
+            // Check built-in actions first
+            const builtinHandler = builtinActions[action];
+            if (builtinHandler) {
+                const result = await builtinHandler(resolvedParams);
+                await middlewareChain.executeAfter(mwContext, result);
+                return;
+            }
+            // Check custom actions
+            const customAction = customActions.get(action);
+            if (customAction) {
+                const result = await customAction.handler(resolvedParams, (path, value) => {
+                    // Security: protect state paths in custom actions too
+                    if (config.stateGuard)
+                        config.stateGuard.assertCanWrite(path);
+                    store.set(path, value);
+                }, (path) => store.get(path));
+                await middlewareChain.executeAfter(mwContext, result);
+                return;
+            }
+            throw new Error(`Unknown action: "${action}". Register it via plugins.`);
+        }
+        catch (err) {
+            await middlewareChain.executeOnError(mwContext, err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+    }
+    function registerAction(action) {
+        customActions.set(action.name, action);
+    }
+    return { dispatch, registerAction };
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/actions/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/actions/dispatcher.ts"],"names":[],"mappings":"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"}

package/dist/actions/middleware.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Dispatcher Middleware — pre/post hooks on ALL actions.
+ *
+ * Separation of concerns:
+ * - Framework Fetch interceptors = networking (headers, retry, timeout)
+ * - Dispatcher Middleware = actions (logging, analytics, auth lifecycle)
+ */
+export interface MiddlewareContext {
+    action: string;
+    params: Record<string, unknown>;
+    getState: (path: string) => unknown;
+    /** Modify a param before action execution. */
+    setParam: (key: string, value: unknown) => void;
+}
+export interface ActionMiddleware {
+    name: string;
+    before?: (context: MiddlewareContext) => void | Promise<void>;
+    after?: (context: MiddlewareContext, result: unknown) => void | Promise<void>;
+    onError?: (context: MiddlewareContext, error: Error) => void | Promise<void>;
+}
+export interface MiddlewareChain {
+    executeBefore: (context: MiddlewareContext) => Promise<void>;
+    executeAfter: (context: MiddlewareContext, result: unknown) => Promise<void>;
+    executeOnError: (context: MiddlewareContext, error: Error) => Promise<void>;
+}
+export declare function createMiddlewareChain(middleware: ActionMiddleware[]): MiddlewareChain;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/actions/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/actions/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,YAAY,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,cAAc,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,eAAe,CA8BrF"}

package/dist/actions/middleware.js

@@ -0,0 +1,37 @@
+/**
+ * Dispatcher Middleware — pre/post hooks on ALL actions.
+ *
+ * Separation of concerns:
+ * - Framework Fetch interceptors = networking (headers, retry, timeout)
+ * - Dispatcher Middleware = actions (logging, analytics, auth lifecycle)
+ */
+export function createMiddlewareChain(middleware) {
+    async function executeBefore(context) {
+        for (const mw of middleware) {
+            if (mw.before) {
+                await mw.before(context);
+            }
+        }
+    }
+    async function executeAfter(context, result) {
+        for (const mw of middleware) {
+            if (mw.after) {
+                await mw.after(context, result);
+            }
+        }
+    }
+    async function executeOnError(context, error) {
+        for (const mw of middleware) {
+            if (mw.onError) {
+                try {
+                    await mw.onError(context, error);
+                }
+                catch {
+                    // Individual onError failure must not prevent other error handlers from running
+                }
+            }
+        }
+    }
+    return { executeBefore, executeAfter, executeOnError };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/actions/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/actions/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,MAAM,UAAU,qBAAqB,CAAC,UAA8B;IAClE,KAAK,UAAU,aAAa,CAAC,OAA0B;QACrD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;gBACd,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,UAAU,YAAY,CAAC,OAA0B,EAAE,MAAe;QACrE,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;gBACb,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,UAAU,cAAc,CAAC,OAA0B,EAAE,KAAY;QACpE,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC;gBAAC,MAAM,CAAC;oBACP,gFAAgF;gBAClF,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;AACzD,CAAC"}

package/dist/actions/transaction-engine.d.ts

@@ -0,0 +1,13 @@
+import type { StateStore } from '../state/store.js';
+import type { TransactionConfig, ResolveFn } from '../types.js';
+import type { ActionDispatcherInstance } from './dispatcher.js';
+export interface TransactionEngineConfig {
+    store: StateStore;
+    dispatcher: ActionDispatcherInstance;
+    resolve: ResolveFn;
+}
+export interface TransactionEngine {
+    execute: (config: TransactionConfig) => Promise<void>;
+}
+export declare function createTransactionEngine(config: TransactionEngineConfig): TransactionEngine;
+//# sourceMappingURL=transaction-engine.d.ts.map

package/dist/actions/transaction-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-engine.d.ts","sourceRoot":"","sources":["../../src/actions/transaction-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,wBAAwB,CAAC;IACrC,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAID,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CA0G1F"}

package/dist/actions/transaction-engine.js

@@ -0,0 +1,96 @@
+const DEFAULT_TIMEOUT = 10_000;
+export function createTransactionEngine(config) {
+    const { store, dispatcher, resolve } = config;
+    // --- Queue: one transaction at a time ---
+    let running = false;
+    const queue = [];
+    function processQueue() {
+        if (running || queue.length === 0)
+            return;
+        running = true;
+        const next = queue.shift();
+        runTransaction(next.txConfig)
+            .finally(() => {
+            running = false;
+            next.done();
+            processQueue();
+        });
+    }
+    // --- Execute phases sequentially ---
+    async function executeActions(actions) {
+        for (const binding of actions) {
+            await dispatcher.dispatch(binding, resolve);
+        }
+    }
+    // --- Core transaction logic ---
+    async function runTransaction(txConfig) {
+        const timeout = txConfig.timeout ?? DEFAULT_TIMEOUT;
+        // Phase 1: before (not rolled back)
+        if (txConfig.before && txConfig.before.length > 0) {
+            await executeActions(txConfig.before);
+        }
+        // Phase 2: snapshot (AFTER before, BEFORE optimistic)
+        const snapshot = store.getSnapshot();
+        // Phase 3: optimistic (rolled back on error)
+        if (txConfig.optimistic && txConfig.optimistic.length > 0) {
+            await executeActions(txConfig.optimistic);
+        }
+        // Phase 4: confirm (with timeout)
+        try {
+            // Clear any previous lastError so we can detect new ones
+            store.set('/ui/lastError', null);
+            await Promise.race([
+                executeActions(txConfig.confirm),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Transaction timeout')), timeout)),
+            ]);
+            // Check if confirm resulted in an error stored by the fetch action
+            const lastError = store.get('/ui/lastError');
+            if (lastError) {
+                store.set('/tx/error', lastError);
+                throw new Error('Confirm phase failed');
+            }
+            // Phase 5a: onSuccess
+            if (txConfig.onSuccess && txConfig.onSuccess.length > 0) {
+                await executeActions(txConfig.onSuccess);
+            }
+        }
+        catch (err) {
+            // Rollback: restore snapshot atomically (single set, one re-render)
+            store.set('/', snapshot);
+            // Write error to /tx/error if not already set
+            if (!store.get('/tx/error')) {
+                store.set('/tx/error', {
+                    message: err instanceof Error ? err.message : 'Transaction failed',
+                });
+            }
+            // Phase 5b: onError (after rollback)
+            if (txConfig.onError && txConfig.onError.length > 0) {
+                try {
+                    await executeActions(txConfig.onError);
+                }
+                catch (onErrorErr) {
+                    console.error('Transaction onError handler failed:', onErrorErr);
+                }
+            }
+        }
+        finally {
+            // Cleanup /tx/*
+            const txState = store.get('/tx');
+            if (txState !== undefined) {
+                store.set('/tx', undefined);
+            }
+        }
+    }
+    // --- Public API ---
+    function execute(txConfig) {
+        return new Promise((resolvePromise) => {
+            queue.push({
+                txConfig,
+                done: () => resolvePromise(),
+            });
+            processQueue();
+        });
+    }
+    return { execute };
+}
+//# sourceMappingURL=transaction-engine.js.map

package/dist/actions/transaction-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-engine.js","sourceRoot":"","sources":["../../src/actions/transaction-engine.ts"],"names":[],"mappings":"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"}