samva 0.5.0 → 0.6.0

package/AGENTS.md

@@ -6,8 +6,9 @@ required.
 
 Effect applications should import Pascal-cased domain modules from focused subpaths such as
 `samva/effect/email` and provide `Client.layerFetch` from `samva/effect/client`. Install the optional
-peer `effect@4.0.0-rc.112` when using those entrypoints. Keep that exact release candidate pinned. Tagged API
-failures remain in the Effect error channel and can be handled with `Effect.catchTag`.
+peer `effect` at the exact version this package's `peerDependencies` names when using those
+entrypoints; a different release candidate is unsupported. Tagged API failures remain in the
+Effect error channel and can be handled with `Effect.catchTag`.
 
 Treat exported request and response types as the API contract. Do not import package-internal files
 or generated implementation paths; use only the subpaths declared in `package.json`.

package/README.md

@@ -65,7 +65,7 @@ const messages = await client.messages.list({
 Install `effect` next to `samva` when using the Effect entrypoint:
 
 ```bash
-bun add samva effect@4.0.0-rc.112
+bun add samva effect@4.0.0-rc.117
 ```
 
 ```typescript
@@ -112,7 +112,7 @@ const client = createClient({
 - The token is user-scoped; send the target organization slug on every request via the `x-org-slug` header.
 - There is no SDK `orgSlug` helper — pass the header directly.
 
-For terminal workflows (`samva login`, `samva org use`, `samva email send --dry-run`), see the [`@samva/cli` README](https://github.com/AryaLabsHQ/samva/tree/main/packages/cli).
+For terminal workflows (`samva login`, `samva org use`, `samva email send --dry-run`), see [`@samva/cli`](https://www.npmjs.com/package/@samva/cli).
 
 The Promise and Effect clients identify their public SDK surface and package version with the
 advisory `x-samva-client` request header. Supply your own value in `headers`, or set the header to
@@ -122,10 +122,14 @@ advisory `x-samva-client` request header. Supply your own value in `headers`, or
 
 The Promise client exposes:
 
+- `analytics`
 - `apiKeys`
+- `attachments`
 - `campaigns`
+- `contactGroups`
 - `contacts`
 - `conversations`
+- `customFields`
 - `design`
 - `email`
 - `media`
@@ -134,14 +138,19 @@ The Promise client exposes:
 - `organizations`
 - `scheduledMessages`
 - `templates`
+- `unsubscribeGroups`
 - `webhooks`
 
 The Effect SDK exposes Pascal-cased domain modules with lower-camel operations:
 
+- `Analytics`
 - `ApiKeys`
+- `Attachments`
 - `Campaigns`
+- `ContactGroups`
 - `Contacts`
 - `Conversations`
+- `CustomFields`
 - `Design`
 - `Email`
 - `Media`
@@ -150,6 +159,7 @@ The Effect SDK exposes Pascal-cased domain modules with lower-camel operations:
 - `Organizations`
 - `ScheduledMessages`
 - `Templates`
+- `UnsubscribeGroups`
 - `Webhooks`
 
 Effect operations take direct parameter objects: body, path, and query fields are not wrapped in `payload` or `params` envelopes. Import the modules you use from `samva/effect/<lower-kebab>` and provide `Client.layerFetch` once at the program boundary. `Client.raw` exposes the underlying generated client for advanced access, but ordinary workflows do not require it.

package/dist/{categories-B9Nw2v_F.js → categories-4u9Az4No.js}

@@ -2,6 +2,10 @@ import { Effect } from "effect";
 import * as Predicate$1 from "effect/Predicate";
 //#region src/effect/generated-metadata.ts
 const SamvaErrorMetadata = {
+	AnalyticsQueryError: {
+		categories: [],
+		retryable: false
+	},
 	BillingProviderError: {
 		categories: ["transient"],
 		retryable: true
@@ -10,6 +14,10 @@ const SamvaErrorMetadata = {
 		categories: ["conflict"],
 		retryable: false
 	},
+	DeliveryUnavailableError: {
+		categories: ["transient"],
+		retryable: true
+	},
 	EmailChannelError: {
 		categories: [],
 		retryable: false
@@ -26,6 +34,10 @@ const SamvaErrorMetadata = {
 		categories: ["auth"],
 		retryable: false
 	},
+	GatewayTimeoutError: {
+		categories: ["transient"],
+		retryable: true
+	},
 	InternalError: {
 		categories: ["transient"],
 		retryable: true
@@ -53,10 +65,6 @@ const SamvaErrorMetadata = {
 	ValidationError: {
 		categories: ["validation"],
 		retryable: false
-	},
-	WebhookEnqueueError: {
-		categories: ["transient"],
-		retryable: true
 	}
 };
 //#endregion
@@ -118,7 +126,7 @@ const isRequestTransportError = (error) => {
 	const reason = error.reason;
 	return Predicate$1.isObject(reason) && Predicate$1.isTagged(reason, "TransportError");
 };
-/** True for transient failures, including raw request-transport errors (D4). */
+/** True for transient failures, including raw request-transport errors. */
 const isTransient = (error) => hasCategory(error, "transient") || isRequestTransportError(error);
 /** True when an error is declared safe to retry (throttling / transient / transport). */
 const isRetryable = (error) => isRetryableError(error) || isRequestTransportError(error);
@@ -128,7 +136,15 @@ const isRetryable = (error) => isRetryableError(error) || isRequestTransportErro
 * category — while only total-membership classes are narrowed out of the error
 * channel (`EmailChannelError` stays: instances with other reasons pass through).
 */
-const catchCategory = (category, handler) => (effect) => Effect.catchIf(effect, (error) => hasCategory(error, category), handler);
+const catchCategory = (category, handler) => (effect) => {
+	const inCategory = (error) => hasCategory(error, category);
+	const outsideCategory = (error) => !hasCategory(error, category);
+	return Effect.catch(effect, (error) => {
+		if (inCategory(error)) return handler(error);
+		if (outsideCategory(error)) return Effect.fail(error);
+		return Effect.die(error);
+	});
+};
 const catchAuthError = (handler) => catchCategory("auth", handler);
 const catchValidationError = (handler) => catchCategory("validation", handler);
 const catchNotFoundError = (handler) => catchCategory("notFound", handler);
@@ -140,8 +156,8 @@ const catchBillingError = (handler) => catchCategory("billing", handler);
 * fallback/degrade paths. The declared error channel is left intact because
 * transient covers untyped transport errors as well.
 */
-const catchTransient = (handler) => (effect) => Effect.catchIf(effect, (error) => isTransient(error), handler);
+const catchTransient = (handler) => (effect) => Effect.catchIf(effect, isTransient, handler);
 //#endregion
 export { isTransient as _, catchNotFoundError as a, catchValidationError as c, isAuthError as d, isBillingError as f, isThrottlingError as g, isRetryable as h, catchConflictError as i, categoriesOf as l, isNotFoundError as m, catchBillingError as n, catchThrottlingError as o, isConflictError as p, catchCategory as r, catchTransient as s, catchAuthError as t, hasCategory as u, isValidationError as v };
 
-//# sourceMappingURL=categories-B9Nw2v_F.js.map
+//# sourceMappingURL=categories-4u9Az4No.js.map