@objectstack/spec 0.6.1 → 0.7.2

package/dist/automation/sync.zod.d.ts.map

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

package/dist/automation/sync.zod.js

@@ -1,16 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Sync = exports.SyncExecutionResultSchema = exports.SyncExecutionStatusSchema = exports.DataSyncConfigSchema = exports.DataDestinationConfigSchema = exports.DataSourceConfigSchema = exports.FieldMappingSchema = exports.ConflictResolutionSchema = exports.SyncModeSchema = exports.SyncDirectionSchema = void 0;
+exports.Sync = exports.SyncExecutionResultSchema = exports.SyncExecutionStatusSchema = exports.DataSyncConfigSchema = exports.DataDestinationConfigSchema = exports.DataSourceConfigSchema = exports.ConflictResolutionSchema = exports.SyncModeSchema = exports.SyncDirectionSchema = void 0;
 const zod_1 = require("zod");
+const mapping_zod_1 = require("../shared/mapping.zod");
 /**
- * Data Sync Protocol
+ * Data Sync Protocol - LEVEL 1: Simple Synchronization
  *
  * Inspired by Salesforce Connect, Segment Sync, and Census Reverse ETL.
  *
+ * **Positioning in 3-Layer Architecture:**
+ * - **L1: Simple Sync** (THIS FILE) - Business users - Sync Salesforce to Sheets
+ * - **L2: ETL Pipeline** (automation/etl.zod.ts) - Data engineers - Aggregate 10 sources to warehouse
+ * - **L3: Enterprise Connector** (integration/connector.zod.ts) - System integrators - Full SAP integration
+ *
  * Data sync provides bidirectional or unidirectional data synchronization
  * between ObjectStack and external systems, maintaining data consistency
  * across platforms.
  *
+ * **SCOPE: Simple field mappings only. NO complex transformations.**
+ * For complex transformations (joins, aggregates, custom SQL), use ETL Pipeline (Level 2).
+ *
+ * ## When to Use This Layer
+ *
+ * **Use Simple Sync when:**
+ * - Syncing 1:1 fields between two systems
+ * - Simple field transformations (uppercase, cast, etc.)
+ * - No complex logic required
+ * - Business users need to configure integrations
+ *
+ * **Examples:**
+ * - Salesforce Contact ↔ Google Sheets
+ * - HubSpot Company ↔ CRM Account
+ * - Shopify Orders → Accounting System
+ *
+ * **When to upgrade:**
+ * - Need multi-source joins → Use {@link file://./etl.zod.ts | ETL Pipeline}
+ * - Need complex authentication/webhooks → Use {@link file://../integration/connector.zod.ts | Enterprise Connector}
+ * - Need aggregations or data warehousing → Use {@link file://./etl.zod.ts | ETL Pipeline}
+ *
+ * @see {@link file://./etl.zod.ts} for Level 2 (data engineering)
+ * @see {@link file://../integration/connector.zod.ts} for Level 3 (enterprise integration)
+ *
  * ## Use Cases
  *
  * 1. **CRM Integration**
@@ -82,36 +112,13 @@ exports.ConflictResolutionSchema = zod_1.z.enum([
     'merge', // Smart merge (custom logic)
 ]);
 /**
- * Field Mapping Schema
+ * Field Mapping for Data Sync
+ *
+ * Uses the canonical field mapping protocol from shared/mapping.zod.ts
+ * for simple 1:1 field transformations.
  *
- * Maps fields between source and destination systems.
+ * @see {@link FieldMappingSchema} for the base field mapping schema
  */
-exports.FieldMappingSchema = zod_1.z.object({
-    /**
-     * Source field name
-     */
-    sourceField: zod_1.z.string().describe('Source field name'),
-    /**
-     * Destination field name
-     */
-    destinationField: zod_1.z.string().describe('Destination field name'),
-    /**
-     * Transformation formula
-     * JavaScript expression to transform the value
-     *
-     * @example "value.toUpperCase()"
-     * @example "new Date(value).toISOString()"
-     */
-    transform: zod_1.z.string().optional().describe('Transformation formula'),
-    /**
-     * Default value if source is null/undefined
-     */
-    default: zod_1.z.any().optional().describe('Default value'),
-    /**
-     * Whether to sync null values
-     */
-    syncNull: zod_1.z.boolean().default(false).describe('Sync null values'),
-});
 /**
  * Data Source Configuration
  */
@@ -172,7 +179,7 @@ exports.DataDestinationConfigSchema = zod_1.z.object({
      */
     mapping: zod_1.z.union([
         zod_1.z.record(zod_1.z.string()), // Simple mapping: { sourceField: 'destField' }
-        zod_1.z.array(exports.FieldMappingSchema), // Advanced mapping with transformations
+        zod_1.z.array(mapping_zod_1.FieldMappingSchema), // Advanced mapping with transformations
     ]).optional().describe('Field mappings'),
     /**
      * External resource identifier

package/dist/automation/{connector.zod.d.ts → trigger-registry.zod.d.ts}

@@ -1,44 +1,59 @@
 import { z } from 'zod';
 /**
- * Connector Registry Protocol
+ * Trigger Registry Protocol
  *
+ * Lightweight automation triggers for simple integrations.
  * Inspired by Zapier, n8n, and Workato connector architectures.
  *
- * Connectors are reusable components that provide pre-built integrations with
- * external systems (SaaS, databases, APIs, etc.).
+ * ## When to use Trigger Registry vs. Integration Connector?
+ *
+ * **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
+ * - Webhook-based or polling triggers for automation workflows
+ *
+ * **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
  *
  * ## Use Cases
  *
- * 1. **SaaS Integration**
- *    - Connect to Salesforce, HubSpot, Stripe, etc.
- *    - Pre-built authentication and API clients
- *    - Standard operations (CRUD, search, etc.)
+ * 1. **Simple Automation Triggers**
+ *    - Slack notifications on record updates
+ *    - Twilio SMS on workflow events
+ *    - SendGrid email templates
  *
- * 2. **Database Connectivity**
- *    - Connect to PostgreSQL, MySQL, MongoDB, etc.
- *    - Query builders and connection pooling
- *    - Schema introspection
+ * 2. **Lightweight Operations**
+ *    - Single-action integrations (send, notify, log)
+ *    - No bidirectional sync required
+ *    - Webhook receivers for incoming events
  *
- * 3. **Third-Party Services**
- *    - Payment processors (Stripe, PayPal)
- *    - Communication (Twilio, SendGrid, Slack)
- *    - Storage (S3, Google Drive, Dropbox)
+ * 3. **Quick Integrations**
+ *    - Payment webhooks (Stripe, PayPal)
+ *    - Communication triggers (Twilio, SendGrid, Slack)
+ *    - Simple API calls to third-party services
  *
  * @see https://zapier.com/developer/documentation/v2/
  * @see https://docs.n8n.io/integrations/creating-nodes/
+ * @see ../../integration/connector.zod.ts for enterprise connectors
  *
  * @example
  * ```typescript
- * const stripeConnector: Connector = {
- *   id: 'stripe',
- *   name: 'Stripe',
- *   category: 'payment',
+ * const slackNotifier: Connector = {
+ *   id: 'slack_notify',
+ *   name: 'Slack Notification',
+ *   category: 'communication',
  *   authentication: {
  *     type: 'apiKey',
- *     fields: [{ name: 'api_key', label: 'API Key', type: 'password' }]
+ *     fields: [{ name: 'webhook_url', label: 'Webhook URL', type: 'url' }]
  *   },
  *   operations: [
- *     { id: 'create_customer', name: 'Create Customer', type: 'write' }
+ *     { id: 'send_message', name: 'Send Message', type: 'action' }
  *   ]
  * }
  * ```
@@ -292,7 +307,7 @@ export declare const AuthenticationSchema: z.ZodObject<{
         method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+    type: "custom" | "none" | "oauth2" | "basic" | "apiKey" | "bearer" | "oauth1";
     fields?: {
         type: "text" | "url" | "password" | "select";
         required: boolean;
@@ -318,7 +333,7 @@ export declare const AuthenticationSchema: z.ZodObject<{
         scopes?: string[] | undefined;
     } | undefined;
 }, {
-    type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+    type: "custom" | "none" | "oauth2" | "basic" | "apiKey" | "bearer" | "oauth1";
     fields?: {
         label: string;
         name: string;
@@ -498,7 +513,7 @@ export declare const ConnectorOperationSchema: z.ZodObject<{
      */
     supportsFiltering: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+    type: "search" | "delete" | "read" | "write" | "action" | "trigger";
     name: string;
     id: string;
     supportsPagination: boolean;
@@ -517,7 +532,7 @@ export declare const ConnectorOperationSchema: z.ZodObject<{
     outputSchema?: Record<string, any> | undefined;
     sampleOutput?: any;
 }, {
-    type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+    type: "search" | "delete" | "read" | "write" | "action" | "trigger";
     name: string;
     id: string;
     description?: string | undefined;
@@ -573,7 +588,7 @@ export declare const ConnectorTriggerSchema: z.ZodObject<{
      */
     pollingIntervalMs: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    type: "webhook" | "polling" | "stream";
+    type: "webhook" | "stream" | "polling";
     name: string;
     id: string;
     description?: string | undefined;
@@ -581,7 +596,7 @@ export declare const ConnectorTriggerSchema: z.ZodObject<{
     outputSchema?: Record<string, any> | undefined;
     pollingIntervalMs?: number | undefined;
 }, {
-    type: "webhook" | "polling" | "stream";
+    type: "webhook" | "stream" | "polling";
     name: string;
     id: string;
     description?: string | undefined;
@@ -755,7 +770,7 @@ export declare const ConnectorSchema: z.ZodObject<{
             method?: "GET" | "POST" | "PUT" | "DELETE" | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+        type: "custom" | "none" | "oauth2" | "basic" | "apiKey" | "bearer" | "oauth1";
         fields?: {
             type: "text" | "url" | "password" | "select";
             required: boolean;
@@ -781,7 +796,7 @@ export declare const ConnectorSchema: z.ZodObject<{
             scopes?: string[] | undefined;
         } | undefined;
     }, {
-        type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+        type: "custom" | "none" | "oauth2" | "basic" | "apiKey" | "bearer" | "oauth1";
         fields?: {
             label: string;
             name: string;
@@ -899,7 +914,7 @@ export declare const ConnectorSchema: z.ZodObject<{
          */
         supportsFiltering: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+        type: "search" | "delete" | "read" | "write" | "action" | "trigger";
         name: string;
         id: string;
         supportsPagination: boolean;
@@ -918,7 +933,7 @@ export declare const ConnectorSchema: z.ZodObject<{
         outputSchema?: Record<string, any> | undefined;
         sampleOutput?: any;
     }, {
-        type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+        type: "search" | "delete" | "read" | "write" | "action" | "trigger";
         name: string;
         id: string;
         description?: string | undefined;
@@ -971,7 +986,7 @@ export declare const ConnectorSchema: z.ZodObject<{
          */
         pollingIntervalMs: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        type: "webhook" | "polling" | "stream";
+        type: "webhook" | "stream" | "polling";
         name: string;
         id: string;
         description?: string | undefined;
@@ -979,7 +994,7 @@ export declare const ConnectorSchema: z.ZodObject<{
         outputSchema?: Record<string, any> | undefined;
         pollingIntervalMs?: number | undefined;
     }, {
-        type: "webhook" | "polling" | "stream";
+        type: "webhook" | "stream" | "polling";
         name: string;
         id: string;
         description?: string | undefined;
@@ -995,12 +1010,12 @@ export declare const ConnectorSchema: z.ZodObject<{
         requestsPerMinute: z.ZodOptional<z.ZodNumber>;
         requestsPerHour: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        requestsPerMinute?: number | undefined;
         requestsPerSecond?: number | undefined;
+        requestsPerMinute?: number | undefined;
         requestsPerHour?: number | undefined;
     }, {
-        requestsPerMinute?: number | undefined;
         requestsPerSecond?: number | undefined;
+        requestsPerMinute?: number | undefined;
         requestsPerHour?: number | undefined;
     }>>;
     /**
@@ -1035,9 +1050,8 @@ export declare const ConnectorSchema: z.ZodObject<{
     name: string;
     id: string;
     category: "database" | "storage" | "other" | "analytics" | "crm" | "payment" | "communication" | "marketing" | "accounting" | "hr" | "productivity" | "ecommerce" | "support" | "devtools" | "social";
-    verified: boolean;
     authentication: {
-        type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+        type: "custom" | "none" | "oauth2" | "basic" | "apiKey" | "bearer" | "oauth1";
         fields?: {
             type: "text" | "url" | "password" | "select";
             required: boolean;
@@ -1063,23 +1077,22 @@ export declare const ConnectorSchema: z.ZodObject<{
             scopes?: string[] | undefined;
         } | undefined;
     };
+    verified: boolean;
     tags?: string[] | undefined;
     description?: string | undefined;
-    icon?: string | undefined;
     version?: string | undefined;
-    author?: string | undefined;
-    documentation?: string | undefined;
-    license?: string | undefined;
+    icon?: string | undefined;
     metadata?: Record<string, any> | undefined;
-    homepage?: string | undefined;
-    baseUrl?: string | undefined;
     rateLimit?: {
-        requestsPerMinute?: number | undefined;
         requestsPerSecond?: number | undefined;
+        requestsPerMinute?: number | undefined;
         requestsPerHour?: number | undefined;
     } | undefined;
+    author?: string | undefined;
+    documentation?: string | undefined;
+    license?: string | undefined;
     operations?: {
-        type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+        type: "search" | "delete" | "read" | "write" | "action" | "trigger";
         name: string;
         id: string;
         supportsPagination: boolean;
@@ -1098,8 +1111,10 @@ export declare const ConnectorSchema: z.ZodObject<{
         outputSchema?: Record<string, any> | undefined;
         sampleOutput?: any;
     }[] | undefined;
+    homepage?: string | undefined;
+    baseUrl?: string | undefined;
     triggers?: {
-        type: "webhook" | "polling" | "stream";
+        type: "webhook" | "stream" | "polling";
         name: string;
         id: string;
         description?: string | undefined;
@@ -1112,7 +1127,7 @@ export declare const ConnectorSchema: z.ZodObject<{
     id: string;
     category: "database" | "storage" | "other" | "analytics" | "crm" | "payment" | "communication" | "marketing" | "accounting" | "hr" | "productivity" | "ecommerce" | "support" | "devtools" | "social";
     authentication: {
-        type: "custom" | "none" | "apiKey" | "basic" | "bearer" | "oauth2" | "oauth1";
+        type: "custom" | "none" | "oauth2" | "basic" | "apiKey" | "bearer" | "oauth1";
         fields?: {
             label: string;
             name: string;
@@ -1140,22 +1155,19 @@ export declare const ConnectorSchema: z.ZodObject<{
     };
     tags?: string[] | undefined;
     description?: string | undefined;
-    icon?: string | undefined;
     version?: string | undefined;
-    author?: string | undefined;
-    documentation?: string | undefined;
-    license?: string | undefined;
+    icon?: string | undefined;
     metadata?: Record<string, any> | undefined;
-    homepage?: string | undefined;
-    baseUrl?: string | undefined;
     rateLimit?: {
-        requestsPerMinute?: number | undefined;
         requestsPerSecond?: number | undefined;
+        requestsPerMinute?: number | undefined;
         requestsPerHour?: number | undefined;
     } | undefined;
-    verified?: boolean | undefined;
+    author?: string | undefined;
+    documentation?: string | undefined;
+    license?: string | undefined;
     operations?: {
-        type: "delete" | "search" | "read" | "write" | "action" | "trigger";
+        type: "search" | "delete" | "read" | "write" | "action" | "trigger";
         name: string;
         id: string;
         description?: string | undefined;
@@ -1174,8 +1186,11 @@ export declare const ConnectorSchema: z.ZodObject<{
         supportsPagination?: boolean | undefined;
         supportsFiltering?: boolean | undefined;
     }[] | undefined;
+    homepage?: string | undefined;
+    baseUrl?: string | undefined;
+    verified?: boolean | undefined;
     triggers?: {
-        type: "webhook" | "polling" | "stream";
+        type: "webhook" | "stream" | "polling";
         name: string;
         id: string;
         description?: string | undefined;
@@ -1232,25 +1247,25 @@ export declare const ConnectorInstanceSchema: z.ZodObject<{
      */
     testStatus: z.ZodDefault<z.ZodEnum<["unknown", "success", "failed"]>>;
 }, "strip", z.ZodTypeAny, {
+    credentials: Record<string, any>;
     name: string;
     active: boolean;
     id: string;
-    credentials: Record<string, any>;
     connectorId: string;
     testStatus: "unknown" | "success" | "failed";
     description?: string | undefined;
-    config?: Record<string, any> | undefined;
     createdAt?: string | undefined;
+    config?: Record<string, any> | undefined;
     lastTestedAt?: string | undefined;
 }, {
+    credentials: Record<string, any>;
     name: string;
     id: string;
-    credentials: Record<string, any>;
     connectorId: string;
     description?: string | undefined;
     active?: boolean | undefined;
-    config?: Record<string, any> | undefined;
     createdAt?: string | undefined;
+    config?: Record<string, any> | undefined;
     lastTestedAt?: string | undefined;
     testStatus?: "unknown" | "success" | "failed" | undefined;
 }>;
@@ -1281,4 +1296,4 @@ export declare const Connector: {
         scopes?: string[];
     }) => Connector;
 };
-//# sourceMappingURL=connector.zod.d.ts.map
+//# sourceMappingURL=trigger-registry.zod.d.ts.map

package/dist/automation/trigger-registry.zod.d.ts.map

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

package/dist/automation/{connector.zod.js → trigger-registry.zod.js}

@@ -3,45 +3,60 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Connector = exports.ConnectorInstanceSchema = exports.ConnectorSchema = exports.ConnectorTriggerSchema = exports.ConnectorOperationSchema = exports.OperationParameterSchema = exports.OperationTypeSchema = exports.AuthenticationSchema = exports.OAuth2ConfigSchema = exports.AuthFieldSchema = exports.AuthenticationTypeSchema = exports.ConnectorCategorySchema = void 0;
 const zod_1 = require("zod");
 /**
- * Connector Registry Protocol
+ * Trigger Registry Protocol
  *
+ * Lightweight automation triggers for simple integrations.
  * Inspired by Zapier, n8n, and Workato connector architectures.
  *
- * Connectors are reusable components that provide pre-built integrations with
- * external systems (SaaS, databases, APIs, etc.).
+ * ## When to use Trigger Registry vs. Integration Connector?
+ *
+ * **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
+ * - Webhook-based or polling triggers for automation workflows
+ *
+ * **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
  *
  * ## Use Cases
  *
- * 1. **SaaS Integration**
- *    - Connect to Salesforce, HubSpot, Stripe, etc.
- *    - Pre-built authentication and API clients
- *    - Standard operations (CRUD, search, etc.)
+ * 1. **Simple Automation Triggers**
+ *    - Slack notifications on record updates
+ *    - Twilio SMS on workflow events
+ *    - SendGrid email templates
  *
- * 2. **Database Connectivity**
- *    - Connect to PostgreSQL, MySQL, MongoDB, etc.
- *    - Query builders and connection pooling
- *    - Schema introspection
+ * 2. **Lightweight Operations**
+ *    - Single-action integrations (send, notify, log)
+ *    - No bidirectional sync required
+ *    - Webhook receivers for incoming events
  *
- * 3. **Third-Party Services**
- *    - Payment processors (Stripe, PayPal)
- *    - Communication (Twilio, SendGrid, Slack)
- *    - Storage (S3, Google Drive, Dropbox)
+ * 3. **Quick Integrations**
+ *    - Payment webhooks (Stripe, PayPal)
+ *    - Communication triggers (Twilio, SendGrid, Slack)
+ *    - Simple API calls to third-party services
  *
  * @see https://zapier.com/developer/documentation/v2/
  * @see https://docs.n8n.io/integrations/creating-nodes/
+ * @see ../../integration/connector.zod.ts for enterprise connectors
  *
  * @example
  * ```typescript
- * const stripeConnector: Connector = {
- *   id: 'stripe',
- *   name: 'Stripe',
- *   category: 'payment',
+ * const slackNotifier: Connector = {
+ *   id: 'slack_notify',
+ *   name: 'Slack Notification',
+ *   category: 'communication',
  *   authentication: {
  *     type: 'apiKey',
- *     fields: [{ name: 'api_key', label: 'API Key', type: 'password' }]
+ *     fields: [{ name: 'webhook_url', label: 'Webhook URL', type: 'url' }]
  *   },
  *   operations: [
- *     { id: 'create_customer', name: 'Create Customer', type: 'write' }
+ *     { id: 'send_message', name: 'Send Message', type: 'action' }
  *   ]
  * }
  * ```