@christian-ek/sweego 0.1.0

package/dist/component/shared.d.ts

@@ -0,0 +1,280 @@
+import { type GenericActionCtx, type GenericDataModel, type GenericMutationCtx, type GenericQueryCtx } from "convex/server";
+import { type Infer } from "convex/values";
+export declare const SWEEGO_API_BASE_URL = "https://api.sweego.io";
+export declare const DEFAULT_PROVIDER = "sweego";
+export declare const vChannel: import("convex/values").VUnion<"email" | "sms", [import("convex/values").VLiteral<"email", "required">, import("convex/values").VLiteral<"sms", "required">], "required", never>;
+export type Channel = Infer<typeof vChannel>;
+export declare const vEmailAddress: import("convex/values").VObject<{
+    name?: string | undefined;
+    email: string;
+}, {
+    email: import("convex/values").VString<string, "required">;
+    name: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "email" | "name">;
+export type EmailAddress = Infer<typeof vEmailAddress>;
+export declare const vVariables: import("convex/values").VRecord<Record<string, string | number | boolean>, import("convex/values").VString<string, "required">, import("convex/values").VUnion<string | number | boolean, [import("convex/values").VString<string, "required">, import("convex/values").VFloat64<number, "required">, import("convex/values").VBoolean<boolean, "required">], "required", never>, "required", string>;
+export type Variables = Infer<typeof vVariables>;
+export declare const vEmailRecipient: import("convex/values").VObject<{
+    name?: string | undefined;
+    variables?: Record<string, string | number | boolean> | undefined;
+    email: string;
+}, {
+    email: import("convex/values").VString<string, "required">;
+    name: import("convex/values").VString<string | undefined, "optional">;
+    variables: import("convex/values").VRecord<Record<string, string | number | boolean> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VUnion<string | number | boolean, [import("convex/values").VString<string, "required">, import("convex/values").VFloat64<number, "required">, import("convex/values").VBoolean<boolean, "required">], "required", never>, "optional", string>;
+}, "required", "email" | "name" | "variables" | `variables.${string}`>;
+export type EmailRecipient = Infer<typeof vEmailRecipient>;
+export declare const vSmsRecipient: import("convex/values").VObject<{
+    num: string;
+    region: string;
+}, {
+    num: import("convex/values").VString<string, "required">;
+    region: import("convex/values").VString<string, "required">;
+}, "required", "num" | "region">;
+export type SmsRecipient = Infer<typeof vSmsRecipient>;
+export declare const vAttachment: import("convex/values").VObject<{
+    contentId?: string | undefined;
+    disposition?: "attachment" | "inline" | undefined;
+    isRelated?: boolean | undefined;
+    content: string;
+    filename: string;
+}, {
+    content: import("convex/values").VString<string, "required">;
+    filename: import("convex/values").VString<string, "required">;
+    contentId: import("convex/values").VString<string | undefined, "optional">;
+    disposition: import("convex/values").VUnion<"attachment" | "inline" | undefined, [import("convex/values").VLiteral<"attachment", "required">, import("convex/values").VLiteral<"inline", "required">], "optional", never>;
+    isRelated: import("convex/values").VBoolean<boolean | undefined, "optional">;
+}, "required", "content" | "filename" | "contentId" | "disposition" | "isRelated">;
+export type Attachment = Infer<typeof vAttachment>;
+export declare const vListUnsub: import("convex/values").VObject<{
+    method?: "mailto" | "one-click" | undefined;
+    value: string;
+}, {
+    method: import("convex/values").VUnion<"mailto" | "one-click" | undefined, [import("convex/values").VLiteral<"mailto", "required">, import("convex/values").VLiteral<"one-click", "required">], "optional", never>;
+    value: import("convex/values").VString<string, "required">;
+}, "required", "method" | "value">;
+export type ListUnsub = Infer<typeof vListUnsub>;
+export declare const vEmailCampaignType: import("convex/values").VUnion<"market" | "newsletter" | "transac", [import("convex/values").VLiteral<"market", "required">, import("convex/values").VLiteral<"newsletter", "required">, import("convex/values").VLiteral<"transac", "required">], "required", never>;
+export declare const vSmsCampaignType: import("convex/values").VUnion<"market" | "transac", [import("convex/values").VLiteral<"market", "required">, import("convex/values").VLiteral<"transac", "required">], "required", never>;
+export type SmsCampaignType = Infer<typeof vSmsCampaignType>;
+export declare const vSendStatus: import("convex/values").VUnion<"sent" | "queued" | "failed" | "cancelled", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"sent", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"cancelled", "required">], "required", never>;
+export type SendStatus = Infer<typeof vSendStatus>;
+export declare const vDeliveryStatus: import("convex/values").VUnion<"pending" | "sent" | "delivered" | "soft_bounced" | "bounced" | "undelivered" | "stopped", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"sent", "required">, import("convex/values").VLiteral<"delivered", "required">, import("convex/values").VLiteral<"soft_bounced", "required">, import("convex/values").VLiteral<"bounced", "required">, import("convex/values").VLiteral<"undelivered", "required">, import("convex/values").VLiteral<"stopped", "required">], "required", never>;
+export type DeliveryStatus = Infer<typeof vDeliveryStatus>;
+export declare const KNOWN_EMAIL_EVENT_TYPES: readonly ["email_sent", "delivered", "soft-bounce", "hard_bounce", "list_unsub", "complaint", "email_opened", "email_clicked", "email_inbound"];
+export declare const KNOWN_SMS_EVENT_TYPES: readonly ["sms_sent", "sms_undelivered", "sms_stop", "sms_clicked"];
+export declare const vSweegoEvent: import("convex/values").VObject<{
+    channel?: "email" | "sms" | undefined;
+    eventId?: string | undefined;
+    transactionId?: string | undefined;
+    timestamp?: string | undefined;
+    eventType: string;
+    swgUid: string;
+    raw: any;
+}, {
+    eventType: import("convex/values").VString<string, "required">;
+    channel: import("convex/values").VUnion<"email" | "sms" | undefined, [import("convex/values").VLiteral<"email", "required">, import("convex/values").VLiteral<"sms", "required">], "optional", never>;
+    swgUid: import("convex/values").VString<string, "required">;
+    eventId: import("convex/values").VString<string | undefined, "optional">;
+    transactionId: import("convex/values").VString<string | undefined, "optional">;
+    timestamp: import("convex/values").VString<string | undefined, "optional">;
+    raw: import("convex/values").VAny<any, "required", string>;
+}, "required", "eventType" | "channel" | "swgUid" | "eventId" | "transactionId" | "timestamp" | "raw" | `raw.${string}`>;
+export type SweegoEvent = Infer<typeof vSweegoEvent>;
+export type EventKind = "sent" | "delivered" | "soft_bounce" | "hard_bounce" | "complaint" | "unsub" | "open" | "click" | "sms_sent" | "sms_undelivered" | "sms_stop" | "sms_click" | "inbound" | "unknown";
+export declare function normalizeEventType(raw: string): string;
+export declare function classifyEvent(raw: string): EventKind;
+export declare const onEvent: import("convex/values").VObject<{
+    fnHandle: string;
+}, {
+    fnHandle: import("convex/values").VString<string, "required">;
+}, "required", "fnHandle">;
+export declare const vOptions: import("convex/values").VObject<{
+    onEvent?: {
+        fnHandle: string;
+    } | undefined;
+    apiKey: string;
+    provider: string;
+    initialBackoffMs: number;
+    retryAttempts: number;
+    testMode: boolean;
+}, {
+    apiKey: import("convex/values").VString<string, "required">;
+    provider: import("convex/values").VString<string, "required">;
+    initialBackoffMs: import("convex/values").VFloat64<number, "required">;
+    retryAttempts: import("convex/values").VFloat64<number, "required">;
+    testMode: import("convex/values").VBoolean<boolean, "required">;
+    onEvent: import("convex/values").VObject<{
+        fnHandle: string;
+    } | undefined, {
+        fnHandle: import("convex/values").VString<string, "required">;
+    }, "optional", "fnHandle">;
+}, "required", "apiKey" | "provider" | "initialBackoffMs" | "retryAttempts" | "testMode" | "onEvent" | "onEvent.fnHandle">;
+export type RuntimeConfig = Infer<typeof vOptions>;
+export declare const vMessageInput: import("convex/values").VObject<{
+    variables?: Record<string, string | number | boolean> | undefined;
+    emailRecipients?: {
+        name?: string | undefined;
+        variables?: Record<string, string | number | boolean> | undefined;
+        email: string;
+    }[] | undefined;
+    smsRecipients?: {
+        num: string;
+        region: string;
+    }[] | undefined;
+    from?: {
+        name?: string | undefined;
+        email: string;
+    } | undefined;
+    subject?: string | undefined;
+    cc?: {
+        name?: string | undefined;
+        email: string;
+    }[] | undefined;
+    bcc?: {
+        name?: string | undefined;
+        email: string;
+    }[] | undefined;
+    replyTo?: {
+        name?: string | undefined;
+        email: string;
+    } | undefined;
+    html?: string | undefined;
+    text?: string | undefined;
+    templateId?: string | undefined;
+    attachments?: {
+        contentId?: string | undefined;
+        disposition?: "attachment" | "inline" | undefined;
+        isRelated?: boolean | undefined;
+        content: string;
+        filename: string;
+    }[] | undefined;
+    headers?: Record<string, string> | undefined;
+    listUnsub?: {
+        method?: "mailto" | "one-click" | undefined;
+        value: string;
+    } | undefined;
+    expires?: string | undefined;
+    campaignId?: string | undefined;
+    campaignTags?: string[] | undefined;
+    campaignType?: string | undefined;
+    compressStyle?: boolean | undefined;
+    forceInlineStyle?: boolean | undefined;
+    dryRun?: boolean | undefined;
+    senderId?: string | undefined;
+    shortenUrls?: boolean | undefined;
+    shortenWithProtocol?: boolean | undefined;
+    bat?: boolean | undefined;
+    channel: "email" | "sms";
+    bulk: boolean;
+}, {
+    channel: import("convex/values").VUnion<"email" | "sms", [import("convex/values").VLiteral<"email", "required">, import("convex/values").VLiteral<"sms", "required">], "required", never>;
+    bulk: import("convex/values").VBoolean<boolean, "required">;
+    emailRecipients: import("convex/values").VArray<{
+        name?: string | undefined;
+        variables?: Record<string, string | number | boolean> | undefined;
+        email: string;
+    }[] | undefined, import("convex/values").VObject<{
+        name?: string | undefined;
+        variables?: Record<string, string | number | boolean> | undefined;
+        email: string;
+    }, {
+        email: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string | undefined, "optional">;
+        variables: import("convex/values").VRecord<Record<string, string | number | boolean> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VUnion<string | number | boolean, [import("convex/values").VString<string, "required">, import("convex/values").VFloat64<number, "required">, import("convex/values").VBoolean<boolean, "required">], "required", never>, "optional", string>;
+    }, "required", "email" | "name" | "variables" | `variables.${string}`>, "optional">;
+    smsRecipients: import("convex/values").VArray<{
+        num: string;
+        region: string;
+    }[] | undefined, import("convex/values").VObject<{
+        num: string;
+        region: string;
+    }, {
+        num: import("convex/values").VString<string, "required">;
+        region: import("convex/values").VString<string, "required">;
+    }, "required", "num" | "region">, "optional">;
+    from: import("convex/values").VObject<{
+        name?: string | undefined;
+        email: string;
+    } | undefined, {
+        email: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string | undefined, "optional">;
+    }, "optional", "email" | "name">;
+    subject: import("convex/values").VString<string | undefined, "optional">;
+    cc: import("convex/values").VArray<{
+        name?: string | undefined;
+        email: string;
+    }[] | undefined, import("convex/values").VObject<{
+        name?: string | undefined;
+        email: string;
+    }, {
+        email: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "email" | "name">, "optional">;
+    bcc: import("convex/values").VArray<{
+        name?: string | undefined;
+        email: string;
+    }[] | undefined, import("convex/values").VObject<{
+        name?: string | undefined;
+        email: string;
+    }, {
+        email: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "email" | "name">, "optional">;
+    replyTo: import("convex/values").VObject<{
+        name?: string | undefined;
+        email: string;
+    } | undefined, {
+        email: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string | undefined, "optional">;
+    }, "optional", "email" | "name">;
+    html: import("convex/values").VString<string | undefined, "optional">;
+    text: import("convex/values").VString<string | undefined, "optional">;
+    templateId: import("convex/values").VString<string | undefined, "optional">;
+    variables: import("convex/values").VRecord<Record<string, string | number | boolean> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VUnion<string | number | boolean, [import("convex/values").VString<string, "required">, import("convex/values").VFloat64<number, "required">, import("convex/values").VBoolean<boolean, "required">], "required", never>, "optional", string>;
+    attachments: import("convex/values").VArray<{
+        contentId?: string | undefined;
+        disposition?: "attachment" | "inline" | undefined;
+        isRelated?: boolean | undefined;
+        content: string;
+        filename: string;
+    }[] | undefined, import("convex/values").VObject<{
+        contentId?: string | undefined;
+        disposition?: "attachment" | "inline" | undefined;
+        isRelated?: boolean | undefined;
+        content: string;
+        filename: string;
+    }, {
+        content: import("convex/values").VString<string, "required">;
+        filename: import("convex/values").VString<string, "required">;
+        contentId: import("convex/values").VString<string | undefined, "optional">;
+        disposition: import("convex/values").VUnion<"attachment" | "inline" | undefined, [import("convex/values").VLiteral<"attachment", "required">, import("convex/values").VLiteral<"inline", "required">], "optional", never>;
+        isRelated: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    }, "required", "content" | "filename" | "contentId" | "disposition" | "isRelated">, "optional">;
+    headers: import("convex/values").VRecord<Record<string, string> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "optional", string>;
+    listUnsub: import("convex/values").VObject<{
+        method?: "mailto" | "one-click" | undefined;
+        value: string;
+    } | undefined, {
+        method: import("convex/values").VUnion<"mailto" | "one-click" | undefined, [import("convex/values").VLiteral<"mailto", "required">, import("convex/values").VLiteral<"one-click", "required">], "optional", never>;
+        value: import("convex/values").VString<string, "required">;
+    }, "optional", "method" | "value">;
+    expires: import("convex/values").VString<string | undefined, "optional">;
+    campaignId: import("convex/values").VString<string | undefined, "optional">;
+    campaignTags: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    campaignType: import("convex/values").VString<string | undefined, "optional">;
+    compressStyle: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    forceInlineStyle: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    dryRun: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    senderId: import("convex/values").VString<string | undefined, "optional">;
+    shortenUrls: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    shortenWithProtocol: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    bat: import("convex/values").VBoolean<boolean | undefined, "optional">;
+}, "required", "variables" | `variables.${string}` | "channel" | "bulk" | "emailRecipients" | "smsRecipients" | "from" | "subject" | "cc" | "bcc" | "replyTo" | "html" | "text" | "templateId" | "attachments" | "headers" | "listUnsub" | "expires" | "campaignId" | "campaignTags" | "campaignType" | "compressStyle" | "forceInlineStyle" | "dryRun" | "senderId" | "shortenUrls" | "shortenWithProtocol" | "bat" | "from.email" | "from.name" | "replyTo.email" | "replyTo.name" | `headers.${string}` | "listUnsub.method" | "listUnsub.value">;
+export type MessageInput = Infer<typeof vMessageInput>;
+export declare function parseEmailAddress(input: string | EmailAddress): EmailAddress;
+export declare function parseEmailAddresses(input: string | EmailAddress | Array<string | EmailAddress>): EmailAddress[];
+export type QueryCtx = Pick<GenericQueryCtx<GenericDataModel>, "runQuery">;
+export type MutationCtx = Pick<GenericMutationCtx<GenericDataModel>, "runQuery" | "runMutation">;
+export type ActionCtx = Pick<GenericActionCtx<GenericDataModel>, "runQuery" | "runMutation" | "runAction">;
+//# sourceMappingURL=shared.d.ts.map

package/dist/component/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/component/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,KAAK,EAAK,MAAM,eAAe,CAAC;AAG9C,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAG3D,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAMzC,eAAO,MAAM,QAAQ,kLAAgD,CAAC;AACtE,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAO7C,eAAO,MAAM,aAAa;;;;;;gCAGxB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIvD,eAAO,MAAM,UAAU,uYAGtB,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAIjD,eAAO,MAAM,eAAe;;;;;;;;sEAI1B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAG3D,eAAO,MAAM,aAAa;;;;;;gCAGxB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AASvD,eAAO,MAAM,WAAW;;;;;;;;;;;;kFAQtB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAInD,eAAO,MAAM,UAAU;;;;;;kCAGrB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAGjD,eAAO,MAAM,kBAAkB,uQAI9B,CAAC;AAGF,eAAO,MAAM,gBAAgB,4LAG5B,CAAC;AACF,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAO7D,eAAO,MAAM,WAAW,kUAKvB,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAGnD,eAAO,MAAM,eAAe,uiBAQ3B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAS3D,eAAO,MAAM,uBAAuB,iJAU1B,CAAC;AAEX,eAAO,MAAM,qBAAqB,qEAKxB,CAAC;AAIX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;wHAQvB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIrD,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,WAAW,GACX,aAAa,GACb,aAAa,GACb,WAAW,GACX,OAAO,GACP,MAAM,GACN,OAAO,GACP,UAAU,GACV,iBAAiB,GACjB,UAAU,GACV,WAAW,GACX,SAAS,GACT,SAAS,CAAC;AAEd,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAiCpD;AAOD,eAAO,MAAM,OAAO;;;;0BAAqC,CAAC;AAK1D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;0HAQnB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AASnD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ohBA4BxB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAQvD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,YAAY,GAC3B,YAAY,CASd;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,GAC1D,YAAY,EAAE,CAGhB;AAMD,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B,kBAAkB,CAAC,gBAAgB,CAAC,EACpC,UAAU,GAAG,aAAa,CAC3B,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,IAAI,CAC1B,gBAAgB,CAAC,gBAAgB,CAAC,EAClC,UAAU,GAAG,aAAa,GAAG,WAAW,CACzC,CAAC"}

package/dist/component/shared.js

@@ -0,0 +1,213 @@
+import { v } from "convex/values";
+// The Sweego API base URL. All requests go here.
+export const SWEEGO_API_BASE_URL = "https://api.sweego.io";
+// The default provider Sweego expects on every send request.
+export const DEFAULT_PROVIDER = "sweego";
+/* -------------------------------------------------------------------------- */
+/*  Channels                                                                  */
+/* -------------------------------------------------------------------------- */
+export const vChannel = v.union(v.literal("email"), v.literal("sms"));
+/* -------------------------------------------------------------------------- */
+/*  Addresses / recipients                                                    */
+/* -------------------------------------------------------------------------- */
+// An email address with an optional display name, e.g. { email, name }.
+export const vEmailAddress = v.object({
+    email: v.string(),
+    name: v.optional(v.string()),
+});
+// Variables passed to a Sweego template. Values are interpolated into
+// `{{ placeholder }}` tokens; Sweego accepts string/number/boolean values.
+export const vVariables = v.record(v.string(), v.union(v.string(), v.number(), v.boolean()));
+// An email recipient. `variables` is only honored on the bulk endpoint
+// (`/send/bulk/email`), where each recipient may be personalized.
+export const vEmailRecipient = v.object({
+    email: v.string(),
+    name: v.optional(v.string()),
+    variables: v.optional(vVariables),
+});
+// An SMS recipient: a phone number plus its ISO-3166 alpha-2 region (e.g. "FR").
+export const vSmsRecipient = v.object({
+    num: v.string(),
+    region: v.string(),
+});
+/* -------------------------------------------------------------------------- */
+/*  Email extras                                                              */
+/* -------------------------------------------------------------------------- */
+// A file attachment. `content` MUST be base64-encoded bytes. The total
+// message (incl. attachments) must fit within a single Convex document
+// (~1 MiB); use small attachments or host large files elsewhere.
+export const vAttachment = v.object({
+    content: v.string(),
+    filename: v.string(),
+    contentId: v.optional(v.string()),
+    disposition: v.optional(v.union(v.literal("attachment"), v.literal("inline"))),
+    isRelated: v.optional(v.boolean()),
+});
+// The List-Unsubscribe header. For "mailto", `value` is an email; for
+// "one-click", `value` is "<mailto:EMAIL>,<URL>".
+export const vListUnsub = v.object({
+    method: v.optional(v.union(v.literal("mailto"), v.literal("one-click"))),
+    value: v.string(),
+});
+// Email campaign type. Optional for email.
+export const vEmailCampaignType = v.union(v.literal("market"), v.literal("newsletter"), v.literal("transac"));
+// SMS campaign type. REQUIRED by Sweego for every SMS send.
+export const vSmsCampaignType = v.union(v.literal("market"), v.literal("transac"));
+/* -------------------------------------------------------------------------- */
+/*  Statuses                                                                  */
+/* -------------------------------------------------------------------------- */
+// Lifecycle of a logical send (one `messages` row).
+export const vSendStatus = v.union(v.literal("queued"), // enqueued, not yet handed to Sweego
+v.literal("sent"), // accepted by Sweego (swg_uids issued)
+v.literal("failed"), // permanent failure / retries exhausted
+v.literal("cancelled"));
+// Per-recipient delivery outcome (one `deliveries` row per swg_uid).
+export const vDeliveryStatus = v.union(v.literal("pending"), // accepted, awaiting delivery events
+v.literal("sent"), v.literal("delivered"), v.literal("soft_bounced"), // transient bounce, may still deliver
+v.literal("bounced"), // hard bounce (terminal)
+v.literal("undelivered"), // SMS not delivered (terminal)
+v.literal("stopped"));
+/* -------------------------------------------------------------------------- */
+/*  Webhook events                                                            */
+/* -------------------------------------------------------------------------- */
+// Known Sweego email webhook event_type strings. Casing is inconsistent in
+// Sweego's docs (e.g. "soft-bounce" vs "hard_bounce"), so we match defensively
+// via `classifyEvent` rather than relying on these literally.
+export const KNOWN_EMAIL_EVENT_TYPES = [
+    "email_sent",
+    "delivered",
+    "soft-bounce",
+    "hard_bounce",
+    "list_unsub",
+    "complaint",
+    "email_opened",
+    "email_clicked",
+    "email_inbound",
+];
+export const KNOWN_SMS_EVENT_TYPES = [
+    "sms_sent",
+    "sms_undelivered",
+    "sms_stop",
+    "sms_clicked",
+];
+// A normalized webhook event handed to your `onEvent` handler. The raw,
+// unmodified payload is always available on `raw`.
+export const vSweegoEvent = v.object({
+    eventType: v.string(),
+    channel: v.optional(vChannel),
+    swgUid: v.string(),
+    eventId: v.optional(v.string()),
+    transactionId: v.optional(v.string()),
+    timestamp: v.optional(v.string()),
+    raw: v.any(),
+});
+export function normalizeEventType(raw) {
+    return raw.trim().toLowerCase().replace(/-/g, "_");
+}
+export function classifyEvent(raw) {
+    switch (normalizeEventType(raw)) {
+        case "email_sent":
+            return "sent";
+        case "delivered":
+            return "delivered";
+        case "soft_bounce":
+            return "soft_bounce";
+        case "hard_bounce":
+        case "bounce":
+            return "hard_bounce";
+        case "complaint":
+            return "complaint";
+        case "list_unsub":
+            return "unsub";
+        case "email_opened":
+            return "open";
+        case "email_clicked":
+            return "click";
+        case "email_inbound":
+            return "inbound";
+        case "sms_sent":
+            return "sms_sent";
+        case "sms_undelivered":
+            return "sms_undelivered";
+        case "sms_stop":
+        case "stop":
+            return "sms_stop";
+        case "sms_clicked":
+            return "sms_click";
+        default:
+            return "unknown";
+    }
+}
+/* -------------------------------------------------------------------------- */
+/*  Runtime configuration                                                     */
+/* -------------------------------------------------------------------------- */
+// A reference to a mutation in the host app that runs after each event.
+export const onEvent = v.object({ fnHandle: v.string() });
+// Runtime configuration threaded from the client into the component on each
+// send. Note: components cannot read the host app's environment variables, so
+// the API key is passed in explicitly here.
+export const vOptions = v.object({
+    apiKey: v.string(),
+    provider: v.string(),
+    initialBackoffMs: v.number(),
+    retryAttempts: v.number(),
+    // When true, email sends use Sweego's `dry-run` (validated, never sent).
+    testMode: v.boolean(),
+    onEvent: v.optional(onEvent),
+});
+/* -------------------------------------------------------------------------- */
+/*  Message input (client -> component)                                       */
+/* -------------------------------------------------------------------------- */
+// The normalized message a client hands to the component's `enqueueMessage`
+// mutation. Lifecycle fields (status, transactionId, finalizedAt, …) are added
+// by the component, not provided here.
+export const vMessageInput = v.object({
+    channel: vChannel,
+    bulk: v.boolean(),
+    emailRecipients: v.optional(v.array(vEmailRecipient)),
+    smsRecipients: v.optional(v.array(vSmsRecipient)),
+    from: v.optional(vEmailAddress),
+    subject: v.optional(v.string()),
+    cc: v.optional(v.array(vEmailAddress)),
+    bcc: v.optional(v.array(vEmailAddress)),
+    replyTo: v.optional(vEmailAddress),
+    html: v.optional(v.string()),
+    text: v.optional(v.string()),
+    templateId: v.optional(v.string()),
+    variables: v.optional(vVariables),
+    attachments: v.optional(v.array(vAttachment)),
+    headers: v.optional(v.record(v.string(), v.string())),
+    listUnsub: v.optional(vListUnsub),
+    expires: v.optional(v.string()),
+    campaignId: v.optional(v.string()),
+    campaignTags: v.optional(v.array(v.string())),
+    campaignType: v.optional(v.string()),
+    compressStyle: v.optional(v.boolean()),
+    forceInlineStyle: v.optional(v.boolean()),
+    dryRun: v.optional(v.boolean()),
+    senderId: v.optional(v.string()),
+    shortenUrls: v.optional(v.boolean()),
+    shortenWithProtocol: v.optional(v.boolean()),
+    bat: v.optional(v.boolean()),
+});
+/* -------------------------------------------------------------------------- */
+/*  Helpers                                                                   */
+/* -------------------------------------------------------------------------- */
+// Accepts either a structured address or an RFC-5322-ish "Name <email>" /
+// "email" string and returns { email, name? }.
+export function parseEmailAddress(input) {
+    if (typeof input !== "string")
+        return input;
+    const match = input.match(/^\s*(.*?)\s*<\s*([^>]+)\s*>\s*$/);
+    if (match) {
+        const name = match[1].replace(/^["']|["']$/g, "").trim();
+        const email = match[2].trim();
+        return name ? { email, name } : { email };
+    }
+    return { email: input.trim() };
+}
+export function parseEmailAddresses(input) {
+    const list = Array.isArray(input) ? input : [input];
+    return list.map(parseEmailAddress);
+}
+//# sourceMappingURL=shared.js.map

package/dist/component/shared.js.map

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

package/dist/component/sweego.d.ts

@@ -0,0 +1,95 @@
+/**
+ * HTTP status codes from which retrying will never help. Everything else
+ * (429 rate limits, 409 conflicts, 5xx) is treated as transient and retried
+ * by the workpool. Derived from Sweego's documented status codes.
+ */
+export declare const PERMANENT_ERROR_CODES: Set<number>;
+export type SweegoRequestInit = Omit<RequestInit, "body"> & {
+    json?: unknown;
+};
+/** Low-level fetch against the Sweego API with the `Api-Key` auth header. */
+export declare function sweegoFetch(apiKey: string, path: string, init?: SweegoRequestInit): Promise<Response>;
+/** Turn a non-OK Sweego response into a concise, non-leaky Error message. */
+export declare function sanitizeSweegoError(status: number, errorText: string): string;
+export interface BuildableMessage {
+    channel: "email" | "sms";
+    provider: string;
+    bulk: boolean;
+    emailRecipients?: Array<{
+        email: string;
+        name?: string;
+        variables?: Record<string, string | number | boolean>;
+    }>;
+    smsRecipients?: Array<{
+        num: string;
+        region: string;
+    }>;
+    from?: {
+        email: string;
+        name?: string;
+    };
+    subject?: string;
+    cc?: Array<{
+        email: string;
+        name?: string;
+    }>;
+    bcc?: Array<{
+        email: string;
+        name?: string;
+    }>;
+    replyTo?: {
+        email: string;
+        name?: string;
+    };
+    html?: string;
+    text?: string;
+    templateId?: string;
+    variables?: Record<string, string | number | boolean>;
+    attachments?: Array<{
+        content: string;
+        filename: string;
+        contentId?: string;
+        disposition?: "attachment" | "inline";
+        isRelated?: boolean;
+    }>;
+    headers?: Record<string, string>;
+    listUnsub?: {
+        method?: "mailto" | "one-click";
+        value: string;
+    };
+    expires?: string;
+    campaignId?: string;
+    campaignTags?: string[];
+    campaignType?: string;
+    compressStyle?: boolean;
+    forceInlineStyle?: boolean;
+    dryRun?: boolean;
+    senderId?: string;
+    shortenUrls?: boolean;
+    shortenWithProtocol?: boolean;
+    bat?: boolean;
+}
+type Json = Record<string, unknown>;
+/** Build the `{ path, body }` for a stored message. */
+export declare function buildSendRequest(message: BuildableMessage): {
+    path: string;
+    body: Json;
+};
+export interface SendResult {
+    channel?: string;
+    provider?: string;
+    swgUids: Record<string, string>;
+    transactionId?: string;
+    creditLeft?: string;
+}
+/** Parse a Sweego `ModelOutSend` body into a normalized result. */
+export declare function parseSendResponse(data: unknown): SendResult;
+/** GET /logs/{swg_uid}/status — current remote status for one message. */
+export declare function fetchLogStatus(apiKey: string, swgUid: string): Promise<{
+    status: string;
+    channel?: string;
+} | null>;
+/** POST /sms/estimate — estimate the cost/segments of an SMS send. */
+export declare function fetchSmsEstimate(apiKey: string, body: Record<string, unknown>): Promise<unknown>;
+export {};
+//# sourceMappingURL=sweego.d.ts.map

package/dist/component/sweego.d.ts.map

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