@ironflow/node 0.20.2 → 0.22.0

package/dist/projection-runner.js

@@ -0,0 +1,498 @@
+// sdk/js/node/src/projection-runner.ts
+/** Micro-batch flush configuration */
+const FLUSH_INTERVAL_MS = 100;
+/** Reusable encoder — TextEncoder is stateless, no need to instantiate per call */
+const textEncoder = new TextEncoder();
+/**
+ * Encode a JSON string as a ConnectRPC envelope.
+ * Format: 0x00 (flags: uncompressed) + uint32 big-endian length + payload bytes.
+ * Required for streaming RPCs; unary RPCs use plain JSON bodies.
+ */
+function encodeConnectEnvelope(json) {
+    const payload = textEncoder.encode(json);
+    const envelope = new Uint8Array(5 + payload.length);
+    envelope[0] = 0x00; // flags: uncompressed
+    const view = new DataView(envelope.buffer);
+    view.setUint32(1, payload.length, false); // big-endian length
+    envelope.set(payload, 5);
+    return envelope;
+}
+export class ProjectionRunner {
+    config;
+    running = false;
+    backoffMs = 1000;
+    // Micro-batch state for streaming mode
+    pendingEvents = [];
+    flushTimer = null;
+    // Serializes flushPending calls to prevent concurrent state mutations
+    flushChain = Promise.resolve();
+    // In-memory state for managed projections (accumulated across micro-batches)
+    managedState = null;
+    managedStateInitialized = false;
+    constructor(config) {
+        this.config = config;
+    }
+    async register() {
+        const { projection, baseUrl, headers } = this.config;
+        const resp = await fetch(`${baseUrl}/ironflow.v1.ProjectionService/RegisterProjection`, {
+            method: "POST",
+            headers: { ...headers, "Content-Type": "application/json" },
+            body: JSON.stringify({
+                name: projection.config.name,
+                events: projection.config.events,
+                mode: projection.config.mode,
+                version: 1,
+                partitionKey: projection.config.partitionKey || "",
+            }),
+        });
+        if (!resp.ok) {
+            throw new Error(`Failed to register projection: ${resp.status}`);
+        }
+    }
+    /**
+     * Start in streaming mode (preferred). Opens a ConnectRPC server-stream
+     * that delivers events in real-time. Falls back to polling if the server
+     * returns Unimplemented or the stream fails to connect.
+     */
+    async startStreaming() {
+        this.running = true;
+        await this.register();
+        const { projection, baseUrl, headers, logger } = this.config;
+        const name = projection.config.name;
+        logger.info(`Projection runner started (streaming): ${name}`);
+        // Initialize managed state from initialState() if available
+        if (projection.config.mode === "managed" && projection.config.initialState) {
+            this.managedState = projection.config.initialState();
+            this.managedStateInitialized = true;
+        }
+        // Fetch existing state from server to resume from where we left off
+        await this.loadExistingState();
+        // Track consecutive connection failures so the first drop (often just
+        // a proxy/socket idle timeout during quiet periods) logs at info rather
+        // than error. Escalates to error after repeated failures — at that
+        // point something is actually broken.
+        let consecutiveFailures = 0;
+        const FAIL_LOG_ESCALATE_AT = 3;
+        while (this.running && !this.config.signal?.aborted) {
+            try {
+                const resp = await fetch(`${baseUrl}/ironflow.v1.ProjectionService/StreamProjectionEvents`, {
+                    method: "POST",
+                    headers: {
+                        ...headers,
+                        "Content-Type": "application/connect+json",
+                    },
+                    body: encodeConnectEnvelope(JSON.stringify({
+                        name,
+                        batchSize: projection.config.batchSize || 100,
+                        // Opt in to server-side keepalive heartbeats. Server emits
+                        // empty ProjectionEvent frames with kind=HEARTBEAT every
+                        // ~15s so idle streams don't get closed by proxies/LBs or
+                        // Node's default fetch socket idle timer.
+                        acceptHeartbeats: true,
+                    })),
+                    signal: this.config.signal,
+                });
+                if (!resp.ok) {
+                    const status = resp.status;
+                    // If server doesn't support streaming, let the caller know to fall back
+                    if (status === 404 || status === 501) {
+                        throw new StreamingUnsupportedError(`Server does not support StreamProjectionEvents (${status})`);
+                    }
+                    // Auth failures (401/403) are non-transient — break out of the reconnect loop
+                    if (status === 401 || status === 403) {
+                        throw new StreamingUnsupportedError(`Stream authentication failed (${status}) — check credentials`);
+                    }
+                    throw new Error(`Stream request failed: ${status}`);
+                }
+                if (!resp.body) {
+                    throw new Error("No response body for streaming");
+                }
+                // Read the streaming response using the ConnectRPC streaming envelope format.
+                // Each message is: 1 byte flags + 4 bytes big-endian length + JSON payload.
+                const reader = resp.body.getReader();
+                try {
+                    let buffer = new Uint8Array(0);
+                    while (this.running && !this.config.signal?.aborted) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        // Successful read — the connection is healthy, so clear the
+                        // failure counter that gates error-log escalation.
+                        consecutiveFailures = 0;
+                        // Append new data to buffer
+                        const newBuffer = new Uint8Array(buffer.length + value.length);
+                        newBuffer.set(buffer);
+                        newBuffer.set(value, buffer.length);
+                        buffer = newBuffer;
+                        // Process all complete messages in the buffer
+                        while (buffer.length >= 5) {
+                            // ConnectRPC envelope: flags(1) + length(4) + payload(length)
+                            const dataView = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+                            const msgLength = dataView.getUint32(1, false); // big-endian
+                            const totalLength = 5 + msgLength;
+                            if (buffer.length < totalLength)
+                                break; // Incomplete message
+                            const flags = buffer[0] ?? 0;
+                            const payload = buffer.slice(5, totalLength);
+                            buffer = buffer.slice(totalLength);
+                            // ConnectRPC end-of-stream trailer (flags bit 1 set)
+                            if (flags & 0x02) {
+                                const text = new TextDecoder().decode(payload);
+                                try {
+                                    const trailer = JSON.parse(text);
+                                    if (trailer.error) {
+                                        logger.error(`Stream trailer error: ${trailer.error.message || trailer.error.code}`);
+                                    }
+                                }
+                                catch { /* ignore malformed trailers */ }
+                                break; // End of stream
+                            }
+                            const text = new TextDecoder().decode(payload);
+                            try {
+                                const event = JSON.parse(text);
+                                // Skip server-side keepalive heartbeats (issue #550).
+                                // Proto enum renders as string name in ConnectRPC JSON,
+                                // but accept the numeric form defensively.
+                                if (event.kind === "PROJECTION_EVENT_KIND_HEARTBEAT" || event.kind === 2) {
+                                    continue;
+                                }
+                                // Normalize field names from protobuf JSON (camelCase)
+                                const normalized = {
+                                    id: event.id || "",
+                                    name: event.name || "",
+                                    data: event.data,
+                                    seq: typeof event.seq === "string" ? parseInt(event.seq, 10) : (event.seq || 0),
+                                    timestamp: event.timestamp,
+                                    metadata: event.metadata,
+                                };
+                                this.enqueueEvent(normalized);
+                            }
+                            catch {
+                                // Skip malformed messages
+                                logger.warn(`Skipping malformed stream message: ${text.slice(0, 100)}`);
+                            }
+                        }
+                    }
+                }
+                finally {
+                    reader.releaseLock();
+                    // Flush any remaining events
+                    await this.flushPending();
+                }
+                // Stream ended normally (server restart, etc.)
+                if (this.running) {
+                    logger.info(`Projection stream ended for ${name}, reconnecting...`);
+                    await this.sleep(1000);
+                }
+            }
+            catch (err) {
+                if (!this.running || this.config.signal?.aborted)
+                    break;
+                // Re-throw StreamingUnsupportedError so caller can fall back to polling
+                if (err instanceof StreamingUnsupportedError) {
+                    throw err;
+                }
+                consecutiveFailures += 1;
+                if (consecutiveFailures < FAIL_LOG_ESCALATE_AT) {
+                    // First failures are typically idle-timeout reconnects during
+                    // quiet periods — don't pollute logs. Issue #550.
+                    logger.info(`Projection stream disconnected for ${name}, reconnecting (attempt ${consecutiveFailures})`);
+                }
+                else {
+                    logger.error(`Projection stream error for ${name} (${consecutiveFailures} consecutive failures): ${err}`);
+                }
+                await this.sleep(2000); // Brief delay before reconnect
+            }
+        }
+    }
+    /**
+     * Enqueue an event from the stream into the micro-batch.
+     * Flushes when batch is full or after FLUSH_INTERVAL_MS of inactivity.
+     * Flush calls are serialized via flushChain to prevent concurrent state mutations.
+     */
+    enqueueEvent(event) {
+        this.pendingEvents.push(event);
+        const batchSize = this.config.projection.config.batchSize || 100;
+        if (this.pendingEvents.length >= batchSize) {
+            // Batch full — flush immediately, serialized through the chain
+            this.scheduleFlush();
+        }
+        else if (!this.flushTimer) {
+            // Start the flush timer
+            this.flushTimer = setTimeout(() => {
+                this.flushTimer = null;
+                this.scheduleFlush();
+            }, FLUSH_INTERVAL_MS);
+        }
+    }
+    /** Serializes flush calls so only one runs at a time */
+    scheduleFlush() {
+        this.flushChain = this.flushChain.then(() => this.flushPending()).catch(() => { });
+    }
+    /**
+     * Flush pending events through the handler and persist state.
+     */
+    async flushPending() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        const events = this.pendingEvents.splice(0);
+        if (events.length === 0)
+            return;
+        const projConfig = this.config.projection.config;
+        if (projConfig.mode === "managed") {
+            await this.processManagedBatch(events);
+        }
+        else {
+            await this.processExternalBatch(events);
+        }
+    }
+    /**
+     * Process a batch of events in managed mode: run reducer, save state.
+     */
+    async processManagedBatch(events) {
+        const projConfig = this.config.projection.config;
+        // Group by partition
+        const partitions = new Map();
+        for (const event of events) {
+            const pk = event.metadata?.["__partition"] || "__global__";
+            if (!partitions.has(pk)) {
+                partitions.set(pk, { events: [], lastEventId: "", lastEventSeq: 0 });
+            }
+            partitions.get(pk).events.push(event);
+        }
+        for (const [pk, batch] of partitions) {
+            // For __global__ partition, use in-memory accumulated state
+            let state;
+            if (pk === "__global__" && this.managedStateInitialized) {
+                state = this.managedState;
+            }
+            else {
+                state = projConfig.initialState ? projConfig.initialState() : {};
+            }
+            for (const event of batch.events) {
+                const ctx = this.buildContext(event);
+                state = projConfig.handler(state, event, ctx);
+                batch.lastEventId = event.id;
+                batch.lastEventSeq = event.seq;
+                batch.lastEventTime = event.timestamp;
+            }
+            // Update in-memory state for __global__ partition
+            if (pk === "__global__") {
+                this.managedState = state;
+                this.managedStateInitialized = true;
+            }
+            await this.saveState(state, batch.lastEventId, batch.lastEventSeq, batch.lastEventTime, pk);
+        }
+    }
+    /**
+     * Process a batch of events in external mode: run handler, ack.
+     */
+    async processExternalBatch(events) {
+        const projConfig = this.config.projection.config;
+        let lastEventId = "";
+        let lastEventSeq = 0;
+        for (const event of events) {
+            const ctx = this.buildContext(event);
+            await projConfig.handler(event, ctx);
+            lastEventId = event.id;
+            lastEventSeq = event.seq;
+        }
+        await this.ackEvents(lastEventId, lastEventSeq);
+    }
+    /**
+     * Load existing projection state from the server so streaming resumes
+     * with the correct accumulated state.
+     */
+    async loadExistingState() {
+        const { projection, baseUrl, headers, logger } = this.config;
+        if (projection.config.mode !== "managed")
+            return;
+        try {
+            const resp = await fetch(`${baseUrl}/ironflow.v1.ProjectionService/GetProjection`, {
+                method: "POST",
+                headers: { ...headers, "Content-Type": "application/json" },
+                body: JSON.stringify({ name: projection.config.name }),
+            });
+            if (resp.ok) {
+                const data = await resp.json();
+                if (data.state &&
+                    typeof data.state === "object" &&
+                    Object.keys(data.state).length > 0) {
+                    this.managedState = data.state;
+                    this.managedStateInitialized = true;
+                }
+            }
+        }
+        catch (err) {
+            logger.warn(`Failed to load existing projection state: ${err}`);
+        }
+    }
+    /**
+     * Start in poll mode (fallback). Uses the existing PollProjectionEvents RPC
+     * with exponential backoff.
+     */
+    async start() {
+        this.running = true;
+        await this.register();
+        this.config.logger.info(`Projection runner started: ${this.config.projection.config.name}`);
+        while (this.running && !this.config.signal?.aborted) {
+            try {
+                const processed = await this.poll();
+                if (processed > 0) {
+                    this.backoffMs = 1000; // Reset backoff
+                }
+                else {
+                    // Backoff on empty poll
+                    await this.sleep(this.backoffMs);
+                    this.backoffMs = Math.min(this.backoffMs * 2, 10000);
+                }
+            }
+            catch (err) {
+                this.config.logger.error(`Projection poll error: ${err}`);
+                await this.sleep(this.backoffMs);
+                this.backoffMs = Math.min(this.backoffMs * 2, 10000);
+            }
+        }
+    }
+    async stop() {
+        this.running = false;
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        // Wait for any in-flight flush, then flush remaining events
+        await this.flushChain;
+        await this.flushPending();
+    }
+    async poll() {
+        const { projection, baseUrl, headers } = this.config;
+        const resp = await fetch(`${baseUrl}/ironflow.v1.ProjectionService/PollProjectionEvents`, {
+            method: "POST",
+            headers: { ...headers, "Content-Type": "application/json" },
+            body: JSON.stringify({
+                name: projection.config.name,
+                batchSize: projection.config.batchSize || 100,
+            }),
+        });
+        if (!resp.ok)
+            throw new Error(`Poll failed: ${resp.status}`);
+        const data = (await resp.json());
+        const events = data.events || [];
+        if (events.length === 0)
+            return 0;
+        const projConfig = projection.config;
+        if (projConfig.mode === "managed") {
+            // Managed mode: group events by partition, run reducer per partition, save each.
+            const partitions = new Map();
+            for (const event of events) {
+                const pk = event.metadata?.["__partition"] || "__global__";
+                if (!partitions.has(pk)) {
+                    partitions.set(pk, {
+                        events: [],
+                        lastEventId: "",
+                        lastEventSeq: 0,
+                    });
+                }
+                partitions.get(pk).events.push(event);
+            }
+            for (const [pk, batch] of partitions) {
+                // Use currentState from server only for __global__ (non-partitioned).
+                let state = pk === "__global__" && data.currentState != null
+                    ? data.currentState
+                    : projConfig.initialState
+                        ? projConfig.initialState()
+                        : {};
+                for (const event of batch.events) {
+                    const ctx = this.buildContext(event);
+                    state = projConfig.handler(state, event, ctx);
+                    batch.lastEventId = event.id;
+                    batch.lastEventSeq = event.seq;
+                    batch.lastEventTime = event.timestamp;
+                }
+                await this.saveState(state, batch.lastEventId, batch.lastEventSeq, batch.lastEventTime, pk);
+            }
+        }
+        else {
+            // External mode: run handler for each event, then ack
+            let lastEventId = "";
+            let lastEventSeq = 0;
+            for (const event of events) {
+                const ctx = this.buildContext(event);
+                await projConfig.handler(event, ctx);
+                lastEventId = event.id;
+                lastEventSeq = event.seq;
+            }
+            await this.ackEvents(lastEventId, lastEventSeq);
+        }
+        return events.length;
+    }
+    buildContext(event) {
+        return {
+            event: {
+                id: event.id,
+                name: event.name,
+                seq: event.seq || 0,
+                timestamp: event.timestamp ? new Date(event.timestamp) : new Date(),
+                metadata: event.metadata,
+            },
+            projection: {
+                name: this.config.projection.config.name,
+                version: 1,
+            },
+            logger: this.config.logger,
+        };
+    }
+    async saveState(state, lastEventId, lastEventSeq, lastEventTime, partitionKey) {
+        const { baseUrl, headers, projection } = this.config;
+        const resp = await fetch(`${baseUrl}/ironflow.v1.ProjectionService/SaveProjectionState`, {
+            method: "POST",
+            headers: { ...headers, "Content-Type": "application/json" },
+            body: JSON.stringify({
+                name: projection.config.name,
+                partitionKey: partitionKey ?? "",
+                state,
+                lastEventId,
+                lastEventSeq,
+                lastEventTime,
+            }),
+        });
+        if (!resp.ok)
+            throw new Error(`Save state failed: ${resp.status}`);
+    }
+    async ackEvents(lastEventId, lastEventSeq) {
+        const { baseUrl, headers, projection } = this.config;
+        const resp = await fetch(`${baseUrl}/ironflow.v1.ProjectionService/AckProjectionEvents`, {
+            method: "POST",
+            headers: { ...headers, "Content-Type": "application/json" },
+            body: JSON.stringify({
+                name: projection.config.name,
+                lastEventId,
+                lastEventSeq,
+            }),
+        });
+        if (!resp.ok)
+            throw new Error(`Ack events failed: ${resp.status}`);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => {
+            const timer = setTimeout(resolve, ms);
+            this.config.signal?.addEventListener("abort", () => {
+                clearTimeout(timer);
+                resolve();
+            }, { once: true });
+        });
+    }
+}
+/** Error thrown when the server doesn't support the streaming RPC */
+export class StreamingUnsupportedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "StreamingUnsupportedError";
+    }
+}
+export function createProjectionRunner(config) {
+    return new ProjectionRunner(config);
+}
+//# sourceMappingURL=projection-runner.js.map

package/dist/projection-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-runner.js","sourceRoot":"","sources":["../src/projection-runner.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAmDvC,sCAAsC;AACtC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,mFAAmF;AACnF,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,sBAAsB;IAC1C,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,oBAAoB;IAC9D,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAyB;IAC/B,OAAO,GAAG,KAAK,CAAC;IAChB,SAAS,GAAG,IAAI,CAAC;IAEzB,uCAAuC;IAC/B,aAAa,GAAgB,EAAE,CAAC;IAChC,UAAU,GAAyC,IAAI,CAAC;IAChE,sEAAsE;IAC9D,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IACtD,6EAA6E;IACrE,YAAY,GAAY,IAAI,CAAC;IAC7B,uBAAuB,GAAG,KAAK,CAAC;IAExC,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,GAAG,OAAO,mDAAmD,EAC7D;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC3D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI;gBAC5B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM;gBAChC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI;gBAC5B,OAAO,EAAE,CAAC;gBACV,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE;aACnD,CAAC;SACH,CACF,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEtB,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7D,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;QAEpC,MAAM,CAAC,IAAI,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;QAE9D,4DAA4D;QAC5D,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC3E,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACrD,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;QACtC,CAAC;QAED,oEAAoE;QACpE,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE/B,sEAAsE;QACtE,wEAAwE;QACxE,mEAAmE;QACnE,sCAAsC;QACtC,IAAI,mBAAmB,GAAG,CAAC,CAAC;QAC5B,MAAM,oBAAoB,GAAG,CAAC,CAAC;QAE/B,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,GAAG,OAAO,uDAAuD,EACjE;oBACE,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,GAAG,OAAO;wBACV,cAAc,EAAE,0BAA0B;qBAC3C;oBACD,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC;wBACzC,IAAI;wBACJ,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG;wBAC7C,2DAA2D;wBAC3D,yDAAyD;wBACzD,0DAA0D;wBAC1D,0CAA0C;wBAC1C,gBAAgB,EAAE,IAAI;qBACvB,CAAC,CAAC;oBACH,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;iBAC3B,CACF,CAAC;gBAEF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;oBACb,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;oBAC3B,wEAAwE;oBACxE,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;wBACrC,MAAM,IAAI,yBAAyB,CACjC,mDAAmD,MAAM,GAAG,CAC7D,CAAC;oBACJ,CAAC;oBACD,8EAA8E;oBAC9E,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;wBACrC,MAAM,IAAI,yBAAyB,CACjC,iCAAiC,MAAM,uBAAuB,CAC/D,CAAC;oBACJ,CAAC;oBACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;gBACtD,CAAC;gBAED,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBACpD,CAAC;gBAED,8EAA8E;gBAC9E,4EAA4E;gBAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAErC,IAAI,CAAC;oBACH,IAAI,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;oBAE/B,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;wBACpD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;wBAC5C,IAAI,IAAI;4BAAE,MAAM;wBAEhB,4DAA4D;wBAC5D,mDAAmD;wBACnD,mBAAmB,GAAG,CAAC,CAAC;wBAExB,4BAA4B;wBAC5B,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;wBAC/D,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;wBACtB,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;wBACpC,MAAM,GAAG,SAAS,CAAC;wBAEnB,8CAA8C;wBAC9C,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;4BAC1B,8DAA8D;4BAC9D,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;4BACnF,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa;4BAC7D,MAAM,WAAW,GAAG,CAAC,GAAG,SAAS,CAAC;4BAElC,IAAI,MAAM,CAAC,MAAM,GAAG,WAAW;gCAAE,MAAM,CAAC,qBAAqB;4BAE7D,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;4BAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;4BAC7C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;4BAEnC,qDAAqD;4BACrD,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;gCACjB,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gCAC/C,IAAI,CAAC;oCACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoD,CAAC;oCACpF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;wCAClB,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;oCACvF,CAAC;gCACH,CAAC;gCAAC,MAAM,CAAC,CAAC,+BAA+B,CAAC,CAAC;gCAC3C,MAAM,CAAC,gBAAgB;4BACzB,CAAC;4BAED,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;4BAC/C,IAAI,CAAC;gCACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2C,CAAC;gCACzE,sDAAsD;gCACtD,wDAAwD;gCACxD,2CAA2C;gCAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,iCAAiC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oCACzE,SAAS;gCACX,CAAC;gCACD,uDAAuD;gCACvD,MAAM,UAAU,GAAc;oCAC5B,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE;oCAClB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;oCACtB,IAAI,EAAE,KAAK,CAAC,IAAI;oCAChB,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAwB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;oCACpG,SAAS,EAAE,KAAK,CAAC,SAAS;oCAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;iCACzB,CAAC;gCACF,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;4BAChC,CAAC;4BAAC,MAAM,CAAC;gCACP,0BAA0B;gCAC1B,MAAM,CAAC,IAAI,CAAC,sCAAsC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;4BAC1E,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;wBAAS,CAAC;oBACT,MAAM,CAAC,WAAW,EAAE,CAAC;oBACrB,6BAA6B;oBAC7B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC5B,CAAC;gBAED,+CAA+C;gBAC/C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,+BAA+B,IAAI,mBAAmB,CAAC,CAAC;oBACpE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO;oBAAE,MAAM;gBAExD,wEAAwE;gBACxE,IAAI,GAAG,YAAY,yBAAyB,EAAE,CAAC;oBAC7C,MAAM,GAAG,CAAC;gBACZ,CAAC;gBAED,mBAAmB,IAAI,CAAC,CAAC;gBACzB,IAAI,mBAAmB,GAAG,oBAAoB,EAAE,CAAC;oBAC/C,8DAA8D;oBAC9D,kDAAkD;oBAClD,MAAM,CAAC,IAAI,CAAC,sCAAsC,IAAI,2BAA2B,mBAAmB,GAAG,CAAC,CAAC;gBAC3G,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,KAAK,CAAC,+BAA+B,IAAI,KAAK,mBAAmB,2BAA2B,GAAG,EAAE,CAAC,CAAC;gBAC5G,CAAC;gBACD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,+BAA+B;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,YAAY,CAAC,KAAgB;QACnC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;QACjE,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC3C,+DAA+D;YAC/D,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5B,wBAAwB;YACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBACvB,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,CAAC,EAAE,iBAAiB,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,wDAAwD;IAChD,aAAa;QACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEhC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAEjD,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB,CAAC,MAAmB;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAEjD,qBAAqB;QACrB,MAAM,UAAU,GAAG,IAAI,GAAG,EAGvB,CAAC;QACJ,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,EAAE,GAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAY,IAAI,YAAY,CAAC;YACvE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxB,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YACrC,4DAA4D;YAC5D,IAAI,KAAc,CAAC;YACnB,IAAI,EAAE,KAAK,YAAY,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;gBACxD,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACrC,KAAK,GAAI,UAAU,CAAC,OAAoC,CAAC,KAAK,EAAE,KAAY,EAAE,GAAG,CAAC,CAAC;gBACnF,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC;gBAC/B,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC;YACxC,CAAC;YAED,kDAAkD;YAClD,IAAI,EAAE,KAAK,YAAY,EAAE,CAAC;gBACxB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;gBAC1B,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;YACtC,CAAC;YAED,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAAC,MAAmB;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QACjD,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACrC,MAAO,UAAU,CAAC,OAAqC,CAAC,KAAY,EAAE,GAAG,CAAC,CAAC;YAC3E,WAAW,GAAG,KAAK,CAAC,EAAE,CAAC;YACvB,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC;QAC3B,CAAC;QAED,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,iBAAiB;QAC7B,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7D,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QAEjD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,GAAG,OAAO,8CAA8C,EACxD;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC3D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;aACvD,CACF,CAAC;YACF,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAyB,CAAC;gBACtD,IACE,IAAI,CAAC,KAAK;oBACV,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;oBAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,MAAM,GAAG,CAAC,EAC7D,CAAC;oBACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC;oBAC/B,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,6CAA6C,GAAG,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CACrB,8BAA8B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CACnE,CAAC;QAEF,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;oBAClB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,gBAAgB;gBACzC,CAAC;qBAAM,CAAC;oBACN,wBAAwB;oBACxB,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACjC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;gBAC1D,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACjC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,4DAA4D;QAC5D,MAAM,IAAI,CAAC,UAAU,CAAC;QACtB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAErD,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,GAAG,OAAO,qDAAqD,EAC/D;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC3D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI;gBAC5B,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG;aAC9C,CAAC;SACH,CACF,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAE7D,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAiB,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAElC,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;QAErC,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,iFAAiF;YACjF,MAAM,UAAU,GAAG,IAAI,GAAG,EAGvB,CAAC;YACJ,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,EAAE,GACL,KAAK,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAY,IAAI,YAAY,CAAC;gBAC9D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBACxB,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE;wBACjB,MAAM,EAAE,EAAE;wBACV,WAAW,EAAE,EAAE;wBACf,YAAY,EAAE,CAAC;qBAChB,CAAC,CAAC;gBACL,CAAC;gBACD,UAAU,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;YAED,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;gBACrC,sEAAsE;gBACtE,IAAI,KAAK,GACP,EAAE,KAAK,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;oBAC9C,CAAC,CAAC,IAAI,CAAC,YAAY;oBACnB,CAAC,CAAC,UAAU,CAAC,YAAY;wBACvB,CAAC,CAAC,UAAU,CAAC,YAAY,EAAE;wBAC3B,CAAC,CAAC,EAAE,CAAC;gBAEX,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;oBACrC,KAAK,GAAI,UAAU,CAAC,OAAoC,CACtD,KAAK,EACL,KAAY,EACZ,GAAG,CACJ,CAAC;oBACF,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,EAAE,CAAC;oBAC7B,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC;oBAC/B,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC;gBACxC,CAAC;gBAED,MAAM,IAAI,CAAC,SAAS,CAClB,KAAK,EACL,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,aAAa,EACnB,EAAE,CACH,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,sDAAsD;YACtD,IAAI,WAAW,GAAG,EAAE,CAAC;YACrB,IAAI,YAAY,GAAG,CAAC,CAAC;YAErB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACrC,MAAO,UAAU,CAAC,OAAqC,CACrD,KAAY,EACZ,GAAG,CACJ,CAAC;gBACF,WAAW,GAAG,KAAK,CAAC,EAAE,CAAC;gBACvB,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC;YAC3B,CAAC;YAED,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAEO,YAAY,CAAC,KAAgB;QACnC,OAAO;YACL,KAAK,EAAE;gBACL,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;gBACnB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE;gBACnE,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI;gBACxC,OAAO,EAAE,CAAC;aACX;YACD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;SAC3B,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,KAAc,EACd,WAAmB,EACnB,YAAoB,EACpB,aAAsB,EACtB,YAAqB;QAErB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,GAAG,OAAO,oDAAoD,EAC9D;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC3D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI;gBAC5B,YAAY,EAAE,YAAY,IAAI,EAAE;gBAChC,KAAK;gBACL,WAAW;gBACX,YAAY;gBACZ,aAAa;aACd,CAAC;SACH,CACF,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,WAAmB,EACnB,YAAoB;QAEpB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,GAAG,OAAO,oDAAoD,EAC9D;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC3D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI;gBAC5B,WAAW;gBACX,YAAY;aACb,CAAC;SACH,CACF,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAClC,OAAO,EACP,GAAG,EAAE;gBACH,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,EAAE,CAAC;YACZ,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,MAA8B;IACnE,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/projection.d.ts

@@ -0,0 +1,36 @@
+import type { ProjectionConfig, IronflowProjection } from "@ironflow/core";
+/**
+ * Create a projection definition.
+ *
+ * Projections subscribe to event streams and maintain derived state (managed mode)
+ * or trigger side effects (external mode).
+ *
+ * Mode is auto-detected from the presence of `initialState`:
+ * - If `initialState` is provided, mode defaults to "managed"
+ * - If `initialState` is absent, mode defaults to "external"
+ *
+ * @example
+ * ```typescript
+ * // Managed projection (maintains state)
+ * const orderTotals = createProjection({
+ *   name: "order-totals",
+ *   events: ["order.created", "order.updated"],
+ *   initialState: () => ({ total: 0, count: 0 }),
+ *   handler: (state, event) => ({
+ *     total: state.total + event.data.amount,
+ *     count: state.count + 1,
+ *   }),
+ * });
+ *
+ * // External projection (side effects)
+ * const emailNotifier = createProjection({
+ *   name: "email-notifier",
+ *   events: ["order.completed"],
+ *   handler: async (event, ctx) => {
+ *     await sendEmail(event.data.email, "Order complete!");
+ *   },
+ * });
+ * ```
+ */
+export declare function createProjection<TState = unknown, TEvent = unknown>(config: ProjectionConfig<TState, TEvent>): IronflowProjection<TState, TEvent>;
+//# sourceMappingURL=projection.d.ts.map

package/dist/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EACjE,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBpC"}

package/dist/projection.js

@@ -0,0 +1,55 @@
+// sdk/js/node/src/projection.ts
+import { ValidationError } from "@ironflow/core";
+/**
+ * Create a projection definition.
+ *
+ * Projections subscribe to event streams and maintain derived state (managed mode)
+ * or trigger side effects (external mode).
+ *
+ * Mode is auto-detected from the presence of `initialState`:
+ * - If `initialState` is provided, mode defaults to "managed"
+ * - If `initialState` is absent, mode defaults to "external"
+ *
+ * @example
+ * ```typescript
+ * // Managed projection (maintains state)
+ * const orderTotals = createProjection({
+ *   name: "order-totals",
+ *   events: ["order.created", "order.updated"],
+ *   initialState: () => ({ total: 0, count: 0 }),
+ *   handler: (state, event) => ({
+ *     total: state.total + event.data.amount,
+ *     count: state.count + 1,
+ *   }),
+ * });
+ *
+ * // External projection (side effects)
+ * const emailNotifier = createProjection({
+ *   name: "email-notifier",
+ *   events: ["order.completed"],
+ *   handler: async (event, ctx) => {
+ *     await sendEmail(event.data.email, "Order complete!");
+ *   },
+ * });
+ * ```
+ */
+export function createProjection(config) {
+    // Validate
+    if (!config.name) {
+        throw new ValidationError("Projection name is required");
+    }
+    if (!config.events || config.events.length === 0) {
+        throw new ValidationError("Projection must subscribe to at least one event");
+    }
+    // Auto-detect mode
+    const mode = config.mode ?? (config.initialState ? "managed" : "external");
+    return {
+        config: {
+            ...config,
+            mode,
+            maxRetries: config.maxRetries ?? 3,
+            batchSize: config.batchSize ?? 100,
+        },
+    };
+}
+//# sourceMappingURL=projection.js.map

package/dist/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAMhC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAwC;IAExC,WAAW;IACX,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,eAAe,CAAC,6BAA6B,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,eAAe,CAAC,iDAAiD,CAAC,CAAC;IAC/E,CAAC;IAED,mBAAmB;IACnB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAE3E,OAAO;QACL,MAAM,EAAE;YACN,GAAG,MAAM;YACT,IAAI;YACJ,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YAClC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG;SACnC;KACF,CAAC;AACJ,CAAC"}

package/dist/secrets.d.ts

@@ -0,0 +1,6 @@
+import type { SecretsClient } from "@ironflow/core";
+/**
+ * Creates a read-only SecretsClient from a resolved secrets map.
+ */
+export declare function createSecretsClient(secrets?: Record<string, string>): SecretsClient;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,aAAa,CAcf"}

package/dist/secrets.js

@@ -0,0 +1,19 @@
+/**
+ * Creates a read-only SecretsClient from a resolved secrets map.
+ */
+export function createSecretsClient(secrets) {
+    const values = secrets ?? {};
+    return {
+        get(name) {
+            const value = values[name];
+            if (value === undefined) {
+                throw new Error(`Secret "${name}" not found`);
+            }
+            return value;
+        },
+        has(name) {
+            return name in values;
+        },
+    };
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAgC;IAEhC,MAAM,MAAM,GAAG,OAAO,IAAI,EAAE,CAAC;IAC7B,OAAO;QACL,GAAG,CAAC,IAAY;YACd,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,aAAa,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,GAAG,CAAC,IAAY;YACd,OAAO,IAAI,IAAI,MAAM,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}