@dxos/plugin-jmap 0.10.0

package/dist/types/src/apis/JmapMail/api.d.ts

@@ -0,0 +1,223 @@
+import * as HttpClient from '@effect/platform/HttpClient';
+import * as Effect from 'effect/Effect';
+import { JmapApiError } from '../../errors';
+import { JmapCredentials } from '../../services/jmap-credentials';
+import { type EmailAddress } from './types';
+/**
+ * Resolved per-request context: the session `apiUrl`, the mail account id, and (optionally) the
+ * session's blob `downloadUrl` template (RFC 8620 §6.2). Most operations (mailboxGet, emailQuery,
+ * send, delete, …) don't need it and construct a `Target` without it; only the attachment-fetching
+ * path populates it from `Jmap.Session.downloadUrl`, so {@link downloadBlob} is the sole consumer
+ * that requires it — absent here just means "this call site never populated it", not "the server
+ * didn't advertise one" (every real session does).
+ */
+export type Target = {
+    readonly apiUrl: string;
+    readonly accountId: string;
+    readonly downloadUrl?: string;
+};
+/**
+ * Downloads a blob's raw bytes via the session's `downloadUrl` template. `name`/`type` are advisory
+ * (they only affect the response's `Content-Disposition`/`Accept`), not required for correctness.
+ */
+export declare const downloadBlob: (target: Target, blobId: string, options?: {
+    name?: string;
+    type?: string;
+} | undefined) => Effect.Effect<Uint8Array<ArrayBuffer>, JmapApiError, HttpClient.HttpClient | JmapCredentials>;
+/** Email properties fetched by {@link emailGet} — enough for the mapper to build a Message. */
+export declare const EMAIL_PROPERTIES: readonly ['id', 'blobId', 'threadId', 'mailboxIds', 'keywords', 'from', 'to', 'cc', 'subject', 'receivedAt', 'sentAt', 'preview', 'messageId', 'inReplyTo', 'references', 'bodyValues', 'textBody', 'htmlBody', 'attachments'];
+/** Lists all folders (mailboxes) in the account (RFC 8621 §2.3). */
+export declare const mailboxGet: (target: Target) => Effect.Effect<{
+    readonly accountId?: string | undefined;
+    readonly state?: string | undefined;
+    readonly list: readonly {
+        readonly id: string;
+        readonly name: string;
+        readonly role?: string | null | undefined;
+        readonly parentId?: string | null | undefined;
+        readonly sortOrder?: number | undefined;
+        readonly totalEmails?: number | undefined;
+        readonly unreadEmails?: number | undefined;
+    }[];
+    readonly notFound?: readonly string[] | null | undefined;
+}, JmapApiError, HttpClient.HttpClient | JmapCredentials>;
+/** Queries email ids matching a filter (RFC 8621 §4.4). */
+export declare const emailQuery: (target: Target, options?: {
+    filter?: unknown;
+    sort?: readonly {
+        property: string;
+        isAscending?: boolean;
+    }[];
+    position?: number;
+    limit?: number;
+    calculateTotal?: boolean;
+} | undefined) => Effect.Effect<{
+    readonly accountId?: string | undefined;
+    readonly queryState?: string | undefined;
+    readonly position?: number | undefined;
+    readonly total?: number | undefined;
+    readonly limit?: number | undefined;
+    readonly ids: readonly string[];
+}, JmapApiError, HttpClient.HttpClient | JmapCredentials>;
+/** Fetches emails by id with decoded HTML and text body values (RFC 8621 §4.2). */
+export declare const emailGet: (target: Target, ids: readonly string[], properties?: readonly string[] | undefined) => Effect.Effect<{
+    readonly accountId?: string | undefined;
+    readonly state?: string | undefined;
+    readonly list: readonly {
+        readonly id: string;
+        readonly blobId?: string | undefined;
+        readonly threadId: string;
+        readonly mailboxIds?: {
+            readonly [x: string]: boolean;
+        } | undefined;
+        readonly keywords?: {
+            readonly [x: string]: boolean;
+        } | undefined;
+        readonly from?: readonly {
+            readonly name?: string | null | undefined;
+            readonly email: string;
+        }[] | null | undefined;
+        readonly to?: readonly {
+            readonly name?: string | null | undefined;
+            readonly email: string;
+        }[] | null | undefined;
+        readonly cc?: readonly {
+            readonly name?: string | null | undefined;
+            readonly email: string;
+        }[] | null | undefined;
+        readonly bcc?: readonly {
+            readonly name?: string | null | undefined;
+            readonly email: string;
+        }[] | null | undefined;
+        readonly subject?: string | null | undefined;
+        readonly receivedAt: string;
+        readonly sentAt?: string | null | undefined;
+        readonly preview?: string | null | undefined;
+        readonly messageId?: readonly string[] | null | undefined;
+        readonly inReplyTo?: readonly string[] | null | undefined;
+        readonly references?: readonly string[] | null | undefined;
+        readonly bodyValues?: {
+            readonly [x: string]: {
+                readonly value: string;
+                readonly isEncodingProblem?: boolean | undefined;
+                readonly isTruncated?: boolean | undefined;
+            };
+        } | undefined;
+        readonly textBody?: readonly {
+            readonly partId?: string | null | undefined;
+            readonly blobId?: string | null | undefined;
+            readonly size?: number | undefined;
+            readonly type?: string | undefined;
+            readonly charset?: string | null | undefined;
+            readonly name?: string | null | undefined;
+            readonly disposition?: string | null | undefined;
+            readonly cid?: string | null | undefined;
+        }[] | undefined;
+        readonly htmlBody?: readonly {
+            readonly partId?: string | null | undefined;
+            readonly blobId?: string | null | undefined;
+            readonly size?: number | undefined;
+            readonly type?: string | undefined;
+            readonly charset?: string | null | undefined;
+            readonly name?: string | null | undefined;
+            readonly disposition?: string | null | undefined;
+            readonly cid?: string | null | undefined;
+        }[] | undefined;
+        readonly attachments?: readonly {
+            readonly partId?: string | null | undefined;
+            readonly blobId?: string | null | undefined;
+            readonly size?: number | undefined;
+            readonly type?: string | undefined;
+            readonly charset?: string | null | undefined;
+            readonly name?: string | null | undefined;
+            readonly disposition?: string | null | undefined;
+            readonly cid?: string | null | undefined;
+        }[] | undefined;
+    }[];
+    readonly notFound?: readonly string[] | null | undefined;
+}, JmapApiError, HttpClient.HttpClient | JmapCredentials>;
+/**
+ * Fetches the delta of email changes since an opaque `sinceState` token (RFC 8621 §4.3). A server that
+ * can't compute the delta (state too old / evicted) returns a `cannotCalculateChanges` method error,
+ * surfaced as a {@link JmapApiError} with that `type` — the caller's cue to fall back to a full scan.
+ * The token to pass comes from a prior `Email/get` `state` (NOT `Email/query` `queryState`).
+ */
+export declare const emailChanges: (target: Target, sinceState: string, maxChanges?: number | undefined) => Effect.Effect<{
+    readonly accountId?: string | undefined;
+    readonly oldState: string;
+    readonly newState: string;
+    readonly hasMoreChanges: boolean;
+    readonly created: readonly string[];
+    readonly updated: readonly string[];
+    readonly destroyed: readonly string[];
+}, JmapApiError, HttpClient.HttpClient | JmapCredentials>;
+/** Lists the account's sending identities (RFC 8621 §6.2). */
+export declare const identityGet: (target: Target) => Effect.Effect<{
+    readonly accountId?: string | undefined;
+    readonly state?: string | undefined;
+    readonly list: readonly {
+        readonly id: string;
+        readonly name?: string | null | undefined;
+        readonly email: string;
+    }[];
+    readonly notFound?: readonly string[] | null | undefined;
+}, JmapApiError, HttpClient.HttpClient | JmapCredentials>;
+/** Patches a single email (e.g. replace `mailboxIds` to move to Trash). Idempotent, so retryable. */
+export declare const emailSetUpdate: (target: Target, emailId: string, patch: Record<string, unknown>) => Effect.Effect<{
+    readonly accountId?: string | undefined;
+    readonly oldState?: string | null | undefined;
+    readonly newState?: string | undefined;
+    readonly created?: {
+        readonly [x: string]: {
+            readonly id: string;
+            readonly blobId?: string | undefined;
+            readonly threadId?: string | undefined;
+            readonly size?: number | undefined;
+        };
+    } | null | undefined;
+    readonly updated?: {
+        readonly [x: string]: unknown;
+    } | null | undefined;
+    readonly destroyed?: readonly string[] | null | undefined;
+    readonly notCreated?: {
+        readonly [x: string]: {
+            readonly type: string;
+            readonly description?: string | null | undefined;
+        };
+    } | null | undefined;
+    readonly notUpdated?: {
+        readonly [x: string]: {
+            readonly type: string;
+            readonly description?: string | null | undefined;
+        };
+    } | null | undefined;
+    readonly notDestroyed?: {
+        readonly [x: string]: {
+            readonly type: string;
+            readonly description?: string | null | undefined;
+        };
+    } | null | undefined;
+}, JmapApiError, HttpClient.HttpClient | JmapCredentials>;
+/**
+ * Creates a draft and submits it for delivery in a single batched request. Not retried (a retry
+ * could double-send). Returns the created email's id and thread id.
+ */
+export declare const submitEmail: (target: Target, args: {
+    identityId: string;
+    draftsMailboxId: string;
+    sentMailboxId: string;
+    draft: {
+        from: readonly EmailAddress[];
+        to: readonly EmailAddress[];
+        cc?: readonly EmailAddress[];
+        bcc?: readonly EmailAddress[];
+        subject?: string;
+        inReplyTo?: readonly string[];
+        references?: readonly string[];
+        text: string;
+    };
+}) => Effect.Effect<{
+    id: string;
+    threadId: string | undefined;
+}, JmapApiError, HttpClient.HttpClient | JmapCredentials>;
+//# sourceMappingURL=api.d.ts.map

package/dist/types/src/apis/JmapMail/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../../src/apis/JmapMail/api.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAE1D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAUlE,OAAO,EACL,KAAK,YAAY,EAQlB,MAAM,SAAS,CAAC;AAEjB;;;;;;;GAOG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAWF;;;GAGG;AACH,eAAO,MAAM,YAAY;WAGL,MAAM;WAAS,MAAM;+GA2BvC,CAAC;AAQH,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,YAC3B,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,CACL,CAAC;AAEX,oEAAoE;AACpE,eAAO,MAAM,UAAU;;;;;;;;;;;;;yDAMrB,CAAC;AAEH,2DAA2D;AAC3D,eAAO,MAAM,UAAU;aAGV,OAAO;WACT,SAAS;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE;eAClD,MAAM;YACT,MAAM;qBACG,OAAO;;;;;;;;yDAyB1B,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAgBnB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;yDAcvB,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,WAAW;;;;;;;;;yDAMtB,CAAC;AAEH,qGAAqG;AACrG,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAezB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;gBAGR,MAAM;qBACD,MAAM;mBACR,MAAM;WACd;QACL,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;QAC9B,EAAE,EAAE,SAAS,YAAY,EAAE,CAAC;QAC5B,EAAE,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;QAC7B,GAAG,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC9B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;KACd;;;;yDAwEH,CAAC"}

package/dist/types/src/apis/JmapMail/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api';
+export * from './types';
+export * from './query';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/apis/JmapMail/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/apis/JmapMail/index.ts"],"names":[],"mappings":"AAIA,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/types/src/apis/JmapMail/query.d.ts

@@ -0,0 +1,26 @@
+import * as Option from 'effect/Option';
+import { type Filter } from '../Jmap';
+import { type Mailbox } from './types';
+/** Context for {@link parseMailQuery}: a clock (for relative dates) and a label/folder resolver. */
+export type ParseContext = {
+    readonly now: Date;
+    /** Resolves a `label:`/`in:` name or system role to a JMAP mailbox id. */
+    readonly resolveMailbox: (nameOrRole: string) => Option.Option<string>;
+};
+/**
+ * Translates a Gmail-like query string into a JMAP `Email/query` filter (RFC 8621 §4.4.1).
+ *
+ * Supported operators: `from:`/`to:`/`cc:`/`bcc:`/`subject:`/`body:`, `label:`/`in:` (resolved to a
+ * mailbox id), `is:unread|read|starred|flagged|unstarred|draft|answered`, `has:attachment`,
+ * `after:`/`before:` (`YYYY/MM/DD` or `YYYY-MM-DD`), `newer_than:`/`older_than:` (e.g. `7d`, `2w`,
+ * `3m`, `1y`), `larger:`/`smaller:` (e.g. `10M`, `500k`), `list:`/`deliveredto:` (header match),
+ * quoted phrases, `-` negation, `OR` groups, and bare words (full-text). Space-separated terms are
+ * AND-ed. Returns `None` for an empty query, or one whose terms all fail to resolve (e.g. an unknown
+ * label).
+ */
+export declare const parseMailQuery: (query: string, ctx: ParseContext) => Option.Option<Filter>;
+/** Resolves a label/folder name (case-insensitive) or a system role/alias to a mailbox id. */
+export declare const resolveMailboxByNameOrRole: (folders: readonly Mailbox[], nameOrRole: string) => Option.Option<string>;
+/** Whether a filter restricts the mailbox scope (`inMailbox`/`inMailboxOtherThan`), recursively. */
+export declare const filterScopesMailbox: (filter: Filter) => boolean;
+//# sourceMappingURL=query.d.ts.map

package/dist/types/src/apis/JmapMail/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../src/apis/JmapMail/query.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,MAAM,EAA6C,MAAM,SAAS,CAAC;AACjF,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACxE,CAAC;AAMF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,OAAO,YAAY,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CACnD,CAAC;AAEpC,8FAA8F;AAC9F,eAAO,MAAM,0BAA0B,YAAa,SAAS,OAAO,EAAE,cAAc,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAMhH,CAAC;AAwEF,oGAAoG;AACpG,eAAO,MAAM,mBAAmB,WAAY,MAAM,KAAG,OAG0B,CAAC"}

package/dist/types/src/apis/JmapMail/query.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query.test.d.ts.map

package/dist/types/src/apis/JmapMail/query.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.test.d.ts","sourceRoot":"","sources":["../../../../../src/apis/JmapMail/query.test.ts"],"names":[],"mappings":""}

package/dist/types/src/apis/JmapMail/types.d.ts

@@ -0,0 +1,290 @@
+import * as Schema from 'effect/Schema';
+/** Structured email address — JMAP gives `{ name, email }` directly (no header parsing). */
+export declare const EmailAddress: Schema.Struct<{
+    name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    email: typeof Schema.String;
+}>;
+export type EmailAddress = Schema.Schema.Type<typeof EmailAddress>;
+/** A folder. `role` is a well-known role (`inbox`, `drafts`, `sent`, `trash`, …) or null for custom folders. */
+export declare const Mailbox: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    role: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    parentId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    sortOrder: Schema.optional<typeof Schema.Number>;
+    totalEmails: Schema.optional<typeof Schema.Number>;
+    unreadEmails: Schema.optional<typeof Schema.Number>;
+}>;
+export type Mailbox = Schema.Schema.Type<typeof Mailbox>;
+/** A decoded body part value (when fetched with `fetchTextBodyValues`). */
+export declare const BodyValue: Schema.Struct<{
+    value: typeof Schema.String;
+    isEncodingProblem: Schema.optional<typeof Schema.Boolean>;
+    isTruncated: Schema.optional<typeof Schema.Boolean>;
+}>;
+export type BodyValue = Schema.Schema.Type<typeof BodyValue>;
+/** A body part reference (the `partId` keys into `Email.bodyValues`; `blobId` fetches raw bytes). */
+export declare const EmailBodyPart: Schema.Struct<{
+    partId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    blobId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    size: Schema.optional<typeof Schema.Number>;
+    type: Schema.optional<typeof Schema.String>;
+    charset: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    /** Attachment filename, present on parts listed in `Email.attachments`. */
+    name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    /** MIME `Content-Disposition` (`attachment` or `inline`), present on parts listed in `Email.attachments`. */
+    disposition: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    /** The part's `Content-ID` header (RFC 8621 §4.1.4), if any — matches a `cid:` reference in an HTML body. */
+    cid: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+}>;
+export type EmailBodyPart = Schema.Schema.Type<typeof EmailBodyPart>;
+/** An email (RFC 8621 §4). Only the properties requested in `Email/get` are present. */
+export declare const Email: Schema.Struct<{
+    id: typeof Schema.String;
+    blobId: Schema.optional<typeof Schema.String>;
+    threadId: typeof Schema.String;
+    mailboxIds: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Boolean>>;
+    keywords: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Boolean>>;
+    from: Schema.optional<Schema.NullOr<Schema.Array$<Schema.Struct<{
+        name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        email: typeof Schema.String;
+    }>>>>;
+    to: Schema.optional<Schema.NullOr<Schema.Array$<Schema.Struct<{
+        name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        email: typeof Schema.String;
+    }>>>>;
+    cc: Schema.optional<Schema.NullOr<Schema.Array$<Schema.Struct<{
+        name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        email: typeof Schema.String;
+    }>>>>;
+    bcc: Schema.optional<Schema.NullOr<Schema.Array$<Schema.Struct<{
+        name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        email: typeof Schema.String;
+    }>>>>;
+    subject: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    receivedAt: typeof Schema.String;
+    sentAt: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    preview: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    messageId: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+    inReplyTo: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+    references: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+    bodyValues: Schema.optional<Schema.Record$<typeof Schema.String, Schema.Struct<{
+        value: typeof Schema.String;
+        isEncodingProblem: Schema.optional<typeof Schema.Boolean>;
+        isTruncated: Schema.optional<typeof Schema.Boolean>;
+    }>>>;
+    textBody: Schema.optional<Schema.Array$<Schema.Struct<{
+        partId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        blobId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        size: Schema.optional<typeof Schema.Number>;
+        type: Schema.optional<typeof Schema.String>;
+        charset: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** Attachment filename, present on parts listed in `Email.attachments`. */
+        name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** MIME `Content-Disposition` (`attachment` or `inline`), present on parts listed in `Email.attachments`. */
+        disposition: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** The part's `Content-ID` header (RFC 8621 §4.1.4), if any — matches a `cid:` reference in an HTML body. */
+        cid: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>>;
+    htmlBody: Schema.optional<Schema.Array$<Schema.Struct<{
+        partId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        blobId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        size: Schema.optional<typeof Schema.Number>;
+        type: Schema.optional<typeof Schema.String>;
+        charset: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** Attachment filename, present on parts listed in `Email.attachments`. */
+        name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** MIME `Content-Disposition` (`attachment` or `inline`), present on parts listed in `Email.attachments`. */
+        disposition: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** The part's `Content-ID` header (RFC 8621 §4.1.4), if any — matches a `cid:` reference in an HTML body. */
+        cid: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>>;
+    /** Non-body parts (RFC 8621 §4.1.4) — the attachments proper, distinct from `textBody`/`htmlBody`. */
+    attachments: Schema.optional<Schema.Array$<Schema.Struct<{
+        partId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        blobId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        size: Schema.optional<typeof Schema.Number>;
+        type: Schema.optional<typeof Schema.String>;
+        charset: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** Attachment filename, present on parts listed in `Email.attachments`. */
+        name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** MIME `Content-Disposition` (`attachment` or `inline`), present on parts listed in `Email.attachments`. */
+        disposition: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** The part's `Content-ID` header (RFC 8621 §4.1.4), if any — matches a `cid:` reference in an HTML body. */
+        cid: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>>;
+}>;
+export type Email = Schema.Schema.Type<typeof Email>;
+/** A sending identity (RFC 8621 §6); `email` is an address the server permits as `from`. */
+export declare const Identity: Schema.Struct<{
+    id: typeof Schema.String;
+    name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    email: typeof Schema.String;
+}>;
+export type Identity = Schema.Schema.Type<typeof Identity>;
+export declare const MailboxGetResult: Schema.Struct<{
+    accountId: Schema.optional<typeof Schema.String>;
+    state: Schema.optional<typeof Schema.String>;
+    list: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+        role: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        parentId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        sortOrder: Schema.optional<typeof Schema.Number>;
+        totalEmails: Schema.optional<typeof Schema.Number>;
+        unreadEmails: Schema.optional<typeof Schema.Number>;
+    }>>;
+    notFound: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+}>;
+export type MailboxGetResult = Schema.Schema.Type<typeof MailboxGetResult>;
+export declare const EmailQueryResult: Schema.Struct<{
+    accountId: Schema.optional<typeof Schema.String>;
+    queryState: Schema.optional<typeof Schema.String>;
+    position: Schema.optional<typeof Schema.Number>;
+    total: Schema.optional<typeof Schema.Number>;
+    limit: Schema.optional<typeof Schema.Number>;
+    ids: Schema.Array$<typeof Schema.String>;
+}>;
+export type EmailQueryResult = Schema.Schema.Type<typeof EmailQueryResult>;
+export declare const EmailGetResult: Schema.Struct<{
+    accountId: Schema.optional<typeof Schema.String>;
+    state: Schema.optional<typeof Schema.String>;
+    list: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        blobId: Schema.optional<typeof Schema.String>;
+        threadId: typeof Schema.String;
+        mailboxIds: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Boolean>>;
+        keywords: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Boolean>>;
+        from: Schema.optional<Schema.NullOr<Schema.Array$<Schema.Struct<{
+            name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            email: typeof Schema.String;
+        }>>>>;
+        to: Schema.optional<Schema.NullOr<Schema.Array$<Schema.Struct<{
+            name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            email: typeof Schema.String;
+        }>>>>;
+        cc: Schema.optional<Schema.NullOr<Schema.Array$<Schema.Struct<{
+            name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            email: typeof Schema.String;
+        }>>>>;
+        bcc: Schema.optional<Schema.NullOr<Schema.Array$<Schema.Struct<{
+            name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            email: typeof Schema.String;
+        }>>>>;
+        subject: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        receivedAt: typeof Schema.String;
+        sentAt: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        preview: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        messageId: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+        inReplyTo: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+        references: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+        bodyValues: Schema.optional<Schema.Record$<typeof Schema.String, Schema.Struct<{
+            value: typeof Schema.String;
+            isEncodingProblem: Schema.optional<typeof Schema.Boolean>;
+            isTruncated: Schema.optional<typeof Schema.Boolean>;
+        }>>>;
+        textBody: Schema.optional<Schema.Array$<Schema.Struct<{
+            partId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            blobId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            size: Schema.optional<typeof Schema.Number>;
+            type: Schema.optional<typeof Schema.String>;
+            charset: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            /** Attachment filename, present on parts listed in `Email.attachments`. */
+            name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            /** MIME `Content-Disposition` (`attachment` or `inline`), present on parts listed in `Email.attachments`. */
+            disposition: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            /** The part's `Content-ID` header (RFC 8621 §4.1.4), if any — matches a `cid:` reference in an HTML body. */
+            cid: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        }>>>;
+        htmlBody: Schema.optional<Schema.Array$<Schema.Struct<{
+            partId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            blobId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            size: Schema.optional<typeof Schema.Number>;
+            type: Schema.optional<typeof Schema.String>;
+            charset: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            /** Attachment filename, present on parts listed in `Email.attachments`. */
+            name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            /** MIME `Content-Disposition` (`attachment` or `inline`), present on parts listed in `Email.attachments`. */
+            disposition: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            /** The part's `Content-ID` header (RFC 8621 §4.1.4), if any — matches a `cid:` reference in an HTML body. */
+            cid: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        }>>>;
+        /** Non-body parts (RFC 8621 §4.1.4) — the attachments proper, distinct from `textBody`/`htmlBody`. */
+        attachments: Schema.optional<Schema.Array$<Schema.Struct<{
+            partId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            blobId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            size: Schema.optional<typeof Schema.Number>;
+            type: Schema.optional<typeof Schema.String>;
+            charset: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            /** Attachment filename, present on parts listed in `Email.attachments`. */
+            name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            /** MIME `Content-Disposition` (`attachment` or `inline`), present on parts listed in `Email.attachments`. */
+            disposition: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+            /** The part's `Content-ID` header (RFC 8621 §4.1.4), if any — matches a `cid:` reference in an HTML body. */
+            cid: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        }>>>;
+    }>>;
+    notFound: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+}>;
+export type EmailGetResult = Schema.Schema.Type<typeof EmailGetResult>;
+/** `Email/changes` delta since an opaque `sinceState` token (RFC 8621 §4.3 / RFC 8620 §5.2). */
+export declare const EmailChangesResult: Schema.Struct<{
+    accountId: Schema.optional<typeof Schema.String>;
+    oldState: typeof Schema.String;
+    newState: typeof Schema.String;
+    hasMoreChanges: typeof Schema.Boolean;
+    created: Schema.Array$<typeof Schema.String>;
+    updated: Schema.Array$<typeof Schema.String>;
+    destroyed: Schema.Array$<typeof Schema.String>;
+}>;
+export type EmailChangesResult = Schema.Schema.Type<typeof EmailChangesResult>;
+export declare const IdentityGetResult: Schema.Struct<{
+    accountId: Schema.optional<typeof Schema.String>;
+    state: Schema.optional<typeof Schema.String>;
+    list: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        name: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        email: typeof Schema.String;
+    }>>;
+    notFound: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+}>;
+export type IdentityGetResult = Schema.Schema.Type<typeof IdentityGetResult>;
+export declare const EmailSetResult: Schema.Struct<{
+    accountId: Schema.optional<typeof Schema.String>;
+    oldState: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    newState: Schema.optional<typeof Schema.String>;
+    created: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, Schema.Struct<{
+        id: typeof Schema.String;
+        blobId: Schema.optional<typeof Schema.String>;
+        threadId: Schema.optional<typeof Schema.String>;
+        size: Schema.optional<typeof Schema.Number>;
+    }>>>>;
+    updated: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
+    destroyed: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+    notCreated: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, Schema.Struct<{
+        type: typeof Schema.String;
+        description: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>>>;
+    notUpdated: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, Schema.Struct<{
+        type: typeof Schema.String;
+        description: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>>>;
+    notDestroyed: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, Schema.Struct<{
+        type: typeof Schema.String;
+        description: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>>>;
+}>;
+export type EmailSetResult = Schema.Schema.Type<typeof EmailSetResult>;
+export declare const EmailSubmissionSetResult: Schema.Struct<{
+    accountId: Schema.optional<typeof Schema.String>;
+    newState: Schema.optional<typeof Schema.String>;
+    created: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, Schema.Struct<{
+        id: typeof Schema.String;
+    }>>>>;
+    notCreated: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, Schema.Struct<{
+        type: typeof Schema.String;
+        description: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>>>;
+}>;
+export type EmailSubmissionSetResult = Schema.Schema.Type<typeof EmailSubmissionSetResult>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/src/apis/JmapMail/types.d.ts.map

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

package/dist/types/src/apis/index.d.ts

@@ -0,0 +1,3 @@
+export * as Jmap from './Jmap';
+export * as JmapMail from './JmapMail';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/apis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/apis/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAE/B,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}

package/dist/types/src/apis/jmap-api.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jmap-api.test.d.ts.map

package/dist/types/src/apis/jmap-api.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jmap-api.test.d.ts","sourceRoot":"","sources":["../../../../src/apis/jmap-api.test.ts"],"names":[],"mappings":""}

package/dist/types/src/capabilities/connector.d.ts

@@ -0,0 +1,5 @@
+import * as Effect from 'effect/Effect';
+import * as Capability from '@dxos/app-framework/Capability';
+declare const _default: (props: void) => Effect.Effect<Capability.Contribution<Capability.CapabilityIdentifier<"org.dxos.plugin.connector.capability.connector", "multi">>, never, import("effect/Scope").Scope>;
+export default _default;
+//# sourceMappingURL=connector.d.ts.map

package/dist/types/src/capabilities/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/connector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC"}

package/dist/types/src/capabilities/credential-form.d.ts

@@ -0,0 +1,37 @@
+import * as Schema from 'effect/Schema';
+import { Obj } from '@dxos/echo';
+import { AccessToken } from '@dxos/link';
+import * as Connection from '@dxos/plugin-connector/Connection';
+import * as ConnectorSpec from '@dxos/plugin-connector/ConnectorSpec';
+import { Jmap } from '../apis';
+/**
+ * Manual-credential form for the JMAP connector. JMAP auth is a server-issued Bearer API token
+ * (Fastmail: Settings → Privacy & Security → Integrations), outside any OAuth flow, so the host,
+ * email, and token are collected directly.
+ */
+declare const JmapCredentialFormSchema: Schema.Struct<{
+    host: Schema.SchemaClass<string, string, never>;
+    email: Schema.SchemaClass<string, string, never>;
+    token: Schema.SchemaClass<string, string, never>;
+}>;
+type JmapCredentialFormValues = Schema.Schema.Type<typeof JmapCredentialFormSchema>;
+export declare const jmapCredentialForm: ConnectorSpec.CredentialForm<JmapCredentialFormValues>;
+/**
+ * Builds the `AccessToken` (source = host, account = form email or session username) and `Connection`
+ * for a validated JMAP credential. Pure (no DB), so the construction is unit-testable.
+ */
+export declare const buildJmapCredential: ({ host, email, token, session, connector, }: {
+    host: string;
+    email: string;
+    token: string;
+    session: Jmap.Session;
+    connector: {
+        id?: string;
+        label?: string;
+    };
+}) => {
+    accessToken: Obj.OfShape<AccessToken.AccessToken & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>>;
+    connection: Obj.OfShape<Connection.Connection & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>>;
+};
+export {};
+//# sourceMappingURL=credential-form.d.ts.map

package/dist/types/src/capabilities/credential-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-form.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/credential-form.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAU,GAAG,EAAO,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,UAAU,MAAM,mCAAmC,CAAC;AAChE,OAAO,KAAK,aAAa,MAAM,sCAAsC,CAAC;AAEtE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAK/B;;;;GAIG;AACH,QAAA,MAAM,wBAAwB;;;;EAa5B,CAAC;AAEH,KAAK,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEpF,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,cAAc,CAAC,wBAAwB,CA2BrF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,gDAM7B;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;IACtB,SAAS,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;;;CAaA,CAAC"}

package/dist/types/src/capabilities/credential-form.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=credential-form.test.d.ts.map