@mantaq/sugar 2.0.0 → 2.0.2

package/README.md

@@ -387,6 +387,36 @@ withPromise(fetchData(), input.signal, input.emit, {
 });
 ```
 
+#### Errors as values
+
+When a port returns `Promise<Either<PortError, Loaded>>`, map the result with `Either.match` inside `success`. No new helper is needed, and both branches stay typed without a cast:
+
+```ts
+import { Either } from "@mantaq/utils";
+import { withPromise } from "@mantaq/sugar";
+
+m.effect(loading, {
+  name: "load",
+  sends: [loaded, failed, loadRejected],
+  fn: (input) =>
+    withPromise({
+      promise: port.load(),
+      signal: input.signal,
+      emit: input.emit,
+      events: {
+        success: (result) =>
+          Either.match(result, {
+            onLeft: (e): LoadEvent => failed.create(e), // e: PortError
+            onRight: (v): LoadEvent => loaded.create(v), // v: Loaded
+          }),
+        error: (err) => loadRejected.create({ message: String(err) }),
+      },
+    }),
+});
+```
+
+`LoadEvent` is the union of the two event shapes; annotating both handlers with it lets `Either.match` infer one result type. A rejected promise still goes through `error`, and an effect aborted before the promise settles emits nothing. See `src/effects/promise.either.test.ts`.
+
 ### `withTimeout(ms, input, eventFn)`
 
 Schedule a timeout event through the actor's clock. Aborts cleanly if the actor is destroyed before timeout fires.

package/dist/index.d.mts

@@ -99,7 +99,7 @@ interface WithPromiseOptions<T, Emit = AnyEvent> {
   };
 }
 export declare function withPromise<T, Emit = AnyEvent>(options: WithPromiseOptions<T, Emit>): Promise<void>;
-export declare function withTimeout<ActorContext, Payload = unknown, Emit = InternalEvent>(durationMs: number, options: {
+export declare function withTimeout<ActorContext, Payload = unknown, Emit extends InternalEvent = InternalEvent>(durationMs: number, options: {
   input: EffectInput<ActorContext, Payload, Emit>;
   event: () => NoInfer<Emit>;
 }): void;

package/dist/index.mjs

@@ -154,6 +154,7 @@ function withTimeout(durationMs, options) {
 	const { input, event } = options;
 	input.clock.setTimeout(durationMs, {
 		signal: input.signal,
+		eventName: event().type,
 		cb: () => {
 			if (input.signal.aborted) return;
 			input.emit(event());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mantaq/sugar",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Userland sugar for mantaq actors — matches, effect helpers, transition utilities.",
   "license": "MIT",
   "repository": {
@@ -20,7 +20,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@mantaq/core": "0.5.0"
+    "@mantaq/core": "0.5.2"
   },
   "devDependencies": {
     "@stryker-mutator/core": "^10",
@@ -32,7 +32,8 @@
     "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0",
     "vite-plus": "1.4.0",
     "vitest": "5.0.5",
-    "@mantaq/pbt": "0.0.3"
+    "@mantaq/pbt": "0.0.3",
+    "@mantaq/utils": "0.0.4"
   },
   "scripts": {
     "build": "vp pack",