@notionx/create-notionx-app 1.0.0

package/dist/locale-add/list.js

@@ -0,0 +1,44 @@
+// packages/create-notionx-app/src/locale-add/list.ts
+//
+// Read-only helper that turns the scaffold metadata into a printable
+// `notionx locale list` view. The view is plain data so it can be
+// rendered as a table, a JSON dump, or a Markdown summary.
+const BUILT_IN_MODELS = [
+    "blog-translations",
+    "page-translations",
+    "block-translations",
+    "site-settings-translations",
+];
+function envVarForModel(modelId) {
+    switch (modelId) {
+        case "blog-translations":
+            return "NOTION_BLOG_TRANSLATIONS_DATA_SOURCE_ID";
+        case "page-translations":
+            return "NOTION_PAGES_TRANSLATIONS_DATA_SOURCE_ID";
+        case "block-translations":
+            return "NOTION_BLOCKS_TRANSLATIONS_DATA_SOURCE_ID";
+        case "site-settings-translations":
+            return "NOTION_SITE_SETTINGS_TRANSLATIONS_DATA_SOURCE_ID";
+        default: {
+            const upper = modelId.replace(/-/g, "_").toUpperCase();
+            return `NOTION_${upper}_DATA_SOURCE_ID`;
+        }
+    }
+}
+export function buildLocaleListView(input) {
+    const sources = input.metadata.translationSources ?? {};
+    const rows = input.metadata.supportedLocales.map((locale) => ({
+        locale,
+        isDefault: locale === input.metadata.defaultLocale,
+        translationSources: BUILT_IN_MODELS.map((modelId) => {
+            const ref = sources[modelId];
+            return {
+                modelId,
+                envVar: ref?.envVar ?? envVarForModel(modelId),
+                configured: Boolean(ref?.dataSourceId),
+            };
+        }),
+    }));
+    return { rows };
+}
+//# sourceMappingURL=list.js.map

package/dist/locale-add/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/locale-add/list.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,qEAAqE;AACrE,kEAAkE;AAClE,2DAA2D;AAI3D,MAAM,eAAe,GAAG;IACtB,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,4BAA4B;CACpB,CAAC;AAgBX,SAAS,cAAc,CAAC,OAAe;IACrC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,mBAAmB;YACtB,OAAO,yCAAyC,CAAC;QACnD,KAAK,mBAAmB;YACtB,OAAO,0CAA0C,CAAC;QACpD,KAAK,oBAAoB;YACvB,OAAO,2CAA2C,CAAC;QACrD,KAAK,4BAA4B;YAC/B,OAAO,kDAAkD,CAAC;QAC5D,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YACvD,OAAO,UAAU,KAAK,iBAAiB,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAEnC;IACC,MAAM,OAAO,GACX,KAAK,CAAC,QAAQ,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAoB,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAC/D,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACX,MAAM;QACN,SAAS,EAAE,MAAM,KAAK,KAAK,CAAC,QAAQ,CAAC,aAAa;QAClD,kBAAkB,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YAClD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO;gBACL,OAAO;gBACP,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC;gBAC9C,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC;aACvC,CAAC;QACJ,CAAC,CAAC;KACH,CAAC,CACH,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/dist/locale-add/list.test.js

@@ -0,0 +1,45 @@
+// packages/create-notionx-app/src/locale-add/list.test.ts
+import { describe, expect, it } from "vitest";
+import { buildLocaleListView } from "../../src/locale-add/list.js";
+const metadata = {
+    projectKind: "notionx",
+    projectName: "demo",
+    scaffoldVersion: "1.0.0",
+    defaultLocale: "en",
+    supportedLocales: ["en", "zh-CN"],
+    notionxSource: "1.0.0",
+    enableSiteSettings: true,
+    contentSource: { id: "blog", title: "Blog", fields: [] },
+};
+describe("buildLocaleListView", () => {
+    it("marks the default locale", () => {
+        const view = buildLocaleListView({ metadata });
+        expect(view.rows.find((r) => r.locale === "en")?.isDefault).toBe(true);
+        expect(view.rows.find((r) => r.locale === "zh-CN")?.isDefault).toBe(false);
+    });
+    it("reports whether translation sources are configured", () => {
+        const view = buildLocaleListView({
+            metadata: {
+                ...metadata,
+                translationSources: {
+                    "blog-translations": {
+                        dataSourceId: "ds-1",
+                        envVar: "NOTION_BLOG_TRANSLATIONS_DATA_SOURCE_ID",
+                    },
+                },
+            },
+        });
+        const zhRow = view.rows.find((r) => r.locale === "zh-CN");
+        const blogTs = zhRow?.translationSources.find((ts) => ts.modelId === "blog-translations");
+        expect(blogTs?.configured).toBe(true);
+        // Other built-in models stay unconfigured.
+        const pagesTs = zhRow?.translationSources.find((ts) => ts.modelId === "page-translations");
+        expect(pagesTs?.configured).toBe(false);
+    });
+    it("falls back to a synthesized env-var name for unconfigured sources", () => {
+        const view = buildLocaleListView({ metadata });
+        const blockTs = view.rows[1]?.translationSources.find((ts) => ts.modelId === "block-translations");
+        expect(blockTs?.envVar).toBe("NOTION_BLOCKS_TRANSLATIONS_DATA_SOURCE_ID");
+    });
+});
+//# sourceMappingURL=list.test.js.map

package/dist/locale-add/list.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.test.js","sourceRoot":"","sources":["../../src/locale-add/list.test.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGnE,MAAM,QAAQ,GAAqB;IACjC,WAAW,EAAE,SAAS;IACtB,WAAW,EAAE,MAAM;IACnB,eAAe,EAAE,OAAO;IACxB,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;IACjC,aAAa,EAAE,OAAO;IACtB,kBAAkB,EAAE,IAAI;IACxB,aAAa,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;CACzD,CAAC;AAEF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CACjE,KAAK,CACN,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,IAAI,GAAG,mBAAmB,CAAC;YAC/B,QAAQ,EAAE;gBACR,GAAG,QAAQ;gBACX,kBAAkB,EAAE;oBAClB,mBAAmB,EAAE;wBACnB,YAAY,EAAE,MAAM;wBACpB,MAAM,EAAE,yCAAyC;qBAClD;iBACF;aACF;SACF,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAC3C,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,KAAK,mBAAmB,CAC3C,CAAC;QACF,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,2CAA2C;QAC3C,MAAM,OAAO,GAAG,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAC5C,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,KAAK,mBAAmB,CAC3C,CAAC;QACF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,IAAI,CACnD,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,KAAK,oBAAoB,CAC5C,CAAC;QACF,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,CAC1B,2CAA2C,CAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/locale-add/plan.js

@@ -0,0 +1,128 @@
+// packages/create-notionx-app/src/locale-add/plan.ts
+//
+// Pure planning step for `notionx locale add`. Given the project
+// context, a locale, and CLI flags, return the list of changes the
+// runner should apply. The planner is pure: it never touches disk,
+// never shells out, and never throws on missing optional inputs.
+//
+// The output is consumed by the runner (see `apply.ts`) which is
+// the only thing that mutates state. This makes the planner
+// trivially testable and lets the CLI render a dry-run summary
+// without side effects.
+const BUILT_IN_NOTION_SOURCES = [
+    "blog-translations",
+    "page-translations",
+    "block-translations",
+    "site-settings-translations",
+];
+export function buildLocaleAddPlan(input) {
+    const changes = [];
+    const { projectDir, metadata, locale } = input;
+    const i18nPath = "lib/i18n/config.ts";
+    const siteConfigPath = "lib/site/config.ts";
+    const metadataPath = ".notionx/scaffold.json";
+    // 1. metadata: append locale to supportedLocales.
+    const nextMetadata = {
+        ...metadata,
+        supportedLocales: [...metadata.supportedLocales, locale],
+    };
+    changes.push({
+        kind: "metadata",
+        label: "metadata:supportedLocales",
+        description: `Append "${locale}" to .notionx/scaffold.json supportedLocales.`,
+        risk: metadata.supportedLocales.includes(locale) ? "conflict" : "safe",
+        async apply() {
+            const fs = await import("node:fs/promises");
+            const full = `${projectDir}/${metadataPath}`;
+            await fs.writeFile(full, JSON.stringify(nextMetadata, null, 2) + "\n", "utf8");
+        },
+    });
+    // 2. lib/i18n/config.ts — append the locale to supportedLocalesJson.
+    changes.push({
+        kind: "file",
+        label: `file:${i18nPath}`,
+        description: `Add "${locale}" to lib/i18n/config.ts supportedLocales.`,
+        risk: "safe",
+        filePath: i18nPath,
+        async apply() {
+            const fs = await import("node:fs/promises");
+            const full = `${projectDir}/${i18nPath}`;
+            let content;
+            try {
+                content = await fs.readFile(full, "utf8");
+            }
+            catch {
+                return;
+            }
+            const updated = content.replace(/supportedLocales:\s*\[[^\]]*\]/, (match) => match.replace(/\]$/, `, "${locale}"]`));
+            await fs.writeFile(full, updated, "utf8");
+        },
+    });
+    // 3. lib/site/config.ts — append the locale to the locales list.
+    changes.push({
+        kind: "file",
+        label: `file:${siteConfigPath}`,
+        description: `Add "${locale}" to lib/site/config.ts locales.`,
+        risk: "safe",
+        filePath: siteConfigPath,
+        async apply() {
+            const fs = await import("node:fs/promises");
+            const full = `${projectDir}/${siteConfigPath}`;
+            let content;
+            try {
+                content = await fs.readFile(full, "utf8");
+            }
+            catch {
+                return;
+            }
+            const updated = content.replace(/locales:\s*\[[^\]]*\]/, (match) => match.replace(/\]$/, `, "${locale}"]`));
+            await fs.writeFile(full, updated, "utf8");
+        },
+    });
+    // 4. (optional) Notion translation data sources — declared but the
+    // actual create/reuse happens in the translation-sources runner.
+    if (input.withNotion) {
+        for (const sourceName of BUILT_IN_NOTION_SOURCES) {
+            changes.push({
+                kind: "notion",
+                label: `notion:${sourceName}`,
+                description: `Ensure Notion data source "${sourceName}" exists (idempotent: create or reuse).`,
+                risk: "safe",
+                modelId: sourceName,
+                async apply() {
+                    return null;
+                },
+            });
+        }
+    }
+    // 5. (optional) Cloudflare secrets for the new translation source ids.
+    if (input.withNotion && input.translationSourceIds) {
+        for (const [sourceName, dataSourceId] of Object.entries(input.translationSourceIds)) {
+            const envVar = sourceNameToEnvVar(sourceName);
+            if (!envVar)
+                continue;
+            changes.push({
+                kind: "cloudflare",
+                label: `cloudflare-secret:${envVar}`,
+                description: `Set worker secret ${envVar} to ${dataSourceId}.`,
+                risk: "safe",
+                envVar,
+                async apply() {
+                    const { setWorkerSecret } = await import("../provision/cloudflare.js");
+                    await setWorkerSecret(envVar, dataSourceId, projectDir, [dataSourceId]);
+                },
+            });
+        }
+    }
+    return { locale, changes };
+}
+function sourceNameToEnvVar(sourceName) {
+    const map = {
+        "blog-translations": "NOTION_BLOG_TRANSLATIONS_DATA_SOURCE_ID",
+        "page-translations": "NOTION_PAGES_TRANSLATIONS_DATA_SOURCE_ID",
+        "block-translations": "NOTION_BLOCKS_TRANSLATIONS_DATA_SOURCE_ID",
+        "site-settings-translations": "NOTION_SITE_SETTINGS_TRANSLATIONS_DATA_SOURCE_ID",
+    };
+    return map[sourceName] ?? null;
+}
+//# sourceMappingURL=plan.js.map

package/dist/locale-add/plan.js.map

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

package/dist/locale-add/validate.js

@@ -0,0 +1,46 @@
+// packages/create-notionx-app/src/locale-add/validate.ts
+//
+// Conservative validator for `notionx locale add <locale>`. The
+// command only ever adds, never removes. The validator refuses:
+//
+//   - empty / whitespace-only input
+//   - malformed locales (anything that is not a BCP-47-ish tag of
+//     letters, digits, and a single hyphen)
+//   - duplicates against the existing `supportedLocales` list
+//   - the default locale (adding the default is a no-op)
+//
+// A well-formed, non-duplicate locale is returned with a normalized
+// casing (`zh-cn` → `zh-CN` style, where the region part is upper
+// case and the language part is lower case).
+const LOCALE_RE = /^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$/;
+function normalize(locale) {
+    const trimmed = locale.trim();
+    if (!trimmed)
+        return null;
+    if (!LOCALE_RE.test(trimmed))
+        return null;
+    const [lang, region] = trimmed.split("-");
+    return region
+        ? `${lang.toLowerCase()}-${region.toUpperCase()}`
+        : lang.toLowerCase();
+}
+export function validateLocaleAdd(input) {
+    const normalized = normalize(input.locale);
+    if (!normalized) {
+        return { ok: false, reason: `Not a valid locale tag: "${input.locale}"` };
+    }
+    if (normalized === input.defaultLocale) {
+        return {
+            ok: false,
+            reason: `"${normalized}" is already the default locale`,
+        };
+    }
+    if (input.supportedLocales.includes(normalized)) {
+        return {
+            ok: false,
+            reason: `"${normalized}" is already in supportedLocales`,
+        };
+    }
+    return { ok: true, locale: normalized };
+}
+//# sourceMappingURL=validate.js.map

package/dist/locale-add/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/locale-add/validate.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,gEAAgE;AAChE,gEAAgE;AAChE,EAAE;AACF,oCAAoC;AACpC,kEAAkE;AAClE,4CAA4C;AAC5C,8DAA8D;AAC9D,yDAAyD;AACzD,EAAE;AACF,oEAAoE;AACpE,kEAAkE;AAClE,6CAA6C;AAE7C,MAAM,SAAS,GAAG,kCAAkC,CAAC;AAYrD,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,MAAM;QACX,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE;QACjD,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAA6B;IAE7B,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,UAAU,KAAK,KAAK,CAAC,aAAa,EAAE,CAAC;QACvC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,IAAI,UAAU,iCAAiC;SACxD,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAChD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,IAAI,UAAU,kCAAkC;SACzD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC"}

package/dist/metadata.js

@@ -0,0 +1,41 @@
+export const SCAFFOLD_METADATA_FILE = ".notionx/scaffold.json";
+export function buildScaffoldMetadata(answers, scaffoldVersion) {
+    return {
+        projectKind: "notionx",
+        projectName: answers.projectName,
+        scaffoldVersion,
+        defaultLocale: answers.defaultLocale,
+        supportedLocales: [...answers.supportedLocales],
+        notionxSource: answers.notionxSource,
+        enableSiteSettings: answers.enableSiteSettings,
+        contentSource: {
+            id: answers.contentSource.id,
+            title: answers.contentSource.title,
+            fields: answers.contentSource.fields.map((field) => ({
+                key: field.key,
+                notionName: field.notionName,
+            })),
+        },
+        translationSources: {},
+    };
+}
+export function parseScaffoldMetadata(raw) {
+    const parsed = JSON.parse(raw);
+    if (parsed.projectKind !== "notionx" ||
+        typeof parsed.projectName !== "string" ||
+        typeof parsed.scaffoldVersion !== "string" ||
+        typeof parsed.defaultLocale !== "string" ||
+        !Array.isArray(parsed.supportedLocales) ||
+        typeof parsed.notionxSource !== "string" ||
+        !parsed.contentSource ||
+        typeof parsed.contentSource.id !== "string" ||
+        typeof parsed.contentSource.title !== "string" ||
+        !Array.isArray(parsed.contentSource.fields) ||
+        parsed.contentSource.fields.some((field) => !field ||
+            typeof field.key !== "string" ||
+            typeof field.notionName !== "string")) {
+        throw new Error("Invalid Notionx metadata payload");
+    }
+    return parsed;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAuD/D,MAAM,UAAU,qBAAqB,CACnC,OAAgB,EAChB,eAAuB;IAEvB,OAAO;QACL,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,eAAe;QACf,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,gBAAgB,EAAE,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;QAC/C,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,aAAa,EAAE;YACb,EAAE,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE;YAC5B,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK;YAClC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACnD,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;SACJ;QACD,kBAAkB,EAAE,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA8B,CAAC;IAC5D,IACE,MAAM,CAAC,WAAW,KAAK,SAAS;QAChC,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QACtC,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ;QAC1C,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;QACxC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACvC,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;QACxC,CAAC,MAAM,CAAC,aAAa;QACrB,OAAO,MAAM,CAAC,aAAa,CAAC,EAAE,KAAK,QAAQ;QAC3C,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,KAAK,QAAQ;QAC9C,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC;QAC3C,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAC9B,CAAC,KAAK,EAAE,EAAE,CACR,CAAC,KAAK;YACN,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;YAC7B,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CACvC,EACD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,MAA0B,CAAC;AACpC,CAAC"}

package/dist/notion-translation-sources/apply.js

@@ -0,0 +1,61 @@
+// packages/create-notionx-app/src/notion-translation-sources/apply.ts
+//
+// Applies the planned translation data source changes via the `ntn`
+// CLI. This module owns the only place that shells out to Notion for
+// translation sources; everything else flows through the same
+// `LocaleAddChange` runner.
+import { runNtn } from "../provision/shell.js";
+export async function applyNotionTranslationSources(plans) {
+    const result = { resolved: {}, failures: [] };
+    for (const plan of plans) {
+        if (plan.action === "reuse" && plan.existingDataSourceId) {
+            result.resolved[plan.modelId] = {
+                dataSourceId: plan.existingDataSourceId,
+                envVar: plan.envVar,
+            };
+            continue;
+        }
+        try {
+            const cli = await runNtn([
+                "databases",
+                "create",
+                "--parent",
+                plan.parentPageId,
+                "--title",
+                titleFor(plan.modelId),
+            ]);
+            if (cli.code !== 0) {
+                result.failures.push({
+                    modelId: plan.modelId,
+                    error: cli.stderr || cli.stdout,
+                });
+                continue;
+            }
+            const parsed = JSON.parse(cli.stdout);
+            const dataSourceId = parsed.dataSourceId;
+            if (!dataSourceId) {
+                result.failures.push({
+                    modelId: plan.modelId,
+                    error: "ntn did not return a dataSourceId",
+                });
+                continue;
+            }
+            result.resolved[plan.modelId] = { dataSourceId, envVar: plan.envVar };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            result.failures.push({ modelId: plan.modelId, error: message });
+        }
+    }
+    return result;
+}
+function titleFor(modelId) {
+    const map = {
+        "blog-translations": "Blog Translations",
+        "page-translations": "Page Translations",
+        "block-translations": "Block Translations",
+        "site-settings-translations": "Site Settings Translations",
+    };
+    return map[modelId] ?? modelId;
+}
+//# sourceMappingURL=apply.js.map

package/dist/notion-translation-sources/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/notion-translation-sources/apply.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,oEAAoE;AACpE,qEAAqE;AACrE,8DAA8D;AAC9D,4BAA4B;AAE5B,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAQ/C,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAoC;IAEpC,MAAM,MAAM,GAAkC,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACzD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG;gBAC9B,YAAY,EAAE,IAAI,CAAC,oBAAoB;gBACvC,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC;gBACvB,WAAW;gBACX,QAAQ;gBACR,UAAU;gBACV,IAAI,CAAC,YAAY;gBACjB,SAAS;gBACT,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;aACvB,CAAC,CAAC;YACH,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACnB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,KAAK,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM;iBAChC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAA8B,CAAC;YACnE,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;YACzC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,KAAK,EAAE,mCAAmC;iBAC3C,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe;IAC/B,MAAM,GAAG,GAA2B;QAClC,mBAAmB,EAAE,mBAAmB;QACxC,mBAAmB,EAAE,mBAAmB;QACxC,oBAAoB,EAAE,oBAAoB;QAC1C,4BAA4B,EAAE,4BAA4B;KAC3D,CAAC;IACF,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;AACjC,CAAC"}

package/dist/notion-translation-sources/index.js

@@ -0,0 +1,3 @@
+export * from "./plan.js";
+export * from "./apply.js";
+//# sourceMappingURL=index.js.map

package/dist/notion-translation-sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notion-translation-sources/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/notion-translation-sources/plan.js

@@ -0,0 +1,33 @@
+// packages/create-notionx-app/src/notion-translation-sources/plan.ts
+//
+// Pure planner for the four built-in Notion translation data
+// sources. The planner never calls the `ntn` CLI; it returns a
+// list of `NotionTranslationSourcePlan` records that the runner
+// resolves into actual Notion resources.
+const MODEL_ID_TO_ENV = {
+    "blog-translations": "NOTION_BLOG_TRANSLATIONS_DATA_SOURCE_ID",
+    "page-translations": "NOTION_PAGES_TRANSLATIONS_DATA_SOURCE_ID",
+    "block-translations": "NOTION_BLOCKS_TRANSLATIONS_DATA_SOURCE_ID",
+    "site-settings-translations": "NOTION_SITE_SETTINGS_TRANSLATIONS_DATA_SOURCE_ID",
+};
+const ALL_MODEL_IDS = [
+    "blog-translations",
+    "page-translations",
+    "block-translations",
+    "site-settings-translations",
+];
+export function planNotionTranslationSources(input) {
+    return ALL_MODEL_IDS.map((modelId) => {
+        const envVar = MODEL_ID_TO_ENV[modelId];
+        const existing = input.existingTranslationSources[modelId];
+        return {
+            modelId,
+            envVar,
+            parentPageId: input.parentPageId,
+            copyFrom: input.copyFrom,
+            existingDataSourceId: existing?.dataSourceId,
+            action: existing ? "reuse" : "create",
+        };
+    });
+}
+//# sourceMappingURL=plan.js.map

package/dist/notion-translation-sources/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/notion-translation-sources/plan.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,6DAA6D;AAC7D,+DAA+D;AAC/D,gEAAgE;AAChE,yCAAyC;AAiBzC,MAAM,eAAe,GAGjB;IACF,mBAAmB,EAAE,yCAAyC;IAC9D,mBAAmB,EAAE,0CAA0C;IAC/D,oBAAoB,EAAE,2CAA2C;IACjE,4BAA4B,EAC1B,kDAAkD;CACrD,CAAC;AAEF,MAAM,aAAa,GAA6C;IAC9D,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,4BAA4B;CAC7B,CAAC;AAUF,MAAM,UAAU,4BAA4B,CAC1C,KAAwC;IAExC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO;YACL,OAAO;YACP,MAAM;YACN,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,oBAAoB,EAAE,QAAQ,EAAE,YAAY;YAC5C,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;SACtC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/notionx-source.js

@@ -0,0 +1,142 @@
+// packages/create-notionx-app/src/notionx-source.ts
+//
+// Resolves the `notionxSource` semver range that the scaffolder
+// writes into the generated `package.json`'s
+// `@notionx/core` / `@notionx/create-notionx-app` entries.
+//
+// Resolution order (highest priority first):
+//
+//   1. Explicit override (`--notionx-source <range>` or
+//      the interactive prompt).
+//   2. **Monorepo dev mode** — the user is running the scaffolder
+//      from inside the `notionx` monorepo (or from a workspace
+//      consumer such as `notionx/apps/<app>`). When we can see
+//      `packages/notionx/package.json` two directories up from the
+//      target dir, we emit `workspace:*` so the generated project
+//      resolves `@notionx/core` against the local checkout via
+//      pnpm workspace symlinks. This is the path scaffolder
+//      authors use to iterate on `core` without publish / install
+//      round-trips.
+//   3. Live npm registry — fetch `@notionx/core`'s `dist-tags.latest`
+//      and emit `^<version>`. The fetch has a 5s timeout.
+//   4. Hardcoded `FALLBACK_NOTIONX_SOURCE` range — used when the
+//      registry is unreachable. Bump in lockstep with releases.
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * Last-known-good fallback used when the npm registry lookup
+ * fails (network down, registry behind a proxy, 5xx, etc.).
+ *
+ * Bump this in lockstep with the latest published release — but
+ * note that any *in-flight* release cycle should accept a slightly
+ * stale fallback over refusing to install.
+ *
+ * Exported so the prompt / answers modules can reference the same
+ * source of truth instead of duplicating the literal — duplicate
+ * strings drifted out of sync in 0.5.x and produced un-installable
+ * scaffolds (`ERR_PNPM_NO_MATCHING_VERSION` for `@notionx/core@^0.5.2`).
+ */
+export const FALLBACK_NOTIONX_SOURCE = "^1.0.0";
+const REGISTRY_TIMEOUT_MS = 5_000;
+/**
+ * Marker written into the generated `.notionx/scaffold.json` and
+ * `package.json` so downstream tools (the `update` command, the
+ * doctor, etc.) can tell that this project was generated in
+ * monorepo dev mode and should be upgraded by re-running the
+ * scaffolder rather than by pulling a new semver from npm.
+ */
+export const MONOREPO_PROTOCOL = "workspace:*";
+/**
+ * Returns true when the scaffold target lives inside the `notionx`
+ * monorepo — i.e. we can see the monorepo root two directories up
+ * from the target. Both the monorepo root and `apps/<name>` consumers
+ * qualify, as do any depth-2 or shallower workspace packages.
+ *
+ * We probe the resolved real path of `packages/notionx/package.json`
+ * (not the symlink) to avoid false negatives inside worktrees.
+ */
+export function isMonorepoDevMode(targetDir) {
+    try {
+        // Walk up from the target directory looking for a sibling
+        // `packages/notionx/package.json` whose name is `@notionx/core`.
+        // We probe upward (not just two levels) so the detector works
+        // for both shallow (`notionx/apps/digwis`) and nested
+        // (`notionx/apps/scratch/digwis`) layouts, and for worktrees
+        // checked out anywhere under the monorepo root.
+        let cursor = resolve(targetDir);
+        for (let i = 0; i < 6; i++) {
+            const probe = resolve(cursor, "packages", "notionx", "package.json");
+            if (existsSync(probe)) {
+                const contents = readFileSync(probe, "utf8");
+                if (/"name"\s*:\s*"@notionx\/core"/.test(contents)) {
+                    return true;
+                }
+            }
+            const parent = resolve(cursor, "..");
+            if (parent === cursor)
+                break; // filesystem root
+            cursor = parent;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolved semver range the scaffolder should write into the
+ * generated project.
+ *
+ * If the caller passed an explicit range (via `--notionx-source`
+ * or the interactive prompt), that wins. Otherwise, if the
+ * target is inside the `notionx` monorepo, we emit `workspace:*`
+ * for the local-dev fast path. Otherwise we hit the npm registry
+ * for `@notionx/core`'s `dist-tags.latest` and prefix it with `^`
+ * so the generated project picks up compatible updates.
+ */
+export async function resolveNotionxSource(override, targetDir) {
+    if (override !== undefined && override !== "") {
+        return override;
+    }
+    if (isMonorepoDevMode(targetDir)) {
+        return MONOREPO_PROTOCOL;
+    }
+    try {
+        const version = await fetchLatestCoreVersion();
+        if (version) {
+            return `^${version}`;
+        }
+    }
+    catch {
+        // Swallow — fall through to the hardcoded fallback below.
+    }
+    return FALLBACK_NOTIONX_SOURCE;
+}
+/**
+ * Fetches `@notionx/core`'s `dist-tags.latest` from the public
+ * npm registry, with a hard timeout. Returns `null` on any error
+ * (timeout, non-2xx, malformed JSON, missing field) so the caller
+ * can fall back without needing to know what went wrong.
+ */
+async function fetchLatestCoreVersion() {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), REGISTRY_TIMEOUT_MS);
+    try {
+        const response = await fetch("https://registry.npmjs.org/@notionx/core/latest", { signal: controller.signal });
+        if (!response.ok) {
+            return null;
+        }
+        const data = (await response.json());
+        if (typeof data.version !== "string" || data.version.length === 0) {
+            return null;
+        }
+        return data.version;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=notionx-source.js.map

package/dist/notionx-source.js.map

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