@contractspec/example.integration-hub 0.0.0-canary-20260113170453

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,156 @@
+# @contractspec/example.integration-hub
+
+Website: https://contractspec.io/
+
+
+A comprehensive integration hub example demonstrating ContractSpec principles for data synchronization.
+
+## Features
+
+- **Multi-Provider Support**: Connect to various external systems (Salesforce, HubSpot, etc.)
+- **Bidirectional Sync**: INBOUND, OUTBOUND, or BIDIRECTIONAL data flow
+- **Field Mapping**: Configurable field mappings with transforms
+- **Sync Engine**: Change detection, deduplication, and error handling
+- **Scheduled Sync**: Cron-based scheduled synchronization
+- **Feature Flag Integration**: Control integration availability
+- **Full Audit Trail**: Track all sync operations
+
+## Entities
+
+### Core
+- `Integration` - Integration definition
+- `Connection` - Authenticated connection to external system
+- `SyncConfig` - Sync configuration for object pairs
+- `FieldMapping` - Field-level mapping configuration
+
+### Sync Execution
+- `SyncRun` - A single sync execution
+- `SyncLog` - Log entries for a sync run
+- `SyncRecord` - Tracks synced records for deduplication
+
+## Contracts
+
+### Integration Management
+- `integration.create` - Create a new integration
+- `integration.connection.create` - Create a connection
+
+### Sync Configuration
+- `integration.syncConfig.create` - Create sync config
+- `integration.fieldMapping.add` - Add field mapping
+
+### Sync Execution
+- `integration.sync.trigger` - Trigger manual sync
+- `integration.syncRun.list` - List sync history
+
+## Field Mapping Types
+
+- **DIRECT**: Direct field copy
+- **TRANSFORM**: Apply transformation expression
+- **LOOKUP**: Lookup from another object
+- **CONSTANT**: Fixed value
+- **COMPUTED**: Computed from multiple fields
+
+## Sync Engine
+
+The sync engine handles:
+
+1. **Change Detection**: Uses checksums to detect changes
+2. **Transformation**: Applies field mappings
+3. **Validation**: Validates required fields
+4. **Deduplication**: Tracks synced records
+
+```typescript
+import { createSyncEngine, BasicFieldTransformer } from '@contractspec/example.integration-hub/sync-engine';
+
+const engine = createSyncEngine();
+
+const result = engine.transformRecord(
+  { id: '123', data: { FirstName: 'John', LastName: 'Doe' } },
+  [
+    { sourceField: 'FirstName', targetField: 'first_name', mappingType: 'DIRECT' },
+    { sourceField: 'LastName', targetField: 'last_name', mappingType: 'TRANSFORM', transformExpression: 'uppercase' },
+  ],
+  context
+);
+// { id: '123', data: { first_name: 'John', last_name: 'DOE' } }
+```
+
+## Transform Expressions
+
+- `uppercase` - Convert to uppercase
+- `lowercase` - Convert to lowercase
+- `trim` - Trim whitespace
+- `default:value` - Set default value
+- `concat:separator` - Join array
+- `split:separator` - Split string
+- `number` - Convert to number
+- `boolean` - Convert to boolean
+- `string` - Convert to string
+
+## Events
+
+- `integration.created` - Integration created
+- `integration.connection.created` - Connection created
+- `integration.connection.statusChanged` - Connection status changed
+- `integration.syncConfig.created` - Sync config created
+- `integration.sync.started` - Sync started
+- `integration.sync.completed` - Sync completed
+- `integration.sync.failed` - Sync failed
+- `integration.record.synced` - Record synced
+
+## Usage
+
+```typescript
+import { 
+  CreateIntegrationContract,
+  CreateSyncConfigContract,
+  TriggerSyncContract,
+  integrationHubSchemaContribution 
+} from '@contractspec/example.integration-hub';
+
+// Create integration
+const integration = await executeContract(CreateIntegrationContract, {
+  name: 'Salesforce CRM',
+  slug: 'salesforce-crm',
+  provider: 'salesforce',
+});
+
+// Create sync config
+const syncConfig = await executeContract(CreateSyncConfigContract, {
+  integrationId: integration.id,
+  connectionId: connection.id,
+  name: 'Contacts Sync',
+  direction: 'BIDIRECTIONAL',
+  sourceObject: 'Contact',
+  targetObject: 'contacts',
+});
+
+// Trigger sync
+const run = await executeContract(TriggerSyncContract, {
+  syncConfigId: syncConfig.id,
+});
+```
+
+## Dependencies
+
+- `@contractspec/lib.identity-rbac` - User identity and roles
+- `@contractspec/lib.feature-flags` - Feature flag control
+- `@contractspec/lib.files` - Import/export file handling
+- `@contractspec/lib.jobs` - Background sync jobs
+- `@contractspec/module.audit-trail` - Action auditing
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/dist/connection/connection.enum.d.ts

@@ -0,0 +1,10 @@
+import * as _contractspec_lib_schema55 from "@contractspec/lib.schema";
+
+//#region src/connection/connection.enum.d.ts
+/**
+ * Connection status enum.
+ */
+declare const ConnectionStatusEnum: _contractspec_lib_schema55.EnumType<[string, string, string, string, string]>;
+//#endregion
+export { ConnectionStatusEnum };
+//# sourceMappingURL=connection.enum.d.ts.map

package/dist/connection/connection.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.enum.d.ts","names":[],"sources":["../../src/connection/connection.enum.ts"],"sourcesContent":[],"mappings":";;;;;;AAKa,cAAA,oBAMX,EAAA,0BAAA,CAN+B,QAAA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA"}

package/dist/connection/connection.enum.js

@@ -0,0 +1,17 @@
+import { defineEnum } from "@contractspec/lib.schema";
+
+//#region src/connection/connection.enum.ts
+/**
+* Connection status enum.
+*/
+const ConnectionStatusEnum = defineEnum("ConnectionStatus", [
+	"PENDING",
+	"CONNECTED",
+	"DISCONNECTED",
+	"ERROR",
+	"EXPIRED"
+]);
+
+//#endregion
+export { ConnectionStatusEnum };
+//# sourceMappingURL=connection.enum.js.map

package/dist/connection/connection.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.enum.js","names":[],"sources":["../../src/connection/connection.enum.ts"],"sourcesContent":["import { defineEnum } from '@contractspec/lib.schema';\n\n/**\n * Connection status enum.\n */\nexport const ConnectionStatusEnum = defineEnum('ConnectionStatus', [\n  'PENDING',\n  'CONNECTED',\n  'DISCONNECTED',\n  'ERROR',\n  'EXPIRED',\n]);\n"],"mappings":";;;;;;AAKA,MAAa,uBAAuB,WAAW,oBAAoB;CACjE;CACA;CACA;CACA;CACA;CACD,CAAC"}

package/dist/connection/connection.operation.d.ts

@@ -0,0 +1,107 @@
+import * as _contractspec_lib_contracts16 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema56 from "@contractspec/lib.schema";
+
+//#region src/connection/connection.operation.d.ts
+/**
+ * Create a connection to an external system.
+ */
+declare const CreateConnectionContract: _contractspec_lib_contracts16.OperationSpec<_contractspec_lib_schema56.SchemaModel<{
+  integrationId: {
+    type: _contractspec_lib_schema56.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _contractspec_lib_schema56.FieldType<string, string>;
+    isOptional: false;
+  };
+  authType: {
+    type: _contractspec_lib_schema56.FieldType<string, string>;
+    isOptional: false;
+  };
+  credentials: {
+    type: _contractspec_lib_schema56.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+}>, _contractspec_lib_schema56.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema56.FieldType<string, string>;
+    isOptional: false;
+  };
+  integrationId: {
+    type: _contractspec_lib_schema56.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _contractspec_lib_schema56.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema56.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  authType: {
+    type: _contractspec_lib_schema56.FieldType<string, string>;
+    isOptional: false;
+  };
+  externalAccountName: {
+    type: _contractspec_lib_schema56.FieldType<string, string>;
+    isOptional: true;
+  };
+  connectedAt: {
+    type: _contractspec_lib_schema56.FieldType<Date, string>;
+    isOptional: true;
+  };
+  lastHealthCheck: {
+    type: _contractspec_lib_schema56.FieldType<Date, string>;
+    isOptional: true;
+  };
+  healthStatus: {
+    type: _contractspec_lib_schema56.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, {
+  key: string;
+  version: string;
+  when: string;
+  payload: _contractspec_lib_schema56.SchemaModel<{
+    id: {
+      type: _contractspec_lib_schema56.FieldType<string, string>;
+      isOptional: false;
+    };
+    integrationId: {
+      type: _contractspec_lib_schema56.FieldType<string, string>;
+      isOptional: false;
+    };
+    name: {
+      type: _contractspec_lib_schema56.FieldType<string, string>;
+      isOptional: false;
+    };
+    status: {
+      type: _contractspec_lib_schema56.EnumType<[string, string, string, string, string]>;
+      isOptional: false;
+    };
+    authType: {
+      type: _contractspec_lib_schema56.FieldType<string, string>;
+      isOptional: false;
+    };
+    externalAccountName: {
+      type: _contractspec_lib_schema56.FieldType<string, string>;
+      isOptional: true;
+    };
+    connectedAt: {
+      type: _contractspec_lib_schema56.FieldType<Date, string>;
+      isOptional: true;
+    };
+    lastHealthCheck: {
+      type: _contractspec_lib_schema56.FieldType<Date, string>;
+      isOptional: true;
+    };
+    healthStatus: {
+      type: _contractspec_lib_schema56.FieldType<string, string>;
+      isOptional: true;
+    };
+  }>;
+}[]>;
+//#endregion
+export { CreateConnectionContract };
+//# sourceMappingURL=connection.operation.d.ts.map

package/dist/connection/connection.operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.operation.d.ts","names":[],"sources":["../../src/connection/connection.operation.ts"],"sourcesContent":[],"mappings":";;;;;;;cAWa,wDAAwB,yCAAA;EAAxB,aAAA,EAAA;IAiDX,IAAA,EAAA,0BAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;8CAjDmC,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;;;;;;UAAA,0BAAA,CAAA;;;;;;;;;;;;6CAAA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;IAAA,UAAA,EAAA,KAAA"}

package/dist/connection/connection.operation.js

@@ -0,0 +1,63 @@
+import { ConnectionModel, CreateConnectionInputModel } from "./connection.schema.js";
+import { defineCommand } from "@contractspec/lib.contracts/operations";
+
+//#region src/connection/connection.operation.ts
+const OWNERS = ["@example.integration-hub"];
+/**
+* Create a connection to an external system.
+*/
+const CreateConnectionContract = defineCommand({
+	meta: {
+		key: "integration.connection.create",
+		version: "1.0.0",
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"integration",
+			"connection",
+			"create"
+		],
+		description: "Create a connection to an external system.",
+		goal: "Authenticate with external systems.",
+		context: "Connection setup."
+	},
+	io: {
+		input: CreateConnectionInputModel,
+		output: ConnectionModel
+	},
+	policy: { auth: "user" },
+	sideEffects: {
+		emits: [{
+			key: "integration.connection.created",
+			version: "1.0.0",
+			when: "Connection created",
+			payload: ConnectionModel
+		}],
+		audit: ["integration.connection.created"]
+	},
+	acceptance: {
+		scenarios: [{
+			key: "create-connection-happy-path",
+			given: ["User is authenticated"],
+			when: ["User creates connection with valid credentials"],
+			then: ["Connection is created", "ConnectionCreated event is emitted"]
+		}],
+		examples: [{
+			key: "connect-crm",
+			input: {
+				name: "Salesforce Prod",
+				integrationId: "salesforce",
+				credentials: { clientId: "xxx" }
+			},
+			output: {
+				id: "conn-123",
+				status: "connected",
+				connectedAt: "2025-01-01T12:00:00Z"
+			}
+		}]
+	}
+});
+
+//#endregion
+export { CreateConnectionContract };
+//# sourceMappingURL=connection.operation.js.map

package/dist/connection/connection.operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.operation.js","names":[],"sources":["../../src/connection/connection.operation.ts"],"sourcesContent":["import { defineCommand } from '@contractspec/lib.contracts/operations';\nimport {\n  ConnectionModel,\n  CreateConnectionInputModel,\n} from './connection.schema';\n\nconst OWNERS = ['@example.integration-hub'] as const;\n\n/**\n * Create a connection to an external system.\n */\nexport const CreateConnectionContract = defineCommand({\n  meta: {\n    key: 'integration.connection.create',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['integration', 'connection', 'create'],\n    description: 'Create a connection to an external system.',\n    goal: 'Authenticate with external systems.',\n    context: 'Connection setup.',\n  },\n  io: { input: CreateConnectionInputModel, output: ConnectionModel },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'integration.connection.created',\n        version: '1.0.0',\n        when: 'Connection created',\n        payload: ConnectionModel,\n      },\n    ],\n    audit: ['integration.connection.created'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'create-connection-happy-path',\n        given: ['User is authenticated'],\n        when: ['User creates connection with valid credentials'],\n        then: ['Connection is created', 'ConnectionCreated event is emitted'],\n      },\n    ],\n    examples: [\n      {\n        key: 'connect-crm',\n        input: {\n          name: 'Salesforce Prod',\n          integrationId: 'salesforce',\n          credentials: { clientId: 'xxx' },\n        },\n        output: {\n          id: 'conn-123',\n          status: 'connected',\n          connectedAt: '2025-01-01T12:00:00Z',\n        },\n      },\n    ],\n  },\n});\n"],"mappings":";;;;AAMA,MAAM,SAAS,CAAC,2BAA2B;;;;AAK3C,MAAa,2BAA2B,cAAc;CACpD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAe;GAAc;GAAS;EAC7C,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EAAE,OAAO;EAA4B,QAAQ;EAAiB;CAClE,QAAQ,EAAE,MAAM,QAAQ;CACxB,aAAa;EACX,OAAO,CACL;GACE,KAAK;GACL,SAAS;GACT,MAAM;GACN,SAAS;GACV,CACF;EACD,OAAO,CAAC,iCAAiC;EAC1C;CACD,YAAY;EACV,WAAW,CACT;GACE,KAAK;GACL,OAAO,CAAC,wBAAwB;GAChC,MAAM,CAAC,iDAAiD;GACxD,MAAM,CAAC,yBAAyB,qCAAqC;GACtE,CACF;EACD,UAAU,CACR;GACE,KAAK;GACL,OAAO;IACL,MAAM;IACN,eAAe;IACf,aAAa,EAAE,UAAU,OAAO;IACjC;GACD,QAAQ;IACN,IAAI;IACJ,QAAQ;IACR,aAAa;IACd;GACF,CACF;EACF;CACF,CAAC"}

package/dist/connection/connection.presentation.d.ts

@@ -0,0 +1,8 @@
+import * as _contractspec_lib_contracts17 from "@contractspec/lib.contracts";
+
+//#region src/connection/connection.presentation.d.ts
+declare const ConnectionListPresentation: _contractspec_lib_contracts17.PresentationSpec;
+declare const ConnectionSetupPresentation: _contractspec_lib_contracts17.PresentationSpec;
+//#endregion
+export { ConnectionListPresentation, ConnectionSetupPresentation };
+//# sourceMappingURL=connection.presentation.d.ts.map

package/dist/connection/connection.presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.presentation.d.ts","names":[],"sources":["../../src/connection/connection.presentation.ts"],"sourcesContent":[],"mappings":";;;cAGa,4BAuBX,6BAAA,CAvBqC;cAyB1B,6BAuBX,6BAAA,CAvBsC"}

package/dist/connection/connection.presentation.js

@@ -0,0 +1,60 @@
+import { ConnectionModel } from "./connection.schema.js";
+import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
+
+//#region src/connection/connection.presentation.ts
+const ConnectionListPresentation = definePresentation({
+	meta: {
+		key: "integration.connection.list",
+		version: "1.0.0",
+		title: "Connection List",
+		description: "List of integration connections",
+		domain: "integration",
+		owners: ["@integration-team"],
+		tags: [
+			"integration",
+			"connection",
+			"list"
+		],
+		stability: StabilityEnum.Experimental,
+		goal: "Provide an overview of all established integration connections.",
+		context: "The primary management view for integration hubs."
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "ConnectionList",
+		props: ConnectionModel
+	},
+	targets: ["react", "markdown"],
+	policy: { flags: ["integration.enabled"] }
+});
+const ConnectionSetupPresentation = definePresentation({
+	meta: {
+		key: "integration.connection.setup",
+		version: "1.0.0",
+		title: "Connection Setup",
+		description: "Setup wizard for creating integration connections",
+		domain: "integration",
+		owners: ["@integration-team"],
+		tags: [
+			"integration",
+			"connection",
+			"setup"
+		],
+		stability: StabilityEnum.Experimental,
+		goal: "Guide users through the multi-step process of connecting to a new integration.",
+		context: "The onboarding flow for new integrations."
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "ConnectionSetup",
+		props: ConnectionModel
+	},
+	targets: ["react"],
+	policy: { flags: ["integration.enabled"] }
+});
+
+//#endregion
+export { ConnectionListPresentation, ConnectionSetupPresentation };
+//# sourceMappingURL=connection.presentation.js.map

package/dist/connection/connection.presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.presentation.js","names":[],"sources":["../../src/connection/connection.presentation.ts"],"sourcesContent":["import { definePresentation, StabilityEnum } from '@contractspec/lib.contracts';\nimport { ConnectionModel } from './connection.schema';\n\nexport const ConnectionListPresentation = definePresentation({\n  meta: {\n    key: 'integration.connection.list',\n    version: '1.0.0',\n    title: 'Connection List',\n    description: 'List of integration connections',\n    domain: 'integration',\n    owners: ['@integration-team'],\n    tags: ['integration', 'connection', 'list'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Provide an overview of all established integration connections.',\n    context: 'The primary management view for integration hubs.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'ConnectionList',\n    props: ConnectionModel,\n  },\n  targets: ['react', 'markdown'],\n  policy: {\n    flags: ['integration.enabled'],\n  },\n});\n\nexport const ConnectionSetupPresentation = definePresentation({\n  meta: {\n    key: 'integration.connection.setup',\n    version: '1.0.0',\n    title: 'Connection Setup',\n    description: 'Setup wizard for creating integration connections',\n    domain: 'integration',\n    owners: ['@integration-team'],\n    tags: ['integration', 'connection', 'setup'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Guide users through the multi-step process of connecting to a new integration.',\n    context: 'The onboarding flow for new integrations.',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'ConnectionSetup',\n    props: ConnectionModel,\n  },\n  targets: ['react'],\n  policy: {\n    flags: ['integration.enabled'],\n  },\n});\n"],"mappings":";;;;AAGA,MAAa,6BAA6B,mBAAmB;CAC3D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,oBAAoB;EAC7B,MAAM;GAAC;GAAe;GAAc;GAAO;EAC3C,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EACN,OAAO,CAAC,sBAAsB,EAC/B;CACF,CAAC;AAEF,MAAa,8BAA8B,mBAAmB;CAC5D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,oBAAoB;EAC7B,MAAM;GAAC;GAAe;GAAc;GAAQ;EAC5C,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,QAAQ;CAClB,QAAQ,EACN,OAAO,CAAC,sBAAsB,EAC/B;CACF,CAAC"}

package/dist/connection/connection.schema.d.ts

@@ -0,0 +1,68 @@
+import * as _contractspec_lib_schema81 from "@contractspec/lib.schema";
+
+//#region src/connection/connection.schema.d.ts
+/**
+ * A connection to an external system.
+ */
+declare const ConnectionModel: _contractspec_lib_schema81.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema81.FieldType<string, string>;
+    isOptional: false;
+  };
+  integrationId: {
+    type: _contractspec_lib_schema81.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _contractspec_lib_schema81.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema81.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  authType: {
+    type: _contractspec_lib_schema81.FieldType<string, string>;
+    isOptional: false;
+  };
+  externalAccountName: {
+    type: _contractspec_lib_schema81.FieldType<string, string>;
+    isOptional: true;
+  };
+  connectedAt: {
+    type: _contractspec_lib_schema81.FieldType<Date, string>;
+    isOptional: true;
+  };
+  lastHealthCheck: {
+    type: _contractspec_lib_schema81.FieldType<Date, string>;
+    isOptional: true;
+  };
+  healthStatus: {
+    type: _contractspec_lib_schema81.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for creating a connection.
+ */
+declare const CreateConnectionInputModel: _contractspec_lib_schema81.SchemaModel<{
+  integrationId: {
+    type: _contractspec_lib_schema81.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _contractspec_lib_schema81.FieldType<string, string>;
+    isOptional: false;
+  };
+  authType: {
+    type: _contractspec_lib_schema81.FieldType<string, string>;
+    isOptional: false;
+  };
+  credentials: {
+    type: _contractspec_lib_schema81.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+}>;
+//#endregion
+export { ConnectionModel, CreateConnectionInputModel };
+//# sourceMappingURL=connection.schema.d.ts.map

package/dist/connection/connection.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.schema.d.ts","names":[],"sources":["../../src/connection/connection.schema.ts"],"sourcesContent":[],"mappings":";;;;;;AAMa,cAAA,eAmBX,6BAnB0B,WAmB1B,CAAA;EAAA,EAAA,EAAA;UAAA,0BAAA,CAAA;;;;;;;;;;;EAnB0B,MAAA,EAAA;IAwBf,IAAA,qCAWX,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;EAXqC,CAAA;;;;;;;;;;;;;;;;;;;;;cAA1B,uDAA0B;;UAWrC,0BAAA,CAAA"}

package/dist/connection/connection.schema.js

@@ -0,0 +1,76 @@
+import { ConnectionStatusEnum } from "./connection.enum.js";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/connection/connection.schema.ts
+/**
+* A connection to an external system.
+*/
+const ConnectionModel = defineSchemaModel({
+	name: "ConnectionModel",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		integrationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ConnectionStatusEnum,
+			isOptional: false
+		},
+		authType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		externalAccountName: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		connectedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		lastHealthCheck: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		healthStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Input for creating a connection.
+*/
+const CreateConnectionInputModel = defineSchemaModel({
+	name: "CreateConnectionInput",
+	fields: {
+		integrationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		authType: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		credentials: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		}
+	}
+});
+
+//#endregion
+export { ConnectionModel, CreateConnectionInputModel };
+//# sourceMappingURL=connection.schema.js.map

package/dist/connection/connection.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.schema.js","names":[],"sources":["../../src/connection/connection.schema.ts"],"sourcesContent":["import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\nimport { ConnectionStatusEnum } from './connection.enum';\n\n/**\n * A connection to an external system.\n */\nexport const ConnectionModel = defineSchemaModel({\n  name: 'ConnectionModel',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    integrationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ConnectionStatusEnum, isOptional: false },\n    authType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    externalAccountName: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\n/**\n * Input for creating a connection.\n */\nexport const CreateConnectionInputModel = defineSchemaModel({\n  name: 'CreateConnectionInput',\n  fields: {\n    integrationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n"],"mappings":";;;;;;;AAMA,MAAa,kBAAkB,kBAAkB;CAC/C,MAAM;CACN,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,QAAQ;GAAE,MAAM;GAAsB,YAAY;GAAO;EACzD,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACvE,qBAAqB;GACnB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,aAAa;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAM;EAClE,iBAAiB;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAM;EACtE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EAC3E;CACF,CAAC;;;;AAKF,MAAa,6BAA6B,kBAAkB;CAC1D,MAAM;CACN,QAAQ;EACN,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,MAAM;GAAE,MAAM,eAAe,gBAAgB;GAAE,YAAY;GAAO;EAClE,UAAU;GAAE,MAAM,eAAe,gBAAgB;GAAE,YAAY;GAAO;EACtE,aAAa;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAM;EAC/D;CACF,CAAC"}

package/dist/connection/index.d.ts

@@ -0,0 +1,4 @@
+import { ConnectionStatusEnum } from "./connection.enum.js";
+import { CreateConnectionContract } from "./connection.operation.js";
+import { ConnectionModel, CreateConnectionInputModel } from "./connection.schema.js";
+export { ConnectionModel, ConnectionStatusEnum, CreateConnectionContract, CreateConnectionInputModel };

package/dist/connection/index.js

@@ -0,0 +1,5 @@
+import { ConnectionStatusEnum } from "./connection.enum.js";
+import { ConnectionModel, CreateConnectionInputModel } from "./connection.schema.js";
+import { CreateConnectionContract } from "./connection.operation.js";
+
+export { ConnectionModel, ConnectionStatusEnum, CreateConnectionContract, CreateConnectionInputModel };

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./integration-hub.docblock.js";

package/dist/docs/integration-hub.docblock.d.ts

@@ -0,0 +1 @@
+export { };