@rudderhq/server 0.7.2 → 0.7.4

package/dist/services/plugin-loader.helpers.js

@@ -1,238 +0,0 @@
-import { execFile } from "node:child_process";
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { promisify } from "node:util";
-export const execFileAsync = promisify(execFile);
-export const __dirname = path.dirname(fileURLToPath(import.meta.url));
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/**
- * Naming convention for npm-published Rudder plugins.
- * Packages matching this pattern are considered Rudder plugins.
- *
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Package Contract
- */
-export const NPM_PLUGIN_PACKAGE_PREFIX = "rudder-plugin-";
-/**
- * Default local plugin directory.  The loader scans this directory for
- * locally-installed plugin packages.
- *
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — On-Disk Layout
- */
-export const DEFAULT_LOCAL_PLUGIN_DIR = path.join(os.homedir(), ".rudder", "plugins");
-export const DEV_TSX_LOADER_PATH = path.resolve(__dirname, "../../../cli/node_modules/tsx/dist/loader.mjs");
-export function getDeclaredPageRoutePaths(manifest) {
-    return (manifest.ui?.slots ?? [])
-        .filter((slot) => slot.type === "page" && typeof slot.routePath === "string" && slot.routePath.length > 0)
-        .map((slot) => slot.routePath);
-}
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/**
- * Check whether a package name matches the Rudder plugin naming convention.
- * Accepts both the "rudder-plugin-" prefix and scoped "@scope/plugin-" packages.
- *
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Package Contract
- */
-export function isPluginPackageName(name) {
-    if (name.startsWith(NPM_PLUGIN_PACKAGE_PREFIX))
-        return true;
-    // Also accept scoped packages like @acme/plugin-linear or @rudderhq/plugin-*
-    if (name.includes("/")) {
-        const localPart = name.split("/")[1] ?? "";
-        return localPart.startsWith("plugin-");
-    }
-    return false;
-}
-/**
- * Read and parse a package.json from a directory path.
- * Returns null if no package.json exists.
- */
-export async function readPackageJson(dir) {
-    const pkgPath = path.join(dir, "package.json");
-    if (!existsSync(pkgPath))
-        return null;
-    try {
-        const raw = await readFile(pkgPath, "utf-8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Resolve the manifest entrypoint from a package.json and package root.
- *
- * Rudder plugin packages define a "rudderPlugin" key in package.json with a
- * "manifest" subkey pointing to the manifest module. This helper resolves the
- * path.
- *
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Package Contract
- */
-export function resolveManifestPath(packageRoot, pkgJson) {
-    const rudderPlugin = pkgJson["rudderPlugin"];
-    if (rudderPlugin !== null &&
-        typeof rudderPlugin === "object" &&
-        !Array.isArray(rudderPlugin)) {
-        const manifestRelPath = rudderPlugin["manifest"];
-        if (typeof manifestRelPath === "string") {
-            // NOTE: the resolved path is returned as-is even if the file does not yet
-            // exist on disk (e.g. the package has not been built).  Callers MUST guard
-            // with existsSync() before passing the path to loadManifestFromPath().
-            return path.resolve(packageRoot, manifestRelPath);
-        }
-    }
-    // Fallback: look for dist/manifest.js as a convention
-    const conventionalPath = path.join(packageRoot, "dist", "manifest.js");
-    if (existsSync(conventionalPath)) {
-        return conventionalPath;
-    }
-    // Fallback: look for manifest.js at package root
-    const rootManifestPath = path.join(packageRoot, "manifest.js");
-    if (existsSync(rootManifestPath)) {
-        return rootManifestPath;
-    }
-    return null;
-}
-export function parseSemver(version) {
-    const match = version.match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/);
-    if (!match)
-        return null;
-    return {
-        major: Number(match[1]),
-        minor: Number(match[2]),
-        patch: Number(match[3]),
-        prerelease: match[4] ? match[4].split(".") : [],
-    };
-}
-export function compareIdentifiers(left, right) {
-    const leftIsNumeric = /^\d+$/.test(left);
-    const rightIsNumeric = /^\d+$/.test(right);
-    if (leftIsNumeric && rightIsNumeric) {
-        return Number(left) - Number(right);
-    }
-    if (leftIsNumeric)
-        return -1;
-    if (rightIsNumeric)
-        return 1;
-    return left.localeCompare(right);
-}
-export function compareSemver(left, right) {
-    const leftParsed = parseSemver(left);
-    const rightParsed = parseSemver(right);
-    if (!leftParsed || !rightParsed) {
-        throw new Error(`Invalid semver comparison: '${left}' vs '${right}'`);
-    }
-    const coreOrder = ["major", "minor", "patch"].map((key) => leftParsed[key] - rightParsed[key]).find((delta) => delta !== 0);
-    if (coreOrder) {
-        return coreOrder;
-    }
-    if (leftParsed.prerelease.length === 0 && rightParsed.prerelease.length === 0) {
-        return 0;
-    }
-    if (leftParsed.prerelease.length === 0)
-        return 1;
-    if (rightParsed.prerelease.length === 0)
-        return -1;
-    const maxLength = Math.max(leftParsed.prerelease.length, rightParsed.prerelease.length);
-    for (let index = 0; index < maxLength; index += 1) {
-        const leftId = leftParsed.prerelease[index];
-        const rightId = rightParsed.prerelease[index];
-        if (leftId === undefined)
-            return -1;
-        if (rightId === undefined)
-            return 1;
-        const diff = compareIdentifiers(leftId, rightId);
-        if (diff !== 0)
-            return diff;
-    }
-    return 0;
-}
-export function getMinimumHostVersion(manifest) {
-    return manifest.minimumHostVersion ?? manifest.minimumPaperclipVersion;
-}
-/**
- * Extract UI contribution metadata from a manifest for route serialization.
- *
- * Returns `null` when the plugin does not declare any UI slots or launchers.
- * Launcher declarations are aggregated from both the legacy top-level
- * `launchers` field and the preferred `ui.launchers` field.
- */
-export function getPluginUiContributionMetadata(manifest) {
-    const slots = manifest.ui?.slots ?? [];
-    const launchers = [
-        ...(manifest.launchers ?? []),
-        ...(manifest.ui?.launchers ?? []),
-    ];
-    if (slots.length === 0 && launchers.length === 0) {
-        return null;
-    }
-    return {
-        uiEntryFile: "index.js",
-        slots,
-        launchers,
-    };
-}
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-/**
- * Create a PluginLoader service.
- *
- * The loader is responsible for plugin discovery, installation, and runtime
- * activation.  It reads plugin packages from the local filesystem and npm,
- * validates their manifests, registers them in the database, and — when
- * runtime services are provided — initialises worker processes, event
- * subscriptions, job schedules, webhook endpoints, and agent tools.
- *
- * Usage (discovery & install only):
- * ```ts
- * const loader = pluginLoader(db, { enableLocalFilesystem: true });
- *
- * // Discover all available plugins
- * const result = await loader.discoverAll();
- * for (const plugin of result.discovered) {
- *   console.log(plugin.packageName, plugin.manifest?.id);
- * }
- *
- * // Install a specific plugin
- * const discovered = await loader.installPlugin({
- *   packageName: "rudder-plugin-linear",
- *   version: "^1.0.0",
- * });
- * ```
- *
- * Usage (full runtime activation at server startup):
- * ```ts
- * const loader = pluginLoader(db, loaderOpts, {
- *   workerManager,
- *   eventBus,
- *   jobScheduler,
- *   jobStore,
- *   toolDispatcher,
- *   lifecycleManager,
- *   buildHostHandlers: (pluginId, manifest) => ({ ... }),
- *   instanceInfo: { instanceId: "inst-1", hostVersion: "1.0.0" },
- * });
- *
- * // Load all ready plugins at startup
- * const loadResult = await loader.loadAll();
- * console.log(`Loaded ${loadResult.succeeded}/${loadResult.total} plugins`);
- *
- * // Load a single plugin after install
- * const singleResult = await loader.loadSingle(pluginId);
- *
- * // Shutdown all plugin workers on server exit
- * await loader.shutdownAll();
- * ```
- *
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — On-Disk Layout
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Install Process
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Process Model
- */
-//# sourceMappingURL=plugin-loader.helpers.js.map

package/dist/services/plugin-loader.helpers.js.map

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

package/dist/services/plugin-loader.js

@@ -1,30 +0,0 @@
-/**
- * PluginLoader — discovery, installation, and runtime activation of plugins.
- *
- * This service is the entry point for the plugin system's I/O boundary:
- *
- * 1. **Discovery** — Scans the local plugin directory
- *    (`~/.rudder/plugins/`) and `node_modules` for packages matching
- *    the `rudder-plugin-*` naming convention. Aggregates results with
- *    path-based deduplication.
- *
- * 2. **Installation** — `installPlugin()` downloads from npm (or reads a
- *    local path), validates the manifest, checks capability consistency,
- *    and persists the install record.
- *
- * 3. **Runtime activation** — `activatePlugin()` wires up a loaded plugin
- *    with all runtime services: resolves its entrypoint, builds
- *    capability-gated host handlers, spawns a worker process, syncs job
- *    declarations, registers event subscriptions, and discovers tools.
- *
- * 4. **Shutdown** — `shutdownAll()` gracefully stops all active workers
- *    and unregisters runtime hooks.
- *
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin Discovery
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Package Contract
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Process Model
- */
-export * from "./plugin-loader.core.js";
-export * from "./plugin-loader.helpers.js";
-export * from "./plugin-loader.worker-paths.js";
-//# sourceMappingURL=plugin-loader.js.map

package/dist/services/plugin-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-loader.js","sourceRoot":"","sources":["../../src/services/plugin-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC"}

package/dist/services/plugin-loader.worker-paths.d.ts

@@ -1,37 +0,0 @@
-/**
- * PluginLoader — discovery, installation, and runtime activation of plugins.
- *
- * This service is the entry point for the plugin system's I/O boundary:
- *
- * 1. **Discovery** — Scans the local plugin directory
- *    (`~/.rudder/plugins/`) and `node_modules` for packages matching
- *    the `rudder-plugin-*` naming convention. Aggregates results with
- *    path-based deduplication.
- *
- * 2. **Installation** — `installPlugin()` downloads from npm (or reads a
- *    local path), validates the manifest, checks capability consistency,
- *    and persists the install record.
- *
- * 3. **Runtime activation** — `activatePlugin()` wires up a loaded plugin
- *    with all runtime services: resolves its entrypoint, builds
- *    capability-gated host handlers, spawns a worker process, syncs job
- *    declarations, registers event subscriptions, and discovers tools.
- *
- * 4. **Shutdown** — `shutdownAll()` gracefully stops all active workers
- *    and unregisters runtime hooks.
- *
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin Discovery
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Package Contract
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Process Model
- */
-import type { PluginRecord } from "@rudderhq/shared";
-export interface PluginPackageResolutionOptions {
-    serverPackageRoot?: string;
-}
-export declare function resolvePluginPackageCandidateDirs(localPluginDir: string, packageName: string, packagePath?: string | null, options?: PluginPackageResolutionOptions): string[];
-export declare function resolveWorkerEntrypoint(plugin: PluginRecord & {
-    packagePath?: string | null;
-}, localPluginDir: string, options?: PluginPackageResolutionOptions): string;
-export declare function resolveManagedInstallPackageDir(localPluginDir: string, packageName: string): string;
-export declare function isPathInsideDir(candidatePath: string, parentDir: string): boolean;
-//# sourceMappingURL=plugin-loader.worker-paths.d.ts.map

package/dist/services/plugin-loader.worker-paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-loader.worker-paths.d.ts","sourceRoot":"","sources":["../../src/services/plugin-loader.worker-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EACV,YAAY,EACb,MAAM,kBAAkB,CAAC;AAO1B,MAAM,WAAW,8BAA8B;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD,wBAAgB,iCAAiC,CAC/C,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,GAAE,8BAAmC,GAC3C,MAAM,EAAE,CA4BV;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACtD,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,8BAAmC,GAC3C,MAAM,CAmCR;AAED,wBAAgB,+BAA+B,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAKnG;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAKjF"}

package/dist/services/plugin-loader.worker-paths.js

@@ -1,62 +0,0 @@
-import { existsSync } from "node:fs";
-import path from "node:path";
-import { __dirname } from "./plugin-loader.helpers.js";
-const SERVER_PACKAGE_ROOT = path.resolve(__dirname, "../..");
-const BUNDLED_PLUGIN_PACKAGE_DIRS = new Map([
-    ["@rudderhq/plugin-linear", "plugin-linear"],
-]);
-export function resolvePluginPackageCandidateDirs(localPluginDir, packageName, packagePath, options = {}) {
-    const candidates = [];
-    if (packagePath && existsSync(packagePath)) {
-        candidates.push(path.resolve(packagePath));
-    }
-    if (packageName.startsWith("@")) {
-        candidates.push(path.join(localPluginDir, "node_modules", ...packageName.split("/")));
-    }
-    else {
-        candidates.push(path.join(localPluginDir, "node_modules", packageName));
-    }
-    candidates.push(path.join(localPluginDir, packageName));
-    const bundledPluginDirName = BUNDLED_PLUGIN_PACKAGE_DIRS.get(packageName);
-    if (bundledPluginDirName) {
-        candidates.push(path.join(options.serverPackageRoot ?? SERVER_PACKAGE_ROOT, "dist", "bundled-plugins", bundledPluginDirName));
-    }
-    return [...new Set(candidates.map((candidate) => path.resolve(candidate)))];
-}
-export function resolveWorkerEntrypoint(plugin, localPluginDir, options = {}) {
-    const manifest = plugin.manifestJson;
-    const workerRelPath = manifest.entrypoints.worker;
-    const packageName = plugin.packageName;
-    const checkedEntrypoints = [];
-    for (const dir of resolvePluginPackageCandidateDirs(localPluginDir, packageName, plugin.packagePath, options)) {
-        const entrypoint = path.resolve(dir, workerRelPath);
-        checkedEntrypoints.push(entrypoint);
-        // Security: ensure entrypoint is actually inside the directory (prevent path traversal)
-        if (!isPathInsideDir(entrypoint, dir)) {
-            continue;
-        }
-        if (existsSync(entrypoint)) {
-            return entrypoint;
-        }
-    }
-    // Fallback: try the worker path as-is (absolute or relative to cwd)
-    // ONLY if it's already an absolute path and we trust the manifest (which we've already validated)
-    if (path.isAbsolute(workerRelPath) && existsSync(workerRelPath)) {
-        return workerRelPath;
-    }
-    throw new Error(`Worker entrypoint not found for plugin "${plugin.pluginKey}". ` +
-        `Checked: ${checkedEntrypoints.join(", ")}`);
-}
-export function resolveManagedInstallPackageDir(localPluginDir, packageName) {
-    if (packageName.startsWith("@")) {
-        return path.join(localPluginDir, "node_modules", ...packageName.split("/"));
-    }
-    return path.join(localPluginDir, "node_modules", packageName);
-}
-export function isPathInsideDir(candidatePath, parentDir) {
-    const resolvedCandidate = path.resolve(candidatePath);
-    const resolvedParent = path.resolve(parentDir);
-    const relative = path.relative(resolvedParent, resolvedCandidate);
-    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
-}
-//# sourceMappingURL=plugin-loader.worker-paths.js.map

package/dist/services/plugin-loader.worker-paths.js.map

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

package/dist/services/plugin-log-retention.d.ts

@@ -1,20 +0,0 @@
-import type { Db } from "@rudderhq/db";
-/**
- * Delete plugin log rows older than `retentionDays`.
- *
- * Deletes in batches of `DELETE_BATCH_SIZE` to keep transaction sizes
- * bounded and avoid holding locks for extended periods.
- *
- * @returns The total number of rows deleted.
- */
-export declare function prunePluginLogs(db: Db, retentionDays?: number): Promise<number>;
-/**
- * Start a periodic plugin log cleanup interval.
- *
- * @param db - Database connection
- * @param intervalMs - How often to run (default: 1 hour)
- * @param retentionDays - How many days of logs to keep (default: 7)
- * @returns A cleanup function that stops the interval
- */
-export declare function startPluginLogRetention(db: Db, intervalMs?: number, retentionDays?: number): () => void;
-//# sourceMappingURL=plugin-log-retention.d.ts.map

package/dist/services/plugin-log-retention.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-log-retention.d.ts","sourceRoot":"","sources":["../../src/services/plugin-log-retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAcvC;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,EAAE,EACN,aAAa,GAAE,MAA+B,GAC7C,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,EAAE,EACN,UAAU,GAAE,MAAwB,EACpC,aAAa,GAAE,MAA+B,GAC7C,MAAM,IAAI,CAaZ"}

package/dist/services/plugin-log-retention.js

@@ -1,63 +0,0 @@
-import { pluginLogs } from "@rudderhq/db";
-import { lt } from "drizzle-orm";
-import { logger } from "../middleware/logger.js";
-/** Default retention period: 7 days. */
-const DEFAULT_RETENTION_DAYS = 7;
-/** Maximum rows to delete per sweep to avoid long-running transactions. */
-const DELETE_BATCH_SIZE = 5_000;
-/** Maximum number of batches per sweep to guard against unbounded loops. */
-const MAX_ITERATIONS = 100;
-/**
- * Delete plugin log rows older than `retentionDays`.
- *
- * Deletes in batches of `DELETE_BATCH_SIZE` to keep transaction sizes
- * bounded and avoid holding locks for extended periods.
- *
- * @returns The total number of rows deleted.
- */
-export async function prunePluginLogs(db, retentionDays = DEFAULT_RETENTION_DAYS) {
-    const cutoff = new Date();
-    cutoff.setDate(cutoff.getDate() - retentionDays);
-    let totalDeleted = 0;
-    let iterations = 0;
-    // Delete in batches to avoid long-running transactions
-    while (iterations < MAX_ITERATIONS) {
-        const deleted = await db
-            .delete(pluginLogs)
-            .where(lt(pluginLogs.createdAt, cutoff))
-            .returning({ id: pluginLogs.id })
-            .then((rows) => rows.length);
-        totalDeleted += deleted;
-        iterations++;
-        if (deleted < DELETE_BATCH_SIZE)
-            break;
-    }
-    if (iterations >= MAX_ITERATIONS) {
-        logger.warn({ totalDeleted, iterations, cutoffDate: cutoff }, "Plugin log retention hit iteration limit; some logs may remain");
-    }
-    if (totalDeleted > 0) {
-        logger.info({ totalDeleted, retentionDays }, "Pruned expired plugin logs");
-    }
-    return totalDeleted;
-}
-/**
- * Start a periodic plugin log cleanup interval.
- *
- * @param db - Database connection
- * @param intervalMs - How often to run (default: 1 hour)
- * @param retentionDays - How many days of logs to keep (default: 7)
- * @returns A cleanup function that stops the interval
- */
-export function startPluginLogRetention(db, intervalMs = 60 * 60 * 1_000, retentionDays = DEFAULT_RETENTION_DAYS) {
-    const timer = setInterval(() => {
-        prunePluginLogs(db, retentionDays).catch((err) => {
-            logger.warn({ err }, "Plugin log retention sweep failed");
-        });
-    }, intervalMs);
-    // Run once immediately on startup
-    prunePluginLogs(db, retentionDays).catch((err) => {
-        logger.warn({ err }, "Initial plugin log retention sweep failed");
-    });
-    return () => clearInterval(timer);
-}
-//# sourceMappingURL=plugin-log-retention.js.map

package/dist/services/plugin-log-retention.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-log-retention.js","sourceRoot":"","sources":["../../src/services/plugin-log-retention.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,wCAAwC;AACxC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,2EAA2E;AAC3E,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC,4EAA4E;AAC5E,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,EAAM,EACN,gBAAwB,sBAAsB;IAE9C,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAC1B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC;IAEjD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,uDAAuD;IACvD,OAAO,UAAU,GAAG,cAAc,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,EAAE;aACrB,MAAM,CAAC,UAAU,CAAC;aAClB,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;aACvC,SAAS,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC;aAChC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE/B,YAAY,IAAI,OAAO,CAAC;QACxB,UAAU,EAAE,CAAC;QAEb,IAAI,OAAO,GAAG,iBAAiB;YAAE,MAAM;IACzC,CAAC;IAED,IAAI,UAAU,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CACT,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,EAChD,gEAAgE,CACjE,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,4BAA4B,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,EAAM,EACN,aAAqB,EAAE,GAAG,EAAE,GAAG,KAAK,EACpC,gBAAwB,sBAAsB;IAE9C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,eAAe,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,mCAAmC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,UAAU,CAAC,CAAC;IAEf,kCAAkC;IAClC,eAAe,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,2CAA2C,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/services/plugin-manifest-validator.d.ts

@@ -1,90 +0,0 @@
-/**
- * PluginManifestValidator — schema validation for plugin manifest files.
- *
- * Uses the shared Zod schema (`pluginManifestV1Schema`) to validate
- * manifest payloads. Provides both a safe `parse()` variant (returns
- * a result union) and a throwing `parseOrThrow()` for HTTP error
- * propagation at install time.
- *
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin Manifest
- * @see packages/shared/src/validators/plugin.ts — Zod schema definition
- */
-import type { PaperclipPluginManifestV1 } from "@rudderhq/shared";
-/**
- * Successful parse result.
- */
-export interface ManifestParseSuccess {
-    success: true;
-    manifest: PaperclipPluginManifestV1;
-}
-/**
- * Failed parse result. `errors` is a human-readable description of what went
- * wrong; `details` is the raw Zod error list for programmatic inspection.
- */
-export interface ManifestParseFailure {
-    success: false;
-    errors: string;
-    details: Array<{
-        path: (string | number)[];
-        message: string;
-    }>;
-}
-/** Union of parse outcomes. */
-export type ManifestParseResult = ManifestParseSuccess | ManifestParseFailure;
-/**
- * Service for parsing and validating plugin manifests.
- *
- * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin Manifest
- */
-export interface PluginManifestValidator {
-    /**
-     * Try to parse `input` as a plugin manifest.
-     *
-     * Returns a {@link ManifestParseSuccess} when the input passes all
-     * validation rules, or a {@link ManifestParseFailure} with human-readable
-     * error messages when it does not.
-     *
-     * This is the "safe" variant — it never throws.
-     */
-    parse(input: unknown): ManifestParseResult;
-    /**
-     * Parse `input` as a plugin manifest, throwing a 400 HttpError on failure.
-     *
-     * Use this at install time when an invalid manifest should surface as an
-     * HTTP error to the caller.
-     *
-     * @throws {HttpError} 400 Bad Request if the manifest is invalid.
-     */
-    parseOrThrow(input: unknown): PaperclipPluginManifestV1;
-    /**
-     * Return the list of plugin API versions supported by this host.
-     *
-     * Callers can use this to present the supported version range to operators
-     * or to decide whether a candidate plugin can be installed.
-     */
-    getSupportedVersions(): readonly number[];
-}
-/**
- * Create a {@link PluginManifestValidator}.
- *
- * Usage:
- * ```ts
- * const validator = pluginManifestValidator();
- *
- * // Safe parse — inspect the result
- * const result = validator.parse(rawManifest);
- * if (!result.success) {
- *   console.error(result.errors);
- *   return;
- * }
- * const manifest = result.manifest;
- *
- * // Throwing parse — use at install time
- * const manifest = validator.parseOrThrow(rawManifest);
- *
- * // Check supported versions
- * const versions = validator.getSupportedVersions(); // [1]
- * ```
- */
-export declare function pluginManifestValidator(): PluginManifestValidator;
-//# sourceMappingURL=plugin-manifest-validator.d.ts.map

package/dist/services/plugin-manifest-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-manifest-validator.d.ts","sourceRoot":"","sources":["../../src/services/plugin-manifest-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAmBlE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,yBAAyB,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,+BAA+B;AAC/B,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAM9E;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAE3C;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAAC;IAExD;;;;;OAKG;IACH,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAAC;CAC3C;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,IAAI,uBAAuB,CA4CjE"}

package/dist/services/plugin-manifest-validator.js

@@ -1,72 +0,0 @@
-import { PLUGIN_API_VERSION, pluginManifestV1Schema } from "@rudderhq/shared";
-import { badRequest } from "../errors.js";
-// ---------------------------------------------------------------------------
-// Supported manifest API versions
-// ---------------------------------------------------------------------------
-/**
- * The set of plugin API versions this host can accept.
- * When a new API version is introduced, add it here. Old versions should be
- * retained until the host drops support for them.
- */
-const SUPPORTED_VERSIONS = [PLUGIN_API_VERSION];
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-/**
- * Create a {@link PluginManifestValidator}.
- *
- * Usage:
- * ```ts
- * const validator = pluginManifestValidator();
- *
- * // Safe parse — inspect the result
- * const result = validator.parse(rawManifest);
- * if (!result.success) {
- *   console.error(result.errors);
- *   return;
- * }
- * const manifest = result.manifest;
- *
- * // Throwing parse — use at install time
- * const manifest = validator.parseOrThrow(rawManifest);
- *
- * // Check supported versions
- * const versions = validator.getSupportedVersions(); // [1]
- * ```
- */
-export function pluginManifestValidator() {
-    return {
-        parse(input) {
-            const result = pluginManifestV1Schema.safeParse(input);
-            if (result.success) {
-                return {
-                    success: true,
-                    manifest: result.data,
-                };
-            }
-            const details = result.error.errors.map((issue) => ({
-                path: issue.path,
-                message: issue.message,
-            }));
-            const errors = details
-                .map(({ path, message }) => path.length > 0 ? `${path.join(".")}: ${message}` : message)
-                .join("; ");
-            return {
-                success: false,
-                errors,
-                details,
-            };
-        },
-        parseOrThrow(input) {
-            const result = this.parse(input);
-            if (!result.success) {
-                throw badRequest(`Invalid plugin manifest: ${result.errors}`, result.details);
-            }
-            return result.manifest;
-        },
-        getSupportedVersions() {
-            return SUPPORTED_VERSIONS;
-        },
-    };
-}
-//# sourceMappingURL=plugin-manifest-validator.js.map

package/dist/services/plugin-manifest-validator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-manifest-validator.js","sourceRoot":"","sources":["../../src/services/plugin-manifest-validator.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CAAC,kBAAkB,CAAU,CAAC;AAmEzD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,KAAK,CAAC,KAAc;YAClB,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAEvD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,MAAM,CAAC,IAAiC;iBACnD,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAClD,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC,CAAC;YAEJ,MAAM,MAAM,GAAG,OAAO;iBACnB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CACzB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAC5D;iBACA,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM;gBACN,OAAO;aACR,CAAC;QACJ,CAAC;QAED,YAAY,CAAC,KAAc;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAEjC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,UAAU,CAAC,4BAA4B,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAChF,CAAC;YAED,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QAED,oBAAoB;YAClB,OAAO,kBAAkB,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}