@metaobjectsdev/tanstack 1.0.0-rc.4 → 1.0.0-rc.5

package/dist/entity-fetcher.d.ts

@@ -22,6 +22,40 @@ export interface EntityFetcherProviderProps {
 }
 /** Wrap your app (or admin subtree) to supply a fetcher to generated hooks. */
 export declare function EntityFetcherProvider({ fetcher, baseUrl, children, }: EntityFetcherProviderProps): import("react").JSX.Element;
-/** Reads the fetcher from context, already bound to `baseUrl`. Throws if not provided. */
-export declare function useEntityFetcher(): EntityFetcher;
+/**
+ * The fetcher from context, already bound to `baseUrl`.
+ *
+ * **Every path you hand this is rewritten**: `baseUrl` is prefixed onto it. That
+ * is exactly right for the ENTITY-RELATIVE paths generated hooks emit
+ * (`${Entity.$path}/…`), and it is the reason for the name — the argument is an
+ * entity path, not an application path.
+ *
+ * It is NOT a general-purpose `fetch`. Handing it an absolute app route silently
+ * relocates the request: with `baseUrl="/api"`, `/internal/leads/1/notes` becomes
+ * `/api/internal/leads/1/notes`, and an already-prefixed `/api/decisions/1`
+ * becomes `/api/api/decisions/1`. Both are type-correct, so nothing in the
+ * compiler, the unit suite or `meta verify` can see them — only a request that
+ * 404s at runtime. An adopter who had followed the "the fetcher is the ONE place
+ * base-URL policy lives" advice and shared this seam with hand-written call sites
+ * lost ten write actions this way, silently.
+ *
+ * For non-entity paths, call your own transport directly, or compose `joinBaseUrl`
+ * from `@metaobjectsdev/runtime-web` yourself where you DO want the prefix.
+ *
+ * Throws if no `<EntityFetcherProvider>` is above it.
+ */
+export declare function useEntityPathFetcher(): EntityFetcher;
+/**
+ * @deprecated Renamed to {@link useEntityPathFetcher}. Identical behaviour — the
+ * new name says what the hook does to the path it is given, which is what the old
+ * name hid: before 1.0 the provider passed its fetcher through unchanged, so
+ * "entity fetcher" was an accurate description of a hook that rewrote nothing.
+ * 1.0 made it BIND the fetcher to `baseUrl` (generated hooks stopped composing
+ * `$apiPrefix` themselves), and the name did not move with the behaviour.
+ *
+ * This alias will be removed in a future major. If you share this seam with
+ * hand-written non-entity call sites, read {@link useEntityPathFetcher} first —
+ * those paths are being rewritten.
+ */
+export declare const useEntityFetcher: typeof useEntityPathFetcher;
 //# sourceMappingURL=entity-fetcher.d.ts.map

package/dist/entity-fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-fetcher.d.ts","sourceRoot":"","sources":["../src/entity-fetcher.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI9E,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,OAAO,EAAE,aAAa,CAAC;IACvB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,QAAQ,GACT,EAAE,0BAA0B,+BAU5B;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,IAAI,aAAa,CAShD"}
+{"version":3,"file":"entity-fetcher.d.ts","sourceRoot":"","sources":["../src/entity-fetcher.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI9E,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,OAAO,EAAE,aAAa,CAAC;IACvB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,QAAQ,GACT,EAAE,0BAA0B,+BAU5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CASpD;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,6BAAuB,CAAC"}

package/dist/entity-fetcher.js

@@ -9,13 +9,47 @@ export function EntityFetcherProvider({ fetcher, baseUrl, children, }) {
     const value = useMemo(() => ((path, init) => fetcher(joinBaseUrl(baseUrl, path), init)), [fetcher, baseUrl]);
     return _jsx(EntityFetcherContext.Provider, { value: value, children: children });
 }
-/** Reads the fetcher from context, already bound to `baseUrl`. Throws if not provided. */
-export function useEntityFetcher() {
+/**
+ * The fetcher from context, already bound to `baseUrl`.
+ *
+ * **Every path you hand this is rewritten**: `baseUrl` is prefixed onto it. That
+ * is exactly right for the ENTITY-RELATIVE paths generated hooks emit
+ * (`${Entity.$path}/…`), and it is the reason for the name — the argument is an
+ * entity path, not an application path.
+ *
+ * It is NOT a general-purpose `fetch`. Handing it an absolute app route silently
+ * relocates the request: with `baseUrl="/api"`, `/internal/leads/1/notes` becomes
+ * `/api/internal/leads/1/notes`, and an already-prefixed `/api/decisions/1`
+ * becomes `/api/api/decisions/1`. Both are type-correct, so nothing in the
+ * compiler, the unit suite or `meta verify` can see them — only a request that
+ * 404s at runtime. An adopter who had followed the "the fetcher is the ONE place
+ * base-URL policy lives" advice and shared this seam with hand-written call sites
+ * lost ten write actions this way, silently.
+ *
+ * For non-entity paths, call your own transport directly, or compose `joinBaseUrl`
+ * from `@metaobjectsdev/runtime-web` yourself where you DO want the prefix.
+ *
+ * Throws if no `<EntityFetcherProvider>` is above it.
+ */
+export function useEntityPathFetcher() {
     const fetcher = useContext(EntityFetcherContext);
     if (!fetcher) {
-        throw new Error("useEntityFetcher() called outside <EntityFetcherProvider>. " +
+        throw new Error("useEntityPathFetcher() called outside <EntityFetcherProvider>. " +
             "Wrap your app (or the relevant subtree) with EntityFetcherProvider fetcher={...}.");
     }
     return fetcher;
 }
+/**
+ * @deprecated Renamed to {@link useEntityPathFetcher}. Identical behaviour — the
+ * new name says what the hook does to the path it is given, which is what the old
+ * name hid: before 1.0 the provider passed its fetcher through unchanged, so
+ * "entity fetcher" was an accurate description of a hook that rewrote nothing.
+ * 1.0 made it BIND the fetcher to `baseUrl` (generated hooks stopped composing
+ * `$apiPrefix` themselves), and the name did not move with the behaviour.
+ *
+ * This alias will be removed in a future major. If you share this seam with
+ * hand-written non-entity call sites, read {@link useEntityPathFetcher} first —
+ * those paths are being rewritten.
+ */
+export const useEntityFetcher = useEntityPathFetcher;
 //# sourceMappingURL=entity-fetcher.js.map

package/dist/entity-fetcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-fetcher.js","sourceRoot":"","sources":["../src/entity-fetcher.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAsB,MAAM,6BAA6B,CAAC;AAE9E,MAAM,oBAAoB,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAC;AAuBvE,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,QAAQ,GACmB;IAC3B,sFAAsF;IACtF,oFAAoF;IACpF,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CACH,CAAC,CAAK,IAAY,EAAE,IAAkB,EAAE,EAAE,CACxC,OAAO,CAAI,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAkB,EAClE,CAAC,OAAO,EAAE,OAAO,CAAC,CACnB,CAAC;IACF,OAAO,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAiC,CAAC;AACjG,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,mFAAmF,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"entity-fetcher.js","sourceRoot":"","sources":["../src/entity-fetcher.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAsB,MAAM,6BAA6B,CAAC;AAE9E,MAAM,oBAAoB,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAC;AAuBvE,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,QAAQ,GACmB;IAC3B,sFAAsF;IACtF,oFAAoF;IACpF,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CACH,CAAC,CAAK,IAAY,EAAE,IAAkB,EAAE,EAAE,CACxC,OAAO,CAAI,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAkB,EAClE,CAAC,OAAO,EAAE,OAAO,CAAC,CACnB,CAAC;IACF,OAAO,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAiC,CAAC;AACjG,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,iEAAiE;YAC/D,mFAAmF,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-export { EntityFetcherProvider, useEntityFetcher } from "./entity-fetcher.js";
+export { EntityFetcherProvider, useEntityPathFetcher, 
+/** @deprecated Renamed to `useEntityPathFetcher`. */
+useEntityFetcher, } from "./entity-fetcher.js";
 export type { EntityFetcherProviderProps } from "./entity-fetcher.js";
 export type { EntityFetcher, GridConfig } from "@metaobjectsdev/runtime-web";
 export { defaultCellRenderers, imageCell, type CellRenderer, type ImageCellOptions, } from "./cell-renderers.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,oBAAoB;AACpB,qDAAqD;AACrD,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
 // Public API surface for @metaobjectsdev/tanstack.
-export { EntityFetcherProvider, useEntityFetcher } from "./entity-fetcher.js";
+export { EntityFetcherProvider, useEntityPathFetcher, 
+/** @deprecated Renamed to `useEntityPathFetcher`. */
+useEntityFetcher, } from "./entity-fetcher.js";
 export { defaultCellRenderers, imageCell, } from "./cell-renderers.js";
 export { CellRendererProvider, useCellRenderers, } from "./cell-renderer-provider.js";
 export { EntityGrid } from "./entity-grid.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,EACL,oBAAoB,EACpB,SAAS,GAGV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAA8C,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,OAAO,EACL,qBAAqB,EACrB,oBAAoB;AACpB,qDAAqD;AACrD,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,oBAAoB,EACpB,SAAS,GAGV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAA8C,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/tanstack",
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0-rc.5",
   "description": "TanStack runtime for metaobjects: EntityFetcherProvider, EntityGrid, default cell renderers.",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@metaobjectsdev/runtime-web": "1.0.0-rc.4"
+    "@metaobjectsdev/runtime-web": "1.0.0-rc.5"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.90.0",

package/src/entity-fetcher.tsx

@@ -41,14 +41,49 @@ export function EntityFetcherProvider({
   return <EntityFetcherContext.Provider value={value}>{children}</EntityFetcherContext.Provider>;
 }
 
-/** Reads the fetcher from context, already bound to `baseUrl`. Throws if not provided. */
-export function useEntityFetcher(): EntityFetcher {
+/**
+ * The fetcher from context, already bound to `baseUrl`.
+ *
+ * **Every path you hand this is rewritten**: `baseUrl` is prefixed onto it. That
+ * is exactly right for the ENTITY-RELATIVE paths generated hooks emit
+ * (`${Entity.$path}/…`), and it is the reason for the name — the argument is an
+ * entity path, not an application path.
+ *
+ * It is NOT a general-purpose `fetch`. Handing it an absolute app route silently
+ * relocates the request: with `baseUrl="/api"`, `/internal/leads/1/notes` becomes
+ * `/api/internal/leads/1/notes`, and an already-prefixed `/api/decisions/1`
+ * becomes `/api/api/decisions/1`. Both are type-correct, so nothing in the
+ * compiler, the unit suite or `meta verify` can see them — only a request that
+ * 404s at runtime. An adopter who had followed the "the fetcher is the ONE place
+ * base-URL policy lives" advice and shared this seam with hand-written call sites
+ * lost ten write actions this way, silently.
+ *
+ * For non-entity paths, call your own transport directly, or compose `joinBaseUrl`
+ * from `@metaobjectsdev/runtime-web` yourself where you DO want the prefix.
+ *
+ * Throws if no `<EntityFetcherProvider>` is above it.
+ */
+export function useEntityPathFetcher(): EntityFetcher {
   const fetcher = useContext(EntityFetcherContext);
   if (!fetcher) {
     throw new Error(
-      "useEntityFetcher() called outside <EntityFetcherProvider>. " +
+      "useEntityPathFetcher() called outside <EntityFetcherProvider>. " +
         "Wrap your app (or the relevant subtree) with EntityFetcherProvider fetcher={...}.",
     );
   }
   return fetcher;
 }
+
+/**
+ * @deprecated Renamed to {@link useEntityPathFetcher}. Identical behaviour — the
+ * new name says what the hook does to the path it is given, which is what the old
+ * name hid: before 1.0 the provider passed its fetcher through unchanged, so
+ * "entity fetcher" was an accurate description of a hook that rewrote nothing.
+ * 1.0 made it BIND the fetcher to `baseUrl` (generated hooks stopped composing
+ * `$apiPrefix` themselves), and the name did not move with the behaviour.
+ *
+ * This alias will be removed in a future major. If you share this seam with
+ * hand-written non-entity call sites, read {@link useEntityPathFetcher} first —
+ * those paths are being rewritten.
+ */
+export const useEntityFetcher = useEntityPathFetcher;

package/src/index.ts

@@ -1,5 +1,10 @@
 // Public API surface for @metaobjectsdev/tanstack.
-export { EntityFetcherProvider, useEntityFetcher } from "./entity-fetcher.js";
+export {
+  EntityFetcherProvider,
+  useEntityPathFetcher,
+  /** @deprecated Renamed to `useEntityPathFetcher`. */
+  useEntityFetcher,
+} from "./entity-fetcher.js";
 export type { EntityFetcherProviderProps } from "./entity-fetcher.js";
 export type { EntityFetcher, GridConfig } from "@metaobjectsdev/runtime-web";
 export {