@notionx/create-notionx-app 1.0.0

package/dist/registry/migrations-store.js

@@ -0,0 +1,125 @@
+// packages/create-notionx-app/src/registry/migrations-store.ts
+//
+// Read / write `.notionx/migrations/`.
+//
+// Layout:
+//
+//   .notionx/
+//   ├── registry.json
+//   └── migrations/
+//       ├── _meta.json
+//       ├── 0001_init.sql
+//       ├── 0002_add_blog_status.sql
+//       └── 0003_rename_eyebrow.notion-diff.json
+//
+// `_meta.json` is the **index**. The .sql / .notion-diff.json /
+// .codemod.json files are the **payloads**. Both are append-only:
+// once written, a file is never edited. To "undo" a migration, run
+// another one that does the opposite.
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+export const MIGRATIONS_DIR = ".notionx/migrations";
+export const MIGRATIONS_META = "_meta.json";
+export const MIGRATIONS_SCHEMA_V1 = "https://notionx.dev/schemas/migrations-meta.v1.json";
+/**
+ * Empty `migrations/` directory shape. Used as the default when
+ * the directory doesn't exist yet.
+ */
+export function emptyMeta(nextSequence = 1) {
+    return {
+        $schema: MIGRATIONS_SCHEMA_V1,
+        nextSequence,
+        history: [],
+    };
+}
+/**
+ * Read `_meta.json` from `<projectDir>/.notionx/migrations/`. Returns
+ * `null` when the directory doesn't exist (caller should treat as
+ * empty migrations history).
+ */
+export async function readMigrationsMeta(projectDir) {
+    const filePath = path.join(projectDir, MIGRATIONS_DIR, MIGRATIONS_META);
+    try {
+        const raw = await readFile(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        if (isENOENT(err))
+            return null;
+        throw err;
+    }
+}
+/**
+ * Write `_meta.json` atomically (write to `.tmp`, then rename).
+ */
+export async function writeMigrationsMeta(projectDir, meta) {
+    const dir = path.join(projectDir, MIGRATIONS_DIR);
+    const target = path.join(dir, MIGRATIONS_META);
+    const tmp = `${target}.tmp`;
+    await mkdir(dir, { recursive: true });
+    await writeFile(tmp, `${JSON.stringify(meta, null, 2)}\n`, "utf8");
+    await rename(tmp, target);
+}
+/**
+ * Append a single migration entry. Returns the new meta + the
+ * sequence number assigned to this entry.
+ *
+ * Sequence number is the **previous** `nextSequence` value, zero-
+ * padded to 4 digits. The meta's `nextSequence` is then
+ * incremented by 1.
+ */
+export async function appendMigration(projectDir, entry) {
+    const meta = (await readMigrationsMeta(projectDir)) ?? emptyMeta();
+    const seq = String(meta.nextSequence).padStart(4, "0");
+    const next = {
+        ...meta,
+        nextSequence: meta.nextSequence + 1,
+        history: [
+            ...meta.history,
+            {
+                ...entry,
+                sequence: seq,
+                generatedAt: new Date().toISOString(),
+            },
+        ],
+    };
+    await writeMigrationsMeta(projectDir, next);
+    return { meta: next, sequence: seq };
+}
+/**
+ * Mark an existing migration as applied. Idempotent.
+ */
+export async function markMigrationApplied(projectDir, sequence) {
+    const meta = await readMigrationsMeta(projectDir);
+    if (!meta) {
+        throw new Error(`Cannot mark migration ${sequence} applied: .notionx/migrations/_meta.json does not exist.`);
+    }
+    const next = {
+        ...meta,
+        history: meta.history.map((entry) => entry.sequence === sequence && !entry.applied
+            ? { ...entry, applied: true, appliedAt: new Date().toISOString() }
+            : entry),
+    };
+    await writeMigrationsMeta(projectDir, next);
+    return next;
+}
+/**
+ * Write a migration payload file (the .sql or .notion-diff.json
+ * next to `_meta.json`). Atomic. The filename is supplied by the
+ * caller; we don't try to derive it from the entry.
+ */
+export async function writeMigrationPayload(projectDir, filename, content) {
+    const dir = path.join(projectDir, MIGRATIONS_DIR);
+    const target = path.join(dir, filename);
+    const tmp = `${target}.tmp`;
+    await mkdir(dir, { recursive: true });
+    await writeFile(tmp, content, "utf8");
+    await rename(tmp, target);
+}
+function isENOENT(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+//# sourceMappingURL=migrations-store.js.map

package/dist/registry/migrations-store.js.map

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

package/dist/registry/migrations-store.test.js

@@ -0,0 +1,163 @@
+// packages/create-notionx-app/src/registry/migrations-store.test.ts
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { MIGRATIONS_DIR, appendMigration, emptyMeta, markMigrationApplied, readMigrationsMeta, writeMigrationPayload, writeMigrationsMeta, } from "./migrations-store.js";
+describe("migrations-store", () => {
+    let dir;
+    beforeEach(async () => {
+        dir = await mkdtemp(path.join(os.tmpdir(), "notionx-mig-"));
+    });
+    afterEach(async () => {
+        await rm(dir, { recursive: true, force: true });
+    });
+    it("exposes the canonical .notionx/migrations/ path", () => {
+        expect(MIGRATIONS_DIR).toBe(".notionx/migrations");
+    });
+    it("returns null when _meta.json does not exist", async () => {
+        const meta = await readMigrationsMeta(dir);
+        expect(meta).toBeNull();
+    });
+    it("emptyMeta() starts with nextSequence=1 and empty history", () => {
+        const m = emptyMeta();
+        expect(m.nextSequence).toBe(1);
+        expect(m.history).toEqual([]);
+    });
+    it("writeMigrationsMeta + read round-trips", async () => {
+        const m = emptyMeta();
+        await writeMigrationsMeta(dir, m);
+        const read = await readMigrationsMeta(dir);
+        expect(read).toEqual(m);
+    });
+    it("appendMigration assigns 4-digit sequence numbers and bumps nextSequence", async () => {
+        await writeMigrationsMeta(dir, emptyMeta());
+        const { sequence, meta } = await appendMigration(dir, {
+            itemId: "blog",
+            itemKind: "content-source",
+            file: { kind: "d1-sql", filename: "0001_init.sql" },
+            applied: false,
+            label: "init",
+        });
+        expect(sequence).toBe("0001");
+        expect(meta.nextSequence).toBe(2);
+        expect(meta.history).toHaveLength(1);
+        expect(meta.history[0]?.sequence).toBe("0001");
+        expect(meta.history[0]?.itemId).toBe("blog");
+    });
+    it("appendMigration is monotonic across many calls", async () => {
+        await writeMigrationsMeta(dir, emptyMeta());
+        for (let i = 1; i <= 5; i++) {
+            const { sequence } = await appendMigration(dir, {
+                itemId: "blog",
+                itemKind: "content-source",
+                file: { kind: "d1-sql", filename: `000${i}_x.sql` },
+                applied: false,
+            });
+            expect(sequence).toBe(`000${i}`);
+        }
+        const meta = await readMigrationsMeta(dir);
+        expect(meta?.nextSequence).toBe(6);
+        expect(meta?.history.map((e) => e.sequence)).toEqual([
+            "0001",
+            "0002",
+            "0003",
+            "0004",
+            "0005",
+        ]);
+    });
+    it("markMigrationApplied is idempotent (only flips once)", async () => {
+        await writeMigrationsMeta(dir, emptyMeta());
+        await appendMigration(dir, {
+            itemId: "blog",
+            itemKind: "content-source",
+            file: { kind: "d1-sql", filename: "0001_x.sql" },
+            applied: false,
+        });
+        const first = await markMigrationApplied(dir, "0001");
+        expect(first.history[0]?.applied).toBe(true);
+        expect(first.history[0]?.appliedAt).toBeDefined();
+        // Wait a tick so the second call's `appliedAt` would differ if
+        // it actually re-wrote the timestamp. We assert the timestamp
+        // didn't change, proving idempotency.
+        const originalTimestamp = first.history[0]?.appliedAt;
+        await new Promise((resolve) => setTimeout(resolve, 5));
+        const second = await markMigrationApplied(dir, "0001");
+        expect(second.history[0]?.appliedAt).toBe(originalTimestamp);
+    });
+    it("markMigrationApplied throws when the directory is empty", async () => {
+        await expect(markMigrationApplied(dir, "0001")).rejects.toThrow(/does not exist/);
+    });
+    it("writeMigrationPayload writes the payload file alongside _meta.json", async () => {
+        await writeMigrationsMeta(dir, emptyMeta());
+        await writeMigrationPayload(dir, "0001_init.sql", "CREATE TABLE x (id INTEGER);");
+        const raw = await readFile(path.join(dir, MIGRATIONS_DIR, "0001_init.sql"), "utf8");
+        expect(raw).toContain("CREATE TABLE x");
+    });
+    it("migrations are append-only: re-writing the same sequence is not allowed by the store", async () => {
+        // We don't expose a "rewrite" API; ensure the public surface
+        // doesn't let us accidentally edit a previous migration. The
+        // only mutators are `writeMigrationsMeta` (whole-file) and
+        // `appendMigration` (always uses nextSequence). A test that
+        // calls writeMigrationsMeta with a "rewriting" intent has to
+        // opt out by writing the whole meta — and even then,
+        // `appendMigration` would never re-use a sequence.
+        await writeMigrationsMeta(dir, emptyMeta());
+        await appendMigration(dir, {
+            itemId: "blog",
+            itemKind: "content-source",
+            file: { kind: "d1-sql", filename: "0001_x.sql" },
+            applied: false,
+        });
+        const before = await readMigrationsMeta(dir);
+        const firstEntryBefore = before?.history[0];
+        // Second append must use sequence 0002, not 0001.
+        await appendMigration(dir, {
+            itemId: "blog",
+            itemKind: "content-source",
+            file: { kind: "d1-sql", filename: "0002_y.sql" },
+            applied: false,
+        });
+        const after = await readMigrationsMeta(dir);
+        const firstEntryAfter = after?.history[0];
+        // The first entry is byte-identical to its pre-second-append
+        // form (proving append-only for the first migration's record).
+        expect(firstEntryAfter).toEqual(firstEntryBefore);
+        expect(after?.history[1]?.sequence).toBe("0002");
+    });
+});
+describe("migrations-store: dir layout", () => {
+    let dir;
+    beforeEach(async () => {
+        dir = await mkdtemp(path.join(os.tmpdir(), "notionx-mig-dir-"));
+    });
+    afterEach(async () => {
+        await rm(dir, { recursive: true, force: true });
+    });
+    it("creates .notionx/migrations/ if missing", async () => {
+        await writeMigrationsMeta(dir, emptyMeta());
+        await writeMigrationPayload(dir, "0001_x.sql", "SELECT 1;");
+        const sub = path.join(dir, ".notionx/migrations");
+        const metaRaw = await readFile(path.join(sub, "_meta.json"), "utf8");
+        const payload = await readFile(path.join(sub, "0001_x.sql"), "utf8");
+        expect(metaRaw).toContain("nextSequence");
+        expect(payload).toBe("SELECT 1;");
+    });
+    it("rejects writing payload without prior dir creation when mkdir fails — actually the store creates it", async () => {
+        // Sanity: writeMigrationsMeta creates the dir, so a payload
+        // write that arrives first still works (the store calls
+        // mkdir({ recursive: true })).
+        await writeMigrationPayload(dir, "0001_x.sql", "SELECT 2;");
+        const raw = await readFile(path.join(dir, MIGRATIONS_DIR, "0001_x.sql"), "utf8");
+        expect(raw).toBe("SELECT 2;");
+    });
+    it("supports arbitrary filenames (the store does not enforce .sql extension)", async () => {
+        // The registry may ship a `.notion-diff.json` or `.codemod.json`
+        // payload. The store just writes whatever filename the caller
+        // gives.
+        await writeMigrationPayload(dir, "0001_add_author.notion-diff.json", JSON.stringify({ kind: "notion-field-add", property: "Author" }));
+        const raw = await readFile(path.join(dir, MIGRATIONS_DIR, "0001_add_author.notion-diff.json"), "utf8");
+        expect(raw).toContain("notion-field-add");
+    });
+});
+//# sourceMappingURL=migrations-store.test.js.map

package/dist/registry/migrations-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations-store.test.js","sourceRoot":"","sources":["../../src/registry/migrations-store.test.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EAAS,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAa,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EACL,cAAc,EACd,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,GAAW,CAAC;IAChB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;QACtB,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;QACtB,MAAM,mBAAmB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE;YACnD,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE;gBAC9C,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,gBAAgB;gBAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;gBACnD,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YACH,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YACnD,MAAM;YACN,MAAM;YACN,MAAM;YACN,MAAM;YACN,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,MAAM,eAAe,CAAC,GAAG,EAAE;YACzB,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE;YAChD,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAElD,+DAA+D;QAC/D,8DAA8D;QAC9D,sCAAsC;QACtC,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;QACtD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC7D,gBAAgB,CACjB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,MAAM,qBAAqB,CAAC,GAAG,EAAE,eAAe,EAAE,8BAA8B,CAAC,CAAC;QAClF,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,eAAe,CAAC,EAC/C,MAAM,CACP,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,KAAK,IAAI,EAAE;QACpG,6DAA6D;QAC7D,6DAA6D;QAC7D,2DAA2D;QAC3D,4DAA4D;QAC5D,6DAA6D;QAC7D,qDAAqD;QACrD,mDAAmD;QACnD,MAAM,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,MAAM,eAAe,CAAC,GAAG,EAAE;YACzB,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE;YAChD,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,gBAAgB,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAE5C,kDAAkD;QAClD,MAAM,eAAe,CAAC,GAAG,EAAE;YACzB,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE;YAChD,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,eAAe,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAE1C,6DAA6D;QAC7D,+DAA+D;QAC/D,MAAM,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,IAAI,GAAW,CAAC;IAChB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,MAAM,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAE5D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QACrE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qGAAqG,EAAE,KAAK,IAAI,EAAE;QACnH,4DAA4D;QAC5D,wDAAwD;QACxD,+BAA+B;QAC/B,MAAM,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,YAAY,CAAC,EAC5C,MAAM,CACP,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,iEAAiE;QACjE,8DAA8D;QAC9D,SAAS;QACT,MAAM,qBAAqB,CACzB,GAAG,EACH,kCAAkC,EAClC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CACjE,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,IAAI,CAAC,IAAI,CACP,GAAG,EACH,cAAc,EACd,kCAAkC,CACnC,EACD,MAAM,CACP,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/registry/migrations-types.js

@@ -0,0 +1,25 @@
+// packages/create-notionx-app/src/registry/migrations-types.ts
+//
+// v2 Migration Protocol — the on-disk format for
+// `.notionx/migrations/`.
+//
+// Modeled on Prisma's `migrations/` directory: every change to a
+// project's schema (D1 or Notion) is an immutable, append-only
+// file with a monotonically-increasing sequence number. Once a
+// migration has been applied to a real environment, **it is
+// never edited**. To reverse a change, the user runs
+// `notionx update` to apply a *new* migration that undoes it.
+//
+// Three kinds of migration live alongside each other:
+//   - `.sql`       — D1 schema change (run by `wrangler d1 migrations apply`)
+//   - `.notion.json`— Notion schema change (run by hand or via the
+//                    Notion API in CI; PR 4 ships a *plan*, not the
+//                    run)
+//   - `.codemod.json`— TypeScript code transformation (run by
+//                    `notionx update` against the user's code)
+//
+// A single migration usually has exactly one file. We bundle
+// them in `_meta.json` so the planner can apply them in order
+// and the user can see what changed.
+export {};
+//# sourceMappingURL=migrations-types.js.map

package/dist/registry/migrations-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations-types.js","sourceRoot":"","sources":["../../src/registry/migrations-types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,iDAAiD;AACjD,0BAA0B;AAC1B,EAAE;AACF,iEAAiE;AACjE,+DAA+D;AAC/D,+DAA+D;AAC/D,4DAA4D;AAC5D,qDAAqD;AACrD,8DAA8D;AAC9D,EAAE;AACF,sDAAsD;AACtD,8EAA8E;AAC9E,mEAAmE;AACnE,oEAAoE;AACpE,0BAA0B;AAC1B,8DAA8D;AAC9D,+DAA+D;AAC/D,EAAE;AACF,6DAA6D;AAC7D,8DAA8D;AAC9D,qCAAqC"}

package/dist/registry/project-meta.js

@@ -0,0 +1,84 @@
+// packages/create-notionx-app/src/registry/project-meta.ts
+//
+// Shared helpers used by install / uninstall / update:
+//   - `readProjectMeta` reads `package.json` for the project name
+//     and assembles the `MultiSourceProject` shape the token
+//     builders need.
+//   - `rerenderModelsFile` re-renders `lib/content/models.ts` from
+//     its template using the current installed-item list.
+//
+// Both helpers lived as private duplicates in install.ts and
+// update.ts (readProjectMeta) and in install.ts and uninstall.ts
+// (rerenderModelsFile). They are collected here so there is one
+// authoritative implementation.
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { buildMultiSourceTokenMap } from "./render-multi-source.js";
+/**
+ * Read `package.json` for the project name and assemble the
+ * `MultiSourceProject` shape. Falls back to the directory basename
+ * when `package.json` is missing or has no `name` field.
+ */
+export async function readProjectMeta(projectDir, manifest) {
+    const pkgPath = path.join(projectDir, "package.json");
+    let projectName = path.basename(projectDir);
+    try {
+        const raw = await readFile(pkgPath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.name === "string" && parsed.name.length > 0) {
+            projectName = parsed.name;
+        }
+    }
+    catch {
+        // No package.json (or unreadable). Fall back to dir basename.
+    }
+    return {
+        projectName,
+        targetDir: projectDir,
+        defaultLocale: "en", // TODO: read from a future v2 i18n block
+        supportedLocales: ["en"],
+        notionxSource: manifest.notionxCore,
+        adminEmail: "admin@example.com", // placeholder; not used by add/remove/update
+        adminPassword: "", // placeholder; not used by add/remove/update
+        scaffoldVersion: manifest.scaffoldVersion,
+    };
+}
+/**
+ * Re-render `lib/content/models.ts` from its template so the
+ * `contentSources` / `managedContentSources` arrays stay in sync
+ * with the installed-item list and the current internal-source
+ * flags (`enableSiteSettings` / `enableBlocks`).
+ *
+ * Returns `{ wrote: false }` when the template file is missing
+ * (e.g. a project that doesn't ship the models template).
+ */
+export async function rerenderModelsFile(input) {
+    const target = path.join(input.projectDir, "lib/content/models.ts");
+    const tplPath = path.join(input.templatesDir, "lib/content/models.ts.tmpl");
+    let tpl;
+    try {
+        tpl = await readFile(tplPath, "utf8");
+    }
+    catch {
+        return { wrote: false };
+    }
+    const tokens = buildMultiSourceTokenMap({
+        project: input.project,
+        installed: input.installed,
+        internalSources: input.internalSources,
+    });
+    const flat = {
+        contentSourceDeclarations: tokens.contentSourceDeclarations,
+        contentSourceSourcesVarNames: tokens.contentSourceSourcesVarNames,
+        internalSourceDeclarations: tokens.internalSourceDeclarations,
+        internalSourceVarNames: tokens.internalSourceVarNames,
+    };
+    const rendered = tpl.replace(/\{\{\s*([a-zA-Z][a-zA-Z0-9_]*)\s*\}\}/g, (full, key) => {
+        const v = flat[key];
+        return typeof v === "string" ? v : full;
+    });
+    await mkdir(path.dirname(target), { recursive: true });
+    await writeFile(target, rendered, "utf8");
+    return { wrote: true };
+}
+//# sourceMappingURL=project-meta.js.map

package/dist/registry/project-meta.js.map

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