@luckystack/devkit 0.10.1 → 0.10.2

package/CHANGELOG.md

@@ -5,7 +5,11 @@ All notable changes to `@luckystack/devkit` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.10.2] - 2026-10-09
+
+### Added
+
+- The type-map generator emits `syncMetaMap` / `getSyncMeta` (auth + rateLimit per sync route) in `apiTypes.generated.ts` and `syncInputSchemas` / `getSyncInputSchema` (Zod schema of each sync route's `clientInput`) in `apiInputSchemas.generated.ts` — the sync counterparts of `apiMetaMap` and `apiInputSchemas`. Only routes with a `_server_v<N>.ts` file are listed. This lets the `@luckystack/test-runner` auto-sweep layers reach sync routes, not just API routes. A sync input that falls back to `z.any()` is now reported in `apiTypeDiagnostics.generated.json`, like an API input.
 
 ## [0.9.2] - 2026-09-01
 

package/CLAUDE.md

@@ -42,7 +42,7 @@ Dev-time tooling for LuckyStack projects: file-based route discovery + in-memory
 | `devSyncs` | In-memory map of `route key (with _server / _client suffix) -> server entry record or client callback function`. | -> docs/loader-pipeline.md |
 | `devFunctions` | Nested mirror of `serverFunctionsDir`. Each leaf is a module's named + default exports, with later folder scans merging onto existing nodes. | -> docs/loader-pipeline.md |
 | `setupWatchers()` | Boots the chokidar watchers for `srcDir` / each `serverFunctionDirs` root / `sharedDir` (legacy singular `serverFunctionsDir` still honored when set), coalesces hot-reload + type-map regenerations, fires initial background type-map generation. No-op when `NODE_ENV === 'production'`. | -> docs/hot-reload.md |
-| `generateTypeMapFile(options?)` | Discovers all `_api/` and `_sync/` files, runs the TypeChecker-backed extractors, emits `apiTypes.generated.ts`, `apiInputSchemas.generated.ts`, and `apiDocs.generated.json`. Aborts if any unresolved type symbol is found. | -> docs/type-map-generation.md |
+| `generateTypeMapFile(options?)` | Discovers all `_api/` and `_sync/` files, runs the TypeChecker-backed extractors, emits `apiTypes.generated.ts` (incl. `apiMetaMap` + `syncMetaMap`), `apiInputSchemas.generated.ts` (`apiInputSchemas` + `syncInputSchemas`), and `apiDocs.generated.json`. Aborts if any unresolved type symbol is found. | -> docs/type-map-generation.md |
 | `getInputTypeFromFile(filePath)` | Public extractor: returns the inline-expanded `data` input type text for one API file. Consumed by the dev loader to drive `runtimeTypeValidation`. | -> docs/type-map-generation.md |
 | `getSyncClientDataType(filePath)` | Public extractor: returns the inline-expanded `clientInput` (sync server) or client data (sync client) type text. | -> docs/type-map-generation.md |
 | `API_VERSION_TOKEN_REGEX` | Canonical `_v<number>` regex used to parse API filenames. | -> docs/loader-pipeline.md |

package/dist/index.js

@@ -867,6 +867,75 @@ var findExtractionFailure = (route, kind, field) => {
 };
 
 // src/typeMap/emitterArtifacts.ts
+var compareVersions = (a, b) => a.version.localeCompare(b.version, void 0, { numeric: true });
+var renderRouteMetaFields = (authValue, rateLimit) => {
+  const auth = authValue && typeof authValue === "object" ? authValue : { login: false, hasAdditional: false };
+  const rateLimitPart = rateLimit === void 0 ? "" : `, rateLimit: ${rateLimit === false ? "false" : String(rateLimit)}`;
+  const additionalPart = auth.additional && auth.additional.length > 0 ? `, additional: ${JSON.stringify(auth.additional)}` : "";
+  return `auth: { login: ${auth.login ? "true" : "false"}${additionalPart}${auth.hasAdditional ? ", hasAdditional: true" : ""} }${rateLimitPart}`;
+};
+var inputSchemaSource = (typeText) => typeTextToZodSource(typeText) ?? "z.any() /* unparseable input type */";
+var groupServerSyncRoutes = (syncTypesByPage) => {
+  const pages = [];
+  for (const pagePath of [...syncTypesByPage.keys()].toSorted()) {
+    const grouped = /* @__PURE__ */ new Map();
+    for (const [syncKey, entry] of mustGet(syncTypesByPage, pagePath, "syncTypesByPage")) {
+      if (!entry.serverMeta) continue;
+      const { name, version } = splitVersionedKey(syncKey);
+      getOrInit(grouped, name, () => []).push({ version, clientInput: entry.clientInput, serverMeta: entry.serverMeta });
+    }
+    if (grouped.size === 0) continue;
+    pages.push([
+      pagePath,
+      [...grouped.keys()].toSorted().map((name) => [name, mustGet(grouped, name, "grouped").toSorted(compareVersions)])
+    ]);
+  }
+  return pages;
+};
+var renderServerSyncRouteMap = (syncTypesByPage, renderValue) => {
+  let body = "";
+  for (const [pagePath, syncs] of groupServerSyncRoutes(syncTypesByPage)) {
+    body += `  '${pagePath}': {
+`;
+    for (const [syncName, routes] of syncs) {
+      body += `    '${syncName}': {
+`;
+      for (const route of routes) {
+        body += `      '${route.version}': ${renderValue(route)},
+`;
+      }
+      body += `    },
+`;
+    }
+    body += `  },
+`;
+  }
+  return body;
+};
+var buildSyncMetaMapSource = (syncTypesByPage) => `export interface SyncMetaEntry {
+	auth: { login: boolean; additional?: Record<string, unknown>[]; hasAdditional?: boolean };
+	rateLimit?: number | false;
+}
+
+export const syncMetaMap: Record<string, Record<string, Record<string, SyncMetaEntry>>> = {
+${renderServerSyncRouteMap(syncTypesByPage, (route) => `{ ${renderRouteMetaFields(route.serverMeta.auth, route.serverMeta.rateLimit)} }`)}};
+
+export const getSyncMeta = (pagePath: string, syncName: string, version: string): SyncMetaEntry | undefined => {
+	return syncMetaMap[pagePath]?.[syncName]?.[version];
+};
+`;
+var buildSyncInputSchemasSource = (syncTypesByPage) => `
+export const syncInputSchemas: Record<string, Record<string, Record<string, z.ZodTypeAny>>> = {
+${renderServerSyncRouteMap(syncTypesByPage, (route) => inputSchemaSource(route.clientInput))}};
+
+export const getSyncInputSchema = (
+	pagePath: string,
+	syncName: string,
+	version: string,
+): z.ZodTypeAny | undefined => {
+	return syncInputSchemas[pagePath]?.[syncName]?.[version];
+};
+`;
 var buildImportStatements = ({
   namedImports,
   defaultImports
@@ -1060,7 +1129,7 @@ var collectFallbacks = (typesByPage, syncTypesByPage) => {
     for (const [syncKey, entry] of syncs) {
       const { name, version } = splitVersionedKey(syncKey);
       const route = `${pagePath}/${name}@${version}`;
-      flagField(route, "sync", "clientInput", entry.clientInput);
+      flagField(route, "sync", "clientInput", entry.clientInput, entry.serverMeta !== void 0);
       flagField(route, "sync", "serverOutput", entry.serverOutput, false, !entry.hasServer);
       flagField(route, "sync", "clientOutput", entry.clientOutput, false, !entry.hasClient);
       flagField(route, "sync", "serverStream", entry.serverStream);
@@ -1254,10 +1323,7 @@ export const apiMetaMap: Record<string, Record<string, Record<string, ApiMetaEnt
       content += `    '${apiName}': {
 `;
       for (const { version, entry } of mustGet(grouped, apiName, "grouped").toSorted((a, b) => a.version.localeCompare(b.version, void 0, { numeric: true }))) {
-        const auth = entry.auth && typeof entry.auth === "object" ? entry.auth : { login: false, hasAdditional: false };
-        const rateLimitPart = entry.rateLimit === void 0 ? "" : `, rateLimit: ${entry.rateLimit === false ? "false" : String(entry.rateLimit)}`;
-        const additionalPart = auth.additional && auth.additional.length > 0 ? `, additional: ${JSON.stringify(auth.additional)}` : "";
-        content += `      '${version}': { method: '${entry.method}', auth: { login: ${auth.login ? "true" : "false"}${additionalPart}${auth.hasAdditional ? ", hasAdditional: true" : ""} }${rateLimitPart} },
+        content += `      '${version}': { method: '${entry.method}', ${renderRouteMetaFields(entry.auth, entry.rateLimit)} },
 `;
       }
       content += `    },
@@ -1272,6 +1338,7 @@ export const getApiMeta = (pagePath: string, apiName: string, version: string):
 	return apiMetaMap[pagePath]?.[apiName]?.[version];
 };
 
+${buildSyncMetaMapSource(syncTypesByPage)}
 // Sync Type Definitions
 // 
 
@@ -1371,7 +1438,7 @@ declare module '@luckystack/core/typemap' {
 `;
   content = stripSymbolKeyedMembers(content);
   validateGeneratedTypeIdentifiers(content);
-  const schemasContent = buildSchemasContent({ typesByPage });
+  const schemasContent = buildSchemasContent({ typesByPage, syncTypesByPage });
   const fallbacks = collectFallbacks(typesByPage, syncTypesByPage);
   const totalRoutes = [...typesByPage.values()].reduce((n, m) => n + m.size, 0) + [...syncTypesByPage.values()].reduce((n, m) => n + m.size, 0);
   const diagnosticsData = {
@@ -1383,11 +1450,13 @@ declare module '@luckystack/core/typemap' {
   return { content, docsData, schemasContent, diagnosticsData };
 };
 var buildSchemasContent = ({
-  typesByPage
+  typesByPage,
+  syncTypesByPage
 }) => {
   const sortedPages = [...typesByPage.keys()].toSorted();
   let body = `/* eslint-disable */
-//? Auto-generated Zod schemas for every API input. Driven by the same walk
+//? Auto-generated Zod schemas for every API input and every sync-server
+//? clientInput. Driven by the same walk
 //? as apiTypes.generated.ts; see @luckystack/devkit/src/typeMap/zodEmitter.ts
 //? for the TS-AST \xE2\u2020\u2019 Zod converter. Types that fall outside the converter's
 //? scope emit \`z.any()\` with a TODO comment.
@@ -1412,8 +1481,7 @@ export const apiInputSchemas: Record<string, Record<string, Record<string, z.Zod
       for (const { version, entry } of mustGet(grouped, apiName, "grouped").toSorted(
         (a, b) => a.version.localeCompare(b.version, void 0, { numeric: true })
       )) {
-        const schemaSrc = typeTextToZodSource(entry.input) ?? "z.any() /* unparseable input type */";
-        body += `      '${version}': ${schemaSrc},
+        body += `      '${version}': ${inputSchemaSource(entry.input)},
 `;
       }
       body += `    },
@@ -1432,6 +1500,7 @@ export const getApiInputSchema = (
 	return apiInputSchemas[pagePath]?.[apiName]?.[version];
 };
 `;
+  body += buildSyncInputSchemasSource(syncTypesByPage);
   return body;
 };
 var writeTypeMapArtifacts = ({
@@ -2971,7 +3040,9 @@ var collectSyncTypes = (syncServerFiles, syncClientFiles, collectors) => {
       version: syncVersion,
       hasServer: serverFile !== void 0,
       hasClient: clientFile !== void 0,
-      ...syncMeta ? { meta: syncMeta } : {}
+      ...syncMeta ? { meta: syncMeta } : {},
+      //? Same extractors as the API side, so `syncMetaMap` and `apiMetaMap` agree.
+      ...serverFile ? { serverMeta: { auth: extractAuth(serverFile), rateLimit: extractRateLimit(serverFile) } } : {}
     });
   }
   return syncTypesByPage;