@lssm/lib.contracts 1.41.1 → 1.42.2

package/dist/integrations/providers/impls/mistral-llm.js

@@ -1 +1,247 @@
-import{Mistral as e}from"@mistralai/mistralai";var t=class{client;defaultModel;constructor(t){if(!t.apiKey)throw Error(`MistralLLMProvider requires an apiKey`);this.client=t.client??new e({apiKey:t.apiKey,serverURL:t.serverURL,userAgent:t.userAgentSuffix?`${t.userAgentSuffix}`:void 0}),this.defaultModel=t.defaultModel??`mistral-large-latest`}async chat(e,t={}){let n=this.buildChatRequest(e,t),r=await this.client.chat.complete(n);return this.buildLLMResponse(r)}async*stream(e,t={}){let r=this.buildChatRequest(e,t);r.stream=!0;let i=await this.client.chat.stream(r),a=[],o=[],s,c;for await(let e of i){for(let t of e.data.choices){let e=t.delta;if(typeof e.content==`string`)e.content.length>0&&(a.push({type:`text`,text:e.content}),yield{type:`message_delta`,delta:{type:`text`,text:e.content},index:t.index});else if(Array.isArray(e.content))for(let n of e.content)n.type===`text`&&`text`in n&&(a.push({type:`text`,text:n.text}),yield{type:`message_delta`,delta:{type:`text`,text:n.text},index:t.index});if(e.toolCalls){let n=0;for(let r of e.toolCalls){let e=this.fromMistralToolCall(r,n);o.push(e),yield{type:`tool_call`,call:e,index:t.index},n+=1}}t.finishReason&&t.finishReason!==`null`&&(c=t.finishReason)}if(e.data.usage){let t=this.fromUsage(e.data.usage);t&&(s=t,yield{type:`usage`,usage:t})}}let l={role:`assistant`,content:a.length?a:[{type:`text`,text:``}]};o.length>0&&(l.content=[...o,...a.length?a:[]]),yield{type:`end`,response:{message:l,usage:s,finishReason:n(c)}}}async countTokens(e){throw Error(`Mistral API does not currently support token counting`)}buildChatRequest(e,t){let n={model:t.model??this.defaultModel,messages:e.map(e=>this.toMistralMessage(e))};return t.temperature!=null&&(n.temperature=t.temperature),t.topP!=null&&(n.topP=t.topP),t.maxOutputTokens!=null&&(n.maxTokens=t.maxOutputTokens),t.stopSequences?.length&&(n.stop=t.stopSequences.length===1?t.stopSequences[0]:t.stopSequences),t.tools?.length&&(n.tools=t.tools.map(e=>({type:`function`,function:{name:e.name,description:e.description,parameters:typeof e.inputSchema==`object`&&e.inputSchema!==null?e.inputSchema:{}}}))),t.responseFormat===`json`&&(n.responseFormat={type:`json_object`}),n}buildLLMResponse(e){let t=e.choices[0];return t?{message:this.fromAssistantMessage(t.message),usage:this.fromUsage(e.usage),finishReason:n(t.finishReason),raw:e}:{message:{role:`assistant`,content:[{type:`text`,text:``}]},usage:this.fromUsage(e.usage),raw:e}}fromUsage(e){if(e)return{promptTokens:e.promptTokens??0,completionTokens:e.completionTokens??0,totalTokens:e.totalTokens??0}}fromAssistantMessage(e){let t=[];typeof e.content==`string`?t.push({type:`text`,text:e.content}):Array.isArray(e.content)&&e.content.forEach(e=>{e.type===`text`&&`text`in e&&t.push({type:`text`,text:e.text})});let n=e.toolCalls?.map((e,t)=>this.fromMistralToolCall(e,t))??[];return n.length>0&&t.splice(0,0,...n),t.length===0&&t.push({type:`text`,text:``}),{role:`assistant`,content:t}}fromMistralToolCall(e,t){let n=typeof e.function.arguments==`string`?e.function.arguments:JSON.stringify(e.function.arguments);return{type:`tool-call`,id:e.id??`tool-call-${t}`,name:e.function.name,arguments:n}}toMistralMessage(e){let t=this.extractText(e.content),n=this.extractToolCalls(e);switch(e.role){case`system`:return{role:`system`,content:t??``};case`user`:return{role:`user`,content:t??``};case`assistant`:return{role:`assistant`,content:n.length>0?null:t??``,toolCalls:n.length>0?n:void 0};case`tool`:return{role:`tool`,content:t??``,toolCallId:e.toolCallId??n[0]?.id};default:return{role:`user`,content:t??``}}}extractText(e){let t=e.filter(e=>e.type===`text`).map(e=>e.text);return t.length===0?null:t.join(``)}extractToolCalls(e){return e.content.filter(e=>e.type===`tool-call`).map((e,t)=>({id:e.id??`call_${t}`,type:`function`,index:t,function:{name:e.name,arguments:e.arguments}}))}};function n(e){if(e)switch(e.toLowerCase()){case`stop`:return`stop`;case`length`:return`length`;case`tool_call`:case`tool_calls`:return`tool_call`;case`content_filter`:return`content_filter`;default:return}}export{t as MistralLLMProvider};
+import { Mistral } from "@mistralai/mistralai";
+
+//#region src/integrations/providers/impls/mistral-llm.ts
+var MistralLLMProvider = class {
+	client;
+	defaultModel;
+	constructor(options) {
+		if (!options.apiKey) throw new Error("MistralLLMProvider requires an apiKey");
+		this.client = options.client ?? new Mistral({
+			apiKey: options.apiKey,
+			serverURL: options.serverURL,
+			userAgent: options.userAgentSuffix ? `${options.userAgentSuffix}` : void 0
+		});
+		this.defaultModel = options.defaultModel ?? "mistral-large-latest";
+	}
+	async chat(messages, options = {}) {
+		const request = this.buildChatRequest(messages, options);
+		const response = await this.client.chat.complete(request);
+		return this.buildLLMResponse(response);
+	}
+	async *stream(messages, options = {}) {
+		const request = this.buildChatRequest(messages, options);
+		request.stream = true;
+		const stream = await this.client.chat.stream(request);
+		const aggregatedParts = [];
+		const aggregatedToolCalls = [];
+		let usage;
+		let finishReason;
+		for await (const event of stream) {
+			for (const choice of event.data.choices) {
+				const delta = choice.delta;
+				if (typeof delta.content === "string") {
+					if (delta.content.length > 0) {
+						aggregatedParts.push({
+							type: "text",
+							text: delta.content
+						});
+						yield {
+							type: "message_delta",
+							delta: {
+								type: "text",
+								text: delta.content
+							},
+							index: choice.index
+						};
+					}
+				} else if (Array.isArray(delta.content)) {
+					for (const chunk of delta.content) if (chunk.type === "text" && "text" in chunk) {
+						aggregatedParts.push({
+							type: "text",
+							text: chunk.text
+						});
+						yield {
+							type: "message_delta",
+							delta: {
+								type: "text",
+								text: chunk.text
+							},
+							index: choice.index
+						};
+					}
+				}
+				if (delta.toolCalls) {
+					let localIndex = 0;
+					for (const call of delta.toolCalls) {
+						const toolCall = this.fromMistralToolCall(call, localIndex);
+						aggregatedToolCalls.push(toolCall);
+						yield {
+							type: "tool_call",
+							call: toolCall,
+							index: choice.index
+						};
+						localIndex += 1;
+					}
+				}
+				if (choice.finishReason && choice.finishReason !== "null") finishReason = choice.finishReason;
+			}
+			if (event.data.usage) {
+				const usageEntry = this.fromUsage(event.data.usage);
+				if (usageEntry) {
+					usage = usageEntry;
+					yield {
+						type: "usage",
+						usage: usageEntry
+					};
+				}
+			}
+		}
+		const message = {
+			role: "assistant",
+			content: aggregatedParts.length ? aggregatedParts : [{
+				type: "text",
+				text: ""
+			}]
+		};
+		if (aggregatedToolCalls.length > 0) message.content = [...aggregatedToolCalls, ...aggregatedParts.length ? aggregatedParts : []];
+		yield {
+			type: "end",
+			response: {
+				message,
+				usage,
+				finishReason: mapFinishReason(finishReason)
+			}
+		};
+	}
+	async countTokens(_messages) {
+		throw new Error("Mistral API does not currently support token counting");
+	}
+	buildChatRequest(messages, options) {
+		const request = {
+			model: options.model ?? this.defaultModel,
+			messages: messages.map((message) => this.toMistralMessage(message))
+		};
+		if (options.temperature != null) request.temperature = options.temperature;
+		if (options.topP != null) request.topP = options.topP;
+		if (options.maxOutputTokens != null) request.maxTokens = options.maxOutputTokens;
+		if (options.stopSequences?.length) request.stop = options.stopSequences.length === 1 ? options.stopSequences[0] : options.stopSequences;
+		if (options.tools?.length) request.tools = options.tools.map((tool) => ({
+			type: "function",
+			function: {
+				name: tool.name,
+				description: tool.description,
+				parameters: typeof tool.inputSchema === "object" && tool.inputSchema !== null ? tool.inputSchema : {}
+			}
+		}));
+		if (options.responseFormat === "json") request.responseFormat = { type: "json_object" };
+		return request;
+	}
+	buildLLMResponse(response) {
+		const firstChoice = response.choices[0];
+		if (!firstChoice) return {
+			message: {
+				role: "assistant",
+				content: [{
+					type: "text",
+					text: ""
+				}]
+			},
+			usage: this.fromUsage(response.usage),
+			raw: response
+		};
+		return {
+			message: this.fromAssistantMessage(firstChoice.message),
+			usage: this.fromUsage(response.usage),
+			finishReason: mapFinishReason(firstChoice.finishReason),
+			raw: response
+		};
+	}
+	fromUsage(usage) {
+		if (!usage) return void 0;
+		return {
+			promptTokens: usage.promptTokens ?? 0,
+			completionTokens: usage.completionTokens ?? 0,
+			totalTokens: usage.totalTokens ?? 0
+		};
+	}
+	fromAssistantMessage(message) {
+		const parts = [];
+		if (typeof message.content === "string") parts.push({
+			type: "text",
+			text: message.content
+		});
+		else if (Array.isArray(message.content)) message.content.forEach((chunk) => {
+			if (chunk.type === "text" && "text" in chunk) parts.push({
+				type: "text",
+				text: chunk.text
+			});
+		});
+		const toolCalls = message.toolCalls?.map((call, index) => this.fromMistralToolCall(call, index)) ?? [];
+		if (toolCalls.length > 0) parts.splice(0, 0, ...toolCalls);
+		if (parts.length === 0) parts.push({
+			type: "text",
+			text: ""
+		});
+		return {
+			role: "assistant",
+			content: parts
+		};
+	}
+	fromMistralToolCall(call, index) {
+		const args = typeof call.function.arguments === "string" ? call.function.arguments : JSON.stringify(call.function.arguments);
+		return {
+			type: "tool-call",
+			id: call.id ?? `tool-call-${index}`,
+			name: call.function.name,
+			arguments: args
+		};
+	}
+	toMistralMessage(message) {
+		const textContent = this.extractText(message.content);
+		const toolCalls = this.extractToolCalls(message);
+		switch (message.role) {
+			case "system": return {
+				role: "system",
+				content: textContent ?? ""
+			};
+			case "user": return {
+				role: "user",
+				content: textContent ?? ""
+			};
+			case "assistant": return {
+				role: "assistant",
+				content: toolCalls.length > 0 ? null : textContent ?? "",
+				toolCalls: toolCalls.length > 0 ? toolCalls : void 0
+			};
+			case "tool": return {
+				role: "tool",
+				content: textContent ?? "",
+				toolCallId: message.toolCallId ?? toolCalls[0]?.id
+			};
+			default: return {
+				role: "user",
+				content: textContent ?? ""
+			};
+		}
+	}
+	extractText(parts) {
+		const textParts = parts.filter((part) => part.type === "text").map((part) => part.text);
+		if (textParts.length === 0) return null;
+		return textParts.join("");
+	}
+	extractToolCalls(message) {
+		return message.content.filter((part) => part.type === "tool-call").map((call, index) => ({
+			id: call.id ?? `call_${index}`,
+			type: "function",
+			index,
+			function: {
+				name: call.name,
+				arguments: call.arguments
+			}
+		}));
+	}
+};
+function mapFinishReason(reason) {
+	if (!reason) return void 0;
+	switch (reason.toLowerCase()) {
+		case "stop": return "stop";
+		case "length": return "length";
+		case "tool_call":
+		case "tool_calls": return "tool_call";
+		case "content_filter": return "content_filter";
+		default: return;
+	}
+}
+
+//#endregion
+export { MistralLLMProvider };

package/dist/integrations/providers/impls/postmark-email.d.ts

@@ -0,0 +1,19 @@
+import { EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult } from "../email.js";
+import { ServerClient } from "postmark";
+
+//#region src/integrations/providers/impls/postmark-email.d.ts
+interface PostmarkEmailProviderOptions {
+  serverToken: string;
+  defaultFromEmail?: string;
+  messageStream?: string;
+  client?: ServerClient;
+}
+declare class PostmarkEmailProvider implements EmailOutboundProvider {
+  private readonly client;
+  private readonly defaultFromEmail?;
+  private readonly messageStream?;
+  constructor(options: PostmarkEmailProviderOptions);
+  sendEmail(message: EmailOutboundMessage): Promise<EmailOutboundResult>;
+}
+//#endregion
+export { PostmarkEmailProvider, PostmarkEmailProviderOptions };

package/dist/integrations/providers/impls/postmark-email.js

@@ -1 +1,55 @@
-import{ServerClient as e}from"postmark";var t=class{client;defaultFromEmail;messageStream;constructor(t){this.client=t.client??new e(t.serverToken,{useHttps:!0}),this.defaultFromEmail=t.defaultFromEmail,this.messageStream=t.messageStream}async sendEmail(e){let t={From:n(e.from)??this.defaultFromEmail,To:e.to.map(e=>n(e)).join(`, `),Cc:e.cc?.map(e=>n(e)).join(`, `)||void 0,Bcc:e.bcc?.map(e=>n(e)).join(`, `)||void 0,ReplyTo:e.replyTo?n(e.replyTo):void 0,Subject:e.subject,TextBody:e.textBody,HtmlBody:e.htmlBody,Headers:e.headers?Object.entries(e.headers).map(([e,t])=>({Name:e,Value:t})):void 0,MessageStream:this.messageStream,Attachments:r(e)},i=await this.client.sendEmail(t);return{id:i.MessageID,providerMessageId:i.MessageID,queuedAt:new Date(i.SubmittedAt??new Date().toISOString())}}};function n(e){return e.name?`"${e.name}" <${e.email}>`:e.email}function r(e){if(e.attachments?.length)return e.attachments.filter(e=>e.data).map(e=>({Name:e.filename,Content:Buffer.from(e.data??new Uint8Array).toString(`base64`),ContentType:e.contentType,ContentID:null,ContentLength:e.sizeBytes,Disposition:`attachment`}))}export{t as PostmarkEmailProvider};
+import { ServerClient } from "postmark";
+
+//#region src/integrations/providers/impls/postmark-email.ts
+var PostmarkEmailProvider = class {
+	client;
+	defaultFromEmail;
+	messageStream;
+	constructor(options) {
+		this.client = options.client ?? new ServerClient(options.serverToken, { useHttps: true });
+		this.defaultFromEmail = options.defaultFromEmail;
+		this.messageStream = options.messageStream;
+	}
+	async sendEmail(message) {
+		const request = {
+			From: formatAddress(message.from) ?? this.defaultFromEmail,
+			To: message.to.map((addr) => formatAddress(addr)).join(", "),
+			Cc: message.cc?.map((addr) => formatAddress(addr)).join(", ") || void 0,
+			Bcc: message.bcc?.map((addr) => formatAddress(addr)).join(", ") || void 0,
+			ReplyTo: message.replyTo ? formatAddress(message.replyTo) : void 0,
+			Subject: message.subject,
+			TextBody: message.textBody,
+			HtmlBody: message.htmlBody,
+			Headers: message.headers ? Object.entries(message.headers).map(([name, value]) => ({
+				Name: name,
+				Value: value
+			})) : void 0,
+			MessageStream: this.messageStream,
+			Attachments: buildAttachments(message)
+		};
+		const response = await this.client.sendEmail(request);
+		return {
+			id: response.MessageID,
+			providerMessageId: response.MessageID,
+			queuedAt: new Date(response.SubmittedAt ?? (/* @__PURE__ */ new Date()).toISOString())
+		};
+	}
+};
+function formatAddress(address) {
+	if (address.name) return `"${address.name}" <${address.email}>`;
+	return address.email;
+}
+function buildAttachments(message) {
+	if (!message.attachments?.length) return void 0;
+	return message.attachments.filter((attachment) => attachment.data).map((attachment) => ({
+		Name: attachment.filename,
+		Content: Buffer.from(attachment.data ?? new Uint8Array()).toString("base64"),
+		ContentType: attachment.contentType,
+		ContentID: null,
+		ContentLength: attachment.sizeBytes,
+		Disposition: "attachment"
+	}));
+}
+
+//#endregion
+export { PostmarkEmailProvider };

package/dist/integrations/providers/impls/powens-client.d.ts

@@ -0,0 +1,124 @@
+//#region src/integrations/providers/impls/powens-client.d.ts
+type PowensEnvironment = 'sandbox' | 'production';
+interface PowensClientOptions {
+  clientId: string;
+  clientSecret: string;
+  apiKey?: string;
+  environment: PowensEnvironment;
+  baseUrl?: string;
+  fetchImpl?: typeof fetch;
+  defaultTimeoutMs?: number;
+  logger?: {
+    debug?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+  };
+}
+interface PowensAccount {
+  uuid: string;
+  reference: string;
+  userUuid: string;
+  institution: {
+    id: string;
+    name: string;
+    logoUrl?: string;
+  };
+  name: string;
+  iban?: string;
+  bic?: string;
+  currency?: string;
+  balance?: number;
+  availableBalance?: number;
+  type?: string;
+  status?: string;
+  metadata?: Record<string, unknown>;
+}
+interface PowensAccountListResponse {
+  accounts: PowensAccount[];
+  pagination?: {
+    nextCursor?: string;
+    hasMore?: boolean;
+  };
+}
+interface PowensTransaction {
+  uuid: string;
+  accountUuid: string;
+  amount: number;
+  currency: string;
+  direction: 'credit' | 'debit';
+  description?: string;
+  category?: string;
+  rawLabel?: string;
+  bookingDate?: string;
+  valueDate?: string;
+  status?: string;
+  merchantName?: string;
+  merchantCategoryCode?: string;
+  counterpartyName?: string;
+  counterpartyAccount?: string;
+  metadata?: Record<string, unknown>;
+}
+interface PowensTransactionListResponse {
+  transactions: PowensTransaction[];
+  pagination?: {
+    nextCursor?: string;
+    hasMore?: boolean;
+  };
+}
+interface PowensBalance {
+  accountUuid: string;
+  type: string;
+  amount: number;
+  currency: string;
+  updatedAt: string;
+  metadata?: Record<string, unknown>;
+}
+interface PowensConnectionStatusResponse {
+  connectionUuid: string;
+  status: 'healthy' | 'error' | 'revoked' | 'pending';
+  lastAttemptAt?: string;
+  errorCode?: string;
+  errorMessage?: string;
+  metadata?: Record<string, unknown>;
+}
+declare class PowensClientError extends Error {
+  readonly status: number;
+  readonly code?: string;
+  readonly requestId?: string;
+  readonly response?: unknown;
+  constructor(message: string, status: number, code?: string, requestId?: string, response?: unknown);
+}
+declare class PowensClient {
+  private readonly clientId;
+  private readonly clientSecret;
+  private readonly apiKey?;
+  private readonly fetchImpl;
+  private readonly logger?;
+  private readonly defaultTimeoutMs;
+  private token?;
+  private readonly baseUrl;
+  constructor(options: PowensClientOptions);
+  listAccounts(params: {
+    userUuid: string;
+    cursor?: string;
+    limit?: number;
+    includeBalances?: boolean;
+    institutionUuid?: string;
+  }): Promise<PowensAccountListResponse>;
+  getAccount(accountUuid: string): Promise<PowensAccount>;
+  listTransactions(params: {
+    accountUuid: string;
+    cursor?: string;
+    limit?: number;
+    from?: string;
+    to?: string;
+    includePending?: boolean;
+  }): Promise<PowensTransactionListResponse>;
+  getBalances(accountUuid: string): Promise<PowensBalance[]>;
+  getConnectionStatus(connectionUuid: string): Promise<PowensConnectionStatusResponse>;
+  private request;
+  private ensureAccessToken;
+  private fetchAccessToken;
+}
+//#endregion
+export { PowensAccount, PowensAccountListResponse, PowensBalance, PowensClient, PowensClientError, PowensClientOptions, PowensConnectionStatusResponse, PowensEnvironment, PowensTransaction, PowensTransactionListResponse };

package/dist/integrations/providers/impls/powens-client.js

@@ -1 +1,171 @@
-import{URL as e}from"node:url";const t={sandbox:`https://api-sandbox.powens.com/v2`,production:`https://api.powens.com/v2`};var n=class extends Error{status;code;requestId;response;constructor(e,t,n,r,i){super(e),this.name=`PowensClientError`,this.status=t,this.code=n,this.requestId=r,this.response=i}},r=class{clientId;clientSecret;apiKey;fetchImpl;logger;defaultTimeoutMs;token;baseUrl;constructor(e){this.clientId=e.clientId,this.clientSecret=e.clientSecret,this.apiKey=e.apiKey,this.fetchImpl=e.fetchImpl??fetch,this.logger=e.logger,this.defaultTimeoutMs=e.defaultTimeoutMs??15e3,this.baseUrl=e.baseUrl??t[e.environment]??t.production}async listAccounts(e){let t={cursor:e.cursor,limit:e.limit,include_balances:e.includeBalances,institution_uuid:e.institutionUuid};return await this.request({method:`GET`,path:`/users/${encodeURIComponent(e.userUuid)}/accounts`,searchParams:t})}async getAccount(e){return this.request({method:`GET`,path:`/accounts/${encodeURIComponent(e)}`})}async listTransactions(e){let t={cursor:e.cursor,limit:e.limit,from:e.from,to:e.to,include_pending:e.includePending};return this.request({method:`GET`,path:`/accounts/${encodeURIComponent(e.accountUuid)}/transactions`,searchParams:t})}async getBalances(e){return this.request({method:`GET`,path:`/accounts/${encodeURIComponent(e)}/balances`})}async getConnectionStatus(e){return this.request({method:`GET`,path:`/connections/${encodeURIComponent(e)}`})}async request(t){let r=new e(t.path,this.baseUrl);if(t.searchParams)for(let[e,n]of Object.entries(t.searchParams))n!=null&&r.searchParams.set(e,String(n));let i={Accept:`application/json`,"Content-Type":`application/json`,...t.headers};this.apiKey&&(i[`x-api-key`]=this.apiKey),t.skipAuth||(i.Authorization=`Bearer ${await this.ensureAccessToken()}`);let a=new AbortController,o=setTimeout(()=>a.abort(),t.timeoutMs??this.defaultTimeoutMs);try{let e=await this.fetchImpl(r,{method:t.method,headers:i,body:t.body?JSON.stringify(t.body):void 0,signal:a.signal}),o=e.headers.get(`x-request-id`)??void 0;if(!e.ok){let t;try{t=await e.json()}catch{}let r=typeof t==`object`&&t?t:void 0,i=typeof r?.message==`string`?r.message:`Powens API request failed with status ${e.status}`,a=typeof r?.code==`string`?r.code:void 0;throw new n(i,e.status,a,o,t)}if(e.status===204)return;try{return await e.json()}catch(t){throw this.logger?.error?.(`[PowensClient] Failed to parse JSON response`,t),new n(`Failed to parse Powens response payload as JSON`,e.status,void 0,o)}}catch(e){throw e instanceof n?e:e.name===`AbortError`?new n(`Powens API request timed out after ${t.timeoutMs??this.defaultTimeoutMs}ms`,408):(this.logger?.error?.(`[PowensClient] Request failed`,e),new n(e.message??`Powens API request failed`,500))}finally{clearTimeout(o)}}async ensureAccessToken(){return this.token&&Date.now()<this.token.expiresAt-5e3||(this.token=await this.fetchAccessToken()),this.token.accessToken}async fetchAccessToken(){let t=new e(`/oauth/token`,this.baseUrl),r=Buffer.from(`${this.clientId}:${this.clientSecret}`,`utf-8`).toString(`base64`),i=await this.fetchImpl(t,{method:`POST`,headers:{Authorization:`Basic ${r}`,"Content-Type":`application/x-www-form-urlencoded`,Accept:`application/json`},body:new URLSearchParams({grant_type:`client_credentials`}).toString()});if(!i.ok){let e;try{e=await i.json()}catch{}let t=typeof e==`object`&&e?e:void 0;throw new n(typeof t?.error_description==`string`?t.error_description:`Failed to obtain Powens access token`,i.status,void 0,void 0,e)}let a=await i.json(),o=Date.now()+a.expires_in*1e3;return this.logger?.debug?.(`[PowensClient] Received access token`,{expiresIn:a.expires_in}),{accessToken:a.access_token,expiresAt:o,scope:a.scope}}};export{r as PowensClient,n as PowensClientError};
+import { URL } from "node:url";
+
+//#region src/integrations/providers/impls/powens-client.ts
+const POWENS_BASE_URL = {
+	sandbox: "https://api-sandbox.powens.com/v2",
+	production: "https://api.powens.com/v2"
+};
+var PowensClientError = class extends Error {
+	status;
+	code;
+	requestId;
+	response;
+	constructor(message, status, code, requestId, response) {
+		super(message);
+		this.name = "PowensClientError";
+		this.status = status;
+		this.code = code;
+		this.requestId = requestId;
+		this.response = response;
+	}
+};
+var PowensClient = class {
+	clientId;
+	clientSecret;
+	apiKey;
+	fetchImpl;
+	logger;
+	defaultTimeoutMs;
+	token;
+	baseUrl;
+	constructor(options) {
+		this.clientId = options.clientId;
+		this.clientSecret = options.clientSecret;
+		this.apiKey = options.apiKey;
+		this.fetchImpl = options.fetchImpl ?? fetch;
+		this.logger = options.logger;
+		this.defaultTimeoutMs = options.defaultTimeoutMs ?? 15e3;
+		this.baseUrl = options.baseUrl ?? POWENS_BASE_URL[options.environment] ?? POWENS_BASE_URL.production;
+	}
+	async listAccounts(params) {
+		const searchParams = {
+			cursor: params.cursor,
+			limit: params.limit,
+			include_balances: params.includeBalances,
+			institution_uuid: params.institutionUuid
+		};
+		return await this.request({
+			method: "GET",
+			path: `/users/${encodeURIComponent(params.userUuid)}/accounts`,
+			searchParams
+		});
+	}
+	async getAccount(accountUuid) {
+		return this.request({
+			method: "GET",
+			path: `/accounts/${encodeURIComponent(accountUuid)}`
+		});
+	}
+	async listTransactions(params) {
+		const searchParams = {
+			cursor: params.cursor,
+			limit: params.limit,
+			from: params.from,
+			to: params.to,
+			include_pending: params.includePending
+		};
+		return this.request({
+			method: "GET",
+			path: `/accounts/${encodeURIComponent(params.accountUuid)}/transactions`,
+			searchParams
+		});
+	}
+	async getBalances(accountUuid) {
+		return this.request({
+			method: "GET",
+			path: `/accounts/${encodeURIComponent(accountUuid)}/balances`
+		});
+	}
+	async getConnectionStatus(connectionUuid) {
+		return this.request({
+			method: "GET",
+			path: `/connections/${encodeURIComponent(connectionUuid)}`
+		});
+	}
+	async request(options) {
+		const url = new URL(options.path, this.baseUrl);
+		if (options.searchParams) for (const [key, value] of Object.entries(options.searchParams)) {
+			if (value === void 0 || value === null) continue;
+			url.searchParams.set(key, String(value));
+		}
+		const headers = {
+			Accept: "application/json",
+			"Content-Type": "application/json",
+			...options.headers
+		};
+		if (this.apiKey) headers["x-api-key"] = this.apiKey;
+		if (!options.skipAuth) headers.Authorization = `Bearer ${await this.ensureAccessToken()}`;
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? this.defaultTimeoutMs);
+		try {
+			const response = await this.fetchImpl(url, {
+				method: options.method,
+				headers,
+				body: options.body ? JSON.stringify(options.body) : void 0,
+				signal: controller.signal
+			});
+			const requestId = response.headers.get("x-request-id") ?? void 0;
+			if (!response.ok) {
+				let errorBody;
+				try {
+					errorBody = await response.json();
+				} catch {}
+				const errorObject = typeof errorBody === "object" && errorBody !== null ? errorBody : void 0;
+				const message = typeof errorObject?.message === "string" ? errorObject.message : `Powens API request failed with status ${response.status}`;
+				const code = typeof errorObject?.code === "string" ? errorObject.code : void 0;
+				throw new PowensClientError(message, response.status, code, requestId, errorBody);
+			}
+			if (response.status === 204) return;
+			try {
+				return await response.json();
+			} catch (error) {
+				this.logger?.error?.("[PowensClient] Failed to parse JSON response", error);
+				throw new PowensClientError("Failed to parse Powens response payload as JSON", response.status, void 0, requestId);
+			}
+		} catch (error) {
+			if (error instanceof PowensClientError) throw error;
+			if (error.name === "AbortError") throw new PowensClientError(`Powens API request timed out after ${options.timeoutMs ?? this.defaultTimeoutMs}ms`, 408);
+			this.logger?.error?.("[PowensClient] Request failed", error);
+			throw new PowensClientError(error.message ?? "Powens API request failed", 500);
+		} finally {
+			clearTimeout(timeout);
+		}
+	}
+	async ensureAccessToken() {
+		if (this.token && Date.now() < this.token.expiresAt - 5e3) return this.token.accessToken;
+		this.token = await this.fetchAccessToken();
+		return this.token.accessToken;
+	}
+	async fetchAccessToken() {
+		const url = new URL("/oauth/token", this.baseUrl);
+		const basicAuth = Buffer.from(`${this.clientId}:${this.clientSecret}`, "utf-8").toString("base64");
+		const response = await this.fetchImpl(url, {
+			method: "POST",
+			headers: {
+				Authorization: `Basic ${basicAuth}`,
+				"Content-Type": "application/x-www-form-urlencoded",
+				Accept: "application/json"
+			},
+			body: new URLSearchParams({ grant_type: "client_credentials" }).toString()
+		});
+		if (!response.ok) {
+			let errorBody;
+			try {
+				errorBody = await response.json();
+			} catch {}
+			const errorObject = typeof errorBody === "object" && errorBody !== null ? errorBody : void 0;
+			throw new PowensClientError(typeof errorObject?.error_description === "string" ? errorObject.error_description : "Failed to obtain Powens access token", response.status, void 0, void 0, errorBody);
+		}
+		const payload = await response.json();
+		const expiresAt = Date.now() + payload.expires_in * 1e3;
+		this.logger?.debug?.("[PowensClient] Received access token", { expiresIn: payload.expires_in });
+		return {
+			accessToken: payload.access_token,
+			expiresAt,
+			scope: payload.scope
+		};
+	}
+};
+
+//#endregion
+export { PowensClient, PowensClientError };

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

@@ -0,0 +1,27 @@
+import { OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingConnectionStatus, OpenBankingGetAccountDetailsParams, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider } from "../openbanking.js";
+import { PowensClientOptions } from "./powens-client.js";
+
+//#region src/integrations/providers/impls/powens-openbanking.d.ts
+type PowensOpenBankingProviderOptions = PowensClientOptions;
+declare class PowensOpenBankingProvider implements OpenBankingProvider {
+  private readonly client;
+  private readonly logger?;
+  constructor(options: PowensOpenBankingProviderOptions);
+  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>;
+  private mapAccount;
+  private mapAccountDetails;
+  private mapTransaction;
+  private mapBalance;
+  private toContext;
+  private mapOwnership;
+  private mapAccountStatus;
+  private mapTransactionStatus;
+  private mapConnectionStatus;
+  private handleError;
+}
+//#endregion
+export { PowensOpenBankingProvider, PowensOpenBankingProviderOptions };