@revealui/setup 0.3.4 → 0.3.6

package/README.md

@@ -306,14 +306,14 @@ pnpm test:coverage
 - You're building setup scripts or CLI tools that need environment variable management
 - You need cryptographically secure secret generation for JWT keys or database passwords
 - You want consistent, colored logging with progress bars for setup flows
-- **Not** for runtime config access — use `@revealui/config` after setup is complete
-- **Not** for end-user-facing logging — use `@revealui/utils/logger` in application code
+- **Not** for runtime config access  -  use `@revealui/config` after setup is complete
+- **Not** for end-user-facing logging  -  use `@revealui/utils/logger` in application code
 
 ## JOSHUA Alignment
 
-- **Justifiable**: Every utility exists because `@revealui/cli` and setup scripts need it — no speculative abstractions
+- **Justifiable**: Every utility exists because `@revealui/cli` and setup scripts need it  -  no speculative abstractions
 - **Hermetic**: Validation catches missing or malformed variables before they propagate into runtime
-- **Sovereign**: Generates secrets locally with `crypto.randomBytes` — no external service required
+- **Sovereign**: Generates secrets locally with `crypto.randomBytes`  -  no external service required
 
 ## License
 

package/dist/bootstrap/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Suite-wide bootstrap primitive for RevealUI.
+ *
+ * Creates the first admin user and seeds minimal content.
+ * Designed for three consumers (in priority order):
+ *   1. Agents / MCP clients (programmatic)
+ *   2. CLI (`pnpm admin:setup`)
+ *   3. Browser UI (`/setup` page)
+ *
+ * Self-disabling: refuses to run if any users already exist.
+ * The RevealUI instance is injected  -  this module has no direct
+ * dependency on @revealui/core or @revealui/db, keeping the
+ * setup package lightweight.
+ */
+/** Minimal interface for the RevealUI admin instance (injected by consumer). */
+interface RevealUILike {
+    find: (args: {
+        collection: string;
+        limit?: number;
+        depth?: number;
+        where?: Record<string, unknown>;
+    }) => Promise<{
+        totalDocs: number;
+        docs: Array<Record<string, unknown>>;
+    }>;
+    create: (args: {
+        collection: string;
+        data: Record<string, unknown>;
+    }) => Promise<Record<string, unknown>>;
+}
+interface BootstrapAdminConfig {
+    email: string;
+    password: string;
+    name?: string;
+}
+interface BootstrapOptions {
+    /** RevealUI admin instance (injected  -  keeps setup package lightweight). */
+    revealui: RevealUILike;
+    /** First admin user credentials. */
+    admin: BootstrapAdminConfig;
+    /** Seed minimal content (home page). Default: true. */
+    seed?: boolean;
+}
+interface BootstrapResult {
+    status: 'created' | 'locked' | 'error';
+    message: string;
+    user?: {
+        email: string;
+        role: string;
+    };
+    seeded?: boolean;
+    error?: string;
+}
+/**
+ * Bootstrap a fresh RevealUI instance.
+ *
+ * 1. Checks if any users exist (self-disabling gate)
+ * 2. Validates admin credentials
+ * 3. Creates the first admin user
+ * 4. Seeds minimal content (home page) if requested
+ *
+ * @returns BootstrapResult with status, message, and optional user/seed info.
+ */
+declare function bootstrap(options: BootstrapOptions): Promise<BootstrapResult>;
+
+export { type BootstrapAdminConfig, type BootstrapOptions, type BootstrapResult, type RevealUILike, bootstrap };

package/dist/bootstrap/index.js

@@ -0,0 +1,147 @@
+// src/bootstrap/index.ts
+function richTextDoc(...nodes) {
+  return {
+    root: {
+      type: "root",
+      children: nodes,
+      direction: "ltr",
+      format: "",
+      indent: 0,
+      version: 1
+    }
+  };
+}
+function heading(text, tag = "h2") {
+  return {
+    type: "heading",
+    children: [{ type: "text", detail: 0, format: 0, mode: "normal", style: "", text, version: 1 }],
+    direction: "ltr",
+    format: "",
+    indent: 0,
+    tag,
+    version: 1
+  };
+}
+function paragraph(text) {
+  return {
+    type: "paragraph",
+    children: [{ type: "text", detail: 0, format: 0, mode: "normal", style: "", text, version: 1 }],
+    direction: "ltr",
+    format: "",
+    indent: 0,
+    textFormat: 0,
+    textStyle: "",
+    version: 1
+  };
+}
+var SEED_PAGES = [
+  {
+    title: "Home",
+    slug: "home",
+    path: "/",
+    layout: [
+      {
+        blockType: "content",
+        columns: [
+          {
+            size: "full",
+            richText: richTextDoc(
+              heading("Welcome to RevealUI"),
+              paragraph(
+                "Your agentic business runtime is ready. Visit /admin to manage content, configure collections, and build your application."
+              )
+            )
+          }
+        ]
+      }
+    ]
+  }
+];
+async function bootstrap(options) {
+  const { revealui, admin, seed = true } = options;
+  try {
+    const existing = await revealui.find({
+      collection: "users",
+      limit: 1,
+      depth: 0
+    });
+    if (existing.totalDocs > 0) {
+      return {
+        status: "locked",
+        message: "Setup already completed. Users exist."
+      };
+    }
+  } catch (err) {
+    return {
+      status: "error",
+      message: "Database connection failed. Check POSTGRES_URL or DATABASE_URL.",
+      error: err instanceof Error ? err.message : String(err)
+    };
+  }
+  if (!(admin.email && admin.password)) {
+    return {
+      status: "error",
+      message: "Admin email and password are required."
+    };
+  }
+  if (admin.password.length < 12) {
+    return {
+      status: "error",
+      message: "Admin password must be at least 12 characters."
+    };
+  }
+  try {
+    await revealui.create({
+      collection: "users",
+      data: {
+        name: admin.name ?? "Admin",
+        email: admin.email,
+        password: admin.password,
+        role: "owner",
+        roles: ["super-admin"]
+      }
+    });
+  } catch (err) {
+    const pgCode = err.code;
+    if (pgCode === "23505") {
+      return {
+        status: "error",
+        message: "A user with that email already exists."
+      };
+    }
+    return {
+      status: "error",
+      message: "Failed to create admin user.",
+      error: err instanceof Error ? err.message : String(err)
+    };
+  }
+  let seeded = false;
+  if (seed) {
+    try {
+      for (const page of SEED_PAGES) {
+        const existing = await revealui.find({
+          collection: "pages",
+          where: { slug: { equals: page.slug } },
+          limit: 1
+        });
+        if (existing.docs.length === 0) {
+          await revealui.create({
+            collection: "pages",
+            data: page
+          });
+        }
+      }
+      seeded = true;
+    } catch {
+    }
+  }
+  return {
+    status: "created",
+    message: `Admin user created${seeded ? " and content seeded" : ""}. Sign in at /admin.`,
+    user: { email: admin.email, role: "owner" },
+    seeded
+  };
+}
+export {
+  bootstrap
+};

package/dist/environment/index.js

@@ -5,10 +5,15 @@ function generateSecret(length = 32) {
 }
 function generatePassword(length = 16) {
   const chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*";
+  const maxValid = 256 - 256 % chars.length;
   let password = "";
-  const randomValues = randomBytes(length);
-  for (let i = 0; i < length; i++) {
-    password += chars[randomValues[i] % chars.length];
+  while (password.length < length) {
+    const buf = randomBytes(length - password.length + 16);
+    for (let i = 0; i < buf.length && password.length < length; i++) {
+      if (buf[i] < maxValid) {
+        password += chars[buf[i] % chars.length];
+      }
+    }
   }
   return password;
 }
@@ -459,4 +464,3 @@ export {
   setupEnvironment,
   updateEnvValue
 };
-//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { BootstrapAdminConfig, BootstrapOptions, BootstrapResult, RevealUILike, bootstrap } from './bootstrap/index.js';
 export { SetupEnvironmentOptions, SetupEnvironmentResult, generatePassword, generateSecret, parseEnvContent, setupEnvironment, updateEnvValue } from './environment/index.js';
+export { PROFILES, PlanAction, PlatformClass, SystemInfo, TunePlan, TuneProfile, TuneValues, WslConfigTune, detectSystem, generateAutoplan, generatePlan, matchProfile } from './system-tune/index.js';
 export { LogLevel, Logger, LoggerOptions, createLogger, handleASTParseError, logger } from './utils/index.js';
 export { EnvVariable, OPTIONAL_ENV_VARS, REQUIRED_ENV_VARS, ValidationResult, validateEnv, validators } from './validators/index.js';