pastoria 0.0.1 → 1.0.2

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# pastoria
+
+## 1.0.2
+
+### Patch Changes
+
+- Remove usage of experimentalStripTypes
+
+## 1.0.1
+
+### Patch Changes
+
+- Pastoria alpha version for testing

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 Ryan Delaney
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/build.d.ts

@@ -0,0 +1,39 @@
+import { type BuildEnvironmentOptions, type Plugin } from 'vite';
+export declare const CLIENT_BUILD: BuildEnvironmentOptions;
+export declare const SERVER_BUILD: BuildEnvironmentOptions;
+export declare function createBuildConfig(buildEnv: BuildEnvironmentOptions): {
+    appType: "custom";
+    build: {
+        assetsInlineLimit: number;
+        manifest: boolean;
+        ssrManifest: boolean;
+        target?: "baseline-widely-available" | import("vite").EsbuildTransformOptions["target"] | false;
+        polyfillModulePreload?: boolean;
+        modulePreload?: boolean | import("vite").ModulePreloadOptions;
+        outDir?: string;
+        assetsDir?: string;
+        cssCodeSplit?: boolean;
+        cssTarget?: import("vite").EsbuildTransformOptions["target"] | false;
+        cssMinify?: boolean | "esbuild" | "lightningcss";
+        sourcemap?: boolean | "inline" | "hidden";
+        minify?: boolean | "terser" | "esbuild";
+        terserOptions?: import("vite").TerserOptions;
+        rollupOptions?: import("rollup").RollupOptions;
+        commonjsOptions?: import("vite").RollupCommonJSOptions;
+        dynamicImportVarsOptions?: import("vite").RollupDynamicImportVarsOptions;
+        write?: boolean;
+        emptyOutDir?: boolean | null;
+        copyPublicDir?: boolean;
+        lib?: import("vite").LibraryOptions | false;
+        ssr?: boolean | string;
+        ssrEmitAssets?: boolean;
+        emitAssets?: boolean;
+        reportCompressedSize?: boolean;
+        chunkSizeWarningLimit?: number;
+        watch?: import("rollup").WatcherOptions | null;
+        createEnvironment?: (name: string, config: import("vite").ResolvedConfig) => Promise<import("vite").BuildEnvironment> | import("vite").BuildEnvironment;
+    };
+    plugins: (Plugin<any> | Plugin<any>[])[];
+};
+export declare function createBuild(): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAGA,OAAO,EAAQ,KAAK,uBAAuB,EAAE,KAAK,MAAM,EAAC,MAAM,MAAM,CAAC;AA8EtE,eAAO,MAAM,YAAY,EAAE,uBAK1B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,uBAM1B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBlE;AAED,wBAAsB,WAAW,kBAUhC"}

package/dist/build.js

@@ -0,0 +1,121 @@
+import react from '@vitejs/plugin-react';
+import tailwindcss from '@tailwindcss/vite';
+import { cjsInterop } from 'vite-plugin-cjs-interop';
+import { build } from 'vite';
+// TODO: Only emit `App` code if _app exits.
+const PASTORIA_CLIENT_ENTRY = `// Generated by Pastoria.
+import {createRouterApp} from '#genfiles/router/router';
+import {App} from '#src/pages/_app';
+import {hydrateRoot} from 'react-dom/client';
+
+async function main() {
+  const RouterApp = await createRouterApp();
+  hydrateRoot(document, <RouterApp App={App} />);
+}
+
+main();
+`;
+// TODO: Remove hard-coded context import here.
+const PASTORIA_ENTRY_SERVER = `// Generated by Pastoria.
+import {JSResource} from '#genfiles/router/js_resource';
+import {
+  listRoutes,
+  router__createAppFromEntryPoint,
+  router__loadEntryPoint,
+} from '#genfiles/router/router';
+import {getSchema} from '#genfiles/schema/schema';
+import {Context} from '#src/lib/server/context';
+import {App} from '#src/pages/_app';
+import {GraphQLSchema, specifiedDirectives} from 'graphql';
+import {createRouterHandler} from 'pastoria-runtime/server';
+import type {Manifest} from 'vite';
+
+const schemaConfig = getSchema().toConfig();
+const schema = new GraphQLSchema({
+  ...schemaConfig,
+  directives: [...specifiedDirectives, ...schemaConfig.directives],
+});
+
+export function createHandler(
+  persistedQueries: Record<string, string>,
+  manifest?: Manifest,
+) {
+  return createRouterHandler(
+    listRoutes(),
+    JSResource.srcOfModuleId,
+    router__loadEntryPoint,
+    router__createAppFromEntryPoint,
+    App,
+    schema,
+    () => new Context(),
+    persistedQueries,
+    manifest,
+  );
+}
+`;
+function pastoriaEntryPlugin() {
+    const clientEntryModuleId = 'virtual:pastoria-entry-client.tsx';
+    const serverEntryModuleId = 'virtual:pastoria-entry-server.tsx';
+    return {
+        name: 'pastoria-entry',
+        resolveId(id) {
+            if (id === clientEntryModuleId) {
+                return clientEntryModuleId; // Return without \0 prefix so React plugin can see .tsx extension
+            }
+            else if (id === serverEntryModuleId) {
+                return serverEntryModuleId;
+            }
+        },
+        load(id) {
+            if (id === clientEntryModuleId) {
+                return PASTORIA_CLIENT_ENTRY;
+            }
+            else if (id === serverEntryModuleId) {
+                return PASTORIA_ENTRY_SERVER;
+            }
+        },
+    };
+}
+export const CLIENT_BUILD = {
+    outDir: 'dist/client',
+    rollupOptions: {
+        input: 'virtual:pastoria-entry-client.tsx',
+    },
+};
+export const SERVER_BUILD = {
+    outDir: 'dist/server',
+    ssr: true,
+    rollupOptions: {
+        input: 'virtual:pastoria-entry-server.tsx',
+    },
+};
+export function createBuildConfig(buildEnv) {
+    return {
+        appType: 'custom',
+        build: {
+            ...buildEnv,
+            assetsInlineLimit: 0,
+            manifest: true,
+            ssrManifest: true,
+        },
+        plugins: [
+            pastoriaEntryPlugin(),
+            tailwindcss(),
+            react({ babel: { plugins: ['relay'] } }),
+            cjsInterop({
+                dependencies: ['react-relay', 'react-relay/hooks', 'relay-runtime'],
+            }),
+        ],
+    };
+}
+export async function createBuild() {
+    const clientBuild = await build({
+        ...createBuildConfig(CLIENT_BUILD),
+        configFile: false,
+    });
+    const serverBuild = await build({
+        ...createBuildConfig(SERVER_BUILD),
+        configFile: false,
+    });
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,sBAAsB,CAAC;AACzC,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAC,UAAU,EAAC,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAC,KAAK,EAA4C,MAAM,MAAM,CAAC;AAEtE,4CAA4C;AAC5C,MAAM,qBAAqB,GAAG;;;;;;;;;;;CAW7B,CAAC;AAEF,+CAA+C;AAC/C,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC7B,CAAC;AAEF,SAAS,mBAAmB;IAC1B,MAAM,mBAAmB,GAAG,mCAAmC,CAAC;IAChE,MAAM,mBAAmB,GAAG,mCAAmC,CAAC;IAEhE,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,SAAS,CAAC,EAAE;YACV,IAAI,EAAE,KAAK,mBAAmB,EAAE,CAAC;gBAC/B,OAAO,mBAAmB,CAAC,CAAC,kEAAkE;YAChG,CAAC;iBAAM,IAAI,EAAE,KAAK,mBAAmB,EAAE,CAAC;gBACtC,OAAO,mBAAmB,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,KAAK,mBAAmB,EAAE,CAAC;gBAC/B,OAAO,qBAAqB,CAAC;YAC/B,CAAC;iBAAM,IAAI,EAAE,KAAK,mBAAmB,EAAE,CAAC;gBACtC,OAAO,qBAAqB,CAAC;YAC/B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAA4B;IACnD,MAAM,EAAE,aAAa;IACrB,aAAa,EAAE;QACb,KAAK,EAAE,mCAAmC;KAC3C;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAA4B;IACnD,MAAM,EAAE,aAAa;IACrB,GAAG,EAAE,IAAI;IACT,aAAa,EAAE;QACb,KAAK,EAAE,mCAAmC;KAC3C;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,QAAiC;IACjE,OAAO;QACL,OAAO,EAAE,QAAiB;QAC1B,KAAK,EAAE;YACL,GAAG,QAAQ;YACX,iBAAiB,EAAE,CAAC;YACpB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,IAAI;SAClB;QACD,OAAO,EAAE;YACP,mBAAmB,EAAE;YACrB,WAAW,EAAE;YACb,KAAK,CAAC,EAAC,KAAK,EAAE,EAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAC,EAAC,CAAC;YACpC,UAAU,CAAC;gBACT,YAAY,EAAE,CAAC,aAAa,EAAE,mBAAmB,EAAE,eAAe,CAAC;aACpE,CAAC;SACH;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC;QAC9B,GAAG,iBAAiB,CAAC,YAAY,CAAC;QAClC,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC;QAC9B,GAAG,iBAAiB,CAAC,YAAY,CAAC;QAClC,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/devserver.d.ts

@@ -0,0 +1,4 @@
+export declare function startDevserver(opts: {
+    port: string;
+}): Promise<void>;
+//# sourceMappingURL=devserver.d.ts.map

package/dist/devserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devserver.d.ts","sourceRoot":"","sources":["../src/devserver.ts"],"names":[],"mappings":"AAmBA,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,iBAiCxD"}

package/dist/devserver.js

@@ -0,0 +1,34 @@
+import cookieParser from 'cookie-parser';
+import dotenv from 'dotenv';
+import express from 'express';
+import { readFile } from 'node:fs/promises';
+import pc from 'picocolors';
+import { createServer as createViteServer } from 'vite';
+import { CLIENT_BUILD, createBuildConfig } from './build';
+export async function startDevserver(opts) {
+    dotenv.config();
+    const buildConfig = createBuildConfig(CLIENT_BUILD);
+    const vite = await createViteServer({
+        ...buildConfig,
+        configFile: false,
+        server: { middlewareMode: true },
+    });
+    const app = express();
+    app.use(cookieParser());
+    app.use(vite.middlewares);
+    app.use(async (req, res, next) => {
+        const persistedQueries = JSON.parse(await readFile('__generated__/persisted_queries.json', 'utf-8'));
+        const { createHandler } = (await vite.ssrLoadModule('virtual:pastoria-entry-server.tsx'));
+        const handler = createHandler(persistedQueries);
+        handler(req, res, next);
+    });
+    app.listen(Number(opts.port), (err) => {
+        if (err) {
+            console.error(err);
+        }
+        else {
+            console.log(pc.cyan(`Listening on port ${opts.port}!`));
+        }
+    });
+}
+//# sourceMappingURL=devserver.js.map

package/dist/devserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devserver.js","sourceRoot":"","sources":["../src/devserver.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAC,YAAY,IAAI,gBAAgB,EAAgB,MAAM,MAAM,CAAC;AACrE,OAAO,EAAC,YAAY,EAAE,iBAAiB,EAAC,MAAM,SAAS,CAAC;AAaxD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAoB;IACvD,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,MAAM,WAAW,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC;QAClC,GAAG,WAAW;QACd,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,EAAC,cAAc,EAAE,IAAI,EAAC;KAC/B,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;IACxB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC/B,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CACjC,MAAM,QAAQ,CAAC,sCAAsC,EAAE,OAAO,CAAC,CAChE,CAAC;QAEF,MAAM,EAAC,aAAa,EAAC,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,CAC/C,mCAAmC,CACpC,CAAgB,CAAC;QAElB,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;QACpC,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/generate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Router Code Generator
+ *
+ * This script generates type-safe router configuration files by scanning TypeScript
+ * source code for JSDoc annotations. It's part of the "Pastoria" routing framework.
+ *
+ * How it works:
+ * 1. Scans all TypeScript files in the project for exported functions/classes
+ * 2. Looks for JSDoc tags: @route, @resource, and @param
+ * 3. Generates three files from templates:
+ *    - js_resource.ts: Resource configuration for lazy loading
+ *    - router.tsx: Client-side router with type-safe routes
+ *    - server_router.ts: Server-side router configuration
+ *
+ * Usage:
+ * - Add @route <route-name> to functions to create routes
+ * - Add @param <name> <type> to document route parameters
+ * - Add @resource <resource-name> to exports for lazy loading
+ *
+ * The generator automatically creates Zod schemas for route parameters based on
+ * TypeScript types, enabling runtime validation and type safety.
+ */
+export declare function generatePastoriaArtifacts(): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAoJH,wBAAsB,yBAAyB,kBA2G9C"}

package/dist/generate.js

@@ -0,0 +1,209 @@
+/**
+ * @fileoverview Router Code Generator
+ *
+ * This script generates type-safe router configuration files by scanning TypeScript
+ * source code for JSDoc annotations. It's part of the "Pastoria" routing framework.
+ *
+ * How it works:
+ * 1. Scans all TypeScript files in the project for exported functions/classes
+ * 2. Looks for JSDoc tags: @route, @resource, and @param
+ * 3. Generates three files from templates:
+ *    - js_resource.ts: Resource configuration for lazy loading
+ *    - router.tsx: Client-side router with type-safe routes
+ *    - server_router.ts: Server-side router configuration
+ *
+ * Usage:
+ * - Add @route <route-name> to functions to create routes
+ * - Add @param <name> <type> to document route parameters
+ * - Add @resource <resource-name> to exports for lazy loading
+ *
+ * The generator automatically creates Zod schemas for route parameters based on
+ * TypeScript types, enabling runtime validation and type safety.
+ */
+import { readFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { default as pc } from 'picocolors';
+import { Project, SyntaxKind, ts, TypeFlags } from 'ts-morph';
+const JS_RESOURCE_FILENAME = '__generated__/router/js_resource.ts';
+const JS_RESOURCE_TEMPLATE = path.join(import.meta.dirname, '../templates/js_resource.ts');
+const ROUTER_FILENAME = '__generated__/router/router.tsx';
+const ROUTER_TEMPLATE = path.join(import.meta.dirname, '../templates/router.tsx');
+async function loadRouterFiles(project) {
+    async function loadSourceFile(fileName, templateFileName) {
+        const template = await readFile(templateFileName, 'utf-8');
+        const warningComment = `/*
+ * This file was generated by \`pastoria\`.
+ * Do not modify this file directly. Instead, edit the template at ${path.basename(templateFileName)}.
+ */
+
+`;
+        return project.createSourceFile(fileName, warningComment + template, {
+            overwrite: true,
+        });
+    }
+    const [jsResource, router] = await Promise.all([
+        loadSourceFile(JS_RESOURCE_FILENAME, JS_RESOURCE_TEMPLATE),
+        loadSourceFile(ROUTER_FILENAME, ROUTER_TEMPLATE),
+    ]);
+    return { jsResource, router };
+}
+function collectRouterNodes(project) {
+    const resources = [];
+    const routes = [];
+    function visitRouterNodes(sourceFile) {
+        // TODO: Skip sourceFile if a pastora JSDoc tag isn't used at all.
+        sourceFile.getExportSymbols().forEach((symbol) => {
+            let routerResource = null;
+            let routerRoute = null;
+            const routeParams = new Map();
+            function visitJSDocTags(tag) {
+                if (ts.isJSDoc(tag)) {
+                    tag.tags?.forEach(visitJSDocTags);
+                }
+                else if (ts.isJSDocParameterTag(tag)) {
+                    const typeNode = tag.typeExpression?.type;
+                    const tc = project.getTypeChecker().compilerObject;
+                    const type = typeNode == null
+                        ? tc.getUnknownType()
+                        : tc.getTypeFromTypeNode(typeNode);
+                    routeParams.set(tag.name.getText(), type);
+                }
+                else if (typeof tag.comment === 'string') {
+                    switch (tag.tagName.getText()) {
+                        case 'route': {
+                            routerRoute = {
+                                routeName: tag.comment,
+                                sourceFile,
+                                symbol,
+                                params: routeParams,
+                            };
+                            break;
+                        }
+                        case 'resource': {
+                            routerResource = {
+                                resourceName: tag.comment,
+                                sourceFile,
+                                symbol,
+                            };
+                            break;
+                        }
+                    }
+                }
+            }
+            symbol
+                .getDeclarations()
+                .flatMap((decl) => ts.getJSDocCommentsAndTags(decl.compilerNode))
+                .forEach(visitJSDocTags);
+            if (routerRoute != null)
+                routes.push(routerRoute);
+            if (routerResource != null)
+                resources.push(routerResource);
+        });
+    }
+    project.getSourceFiles().forEach(visitRouterNodes);
+    return { resources, routes };
+}
+function zodSchemaOfType(tc, t) {
+    if (t.getFlags() & TypeFlags.String) {
+        return `z.pipe(z.string(), z.transform(decodeURIComponent))`;
+    }
+    else if (t.getFlags() & TypeFlags.Number) {
+        return `z.coerce.number<number>()`;
+    }
+    else if (t.getFlags() & TypeFlags.Null) {
+        return `z.preprocess(s => s == null ? undefined : s, z.undefined())`;
+    }
+    else if (t.isUnion()) {
+        const isRepresentingOptional = t.types.length === 2 &&
+            t.types.some((s) => s.getFlags() & TypeFlags.Null);
+        if (isRepresentingOptional) {
+            const nonOptionalType = t.types.find((s) => !(s.getFlags() & TypeFlags.Null));
+            return `z.pipe(z.nullish(${zodSchemaOfType(tc, nonOptionalType)}), z.transform(s => s == null ? undefined : s))`;
+        }
+        else {
+            return `z.union([${t.types.map((it) => zodSchemaOfType(tc, it)).join(', ')}])`;
+        }
+    }
+    else if (tc.isArrayLikeType(t)) {
+        const typeArg = tc.getTypeArguments(t)[0];
+        const argZodSchema = typeArg == null ? `z.any()` : zodSchemaOfType(tc, typeArg);
+        return `z.array(${argZodSchema})`;
+    }
+    else {
+        console.log('Could not handle type:', tc.typeToString(t));
+        return `z.any()`;
+    }
+}
+export async function generatePastoriaArtifacts() {
+    const targetDir = process.cwd();
+    const project = new Project({
+        tsConfigFilePath: path.join(targetDir, 'tsconfig.json'),
+    });
+    const tc = project.getTypeChecker().compilerObject;
+    const routerFiles = await loadRouterFiles(project);
+    const routerNodes = collectRouterNodes(project);
+    const resourceConf = routerFiles.jsResource
+        .getVariableDeclarationOrThrow('RESOURCE_CONF')
+        .getInitializerIfKindOrThrow(SyntaxKind.AsExpression)
+        .getExpressionIfKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+    resourceConf.getPropertyOrThrow('noop').remove();
+    for (const { resourceName, sourceFile, symbol } of routerNodes.resources) {
+        const filePath = path.relative(process.cwd(), sourceFile.getFilePath());
+        const moduleSpecifier = routerFiles.jsResource.getRelativePathAsModuleSpecifierTo(sourceFile.getFilePath());
+        resourceConf.addPropertyAssignment({
+            name: `"${resourceName}"`,
+            initializer: (writer) => {
+                writer.block(() => {
+                    writer
+                        .writeLine(`src: "${filePath}",`)
+                        .writeLine(`loader: () => import("${moduleSpecifier}").then(m => m.${symbol.getName()})`);
+                });
+            },
+        });
+        console.log('Created resource', pc.cyan(resourceName), 'for', pc.green(symbol.getName()), 'exported from', pc.yellow(filePath));
+    }
+    const routerConf = routerFiles.router
+        .getVariableDeclarationOrThrow('ROUTER_CONF')
+        .getInitializerIfKindOrThrow(SyntaxKind.AsExpression)
+        .getExpressionIfKindOrThrow(SyntaxKind.ObjectLiteralExpression);
+    routerConf.getPropertyOrThrow('noop').remove();
+    let entryPointImportIndex = 0;
+    for (const { routeName, sourceFile, symbol, params } of routerNodes.routes) {
+        const importAlias = `e${entryPointImportIndex++}`;
+        const filePath = path.relative(process.cwd(), sourceFile.getFilePath());
+        const moduleSpecifier = routerFiles.router.getRelativePathAsModuleSpecifierTo(sourceFile.getFilePath());
+        routerFiles.router.addImportDeclaration({
+            moduleSpecifier,
+            namedImports: [
+                {
+                    name: symbol.getName(),
+                    alias: importAlias,
+                },
+            ],
+        });
+        routerConf.addPropertyAssignment({
+            name: `"${routeName}"`,
+            initializer: (writer) => {
+                writer
+                    .write('{')
+                    .indent(() => {
+                    writer.writeLine(`entrypoint: ${importAlias},`);
+                    if (params.size === 0) {
+                        writer.writeLine(`schema: z.object({})`);
+                    }
+                    else {
+                        writer.writeLine(`schema: z.object({`);
+                        for (const [paramName, paramType] of Array.from(params)) {
+                            writer.writeLine(`  ${paramName}: ${zodSchemaOfType(tc, paramType)},`);
+                        }
+                        writer.writeLine('})');
+                    }
+                })
+                    .write('} as const');
+            },
+        });
+        console.log('Created route', pc.cyan(routeName), 'for', pc.green(symbol.getName()), 'exported from', pc.yellow(filePath));
+    }
+    await Promise.all([routerFiles.jsResource.save(), routerFiles.router.save()]);
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { readFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { createBuild } from './build';
+import { startDevserver } from './devserver';
+import { generatePastoriaArtifacts } from './generate';
+async function main() {
+    const packageData = JSON.parse(await readFile(path.join(import.meta.dirname, '../package.json'), 'utf-8'));
+    program
+        .name('pastoria')
+        .description(packageData.description)
+        .version(packageData.version);
+    program
+        .command('gen')
+        .description('Run Pastoria code generation')
+        .action(generatePastoriaArtifacts);
+    program
+        .command('dev')
+        .description('Start the pastoria devserver')
+        .option('--port <port>', 'Port the devserver will listen on', '3000')
+        .action(startDevserver);
+    program
+        .command('build')
+        .description('Creates a production build of the project')
+        .action(createBuild);
+    program.parseAsync();
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AACpC,OAAO,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAC,yBAAyB,EAAC,MAAM,YAAY,CAAC;AAErD,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAC3E,CAAC;IAEF,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC;SACpC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAEhC,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAErC,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,eAAe,EAAE,mCAAmC,EAAE,MAAM,CAAC;SACpE,MAAM,CAAC,cAAc,CAAC,CAAC;IAE1B,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,2CAA2C,CAAC;SACxD,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvB,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/package.json

@@ -1,14 +1,35 @@
 {
   "name": "pastoria",
-  "version": "0.0.1",
+  "version": "1.0.2",
+  "description": "Pastoria Development CLI",
+  "license": "MIT",
   "type": "module",
-  "bin": "./src/index.mts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "pastoria": "dist/index.js"
+  },
   "dependencies": {
+    "@tailwindcss/vite": "^4.1.14",
+    "@vitejs/plugin-react": "^5.0.4",
+    "commander": "^14.0.1",
+    "cookie-parser": "^1.4.7",
+    "dotenv": "^16.6.1",
+    "express": "^5.1.0",
     "picocolors": "^1.1.1",
-    "ts-morph": "^26.0.0"
+    "ts-morph": "^26.0.0",
+    "vite": "^7.1.9",
+    "vite-plugin-cjs-interop": "^2.3.0"
   },
   "devDependencies": {
-    "@types/node": "20.3.1",
-    "typescript": "^5.9.2"
+    "@types/cookie-parser": "^1.4.9",
+    "@types/express": "^5.0.3",
+    "@types/node": "^22.12.0",
+    "typescript": "^5.9.2",
+    "pastoria-runtime": "1.0.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check:types": "tsc --noEmit"
   }
-}
+}

package/src/build.ts

@@ -0,0 +1,127 @@
+import react from '@vitejs/plugin-react';
+import tailwindcss from '@tailwindcss/vite';
+import {cjsInterop} from 'vite-plugin-cjs-interop';
+import {build, type BuildEnvironmentOptions, type Plugin} from 'vite';
+
+// TODO: Only emit `App` code if _app exits.
+const PASTORIA_CLIENT_ENTRY = `// Generated by Pastoria.
+import {createRouterApp} from '#genfiles/router/router';
+import {App} from '#src/pages/_app';
+import {hydrateRoot} from 'react-dom/client';
+
+async function main() {
+  const RouterApp = await createRouterApp();
+  hydrateRoot(document, <RouterApp App={App} />);
+}
+
+main();
+`;
+
+// TODO: Remove hard-coded context import here.
+const PASTORIA_ENTRY_SERVER = `// Generated by Pastoria.
+import {JSResource} from '#genfiles/router/js_resource';
+import {
+  listRoutes,
+  router__createAppFromEntryPoint,
+  router__loadEntryPoint,
+} from '#genfiles/router/router';
+import {getSchema} from '#genfiles/schema/schema';
+import {Context} from '#src/lib/server/context';
+import {App} from '#src/pages/_app';
+import {GraphQLSchema, specifiedDirectives} from 'graphql';
+import {createRouterHandler} from 'pastoria-runtime/server';
+import type {Manifest} from 'vite';
+
+const schemaConfig = getSchema().toConfig();
+const schema = new GraphQLSchema({
+  ...schemaConfig,
+  directives: [...specifiedDirectives, ...schemaConfig.directives],
+});
+
+export function createHandler(
+  persistedQueries: Record<string, string>,
+  manifest?: Manifest,
+) {
+  return createRouterHandler(
+    listRoutes(),
+    JSResource.srcOfModuleId,
+    router__loadEntryPoint,
+    router__createAppFromEntryPoint,
+    App,
+    schema,
+    () => new Context(),
+    persistedQueries,
+    manifest,
+  );
+}
+`;
+
+function pastoriaEntryPlugin(): Plugin {
+  const clientEntryModuleId = 'virtual:pastoria-entry-client.tsx';
+  const serverEntryModuleId = 'virtual:pastoria-entry-server.tsx';
+
+  return {
+    name: 'pastoria-entry',
+    resolveId(id) {
+      if (id === clientEntryModuleId) {
+        return clientEntryModuleId; // Return without \0 prefix so React plugin can see .tsx extension
+      } else if (id === serverEntryModuleId) {
+        return serverEntryModuleId;
+      }
+    },
+    load(id) {
+      if (id === clientEntryModuleId) {
+        return PASTORIA_CLIENT_ENTRY;
+      } else if (id === serverEntryModuleId) {
+        return PASTORIA_ENTRY_SERVER;
+      }
+    },
+  };
+}
+
+export const CLIENT_BUILD: BuildEnvironmentOptions = {
+  outDir: 'dist/client',
+  rollupOptions: {
+    input: 'virtual:pastoria-entry-client.tsx',
+  },
+};
+
+export const SERVER_BUILD: BuildEnvironmentOptions = {
+  outDir: 'dist/server',
+  ssr: true,
+  rollupOptions: {
+    input: 'virtual:pastoria-entry-server.tsx',
+  },
+};
+
+export function createBuildConfig(buildEnv: BuildEnvironmentOptions) {
+  return {
+    appType: 'custom' as const,
+    build: {
+      ...buildEnv,
+      assetsInlineLimit: 0,
+      manifest: true,
+      ssrManifest: true,
+    },
+    plugins: [
+      pastoriaEntryPlugin(),
+      tailwindcss(),
+      react({babel: {plugins: ['relay']}}),
+      cjsInterop({
+        dependencies: ['react-relay', 'react-relay/hooks', 'relay-runtime'],
+      }),
+    ],
+  };
+}
+
+export async function createBuild() {
+  const clientBuild = await build({
+    ...createBuildConfig(CLIENT_BUILD),
+    configFile: false,
+  });
+
+  const serverBuild = await build({
+    ...createBuildConfig(SERVER_BUILD),
+    configFile: false,
+  });
+}

package/src/devserver.ts

@@ -0,0 +1,53 @@
+import cookieParser from 'cookie-parser';
+import dotenv from 'dotenv';
+import express from 'express';
+import {readFile} from 'node:fs/promises';
+import pc from 'picocolors';
+import {createServer as createViteServer, type Manifest} from 'vite';
+import {CLIENT_BUILD, createBuildConfig} from './build';
+
+interface PersistedQueries {
+  [hash: string]: string;
+}
+
+interface ServerEntry {
+  createHandler(
+    persistedQueries: PersistedQueries,
+    manifest?: Manifest,
+  ): express.Router;
+}
+
+export async function startDevserver(opts: {port: string}) {
+  dotenv.config();
+
+  const buildConfig = createBuildConfig(CLIENT_BUILD);
+  const vite = await createViteServer({
+    ...buildConfig,
+    configFile: false,
+    server: {middlewareMode: true},
+  });
+
+  const app = express();
+  app.use(cookieParser());
+  app.use(vite.middlewares);
+  app.use(async (req, res, next) => {
+    const persistedQueries = JSON.parse(
+      await readFile('__generated__/persisted_queries.json', 'utf-8'),
+    );
+
+    const {createHandler} = (await vite.ssrLoadModule(
+      'virtual:pastoria-entry-server.tsx',
+    )) as ServerEntry;
+
+    const handler = createHandler(persistedQueries);
+    handler(req, res, next);
+  });
+
+  app.listen(Number(opts.port), (err) => {
+    if (err) {
+      console.error(err);
+    } else {
+      console.log(pc.cyan(`Listening on port ${opts.port}!`));
+    }
+  });
+}

package/src/{index.mts → generate.ts}

@@ -1,4 +1,3 @@
-#!/usr/bin/env node --experimental-strip-types
 /**
  * @fileoverview Router Code Generator
  *
@@ -20,12 +19,6 @@
  *
  * The generator automatically creates Zod schemas for route parameters based on
  * TypeScript types, enabling runtime validation and type safety.
- *
- * Roadmap:
- * 1. [DONE] Type-safe router APIs - Generate strongly typed navigation functions
- * 2. Support for useTransition during routing - React 19 concurrent features
- * 3. Support for metadata management in <head>
- * 4. HTML manual generator suitable to be read by LLMs - Auto-generated docs
  */
 
 import {readFile} from 'node:fs/promises';
@@ -35,22 +28,16 @@ import {Project, SourceFile, Symbol, SyntaxKind, ts, TypeFlags} from 'ts-morph';
 
 const JS_RESOURCE_FILENAME = '__generated__/router/js_resource.ts';
 const JS_RESOURCE_TEMPLATE = path.join(
-  path.dirname(new URL(import.meta.url).pathname),
+  import.meta.dirname,
   '../templates/js_resource.ts',
 );
 
 const ROUTER_FILENAME = '__generated__/router/router.tsx';
 const ROUTER_TEMPLATE = path.join(
-  path.dirname(new URL(import.meta.url).pathname),
+  import.meta.dirname,
   '../templates/router.tsx',
 );
 
-const SERVER_ROUTER_FILENAME = '__generated__/router/server_router.ts';
-const SERVER_ROUTER_TEMPLATE = path.join(
-  path.dirname(new URL(import.meta.url).pathname),
-  '../templates/server_router.ts',
-);
-
 async function loadRouterFiles(project: Project) {
   async function loadSourceFile(fileName: string, templateFileName: string) {
     const template = await readFile(templateFileName, 'utf-8');
@@ -65,13 +52,12 @@ async function loadRouterFiles(project: Project) {
     });
   }
 
-  const [jsResource, router, serverRouter] = await Promise.all([
+  const [jsResource, router] = await Promise.all([
     loadSourceFile(JS_RESOURCE_FILENAME, JS_RESOURCE_TEMPLATE),
     loadSourceFile(ROUTER_FILENAME, ROUTER_TEMPLATE),
-    loadSourceFile(SERVER_ROUTER_FILENAME, SERVER_ROUTER_TEMPLATE),
   ]);
 
-  return {jsResource, router, serverRouter} as const;
+  return {jsResource, router} as const;
 }
 
 type RouterResource = {
@@ -92,6 +78,7 @@ function collectRouterNodes(project: Project) {
   const routes: RouterRoute[] = [];
 
   function visitRouterNodes(sourceFile: SourceFile) {
+    // TODO: Skip sourceFile if a pastora JSDoc tag isn't used at all.
     sourceFile.getExportSymbols().forEach((symbol) => {
       let routerResource = null as RouterResource | null;
       let routerRoute = null as RouterRoute | null;
@@ -180,14 +167,13 @@ function zodSchemaOfType(tc: ts.TypeChecker, t: ts.Type): string {
   }
 }
 
-async function main() {
-  const targetDir = path.resolve(process.argv[2] || process.cwd());
-  process.chdir(targetDir);
+export async function generatePastoriaArtifacts() {
+  const targetDir = process.cwd();
   const project = new Project({
     tsConfigFilePath: path.join(targetDir, 'tsconfig.json'),
   });
-  const tc = project.getTypeChecker().compilerObject;
 
+  const tc = project.getTypeChecker().compilerObject;
   const routerFiles = await loadRouterFiles(project);
   const routerNodes = collectRouterNodes(project);
 
@@ -287,11 +273,5 @@ async function main() {
     );
   }
 
-  await Promise.all([
-    routerFiles.jsResource.save(),
-    routerFiles.router.save(),
-    routerFiles.serverRouter.save(),
-  ]);
+  await Promise.all([routerFiles.jsResource.save(), routerFiles.router.save()]);
 }
-
-main().catch(console.error);

package/src/index.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+import {program} from 'commander';
+import {readFile} from 'node:fs/promises';
+import * as path from 'node:path';
+import {createBuild} from './build';
+import {startDevserver} from './devserver';
+import {generatePastoriaArtifacts} from './generate';
+
+async function main() {
+  const packageData = JSON.parse(
+    await readFile(path.join(import.meta.dirname, '../package.json'), 'utf-8'),
+  );
+
+  program
+    .name('pastoria')
+    .description(packageData.description)
+    .version(packageData.version);
+
+  program
+    .command('gen')
+    .description('Run Pastoria code generation')
+    .action(generatePastoriaArtifacts);
+
+  program
+    .command('dev')
+    .description('Start the pastoria devserver')
+    .option('--port <port>', 'Port the devserver will listen on', '3000')
+    .action(startDevserver);
+
+  program
+    .command('build')
+    .description('Creates a production build of the project')
+    .action(createBuild);
+
+  program.parseAsync();
+}
+
+main().catch(console.error);

package/templates/router.tsx

@@ -1,8 +1,15 @@
+import {
+  AnyPreloadedEntryPoint,
+  EnvironmentProvider,
+  relayClientEnvironment,
+  RouterOps,
+} from 'pastoria-runtime';
 import {createRouter} from 'radix3';
 import {
   AnchorHTMLAttributes,
   createContext,
   PropsWithChildren,
+  StrictMode,
   Suspense,
   useCallback,
   useContext,
@@ -10,22 +17,16 @@ import {
   useMemo,
   useState,
 } from 'react';
+import {preinit, preloadModule} from 'react-dom';
 import {
   EntryPoint,
   EntryPointContainer,
-  EnvironmentProviderOptions,
-  IEnvironmentProvider,
   loadEntryPoint,
-  PreloadedEntryPoint,
+  RelayEnvironmentProvider,
   useEntryPointLoader,
 } from 'react-relay/hooks';
-import {OperationDescriptor, PayloadData} from 'relay-runtime';
-import type {Manifest} from 'vite';
 import * as z from 'zod/v4-mini';
 
-export type AnyPreloadedEntryPoint = PreloadedEntryPoint<any>;
-export type RouterOps = [OperationDescriptor, PayloadData][];
-
 type RouterConf = typeof ROUTER_CONF;
 const ROUTER_CONF = {
   noop: {
@@ -121,9 +122,7 @@ function useLocation(initialPath?: string) {
   return [location, setLocation] as const;
 }
 
-export function router__hydrateStore(
-  provider: IEnvironmentProvider<EnvironmentProviderOptions>,
-) {
+export function router__hydrateStore(provider: EnvironmentProvider) {
   const env = provider.getEnvironment(null);
   if ('__router_ops' in window) {
     const ops = (window as any).__router_ops as RouterOps;
@@ -134,7 +133,7 @@ export function router__hydrateStore(
 }
 
 export async function router__loadEntryPoint(
-  provider: IEnvironmentProvider<EnvironmentProviderOptions>,
+  provider: EnvironmentProvider,
   initialPath?: string,
 ) {
   if (!initialPath) initialPath = window.location.href;
@@ -159,12 +158,63 @@ const RouterContext = createContext<RouterContextValue>({
   setLocation: () => {},
 });
 
+const REACT_REFRESH_SCRIPT = `
+import RefreshRuntime from 'http://localhost:3000/@react-refresh'
+RefreshRuntime.injectIntoGlobalHook(window)
+window.$RefreshReg$ = () => {}
+window.$RefreshSig$ = () => (type) => type
+window.__vite_plugin_react_preamble_installed__ = true`;
+
 export function router__createAppFromEntryPoint(
-  provider: IEnvironmentProvider<EnvironmentProviderOptions>,
   initialEntryPoint: AnyPreloadedEntryPoint | null,
+  provider: EnvironmentProvider,
   initialPath?: string,
 ) {
-  function RouterApp() {
+  const env = provider.getEnvironment(null);
+
+  function RouterShell({
+    preloadModules,
+    preloadStylesheets,
+    children,
+  }: PropsWithChildren<{
+    preloadModules?: string[];
+    preloadStylesheets?: string[];
+  }>) {
+    for (const m of preloadModules ?? []) {
+      preloadModule(m, {as: 'script'});
+    }
+
+    for (const s of preloadStylesheets ?? []) {
+      preinit(s, {as: 'style'});
+    }
+
+    return (
+      <StrictMode>
+        <RelayEnvironmentProvider environment={env}>
+          <html>
+            <head>
+              <meta charSet="utf-8" />
+              <meta
+                name="viewport"
+                content="width=device-width, initial-scale=1"
+              />
+
+              {process.env.NODE_ENV !== 'production' && (
+                <script
+                  type="module"
+                  dangerouslySetInnerHTML={{__html: REACT_REFRESH_SCRIPT}}
+                />
+              )}
+            </head>
+
+            <body>{children}</body>
+          </html>
+        </RelayEnvironmentProvider>
+      </StrictMode>
+    );
+  }
+
+  function RouterCore() {
     const [location, setLocation] = useLocation(initialPath);
     const routerContextValue = useMemo(
       (): RouterContextValue => ({
@@ -213,16 +263,34 @@ export function router__createAppFromEntryPoint(
     );
   }
 
-  RouterApp.bootstrap = (manifest?: Manifest): string | null => null;
+  function RouterApp(props: {
+    preloadModules?: string[];
+    preloadStylesheets?: string[];
+    App?: React.ComponentType<PropsWithChildren<{}>> | null;
+  }) {
+    return (
+      <RouterShell
+        preloadModules={props.preloadModules}
+        preloadStylesheets={props.preloadStylesheets}
+      >
+        {props.App == null ? (
+          <RouterCore />
+        ) : (
+          <props.App children={<RouterCore />} />
+        )}
+      </RouterShell>
+    );
+  }
+
   return RouterApp;
 }
 
-export async function createRouterApp(
-  provider: IEnvironmentProvider<EnvironmentProviderOptions>,
-) {
+export async function createRouterApp() {
+  const provider = relayClientEnvironment;
+
   router__hydrateStore(provider);
   const ep = await router__loadEntryPoint(provider);
-  return router__createAppFromEntryPoint(provider, ep);
+  return router__createAppFromEntryPoint(ep, provider);
 }
 
 export function usePath() {

package/tsconfig.json

@@ -1,17 +1,19 @@
 {
   "compilerOptions": {
     "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "allowSyntheticDefaultImports": true,
+    "module": "ES2022",
+    "lib": ["ES2022", "DOM"],
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
     "esModuleInterop": true,
-    "strict": false,
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
-    "downlevelIteration": true,
-    "types": ["node"],
-    "lib": ["ES2022"],
-    "noEmit": true
+    "jsx": "react-jsx"
   },
   "include": ["src/**/*"],
   "exclude": ["node_modules", "dist"]

package/templates/server_router.ts

@@ -1,112 +0,0 @@
-import {
-  EnvironmentProviderOptions,
-  IEnvironmentProvider,
-  OperationDescriptor,
-  PreloadedQuery,
-} from 'react-relay/hooks';
-import {
-  createOperationDescriptor,
-  GraphQLResponse,
-  GraphQLSingularResponse,
-  OperationType,
-  PayloadData,
-  PreloadableQueryRegistry,
-} from 'relay-runtime';
-import serialize from 'serialize-javascript';
-import type {Manifest} from 'vite';
-import {JSResource} from './js_resource';
-import {
-  AnyPreloadedEntryPoint,
-  router__createAppFromEntryPoint,
-  router__loadEntryPoint,
-  RouterOps,
-} from './router';
-
-type AnyPreloadedQuery = PreloadedQuery<OperationType>;
-
-function router__bootstrapScripts(
-  entryPoint: AnyPreloadedEntryPoint,
-  ops: RouterOps,
-  manifest?: Manifest,
-) {
-  let bootstrap = `
-      <script type="text/javascript">
-        window.__router_ops = ${serialize(ops)};
-      </script>`;
-
-  const rootModuleSrc = JSResource.srcOfModuleId(entryPoint.rootModuleID);
-  if (rootModuleSrc == null) return bootstrap;
-
-  function crawlImports(moduleName: string) {
-    const chunk = manifest?.[moduleName];
-    if (!chunk) return;
-
-    chunk.imports?.forEach(crawlImports);
-    bootstrap =
-      `<link rel="modulepreload" href="${chunk.file}" />\n` + bootstrap;
-  }
-
-  crawlImports(rootModuleSrc);
-  return bootstrap;
-}
-
-async function router__ensureQueryFlushed(
-  query: AnyPreloadedQuery,
-): Promise<GraphQLResponse> {
-  return new Promise((resolve, reject) => {
-    if (query.source == null) {
-      resolve({data: {}});
-    } else {
-      query.source.subscribe({
-        next: resolve,
-        error: reject,
-      });
-    }
-  });
-}
-
-async function router__loadQueries(entryPoint: AnyPreloadedEntryPoint) {
-  const preloadedQueryOps: [OperationDescriptor, PayloadData][] = [];
-  for (const query of Object.values(
-    entryPoint?.queries ?? {},
-  ) as PreloadedQuery<OperationType>[]) {
-    try {
-      const payload = await router__ensureQueryFlushed(query);
-      const concreteRequest =
-        query.id == null ? null : PreloadableQueryRegistry.get(query.id);
-
-      if (concreteRequest != null) {
-        const desc = createOperationDescriptor(
-          concreteRequest,
-          query.variables,
-        );
-
-        preloadedQueryOps.push([
-          desc,
-          (payload as GraphQLSingularResponse).data!,
-        ]);
-      }
-    } catch (e) {
-      console.error(e);
-      throw e;
-    }
-  }
-
-  return preloadedQueryOps;
-}
-
-export async function createRouterServerApp(
-  provider: IEnvironmentProvider<EnvironmentProviderOptions>,
-  initialPath: string,
-) {
-  const ep = await router__loadEntryPoint(provider, initialPath);
-  const ops = ep != null ? await router__loadQueries(ep) : [];
-  const RouterApp = router__createAppFromEntryPoint(provider, ep, initialPath);
-
-  if (ep != null) {
-    RouterApp.bootstrap = (manifest) =>
-      router__bootstrapScripts(ep, ops, manifest);
-  }
-
-  return RouterApp;
-}