@nubbin/next 0.1.0-rc.5 → 0.1.0-rc.7

package/dist/index.d.ts

@@ -1,16 +1,35 @@
-import { FieldHintData, ArtifactStore, Artifact } from '@nubbin/core';
+import { Artifact, FieldHintData, ArtifactStore } from '@nubbin/core';
+import { Metadata } from 'next';
+
+/**
+ * Maps a compiled artifact's `meta` onto Next's `Metadata`, so the mapping is owned by the
+ * binding rather than re-decided in every consumer's `generateMetadata` — the same reason
+ * `holeFetchOptions` owns the hole-lifecycle mapping.
+ *
+ * `compile` has written `meta` into every artifact since the first one, and until this existed
+ * nothing read it: a published page could not set its own title. The shapes differ in one place
+ * — a document's `canonical` is a flat field, and Next reads a canonical URL from
+ * `alternates.canonical` — so that is the only thing this translates rather than copies.
+ *
+ * A null artifact returns an empty object rather than a title, because the caller is about to
+ * render a 404 and the layout's own metadata is the right answer for it.
+ *
+ * Optional fields are assigned only when present. `exactOptionalPropertyTypes` is on, and a
+ * `description: undefined` sent to Next is an instruction to emit an empty tag rather than an
+ * absence.
+ */
+declare function artifactMetadata(artifact: Artifact | null): Metadata;
 
 /**
  * Maps a hole's declared lifecycle onto Next's fetch cache, so the mapping is owned by the
- * binding rather than re-decided in every consumer's resolver. `no-store` also makes a page
- * carrying a request hole dynamic — per-request resolution is exactly what it declared.
+ * binding rather than re-decided in every consumer's resolver.
  *
  * Takes core's `FieldHintData` directly. An earlier plan derived a local `HoleSpec` from
  * `ArtifactNode["holes"]` so two packages would not import each other; core exports the type
  * by name, so both import it from core and neither derivation is needed.
  */
 declare function holeFetchOptions(spec: FieldHintData): RequestInit & {
-    next?: {
+    next: {
         revalidate: number;
     };
 };
@@ -43,4 +62,4 @@ declare function staticRouteParams(store: ArtifactStore): Promise<{
 /** Pointer removed, then that one route invalidated — the next request renders a real 404. */
 declare function unpublishRoute(store: ArtifactStore, route: string): Promise<void>;
 
-export { holeFetchOptions, publishRoute, resolveArtifact, routeFromSlug, staticRouteParams, unpublishRoute };
+export { artifactMetadata, holeFetchOptions, publishRoute, resolveArtifact, routeFromSlug, staticRouteParams, unpublishRoute };

package/dist/index.js

@@ -1,8 +1,18 @@
+// src/artifactMetadata.ts
+function artifactMetadata(artifact) {
+  if (artifact === null) {
+    return {};
+  }
+  const { title, description, robots, canonical } = artifact.meta;
+  const metadata = { title };
+  if (description !== void 0) metadata.description = description;
+  if (robots !== void 0) metadata.robots = robots;
+  if (canonical !== void 0) metadata.alternates = { canonical };
+  return metadata;
+}
+
 // src/holeFetchOptions.ts
 function holeFetchOptions(spec) {
-  if (spec === "request") {
-    return { cache: "no-store" };
-  }
   return { next: { revalidate: spec.revalidate } };
 }
 
@@ -43,6 +53,7 @@ async function unpublishRoute(store, route) {
   revalidatePath2(route);
 }
 export {
+  artifactMetadata,
   holeFetchOptions,
   publishRoute,
   resolveArtifact,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nubbin/next",
-  "version": "0.1.0-rc.5",
+  "version": "0.1.0-rc.7",
   "description": "The Next.js binding for Nubbin: resolve a published artifact for a route, prebuild the ones that exist, and publish or unpublish a single route.",
   "keywords": [
     "nubbin",
@@ -32,13 +32,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@nubbin/core": "0.1.0-rc.5"
+    "@nubbin/core": "0.1.0-rc.7"
   },
   "peerDependencies": {
     "next": ">=16.0.0"
   },
   "devDependencies": {
-    "next": "16.2.7",
+    "next": "16.2.11",
     "tsup": "8.5.1",
     "typescript": "6.0.3",
     "vitest": "4.1.10"