@dafengzhen/event-bus 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,49 @@
+type EventMap = Record<string, unknown>;
+type Listener<Payload> = Payload extends void ? () => void : (payload: Payload) => void;
+type AnyListener<E extends EventMap> = <K extends keyof E>(event: K, payload: E[K]) => void;
+type PatternKind = 'star' | 'prefix' | 'param';
+type Pattern<_K extends string> = '*' | `${string}:*` | `${string}{${string}}${string}`;
+type PatternToKeyShape<P extends string> = P extends '*' ? string : P extends `${infer Prefix}:*` ? `${Prefix}:${string}` | Prefix : P extends `${infer A}{${string}}${infer B}` ? `${A}${string}${B}` : never;
+type MatchKeys<Keys extends string, P extends Pattern<Keys>> = Extract<Keys, PatternToKeyShape<P>>;
+type EmitContext<E extends EventMap, K extends keyof E> = {
+    readonly blocked: boolean;
+    readonly event: K;
+    readonly payload: E[K];
+    readonly matched: readonly PatternListenerInfo<E>[];
+    readonly meta: Record<string, unknown>;
+    block(): void;
+};
+type Middleware<E extends EventMap> = <K extends keyof E>(ctx: EmitContext<E, K>, next: () => Promise<void>) => Promise<void> | void;
+type PatternMiddleware<E extends EventMap> = (ctx: EmitContext<E, keyof E>, next: () => Promise<void>) => Promise<void> | void;
+type PatternListenerInfo<E extends EventMap> = {
+    readonly kind: PatternKind;
+    readonly once?: boolean;
+    readonly priority: number;
+    readonly prefix?: string;
+    readonly handler: (event: keyof E, payload: E[keyof E]) => void;
+};
+type PatternOptions = {
+    once?: boolean;
+    priority?: number;
+};
+/**
+ * EventBus.
+ *
+ * @author dafengzhen
+ */
+export class EventBus<E extends EventMap> {
+    clear(event?: keyof E): void;
+    on<K extends keyof E>(event: K, listener: Listener<E[K]>): () => void;
+    off<K extends keyof E>(event: K, listener: Listener<E[K]>): void;
+    once<K extends keyof E>(event: K, listener: Listener<E[K]>): () => void;
+    onAny(listener: AnyListener<E>): () => void;
+    use(mw: Middleware<E>): () => void;
+    usePattern(mw: PatternMiddleware<E>): () => void;
+    onPattern<P extends Pattern<Extract<keyof E, string>>>(pattern: P, handler: <K extends keyof E & MatchKeys<Extract<keyof E, string>, P>>(event: K, payload: E[K], params?: Record<string, string>) => void, options?: PatternOptions): () => void;
+    oncePattern<P extends Pattern<Extract<keyof E, string>>>(pattern: P, handler: <K extends keyof E & MatchKeys<Extract<keyof E, string>, P>>(event: K, payload: E[K], params?: Record<string, string>) => void, options?: Omit<PatternOptions, 'once'>): () => void;
+    listenerCount(event: keyof E): number;
+    emit<K extends keyof E>(event: K, ...args: E[K] extends void ? [] : [payload: E[K]]): void;
+    emitAsync<K extends keyof E>(event: K, ...args: E[K] extends void ? [] : [payload: E[K]]): Promise<void>;
+}
+
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["src/src/types.ts","src/src/event-bus.ts","src/src/index.ts","src/index.ts"],"sourcesContent":[null,null,null,"import { EventBus } from './event-bus.ts';\nimport * as Types from './types.ts';\n\nexport { EventBus, Types };\n"],"names":[],"version":3,"file":"index.d.ts.map"}

package/package.json

@@ -0,0 +1,160 @@
+{
+  "name": "@dafengzhen/event-bus",
+  "version": "0.1.0",
+  "description": "A lightweight TypeScript event bus with strong typing, middleware pipeline, and pattern-based event listeners.",
+  "keywords": [
+    "event-bus",
+    "event-emitter",
+    "events",
+    "middleware",
+    "observer",
+    "pattern-matching",
+    "pubsub",
+    "typed",
+    "typescript"
+  ],
+  "homepage": "https://github.com/dafengzhen/event-bus#readme",
+  "bugs": {
+    "url": "https://github.com/dafengzhen/event-bus/issues"
+  },
+  "license": "MIT",
+  "author": "dafengzhen",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dafengzhen/event-bus.git"
+  },
+  "source": "./src/index.ts",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "default": "./dist/esm/modern/index.js"
+      },
+      "require": {
+        "default": "./dist/cjs/modern/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "parcel build",
+    "prepare": "husky install",
+    "test": "jest",
+    "watch": "parcel watch",
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "lint:fmt": "npm run lint:fix && npm run fmt"
+  },
+  "dependencies": {
+    "@swc/helpers": "^0.5.18",
+    "browserslist-config-baseline": "^0.5.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.28.6",
+    "@babel/preset-env": "^7.28.6",
+    "@babel/preset-typescript": "^7.28.5",
+    "@commitlint/cli": "^20.3.1",
+    "@commitlint/config-conventional": "^20.3.1",
+    "@commitlint/prompt-cli": "^20.3.1",
+    "@jest/globals": "^30.2.0",
+    "@parcel/packager-ts": "^2.16.3",
+    "@parcel/transformer-typescript-types": "^2.16.3",
+    "@types/node": "^25.0.10",
+    "babel-jest": "^30.2.0",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
+    "jest-environment-jsdom": "^30.2.0",
+    "oxfmt": "^0.26.0",
+    "oxlint": "^1.41.0",
+    "parcel": "^2.16.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,mjs,cjs}": "npm run lint",
+    "*": "npm run fmt --no-error-on-unmatched-pattern"
+  },
+  "targets": {
+    "legacy-cjs": {
+      "distDir": "./dist/cjs/legacy",
+      "engines": {
+        "browsers": ">0.3%, Chrome >= 87, ChromeAndroid >= 87, Edge >= 87, Firefox >= 83, FirefoxAndroid >= 83, Safari >= 14, iOS >= 14"
+      },
+      "includeNodeModules": true,
+      "isLibrary": true,
+      "optimize": true,
+      "outputFormat": "commonjs",
+      "sourceMap": true
+    },
+    "legacy-cjs-dev": {
+      "distDir": "./dist/cjs/legacy-dev",
+      "engines": {
+        "browsers": ">0.3%, Chrome >= 87, ChromeAndroid >= 87, Edge >= 87, Firefox >= 83, FirefoxAndroid >= 83, Safari >= 14, iOS >= 14"
+      },
+      "includeNodeModules": true,
+      "isLibrary": true,
+      "optimize": false,
+      "outputFormat": "commonjs",
+      "sourceMap": true
+    },
+    "legacy-esm": {
+      "distDir": "./dist/esm/legacy",
+      "engines": {
+        "browsers": ">0.3%, Chrome >= 87, ChromeAndroid >= 87, Edge >= 87, Firefox >= 83, FirefoxAndroid >= 83, Safari >= 14, iOS >= 14"
+      },
+      "includeNodeModules": true,
+      "isLibrary": true,
+      "optimize": true,
+      "outputFormat": "esmodule",
+      "sourceMap": true
+    },
+    "legacy-esm-dev": {
+      "distDir": "./dist/esm/legacy-dev",
+      "engines": {
+        "browsers": ">0.3%, Chrome >= 87, ChromeAndroid >= 87, Edge >= 87, Firefox >= 83, FirefoxAndroid >= 83, Safari >= 14, iOS >= 14"
+      },
+      "includeNodeModules": true,
+      "isLibrary": true,
+      "optimize": false,
+      "outputFormat": "esmodule",
+      "sourceMap": true
+    },
+    "modern-cjs": {
+      "distDir": "./dist/cjs/modern",
+      "includeNodeModules": true,
+      "isLibrary": true,
+      "optimize": true,
+      "outputFormat": "commonjs",
+      "sourceMap": true
+    },
+    "modern-cjs-dev": {
+      "distDir": "./dist/cjs/modern-dev",
+      "includeNodeModules": true,
+      "isLibrary": true,
+      "optimize": false,
+      "outputFormat": "commonjs",
+      "sourceMap": true
+    },
+    "modern-esm": {
+      "distDir": "./dist/esm/modern",
+      "includeNodeModules": true,
+      "isLibrary": true,
+      "optimize": true,
+      "outputFormat": "esmodule",
+      "sourceMap": true
+    },
+    "modern-esm-dev": {
+      "distDir": "./dist/esm/modern-dev",
+      "includeNodeModules": true,
+      "isLibrary": true,
+      "optimize": false,
+      "outputFormat": "esmodule",
+      "sourceMap": true
+    }
+  }
+}