raffel 0.1.2

package/dist/server/fs-routes/index.js

@@ -0,0 +1,66 @@
+/**
+ * File-System Discovery
+ *
+ * Next.js-style auto-discovery of handlers for Raffel.
+ *
+ * @example
+ * ```typescript
+ * import { createServer } from 'raffel'
+ *
+ * const server = createServer({
+ *   port: 3000,
+ *   discovery: {
+ *     http: './src/http',
+ *     channels: './src/channels',
+ *     rpc: './src/rpc',
+ *     streams: './src/streams',
+ *     rest: './src/rest',       // Auto-CRUD from schema
+ *     resources: './src/resources', // 1 file = 1 resource
+ *     tcp: './src/tcp',         // Custom TCP handlers
+ *     udp: './src/udp',         // Custom UDP handlers
+ *   },
+ * })
+ *
+ * await server.start()
+ * ```
+ *
+ * Directory Structure:
+ * ```
+ * src/
+ * ├── http/                    # Individual handlers (max control)
+ * │   ├── _middleware.ts
+ * │   ├── _auth.ts
+ * │   └── users/
+ * │       ├── get.ts
+ * │       └── [id]/
+ * │           └── update.ts
+ * ├── rest/                    # Auto-CRUD (min boilerplate)
+ * │   └── users.ts             # → GET/POST/PUT/PATCH/DELETE /users
+ * ├── resources/               # Explicit handlers (balance)
+ * │   └── products.ts          # → All CRUD with custom logic
+ * ├── channels/                # WebSocket pub/sub
+ * │   ├── chat-room.ts
+ * │   └── presence-lobby.ts
+ * ├── streams/                 # Streaming handlers
+ * │   └── logs/tail.ts
+ * ├── tcp/                     # Custom TCP servers
+ * │   └── game-server.ts
+ * └── udp/                     # Custom UDP servers
+ *     └── metrics-collector.ts
+ * ```
+ */
+// === Loader ===
+export { loadDiscovery, clearModuleCache } from './loader.js';
+// === Watcher ===
+export { createDiscoveryWatcher, isDevelopment } from './watcher.js';
+// === Middleware Processor ===
+export { createRouteInterceptors, createChannelAuthorizer } from './middleware-processor.js';
+// === REST Auto-CRUD ===
+export { loadRestResources, } from './rest/index.js';
+// === Resource Handlers ===
+export { loadResources, generateResourceRoutes, } from './resources/index.js';
+// === TCP Custom Handlers ===
+export { loadTcpHandlers, createTcpServer, } from './tcp/index.js';
+// === UDP Custom Handlers ===
+export { loadUdpHandlers, createUdpServer, } from './udp/index.js';
+//# sourceMappingURL=index.js.map

package/dist/server/fs-routes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/fs-routes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG7D,kBAAkB;AAClB,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGpE,+BAA+B;AAC/B,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAyC5F,yBAAyB;AACzB,OAAO,EACL,iBAAiB,GAClB,MAAM,iBAAiB,CAAA;AAoBxB,4BAA4B;AAC5B,OAAO,EACL,aAAa,EACb,sBAAsB,GACvB,MAAM,sBAAsB,CAAA;AA0B7B,8BAA8B;AAC9B,OAAO,EACL,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAqBvB,8BAA8B;AAC9B,OAAO,EACL,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAA"}

package/dist/server/fs-routes/loader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * File-System Discovery Loader
+ *
+ * Auto-discovers and loads handlers from the file system.
+ */
+import type { LoadedRestResource } from './rest/types.js';
+import type { LoadedResource } from './resources/types.js';
+import type { LoadedTcpHandler } from './tcp/types.js';
+import type { LoadedUdpHandler } from './udp/types.js';
+import type { DiscoveryLoaderOptions, DiscoveryStats, LoadedRoute, LoadedChannel } from './types.js';
+/**
+ * Discover and load handlers from file system
+ */
+export declare function loadDiscovery(options: DiscoveryLoaderOptions): Promise<DiscoveryResult>;
+export interface DiscoveryResult {
+    routes: LoadedRoute[];
+    channels: LoadedChannel[];
+    restResources: LoadedRestResource[];
+    resources: LoadedResource[];
+    tcpHandlers: LoadedTcpHandler[];
+    udpHandlers: LoadedUdpHandler[];
+    stats: DiscoveryStats;
+}
+/**
+ * Clear module cache for hot reload
+ */
+export declare function clearModuleCache(filePath: string): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/server/fs-routes/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/server/fs-routes/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAEV,sBAAsB,EACtB,cAAc,EACd,WAAW,EACX,aAAa,EAWd,MAAM,YAAY,CAAA;AA8GnB;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgI7F;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,aAAa,EAAE,kBAAkB,EAAE,CAAA;IACnC,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,KAAK,EAAE,cAAc,CAAA;CACtB;AAkbD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIvD"}

package/dist/server/fs-routes/loader.int.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * File-System Discovery Loader Tests
+ */
+export {};
+//# sourceMappingURL=loader.int.test.d.ts.map

package/dist/server/fs-routes/loader.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.int.test.d.ts","sourceRoot":"","sources":["../../../src/server/fs-routes/loader.int.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/server/fs-routes/loader.int.test.js

@@ -0,0 +1,48 @@
+/**
+ * File-System Discovery Loader Tests
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+import { mkdtemp, writeFile, rm, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { loadDiscovery } from './loader.js';
+async function createTempDir() {
+    return mkdtemp(path.join(os.tmpdir(), 'raffel-discovery-'));
+}
+async function writeFixture(root, relativePath, content) {
+    const filePath = path.join(root, relativePath);
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, content, 'utf-8');
+}
+describe('loadDiscovery middleware filtering', () => {
+    let tempDir = null;
+    afterEach(async () => {
+        if (tempDir) {
+            await rm(tempDir, { recursive: true, force: true });
+            tempDir = null;
+        }
+    });
+    it('should apply matcher and exclude patterns to route names', async () => {
+        tempDir = await createTempDir();
+        await writeFixture(tempDir, 'src/http/_middleware.js', `export const config = { matcher: ['users/*'], exclude: ['users/internal/*'] }
+export default async function middleware(ctx, next) { return next() }
+`);
+        await writeFixture(tempDir, 'src/http/users/get.js', 'export default async function handler() { return { ok: true } }');
+        await writeFixture(tempDir, 'src/http/users/internal/stats.js', 'export default async function handler() { return { ok: true } }');
+        await writeFixture(tempDir, 'src/http/admin/get.js', 'export default async function handler() { return { ok: true } }');
+        const result = await loadDiscovery({
+            baseDir: tempDir,
+            discovery: { http: true },
+        });
+        const usersGet = result.routes.find((route) => route.name === 'users/get');
+        const usersInternal = result.routes.find((route) => route.name === 'users/internal/stats');
+        const adminGet = result.routes.find((route) => route.name === 'admin/get');
+        expect(usersGet).toBeDefined();
+        expect(usersInternal).toBeDefined();
+        expect(adminGet).toBeDefined();
+        expect(usersGet?.middlewares.length).toBe(1);
+        expect(usersInternal?.middlewares.length).toBe(0);
+        expect(adminGet?.middlewares.length).toBe(0);
+    });
+});
+//# sourceMappingURL=loader.int.test.js.map

package/dist/server/fs-routes/loader.int.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.int.test.js","sourceRoot":"","sources":["../../../src/server/fs-routes/loader.int.test.ts"],"names":[],"mappings":"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"}