@sansavision/aurora 0.1.0-alpha.20260212.4

package/src/run.ts

@@ -0,0 +1,37 @@
+import { renderCommandHelp, renderGlobalHelp } from "./help";
+import { type CommandResult, findCommand } from "./registry";
+
+export interface RunCliOptions {
+  cwd?: string;
+}
+
+function stdout(message: string): CommandResult {
+  return { exitCode: 0, stdout: message };
+}
+
+function stderr(message: string, exitCode = 1): CommandResult {
+  return { exitCode, stderr: message };
+}
+
+export function runAuroraCli(
+  argv: ReadonlyArray<string>,
+  options: RunCliOptions = {},
+): CommandResult {
+  const [firstArg, ...restArgs] = argv;
+  const cwd = options.cwd ?? process.cwd();
+
+  if (!firstArg || firstArg === "help" || firstArg === "-h" || firstArg === "--help") {
+    return stdout(renderGlobalHelp());
+  }
+
+  const command = findCommand(firstArg);
+  if (!command) {
+    return stderr(`Unknown command: ${firstArg}\nRun \`aurora --help\` to list available commands.`);
+  }
+
+  if (restArgs.includes("--help") || restArgs.includes("-h")) {
+    return stdout(renderCommandHelp(command));
+  }
+
+  return command.run(restArgs, { cwd });
+}

package/src/start.ts

@@ -0,0 +1,56 @@
+import { resolve } from "node:path";
+
+import { type CommandContext, type CommandResult } from "./registry";
+
+interface StartBootstrapReport {
+  mode: "start";
+  cwd: string;
+  runtimeBundlePath: string;
+  url: string;
+}
+
+function parseStartArgs(args: ReadonlyArray<string>): CommandResult | undefined {
+  if (args.length === 0) {
+    return undefined;
+  }
+
+  const first = args[0];
+  return {
+    exitCode: 2,
+    stderr: `aurora start: unknown option '${first}'`,
+  };
+}
+
+function buildStartBootstrapReport(context: CommandContext): StartBootstrapReport {
+  return {
+    mode: "start",
+    cwd: context.cwd,
+    runtimeBundlePath: resolve(context.cwd, ".aurora/build/node/server.mjs"),
+    url: "http://localhost:3000",
+  };
+}
+
+function renderStartBootstrapReport(report: StartBootstrapReport): string {
+  return [
+    "aurora start bootstrap",
+    `cwd: ${report.cwd}`,
+    `runtime_bundle: ${report.runtimeBundlePath}`,
+    `url: ${report.url}`,
+  ].join("\n");
+}
+
+export function runStartCommand(
+  args: ReadonlyArray<string>,
+  context: CommandContext,
+): CommandResult {
+  const parseError = parseStartArgs(args);
+  if (parseError) {
+    return parseError;
+  }
+
+  const report = buildStartBootstrapReport(context);
+  return {
+    exitCode: 0,
+    stdout: renderStartBootstrapReport(report),
+  };
+}

package/src/test.ts

@@ -0,0 +1,289 @@
+import { resolve } from "node:path";
+
+import {
+  loadMatrixProjectConfig,
+  type MatrixBuildTarget,
+  type MatrixProjectSpec,
+  type MatrixTemplateId,
+} from "../../qa/e2e-matrix/src";
+
+import { runBuildCommand } from "./build";
+import { runCreateCommand } from "./create";
+import { type CommandContext, type CommandResult } from "./registry";
+import { runStartCommand } from "./start";
+
+type TestOutputFormat = "text" | "json";
+
+interface TestOptions {
+  template?: MatrixTemplateId;
+  format: TestOutputFormat;
+}
+
+interface MatrixBuildExecution {
+  target: MatrixBuildTarget;
+  exitCode: number;
+  stderr?: string;
+}
+
+interface MatrixStartExecution {
+  exitCode: number;
+  stderr?: string;
+}
+
+interface MatrixProjectExecution {
+  id: string;
+  template: MatrixTemplateId;
+  projectRoot: string;
+  createExitCode: number;
+  createStderr?: string;
+  builds: readonly MatrixBuildExecution[];
+  start?: MatrixStartExecution;
+  passed: boolean;
+  errors: readonly string[];
+}
+
+interface TestRunnerReport {
+  mode: "test";
+  cwd: string;
+  matrixVersion: 1;
+  templateFilter?: MatrixTemplateId;
+  projectsTotal: number;
+  projectsPassed: number;
+  projectsFailed: number;
+  durationMs: number;
+  results: readonly MatrixProjectExecution[];
+}
+
+let runCounter = 0;
+
+export function runTestCommand(
+  args: ReadonlyArray<string>,
+  context: CommandContext,
+): CommandResult {
+  const options = parseTestOptions(args);
+  if ("exitCode" in options) {
+    return options;
+  }
+
+  const matrix = loadMatrixProjectConfig();
+  const projects = options.template
+    ? matrix.projects.filter((project) => project.template === options.template)
+    : matrix.projects;
+
+  if (projects.length === 0) {
+    return {
+      exitCode: 2,
+      stderr: `aurora test: no matrix projects found for template '${options.template}'.`,
+    };
+  }
+
+  const startedAt = Date.now();
+  const results = projects.map((project) => runMatrixProject(project));
+  const projectsFailed = results.filter((result) => !result.passed).length;
+  const report: TestRunnerReport = {
+    mode: "test",
+    cwd: context.cwd,
+    matrixVersion: 1,
+    templateFilter: options.template,
+    projectsTotal: results.length,
+    projectsPassed: results.length - projectsFailed,
+    projectsFailed,
+    durationMs: Date.now() - startedAt,
+    results,
+  };
+
+  const stdout =
+    options.format === "json"
+      ? JSON.stringify(report, null, 2)
+      : renderTestRunnerReport(report);
+
+  return {
+    exitCode: projectsFailed === 0 ? 0 : 1,
+    stdout,
+  };
+}
+
+function parseTestOptions(args: ReadonlyArray<string>): TestOptions | CommandResult {
+  const options: TestOptions = {
+    format: "text",
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+
+    if (arg === "--template") {
+      const parsedTemplate = parseTemplateFilter(args[index + 1]);
+      if (typeof parsedTemplate !== "string") {
+        return parsedTemplate;
+      }
+
+      options.template = parsedTemplate;
+      index += 1;
+      continue;
+    }
+
+    if (arg === "--format") {
+      const parsedFormat = parseOutputFormat(args[index + 1]);
+      if (typeof parsedFormat !== "string") {
+        return parsedFormat;
+      }
+
+      options.format = parsedFormat;
+      index += 1;
+      continue;
+    }
+
+    return {
+      exitCode: 2,
+      stderr: `aurora test: unknown option '${arg}'`,
+    };
+  }
+
+  return options;
+}
+
+function parseTemplateFilter(
+  value: string | undefined,
+): MatrixTemplateId | CommandResult {
+  if (!value) {
+    return {
+      exitCode: 2,
+      stderr:
+        "aurora test: --template requires one of 'basic', 'saas', 'blog', or 'dashboard'",
+    };
+  }
+
+  if (value === "basic" || value === "saas" || value === "blog" || value === "dashboard") {
+    return value;
+  }
+
+  return {
+    exitCode: 2,
+    stderr:
+      `aurora test: invalid template '${value}'. Expected basic, saas, blog, or dashboard`,
+  };
+}
+
+function parseOutputFormat(value: string | undefined): TestOutputFormat | CommandResult {
+  if (!value) {
+    return {
+      exitCode: 2,
+      stderr: "aurora test: --format requires 'text' or 'json'",
+    };
+  }
+
+  if (value === "text" || value === "json") {
+    return value;
+  }
+
+  return {
+    exitCode: 2,
+    stderr: `aurora test: invalid format '${value}'. Expected 'text' or 'json'`,
+  };
+}
+
+function runMatrixProject(project: MatrixProjectSpec): MatrixProjectExecution {
+  runCounter += 1;
+
+  const projectName = `${project.id}-matrix-${Date.now()}-${runCounter}`;
+  const matrixRoot = resolve("/tmp", `aurora-cli-test-${projectName}`);
+
+  const createResult = runCreateCommand(
+    [projectName, "--template", project.template],
+    { cwd: matrixRoot },
+  );
+  const projectRoot = resolve(matrixRoot, projectName);
+
+  const errors: string[] = [];
+
+  if (createResult.exitCode !== 0) {
+    errors.push(createResult.stderr ?? "create command failed");
+  }
+
+  const builds: MatrixBuildExecution[] = [];
+  if (createResult.exitCode === 0) {
+    for (const target of project.buildTargets) {
+      const buildResult = runBuildCommand(["--target", target], {
+        cwd: projectRoot,
+      });
+
+      builds.push({
+        target,
+        exitCode: buildResult.exitCode,
+        stderr: buildResult.stderr,
+      });
+
+      if (buildResult.exitCode !== 0) {
+        errors.push(buildResult.stderr ?? `build failed for target ${target}`);
+      }
+    }
+  }
+
+  let start: MatrixStartExecution | undefined;
+  if (createResult.exitCode === 0 && project.runStart) {
+    const startResult = runStartCommand([], {
+      cwd: projectRoot,
+    });
+
+    start = {
+      exitCode: startResult.exitCode,
+      stderr: startResult.stderr,
+    };
+
+    if (startResult.exitCode !== 0) {
+      errors.push(startResult.stderr ?? "start command failed");
+    }
+  }
+
+  return {
+    id: project.id,
+    template: project.template,
+    projectRoot,
+    createExitCode: createResult.exitCode,
+    createStderr: createResult.stderr,
+    builds,
+    start,
+    passed: errors.length === 0,
+    errors,
+  };
+}
+
+function renderTestRunnerReport(report: TestRunnerReport): string {
+  const templates = report.templateFilter
+    ? report.templateFilter
+    : report.results.map((result) => result.template).join(", ");
+
+  const lines: string[] = [
+    "aurora test integration runner",
+    `cwd: ${report.cwd}`,
+    `matrix_version: ${report.matrixVersion}`,
+    `templates: ${templates}`,
+    `projects_total: ${report.projectsTotal}`,
+    `projects_passed: ${report.projectsPassed}`,
+    `projects_failed: ${report.projectsFailed}`,
+    `duration_ms: ${report.durationMs}`,
+    "results:",
+  ];
+
+  for (const result of report.results) {
+    lines.push(`- ${result.id} (${result.template}): ${result.passed ? "PASS" : "FAIL"}`);
+
+    for (const build of result.builds) {
+      lines.push(
+        `  build ${build.target}: ${build.exitCode === 0 ? "PASS" : `FAIL (${build.exitCode})`}`,
+      );
+    }
+
+    if (result.start) {
+      lines.push(
+        `  start: ${result.start.exitCode === 0 ? "PASS" : `FAIL (${result.start.exitCode})`}`,
+      );
+    }
+
+    for (const error of result.errors) {
+      lines.push(`  error: ${error}`);
+    }
+  }
+
+  return lines.join("\n");
+}

package/templates/basic/README.md

@@ -0,0 +1,16 @@
+# __AURORA_APP_NAME__
+
+Aurora basic starter template.
+
+Includes:
+
+- file-based route example
+- server query example
+- server action example
+- auth seam stub for local development
+
+## Commands
+
+- `aurora dev`
+- `aurora build`
+- `aurora start`

package/templates/basic/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "__AURORA_APP_NAME__",
+  "private": true,
+  "scripts": {
+    "dev": "aurora dev",
+    "build": "aurora build",
+    "start": "aurora start",
+    "test": "aurora test"
+  }
+}

package/templates/basic/src/actions/createMessage.action.server.ts

@@ -0,0 +1,22 @@
+import { requireUser } from "../lib/auth.server";
+
+export interface CreateMessageInput {
+  text: string;
+}
+
+export interface MessageRecord {
+  id: string;
+  text: string;
+  authorId: string;
+  createdAt: number;
+}
+
+export async function createMessage(input: CreateMessageInput): Promise<MessageRecord> {
+  const user = await requireUser();
+  return {
+    id: `msg-${Date.now()}`,
+    text: input.text,
+    authorId: user.id,
+    createdAt: Date.now(),
+  };
+}

package/templates/basic/src/lib/auth.server.ts

@@ -0,0 +1,11 @@
+export interface AuthUser {
+  id: string;
+  role: "admin" | "user";
+}
+
+export async function requireUser(): Promise<AuthUser> {
+  return {
+    id: "demo-user",
+    role: "admin",
+  };
+}

package/templates/basic/src/queries/listMessages.server.ts

@@ -0,0 +1,17 @@
+export interface MessageListItem {
+  id: string;
+  text: string;
+  createdAt: number;
+}
+
+const seed: MessageListItem[] = [
+  {
+    id: "seed-1",
+    text: "Welcome to Aurora basic starter.",
+    createdAt: 1707609600000,
+  },
+];
+
+export async function listMessages(): Promise<MessageListItem[]> {
+  return seed;
+}

package/templates/basic/src/routes/index.tsx

@@ -0,0 +1,12 @@
+import { createMessage } from "../actions/createMessage.action.server";
+import { listMessages } from "../queries/listMessages.server";
+
+export async function HomePage(): Promise<string> {
+  const messages = await listMessages();
+
+  if (messages.length === 0) {
+    await createMessage({ text: "Hello from Aurora basic starter." });
+  }
+
+  return `<main><h1>Aurora Basic Starter</h1><p>messages: ${messages.length}</p></main>`;
+}

package/templates/blog/README.md

@@ -0,0 +1,17 @@
+# __AURORA_APP_NAME__
+
+Aurora blog starter template.
+
+Includes:
+
+- static-friendly blog list/detail route seams
+- markdown content examples
+- SEO metadata helper seam
+- default social preview asset
+
+## Commands
+
+- `aurora dev`
+- `aurora build --target static`
+- `aurora build --target node`
+- `aurora start`

package/templates/blog/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "__AURORA_APP_NAME__",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "aurora dev",
+    "build": "aurora build --target static",
+    "build:node": "aurora build --target node",
+    "start": "aurora start",
+    "test": "aurora test"
+  }
+}

package/templates/blog/public/assets/og-default.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 630" role="img" aria-label="Aurora Blog">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#0f172a"/>
+      <stop offset="100%" stop-color="#1d4ed8"/>
+    </linearGradient>
+  </defs>
+  <rect width="1200" height="630" fill="url(#bg)"/>
+  <circle cx="150" cy="150" r="90" fill="#38bdf8" opacity="0.25"/>
+  <circle cx="1050" cy="520" r="110" fill="#22c55e" opacity="0.2"/>
+  <text x="96" y="320" font-family="ui-monospace, Menlo, Monaco, Consolas, monospace" font-size="76" fill="#e2e8f0">
+    Aurora Blog Starter
+  </text>
+  <text x="96" y="390" font-family="ui-monospace, Menlo, Monaco, Consolas, monospace" font-size="36" fill="#bfdbfe">
+    static + markdown + seo
+  </text>
+</svg>

package/templates/blog/src/content/loadPosts.server.ts

@@ -0,0 +1,22 @@
+export interface BlogPostSummary {
+  slug: string;
+  title: string;
+  description: string;
+}
+
+const seedPosts: BlogPostSummary[] = [
+  {
+    slug: "hello-world",
+    title: "Hello Aurora Blog",
+    description: "First post in the Aurora blog starter.",
+  },
+  {
+    slug: "release-notes",
+    title: "Release Notes Template",
+    description: "Example changelog-style post.",
+  },
+];
+
+export async function loadPosts(): Promise<BlogPostSummary[]> {
+  return seedPosts;
+}

package/templates/blog/src/content/posts/hello-world.md

@@ -0,0 +1,11 @@
+---
+title: Hello Aurora Blog
+slug: hello-world
+description: First post in the Aurora blog starter.
+---
+
+# Hello Aurora
+
+Welcome to the Aurora blog starter.
+
+This markdown file is part of the static content seed set.

package/templates/blog/src/content/posts/release-notes.md

@@ -0,0 +1,9 @@
+---
+title: Release Notes Template
+slug: release-notes
+description: Example changelog-style post.
+---
+
+# Release Notes
+
+Use this post as a baseline for changelog and release-note pages.

package/templates/blog/src/routes/index.tsx

@@ -0,0 +1,22 @@
+import { loadPosts } from "../content/loadPosts.server";
+import { buildSeoMeta } from "../seo/meta";
+
+export async function HomePage(): Promise<string> {
+  const posts = await loadPosts();
+  const meta = buildSeoMeta({
+    title: "Aurora Blog",
+    description: "Static-friendly Aurora blog starter.",
+    canonicalPath: "/",
+  });
+
+  return [
+    "<main>",
+    `<h1>${meta.title}</h1>`,
+    "<ul>",
+    ...posts.map(
+      (post) => `<li><a href="/posts/${post.slug}">${post.title}</a> - ${post.description}</li>`,
+    ),
+    "</ul>",
+    "</main>",
+  ].join("");
+}

package/templates/blog/src/routes/posts/[slug].tsx

@@ -0,0 +1,19 @@
+import { loadPosts } from "../../content/loadPosts.server";
+import { buildSeoMeta } from "../../seo/meta";
+
+export async function BlogPostPage(slug: string): Promise<string> {
+  const posts = await loadPosts();
+  const post = posts.find((entry) => entry.slug === slug);
+
+  if (!post) {
+    return "<main><h1>Post not found</h1></main>";
+  }
+
+  const meta = buildSeoMeta({
+    title: post.title,
+    description: post.description,
+    canonicalPath: `/posts/${post.slug}`,
+  });
+
+  return `<main><h1>${meta.title}</h1><p>${post.description}</p></main>`;
+}

package/templates/blog/src/seo/meta.ts

@@ -0,0 +1,19 @@
+export interface SeoMetaInput {
+  title: string;
+  description: string;
+  canonicalPath: string;
+}
+
+export function buildSeoMeta(input: SeoMetaInput): {
+  title: string;
+  description: string;
+  canonicalUrl: string;
+  openGraphImage: string;
+} {
+  return {
+    title: input.title,
+    description: input.description,
+    canonicalUrl: `https://example.com${input.canonicalPath}`,
+    openGraphImage: "/assets/og-default.svg",
+  };
+}

package/templates/dashboard/README.md

@@ -0,0 +1,18 @@
+# __AURORA_APP_NAME__
+
+Template: dashboard
+
+Aurora dashboard starter template.
+
+Includes:
+
+- metrics query for dashboard cards/charts
+- data-grid style table projection
+- realtime subscription seam for dashboard refresh
+- action seam for acknowledging alerts
+
+## Commands
+
+- `aurora dev`
+- `aurora build`
+- `aurora start`

package/templates/dashboard/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "__AURORA_APP_NAME__",
+  "private": true,
+  "scripts": {
+    "dev": "aurora dev",
+    "build": "aurora build",
+    "start": "aurora start",
+    "test": "aurora test"
+  }
+}

package/templates/dashboard/src/actions/acknowledgeAlert.action.server.ts

@@ -0,0 +1,6 @@
+export async function acknowledgeAlert(alertId: string): Promise<{ ok: true; id: string }> {
+  return {
+    ok: true,
+    id: alertId,
+  };
+}