@powerhousedao/switchboard 6.0.0-dev.1 → 6.0.0-dev.100

package/Dockerfile

@@ -1,58 +1,84 @@
-FROM node:22 AS build
+# Build stage
+FROM node:24-alpine AS build
+
 WORKDIR /app
-COPY . .
-RUN chmod +x entrypoint.sh
+
+# Install build dependencies
+RUN apk add --no-cache python3 make g++ git bash \
+    && ln -sf /usr/bin/python3 /usr/bin/python
+
+# Setup pnpm
 ENV PNPM_HOME="/pnpm"
 ENV PATH="$PNPM_HOME:$PATH"
-RUN corepack enable && corepack install --global pnpm@9.8.0
-ENV COREPACK_ENABLE_DOWNLOAD_PROMPT=0
+RUN corepack enable && corepack prepare pnpm@latest --activate
 
-ENV HUSKY=false
+# Configure JSR registry
+RUN pnpm config set @jsr:registry https://npm.jsr.io
 
-# Packages
-ENV PH_PACKAGES=""
+# Build arguments
+ARG TAG=latest
+ARG PH_PACKAGES=""
 
-# Nx
-ENV NX_SOCKET_DIR="/tmp/nx"
-ENV NX_DAEMON=false
+# Install ph-cmd, prisma, and prettier
+RUN pnpm add -g ph-cmd@$TAG prisma@5.17.0 prettier
 
-# Auth
-ENV PH_SWITCHBOARD_AUTH_ENABLED=false
-ENV PH_SWITCHBOARD_ADMINS_LIST="0x123,0x456"
-ENV PH_SWITCHBOARD_USERS_LIST="0x123,0x456"
-ENV PH_SWITCHBOARD_GUESTS_LIST="0x123,0x456"
+# Initialize project based on tag
+RUN case "$TAG" in \
+        *dev*) ph init project --dev --package-manager pnpm ;; \
+        *staging*) ph init project --staging --package-manager pnpm ;; \
+        *) ph init project --package-manager pnpm ;; \
+    esac
 
-# Database
-ENV PH_SWITCHBOARD_DATABASE_URL="dev.db"
-ENV PH_SWITCHBOARD_REDIS_URL=""
-ENV SKIP_DB_MIGRATIONS="false"
+WORKDIR /app/project
 
-# Heroku Workaround
-ENV PORT=4001 
+# Install PH packages if provided
+RUN if [ -n "$PH_PACKAGES" ]; then \
+        IFS=',' ; for pkg in $PH_PACKAGES; do \
+            echo "Installing package: $pkg"; \
+            ph install "$pkg"; \
+        done; \
+    fi
 
-# Switchboard
-ENV PH_SWITCHBOARD_PORT=$PORT
+# Regenerate Prisma client for Alpine Linux (linux-musl-openssl-3.0.x)
+# The document-drive package ships with darwin-arm64 binaries, we need to regenerate
+RUN prisma generate --schema node_modules/document-drive/dist/prisma/schema.prisma
 
-# Other
-ARG TAG=latest
-ENV TAG=$TAG
-# RUN apk add --no-cache openssl
-# Configure JSR registry for @jsr scoped packages
+# Final stage - slim node image
+FROM node:24-alpine
+
+WORKDIR /app
+
+# Install runtime dependencies (curl for health checks, openssl for Prisma)
+RUN apk add --no-cache curl openssl
+
+# Setup pnpm
+ENV PNPM_HOME="/pnpm"
+ENV PATH="$PNPM_HOME:$PATH"
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+# Configure JSR registry
 RUN pnpm config set @jsr:registry https://npm.jsr.io
+
+# Install ph-cmd and prisma globally (needed at runtime)
+ARG TAG=latest
 RUN pnpm add -g ph-cmd@$TAG prisma@5.17.0
 
-RUN case "$TAG" in \
-        *dev*) ph init project --dev --package-manager pnpm ;; \
-        *staging*) ph init project --staging --package-manager pnpm ;; \
-        *) ph init project --package-manager pnpm ;; \
-    esac
+# Copy built project from build stage
+COPY --from=build /app/project /app/project
 
 WORKDIR /app/project
 
-# Install curl for health checks
-RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*
+# Copy entrypoint
+COPY entrypoint.sh /app/entrypoint.sh
+RUN chmod +x /app/entrypoint.sh
+
+# Environment variables
+ENV NODE_ENV=production
+ENV PORT=3000
+ENV DATABASE_URL=""
+ENV SKIP_DB_MIGRATIONS="false"
 
-EXPOSE $PORT
+EXPOSE ${PORT}
 
 HEALTHCHECK --interval=30s --timeout=3s --start-period=30s --retries=3 \
     CMD curl -f http://localhost:${PORT}/health || exit 1

package/README.md

@@ -40,6 +40,48 @@ pnpm --filter @powerhousedao/switchboard build
 pnpm --filter @powerhousedao/switchboard dev
 ```
 
+### Local Development (PostgreSQL)
+
+1. **Start the PostgreSQL database using reactor's Docker Compose:**
+
+```bash
+# From the repository root, start the database
+docker compose -f packages/reactor/docker-compose.yml up -d
+```
+
+This starts:
+- PostgreSQL on port `5433` (mapped from container port 5432)
+- Adminer (database UI) on port `8080`
+
+2. **Run database migrations:**
+
+```bash
+DATABASE_URL="postgresql://postgres:postgres@localhost:5433/reactor" pnpm migrate
+```
+
+3. **Start switchboard with the PostgreSQL database URL:**
+
+```bash
+DATABASE_URL="postgresql://postgres:postgres@localhost:5433/reactor" pnpm start
+```
+
+4. **(Optional) Access the database UI:**
+   - Open http://localhost:8080
+   - System: PostgreSQL
+   - Server: postgres
+   - Username: postgres
+   - Password: postgres
+   - Database: reactor
+
+5. **(Optional) Stop the Database**
+
+```bash
+docker compose -f packages/reactor/docker-compose.yml down
+
+# To also remove the data volume:
+docker compose -f packages/reactor/docker-compose.yml down -v
+```
+
 ### Global Installation
 
 ```bash
@@ -52,6 +94,7 @@ pnpm add -g @powerhousedao/switchboard
 
 ## 🏃‍♂️ Quick Start
 
+
 ## ⚙️ Configuration
 
 ### Environment Variables
@@ -60,6 +103,7 @@ pnpm add -g @powerhousedao/switchboard
 | ---------------------------- | ---------------------------------- | --------------------- |
 | `PORT`                       | Server port                        | `4001`                |
 | `DATABASE_URL`               | Database connection string         | `./.ph/drive-storage` |
+| `PH_REACTOR_DATABASE_URL`    | PostgreSQL URL (takes precedence)  | -                     |
 | `REDIS_URL`                  | Redis connection URL               | -                     |
 | `REDIS_TLS_URL`              | Redis TLS connection URL           | -                     |
 | `SENTRY_DSN`                 | Sentry DSN for error tracking      | -                     |
@@ -164,6 +208,12 @@ pnpm dev
 # Start production server
 pnpm start
 
+# Run database migrations (PostgreSQL only)
+pnpm migrate
+
+# Check migration status
+pnpm migrate:status
+
 # Lint code
 pnpm lint
 
@@ -171,6 +221,48 @@ pnpm lint
 pnpm clean
 ```
 
+### Database Migrations
+
+Switchboard uses Kysely for database migrations when running with PostgreSQL. Migrations are handled differently depending on your storage backend:
+
+- **PGlite (default)**: Migrations run automatically on startup
+- **PostgreSQL**: Migrations can be run manually or as part of your deployment pipeline
+
+#### Running Migrations
+
+```bash
+# Via pnpm scripts (from apps/switchboard directory)
+DATABASE_URL="postgresql://user:pass@localhost:5432/db" pnpm migrate
+
+# Check which migrations have been applied
+DATABASE_URL="postgresql://user:pass@localhost:5432/db" pnpm migrate:status
+
+# Via ph CLI (from anywhere)
+ph switchboard --db-path postgresql://user:pass@localhost:5432/db --migrate
+ph switchboard --db-path postgresql://user:pass@localhost:5432/db --migrate-status
+```
+
+#### Environment Variables for Migrations
+
+The migration commands check for a PostgreSQL URL in this order:
+1. `PH_REACTOR_DATABASE_URL`
+2. `DATABASE_URL`
+3. Config file (`powerhouse.config.json` -> `switchboard.database.url`)
+
+If no PostgreSQL URL is found, migrations are skipped with a message (PGlite handles migrations automatically).
+
+#### CI/CD Integration
+
+For production deployments, run migrations before starting the server:
+
+```bash
+# Run migrations then start
+ph switchboard --migrate && ph switchboard
+
+# Or with pnpm
+pnpm migrate && pnpm start
+```
+
 ### Adding New Features
 
 1. **Document Models**: Add new document model modules to the reactor builder

package/dist/src/index.js

@@ -1,7 +1,12 @@
 #!/usr/bin/env node
+import * as Sentry from "@sentry/node";
+import { childLogger } from "document-drive";
 import { config } from "./config.js";
+import { createMeterProviderFromEnv } from "./metrics.js";
+import { initProfilerFromEnv } from "./profiler.js";
 import { startSwitchboard } from "./server.js";
-function ensureNodeVersion(minVersion = "22") {
+const logger = childLogger(["switchboard"]);
+function ensureNodeVersion(minVersion = "24") {
     const version = process.versions.node;
     if (!version) {
         return;
@@ -12,6 +17,33 @@ function ensureNodeVersion(minVersion = "22") {
     }
 }
 // Ensure minimum Node.js version
-ensureNodeVersion("22");
-startSwitchboard(config).catch(console.error);
+ensureNodeVersion("24");
+const meterProvider = createMeterProviderFromEnv({
+    OTEL_EXPORTER_OTLP_ENDPOINT: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+    OTEL_METRIC_EXPORT_INTERVAL: process.env.OTEL_METRIC_EXPORT_INTERVAL,
+    OTEL_SERVICE_NAME: process.env.OTEL_SERVICE_NAME,
+});
+async function shutdown() {
+    console.log("\nShutting down...");
+    // Flush final metrics before exit. Races against a 5s deadline so an
+    // unresponsive OTLP endpoint cannot exhaust terminationGracePeriodSeconds.
+    await Promise.race([
+        meterProvider?.shutdown().catch(() => undefined),
+        new Promise((resolve) => setTimeout(resolve, 5_000)),
+    ]);
+    process.exit(0);
+}
+// SIGINT: Ctrl-C in development; SIGTERM: graceful shutdown in Docker/Kubernetes
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+if (process.env.PYROSCOPE_SERVER_ADDRESS) {
+    try {
+        await initProfilerFromEnv(process.env);
+    }
+    catch (e) {
+        Sentry.captureException(e);
+        logger.error("Error starting profiler: @error", e);
+    }
+}
+startSwitchboard({ ...config, meterProvider }).catch(console.error);
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,SAAS,iBAAiB,CAAC,UAAU,GAAG,IAAI;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CACX,gBAAgB,UAAU,4CAA4C,OAAO,EAAE,CAChF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AACD,iCAAiC;AACjC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAExB,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;AAE5C,SAAS,iBAAiB,CAAC,UAAU,GAAG,IAAI;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CACX,gBAAgB,UAAU,4CAA4C,OAAO,EAAE,CAChF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AACD,iCAAiC;AACjC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAExB,MAAM,aAAa,GAAG,0BAA0B,CAAC;IAC/C,2BAA2B,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B;IACpE,2BAA2B,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B;IACpE,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;CACjD,CAAC,CAAC;AAEH,KAAK,UAAU,QAAQ;IACrB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,qEAAqE;IACrE,2EAA2E;IAC3E,MAAM,OAAO,CAAC,IAAI,CAAC;QACjB,aAAa,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;QAChD,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;KAC3D,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,iFAAiF;AACjF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhC,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,gBAAgB,CAAC,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/src/metrics.d.ts

@@ -0,0 +1,7 @@
+import { MeterProvider } from "@opentelemetry/sdk-metrics";
+export declare function createMeterProviderFromEnv(env: {
+    OTEL_EXPORTER_OTLP_ENDPOINT?: string;
+    OTEL_METRIC_EXPORT_INTERVAL?: string;
+    OTEL_SERVICE_NAME?: string;
+}): MeterProvider | undefined;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/src/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/metrics.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EAEd,MAAM,4BAA4B,CAAC;AAKpC,wBAAgB,0BAA0B,CAAC,GAAG,EAAE;IAC9C,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,aAAa,GAAG,SAAS,CA8B5B"}

package/dist/src/metrics.js

@@ -0,0 +1,34 @@
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { Resource } from "@opentelemetry/resources";
+import { MeterProvider, PeriodicExportingMetricReader, } from "@opentelemetry/sdk-metrics";
+import { childLogger } from "document-drive";
+const logger = childLogger(["switchboard", "metrics"]);
+export function createMeterProviderFromEnv(env) {
+    const endpoint = env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    if (!endpoint)
+        return undefined;
+    const parsed = parseInt(env.OTEL_METRIC_EXPORT_INTERVAL ?? "", 10);
+    const exportIntervalMillis = Number.isFinite(parsed) && parsed > 0 ? parsed : 5_000;
+    const base = endpoint.replace(/\/$/, "");
+    const exporterUrl = base.endsWith("/v1/metrics")
+        ? base
+        : `${base}/v1/metrics`;
+    logger.info(`Initializing OpenTelemetry metrics exporter at: ${endpoint}`);
+    const meterProvider = new MeterProvider({
+        resource: new Resource({
+            "service.name": env.OTEL_SERVICE_NAME ?? "switchboard",
+        }),
+        readers: [
+            new PeriodicExportingMetricReader({
+                exporter: new OTLPMetricExporter({
+                    url: exporterUrl,
+                }),
+                exportIntervalMillis,
+                exportTimeoutMillis: Math.max(exportIntervalMillis - 250, 1),
+            }),
+        ],
+    });
+    logger.info(`Metrics export enabled (interval: ${exportIntervalMillis}ms)`);
+    return meterProvider;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/src/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EACL,aAAa,EACb,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAEvD,MAAM,UAAU,0BAA0B,CAAC,GAI1C;IACC,MAAM,QAAQ,GAAG,GAAG,CAAC,2BAA2B,CAAC;IACjD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,oBAAoB,GACxB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IAEzD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC9C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,IAAI,aAAa,CAAC;IAEzB,MAAM,CAAC,IAAI,CAAC,mDAAmD,QAAQ,EAAE,CAAC,CAAC;IAC3E,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC;QACtC,QAAQ,EAAE,IAAI,QAAQ,CAAC;YACrB,cAAc,EAAE,GAAG,CAAC,iBAAiB,IAAI,aAAa;SACvD,CAAC;QACF,OAAO,EAAE;YACP,IAAI,6BAA6B,CAAC;gBAChC,QAAQ,EAAE,IAAI,kBAAkB,CAAC;oBAC/B,GAAG,EAAE,WAAW;iBACjB,CAAC;gBACF,oBAAoB;gBACpB,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,GAAG,EAAE,CAAC,CAAC;aAC7D,CAAC;SACH;KACF,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,qCAAqC,oBAAoB,KAAK,CAAC,CAAC;IAC5E,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/src/migrate.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=migrate.d.ts.map

package/dist/src/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/migrate.ts"],"names":[],"mappings":""}

package/dist/src/migrate.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { Kysely, PostgresDialect } from "kysely";
+import { Pool } from "pg";
+import { runMigrations, getMigrationStatus, REACTOR_SCHEMA, } from "@powerhousedao/reactor";
+import { getConfig } from "@powerhousedao/config/node";
+function isPostgresUrl(url) {
+    return url.startsWith("postgresql://") || url.startsWith("postgres://");
+}
+async function main() {
+    const command = process.argv[2];
+    const config = getConfig();
+    const dbPath = process.env.PH_REACTOR_DATABASE_URL ??
+        process.env.DATABASE_URL ??
+        config.switchboard?.database?.url;
+    if (!dbPath || !isPostgresUrl(dbPath)) {
+        console.log("No PostgreSQL URL configured. Skipping migrations.");
+        console.log("(PGlite migrations are handled automatically on startup)");
+        return;
+    }
+    console.log(`Database: ${dbPath}`);
+    const pool = new Pool({ connectionString: dbPath });
+    const db = new Kysely({
+        dialect: new PostgresDialect({ pool }),
+    });
+    try {
+        if (command === "status") {
+            console.log("\nChecking migration status...");
+            const migrations = await getMigrationStatus(db, REACTOR_SCHEMA);
+            console.log("\nMigration Status:");
+            console.log("=================");
+            for (const migration of migrations) {
+                const status = migration.executedAt
+                    ? `[OK] Executed at ${migration.executedAt.toISOString()}`
+                    : "[--] Pending";
+                console.log(`${status} - ${migration.name}`);
+            }
+        }
+        else {
+            console.log("\nRunning migrations...");
+            const result = await runMigrations(db, REACTOR_SCHEMA);
+            if (!result.success) {
+                console.error("Migration failed:", result.error?.message);
+                process.exit(1);
+            }
+            if (result.migrationsExecuted.length === 0) {
+                console.log("No migrations to run - database is up to date");
+            }
+            else {
+                console.log(`Successfully executed ${result.migrationsExecuted.length} migration(s):`);
+                for (const name of result.migrationsExecuted) {
+                    console.log(`  - ${name}`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        console.error("Error:", error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+    finally {
+        await db.destroy();
+    }
+}
+void main();
+//# sourceMappingURL=migrate.js.map

package/dist/src/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/migrate.ts"],"names":[],"mappings":"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"}

package/dist/src/profiler.d.ts

@@ -1,4 +1,9 @@
 import type { PyroscopeConfig } from "@pyroscope/nodejs";
 export declare function initProfilerFromEnv(env: typeof process.env): Promise<void>;
-export declare function initProfiler(options?: PyroscopeConfig): Promise<void>;
+interface ProfilerFlags {
+    wallEnabled?: boolean;
+    heapEnabled?: boolean;
+}
+export declare function initProfiler(options?: PyroscopeConfig, flags?: ProfilerFlags): Promise<void>;
+export {};
 //# sourceMappingURL=profiler.d.ts.map

package/dist/src/profiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../src/profiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,iBAehE;AAED,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE,eAAe,iBAK3D"}
+{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../src/profiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,iBAgChE;AAED,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,eAAe,EACzB,KAAK,GAAE,aAAyD,iBAqBjE"}

package/dist/src/profiler.js

@@ -1,17 +1,43 @@
 export async function initProfilerFromEnv(env) {
-    const { PYROSCOPE_SERVER_ADDRESS: serverAddress, PYROSCOPE_APPLICATION_NAME: appName, PYROSCOPE_USER: basicAuthUser, PYROSCOPE_PASSWORD: basicAuthPassword, } = env;
+    const { PYROSCOPE_SERVER_ADDRESS: serverAddress, PYROSCOPE_APPLICATION_NAME: appName, PYROSCOPE_USER: basicAuthUser, PYROSCOPE_PASSWORD: basicAuthPassword, PYROSCOPE_WALL_ENABLED: wallEnabled, PYROSCOPE_HEAP_ENABLED: heapEnabled, } = env;
     const options = {
         serverAddress,
         appName,
         basicAuthUser,
         basicAuthPassword,
+        // Wall profiling captures wall-clock time (includes async I/O waits)
+        // This shows GraphQL resolvers even when waiting for database
+        wall: {
+            samplingDurationMs: 10000, // 10 second sampling windows
+            samplingIntervalMicros: 10000, // 10ms sampling interval (100 samples/sec)
+            collectCpuTime: true, // Also collect CPU time alongside wall time
+        },
+        // Heap profiling for memory allocation tracking
+        heap: {
+            samplingIntervalBytes: 512 * 1024, // Sample every 512KB allocated
+            stackDepth: 64, // Capture deeper stacks for better context
+        },
     };
-    return initProfiler(options);
+    return initProfiler(options, {
+        wallEnabled: wallEnabled !== "false",
+        heapEnabled: heapEnabled === "true",
+    });
 }
-export async function initProfiler(options) {
+export async function initProfiler(options, flags = { wallEnabled: true, heapEnabled: false }) {
     console.log("Initializing Pyroscope profiler at:", options?.serverAddress);
-    const Pyroscope = await import("@pyroscope/nodejs");
+    console.log("  Wall profiling:", flags.wallEnabled ? "enabled" : "disabled");
+    console.log("  Heap profiling:", flags.heapEnabled ? "enabled" : "disabled");
+    const { default: Pyroscope } = await import("@pyroscope/nodejs");
     Pyroscope.init(options);
-    Pyroscope.start();
+    // Start wall profiling (captures async I/O time - shows resolvers)
+    if (flags.wallEnabled) {
+        Pyroscope.startWallProfiling();
+    }
+    // Start CPU profiling (captures CPU-bound work)
+    Pyroscope.startCpuProfiling();
+    // Optionally start heap profiling (memory allocations)
+    if (flags.heapEnabled) {
+        Pyroscope.startHeapProfiling();
+    }
 }
 //# sourceMappingURL=profiler.js.map

package/dist/src/profiler.js.map

@@ -1 +1 @@
-{"version":3,"file":"profiler.js","sourceRoot":"","sources":["../../src/profiler.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAuB;IAC/D,MAAM,EACJ,wBAAwB,EAAE,aAAa,EACvC,0BAA0B,EAAE,OAAO,EACnC,cAAc,EAAE,aAAa,EAC7B,kBAAkB,EAAE,iBAAiB,GACtC,GAAG,GAAG,CAAC;IAER,MAAM,OAAO,GAAoB;QAC/B,aAAa;QACb,OAAO;QACP,aAAa;QACb,iBAAiB;KAClB,CAAC;IACF,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACpD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}
+{"version":3,"file":"profiler.js","sourceRoot":"","sources":["../../src/profiler.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAuB;IAC/D,MAAM,EACJ,wBAAwB,EAAE,aAAa,EACvC,0BAA0B,EAAE,OAAO,EACnC,cAAc,EAAE,aAAa,EAC7B,kBAAkB,EAAE,iBAAiB,EACrC,sBAAsB,EAAE,WAAW,EACnC,sBAAsB,EAAE,WAAW,GACpC,GAAG,GAAG,CAAC;IAER,MAAM,OAAO,GAAoB;QAC/B,aAAa;QACb,OAAO;QACP,aAAa;QACb,iBAAiB;QACjB,qEAAqE;QACrE,8DAA8D;QAC9D,IAAI,EAAE;YACJ,kBAAkB,EAAE,KAAK,EAAE,6BAA6B;YACxD,sBAAsB,EAAE,KAAK,EAAE,2CAA2C;YAC1E,cAAc,EAAE,IAAI,EAAE,4CAA4C;SACnE;QACD,gDAAgD;QAChD,IAAI,EAAE;YACJ,qBAAqB,EAAE,GAAG,GAAG,IAAI,EAAE,+BAA+B;YAClE,UAAU,EAAE,EAAE,EAAE,2CAA2C;SAC5D;KACF,CAAC;IACF,OAAO,YAAY,CAAC,OAAO,EAAE;QAC3B,WAAW,EAAE,WAAW,KAAK,OAAO;QACpC,WAAW,EAAE,WAAW,KAAK,MAAM;KACpC,CAAC,CAAC;AACL,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAyB,EACzB,QAAuB,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;IAEhE,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAE7E,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACjE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAExB,mEAAmE;IACnE,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,SAAS,CAAC,kBAAkB,EAAE,CAAC;IACjC,CAAC;IAED,gDAAgD;IAChD,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAE9B,uDAAuD;IACvD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,SAAS,CAAC,kBAAkB,EAAE,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/src/renown.d.ts

@@ -0,0 +1,16 @@
+import { type IRenown } from "@renown/sdk/node";
+export interface RenownOptions {
+    /** Path to the keypair file. Defaults to .ph/.keypair.json in cwd */
+    keypairPath?: string;
+    /** If true, won't generate a new keypair if none exists */
+    requireExisting?: boolean;
+    /** Base url of the Renown instance to use */
+    baseUrl?: string;
+}
+/**
+ * Initialize Renown for the Switchboard instance.
+ * This allows Switchboard to authenticate with remote services
+ * using the same identity established during `ph login`.
+ */
+export declare function initRenown(options?: RenownOptions): Promise<IRenown | null>;
+//# sourceMappingURL=renown.d.ts.map

package/dist/src/renown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renown.d.ts","sourceRoot":"","sources":["../../src/renown.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAqCzB"}

package/dist/src/renown.js

@@ -0,0 +1,33 @@
+import { childLogger } from "document-drive";
+import { DEFAULT_RENOWN_URL, NodeKeyStorage, RenownBuilder, RenownCryptoBuilder, } from "@renown/sdk/node";
+const logger = childLogger(["switchboard", "renown"]);
+/**
+ * Initialize Renown for the Switchboard instance.
+ * This allows Switchboard to authenticate with remote services
+ * using the same identity established during `ph login`.
+ */
+export async function initRenown(options = {}) {
+    const { keypairPath, requireExisting = false, baseUrl = DEFAULT_RENOWN_URL, } = options;
+    const keyStorage = new NodeKeyStorage(keypairPath, {
+        logger,
+    });
+    // Check if we have an existing keypair
+    const existingKeyPair = await keyStorage.loadKeyPair();
+    if (!existingKeyPair && requireExisting) {
+        throw new Error("No existing keypair found and requireExisting is true. " +
+            'Run "ph login" to create one.');
+    }
+    if (!existingKeyPair) {
+        logger.info("No existing keypair found. A new one will be generated.");
+    }
+    const renownCrypto = await new RenownCryptoBuilder()
+        .withKeyPairStorage(keyStorage)
+        .build();
+    const renown = await new RenownBuilder("switchboard", {})
+        .withCrypto(renownCrypto)
+        .withBaseUrl(baseUrl)
+        .build();
+    logger.info("Switchboard identity initialized: @did", renownCrypto.did);
+    return renown;
+}
+//# sourceMappingURL=renown.js.map

package/dist/src/renown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renown.js","sourceRoot":"","sources":["../../src/renown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,mBAAmB,GAEpB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAWtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAAyB,EAAE;IAE3B,MAAM,EACJ,WAAW,EACX,eAAe,GAAG,KAAK,EACvB,OAAO,GAAG,kBAAkB,GAC7B,GAAG,OAAO,CAAC;IAEZ,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,WAAW,EAAE;QACjD,MAAM;KACP,CAAC,CAAC;IAEH,uCAAuC;IACvC,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC;IAEvD,IAAI,CAAC,eAAe,IAAI,eAAe,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,yDAAyD;YACvD,+BAA+B,CAClC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,IAAI,mBAAmB,EAAE;SACjD,kBAAkB,CAAC,UAAU,CAAC;SAC9B,KAAK,EAAE,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,EAAE,CAAC;SACtD,UAAU,CAAC,YAAY,CAAC;SACxB,WAAW,CAAC,OAAO,CAAC;SACpB,KAAK,EAAE,CAAC;IAEX,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IAExE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/server.d.ts

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import type { StartServerOptions, SwitchboardReactor } from "./types.js";
 export declare const startSwitchboard: (options?: StartServerOptions) => Promise<SwitchboardReactor>;
-export { getBearerToken, getConnectCrypto, getConnectDid, } from "./connect-crypto.js";
 export * from "./types.js";
 //# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":";AA0CA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA+RzE,eAAO,MAAM,gBAAgB,GAC3B,UAAS,kBAAuB,KAC/B,OAAO,CAAC,kBAAkB,CA+D5B,CAAC;AAEF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":";AAsDA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwYzE,eAAO,MAAM,gBAAgB,GAC3B,UAAS,kBAAuB,KAC/B,OAAO,CAAC,kBAAkB,CAiE5B,CAAC;AAEF,cAAc,YAAY,CAAC"}