exportc 0.0.3 → 0.0.4

package/README.md

@@ -20,11 +20,11 @@ npm run export
 
 ## Usage
 
-After initialization, import your server exports using the `export:/` prefix:
+After initialization, import your server exports using the `export/` prefix:
 
 ```typescript
 // In your Vite app
-import { hello, Counter } from "export:/";
+import { hello, Counter } from "export/";
 
 const message = await hello("World");  // "Hello, World!"
 
@@ -51,7 +51,7 @@ Deploy your exports to Cloudflare Workers.
 
 ## Vite Plugin
 
-The `exportPlugin` automatically starts Wrangler and transforms `export:/` imports:
+The `exportPlugin` automatically starts Wrangler and transforms `export/` imports:
 
 ```typescript
 // vite.config.ts
@@ -70,12 +70,12 @@ export default defineConfig({
 **Development** (`npm run dev`):
 1. Automatically starts Wrangler dev server
 2. Waits for it to be ready
-3. Transforms `export:/` imports to `http://localhost:8787`
+3. Transforms `export/` imports to `http://localhost:8787`
 
 **Production** (`npm run export`):
 1. Builds Vite app
 2. Deploys to Workers Sites (static assets + server exports)
-3. `export:/` imports resolve to `https://{worker-name}.workers.dev`
+3. `export/` imports resolve to `https://{worker-name}.workers.dev`
 
 ## Project Structure
 
@@ -93,20 +93,26 @@ my-vite-app/
 
 ## TypeScript Support
 
-The `export-env.d.ts` file provides type declarations for `export:/` imports. Update it when you add new exports:
+The `export-env.d.ts` file is **automatically generated** when you run `npm run dev`. The Vite plugin watches for changes to your export files and regenerates type declarations automatically.
 
 ```typescript
-// export-env.d.ts
-declare module "export:/" {
+// export-env.d.ts (auto-generated)
+declare module "export/" {
   export function hello(name: string): Promise<string>;
-  export function myNewFunction(): Promise<void>;
+  export class Counter {
+    constructor(initial?: number);
+    increment(): Promise<number>;
+    [Symbol.dispose](): Promise<void>;
+  }
 }
 
-declare module "export:/utils" {
+declare module "export/utils" {
   export function formatDate(date: Date): Promise<string>;
 }
 ```
 
+Types are inferred from your actual export code, so you get accurate type information with zero manual maintenance.
+
 ## License
 
 MIT

package/commands/dev.js

@@ -45,7 +45,7 @@ export async function dev(argv) {
     `Wrangler dev server is running at ${pc.cyan("http://localhost:8787")}
 
 ${pc.bold("In your Vite app:")}
-${pc.cyan(`import { hello } from "export:/";`)}
+${pc.cyan(`import { hello } from "export/";`)}
 ${pc.cyan(`const message = await hello("World");`)}
 
 ${pc.dim("Press Ctrl+C to stop")}`,

package/commands/init.js

@@ -76,7 +76,7 @@ export async function init(argv) {
   if (!fs.existsSync(indexPath)) {
     const template = isTypeScript
       ? `// Server-side exports - these will be available to your client code
-// Import from "export:/" in your client code
+// Import from "export/" in your client code
 
 export async function hello(name: string): Promise<string> {
   return \`Hello, \${name}!\`;
@@ -103,7 +103,7 @@ export class Counter {
 }
 `
       : `// Server-side exports - these will be available to your client code
-// Import from "export:/" in your client code
+// Import from "export/" in your client code
 
 export async function hello(name) {
   return \`Hello, \${name}!\`;
@@ -237,13 +237,13 @@ wrangler.toml
   if (isTypeScript) {
     const envDtsPath = path.join(cwd, "export-env.d.ts");
     if (!fs.existsSync(envDtsPath)) {
-      const envDtsContent = `// Type declarations for export:/ imports
+      const envDtsContent = `// Type declarations for export/ imports
 // This file is auto-generated by exportc. You can modify it to add custom types.
 
 // Re-export types from your export directory
 // Update this when you add new exports
 
-declare module "export:/" {
+declare module "export/" {
   export function hello(name: string): Promise<string>;
   export function add(a: number, b: number): Promise<number>;
   export class Counter {
@@ -255,7 +255,7 @@ declare module "export:/" {
 }
 
 // Add more module declarations for subpaths:
-// declare module "export:/utils" {
+// declare module "export/utils" {
 //   export function myUtil(): Promise<void>;
 // }
 `;
@@ -289,7 +289,7 @@ declare module "export:/" {
 ├── package.json    ${pc.dim("# Worker configuration")}
 └── .gitignore
 
-${pc.cyan("export-env.d.ts")}     ${pc.dim("# Type declarations for export:/ imports")}`
+${pc.cyan("export-env.d.ts")}     ${pc.dim("# Type declarations for export/ imports")}`
     : `${pc.cyan("export/")}
 ├── index.${ext}        ${pc.dim("# Your server exports")}
 ├── package.json    ${pc.dim("# Worker configuration")}
@@ -307,7 +307,7 @@ ${pc.bold("Next steps:")}
    ${pc.cyan("npm run dev")}
 
 3. Import in your client code:
-   ${pc.cyan(`import { hello } from "export:/";`)}
+   ${pc.cyan(`import { hello } from "export/";`)}
    ${pc.cyan(`const message = await hello("World");`)}
 
 4. Deploy to Cloudflare Workers Sites:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exportc",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "CLI to add export to existing projects",
   "scripts": {
     "test": "node --test test/*.test.mjs"

package/vite-plugin.d.ts

@@ -37,11 +37,11 @@ export interface ExportPluginOptions {
  * Vite plugin for export integration
  *
  * Automatically starts Wrangler when you run `npm run dev` and allows
- * importing server exports using the "export:/" prefix:
+ * importing server exports using the "export/" prefix:
  *
  * ```ts
- * import { hello } from "export:/";
- * import { utils } from "export:/utils";
+ * import { hello } from "export/";
+ * import { utils } from "export/utils";
  * ```
  *
  * @example

package/vite-plugin.js

@@ -1,9 +1,9 @@
 /**
  * Vite plugin for export integration
  *
- * Allows importing server exports using the "export:/" prefix:
- *   import { hello } from "export:/";
- *   import { utils } from "export:/utils";
+ * Allows importing server exports using the "export/" prefix:
+ *   import { hello } from "export/";
+ *   import { utils } from "export/utils";
  *
  * In development:
  *   - Automatically starts Wrangler dev server
@@ -14,10 +14,10 @@
  */
 
 import { spawn } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, watchFile, unwatchFile } from "node:fs";
 import { resolve } from "node:path";
 
-const EXPORT_PREFIX = "export:";
+const EXPORT_PREFIX = "export/";
 const DEFAULT_DEV_PORT = 8787;
 
 /**
@@ -55,6 +55,44 @@ export function exportPlugin(options = {}) {
     return null;
   };
 
+  // Generate export-env.d.ts from .export-types.js
+  const generateTypeDeclarations = (root) => {
+    try {
+      const typesFilePath = resolve(root, exportDir, ".export-types.js");
+      if (!existsSync(typesFilePath)) return;
+
+      const typesContent = readFileSync(typesFilePath, "utf8");
+      // Extract the first line which contains the default export
+      const firstLine = typesContent.split('\n')[0];
+      if (!firstLine.startsWith('export default ')) return;
+
+      // Remove "export default " prefix and trailing ";"
+      const jsonStr = firstLine.slice('export default '.length).replace(/;$/, '');
+
+      // Parse the types map
+      const typesMap = JSON.parse(jsonStr);
+
+      // Generate declare module statements
+      const declarations = ['// Auto-generated by exportc. Do not edit manually.', '// Re-run "npm run dev" to regenerate after changing export/ files.', ''];
+
+      for (const [route, types] of Object.entries(typesMap)) {
+        const modulePath = route === "" ? "export/" : `export/${route}`;
+        declarations.push(`declare module "${modulePath}" {`);
+        // Indent the type declarations
+        const indented = types.split('\n').map(line => line ? `  ${line}` : '').join('\n');
+        declarations.push(indented);
+        declarations.push('}');
+        declarations.push('');
+      }
+
+      const envDtsPath = resolve(root, "export-env.d.ts");
+      writeFileSync(envDtsPath, declarations.join('\n'));
+      console.log(`[exportc] Generated type declarations: export-env.d.ts`);
+    } catch (err) {
+      console.warn(`[exportc] Failed to generate type declarations:`, err.message);
+    }
+  };
+
   const startWrangler = (root) => {
     const exportPath = resolve(root, exportDir);
 
@@ -164,8 +202,27 @@ export function exportPlugin(options = {}) {
         const root = server.config.root || process.cwd();
         wranglerReadyPromise = startWrangler(root);
 
+        // Generate types after Wrangler is ready
+        wranglerReadyPromise.then(() => {
+          // Initial generation
+          setTimeout(() => generateTypeDeclarations(root), 1000);
+
+          // Watch for changes to .export-types.js
+          const typesFilePath = resolve(root, exportDir, ".export-types.js");
+          if (existsSync(typesFilePath)) {
+            watchFile(typesFilePath, { interval: 1000 }, () => {
+              generateTypeDeclarations(root);
+            });
+          }
+        });
+
         // Cleanup on server close
-        server.httpServer?.on("close", stopWrangler);
+        server.httpServer?.on("close", () => {
+          stopWrangler();
+          // Stop watching
+          const typesFilePath = resolve(root, exportDir, ".export-types.js");
+          unwatchFile(typesFilePath);
+        });
       }
     },
 
@@ -233,7 +290,7 @@ export { default } from "${fullUrl}";
         return null;
       }
 
-      if (code.includes('import("export:') || code.includes("import('export:")) {
+      if (code.includes('import("export/') || code.includes("import('export/")) {
         const baseUrl = isDev ? devUrl : prodUrl;
         if (!baseUrl && !isDev) {
           this.warn(`[exportc] Production URL not configured for dynamic imports in ${id}`);
@@ -241,7 +298,7 @@ export { default } from "${fullUrl}";
         }
 
         const transformed = code.replace(
-          /import\((['"])export:([^'"]*)\1\)/g,
+          /import\((['"])export\/([^'"]*)\1\)/g,
           (match, quote, path) => {
             const fullUrl = new URL(path || "/", baseUrl).href;
             return `import(${quote}${fullUrl}${quote})`;