devflare 0.0.0 → 1.0.0-next.0

package/dist/test/utilities.d.ts

@@ -0,0 +1,99 @@
+export interface TestContextOptions<TEnv = Record<string, unknown>> {
+    env?: TEnv;
+    request?: Request | null;
+    type?: 'fetch' | 'scheduled' | 'queue' | 'email' | 'tail';
+}
+export interface TestContext<TEnv = Record<string, unknown>> {
+    env: TEnv;
+    ctx: ExecutionContext;
+    request: Request | null;
+    waitUntilPromises: Promise<unknown>[];
+}
+export interface MockEnvOptions {
+    kv?: string[];
+    d1?: string[];
+    r2?: string[];
+    queues?: string[];
+    durableObjects?: string[];
+    vars?: Record<string, string>;
+    secrets?: Record<string, string>;
+    custom?: Record<string, unknown>;
+}
+/**
+ * Creates a test context with mock ExecutionContext
+ *
+ * @example
+ * ```ts
+ * const ctx = createTestContext({
+ *   env: { API_KEY: 'test' },
+ *   request: new Request('https://test.com')
+ * })
+ * ```
+ */
+export declare function createMockTestContext<TEnv = Record<string, unknown>>(options?: TestContextOptions<TEnv>): TestContext<TEnv>;
+/**
+ * Runs a function within a test context
+ *
+ * @example
+ * ```ts
+ * const response = await withTestContext(
+ *   { env: { DB: mockD1 } },
+ *   async () => {
+ *     // env, ctx, locals all work here
+ *     return handler.fetch(new Request('https://test.com'))
+ *   }
+ * )
+ * ```
+ */
+export declare function withTestContext<T, TEnv = Record<string, unknown>>(options: TestContextOptions<TEnv>, handler: () => Promise<T>): Promise<T>;
+/**
+ * Creates a mock KVNamespace for testing
+ *
+ * @example
+ * ```ts
+ * const kv = createMockKV({ 'key': 'value' })
+ * await kv.get('key') // 'value'
+ * ```
+ */
+export declare function createMockKV(initialData?: Record<string, string>): KVNamespace;
+/**
+ * Creates a mock D1Database for testing
+ *
+ * @example
+ * ```ts
+ * const d1 = createMockD1([
+ *   { id: 1, name: 'Alice' }
+ * ])
+ * const result = await d1.prepare('SELECT * FROM users').all()
+ * ```
+ */
+export declare function createMockD1(mockResults?: unknown[]): D1Database;
+/**
+ * Creates a mock R2Bucket for testing
+ *
+ * @example
+ * ```ts
+ * const r2 = createMockR2()
+ * await r2.put('file.txt', 'content')
+ * const obj = await r2.get('file.txt')
+ * ```
+ */
+export declare function createMockR2(): R2Bucket;
+/**
+ * Creates a mock Queue for testing
+ */
+export declare function createMockQueue(): Queue;
+/**
+ * Creates a complete mock environment with specified bindings
+ *
+ * @example
+ * ```ts
+ * const env = createMockEnv({
+ *   kv: ['CACHE'],
+ *   d1: ['DB'],
+ *   vars: { API_KEY: 'secret' }
+ * })
+ * ```
+ */
+export declare function createMockEnv(options?: MockEnvOptions): Record<string, unknown>;
+//# sourceMappingURL=utilities.d.ts.map

package/dist/test/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/test/utilities.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,kBAAkB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;CACzD;AAED,MAAM,WAAW,WAAW,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,GAAG,EAAE,IAAI,CAAA;IACT,GAAG,EAAE,gBAAgB,CAAA;IACrB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,cAAc;IAC9B,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,OAAO,GAAE,kBAAkB,CAAC,IAAI,CAAM,GACpC,WAAW,CAAC,IAAI,CAAC,CAmBnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACjC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAUZ;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC3B,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACtC,WAAW,CAgFb;AAoBD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,WAAW,GAAE,OAAO,EAAO,GAAG,UAAU,CAqEpE;AAQD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CA4HvC;AAMD;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAiBvC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+CnF"}

package/dist/test/worker.d.ts

@@ -0,0 +1,76 @@
+export interface WorkerFetchOptions {
+    /** Request method (default: GET) */
+    method?: string;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request body (will be JSON-serialized if object) */
+    body?: unknown;
+}
+/**
+ * Configure the worker test helper
+ * @internal Called by createTestContext to set up handler path and env
+ */
+export declare function configureWorker(options: {
+    handlerPath: string | null;
+    configDir: string;
+    getEnv: () => Record<string, unknown>;
+}): void;
+/**
+ * Reset worker helper state
+ * @internal Called when test context is disposed
+ */
+export declare function resetWorkerState(): void;
+/**
+ * Trigger the fetch handler with a request.
+ * This directly invokes the fetch handler function from your config.
+ *
+ * @param request - Request object or URL string
+ * @param options - Optional fetch options (method, headers, body)
+ * @returns Response from the handler
+ *
+ * @example
+ * ```ts
+ * // With Request object
+ * const response = await cf.worker.fetch(new Request('http://localhost/api'))
+ *
+ * // With URL string
+ * const response = await cf.worker.fetch('http://localhost/api')
+ *
+ * // With options
+ * const response = await cf.worker.fetch('/api/users', {
+ *   method: 'POST',
+ *   body: { name: 'Alice' }
+ * })
+ * ```
+ */
+declare function fetch(request: Request | string, options?: WorkerFetchOptions): Promise<Response>;
+/**
+ * Shorthand for GET requests
+ */
+declare function get(path: string, headers?: Record<string, string>): Promise<Response>;
+/**
+ * Shorthand for POST requests with JSON body
+ */
+declare function post(path: string, body?: unknown, headers?: Record<string, string>): Promise<Response>;
+/**
+ * Shorthand for PUT requests with JSON body
+ */
+declare function put(path: string, body?: unknown, headers?: Record<string, string>): Promise<Response>;
+/**
+ * Shorthand for DELETE requests
+ */
+declare function del(path: string, headers?: Record<string, string>): Promise<Response>;
+/**
+ * Shorthand for PATCH requests with JSON body
+ */
+declare function patch(path: string, body?: unknown, headers?: Record<string, string>): Promise<Response>;
+export declare const worker: {
+    fetch: typeof fetch;
+    get: typeof get;
+    post: typeof post;
+    put: typeof put;
+    delete: typeof del;
+    patch: typeof patch;
+};
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/test/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/test/worker.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,kBAAkB;IAClC,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAA;CACd;AAcD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACxC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC,GAAG,IAAI,CAIP;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAe,KAAK,CACnB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,QAAQ,CAAC,CA2EnB;AAED;;GAEG;AACH,iBAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEpF;AAED;;GAEG;AACH,iBAAe,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAErG;AAED;;GAEG;AACH,iBAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEpG;AAED;;GAEG;AACH,iBAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEpF;AAED;;GAEG;AACH,iBAAe,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEtG;AAMD,eAAO,MAAM,MAAM;;;;;;;CAOlB,CAAA"}

package/dist/transform/durable-object.d.ts

@@ -0,0 +1,46 @@
+import MagicString from 'magic-string';
+/**
+ * Information about a detected Durable Object class
+ */
+export interface DOClassInfo {
+    /** Class name */
+    name: string;
+    /** Whether the class extends DurableObject */
+    extendsBase: boolean;
+    /** Whether the class has @durableObject decorator */
+    hasDecorator: boolean;
+    /** Parsed decorator options (if any) */
+    decoratorOptions?: Record<string, unknown>;
+}
+/**
+ * Finds all class names that extend DurableObject or have @durableObject decorator
+ */
+export declare function findDurableObjectClasses(code: string): string[];
+/**
+ * Finds detailed info about all Durable Object classes
+ */
+export declare function findDurableObjectClassesDetailed(code: string): DOClassInfo[];
+/**
+ * Options for wrapper generation
+ */
+export interface WrapperOptions {
+    alarms?: boolean;
+    websockets?: boolean;
+}
+/**
+ * Generates a wrapper class that injects context into DO methods
+ */
+export declare function generateWrapper(className: string, options?: WrapperOptions): string;
+export interface TransformResult {
+    code: string;
+    map: ReturnType<MagicString['generateMap']>;
+}
+/**
+ * Transforms a source file to wrap Durable Object classes
+ *
+ * @param code - Source code to transform
+ * @param id - File path/id for source mapping
+ * @returns Transformed code with source map, or null if no transforms needed
+ */
+export declare function transformDurableObject(code: string, id: string): Promise<TransformResult | null>;
+//# sourceMappingURL=durable-object.d.ts.map

package/dist/transform/durable-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-object.d.ts","sourceRoot":"","sources":["../../src/transform/durable-object.ts"],"names":[],"mappings":"AAOA,OAAO,WAAW,MAAM,cAAc,CAAA;AAoBtC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAA;IACpB,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAA;IACrB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB/D;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAqD5E;AAiED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CA6EvF;AAMD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAA;CAC3C;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC3C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACR,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA0GjC"}

package/dist/transform/index.d.ts

@@ -0,0 +1,3 @@
+export { transformDurableObject, findDurableObjectClasses, generateWrapper, type TransformResult } from './durable-object';
+export { transformWorkerEntrypoint, findExportedFunctions, shouldTransformWorker, generateRpcInterface, type ExportedFunction, type WorkerTransformOptions, type WorkerTransformResult } from './worker-entrypoint';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transform/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,KAAK,eAAe,EACpB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACN,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,MAAM,qBAAqB,CAAA"}

package/dist/transform/worker-entrypoint.d.ts

@@ -0,0 +1,66 @@
+import MagicString from 'magic-string';
+/**
+ * Information about an exported function
+ */
+export interface ExportedFunction {
+    /** Function name */
+    name: string;
+    /** Whether it's an async function */
+    isAsync: boolean;
+    /** Function parameters (as string) */
+    params: string;
+    /** Return type annotation (if any) */
+    returnType?: string;
+    /** Start position in source */
+    start: number;
+    /** End position in source */
+    end: number;
+    /** The full function text for preservation */
+    body?: string;
+    /** Whether this is the default export */
+    isDefault?: boolean;
+}
+/**
+ * Options for worker entrypoint transformation
+ */
+export interface WorkerTransformOptions {
+    /** Class name to generate (default: 'Worker') */
+    className?: string;
+    /** Whether to inject context wrapper for fetch (default: true) */
+    injectContext?: boolean;
+}
+/**
+ * Result of transformation
+ */
+export interface WorkerTransformResult {
+    code: string;
+    map: ReturnType<MagicString['generateMap']>;
+    /** List of RPC methods (exported functions except fetch) */
+    rpcMethods: string[];
+    /** Generated class name */
+    className: string;
+}
+/**
+ * Find all exported functions in a worker.ts file using TypeScript AST
+ */
+export declare function findExportedFunctions(code: string): ExportedFunction[];
+/**
+ * Check if a file should be transformed as a worker entrypoint
+ * Returns true if the file has exported functions that could be RPC methods
+ */
+export declare function shouldTransformWorker(code: string, filePath: string): boolean;
+/**
+ * Transform a worker.ts file into a WorkerEntrypoint class
+ *
+ * @param code - Source code to transform
+ * @param id - File path/id for source mapping
+ * @param options - Transform options
+ * @returns Transformed code with source map
+ */
+export declare function transformWorkerEntrypoint(code: string, id: string, options?: WorkerTransformOptions): WorkerTransformResult | null;
+/**
+ * Generate TypeScript interface for RPC methods
+ * This is useful for creating type-safe service binding contracts
+ */
+export declare function generateRpcInterface(functions: ExportedFunction[], interfaceName: string): string;
+//# sourceMappingURL=worker-entrypoint.d.ts.map

package/dist/transform/worker-entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-entrypoint.d.ts","sourceRoot":"","sources":["../../src/transform/worker-entrypoint.ts"],"names":[],"mappings":"AAwBA,OAAO,WAAW,MAAM,cAAc,CAAA;AAMtC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAA;IAC3C,4DAA4D;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAA;CACjB;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAqHtE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU7E;AAMD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,sBAA2B,GAClC,qBAAqB,GAAG,IAAI,CAuG9B;AA4CD;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,gBAAgB,EAAE,EAC7B,aAAa,EAAE,MAAM,GACnB,MAAM,CAsBR"}