@meekojs/meeko 0.0.2 → 0.0.4

package/dist/framework/clients.d.ts

@@ -0,0 +1,82 @@
+/** Public descriptors intentionally omit handler files and server schemas. */
+export interface PublicApiEndpoint {
+    readonly clientKey: string;
+    readonly pathname: string;
+    readonly method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    readonly contentType?: "json" | "response";
+}
+export interface PublicRpcEndpoint {
+    readonly id: string;
+    readonly pathname: string;
+}
+export interface PublicServerManifest {
+    readonly api: readonly PublicApiEndpoint[];
+    readonly rpc: readonly PublicRpcEndpoint[];
+}
+/** Strips private handler paths before serializing a discovered server manifest. */
+export declare function createPublicServerManifest(manifest: PublicServerManifest): PublicServerManifest;
+/** Type-only operation declarations can be inferred from public shared schemas. */
+export interface ApiOperation<Params = undefined, Query = undefined, Body = undefined, Output = unknown> {
+    readonly params: Params;
+    readonly query: Query;
+    readonly body: Body;
+    readonly output: Output;
+}
+export interface RpcOperation<Input = unknown, Output = unknown> {
+    readonly input: Input;
+    readonly output: Output;
+}
+type AnyApiOperation = ApiOperation<unknown, unknown, unknown, unknown>;
+type RequestOptions = {
+    readonly signal?: AbortSignal;
+};
+type ParamOption<T> = T extends undefined ? {
+    readonly params?: never;
+} : {
+    readonly params: T;
+};
+type QueryOption<T> = T extends undefined ? {
+    readonly query?: never;
+} : {
+    readonly query: T;
+};
+type BodyOption<T> = T extends undefined ? {
+    readonly body?: never;
+} : {
+    readonly body: T;
+};
+type ApiArguments<O extends AnyApiOperation> = O["params"] extends undefined ? O["query"] extends undefined ? O["body"] extends undefined ? [options?: ParamOption<O["params"]> & QueryOption<O["query"]> & BodyOption<O["body"]> & RequestOptions] : [options: ParamOption<O["params"]> & QueryOption<O["query"]> & BodyOption<O["body"]> & RequestOptions] : [options: ParamOption<O["params"]> & QueryOption<O["query"]> & BodyOption<O["body"]> & RequestOptions] : [options: ParamOption<O["params"]> & QueryOption<O["query"]> & BodyOption<O["body"]> & RequestOptions];
+type Nest<Path extends string, Value> = Path extends `${infer Head}.${infer Tail}` ? {
+    [K in Head]: Nest<Tail, Value>;
+} : {
+    [K in Path]: Value;
+};
+type Intersection<Union> = (Union extends unknown ? (value: Union) => void : never) extends (value: infer Result) => void ? Result : never;
+type ApiMethods<Operations> = {
+    [Method in keyof Operations]: Operations[Method] extends AnyApiOperation ? (...args: ApiArguments<Operations[Method]>) => Promise<Operations[Method]["output"]> : never;
+};
+export type ApiClient<Contract extends Record<string, Record<string, AnyApiOperation>>> = Intersection<{
+    [Key in keyof Contract & string]: Nest<Key, ApiMethods<Contract[Key]>>;
+}[keyof Contract & string]>;
+export type RpcClient<Contract extends Record<string, RpcOperation>> = Intersection<{
+    [Key in keyof Contract & string]: Nest<Key, (input: Contract[Key]["input"], options?: RequestOptions) => Promise<Contract[Key]["output"]>>;
+}[keyof Contract & string]>;
+export declare class ClientError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly requestId?: string | undefined;
+    constructor(code: string, status: number, requestId?: string | undefined);
+}
+export interface ClientOptions {
+    readonly baseUrl?: string | (() => string);
+    readonly fetch?: typeof fetch;
+    readonly csrfToken?: string | (() => string | undefined);
+    readonly headers?: HeadersInit | (() => HeadersInit);
+}
+/** Reads the current document token at call time, including after client navigation. */
+export declare function createBrowserClientOptions(): ClientOptions;
+/** Creates browser API methods from public endpoint paths, without server imports. */
+export declare function createApiClient<Contract extends Record<string, Record<string, AnyApiOperation>>>(manifest: Pick<PublicServerManifest, "api">, options?: ClientOptions): ApiClient<Contract>;
+/** Creates browser RPC procedures from public endpoint paths. */
+export declare function createRpcClient<Contract extends Record<string, RpcOperation>>(manifest: Pick<PublicServerManifest, "rpc">, options?: ClientOptions): RpcClient<Contract>;
+export {};

package/dist/framework/clients.js

@@ -0,0 +1,182 @@
+/** Strips private handler paths before serializing a discovered server manifest. */
+export function createPublicServerManifest(manifest) {
+    return {
+        api: manifest.api.map(({ clientKey, pathname, method, contentType }) => ({
+            clientKey, pathname, method, ...(contentType ? { contentType } : {}),
+        })),
+        rpc: manifest.rpc.map(({ id, pathname }) => ({ id, pathname })),
+    };
+}
+export class ClientError extends Error {
+    code;
+    status;
+    requestId;
+    constructor(code, status, requestId) {
+        super(code);
+        this.code = code;
+        this.status = status;
+        this.requestId = requestId;
+        this.name = "ClientError";
+    }
+}
+/** Reads the current document token at call time, including after client navigation. */
+export function createBrowserClientOptions() {
+    return {
+        csrfToken: () => typeof document === "undefined"
+            ? undefined
+            : document.querySelector('meta[name="meeko-csrf-token"]')?.getAttribute("content") ?? undefined,
+        fetch: async (input, init) => {
+            const response = await fetch(input, init);
+            const token = response.headers.get("x-meeko-csrf-token");
+            if (token && typeof document !== "undefined") {
+                let meta = document.querySelector('meta[name="meeko-csrf-token"]');
+                if (!meta) {
+                    meta = document.createElement("meta");
+                    meta.setAttribute("name", "meeko-csrf-token");
+                    document.head.append(meta);
+                }
+                meta.setAttribute("content", token);
+            }
+            return response;
+        },
+    };
+}
+function pathWithParams(pathname, params = {}) {
+    const used = new Set();
+    const path = pathname.replace(/\[(\.\.\.)?([A-Za-z_$][\w$]*)\]/g, (_match, rest, name) => {
+        const value = params[name];
+        if (!value)
+            throw new TypeError(`Missing route parameter: ${name}`);
+        used.add(name);
+        const parts = rest ? value.split("/") : [value];
+        if (parts.some((part) => !part || part === "." || part === ".." || part.includes("/") || part.includes("\\")))
+            throw new TypeError(`Invalid route parameter: ${name}`);
+        return parts.map(encodeURIComponent).join("/");
+    });
+    for (const key of Object.keys(params))
+        if (!used.has(key))
+            throw new TypeError(`Unknown route parameter: ${key}`);
+    return path;
+}
+function queryString(query) {
+    if (!query)
+        return "";
+    const search = new URLSearchParams();
+    for (const [key, raw] of Object.entries(query)) {
+        for (const value of Array.isArray(raw) ? raw : [raw]) {
+            if (value !== null && value !== undefined)
+                search.append(key, String(value));
+        }
+    }
+    const result = search.toString();
+    return result ? `?${result}` : "";
+}
+async function responseValue(response, contentType = "json") {
+    if (!response.ok) {
+        let payload;
+        try {
+            payload = await response.json();
+        }
+        catch { /* Bad error bodies still produce a normalized error. */ }
+        const record = payload && typeof payload === "object" ? payload : {};
+        const code = typeof record.code === "string" ? record.code : "HTTP_ERROR";
+        const requestId = typeof record.requestId === "string" ? record.requestId : response.headers.get("x-request-id") ?? undefined;
+        throw new ClientError(code, response.status, requestId);
+    }
+    if (contentType === "response")
+        return response;
+    if (response.status === 204)
+        return undefined;
+    try {
+        return await response.json();
+    }
+    catch {
+        throw new ClientError("INVALID_RESPONSE", response.status, response.headers.get("x-request-id") ?? undefined);
+    }
+}
+function endpointUrl(pathname, options) {
+    const baseUrl = typeof options.baseUrl === "function" ? options.baseUrl() : options.baseUrl;
+    return baseUrl ? new URL(pathname, baseUrl).toString() : pathname;
+}
+function headersFor(options, method, json) {
+    const headers = new Headers(typeof options.headers === "function" ? options.headers() : options.headers);
+    if (json)
+        headers.set("content-type", "application/json");
+    if (method !== "GET" && method !== "HEAD") {
+        const csrf = typeof options.csrfToken === "function" ? options.csrfToken() : options.csrfToken;
+        if (csrf)
+            headers.set("x-meeko-csrf", csrf);
+    }
+    return headers;
+}
+function insert(root, key, value) {
+    const parts = key.split(".");
+    if (parts.some((part) => !/^[A-Za-z_$][\w$]*$/.test(part)))
+        throw new TypeError(`Invalid client key: ${key}`);
+    let node = root;
+    for (const part of parts.slice(0, -1)) {
+        const existing = node[part];
+        if (existing === undefined)
+            node[part] = Object.create(null);
+        else if (!existing || typeof existing !== "object")
+            throw new TypeError(`Client key collision: ${key}`);
+        node = node[part];
+    }
+    const last = parts.at(-1);
+    if (node[last] !== undefined)
+        throw new TypeError(`Client key collision: ${key}`);
+    node[last] = value;
+}
+function ensureObject(root, key) {
+    const parts = key.split(".");
+    if (parts.some((part) => !/^[A-Za-z_$][\w$]*$/.test(part)))
+        throw new TypeError(`Invalid client key: ${key}`);
+    let node = root;
+    for (const part of parts) {
+        const existing = node[part];
+        if (existing === undefined)
+            node[part] = Object.create(null);
+        else if (!existing || typeof existing !== "object")
+            throw new TypeError(`Client key collision: ${key}`);
+        node = node[part];
+    }
+    return node;
+}
+/** Creates browser API methods from public endpoint paths, without server imports. */
+export function createApiClient(manifest, options = {}) {
+    const root = Object.create(null);
+    for (const endpoint of manifest.api) {
+        const methods = ensureObject(root, endpoint.clientKey);
+        const method = endpoint.method.toLowerCase();
+        if (methods[method])
+            throw new TypeError(`Duplicate API method: ${endpoint.clientKey}.${method}`);
+        methods[method] = async (input = {}) => {
+            const path = pathWithParams(endpoint.pathname, input.params) + queryString(input.query);
+            const url = endpointUrl(path, options);
+            const fetcher = options.fetch ?? fetch;
+            const response = await fetcher(url, {
+                method: endpoint.method, headers: headersFor(options, endpoint.method, input.body !== undefined),
+                credentials: "same-origin", ...(input.body === undefined ? {} : { body: JSON.stringify(input.body) }),
+                ...(input.signal ? { signal: input.signal } : {}),
+            });
+            return responseValue(response, endpoint.contentType);
+        };
+    }
+    return root;
+}
+/** Creates browser RPC procedures from public endpoint paths. */
+export function createRpcClient(manifest, options = {}) {
+    const root = Object.create(null);
+    for (const endpoint of manifest.rpc) {
+        insert(root, endpoint.id, async (input, request = {}) => {
+            const fetcher = options.fetch ?? fetch;
+            const response = await fetcher(endpointUrl(endpoint.pathname, options), {
+                method: "POST", headers: headersFor(options, "POST", true), credentials: "same-origin",
+                body: JSON.stringify(input), ...(request.signal ? { signal: request.signal } : {}),
+            });
+            return responseValue(response);
+        });
+    }
+    return root;
+}
+//# sourceMappingURL=clients.js.map

package/dist/framework/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/framework/clients.ts"],"names":[],"mappings":"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","sourcesContent":["/** Public descriptors intentionally omit handler files and server schemas. */\nexport interface PublicApiEndpoint {\n  readonly clientKey: string;\n  readonly pathname: string;\n  readonly method: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n  readonly contentType?: \"json\" | \"response\";\n}\n\nexport interface PublicRpcEndpoint {\n  readonly id: string;\n  readonly pathname: string;\n}\n\nexport interface PublicServerManifest {\n  readonly api: readonly PublicApiEndpoint[];\n  readonly rpc: readonly PublicRpcEndpoint[];\n}\n\n/** Strips private handler paths before serializing a discovered server manifest. */\nexport function createPublicServerManifest(manifest: PublicServerManifest): PublicServerManifest {\n  return {\n    api: manifest.api.map(({ clientKey, pathname, method, contentType }) => ({\n      clientKey, pathname, method, ...(contentType ? { contentType } : {}),\n    })),\n    rpc: manifest.rpc.map(({ id, pathname }) => ({ id, pathname })),\n  };\n}\n\n/** Type-only operation declarations can be inferred from public shared schemas. */\nexport interface ApiOperation<Params = undefined, Query = undefined, Body = undefined, Output = unknown> {\n  readonly params: Params;\n  readonly query: Query;\n  readonly body: Body;\n  readonly output: Output;\n}\n\nexport interface RpcOperation<Input = unknown, Output = unknown> {\n  readonly input: Input;\n  readonly output: Output;\n}\n\ntype AnyApiOperation = ApiOperation<unknown, unknown, unknown, unknown>;\n\ntype SearchValue = string | number | boolean | null | undefined;\ntype QueryValue = SearchValue | readonly SearchValue[];\ntype RequestOptions = { readonly signal?: AbortSignal };\ntype ParamOption<T> = T extends undefined ? { readonly params?: never } : { readonly params: T };\ntype QueryOption<T> = T extends undefined ? { readonly query?: never } : { readonly query: T };\ntype BodyOption<T> = T extends undefined ? { readonly body?: never } : { readonly body: T };\ntype ApiArguments<O extends AnyApiOperation> = O[\"params\"] extends undefined\n  ? O[\"query\"] extends undefined\n    ? O[\"body\"] extends undefined ? [options?: ParamOption<O[\"params\"]> & QueryOption<O[\"query\"]> & BodyOption<O[\"body\"]> & RequestOptions] : [options: ParamOption<O[\"params\"]> & QueryOption<O[\"query\"]> & BodyOption<O[\"body\"]> & RequestOptions]\n    : [options: ParamOption<O[\"params\"]> & QueryOption<O[\"query\"]> & BodyOption<O[\"body\"]> & RequestOptions]\n  : [options: ParamOption<O[\"params\"]> & QueryOption<O[\"query\"]> & BodyOption<O[\"body\"]> & RequestOptions];\ntype Nest<Path extends string, Value> = Path extends `${infer Head}.${infer Tail}` ? { [K in Head]: Nest<Tail, Value> } : { [K in Path]: Value };\ntype Intersection<Union> = (Union extends unknown ? (value: Union) => void : never) extends (value: infer Result) => void ? Result : never;\ntype ApiMethods<Operations> = { [Method in keyof Operations]: Operations[Method] extends AnyApiOperation\n  ? (...args: ApiArguments<Operations[Method]>) => Promise<Operations[Method][\"output\"]>\n  : never };\nexport type ApiClient<Contract extends Record<string, Record<string, AnyApiOperation>>> = Intersection<{\n  [Key in keyof Contract & string]: Nest<Key, ApiMethods<Contract[Key]>>\n}[keyof Contract & string]>;\nexport type RpcClient<Contract extends Record<string, RpcOperation>> = Intersection<{\n  [Key in keyof Contract & string]: Nest<Key, (input: Contract[Key][\"input\"], options?: RequestOptions) => Promise<Contract[Key][\"output\"]>>\n}[keyof Contract & string]>;\n\nexport class ClientError extends Error {\n  constructor(public readonly code: string, public readonly status: number, public readonly requestId?: string) {\n    super(code);\n    this.name = \"ClientError\";\n  }\n}\n\nexport interface ClientOptions {\n  readonly baseUrl?: string | (() => string);\n  readonly fetch?: typeof fetch;\n  readonly csrfToken?: string | (() => string | undefined);\n  readonly headers?: HeadersInit | (() => HeadersInit);\n}\n\n/** Reads the current document token at call time, including after client navigation. */\nexport function createBrowserClientOptions(): ClientOptions {\n  return {\n    csrfToken: () => typeof document === \"undefined\"\n      ? undefined\n      : document.querySelector('meta[name=\"meeko-csrf-token\"]')?.getAttribute(\"content\") ?? undefined,\n    fetch: async (input, init) => {\n      const response = await fetch(input, init);\n      const token = response.headers.get(\"x-meeko-csrf-token\");\n      if (token && typeof document !== \"undefined\") {\n        let meta = document.querySelector('meta[name=\"meeko-csrf-token\"]');\n        if (!meta) {\n          meta = document.createElement(\"meta\");\n          meta.setAttribute(\"name\", \"meeko-csrf-token\");\n          document.head.append(meta);\n        }\n        meta.setAttribute(\"content\", token);\n      }\n      return response;\n    },\n  };\n}\n\nfunction pathWithParams(pathname: string, params: Readonly<Record<string, string>> = {}): string {\n  const used = new Set<string>();\n  const path = pathname.replace(/\\[(\\.\\.\\.)?([A-Za-z_$][\\w$]*)\\]/g, (_match, rest: string | undefined, name: string) => {\n    const value = params[name];\n    if (!value) throw new TypeError(`Missing route parameter: ${name}`);\n    used.add(name);\n    const parts = rest ? value.split(\"/\") : [value];\n    if (parts.some((part) => !part || part === \".\" || part === \"..\" || part.includes(\"/\") || part.includes(\"\\\\\"))) throw new TypeError(`Invalid route parameter: ${name}`);\n    return parts.map(encodeURIComponent).join(\"/\");\n  });\n  for (const key of Object.keys(params)) if (!used.has(key)) throw new TypeError(`Unknown route parameter: ${key}`);\n  return path;\n}\n\nfunction queryString(query: Readonly<Record<string, QueryValue>> | undefined): string {\n  if (!query) return \"\";\n  const search = new URLSearchParams();\n  for (const [key, raw] of Object.entries(query)) {\n    for (const value of Array.isArray(raw) ? raw : [raw]) {\n      if (value !== null && value !== undefined) search.append(key, String(value));\n    }\n  }\n  const result = search.toString();\n  return result ? `?${result}` : \"\";\n}\n\nasync function responseValue(response: Response, contentType: \"json\" | \"response\" = \"json\"): Promise<unknown> {\n  if (!response.ok) {\n    let payload: unknown;\n    try { payload = await response.json(); } catch { /* Bad error bodies still produce a normalized error. */ }\n    const record = payload && typeof payload === \"object\" ? payload as Record<string, unknown> : {};\n    const code = typeof record.code === \"string\" ? record.code : \"HTTP_ERROR\";\n    const requestId = typeof record.requestId === \"string\" ? record.requestId : response.headers.get(\"x-request-id\") ?? undefined;\n    throw new ClientError(code, response.status, requestId);\n  }\n  if (contentType === \"response\") return response;\n  if (response.status === 204) return undefined;\n  try { return await response.json(); }\n  catch { throw new ClientError(\"INVALID_RESPONSE\", response.status, response.headers.get(\"x-request-id\") ?? undefined); }\n}\n\nfunction endpointUrl(pathname: string, options: ClientOptions): string {\n  const baseUrl = typeof options.baseUrl === \"function\" ? options.baseUrl() : options.baseUrl;\n  return baseUrl ? new URL(pathname, baseUrl).toString() : pathname;\n}\n\nfunction headersFor(options: ClientOptions, method: string, json: boolean): Headers {\n  const headers = new Headers(typeof options.headers === \"function\" ? options.headers() : options.headers);\n  if (json) headers.set(\"content-type\", \"application/json\");\n  if (method !== \"GET\" && method !== \"HEAD\") {\n    const csrf = typeof options.csrfToken === \"function\" ? options.csrfToken() : options.csrfToken;\n    if (csrf) headers.set(\"x-meeko-csrf\", csrf);\n  }\n  return headers;\n}\n\nfunction insert(root: Record<string, unknown>, key: string, value: unknown): void {\n  const parts = key.split(\".\");\n  if (parts.some((part) => !/^[A-Za-z_$][\\w$]*$/.test(part))) throw new TypeError(`Invalid client key: ${key}`);\n  let node = root;\n  for (const part of parts.slice(0, -1)) {\n    const existing = node[part];\n    if (existing === undefined) node[part] = Object.create(null) as Record<string, unknown>;\n    else if (!existing || typeof existing !== \"object\") throw new TypeError(`Client key collision: ${key}`);\n    node = node[part] as Record<string, unknown>;\n  }\n  const last = parts.at(-1)!;\n  if (node[last] !== undefined) throw new TypeError(`Client key collision: ${key}`);\n  node[last] = value;\n}\n\nfunction ensureObject(root: Record<string, unknown>, key: string): Record<string, unknown> {\n  const parts = key.split(\".\");\n  if (parts.some((part) => !/^[A-Za-z_$][\\w$]*$/.test(part))) throw new TypeError(`Invalid client key: ${key}`);\n  let node = root;\n  for (const part of parts) {\n    const existing = node[part];\n    if (existing === undefined) node[part] = Object.create(null) as Record<string, unknown>;\n    else if (!existing || typeof existing !== \"object\") throw new TypeError(`Client key collision: ${key}`);\n    node = node[part] as Record<string, unknown>;\n  }\n  return node;\n}\n\n/** Creates browser API methods from public endpoint paths, without server imports. */\nexport function createApiClient<Contract extends Record<string, Record<string, AnyApiOperation>>>(manifest: Pick<PublicServerManifest, \"api\">, options: ClientOptions = {}): ApiClient<Contract> {\n  const root: Record<string, unknown> = Object.create(null);\n  for (const endpoint of manifest.api) {\n    const methods = ensureObject(root, endpoint.clientKey);\n    const method = endpoint.method.toLowerCase();\n    if (methods[method]) throw new TypeError(`Duplicate API method: ${endpoint.clientKey}.${method}`);\n    methods[method] = async (input: { params?: Record<string, string>; query?: Record<string, QueryValue>; body?: unknown; signal?: AbortSignal } = {}) => {\n      const path = pathWithParams(endpoint.pathname, input.params) + queryString(input.query);\n      const url = endpointUrl(path, options);\n      const fetcher = options.fetch ?? fetch;\n      const response = await fetcher(url, {\n        method: endpoint.method, headers: headersFor(options, endpoint.method, input.body !== undefined),\n        credentials: \"same-origin\", ...(input.body === undefined ? {} : { body: JSON.stringify(input.body) }),\n        ...(input.signal ? { signal: input.signal } : {}),\n      });\n      return responseValue(response, endpoint.contentType);\n    };\n  }\n  return root as ApiClient<Contract>;\n}\n\n/** Creates browser RPC procedures from public endpoint paths. */\nexport function createRpcClient<Contract extends Record<string, RpcOperation>>(manifest: Pick<PublicServerManifest, \"rpc\">, options: ClientOptions = {}): RpcClient<Contract> {\n  const root: Record<string, unknown> = Object.create(null);\n  for (const endpoint of manifest.rpc) {\n    insert(root, endpoint.id, async (input: unknown, request: RequestOptions = {}) => {\n      const fetcher = options.fetch ?? fetch;\n      const response = await fetcher(endpointUrl(endpoint.pathname, options), {\n        method: \"POST\", headers: headersFor(options, \"POST\", true), credentials: \"same-origin\",\n        body: JSON.stringify(input), ...(request.signal ? { signal: request.signal } : {}),\n      });\n      return responseValue(response);\n    });\n  }\n  return root as RpcClient<Contract>;\n}\n"]}

package/dist/framework/config-type.d.ts

@@ -0,0 +1,10 @@
+export interface MeekoConfig {
+    /** Layers are applied after the application, in declaration order. Collisions fail. */
+    readonly extends?: readonly string[];
+    /** Modules use the same app/pages convention as layers. */
+    readonly modules?: readonly string[];
+    readonly imports?: {
+        readonly serverDirs?: readonly string[];
+    };
+}
+export declare function defineMeekoConfig<const T extends MeekoConfig>(config: T): T;

package/dist/framework/config-type.js

@@ -0,0 +1,4 @@
+export function defineMeekoConfig(config) {
+    return config;
+}
+//# sourceMappingURL=config-type.js.map

package/dist/framework/config-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-type.js","sourceRoot":"","sources":["../../src/framework/config-type.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAA8B,MAAS;IACtE,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["export interface MeekoConfig {\n  /** Layers are applied after the application, in declaration order. Collisions fail. */\n  readonly extends?: readonly string[];\n  /** Modules use the same app/pages convention as layers. */\n  readonly modules?: readonly string[];\n  readonly imports?: { readonly serverDirs?: readonly string[] };\n}\n\nexport function defineMeekoConfig<const T extends MeekoConfig>(config: T): T {\n  return config;\n}\n"]}

package/dist/framework/config.d.ts

@@ -0,0 +1,15 @@
+import type { RouteRecord } from "./router.js";
+import type { MeekoConfig } from "./config-type.js";
+export type { MeekoConfig } from "./config-type.js";
+export interface ConfigSource {
+    readonly name: string;
+    readonly root: string;
+    readonly kind: "app" | "layer" | "module";
+}
+/** Loads the optional project configuration using Node 24's TypeScript support. */
+export declare function loadMeekoConfig(projectRoot: string): Promise<MeekoConfig>;
+/** Resolves sources and rejects accidental escape or duplicate names before discovery. */
+/** Reads static server import directories for synchronous editor discovery. */
+export declare function readMeekoConfigSync(projectRoot: string): MeekoConfig;
+export declare function resolveConfigSources(projectRoot: string, config?: MeekoConfig): Promise<readonly ConfigSource[]>;
+export declare function discoverConfiguredRoutes(projectRoot: string): Promise<readonly RouteRecord[]>;

package/dist/framework/config.js

@@ -0,0 +1,138 @@
+import { realpath, stat } from "node:fs/promises";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, extname, isAbsolute, relative, resolve, sep } from "node:path";
+import { pathToFileURL } from "node:url";
+import ts from "@typescript/typescript6";
+import { composeFrameworkRoutes } from "./modules.js";
+function inside(root, target) {
+    const path = relative(root, target);
+    return path === "" || (path !== ".." && !path.startsWith(`..${sep}`) && !isAbsolute(path));
+}
+async function configFile(root) {
+    const files = ["meeko.config.ts", "meeko.config.mts", "meeko.config.js", "meeko.config.mjs"];
+    const found = [];
+    for (const name of files) {
+        const file = resolve(root, name);
+        try {
+            if ((await stat(file)).isFile())
+                found.push(file);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+    }
+    if (found.length > 1)
+        throw new Error(`Multiple Meeko configuration files: ${found.join(", ")}`);
+    return found[0];
+}
+/** Loads the optional project configuration using Node 24's TypeScript support. */
+export async function loadMeekoConfig(projectRoot) {
+    const root = resolve(projectRoot);
+    const file = await configFile(root);
+    if (!file)
+        return {};
+    const url = pathToFileURL(file);
+    url.searchParams.set("mtime", String((await stat(file)).mtimeMs));
+    let loaded;
+    try {
+        loaded = (await import(url.href)).default;
+    }
+    catch (error) {
+        throw new Error(`Cannot load ${file}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+    if (!loaded || typeof loaded !== "object" || Array.isArray(loaded))
+        throw new TypeError(`${file} must export a Meeko configuration object`);
+    const config = loaded;
+    for (const [key, entries] of [["extends", config.extends], ["modules", config.modules], ["imports.serverDirs", config.imports?.serverDirs]]) {
+        if (entries !== undefined && (!Array.isArray(entries) || entries.some((entry) => typeof entry !== "string" || !entry))) {
+            throw new TypeError(`${file}: ${key} must be an array of nonempty paths`);
+        }
+    }
+    return config;
+}
+/** Resolves sources and rejects accidental escape or duplicate names before discovery. */
+/** Reads static server import directories for synchronous editor discovery. */
+export function readMeekoConfigSync(projectRoot) {
+    const file = ["meeko.config.ts", "meeko.config.mts", "meeko.config.js", "meeko.config.mjs"]
+        .map((name) => resolve(projectRoot, name)).find(existsSync);
+    if (!file)
+        return {};
+    const source = ts.createSourceFile(file, readFileSync(file, "utf8"), ts.ScriptTarget.Latest, true);
+    const exported = source.statements.find(ts.isExportAssignment);
+    const expression = exported?.expression;
+    const config = expression && ts.isCallExpression(expression) ? expression.arguments[0] : expression;
+    if (!config || !ts.isObjectLiteralExpression(config))
+        return {};
+    const property = (node, name) => {
+        const item = node.properties.find((entry) => ts.isPropertyAssignment(entry) &&
+            ((ts.isIdentifier(entry.name) && entry.name.text === name) || (ts.isStringLiteral(entry.name) && entry.name.text === name)));
+        return item && ts.isPropertyAssignment(item) ? item.initializer : undefined;
+    };
+    const strings = (node, name) => {
+        const value = property(node, name);
+        if (!value)
+            return undefined;
+        if (!ts.isArrayLiteralExpression(value) || value.elements.some((entry) => !ts.isStringLiteral(entry))) {
+            throw new TypeError(`${file}: ${name} must be a static string array for editor discovery`);
+        }
+        return value.elements.map((entry) => entry.text);
+    };
+    const imports = property(config, "imports");
+    const serverDirs = imports && ts.isObjectLiteralExpression(imports) ? strings(imports, "serverDirs") : undefined;
+    const extensions = strings(config, "extends");
+    const modules = strings(config, "modules");
+    return {
+        ...(extensions ? { extends: extensions } : {}),
+        ...(modules ? { modules } : {}),
+        ...(serverDirs ? { imports: { serverDirs } } : {}),
+    };
+}
+export async function resolveConfigSources(projectRoot, config) {
+    config ??= await loadMeekoConfig(projectRoot);
+    const root = resolve(projectRoot);
+    const actualRoot = await realpath(root);
+    const result = [{ name: "app", root, kind: "app" }];
+    const names = new Set(["app"]);
+    const roots = new Set([actualRoot.toLowerCase()]);
+    for (const [kind, entries] of [["layer", config.extends], ["module", config.modules]]) {
+        for (const entry of entries ?? []) {
+            const target = resolve(root, entry);
+            if (!inside(root, target))
+                throw new Error(`${kind} ${entry} escapes project root ${root}`);
+            let actualTarget;
+            try {
+                actualTarget = await realpath(target);
+            }
+            catch {
+                throw new Error(`${kind} ${entry} does not exist: ${target}`);
+            }
+            if (!inside(actualRoot, actualTarget))
+                throw new Error(`${kind} ${entry} escapes project root ${root}`);
+            if (roots.has(actualTarget.toLowerCase()))
+                throw new Error(`Duplicate Meeko source root: ${target}`);
+            const name = basename(target, extname(target));
+            if (!/^[a-z][a-z0-9-]*$/.test(name) || names.has(name))
+                throw new Error(`Invalid or duplicate Meeko source name ${name}: ${target}`);
+            try {
+                if (!(await stat(resolve(target, "app", "pages"))).isDirectory())
+                    throw new Error("not a directory");
+            }
+            catch {
+                throw new Error(`${kind} ${entry} has no app/pages directory: ${target}`);
+            }
+            roots.add(actualTarget.toLowerCase());
+            names.add(name);
+            result.push({ name, root: target, kind });
+        }
+    }
+    return result;
+}
+export async function discoverConfiguredRoutes(projectRoot) {
+    const sources = await resolveConfigSources(projectRoot);
+    return composeFrameworkRoutes({
+        projectRoot,
+        layers: sources.slice(1).map(({ name, root }) => ({ name, root })),
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/framework/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/framework/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAYtD,SAAS,MAAM,CAAC,IAAY,EAAE,MAAc;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,IAAI,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;IAC7F,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC;YAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAC1D,OAAO,KAAK,EAAE,CAAC;YAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;QAAC,CAAC;IACxF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QAAC,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAA2B,EAAC,OAAO,CAAC;IAAC,CAAC;IAC3E,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAAC,CAAC;IACtI,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,2CAA2C,CAAC,CAAC;IAC5I,MAAM,MAAM,GAAG,MAAqB,CAAC;IACrC,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAU,EAAE,CAAC;QACrJ,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACvH,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,KAAK,GAAG,qCAAqC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AAC1F,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,IAAI,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;SACxF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnG,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,QAAQ,EAAE,UAAU,CAAC;IACxC,MAAM,MAAM,GAAG,UAAU,IAAI,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACpG,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAChE,MAAM,QAAQ,GAAG,CAAC,IAAgC,EAAE,IAAY,EAA6B,EAAE;QAC7F,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC;YACzE,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/H,OAAO,IAAI,IAAI,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,IAAgC,EAAE,IAAY,EAAiC,EAAE;QAChG,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACtG,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,KAAK,IAAI,qDAAqD,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAE,KAA0B,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,OAAO,IAAI,EAAE,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjH,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,OAAO;QACL,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB,EAAE,MAAoB;IAClF,MAAM,KAAK,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAmB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAU,EAAE,CAAC;QAC/F,KAAK,MAAM,KAAK,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,KAAK,yBAAyB,IAAI,EAAE,CAAC,CAAC;YAC5F,IAAI,YAAoB,CAAC;YACzB,IAAI,CAAC;gBAAC,YAAY,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;YAAC,CAAC;YAC9C,MAAM,CAAC;gBAAC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,KAAK,oBAAoB,MAAM,EAAE,CAAC,CAAC;YAAC,CAAC;YACxE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,KAAK,yBAAyB,IAAI,EAAE,CAAC,CAAC;YACxG,IAAI,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;YACrG,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;YACrI,IAAI,CAAC;gBAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAAC,CAAC;YAC7G,MAAM,CAAC;gBAAC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,KAAK,gCAAgC,MAAM,EAAE,CAAC,CAAC;YAAC,CAAC;YACpF,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;YAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,WAAmB;IAChE,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACxD,OAAO,sBAAsB,CAAC;QAC5B,WAAW;QACX,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;KACnE,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { realpath, stat } from \"node:fs/promises\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { basename, extname, isAbsolute, relative, resolve, sep } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport ts from \"@typescript/typescript6\";\nimport { composeFrameworkRoutes } from \"./modules.js\";\nimport type { RouteRecord } from \"./router.js\";\nimport type { MeekoConfig } from \"./config-type.js\";\n\nexport type { MeekoConfig } from \"./config-type.js\";\n\nexport interface ConfigSource {\n  readonly name: string;\n  readonly root: string;\n  readonly kind: \"app\" | \"layer\" | \"module\";\n}\n\nfunction inside(root: string, target: string): boolean {\n  const path = relative(root, target);\n  return path === \"\" || (path !== \"..\" && !path.startsWith(`..${sep}`) && !isAbsolute(path));\n}\n\nasync function configFile(root: string): Promise<string | undefined> {\n  const files = [\"meeko.config.ts\", \"meeko.config.mts\", \"meeko.config.js\", \"meeko.config.mjs\"];\n  const found: string[] = [];\n  for (const name of files) {\n    const file = resolve(root, name);\n    try { if ((await stat(file)).isFile()) found.push(file); }\n    catch (error) { if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error; }\n  }\n  if (found.length > 1) throw new Error(`Multiple Meeko configuration files: ${found.join(\", \")}`);\n  return found[0];\n}\n\n/** Loads the optional project configuration using Node 24's TypeScript support. */\nexport async function loadMeekoConfig(projectRoot: string): Promise<MeekoConfig> {\n  const root = resolve(projectRoot);\n  const file = await configFile(root);\n  if (!file) return {};\n  const url = pathToFileURL(file);\n  url.searchParams.set(\"mtime\", String((await stat(file)).mtimeMs));\n  let loaded: unknown;\n  try { loaded = (await import(url.href) as { default?: unknown }).default; }\n  catch (error) { throw new Error(`Cannot load ${file}: ${error instanceof Error ? error.message : String(error)}`, { cause: error }); }\n  if (!loaded || typeof loaded !== \"object\" || Array.isArray(loaded)) throw new TypeError(`${file} must export a Meeko configuration object`);\n  const config = loaded as MeekoConfig;\n  for (const [key, entries] of [[\"extends\", config.extends], [\"modules\", config.modules], [\"imports.serverDirs\", config.imports?.serverDirs]] as const) {\n    if (entries !== undefined && (!Array.isArray(entries) || entries.some((entry) => typeof entry !== \"string\" || !entry))) {\n      throw new TypeError(`${file}: ${key} must be an array of nonempty paths`);\n    }\n  }\n  return config;\n}\n\n/** Resolves sources and rejects accidental escape or duplicate names before discovery. */\n/** Reads static server import directories for synchronous editor discovery. */\nexport function readMeekoConfigSync(projectRoot: string): MeekoConfig {\n  const file = [\"meeko.config.ts\", \"meeko.config.mts\", \"meeko.config.js\", \"meeko.config.mjs\"]\n    .map((name) => resolve(projectRoot, name)).find(existsSync);\n  if (!file) return {};\n  const source = ts.createSourceFile(file, readFileSync(file, \"utf8\"), ts.ScriptTarget.Latest, true);\n  const exported = source.statements.find(ts.isExportAssignment);\n  const expression = exported?.expression;\n  const config = expression && ts.isCallExpression(expression) ? expression.arguments[0] : expression;\n  if (!config || !ts.isObjectLiteralExpression(config)) return {};\n  const property = (node: ts.ObjectLiteralExpression, name: string): ts.Expression | undefined => {\n    const item = node.properties.find((entry) => ts.isPropertyAssignment(entry) &&\n      ((ts.isIdentifier(entry.name) && entry.name.text === name) || (ts.isStringLiteral(entry.name) && entry.name.text === name)));\n    return item && ts.isPropertyAssignment(item) ? item.initializer : undefined;\n  };\n  const strings = (node: ts.ObjectLiteralExpression, name: string): readonly string[] | undefined => {\n    const value = property(node, name);\n    if (!value) return undefined;\n    if (!ts.isArrayLiteralExpression(value) || value.elements.some((entry) => !ts.isStringLiteral(entry))) {\n      throw new TypeError(`${file}: ${name} must be a static string array for editor discovery`);\n    }\n    return value.elements.map((entry) => (entry as ts.StringLiteral).text);\n  };\n  const imports = property(config, \"imports\");\n  const serverDirs = imports && ts.isObjectLiteralExpression(imports) ? strings(imports, \"serverDirs\") : undefined;\n  const extensions = strings(config, \"extends\");\n  const modules = strings(config, \"modules\");\n  return {\n    ...(extensions ? { extends: extensions } : {}),\n    ...(modules ? { modules } : {}),\n    ...(serverDirs ? { imports: { serverDirs } } : {}),\n  };\n}\n\nexport async function resolveConfigSources(projectRoot: string, config?: MeekoConfig): Promise<readonly ConfigSource[]> {\n  config ??= await loadMeekoConfig(projectRoot);\n  const root = resolve(projectRoot);\n  const actualRoot = await realpath(root);\n  const result: ConfigSource[] = [{ name: \"app\", root, kind: \"app\" }];\n  const names = new Set([\"app\"]);\n  const roots = new Set([actualRoot.toLowerCase()]);\n  for (const [kind, entries] of [[\"layer\", config.extends], [\"module\", config.modules]] as const) {\n    for (const entry of entries ?? []) {\n      const target = resolve(root, entry);\n      if (!inside(root, target)) throw new Error(`${kind} ${entry} escapes project root ${root}`);\n      let actualTarget: string;\n      try { actualTarget = await realpath(target); }\n      catch { throw new Error(`${kind} ${entry} does not exist: ${target}`); }\n      if (!inside(actualRoot, actualTarget)) throw new Error(`${kind} ${entry} escapes project root ${root}`);\n      if (roots.has(actualTarget.toLowerCase())) throw new Error(`Duplicate Meeko source root: ${target}`);\n      const name = basename(target, extname(target));\n      if (!/^[a-z][a-z0-9-]*$/.test(name) || names.has(name)) throw new Error(`Invalid or duplicate Meeko source name ${name}: ${target}`);\n      try { if (!(await stat(resolve(target, \"app\", \"pages\"))).isDirectory()) throw new Error(\"not a directory\"); }\n      catch { throw new Error(`${kind} ${entry} has no app/pages directory: ${target}`); }\n      roots.add(actualTarget.toLowerCase()); names.add(name);\n      result.push({ name, root: target, kind });\n    }\n  }\n  return result;\n}\n\nexport async function discoverConfiguredRoutes(projectRoot: string): Promise<readonly RouteRecord[]> {\n  const sources = await resolveConfigSources(projectRoot);\n  return composeFrameworkRoutes({\n    projectRoot,\n    layers: sources.slice(1).map(({ name, root }) => ({ name, root })),\n  });\n}\n"]}

package/dist/framework/contracts-generate.d.ts

@@ -0,0 +1,8 @@
+export interface GeneratedServerContracts {
+    readonly types: string;
+    readonly manifest: string;
+    readonly apiCount: number;
+    readonly rpcCount: number;
+}
+/** Generate public API/RPC declarations without importing handler modules. */
+export declare function generateServerContracts(projectRoot: string): Promise<GeneratedServerContracts>;