superslate 0.3.0 → 0.4.0

package/dist/cli.js

@@ -1329,6 +1329,7 @@ function isUnicodeSupported() {
 }
 var unicode = isUnicodeSupported();
 var isCI = () => process.env.CI === "true";
+var isTTY = (o2) => o2.isTTY === true;
 var unicodeOr = (o2, e) => unicode ? o2 : e;
 var S_STEP_ACTIVE = unicodeOr("◆", "*");
 var S_STEP_CANCEL = unicodeOr("■", "x");
@@ -1591,6 +1592,46 @@ var u4 = {
   heavy: unicodeOr("━", "="),
   block: unicodeOr("█", "#")
 };
+function progress({
+  style: o2 = "heavy",
+  max: d = 100,
+  size: v = 40,
+  ...x
+} = {}) {
+  const r2 = spinner(x);
+  let a2 = 0, n3 = "";
+  const c2 = Math.max(1, d), l2 = Math.max(1, v), S = (t2) => {
+    switch (t2) {
+      case "initial":
+      case "active":
+        return (e) => styleText2("magenta", e);
+      case "error":
+      case "cancel":
+        return (e) => styleText2("red", e);
+      case "submit":
+        return (e) => styleText2("green", e);
+      default:
+        return (e) => styleText2("magenta", e);
+    }
+  }, p2 = (t2, e) => {
+    const m2 = Math.floor(a2 / c2 * l2);
+    return `${S(t2)(u4[o2].repeat(m2))}${styleText2("dim", u4[o2].repeat(l2 - m2))} ${e}`;
+  }, h2 = (t2 = "") => {
+    n3 = t2, r2.start(p2("initial", t2));
+  }, g2 = (t2 = 1, e) => {
+    a2 = Math.min(c2, t2 + a2), r2.message(p2("active", e ?? n3)), n3 = e ?? n3;
+  };
+  return {
+    start: h2,
+    stop: r2.stop,
+    cancel: r2.cancel,
+    error: r2.error,
+    clear: r2.clear,
+    advance: g2,
+    isCancelled: r2.isCancelled,
+    message: (t2) => g2(0, t2)
+  };
+}
 var SELECT_INSTRUCTIONS = [
   `${styleText2("dim", "↑/↓")} to navigate`,
   `${styleText2("dim", "Enter:")} confirm`
@@ -2550,10 +2591,10 @@ ${dryRunDescription(client, root)}`);
     outro2("Dry run complete. No client configuration was changed.");
     return;
   }
-  const progress = spinner2();
-  progress.start("Testing the local MCP server");
+  const progress2 = spinner2();
+  progress2.start("Testing the local MCP server");
   await smokeServer(root);
-  progress.stop("Local MCP server passed its protocol self-check");
+  progress2.stop("Local MCP server passed its protocol self-check");
   for (const client of clients) {
     const result = client === "codex" ? await configureCodex(root) : client === "cursor" ? await configureCursor(root) : await configureClaude(root);
     log2.success(`${client}: ${result}`);
@@ -3297,7 +3338,7 @@ import { promisify } from "node:util";
 import { createWriteStream } from "node:fs";
 import { rm as rm3 } from "node:fs/promises";
 import { join as join6 } from "node:path";
-import { Readable } from "node:stream";
+import { Readable, Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 var RELEASE_TAG_PATTERN2 = /^v\d+\.\d+\.\d+(?:-rc\.\d+)?$/;
 var INDEX_TIMEOUT_MS = 15000;
@@ -3357,7 +3398,24 @@ async function resolveRelease(licenseKey, baseUrl = deliveryBaseUrl()) {
   }
   return index;
 }
-async function downloadAsset(licenseKey, releaseTag, assetName, directory, baseUrl = deliveryBaseUrl()) {
+function readContentLength(response) {
+  const header = response.headers.get("content-length");
+  if (!header)
+    return;
+  const total = Number(header);
+  return Number.isSafeInteger(total) && total > 0 ? total : undefined;
+}
+function countBytes(total, onBytes) {
+  let received = 0;
+  return new Transform({
+    transform(chunk, _encoding, done) {
+      received += chunk.length;
+      onBytes(received, total);
+      done(null, chunk);
+    }
+  });
+}
+async function downloadAsset(licenseKey, releaseTag, assetName, directory, baseUrl = deliveryBaseUrl(), onBytes) {
   const response = await requestDelivery(`${baseUrl}/v1/source/${encodeURIComponent(releaseTag)}/${encodeURIComponent(assetName)}`, {
     headers: { authorization: `Bearer ${licenseKey}` },
     signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS)
@@ -3365,8 +3423,13 @@ async function downloadAsset(licenseKey, releaseTag, assetName, directory, baseU
   if (!response.body)
     throw new Error(`Source delivery returned an empty ${assetName}.`);
   const path = join6(directory, assetName);
+  const source = Readable.fromWeb(response.body);
   try {
-    await pipeline(Readable.fromWeb(response.body), createWriteStream(path));
+    if (onBytes) {
+      await pipeline(source, countBytes(readContentLength(response), onBytes), createWriteStream(path));
+    } else {
+      await pipeline(source, createWriteStream(path));
+    }
   } catch {
     await rm3(path, { force: true });
     throw new Error(`Downloading ${assetName} was interrupted. Try again in a few minutes.`);
@@ -3722,6 +3785,8 @@ function isTemplatePathExcluded(relativePath) {
     return true;
   if (parts.includes("dist") || parts.includes("out"))
     return true;
+  if (parts.includes(".next") || parts.includes(".source") || parts.includes(".turbo"))
+    return true;
   if (normalized === "bun.lock")
     return true;
   if (normalized === ".vercelignore")
@@ -3806,14 +3871,14 @@ function verifyReleaseMetadata(checksum, manifest, artifactName, digest, templat
     throw new Error(`${CLI_NAME2} release manifest does not match the downloaded source artifact.`);
   }
 }
-async function downloadLicensedTemplate(target, licenseKey, sourceVersion) {
+async function downloadLicensedTemplate(target, licenseKey, sourceVersion, onDownloadProgress) {
   const baseUrl = deliveryBaseUrl();
   const releaseTag = sourceVersion ?? (await resolveRelease(licenseKey, baseUrl)).latest;
   const { artifact, checksum: checksumName, manifest: manifestName } = releaseAssetNames(releaseTag);
   const temporaryDirectory = await mkdtemp(join7(tmpdir(), `${CLI_NAME2}-`));
   const extractedPath = join7(temporaryDirectory, "template");
   try {
-    const archivePath = await downloadAsset(licenseKey, releaseTag, artifact, temporaryDirectory, baseUrl);
+    const archivePath = await downloadAsset(licenseKey, releaseTag, artifact, temporaryDirectory, baseUrl, onDownloadProgress);
     await downloadAsset(licenseKey, releaseTag, checksumName, temporaryDirectory, baseUrl);
     await downloadAsset(licenseKey, releaseTag, manifestName, temporaryDirectory, baseUrl);
     const archive = await readFile5(archivePath);
@@ -3965,7 +4030,7 @@ async function scaffold(options) {
     if (options.from)
       await copyLocalTemplate(options.from, target);
     else if (options.licenseKey) {
-      await downloadLicensedTemplate(target, options.licenseKey, options.sourceVersion);
+      await downloadLicensedTemplate(target, options.licenseKey, options.sourceVersion, options.onDownloadProgress);
     } else {
       throw new Error(`A local source path or a ${CLI_NAME2} licence key is required.`);
     }
@@ -4305,35 +4370,71 @@ async function installDependencies(target) {
     throw new Error(`Dependency installation failed.${commandFailureOutput(stdout2, stderr)}`);
   }
 }
-async function runCapturedCommand(command, target) {
-  const { stdout: stdout2, stderr, exitCode } = await runCaptured2(command, { cwd: target });
-  if (exitCode !== 0) {
-    throw new Error(`${command.join(" ")} failed.${commandFailureOutput(stdout2, stderr)}`);
-  }
-}
 async function occupiedDevelopmentPorts() {
   const results = await Promise.all([5173, 8000].map(async (port) => ({ port, available: await isPortAvailable(port) })));
   return results.filter((result) => !result.available).map((result) => result.port);
 }
 async function startDevelopment(target) {
-  await runStep("Starting local Postgres", "Local Postgres is ready", () => runCapturedCommand(["docker", "compose", "up", "-d", "--wait", "postgres"], target));
   log.info(`Web  http://localhost:5173
 API  http://localhost:8000`);
   outro("Development servers are starting. Ctrl+C stops app servers; Postgres stays running.");
-  const exitCode = await runInherited(["vp", "run", "-r", "--parallel", "dev"], { cwd: target });
+  const exitCode = await runInherited(["pnpm", "run", "dev"], { cwd: target });
   if (exitCode !== 0 && exitCode !== 130) {
     throw new Error(`Development servers exited with code ${exitCode}.`);
   }
 }
-async function runStep(pending, complete, action, indicator = "dots") {
-  const progress = spinner({ indicator });
-  progress.start(pending);
+var BYTE_UNITS = ["B", "KB", "MB", "GB"];
+var BYTE_SCALE = 1024;
+var PROGRESS_MAX = 100;
+var PROGRESS_BAR_WIDTH = 40;
+var PROGRESS_MIN_INTERVAL_MS = 80;
+var PROGRESS_MIN_DELTA = 0.5;
+function formatBytes(bytes) {
+  let value = bytes;
+  let unit = 0;
+  while (value >= BYTE_SCALE && unit < BYTE_UNITS.length - 1) {
+    value /= BYTE_SCALE;
+    unit += 1;
+  }
+  return `${unit === 0 ? value : value.toFixed(1)} ${BYTE_UNITS[unit]}`;
+}
+function supportsAnimation() {
+  return isTTY(process.stdout) && !isCI();
+}
+function createScaffoldReporter(pending, expectsDownload) {
+  if (!expectsDownload || !supportsAnimation())
+    return { handle: spinner() };
+  const bar = progress({
+    style: "heavy",
+    size: PROGRESS_BAR_WIDTH,
+    max: PROGRESS_MAX
+  });
+  let shown = 0;
+  let emittedAt = 0;
+  return {
+    handle: bar,
+    onDownloadProgress: (received, total) => {
+      const percent = total ? Math.min(PROGRESS_MAX, received / total * PROGRESS_MAX) : shown;
+      const finished = total !== undefined && received >= total;
+      const now = performance.now();
+      if (!finished && now - emittedAt < PROGRESS_MIN_INTERVAL_MS && percent - shown < PROGRESS_MIN_DELTA) {
+        return;
+      }
+      emittedAt = now;
+      const label = finished ? pending : total === undefined ? `Downloading source  ${formatBytes(received)}` : `Downloading source  ${formatBytes(received)} / ${formatBytes(total)}`;
+      bar.advance(percent - shown, label);
+      shown = percent;
+    }
+  };
+}
+async function runStep(pending, complete, action, handle) {
+  handle.start(pending);
   try {
     const result = await action();
-    progress.stop(complete);
+    handle.stop(complete);
     return result;
   } catch (error) {
-    progress.error(`${pending} failed`);
+    handle.error(`${pending} failed`);
     throw error;
   }
 }
@@ -4344,8 +4445,10 @@ async function createApplication(options) {
   const databasePort = await findAvailablePort();
   await mkdir5(dirname2(target), { recursive: true });
   const staging = await mkdtemp2(join8(dirname2(target), `.${options.appName}-${CLI_NAME}-`));
+  const preparing = "Preparing your application";
+  const reporter = createScaffoldReporter(preparing, Boolean(options.licenseKey));
   try {
-    await runStep("Preparing your application", "Application source prepared", () => scaffold({
+    await runStep(preparing, "Application source prepared", () => scaffold({
       appName: options.appName,
       scope: options.scope,
       brandName: options.brandName,
@@ -4354,13 +4457,14 @@ async function createApplication(options) {
       licenseKey: options.licenseKey,
       sourceVersion: options.sourceVersion,
       initializeGit: options.initializeGit,
-      databasePort
-    }));
+      databasePort,
+      onDownloadProgress: reporter.onDownloadProgress
+    }), reporter.handle);
     if (options.deployment) {
-      await runStep("Configuring deployment", "Deployment target locked", () => applyDeploymentSelection2(staging, options.appName, options.deployment));
+      await runStep("Configuring deployment", "Deployment target locked", () => applyDeploymentSelection2(staging, options.appName, options.deployment), spinner());
     }
     if (options.installDependencies) {
-      await runStep("Installing dependencies with pnpm", "Dependencies installed with pnpm", () => installDependencies(staging), "timer");
+      await runStep("Installing dependencies with pnpm", "Dependencies installed with pnpm", () => installDependencies(staging), spinner({ indicator: "timer" }));
     }
     if (await stat5(target).catch(() => {
       return;
@@ -4378,12 +4482,7 @@ function completionDetails(target, options, databasePort) {
   const install = options.installDependencies ? [] : ["vp install --frozen-lockfile"];
   return {
     directory: `./${targetName}`,
-    commands: [
-      `cd ${targetName}`,
-      ...install,
-      "docker compose up -d postgres",
-      "vp run -r --parallel dev"
-    ].join(`
+    commands: [`cd ${targetName}`, ...install, "pnpm dev"].join(`
 `),
     database: `Postgres  localhost:${databasePort}`
   };
@@ -4470,6 +4569,7 @@ export {
   printRunnableCommands,
   parseArguments,
   occupiedDevelopmentPorts,
+  formatBytes,
   findAvailablePort,
   describeTargetConflict,
   collectLicenseKey

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superslate",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Create a production-oriented SaaS application from superslate.",
   "keywords": [
     "bun",
@@ -39,8 +39,9 @@
   },
   "devDependencies": {
     "@clack/prompts": "^1.7.0",
-    "@types/bun": "^1.3.14",
-    "typescript": "^7.0.2"
+    "@types/node": "^26.1.2",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
   },
   "engines": {
     "node": ">=20"