@tulipes/core 0.1.0

package/dist/sockets/socket-manager.d.ts

@@ -0,0 +1,39 @@
+import type { Server as HttpServer } from "node:http";
+import { Server, type Namespace, type ServerOptions } from "socket.io";
+import { BootReport } from "../errors/boot-error.js";
+/**
+ * Wraps the process-wide Socket.IO server (web branch only, phase 11w).
+ *
+ * Namespaces are the socket-side equivalent of route prefixes, and get the
+ * same ownership rule as everything else in Tulipes: a module claims its
+ * namespace ("/users") exactly once, and emitting into a namespace nobody
+ * claimed throws instead of silently broadcasting to nothing.
+ */
+export declare class SocketManager {
+    #private;
+    constructor(httpServer: HttpServer, options?: Partial<ServerOptions>);
+    /** Escape hatch for advanced use — prefer `of()` for claimed namespaces. */
+    get io(): Server;
+    /** Emit-side accessor, fail-closed on unclaimed namespaces. */
+    of(name: string): Namespace;
+    /** Claimed namespace names — for the startup banner and tooling. */
+    namespaces(): string[];
+    /** @internal Module-scoped facade for the loader. */
+    forModule(moduleName: string, report: BootReport): SocketRegistry;
+    /** @internal SocketRegistry only. */
+    claim_(name: string, owner: string): string | undefined;
+    /**
+     * Disconnects every client. Deliberately NOT io.close() — that would also
+     * close the attached http server, whose lifecycle belongs to boot.
+     */
+    close(): void;
+}
+export declare class SocketRegistry {
+    #private;
+    constructor(manager: SocketManager, moduleName: string, report: BootReport);
+    /**
+     * Claim a namespace and wire it up. The setup callback receives the live
+     * Namespace — attach middleware and connection handlers there.
+     */
+    namespace(name: string, setup: (nsp: Namespace) => void): this;
+}

package/dist/sockets/socket-manager.js

@@ -0,0 +1,85 @@
+import { Server } from "socket.io";
+import { BootReport } from "../errors/boot-error.js";
+/**
+ * Wraps the process-wide Socket.IO server (web branch only, phase 11w).
+ *
+ * Namespaces are the socket-side equivalent of route prefixes, and get the
+ * same ownership rule as everything else in Tulipes: a module claims its
+ * namespace ("/users") exactly once, and emitting into a namespace nobody
+ * claimed throws instead of silently broadcasting to nothing.
+ */
+export class SocketManager {
+    #io;
+    /** namespace name → owning module */
+    #namespaces = new Map();
+    constructor(httpServer, options) {
+        this.#io = new Server(httpServer, options);
+    }
+    /** Escape hatch for advanced use — prefer `of()` for claimed namespaces. */
+    get io() {
+        return this.#io;
+    }
+    /** Emit-side accessor, fail-closed on unclaimed namespaces. */
+    of(name) {
+        if (!this.#namespaces.has(name)) {
+            throw new Error(`Socket namespace "${name}" was never claimed by any module (known: ${[...this.#namespaces.keys()].join(", ") || "none"})`);
+        }
+        return this.#io.of(name);
+    }
+    /** Claimed namespace names — for the startup banner and tooling. */
+    namespaces() {
+        return [...this.#namespaces.keys()];
+    }
+    /** @internal Module-scoped facade for the loader. */
+    forModule(moduleName, report) {
+        return new SocketRegistry(this, moduleName, report);
+    }
+    /** @internal SocketRegistry only. */
+    claim_(name, owner) {
+        const existing = this.#namespaces.get(name);
+        if (existing)
+            return existing;
+        this.#namespaces.set(name, owner);
+        return undefined;
+    }
+    /**
+     * Disconnects every client. Deliberately NOT io.close() — that would also
+     * close the attached http server, whose lifecycle belongs to boot.
+     */
+    close() {
+        this.#io.disconnectSockets(true);
+    }
+}
+/** "/", or "/name" — lowercase kebab-case. */
+const NAMESPACE = /^\/([a-z0-9-]+)?$/;
+export class SocketRegistry {
+    #manager;
+    #module;
+    #report;
+    constructor(manager, moduleName, report) {
+        this.#manager = manager;
+        this.#module = moduleName;
+        this.#report = report;
+    }
+    /**
+     * Claim a namespace and wire it up. The setup callback receives the live
+     * Namespace — attach middleware and connection handlers there.
+     */
+    namespace(name, setup) {
+        if (!NAMESPACE.test(name)) {
+            this.#issue(`namespace "${name}" is invalid — expected "/" or "/kebab-case-name"`);
+            return this;
+        }
+        const owner = this.#manager.claim_(name, this.#module);
+        if (owner) {
+            this.#issue(`namespace "${name}" is already claimed by module "${owner}"`);
+            return this;
+        }
+        setup(this.#manager.io.of(name));
+        return this;
+    }
+    #issue(message) {
+        this.#report.add({ scope: "boot", module: this.#module, message });
+    }
+}
+//# sourceMappingURL=socket-manager.js.map

package/dist/sockets/socket-manager.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@tulipes/core",
+  "version": "0.1.0",
+  "description": "Module-based Express framework: convention-driven boot pipeline, env contracts, ACL, queues, sockets and CLI",
+  "type": "module",
+  "bin": {
+    "tulipes": "./dist/cli/bin.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./env": "./dist/env/index.js",
+    "./modules": "./dist/modules/index.js",
+    "./boot": "./dist/boot/index.js",
+    "./acl": "./dist/acl/index.js",
+    "./db": "./dist/db/index.js",
+    "./queues": "./dist/queues/index.js",
+    "./sockets": "./dist/sockets/index.js",
+    "./http": "./dist/http/index.js",
+    "./config": "./dist/config/index.js",
+    "./errors": "./dist/errors/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -p tsconfig.json",
+    "prepack": "yarn build"
+  },
+  "publishConfig": {
+    "access": "public",
+    "bin": {
+      "tulipes": "./dist/cli/bin.js"
+    },
+    "exports": {
+      ".": "./dist/index.js",
+      "./env": "./dist/env/index.js",
+      "./modules": "./dist/modules/index.js",
+      "./boot": "./dist/boot/index.js",
+      "./acl": "./dist/acl/index.js",
+      "./db": "./dist/db/index.js",
+      "./queues": "./dist/queues/index.js",
+      "./sockets": "./dist/sockets/index.js",
+      "./http": "./dist/http/index.js",
+      "./config": "./dist/config/index.js",
+      "./errors": "./dist/errors/index.js"
+    }
+  },
+  "dependencies": {
+    "bullmq": "^5",
+    "colorette": "^2",
+    "dotenv": "^16.4.7",
+    "express": "^5",
+    "ioredis": "^5",
+    "mongoose": "^8",
+    "socket.io": "^4",
+    "tsx": "^4",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/express": "^5",
+    "@types/node": "^24.2.0",
+    "typescript": "^7.0.2"
+  }
+}