xstate 4.27.0 → 4.28.0

package/lib/actions.js

@@ -156,6 +156,20 @@ function sendParent(event, options) {
     to: types.SpecialTargets.Parent
   }));
 }
+/**
+ * Sends an event to an actor.
+ *
+ * @param actor The `ActorRef` to send the event to.
+ * @param event The event to send, or an expression that evaluates to the event to send
+ * @param options Send action options
+ * @returns An XState send action object
+ */
+
+function sendTo(actor, event, options) {
+  return send(event, _tslib.__assign(_tslib.__assign({}, options), {
+    to: actor
+  }));
+}
 /**
  * Sends an update event to this machine's parent.
  */
@@ -524,6 +538,7 @@ exports.resolveStop = resolveStop;
 exports.respond = respond;
 exports.send = send;
 exports.sendParent = sendParent;
+exports.sendTo = sendTo;
 exports.sendUpdate = sendUpdate;
 exports.start = start;
 exports.stop = stop;

package/lib/index.d.ts

@@ -4,7 +4,7 @@ import { StateNode } from './StateNode';
 import { State } from './State';
 import { Machine, createMachine } from './Machine';
 import { Actor } from './Actor';
-import { raise, send, sendParent, sendUpdate, log, start, stop, assign, after, done, respond, doneInvoke, forwardTo, escalate, choose, pure } from './actions';
+import { raise, send, sendParent, sendTo, sendUpdate, log, start, stop, assign, after, done, respond, doneInvoke, forwardTo, escalate, choose, pure } from './actions';
 import { interpret, Interpreter, spawn, InterpreterStatus } from './interpreter';
 import { matchState } from './match';
 import { createSchema } from './schema';
@@ -12,6 +12,7 @@ declare const actions: {
     raise: typeof raise;
     send: typeof send;
     sendParent: typeof sendParent;
+    sendTo: typeof sendTo;
     sendUpdate: typeof sendUpdate;
     log: typeof log;
     cancel: (sendId: string | number) => import("./types").CancelAction;

package/lib/index.js

@@ -17,6 +17,7 @@ var actions = {
   raise: actions$1.raise,
   send: actions$1.send,
   sendParent: actions$1.sendParent,
+  sendTo: actions$1.sendTo,
   sendUpdate: actions$1.sendUpdate,
   log: actions$1.log,
   cancel: actions$1.cancel,

package/lib/interpreter.d.ts

@@ -21,11 +21,6 @@ export declare enum InterpreterStatus {
     Running = 1,
     Stopped = 2
 }
-declare global {
-    interface SymbolConstructor {
-        readonly observable: symbol;
-    }
-}
 export declare class Interpreter<TContext, TStateSchema extends StateSchema = any, TEvent extends EventObject = EventObject, TTypestate extends Typestate<TContext> = {
     value: any;
     context: TContext;

package/lib/interpreter.js

@@ -1039,7 +1039,8 @@ function () {
         }
       }
     });
-    var actor = {
+
+    var actor = _tslib.__assign({
       id: id,
       send: function () {
         return void 0;
@@ -1083,7 +1084,8 @@ function () {
       getSnapshot: function () {
         return resolvedData;
       }
-    };
+    }, utils.interopSymbols);
+
     this.children.set(id, actor);
     return actor;
   };
@@ -1127,7 +1129,7 @@ function () {
       return this.spawnPromise(callbackStop, id);
     }
 
-    var actor = {
+    var actor = _tslib.__assign({
       id: id,
       send: function (event) {
         return receivers.forEach(function (receiver) {
@@ -1157,7 +1159,8 @@ function () {
       getSnapshot: function () {
         return emitted;
       }
-    };
+    }, utils.interopSymbols);
+
     this.children.set(id, actor);
     return actor;
   };
@@ -1185,7 +1188,8 @@ function () {
         origin: id
       }));
     });
-    var actor = {
+
+    var actor = _tslib.__assign({
       id: id,
       send: function () {
         return void 0;
@@ -1204,7 +1208,8 @@ function () {
           id: id
         };
       }
-    };
+    }, utils.interopSymbols);
+
     this.children.set(id, actor);
     return actor;
   };
@@ -1232,7 +1237,7 @@ function () {
   };
 
   Interpreter.prototype.spawnEffect = function (id, dispose) {
-    this.children.set(id, {
+    this.children.set(id, _tslib.__assign({
       id: id,
       send: function () {
         return void 0;
@@ -1253,7 +1258,7 @@ function () {
           id: id
         };
       }
-    });
+    }, utils.interopSymbols));
   };
 
   Interpreter.prototype.attachDev = function () {

package/lib/types.d.ts

@@ -916,18 +916,21 @@ export interface Observer<T> {
 export interface Subscription {
     unsubscribe(): void;
 }
+export interface InteropObservable<T> {
+    [Symbol.observable]: () => Subscribable<T>;
+}
 export interface Subscribable<T> {
     subscribe(next: (value: T) => void, error?: (error: any) => void, complete?: () => void): Subscription;
     subscribe(observer: Observer<T>): Subscription;
 }
-export declare type Spawnable = StateMachine<any, any, any> | PromiseLike<any> | InvokeCallback | Subscribable<any> | Behavior<any>;
+export declare type Spawnable = StateMachine<any, any, any> | PromiseLike<any> | InvokeCallback | InteropObservable<any> | Subscribable<any> | Behavior<any>;
 export declare type ExtractEvent<TEvent extends EventObject, TEventType extends TEvent['type']> = TEvent extends {
     type: TEventType;
 } ? TEvent : never;
 export interface BaseActorRef<TEvent extends EventObject> {
     send: (event: TEvent) => void;
 }
-export interface ActorRef<TEvent extends EventObject, TEmitted = any> extends Subscribable<TEmitted> {
+export interface ActorRef<TEvent extends EventObject, TEmitted = any> extends Subscribable<TEmitted>, InteropObservable<TEmitted> {
     send: Sender<TEvent>;
     id: string;
     getSnapshot: () => TEmitted | undefined;

package/lib/utils.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import { Event, StateValue, ActionType, Action, EventObject, PropertyMapper, Mapper, EventType, HistoryValue, AssignAction, Condition, Subscribable, StateMachine, ConditionPredicate, SCXML, StateLike, EventData, TransitionConfig, TransitionConfigTarget, NullEvent, SingleOrArray, Guard, InvokeSourceDefinition, Observer, Behavior } from './types';
 import { StateNode } from './StateNode';
 import { State } from './State';
@@ -52,7 +53,11 @@ export declare function isFunction(value: any): value is Function;
 export declare function isString(value: any): value is string;
 export declare function toGuard<TContext, TEvent extends EventObject>(condition?: Condition<TContext, TEvent>, guardMap?: Record<string, ConditionPredicate<TContext, TEvent>>): Guard<TContext, TEvent> | undefined;
 export declare function isObservable<T>(value: any): value is Subscribable<T>;
-export declare const symbolObservable: any;
+export declare const symbolObservable: string | typeof Symbol.observable;
+export declare const interopSymbols: {
+    [x: string]: () => any;
+    [Symbol.observable]: () => any;
+};
 export declare function isMachine(value: any): value is StateMachine<any, any, any>;
 export declare function isActor(value: any): value is Actor;
 export declare const uniqueId: () => string;
@@ -66,4 +71,5 @@ export declare function reportUnhandledExceptionOnInvocation(originalError: any,
 export declare function evaluateGuard<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent, any>, guard: Guard<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>, state: State<TContext, TEvent>): boolean;
 export declare function toInvokeSource(src: string | InvokeSourceDefinition): InvokeSourceDefinition;
 export declare function toObserver<T>(nextHandler: Observer<T> | ((value: T) => void), errorHandler?: (error: any) => void, completionHandler?: () => void): Observer<T>;
+export declare function createInvokeId(stateNodeId: string, index: number): string;
 //# sourceMappingURL=utils.d.ts.map

package/lib/utils.js

@@ -6,6 +6,7 @@ var _tslib = require('./_virtual/_tslib.js');
 var constants = require('./constants.js');
 var environment = require('./environment.js');
 
+var _a;
 function keys(value) {
   return Object.keys(value);
 }
@@ -464,6 +465,9 @@ function isObservable(value) {
 var symbolObservable = /*#__PURE__*/function () {
   return typeof Symbol === 'function' && Symbol.observable || '@@observable';
 }();
+var interopSymbols = (_a = {}, _a[symbolObservable] = function () {
+  return this;
+}, _a);
 function isMachine(value) {
   try {
     return '__xstatenode' in value;
@@ -584,10 +588,15 @@ function toObserver(nextHandler, errorHandler, completionHandler) {
     complete: completionHandler || noop
   };
 }
+function createInvokeId(stateNodeId, index) {
+  return "".concat(stateNodeId, ":invocation[").concat(index, "]");
+}
 
+exports.createInvokeId = createInvokeId;
 exports.evaluateGuard = evaluateGuard;
 exports.flatten = flatten;
 exports.getEventType = getEventType;
+exports.interopSymbols = interopSymbols;
 exports.isActor = isActor;
 exports.isArray = isArray;
 exports.isBehavior = isBehavior;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xstate",
-  "version": "4.27.0",
+  "version": "4.28.0",
   "description": "Finite State Machines and Statecharts for the Modern Web.",
   "main": "lib/index.js",
   "module": "es/index.js",