@rudderhq/server 0.6.6-canary.8 → 0.7.0

package/skills/app-builder/assets/scaffold/components/ui/card.tsx

@@ -0,0 +1,19 @@
+import { cn } from "@/lib/utils";
+import * as React from "react";
+
+export function Card({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return (
+    <section
+      className={cn("rounded-xl border bg-[var(--card)] text-[var(--card-foreground)] shadow-sm", className)}
+      {...props}
+    />
+  );
+}
+
+export function CardHeader({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return <div className={cn("border-b px-5 py-4", className)} {...props} />;
+}
+
+export function CardContent({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return <div className={cn("p-5", className)} {...props} />;
+}

package/skills/app-builder/assets/scaffold/components/ui/input.tsx

@@ -0,0 +1,17 @@
+import { cn } from "@/lib/utils";
+import * as React from "react";
+
+export const Input = React.forwardRef<HTMLInputElement, React.ComponentProps<"input">>(
+  ({ className, type, ...props }, ref) => (
+    <input
+      ref={ref}
+      type={type}
+      className={cn(
+        "flex h-10 w-full rounded-lg border bg-white px-3 py-2 text-sm outline-none placeholder:text-[var(--muted-foreground)] focus:ring-2 focus:ring-[var(--ring)] disabled:opacity-50",
+        className,
+      )}
+      {...props}
+    />
+  ),
+);
+Input.displayName = "Input";

package/skills/app-builder/assets/scaffold/components/ui/label.tsx

@@ -0,0 +1,6 @@
+import { cn } from "@/lib/utils";
+import * as React from "react";
+
+export function Label({ className, ...props }: React.LabelHTMLAttributes<HTMLLabelElement>) {
+  return <label className={cn("text-sm font-medium", className)} {...props} />;
+}

package/skills/app-builder/assets/scaffold/data/.gitkeep

@@ -0,0 +1 @@
+

package/skills/app-builder/assets/scaffold/drizzle.config.ts

@@ -0,0 +1,18 @@
+import { defineConfig } from "drizzle-kit";
+import path from "node:path";
+
+const dataDir = process.env.RUDDER_APP_DATA_DIR
+  ? path.resolve(process.env.RUDDER_APP_DATA_DIR)
+  : path.resolve("data");
+const mode = process.env.RUDDER_APP_DATA_MODE === "production"
+  ? "app.sqlite"
+  : "dev.sqlite";
+
+export default defineConfig({
+  dialect: "sqlite",
+  schema: "./lib/db/schema.ts",
+  out: "./migrations",
+  dbCredentials: {
+    url: path.join(dataDir, mode),
+  },
+});

package/skills/app-builder/assets/scaffold/instrumentation.ts

@@ -0,0 +1,5 @@
+export async function register() {
+  if (process.env.NEXT_RUNTIME !== "nodejs") return;
+  const { startJobRunner } = await import("@/lib/jobs/runner");
+  startJobRunner();
+}

package/skills/app-builder/assets/scaffold/lib/data-transfer.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { contactStatusSchema } from "./domain";
+
+export const exportedContactSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string().min(1).max(120),
+  email: z.email().max(320),
+  company: z.string().max(160),
+  status: contactStatusSchema,
+  createdAt: z.iso.datetime(),
+  updatedAt: z.iso.datetime(),
+});
+
+export const importEnvelopeSchema = z.object({
+  format: z.literal("rudder-app-data/v1"),
+  exportedAt: z.iso.datetime(),
+  data: z.object({
+    contacts: z.array(exportedContactSchema).max(100_000),
+  }),
+}).strict();
+
+type ContactRow = {
+  id: string;
+  name: string;
+  email: string;
+  company: string;
+  status: "new" | "contacted" | "replied" | "paused";
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+export function buildExportEnvelope(rows: ContactRow[]) {
+  return {
+    format: "rudder-app-data/v1" as const,
+    exportedAt: new Date().toISOString(),
+    data: {
+      contacts: rows.map((row) => ({
+        ...row,
+        createdAt: row.createdAt.toISOString(),
+        updatedAt: row.updatedAt.toISOString(),
+      })),
+    },
+  };
+}

package/skills/app-builder/assets/scaffold/lib/db/client.ts

@@ -0,0 +1,78 @@
+import {
+  drizzle,
+  type SqliteRemoteDatabase,
+} from "drizzle-orm/sqlite-proxy";
+import { mkdirSync } from "node:fs";
+import path from "node:path";
+import { DatabaseSync, type SQLInputValue } from "node:sqlite";
+import * as schema from "./schema";
+
+type DatabaseHandle = {
+  sqlite: DatabaseSync;
+  db: SqliteRemoteDatabase<typeof schema>;
+  filePath: string;
+};
+
+const handles = new Map<string, DatabaseHandle>();
+
+export function dataMode() {
+  return process.env.RUDDER_APP_DATA_MODE === "production"
+    ? "production"
+    : "development";
+}
+
+export function dataDirectory() {
+  return process.env.RUDDER_APP_DATA_DIR
+    ? path.resolve(process.env.RUDDER_APP_DATA_DIR)
+    : path.resolve("data");
+}
+
+export function databasePath() {
+  if (process.env.RUDDER_APP_DATA_DIR) {
+    return path.join(
+      dataDirectory(),
+      dataMode() === "production" ? "app.sqlite" : "dev.sqlite",
+    );
+  }
+  return path.join(
+    dataDirectory(),
+    dataMode() === "production" ? "production/app.sqlite" : "development/dev.sqlite",
+  );
+}
+
+export function getDatabase(): DatabaseHandle {
+  const filePath = databasePath();
+  const cached = handles.get(filePath);
+  if (cached) return cached;
+
+  mkdirSync(path.dirname(filePath), { recursive: true });
+  const sqlite = new DatabaseSync(filePath);
+  sqlite.exec("PRAGMA journal_mode = WAL");
+  sqlite.exec("PRAGMA foreign_keys = ON");
+  sqlite.exec("PRAGMA busy_timeout = 5000");
+  const db = drizzle(async (query, parameters, method): Promise<{ rows: unknown[] }> => {
+    const statement = sqlite.prepare(query);
+    statement.setReturnArrays(true);
+    const values = parameters as SQLInputValue[];
+    if (method === "run") {
+      statement.run(...values);
+      return { rows: [] };
+    }
+    if (method === "get") {
+      return { rows: statement.get(...values) as unknown as unknown[] };
+    }
+    return { rows: statement.all(...values) as unknown as unknown[][] };
+  }, { schema });
+  const handle: DatabaseHandle = {
+    sqlite,
+    db,
+    filePath,
+  };
+  handles.set(filePath, handle);
+  return handle;
+}
+
+export function closeDatabases() {
+  for (const handle of handles.values()) handle.sqlite.close();
+  handles.clear();
+}

package/skills/app-builder/assets/scaffold/lib/db/schema.ts

@@ -0,0 +1,35 @@
+import { integer, sqliteTable, text, uniqueIndex } from "drizzle-orm/sqlite-core";
+
+export const contacts = sqliteTable("contacts", {
+  id: text("id").primaryKey(),
+  name: text("name").notNull(),
+  email: text("email").notNull(),
+  company: text("company").notNull().default(""),
+  status: text("status", { enum: ["new", "contacted", "replied", "paused"] })
+    .notNull()
+    .default("new"),
+  createdAt: integer("created_at", { mode: "timestamp_ms" }).notNull(),
+  updatedAt: integer("updated_at", { mode: "timestamp_ms" }).notNull(),
+}, (table) => [
+  uniqueIndex("contacts_email_uq").on(table.email),
+]);
+
+export const jobs = sqliteTable("jobs", {
+  id: text("id").primaryKey(),
+  kind: text("kind").notNull(),
+  idempotencyKey: text("idempotency_key").notNull(),
+  payloadJson: text("payload_json").notNull().default("{}"),
+  status: text("status", { enum: ["pending", "running", "completed", "failed", "missed"] })
+    .notNull()
+    .default("pending"),
+  catchUpPolicy: text("catch_up_policy", { enum: ["run", "skip", "prompt"] })
+    .notNull()
+    .default("prompt"),
+  scheduledFor: integer("scheduled_for", { mode: "timestamp_ms" }).notNull(),
+  attempts: integer("attempts").notNull().default(0),
+  lastError: text("last_error"),
+  createdAt: integer("created_at", { mode: "timestamp_ms" }).notNull(),
+  updatedAt: integer("updated_at", { mode: "timestamp_ms" }).notNull(),
+}, (table) => [
+  uniqueIndex("jobs_idempotency_key_uq").on(table.idempotencyKey),
+]);

package/skills/app-builder/assets/scaffold/lib/domain.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+
+export const contactStatusSchema = z.enum(["new", "contacted", "replied", "paused"]);
+
+export const contactCreateSchema = z.object({
+  name: z.string().trim().min(1).max(120),
+  email: z.email().max(320),
+  company: z.string().trim().max(160).default(""),
+  status: contactStatusSchema.default("new"),
+});
+
+export const contactUpdateSchema = contactCreateSchema.partial().refine(
+  (value) => Object.keys(value).length > 0,
+  "At least one contact field is required",
+);
+
+export type ContactInput = z.infer<typeof contactCreateSchema>;
+export type ContactStatus = z.infer<typeof contactStatusSchema>;

package/skills/app-builder/assets/scaffold/lib/jobs/runner.ts

@@ -0,0 +1,56 @@
+import { getDatabase } from "@/lib/db/client";
+
+type RunnerState = {
+  timer: NodeJS.Timeout | null;
+  ticking: boolean;
+};
+
+const globalState = globalThis as typeof globalThis & {
+  __rudderAppJobRunner?: RunnerState;
+};
+
+function state(): RunnerState {
+  globalState.__rudderAppJobRunner ??= { timer: null, ticking: false };
+  return globalState.__rudderAppJobRunner;
+}
+
+async function tick() {
+  const current = state();
+  if (current.ticking) return;
+  current.ticking = true;
+  try {
+    const { sqlite } = getDatabase();
+    const now = Date.now();
+    sqlite.prepare(`
+      update jobs
+      set status = case catch_up_policy
+        when 'skip' then 'missed'
+        when 'run' then 'pending'
+        else 'missed'
+      end,
+      updated_at = ?
+      where status = 'pending' and scheduled_for < ?
+    `).run(now, now - 60_000);
+    // Domain-specific handlers should claim one pending job transactionally,
+    // execute it with the persisted idempotency key, and then complete/fail it.
+  } catch {
+    // The health endpoint remains authoritative. A missing pre-migration table
+    // must not create an unhandled background rejection during startup.
+  } finally {
+    current.ticking = false;
+  }
+}
+
+export function startJobRunner() {
+  const current = state();
+  if (current.timer) return;
+  current.timer = setInterval(() => void tick(), 15_000);
+  current.timer.unref();
+  void tick();
+}
+
+export function stopJobRunner() {
+  const current = state();
+  if (current.timer) clearInterval(current.timer);
+  current.timer = null;
+}

package/skills/app-builder/assets/scaffold/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/skills/app-builder/assets/scaffold/migrations/0000_app_builder_foundation.sql

@@ -0,0 +1,27 @@
+CREATE TABLE `contacts` (
+  `id` text PRIMARY KEY NOT NULL,
+  `name` text NOT NULL,
+  `email` text NOT NULL,
+  `company` text DEFAULT '' NOT NULL,
+  `status` text DEFAULT 'new' NOT NULL,
+  `created_at` integer NOT NULL,
+  `updated_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `contacts_email_uq` ON `contacts` (`email`);
+--> statement-breakpoint
+CREATE TABLE `jobs` (
+  `id` text PRIMARY KEY NOT NULL,
+  `kind` text NOT NULL,
+  `idempotency_key` text NOT NULL,
+  `payload_json` text DEFAULT '{}' NOT NULL,
+  `status` text DEFAULT 'pending' NOT NULL,
+  `catch_up_policy` text DEFAULT 'prompt' NOT NULL,
+  `scheduled_for` integer NOT NULL,
+  `attempts` integer DEFAULT 0 NOT NULL,
+  `last_error` text,
+  `created_at` integer NOT NULL,
+  `updated_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `jobs_idempotency_key_uq` ON `jobs` (`idempotency_key`);

package/skills/app-builder/assets/scaffold/migrations/meta/_journal.json

@@ -0,0 +1,13 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "6",
+      "when": 1785312000000,
+      "tag": "0000_app_builder_foundation",
+      "breakpoints": true
+    }
+  ]
+}

package/skills/app-builder/assets/scaffold/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/dev/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/skills/app-builder/assets/scaffold/next.config.ts

@@ -0,0 +1,8 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  output: "standalone",
+  poweredByHeader: false,
+};
+
+export default nextConfig;

package/skills/app-builder/assets/scaffold/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "rudder-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "scripts": {
+    "dev": "next dev --hostname 127.0.0.1",
+    "build": "next build",
+    "start": "next start --hostname 127.0.0.1",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:e2e": "playwright test",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "tsx scripts/migrate.ts",
+    "db:seed": "tsx scripts/seed.ts",
+    "data:snapshot": "tsx scripts/snapshot.ts",
+    "verify": "tsc --noEmit && vitest run && next build",
+    "predev": "tsx scripts/migrate.ts && tsx scripts/seed.ts"
+  },
+  "dependencies": {
+    "@radix-ui/react-slot": "1.2.4",
+    "class-variance-authority": "0.7.1",
+    "clsx": "2.1.1",
+    "drizzle-orm": "0.45.2",
+    "lucide-react": "1.27.0",
+    "next": "16.2.12",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "tailwind-merge": "3.6.0",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.58.2",
+    "@tailwindcss/postcss": "4.3.3",
+    "@types/node": "24.12.0",
+    "@types/react": "19.2.7",
+    "@types/react-dom": "19.2.3",
+    "drizzle-kit": "0.31.10",
+    "tailwindcss": "4.3.3",
+    "tsx": "4.23.1",
+    "typescript": "5.9.3",
+    "vitest": "3.2.7"
+  }
+}

package/skills/app-builder/assets/scaffold/playwright.config.ts

@@ -0,0 +1,30 @@
+import { defineConfig, devices } from "@playwright/test";
+
+export default defineConfig({
+  testDir: "./tests/e2e",
+  fullyParallel: false,
+  retries: 0,
+  reporter: "list",
+  use: {
+    baseURL: process.env.RUDDER_APP_BASE_URL ?? "http://127.0.0.1:3000",
+    trace: "retain-on-failure",
+  },
+  webServer: process.env.RUDDER_APP_BASE_URL
+    ? undefined
+    : {
+        command: "pnpm exec next dev --hostname 127.0.0.1 --port 3000",
+        url: "http://127.0.0.1:3000/api/__rudder/health",
+        reuseExistingServer: true,
+        timeout: 120_000,
+      },
+  projects: [
+    { name: "desktop", use: { ...devices["Desktop Chrome"] } },
+    {
+      name: "mobile",
+      use: {
+        viewport: { width: 390, height: 844 },
+        isMobile: true,
+      },
+    },
+  ],
+});