@powerhousedao/switchboard 6.0.0-dev.2 → 6.0.0-dev.200

package/dist/server-BMtyzhoR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-BMtyzhoR.mjs","names":["vetraDocumentModels","documentModels","vetraProcessorFactory"],"sources":["../src/feature-flags.ts","../src/renown.ts","../src/server.mts"],"sourcesContent":["import { EnvVarProvider } from \"@openfeature/env-var-provider\";\nimport { OpenFeature } from \"@openfeature/server-sdk\";\n\nexport async function initFeatureFlags() {\n  // for now, we're only using env vars for feature flags\n  const provider = new EnvVarProvider();\n\n  await OpenFeature.setProviderAndWait(provider);\n\n  return OpenFeature.getClient();\n}\n","import type { SignerConfig } from \"@powerhousedao/reactor\";\nimport {\n  createSignatureVerifier,\n  DEFAULT_RENOWN_URL,\n  NodeKeyStorage,\n  RenownBuilder,\n  RenownCryptoBuilder,\n  type IRenown,\n} from \"@renown/sdk/node\";\nimport { childLogger } from \"document-model\";\n\nconst logger = childLogger([\"switchboard\", \"renown\"]);\n\nexport interface RenownOptions {\n  /** Path to the keypair file. Defaults to .ph/.keypair.json in cwd */\n  keypairPath?: string;\n  /** If true, won't generate a new keypair if none exists */\n  requireExisting?: boolean;\n  /** Base url of the Renown instance to use */\n  baseUrl?: string;\n}\n\n/**\n * Initialize Renown for the Switchboard instance.\n * This allows Switchboard to authenticate with remote services\n * using the same identity established during `ph login`.\n */\nexport async function initRenown(\n  options: RenownOptions = {},\n): Promise<IRenown | null> {\n  const {\n    keypairPath,\n    requireExisting = false,\n    baseUrl = DEFAULT_RENOWN_URL,\n  } = options;\n\n  const keyStorage = new NodeKeyStorage(keypairPath, {\n    logger,\n  });\n\n  // Check if we have an existing keypair\n  const existingKeyPair = await keyStorage.loadKeyPair();\n\n  if (!existingKeyPair && requireExisting) {\n    throw new Error(\n      \"No existing keypair found and requireExisting is true. \" +\n        'Run \"ph login\" to create one.',\n    );\n  }\n\n  if (!existingKeyPair) {\n    logger.info(\"No existing keypair found. A new one will be generated.\");\n  }\n\n  const renownCrypto = await new RenownCryptoBuilder()\n    .withKeyPairStorage(keyStorage)\n    .build();\n\n  const renown = await new RenownBuilder(\"switchboard\", {})\n    .withCrypto(renownCrypto)\n    .withBaseUrl(baseUrl)\n    .build();\n\n  logger.info(\"Switchboard identity initialized: @did\", renownCrypto.did);\n\n  return renown;\n}\n\n/**\n * Get the signer config for the given renown instance.\n *\n * @param renown - The renown instance\n * @param requireSignature - If true, unsigned actions are rejected\n */\nexport function getRenownSignerConfig(\n  renown: IRenown,\n  requireSignature?: boolean,\n): SignerConfig {\n  return {\n    signer: renown.signer,\n    verifier: createSignatureVerifier(requireSignature),\n  };\n}\n","#!/usr/bin/env node\nimport { PGlite } from \"@electric-sql/pglite\";\nimport { metrics } from \"@opentelemetry/api\";\nimport { getConfig } from \"@powerhousedao/config/node\";\nimport { ReactorInstrumentation } from \"@powerhousedao/opentelemetry-instrumentation-reactor\";\nimport {\n  ChannelScheme,\n  EventBus,\n  ReactorBuilder,\n  ReactorClientBuilder,\n  driveCollectionId,\n  parseDriveUrl,\n  type Database,\n} from \"@powerhousedao/reactor\";\nimport {\n  HttpPackageLoader,\n  ImportPackageLoader,\n  PackageManagementService,\n  PackagesSubgraph,\n  getUniqueDocumentModels,\n  initializeAndStartAPI,\n  type IPackageLoader,\n} from \"@powerhousedao/reactor-api\";\nimport { httpsHooksPath } from \"@powerhousedao/reactor-api/https-hooks\";\nimport {\n  VitePackageLoader,\n  createViteLogger,\n  startViteServer,\n} from \"@powerhousedao/reactor-api/vite\";\nimport { driveDocumentModelModule } from \"@powerhousedao/shared/document-drive\";\nimport type { DocumentModelModule } from \"@powerhousedao/shared/document-model\";\nimport { documentModels as vetraDocumentModels } from \"@powerhousedao/vetra\";\nimport { processorFactory as vetraProcessorFactory } from \"@powerhousedao/vetra/processors\";\nimport type { IRenown } from \"@renown/sdk/node\";\nimport * as Sentry from \"@sentry/node\";\nimport {\n  childLogger,\n  documentModelDocumentModelModule,\n  setLogLevel,\n  type ILogger,\n} from \"document-model\";\nimport dotenv from \"dotenv\";\nimport { Kysely, PostgresDialect } from \"kysely\";\nimport { PGliteDialect } from \"kysely-pglite-dialect\";\nimport net from \"node:net\";\nimport { register } from \"node:module\";\nimport path from \"path\";\nimport { Pool } from \"pg\";\nimport { initFeatureFlags } from \"./feature-flags.js\";\nimport { getRenownSignerConfig, initRenown } from \"./renown.js\";\nimport type { StartServerOptions, SwitchboardReactor } from \"./types.js\";\nimport { addDefaultDrive, isPostgresUrl } from \"./utils.mjs\";\n\nconst defaultLogger = childLogger([\"switchboard\"]);\n\nconst LogLevel = (process.env.LOG_LEVEL as ILogger[\"level\"] | \"\") || \"info\";\nsetLogLevel(LogLevel);\n\ndotenv.config();\n\n// Feature flag constants\nconst DOCUMENT_MODEL_SUBGRAPHS_ENABLED = \"DOCUMENT_MODEL_SUBGRAPHS_ENABLED\";\nconst DOCUMENT_MODEL_SUBGRAPHS_ENABLED_DEFAULT = true;\nconst REQUIRE_SIGNATURES = \"REQUIRE_SIGNATURES\";\nconst REQUIRE_SIGNATURES_DEFAULT = false;\n\nif (process.env.SENTRY_DSN) {\n  defaultLogger.info(\n    \"Initialized Sentry with env: @env\",\n    process.env.SENTRY_ENV,\n  );\n  Sentry.init({\n    dsn: process.env.SENTRY_DSN,\n    environment: process.env.SENTRY_ENV,\n    // Match the version tag uploaded by release-branch.yml so source maps\n    // resolve. Populated by the CI (WORKSPACE_VERSION) or npm at runtime.\n    release:\n      process.env.SENTRY_RELEASE ||\n      (process.env.npm_package_version\n        ? `v${process.env.npm_package_version}`\n        : undefined),\n  });\n}\n\nconst DEFAULT_PORT = process.env.PORT ? Number(process.env.PORT) : 4001;\n\n// How many ports forward from the requested one we will try before giving up.\nconst PORT_FALLBACK_ATTEMPTS = 20;\n\n/**\n * Attempt to bind a throwaway TCP server to the given port. Resolves true if\n * the port is free, false if the OS reports it in use. Any other error is\n * surfaced so we don't silently mask real issues (permissions, bad host, …).\n */\nexport function isPortAvailable(port: number): Promise<boolean> {\n  return new Promise((resolve, reject) => {\n    const tester = net.createServer();\n    tester.once(\"error\", (err: NodeJS.ErrnoException) => {\n      if (err.code === \"EADDRINUSE\" || err.code === \"EACCES\") {\n        resolve(false);\n      } else {\n        reject(err);\n      }\n    });\n    tester.once(\"listening\", () => {\n      tester.close(() => resolve(true));\n    });\n    // Bind on the unspecified IPv6 address so we detect collisions with both\n    // IPv6 and IPv4 listeners (Node maps `::` to dual-stack on most systems).\n    tester.listen({ port, host: \"::\" });\n  });\n}\n\nasync function resolveServerPort(\n  requested: number,\n  strictPort: boolean,\n  logger: ILogger,\n): Promise<number> {\n  if (strictPort) return requested;\n  for (let i = 0; i < PORT_FALLBACK_ATTEMPTS; i++) {\n    const candidate = requested + i;\n    if (await isPortAvailable(candidate)) {\n      if (candidate !== requested) {\n        logger.info(\n          `Port ${requested} is in use. Falling back to port ${candidate}.`,\n        );\n      }\n      return candidate;\n    }\n  }\n  // Couldn't find a free port in the window; let the caller surface the\n  // original EADDRINUSE when the real bind attempts runs.\n  return requested;\n}\n\nasync function initServer(\n  serverPort: number,\n  options: StartServerOptions,\n  renown: IRenown | null,\n) {\n  // Register the global MeterProvider before ReactorInstrumentation is\n  // constructed. setGlobalMeterProvider is a one-way door — once set it cannot\n  // be unset — so this must happen before initializeClient calls\n  // instrumentation.start() → createMetrics() → metrics.getMeter().\n  if (options.meterProvider) {\n    metrics.setGlobalMeterProvider(options.meterProvider);\n  }\n\n  const {\n    dev,\n    packages = [],\n    remoteDrives = [],\n    logger = defaultLogger,\n  } = options;\n  logger.level = LogLevel;\n  const dbPath = options.dbPath ?? process.env.DATABASE_URL;\n\n  // use postgres url for read model storage if available, otherwise use local PGlite path\n  const readModelPath = dbPath || \".ph/read-storage\";\n\n  // HTTP registry package loading\n  const configPath =\n    options.configFile ?? path.join(process.cwd(), \"powerhouse.config.json\");\n  const config = getConfig(configPath);\n  const registryUrl = process.env.PH_REGISTRY_URL ?? config.packageRegistryUrl;\n  const registryPackages = process.env.PH_REGISTRY_PACKAGES;\n  const dynamicModelLoading =\n    options.dynamicModelLoading ?? process.env.DYNAMIC_MODEL_LOADING === \"true\";\n  let httpLoader: HttpPackageLoader | undefined;\n\n  if (registryUrl) {\n    // Register HTTP/HTTPS module loader hooks for dynamic package imports\n    register(httpsHooksPath, import.meta.url);\n    httpLoader = new HttpPackageLoader({ registryUrl });\n    registryPackages?.split(\",\").forEach((p) => {\n      const name = p.trim();\n      if (!packages.includes(name)) {\n        packages.push(name);\n      }\n    });\n  }\n\n  const reactorLogger = logger.child([\"reactor\"]);\n  const initializeClient = async (documentModels: DocumentModelModule[]) => {\n    const eventBus = new EventBus();\n    const builder = new ReactorBuilder()\n      .withEventBus(eventBus)\n      .withDocumentModels(\n        getUniqueDocumentModels([\n          documentModelDocumentModelModule,\n          driveDocumentModelModule,\n          ...vetraDocumentModels,\n          ...documentModels,\n        ]),\n      )\n      .withChannelScheme(ChannelScheme.SWITCHBOARD)\n      .withSignalHandlers()\n      .withLogger(reactorLogger);\n\n    const maxSkipThreshold = parseInt(process.env.MAX_SKIP_THRESHOLD ?? \"\", 10);\n    if (!isNaN(maxSkipThreshold) && maxSkipThreshold > 0) {\n      builder.withExecutorConfig({ maxSkipThreshold });\n      logger.info(`Reactor maxSkipThreshold set to ${maxSkipThreshold}`);\n    }\n\n    const reactorDbUrl = process.env.PH_REACTOR_DATABASE_URL;\n    if (reactorDbUrl && isPostgresUrl(reactorDbUrl)) {\n      const connectionString = reactorDbUrl.includes(\"?\")\n        ? reactorDbUrl\n        : `${reactorDbUrl}?sslmode=disable`;\n      const pool = new Pool({ connectionString });\n      const kysely = new Kysely<Database>({\n        dialect: new PostgresDialect({ pool }),\n      });\n      builder.withKysely(kysely);\n      logger.info(\"Using PostgreSQL for reactor storage\");\n    } else {\n      const pglitePath = \"./.ph/reactor-storage\";\n      const pglite = new PGlite(pglitePath);\n      const kysely = new Kysely<Database>({\n        dialect: new PGliteDialect(pglite),\n      });\n      builder.withKysely(kysely);\n      logger.info(\"Using PGlite for reactor storage\");\n    }\n\n    if (httpLoader && dynamicModelLoading) {\n      builder.withDocumentModelLoader(httpLoader.documentModelLoader);\n    }\n\n    const clientBuilder = new ReactorClientBuilder().withReactorBuilder(\n      builder,\n    );\n\n    if (renown) {\n      const signerConfig = getRenownSignerConfig(\n        renown,\n        options.identity?.requireSignatures,\n      );\n      clientBuilder.withSigner(signerConfig);\n    }\n\n    const module = await clientBuilder.buildModule();\n\n    if (module.reactorModule) {\n      const instrumentation = new ReactorInstrumentation(module.reactorModule);\n      instrumentation.start();\n      reactorLogger.info(\"Reactor metrics instrumentation started\");\n    }\n\n    return module;\n  };\n\n  let defaultDriveUrl: undefined | string = undefined;\n\n  // TODO get path from powerhouse config\n  // start vite server if dev mode is enabled\n  const basePath = process.cwd();\n  const viteLogger = createViteLogger(logger);\n  const vite = dev\n    ? await startViteServer(process.cwd(), viteLogger)\n    : undefined;\n\n  // get paths to local document models\n  if (!options.disableLocalPackages) {\n    packages.push(basePath);\n  }\n\n  // create loaders\n  const packageLoaders: IPackageLoader[] = [];\n  if (vite) {\n    packageLoaders.push(VitePackageLoader.build(vite));\n  } else {\n    packageLoaders.push(new ImportPackageLoader());\n  }\n  if (httpLoader) {\n    packageLoaders.push(httpLoader);\n    registryPackages?.split(\",\").forEach((p) => {\n      const name = p.trim();\n      if (!packages.includes(name)) {\n        packages.push(name);\n      }\n    });\n  }\n\n  const apiLogger = logger.child([\"reactor-api\"]);\n  const api = await initializeAndStartAPI(\n    initializeClient,\n    {\n      port: serverPort,\n      dbPath: readModelPath,\n      https: options.https,\n      packageLoaders: packageLoaders.length > 0 ? packageLoaders : undefined,\n      packages: packages,\n      processorConfig: options.processorConfig,\n      processors: {\n        \"@powerhousedao/vetra\": [vetraProcessorFactory],\n      },\n      configFile:\n        options.configFile ??\n        path.join(process.cwd(), \"powerhouse.config.json\"),\n      mcp: options.mcp ?? true,\n      logger: apiLogger,\n      enableDocumentModelSubgraphs: options.enableDocumentModelSubgraphs,\n    },\n    \"switchboard\",\n  );\n\n  if (process.env.SENTRY_DSN) {\n    // Register Sentry error handler after all routes are established.\n    // The adapter calls the framework-specific Sentry setup internally.\n    api.httpAdapter.setupSentryErrorHandler(Sentry);\n  }\n\n  const { client, graphqlManager, documentModelRegistry } = api;\n\n  // Wire up dynamic package management if HTTP loader is configured\n  if (httpLoader) {\n    const packageManagementService = new PackageManagementService({\n      defaultRegistryUrl: registryUrl,\n      httpLoader,\n      documentModelRegistry,\n    });\n\n    packageManagementService.setOnModelsChanged(() => {\n      graphqlManager.regenerateDocumentModelSubgraphs().catch(logger.error);\n    });\n\n    const packagesSubgraph = new PackagesSubgraph({\n      relationalDb: undefined as never,\n      analyticsStore: undefined as never,\n      reactorClient: client,\n      graphqlManager,\n      syncManager: api.syncManager,\n      path: graphqlManager.getBasePath(),\n      packageManagementService,\n    });\n\n    void graphqlManager\n      .registerSubgraphInstance(packagesSubgraph, \"graphql\", false)\n      .then(() => graphqlManager.updateRouter())\n      .catch((error: unknown) => {\n        logger.error(\"Failed to register packages subgraph: @error\", error);\n      });\n  }\n\n  // Create default drive if provided\n  if (options.drive) {\n    if (!renown) {\n      throw new Error(\"Cannot create default drive without Renown identity\");\n    }\n\n    defaultDriveUrl = await addDefaultDrive(client, options.drive, serverPort);\n  }\n\n  // add vite middleware after express app is initialized if applicable\n  if (vite) {\n    api.httpAdapter.mountRawMiddleware(vite.middlewares);\n  }\n\n  // Connect to remote drives AFTER packages are loaded\n  if (remoteDrives.length > 0) {\n    for (const remoteDriveUrl of remoteDrives) {\n      let driveId: string | undefined;\n\n      try {\n        const { syncManager } = api;\n        const parsed = parseDriveUrl(remoteDriveUrl);\n        driveId = parsed.driveId;\n        const remoteName = `remote-drive-${driveId}-${crypto.randomUUID()}`;\n        await syncManager.add(remoteName, driveCollectionId(\"main\", driveId), {\n          type: \"gql\",\n          parameters: { url: parsed.graphqlEndpoint },\n        });\n        logger.debug(\"Remote drive @remoteDriveUrl synced\", remoteDriveUrl);\n      } catch (error) {\n        if (\n          error instanceof Error &&\n          error.message.includes(\"already exists\")\n        ) {\n          logger.debug(\n            \"Remote drive already added: @remoteDriveUrl\",\n            remoteDriveUrl,\n          );\n          driveId = remoteDriveUrl.split(\"/\").pop();\n        } else {\n          logger.error(\n            \"Failed to connect to remote drive @remoteDriveUrl: @error\",\n            remoteDriveUrl,\n            error,\n          );\n        }\n      } finally {\n        // Construct local URL once in finally block\n        if (!defaultDriveUrl && driveId) {\n          const protocol = options.https ? \"https\" : \"http\";\n          defaultDriveUrl = `${protocol}://localhost:${serverPort}/d/${driveId}`;\n        }\n      }\n    }\n  }\n\n  return {\n    defaultDriveUrl,\n    api,\n    reactor: client,\n    renown,\n    port: serverPort,\n  };\n}\n\nexport const startSwitchboard = async (\n  options: StartServerOptions = {},\n): Promise<SwitchboardReactor> => {\n  const requestedPort = options.port ?? DEFAULT_PORT;\n  const logger = options.logger ?? defaultLogger;\n  const serverPort = await resolveServerPort(\n    requestedPort,\n    options.strictPort ?? false,\n    logger,\n  );\n\n  // Initialize feature flags\n  const featureFlags = await initFeatureFlags();\n\n  const enableDocumentModelSubgraphs = await featureFlags.getBooleanValue(\n    DOCUMENT_MODEL_SUBGRAPHS_ENABLED,\n    options.enableDocumentModelSubgraphs ??\n      DOCUMENT_MODEL_SUBGRAPHS_ENABLED_DEFAULT,\n  );\n\n  options.enableDocumentModelSubgraphs = enableDocumentModelSubgraphs;\n\n  const requireSignatures =\n    options.identity?.requireSignatures ??\n    (await featureFlags.getBooleanValue(\n      REQUIRE_SIGNATURES,\n      REQUIRE_SIGNATURES_DEFAULT,\n    ));\n  options.identity = { ...options.identity, requireSignatures };\n\n  logger.info(\n    \"Feature flags: @flags\",\n    JSON.stringify(\n      {\n        DOCUMENT_MODEL_SUBGRAPHS_ENABLED: enableDocumentModelSubgraphs,\n        REQUIRE_SIGNATURES: requireSignatures,\n      },\n      null,\n      2,\n    ),\n  );\n\n  // Initialize Renown if identity options are provided or keypair exists\n  let renown: IRenown | null = null;\n  try {\n    renown = await initRenown(options.identity);\n  } catch (e) {\n    logger.warn(\"Failed to initialize ConnectCrypto: @error\", e);\n    if (options.identity?.requireExisting) {\n      throw new Error(\n        'Identity required but failed to initialize. Run \"ph login\" first.',\n      );\n    }\n  }\n\n  try {\n    return await initServer(serverPort, options, renown);\n  } catch (e) {\n    Sentry.captureException(e);\n    logger.error(\"App crashed: @error\", e);\n    throw e;\n  }\n};\n\nexport * from \"./types.js\";\n\nif (import.meta.main) {\n  await startSwitchboard();\n}\n"],"mappings":"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"}

package/dist/server.d.mts

@@ -0,0 +1,93 @@
+import { ILogger } from "document-model";
+import { MeterProvider } from "@opentelemetry/api";
+import { IReactorClient } from "@powerhousedao/reactor";
+import { DriveInput } from "@powerhousedao/shared/document-drive";
+import { IRenown } from "@renown/sdk";
+
+//#region src/types.d.ts
+type StorageOptions = {
+  type: "filesystem" | "memory" | "postgres" | "browser";
+  filesystemPath?: string;
+  postgresUrl?: string;
+};
+type IdentityOptions = {
+  /** Path to the keypair file. Defaults to ~/.ph/keypair.json */keypairPath?: string;
+  /**
+   * If true, won't start without an existing keypair.
+   * Use this to ensure the switchboard only runs with an authenticated identity.
+   */
+  requireExisting?: boolean; /** Base url of the Renown instance to use */
+  baseUrl?: string; /** If true, unsigned actions will be rejected */
+  requireSignatures?: boolean;
+};
+type StartServerOptions = {
+  configFile?: string;
+  port?: number;
+  /**
+   * If true, fail immediately when the requested port is in use instead of
+   * falling back to the next free port. Matches the semantics of Vite's
+   * `--strictPort` flag that flows through the `ph vetra` command.
+   */
+  strictPort?: boolean;
+  dev?: boolean;
+  dbPath?: string;
+  drive?: DriveInput;
+  packages?: string[];
+  remoteDrives?: string[];
+  https?: {
+    keyPath: string;
+    certPath: string;
+  } | boolean | undefined;
+  auth?: {
+    enabled: boolean;
+    guests: string[];
+    users: string[];
+    admins: string[];
+  };
+  /**
+   * Identity options for Renown.
+   * When configured, the switchboard will load the keypair from `ph login`
+   * and can authenticate with remote services on behalf of the user.
+   */
+  identity?: IdentityOptions;
+  mcp?: boolean;
+  processorConfig?: Map<string, unknown>;
+  disableLocalPackages?: boolean;
+  enableDocumentModelSubgraphs?: boolean;
+  /**
+   * When true, enables dynamic loading of document models from the registry
+   * when an unknown document type is encountered during sync.
+   * Disabled by default — enable with DYNAMIC_MODEL_LOADING=true env var.
+   */
+  dynamicModelLoading?: boolean;
+  logger?: ILogger;
+  /**
+   * OpenTelemetry MeterProvider to register as the global provider before
+   * ReactorInstrumentation starts. Must be provided here rather than set
+   * externally to guarantee the registration happens before
+   * instrumentation.start() reads the global provider via metrics.getMeter().
+   */
+  meterProvider?: MeterProvider;
+};
+type SwitchboardReactor = {
+  defaultDriveUrl: string | undefined;
+  reactor: IReactorClient; /** The Renown instance if identity was initialized */
+  renown: IRenown | null;
+  /**
+   * Port the HTTP server actually bound to. May differ from the requested
+   * port when the requested port was in use and fallback kicked in.
+   */
+  port: number;
+};
+//#endregion
+//#region src/server.d.mts
+/**
+ * Attempt to bind a throwaway TCP server to the given port. Resolves true if
+ * the port is free, false if the OS reports it in use. Any other error is
+ * surfaced so we don't silently mask real issues (permissions, bad host, …).
+ */
+declare function isPortAvailable(port: number): Promise<boolean>;
+declare const startSwitchboard: (options?: StartServerOptions) => Promise<SwitchboardReactor>;
+//#endregion
+export { IdentityOptions, StartServerOptions, StorageOptions, SwitchboardReactor, isPortAvailable, startSwitchboard };
+//# sourceMappingURL=server.d.mts.map

package/dist/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../src/types.ts","../src/server.mts"],"mappings":";;;;;;;KAMY,cAAA;EACV,IAAA;EACA,cAAA;EACA,WAAA;AAAA;AAAA,KAGU,eAAA;EALV,+DAOA,WAAA;EALA;;;AAGF;EAOE,eAAA;EAGA,OAAA,WARA;EAWA,iBAAA;AAAA;AAAA,KAGU,kBAAA;EACV,UAAA;EACA,IAAA;EAFU;;;;;EAQV,UAAA;EACA,GAAA;EACA,MAAA;EACA,KAAA,GAAQ,UAAA;EACR,QAAA;EACA,YAAA;EACA,KAAA;IAEM,OAAA;IACA,QAAA;EAAA;EAIN,IAAA;IACE,OAAA;IACA,MAAA;IACA,KAAA;IACA,MAAA;EAAA;EARI;;;;;EAeN,QAAA,GAAW,eAAA;EACX,GAAA;EACA,eAAA,GAAkB,GAAA;EAClB,oBAAA;EACA,4BAAA;EAFkB;;;;;EAQlB,mBAAA;EACA,MAAA,GAAS,OAAA;EAOO;;;AAGlB;;;EAHE,aAAA,GAAgB,aAAA;AAAA;AAAA,KAGN,kBAAA;EACV,eAAA;EACA,OAAA,EAAS,cAAA,EAED;EAAR,MAAA,EAAQ,OAAA;EAKJ;;;;EAAJ,IAAA;AAAA;;;;;;;;iBCIc,eAAA,CAAgB,IAAA,WAAe,OAAA;AAAA,cA6TlC,gBAAA,GACX,OAAA,GAAS,kBAAA,KACR,OAAA,CAAQ,kBAAA"}

package/dist/server.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { n as startSwitchboard, t as isPortAvailable } from "./server-BMtyzhoR.mjs";
+import "./utils-DFl0ezBT.mjs";
+export { isPortAvailable, startSwitchboard };

package/dist/utils-DFl0ezBT.mjs

@@ -0,0 +1,44 @@
+import { driveCreateDocument, driveCreateState } from "@powerhousedao/shared/document-drive";
+import "@powerhousedao/shared/document-model";
+//#region src/utils.mts
+async function addDefaultDrive(client, drive, serverPort) {
+	let driveId = drive.id;
+	if (!driveId || driveId.length === 0) driveId = drive.slug;
+	if (!driveId || driveId.length === 0) throw new Error("Invalid Drive Id");
+	let existingDrive;
+	try {
+		existingDrive = await client.get(driveId);
+	} catch {}
+	if (existingDrive) return `http://localhost:${serverPort}/d/${driveId}`;
+	const { global } = driveCreateState();
+	const document = driveCreateDocument({
+		global: {
+			...global,
+			name: drive.global.name,
+			icon: drive.global.icon ?? global.icon
+		},
+		local: {
+			availableOffline: drive.local?.availableOffline ?? false,
+			sharingType: drive.local?.sharingType ?? "public",
+			listeners: drive.local?.listeners ?? [],
+			triggers: drive.local?.triggers ?? []
+		}
+	});
+	if (drive.id && drive.id.length > 0) document.header.id = drive.id;
+	if (drive.slug && drive.slug.length > 0) document.header.slug = drive.slug;
+	if (drive.global.name) document.header.name = drive.global.name;
+	if (drive.preferredEditor) document.header.meta = { preferredEditor: drive.preferredEditor };
+	try {
+		await client.create(document);
+	} catch (e) {
+		if (!(e instanceof Error ? e.message : String(e)).includes("already exists")) throw e;
+	}
+	return `http://localhost:${serverPort}/d/${driveId}`;
+}
+function isPostgresUrl(url) {
+	return url.startsWith("postgresql") || url.startsWith("postgres");
+}
+//#endregion
+export { isPostgresUrl as n, addDefaultDrive as t };
+
+//# sourceMappingURL=utils-DFl0ezBT.mjs.map

package/dist/utils-DFl0ezBT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-DFl0ezBT.mjs","names":[],"sources":["../src/utils.mts"],"sourcesContent":["import type { IReactorClient } from \"@powerhousedao/reactor\";\nimport type { DocumentDriveDocument } from \"@powerhousedao/shared/document-drive\";\nimport {\n  driveCreateDocument,\n  driveCreateState,\n} from \"@powerhousedao/shared/document-drive\";\nimport type { DriveInput } from \"@powerhousedao/shared/document-drive\";\nimport { generateId } from \"@powerhousedao/shared/document-model\";\n\nexport async function addDefaultDrive(\n  client: IReactorClient,\n  drive: DriveInput,\n  serverPort: number,\n) {\n  let driveId = drive.id;\n  if (!driveId || driveId.length === 0) {\n    driveId = drive.slug;\n  }\n\n  if (!driveId || driveId.length === 0) {\n    throw new Error(\"Invalid Drive Id\");\n  }\n\n  // check if the drive already exists\n  let existingDrive;\n  try {\n    existingDrive = await client.get(driveId);\n  } catch {\n    //\n  }\n\n  // already exists, return the existing drive url\n  if (existingDrive) {\n    return `http://localhost:${serverPort}/d/${driveId}`;\n  }\n\n  const { global } = driveCreateState();\n  const document = driveCreateDocument({\n    global: {\n      ...global,\n      name: drive.global.name,\n      icon: drive.global.icon ?? global.icon,\n    },\n    local: {\n      availableOffline: drive.local?.availableOffline ?? false,\n      sharingType: drive.local?.sharingType ?? \"public\",\n      listeners: drive.local?.listeners ?? [],\n      triggers: drive.local?.triggers ?? [],\n    },\n  });\n\n  if (drive.id && drive.id.length > 0) {\n    document.header.id = drive.id;\n  }\n  if (drive.slug && drive.slug.length > 0) {\n    document.header.slug = drive.slug;\n  }\n  if (drive.global.name) {\n    document.header.name = drive.global.name;\n  }\n  if (drive.preferredEditor) {\n    document.header.meta = { preferredEditor: drive.preferredEditor };\n  }\n\n  try {\n    await client.create(document);\n  } catch (e) {\n    const errorMessage = e instanceof Error ? e.message : String(e);\n    if (!errorMessage.includes(\"already exists\")) {\n      throw e;\n    }\n  }\n\n  return `http://localhost:${serverPort}/d/${driveId}`;\n}\n\nexport function isPostgresUrl(url: string) {\n  return url.startsWith(\"postgresql\") || url.startsWith(\"postgres\");\n}\n"],"mappings":";;;AASA,eAAsB,gBACpB,QACA,OACA,YACA;CACA,IAAI,UAAU,MAAM;AACpB,KAAI,CAAC,WAAW,QAAQ,WAAW,EACjC,WAAU,MAAM;AAGlB,KAAI,CAAC,WAAW,QAAQ,WAAW,EACjC,OAAM,IAAI,MAAM,mBAAmB;CAIrC,IAAI;AACJ,KAAI;AACF,kBAAgB,MAAM,OAAO,IAAI,QAAQ;SACnC;AAKR,KAAI,cACF,QAAO,oBAAoB,WAAW,KAAK;CAG7C,MAAM,EAAE,WAAW,kBAAkB;CACrC,MAAM,WAAW,oBAAoB;EACnC,QAAQ;GACN,GAAG;GACH,MAAM,MAAM,OAAO;GACnB,MAAM,MAAM,OAAO,QAAQ,OAAO;GACnC;EACD,OAAO;GACL,kBAAkB,MAAM,OAAO,oBAAoB;GACnD,aAAa,MAAM,OAAO,eAAe;GACzC,WAAW,MAAM,OAAO,aAAa,EAAE;GACvC,UAAU,MAAM,OAAO,YAAY,EAAE;GACtC;EACF,CAAC;AAEF,KAAI,MAAM,MAAM,MAAM,GAAG,SAAS,EAChC,UAAS,OAAO,KAAK,MAAM;AAE7B,KAAI,MAAM,QAAQ,MAAM,KAAK,SAAS,EACpC,UAAS,OAAO,OAAO,MAAM;AAE/B,KAAI,MAAM,OAAO,KACf,UAAS,OAAO,OAAO,MAAM,OAAO;AAEtC,KAAI,MAAM,gBACR,UAAS,OAAO,OAAO,EAAE,iBAAiB,MAAM,iBAAiB;AAGnE,KAAI;AACF,QAAM,OAAO,OAAO,SAAS;UACtB,GAAG;AAEV,MAAI,EADiB,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE,EAC7C,SAAS,iBAAiB,CAC1C,OAAM;;AAIV,QAAO,oBAAoB,WAAW,KAAK;;AAG7C,SAAgB,cAAc,KAAa;AACzC,QAAO,IAAI,WAAW,aAAa,IAAI,IAAI,WAAW,WAAW"}

package/dist/utils.d.mts

@@ -0,0 +1,9 @@
+import { IReactorClient } from "@powerhousedao/reactor";
+import { DriveInput } from "@powerhousedao/shared/document-drive";
+
+//#region src/utils.d.mts
+declare function addDefaultDrive(client: IReactorClient, drive: DriveInput, serverPort: number): Promise<string>;
+declare function isPostgresUrl(url: string): boolean;
+//#endregion
+export { addDefaultDrive, isPostgresUrl };
+//# sourceMappingURL=utils.d.mts.map

package/dist/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils.mts"],"mappings":";;;;iBASsB,eAAA,CACpB,MAAA,EAAQ,cAAA,EACR,KAAA,EAAO,UAAA,EACP,UAAA,WAAkB,OAAA;AAAA,iBAgEJ,aAAA,CAAc,GAAA"}

package/dist/utils.mjs

@@ -0,0 +1,2 @@
+import { n as isPostgresUrl, t as addDefaultDrive } from "./utils-DFl0ezBT.mjs";
+export { addDefaultDrive, isPostgresUrl };

package/package.json

@@ -1,20 +1,27 @@
 {
   "name": "@powerhousedao/switchboard",
   "type": "module",
-  "version": "6.0.0-dev.2",
-  "main": "dist/src/index.js",
+  "version": "6.0.0-dev.200",
+  "main": "dist/index.mjs",
   "exports": {
     ".": {
-      "import": "./dist/src/index.js",
-      "types": "./dist/src/index.d.ts"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
     },
     "./server": {
-      "import": "./dist/src/server.js",
-      "types": "./dist/src/server.d.ts"
+      "types": "./dist/server.d.mts",
+      "import": "./dist/server.mjs"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.mts",
+      "import": "./dist/utils.mjs"
     }
   },
+  "engines": {
+    "node": ">=24.0.0"
+  },
   "bin": {
-    "switchboard": "dist/src/index.js"
+    "switchboard": "dist/index.mjs"
   },
   "repository": {
     "type": "git",
@@ -24,48 +31,55 @@
   "license": "ISC",
   "description": "",
   "dependencies": {
-    "@electric-sql/pglite": "0.2.17",
-    "@openfeature/core": "^1.9.1",
-    "@openfeature/env-var-provider": "^0.3.1",
-    "@openfeature/server-sdk": "^1.19.0",
-    "@powerhousedao/analytics-engine-core": "^0.5.0",
-    "@powerhousedao/analytics-engine-knex": "^0.6.0",
+    "@electric-sql/pglite": "0.3.15",
+    "@openfeature/core": "1.9.1",
+    "@openfeature/env-var-provider": "0.3.1",
+    "@openfeature/server-sdk": "1.19.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.57.2",
+    "@opentelemetry/resources": "^1.29.0",
+    "@opentelemetry/sdk-metrics": "^1.29.0",
     "@pyroscope/nodejs": "^0.4.5",
     "@sentry/node": "^9.6.1",
-    "body-parser": "^1.20.3",
-    "cors": "^2.8.5",
     "dotenv": "^16.4.7",
-    "exponential-backoff": "^3.1.1",
     "express": "^4.21.2",
-    "graphql": "^16.11.0",
-    "kysely": "^0.28.2",
-    "kysely-pglite-dialect": "^1.1.1",
-    "pg": "^8.13.0",
-    "redis": "^4.7.0",
-    "@powerhousedao/config": "6.0.0-dev.2",
-    "@powerhousedao/reactor": "6.0.0-dev.2",
-    "@powerhousedao/reactor-api": "6.0.0-dev.2",
-    "@renown/sdk": "6.0.0-dev.2",
-    "document-drive": "6.0.0-dev.2",
-    "document-model": "6.0.0-dev.2"
+    "kysely": "0.28.16",
+    "kysely-pglite-dialect": "1.2.0",
+    "pg": "8.18.0",
+    "vite": "8.0.8",
+    "@powerhousedao/config": "6.0.0-dev.200",
+    "@powerhousedao/opentelemetry-instrumentation-reactor": "6.0.0-dev.200",
+    "@powerhousedao/shared": "6.0.0-dev.200",
+    "@powerhousedao/reactor-api": "6.0.0-dev.200",
+    "@powerhousedao/vetra": "6.0.0-dev.200",
+    "@powerhousedao/reactor": "6.0.0-dev.200",
+    "@renown/sdk": "6.0.0-dev.200",
+    "document-model": "6.0.0-dev.200"
   },
   "devDependencies": {
     "@types/express": "^4.17.25",
-    "@types/node": "^24.6.1",
-    "@types/pg": "^8.11.10",
-    "concurrently": "^9.1.2",
-    "nodemon": "^3.1.9"
+    "@types/node": "25.2.3",
+    "@types/pg": "8.16.0",
+    "tsdown": "0.21.1",
+    "concurrently": "9.2.1",
+    "nodemon": "3.1.11",
+    "react": "19.2.4",
+    "vitest": "4.1.1"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0"
   },
   "scripts": {
     "tsc": "tsc",
+    "test": "vitest run",
     "lint": "eslint",
-    "build": "pnpm run install-packages",
-    "start": "node dist/src/index.js",
-    "start:profile": "mkdir -p .prof && node --cpu-prof --cpu-prof-dir=.prof dist/src/index.js",
-    "start:profile:bun": "mkdir -p .prof && bun --cpu-prof --cpu-prof-dir=.prof dist/src/index.js",
-    "dev": "concurrently -P 'pnpm -w run tsc --watch' 'nodemon --trace-warnings --watch \"../..\" -e ts,tsx,js,json dist/src/index.js -- {@}' --",
-    "install-packages": "node dist/src/install-packages.js",
-    "migrate": "node dist/src/migrate.js",
-    "migrate:status": "node dist/src/migrate.js status"
+    "build": "tsdown && pnpm run install-packages",
+    "start": "node dist/index.mjs",
+    "start:profile": "mkdir -p .prof && node --cpu-prof --cpu-prof-dir=.prof dist/index.mjs",
+    "start:profile:bun": "mkdir -p .prof && bun --cpu-prof --cpu-prof-dir=.prof dist/index.mjs",
+    "dev": "concurrently -P 'pnpm -w run tsc --watch' 'nodemon --trace-warnings --watch \"../..\" -e ts,tsx,js,json dist/index.mjs -- {@}' --",
+    "install-packages": "node dist/install-packages.mjs",
+    "migrate": "node dist/migrate.mjs",
+    "migrate:status": "node dist/migrate.mjs status"
   }
 }

package/test/metrics.test.ts

@@ -0,0 +1,202 @@
+import { MeterProvider } from "@opentelemetry/sdk-metrics";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createMeterProviderFromEnv } from "../src/metrics.js";
+
+// Stub childLogger so tests don't require the full document-drive runtime
+vi.mock("document-drive", () => ({
+  childLogger: () => ({
+    info: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+  }),
+}));
+
+const providers: MeterProvider[] = [];
+
+afterEach(async () => {
+  vi.restoreAllMocks();
+  // Await shutdown so PeriodicExportingMetricReader timers are cleared
+  await Promise.all(providers.map((p) => p.shutdown()));
+  providers.length = 0;
+});
+
+function track(provider: MeterProvider | undefined): MeterProvider | undefined {
+  if (provider) providers.push(provider);
+  return provider;
+}
+
+function trackAsserted(provider: MeterProvider | undefined): MeterProvider {
+  expect(provider).toBeInstanceOf(MeterProvider);
+  return track(provider) as MeterProvider;
+}
+
+// These helpers access undocumented internal fields of MeterProvider and
+// PeriodicExportingMetricReader. They may break if @opentelemetry/sdk-metrics
+// renames its private state between major versions.
+function getReader(provider: MeterProvider): {
+  _exportInterval: number;
+  _exportTimeout: number;
+} {
+  return (
+    provider as unknown as {
+      _sharedState: {
+        metricCollectors: Array<{
+          _metricReader: { _exportInterval: number; _exportTimeout: number };
+        }>;
+      };
+    }
+  )._sharedState.metricCollectors[0]._metricReader;
+}
+
+function getExporterUrl(provider: MeterProvider): string {
+  return (
+    provider as unknown as {
+      _sharedState: {
+        metricCollectors: Array<{
+          _metricReader: {
+            _exporter: {
+              _delegate: {
+                _transport: {
+                  _transport: { _parameters: { url: string } };
+                };
+              };
+            };
+          };
+        }>;
+      };
+    }
+  )._sharedState.metricCollectors[0]._metricReader._exporter._delegate
+    ._transport._transport._parameters.url;
+}
+
+function getResourceAttributes(
+  provider: MeterProvider,
+): Record<string, unknown> {
+  return (
+    provider as unknown as {
+      _sharedState: { resource: { attributes: Record<string, unknown> } };
+    }
+  )._sharedState.resource.attributes;
+}
+
+describe("createMeterProviderFromEnv", () => {
+  describe("when OTEL_EXPORTER_OTLP_ENDPOINT is not set", () => {
+    it("returns undefined", () => {
+      expect(createMeterProviderFromEnv({})).toBeUndefined();
+    });
+  });
+
+  describe("when OTEL_EXPORTER_OTLP_ENDPOINT is set", () => {
+    it("returns a MeterProvider", () => {
+      expect(
+        track(
+          createMeterProviderFromEnv({
+            OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          }),
+        ),
+      ).toBeInstanceOf(MeterProvider);
+    });
+
+    it("strips trailing slash from endpoint URL without throwing", () => {
+      expect(() =>
+        track(
+          createMeterProviderFromEnv({
+            OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318/",
+          }),
+        ),
+      ).not.toThrow();
+    });
+
+    it("does not double-append /v1/metrics when endpoint already includes it", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318/v1/metrics",
+        }),
+      );
+      expect(getExporterUrl(provider)).toBe("http://localhost:4318/v1/metrics");
+    });
+
+    it("uses 5000ms export interval by default", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(5000);
+    });
+
+    it("honours OTEL_METRIC_EXPORT_INTERVAL", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "2000",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(2000);
+    });
+
+    it("falls back to 5000ms when OTEL_METRIC_EXPORT_INTERVAL is non-numeric", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "abc",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(5000);
+    });
+
+    it("falls back to 5000ms when OTEL_METRIC_EXPORT_INTERVAL is zero", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "0",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(5000);
+    });
+
+    it("falls back to 5000ms when OTEL_METRIC_EXPORT_INTERVAL is negative", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "-1000",
+        }),
+      );
+      expect(getReader(provider)._exportInterval).toBe(5000);
+    });
+
+    it("sets exportTimeoutMillis below exportIntervalMillis", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_METRIC_EXPORT_INTERVAL: "1000",
+        }),
+      );
+      const reader = getReader(provider);
+      expect(reader._exportTimeout).toBeLessThan(reader._exportInterval);
+    });
+
+    it("uses 'switchboard' as service name by default", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+        }),
+      );
+      expect(getResourceAttributes(provider)["service.name"]).toBe(
+        "switchboard",
+      );
+    });
+
+    it("honours OTEL_SERVICE_NAME", () => {
+      const provider = trackAsserted(
+        createMeterProviderFromEnv({
+          OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318",
+          OTEL_SERVICE_NAME: "my-switchboard",
+        }),
+      );
+      expect(getResourceAttributes(provider)["service.name"]).toBe(
+        "my-switchboard",
+      );
+    });
+  });
+});

package/tsconfig.json

@@ -6,20 +6,29 @@
   },
   "include": ["**/*"],
   "references": [
+    {
+      "path": "../../packages/config"
+    },
     {
       "path": "../../packages/document-model"
     },
     {
-      "path": "../../packages/document-drive"
+      "path": "../../packages/opentelemetry-instrumentation-reactor"
     },
     {
-      "path": "../../packages/config"
+      "path": "../../packages/reactor"
     },
     {
       "path": "../../packages/reactor-api"
     },
     {
       "path": "../../packages/renown"
+    },
+    {
+      "path": "../../packages/shared"
+    },
+    {
+      "path": "../../packages/vetra"
     }
   ]
 }

package/tsdown.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: [
+    "src/index.mts",
+    "src/server.mts",
+    "src/utils.mts",
+    "src/install-packages.mts",
+    "src/migrate.mts",
+  ],
+  platform: "node",
+  outDir: "dist",
+  clean: true,
+  dts: true,
+  sourcemap: true,
+});

package/vitest.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    pool: "forks",
+    environment: "node",
+    isolate: true,
+    maxWorkers: 1,
+    include: ["test/**/*.test.ts"],
+  },
+});