@valbuild/next 0.99.0 → 0.100.0

package/dist/declarations/src/rsc/initValRsc.d.ts

@@ -1,5 +1,5 @@
 import { type StegaOfSource } from "@valbuild/react/stega";
-import { SelectorSource, SelectorOf, GenericSelector, ValConfig, ValModules, ValModule, SourceObject } from "@valbuild/core";
+import { SelectorSource, SelectorOf, GenericSelector, ValConfig, ValModules, ValModule, SourceObject, JsonSource } from "@valbuild/core";
 import { cookies, draftMode, headers } from "next/headers";
 import { ValServer } from "@valbuild/server";
 declare const initFetchValStega: (config: ValConfig, valApiEndpoints: string, valServerPromise: Promise<ValServer>, isEnabled: () => Promise<boolean>, getHeaders: () => Promise<{
@@ -10,7 +10,7 @@ declare const initFetchValStega: (config: ValConfig, valApiEndpoints: string, va
         value: string;
     } | undefined;
 }>) => <T extends SelectorSource>(selector: T) => Promise<SelectorOf<T> extends GenericSelector<infer S> ? StegaOfSource<S> : never>;
-type FetchValRouteReturnType<T extends ValModule<GenericSelector<SourceObject>>> = T extends ValModule<infer S> ? S extends SourceObject ? StegaOfSource<NonNullable<S>[string]> | null : never : never;
+type FetchValRouteReturnType<T extends ValModule<GenericSelector<SourceObject>>> = T extends ValModule<infer S> ? S extends SourceObject ? NonNullable<S>[string] extends JsonSource<infer C> ? C | null : StegaOfSource<NonNullable<S>[string]> | null : never : never;
 declare const initFetchValRouteStega: (config: ValConfig, valApiEndpoints: string, valServerPromise: Promise<ValServer>, isEnabled: () => Promise<boolean>, getHeaders: () => Promise<{
     get(name: string): string | null;
 }>, getCookies: () => Promise<{
@@ -19,6 +19,64 @@ declare const initFetchValRouteStega: (config: ValConfig, valApiEndpoints: strin
         value: string;
     } | undefined;
 }>) => <T extends ValModule<GenericSelector<SourceObject>>>(selector: T, params: Promise<Record<string, string | string[]>> | Record<string, string | string[]> | unknown) => Promise<FetchValRouteReturnType<T>>;
+/**
+ * Loads a single `.jsonValues()` entry's DRAFT content via the in-process
+ * `/json` endpoint (which replays pending patches). Returns `undefined` when the
+ * entry has no draft content to serve — the caller then falls back to the
+ * locally-bundled committed content.
+ */
+/**
+ * What the draft state says about an entry.
+ *
+ * The three cases have to stay distinct: `absent` is an ANSWER — the entry is not
+ * there in the draft state, e.g. a pending patch removed it — while `unavailable`
+ * means we could not ask. Collapsing them into `undefined` is what made a
+ * draft-deleted entry keep rendering its committed content: the caller could not
+ * tell "it is gone" from "ask the committed source instead".
+ */
+/**
+ * The slice of `ValServer` the single-entry readers actually use. Narrower than
+ * `ValServer` on purpose: it says what the dependency IS, and it lets a test
+ * drive these readers with a one-route fake instead of casting a partial object
+ * to the whole server type.
+ */
+export type JsonEntryValServer = Pick<ValServer, "/json">;
+export type DraftJsonEntry = {
+    status: "content";
+    content: unknown;
+} | {
+    status: "absent";
+} | {
+    status: "unavailable";
+};
+/**
+ * Picks the content a draft-aware single-entry read should render.
+ *
+ * The rule the two callers share: the draft state WINS when it has an answer —
+ * including the answer "this entry is gone" — and the committed content is used
+ * only when there is no draft answer to be had (Val disabled, or we could not
+ * ask). Returning `undefined` means "render nothing"; both callers turn that into
+ * a null/undefined result.
+ */
+export declare function resolveDraftOrCommittedEntry(draft: DraftJsonEntry, loadCommitted: () => Promise<unknown | undefined>): Promise<unknown | undefined>;
+type JsonEntryContentOf<T extends ValModule<GenericSelector<SourceObject>>> = T extends ValModule<infer S> ? S extends Record<string, infer V> ? V extends JsonSource<infer C> ? C : never : never : never;
+/**
+ * Resolves ONE `.jsonValues()` entry by key, loading only that entry instead of
+ * the whole record — the runtime-scaling counterpart to the eager `fetchVal`.
+ *
+ * Production (Val disabled): resolves the entry's lazy import thunk from the
+ * locally-bundled module. One dynamic import, no server round-trip.
+ *
+ * Enabled (draft mode): reads the entry through `/json`, which replays pending
+ * patches, so uncommitted Studio edits show up. Falls back to the local thunk if
+ * the draft read yields nothing.
+ */
+export declare const initFetchValKeyStega: (valServerPromise: Promise<JsonEntryValServer>, isEnabled: () => Promise<boolean>, getCookies: () => Promise<{
+    get(name: string): {
+        name: string;
+        value: string;
+    } | undefined;
+}>) => <T extends ValModule<GenericSelector<SourceObject>>>(selector: T, key: string) => Promise<JsonEntryContentOf<T> | undefined>;
 declare const initFetchValRouteUrl: (config: ValConfig, valApiEndpoints: string, valServerPromise: Promise<ValServer>, isEnabled: () => Promise<boolean>, getHeaders: () => Promise<{
     get(name: string): string | null;
 }>, getCookies: () => Promise<{
@@ -34,6 +92,7 @@ type ValNextRscConfig = {
 };
 export declare function initValRsc(config: ValConfig, valModules: ValModules, rscNextConfig: ValNextRscConfig): {
     fetchValStega: ReturnType<typeof initFetchValStega>;
+    fetchValKeyStega: ReturnType<typeof initFetchValKeyStega>;
     fetchValRouteStega: ReturnType<typeof initFetchValRouteStega>;
     fetchValRouteUrl: ReturnType<typeof initFetchValRouteUrl>;
 };

package/dist/{routeFromVal-8855a5cc.esm.js → routeFromVal-263eec96.esm.js}

@@ -14,6 +14,46 @@ function _typeof(o) {
   }, _typeof(o);
 }
 
+/**
+ * True when the module's schema is a `.jsonValues()` record/router — i.e. each
+ * entry value is a lazily-loaded `c.json(() => import(...))` marker. Used by the
+ * route helpers to load ONLY the matched entry instead of the whole record.
+ */
+function isJsonValuesRecordSchema(schema) {
+  return schema instanceof RecordSchema && schema["executeSerialize"]().jsonValues === true;
+}
+
+/**
+ * Builds the `stegaEncode` `root` seed for a single `.jsonValues()` entry, so its
+ * strings get edit tags. Without a seed, `stegaEncode` on raw entry content is an
+ * identity transform (the content carries no selector path/schema).
+ *
+ * Yields e.g. `/app/support/[slug]/page.val.ts?p="/support/faq"`, so a `title`
+ * field is tagged `…?p="/support/faq"."title"` — the shape the Studio's
+ * `findUnloadedJsonEntryKey` walks, so click-to-edit + lazy load line up.
+ */
+function getJsonEntryStegaRoot(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+selector, key
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+  var modulePath = selector && Internal.getValPath(selector);
+  if (!modulePath) {
+    return undefined;
+  }
+  var schema = selector && Internal.getSchema(selector);
+  if (!(schema instanceof RecordSchema)) {
+    return undefined;
+  }
+  var path = Internal.createValPathOfItem(modulePath, key);
+  if (!path) {
+    return undefined;
+  }
+  return {
+    path: path,
+    schema: schema["executeSerialize"]().item
+  };
+}
 function getValRouteUrlFromVal(resolvedParams, methodName,
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 path,
@@ -153,4 +193,4 @@ val) {
   return actualRoute;
 }
 
-export { getValRouteUrlFromVal as g, initValRouteFromVal as i };
+export { _typeof as _, isJsonValuesRecordSchema as a, getValRouteUrlFromVal as b, getJsonEntryStegaRoot as g, initValRouteFromVal as i };

package/dist/{routeFromVal-13c832b2.cjs.prod.js → routeFromVal-8ac2f984.cjs.prod.js}

@@ -16,6 +16,46 @@ function _typeof(o) {
   }, _typeof(o);
 }
 
+/**
+ * True when the module's schema is a `.jsonValues()` record/router — i.e. each
+ * entry value is a lazily-loaded `c.json(() => import(...))` marker. Used by the
+ * route helpers to load ONLY the matched entry instead of the whole record.
+ */
+function isJsonValuesRecordSchema(schema) {
+  return schema instanceof core.RecordSchema && schema["executeSerialize"]().jsonValues === true;
+}
+
+/**
+ * Builds the `stegaEncode` `root` seed for a single `.jsonValues()` entry, so its
+ * strings get edit tags. Without a seed, `stegaEncode` on raw entry content is an
+ * identity transform (the content carries no selector path/schema).
+ *
+ * Yields e.g. `/app/support/[slug]/page.val.ts?p="/support/faq"`, so a `title`
+ * field is tagged `…?p="/support/faq"."title"` — the shape the Studio's
+ * `findUnloadedJsonEntryKey` walks, so click-to-edit + lazy load line up.
+ */
+function getJsonEntryStegaRoot(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+selector, key
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+  var modulePath = selector && core.Internal.getValPath(selector);
+  if (!modulePath) {
+    return undefined;
+  }
+  var schema = selector && core.Internal.getSchema(selector);
+  if (!(schema instanceof core.RecordSchema)) {
+    return undefined;
+  }
+  var path = core.Internal.createValPathOfItem(modulePath, key);
+  if (!path) {
+    return undefined;
+  }
+  return {
+    path: path,
+    schema: schema["executeSerialize"]().item
+  };
+}
 function getValRouteUrlFromVal(resolvedParams, methodName,
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 path,
@@ -155,5 +195,8 @@ val) {
   return actualRoute;
 }
 
+exports._typeof = _typeof;
+exports.getJsonEntryStegaRoot = getJsonEntryStegaRoot;
 exports.getValRouteUrlFromVal = getValRouteUrlFromVal;
 exports.initValRouteFromVal = initValRouteFromVal;
+exports.isJsonValuesRecordSchema = isJsonValuesRecordSchema;

package/dist/{routeFromVal-9b610e77.cjs.dev.js → routeFromVal-b48a454a.cjs.dev.js}

@@ -16,6 +16,46 @@ function _typeof(o) {
   }, _typeof(o);
 }
 
+/**
+ * True when the module's schema is a `.jsonValues()` record/router — i.e. each
+ * entry value is a lazily-loaded `c.json(() => import(...))` marker. Used by the
+ * route helpers to load ONLY the matched entry instead of the whole record.
+ */
+function isJsonValuesRecordSchema(schema) {
+  return schema instanceof core.RecordSchema && schema["executeSerialize"]().jsonValues === true;
+}
+
+/**
+ * Builds the `stegaEncode` `root` seed for a single `.jsonValues()` entry, so its
+ * strings get edit tags. Without a seed, `stegaEncode` on raw entry content is an
+ * identity transform (the content carries no selector path/schema).
+ *
+ * Yields e.g. `/app/support/[slug]/page.val.ts?p="/support/faq"`, so a `title`
+ * field is tagged `…?p="/support/faq"."title"` — the shape the Studio's
+ * `findUnloadedJsonEntryKey` walks, so click-to-edit + lazy load line up.
+ */
+function getJsonEntryStegaRoot(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+selector, key
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+  var modulePath = selector && core.Internal.getValPath(selector);
+  if (!modulePath) {
+    return undefined;
+  }
+  var schema = selector && core.Internal.getSchema(selector);
+  if (!(schema instanceof core.RecordSchema)) {
+    return undefined;
+  }
+  var path = core.Internal.createValPathOfItem(modulePath, key);
+  if (!path) {
+    return undefined;
+  }
+  return {
+    path: path,
+    schema: schema["executeSerialize"]().item
+  };
+}
 function getValRouteUrlFromVal(resolvedParams, methodName,
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 path,
@@ -155,5 +195,8 @@ val) {
   return actualRoute;
 }
 
+exports._typeof = _typeof;
+exports.getJsonEntryStegaRoot = getJsonEntryStegaRoot;
 exports.getValRouteUrlFromVal = getValRouteUrlFromVal;
 exports.initValRouteFromVal = initValRouteFromVal;
+exports.isJsonValuesRecordSchema = isJsonValuesRecordSchema;

package/package.json

@@ -12,7 +12,7 @@
     "next",
     "react"
   ],
-  "version": "0.99.0",
+  "version": "0.100.0",
   "main": "dist/valbuild-next.cjs.js",
   "module": "dist/valbuild-next.esm.js",
   "exports": {
@@ -47,12 +47,12 @@
   "dependencies": {
     "client-only": "^0.0.1",
     "server-only": "^0.0.1",
-    "@valbuild/core": "0.99.0",
-    "@valbuild/language-server": "0.99.0",
-    "@valbuild/react": "0.99.0",
-    "@valbuild/server": "0.99.0",
-    "@valbuild/shared": "0.99.0",
-    "@valbuild/ui": "0.99.0"
+    "@valbuild/core": "0.100.0",
+    "@valbuild/language-server": "0.100.0",
+    "@valbuild/react": "0.100.0",
+    "@valbuild/server": "0.100.0",
+    "@valbuild/shared": "0.100.0",
+    "@valbuild/ui": "0.100.0"
   },
   "devDependencies": {
     "@testing-library/react": "^14.0.0",