@xemahq/biomes-platform-imap 0.1.0

package/dist/connector-adapters/imap-message-parts.js

@@ -0,0 +1,103 @@
+export const DEFAULT_ATTACHMENT_SIZE_LIMIT = 5 * 1024 * 1024;
+const MIN_ATTACHMENT_SIZE_LIMIT = 1024;
+const MAX_ATTACHMENT_SIZE_LIMIT = 16 * 1024 * 1024;
+export function clampAttachmentSizeLimit(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return DEFAULT_ATTACHMENT_SIZE_LIMIT;
+    }
+    return Math.max(MIN_ATTACHMENT_SIZE_LIMIT, Math.min(MAX_ATTACHMENT_SIZE_LIMIT, Math.floor(value)));
+}
+export function flattenAttachmentParts(node, parentId = '') {
+    const out = [];
+    const partId = node.part ?? parentId;
+    const disposition = node.disposition?.toLowerCase();
+    const filename = node.dispositionParameters?.filename ?? node.parameters?.name;
+    if (disposition === 'attachment' &&
+        filename &&
+        typeof node.size === 'number' &&
+        partId) {
+        out.push({
+            filename,
+            contentType: `${node.type ?? 'application'}/${node.subtype ?? 'octet-stream'}`,
+            size: node.size,
+            partId,
+        });
+    }
+    if (Array.isArray(node.childNodes)) {
+        for (const child of node.childNodes) {
+            out.push(...flattenAttachmentParts(child, partId));
+        }
+    }
+    return out;
+}
+function splitHeadersBody(raw) {
+    const match = raw.match(/\r?\n\r?\n/);
+    if (match?.index === undefined) {
+        return null;
+    }
+    return {
+        headers: raw.slice(0, match.index),
+        body: raw.slice(match.index + match[0].length),
+    };
+}
+export function extractBodies(raw) {
+    const out = {};
+    const boundaryMatch = raw.match(/boundary="?([^"\r\n;]+)/i);
+    if (!boundaryMatch?.[1]) {
+        const split = splitHeadersBody(raw);
+        if (split) {
+            out.text = split.body;
+        }
+        return out;
+    }
+    const boundary = boundaryMatch[1];
+    const parts = raw.split(new RegExp(`--${boundary.replace(/[/\\^$*+?.()|[\]{}]/g, '\\$&')}(?:--)?`, 'g'));
+    const filenames = [];
+    for (const part of parts) {
+        const split = splitHeadersBody(part);
+        if (!split) {
+            continue;
+        }
+        const { headers, body } = split;
+        const contentTypeMatch = headers.match(/content-type:\s*([^\r\n;]+)/i);
+        const contentType = contentTypeMatch?.[1]?.toLowerCase().trim();
+        const dispositionMatch = headers.match(/content-disposition:\s*([^\r\n;]+)/i);
+        const filenameMatch = headers.match(/filename="?([^"\r\n;]+)/i);
+        if (dispositionMatch?.[1]?.toLowerCase().includes('attachment') && filenameMatch?.[1]) {
+            filenames.push(filenameMatch[1]);
+            continue;
+        }
+        if (contentType === 'text/plain' && !out.text) {
+            out.text = body.trim();
+        }
+        else if (contentType === 'text/html' && !out.html) {
+            out.html = body.trim();
+        }
+    }
+    if (filenames.length > 0) {
+        out.attachmentFilenames = filenames;
+    }
+    return out;
+}
+export function extractReferences(raw) {
+    const blankIdx = raw.search(/\r?\n\r?\n/);
+    const head = blankIdx >= 0 ? raw.slice(0, blankIdx) : raw;
+    const match = head.match(/^references:\s*((?:.|\r?\n[ \t])+)/im);
+    if (!match?.[1]) {
+        return undefined;
+    }
+    const refs = match[1]
+        .replace(/\r?\n[ \t]+/g, ' ')
+        .split(/\s+/)
+        .filter((r) => r.length > 0);
+    return refs.length > 0 ? refs : undefined;
+}
+export function parseSource(raw) {
+    const body = extractBodies(raw);
+    const references = extractReferences(raw);
+    return {
+        ...body,
+        ...(references ? { references } : {}),
+    };
+}
+//# sourceMappingURL=imap-message-parts.js.map

package/dist/connector-adapters/imap-message-parts.js.map

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

package/dist/connector-adapters/index.d.ts

@@ -0,0 +1,16 @@
+import { type ConnectorAdapterModule } from '@xemahq/biome-sdk/adapter';
+import { type ConnectorDescriptor, type ProviderDescriptor } from '@xemahq/kernel-contracts/connector';
+export declare const MAIL_FETCH_CAPABILITY_REF: import("@xemahq/kernel-contracts/capability").CapabilityRef;
+export declare const MAIL_FETCH_BY_UID_CAPABILITY_REF: import("@xemahq/kernel-contracts/capability").CapabilityRef;
+export declare const MAIL_SEARCH_CAPABILITY_REF: import("@xemahq/kernel-contracts/capability").CapabilityRef;
+export declare const MAIL_MARK_CAPABILITY_REF: import("@xemahq/kernel-contracts/capability").CapabilityRef;
+export declare const imapFetchAction: import("@xemahq/biome-sdk/adapter").OutboundActionHandler;
+export declare const imapFetchByUidAction: import("@xemahq/biome-sdk/adapter").OutboundActionHandler;
+export declare const imapSearchAction: import("@xemahq/biome-sdk/adapter").OutboundActionHandler;
+export declare const imapMarkAction: import("@xemahq/biome-sdk/adapter").OutboundActionHandler;
+export declare const imapProvider: ConnectorAdapterModule;
+declare const connectorAdapters: readonly ConnectorAdapterModule[];
+export default connectorAdapters;
+export declare const providerDescriptor: ProviderDescriptor;
+export declare const connectorDescriptors: readonly ConnectorDescriptor[];
+//# sourceMappingURL=index.d.ts.map

package/dist/connector-adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connector-adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAQL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAExB,MAAM,oCAAoC,CAAC;AA2C5C,eAAO,MAAM,yBAAyB,6DAGrC,CAAC;AACF,eAAO,MAAM,gCAAgC,6DAG5C,CAAC;AACF,eAAO,MAAM,0BAA0B,6DAGtC,CAAC;AACF,eAAO,MAAM,wBAAwB,6DAGpC,CAAC;AAEF,eAAO,MAAM,eAAe,2DAAoC,CAAC;AACjE,eAAO,MAAM,oBAAoB,2DAAyC,CAAC;AAC3E,eAAO,MAAM,gBAAgB,2DAAqC,CAAC;AACnE,eAAO,MAAM,cAAc,2DAAmC,CAAC;AAiE/D,eAAO,MAAM,YAAY,EAAE,sBAazB,CAAC;AAEH,QAAA,MAAM,iBAAiB,EAAE,SAAS,sBAAsB,EAAmB,CAAC;AAC5E,eAAe,iBAAiB,CAAC;AAIjC,eAAO,MAAM,kBAAkB,EAAE,kBAWhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAAS,mBAAmB,EAqC9D,CAAC"}

package/dist/connector-adapters/index.js

@@ -0,0 +1,137 @@
+import { defineConnectorAdapter, } from '@xemahq/biome-sdk/adapter';
+import { buildConnectorCapabilityRef } from '@xemahq/kernel-contracts/capability';
+import { ConnectorAdapterKind, CredentialFieldTransform, CredentialFieldType, CredentialKind, ConnectorOnboardingKind, ProviderAppAuthKind, ProviderOrigin, } from '@xemahq/kernel-contracts/connector';
+import { createImapClient } from './imap-client.factory.js';
+import { IMAP_FETCH_ACTION, IMAP_FETCH_BY_UID_ACTION, IMAP_MARK_ACTION, IMAP_SEARCH_ACTION, makeFetchAction, makeFetchByUidAction, makeMarkAction, makeSearchAction, } from './imap-fetch.js';
+const CONNECTOR_KEY = 'IMAP_GENERIC';
+const PROVIDER_SLUG = 'imap-generic';
+const MAIL_ADAPTER_KIND = 'mail';
+export const MAIL_FETCH_CAPABILITY_REF = buildConnectorCapabilityRef(MAIL_ADAPTER_KIND, IMAP_FETCH_ACTION);
+export const MAIL_FETCH_BY_UID_CAPABILITY_REF = buildConnectorCapabilityRef(MAIL_ADAPTER_KIND, IMAP_FETCH_BY_UID_ACTION);
+export const MAIL_SEARCH_CAPABILITY_REF = buildConnectorCapabilityRef(MAIL_ADAPTER_KIND, IMAP_SEARCH_ACTION);
+export const MAIL_MARK_CAPABILITY_REF = buildConnectorCapabilityRef(MAIL_ADAPTER_KIND, IMAP_MARK_ACTION);
+export const imapFetchAction = makeFetchAction(createImapClient);
+export const imapFetchByUidAction = makeFetchByUidAction(createImapClient);
+export const imapSearchAction = makeSearchAction(createImapClient);
+export const imapMarkAction = makeMarkAction(createImapClient);
+const onboarding = {
+    provider: PROVIDER_SLUG,
+    displayName: 'IMAP (generic)',
+    description: 'Fetch mail from any IMAP server. Each connection carries its own host/port/username/password wallet — no shared app credential.',
+    iconName: 'Mail',
+    kind: ConnectorOnboardingKind.CREDENTIALS,
+    supportedProjectBindingAdapterKinds: [],
+    fields: [
+        {
+            key: 'host',
+            label: 'IMAP host',
+            type: CredentialFieldType.TEXT,
+            required: true,
+            isSecret: false,
+            placeholder: 'imap.example.com',
+            transform: CredentialFieldTransform.TRIM,
+        },
+        {
+            key: 'port',
+            label: 'Port',
+            type: CredentialFieldType.TEXT,
+            required: true,
+            isSecret: false,
+            placeholder: '993',
+            transform: CredentialFieldTransform.TRIM,
+        },
+        {
+            key: 'username',
+            label: 'Username',
+            type: CredentialFieldType.TEXT,
+            required: true,
+            isSecret: false,
+            transform: CredentialFieldTransform.TRIM,
+        },
+        {
+            key: 'password',
+            label: 'Password',
+            type: CredentialFieldType.PASSWORD,
+            required: true,
+            isSecret: true,
+            transform: CredentialFieldTransform.TRIM,
+        },
+        {
+            key: 'tlsMode',
+            label: 'TLS mode',
+            type: CredentialFieldType.TEXT,
+            required: false,
+            isSecret: false,
+            placeholder: 'auto | tls | starttls | plain',
+            hint: 'Leave as auto to pick TLS by port (993 → implicit TLS).',
+            transform: CredentialFieldTransform.TRIM,
+        },
+    ],
+    hint: 'Enter the mailbox IMAP settings. Xema fetches mail on your behalf using this wallet.',
+};
+export const imapProvider = defineConnectorAdapter({
+    adapterKind: MAIL_ADAPTER_KIND,
+    provider: PROVIDER_SLUG,
+    displayName: 'IMAP (generic)',
+    credentialKind: CredentialKind.ImapAuth,
+    resources: {},
+    actions: {
+        [IMAP_FETCH_ACTION]: imapFetchAction,
+        [IMAP_FETCH_BY_UID_ACTION]: imapFetchByUidAction,
+        [IMAP_SEARCH_ACTION]: imapSearchAction,
+        [IMAP_MARK_ACTION]: imapMarkAction,
+    },
+    onboarding,
+});
+const connectorAdapters = [imapProvider];
+export default connectorAdapters;
+export const providerDescriptor = {
+    providerKey: PROVIDER_SLUG,
+    displayName: 'IMAP (generic)',
+    description: 'Generic IMAP fetching authority. appAuthKind None — every connection carries its own mailbox wallet.',
+    iconName: 'Mail',
+    category: 'Email',
+    appAuthKind: ProviderAppAuthKind.None,
+    origin: ProviderOrigin.Biome,
+    allowOrgOverride: false,
+    appCredentialSchema: [],
+};
+export const connectorDescriptors = [
+    {
+        connectorKey: CONNECTOR_KEY,
+        displayName: 'IMAP (generic)',
+        description: 'Inbound mail fetch from a generic IMAP server.',
+        iconName: 'Mail',
+        providerKey: PROVIDER_SLUG,
+        scopes: [],
+        connectionCredentialKind: CredentialKind.ImapAuth,
+        adapterKind: MAIL_ADAPTER_KIND,
+        operations: [
+            {
+                capabilityRef: MAIL_FETCH_CAPABILITY_REF,
+                adapterKind: ConnectorAdapterKind.NativeProvider,
+                scopes: [],
+                requiresConnection: true,
+            },
+            {
+                capabilityRef: MAIL_FETCH_BY_UID_CAPABILITY_REF,
+                adapterKind: ConnectorAdapterKind.NativeProvider,
+                scopes: [],
+                requiresConnection: true,
+            },
+            {
+                capabilityRef: MAIL_SEARCH_CAPABILITY_REF,
+                adapterKind: ConnectorAdapterKind.NativeProvider,
+                scopes: [],
+                requiresConnection: true,
+            },
+            {
+                capabilityRef: MAIL_MARK_CAPABILITY_REF,
+                adapterKind: ConnectorAdapterKind.NativeProvider,
+                scopes: [],
+                requiresConnection: true,
+            },
+        ],
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/connector-adapters/index.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@xemahq/biomes-platform-imap",
+  "version": "0.1.0",
+  "license": "LicenseRef-Xema-BSL-1.1",
+  "type": "module",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "main": "dist/connector-adapters/index.js",
+  "files": [
+    "dist",
+    "xema-biome.json",
+    "contributions"
+  ],
+  "exports": {
+    "./connector-adapters": {
+      "types": "./dist/connector-adapters/index.d.ts",
+      "default": "./dist/connector-adapters/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@xemahq/biome-sdk": "^3.0.0",
+    "@xemahq/kernel-contracts": "^5.1.0",
+    "imapflow": "^1.0.180"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.3",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test ./tests/**/*.test.mjs"
+  }
+}

package/xema-biome.json

@@ -0,0 +1,121 @@
+{
+  "name": "@xemahq/biomes-platform-imap",
+  "version": "0.1.0",
+  "xema": {
+    "id": "connector-imap",
+    "displayName": "IMAP Connector",
+    "display": {
+      "icon": "mail",
+      "category": "connect",
+      "summary": "IMAP connector — fetch, search, and flag inbound mail from a generic IMAP mailbox into Xema via the connector gateway."
+    },
+    "description": "First-party connector biome that ships vendor-neutral inbound IMAP fetch as a contributed ConnectorAdapterModule. Fetch-only over IMAP polling (no inbound webhook): it contributes three actions — `fetch` (fetch-since-marker with UIDVALIDITY-reset detection), `search`, and `mark` — projected as native-provider capabilities `connector:mail.fetch@1` / `connector:mail.search@1` / `connector:mail.mark@1`, dispatched THROUGH the connector-gateway native-action executor (the P2 seam). Owns the `imapflow` SDK (quarantined to `connector-adapters/**`). The durable IMAP cursor STORE stays the platform `imap-markers` capability the caller owns; connections authenticate with their own curated `imap_auth` wallet.",
+    "scope": "platform",
+    "target": "server",
+    "bundleSource": {
+      "kind": "npm",
+      "name": "@xemahq/biomes-platform-imap",
+      "version": "0.1.0"
+    },
+    "trustTier": "first-party",
+    "connectorRequirements": [
+      {
+        "adapterKind": "mail",
+        "purpose": "Inbound mail fetch / search / flag over a generic IMAP mailbox",
+        "capabilities": [
+          "mail.fetch",
+          "mail.search",
+          "mail.mark"
+        ]
+      }
+    ],
+    "components": [
+      {
+        "key": "connector-adapter",
+        "kind": "adapter",
+        "artifact": {
+          "kind": "host-module",
+          "path": "dist/connector-adapters/index.js"
+        },
+        "entrypoint": {
+          "kind": "module-export",
+          "module": "dist/connector-adapters/index.js",
+          "exportName": "default"
+        },
+        "protocol": {
+          "kind": "adapter",
+          "revision": "v1"
+        },
+        "hostAbi": {
+          "name": "xema-adapter-host",
+          "versionRange": "^1"
+        },
+        "executionModes": [
+          "shared-host",
+          "isolated"
+        ],
+        "requirements": {
+          "tenancy": {
+            "allowed": [
+              "org",
+              "project"
+            ],
+            "tenantContext": "verified"
+          },
+          "isolation": {
+            "minimum": "none"
+          },
+          "trust": {
+            "minimum": "verified"
+          },
+          "locality": {
+            "allowed": [
+              "cloud",
+              "customer-private"
+            ]
+          },
+          "state": {
+            "kind": "stateless"
+          },
+          "resources": {
+            "minimum": {
+              "cpu": "100m",
+              "memory": "64Mi",
+              "ephemeralStorage": "64Mi"
+            }
+          },
+          "runtime": {
+            "kind": "node",
+            "versionRange": ">=22 <25"
+          },
+          "io": {
+            "ingress": "none",
+            "egress": "internet",
+            "rawBody": false,
+            "devices": []
+          },
+          "scaling": {
+            "mode": "horizontal",
+            "concurrency": {
+              "handling": "parallel",
+              "maximumPerInstance": 16
+            },
+            "readiness": {
+              "kind": "protocol",
+              "initialDelaySeconds": 0
+            },
+            "drain": {
+              "kind": "graceful",
+              "maximumSeconds": 30
+            },
+            "hints": {
+              "cpu": "latency",
+              "memory": "steady",
+              "startup": "fast"
+            }
+          }
+        }
+      }
+    ]
+  }
+}