samva 0.0.1 → 0.2.0

package/dist/operation-Ccqh_yxb.js

@@ -0,0 +1,596 @@
+import { n as buildMessagesSendPayload, r as replyToEmailsPayload, t as buildEmailSendPayload } from "./normalize-LkWl4HUF.js";
+import { _ as SamvaApi, t as Service } from "./client-BqkU-sFv.js";
+import { generateIdempotencyKey, withRetry } from "./effect/retry.js";
+import { Effect, Option, Predicate, Stream } from "effect";
+//#region src/service-map.ts
+/** How each generated Effect operation is adapted to the Promise facade's direct input shape. */
+const SDK_OPERATION_CALLS = {
+	designGet: { kind: "none" },
+	designUpdate: { kind: "payload" },
+	operationsList: { kind: "params" },
+	operationsGet: {
+		kind: "path",
+		paths: ["operationId"]
+	},
+	operationsRetry: {
+		kind: "path",
+		paths: ["operationId"]
+	},
+	messagesList: { kind: "params" },
+	messagesSend: { kind: "payload" },
+	messagesGet: {
+		kind: "path",
+		paths: ["id"]
+	},
+	messagesGetEmail: {
+		kind: "pathParams",
+		paths: ["id"]
+	},
+	messagesRemove: {
+		kind: "path",
+		paths: ["id"]
+	},
+	messagesGetStatus: {
+		kind: "path",
+		paths: ["id"]
+	},
+	messagesGetEvents: {
+		kind: "path",
+		paths: ["id"]
+	},
+	scheduledMessagesList: { kind: "params" },
+	scheduledMessagesCreate: { kind: "payload" },
+	scheduledMessagesGet: {
+		kind: "path",
+		paths: ["id"]
+	},
+	scheduledMessagesCancel: {
+		kind: "path",
+		paths: ["id"]
+	},
+	campaignsList: { kind: "params" },
+	campaignsCreate: { kind: "payload" },
+	campaignsGet: {
+		kind: "path",
+		paths: ["id"]
+	},
+	campaignsArchive: {
+		kind: "path",
+		paths: ["id"]
+	},
+	campaignsUpdate: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	campaignsListRuns: {
+		kind: "pathParams",
+		paths: ["id"]
+	},
+	campaignsScheduleRun: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	campaignsGetRun: {
+		kind: "path",
+		paths: ["id", "runId"]
+	},
+	campaignsPauseRun: {
+		kind: "path",
+		paths: ["id", "runId"]
+	},
+	campaignsResumeRun: {
+		kind: "path",
+		paths: ["id", "runId"]
+	},
+	campaignsCancelRun: {
+		kind: "path",
+		paths: ["id", "runId"]
+	},
+	campaignsListRecipients: {
+		kind: "pathParams",
+		paths: ["id", "runId"]
+	},
+	emailListDomains: { kind: "params" },
+	emailGetTrackingDefaults: { kind: "none" },
+	emailUpdateTrackingDefaults: { kind: "payload" },
+	emailGetRecipientTrackingPreference: { kind: "params" },
+	emailUpdateRecipientTrackingPreference: { kind: "payload" },
+	emailAddDomain: { kind: "payload" },
+	emailGetDomainVerification: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailAdvanceDomainVerification: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailGetDomainById: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailRemoveDomain: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailSetDefaultDomain: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailSetDomainDefaultSender: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailClearDomainDefaultSender: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailUpdateDomainConfig: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailDetectRegistrar: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailGetDomainConnect: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailBuildDomainConnectApplyUrl: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailCompleteDomainConnect: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailEnableReceiving: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailEnableCustomTracking: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailGetCustomTracking: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailGetCustomTrackingDomainConnect: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailBuildCustomTrackingDomainConnectApplyUrl: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailCompleteCustomTrackingDomainConnect: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailDisableCustomTracking: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailListSenders: { kind: "params" },
+	emailAddSender: { kind: "payload" },
+	emailCheckSenderVerification: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailRemoveSender: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailSetDefaultSender: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailGetStats: { kind: "params" },
+	emailEnableCatchAll: { kind: "payload" },
+	emailDisableCatchAll: { kind: "payload" },
+	emailGetCatchAllConfig: { kind: "params" },
+	emailUpdateCatchAllConfig: { kind: "payload" },
+	emailGetCatchAllStats: { kind: "params" },
+	emailListSuppressions: { kind: "params" },
+	emailRemoveSuppression: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailListBlocks: { kind: "params" },
+	emailAddBlock: { kind: "payload" },
+	emailRemoveBlock: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailUpdateBlock: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailGetBlockLogs: { kind: "params" },
+	emailCheckBlocked: { kind: "payload" },
+	emailListForwardingRules: { kind: "params" },
+	emailCreateForwardingRule: { kind: "payload" },
+	emailDeleteForwardingRule: {
+		kind: "path",
+		paths: ["id"]
+	},
+	emailUpdateForwardingRule: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	emailGetForwardingLog: { kind: "params" },
+	conversationsList: { kind: "params" },
+	conversationsCreate: { kind: "payload" },
+	conversationsGetById: {
+		kind: "path",
+		paths: ["id"]
+	},
+	conversationsListMessages: {
+		kind: "pathParams",
+		paths: ["id"]
+	},
+	conversationsUpdate: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	conversationsAddContacts: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	conversationsRemoveContacts: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	contactsList: { kind: "params" },
+	contactsCreate: { kind: "payload" },
+	contactsFind: { kind: "payload" },
+	contactsFindOrCreate: { kind: "payload" },
+	contactsGet: {
+		kind: "path",
+		paths: ["id"]
+	},
+	contactsRemove: {
+		kind: "path",
+		paths: ["id"]
+	},
+	contactsUpdate: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	contactsGetEngagement: {
+		kind: "path",
+		paths: ["id"]
+	},
+	contactsBulkImport: { kind: "payload" },
+	contactsBulkDelete: { kind: "payload" },
+	contactsBulkUpdateTags: { kind: "payload" },
+	contactsBulkUpdateStatus: { kind: "payload" },
+	contactsExport: { kind: "payload" },
+	contactsGetActivityTimeline: {
+		kind: "pathParams",
+		paths: ["id"]
+	},
+	contactsGetGroupMemberships: {
+		kind: "path",
+		paths: ["id"]
+	},
+	templatesList: { kind: "params" },
+	templatesCreate: { kind: "payload" },
+	templatesListDashboard: { kind: "params" },
+	templatesListFamilies: { kind: "params" },
+	templatesCreateFamily: { kind: "payload" },
+	templatesGetFamily: {
+		kind: "path",
+		paths: ["familyId"]
+	},
+	templatesDeleteFamily: {
+		kind: "path",
+		paths: ["familyId"]
+	},
+	templatesRenameFamily: {
+		kind: "pathPayload",
+		paths: ["familyId"]
+	},
+	templatesCreateFamilyFromTemplate: {
+		kind: "pathPayload",
+		paths: ["templateId"]
+	},
+	templatesAttachFamilyMember: {
+		kind: "path",
+		paths: ["familyId", "templateId"]
+	},
+	templatesDetachFamilyMember: {
+		kind: "path",
+		paths: ["familyId", "templateId"]
+	},
+	templatesAddFamilyChannel: {
+		kind: "path",
+		paths: ["familyId", "channel"]
+	},
+	templatesGetById: {
+		kind: "path",
+		paths: ["id"]
+	},
+	templatesRemove: {
+		kind: "path",
+		paths: ["id"]
+	},
+	templatesUpdate: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	templatesApprove: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	templateDocumentsBootstrap: { kind: "payload" },
+	templateDocumentsGet: {
+		kind: "path",
+		paths: ["templateId"]
+	},
+	templateDocumentsReplace: {
+		kind: "pathPayload",
+		paths: ["templateId"]
+	},
+	templateDocumentsSave: {
+		kind: "pathPayload",
+		paths: ["templateId"]
+	},
+	templateDocumentsRender: {
+		kind: "pathPayload",
+		paths: ["templateId"]
+	},
+	templateDocumentsSpamCheck: {
+		kind: "pathPayload",
+		paths: ["templateId"]
+	},
+	templateDocumentsTestSend: {
+		kind: "pathPayload",
+		paths: ["templateId"]
+	},
+	templateDocumentsVersions: {
+		kind: "path",
+		paths: ["templateId"]
+	},
+	templateDocumentsPublish: {
+		kind: "path",
+		paths: ["templateId"]
+	},
+	templateDocumentsUnpublish: {
+		kind: "path",
+		paths: ["templateId"]
+	},
+	templateDocumentsRestore: {
+		kind: "pathPayload",
+		paths: ["templateId", "versionId"]
+	},
+	webhooksList: { kind: "params" },
+	webhooksCreate: { kind: "payload" },
+	webhooksGet: {
+		kind: "path",
+		paths: ["id"]
+	},
+	webhooksRemove: {
+		kind: "path",
+		paths: ["id"]
+	},
+	webhooksUpdate: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	webhooksTest: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	webhooksGetLogs: {
+		kind: "pathParams",
+		paths: ["webhookId"]
+	},
+	webhooksGetStats: {
+		kind: "pathParams",
+		paths: ["webhookId"]
+	},
+	webhooksRetryDelivery: {
+		kind: "pathPayload",
+		paths: ["webhookId"]
+	},
+	webhooksRegenerateSecret: {
+		kind: "path",
+		paths: ["webhookId"]
+	},
+	organizationsBootstrap: { kind: "payload" },
+	organizationsCreate: { kind: "payload" },
+	organizationsGet: { kind: "none" },
+	organizationsUpdate: { kind: "payload" },
+	organizationsGetUsage: { kind: "params" },
+	organizationsDelete: { kind: "idempotentPayload" },
+	apiKeysList: { kind: "params" },
+	apiKeysCreate: { kind: "payload" },
+	apiKeysGet: {
+		kind: "path",
+		paths: ["id"]
+	},
+	apiKeysRevoke: {
+		kind: "path",
+		paths: ["id"]
+	},
+	apiKeysUpdate: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
+	apiKeysRotate: {
+		kind: "path",
+		paths: ["id"]
+	},
+	apiKeysRemove: {
+		kind: "path",
+		paths: ["id"]
+	},
+	apiKeysGetStats: {
+		kind: "pathParams",
+		paths: ["id"]
+	},
+	apiKeysGetActivity: {
+		kind: "pathParams",
+		paths: ["id"]
+	}
+};
+//#endregion
+//#region src/effect/pagination.ts
+/**
+* Stream pagination for the Effect SDK.
+*
+* Every list operation whose success value is the uniform page envelope —
+* `{ items, pagination: { page, limit, total, totalPages } }` — gains `.pages()`
+* and `.items()` companions on its domain operation. `.pages()`
+* streams the raw envelopes; `.items()` flattens them into a stream of items.
+*
+* The traversal is **lazy**: built on `Stream.paginate` (a pull-based source),
+* so each page is fetched only as the stream is consumed — `Stream.take(n)`
+* stops requesting further pages. Caller params (start `page`, `limit`, filters)
+* are respected; only `page` is advanced per step, and the walk stops once the
+* server-echoed `page` reaches `totalPages`.
+*
+* Retry is **not** re-applied here: the underlying domain operation is already
+* wrapped in the ambient {@link import("./retry").Service} policy (reads are
+* retry-safe), so each page fetch retries on its own and pagination composes
+* with retry instead of nesting retries.
+*/
+/** The next page number, or `none` once the last page has been yielded. */
+const nextPage = (pagination) => pagination.page < pagination.totalPages ? Option.some(pagination.page + 1) : Option.none();
+/** Honor a caller-supplied start `page`; default to the first page otherwise. */
+const startPageOf = (input) => {
+	const page = input?.page;
+	const parsed = typeof page === "string" ? Number(page) : NaN;
+	return Number.isFinite(parsed) && parsed >= 1 ? parsed : 1;
+};
+/** Fetch one page at `page`, preserving all other caller params. */
+const fetchPage = (operation, input, page) => operation({
+	...input,
+	page: page.toString()
+});
+/** Stream the raw page envelopes, one per request, from the caller's start page. */
+const streamPages = (operation, input) => Stream.paginate(startPageOf(input), (page) => fetchPage(operation, input, page).pipe(Effect.map((result) => [[result], nextPage(result.pagination)])));
+/** Stream individual items across pages, fetching the next page only when pulled. */
+const streamItems = (operation, input) => Stream.paginate(startPageOf(input), (page) => fetchPage(operation, input, page).pipe(Effect.map((result) => [result.items, nextPage(result.pagination)])));
+//#endregion
+//#region src/effect/internal/operation.ts
+const hasField = (node, name) => node?.propertySignatures?.some((property) => property.name === name) ?? false;
+const isPaginatedSuccess = (success) => {
+	if (!(success instanceof Set)) return false;
+	for (const schema of success) for (const node of [
+		schema.ast,
+		schema.ast?.to,
+		schema.ast?.from
+	]) if (hasField(node, "items") && hasField(node, "pagination")) return true;
+	return false;
+};
+const paginatedOperations = () => {
+	const paginated = /* @__PURE__ */ new Set();
+	const groups = SamvaApi.groups;
+	for (const group of Object.values(groups)) for (const [name, endpoint] of Object.entries(group.endpoints)) if (isPaginatedSuccess(endpoint.success)) paginated.add(name);
+	return paginated;
+};
+const PAGINATED_OPERATIONS = paginatedOperations();
+const READ_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD"]);
+const readOperations = () => {
+	const reads = /* @__PURE__ */ new Set();
+	const groups = SamvaApi.groups;
+	for (const group of Object.values(groups)) for (const [name, endpoint] of Object.entries(group.endpoints)) if (READ_METHODS.has(endpoint.method)) reads.add(name);
+	return reads;
+};
+const READ_OPERATIONS = readOperations();
+const MODULE_NAMES = {
+	apiKeys: "ApiKeys",
+	campaigns: "Campaigns",
+	contacts: "Contacts",
+	conversations: "Conversations",
+	design: "Design",
+	email: "Email",
+	messages: "Messages",
+	operations: "Operations",
+	organizations: "Organizations",
+	scheduledMessages: "ScheduledMessages",
+	templates: "Templates",
+	webhooks: "Webhooks"
+};
+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 rawOperation = (client, name) => client.operation(name);
+const adapt = (operationName, rawCall, input) => {
+	const descriptor = SDK_OPERATION_CALLS[operationName];
+	const call = READ_OPERATIONS.has(operationName) ? (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 });
+	const remainingInput = stripUndefined(Object.fromEntries(Object.entries(inputRecord).filter(([key]) => !pathDescriptor.paths.includes(key))));
+	return call({
+		params,
+		[pathDescriptor.kind === "pathParams" ? "query" : "payload"]: remainingInput
+	});
+};
+const make = (operationName) => {
+	const operation = Effect.fn(traceName(operationName))((input) => Effect.flatMap(Service, (client) => adapt(operationName, rawOperation(client, operationName), input)));
+	if (PAGINATED_OPERATIONS.has(operationName)) {
+		const list = operation;
+		Object.assign(operation, {
+			pages: (input) => streamPages(list, input ?? {}),
+			items: (input) => streamItems(list, input ?? {})
+		});
+	}
+	return operation;
+};
+const sendPayload = (payload, options) => Effect.gen(function* () {
+	const client = yield* Service;
+	const idempotencyKey = options?.idempotencyKey ?? (yield* generateIdempotencyKey);
+	return yield* withRetry(rawOperation(client, "messagesSend")({
+		payload: stripUndefined(payload),
+		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);
+});
+const addEmailSender = Effect.fn("Email.addSender")(function* (input) {
+	const client = yield* Service;
+	const { replyToEmails, ...sender } = input;
+	return yield* rawOperation(client, "emailAddSender")({ payload: stripUndefined({
+		...sender,
+		...replyToEmailsPayload(replyToEmails)
+	}) });
+});
+//#endregion
+export { sendMessage as i, make as n, sendEmail as r, addEmailSender as t };
+
+//# sourceMappingURL=operation-Ccqh_yxb.js.map