@astrale-os/sdk 0.5.0-beta.77 → 0.5.0-beta.78

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.5.0-beta.78](https://github.com/astrale-os/sdk/compare/sdk-v0.5.0-beta.77...sdk-v0.5.0-beta.78) (2026-08-29)
+
+
+### Features
+
+* **mutation:** support atomic transition deltas ([#331](https://github.com/astrale-os/sdk/issues/331)) ([0bf94fa](https://github.com/astrale-os/sdk/commit/0bf94fa8193cdc52047007f25cbf59e79f1f97b4))
+
 ## [0.5.0-beta.77](https://github.com/astrale-os/sdk/compare/sdk-v0.5.0-beta.76...sdk-v0.5.0-beta.77) (2026-08-29)
 
 

package/dist/application/mutation/authoring/transition.d.ts

@@ -3,7 +3,7 @@ import type { Domain, ResolvedClass } from '../../../platform/schema/index.js';
 import type { StatePropertiesOfClass } from '../../../platform/schema/state-property/index.js';
 import type { EventOf, StateMachine, StateOf } from '../../state/machine.js';
 import type { ExistingEndpoint } from './endpoint.js';
-import type { RichPropertyConditions, RichPropertyName } from './properties.js';
+import type { RichPropertyConditions, RichPropertyDelta, RichPropertyName } from './properties.js';
 export type StatePropertyName<Class extends ResolvedClass<'node'>> = Extract<keyof StatePropertiesOfClass<Class>, RichPropertyName<Class>>;
 export type StateMachineOf<Class extends ResolvedClass<'node'>, Property extends StatePropertyName<Class>> = Extract<StatePropertiesOfClass<Class>[Property], StateMachine>;
 export interface StateTransitionInput<Class extends ResolvedClass<'node'>, Property extends StatePropertyName<Class>, Machine extends StateMachineOf<Class, Property>, From extends StateOf<Machine>, Event extends EventOf<Machine, From>> {
@@ -13,5 +13,7 @@ export interface StateTransitionInput<Class extends ResolvedClass<'node'>, Prope
     readonly from: From;
     readonly event: Event;
     readonly props?: RichPropertyConditions<Class>;
+    /** Auxiliary property changes committed in the same compare-and-set as the state transition. */
+    readonly update?: RichPropertyDelta<Class>;
 }
 export declare function authorStateTransition<Class extends ResolvedClass<'node'>, Property extends StatePropertyName<Class>, Machine extends StateMachineOf<Class, Property>, From extends StateOf<Machine>, Event extends EventOf<Machine, From>>(core: MutationBuilder, domain: Domain, input: StateTransitionInput<Class, Property, Machine, From, Event>): void;

package/dist/application/mutation/authoring/transition.js

@@ -10,10 +10,15 @@ export function authorStateTransition(core, domain, input) {
     const fromState = input.from;
     const event = input.event;
     const suppliedProps = input.props;
+    const suppliedUpdate = input.update;
     const equals = suppliedProps?.equals;
     const absent = suppliedProps?.absent;
+    const set = suppliedUpdate?.set;
+    const unset = suppliedUpdate?.unset;
     const suppliedEquals = equals === undefined ? undefined : { ...equals };
     const suppliedAbsent = absent === undefined ? undefined : [...absent];
+    const suppliedSet = set === undefined ? undefined : { ...set };
+    const suppliedUnset = unset === undefined ? undefined : [...unset];
     const selected = resolvedProperty(selectedClass, property);
     const selectedClassKey = ClassKey(selectedClass.key);
     const machine = stateMachineFor(domain, selected);
@@ -28,7 +33,9 @@ export function authorStateTransition(core, domain, input) {
     if ((suppliedEquals !== undefined &&
         Object.hasOwn(suppliedEquals, property) &&
         suppliedEquals[property] !== fromState) ||
-        suppliedAbsent?.includes(property) === true) {
+        suppliedAbsent?.includes(property) === true ||
+        (suppliedSet !== undefined && Object.hasOwn(suppliedSet, property)) ||
+        suppliedUnset?.includes(property) === true) {
         throw new TypeError(`StateMachine transition conditions conflict with property ${String(property)}.`);
     }
     core.expect.node({
@@ -42,6 +49,9 @@ export function authorStateTransition(core, domain, input) {
     core.updateNode({
         node,
         class: selectedClassKey,
-        props: delta(selectedClass, { set: to }),
+        props: delta(selectedClass, {
+            set: { ...suppliedSet, ...to },
+            ...(suppliedUnset === undefined ? {} : { unset: suppliedUnset }),
+        }),
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/sdk",
-  "version": "0.5.0-beta.77",
+  "version": "0.5.0-beta.78",
   "description": "Schema-first SDK for defining, composing, and deploying Astrale domains",
   "keywords": [
     "astrale",