@luckystack/devkit 0.9.1 → 0.10.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.2] - 2026-09-01
+
+### Fixed
+
+- A sync route without the optional `_client` handler is no longer reported as
+  degraded type extraction. `apiTypeDiagnostics.generated.json` matched on the
+  fallback TEXT alone, and an absent side produces the same `{ }` as a side that
+  is present but declares no shape — so every deliberately server-only sync
+  landed in `fallbackCount` as a `default-fallback`. In a real project that was
+  44 of 46 reported fallbacks, and the only way to silence them was to add the
+  no-op `_client` handlers `ARCHITECTURE_SYNC.md` tells you not to write (they
+  cost one execution per recipient). The generator now carries which sides were
+  actually found and suppresses only the missing side's own field. A thrown
+  extraction is still checked first and always reported, and a side that IS
+  present keeps falling back exactly as before.
+
 ## [0.8.7] - 2026-08-18
 
 ### Fixed

package/CLAUDE.md

@@ -101,6 +101,8 @@ Object literal types → `.strict()` (unknown keys rejected, fail-closed). This
 
 Every `generateTypeMapFile()` run emits `apiTypeDiagnostics.generated.json` alongside `apiDocs.generated.json`. It lists every route whose type extraction degraded to a fallback (source file miss, thrown API/sync input/output/**stream** extraction, or `z.any()` in the Zod schema). Shape: `{ generatedAt, totalRoutes, fallbackCount, fallbacks: DiagnosticsEntry[] }`. CI can fail on non-zero `fallbackCount` to enforce type-fidelity. The file path is `<generatedApiDocs dir>/apiTypeDiagnostics.generated.json`.
 
+One case is deliberately NOT a fallback: a sync side that does not exist on disk. `_client` is optional by contract (`/docs/ARCHITECTURE_SYNC.md` — a pass-through sync must not have one, because a no-op handler costs an execution per recipient), and an absent side yields the same `{ }` text as a present side that declares no shape. The generator therefore carries per-entry presence flags so the emitter can tell the two apart, and suppresses only the field belonging to the missing side. A THROWN extraction is still checked first and always reported, so this can never hide a real failure — do not widen the exception past the missing side's own field.
+
 **D4 — transport-safe route contracts**
 
 Output extraction projects `JSON.stringify` semantics recursively: `Date` becomes `string`; `toJSON()` becomes its return type; omitted object values (`undefined`, symbol, every callable value) disappear or make a union-valued property optional; those values become `null` in arrays/tuples. Binary values are rejected because HTTP JSON and Socket.io binary delivery cannot share one truthful output type. Input extraction does not project declarations, but rejects `Date`: JSON can only deliver an ISO string, so route authors must declare `string`, validate it, and convert explicitly before using Date methods.

package/dist/index.js

@@ -1030,14 +1030,16 @@ var validateGeneratedTypeIdentifiers = (content) => {
 };
 var collectFallbacks = (typesByPage, syncTypesByPage) => {
   const entries = [];
-  const flagField = (route, kind, field, value, checkZod = false) => {
+  const flagField = (route, kind, field, value, checkZod = false, intentionalDefault = false) => {
     const extractionError = findExtractionFailure(route, kind, field);
     if (extractionError !== void 0) {
       entries.push({ route, kind, field, fallback: value, reason: "extraction-error", detail: extractionError });
       return;
     }
     if (value === "{ }" || value === "{ status: string }") {
-      entries.push({ route, kind, field, fallback: value, reason: "default-fallback" });
+      if (!intentionalDefault) {
+        entries.push({ route, kind, field, fallback: value, reason: "default-fallback" });
+      }
       return;
     }
     const zodSrc = checkZod ? typeTextToZodSource(value) : null;
@@ -1059,8 +1061,8 @@ var collectFallbacks = (typesByPage, syncTypesByPage) => {
       const { name, version } = splitVersionedKey(syncKey);
       const route = `${pagePath}/${name}@${version}`;
       flagField(route, "sync", "clientInput", entry.clientInput);
-      flagField(route, "sync", "serverOutput", entry.serverOutput);
-      flagField(route, "sync", "clientOutput", entry.clientOutput);
+      flagField(route, "sync", "serverOutput", entry.serverOutput, false, !entry.hasServer);
+      flagField(route, "sync", "clientOutput", entry.clientOutput, false, !entry.hasClient);
       flagField(route, "sync", "serverStream", entry.serverStream);
       flagField(route, "sync", "clientStream", entry.clientStream);
     }
@@ -2967,6 +2969,8 @@ var collectSyncTypes = (syncServerFiles, syncClientFiles, collectors) => {
       serverStream: serverStreamType,
       clientStream: clientStreamType,
       version: syncVersion,
+      hasServer: serverFile !== void 0,
+      hasClient: clientFile !== void 0,
       ...syncMeta ? { meta: syncMeta } : {}
     });
   }