@relkit/cli 0.0.0

package/dist/commands/start.js

@@ -0,0 +1,121 @@
+import { join, resolve } from "node:path";
+import { API_BASE_PATH } from "@relkit/contracts";
+import { DEFAULT_CANDIDATE_HEALTH_TIMEOUT_MS } from "@relkit/supervisor";
+import { resolveApplicationPort } from "./ports.js";
+import { readBuilt } from "./start-built.js";
+/** Validates the built graph/manifest, waits for health/readiness, and owns shutdown. */
+export async function startProject(options = {}) {
+    const projectRoot = resolve(options.projectRoot ?? process.cwd());
+    const buildDirectory = resolve(options.buildDirectory ?? join(projectRoot, ".relkit", "build"));
+    const built = await readBuilt(buildDirectory);
+    const hostname = options.hostname ?? "127.0.0.1";
+    const inherited = Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== undefined));
+    const source = {
+        ...inherited,
+        ...Object.fromEntries(Object.entries(options.environment ?? {}).filter((entry) => entry[1] !== undefined)),
+    };
+    const port = await allocatePort(resolveApplicationPort({
+        ...(options.port === undefined ? {} : { flag: options.port }),
+        source,
+        ...(built.manifest.server?.port === undefined
+            ? {}
+            : { configured: built.manifest.server.port }),
+    }), hostname);
+    if (options.signal?.aborted)
+        throw options.signal.reason ?? new Error("Start was aborted.");
+    const environment = {
+        ...source,
+        PORT: String(port),
+        RELKIT_GRAPH_HASH: built.graphHash,
+    };
+    const entrypoint = join(buildDirectory, built.manifest.containerEntrypoint);
+    const spawn = options.spawn ?? Bun.spawn;
+    const child = spawn([process.execPath, "run", "--no-env-file", "--no-install", "--silent", entrypoint], {
+        cwd: projectRoot,
+        env: environment,
+        stdin: "ignore",
+        stdout: "pipe",
+        stderr: "pipe",
+    });
+    void new Response(child.stdout).text();
+    void new Response(child.stderr).text();
+    let stopping;
+    let abort;
+    const stop = async () => {
+        stopping ??= stopChild(child, options.stopTimeoutMs ?? 1_000);
+        await stopping;
+        if (abort !== undefined)
+            options.signal?.removeEventListener("abort", abort);
+    };
+    abort = () => void stop();
+    options.signal?.addEventListener("abort", abort, { once: true });
+    try {
+        await waitForHealth(hostname, port, options.healthTimeoutMs ?? DEFAULT_CANDIDATE_HEALTH_TIMEOUT_MS, options.fetch ?? fetch, child);
+        return Object.freeze({
+            projectRoot,
+            buildDirectory,
+            hostname,
+            port,
+            process: child,
+            exited: child.exited,
+            stop,
+        });
+    }
+    catch (error) {
+        await stop();
+        options.signal?.removeEventListener("abort", abort);
+        throw error;
+    }
+}
+export async function runStart(options = {}) {
+    const server = await startProject(options);
+    return server.exited;
+}
+async function waitForHealth(hostname, port, timeoutMs, fetcher, child) {
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1)
+        throw new RangeError("healthTimeoutMs must be a positive safe integer.");
+    const deadline = Date.now() + timeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+        if (child.exitCode !== null)
+            throw new Error(`Built server exited with code ${child.exitCode}.`);
+        try {
+            const live = await fetcher(`http://${hostname}:${port}${API_BASE_PATH}/health/live`);
+            const ready = await fetcher(`http://${hostname}:${port}${API_BASE_PATH}/health/ready`);
+            if (live.ok && ready.ok)
+                return;
+        }
+        catch (error) {
+            lastError = error;
+        }
+        await new Promise((resolveDelay) => setTimeout(resolveDelay, Math.min(25, deadline - Date.now())));
+    }
+    throw new Error(`Built server did not become ready${lastError instanceof Error ? `: ${lastError.message}` : "."}`);
+}
+async function stopChild(child, timeoutMs) {
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0)
+        throw new RangeError("stopTimeoutMs must be a non-negative safe integer.");
+    if (child.exitCode === null)
+        child.kill("SIGTERM");
+    const exited = await Promise.race([
+        child.exited.then(() => true),
+        new Promise((resolve) => setTimeout(() => resolve(false), timeoutMs)),
+    ]);
+    if (!exited && child.exitCode === null) {
+        child.kill("SIGKILL");
+        await child.exited;
+    }
+}
+async function allocatePort(port, hostname) {
+    if (!Number.isSafeInteger(port) || port < 0 || port > 65_535)
+        throw new RangeError("port must be between 0 and 65535.");
+    if (port !== 0)
+        return port;
+    const probe = Bun.serve({ hostname, port: 0, fetch: () => new Response() });
+    const allocated = probe.port;
+    await probe.stop(true);
+    if (allocated === undefined)
+        throw new Error("Unable to allocate a start port.");
+    return allocated;
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env bun
+export * from "./commands/dev.js";
+export * from "./main.js";
+//# 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":";AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env bun
+import { existsSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+export * from "./commands/dev.js";
+export * from "./main.js";
+import { main } from "./main.js";
+async function run() {
+    const root = resolve(import.meta.dir, "../../..");
+    const launcher = join(root, "scripts/relkit-local.ts");
+    const cwd = relative(root, process.cwd()).replaceAll("\\", "/");
+    const workspace = cwd === "" || /^(?:apps|examples|packages)(?:\/|$)/.test(cwd);
+    if (!existsSync(launcher) || workspace)
+        return main();
+    return Bun.spawn([process.execPath, launcher, ...process.argv.slice(2)], {
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit",
+    }).exited;
+}
+if (import.meta.main)
+    process.exitCode = await run();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpD,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,KAAK,UAAU,GAAG;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,GAAG,KAAK,EAAE,IAAI,qCAAqC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,SAAS;QAAE,OAAO,IAAI,EAAE,CAAC;IACtD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;QACvE,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC,MAAM,CAAC;AACZ,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI;IAAE,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,EAAE,CAAC"}

package/dist/inspector/.next-packaged/BUILD_ID

@@ -0,0 +1 @@
+relkit

package/dist/inspector/.next-packaged/app-path-routes-manifest.json

@@ -0,0 +1,35 @@
+{
+  "/_global-error/page": "/_global-error",
+  "/_not-found/page": "/_not-found",
+  "/_relkit/backend/[...path]/route": "/_relkit/backend/[...path]",
+  "/agents/[id]/page": "/agents/[id]",
+  "/agents/page": "/agents",
+  "/api-reference/page": "/api-reference",
+  "/buckets/[id]/page": "/buckets/[id]",
+  "/buckets/page": "/buckets",
+  "/cache/[id]/page": "/cache/[id]",
+  "/cache/page": "/cache",
+  "/diagnostics/page": "/diagnostics",
+  "/env/page": "/env",
+  "/events/[id]/page": "/events/[id]",
+  "/events/page": "/events",
+  "/functions/[id]/page": "/functions/[id]",
+  "/functions/page": "/functions",
+  "/graph/page": "/graph",
+  "/jobs/[id]/page": "/jobs/[id]",
+  "/jobs/page": "/jobs",
+  "/logs/page": "/logs",
+  "/middlewares/[id]/page": "/middlewares/[id]",
+  "/middlewares/page": "/middlewares",
+  "/page": "/",
+  "/providers/[id]/page": "/providers/[id]",
+  "/providers/page": "/providers",
+  "/requests/[requestId]/page": "/requests/[requestId]",
+  "/requests/page": "/requests",
+  "/routes/[id]/page": "/routes/[id]",
+  "/routes/page": "/routes",
+  "/tools/[id]/page": "/tools/[id]",
+  "/tools/page": "/tools",
+  "/traces/[traceId]/page": "/traces/[traceId]",
+  "/traces/page": "/traces"
+}

package/dist/inspector/.next-packaged/build-manifest.json

@@ -0,0 +1,24 @@
+{
+  "pages": {
+    "/_app": []
+  },
+  "devFiles": [],
+  "polyfillFiles": [
+    "static/chunks/0cz1d0mv5g_q7.js"
+  ],
+  "lowPriorityFiles": [
+    "static/relkit/_buildManifest.js",
+    "static/relkit/_ssgManifest.js",
+    "static/relkit/_clientMiddlewareManifest.js"
+  ],
+  "rootMainFiles": [
+    "static/chunks/1nn7govuunqqi.js",
+    "static/chunks/0abk7w__c47w4.js",
+    "static/chunks/1jins34-u_ktx.js",
+    "static/chunks/2a08fxqwpmmrq.js",
+    "static/chunks/turbopack-1pvexuw7eouia.js"
+  ],
+  "rootMainFilesTree": {},
+  "pagesChunkGroupBootstrapParams": {},
+  "chunkLoadingGlobal": "TURBOPACK"
+}

package/dist/inspector/.next-packaged/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}