@rashidazarang/airtable-mcp 3.0.0 → 3.2.5

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

@@ -0,0 +1,53 @@
+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 {};

package/types/typescript/errors.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Error taxonomy aligned with Airtable Brain guardrails.
+ *
+ * All tool errors should use these types so the LLM can reason about
+ * retry behaviour and user messaging. Avoid leaking raw Airtable payloads
+ * through error messages.
+ */
+export type AirtableErrorCode = 'RateLimited' | 'ValidationError' | 'AuthError' | 'ConflictError' | 'NotFound' | 'InternalError' | 'GovernanceError';
+export interface ErrorContext {
+    baseId?: string;
+    table?: string;
+    retryAfterMs?: number;
+    attempt?: number;
+    totalAttempts?: number;
+    upstreamErrorType?: string;
+    upstreamRequestId?: string;
+    governanceRule?: string;
+    endpoint?: string;
+}
+interface AirtableErrorOptions {
+    status?: number;
+    retryAfterMs?: number;
+    context?: ErrorContext;
+    cause?: unknown;
+}
+export declare class AirtableBrainError extends Error {
+    readonly code: AirtableErrorCode;
+    readonly status?: number;
+    readonly retryAfterMs?: number;
+    readonly context: ErrorContext;
+    constructor(code: AirtableErrorCode, message: string, options?: AirtableErrorOptions);
+    withContext(context: Partial<ErrorContext>): this;
+}
+export declare class RateLimitError extends AirtableBrainError {
+    constructor(message: string, options?: AirtableErrorOptions);
+}
+export declare class AirtableValidationError extends AirtableBrainError {
+    constructor(message: string, options?: AirtableErrorOptions);
+}
+export declare class AuthError extends AirtableBrainError {
+    constructor(message: string, options?: AirtableErrorOptions);
+}
+export declare class ConflictError extends AirtableBrainError {
+    constructor(message: string, options?: AirtableErrorOptions);
+}
+export declare class NotFoundError extends AirtableBrainError {
+    constructor(message: string, options?: AirtableErrorOptions);
+}
+export declare class InternalServerError extends AirtableBrainError {
+    constructor(message: string, options?: AirtableErrorOptions);
+}
+export declare class GovernanceError extends AirtableBrainError {
+    constructor(message: string, options?: AirtableErrorOptions);
+}
+export {};

package/types/typescript/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Airtable MCP Server - Main Export
+ *
+ * This module exports the main server functionality for programmatic use.
+ * For CLI usage, use the bin/airtable-mcp.js executable.
+ */
+export { start } from './airtable-mcp-server';
+export * from './errors';
+export type { AppConfig, AirtableAuthConfig, LogLevel } from './app/config';
+export type { AppContext } from './app/context';

package/types/typescript/prompt-templates.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Runtime AI prompt templates for Airtable MCP Server
+ */
+import type { PromptSchema } from './index';
+export declare const AI_PROMPT_TEMPLATES: Record<string, PromptSchema>;

package/types/typescript/test-suite.d.ts

@@ -0,0 +1,33 @@
+/**
+ * TypeScript Test Suite for Airtable MCP Server
+ * Comprehensive type-safe testing with enterprise validation
+ */
+interface TestResult {
+    name: string;
+    passed: boolean;
+    error?: string;
+    duration: number;
+}
+interface TestSuite {
+    name: string;
+    tests: TestResult[];
+    totalPassed: number;
+    totalFailed: number;
+    totalDuration: number;
+}
+declare class TypeScriptTestRunner {
+    private results;
+    runTest(name: string, testFn: () => Promise<void>): Promise<TestResult>;
+    runSuite(suiteName: string, tests: Array<{
+        name: string;
+        fn: () => Promise<void>;
+    }>): Promise<TestSuite>;
+    generateReport(): void;
+}
+declare class MockAirtableMCPServer {
+    initialize(): Promise<any>;
+    handleToolCall(name: string, params: Record<string, unknown>): Promise<any>;
+    handlePromptGet(_name: string, _args: Record<string, unknown>): Promise<any>;
+}
+declare function runAllTests(): Promise<void>;
+export { TypeScriptTestRunner, MockAirtableMCPServer, runAllTests, TestResult, TestSuite };

package/types/typescript/tools-schemas.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Runtime tool schemas for Airtable MCP Server
+ */
+import type { ToolSchema } from './index';
+export declare const COMPLETE_TOOL_SCHEMAS: ToolSchema[];