devflare 1.0.0-next.1 → 1.0.0-next.10

package/dist/router/types.d.ts

@@ -0,0 +1,24 @@
+export type RouteSegment = {
+    readonly type: 'static';
+    readonly value: string;
+} | {
+    readonly type: 'param';
+    readonly name: string;
+} | {
+    readonly type: 'rest';
+    readonly name: string;
+} | {
+    readonly type: 'optional-rest';
+    readonly name: string;
+};
+export interface RouteModuleDefinition {
+    readonly filePath: string;
+    readonly routePath: string;
+    readonly segments: readonly RouteSegment[];
+    readonly module: Record<string, unknown>;
+}
+export interface RouteMatchResult {
+    readonly route: RouteModuleDefinition;
+    readonly params: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GACrB;IACD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB,GACC;IACD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACrB,GACC;IACD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACrB,GACC;IACD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACrB,CAAA;AAEF,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC"}

package/dist/runtime/context.d.ts

@@ -1,15 +1,195 @@
+/**
+ * All event surfaces that Devflare exposes through AsyncLocalStorage.
+ */
+export type RuntimeEventType = 'fetch' | 'scheduled' | 'queue' | 'email' | 'tail' | 'durable-object-fetch' | 'durable-object-alarm' | 'durable-object-websocket-message' | 'durable-object-websocket-close' | 'durable-object-websocket-error';
+/**
+ * Shared base shape for all Devflare event objects.
+ */
+export interface EventContext<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> {
+    readonly type: RuntimeEventType;
+    readonly env: TEnv;
+    readonly ctx: RuntimeContextValue;
+    readonly locals: TLocals;
+    readonly request?: Request | null;
+    readonly params?: Record<string, string>;
+}
+/**
+ * Execution context shape exposed through `ctx`.
+ *
+ * Fetch/queue/scheduled/email/tail handlers receive the standard Cloudflare
+ * `ExecutionContext`. Durable Object handlers receive `DurableObjectState`.
+ */
+export type RuntimeContextValue = ExecutionContext | DurableObjectState | null;
+/**
+ * Event-first fetch handler input.
+ *
+ * This intentionally behaves like both:
+ * - a real `Request`
+ * - an object with `{ request, env, ctx, params, locals }`
+ *
+ * That means old `fetch(request, env, ctx)` handlers keep working while new
+ * `fetch(event)` / `GET({ request, params })` handlers can destructure the
+ * richer event object.
+ */
+export interface FetchEvent<TEnv = unknown, TParams extends Record<string, string> = Record<string, string>, TLocals extends Record<string, unknown> = Record<string, unknown>> extends Request, EventContext<TEnv, TLocals> {
+    readonly type: 'fetch';
+    readonly request: Request;
+    readonly ctx: ExecutionContext;
+    readonly params: TParams;
+}
+/**
+ * Event-first queue handler input.
+ */
+export interface QueueEvent<TMessage = unknown, TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends MessageBatch<TMessage>, EventContext<TEnv, TLocals> {
+    readonly type: 'queue';
+    readonly batch: MessageBatch<TMessage>;
+    readonly ctx: ExecutionContext;
+}
+/**
+ * Event-first scheduled handler input.
+ */
+export interface ScheduledEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends ScheduledController, EventContext<TEnv, TLocals> {
+    readonly type: 'scheduled';
+    readonly controller: ScheduledController;
+    readonly ctx: ExecutionContext;
+}
+/**
+ * Event-first email handler input.
+ */
+export interface EmailEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends ForwardableEmailMessage, EventContext<TEnv, TLocals> {
+    readonly type: 'email';
+    readonly message: ForwardableEmailMessage;
+    readonly ctx: ExecutionContext;
+}
+/**
+ * Event-first tail handler input.
+ */
+export interface TailEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends Array<TraceItem>, EventContext<TEnv, TLocals> {
+    readonly type: 'tail';
+    readonly events: TraceItem[];
+    readonly ctx: ExecutionContext;
+}
+/**
+ * Shared base shape for Durable Object events.
+ */
+export interface DurableObjectEventContext<TType extends Extract<RuntimeEventType, `durable-object-${string}`>, TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends EventContext<TEnv, TLocals> {
+    readonly type: TType;
+    readonly ctx: DurableObjectState;
+    readonly state: DurableObjectState;
+}
+/**
+ * Event-first Durable Object fetch handler input.
+ */
+export interface DurableObjectFetchEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends Request, DurableObjectEventContext<'durable-object-fetch', TEnv, TLocals> {
+    readonly request: Request;
+}
+/**
+ * Event-first Durable Object alarm handler input.
+ */
+export interface DurableObjectAlarmEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends DurableObjectEventContext<'durable-object-alarm', TEnv, TLocals> {
+}
+/**
+ * Event-first Durable Object websocket message handler input.
+ */
+export interface DurableObjectWebSocketMessageEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends WebSocket, DurableObjectEventContext<'durable-object-websocket-message', TEnv, TLocals> {
+    readonly ws: WebSocket;
+    readonly message: string | ArrayBuffer;
+}
+/**
+ * Event-first Durable Object websocket close handler input.
+ */
+export interface DurableObjectWebSocketCloseEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends WebSocket, DurableObjectEventContext<'durable-object-websocket-close', TEnv, TLocals> {
+    readonly ws: WebSocket;
+    readonly code: number;
+    readonly reason: string;
+    readonly wasClean: boolean;
+}
+/**
+ * Event-first Durable Object websocket error handler input.
+ */
+export interface DurableObjectWebSocketErrorEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> extends WebSocket, DurableObjectEventContext<'durable-object-websocket-error', TEnv, TLocals> {
+    readonly ws: WebSocket;
+    readonly error: unknown;
+}
+/**
+ * Union of all Durable Object event surfaces.
+ */
+export type DurableObjectEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> = DurableObjectFetchEvent<TEnv, TLocals> | DurableObjectAlarmEvent<TEnv, TLocals> | DurableObjectWebSocketMessageEvent<TEnv, TLocals> | DurableObjectWebSocketCloseEvent<TEnv, TLocals> | DurableObjectWebSocketErrorEvent<TEnv, TLocals>;
+/**
+ * Union of all non-DO worker surfaces.
+ */
+export type WorkerEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> = FetchEvent<TEnv, Record<string, string>, TLocals> | QueueEvent<unknown, TEnv, TLocals> | ScheduledEvent<TEnv, TLocals> | EmailEvent<TEnv, TLocals> | TailEvent<TEnv, TLocals>;
+/**
+ * Union of all concrete Devflare event objects.
+ */
+export type AnyEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> = WorkerEvent<TEnv, TLocals> | DurableObjectEvent<TEnv, TLocals>;
 /**
  * Context shape stored in AsyncLocalStorage
  */
-export interface RequestContext<TEnv = unknown, TLocals = Record<string, unknown>> {
+export interface RequestContext<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>> {
     env: TEnv;
-    ctx: ExecutionContext | null;
+    ctx: RuntimeContextValue;
     request: Request | null;
     locals: TLocals;
-    type: 'fetch' | 'scheduled' | 'queue' | 'email' | 'tail';
+    type: RuntimeEventType;
+    event: EventContext<TEnv, TLocals>;
+}
+type EventAccessor<TEvent> = (() => TEvent) & {
+    safe: () => TEvent | null;
+};
+interface EventInitOptions<TLocals extends Record<string, unknown> = Record<string, unknown>> {
+    locals?: TLocals;
+}
+interface FetchEventInit<TParams extends Record<string, string> = Record<string, string>, TLocals extends Record<string, unknown> = Record<string, unknown>> extends EventInitOptions<TLocals> {
+    params?: TParams;
 }
 /**
- * Run a function with context established
+ * Create a Devflare fetch event object.
+ */
+export declare function createFetchEvent<TEnv = unknown, TParams extends Record<string, string> = Record<string, string>, TLocals extends Record<string, unknown> = Record<string, unknown>>(request: Request, env: TEnv, ctx: ExecutionContext, options?: FetchEventInit<TParams, TLocals>): FetchEvent<TEnv, TParams, TLocals>;
+/**
+ * Create a Devflare queue event object.
+ */
+export declare function createQueueEvent<TMessage = unknown, TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(batch: MessageBatch<TMessage>, env: TEnv, ctx: ExecutionContext, options?: EventInitOptions<TLocals>): QueueEvent<TMessage, TEnv, TLocals>;
+/**
+ * Create a Devflare scheduled event object.
+ */
+export declare function createScheduledEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(controller: ScheduledController, env: TEnv, ctx: ExecutionContext, options?: EventInitOptions<TLocals>): ScheduledEvent<TEnv, TLocals>;
+/**
+ * Create a Devflare email event object.
+ */
+export declare function createEmailEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(message: ForwardableEmailMessage, env: TEnv, ctx: ExecutionContext, options?: EventInitOptions<TLocals>): EmailEvent<TEnv, TLocals>;
+/**
+ * Create a Devflare tail event object.
+ */
+export declare function createTailEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(events: TraceItem[], env: TEnv, ctx: ExecutionContext, options?: EventInitOptions<TLocals>): TailEvent<TEnv, TLocals>;
+/**
+ * Create a Devflare Durable Object fetch event object.
+ */
+export declare function createDurableObjectFetchEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(request: Request, env: TEnv, state: DurableObjectState, options?: EventInitOptions<TLocals>): DurableObjectFetchEvent<TEnv, TLocals>;
+/**
+ * Create a Devflare Durable Object alarm event object.
+ */
+export declare function createDurableObjectAlarmEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(env: TEnv, state: DurableObjectState, options?: EventInitOptions<TLocals>): DurableObjectAlarmEvent<TEnv, TLocals>;
+/**
+ * Create a Devflare Durable Object websocket message event object.
+ */
+export declare function createDurableObjectWebSocketMessageEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(ws: WebSocket, message: string | ArrayBuffer, env: TEnv, state: DurableObjectState, options?: EventInitOptions<TLocals>): DurableObjectWebSocketMessageEvent<TEnv, TLocals>;
+/**
+ * Create a Devflare Durable Object websocket close event object.
+ */
+export declare function createDurableObjectWebSocketCloseEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(ws: WebSocket, code: number, reason: string, wasClean: boolean, env: TEnv, state: DurableObjectState, options?: EventInitOptions<TLocals>): DurableObjectWebSocketCloseEvent<TEnv, TLocals>;
+/**
+ * Create a Devflare Durable Object websocket error event object.
+ */
+export declare function createDurableObjectWebSocketErrorEvent<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(ws: WebSocket, error: unknown, env: TEnv, state: DurableObjectState, options?: EventInitOptions<TLocals>): DurableObjectWebSocketErrorEvent<TEnv, TLocals>;
+/**
+ * Advanced: run a function with a compatibility context established.
+ *
+ * Normal Devflare application code should not need this directly.
+ * Generated worker wrappers, dev-server dispatch, router/middleware resolution,
+ * and `createTestContext()` helpers already establish context before invoking
+ * user handlers.
  *
  * @param env - Worker environment bindings
  * @param ctx - Execution context (null for DO methods)
@@ -18,29 +198,90 @@ export interface RequestContext<TEnv = unknown, TLocals = Record<string, unknown
  * @param type - Handler type
  * @returns Result of function
  */
-export declare function runWithContext<T, TEnv = unknown>(env: TEnv, ctx: ExecutionContext | null, request: Request | null, fn: () => T, type?: RequestContext['type']): T;
+export declare function runWithContext<T, TEnv = unknown>(env: TEnv, ctx: RuntimeContextValue, request: Request | null, fn: () => T, type?: RequestContext['type']): T;
+/**
+ * Advanced: run a function with a fully constructed event object established.
+ *
+ * Normal Devflare application code should not need this directly.
+ * Devflare uses it internally so getters like `getQueueEvent()` and
+ * `getEmailEvent()` work automatically inside user handlers.
+ */
+export declare function runWithEventContext<T, TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(event: EventContext<TEnv, TLocals>, fn: () => T): T;
 /**
  * Get the current context
  *
  * @throws {ContextUnavailableError} When called outside of a request context
  * @returns Current context
  */
-export declare function getContext<TEnv = unknown, TLocals = Record<string, unknown>>(): RequestContext<TEnv, TLocals>;
+export declare function getContext<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(): RequestContext<TEnv, TLocals>;
 /**
  * Get the current context, or null if not available
  *
  * @returns Current context or null
  */
-export declare function getContextOrNull<TEnv = unknown, TLocals = Record<string, unknown>>(): RequestContext<TEnv, TLocals> | null;
+export declare function getContextOrNull<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(): RequestContext<TEnv, TLocals> | null;
+/**
+ * Get the current event object.
+ */
+export declare function getEventContext<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(): EventContext<TEnv, TLocals>;
+/**
+ * Get the current event object, or null if not available.
+ */
+export declare function getEventContextOrNull<TEnv = unknown, TLocals extends Record<string, unknown> = Record<string, unknown>>(): EventContext<TEnv, TLocals> | null;
 /**
  * Check if currently running within a context
  */
 export declare function hasContext(): boolean;
+/**
+ * Get the current fetch event.
+ */
+export declare const getFetchEvent: EventAccessor<FetchEvent<unknown, Record<string, string>, Record<string, unknown>>>;
+/**
+ * Get the current queue event.
+ */
+export declare const getQueueEvent: EventAccessor<QueueEvent<unknown, unknown, Record<string, unknown>>>;
+/**
+ * Get the current scheduled event.
+ */
+export declare const getScheduledEvent: EventAccessor<ScheduledEvent<unknown, Record<string, unknown>>>;
+/**
+ * Get the current email event.
+ */
+export declare const getEmailEvent: EventAccessor<EmailEvent<unknown, Record<string, unknown>>>;
+/**
+ * Get the current tail event.
+ */
+export declare const getTailEvent: EventAccessor<TailEvent<unknown, Record<string, unknown>>>;
+/**
+ * Get the current Durable Object event, regardless of surface.
+ */
+export declare const getDurableObjectEvent: EventAccessor<DurableObjectEvent<unknown, Record<string, unknown>>>;
+/**
+ * Get the current Durable Object fetch event.
+ */
+export declare const getDurableObjectFetchEvent: EventAccessor<DurableObjectFetchEvent<unknown, Record<string, unknown>>>;
+/**
+ * Get the current Durable Object alarm event.
+ */
+export declare const getDurableObjectAlarmEvent: EventAccessor<DurableObjectAlarmEvent<unknown, Record<string, unknown>>>;
+/**
+ * Get the current Durable Object websocket message event.
+ */
+export declare const getDurableObjectWebSocketMessageEvent: EventAccessor<DurableObjectWebSocketMessageEvent<unknown, Record<string, unknown>>>;
+/**
+ * Get the current Durable Object websocket close event.
+ */
+export declare const getDurableObjectWebSocketCloseEvent: EventAccessor<DurableObjectWebSocketCloseEvent<unknown, Record<string, unknown>>>;
+/**
+ * Get the current Durable Object websocket error event.
+ */
+export declare const getDurableObjectWebSocketErrorEvent: EventAccessor<DurableObjectWebSocketErrorEvent<unknown, Record<string, unknown>>>;
 /**
  * Error thrown when context is accessed outside of a request handler
  */
 export declare class ContextUnavailableError extends Error {
     readonly code = "CONTEXT_UNAVAILABLE";
-    constructor();
+    constructor(message?: string);
 }
+export {};
 //# sourceMappingURL=context.d.ts.map

package/dist/runtime/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChF,GAAG,EAAE,IAAI,CAAA;IACT,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC5B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;CACxD;AAOD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,GAAG,OAAO,EAC/C,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,gBAAgB,GAAG,IAAI,EAC5B,OAAO,EAAE,OAAO,GAAG,IAAI,EACvB,EAAE,EAAE,MAAM,CAAC,EACX,IAAI,GAAE,cAAc,CAAC,MAAM,CAAW,GACpC,CAAC,CAUH;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAM7G;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,CAG1H;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,yBAAwB;IAErC,cAUC;CACD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"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"}

package/dist/runtime/exports.d.ts

@@ -1,87 +1,83 @@
+import { type EventContext, type RuntimeContextValue } from './context';
+declare global {
+    interface DevflareEnv {
+    }
+}
 /**
  * Access environment bindings (KV, D1, R2, etc.) and variables
  *
  * @remarks
  * This is readonly - bindings cannot be reassigned at runtime.
- * Available only within request handlers or middleware.
+ * Available only within an active Devflare-managed handler or middleware call trail.
  *
  * @example
  * ```ts
- * import { env } from 'devflare/runtime'
- *
- * export default {
- *   async fetch(request) {
- *     const value = await env.MY_KV.get('key')
- *     const dbResult = await env.DB.prepare('SELECT * FROM users').all()
- *     return new Response(JSON.stringify({ value, dbResult }))
- *   }
+     * import { env, type FetchEvent } from 'devflare/runtime'
+ *
+     * export async function fetch(event: FetchEvent) {
+ *   const value = await env.MY_KV.get('key')
+ *   const dbResult = await env.DB.prepare('SELECT * FROM users').all()
+     *   return new Response(JSON.stringify({
+     *     path: new URL(event.request.url).pathname,
+     *     value,
+     *     dbResult
+     *   }))
  * }
  * ```
  *
- * @throws {ContextAccessError} When accessed outside request handler
+ * @throws {ContextAccessError} When accessed outside an active Devflare-managed handler trail
  */
-export declare const env: Readonly<Record<string, unknown>>;
+export declare const env: Readonly<DevflareEnv>;
 /**
  * Access the ExecutionContext for background tasks
  *
  * @remarks
  * Provides `waitUntil()` for background processing and
- * `passThroughOnException()` for error handling.
+ * `passThroughOnException()` for error handling on worker surfaces.
+ * When running inside a Durable Object, this proxy exposes the current
+ * `DurableObjectState` instead.
  * This is readonly.
  *
  * @example
  * ```ts
- * import { ctx } from 'devflare/runtime'
- *
- * export default {
- *   async fetch(request) {
- *     // Process request quickly
- *     const response = new Response('OK')
+     * import { ctx, type FetchEvent } from 'devflare/runtime'
  *
- *     // Queue background work
- *     ctx.waitUntil(analytics.track('request-processed'))
- *
- *     return response
- *   }
+     * export async function fetch(event: FetchEvent) {
+ *   const response = new Response('OK')
+     *   ctx.waitUntil(analytics.track(new URL(event.request.url).pathname))
+ *   return response
  * }
  * ```
  *
- * @throws {ContextAccessError} When accessed outside request handler
- */
-export declare const ctx: Readonly<ExecutionContext>;
-/**
- * Event context shape - provides access to request and context type
+ * @throws {ContextAccessError} When accessed outside an active Devflare-managed handler trail
  */
-export interface EventContext {
-    /** The incoming Request object */
-    request: Request | null;
-    /** Type of event trigger */
-    type: 'fetch' | 'scheduled' | 'queue' | 'email' | 'tail';
-}
+export declare const ctx: Readonly<RuntimeContextValue>;
 /**
- * Access event-level context (request, event type)
+ * Access the current event object.
  *
  * @remarks
- * Provides access to the current Request and the type of event
- * that triggered this handler.
+ * This is the generic event proxy for the active AsyncLocalStorage context.
+ *
+ * For strong per-surface typing, prefer `getFetchEvent()`, `getQueueEvent()`,
+ * `getScheduledEvent()`, `getEmailEvent()`, and the Durable Object getters
+ * from `devflare/runtime`.
  *
  * @example
  * ```ts
- * import { event } from 'devflare/runtime'
+     * import { event as runtimeEvent, type FetchEvent, type ScheduledEvent } from 'devflare/runtime'
  *
- * export default {
- *   async fetch(request) {
- *     console.log(event.type)       // 'fetch'
- *     console.log(event.request.url) // Request URL
- *   },
+     * export async function fetch(event: FetchEvent) {
+     *   console.log(runtimeEvent.type)
+     *   console.log(event.request.url)
+ * }
  *
- *   async scheduled(controller, env, ctx) {
- *     console.log(event.type) // 'scheduled'
- *   }
+     * export async function scheduled(event: ScheduledEvent) {
+     *   console.log(runtimeEvent.type)
+     *   console.log(event.cron)
  * }
  * ```
  *
- * @throws {ContextAccessError} When accessed outside request handler
+ * @throws {ContextAccessError} When accessed outside an active Devflare-managed handler trail
  */
 export declare const event: Readonly<EventContext>;
 /**
@@ -96,23 +92,22 @@ export declare const event: Readonly<EventContext>;
  *
  * @example
  * ```ts
- * import { locals } from 'devflare/runtime'
+     * import { locals, type FetchEvent } from 'devflare/runtime'
  *
  * // In auth middleware
- * const authMiddleware = async (next) => {
- *   locals.user = await validateToken(request.headers.get('Authorization'))
+     * const authMiddleware = async (event: FetchEvent, next: () => Promise<Response>) => {
+ *   locals.user = await validateToken(event.request?.headers.get('Authorization'))
  *   return next()
  * }
  *
  * // In handler
- * export default {
- *   async fetch(request) {
- *     console.log(locals.user) // Access authenticated user
- *   }
+     * export async function fetch(event: FetchEvent) {
+     *   void event
+ *   console.log(locals.user)
  * }
  * ```
  *
- * @throws {ContextAccessError} When accessed outside request handler
+ * @throws {ContextAccessError} When accessed outside an active Devflare-managed handler trail
  */
 export declare const locals: Record<string, unknown>;
 //# sourceMappingURL=exports.d.ts.map

package/dist/runtime/exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/runtime/exports.ts"],"names":[],"mappings":"AA8EA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGjD,CAAA;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAG1C,CAAA;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,kCAAkC;IAClC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,4BAA4B;IAC5B,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC,YAAY,CAUxC,CAAA;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAG1C,CAAA"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/runtime/exports.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAGzF,OAAO,CAAC,MAAM,CAAC,CAAC;IACf,UAAU,WAAW;KAAI;CACzB;AAsED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,GAAG,EAAE,QAAQ,CAAC,WAAW,CAGrC,CAAA;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,GAAG,EAAE,QAAQ,CAAC,mBAAmB,CAG7C,CAAA;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC,YAAY,CAGxC,CAAA;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAG1C,CAAA"}

package/dist/runtime/index.d.ts

@@ -1,4 +1,11 @@
+export { env, ctx, event, locals } from './exports';
+export { setLocalSendEmailBindings, clearLocalSendEmailBindings } from '../utils/send-email';
+export type { EventContext } from './context';
+export { createFetchEvent, createQueueEvent, createScheduledEvent, createEmailEvent, createTailEvent, createDurableObjectFetchEvent, createDurableObjectAlarmEvent, createDurableObjectWebSocketMessageEvent, createDurableObjectWebSocketCloseEvent, createDurableObjectWebSocketErrorEvent, runWithContext, runWithEventContext, getContext, getContextOrNull, getEventContext, getEventContextOrNull, getFetchEvent, getQueueEvent, getScheduledEvent, getEmailEvent, getTailEvent, getDurableObjectEvent, getDurableObjectFetchEvent, getDurableObjectAlarmEvent, getDurableObjectWebSocketMessageEvent, getDurableObjectWebSocketCloseEvent, getDurableObjectWebSocketErrorEvent, hasContext, ContextUnavailableError, type RuntimeEventType, type RuntimeContextValue, type RequestContext } from './context';
+export type { FetchEvent, QueueEvent, ScheduledEvent, EmailEvent, TailEvent, DurableObjectEvent, DurableObjectFetchEvent, DurableObjectAlarmEvent, DurableObjectWebSocketMessageEvent, DurableObjectWebSocketCloseEvent, DurableObjectWebSocketErrorEvent, WorkerEvent, AnyEvent } from './context';
 export { createContextProxy, ContextAccessError } from './validation';
-export { sequence, resolve, pipe, type Middleware, type Handler } from './middleware';
+export { sequence, handle, resolve, pipe, resolveFetchHandler, invokeFetchHandler, createResolveFetch, invokeFetchModule, type Middleware, type Handler, type Awaitable, type ResolveFetch, type FetchMiddleware } from './middleware';
+export { matchFetchRoute, invokeRouteModules, createRouteResolve } from './router';
+export type { RouteSegment, RouteModuleDefinition, RouteMatchResult } from '../router/types';
 export { durableObject, getDurableObjectOptions, type DurableObjectOptions } from '../decorators';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAGrE,OAAO,EACN,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,MAAM,cAAc,CAAA;AAGrB,OAAO,EACN,aAAa,EACb,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACN,GAAG,EACH,GAAG,EACH,KAAK,EACL,MAAM,EACN,MAAM,WAAW,CAAA;AAClB,OAAO,EACN,yBAAyB,EACzB,2BAA2B,EAC3B,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAG7C,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,6BAA6B,EAC7B,6BAA6B,EAC7B,wCAAwC,EACxC,sCAAsC,EACtC,sCAAsC,EACtC,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,0BAA0B,EAC1B,0BAA0B,EAC1B,qCAAqC,EACrC,mCAAmC,EACnC,mCAAmC,EACnC,UAAU,EACV,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,MAAM,WAAW,CAAA;AAElB,YAAY,EACX,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EAChC,WAAW,EACX,QAAQ,EACR,MAAM,WAAW,CAAA;AAGlB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAGrE,OAAO,EACN,QAAQ,EACR,MAAM,EACN,OAAO,EACP,IAAI,EACJ,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,MAAM,cAAc,CAAA;AAErB,OAAO,EACN,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,UAAU,CAAA;AAEjB,YAAY,EACX,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACN,aAAa,EACb,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,MAAM,eAAe,CAAA"}