@dawnlit/outlook-bridge 1.0.0

package/dist/mac/read.js

@@ -0,0 +1,406 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readInboxEmails = readInboxEmails;
+exports.readEmailBody = readEmailBody;
+exports.searchInboxByFilter = searchInboxByFilter;
+exports.readSelectedEmail = readSelectedEmail;
+exports.openOutlookEmail = openOutlookEmail;
+// Reading mail on macOS: one folder, one item, a whole Inbox tree, or whatever
+// is selected in the running Outlook.
+//
+// Every reader here is two passes. Pass 1 indexes a folder with bulk property
+// reads (one Apple event each); pass 2 fetches the expensive fields — body,
+// attachments, sender — only for the messages that survived. Reading
+// per-message in a loop costs an event per property and is unusably slow on a
+// real mailbox, which is the whole reason for the shape.
+const run_1 = require("./run");
+const scripts_1 = require("./scripts");
+const mail_1 = require("../mail");
+const errors_1 = require("../errors");
+/** How much of a body readInboxEmails previews, matching the Windows reader. */
+const PREVIEW_CHARS = 600;
+/**
+ * Read recent messages for the given account, newest first.
+ *
+ * `entryId` here is Outlook for Mac's small integer message id (e.g. "779"), not
+ * the MAPI EntryID string Windows returns. The two are not interchangeable, so
+ * don't persist one and look it up on the other platform.
+ */
+async function readInboxEmails(emailAccount, daysBack = 60, limit = 50, folder) {
+    const days = Math.max(0, Math.floor(daysBack));
+    const cap = Math.max(0, Math.floor(limit));
+    if (cap === 0)
+        return [];
+    const ref = folder ? (0, mail_1.mailFolderRef)(folder) : { rootId: 6, rootLabel: 'Inbox', segments: [] };
+    // A folder argument that trims away to nothing ("\\", "  ") would otherwise
+    // read the Inbox root and look like it had scoped — the exact silent
+    // mis-scoping this parameter exists to prevent. Mirrors the Windows check.
+    if (folder && folder.trim() && ref.segments.length === 0 && ref.rootId === 6
+        && folder.trim().toLowerCase() !== 'inbox') {
+        throw new errors_1.NotFoundError('folder', `Folder '${folder}' does not name a folder under the Inbox.`);
+    }
+    const resolveScope = (0, scripts_1.mailScopeSnippet)(ref, folder || '');
+    const folderPath = (0, scripts_1.macFolderPath)(emailAccount, ref.rootLabel, ref.segments);
+    const isOutgoing = (0, mail_1.isOutgoingRoot)(ref.rootId);
+    // Pass 1 — index the folder. Folder order isn't documented, so sort here
+    // rather than trusting Outlook to hand back newest-first.
+    const indexScript = `tell application "Microsoft Outlook"
+${(0, scripts_1.accountLookupSnippet)(emailAccount)}
+${resolveScope}
+    set cutoff to (current date) - (${days} * days)
+    set idList to id of every message of scopeFolder
+    try
+        set timeList to ${(0, scripts_1.dateProperty)(ref.rootId)} of every message of scopeFolder
+    on error
+        set timeList to {}
+    end try
+    set hasTimes to ((count of timeList) is (count of idList))
+    set out to ""
+    repeat with i from 1 to (count of idList)
+        set d to missing value
+        if hasTimes then set d to item i of timeList
+        -- An item carrying no timestamp of its own (an unsent draft filed into a
+        -- mail folder) is skipped rather than crashing the walk, matching what the
+        -- Windows Restrict on the same property does with it.
+        if d is not missing value and d is greater than or equal to cutoff then
+            set out to out & (item i of idList as string) & tab & my isoDate(d) & linefeed
+        end if
+    end repeat
+    return out
+end tell`;
+    const index = (await (0, run_1.runOsaScript)(indexScript, 60000))
+        .split('\n')
+        .map(line => line.trim())
+        .filter(Boolean)
+        .map(line => {
+        const [id, receivedTime] = line.split('\t');
+        return { id, receivedTime: receivedTime || '' };
+    });
+    // 'yyyy-MM-dd HH:mm' is lexicographically ordered, so plain string compare sorts it.
+    index.sort((a, b) => b.receivedTime.localeCompare(a.receivedTime));
+    const chosen = index.slice(0, cap);
+    if (chosen.length === 0)
+        return [];
+    // Pass 2 — the expensive reads, only for messages we keep.
+    const detailScript = `tell application "Microsoft Outlook"
+    set wanted to {${chosen.map(c => c.id).join(', ')}}
+    set out to ""
+    repeat with k from 1 to (count of wanted)
+        set theMsg to missing value
+        try
+            set theMsg to message id (item k of wanted)
+        end try
+        if theMsg is not missing value then
+            set subj to ""
+            try
+                set subj to (subject of theMsg) as string
+            end try
+${isOutgoing ? (0, scripts_1.firstRecipientSnippet)('theMsg', '            ') : (0, scripts_1.senderSnippet)('theMsg', '            ')}
+            set bodyText to ""
+            try
+                set bodyText to (plain text content of theMsg) as string
+            end try
+            if (length of bodyText) > ${PREVIEW_CHARS} then set bodyText to text 1 thru ${PREVIEW_CHARS} of bodyText
+            set attNames to {}
+            try
+                set attNames to name of every attachment of theMsg
+            end try
+            set out to out & ${(0, run_1.asRow)([
+        '(id of theMsg as string)',
+        'subj',
+        'sndName',
+        'sndAddr',
+        'bodyText',
+        'my sanitizeList(attNames)',
+    ])}
+        end if
+    end repeat
+    return out
+end tell`;
+    const byId = new Map(chosen.map(c => [c.id, c.receivedTime]));
+    return (0, run_1.splitRecords)(await (0, run_1.runOsaScript)(detailScript, 120000)).map(record => {
+        const parts = (0, run_1.splitFields)(record);
+        const id = (0, run_1.field)(parts, 0);
+        const attachmentNames = (0, run_1.splitList)((0, run_1.field)(parts, 5));
+        return {
+            entryId: id,
+            storeId: '', // macOS AppleScript has no StoreID equivalent
+            subject: (0, run_1.field)(parts, 1).trim(),
+            senderName: (0, run_1.field)(parts, 2),
+            senderEmail: (0, run_1.field)(parts, 3),
+            receivedTime: byId.get(id) || '',
+            bodyPreview: (0, run_1.field)(parts, 4),
+            attachmentNames,
+            attachmentCount: attachmentNames.length,
+            folderPath,
+        };
+    });
+}
+/**
+ * Read one email's full plain-text body by message id.
+ *
+ * `storeId` is accepted for signature parity and ignored: macOS has no StoreID,
+ * and `message id N` resolves against the application rather than one folder, so
+ * the message is found wherever it currently sits — including a subfolder.
+ *
+ * Uses `plain text content`, matching the Windows reader's use of `.Body`: the
+ * same tradeoff applies, so an HTML table's rows flatten and tabular figures are
+ * better read from an attachment.
+ */
+async function readEmailBody(entryId, _storeId, maxChars = 8000, includeQuoted = false) {
+    const id = (0, scripts_1.macMessageId)(entryId);
+    const script = `tell application "Microsoft Outlook"
+${(0, scripts_1.messageLookupSnippet)(id)}
+${(0, scripts_1.messageDetailSnippet)(true)}
+    return ${(0, run_1.asRow)((0, scripts_1.messageDetailFields)(true))}
+end tell`;
+    // The body is emitted LAST so a stray separator in earlier fields can't shift it.
+    const parts = (0, run_1.summaryFields)(await (0, run_1.runOsaScript)(script, 60000));
+    const attachmentNames = (0, run_1.splitList)((0, run_1.field)(parts, scripts_1.MessageDetail.attachmentNames));
+    const { body, quoted, separator } = (0, mail_1.splitQuotedOriginal)((0, run_1.field)(parts, scripts_1.MessageDetail.body));
+    // The quoted thread is context, never the priced content, so it is capped
+    // harder than the reply itself — matching the Windows reader.
+    const quotedCap = Math.min(maxChars, 4000);
+    return {
+        entryId: (0, run_1.field)(parts, scripts_1.MessageDetail.id) || id,
+        subject: (0, run_1.field)(parts, scripts_1.MessageDetail.subject).trim(),
+        senderName: (0, run_1.field)(parts, scripts_1.MessageDetail.senderName),
+        senderEmail: (0, run_1.field)(parts, scripts_1.MessageDetail.senderEmail),
+        receivedTime: (0, run_1.field)(parts, scripts_1.MessageDetail.receivedTime),
+        body: body.length > maxChars ? body.slice(0, maxChars) : body,
+        truncated: body.length > maxChars,
+        bodyLength: body.length,
+        quoteSeparator: separator,
+        quotedLength: quoted.length,
+        quotedOriginal: includeQuoted ? quoted.slice(0, quotedCap) : '',
+        attachmentNames,
+        attachmentCount: attachmentNames.length,
+    };
+}
+/**
+ * Translate a Restrict-style `like` pattern to a regex.
+ *
+ * Windows hands `subjectLike` to Outlook's server-side Restrict; AppleScript has
+ * no equivalent, so the same pattern is applied here instead. `%` and `*` are
+ * the any-run wildcards, `_` and `?` match one character, and the match is
+ * anchored because that is what SQL `like` means.
+ */
+function likePattern(pattern) {
+    let source = '';
+    for (const ch of pattern) {
+        if (ch === '%' || ch === '*')
+            source += '.*';
+        else if (ch === '_' || ch === '?')
+            source += '.';
+        else
+            source += ch.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    return new RegExp(`^${source}$`, 'i');
+}
+/**
+ * Walk every folder under the Inbox (recursively) for one account and return the
+ * emails matching `filter` — full body included, attachments listed by name but
+ * not saved.
+ *
+ * The filtering happens here rather than in Outlook: `Items.Restrict` is a COM
+ * facility with no AppleScript counterpart, so the folder walk indexes each
+ * folder in two bulk reads and the subject/date tests run on the index. The
+ * observable contract is the same; the cost profile is not, and a `daysBack` of
+ * 0 over a large mailbox tree is correspondingly heavier here.
+ *
+ * `subjectPattern` is applied case-insensitively regardless of the RegExp's own
+ * flags, matching PowerShell's `-match`.
+ */
+async function searchInboxByFilter(emailAccount, filter = {}, daysBack = 0) {
+    const days = Math.max(0, Math.floor(daysBack));
+    // Pass 1 — index every folder under the Inbox: path, id, subject, received.
+    const indexScript = `on scanFolder(theFolder, prefix, cutoff, useCutoff)
+    set out to ""
+    tell application "Microsoft Outlook"
+        set idList to id of every message of theFolder
+        set subjList to subject of every message of theFolder
+        try
+            set timeList to time received of every message of theFolder
+        on error
+            set timeList to {}
+        end try
+        set subs to mail folders of theFolder
+    end tell
+    set hasTimes to ((count of timeList) is (count of idList))
+    repeat with i from 1 to (count of idList)
+        set d to missing value
+        if hasTimes then set d to item i of timeList
+        set keep to true
+        if d is missing value then
+            -- A folder whose items carry no readable receive time can only be
+            -- included when the caller isn't bounding by date; silently dropping
+            -- it would look exactly like an empty folder.
+            set keep to not useCutoff
+        else if useCutoff and d is less than cutoff then
+            set keep to false
+        end if
+        if keep then
+            set out to out & ${(0, run_1.asRow)([
+        'prefix',
+        '(item i of idList as string)',
+        '(item i of subjList)',
+        'my isoDate(d)',
+    ])}
+        end if
+    end repeat
+    repeat with f in subs
+        set childName to ""
+        try
+            set childName to (name of f) as string
+        end try
+        set out to out & my scanFolder(f, prefix & ${run_1.AS_LIST_SEP} & childName, cutoff, useCutoff)
+    end repeat
+    return out
+end scanFolder
+
+tell application "Microsoft Outlook"
+${(0, scripts_1.accountLookupSnippet)(emailAccount)}
+    set rootInbox to inbox of targetAcct
+    set rootName to (name of rootInbox) as string
+end tell
+set cutoff to (current date) - (${days} * days)
+return my scanFolder(rootInbox, rootName, cutoff, ${days > 0 ? 'true' : 'false'})`;
+    const likeRe = filter.subjectLike ? likePattern(filter.subjectLike) : null;
+    // PowerShell's -match is case-insensitive by default, so the pattern is
+    // rebuilt with `i` regardless of the flags the caller's RegExp carries.
+    const patternRe = filter.subjectPattern
+        ? new RegExp(filter.subjectPattern.source, 'i')
+        : null;
+    const candidates = (0, run_1.splitRecords)(await (0, run_1.runOsaScript)(indexScript, 300000))
+        .map(record => {
+        const parts = (0, run_1.splitFields)(record);
+        const segments = (0, run_1.splitList)((0, run_1.field)(parts, 0));
+        return {
+            folderPath: (0, scripts_1.macFolderPath)(emailAccount, segments[0] || 'Inbox', segments.slice(1)),
+            id: (0, run_1.field)(parts, 1),
+            subject: (0, run_1.field)(parts, 2).trim(),
+            receivedTime: (0, run_1.field)(parts, 3),
+        };
+    })
+        .filter(candidate => {
+        if (!candidate.subject)
+            return false;
+        if (likeRe && !likeRe.test(candidate.subject))
+            return false;
+        if (patternRe && !patternRe.test(candidate.subject))
+            return false;
+        if (filter.excludeReplies && /^(re|fwd?)\s*:/i.test(candidate.subject))
+            return false;
+        return true;
+    });
+    if (candidates.length === 0)
+        return [];
+    // Pass 2 — bodies, senders and attachment names for the survivors only.
+    const detailScript = `tell application "Microsoft Outlook"
+    set wanted to {${candidates.map(c => c.id).join(', ')}}
+    set out to ""
+    repeat with k from 1 to (count of wanted)
+        set theMsg to missing value
+        try
+            set theMsg to message id (item k of wanted)
+        end try
+        if theMsg is not missing value then
+${(0, scripts_1.senderSnippet)('theMsg', '            ')}
+            set attNames to {}
+            try
+                set attNames to name of every attachment of theMsg
+            end try
+            set bodyText to ""
+            try
+                set bodyText to (plain text content of theMsg) as string
+            end try
+            set out to out & ${(0, run_1.asRow)([
+        '(id of theMsg as string)',
+        'sndName',
+        'sndAddr',
+        'my sanitizeList(attNames)',
+        'bodyText',
+    ])}
+        end if
+    end repeat
+    return out
+end tell`;
+    const details = new Map();
+    for (const record of (0, run_1.splitRecords)(await (0, run_1.runOsaScript)(detailScript, 300000))) {
+        const parts = (0, run_1.splitFields)(record);
+        details.set((0, run_1.field)(parts, 0), {
+            senderName: (0, run_1.field)(parts, 1),
+            senderEmail: (0, run_1.field)(parts, 2),
+            attachmentNames: (0, run_1.splitList)((0, run_1.field)(parts, 3)),
+            body: (0, run_1.field)(parts, 4),
+        });
+    }
+    const matches = [];
+    for (const candidate of candidates) {
+        const detail = details.get(candidate.id);
+        if (!detail)
+            continue;
+        // requireAttachment can only be answered once the attachment names are in
+        // hand, so it filters here rather than during the index pass.
+        if (filter.requireAttachment && detail.attachmentNames.length === 0)
+            continue;
+        matches.push({
+            entryId: candidate.id,
+            storeId: '', // macOS AppleScript has no StoreID equivalent
+            subject: candidate.subject,
+            senderName: detail.senderName,
+            senderEmail: detail.senderEmail,
+            receivedTime: candidate.receivedTime,
+            body: detail.body,
+            attachmentNames: detail.attachmentNames,
+            folderPath: candidate.folderPath,
+        });
+    }
+    return matches;
+}
+/**
+ * Read the email currently selected (or open) in Outlook — full body,
+ * attachments listed by name but not saved.
+ *
+ * `current messages` covers both cases the Windows reader handles separately
+ * (an explorer selection and an open item), so there is no second lookup here.
+ */
+async function readSelectedEmail() {
+    const script = `tell application "Microsoft Outlook"
+    set sel to {}
+    try
+        set sel to current messages
+    end try
+    if (count of sel) is 0 then error "No email is selected in Outlook. Open Outlook, select (or open) an email, then try again."
+    set theMsg to item 1 of sel
+${(0, scripts_1.messageDetailSnippet)(true)}
+    return ${(0, run_1.asRow)((0, scripts_1.messageDetailFields)(true))}
+end tell`;
+    const records = (0, run_1.splitRecords)(await (0, run_1.runOsaScript)(script, 30000));
+    if (records.length === 0) {
+        throw new errors_1.NotFoundError('email', 'Failed to read the selected Outlook email.');
+    }
+    const parts = (0, run_1.splitFields)(records[0]);
+    return {
+        entryId: (0, run_1.field)(parts, scripts_1.MessageDetail.id),
+        storeId: '', // macOS AppleScript has no StoreID equivalent
+        subject: (0, run_1.field)(parts, scripts_1.MessageDetail.subject).trim(),
+        senderName: (0, run_1.field)(parts, scripts_1.MessageDetail.senderName),
+        senderEmail: (0, run_1.field)(parts, scripts_1.MessageDetail.senderEmail),
+        receivedTime: (0, run_1.field)(parts, scripts_1.MessageDetail.receivedTime),
+        body: (0, run_1.field)(parts, scripts_1.MessageDetail.body),
+        attachmentNames: (0, run_1.splitList)((0, run_1.field)(parts, scripts_1.MessageDetail.attachmentNames)),
+    };
+}
+/** Open an email in Outlook by its message id, and bring Outlook forward. */
+async function openOutlookEmail(entryId) {
+    const id = (0, scripts_1.macMessageId)(entryId);
+    const script = `
+tell application "Microsoft Outlook"
+${(0, scripts_1.messageLookupSnippet)(id)}
+    open theMsg
+    activate
+end tell`;
+    await (0, run_1.runOsaScript)(script, 30000);
+}
+//# sourceMappingURL=read.js.map

package/dist/mac/read.js.map

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

package/dist/mac/run.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Run an AppleScript via a temp file (avoids arg-length and quoting limits).
+ *
+ * `AS_HANDLERS` is prepended here rather than by each caller — the Windows runner
+ * already owns its UTF-8 prelude the same way. It matters more on this side: a
+ * script missing a handler fails at COMPILE time for the WHOLE script, with a
+ * message pointing nowhere near the omission, so "remember to paste the handlers"
+ * was a footgun every new script had to survive.
+ *
+ * `timeout` overrides the configured default for this one call; see `configure()`
+ * for that and for the stdout cap.
+ */
+export declare function runOsaScript(source: string, timeout?: number): Promise<string>;
+/** Escape a string for embedding inside an AppleScript double-quoted literal. */
+export declare function asEscape(s: string): string;
+/** AppleScript's boolean literals. */
+export declare function asBool(value: boolean): string;
+export declare const FIELD_SEP = "\u001F";
+export declare const RECORD_SEP = "\u001E";
+export declare const LIST_SEP = "\u001D";
+/** The same three, as AppleScript expressions. */
+export declare const AS_FIELD_SEP = "(character id 31)";
+export declare const AS_RECORD_SEP = "(character id 30)";
+export declare const AS_LIST_SEP = "(character id 29)";
+/**
+ * Emit one record: the AppleScript expressions in `fields`, separated and
+ * terminated so `splitRecords`/`splitFields` can take them apart again.
+ *
+ * Every field goes through `sanitize`, which is what makes the framing safe
+ * rather than merely unlikely to break. A field holding a LIST must be built
+ * with `my sanitizeList(...)`, which cleans the elements instead — `sanitize`
+ * deliberately leaves the list separator alone.
+ */
+export declare function asRow(fields: readonly string[]): string;
+/**
+ * The AppleScript handlers every script here relies on. Called with `my` from
+ * inside a `tell` block.
+ *
+ * `isoDate` produces the zero-padded 'yyyy-MM-dd HH:mm' both platforms' readers
+ * return; `sanitize` strips the framing characters; `joinList` and `replaceText`
+ * are the text-item-delimiter dance nobody should write twice.
+ */
+export declare const AS_HANDLERS = "\non pad2(n)\n    set s to (n as integer) as string\n    if (length of s) < 2 then set s to \"0\" & s\n    return s\nend pad2\n\non isoDate(d)\n    if d is missing value then return \"\"\n    return (year of d as string) & \"-\" & pad2(month of d as integer) & \"-\" & pad2(day of d) & \" \" & pad2(hours of d) & \":\" & pad2(minutes of d)\nend isoDate\n\non joinList(lst, sep)\n    set saved to AppleScript's text item delimiters\n    set AppleScript's text item delimiters to sep\n    set out to lst as string\n    set AppleScript's text item delimiters to saved\n    return out\nend joinList\n\non replaceText(t, findWhat, replaceWith)\n    set saved to AppleScript's text item delimiters\n    set AppleScript's text item delimiters to findWhat\n    set parts to text items of t\n    set AppleScript's text item delimiters to replaceWith\n    set out to parts as string\n    set AppleScript's text item delimiters to saved\n    return out\nend replaceText\n\n-- Strips the FIELD and RECORD separators only. The LIST separator is left\n-- alone on purpose: a field may legitimately BE a list, and stripping 29 here\n-- collapsed every such field into one run-on string.\non sanitize(v)\n    if v is missing value then return \"\"\n    set t to v as string\n    repeat with codePoint in {30, 31}\n        set marker to (character id (codePoint as integer))\n        if t contains marker then set t to my replaceText(t, marker, \" \")\n    end repeat\n    return t\nend sanitize\n\n-- A list field: each element loses all three separators, then they are joined\n-- with the LIST separator that splitList() takes them apart on.\non sanitizeList(lst)\n    set cleaned to {}\n    repeat with item_ in lst\n        set t to my sanitize(item_)\n        repeat with codePoint in {29}\n            set marker to (character id (codePoint as integer))\n            if t contains marker then set t to my replaceText(t, marker, \" \")\n        end repeat\n        set end of cleaned to t\n    end repeat\n    return my joinList(cleaned, (character id 29))\nend sanitizeList\n\non insertAboveQuoted(c, ins)\n    if c is missing value then return ins\n    set c to c as string\n    if (length of c) is 0 then return ins\n    -- Outlook builds a reply as a document whose own empty paragraph sits inside\n    -- WordSection1; inserting straight after that tag puts the new text where the\n    -- user's cursor would have been. Anything else falls back to just inside <body>.\n    -- 'at' is a reserved AppleScript parameter name, so the cut point cannot be\n    -- called that however naturally it reads.\n    set cutPoint to my tagEnd(c, \"WordSection1>\")\n    if cutPoint is 0 then set cutPoint to my tagEnd(c, \"<body\")\n    if cutPoint is 0 then return ins & c\n    if cutPoint is (length of c) then return c & ins\n    return (text 1 thru cutPoint of c) & ins & (text (cutPoint + 1) thru -1 of c)\nend insertAboveQuoted\n\n-- 'rest' is an AppleScript term (rest of list), so the remainder cannot be\n-- called that: assigning to it compiles and then fails at run time.\non tagEnd(c, marker)\n    set ix to offset of marker in c\n    if ix is 0 then return 0\n    if marker ends with \">\" then return ix + (length of marker) - 1\n    set tailText to text ix thru -1 of c\n    set gt to offset of \">\" in tailText\n    if gt is 0 then return 0\n    return ix + gt - 1\nend tagEnd\n";
+/** Split a script's output into records, dropping the trailing empty one. */
+export declare function splitRecords(raw: string): string[];
+/** Split one record into its fields. */
+export declare function splitFields(record: string): string[];
+/** Split one field that carries a list. */
+export declare function splitList(value: string | undefined): string[];
+/** A field by position — a missing field reads as ''. */
+export declare function field(fields: readonly string[], index: number): string;
+/**
+ * The fields of a script's ONE summary record — the shape every mutation here
+ * returns (counts first, then any per-item failures as further records).
+ */
+export declare function summaryFields(raw: string): string[];
+/** A numeric field, defaulting to `fallback` when absent or unparsable. */
+export declare function intField(fields: readonly string[], index: number, fallback?: number): number;
+/**
+ * A boolean field. AppleScript renders booleans as the bare words `true`/`false`,
+ * so this is the counterpart of `shared/json.ts`'s coercions for the framed
+ * output — the Windows side gets those free from ConvertFrom-Json.
+ */
+export declare function boolField(fields: readonly string[], index: number): boolean;