stitchkit 0.68.0 → 0.68.2

package/dist/react/entity-cache.d.ts

@@ -4,7 +4,7 @@
  * infinite TanStack Query data without changing its envelope metadata.
  */
 import type { QueryKey } from '@tanstack/react-query';
-import type { CacheBridgeHandler } from './cache-bridge';
+import type { CacheBridgeHandler } from './cache-bridge.js';
 /** The `deleted` event may carry the whole entity or only its id. */
 export type DeletedPayload<TData> = TData | {
     id: string;
@@ -26,6 +26,27 @@ export type EntityCacheEvent<TData> = {
 /** A static cache key/prefix or an event-aware key factory. */
 export type EntityCacheKey<TData> = QueryKey | ((event: EntityCacheEvent<TData>) => QueryKey);
 export type EntityCacheListShape = 'array' | 'paginated' | 'infinite-array' | 'infinite-paginated';
+export type EntityCacheMembership = 'include' | 'exclude' | 'unknown';
+export interface EntityCacheMembershipPolicy<TData> {
+    /** Backend-equivalent membership for this exact cached query key. */
+    evaluate(event: EntityCacheEvent<TData>, queryKey: QueryKey): EntityCacheMembership;
+    /** What to do when the event cannot prove membership. Default `preserve`. */
+    unknown?: 'preserve' | 'invalidate';
+}
+export interface EntityCacheTotalDeltaInput<TData> {
+    event: EntityCacheEvent<TData>;
+    queryKey: QueryKey;
+    present: boolean;
+    membership: EntityCacheMembership;
+}
+export interface EntityCacheTotalPolicy<TData> {
+    /** Reconcile a numeric `total` field when the event proves a delta. */
+    mode: 'reconcile';
+    /** Override the conservative built-in delta when the event carries transition evidence. */
+    delta?(input: EntityCacheTotalDeltaInput<TData>): number | 'unknown';
+    /** What to do when an unseen id makes the delta unknowable. Default `preserve`. */
+    unknown?: 'preserve' | 'invalidate';
+}
 /** List envelope, scoped key and explicit CRUD policies. */
 export interface EntityCacheListConfig<TData, TListItem> {
     /** Static query-key prefix or an event-aware scoped key factory. */
@@ -38,6 +59,10 @@ export interface EntityCacheListConfig<TData, TListItem> {
     compare?: (left: TListItem, right: TListItem) => number;
     /** Cached data envelope; no runtime shape inference is performed. */
     shape: EntityCacheListShape;
+    /** Optional per-query filter membership. Omit for the envelope-preserving legacy path. */
+    membership?: EntityCacheMembershipPolicy<TData>;
+    /** Optional reconciliation of a numeric paginated `total` field. */
+    total?: EntityCacheTotalPolicy<TData>;
 }
 /** Config for `createEntityCacheHandlers`. */
 export interface EntityCacheConfig<TData, TListItem = TData> {

package/dist/react/entity-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-cache.d.ts","sourceRoot":"","sources":["../../src/react/entity-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAgB,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGpE,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,qEAAqE;AACrE,MAAM,MAAM,cAAc,CAAC,KAAK,IAAI,KAAK,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,CAAC,KAAK,IAC9B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,+DAA+D;AAC/D,MAAM,MAAM,cAAc,CAAC,KAAK,IAAI,QAAQ,GAAG,CAAC,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC;AAE9F,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,WAAW,GACX,gBAAgB,GAChB,oBAAoB,CAAC;AAEzB,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB,CAAC,KAAK,EAAE,SAAS;IACrD,oEAAoE;IACpE,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC;IAC1B,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjC,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC;IACxD,qEAAqE;IACrE,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK;IACzD,uDAAuD;IACvD,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,CAAC;IACjC,kEAAkE;IAClE,aAAa,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC;IAC3C,sEAAsE;IACtE,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC;IACzC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC;IAC1D,yEAAyE;IACzE,IAAI,EAAE,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9C,iFAAiF;IACjF,SAAS,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;CACnC;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB,CAAC,KAAK;IACxC,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,EAAE,kBAAkB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;CACpD;AAiJD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,EAChE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,GAC1C,mBAAmB,CAAC,KAAK,CAAC,CAkD5B"}
+{"version":3,"file":"entity-cache.d.ts","sourceRoot":"","sources":["../../src/react/entity-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAgB,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGpE,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,qEAAqE;AACrE,MAAM,MAAM,cAAc,CAAC,KAAK,IAAI,KAAK,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,CAAC,KAAK,IAC9B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,+DAA+D;AAC/D,MAAM,MAAM,cAAc,CAAC,KAAK,IAAI,QAAQ,GAAG,CAAC,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC;AAE9F,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,WAAW,GACX,gBAAgB,GAChB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,2BAA2B,CAAC,KAAK;IAChD,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,qBAAqB,CAAC;IACpF,6EAA6E;IAC7E,OAAO,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B,CAAC,KAAK;IAC/C,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,qBAAqB,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB,CAAC,KAAK;IAC3C,uEAAuE;IACvE,IAAI,EAAE,WAAW,CAAC;IAClB,2FAA2F;IAC3F,KAAK,CAAC,CAAC,KAAK,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;IACrE,mFAAmF;IACnF,OAAO,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;CACrC;AAED,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB,CAAC,KAAK,EAAE,SAAS;IACrD,oEAAoE;IACpE,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC;IAC1B,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjC,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC;IACxD,qEAAqE;IACrE,KAAK,EAAE,oBAAoB,CAAC;IAC5B,0FAA0F;IAC1F,UAAU,CAAC,EAAE,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAChD,oEAAoE;IACpE,KAAK,CAAC,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC;CACvC;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK;IACzD,uDAAuD;IACvD,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,CAAC;IACjC,kEAAkE;IAClE,aAAa,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC;IAC3C,sEAAsE;IACtE,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC;IACzC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC;IAC1D,yEAAyE;IACzE,IAAI,EAAE,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9C,iFAAiF;IACjF,SAAS,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;CACnC;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB,CAAC,KAAK;IACxC,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,EAAE,kBAAkB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;CACpD;AAoQD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,EAChE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,GAC1C,mBAAmB,CAAC,KAAK,CAAC,CAyD5B"}

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-export { type CacheBridge, type CacheBridgeConfig, type CacheBridgeContext, type CacheBridgeHandler, type CacheBridgeHandlers, type CacheBridgeSocket, createCacheBridge, } from './react/cache-bridge';
-export { type CursorQueryConfig, createCursorQuery } from './react/cursor-query';
-export { createEntityCacheHandlers, type DeletedPayload, type EntityCacheConfig, type EntityCacheEvent, type EntityCacheHandlers, type EntityCacheKey, type EntityCacheListConfig, type EntityCacheListShape, } from './react/entity-cache';
+export { type CacheBridge, type CacheBridgeConfig, type CacheBridgeContext, type CacheBridgeHandler, type CacheBridgeHandlers, type CacheBridgeSocket, createCacheBridge, } from './react/cache-bridge.js';
+export { type CursorQueryConfig, createCursorQuery } from './react/cursor-query.js';
+export { createEntityCacheHandlers, type DeletedPayload, type EntityCacheConfig, type EntityCacheEvent, type EntityCacheHandlers, type EntityCacheKey, type EntityCacheListConfig, type EntityCacheListShape, type EntityCacheMembership, type EntityCacheMembershipPolicy, type EntityCacheTotalDeltaInput, type EntityCacheTotalPolicy, } from './react/entity-cache.js';
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EACL,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EACL,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC"}

package/dist/react.js

@@ -104,20 +104,29 @@ function insertAt(items, item, at, compare) {
 function mutateItemArrays(arrays, mutation, config, getId) {
   const present = arrays.some((items) => items.some((item) => getId(item) === mutation.id));
   if (mutation.type === "created" && present)
-    return arrays;
+    return { arrays, present };
   if (mutation.type === "updated" && !present && config.updateMissing === "skip") {
-    return arrays;
+    return { arrays, present };
   }
   if (mutation.type !== "deleted" && (!present || mutation.type === "created")) {
     if (arrays.length === 0)
-      return arrays;
+      return { arrays, present };
     const target = config.createAt === "start" ? 0 : arrays.length - 1;
-    return arrays.map((items, index) => index === target ? insertAt(items, mutation.item, config.createAt, config.compare) : items);
+    return {
+      arrays: arrays.map((items, index) => index === target ? insertAt(items, mutation.item, config.createAt, config.compare) : items),
+      present
+    };
   }
   if (mutation.type === "deleted") {
-    return arrays.map((items) => items.filter((item) => getId(item) !== mutation.id));
+    return {
+      arrays: arrays.map((items) => items.filter((item) => getId(item) !== mutation.id)),
+      present
+    };
   }
-  return arrays.map((items) => ordered(items.map((item) => getId(item) === mutation.id ? mutation.item : item), config.compare));
+  return {
+    arrays: arrays.map((items) => ordered(items.map((item) => getId(item) === mutation.id ? mutation.item : item), config.compare)),
+    present
+  };
 }
 function firstArray(arrays) {
   const first = arrays[0];
@@ -125,51 +134,140 @@ function firstArray(arrays) {
     throw new Error("Entity cache list adapter lost its only item array");
   return first;
 }
+function totalDelta(mutation, present, membership) {
+  if (mutation.type === "deleted") {
+    if (present)
+      return -1;
+    return "unknown";
+  }
+  if (membership === "unknown")
+    return "unknown";
+  if (mutation.type === "created") {
+    if (present)
+      return 0;
+    return membership === "include" ? 1 : 0;
+  }
+  if (present)
+    return membership === "exclude" ? -1 : 0;
+  return "unknown";
+}
+function reconcileTotal(value, delta) {
+  if (delta === "unknown")
+    return value;
+  if (!Number.isSafeInteger(delta)) {
+    throw new Error('Entity cache total delta must be a safe integer or "unknown"');
+  }
+  const current = Reflect.get(value, "total");
+  if (typeof current !== "number" || !Number.isSafeInteger(current) || current < 0) {
+    return value;
+  }
+  return { ...value, total: Math.max(0, current + delta) };
+}
 function unsupportedListShape(shape) {
   throw new Error(`Unsupported entity cache list shape: ${String(shape)}`);
 }
-function patchList(context, key, config, mutation, getId) {
-  const mutate = (arrays) => mutateItemArrays(arrays, mutation, config, getId);
-  switch (config.shape) {
-    case "array":
-      context.queryClient.setQueriesData({ queryKey: key }, (old) => Array.isArray(old) ? firstArray(mutate([old])) : old);
-      return;
-    case "paginated":
-      context.queryClient.setQueriesData({ queryKey: key }, (old) => isRecord(old) && Array.isArray(old.items) ? { ...old, items: firstArray(mutate([old.items])) } : old);
-      return;
-    case "infinite-array":
-      context.queryClient.setQueriesData({ queryKey: key }, (old) => isRecord(old) && Array.isArray(old.pages) && old.pages.every((page) => Array.isArray(page)) ? { ...old, pages: mutate(old.pages) } : old);
-      return;
-    case "infinite-paginated":
-      context.queryClient.setQueriesData({ queryKey: key }, (old) => {
-        if (!isRecord(old) || !Array.isArray(old.pages) || !old.pages.every((page) => isRecord(page) && Array.isArray(page.items))) {
-          return old;
-        }
-        const items = mutate(old.pages.map((page) => page.items));
-        return {
-          ...old,
-          pages: old.pages.map((page, index) => {
-            const pageItems = items[index];
-            if (!pageItems) {
-              throw new Error("Entity cache list adapter changed the page count");
-            }
-            return { ...page, items: pageItems };
-          })
-        };
-      });
+function patchList(context, key, config, event, mutation, getId) {
+  const queries = context.queryClient.getQueryCache().findAll({ queryKey: key });
+  const patchExact = (exactKey, membership) => {
+    const effectiveMutation = membership === "exclude" && mutation.type !== "deleted" ? { type: "deleted", id: mutation.id } : mutation;
+    const unknown = membership === "unknown";
+    if (unknown && mutation.type !== "deleted") {
+      if (config.membership?.unknown === "invalidate" || config.total?.unknown === "invalidate") {
+        context.queryClient.invalidateQueries({ queryKey: exactKey, exact: true });
+      }
       return;
-    default:
-      unsupportedListShape(config.shape);
+    }
+    let invalidateMembership = false;
+    const mutate = (arrays) => {
+      const result = mutateItemArrays(arrays, effectiveMutation, config, getId);
+      if (membership === "unknown" && mutation.type === "deleted" && !result.present && config.membership?.unknown === "invalidate") {
+        invalidateMembership = true;
+      }
+      return result;
+    };
+    let invalidateTotal = false;
+    const reconcile = (value, delta) => {
+      if (delta === "unknown" && config.total?.unknown === "invalidate") {
+        invalidateTotal = true;
+      }
+      return reconcileTotal(value, delta);
+    };
+    const invalidateIfNeeded = () => {
+      if (invalidateMembership || invalidateTotal) {
+        context.queryClient.invalidateQueries({ queryKey: exactKey, exact: true });
+      }
+    };
+    switch (config.shape) {
+      case "array":
+        context.queryClient.setQueryData(exactKey, (old) => Array.isArray(old) ? firstArray(mutate([old]).arrays) : old);
+        invalidateIfNeeded();
+        return;
+      case "paginated":
+        context.queryClient.setQueryData(exactKey, (old) => {
+          if (!isRecord(old) || !Array.isArray(old.items))
+            return old;
+          const result = mutate([old.items]);
+          const patched = { ...old, items: firstArray(result.arrays) };
+          const delta = config.total?.delta?.({
+            event,
+            queryKey: exactKey,
+            present: result.present,
+            membership
+          }) ?? totalDelta(mutation, result.present, membership);
+          return config.total ? reconcile(patched, delta) : patched;
+        });
+        invalidateIfNeeded();
+        return;
+      case "infinite-array":
+        context.queryClient.setQueryData(exactKey, (old) => isRecord(old) && Array.isArray(old.pages) && old.pages.every((page) => Array.isArray(page)) ? { ...old, pages: mutate(old.pages).arrays } : old);
+        invalidateIfNeeded();
+        return;
+      case "infinite-paginated":
+        context.queryClient.setQueryData(exactKey, (old) => {
+          if (!isRecord(old) || !Array.isArray(old.pages) || !old.pages.every((page) => isRecord(page) && Array.isArray(page.items))) {
+            return old;
+          }
+          const result = mutate(old.pages.map((page) => page.items));
+          const delta = config.total?.delta?.({
+            event,
+            queryKey: exactKey,
+            present: result.present,
+            membership
+          }) ?? totalDelta(mutation, result.present, membership);
+          return {
+            ...old,
+            pages: old.pages.map((page, index) => {
+              const pageItems = result.arrays[index];
+              if (!pageItems) {
+                throw new Error("Entity cache list adapter changed the page count");
+              }
+              const patched = { ...page, items: pageItems };
+              return config.total ? reconcile(patched, delta) : patched;
+            })
+          };
+        });
+        invalidateIfNeeded();
+        return;
+      default:
+        unsupportedListShape(config.shape);
+    }
+  };
+  for (const query of queries) {
+    const exactKey = query.queryKey;
+    patchExact(exactKey, config.membership?.evaluate(event, exactKey) ?? "include");
   }
 }
 function createEntityCacheHandlers(config) {
+  if (config.list.total && config.list.shape !== "paginated" && config.list.shape !== "infinite-paginated") {
+    throw new Error("Entity cache total policy requires a paginated list shape");
+  }
   const deletedId = config.getDeletedId ?? ((payload) => idOf(payload, config.getId));
   const apply = (event, mutation, context) => {
     const listKey = resolveKey(config.list.key, event);
     const detailKey = config.detailKey ? resolveKey(config.detailKey, event) : undefined;
     if (context.isFresh(detailKey ?? listKey))
       return false;
-    patchList(context, listKey, config.list, mutation, config.getListItemId);
+    patchList(context, listKey, config.list, event, mutation, config.getListItemId);
     return true;
   };
   return {

package/dist/realtime/contract.d.ts

@@ -1,5 +1,5 @@
 import type { z } from 'zod';
-import type { AppError } from '../contract/errors';
+import type { AppError } from '../contract/errors.js';
 export interface RealtimeEventDefinition<TArgs extends z.ZodType<unknown[]> = z.ZodType<unknown[]>, TAck extends z.ZodType | undefined = z.ZodType | undefined> {
     args: TArgs;
     ack?: TAck;

package/dist/realtime/index.d.ts

@@ -1,5 +1,5 @@
-export { defineRealtimeContract, type InferRealtimeEventMap, type RealtimeAcknowledgedEvent, type RealtimeAcknowledgement, type RealtimeContract, type RealtimeEmitArguments, type RealtimeEventArguments, type RealtimeEventDefinition, type RealtimeEventHandler, type RealtimeEventRegistry, type RealtimeRejectDirection, type RealtimeRejectedEvent, type RealtimeRejectedEventHook, type RealtimeRequestArguments, } from './contract';
-export { asRealtimeRejection, REALTIME_REJECTION_KEY, type RealtimeRejectionEnvelope, type RealtimeRejectionIssue, type RealtimeRejectionReport, } from './rejected-frame';
-export { RealtimeRequestDisconnectedError, RealtimeRequestInvalidAcknowledgementError, type RealtimeRequestOptions, RealtimeRequestRejectedError, RealtimeRequestTimeoutError, } from './request';
-export type { ValidatedRealtimeSocket } from './socket';
+export { defineRealtimeContract, type InferRealtimeEventMap, type RealtimeAcknowledgedEvent, type RealtimeAcknowledgement, type RealtimeContract, type RealtimeEmitArguments, type RealtimeEventArguments, type RealtimeEventDefinition, type RealtimeEventHandler, type RealtimeEventRegistry, type RealtimeRejectDirection, type RealtimeRejectedEvent, type RealtimeRejectedEventHook, type RealtimeRequestArguments, } from './contract.js';
+export { asRealtimeRejection, REALTIME_REJECTION_KEY, type RealtimeRejectionEnvelope, type RealtimeRejectionIssue, type RealtimeRejectionReport, } from './rejected-frame.js';
+export { RealtimeRequestDisconnectedError, RealtimeRequestInvalidAcknowledgementError, type RealtimeRequestOptions, RealtimeRequestRejectedError, RealtimeRequestTimeoutError, } from './request.js';
+export type { ValidatedRealtimeSocket } from './socket.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/realtime/rejection.d.ts

@@ -1,4 +1,4 @@
-import type { RealtimeRejectDirection, RealtimeRejectedEvent } from './contract';
+import type { RealtimeRejectDirection, RealtimeRejectedEvent } from './contract.js';
 export declare function realtimeContractViolation(options: {
     event: string;
     direction: RealtimeRejectDirection;

package/dist/realtime/request.d.ts

@@ -1,4 +1,4 @@
-import type { RealtimeRejectionIssue } from './rejected-frame';
+import type { RealtimeRejectionIssue } from './rejected-frame.js';
 export interface RealtimeRequestOptions {
     /** Maximum acknowledgement wait in milliseconds. Must be finite and > 0. */
     timeoutMs: number;

package/dist/realtime/socket.d.ts

@@ -1,6 +1,6 @@
 import type { z } from 'zod';
-import type { StitchLogger } from '../logger';
-import type { RealtimeEmitArguments, RealtimeEventHandler, RealtimeEventRegistry, RealtimeRejectDirection, RealtimeRejectedEventHook } from './contract';
+import type { StitchLogger } from '../logger.js';
+import type { RealtimeEmitArguments, RealtimeEventHandler, RealtimeEventRegistry, RealtimeRejectDirection, RealtimeRejectedEventHook } from './contract.js';
 interface ValidatedRealtimeSocketOptions<TInbound extends RealtimeEventRegistry, TOutbound extends RealtimeEventRegistry> {
     target: object;
     inbound: TInbound;

package/dist/remote.d.ts

@@ -5,5 +5,5 @@
  * own entrypoint lets CLI and other thin processes proxy a deployed API without
  * importing the MCP SDK or the AI SDK through the broad tools barrel.
  */
-export { type ImplementRemoteOptions, implementRemote } from './tools/remote';
+export { type ImplementRemoteOptions, implementRemote } from './tools/remote.js';
 //# sourceMappingURL=remote.d.ts.map

package/dist/remote.js

@@ -1,7 +1,7 @@
 import {
   ApiError,
   createClient
-} from "./index-zd4v31v2.js";
+} from "./index-2ve29dzn.js";
 import"./index-v5bayx1z.js";
 import {
   mergeMeta

package/dist/server/bun.d.ts

@@ -1,6 +1,6 @@
-import { type ManagedServerHandle } from './shutdown';
-import type { SocketIOServerLifecycle } from './socket-io';
-import type { FetchComposition, FetchHandler, HandlerConfig, RawRoute, RawRouteContext } from './types';
+import { type ManagedServerHandle } from './shutdown.js';
+import type { SocketIOServerLifecycle } from './socket-io.js';
+import type { FetchComposition, FetchHandler, HandlerConfig, RawRoute, RawRouteContext } from './types.js';
 /** The concrete `Bun.serve` server instance passed to Bun raw routes. */
 export type BunServer = ReturnType<typeof Bun.serve>;
 export type BunRawRoute = RawRoute<BunServer>;

package/dist/server/context-contribution.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeContext } from '../contract';
+import type { RuntimeContext } from '../contract/index.js';
 /** Keys whose value is owned by a transport/runtime boundary, never by application enrichment. */
 export declare const RUNTIME_CONTEXT_RESERVED_KEYS: Set<string>;
 /**

package/dist/server/context.d.ts

@@ -2,10 +2,10 @@
  * `RuntimeContext` assembly — parses params / body / multipart against the
  * endpoint schemas and gathers request metadata (trace id, client info).
  */
-import { type RuntimeContext } from '../contract';
-import { type MultipartLifecycle } from './multipart';
-import { type ClientIpOptions } from './request';
-import type { AuthorizationContext, MethodDef } from './types';
+import { type RuntimeContext } from '../contract/index.js';
+import { type MultipartLifecycle } from './multipart.js';
+import { type ClientIpOptions } from './request.js';
+import type { AuthorizationContext, MethodDef } from './types.js';
 /**
  * Assemble everything knowable from the URL alone — path params, the request,
  * trace id and client info — **before** any schema parsing. Bound first so a

package/dist/server/contract-stream.d.ts

@@ -1,5 +1,5 @@
-import { type EndpointStreamDescriptor } from '../contract';
-import type { RawRouteContext } from './types';
+import { type EndpointStreamDescriptor } from '../contract/index.js';
+import type { RawRouteContext } from './types.js';
 /** Build the HTTP response for one contract-declared stream. */
 export declare function contractStreamResponse(request: Request, context: RawRouteContext, source: AsyncIterable<unknown>, descriptor: EndpointStreamDescriptor, operationAbort: AbortController): Promise<Response>;
 //# sourceMappingURL=contract-stream.d.ts.map

package/dist/server/create.d.ts

@@ -1,3 +1,3 @@
-import type { FetchHandler, HandlerConfig } from './types';
+import type { FetchHandler, HandlerConfig } from './types.js';
 export declare function createHandler<TServer = unknown>(config: HandlerConfig<TServer>): FetchHandler<TServer>;
 //# sourceMappingURL=create.d.ts.map

package/dist/server/error-hook.d.ts

@@ -35,9 +35,9 @@
  * createServer({ services, hooks: { onError } });
  * ```
  */
-import type { RuntimeContext } from '../contract';
-import { type StitchErrorCode } from '../contract';
-import type { LifecycleHooks, MethodDef } from './types';
+import type { RuntimeContext } from '../contract/index.js';
+import { type StitchErrorCode } from '../contract/index.js';
+import type { LifecycleHooks, MethodDef } from './types.js';
 /** The normalised error handed to `render` — code already remapped. */
 export interface ResolvedError {
     /** Wire code — the app code from `codeMap` for a stitch error, else the thrown code. */

package/dist/server/file.d.ts

@@ -1,4 +1,4 @@
-import type { RawRoute } from './types';
+import type { RawRoute } from './types.js';
 /**
  * Build a basic static-file route. URL-derived paths pass both lexical and
  * realpath containment checks, so an in-root symlink cannot escape `dir`.

package/dist/server/implement.d.ts

@@ -1,6 +1,6 @@
 import type { ZodType } from 'zod';
-import type { ContractDef, EndpointDef, MultipartDescriptor, RuntimeContext } from '../contract';
-import type { EndpointHandlerContext, Handlers, MultipartReceiver, ScopeContexts, ScopedHandlers, ServiceDef, StreamingMultipartImplementation } from './types';
+import type { ContractDef, EndpointDef, MultipartDescriptor, RuntimeContext } from '../contract/index.js';
+import type { EndpointHandlerContext, Handlers, MultipartReceiver, ScopeContexts, ScopedHandlers, ServiceDef, StreamingMultipartImplementation } from './types.js';
 type StreamingEndpoint = EndpointDef & {
     multipart: MultipartDescriptor & {
         delivery: 'stream';

package/dist/server/index.d.ts

@@ -1,32 +1,32 @@
-export { AppError, appError, badRequest, conflict, forbidden, isStitchErrorCode, notFound, rateLimited, STITCH_ERROR_STATUS, type StitchErrorCode, unauthorized, } from '../contract';
-export { errorCode, formatZodError, normalizeError, type ZodIssueSummary, zodIssues, } from '../internal/errors';
-export { isWithinDir } from '../internal/within-dir';
-export { type BunFetchComposition as FetchComposition, type BunFetchHandler as FetchHandler, type BunHandlerConfig as HandlerConfig, type BunRawRoute as RawRoute, type BunRawRouteContext as RawRouteContext, type BunServer, type BunServerConfig, type BunServerHandle, createServer, type ServerPassthrough, type UnixListenConfig, } from './bun';
-export { type CacheOptions, cacheHeaders, createCache } from './cache';
-export { createHandler } from './create';
-export { createErrorHook, type ErrorHookConfig, type ResolvedError, } from './error-hook';
-export { createEventBus, type DefaultEventMap, type EventBus, type EventBusOptions, type EventHandler, } from './event-bus';
-export { type ByteRange, parseByteRange, type ServeFileOptions, serveFile, staticRoute, weakETag, } from './file';
-export { createImplement, createImplementRegistry, createMultipartStream, createScopedImplement, createScopedImplementRegistry, defineMultipartStream, type ExactRegistryHandlers, type ExactScopedRegistryHandlers, type ImplementationRegistry, implement, implementRegistry, type KeyedServices, type MultipartStreamConfig, type RegistryHandlers, type ScopedImplementationRegistry, type ScopedRegistryHandlers, type StreamScope, } from './implement';
-export { composeLifecycleHooks } from './lifecycle';
-export type { LogFormat } from './logger';
-export { type AuthHook, type AuthHookConfig, type AuthRule, type AuthRuleContribution, type AuthRules, type AuthScopes, type BearerResolverConfig, type ComposeAuthHooksConfig, type ComposedAuthScopes, composeAuthHooks, createAuthHook, createBearerResolver, extractToken, type JwtPayload, type RuleScopes, type ScopedAuthHook, type ScopedAuthRule, type SignJwtOptions, signJwt, type VerifyJwtOptions, verifyJwt, } from './middleware/auth';
-export { type CookieDef, type CookieOptions, defineCookie, parseCookies, serializeCookie, } from './middleware/cookies';
-export { type CorsConfig, corsHeaders, corsPreflightResponse, DEFAULT_CORS_ALLOW_HEADERS, DEFAULT_CORS_EXPOSE_HEADERS, } from './middleware/cors';
-export { deriveCodeChallenge, type PkceMethod, verifyPkce } from './middleware/pkce';
-export { type MultipartLifecycle, type MultipartResult, parseMultipart } from './multipart';
-export { generateOpenApiDocument, type OpenApiConfig, type OpenApiDocument, type OpenApiInfo, type OpenApiServer, openApiRoute, } from './openapi';
-export { bindProcessSignals, type ProcessSignalName, type ProcessSignalsBinding, type ProcessSignalsErrorPhase, type ProcessSignalsOptions, type ShutdownTarget, type SignalSource, } from './process-signals';
-export { createRateLimiter, type RateLimitConfig } from './rate-limit';
-export { errorResponse, parseBody, respondJson } from './raw';
-export { bindRealtimeServer, type RealtimeServer, type RealtimeServerConnection, type RealtimeServerHandle, } from './realtime';
-export { type ClientIpOptions, extractIp, generateTraceId, getClientInfo, resolveSocketIp, resolveTraceId, } from './request';
-export { type ManagedServerHandle, type ShutdownOptions, ShutdownOptionsSchema, type ShutdownResult, ShutdownResultSchema, type ShutdownState, ShutdownStateSchema, type ShutdownStatus, ShutdownStatusSchema, } from './shutdown';
-export type { SocketIOHandshakeConfig, SocketIOPeerLoaders, SocketIORequestPolicy, SocketIOServerConfig, SocketIOServerHandle, SocketIOServerLifecycle, } from './socket-io';
-export { createSocketIOServer, socketIoLane } from './socket-io';
-export { type ParseSSEOptions, parseSSE, streamSSE } from './stream';
-export { DEFAULT_STREAM_HEARTBEAT_MS, ndjsonRoute, type StreamingFormat, type StreamingRouteOptions, type StreamingSourceContext, sseRoute, streamingRoute, } from './streaming-route';
-export type { AuthorizationContext, EffectiveScope, EndpointHandlerContext, Handlers, LifecycleHooks, LoggingConfig, LogOutcome, MethodDef, MultipartFileMetadata, MultipartReceiver, MultipartReceiverResult, OperationIdentity, RouteGroup, ScopeContexts, ScopedHandlers, ServiceDef, StitchLogger, StreamingMultipartImplementation, } from './types';
-export { createUnixClientTransport, type UnixClientDeliveryState, type UnixClientTransport, type UnixClientTransportConfig, UnixClientTransportError, type UnixClientTransportErrorCode, } from './unix-client';
-export { type ComposedLane, composeWebSocketHandlers, type WebSocketComposeConfig, type WebSocketLane, webSocketLane, } from './websocket';
+export { AppError, appError, badRequest, conflict, forbidden, isStitchErrorCode, notFound, rateLimited, STITCH_ERROR_STATUS, type StitchErrorCode, unauthorized, } from '../contract/index.js';
+export { errorCode, formatZodError, normalizeError, type ZodIssueSummary, zodIssues, } from '../internal/errors.js';
+export { isWithinDir } from '../internal/within-dir.js';
+export { type BunFetchComposition as FetchComposition, type BunFetchHandler as FetchHandler, type BunHandlerConfig as HandlerConfig, type BunRawRoute as RawRoute, type BunRawRouteContext as RawRouteContext, type BunServer, type BunServerConfig, type BunServerHandle, createServer, type ServerPassthrough, type UnixListenConfig, } from './bun.js';
+export { type CacheOptions, cacheHeaders, createCache } from './cache.js';
+export { createHandler } from './create.js';
+export { createErrorHook, type ErrorHookConfig, type ResolvedError, } from './error-hook.js';
+export { createEventBus, type DefaultEventMap, type EventBus, type EventBusOptions, type EventHandler, } from './event-bus.js';
+export { type ByteRange, parseByteRange, type ServeFileOptions, serveFile, staticRoute, weakETag, } from './file.js';
+export { createImplement, createImplementRegistry, createMultipartStream, createScopedImplement, createScopedImplementRegistry, defineMultipartStream, type ExactRegistryHandlers, type ExactScopedRegistryHandlers, type ImplementationRegistry, implement, implementRegistry, type KeyedServices, type MultipartStreamConfig, type RegistryHandlers, type ScopedImplementationRegistry, type ScopedRegistryHandlers, type StreamScope, } from './implement.js';
+export { composeLifecycleHooks } from './lifecycle.js';
+export type { LogFormat } from './logger.js';
+export { type AuthHook, type AuthHookConfig, type AuthRule, type AuthRuleContribution, type AuthRules, type AuthScopes, type BearerResolverConfig, type ComposeAuthHooksConfig, type ComposedAuthScopes, composeAuthHooks, createAuthHook, createBearerResolver, extractToken, type JwtPayload, type RuleScopes, type ScopedAuthHook, type ScopedAuthRule, type SignJwtOptions, signJwt, type VerifyJwtOptions, verifyJwt, } from './middleware/auth.js';
+export { type CookieDef, type CookieOptions, defineCookie, parseCookies, serializeCookie, } from './middleware/cookies.js';
+export { type CorsConfig, corsHeaders, corsPreflightResponse, DEFAULT_CORS_ALLOW_HEADERS, DEFAULT_CORS_EXPOSE_HEADERS, } from './middleware/cors.js';
+export { deriveCodeChallenge, type PkceMethod, verifyPkce } from './middleware/pkce.js';
+export { type MultipartLifecycle, type MultipartResult, parseMultipart } from './multipart.js';
+export { generateOpenApiDocument, type OpenApiConfig, type OpenApiDocument, type OpenApiInfo, type OpenApiServer, openApiRoute, } from './openapi.js';
+export { bindProcessSignals, type ProcessSignalName, type ProcessSignalsBinding, type ProcessSignalsErrorPhase, type ProcessSignalsOptions, type ShutdownTarget, type SignalSource, } from './process-signals.js';
+export { createRateLimiter, type RateLimitConfig } from './rate-limit.js';
+export { errorResponse, parseBody, respondJson } from './raw.js';
+export { bindRealtimeServer, type RealtimeServer, type RealtimeServerConnection, type RealtimeServerHandle, } from './realtime.js';
+export { type ClientIpOptions, extractIp, generateTraceId, getClientInfo, resolveSocketIp, resolveTraceId, } from './request.js';
+export { type ManagedServerHandle, type ShutdownOptions, ShutdownOptionsSchema, type ShutdownResult, ShutdownResultSchema, type ShutdownState, ShutdownStateSchema, type ShutdownStatus, ShutdownStatusSchema, } from './shutdown.js';
+export type { SocketIOHandshakeConfig, SocketIOPeerLoaders, SocketIORequestPolicy, SocketIOServerConfig, SocketIOServerHandle, SocketIOServerLifecycle, } from './socket-io.js';
+export { createSocketIOServer, socketIoLane } from './socket-io.js';
+export { type ParseSSEOptions, parseSSE, streamSSE } from './stream.js';
+export { DEFAULT_STREAM_HEARTBEAT_MS, ndjsonRoute, type StreamingFormat, type StreamingRouteOptions, type StreamingSourceContext, sseRoute, streamingRoute, } from './streaming-route.js';
+export type { AuthorizationContext, EffectiveScope, EndpointHandlerContext, Handlers, LifecycleHooks, LoggingConfig, LogOutcome, MethodDef, MultipartFileMetadata, MultipartReceiver, MultipartReceiverResult, OperationIdentity, RouteGroup, ScopeContexts, ScopedHandlers, ServiceDef, StitchLogger, StreamingMultipartImplementation, } from './types.js';
+export { createUnixClientTransport, type UnixClientDeliveryState, type UnixClientTransport, type UnixClientTransportConfig, UnixClientTransportError, type UnixClientTransportErrorCode, type UnixResponseBodyMode, } from './unix-client.js';
+export { type ComposedLane, composeWebSocketHandlers, type WebSocketComposeConfig, type WebSocketLane, webSocketLane, } from './websocket.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

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

package/dist/server/index.js

@@ -13,7 +13,7 @@ import {
   sseRoute,
   streamingRoute,
   webSocketLane
-} from "../index-nymn7wbg.js";
+} from "../index-3vq6we8m.js";
 import {
   composeAuthHooks,
   createAuthHook,
@@ -41,6 +41,14 @@ import {
   implement,
   implementRegistry
 } from "../index-pr0qsmjy.js";
+import {
+  extractIp,
+  generateTraceId,
+  getClientInfo,
+  getTraceId,
+  resolveSocketIp,
+  resolveTraceId
+} from "../index-69m2278y.js";
 import {
   isWithinDir,
   realPathWithinDir
@@ -62,14 +70,6 @@ import {
   parseSSE,
   streamSSE
 } from "../index-v5bayx1z.js";
-import {
-  extractIp,
-  generateTraceId,
-  getClientInfo,
-  getTraceId,
-  resolveSocketIp,
-  resolveTraceId
-} from "../index-69m2278y.js";
 import {
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
   errorCode,

package/dist/server/lifecycle.d.ts

@@ -1,4 +1,4 @@
-import type { LifecycleHooks } from './types';
+import type { LifecycleHooks } from './types.js';
 /** Compose ordinary HTTP lifecycle hooks inside each existing phase slot. */
 export declare function composeLifecycleHooks(...hooks: readonly (LifecycleHooks | undefined)[]): LifecycleHooks;
 //# sourceMappingURL=lifecycle.d.ts.map

package/dist/server/logging.d.ts

@@ -1,4 +1,4 @@
-import type { LoggingConfig, LogOutcome } from './types';
+import type { LoggingConfig, LogOutcome } from './types.js';
 /**
  * Normalise `logging` into either a config or `null` (off). `true` is shorthand
  * for `{}`: any object turns logging on, and `logger` decides which sink writes.

package/dist/server/middleware/auth.d.ts

@@ -1,5 +1,5 @@
-import type { RuntimeContext } from '../../contract';
-import type { AuthorizationContext, OperationIdentity } from '../types';
+import type { RuntimeContext } from '../../contract/index.js';
+import type { AuthorizationContext, OperationIdentity } from '../types.js';
 export interface JwtPayload {
     [key: string]: unknown;
 }

package/dist/server/multipart.d.ts

@@ -1,5 +1,5 @@
-import type { MultipartDescriptor } from '../contract';
-import type { MultipartReceiver } from './types';
+import type { MultipartDescriptor } from '../contract/index.js';
+import type { MultipartReceiver } from './types.js';
 export interface MultipartLifecycle {
     rollback(): Promise<void>;
 }

package/dist/server/node.d.ts

@@ -1,7 +1,7 @@
 import type { Server as HttpServer } from 'node:http';
 import { serve } from 'srvx/node';
-import { type ManagedServerHandle } from './shutdown';
-import type { FetchComposition, HandlerConfig } from './types';
+import { type ManagedServerHandle } from './shutdown.js';
+import type { FetchComposition, HandlerConfig } from './types.js';
 export interface NodeSocketLifecycle {
     attach(server: HttpServer): void;
     beginShutdown(): void;

package/dist/server/openapi.d.ts

@@ -10,7 +10,7 @@
  * emits — not a divergent code path. Schemas are inlined (valid OpenAPI);
  * `$ref` de-duplication can come later if a spec grows unwieldy.
  */
-import type { MethodDef, RawRoute, ServiceDef } from './types';
+import type { MethodDef, RawRoute, ServiceDef } from './types.js';
 export interface OpenApiInfo {
     title: string;
     version: string;