samva 0.18.0 → 0.20.0

package/dist/effect/templates.d.ts

@@ -7,6 +7,7 @@ export declare const list: ((input?: {
     readonly status?: "approved" | "archived" | "draft" | "pending" | "published" | "rejected" | null | undefined;
     readonly search?: string | null | undefined;
     readonly projectId?: string | null | undefined;
+    readonly namespaceId?: string | null | undefined;
 } | undefined) => import("effect/Effect").Effect<{
     readonly items: readonly {
         readonly id: string & import("effect/Brand").Brand<"TemplateId">;
@@ -14,6 +15,7 @@ export declare const list: ((input?: {
         readonly name: string;
         readonly channel: "email";
         readonly projectId: string & import("effect/Brand").Brand<"TemplateProjectId">;
+        readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
         readonly entryPath: string;
         readonly status: "approved" | "archived" | "draft" | "pending" | "published" | "rejected";
         readonly isActive: boolean;
@@ -42,6 +44,7 @@ export declare const list: ((input?: {
         readonly status?: "approved" | "archived" | "draft" | "pending" | "published" | "rejected" | null | undefined;
         readonly search?: string | null | undefined;
         readonly projectId?: string | null | undefined;
+        readonly namespaceId?: string | null | undefined;
     } | undefined) => import("effect/Stream").Stream<{
         readonly items: readonly {
             readonly id: string & import("effect/Brand").Brand<"TemplateId">;
@@ -49,6 +52,7 @@ export declare const list: ((input?: {
             readonly name: string;
             readonly channel: "email";
             readonly projectId: string & import("effect/Brand").Brand<"TemplateProjectId">;
+            readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
             readonly entryPath: string;
             readonly status: "approved" | "archived" | "draft" | "pending" | "published" | "rejected";
             readonly isActive: boolean;
@@ -77,12 +81,14 @@ export declare const list: ((input?: {
         readonly status?: "approved" | "archived" | "draft" | "pending" | "published" | "rejected" | null | undefined;
         readonly search?: string | null | undefined;
         readonly projectId?: string | null | undefined;
+        readonly namespaceId?: string | null | undefined;
     } | undefined) => import("effect/Stream").Stream<{
         readonly id: string & import("effect/Brand").Brand<"TemplateId">;
         readonly slug: string;
         readonly name: string;
         readonly channel: "email";
         readonly projectId: string & import("effect/Brand").Brand<"TemplateProjectId">;
+        readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
         readonly entryPath: string;
         readonly status: "approved" | "archived" | "draft" | "pending" | "published" | "rejected";
         readonly isActive: boolean;
@@ -111,6 +117,7 @@ export declare const create: (input: {
     readonly description?: string | null | undefined;
     readonly category?: "alert" | "marketing" | "notification" | "reminder" | "support" | "transactional" | "verification" | null | undefined;
     readonly isActive?: boolean | null | undefined;
+    readonly namespaceId?: string | null | undefined;
     readonly idempotencyKey: string;
 }) => import("effect/Effect").Effect<{
     readonly id: string & import("effect/Brand").Brand<"TemplateId">;
@@ -118,6 +125,7 @@ export declare const create: (input: {
     readonly name: string;
     readonly channel: "email";
     readonly projectId: string & import("effect/Brand").Brand<"TemplateProjectId">;
+    readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
     readonly entryPath: string;
     readonly status: "approved" | "archived" | "draft" | "pending" | "published" | "rejected";
     readonly isActive: boolean;
@@ -155,7 +163,7 @@ export declare const create: (input: {
     readonly inputSchema: {
         readonly [x: string]: import("./generated").JsonValue;
     } | null;
-}, import("./errors").ConflictError | import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
+}, import("./errors").ConflictError | import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("./errors").ResourceNotFoundError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
 export declare const addEntry: (input: {
     readonly id: string;
     readonly entryPath: string;
@@ -169,6 +177,7 @@ export declare const addEntry: (input: {
     readonly name: string;
     readonly channel: "email";
     readonly projectId: string & import("effect/Brand").Brand<"TemplateProjectId">;
+    readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
     readonly entryPath: string;
     readonly status: "approved" | "archived" | "draft" | "pending" | "published" | "rejected";
     readonly isActive: boolean;
@@ -396,6 +405,7 @@ export declare const getById: (input: {
     readonly name: string;
     readonly channel: "email";
     readonly projectId: string & import("effect/Brand").Brand<"TemplateProjectId">;
+    readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
     readonly entryPath: string;
     readonly status: "approved" | "archived" | "draft" | "pending" | "published" | "rejected";
     readonly isActive: boolean;
@@ -460,6 +470,7 @@ export declare const update: (input: {
     readonly name: string;
     readonly channel: "email";
     readonly projectId: string & import("effect/Brand").Brand<"TemplateProjectId">;
+    readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
     readonly entryPath: string;
     readonly status: "approved" | "archived" | "draft" | "pending" | "published" | "rejected";
     readonly isActive: boolean;

package/dist/effect/unsubscribe-groups.d.ts

@@ -60,9 +60,8 @@ export declare const listMembers: ((input: {
     readonly cursor?: string | null | undefined;
 }) => import("effect/Effect").Effect<{
     readonly items: readonly {
-        readonly id: string;
-        readonly email: string;
-        readonly contactId: string | null;
+        readonly id: string & import("effect/Brand").Brand<"UnsubscribeGroupMemberId">;
+        readonly contactId: string & import("effect/Brand").Brand<"ContactId">;
         readonly source: "api" | "complaint" | "link" | "manual";
         readonly unsubscribedAt: string;
         readonly createdAt: string;
@@ -75,9 +74,8 @@ export declare const listMembers: ((input: {
         readonly cursor?: string | null | undefined;
     }) => import("effect/Stream").Stream<{
         readonly items: readonly {
-            readonly id: string;
-            readonly email: string;
-            readonly contactId: string | null;
+            readonly id: string & import("effect/Brand").Brand<"UnsubscribeGroupMemberId">;
+            readonly contactId: string & import("effect/Brand").Brand<"ContactId">;
             readonly source: "api" | "complaint" | "link" | "manual";
             readonly unsubscribedAt: string;
             readonly createdAt: string;
@@ -89,33 +87,46 @@ export declare const listMembers: ((input: {
         readonly limit?: string | null | undefined;
         readonly cursor?: string | null | undefined;
     }) => import("effect/Stream").Stream<{
-        readonly id: string;
-        readonly email: string;
-        readonly contactId: string | null;
+        readonly id: string & import("effect/Brand").Brand<"UnsubscribeGroupMemberId">;
+        readonly contactId: string & import("effect/Brand").Brand<"ContactId">;
         readonly source: "api" | "complaint" | "link" | "manual";
         readonly unsubscribedAt: string;
         readonly createdAt: string;
     }, import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("./errors").ResourceNotFoundError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
 };
-export declare const addEmails: (input: {
+export declare const addMembers: (input: {
     readonly id: string;
-    readonly emails: readonly string[];
+    readonly members: readonly ({
+        readonly contactId: string;
+    } | {
+        readonly email: string;
+    } | {
+        readonly phone: string;
+    })[];
     readonly source?: "api" | "complaint" | "link" | "manual" | null | undefined;
 }) => import("effect/Effect").Effect<{
     readonly added: number;
     readonly skipped: number;
-}, import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("./errors").ResourceNotFoundError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
-export declare const removeEmails: (input: {
+}, import("./errors").BillingProviderError | import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("./errors").PaymentRequiredError | import("./errors").ResourceNotFoundError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
+export declare const removeMembers: (input: {
     readonly id: string;
-    readonly emails: readonly string[];
+    readonly members: readonly ({
+        readonly contactId: string;
+    } | {
+        readonly email: string;
+    } | {
+        readonly phone: string;
+    })[];
 }) => import("effect/Effect").Effect<{
     readonly removed: number;
 }, import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("./errors").ResourceNotFoundError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
-export declare const checkSubscription: (input: {
-    readonly email: string;
+export declare const checkSubscription: (input?: {
+    readonly contactId?: string | null | undefined;
+    readonly email?: string | null | undefined;
+    readonly phone?: string | null | undefined;
     readonly groupIds?: string | null | undefined;
-}) => import("effect/Effect").Effect<{
-    readonly email: string;
+} | undefined) => import("effect/Effect").Effect<{
+    readonly contactId: (string & import("effect/Brand").Brand<"ContactId">) | null;
     readonly unsubscribedGroups: readonly {
         readonly groupId: string;
         readonly groupName: string;

package/dist/effect/unsubscribe-groups.js

@@ -3,13 +3,13 @@ import { forGroup } from "./internal/operation.js";
 import { UnsubscribeGroupsGroup } from "./generated/unsubscribe-groups.js";
 //#region src/effect/unsubscribe-groups.ts
 var unsubscribe_groups_exports = /* @__PURE__ */ __exportAll({
-	addEmails: () => addEmails,
+	addMembers: () => addMembers,
 	checkSubscription: () => checkSubscription,
 	create: () => create,
 	list: () => list,
 	listMembers: () => listMembers,
 	remove: () => remove,
-	removeEmails: () => removeEmails,
+	removeMembers: () => removeMembers,
 	setDefault: () => setDefault,
 	update: () => update
 });
@@ -20,10 +20,10 @@ const update = /* @__PURE__ */ make("unsubscribeUpdate");
 const remove = /* @__PURE__ */ make("unsubscribeRemove");
 const setDefault = /* @__PURE__ */ make("unsubscribeSetDefault");
 const listMembers = /* @__PURE__ */ make("unsubscribeListMembers");
-const addEmails = /* @__PURE__ */ make("unsubscribeAddEmails");
-const removeEmails = /* @__PURE__ */ make("unsubscribeRemoveEmails");
+const addMembers = /* @__PURE__ */ make("unsubscribeAddMembers");
+const removeMembers = /* @__PURE__ */ make("unsubscribeRemoveMembers");
 const checkSubscription = /* @__PURE__ */ make("unsubscribeCheckSubscription");
 //#endregion
-export { addEmails, checkSubscription, create, list, listMembers, remove, removeEmails, setDefault, unsubscribe_groups_exports, update };
+export { addMembers, checkSubscription, create, list, listMembers, remove, removeMembers, setDefault, unsubscribe_groups_exports, update };
 
 //# sourceMappingURL=unsubscribe-groups.js.map

package/dist/effect/webhooks.d.ts

@@ -9,7 +9,7 @@ export declare const list: ((input?: {
         readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
         readonly name: string;
         readonly url: string;
-        readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+        readonly eventTypes: readonly ("contact.consent_changed" | "contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
         readonly channels: readonly "email"[] | null;
         readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
         readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -39,7 +39,7 @@ export declare const list: ((input?: {
             readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
             readonly name: string;
             readonly url: string;
-            readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+            readonly eventTypes: readonly ("contact.consent_changed" | "contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
             readonly channels: readonly "email"[] | null;
             readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
             readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -68,7 +68,7 @@ export declare const list: ((input?: {
         readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
         readonly name: string;
         readonly url: string;
-        readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+        readonly eventTypes: readonly ("contact.consent_changed" | "contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
         readonly channels: readonly "email"[] | null;
         readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
         readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -90,7 +90,7 @@ export declare const list: ((input?: {
 export declare const create: (input: {
     readonly name: string;
     readonly url: string;
-    readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+    readonly eventTypes: readonly ("contact.consent_changed" | "contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
     readonly channels?: readonly "email"[] | null | undefined;
     readonly mailboxIds?: readonly string[] | null | undefined;
     readonly namespaceId?: string | null | undefined;
@@ -103,7 +103,7 @@ export declare const create: (input: {
         readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
         readonly name: string;
         readonly url: string;
-        readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+        readonly eventTypes: readonly ("contact.consent_changed" | "contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
         readonly channels: readonly "email"[] | null;
         readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
         readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -122,7 +122,7 @@ export declare const get: (input: {
     readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
     readonly name: string;
     readonly url: string;
-    readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+    readonly eventTypes: readonly ("contact.consent_changed" | "contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
     readonly channels: readonly "email"[] | null;
     readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
     readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -142,7 +142,7 @@ export declare const update: (input: {
     readonly id: string;
     readonly name?: string | null | undefined;
     readonly url?: string | null | undefined;
-    readonly eventTypes?: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[] | null | undefined;
+    readonly eventTypes?: readonly ("contact.consent_changed" | "contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[] | null | undefined;
     readonly channels?: readonly "email"[] | null | undefined;
     readonly mailboxIds?: readonly string[] | null | undefined;
     readonly namespaceId?: string | null | undefined;
@@ -154,7 +154,7 @@ export declare const update: (input: {
     readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
     readonly name: string;
     readonly url: string;
-    readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+    readonly eventTypes: readonly ("contact.consent_changed" | "contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "journey.webhook" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
     readonly channels: readonly "email"[] | null;
     readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
     readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { MediaUploadError } from "./inline-attachments.js";
 import { MailboxEventStream, MailboxEventStreamError } from "./mailbox-events.js";
-import { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, DeliveryUnavailableError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxChannelUnsupportedError, MailboxSendConflictError, MailboxSendRefusedError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SamvaApiError, SamvaTransportError, SenderNotReadyError, UnauthorizedError, ValidationError, fromApiError } from "./promises/errors.gen.js";
+import { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, DeliveryUnavailableError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxSendConflictError, MailboxSendRefusedError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SamvaApiError, SamvaTransportError, SenderNotReadyError, UnauthorizedError, ValidationError, fromApiError } from "./promises/errors.gen.js";
 import { createClient } from "./promises/index.js";
-export { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, DeliveryUnavailableError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxChannelUnsupportedError, MailboxEventStream, MailboxEventStreamError, MailboxSendConflictError, MailboxSendRefusedError, MediaUploadError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SamvaApiError, SamvaTransportError, SenderNotReadyError, UnauthorizedError, ValidationError, createClient, fromApiError };
+export { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, DeliveryUnavailableError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxEventStream, MailboxEventStreamError, MailboxSendConflictError, MailboxSendRefusedError, MediaUploadError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SamvaApiError, SamvaTransportError, SenderNotReadyError, UnauthorizedError, ValidationError, createClient, fromApiError };

package/dist/mailbox-events.d.ts

@@ -5,7 +5,8 @@
  * {@link MailboxEventStream} is an async iterable. The loop body handling an event is the
  * acknowledgement: asking for the next event marks the previous one handled, and the stream
  * resumes from the last handled event whenever it reconnects. Transient closes reconnect by
- * themselves; a close the caller has to act on ends the loop with a {@link MailboxEventStreamError}.
+ * themselves, and a normal close (1000) from the host ends the loop after the events already
+ * received; a close the caller has to act on ends the loop with a {@link MailboxEventStreamError}.
  *
  * This module has no runtime dependencies so the Promise and Effect clients share it.
  */
@@ -29,7 +30,7 @@ export declare const MailboxEventStreamCloseCode: {
     readonly accessUnavailable: 4503;
 };
 /** The event types the stream carries: the `mailbox.*` webhook events. */
-export type MailboxEventType = "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded";
+export type MailboxEventType = "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded";
 /** One event, as a webhook delivery of it would carry it, plus its stream position. */
 export interface MailboxEvent {
     /** The stream position of this event. Persist it after handling to resume from here. */
@@ -44,12 +45,19 @@ export interface MailboxEvent {
 /**
  * Why a stream ended, as the `_tag` of its {@link MailboxEventStreamError}. The first nine are the
  * API error tags the events host refuses with, or that a close code stands for. The rest are the
- * client's own: `StreamDisconnectedError` is a close or an unreachable host that was not retried
- * because `reconnect` is `false`, `StreamClientError` is a request this client could not make,
+ * client's own: `StreamDisconnectedError` is a close, an idle timeout, or an unreachable host that
+ * was not retried because `reconnect` is `false`, `StreamClientError` is a request this client could not make,
  * `StreamProtocolError` is a frame from the host it could not read, and `StreamRefusedError` is a refusal whose tag and status this client
  * does not know (`serverTag` carries the tag the host sent).
  */
 export type MailboxEventStreamErrorTag = "UnauthorizedError" | "ForbiddenError" | "ResourceNotFoundError" | "CursorExpiredError" | "ValidationError" | "UpgradeRequiredError" | "RateLimitedError" | "ServiceUnavailableError" | "MethodNotAllowedError" | "StreamDisconnectedError" | "StreamClientError" | "StreamProtocolError" | "StreamRefusedError";
+/**
+ * Why a {@link MailboxEventStreamError} ended a stream, when `_tag` alone does not say.
+ * `idleTimeout`: the client heard no frame, not even a pong, for
+ * {@link MAILBOX_EVENT_STREAM_IDLE_MILLIS}, so it closed the connection itself. No close code
+ * accompanies it; a `closeCode` of `1006` is a close the client observed without a status.
+ */
+export type MailboxEventStreamErrorReason = "idleTimeout";
 /** Field-level validation messages, keyed by dotted path, as a `ValidationError` carries them. */
 export type MailboxEventStreamErrorFields = Readonly<Record<string, ReadonlyArray<string>>>;
 /**
@@ -76,6 +84,8 @@ export declare class MailboxEventStreamError<Tag extends MailboxEventStreamError
     readonly retryAfterSeconds: number | undefined;
     /** The tag the host sent, when it is not one this client maps. */
     readonly serverTag: string | undefined;
+    /** Set when the client ended the connection itself; see {@link MailboxEventStreamErrorReason}. */
+    readonly reason: MailboxEventStreamErrorReason | undefined;
     constructor(input: {
         readonly _tag: Tag;
         readonly message: string;
@@ -85,6 +95,7 @@ export declare class MailboxEventStreamError<Tag extends MailboxEventStreamError
         readonly fields?: MailboxEventStreamErrorFields | undefined;
         readonly retryAfterSeconds?: number | undefined;
         readonly serverTag?: string | undefined;
+        readonly reason?: MailboxEventStreamErrorReason | undefined;
     });
 }
 /** Every stream error as a union over `_tag`, so `Effect.catchTag` can narrow it. */
@@ -113,6 +124,17 @@ export interface MailboxEventStreamSocket {
 export type MailboxEventStreamWebSocket = new (url: string, options: {
     readonly headers: Readonly<Record<string, string>>;
 }) => MailboxEventStreamSocket;
+/** A reconnect the stream is about to make. */
+export interface MailboxEventStreamReconnect {
+    /** Why the connection ended: the error the stream would have ended with had it not retried. */
+    readonly error: MailboxEventStreamError;
+    /** The cursor the next connection resumes from; undefined when the stream started live and has none yet. */
+    readonly cursor: string | undefined;
+    /** Failed attempts in a row, starting at 1; a connection that went live resets it. */
+    readonly attempt: number;
+    /** How long the stream waits before connecting again. */
+    readonly delayMillis: number;
+}
 export interface MailboxEventStreamOptions {
     /** Resume after this cursor: every retained event after it, then live. Omit to start live. */
     readonly cursor?: string | undefined;
@@ -124,6 +146,11 @@ export interface MailboxEventStreamOptions {
     readonly onLive?: (() => void) | undefined;
     /** Reconnect after transient closes. Defaults to `true`. */
     readonly reconnect?: boolean | undefined;
+    /**
+     * Called when a transient failure ends a connection and the stream is about to reconnect from
+     * its last handled cursor, before the backoff wait. Never called when `reconnect` is `false`.
+     */
+    readonly onReconnect?: ((reconnect: MailboxEventStreamReconnect) => void) | undefined;
     /**
      * The events origin, such as `wss://events.samva.dev`. Defaults to the API origin with its
      * `api` host label replaced by `events`.

package/dist/mailbox-events.js

@@ -6,7 +6,8 @@
 * {@link MailboxEventStream} is an async iterable. The loop body handling an event is the
 * acknowledgement: asking for the next event marks the previous one handled, and the stream
 * resumes from the last handled event whenever it reconnects. Transient closes reconnect by
-* themselves; a close the caller has to act on ends the loop with a {@link MailboxEventStreamError}.
+* themselves, and a normal close (1000) from the host ends the loop after the events already
+* received; a close the caller has to act on ends the loop with a {@link MailboxEventStreamError}.
 *
 * This module has no runtime dependencies so the Promise and Effect clients share it.
 */
@@ -66,6 +67,8 @@ var MailboxEventStreamError = class extends Error {
 	retryAfterSeconds;
 	/** The tag the host sent, when it is not one this client maps. */
 	serverTag;
+	/** Set when the client ended the connection itself; see {@link MailboxEventStreamErrorReason}. */
+	reason;
 	constructor(input) {
 		super(input.message);
 		this._tag = input._tag;
@@ -75,9 +78,12 @@ var MailboxEventStreamError = class extends Error {
 		this.fields = input.fields;
 		this.retryAfterSeconds = input.retryAfterSeconds;
 		this.serverTag = input.serverTag;
+		this.reason = input.reason;
 	}
 };
 const OPEN = 1;
+/** The close code a host ends a finished stream with. */
+const NORMAL_CLOSE = 1e3;
 /** Acknowledge after this many handled events, well inside the server's window of 256. */
 const ACK_EVERY = 32;
 const RETRY_BASE_MILLIS = 500;
@@ -300,7 +306,7 @@ var MailboxEventStream = class {
 	* {@link markHandled} was called, so a resume repeats it. A pending iteration finishes.
 	*/
 	close() {
-		if (this.#ended) return;
+		if (this.#closed) return;
 		this.#ack();
 		this.#ended = true;
 		this.#closed = true;
@@ -349,10 +355,13 @@ var MailboxEventStream = class {
 			draining?.resolve();
 			this.#ack();
 			if (this.#error !== void 0) throw this.#errorAtCursor(this.#error);
-			if (this.#ended) return {
-				done: true,
-				value: void 0
-			};
+			if (this.#ended) {
+				this.#callerSignal?.removeEventListener("abort", this.#onCallerAbort);
+				return {
+					done: true,
+					value: void 0
+				};
+			}
 			await new Promise((resolve) => {
 				this.#waiting = { resolve };
 			});
@@ -418,8 +427,16 @@ var MailboxEventStream = class {
 				attempt = 0;
 			});
 			if (this.#ended || outcome.kind === "stopped") return;
+			if (outcome.kind === "closed" && outcome.code === NORMAL_CLOSE) {
+				this.#finish();
+				return;
+			}
 			let result;
 			if (outcome.kind === "closed") result = closeOutcome(outcome.code);
+			else if (outcome.kind === "idle") result = outcomeOf("StreamDisconnectedError", true, {
+				reason: "idleTimeout",
+				message: `No frame from the events host in ${MAILBOX_EVENT_STREAM_IDLE_MILLIS / 1e3} seconds, so the stream closed the connection.`
+			});
 			else {
 				const refusal = await this.#diagnose();
 				result = refusal === void 0 ? outcomeOf("StreamDisconnectedError", true) : refusalOutcome(refusal);
@@ -430,9 +447,23 @@ var MailboxEventStream = class {
 			}
 			const backoff = Math.min(RETRY_MAX_MILLIS, RETRY_BASE_MILLIS * 2 ** attempt);
 			attempt += 1;
-			await sleep(result.retryAfterMillis ?? backoff / 2 + Math.random() * (backoff / 2), this.#stop.signal);
+			const delayMillis = result.retryAfterMillis ?? backoff / 2 + Math.random() * (backoff / 2);
+			this.#options.onReconnect?.({
+				error: this.#withCursor(result.error),
+				cursor: this.#resumeCursor(),
+				attempt,
+				delayMillis
+			});
+			await sleep(delayMillis, this.#stop.signal);
 		}
 	}
+	/** End the iteration after the buffered events, with no error. */
+	#finish() {
+		if (this.#ended) return;
+		this.#ended = true;
+		this.#stop.abort();
+		this.#wake();
+	}
 	#withCursor(error) {
 		return new MailboxEventStreamError({
 			...error,
@@ -464,10 +495,7 @@ var MailboxEventStream = class {
 			const armIdle = () => {
 				clearTimeout(idleTimer);
 				idleTimer = setTimeout(() => {
-					settle(opened ? {
-						kind: "closed",
-						code: 1006
-					} : { kind: "refused" });
+					settle(opened ? { kind: "idle" } : { kind: "refused" });
 					socket.close(1e3);
 				}, MAILBOX_EVENT_STREAM_IDLE_MILLIS);
 			};

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.18.0";
+var version = "0.20.0";
 //#endregion
 export { version };
 

package/dist/promises/errors.gen.d.ts

@@ -1,4 +1,4 @@
-export type SamvaApiErrorTag = "AnalyticsQueryError" | "BillingProviderError" | "BrandAddressRequiredError" | "CampaignFooterRequiredError" | "ConflictError" | "DeliveryUnavailableError" | "EmailChannelError" | "ExternalServiceError" | "FlagDisabledError" | "ForbiddenError" | "GatewayTimeoutError" | "InternalError" | "MailboxChannelUnsupportedError" | "MailboxSendConflictError" | "MailboxSendRefusedError" | "OnboardingReviewRequiredError" | "PaymentRequiredError" | "RateLimitedError" | "ResourceNotFoundError" | "SenderNotReadyError" | "UnauthorizedError" | "ValidationError";
+export type SamvaApiErrorTag = "AnalyticsQueryError" | "BillingProviderError" | "BrandAddressRequiredError" | "CampaignFooterRequiredError" | "ConflictError" | "DeliveryUnavailableError" | "EmailChannelError" | "ExternalServiceError" | "FlagDisabledError" | "ForbiddenError" | "GatewayTimeoutError" | "InternalError" | "MailboxSendConflictError" | "MailboxSendRefusedError" | "OnboardingReviewRequiredError" | "PaymentRequiredError" | "RateLimitedError" | "ResourceNotFoundError" | "SenderNotReadyError" | "UnauthorizedError" | "ValidationError";
 export interface SamvaApiErrorContext {
     readonly request?: Request | undefined;
     readonly response?: Response | undefined;
@@ -132,16 +132,6 @@ export declare class InternalError extends SamvaApiError<"InternalError"> {
     readonly _tag: "InternalError";
     constructor(payload: Omit<InternalErrorPayload, "_tag">, context?: SamvaApiErrorContext);
 }
-type MailboxChannelUnsupportedErrorPayload = {
-    readonly _tag: "MailboxChannelUnsupportedError";
-    readonly channel: string;
-    readonly message: string;
-};
-export declare class MailboxChannelUnsupportedError extends SamvaApiError<"MailboxChannelUnsupportedError"> {
-    readonly _tag: "MailboxChannelUnsupportedError";
-    readonly "channel": string;
-    constructor(payload: Omit<MailboxChannelUnsupportedErrorPayload, "_tag">, context?: SamvaApiErrorContext);
-}
 type MailboxSendConflictErrorPayload = {
     readonly _tag: "MailboxSendConflictError";
     readonly id: string;
@@ -250,7 +240,7 @@ export declare class ValidationError extends SamvaApiError<"ValidationError"> {
     readonly "fields"?: Record<string, Array<string>> | null;
     constructor(payload: Omit<ValidationErrorPayload, "_tag">, context?: SamvaApiErrorContext);
 }
-export type AnySamvaApiError = AnalyticsQueryError | BillingProviderError | BrandAddressRequiredError | CampaignFooterRequiredError | ConflictError | DeliveryUnavailableError | EmailChannelError | ExternalServiceError | FlagDisabledError | ForbiddenError | GatewayTimeoutError | InternalError | MailboxChannelUnsupportedError | MailboxSendConflictError | MailboxSendRefusedError | OnboardingReviewRequiredError | PaymentRequiredError | RateLimitedError | ResourceNotFoundError | SenderNotReadyError | UnauthorizedError | ValidationError;
+export type AnySamvaApiError = AnalyticsQueryError | BillingProviderError | BrandAddressRequiredError | CampaignFooterRequiredError | ConflictError | DeliveryUnavailableError | EmailChannelError | ExternalServiceError | FlagDisabledError | ForbiddenError | GatewayTimeoutError | InternalError | MailboxSendConflictError | MailboxSendRefusedError | OnboardingReviewRequiredError | PaymentRequiredError | RateLimitedError | ResourceNotFoundError | SenderNotReadyError | UnauthorizedError | ValidationError;
 /** Convert a decoded error payload into its generated JavaScript error class. */
 export declare function fromApiError(error: unknown, context?: SamvaApiErrorContext): AnySamvaApiError | SamvaTransportError;
 export {};

package/dist/promises/errors.gen.js

@@ -117,13 +117,6 @@ var InternalError = class extends SamvaApiError {
 		Object.assign(this, payload);
 	}
 };
-var MailboxChannelUnsupportedError = class extends SamvaApiError {
-	_tag = "MailboxChannelUnsupportedError";
-	constructor(payload, context = {}) {
-		super(messageOf("MailboxChannelUnsupportedError", payload), context);
-		Object.assign(this, payload);
-	}
-};
 var MailboxSendConflictError = class extends SamvaApiError {
 	_tag = "MailboxSendConflictError";
 	constructor(payload, context = {}) {
@@ -200,7 +193,6 @@ const constructors = {
 	ForbiddenError,
 	GatewayTimeoutError,
 	InternalError,
-	MailboxChannelUnsupportedError,
 	MailboxSendConflictError,
 	MailboxSendRefusedError,
 	OnboardingReviewRequiredError,
@@ -411,23 +403,6 @@ const payloadSchemas = {
 		"x-category": ["transient"],
 		"x-retryable": true
 	},
-	MailboxChannelUnsupportedError: {
-		type: "object",
-		properties: {
-			_tag: {
-				type: "string",
-				enum: ["MailboxChannelUnsupportedError"]
-			},
-			message: { type: "string" },
-			channel: { type: "string" }
-		},
-		required: [
-			"_tag",
-			"message",
-			"channel"
-		],
-		additionalProperties: false
-	},
 	MailboxSendConflictError: {
 		type: "object",
 		properties: {
@@ -1335,6 +1310,6 @@ function fromApiError(error, context = {}) {
 	return new SamvaTransportError(error, context);
 }
 //#endregion
-export { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, DeliveryUnavailableError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxChannelUnsupportedError, MailboxSendConflictError, MailboxSendRefusedError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SamvaApiError, SamvaTransportError, SenderNotReadyError, UnauthorizedError, ValidationError, fromApiError };
+export { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, DeliveryUnavailableError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxSendConflictError, MailboxSendRefusedError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SamvaApiError, SamvaTransportError, SenderNotReadyError, UnauthorizedError, ValidationError, fromApiError };
 
 //# sourceMappingURL=errors.gen.js.map

package/dist/promises/index.d.ts

@@ -33,7 +33,7 @@ import { MailboxEventStream, type MailboxEventStreamOptions } from "../mailbox-e
 export * from "./errors.gen";
 export { MediaUploadError } from "../inline-attachments";
 export type * from "./types.gen";
-export { MailboxEventStream, MailboxEventStreamError, type MailboxEvent, type MailboxEventStreamErrorFields, type MailboxEventStreamErrorTag, type MailboxEventStreamFailure, type MailboxEventStreamOptions, type MailboxEventStreamWebSocket, type MailboxEventType, } from "../mailbox-events";
+export { MailboxEventStream, MailboxEventStreamError, type MailboxEvent, type MailboxEventStreamErrorFields, type MailboxEventStreamErrorReason, type MailboxEventStreamErrorTag, type MailboxEventStreamFailure, type MailboxEventStreamOptions, type MailboxEventStreamReconnect, type MailboxEventStreamWebSocket, type MailboxEventType, } from "../mailbox-events";
 interface SamvaClientConfigBase extends Omit<Config, "baseUrl" | "responseStyle" | "throwOnError"> {
     /** Base URL for the API (defaults to https://api.samva.dev). */
     baseUrl?: string;