@generacy-ai/cluster-relay 0.0.0-preview-20260314042105

package/dist/messages.d.ts

@@ -0,0 +1,252 @@
+import { z } from 'zod';
+export interface ApiRequestMessage {
+    type: 'api_request';
+    id: string;
+    method: string;
+    path: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+export interface ApiResponseMessage {
+    type: 'api_response';
+    id: string;
+    status: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+export interface EventMessage {
+    type: 'event';
+    channel: string;
+    event: unknown;
+}
+export interface ConversationMessage {
+    type: 'conversation';
+    conversationId: string;
+    data: unknown;
+}
+export interface HeartbeatMessage {
+    type: 'heartbeat';
+}
+export interface HandshakeMessage {
+    type: 'handshake';
+    metadata: ClusterMetadata;
+}
+export interface ErrorMessage {
+    type: 'error';
+    code: string;
+    message: string;
+}
+export type RelayMessage = ApiRequestMessage | ApiResponseMessage | EventMessage | ConversationMessage | HeartbeatMessage | HandshakeMessage | ErrorMessage;
+export interface GitRemote {
+    name: string;
+    url: string;
+}
+export interface ClusterMetadata {
+    workerCount: number;
+    activeWorkflows: number;
+    channel: 'preview' | 'stable';
+    orchestratorVersion: string;
+    gitRemotes: GitRemote[];
+    uptime: number;
+}
+declare const GitRemoteSchema: z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    url: string;
+}, {
+    name: string;
+    url: string;
+}>;
+declare const ClusterMetadataSchema: z.ZodObject<{
+    workerCount: z.ZodNumber;
+    activeWorkflows: z.ZodNumber;
+    channel: z.ZodEnum<["preview", "stable"]>;
+    orchestratorVersion: z.ZodString;
+    gitRemotes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        url: string;
+    }, {
+        name: string;
+        url: string;
+    }>, "many">;
+    uptime: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    workerCount: number;
+    activeWorkflows: number;
+    channel: "preview" | "stable";
+    orchestratorVersion: string;
+    gitRemotes: {
+        name: string;
+        url: string;
+    }[];
+    uptime: number;
+}, {
+    workerCount: number;
+    activeWorkflows: number;
+    channel: "preview" | "stable";
+    orchestratorVersion: string;
+    gitRemotes: {
+        name: string;
+        url: string;
+    }[];
+    uptime: number;
+}>;
+export declare const RelayMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"api_request">;
+    id: z.ZodString;
+    method: z.ZodString;
+    path: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "api_request";
+    id: string;
+    method: string;
+    headers?: Record<string, string> | undefined;
+    body?: unknown;
+}, {
+    path: string;
+    type: "api_request";
+    id: string;
+    method: string;
+    headers?: Record<string, string> | undefined;
+    body?: unknown;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"api_response">;
+    id: z.ZodString;
+    status: z.ZodNumber;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    type: "api_response";
+    status: number;
+    id: string;
+    headers?: Record<string, string> | undefined;
+    body?: unknown;
+}, {
+    type: "api_response";
+    status: number;
+    id: string;
+    headers?: Record<string, string> | undefined;
+    body?: unknown;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"event">;
+    channel: z.ZodString;
+    event: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    type: "event";
+    channel: string;
+    event?: unknown;
+}, {
+    type: "event";
+    channel: string;
+    event?: unknown;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation">;
+    conversationId: z.ZodString;
+    data: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    type: "conversation";
+    conversationId: string;
+    data?: unknown;
+}, {
+    type: "conversation";
+    conversationId: string;
+    data?: unknown;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat">;
+}, "strip", z.ZodTypeAny, {
+    type: "heartbeat";
+}, {
+    type: "heartbeat";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"handshake">;
+    metadata: z.ZodObject<{
+        workerCount: z.ZodNumber;
+        activeWorkflows: z.ZodNumber;
+        channel: z.ZodEnum<["preview", "stable"]>;
+        orchestratorVersion: z.ZodString;
+        gitRemotes: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            url: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            url: string;
+        }, {
+            name: string;
+            url: string;
+        }>, "many">;
+        uptime: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        workerCount: number;
+        activeWorkflows: number;
+        channel: "preview" | "stable";
+        orchestratorVersion: string;
+        gitRemotes: {
+            name: string;
+            url: string;
+        }[];
+        uptime: number;
+    }, {
+        workerCount: number;
+        activeWorkflows: number;
+        channel: "preview" | "stable";
+        orchestratorVersion: string;
+        gitRemotes: {
+            name: string;
+            url: string;
+        }[];
+        uptime: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "handshake";
+    metadata: {
+        workerCount: number;
+        activeWorkflows: number;
+        channel: "preview" | "stable";
+        orchestratorVersion: string;
+        gitRemotes: {
+            name: string;
+            url: string;
+        }[];
+        uptime: number;
+    };
+}, {
+    type: "handshake";
+    metadata: {
+        workerCount: number;
+        activeWorkflows: number;
+        channel: "preview" | "stable";
+        orchestratorVersion: string;
+        gitRemotes: {
+            name: string;
+            url: string;
+        }[];
+        uptime: number;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    code: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    type: "error";
+}, {
+    code: string;
+    message: string;
+    type: "error";
+}>]>;
+export { ClusterMetadataSchema, GitRemoteSchema };
+/**
+ * Parse and validate an incoming relay message.
+ * Returns the validated message or null if invalid.
+ */
+export declare function parseRelayMessage(data: unknown): RelayMessage | null;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,kBAAkB,GAClB,YAAY,GACZ,mBAAmB,GACnB,gBAAgB,GAChB,gBAAgB,GAChB,YAAY,CAAC;AAEjB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,QAAA,MAAM,eAAe;;;;;;;;;EAGnB,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AA8CH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ7B,CAAC;AAEH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,CAAC;AAElD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAGpE"}

package/dist/messages.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+// --- Zod Schemas ---
+const GitRemoteSchema = z.object({
+    name: z.string(),
+    url: z.string(),
+});
+const ClusterMetadataSchema = z.object({
+    workerCount: z.number(),
+    activeWorkflows: z.number(),
+    channel: z.enum(['preview', 'stable']),
+    orchestratorVersion: z.string(),
+    gitRemotes: z.array(GitRemoteSchema),
+    uptime: z.number(),
+});
+const ApiRequestMessageSchema = z.object({
+    type: z.literal('api_request'),
+    id: z.string().min(1),
+    method: z.string().min(1),
+    path: z.string().min(1),
+    headers: z.record(z.string()).optional(),
+    body: z.unknown().optional(),
+});
+const ApiResponseMessageSchema = z.object({
+    type: z.literal('api_response'),
+    id: z.string().min(1),
+    status: z.number().int().min(100).max(599),
+    headers: z.record(z.string()).optional(),
+    body: z.unknown().optional(),
+});
+const EventMessageSchema = z.object({
+    type: z.literal('event'),
+    channel: z.string().min(1),
+    event: z.unknown(),
+});
+const ConversationMessageSchema = z.object({
+    type: z.literal('conversation'),
+    conversationId: z.string().min(1),
+    data: z.unknown(),
+});
+const HeartbeatMessageSchema = z.object({
+    type: z.literal('heartbeat'),
+});
+const HandshakeMessageSchema = z.object({
+    type: z.literal('handshake'),
+    metadata: ClusterMetadataSchema,
+});
+const ErrorMessageSchema = z.object({
+    type: z.literal('error'),
+    code: z.string().min(1),
+    message: z.string(),
+});
+export const RelayMessageSchema = z.discriminatedUnion('type', [
+    ApiRequestMessageSchema,
+    ApiResponseMessageSchema,
+    EventMessageSchema,
+    ConversationMessageSchema,
+    HeartbeatMessageSchema,
+    HandshakeMessageSchema,
+    ErrorMessageSchema,
+]);
+export { ClusterMetadataSchema, GitRemoteSchema };
+/**
+ * Parse and validate an incoming relay message.
+ * Returns the validated message or null if invalid.
+ */
+export function parseRelayMessage(data) {
+    const result = RelayMessageSchema.safeParse(data);
+    return result.success ? result.data : null;
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

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

package/dist/metadata.d.ts

@@ -0,0 +1,8 @@
+import type { ClusterMetadata } from './messages.js';
+import type { RelayConfig } from './config.js';
+/**
+ * Collect cluster metadata by querying the local orchestrator's
+ * /health and /metrics endpoints, and parsing git remotes.
+ */
+export declare function collectMetadata(config: RelayConfig): Promise<ClusterMetadata>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CAe1B"}

package/dist/metadata.js

@@ -0,0 +1,77 @@
+import { execSync } from 'node:child_process';
+/**
+ * Collect cluster metadata by querying the local orchestrator's
+ * /health and /metrics endpoints, and parsing git remotes.
+ */
+export async function collectMetadata(config) {
+    const [health, metrics, gitRemotes] = await Promise.all([
+        fetchHealth(config),
+        fetchMetrics(config),
+        parseGitRemotes(),
+    ]);
+    return {
+        workerCount: metrics.workerCount,
+        activeWorkflows: metrics.activeWorkflows,
+        channel: health.channel,
+        orchestratorVersion: health.version,
+        gitRemotes,
+        uptime: health.uptime,
+    };
+}
+async function fetchHealth(config) {
+    try {
+        const response = await fetch(`${config.orchestratorUrl}/health`, {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (response.ok) {
+            const data = await response.json();
+            return {
+                version: String(data['version'] ?? '0.0.0'),
+                channel: (data['channel'] === 'preview' ? 'preview' : 'stable'),
+                uptime: Number(data['uptime'] ?? 0),
+            };
+        }
+    }
+    catch {
+        // Orchestrator unreachable — use defaults
+    }
+    return { version: '0.0.0', channel: 'stable', uptime: 0 };
+}
+async function fetchMetrics(config) {
+    try {
+        const response = await fetch(`${config.orchestratorUrl}/metrics`, {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (response.ok) {
+            const data = await response.json();
+            return {
+                workerCount: Number(data['workerCount'] ?? 0),
+                activeWorkflows: Number(data['activeWorkflows'] ?? 0),
+            };
+        }
+    }
+    catch {
+        // Orchestrator unreachable — use defaults
+    }
+    return { workerCount: 0, activeWorkflows: 0 };
+}
+/**
+ * Parse git remotes from `git remote -v`.
+ */
+async function parseGitRemotes() {
+    try {
+        const output = execSync('git remote -v', { encoding: 'utf-8', timeout: 5000 });
+        const remotes = new Map();
+        for (const line of output.split('\n')) {
+            const match = line.match(/^(\S+)\s+(\S+)\s+\(fetch\)$/);
+            if (match?.[1] && match[2]) {
+                remotes.set(match[1], match[2]);
+            }
+        }
+        return Array.from(remotes.entries()).map(([name, url]) => ({ name, url }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

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

package/dist/proxy.d.ts

@@ -0,0 +1,7 @@
+import type { ApiRequestMessage, ApiResponseMessage } from './messages.js';
+import type { RelayConfig } from './config.js';
+/**
+ * Handle an API request from the cloud by proxying it to the local orchestrator.
+ */
+export declare function handleApiRequest(request: ApiRequestMessage, config: RelayConfig): Promise<ApiResponseMessage>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAwD7B"}

package/dist/proxy.js

@@ -0,0 +1,56 @@
+/**
+ * Handle an API request from the cloud by proxying it to the local orchestrator.
+ */
+export async function handleApiRequest(request, config) {
+    const url = `${config.orchestratorUrl}${request.path}`;
+    const headers = {
+        ...request.headers,
+    };
+    if (config.orchestratorApiKey) {
+        headers['X-API-Key'] = config.orchestratorApiKey;
+    }
+    try {
+        const response = await fetch(url, {
+            method: request.method,
+            headers,
+            body: request.body != null ? JSON.stringify(request.body) : undefined,
+            signal: AbortSignal.timeout(config.requestTimeoutMs),
+        });
+        const responseHeaders = {};
+        response.headers.forEach((value, key) => {
+            responseHeaders[key] = value;
+        });
+        let body;
+        const contentType = response.headers.get('content-type');
+        if (contentType?.includes('application/json')) {
+            body = await response.json();
+        }
+        else {
+            body = await response.text();
+        }
+        return {
+            type: 'api_response',
+            id: request.id,
+            status: response.status,
+            headers: responseHeaders,
+            body,
+        };
+    }
+    catch (error) {
+        if (error instanceof DOMException && error.name === 'TimeoutError') {
+            return {
+                type: 'api_response',
+                id: request.id,
+                status: 504,
+                body: { error: 'Gateway Timeout', message: 'Request to orchestrator timed out' },
+            };
+        }
+        return {
+            type: 'api_response',
+            id: request.id,
+            status: 502,
+            body: { error: 'Bad Gateway', message: `Failed to reach orchestrator: ${String(error)}` },
+        };
+    }
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA0B,EAC1B,MAAmB;IAEnB,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAEvD,MAAM,OAAO,GAA2B;QACtC,GAAG,OAAO,CAAC,OAAO;KACnB,CAAC;IAEF,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC9B,OAAO,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,kBAAkB,CAAC;IACnD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YACrE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;SACrD,CAAC,CAAC;QAEH,MAAM,eAAe,GAA2B,EAAE,CAAC;QACnD,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACtC,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,IAAI,IAAa,CAAC;QAClB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC9C,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,eAAe;YACxB,IAAI;SACL,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACnE,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,mCAAmC,EAAE;aACjF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,iCAAiC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;SAC1F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/relay.d.ts

@@ -0,0 +1,76 @@
+import type { RelayConfig } from './config.js';
+import type { RelayMessage, ClusterMetadata } from './messages.js';
+export type RelayState = 'disconnected' | 'connecting' | 'authenticating' | 'connected' | 'disconnecting';
+export interface Logger {
+    info(msg: string): void;
+    info(obj: Record<string, unknown>, msg: string): void;
+    warn(msg: string): void;
+    warn(obj: Record<string, unknown>, msg: string): void;
+    error(msg: string): void;
+    error(obj: Record<string, unknown>, msg: string): void;
+}
+export declare class ClusterRelay {
+    private _state;
+    private ws;
+    private readonly config;
+    private readonly logger;
+    private readonly messageHandlers;
+    private running;
+    private abortController;
+    private reconnectAttempt;
+    private heartbeatTimer;
+    private pongReceived;
+    private metadataOverride;
+    constructor(config: RelayConfig, logger?: Logger);
+    get state(): RelayState;
+    /**
+     * Establish WebSocket connection with automatic reconnection.
+     */
+    connect(): Promise<void>;
+    /**
+     * Gracefully disconnect.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Send a message over the WebSocket.
+     */
+    send(message: RelayMessage): void;
+    /**
+     * Register a handler for incoming messages.
+     */
+    onMessage(handler: (message: RelayMessage) => void): void;
+    /**
+     * Push an event to the cloud (library mode).
+     */
+    pushEvent(channel: string, event: unknown): void;
+    /**
+     * Override metadata for library mode.
+     */
+    setMetadata(metadata: Partial<ClusterMetadata>): void;
+    /**
+     * Establish a single WebSocket connection, authenticate, and process messages.
+     * Resolves when the connection closes normally, throws on error.
+     */
+    private connectOnce;
+    /**
+     * Send handshake with cluster metadata.
+     */
+    private sendHandshake;
+    /**
+     * Start the heartbeat interval.
+     */
+    private startHeartbeat;
+    /**
+     * Stop the heartbeat interval.
+     */
+    private stopHeartbeat;
+    /**
+     * Calculate exponential backoff delay.
+     */
+    private get reconnectDelayMs();
+    /**
+     * Cancellable sleep.
+     */
+    private sleep;
+}
+//# sourceMappingURL=relay.d.ts.map

package/dist/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKnE,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,GAAG,WAAW,GAAG,eAAe,CAAC;AAE1G,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxD;AAiBD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8C;IAC9E,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,gBAAgB,CAAyC;gBAErD,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM;IAKhD,IAAI,KAAK,IAAI,UAAU,CAEtB;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BjC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAQjC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAIzD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAIrD;;;OAGG;YACW,WAAW;IA+FzB;;OAEG;YACW,aAAa;IAa3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,KAAK,gBAAgB,GAG3B;IAED;;OAEG;IACH,OAAO,CAAC,KAAK;CAcd"}