@awiki/dsh-plugin 0.3.7-dsh-test.20260831.2 → 0.3.10

package/lib/types/integration-client.js

@@ -0,0 +1,233 @@
+/** Host-only fixed-scope client for Guest Integration management. */
+import { AwikiExternalHttpAuthError, } from "./external-http-auth.js";
+const MAX_REQUEST_BYTES = 64 * 1024;
+const MAX_RESPONSE_BYTES = 1024 * 1024;
+const REQUEST_TIMEOUT_MS = 10_000;
+const INTEGRATION_STATUSES = ['active', 'closed'];
+const TARGET_AVAILABILITIES = [
+    'eligible',
+    'group_not_found',
+    'owner_not_active',
+    'owner_mismatch',
+    'not_open_join',
+    'unsupported_security_profile',
+    'member_send_disabled',
+    'attachments_disabled',
+    'group_full',
+    'validation_unavailable',
+];
+const OPERATIONS = {
+    read: { method: 'GET', path: '/guest/api/v1/management/integration' },
+    create: { method: 'POST', path: '/guest/api/v1/management/integration' },
+    update: { method: 'PATCH', path: '/guest/api/v1/management/integration' },
+    rotate: { method: 'POST', path: '/guest/api/v1/management/integration/rotate-id' },
+    close: { method: 'POST', path: '/guest/api/v1/management/integration/close' },
+    reopen: { method: 'POST', path: '/guest/api/v1/management/integration/reopen' },
+};
+/** Browser-safe management input translated to the Gateway's snake-case contract. */
+function fields(request) {
+    return {
+        product_name: request.productName,
+        description: request.description,
+        contact_enabled: request.contactEnabled,
+        contact_description: request.contactDescription,
+        group_targets: request.groupTargets.map(target => ({
+            ...target.id === undefined ? {} : { id: target.id },
+            group_did: target.groupDid,
+            description: target.description,
+        })),
+    };
+}
+function view(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        throw new TypeError('invalid Integration response');
+    const value = raw;
+    const owner = value.owner;
+    const groups = value.group_targets;
+    if (typeof owner !== 'object' || owner === null || !Array.isArray(groups)) {
+        throw new TypeError('invalid Integration response');
+    }
+    return {
+        id: requiredString(value.id),
+        publicId: nullableString(value.public_id),
+        integrationUrl: nullableString(value.integration_url),
+        owner: {
+            tenantId: requiredString(owner.tenant_id),
+            handle: requiredString(owner.handle),
+            currentDid: requiredString(owner.current_did),
+            displayName: requiredString(owner.display_name),
+        },
+        productName: requiredString(value.product_name),
+        description: requiredString(value.description),
+        contactEnabled: requiredBoolean(value.contact_enabled),
+        contactDescription: requiredString(value.contact_description),
+        groupTargets: groups.map(group => {
+            if (typeof group !== 'object' || group === null)
+                throw new TypeError('invalid Integration group');
+            const target = group;
+            return {
+                id: requiredString(target.id),
+                groupDid: requiredString(target.group_did),
+                displayName: requiredString(target.display_name),
+                avatarUrl: nullableString(target.avatar_url),
+                description: requiredString(target.description),
+                availability: requiredEnum(target.availability, TARGET_AVAILABILITIES),
+            };
+        }),
+        status: requiredEnum(value.status, INTEGRATION_STATUSES),
+        revision: requiredInteger(value.revision),
+    };
+}
+function requiredString(value) {
+    if (typeof value !== 'string')
+        throw new TypeError('invalid Integration response');
+    return value;
+}
+function nullableString(value) {
+    if (value === null)
+        return null;
+    return requiredString(value);
+}
+function requiredBoolean(value) {
+    if (typeof value !== 'boolean')
+        throw new TypeError('invalid Integration response');
+    return value;
+}
+function requiredInteger(value) {
+    if (!Number.isSafeInteger(value))
+        throw new TypeError('invalid Integration response');
+    return value;
+}
+function requiredEnum(value, allowed) {
+    if (typeof value !== 'string' || !allowed.includes(value)) {
+        throw new TypeError('invalid Integration response');
+    }
+    return value;
+}
+function failure(status, raw) {
+    const body = typeof raw === 'object' && raw !== null ? raw : {};
+    const nested = typeof body.error === 'object' && body.error !== null
+        ? body.error
+        : body;
+    const candidate = typeof nested.code === 'string' ? nested.code : '';
+    const code = status === 404 ? 'not-found'
+        : status === 409 ? 'conflict'
+            : status === 400 ? 'invalid-request'
+                : status === 401 ? 'unauthorized'
+                    : status === 403 ? 'forbidden'
+                        : status === 429 ? 'rate-limited'
+                            : status >= 500 ? 'unavailable'
+                                : ['not-found', 'conflict', 'invalid-request', 'forbidden', 'unauthorized', 'rate-limited', 'unavailable'].includes(candidate)
+                                    ? candidate
+                                    : 'remote';
+    return { code, message: integrationFailureMessage(code) };
+}
+function integrationFailureMessage(code) {
+    switch (code) {
+        case 'not-found': return '尚未创建 Integration。';
+        case 'conflict': return 'Integration 已在其他位置更新，请重新加载后再试。';
+        case 'invalid-request': return 'Integration 信息不完整或格式不正确。';
+        case 'forbidden': return '当前 AWiki 身份无权管理这个 Integration。';
+        case 'unauthorized': return '请先在 AWiki 正式版中登录。';
+        case 'rate-limited': return '操作过于频繁，请稍后重试。';
+        case 'unavailable': return '临时消息服务暂时不可用。';
+        case 'network': return '无法连接临时消息服务。';
+        default: return '临时消息服务返回了无法识别的结果。';
+    }
+}
+async function readBounded(response) {
+    const reader = response.body?.getReader();
+    if (reader === undefined)
+        return null;
+    const chunks = [];
+    let size = 0;
+    try {
+        while (true) {
+            const result = await reader.read();
+            if (result.done)
+                break;
+            size += result.value.byteLength;
+            if (size > MAX_RESPONSE_BYTES)
+                throw new TypeError('Integration response too large');
+            chunks.push(result.value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const bytes = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    if (bytes.length === 0)
+        return null;
+    return JSON.parse(new TextDecoder().decode(bytes));
+}
+/** Fixed-origin client; callers cannot control path, method, headers, or transport. */
+export class AwikiIntegrationClient {
+    origin;
+    auth;
+    constructor(origin, auth) {
+        this.origin = origin;
+        this.auth = auth;
+    }
+    read() {
+        return this.execute('read');
+    }
+    create(request) {
+        return this.execute('create', fields(request), request.idempotencyKey);
+    }
+    update(request) {
+        return this.execute('update', { expected_revision: request.expectedRevision, ...fields(request) }, request.idempotencyKey);
+    }
+    rotate(request) {
+        return this.execute('rotate', { expected_revision: request.expectedRevision }, request.idempotencyKey);
+    }
+    close(request) {
+        return this.execute('close', { expected_revision: request.expectedRevision }, request.idempotencyKey);
+    }
+    reopen(request) {
+        return this.execute('reopen', { expected_revision: request.expectedRevision, ...fields(request) }, request.idempotencyKey);
+    }
+    async execute(operation, body, idempotencyKey) {
+        const spec = OPERATIONS[operation];
+        const encoded = body === undefined ? undefined : JSON.stringify(body);
+        if (encoded !== undefined && Buffer.byteLength(encoded, 'utf8') > MAX_REQUEST_BYTES) {
+            return { ok: false, error: { code: 'invalid-request', message: integrationFailureMessage('invalid-request') } };
+        }
+        const headers = new Headers({ accept: 'application/json' });
+        if (encoded !== undefined)
+            headers.set('content-type', 'application/json');
+        if (idempotencyKey !== undefined)
+            headers.set('idempotency-key', idempotencyKey);
+        const abort = new AbortController();
+        const timeout = setTimeout(() => { abort.abort(); }, REQUEST_TIMEOUT_MS);
+        try {
+            const request = new Request(new URL(spec.path, this.origin), {
+                method: spec.method,
+                headers,
+                ...encoded === undefined ? {} : { body: encoded },
+                redirect: 'error',
+                signal: abort.signal,
+            });
+            const response = await this.auth.dispatch(request, signed => fetch(signed));
+            const raw = await readBounded(response);
+            if (!response.ok)
+                return { ok: false, error: failure(response.status, raw) };
+            return { ok: true, value: view(raw) };
+        }
+        catch (error) {
+            if (error instanceof AwikiExternalHttpAuthError
+                && (error.code === 'not-registered' || error.code === 'signed-out')) {
+                return { ok: false, error: { code: 'unauthorized', message: integrationFailureMessage('unauthorized') } };
+            }
+            return { ok: false, error: { code: 'network', message: integrationFailureMessage('network') } };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=integration-client.js.map

package/lib/types/integration-client.js.map

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

package/lib/types/legacy-sent-mail-cache.d.ts

@@ -0,0 +1,4 @@
+/** Exact cleanup for the removed Host-local sent-mail authority. */
+/** Clear only the legacy cache directory during the existing destructive local-data flow. */
+export declare function clearLegacySentMailCache(stateRoot: string): Promise<void>;
+//# sourceMappingURL=legacy-sent-mail-cache.d.ts.map

package/lib/types/legacy-sent-mail-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-sent-mail-cache.d.ts","sourceRoot":"","sources":["../../src/legacy-sent-mail-cache.ts"],"names":[],"mappings":"AAAA,oEAAoE;AASpE,6FAA6F;AAC7F,wBAAsB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/E"}

package/lib/types/legacy-sent-mail-cache.js

@@ -0,0 +1,29 @@
+/** Exact cleanup for the removed Host-local sent-mail authority. */
+import { lstat, rm, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+function isMissing(error) {
+    return typeof error === 'object' && error !== null && error.code === 'ENOENT';
+}
+/** Clear only the legacy cache directory during the existing destructive local-data flow. */
+export async function clearLegacySentMailCache(stateRoot) {
+    const hostDirectory = join(stateRoot, '.host');
+    const directory = join(hostDirectory, 'sent-mail-v1');
+    try {
+        const host = await lstat(hostDirectory);
+        if (!host.isDirectory() || host.isSymbolicLink()) {
+            throw new TypeError('awiki: legacy sent-mail cache parent is invalid');
+        }
+        const target = await lstat(directory);
+        if (target.isDirectory() && !target.isSymbolicLink()) {
+            await rm(directory, { recursive: true, force: true });
+        }
+        else {
+            await unlink(directory);
+        }
+    }
+    catch (error) {
+        if (!isMissing(error))
+            throw error;
+    }
+}
+//# sourceMappingURL=legacy-sent-mail-cache.js.map

package/lib/types/legacy-sent-mail-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-sent-mail-cache.js","sourceRoot":"","sources":["../../src/legacy-sent-mail-cache.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAqC,CAAC,IAAI,KAAK,QAAQ,CAAA;AAChH,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,SAAiB;IAC9D,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACrD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,CAAA;QACvC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAA;QACxE,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAA;QACrC,IAAI,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;YACrD,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACvD,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,CAAC,SAAS,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;IACpC,CAAC;AACH,CAAC"}

package/lib/types/mail-list-client.d.ts

@@ -0,0 +1,12 @@
+/** Host-only server-authoritative outbound Mail query. */
+import { type AwikiExternalHttpAuth } from './external-http-auth.ts';
+import type { AwikiMailInboxPage, AwikiMailInboxRequest } from './types.ts';
+/** Fixed Mail Service client; callers cannot select method, direction, headers, or transport. */
+export declare class AwikiMailListClient {
+    private readonly origin;
+    private readonly auth;
+    constructor(origin: string, auth: AwikiExternalHttpAuth);
+    listOutbound(request: AwikiMailInboxRequest): Promise<AwikiMailInboxPage>;
+    private page;
+}
+//# sourceMappingURL=mail-list-client.d.ts.map

package/lib/types/mail-list-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-list-client.d.ts","sourceRoot":"","sources":["../../src/mail-list-client.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EAGtB,MAAM,YAAY,CAAA;AAoKnB,iGAAiG;AACjG,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,qBAAqB;IAGjC,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAsBxE,IAAI;CA2CnB"}

package/lib/types/mail-list-client.js

@@ -0,0 +1,254 @@
+/** Host-only server-authoritative outbound Mail query. */
+import { AwikiExternalHttpAuthError, } from "./external-http-auth.js";
+import { AwikiSdkError } from "./sdk-adapter.js";
+const MAIL_LIST_PATH = '/mail/rpc';
+const MAIL_LIST_PAGE_SIZE = 100;
+const MAIL_LIST_TIMEOUT_MS = 10_000;
+const MAX_RESPONSE_BYTES = 1024 * 1024;
+const MAX_UINT32 = 0xffff_ffff;
+function invalidResponse() {
+    throw new AwikiSdkError('remote');
+}
+function uint32(value) {
+    if (!Number.isSafeInteger(value) || value < 0 || value > MAX_UINT32) {
+        invalidResponse();
+    }
+    return value;
+}
+function requiredString(value, maxBytes) {
+    if (typeof value !== 'string'
+        || value.length === 0
+        || value.trim() !== value
+        || /[\u0000-\u001f\u007f-\u009f]/u.test(value)
+        || Buffer.byteLength(value, 'utf8') > maxBytes) {
+        invalidResponse();
+    }
+    return value;
+}
+function addresses(value) {
+    if (value === null || value === undefined || value === '')
+        return [];
+    const raw = Array.isArray(value)
+        ? value
+        : typeof value === 'string' ? value.split(/[;,]/u) : invalidResponse();
+    if (raw.length > 100)
+        invalidResponse();
+    return raw.map(candidate => {
+        const address = requiredString(typeof candidate === 'string' ? candidate.trim() : candidate, 320);
+        if (!address.includes('@') || /\s/u.test(address))
+            invalidResponse();
+        return address;
+    });
+}
+function timestamp(value) {
+    const copied = requiredString(value, 64);
+    const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d+))?(Z|[+-]\d{2}:\d{2})?$/u.exec(copied);
+    if (match === null)
+        invalidResponse();
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const hour = Number(match[4]);
+    const minute = Number(match[5]);
+    const second = Number(match[6]);
+    const zone = match[8];
+    const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+    const monthDays = [31, leapYear ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+    if (year === 0
+        || month < 1 || month > 12
+        || day < 1 || day > monthDays[month - 1]
+        || hour > 23
+        || minute > 59
+        || second > 59) {
+        invalidResponse();
+    }
+    if (zone !== undefined && zone !== 'Z') {
+        const offsetHour = Number(zone.slice(1, 3));
+        const offsetMinute = Number(zone.slice(4, 6));
+        if (offsetHour > 23 || offsetMinute > 59)
+            invalidResponse();
+    }
+    // Mail Service persists UTC-naive MySQL DATETIME and serializes it with
+    // datetime.isoformat(). Make that deployed shape explicit before Browser use.
+    return zone === undefined ? `${copied}Z` : copied;
+}
+function boundedText(value, maxBytes, fallback) {
+    const source = typeof value === 'string' && value.trim() !== '' ? value : fallback;
+    if (/\u0000/u.test(source))
+        invalidResponse();
+    if (Buffer.byteLength(source, 'utf8') <= maxBytes)
+        return { value: source, truncated: false };
+    const characters = Array.from(source);
+    while (characters.length > 0 && Buffer.byteLength(characters.join(''), 'utf8') > maxBytes) {
+        characters.pop();
+    }
+    return { value: characters.join(''), truncated: true };
+}
+function summary(raw) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        invalidResponse();
+    const value = raw;
+    if (value.direction !== 'outbound' || typeof value.has_attachments !== 'boolean')
+        invalidResponse();
+    const subject = boundedText(value.subject, 1_024, '(no subject)');
+    return {
+        id: requiredString(value.id, 2_048),
+        folder: 'sent',
+        from: addresses(value.from_addr),
+        to: addresses(value.to_addr),
+        cc: addresses(value.cc_addr),
+        subject: subject.value,
+        subjectTruncated: subject.truncated,
+        previewTruncated: false,
+        sentAt: timestamp(value.created_at),
+        unread: false,
+        hasAttachments: value.has_attachments,
+    };
+}
+async function readBounded(response) {
+    const declared = response.headers.get('content-length');
+    if (declared !== null && /^\d+$/u.test(declared) && Number(declared) > MAX_RESPONSE_BYTES) {
+        invalidResponse();
+    }
+    const reader = response.body?.getReader();
+    if (reader === undefined)
+        invalidResponse();
+    const chunks = [];
+    let size = 0;
+    try {
+        while (true) {
+            const result = await reader.read();
+            if (result.done)
+                break;
+            size += result.value.byteLength;
+            if (size > MAX_RESPONSE_BYTES)
+                invalidResponse();
+            chunks.push(result.value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const bytes = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    try {
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        invalidResponse();
+    }
+}
+function rpcFailure(code) {
+    if (code === -32000)
+        throw new AwikiSdkError('not-registered');
+    if (code === -32001)
+        throw new AwikiSdkError('forbidden');
+    if (code === -32002)
+        throw new AwikiSdkError('not-found');
+    if (code === -32003)
+        throw new AwikiSdkError('conflict');
+    if (code === -32004 || code === -32600 || code === -32602)
+        throw new AwikiSdkError('invalid-request');
+    if (code === -32005)
+        throw new AwikiSdkError('rate-limited');
+    invalidResponse();
+}
+function responseFailure(status) {
+    if (status === 401)
+        throw new AwikiSdkError('not-registered');
+    if (status === 403)
+        throw new AwikiSdkError('forbidden');
+    if (status === 429)
+        throw new AwikiSdkError('rate-limited');
+    if (status >= 500)
+        throw new AwikiSdkError('network');
+    invalidResponse();
+}
+/** Fixed Mail Service client; callers cannot select method, direction, headers, or transport. */
+export class AwikiMailListClient {
+    origin;
+    auth;
+    constructor(origin, auth) {
+        this.origin = origin;
+        this.auth = auth;
+    }
+    async listOutbound(request) {
+        const offset = request.offset ?? 0;
+        const limit = request.limit ?? 20;
+        const firstPageNumber = Math.floor(offset / MAIL_LIST_PAGE_SIZE) + 1;
+        const first = await this.page(firstPageNumber);
+        const pageOffset = offset % MAIL_LIST_PAGE_SIZE;
+        let items = first.items.slice(pageOffset, pageOffset + limit);
+        let total = first.total;
+        if (items.length < limit && offset + items.length < total) {
+            const next = await this.page(firstPageNumber + 1);
+            total = next.total;
+            items = [...items, ...next.items.slice(0, limit - items.length)];
+        }
+        const nextOffset = offset + items.length;
+        const hasMore = nextOffset < total;
+        return {
+            items,
+            ...hasMore ? { nextOffset } : {},
+            hasMore,
+        };
+    }
+    async page(page) {
+        const abort = new AbortController();
+        const timeout = setTimeout(() => { abort.abort(); }, MAIL_LIST_TIMEOUT_MS);
+        try {
+            const request = new Request(new URL(MAIL_LIST_PATH, this.origin), {
+                method: 'POST',
+                headers: { accept: 'application/json', 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    method: 'mail.list',
+                    params: { direction: 'outbound', page, page_size: MAIL_LIST_PAGE_SIZE },
+                }),
+                redirect: 'error',
+                signal: abort.signal,
+            });
+            const response = await this.auth.dispatch(request, signed => fetch(signed));
+            if (!response.ok)
+                responseFailure(response.status);
+            const raw = await readBounded(response);
+            if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+                invalidResponse();
+            const envelope = raw;
+            if (envelope.jsonrpc !== '2.0' || envelope.id !== 1)
+                invalidResponse();
+            if (envelope.error !== null && envelope.error !== undefined) {
+                if (typeof envelope.error !== 'object' || Array.isArray(envelope.error))
+                    invalidResponse();
+                rpcFailure(envelope.error.code);
+            }
+            if (typeof envelope.result !== 'object' || envelope.result === null || Array.isArray(envelope.result)) {
+                invalidResponse();
+            }
+            const result = envelope.result;
+            if (!Array.isArray(result.items) || result.items.length > MAIL_LIST_PAGE_SIZE)
+                invalidResponse();
+            return { total: uint32(result.total), items: result.items.map(summary) };
+        }
+        catch (error) {
+            if (error instanceof AwikiSdkError)
+                throw error;
+            if (error instanceof AwikiExternalHttpAuthError) {
+                if (error.code === 'not-registered')
+                    throw new AwikiSdkError('not-registered');
+                if (error.code === 'signed-out')
+                    throw new AwikiSdkError('signed-out');
+            }
+            throw new AwikiSdkError('network');
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=mail-list-client.js.map

package/lib/types/mail-list-client.js.map

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

package/lib/types/mail-recovery-observability.d.ts

@@ -0,0 +1,8 @@
+import type { AwikiMailRecoveryObservability } from './types.ts';
+export type AwikiMailRecoveryFailureFields = Pick<AwikiMailRecoveryObservability, 'mail_ingress_classification' | 'auth_status_class' | 'auth_stable_machine_code' | 'retryable' | 'mail_closed_classification'>;
+/** Copy only a complete upstream closed classification; arbitrary errors fail closed. */
+export declare function mailRecoveryFailureFields(error: unknown): AwikiMailRecoveryFailureFields | undefined;
+export declare function successfulMailRecoveryObservability(): AwikiMailRecoveryObservability;
+export declare function failedMailRecoveryObservability(error: unknown): AwikiMailRecoveryObservability;
+export declare function fencedMailRecoveryObservability(currentPrincipalMatchesRecovery: boolean, requestGenerationClassification: 'current' | 'replaced'): AwikiMailRecoveryObservability;
+//# sourceMappingURL=mail-recovery-observability.d.ts.map

package/lib/types/mail-recovery-observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-recovery-observability.d.ts","sourceRoot":"","sources":["../../src/mail-recovery-observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,8BAA8B,EAC/B,MAAM,YAAY,CAAA;AAkCnB,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAC/C,8BAA8B,EAC5B,6BAA6B,GAC7B,mBAAmB,GACnB,0BAA0B,GAC1B,WAAW,GACX,4BAA4B,CAC/B,CAAA;AAwBD,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,GAAG,SAAS,CA6BpG;AAED,wBAAgB,mCAAmC,IAAI,8BAA8B,CASpF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,CAY9F;AAED,wBAAgB,+BAA+B,CAC7C,+BAA+B,EAAE,OAAO,EACxC,+BAA+B,EAAE,SAAS,GAAG,UAAU,GACtD,8BAA8B,CAShC"}