vapor-chamber 0.1.0

package/dist/plugins.d.ts

@@ -0,0 +1,46 @@
+/**
+ * vapor-chamber - Built-in plugins
+ */
+import type { Command, Plugin } from './command-bus';
+/**
+ * Logger plugin - logs all commands and results
+ */
+export declare function logger(options?: {
+    collapsed?: boolean;
+    filter?: (cmd: Command) => boolean;
+}): Plugin;
+/**
+ * Validator plugin - validate commands before execution
+ */
+export declare function validator(rules: {
+    [action: string]: (cmd: Command) => string | null;
+}): Plugin;
+/**
+ * History plugin - tracks command history for undo/redo
+ */
+export interface HistoryState {
+    past: Command[];
+    future: Command[];
+    canUndo: boolean;
+    canRedo: boolean;
+}
+export declare function history(options?: {
+    maxSize?: number;
+    filter?: (cmd: Command) => boolean;
+}): Plugin & {
+    getState: () => HistoryState;
+    undo: () => Command | undefined;
+    redo: () => Command | undefined;
+    clear: () => void;
+};
+/**
+ * Debounce plugin - debounce specific actions
+ * Returns a pending result immediately, executes after wait period
+ */
+export declare function debounce(actions: string[], wait: number): Plugin;
+/**
+ * Throttle plugin - execute immediately, then block for wait period
+ * Unlike debounce, throttle guarantees execution on first call
+ */
+export declare function throttle(actions: string[], wait: number): Plugin;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAEpE;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CAC/B,GAAG,MAAM,CAwBd;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;CACnD,GAAG,MAAM,CAWT;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,OAAO,CAAC,OAAO,GAAE;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CAC/B,GAAG,MAAM,GAAG;IAChB,QAAQ,EAAE,MAAM,YAAY,CAAC;IAC7B,IAAI,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAwCA;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,GACX,MAAM,CAwBR;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,GACX,MAAM,CAmBR"}

package/dist/plugins.js

@@ -0,0 +1,130 @@
+/**
+ * vapor-chamber - Built-in plugins
+ */
+/**
+ * Logger plugin - logs all commands and results
+ */
+export function logger(options = {}) {
+    const { collapsed = true, filter } = options;
+    return (cmd, next) => {
+        if (filter && !filter(cmd))
+            return next();
+        const label = `⚡ ${cmd.action}`;
+        const log = collapsed ? console.groupCollapsed : console.group;
+        log(label);
+        console.log('target:', cmd.target);
+        if (cmd.payload !== undefined)
+            console.log('payload:', cmd.payload);
+        const result = next();
+        if (result.ok) {
+            console.log('result:', result.value);
+        }
+        else {
+            console.error('error:', result.error);
+        }
+        console.groupEnd();
+        return result;
+    };
+}
+/**
+ * Validator plugin - validate commands before execution
+ */
+export function validator(rules) {
+    return (cmd, next) => {
+        const rule = rules[cmd.action];
+        if (rule) {
+            const error = rule(cmd);
+            if (error) {
+                return { ok: false, error: new Error(error) };
+            }
+        }
+        return next();
+    };
+}
+export function history(options = {}) {
+    const { maxSize = 50, filter } = options;
+    const past = [];
+    const future = [];
+    const plugin = (cmd, next) => {
+        const result = next();
+        // Only track successful commands that pass filter
+        if (result.ok && (!filter || filter(cmd))) {
+            past.push(cmd);
+            if (past.length > maxSize)
+                past.shift();
+            future.length = 0; // Clear redo stack on new command
+        }
+        return result;
+    };
+    return Object.assign(plugin, {
+        getState: () => ({
+            past: [...past],
+            future: [...future],
+            canUndo: past.length > 0,
+            canRedo: future.length > 0,
+        }),
+        undo: () => {
+            const cmd = past.pop();
+            if (cmd)
+                future.push(cmd);
+            return cmd;
+        },
+        redo: () => {
+            const cmd = future.pop();
+            if (cmd)
+                past.push(cmd);
+            return cmd;
+        },
+        clear: () => {
+            past.length = 0;
+            future.length = 0;
+        },
+    });
+}
+/**
+ * Debounce plugin - debounce specific actions
+ * Returns a pending result immediately, executes after wait period
+ */
+export function debounce(actions, wait) {
+    const actionSet = new Set(actions);
+    const timers = new Map();
+    const results = new Map();
+    return (cmd, next) => {
+        if (!actionSet.has(cmd.action))
+            return next();
+        const key = `${cmd.action}:${JSON.stringify(cmd.target)}`;
+        // Clear existing timer
+        const existing = timers.get(key);
+        if (existing)
+            clearTimeout(existing);
+        // Schedule execution
+        timers.set(key, setTimeout(() => {
+            const result = next();
+            results.set(key, result);
+            timers.delete(key);
+        }, wait));
+        // Return pending status synchronously (check results map for actual result)
+        return results.get(key) ?? { ok: true, value: { pending: true, key } };
+    };
+}
+/**
+ * Throttle plugin - execute immediately, then block for wait period
+ * Unlike debounce, throttle guarantees execution on first call
+ */
+export function throttle(actions, wait) {
+    const actionSet = new Set(actions);
+    const lastRun = new Map();
+    return (cmd, next) => {
+        if (!actionSet.has(cmd.action))
+            return next();
+        const key = `${cmd.action}:${JSON.stringify(cmd.target)}`;
+        const now = Date.now();
+        const last = lastRun.get(key) ?? 0;
+        if (now - last >= wait) {
+            lastRun.set(key, now);
+            return next();
+        }
+        // Throttled - return skipped status
+        return { ok: true, value: { throttled: true, key, retryIn: wait - (now - last) } };
+    };
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "vapor-chamber",
+  "version": "0.1.0",
+  "description": "Lightweight command bus for Vue Vapor - plugins, hooks, undo/redo",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm run test:run"
+  },
+  "keywords": [
+    "vue",
+    "vapor",
+    "vue-vapor",
+    "command-bus",
+    "commands",
+    "plugins",
+    "middleware",
+    "undo-redo",
+    "state-management",
+    "signals",
+    "reactive"
+  ],
+  "author": "Luciano Federico Pereira",
+  "license": "LGPL-2.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lucianofedericopereira/vapor-chamber.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lucianofedericopereira/vapor-chamber/issues"
+  },
+  "homepage": "https://github.com/lucianofedericopereira/vapor-chamber#readme",
+  "peerDependencies": {
+    "vue": ">=3.5.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.18",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}