@elizaos/plugin-imessage 2.0.3-beta.2 → 2.0.3-beta.3

package/dist/rpc.js

@@ -0,0 +1,393 @@
+import { spawn } from "node:child_process";
+import { homedir } from "node:os";
+import { resolve as resolvePath } from "node:path";
+import { createInterface } from "node:readline";
+/**
+ * Default probe timeout in milliseconds
+ */
+export const DEFAULT_PROBE_TIMEOUT_MS = 5000;
+/**
+ * Default request timeout in milliseconds
+ */
+export const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+/**
+ * Resolves a path with ~ expansion
+ */
+function resolveUserPath(path) {
+    if (path.startsWith("~/")) {
+        return resolvePath(homedir(), path.slice(2));
+    }
+    return resolvePath(path);
+}
+/**
+ * iMessage RPC client for communicating with the imsg CLI tool
+ */
+export class IMessageRpcClient {
+    cliPath;
+    dbPath;
+    onNotification;
+    onError;
+    onClose;
+    pending = new Map();
+    closedPromise;
+    closedResolve = null;
+    child = null;
+    reader = null;
+    nextId = 1;
+    started = false;
+    constructor(opts = {}) {
+        this.cliPath = opts.cliPath?.trim() || "imsg";
+        this.dbPath = opts.dbPath?.trim() ? resolveUserPath(opts.dbPath) : undefined;
+        this.onNotification = opts.onNotification;
+        this.onError = opts.onError;
+        this.onClose = opts.onClose;
+        this.closedPromise = new Promise((resolve) => {
+            this.closedResolve = resolve;
+        });
+    }
+    /**
+     * Starts the RPC client by spawning the CLI process
+     */
+    async start() {
+        if (this.child) {
+            return;
+        }
+        const args = ["rpc"];
+        if (this.dbPath) {
+            args.push("--db", this.dbPath);
+        }
+        const child = spawn(this.cliPath, args, {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.child = child;
+        this.started = true;
+        this.reader = createInterface({ input: child.stdout });
+        this.reader.on("line", (line) => {
+            const trimmed = line.trim();
+            if (!trimmed) {
+                return;
+            }
+            this.handleLine(trimmed);
+        });
+        child.stderr.on("data", (chunk) => {
+            const lines = chunk.toString().split(/\r?\n/);
+            for (const line of lines) {
+                if (!line.trim()) {
+                    continue;
+                }
+                this.onError?.(new Error(`imsg rpc stderr: ${line.trim()}`));
+            }
+        });
+        child.on("error", (err) => {
+            this.failAll(err instanceof Error ? err : new Error(String(err)));
+            this.onError?.(err instanceof Error ? err : new Error(String(err)));
+            this.closedResolve?.();
+        });
+        child.on("close", (code, signal) => {
+            if (code !== 0 && code !== null) {
+                const reason = signal ? `signal ${signal}` : `code ${code}`;
+                this.failAll(new Error(`imsg rpc exited (${reason})`));
+            }
+            else {
+                this.failAll(new Error("imsg rpc closed"));
+            }
+            this.onClose?.(code, signal);
+            this.closedResolve?.();
+        });
+    }
+    /**
+     * Stops the RPC client
+     */
+    async stop() {
+        if (!this.child) {
+            return;
+        }
+        this.reader?.close();
+        this.reader = null;
+        this.child.stdin.end();
+        const child = this.child;
+        this.child = null;
+        await Promise.race([
+            this.closedPromise,
+            new Promise((resolve) => {
+                setTimeout(() => {
+                    if (!child.killed) {
+                        child.kill("SIGTERM");
+                    }
+                    resolve();
+                }, 500);
+            }),
+        ]);
+    }
+    /**
+     * Waits for the RPC client to close
+     */
+    async waitForClose() {
+        await this.closedPromise;
+    }
+    /**
+     * Checks if the client is running
+     */
+    isRunning() {
+        return this.child !== null && this.started;
+    }
+    /**
+     * Makes an RPC request
+     */
+    async request(method, params, opts) {
+        if (!this.child?.stdin) {
+            throw new Error("imsg rpc not running");
+        }
+        const id = this.nextId++;
+        const payload = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            params: params ?? {},
+        };
+        const line = `${JSON.stringify(payload)}\n`;
+        const timeoutMs = opts?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        const response = new Promise((resolve, reject) => {
+            const key = String(id);
+            const timer = timeoutMs > 0
+                ? setTimeout(() => {
+                    this.pending.delete(key);
+                    reject(new Error(`imsg rpc timeout (${method})`));
+                }, timeoutMs)
+                : undefined;
+            this.pending.set(key, {
+                resolve: (value) => resolve(value),
+                reject,
+                timer,
+            });
+        });
+        this.child.stdin.write(line);
+        return await response;
+    }
+    /**
+     * Handles an incoming line from the RPC process
+     */
+    handleLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            this.onError?.(new Error(`imsg rpc: failed to parse ${line}: ${detail}`));
+            return;
+        }
+        // Handle response with ID
+        if (parsed.id !== undefined && parsed.id !== null) {
+            const key = String(parsed.id);
+            const pending = this.pending.get(key);
+            if (!pending) {
+                return;
+            }
+            if (pending.timer) {
+                clearTimeout(pending.timer);
+            }
+            this.pending.delete(key);
+            if (parsed.error) {
+                const baseMessage = parsed.error.message ?? "imsg rpc error";
+                const details = parsed.error.data;
+                const code = parsed.error.code;
+                const suffixes = [];
+                if (typeof code === "number") {
+                    suffixes.push(`code=${code}`);
+                }
+                if (details !== undefined) {
+                    const detailText = typeof details === "string" ? details : JSON.stringify(details, null, 2);
+                    if (detailText) {
+                        suffixes.push(detailText);
+                    }
+                }
+                const msg = suffixes.length > 0 ? `${baseMessage}: ${suffixes.join(" ")}` : baseMessage;
+                pending.reject(new Error(msg));
+                return;
+            }
+            pending.resolve(parsed.result);
+            return;
+        }
+        // Handle notification
+        if (parsed.method) {
+            this.onNotification?.({
+                method: parsed.method,
+                params: parsed.params,
+            });
+        }
+    }
+    /**
+     * Fails all pending requests
+     */
+    failAll(err) {
+        for (const [key, pending] of this.pending.entries()) {
+            if (pending.timer) {
+                clearTimeout(pending.timer);
+            }
+            pending.reject(err);
+            this.pending.delete(key);
+        }
+    }
+}
+/**
+ * Creates and starts an iMessage RPC client
+ */
+export async function createIMessageRpcClient(opts = {}) {
+    const client = new IMessageRpcClient(opts);
+    await client.start();
+    return client;
+}
+/**
+ * Probes the iMessage RPC to check connectivity
+ */
+export async function probeIMessageRpc(params) {
+    const client = new IMessageRpcClient({
+        cliPath: params.cliPath,
+        dbPath: params.dbPath,
+    });
+    try {
+        await client.start();
+        await client.request("chats.list", { limit: 1 }, {
+            timeoutMs: params.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS,
+        });
+        await client.stop();
+        return { ok: true };
+    }
+    catch (err) {
+        await client.stop().catch(() => { });
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Lists all contacts via iMessage RPC
+ */
+export async function listContacts(_client) {
+    throw new Error("imsg RPC does not expose contacts");
+}
+/**
+ * Lists all chats via iMessage RPC
+ */
+export async function listChats(client, params = {}) {
+    const response = await client.request("chats.list", {
+        limit: params.limit ?? 20,
+    });
+    const chats = Array.isArray(response.chats) ? response.chats : [];
+    return chats.map((chat) => {
+        const participants = Array.isArray(chat.participants)
+            ? chat.participants.filter((entry) => typeof entry === "string" && entry.trim().length > 0)
+            : [];
+        const lastMessageAt = typeof chat.last_message_at === "string" ? Date.parse(chat.last_message_at) : Number.NaN;
+        return {
+            id: typeof chat.id === "string" || typeof chat.id === "number" ? String(chat.id) : "",
+            chatIdentifier: typeof chat.identifier === "string" ? chat.identifier : "",
+            guid: typeof chat.guid === "string" ? chat.guid : undefined,
+            displayName: typeof chat.name === "string" && chat.name.trim().length > 0 ? chat.name.trim() : undefined,
+            isGroup: Boolean(chat.is_group),
+            participants,
+            service: typeof chat.service === "string" ? chat.service : undefined,
+            lastMessageDate: Number.isFinite(lastMessageAt) ? lastMessageAt : undefined,
+        };
+    });
+}
+/**
+ * Gets recent messages from a chat
+ */
+export async function getMessages(client, params) {
+    const chatId = typeof params.chatId === "number" ? params.chatId : Number.parseInt(String(params.chatId), 10);
+    if (!Number.isFinite(chatId)) {
+        throw new Error("chatId must be numeric for imsg history requests");
+    }
+    const response = await client.request("messages.history", {
+        chat_id: chatId,
+        limit: params.limit,
+        attachments: params.attachments,
+        participants: params.participants,
+        start: params.start,
+        end: params.end,
+    });
+    const messages = Array.isArray(response.messages) ? response.messages : [];
+    return messages.map((message) => {
+        const createdAt = typeof message.created_at === "string" ? Date.parse(message.created_at) : Number.NaN;
+        const deliveredAt = typeof message.date_delivered === "string" ? Date.parse(message.date_delivered) : Number.NaN;
+        const readAt = typeof message.date_read === "string" ? Date.parse(message.date_read) : Number.NaN;
+        const attachments = Array.isArray(message.attachments)
+            ? message.attachments.reduce((acc, attachment) => {
+                if (!attachment || typeof attachment !== "object") {
+                    return acc;
+                }
+                const raw = attachment;
+                acc.push({
+                    id: typeof raw.filename === "string" && raw.filename.trim().length > 0
+                        ? raw.filename.trim()
+                        : typeof raw.original_path === "string"
+                            ? raw.original_path
+                            : "",
+                    filename: typeof raw.filename === "string" ? raw.filename : undefined,
+                    mimeType: typeof raw.mime_type === "string" ? raw.mime_type : undefined,
+                    path: typeof raw.original_path === "string" ? raw.original_path : undefined,
+                    size: typeof raw.total_bytes === "number"
+                        ? raw.total_bytes
+                        : typeof raw.total_bytes === "string"
+                            ? Number.parseInt(raw.total_bytes, 10)
+                            : undefined,
+                });
+                return acc;
+            }, [])
+            : [];
+        return {
+            id: typeof message.id === "string" || typeof message.id === "number" ? String(message.id) : "",
+            chatId: typeof message.chat_id === "string" || typeof message.chat_id === "number"
+                ? String(message.chat_id)
+                : "",
+            guid: typeof message.guid === "string" ? message.guid : undefined,
+            text: typeof message.text === "string" ? message.text : "",
+            sender: typeof message.sender === "string" ? message.sender : "",
+            isFromMe: Boolean(message.is_from_me),
+            date: Number.isFinite(createdAt) ? createdAt : 0,
+            dateRead: Number.isFinite(readAt) ? readAt : undefined,
+            dateDelivered: Number.isFinite(deliveredAt) ? deliveredAt : undefined,
+            attachments,
+        };
+    });
+}
+/**
+ * Sends a message via iMessage RPC
+ */
+export async function sendIMessageRpc(client, params) {
+    const file = Array.isArray(params.attachments) && params.attachments.length > 0
+        ? params.attachments[0]
+        : undefined;
+    const service = params.service === "iMessage" ? "imessage" : params.service === "SMS" ? "sms" : "auto";
+    const result = await client.request("send", {
+        to: params.to,
+        text: params.text,
+        file,
+        service,
+        chat_id: params.chatId,
+        chat_identifier: params.chatIdentifier,
+        chat_guid: params.chatGuid,
+    });
+    return { ok: result.ok !== false };
+}
+/**
+ * Gets chat info via iMessage RPC
+ */
+export async function getChatInfo(client, params) {
+    const chats = await listChats(client, { limit: 100 });
+    return (chats.find((chat) => chat.id === params.chatId ||
+        chat.chatIdentifier === params.chatId ||
+        chat.guid === params.chatId) ?? null);
+}
+/**
+ * Gets contact info via iMessage RPC
+ */
+export async function getContactInfo(client, params) {
+    void client;
+    void params;
+    throw new Error("imsg RPC does not expose contacts");
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/dist/service.d.ts

@@ -0,0 +1,264 @@
+/**
+ * iMessage service implementation for elizaOS.
+ */
+import { type IAgentRuntime, Service } from "@elizaos/core";
+import { type ChatDbMessage } from "./chatdb-reader.js";
+import { type ContactPatch, type ContactsMap, type FullContact, type NewContactInput } from "./contacts-reader.js";
+import { type IIMessageService, type IMessageChat, type IMessageListMessagesOptions, type IMessageMessage, type IMessageSendOptions, type IMessageSendResult, type IMessageServiceStatus, type IMessageSettings } from "./types.js";
+/**
+ * iMessage service for Eliza agents.
+ * Note: This only works on macOS.
+ */
+export declare class IMessageService extends Service implements IIMessageService {
+    static serviceType: string;
+    capabilityDescription: string;
+    private settings;
+    private connected;
+    private pollInterval;
+    /**
+     * Highest `message.ROWID` we've already dispatched to the agent. The
+     * polling loop asks chat.db for rows strictly greater than this value,
+     * then advances the cursor to the largest row it actually processed.
+     * Initialized to 0 on start; bumped on every successful dispatch so
+     * we skip backlog on a fresh launch without ever double-delivering.
+     */
+    private lastRowId;
+    /**
+     * Reentrancy gate for the polling loop. Dispatch calls
+     * `messageService.handleMessage` which invokes the LLM and typically
+     * takes several seconds per message. With a 2-second poll interval
+     * that means multiple ticks can land on top of each other, each
+     * seeing the same stale cursor and re-dispatching the same rows.
+     * This flag ensures at most one poll is in flight at a time; ticks
+     * that arrive while a poll is active are dropped (the next scheduled
+     * tick will pick up where the current one left off).
+     */
+    private pollInFlight;
+    /**
+     * Room keys we've already emitted a WORLD_JOINED event for in this
+     * service lifetime. Not persisted — on restart every room is
+     * re-greeted, which is correct: a fresh Eliza process doesn't know
+     * what previous processes already synced, and the bootstrap plugin's
+     * WORLD_JOINED handler is idempotent (handleServerSync tolerates
+     * already-known rooms via upsert semantics).
+     */
+    private seenWorlds;
+    /**
+     * Entity keys we've already emitted an ENTITY_JOINED event for.
+     * Same lifetime + rationale as seenWorlds.
+     */
+    private seenEntities;
+    /**
+     * Live chat.db handle, bound to the lifetime of this service. Non-null
+     * means inbound polling is active. Null means either (a) not running
+     * under Bun, or (b) chat.db couldn't be opened — in both cases the
+     * service remains send-only and logs a one-time warning on start.
+     */
+    private chatDb;
+    private chatDbPath;
+    /**
+     * Cached handle → display name map from the user's Apple Contacts.
+     * Populated lazily on first inbound message through CNContactStore, NOT at
+     * service start. Loading at boot would create a settings-level Contacts
+     * dependency at app launch, even though the user may never receive an
+     * inbound iMessage. We defer the read until the first message that actually
+     * needs handle→name resolution. Empty map means either the user hasn't
+     * authorized Contacts access yet, the address book is empty, or no inbound
+     * message has triggered the lazy load yet.
+     */
+    private contacts;
+    /** Whether the lazy contact load has been attempted this session. */
+    private contactsLoadAttempted;
+    /**
+     * Start the iMessage service.
+     */
+    static start(runtime: IAgentRuntime): Promise<IMessageService>;
+    static registerSendHandlers(runtime: IAgentRuntime, service: IMessageService): void;
+    /**
+     * Stop the iMessage service.
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the service is connected.
+     */
+    isConnected(): boolean;
+    getStatus(): IMessageServiceStatus;
+    /**
+     * Check if running on macOS.
+     */
+    isMacOS(): boolean;
+    /**
+     * Send a message via iMessage.
+     */
+    sendMessage(to: string, text: string, options?: IMessageSendOptions): Promise<IMessageSendResult>;
+    /**
+     * Get recent messages by reading chat.db. Returns the most recent
+     * `limit` messages (any sender, any chat) in chronological order.
+     *
+     * Returns an empty array if the chat.db reader is unavailable (plugin
+     * running under plain Node without bun:sqlite, or Full Disk Access not
+     * granted, etc.).
+     */
+    getRecentMessages(limit?: number): Promise<IMessageMessage[]>;
+    /**
+     * Return the newest messages in chronological order, optionally scoped
+     * to a single chat identifier. Returns an empty array if chat.db is not
+     * available and the connector is currently running in send-only mode.
+     */
+    getMessages(options?: IMessageListMessagesOptions): Promise<IMessageMessage[]>;
+    /**
+     * List every chat the Messages.app database knows about, joined with
+     * participant handles. Returns an empty list if the chat.db reader is
+     * unavailable (Node runtime, missing FDA, etc.).
+     *
+     * Previously this method used an AppleScript query against
+     * Messages.app's `chats` collection. That verb works but is slow and
+     * returns a coarser view (no participant handles, no style field), so
+     * the chat.db path is strictly better when it's available.
+     */
+    getChats(): Promise<IMessageChat[]>;
+    /**
+     * Get current settings.
+     */
+    getSettings(): IMessageSettings | null;
+    /**
+     * Get the cached Apple Contacts map, if lazy loading has happened.
+     *
+     * Keys are normalized handles (phones in digits-only + optional leading `+`,
+     * emails lowercased). Values carry the contact's display name.
+     *
+     * Exposed for providers that want to inject contact lookups into agent
+     * state so the LLM can resolve a person's name ("text Shaw") to a handle
+     * it can pass to `sendMessage`.
+     *
+     * Returns an empty map if Contacts access was denied, failed to load,
+     * or the service hasn't finished starting.
+     */
+    getContacts(): ContactsMap;
+    /**
+     * Lazy-load the Apple Contacts map on first call. Subsequent calls
+     * are no-ops. We split this out from `start()` so Contacts permission
+     * pressure only appears when the runtime actually needs handle→name
+     * resolution, instead of at app launch. Failure is non-fatal; the cached
+     * map stays empty and the service falls back to raw handles.
+     */
+    private ensureContactsLoaded;
+    private recordContactsPermissionBlock;
+    /**
+     * List every contact in the user's address book as a full record with
+     * id, name, and all phones/emails. Delegates to contacts-reader's
+     * `listAllContacts` which uses CNContactStore. Returns `[]` on failure
+     * (permission denied, etc.).
+     */
+    listAllContacts(): Promise<FullContact[]>;
+    /**
+     * Create a new Apple Contacts record. Requires the Contacts privacy grant.
+     * Returns the new person's id on success, or null on failure.
+     *
+     * After a successful create we refresh the cached handle→name map so
+     * inbound messages from the new contact resolve to their name on the
+     * very next poll, without requiring a service restart.
+     */
+    addContact(input: NewContactInput): Promise<string | null>;
+    /**
+     * Patch an existing contact (name fields, add/remove phones, add/remove
+     * emails). Returns true on success, false on failure. Refreshes the
+     * cached map on success so name resolution reflects the change.
+     */
+    updateContact(personId: string, patch: ContactPatch): Promise<boolean>;
+    /**
+     * Delete a contact by Apple Contacts id. Returns true on success, false on
+     * failure. Refreshes the cached map on success.
+     */
+    deleteContact(personId: string): Promise<boolean>;
+    private loadSettings;
+    private validateSettings;
+    private sendSingleMessage;
+    private sendViaCli;
+    private sendViaAppleScript;
+    private runAppleScript;
+    private startPolling;
+    /**
+     * Poll chat.db for rows newer than the cursor and route each inbound
+     * message through the agent's message pipeline.
+     *
+     * Flow per message:
+     *   1. Read new rows from chat.db via the bun:sqlite reader.
+     *   2. Skip outbound (is_from_me=1), already-seen, and policy-denied rows.
+     *   3. Build a Memory object in the shape the bootstrap plugin expects.
+     *   4. Ensure the entity + room + world exist via ensureConnection.
+     *   5. Call runtime.messageService.handleMessage with a callback that
+     *      sends the agent's reply back through sendViaAppleScript.
+     *   6. Also emit the plugin-namespaced IMESSAGE_MESSAGE_RECEIVED event
+     *      and the core EventType.MESSAGE_RECEIVED event for any listeners.
+     *
+     * Advances this.lastRowId unconditionally to the max rowId we saw in
+     * this batch — even for skipped rows — so the cursor keeps moving
+     * forward and we never get stuck re-reading the same row on every poll.
+     */
+    private pollForNewMessages;
+    private pollForNewMessagesInner;
+    /**
+     * Turn a single chat.db row into a `Memory`, wire up a reply callback,
+     * and hand the whole thing to `runtime.messageService.handleMessage`.
+     *
+     * Mirrors the shape used by @elizaos/plugin-telegram so the bootstrap
+     * plugin's message pipeline picks up inbound iMessages the same way it
+     * picks up Telegram messages — same entity/room/world creation, same
+     * `source: "imessage"` tag on content, same HandlerCallback signature
+     * for the reply path.
+     */
+    private dispatchInboundMessage;
+    /**
+     * Handle non-conversational chat.db rows — reactions, group events,
+     * anything that isn't a normal text turn. These shouldn't flow through
+     * `messageService.handleMessage` (which would try to generate a reply)
+     * but they're still useful to surface as plugin-namespaced events so
+     * listeners can react, log, or update state.
+     *
+     * Emits two events:
+     *   - A plugin-namespaced event on the existing `IMessageEventTypes`
+     *     enum (e.g. `IMESSAGE_REACTION_RECEIVED`).
+     *   - The generic `EventType.REACTION_RECEIVED` from core when the
+     *     row is a reaction, so core-level handlers see it.
+     */
+    private emitAuxiliaryEvent;
+    private isAllowed;
+    /**
+     * Register a recurring heartbeat task with Eliza's task system and
+     * kick off one if it isn't already queued.
+     *
+     * The heartbeat runs once a minute (configurable via
+     * `IMESSAGE_HEARTBEAT_INTERVAL_MS`) and does a lightweight health
+     * probe: (a) chat.db reader is still open and responsive,
+     * (b) Contacts map still populated, (c) polling cursor is advancing
+     * when expected. On failure it logs + emits
+     * `IMESSAGE_HEARTBEAT_UNHEALTHY`; on success it emits
+     * `IMESSAGE_HEARTBEAT_OK`. Observers (Eliza's heartbeat UI, ops
+     * dashboards, trajectory logger) subscribe to these events.
+     *
+     * The task is tagged `["queue", "repeat", "imessage"]` so Eliza's
+     * built-in TaskService picks it up via its standard polling loop.
+     * Without `updateInterval` being set in metadata, the task fires
+     * once and then deletes; with it, the task service re-schedules.
+     */
+    private registerHeartbeat;
+}
+/**
+ * Convert a `ChatDbMessage` (the shape the bun:sqlite reader returns)
+ * into the public `IMessageMessage` shape exposed by this plugin's API.
+ * Exported so the test suite can exercise it in isolation without
+ * spinning up a full runtime + service instance.
+ */
+export declare function chatDbMessageToPublicShape(row: ChatDbMessage): IMessageMessage;
+/**
+ * Parse tab-delimited AppleScript messages output.
+ * Expected format per line: "id\ttext\tdate_sent\tis_from_me\tchat_identifier\tsender"
+ */
+export declare function parseMessagesFromAppleScript(result: string): IMessageMessage[];
+/**
+ * Parse tab-delimited AppleScript chats output.
+ * Expected format per line: "chat_identifier\tdisplay_name\tparticipant_count\tlast_message_date"
+ */
+export declare function parseChatsFromAppleScript(result: string): IMessageChat[];
+//# sourceMappingURL=service.d.ts.map