theokit 0.2.0 → 0.2.1

package/dist/app-typed-client-4L4L4BWD.js

@@ -0,0 +1,289 @@
+#!/usr/bin/env node
+import "tsx/esm";
+import {
+  generateManifest
+} from "./chunk-SEVYARIU.js";
+import {
+  HTTP_METHODS
+} from "./chunk-QLGES2HC.js";
+import "./chunk-MOT42NAH.js";
+import "./chunk-KT3MWNZG.js";
+
+// src/vite-plugin/app-typed-client.ts
+import { mkdirSync, readFileSync, renameSync, writeFileSync, existsSync } from "fs";
+import { dirname, isAbsolute, posix, relative, resolve } from "path";
+var FILE_HEADER = `// AUTO-GENERATED by theokit \u2014 do not edit.
+// Source: theokit/packages/theo/src/vite-plugin/app-typed-client.ts (G1 plan).
+// To refresh: \`pnpm dev\` or \`pnpm build\` regenerates this file on every route change.
+
+/* eslint-disable */
+`;
+function makeNode() {
+  return { children: /* @__PURE__ */ new Map(), methods: /* @__PURE__ */ new Map(), paramNamesAccumulated: [] };
+}
+function normalizeSegment(raw) {
+  let s = raw;
+  if (s.startsWith(":...")) s = s.slice(4);
+  else if (s.startsWith(":")) s = s.slice(1);
+  const camel = s.replace(/-([a-z0-9])/gi, (_, c) => c.toUpperCase());
+  if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(camel)) {
+    return { identifier: camel, bracket: false };
+  }
+  return { identifier: s, bracket: true };
+}
+function importPathFor(dtsOutPath, routeFileAbs) {
+  let rel = relative(dirname(dtsOutPath), routeFileAbs);
+  rel = rel.replace(/\\/g, "/");
+  rel = rel.replace(/\.[jt]sx?$/, "");
+  if (!rel.startsWith(".") && !rel.startsWith("/")) {
+    rel = "./" + rel;
+  }
+  return rel;
+}
+function routePathSegments(routePath) {
+  let p = routePath;
+  if (p.startsWith("/api/")) p = p.slice(5);
+  else if (p.startsWith("/api")) p = p.slice(4);
+  if (p.startsWith("/")) p = p.slice(1);
+  if (p === "") return [];
+  return p.split("/").filter(Boolean);
+}
+function paramNamesFromRoute(routePath) {
+  const out = [];
+  const re = /:(?:\.\.\.)?([^/]+)/g;
+  let m;
+  while ((m = re.exec(routePath)) !== null) {
+    out.push(m[1]);
+  }
+  return out;
+}
+function buildOneRoute(route, ctx) {
+  if (!route.methods || route.methods.length === 0) return;
+  const idx = ctx.aliasCounter.value++;
+  const absRouteFile = isAbsolute(route.filePath) ? route.filePath : resolve(ctx.serverDir, route.filePath);
+  const importPath = importPathFor(ctx.dtsOutPath, absRouteFile);
+  const aliases = route.methods.filter((m) => HTTP_METHODS.includes(m)).map((method) => ({ method, alias: `_r${idx}_${method}` }));
+  if (aliases.length === 0) return;
+  const importClause = aliases.map((a) => `${a.method} as ${a.alias}`).join(", ");
+  ctx.importLines.push(`  import type { ${importClause} } from '${importPath}'`);
+  const segments = routePathSegments(route.routePath);
+  let node = ctx.root;
+  const tokens = [];
+  for (const seg of segments) {
+    const norm = normalizeSegment(seg);
+    tokens.push({ token: norm.identifier, bracket: norm.bracket });
+    let child = node.children.get(norm.identifier);
+    if (child === void 0) {
+      child = makeNode();
+      node.children.set(norm.identifier, child);
+    }
+    node = child;
+  }
+  node.paramNamesAccumulated = paramNamesFromRoute(route.routePath);
+  for (const { method, alias } of aliases) {
+    if (node.methods.has(method)) {
+      ctx.warnings.push(
+        `// WARNING: duplicate ${method} export at /${segments.join("/")} (route file declared twice). Keeping last definition.`
+      );
+    }
+    node.methods.set(method, alias);
+  }
+}
+function resolveCollisions(node, pathPrefix, warnings) {
+  const methodLowerNames = /* @__PURE__ */ new Set();
+  for (const method of node.methods.keys()) {
+    methodLowerNames.add(method.toLowerCase());
+  }
+  const renames = [];
+  for (const childName of node.children.keys()) {
+    if (methodLowerNames.has(childName)) {
+      renames.push({ from: childName, to: `${childName}_` });
+    }
+  }
+  for (const { from, to } of renames) {
+    const old = node.children.get(from);
+    if (old !== void 0) {
+      node.children.delete(from);
+      node.children.set(to, old);
+      warnings.push(
+        `WARNING (EC-3): path collision \u2014 method '${from}' clashed with sub-namespace at ${pathPrefix}/${from}; sub-namespace renamed to '${to}'.`
+      );
+    }
+  }
+  for (const [name, child] of node.children) {
+    resolveCollisions(child, `${pathPrefix}/${name}`, warnings);
+  }
+}
+function renderTreeNode(node, indent, isRoot) {
+  const lines = [];
+  if (isRoot) {
+    lines.push("{");
+  } else {
+    lines.push("{");
+  }
+  for (const [method, alias] of node.methods) {
+    const lower = method.toLowerCase();
+    const paramsField = node.paramNamesAccumulated.length > 0 ? `params: { ${node.paramNamesAccumulated.map((p) => `${p}: string`).join("; ")} } & ` : "";
+    lines.push(
+      `${indent}  ${lower}: (opts${node.paramNamesAccumulated.length === 0 ? "?" : ""}: ${paramsField}import('theokit/client').TheoFetchOptions<typeof ${alias}>) => Promise<import('theokit/client').InferResponse<typeof ${alias}>>`
+    );
+  }
+  for (const [name, child] of node.children) {
+    const propKey = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name) ? name : `'${name.replace(/'/g, "\\'")}'`;
+    lines.push(`${indent}  ${propKey}: ${renderTreeNode(child, indent + "  ", false)}`);
+  }
+  lines.push(`${indent}}`);
+  return lines.join("\n");
+}
+function generateClientDts({
+  manifest,
+  dtsOutPath,
+  serverDir
+}) {
+  const ctx = {
+    root: makeNode(),
+    aliasCounter: { value: 0 },
+    importLines: [],
+    warnings: [],
+    dtsOutPath,
+    serverDir
+  };
+  for (const route of manifest.routes) {
+    buildOneRoute(route, ctx);
+  }
+  resolveCollisions(ctx.root, "", ctx.warnings);
+  const importsBlock = ctx.importLines.length > 0 ? ctx.importLines.join("\n") + "\n\n" : "\n";
+  const warningsBlock = ctx.warnings.length > 0 ? "  // " + ctx.warnings.join("\n  // ") + "\n\n" : "";
+  const treeBody = ctx.root.children.size === 0 && ctx.root.methods.size === 0 ? "{\n    // No routes detected \u2014 add `server/routes/*.ts` to populate this client.\n  }" : renderTreeNode(
+    ctx.root,
+    "  ",
+    /* isRoot */
+    true
+  );
+  return `${FILE_HEADER}
+declare module '@theo/client' {
+${importsBlock}${warningsBlock}  export interface AppClient ${treeBody}
+  export const client: AppClient
+}
+`;
+}
+var VIRTUAL_APP_CLIENT_ID = "@theo/client";
+var RESOLVED_APP_CLIENT_ID = "\0@theo/client";
+function writeFileIfChanged(filePath, content) {
+  if (existsSync(filePath)) {
+    try {
+      const current = readFileSync(filePath, "utf-8");
+      if (current === content) return { changed: false };
+    } catch {
+    }
+  }
+  mkdirSync(dirname(filePath), { recursive: true });
+  const tmp = `${filePath}.${process.pid}.tmp`;
+  writeFileSync(tmp, content);
+  renameSync(tmp, filePath);
+  return { changed: true };
+}
+function emitClientDts(opts) {
+  if (!existsSync(opts.serverDir)) {
+    const stubPath = posix.join(
+      opts.distDir.replace(/\\/g, "/"),
+      "client.d.ts"
+    );
+    return {
+      changed: writeFileIfChanged(
+        stubPath,
+        generateClientDts({
+          manifest: {
+            version: 1,
+            generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            routes: [],
+            actions: [],
+            websockets: []
+          },
+          dtsOutPath: stubPath,
+          serverDir: opts.serverDir
+        })
+      ).changed,
+      path: stubPath
+    };
+  }
+  const manifest = generateManifest(opts.serverDir);
+  const dtsOutPath = posix.join(opts.distDir.replace(/\\/g, "/"), "client.d.ts");
+  const content = generateClientDts({
+    manifest,
+    dtsOutPath,
+    serverDir: opts.serverDir
+  });
+  const { changed } = writeFileIfChanged(dtsOutPath, content);
+  return { changed, path: dtsOutPath };
+}
+function appTypedClientPlugin(opts) {
+  let debounceTimer;
+  let viteServer;
+  function scheduleEmit() {
+    if (debounceTimer) clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(() => {
+      try {
+        emitClientDts(opts);
+        if (viteServer) {
+          const mod = viteServer.moduleGraph.getModuleById(RESOLVED_APP_CLIENT_ID);
+          if (mod) viteServer.moduleGraph.invalidateModule(mod);
+        }
+      } catch (err) {
+        console.error("[theokit:app-typed-client] codegen error:", err);
+      }
+    }, 100);
+  }
+  return {
+    name: "theokit:app-typed-client",
+    enforce: "post",
+    configResolved() {
+      try {
+        emitClientDts(opts);
+      } catch (err) {
+        console.error("[theokit:app-typed-client] initial codegen error:", err);
+      }
+    },
+    buildEnd() {
+      try {
+        emitClientDts(opts);
+      } catch (err) {
+        console.error("[theokit:app-typed-client] buildEnd codegen error:", err);
+      }
+    },
+    configureServer(server) {
+      viteServer = server;
+      const routesGlob = posix.join(opts.serverDir.replace(/\\/g, "/"), "routes");
+      const onFile = (file) => {
+        const normalized = file.replace(/\\/g, "/");
+        if (normalized.startsWith(routesGlob)) scheduleEmit();
+      };
+      server.watcher.on("add", onFile);
+      server.watcher.on("change", onFile);
+      server.watcher.on("unlink", onFile);
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_APP_CLIENT_ID) return RESOLVED_APP_CLIENT_ID;
+      return null;
+    },
+    load(id) {
+      if (id === RESOLVED_APP_CLIENT_ID) {
+        return [
+          `import { createAppClient } from 'theokit/client'`,
+          `export const client = createAppClient()`,
+          `export default client`,
+          ``
+        ].join("\n");
+      }
+      return null;
+    }
+  };
+}
+export {
+  RESOLVED_APP_CLIENT_ID,
+  VIRTUAL_APP_CLIENT_ID,
+  appTypedClientPlugin,
+  emitClientDts,
+  generateClientDts
+};
+//# sourceMappingURL=app-typed-client-4L4L4BWD.js.map

package/dist/app-typed-client-4L4L4BWD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin/app-typed-client.ts"],"sourcesContent":["/**\n * Phase 2 + Phase 4 of G1 (g1-client-codegen-plan.md):\n *\n * 1. `generateClientDts(manifest, dtsOutPath)` — pure function emitting the\n *    `.theo/client.d.ts` shape (declared module `@theo/client`).\n * 2. `appTypedClientPlugin(opts)` — Vite plugin wrapper that calls (1),\n *    writes the file atomically, and rewrites on route file changes.\n *\n * Implementation notes:\n *  - Pure (1) is unit-testable without Vite or a filesystem (see G1-P2 tests).\n *  - EC-2: kebab-case segments → camelCase; unsafe chars → bracket-access.\n *  - EC-3: collision between HTTP method name and sub-segment name → method\n *    wins; sub-segment ganha suffix `_` + warning comment.\n *  - EC-6: write é `writeFileSync(tmp) + renameSync(tmp, final)` (POSIX atomic).\n *  - EC-8: imports normalizam `\\\\` → `/`.\n */\n\nimport { mkdirSync, readFileSync, renameSync, writeFileSync, existsSync } from 'node:fs'\nimport { dirname, isAbsolute, posix, relative, resolve } from 'node:path'\n\nimport type { Plugin, ViteDevServer } from 'vite'\n\nimport { HTTP_METHODS, type HttpMethod } from '../core/contracts/http-methods.js'\nimport {\n  generateManifest,\n  type ManifestRoute,\n  type TheoManifest,\n} from '../server/scan/manifest.js'\n\nconst FILE_HEADER = `// AUTO-GENERATED by theokit — do not edit.\n// Source: theokit/packages/theo/src/vite-plugin/app-typed-client.ts (G1 plan).\n// To refresh: \\`pnpm dev\\` or \\`pnpm build\\` regenerates this file on every route change.\n\n/* eslint-disable */\n`\n\ninterface TreeNode {\n  /** sub-namespaces — keyed by segment name (already normalized). */\n  children: Map<string, TreeNode>\n  /** HTTP methods declared at this path → import alias. */\n  methods: Map<HttpMethod, string>\n  /** Whether any descendant declares dynamic params (for params type construction). */\n  paramNamesAccumulated: string[]\n}\n\nfunction makeNode(): TreeNode {\n  return { children: new Map(), methods: new Map(), paramNamesAccumulated: [] }\n}\n\n/**\n * Normalize a path segment to a valid TS identifier when possible.\n * EC-2: kebab-case → camelCase; pure dynamic (`:name`) → identifier `name`;\n * starts with digit or unsafe char → emit as bracket-access key.\n */\nfunction normalizeSegment(raw: string): { identifier: string; bracket: boolean } {\n  // Dynamic segment: leading `:` (e.g. `:id` or `:...slug`).\n  let s = raw\n  if (s.startsWith(':...')) s = s.slice(4)\n  else if (s.startsWith(':')) s = s.slice(1)\n\n  // kebab → camel\n  const camel = s.replace(/-([a-z0-9])/gi, (_, c: string) => c.toUpperCase())\n\n  // Valid TS identifier (cannot start with digit, must be [a-zA-Z_$][a-zA-Z0-9_$]*)\n  if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(camel)) {\n    return { identifier: camel, bracket: false }\n  }\n  // Fallback: bracket-access (keep raw form intact for JSON-string key)\n  return { identifier: s, bracket: true }\n}\n\nfunction importPathFor(dtsOutPath: string, routeFileAbs: string): string {\n  let rel = relative(dirname(dtsOutPath), routeFileAbs)\n  // EC-8: normalize Windows path separators.\n  rel = rel.replace(/\\\\/g, '/')\n  // Strip extension (`.ts` / `.tsx`); TS module resolution likes extensionless.\n  rel = rel.replace(/\\.[jt]sx?$/, '')\n  if (!rel.startsWith('.') && !rel.startsWith('/')) {\n    rel = './' + rel\n  }\n  return rel\n}\n\n/**\n * Convert a route path (e.g. `/api/users/:id/posts`) into the tree segments\n * we want under the `client` root. Strips the `/api/` prefix and splits.\n */\nfunction routePathSegments(routePath: string): string[] {\n  let p = routePath\n  if (p.startsWith('/api/')) p = p.slice(5)\n  else if (p.startsWith('/api')) p = p.slice(4)\n  if (p.startsWith('/')) p = p.slice(1)\n  if (p === '') return []\n  return p.split('/').filter(Boolean)\n}\n\nfunction paramNamesFromRoute(routePath: string): string[] {\n  const out: string[] = []\n  const re = /:(?:\\.\\.\\.)?([^/]+)/g\n  let m: RegExpExecArray | null\n  while ((m = re.exec(routePath)) !== null) {\n    out.push(m[1])\n  }\n  return out\n}\n\ninterface BuildContext {\n  root: TreeNode\n  /** Sequential index per route file for aliasing imports. */\n  aliasCounter: { value: number }\n  /** Lines emitted at the top of the declared module (one per route file). */\n  importLines: string[]\n  /** Diagnostic warnings rendered as block comments inside the declared module. */\n  warnings: string[]\n  dtsOutPath: string\n  serverDir: string\n}\n\nfunction buildOneRoute(route: ManifestRoute, ctx: BuildContext): void {\n  if (!route.methods || route.methods.length === 0) return\n  // Build alias prefix once per route file (`_r0`, `_r1`, ...).\n  const idx = ctx.aliasCounter.value++\n  // Resolve absolute path for the route file (manifest stores it relative to serverDir).\n  const absRouteFile = isAbsolute(route.filePath)\n    ? route.filePath\n    : resolve(ctx.serverDir, route.filePath)\n  const importPath = importPathFor(ctx.dtsOutPath, absRouteFile)\n  const aliases = route.methods\n    .filter((m): m is HttpMethod => (HTTP_METHODS as readonly string[]).includes(m))\n    .map((method) => ({ method, alias: `_r${idx}_${method}` }))\n  if (aliases.length === 0) return\n  const importClause = aliases.map((a) => `${a.method} as ${a.alias}`).join(', ')\n  ctx.importLines.push(`  import type { ${importClause} } from '${importPath}'`)\n\n  // Walk segments + register methods at the leaf node.\n  const segments = routePathSegments(route.routePath)\n  let node = ctx.root\n  const tokens: Array<{ token: string; bracket: boolean }> = []\n  for (const seg of segments) {\n    const norm = normalizeSegment(seg)\n    tokens.push({ token: norm.identifier, bracket: norm.bracket })\n    let child = node.children.get(norm.identifier)\n    if (child === undefined) {\n      child = makeNode()\n      node.children.set(norm.identifier, child)\n    }\n    node = child\n  }\n  // Accumulated param names for typed params (e.g. `{ id: string }`).\n  node.paramNamesAccumulated = paramNamesFromRoute(route.routePath)\n\n  // Register each HTTP method (collision detection runs in a post-pass).\n  for (const { method, alias } of aliases) {\n    if (node.methods.has(method)) {\n      ctx.warnings.push(\n        `// WARNING: duplicate ${method} export at /${segments.join('/')} (route file declared twice). Keeping last definition.`,\n      )\n    }\n    node.methods.set(method, alias)\n  }\n}\n\n/**\n * EC-3: walk the tree post-build and resolve any node where a method's\n * lowercase name clashes with a child segment. HTTP method wins (more common);\n * the offending child gets a `_` suffix + a warning entry.\n */\nfunction resolveCollisions(node: TreeNode, pathPrefix: string, warnings: string[]): void {\n  const methodLowerNames = new Set<string>()\n  for (const method of node.methods.keys()) {\n    methodLowerNames.add(method.toLowerCase())\n  }\n  const renames: Array<{ from: string; to: string }> = []\n  for (const childName of node.children.keys()) {\n    if (methodLowerNames.has(childName)) {\n      renames.push({ from: childName, to: `${childName}_` })\n    }\n  }\n  for (const { from, to } of renames) {\n    const old = node.children.get(from)\n    if (old !== undefined) {\n      node.children.delete(from)\n      node.children.set(to, old)\n      warnings.push(\n        `WARNING (EC-3): path collision — method '${from}' clashed with sub-namespace at ${pathPrefix}/${from}; sub-namespace renamed to '${to}'.`,\n      )\n    }\n  }\n  // Recurse into all children (including the renamed ones).\n  for (const [name, child] of node.children) {\n    resolveCollisions(child, `${pathPrefix}/${name}`, warnings)\n  }\n}\n\nfunction renderTreeNode(node: TreeNode, indent: string, isRoot: boolean): string {\n  const lines: string[] = []\n  if (isRoot) {\n    lines.push('{')\n  } else {\n    lines.push('{')\n  }\n  // Methods first\n  for (const [method, alias] of node.methods) {\n    const lower = method.toLowerCase()\n    const paramsField = node.paramNamesAccumulated.length > 0\n      ? `params: { ${node.paramNamesAccumulated.map((p) => `${p}: string`).join('; ')} } & `\n      : ''\n    lines.push(\n      `${indent}  ${lower}: (opts${node.paramNamesAccumulated.length === 0 ? '?' : ''}: ${paramsField}import('theokit/client').TheoFetchOptions<typeof ${alias}>) => Promise<import('theokit/client').InferResponse<typeof ${alias}>>`,\n    )\n  }\n  // Children\n  for (const [name, child] of node.children) {\n    const propKey = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name) ? name : `'${name.replace(/'/g, \"\\\\'\")}'`\n    lines.push(`${indent}  ${propKey}: ${renderTreeNode(child, indent + '  ', false)}`)\n  }\n  lines.push(`${indent}}`)\n  return lines.join('\\n')\n}\n\nexport interface GenerateClientDtsOptions {\n  manifest: TheoManifest\n  /** Absolute path to the .d.ts that will be emitted. Used to compute import paths. */\n  dtsOutPath: string\n  /** Absolute serverDir; manifest's filePath entries are relative to this. */\n  serverDir: string\n}\n\nexport function generateClientDts({\n  manifest,\n  dtsOutPath,\n  serverDir,\n}: GenerateClientDtsOptions): string {\n  const ctx: BuildContext = {\n    root: makeNode(),\n    aliasCounter: { value: 0 },\n    importLines: [],\n    warnings: [],\n    dtsOutPath,\n    serverDir,\n  }\n  for (const route of manifest.routes) {\n    buildOneRoute(route, ctx)\n  }\n  // EC-3: resolve collisions in a post-build pass (collisions materialize\n  // when two routes are both processed, not during a single route's build).\n  resolveCollisions(ctx.root, '', ctx.warnings)\n\n  const importsBlock =\n    ctx.importLines.length > 0 ? ctx.importLines.join('\\n') + '\\n\\n' : '\\n'\n  const warningsBlock =\n    ctx.warnings.length > 0\n      ? '  // ' + ctx.warnings.join('\\n  // ') + '\\n\\n'\n      : ''\n\n  // Empty manifest (no routes with methods) → emit a stub interface so consumers\n  // still get `client.X` autocomplete-friendly errors instead of \"Module not found\".\n  const treeBody =\n    ctx.root.children.size === 0 && ctx.root.methods.size === 0\n      ? '{\\n    // No routes detected — add `server/routes/*.ts` to populate this client.\\n  }'\n      : renderTreeNode(ctx.root, '  ', /* isRoot */ true)\n\n  return `${FILE_HEADER}\ndeclare module '@theo/client' {\n${importsBlock}${warningsBlock}  export interface AppClient ${treeBody}\n  export const client: AppClient\n}\n`\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Phase 4 — Vite plugin\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface AppTypedClientPluginOptions {\n  /** Project root (cwd). */\n  cwd: string\n  /** Absolute path to the user's `server/` dir. */\n  serverDir: string\n  /** Absolute path to the `.theo/` output dir (where `client.d.ts` lands). */\n  distDir: string\n}\n\nconst VIRTUAL_APP_CLIENT_ID = '@theo/client'\nconst RESOLVED_APP_CLIENT_ID = '\\0@theo/client'\n\n/** Atomic write via tmp + rename (EC-6). Skips when content is unchanged. */\nfunction writeFileIfChanged(filePath: string, content: string): { changed: boolean } {\n  if (existsSync(filePath)) {\n    try {\n      const current = readFileSync(filePath, 'utf-8')\n      if (current === content) return { changed: false }\n    } catch {\n      // fall through to write\n    }\n  }\n  mkdirSync(dirname(filePath), { recursive: true })\n  const tmp = `${filePath}.${process.pid}.tmp`\n  writeFileSync(tmp, content)\n  renameSync(tmp, filePath)\n  return { changed: true }\n}\n\nfunction emitClientDts(opts: AppTypedClientPluginOptions): { changed: boolean; path: string } {\n  if (!existsSync(opts.serverDir)) {\n    // No server dir — emit empty stub to avoid \"module not found\".\n    const stubPath = posix.join(\n      opts.distDir.replace(/\\\\/g, '/'),\n      'client.d.ts',\n    )\n    return {\n      changed: writeFileIfChanged(\n        stubPath,\n        generateClientDts({\n          manifest: {\n            version: 1,\n            generatedAt: new Date().toISOString(),\n            routes: [],\n            actions: [],\n            websockets: [],\n          },\n          dtsOutPath: stubPath,\n          serverDir: opts.serverDir,\n        }),\n      ).changed,\n      path: stubPath,\n    }\n  }\n  const manifest = generateManifest(opts.serverDir)\n  const dtsOutPath = posix.join(opts.distDir.replace(/\\\\/g, '/'), 'client.d.ts')\n  const content = generateClientDts({\n    manifest,\n    dtsOutPath,\n    serverDir: opts.serverDir,\n  })\n  const { changed } = writeFileIfChanged(dtsOutPath, content)\n  return { changed, path: dtsOutPath }\n}\n\nexport function appTypedClientPlugin(opts: AppTypedClientPluginOptions): Plugin {\n  let debounceTimer: NodeJS.Timeout | undefined\n  let viteServer: ViteDevServer | undefined\n\n  function scheduleEmit(): void {\n    if (debounceTimer) clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      try {\n        emitClientDts(opts)\n        // Invalidate the virtual module so re-imports pick up potential new shape.\n        if (viteServer) {\n          const mod = viteServer.moduleGraph.getModuleById(RESOLVED_APP_CLIENT_ID)\n          if (mod) viteServer.moduleGraph.invalidateModule(mod)\n        }\n      } catch (err) {\n        // Surface but don't crash dev server.\n        // eslint-disable-next-line no-console\n        console.error('[theokit:app-typed-client] codegen error:', err)\n      }\n    }, 100)\n  }\n\n  return {\n    name: 'theokit:app-typed-client',\n    enforce: 'post',\n    configResolved() {\n      try {\n        emitClientDts(opts)\n      } catch (err) {\n        // eslint-disable-next-line no-console\n        console.error('[theokit:app-typed-client] initial codegen error:', err)\n      }\n    },\n    buildEnd() {\n      try {\n        emitClientDts(opts)\n      } catch (err) {\n        // eslint-disable-next-line no-console\n        console.error('[theokit:app-typed-client] buildEnd codegen error:', err)\n      }\n    },\n    configureServer(server) {\n      viteServer = server\n      const routesGlob = posix.join(opts.serverDir.replace(/\\\\/g, '/'), 'routes')\n      const onFile = (file: string): void => {\n        const normalized = file.replace(/\\\\/g, '/')\n        if (normalized.startsWith(routesGlob)) scheduleEmit()\n      }\n      server.watcher.on('add', onFile)\n      server.watcher.on('change', onFile)\n      server.watcher.on('unlink', onFile)\n    },\n    resolveId(id) {\n      if (id === VIRTUAL_APP_CLIENT_ID) return RESOLVED_APP_CLIENT_ID\n      return null\n    },\n    load(id) {\n      if (id === RESOLVED_APP_CLIENT_ID) {\n        return [\n          `import { createAppClient } from 'theokit/client'`,\n          `export const client = createAppClient()`,\n          `export default client`,\n          ``,\n        ].join('\\n')\n      }\n      return null\n    },\n  }\n}\n\nexport { VIRTUAL_APP_CLIENT_ID, RESOLVED_APP_CLIENT_ID, emitClientDts }\n"],"mappings":"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","names":[]}

package/dist/app-typed-client-6PAT6VOL.js

@@ -0,0 +1,289 @@
+import {
+  generateManifest
+} from "./chunk-ERAZNHHR.js";
+import "./chunk-2BQYEBCK.js";
+import "./chunk-7DHGV77J.js";
+import "./chunk-X2VVCJ4V.js";
+import {
+  HTTP_METHODS
+} from "./chunk-WSJKACWB.js";
+import "./chunk-DGUM43GV.js";
+
+// src/vite-plugin/app-typed-client.ts
+import { mkdirSync, readFileSync, renameSync, writeFileSync, existsSync } from "fs";
+import { dirname, isAbsolute, posix, relative, resolve } from "path";
+var FILE_HEADER = `// AUTO-GENERATED by theokit \u2014 do not edit.
+// Source: theokit/packages/theo/src/vite-plugin/app-typed-client.ts (G1 plan).
+// To refresh: \`pnpm dev\` or \`pnpm build\` regenerates this file on every route change.
+
+/* eslint-disable */
+`;
+function makeNode() {
+  return { children: /* @__PURE__ */ new Map(), methods: /* @__PURE__ */ new Map(), paramNamesAccumulated: [] };
+}
+function normalizeSegment(raw) {
+  let s = raw;
+  if (s.startsWith(":...")) s = s.slice(4);
+  else if (s.startsWith(":")) s = s.slice(1);
+  const camel = s.replace(/-([a-z0-9])/gi, (_, c) => c.toUpperCase());
+  if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(camel)) {
+    return { identifier: camel, bracket: false };
+  }
+  return { identifier: s, bracket: true };
+}
+function importPathFor(dtsOutPath, routeFileAbs) {
+  let rel = relative(dirname(dtsOutPath), routeFileAbs);
+  rel = rel.replace(/\\/g, "/");
+  rel = rel.replace(/\.[jt]sx?$/, "");
+  if (!rel.startsWith(".") && !rel.startsWith("/")) {
+    rel = "./" + rel;
+  }
+  return rel;
+}
+function routePathSegments(routePath) {
+  let p = routePath;
+  if (p.startsWith("/api/")) p = p.slice(5);
+  else if (p.startsWith("/api")) p = p.slice(4);
+  if (p.startsWith("/")) p = p.slice(1);
+  if (p === "") return [];
+  return p.split("/").filter(Boolean);
+}
+function paramNamesFromRoute(routePath) {
+  const out = [];
+  const re = /:(?:\.\.\.)?([^/]+)/g;
+  let m;
+  while ((m = re.exec(routePath)) !== null) {
+    out.push(m[1]);
+  }
+  return out;
+}
+function buildOneRoute(route, ctx) {
+  if (!route.methods || route.methods.length === 0) return;
+  const idx = ctx.aliasCounter.value++;
+  const absRouteFile = isAbsolute(route.filePath) ? route.filePath : resolve(ctx.serverDir, route.filePath);
+  const importPath = importPathFor(ctx.dtsOutPath, absRouteFile);
+  const aliases = route.methods.filter((m) => HTTP_METHODS.includes(m)).map((method) => ({ method, alias: `_r${idx}_${method}` }));
+  if (aliases.length === 0) return;
+  const importClause = aliases.map((a) => `${a.method} as ${a.alias}`).join(", ");
+  ctx.importLines.push(`  import type { ${importClause} } from '${importPath}'`);
+  const segments = routePathSegments(route.routePath);
+  let node = ctx.root;
+  const tokens = [];
+  for (const seg of segments) {
+    const norm = normalizeSegment(seg);
+    tokens.push({ token: norm.identifier, bracket: norm.bracket });
+    let child = node.children.get(norm.identifier);
+    if (child === void 0) {
+      child = makeNode();
+      node.children.set(norm.identifier, child);
+    }
+    node = child;
+  }
+  node.paramNamesAccumulated = paramNamesFromRoute(route.routePath);
+  for (const { method, alias } of aliases) {
+    if (node.methods.has(method)) {
+      ctx.warnings.push(
+        `// WARNING: duplicate ${method} export at /${segments.join("/")} (route file declared twice). Keeping last definition.`
+      );
+    }
+    node.methods.set(method, alias);
+  }
+}
+function resolveCollisions(node, pathPrefix, warnings) {
+  const methodLowerNames = /* @__PURE__ */ new Set();
+  for (const method of node.methods.keys()) {
+    methodLowerNames.add(method.toLowerCase());
+  }
+  const renames = [];
+  for (const childName of node.children.keys()) {
+    if (methodLowerNames.has(childName)) {
+      renames.push({ from: childName, to: `${childName}_` });
+    }
+  }
+  for (const { from, to } of renames) {
+    const old = node.children.get(from);
+    if (old !== void 0) {
+      node.children.delete(from);
+      node.children.set(to, old);
+      warnings.push(
+        `WARNING (EC-3): path collision \u2014 method '${from}' clashed with sub-namespace at ${pathPrefix}/${from}; sub-namespace renamed to '${to}'.`
+      );
+    }
+  }
+  for (const [name, child] of node.children) {
+    resolveCollisions(child, `${pathPrefix}/${name}`, warnings);
+  }
+}
+function renderTreeNode(node, indent, isRoot) {
+  const lines = [];
+  if (isRoot) {
+    lines.push("{");
+  } else {
+    lines.push("{");
+  }
+  for (const [method, alias] of node.methods) {
+    const lower = method.toLowerCase();
+    const paramsField = node.paramNamesAccumulated.length > 0 ? `params: { ${node.paramNamesAccumulated.map((p) => `${p}: string`).join("; ")} } & ` : "";
+    lines.push(
+      `${indent}  ${lower}: (opts${node.paramNamesAccumulated.length === 0 ? "?" : ""}: ${paramsField}import('theokit/client').TheoFetchOptions<typeof ${alias}>) => Promise<import('theokit/client').InferResponse<typeof ${alias}>>`
+    );
+  }
+  for (const [name, child] of node.children) {
+    const propKey = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name) ? name : `'${name.replace(/'/g, "\\'")}'`;
+    lines.push(`${indent}  ${propKey}: ${renderTreeNode(child, indent + "  ", false)}`);
+  }
+  lines.push(`${indent}}`);
+  return lines.join("\n");
+}
+function generateClientDts({
+  manifest,
+  dtsOutPath,
+  serverDir
+}) {
+  const ctx = {
+    root: makeNode(),
+    aliasCounter: { value: 0 },
+    importLines: [],
+    warnings: [],
+    dtsOutPath,
+    serverDir
+  };
+  for (const route of manifest.routes) {
+    buildOneRoute(route, ctx);
+  }
+  resolveCollisions(ctx.root, "", ctx.warnings);
+  const importsBlock = ctx.importLines.length > 0 ? ctx.importLines.join("\n") + "\n\n" : "\n";
+  const warningsBlock = ctx.warnings.length > 0 ? "  // " + ctx.warnings.join("\n  // ") + "\n\n" : "";
+  const treeBody = ctx.root.children.size === 0 && ctx.root.methods.size === 0 ? "{\n    // No routes detected \u2014 add `server/routes/*.ts` to populate this client.\n  }" : renderTreeNode(
+    ctx.root,
+    "  ",
+    /* isRoot */
+    true
+  );
+  return `${FILE_HEADER}
+declare module '@theo/client' {
+${importsBlock}${warningsBlock}  export interface AppClient ${treeBody}
+  export const client: AppClient
+}
+`;
+}
+var VIRTUAL_APP_CLIENT_ID = "@theo/client";
+var RESOLVED_APP_CLIENT_ID = "\0@theo/client";
+function writeFileIfChanged(filePath, content) {
+  if (existsSync(filePath)) {
+    try {
+      const current = readFileSync(filePath, "utf-8");
+      if (current === content) return { changed: false };
+    } catch {
+    }
+  }
+  mkdirSync(dirname(filePath), { recursive: true });
+  const tmp = `${filePath}.${process.pid}.tmp`;
+  writeFileSync(tmp, content);
+  renameSync(tmp, filePath);
+  return { changed: true };
+}
+function emitClientDts(opts) {
+  if (!existsSync(opts.serverDir)) {
+    const stubPath = posix.join(
+      opts.distDir.replace(/\\/g, "/"),
+      "client.d.ts"
+    );
+    return {
+      changed: writeFileIfChanged(
+        stubPath,
+        generateClientDts({
+          manifest: {
+            version: 1,
+            generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            routes: [],
+            actions: [],
+            websockets: []
+          },
+          dtsOutPath: stubPath,
+          serverDir: opts.serverDir
+        })
+      ).changed,
+      path: stubPath
+    };
+  }
+  const manifest = generateManifest(opts.serverDir);
+  const dtsOutPath = posix.join(opts.distDir.replace(/\\/g, "/"), "client.d.ts");
+  const content = generateClientDts({
+    manifest,
+    dtsOutPath,
+    serverDir: opts.serverDir
+  });
+  const { changed } = writeFileIfChanged(dtsOutPath, content);
+  return { changed, path: dtsOutPath };
+}
+function appTypedClientPlugin(opts) {
+  let debounceTimer;
+  let viteServer;
+  function scheduleEmit() {
+    if (debounceTimer) clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(() => {
+      try {
+        emitClientDts(opts);
+        if (viteServer) {
+          const mod = viteServer.moduleGraph.getModuleById(RESOLVED_APP_CLIENT_ID);
+          if (mod) viteServer.moduleGraph.invalidateModule(mod);
+        }
+      } catch (err) {
+        console.error("[theokit:app-typed-client] codegen error:", err);
+      }
+    }, 100);
+  }
+  return {
+    name: "theokit:app-typed-client",
+    enforce: "post",
+    configResolved() {
+      try {
+        emitClientDts(opts);
+      } catch (err) {
+        console.error("[theokit:app-typed-client] initial codegen error:", err);
+      }
+    },
+    buildEnd() {
+      try {
+        emitClientDts(opts);
+      } catch (err) {
+        console.error("[theokit:app-typed-client] buildEnd codegen error:", err);
+      }
+    },
+    configureServer(server) {
+      viteServer = server;
+      const routesGlob = posix.join(opts.serverDir.replace(/\\/g, "/"), "routes");
+      const onFile = (file) => {
+        const normalized = file.replace(/\\/g, "/");
+        if (normalized.startsWith(routesGlob)) scheduleEmit();
+      };
+      server.watcher.on("add", onFile);
+      server.watcher.on("change", onFile);
+      server.watcher.on("unlink", onFile);
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_APP_CLIENT_ID) return RESOLVED_APP_CLIENT_ID;
+      return null;
+    },
+    load(id) {
+      if (id === RESOLVED_APP_CLIENT_ID) {
+        return [
+          `import { createAppClient } from 'theokit/client'`,
+          `export const client = createAppClient()`,
+          `export default client`,
+          ``
+        ].join("\n");
+      }
+      return null;
+    }
+  };
+}
+export {
+  RESOLVED_APP_CLIENT_ID,
+  VIRTUAL_APP_CLIENT_ID,
+  appTypedClientPlugin,
+  emitClientDts,
+  generateClientDts
+};
+//# sourceMappingURL=app-typed-client-6PAT6VOL.js.map