@justscale/core 0.1.0

package/dist/cluster/index.js

@@ -0,0 +1,57 @@
+/**
+ * @justscale/cluster
+ *
+ * Cluster capabilities for JustScale applications.
+ *
+ * The main entry point is now JustScale() from '@justscale/core':
+ *
+ * @example Creating an app
+ * ```typescript
+ * import JustScale from '@justscale/core'
+ * import '@justscale/http'
+ *
+ * const app = JustScale()
+ *   .add(UserService)
+ *   .add(UserController)
+ *   .build()
+ *
+ * await app.serve({ http: 3000 })
+ * ```
+ *
+ * @example Using the CLI client directly
+ * ```typescript
+ * import { connectToCluster } from "@justscale/cluster"
+ *
+ * const client = await connectToCluster()
+ * const result = await client.invoke("auth create-user", {
+ *   email: "test@example.com",
+ *   password: "secret",
+ * })
+ * ```
+ *
+ * @module @justscale/cluster
+ */
+// Protocol
+export { PROTOCOL_VERSION, PROTOCOL_V1_CBOR, PROTOCOL_V2_PROTO, WIRE_FORMAT_CBOR, WIRE_FORMAT_PROTO, setProtoCodec, getProtoCodec, encodeFrameV2, ErrorCodes, Methods, encodeFrame, FrameDecoder, createRequest, createResponse, createErrorResponse, createStream, createEvent, isRequest, isResponse, isSuccessResponse, isErrorResponse, isStream, isEvent, } from './protocol.js';
+// Transport
+export { SocketTransport, getSocketDir, getSocketPath, cleanupSocket, getPeerCredentials, } from './transport.js';
+// Server
+export { ClusterServer, createClusterServer, } from './server.js';
+// Client
+export { ClusterClient, createClusterClient, connectToCluster, } from './client.js';
+// Proto codec: import { clusterProtoCodec } from '@justscale/core/cluster/proto-codec'
+// Requires .proto module resolution via ptsc - not in default build output.
+// Coordinator (cluster-as-a-process)
+export { ClusterNode, ClusterNodeStatus, ClusterSignals, clusterCoordinator, COORDINATOR_PATH, NodeLifecycleService, } from './coordinator/index.js';
+// Cluster (transport system)
+export { registerTransport, getRegisteredTransports, } from './cluster.js';
+// ============================================================================
+// Re-exports from @justscale/core for convenience
+// ============================================================================
+// Main entry point
+export { default as JustScale } from '../justscale.js';
+// Builder utilities
+export { bindRepository, bindService, bindInstance, } from '../index.js';
+// Type guards
+export { isServiceDef, isControllerDef, isRepositoryBinding, isServiceBinding, isInstanceBinding, isFeatureToken, isBuilderCallback, isComponentArray, FEATURE_TOKEN, FEATURE_META, REPO_BINDING, SERVICE_BINDING, INSTANCE_BINDING, } from '../index.js';
+//# sourceMappingURL=index.js.map

package/dist/cluster/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cluster/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAGjB,aAAa,EACb,aAAa,EACb,aAAa,EAkBb,UAAU,EAEV,OAAO,EACP,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,QAAQ,EACR,OAAO,GACR,MAAM,eAAe,CAAC;AAEvB,YAAY;AACZ,OAAO,EAGL,eAAe,EAEf,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,SAAS;AACT,OAAO,EACL,aAAa,EACb,mBAAmB,GAMpB,MAAM,aAAa,CAAC;AAErB,SAAS;AACT,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,GAKjB,MAAM,aAAa,CAAC;AAErB,uFAAuF;AACvF,4EAA4E;AAE5E,qCAAqC;AACrC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,wBAAwB,CAAC;AAEhC,6BAA6B;AAC7B,OAAO,EAIL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAE/E,mBAAmB;AACnB,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGvD,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,aAAa,CAAC;AAoBrB,cAAc;AACd,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/dist/cluster/protocol.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Wire protocol for inter-process and inter-node communication.
+ * Frame format: [4 bytes big-endian length][CBOR payload]
+ */
+/** CBOR wire format (default for local CLI communication) */
+export declare const PROTOCOL_V1_CBOR = 1;
+/** Proto wire format (v2 for inter-node cluster communication) */
+export declare const PROTOCOL_V2_PROTO = 2;
+export declare const PROTOCOL_VERSION = 1;
+/**
+ * Wire format version markers.
+ * First byte of the frame header indicates the encoding format:
+ * - 0x00: CBOR v1 (4-byte BE length + CBOR payload)
+ * - 0x01: Proto v2 (1-byte version + 4-byte BE length + proto payload)
+ */
+export declare const WIRE_FORMAT_CBOR = 0;
+export declare const WIRE_FORMAT_PROTO = 1;
+export type MessageType = 'request' | 'response' | 'stream' | 'event';
+export type AuthLevel = 'none' | 'socket' | 'shared-secret' | 'pubkey' | 'mtls';
+export interface AuthNone {
+    type: 'none';
+}
+export interface AuthSocket {
+    type: 'socket';
+    uid?: number;
+    gid?: number;
+    pid?: number;
+}
+export interface AuthSharedSecret {
+    type: 'shared-secret';
+    token: string;
+}
+export interface AuthPubkey {
+    type: 'pubkey';
+    publicKey: Uint8Array;
+    signature: Uint8Array;
+    challenge?: Uint8Array;
+}
+export type AuthInfo = AuthNone | AuthSocket | AuthSharedSecret | AuthPubkey;
+interface BaseMessage {
+    /** Protocol version */
+    v: number;
+    /** Correlation ID for request/response matching */
+    id?: string;
+    /** Message type */
+    type: MessageType;
+}
+export interface RequestMessage extends BaseMessage {
+    type: 'request';
+    /** Method namespace.name (e.g., "cli.invoke", "system.health") */
+    method: string;
+    /** Method parameters */
+    params?: Record<string, unknown>;
+}
+export interface SuccessResponse extends BaseMessage {
+    type: 'response';
+    ok: true;
+    result?: unknown;
+}
+export interface ErrorResponse extends BaseMessage {
+    type: 'response';
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        data?: unknown;
+    };
+}
+export type ResponseMessage = SuccessResponse | ErrorResponse;
+export interface StreamMessage extends BaseMessage {
+    type: 'stream';
+    /** Stream channel: stdout, stderr, progress, prompt, prompt_response, etc. */
+    channel: string;
+    /** Stream data */
+    data: unknown;
+    /** Is this the final message in the stream? */
+    done?: boolean;
+    /**
+     * Monotonically increasing sequence number within a stream (scoped to id + channel).
+     * Used to detect and reorder out-of-order delivery on non-TCP transports.
+     */
+    seq?: number;
+}
+export type PromptType = 'text' | 'password' | 'confirm' | 'select';
+/** Server -> Client: Request input from user */
+export interface PromptRequest {
+    promptId: string;
+    promptType: PromptType;
+    message: string;
+    defaultValue?: string;
+    choices?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/** Client -> Server: User's response to prompt */
+export interface PromptResponseData {
+    promptId: string;
+    value: string | boolean | null;
+    cancelled?: boolean;
+}
+export interface EventMessage extends BaseMessage {
+    type: 'event';
+    /** Event name */
+    event: string;
+    /** Event payload */
+    payload?: unknown;
+}
+export type Message = RequestMessage | ResponseMessage | StreamMessage | EventMessage;
+export declare const ErrorCodes: {
+    readonly PARSE_ERROR: "PARSE_ERROR";
+    readonly INVALID_MESSAGE: "INVALID_MESSAGE";
+    readonly UNSUPPORTED_VERSION: "UNSUPPORTED_VERSION";
+    readonly METHOD_NOT_FOUND: "METHOD_NOT_FOUND";
+    readonly INVALID_PARAMS: "INVALID_PARAMS";
+    readonly AUTH_REQUIRED: "AUTH_REQUIRED";
+    readonly AUTH_FAILED: "AUTH_FAILED";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly CANCELLED: "CANCELLED";
+};
+export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+export declare const Methods: {
+    readonly CLI_INVOKE: "cli.invoke";
+    readonly CLI_LIST: "cli.list";
+    readonly SYSTEM_HEALTH: "system.health";
+    readonly SYSTEM_INFO: "system.info";
+    readonly SYSTEM_SHUTDOWN: "system.shutdown";
+    readonly SYSTEM_RELOAD: "system.reload";
+    readonly AUTH_HANDSHAKE: "auth.handshake";
+    readonly AUTH_CHALLENGE: "auth.challenge";
+    readonly AUTH_VERIFY: "auth.verify";
+    readonly MESH_DISCOVER: "mesh.discover";
+    readonly MESH_JOIN: "mesh.join";
+    readonly MESH_LEAVE: "mesh.leave";
+    readonly MESH_ROUTE: "mesh.route";
+};
+export type WireFormat = typeof WIRE_FORMAT_CBOR | typeof WIRE_FORMAT_PROTO;
+export interface ProtoCodec {
+    encode(message: Message): Uint8Array;
+    decode(data: Uint8Array): Message;
+}
+export declare function setProtoCodec(codec: ProtoCodec): void;
+export declare function getProtoCodec(): ProtoCodec | null;
+/**
+ * Encode a message to a framed buffer.
+ * Frame format: [4 bytes big-endian length][CBOR payload]
+ */
+export declare function encodeFrame(message: Message): Uint8Array;
+/**
+ * Encode a message to a framed buffer with explicit wire format.
+ * - CBOR: [4-byte BE length][CBOR payload]
+ * - Proto: [0x01][4-byte BE length][proto payload]
+ */
+export declare function encodeFrameV2(message: Message, format?: WireFormat): Uint8Array;
+/**
+ * Frame decoder for streaming data.
+ * Auto-detects CBOR v1 and proto v2 wire formats.
+ */
+export declare class FrameDecoder {
+    private buffer;
+    /**
+     * Push data into the decoder buffer.
+     * Returns decoded messages (may be empty if incomplete).
+     */
+    push(data: Uint8Array): Message[];
+    /**
+     * Reset the decoder state.
+     */
+    reset(): void;
+    /**
+     * Check if there's pending data in the buffer.
+     */
+    get hasPending(): boolean;
+}
+/**
+ * Create a request message.
+ */
+export declare function createRequest(method: string, params?: Record<string, unknown>, id?: string): RequestMessage;
+/**
+ * Create a success response.
+ */
+export declare function createResponse(id: string, result?: unknown): SuccessResponse;
+/**
+ * Create an error response.
+ */
+export declare function createErrorResponse(id: string, code: ErrorCode | string, message: string, data?: unknown): ErrorResponse;
+/**
+ * Create a stream message.
+ */
+export declare function createStream(id: string, channel: string, data: unknown, done?: boolean): StreamMessage;
+/**
+ * Create an event message.
+ */
+export declare function createEvent(event: string, payload?: unknown): EventMessage;
+export declare function isRequest(msg: Message): msg is RequestMessage;
+export declare function isResponse(msg: Message): msg is ResponseMessage;
+export declare function isSuccessResponse(msg: Message): msg is SuccessResponse;
+export declare function isErrorResponse(msg: Message): msg is ErrorResponse;
+export declare function isStream(msg: Message): msg is StreamMessage;
+export declare function isEvent(msg: Message): msg is EventMessage;
+export {};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/cluster/protocol.d.ts.map

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

package/dist/cluster/protocol.js

@@ -0,0 +1,274 @@
+/**
+ * Wire protocol for inter-process and inter-node communication.
+ * Frame format: [4 bytes big-endian length][CBOR payload]
+ */
+import { encode, decode } from 'cbor-x';
+/** CBOR wire format (default for local CLI communication) */
+export const PROTOCOL_V1_CBOR = 1;
+/** Proto wire format (v2 for inter-node cluster communication) */
+export const PROTOCOL_V2_PROTO = 2;
+export const PROTOCOL_VERSION = PROTOCOL_V1_CBOR;
+/**
+ * Wire format version markers.
+ * First byte of the frame header indicates the encoding format:
+ * - 0x00: CBOR v1 (4-byte BE length + CBOR payload)
+ * - 0x01: Proto v2 (1-byte version + 4-byte BE length + proto payload)
+ */
+export const WIRE_FORMAT_CBOR = 0x00;
+export const WIRE_FORMAT_PROTO = 0x01;
+export const ErrorCodes = {
+    // Protocol errors
+    PARSE_ERROR: 'PARSE_ERROR',
+    INVALID_MESSAGE: 'INVALID_MESSAGE',
+    UNSUPPORTED_VERSION: 'UNSUPPORTED_VERSION',
+    // Method errors
+    METHOD_NOT_FOUND: 'METHOD_NOT_FOUND',
+    INVALID_PARAMS: 'INVALID_PARAMS',
+    // Authentication errors
+    AUTH_REQUIRED: 'AUTH_REQUIRED',
+    AUTH_FAILED: 'AUTH_FAILED',
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    // Execution errors
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    TIMEOUT: 'TIMEOUT',
+    CANCELLED: 'CANCELLED',
+};
+export const Methods = {
+    // CLI commands
+    CLI_INVOKE: 'cli.invoke',
+    CLI_LIST: 'cli.list',
+    // System management
+    SYSTEM_HEALTH: 'system.health',
+    SYSTEM_INFO: 'system.info',
+    SYSTEM_SHUTDOWN: 'system.shutdown',
+    SYSTEM_RELOAD: 'system.reload',
+    // Authentication
+    AUTH_HANDSHAKE: 'auth.handshake',
+    AUTH_CHALLENGE: 'auth.challenge',
+    AUTH_VERIFY: 'auth.verify',
+    MESH_DISCOVER: 'mesh.discover',
+    MESH_JOIN: 'mesh.join',
+    MESH_LEAVE: 'mesh.leave',
+    MESH_ROUTE: 'mesh.route',
+};
+const LENGTH_SIZE = 4;
+const MAX_MESSAGE_SIZE = 16 * 1024 * 1024; // 16MB max
+let protoCodec = null;
+export function setProtoCodec(codec) {
+    protoCodec = codec;
+}
+export function getProtoCodec() {
+    return protoCodec;
+}
+/**
+ * Encode a message to a framed buffer.
+ * Frame format: [4 bytes big-endian length][CBOR payload]
+ */
+export function encodeFrame(message) {
+    const payload = encode(message);
+    const frame = new Uint8Array(LENGTH_SIZE + payload.length);
+    const view = new DataView(frame.buffer);
+    view.setUint32(0, payload.length, false); // big-endian
+    frame.set(payload, LENGTH_SIZE);
+    return frame;
+}
+/**
+ * Encode a message to a framed buffer with explicit wire format.
+ * - CBOR: [4-byte BE length][CBOR payload]
+ * - Proto: [0x01][4-byte BE length][proto payload]
+ */
+export function encodeFrameV2(message, format = WIRE_FORMAT_CBOR) {
+    if (format === WIRE_FORMAT_PROTO) {
+        if (!protoCodec) {
+            throw new Error('Proto codec not registered. Call setProtoCodec() first.');
+        }
+        const payload = protoCodec.encode(message);
+        const frame = new Uint8Array(1 + LENGTH_SIZE + payload.length);
+        const view = new DataView(frame.buffer);
+        frame[0] = WIRE_FORMAT_PROTO;
+        view.setUint32(1, payload.length, false);
+        frame.set(payload, 1 + LENGTH_SIZE);
+        return frame;
+    }
+    // CBOR v1 (default)
+    return encodeFrame(message);
+}
+/**
+ * Frame decoder for streaming data.
+ * Auto-detects CBOR v1 and proto v2 wire formats.
+ */
+export class FrameDecoder {
+    buffer = new Uint8Array(0);
+    /**
+     * Push data into the decoder buffer.
+     * Returns decoded messages (may be empty if incomplete).
+     */
+    push(data) {
+        // Append to buffer
+        const newBuffer = new Uint8Array(this.buffer.length + data.length);
+        newBuffer.set(this.buffer);
+        newBuffer.set(data, this.buffer.length);
+        this.buffer = newBuffer;
+        const messages = [];
+        while (this.buffer.length >= LENGTH_SIZE) {
+            // Wire format is discriminated by the first byte:
+            //   0x00 -> CBOR v1: first byte is the high byte of the 4-byte BE length,
+            //           which must be 0x00 because MAX_MESSAGE_SIZE is 16MB
+            //           (0x01_00_00_00) - a valid CBOR length fits in 24 bits.
+            //   0x01 -> Proto v2: explicit marker tag, followed by 4-byte BE length.
+            // Any other value is invalid on the wire. This lets us run the oversize
+            // guard on CBOR frames: a first byte >= 0x01 with the CBOR layout would
+            // decode to a length >= 16MB, so we surface that as "too large" before
+            // the codec branch instead of leaving it to ambiguous auto-detect.
+            const firstByte = this.buffer[0];
+            if (firstByte === WIRE_FORMAT_PROTO) {
+                // Proto v2: [0x01][4 bytes BE length][proto payload]
+                if (this.buffer.length < 1 + LENGTH_SIZE)
+                    break;
+                const view = new DataView(this.buffer.buffer, this.buffer.byteOffset);
+                const payloadLength = view.getUint32(1, false);
+                if (payloadLength > MAX_MESSAGE_SIZE) {
+                    throw new Error(`Message too large: ${payloadLength} bytes`);
+                }
+                const frameLength = 1 + LENGTH_SIZE + payloadLength;
+                if (this.buffer.length < frameLength)
+                    break;
+                if (!protoCodec) {
+                    throw new Error('Received proto-encoded frame but no proto codec registered');
+                }
+                const payload = this.buffer.slice(1 + LENGTH_SIZE, frameLength);
+                messages.push(protoCodec.decode(payload));
+                this.buffer = this.buffer.slice(frameLength);
+            }
+            else if (firstByte === WIRE_FORMAT_CBOR) {
+                // CBOR v1: [4-byte BE length][CBOR payload]
+                // First byte must be 0x00 for a valid CBOR frame because the length
+                // is bounded by MAX_MESSAGE_SIZE (16MB) which fits in 24 bits.
+                const view = new DataView(this.buffer.buffer, this.buffer.byteOffset);
+                const payloadLength = view.getUint32(0, false);
+                if (payloadLength > MAX_MESSAGE_SIZE) {
+                    throw new Error(`Message too large: ${payloadLength} bytes`);
+                }
+                const frameLength = LENGTH_SIZE + payloadLength;
+                if (this.buffer.length < frameLength)
+                    break;
+                const payload = this.buffer.slice(LENGTH_SIZE, frameLength);
+                messages.push(decode(payload));
+                this.buffer = this.buffer.slice(frameLength);
+            }
+            else {
+                // A first byte other than 0x00 (CBOR) or 0x01 (proto) is not a
+                // valid frame - surface as "too large" to match the oversize guard path.
+                const view = new DataView(this.buffer.buffer, this.buffer.byteOffset);
+                const payloadLength = view.getUint32(0, false);
+                throw new Error(`Message too large: ${payloadLength} bytes`);
+            }
+        }
+        return messages;
+    }
+    /**
+     * Reset the decoder state.
+     */
+    reset() {
+        this.buffer = new Uint8Array(0);
+    }
+    /**
+     * Check if there's pending data in the buffer.
+     */
+    get hasPending() {
+        return this.buffer.length > 0;
+    }
+}
+let messageCounter = 0;
+function generateId() {
+    return `${Date.now().toString(36)}-${(++messageCounter).toString(36)}`;
+}
+/**
+ * Create a request message.
+ */
+export function createRequest(method, params, id) {
+    return {
+        v: PROTOCOL_VERSION,
+        id: id ?? generateId(),
+        type: 'request',
+        method,
+        params,
+    };
+}
+/**
+ * Create a success response.
+ */
+export function createResponse(id, result) {
+    return {
+        v: PROTOCOL_VERSION,
+        id,
+        type: 'response',
+        ok: true,
+        result,
+    };
+}
+/**
+ * Create an error response.
+ */
+export function createErrorResponse(id, code, message, data) {
+    return {
+        v: PROTOCOL_VERSION,
+        id,
+        type: 'response',
+        ok: false,
+        error: { code, message, data },
+    };
+}
+const streamSeqCounters = new Map();
+/**
+ * Create a stream message.
+ */
+export function createStream(id, channel, data, done = false) {
+    const key = `${id}:${channel}`;
+    const seq = (streamSeqCounters.get(key) ?? 0) + 1;
+    if (done) {
+        streamSeqCounters.delete(key);
+    }
+    else {
+        streamSeqCounters.set(key, seq);
+    }
+    return {
+        v: PROTOCOL_VERSION,
+        id,
+        type: 'stream',
+        channel,
+        data,
+        done,
+        seq,
+    };
+}
+/**
+ * Create an event message.
+ */
+export function createEvent(event, payload) {
+    return {
+        v: PROTOCOL_VERSION,
+        type: 'event',
+        event,
+        payload,
+    };
+}
+export function isRequest(msg) {
+    return msg.type === 'request';
+}
+export function isResponse(msg) {
+    return msg.type === 'response';
+}
+export function isSuccessResponse(msg) {
+    return msg.type === 'response' && msg.ok === true;
+}
+export function isErrorResponse(msg) {
+    return msg.type === 'response' && msg.ok === false;
+}
+export function isStream(msg) {
+    return msg.type === 'stream';
+}
+export function isEvent(msg) {
+    return msg.type === 'event';
+}
+//# sourceMappingURL=protocol.js.map

package/dist/cluster/protocol.js.map

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

package/dist/cluster/scheduled-task/builder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ScheduledTask Route Builder
+ *
+ * Provides the builder pattern for scheduled task routes.
+ */
+import type { z } from 'zod';
+import type { ScheduledTaskContext, ScheduledTaskRouteBuilder } from './types.js';
+/** Symbols for scheduled task metadata (preserved through controller compilation) */
+export declare const SCHEDULED_TASK_NAMESPACE: unique symbol;
+export declare const SCHEDULED_TASK_TYPE: unique symbol;
+export declare const SCHEDULED_TASK_QUALIFIED_NAME: unique symbol;
+export declare const SCHEDULED_TASK_PAYLOAD_SCHEMA: unique symbol;
+/** Read the qualified name from a scheduled task route. */
+export declare function getScheduledTaskQualifiedName(route: unknown): string | undefined;
+/** Read the payload schema from a scheduled task route. */
+export declare function getScheduledTaskPayloadSchema(route: unknown): z.ZodType | undefined;
+/**
+ * Create a scheduled task route builder.
+ *
+ * @param namespace - Task namespace (e.g., 'process', 'email')
+ * @param type - Task type within namespace (e.g., 'delay', 'reminder')
+ */
+export declare function createScheduledTaskRouteBuilder<TDeps, TPayload = unknown>(namespace: string, type: string): ScheduledTaskRouteBuilder<TDeps, TPayload, ScheduledTaskContext<TDeps, TPayload>>;
+//# sourceMappingURL=builder.d.ts.map

package/dist/cluster/scheduled-task/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/cluster/scheduled-task/builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,oBAAoB,EAEpB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,eAAoC,CAAC;AAC1E,eAAO,MAAM,mBAAmB,eAA+B,CAAC;AAChE,eAAO,MAAM,6BAA6B,eAAwC,CAAC;AACnF,eAAO,MAAM,6BAA6B,eAAwC,CAAC;AAEnF,2DAA2D;AAC3D,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEhF;AAED,2DAA2D;AAC3D,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,GAAG,SAAS,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EACL,QAAQ,GAAG,OAAO,EAElB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,yBAAyB,CAAC,KAAK,EAAE,QAAQ,EAAE,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CA0CnF"}

package/dist/cluster/scheduled-task/builder.js

@@ -0,0 +1,63 @@
+/**
+ * ScheduledTask Route Builder
+ *
+ * Provides the builder pattern for scheduled task routes.
+ */
+/** Symbols for scheduled task metadata (preserved through controller compilation) */
+export const SCHEDULED_TASK_NAMESPACE = Symbol('scheduledTask:namespace');
+export const SCHEDULED_TASK_TYPE = Symbol('scheduledTask:type');
+export const SCHEDULED_TASK_QUALIFIED_NAME = Symbol('scheduledTask:qualifiedName');
+export const SCHEDULED_TASK_PAYLOAD_SCHEMA = Symbol('scheduledTask:payloadSchema');
+/** Read the qualified name from a scheduled task route. */
+export function getScheduledTaskQualifiedName(route) {
+    return route?.[SCHEDULED_TASK_QUALIFIED_NAME];
+}
+/** Read the payload schema from a scheduled task route. */
+export function getScheduledTaskPayloadSchema(route) {
+    return route?.[SCHEDULED_TASK_PAYLOAD_SCHEMA];
+}
+/**
+ * Create a scheduled task route builder.
+ *
+ * @param namespace - Task namespace (e.g., 'process', 'email')
+ * @param type - Task type within namespace (e.g., 'delay', 'reminder')
+ */
+export function createScheduledTaskRouteBuilder(namespace, type) {
+    const steps = [];
+    let payloadSchema;
+    const builder = {
+        payload(schema) {
+            payloadSchema = schema;
+            return builder;
+        },
+        use(middleware) {
+            steps.push({ type: 'use', fn: middleware });
+            return builder;
+        },
+        guard(check) {
+            steps.push({ type: 'guard', fn: check });
+            return builder;
+        },
+        handle(handler) {
+            const qualifiedName = `${namespace}.${type}`;
+            const route = {
+                method: 'SCHEDULED_TASK',
+                path: qualifiedName,
+                namespace,
+                type,
+                qualifiedName,
+                payloadSchema,
+                steps: [...steps],
+                responseSchemas: new Map(),
+                handler,
+                [SCHEDULED_TASK_NAMESPACE]: namespace,
+                [SCHEDULED_TASK_TYPE]: type,
+                [SCHEDULED_TASK_QUALIFIED_NAME]: qualifiedName,
+                [SCHEDULED_TASK_PAYLOAD_SCHEMA]: payloadSchema,
+            };
+            return route;
+        },
+    };
+    return builder;
+}
+//# sourceMappingURL=builder.js.map

package/dist/cluster/scheduled-task/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/cluster/scheduled-task/builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,qFAAqF;AACrF,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAC;AAEnF,2DAA2D;AAC3D,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,OAAQ,KAAiC,EAAE,CAAC,6BAA6B,CAAuB,CAAC;AACnG,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,OAAQ,KAAiC,EAAE,CAAC,6BAA6B,CAA0B,CAAC;AACtG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAI7C,SAAiB,EACjB,IAAY;IAEZ,MAAM,KAAK,GAAyC,EAAE,CAAC;IACvD,IAAI,aAAoC,CAAC;IAEzC,MAAM,OAAO,GAAsF;QACjG,OAAO,CAAC,MAAM;YACZ,aAAa,GAAG,MAAM,CAAC;YACvB,OAAO,OAAc,CAAC;QACxB,CAAC;QAED,GAAG,CAAC,UAAU;YACZ,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5C,OAAO,OAAc,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,KAAK;YACT,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACzC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,CAAC,OAAO;YACZ,MAAM,aAAa,GAAG,GAAG,SAAS,IAAI,IAAI,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG;gBACZ,MAAM,EAAE,gBAAgB;gBACxB,IAAI,EAAE,aAAa;gBACnB,SAAS;gBACT,IAAI;gBACJ,aAAa;gBACb,aAAa;gBACb,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC;gBACjB,eAAe,EAAE,IAAI,GAAG,EAAE;gBAC1B,OAAO;gBACP,CAAC,wBAAwB,CAAC,EAAE,SAAS;gBACrC,CAAC,mBAAmB,CAAC,EAAE,IAAI;gBAC3B,CAAC,6BAA6B,CAAC,EAAE,aAAa;gBAC9C,CAAC,6BAA6B,CAAC,EAAE,aAAa;aACL,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}