@rudderhq/server 0.1.0-canary.0

package/dist/home-paths.js

@@ -0,0 +1,183 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { resolveStoredOrDerivedAgentWorkspaceKey } from "./agent-workspace-key.js";
+const DEFAULT_INSTANCE_ID = "default";
+const INSTANCE_ID_RE = /^[a-zA-Z0-9_-]+$/;
+const PATH_SEGMENT_RE = /^[a-zA-Z0-9_-]+$/;
+const FRIENDLY_PATH_SEGMENT_RE = /[^a-zA-Z0-9._-]+/g;
+function expandHomePrefix(value) {
+    if (value === "~")
+        return os.homedir();
+    if (value.startsWith("~/"))
+        return path.resolve(os.homedir(), value.slice(2));
+    return value;
+}
+export function resolveRudderHomeDir() {
+    const envHome = process.env.RUDDER_HOME?.trim();
+    if (envHome)
+        return path.resolve(expandHomePrefix(envHome));
+    return path.resolve(os.homedir(), ".rudder");
+}
+export function resolveRudderInstanceId() {
+    const raw = process.env.RUDDER_INSTANCE_ID?.trim() || DEFAULT_INSTANCE_ID;
+    if (!INSTANCE_ID_RE.test(raw)) {
+        throw new Error(`Invalid RUDDER_INSTANCE_ID '${raw}'.`);
+    }
+    return raw;
+}
+export function resolveRudderInstanceRoot() {
+    return path.resolve(resolveRudderHomeDir(), "instances", resolveRudderInstanceId());
+}
+export function resolveDefaultConfigPath() {
+    return path.resolve(resolveRudderInstanceRoot(), "config.json");
+}
+export function resolveDefaultEmbeddedPostgresDir() {
+    return path.resolve(resolveRudderInstanceRoot(), "db");
+}
+export function resolveDefaultLogsDir() {
+    return path.resolve(resolveRudderInstanceRoot(), "logs");
+}
+export function resolveDefaultSecretsKeyFilePath() {
+    return path.resolve(resolveRudderInstanceRoot(), "secrets", "master.key");
+}
+export function resolveDefaultStorageDir() {
+    return path.resolve(resolveRudderInstanceRoot(), "data", "storage");
+}
+export function resolveDefaultBackupDir() {
+    return path.resolve(resolveRudderInstanceRoot(), "data", "backups");
+}
+export function resolveOrganizationRoot(orgId) {
+    const normalizedOrgId = validatePathSegment(orgId, "org id");
+    return path.resolve(resolveRudderInstanceRoot(), "organizations", normalizedOrgId);
+}
+function validatePathSegment(value, label) {
+    const trimmed = value.trim();
+    if (!PATH_SEGMENT_RE.test(trimmed)) {
+        throw new Error(`Invalid ${label} for workspace path '${value}'.`);
+    }
+    return trimmed;
+}
+function resolveAgentWorkspacePathSegment(agent) {
+    if (typeof agent === "string") {
+        return validatePathSegment(agent, "agent workspace key");
+    }
+    return validatePathSegment(resolveStoredOrDerivedAgentWorkspaceKey(agent), "agent workspace key");
+}
+export function resolveOrganizationWorkspaceRoot(orgId) {
+    return path.resolve(resolveOrganizationRoot(orgId), "workspaces");
+}
+export function resolveDefaultAgentWorkspaceDir(orgId, agent) {
+    const normalizedWorkspaceKey = resolveAgentWorkspacePathSegment(agent);
+    return path.resolve(resolveOrganizationWorkspaceRoot(orgId), "agents", normalizedWorkspaceKey);
+}
+export function resolveAgentInstructionsDir(orgId, agent) {
+    return path.resolve(resolveDefaultAgentWorkspaceDir(orgId, agent), "instructions");
+}
+export function resolveAgentMemoryDir(orgId, agent) {
+    return path.resolve(resolveDefaultAgentWorkspaceDir(orgId, agent), "memory");
+}
+export function resolveAgentSkillsDir(orgId, agent) {
+    return path.resolve(resolveDefaultAgentWorkspaceDir(orgId, agent), "skills");
+}
+export function resolveOrganizationSkillsDir(orgId) {
+    return path.resolve(resolveOrganizationWorkspaceRoot(orgId), "skills");
+}
+export function resolveOrganizationPlansDir(orgId) {
+    return path.resolve(resolveOrganizationWorkspaceRoot(orgId), "plans");
+}
+export function resolveOrganizationAgentsDir(orgId) {
+    return path.resolve(resolveOrganizationWorkspaceRoot(orgId), "agents");
+}
+export function resolveManagedOrganizationCodebaseDir(input) {
+    return path.resolve(resolveOrganizationWorkspaceRoot(input.orgId), "codebase", sanitizeFriendlyPathSegment(input.repoName, "_default"));
+}
+export async function ensureOrganizationWorkspaceLayout(orgId) {
+    const root = resolveOrganizationWorkspaceRoot(orgId);
+    const agentsDir = resolveOrganizationAgentsDir(orgId);
+    const skillsDir = resolveOrganizationSkillsDir(orgId);
+    const plansDir = resolveOrganizationPlansDir(orgId);
+    await Promise.all([
+        fs.mkdir(root, { recursive: true }),
+        fs.mkdir(agentsDir, { recursive: true }),
+        fs.mkdir(skillsDir, { recursive: true }),
+        fs.mkdir(plansDir, { recursive: true }),
+    ]);
+    return { root, agentsDir, skillsDir, plansDir };
+}
+export async function ensureAgentWorkspaceLayout(agent) {
+    await ensureOrganizationWorkspaceLayout(agent.orgId);
+    const workspaceKey = resolveStoredOrDerivedAgentWorkspaceKey(agent);
+    const root = resolveDefaultAgentWorkspaceDir(agent.orgId, workspaceKey);
+    const instructionsDir = resolveAgentInstructionsDir(agent.orgId, workspaceKey);
+    const memoryDir = resolveAgentMemoryDir(agent.orgId, workspaceKey);
+    const skillsDir = resolveAgentSkillsDir(agent.orgId, workspaceKey);
+    await fs.mkdir(root, { recursive: true });
+    await Promise.all([
+        fs.mkdir(instructionsDir, { recursive: true }),
+        fs.mkdir(memoryDir, { recursive: true }),
+        fs.mkdir(skillsDir, { recursive: true }),
+    ]);
+    return {
+        root,
+        instructionsDir,
+        memoryDir,
+        skillsDir,
+    };
+}
+function sanitizeFriendlyPathSegment(value, fallback = "_default") {
+    const trimmed = value?.trim() ?? "";
+    if (!trimmed)
+        return fallback;
+    const sanitized = trimmed
+        .replace(FRIENDLY_PATH_SEGMENT_RE, "-")
+        .replace(/^-+|-+$/g, "");
+    return sanitized || fallback;
+}
+export async function removeOrganizationStorage(orgId) {
+    const normalizedOrgId = validatePathSegment(orgId, "org id");
+    const organizationRootPath = resolveOrganizationRoot(normalizedOrgId);
+    const legacyProjectsRootPath = path.resolve(resolveRudderInstanceRoot(), "projects", normalizedOrgId);
+    await Promise.all([
+        fs.rm(organizationRootPath, { recursive: true, force: true }),
+        // Best-effort cleanup for legacy pre-org-workspace managed project paths.
+        fs.rm(legacyProjectsRootPath, { recursive: true, force: true }),
+    ]);
+    return { organizationRootPath, legacyProjectsRootPath };
+}
+async function listDirectoryNames(rootPath) {
+    try {
+        const entries = await fs.readdir(rootPath, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch (error) {
+        if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+}
+export async function pruneOrphanedOrganizationStorage(liveOrgIds) {
+    const liveOrgIdSet = new Set(liveOrgIds.map((orgId) => validatePathSegment(orgId, "org id")));
+    const organizationRoot = path.resolve(resolveRudderInstanceRoot(), "organizations");
+    const legacyProjectsRoot = path.resolve(resolveRudderInstanceRoot(), "projects");
+    const organizationDirNames = await listDirectoryNames(organizationRoot);
+    const legacyProjectDirNames = await listDirectoryNames(legacyProjectsRoot);
+    const removedOrganizationDirNames = organizationDirNames.filter((dirName) => !liveOrgIdSet.has(dirName));
+    const removedLegacyProjectDirNames = legacyProjectDirNames.filter((dirName) => !liveOrgIdSet.has(dirName));
+    await Promise.all([
+        ...removedOrganizationDirNames.map((dirName) => fs.rm(path.resolve(organizationRoot, dirName), { recursive: true, force: true })),
+        ...removedLegacyProjectDirNames.map((dirName) => fs.rm(path.resolve(legacyProjectsRoot, dirName), { recursive: true, force: true })),
+    ]);
+    return {
+        removedOrganizationDirNames,
+        removedLegacyProjectDirNames,
+    };
+}
+export function resolveHomeAwarePath(value) {
+    return path.resolve(expandHomePrefix(value));
+}
+//# sourceMappingURL=home-paths.js.map

package/dist/home-paths.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import { createServer } from "node:http";
+import type { DeploymentExposure, DeploymentMode } from "@rudderhq/shared";
+import { type LocalRuntimeOwnerKind } from "./local-runtime.js";
+export interface StartedServer {
+    server: ReturnType<typeof createServer>;
+    host: string;
+    listenPort: number;
+    apiUrl: string;
+    databaseUrl: string;
+    instancePaths: {
+        homeDir: string;
+        instanceRoot: string;
+        configPath: string;
+        envPath: string;
+    };
+    stop(): Promise<void>;
+    dispose(): Promise<void>;
+}
+export interface ManagedStartedServer {
+    host: string;
+    listenPort: number;
+    apiUrl: string;
+    databaseUrl: string | null;
+    instancePaths: StartedServer["instancePaths"];
+    runtime: {
+        mode: "owned" | "attached";
+        instanceId: string;
+        localEnv: string | null;
+        ownerKind: LocalRuntimeOwnerKind | null;
+        version: string;
+        descriptorPath: string;
+        lockPath: string;
+        startedAt: string | null;
+    };
+    stop(): Promise<void>;
+    dispose(): Promise<void>;
+}
+export type ServerBootstrapStage = "config" | "database" | "app" | "listening" | "ready" | "shutdown";
+export interface ServerBootstrapEvent {
+    stage: ServerBootstrapStage;
+    message: string;
+}
+export interface ServerRuntimeOverrides {
+    host?: string;
+    port?: number;
+    deploymentMode?: DeploymentMode;
+    deploymentExposure?: DeploymentExposure;
+    serveUi?: boolean;
+    uiDevMiddleware?: boolean;
+    heartbeatSchedulerEnabled?: boolean;
+    databaseBackupEnabled?: boolean;
+}
+export interface StartServerOptions {
+    runtimeOverrides?: ServerRuntimeOverrides;
+    openOnListen?: boolean;
+    printBanner?: boolean;
+    onEvent?: (event: ServerBootstrapEvent) => void;
+    runtimeOwnerKind?: LocalRuntimeOwnerKind | null;
+}
+export interface StartManagedLocalServerOptions extends StartServerOptions {
+    ownerKind: LocalRuntimeOwnerKind;
+    takeoverOnVersionMismatch?: boolean;
+    preferredOwner?: boolean;
+    runtimeStartupLockTimeoutMs?: number;
+    gracefulStopTimeoutMs?: number;
+}
+export declare function startManagedLocalServer(options: StartManagedLocalServerOptions): Promise<ManagedStartedServer>;
+export declare function startServer(options?: StartServerOptions): Promise<StartedServer>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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