@notionx/create-notionx-app 1.0.0

package/dist/registry/install.js

@@ -0,0 +1,217 @@
+// packages/create-notionx-app/src/registry/install.ts
+//
+// Core `notionx add <id>` logic. v1 of this module wires the
+// minimal subset needed to make `notionx add docs` a working
+// command; richer behaviour (Notion schema sync, codemods,
+// file-content merge for `user`-owned files) lives in PR 4.
+//
+// The contract:
+//   1. Read `.notionx/registry.json`.
+//   2. Reject if the item is already installed, or if a
+//      `requires` dependency is missing.
+//   3. Render the new item's files (using the project templates
+//      directory, which the CLI looks up next to its own package).
+//   4. Re-render `lib/content/models.ts` so the new source shows
+//      up in `contentSources` / `managedContentSources`.
+//   5. Write the new `registry.json` and a human-readable followup
+//      list (Notion env vars to set, D1 migrations to apply).
+//
+// Everything is pure async + returns a summary object; the CLI
+// layer is responsible for printing the summary.
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { getOfficialItem, listOfficialItems } from "./registry-items.js";
+import { loadRegistry } from "./load-registry.js";
+import { renderContentSourceFiles } from "./render-content-source-files.js";
+import { writeRegistryManifest } from "./registry-store.js";
+import { readProjectMeta, rerenderModelsFile, } from "./project-meta.js";
+export class InstallError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "InstallError";
+    }
+}
+/**
+ * Install a registry item into the project at `projectDir`.
+ *
+ * Throws `InstallError` on the common failure modes so the CLI
+ * can print a stable, human-readable error.
+ */
+export async function installItem(input) {
+    const { projectDir, templatesDir, itemId } = input;
+    const item = getOfficialItem(itemId);
+    if (!item) {
+        throw new InstallError(`Unknown registry item "${itemId}". Run \`notionx add --list\` to see available items.`, "unknown-item");
+    }
+    const finalItem = input.params
+        ? { ...item, params: { ...item.params, ...input.params } }
+        : item;
+    // Load the current registry.
+    const loaded = await loadRegistry(projectDir);
+    const manifest = loaded.manifest;
+    // Idempotency: reject re-installing the same id. `notionx update`
+    // handles version upgrades; `notionx add` is for new items.
+    if (manifest.installed.some((i) => i.id === finalItem.id)) {
+        throw new InstallError(`"${finalItem.id}" is already installed in this project. ` +
+            `Use \`notionx update ${finalItem.id}\` to upgrade it, ` +
+            `or \`notionx remove ${finalItem.id}\` to uninstall.`, "already-installed");
+    }
+    // Dependency check: every `requires` entry must be satisfied by
+    // something already installed. We use simple semver-equality
+    // (only ">=X" today); PR 4 will add a `semver.satisfies` check
+    // for ranges.
+    for (const req of finalItem.requires ?? []) {
+        const dep = manifest.installed.find((i) => i.id === req.id);
+        if (!dep) {
+            throw new InstallError(`"${finalItem.id}" requires "${req.id}" to be installed first. ` +
+                `Run \`notionx add ${req.id}\` and try again.`, "missing-requirement");
+        }
+    }
+    // Compute the new installed record. We snapshot the rendered
+    // file paths so `notionx remove --purge` can delete the exact
+    // set that was written (no heuristic path matching).
+    const installed = {
+        id: finalItem.id,
+        kind: finalItem.kind,
+        version: finalItem.version,
+        source: finalItem.source,
+        params: finalItem.params,
+        installedAt: new Date().toISOString(),
+    };
+    // The list of "currently installed" used for token rendering
+    // is the existing list **plus** the new item (in the same
+    // alphabetical order so generated diffs are stable).
+    const installedForRender = [
+        ...manifest.installed,
+        installed,
+    ].sort((a, b) => a.id.localeCompare(b.id));
+    const project = await readProjectMeta(projectDir, manifest);
+    // For feature-module items, the install flips the manifest flag
+    // to `true` so `rerenderModelsFile` includes the corresponding
+    // internal singleton source. For content-source items, the
+    // flags are unchanged.
+    const internalSourcesForRender = computeInternalSourcesForInstall(manifest, finalItem);
+    // Render the new files (currently: just the list page).
+    const rendered = await renderContentSourceFiles({
+        projectDir,
+        templatesDir,
+        item: finalItem,
+        installed: installedForRender,
+        project,
+        internalSources: internalSourcesForRender,
+    });
+    // Re-render `lib/content/models.ts` so the new source is
+    // registered in `contentSources` / `managedContentSources`.
+    const modelsResult = await rerenderModelsFile({
+        projectDir,
+        templatesDir,
+        project,
+        installed: installedForRender,
+        internalSources: internalSourcesForRender,
+    });
+    // Snapshot the rendered file paths on the InstalledItem so
+    // `notionx remove --purge` can delete the exact set later.
+    installed.files = rendered.map((f) => f.projectRelativePath);
+    const followup = buildFollowupTasks(finalItem, manifest);
+    if (input.dryRun) {
+        return {
+            item: finalItem,
+            installed,
+            files: rendered.map((f) => ({
+                projectRelativePath: f.projectRelativePath,
+                ownership: f.ownership,
+                existed: f.existed,
+            })),
+            rerenderedModels: modelsResult.wrote,
+            wroteManifest: false,
+            followup,
+        };
+    }
+    // Write the rendered files.
+    for (const file of rendered) {
+        await mkdir(path.dirname(file.absolutePath), { recursive: true });
+        await writeFile(file.absolutePath, file.content, "utf8");
+    }
+    // Update the manifest: add the new InstalledItem, the
+    // `user`/`bridge` files to `managedFiles`, and flip the
+    // feature flag (if this is a feature-module item).
+    const nextManifest = {
+        ...manifest,
+        installed: installedForRender,
+        managedFiles: mergeManagedFilesForInstall(manifest, finalItem),
+        ...applyFeatureFlag(manifest, finalItem, true),
+    };
+    await writeRegistryManifest(projectDir, nextManifest);
+    return {
+        item: finalItem,
+        installed,
+        files: rendered.map((f) => ({
+            projectRelativePath: f.projectRelativePath,
+            ownership: f.ownership,
+            existed: f.existed,
+        })),
+        rerenderedModels: modelsResult.wrote,
+        wroteManifest: true,
+        followup,
+    };
+}
+// ---- internals ----
+function buildFollowupTasks(item, _manifest) {
+    const out = [];
+    for (const env of item.capabilities.envVars ?? []) {
+        out.push(`Set \`${env}\` in .dev.vars (see Notion data source for the id).`);
+    }
+    for (const ds of item.capabilities.notionDataSources ?? []) {
+        out.push(`Create the matching Notion data source and set \`${ds}\` in .dev.vars.`);
+    }
+    if ((item.capabilities.d1Tables ?? []).length > 0) {
+        out.push(`Run \`wrangler d1 migrations apply <DB_NAME> --remote\` to create the new tables.`);
+    }
+    return out;
+}
+function mergeManagedFilesForInstall(manifest, item) {
+    const user = new Set(manifest.managedFiles.user);
+    const bridge = new Set(manifest.managedFiles.bridge);
+    const platform = new Set(manifest.managedFiles.platform);
+    for (const file of item.files) {
+        if (file.ownership === "user")
+            user.add(file.path);
+        else if (file.ownership === "bridge")
+            bridge.add(file.path);
+        else
+            platform.add(file.path);
+    }
+    return {
+        platform: [...platform].sort(),
+        bridge: [...bridge].sort(),
+        user: [...user].sort(),
+    };
+}
+/**
+ * Compute the `internalSources` flags to pass to the renderers
+ * during install. For feature-module items, the flag being
+ * installed flips to `true` so the generated `models.ts` includes
+ * the corresponding internal singleton source. For other kinds,
+ * the flags are unchanged from the manifest.
+ */
+function computeInternalSourcesForInstall(manifest, item) {
+    const siteSettings = item.featureFlag === "enableSiteSettings"
+        ? true
+        : manifest.enableSiteSettings;
+    const blocks = item.featureFlag === "enableBlocks" ? true : manifest.enableBlocks;
+    return { siteSettings, blocks };
+}
+/**
+ * Return a partial manifest patch that flips the feature flag
+ * controlled by `item` to `value`. Returns `{}` for items without
+ * a `featureFlag` (content-source / platform-extension).
+ */
+function applyFeatureFlag(_manifest, item, value) {
+    if (!item.featureFlag)
+        return {};
+    return { [item.featureFlag]: value };
+}
+export { listOfficialItems };
+//# sourceMappingURL=install.js.map

package/dist/registry/install.js.map

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

package/dist/registry/install.test.js

@@ -0,0 +1,168 @@
+// packages/create-notionx-app/src/registry/install.test.ts
+import { promises as fs } from "node:fs";
+import { existsSync } from "node:fs";
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { resolveTemplatesDir } from "../render.js";
+import { InstallError, installItem } from "./install.js";
+import { REGISTRY_SCHEMA_V2 } from "./registry-types.js";
+async function writePackageJson(projectDir, name, deps = {}) {
+    await writeFile(path.join(projectDir, "package.json"), JSON.stringify({
+        name,
+        version: "0.0.0",
+        private: true,
+        dependencies: { "@notionx/core": "^2.0.0", ...deps },
+    }), "utf8");
+}
+async function writeV2Manifest(projectDir, installed = [
+    {
+        id: "blog",
+        kind: "content-source",
+        version: 1,
+        source: { kind: "official", name: "@notionx/official" },
+        params: { contentSourceId: "blog" },
+        installedAt: "2026-06-10T00:00:00.000Z",
+    },
+], managedFiles = {}) {
+    await mkdir(path.join(projectDir, ".notionx"), { recursive: true });
+    await writeFile(path.join(projectDir, ".notionx/registry.json"), JSON.stringify({
+        $schema: REGISTRY_SCHEMA_V2,
+        projectKind: "notionx",
+        scaffoldVersion: "2.0.0",
+        notionxCore: "^2.0.0",
+        compat: { mode: "v2-native" },
+        registries: {},
+        installed,
+        managedFiles: {
+            platform: managedFiles.platform ?? ["package.json"],
+            bridge: managedFiles.bridge ?? ["lib/notionx/content-registry.ts"],
+            user: managedFiles.user ?? ["lib/content/models.ts", "app/blog/page.tsx"],
+        },
+    }), "utf8");
+}
+describe("installItem", () => {
+    let dir;
+    let templatesDir;
+    beforeEach(async () => {
+        dir = await mkdtemp(path.join(os.tmpdir(), "notionx-install-"));
+        await mkdir(path.join(dir, ".notionx"), { recursive: true });
+        templatesDir = await resolveTemplatesDir();
+    });
+    afterEach(async () => {
+        await rm(dir, { recursive: true, force: true });
+    });
+    it("installs docs into a v2 project, writing all content source files and updating the manifest", async () => {
+        await writePackageJson(dir, "demo");
+        await writeV2Manifest(dir);
+        const summary = await installItem({
+            projectDir: dir,
+            templatesDir,
+            itemId: "docs",
+        });
+        expect(summary.item.id).toBe("docs");
+        expect(summary.wroteManifest).toBe(true);
+        expect(summary.rerenderedModels).toBe(true);
+        expect(summary.files.map((f) => f.projectRelativePath)).toEqual([
+            "app/docs/page.tsx",
+            "app/docs/[slug]/page.tsx",
+            "app/api/docs/route.ts",
+            "app/api/docs/[slug]/route.ts",
+        ]);
+        // The list page landed on disk
+        const listPath = path.join(dir, "app/docs/page.tsx");
+        expect(existsSync(listPath)).toBe(true);
+        const content = await fs.readFile(listPath, "utf8");
+        // The list page references the new content source
+        expect(content).toContain('"docs"');
+        expect(content).toContain("/docs");
+        // The detail page also landed
+        expect(existsSync(path.join(dir, "app/docs/[slug]/page.tsx"))).toBe(true);
+        // API routes landed
+        expect(existsSync(path.join(dir, "app/api/docs/route.ts"))).toBe(true);
+        expect(existsSync(path.join(dir, "app/api/docs/[slug]/route.ts"))).toBe(true);
+        // The manifest was updated
+        const manifestRaw = await fs.readFile(path.join(dir, ".notionx/registry.json"), "utf8");
+        const manifest = JSON.parse(manifestRaw);
+        expect(manifest.installed.map((i) => i.id).sort()).toEqual([
+            "blog",
+            "docs",
+        ]);
+        // InstalledItem stores the rendered file list
+        const docsRecord = manifest.installed.find((i) => i.id === "docs");
+        expect(docsRecord?.files).toEqual([
+            "app/docs/page.tsx",
+            "app/docs/[slug]/page.tsx",
+            "app/api/docs/route.ts",
+            "app/api/docs/[slug]/route.ts",
+        ]);
+    });
+    it("rejects re-installing an item that is already present", async () => {
+        await writePackageJson(dir, "demo");
+        await writeV2Manifest(dir);
+        await expect(installItem({ projectDir: dir, templatesDir, itemId: "blog" })).rejects.toThrow(/already installed/);
+    });
+    it("returns a followup list mentioning the NOTION_DOCS_DATA_SOURCE_ID env var", async () => {
+        await writePackageJson(dir, "demo");
+        await writeV2Manifest(dir);
+        const summary = await installItem({
+            projectDir: dir,
+            templatesDir,
+            itemId: "docs",
+        });
+        const joined = summary.followup.join("\n");
+        expect(joined).toContain("NOTION_DOCS_DATA_SOURCE_ID");
+    });
+    it("rejects unknown item ids with the unknown-item code", async () => {
+        await writePackageJson(dir, "demo");
+        await writeV2Manifest(dir);
+        try {
+            await installItem({
+                projectDir: dir,
+                templatesDir,
+                itemId: "nonexistent",
+            });
+            throw new Error("expected installItem to throw");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(InstallError);
+            expect(err.code).toBe("unknown-item");
+        }
+    });
+    it("dry-run does not write any file or update the manifest", async () => {
+        await writePackageJson(dir, "demo");
+        await writeV2Manifest(dir);
+        const summary = await installItem({
+            projectDir: dir,
+            templatesDir,
+            itemId: "docs",
+            dryRun: true,
+        });
+        expect(summary.wroteManifest).toBe(false);
+        expect(summary.files.map((f) => f.projectRelativePath)).toEqual([
+            "app/docs/page.tsx",
+            "app/docs/[slug]/page.tsx",
+            "app/api/docs/route.ts",
+            "app/api/docs/[slug]/route.ts",
+        ]);
+        expect(existsSync(path.join(dir, "app/docs/page.tsx"))).toBe(false);
+        // Manifest unchanged
+        const manifestRaw = await fs.readFile(path.join(dir, ".notionx/registry.json"), "utf8");
+        const manifest = JSON.parse(manifestRaw);
+        expect(manifest.installed).toHaveLength(1);
+        expect(manifest.installed[0]?.id).toBe("blog");
+    });
+    it("preserves existing content sources when re-rendering models.ts", async () => {
+        await writePackageJson(dir, "demo");
+        await writeV2Manifest(dir);
+        await installItem({ projectDir: dir, templatesDir, itemId: "docs" });
+        const modelsPath = path.join(dir, "lib/content/models.ts");
+        const models = await fs.readFile(modelsPath, "utf8");
+        expect(models).toContain("blogSource");
+        expect(models).toContain("docsSource");
+        expect(models).toContain("siteSettingsSource");
+        expect(models).toContain("blocksSource");
+    });
+});
+//# sourceMappingURL=install.test.js.map

package/dist/registry/install.test.js.map

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

package/dist/registry/load-registry.js

@@ -0,0 +1,24 @@
+// packages/create-notionx-app/src/registry/load-registry.ts
+//
+// The single entry point for reading a project's registry state.
+//
+// Behaviour:
+//   - If `.notionx/registry.json` exists, read it directly.
+//   - Else, throw — the directory is not a notionx project.
+import { readRegistryManifest, REGISTRY_FILE } from "./registry-store.js";
+/**
+ * Load a project's registry. Returns the `RegistryManifest` plus a
+ * `managedFiles` snapshot (typed view of the manifest's `managedFiles`
+ * block).
+ *
+ * Throws when no `registry.json` exists in the directory.
+ */
+export async function loadRegistry(projectDir) {
+    const manifest = await readRegistryManifest(projectDir);
+    if (manifest === null) {
+        throw new Error(`No Notionx project state found in ${projectDir}. ` +
+            `Expected ${REGISTRY_FILE}.`);
+    }
+    return { manifest, managedFiles: manifest.managedFiles };
+}
+//# sourceMappingURL=load-registry.js.map

package/dist/registry/load-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-registry.js","sourceRoot":"","sources":["../../src/registry/load-registry.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,iEAAiE;AACjE,EAAE;AACF,aAAa;AACb,4DAA4D;AAC5D,4DAA4D;AAE5D,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG1E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB;IACnD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,qCAAqC,UAAU,IAAI;YACjD,YAAY,aAAa,GAAG,CAC/B,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC;AAC3D,CAAC"}

package/dist/registry/load-registry.test.js

@@ -0,0 +1,59 @@
+// packages/create-notionx-app/src/registry/load-registry.test.ts
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { loadRegistry } from "./load-registry.js";
+import { REGISTRY_FILE } from "./registry-store.js";
+import { REGISTRY_SCHEMA_V2 } from "./registry-types.js";
+describe("loadRegistry", () => {
+    let dir;
+    beforeEach(async () => {
+        dir = await mkdtemp(path.join(os.tmpdir(), "notionx-load-"));
+        await mkdir(path.join(dir, ".notionx"), { recursive: true });
+    });
+    afterEach(async () => {
+        await rm(dir, { recursive: true, force: true });
+    });
+    it("throws when no registry.json exists", async () => {
+        await expect(loadRegistry(dir)).rejects.toThrow(/registry\.json/);
+    });
+    it("reads a v2 manifest directly", async () => {
+        await writeFile(path.join(dir, REGISTRY_FILE), JSON.stringify({
+            $schema: REGISTRY_SCHEMA_V2,
+            projectKind: "notionx",
+            projectName: "demo",
+            scaffoldVersion: "1.0.0",
+            notionxCore: "^2.0.0",
+            defaultLocale: "en",
+            supportedLocales: ["en"],
+            enableSiteSettings: true,
+            enableBlocks: true,
+            enableAuth: true,
+            enableAdmin: true,
+            enablePages: true,
+            enableSearch: true,
+            contentSource: {
+                id: "blog",
+                title: "Blog",
+                fields: [{ key: "title", notionName: "Title" }],
+            },
+            compat: { mode: "v2-native" },
+            registries: {},
+            installed: [],
+            managedFiles: { platform: [], bridge: [], user: [] },
+        }), "utf8");
+        const result = await loadRegistry(dir);
+        expect(result.manifest.$schema).toBe(REGISTRY_SCHEMA_V2);
+        expect(result.manifest.projectName).toBe("demo");
+        expect(result.managedFiles.platform).toEqual([]);
+    });
+    it("throws on schema mismatch", async () => {
+        await writeFile(path.join(dir, REGISTRY_FILE), JSON.stringify({
+            $schema: "https://example.com/wrong.json",
+            projectKind: "notionx",
+        }), "utf8");
+        await expect(loadRegistry(dir)).rejects.toThrow(/unknown schema/);
+    });
+});
+//# sourceMappingURL=load-registry.test.js.map

package/dist/registry/load-registry.test.js.map

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