@amigo-ai/platform-sdk 0.23.0 → 0.25.0

package/dist/resources/events.js

@@ -0,0 +1,588 @@
+/**
+ * Real-time workspace event streaming via Server-Sent Events.
+ *
+ * Subscribes to ``GET /v1/{workspace_id}/events/stream`` and yields typed
+ * {@link WorkspaceSSEEvent} values. The platform-api endpoint:
+ *
+ *   - Streams ``text/event-stream`` over HTTP/1.1
+ *   - Sends ``retry: 3000`` directive as the first frame
+ *   - Tags every event with ``id: <millisecond-timestamp>`` for replay
+ *   - Buffers the last 5 minutes of events in Valkey for gapless reconnect
+ *   - Pops the discriminator (``event_type``) out of the JSON ``data:``
+ *     payload and into the SSE ``event:`` line — this helper reattaches
+ *     it before yielding the typed union member
+ *
+ * Implementation choice: this helper uses the SDK's own fetch transport
+ * (with auth + retry middleware applied) rather than the WHATWG
+ * ``EventSource`` API or the ``eventsource`` polyfill. The reasons are:
+ *
+ *   1. ``EventSource`` cannot send ``Authorization`` headers — the polyfill
+ *      can, but adds a runtime dep and bypasses the SDK's BFF-proxy /
+ *      custom-fetch / mock-fetch composition.
+ *   2. Reusing the existing ``createTurnStream`` pattern keeps a single
+ *      SSE parser in the SDK and shares the auth middleware that already
+ *      attaches the bearer token on every request.
+ *   3. The SDK ships with two runtime deps (``openapi-fetch`` +
+ *      ``openapi-typescript-helpers``); adding ``eventsource`` would inflate
+ *      bundle size for a feature that fetch streaming handles cleanly.
+ *
+ * The trade-off is that we reimplement the reconnect loop. The platform-api
+ * advertises ``retry: 3000`` and we honor that as the initial backoff,
+ * doubling with full jitter on each successive failure up to ``maxDelayMs``.
+ *
+ * @see ConversationsResource.streamTurn for the analogous turn-stream helper.
+ */
+import { WorkspaceScopedResource } from './base.js';
+/**
+ * Structured error surfaced through {@link SubscribeToWorkspaceOptions.onError}.
+ *
+ * Subclasses ``Error`` so existing consumers using ``err.message`` continue
+ * to work, while adding ``code`` + ``retryable`` + raw ``frame`` for
+ * deterministic branching. Inspect with ``isWorkspaceEventStreamError``.
+ */
+export class WorkspaceEventStreamError extends Error {
+    code;
+    retryable;
+    /** Raw decoded ``error`` frame body (or ``undefined`` for transport errors). */
+    frame;
+    constructor(message, code, retryable, frame) {
+        super(message);
+        this.name = 'WorkspaceEventStreamError';
+        this.code = code;
+        this.retryable = retryable;
+        this.frame = frame;
+    }
+}
+export function isWorkspaceEventStreamError(value) {
+    return value instanceof WorkspaceEventStreamError;
+}
+const DEFAULT_INITIAL_DELAY_MS = 3000;
+const DEFAULT_MAX_DELAY_MS = 30000;
+const DEFAULT_MAX_RECONNECTS = 10;
+// Hard ceiling on a single SSE field value to defend against a misbehaving
+// upstream that streams without ever emitting a frame terminator. 1 MiB is
+// far above any legitimate platform event payload (most are <2 KiB).
+const MAX_FRAME_BYTES = 1_048_576;
+/**
+ * Real-time event stream resource.
+ *
+ * @example
+ * ```ts
+ * const handle = client.events.subscribeToWorkspace({
+ *   onEvent: (event) => {
+ *     switch (event.event_type) {
+ *       case 'call.started':
+ *         console.log('Call started:', event.call_sid)
+ *         break
+ *       case 'pipeline.error':
+ *         console.error('Pipeline error:', event)
+ *         break
+ *     }
+ *   },
+ *   onError: (err) => console.error('Stream error:', err),
+ *   onReconnect: (attempt) => console.warn(`Reconnect #${attempt}`),
+ * })
+ *
+ * // Later, to stop:
+ * handle.unsubscribe()
+ * await handle.done
+ * ```
+ */
+export class EventsResource extends WorkspaceScopedResource {
+    constructor(client, workspaceId) {
+        super(client, workspaceId);
+    }
+    /**
+     * Subscribe to the workspace event stream.
+     *
+     * Establishes an SSE connection to ``/v1/{workspace_id}/events/stream``
+     * and invokes ``onEvent`` once per typed {@link WorkspaceSSEEvent}.
+     * Unrecoverable failures (auth errors, exhausted reconnect budget,
+     * caller abort) surface through ``onError``.
+     *
+     * Reconnection is automatic: on a network drop or 5xx, the helper
+     * backs off (initial delay derived from the ``retry:`` directive,
+     * default 3s, doubling with full jitter up to ``maxDelayMs``) and
+     * resumes with the most recently seen ``Last-Event-ID``. The platform
+     * buffers 5 minutes of events for gapless replay.
+     *
+     * @returns a {@link SubscriptionHandle} for cleanup. Aborting the
+     *   caller's ``signal`` is equivalent to calling ``unsubscribe()``.
+     */
+    subscribeToWorkspace(options) {
+        const localController = new AbortController();
+        const cleanups = [];
+        if (options.signal) {
+            if (options.signal.aborted) {
+                localController.abort(options.signal.reason);
+            }
+            else {
+                const onAbort = () => localController.abort(options.signal?.reason);
+                options.signal.addEventListener('abort', onAbort, { once: true });
+                cleanups.push(() => options.signal?.removeEventListener('abort', onAbort));
+            }
+        }
+        const done = runSubscription(this.client, this.workspaceId, options, localController.signal).finally(() => {
+            for (const cleanup of cleanups)
+                cleanup();
+        });
+        return {
+            done,
+            unsubscribe: () => localController.abort(),
+        };
+    }
+}
+/**
+ * Server-sent ``error`` event frames that the SDK should treat as terminal
+ * (do NOT auto-retry). Mirror the ``code`` taxonomy emitted by
+ * ``platform-api/src/routes/event_stream.py``.
+ */
+const TERMINAL_SERVER_ERROR_CODES = {
+    too_many_streams: 'too_many_streams',
+};
+/**
+ * Server-sent ``error`` event frames that are recoverable — surface them as
+ * transport errors so the reconnect loop kicks in. ``stream_unavailable``
+ * fires when Valkey is down; ``stream_error`` is the generic catch-all from
+ * the server-side ``except Exception`` branch.
+ */
+const RECOVERABLE_SERVER_ERROR_CODES = {
+    stream_unavailable: 'stream_unavailable',
+    stream_error: 'stream_error',
+};
+async function runSubscription(client, workspaceId, options, signal) {
+    let lastEventId = options.lastEventId;
+    let attempt = 0;
+    let delayMs = options.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;
+    const maxDelayMs = options.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;
+    const maxReconnects = options.maxReconnects ?? DEFAULT_MAX_RECONNECTS;
+    let errorReported = false;
+    const reportError = (error) => {
+        if (errorReported)
+            return;
+        errorReported = true;
+        try {
+            options.onError?.(error);
+        }
+        catch {
+            // Consumer-supplied callback raised — swallow to keep teardown clean.
+        }
+    };
+    while (!signal.aborted) {
+        if (attempt > 0) {
+            try {
+                options.onReconnect?.(attempt);
+            }
+            catch {
+                // Consumer-supplied callback raised — swallow to keep teardown clean.
+            }
+        }
+        let outcome;
+        try {
+            outcome = await runOneConnection({
+                client,
+                workspaceId,
+                lastEventId,
+                signal,
+                onEvent: options.onEvent,
+                onIdAdvance: (id) => {
+                    lastEventId = id;
+                },
+                onRetryDirective: (ms) => {
+                    // Server-sent retry directive resets the backoff floor.
+                    delayMs = clampDelay(ms, options.initialDelayMs, maxDelayMs);
+                },
+            });
+        }
+        catch (err) {
+            // runOneConnection surfaces only terminal auth errors via throw;
+            // everything else is a StreamOutcome. Preserve the original Error
+            // (typically ``AuthenticationError`` with ``statusCode``) so consumers
+            // that branch on ``err.statusCode`` keep working.
+            reportError(err instanceof Error ? err : new Error(String(err)));
+            return;
+        }
+        if (signal.aborted || outcome.kind === 'aborted') {
+            return;
+        }
+        if (outcome.kind === 'auth-error') {
+            // 401 / 403 — never auto-retry. The token is invalid and the
+            // stream cannot succeed without operator intervention. Surface the
+            // original ``AuthenticationError`` so consumers checking
+            // ``err.statusCode`` keep working.
+            reportError(outcome.error);
+            return;
+        }
+        if (outcome.kind === 'terminal-server-error') {
+            // Server emitted a structured ``error`` frame with a code that the
+            // SDK recognizes as terminal (e.g., ``too_many_streams``). Surface
+            // it as a typed ``WorkspaceEventStreamError`` so consumers can branch
+            // on ``error.code`` without parsing free-form text.
+            reportError(new WorkspaceEventStreamError(outcome.message, outcome.code, outcome.retryable, outcome.frame));
+            return;
+        }
+        if (attempt >= maxReconnects) {
+            reportError(new WorkspaceEventStreamError(`SSE subscription exhausted reconnect budget (${maxReconnects}): ${outcome.reason}`, 'transport_exhausted', true));
+            return;
+        }
+        attempt += 1;
+        const sleepMs = jitter(delayMs);
+        delayMs = Math.min(delayMs * 2, maxDelayMs);
+        const slept = await abortableSleep(sleepMs, signal);
+        if (!slept)
+            return;
+    }
+}
+async function runOneConnection(args) {
+    const headers = { Accept: 'text/event-stream' };
+    if (args.lastEventId !== undefined) {
+        headers['Last-Event-ID'] = args.lastEventId;
+    }
+    let result;
+    try {
+        result = await args.client.GET('/v1/{workspace_id}/events/stream', {
+            params: { path: { workspace_id: args.workspaceId } },
+            headers,
+            parseAs: 'stream',
+            signal: args.signal,
+        });
+    }
+    catch (err) {
+        if (args.signal.aborted)
+            return { kind: 'aborted' };
+        const error = err instanceof Error ? err : new Error(String(err));
+        // 4xx (including 401 / 403) are surfaced as thrown AmigoErrors by the
+        // SDK error middleware. Distinguish those from transport failures.
+        const status = readStatus(error);
+        if (status === 401 || status === 403) {
+            return { kind: 'auth-error', error };
+        }
+        return { kind: 'transport-error', reason: error.message };
+    }
+    if (result.error !== undefined) {
+        // openapi-fetch surfaces non-OK responses as `error`. The SDK error
+        // middleware should have thrown — fall through defensively.
+        return { kind: 'transport-error', reason: `API error: ${safeStringify(result.error)}` };
+    }
+    const body = result.data;
+    if (!(body instanceof ReadableStream)) {
+        return { kind: 'transport-error', reason: 'Expected ReadableStream body for SSE' };
+    }
+    try {
+        for await (const frame of parseSSEFrames(body, args.signal)) {
+            if (args.signal.aborted)
+                return { kind: 'aborted' };
+            if (frame.retry !== undefined) {
+                args.onRetryDirective(frame.retry);
+            }
+            if (frame.id !== undefined) {
+                args.onIdAdvance(frame.id);
+            }
+            if (frame.event === 'error' && frame.data !== undefined) {
+                // Structured error frame — branch on ``code`` from the server. We
+                // distinguish three buckets: terminal (don't retry), recoverable
+                // (let the reconnect loop run), and unknown (default to recoverable
+                // so a future server code does not strand consumers without auto-
+                // retry).
+                const errOutcome = interpretServerErrorFrame(frame.data);
+                if (errOutcome.terminal) {
+                    return {
+                        kind: 'terminal-server-error',
+                        code: errOutcome.code,
+                        message: errOutcome.message,
+                        retryable: errOutcome.retryable,
+                        frame: errOutcome.frame,
+                    };
+                }
+                return { kind: 'transport-error', reason: errOutcome.message };
+            }
+            if (frame.event && frame.data !== undefined) {
+                const event = parseWorkspaceFrame(frame.event, frame.data);
+                if (event) {
+                    try {
+                        args.onEvent(event);
+                    }
+                    catch {
+                        // Consumer threw during onEvent; do not let it kill the
+                        // subscription. The stream is still healthy.
+                    }
+                }
+            }
+        }
+    }
+    catch (err) {
+        if (args.signal.aborted)
+            return { kind: 'aborted' };
+        const reason = err instanceof Error ? err.message : String(err);
+        return { kind: 'transport-error', reason };
+    }
+    if (args.signal.aborted)
+        return { kind: 'aborted' };
+    // Reader closed cleanly — server EOF. Treat as recoverable; reconnect
+    // with whatever Last-Event-ID we have.
+    return { kind: 'transport-error', reason: 'Stream closed by server' };
+}
+/**
+ * Parses an SSE byte stream into structured frames.
+ *
+ * Forks the parser in {@link ConversationsResource.streamTurn} to also
+ * surface ``id:`` and ``retry:`` lines that the workspace event stream
+ * relies on for gapless reconnect.
+ */
+async function* parseSSEFrames(stream, signal) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    // When the caller aborts, cancel the reader so any in-flight
+    // ``reader.read()`` resolves immediately with ``{done: true}`` (or rejects
+    // with ``AbortError``, which we trap in the consumer). Without this, an
+    // idle SSE stream keeps the read pending indefinitely after abort.
+    let cancelled = false;
+    const onAbort = () => {
+        if (cancelled)
+            return;
+        cancelled = true;
+        void reader.cancel().catch(() => {
+            // Already cancelled or locked elsewhere; safe to ignore.
+        });
+    };
+    let removeAbortHandler;
+    if (signal.aborted) {
+        onAbort();
+    }
+    else {
+        signal.addEventListener('abort', onAbort, { once: true });
+        removeAbortHandler = () => signal.removeEventListener('abort', onAbort);
+    }
+    function* drain(text) {
+        buffer += text;
+        if (buffer.length > MAX_FRAME_BYTES) {
+            throw new Error(`SSE frame buffer exceeded ${MAX_FRAME_BYTES} bytes without terminator`);
+        }
+        while (true) {
+            const idx = findFrameTerminator(buffer);
+            if (idx === null)
+                break;
+            const block = buffer.slice(0, idx.terminatorStart);
+            buffer = buffer.slice(idx.terminatorEnd);
+            const frame = parseSSEBlock(block);
+            if (frame)
+                yield frame;
+        }
+    }
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            yield* drain(decoder.decode(value, { stream: true }));
+        }
+        yield* drain(decoder.decode());
+        if (buffer.trim().length > 0) {
+            const frame = parseSSEBlock(buffer);
+            if (frame)
+                yield frame;
+            buffer = '';
+        }
+    }
+    finally {
+        removeAbortHandler?.();
+        try {
+            reader.releaseLock();
+        }
+        catch {
+            // releaseLock can throw if the reader is already detached; ignore.
+        }
+    }
+}
+function findFrameTerminator(s) {
+    const lf = s.indexOf('\n\n');
+    const crlf = s.indexOf('\r\n\r\n');
+    if (lf < 0 && crlf < 0)
+        return null;
+    if (lf < 0)
+        return { terminatorStart: crlf, terminatorEnd: crlf + 4 };
+    if (crlf < 0)
+        return { terminatorStart: lf, terminatorEnd: lf + 2 };
+    return lf < crlf
+        ? { terminatorStart: lf, terminatorEnd: lf + 2 }
+        : { terminatorStart: crlf, terminatorEnd: crlf + 4 };
+}
+function parseSSEBlock(block) {
+    let event = '';
+    let id;
+    let retry;
+    const dataLines = [];
+    for (const line of block.split(/\r?\n/)) {
+        if (line === '' || line.startsWith(':'))
+            continue;
+        const colon = line.indexOf(':');
+        const field = colon < 0 ? line : line.slice(0, colon);
+        let value = colon < 0 ? '' : line.slice(colon + 1);
+        if (value.startsWith(' '))
+            value = value.slice(1);
+        if (field === 'event') {
+            event = value;
+        }
+        else if (field === 'data') {
+            dataLines.push(value);
+        }
+        else if (field === 'id') {
+            id = value;
+        }
+        else if (field === 'retry') {
+            const parsed = Number.parseInt(value, 10);
+            if (Number.isFinite(parsed) && parsed >= 0)
+                retry = parsed;
+        }
+        // Unknown fields are ignored per the SSE spec.
+    }
+    // Surface metadata-only frames (id-only or retry-only) so the reconnect
+    // loop can observe ``Last-Event-ID`` advances and server-sent retry hints
+    // even on heartbeats / replay-position markers.
+    if (!event && dataLines.length === 0 && id === undefined && retry === undefined) {
+        return null;
+    }
+    return {
+        event,
+        data: dataLines.length > 0 ? dataLines.join('\n') : undefined,
+        id,
+        retry,
+    };
+}
+/**
+ * Validate and reattach the discriminator to a frame's JSON payload.
+ *
+ * The platform-api SSE serializer pops ``event_type`` out of the JSON body
+ * (it lives in the SSE ``event:`` line). Reattach it so the resulting
+ * value is a well-formed {@link WorkspaceSSEEvent} union member.
+ *
+ * Drift-tolerant: an unparseable payload, non-object payload, or unknown
+ * ``event:`` discriminator is silently dropped (returns ``null``), matching
+ * the behavior of the analogous turn-stream parser.
+ */
+function parseWorkspaceFrame(eventName, dataJson) {
+    let payload;
+    try {
+        payload = JSON.parse(dataJson);
+    }
+    catch {
+        return null;
+    }
+    if (typeof payload !== 'object' || payload === null || Array.isArray(payload))
+        return null;
+    // The discriminator is whatever the server's `event:` line says. We trust
+    // the platform-api union: anything outside the generated literal type is
+    // dropped at the static-type boundary by the consumer's `switch`.
+    return {
+        ...payload,
+        event_type: eventName,
+    };
+}
+/**
+ * Decode a server-sent ``error`` frame body into either a terminal or
+ * recoverable outcome.
+ *
+ * The platform-api event stream emits these shapes:
+ *
+ *   { code: "too_many_streams", message: "...", max_streams: 50 }
+ *   { code: "stream_unavailable", message: "Event streaming unavailable" }
+ *   { code: "stream_error", message: "Stream error, please reconnect" }
+ *
+ * Unknown codes default to recoverable so a server-side addition does not
+ * strand SDK consumers without auto-retry.
+ */
+function interpretServerErrorFrame(dataJson) {
+    let payload;
+    try {
+        payload = JSON.parse(dataJson);
+    }
+    catch {
+        return {
+            terminal: false,
+            code: 'stream_error',
+            message: 'Server sent malformed error frame',
+            retryable: true,
+            frame: {},
+        };
+    }
+    if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+        return {
+            terminal: false,
+            code: 'stream_error',
+            message: 'Server sent non-object error frame',
+            retryable: true,
+            frame: {},
+        };
+    }
+    const obj = payload;
+    const rawCode = typeof obj['code'] === 'string' ? obj['code'] : '';
+    const message = typeof obj['message'] === 'string' ? obj['message'] : 'Stream error';
+    if (rawCode in TERMINAL_SERVER_ERROR_CODES) {
+        return {
+            terminal: true,
+            code: TERMINAL_SERVER_ERROR_CODES[rawCode],
+            message,
+            retryable: false,
+            frame: obj,
+        };
+    }
+    if (rawCode in RECOVERABLE_SERVER_ERROR_CODES) {
+        return {
+            terminal: false,
+            code: RECOVERABLE_SERVER_ERROR_CODES[rawCode],
+            message,
+            retryable: true,
+            frame: obj,
+        };
+    }
+    return {
+        terminal: false,
+        code: 'unknown',
+        message: rawCode ? `${message} (code=${rawCode})` : message,
+        retryable: true,
+        frame: obj,
+    };
+}
+function readStatus(error) {
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    const status = error.statusCode;
+    return typeof status === 'number' ? status : undefined;
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function jitter(ms) {
+    // Full jitter: pick a random delay in [0, ms]. Avoids reconnect stampedes
+    // when many clients reconnect simultaneously after a deploy.
+    return Math.floor(Math.random() * Math.max(1, ms));
+}
+function clampDelay(ms, floor, ceiling) {
+    const lo = floor ?? DEFAULT_INITIAL_DELAY_MS;
+    if (!Number.isFinite(ms) || ms <= 0)
+        return lo;
+    return Math.min(Math.max(ms, lo), ceiling);
+}
+async function abortableSleep(ms, signal) {
+    if (signal.aborted)
+        return false;
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(true);
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', onAbort);
+            resolve(false);
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/resources/events.js.map

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

package/dist/resources/integrations.js

@@ -55,6 +55,31 @@ export class IntegrationsResource extends WorkspaceScopedResource {
             body,
         }));
     }
+    /**
+     * Probe an integration's connection + auth without invoking any specific
+     * endpoint. Exercises auth resolution end-to-end (SSM lookups, OAuth2 token
+     * mints, JWT signing) and sends a HEAD request to ``base_url`` (REST/FHIR)
+     * or ``mcp_url`` (MCP). Safe on production integrations — HEAD carries no
+     * side effects.
+     *
+     * The most recent probe outcome is persisted on the integration so
+     * subsequent ``get`` / ``list`` responses surface ``last_tested_at`` +
+     * ``last_test_status`` without re-probing.
+     *
+     * @returns ``status`` is one of ``healthy`` / ``auth_failed`` /
+     *   ``unreachable`` / ``timeout`` / ``ssl_error`` / ``misconfigured``,
+     *   each mapping to a distinct, actionable user message.
+     */
+    async testConnection(integrationId) {
+        return extractData(await this.client.POST('/v1/{workspace_id}/integrations/{integration_id}/test-connection', {
+            params: {
+                path: {
+                    workspace_id: this.workspaceId,
+                    integration_id: integrationId,
+                },
+            },
+        }));
+    }
     /** Check health of all integrations in the workspace */
     async getHealthCheck() {
         return extractData(await this.client.GET('/v1/{workspace_id}/integrations/health-check', {

package/dist/resources/integrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../../src/resources/integrations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAShE;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,uBAAuB;IAC/D,+BAA+B;IAC/B,KAAK,CAAC,MAAM,CAAC,IAAuD;QAClE,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;YACxD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;YACpD,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,IAAI,CAAC,MAA+B;QACxC,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,EAAE;YACvD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;SACpE,CAAC,CACH,CAAA;IACH,CAAC;IAED,cAAc,CAAC,MAA+B;QAC5C,OAAO,IAAI,CAAC,oBAAoB,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;IACjF,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,GAAG,CAAC,aAAqC;QAC7C,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kDAAkD,EAAE;YACxE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,EAAE;SACpF,CAAC,CACH,CAAA;IACH,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,MAAM,CACV,aAAqC,EACrC,IAAuD;QAEvD,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kDAAkD,EAAE;YACxE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,EAAE;YACnF,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,MAAM,CAAC,aAAqC;QAChD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kDAAkD,EAAE;YAC3E,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,EAAE;SACpF,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,aAAqC,EACrC,YAAoB,EACpB,IAAkD;QAElD,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,iFAAiF,EACjF;YACE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,YAAY,EAAE,IAAI,CAAC,WAAW;oBAC9B,cAAc,EAAE,aAAa;oBAC7B,aAAa,EAAE,YAAY;iBAC5B;aACF;YACD,IAAI;SACL,CACF,CACF,CAAA;IACH,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,cAAc;QAClB,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8CAA8C,EAAE;YACpE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;SACrD,CAAC,CACH,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../../src/resources/integrations.ts"],"names":[],"mappings":"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"}