@runlot/next 0.1.0-rc.11

package/README.md

@@ -0,0 +1,86 @@
+# @runlot/next
+
+Next.js 어댑터. 설계는 `docs/nextjs.md` 에 있고, 이 문서는 표면만 적는다.
+
+> **npm 이름은 `runlot/next` 다.** 워크스페이스 안에서만 `@runlot/next` 이고,
+> 랜딩의 코드 예시와 템플릿이 쓰는 지정자는 `runlot/next` 다 (`import { env }
+> from "runlot/next"`). 게시할 때 이름을 바꾸는 자리가 여기 하나뿐이도록,
+> 이 패키지 안에서는 자기 이름을 문자열로 쓰지 않는다 — 예외는 빌드가 만드는
+> `.open-next/runlot-entry.js` 의 `@runlot/next/entry` 한 줄이다.
+
+## 표면
+
+```ts
+import { env, request, waitUntil } from "runlot/next";
+
+const user = await env.auth.user();          // 요청은 어댑터가 숨긴다
+const rows = await env.db.exec("select 1");
+const url = await env.storage.presign("covers/a.png");
+const token = env.MY_SECRET;                 // 나머지는 문자열이다
+```
+
+| 이름 | 무엇 |
+|---|---|
+| `env` | 이 요청의 바인딩. **요청 밖에서 읽으면 던진다** |
+| `env.auth.user(request?)` | 인자가 없으면 이 요청. `signOut` 도 같다 |
+| `request()` | 이 요청의 `Request` |
+| `waitUntil(p)` | 응답 뒤에도 끝까지 도는 일 |
+| `inRequest()` | 지금 요청 안인가. 라이브러리가 갈래를 나눌 때만 |
+| `wrap(worker)` (`runlot/next/entry`) | 빌드가 세우는 진입 wrapper |
+| `buildNext(opts)` (`runlot/next/build`) | `runlot deploy` 가 부른다 |
+
+`env` 가 요청 밖에서 던지는 것은 설계다. 모듈 최상단과 빌드 시점 정적 렌더가
+그 자리이고, 거기서 조용히 빈 값을 주면 **모든 페이지가 로그아웃 상태로**
+보인다 (`docs/auth.md §4` 의 같은 문장).
+
+## 빌드
+
+`runlot deploy` 가 `runlot.json` 의 `"framework": "next"` 를 보고 `buildNext` 를
+부른다. 그 함수가 하는 일:
+
+1. `next build` — 사용자의 `package.json` scripts 가 아니라 그 프로젝트의 next
+   바이너리를 직접, standalone 으로.
+2. OpenNext 의 빌드 함수를 **직접** 부른다 (CLI 도 wrangler 도 거치지 않는다).
+   설정은 `.runlot-next/open-next.config.ts` 에 우리가 쓴다 — 프로젝트 루트에
+   `open-next.config.ts` 가 있으면 그쪽이 이긴다.
+3. `.open-next/runlot-entry.js` 를 세운다. `worker.js` 의 기본 export 를 `wrap`
+   으로 감싸고 나머지 export 는 그대로 통과시킨다.
+
+오버라이드 셋 (`docs/nextjs.md §2` 의 표):
+
+| 자리 | 우리 값 | 없을 때 |
+|---|---|---|
+| incrementalCache | `env.storage`, 키 `__next/cache/<buildId>/<key>.<type>` | 정적 자산 캐시(읽기 전용) + 한 줄 |
+| tagCache | `env.db`, 표 `runlot_next.tags(tag, path, revalidated_at)` | no-op + 한 줄 |
+| queue | OpenNext 의 `memory-queue` (`WORKER_SELF_REFERENCE` 를 쓴다) | — |
+| enableCacheInterception | `true` | — |
+
+## wrangler 는 의존이 아니다
+
+`@opennextjs/cloudflare` 의 `peerDependencies` 에 `wrangler` 가 있지만, 런타임에
+그것을 import 하는 것은 `dist/cli/commands/*` 뿐이다. 우리가 부르는
+`dist/cli/build/build.js` 는 타입으로만 참조한다. 그래서 이 패키지는 wrangler 를
+`dependencies` 에 두지 않는다 — pnpm 이 peer 를 자동 설치하는 워크스페이스에서는
+스토어에 내려와 있을 수 있지만, 우리 코드 경로는 그것을 부르지 않는다.
+
+## 저장소는 globalThis 의 심볼이다
+
+`Symbol.for("runlot.next.store")`. 모듈 인스턴스가 하나라는 보장이 없어서다:
+OpenNext 의 `worker.js` 는 이미 묶인 번들이라 그 안에 이 패키지의 사본이 있고,
+그 곁에 세우는 `runlot-entry.js` 를 다시 묶으면 사본이 하나 더 생긴다. 모듈
+지역 변수에 두면 wrapper 가 넣은 값을 페이지가 못 본다. OpenNext 자신도 같은
+이유로 `Symbol.for("__cloudflare-context__")` 를 쓴다.
+
+캐시 오버라이드는 그 저장소가 아니라 OpenNext 의 문맥을 읽는다 — 오버라이드는
+미들웨어 번들에도 들어가고, 그 번들은 `node:crypto` 하나만 external 이라
+`node:async_hooks` 를 끌고 오면 빌드가 깨진다.
+
+## 시험
+
+```
+node build.mjs
+```
+
+`env` 프록시(저장소 밖 오류·인자 없는 `user()`·동시 요청 격리)와 캐시 오버라이드
+둘을 가짜 바인딩으로 잰다. 실물 `next build` 는 여기서 돌지 않는다 —
+`docs/nextjs.md §6` 의 `TestLiveNext` 자리다.

package/dist/build.d.ts

@@ -0,0 +1,38 @@
+/** 생성한 OpenNext 설정이 사는 곳. `.open-next` 는 빌드가 매번 지우므로 밖에 둔다. */
+export declare const WORK_DIR = ".runlot-next";
+export declare const ENTRY_NAME = "runlot-entry.js";
+export interface BuildNextOptions {
+    /** Next 프로젝트 루트 (`runlot.json` 이 있는 곳). */
+    dir: string;
+    /** `runlot.json` 의 `compatibilityDate`. OpenNext 는 경고 한 줄에만 쓴다. */
+    compatibilityDate?: string;
+    log?: (line: string) => void;
+}
+export interface BuildNextResult {
+    /** 우리 번들러에게 줄 진입점 (절대 경로). */
+    worker: string;
+    /** 정적 자산 디렉토리 (절대 경로). */
+    assets: string;
+    /** OpenNext 출력 디렉토리 (절대 경로). 번들러의 `absWorkingDir` 이다. */
+    outputDir: string;
+}
+/**
+ * 우리가 세우는 진입점.
+ *
+ * OpenNext 의 `worker.js` 기본 export 를 감싸고 나머지 export(Durable Object
+ * 클래스 등)는 그대로 통과시킨다. `export *` 는 default 를 다시 내보내지 않으므로
+ * 두 줄이 겹치지 않는다.
+ */
+export declare const ENTRY_SOURCE = "// runlot \uC774 \uB9CC\uB4E0 \uD30C\uC77C\uC785\uB2C8\uB2E4. \uACE0\uCCD0\uB3C4 \uB2E4\uC74C \uBC30\uD3EC\uC5D0\uC11C \uB2E4\uC2DC \uC4F0\uC785\uB2C8\uB2E4.\nimport worker from \"./worker.js\";\nimport { wrap } from \"@runlot/next/entry\";\n\nexport * from \"./worker.js\";\nexport default wrap(worker);\n";
+/** 사용자가 자기 것을 두지 않았을 때 우리가 쓰는 OpenNext 설정 (docs/nextjs.md §2 의 표). */
+export declare const OPEN_NEXT_CONFIG_SOURCE = "// runlot \uC774 \uB9CC\uB4E0 \uD30C\uC77C\uC785\uB2C8\uB2E4. \uACE0\uCCD0\uB3C4 \uB2E4\uC74C \uBC30\uD3EC\uC5D0\uC11C \uB2E4\uC2DC \uC4F0\uC785\uB2C8\uB2E4.\n// \uC9C1\uC811 \uB2E4\uB8E8\uB824\uBA74 \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8\uC5D0 open-next.config.ts \uB97C \uB450\uC138\uC694 \u2014 \uC788\uC73C\uBA74 \uADF8\uCABD\uC744 \uC501\uB2C8\uB2E4.\nimport { defineCloudflareConfig } from \"@opennextjs/cloudflare\";\nimport queue from \"@opennextjs/cloudflare/overrides/queue/memory-queue\";\nimport incrementalCache from \"@runlot/next/opennext/incremental-cache\";\nimport tagCache from \"@runlot/next/opennext/tag-cache\";\n\nexport default defineCloudflareConfig({\n  incrementalCache,\n  tagCache,\n  queue,\n  enableCacheInterception: true,\n});\n";
+/** 프로젝트가 자기 OpenNext 설정을 두었으면 그것을, 아니면 우리 것을 만들어 그 경로를 준다. */
+export declare function openNextConfigPath(dir: string, log: (line: string) => void): string;
+/**
+ * `next build` → OpenNext → 우리 진입점.
+ *
+ * `process.cwd()` 를 프로젝트로 옮긴다: OpenNext 의 `normalizeOptions` 가 앱 경로와
+ * 출력 경로를 cwd 에서 만든다. 끝나면 되돌린다.
+ */
+export declare function buildNext(opts: BuildNextOptions): Promise<BuildNextResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAcA,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,uTAMxB,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,6vBAanC,CAAC;AAIF,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAanF;AAUD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2EhF"}

package/dist/build.js

@@ -0,0 +1,130 @@
+// `@runlot/next/build` — `runlot deploy` 가 Next 프로젝트에서 부르는 한 함수
+// (docs/nextjs.md §2).
+//
+// OpenNext 의 **CLI 가 아니라 빌드 함수를 직접** 부른다. CLI 는 yargs 와
+// wrangler 의 `unstable_readConfig` 를 지고 있고, 그 설정에서 실제로 읽는 값은
+// `compatibility_date` 와 `assets.run_worker_first` 둘뿐이다. 우리는 그 둘을
+// `runlot.json` 에서 준다 — `wrangler.toml` 은 생기지 않는다.
+//
+// 이 파일은 node 에서 돈다(워커가 아니다). 그래서 `node:fs` 를 그냥 쓴다.
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+/** 생성한 OpenNext 설정이 사는 곳. `.open-next` 는 빌드가 매번 지우므로 밖에 둔다. */
+export const WORK_DIR = ".runlot-next";
+export const ENTRY_NAME = "runlot-entry.js";
+/**
+ * 우리가 세우는 진입점.
+ *
+ * OpenNext 의 `worker.js` 기본 export 를 감싸고 나머지 export(Durable Object
+ * 클래스 등)는 그대로 통과시킨다. `export *` 는 default 를 다시 내보내지 않으므로
+ * 두 줄이 겹치지 않는다.
+ */
+export const ENTRY_SOURCE = `// runlot 이 만든 파일입니다. 고쳐도 다음 배포에서 다시 쓰입니다.
+import worker from "./worker.js";
+import { wrap } from "@runlot/next/entry";
+
+export * from "./worker.js";
+export default wrap(worker);
+`;
+/** 사용자가 자기 것을 두지 않았을 때 우리가 쓰는 OpenNext 설정 (docs/nextjs.md §2 의 표). */
+export const OPEN_NEXT_CONFIG_SOURCE = `// runlot 이 만든 파일입니다. 고쳐도 다음 배포에서 다시 쓰입니다.
+// 직접 다루려면 프로젝트 루트에 open-next.config.ts 를 두세요 — 있으면 그쪽을 씁니다.
+import { defineCloudflareConfig } from "@opennextjs/cloudflare";
+import queue from "@opennextjs/cloudflare/overrides/queue/memory-queue";
+import incrementalCache from "@runlot/next/opennext/incremental-cache";
+import tagCache from "@runlot/next/opennext/tag-cache";
+
+export default defineCloudflareConfig({
+  incrementalCache,
+  tagCache,
+  queue,
+  enableCacheInterception: true,
+});
+`;
+const USER_CONFIG_NAMES = ["open-next.config.ts", "open-next.config.mjs", "open-next.config.js"];
+/** 프로젝트가 자기 OpenNext 설정을 두었으면 그것을, 아니면 우리 것을 만들어 그 경로를 준다. */
+export function openNextConfigPath(dir, log) {
+    for (const name of USER_CONFIG_NAMES) {
+        const path = join(dir, name);
+        if (existsSync(path)) {
+            log(`${name} 을 찾았습니다 — 그 설정으로 빌드합니다.`);
+            return path;
+        }
+    }
+    const workDir = join(dir, WORK_DIR);
+    mkdirSync(workDir, { recursive: true });
+    const path = join(workDir, "open-next.config.ts");
+    writeFileSync(path, OPEN_NEXT_CONFIG_SOURCE);
+    return path;
+}
+async function load(path) {
+    return (await import(pathToFileURL(path).href));
+}
+/**
+ * `next build` → OpenNext → 우리 진입점.
+ *
+ * `process.cwd()` 를 프로젝트로 옮긴다: OpenNext 의 `normalizeOptions` 가 앱 경로와
+ * 출력 경로를 cwd 에서 만든다. 끝나면 되돌린다.
+ */
+export async function buildNext(opts) {
+    const dir = resolve(opts.dir);
+    const log = opts.log ?? ((line) => console.log(line));
+    const here = createRequire(import.meta.url);
+    let apiIndex;
+    try {
+        apiIndex = here.resolve("@opennextjs/cloudflare");
+    }
+    catch {
+        throw new Error("@opennextjs/cloudflare 를 찾지 못했습니다. @runlot/next 를 다시 설치하세요.");
+    }
+    // 패키지의 exports 는 `dist/api/*` 만 연다. 빌드 함수는 `dist/cli/` 아래라
+    // 지정자로는 못 부르고, 해석된 경로에서 옆으로 간다.
+    const distDir = resolve(dirname(apiIndex), "..");
+    const fromCloudflare = createRequire(apiIndex);
+    const awsIndex = fromCloudflare.resolve("@opennextjs/aws/index.js");
+    const { build: openNextBuild } = await load(join(distDir, "cli", "build", "build.js"));
+    const { ensureCloudflareConfig } = await load(join(distDir, "cli", "build", "utils", "ensure-cf-config.js"));
+    const { compileOpenNextConfig } = await load(fromCloudflare.resolve("@opennextjs/aws/build/compileConfig.js"));
+    const { normalizeOptions } = await load(fromCloudflare.resolve("@opennextjs/aws/build/helper.js"));
+    // Next 자체는 사용자 프로젝트의 것이다. 우리 것을 쓰면 버전이 갈라진다.
+    const fromProject = createRequire(join(dir, "package.json"));
+    let nextBin;
+    try {
+        nextBin = fromProject.resolve("next/dist/bin/next");
+    }
+    catch {
+        throw new Error(`${dir} 에서 next 를 찾지 못했습니다. \`npm i next\` 뒤에 다시 배포하세요.`);
+    }
+    const configPath = openNextConfigPath(dir, log);
+    const previousCwd = process.cwd();
+    process.chdir(dir);
+    try {
+        const { config, buildDir } = await compileOpenNextConfig(configPath, { compileEdge: true });
+        ensureCloudflareConfig(config);
+        // 사용자의 `package.json` scripts 가 아니라 next 바이너리를 직접 부른다.
+        // `npm run build`가 배포·린트·타입검사를 겸하는 프로젝트가 흔한데, 배포가
+        // 그것들을 다시 도는 것은 우리가 약속한 일이 아니다.
+        config.buildCommand = [JSON.stringify(process.execPath), JSON.stringify(nextBin), "build"].join(" ");
+        const options = normalizeOptions(config, dirname(awsIndex), buildDir);
+        log("Next.js 빌드 중…");
+        await openNextBuild(options, config, { sourceDir: dir, skipNextBuild: false, skipWranglerConfigCheck: true, minify: true }, {
+            ...(opts.compatibilityDate !== undefined
+                ? { compatibility_date: opts.compatibilityDate }
+                : {}),
+            assets: { run_worker_first: false },
+        }, false);
+        const outputDir = join(dir, ".open-next");
+        const worker = join(outputDir, ENTRY_NAME);
+        if (!existsSync(join(outputDir, "worker.js"))) {
+            throw new Error(`${outputDir}/worker.js 가 없습니다. OpenNext 빌드가 끝나지 않았습니다.`);
+        }
+        writeFileSync(worker, ENTRY_SOURCE);
+        return { worker, assets: join(outputDir, "assets"), outputDir };
+    }
+    finally {
+        process.chdir(previousCwd);
+    }
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/entry.d.ts

@@ -0,0 +1,13 @@
+import { type RunlotContext, type RunlotEnv } from "./store.js";
+export { als } from "./store.js";
+export type { RunlotBindings, RunlotContext, RunlotEnv, RunlotStore } from "./store.js";
+export interface FetchHandler {
+    fetch(request: Request, env: RunlotEnv, ctx: RunlotContext): Response | Promise<Response>;
+}
+/**
+ * OpenNext 의 워커를 감싼다. `fetch` 밖의 export(Durable Object 클래스 등)는
+ * 이 함수가 아니라 생성된 `runlot-entry.js` 가 그대로 다시 내보낸다 — 감쌀 것이
+ * 요청 경로뿐이라서다.
+ */
+export declare function wrap(handler: FetchHandler): FetchHandler;
+//# sourceMappingURL=entry.d.ts.map

package/dist/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAYA,OAAO,EAAO,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExF,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC3F;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAMxD"}

package/dist/entry.js

@@ -0,0 +1,27 @@
+// 진입 wrapper (docs/nextjs.md §4).
+//
+// 빌드가 `.open-next/runlot-entry.js` 를 내고, 그 파일이 OpenNext 의 `worker.js`
+// 기본 export 를 이것으로 감싼다:
+//
+//   import worker from "./worker.js";
+//   import { wrap } from "@runlot/next/entry";
+//   export default wrap(worker);
+//
+// 하는 일은 하나다 — 요청 하나의 `(request, env, ctx)` 를 저장소에 넣고 그 안에서
+// OpenNext 의 fetch 를 부른다. 그래야 서버 컴포넌트 안의 `env.auth.user()` 가
+// 인자 없이 자기 요청을 찾는다.
+import { als } from "./store.js";
+export { als } from "./store.js";
+/**
+ * OpenNext 의 워커를 감싼다. `fetch` 밖의 export(Durable Object 클래스 등)는
+ * 이 함수가 아니라 생성된 `runlot-entry.js` 가 그대로 다시 내보낸다 — 감쌀 것이
+ * 요청 경로뿐이라서다.
+ */
+export function wrap(handler) {
+    return {
+        fetch(request, env, ctx) {
+            return als.run({ request, env, ctx }, () => handler.fetch(request, env, ctx));
+        },
+    };
+}
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,EAAE;AACF,sEAAsE;AACtE,wBAAwB;AACxB,EAAE;AACF,sCAAsC;AACtC,+CAA+C;AAC/C,iCAAiC;AACjC,EAAE;AACF,2DAA2D;AAC3D,6DAA6D;AAC7D,oBAAoB;AACpB,OAAO,EAAE,GAAG,EAAsC,MAAM,YAAY,CAAC;AAErE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAOjC;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,OAAqB;IACxC,OAAO;QACL,KAAK,CAAC,OAAgB,EAAE,GAAc,EAAE,GAAkB;YACxD,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAChF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { type RunlotEnv } from "./store.js";
+export { als, OUTSIDE_REQUEST } from "./store.js";
+export type { RunlotAuth, RunlotBindings, RunlotContext, RunlotEnv, RunlotStore, } from "./store.js";
+export type { User, SignOutHeaders } from "@runlot/auth";
+export type { Db, DbSession, Storage, StorageObject } from "@runlot/pg";
+/**
+ * 이 요청의 바인딩.
+ *
+ * 이름은 `env` 하나지만 읽는 시점마다 그 요청의 것이다. 요청 밖에서 읽으면
+ * `Error` 를 던진다 (`OUTSIDE_REQUEST`).
+ */
+export declare const env: RunlotEnv;
+/** 이 요청의 `Request`. 헤더·URL 을 직접 봐야 할 때. */
+export declare function request(): Request;
+/**
+ * 응답을 보낸 뒤에도 끝까지 도는 일. 로그 전송·캐시 채우기가 그 자리다.
+ *
+ * `ctx.waitUntil` 이 없는 배치(시험용 가짜 문맥 등)에서는 아무것도 하지 않고
+ * 프로미스를 그대로 돌려준다 — 떠 있는 거절이 프로세스를 죽이지 않게 삼킨다.
+ */
+export declare function waitUntil(promise: Promise<unknown>): void;
+/** 지금 요청 안인가. 라이브러리가 갈래를 나눌 때만 — 앱 코드는 그냥 `env` 를 읽는다. */
+export declare function inRequest(): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAmBxE;;;;;GAKG;AACH,eAAO,MAAM,GAAG,EAAE,SA8BhB,CAAC;AAEH,2CAA2C;AAC3C,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAOzD;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/dist/index.js

@@ -0,0 +1,90 @@
+// `runlot/next` — Next.js 안에서 보는 바인딩 (docs/nextjs.md §4).
+//
+//   import { env } from "runlot/next";
+//   const user = await env.auth.user();          // 요청은 어댑터가 숨긴다
+//   const rows = await env.db.exec("select 1");
+//
+// `env` 는 값이 아니라 Proxy 다. 요청마다 다른 묶음을 모듈 하나의 이름으로
+// 부르는 유일한 길이고, 그래서 **요청 밖에서 읽으면 던진다** — 모듈 최상단과
+// 빌드 시점 정적 렌더가 그 자리다.
+//
+// 패키지 이름: 워크스페이스 안에서는 `@runlot/next`, npm 에서는 `runlot/next`.
+import { als, store } from "./store.js";
+export { als, OUTSIDE_REQUEST } from "./store.js";
+/**
+ * `env.auth` 한 겹. `user()`·`signOut()` 에 인자가 없으면 저장소의 요청을 넣고,
+ * 나머지(`users`·`sessions`·평평한 별칭)는 그대로 넘긴다.
+ */
+function wrapAuth(auth, request) {
+    return new Proxy(auth, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            if (typeof value !== "function")
+                return value;
+            if (prop === "user" || prop === "signOut") {
+                return (given) => value.call(target, given ?? request);
+            }
+            return value.bind(target);
+        },
+    });
+}
+/**
+ * 이 요청의 바인딩.
+ *
+ * 이름은 `env` 하나지만 읽는 시점마다 그 요청의 것이다. 요청 밖에서 읽으면
+ * `Error` 를 던진다 (`OUTSIDE_REQUEST`).
+ */
+export const env = new Proxy({}, {
+    get(_target, prop) {
+        const s = store();
+        if (prop === "auth") {
+            const auth = s.env["auth"];
+            // 바인딩이 없는 프로젝트(`runlot add auth` 전)는 undefined 다. 감싸면
+            // "user 가 없다"는 TypeError 가 우리 프록시 안에서 나므로, 그 자리에서
+            // 무엇이 빠졌는지 말한다.
+            if (auth === undefined || auth === null) {
+                throw new Error("env.auth 바인딩이 없습니다. `runlot add auth` 뒤에 다시 배포하세요.");
+            }
+            return wrapAuth(auth, s.request);
+        }
+        return Reflect.get(s.env, prop);
+    },
+    has(_target, prop) {
+        return Reflect.has(store().env, prop);
+    },
+    ownKeys() {
+        return Reflect.ownKeys(store().env);
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+        const d = Reflect.getOwnPropertyDescriptor(store().env, prop);
+        // 대상은 빈 객체다. `configurable: false` 를 그대로 돌려주면 프록시 불변식
+        // 위반으로 `Object.keys(env)` 가 TypeError 를 낸다.
+        return d === undefined ? undefined : { ...d, configurable: true };
+    },
+    set() {
+        throw new Error("env 는 읽기 전용입니다. 값을 바꾸려면 시크릿이나 바인딩을 고치세요.");
+    },
+});
+/** 이 요청의 `Request`. 헤더·URL 을 직접 봐야 할 때. */
+export function request() {
+    return store().request;
+}
+/**
+ * 응답을 보낸 뒤에도 끝까지 도는 일. 로그 전송·캐시 채우기가 그 자리다.
+ *
+ * `ctx.waitUntil` 이 없는 배치(시험용 가짜 문맥 등)에서는 아무것도 하지 않고
+ * 프로미스를 그대로 돌려준다 — 떠 있는 거절이 프로세스를 죽이지 않게 삼킨다.
+ */
+export function waitUntil(promise) {
+    const { ctx } = store();
+    if (typeof ctx?.waitUntil === "function") {
+        ctx.waitUntil(promise);
+        return;
+    }
+    void promise.catch(() => { });
+}
+/** 지금 요청 안인가. 라이브러리가 갈래를 나눌 때만 — 앱 코드는 그냥 `env` 를 읽는다. */
+export function inRequest() {
+    return als.getStore() !== undefined;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/opennext/context.d.ts

@@ -0,0 +1,7 @@
+/** 이 요청의 env. 어느 저장소에도 없으면 빈 묶음 — 부르는 쪽이 바인딩 없음으로 읽는다. */
+export declare function bindings(): Record<string, unknown>;
+/** OpenNext 가 심는 빌드 id. 배포가 바뀌면 캐시 키가 갈라진다. */
+export declare function buildId(): string;
+/** 배포마다 한 번만 찍는 안내. 요청마다 같은 줄을 쌓지 않는다. */
+export declare function sayOnce(key: string, line: string): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/opennext/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/opennext/context.ts"],"names":[],"mappings":"AAkBA,0DAA0D;AAC1D,wBAAgB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElD;AAED,+CAA+C;AAC/C,wBAAgB,OAAO,IAAI,MAAM,CAKhC;AAID,0CAA0C;AAC1C,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIvD"}

package/dist/opennext/context.js

@@ -0,0 +1,30 @@
+// 캐시 오버라이드가 바인딩을 찾는 자리.
+//
+// 우리 저장소(`../store.js`)가 아니라 OpenNext 자신의 요청 문맥
+// (`Symbol.for("__cloudflare-context__")`)을 읽는다. 이유는 둘이다:
+//
+//   1. 오버라이드는 미들웨어 번들에도 들어간다. 그 번들은 esbuild 의 `browser`
+//      플랫폼으로 묶이고 external 은 `node:crypto` 하나라, `node:async_hooks`
+//      를 끌고 오는 우리 저장소를 import 하면 **빌드가 깨진다** (실측 아님 —
+//      compileOpenNextConfigEdge 의 external 목록에서 읽었다).
+//   2. 캐시 오버라이드가 도는 자리는 언제나 OpenNext 의 요청 문맥 안이다.
+//      그 문맥에는 우리 바인딩이 그대로 들어 있다 — 같은 `env` 다.
+const CF_CONTEXT = Symbol.for("__cloudflare-context__");
+/** 이 요청의 env. 어느 저장소에도 없으면 빈 묶음 — 부르는 쪽이 바인딩 없음으로 읽는다. */
+export function bindings() {
+    return globalThis[CF_CONTEXT]?.env ?? {};
+}
+/** OpenNext 가 심는 빌드 id. 배포가 바뀌면 캐시 키가 갈라진다. */
+export function buildId() {
+    const id = globalThis.process?.env?.["OPEN_NEXT_BUILD_ID"];
+    return typeof id === "string" && id !== "" ? id : "no-build-id";
+}
+const said = new Set();
+/** 배포마다 한 번만 찍는 안내. 요청마다 같은 줄을 쌓지 않는다. */
+export function sayOnce(key, line) {
+    if (said.has(key))
+        return;
+    said.add(key);
+    console.warn(line);
+}
+//# sourceMappingURL=context.js.map

package/dist/opennext/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/opennext/context.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,EAAE;AACF,gDAAgD;AAChD,0DAA0D;AAC1D,EAAE;AACF,wDAAwD;AACxD,kEAAkE;AAClE,sDAAsD;AACtD,uDAAuD;AACvD,kDAAkD;AAClD,8CAA8C;AAE9C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAMxD,0DAA0D;AAC1D,MAAM,UAAU,QAAQ;IACtB,OAAQ,UAAqB,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;AACvD,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,OAAO;IACrB,MAAM,EAAE,GAAa,UAAyE,CAAC,OAAO,EAAE,GAAG,EAAE,CAC3G,oBAAoB,CACrB,CAAC;IACF,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;AAClE,CAAC;AAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/B,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY;IAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC"}

package/dist/opennext/incremental-cache.d.ts

@@ -0,0 +1,13 @@
+import type { CacheEntryType, CacheValue, IncrementalCache, WithLastModified } from "@opennextjs/aws/types/overrides";
+export declare const NAME = "runlot-storage";
+/** `__next/cache/<buildId>/<key>.<type>`. 앞의 `/` 와 겹친 `/` 는 지운다. */
+export declare function cacheKey(key: string, cacheType?: CacheEntryType, id?: string): string;
+declare class RunlotStorageIncrementalCache implements IncrementalCache {
+    name: string;
+    get<CacheType extends CacheEntryType = "cache">(key: string, cacheType?: CacheType): Promise<WithLastModified<CacheValue<CacheType>> | null>;
+    set<CacheType extends CacheEntryType = "cache">(key: string, value: CacheValue<CacheType>, cacheType?: CacheType): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+declare const _default: RunlotStorageIncrementalCache;
+export default _default;
+//# sourceMappingURL=incremental-cache.d.ts.map

package/dist/opennext/incremental-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-cache.d.ts","sourceRoot":"","sources":["../../src/opennext/incremental-cache.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AAGzC,eAAO,MAAM,IAAI,mBAAmB,CAAC;AAMrC,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,cAAwB,EAAE,EAAE,SAAY,GAAG,MAAM,CAEjG;AAOD,cAAM,6BAA8B,YAAW,gBAAgB;IAC7D,IAAI,SAAQ;IAEN,GAAG,CAAC,SAAS,SAAS,cAAc,GAAG,OAAO,EAClD,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC;IAoBpD,GAAG,CAAC,SAAS,SAAS,cAAc,GAAG,OAAO,EAClD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,EAC5B,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,IAAI,CAAC;IAWV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKzC;;AAED,wBAAmD"}

package/dist/opennext/incremental-cache.js

@@ -0,0 +1,63 @@
+// ISR 캐시 — `env.storage` 위 (docs/nextjs.md §2 의 표 첫 줄).
+//
+// OpenNext 의 기본값(정적 자산 캐시)은 **읽기 전용**이라 revalidate 가 안 된다:
+// 빌드 때 구운 페이지는 돌려주지만 `revalidatePath` 뒤의 새 페이지를 어디에도
+// 못 쓴다. 쓰기가 되는 자리는 우리에게 오브젝트 스토리지 하나뿐이다.
+//
+// `env.storage` 가 없으면(= `runlot add storage` 전) 정적 자산 캐시로 떨어지고
+// 한 줄 알린다. 던지지 않는 이유: ISR 없이도 페이지는 떠야 한다.
+import staticAssetsCache from "@opennextjs/cloudflare/overrides/incremental-cache/static-assets-incremental-cache";
+import { bindings, buildId, sayOnce } from "./context.js";
+export const NAME = "runlot-storage";
+const NO_STORAGE = "ISR 캐시를 쓸 곳이 없습니다. `runlot add storage` 뒤에 다시 배포하면 " +
+    "revalidate 가 켜집니다. 그때까지는 빌드 때 구운 페이지만 돌려줍니다.";
+/** `__next/cache/<buildId>/<key>.<type>`. 앞의 `/` 와 겹친 `/` 는 지운다. */
+export function cacheKey(key, cacheType = "cache", id = buildId()) {
+    return `__next/cache/${id}/${key}.${cacheType}`.replace(/\/+/g, "/").replace(/^\//, "");
+}
+function storageOf() {
+    const s = bindings()["storage"];
+    return s === undefined || s === null ? undefined : s;
+}
+class RunlotStorageIncrementalCache {
+    name = NAME;
+    async get(key, cacheType) {
+        const storage = storageOf();
+        if (!storage) {
+            sayOnce("no-storage", NO_STORAGE);
+            return staticAssetsCache.get(key, cacheType);
+        }
+        const object = await storage.get(cacheKey(key, cacheType));
+        if (!object || !object.body)
+            return null;
+        try {
+            const value = (await new Response(object.body).json());
+            // `lastModified` 는 RFC 1123 이다. 못 읽으면 0 이 아니라 "지금 막 썼다"로
+            // 읽어야 한다 — 0 이면 모든 항목이 태그 검사에서 낡은 것이 된다.
+            const at = Date.parse(object.lastModified);
+            return { value, lastModified: Number.isNaN(at) ? Date.now() : at };
+        }
+        catch {
+            // 반쯤 쓰인 항목. 캐시 미스로 읽고 다음 렌더가 덮어쓴다.
+            return null;
+        }
+    }
+    async set(key, value, cacheType) {
+        const storage = storageOf();
+        if (!storage) {
+            sayOnce("no-storage", NO_STORAGE);
+            return;
+        }
+        await storage.put(cacheKey(key, cacheType), JSON.stringify(value), {
+            contentType: "application/json",
+        });
+    }
+    async delete(key) {
+        const storage = storageOf();
+        if (!storage)
+            return;
+        await storage.delete(cacheKey(key));
+    }
+}
+export default new RunlotStorageIncrementalCache();
+//# sourceMappingURL=incremental-cache.js.map

package/dist/opennext/incremental-cache.js.map

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

package/dist/opennext/tag-cache.d.ts

@@ -0,0 +1,22 @@
+import type { OriginalTagCache, OriginalTagCacheWriteInput } from "@opennextjs/aws/types/overrides";
+export declare const NAME = "runlot-db";
+export declare const SCHEMA = "runlot_next";
+export declare const TABLE = "runlot_next.tags";
+/** 시험이 격리를 새로 여는 흉내를 낼 때. */
+export declare function resetBootstrap(): void;
+declare class RunlotDbTagCache implements OriginalTagCache {
+    #private;
+    mode: "original";
+    name: string;
+    getByTag(tag: string): Promise<string[]>;
+    getByPath(path: string): Promise<string[]>;
+    /**
+     * 이 경로의 태그 중 하나라도 `lastModified` 뒤에 무효화됐으면 `-1`.
+     * `-1` 이 어댑터에게 "이 항목은 버려라" 다.
+     */
+    getLastModified(path: string, lastModified?: number): Promise<number>;
+    writeTags(tags: OriginalTagCacheWriteInput[]): Promise<void>;
+}
+declare const _default: RunlotDbTagCache;
+export default _default;
+//# sourceMappingURL=tag-cache.d.ts.map

package/dist/opennext/tag-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-cache.d.ts","sourceRoot":"","sources":["../../src/opennext/tag-cache.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAGpG,eAAO,MAAM,IAAI,cAAc,CAAC;AAChC,eAAO,MAAM,MAAM,gBAAgB,CAAC;AACpC,eAAO,MAAM,KAAK,qBAAqB,CAAC;AAqCxC,6BAA6B;AAC7B,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAgBD,cAAM,gBAAiB,YAAW,gBAAgB;;IAChD,IAAI,EAAG,UAAU,CAAU;IAC3B,IAAI,SAAQ;IA4BN,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOxC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOhD;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWrE,SAAS,CAAC,IAAI,EAAE,0BAA0B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBnE;;AAED,wBAAsC"}

package/dist/opennext/tag-cache.js

@@ -0,0 +1,123 @@
+import { bindings, buildId, sayOnce } from "./context.js";
+export const NAME = "runlot-db";
+export const SCHEMA = "runlot_next";
+export const TABLE = "runlot_next.tags";
+const NO_DB = "태그 캐시를 쓸 곳이 없습니다. `runlot add pg` 뒤에 다시 배포하면 " +
+    "revalidateTag 가 켜집니다. 그때까지는 태그 무효화가 아무 일도 하지 않습니다.";
+const BOOTSTRAP = [
+    `create schema if not exists ${SCHEMA}`,
+    `create table if not exists ${TABLE} (
+     tag text not null,
+     path text not null,
+     revalidated_at bigint not null default 0,
+     primary key (tag, path)
+   )`,
+    `create index if not exists tags_path_idx on ${TABLE} (path)`,
+];
+function dbOf() {
+    const db = bindings()["db"];
+    return db === undefined || db === null ? undefined : db;
+}
+/** 격리 하나에 한 번. 실패하면 다음 호출이 다시 시도한다 — 캐시된 거절을 남기지 않는다. */
+let ready;
+async function ensure(db) {
+    ready ??= (async () => {
+        // 문장을 하나씩 보낸다. `exec` 는 확장 질의라 세미콜론으로 이은 여러 문장을
+        // 한 번에 받지 않는다.
+        for (const sql of BOOTSTRAP)
+            await db.exec(sql);
+    })().catch((err) => {
+        ready = undefined;
+        throw err;
+    });
+    return ready;
+}
+/** 시험이 격리를 새로 여는 흉내를 낼 때. */
+export function resetBootstrap() {
+    ready = undefined;
+}
+function rowsOf(value) {
+    return Array.isArray(value) ? value : [];
+}
+/** bigint 는 드라이버에 따라 문자열로 온다. 숫자로 읽는다. */
+function num(value) {
+    if (typeof value === "number")
+        return value;
+    if (typeof value === "string") {
+        const n = Number(value);
+        return Number.isFinite(n) ? n : 0;
+    }
+    return 0;
+}
+class RunlotDbTagCache {
+    mode = "original";
+    name = NAME;
+    /** 배포마다 태그 이름을 갈라 둔다. 옛 배포의 무효화가 새 배포를 흔들지 않는다. */
+    #key(tag) {
+        return `${buildId()}/${tag}`.replace(/\/+/g, "/");
+    }
+    #bare(key) {
+        const prefix = `${buildId()}/`;
+        return key.startsWith(prefix) ? key.slice(prefix.length) : key;
+    }
+    async #db() {
+        const db = dbOf();
+        if (!db) {
+            sayOnce("no-db", NO_DB);
+            return undefined;
+        }
+        try {
+            await ensure(db);
+        }
+        catch {
+            // 권한이 없거나 DB 가 아직 안 붙었다. 태그 없음으로 이어간다.
+            sayOnce("no-db-bootstrap", NO_DB);
+            return undefined;
+        }
+        return db;
+    }
+    async getByTag(tag) {
+        const db = await this.#db();
+        if (!db)
+            return [];
+        const rows = rowsOf(await db.exec(`select path from ${TABLE} where tag = $1`, [this.#key(tag)]));
+        return rows.map((r) => String(r["path"]));
+    }
+    async getByPath(path) {
+        const db = await this.#db();
+        if (!db)
+            return [];
+        const rows = rowsOf(await db.exec(`select tag from ${TABLE} where path = $1`, [path]));
+        return rows.map((r) => this.#bare(String(r["tag"])));
+    }
+    /**
+     * 이 경로의 태그 중 하나라도 `lastModified` 뒤에 무효화됐으면 `-1`.
+     * `-1` 이 어댑터에게 "이 항목은 버려라" 다.
+     */
+    async getLastModified(path, lastModified) {
+        const at = lastModified ?? Date.now();
+        const db = await this.#db();
+        if (!db)
+            return at;
+        const rows = rowsOf(await db.exec(`select max(revalidated_at) as at from ${TABLE} where path = $1`, [path]));
+        const revalidated = rows.length === 0 ? 0 : num(rows[0]?.["at"]);
+        return revalidated > at ? -1 : at;
+    }
+    async writeTags(tags) {
+        if (tags.length === 0)
+            return;
+        const db = await this.#db();
+        if (!db)
+            return;
+        const now = Date.now();
+        const params = [];
+        const values = tags.map((t, i) => {
+            params.push(this.#key(t.tag), t.path, t.revalidatedAt ?? now);
+            return `($${i * 3 + 1}, $${i * 3 + 2}, $${i * 3 + 3})`;
+        });
+        await db.exec(`insert into ${TABLE} (tag, path, revalidated_at) values ${values.join(", ")} ` +
+            `on conflict (tag, path) do update set revalidated_at = excluded.revalidated_at`, params);
+    }
+}
+export default new RunlotDbTagCache();
+//# sourceMappingURL=tag-cache.js.map

package/dist/opennext/tag-cache.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,40 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { AuthBinding, SignOutHeaders, User } from "@runlot/auth";
+import type { Db, Storage } from "@runlot/pg";
+/**
+ * `env.auth`. `@runlot/auth` 의 `AuthBinding` 과 같되 `user()`·`signOut()` 의 요청
+ * 인자가 선택이다 — 없으면 어댑터가 저장소의 요청을 넣는다 (docs/nextjs.md §4).
+ */
+export interface RunlotAuth extends Omit<AuthBinding, "user" | "signOut"> {
+    user(request?: Request): Promise<User | null>;
+    signOut(request?: Request): Promise<SignOutHeaders>;
+}
+/** 워커가 받는 바인딩 묶음. 이름 없는 나머지는 시크릿·환경 변수(문자열)다. */
+export interface RunlotBindings {
+    db: Db;
+    auth: RunlotAuth;
+    storage: Storage;
+}
+export type RunlotEnv = RunlotBindings & Record<string, string>;
+/** workerd 의 `ExecutionContext` 중 우리가 쓰는 것. */
+export interface RunlotContext {
+    waitUntil(promise: Promise<unknown>): void;
+    passThroughOnException?(): void;
+}
+export interface RunlotStore {
+    request: Request;
+    env: RunlotEnv;
+    ctx: RunlotContext;
+}
+/** 요청 문맥 저장소. 진입 wrapper 가 넣고 `env`·`request()`·`waitUntil()` 이 읽는다. */
+export declare const als: AsyncLocalStorage<RunlotStore>;
+/**
+ * 저장소 밖에서 부를 때의 문장.
+ *
+ * 조용히 `null`·`undefined` 를 주지 않는 이유는 docs/auth.md §4 와 같다 — "안 됨"
+ * 이 빈 값이 되면 모든 페이지가 로그아웃 상태로 보이고, 그것을 알아채는 자리는
+ * 배포 뒤뿐이다.
+ */
+export declare const OUTSIDE_REQUEST: string;
+export declare function store(): RunlotStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACvE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACrD;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhE,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3C,sBAAsB,CAAC,IAAI,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,SAAS,CAAC;IACf,GAAG,EAAE,aAAa,CAAC;CACpB;AAUD,wEAAwE;AACxE,eAAO,MAAM,GAAG,EAAE,iBAAiB,CAAC,WAAW,CAAuD,CAAC;AAEvG;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,QAIkC,CAAC;AAE/D,wBAAgB,KAAK,IAAI,WAAW,CAInC"}

package/dist/store.js

@@ -0,0 +1,36 @@
+// 요청 문맥 저장소 (docs/nextjs.md §4).
+//
+// `runlot/next` 의 `env` 는 워커 진입점이 받은 `(request, env, ctx)` 를 읽는다.
+// Next 의 서버 컴포넌트에는 그 셋을 인자로 내려보낼 자리가 없으므로 —
+// `page.tsx` 는 `props` 만 받는다 — 진입 wrapper 가 AsyncLocalStorage 에 넣고
+// 이 모듈이 그것을 꺼낸다.
+//
+// **저장소는 `globalThis` 의 심볼 하나다.** 모듈 인스턴스가 하나라는 보장이
+// 없어서다: OpenNext 가 낸 `worker.js` 는 이미 묶인 번들이라 그 안에 이 패키지의
+// 사본이 들어 있고, 그 곁에 세우는 `runlot-entry.js` 를 우리가 다시 묶으면 사본이
+// 하나 더 생긴다. 모듈 지역 변수에 저장소를 두면 wrapper 가 넣은 값을 페이지가
+// 못 본다 — 조용히 "요청이 없습니다" 가 된다. OpenNext 자신도 같은 이유로
+// `Symbol.for("__cloudflare-context__")` 를 쓴다.
+import { AsyncLocalStorage } from "node:async_hooks";
+const STORE = Symbol.for("runlot.next.store");
+const g = globalThis;
+/** 요청 문맥 저장소. 진입 wrapper 가 넣고 `env`·`request()`·`waitUntil()` 이 읽는다. */
+export const als = (g[STORE] ??= new AsyncLocalStorage());
+/**
+ * 저장소 밖에서 부를 때의 문장.
+ *
+ * 조용히 `null`·`undefined` 를 주지 않는 이유는 docs/auth.md §4 와 같다 — "안 됨"
+ * 이 빈 값이 되면 모든 페이지가 로그아웃 상태로 보이고, 그것을 알아채는 자리는
+ * 배포 뒤뿐이다.
+ */
+export const OUTSIDE_REQUEST = "runlot/next 의 `env` 는 요청 안에서만 읽을 수 있습니다. " +
+    "모듈 최상단이나 빌드 시점 정적 렌더에는 요청이 없습니다 — " +
+    "서버 컴포넌트·라우트 핸들러·미들웨어 안으로 옮기세요. " +
+    "`next dev` 는 아직 runlot 바인딩을 모릅니다; `runlot deploy` 로 확인합니다.";
+export function store() {
+    const s = als.getStore();
+    if (!s)
+        throw new Error(OUTSIDE_REQUEST);
+    return s;
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,4CAA4C;AAC5C,mEAAmE;AACnE,iBAAiB;AACjB,EAAE;AACF,oDAAoD;AACpD,0DAA0D;AAC1D,yDAAyD;AACzD,mDAAmD;AACnD,kDAAkD;AAClD,+CAA+C;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAkCrD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAM9C,MAAM,CAAC,GAAG,UAAoB,CAAC;AAE/B,wEAAwE;AACxE,MAAM,CAAC,MAAM,GAAG,GAAmC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,iBAAiB,EAAe,CAAC,CAAC;AAEvG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,2CAA2C;IAC3C,oCAAoC;IACpC,iCAAiC;IACjC,4DAA4D,CAAC;AAE/D,MAAM,UAAU,KAAK;IACnB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IACzB,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@runlot/next",
+  "version": "0.1.0-rc.11",
+  "description": "Next.js 어댑터 — env 프록시와 OpenNext 빌드 (docs/nextjs.md)",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/runlot/runlot",
+    "directory": "web/packages/next"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./entry": {
+      "types": "./dist/entry.d.ts",
+      "default": "./dist/entry.js"
+    },
+    "./build": {
+      "types": "./dist/build.d.ts",
+      "default": "./dist/build.js"
+    },
+    "./opennext/incremental-cache": {
+      "types": "./dist/opennext/incremental-cache.d.ts",
+      "default": "./dist/opennext/incremental-cache.js"
+    },
+    "./opennext/tag-cache": {
+      "types": "./dist/opennext/tag-cache.d.ts",
+      "default": "./dist/opennext/tag-cache.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@opennextjs/aws": "4.1.4",
+    "@opennextjs/cloudflare": "^1.20.6",
+    "@runlot/auth": "0.1.0-rc.11",
+    "@runlot/pg": "0.1.0-rc.11"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "esbuild": "^0.24.2",
+    "typescript": "^5.7.2",
+    "@runlot/config": "0.1.0-rc.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "node build.mjs",
+    "typecheck": "tsc --noEmit"
+  }
+}