@stacksjs/buddy 0.70.86 → 0.70.88

package/dist/lazy-commands.js

@@ -1,188 +0,0 @@
-const commandRegistry = {
-  about: { path: "./commands/about.js", exportName: "about" },
-  add: { path: "./commands/add.js", exportName: "add" },
-  auth: { path: "./commands/auth.js", exportName: "auth" },
-  build: { path: "./commands/build.js", exportName: "build" },
-  cd: { path: "./commands/cd.js", exportName: "cd" },
-  changelog: { path: "./commands/changelog.js", exportName: "changelog" },
-  clean: { path: "./commands/clean.js", exportName: "clean" },
-  cloud: { path: "./commands/cloud.js", exportName: "cloud" },
-  commit: { path: "./commands/commit.js", exportName: "commit" },
-  completion: { path: "./commands/completion.js", exportName: "completion" },
-  "config:migrate": { path: "./commands/config-migrate.js", exportName: "configMigrate" },
-  configure: { path: "./commands/configure.js", exportName: "configure" },
-  create: { path: "./commands/create.js", exportName: "create" },
-  deploy: { path: "./commands/deploy.js", exportName: "deploy" },
-  dev: { path: "./commands/dev.js", exportName: "dev" },
-  dns: { path: "./commands/dns.js", exportName: "dns" },
-  "dns:pull": { path: "./commands/dns.js", exportName: "dns" },
-  "dns:diff": { path: "./commands/dns.js", exportName: "dns" },
-  "dns:sync": { path: "./commands/dns.js", exportName: "dns" },
-  doctor: { path: "./commands/doctor.js", exportName: "doctor" },
-  domains: { path: "./commands/domains.js", exportName: "domains" },
-  email: { path: "./commands/email.js", exportName: "email" },
-  env: { path: "./commands/env.js", exportName: "env" },
-  "extension:init": { path: "./commands/extension.js", exportName: "extension" },
-  "extension:build": { path: "./commands/extension.js", exportName: "extension" },
-  "extension:package": { path: "./commands/extension.js", exportName: "extension" },
-  "dashboard:install": { path: "./commands/features.js", exportName: "features" },
-  "dashboard:uninstall": { path: "./commands/features.js", exportName: "features" },
-  "commerce:install": { path: "./commands/features.js", exportName: "features" },
-  "commerce:uninstall": { path: "./commands/features.js", exportName: "features" },
-  "cms:install": { path: "./commands/features.js", exportName: "features" },
-  "cms:uninstall": { path: "./commands/features.js", exportName: "features" },
-  "marketing:install": { path: "./commands/features.js", exportName: "features" },
-  "marketing:uninstall": { path: "./commands/features.js", exportName: "features" },
-  "monitoring:install": { path: "./commands/features.js", exportName: "features" },
-  "monitoring:uninstall": { path: "./commands/features.js", exportName: "features" },
-  "realtime:install": { path: "./commands/features.js", exportName: "features" },
-  "realtime:uninstall": { path: "./commands/features.js", exportName: "features" },
-  "queue:install": { path: "./commands/features.js", exportName: "features" },
-  "queue:uninstall": { path: "./commands/features.js", exportName: "features" },
-  fresh: { path: "./commands/fresh.js", exportName: "fresh" },
-  generate: { path: "./commands/generate.js", exportName: "generate" },
-  http: { path: "./commands/http.js", exportName: "http" },
-  install: { path: "./commands/install.js", exportName: "install" },
-  key: { path: "./commands/key.js", exportName: "key" },
-  lint: { path: "./commands/lint.js", exportName: "lint" },
-  list: { path: "./commands/list.js", exportName: "list" },
-  mail: { path: "./commands/mail.js", exportName: "mailCommands" },
-  "mail:preview": { path: "./commands/mail.js", exportName: "mailCommands" },
-  maintenance: { path: "./commands/maintenance.js", exportName: "maintenance" },
-  down: { path: "./commands/maintenance.js", exportName: "maintenance" },
-  up: { path: "./commands/maintenance.js", exportName: "maintenance" },
-  status: { path: "./commands/maintenance.js", exportName: "maintenance" },
-  make: { path: "./commands/make.js", exportName: "make" },
-  migrate: { path: "./commands/migrate.js", exportName: "migrate" },
-  "migrate:fresh": { path: "./commands/migrate.js", exportName: "migrate" },
-  "migrate:switch": { path: "./commands/migrate.js", exportName: "migrate" },
-  "migrate:dns": { path: "./commands/migrate.js", exportName: "migrate" },
-  "migrate:project": { path: "./commands/migrate-project.js", exportName: "migrateProject" },
-  outdated: { path: "./commands/outdated.js", exportName: "outdated" },
-  package: { path: "./commands/package.js", exportName: "packageCommands" },
-  phone: { path: "./commands/phone.js", exportName: "phone" },
-  ports: { path: "./commands/ports.js", exportName: "ports" },
-  prepublish: { path: "./commands/prepublish.js", exportName: "prepublish" },
-  projects: { path: "./commands/projects.js", exportName: "projects" },
-  publish: { path: "./commands/publish.js", exportName: "publish" },
-  "publish:model": { path: "./commands/publish.js", exportName: "publish" },
-  "publish:controller": { path: "./commands/publish.js", exportName: "publish" },
-  "publish:middleware": { path: "./commands/publish.js", exportName: "publish" },
-  "publish:action": { path: "./commands/publish.js", exportName: "publish" },
-  "publish:core": { path: "./commands/publish.js", exportName: "publish" },
-  queue: { path: "./commands/queue.js", exportName: "queue" },
-  release: { path: "./commands/release.js", exportName: "release" },
-  route: { path: "./commands/route.js", exportName: "route" },
-  saas: { path: "./commands/saas.js", exportName: "saas" },
-  schedule: { path: "./commands/schedule.js", exportName: "schedule" },
-  search: { path: "./commands/search.js", exportName: "search" },
-  seed: { path: "./commands/seed.js", exportName: "seed" },
-  "seed:roles": { path: "./commands/seed.js", exportName: "seed" },
-  "roles:seed": { path: "./commands/seed.js", exportName: "seed" },
-  serve: { path: "./commands/serve.js", exportName: "serve" },
-  "serve:api": { path: "./commands/serve.js", exportName: "serveApi" },
-  setup: { path: "./commands/setup.js", exportName: "setup" },
-  share: { path: "./commands/share.js", exportName: "share" },
-  stack: { path: "./commands/stacks.js", exportName: "stacks" },
-  sms: { path: "./commands/sms.js", exportName: "sms" },
-  telemetry: { path: "./commands/telemetry.js", exportName: "telemetryCommand" },
-  test: { path: "./commands/test.js", exportName: "test" },
-  tinker: { path: "./commands/tinker.js", exportName: "tinker" },
-  types: { path: "./commands/types.js", exportName: "types" },
-  undeploy: { path: "./commands/cloud.js", exportName: "cloud" },
-  upgrade: { path: "./commands/upgrade.js", exportName: "upgrade" },
-  version: { path: "./commands/version.js", exportName: "version" }
-}, commandGroups = {
-  minimal: ["version", "help"],
-  development: ["dev", "build", "test", "lint"],
-  database: ["migrate", "seed", "fresh"],
-  scaffolding: ["make", "generate"],
-  deployment: ["deploy", "release", "cloud"],
-  info: ["about", "doctor", "list"]
-}, loadedRegistrars = new WeakMap;
-function loaderKey(loader) {
-  return `${loader.path}#${loader.exportName}`;
-}
-export function markLoaded(buddy, commandName) {
-  const loader = commandRegistry[commandName];
-  if (!loader)
-    return;
-  let set = loadedRegistrars.get(buddy);
-  if (!set) {
-    set = new Set;
-    loadedRegistrars.set(buddy, set);
-  }
-  set.add(loaderKey(loader));
-}
-export async function loadCommand(commandName, buddy) {
-  const loader = commandRegistry[commandName];
-  if (!loader)
-    return !1;
-  let set = loadedRegistrars.get(buddy);
-  if (!set) {
-    set = new Set;
-    loadedRegistrars.set(buddy, set);
-  }
-  const key = loaderKey(loader);
-  if (set.has(key))
-    return !0;
-  set.add(key);
-  try {
-    const commandFunction = (await import(loader.path))[loader.exportName];
-    if (typeof commandFunction === "function") {
-      commandFunction(buddy);
-      return !0;
-    } else
-      return !1;
-  } catch {
-    return !1;
-  }
-}
-export async function loadCommands(commandNames, buddy) {
-  const timeout = (ms) => new Promise((_, reject) => setTimeout(() => reject(Error("timeout")), ms)), seen = new Set, unique = [];
-  for (const name of commandNames) {
-    const loader = commandRegistry[name], key = loader ? `${loader.path}#${loader.exportName}` : `name:${name}`;
-    if (seen.has(key))
-      continue;
-    seen.add(key);
-    unique.push(name);
-  }
-  await Promise.all(unique.map(async (name) => {
-    try {
-      await Promise.race([
-        loadCommand(name, buddy),
-        timeout(5000)
-      ]);
-    } catch {}
-  }));
-}
-export async function loadCommandGroup(groupName, buddy) {
-  const commands = commandGroups[groupName];
-  if (commands)
-    await loadCommands(commands, buddy);
-}
-export async function loadAllCommands(buddy) {
-  const allCommands = Object.keys(commandRegistry);
-  await loadCommands(allCommands, buddy);
-}
-export function getCommandNames() {
-  return Object.keys(commandRegistry);
-}
-export function getCommandsToLoad(args) {
-  const requestedCommand = args[0], isVersionFlag = requestedCommand === "--version" || requestedCommand === "-v", isHelpFlag = requestedCommand === "--help" || requestedCommand === "-h", isHelpWord = requestedCommand === "help";
-  if (isVersionFlag)
-    return ["version"];
-  if (!requestedCommand || isHelpFlag || isHelpWord)
-    return Object.keys(commandRegistry);
-  const baseCommand = requestedCommand.split(":")[0];
-  if (baseCommand === "list")
-    return ["list", ...Object.keys(commandRegistry).filter((k) => k !== "list")];
-  if (commandRegistry[baseCommand])
-    return [baseCommand];
-  if (requestedCommand.includes(":")) {
-    const namespace = baseCommand;
-    if (commandRegistry[namespace])
-      return [namespace];
-  }
-  return Object.keys(commandRegistry);
-}

package/dist/migrators/index.d.ts

@@ -1,9 +0,0 @@
-import type { Driver, MigrationReport, MigrateProjectRequest } from './types';
-export type { MigrateProjectRequest, MigrationReport, ReportEntry } from './types';
-export declare function runMigrator(req: MigrateProjectRequest): Promise<MigrationReport>;
-/**
- * Render a migration report as a Markdown checklist suitable for
- * writing to `MIGRATION_REPORT.md` in the target project.
- */
-export declare function renderReport(report: MigrationReport): string;
-export declare const DRIVERS: Record<string, Driver>;

package/dist/migrators/index.js

@@ -1,62 +0,0 @@
-import { laravelDriver } from "./laravel";
-import { railsDriver } from "./rails";
-export const DRIVERS = {
-  laravel: laravelDriver,
-  rails: railsDriver
-};
-export async function runMigrator(req) {
-  const driver = DRIVERS[req.from];
-  if (!driver)
-    throw Error(`Unknown source framework: ${req.from}. Supported: ${Object.keys(DRIVERS).join(", ")}`);
-  const startedAt = new Date().toISOString(), entries = await driver.migrate(req), finishedAt = new Date().toISOString();
-  return {
-    source: req.source,
-    target: req.target,
-    from: req.from,
-    startedAt,
-    finishedAt,
-    entries
-  };
-}
-export function renderReport(report) {
-  const lines = [];
-  lines.push(`# Migration report \u2014 ${report.from} \u2192 Stacks`);
-  lines.push("");
-  lines.push(`- **Source**: \`${report.source}\``);
-  lines.push(`- **Target**: \`${report.target}\``);
-  lines.push(`- **Started**: ${report.startedAt}`);
-  lines.push(`- **Finished**: ${report.finishedAt}`);
-  lines.push("");
-  const groups = groupEntriesByStatus(report.entries);
-  for (const [status, label] of [
-    ["translated", "Translated"],
-    ["copied", "Copied verbatim"],
-    ["skipped", "Skipped (hand-port required)"],
-    ["failed", "Failed"]
-  ]) {
-    const group = groups[status] ?? [];
-    if (group.length === 0)
-      continue;
-    lines.push(`## ${label} (${group.length})`);
-    lines.push("");
-    for (const e of group) {
-      const arrow = e.target ? ` \u2192 \`${e.target}\`` : "", note = e.note ? ` \u2014 ${e.note}` : "";
-      lines.push(`- \`${e.source}\`${arrow}${note}`);
-    }
-    lines.push("");
-  }
-  lines.push("---");
-  lines.push("");
-  lines.push("Re-run `./buddy migrate:project <name> --from=" + report.from + "` after fixing the source project to refresh emitted files. Translated outputs are overwritten; skipped entries are not.");
-  return lines.join(`
-`);
-}
-function groupEntriesByStatus(entries) {
-  const out = {};
-  for (const e of entries) {
-    if (!out[e.status])
-      out[e.status] = [];
-    out[e.status].push(e);
-  }
-  return out;
-}

package/dist/migrators/laravel/index.d.ts

@@ -1,2 +0,0 @@
-import type { Driver } from '../types';
-export declare const laravelDriver: Driver;

package/dist/migrators/laravel/index.js

@@ -1,148 +0,0 @@
-import { existsSync, readdirSync } from "node:fs";
-import { copyFile, mkdir, readFile, writeFile } from "node:fs/promises";
-import { basename, join } from "node:path";
-import { laravelFilenameToStacks, parseLaravelMigration } from "./migrations";
-import { parseLaravelModel } from "./models";
-export const laravelDriver = {
-  name: "laravel",
-  async migrate(req) {
-    const entries = [];
-    entries.push(...await migrateEnv(req));
-    entries.push(...await migrateMigrations(req));
-    entries.push(...await migrateModels(req));
-    entries.push(...summariseDeferred(req));
-    return entries;
-  }
-};
-async function migrateEnv(req) {
-  const out = [];
-  for (const file of [".env", ".env.example"]) {
-    const sourcePath = join(req.source, file);
-    if (!existsSync(sourcePath))
-      continue;
-    const targetPath = join(req.target, file);
-    if (!req.dryRun) {
-      await mkdir(req.target, { recursive: !0 });
-      await copyFile(sourcePath, targetPath);
-    }
-    out.push({
-      source: file,
-      target: file,
-      status: "copied",
-      note: "Laravel-specific keys (BROADCAST_DRIVER, FILESYSTEM_DISK names) may need renaming; Stacks reads APP_*/DB_*/MAIL_* keys as-is."
-    });
-  }
-  return out;
-}
-async function migrateMigrations(req) {
-  const dir = join(req.source, "database", "migrations");
-  if (!existsSync(dir))
-    return [];
-  const files = readdirSync(dir).filter((f) => f.endsWith(".php")).sort(), targetDir = join(req.target, "database", "migrations");
-  if (!req.dryRun)
-    await mkdir(targetDir, { recursive: !0 });
-  const out = [];
-  for (let i = 0;i < files.length; i++) {
-    const file = files[i], rel = `database/migrations/${file}`;
-    try {
-      const body = await readFile(join(dir, file), "utf8"), parsed = parseLaravelMigration(body);
-      if (!parsed) {
-        out.push({
-          source: rel,
-          target: "",
-          status: "skipped",
-          note: "No `Schema::create(...)` block found (likely an alter / drop / data-only migration)."
-        });
-        continue;
-      }
-      const sequence = i + 1, outRel = `database/migrations/${laravelFilenameToStacks(file, sequence, parsed.table)}`;
-      if (!req.dryRun)
-        await writeFile(join(req.target, outRel), parsed.sql);
-      const skippedNote = parsed.skipped.length > 0 ? ` Skipped ${parsed.skipped.length} line(s) inside the create block \u2014 hand-port from the source migration.` : "";
-      out.push({
-        source: rel,
-        target: outRel,
-        status: "translated",
-        note: `CREATE TABLE \`${parsed.table}\` emitted.${skippedNote}`
-      });
-    } catch (err) {
-      out.push({
-        source: rel,
-        target: "",
-        status: "failed",
-        note: `Parse error: ${err instanceof Error ? err.message : String(err)}`
-      });
-    }
-  }
-  return out;
-}
-async function migrateModels(req) {
-  const dir = join(req.source, "app", "Models");
-  if (!existsSync(dir))
-    return [];
-  const files = readdirSync(dir).filter((f) => f.endsWith(".php")), targetDir = join(req.target, "app", "Models");
-  if (!req.dryRun)
-    await mkdir(targetDir, { recursive: !0 });
-  const out = [];
-  for (const file of files) {
-    const rel = `app/Models/${file}`;
-    try {
-      const body = await readFile(join(dir, file), "utf8"), parsed = parseLaravelModel(body);
-      if (!parsed) {
-        out.push({
-          source: rel,
-          target: "",
-          status: "skipped",
-          note: "No class declaration found."
-        });
-        continue;
-      }
-      const outRel = `app/Models/${`${parsed.className}.ts`}`;
-      if (!req.dryRun)
-        await writeFile(join(req.target, outRel), parsed.tsSource);
-      const notes = [
-        `Attributes: ${parsed.fillable.length} fillable, ${Object.keys(parsed.casts).length} cast`,
-        parsed.relationships.length > 0 ? `Relationships: ${parsed.relationships.map((r) => `${r.name}(${r.kind})`).join(", ")}` : null,
-        ...parsed.notes
-      ].filter(Boolean).join(" | ");
-      out.push({
-        source: rel,
-        target: outRel,
-        status: "translated",
-        note: notes || `Model ${parsed.className} emitted.`
-      });
-    } catch (err) {
-      out.push({
-        source: rel,
-        target: "",
-        status: "failed",
-        note: `Parse error: ${err instanceof Error ? err.message : String(err)}`
-      });
-    }
-  }
-  return out;
-}
-const DEFERRED_SURFACES = [
-  { path: "routes", note: "routes/web.php + routes/api.php \u2014 port to routes/web.ts + routes/api.ts using the Stacks router DSL." },
-  { path: "app/Http/Controllers", note: "Controllers \u2192 Stacks Actions in app/Actions/. Each controller method maps to one Action file." },
-  { path: "resources/views", note: "Blade templates \u2192 stx components in resources/views/." },
-  { path: "database/seeders", note: "Seeders \u2192 database/seeders/*.ts using Stacks SeederContract." },
-  { path: "app/Console/Commands", note: "Artisan commands \u2192 app/Commands/*.ts in your Stacks project." },
-  { path: "app/Jobs", note: "Queue jobs \u2192 app/Jobs/*.ts; pair with config/queue.ts driver settings." },
-  { path: "composer.json", note: "Dependency map \u2014 Laravel packages don't translate 1:1; the Stacks docs cover the closest @stacksjs/* equivalents." }
-];
-function summariseDeferred(req) {
-  const out = [];
-  for (const surface of DEFERRED_SURFACES) {
-    const sourcePath = join(req.source, surface.path);
-    if (!existsSync(sourcePath))
-      continue;
-    out.push({
-      source: surface.path,
-      target: "",
-      status: "skipped",
-      note: surface.note
-    });
-  }
-  return out;
-}

package/dist/migrators/laravel/migrations.d.ts

@@ -1,52 +0,0 @@
-/**
- * Parse a Laravel migration file. Returns `null` when no
- * `Schema::create(...)` block is found (e.g. drop migrations,
- * data-only migrations, alter-table migrations — those are deferred
- * to a separate emitter once the create paths land).
- */
-export declare function parseLaravelMigration(source: string): ParsedMigration | null;
-/**
- * Lift Laravel's `YYYY_MM_DD_HHMMSS_create_<table>_table.php` filename
- * into the `0000000NNN-create-<table>-table.sql` form the Stacks
- * migration runner expects. The numeric prefix preserves ordering
- * across the existing Stacks migrations directory — callers should
- * pass a `sequence` that starts above whatever's already there.
- */
-export declare function laravelFilenameToStacks(filename: string, sequence: number, table: string): string;
-/**
- * Laravel migration → Stacks SQL translator.
- *
- * Laravel migrations are PHP classes whose `up()` calls
- * `Schema::create(table, fn (Blueprint $t) => { ... })`. We don't
- * parse arbitrary PHP — we recognise the common Blueprint DSL by
- * regex and emit a CREATE TABLE statement that the Stacks runner can
- * consume.
- *
- * Strategy:
- *   1. Find the `Schema::create('table', function (...) { BODY })` block.
- *   2. Tokenise BODY line-by-line, each line a `$table->method(args)->modifier()...;` chain.
- *   3. Map the leading method to a SQLite column type.
- *   4. Translate modifiers (`->nullable()`, `->unique()`, `->default(...)`, `->index()`)
- *      into column constraints (or post-table CREATE INDEX statements).
- *
- * Anything unrecognised gets logged in the report as `// SKIPPED:` and
- * the user can hand-port it.
- */
-export declare interface ParsedMigration {
-  table: string
-  sql: string
-  skipped: string[]
-}
-declare interface Column {
-  name: string
-  type: string
-  nullable: boolean
-  unique: boolean
-  primaryKey: boolean
-  autoIncrement: boolean
-  defaultValue: string | null
-  index: boolean
-}
-declare type ParsedLine = | { kind: 'columns', columns: Column[], indexes?: { name: string, columns: string[], unique: boolean }[] }
-  | { kind: 'index', index: { name: string, columns: string[], unique: boolean } }
-  | { kind: 'skip' }