@mcp-native/mcp 0.5.0 → 0.6.0

package/dist/lifecycle.d.ts

@@ -0,0 +1,103 @@
+export declare const MCP_NATIVE_MAX_CONNECTION_ATTEMPTS = 8;
+export declare const MCP_NATIVE_MAX_CONNECTION_TIMEOUT_MS = 120000;
+export declare const MCP_NATIVE_MAX_CONNECTION_BACKOFF_MS = 30000;
+export type McpNativeConnectionErrorKind = "retryable" | "terminal";
+export declare class McpNativeConnectionLifecycleError extends Error {
+    readonly code: "cancelled" | "timeout";
+    constructor(code: "cancelled" | "timeout");
+}
+export interface McpNativeConnectionErrorClassification {
+    readonly kind: McpNativeConnectionErrorKind;
+    /** Host-authored, non-sensitive stable code. Raw error messages are never retained or emitted. */
+    readonly code: string;
+}
+export type McpNativeHostState = {
+    readonly kind: "loading";
+    readonly attempt: number;
+} | {
+    readonly kind: "ready";
+} | {
+    readonly kind: "empty";
+} | {
+    readonly kind: "denied";
+    readonly code: string;
+} | {
+    readonly kind: "disconnected";
+    readonly reason: "initial" | "offline" | "shutdown";
+} | {
+    readonly kind: "retryable-error";
+    readonly code: string;
+    readonly attempt: number;
+    readonly retryInMs: number;
+} | {
+    readonly kind: "terminal-error";
+    readonly code: string;
+    readonly exhausted: boolean;
+};
+export type McpNativeOperationalEvent = {
+    readonly type: "connection-attempt";
+    readonly attempt: number;
+    readonly timeoutMs: number;
+} | {
+    readonly type: "connection-result";
+    readonly attempt: number;
+    readonly outcome: "connected" | "retryable-error" | "terminal-error" | "cancelled";
+    readonly durationMs: number;
+    readonly code?: string;
+} | {
+    readonly type: "connection-backoff";
+    readonly attempt: number;
+    readonly delayMs: number;
+} | {
+    readonly type: "connection-close";
+    readonly reason: "retry" | "offline" | "shutdown";
+    readonly outcome: "completed" | "failed" | "timeout";
+} | {
+    readonly type: "connection-lost";
+    readonly outcome: "retryable-error" | "terminal-error";
+    readonly code: string;
+};
+/**
+ * Deliberately data-free diagnostics boundary. A host may map these fixed events to structured
+ * logs, counters/histograms, and traces without receiving credentials, tokens, server payloads,
+ * user payloads, URLs, error messages, or arbitrary labels from this package.
+ */
+export interface McpNativeOperationalSink {
+    emit(event: McpNativeOperationalEvent): void;
+}
+export interface McpNativeManagedConnection {
+    /** Connect through the official SDK. Hosts should stop promptly when `signal` aborts. */
+    connect(signal: AbortSignal): void | Promise<void>;
+    /** Close the SDK client/transport and release native resources. */
+    close(): void | Promise<void>;
+    /** Optional one-shot notification for an unexpected post-connect transport close. */
+    readonly closed?: Promise<unknown>;
+}
+export interface McpNativeConnectionLifecycleOptions {
+    /** A fresh SDK client/transport ownership unit for every connection attempt. */
+    readonly createConnection: () => McpNativeManagedConnection;
+    /** Maps an opaque failure to a stable, non-sensitive host code and retry decision. */
+    readonly classifyError: (error: unknown) => McpNativeConnectionErrorClassification;
+    readonly onStateChange?: (state: McpNativeHostState) => void;
+    readonly diagnostics?: McpNativeOperationalSink;
+    readonly timeoutMs?: number;
+    readonly closeTimeoutMs?: number;
+    readonly maxAttempts?: number;
+    readonly initialBackoffMs?: number;
+    readonly maxBackoffMs?: number;
+    readonly backoffMultiplier?: number;
+    readonly now?: () => number;
+    readonly wait?: (milliseconds: number, signal: AbortSignal) => void | Promise<void>;
+    readonly initiallyOnline?: boolean;
+}
+export declare class McpNativeConnectionLifecycle {
+    #private;
+    constructor(options: McpNativeConnectionLifecycleOptions);
+    get state(): McpNativeHostState;
+    start(): Promise<void>;
+    retry(): Promise<void>;
+    setOnline(online: boolean): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export declare function createMcpNativeConnectionLifecycle(options: McpNativeConnectionLifecycleOptions): McpNativeConnectionLifecycle;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

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

package/dist/lifecycle.js

@@ -0,0 +1,425 @@
+export const MCP_NATIVE_MAX_CONNECTION_ATTEMPTS = 8;
+export const MCP_NATIVE_MAX_CONNECTION_TIMEOUT_MS = 120_000;
+export const MCP_NATIVE_MAX_CONNECTION_BACKOFF_MS = 30_000;
+export class McpNativeConnectionLifecycleError extends Error {
+    code;
+    constructor(code) {
+        super(code === "timeout" ? "MCP connection attempt timed out" : "MCP connection attempt cancelled");
+        this.name = "McpNativeConnectionLifecycleError";
+        this.code = code;
+    }
+}
+export class McpNativeConnectionLifecycle {
+    #options;
+    #state;
+    #online;
+    #shutdown = false;
+    #run;
+    #abort;
+    #connection;
+    #generation = 0;
+    #transitionTail = Promise.resolve();
+    constructor(options) {
+        if (options === null ||
+            typeof options !== "object" ||
+            typeof options.createConnection !== "function" ||
+            typeof options.classifyError !== "function" ||
+            (options.onStateChange !== undefined && typeof options.onStateChange !== "function") ||
+            (options.diagnostics !== undefined &&
+                (options.diagnostics === null || typeof options.diagnostics.emit !== "function")) ||
+            (options.initiallyOnline !== undefined && typeof options.initiallyOnline !== "boolean")) {
+            throw new TypeError("Connection lifecycle requires valid host callbacks");
+        }
+        const timeoutMs = boundedInteger(options.timeoutMs ?? 15_000, "connection timeout", 1, MCP_NATIVE_MAX_CONNECTION_TIMEOUT_MS);
+        const closeTimeoutMs = boundedInteger(options.closeTimeoutMs ?? 5_000, "connection close timeout", 1, MCP_NATIVE_MAX_CONNECTION_TIMEOUT_MS);
+        const maxAttempts = boundedInteger(options.maxAttempts ?? 3, "connection attempts", 1, MCP_NATIVE_MAX_CONNECTION_ATTEMPTS);
+        const initialBackoffMs = boundedInteger(options.initialBackoffMs ?? 250, "initial connection backoff", 0, MCP_NATIVE_MAX_CONNECTION_BACKOFF_MS);
+        const maxBackoffMs = boundedInteger(options.maxBackoffMs ?? 5_000, "maximum connection backoff", initialBackoffMs, MCP_NATIVE_MAX_CONNECTION_BACKOFF_MS);
+        const backoffMultiplier = options.backoffMultiplier ?? 2;
+        if (!Number.isFinite(backoffMultiplier) || backoffMultiplier < 1 || backoffMultiplier > 10) {
+            throw new TypeError("Connection backoff multiplier must be between 1 and 10");
+        }
+        if (options.now !== undefined && typeof options.now !== "function") {
+            throw new TypeError("Connection lifecycle clock must be a function");
+        }
+        if (options.wait !== undefined && typeof options.wait !== "function") {
+            throw new TypeError("Connection lifecycle wait must be a function");
+        }
+        this.#options = {
+            ...options,
+            timeoutMs,
+            closeTimeoutMs,
+            maxAttempts,
+            initialBackoffMs,
+            maxBackoffMs,
+            backoffMultiplier,
+            now: options.now ?? Date.now,
+            wait: options.wait ?? waitFor,
+        };
+        this.#online = options.initiallyOnline ?? true;
+        this.#state = Object.freeze({
+            kind: "disconnected",
+            reason: this.#online ? "initial" : "offline",
+        });
+    }
+    get state() {
+        return this.#state;
+    }
+    start() {
+        if (this.#shutdown) {
+            throw new Error("Connection lifecycle is shut down");
+        }
+        if (!this.#online) {
+            this.#setState({ kind: "disconnected", reason: "offline" });
+            return Promise.resolve();
+        }
+        if (this.#run !== undefined || this.#state.kind === "ready") {
+            return this.#run ?? Promise.resolve();
+        }
+        const generation = ++this.#generation;
+        this.#abort = new AbortController();
+        const run = this.#connectLoop(generation, this.#abort.signal).finally(() => {
+            if (this.#run === run) {
+                this.#run = undefined;
+                this.#abort = undefined;
+            }
+        });
+        this.#run = run;
+        return run;
+    }
+    async retry() {
+        if (this.#state.kind !== "retryable-error" && this.#state.kind !== "terminal-error") {
+            return;
+        }
+        await this.start();
+    }
+    setOnline(online) {
+        if (typeof online !== "boolean") {
+            throw new TypeError("Online state must be a boolean");
+        }
+        let connectionRun;
+        const transition = this.#serializeTransition(async () => {
+            if (this.#shutdown || this.#online === online)
+                return;
+            this.#online = online;
+            if (online) {
+                connectionRun = this.start();
+                return;
+            }
+            const run = this.#run;
+            this.#generation += 1;
+            this.#abort?.abort();
+            await this.#closeCurrent("offline");
+            await run;
+            this.#setState({ kind: "disconnected", reason: "offline" });
+        });
+        return transition.then(() => connectionRun);
+    }
+    shutdown() {
+        return this.#serializeTransition(async () => {
+            if (this.#shutdown)
+                return;
+            this.#shutdown = true;
+            const run = this.#run;
+            this.#generation += 1;
+            this.#abort?.abort();
+            await this.#closeCurrent("shutdown");
+            await run;
+            this.#setState({ kind: "disconnected", reason: "shutdown" });
+        });
+    }
+    #serializeTransition(operation) {
+        const result = this.#transitionTail.then(operation, operation);
+        this.#transitionTail = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    async #connectLoop(generation, signal) {
+        for (let attempt = 1; attempt <= this.#options.maxAttempts; attempt += 1) {
+            if (!this.#isCurrent(generation, signal))
+                return;
+            this.#setState({ kind: "loading", attempt });
+            this.#emit({ type: "connection-attempt", attempt, timeoutMs: this.#options.timeoutMs });
+            const startedAt = readClock(this.#options.now);
+            let connection;
+            try {
+                connection = validateConnection(this.#options.createConnection());
+            }
+            catch (error) {
+                if (!this.#handleFailure(error, attempt, startedAt, attempt < this.#options.maxAttempts) ||
+                    // eslint-disable-next-line no-await-in-loop -- bounded retries are deliberately sequential
+                    !(await this.#waitBeforeRetry(attempt, signal))) {
+                    return;
+                }
+                continue;
+            }
+            this.#connection = connection;
+            try {
+                // eslint-disable-next-line no-await-in-loop -- one owned connection attempt at a time
+                await withTimeoutAndAbort(Promise.resolve(connection.connect(signal)), this.#options.timeoutMs, signal);
+                if (!this.#isCurrent(generation, signal)) {
+                    // eslint-disable-next-line no-await-in-loop -- close the current unit before leaving the loop
+                    await this.#closeCurrent(this.#online ? "retry" : "offline");
+                    return;
+                }
+                this.#setState({ kind: "ready" });
+                this.#emit({
+                    type: "connection-result",
+                    attempt,
+                    outcome: "connected",
+                    durationMs: elapsed(readClock(this.#options.now), startedAt),
+                });
+                if (connection.closed !== undefined) {
+                    void Promise.resolve(connection.closed).then((reason) => this.#handleUnexpectedClose(connection, reason), (error) => this.#handleUnexpectedClose(connection, error));
+                }
+                return;
+            }
+            catch (error) {
+                // eslint-disable-next-line no-await-in-loop -- close before a fresh retry unit is created
+                await this.#closeCurrent(this.#online ? "retry" : "offline");
+                if (!this.#isCurrent(generation, signal)) {
+                    this.#emit({
+                        type: "connection-result",
+                        attempt,
+                        outcome: "cancelled",
+                        durationMs: elapsed(readClock(this.#options.now), startedAt),
+                    });
+                    return;
+                }
+                const retry = this.#handleFailure(error, attempt, startedAt, attempt < this.#options.maxAttempts);
+                if (!retry)
+                    return;
+            }
+            // eslint-disable-next-line no-await-in-loop -- backoff serializes bounded retry attempts
+            if (!(await this.#waitBeforeRetry(attempt, signal)))
+                return;
+        }
+    }
+    #handleFailure(error, attempt, startedAt, canRetry) {
+        const classification = validateClassification(this.#options.classifyError(error));
+        const durationMs = elapsed(readClock(this.#options.now), startedAt);
+        if (classification.kind === "terminal" || !canRetry) {
+            this.#setState({
+                kind: "terminal-error",
+                code: classification.code,
+                exhausted: classification.kind === "retryable",
+            });
+            this.#emit({
+                type: "connection-result",
+                attempt,
+                outcome: "terminal-error",
+                durationMs,
+                code: classification.code,
+            });
+            return false;
+        }
+        this.#setState({
+            kind: "retryable-error",
+            code: classification.code,
+            attempt,
+            retryInMs: 0,
+        });
+        this.#emit({
+            type: "connection-result",
+            attempt,
+            outcome: "retryable-error",
+            durationMs,
+            code: classification.code,
+        });
+        return true;
+    }
+    async #waitBeforeRetry(attempt, signal) {
+        const delayMs = Math.min(this.#options.maxBackoffMs, Math.round(this.#options.initialBackoffMs * this.#options.backoffMultiplier ** (attempt - 1)));
+        this.#setState({
+            kind: "retryable-error",
+            code: (this.#state.kind === "retryable-error" && this.#state.code) || "retryable",
+            attempt,
+            retryInMs: delayMs,
+        });
+        this.#emit({ type: "connection-backoff", attempt, delayMs });
+        try {
+            await this.#options.wait(delayMs, signal);
+            return !signal.aborted;
+        }
+        catch {
+            return false;
+        }
+    }
+    async #handleUnexpectedClose(connection, reason) {
+        if (this.#connection !== connection || this.#shutdown || !this.#online)
+            return;
+        this.#connection = undefined;
+        const activeRun = this.#run;
+        if (activeRun !== undefined)
+            await activeRun;
+        if (this.#shutdown || !this.#online)
+            return;
+        let classification;
+        try {
+            classification = validateClassification(this.#options.classifyError(reason));
+        }
+        catch {
+            this.#setState({
+                kind: "terminal-error",
+                code: "lifecycle-callback-failed",
+                exhausted: false,
+            });
+            return;
+        }
+        if (classification.kind === "terminal") {
+            this.#setState({ kind: "terminal-error", code: classification.code, exhausted: false });
+            this.#emit({
+                type: "connection-lost",
+                outcome: "terminal-error",
+                code: classification.code,
+            });
+            return;
+        }
+        this.#setState({
+            kind: "retryable-error",
+            code: classification.code,
+            attempt: 0,
+            retryInMs: 0,
+        });
+        this.#emit({
+            type: "connection-lost",
+            outcome: "retryable-error",
+            code: classification.code,
+        });
+        try {
+            await this.start();
+        }
+        catch {
+            if (!this.#shutdown && this.#online) {
+                this.#setState({
+                    kind: "terminal-error",
+                    code: "lifecycle-callback-failed",
+                    exhausted: false,
+                });
+            }
+        }
+    }
+    #isCurrent(generation, signal) {
+        return generation === this.#generation && !signal.aborted && this.#online && !this.#shutdown;
+    }
+    async #closeCurrent(reason) {
+        const connection = this.#connection;
+        this.#connection = undefined;
+        if (connection === undefined)
+            return;
+        const outcome = await settleWithin(Promise.resolve().then(() => connection.close()), this.#options.closeTimeoutMs);
+        this.#emit({ type: "connection-close", reason, outcome });
+    }
+    #setState(state) {
+        this.#state = Object.freeze(state);
+        try {
+            this.#options.onStateChange?.(this.#state);
+        }
+        catch {
+            // Host observation must not change connection ownership or retry behavior.
+        }
+    }
+    #emit(event) {
+        try {
+            this.#options.diagnostics?.emit(Object.freeze(event));
+        }
+        catch {
+            // Instrumentation failures must not alter the operation being observed.
+        }
+    }
+}
+export function createMcpNativeConnectionLifecycle(options) {
+    return new McpNativeConnectionLifecycle(options);
+}
+function validateConnection(value) {
+    if (value === null ||
+        typeof value !== "object" ||
+        typeof value.connect !== "function" ||
+        typeof value.close !== "function" ||
+        (value.closed !== undefined &&
+            (value.closed === null || typeof value.closed.then !== "function"))) {
+        throw new TypeError("Connection factory must return connect and close callbacks");
+    }
+    return value;
+}
+function validateClassification(value) {
+    if (value === null ||
+        typeof value !== "object" ||
+        (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)) {
+        throw new TypeError("Connection error classifier must return an object");
+    }
+    const candidate = value;
+    if (!Object.hasOwn(candidate, "kind") ||
+        !Object.hasOwn(candidate, "code") ||
+        (candidate.kind !== "retryable" && candidate.kind !== "terminal") ||
+        typeof candidate.code !== "string" ||
+        !/^[a-z][a-z0-9._-]{0,63}$/.test(candidate.code) ||
+        Object.keys(candidate).some((key) => key !== "kind" && key !== "code")) {
+        throw new TypeError("Connection error classifier returned an invalid safe classification");
+    }
+    return Object.freeze({ kind: candidate.kind, code: candidate.code });
+}
+function boundedInteger(value, label, minimum, maximum) {
+    if (!Number.isSafeInteger(value) || value < minimum || value > maximum) {
+        throw new TypeError(`${label} must be an integer from ${minimum} to ${maximum}`);
+    }
+    return value;
+}
+function elapsed(now, startedAt) {
+    return Math.max(0, Math.round(now - startedAt));
+}
+function readClock(now) {
+    const value = now();
+    if (!Number.isFinite(value) || value < 0 || value > Number.MAX_SAFE_INTEGER) {
+        throw new TypeError("Connection lifecycle clock must return a finite non-negative number");
+    }
+    return value;
+}
+function waitFor(milliseconds, signal) {
+    if (signal.aborted)
+        return Promise.reject(new Error("Connection wait aborted"));
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new Error("Connection wait aborted"));
+        };
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, milliseconds);
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function withTimeoutAndAbort(operation, timeoutMs, signal) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (callback) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            signal.removeEventListener("abort", onAbort);
+            callback();
+        };
+        const onAbort = () => finish(() => reject(new McpNativeConnectionLifecycleError("cancelled")));
+        const timer = setTimeout(() => finish(() => reject(new McpNativeConnectionLifecycleError("timeout"))), timeoutMs);
+        signal.addEventListener("abort", onAbort, { once: true });
+        if (signal.aborted)
+            onAbort();
+        void operation.then(() => finish(resolve), (error) => finish(() => reject(error)));
+    });
+}
+function settleWithin(operation, timeoutMs) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(outcome);
+        };
+        const timer = setTimeout(() => finish("timeout"), timeoutMs);
+        void operation.then(() => finish("completed"), () => finish("failed"));
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,oCAAoC,GAAG,OAAO,CAAC;AAC5D,MAAM,CAAC,MAAM,oCAAoC,GAAG,MAAM,CAAC;AAI3D,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IACjD,IAAI,CAA0B;IAEvC,YAAY,IAA6B;QACvC,KAAK,CACH,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,kCAAkC,CAC7F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAmFD,MAAM,OAAO,4BAA4B;IAC9B,QAAQ,CAaqB;IACtC,MAAM,CAAqB;IAC3B,OAAO,CAAU;IACjB,SAAS,GAAG,KAAK,CAAC;IAClB,IAAI,CAA4B;IAChC,MAAM,CAA8B;IACpC,WAAW,CAAyC;IACpD,WAAW,GAAG,CAAC,CAAC;IAChB,eAAe,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEnD,YAAY,OAA4C;QACtD,IACE,OAAO,KAAK,IAAI;YAChB,OAAO,OAAO,KAAK,QAAQ;YAC3B,OAAO,OAAO,CAAC,gBAAgB,KAAK,UAAU;YAC9C,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU;YAC3C,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU,CAAC;YACpF,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;gBAChC,CAAC,OAAO,CAAC,WAAW,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;YACnF,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,EACvF,CAAC;YACD,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,SAAS,GAAG,cAAc,CAC9B,OAAO,CAAC,SAAS,IAAI,MAAM,EAC3B,oBAAoB,EACpB,CAAC,EACD,oCAAoC,CACrC,CAAC;QACF,MAAM,cAAc,GAAG,cAAc,CACnC,OAAO,CAAC,cAAc,IAAI,KAAK,EAC/B,0BAA0B,EAC1B,CAAC,EACD,oCAAoC,CACrC,CAAC;QACF,MAAM,WAAW,GAAG,cAAc,CAChC,OAAO,CAAC,WAAW,IAAI,CAAC,EACxB,qBAAqB,EACrB,CAAC,EACD,kCAAkC,CACnC,CAAC;QACF,MAAM,gBAAgB,GAAG,cAAc,CACrC,OAAO,CAAC,gBAAgB,IAAI,GAAG,EAC/B,4BAA4B,EAC5B,CAAC,EACD,oCAAoC,CACrC,CAAC;QACF,MAAM,YAAY,GAAG,cAAc,CACjC,OAAO,CAAC,YAAY,IAAI,KAAK,EAC7B,4BAA4B,EAC5B,gBAAgB,EAChB,oCAAoC,CACrC,CAAC;QACF,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,GAAG,CAAC,IAAI,iBAAiB,GAAG,EAAE,EAAE,CAAC;YAC3F,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG;YACd,GAAG,OAAO;YACV,SAAS;YACT,cAAc;YACd,WAAW;YACX,gBAAgB;YAChB,YAAY;YACZ,iBAAiB;YACjB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG;YAC5B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;SAC9B,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC1B,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SAC7C,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5D,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,UAAU,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACzE,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBACtB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;gBACtB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACpF,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,MAAe;QACvB,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,aAAwC,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,IAAI,EAAE;YACtD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;gBAAE,OAAO;YACtD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;YACtB,IAAI,MAAM,EAAE,CAAC;gBACX,aAAa,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;YACtB,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YACpC,MAAM,GAAG,CAAC;YACV,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,IAAI,EAAE;YAC1C,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;YACtB,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACrC,MAAM,GAAG,CAAC;YACV,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB,CAAC,SAAqC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/D,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,IAAI,CAChC,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,MAAmB;QACxD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC;gBAAE,OAAO;YACjD,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;YACxF,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC/C,IAAI,UAAsC,CAAC;YAC3C,IAAI,CAAC;gBACH,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;YACpE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IACE,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;oBACpF,2FAA2F;oBAC3F,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAC/C,CAAC;oBACD,OAAO;gBACT,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;YAC9B,IAAI,CAAC;gBACH,sFAAsF;gBACtF,MAAM,mBAAmB,CACvB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAC3C,IAAI,CAAC,QAAQ,CAAC,SAAS,EACvB,MAAM,CACP,CAAC;gBACF,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;oBACzC,8FAA8F;oBAC9F,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;oBAC7D,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAClC,IAAI,CAAC,KAAK,CAAC;oBACT,IAAI,EAAE,mBAAmB;oBACzB,OAAO;oBACP,OAAO,EAAE,WAAW;oBACpB,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;iBAC7D,CAAC,CAAC;gBACH,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBACpC,KAAK,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAC1C,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,EAC3D,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,KAAK,CAAC,CAC1D,CAAC;gBACJ,CAAC;gBACD,OAAO;YACT,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,0FAA0F;gBAC1F,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBAC7D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;oBACzC,IAAI,CAAC,KAAK,CAAC;wBACT,IAAI,EAAE,mBAAmB;wBACzB,OAAO;wBACP,OAAO,EAAE,WAAW;wBACpB,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;qBAC7D,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAC/B,KAAK,EACL,OAAO,EACP,SAAS,EACT,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CACpC,CAAC;gBACF,IAAI,CAAC,KAAK;oBAAE,OAAO;YACrB,CAAC;YACD,yFAAyF;YACzF,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAAE,OAAO;QAC9D,CAAC;IACH,CAAC;IAED,cAAc,CAAC,KAAc,EAAE,OAAe,EAAE,SAAiB,EAAE,QAAiB;QAClF,MAAM,cAAc,GAAG,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QAClF,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;QACpE,IAAI,cAAc,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpD,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,SAAS,EAAE,cAAc,CAAC,IAAI,KAAK,WAAW;aAC/C,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,CAAC;gBACT,IAAI,EAAE,mBAAmB;gBACzB,OAAO;gBACP,OAAO,EAAE,gBAAgB;gBACzB,UAAU;gBACV,IAAI,EAAE,cAAc,CAAC,IAAI;aAC1B,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,cAAc,CAAC,IAAI;YACzB,OAAO;YACP,SAAS,EAAE,CAAC;SACb,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC;YACT,IAAI,EAAE,mBAAmB;YACzB,OAAO;YACP,OAAO,EAAE,iBAAiB;YAC1B,UAAU;YACV,IAAI,EAAE,cAAc,CAAC,IAAI;SAC1B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,OAAe,EAAE,MAAmB;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,IAAI,CAAC,QAAQ,CAAC,YAAY,EAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAC9F,CAAC;QACF,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,WAAW;YACjF,OAAO;YACP,SAAS,EAAE,OAAO;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC1C,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,sBAAsB,CAC1B,UAAsC,EACtC,MAAe;QAEf,IAAI,IAAI,CAAC,WAAW,KAAK,UAAU,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC/E,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;QAC5B,IAAI,SAAS,KAAK,SAAS;YAAE,MAAM,SAAS,CAAC;QAC7C,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC5C,IAAI,cAAsD,CAAC;QAC3D,IAAI,CAAC;YACH,cAAc,GAAG,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/E,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,2BAA2B;gBACjC,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,cAAc,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACxF,IAAI,CAAC,KAAK,CAAC;gBACT,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,gBAAgB;gBACzB,IAAI,EAAE,cAAc,CAAC,IAAI;aAC1B,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,cAAc,CAAC,IAAI;YACzB,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,CAAC;SACb,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC;YACT,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,iBAAiB;YAC1B,IAAI,EAAE,cAAc,CAAC,IAAI;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACpC,IAAI,CAAC,SAAS,CAAC;oBACb,IAAI,EAAE,gBAAgB;oBACtB,IAAI,EAAE,2BAA2B;oBACjC,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU,CAAC,UAAkB,EAAE,MAAmB;QAChD,OAAO,UAAU,KAAK,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;IAC/F,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAwC;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO;QACrC,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAChD,IAAI,CAAC,QAAQ,CAAC,cAAc,CAC7B,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,SAAS,CAAC,KAAyB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;QAC7E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAgC;QACpC,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;QAC1E,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,kCAAkC,CAChD,OAA4C;IAE5C,OAAO,IAAI,4BAA4B,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAiC;IAC3D,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU;QACnC,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;QACjC,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;YACzB,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,OAAQ,KAAK,CAAC,MAA+B,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,EAC/F,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,4DAA4D,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EAC5F,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,IACE,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC;QACjC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC;QACjC,CAAC,SAAS,CAAC,IAAI,KAAK,WAAW,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,CAAC;QACjE,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,CAAC,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,CAAC,EACtE,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,qEAAqE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa,EAAE,OAAe,EAAE,OAAe;IACpF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,OAAO,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QACvE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,4BAA4B,OAAO,OAAO,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,GAAW,EAAE,SAAiB;IAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,SAAS,CAAC,GAAiB;IAClC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;IACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5E,MAAM,IAAI,SAAS,CAAC,qEAAqE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,YAAoB,EAAE,MAAmB;IACxD,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAChF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,YAAY,CAAC,CAAC;QACjB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAC1B,SAAwB,EACxB,SAAiB,EACjB,MAAmB;IAEnB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,QAAoB,EAAE,EAAE;YACtC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,iCAAiC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/F,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,iCAAiC,CAAC,SAAS,CAAC,CAAC,CAAC,EAC5E,SAAS,CACV,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAC9B,KAAK,SAAS,CAAC,IAAI,CACjB,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EACrB,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CACvC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CACnB,SAA2B,EAC3B,SAAiB;IAEjB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,OAA2C,EAAE,EAAE;YAC7D,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7D,KAAK,SAAS,CAAC,IAAI,CACjB,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EACzB,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CACvB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/oauth-error.d.ts

@@ -0,0 +1,6 @@
+export type McpNativeOAuthErrorCode = "authorization-denied" | "callback-mismatch" | "invalid-callback" | "invalid-configuration" | "invalid-storage" | "resource-mismatch" | "reauthorization-denied" | "state-mismatch";
+export declare class McpNativeOAuthError extends Error {
+    readonly code: McpNativeOAuthErrorCode;
+    constructor(code: McpNativeOAuthErrorCode, message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=oauth-error.d.ts.map

package/dist/oauth-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-error.d.ts","sourceRoot":"","sources":["../src/oauth-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAC/B,sBAAsB,GACtB,mBAAmB,GACnB,kBAAkB,GAClB,uBAAuB,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,wBAAwB,GACxB,gBAAgB,CAAC;AAErB,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IAEvC,YAAY,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAIjF;CACF"}

package/dist/oauth-error.js

@@ -0,0 +1,9 @@
+export class McpNativeOAuthError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "McpNativeOAuthError";
+        this.code = code;
+    }
+}
+//# sourceMappingURL=oauth-error.js.map

package/dist/oauth-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-error.js","sourceRoot":"","sources":["../src/oauth-error.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,CAA0B;IAEvC,YAAY,IAA6B,EAAE,OAAe,EAAE,OAAsB;QAChF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/oauth-native.d.ts

@@ -0,0 +1,66 @@
+import type { OAuthDiscoveryState, StoredOAuthClientInformation, StoredOAuthTokens, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
+import type { McpNativeOAuthClientProvider, McpNativeOAuthCredentialScope, McpNativeOAuthPendingAuthorizationRecord, McpNativeOAuthSecureStore } from "./oauth.js";
+type OAuthFinisher = Pick<StreamableHTTPClientTransport, "finishAuth">;
+/**
+ * Minimal bridge to an app-owned iOS Keychain / Android Keystore-backed module.
+ * Implementations must not use AsyncStorage, plain files, or a remote service.
+ */
+export interface McpNativeOAuthSecretBackend {
+    readonly read: (service: string) => Promise<string | undefined>;
+    readonly write: (service: string, value: string) => Promise<void>;
+    readonly remove: (service: string) => Promise<void>;
+}
+export interface McpNativeOAuthPlatformSecureStoreOptions {
+    /** App-owned, environment-specific identifier. It must never come from an MCP server. */
+    readonly namespace: string;
+    readonly backend: McpNativeOAuthSecretBackend;
+}
+/**
+ * Bounded reference implementation of the OAuth store contract over a native secret backend.
+ * One namespace represents one protected-resource authorization context. State operations are
+ * serialized across store objects using the same fixed namespaced service in this JS runtime,
+ * and a claimed state keeps the reservation exclusive until it is explicitly cleared.
+ */
+export declare class McpNativeOAuthPlatformSecureStore implements McpNativeOAuthSecureStore {
+    #private;
+    constructor(options: McpNativeOAuthPlatformSecureStoreOptions);
+    loadClientInformation(issuer: string): Promise<StoredOAuthClientInformation | undefined>;
+    saveClientInformation(issuer: string, information: StoredOAuthClientInformation): Promise<void>;
+    loadTokens(issuer?: string): Promise<StoredOAuthTokens | undefined>;
+    saveTokens(issuer: string, tokens: StoredOAuthTokens): Promise<void>;
+    loadCodeVerifier(): Promise<string | undefined>;
+    saveCodeVerifier(verifier: string): Promise<void>;
+    loadPendingAuthorization(): Promise<unknown>;
+    savePendingAuthorization(record: McpNativeOAuthPendingAuthorizationRecord): Promise<void>;
+    reserveOAuthState(owner: object): Promise<void>;
+    saveOAuthState(state: string, owner: object): Promise<void>;
+    claimOAuthStateForCleanup(owner: object): Promise<void>;
+    clearOAuthState(owner: object): Promise<void>;
+    consumeOAuthState(state: string, owner: object): Promise<boolean>;
+    loadDiscoveryState(): Promise<OAuthDiscoveryState | undefined>;
+    saveDiscoveryState(state: OAuthDiscoveryState): Promise<void>;
+    invalidate(scope: McpNativeOAuthCredentialScope, issuer?: string): Promise<void>;
+}
+export declare function createMcpNativeOAuthPlatformSecureStore(options: McpNativeOAuthPlatformSecureStoreOptions): McpNativeOAuthPlatformSecureStore;
+export type McpNativeOAuthAuthorizationSessionResult = {
+    readonly type: "cancel" | "dismiss";
+} | {
+    readonly type: "success";
+    readonly url: string;
+};
+export interface McpNativeOAuthAuthorizationSessionOptions {
+    readonly redirectUrl: string | URL;
+    /** Must invoke an OS authentication session, never an embedded application WebView. */
+    readonly open: (authorizationUrl: URL, redirectUrl: URL) => McpNativeOAuthAuthorizationSessionResult | Promise<McpNativeOAuthAuthorizationSessionResult>;
+}
+/** Closed adapter for ASWebAuthenticationSession / Android Custom Tab callback results. */
+export declare class McpNativeOAuthAuthorizationSession {
+    #private;
+    constructor(options: McpNativeOAuthAuthorizationSessionOptions);
+    readonly openAuthorization: (authorizationUrl: URL) => Promise<void>;
+    hasPendingCallback(): boolean;
+    finishAuthorization(provider: McpNativeOAuthClientProvider, finisher: OAuthFinisher): Promise<void>;
+}
+export declare function createMcpNativeOAuthAuthorizationSession(options: McpNativeOAuthAuthorizationSessionOptions): McpNativeOAuthAuthorizationSession;
+export {};
+//# sourceMappingURL=oauth-native.d.ts.map