adjacent-next 0.1.0

package/dist/service-worker.js

@@ -0,0 +1,393 @@
+import { WORKER_COMMAND } from "adjacent-core";
+import { basePath, withBasePath } from "./base-path.js";
+/**
+ * Enough for an application's own scripts, styles, fonts and the images of a
+ * few screens, and small enough that a long session cannot fill the origin's
+ * storage quota with them.
+ */
+export const DEFAULT_ASSET_LIMIT = 64;
+function stableHash(value) {
+    let hash = 2_166_136_261;
+    for (const character of value) {
+        hash ^= character.charCodeAt(0);
+        hash = Math.imul(hash, 16_777_619);
+    }
+    return (hash >>> 0).toString(36);
+}
+/**
+ * A trailing slash is dropped, because `/admin` and `/admin/` exclude the same
+ * thing and two spellings of one rule would be two rules in the worker. Sorted
+ * and deduplicated so reordering the configuration does not change the worker,
+ * which would otherwise read as a new deployment.
+ */
+function normaliseExclusions(paths) {
+    if (!paths)
+        return [];
+    return [...new Set(paths.map((path) => path.replace(/\/+$/, "")))].sort();
+}
+export function resolveOfflineRuntime(offline) {
+    if (!offline) {
+        return {
+            assetLimit: DEFAULT_ASSET_LIMIT,
+            enabled: false,
+            exclude: [],
+            navigation: "network-first",
+        };
+    }
+    if (offline === true) {
+        return {
+            assetLimit: DEFAULT_ASSET_LIMIT,
+            enabled: true,
+            exclude: [],
+            navigation: "network-first",
+        };
+    }
+    return {
+        assetLimit: offline.assetLimit ?? DEFAULT_ASSET_LIMIT,
+        enabled: true,
+        exclude: normaliseExclusions(offline.exclude),
+        fallback: offline.fallback,
+        navigation: offline.navigation ?? "network-first",
+    };
+}
+export function createServiceWorkerSource(config, development = process.env.NODE_ENV === "development") {
+    const offline = resolveOfflineRuntime(config.offline);
+    const base = basePath();
+    const startUrl = withBasePath(config.navigation?.startUrl ?? "/", base);
+    const revision = stableHash(JSON.stringify({
+        appName: config.app.name,
+        // Without this the worker is identical between builds, so the browser
+        // rightly concludes there is no update: no update-available state, and
+        // `checkForUpdate()` that can never answer true.
+        buildId: process.env["ADJACENT_BUILD_ID"],
+        assetLimit: offline.assetLimit,
+        exclude: offline.exclude,
+        selfDestroying: config.selfDestroying,
+        base,
+        fallback: offline.fallback,
+        navigation: offline.navigation,
+        slug: config.app.slug,
+        startUrl,
+        version: config.app.version,
+    }));
+    const cachePrefix = `adjacent-${config.app.slug}-`;
+    if (config.selfDestroying) {
+        return `/* Generated by Adjacent: this worker removes itself. */
+const CACHE_PREFIX = ${JSON.stringify(cachePrefix)};
+
+self.addEventListener("install", () => {
+  self.skipWaiting();
+});
+
+/*
+ * Everything is inside waitUntil, because a worker that has unregistered may
+ * be terminated at any moment and half-deleted caches would be left behind.
+ *
+ * Only this application's caches are deleted. Another application on the same
+ * origin keeps its own, which is why they carry a prefix.
+ */
+self.addEventListener("activate", (event) => {
+  event.waitUntil((async () => {
+    const keys = await caches.keys();
+    await Promise.all(
+      keys.filter((key) => key.startsWith(CACHE_PREFIX)).map((key) => caches.delete(key)),
+    );
+
+    await self.registration.unregister();
+
+    // Reload what is open, so a window stops running against a worker that has
+    // gone rather than waiting for the visitor to navigate.
+    const windows = await self.clients.matchAll({ type: "window" });
+    for (const client of windows) client.navigate(client.url);
+  })());
+});
+`;
+    }
+    return `/* Generated by Adjacent. */
+const CACHE_PREFIX = ${JSON.stringify(`adjacent-${config.app.slug}-`)};
+const PAGE_CACHE = CACHE_PREFIX + "pages-${revision}";
+const ASSET_CACHE = CACHE_PREFIX + "assets-${revision}";
+const PRECACHE_URLS = ${JSON.stringify([
+        ...new Set([startUrl, offline.fallback ? withBasePath(offline.fallback, base) : undefined].filter(Boolean)),
+    ])};
+const NAVIGATION_STRATEGY = ${JSON.stringify(offline.navigation)};
+const DEVELOPMENT = ${JSON.stringify(development)};
+const COMMAND = ${JSON.stringify(WORKER_COMMAND)};
+const APP_NAME = ${JSON.stringify(config.app.name)};
+const ASSET_LIMIT = ${JSON.stringify(offline.assetLimit)};
+const EXCLUDED_PATHS = ${JSON.stringify([
+        ...offline.exclude.map((path) => withBasePath(path, base)),
+        ...["/sw.js", "/_adjacent", "/.well-known", "/api"].map((path) => withBasePath(path, base)),
+    ])};
+const START_URL = ${JSON.stringify(startUrl)};
+
+self.addEventListener("install", (event) => {
+  if (DEVELOPMENT) {
+    event.waitUntil(self.skipWaiting());
+    return;
+  }
+  event.waitUntil(
+    caches.open(PAGE_CACHE)
+      .then((cache) => cache.addAll(PRECACHE_URLS))
+  );
+});
+
+self.addEventListener("activate", (event) => {
+  event.waitUntil(
+    caches.keys()
+      .then((keys) => Promise.all(
+        keys
+          .filter((key) => key.startsWith(CACHE_PREFIX) && (
+            DEVELOPMENT || (key !== PAGE_CACHE && key !== ASSET_CACHE)
+          ))
+          .map((key) => caches.delete(key)),
+      ))
+      .then(() => self.clients.claim()),
+  );
+});
+
+/*
+ * Writing to a cache can fail, and the usual reason is the origin's storage
+ * quota. A failed write must not take the response with it: the fetch worked,
+ * and the caller wants the page or the asset whether or not it could be kept.
+ */
+async function store(cache, request, response, limit) {
+  try {
+    await cache.put(request, response);
+    if (limit === undefined) return;
+    // Oldest first, which is the order the Cache API keeps them in. Approximate
+    // as an eviction policy, and enough to stop unbounded growth.
+    const keys = await cache.keys();
+    if (keys.length <= limit) return;
+    await Promise.all(keys.slice(0, keys.length - limit).map((key) => cache.delete(key)));
+  } catch {
+    // Out of quota, or evicted mid-write. Serving the response still works.
+  }
+}
+
+async function networkFirst(request, cacheName, fallbackUrl) {
+  const cache = await caches.open(cacheName);
+  try {
+    const response = await fetch(request);
+    if (isCacheable(response)) await store(cache, request, response.clone());
+    return response;
+  } catch (error) {
+    const cached = await cache.match(request);
+    if (cached) return cached;
+    if (fallbackUrl) {
+      const fallback = await cache.match(fallbackUrl);
+      if (fallback) return fallback;
+    }
+    throw error;
+  }
+}
+
+async function cacheFirst(request, cacheName) {
+  const cache = await caches.open(cacheName);
+  const cached = await cache.match(request);
+  if (cached) return cached;
+  const response = await fetch(request);
+  if (isCacheable(response)) await store(cache, request, response.clone(), ASSET_LIMIT);
+  return response;
+}
+
+async function cacheFirstNavigation(request, fallbackUrl) {
+  try {
+    return await cacheFirst(request, PAGE_CACHE);
+  } catch (error) {
+    if (fallbackUrl) {
+      const fallback = await caches.match(fallbackUrl);
+      if (fallback) return fallback;
+    }
+    throw error;
+  }
+}
+
+function isCacheable(response) {
+  const cacheControl = response.headers.get("cache-control") || "";
+  return response.ok &&
+    (response.type === "basic" || response.type === "default") &&
+    !/(?:^|,)\\s*(?:no-store|private)(?:\\s|,|$)/i.test(cacheControl);
+}
+
+/* A path excludes itself and everything under it, and nothing else: /admin
+ * covers /admin and /admin/users, and leaves /administrators alone. */
+function isExcludedPath(pathname) {
+  return EXCLUDED_PATHS.some(
+    (path) => pathname === path || pathname.startsWith(path + "/"),
+  );
+}
+
+function isExcludedRequest(request, url) {
+  return request.method !== "GET" ||
+    isExcludedPath(url.pathname) ||
+    url.origin !== self.location.origin ||
+    request.headers.has("authorization") ||
+    request.headers.get("rsc") === "1" ||
+    request.headers.has("next-router-state-tree");
+}
+
+async function clearAdjacentCache(target) {
+  const names = target === "pages"
+    ? [PAGE_CACHE]
+    : target === "assets"
+      ? [ASSET_CACHE]
+      : [PAGE_CACHE, ASSET_CACHE];
+  await Promise.all(names.map((name) => caches.delete(name)));
+}
+
+async function revalidatePages(urls) {
+  const cache = await caches.open(PAGE_CACHE);
+  await Promise.all(urls.map(async (input) => {
+    const url = new URL(input, self.location.origin);
+    if (url.origin !== self.location.origin) {
+      throw new Error("Adjacent can only revalidate same-origin URLs.");
+    }
+    const request = new Request(url, { headers: { accept: "text/html" } });
+    const response = await fetch(request);
+    if (!isCacheable(response)) {
+      throw new Error("Could not cache " + url.pathname + ": HTTP " + response.status);
+    }
+    await cache.put(request, response);
+  }));
+}
+
+self.addEventListener("message", (event) => {
+  const command = event.data;
+  const reply = (response) => event.ports[0]?.postMessage(response);
+  event.waitUntil((async () => {
+    try {
+      if (!command || typeof command !== "object") throw new Error("Invalid Adjacent command.");
+      if (command.type === COMMAND.activateUpdate) {
+        await self.skipWaiting();
+      } else if (command.type === COMMAND.clearCache) {
+        if (!["all", "assets", "pages"].includes(command.target)) {
+          throw new Error("Invalid Adjacent cache target.");
+        }
+        await clearAdjacentCache(command.target);
+      } else if (command.type === COMMAND.revalidate) {
+        if (!Array.isArray(command.urls) || !command.urls.every((url) => typeof url === "string")) {
+          throw new Error("Invalid Adjacent revalidation URLs.");
+        }
+        await revalidatePages(command.urls);
+      } else {
+        throw new Error("Unknown Adjacent command.");
+      }
+      reply({ ok: true });
+    } catch (error) {
+      reply({ ok: false, error: error instanceof Error ? error.message : String(error) });
+    }
+  })());
+});
+
+self.addEventListener("fetch", (event) => {
+  if (DEVELOPMENT) return;
+  const { request } = event;
+  const url = new URL(request.url);
+  if (isExcludedRequest(request, url)) return;
+
+  if (request.mode === "navigate") {
+    const fallbackUrl = ${JSON.stringify(offline.fallback)};
+    event.respondWith(
+      NAVIGATION_STRATEGY === "cache-first"
+        ? cacheFirstNavigation(request, fallbackUrl)
+        : networkFirst(request, PAGE_CACHE, fallbackUrl),
+    );
+    return;
+  }
+
+  if (["font", "image", "script", "style", "worker"].includes(request.destination)) {
+    event.respondWith(cacheFirst(request, ASSET_CACHE));
+  }
+});
+
+/*
+ * A push must be shown. Browsers require the subscription to be
+ * userVisibleOnly, and one that arrives without a notification is reported by
+ * the browser with a notification of its own saying so, which is worse than
+ * anything an application would have written.
+ */
+function readPushPayload(event) {
+  if (!event.data) return { title: APP_NAME };
+  try {
+    const payload = event.data.json();
+    return payload && typeof payload === "object" ? payload : { title: APP_NAME, body: String(payload) };
+  } catch {
+    // Not JSON, so it is the message itself.
+    return { title: APP_NAME, body: event.data.text() };
+  }
+}
+
+self.addEventListener("push", (event) => {
+  const payload = readPushPayload(event);
+  const shown = self.registration.showNotification(payload.title ?? APP_NAME, {
+    actions: payload.actions,
+    badge: payload.badge,
+    body: payload.body,
+    data: { ...payload.data, url: payload.url ?? START_URL },
+    icon: payload.icon,
+    renotify: payload.renotify,
+    requireInteraction: payload.requireInteraction,
+    silent: payload.silent,
+    tag: payload.tag,
+  });
+
+  // The count on the application icon travels in the same message, so a push
+  // that clears a queue can clear the badge with it.
+  const badged =
+    typeof payload.badgeCount === "number" && navigator.setAppBadge
+      ? payload.badgeCount > 0
+        ? navigator.setAppBadge(payload.badgeCount)
+        : navigator.clearAppBadge()
+      : undefined;
+
+  event.waitUntil(Promise.all([shown, badged]));
+});
+
+self.addEventListener("notificationclick", (event) => {
+  event.notification.close();
+
+  const data = event.notification.data ?? {};
+  const target = new URL(data.url ?? START_URL, self.location.origin);
+
+  event.waitUntil((async () => {
+    const windows = await self.clients.matchAll({ includeUncontrolled: true, type: "window" });
+    const message = {
+      action: event.action || undefined,
+      data,
+      type: "adjacent:notificationclick",
+    };
+
+    // Focus what is already open rather than opening a second window, and tell
+    // it which action was pressed, since only the application knows what a
+    // button of its own means.
+    for (const client of windows) {
+      if (new URL(client.url).origin !== target.origin) continue;
+      client.postMessage(message);
+      await client.focus();
+      if (client.url !== target.href) await client.navigate?.(target.href);
+      return;
+    }
+
+    await self.clients.openWindow(target.href);
+  })());
+});
+`;
+}
+export function createServiceWorkerRoute(config) {
+    const source = createServiceWorkerSource(config);
+    return {
+        GET() {
+            return new Response(source, {
+                headers: {
+                    "cache-control": "no-cache, no-store, must-revalidate",
+                    "content-security-policy": "default-src 'self'; script-src 'self'",
+                    "content-type": "application/javascript; charset=utf-8",
+                    "service-worker-allowed": "/",
+                    "x-content-type-options": "nosniff",
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=service-worker.js.map

package/dist/service-worker.js.map

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

package/dist/with-adjacent-layout.d.ts

@@ -0,0 +1,10 @@
+import { type ComponentType, type FunctionComponent, type ReactNode } from "react";
+export interface AdjacentLayoutProps {
+    readonly children: ReactNode;
+}
+export interface AdjacentLayoutRuntime {
+    readonly devChannel?: ReactNode;
+    readonly serviceWorkerRegistration: ReactNode;
+}
+export declare function withAdjacentLayout(runtime: AdjacentLayoutRuntime): <Props extends AdjacentLayoutProps>(Layout: ComponentType<Props>) => FunctionComponent<Props>;
+//# sourceMappingURL=with-adjacent-layout.d.ts.map

package/dist/with-adjacent-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-adjacent-layout.d.ts","sourceRoot":"","sources":["../src/with-adjacent-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,yBAAyB,EAAE,SAAS,CAAC;CAC/C;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,qBAAqB,GAC7B,CAAC,KAAK,SAAS,mBAAmB,EACnC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,KACzB,iBAAiB,CAAC,KAAK,CAAC,CAiB5B"}

package/dist/with-adjacent-layout.js

@@ -0,0 +1,11 @@
+import { createElement, Fragment, } from "react";
+export function withAdjacentLayout(runtime) {
+    return function wrapAdjacentLayout(Layout) {
+        function AdjacentLayout(props) {
+            const children = createElement(Fragment, null, props.children, runtime.serviceWorkerRegistration, runtime.devChannel);
+            return createElement(Layout, { ...props, children });
+        }
+        return AdjacentLayout;
+    };
+}
+//# sourceMappingURL=with-adjacent-layout.js.map

package/dist/with-adjacent-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-adjacent-layout.js","sourceRoot":"","sources":["../src/with-adjacent-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,QAAQ,GAIT,MAAM,OAAO,CAAC;AAWf,MAAM,UAAU,kBAAkB,CAChC,OAA8B;IAI9B,OAAO,SAAS,kBAAkB,CAChC,MAA4B;QAE5B,SAAS,cAAc,CAAC,KAAY;YAClC,MAAM,QAAQ,GAAG,aAAa,CAC5B,QAAQ,EACR,IAAI,EACJ,KAAK,CAAC,QAAQ,EACd,OAAO,CAAC,yBAAyB,EACjC,OAAO,CAAC,UAAU,CACnB,CAAC;YACF,OAAO,aAAa,CAAC,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,cAAc,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC"}

package/dist/with-adjacent.d.ts

@@ -0,0 +1,17 @@
+import type { NextConfig } from "next";
+export interface AdjacentNextConfigOptions {
+    readonly connectivityRecovery?: boolean;
+    readonly devOrigins?: readonly string[];
+    readonly discoverLocalOrigins?: boolean;
+    readonly installElementOriginTrial?: string;
+    readonly nextConfig?: NextConfig;
+    readonly partialPrefetching?: boolean;
+    readonly securityHeaders?: boolean;
+}
+export declare function discoverLocalDevOrigins(): string[];
+export declare function shouldSendDevTunnelHeaders(tunnelOrigin: string | undefined, nodeEnvironment?: "development" | "production" | "test"): boolean;
+export declare function shouldEnablePartialPrefetching(requested: boolean | undefined, nodeEnvironment?: "development" | "production" | "test"): boolean;
+/** The name the build id travels under, in Next's `env` and in the worker. */
+export declare const BUILD_ID_ENV = "ADJACENT_BUILD_ID";
+export declare function withAdjacent(options?: AdjacentNextConfigOptions): NextConfig;
+//# sourceMappingURL=with-adjacent.d.ts.map

package/dist/with-adjacent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-adjacent.d.ts","sourceRoot":"","sources":["../src/with-adjacent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAKvC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAYD,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAWlD;AAcD,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,eAAe,wCAAuB,GACrC,OAAO,CAET;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9B,eAAe,wCAAuB,GACrC,OAAO,CAET;AAED,8EAA8E;AAC9E,eAAO,MAAM,YAAY,sBAAsB,CAAC;AAqBhD,wBAAgB,YAAY,CAC1B,OAAO,GAAE,yBAA8B,GACtC,UAAU,CAyFZ"}

package/dist/with-adjacent.js

@@ -0,0 +1,139 @@
+import { networkInterfaces } from "node:os";
+import { BASE_PATH_ENV, normaliseBasePath } from "./base-path.js";
+import { DEV_CHANNEL_PATH, resolveDevChannel } from "./dev-channel.js";
+const DEV_TUNNEL_HEADERS = [
+    { key: "Cache-Control", value: "no-store, must-revalidate" },
+];
+const SECURITY_HEADERS = [
+    { key: "Referrer-Policy", value: "strict-origin-when-cross-origin" },
+    { key: "X-Content-Type-Options", value: "nosniff" },
+    { key: "X-Frame-Options", value: "DENY" },
+];
+export function discoverLocalDevOrigins() {
+    return Object.values(networkInterfaces())
+        .flatMap((addresses) => addresses ?? [])
+        .filter((address) => address.family === "IPv4" &&
+        !address.internal &&
+        isPrivateIpv4(address.address))
+        .map((address) => address.address)
+        .sort();
+}
+function isPrivateIpv4(address) {
+    const octets = address.split(".").map(Number);
+    if (octets.length !== 4 || octets.some(Number.isNaN))
+        return false;
+    const [first, second] = octets;
+    return (first === 10 ||
+        (first === 172 && second !== undefined && second >= 16 && second <= 31) ||
+        (first === 192 && second === 168));
+}
+export function shouldSendDevTunnelHeaders(tunnelOrigin, nodeEnvironment = process.env.NODE_ENV) {
+    return tunnelOrigin !== undefined && nodeEnvironment === "development";
+}
+export function shouldEnablePartialPrefetching(requested, nodeEnvironment = process.env.NODE_ENV) {
+    return requested === true && nodeEnvironment !== "development";
+}
+/** The name the build id travels under, in Next's `env` and in the worker. */
+export const BUILD_ID_ENV = "ADJACENT_BUILD_ID";
+/**
+ * Identifies one build, so the generated service worker changes when the
+ * application does.
+ *
+ * Read from the environment first, which is how a deployment makes it
+ * deterministic: setting it to a commit SHA means rebuilding the same commit
+ * produces the same worker and nobody is told there is an update when there is
+ * not. Otherwise it is fresh per build, which is what Next does for its own
+ * build id.
+ *
+ * It has to be decided here, while the configuration is evaluated, because Next
+ * writes `env` into the build. A value decided per server instance would differ
+ * between them, every update check would find a new worker, and the result is a
+ * reload that never settles.
+ */
+function resolveBuildId() {
+    return process.env[BUILD_ID_ENV] ?? crypto.randomUUID();
+}
+export function withAdjacent(options = {}) {
+    const { connectivityRecovery, devOrigins = [], discoverLocalOrigins = true, installElementOriginTrial, nextConfig = {}, partialPrefetching, securityHeaders = true, } = options;
+    const discoveredOrigins = discoverLocalOrigins
+        ? discoverLocalDevOrigins()
+        : [];
+    const tunnelOrigin = process.env.ADJACENT_DEV_ORIGIN;
+    const assetLinksUrl = process.env.ADJACENT_ASSET_LINKS_URL;
+    const devChannel = resolveDevChannel();
+    const configuredRewrites = nextConfig.rewrites;
+    const configuredHeaders = nextConfig.headers;
+    const enablePartialPrefetching = shouldEnablePartialPrefetching(partialPrefetching);
+    return {
+        ...nextConfig,
+        // After the spread, or the application's own `env` replaces this one.
+        env: {
+            ...nextConfig.env,
+            // Nothing outside next.config.ts can see the base path, so it is
+            // published here for the worker, the manifest and the registration.
+            [BASE_PATH_ENV]: normaliseBasePath(nextConfig.basePath),
+            [BUILD_ID_ENV]: resolveBuildId(),
+        },
+        cacheComponents: enablePartialPrefetching
+            ? true
+            : nextConfig.cacheComponents,
+        partialPrefetching: enablePartialPrefetching
+            ? true
+            : nextConfig.partialPrefetching,
+        experimental: connectivityRecovery === undefined
+            ? nextConfig.experimental
+            : {
+                ...nextConfig.experimental,
+                useOffline: connectivityRecovery,
+            },
+        allowedDevOrigins: [
+            ...new Set([
+                ...(nextConfig.allowedDevOrigins ?? []),
+                ...discoveredOrigins,
+                ...devOrigins,
+                ...(tunnelOrigin ? [new URL(tunnelOrigin).hostname] : []),
+            ]),
+        ],
+        async headers() {
+            const existing = configuredHeaders ? await configuredHeaders() : [];
+            const tunnelHeaders = shouldSendDevTunnelHeaders(tunnelOrigin)
+                ? [{ headers: [...DEV_TUNNEL_HEADERS], source: "/(.*)" }]
+                : [];
+            if (!securityHeaders)
+                return [...existing, ...tunnelHeaders];
+            return [
+                ...existing,
+                ...tunnelHeaders,
+                {
+                    headers: [
+                        ...SECURITY_HEADERS,
+                        ...(installElementOriginTrial
+                            ? [{ key: "Origin-Trial", value: installElementOriginTrial }]
+                            : []),
+                    ],
+                    source: "/(.*)",
+                },
+            ];
+        },
+        async rewrites() {
+            const existing = configuredRewrites ? await configuredRewrites() : [];
+            const adjacentRewrites = [
+                ...(assetLinksUrl
+                    ? [{ source: "/.well-known/assetlinks.json", destination: assetLinksUrl }]
+                    : []),
+                ...(devChannel.url
+                    ? [{ source: DEV_CHANNEL_PATH, destination: devChannel.url }]
+                    : []),
+            ];
+            if (adjacentRewrites.length === 0)
+                return existing;
+            if (Array.isArray(existing))
+                return [...existing, ...adjacentRewrites];
+            return {
+                ...existing,
+                beforeFiles: [...(existing.beforeFiles ?? []), ...adjacentRewrites],
+            };
+        },
+    };
+}
+//# sourceMappingURL=with-adjacent.js.map

package/dist/with-adjacent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-adjacent.js","sourceRoot":"","sources":["../src/with-adjacent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAI5C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAYvE,MAAM,kBAAkB,GAAG;IACzB,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,2BAA2B,EAAE;CACpD,CAAC;AAEX,MAAM,gBAAgB,GAAG;IACvB,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,iCAAiC,EAAE;IACpE,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,SAAS,EAAE;IACnD,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE;CACjC,CAAC;AAEX,MAAM,UAAU,uBAAuB;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;SACtC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC;SACvC,MAAM,CACL,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,MAAM,KAAK,MAAM;QACzB,CAAC,OAAO,CAAC,QAAQ;QACjB,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CACjC;SACA,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;SACjC,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAC/B,OAAO,CACL,KAAK,KAAK,EAAE;QACZ,CAAC,KAAK,KAAK,GAAG,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE,CAAC;QACvE,CAAC,KAAK,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,YAAgC,EAChC,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ;IAEtC,OAAO,YAAY,KAAK,SAAS,IAAI,eAAe,KAAK,aAAa,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,SAA8B,EAC9B,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ;IAEtC,OAAO,SAAS,KAAK,IAAI,IAAI,eAAe,KAAK,aAAa,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,SAAS,cAAc;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,UAAqC,EAAE;IAEvC,MAAM,EACJ,oBAAoB,EACpB,UAAU,GAAG,EAAE,EACf,oBAAoB,GAAG,IAAI,EAC3B,yBAAyB,EACzB,UAAU,GAAG,EAAE,EACf,kBAAkB,EAClB,eAAe,GAAG,IAAI,GACvB,GAAG,OAAO,CAAC;IACZ,MAAM,iBAAiB,GAAG,oBAAoB;QAC5C,CAAC,CAAC,uBAAuB,EAAE;QAC3B,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACrD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAC3D,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,MAAM,kBAAkB,GAAG,UAAU,CAAC,QAAQ,CAAC;IAC/C,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,CAAC;IAC7C,MAAM,wBAAwB,GAAG,8BAA8B,CAAC,kBAAkB,CAAC,CAAC;IAEpF,OAAO;QACL,GAAG,UAAU;QACb,sEAAsE;QACtE,GAAG,EAAE;YACH,GAAG,UAAU,CAAC,GAAG;YACjB,iEAAiE;YACjE,oEAAoE;YACpE,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC;YACvD,CAAC,YAAY,CAAC,EAAE,cAAc,EAAE;SACjC;QACD,eAAe,EAAE,wBAAwB;YACvC,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,UAAU,CAAC,eAAe;QAC9B,kBAAkB,EAAE,wBAAwB;YAC1C,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,UAAU,CAAC,kBAAkB;QACjC,YAAY,EAAE,oBAAoB,KAAK,SAAS;YAC9C,CAAC,CAAC,UAAU,CAAC,YAAY;YACzB,CAAC,CAAC;gBACA,GAAG,UAAU,CAAC,YAAY;gBAC1B,UAAU,EAAE,oBAAoB;aACjC;QACH,iBAAiB,EAAE;YACjB,GAAG,IAAI,GAAG,CAAC;gBACT,GAAG,CAAC,UAAU,CAAC,iBAAiB,IAAI,EAAE,CAAC;gBACvC,GAAG,iBAAiB;gBACpB,GAAG,UAAU;gBACb,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC;SACH;QACD,KAAK,CAAC,OAAO;YACX,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,CAAC,MAAM,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,MAAM,aAAa,GAAG,0BAA0B,CAAC,YAAY,CAAC;gBAC5D,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;gBACzD,CAAC,CAAC,EAAE,CAAC;YACP,IAAI,CAAC,eAAe;gBAAE,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,aAAa,CAAC,CAAC;YAC7D,OAAO;gBACL,GAAG,QAAQ;gBACX,GAAG,aAAa;gBAChB;oBACE,OAAO,EAAE;wBACP,GAAG,gBAAgB;wBACnB,GAAG,CAAC,yBAAyB;4BAC3B,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;4BAC7D,CAAC,CAAC,EAAE,CAAC;qBACR;oBACD,MAAM,EAAE,OAAO;iBAChB;aACF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,QAAQ;YACZ,MAAM,QAAQ,GAAG,kBAAkB,CAAC,CAAC,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,MAAM,gBAAgB,GAAG;gBACvB,GAAG,CAAC,aAAa;oBACf,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,8BAA8B,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;oBAC1E,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,UAAU,CAAC,GAAG;oBAChB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC;oBAC7D,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YACF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC;YAEnD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,gBAAgB,CAAC,CAAC;YACvE,OAAO;gBACL,GAAG,QAAQ;gBACX,WAAW,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,gBAAgB,CAAC;aACpE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "adjacent-next",
+  "version": "0.1.0",
+  "description": "Next.js App Router integration for Adjacent: metadata, manifest, service worker, and development wiring.",
+  "keywords": [
+    "pwa",
+    "nextjs",
+    "app-router",
+    "service-worker",
+    "adjacent"
+  ],
+  "license": "MIT",
+  "author": "Eric Kweyunga",
+  "homepage": "https://github.com/erickweyunga/adjacent-framework/blob/main/docs/nextjs.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/erickweyunga/adjacent-framework.git",
+    "directory": "packages/adjacent-next"
+  },
+  "bugs": {
+    "url": "https://github.com/erickweyunga/adjacent-framework/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./proxy": {
+      "types": "./dist/proxy.d.ts",
+      "import": "./dist/proxy.js",
+      "default": "./dist/proxy.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "adjacent-core": "workspace:~"
+  },
+  "peerDependencies": {
+    "next": ">=16"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.13",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "next": "^16.3.2",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "typescript": "^5"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}