@contractspec/lib.contracts 0.0.0-canary-20260113162409

package/dist/install.js

@@ -0,0 +1,40 @@
+import "./operations/registry.js";
+import "zod";
+
+//#region src/install.ts
+/** Typed emit for a given spec (validates at runtime through ctx.__emitGuard__). */
+function makeEmit(_spec, ctx) {
+	return {
+		ref: async (ev, payload) => {
+			await ctx.__emitGuard__?.(ev.meta.key, ev.meta.version, payload);
+		},
+		key: async (key, version, payload) => {
+			await ctx.__emitGuard__?.(key, version, payload);
+		},
+		object: async (evt) => {
+			await ctx.__emitGuard__?.(evt.key, evt.version, evt.payload);
+		}
+	};
+}
+/**
+* Register the Spec and bind the handler in one call, with full type inference.
+* Returns the registry for chaining.
+*/
+function installOp(reg, spec, handler) {
+	return reg.register(spec).bind(spec, handler);
+}
+/**
+* Curried variant if you prefer building a module installer.
+*   const install = op(BeginSignupSpec, handler);
+*   install(reg);
+*/
+function op(spec, handler) {
+	return {
+		spec,
+		handler,
+		install: (reg) => installOp(reg, spec, handler)
+	};
+}
+
+//#endregion
+export { installOp, makeEmit, op };

package/dist/integrations/binding.d.ts

@@ -0,0 +1,17 @@
+//#region src/integrations/binding.d.ts
+interface AppIntegrationBinding {
+  /** Which slot this binding satisfies. */
+  slotId: string;
+  /** Which IntegrationConnection to use. */
+  connectionId: string;
+  /** Optional: scope to specific workflows/features. */
+  scope?: {
+    workflows?: string[];
+    features?: string[];
+    operations?: string[];
+  };
+  /** Priority when multiple connections provide same capability. */
+  priority?: number;
+}
+//#endregion
+export { AppIntegrationBinding };

package/dist/integrations/connection.d.ts

@@ -0,0 +1,51 @@
+import { IntegrationOwnershipMode } from "./spec.js";
+
+//#region src/integrations/connection.d.ts
+type ConnectionStatus = 'connected' | 'disconnected' | 'error' | 'unknown';
+interface IntegrationConnectionHealth {
+  status: ConnectionStatus;
+  checkedAt?: Date;
+  latencyMs?: number;
+  errorCode?: string;
+  errorMessage?: string;
+}
+interface IntegrationUsageMetrics {
+  requestCount?: number;
+  successCount?: number;
+  errorCount?: number;
+  lastUsed?: Date;
+  lastSuccessAt?: Date;
+  lastErrorAt?: Date;
+  lastErrorCode?: string;
+}
+interface IntegrationConnectionMeta {
+  id: string;
+  tenantId: string;
+  /** Reference to IntegrationSpec. */
+  integrationKey: string;
+  integrationVersion: string;
+  /** Human-readable label (e.g., "Production Stripe"). */
+  label: string;
+  environment?: string;
+  createdAt: string | Date;
+  updatedAt: string | Date;
+}
+interface IntegrationConnection {
+  meta: IntegrationConnectionMeta;
+  /** Ownership mode indicating who controls credentials. */
+  ownershipMode: IntegrationOwnershipMode;
+  /** External provider account/project identifier (BYOK scenarios). */
+  externalAccountId?: string;
+  /** Encrypted configuration matching IntegrationSpec.configSchema. */
+  config: Record<string, unknown>;
+  /** Reference to external secret store entry containing credentials. */
+  secretProvider: string;
+  secretRef: string;
+  status: ConnectionStatus;
+  /** Last health check result. */
+  health?: IntegrationConnectionHealth;
+  /** Usage tracking. */
+  usage?: IntegrationUsageMetrics;
+}
+//#endregion
+export { ConnectionStatus, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationUsageMetrics };

package/dist/integrations/docs/integrations.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/integrations/docs/integrations.docblock.d.ts
+declare const tech_contracts_integrations_DocBlocks: DocBlock[];
+//#endregion
+export { tech_contracts_integrations_DocBlocks };

package/dist/integrations/docs/integrations.docblock.js

@@ -0,0 +1,94 @@
+import { registerDocBlocks } from "../../docs/registry.js";
+
+//#region src/integrations/docs/integrations.docblock.ts
+const tech_contracts_integrations_DocBlocks = [{
+	id: "docs.tech.contracts.integrations",
+	title: "ContractSpec Integrations",
+	summary: "Provider-agnostic integration contracts: specs, connections, secrets, health checks, and runtime guards.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/contracts/integrations",
+	tags: [
+		"tech",
+		"contracts",
+		"integrations"
+	],
+	body: `# ContractSpec Integrations
+
+This document describes the integration architecture that powers ContractSpec-based apps. It focuses on provider-agnostic contracts, secret management, health checks, and runtime guards.
+
+## Core Concepts
+
+- **IntegrationSpec** – declarative description of a provider that lists supported ownership modes, capability mappings, configuration schema, secret schema, health check policy, and documentation metadata.
+- **IntegrationConnection** – tenant/environment binding to a provider (\`meta\` + ownership mode + config + \`secretRef\`). Secrets are never embedded in specs or configs.
+- **AppIntegrationSlot** – blueprint-level requirement that declares which integration categories/capabilities must be satisfied at runtime (e.g. \`primaryLLM\`, \`primaryVectorDb\`).
+- **AppIntegrationBinding** – tenant-level slot → connection mapping.
+- **ResolvedIntegration** – runtime view containing slot metadata, connection details, and the resolved IntegrationSpec.
+
+## Registered Providers
+
+The contracts library ships ten priority providers in \`packages/libs/contracts/src/integrations/providers\`:
+
+| Category      | Provider         | Key                         | Notes                                             |
+| ------------- | ---------------- | --------------------------- | ------------------------------------------------- |
+| payments      | Stripe           | \`payments.stripe\`          | Card + invoice flows, managed or BYOK credentials |
+| email (out)   | Postmark         | \`email.postmark\`           | Transactional email delivery                      |
+| email (in)    | Gmail API        | \`email.gmail\`              | Thread ingestion (OAuth BYOK or service account)  |
+| calendar      | Google Calendar  | \`calendar.google\`          | Event scheduling via service account              |
+| vector-db     | Qdrant           | \`vectordb.qdrant\`          | Embedding storage & search                        |
+| storage       | Google Cloud     | \`storage.gcs\`              | Object storage                                    |
+| ai-llm        | Mistral          | \`ai-llm.mistral\`           | Primary chat + embedding provider                 |
+| ai-voice      | ElevenLabs       | \`ai-voice.elevenlabs\`      | Text-to-speech synthesis                          |
+| sms           | Twilio SMS       | \`sms.twilio\`               | Urgent and fallback reminders                     |
+| open-banking  | Powens           | \`openbanking.powens\`       | Read-only account, transaction, and balance sync  |
+
+Each provider ships with:
+
+- Strongly typed adapter interfaces (\`payments.ts\`, \`llm.ts\`, etc.)
+- A concrete SDK-backed implementation under \`providers/impls\`
+- Unit tests validating adapter behaviour and health checks
+
+### Canonical registry builder
+
+To list all shipped specs at runtime, use:
+
+- \`createDefaultIntegrationSpecRegistry()\` from \`@contractspec/lib.contracts/integrations/providers/registry\`
+
+## Secret Management
+
+All integrations rely on the \`SecretProvider\` abstraction defined in \`integrations/secrets\`. Providers ship with the contracts library and are orchestrated by the \`SecretProviderManager\` composite:
+
+- **EnvSecretProvider** (\`env-secret-provider.ts\`) – high-priority, read-only overrides backed by environment variables.
+  - Supports the \`env://VARIABLE_NAME\` scheme
+  - Supports overrides for other schemes via \`?env=ALIAS\` or derived uppercase keys
+- **GcpSecretManagerProvider** (\`gcp-secret-manager.ts\`) – versioned secrets stored in Google Cloud Secret Manager.
+  - Example: \`gcp://projects/demo/secrets/stripe-key/versions/latest\`
+- **AwsSecretsManagerProvider** (\`aws-secret-manager.ts\`) – AWS Secrets Manager backend.
+  - Example: \`aws://secretsmanager/eu-west-1/my-secret?version=AWSCURRENT\`
+  - Region may be in the reference or provided via \`AWS_REGION\` / \`AWS_DEFAULT_REGION\`
+- **ScalewaySecretManagerProvider** (\`scaleway-secret-manager.ts\`) – Scaleway Secret Manager backend.
+  - Example (id): \`scw://secret-manager/fr-par/1234...-uuid?version=latest\`
+  - Example (name, create+write): \`scw://secret-manager/fr-par/my-secret-name\`
+  - Requires \`SCW_SECRET_KEY\` (token) and \`SCW_DEFAULT_PROJECT_ID\` when creating secrets by name
+
+The manager attempts providers in priority order (environment first, then cloud providers). Key points:
+
+- \`secretRef\` is a URI-like reference; raw secrets are never returned.
+- \`IntegrationCallGuard\` fetches and parses secrets before executing a provider adapter.
+- Local development can rely on \`.env\` files, while staging/production reference cloud secret stores.
+
+## Health Checks & Telemetry
+
+- Each IntegrationSpec optionally declares \`healthCheck.method\` and timeouts.
+- \`IntegrationCallGuard\` enforces connection status, wraps retries with exponential back-off, and emits telemetry events tagged with tenant/app/slot metadata.
+- Validation rules (\`app-config/validation.ts\`) surface issues at publish time (slot mismatch, unsupported ownership modes, missing capabilities, etc.).
+
+## Studio persistence (ContractSpec Studio)
+
+ContractSpec Studio persists tenant \`IntegrationConnection\` records in Postgres (Prisma model \`IntegrationConnection\` in \`@contractspec/lib.database-studio\`) and exposes a platform-admin management surface (see the Studio platform admin panel).
+`
+}];
+registerDocBlocks(tech_contracts_integrations_DocBlocks);
+
+//#endregion
+export { tech_contracts_integrations_DocBlocks };

package/dist/integrations/health.d.ts

@@ -0,0 +1,21 @@
+import { IntegrationConnectionHealth } from "./connection.js";
+import { IntegrationContext, IntegrationTelemetryEmitter } from "./runtime.js";
+
+//#region src/integrations/health.d.ts
+interface IntegrationHealthCheckResult extends IntegrationConnectionHealth {
+  metadata?: Record<string, string>;
+}
+type IntegrationHealthCheckExecutor = (context: IntegrationContext) => Promise<void>;
+interface IntegrationHealthServiceOptions {
+  telemetry?: IntegrationTelemetryEmitter;
+  now?: () => Date;
+}
+declare class IntegrationHealthService {
+  private readonly telemetry?;
+  private readonly nowFn;
+  constructor(options?: IntegrationHealthServiceOptions);
+  check(context: IntegrationContext, executor: IntegrationHealthCheckExecutor): Promise<IntegrationHealthCheckResult>;
+  private emitTelemetry;
+}
+//#endregion
+export { IntegrationHealthCheckExecutor, IntegrationHealthCheckResult, IntegrationHealthService, IntegrationHealthServiceOptions };

package/dist/integrations/health.js

@@ -0,0 +1,69 @@
+//#region src/integrations/health.ts
+var IntegrationHealthService = class {
+	telemetry;
+	nowFn;
+	constructor(options = {}) {
+		this.telemetry = options.telemetry;
+		this.nowFn = options.now ?? (() => /* @__PURE__ */ new Date());
+	}
+	async check(context, executor) {
+		const start = this.nowFn();
+		try {
+			await executor(context);
+			const end = this.nowFn();
+			const result = {
+				status: "connected",
+				checkedAt: end,
+				latencyMs: end.getTime() - start.getTime()
+			};
+			this.emitTelemetry(context, result, "success");
+			return result;
+		} catch (error) {
+			const end = this.nowFn();
+			const message = error instanceof Error ? error.message : "Unknown error";
+			const code = extractErrorCode(error);
+			const result = {
+				status: "error",
+				checkedAt: end,
+				latencyMs: end.getTime() - start.getTime(),
+				errorMessage: message,
+				errorCode: code
+			};
+			this.emitTelemetry(context, result, "error", code, message);
+			return result;
+		}
+	}
+	emitTelemetry(context, result, status, errorCode, errorMessage) {
+		if (!this.telemetry) return;
+		this.telemetry.record({
+			tenantId: context.tenantId,
+			appId: context.appId,
+			environment: context.environment,
+			slotId: context.slotId,
+			integrationKey: context.spec.meta.key,
+			integrationVersion: context.spec.meta.version,
+			connectionId: context.connection.meta.id,
+			status,
+			durationMs: result.latencyMs,
+			errorCode,
+			errorMessage,
+			occurredAt: result.checkedAt ?? this.nowFn(),
+			metadata: {
+				...context.trace ? {
+					blueprint: `${context.trace.blueprintName}.v${context.trace.blueprintVersion}`,
+					configVersion: context.trace.configVersion
+				} : {},
+				status: result.status
+			}
+		});
+	}
+};
+function extractErrorCode(error) {
+	if (!error || typeof error !== "object") return void 0;
+	const candidate = error;
+	if (candidate.code == null) return void 0;
+	return String(candidate.code);
+}
+
+//#endregion
+export { IntegrationHealthService };

package/dist/integrations/index.d.ts

@@ -0,0 +1,34 @@
+import { IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, defineIntegration, makeIntegrationSpecKey } from "./spec.js";
+import { ConnectionStatus, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationUsageMetrics } from "./connection.js";
+import { AppIntegrationBinding } from "./binding.js";
+import { CapturePaymentInput, CreateCustomerInput, CreatePaymentIntentInput, ListInvoicesQuery, ListTransactionsQuery, Money, PaymentCustomer, PaymentIntent, PaymentIntentStatus, PaymentInvoice, PaymentRefund, PaymentTransaction, PaymentsProvider, RefundPaymentInput } from "./providers/payments.js";
+import { LLMChatOptions, LLMContentPart, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, TokenCountResult } from "./providers/llm.js";
+import { EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector } from "./providers/embedding.js";
+import { VectorDeleteRequest, VectorDocument, VectorSearchQuery, VectorSearchResult, VectorStoreProvider, VectorUpsertRequest } from "./providers/vector-store.js";
+import { EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery } from "./providers/email.js";
+import { CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder } from "./providers/calendar.js";
+import { SendSmsInput, SmsDeliveryStatus, SmsMessage, SmsProvider } from "./providers/sms.js";
+import { Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult } from "./providers/voice.js";
+import { DeleteObjectInput, GetObjectResult, ListObjectsQuery, ListObjectsResult, ObjectStorageProvider, PutObjectInput, SignedUrlOptions, StorageObjectBody, StorageObjectMetadata } from "./providers/storage.js";
+import { registerStripeIntegration, stripeIntegrationSpec } from "./providers/stripe.js";
+import { postmarkIntegrationSpec, registerPostmarkIntegration } from "./providers/postmark.js";
+import { qdrantIntegrationSpec, registerQdrantIntegration } from "./providers/qdrant.js";
+import { mistralIntegrationSpec, registerMistralIntegration } from "./providers/mistral.js";
+import { elevenLabsIntegrationSpec, registerElevenLabsIntegration } from "./providers/elevenlabs.js";
+import { gmailIntegrationSpec, registerGmailIntegration } from "./providers/gmail.js";
+import { googleCalendarIntegrationSpec, registerGoogleCalendarIntegration } from "./providers/google-calendar.js";
+import { registerTwilioSmsIntegration, twilioSmsIntegrationSpec } from "./providers/twilio-sms.js";
+import { gcsStorageIntegrationSpec, registerGcsStorageIntegration } from "./providers/gcs-storage.js";
+import { powensIntegrationSpec, registerPowensIntegration } from "./providers/powens.js";
+import { OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingGetAccountDetailsParams, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, OpenBankingTransaction } from "./providers/openbanking.js";
+import { createDefaultIntegrationSpecRegistry } from "./providers/registry.js";
+import "./providers/index.js";
+import { AccountBalanceRecord, BankAccountRecord, BankTransactionRecord } from "./openbanking/models.js";
+import { OpenBankingGetAccount, OpenBankingListAccounts, OpenBankingSyncAccounts } from "./openbanking/contracts/accounts.js";
+import { OpenBankingListTransactions, OpenBankingSyncTransactions } from "./openbanking/contracts/transactions.js";
+import { OpenBankingGetBalances, OpenBankingRefreshBalances } from "./openbanking/contracts/balances.js";
+import { OpenBankingFeature } from "./openbanking/openbanking.feature.js";
+import { registerOpenBankingContracts } from "./openbanking/contracts/index.js";
+import { OpenBankingGuardResult, assertPrimaryOpenBankingReady, ensurePrimaryOpenBankingIntegration } from "./openbanking/guards.js";
+import { OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, OpenBankingTelemetryEvent, redactOpenBankingTelemetryPayload } from "./openbanking/telemetry.js";
+export { AccountBalanceRecord, AppIntegrationBinding, BankAccountRecord, BankTransactionRecord, CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder, CapturePaymentInput, ConnectionStatus, CreateCustomerInput, CreatePaymentIntentInput, DeleteObjectInput, EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery, EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector, GetObjectResult, IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationUsageMetrics, LLMChatOptions, LLMContentPart, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, ListInvoicesQuery, ListObjectsQuery, ListObjectsResult, ListTransactionsQuery, Money, OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, ObjectStorageProvider, OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingFeature, OpenBankingGetAccount, OpenBankingGetAccountDetailsParams, OpenBankingGetBalances, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingGuardResult, OpenBankingListAccounts, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactions, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, OpenBankingRefreshBalances, OpenBankingSyncAccounts, OpenBankingSyncTransactions, OpenBankingTelemetryEvent, OpenBankingTransaction, PaymentCustomer, PaymentIntent, PaymentIntentStatus, PaymentInvoice, PaymentRefund, PaymentTransaction, PaymentsProvider, PutObjectInput, RefundPaymentInput, SendSmsInput, SignedUrlOptions, SmsDeliveryStatus, SmsMessage, SmsProvider, StorageObjectBody, StorageObjectMetadata, TokenCountResult, VectorDeleteRequest, VectorDocument, VectorSearchQuery, VectorSearchResult, VectorStoreProvider, VectorUpsertRequest, Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult, assertPrimaryOpenBankingReady, createDefaultIntegrationSpecRegistry, defineIntegration, elevenLabsIntegrationSpec, ensurePrimaryOpenBankingIntegration, gcsStorageIntegrationSpec, gmailIntegrationSpec, googleCalendarIntegrationSpec, makeIntegrationSpecKey, mistralIntegrationSpec, postmarkIntegrationSpec, powensIntegrationSpec, qdrantIntegrationSpec, redactOpenBankingTelemetryPayload, registerElevenLabsIntegration, registerGcsStorageIntegration, registerGmailIntegration, registerGoogleCalendarIntegration, registerMistralIntegration, registerOpenBankingContracts, registerPostmarkIntegration, registerPowensIntegration, registerQdrantIntegration, registerStripeIntegration, registerTwilioSmsIntegration, stripeIntegrationSpec, twilioSmsIntegrationSpec };

package/dist/integrations/index.js

@@ -0,0 +1,23 @@
+import { IntegrationSpecRegistry, defineIntegration, makeIntegrationSpecKey } from "./spec.js";
+import { registerStripeIntegration, stripeIntegrationSpec } from "./providers/stripe.js";
+import { postmarkIntegrationSpec, registerPostmarkIntegration } from "./providers/postmark.js";
+import { qdrantIntegrationSpec, registerQdrantIntegration } from "./providers/qdrant.js";
+import { mistralIntegrationSpec, registerMistralIntegration } from "./providers/mistral.js";
+import { elevenLabsIntegrationSpec, registerElevenLabsIntegration } from "./providers/elevenlabs.js";
+import { gmailIntegrationSpec, registerGmailIntegration } from "./providers/gmail.js";
+import { googleCalendarIntegrationSpec, registerGoogleCalendarIntegration } from "./providers/google-calendar.js";
+import { registerTwilioSmsIntegration, twilioSmsIntegrationSpec } from "./providers/twilio-sms.js";
+import { gcsStorageIntegrationSpec, registerGcsStorageIntegration } from "./providers/gcs-storage.js";
+import { powensIntegrationSpec, registerPowensIntegration } from "./providers/powens.js";
+import { createDefaultIntegrationSpecRegistry } from "./providers/registry.js";
+import "./providers/index.js";
+import { AccountBalanceRecord, BankAccountRecord, BankTransactionRecord } from "./openbanking/models.js";
+import { OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, redactOpenBankingTelemetryPayload } from "./openbanking/telemetry.js";
+import { OpenBankingGetAccount, OpenBankingListAccounts, OpenBankingSyncAccounts } from "./openbanking/contracts/accounts.js";
+import { OpenBankingListTransactions, OpenBankingSyncTransactions } from "./openbanking/contracts/transactions.js";
+import { OpenBankingGetBalances, OpenBankingRefreshBalances } from "./openbanking/contracts/balances.js";
+import { OpenBankingFeature } from "./openbanking/openbanking.feature.js";
+import { registerOpenBankingContracts } from "./openbanking/contracts/index.js";
+import { assertPrimaryOpenBankingReady, ensurePrimaryOpenBankingIntegration } from "./openbanking/guards.js";
+
+export { AccountBalanceRecord, BankAccountRecord, BankTransactionRecord, IntegrationSpecRegistry, OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, OpenBankingFeature, OpenBankingGetAccount, OpenBankingGetBalances, OpenBankingListAccounts, OpenBankingListTransactions, OpenBankingRefreshBalances, OpenBankingSyncAccounts, OpenBankingSyncTransactions, assertPrimaryOpenBankingReady, createDefaultIntegrationSpecRegistry, defineIntegration, elevenLabsIntegrationSpec, ensurePrimaryOpenBankingIntegration, gcsStorageIntegrationSpec, gmailIntegrationSpec, googleCalendarIntegrationSpec, makeIntegrationSpecKey, mistralIntegrationSpec, postmarkIntegrationSpec, powensIntegrationSpec, qdrantIntegrationSpec, redactOpenBankingTelemetryPayload, registerElevenLabsIntegration, registerGcsStorageIntegration, registerGmailIntegration, registerGoogleCalendarIntegration, registerMistralIntegration, registerOpenBankingContracts, registerPostmarkIntegration, registerPowensIntegration, registerQdrantIntegration, registerStripeIntegration, registerTwilioSmsIntegration, stripeIntegrationSpec, twilioSmsIntegrationSpec };

package/dist/integrations/integrations.capability.d.ts

@@ -0,0 +1,7 @@
+import { CapabilitySpec } from "../capabilities/capabilities.js";
+import "../index.js";
+
+//#region src/integrations/integrations.capability.d.ts
+declare const IntegrationsCapability: CapabilitySpec;
+//#endregion
+export { IntegrationsCapability };

package/dist/integrations/integrations.capability.js

@@ -0,0 +1,17 @@
+import { defineCapability } from "../capabilities/capabilities.js";
+import { StabilityEnum } from "../ownership.js";
+import "../capabilities/index.js";
+
+//#region src/integrations/integrations.capability.ts
+const IntegrationsCapability = defineCapability({ meta: {
+	key: "integrations",
+	version: "1.0.0",
+	kind: "integration",
+	stability: StabilityEnum.Experimental,
+	description: "Core integrations capability for third-party connections",
+	owners: ["@platform.core"],
+	tags: ["integrations", "platform"]
+} });
+
+//#endregion
+export { IntegrationsCapability };

package/dist/integrations/integrations.feature.d.ts

@@ -0,0 +1,11 @@
+import { FeatureModuleSpec } from "../features/types.js";
+import "../index.js";
+
+//#region src/integrations/integrations.feature.d.ts
+/**
+ * Platform Integrations feature module that bundles
+ * integration connection management capabilities.
+ */
+declare const IntegrationsFeature: FeatureModuleSpec;
+//#endregion
+export { IntegrationsFeature };

package/dist/integrations/integrations.feature.js

@@ -0,0 +1,67 @@
+import { defineFeature } from "../features/index.js";
+
+//#region src/integrations/integrations.feature.ts
+/**
+* Platform Integrations Feature Module Specification
+*
+* Defines the feature module for managing integration connections.
+*/
+/**
+* Platform Integrations feature module that bundles
+* integration connection management capabilities.
+*/
+const IntegrationsFeature = defineFeature({
+	meta: {
+		key: "platform.integrations",
+		version: "1.0.0",
+		title: "Platform Integrations",
+		description: "Manage integration connections to external providers (e.g., Stripe, Qdrant)",
+		domain: "platform",
+		owners: ["@platform.integrations"],
+		tags: [
+			"integrations",
+			"connections",
+			"platform"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			key: "integrations.connection.create",
+			version: "1.0.0"
+		},
+		{
+			key: "integrations.connection.update",
+			version: "1.0.0"
+		},
+		{
+			key: "integrations.connection.delete",
+			version: "1.0.0"
+		},
+		{
+			key: "integrations.connection.list",
+			version: "1.0.0"
+		},
+		{
+			key: "integrations.connection.test",
+			version: "1.0.0"
+		}
+	],
+	events: [],
+	presentations: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: {
+		provides: [{
+			key: "integrations",
+			version: "1.0.0"
+		}],
+		requires: [{
+			key: "identity",
+			version: "1.0.0"
+		}]
+	}
+});
+
+//#endregion
+export { IntegrationsFeature };