@agentuity/runtime 0.0.103 → 0.0.105

package/dist/router.d.ts

@@ -1,232 +1,64 @@
-import { type Context, Hono, type MiddlewareHandler, type Schema, type Env as HonoEnv } from 'hono';
+import { Hono, type Schema, type Env as HonoEnv } from 'hono';
 import type { Env } from './app';
-import { type Email } from './io/email';
 export type { Env };
 export type { HonoEnv };
-export interface WebSocketConnection {
-    onOpen: (handler: (event: any) => void | Promise<void>) => void;
-    onMessage: (handler: (event: any) => void | Promise<void>) => void;
-    onClose: (handler: (event: any) => void | Promise<void>) => void;
-    send: (data: string | ArrayBuffer | Uint8Array) => void;
-}
+export type { WebSocketConnection } from './handlers/websocket';
 declare module 'hono' {
     interface Hono {
         /**
-         * Register a route to handle incoming emails at a specific address.
-         *
-         * @param address - The email address to handle (e.g., 'support@example.com')
-         * @param handler - Handler function receiving parsed email and context
-         *
-         * @example
-         * ```typescript
-         * router.email('support@example.com', (email, c) => {
-         *   console.log('From:', email.fromEmail());
-         *   console.log('Subject:', email.subject());
-         *   console.log('Body:', email.text());
-         *   return c.text('Email received');
-         * });
-         * ```
-         */
-        email(address: string, handler: (email: Email, c: Context) => any): this;
-        /**
-         * Register a route to handle incoming emails with middleware.
-         *
-         * @param address - The email address to handle
-         * @param middleware - Middleware to run before the handler
-         * @param handler - Handler function receiving parsed email and context
-         *
-         * @example
-         * ```typescript
-         * router.email('support@example.com', authMiddleware, (email, c) => {
-         *   return c.json({ received: email.subject() });
-         * });
-         * ```
-         */
-        email(address: string, middleware: MiddlewareHandler, handler: (email: Email, c: Context) => any): this;
-        /**
-         * Register a route to handle incoming SMS messages to a phone number.
-         *
-         * @param params - Configuration object with phone number
-         * @param params.number - Phone number to handle (e.g., '+1234567890')
-         * @param handler - Handler function receiving context
-         *
-         * @example
-         * ```typescript
-         * router.sms({ number: '+1234567890' }, (c) => {
-         *   const message = c.req.query('message');
-         *   console.log('SMS received:', message);
-         *   return c.text('SMS received');
-         * });
-         * ```
-         */
-        sms(params: {
-            number: string;
-        }, handler: (c: Context) => any): this;
-        /**
-         * Schedule a handler to run at specific intervals using cron syntax.
-         *
-         * @param schedule - Cron expression (e.g., '0 0 * * *' for daily at midnight)
-         * @param handler - Handler function to run on schedule
-         *
-         * @example
-         * ```typescript
-         * // Run daily at midnight
-         * router.cron('0 0 * * *', (c) => {
-         *   console.log('Daily cleanup running');
-         *   return c.text('Cleanup complete');
-         * });
-         *
-         * // Run every hour
-         * router.cron('0 * * * *', (c) => {
-         *   console.log('Hourly health check');
-         *   return c.text('OK');
-         * });
-         * ```
-         */
-        cron(schedule: string, handler: (c: Context) => any): this;
-        /**
-         * Create a streaming route that returns a ReadableStream.
-         *
-         * @param path - The route path
-         * @param handler - Handler returning a ReadableStream
-         *
-         * @example
-         * ```typescript
-         * router.stream('/events', (c) => {
-         *   return new ReadableStream({
-         *     start(controller) {
-         *       controller.enqueue('event 1\n');
-         *       controller.enqueue('event 2\n');
-         *       controller.close();
-         *     }
-         *   });
-         * });
-         * ```
-         */
-        stream(path: string, handler: (c: Context) => ReadableStream<any> | Promise<ReadableStream<any>>): this;
-        /**
-         * Create a streaming route with middleware.
-         *
-         * @param path - The route path
-         * @param middleware - Middleware to run before streaming
-         * @param handler - Handler returning a ReadableStream
-         *
-         * @example
-         * ```typescript
-         * router.stream('/protected-stream', authMiddleware, (c) => {
-         *   return new ReadableStream({
-         *     start(controller) {
-         *       controller.enqueue('secure data\n');
-         *       controller.close();
-         *     }
-         *   });
-         * });
-         * ```
-         */
-        stream(path: string, middleware: MiddlewareHandler, handler: (c: Context) => ReadableStream<any> | Promise<ReadableStream<any>>): this;
-        /**
-         * Create a WebSocket route for real-time bidirectional communication.
-         *
-         * @param path - The route path
-         * @param handler - Setup function that registers WebSocket event handlers
-         *
-         * @example
+         * @deprecated Use the `websocket` middleware instead:
          * ```typescript
-         * router.websocket('/ws', (c) => (ws) => {
-         *   ws.onOpen((event) => {
-         *     console.log('WebSocket opened');
-         *     ws.send('Welcome!');
-         *   });
-         *
-         *   ws.onMessage((event) => {
-         *     console.log('Received:', event.data);
-         *     ws.send('Echo: ' + event.data);
-         *   });
-         *
-         *   ws.onClose((event) => {
-         *     console.log('WebSocket closed');
-         *   });
-         * });
+         * import { websocket } from '@agentuity/runtime';
+         * router.get('/ws', websocket((c, ws) => { ... }));
          * ```
          */
-        websocket(path: string, handler: (c: Context) => (ws: WebSocketConnection) => void): this;
+        websocket(path: string, ...args: any[]): this;
         /**
-         * Create a WebSocket route with middleware.
-         *
-         * @param path - The route path
-         * @param middleware - Middleware to run before WebSocket upgrade
-         * @param handler - Setup function that registers WebSocket event handlers
-         *
-         * @example
+         * @deprecated Use the `sse` middleware instead:
          * ```typescript
-         * router.websocket('/ws', authMiddleware, (c) => (ws) => {
-         *   ws.onMessage((event) => {
-         *     ws.send('Authenticated echo: ' + event.data);
-         *   });
-         * });
+         * import { sse } from '@agentuity/runtime';
+         * router.get('/events', sse((c, stream) => { ... }));
          * ```
          */
-        websocket(path: string, middleware: MiddlewareHandler, handler: (c: Context) => (ws: WebSocketConnection) => void): this;
+        sse(path: string, ...args: any[]): this;
         /**
-         * Create a Server-Sent Events (SSE) route for streaming updates to clients.
-         *
-         * @param path - The route path
-         * @param handler - Handler receiving SSE stream writer
-         *
-         * @example
+         * @deprecated Use the `stream` middleware instead:
          * ```typescript
-         * router.sse('/notifications', (c) => async (stream) => {
-         *   let count = 0;
-         *   const interval = setInterval(() => {
-         *     stream.writeSSE({
-         *       data: `Notification ${++count}`,
-         *       event: 'notification'
-         *     });
-         *     if (count >= 10) {
-         *       clearInterval(interval);
-         *       stream.close();
-         *     }
-         *   }, 1000);
-         * });
+         * import { stream } from '@agentuity/runtime';
+         * router.post('/data', stream((c) => new ReadableStream({ ... })));
          * ```
          */
-        sse(path: string, handler: (c: Context) => (stream: any) => void): this;
+        stream(path: string, ...args: any[]): this;
         /**
-         * Create an SSE route with middleware.
-         *
-         * @param path - The route path
-         * @param middleware - Middleware to run before SSE streaming
-         * @param handler - Handler receiving SSE stream writer
-         *
-         * @example
+         * @deprecated Use the `cron` middleware instead:
          * ```typescript
-         * router.sse('/protected-events', authMiddleware, (c) => async (stream) => {
-         *   stream.writeSSE({ data: 'Secure event', event: 'update' });
-         *   stream.close();
-         * });
+         * import { cron } from '@agentuity/runtime';
+         * router.post('/job', cron('0 0 * * *', (c) => { ... }));
          * ```
          */
-        sse(path: string, middleware: MiddlewareHandler, handler: (c: Context) => (stream: any) => void): this;
+        cron(schedule: string, ...args: any[]): this;
     }
 }
 /**
  * Creates a Hono router with extended methods for Agentuity-specific routing patterns.
  *
- * In addition to standard HTTP methods (get, post, put, delete, patch), the router includes:
- * - **stream()** - Stream responses with ReadableStream
- * - **websocket()** - WebSocket connections
- * - **sse()** - Server-Sent Events
- * - **email()** - Email handler routing
- * - **sms()** - SMS handler routing
- * - **cron()** - Scheduled task routing
+ * Standard HTTP methods (get, post, put, delete, patch) are available, plus middleware
+ * functions for specialized protocols:
+ *
+ * - **websocket()** - WebSocket connections (import { websocket } from '@agentuity/runtime')
+ * - **sse()** - Server-Sent Events (import { sse } from '@agentuity/runtime')
+ * - **stream()** - Streaming responses (import { stream } from '@agentuity/runtime')
+ * - **cron()** - Scheduled tasks (import { cron } from '@agentuity/runtime')
  *
  * @template E - Environment type (Hono Env)
  * @template S - Schema type for route definitions
  *
- * @returns Extended Hono router with custom methods
+ * @returns Extended Hono router
  *
  * @example
  * ```typescript
+ * import { createRouter, websocket, sse, stream, cron } from '@agentuity/runtime';
+ *
  * const router = createRouter();
  *
  * // Standard HTTP routes
@@ -236,54 +68,32 @@ declare module 'hono' {
  *   return c.json({ received: body });
  * });
  *
- * // Streaming response
- * router.stream('/events', (c) => {
- *   return new ReadableStream({
- *     start(controller) {
- *       controller.enqueue('event 1\n');
- *       controller.enqueue('event 2\n');
- *       controller.close();
- *     }
- *   });
- * });
- *
  * // WebSocket connection
- * router.websocket('/ws', (c) => (ws) => {
+ * router.get('/ws', websocket((c, ws) => {
  *   ws.onMessage((event) => {
- *     console.log('Received:', event.data);
  *     ws.send('Echo: ' + event.data);
  *   });
- * });
+ * }));
  *
  * // Server-Sent Events
- * router.sse('/notifications', (c) => async (stream) => {
- *   let count = 0;
- *   const interval = setInterval(() => {
- *     stream.writeSSE({ data: `Message ${++count}` });
- *     if (count >= 10) {
- *       clearInterval(interval);
- *       stream.close();
- *     }
- *   }, 1000);
- * });
- *
- * // Email routing
- * router.email('support@example.com', (email, c) => {
- *   console.log('From:', email.fromEmail());
- *   console.log('Subject:', email.subject());
- *   return c.text('Email received');
- * });
+ * router.get('/events', sse((c, stream) => {
+ *   stream.writeSSE({ data: 'Hello', event: 'message' });
+ * }));
  *
- * // SMS routing
- * router.sms({ number: '+1234567890' }, (c) => {
- *   return c.text('SMS received');
- * });
+ * // Streaming response
+ * router.post('/stream', stream((c) => {
+ *   return new ReadableStream({
+ *     start(controller) {
+ *       controller.enqueue('data\n');
+ *       controller.close();
+ *     }
+ *   });
+ * }));
  *
- * // Scheduled cron
- * router.cron('0 0 * * *', (c) => {
- *   console.log('Daily task running');
- *   return c.text('OK');
- * });
+ * // Cron job
+ * router.post('/daily', cron('0 0 * * *', (c) => {
+ *   return { status: 'complete' };
+ * }));
  * ```
  */
 export declare const createRouter: <E extends Env = Env, S extends Schema = Schema>() => Hono<E, S>;

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,GAAG,IAAI,OAAO,EAAE,MAAM,MAAM,CAAC;AAE5E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGjC,YAAY,EAAE,GAAG,EAAE,CAAC;AACpB,YAAY,EAAE,OAAO,EAAE,CAAC;AAGxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIhE,OAAO,QAAQ,MAAM,CAAC;IACrB,UAAU,IAAI;QACb;;;;;;WAMG;QACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAE9C;;;;;;WAMG;QACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAExC;;;;;;WAMG;QACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAE3C;;;;;;WAMG;QACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;KAC7C;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,OAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAwHxF,CAAC"}