digital-tools 2.0.1

package/dist/providers/email/resend.js

@@ -0,0 +1,259 @@
+/**
+ * Resend Email Provider
+ *
+ * Concrete implementation of EmailProvider using Resend API.
+ *
+ * @packageDocumentation
+ */
+import { defineProvider } from '../registry.js';
+const RESEND_API_URL = 'https://api.resend.com';
+/**
+ * Resend provider info
+ */
+export const resendInfo = {
+    id: 'email.resend',
+    name: 'Resend',
+    description: 'Modern email API for developers',
+    category: 'email',
+    website: 'https://resend.com',
+    docsUrl: 'https://resend.com/docs',
+    requiredConfig: ['apiKey'],
+    optionalConfig: ['defaultFrom'],
+};
+/**
+ * Create Resend email provider
+ */
+export function createResendProvider(config) {
+    let apiKey;
+    let defaultFrom;
+    return {
+        info: resendInfo,
+        async initialize(cfg) {
+            apiKey = cfg.apiKey;
+            defaultFrom = cfg.defaultFrom;
+            if (!apiKey) {
+                throw new Error('Resend API key is required');
+            }
+        },
+        async healthCheck() {
+            const start = Date.now();
+            try {
+                const response = await fetch(`${RESEND_API_URL}/domains`, {
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                    },
+                });
+                return {
+                    healthy: response.ok,
+                    latencyMs: Date.now() - start,
+                    message: response.ok ? 'Connected' : `HTTP ${response.status}`,
+                    checkedAt: new Date(),
+                };
+            }
+            catch (error) {
+                return {
+                    healthy: false,
+                    latencyMs: Date.now() - start,
+                    message: error instanceof Error ? error.message : 'Unknown error',
+                    checkedAt: new Date(),
+                };
+            }
+        },
+        async dispose() {
+            // No cleanup needed
+        },
+        async send(options) {
+            const from = options.from || defaultFrom;
+            if (!from) {
+                return {
+                    success: false,
+                    error: { code: 'MISSING_FROM', message: 'From address is required' },
+                };
+            }
+            const body = {
+                from,
+                to: options.to,
+                subject: options.subject,
+                ...(options.cc && { cc: options.cc }),
+                ...(options.bcc && { bcc: options.bcc }),
+                ...(options.replyTo && { reply_to: options.replyTo }),
+                ...(options.text && { text: options.text }),
+                ...(options.html && { html: options.html }),
+                ...(options.headers && { headers: options.headers }),
+                ...(options.tags && { tags: options.tags.map((name) => ({ name })) }),
+            };
+            if (options.attachments?.length) {
+                body.attachments = options.attachments.map((att) => ({
+                    filename: att.filename,
+                    content: typeof att.content === 'string' ? att.content : att.content.toString('base64'),
+                    content_type: att.contentType,
+                }));
+            }
+            if (options.sendAt) {
+                body.scheduled_at = options.sendAt.toISOString();
+            }
+            try {
+                const response = await fetch(`${RESEND_API_URL}/emails`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Authorization: `Bearer ${apiKey}`,
+                    },
+                    body: JSON.stringify(body),
+                });
+                const data = await response.json();
+                if (response.ok) {
+                    return {
+                        success: true,
+                        messageId: data.id,
+                    };
+                }
+                return {
+                    success: false,
+                    error: {
+                        code: data.name || `HTTP_${response.status}`,
+                        message: data.message || response.statusText,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: {
+                        code: 'NETWORK_ERROR',
+                        message: error instanceof Error ? error.message : 'Unknown error',
+                    },
+                };
+            }
+        },
+        async sendBatch(emails) {
+            // Resend has a batch endpoint
+            const from = defaultFrom;
+            const batch = emails.map((options) => ({
+                from: options.from || from,
+                to: options.to,
+                subject: options.subject,
+                ...(options.cc && { cc: options.cc }),
+                ...(options.bcc && { bcc: options.bcc }),
+                ...(options.replyTo && { reply_to: options.replyTo }),
+                ...(options.text && { text: options.text }),
+                ...(options.html && { html: options.html }),
+            }));
+            try {
+                const response = await fetch(`${RESEND_API_URL}/emails/batch`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Authorization: `Bearer ${apiKey}`,
+                    },
+                    body: JSON.stringify(batch),
+                });
+                const data = await response.json();
+                if (response.ok) {
+                    return data.data.map((item) => ({
+                        success: true,
+                        messageId: item.id,
+                    }));
+                }
+                // If batch fails, return error for all
+                return emails.map(() => ({
+                    success: false,
+                    error: {
+                        code: data.name || `HTTP_${response.status}`,
+                        message: data.message || response.statusText,
+                    },
+                }));
+            }
+            catch (error) {
+                return emails.map(() => ({
+                    success: false,
+                    error: {
+                        code: 'NETWORK_ERROR',
+                        message: error instanceof Error ? error.message : 'Unknown error',
+                    },
+                }));
+            }
+        },
+        async get(messageId) {
+            try {
+                const response = await fetch(`${RESEND_API_URL}/emails/${messageId}`, {
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                    },
+                });
+                if (!response.ok) {
+                    if (response.status === 404)
+                        return null;
+                    throw new Error(`HTTP ${response.status}`);
+                }
+                const data = (await response.json());
+                return {
+                    id: data.id,
+                    from: data.from,
+                    to: Array.isArray(data.to) ? data.to : [data.to],
+                    cc: data.cc,
+                    bcc: data.bcc,
+                    subject: data.subject,
+                    text: data.text,
+                    html: data.html,
+                    status: mapResendStatus(data.last_event),
+                    sentAt: data.created_at ? new Date(data.created_at) : undefined,
+                };
+            }
+            catch {
+                return null;
+            }
+        },
+        async verifyDomain(domain) {
+            const response = await fetch(`${RESEND_API_URL}/domains`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({ name: domain }),
+            });
+            const data = (await response.json());
+            return {
+                domain: data.name,
+                verified: data.status === 'verified',
+                dnsRecords: data.records?.map((r) => ({
+                    type: r.type,
+                    name: r.name,
+                    value: r.value,
+                    verified: r.status === 'verified',
+                })) || [],
+            };
+        },
+        async listDomains() {
+            const response = await fetch(`${RESEND_API_URL}/domains`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                },
+            });
+            const data = (await response.json());
+            return data.data?.map((d) => ({
+                domain: d.name,
+                verified: d.status === 'verified',
+                createdAt: new Date(d.created_at),
+            })) || [];
+        },
+    };
+}
+function mapResendStatus(event) {
+    switch (event) {
+        case 'delivered':
+            return 'delivered';
+        case 'bounced':
+            return 'bounced';
+        case 'complained':
+            return 'failed';
+        default:
+            return 'sent';
+    }
+}
+/**
+ * Resend provider definition
+ */
+export const resendProvider = defineProvider(resendInfo, async (config) => createResendProvider(config));
+//# sourceMappingURL=resend.js.map

package/dist/providers/email/resend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.js","sourceRoot":"","sources":["../../../src/providers/email/resend.ts"],"names":[],"mappings":"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"}

package/dist/providers/email/sendgrid.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SendGrid Email Provider
+ *
+ * Concrete implementation of EmailProvider using SendGrid API.
+ *
+ * @packageDocumentation
+ */
+import type { EmailProvider, ProviderConfig, ProviderInfo } from '../types.js';
+/**
+ * SendGrid provider info
+ */
+export declare const sendgridInfo: ProviderInfo;
+/**
+ * Create SendGrid email provider
+ */
+export declare function createSendGridProvider(config: ProviderConfig): EmailProvider;
+/**
+ * SendGrid provider definition
+ */
+export declare const sendgridProvider: {
+    info: ProviderInfo;
+    factory: import("../types.js").ProviderFactory<EmailProvider>;
+    register: () => void;
+};
+//# sourceMappingURL=sendgrid.d.ts.map

package/dist/providers/email/sendgrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendgrid.d.ts","sourceRoot":"","sources":["../../../src/providers/email/sendgrid.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAEd,YAAY,EAMb,MAAM,aAAa,CAAA;AAKpB;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAS1B,CAAA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAoJ5E;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;CAE5B,CAAA"}

package/dist/providers/email/sendgrid.js

@@ -0,0 +1,162 @@
+/**
+ * SendGrid Email Provider
+ *
+ * Concrete implementation of EmailProvider using SendGrid API.
+ *
+ * @packageDocumentation
+ */
+import { defineProvider } from '../registry.js';
+const SENDGRID_API_URL = 'https://api.sendgrid.com/v3';
+/**
+ * SendGrid provider info
+ */
+export const sendgridInfo = {
+    id: 'email.sendgrid',
+    name: 'SendGrid',
+    description: 'SendGrid email delivery service by Twilio',
+    category: 'email',
+    website: 'https://sendgrid.com',
+    docsUrl: 'https://docs.sendgrid.com',
+    requiredConfig: ['apiKey'],
+    optionalConfig: ['defaultFrom', 'sandboxMode'],
+};
+/**
+ * Create SendGrid email provider
+ */
+export function createSendGridProvider(config) {
+    let apiKey;
+    let defaultFrom;
+    return {
+        info: sendgridInfo,
+        async initialize(cfg) {
+            apiKey = cfg.apiKey;
+            defaultFrom = cfg.defaultFrom;
+            if (!apiKey) {
+                throw new Error('SendGrid API key is required');
+            }
+        },
+        async healthCheck() {
+            const start = Date.now();
+            try {
+                const response = await fetch(`${SENDGRID_API_URL}/scopes`, {
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                    },
+                });
+                return {
+                    healthy: response.ok,
+                    latencyMs: Date.now() - start,
+                    message: response.ok ? 'Connected' : `HTTP ${response.status}`,
+                    checkedAt: new Date(),
+                };
+            }
+            catch (error) {
+                return {
+                    healthy: false,
+                    latencyMs: Date.now() - start,
+                    message: error instanceof Error ? error.message : 'Unknown error',
+                    checkedAt: new Date(),
+                };
+            }
+        },
+        async dispose() {
+            // No cleanup needed
+        },
+        async send(options) {
+            const from = options.from || defaultFrom;
+            if (!from) {
+                return {
+                    success: false,
+                    error: { code: 'MISSING_FROM', message: 'From address is required' },
+                };
+            }
+            const personalizations = [
+                {
+                    to: options.to.map((email) => ({ email })),
+                    ...(options.cc && { cc: options.cc.map((email) => ({ email })) }),
+                    ...(options.bcc && { bcc: options.bcc.map((email) => ({ email })) }),
+                },
+            ];
+            const body = {
+                personalizations,
+                from: { email: from },
+                subject: options.subject,
+                content: [
+                    ...(options.text ? [{ type: 'text/plain', value: options.text }] : []),
+                    ...(options.html ? [{ type: 'text/html', value: options.html }] : []),
+                ],
+            };
+            if (options.replyTo) {
+                body.reply_to = { email: options.replyTo };
+            }
+            if (options.attachments?.length) {
+                body.attachments = options.attachments.map((att) => ({
+                    content: typeof att.content === 'string' ? att.content : att.content.toString('base64'),
+                    filename: att.filename,
+                    type: att.contentType,
+                    content_id: att.contentId,
+                    disposition: att.contentId ? 'inline' : 'attachment',
+                }));
+            }
+            if (options.sendAt) {
+                body.send_at = Math.floor(options.sendAt.getTime() / 1000);
+            }
+            if (options.trackOpens !== undefined || options.trackClicks !== undefined) {
+                body.tracking_settings = {
+                    ...(options.trackOpens !== undefined && {
+                        open_tracking: { enable: options.trackOpens },
+                    }),
+                    ...(options.trackClicks !== undefined && {
+                        click_tracking: { enable: options.trackClicks },
+                    }),
+                };
+            }
+            if (options.tags?.length) {
+                body.categories = options.tags;
+            }
+            if (options.metadata) {
+                body.custom_args = options.metadata;
+            }
+            try {
+                const response = await fetch(`${SENDGRID_API_URL}/mail/send`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Authorization: `Bearer ${apiKey}`,
+                    },
+                    body: JSON.stringify(body),
+                });
+                if (response.ok || response.status === 202) {
+                    const messageId = response.headers.get('X-Message-Id') || undefined;
+                    return { success: true, messageId };
+                }
+                const errorData = await response.json().catch(() => ({}));
+                return {
+                    success: false,
+                    error: {
+                        code: `HTTP_${response.status}`,
+                        message: errorData?.errors?.[0]?.message || response.statusText,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: {
+                        code: 'NETWORK_ERROR',
+                        message: error instanceof Error ? error.message : 'Unknown error',
+                    },
+                };
+            }
+        },
+        async sendBatch(emails) {
+            // SendGrid doesn't have a true batch endpoint, so we send in parallel
+            return Promise.all(emails.map((email) => this.send(email)));
+        },
+    };
+}
+/**
+ * SendGrid provider definition
+ */
+export const sendgridProvider = defineProvider(sendgridInfo, async (config) => createSendGridProvider(config));
+//# sourceMappingURL=sendgrid.js.map

package/dist/providers/email/sendgrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendgrid.js","sourceRoot":"","sources":["../../../src/providers/email/sendgrid.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+/**
+ * Finance Providers
+ *
+ * @packageDocumentation
+ */
+export { stripeInfo, stripeProvider, createStripeProvider } from './stripe.js';
+/**
+ * Register all finance providers
+ */
+export declare function registerFinanceProviders(): void;
+/**
+ * All finance providers
+ */
+export declare const financeProviders: {
+    info: import("../types.js").ProviderInfo;
+    factory: import("../types.js").ProviderFactory<import("../types.js").FinanceProvider>;
+    register: () => void;
+}[];
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/finance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/finance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAI9E;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;GAAmB,CAAA"}

package/dist/providers/finance/index.js

@@ -0,0 +1,18 @@
+/**
+ * Finance Providers
+ *
+ * @packageDocumentation
+ */
+export { stripeInfo, stripeProvider, createStripeProvider } from './stripe.js';
+import { stripeProvider } from './stripe.js';
+/**
+ * Register all finance providers
+ */
+export function registerFinanceProviders() {
+    stripeProvider.register();
+}
+/**
+ * All finance providers
+ */
+export const financeProviders = [stripeProvider];
+//# sourceMappingURL=index.js.map

package/dist/providers/finance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/finance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,cAAc,CAAC,QAAQ,EAAE,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,cAAc,CAAC,CAAA"}

package/dist/providers/finance/stripe.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stripe Finance Provider
+ *
+ * Concrete implementation of FinanceProvider using Stripe API.
+ *
+ * @packageDocumentation
+ */
+import type { FinanceProvider, ProviderConfig, ProviderInfo } from '../types.js';
+/**
+ * Stripe provider info
+ */
+export declare const stripeInfo: ProviderInfo;
+/**
+ * Create Stripe finance provider
+ */
+export declare function createStripeProvider(config: ProviderConfig): FinanceProvider;
+/**
+ * Stripe provider definition
+ */
+export declare const stripeProvider: {
+    info: ProviderInfo;
+    factory: import("../types.js").ProviderFactory<FinanceProvider>;
+    register: () => void;
+};
+//# sourceMappingURL=stripe.d.ts.map

package/dist/providers/finance/stripe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../../src/providers/finance/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEd,YAAY,EAYb,MAAM,aAAa,CAAA;AAKpB;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,YASxB,CAAA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CA2jB5E;AA0CD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAE1B,CAAA"}