@meekojs/meeko 0.0.2 → 0.0.4

package/dist/framework/contracts-generate.js

@@ -0,0 +1,227 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import ts from "@typescript/typescript6";
+import { discoverServerManifest } from "../framework-server/discovery.js";
+import { generateSocketContracts } from "./socket-contracts-generate.js";
+async function writeIfChanged(file, source) {
+    try {
+        if (await readFile(file, "utf8") === source)
+            return;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    await writeFile(file, source, "utf8");
+}
+function inside(parent, child) {
+    const path = relative(parent, child);
+    return path === "" || (path !== ".." && !path.startsWith(`..${sep}`) && !isAbsolute(path));
+}
+function optionsFor(root) {
+    const config = ts.findConfigFile(root, ts.sys.fileExists, "tsconfig.json");
+    if (!config)
+        return { module: ts.ModuleKind.NodeNext, moduleResolution: ts.ModuleResolutionKind.NodeNext, target: ts.ScriptTarget.ES2022, skipLibCheck: true };
+    const loaded = ts.readConfigFile(config, ts.sys.readFile);
+    if (loaded.error)
+        throw new Error(ts.flattenDiagnosticMessageText(loaded.error.messageText, "\n"));
+    return ts.parseJsonConfigFileContent(loaded.config, ts.sys, dirname(config)).options;
+}
+function resolvedImport(specifier, importer, options) {
+    return ts.resolveModuleName(specifier, importer, options, ts.sys).resolvedModule?.resolvedFileName;
+}
+function importMap(file, sharedRoot, options) {
+    const imports = new Map();
+    for (const statement of file.statements) {
+        if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier))
+            continue;
+        const specifier = statement.moduleSpecifier.text;
+        const target = resolvedImport(specifier, file.fileName, options);
+        if (!target || !inside(sharedRoot, target))
+            continue;
+        const clause = statement.importClause;
+        if (!clause)
+            continue;
+        if (clause.name)
+            imports.set(clause.name.text, { file: target, exported: "default" });
+        if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) {
+            for (const element of clause.namedBindings.elements)
+                imports.set(element.name.text, { file: target, exported: element.propertyName?.text ?? element.name.text });
+        }
+        if (clause.namedBindings && ts.isNamespaceImport(clause.namedBindings))
+            imports.set(clause.namedBindings.name.text, { file: target, exported: "*" });
+    }
+    return imports;
+}
+function objectProperty(object, name) {
+    const property = object.properties.find((candidate) => {
+        if (!ts.isPropertyAssignment(candidate) && !ts.isShorthandPropertyAssignment(candidate))
+            return false;
+        return candidate.name.getText(object.getSourceFile()).replace(/^['"]|['"]$/g, "") === name;
+    });
+    if (!property)
+        return undefined;
+    if (ts.isPropertyAssignment(property))
+        return property.initializer;
+    return ts.isShorthandPropertyAssignment(property) ? property.name : undefined;
+}
+function definition(file, kind) {
+    const assignment = file.statements.find((statement) => ts.isExportAssignment(statement) && !statement.isExportEquals);
+    const expression = assignment?.expression;
+    const name = kind === "api" ? "defineApiRoute" : "defineRpc";
+    if (!expression || !ts.isCallExpression(expression) || !ts.isIdentifier(expression.expression) || expression.expression.text !== name || !expression.arguments[0] || !ts.isObjectLiteralExpression(expression.arguments[0])) {
+        throw new Error(`${file.fileName}: public ${kind.toUpperCase()} contract requires export default ${name}({...})`);
+    }
+    return expression.arguments[0];
+}
+function publicSchema(expression, label, file, imports, checker, root, sharedRoot, options, outputDir) {
+    if (!expression)
+        return undefined;
+    let local;
+    let member;
+    if (ts.isIdentifier(expression))
+        local = expression.text;
+    else if (ts.isPropertyAccessExpression(expression) && ts.isIdentifier(expression.expression)) {
+        local = expression.expression.text;
+        member = expression.name.text;
+    }
+    else
+        throw new Error(`${file.fileName}: ${label} must reference an imported shared schema`);
+    const imported = imports.get(local);
+    if (!imported)
+        throw new Error(`${file.fileName}: ${label} must come from shared/`);
+    const exported = imported.exported === "*" ? member : imported.exported;
+    if (!exported || (imported.exported !== "*" && member))
+        throw new Error(`${file.fileName}: ${label} must reference one shared export`);
+    const type = checker.getTypeAtLocation(expression);
+    if (type.flags & ts.TypeFlags.Any)
+        throw new Error(`${file.fileName}: ${label} has type any; public schema cannot be inferred`);
+    validateSharedGraph(imported.file, root, sharedRoot, options, new Set());
+    const target = relative(outputDir, imported.file).replaceAll("\\", "/").replace(/\.(?:ts|mts|cts)$/, (suffix) => suffix === ".mts" ? ".mjs" : suffix === ".cts" ? ".cjs" : ".js");
+    const specifier = target.startsWith(".") ? target : `./${target}`;
+    return `typeof import(${JSON.stringify(specifier)})[${JSON.stringify(exported)}]`;
+}
+function validateSharedGraph(file, root, sharedRoot, options, seen) {
+    if (seen.has(file))
+        return;
+    seen.add(file);
+    if (!inside(sharedRoot, file))
+        throw new Error(`${file}: public schema dependency escapes shared/`);
+    const source = ts.sys.readFile(file);
+    if (source === undefined)
+        throw new Error(`${file}: public schema dependency not found`);
+    const ast = ts.createSourceFile(file, source, ts.ScriptTarget.Latest, true);
+    const checkDependency = (specifier) => {
+        const target = resolvedImport(specifier, file, options);
+        if (!target)
+            throw new Error(`${file}: unresolved public schema dependency ${specifier}`);
+        if (inside(root, target) && !relative(root, target).split(sep).includes("node_modules"))
+            validateSharedGraph(target, root, sharedRoot, options, seen);
+    };
+    for (const statement of ast.statements) {
+        if (!ts.isImportDeclaration(statement) && !ts.isExportDeclaration(statement))
+            continue;
+        const literal = statement.moduleSpecifier;
+        if (!literal || !ts.isStringLiteral(literal))
+            continue;
+        checkDependency(literal.text);
+    }
+    const visit = (node) => {
+        if (ts.isImportTypeNode(node) && ts.isLiteralTypeNode(node.argument) && ts.isStringLiteral(node.argument.literal))
+            checkDependency(node.argument.literal.text);
+        ts.forEachChild(node, visit);
+    };
+    visit(ast);
+}
+function shapeFor(endpoint, checker, program, root, options, outputDir) {
+    const file = program.getSourceFile(endpoint.file);
+    if (!file)
+        throw new Error(`Handler not found: ${endpoint.file}`);
+    const sharedRoot = join(root, "shared");
+    const imports = importMap(file, sharedRoot, options);
+    const kind = endpoint.kind;
+    const contract = definition(file, kind);
+    const schema = (name) => publicSchema(objectProperty(contract, name), name, file, imports, checker, root, sharedRoot, options, outputDir);
+    if (kind === "rpc") {
+        const input = schema("input");
+        const output = schema("output");
+        if (!input || !output)
+            throw new Error(`${file.fileName}: RPC requires public input and output schemas`);
+        return { type: `import("@meekojs/meeko/framework").RpcOperation<__Input<${input}>, __Output<${output}>>` };
+    }
+    const params = schema("params");
+    const query = schema("query");
+    const body = schema("body");
+    const response = schema("response");
+    const content = objectProperty(contract, "contentType");
+    if (content && (!ts.isStringLiteral(content) || (content.text !== "json" && content.text !== "response")))
+        throw new Error(`${file.fileName}: contentType must be a static json or response literal`);
+    const responseType = content && ts.isStringLiteral(content) && content.text === "response";
+    if (!responseType && !response)
+        throw new Error(`${file.fileName}: API requires a public response schema`);
+    if (endpoint.pathname.includes("[") && !params)
+        throw new Error(`${file.fileName}: dynamic API path requires a public params schema`);
+    return {
+        type: `import("@meekojs/meeko/framework").ApiOperation<${params ? `__Input<${params}>` : "undefined"}, ${query ? `__Input<${query}>` : "undefined"}, ${body ? `__Input<${body}>` : "undefined"}, ${responseType ? "Response" : `__Output<${response}>`}>`,
+        ...(responseType ? { contentType: "response" } : {}),
+    };
+}
+/** Generate public API/RPC declarations without importing handler modules. */
+export async function generateServerContracts(projectRoot) {
+    const root = resolve(projectRoot);
+    await generateSocketContracts(root);
+    const discovered = await discoverServerManifest(root);
+    const outputDir = join(root, ".meeko", "types");
+    const types = join(outputDir, "server-contracts.d.ts");
+    const manifest = join(root, ".meeko", "manifests", "server.json");
+    const generatedDir = join(root, ".meeko", "generated");
+    const options = optionsFor(root);
+    const files = [...discovered.api, ...discovered.rpc].map((entry) => entry.file);
+    const program = ts.createProgram(files, { ...options, noEmit: true });
+    const checker = program.getTypeChecker();
+    const api = discovered.api.map((endpoint) => ({ endpoint, shape: shapeFor(endpoint, checker, program, root, options, outputDir) }));
+    const rpc = discovered.rpc.map((endpoint) => ({ endpoint, shape: shapeFor(endpoint, checker, program, root, options, outputDir) }));
+    const apiMethods = new Map();
+    for (const { endpoint, shape } of api) {
+        const methods = apiMethods.get(endpoint.clientKey) ?? [];
+        methods.push(`${endpoint.method.toLowerCase()}: ${shape.type}`);
+        apiMethods.set(endpoint.clientKey, methods);
+    }
+    const lines = [
+        "// Generated by Meeko. Public schemas must live in shared/.",
+        'type __Input<S> = S extends { readonly "~standard": { readonly types?: infer T } } ? NonNullable<T> extends { readonly input: infer I } ? I : never : never;',
+        'type __Output<S> = S extends { readonly "~standard": { readonly types?: infer T } } ? NonNullable<T> extends { readonly output: infer O } ? O : never : never;',
+        "export type ApiContract = {",
+        ...[...apiMethods].map(([key, methods]) => `  ${JSON.stringify(key)}: { ${methods.join("; ")} };`),
+        "};",
+        "export type RpcContract = {",
+        ...rpc.map(({ endpoint, shape }) => `  ${JSON.stringify(endpoint.id)}: ${shape.type};`),
+        "};",
+        "",
+    ];
+    await mkdir(outputDir, { recursive: true });
+    await mkdir(dirname(manifest), { recursive: true });
+    await writeIfChanged(types, lines.join("\n"));
+    const publicManifest = { version: 1, api: api.map(({ endpoint, shape }) => ({ clientKey: endpoint.clientKey, pathname: endpoint.pathname, method: endpoint.method, ...(shape.contentType ? { contentType: shape.contentType } : {}) })), rpc: rpc.map(({ endpoint }) => ({ id: endpoint.id, pathname: endpoint.pathname })) };
+    await writeIfChanged(manifest, `${JSON.stringify(publicManifest, null, 2)}\n`);
+    await mkdir(generatedDir, { recursive: true });
+    const clientSource = (server) => [
+        "// Generated by Meeko. Contains only public route descriptors and shared contract types.",
+        `import { createApiClient, createRpcClient${server ? "" : ", createBrowserClientOptions"} } from "@meekojs/meeko/framework";`,
+        'import { createSocketRegistry, useSocketChannel, type SocketRegistryOptions } from "@meekojs/meeko/framework";',
+        ...(server ? ['import { createServerClientOptions } from "@meekojs/meeko/server";'] : []),
+        'import type { ApiContract, RpcContract } from "../types/server-contracts.js";',
+        'import { socketContracts } from "./socket-contracts.js";',
+        `const manifest = ${JSON.stringify(publicManifest, null, 2)} as const;`,
+        `const options = ${server ? "createServerClientOptions()" : "createBrowserClientOptions()"};`,
+        "export const api = createApiClient<ApiContract>(manifest, options);",
+        "export const rpc = createRpcClient<RpcContract>(manifest, options);",
+        "export const socket = createSocketRegistry(socketContracts);",
+        "export const useSocket = <K extends keyof typeof socketContracts & string>(name: K, options?: SocketRegistryOptions) => useSocketChannel(socketContracts, name, options);",
+        "",
+    ].join("\n");
+    await writeIfChanged(join(generatedDir, "clients.client.ts"), clientSource(false));
+    await writeIfChanged(join(generatedDir, "clients.server.ts"), clientSource(true));
+    return { types, manifest, apiCount: api.length, rpcCount: rpc.length };
+}
+//# sourceMappingURL=contracts-generate.js.map

package/dist/framework/contracts-generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-generate.js","sourceRoot":"","sources":["../../src/framework/contracts-generate.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, isAbsolute, join, relative, resolve, sep } from \"node:path\";\nimport ts from \"@typescript/typescript6\";\nimport { discoverServerManifest } from \"../framework-server/discovery.js\";\nimport type { ApiEndpoint, RpcEndpoint } from \"../framework-server/discovery.js\";\nimport { generateSocketContracts } from \"./socket-contracts-generate.js\";\n\nexport interface GeneratedServerContracts {\n  readonly types: string;\n  readonly manifest: string;\n  readonly apiCount: number;\n  readonly rpcCount: number;\n}\n\nasync function writeIfChanged(file: string, source: string): Promise<void> {\n  try { if (await readFile(file, \"utf8\") === source) return; }\n  catch (error) { if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error; }\n  await writeFile(file, source, \"utf8\");\n}\n\ntype Kind = \"api\" | \"rpc\";\ntype Imports = Map<string, { file: string; exported: string }>;\n\nfunction inside(parent: string, child: string): boolean {\n  const path = relative(parent, child);\n  return path === \"\" || (path !== \"..\" && !path.startsWith(`..${sep}`) && !isAbsolute(path));\n}\n\nfunction optionsFor(root: string): ts.CompilerOptions {\n  const config = ts.findConfigFile(root, ts.sys.fileExists, \"tsconfig.json\");\n  if (!config) return { module: ts.ModuleKind.NodeNext, moduleResolution: ts.ModuleResolutionKind.NodeNext, target: ts.ScriptTarget.ES2022, skipLibCheck: true };\n  const loaded = ts.readConfigFile(config, ts.sys.readFile);\n  if (loaded.error) throw new Error(ts.flattenDiagnosticMessageText(loaded.error.messageText, \"\\n\"));\n  return ts.parseJsonConfigFileContent(loaded.config, ts.sys, dirname(config)).options;\n}\n\nfunction resolvedImport(specifier: string, importer: string, options: ts.CompilerOptions): string | undefined {\n  return ts.resolveModuleName(specifier, importer, options, ts.sys).resolvedModule?.resolvedFileName;\n}\n\nfunction importMap(file: ts.SourceFile, sharedRoot: string, options: ts.CompilerOptions): Imports {\n  const imports: Imports = new Map();\n  for (const statement of file.statements) {\n    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) continue;\n    const specifier = statement.moduleSpecifier.text;\n    const target = resolvedImport(specifier, file.fileName, options);\n    if (!target || !inside(sharedRoot, target)) continue;\n    const clause = statement.importClause;\n    if (!clause) continue;\n    if (clause.name) imports.set(clause.name.text, { file: target, exported: \"default\" });\n    if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) {\n      for (const element of clause.namedBindings.elements) imports.set(element.name.text, { file: target, exported: element.propertyName?.text ?? element.name.text });\n    }\n    if (clause.namedBindings && ts.isNamespaceImport(clause.namedBindings)) imports.set(clause.namedBindings.name.text, { file: target, exported: \"*\" });\n  }\n  return imports;\n}\n\nfunction objectProperty(object: ts.ObjectLiteralExpression, name: string): ts.Expression | undefined {\n  const property = object.properties.find((candidate) => {\n    if (!ts.isPropertyAssignment(candidate) && !ts.isShorthandPropertyAssignment(candidate)) return false;\n    return candidate.name.getText(object.getSourceFile()).replace(/^['\"]|['\"]$/g, \"\") === name;\n  });\n  if (!property) return undefined;\n  if (ts.isPropertyAssignment(property)) return property.initializer;\n  return ts.isShorthandPropertyAssignment(property) ? property.name : undefined;\n}\n\nfunction definition(file: ts.SourceFile, kind: Kind): ts.ObjectLiteralExpression {\n  const assignment = file.statements.find((statement): statement is ts.ExportAssignment => ts.isExportAssignment(statement) && !statement.isExportEquals);\n  const expression = assignment?.expression;\n  const name = kind === \"api\" ? \"defineApiRoute\" : \"defineRpc\";\n  if (!expression || !ts.isCallExpression(expression) || !ts.isIdentifier(expression.expression) || expression.expression.text !== name || !expression.arguments[0] || !ts.isObjectLiteralExpression(expression.arguments[0])) {\n    throw new Error(`${file.fileName}: public ${kind.toUpperCase()} contract requires export default ${name}({...})`);\n  }\n  return expression.arguments[0];\n}\n\nfunction publicSchema(expression: ts.Expression | undefined, label: string, file: ts.SourceFile, imports: Imports, checker: ts.TypeChecker, root: string, sharedRoot: string, options: ts.CompilerOptions, outputDir: string): string | undefined {\n  if (!expression) return undefined;\n  let local: string;\n  let member: string | undefined;\n  if (ts.isIdentifier(expression)) local = expression.text;\n  else if (ts.isPropertyAccessExpression(expression) && ts.isIdentifier(expression.expression)) { local = expression.expression.text; member = expression.name.text; }\n  else throw new Error(`${file.fileName}: ${label} must reference an imported shared schema`);\n  const imported = imports.get(local);\n  if (!imported) throw new Error(`${file.fileName}: ${label} must come from shared/`);\n  const exported = imported.exported === \"*\" ? member : imported.exported;\n  if (!exported || (imported.exported !== \"*\" && member)) throw new Error(`${file.fileName}: ${label} must reference one shared export`);\n  const type = checker.getTypeAtLocation(expression);\n  if (type.flags & ts.TypeFlags.Any) throw new Error(`${file.fileName}: ${label} has type any; public schema cannot be inferred`);\n  validateSharedGraph(imported.file, root, sharedRoot, options, new Set());\n  const target = relative(outputDir, imported.file).replaceAll(\"\\\\\", \"/\").replace(/\\.(?:ts|mts|cts)$/, (suffix) => suffix === \".mts\" ? \".mjs\" : suffix === \".cts\" ? \".cjs\" : \".js\");\n  const specifier = target.startsWith(\".\") ? target : `./${target}`;\n  return `typeof import(${JSON.stringify(specifier)})[${JSON.stringify(exported)}]`;\n}\n\nfunction validateSharedGraph(file: string, root: string, sharedRoot: string, options: ts.CompilerOptions, seen: Set<string>): void {\n  if (seen.has(file)) return;\n  seen.add(file);\n  if (!inside(sharedRoot, file)) throw new Error(`${file}: public schema dependency escapes shared/`);\n  const source = ts.sys.readFile(file);\n  if (source === undefined) throw new Error(`${file}: public schema dependency not found`);\n  const ast = ts.createSourceFile(file, source, ts.ScriptTarget.Latest, true);\n  const checkDependency = (specifier: string): void => {\n    const target = resolvedImport(specifier, file, options);\n    if (!target) throw new Error(`${file}: unresolved public schema dependency ${specifier}`);\n    if (inside(root, target) && !relative(root, target).split(sep).includes(\"node_modules\")) validateSharedGraph(target, root, sharedRoot, options, seen);\n  };\n  for (const statement of ast.statements) {\n    if (!ts.isImportDeclaration(statement) && !ts.isExportDeclaration(statement)) continue;\n    const literal = statement.moduleSpecifier;\n    if (!literal || !ts.isStringLiteral(literal)) continue;\n    checkDependency(literal.text);\n  }\n  const visit = (node: ts.Node): void => {\n    if (ts.isImportTypeNode(node) && ts.isLiteralTypeNode(node.argument) && ts.isStringLiteral(node.argument.literal)) checkDependency(node.argument.literal.text);\n    ts.forEachChild(node, visit);\n  };\n  visit(ast);\n}\n\nfunction shapeFor(endpoint: ApiEndpoint | RpcEndpoint, checker: ts.TypeChecker, program: ts.Program, root: string, options: ts.CompilerOptions, outputDir: string): { type: string; contentType?: \"response\" } {\n  const file = program.getSourceFile(endpoint.file);\n  if (!file) throw new Error(`Handler not found: ${endpoint.file}`);\n  const sharedRoot = join(root, \"shared\");\n  const imports = importMap(file, sharedRoot, options);\n  const kind: Kind = endpoint.kind;\n  const contract = definition(file, kind);\n  const schema = (name: string): string | undefined => publicSchema(objectProperty(contract, name), name, file, imports, checker, root, sharedRoot, options, outputDir);\n  if (kind === \"rpc\") {\n    const input = schema(\"input\");\n    const output = schema(\"output\");\n    if (!input || !output) throw new Error(`${file.fileName}: RPC requires public input and output schemas`);\n    return { type: `import(\"@meekojs/meeko/framework\").RpcOperation<__Input<${input}>, __Output<${output}>>` };\n  }\n  const params = schema(\"params\");\n  const query = schema(\"query\");\n  const body = schema(\"body\");\n  const response = schema(\"response\");\n  const content = objectProperty(contract, \"contentType\");\n  if (content && (!ts.isStringLiteral(content) || (content.text !== \"json\" && content.text !== \"response\"))) throw new Error(`${file.fileName}: contentType must be a static json or response literal`);\n  const responseType = content && ts.isStringLiteral(content) && content.text === \"response\";\n  if (!responseType && !response) throw new Error(`${file.fileName}: API requires a public response schema`);\n  if (endpoint.pathname.includes(\"[\") && !params) throw new Error(`${file.fileName}: dynamic API path requires a public params schema`);\n  return {\n    type: `import(\"@meekojs/meeko/framework\").ApiOperation<${params ? `__Input<${params}>` : \"undefined\"}, ${query ? `__Input<${query}>` : \"undefined\"}, ${body ? `__Input<${body}>` : \"undefined\"}, ${responseType ? \"Response\" : `__Output<${response}>`}>`,\n    ...(responseType ? { contentType: \"response\" as const } : {}),\n  };\n}\n\n/** Generate public API/RPC declarations without importing handler modules. */\nexport async function generateServerContracts(projectRoot: string): Promise<GeneratedServerContracts> {\n  const root = resolve(projectRoot);\n  await generateSocketContracts(root);\n  const discovered = await discoverServerManifest(root);\n  const outputDir = join(root, \".meeko\", \"types\");\n  const types = join(outputDir, \"server-contracts.d.ts\");\n  const manifest = join(root, \".meeko\", \"manifests\", \"server.json\");\n  const generatedDir = join(root, \".meeko\", \"generated\");\n  const options = optionsFor(root);\n  const files = [...discovered.api, ...discovered.rpc].map((entry) => entry.file);\n  const program = ts.createProgram(files, { ...options, noEmit: true });\n  const checker = program.getTypeChecker();\n  const api = discovered.api.map((endpoint) => ({ endpoint, shape: shapeFor(endpoint, checker, program, root, options, outputDir) }));\n  const rpc = discovered.rpc.map((endpoint) => ({ endpoint, shape: shapeFor(endpoint, checker, program, root, options, outputDir) }));\n  const apiMethods = new Map<string, string[]>();\n  for (const { endpoint, shape } of api) {\n    const methods = apiMethods.get(endpoint.clientKey) ?? [];\n    methods.push(`${endpoint.method.toLowerCase()}: ${shape.type}`);\n    apiMethods.set(endpoint.clientKey, methods);\n  }\n  const lines = [\n    \"// Generated by Meeko. Public schemas must live in shared/.\",\n    'type __Input<S> = S extends { readonly \"~standard\": { readonly types?: infer T } } ? NonNullable<T> extends { readonly input: infer I } ? I : never : never;',\n    'type __Output<S> = S extends { readonly \"~standard\": { readonly types?: infer T } } ? NonNullable<T> extends { readonly output: infer O } ? O : never : never;',\n    \"export type ApiContract = {\",\n    ...[...apiMethods].map(([key, methods]) => `  ${JSON.stringify(key)}: { ${methods.join(\"; \")} };`),\n    \"};\",\n    \"export type RpcContract = {\",\n    ...rpc.map(({ endpoint, shape }) => `  ${JSON.stringify(endpoint.id)}: ${shape.type};`),\n    \"};\",\n    \"\",\n  ];\n  await mkdir(outputDir, { recursive: true });\n  await mkdir(dirname(manifest), { recursive: true });\n  await writeIfChanged(types, lines.join(\"\\n\"));\n  const publicManifest = { version: 1, api: api.map(({ endpoint, shape }) => ({ clientKey: endpoint.clientKey, pathname: endpoint.pathname, method: endpoint.method, ...(shape.contentType ? { contentType: shape.contentType } : {}) })), rpc: rpc.map(({ endpoint }) => ({ id: endpoint.id, pathname: endpoint.pathname })) };\n  await writeIfChanged(manifest, `${JSON.stringify(publicManifest, null, 2)}\\n`);\n  await mkdir(generatedDir, { recursive: true });\n  const clientSource = (server: boolean): string => [\n    \"// Generated by Meeko. Contains only public route descriptors and shared contract types.\",\n    `import { createApiClient, createRpcClient${server ? \"\" : \", createBrowserClientOptions\"} } from \"@meekojs/meeko/framework\";`,\n    'import { createSocketRegistry, useSocketChannel, type SocketRegistryOptions } from \"@meekojs/meeko/framework\";',\n    ...(server ? ['import { createServerClientOptions } from \"@meekojs/meeko/server\";'] : []),\n    'import type { ApiContract, RpcContract } from \"../types/server-contracts.js\";',\n    'import { socketContracts } from \"./socket-contracts.js\";',\n    `const manifest = ${JSON.stringify(publicManifest, null, 2)} as const;`,\n    `const options = ${server ? \"createServerClientOptions()\" : \"createBrowserClientOptions()\"};`,\n    \"export const api = createApiClient<ApiContract>(manifest, options);\",\n    \"export const rpc = createRpcClient<RpcContract>(manifest, options);\",\n    \"export const socket = createSocketRegistry(socketContracts);\",\n    \"export const useSocket = <K extends keyof typeof socketContracts & string>(name: K, options?: SocketRegistryOptions) => useSocketChannel(socketContracts, name, options);\",\n    \"\",\n  ].join(\"\\n\");\n  await writeIfChanged(join(generatedDir, \"clients.client.ts\"), clientSource(false));\n  await writeIfChanged(join(generatedDir, \"clients.server.ts\"), clientSource(true));\n  return { types, manifest, apiCount: api.length, rpcCount: rpc.length };\n}\n"]}

package/dist/framework/generate.d.ts

@@ -0,0 +1,7 @@
+export interface GeneratedRouteFiles {
+    readonly types: string;
+    readonly manifest: string;
+    readonly count: number;
+}
+/** Generates public route types and a portable manifest from one route discovery pass. */
+export declare function generateRoutes(projectRoot: string): Promise<GeneratedRouteFiles>;

package/dist/framework/generate.js

@@ -0,0 +1,67 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { discoverConfiguredRoutes } from "./config.js";
+function paramsFor(id) {
+    const params = [];
+    for (const part of id.split("/").filter(Boolean)) {
+        const match = /^\[(?:\.\.\.)?([A-Za-z_$][\w$]*)\]$/.exec(part);
+        if (!match)
+            continue;
+        const name = match[1];
+        if (params.includes(name))
+            throw new Error(`Duplicate route parameter ${name} in ${id}`);
+        params.push(name);
+    }
+    return params;
+}
+function portable(root, file) {
+    const path = relative(root, file).replaceAll("\\", "/");
+    if (path.startsWith("../") || path === "..")
+        throw new Error(`Route file escapes project root: ${file}`);
+    return path;
+}
+/** Generates public route types and a portable manifest from one route discovery pass. */
+export async function generateRoutes(projectRoot) {
+    const root = resolve(projectRoot);
+    const routes = await discoverConfiguredRoutes(root);
+    const types = join(root, ".meeko", "types", "routes.d.ts");
+    const manifest = join(root, ".meeko", "manifests", "routes.json");
+    const virtualTypes = join(root, ".meeko", "types", "virtual-pages.d.ts");
+    const lines = routes.map((route) => {
+        const params = paramsFor(route.id);
+        const shape = params.length ? `{ ${params.map((param) => `${JSON.stringify(param)}: string`).join("; ")} }` : "Record<never, never>";
+        return `    ${JSON.stringify(route.id)}: ${shape};`;
+    });
+    const declarations = [
+        "// Generated by Meeko. Edit app/pages instead.",
+        'import "@meekojs/meeko/framework";',
+        'declare module "@meekojs/meeko/framework" {',
+        "  interface GeneratedRoutes {",
+        ...lines,
+        "  }",
+        "}",
+        `export type RouteId = ${routes.length ? routes.map((route) => JSON.stringify(route.id)).join(" | ") : "never"};`,
+        'export type RouteParams<Id extends RouteId> = import("@meekojs/meeko/framework").GeneratedRoutes[Id];',
+        "export {};",
+        "",
+    ].join("\n");
+    const portableRoutes = routes.map((route) => ({
+        id: route.id,
+        file: portable(root, route.file),
+        layouts: route.layouts.map((layout) => portable(root, layout)),
+        ...(route.error ? { error: portable(root, route.error) } : {}),
+        ...(route.sidecar ? { sidecar: portable(root, route.sidecar) } : {}),
+    }));
+    await mkdir(join(root, ".meeko", "types"), { recursive: true });
+    await mkdir(join(root, ".meeko", "manifests"), { recursive: true });
+    await writeFile(types, declarations, "utf8");
+    await writeFile(virtualTypes, [
+        'declare module "virtual:meeko-client-pages" { export const modules: Record<string, () => Promise<unknown>>; }',
+        'declare module "virtual:meeko-server-pages" { export const modules: Record<string, unknown>; }',
+        'declare module "virtual:meeko-server-routes" { export const modules: Record<string, unknown>; }',
+        "",
+    ].join("\n"), "utf8");
+    await writeFile(manifest, `${JSON.stringify({ version: 1, routes: portableRoutes }, null, 2)}\n`, "utf8");
+    return { types, manifest, count: routes.length };
+}
+//# sourceMappingURL=generate.js.map

package/dist/framework/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/framework/generate.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { join, relative, resolve } from \"node:path\";\nimport { discoverConfiguredRoutes } from \"./config.js\";\n\nexport interface GeneratedRouteFiles {\n  readonly types: string;\n  readonly manifest: string;\n  readonly count: number;\n}\n\nfunction paramsFor(id: string): readonly string[] {\n  const params: string[] = [];\n  for (const part of id.split(\"/\").filter(Boolean)) {\n    const match = /^\\[(?:\\.\\.\\.)?([A-Za-z_$][\\w$]*)\\]$/.exec(part);\n    if (!match) continue;\n    const name = match[1]!;\n    if (params.includes(name)) throw new Error(`Duplicate route parameter ${name} in ${id}`);\n    params.push(name);\n  }\n  return params;\n}\n\nfunction portable(root: string, file: string): string {\n  const path = relative(root, file).replaceAll(\"\\\\\", \"/\");\n  if (path.startsWith(\"../\") || path === \"..\") throw new Error(`Route file escapes project root: ${file}`);\n  return path;\n}\n\n/** Generates public route types and a portable manifest from one route discovery pass. */\nexport async function generateRoutes(projectRoot: string): Promise<GeneratedRouteFiles> {\n  const root = resolve(projectRoot);\n  const routes = await discoverConfiguredRoutes(root);\n  const types = join(root, \".meeko\", \"types\", \"routes.d.ts\");\n  const manifest = join(root, \".meeko\", \"manifests\", \"routes.json\");\n  const virtualTypes = join(root, \".meeko\", \"types\", \"virtual-pages.d.ts\");\n  const lines = routes.map((route) => {\n    const params = paramsFor(route.id);\n    const shape = params.length ? `{ ${params.map((param) => `${JSON.stringify(param)}: string`).join(\"; \")} }` : \"Record<never, never>\";\n    return `    ${JSON.stringify(route.id)}: ${shape};`;\n  });\n  const declarations = [\n    \"// Generated by Meeko. Edit app/pages instead.\",\n    'import \"@meekojs/meeko/framework\";',\n    'declare module \"@meekojs/meeko/framework\" {',\n    \"  interface GeneratedRoutes {\",\n    ...lines,\n    \"  }\",\n    \"}\",\n    `export type RouteId = ${routes.length ? routes.map((route) => JSON.stringify(route.id)).join(\" | \") : \"never\"};`,\n    'export type RouteParams<Id extends RouteId> = import(\"@meekojs/meeko/framework\").GeneratedRoutes[Id];',\n    \"export {};\",\n    \"\",\n  ].join(\"\\n\");\n  const portableRoutes = routes.map((route) => ({\n    id: route.id,\n    file: portable(root, route.file),\n    layouts: route.layouts.map((layout) => portable(root, layout)),\n    ...(route.error ? { error: portable(root, route.error) } : {}),\n    ...(route.sidecar ? { sidecar: portable(root, route.sidecar) } : {}),\n  }));\n  await mkdir(join(root, \".meeko\", \"types\"), { recursive: true });\n  await mkdir(join(root, \".meeko\", \"manifests\"), { recursive: true });\n  await writeFile(types, declarations, \"utf8\");\n  await writeFile(virtualTypes, [\n    'declare module \"virtual:meeko-client-pages\" { export const modules: Record<string, () => Promise<unknown>>; }',\n    'declare module \"virtual:meeko-server-pages\" { export const modules: Record<string, unknown>; }',\n    'declare module \"virtual:meeko-server-routes\" { export const modules: Record<string, unknown>; }',\n    \"\",\n  ].join(\"\\n\"), \"utf8\");\n  await writeFile(manifest, `${JSON.stringify({ version: 1, routes: portableRoutes }, null, 2)}\\n`, \"utf8\");\n  return { types, manifest, count: routes.length };\n}\n"]}

package/dist/framework/init.d.ts

@@ -0,0 +1,2 @@
+/** Creates a framework project without overwriting unrelated user files. */
+export declare function initFrameworkProject(directory: string): Promise<string>;