@siggn/core 0.0.1 → 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Guilherme Guerreiro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,15 +1,203 @@
-# siggn
+# @siggn/core
 
-To install dependencies:
+A lightweight and type-safe event-driven pub/sub system for TypeScript projects.
+
+## Features
+
+- **Type-Safe**: Leverages TypeScript to ensure that message payloads are correct at compile and
+  runtime.
+- **Lightweight**: Zero dependencies and a minimal API surface.
+- **Simple API**: Easy to learn and use, with a clear and concise API.
+
+## Installation
+
+You can install the package using your favorite package manager:
 
 ```bash
-bun install
+npm install @siggn/core
 ```
 
-To run:
+```bash
+yarn add @siggn/core
+```
 
 ```bash
-bun run index.ts
+pnpm add @siggn/core
+```
+
+## Usage
+
+Here's a basic example of how to use Siggn:
+
+```typescript
+import { Siggn } from '@siggn/core';
+
+// 1. Define your message types
+type Message =
+  | { type: 'user_created'; userId: string; name: string }
+  | { type: 'user_deleted'; userId: string };
+
+// 2. Create a new Siggn instance
+const siggn = new Siggn<Message>();
+
+// 3. Subscribe to events
+// Use a unique ID for each subscriber to manage subscriptions
+const subscriberId = 'analytics-service';
+
+siggn.subscribe(subscriberId, 'user_created', (msg) => {
+  console.log(`[Analytics] New user created: ${msg.name} (ID: ${msg.userId})`);
+});
+
+// 4. Publish events
+siggn.publish({ type: 'user_created', userId: '123', name: 'John Doe' });
+// Output: [Analytics] New user created: John Doe (ID: 123)
+
+// 5. Unsubscribe from all events for a given ID
+siggn.unsubscribe(subscriberId);
+
+siggn.publish({ type: 'user_created', userId: '456', name: 'Jane Doe' });
+// No output, because the subscriber was removed.
+```
+
+### Using the `make` helper
+
+The `make` method simplifies managing subscriptions for a specific component or service.
+
+```typescript
+const userComponent = siggn.make('user-component');
+
+userComponent.subscribe('user_deleted', (msg) => {
+  console.log(`[UI] User ${msg.userId} was deleted. Updating view...`);
+});
+
+siggn.publish({ type: 'user_deleted', userId: '123' });
+// Output: [UI] User 123 was deleted. Updating view...
+
+// Unsubscribe from all subscriptions made by 'user-component'
+userComponent.unsubscribe();
+```
+
+### Subscribing to multiple events
+
+You can use `subscribeMany` to group subscriptions for a single subscriber.
+
+```typescript
+const auditService = siggn.make('audit-service');
+
+auditService.subscribeMany((subscribe) => {
+  subscribe('user_created', (msg) => {
+    console.log(`[Audit] User created: ${msg.name}`);
+  });
+  subscribe('user_deleted', (msg) => {
+    console.log(`[Audit] User deleted: ${msg.userId}`);
+  });
+});
+
+siggn.publish({ type: 'user_created', userId: '789', name: 'Peter Pan' });
+siggn.publish({ type: 'user_deleted', userId: '123' });
+
+// Unsubscribe from all audit-service events
+auditService.unsubscribe();
+```
+
+### Subscribing to all events
+
+If you need to listen to every message that passes through the bus, regardless of its type, you can
+use `subscribeAll`. This is useful for cross-cutting concerns like logging or debugging.
+
+```typescript
+const logger = siggn.make('logger-service');
+
+logger.subscribeAll((msg) => {
+  console.log(`[Logger] Received event of type: ${msg.type}`);
+});
+
+siggn.publish({ type: 'user_created', userId: '789', name: 'Peter Pan' });
+// Output: [Logger] Received event of type: user_created
+
+siggn.publish({ type: 'user_deleted', userId: '123' });
+// Output: [Logger] Received event of type: user_deleted
+
+// Unsubscribe from all logger-service events
+logger.unsubscribe();
 ```
 
-This project was created using `bun init` in bun v1.2.21. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+### Extending message types with `createChild`
+
+The `createChild` method allows you to create a new, independent `Siggn` instance that inherits the
+message types of its parent. This is useful for creating specialized message buses that extend a
+base set of events without affecting the parent bus.
+
+```typescript
+// Continuing with the previous `Message` type...
+const baseSiggn = new Siggn<Message>();
+
+// 1. Define a new set of messages for a specialized module
+type AdminMessage = { type: 'admin_login'; adminId: string };
+
+// 2. Create a child bus that understands both `Message` and `AdminMessage`
+const adminSiggn = baseSiggn.createChild<AdminMessage>();
+
+// 3. Subscribe to events on the child bus
+adminSiggn.subscribe('audit-log', 'user_created', (msg) => {
+  console.log(`[Admin Audit] User created: ${msg.name}`);
+});
+
+adminSiggn.subscribe('auth-service', 'admin_login', (msg) => {
+  console.log(`[Admin Auth] Admin logged in: ${msg.adminId}`);
+});
+
+// 4. Publish events on the child bus
+adminSiggn.publish({ type: 'user_created', userId: 'abc', name: 'Alice' });
+// Output: [Admin Audit] User created: Alice
+
+adminSiggn.publish({ type: 'admin_login', adminId: 'xyz' });
+// Output: [Admin Auth] Admin logged in: xyz
+
+// Note: The parent and child buses are independent.
+// Publishing on the parent does not affect the child's subscribers.
+baseSiggn.publish({ type: 'user_created', userId: 'def', name: 'Bob' });
+// No output, because the subscription is on `adminSiggn`.
+```
+
+## API
+
+### `new Siggn<T>()`
+
+Creates a new message bus instance. `T` is a union type of all possible messages.
+
+### `publish(msg)`
+
+Publishes a message to all relevant subscribers.
+
+### `subscribe(id, type, callback)`
+
+Subscribes a callback to a specific message type with a unique subscriber ID.
+
+### `subscribeAll(id, callback)`
+
+Subscribes a callback to all message types with a unique subscriber ID. The callback will receive
+every message published on the bus.
+
+### `unsubscribe(id)`
+
+Removes all subscriptions associated with a specific subscriber ID.
+
+### `make(id)`
+
+Returns a helper object with `subscribe`, `subscribeMany`, `subscribeAll`, and `unsubscribe` methods
+pre-bound to the provided ID. This is useful for encapsulating subscription logic within a component
+or service.
+
+### `subscribeMany(id, setup)`
+
+A convenience method to subscribe to multiple message types for a single ID.
+
+### `createChild<C>()`
+
+Creates a new, independent `Siggn` instance whose message types are a union of the parent's types
+and the new child-specific types `C`.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class r{subscriptions;subscribeAllSubscriptions=[];constructor(){this.subscriptions=new Map}createChild(){return new r}make(i){return{subscribe:(s,b)=>{this.subscribe(i,s,b)},unsubscribe:()=>{this.unsubscribe(i)},subscribeMany:s=>{this.subscribeMany(i,s)},subscribeAll:s=>{this.subscribeAll(i,s)}}}subscribeMany(i,s){s((b,t)=>this.subscribe(i,b,t))}subscribe(i,s,b){this.subscriptions.has(s)||this.subscriptions.set(s,[]),this.subscriptions.get(s)?.push({id:i,callback:b})}subscribeAll(i,s){this.subscribeAllSubscriptions.push({id:i,callback:s})}publish(i){this.subscribeAllSubscriptions.forEach(s=>{s.callback(i)}),this.subscriptions.has(i.type)&&this.subscriptions.get(i.type)?.forEach(s=>{s.callback(i)})}unsubscribe(i){this.subscribeAllSubscriptions=this.subscribeAllSubscriptions.filter(s=>s.id!==i);for(const[s,b]of this.subscriptions)this.subscriptions.set(s,b.filter(t=>t.id!==i))}}exports.Siggn=r;

package/dist/index.js

@@ -0,0 +1,53 @@
+class t {
+  subscriptions;
+  subscribeAllSubscriptions = [];
+  constructor() {
+    this.subscriptions = /* @__PURE__ */ new Map();
+  }
+  createChild() {
+    return new t();
+  }
+  make(i) {
+    return {
+      subscribe: (s, b) => {
+        this.subscribe(i, s, b);
+      },
+      unsubscribe: () => {
+        this.unsubscribe(i);
+      },
+      subscribeMany: (s) => {
+        this.subscribeMany(i, s);
+      },
+      subscribeAll: (s) => {
+        this.subscribeAll(i, s);
+      }
+    };
+  }
+  subscribeMany(i, s) {
+    s((b, r) => this.subscribe(i, b, r));
+  }
+  subscribe(i, s, b) {
+    this.subscriptions.has(s) || this.subscriptions.set(s, []), this.subscriptions.get(s)?.push({ id: i, callback: b });
+  }
+  subscribeAll(i, s) {
+    this.subscribeAllSubscriptions.push({ id: i, callback: s });
+  }
+  publish(i) {
+    this.subscribeAllSubscriptions.forEach((s) => {
+      s.callback(i);
+    }), this.subscriptions.has(i.type) && this.subscriptions.get(i.type)?.forEach((s) => {
+      s.callback(i);
+    });
+  }
+  unsubscribe(i) {
+    this.subscribeAllSubscriptions = this.subscribeAllSubscriptions.filter((s) => s.id !== i);
+    for (const [s, b] of this.subscriptions)
+      this.subscriptions.set(
+        s,
+        b.filter((r) => r.id !== i)
+      );
+  }
+}
+export {
+  t as Siggn
+};

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from './siggn.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/src/siggn.d.ts

@@ -0,0 +1,27 @@
+import { Msg } from './types.js';
+export declare class Siggn<T extends Msg> {
+    private subscriptions;
+    private subscribeAllSubscriptions;
+    constructor();
+    createChild<C extends Msg>(): Siggn<T | C>;
+    make(id: string): {
+        subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
+            type: K;
+        }>) => void) => void;
+        unsubscribe: () => void;
+        subscribeMany: (setup: (subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
+            type: K;
+        }>) => void) => void) => void) => void;
+        subscribeAll: (callback: (msg: T) => void) => void;
+    };
+    subscribeMany(id: string, setup: (subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
+        type: K;
+    }>) => void) => void) => void): void;
+    subscribe<K extends T['type']>(id: string, type: K, callback: (msg: Extract<T, {
+        type: K;
+    }>) => void): void;
+    subscribeAll(id: string, callback: (msg: T) => void): void;
+    publish(msg: T): void;
+    unsubscribe(id: string): void;
+}
+//# sourceMappingURL=siggn.d.ts.map

package/dist/src/siggn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"siggn.d.ts","sourceRoot":"","sources":["../../src/siggn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAgB,MAAM,YAAY,CAAC;AAEpD,qBAAa,KAAK,CAAC,CAAC,SAAS,GAAG;IAC9B,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,yBAAyB,CAAmC;;IAMpE,WAAW,CAAC,CAAC,SAAS,GAAG;IAIzB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG;QAChB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,CAAA;SAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,CAAC;QACV,WAAW,EAAE,MAAM,IAAI,CAAC;QACxB,aAAa,EAAE,CACb,KAAK,EAAE,CACL,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,CAAA;SAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI,KACN,IAAI,CAAC;QACV,YAAY,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;KACpD;IAiBD,aAAa,CACX,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,CACL,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI;IAKX,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC3B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI;IASlD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI;IAInD,OAAO,CAAC,GAAG,EAAE,CAAC;IAcd,WAAW,CAAC,EAAE,EAAE,MAAM;CAUvB"}

package/dist/src/types.d.ts

@@ -0,0 +1,14 @@
+export type Msg = {
+    type: string;
+    [key: string]: unknown;
+};
+export type Subscription<T extends Msg, K extends T['type']> = {
+    id: string;
+    callback: (msg: Extract<T, {
+        type: K;
+    }>) => void;
+};
+export type SubscriptionMap<T extends Msg> = {
+    [K in T['type']]: Array<Subscription<T, K>>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,GAAG,IAAI;KAC1C,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC5C,CAAC"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@siggn/core",
-  "version": "0.0.1",
-  "description": "A lightweight event driven pub/sub system",
+  "version": "0.0.4",
+  "description": "A lightweight message bus system for Typescript",
   "keywords": [
-    "pub",
-    "sub",
-    "lightweight",
-    "signals"
+    "pub/sub",
+    "message",
+    "event",
+    "bus"
   ],
   "publishConfig": {
     "@siggn:registry": "https://registry.npmjs.org/",
@@ -18,26 +18,35 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Guiguerreiro39/siggn.git"
+    "url": "git+https://github.com/Guiguerreiro39/siggn.git/",
+    "directory": "packages/core"
   },
-  "license": "ISC",
-  "author": "Guilherme Guerreiro",
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "author": "Guilherme Guerreiro (https://guilhermegr.com)",
   "type": "module",
-  "main": "index.ts",
-  "scripts": {
-    "test": "exit 0"
-  },
-  "dependencies": {
-    "bun-types": "^1.3.0",
-    "csstype": "^3.1.3",
-    "typescript": "^5.9.3",
-    "undici-types": "^7.14.0"
-  },
+  "main": "dist/index.cjs.js",
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.es.js",
   "devDependencies": {
-    "@types/bun": "latest"
+    "typescript": "^5.9.3",
+    "vite": "^7.1.12",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.2.4"
   },
   "peerDependencies": {
     "typescript": "^5"
   },
-  "module": "index.ts"
-}
+  "scripts": {
+    "dev": "vitest",
+    "test": "vitest run",
+    "build": "vite build",
+    "ci": "pnpm run build && pnpm run check-format && pnpm run test",
+    "format": "prettier --write .",
+    "check-format": "prettier --check .",
+    "version": "changeset version",
+    "release": "changeset publish"
+  }
+}

package/.github/workflows/release-package.yml

@@ -1,33 +0,0 @@
-name: Node.js Package
-
-on:
-  release:
-    types: [created]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - run: npm ci
-      - run: npm test
-
-  publish-gpr:
-    needs: build
-    runs-on: ubuntu-latest
-    permissions:
-      packages: write
-      contents: read
-    steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          registry-url: https://npm.pkg.github.com/
-      - run: npm ci
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}

package/bun.lock

@@ -1,29 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "siggn",
-      "devDependencies": {
-        "@types/bun": "latest",
-      },
-      "peerDependencies": {
-        "typescript": "^5",
-      },
-    },
-  },
-  "packages": {
-    "@types/bun": ["@types/bun@1.3.0", "", { "dependencies": { "bun-types": "1.3.0" } }, "sha512-+lAGCYjXjip2qY375xX/scJeVRmZ5cY0wyHYyCYxNcdEXrQ4AOe3gACgd4iQ8ksOslJtW4VNxBJ8llUwc3a6AA=="],
-
-    "@types/node": ["@types/node@24.8.1", "", { "dependencies": { "undici-types": "~7.14.0" } }, "sha512-alv65KGRadQVfVcG69MuB4IzdYVpRwMG/mq8KWOaoOdyY617P5ivaDiMCGOFDWD2sAn5Q0mR3mRtUOgm99hL9Q=="],
-
-    "@types/react": ["@types/react@19.2.2", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-6mDvHUFSjyT2B2yeNx2nUgMxh9LtOWvkhIU3uePn2I2oyNymUAX1NIsdgviM4CH+JSrp2D2hsMvJOkxY+0wNRA=="],
-
-    "bun-types": ["bun-types@1.3.0", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-u8X0thhx+yJ0KmkxuEo9HAtdfgCBaM/aI9K90VQcQioAmkVp3SG3FkwWGibUFz3WdXAdcsqOcbU40lK7tbHdkQ=="],
-
-    "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
-
-    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
-
-    "undici-types": ["undici-types@7.14.0", "", {}, "sha512-QQiYxHuyZ9gQUIrmPo3IA+hUl4KYk8uSA7cHrcKd/l3p1OTpZcM0Tbp9x7FAtXdAYhlasd60ncPpgu6ihG6TOA=="],
-  }
-}

package/index.ts

@@ -1 +0,0 @@
-export * from "./siggn";

package/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc

@@ -1,111 +0,0 @@
----
-description: Use Bun instead of Node.js, npm, pnpm, or vite.
-globs: "*.ts, *.tsx, *.html, *.css, *.js, *.jsx, package.json"
-alwaysApply: false
----
-
-Default to using Bun instead of Node.js.
-
-- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
-- Use `bun test` instead of `jest` or `vitest`
-- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
-- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
-- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
-- Bun automatically loads .env, so don't use dotenv.
-
-## APIs
-
-- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
-- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
-- `Bun.redis` for Redis. Don't use `ioredis`.
-- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
-- `WebSocket` is built-in. Don't use `ws`.
-- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
-- Bun.$`ls` instead of execa.
-
-## Testing
-
-Use `bun test` to run tests.
-
-```ts#index.test.ts
-import { test, expect } from "bun:test";
-
-test("hello world", () => {
-  expect(1).toBe(1);
-});
-```
-
-## Frontend
-
-Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.
-
-Server:
-
-```ts#index.ts
-import index from "./index.html"
-
-Bun.serve({
-  routes: {
-    "/": index,
-    "/api/users/:id": {
-      GET: (req) => {
-        return new Response(JSON.stringify({ id: req.params.id }));
-      },
-    },
-  },
-  // optional websocket support
-  websocket: {
-    open: (ws) => {
-      ws.send("Hello, world!");
-    },
-    message: (ws, message) => {
-      ws.send(message);
-    },
-    close: (ws) => {
-      // handle close
-    }
-  },
-  development: {
-    hmr: true,
-    console: true,
-  }
-})
-```
-
-HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
-
-```html#index.html
-<html>
-  <body>
-    <h1>Hello, world!</h1>
-    <script type="module" src="./frontend.tsx"></script>
-  </body>
-</html>
-```
-
-With the following `frontend.tsx`:
-
-```tsx#frontend.tsx
-import React from "react";
-
-// import .css files directly and it works
-import './index.css';
-
-import { createRoot } from "react-dom/client";
-
-const root = createRoot(document.body);
-
-export default function Frontend() {
-  return <h1>Hello, world!</h1>;
-}
-
-root.render(<Frontend />);
-```
-
-Then, run index.ts
-
-```sh
-bun --hot ./index.ts
-```
-
-For more information, read the Bun API docs in `node_modules/bun-types/docs/**.md`.

package/siggn.ts

@@ -1,32 +0,0 @@
-type Msg = {
-  type: string
-  [key: string]: unknown
-}
-
-export class Siggn <T extends Msg> {
-  private subscriptions: Map<T['type'], Map<string, Function>>
-
-  constructor() {
-    this.subscriptions = new Map();
-  }
-
-  subscribe(id: string, type: T['type'], callback: (msg: T) => void) {
-    if (!this.subscriptions.has(type)) {
-      this.subscriptions.set(type, new Map());
-    }
-    
-    this.subscriptions.get(type)?.set(id, callback);
-  }
-
-  emit(msg: T) {
-    this.subscriptions.get(msg.type)?.forEach((callback) => {
-      callback(msg);
-    });
-  }
-
-  unsubscribe(id: string) {
-    this.subscriptions.forEach((sub) => {
-      sub.delete(id);
-    });
-  }
-}

package/test.ts

@@ -1,35 +0,0 @@
-import { Siggn } from "./siggn";
-
-type Msg = {
-  type: 'increment_count',
-  value: number
-} | {
-  type: 'decrement_count',
-  value: number
-}
-
-const siggn = new Siggn<Msg>();
-
-let count = 0
-
-siggn.subscribe('1', 'increment_count', (msg) => {
-  count += msg.value
-})
-
-siggn.subscribe('2', 'decrement_count', (msg) => {
-  count -= msg.value
-})
-
-function incrementCount(r: typeof siggn) {
-  r.emit({ type: 'increment_count', value: 4 })
-}
-
-function decrementCount(r: typeof siggn) {
-  r.emit({ type: 'decrement_count', value: 2 })
-}
-  
-incrementCount(siggn)
-console.log(count)
-
-decrementCount(siggn)
-console.log(count)

package/tsconfig.json

@@ -1,29 +0,0 @@
-{
-  "compilerOptions": {
-    // Environment setup & latest features
-    "lib": ["ESNext"],
-    "target": "ESNext",
-    "module": "Preserve",
-    "moduleDetection": "force",
-    "jsx": "react-jsx",
-    "allowJs": true,
-
-    // Bundler mode
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    // Best practices
-    "strict": true,
-    "skipLibCheck": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-
-    // Some stricter flags (disabled by default)
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
-  }
-}