@moneydevkit/create 0.3.3 → 0.4.0-beta.0

package/README.md

@@ -5,8 +5,8 @@ Developer onboarding CLI for Money Dev Kit. This package publishes the interacti
 ## Getting Started
 
 1. Run `npx @moneydevkit/create@latest` from the root of your project. The CLI walks you through login, webhook verification, and writes your secrets to `.env.local` (or a path you pick) while also copying them to the clipboard by default.
-2. If we detect a Next.js app (package.json `next` dependency, `next.config.*`, or an `app/`/`pages/` directory), we’ll offer to install and scaffold `@moneydevkit/nextjs` for you.
-3. Follow the prompts. When you reach your editor again, `MDK_ACCESS_TOKEN`, `MDK_WEBHOOK_SECRET`, and `MDK_MNEMONIC` are ready to go.
+2. If we detect a Next.js app (package.json `next` dependency, `next.config.*`, or an `app/` directory), we'll offer to install and scaffold `@moneydevkit/nextjs` for you.
+3. Follow the prompts. When you reach your editor again, `MDK_ACCESS_TOKEN` and `MDK_MNEMONIC` are ready to go.
 
 ### Customize the flow with flags
 
@@ -16,7 +16,7 @@ Pass any of the options from the table below to skip prompts or run non-interact
 npx @moneydevkit/create@latest \
   --dir ./apps/storefront \
   --env-target .env.production \
-  --webhook-url https://example.com/webhooks/mdk \
+  --webhook-url https://example.com \
   --project-name "Storefront" \
   --no-open --no-clipboard
 ```
@@ -41,9 +41,9 @@ The CLI still creates a device code but immediately authorises it using your coo
 
 ## Next.js scaffolding
 
-- Auto-detects Next.js via `package.json`, `next.config.*`, or `app/`/`pages/` directories. If found, you’ll be prompted to install and scaffold `@moneydevkit/nextjs`. Requires Next.js 15+ (per SDK peer deps).
+- Auto-detects Next.js via `package.json`, `next.config.*`, or `app/` directory. If found, you'll be prompted to install and scaffold `@moneydevkit/nextjs`. Requires Next.js 15+ (per SDK peer deps).
 - `--scaffold-nextjs` forces the install/scaffold (useful for CI); if no Next.js app is found, the CLI prints a warning and skips.
-- Prefers the App Router (`app/api/mdk/route.(ts|js)` and `app/checkout/[id]/page.(tsx|js)`); falls back to the Pages Router paths when only `pages/` exists.
+- Always scaffolds App Router files (`app/api/mdk/route.(ts|js)` and `app/checkout/[id]/page.(tsx|js)`).
 - Existing files are left untouched; `next.config.*` is backed up if we need to wrap it with `withMdkCheckout`.
 
 ## Flags
@@ -58,7 +58,7 @@ The CLI still creates a device code but immediately authorises it using your coo
 | `--no-clipboard` | Do not place secrets on the clipboard. |
 | `--json` | Emit JSON result payloads (no interactive prompts).
 | `--manual-login "<cookie>"` | Use a pre-generated dashboard session cookie instead of device flow. |
-| `--webhook-url "<url>"` | Provide the webhook URL when running in `--manual-login` or `--json` modes. |
+| `--webhook-url "<url>"` | Provide the domain when running in `--manual-login` or `--json` modes. |
 | `--force-new-webhook` | Force creation of a new webhook even if one already exists for the URL. |
 | `--scaffold-nextjs` | Force install + scaffold `@moneydevkit/nextjs` (warns and skips if no Next.js app is detected). |
 
@@ -75,8 +75,25 @@ npm run run:local    # talk to a dashboard at http://localhost:3900
 
 ## Releasing to npm
 
-1. Bump the version in `packages/create/package.json` (for example: `npm version 0.2.0 --workspace packages/create --no-git-tag-version`) and commit the resulting `package-lock.json` change.
-2. Push the commit, then create a GitHub release (or annotated tag) named `create-vX.Y.Z` that matches the new version string.
-3. The `publish-create` workflow will detect that tag, run the build, and execute `npm publish packages/create --access public` using trusted publishing.
+All `@moneydevkit/*` packages share a unified version number and are released together.
+
+### Beta releases (automatic)
+
+Every push to `main` that modifies files in `packages/` triggers the `publish-beta` workflow:
+1. All packages are bumped to the next beta version (e.g., `0.4.0-beta.0` → `0.4.0-beta.1`)
+2. All packages are published to npm with the `beta` tag
+
+Install the latest beta with:
+```bash
+npx @moneydevkit/create@beta
+npm install @moneydevkit/nextjs@beta
+```
+
+### Stable releases
+
+1. Create a GitHub release with a tag matching the version in package.json (e.g., if package.json has `0.4.0-beta.3`, create tag `v0.4.0`)
+2. The `publish-release` workflow validates, publishes, and bumps to the next minor version
 
 Once that workflow succeeds, `npx @moneydevkit/create@latest` automatically downloads the freshly published build.
+
+See the [main README](../../README.md#releasing) for version flow examples and error cases.

package/dist/index.cjs

@@ -234,6 +234,11 @@ function writeFileWithBackup(filePath, content) {
 }
 
 // src/scaffold/nextjs.ts
+var import_meta = {};
+var templateRoot = new URL("../templates/nextjs/", import_meta.url);
+function readTemplate(relativePath) {
+  return import_node_fs4.default.readFileSync(new URL(relativePath, templateRoot), "utf8");
+}
 function findExistingConfig(rootDir, preferred) {
   if (preferred && import_node_fs4.default.existsSync(preferred)) return preferred;
   const candidates = [
@@ -276,138 +281,12 @@ async function installNextjsPackage(rootDir, packageManager) {
   return { installed: true, skipped: false };
 }
 function createAppRouteContent(isTypeScript) {
-  const ext = isTypeScript ? "ts" : "js";
-  if (ext === "ts") {
-    return 'export { POST } from "@moneydevkit/nextjs/server/route";\n';
-  }
-  return 'export { POST } from "@moneydevkit/nextjs/server/route";\n';
+  return readTemplate(`app/api/mdk/route.${isTypeScript ? "ts" : "js"}`);
 }
 function createAppCheckoutPageContent(isTypeScript) {
-  if (isTypeScript) {
-    return [
-      '"use client";',
-      "",
-      'import { Checkout } from "@moneydevkit/nextjs";',
-      "",
-      "type CheckoutPageProps = { params: { id: string } };",
-      "",
-      "export default function CheckoutPage({ params }: CheckoutPageProps) {",
-      "  return <Checkout id={params.id} />;",
-      "}",
-      ""
-    ].join("\n");
-  }
-  return [
-    '"use client";',
-    "",
-    'import { Checkout } from "@moneydevkit/nextjs";',
-    "",
-    "export default function CheckoutPage({ params }) {",
-    "  return <Checkout id={params.id} />;",
-    "}",
-    ""
-  ].join("\n");
-}
-function createPagesApiRouteContent(isTypeScript) {
-  if (isTypeScript) {
-    return [
-      'import type { NextApiRequest, NextApiResponse } from "next";',
-      'import { POST as appRouteHandler } from "@moneydevkit/nextjs/server/route";',
-      "",
-      "export default async function handler(req: NextApiRequest, res: NextApiResponse) {",
-      '  const url = `http://${req.headers.host ?? "localhost"}${req.url ?? "/api/mdk"}`;',
-      "  const request = new Request(url, {",
-      '    method: req.method || "POST",',
-      "    headers: req.headers as Record<string, string>,",
-      "    body:",
-      '      req.method === "GET" || req.method === "HEAD"',
-      "        ? undefined",
-      '        : typeof req.body === "string"',
-      "          ? req.body",
-      "          : JSON.stringify(req.body ?? {}),",
-      "  });",
-      "",
-      "  const response = await appRouteHandler(request);",
-      "  res.status(response.status);",
-      "  response.headers.forEach((value, key) => {",
-      "    res.setHeader(key, value);",
-      "  });",
-      "  const body = await response.arrayBuffer();",
-      "  res.send(Buffer.from(body));",
-      "}",
-      ""
-    ].join("\n");
-  }
-  return [
-    'import { POST as appRouteHandler } from "@moneydevkit/nextjs/server/route";',
-    "",
-    "export default async function handler(req, res) {",
-    '  const url = `http://${req.headers.host ?? "localhost"}${req.url ?? "/api/mdk"}`;',
-    "  const request = new Request(url, {",
-    '    method: req.method || "POST",',
-    "    headers: req.headers,",
-    "    body:",
-    '      req.method === "GET" || req.method === "HEAD"',
-    "        ? undefined",
-    '        : typeof req.body === "string"',
-    "          ? req.body",
-    "          : JSON.stringify(req.body ?? {}),",
-    "  });",
-    "",
-    "  const response = await appRouteHandler(request);",
-    "  res.status(response.status);",
-    "  response.headers.forEach((value, key) => {",
-    "    res.setHeader(key, value);",
-    "  });",
-    "  const body = await response.arrayBuffer();",
-    "  res.send(Buffer.from(body));",
-    "}",
-    ""
-  ].join("\n");
-}
-function createPagesCheckoutContent(isTypeScript) {
-  if (isTypeScript) {
-    return [
-      '"use client";',
-      "",
-      'import { useRouter } from "next/router";',
-      'import { Checkout } from "@moneydevkit/nextjs";',
-      "",
-      "export default function CheckoutPage() {",
-      "  const router = useRouter();",
-      "  const id = Array.isArray(router.query.id)",
-      "    ? router.query.id[0]",
-      "    : router.query.id;",
-      "",
-      "  if (!id) {",
-      "    return null;",
-      "  }",
-      "",
-      "  return <Checkout id={id as string} />;",
-      "}",
-      ""
-    ].join("\n");
-  }
-  return [
-    '"use client";',
-    "",
-    'import { useRouter } from "next/router";',
-    'import { Checkout } from "@moneydevkit/nextjs";',
-    "",
-    "export default function CheckoutPage() {",
-    "  const router = useRouter();",
-    "  const id = Array.isArray(router.query.id)",
-    "    ? router.query.id[0]",
-    "    : router.query.id;",
-    "",
-    "  if (!id) {",
-    "    return null;",
-    "  }",
-    "",
-    "  return <Checkout id={id} />;",
-    "}",
-    ""
-  ].join("\n");
+  return readTemplate(
+    `app/checkout/[id]/page.${isTypeScript ? "tsx" : "js"}`
+  );
 }
 function isTypeScriptConfig(configPath) {
   return configPath.endsWith(".ts") || configPath.endsWith(".mts");
@@ -539,39 +418,6 @@ function scaffoldAppRouter(appDir, isTypeScript) {
   }
   return { added, skipped };
 }
-function scaffoldPagesRouter(pagesDir, isTypeScript) {
-  const added = [];
-  const skipped = [];
-  const apiPath = import_node_path5.default.join(
-    pagesDir,
-    "api",
-    `mdk.${isTypeScript ? "ts" : "js"}`
-  );
-  const apiResult = writeFileIfAbsent(
-    apiPath,
-    createPagesApiRouteContent(isTypeScript)
-  );
-  if (apiResult.status === "created") {
-    added.push(apiResult.path);
-  } else {
-    skipped.push(apiResult.path);
-  }
-  const checkoutPath = import_node_path5.default.join(
-    pagesDir,
-    "checkout",
-    `[id].${isTypeScript ? "tsx" : "js"}`
-  );
-  const checkoutResult = writeFileIfAbsent(
-    checkoutPath,
-    createPagesCheckoutContent(isTypeScript)
-  );
-  if (checkoutResult.status === "created") {
-    added.push(checkoutResult.path);
-  } else {
-    skipped.push(checkoutResult.path);
-  }
-  return { added, skipped };
-}
 async function scaffoldNextJs(options) {
   const { detection, jsonMode, skipInstall } = options;
   if (!detection.rootDir) {
@@ -588,21 +434,11 @@ async function scaffoldNextJs(options) {
       `Could not automatically update ${import_node_path5.default.basename(configPath)} (${configResult.reason}). Please wrap your Next.js config with withMdkCheckout manually.`
     );
   }
-  let fileResults;
-  if (detection.appDir) {
-    fileResults = scaffoldAppRouter(detection.appDir, detection.usesTypeScript);
-  } else if (detection.pagesDir) {
-    fileResults = scaffoldPagesRouter(
-      detection.pagesDir,
-      detection.usesTypeScript
-    );
-  } else {
-    fileResults = scaffoldAppRouter(
-      import_node_path5.default.join(rootDir, "app"),
-      detection.usesTypeScript
-    );
+  const appDir = detection.appDir ?? import_node_path5.default.join(rootDir, "app");
+  const fileResults = scaffoldAppRouter(appDir, detection.usesTypeScript);
+  if (!detection.appDir) {
     warnings.push(
-      "No app/ or pages/ directory detected; created App Router scaffolding in app/."
+      "No app/ directory detected; created App Router scaffolding in app/."
     );
   }
   if (!jsonMode) {
@@ -806,7 +642,7 @@ async function runDeviceFlow(options) {
       p.note(
         [
           `Device code: ${device.userCode}`,
-          `Webhook URL: ${webhookUrl}`,
+          `Domain: ${webhookUrl}`,
           "Open the authorization page, click Authorize, then return to this terminal."
         ].join("\n"),
         "Authorize this device"
@@ -962,7 +798,7 @@ async function main() {
   }
   while (!webhookUrl) {
     const webhookInput = await p.text({
-      message: "Webhook URL for your application",
+      message: "Domain for your application",
       initialValue: "https://",
       placeholder: "https://yourapp.com",
       validate: (value) => isValidHttpUrl(value?.trim()) ? void 0 : "Enter a valid http(s) URL (e.g. https://yourapp.com)"
@@ -1029,7 +865,6 @@ async function main() {
     });
     const updates = {
       MDK_ACCESS_TOKEN: result.credentials.apiKey,
-      MDK_WEBHOOK_SECRET: result.credentials.webhookSecret,
       MDK_MNEMONIC: result.mnemonic
     };
     ensureEnvFileExists(envPath);
@@ -1050,7 +885,7 @@ async function main() {
     }
     if (!flags.noClipboard) {
       await import_clipboardy.default.write(
-        [`MDK_ACCESS_TOKEN=${updates.MDK_ACCESS_TOKEN}`, `MDK_WEBHOOK_SECRET=${updates.MDK_WEBHOOK_SECRET}`, `MDK_MNEMONIC=${updates.MDK_MNEMONIC}`].join(
+        [`MDK_ACCESS_TOKEN=${updates.MDK_ACCESS_TOKEN}`, `MDK_MNEMONIC=${updates.MDK_MNEMONIC}`].join(
           "\n"
         )
       );