@framers/agentos-ext-gmail-source 0.3.0 → 0.5.0

package/dist/gmail.js

@@ -0,0 +1,592 @@
+/**
+ * @fileoverview The capped, read-only Gmail API client: profile, labels, a bounded thread list, history pages and one
+ * thread read at fixed `users/me` paths. Every token refresh and every HTTP dispatch is admitted through the host's
+ * shared account-source quota with a new attempt id, and every refresh runs inside the host's grant operation on a
+ * flow built for it alone; given a holder, the clients of one sync lease share one access token. Responses are read
+ * through the released byte cap before decoding, with prompt cancellation, and only fixed failures leave the client.
+ * It never sleeps, retries a transient failure inline, stores, purges, logs, or fetches an attachment.
+ * @module agentos-ext-gmail-source/gmail
+ */
+import { randomUUID } from 'node:crypto';
+import { readCapped, ReadCapExceeded, decideSourceCache, sourceRetryAt, SourceSyncFault, SOURCE_GRANT_KEY, } from '@framers/agentos-ext-account-sources';
+import { GmailOAuthFlow } from './GmailOAuthFlow.js';
+import { GmailThreadMapper } from './mapThread.js';
+import { mappingBounds, gmailId } from './mime.js';
+import { sanitizeMailMetadata } from './mailSanitize.js';
+import { classifyGmailHttp, gmailOAuthFault } from './retry.js';
+/**
+ * A client's fixed refusal; its message is `gmail_api_<reason>`. `configuration` is thrown by the constructor;
+ * `response_too_large` stays inside the client, which answers it as a skipped thread or an invalid control page.
+ */
+export class GmailApiFault extends Error {
+    reason;
+    /** @param reason Why the client refused. */
+    constructor(reason) {
+        super(`gmail_api_${reason}`);
+        this.reason = reason;
+        this.name = 'GmailApiFault';
+    }
+}
+const productionOrigin = 'https://gmail.googleapis.com';
+// The latest epoch millisecond the account-source services accept.
+const maxTime = 8_639_999_913_600_000;
+const integer = (n) => Number.isSafeInteger(n) && n >= 0 && n <= maxTime;
+// An invalid provider shape or argument is a fixed failure, never an empty success.
+const invalid = () => { throw new SourceSyncFault('invalid_response'); };
+const historyId = (value) => typeof value === 'string' && /^[0-9]{1,128}$/.test(value);
+// The lease a held access token belongs to: the connection, its generation and the lease token, which a renewal keeps.
+const leaseKey = (handle) => JSON.stringify([handle.lease.scope.tenantId,
+    handle.lease.scope.ownerId, handle.lease.scope.connectionId, handle.lease.generation, handle.lease.token]);
+const labelId = (value) => typeof value === 'string'
+    && /^(?:[A-Z][A-Z0-9_]{0,63}|Label_[0-9]{1,64})$/.test(value);
+// Orders decimal history ids as strings, by length and then lexically, so no id passes through a float.
+function compareHistory(a, b) {
+    const left = a.replace(/^0+(?=.)/, '');
+    const right = b.replace(/^0+(?=.)/, '');
+    return left.length - right.length || (left < right ? -1 : left > right ? 1 : 0);
+}
+function object(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return invalid();
+    return value;
+}
+function array(value, maximum) {
+    if (!Array.isArray(value) || value.length > maximum)
+        return invalid();
+    return value;
+}
+// Google's origin, or on CI only a loopback or `.invalid` origin with no path, query, fragment or userinfo.
+function selectedOrigin(value) {
+    if (value === undefined)
+        return productionOrigin;
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new GmailApiFault('configuration');
+    }
+    const local = ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname);
+    if (process.env.CI !== 'true' || (!local && !url.hostname.endsWith('.invalid'))
+        || (url.protocol !== 'https:' && !(local && url.protocol === 'http:'))
+        || url.username || url.password || url.pathname !== '/' || url.search || url.hash) {
+        throw new GmailApiFault('configuration');
+    }
+    return url.origin;
+}
+function cancel(response) { void response.body?.cancel().catch(() => { }); }
+function active(signal) { if (signal?.aborted)
+    throw new SourceSyncFault('cancelled'); }
+// Rejects promptly on abort; a response that arrives afterwards is handed to `discard` instead of the caller.
+function abortable(work, signal, stopped, discard) {
+    return new Promise((resolve, reject) => {
+        let done = false;
+        const abort = () => { if (!done) {
+            done = true;
+            reject(stopped());
+        } };
+        signal.addEventListener('abort', abort, { once: true });
+        if (signal.aborted)
+            abort();
+        work.then((value) => {
+            signal.removeEventListener('abort', abort);
+            if (done) {
+                discard?.(value);
+                return;
+            }
+            done = true;
+            resolve(value);
+        }, (error) => {
+            signal.removeEventListener('abort', abort);
+            if (!done) {
+                done = true;
+                reject(error);
+            }
+        });
+    });
+}
+// Reads a body through the released byte cap. The bridge turns an abort into a fixed fault even while no bytes
+// arrive, and passes cancellation through to the provider's stream.
+async function bodyBytes(response, maximum, signal, stopped) {
+    if (signal.aborted) {
+        cancel(response);
+        throw stopped();
+    }
+    if (response.body === null)
+        return new Uint8Array(0);
+    const reader = response.body.getReader();
+    let closed = false;
+    let stop;
+    const bridge = new ReadableStream({
+        start(controller) {
+            stop = () => {
+                if (closed)
+                    return;
+                closed = true;
+                controller.error(stopped());
+                void reader.cancel().catch(() => { });
+            };
+            signal.addEventListener('abort', stop, { once: true });
+            if (signal.aborted)
+                stop();
+        },
+        async pull(controller) {
+            try {
+                const next = await reader.read();
+                if (closed)
+                    return;
+                if (next.done) {
+                    closed = true;
+                    controller.close();
+                }
+                else
+                    controller.enqueue(next.value);
+            }
+            catch {
+                if (!closed) {
+                    closed = true;
+                    controller.error(signal.aborted ? stopped() : new SourceSyncFault('network'));
+                }
+            }
+        },
+        async cancel() { closed = true; try {
+            await reader.cancel();
+        }
+        catch { /* Fixed fault only. */ } },
+    });
+    try {
+        return await readCapped(new Response(bridge, { headers: response.headers }), maximum);
+    }
+    finally {
+        signal.removeEventListener('abort', stop);
+        try {
+            reader.releaseLock();
+        }
+        catch { /* Cancellation can still be settling. */ }
+    }
+}
+/**
+ * The capped, read-only Gmail API client. Each provider operation makes one attempt: one OAuth refresh inside the
+ * host's grant operation, or the access token a `tokenHolder` holds for the current lease, then one HTTP dispatch, each
+ * admitted by the shared quota with a new attempt id; a 401 drops a held token and earns one fresh token and one
+ * repeat of the same call. Provider waits are recorded through the quota's `defer` and thrown as `rate_limited` or
+ * `provider_unavailable` with their time; the durable coordinator owns retry episodes, backoff and exhaustion. Every
+ * failure is a fixed `SourceSyncFault`.
+ *
+ * @typeParam Prepared - The host's prepared-document type of its `SourceRevocations`.
+ */
+export class GmailApi {
+    options;
+    origin;
+    send;
+    bounds;
+    limits;
+    mapper;
+    /**
+     * @param options The client, the host's grant and quota services, the quota keys, the bounds and limits, and the
+     * optional fetch, clock and CI-only endpoints.
+     * @throws {GmailApiFault} `configuration` for an origin override outside CI or not a loopback or `.invalid` origin,
+     * a limit outside its ceiling, or a malformed quota key.
+     * @throws {GmailMappingFault} `configuration` for invalid bounds.
+     */
+    constructor(options) {
+        this.options = options;
+        this.origin = selectedOrigin(options.apiOrigin);
+        this.send = options.fetchImpl ?? fetch;
+        this.bounds = mappingBounds(options.bounds);
+        this.mapper = new GmailThreadMapper(this.bounds);
+        const ceilings = { timeoutMs: 15_000, maxLabels: 1000, maxHistoryReferences: 10_000, maxPageTokenCharacters: 4096 };
+        for (const key of Object.keys(ceilings)) {
+            if (!integer(options.limits[key]) || options.limits[key] < 1 || options.limits[key] > ceilings[key]) {
+                throw new GmailApiFault('configuration');
+            }
+        }
+        this.limits = Object.freeze({ ...options.limits });
+        for (const key of [options.projectKey, options.mailboxKey]) {
+            if (typeof key !== 'string' || !/^[A-Za-z0-9:_-]{1,512}$/.test(key))
+                throw new GmailApiFault('configuration');
+        }
+    }
+    now() {
+        const value = this.options.clock?.() ?? Date.now();
+        if (!integer(value))
+            return invalid();
+        return value;
+    }
+    // A retry time handed back: never at or before this client's clock. The quota's times come from the database's
+    // clock, and the sync store refuses a retry time that is not after its own.
+    later(retryAt) { return Math.max(retryAt, this.now() + 1); }
+    pageToken(value) {
+        if (value === undefined || value === null)
+            return null;
+        if (typeof value !== 'string' || value.length < 1 || value.length > this.limits.maxPageTokenCharacters
+            || /[\x00-\x20\x7f]/.test(value))
+            return invalid();
+        return value;
+    }
+    pageSize(value) { if (!Number.isSafeInteger(value) || value < 1 || value > 100)
+        invalid(); }
+    // Nothing was sent for a deferral or a late start: both are retryable from their time, with a new attempt id. Only
+    // a reused attempt id is a fault.
+    quotaValue(result) {
+        if (result.kind === 'deferred' || result.kind === 'late')
+            throw new SourceSyncFault('rate_limited', this.later(result.retryAt));
+        if (result.kind === 'duplicate')
+            return invalid();
+        return result.value;
+    }
+    async reserve(method, work, parent) {
+        active(parent);
+        const result = await this.options.quota.run({ projectKey: this.options.projectKey,
+            mailboxKey: this.options.mailboxKey, method, attemptId: randomUUID() }, work, parent);
+        active(parent);
+        return this.quotaValue(result);
+    }
+    // Records a provider wait for the mailbox or the whole project, never shorter than the provider's Retry-After, and
+    // at least a day for the provider's daily limit, then throws it.
+    async defer(code, retryAfter, scope, daily) {
+        const now = this.now();
+        const retryAt = Math.max(sourceRetryAt(now, 1, retryAfter, 0), daily ? now + 86_400_000 : 0);
+        await this.options.quota.defer({ projectKey: this.options.projectKey,
+            ...(scope === 'mailbox' ? { mailboxKey: this.options.mailboxKey } : {}) }, retryAt);
+        throw new SourceSyncFault(code, this.later(retryAt));
+    }
+    // A fresh access token from a flow built inside the grant operation and discarded with it, or the token held for
+    // the current lease. OAuth failures are translated inside the operation, whose boundary would turn an unknown error
+    // into a storage failure.
+    async accessToken(parent) {
+        active(parent);
+        const handle = this.options.currentHandle();
+        const lease = leaseKey(handle);
+        const holder = this.options.tokenHolder;
+        const held = holder?.current ?? null;
+        if (holder && held) {
+            if (held.lease === lease && handle.lease.expiresAt > this.now())
+                return held.value;
+            holder.current = null;
+        }
+        const token = await this.options.revocations.withGrant(handle, async (tokens, grantSignal) => {
+            return this.reserve('profile', async (requestSignal) => {
+                let retryAfter = null;
+                const observedFetch = async (input, init) => {
+                    const response = await this.send(input, init);
+                    retryAfter = response.headers.get('retry-after');
+                    return response;
+                };
+                try {
+                    const flow = new GmailOAuthFlow(this.options.client, tokens, {
+                        signal: requestSignal, fetchImpl: observedFetch, endpoints: this.options.oauthEndpoints,
+                    });
+                    return await flow.accessToken(SOURCE_GRANT_KEY);
+                }
+                catch (error) {
+                    // A flow stopped by the quota's or the grant's own deadline, not by the caller, was a network failure.
+                    const translated = gmailOAuthFault(error);
+                    const fault = translated.code === 'cancelled' && !parent?.aborted ? new SourceSyncFault('network') : translated;
+                    if (fault.code === 'rate_limited' || fault.code === 'provider_unavailable') {
+                        return this.defer(fault.code, retryAfter, 'mailbox', false);
+                    }
+                    throw fault;
+                }
+            }, grantSignal);
+        }, parent).catch((error) => {
+            // A grant lease that another worker holds answers its expiry, which can pass before this caller reads it.
+            if (error instanceof SourceSyncFault && error.retryAt !== null)
+                throw new SourceSyncFault(error.code, this.later(error.retryAt));
+            throw error;
+        });
+        if (holder)
+            holder.current = { lease, value: token };
+        return token;
+    }
+    // A 401 ends a held token's use: this operation's repeat, or the next operation, refreshes the grant.
+    dropToken(token) {
+        const holder = this.options.tokenHolder;
+        if (holder && holder.current !== null && holder.current.value === token)
+            holder.current = null;
+    }
+    /** Consume/cancel the whole body within the quota callback, before releasing its slot. */
+    async wire(url, token, quotaSignal, parent) {
+        const controller = new AbortController();
+        let timedOut = false;
+        const abort = () => controller.abort();
+        const stopped = () => new SourceSyncFault(parent?.aborted ? 'cancelled' : 'network');
+        quotaSignal.addEventListener('abort', abort, { once: true });
+        parent?.addEventListener('abort', abort, { once: true });
+        if (quotaSignal.aborted || parent?.aborted)
+            abort();
+        const timer = setTimeout(() => { timedOut = true; controller.abort(); }, this.limits.timeoutMs);
+        try {
+            if (controller.signal.aborted)
+                throw stopped();
+            const readStartedAt = this.now();
+            const response = await abortable(this.send(url, { method: 'GET',
+                headers: { accept: 'application/json', authorization: 'Bearer ' + token },
+                redirect: 'error', credentials: 'omit', cache: 'no-store', referrerPolicy: 'no-referrer', signal: controller.signal,
+            }), controller.signal, stopped, cancel);
+            if (controller.signal.aborted) {
+                cancel(response);
+                throw stopped();
+            }
+            if (response.status < 200 || response.status >= 600 || (response.status >= 300 && response.status < 400)) {
+                cancel(response);
+                return invalid();
+            }
+            let bytes;
+            try {
+                bytes = await bodyBytes(response, this.bounds.maxResponseBytes, controller.signal, stopped);
+            }
+            catch (error) {
+                // Only a successful answer can be too large to use; an oversized failure is classified by its status alone.
+                if (error instanceof ReadCapExceeded) {
+                    if (response.status === 200)
+                        throw new GmailApiFault('response_too_large');
+                    bytes = new Uint8Array(0);
+                }
+                else
+                    throw error;
+            }
+            if (controller.signal.aborted)
+                throw stopped();
+            const receivedAt = this.now();
+            if (receivedAt < readStartedAt)
+                return invalid();
+            let body = null;
+            try {
+                body = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
+            }
+            catch {
+                if (response.status === 200)
+                    return invalid();
+            }
+            return { status: response.status, body, readStartedAt, receivedAt,
+                retryAfter: response.headers.get('retry-after'), cacheHeaders: {
+                    cacheControl: response.headers.get('cache-control'), date: response.headers.get('date'),
+                    age: response.headers.get('age'), expires: response.headers.get('expires'),
+                } };
+        }
+        catch (error) {
+            if (parent?.aborted || timedOut || controller.signal.aborted)
+                throw stopped();
+            if (error instanceof SourceSyncFault || error instanceof GmailApiFault)
+                throw error;
+            throw new SourceSyncFault('network');
+        }
+        finally {
+            clearTimeout(timer);
+            quotaSignal.removeEventListener('abort', abort);
+            parent?.removeEventListener('abort', abort);
+        }
+    }
+    // One provider operation at a fixed path: a fresh token, one metered dispatch, and one repeat after a 401.
+    async request(method, path, query, signal) {
+        active(signal);
+        const expected = method === 'profile' ? 'profile' : method === 'labels' ? 'labels'
+            : method === 'list' ? 'threads' : method === 'changes' ? 'history' : null;
+        if ((expected !== null && path !== expected) || (expected === null && !/^threads\/[a-fA-F0-9]{1,64}$/.test(path)))
+            return invalid();
+        const url = new URL('/gmail/v1/users/me/' + path, this.origin);
+        for (const [key, value] of Object.entries(query))
+            url.searchParams.set(key, value);
+        for (let authAttempt = 0; authAttempt < 2; authAttempt++) {
+            const token = await this.accessToken(signal);
+            active(signal);
+            const response = await this.reserve(method, (quotaSignal) => this.wire(url, token, quotaSignal, signal), signal);
+            const disposition = classifyGmailHttp(response.status, response.body, method);
+            if (disposition.kind === 'ok')
+                return response;
+            if (disposition.kind === 'gone')
+                return null;
+            if (disposition.kind === 'refresh') {
+                this.dropToken(token);
+                if (authAttempt === 0)
+                    continue;
+                throw new SourceSyncFault('grant_rejected');
+            }
+            if (disposition.kind === 'fault')
+                throw new SourceSyncFault(disposition.code);
+            if (disposition.kind === 'retry')
+                return this.defer(disposition.code, response.retryAfter, disposition.scope, disposition.daily);
+        }
+        return invalid();
+    }
+    // A control page: an absent or oversized answer fails without a partial page or a cursor advance.
+    async control(method, path, query, signal) {
+        try {
+            const result = await this.request(method, path, query, signal);
+            if (result === null)
+                return invalid();
+            return result;
+        }
+        catch (error) {
+            if (error instanceof GmailApiFault && error.reason === 'response_too_large')
+                return invalid();
+            throw error;
+        }
+    }
+    /**
+     * The mailbox address and current history id, for the host's private account binding and its history anchor. The
+     * answer's other fields are dropped.
+     *
+     * @param signal Cancels the call.
+     * @throws {SourceSyncFault} A fixed failure, `invalid_response` for a malformed answer.
+     */
+    async profile(signal) {
+        const response = await this.control('profile', 'profile', {}, signal);
+        const body = object(response.body);
+        if (typeof body.emailAddress !== 'string' || body.emailAddress.length > 320
+            || !/^[^\s@<>]+@[^\s@<>]+$/.test(body.emailAddress) || !historyId(body.historyId))
+            return invalid();
+        return { emailAddress: body.emailAddress, historyId: body.historyId };
+    }
+    /**
+     * The mailbox's labels: sanitized names by id under the labels response's own cache decision. A refused decision
+     * keeps no names.
+     *
+     * @param permission The host's evidenced cache permission; null refuses the names.
+     * @param signal Cancels the call.
+     * @throws {SourceSyncFault} A fixed failure, `invalid_response` for a malformed or oversized list.
+     */
+    async labels(permission, signal) {
+        const response = await this.control('labels', 'labels', {}, signal);
+        const body = object(response.body);
+        const entries = array(body.labels === undefined ? [] : body.labels, this.limits.maxLabels);
+        const cache = decideSourceCache({ permission, maximumCacheMs: this.bounds.maximumCacheMs,
+            readStartedAt: response.readStartedAt, receivedAt: response.receivedAt,
+            windowExpiresAt: response.readStartedAt + this.bounds.maximumCacheMs, headers: response.cacheHeaders });
+        const names = Object.create(null);
+        const seen = new Set();
+        for (const entry of entries) {
+            const row = object(entry);
+            if (!labelId(row.id) || seen.has(row.id) || typeof row.name !== 'string'
+                || row.name.length > this.bounds.maxInputCharacters)
+                return invalid();
+            seen.add(row.id);
+            if (cache.kind === 'cache')
+                names[row.id] = sanitizeMailMetadata(row.name, {
+                    maxInputCharacters: this.bounds.maxInputCharacters, maxLineCharacters: this.bounds.maxLineCharacters,
+                    maxOutputCharacters: Math.min(200, this.bounds.maxInputCharacters),
+                }).text;
+        }
+        active(signal);
+        return { names: Object.freeze(names), cache };
+    }
+    /**
+     * One page of candidate thread ids between `cutoff - windowMs` and `cutoff`, outside spam, trash and drafts. The
+     * query's whole-second bounds are widened by a second each way; the mapper enforces the exact window. Snippets and
+     * estimates are dropped, and no mailbox-wide completeness is claimed.
+     *
+     * @param cutoff The selection cutoff in epoch milliseconds.
+     * @param windowMs The window, from 1 millisecond to 90 days.
+     * @param pageSize Candidates per page, from 1 to 100.
+     * @param pageToken The resume token from the previous page, or null for the first.
+     * @param signal Cancels the call.
+     * @throws {SourceSyncFault} A fixed failure, `invalid_response` for bad arguments, a malformed page or a repeated
+     * page token.
+     */
+    async list(cutoff, windowMs, pageSize, pageToken, signal) {
+        this.pageSize(pageSize);
+        const token = this.pageToken(pageToken);
+        if (!integer(cutoff) || !integer(windowMs) || windowMs < 1 || windowMs > 90 * 86_400_000)
+            return invalid();
+        const after = Math.max(0, Math.floor((cutoff - windowMs) / 1000) - 1);
+        const before = Math.floor(cutoff / 1000) + 1;
+        const response = await this.control('list', 'threads', { maxResults: String(pageSize), includeSpamTrash: 'false',
+            q: `after:${after} before:${before} -in:spam -in:trash -in:drafts`,
+            ...(token === null ? {} : { pageToken: token }),
+        }, signal);
+        const body = object(response.body);
+        const entries = array(body.threads === undefined ? [] : body.threads, pageSize);
+        const ids = entries.map((entry) => { const id = object(entry).id; if (!gmailId(id))
+            return invalid(); return id; });
+        const nextPageToken = this.pageToken(body.nextPageToken);
+        if (nextPageToken !== null && nextPageToken === token)
+            return invalid();
+        return { kind: 'scan', ids, nextPageToken };
+    }
+    /**
+     * One page of history after `fromCursor`: the thread ids of every message addition, deletion and label change, and
+     * of generic message entries, deduplicated and sorted, with the page's decimal-string cursor. The host persists the
+     * pending work and commits a terminal cursor only once every item is terminal.
+     *
+     * @param fromCursor The committed history id, a decimal string.
+     * @param pageSize Records per page, from 1 to 100.
+     * @param pageToken The resume token from the previous page, or null for the first.
+     * @param signal Cancels the call.
+     * @throws {SourceSyncFault} `history_expired` when Google no longer holds the anchor; `invalid_response` for bad
+     * arguments, a malformed or out-of-order page, too many references or a repeated page token; another fixed failure.
+     */
+    async history(fromCursor, pageSize, pageToken, signal) {
+        this.pageSize(pageSize);
+        const token = this.pageToken(pageToken);
+        if (!historyId(fromCursor))
+            return invalid();
+        const response = await this.control('changes', 'history', { startHistoryId: fromCursor, maxResults: String(pageSize),
+            ...(token === null ? {} : { pageToken: token }),
+        }, signal);
+        const body = object(response.body);
+        if (!historyId(body.historyId) || compareHistory(body.historyId, fromCursor) < 0)
+            return invalid();
+        const records = array(body.history === undefined ? [] : body.history, pageSize);
+        const ids = new Set();
+        let references = 0;
+        let previous = fromCursor;
+        const changed = (value) => {
+            if (++references > this.limits.maxHistoryReferences)
+                return invalid();
+            const message = object(value);
+            if (!gmailId(message.id) || !gmailId(message.threadId))
+                return invalid();
+            ids.add(message.threadId);
+        };
+        for (const value of records) {
+            const entry = object(value);
+            if (!historyId(entry.id) || compareHistory(entry.id, fromCursor) <= 0
+                || compareHistory(entry.id, previous) < 0 || compareHistory(entry.id, body.historyId) > 0)
+                return invalid();
+            previous = entry.id;
+            for (const field of ['messages', 'messagesAdded', 'messagesDeleted', 'labelsAdded', 'labelsRemoved']) {
+                const events = array(entry[field] === undefined ? [] : entry[field], this.limits.maxHistoryReferences - references);
+                for (const event of events)
+                    changed(field === 'messages' ? event : object(event).message);
+            }
+        }
+        const nextPageToken = this.pageToken(body.nextPageToken);
+        if (nextPageToken !== null && nextPageToken === token)
+            return invalid();
+        return { kind: 'history', ids: [...ids].sort(), nextPageToken, cursor: body.historyId };
+    }
+    /**
+     * Reads one thread in the `full` format and maps it with its own read times and cache headers and the separate
+     * label snapshot. A 404 is `gone`; an oversized successful answer is skipped as `response_too_large`; any other
+     * result is the mapper's. The raw response never leaves the client.
+     *
+     * @param sourceId The thread id, 1 to 64 hexadecimal characters.
+     * @param options The cutoff, window, detail path, cache permission, label snapshot and signal.
+     * @throws {SourceSyncFault} A fixed failure, `invalid_response` for a malformed id.
+     */
+    async readThread(sourceId, options) {
+        if (!gmailId(sourceId))
+            return invalid();
+        active(options.signal);
+        let response;
+        try {
+            response = await this.request('read', 'threads/' + sourceId, { format: 'full' }, options.signal);
+        }
+        catch (error) {
+            if (error instanceof GmailApiFault && error.reason === 'response_too_large') {
+                return { kind: 'skipped', id: sourceId, reason: 'response_too_large' };
+            }
+            throw error;
+        }
+        if (response === null)
+            return { kind: 'gone', id: sourceId };
+        return this.mapper.map(response.body, {
+            sourceId, sourceDetailUrl: options.sourceDetailUrl, cutoff: options.cutoff, windowMs: options.windowMs,
+            readStartedAt: response.readStartedAt, receivedAt: response.receivedAt,
+            permission: options.permission, cacheHeaders: response.cacheHeaders,
+            labelNames: options.labels?.names ?? {}, labelCache: options.labels?.cache ?? null, signal: options.signal,
+        });
+    }
+}
+//# sourceMappingURL=gmail.js.map

package/dist/gmail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.js","sourceRoot":"","sources":["../src/gmail.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,GAIjG,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,OAAO,EAA2B,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgGhE;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEjB;IADrB,4CAA4C;IAC5C,YAAqB,MAA8C;QACjE,KAAK,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;QADV,WAAM,GAAN,MAAM,CAAwC;QACnC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC5D,CAAC;CACF;AAUD,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AACxD,mEAAmE;AACnE,MAAM,OAAO,GAAG,qBAAqB,CAAC;AACtC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;AAC1F,oFAAoF;AACpF,MAAM,OAAO,GAAG,GAAU,EAAE,GAAG,MAAM,IAAI,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,MAAM,SAAS,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjH,uHAAuH;AACvH,MAAM,QAAQ,GAAG,CAAC,MAAwB,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ;IAChG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7G,MAAM,OAAO,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ;OACzE,8CAA8C,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChE,wGAAwG;AACxG,SAAS,cAAc,CAAC,CAAS,EAAE,CAAS;IAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAAC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AACD,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,EAAE,CAAC;IAClF,OAAO,KAAgC,CAAC;AAC1C,CAAC;AACD,SAAS,KAAK,CAAC,KAAc,EAAE,OAAe;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,OAAO;QAAE,OAAO,OAAO,EAAE,CAAC;IACtE,OAAO,KAAK,CAAC;AACf,CAAC;AACD,4GAA4G;AAC5G,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,gBAAgB,CAAC;IACjD,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;IAAC,CAAC;IACjF,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;WAC1E,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;WACnE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACpF,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC;AACD,SAAS,MAAM,CAAC,QAAkB,IAAU,KAAK,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3F,SAAS,MAAM,CAAC,MAAoB,IAAU,IAAI,MAAM,EAAE,OAAO;IAAE,MAAM,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAC5G,8GAA8G;AAC9G,SAAS,SAAS,CAAI,IAAgB,EAAE,MAAmB,EAAE,OAA8B,EACzF,OAA4B;IAC5B,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,MAAM,KAAK,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,IAAI,GAAG,IAAI,CAAC;YAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,IAAI,EAAE,CAAC;gBAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACvC,IAAI,GAAG,IAAI,CAAC;YAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC,EAAE,CAAC,KAAc,EAAE,EAAE;YACpB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAC,IAAI,GAAG,IAAI,CAAC;gBAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AACD,+GAA+G;AAC/G,oEAAoE;AACpE,KAAK,UAAU,SAAS,CAAC,QAAkB,EAAE,OAAe,EAAE,MAAmB,EAC/E,OAA8B;IAC9B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAAC,MAAM,OAAO,EAAE,CAAC;IAAC,CAAC;IAC1D,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IAAC,IAAI,MAAM,GAAG,KAAK,CAAC;IAAC,IAAI,IAAiB,CAAC;IACpF,MAAM,MAAM,GAAG,IAAI,cAAc,CAAa;QAC5C,KAAK,CAAC,UAAU;YACd,IAAI,GAAG,GAAG,EAAE;gBACV,IAAI,MAAM;oBAAE,OAAO;gBACnB,MAAM,GAAG,IAAI,CAAC;gBAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAAC,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnF,CAAC,CAAC;YACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,IAAI,MAAM,CAAC,OAAO;gBAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,UAAU;YACnB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjC,IAAI,MAAM;oBAAE,OAAO;gBACnB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBAAC,MAAM,GAAG,IAAI,CAAC;oBAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC;;oBAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5F,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,MAAM,EAAE,CAAC;oBAAC,MAAM,GAAG,IAAI,CAAC;oBAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;gBAAC,CAAC;YAChH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC;YAAC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;KACnG,CAAC,CAAC;IACH,IAAI,CAAC;QAAC,OAAO,MAAM,UAAU,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAAC,CAAC;YACtF,CAAC;QAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAAC,IAAI,CAAC;YAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,yCAAyC,CAAC,CAAC;IAAC,CAAC;AAC1I,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,QAAQ;IAaU;IAZZ,MAAM,CAAS;IACf,IAAI,CAAe;IACnB,MAAM,CAAqB;IAC3B,MAAM,CAAiB;IACvB,MAAM,CAAoB;IAC3C;;;;;;OAMG;IACH,YAA6B,OAAkC;QAAlC,YAAO,GAAP,OAAO,CAA2B;QAC7D,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAAC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QACxF,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9F,MAAM,QAAQ,GAAmB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC;QACpI,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAA6B,EAAE,CAAC;YACpE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpG,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;QAChH,CAAC;IACH,CAAC;IACO,GAAG;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,EAAE,CAAC;QAAC,OAAO,KAAK,CAAC;IAC1G,CAAC;IACD,+GAA+G;IAC/G,4EAA4E;IACpE,KAAK,CAAC,OAAe,IAAY,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,SAAS,CAAC,KAAc;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,sBAAsB;eACjG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IACO,QAAQ,CAAC,KAAa,IAAU,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAClH,mHAAmH;IACnH,kCAAkC;IAC1B,UAAU,CAAI,MAA4B;QAChD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;YAAE,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAChI,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,OAAO,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACO,KAAK,CAAC,OAAO,CAAI,MAAyB,EAAE,IAAyC,EAAE,MAAoB;QACjH,MAAM,CAAC,MAAM,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC/E,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IACD,mHAAmH;IACnH,iEAAiE;IACzD,KAAK,CAAC,KAAK,CAAC,IAA6C,EAAE,UAAyB,EAC1F,KAA4B,EAAE,KAAc;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7F,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAClE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACtF,MAAM,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,iHAAiH;IACjH,oHAAoH;IACpH,0BAA0B;IAClB,KAAK,CAAC,WAAW,CAAC,MAAoB;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAAC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAAC,MAAM,IAAI,GAAG,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;QAC9E,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC;YACnF,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;YAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;gBACrD,IAAI,UAAU,GAAkB,IAAI,CAAC;gBACrC,MAAM,aAAa,GAAiB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;oBACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;oBAC9C,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;oBACjD,OAAO,QAAQ,CAAC;gBAClB,CAAC,CAAC;gBACF,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE;wBAC3D,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;qBACxF,CAAC,CAAC;oBACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;gBAClD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,uGAAuG;oBACvG,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;oBAAC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;oBAC3J,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;wBAC3E,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;oBAC9D,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC,EAAE,WAAW,CAAC,CAAC;QAClB,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAS,EAAE;YACzC,0GAA0G;YAC1G,IAAI,KAAK,YAAY,eAAe,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;gBAAE,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACjI,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,MAAM;YAAE,MAAM,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,sGAAsG;IAC9F,SAAS,CAAC,KAAa;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACxC,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,KAAK;YAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACjG,CAAC;IACD,0FAA0F;IAClF,KAAK,CAAC,IAAI,CAAC,GAAQ,EAAE,KAAa,EAAE,WAAwB,EAAE,MAAoB;QACxF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QAAC,IAAI,QAAQ,GAAG,KAAK,CAAC;QAC/D,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACrF,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,WAAW,CAAC,OAAO,IAAI,MAAM,EAAE,OAAO;YAAE,KAAK,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChG,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,OAAO,EAAE,CAAC;YAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK;gBAC7D,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,GAAG,KAAK,EAAE;gBACzE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM;aACpH,CAAC,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACxC,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAAC,MAAM,OAAO,EAAE,CAAC;YAAC,CAAC;YACrE,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC;gBACzG,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAAC,OAAO,OAAO,EAAE,CAAC;YACrC,CAAC;YACD,IAAI,KAAiB,CAAC;YACtB,IAAI,CAAC;gBAAC,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAAC,CAAC;YACpG,OAAO,KAAK,EAAE,CAAC;gBACb,4GAA4G;gBAC5G,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;oBACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;wBAAE,MAAM,IAAI,aAAa,CAAC,oBAAoB,CAAC,CAAC;oBAC3E,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC5B,CAAC;;oBAAM,MAAM,KAAK,CAAC;YACrB,CAAC;YACD,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,OAAO,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,IAAI,UAAU,GAAG,aAAa;gBAAE,OAAO,OAAO,EAAE,CAAC;YAChF,IAAI,IAAI,GAAY,IAAI,CAAC;YACzB,IAAI,CAAC;gBAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAAC,CAAC;YACnF,MAAM,CAAC;gBAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;oBAAE,OAAO,OAAO,EAAE,CAAC;YAAC,CAAC;YACxD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU;gBAC/D,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,YAAY,EAAE;oBAC7D,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;oBACvF,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;iBAC3E,EAAE,CAAC;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,MAAM,EAAE,OAAO,IAAI,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,OAAO,EAAE,CAAC;YAC9E,IAAI,KAAK,YAAY,eAAe,IAAI,KAAK,YAAY,aAAa;gBAAE,MAAM,KAAK,CAAC;YACpF,MAAM,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;YAAC,WAAW,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IACD,2GAA2G;IACnG,KAAK,CAAC,OAAO,CAAC,MAAyB,EAAE,IAAY,EAC3D,KAAuC,EAAE,MAAoB;QAC7D,MAAM,CAAC,MAAM,CAAC,CAAC;QACf,MAAM,QAAQ,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ;YAChF,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,OAAO,EAAE,CAAC;QACpI,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,qBAAqB,GAAG,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnF,KAAK,IAAI,WAAW,GAAG,CAAC,EAAE,WAAW,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;YACjH,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC9E,IAAI,WAAW,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,QAAQ,CAAC;YAC/C,IAAI,WAAW,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC;YAC7C,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACnC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACtB,IAAI,WAAW,KAAK,CAAC;oBAAE,SAAS;gBAChC,MAAM,IAAI,eAAe,CAAC,gBAAgB,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,WAAW,CAAC,IAAI,KAAK,OAAO;gBAAE,MAAM,IAAI,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC9E,IAAI,WAAW,CAAC,IAAI,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAClE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IACD,kGAAkG;IAC1F,KAAK,CAAC,OAAO,CAAC,MAA0C,EAAE,IAAY,EAC5E,KAAuC,EAAE,MAAoB;QAC7D,IAAI,CAAC;YAAC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAAC,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,OAAO,EAAE,CAAC;YAAC,OAAO,MAAM,CAAC;QAAC,CAAC;QAC7H,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,MAAM,KAAK,oBAAoB;gBAAE,OAAO,OAAO,EAAE,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;IAC/H,CAAC;IACD;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,MAAoB;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,GAAG;eACtE,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,OAAO,OAAO,EAAE,CAAC;QACtG,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACxE,CAAC;IACD;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,UAAwC,EAAE,MAAoB;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3F,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YACtF,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU;YACtE,eAAe,EAAE,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;QAC1G,MAAM,KAAK,GAA2B,MAAM,CAAC,MAAM,CAAC,IAAI,CAA2B,CAAC;QACpF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;mBACnE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB;gBAAE,OAAO,OAAO,EAAE,CAAC;YACxE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjB,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;gBAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE;oBACzE,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;oBACpG,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;iBACnE,CAAC,CAAC,IAAI,CAAC;QACV,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;IAChD,CAAC;IACD;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,QAAgB,EAAE,QAAgB,EAC3D,SAAwB,EAAE,MAAoB;QAC9C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAAC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,EAAE,GAAG,UAAU;YAAE,OAAO,OAAO,EAAE,CAAC;QAC3G,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,gBAAgB,EAAE,OAAO;YAC9G,CAAC,EAAE,SAAS,KAAK,WAAW,MAAM,gCAAgC;YAClE,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;SAChD,EAAE,MAAM,CAAC,CAAC;QACX,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAAE,OAAO,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACpH,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,KAAK;YAAE,OAAO,OAAO,EAAE,CAAC;QACxE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;IAC9C,CAAC;IACD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,QAAgB,EAAE,SAAwB,EAC1E,MAAoB;QACpB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAAC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;YAAE,OAAO,OAAO,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC;YAClH,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;SAChD,EAAE,MAAM,CAAC,CAAC;QACX,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,EAAE,CAAC;QACnG,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAAC,IAAI,UAAU,GAAG,CAAC,CAAC;QAAC,IAAI,QAAQ,GAAG,UAAU,CAAC;QAC7E,MAAM,OAAO,GAAG,CAAC,KAAc,EAAQ,EAAE;YACvC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB;gBAAE,OAAO,OAAO,EAAE,CAAC;YACtE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAAE,OAAO,OAAO,EAAE,CAAC;YACzE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC;mBAChE,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;gBAAE,OAAO,OAAO,EAAE,CAAC;YAC9G,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,CAAU,EAAE,CAAC;gBAC9G,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB,GAAG,UAAU,CAAC,CAAC;gBACpH,KAAK,MAAM,KAAK,IAAI,MAAM;oBAAE,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,KAAK;YAAE,OAAO,OAAO,EAAE,CAAC;QACxE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1F,CAAC;IACD;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,OAAyB;QAC1D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO,OAAO,EAAE,CAAC;QACzC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,QAA4B,CAAC;QACjC,IAAI,CAAC;YAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC;QACzG,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,MAAM,KAAK,oBAAoB,EAAE,CAAC;gBAC5E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;YACzE,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE;YACpC,QAAQ,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ;YACtG,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU;YACtE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM;SAC3G,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/index.d.ts

@@ -2,8 +2,11 @@
  * @fileoverview A read-only Gmail source's grant: Google's read-only scope on the AgentOS redirect OAuth flow and
  * sealed-token store, with capped, cancellable OAuth calls and fixed failures; its text helpers: bounded
  * pre-storage sanitization of mail text, allow-listed headers and metadata, and conservative trimming of reply history
- * and signatures; and its thread mapper: bounded MIME reading of one thread into a sanitized account-source document
- * with message provenance, attachment listings and an explicit cache decision.
+ * and signatures; its thread mapper: bounded MIME reading of one thread into a sanitized account-source document
+ * with message provenance, attachment listings and an explicit cache decision; its read-only API client: capped
+ * profile, label, list, history and thread calls through the host's grant and quota services, with fixed failures;
+ * and its connector: the bounded selected-id account-source interface and the resumable sync provider, with private
+ * mailbox verification, composed with the released durable coordinator and a one-time identity probe.
  * @module agentos-ext-gmail-source
  */
 export { GmailOAuthFlow } from './GmailOAuthFlow.js';
@@ -12,4 +15,8 @@ export { GmailTextFault, sanitizeMailText, sanitizeMailMetadata, sanitizeMailHea
 export { messageText, type GmailMessageText } from './messageText.js';
 export { GmailThreadMapper, type GmailMapThreadOptions } from './mapThread.js';
 export { GmailMappingFault, type GmailMappingBounds } from './mime.js';
+export { GmailApi, GmailApiFault, type GmailApiOptions, type GmailApiLimits, type GmailProfile, type GmailLabels, type GmailReadOptions, type GmailTokenHolder, } from './gmail.js';
+export { classifyGmailHttp, gmailOAuthFault, type GmailHttpDisposition } from './retry.js';
+export { GmailSourceConnector, GmailConnectorFault, type GmailMailboxBinding, type GmailSourceConnectorOptions, } from './GmailSourceConnector.js';
+export { runGmailSourceSync, verifyGmailSource, type GmailSourceRunOptions, type GmailSourceVerification, } from './sync.js';
 //# sourceMappingURL=index.d.ts.map