@contractspec/integration.providers-impls 1.44.0

package/dist/impls/mistral-llm.js

@@ -0,0 +1,248 @@
+import { Mistral } from "@mistralai/mistralai";
+
+//#region src/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 };
+//# sourceMappingURL=mistral-llm.js.map

package/dist/impls/mistral-llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mistral-llm.js","names":["aggregatedParts: LLMContentPart[]","aggregatedToolCalls: LLMToolCallPart[]","usage: LLMTokenUsage | undefined","finishReason: string | undefined","message: LLMMessage","request: components.ChatCompletionRequest","parts: LLMContentPart[]"],"sources":["../../src/impls/mistral-llm.ts"],"sourcesContent":["import { Mistral } from '@mistralai/mistralai';\nimport type * as components from '@mistralai/mistralai/models/components/index.js';\n\nimport type {\n  LLMChatOptions,\n  LLMContentPart,\n  LLMMessage,\n  LLMProvider,\n  LLMResponse,\n  LLMStreamChunk,\n  LLMToolCallPart,\n  LLMTokenUsage,\n} from '../llm';\n\nexport interface MistralLLMProviderOptions {\n  apiKey: string;\n  defaultModel?: string;\n  serverURL?: string;\n  client?: Mistral;\n  userAgentSuffix?: string;\n}\n\nexport class MistralLLMProvider implements LLMProvider {\n  private readonly client: Mistral;\n  private readonly defaultModel: string;\n\n  constructor(options: MistralLLMProviderOptions) {\n    if (!options.apiKey) {\n      throw new Error('MistralLLMProvider requires an apiKey');\n    }\n\n    this.client =\n      options.client ??\n      new Mistral({\n        apiKey: options.apiKey,\n        serverURL: options.serverURL,\n        userAgent: options.userAgentSuffix\n          ? `${options.userAgentSuffix}`\n          : undefined,\n      });\n    this.defaultModel = options.defaultModel ?? 'mistral-large-latest';\n  }\n\n  async chat(\n    messages: LLMMessage[],\n    options: LLMChatOptions = {}\n  ): Promise<LLMResponse> {\n    const request = this.buildChatRequest(messages, options);\n    const response = await this.client.chat.complete(request);\n    return this.buildLLMResponse(response);\n  }\n\n  async *stream(\n    messages: LLMMessage[],\n    options: LLMChatOptions = {}\n  ): AsyncIterable<LLMStreamChunk> {\n    const request = this.buildChatRequest(messages, options);\n    request.stream = true;\n    const stream = await this.client.chat.stream(request);\n\n    const aggregatedParts: LLMContentPart[] = [];\n    const aggregatedToolCalls: LLMToolCallPart[] = [];\n    let usage: LLMTokenUsage | undefined;\n    let finishReason: string | undefined;\n\n    for await (const event of stream) {\n      for (const choice of event.data.choices) {\n        const delta = choice.delta;\n        if (typeof delta.content === 'string') {\n          if (delta.content.length > 0) {\n            aggregatedParts.push({ type: 'text', text: delta.content });\n            yield {\n              type: 'message_delta',\n              delta: { type: 'text', text: delta.content },\n              index: choice.index,\n            };\n          }\n        } else if (Array.isArray(delta.content)) {\n          for (const chunk of delta.content) {\n            if (chunk.type === 'text' && 'text' in chunk) {\n              aggregatedParts.push({ type: 'text', text: chunk.text });\n              yield {\n                type: 'message_delta',\n                delta: { type: 'text', text: chunk.text },\n                index: choice.index,\n              };\n            }\n          }\n        }\n\n        if (delta.toolCalls) {\n          let localIndex = 0;\n          for (const call of delta.toolCalls) {\n            const toolCall = this.fromMistralToolCall(call, localIndex);\n            aggregatedToolCalls.push(toolCall);\n            yield {\n              type: 'tool_call',\n              call: toolCall,\n              index: choice.index,\n            };\n            localIndex += 1;\n          }\n        }\n\n        if (choice.finishReason && choice.finishReason !== 'null') {\n          finishReason = choice.finishReason;\n        }\n      }\n\n      if (event.data.usage) {\n        const usageEntry = this.fromUsage(event.data.usage);\n        if (usageEntry) {\n          usage = usageEntry;\n          yield { type: 'usage', usage: usageEntry };\n        }\n      }\n    }\n\n    const message: LLMMessage = {\n      role: 'assistant',\n      content: aggregatedParts.length\n        ? aggregatedParts\n        : [{ type: 'text', text: '' }],\n    };\n    if (aggregatedToolCalls.length > 0) {\n      message.content = [\n        ...aggregatedToolCalls,\n        ...(aggregatedParts.length ? aggregatedParts : []),\n      ];\n    }\n\n    yield {\n      type: 'end',\n      response: {\n        message,\n        usage,\n        finishReason: mapFinishReason(finishReason),\n      },\n    };\n  }\n\n  async countTokens(\n    _messages: LLMMessage[]\n  ): Promise<{ promptTokens: number }> {\n    throw new Error('Mistral API does not currently support token counting');\n  }\n\n  private buildChatRequest(\n    messages: LLMMessage[],\n    options: LLMChatOptions\n  ): components.ChatCompletionRequest {\n    const model = options.model ?? this.defaultModel;\n    const mappedMessages = messages.map((message) =>\n      this.toMistralMessage(message)\n    );\n\n    const request: components.ChatCompletionRequest = {\n      model,\n      messages: mappedMessages,\n    };\n\n    if (options.temperature != null) {\n      request.temperature = options.temperature;\n    }\n    if (options.topP != null) {\n      request.topP = options.topP;\n    }\n    if (options.maxOutputTokens != null) {\n      request.maxTokens = options.maxOutputTokens;\n    }\n    if (options.stopSequences?.length) {\n      request.stop =\n        options.stopSequences.length === 1\n          ? options.stopSequences[0]\n          : options.stopSequences;\n    }\n    if (options.tools?.length) {\n      request.tools = options.tools.map((tool) => ({\n        type: 'function',\n        function: {\n          name: tool.name,\n          description: tool.description,\n          parameters:\n            typeof tool.inputSchema === 'object' && tool.inputSchema !== null\n              ? tool.inputSchema\n              : {},\n        },\n      }));\n    }\n    if (options.responseFormat === 'json') {\n      request.responseFormat = { type: 'json_object' };\n    }\n\n    return request;\n  }\n\n  private buildLLMResponse(\n    response: components.ChatCompletionResponse\n  ): LLMResponse {\n    const firstChoice = response.choices[0];\n    if (!firstChoice) {\n      return {\n        message: {\n          role: 'assistant',\n          content: [{ type: 'text', text: '' }],\n        },\n        usage: this.fromUsage(response.usage),\n        raw: response,\n      };\n    }\n    const message = this.fromAssistantMessage(firstChoice.message);\n    return {\n      message,\n      usage: this.fromUsage(response.usage),\n      finishReason: mapFinishReason(firstChoice.finishReason),\n      raw: response,\n    };\n  }\n\n  private fromUsage(\n    usage: components.UsageInfo | undefined\n  ): LLMTokenUsage | undefined {\n    if (!usage) return undefined;\n    return {\n      promptTokens: usage.promptTokens ?? 0,\n      completionTokens: usage.completionTokens ?? 0,\n      totalTokens: usage.totalTokens ?? 0,\n    };\n  }\n\n  private fromAssistantMessage(\n    message: components.AssistantMessage\n  ): LLMMessage {\n    const parts: LLMContentPart[] = [];\n    if (typeof message.content === 'string') {\n      parts.push({ type: 'text', text: message.content });\n    } else if (Array.isArray(message.content)) {\n      message.content.forEach((chunk) => {\n        if (chunk.type === 'text' && 'text' in chunk) {\n          parts.push({ type: 'text', text: chunk.text });\n        }\n      });\n    }\n\n    const toolCalls =\n      message.toolCalls?.map((call, index) =>\n        this.fromMistralToolCall(call, index)\n      ) ?? [];\n\n    if (toolCalls.length > 0) {\n      parts.splice(0, 0, ...toolCalls);\n    }\n\n    if (parts.length === 0) {\n      parts.push({ type: 'text', text: '' });\n    }\n\n    return {\n      role: 'assistant',\n      content: parts,\n    };\n  }\n\n  private fromMistralToolCall(\n    call: components.ToolCall,\n    index: number\n  ): LLMToolCallPart {\n    const args =\n      typeof call.function.arguments === 'string'\n        ? call.function.arguments\n        : JSON.stringify(call.function.arguments);\n    return {\n      type: 'tool-call',\n      id: call.id ?? `tool-call-${index}`,\n      name: call.function.name,\n      arguments: args,\n    };\n  }\n\n  private toMistralMessage(message: LLMMessage): components.Messages {\n    const textContent = this.extractText(message.content);\n    const toolCalls = this.extractToolCalls(message);\n\n    switch (message.role) {\n      case 'system':\n        return {\n          role: 'system',\n          content: textContent ?? '',\n        };\n      case 'user':\n        return {\n          role: 'user',\n          content: textContent ?? '',\n        };\n      case 'assistant':\n        return {\n          role: 'assistant',\n          content: toolCalls.length > 0 ? null : (textContent ?? ''),\n          toolCalls: toolCalls.length > 0 ? toolCalls : undefined,\n        };\n      case 'tool':\n        return {\n          role: 'tool',\n          content: textContent ?? '',\n          toolCallId: message.toolCallId ?? toolCalls[0]?.id,\n        };\n      default:\n        return {\n          role: 'user',\n          content: textContent ?? '',\n        };\n    }\n  }\n\n  private extractText(parts: LLMContentPart[]): string | null {\n    const textParts = parts\n      .filter((part) => part.type === 'text')\n      .map((part) => (part as Extract<LLMContentPart, { type: 'text' }>).text);\n    if (textParts.length === 0) return null;\n    return textParts.join('');\n  }\n\n  private extractToolCalls(message: LLMMessage): components.ToolCall[] {\n    const toolCallParts = message.content.filter(\n      (part): part is LLMToolCallPart => part.type === 'tool-call'\n    );\n    return toolCallParts.map((call, index) => ({\n      id: call.id ?? `call_${index}`,\n      type: 'function',\n      index,\n      function: {\n        name: call.name,\n        arguments: call.arguments,\n      },\n    }));\n  }\n}\n\nfunction mapFinishReason(\n  reason?: string | null\n): LLMResponse['finishReason'] | undefined {\n  if (!reason) return undefined;\n  const normalized = reason.toLowerCase();\n  switch (normalized) {\n    case 'stop':\n      return 'stop';\n    case 'length':\n      return 'length';\n    case 'tool_call':\n    case 'tool_calls':\n      return 'tool_call';\n    case 'content_filter':\n      return 'content_filter';\n    default:\n      return undefined;\n  }\n}\n"],"mappings":"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"}

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

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

package/dist/impls/postmark-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmark-email.d.ts","names":[],"sources":["../../src/impls/postmark-email.ts"],"sourcesContent":[],"mappings":";;;;UAQiB,4BAAA;;EAAA,gBAAA,CAAA,EAAA,MAAA;EAOJ,aAAA,CAAA,EAAA,MAAA;EAKU,MAAA,CAAA,EARZ,YAQY;;AAUmC,cAf7C,qBAAA,YAAiC,eAAA,CAAA,qBAeY,CAAA;EAAR,iBAAA,MAAA;EAfJ,iBAAA,gBAAA;EAAqB,iBAAA,aAAA;uBAK5C;qBAUI,eAAA,CAAA,uBAAuB,QAAQ,eAAA,CAAA"}

package/dist/impls/postmark-email.js

@@ -0,0 +1,56 @@
+import { ServerClient } from "postmark";
+
+//#region src/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 };
+//# sourceMappingURL=postmark-email.js.map

package/dist/impls/postmark-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmark-email.js","names":["request: PostmarkModels.Message"],"sources":["../../src/impls/postmark-email.ts"],"sourcesContent":["import { ServerClient, type Models as PostmarkModels } from 'postmark';\n\nimport type {\n  EmailOutboundMessage,\n  EmailOutboundProvider,\n  EmailOutboundResult,\n} from '../email';\n\nexport interface PostmarkEmailProviderOptions {\n  serverToken: string;\n  defaultFromEmail?: string;\n  messageStream?: string;\n  client?: ServerClient;\n}\n\nexport class PostmarkEmailProvider implements EmailOutboundProvider {\n  private readonly client: ServerClient;\n  private readonly defaultFromEmail?: string;\n  private readonly messageStream?: string;\n\n  constructor(options: PostmarkEmailProviderOptions) {\n    this.client =\n      options.client ??\n      new ServerClient(options.serverToken, {\n        useHttps: true,\n      });\n    this.defaultFromEmail = options.defaultFromEmail;\n    this.messageStream = options.messageStream;\n  }\n\n  async sendEmail(message: EmailOutboundMessage): Promise<EmailOutboundResult> {\n    const request: PostmarkModels.Message = {\n      From: formatAddress(message.from) ?? this.defaultFromEmail,\n      To: message.to.map((addr) => formatAddress(addr)).join(', '),\n      Cc:\n        message.cc?.map((addr) => formatAddress(addr)).join(', ') || undefined,\n      Bcc:\n        message.bcc?.map((addr) => formatAddress(addr)).join(', ') || undefined,\n      ReplyTo: message.replyTo ? formatAddress(message.replyTo) : undefined,\n      Subject: message.subject,\n      TextBody: message.textBody,\n      HtmlBody: message.htmlBody,\n      Headers: message.headers\n        ? Object.entries(message.headers).map(([name, value]) => ({\n            Name: name,\n            Value: value,\n          }))\n        : undefined,\n      MessageStream: this.messageStream,\n      Attachments: buildAttachments(message),\n    };\n\n    const response = await this.client.sendEmail(request);\n    return {\n      id: response.MessageID,\n      providerMessageId: response.MessageID,\n      queuedAt: new Date(response.SubmittedAt ?? new Date().toISOString()),\n    };\n  }\n}\n\nfunction formatAddress(address: { email: string; name?: string }): string {\n  if (address.name) {\n    return `\"${address.name}\" <${address.email}>`;\n  }\n  return address.email;\n}\n\nfunction buildAttachments(\n  message: EmailOutboundMessage\n): PostmarkModels.Attachment[] | undefined {\n  if (!message.attachments?.length) return undefined;\n  return message.attachments\n    .filter((attachment) => attachment.data)\n    .map((attachment) => ({\n      Name: attachment.filename,\n      Content: Buffer.from(attachment.data ?? new Uint8Array()).toString(\n        'base64'\n      ),\n      ContentType: attachment.contentType,\n      ContentID: null,\n      ContentLength: attachment.sizeBytes,\n      Disposition: 'attachment',\n    }));\n}\n"],"mappings":";;;AAeA,IAAa,wBAAb,MAAoE;CAClE,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAuC;AACjD,OAAK,SACH,QAAQ,UACR,IAAI,aAAa,QAAQ,aAAa,EACpC,UAAU,MACX,CAAC;AACJ,OAAK,mBAAmB,QAAQ;AAChC,OAAK,gBAAgB,QAAQ;;CAG/B,MAAM,UAAU,SAA6D;EAC3E,MAAMA,UAAkC;GACtC,MAAM,cAAc,QAAQ,KAAK,IAAI,KAAK;GAC1C,IAAI,QAAQ,GAAG,KAAK,SAAS,cAAc,KAAK,CAAC,CAAC,KAAK,KAAK;GAC5D,IACE,QAAQ,IAAI,KAAK,SAAS,cAAc,KAAK,CAAC,CAAC,KAAK,KAAK,IAAI;GAC/D,KACE,QAAQ,KAAK,KAAK,SAAS,cAAc,KAAK,CAAC,CAAC,KAAK,KAAK,IAAI;GAChE,SAAS,QAAQ,UAAU,cAAc,QAAQ,QAAQ,GAAG;GAC5D,SAAS,QAAQ;GACjB,UAAU,QAAQ;GAClB,UAAU,QAAQ;GAClB,SAAS,QAAQ,UACb,OAAO,QAAQ,QAAQ,QAAQ,CAAC,KAAK,CAAC,MAAM,YAAY;IACtD,MAAM;IACN,OAAO;IACR,EAAE,GACH;GACJ,eAAe,KAAK;GACpB,aAAa,iBAAiB,QAAQ;GACvC;EAED,MAAM,WAAW,MAAM,KAAK,OAAO,UAAU,QAAQ;AACrD,SAAO;GACL,IAAI,SAAS;GACb,mBAAmB,SAAS;GAC5B,UAAU,IAAI,KAAK,SAAS,gCAAe,IAAI,MAAM,EAAC,aAAa,CAAC;GACrE;;;AAIL,SAAS,cAAc,SAAmD;AACxE,KAAI,QAAQ,KACV,QAAO,IAAI,QAAQ,KAAK,KAAK,QAAQ,MAAM;AAE7C,QAAO,QAAQ;;AAGjB,SAAS,iBACP,SACyC;AACzC,KAAI,CAAC,QAAQ,aAAa,OAAQ,QAAO;AACzC,QAAO,QAAQ,YACZ,QAAQ,eAAe,WAAW,KAAK,CACvC,KAAK,gBAAgB;EACpB,MAAM,WAAW;EACjB,SAAS,OAAO,KAAK,WAAW,QAAQ,IAAI,YAAY,CAAC,CAAC,SACxD,SACD;EACD,aAAa,WAAW;EACxB,WAAW;EACX,eAAe,WAAW;EAC1B,aAAa;EACd,EAAE"}

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

@@ -0,0 +1,125 @@
+//#region src/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 };
+//# sourceMappingURL=powens-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"powens-client.d.ts","names":[],"sources":["../../src/impls/powens-client.ts"],"sourcesContent":[],"mappings":";KAEY,iBAAA;AAAA,UAOK,mBAAA,CAPY;EAOZ,QAAA,EAAA,MAAA;EA4BA,YAAA,EAAA,MAAa;EAoBb,MAAA,CAAA,EAAA,MAAA;EAQA,WAAA,EApDF,iBAoDmB;EAmBjB,OAAA,CAAA,EAAA,MAAA;EAQA,SAAA,CAAA,EAAA,OA7EI,KA6ES;EASb,gBAAA,CAAA,EAAA,MAAA;EASJ,MAAA,CAAA,EAAA;IAgCA,KAAA,CAAA,EAAA,CAAA,GAAY,IAAA,EAAA,OAAA,EAAA,EAAA,GAAA,IAAA;IAUF,IAAA,CAAA,EAAA,CAAA,GAAA,IAAA,EAAA,OAAA,EAAA,EAAA,GAAA,IAAA;IAmBT,KAAA,CAAA,EAAA,CAAA,GAAA,IAAA,EAAA,OAAA,EAAA,EAAA,GAAA,IAAA;EAAR,CAAA;;AAgBmC,UAtJxB,aAAA,CAsJwB;EAc3B,IAAA,EAAA,MAAA;EAAR,SAAA,EAAA,MAAA;EAgB4C,QAAA,EAAA,MAAA;EAAR,WAAA,EAAA;IAS7B,EAAA,EAAA,MAAA;IAAR,IAAA,EAAA,MAAA;IAAO,OAAA,CAAA,EAAA,MAAA;;;;;;;;;;aA5KC;;UAGI,yBAAA;YACL;;;;;;UAOK,iBAAA;;;;;;;;;;;;;;;;aAgBJ;;UAGI,6BAAA;gBACD;;;;;;UAOC,aAAA;;;;;;aAMJ;;UAGI,8BAAA;;;;;;aAMJ;;cAGA,iBAAA,SAA0B,KAAA;;;;;;;cAgC1B,YAAA;;;;;;;;;uBAUU;;;;;;;MAmBjB,QAAQ;mCAgB2B,QAAQ;;;;;;;;MAc3C,QAAQ;oCAgB4B,QAAQ;+CAS7C,QAAQ"}

package/dist/impls/powens-client.js

@@ -0,0 +1,172 @@
+import { URL } from "node:url";
+
+//#region src/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 };
+//# sourceMappingURL=powens-client.js.map