@objectstack/spec 0.6.1 → 0.7.2

package/dist/integration/connector.zod.d.ts

@@ -0,0 +1,1571 @@
+import { z } from 'zod';
+import { AuthConfigSchema as ConnectorAuthConfigSchema } from '../auth/config.zod';
+/**
+ * Connector Protocol - LEVEL 3: Enterprise Connector
+ *
+ * Defines the standard connector specification for external system integration.
+ * Connectors enable ObjectStack to sync data with SaaS apps, databases, file storage,
+ * and message queues through a unified protocol.
+ *
+ * **Positioning in 3-Layer Architecture:**
+ * - **L1: Simple Sync** (automation/sync.zod.ts) - Business users - Sync Salesforce to Sheets
+ * - **L2: ETL Pipeline** (automation/etl.zod.ts) - Data engineers - Aggregate 10 sources to warehouse
+ * - **L3: Enterprise Connector** (THIS FILE) - System integrators - Full SAP integration
+ *
+ * **SCOPE: Most comprehensive integration layer.**
+ * Includes authentication, webhooks, rate limiting, field mapping, bidirectional sync,
+ * retry policies, and complete lifecycle management.
+ *
+ * This protocol supports multiple authentication strategies, bidirectional sync,
+ * field mapping, webhooks, and comprehensive rate limiting.
+ *
+ * Authentication is now imported from the canonical auth/config.zod.ts.
+ *
+ * ## When to Use This Layer
+ *
+ * **Use Enterprise Connector when:**
+ * - Building enterprise-grade connectors (e.g., Salesforce, SAP, Oracle)
+ * - Complex OAuth2/SAML authentication required
+ * - Bidirectional sync with field mapping and transformations
+ * - Webhook management and rate limiting required
+ * - Full CRUD operations and data synchronization
+ * - Need comprehensive retry strategies and error handling
+ *
+ * **Examples:**
+ * - Full Salesforce integration with webhooks
+ * - SAP ERP connector with CDC (Change Data Capture)
+ * - Microsoft Dynamics 365 connector
+ *
+ * **When to downgrade:**
+ * - Simple field sync → Use {@link file://../automation/sync.zod.ts | Simple Sync}
+ * - Data transformation only → Use {@link file://../automation/etl.zod.ts | ETL Pipeline}
+ *
+ * @see {@link file://../automation/sync.zod.ts} for Level 1 (simple sync)
+ * @see {@link file://../automation/etl.zod.ts} for Level 2 (data engineering)
+ *
+ * ## When to use Integration Connector vs. Trigger Registry?
+ *
+ * **Use `integration/connector.zod.ts` when:**
+ * - Building enterprise-grade connectors (e.g., Salesforce, SAP, Oracle)
+ * - Complex OAuth2/SAML authentication required
+ * - Bidirectional sync with field mapping and transformations
+ * - Webhook management and rate limiting required
+ * - Full CRUD operations and data synchronization
+ * - Need comprehensive retry strategies and error handling
+ *
+ * **Use `automation/trigger-registry.zod.ts` when:**
+ * - Building simple automation triggers (e.g., "when Slack message received, create task")
+ * - No complex authentication needed (simple API keys, basic auth)
+ * - Lightweight, single-purpose integrations
+ * - Quick setup with minimal configuration
+ *
+ * @see ../../automation/trigger-registry.zod.ts for lightweight automation triggers
+ */
+/**
+ * @deprecated Use ConnectorAuthConfigSchema from auth/config.zod instead
+ * Kept for backward compatibility
+ */
+export declare const AuthenticationSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"oauth2">;
+    authorizationUrl: z.ZodString;
+    tokenUrl: z.ZodString;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    redirectUri: z.ZodOptional<z.ZodString>;
+    refreshToken: z.ZodOptional<z.ZodString>;
+    tokenExpiry: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "oauth2";
+    authorizationUrl: string;
+    tokenUrl: string;
+    clientId: string;
+    clientSecret: string;
+    scopes?: string[] | undefined;
+    redirectUri?: string | undefined;
+    refreshToken?: string | undefined;
+    tokenExpiry?: number | undefined;
+}, {
+    type: "oauth2";
+    authorizationUrl: string;
+    tokenUrl: string;
+    clientId: string;
+    clientSecret: string;
+    scopes?: string[] | undefined;
+    redirectUri?: string | undefined;
+    refreshToken?: string | undefined;
+    tokenExpiry?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"api-key">;
+    key: z.ZodString;
+    headerName: z.ZodDefault<z.ZodString>;
+    paramName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "api-key";
+    key: string;
+    headerName: string;
+    paramName?: string | undefined;
+}, {
+    type: "api-key";
+    key: string;
+    headerName?: string | undefined;
+    paramName?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"basic">;
+    username: z.ZodString;
+    password: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "basic";
+    password: string;
+    username: string;
+}, {
+    type: "basic";
+    password: string;
+    username: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"bearer">;
+    token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "bearer";
+    token: string;
+}, {
+    type: "bearer";
+    token: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"jwt">;
+    token: z.ZodOptional<z.ZodString>;
+    secretKey: z.ZodOptional<z.ZodString>;
+    algorithm: z.ZodDefault<z.ZodEnum<["HS256", "HS384", "HS512", "RS256", "RS384", "RS512", "ES256", "ES384", "ES512"]>>;
+    issuer: z.ZodOptional<z.ZodString>;
+    audience: z.ZodOptional<z.ZodString>;
+    subject: z.ZodOptional<z.ZodString>;
+    expiresIn: z.ZodDefault<z.ZodNumber>;
+    claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    type: "jwt";
+    algorithm: "HS256" | "HS384" | "HS512" | "RS256" | "RS384" | "RS512" | "ES256" | "ES384" | "ES512";
+    expiresIn: number;
+    token?: string | undefined;
+    subject?: string | undefined;
+    secretKey?: string | undefined;
+    issuer?: string | undefined;
+    audience?: string | undefined;
+    claims?: Record<string, any> | undefined;
+}, {
+    type: "jwt";
+    algorithm?: "HS256" | "HS384" | "HS512" | "RS256" | "RS384" | "RS512" | "ES256" | "ES384" | "ES512" | undefined;
+    token?: string | undefined;
+    expiresIn?: number | undefined;
+    subject?: string | undefined;
+    secretKey?: string | undefined;
+    issuer?: string | undefined;
+    audience?: string | undefined;
+    claims?: Record<string, any> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"saml">;
+    entryPoint: z.ZodString;
+    issuer: z.ZodString;
+    certificate: z.ZodString;
+    privateKey: z.ZodOptional<z.ZodString>;
+    callbackUrl: z.ZodOptional<z.ZodString>;
+    signatureAlgorithm: z.ZodDefault<z.ZodEnum<["sha1", "sha256", "sha512"]>>;
+    wantAssertionsSigned: z.ZodDefault<z.ZodBoolean>;
+    identifierFormat: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "saml";
+    issuer: string;
+    entryPoint: string;
+    certificate: string;
+    signatureAlgorithm: "sha1" | "sha256" | "sha512";
+    wantAssertionsSigned: boolean;
+    privateKey?: string | undefined;
+    callbackUrl?: string | undefined;
+    identifierFormat?: string | undefined;
+}, {
+    type: "saml";
+    issuer: string;
+    entryPoint: string;
+    certificate: string;
+    privateKey?: string | undefined;
+    callbackUrl?: string | undefined;
+    signatureAlgorithm?: "sha1" | "sha256" | "sha512" | undefined;
+    wantAssertionsSigned?: boolean | undefined;
+    identifierFormat?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"none">;
+}, "strip", z.ZodTypeAny, {
+    type: "none";
+}, {
+    type: "none";
+}>]>;
+export type Authentication = z.infer<typeof ConnectorAuthConfigSchema>;
+/**
+ * Field Transformation Function (Connector-specific)
+ *
+ * @deprecated Use TransformTypeSchema from shared/mapping.zod.ts instead
+ */
+export declare const FieldTransformSchema: z.ZodObject<{
+    type: z.ZodEnum<["uppercase", "lowercase", "trim", "date_format", "number_format", "custom"]>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    function: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "custom" | "trim" | "uppercase" | "lowercase" | "date_format" | "number_format";
+    function?: string | undefined;
+    params?: Record<string, any> | undefined;
+}, {
+    type: "custom" | "trim" | "uppercase" | "lowercase" | "date_format" | "number_format";
+    function?: string | undefined;
+    params?: Record<string, any> | undefined;
+}>;
+export type FieldTransform = z.infer<typeof FieldTransformSchema>;
+/**
+ * Connector Field Mapping Configuration
+ *
+ * Extends the base field mapping with connector-specific features
+ * like bidirectional sync modes and data type mapping.
+ */
+export declare const FieldMappingSchema: z.ZodObject<{
+    source: z.ZodString;
+    target: z.ZodString;
+    transform: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"constant">;
+        value: z.ZodAny;
+    }, "strip", z.ZodTypeAny, {
+        type: "constant";
+        value?: any;
+    }, {
+        type: "constant";
+        value?: any;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cast">;
+        targetType: z.ZodEnum<["string", "number", "boolean", "date"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "cast";
+        targetType: "string" | "number" | "boolean" | "date";
+    }, {
+        type: "cast";
+        targetType: "string" | "number" | "boolean" | "date";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"lookup">;
+        table: z.ZodString;
+        keyField: z.ZodString;
+        valueField: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "lookup";
+        table: string;
+        keyField: string;
+        valueField: string;
+    }, {
+        type: "lookup";
+        table: string;
+        keyField: string;
+        valueField: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"javascript">;
+        expression: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "javascript";
+        expression: string;
+    }, {
+        type: "javascript";
+        expression: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"map">;
+        mappings: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        type: "map";
+        mappings: Record<string, any>;
+    }, {
+        type: "map";
+        mappings: Record<string, any>;
+    }>]>>;
+    defaultValue: z.ZodOptional<z.ZodAny>;
+} & {
+    /**
+     * Data type mapping (connector-specific)
+     */
+    dataType: z.ZodOptional<z.ZodEnum<["string", "number", "boolean", "date", "datetime", "json", "array"]>>;
+    /**
+     * Is this field required?
+     */
+    required: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Bidirectional sync mode (connector-specific)
+     */
+    syncMode: z.ZodDefault<z.ZodEnum<["read_only", "write_only", "bidirectional"]>>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    target: string;
+    required: boolean;
+    syncMode: "bidirectional" | "read_only" | "write_only";
+    transform?: {
+        type: "constant";
+        value?: any;
+    } | {
+        type: "cast";
+        targetType: "string" | "number" | "boolean" | "date";
+    } | {
+        type: "lookup";
+        table: string;
+        keyField: string;
+        valueField: string;
+    } | {
+        type: "javascript";
+        expression: string;
+    } | {
+        type: "map";
+        mappings: Record<string, any>;
+    } | undefined;
+    defaultValue?: any;
+    dataType?: "string" | "number" | "boolean" | "date" | "array" | "datetime" | "json" | undefined;
+}, {
+    source: string;
+    target: string;
+    transform?: {
+        type: "constant";
+        value?: any;
+    } | {
+        type: "cast";
+        targetType: "string" | "number" | "boolean" | "date";
+    } | {
+        type: "lookup";
+        table: string;
+        keyField: string;
+        valueField: string;
+    } | {
+        type: "javascript";
+        expression: string;
+    } | {
+        type: "map";
+        mappings: Record<string, any>;
+    } | undefined;
+    defaultValue?: any;
+    required?: boolean | undefined;
+    dataType?: "string" | "number" | "boolean" | "date" | "array" | "datetime" | "json" | undefined;
+    syncMode?: "bidirectional" | "read_only" | "write_only" | undefined;
+}>;
+export type FieldMapping = z.infer<typeof FieldMappingSchema>;
+/**
+ * Sync Strategy Schema
+ */
+export declare const SyncStrategySchema: z.ZodEnum<["full", "incremental", "upsert", "append_only"]>;
+export type SyncStrategy = z.infer<typeof SyncStrategySchema>;
+/**
+ * Conflict Resolution Strategy
+ */
+export declare const ConflictResolutionSchema: z.ZodEnum<["source_wins", "target_wins", "latest_wins", "manual"]>;
+export type ConflictResolution = z.infer<typeof ConflictResolutionSchema>;
+/**
+ * Data Synchronization Configuration
+ */
+export declare const DataSyncConfigSchema: z.ZodObject<{
+    /**
+     * Sync strategy
+     */
+    strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["full", "incremental", "upsert", "append_only"]>>>;
+    /**
+     * Sync direction
+     */
+    direction: z.ZodDefault<z.ZodOptional<z.ZodEnum<["import", "export", "bidirectional"]>>>;
+    /**
+     * Sync frequency (cron expression)
+     */
+    schedule: z.ZodOptional<z.ZodString>;
+    /**
+     * Enable real-time sync via webhooks
+     */
+    realtimeSync: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Field to track last sync timestamp
+     */
+    timestampField: z.ZodOptional<z.ZodString>;
+    /**
+     * Conflict resolution strategy
+     */
+    conflictResolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<["source_wins", "target_wins", "latest_wins", "manual"]>>>;
+    /**
+     * Batch size for bulk operations
+     */
+    batchSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Delete handling
+     */
+    deleteMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["hard_delete", "soft_delete", "ignore"]>>>;
+    /**
+     * Filter criteria for selective sync
+     */
+    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    strategy: "full" | "upsert" | "incremental" | "append_only";
+    batchSize: number;
+    direction: "import" | "export" | "bidirectional";
+    conflictResolution: "manual" | "source_wins" | "latest_wins" | "target_wins";
+    realtimeSync: boolean;
+    deleteMode: "ignore" | "hard_delete" | "soft_delete";
+    filters?: Record<string, any> | undefined;
+    schedule?: string | undefined;
+    timestampField?: string | undefined;
+}, {
+    strategy?: "full" | "upsert" | "incremental" | "append_only" | undefined;
+    filters?: Record<string, any> | undefined;
+    batchSize?: number | undefined;
+    schedule?: string | undefined;
+    direction?: "import" | "export" | "bidirectional" | undefined;
+    conflictResolution?: "manual" | "source_wins" | "latest_wins" | "target_wins" | undefined;
+    realtimeSync?: boolean | undefined;
+    timestampField?: string | undefined;
+    deleteMode?: "ignore" | "hard_delete" | "soft_delete" | undefined;
+}>;
+export type DataSyncConfig = z.infer<typeof DataSyncConfigSchema>;
+/**
+ * Webhook Event Schema
+ */
+export declare const WebhookEventSchema: z.ZodEnum<["record.created", "record.updated", "record.deleted", "sync.started", "sync.completed", "sync.failed", "auth.expired", "rate_limit.exceeded"]>;
+export type WebhookEvent = z.infer<typeof WebhookEventSchema>;
+/**
+ * Webhook Signature Algorithm
+ */
+export declare const WebhookSignatureAlgorithmSchema: z.ZodEnum<["hmac_sha256", "hmac_sha512", "none"]>;
+export type WebhookSignatureAlgorithm = z.infer<typeof WebhookSignatureAlgorithmSchema>;
+/**
+ * Webhook Configuration Schema
+ *
+ * Extends the canonical WebhookSchema with connector-specific event types.
+ * This allows connectors to subscribe to both data events and connector lifecycle events.
+ */
+export declare const WebhookConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    object: z.ZodOptional<z.ZodString>;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<["create", "update", "delete", "undelete", "api"]>, "many">>;
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodAny>;
+    payloadFields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    includeSession: z.ZodDefault<z.ZodBoolean>;
+    authentication: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["none", "bearer", "basic", "api-key"]>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "none" | "api-key" | "basic" | "bearer";
+        credentials?: Record<string, string> | undefined;
+    }, {
+        type: "none" | "api-key" | "basic" | "bearer";
+        credentials?: Record<string, string> | undefined;
+    }>>;
+    retryPolicy: z.ZodOptional<z.ZodObject<{
+        maxRetries: z.ZodDefault<z.ZodNumber>;
+        backoffStrategy: z.ZodDefault<z.ZodEnum<["exponential", "linear", "fixed"]>>;
+        initialDelayMs: z.ZodDefault<z.ZodNumber>;
+        maxDelayMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxRetries: number;
+        backoffStrategy: "fixed" | "linear" | "exponential";
+        initialDelayMs: number;
+        maxDelayMs: number;
+    }, {
+        maxRetries?: number | undefined;
+        backoffStrategy?: "fixed" | "linear" | "exponential" | undefined;
+        initialDelayMs?: number | undefined;
+        maxDelayMs?: number | undefined;
+    }>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    secret: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+} & {
+    /**
+     * Events to listen for
+     * Connector-specific events like sync completion, auth expiry, etc.
+     */
+    events: z.ZodOptional<z.ZodArray<z.ZodEnum<["record.created", "record.updated", "record.deleted", "sync.started", "sync.completed", "sync.failed", "auth.expired", "rate_limit.exceeded"]>, "many">>;
+    /**
+     * Signature algorithm for webhook security
+     */
+    signatureAlgorithm: z.ZodDefault<z.ZodOptional<z.ZodEnum<["hmac_sha256", "hmac_sha512", "none"]>>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    name: string;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    timeoutMs: number;
+    signatureAlgorithm: "none" | "hmac_sha256" | "hmac_sha512";
+    includeSession: boolean;
+    isActive: boolean;
+    object?: string | undefined;
+    tags?: string[] | undefined;
+    label?: string | undefined;
+    description?: string | undefined;
+    events?: ("record.created" | "record.updated" | "record.deleted" | "sync.started" | "sync.completed" | "sync.failed" | "auth.expired" | "rate_limit.exceeded")[] | undefined;
+    headers?: Record<string, string> | undefined;
+    authentication?: {
+        type: "none" | "api-key" | "basic" | "bearer";
+        credentials?: Record<string, string> | undefined;
+    } | undefined;
+    body?: any;
+    secret?: string | undefined;
+    retryPolicy?: {
+        maxRetries: number;
+        backoffStrategy: "fixed" | "linear" | "exponential";
+        initialDelayMs: number;
+        maxDelayMs: number;
+    } | undefined;
+    triggers?: ("update" | "delete" | "create" | "api" | "undelete")[] | undefined;
+    payloadFields?: string[] | undefined;
+}, {
+    url: string;
+    name: string;
+    object?: string | undefined;
+    tags?: string[] | undefined;
+    label?: string | undefined;
+    description?: string | undefined;
+    events?: ("record.created" | "record.updated" | "record.deleted" | "sync.started" | "sync.completed" | "sync.failed" | "auth.expired" | "rate_limit.exceeded")[] | undefined;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | undefined;
+    headers?: Record<string, string> | undefined;
+    authentication?: {
+        type: "none" | "api-key" | "basic" | "bearer";
+        credentials?: Record<string, string> | undefined;
+    } | undefined;
+    body?: any;
+    secret?: string | undefined;
+    timeoutMs?: number | undefined;
+    retryPolicy?: {
+        maxRetries?: number | undefined;
+        backoffStrategy?: "fixed" | "linear" | "exponential" | undefined;
+        initialDelayMs?: number | undefined;
+        maxDelayMs?: number | undefined;
+    } | undefined;
+    signatureAlgorithm?: "none" | "hmac_sha256" | "hmac_sha512" | undefined;
+    triggers?: ("update" | "delete" | "create" | "api" | "undelete")[] | undefined;
+    payloadFields?: string[] | undefined;
+    includeSession?: boolean | undefined;
+    isActive?: boolean | undefined;
+}>;
+export type WebhookConfig = z.infer<typeof WebhookConfigSchema>;
+/**
+ * Rate Limiting Strategy
+ */
+export declare const RateLimitStrategySchema: z.ZodEnum<["fixed_window", "sliding_window", "token_bucket", "leaky_bucket"]>;
+export type RateLimitStrategy = z.infer<typeof RateLimitStrategySchema>;
+/**
+ * Rate Limiting Configuration
+ */
+export declare const RateLimitConfigSchema: z.ZodObject<{
+    /**
+     * Rate limiting strategy
+     */
+    strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["fixed_window", "sliding_window", "token_bucket", "leaky_bucket"]>>>;
+    /**
+     * Maximum requests per window
+     */
+    maxRequests: z.ZodNumber;
+    /**
+     * Time window in seconds
+     */
+    windowSeconds: z.ZodNumber;
+    /**
+     * Burst capacity (for token bucket)
+     */
+    burstCapacity: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Respect external system rate limits
+     */
+    respectUpstreamLimits: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Custom rate limit headers to check
+     */
+    rateLimitHeaders: z.ZodOptional<z.ZodObject<{
+        remaining: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        reset: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        limit: string;
+        remaining: string;
+        reset: string;
+    }, {
+        limit?: string | undefined;
+        remaining?: string | undefined;
+        reset?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    maxRequests: number;
+    strategy: "sliding_window" | "token_bucket" | "fixed_window" | "leaky_bucket";
+    windowSeconds: number;
+    respectUpstreamLimits: boolean;
+    burstCapacity?: number | undefined;
+    rateLimitHeaders?: {
+        limit: string;
+        remaining: string;
+        reset: string;
+    } | undefined;
+}, {
+    maxRequests: number;
+    windowSeconds: number;
+    strategy?: "sliding_window" | "token_bucket" | "fixed_window" | "leaky_bucket" | undefined;
+    burstCapacity?: number | undefined;
+    respectUpstreamLimits?: boolean | undefined;
+    rateLimitHeaders?: {
+        limit?: string | undefined;
+        remaining?: string | undefined;
+        reset?: string | undefined;
+    } | undefined;
+}>;
+export type RateLimitConfig = z.infer<typeof RateLimitConfigSchema>;
+/**
+ * Retry Strategy
+ */
+export declare const RetryStrategySchema: z.ZodEnum<["exponential_backoff", "linear_backoff", "fixed_delay", "no_retry"]>;
+export type RetryStrategy = z.infer<typeof RetryStrategySchema>;
+/**
+ * Retry Configuration
+ */
+export declare const RetryConfigSchema: z.ZodObject<{
+    /**
+     * Retry strategy
+     */
+    strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["exponential_backoff", "linear_backoff", "fixed_delay", "no_retry"]>>>;
+    /**
+     * Maximum retry attempts
+     */
+    maxAttempts: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Initial delay in milliseconds
+     */
+    initialDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Maximum delay in milliseconds
+     */
+    maxDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Backoff multiplier (for exponential backoff)
+     */
+    backoffMultiplier: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * HTTP status codes to retry
+     */
+    retryableStatusCodes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>>;
+    /**
+     * Retry on network errors
+     */
+    retryOnNetworkError: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Jitter to add randomness to retry delays
+     */
+    jitter: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    strategy: "no_retry" | "exponential_backoff" | "linear_backoff" | "fixed_delay";
+    backoffMultiplier: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    maxAttempts: number;
+    retryableStatusCodes: number[];
+    retryOnNetworkError: boolean;
+    jitter: boolean;
+}, {
+    strategy?: "no_retry" | "exponential_backoff" | "linear_backoff" | "fixed_delay" | undefined;
+    backoffMultiplier?: number | undefined;
+    initialDelayMs?: number | undefined;
+    maxDelayMs?: number | undefined;
+    maxAttempts?: number | undefined;
+    retryableStatusCodes?: number[] | undefined;
+    retryOnNetworkError?: boolean | undefined;
+    jitter?: boolean | undefined;
+}>;
+export type RetryConfig = z.infer<typeof RetryConfigSchema>;
+/**
+ * Connector Type
+ */
+export declare const ConnectorTypeSchema: z.ZodEnum<["saas", "database", "file_storage", "message_queue", "api", "custom"]>;
+export type ConnectorType = z.infer<typeof ConnectorTypeSchema>;
+/**
+ * Connector Status
+ */
+export declare const ConnectorStatusSchema: z.ZodEnum<["active", "inactive", "error", "configuring"]>;
+export type ConnectorStatus = z.infer<typeof ConnectorStatusSchema>;
+/**
+ * Base Connector Schema
+ * Core connector configuration shared across all connector types
+ */
+export declare const ConnectorSchema: z.ZodObject<{
+    /**
+     * Machine name (snake_case)
+     */
+    name: z.ZodString;
+    /**
+     * Human-readable label
+     */
+    label: z.ZodString;
+    /**
+     * Connector type
+     */
+    type: z.ZodEnum<["saas", "database", "file_storage", "message_queue", "api", "custom"]>;
+    /**
+     * Description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Icon identifier
+     */
+    icon: z.ZodOptional<z.ZodString>;
+    /**
+     * Authentication configuration
+     */
+    authentication: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"oauth2">;
+        authorizationUrl: z.ZodString;
+        tokenUrl: z.ZodString;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        redirectUri: z.ZodOptional<z.ZodString>;
+        refreshToken: z.ZodOptional<z.ZodString>;
+        tokenExpiry: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "oauth2";
+        authorizationUrl: string;
+        tokenUrl: string;
+        clientId: string;
+        clientSecret: string;
+        scopes?: string[] | undefined;
+        redirectUri?: string | undefined;
+        refreshToken?: string | undefined;
+        tokenExpiry?: number | undefined;
+    }, {
+        type: "oauth2";
+        authorizationUrl: string;
+        tokenUrl: string;
+        clientId: string;
+        clientSecret: string;
+        scopes?: string[] | undefined;
+        redirectUri?: string | undefined;
+        refreshToken?: string | undefined;
+        tokenExpiry?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"api-key">;
+        key: z.ZodString;
+        headerName: z.ZodDefault<z.ZodString>;
+        paramName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "api-key";
+        key: string;
+        headerName: string;
+        paramName?: string | undefined;
+    }, {
+        type: "api-key";
+        key: string;
+        headerName?: string | undefined;
+        paramName?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"basic">;
+        username: z.ZodString;
+        password: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "basic";
+        password: string;
+        username: string;
+    }, {
+        type: "basic";
+        password: string;
+        username: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"bearer">;
+        token: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "bearer";
+        token: string;
+    }, {
+        type: "bearer";
+        token: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"jwt">;
+        token: z.ZodOptional<z.ZodString>;
+        secretKey: z.ZodOptional<z.ZodString>;
+        algorithm: z.ZodDefault<z.ZodEnum<["HS256", "HS384", "HS512", "RS256", "RS384", "RS512", "ES256", "ES384", "ES512"]>>;
+        issuer: z.ZodOptional<z.ZodString>;
+        audience: z.ZodOptional<z.ZodString>;
+        subject: z.ZodOptional<z.ZodString>;
+        expiresIn: z.ZodDefault<z.ZodNumber>;
+        claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "jwt";
+        algorithm: "HS256" | "HS384" | "HS512" | "RS256" | "RS384" | "RS512" | "ES256" | "ES384" | "ES512";
+        expiresIn: number;
+        token?: string | undefined;
+        subject?: string | undefined;
+        secretKey?: string | undefined;
+        issuer?: string | undefined;
+        audience?: string | undefined;
+        claims?: Record<string, any> | undefined;
+    }, {
+        type: "jwt";
+        algorithm?: "HS256" | "HS384" | "HS512" | "RS256" | "RS384" | "RS512" | "ES256" | "ES384" | "ES512" | undefined;
+        token?: string | undefined;
+        expiresIn?: number | undefined;
+        subject?: string | undefined;
+        secretKey?: string | undefined;
+        issuer?: string | undefined;
+        audience?: string | undefined;
+        claims?: Record<string, any> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"saml">;
+        entryPoint: z.ZodString;
+        issuer: z.ZodString;
+        certificate: z.ZodString;
+        privateKey: z.ZodOptional<z.ZodString>;
+        callbackUrl: z.ZodOptional<z.ZodString>;
+        signatureAlgorithm: z.ZodDefault<z.ZodEnum<["sha1", "sha256", "sha512"]>>;
+        wantAssertionsSigned: z.ZodDefault<z.ZodBoolean>;
+        identifierFormat: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "saml";
+        issuer: string;
+        entryPoint: string;
+        certificate: string;
+        signatureAlgorithm: "sha1" | "sha256" | "sha512";
+        wantAssertionsSigned: boolean;
+        privateKey?: string | undefined;
+        callbackUrl?: string | undefined;
+        identifierFormat?: string | undefined;
+    }, {
+        type: "saml";
+        issuer: string;
+        entryPoint: string;
+        certificate: string;
+        privateKey?: string | undefined;
+        callbackUrl?: string | undefined;
+        signatureAlgorithm?: "sha1" | "sha256" | "sha512" | undefined;
+        wantAssertionsSigned?: boolean | undefined;
+        identifierFormat?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, "strip", z.ZodTypeAny, {
+        type: "none";
+    }, {
+        type: "none";
+    }>]>;
+    /**
+     * Data synchronization configuration
+     */
+    syncConfig: z.ZodOptional<z.ZodObject<{
+        /**
+         * Sync strategy
+         */
+        strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["full", "incremental", "upsert", "append_only"]>>>;
+        /**
+         * Sync direction
+         */
+        direction: z.ZodDefault<z.ZodOptional<z.ZodEnum<["import", "export", "bidirectional"]>>>;
+        /**
+         * Sync frequency (cron expression)
+         */
+        schedule: z.ZodOptional<z.ZodString>;
+        /**
+         * Enable real-time sync via webhooks
+         */
+        realtimeSync: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Field to track last sync timestamp
+         */
+        timestampField: z.ZodOptional<z.ZodString>;
+        /**
+         * Conflict resolution strategy
+         */
+        conflictResolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<["source_wins", "target_wins", "latest_wins", "manual"]>>>;
+        /**
+         * Batch size for bulk operations
+         */
+        batchSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * Delete handling
+         */
+        deleteMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["hard_delete", "soft_delete", "ignore"]>>>;
+        /**
+         * Filter criteria for selective sync
+         */
+        filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        strategy: "full" | "upsert" | "incremental" | "append_only";
+        batchSize: number;
+        direction: "import" | "export" | "bidirectional";
+        conflictResolution: "manual" | "source_wins" | "latest_wins" | "target_wins";
+        realtimeSync: boolean;
+        deleteMode: "ignore" | "hard_delete" | "soft_delete";
+        filters?: Record<string, any> | undefined;
+        schedule?: string | undefined;
+        timestampField?: string | undefined;
+    }, {
+        strategy?: "full" | "upsert" | "incremental" | "append_only" | undefined;
+        filters?: Record<string, any> | undefined;
+        batchSize?: number | undefined;
+        schedule?: string | undefined;
+        direction?: "import" | "export" | "bidirectional" | undefined;
+        conflictResolution?: "manual" | "source_wins" | "latest_wins" | "target_wins" | undefined;
+        realtimeSync?: boolean | undefined;
+        timestampField?: string | undefined;
+        deleteMode?: "ignore" | "hard_delete" | "soft_delete" | undefined;
+    }>>;
+    /**
+     * Field mappings
+     */
+    fieldMappings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+        transform: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"constant">;
+            value: z.ZodAny;
+        }, "strip", z.ZodTypeAny, {
+            type: "constant";
+            value?: any;
+        }, {
+            type: "constant";
+            value?: any;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"cast">;
+            targetType: z.ZodEnum<["string", "number", "boolean", "date"]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "cast";
+            targetType: "string" | "number" | "boolean" | "date";
+        }, {
+            type: "cast";
+            targetType: "string" | "number" | "boolean" | "date";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"lookup">;
+            table: z.ZodString;
+            keyField: z.ZodString;
+            valueField: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "lookup";
+            table: string;
+            keyField: string;
+            valueField: string;
+        }, {
+            type: "lookup";
+            table: string;
+            keyField: string;
+            valueField: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"javascript">;
+            expression: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "javascript";
+            expression: string;
+        }, {
+            type: "javascript";
+            expression: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"map">;
+            mappings: z.ZodRecord<z.ZodString, z.ZodAny>;
+        }, "strip", z.ZodTypeAny, {
+            type: "map";
+            mappings: Record<string, any>;
+        }, {
+            type: "map";
+            mappings: Record<string, any>;
+        }>]>>;
+        defaultValue: z.ZodOptional<z.ZodAny>;
+    } & {
+        /**
+         * Data type mapping (connector-specific)
+         */
+        dataType: z.ZodOptional<z.ZodEnum<["string", "number", "boolean", "date", "datetime", "json", "array"]>>;
+        /**
+         * Is this field required?
+         */
+        required: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Bidirectional sync mode (connector-specific)
+         */
+        syncMode: z.ZodDefault<z.ZodEnum<["read_only", "write_only", "bidirectional"]>>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        target: string;
+        required: boolean;
+        syncMode: "bidirectional" | "read_only" | "write_only";
+        transform?: {
+            type: "constant";
+            value?: any;
+        } | {
+            type: "cast";
+            targetType: "string" | "number" | "boolean" | "date";
+        } | {
+            type: "lookup";
+            table: string;
+            keyField: string;
+            valueField: string;
+        } | {
+            type: "javascript";
+            expression: string;
+        } | {
+            type: "map";
+            mappings: Record<string, any>;
+        } | undefined;
+        defaultValue?: any;
+        dataType?: "string" | "number" | "boolean" | "date" | "array" | "datetime" | "json" | undefined;
+    }, {
+        source: string;
+        target: string;
+        transform?: {
+            type: "constant";
+            value?: any;
+        } | {
+            type: "cast";
+            targetType: "string" | "number" | "boolean" | "date";
+        } | {
+            type: "lookup";
+            table: string;
+            keyField: string;
+            valueField: string;
+        } | {
+            type: "javascript";
+            expression: string;
+        } | {
+            type: "map";
+            mappings: Record<string, any>;
+        } | undefined;
+        defaultValue?: any;
+        required?: boolean | undefined;
+        dataType?: "string" | "number" | "boolean" | "date" | "array" | "datetime" | "json" | undefined;
+        syncMode?: "bidirectional" | "read_only" | "write_only" | undefined;
+    }>, "many">>;
+    /**
+     * Webhook configuration
+     */
+    webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        object: z.ZodOptional<z.ZodString>;
+        triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<["create", "update", "delete", "undelete", "api"]>, "many">>;
+        url: z.ZodString;
+        method: z.ZodDefault<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodAny>;
+        payloadFields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        includeSession: z.ZodDefault<z.ZodBoolean>;
+        authentication: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["none", "bearer", "basic", "api-key"]>;
+            credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "none" | "api-key" | "basic" | "bearer";
+            credentials?: Record<string, string> | undefined;
+        }, {
+            type: "none" | "api-key" | "basic" | "bearer";
+            credentials?: Record<string, string> | undefined;
+        }>>;
+        retryPolicy: z.ZodOptional<z.ZodObject<{
+            maxRetries: z.ZodDefault<z.ZodNumber>;
+            backoffStrategy: z.ZodDefault<z.ZodEnum<["exponential", "linear", "fixed"]>>;
+            initialDelayMs: z.ZodDefault<z.ZodNumber>;
+            maxDelayMs: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxRetries: number;
+            backoffStrategy: "fixed" | "linear" | "exponential";
+            initialDelayMs: number;
+            maxDelayMs: number;
+        }, {
+            maxRetries?: number | undefined;
+            backoffStrategy?: "fixed" | "linear" | "exponential" | undefined;
+            initialDelayMs?: number | undefined;
+            maxDelayMs?: number | undefined;
+        }>>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        secret: z.ZodOptional<z.ZodString>;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    } & {
+        /**
+         * Events to listen for
+         * Connector-specific events like sync completion, auth expiry, etc.
+         */
+        events: z.ZodOptional<z.ZodArray<z.ZodEnum<["record.created", "record.updated", "record.deleted", "sync.started", "sync.completed", "sync.failed", "auth.expired", "rate_limit.exceeded"]>, "many">>;
+        /**
+         * Signature algorithm for webhook security
+         */
+        signatureAlgorithm: z.ZodDefault<z.ZodOptional<z.ZodEnum<["hmac_sha256", "hmac_sha512", "none"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        name: string;
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+        timeoutMs: number;
+        signatureAlgorithm: "none" | "hmac_sha256" | "hmac_sha512";
+        includeSession: boolean;
+        isActive: boolean;
+        object?: string | undefined;
+        tags?: string[] | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+        events?: ("record.created" | "record.updated" | "record.deleted" | "sync.started" | "sync.completed" | "sync.failed" | "auth.expired" | "rate_limit.exceeded")[] | undefined;
+        headers?: Record<string, string> | undefined;
+        authentication?: {
+            type: "none" | "api-key" | "basic" | "bearer";
+            credentials?: Record<string, string> | undefined;
+        } | undefined;
+        body?: any;
+        secret?: string | undefined;
+        retryPolicy?: {
+            maxRetries: number;
+            backoffStrategy: "fixed" | "linear" | "exponential";
+            initialDelayMs: number;
+            maxDelayMs: number;
+        } | undefined;
+        triggers?: ("update" | "delete" | "create" | "api" | "undelete")[] | undefined;
+        payloadFields?: string[] | undefined;
+    }, {
+        url: string;
+        name: string;
+        object?: string | undefined;
+        tags?: string[] | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+        events?: ("record.created" | "record.updated" | "record.deleted" | "sync.started" | "sync.completed" | "sync.failed" | "auth.expired" | "rate_limit.exceeded")[] | undefined;
+        method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | undefined;
+        headers?: Record<string, string> | undefined;
+        authentication?: {
+            type: "none" | "api-key" | "basic" | "bearer";
+            credentials?: Record<string, string> | undefined;
+        } | undefined;
+        body?: any;
+        secret?: string | undefined;
+        timeoutMs?: number | undefined;
+        retryPolicy?: {
+            maxRetries?: number | undefined;
+            backoffStrategy?: "fixed" | "linear" | "exponential" | undefined;
+            initialDelayMs?: number | undefined;
+            maxDelayMs?: number | undefined;
+        } | undefined;
+        signatureAlgorithm?: "none" | "hmac_sha256" | "hmac_sha512" | undefined;
+        triggers?: ("update" | "delete" | "create" | "api" | "undelete")[] | undefined;
+        payloadFields?: string[] | undefined;
+        includeSession?: boolean | undefined;
+        isActive?: boolean | undefined;
+    }>, "many">>;
+    /**
+     * Rate limiting configuration
+     */
+    rateLimitConfig: z.ZodOptional<z.ZodObject<{
+        /**
+         * Rate limiting strategy
+         */
+        strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["fixed_window", "sliding_window", "token_bucket", "leaky_bucket"]>>>;
+        /**
+         * Maximum requests per window
+         */
+        maxRequests: z.ZodNumber;
+        /**
+         * Time window in seconds
+         */
+        windowSeconds: z.ZodNumber;
+        /**
+         * Burst capacity (for token bucket)
+         */
+        burstCapacity: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Respect external system rate limits
+         */
+        respectUpstreamLimits: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Custom rate limit headers to check
+         */
+        rateLimitHeaders: z.ZodOptional<z.ZodObject<{
+            remaining: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            reset: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            limit: string;
+            remaining: string;
+            reset: string;
+        }, {
+            limit?: string | undefined;
+            remaining?: string | undefined;
+            reset?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        maxRequests: number;
+        strategy: "sliding_window" | "token_bucket" | "fixed_window" | "leaky_bucket";
+        windowSeconds: number;
+        respectUpstreamLimits: boolean;
+        burstCapacity?: number | undefined;
+        rateLimitHeaders?: {
+            limit: string;
+            remaining: string;
+            reset: string;
+        } | undefined;
+    }, {
+        maxRequests: number;
+        windowSeconds: number;
+        strategy?: "sliding_window" | "token_bucket" | "fixed_window" | "leaky_bucket" | undefined;
+        burstCapacity?: number | undefined;
+        respectUpstreamLimits?: boolean | undefined;
+        rateLimitHeaders?: {
+            limit?: string | undefined;
+            remaining?: string | undefined;
+            reset?: string | undefined;
+        } | undefined;
+    }>>;
+    /**
+     * Retry configuration
+     */
+    retryConfig: z.ZodOptional<z.ZodObject<{
+        /**
+         * Retry strategy
+         */
+        strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["exponential_backoff", "linear_backoff", "fixed_delay", "no_retry"]>>>;
+        /**
+         * Maximum retry attempts
+         */
+        maxAttempts: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * Initial delay in milliseconds
+         */
+        initialDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * Maximum delay in milliseconds
+         */
+        maxDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * Backoff multiplier (for exponential backoff)
+         */
+        backoffMultiplier: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * HTTP status codes to retry
+         */
+        retryableStatusCodes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>>;
+        /**
+         * Retry on network errors
+         */
+        retryOnNetworkError: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Jitter to add randomness to retry delays
+         */
+        jitter: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        strategy: "no_retry" | "exponential_backoff" | "linear_backoff" | "fixed_delay";
+        backoffMultiplier: number;
+        initialDelayMs: number;
+        maxDelayMs: number;
+        maxAttempts: number;
+        retryableStatusCodes: number[];
+        retryOnNetworkError: boolean;
+        jitter: boolean;
+    }, {
+        strategy?: "no_retry" | "exponential_backoff" | "linear_backoff" | "fixed_delay" | undefined;
+        backoffMultiplier?: number | undefined;
+        initialDelayMs?: number | undefined;
+        maxDelayMs?: number | undefined;
+        maxAttempts?: number | undefined;
+        retryableStatusCodes?: number[] | undefined;
+        retryOnNetworkError?: boolean | undefined;
+        jitter?: boolean | undefined;
+    }>>;
+    /**
+     * Connection timeout in milliseconds
+     */
+    connectionTimeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Request timeout in milliseconds
+     */
+    requestTimeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Connector status
+     */
+    status: z.ZodDefault<z.ZodOptional<z.ZodEnum<["active", "inactive", "error", "configuring"]>>>;
+    /**
+     * Enable connector
+     */
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Custom metadata
+     */
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    type: "custom" | "database" | "api" | "saas" | "file_storage" | "message_queue";
+    status: "active" | "error" | "inactive" | "configuring";
+    enabled: boolean;
+    label: string;
+    name: string;
+    authentication: {
+        type: "oauth2";
+        authorizationUrl: string;
+        tokenUrl: string;
+        clientId: string;
+        clientSecret: string;
+        scopes?: string[] | undefined;
+        redirectUri?: string | undefined;
+        refreshToken?: string | undefined;
+        tokenExpiry?: number | undefined;
+    } | {
+        type: "api-key";
+        key: string;
+        headerName: string;
+        paramName?: string | undefined;
+    } | {
+        type: "basic";
+        password: string;
+        username: string;
+    } | {
+        type: "bearer";
+        token: string;
+    } | {
+        type: "none";
+    } | {
+        type: "jwt";
+        algorithm: "HS256" | "HS384" | "HS512" | "RS256" | "RS384" | "RS512" | "ES256" | "ES384" | "ES512";
+        expiresIn: number;
+        token?: string | undefined;
+        subject?: string | undefined;
+        secretKey?: string | undefined;
+        issuer?: string | undefined;
+        audience?: string | undefined;
+        claims?: Record<string, any> | undefined;
+    } | {
+        type: "saml";
+        issuer: string;
+        entryPoint: string;
+        certificate: string;
+        signatureAlgorithm: "sha1" | "sha256" | "sha512";
+        wantAssertionsSigned: boolean;
+        privateKey?: string | undefined;
+        callbackUrl?: string | undefined;
+        identifierFormat?: string | undefined;
+    };
+    connectionTimeoutMs: number;
+    requestTimeoutMs: number;
+    description?: string | undefined;
+    icon?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+    fieldMappings?: {
+        source: string;
+        target: string;
+        required: boolean;
+        syncMode: "bidirectional" | "read_only" | "write_only";
+        transform?: {
+            type: "constant";
+            value?: any;
+        } | {
+            type: "cast";
+            targetType: "string" | "number" | "boolean" | "date";
+        } | {
+            type: "lookup";
+            table: string;
+            keyField: string;
+            valueField: string;
+        } | {
+            type: "javascript";
+            expression: string;
+        } | {
+            type: "map";
+            mappings: Record<string, any>;
+        } | undefined;
+        defaultValue?: any;
+        dataType?: "string" | "number" | "boolean" | "date" | "array" | "datetime" | "json" | undefined;
+    }[] | undefined;
+    webhooks?: {
+        url: string;
+        name: string;
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+        timeoutMs: number;
+        signatureAlgorithm: "none" | "hmac_sha256" | "hmac_sha512";
+        includeSession: boolean;
+        isActive: boolean;
+        object?: string | undefined;
+        tags?: string[] | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+        events?: ("record.created" | "record.updated" | "record.deleted" | "sync.started" | "sync.completed" | "sync.failed" | "auth.expired" | "rate_limit.exceeded")[] | undefined;
+        headers?: Record<string, string> | undefined;
+        authentication?: {
+            type: "none" | "api-key" | "basic" | "bearer";
+            credentials?: Record<string, string> | undefined;
+        } | undefined;
+        body?: any;
+        secret?: string | undefined;
+        retryPolicy?: {
+            maxRetries: number;
+            backoffStrategy: "fixed" | "linear" | "exponential";
+            initialDelayMs: number;
+            maxDelayMs: number;
+        } | undefined;
+        triggers?: ("update" | "delete" | "create" | "api" | "undelete")[] | undefined;
+        payloadFields?: string[] | undefined;
+    }[] | undefined;
+    syncConfig?: {
+        strategy: "full" | "upsert" | "incremental" | "append_only";
+        batchSize: number;
+        direction: "import" | "export" | "bidirectional";
+        conflictResolution: "manual" | "source_wins" | "latest_wins" | "target_wins";
+        realtimeSync: boolean;
+        deleteMode: "ignore" | "hard_delete" | "soft_delete";
+        filters?: Record<string, any> | undefined;
+        schedule?: string | undefined;
+        timestampField?: string | undefined;
+    } | undefined;
+    rateLimitConfig?: {
+        maxRequests: number;
+        strategy: "sliding_window" | "token_bucket" | "fixed_window" | "leaky_bucket";
+        windowSeconds: number;
+        respectUpstreamLimits: boolean;
+        burstCapacity?: number | undefined;
+        rateLimitHeaders?: {
+            limit: string;
+            remaining: string;
+            reset: string;
+        } | undefined;
+    } | undefined;
+    retryConfig?: {
+        strategy: "no_retry" | "exponential_backoff" | "linear_backoff" | "fixed_delay";
+        backoffMultiplier: number;
+        initialDelayMs: number;
+        maxDelayMs: number;
+        maxAttempts: number;
+        retryableStatusCodes: number[];
+        retryOnNetworkError: boolean;
+        jitter: boolean;
+    } | undefined;
+}, {
+    type: "custom" | "database" | "api" | "saas" | "file_storage" | "message_queue";
+    label: string;
+    name: string;
+    authentication: {
+        type: "oauth2";
+        authorizationUrl: string;
+        tokenUrl: string;
+        clientId: string;
+        clientSecret: string;
+        scopes?: string[] | undefined;
+        redirectUri?: string | undefined;
+        refreshToken?: string | undefined;
+        tokenExpiry?: number | undefined;
+    } | {
+        type: "api-key";
+        key: string;
+        headerName?: string | undefined;
+        paramName?: string | undefined;
+    } | {
+        type: "basic";
+        password: string;
+        username: string;
+    } | {
+        type: "bearer";
+        token: string;
+    } | {
+        type: "none";
+    } | {
+        type: "jwt";
+        algorithm?: "HS256" | "HS384" | "HS512" | "RS256" | "RS384" | "RS512" | "ES256" | "ES384" | "ES512" | undefined;
+        token?: string | undefined;
+        expiresIn?: number | undefined;
+        subject?: string | undefined;
+        secretKey?: string | undefined;
+        issuer?: string | undefined;
+        audience?: string | undefined;
+        claims?: Record<string, any> | undefined;
+    } | {
+        type: "saml";
+        issuer: string;
+        entryPoint: string;
+        certificate: string;
+        privateKey?: string | undefined;
+        callbackUrl?: string | undefined;
+        signatureAlgorithm?: "sha1" | "sha256" | "sha512" | undefined;
+        wantAssertionsSigned?: boolean | undefined;
+        identifierFormat?: string | undefined;
+    };
+    status?: "active" | "error" | "inactive" | "configuring" | undefined;
+    enabled?: boolean | undefined;
+    description?: string | undefined;
+    icon?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+    fieldMappings?: {
+        source: string;
+        target: string;
+        transform?: {
+            type: "constant";
+            value?: any;
+        } | {
+            type: "cast";
+            targetType: "string" | "number" | "boolean" | "date";
+        } | {
+            type: "lookup";
+            table: string;
+            keyField: string;
+            valueField: string;
+        } | {
+            type: "javascript";
+            expression: string;
+        } | {
+            type: "map";
+            mappings: Record<string, any>;
+        } | undefined;
+        defaultValue?: any;
+        required?: boolean | undefined;
+        dataType?: "string" | "number" | "boolean" | "date" | "array" | "datetime" | "json" | undefined;
+        syncMode?: "bidirectional" | "read_only" | "write_only" | undefined;
+    }[] | undefined;
+    webhooks?: {
+        url: string;
+        name: string;
+        object?: string | undefined;
+        tags?: string[] | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+        events?: ("record.created" | "record.updated" | "record.deleted" | "sync.started" | "sync.completed" | "sync.failed" | "auth.expired" | "rate_limit.exceeded")[] | undefined;
+        method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | undefined;
+        headers?: Record<string, string> | undefined;
+        authentication?: {
+            type: "none" | "api-key" | "basic" | "bearer";
+            credentials?: Record<string, string> | undefined;
+        } | undefined;
+        body?: any;
+        secret?: string | undefined;
+        timeoutMs?: number | undefined;
+        retryPolicy?: {
+            maxRetries?: number | undefined;
+            backoffStrategy?: "fixed" | "linear" | "exponential" | undefined;
+            initialDelayMs?: number | undefined;
+            maxDelayMs?: number | undefined;
+        } | undefined;
+        signatureAlgorithm?: "none" | "hmac_sha256" | "hmac_sha512" | undefined;
+        triggers?: ("update" | "delete" | "create" | "api" | "undelete")[] | undefined;
+        payloadFields?: string[] | undefined;
+        includeSession?: boolean | undefined;
+        isActive?: boolean | undefined;
+    }[] | undefined;
+    syncConfig?: {
+        strategy?: "full" | "upsert" | "incremental" | "append_only" | undefined;
+        filters?: Record<string, any> | undefined;
+        batchSize?: number | undefined;
+        schedule?: string | undefined;
+        direction?: "import" | "export" | "bidirectional" | undefined;
+        conflictResolution?: "manual" | "source_wins" | "latest_wins" | "target_wins" | undefined;
+        realtimeSync?: boolean | undefined;
+        timestampField?: string | undefined;
+        deleteMode?: "ignore" | "hard_delete" | "soft_delete" | undefined;
+    } | undefined;
+    rateLimitConfig?: {
+        maxRequests: number;
+        windowSeconds: number;
+        strategy?: "sliding_window" | "token_bucket" | "fixed_window" | "leaky_bucket" | undefined;
+        burstCapacity?: number | undefined;
+        respectUpstreamLimits?: boolean | undefined;
+        rateLimitHeaders?: {
+            limit?: string | undefined;
+            remaining?: string | undefined;
+            reset?: string | undefined;
+        } | undefined;
+    } | undefined;
+    retryConfig?: {
+        strategy?: "no_retry" | "exponential_backoff" | "linear_backoff" | "fixed_delay" | undefined;
+        backoffMultiplier?: number | undefined;
+        initialDelayMs?: number | undefined;
+        maxDelayMs?: number | undefined;
+        maxAttempts?: number | undefined;
+        retryableStatusCodes?: number[] | undefined;
+        retryOnNetworkError?: boolean | undefined;
+        jitter?: boolean | undefined;
+    } | undefined;
+    connectionTimeoutMs?: number | undefined;
+    requestTimeoutMs?: number | undefined;
+}>;
+export type Connector = z.infer<typeof ConnectorSchema>;
+//# sourceMappingURL=connector.zod.d.ts.map