@contractspec/integration.providers-impls 1.44.0

package/dist/impls/powens-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powens-client.js","names":["POWENS_BASE_URL: Record<PowensEnvironment, string>","searchParams: Record<string, string | number | boolean | undefined>","headers: Record<string, string>","requestId: string | undefined","errorBody: unknown","message: string"],"sources":["../../src/impls/powens-client.ts"],"sourcesContent":["import { URL } from 'node:url';\n\nexport type PowensEnvironment = 'sandbox' | 'production';\n\nconst POWENS_BASE_URL: Record<PowensEnvironment, string> = {\n  sandbox: 'https://api-sandbox.powens.com/v2',\n  production: 'https://api.powens.com/v2',\n};\n\nexport interface PowensClientOptions {\n  clientId: string;\n  clientSecret: string;\n  apiKey?: string;\n  environment: PowensEnvironment;\n  baseUrl?: string;\n  fetchImpl?: typeof fetch;\n  defaultTimeoutMs?: number;\n  logger?: {\n    debug?: (...args: unknown[]) => void;\n    warn?: (...args: unknown[]) => void;\n    error?: (...args: unknown[]) => void;\n  };\n}\n\ninterface PowensOAuthTokenResponse {\n  access_token: string;\n  expires_in: number;\n  scope?: string;\n  token_type: string;\n}\n\ninterface PowensOAuthToken {\n  accessToken: string;\n  expiresAt: number;\n  scope?: string;\n}\n\nexport interface PowensAccount {\n  uuid: string;\n  reference: string;\n  userUuid: string;\n  institution: {\n    id: string;\n    name: string;\n    logoUrl?: string;\n  };\n  name: string;\n  iban?: string;\n  bic?: string;\n  currency?: string;\n  balance?: number;\n  availableBalance?: number;\n  type?: string;\n  status?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface PowensAccountListResponse {\n  accounts: PowensAccount[];\n  pagination?: {\n    nextCursor?: string;\n    hasMore?: boolean;\n  };\n}\n\nexport interface PowensTransaction {\n  uuid: string;\n  accountUuid: string;\n  amount: number;\n  currency: string;\n  direction: 'credit' | 'debit';\n  description?: string;\n  category?: string;\n  rawLabel?: string;\n  bookingDate?: string;\n  valueDate?: string;\n  status?: string;\n  merchantName?: string;\n  merchantCategoryCode?: string;\n  counterpartyName?: string;\n  counterpartyAccount?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface PowensTransactionListResponse {\n  transactions: PowensTransaction[];\n  pagination?: {\n    nextCursor?: string;\n    hasMore?: boolean;\n  };\n}\n\nexport interface PowensBalance {\n  accountUuid: string;\n  type: string;\n  amount: number;\n  currency: string;\n  updatedAt: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface PowensConnectionStatusResponse {\n  connectionUuid: string;\n  status: 'healthy' | 'error' | 'revoked' | 'pending';\n  lastAttemptAt?: string;\n  errorCode?: string;\n  errorMessage?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport class PowensClientError extends Error {\n  readonly status: number;\n  readonly code?: string;\n  readonly requestId?: string;\n  readonly response?: unknown;\n\n  constructor(\n    message: string,\n    status: number,\n    code?: string,\n    requestId?: string,\n    response?: unknown\n  ) {\n    super(message);\n    this.name = 'PowensClientError';\n    this.status = status;\n    this.code = code;\n    this.requestId = requestId;\n    this.response = response;\n  }\n}\n\ninterface RequestOptions {\n  method: string;\n  path: string;\n  searchParams?: Record<string, string | number | boolean | undefined>;\n  body?: Record<string, unknown> | undefined;\n  headers?: Record<string, string | undefined>;\n  timeoutMs?: number;\n  skipAuth?: boolean;\n}\n\nexport class PowensClient {\n  private readonly clientId: string;\n  private readonly clientSecret: string;\n  private readonly apiKey?: string;\n  private readonly fetchImpl: typeof fetch;\n  private readonly logger?: PowensClientOptions['logger'];\n  private readonly defaultTimeoutMs: number;\n  private token?: PowensOAuthToken;\n  private readonly baseUrl: string;\n\n  constructor(options: PowensClientOptions) {\n    this.clientId = options.clientId;\n    this.clientSecret = options.clientSecret;\n    this.apiKey = options.apiKey;\n    this.fetchImpl = options.fetchImpl ?? fetch;\n    this.logger = options.logger;\n    this.defaultTimeoutMs = options.defaultTimeoutMs ?? 15000;\n    this.baseUrl =\n      options.baseUrl ??\n      POWENS_BASE_URL[options.environment] ??\n      POWENS_BASE_URL.production;\n  }\n\n  async listAccounts(params: {\n    userUuid: string;\n    cursor?: string;\n    limit?: number;\n    includeBalances?: boolean;\n    institutionUuid?: string;\n  }): Promise<PowensAccountListResponse> {\n    const searchParams: Record<string, string | number | boolean | undefined> =\n      {\n        cursor: params.cursor,\n        limit: params.limit,\n        include_balances: params.includeBalances,\n        institution_uuid: params.institutionUuid,\n      };\n    const response = await this.request<PowensAccountListResponse>({\n      method: 'GET',\n      path: `/users/${encodeURIComponent(params.userUuid)}/accounts`,\n      searchParams,\n    });\n    return response;\n  }\n\n  async getAccount(accountUuid: string): Promise<PowensAccount> {\n    return this.request<PowensAccount>({\n      method: 'GET',\n      path: `/accounts/${encodeURIComponent(accountUuid)}`,\n    });\n  }\n\n  async listTransactions(params: {\n    accountUuid: string;\n    cursor?: string;\n    limit?: number;\n    from?: string;\n    to?: string;\n    includePending?: boolean;\n  }): Promise<PowensTransactionListResponse> {\n    const searchParams: Record<string, string | number | boolean | undefined> =\n      {\n        cursor: params.cursor,\n        limit: params.limit,\n        from: params.from,\n        to: params.to,\n        include_pending: params.includePending,\n      };\n    return this.request<PowensTransactionListResponse>({\n      method: 'GET',\n      path: `/accounts/${encodeURIComponent(params.accountUuid)}/transactions`,\n      searchParams,\n    });\n  }\n\n  async getBalances(accountUuid: string): Promise<PowensBalance[]> {\n    return this.request<PowensBalance[]>({\n      method: 'GET',\n      path: `/accounts/${encodeURIComponent(accountUuid)}/balances`,\n    });\n  }\n\n  async getConnectionStatus(\n    connectionUuid: string\n  ): Promise<PowensConnectionStatusResponse> {\n    return this.request<PowensConnectionStatusResponse>({\n      method: 'GET',\n      path: `/connections/${encodeURIComponent(connectionUuid)}`,\n    });\n  }\n\n  private async request<T>(options: RequestOptions): Promise<T> {\n    const url = new URL(options.path, this.baseUrl);\n    if (options.searchParams) {\n      for (const [key, value] of Object.entries(options.searchParams)) {\n        if (value === undefined || value === null) continue;\n        url.searchParams.set(key, String(value));\n      }\n    }\n\n    const headers: Record<string, string> = {\n      Accept: 'application/json',\n      'Content-Type': 'application/json',\n      ...options.headers,\n    };\n\n    if (this.apiKey) {\n      headers['x-api-key'] = this.apiKey;\n    }\n\n    if (!options.skipAuth) {\n      const token = await this.ensureAccessToken();\n      headers.Authorization = `Bearer ${token}`;\n    }\n\n    const controller = new AbortController();\n    const timeout = setTimeout(\n      () => controller.abort(),\n      options.timeoutMs ?? this.defaultTimeoutMs\n    );\n\n    try {\n      const response = await this.fetchImpl(url, {\n        method: options.method,\n        headers,\n        body: options.body ? JSON.stringify(options.body) : undefined,\n        signal: controller.signal,\n      });\n\n      const requestId: string | undefined =\n        response.headers.get('x-request-id') ?? undefined;\n\n      if (!response.ok) {\n        let errorBody: unknown;\n        try {\n          errorBody = await response.json();\n        } catch {\n          // ignore parsing errors\n        }\n        const errorObject =\n          typeof errorBody === 'object' && errorBody !== null\n            ? (errorBody as Record<string, unknown>)\n            : undefined;\n        const message: string =\n          typeof errorObject?.message === 'string'\n            ? errorObject.message\n            : `Powens API request failed with status ${response.status}`;\n        const code =\n          typeof errorObject?.code === 'string' ? errorObject.code : undefined;\n        throw new PowensClientError(\n          message,\n          response.status,\n          code,\n          requestId,\n          errorBody\n        );\n      }\n\n      if (response.status === 204) {\n        return undefined as T;\n      }\n\n      try {\n        return (await response.json()) as T;\n      } catch (error) {\n        this.logger?.error?.(\n          '[PowensClient] Failed to parse JSON response',\n          error\n        );\n        throw new PowensClientError(\n          'Failed to parse Powens response payload as JSON',\n          response.status,\n          undefined,\n          requestId\n        );\n      }\n    } catch (error) {\n      if (error instanceof PowensClientError) {\n        throw error;\n      }\n      if ((error as Error).name === 'AbortError') {\n        throw new PowensClientError(\n          `Powens API request timed out after ${options.timeoutMs ?? this.defaultTimeoutMs}ms`,\n          408\n        );\n      }\n      this.logger?.error?.('[PowensClient] Request failed', error);\n      throw new PowensClientError(\n        (error as Error).message ?? 'Powens API request failed',\n        500\n      );\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n\n  private async ensureAccessToken(): Promise<string> {\n    if (this.token && Date.now() < this.token.expiresAt - 5000) {\n      return this.token.accessToken;\n    }\n    this.token = await this.fetchAccessToken();\n    return this.token.accessToken;\n  }\n\n  private async fetchAccessToken(): Promise<PowensOAuthToken> {\n    const url = new URL('/oauth/token', this.baseUrl);\n    const basicAuth = Buffer.from(\n      `${this.clientId}:${this.clientSecret}`,\n      'utf-8'\n    ).toString('base64');\n\n    const response = await this.fetchImpl(url, {\n      method: 'POST',\n      headers: {\n        Authorization: `Basic ${basicAuth}`,\n        'Content-Type': 'application/x-www-form-urlencoded',\n        Accept: 'application/json',\n      },\n      body: new URLSearchParams({\n        grant_type: 'client_credentials',\n      }).toString(),\n    });\n\n    if (!response.ok) {\n      let errorBody: unknown;\n      try {\n        errorBody = await response.json();\n      } catch {\n        // ignore\n      }\n      const errorObject =\n        typeof errorBody === 'object' && errorBody !== null\n          ? (errorBody as Record<string, unknown>)\n          : undefined;\n      const message: string =\n        typeof errorObject?.error_description === 'string'\n          ? errorObject.error_description\n          : 'Failed to obtain Powens access token';\n      throw new PowensClientError(\n        message,\n        response.status,\n        undefined,\n        undefined,\n        errorBody\n      );\n    }\n\n    const payload = (await response.json()) as PowensOAuthTokenResponse;\n    const expiresAt = Date.now() + payload.expires_in * 1000;\n    this.logger?.debug?.('[PowensClient] Received access token', {\n      expiresIn: payload.expires_in,\n    });\n    return {\n      accessToken: payload.access_token,\n      expiresAt,\n      scope: payload.scope,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/impls/powens-openbanking.d.ts

@@ -0,0 +1,28 @@
+import { openbanking_d_exports } from "../openbanking.js";
+import { PowensClientOptions } from "./powens-client.js";
+
+//#region src/impls/powens-openbanking.d.ts
+type PowensOpenBankingProviderOptions = PowensClientOptions;
+declare class PowensOpenBankingProvider implements openbanking_d_exports.OpenBankingProvider {
+  private readonly client;
+  private readonly logger?;
+  constructor(options: PowensOpenBankingProviderOptions);
+  listAccounts(params: openbanking_d_exports.OpenBankingListAccountsParams): Promise<openbanking_d_exports.OpenBankingListAccountsResult>;
+  getAccountDetails(params: openbanking_d_exports.OpenBankingGetAccountDetailsParams): Promise<openbanking_d_exports.OpenBankingAccountDetails>;
+  listTransactions(params: openbanking_d_exports.OpenBankingListTransactionsParams): Promise<openbanking_d_exports.OpenBankingListTransactionsResult>;
+  getBalances(params: openbanking_d_exports.OpenBankingGetBalancesParams): Promise<openbanking_d_exports.OpenBankingAccountBalance[]>;
+  getConnectionStatus(params: openbanking_d_exports.OpenBankingGetConnectionStatusParams): Promise<openbanking_d_exports.OpenBankingConnectionStatus>;
+  private mapAccount;
+  private mapAccountDetails;
+  private mapTransaction;
+  private mapBalance;
+  private toContext;
+  private mapOwnership;
+  private mapAccountStatus;
+  private mapTransactionStatus;
+  private mapConnectionStatus;
+  private handleError;
+}
+//#endregion
+export { PowensOpenBankingProvider, PowensOpenBankingProviderOptions };
+//# sourceMappingURL=powens-openbanking.d.ts.map

package/dist/impls/powens-openbanking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powens-openbanking.d.ts","names":[],"sources":["../../src/impls/powens-openbanking.ts"],"sourcesContent":[],"mappings":";;;;KAyBY,gCAAA,GAAmC;cAOlC,yBAAA,YAAqC,qBAAA,CAAA;EAPtC,iBAAA,MAAA;EAOC,iBAAA,MAAA;EAIU,WAAA,CAAA,OAAA,EAAA,gCAAA;EAMX,YAAA,CAAA,MAAA,EAAA,qBAAA,CAAA,6BAAA,CAAA,EACP,OADO,CACC,qBAAA,CAAA,6BADD,CAAA;EACC,iBAAA,CAAA,MAAA,EA6BD,qBAAA,CAAA,kCA7BC,CAAA,EA8BR,OA9BQ,CA8BA,qBAAA,CAAA,yBA9BA,CAAA;EAAR,gBAAA,CAAA,MAAA,EAyCO,qBAAA,CAAA,iCAzCP,CAAA,EA0CA,OA1CA,CA0CQ,qBAAA,CAAA,iCA1CR,CAAA;EA6BO,WAAA,CAAA,MAAA,EAqCA,qBAAA,CAAA,4BArCA,CAAA,EAsCP,OAtCO,CAsCC,qBAAA,CAAA,yBAtCD,EAAA,CAAA;EACC,mBAAA,CAAA,MAAA,EAsDD,qBAAA,CAAA,oCAtDC,CAAA,EAuDR,OAvDQ,CAuDA,qBAAA,CAAA,2BAvDA,CAAA;EAAR,QAAA,UAAA;EAWO,QAAA,iBAAA;EACC,QAAA,cAAA;EAAR,QAAA,UAAA;EAwBO,QAAA,SAAA;EACC,QAAA,YAAA;EAAR,QAAA,gBAAA;EAiBO,QAAA,oBAAA;EACC,QAAA,mBAAA;EAAR,QAAA,WAAA"}

package/dist/impls/powens-openbanking.js

@@ -0,0 +1,219 @@
+import { PowensClient, PowensClientError } from "./powens-client.js";
+
+//#region src/impls/powens-openbanking.ts
+var PowensOpenBankingProvider = class {
+	client;
+	logger;
+	constructor(options) {
+		this.client = new PowensClient(options);
+		this.logger = options.logger;
+	}
+	async listAccounts(params) {
+		if (!params.userId) throw new PowensClientError("Powens account listing requires the upstream userId mapped to Powens user UUID.", 400);
+		const context = this.toContext(params.tenantId, params.connectionId);
+		try {
+			const response = await this.client.listAccounts({
+				userUuid: params.userId,
+				cursor: params.cursor,
+				limit: params.pageSize,
+				includeBalances: params.includeBalances,
+				institutionUuid: params.institutionId
+			});
+			return {
+				accounts: response.accounts.map((account) => this.mapAccount(account, context)),
+				nextCursor: response.pagination?.nextCursor,
+				hasMore: response.pagination?.hasMore
+			};
+		} catch (error) {
+			this.handleError("listAccounts", error);
+		}
+	}
+	async getAccountDetails(params) {
+		const context = this.toContext(params.tenantId, params.connectionId);
+		try {
+			const account = await this.client.getAccount(params.accountId);
+			return this.mapAccountDetails(account, context);
+		} catch (error) {
+			this.handleError("getAccountDetails", error);
+		}
+	}
+	async listTransactions(params) {
+		const context = this.toContext(params.tenantId, params.connectionId);
+		try {
+			const response = await this.client.listTransactions({
+				accountUuid: params.accountId,
+				cursor: params.cursor,
+				limit: params.pageSize,
+				from: params.from,
+				to: params.to,
+				includePending: params.includePending
+			});
+			return {
+				transactions: response.transactions.map((transaction) => this.mapTransaction(transaction, context)),
+				nextCursor: response.pagination?.nextCursor,
+				hasMore: response.pagination?.hasMore
+			};
+		} catch (error) {
+			this.handleError("listTransactions", error);
+		}
+	}
+	async getBalances(params) {
+		const context = this.toContext(params.tenantId, params.connectionId);
+		try {
+			return (await this.client.getBalances(params.accountId)).filter((balance) => params.balanceTypes?.length ? params.balanceTypes.includes(String(balance.type)) : true).map((balance) => this.mapBalance(balance, context));
+		} catch (error) {
+			this.handleError("getBalances", error);
+		}
+	}
+	async getConnectionStatus(params) {
+		try {
+			const status = await this.client.getConnectionStatus(params.connectionId);
+			return {
+				connectionId: params.connectionId,
+				tenantId: params.tenantId,
+				status: this.mapConnectionStatus(status.status),
+				lastCheckedAt: status.lastAttemptAt,
+				errorCode: status.errorCode,
+				errorMessage: status.errorMessage,
+				details: status.metadata
+			};
+		} catch (error) {
+			this.handleError("getConnectionStatus", error);
+		}
+	}
+	mapAccount(account, context) {
+		return {
+			id: account.uuid,
+			externalId: account.reference ?? account.uuid,
+			tenantId: context.tenantId,
+			connectionId: context.connectionId,
+			userId: account.userUuid,
+			displayName: account.name,
+			institutionId: account.institution.id,
+			institutionName: account.institution.name,
+			institutionLogoUrl: account.institution.logoUrl,
+			accountType: account.type ?? "unknown",
+			iban: account.iban,
+			bic: account.bic,
+			currency: account.currency ?? "EUR",
+			accountNumberMasked: account.metadata?.account_number_masked,
+			ownership: this.mapOwnership(account.metadata?.ownership),
+			status: this.mapAccountStatus(account.status),
+			lastSyncedAt: account.metadata?.last_sync_at,
+			metadata: account.metadata
+		};
+	}
+	mapAccountDetails(account, context) {
+		return {
+			...this.mapAccount(account, context),
+			productCode: account.metadata?.product_code,
+			openedAt: account.metadata?.opened_at,
+			closedAt: account.metadata?.closed_at,
+			availableBalance: account.availableBalance ?? void 0,
+			currentBalance: account.balance ?? void 0,
+			creditLimit: account.metadata?.credit_limit,
+			customFields: account.metadata
+		};
+	}
+	mapTransaction(transaction, context) {
+		return {
+			id: transaction.uuid,
+			externalId: transaction.uuid,
+			tenantId: context.tenantId,
+			accountId: transaction.accountUuid,
+			connectionId: context.connectionId,
+			amount: transaction.amount,
+			currency: transaction.currency,
+			direction: transaction.direction === "credit" ? "credit" : "debit",
+			description: transaction.description ?? transaction.rawLabel,
+			bookingDate: transaction.bookingDate,
+			valueDate: transaction.valueDate,
+			postedAt: transaction.bookingDate,
+			category: transaction.category,
+			rawCategory: transaction.rawLabel,
+			merchantName: transaction.merchantName,
+			merchantCategoryCode: transaction.merchantCategoryCode,
+			counterpartyName: transaction.counterpartyName,
+			counterpartyAccount: transaction.counterpartyAccount,
+			reference: transaction.metadata?.reference,
+			status: this.mapTransactionStatus(transaction.status),
+			metadata: transaction.metadata
+		};
+	}
+	mapBalance(balance, context) {
+		return {
+			accountId: balance.accountUuid,
+			connectionId: context.connectionId,
+			tenantId: context.tenantId,
+			type: balance.type ?? "current",
+			currency: balance.currency ?? "EUR",
+			amount: balance.amount,
+			lastUpdatedAt: balance.updatedAt,
+			metadata: balance.metadata
+		};
+	}
+	toContext(tenantId, connectionId) {
+		return {
+			tenantId,
+			connectionId
+		};
+	}
+	mapOwnership(value) {
+		switch (value?.toLowerCase()) {
+			case "individual":
+			case "personal": return "individual";
+			case "joint": return "joint";
+			case "business":
+			case "corporate": return "business";
+			default: return "unknown";
+		}
+	}
+	mapAccountStatus(status) {
+		switch (status?.toLowerCase()) {
+			case "active":
+			case "enabled": return "active";
+			case "disabled":
+			case "inactive": return "inactive";
+			case "closed": return "closed";
+			case "suspended": return "suspended";
+			default: return "active";
+		}
+	}
+	mapTransactionStatus(status) {
+		switch (status?.toLowerCase()) {
+			case "pending":
+			case "authorised": return "pending";
+			case "booked":
+			case "posted": return "booked";
+			case "cancelled":
+			case "rejected": return "cancelled";
+			default: return "booked";
+		}
+	}
+	mapConnectionStatus(status) {
+		switch (status) {
+			case "healthy": return "healthy";
+			case "pending": return "degraded";
+			case "error": return "error";
+			case "revoked": return "disconnected";
+			default: return "degraded";
+		}
+	}
+	handleError(operation, error) {
+		if (error instanceof PowensClientError) {
+			this.logger?.error?.(`[PowensOpenBankingProvider] ${operation} failed`, {
+				status: error.status,
+				code: error.code,
+				requestId: error.requestId,
+				message: error.message
+			});
+			throw error;
+		}
+		this.logger?.error?.(`[PowensOpenBankingProvider] ${operation} failed with unexpected error`, error);
+		throw error instanceof Error ? error : /* @__PURE__ */ new Error(`Powens operation "${operation}" failed`);
+	}
+};
+
+//#endregion
+export { PowensOpenBankingProvider };
+//# sourceMappingURL=powens-openbanking.js.map

package/dist/impls/powens-openbanking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powens-openbanking.js","names":[],"sources":["../../src/impls/powens-openbanking.ts"],"sourcesContent":["import type {\n  OpenBankingAccountBalance,\n  OpenBankingAccountDetails,\n  OpenBankingAccountSummary,\n  OpenBankingConnectionStatus,\n  OpenBankingGetAccountDetailsParams,\n  OpenBankingGetBalancesParams,\n  OpenBankingGetConnectionStatusParams,\n  OpenBankingListAccountsParams,\n  OpenBankingListAccountsResult,\n  OpenBankingListTransactionsParams,\n  OpenBankingListTransactionsResult,\n  OpenBankingProvider,\n  OpenBankingTransaction,\n} from '../openbanking';\nimport {\n  PowensClient,\n  PowensClientError,\n  type PowensClientOptions,\n  type PowensAccount,\n  type PowensTransaction,\n  type PowensBalance,\n  type PowensConnectionStatusResponse,\n} from './powens-client';\n\nexport type PowensOpenBankingProviderOptions = PowensClientOptions;\n\ninterface ProviderContext {\n  tenantId: string;\n  connectionId: string;\n}\n\nexport class PowensOpenBankingProvider implements OpenBankingProvider {\n  private readonly client: PowensClient;\n  private readonly logger?: PowensClientOptions['logger'];\n\n  constructor(options: PowensOpenBankingProviderOptions) {\n    this.client = new PowensClient(options);\n    this.logger = options.logger;\n  }\n\n  async listAccounts(\n    params: OpenBankingListAccountsParams\n  ): Promise<OpenBankingListAccountsResult> {\n    if (!params.userId) {\n      throw new PowensClientError(\n        'Powens account listing requires the upstream userId mapped to Powens user UUID.',\n        400\n      );\n    }\n    const context = this.toContext(params.tenantId, params.connectionId);\n    try {\n      const response = await this.client.listAccounts({\n        userUuid: params.userId,\n        cursor: params.cursor,\n        limit: params.pageSize,\n        includeBalances: params.includeBalances,\n        institutionUuid: params.institutionId,\n      });\n      return {\n        accounts: response.accounts.map((account) =>\n          this.mapAccount(account, context)\n        ),\n        nextCursor: response.pagination?.nextCursor,\n        hasMore: response.pagination?.hasMore,\n      };\n    } catch (error) {\n      this.handleError('listAccounts', error);\n    }\n  }\n\n  async getAccountDetails(\n    params: OpenBankingGetAccountDetailsParams\n  ): Promise<OpenBankingAccountDetails> {\n    const context = this.toContext(params.tenantId, params.connectionId);\n    try {\n      const account = await this.client.getAccount(params.accountId);\n      return this.mapAccountDetails(account, context);\n    } catch (error) {\n      this.handleError('getAccountDetails', error);\n    }\n  }\n\n  async listTransactions(\n    params: OpenBankingListTransactionsParams\n  ): Promise<OpenBankingListTransactionsResult> {\n    const context = this.toContext(params.tenantId, params.connectionId);\n    try {\n      const response = await this.client.listTransactions({\n        accountUuid: params.accountId,\n        cursor: params.cursor,\n        limit: params.pageSize,\n        from: params.from,\n        to: params.to,\n        includePending: params.includePending,\n      });\n      return {\n        transactions: response.transactions.map((transaction) =>\n          this.mapTransaction(transaction, context)\n        ),\n        nextCursor: response.pagination?.nextCursor,\n        hasMore: response.pagination?.hasMore,\n      };\n    } catch (error) {\n      this.handleError('listTransactions', error);\n    }\n  }\n\n  async getBalances(\n    params: OpenBankingGetBalancesParams\n  ): Promise<OpenBankingAccountBalance[]> {\n    const context = this.toContext(params.tenantId, params.connectionId);\n    try {\n      const balances = await this.client.getBalances(params.accountId);\n      return balances\n        .filter((balance) =>\n          params.balanceTypes?.length\n            ? params.balanceTypes.includes(String(balance.type))\n            : true\n        )\n        .map((balance) => this.mapBalance(balance, context));\n    } catch (error) {\n      this.handleError('getBalances', error);\n    }\n  }\n\n  async getConnectionStatus(\n    params: OpenBankingGetConnectionStatusParams\n  ): Promise<OpenBankingConnectionStatus> {\n    try {\n      const status = await this.client.getConnectionStatus(params.connectionId);\n      return {\n        connectionId: params.connectionId,\n        tenantId: params.tenantId,\n        status: this.mapConnectionStatus(status.status),\n        lastCheckedAt: status.lastAttemptAt,\n        errorCode: status.errorCode,\n        errorMessage: status.errorMessage,\n        details: status.metadata,\n      };\n    } catch (error) {\n      this.handleError('getConnectionStatus', error);\n    }\n  }\n\n  private mapAccount(\n    account: PowensAccount,\n    context: ProviderContext\n  ): OpenBankingAccountSummary {\n    return {\n      id: account.uuid,\n      externalId: account.reference ?? account.uuid,\n      tenantId: context.tenantId,\n      connectionId: context.connectionId,\n      userId: account.userUuid,\n      displayName: account.name,\n      institutionId: account.institution.id,\n      institutionName: account.institution.name,\n      institutionLogoUrl: account.institution.logoUrl,\n      accountType: account.type ?? 'unknown',\n      iban: account.iban,\n      bic: account.bic,\n      currency: account.currency ?? 'EUR',\n      accountNumberMasked: account.metadata?.account_number_masked as\n        | string\n        | undefined,\n      ownership: this.mapOwnership(\n        account.metadata?.ownership as string | undefined\n      ),\n      status: this.mapAccountStatus(account.status),\n      lastSyncedAt: account.metadata?.last_sync_at as string | undefined,\n      metadata: account.metadata,\n    };\n  }\n\n  private mapAccountDetails(\n    account: PowensAccount,\n    context: ProviderContext\n  ): OpenBankingAccountDetails {\n    return {\n      ...this.mapAccount(account, context),\n      productCode: account.metadata?.product_code as string | undefined,\n      openedAt: account.metadata?.opened_at as string | undefined,\n      closedAt: account.metadata?.closed_at as string | undefined,\n      availableBalance: account.availableBalance ?? undefined,\n      currentBalance: account.balance ?? undefined,\n      creditLimit: account.metadata?.credit_limit as number | undefined,\n      customFields: account.metadata,\n    };\n  }\n\n  private mapTransaction(\n    transaction: PowensTransaction,\n    context: ProviderContext\n  ): OpenBankingTransaction {\n    return {\n      id: transaction.uuid,\n      externalId: transaction.uuid,\n      tenantId: context.tenantId,\n      accountId: transaction.accountUuid,\n      connectionId: context.connectionId,\n      amount: transaction.amount,\n      currency: transaction.currency,\n      direction: transaction.direction === 'credit' ? 'credit' : 'debit',\n      description: transaction.description ?? transaction.rawLabel,\n      bookingDate: transaction.bookingDate,\n      valueDate: transaction.valueDate,\n      postedAt: transaction.bookingDate,\n      category: transaction.category,\n      rawCategory: transaction.rawLabel,\n      merchantName: transaction.merchantName,\n      merchantCategoryCode: transaction.merchantCategoryCode,\n      counterpartyName: transaction.counterpartyName,\n      counterpartyAccount: transaction.counterpartyAccount,\n      reference: transaction.metadata?.reference as string | undefined,\n      status: this.mapTransactionStatus(transaction.status),\n      metadata: transaction.metadata,\n    };\n  }\n\n  private mapBalance(\n    balance: PowensBalance,\n    context: ProviderContext\n  ): OpenBankingAccountBalance {\n    return {\n      accountId: balance.accountUuid,\n      connectionId: context.connectionId,\n      tenantId: context.tenantId,\n      type: (balance.type ?? 'current') as OpenBankingAccountBalance['type'],\n      currency: balance.currency ?? 'EUR',\n      amount: balance.amount,\n      lastUpdatedAt: balance.updatedAt,\n      metadata: balance.metadata,\n    };\n  }\n\n  private toContext(tenantId: string, connectionId: string): ProviderContext {\n    return { tenantId, connectionId };\n  }\n\n  private mapOwnership(value: string | undefined) {\n    switch (value?.toLowerCase()) {\n      case 'individual':\n      case 'personal':\n        return 'individual';\n      case 'joint':\n        return 'joint';\n      case 'business':\n      case 'corporate':\n        return 'business';\n      default:\n        return 'unknown';\n    }\n  }\n\n  private mapAccountStatus(status?: string) {\n    switch (status?.toLowerCase()) {\n      case 'active':\n      case 'enabled':\n        return 'active';\n      case 'disabled':\n      case 'inactive':\n        return 'inactive';\n      case 'closed':\n        return 'closed';\n      case 'suspended':\n        return 'suspended';\n      default:\n        return 'active';\n    }\n  }\n\n  private mapTransactionStatus(status?: string) {\n    switch (status?.toLowerCase()) {\n      case 'pending':\n      case 'authorised':\n        return 'pending';\n      case 'booked':\n      case 'posted':\n        return 'booked';\n      case 'cancelled':\n      case 'rejected':\n        return 'cancelled';\n      default:\n        return 'booked';\n    }\n  }\n\n  private mapConnectionStatus(\n    status: PowensConnectionStatusResponse['status']\n  ): OpenBankingConnectionStatus['status'] {\n    switch (status) {\n      case 'healthy':\n        return 'healthy';\n      case 'pending':\n        return 'degraded';\n      case 'error':\n        return 'error';\n      case 'revoked':\n        return 'disconnected';\n      default:\n        return 'degraded';\n    }\n  }\n\n  private handleError(operation: string, error: unknown): never {\n    if (error instanceof PowensClientError) {\n      this.logger?.error?.(`[PowensOpenBankingProvider] ${operation} failed`, {\n        status: error.status,\n        code: error.code,\n        requestId: error.requestId,\n        message: error.message,\n      });\n      throw error;\n    }\n    this.logger?.error?.(\n      `[PowensOpenBankingProvider] ${operation} failed with unexpected error`,\n      error\n    );\n    throw error instanceof Error\n      ? error\n      : new Error(`Powens operation \"${operation}\" failed`);\n  }\n}\n"],"mappings":"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"}

package/dist/impls/provider-factory.d.ts

@@ -0,0 +1,27 @@
+import { email_d_exports } from "../email.js";
+import { embedding_d_exports } from "../embedding.js";
+import { voice_d_exports } from "../voice.js";
+import { storage_d_exports } from "../storage.js";
+import { payments_d_exports } from "../payments.js";
+import { sms_d_exports } from "../sms.js";
+import { vector_store_d_exports } from "../vector-store.js";
+import { llm_d_exports } from "../llm.js";
+import { openbanking_d_exports } from "../openbanking.js";
+import { IntegrationContext } from "@contractspec/integration.runtime/runtime";
+
+//#region src/impls/provider-factory.d.ts
+declare class IntegrationProviderFactory {
+  createPaymentsProvider(context: IntegrationContext): Promise<payments_d_exports.PaymentsProvider>;
+  createEmailOutboundProvider(context: IntegrationContext): Promise<email_d_exports.EmailOutboundProvider>;
+  createSmsProvider(context: IntegrationContext): Promise<sms_d_exports.SmsProvider>;
+  createVectorStoreProvider(context: IntegrationContext): Promise<vector_store_d_exports.VectorStoreProvider>;
+  createObjectStorageProvider(context: IntegrationContext): Promise<storage_d_exports.ObjectStorageProvider>;
+  createVoiceProvider(context: IntegrationContext): Promise<voice_d_exports.VoiceProvider>;
+  createLlmProvider(context: IntegrationContext): Promise<llm_d_exports.LLMProvider>;
+  createEmbeddingProvider(context: IntegrationContext): Promise<embedding_d_exports.EmbeddingProvider>;
+  createOpenBankingProvider(context: IntegrationContext): Promise<openbanking_d_exports.OpenBankingProvider>;
+  private loadSecrets;
+}
+//#endregion
+export { IntegrationProviderFactory };
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/impls/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","names":[],"sources":["../../src/impls/provider-factory.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;cA0Ba,0BAAA;kCAEA,qBACR,QAAQ,kBAAA,CAAA;EAHA,2BAAA,CAAA,OAA0B,EAsB1B,kBAtB0B,CAAA,EAuBlC,OAvBkC,CAuB1B,eAAA,CAAA,qBAvB0B,CAAA;EAE1B,iBAAA,CAAA,OAAA,EA2CsB,kBA3CtB,CAAA,EA2C2C,OA3C3C,CA2CmD,aAAA,CAAA,WA3CnD,CAAA;EACA,yBAAA,CAAA,OAAA,EAmEA,kBAnEA,CAAA,EAoER,OApEQ,CAoEA,sBAAA,CAAA,mBApEA,CAAA;EAAR,2BAAA,CAAA,OAAA,EAwFQ,kBAxFR,CAAA,EAyFA,OAzFA,CAyFQ,iBAAA,CAAA,qBAzFR,CAAA;EAmBQ,mBAAA,CAAA,OAAA,EA8FA,kBA9FA,CAAA,EA+FR,OA/FQ,CA+FA,eAAA,CAAA,aA/FA,CAAA;EACA,iBAAA,CAAA,OAAA,EAkHsB,kBAlHtB,CAAA,EAkH2C,OAlH3C,CAkHmD,aAAA,CAAA,WAlHnD,CAAA;EAAR,uBAAA,CAAA,OAAA,EAsIQ,kBAtIR,CAAA,EAuIA,OAvIA,CAuIQ,mBAAA,CAAA,iBAvIR,CAAA;EAsB8B,yBAAA,CAAA,OAAA,EAsItB,kBAtIsB,CAAA,EAuI9B,OAvI8B,CAuItB,qBAAA,CAAA,mBAvIsB,CAAA;EAA6B,QAAA,WAAA"}

package/dist/impls/provider-factory.js

@@ -0,0 +1,143 @@
+import { MistralLLMProvider } from "./mistral-llm.js";
+import { MistralEmbeddingProvider } from "./mistral-embedding.js";
+import { QdrantVectorProvider } from "./qdrant-vector.js";
+import { GoogleCloudStorageProvider } from "./gcs-storage.js";
+import { StripePaymentsProvider } from "./stripe-payments.js";
+import { PostmarkEmailProvider } from "./postmark-email.js";
+import { TwilioSmsProvider } from "./twilio-sms.js";
+import { ElevenLabsVoiceProvider } from "./elevenlabs-voice.js";
+import { PowensOpenBankingProvider } from "./powens-openbanking.js";
+import { Buffer } from "node:buffer";
+
+//#region src/impls/provider-factory.ts
+const SECRET_CACHE = /* @__PURE__ */ new Map();
+var IntegrationProviderFactory = class {
+	async createPaymentsProvider(context) {
+		const secrets = await this.loadSecrets(context);
+		switch (context.spec.meta.key) {
+			case "payments.stripe": return new StripePaymentsProvider({ apiKey: requireSecret(secrets, "apiKey", "Stripe API key is required") });
+			default: throw new Error(`Unsupported payments integration: ${context.spec.meta.key}`);
+		}
+	}
+	async createEmailOutboundProvider(context) {
+		const secrets = await this.loadSecrets(context);
+		switch (context.spec.meta.key) {
+			case "email.postmark": return new PostmarkEmailProvider({
+				serverToken: requireSecret(secrets, "serverToken", "Postmark server token is required"),
+				defaultFromEmail: context.config.fromEmail,
+				messageStream: context.config.messageStream
+			});
+			default: throw new Error(`Unsupported email integration: ${context.spec.meta.key}`);
+		}
+	}
+	async createSmsProvider(context) {
+		const secrets = await this.loadSecrets(context);
+		switch (context.spec.meta.key) {
+			case "sms.twilio": return new TwilioSmsProvider({
+				accountSid: requireSecret(secrets, "accountSid", "Twilio account SID is required"),
+				authToken: requireSecret(secrets, "authToken", "Twilio auth token is required"),
+				fromNumber: context.config.fromNumber
+			});
+			default: throw new Error(`Unsupported SMS integration: ${context.spec.meta.key}`);
+		}
+	}
+	async createVectorStoreProvider(context) {
+		const secrets = await this.loadSecrets(context);
+		switch (context.spec.meta.key) {
+			case "vectordb.qdrant": return new QdrantVectorProvider({
+				url: requireConfig(context, "apiUrl", "Qdrant apiUrl config is required"),
+				apiKey: secrets.apiKey
+			});
+			default: throw new Error(`Unsupported vector store integration: ${context.spec.meta.key}`);
+		}
+	}
+	async createObjectStorageProvider(context) {
+		const secrets = await this.loadSecrets(context);
+		switch (context.spec.meta.key) {
+			case "storage.s3":
+			case "storage.gcs": return new GoogleCloudStorageProvider({
+				bucket: requireConfig(context, "bucket", "Storage bucket is required"),
+				clientOptions: secrets.type === "service_account" ? { credentials: secrets } : void 0
+			});
+			default: throw new Error(`Unsupported storage integration: ${context.spec.meta.key}`);
+		}
+	}
+	async createVoiceProvider(context) {
+		const secrets = await this.loadSecrets(context);
+		switch (context.spec.meta.key) {
+			case "ai-voice.elevenlabs": return new ElevenLabsVoiceProvider({
+				apiKey: requireSecret(secrets, "apiKey", "ElevenLabs API key is required"),
+				defaultVoiceId: context.config.defaultVoiceId
+			});
+			default: throw new Error(`Unsupported voice integration: ${context.spec.meta.key}`);
+		}
+	}
+	async createLlmProvider(context) {
+		const secrets = await this.loadSecrets(context);
+		switch (context.spec.meta.key) {
+			case "ai-llm.mistral": return new MistralLLMProvider({
+				apiKey: requireSecret(secrets, "apiKey", "Mistral API key is required"),
+				defaultModel: context.config.model
+			});
+			default: throw new Error(`Unsupported LLM integration: ${context.spec.meta.key}`);
+		}
+	}
+	async createEmbeddingProvider(context) {
+		const secrets = await this.loadSecrets(context);
+		switch (context.spec.meta.key) {
+			case "ai-llm.mistral": return new MistralEmbeddingProvider({
+				apiKey: requireSecret(secrets, "apiKey", "Mistral API key is required"),
+				defaultModel: context.config.embeddingModel
+			});
+			default: throw new Error(`Unsupported embeddings integration: ${context.spec.meta.key}`);
+		}
+	}
+	async createOpenBankingProvider(context) {
+		const secrets = await this.loadSecrets(context);
+		const config = context.config;
+		switch (context.spec.meta.key) {
+			case "openbanking.powens": {
+				const environmentValue = requireConfig(context, "environment", "Powens environment (sandbox | production) must be specified in integration config.");
+				if (environmentValue !== "sandbox" && environmentValue !== "production") throw new Error(`Powens environment "${environmentValue}" is invalid. Expected "sandbox" or "production".`);
+				return new PowensOpenBankingProvider({
+					clientId: requireSecret(secrets, "clientId", "Powens clientId is required"),
+					clientSecret: requireSecret(secrets, "clientSecret", "Powens clientSecret is required"),
+					apiKey: secrets.apiKey,
+					environment: environmentValue,
+					baseUrl: config?.baseUrl
+				});
+			}
+			default: throw new Error(`Unsupported open banking integration: ${context.spec.meta.key}`);
+		}
+	}
+	async loadSecrets(context) {
+		const cacheKey = context.connection.meta.id;
+		if (SECRET_CACHE.has(cacheKey)) return SECRET_CACHE.get(cacheKey) ?? {};
+		const value = parseSecret(await context.secretProvider.getSecret(context.secretReference));
+		SECRET_CACHE.set(cacheKey, value);
+		return value;
+	}
+};
+function parseSecret(secret) {
+	const text = Buffer.from(secret.data).toString("utf-8").trim();
+	if (!text) return {};
+	try {
+		return JSON.parse(text);
+	} catch {
+		return { apiKey: text };
+	}
+}
+function requireSecret(secrets, key, message) {
+	const value = secrets[key];
+	if (value == null || value === "") throw new Error(message);
+	return value;
+}
+function requireConfig(context, key, message) {
+	const value = context.config?.[key];
+	if (value == null) throw new Error(message);
+	return value;
+}
+
+//#endregion
+export { IntegrationProviderFactory };
+//# sourceMappingURL=provider-factory.js.map

package/dist/impls/provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.js","names":[],"sources":["../../src/impls/provider-factory.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\n\nimport type { IntegrationContext } from '@contractspec/integration.runtime/runtime';\nimport type { SecretValue } from '@contractspec/integration.runtime/secrets/provider';\nimport { MistralLLMProvider } from './mistral-llm';\nimport { MistralEmbeddingProvider } from './mistral-embedding';\nimport { QdrantVectorProvider } from './qdrant-vector';\nimport { GoogleCloudStorageProvider } from './gcs-storage';\nimport { StripePaymentsProvider } from './stripe-payments';\nimport { PostmarkEmailProvider } from './postmark-email';\nimport { TwilioSmsProvider } from './twilio-sms';\nimport { ElevenLabsVoiceProvider } from './elevenlabs-voice';\nimport type { PaymentsProvider } from '../payments';\nimport type { EmailOutboundProvider } from '../email';\nimport type { SmsProvider } from '../sms';\nimport type { VectorStoreProvider } from '../vector-store';\nimport type { ObjectStorageProvider } from '../storage';\nimport type { VoiceProvider } from '../voice';\nimport type { LLMProvider } from '../llm';\nimport type { EmbeddingProvider } from '../embedding';\nimport type { OpenBankingProvider } from '../openbanking';\nimport { PowensOpenBankingProvider } from './powens-openbanking';\nimport type { PowensEnvironment } from './powens-client';\n\nconst SECRET_CACHE = new Map<string, Record<string, unknown>>();\n\nexport class IntegrationProviderFactory {\n  async createPaymentsProvider(\n    context: IntegrationContext\n  ): Promise<PaymentsProvider> {\n    const secrets = await this.loadSecrets(context);\n    switch (context.spec.meta.key) {\n      case 'payments.stripe':\n        return new StripePaymentsProvider({\n          apiKey: requireSecret<string>(\n            secrets,\n            'apiKey',\n            'Stripe API key is required'\n          ),\n        });\n      default:\n        throw new Error(\n          `Unsupported payments integration: ${context.spec.meta.key}`\n        );\n    }\n  }\n\n  async createEmailOutboundProvider(\n    context: IntegrationContext\n  ): Promise<EmailOutboundProvider> {\n    const secrets = await this.loadSecrets(context);\n    switch (context.spec.meta.key) {\n      case 'email.postmark':\n        return new PostmarkEmailProvider({\n          serverToken: requireSecret<string>(\n            secrets,\n            'serverToken',\n            'Postmark server token is required'\n          ),\n          defaultFromEmail: (context.config as { fromEmail?: string })\n            .fromEmail,\n          messageStream: (context.config as { messageStream?: string })\n            .messageStream,\n        });\n      default:\n        throw new Error(\n          `Unsupported email integration: ${context.spec.meta.key}`\n        );\n    }\n  }\n\n  async createSmsProvider(context: IntegrationContext): Promise<SmsProvider> {\n    const secrets = await this.loadSecrets(context);\n    switch (context.spec.meta.key) {\n      case 'sms.twilio':\n        return new TwilioSmsProvider({\n          accountSid: requireSecret<string>(\n            secrets,\n            'accountSid',\n            'Twilio account SID is required'\n          ),\n          authToken: requireSecret<string>(\n            secrets,\n            'authToken',\n            'Twilio auth token is required'\n          ),\n          fromNumber: (context.config as { fromNumber?: string }).fromNumber,\n        });\n      default:\n        throw new Error(\n          `Unsupported SMS integration: ${context.spec.meta.key}`\n        );\n    }\n  }\n\n  async createVectorStoreProvider(\n    context: IntegrationContext\n  ): Promise<VectorStoreProvider> {\n    const secrets = await this.loadSecrets(context);\n    switch (context.spec.meta.key) {\n      case 'vectordb.qdrant':\n        return new QdrantVectorProvider({\n          url: requireConfig<string>(\n            context,\n            'apiUrl',\n            'Qdrant apiUrl config is required'\n          ),\n          apiKey: secrets.apiKey as string | undefined,\n        });\n      default:\n        throw new Error(\n          `Unsupported vector store integration: ${context.spec.meta.key}`\n        );\n    }\n  }\n\n  async createObjectStorageProvider(\n    context: IntegrationContext\n  ): Promise<ObjectStorageProvider> {\n    const secrets = await this.loadSecrets(context);\n    switch (context.spec.meta.key) {\n      case 'storage.s3':\n      case 'storage.gcs':\n        return new GoogleCloudStorageProvider({\n          bucket: requireConfig<string>(\n            context,\n            'bucket',\n            'Storage bucket is required'\n          ),\n          clientOptions:\n            secrets.type === 'service_account'\n              ? { credentials: secrets as Record<string, unknown> }\n              : undefined,\n        });\n      default:\n        throw new Error(\n          `Unsupported storage integration: ${context.spec.meta.key}`\n        );\n    }\n  }\n\n  async createVoiceProvider(\n    context: IntegrationContext\n  ): Promise<VoiceProvider> {\n    const secrets = await this.loadSecrets(context);\n    switch (context.spec.meta.key) {\n      case 'ai-voice.elevenlabs':\n        return new ElevenLabsVoiceProvider({\n          apiKey: requireSecret<string>(\n            secrets,\n            'apiKey',\n            'ElevenLabs API key is required'\n          ),\n          defaultVoiceId: (context.config as { defaultVoiceId?: string })\n            .defaultVoiceId,\n        });\n      default:\n        throw new Error(\n          `Unsupported voice integration: ${context.spec.meta.key}`\n        );\n    }\n  }\n\n  async createLlmProvider(context: IntegrationContext): Promise<LLMProvider> {\n    const secrets = await this.loadSecrets(context);\n    switch (context.spec.meta.key) {\n      case 'ai-llm.mistral':\n        return new MistralLLMProvider({\n          apiKey: requireSecret<string>(\n            secrets,\n            'apiKey',\n            'Mistral API key is required'\n          ),\n          defaultModel: (context.config as { model?: string }).model,\n        });\n      default:\n        throw new Error(\n          `Unsupported LLM integration: ${context.spec.meta.key}`\n        );\n    }\n  }\n\n  async createEmbeddingProvider(\n    context: IntegrationContext\n  ): Promise<EmbeddingProvider> {\n    const secrets = await this.loadSecrets(context);\n    switch (context.spec.meta.key) {\n      case 'ai-llm.mistral':\n        return new MistralEmbeddingProvider({\n          apiKey: requireSecret<string>(\n            secrets,\n            'apiKey',\n            'Mistral API key is required'\n          ),\n          defaultModel: (context.config as { embeddingModel?: string })\n            .embeddingModel,\n        });\n      default:\n        throw new Error(\n          `Unsupported embeddings integration: ${context.spec.meta.key}`\n        );\n    }\n  }\n\n  async createOpenBankingProvider(\n    context: IntegrationContext\n  ): Promise<OpenBankingProvider> {\n    const secrets = await this.loadSecrets(context);\n    const config = context.config as {\n      environment?: string;\n      baseUrl?: string;\n      region?: string;\n      pollingIntervalMs?: number;\n    };\n\n    switch (context.spec.meta.key) {\n      case 'openbanking.powens': {\n        const environmentValue = requireConfig<string>(\n          context,\n          'environment',\n          'Powens environment (sandbox | production) must be specified in integration config.'\n        );\n        if (\n          environmentValue !== 'sandbox' &&\n          environmentValue !== 'production'\n        ) {\n          throw new Error(\n            `Powens environment \"${environmentValue}\" is invalid. Expected \"sandbox\" or \"production\".`\n          );\n        }\n\n        return new PowensOpenBankingProvider({\n          clientId: requireSecret<string>(\n            secrets,\n            'clientId',\n            'Powens clientId is required'\n          ),\n          clientSecret: requireSecret<string>(\n            secrets,\n            'clientSecret',\n            'Powens clientSecret is required'\n          ),\n          apiKey: secrets.apiKey as string | undefined,\n          environment: environmentValue as PowensEnvironment,\n          baseUrl: config?.baseUrl as string | undefined,\n        });\n      }\n      default:\n        throw new Error(\n          `Unsupported open banking integration: ${context.spec.meta.key}`\n        );\n    }\n  }\n\n  private async loadSecrets(\n    context: IntegrationContext\n  ): Promise<Record<string, unknown>> {\n    const cacheKey = context.connection.meta.id;\n    if (SECRET_CACHE.has(cacheKey)) {\n      const cached = SECRET_CACHE.get(cacheKey);\n      return cached ?? {};\n    }\n    const secret = await context.secretProvider.getSecret(\n      context.secretReference\n    );\n    const value = parseSecret(secret);\n    SECRET_CACHE.set(cacheKey, value);\n    return value;\n  }\n}\n\nfunction parseSecret(secret: SecretValue): Record<string, unknown> {\n  const text = Buffer.from(secret.data).toString('utf-8').trim();\n  if (!text) return {};\n  try {\n    return JSON.parse(text);\n  } catch {\n    return { apiKey: text };\n  }\n}\n\nfunction requireSecret<T>(\n  secrets: Record<string, unknown>,\n  key: string,\n  message: string\n): T {\n  const value = secrets[key];\n  if (value == null || value === '') {\n    throw new Error(message);\n  }\n  return value as T;\n}\n\nfunction requireConfig<T>(\n  context: IntegrationContext,\n  key: string,\n  message: string\n): T {\n  const config = context.config as Record<string, unknown>;\n  const value = config?.[key];\n  if (value == null) {\n    throw new Error(message);\n  }\n  return value as T;\n}\n"],"mappings":"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"}

package/dist/impls/qdrant-vector.d.ts

@@ -0,0 +1,25 @@
+import { vector_store_d_exports } from "../vector-store.js";
+import { QdrantClient, QdrantClientParams } from "@qdrant/js-client-rest";
+
+//#region src/impls/qdrant-vector.d.ts
+interface QdrantVectorProviderOptions {
+  url: string;
+  apiKey?: string;
+  client?: QdrantClient;
+  createCollectionIfMissing?: boolean;
+  distance?: 'Cosine' | 'Euclid' | 'Dot' | 'Manhattan';
+  clientParams?: Omit<QdrantClientParams, 'url' | 'apiKey'>;
+}
+declare class QdrantVectorProvider implements vector_store_d_exports.VectorStoreProvider {
+  private readonly client;
+  private readonly createCollectionIfMissing;
+  private readonly distance;
+  constructor(options: QdrantVectorProviderOptions);
+  upsert(request: vector_store_d_exports.VectorUpsertRequest): Promise<void>;
+  search(query: vector_store_d_exports.VectorSearchQuery): Promise<vector_store_d_exports.VectorSearchResult[]>;
+  delete(request: vector_store_d_exports.VectorDeleteRequest): Promise<void>;
+  private ensureCollection;
+}
+//#endregion
+export { QdrantVectorProvider, QdrantVectorProviderOptions };
+//# sourceMappingURL=qdrant-vector.d.ts.map

package/dist/impls/qdrant-vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-vector.d.ts","names":[],"sources":["../../src/impls/qdrant-vector.ts"],"sourcesContent":[],"mappings":";;;;UAUiB,2BAAA;;EAAA,MAAA,CAAA,EAAA,MAAA;EAGN,MAAA,CAAA,EAAA,YAAA;EAGW,yBAAA,CAAA,EAAA,OAAA;EAAL,QAAA,CAAA,EAAA,QAAA,GAAA,QAAA,GAAA,KAAA,GAAA,WAAA;EAAI,YAAA,CAAA,EAAJ,IAAI,CAAC,kBAAD,EAAA,KAAA,GAAA,QAAA,CAAA;AAGrB;AAKuB,cALV,oBAAA,YAAgC,sBAAA,CAAA,mBAKtB,CAAA;EAYC,iBAAA,MAAA;EAAsB,iBAAA,yBAAA;EA4BxB,iBAAA,QAAA;EAA4B,WAAA,CAAA,OAAA,EAxC3B,2BAwC2B;EAAR,MAAA,CAAA,OAAA,EA5BlB,sBAAA,CAAA,mBA4BkB,CAAA,EA5BI,OA4BJ,CAAA,IAAA,CAAA;EAqBlB,MAAA,CAAA,KAAA,EArBF,sBAAA,CAAA,iBAqBE,CAAA,EArBkB,OAqBlB,CArB0B,sBAAA,CAAA,kBAqB1B,EAAA,CAAA;EAAsB,MAAA,CAAA,OAAA,EAAtB,sBAAA,CAAA,mBAAsB,CAAA,EAAA,OAAA,CAAA,IAAA,CAAA;EAlED,QAAA,gBAAA"}

package/dist/impls/qdrant-vector.js

@@ -0,0 +1,72 @@
+import { QdrantClient } from "@qdrant/js-client-rest";
+
+//#region src/impls/qdrant-vector.ts
+var QdrantVectorProvider = class {
+	client;
+	createCollectionIfMissing;
+	distance;
+	constructor(options) {
+		this.client = options.client ?? new QdrantClient({
+			url: options.url,
+			apiKey: options.apiKey,
+			...options.clientParams
+		});
+		this.createCollectionIfMissing = options.createCollectionIfMissing ?? true;
+		this.distance = options.distance ?? "Cosine";
+	}
+	async upsert(request) {
+		if (request.documents.length === 0) return;
+		const firstDocument = request.documents[0];
+		if (!firstDocument) return;
+		const vectorSize = firstDocument.vector.length;
+		if (this.createCollectionIfMissing) await this.ensureCollection(request.collection, vectorSize);
+		const points = request.documents.map((document) => ({
+			id: document.id,
+			vector: document.vector,
+			payload: {
+				...document.payload,
+				...document.namespace ? { namespace: document.namespace } : {},
+				...document.expiresAt ? { expiresAt: document.expiresAt.toISOString() } : {}
+			}
+		}));
+		await this.client.upsert(request.collection, {
+			wait: true,
+			points
+		});
+	}
+	async search(query) {
+		return (await this.client.search(query.collection, {
+			vector: query.vector,
+			limit: query.topK,
+			filter: query.filter,
+			score_threshold: query.scoreThreshold,
+			with_payload: true,
+			with_vector: false
+		})).map((item) => ({
+			id: String(item.id),
+			score: item.score,
+			payload: item.payload ?? void 0,
+			namespace: typeof item.payload === "object" && item.payload !== null ? item.payload.namespace : void 0
+		}));
+	}
+	async delete(request) {
+		await this.client.delete(request.collection, {
+			wait: true,
+			points: request.ids
+		});
+	}
+	async ensureCollection(collectionName, vectorSize) {
+		try {
+			await this.client.getCollection(collectionName);
+		} catch (_error) {
+			await this.client.createCollection(collectionName, { vectors: {
+				size: vectorSize,
+				distance: this.distance
+			} });
+		}
+	}
+};
+
+//#endregion
+export { QdrantVectorProvider };
+//# sourceMappingURL=qdrant-vector.js.map

package/dist/impls/qdrant-vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-vector.js","names":[],"sources":["../../src/impls/qdrant-vector.ts"],"sourcesContent":["import { QdrantClient, type QdrantClientParams } from '@qdrant/js-client-rest';\n\nimport type {\n  VectorDeleteRequest,\n  VectorSearchQuery,\n  VectorSearchResult,\n  VectorStoreProvider,\n  VectorUpsertRequest,\n} from '../vector-store';\n\nexport interface QdrantVectorProviderOptions {\n  url: string;\n  apiKey?: string;\n  client?: QdrantClient;\n  createCollectionIfMissing?: boolean;\n  distance?: 'Cosine' | 'Euclid' | 'Dot' | 'Manhattan';\n  clientParams?: Omit<QdrantClientParams, 'url' | 'apiKey'>;\n}\n\nexport class QdrantVectorProvider implements VectorStoreProvider {\n  private readonly client: QdrantClient;\n  private readonly createCollectionIfMissing: boolean;\n  private readonly distance: 'Cosine' | 'Euclid' | 'Dot' | 'Manhattan';\n\n  constructor(options: QdrantVectorProviderOptions) {\n    this.client =\n      options.client ??\n      new QdrantClient({\n        url: options.url,\n        apiKey: options.apiKey,\n        ...options.clientParams,\n      });\n    this.createCollectionIfMissing = options.createCollectionIfMissing ?? true;\n    this.distance = options.distance ?? 'Cosine';\n  }\n\n  async upsert(request: VectorUpsertRequest): Promise<void> {\n    if (request.documents.length === 0) return;\n    const firstDocument = request.documents[0];\n    if (!firstDocument) return;\n    const vectorSize = firstDocument.vector.length;\n\n    if (this.createCollectionIfMissing) {\n      await this.ensureCollection(request.collection, vectorSize);\n    }\n\n    const points = request.documents.map((document) => ({\n      id: document.id,\n      vector: document.vector,\n      payload: {\n        ...document.payload,\n        ...(document.namespace ? { namespace: document.namespace } : {}),\n        ...(document.expiresAt\n          ? { expiresAt: document.expiresAt.toISOString() }\n          : {}),\n      },\n    }));\n\n    await this.client.upsert(request.collection, {\n      wait: true,\n      points,\n    });\n  }\n\n  async search(query: VectorSearchQuery): Promise<VectorSearchResult[]> {\n    const results = await this.client.search(query.collection, {\n      vector: query.vector,\n      limit: query.topK,\n      filter: query.filter as Record<string, unknown>,\n      score_threshold: query.scoreThreshold,\n      with_payload: true,\n      with_vector: false,\n    });\n\n    return results.map((item) => ({\n      id: String(item.id),\n      score: item.score,\n      payload: item.payload ?? undefined,\n      namespace:\n        typeof item.payload === 'object' && item.payload !== null\n          ? (item.payload.namespace as string | undefined)\n          : undefined,\n    }));\n  }\n\n  async delete(request: VectorDeleteRequest): Promise<void> {\n    await this.client.delete(request.collection, {\n      wait: true,\n      points: request.ids,\n    });\n  }\n\n  private async ensureCollection(\n    collectionName: string,\n    vectorSize: number\n  ): Promise<void> {\n    try {\n      await this.client.getCollection(collectionName);\n    } catch (_error) {\n      await this.client.createCollection(collectionName, {\n        vectors: {\n          size: vectorSize,\n          distance: this.distance,\n        },\n      });\n    }\n  }\n}\n"],"mappings":";;;AAmBA,IAAa,uBAAb,MAAiE;CAC/D,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAsC;AAChD,OAAK,SACH,QAAQ,UACR,IAAI,aAAa;GACf,KAAK,QAAQ;GACb,QAAQ,QAAQ;GAChB,GAAG,QAAQ;GACZ,CAAC;AACJ,OAAK,4BAA4B,QAAQ,6BAA6B;AACtE,OAAK,WAAW,QAAQ,YAAY;;CAGtC,MAAM,OAAO,SAA6C;AACxD,MAAI,QAAQ,UAAU,WAAW,EAAG;EACpC,MAAM,gBAAgB,QAAQ,UAAU;AACxC,MAAI,CAAC,cAAe;EACpB,MAAM,aAAa,cAAc,OAAO;AAExC,MAAI,KAAK,0BACP,OAAM,KAAK,iBAAiB,QAAQ,YAAY,WAAW;EAG7D,MAAM,SAAS,QAAQ,UAAU,KAAK,cAAc;GAClD,IAAI,SAAS;GACb,QAAQ,SAAS;GACjB,SAAS;IACP,GAAG,SAAS;IACZ,GAAI,SAAS,YAAY,EAAE,WAAW,SAAS,WAAW,GAAG,EAAE;IAC/D,GAAI,SAAS,YACT,EAAE,WAAW,SAAS,UAAU,aAAa,EAAE,GAC/C,EAAE;IACP;GACF,EAAE;AAEH,QAAM,KAAK,OAAO,OAAO,QAAQ,YAAY;GAC3C,MAAM;GACN;GACD,CAAC;;CAGJ,MAAM,OAAO,OAAyD;AAUpE,UATgB,MAAM,KAAK,OAAO,OAAO,MAAM,YAAY;GACzD,QAAQ,MAAM;GACd,OAAO,MAAM;GACb,QAAQ,MAAM;GACd,iBAAiB,MAAM;GACvB,cAAc;GACd,aAAa;GACd,CAAC,EAEa,KAAK,UAAU;GAC5B,IAAI,OAAO,KAAK,GAAG;GACnB,OAAO,KAAK;GACZ,SAAS,KAAK,WAAW;GACzB,WACE,OAAO,KAAK,YAAY,YAAY,KAAK,YAAY,OAChD,KAAK,QAAQ,YACd;GACP,EAAE;;CAGL,MAAM,OAAO,SAA6C;AACxD,QAAM,KAAK,OAAO,OAAO,QAAQ,YAAY;GAC3C,MAAM;GACN,QAAQ,QAAQ;GACjB,CAAC;;CAGJ,MAAc,iBACZ,gBACA,YACe;AACf,MAAI;AACF,SAAM,KAAK,OAAO,cAAc,eAAe;WACxC,QAAQ;AACf,SAAM,KAAK,OAAO,iBAAiB,gBAAgB,EACjD,SAAS;IACP,MAAM;IACN,UAAU,KAAK;IAChB,EACF,CAAC"}