@objectstack/spec 0.6.1 → 0.7.1

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

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

package/dist/integration/connector.zod.js

@@ -0,0 +1,426 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectorSchema = exports.ConnectorStatusSchema = exports.ConnectorTypeSchema = exports.RetryConfigSchema = exports.RetryStrategySchema = exports.RateLimitConfigSchema = exports.RateLimitStrategySchema = exports.WebhookConfigSchema = exports.WebhookSignatureAlgorithmSchema = exports.WebhookEventSchema = exports.DataSyncConfigSchema = exports.ConflictResolutionSchema = exports.SyncStrategySchema = exports.FieldMappingSchema = exports.FieldTransformSchema = exports.AuthenticationSchema = void 0;
+const zod_1 = require("zod");
+const webhook_zod_1 = require("../automation/webhook.zod");
+const config_zod_1 = require("../auth/config.zod");
+const mapping_zod_1 = require("../shared/mapping.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
+ */
+// ============================================================================
+// Authentication Schemas - IMPORTED FROM CANONICAL SOURCE
+// For backward compatibility, we re-export the auth types from auth/config.zod.ts
+// ============================================================================
+/**
+ * @deprecated Use ConnectorAuthConfigSchema from auth/config.zod instead
+ * Kept for backward compatibility
+ */
+exports.AuthenticationSchema = config_zod_1.AuthConfigSchema;
+// ============================================================================
+// Field Mapping Schema
+// Uses the canonical field mapping protocol from shared/mapping.zod.ts
+// Extended with connector-specific features
+// ============================================================================
+/**
+ * Field Transformation Function (Connector-specific)
+ *
+ * @deprecated Use TransformTypeSchema from shared/mapping.zod.ts instead
+ */
+exports.FieldTransformSchema = zod_1.z.object({
+    type: zod_1.z.enum([
+        'uppercase',
+        'lowercase',
+        'trim',
+        'date_format',
+        'number_format',
+        'custom',
+    ]).describe('Transformation type'),
+    params: zod_1.z.record(zod_1.z.any()).optional().describe('Transformation parameters'),
+    function: zod_1.z.string().optional().describe('Custom JavaScript function for transformation'),
+});
+/**
+ * Connector Field Mapping Configuration
+ *
+ * Extends the base field mapping with connector-specific features
+ * like bidirectional sync modes and data type mapping.
+ */
+exports.FieldMappingSchema = mapping_zod_1.FieldMappingSchema.extend({
+    /**
+     * Data type mapping (connector-specific)
+     */
+    dataType: zod_1.z.enum([
+        'string',
+        'number',
+        'boolean',
+        'date',
+        'datetime',
+        'json',
+        'array',
+    ]).optional().describe('Target data type'),
+    /**
+     * Is this field required?
+     */
+    required: zod_1.z.boolean().default(false).describe('Field is required'),
+    /**
+     * Bidirectional sync mode (connector-specific)
+     */
+    syncMode: zod_1.z.enum([
+        'read_only', // Only sync from external to ObjectStack
+        'write_only', // Only sync from ObjectStack to external
+        'bidirectional', // Sync both ways
+    ]).default('bidirectional').describe('Sync mode'),
+});
+// ============================================================================
+// Data Synchronization Configuration
+// ============================================================================
+/**
+ * Sync Strategy Schema
+ */
+exports.SyncStrategySchema = zod_1.z.enum([
+    'full', // Full refresh (delete all and re-import)
+    'incremental', // Only sync changes since last sync
+    'upsert', // Insert new, update existing
+    'append_only', // Only insert new records
+]).describe('Synchronization strategy');
+/**
+ * Conflict Resolution Strategy
+ */
+exports.ConflictResolutionSchema = zod_1.z.enum([
+    'source_wins', // External system data takes precedence
+    'target_wins', // ObjectStack data takes precedence
+    'latest_wins', // Most recently modified wins
+    'manual', // Flag for manual resolution
+]).describe('Conflict resolution strategy');
+/**
+ * Data Synchronization Configuration
+ */
+exports.DataSyncConfigSchema = zod_1.z.object({
+    /**
+     * Sync strategy
+     */
+    strategy: exports.SyncStrategySchema.optional().default('incremental'),
+    /**
+     * Sync direction
+     */
+    direction: zod_1.z.enum([
+        'import', // External → ObjectStack
+        'export', // ObjectStack → External
+        'bidirectional', // Both ways
+    ]).optional().default('import').describe('Sync direction'),
+    /**
+     * Sync frequency (cron expression)
+     */
+    schedule: zod_1.z.string().optional().describe('Cron expression for scheduled sync'),
+    /**
+     * Enable real-time sync via webhooks
+     */
+    realtimeSync: zod_1.z.boolean().optional().default(false).describe('Enable real-time sync'),
+    /**
+     * Field to track last sync timestamp
+     */
+    timestampField: zod_1.z.string().optional().describe('Field to track last modification time'),
+    /**
+     * Conflict resolution strategy
+     */
+    conflictResolution: exports.ConflictResolutionSchema.optional().default('latest_wins'),
+    /**
+     * Batch size for bulk operations
+     */
+    batchSize: zod_1.z.number().min(1).max(10000).optional().default(1000).describe('Records per batch'),
+    /**
+     * Delete handling
+     */
+    deleteMode: zod_1.z.enum([
+        'hard_delete', // Permanently delete
+        'soft_delete', // Mark as deleted
+        'ignore', // Don't sync deletions
+    ]).optional().default('soft_delete').describe('Delete handling mode'),
+    /**
+     * Filter criteria for selective sync
+     */
+    filters: zod_1.z.record(zod_1.z.any()).optional().describe('Filter criteria for selective sync'),
+});
+// ============================================================================
+// Webhook Configuration
+// ============================================================================
+/**
+ * Webhook Event Schema
+ */
+exports.WebhookEventSchema = zod_1.z.enum([
+    'record.created',
+    'record.updated',
+    'record.deleted',
+    'sync.started',
+    'sync.completed',
+    'sync.failed',
+    'auth.expired',
+    'rate_limit.exceeded',
+]).describe('Webhook event type');
+/**
+ * Webhook Signature Algorithm
+ */
+exports.WebhookSignatureAlgorithmSchema = zod_1.z.enum([
+    'hmac_sha256',
+    'hmac_sha512',
+    'none',
+]).describe('Webhook signature algorithm');
+/**
+ * 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.
+ */
+exports.WebhookConfigSchema = webhook_zod_1.WebhookSchema.extend({
+    /**
+     * Events to listen for
+     * Connector-specific events like sync completion, auth expiry, etc.
+     */
+    events: zod_1.z.array(exports.WebhookEventSchema).optional().describe('Connector events to subscribe to'),
+    /**
+     * Signature algorithm for webhook security
+     */
+    signatureAlgorithm: exports.WebhookSignatureAlgorithmSchema.optional().default('hmac_sha256'),
+});
+// ============================================================================
+// Rate Limiting and Retry Configuration
+// ============================================================================
+/**
+ * Rate Limiting Strategy
+ */
+exports.RateLimitStrategySchema = zod_1.z.enum([
+    'fixed_window', // Fixed time window
+    'sliding_window', // Sliding time window
+    'token_bucket', // Token bucket algorithm
+    'leaky_bucket', // Leaky bucket algorithm
+]).describe('Rate limiting strategy');
+/**
+ * Rate Limiting Configuration
+ */
+exports.RateLimitConfigSchema = zod_1.z.object({
+    /**
+     * Rate limiting strategy
+     */
+    strategy: exports.RateLimitStrategySchema.optional().default('token_bucket'),
+    /**
+     * Maximum requests per window
+     */
+    maxRequests: zod_1.z.number().min(1).describe('Maximum requests per window'),
+    /**
+     * Time window in seconds
+     */
+    windowSeconds: zod_1.z.number().min(1).describe('Time window in seconds'),
+    /**
+     * Burst capacity (for token bucket)
+     */
+    burstCapacity: zod_1.z.number().min(1).optional().describe('Burst capacity'),
+    /**
+     * Respect external system rate limits
+     */
+    respectUpstreamLimits: zod_1.z.boolean().optional().default(true).describe('Respect external rate limit headers'),
+    /**
+     * Custom rate limit headers to check
+     */
+    rateLimitHeaders: zod_1.z.object({
+        remaining: zod_1.z.string().optional().default('X-RateLimit-Remaining').describe('Header for remaining requests'),
+        limit: zod_1.z.string().optional().default('X-RateLimit-Limit').describe('Header for rate limit'),
+        reset: zod_1.z.string().optional().default('X-RateLimit-Reset').describe('Header for reset time'),
+    }).optional().describe('Custom rate limit headers'),
+});
+/**
+ * Retry Strategy
+ */
+exports.RetryStrategySchema = zod_1.z.enum([
+    'exponential_backoff',
+    'linear_backoff',
+    'fixed_delay',
+    'no_retry',
+]).describe('Retry strategy');
+/**
+ * Retry Configuration
+ */
+exports.RetryConfigSchema = zod_1.z.object({
+    /**
+     * Retry strategy
+     */
+    strategy: exports.RetryStrategySchema.optional().default('exponential_backoff'),
+    /**
+     * Maximum retry attempts
+     */
+    maxAttempts: zod_1.z.number().min(0).max(10).optional().default(3).describe('Maximum retry attempts'),
+    /**
+     * Initial delay in milliseconds
+     */
+    initialDelayMs: zod_1.z.number().min(100).optional().default(1000).describe('Initial retry delay in ms'),
+    /**
+     * Maximum delay in milliseconds
+     */
+    maxDelayMs: zod_1.z.number().min(1000).optional().default(60000).describe('Maximum retry delay in ms'),
+    /**
+     * Backoff multiplier (for exponential backoff)
+     */
+    backoffMultiplier: zod_1.z.number().min(1).optional().default(2).describe('Exponential backoff multiplier'),
+    /**
+     * HTTP status codes to retry
+     */
+    retryableStatusCodes: zod_1.z.array(zod_1.z.number()).optional().default([408, 429, 500, 502, 503, 504]).describe('HTTP status codes to retry'),
+    /**
+     * Retry on network errors
+     */
+    retryOnNetworkError: zod_1.z.boolean().optional().default(true).describe('Retry on network errors'),
+    /**
+     * Jitter to add randomness to retry delays
+     */
+    jitter: zod_1.z.boolean().optional().default(true).describe('Add jitter to retry delays'),
+});
+// ============================================================================
+// Base Connector Schema
+// ============================================================================
+/**
+ * Connector Type
+ */
+exports.ConnectorTypeSchema = zod_1.z.enum([
+    'saas', // SaaS application connector
+    'database', // Database connector
+    'file_storage', // File storage connector
+    'message_queue', // Message queue connector
+    'api', // Generic REST/GraphQL API
+    'custom', // Custom connector
+]).describe('Connector type');
+/**
+ * Connector Status
+ */
+exports.ConnectorStatusSchema = zod_1.z.enum([
+    'active', // Connector is active and syncing
+    'inactive', // Connector is configured but disabled
+    'error', // Connector has errors
+    'configuring', // Connector is being set up
+]).describe('Connector status');
+/**
+ * Base Connector Schema
+ * Core connector configuration shared across all connector types
+ */
+exports.ConnectorSchema = zod_1.z.object({
+    /**
+     * Machine name (snake_case)
+     */
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Unique connector identifier'),
+    /**
+     * Human-readable label
+     */
+    label: zod_1.z.string().describe('Display label'),
+    /**
+     * Connector type
+     */
+    type: exports.ConnectorTypeSchema.describe('Connector type'),
+    /**
+     * Description
+     */
+    description: zod_1.z.string().optional().describe('Connector description'),
+    /**
+     * Icon identifier
+     */
+    icon: zod_1.z.string().optional().describe('Icon identifier'),
+    /**
+     * Authentication configuration
+     */
+    authentication: exports.AuthenticationSchema.describe('Authentication configuration'),
+    /**
+     * Data synchronization configuration
+     */
+    syncConfig: exports.DataSyncConfigSchema.optional().describe('Data sync configuration'),
+    /**
+     * Field mappings
+     */
+    fieldMappings: zod_1.z.array(exports.FieldMappingSchema).optional().describe('Field mapping rules'),
+    /**
+     * Webhook configuration
+     */
+    webhooks: zod_1.z.array(exports.WebhookConfigSchema).optional().describe('Webhook configurations'),
+    /**
+     * Rate limiting configuration
+     */
+    rateLimitConfig: exports.RateLimitConfigSchema.optional().describe('Rate limiting configuration'),
+    /**
+     * Retry configuration
+     */
+    retryConfig: exports.RetryConfigSchema.optional().describe('Retry configuration'),
+    /**
+     * Connection timeout in milliseconds
+     */
+    connectionTimeoutMs: zod_1.z.number().min(1000).max(300000).optional().default(30000).describe('Connection timeout in ms'),
+    /**
+     * Request timeout in milliseconds
+     */
+    requestTimeoutMs: zod_1.z.number().min(1000).max(300000).optional().default(30000).describe('Request timeout in ms'),
+    /**
+     * Connector status
+     */
+    status: exports.ConnectorStatusSchema.optional().default('inactive').describe('Connector status'),
+    /**
+     * Enable connector
+     */
+    enabled: zod_1.z.boolean().optional().default(true).describe('Enable connector'),
+    /**
+     * Custom metadata
+     */
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Custom connector metadata'),
+});

package/dist/integration/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Integration Protocol Exports
+ *
+ * External System Connection Protocols
+ * - Connector configurations for SaaS, databases, file storage, message queues
+ * - Authentication methods (OAuth2, API Key, JWT, SAML)
+ * - Data synchronization and field mapping
+ * - Webhooks, rate limiting, and retry strategies
+ */
+export * from './connector.zod';
+export * from './connector/saas.zod';
+export * from './connector/database.zod';
+export * from './connector/file-storage.zod';
+export * from './connector/message-queue.zod';
+//# sourceMappingURL=index.d.ts.map

package/dist/integration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integration/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}

package/dist/integration/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Integration Protocol Exports
+ *
+ * External System Connection Protocols
+ * - Connector configurations for SaaS, databases, file storage, message queues
+ * - Authentication methods (OAuth2, API Key, JWT, SAML)
+ * - Data synchronization and field mapping
+ * - Webhooks, rate limiting, and retry strategies
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core Connector Protocol
+__exportStar(require("./connector.zod"), exports);
+// Connector Templates
+__exportStar(require("./connector/saas.zod"), exports);
+__exportStar(require("./connector/database.zod"), exports);
+__exportStar(require("./connector/file-storage.zod"), exports);
+__exportStar(require("./connector/message-queue.zod"), exports);