samva 0.16.0 → 0.18.0

package/dist/effect/index.d.ts

@@ -29,7 +29,9 @@ export * as CustomFields from "./custom-fields";
 export * as Email from "./email";
 export * as ExtensionInstallations from "./extension-installations";
 export * as Extensions from "./extensions";
+export * as Events from "./events";
 export * as Feedback from "./feedback";
+export * as Journeys from "./journeys";
 export * as Mailboxes from "./mailboxes";
 export * as Media from "./media";
 export * as Messages from "./messages";
@@ -43,8 +45,7 @@ export * as Templates from "./templates";
 export * as UnsubscribeGroups from "./unsubscribe-groups";
 export * as Webhooks from "./webhooks";
 export * as Whoami from "./whoami";
-export { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxChannelUnsupportedError, MailboxSendConflictError, MailboxSendRefusedError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SenderNotReadyError, UnauthorizedError, ValidationError, DeliveryUnavailableError, } from "./generated";
+export * from "./errors";
 export { type ErrorCategory, categoriesOf, hasCategory, isAuthError, isValidationError, isNotFoundError, isConflictError, isThrottlingError, isBillingError, isTransient, isRetryable, catchCategory, catchAuthError, catchValidationError, catchNotFoundError, catchConflictError, catchThrottlingError, catchBillingError, catchTransient, } from "./categories";
-export { MediaUploadError } from "../inline-attachments";
 export type { CursorPageEnvelope } from "./pagination";
 export type { Json as JsonValue } from "effect/Schema";

package/dist/effect/index.js

@@ -1,31 +1,33 @@
-import { t as MediaUploadError } from "../inline-attachments-Cegg6tTF.js";
-import { C as MailboxSendConflictError, D as RateLimitedError, E as PaymentRequiredError, O as ResourceNotFoundError, P as UnauthorizedError, R as ValidationError, S as MailboxChannelUnsupportedError, T as OnboardingReviewRequiredError, _ as ExternalServiceError, a as AnalyticsQueryError, b as GatewayTimeoutError, c as BillingProviderError, d as ConflictError, g as EmailChannelError, h as DeliveryUnavailableError, j as SenderNotReadyError, l as BrandAddressRequiredError, u as CampaignFooterRequiredError, v as FlagDisabledError, w as MailboxSendRefusedError, x as InternalError, y as ForbiddenError } from "../client-BMUew5Wp.js";
-import { _ as isTransient, a as catchNotFoundError, c as catchValidationError, d as isAuthError, f as isBillingError, g as isThrottlingError, h as isRetryable, i as catchConflictError, l as categoriesOf, m as isNotFoundError, n as catchBillingError, o as catchThrottlingError, p as isConflictError, r as catchCategory, s as catchTransient, t as catchAuthError, u as hasCategory, v as isValidationError } from "../categories-DV51kr2H.js";
-import { t as retry_exports } from "./retry.js";
-import { t as analytics_exports } from "./analytics.js";
-import { t as api_keys_exports } from "./api-keys.js";
-import { t as attachments_exports } from "./attachments.js";
-import { t as brands_exports } from "./brands.js";
-import { t as campaigns_exports } from "./campaigns.js";
-import { t as client_exports } from "./client.js";
-import { t as contact_groups_exports } from "./contact-groups.js";
-import { t as contacts_exports } from "./contacts.js";
-import { t as conversations_exports } from "./conversations.js";
-import { t as custom_fields_exports } from "./custom-fields.js";
-import { t as email_exports } from "./email.js";
-import { t as extension_installations_exports } from "./extension-installations.js";
-import { t as extensions_exports } from "./extensions.js";
-import { t as feedback_exports } from "./feedback.js";
-import { V as mailboxes_exports } from "../mailboxes-Thp5z0oX.js";
-import { t as media_exports } from "./media.js";
-import { t as messages_exports } from "./messages.js";
-import { t as namespaces_exports } from "./namespaces.js";
-import { t as operations_exports } from "./operations.js";
-import { t as organizations_exports } from "./organizations.js";
-import { t as scheduled_messages_exports } from "./scheduled-messages.js";
-import { t as subscriptions_exports } from "./subscriptions.js";
-import { t as templates_exports } from "./templates.js";
-import { t as unsubscribe_groups_exports } from "./unsubscribe-groups.js";
-import { t as webhooks_exports } from "./webhooks.js";
-import { t as whoami_exports } from "./whoami.js";
-export { analytics_exports as Analytics, AnalyticsQueryError, api_keys_exports as ApiKeys, attachments_exports as Attachments, BillingProviderError, BrandAddressRequiredError, brands_exports as Brands, CampaignFooterRequiredError, campaigns_exports as Campaigns, client_exports as Client, ConflictError, contact_groups_exports as ContactGroups, contacts_exports as Contacts, conversations_exports as Conversations, custom_fields_exports as CustomFields, DeliveryUnavailableError, email_exports as Email, EmailChannelError, extension_installations_exports as ExtensionInstallations, extensions_exports as Extensions, ExternalServiceError, feedback_exports as Feedback, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxChannelUnsupportedError, MailboxSendConflictError, MailboxSendRefusedError, mailboxes_exports as Mailboxes, media_exports as Media, MediaUploadError, messages_exports as Messages, namespaces_exports as Namespaces, OnboardingReviewRequiredError, operations_exports as Operations, organizations_exports as Organizations, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, retry_exports as Retry, scheduled_messages_exports as ScheduledMessages, SenderNotReadyError, subscriptions_exports as Subscriptions, templates_exports as Templates, UnauthorizedError, unsubscribe_groups_exports as UnsubscribeGroups, ValidationError, webhooks_exports as Webhooks, whoami_exports as Whoami, catchAuthError, catchBillingError, catchCategory, catchConflictError, catchNotFoundError, catchThrottlingError, catchTransient, catchValidationError, categoriesOf, hasCategory, isAuthError, isBillingError, isConflictError, isNotFoundError, isRetryable, isThrottlingError, isTransient, isValidationError };
+import { MediaUploadError } from "../inline-attachments.js";
+import { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, DeliveryUnavailableError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxChannelUnsupportedError, MailboxSendConflictError, MailboxSendRefusedError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SenderNotReadyError, UnauthorizedError, ValidationError } from "./generated/shared.js";
+import { catchAuthError, catchBillingError, catchCategory, catchConflictError, catchNotFoundError, catchThrottlingError, catchTransient, catchValidationError, categoriesOf, hasCategory, isAuthError, isBillingError, isConflictError, isNotFoundError, isRetryable, isThrottlingError, isTransient, isValidationError } from "./categories.js";
+import { retry_exports } from "./retry.js";
+import { analytics_exports } from "./analytics.js";
+import { api_keys_exports } from "./api-keys.js";
+import { attachments_exports } from "./attachments.js";
+import { brands_exports } from "./brands.js";
+import { campaigns_exports } from "./campaigns.js";
+import { client_exports } from "./client.js";
+import { contact_groups_exports } from "./contact-groups.js";
+import { contacts_exports } from "./contacts.js";
+import { conversations_exports } from "./conversations.js";
+import { custom_fields_exports } from "./custom-fields.js";
+import { email_exports } from "./email.js";
+import { extension_installations_exports } from "./extension-installations.js";
+import { extensions_exports } from "./extensions.js";
+import { events_exports } from "./events.js";
+import { feedback_exports } from "./feedback.js";
+import { journeys_exports } from "./journeys.js";
+import { mailboxes_exports } from "./mailboxes.js";
+import { media_exports } from "./media.js";
+import { messages_exports } from "./messages.js";
+import { namespaces_exports } from "./namespaces.js";
+import { operations_exports } from "./operations.js";
+import { organizations_exports } from "./organizations.js";
+import { scheduled_messages_exports } from "./scheduled-messages.js";
+import { subscriptions_exports } from "./subscriptions.js";
+import { templates_exports } from "./templates.js";
+import { unsubscribe_groups_exports } from "./unsubscribe-groups.js";
+import { webhooks_exports } from "./webhooks.js";
+import { whoami_exports } from "./whoami.js";
+export { analytics_exports as Analytics, AnalyticsQueryError, api_keys_exports as ApiKeys, attachments_exports as Attachments, BillingProviderError, BrandAddressRequiredError, brands_exports as Brands, CampaignFooterRequiredError, campaigns_exports as Campaigns, client_exports as Client, ConflictError, contact_groups_exports as ContactGroups, contacts_exports as Contacts, conversations_exports as Conversations, custom_fields_exports as CustomFields, DeliveryUnavailableError, email_exports as Email, EmailChannelError, events_exports as Events, extension_installations_exports as ExtensionInstallations, extensions_exports as Extensions, ExternalServiceError, feedback_exports as Feedback, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, journeys_exports as Journeys, MailboxChannelUnsupportedError, MailboxSendConflictError, MailboxSendRefusedError, mailboxes_exports as Mailboxes, media_exports as Media, MediaUploadError, messages_exports as Messages, namespaces_exports as Namespaces, OnboardingReviewRequiredError, operations_exports as Operations, organizations_exports as Organizations, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, retry_exports as Retry, scheduled_messages_exports as ScheduledMessages, SenderNotReadyError, subscriptions_exports as Subscriptions, templates_exports as Templates, UnauthorizedError, unsubscribe_groups_exports as UnsubscribeGroups, ValidationError, webhooks_exports as Webhooks, whoami_exports as Whoami, catchAuthError, catchBillingError, catchCategory, catchConflictError, catchNotFoundError, catchThrottlingError, catchTransient, catchValidationError, categoriesOf, hasCategory, isAuthError, isBillingError, isConflictError, isNotFoundError, isRetryable, isThrottlingError, isTransient, isValidationError };

package/dist/effect/internal/client.d.ts

@@ -1,9 +1,9 @@
 import { Context, Effect, Layer, Redacted } from "effect";
-import { HttpApiClient } from "effect/http-api";
+import { HttpApiClient, type HttpApiGroup } from "effect/http-api";
 import * as HttpClient from "effect/http/HttpClient";
 import { MediaUploadError } from "../../inline-attachments";
 import type { MailboxEventStreamConnection } from "../../mailbox-events";
-import { SamvaApi } from "../generated";
+import type { SamvaApi } from "../generated/index";
 export interface ConfigBase {
     readonly baseUrl?: string;
     readonly headers?: Readonly<Record<string, string | undefined>>;
@@ -15,18 +15,22 @@ export type Config = (ConfigBase & {
     readonly authToken: string;
     readonly apiKey?: never;
 });
-export type Raw = HttpApiClient.ForApi<typeof SamvaApi>;
+type Api = HttpApiClient.ForApi<typeof SamvaApi>;
 type UnionToIntersection<Union> = (Union extends unknown ? (arg: Union) => void : never) extends (arg: infer Intersection) => void ? Intersection : never;
 type FlattenGroups<Client> = {
     [Group in keyof Client]: {
         [Endpoint in keyof Client[Group]]: Client[Group][Endpoint];
     };
 }[keyof Client];
-export type FlatRaw = UnionToIntersection<FlattenGroups<Raw>>;
+export type FlatRaw = UnionToIntersection<FlattenGroups<Api>>;
 export type Operation = keyof FlatRaw & string;
+export type RawCall = (request?: unknown) => Effect.Effect<unknown, unknown>;
 export interface Interface {
-    readonly raw: Raw;
-    readonly operation: <Name extends Operation>(name: Name) => FlatRaw[Name];
+    /**
+     * The generated call for one endpoint. A group's client is built on the first call to any of its
+     * endpoints and reused, so a group the program never calls costs nothing.
+     */
+    readonly endpoint: (group: HttpApiGroup.Constraint, name: Operation) => Effect.Effect<RawCall>;
     /** The origin and headers a connection outside HTTP requests, such as the event stream, uses. */
     readonly connection: MailboxEventStreamConnection;
     /**
@@ -48,5 +52,4 @@ export declare class Service extends Service_base {
 }
 export declare const layer: (config: Config) => Layer.Layer<Service, never, HttpClient.HttpClient>;
 export declare const layerFetch: (config: Config) => Layer.Layer<Service>;
-export declare const raw: Effect.Effect<Raw, never, Service>;
 export {};

package/dist/effect/internal/client.js

@@ -0,0 +1,69 @@
+import { CLIENT_ATTRIBUTION_HEADER, clientAttribution } from "../../client-attribution.js";
+import { MediaUploadError, uploadContentType } from "../../inline-attachments.js";
+import { ApiKeySecurityMiddleware } from "../generated/shared.js";
+import { HttpApi, HttpApiClient, HttpApiMiddleware } from "effect/http-api";
+import { Context, Effect, Layer, Redacted } from "effect";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientRequest from "effect/http/HttpClientRequest";
+//#region src/effect/internal/client.ts
+const DEFAULT_BASE_URL = "https://api.samva.dev";
+var Service = class extends Context.Service()("samva/Client") {};
+const authHeaders = (config) => config.authToken !== void 0 ? { Authorization: `Bearer ${config.authToken}` } : { "x-api-key": Redacted.isRedacted(config.apiKey) ? Redacted.value(config.apiKey) : config.apiKey };
+const AuthorizationClient = HttpApiMiddleware.layerClient(ApiKeySecurityMiddleware, ({ next, request }) => next(request));
+const make = (config) => Effect.gen(function* () {
+	const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+	const removesAttribution = Object.entries(config.headers ?? {}).some(([name, value]) => name.toLowerCase() === "x-samva-client" && value === void 0);
+	const storage = yield* HttpClient.HttpClient;
+	const httpClient = storage.pipe(HttpClient.mapRequest((request) => {
+		let attributed = HttpClientRequest.setHeader(request, CLIENT_ATTRIBUTION_HEADER, clientAttribution("typescript-effect"));
+		if (config.headers !== void 0) attributed = HttpClientRequest.setHeaders(attributed, config.headers);
+		if (removesAttribution) attributed = HttpClientRequest.removeHeader(attributed, CLIENT_ATTRIBUTION_HEADER);
+		return HttpClientRequest.setHeaders(attributed, authHeaders(config));
+	}));
+	const groups = /* @__PURE__ */ new Map();
+	const groupClient = (group) => {
+		const built = groups.get(group.identifier);
+		if (built !== void 0) return Effect.succeed(built);
+		return HttpApiClient.group(HttpApi.make("SamvaApi").add(group), {
+			group: group.identifier,
+			httpClient,
+			baseUrl
+		}).pipe(Effect.provide(AuthorizationClient), Effect.map((client) => {
+			const calls = client;
+			groups.set(group.identifier, calls);
+			return calls;
+		}));
+	};
+	const headers = removesAttribution ? {} : { [CLIENT_ATTRIBUTION_HEADER]: clientAttribution("typescript-effect") };
+	for (const [name, value] of Object.entries(config.headers ?? {})) if (value !== void 0) headers[name] = value;
+	const putUpload = (input) => storage.execute(HttpClientRequest.make(input.method)(input.url).pipe(HttpClientRequest.bodyUint8Array(input.bytes, uploadContentType(input.headers)), HttpClientRequest.setHeaders(input.headers))).pipe(Effect.mapError((cause) => new MediaUploadError({
+		filename: input.filename,
+		mediaId: input.mediaId,
+		cause
+	})), Effect.flatMap((response) => response.status >= 200 && response.status < 300 ? Effect.void : Effect.fail(new MediaUploadError({
+		filename: input.filename,
+		mediaId: input.mediaId,
+		status: response.status
+	}))));
+	return Service.of({
+		putUpload,
+		endpoint: (group, name) => Effect.flatMap(groupClient(group), (client) => {
+			const call = client[name];
+			return call === void 0 ? Effect.die(/* @__PURE__ */ new Error(`${name} is not an endpoint of ${group.identifier}`)) : Effect.succeed(call);
+		}),
+		connection: {
+			baseUrl,
+			headers: {
+				...headers,
+				...authHeaders(config)
+			}
+		}
+	});
+});
+const layer = (config) => Layer.effect(Service, make(config));
+const layerFetch = (config) => layer(config).pipe(Layer.provide(FetchHttpClient.layer));
+//#endregion
+export { Service, layer, layerFetch };
+
+//# sourceMappingURL=client.js.map

package/dist/effect/internal/email-sender.d.ts

@@ -0,0 +1,17 @@
+import { Effect } from "effect";
+import type { FlatRaw, Service } from "./client";
+import { type RequestArg } from "./operation";
+import type { ErgonomicEmailList, SendOptions } from "./send";
+type AddSenderRequest = NonNullable<RequestArg<FlatRaw["emailAddSender"]>>;
+export type EmailAddSenderInput = Omit<AddSenderRequest["payload"], "replyToEmails"> & {
+    readonly replyToEmails?: ErgonomicEmailList | null | undefined;
+};
+export declare const addEmailSender: (input: EmailAddSenderInput, options?: SendOptions | undefined) => Effect.Effect<{
+    readonly id: string & import("effect/Brand").Brand<"EmailSenderId">;
+    readonly email: string;
+    readonly status: "failed" | "pending" | "verified";
+    readonly providerLifecycle: "active" | "deleting" | "failed" | "provisioning";
+    readonly providerFailureCode: string | null;
+    readonly createdAt: string;
+}, import("..").ConflictError | import("..").ExternalServiceError | import("..").ForbiddenError | import("..").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("..").InternalError | import("..").ResourceNotFoundError | import("effect/Schema").SchemaError | import("..").UnauthorizedError | import("..").ValidationError, Service>;
+export {};

package/dist/effect/internal/email-sender.js

@@ -0,0 +1,21 @@
+import { replyToEmailsPayload } from "../../normalize.js";
+import { generateIdempotencyKey, withRetry } from "../retry.js";
+import { callEndpoint, stripUndefined } from "./operation.js";
+import { EmailGroup } from "../generated/email.js";
+import { Effect } from "effect";
+//#region src/effect/internal/email-sender.ts
+const addEmailSender = Effect.fn("Email.addSender")(function* (input, options) {
+	const idempotencyKey = options?.idempotencyKey ?? (yield* generateIdempotencyKey);
+	const { replyToEmails, ...sender } = input;
+	return yield* withRetry(callEndpoint(EmailGroup, "emailAddSender", {
+		headers: { "idempotency-key": idempotencyKey },
+		payload: stripUndefined({
+			...sender,
+			...replyToEmailsPayload(replyToEmails)
+		})
+	}));
+});
+//#endregion
+export { addEmailSender };
+
+//# sourceMappingURL=email-sender.js.map

package/dist/effect/internal/mailbox-events.js

@@ -0,0 +1,33 @@
+import { MailboxEventStream, MailboxEventStreamError } from "../../mailbox-events.js";
+import { Service } from "./client.js";
+import { Cause, Effect, Exit, Stream } from "effect";
+//#region src/effect/internal/mailbox-events.ts
+const toStreamError = (cause) => cause instanceof MailboxEventStreamError ? cause : new MailboxEventStreamError({
+	_tag: "StreamDisconnectedError",
+	message: String(cause)
+});
+/**
+* The organization's mailbox events as a stream, resuming from `cursor`. An event counts as handled
+* once the stream is pulled again, or once it ends successfully after the event (as `Stream.take`
+* does); a failure or interruption leaves the event in hand unacknowledged, so a resume repeats it.
+* The stream fails with a {@link MailboxEventStreamFailure}, which `Effect.catchTag` narrows by the
+* `_tag` of the host's refusal.
+*/
+const events = (options = {}) => Stream.scoped(Stream.unwrap(Effect.gen(function* () {
+	const client = yield* Service;
+	const iterator = (yield* Effect.acquireRelease(Effect.try({
+		try: () => new MailboxEventStream(client.connection, options),
+		catch: toStreamError
+	}), (opened, exit) => Effect.sync(() => {
+		if (Exit.isSuccess(exit)) opened.markHandled();
+		opened.close();
+	})))[Symbol.asyncIterator]();
+	return Stream.fromEffectRepeat(Effect.tryPromise({
+		try: () => iterator.next(),
+		catch: toStreamError
+	}).pipe(Effect.flatMap((next) => next.done ? Cause.done() : Effect.succeed(next.value))));
+})));
+//#endregion
+export { events };
+
+//# sourceMappingURL=mailbox-events.js.map

package/dist/effect/internal/operation.d.ts

@@ -1,10 +1,9 @@
 import { type Brand, Effect, Redacted, Stream } from "effect";
-import { type MediaUploadError } from "../../inline-attachments";
+import type { HttpApiGroup } from "effect/http-api";
 import { SDK_OPERATION_CALLS } from "../../service-map";
-import { SendMessagePayload } from "../generated";
 import { type FlatRaw, type Operation, Service } from "./client";
-type SdkOperation = keyof typeof SDK_OPERATION_CALLS & Operation;
-type MethodReturn<Method> = Method extends (...args: infer _Args) => infer Return ? Return : never;
+export type SdkOperation = keyof typeof SDK_OPERATION_CALLS & Operation;
+export type MethodReturn<Method> = Method extends (...args: infer _Args) => infer Return ? Return : never;
 type Wire<Value> = Value extends string ? Value extends Brand.Brand<string> ? string : Value : Value extends Redacted.Redacted<infer Raw> ? Raw | Value : Value extends number | boolean | bigint | symbol | null | undefined ? Value : Value extends Date ? Value : Value extends ReadonlyArray<infer Item> ? ReadonlyArray<Wire<Item>> : Value extends object ? {
     readonly [Key in keyof Value]: Wire<Value[Key]> | ({} extends Pick<Value, Key> ? undefined : never);
 } : Value;
@@ -15,7 +14,7 @@ type FlattenRequest<Request> = (Request extends {
 } ? Query : unknown) & (Request extends {
     readonly payload: infer Payload;
 } ? Payload : unknown);
-type RequestArg<Method> = Method extends (request: infer Request, ...rest: ReadonlyArray<unknown>) => unknown ? Request : never;
+export type RequestArg<Method> = Method extends (request: infer Request, ...rest: ReadonlyArray<unknown>) => unknown ? Request : never;
 type Input<Name extends SdkOperation> = Wire<FlattenRequest<NonNullable<RequestArg<FlatRaw[Name]>>>>;
 type IdempotencyKeyField<Request> = Request extends {
     readonly headers: {
@@ -52,71 +51,12 @@ type PaginationCompanions<Parameters, A, E, R> = {} extends Parameters ? {
     readonly items: (input: Parameters) => Stream.Stream<EnvelopeItem<A>, E, R>;
 };
 type WithPagination<Method> = Method extends (input: infer Parameters) => Effect.Effect<infer A, infer E, infer R> ? IsPaginated<A> extends true ? Method & PaginationCompanions<Parameters, A, E, R> : Method : Method;
-export declare const make: <Name extends SdkOperation>(operationName: Name) => WithPagination<OperationFunction<Name>>;
-type MessagePayload = typeof SendMessagePayload.Encoded;
-type MessageRecipient = MessagePayload["to"][number];
-type ContactObjectRecipient = {
-    readonly id: string;
-};
-type ErgonomicMessageRecipient = MessageRecipient | ContactObjectRecipient | string;
-type EmailPayload = Extract<MessagePayload, {
-    readonly channel: "email";
-}>;
-type ErgonomicReplyTo = string | ReadonlyArray<string>;
-type ErgonomicEmailList = string | ReadonlyArray<string>;
-type ErgonomicEmailContent = Omit<EmailPayload["email"], "replyTo"> & {
-    readonly replyTo?: ErgonomicReplyTo | null | undefined;
-};
-export interface SendOptions {
-    readonly idempotencyKey?: string;
-}
-export type MessageSendInput = Omit<EmailPayload, "to" | "cc" | "bcc" | "email"> & {
-    readonly to: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient>;
-    readonly cc?: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient> | null;
-    readonly bcc?: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient> | null;
-    readonly email: ErgonomicEmailContent;
-};
-export type EmailSendInput = Omit<EmailPayload, "channel" | "email" | "to" | "cc" | "bcc"> & ErgonomicEmailContent & {
-    readonly to: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient>;
-    readonly cc?: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient>;
-    readonly bcc?: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient>;
-};
-type SendResult = MethodReturn<FlatRaw["messagesSend"]>;
-type UploadFailure = MediaUploadError | Effect.Error<SendResult>;
-export declare const sendMessage: (input: MessageSendInput, options?: SendOptions | undefined) => Effect.Effect<{
-    readonly id: string & Brand.Brand<"MessageId">;
-    readonly status: "bounced" | "complained" | "delivered" | "failed" | "pending" | "processing" | "queued" | "read" | "scheduled" | "sent";
-    readonly waitReason: "campaign-paused" | "content-review" | "daily-quota" | "domain-health" | "domain-warming" | "onboarding-review" | "rate" | "retry" | "screening-unavailable" | "sending-paused" | "upstream-unavailable" | null;
-    readonly reviewExpectedAt: string | null;
-    readonly skippedRecipients: readonly {
-        readonly address: string;
-        readonly reason: "bounce" | "complaint" | "group-unsubscribe" | "manual" | "unsubscribe";
-        readonly unsubscribeGroupId?: (string & Brand.Brand<"UnsubscribeId">) | null;
-    }[];
-    readonly createdAt: string;
-}, UploadFailure, Service>;
-export declare const sendEmail: (input: EmailSendInput, options?: SendOptions | undefined) => Effect.Effect<{
-    readonly id: string & Brand.Brand<"MessageId">;
-    readonly status: "bounced" | "complained" | "delivered" | "failed" | "pending" | "processing" | "queued" | "read" | "scheduled" | "sent";
-    readonly waitReason: "campaign-paused" | "content-review" | "daily-quota" | "domain-health" | "domain-warming" | "onboarding-review" | "rate" | "retry" | "screening-unavailable" | "sending-paused" | "upstream-unavailable" | null;
-    readonly reviewExpectedAt: string | null;
-    readonly skippedRecipients: readonly {
-        readonly address: string;
-        readonly reason: "bounce" | "complaint" | "group-unsubscribe" | "manual" | "unsubscribe";
-        readonly unsubscribeGroupId?: (string & Brand.Brand<"UnsubscribeId">) | null;
-    }[];
-    readonly createdAt: string;
-}, UploadFailure, Service>;
-type AddSenderRequest = NonNullable<RequestArg<FlatRaw["emailAddSender"]>>;
-export type EmailAddSenderInput = Omit<AddSenderRequest["payload"], "replyToEmails"> & {
-    readonly replyToEmails?: ErgonomicEmailList | null | undefined;
-};
-export declare const addEmailSender: (input: EmailAddSenderInput, options?: SendOptions | undefined) => Effect.Effect<{
-    readonly id: string & Brand.Brand<"EmailSenderId">;
-    readonly email: string;
-    readonly status: "failed" | "pending" | "verified";
-    readonly providerLifecycle: "active" | "deleting" | "failed" | "provisioning";
-    readonly providerFailureCode: string | null;
-    readonly createdAt: string;
-}, import("..").ConflictError | import("..").ExternalServiceError | import("..").ForbiddenError | import("..").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("..").InternalError | import("..").ResourceNotFoundError | import("effect/Schema").SchemaError | import("..").UnauthorizedError | import("..").ValidationError, Service>;
+export declare const stripUndefined: <Value>(input: Value) => Value;
+/**
+ * Operation factory for one API group. Each domain module binds its own group, so importing it
+ * loads that group's schemas and nothing else.
+ */
+export declare const forGroup: (group: HttpApiGroup.Constraint) => <Name extends SdkOperation>(operationName: Name) => WithPagination<OperationFunction<Name>>;
+/** Call one endpoint with an already-shaped request, outside the direct-operation adapter. */
+export declare const callEndpoint: (group: HttpApiGroup.Constraint, name: SdkOperation, request: unknown) => Effect.Effect<unknown, unknown, Service>;
 export {};

package/dist/effect/internal/operation.js

@@ -0,0 +1,116 @@
+import { SDK_OPERATION_CALLS } from "../../service-map.js";
+import { SamvaOperations } from "../generated-metadata.js";
+import { streamCursorItems, streamCursorPages } from "../pagination.js";
+import { withRetry } from "../retry.js";
+import { Service } from "./client.js";
+import { Effect, Predicate } from "effect";
+//#region src/effect/internal/operation.ts
+const READ_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD"]);
+const MODULE_NAMES = {
+	analytics: "Analytics",
+	apiKeys: "ApiKeys",
+	attachments: "Attachments",
+	brands: "Brands",
+	campaigns: "Campaigns",
+	contactGroups: "ContactGroups",
+	contacts: "Contacts",
+	conversations: "Conversations",
+	customFields: "CustomFields",
+	email: "Email",
+	extensions: "Extensions",
+	feedback: "Feedback",
+	mailboxes: "Mailboxes",
+	media: "Media",
+	messages: "Messages",
+	namespaces: "Namespaces",
+	operations: "Operations",
+	organizations: "Organizations",
+	scheduledMessages: "ScheduledMessages",
+	templates: "Templates",
+	unsubscribe: "UnsubscribeGroups",
+	webhooks: "Webhooks",
+	whoami: "Whoami"
+};
+const traceName = (operationName) => {
+	for (const [prefix, moduleName] of Object.entries(MODULE_NAMES)) {
+		if (!operationName.startsWith(prefix)) continue;
+		const method = operationName.slice(prefix.length);
+		return `${moduleName}.${method[0].toLowerCase()}${method.slice(1)}`;
+	}
+	return `Samva.${operationName}`;
+};
+const stripUndefined = (input) => {
+	if (!Predicate.isObject(input)) return input;
+	if (Array.isArray(input)) return input.map(stripUndefined);
+	if (Object.getPrototypeOf(input) !== Object.prototype) return input;
+	return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0).map(([key, value]) => [key, stripUndefined(value)]));
+};
+const adapt = (operationName, rawCall, input) => {
+	const descriptor = SDK_OPERATION_CALLS[operationName];
+	const call = READ_METHODS.has(SamvaOperations[operationName].method) ? (request) => withRetry(rawCall(request)) : rawCall;
+	if (descriptor.kind === "none") return call();
+	if (descriptor.kind === "params") return call({ query: stripUndefined(input) });
+	if (descriptor.kind === "payload") return call({ payload: stripUndefined(input) });
+	if (descriptor.kind === "idempotentPayload") {
+		const { idempotencyKey, ...payload } = input;
+		return call({
+			headers: { "idempotency-key": idempotencyKey },
+			payload: stripUndefined(payload)
+		});
+	}
+	const pathDescriptor = descriptor;
+	const inputRecord = input ?? {};
+	const params = {};
+	for (const path of pathDescriptor.paths) {
+		if (inputRecord[path] === void 0) return Effect.die(/* @__PURE__ */ new Error(`${operationName} requires path field ${path}`));
+		params[path] = inputRecord[path];
+	}
+	if (pathDescriptor.kind === "path") return call({ params });
+	if (pathDescriptor.kind === "idempotentPath") return call({
+		params,
+		headers: { "idempotency-key": inputRecord.idempotencyKey }
+	});
+	const optionalKeyHeaders = { headers: inputRecord.idempotencyKey === void 0 ? {} : { "idempotency-key": inputRecord.idempotencyKey } };
+	if (pathDescriptor.kind === "optionalIdempotentPath") return call({
+		params,
+		...optionalKeyHeaders
+	});
+	const headerKey = pathDescriptor.kind === "optionalIdempotentPathPayload";
+	const remainingInput = stripUndefined(Object.fromEntries(Object.entries(inputRecord).filter(([key]) => !pathDescriptor.paths.includes(key) && !(headerKey && key === "idempotencyKey"))));
+	if (pathDescriptor.kind === "optionalIdempotentPathPayload") return call({
+		params,
+		payload: remainingInput,
+		...optionalKeyHeaders
+	});
+	return call({
+		params,
+		[pathDescriptor.kind === "pathParams" ? "query" : "payload"]: remainingInput
+	});
+};
+const isCursorPageEnvelope = (value) => Predicate.isObject(value) && Array.isArray(value.items) && (value.nextCursor === null || typeof value.nextCursor === "string");
+/**
+* Operation factory for one API group. Each domain module binds its own group, so importing it
+* loads that group's schemas and nothing else.
+*/
+const forGroup = (group) => (operationName) => {
+	if (SamvaOperations[operationName].group !== group.identifier) throw new Error(`${operationName} is not an endpoint of ${group.identifier}`);
+	return make(group, operationName);
+};
+/** Call one endpoint with an already-shaped request, outside the direct-operation adapter. */
+const callEndpoint = (group, name, request) => Effect.flatMap(Service, (client) => Effect.flatMap(client.endpoint(group, name), (call) => call(request)));
+const make = (group, operationName) => {
+	const call = Effect.fn(traceName(operationName))((input) => Effect.flatMap(Service, (client) => Effect.flatMap(client.endpoint(group, operationName), (rawCall) => adapt(operationName, rawCall, input))));
+	const operation = call;
+	if (SamvaOperations[operationName].paginated) {
+		const list = (input) => Effect.filterOrElse(call(input), isCursorPageEnvelope, () => Effect.die(/* @__PURE__ */ new Error(`${operationName} did not return a cursor page envelope`)));
+		Object.assign(operation, {
+			pages: (input) => streamCursorPages(list, input ?? {}),
+			items: (input) => streamCursorItems(list, input ?? {})
+		});
+	}
+	return operation;
+};
+//#endregion
+export { callEndpoint, forGroup, stripUndefined };
+
+//# sourceMappingURL=operation.js.map

package/dist/effect/internal/send.d.ts

@@ -0,0 +1,60 @@
+import { Effect } from "effect";
+import { type MediaUploadError } from "../../inline-attachments";
+import type { SendMessagePayload } from "../generated/scheduled-messages";
+import { type FlatRaw, Service } from "./client";
+import { type MethodReturn } from "./operation";
+type MessagePayload = typeof SendMessagePayload.Encoded;
+export type MessageRecipient = MessagePayload["to"][number];
+type ContactObjectRecipient = {
+    readonly id: string;
+};
+type ErgonomicMessageRecipient = MessageRecipient | ContactObjectRecipient | string;
+type EmailPayload = Extract<MessagePayload, {
+    readonly channel: "email";
+}>;
+type ErgonomicReplyTo = string | ReadonlyArray<string>;
+export type ErgonomicEmailList = string | ReadonlyArray<string>;
+type ErgonomicEmailContent = Omit<EmailPayload["email"], "replyTo"> & {
+    readonly replyTo?: ErgonomicReplyTo | null | undefined;
+};
+export interface SendOptions {
+    readonly idempotencyKey?: string;
+}
+export type MessageSendInput = Omit<EmailPayload, "to" | "cc" | "bcc" | "email"> & {
+    readonly to: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient>;
+    readonly cc?: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient> | null;
+    readonly bcc?: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient> | null;
+    readonly email: ErgonomicEmailContent;
+};
+export type EmailSendInput = Omit<EmailPayload, "channel" | "email" | "to" | "cc" | "bcc"> & ErgonomicEmailContent & {
+    readonly to: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient>;
+    readonly cc?: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient>;
+    readonly bcc?: ErgonomicMessageRecipient | ReadonlyArray<ErgonomicMessageRecipient>;
+};
+type SendResult = MethodReturn<FlatRaw["messagesSend"]>;
+type UploadFailure = MediaUploadError | Effect.Error<SendResult>;
+export declare const sendMessage: (input: MessageSendInput, options?: SendOptions | undefined) => Effect.Effect<{
+    readonly id: string & import("effect/Brand").Brand<"MessageId">;
+    readonly status: "bounced" | "complained" | "delivered" | "failed" | "pending" | "processing" | "queued" | "read" | "scheduled" | "sent";
+    readonly waitReason: "campaign-paused" | "content-review" | "daily-quota" | "domain-health" | "domain-warming" | "onboarding-review" | "rate" | "retry" | "screening-unavailable" | "sending-paused" | "upstream-unavailable" | null;
+    readonly reviewExpectedAt: string | null;
+    readonly skippedRecipients: readonly {
+        readonly address: string;
+        readonly reason: "bounce" | "complaint" | "group-unsubscribe" | "manual" | "unsubscribe";
+        readonly unsubscribeGroupId?: (string & import("effect/Brand").Brand<"UnsubscribeId">) | null;
+    }[];
+    readonly createdAt: string;
+}, UploadFailure, Service>;
+export declare const sendEmail: (input: EmailSendInput, options?: SendOptions | undefined) => Effect.Effect<{
+    readonly id: string & import("effect/Brand").Brand<"MessageId">;
+    readonly status: "bounced" | "complained" | "delivered" | "failed" | "pending" | "processing" | "queued" | "read" | "scheduled" | "sent";
+    readonly waitReason: "campaign-paused" | "content-review" | "daily-quota" | "domain-health" | "domain-warming" | "onboarding-review" | "rate" | "retry" | "screening-unavailable" | "sending-paused" | "upstream-unavailable" | null;
+    readonly reviewExpectedAt: string | null;
+    readonly skippedRecipients: readonly {
+        readonly address: string;
+        readonly reason: "bounce" | "complaint" | "group-unsubscribe" | "manual" | "unsubscribe";
+        readonly unsubscribeGroupId?: (string & import("effect/Brand").Brand<"UnsubscribeId">) | null;
+    }[];
+    readonly createdAt: string;
+}, UploadFailure, Service>;
+export {};

package/dist/effect/internal/send.js

@@ -0,0 +1,56 @@
+import { mediaCreateBody, planInlineUploads, withUploadedAttachments } from "../../inline-attachments.js";
+import { buildEmailSendPayload, buildMessagesSendPayload } from "../../normalize.js";
+import { generateIdempotencyKey, withRetry } from "../retry.js";
+import { Service } from "./client.js";
+import { callEndpoint, stripUndefined } from "./operation.js";
+import { MediaGroup } from "../generated/media.js";
+import { MessagesGroup } from "../generated/messages.js";
+import { Effect } from "effect";
+//#region src/effect/internal/send.ts
+/**
+* Inline attachment content over the API's request cap travels as media instead: the largest
+* attachments are uploaded (create, put to the presigned URL, complete) and replaced by their
+* `mediaId`. The returned payload is the one request every send attempt reuses, so nothing is
+* uploaded twice.
+*/
+const uploadOversizedAttachments = (client, payload) => Effect.gen(function* () {
+	const plan = planInlineUploads(payload);
+	if (plan.length === 0) return payload;
+	const uploaded = /* @__PURE__ */ new Map();
+	for (const upload of plan) {
+		const created = yield* callEndpoint(MediaGroup, "mediaCreate", { payload: mediaCreateBody(upload) });
+		yield* client.putUpload({
+			filename: upload.filename,
+			mediaId: created.id,
+			url: created.upload.url,
+			method: created.upload.method,
+			headers: created.upload.headers,
+			bytes: upload.bytes
+		});
+		yield* callEndpoint(MediaGroup, "mediaComplete", { params: { id: created.id } });
+		uploaded.set(upload.index, {
+			mediaId: created.id,
+			upload
+		});
+	}
+	return withUploadedAttachments(payload, uploaded);
+});
+const sendPayload = (payload, options) => Effect.gen(function* () {
+	const client = yield* Service;
+	const idempotencyKey = options?.idempotencyKey ?? (yield* generateIdempotencyKey);
+	const prepared = yield* uploadOversizedAttachments(client, payload);
+	return yield* withRetry(callEndpoint(MessagesGroup, "messagesSend", {
+		payload: stripUndefined(prepared),
+		headers: { "idempotency-key": idempotencyKey }
+	}));
+});
+const sendMessage = Effect.fn("Messages.send")(function* (input, options) {
+	return yield* sendPayload(buildMessagesSendPayload(input), options);
+});
+const sendEmail = Effect.fn("Email.send")(function* (input, options) {
+	return yield* sendPayload(buildEmailSendPayload(input), options);
+});
+//#endregion
+export { sendEmail, sendMessage };
+
+//# sourceMappingURL=send.js.map