@contractspec/lib.contracts 1.44.0

package/dist/integrations/providers/impls/stripe-payments.js

@@ -0,0 +1,202 @@
+import Stripe from "stripe";
+
+//#region src/integrations/providers/impls/stripe-payments.ts
+const API_VERSION = "2025-12-15.clover";
+var StripePaymentsProvider = class {
+	stripe;
+	constructor(options) {
+		this.stripe = options.stripe ?? new Stripe(options.apiKey, { apiVersion: API_VERSION });
+	}
+	async createCustomer(input) {
+		const customer = await this.stripe.customers.create({
+			email: input.email,
+			name: input.name,
+			description: input.description,
+			metadata: input.metadata
+		});
+		return this.toCustomer(customer);
+	}
+	async getCustomer(customerId) {
+		const customer = await this.stripe.customers.retrieve(customerId);
+		if (customer.deleted) return null;
+		return this.toCustomer(customer);
+	}
+	async createPaymentIntent(input) {
+		const intent = await this.stripe.paymentIntents.create({
+			amount: input.amount.amount,
+			currency: input.amount.currency,
+			customer: input.customerId,
+			description: input.description,
+			capture_method: input.captureMethod ?? "automatic",
+			confirmation_method: input.confirmationMethod ?? "automatic",
+			automatic_payment_methods: { enabled: true },
+			metadata: input.metadata,
+			return_url: input.returnUrl,
+			statement_descriptor: input.statementDescriptor
+		});
+		return this.toPaymentIntent(intent);
+	}
+	async capturePayment(paymentIntentId, input) {
+		const intent = await this.stripe.paymentIntents.capture(paymentIntentId, input?.amount ? { amount_to_capture: input.amount.amount } : void 0);
+		return this.toPaymentIntent(intent);
+	}
+	async cancelPaymentIntent(paymentIntentId) {
+		const intent = await this.stripe.paymentIntents.cancel(paymentIntentId);
+		return this.toPaymentIntent(intent);
+	}
+	async refundPayment(input) {
+		const refund = await this.stripe.refunds.create({
+			payment_intent: input.paymentIntentId,
+			amount: input.amount?.amount,
+			reason: mapRefundReason(input.reason),
+			metadata: input.metadata
+		});
+		const paymentIntentId = typeof refund.payment_intent === "string" ? refund.payment_intent : refund.payment_intent?.id ?? "";
+		return {
+			id: refund.id,
+			paymentIntentId,
+			amount: {
+				amount: refund.amount ?? 0,
+				currency: refund.currency?.toUpperCase() ?? "USD"
+			},
+			status: mapRefundStatus(refund.status),
+			reason: refund.reason ?? void 0,
+			metadata: this.toMetadata(refund.metadata),
+			createdAt: refund.created ? /* @__PURE__ */ new Date(refund.created * 1e3) : void 0
+		};
+	}
+	async listInvoices(query) {
+		const requestedStatus = query?.status?.[0];
+		const stripeStatus = requestedStatus && requestedStatus !== "deleted" ? requestedStatus : void 0;
+		return (await this.stripe.invoices.list({
+			customer: query?.customerId,
+			status: stripeStatus,
+			limit: query?.limit,
+			starting_after: query?.startingAfter
+		})).data.map((invoice) => this.toInvoice(invoice));
+	}
+	async listTransactions(query) {
+		return (await this.stripe.charges.list({
+			customer: query?.customerId,
+			payment_intent: query?.paymentIntentId,
+			limit: query?.limit,
+			starting_after: query?.startingAfter
+		})).data.map((charge) => ({
+			id: charge.id,
+			paymentIntentId: typeof charge.payment_intent === "string" ? charge.payment_intent : charge.payment_intent?.id,
+			amount: {
+				amount: charge.amount,
+				currency: charge.currency?.toUpperCase() ?? "USD"
+			},
+			type: "capture",
+			status: mapChargeStatus(charge.status),
+			description: charge.description ?? void 0,
+			createdAt: /* @__PURE__ */ new Date(charge.created * 1e3),
+			metadata: this.mergeMetadata(this.toMetadata(charge.metadata), { balanceTransaction: typeof charge.balance_transaction === "string" ? charge.balance_transaction : void 0 })
+		}));
+	}
+	toCustomer(customer) {
+		const metadata = this.toMetadata(customer.metadata);
+		const updatedAtValue = metadata?.updatedAt;
+		return {
+			id: customer.id,
+			email: customer.email ?? void 0,
+			name: customer.name ?? void 0,
+			metadata,
+			createdAt: customer.created ? /* @__PURE__ */ new Date(customer.created * 1e3) : void 0,
+			updatedAt: updatedAtValue ? new Date(updatedAtValue) : void 0
+		};
+	}
+	toPaymentIntent(intent) {
+		const metadata = this.toMetadata(intent.metadata);
+		return {
+			id: intent.id,
+			amount: this.toMoney(intent.amount_received ?? intent.amount ?? 0, intent.currency),
+			status: mapPaymentIntentStatus(intent.status),
+			customerId: typeof intent.customer === "string" ? intent.customer : intent.customer?.id,
+			description: intent.description ?? void 0,
+			clientSecret: intent.client_secret ?? void 0,
+			metadata,
+			createdAt: /* @__PURE__ */ new Date(intent.created * 1e3),
+			updatedAt: intent.canceled_at != null ? /* @__PURE__ */ new Date(intent.canceled_at * 1e3) : /* @__PURE__ */ new Date(intent.created * 1e3)
+		};
+	}
+	toInvoice(invoice) {
+		const metadata = this.toMetadata(invoice.metadata);
+		return {
+			id: invoice.id,
+			number: invoice.number ?? void 0,
+			status: invoice.status ?? "draft",
+			amountDue: this.toMoney(invoice.amount_due ?? 0, invoice.currency),
+			amountPaid: this.toMoney(invoice.amount_paid ?? 0, invoice.currency),
+			customerId: typeof invoice.customer === "string" ? invoice.customer : invoice.customer?.id,
+			dueDate: invoice.due_date ? /* @__PURE__ */ new Date(invoice.due_date * 1e3) : void 0,
+			hostedInvoiceUrl: invoice.hosted_invoice_url ?? void 0,
+			metadata,
+			createdAt: invoice.created ? /* @__PURE__ */ new Date(invoice.created * 1e3) : void 0,
+			updatedAt: invoice.status_transitions?.finalized_at ? /* @__PURE__ */ new Date(invoice.status_transitions.finalized_at * 1e3) : void 0
+		};
+	}
+	toMoney(amount, currency) {
+		return {
+			amount,
+			currency: currency?.toUpperCase() ?? "USD"
+		};
+	}
+	toMetadata(metadata) {
+		if (!metadata) return void 0;
+		const entries = Object.entries(metadata).filter((entry) => typeof entry[1] === "string");
+		if (entries.length === 0) return void 0;
+		return Object.fromEntries(entries);
+	}
+	mergeMetadata(base, extras) {
+		const filteredExtras = Object.entries(extras).filter((entry) => typeof entry[1] === "string");
+		if (!base && filteredExtras.length === 0) return;
+		return {
+			...base ?? {},
+			...Object.fromEntries(filteredExtras)
+		};
+	}
+};
+function mapRefundReason(reason) {
+	if (!reason) return void 0;
+	return [
+		"duplicate",
+		"fraudulent",
+		"requested_by_customer"
+	].includes(reason) ? reason : void 0;
+}
+function mapPaymentIntentStatus(status) {
+	switch (status) {
+		case "requires_payment_method": return "requires_payment_method";
+		case "requires_confirmation": return "requires_confirmation";
+		case "requires_action":
+		case "requires_capture": return "requires_action";
+		case "processing": return "processing";
+		case "succeeded": return "succeeded";
+		case "canceled": return "canceled";
+		default: return "requires_payment_method";
+	}
+}
+function mapRefundStatus(status) {
+	switch (status) {
+		case "pending":
+		case "succeeded":
+		case "failed":
+		case "canceled": return status;
+		default: return "pending";
+	}
+}
+function mapChargeStatus(status) {
+	switch (status) {
+		case "pending":
+		case "processing": return "pending";
+		case "succeeded": return "succeeded";
+		case "failed":
+		case "canceled": return "failed";
+		default: return "pending";
+	}
+}
+
+//#endregion
+export { StripePaymentsProvider };

package/dist/integrations/providers/impls/twilio-sms.d.ts

@@ -0,0 +1,20 @@
+import { SendSmsInput, SmsDeliveryStatus, SmsMessage, SmsProvider } from "../sms.js";
+import Twilio from "twilio";
+
+//#region src/integrations/providers/impls/twilio-sms.d.ts
+type TwilioClient = ReturnType<typeof Twilio>;
+interface TwilioSmsProviderOptions {
+  accountSid: string;
+  authToken: string;
+  fromNumber?: string;
+  client?: TwilioClient;
+}
+declare class TwilioSmsProvider implements SmsProvider {
+  private readonly client;
+  private readonly fromNumber?;
+  constructor(options: TwilioSmsProviderOptions);
+  sendSms(input: SendSmsInput): Promise<SmsMessage>;
+  getDeliveryStatus(messageId: string): Promise<SmsDeliveryStatus>;
+}
+//#endregion
+export { TwilioSmsProvider, TwilioSmsProviderOptions };

package/dist/integrations/providers/impls/twilio-sms.js

@@ -0,0 +1,58 @@
+import Twilio from "twilio";
+
+//#region src/integrations/providers/impls/twilio-sms.ts
+var TwilioSmsProvider = class {
+	client;
+	fromNumber;
+	constructor(options) {
+		this.client = options.client ?? Twilio(options.accountSid, options.authToken);
+		this.fromNumber = options.fromNumber;
+	}
+	async sendSms(input) {
+		const message = await this.client.messages.create({
+			to: input.to,
+			from: input.from ?? this.fromNumber,
+			body: input.body
+		});
+		return {
+			id: message.sid,
+			to: message.to ?? input.to,
+			from: message.from ?? input.from ?? this.fromNumber ?? "",
+			body: message.body ?? input.body,
+			status: mapStatus(message.status),
+			sentAt: message.dateCreated ? new Date(message.dateCreated) : void 0,
+			deliveredAt: message.status === "delivered" && message.dateUpdated ? new Date(message.dateUpdated) : void 0,
+			price: message.price ? Number(message.price) : void 0,
+			priceCurrency: message.priceUnit ?? void 0,
+			errorCode: message.errorCode ? String(message.errorCode) : void 0,
+			errorMessage: message.errorMessage ?? void 0
+		};
+	}
+	async getDeliveryStatus(messageId) {
+		const message = await this.client.messages(messageId).fetch();
+		return {
+			status: mapStatus(message.status),
+			errorCode: message.errorCode ? String(message.errorCode) : void 0,
+			errorMessage: message.errorMessage ?? void 0,
+			updatedAt: message.dateUpdated ? new Date(message.dateUpdated) : /* @__PURE__ */ new Date()
+		};
+	}
+};
+function mapStatus(status) {
+	switch (status) {
+		case "queued":
+		case "accepted":
+		case "scheduled": return "queued";
+		case "sending":
+		case "processing": return "sending";
+		case "sent": return "sent";
+		case "delivered": return "delivered";
+		case "undelivered": return "undelivered";
+		case "failed":
+		case "canceled": return "failed";
+		default: return "queued";
+	}
+}
+
+//#endregion
+export { TwilioSmsProvider };

package/dist/integrations/providers/index.d.ts

@@ -0,0 +1,22 @@
+import { CapturePaymentInput, CreateCustomerInput, CreatePaymentIntentInput, ListInvoicesQuery, ListTransactionsQuery, Money, PaymentCustomer, PaymentIntent, PaymentIntentStatus, PaymentInvoice, PaymentRefund, PaymentTransaction, PaymentsProvider, RefundPaymentInput } from "./payments.js";
+import { LLMChatOptions, LLMContentPart, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, TokenCountResult } from "./llm.js";
+import { EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector } from "./embedding.js";
+import { VectorDeleteRequest, VectorDocument, VectorSearchQuery, VectorSearchResult, VectorStoreProvider, VectorUpsertRequest } from "./vector-store.js";
+import { EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery } from "./email.js";
+import { CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder } from "./calendar.js";
+import { SendSmsInput, SmsDeliveryStatus, SmsMessage, SmsProvider } from "./sms.js";
+import { Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult } from "./voice.js";
+import { DeleteObjectInput, GetObjectResult, ListObjectsQuery, ListObjectsResult, ObjectStorageProvider, PutObjectInput, SignedUrlOptions, StorageObjectBody, StorageObjectMetadata } from "./storage.js";
+import { registerStripeIntegration, stripeIntegrationSpec } from "./stripe.js";
+import { postmarkIntegrationSpec, registerPostmarkIntegration } from "./postmark.js";
+import { qdrantIntegrationSpec, registerQdrantIntegration } from "./qdrant.js";
+import { mistralIntegrationSpec, registerMistralIntegration } from "./mistral.js";
+import { elevenLabsIntegrationSpec, registerElevenLabsIntegration } from "./elevenlabs.js";
+import { gmailIntegrationSpec, registerGmailIntegration } from "./gmail.js";
+import { googleCalendarIntegrationSpec, registerGoogleCalendarIntegration } from "./google-calendar.js";
+import { registerTwilioSmsIntegration, twilioSmsIntegrationSpec } from "./twilio-sms.js";
+import { gcsStorageIntegrationSpec, registerGcsStorageIntegration } from "./gcs-storage.js";
+import { powensIntegrationSpec, registerPowensIntegration } from "./powens.js";
+import { OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingGetAccountDetailsParams, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, OpenBankingTransaction } from "./openbanking.js";
+import { createDefaultIntegrationSpecRegistry } from "./registry.js";
+export { CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder, CapturePaymentInput, CreateCustomerInput, CreatePaymentIntentInput, DeleteObjectInput, EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery, EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector, GetObjectResult, LLMChatOptions, LLMContentPart, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, ListInvoicesQuery, ListObjectsQuery, ListObjectsResult, ListTransactionsQuery, Money, ObjectStorageProvider, OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingGetAccountDetailsParams, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, 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, createDefaultIntegrationSpecRegistry, elevenLabsIntegrationSpec, gcsStorageIntegrationSpec, gmailIntegrationSpec, googleCalendarIntegrationSpec, mistralIntegrationSpec, postmarkIntegrationSpec, powensIntegrationSpec, qdrantIntegrationSpec, registerElevenLabsIntegration, registerGcsStorageIntegration, registerGmailIntegration, registerGoogleCalendarIntegration, registerMistralIntegration, registerPostmarkIntegration, registerPowensIntegration, registerQdrantIntegration, registerStripeIntegration, registerTwilioSmsIntegration, stripeIntegrationSpec, twilioSmsIntegrationSpec };

package/dist/integrations/providers/index.js

@@ -0,0 +1,13 @@
+import { registerStripeIntegration, stripeIntegrationSpec } from "./stripe.js";
+import { postmarkIntegrationSpec, registerPostmarkIntegration } from "./postmark.js";
+import { qdrantIntegrationSpec, registerQdrantIntegration } from "./qdrant.js";
+import { mistralIntegrationSpec, registerMistralIntegration } from "./mistral.js";
+import { elevenLabsIntegrationSpec, registerElevenLabsIntegration } from "./elevenlabs.js";
+import { gmailIntegrationSpec, registerGmailIntegration } from "./gmail.js";
+import { googleCalendarIntegrationSpec, registerGoogleCalendarIntegration } from "./google-calendar.js";
+import { registerTwilioSmsIntegration, twilioSmsIntegrationSpec } from "./twilio-sms.js";
+import { gcsStorageIntegrationSpec, registerGcsStorageIntegration } from "./gcs-storage.js";
+import { powensIntegrationSpec, registerPowensIntegration } from "./powens.js";
+import { createDefaultIntegrationSpecRegistry } from "./registry.js";
+
+export { createDefaultIntegrationSpecRegistry, elevenLabsIntegrationSpec, gcsStorageIntegrationSpec, gmailIntegrationSpec, googleCalendarIntegrationSpec, mistralIntegrationSpec, postmarkIntegrationSpec, powensIntegrationSpec, qdrantIntegrationSpec, registerElevenLabsIntegration, registerGcsStorageIntegration, registerGmailIntegration, registerGoogleCalendarIntegration, registerMistralIntegration, registerPostmarkIntegration, registerPowensIntegration, registerQdrantIntegration, registerStripeIntegration, registerTwilioSmsIntegration, stripeIntegrationSpec, twilioSmsIntegrationSpec };

package/dist/integrations/providers/llm.d.ts

@@ -0,0 +1,82 @@
+//#region src/integrations/providers/llm.d.ts
+type LLMRole = 'system' | 'user' | 'assistant' | 'tool';
+interface LLMTextPart {
+  type: 'text';
+  text: string;
+}
+interface LLMToolCallPart {
+  type: 'tool-call';
+  id: string;
+  name: string;
+  arguments: string;
+}
+interface LLMToolResultPart {
+  type: 'tool-result';
+  toolCallId: string;
+  output: string;
+}
+type LLMContentPart = LLMTextPart | LLMToolCallPart | LLMToolResultPart;
+interface LLMMessage {
+  role: LLMRole;
+  content: LLMContentPart[];
+  name?: string;
+  toolCallId?: string;
+  metadata?: Record<string, string>;
+}
+interface LLMToolDefinition {
+  name: string;
+  description?: string;
+  inputSchema: unknown;
+}
+interface LLMTokenUsage {
+  promptTokens: number;
+  completionTokens: number;
+  totalTokens: number;
+}
+interface LLMChatOptions {
+  model?: string;
+  temperature?: number;
+  topP?: number;
+  maxOutputTokens?: number;
+  stopSequences?: string[];
+  responseFormat?: 'text' | 'json';
+  tools?: LLMToolDefinition[];
+  userId?: string;
+  metadata?: Record<string, string>;
+  timeoutMs?: number;
+  signal?: AbortSignal;
+}
+interface LLMResponse {
+  message: LLMMessage;
+  usage?: LLMTokenUsage;
+  finishReason?: 'stop' | 'length' | 'tool_call' | 'content_filter';
+  raw?: unknown;
+}
+type LLMStreamChunk = {
+  type: 'message_delta';
+  delta: LLMContentPart;
+  index: number;
+} | {
+  type: 'tool_call';
+  call: LLMToolCallPart;
+  index: number;
+} | {
+  type: 'usage';
+  usage: LLMTokenUsage;
+} | {
+  type: 'error';
+  error: Error;
+} | {
+  type: 'end';
+  response: LLMResponse;
+};
+interface TokenCountResult {
+  promptTokens: number;
+}
+interface LLMProvider {
+  chat(messages: LLMMessage[], options?: LLMChatOptions): Promise<LLMResponse>;
+  stream(messages: LLMMessage[], options?: LLMChatOptions): AsyncIterable<LLMStreamChunk>;
+  countTokens(messages: LLMMessage[]): Promise<TokenCountResult>;
+}
+//#endregion
+export { LLMChatOptions, LLMContentPart, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, TokenCountResult };

package/dist/integrations/providers/mistral.d.ts

@@ -0,0 +1,7 @@
+import { IntegrationSpec, IntegrationSpecRegistry } from "../spec.js";
+
+//#region src/integrations/providers/mistral.d.ts
+declare const mistralIntegrationSpec: IntegrationSpec;
+declare function registerMistralIntegration(registry: IntegrationSpecRegistry): IntegrationSpecRegistry;
+//#endregion
+export { mistralIntegrationSpec, registerMistralIntegration };

package/dist/integrations/providers/mistral.js

@@ -0,0 +1,71 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/integrations/providers/mistral.ts
+const mistralIntegrationSpec = {
+	meta: {
+		key: "ai-llm.mistral",
+		version: 1,
+		category: "ai-llm",
+		title: "Mistral Large Language Model",
+		description: "Mistral integration providing chat completions and embedding generation.",
+		domain: "ai",
+		owners: ["platform.ai"],
+		tags: [
+			"ai",
+			"llm",
+			"embeddings"
+		],
+		stability: StabilityEnum.Experimental
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: { provides: [{
+		key: "ai.chat",
+		version: 1
+	}, {
+		key: "ai.embeddings",
+		version: 1
+	}] },
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: {
+				model: {
+					type: "string",
+					description: "Default chat completion model (e.g., mistral-large-latest)."
+				},
+				embeddingModel: {
+					type: "string",
+					description: "Embedding model identifier."
+				}
+			}
+		},
+		example: {
+			model: "mistral-large-latest",
+			embeddingModel: "mistral-embed"
+		}
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: ["apiKey"],
+			properties: { apiKey: {
+				type: "string",
+				description: "Mistral API key with access to chat and embeddings endpoints."
+			} }
+		},
+		example: { apiKey: "mistral-***" }
+	},
+	healthCheck: {
+		method: "custom",
+		timeoutMs: 5e3
+	},
+	docsUrl: "https://docs.mistral.ai/platform/endpoints",
+	constraints: { rateLimit: { rpm: 600 } },
+	byokSetup: { setupInstructions: "Generate an API key within the Mistral console and ensure the selected models are enabled for the account." }
+};
+function registerMistralIntegration(registry) {
+	return registry.register(mistralIntegrationSpec);
+}
+
+//#endregion
+export { mistralIntegrationSpec, registerMistralIntegration };

package/dist/integrations/providers/openbanking.d.ts

@@ -0,0 +1,128 @@
+//#region src/integrations/providers/openbanking.d.ts
+type OpenBankingAccountOwnership = 'individual' | 'joint' | 'business' | 'unknown';
+interface OpenBankingAccountSummary {
+  id: string;
+  externalId: string;
+  tenantId: string;
+  connectionId: string;
+  userId?: string;
+  displayName: string;
+  institutionId: string;
+  institutionName: string;
+  institutionLogoUrl?: string;
+  accountType: string;
+  iban?: string;
+  bic?: string;
+  currency: string;
+  accountNumberMasked?: string;
+  ownership?: OpenBankingAccountOwnership;
+  status?: 'active' | 'inactive' | 'closed' | 'suspended';
+  lastSyncedAt?: string;
+  metadata?: Record<string, unknown>;
+}
+interface OpenBankingAccountDetails extends OpenBankingAccountSummary {
+  productCode?: string;
+  openedAt?: string;
+  closedAt?: string;
+  availableBalance?: number;
+  currentBalance?: number;
+  creditLimit?: number;
+  customFields?: Record<string, unknown>;
+}
+interface OpenBankingTransaction {
+  id: string;
+  externalId: string;
+  tenantId: string;
+  accountId: string;
+  connectionId: string;
+  amount: number;
+  currency: string;
+  direction: 'debit' | 'credit';
+  description?: string;
+  bookingDate?: string;
+  valueDate?: string;
+  postedAt?: string;
+  category?: string;
+  rawCategory?: string;
+  merchantName?: string;
+  merchantCategoryCode?: string;
+  counterpartyName?: string;
+  counterpartyAccount?: string;
+  reference?: string;
+  status?: 'pending' | 'booked' | 'cancelled';
+  metadata?: Record<string, unknown>;
+}
+type OpenBankingBalanceType = 'current' | 'available' | 'authorised' | 'uncleared' | 'credit' | (string & {});
+interface OpenBankingAccountBalance {
+  accountId: string;
+  connectionId: string;
+  tenantId: string;
+  type: OpenBankingBalanceType;
+  currency: string;
+  amount: number;
+  lastUpdatedAt: string;
+  metadata?: Record<string, unknown>;
+}
+interface OpenBankingConnectionStatus {
+  connectionId: string;
+  tenantId: string;
+  status: 'healthy' | 'degraded' | 'error' | 'disconnected';
+  lastCheckedAt?: string;
+  errorCode?: string;
+  errorMessage?: string;
+  details?: Record<string, unknown>;
+}
+interface OpenBankingListAccountsParams {
+  tenantId: string;
+  connectionId: string;
+  userId?: string;
+  cursor?: string;
+  pageSize?: number;
+  includeBalances?: boolean;
+  institutionId?: string;
+}
+interface OpenBankingListAccountsResult {
+  accounts: OpenBankingAccountSummary[];
+  nextCursor?: string;
+  hasMore?: boolean;
+}
+interface OpenBankingGetAccountDetailsParams {
+  tenantId: string;
+  accountId: string;
+  connectionId: string;
+  includeBalances?: boolean;
+}
+interface OpenBankingListTransactionsParams {
+  tenantId: string;
+  accountId: string;
+  connectionId: string;
+  from?: string;
+  to?: string;
+  cursor?: string;
+  pageSize?: number;
+  includePending?: boolean;
+}
+interface OpenBankingListTransactionsResult {
+  transactions: OpenBankingTransaction[];
+  nextCursor?: string;
+  hasMore?: boolean;
+}
+interface OpenBankingGetBalancesParams {
+  tenantId: string;
+  accountId: string;
+  connectionId: string;
+  balanceTypes?: OpenBankingBalanceType[];
+}
+interface OpenBankingGetConnectionStatusParams {
+  tenantId: string;
+  connectionId: string;
+}
+interface OpenBankingProvider {
+  listAccounts(params: OpenBankingListAccountsParams): Promise<OpenBankingListAccountsResult>;
+  getAccountDetails(params: OpenBankingGetAccountDetailsParams): Promise<OpenBankingAccountDetails>;
+  listTransactions(params: OpenBankingListTransactionsParams): Promise<OpenBankingListTransactionsResult>;
+  getBalances(params: OpenBankingGetBalancesParams): Promise<OpenBankingAccountBalance[]>;
+  getConnectionStatus(params: OpenBankingGetConnectionStatusParams): Promise<OpenBankingConnectionStatus>;
+}
+//#endregion
+export { OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingGetAccountDetailsParams, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, OpenBankingTransaction };