@relayfile/adapter-airtable 0.1.0

package/dist/writeback.js

@@ -0,0 +1,139 @@
+import { parseAirtablePath } from './path-mapper.js';
+export const AIRTABLE_WRITEBACK_ROUTE_TEMPLATE = '/v0/{baseId}/{tableId}';
+export function resolveAirtableWritebackRequest(path, content) {
+    const parsed = parseAirtablePath(path);
+    const payload = parseJsonObject(content);
+    if (parsed.objectType === 'record') {
+        const fields = unwrapFields(payload);
+        const endpoint = `/v0/${encodeURIComponent(requireBaseId(parsed.baseId))}/${encodeURIComponent(requireTableId(parsed.tableId))}`;
+        return {
+            action: 'update_record',
+            body: {
+                records: [
+                    {
+                        id: parsed.objectId,
+                        fields,
+                    },
+                ],
+            },
+            endpoint,
+            method: 'PATCH',
+            routeTemplate: AIRTABLE_WRITEBACK_ROUTE_TEMPLATE,
+        };
+    }
+    if (parsed.objectType === 'table') {
+        const records = readRecords(payload);
+        return {
+            action: 'create_record',
+            body: {
+                records,
+            },
+            endpoint: `/v0/${encodeURIComponent(requireBaseId(parsed.baseId))}/${encodeURIComponent(parsed.objectId)}`,
+            method: 'POST',
+            routeTemplate: AIRTABLE_WRITEBACK_ROUTE_TEMPLATE,
+        };
+    }
+    throw new Error(`No Airtable writeback rule matched ${path}`);
+}
+export function resolveAirtableReplaceRecordRequest(path, content) {
+    const parsed = parseAirtablePath(path);
+    if (parsed.objectType !== 'record') {
+        throw new Error(`Airtable replace writeback requires a record path: ${path}`);
+    }
+    return {
+        action: 'replace_record',
+        body: {
+            records: [
+                {
+                    id: parsed.objectId,
+                    fields: unwrapFields(parseJsonObject(content)),
+                },
+            ],
+        },
+        endpoint: `/v0/${encodeURIComponent(requireBaseId(parsed.baseId))}/${encodeURIComponent(requireTableId(parsed.tableId))}`,
+        method: 'PUT',
+        routeTemplate: AIRTABLE_WRITEBACK_ROUTE_TEMPLATE,
+    };
+}
+function readRecords(payload) {
+    const records = payload.records;
+    if (Array.isArray(records)) {
+        return records.map((record) => {
+            if (!isRecord(record)) {
+                throw new Error('Airtable records writeback expects record objects');
+            }
+            const fields = unwrapFields(record);
+            return { fields };
+        });
+    }
+    return [{ fields: unwrapFields(payload) }];
+}
+function unwrapFields(payload) {
+    if (isRecord(payload.payload) && looksLikeSyncedEnvelope(payload)) {
+        return unwrapFields(payload.payload);
+    }
+    if (isRecord(payload.fields)) {
+        if (Object.keys(payload.fields).length === 0) {
+            throw new Error('Airtable writeback requires at least one field');
+        }
+        return { ...payload.fields };
+    }
+    const fields = {};
+    for (const [key, value] of Object.entries(payload)) {
+        if (ENVELOPE_KEYS.has(key)) {
+            continue;
+        }
+        fields[key] = value;
+    }
+    if (Object.keys(fields).length === 0) {
+        throw new Error('Airtable writeback requires at least one field');
+    }
+    return fields;
+}
+const ENVELOPE_KEYS = new Set([
+    'baseId',
+    'connectionId',
+    'deleted',
+    'eventType',
+    'id',
+    'objectId',
+    'objectType',
+    'provider',
+    'tableId',
+    'workspaceId',
+]);
+function looksLikeSyncedEnvelope(payload) {
+    return ['provider', 'objectType', 'objectId', 'workspaceId'].some((key) => key in payload);
+}
+function parseJsonObject(content) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Airtable writeback content must be valid JSON: ${toErrorMessage(error)}`);
+    }
+    if (!isRecord(parsed)) {
+        throw new Error('Airtable writeback content must be a JSON object');
+    }
+    return parsed;
+}
+function requireBaseId(baseId) {
+    if (!baseId) {
+        throw new Error('Airtable writeback route requires baseId');
+    }
+    return baseId;
+}
+function requireTableId(tableId) {
+    if (!tableId) {
+        throw new Error('Airtable writeback route requires tableId');
+    }
+    return tableId;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=writeback.js.map

package/dist/writeback.js.map

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

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@relayfile/adapter-airtable",
+  "version": "0.1.0",
+  "description": "Airtable adapter package for Relayfile",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./path-mapper": {
+      "types": "./dist/path-mapper.d.ts",
+      "import": "./dist/path-mapper.js",
+      "default": "./dist/path-mapper.js"
+    },
+    "./writeback": {
+      "types": "./dist/writeback.d.ts",
+      "import": "./dist/writeback.js",
+      "default": "./dist/writeback.js"
+    },
+    "./webhook": {
+      "types": "./dist/webhook-normalizer.d.ts",
+      "import": "./dist/webhook-normalizer.js",
+      "default": "./dist/webhook-normalizer.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "node --import tsx --test 'src/**/*.test.ts'",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "relayfile",
+    "airtable",
+    "adapter"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentWorkforce/relayfile-adapters",
+    "directory": "packages/airtable"
+  },
+  "peerDependencies": {
+    "@relayfile/sdk": ">=0.6.0 <1"
+  },
+  "devDependencies": {
+    "@agent-relay/sdk": "^6.0.7",
+    "@relayfile/sdk": "^0.6.0",
+    "@types/node": "^24.6.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
+}