@relayfile/adapter-airtable 0.2.4 → 0.2.5

package/README.md

@@ -0,0 +1,50 @@
+# `@relayfile/adapter-airtable`
+
+Airtable adapter for Relayfile. The package still supports canonical base, table, and record ingestion/writeback, and it now also exposes a lazy proactive-runtime webhook surface for Airtable’s notification-only webhooks.
+
+## Quick start
+
+```ts
+import {
+  AirtableAdapter,
+  buildSummary,
+  createAirtableFetchOnDemand,
+  normalizeAirtableNotification,
+} from '@relayfile/adapter-airtable';
+```
+
+## Canonical VFS paths
+
+```text
+/airtable/bases/{baseId}.json
+/airtable/bases/{baseId}/tables/{tableId}.json
+/airtable/bases/{baseId}/tables/{tableId}/records/{recordId}.json
+/airtable/bases/{baseId}/_notifications/{webhookId}.json
+```
+
+## Lazy Airtable webhook flow
+
+The proactive-runtime receive path is intentionally shallow:
+
+1. `normalizeAirtableNotification(rawPayload, headers, options)` validates the request and extracts only the cheap notification metadata.
+2. Persist that metadata at `/airtable/bases/{baseId}/_notifications/{webhookId}.json`.
+3. `buildSummary(notification)` derives a routing-safe summary from `changedFieldIds` plus the first 50 change hints already present in the notification payload.
+4. `createAirtableFetchOnDemand(provider, options)` returns a gateway-facing loader that materializes the full Airtable payload page only when `expand("full")` is invoked.
+
+## Gateway wiring
+
+```ts
+const notification = normalizeAirtableNotification(rawBody, headers, {
+  webhookSecret: process.env.AIRTABLE_WEBHOOK_SECRET,
+});
+
+const summary = buildSummary(notification);
+const fetchOnDemand = createAirtableFetchOnDemand(provider, {
+  connectionId: notification.connectionId,
+  providerConfigKey: notification.providerConfigKey,
+});
+
+const full = await fetchOnDemand(notification);
+```
+
+`fetchOnDemand(...)` accepts either the normalized notification object, the canonical notification path, or a `<baseId>:<webhookId>` identifier. The string forms stay keyed by `webhookId` so downstream expand handlers can reconstruct Airtable’s `/v0/bases/{baseId}/webhooks/{webhookId}/payloads` endpoint without a second lookup.

package/dist/__tests__/fetch-on-demand.test.d.ts

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

package/dist/__tests__/fetch-on-demand.test.d.ts.map

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

package/dist/__tests__/fetch-on-demand.test.js

@@ -0,0 +1,134 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { createAirtableFetchOnDemand, } from '../index.js';
+test('createAirtableFetchOnDemand materializes webhook payloads from the canonical notification path', async () => {
+    const requests = [];
+    const provider = {
+        name: 'relayfile-test-provider',
+        async proxy(request) {
+            requests.push(request);
+            return {
+                data: {
+                    cursor: 7,
+                    mightHaveMore: false,
+                    payloadFormat: 'v0',
+                    payloads: [
+                        {
+                            changedTablesById: {
+                                tbl_tasks: {
+                                    changedRecordsById: {
+                                        rec_1: {
+                                            current: {
+                                                cellValuesByFieldId: {
+                                                    fld_status: 'Done',
+                                                },
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                            timestamp: '2026-05-12T01:00:00.000Z',
+                        },
+                    ],
+                },
+                headers: {},
+                status: 200,
+            };
+        },
+        async healthCheck() {
+            return true;
+        },
+    };
+    const fetchOnDemand = createAirtableFetchOnDemand(provider, {
+        connectionId: 'conn_airtable_1',
+        cursor: 4,
+        providerConfigKey: 'airtable-primary',
+    });
+    const materialized = await fetchOnDemand('/airtable/bases/app_base/_notifications/ach_1.json');
+    assert.deepEqual(requests[0], {
+        baseUrl: '',
+        connectionId: 'conn_airtable_1',
+        endpoint: '/v0/bases/app_base/webhooks/ach_1/payloads',
+        headers: {
+            'Provider-Config-Key': 'airtable-primary',
+        },
+        method: 'GET',
+        query: {
+            cursor: '4',
+        },
+    });
+    assert.equal(materialized.baseId, 'app_base');
+    assert.match(materialized.digest, /^[a-f0-9]{64}$/);
+    assert.equal(materialized.webhookId, 'ach_1');
+    assert.equal(materialized.notificationId, 'ach_1');
+    assert.equal(materialized.cursor, 7);
+    assert.equal(materialized.payloadFormat, 'v0');
+    assert.deepEqual(materialized.payloads, [
+        {
+            changedTablesById: {
+                tbl_tasks: {
+                    changedRecordsById: {
+                        rec_1: {
+                            current: {
+                                cellValuesByFieldId: {
+                                    fld_status: 'Done',
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            timestamp: '2026-05-12T01:00:00.000Z',
+        },
+    ]);
+});
+test('createAirtableFetchOnDemand follows pagination until the final payload page', async () => {
+    const requests = [];
+    const pages = [
+        {
+            cursor: 8,
+            mightHaveMore: true,
+            payloads: [
+                {
+                    id: 'page-1',
+                },
+            ],
+        },
+        {
+            cursor: 9,
+            mightHaveMore: false,
+            payloadFormat: 'v0',
+            payloads: [
+                {
+                    id: 'page-2',
+                },
+            ],
+        },
+    ];
+    const provider = {
+        name: 'relayfile-test-provider',
+        async proxy(request) {
+            requests.push(request);
+            const data = pages.shift();
+            assert.ok(data, 'expected another Airtable payload page');
+            return {
+                data: data,
+                headers: {},
+                status: 200,
+            };
+        },
+        async healthCheck() {
+            return true;
+        },
+    };
+    const fetchOnDemand = createAirtableFetchOnDemand(provider, {
+        connectionId: 'conn_airtable_1',
+        cursor: 7,
+    });
+    const materialized = await fetchOnDemand('/airtable/bases/app_base/_notifications/ach_1.json');
+    assert.deepEqual(requests.map((request) => request.query), [{ cursor: '7' }, { cursor: '8' }]);
+    assert.deepEqual(materialized.payloads, [{ id: 'page-1' }, { id: 'page-2' }]);
+    assert.equal(materialized.cursor, 9);
+    assert.equal(materialized.mightHaveMore, false);
+});
+//# sourceMappingURL=fetch-on-demand.test.js.map

package/dist/__tests__/fetch-on-demand.test.js.map

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

package/dist/__tests__/webhook-normalizer.test.js

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict';
 import { createHmac } from 'node:crypto';
 import test from 'node:test';
-import { AIRTABLE_CONTENT_MAC_HEADER, AIRTABLE_TIMESTAMP_HEADER, assertValidAirtableWebhookSignature, computeAirtableWebhookSignature, normalizeAirtableWebhook, validateAirtableWebhookSignature, validateAirtableWebhookTimestamp, } from '../index.js';
+import { AIRTABLE_CONTENT_MAC_HEADER, AIRTABLE_TIMESTAMP_HEADER, assertValidAirtableWebhookSignature, buildSummary, computeAirtableWebhookSignature, normalizeAirtableNotification, normalizeAirtableWebhook, validateAirtableWebhookSignature, validateAirtableWebhookTimestamp, } from '../index.js';
 const payload = {
     action: 'changed',
     baseId: 'app_base',
@@ -99,4 +99,54 @@ test('rejects expired timestamp when timestamp freshness is required', () => {
     assert.equal(stale.ok, false);
     assert.equal(stale.reason, 'stale-timestamp');
 });
+test('normalizeAirtableNotification keeps the receive path shallow and derives a routing summary', () => {
+    const notification = normalizeAirtableNotification({
+        actionMetadata: {
+            sourceMetadata: {
+                user: {
+                    id: 'usr_1',
+                    name: 'Ada Lovelace',
+                },
+            },
+        },
+        baseId: 'app_base',
+        changedTablesById: {
+            tbl_tasks: {
+                changedFieldIds: ['fld_status'],
+                changedRecordsById: {
+                    rec_1: {
+                        current: {
+                            cellValuesByFieldId: {
+                                fld_name: 'Ship Airtable adapter',
+                                fld_status: 'Done',
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        timestamp: '2026-05-12T01:00:00.000Z',
+        webhookId: 'ach_1',
+    }, {}, {
+        nowMs: Date.parse('2026-05-12T01:00:00.000Z'),
+    });
+    assert.equal(notification.baseId, 'app_base');
+    assert.equal(notification.kind, 'airtable.notification');
+    assert.equal(notification.webhookId, 'ach_1');
+    assert.equal(notification.path, '/airtable/bases/app_base/_notifications/ach_1.json');
+    assert.deepEqual(notification.changedFieldIds, ['fld_status', 'fld_name']);
+    assert.deepEqual(notification.changes, [
+        { fieldId: 'fld_name', recordId: 'rec_1', tableId: 'tbl_tasks', type: 'update' },
+        { fieldId: 'fld_status', recordId: 'rec_1', tableId: 'tbl_tasks', type: 'update' },
+    ]);
+    assert.deepEqual(buildSummary(notification), {
+        actor: {
+            displayName: 'Ada Lovelace',
+            id: 'usr_1',
+        },
+        fieldsChanged: ['fld_status', 'fld_name'],
+        tags: ['airtable', 'notification', 'webhook:ach_1', 'table:tbl_tasks'],
+        title: 'Ship Airtable adapter',
+    });
+});
 //# sourceMappingURL=webhook-normalizer.test.js.map

package/dist/__tests__/webhook-normalizer.test.js.map

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

package/dist/fetch-on-demand.d.ts

@@ -0,0 +1,6 @@
+import type { ConnectionProvider } from '@relayfile/sdk';
+import type { AirtableFetchOnDemandOptions, AirtableMaterializedChangePayload, AirtableWebhookNotification } from './types.js';
+export declare const AIRTABLE_WEBHOOK_PAYLOADS_ROUTE_TEMPLATE = "/v0/bases/{baseId}/webhooks/{webhookId}/payloads";
+export declare function createAirtableFetchOnDemand(provider: ConnectionProvider, options?: AirtableFetchOnDemandOptions): (notification: AirtableWebhookNotification | string) => Promise<AirtableMaterializedChangePayload>;
+export declare function fetchOnDemand(notification: AirtableWebhookNotification | string, provider: ConnectionProvider, options?: AirtableFetchOnDemandOptions): Promise<AirtableMaterializedChangePayload>;
+//# sourceMappingURL=fetch-on-demand.d.ts.map

package/dist/fetch-on-demand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-on-demand.d.ts","sourceRoot":"","sources":["../src/fetch-on-demand.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAA+B,MAAM,gBAAgB,CAAC;AAMtF,OAAO,KAAK,EACV,4BAA4B,EAC5B,iCAAiC,EACjC,2BAA2B,EAE5B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,wCAAwC,qDAAqD,CAAC;AAE3G,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,4BAAiC,GACzC,CAAC,YAAY,EAAE,2BAA2B,GAAG,MAAM,KAAK,OAAO,CAAC,iCAAiC,CAAC,CAEpG;AAED,wBAAsB,aAAa,CACjC,YAAY,EAAE,2BAA2B,GAAG,MAAM,EAClD,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,iCAAiC,CAAC,CAkE5C"}

package/dist/fetch-on-demand.js

@@ -0,0 +1,179 @@
+import { createHash } from 'node:crypto';
+import { airtableNotificationPath, parseAirtableNotificationPath, } from './path-mapper.js';
+export const AIRTABLE_WEBHOOK_PAYLOADS_ROUTE_TEMPLATE = '/v0/bases/{baseId}/webhooks/{webhookId}/payloads';
+export function createAirtableFetchOnDemand(provider, options = {}) {
+    return async (notification) => fetchOnDemand(notification, provider, options);
+}
+export async function fetchOnDemand(notification, provider, options = {}) {
+    const resolved = resolveNotification(notification, options);
+    const endpoint = AIRTABLE_WEBHOOK_PAYLOADS_ROUTE_TEMPLATE
+        .replace('{baseId}', encodeURIComponent(resolved.baseId))
+        .replace('{webhookId}', encodeURIComponent(resolved.webhookId));
+    const payloads = [];
+    let lastData;
+    let lastPage;
+    let cursor = resolved.cursor;
+    while (true) {
+        const query = {
+            ...(options.query ?? {}),
+            ...(cursor !== undefined ? { cursor: String(cursor) } : {}),
+        };
+        const request = {
+            method: 'GET',
+            baseUrl: options.apiUrl ?? '',
+            connectionId: resolved.connectionId,
+            endpoint,
+        };
+        if (resolved.providerConfigKey) {
+            request.headers = { 'Provider-Config-Key': resolved.providerConfigKey };
+        }
+        if (Object.keys(query).length > 0) {
+            request.query = query;
+        }
+        const response = await provider.proxy(request);
+        assertOk(response, endpoint);
+        const data = expectRecord(response.data, endpoint);
+        const page = normalizePayloadPage(data);
+        payloads.push(...page.payloads);
+        lastData = data;
+        lastPage = page;
+        if (!page.mightHaveMore || page.cursor === undefined || page.cursor === cursor) {
+            break;
+        }
+        cursor = page.cursor;
+    }
+    const digest = createHash('sha256')
+        .update(JSON.stringify({
+        baseId: resolved.baseId,
+        webhookId: resolved.webhookId,
+        payloads,
+    }))
+        .digest('hex');
+    return {
+        baseId: resolved.baseId,
+        digest,
+        webhookId: resolved.webhookId,
+        notificationId: resolved.notificationId,
+        endpoint,
+        path: resolved.path,
+        data: lastData ?? {},
+        ...(lastPage?.cursor !== undefined ? { cursor: lastPage.cursor } : {}),
+        ...(lastPage?.mightHaveMore !== undefined ? { mightHaveMore: lastPage.mightHaveMore } : {}),
+        ...(lastPage?.payloadFormat ? { payloadFormat: lastPage.payloadFormat } : {}),
+        payloads,
+    };
+}
+function assertOk(response, endpoint) {
+    if (response.status >= 200 && response.status < 300) {
+        return;
+    }
+    const detail = typeof response.data === 'string'
+        ? response.data
+        : response.data && typeof response.data === 'object'
+            ? JSON.stringify(response.data)
+            : 'Unknown provider error';
+    throw new Error(`GET ${endpoint} failed with ${response.status}: ${detail}`);
+}
+function expectRecord(value, endpoint) {
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        return value;
+    }
+    throw new Error(`Airtable payload materialization for ${endpoint} must return a JSON object.`);
+}
+function normalizePayloadPage(data) {
+    const cursor = readOptionalNumber(data.cursor);
+    const payloadFormat = readOptionalString(data.payloadFormat);
+    return {
+        ...(cursor !== undefined ? { cursor } : {}),
+        ...(typeof data.mightHaveMore === 'boolean' ? { mightHaveMore: data.mightHaveMore } : {}),
+        ...(payloadFormat ? { payloadFormat } : {}),
+        payloads: Array.isArray(data.payloads)
+            ? data.payloads.filter(isRecord)
+            : [],
+    };
+}
+function resolveNotification(notification, options) {
+    if (typeof notification !== 'string') {
+        const baseId = requireString(notification.baseId, 'Airtable notification baseId');
+        const webhookId = requireString(notification.webhookId, 'Airtable notification webhookId');
+        const connectionId = requireString(notification.connectionId ?? options.connectionId, 'Airtable fetchOnDemand connectionId');
+        const cursor = notification.cursor ?? options.cursor;
+        const providerConfigKey = notification.providerConfigKey ?? options.providerConfigKey;
+        return {
+            baseId,
+            webhookId,
+            notificationId: notification.notificationId?.trim() || webhookId,
+            connectionId,
+            ...(cursor !== undefined ? { cursor } : {}),
+            path: notification.path ?? airtableNotificationPath(baseId, webhookId),
+            ...(providerConfigKey ? { providerConfigKey } : {}),
+        };
+    }
+    if (notification.startsWith('/airtable/')) {
+        const parsed = parseAirtableNotificationPath(notification);
+        const connectionId = requireString(options.connectionId, 'Airtable fetchOnDemand connectionId');
+        const providerConfigKey = options.providerConfigKey;
+        return {
+            baseId: parsed.baseId,
+            webhookId: parsed.webhookId,
+            notificationId: parsed.webhookId,
+            connectionId,
+            ...(options.cursor !== undefined ? { cursor: options.cursor } : {}),
+            path: notification,
+            ...(providerConfigKey ? { providerConfigKey } : {}),
+        };
+    }
+    if (notification.includes(':')) {
+        const [baseId, webhookId] = notification.split(':', 2);
+        if (baseId?.trim() && webhookId?.trim()) {
+            const connectionId = requireString(options.connectionId, 'Airtable fetchOnDemand connectionId');
+            const providerConfigKey = options.providerConfigKey;
+            return {
+                baseId: baseId.trim(),
+                webhookId: webhookId.trim(),
+                notificationId: webhookId.trim(),
+                connectionId,
+                ...(options.cursor !== undefined ? { cursor: options.cursor } : {}),
+                path: airtableNotificationPath(baseId.trim(), webhookId.trim()),
+                ...(providerConfigKey ? { providerConfigKey } : {}),
+            };
+        }
+    }
+    if (options.defaultBaseId?.trim()) {
+        const connectionId = requireString(options.connectionId, 'Airtable fetchOnDemand connectionId');
+        const providerConfigKey = options.providerConfigKey;
+        return {
+            baseId: options.defaultBaseId.trim(),
+            webhookId: notification.trim(),
+            notificationId: notification.trim(),
+            connectionId,
+            ...(options.cursor !== undefined ? { cursor: options.cursor } : {}),
+            path: airtableNotificationPath(options.defaultBaseId.trim(), notification.trim()),
+            ...(providerConfigKey ? { providerConfigKey } : {}),
+        };
+    }
+    throw new Error('Airtable fetchOnDemand requires a notification object, a canonical notification path, or a "<baseId>:<webhookId>" identifier.');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readOptionalNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === 'string' && value.trim()) {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+}
+function readOptionalString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function requireString(value, label) {
+    if (!value?.trim()) {
+        throw new Error(`${label} is required.`);
+    }
+    return value.trim();
+}
+//# sourceMappingURL=fetch-on-demand.js.map

package/dist/fetch-on-demand.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export * from './airtable-adapter.js';
+export * from './fetch-on-demand.js';
 export * from './path-mapper.js';
 export * from './queries.js';
+export * from './summary.js';
 export * from './types.js';
 export * from './webhook-normalizer.js';
 export * from './writeback.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,6 +1,8 @@
 export * from './airtable-adapter.js';
+export * from './fetch-on-demand.js';
 export * from './path-mapper.js';
 export * from './queries.js';
+export * from './summary.js';
 export * from './types.js';
 export * from './webhook-normalizer.js';
 export * from './writeback.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}

package/dist/path-mapper.d.ts

@@ -8,6 +8,7 @@ export declare function normalizeNangoAirtableModel(model: string): AirtablePath
 export declare function airtableBasePath(baseId: string): string;
 export declare function airtableTablePath(baseId: string, tableId: string): string;
 export declare function airtableRecordPath(baseId: string, tableId: string, recordId: string): string;
+export declare function airtableNotificationPath(baseId: string, webhookId: string): string;
 export declare function computeAirtablePath(objectType: string, objectId: string, context?: {
     baseId?: string;
     tableId?: string;
@@ -18,4 +19,8 @@ export declare function parseAirtablePath(path: string): {
     objectType: AirtablePathObjectType;
     tableId?: string;
 };
+export declare function parseAirtableNotificationPath(path: string): {
+    baseId: string;
+    webhookId: string;
+};
 //# sourceMappingURL=path-mapper.d.ts.map

package/dist/path-mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-mapper.d.ts","sourceRoot":"","sources":["../src/path-mapper.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,eAAO,MAAM,qBAAqB,sCAIxB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AA4B5E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAOtF;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAMrG;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAIjF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,MAAM,CAYR;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,sBAAsB,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CA8BA"}
+{"version":3,"file":"path-mapper.d.ts","sourceRoot":"","sources":["../src/path-mapper.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,eAAO,MAAM,qBAAqB,sCAIxB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AA4B5E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAOtF;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAMrG;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAIjF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,MAAM,CAYR;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,sBAAsB,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CA8BA;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAUA"}

package/dist/path-mapper.js

@@ -61,6 +61,9 @@ export function airtableTablePath(baseId, tableId) {
 export function airtableRecordPath(baseId, tableId, recordId) {
     return `${AIRTABLE_PATH_ROOT}/bases/${encodeAirtablePathSegment(baseId)}/tables/${encodeAirtablePathSegment(tableId)}/records/${encodeAirtablePathSegment(recordId)}.json`;
 }
+export function airtableNotificationPath(baseId, webhookId) {
+    return `${AIRTABLE_PATH_ROOT}/bases/${encodeAirtablePathSegment(baseId)}/_notifications/${encodeAirtablePathSegment(webhookId)}.json`;
+}
 export function computeAirtablePath(objectType, objectId, context = {}) {
     const normalizedType = normalizeAirtableObjectType(objectType);
     const normalizedId = assertNonEmptySegment(objectId, 'object id');
@@ -101,6 +104,16 @@ export function parseAirtablePath(path) {
     }
     throw new Error(`No Airtable path rule matched ${path}`);
 }
+export function parseAirtableNotificationPath(path) {
+    const notificationMatch = path.match(/^\/airtable\/bases\/([^/]+)\/_notifications\/([^/]+)\.json$/);
+    if (notificationMatch?.[1] && notificationMatch[2]) {
+        return {
+            baseId: decodeURIComponent(notificationMatch[1]),
+            webhookId: decodeURIComponent(notificationMatch[2]),
+        };
+    }
+    throw new Error(`No Airtable notification path rule matched ${path}`);
+}
 function resolveBaseId(baseId) {
     if (!baseId) {
         throw new Error('Airtable base id is required for this path');

package/dist/path-mapper.js.map

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

package/dist/summary.d.ts

@@ -0,0 +1,3 @@
+import type { AirtableEventSummary, AirtableWebhookNotification } from './types.js';
+export declare function buildSummary(input: AirtableWebhookNotification | Record<string, unknown>): AirtableEventSummary;
+//# sourceMappingURL=summary.d.ts.map

package/dist/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../src/summary.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB,wBAAgB,YAAY,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAwD/G"}