@relayfile/adapter-airtable 0.2.4 → 0.2.5

package/dist/summary.js

@@ -0,0 +1,164 @@
+import { extractAirtableNotificationChangedFieldIds, extractAirtableNotificationChanges, parseAirtableWebhookPayload, } from './webhook-normalizer.js';
+export function buildSummary(input) {
+    const payload = isWebhookNotification(input)
+        ? (input.payload ?? {})
+        : input;
+    const record = parseAirtableWebhookPayload(payload);
+    const normalized = isWebhookNotification(input) ? input : undefined;
+    const baseId = normalized?.baseId ??
+        readOptionalString(record.baseId) ??
+        readOptionalString(record.base_id) ??
+        readOptionalString(getRecord(record.base)?.id);
+    const webhookId = normalized?.webhookId ??
+        readOptionalString(record.webhookId) ??
+        readOptionalString(record.webhook_id) ??
+        readOptionalString(getRecord(record.webhook)?.id) ??
+        readOptionalString(record.id);
+    const fieldNamesById = buildFieldNamesById(record);
+    const fieldsChanged = uniqueStrings([
+        ...(normalized?.changedFieldIds ?? [])
+            .map((fieldId) => resolveFieldName(fieldNamesById, fieldId))
+            .filter((value) => Boolean(value)),
+        ...(normalized?.changes ?? [])
+            .map((change) => change.fieldName ?? resolveFieldName(fieldNamesById, change.fieldId))
+            .filter((value) => Boolean(value)),
+        ...extractAirtableNotificationChangedFieldIds(record)
+            .map((fieldId) => resolveFieldName(fieldNamesById, fieldId) ?? fieldId)
+            .filter((value) => Boolean(value)),
+        ...extractAirtableNotificationChanges(record, 50)
+            .map((change) => change.fieldName ?? resolveFieldName(fieldNamesById, change.fieldId) ?? change.fieldId)
+            .filter((value) => Boolean(value)),
+    ]).slice(0, 16);
+    const tableIds = uniqueStrings([
+        ...extractAirtableNotificationChanges(record, 50)
+            .map((change) => change.tableId)
+            .filter((value) => Boolean(value)),
+    ]).slice(0, 6);
+    const actor = readActor(record);
+    const title = resolveNotificationTitle(record)
+        ?? (baseId ? `Airtable base ${baseId} change notification` : 'Airtable change notification');
+    return {
+        title,
+        ...(actor ? { actor } : {}),
+        ...(fieldsChanged.length > 0 ? { fieldsChanged } : {}),
+        ...(tableIds.length > 0 || webhookId
+            ? {
+                tags: uniqueStrings([
+                    'airtable',
+                    'notification',
+                    ...(webhookId ? [`webhook:${webhookId}`] : []),
+                    ...tableIds.map((tableId) => `table:${tableId}`),
+                ]).slice(0, 8),
+            }
+            : {}),
+    };
+}
+function resolveNotificationTitle(record) {
+    const changedTablesById = getRecord(record.changedTablesById);
+    if (!changedTablesById) {
+        return undefined;
+    }
+    for (const tableChange of Object.values(changedTablesById)) {
+        const changedRecordsById = getRecord(getRecord(tableChange)?.changedRecordsById);
+        if (!changedRecordsById) {
+            continue;
+        }
+        for (const changeRecord of Object.values(changedRecordsById)) {
+            const currentFields = getRecord(getRecord(changeRecord)?.current)?.cellValuesByFieldId;
+            const previousFields = getRecord(getRecord(changeRecord)?.previous)?.cellValuesByFieldId;
+            const title = firstNonEmptyString(...Object.values(getRecord(currentFields) ?? {}))
+                ?? firstNonEmptyString(...Object.values(getRecord(previousFields) ?? {}));
+            if (title) {
+                return title;
+            }
+        }
+    }
+    return undefined;
+}
+function readActor(record) {
+    const user = getRecord(getRecord(getRecord(record.actionMetadata)?.sourceMetadata)?.user) ??
+        getRecord(record.actor);
+    const id = readOptionalString(user?.id);
+    if (!id) {
+        return undefined;
+    }
+    const displayName = readOptionalString(user?.displayName) ??
+        readOptionalString(user?.name);
+    return {
+        id,
+        ...(displayName ? { displayName } : {}),
+    };
+}
+function buildFieldNamesById(record) {
+    const names = new Map();
+    collectFieldDefinitions(names, record.fields);
+    collectFieldDefinitions(names, getRecord(record.table)?.fields);
+    const baseTables = getRecord(record.base)?.tables;
+    if (Array.isArray(baseTables)) {
+        for (const table of baseTables) {
+            collectFieldDefinitions(names, getRecord(table)?.fields);
+        }
+    }
+    const changedTablesById = getRecord(record.changedTablesById);
+    if (changedTablesById) {
+        for (const tableChange of Object.values(changedTablesById)) {
+            const tableRecord = getRecord(tableChange);
+            collectFieldDefinitions(names, getRecord(tableRecord?.table)?.fields);
+            const fieldsById = getRecord(tableRecord?.fieldsById);
+            if (!fieldsById) {
+                continue;
+            }
+            for (const [fieldId, value] of Object.entries(fieldsById)) {
+                const fieldName = readOptionalString(getRecord(value)?.name);
+                if (fieldName) {
+                    names.set(fieldId, fieldName);
+                }
+            }
+        }
+    }
+    return names;
+}
+function collectFieldDefinitions(names, value) {
+    if (!Array.isArray(value)) {
+        return;
+    }
+    for (const entry of value) {
+        const record = getRecord(entry);
+        const fieldId = readOptionalString(record?.id);
+        const fieldName = readOptionalString(record?.name);
+        if (fieldId && fieldName) {
+            names.set(fieldId, fieldName);
+        }
+    }
+}
+function resolveFieldName(fieldNamesById, fieldId) {
+    if (!fieldId) {
+        return undefined;
+    }
+    return fieldNamesById.get(fieldId) ?? fieldId;
+}
+function getRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function isWebhookNotification(value) {
+    const record = getRecord(value);
+    return Boolean(record && typeof record.baseId === 'string' && typeof record.webhookId === 'string');
+}
+function readOptionalString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
+}
+function firstNonEmptyString(...values) {
+    for (const value of values) {
+        const string = readOptionalString(value);
+        if (string) {
+            return string;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=summary.js.map

package/dist/summary.js.map

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

package/dist/summary.test.d.ts

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

package/dist/summary.test.d.ts.map

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

package/dist/summary.test.js

@@ -0,0 +1,79 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { buildSummary } from './summary.js';
+test('buildSummary derives the Airtable title from the first changed text cell', () => {
+    const summary = buildSummary({
+        baseId: 'app_base',
+        changedFieldIds: ['fld_name', 'fld_status'],
+        changes: [
+            { fieldId: 'fld_name', recordId: 'rec_1', tableId: 'tbl_tasks', type: 'update' },
+            { fieldId: 'fld_status', recordId: 'rec_1', tableId: 'tbl_tasks', type: 'update' },
+        ],
+        payload: {
+            table: {
+                fields: [
+                    { id: 'fld_name', name: 'Name' },
+                    { id: 'fld_status', name: 'Status' },
+                ],
+            },
+            actionMetadata: {
+                sourceMetadata: {
+                    user: {
+                        id: 'usr_1',
+                        displayName: 'Ada Lovelace',
+                    },
+                },
+            },
+            changedTablesById: {
+                tbl_tasks: {
+                    changedRecordsById: {
+                        rec_1: {
+                            current: {
+                                cellValuesByFieldId: {
+                                    fld_name: 'Ship Airtable adapter',
+                                    fld_status: 'Done',
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        timestamp: '2026-05-12T01:00:00.000Z',
+        webhookId: 'ach_1',
+    });
+    assert.deepEqual(summary, {
+        actor: {
+            id: 'usr_1',
+            displayName: 'Ada Lovelace',
+        },
+        fieldsChanged: ['Name', 'Status'],
+        tags: ['airtable', 'notification', 'webhook:ach_1', 'table:tbl_tasks'],
+        title: 'Ship Airtable adapter',
+    });
+});
+test('buildSummary falls back to Airtable field ids when the notification lacks schema metadata', () => {
+    const summary = buildSummary({
+        baseId: 'app_base',
+        changedFieldIds: ['fld_status'],
+        payload: {
+            changedTablesById: {
+                tbl_tasks: {
+                    changedRecordsById: {
+                        rec_1: {
+                            current: {
+                                cellValuesByFieldId: {
+                                    fld_status: 'Done',
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        timestamp: '2026-05-12T01:00:00.000Z',
+        webhookId: 'ach_2',
+    });
+    assert.deepEqual(summary.fieldsChanged, ['fld_status']);
+});
+//# sourceMappingURL=summary.test.js.map

package/dist/summary.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.test.js","sourceRoot":"","sources":["../src/summary.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,IAAI,CAAC,0EAA0E,EAAE,GAAG,EAAE;IACpF,MAAM,OAAO,GAAG,YAAY,CAAC;QAC3B,MAAM,EAAE,UAAU;QAClB,eAAe,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;QAC3C,OAAO,EAAE;YACP,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChF,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;SACnF;QACD,OAAO,EAAE;YACP,KAAK,EAAE;gBACL,MAAM,EAAE;oBACN,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE;oBAChC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACrC;aACF;YACD,cAAc,EAAE;gBACd,cAAc,EAAE;oBACd,IAAI,EAAE;wBACJ,EAAE,EAAE,OAAO;wBACX,WAAW,EAAE,cAAc;qBAC5B;iBACF;aACF;YACD,iBAAiB,EAAE;gBACjB,SAAS,EAAE;oBACT,kBAAkB,EAAE;wBAClB,KAAK,EAAE;4BACL,OAAO,EAAE;gCACP,mBAAmB,EAAE;oCACnB,QAAQ,EAAE,uBAAuB;oCACjC,UAAU,EAAE,MAAM;iCACnB;6BACF;yBACF;qBACF;iBACF;aACF;SACF;QACD,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE;QACxB,KAAK,EAAE;YACL,EAAE,EAAE,OAAO;YACX,WAAW,EAAE,cAAc;SAC5B;QACD,aAAa,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;QACjC,IAAI,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,CAAC;QACtE,KAAK,EAAE,uBAAuB;KAC/B,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2FAA2F,EAAE,GAAG,EAAE;IACrG,MAAM,OAAO,GAAG,YAAY,CAAC;QAC3B,MAAM,EAAE,UAAU;QAClB,eAAe,EAAE,CAAC,YAAY,CAAC;QAC/B,OAAO,EAAE;YACP,iBAAiB,EAAE;gBACjB,SAAS,EAAE;oBACT,kBAAkB,EAAE;wBAClB,KAAK,EAAE;4BACL,OAAO,EAAE;gCACP,mBAAmB,EAAE;oCACnB,UAAU,EAAE,MAAM;iCACnB;6BACF;yBACF;qBACF;iBACF;aACF;SACF;QACD,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { EventSummary as SharedEventSummary } from '@agent-relay/events';
 export declare const AIRTABLE_WEBHOOK_OBJECT_TYPES: readonly ["record", "table", "base"];
 export declare const AIRTABLE_WEBHOOK_ACTIONS: readonly ["create", "update", "delete"];
 export type AirtableWebhookObjectType = (typeof AIRTABLE_WEBHOOK_OBJECT_TYPES)[number];
@@ -90,6 +91,54 @@ export type AirtableRecordWebhookPayload = AirtableWebhookBase<AirtableRecord>;
 export type AirtableTableWebhookPayload = AirtableWebhookBase<AirtableTable>;
 export type AirtableBaseWebhookPayload = AirtableWebhookBase<AirtableBase>;
 export type AirtableWebhookPayload = AirtableBaseWebhookPayload | AirtableRecordWebhookPayload | AirtableTableWebhookPayload | AirtableWebhookBase<Record<string, unknown>>;
+export interface AirtableEventActorSummary {
+    id: string;
+    displayName?: string;
+}
+export type AirtableEventSummary = SharedEventSummary;
+export interface AirtableNotificationChange {
+    fieldId?: string;
+    fieldName?: string;
+    recordId?: string;
+    tableId?: string;
+    type?: string;
+}
+export interface AirtableWebhookNotification {
+    baseId: string;
+    kind?: string;
+    webhookId: string;
+    timestamp: string;
+    notificationId?: string;
+    changedFieldIds?: string[];
+    changes?: AirtableNotificationChange[];
+    connectionId?: string;
+    cursor?: number;
+    path?: string;
+    payload?: Record<string, unknown>;
+    payloadFormat?: string;
+    provider?: string;
+    providerConfigKey?: string;
+}
+export interface AirtableWebhookPayloadPage {
+    cursor?: number;
+    mightHaveMore?: boolean;
+    payloadFormat?: string;
+    payloads: Record<string, unknown>[];
+}
+export interface AirtableMaterializedChangePayload extends AirtableWebhookPayloadPage {
+    baseId: string;
+    digest: string;
+    webhookId: string;
+    notificationId: string;
+    endpoint: string;
+    path: string;
+    data: Record<string, unknown>;
+}
+export interface AirtableFetchOnDemandOptions extends Pick<AirtableAdapterConfig, 'apiUrl' | 'connectionId' | 'providerConfigKey'> {
+    cursor?: number;
+    defaultBaseId?: string;
+    query?: Record<string, string>;
+}
 export interface AirtableReadRequest {
     action: 'get_base' | 'get_record' | 'get_table_records';
     method: 'GET';

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ;IACR,OAAO;IACP,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ;IACR,OAAO;IACP,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC"}

package/dist/webhook-normalizer.d.ts

@@ -1,4 +1,5 @@
 import type { NormalizedWebhook } from './airtable-adapter.js';
+import type { AirtableNotificationChange, AirtableWebhookNotification } from './types.js';
 export declare const AIRTABLE_PROVIDER = "airtable";
 export declare const AIRTABLE_CONTENT_MAC_HEADER = "x-airtable-content-mac";
 export declare const AIRTABLE_TIMESTAMP_HEADER = "x-airtable-timestamp";
@@ -35,12 +36,21 @@ export interface NormalizeAirtableWebhookOptions {
     toleranceMs?: number;
     webhookSecret?: string;
 }
+export type NormalizeAirtableNotificationOptions = Omit<NormalizeAirtableWebhookOptions, 'requireTimestamp'> & {
+    defaultBaseId?: string;
+    defaultConnectionId?: string;
+    defaultProvider?: string;
+    defaultProviderConfigKey?: string;
+};
 export declare function normalizeAirtableWebhook(rawPayload: unknown, headers?: AirtableWebhookHeaders, options?: NormalizeAirtableWebhookOptions): NormalizedWebhook;
+export declare function normalizeAirtableNotification(rawPayload: unknown, headers?: AirtableWebhookHeaders, options?: NormalizeAirtableNotificationOptions): AirtableWebhookNotification;
 export declare function parseAirtableWebhookPayload(rawPayload: unknown): AirtableRecord;
 export declare function extractAirtableConnectionMetadata(payload: unknown, headers?: AirtableWebhookHeaders): AirtableWebhookConnectionMetadata;
 export declare function extractAirtableEventType(payload: unknown, headers?: AirtableWebhookHeaders, objectType?: string, action?: string): string;
 export declare function extractAirtableObjectType(payload: unknown, headers?: AirtableWebhookHeaders): string;
 export declare function extractAirtableObjectId(payload: unknown, objectType?: string): string;
+export declare function extractAirtableNotificationChangedFieldIds(payload: unknown): string[];
+export declare function extractAirtableNotificationChanges(payload: unknown, limit?: number): AirtableNotificationChange[];
 export declare function computeAirtableWebhookSignature(rawPayload: unknown, secret: string): string;
 export declare function validateAirtableWebhookSignature(rawPayload: unknown, headers: AirtableWebhookHeaders, secret: string): AirtableWebhookSignatureValidationResult;
 export declare function assertValidAirtableWebhookSignature(rawPayload: unknown, headers: AirtableWebhookHeaders, secret: string): void;

package/dist/webhook-normalizer.d.ts.map

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