@sansavision/aurora 0.1.0-alpha.20260212.4

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

@@ -0,0 +1,134 @@
+import { readSessionToken, writeSessionToken } from "../mobile/auth/session-handoff.client";
+import { createMobileApiClient } from "../mobile/generated/mobile-api-sdk";
+import { createHttpMobileTransport } from "../mobile/transport/mobile-api-transport.client";
+
+export async function HomePage(): Promise<string> {
+  const existingToken = readSessionToken();
+  if (!existingToken) {
+    writeSessionToken("mobile-demo-token", Date.now() + 1000 * 60 * 30);
+  }
+
+  const transport = createHttpMobileTransport({
+    baseUrl: "https://mobile.local.test",
+    retries: 2,
+    retryDelayMs: 10,
+    fetchImpl: createMockMobileFetch(),
+  });
+  const client = createMobileApiClient(transport);
+
+  try {
+    const messages = await client.queries["messages.list"]({
+      cursor: null,
+      limit: 20,
+    });
+
+    if (messages.items.length === 0) {
+      await client.actions["messages.create"]({
+        text: "Hello from Aurora mobile starter.",
+      });
+    }
+
+    return [
+      "<main>",
+      "<h1>Aurora Mobile Companion Starter</h1>",
+      `<p>message_count: ${messages.items.length}</p>`,
+      "<p>network_retry_policy: exponential backoff</p>",
+      "</main>",
+    ].join("");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "unknown mobile error";
+
+    return [
+      "<main>",
+      "<h1>Aurora Mobile Companion Starter</h1>",
+      `<p>sync_status: degraded</p>`,
+      `<p>error: ${message}</p>`,
+      "<p>retry_hint: check connectivity and retry queued operations.</p>",
+      "</main>",
+    ].join("");
+  }
+}
+
+function createMockMobileFetch(): typeof fetch {
+  const attempts = new Map<string, number>();
+
+  return async (_input, init): Promise<Response> => {
+    const rawBody = typeof init?.body === "string" ? init.body : "{}";
+    const payload = JSON.parse(rawBody) as {
+      operation?: string;
+      name?: string;
+      input?: {
+        text?: string;
+      };
+      params?: {
+        cursor?: string | null;
+        limit?: number;
+      };
+    };
+
+    const operation = payload.operation ?? "unknown";
+    const name = payload.name ?? "unknown";
+    const key = `${operation}:${name}`;
+    const attempt = (attempts.get(key) ?? 0) + 1;
+    attempts.set(key, attempt);
+
+    if (attempt === 1) {
+      throw new Error("simulated transient network error");
+    }
+
+    if (operation === "query" && name === "messages.list") {
+      return new Response(
+        JSON.stringify({
+          data: {
+            items: [
+              {
+                id: "seed-1",
+                text: "Welcome to Aurora mobile starter.",
+                createdAt: 1707609600000,
+              },
+            ],
+            nextCursor: null,
+          },
+          tags: ["messages"],
+        }),
+        {
+          status: 200,
+          headers: {
+            "content-type": "application/json",
+          },
+        },
+      );
+    }
+
+    if (operation === "action" && name === "messages.create") {
+      return new Response(
+        JSON.stringify({
+          data: {
+            id: "msg-1",
+            text: payload.input?.text ?? "",
+            createdAt: Date.now(),
+          },
+          tags: ["messages"],
+        }),
+        {
+          status: 200,
+          headers: {
+            "content-type": "application/json",
+          },
+        },
+      );
+    }
+
+    return new Response(
+      JSON.stringify({
+        error: "unknown mobile operation",
+      }),
+      {
+        status: 404,
+        headers: {
+          "content-type": "application/json",
+        },
+      },
+    );
+  };
+}

package/templates/monorepo/README.md

@@ -0,0 +1,18 @@
+# __AURORA_APP_NAME__
+
+Template: monorepo
+
+Aurora monorepo starter template.
+
+Includes:
+
+- workspace root with shared scripts
+- `apps/web` application package
+- `packages/ui` shared UI package
+- `packages/shared` shared utilities/types package
+
+## Commands
+
+- `bun run dev`
+- `bun run build`
+- `bun run start`

package/templates/monorepo/apps/web/package.json

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

package/templates/monorepo/apps/web/src/routes/index.tsx

@@ -0,0 +1 @@
+export const HomePage = () => "<main>Aurora monorepo starter web app.</main>";

package/templates/monorepo/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "__AURORA_APP_NAME__",
+  "private": true,
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ],
+  "scripts": {
+    "dev": "bun run --cwd apps/web aurora dev",
+    "build": "bun run --cwd apps/web aurora build",
+    "start": "bun run --cwd apps/web aurora start"
+  }
+}

package/templates/monorepo/packages/shared/README.md

@@ -0,0 +1,3 @@
+# Shared Package
+
+Shared types and utilities used by workspace apps/packages.

package/templates/monorepo/packages/ui/README.md

@@ -0,0 +1,3 @@
+# UI Package
+
+Shared UI components and styling primitives for Aurora apps.

package/templates/saas/README.md

@@ -0,0 +1,17 @@
+# __AURORA_APP_NAME__
+
+Aurora SaaS starter template.
+
+Includes:
+
+- session/auth seam
+- billing checkout seam
+- admin dashboard query
+- realtime notifications publisher/subscriber seam
+- transactional email seam
+
+## Commands
+
+- `aurora dev`
+- `aurora build`
+- `aurora start`

package/templates/saas/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/saas/src/admin/getDashboard.server.ts

@@ -0,0 +1,18 @@
+export interface DashboardSummary {
+  projectCount: number;
+  activeSeats: number;
+}
+
+export async function getAdminDashboard(ownerId: string): Promise<DashboardSummary> {
+  if (!ownerId) {
+    return {
+      projectCount: 0,
+      activeSeats: 0,
+    };
+  }
+
+  return {
+    projectCount: 3,
+    activeSeats: 12,
+  };
+}

package/templates/saas/src/auth/session.server.ts

@@ -0,0 +1,13 @@
+export interface SessionUser {
+  id: string;
+  email: string;
+  role: "owner" | "member";
+}
+
+export async function getSessionUser(): Promise<SessionUser> {
+  return {
+    id: "owner-1",
+    email: "owner@example.com",
+    role: "owner",
+  };
+}

package/templates/saas/src/billing/checkout.server.ts

@@ -0,0 +1,11 @@
+export interface CheckoutSession {
+  id: string;
+  checkoutUrl: string;
+}
+
+export async function createCheckoutSession(userId: string): Promise<CheckoutSession> {
+  return {
+    id: `checkout-${userId}`,
+    checkoutUrl: `https://billing.local/checkout/${userId}`,
+  };
+}

package/templates/saas/src/email/sendWelcome.server.ts

@@ -0,0 +1,8 @@
+export interface WelcomeEmailInput {
+  userId: string;
+  email: string;
+}
+
+export async function sendWelcomeEmail(input: WelcomeEmailInput): Promise<void> {
+  void input;
+}

package/templates/saas/src/realtime/notifications.server.ts

@@ -0,0 +1,8 @@
+export interface NotificationPayload {
+  userId: string;
+  message: string;
+}
+
+export async function publishNotification(payload: NotificationPayload): Promise<void> {
+  void payload;
+}

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

@@ -0,0 +1,20 @@
+import { getAdminDashboard } from "../admin/getDashboard.server";
+import { createCheckoutSession } from "../billing/checkout.server";
+import { sendWelcomeEmail } from "../email/sendWelcome.server";
+import { publishNotification } from "../realtime/notifications.server";
+import { getSessionUser } from "../auth/session.server";
+
+export async function HomePage(): Promise<string> {
+  const user = await getSessionUser();
+  const dashboard = await getAdminDashboard(user.id);
+
+  await sendWelcomeEmail({ userId: user.id, email: user.email });
+  await publishNotification({
+    userId: user.id,
+    message: "Welcome to Aurora SaaS starter",
+  });
+
+  const checkout = await createCheckoutSession(user.id);
+
+  return `<main><h1>Aurora SaaS Starter</h1><p>projects: ${dashboard.projectCount}</p><p>checkout: ${checkout.checkoutUrl}</p></main>`;
+}

package/test/ai.test.ts

@@ -0,0 +1,94 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+
+import { describe, expect, it } from "bun:test";
+
+import { runAuroraCli } from "../src";
+
+let tempCounter = 1;
+
+function uniqueTempPath(suffix: string): string {
+  tempCounter += 1;
+  return `/tmp/aurora-cli-ai-${suffix}-${Date.now()}-${tempCounter}`;
+}
+
+describe("aurora ai", () => {
+  it("infers scaffold plan in dry-run JSON mode", () => {
+    const cwd = uniqueTempPath("dry-run");
+    mkdirSync(cwd, { recursive: true });
+
+    const result = runAuroraCli(
+      [
+        "ai",
+        "add",
+        "a",
+        "guestbook",
+        "feature",
+        "with",
+        "reactions",
+        "and",
+        "moderation",
+        "--dry-run",
+        "--format",
+        "json",
+      ],
+      { cwd },
+    );
+
+    expect(result.exitCode).toBe(0);
+
+    const parsed = JSON.parse(result.stdout ?? "{}") as {
+      mode?: string;
+      dryRun?: boolean;
+      inferred?: {
+        featureSlug?: string;
+        routeKind?: string;
+        routeDataSource?: string;
+        routeAuth?: string;
+      };
+      diagnostics?: Array<{ code?: string }>;
+    };
+
+    expect(parsed.mode).toBe("ai");
+    expect(parsed.dryRun).toBe(true);
+    expect(parsed.inferred?.featureSlug).toBe("guestbook-reactions-moderation");
+    expect(parsed.inferred?.routeKind).toBe("crud");
+    expect(parsed.inferred?.routeDataSource).toBe("database");
+    expect(parsed.inferred?.routeAuth).toBe("admin");
+    expect(parsed.diagnostics?.length).toBe(0);
+  });
+
+  it("executes create-feature scaffold when not in dry-run mode", () => {
+    const cwd = uniqueTempPath("scaffold");
+    mkdirSync(cwd, { recursive: true });
+
+    const result = runAuroraCli(["ai", "guestbook", "moderation"], { cwd });
+
+    expect(result.exitCode).toBe(0);
+    expect(result.stdout).toContain("aurora ai bootstrap");
+    expect(result.stdout).toContain("scaffold_output:");
+    expect(existsSync(join(cwd, "src/features/guestbook-moderation"))).toBe(true);
+    expect(existsSync(join(cwd, "src/routes/guestbook-moderation/page.tsx"))).toBe(true);
+  });
+
+  it("returns AI-readable diagnostic when prompt is underspecified", () => {
+    const cwd = uniqueTempPath("underspecified");
+    mkdirSync(cwd, { recursive: true });
+
+    const result = runAuroraCli(["ai", "build", "feature", "--dry-run", "--format", "json"], {
+      cwd,
+    });
+
+    expect(result.exitCode).toBe(0);
+
+    const parsed = JSON.parse(result.stdout ?? "{}") as {
+      inferred?: { featureSlug?: string };
+      diagnostics?: Array<{ code?: string; why?: string; howToFix?: string }>;
+    };
+
+    expect(parsed.inferred?.featureSlug).toBe("ai-feature");
+    expect(parsed.diagnostics?.some((issue) => issue.code === "AI_PROMPT_UNDERSPECIFIED")).toBe(true);
+    expect(parsed.diagnostics?.every((issue) => Boolean(issue.why))).toBe(true);
+    expect(parsed.diagnostics?.every((issue) => Boolean(issue.howToFix))).toBe(true);
+  });
+});