@rashidazarang/airtable-mcp 3.2.5 → 3.2.8

package/types/typescript/app/validateApiKey.d.ts

@@ -0,0 +1,25 @@
+/**
+ * API key format validation for Airtable Personal Access Tokens.
+ *
+ * Provides helpful warnings when token format appears incorrect,
+ * without blocking startup (token might still work in edge cases).
+ */
+export interface TokenValidationResult {
+    isValid: boolean;
+    warnings: string[];
+}
+/**
+ * Validates Airtable API key format and returns warnings for common issues.
+ *
+ * @param apiKey - The API key to validate
+ * @returns Validation result with warnings array
+ */
+export declare function validateApiKey(apiKey: string): TokenValidationResult;
+/**
+ * Get token format warnings for inclusion in error messages.
+ * Only returns warnings if issues are detected.
+ *
+ * @param apiKey - The API key to check
+ * @returns Array of warning strings, empty if token format looks valid
+ */
+export declare function getTokenFormatWarnings(apiKey: string): string[];

package/types/typescript/errors.d.ts

@@ -13,9 +13,11 @@ export interface ErrorContext {
     attempt?: number;
     totalAttempts?: number;
     upstreamErrorType?: string;
+    upstreamErrorMessage?: string;
     upstreamRequestId?: string;
     governanceRule?: string;
     endpoint?: string;
+    tokenFormatWarnings?: string[];
 }
 interface AirtableErrorOptions {
     status?: number;

package/dist/typescript/apps-sdk/mappers.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toInlineResultCard = toInlineResultCard;
-exports.toFullscreenGrid = toFullscreenGrid;
-exports.buildDiffModalForCreate = buildDiffModalForCreate;
-exports.buildDiffModalForUpdate = buildDiffModalForUpdate;
-function toInlineResultCard(table, result) {
-    const sample = result.records.slice(0, 5);
-    const colSet = new Set();
-    for (const r of sample)
-        Object.keys(r.fields || {}).forEach((k) => colSet.add(k));
-    const columns = Array.from(colSet).map((k) => ({ key: k, label: k }));
-    return {
-        title: `${table}`,
-        subtitle: sample.length > 0 && typeof result.summary?.returned === 'number'
-            ? `Showing ${sample.length} of ${result.summary.returned}${result.summary.hasMore ? '+' : ''}`
-            : undefined,
-        columns,
-        rows: sample.map((r) => ({ id: r.id, ...r.fields })),
-        pagination: { hasMore: Boolean(result.summary?.hasMore), nextOffset: result.offset },
-        actions: ['view_fullscreen', 'export_csv'],
-        state: sample.length === 0 ? 'empty' : 'ready'
-    };
-}
-function toFullscreenGrid(_table, result, selection = []) {
-    const colSet = new Set();
-    for (const r of result.records)
-        Object.keys(r.fields || {}).forEach((k) => colSet.add(k));
-    const columns = Array.from(colSet).map((k) => ({ key: k, label: k }));
-    return {
-        columns,
-        rows: result.records.map((r) => ({ id: r.id, ...(r.fields || {}) })),
-        filters: {},
-        sorts: [],
-        selection,
-        toolbarActions: ['propose_edit', 'upsert_by_key', 'export_csv'],
-        state: result.records.length === 0 ? 'empty' : 'ready'
-    };
-}
-function buildDiffModalForCreate(output, idempotencyKey) {
-    const changes = [];
-    for (const r of output.records || []) {
-        const fields = r.fields || {};
-        for (const [field, after] of Object.entries(fields)) {
-            changes.push({ recordId: r.id || 'new', field, before: null, after, status: 'add' });
-        }
-    }
-    return {
-        changes,
-        idempotencyKey,
-        confirmAction: 'create',
-        cancelAction: 'close'
-    };
-}
-function buildDiffModalForUpdate(output, idempotencyKey) {
-    const changes = [];
-    for (const r of output.records || []) {
-        const fields = r.fields || {};
-        for (const [field, after] of Object.entries(fields)) {
-            changes.push({ recordId: r.id, field, before: undefined, after, status: 'update' });
-        }
-    }
-    return {
-        changes,
-        idempotencyKey,
-        confirmAction: 'update',
-        cancelAction: 'close'
-    };
-}
-//# sourceMappingURL=mappers.js.map

package/dist/typescript/apps-sdk/mappers.js.map

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

package/types/typescript/apps-sdk/mappers.d.ts

@@ -1,53 +0,0 @@
-import type { QueryOutput, CreateOutput, UpdateOutput } from '../app/types';
-export declare function toInlineResultCard(table: string, result: QueryOutput): {
-    title: string;
-    subtitle: string | undefined;
-    columns: {
-        key: string;
-        label: string;
-    }[];
-    rows: {
-        id: string;
-    }[];
-    pagination: {
-        hasMore: boolean;
-        nextOffset: string | undefined;
-    };
-    actions: string[];
-    state: string;
-};
-export declare function toFullscreenGrid(_table: string, result: QueryOutput, selection?: string[]): {
-    columns: {
-        key: string;
-        label: string;
-    }[];
-    rows: {
-        id: string;
-    }[];
-    filters: {};
-    sorts: never[];
-    selection: string[];
-    toolbarActions: string[];
-    state: string;
-};
-type DiffChange = {
-    recordId: string;
-    field: string;
-    before?: unknown;
-    after?: unknown;
-    status: 'add' | 'update' | 'unchanged' | 'conflict';
-    warning?: string;
-};
-export declare function buildDiffModalForCreate(output: CreateOutput, idempotencyKey?: string): {
-    changes: DiffChange[];
-    idempotencyKey: string | undefined;
-    confirmAction: "create";
-    cancelAction: "close";
-};
-export declare function buildDiffModalForUpdate(output: UpdateOutput, idempotencyKey?: string): {
-    changes: DiffChange[];
-    idempotencyKey: string | undefined;
-    confirmAction: "update";
-    cancelAction: "close";
-};
-export {};