xstate 5.0.0-beta.38 → 5.0.0-beta.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/actions/dist/xstate-actions.cjs.js +3 -3
  2. package/actions/dist/xstate-actions.development.cjs.js +3 -3
  3. package/actions/dist/xstate-actions.development.esm.js +3 -3
  4. package/actions/dist/xstate-actions.esm.js +3 -3
  5. package/actions/dist/xstate-actions.umd.min.js +1 -1
  6. package/actions/dist/xstate-actions.umd.min.js.map +1 -1
  7. package/actors/dist/xstate-actors.cjs.js +60 -3
  8. package/actors/dist/xstate-actors.development.cjs.js +60 -3
  9. package/actors/dist/xstate-actors.development.esm.js +60 -3
  10. package/actors/dist/xstate-actors.esm.js +60 -3
  11. package/actors/dist/xstate-actors.umd.min.js +1 -1
  12. package/actors/dist/xstate-actors.umd.min.js.map +1 -1
  13. package/dist/declarations/src/StateMachine.d.ts +5 -5
  14. package/dist/declarations/src/actors/callback.d.ts +74 -0
  15. package/dist/declarations/src/actors/transition.d.ts +2 -2
  16. package/dist/declarations/src/interpreter.d.ts +70 -9
  17. package/dist/declarations/src/spawn.d.ts +2 -2
  18. package/dist/declarations/src/stateUtils.d.ts +4 -4
  19. package/dist/declarations/src/system.d.ts +7 -3
  20. package/dist/declarations/src/types.d.ts +7 -7
  21. package/dist/{interpreter-4005eb36.development.esm.js → interpreter-410d7ca9.development.esm.js} +92 -13
  22. package/dist/{interpreter-b6f22ee2.cjs.js → interpreter-586abde4.cjs.js} +92 -13
  23. package/dist/{interpreter-ed3f81f7.development.cjs.js → interpreter-bae5c279.development.cjs.js} +92 -13
  24. package/dist/{interpreter-c80ce92e.esm.js → interpreter-ed0fac7e.esm.js} +92 -13
  25. package/dist/{raise-7faa9b3b.cjs.js → raise-27909189.cjs.js} +83 -80
  26. package/dist/{raise-c989c7fb.esm.js → raise-2b2fdec3.esm.js} +83 -80
  27. package/dist/{raise-42073973.development.esm.js → raise-37f9f3b8.development.esm.js} +84 -81
  28. package/dist/{raise-b69a3d16.development.cjs.js → raise-8325e2df.development.cjs.js} +84 -81
  29. package/dist/{send-34160163.cjs.js → send-4fdf275e.cjs.js} +22 -22
  30. package/dist/{send-4b616da9.esm.js → send-59f66c58.esm.js} +22 -22
  31. package/dist/{send-58725522.development.cjs.js → send-c45d0d2c.development.cjs.js} +22 -22
  32. package/dist/{send-bff8c910.development.esm.js → send-f6b49072.development.esm.js} +22 -22
  33. package/dist/xstate.cjs.js +18 -17
  34. package/dist/xstate.development.cjs.js +18 -17
  35. package/dist/xstate.development.esm.js +21 -20
  36. package/dist/xstate.esm.js +21 -20
  37. package/dist/xstate.umd.min.js +1 -1
  38. package/dist/xstate.umd.min.js.map +1 -1
  39. package/guards/dist/xstate-guards.cjs.js +2 -2
  40. package/guards/dist/xstate-guards.development.cjs.js +2 -2
  41. package/guards/dist/xstate-guards.development.esm.js +2 -2
  42. package/guards/dist/xstate-guards.esm.js +2 -2
  43. package/guards/dist/xstate-guards.umd.min.js.map +1 -1
  44. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"xstate-actors.umd.min.js","sources":["../../src/Mailbox.ts","../../src/constants.ts","../../src/eventUtils.ts","../../src/dev/index.ts","../../src/reportUnhandledError.ts","../../src/symbolObservable.ts","../../src/system.ts","../../src/utils.ts","../../src/interpreter.ts","../../src/actors/transition.ts","../../src/actors/promise.ts","../../src/actors/index.ts","../../src/actors/callback.ts","../../src/actors/observable.ts"],"sourcesContent":["interface MailboxItem<T> {\n value: T;\n next: MailboxItem<T> | null;\n}\n\nexport class Mailbox<T> {\n private _active: boolean = false;\n private _current: MailboxItem<T> | null = null;\n private _last: MailboxItem<T> | null = null;\n\n constructor(private _process: (ev: T) => void) {}\n\n public start() {\n this._active = true;\n this.flush();\n }\n\n public clear(): void {\n // we can't set _current to null because we might be currently processing\n // and enqueue following clear shouldnt start processing the enqueued item immediately\n if (this._current) {\n this._current.next = null;\n this._last = this._current;\n }\n }\n\n public enqueue(event: T): void {\n const enqueued = {\n value: event,\n next: null\n };\n\n if (this._current) {\n this._last!.next = enqueued;\n this._last = enqueued;\n return;\n }\n\n this._current = enqueued;\n this._last = enqueued;\n\n if (this._active) {\n this.flush();\n }\n }\n\n private flush() {\n while (this._current) {\n // atm the given _process is responsible for implementing proper try/catch handling\n // we assume here that this won't throw in a way that can affect this mailbox\n const consumed = this._current;\n this._process(consumed.value);\n this._current = consumed.next;\n }\n this._last = null;\n }\n}\n","export const STATE_DELIMITER = '.';\nexport const TARGETLESS_KEY = '';\nexport const NULL_EVENT = '';\nexport const STATE_IDENTIFIER = '#';\nexport const WILDCARD = '*';\nexport const XSTATE_INIT = 'xstate.init';\nexport const XSTATE_ERROR = 'xstate.error';\nexport const XSTATE_STOP = 'xstate.stop';\n","import { XSTATE_INIT } from './constants.ts';\nimport { DoneActorEvent, DoneStateEvent, ErrorActorEvent } from './types.ts';\n\n/**\n * Returns an event that represents an implicit event that\n * is sent after the specified `delay`.\n *\n * @param delayRef The delay in milliseconds\n * @param id The state node ID where this event is handled\n */\nexport function createAfterEvent(delayRef: number | string, id?: string) {\n const idSuffix = id ? `#${id}` : '';\n return { type: `xstate.after(${delayRef})${idSuffix}` } as const;\n}\n\n/**\n * Returns an event that represents that a final state node\n * has been reached in the parent state node.\n *\n * @param id The final state node's parent state node `id`\n * @param output The data to pass into the event\n */\nexport function createDoneStateEvent(\n id: string,\n output?: unknown\n): DoneStateEvent {\n return {\n type: `xstate.done.state.${id}`,\n output\n };\n}\n\n/**\n * Returns an event that represents that an invoked service has terminated.\n *\n * An invoked service is terminated when it has reached a top-level final state node,\n * but not when it is canceled.\n *\n * @param invokeId The invoked service ID\n * @param output The data to pass into the event\n */\nexport function createDoneActorEvent(\n invokeId: string,\n output?: unknown\n): DoneActorEvent {\n return {\n type: `xstate.done.actor.${invokeId}`,\n output\n };\n}\n\nexport function createErrorActorEvent(\n id: string,\n data?: unknown\n): ErrorActorEvent {\n return { type: `xstate.error.actor.${id}`, data };\n}\n\nexport function createInitEvent(input: unknown) {\n return { type: XSTATE_INIT, input } as const;\n}\n","import isDevelopment from '#is-development';\nimport { AnyActor, DevToolsAdapter } from '../types.ts';\n\ninterface DevInterface {\n services: Set<AnyActor>;\n register(service: AnyActor): void;\n onRegister(listener: ServiceListener): void;\n}\ntype ServiceListener = (service: AnyActor) => void;\n\nexport interface XStateDevInterface {\n register: (service: AnyActor) => void;\n unregister: (service: AnyActor) => void;\n onRegister: (listener: ServiceListener) => {\n unsubscribe: () => void;\n };\n services: Set<AnyActor>;\n}\n\n// From https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis\nexport function getGlobal(): typeof globalThis | undefined {\n if (typeof globalThis !== 'undefined') {\n return globalThis;\n }\n if (typeof self !== 'undefined') {\n return self;\n }\n if (typeof window !== 'undefined') {\n return window;\n }\n if (typeof global !== 'undefined') {\n return global;\n }\n if (isDevelopment) {\n console.warn(\n 'XState could not find a global object in this environment. Please let the maintainers know and raise an issue here: https://github.com/statelyai/xstate/issues'\n );\n }\n}\n\nfunction getDevTools(): DevInterface | undefined {\n const w = getGlobal();\n if (!!(w as any).__xstate__) {\n return (w as any).__xstate__;\n }\n\n return undefined;\n}\n\nexport function registerService(service: AnyActor) {\n if (typeof window === 'undefined') {\n return;\n }\n\n const devTools = getDevTools();\n\n if (devTools) {\n devTools.register(service);\n }\n}\n\nexport const devToolsAdapter: DevToolsAdapter = (service) => {\n if (typeof window === 'undefined') {\n return;\n }\n\n const devTools = getDevTools();\n\n if (devTools) {\n devTools.register(service);\n }\n};\n","/**\n * This function makes sure that unhandled errors are thrown in a separate macrotask.\n * It allows those errors to be detected by global error handlers and reported to bug tracking services\n * without interrupting our own stack of execution.\n *\n * @param err error to be thrown\n */\nexport function reportUnhandledError(err: unknown) {\n setTimeout(() => {\n throw err;\n });\n}\n","export const symbolObservable: typeof Symbol.observable = (() =>\n (typeof Symbol === 'function' && Symbol.observable) ||\n '@@observable')() as any;\n","import {\n AnyEventObject,\n ActorSystem,\n ActorSystemInfo,\n AnyActorRef,\n Observer,\n Snapshot\n} from './types.ts';\n\nlet idCounter = 0;\nexport function createSystem<T extends ActorSystemInfo>(\n rootActor: AnyActorRef\n): ActorSystem<T> {\n const children = new Map<string, AnyActorRef>();\n const keyedActors = new Map<keyof T['actors'], AnyActorRef | undefined>();\n const reverseKeyedActors = new WeakMap<AnyActorRef, keyof T['actors']>();\n const observers = new Set<Observer<InspectionEvent>>();\n\n const system: ActorSystem<T> = {\n _bookId: () => `x:${idCounter++}`,\n _register: (sessionId, actorRef) => {\n children.set(sessionId, actorRef);\n return sessionId;\n },\n _unregister: (actorRef) => {\n children.delete(actorRef.sessionId);\n const systemId = reverseKeyedActors.get(actorRef);\n\n if (systemId !== undefined) {\n keyedActors.delete(systemId);\n reverseKeyedActors.delete(actorRef);\n }\n },\n get: (systemId) => {\n return keyedActors.get(systemId) as T['actors'][any];\n },\n _set: (systemId, actorRef) => {\n const existing = keyedActors.get(systemId);\n if (existing && existing !== actorRef) {\n throw new Error(\n `Actor with system ID '${systemId as string}' already exists.`\n );\n }\n\n keyedActors.set(systemId, actorRef);\n reverseKeyedActors.set(actorRef, systemId);\n },\n inspect: (observer) => {\n observers.add(observer);\n },\n _sendInspectionEvent: (event) => {\n const resolvedInspectionEvent: InspectionEvent = {\n ...event,\n rootId: rootActor.sessionId\n };\n observers.forEach((observer) => observer.next?.(resolvedInspectionEvent));\n },\n _relay: (source, target, event) => {\n system._sendInspectionEvent({\n type: '@xstate.event',\n sourceRef: source,\n targetRef: target,\n event\n });\n\n target._send(event);\n }\n };\n\n return system;\n}\nexport interface BaseInspectionEventProperties {\n rootId: string; // the session ID of the root\n}\n\nexport interface InspectedSnapshotEvent extends BaseInspectionEventProperties {\n type: '@xstate.snapshot';\n actorRef: AnyActorRef; // Only available locally\n event: AnyEventObject; // { type: string, ... }\n snapshot: Snapshot<unknown>;\n}\n\nexport interface InspectedEventEvent extends BaseInspectionEventProperties {\n type: '@xstate.event';\n // The source might not exist, e.g. when:\n // - root init events\n // - events sent from external (non-actor) sources\n sourceRef: AnyActorRef | undefined;\n targetRef: AnyActorRef; // Session ID, required\n event: AnyEventObject; // { type: string, ... }\n}\n\nexport interface InspectedActorEvent extends BaseInspectionEventProperties {\n type: '@xstate.actor';\n actorRef: AnyActorRef;\n}\n\nexport type InspectionEvent =\n | InspectedSnapshotEvent\n | InspectedEventEvent\n | InspectedActorEvent;\n","import isDevelopment from '#is-development';\nimport { AnyActorLogic, AnyState } from './index.ts';\nimport { STATE_DELIMITER, TARGETLESS_KEY } from './constants.ts';\nimport type { StateNode } from './StateNode.ts';\nimport type {\n ActorLogic,\n AnyEventObject,\n EventObject,\n MachineContext,\n Mapper,\n Observer,\n ErrorActorEvent,\n SingleOrArray,\n StateLike,\n StateValue,\n Subscribable,\n TransitionConfigTarget,\n AnyActorRef,\n AnyTransitionConfig,\n NonReducibleUnknown,\n AnyStateMachine,\n InvokeConfig\n} from './types.ts';\n\nexport function keys<T extends object>(value: T): Array<keyof T & string> {\n return Object.keys(value) as Array<keyof T & string>;\n}\n\nexport function matchesState(\n parentStateId: StateValue,\n childStateId: StateValue\n): boolean {\n const parentStateValue = toStateValue(parentStateId);\n const childStateValue = toStateValue(childStateId);\n\n if (typeof childStateValue === 'string') {\n if (typeof parentStateValue === 'string') {\n return childStateValue === parentStateValue;\n }\n\n // Parent more specific than child\n return false;\n }\n\n if (typeof parentStateValue === 'string') {\n return parentStateValue in childStateValue;\n }\n\n return Object.keys(parentStateValue).every((key) => {\n if (!(key in childStateValue)) {\n return false;\n }\n\n return matchesState(parentStateValue[key], childStateValue[key]);\n });\n}\n\nexport function toStatePath(stateId: string | string[]): string[] {\n try {\n if (isArray(stateId)) {\n return stateId;\n }\n\n return stateId.toString().split(STATE_DELIMITER);\n } catch (e) {\n throw new Error(`'${stateId}' is not a valid state path.`);\n }\n}\n\nexport function isStateLike(state: any): state is AnyState {\n return (\n typeof state === 'object' &&\n 'value' in state &&\n 'context' in state &&\n 'event' in state\n );\n}\n\nexport function toStateValue(\n stateValue: StateLike<any> | StateValue | string[]\n): StateValue {\n if (isStateLike(stateValue)) {\n return stateValue.value;\n }\n\n if (isArray(stateValue)) {\n return pathToStateValue(stateValue);\n }\n\n if (typeof stateValue !== 'string') {\n return stateValue as StateValue;\n }\n\n const statePath = toStatePath(stateValue as string);\n\n return pathToStateValue(statePath);\n}\n\nexport function pathToStateValue(statePath: string[]): StateValue {\n if (statePath.length === 1) {\n return statePath[0];\n }\n\n const value: StateValue = {};\n let marker = value;\n\n for (let i = 0; i < statePath.length - 1; i++) {\n if (i === statePath.length - 2) {\n marker[statePath[i]] = statePath[i + 1];\n } else {\n const previous = marker;\n marker = {};\n previous[statePath[i]] = marker;\n }\n }\n\n return value;\n}\n\nexport function mapValues<P, O extends Record<string, unknown>>(\n collection: O,\n iteratee: (item: O[keyof O], key: keyof O, collection: O, i: number) => P\n): { [key in keyof O]: P };\nexport function mapValues(\n collection: Record<string, unknown>,\n iteratee: (\n item: unknown,\n key: string,\n collection: Record<string, unknown>,\n i: number\n ) => unknown\n) {\n const result: Record<string, unknown> = {};\n\n const collectionKeys = Object.keys(collection);\n for (let i = 0; i < collectionKeys.length; i++) {\n const key = collectionKeys[i];\n result[key] = iteratee(collection[key], key, collection, i);\n }\n\n return result;\n}\n\nexport function mapFilterValues<T, P>(\n collection: { [key: string]: T },\n iteratee: (item: T, key: string, collection: { [key: string]: T }) => P,\n predicate: (item: T) => boolean\n): { [key: string]: P } {\n const result: { [key: string]: P } = {};\n\n for (const key of Object.keys(collection)) {\n const item = collection[key];\n\n if (!predicate(item)) {\n continue;\n }\n\n result[key] = iteratee(item, key, collection);\n }\n\n return result;\n}\n\n/**\n * Retrieves a value at the given path.\n * @param props The deep path to the prop of the desired value\n */\nexport function path<T extends Record<string, any>>(props: string[]): any {\n return (object: T): any => {\n let result: T = object;\n\n for (const prop of props) {\n result = result[prop as keyof typeof result];\n }\n\n return result;\n };\n}\n\nexport function toStatePaths(stateValue: StateValue | undefined): string[][] {\n if (!stateValue) {\n return [[]];\n }\n\n if (typeof stateValue === 'string') {\n return [[stateValue]];\n }\n\n const result = flatten(\n Object.keys(stateValue).map((key) => {\n const subStateValue = stateValue[key];\n\n if (\n typeof subStateValue !== 'string' &&\n (!subStateValue || !Object.keys(subStateValue).length)\n ) {\n return [[key]];\n }\n\n return toStatePaths(stateValue[key]).map((subPath) => {\n return [key].concat(subPath);\n });\n })\n );\n\n return result;\n}\n\nexport function flatten<T>(array: Array<T | T[]>): T[] {\n return ([] as T[]).concat(...array);\n}\n\nexport function toArrayStrict<T>(value: readonly T[] | T): readonly T[] {\n if (isArray(value)) {\n return value;\n }\n return [value];\n}\n\nexport function toArray<T>(value: readonly T[] | T | undefined): readonly T[] {\n if (value === undefined) {\n return [];\n }\n return toArrayStrict(value);\n}\n\nexport function resolveOutput<\n TContext extends MachineContext,\n TExpressionEvent extends EventObject\n>(\n mapper:\n | Mapper<TContext, TExpressionEvent, unknown, EventObject>\n | NonReducibleUnknown,\n context: TContext,\n event: TExpressionEvent,\n self: AnyActorRef\n): unknown {\n if (typeof mapper === 'function') {\n return mapper({ context, event, self });\n }\n\n if (\n isDevelopment &&\n !!mapper &&\n typeof mapper === 'object' &&\n Object.values(mapper).some((val) => typeof val === 'function')\n ) {\n console.warn(\n `Dynamically mapping values to individual properties is deprecated. Use a single function that returns the mapped object instead.\\nFound object containing properties whose values are possibly mapping functions: ${Object.entries(\n mapper\n )\n .filter(([key, value]) => typeof value === 'function')\n .map(\n ([key, value]) =>\n `\\n - ${key}: ${(value as () => any)\n .toString()\n .replace(/\\n\\s*/g, '')}`\n )\n .join('')}`\n );\n }\n\n return mapper;\n}\n\nexport function isBuiltInEvent(eventType: string): boolean {\n return /^(done|error)\\./.test(eventType);\n}\n\nexport function isPromiseLike(value: any): value is PromiseLike<any> {\n if (value instanceof Promise) {\n return true;\n }\n // Check if shape matches the Promise/A+ specification for a \"thenable\".\n if (\n value !== null &&\n (typeof value === 'function' || typeof value === 'object') &&\n typeof value.then === 'function'\n ) {\n return true;\n }\n return false;\n}\n\nexport function isActorLogic(value: any): value is ActorLogic<any, any> {\n return (\n value !== null &&\n typeof value === 'object' &&\n 'transition' in value &&\n typeof value.transition === 'function'\n );\n}\n\nexport function partition<T, A extends T, B extends T>(\n items: T[],\n predicate: (item: T) => item is A\n): [A[], B[]] {\n const [truthy, falsy] = [[], []] as [A[], B[]];\n\n for (const item of items) {\n if (predicate(item)) {\n truthy.push(item);\n } else {\n falsy.push(item as B);\n }\n }\n\n return [truthy, falsy];\n}\n\nexport function isArray(value: any): value is readonly any[] {\n return Array.isArray(value);\n}\n\nexport function isObservable<T>(value: any): value is Subscribable<T> {\n return (\n !!value && 'subscribe' in value && typeof value.subscribe === 'function'\n );\n}\n\nexport function isErrorActorEvent(\n event: AnyEventObject\n): event is ErrorActorEvent {\n return event.type.startsWith('xstate.error.actor');\n}\n\nexport function toTransitionConfigArray<\n TContext extends MachineContext,\n TEvent extends EventObject\n>(\n configLike: SingleOrArray<AnyTransitionConfig | TransitionConfigTarget>\n): Array<AnyTransitionConfig> {\n return toArrayStrict(configLike).map((transitionLike) => {\n if (\n typeof transitionLike === 'undefined' ||\n typeof transitionLike === 'string'\n ) {\n return { target: transitionLike };\n }\n\n return transitionLike;\n });\n}\n\nexport function normalizeTarget<\n TContext extends MachineContext,\n TEvent extends EventObject\n>(\n target: SingleOrArray<string | StateNode<TContext, TEvent>> | undefined\n): ReadonlyArray<string | StateNode<TContext, TEvent>> | undefined {\n if (target === undefined || target === TARGETLESS_KEY) {\n return undefined;\n }\n return toArray(target);\n}\n\nexport function reportUnhandledExceptionOnInvocation(\n originalError: any,\n currentError: any,\n id: string\n) {\n if (isDevelopment) {\n const originalStackTrace = originalError.stack\n ? ` Stacktrace was '${originalError.stack}'`\n : '';\n if (originalError === currentError) {\n // tslint:disable-next-line:no-console\n console.error(\n `Missing onError handler for invocation '${id}', error was '${originalError}'.${originalStackTrace}`\n );\n } else {\n const stackTrace = currentError.stack\n ? ` Stacktrace was '${currentError.stack}'`\n : '';\n // tslint:disable-next-line:no-console\n console.error(\n `Missing onError handler and/or unhandled exception/promise rejection for invocation '${id}'. ` +\n `Original error: '${originalError}'. ${originalStackTrace} Current error is '${currentError}'.${stackTrace}`\n );\n }\n }\n}\n\nexport function toObserver<T>(\n nextHandler?: Observer<T> | ((value: T) => void),\n errorHandler?: (error: any) => void,\n completionHandler?: () => void\n): Observer<T> {\n const isObserver = typeof nextHandler === 'object';\n const self = isObserver ? nextHandler : undefined;\n\n return {\n next: (isObserver ? nextHandler.next : nextHandler)?.bind(self),\n error: (isObserver ? nextHandler.error : errorHandler)?.bind(self),\n complete: (isObserver ? nextHandler.complete : completionHandler)?.bind(\n self\n )\n };\n}\n\nexport function createInvokeId(stateNodeId: string, index: number): string {\n return `${stateNodeId}[${index}]`;\n}\n\nexport function resolveReferencedActor(machine: AnyStateMachine, src: string) {\n if (src.startsWith('xstate#')) {\n const [, indexStr] = src.match(/\\[(\\d+)\\]$/)!;\n const node = machine.getStateNodeById(src.slice(7, -(indexStr.length + 2)));\n const invokeConfig = node.config.invoke!;\n return {\n src: (Array.isArray(invokeConfig)\n ? invokeConfig[indexStr as any]\n : (invokeConfig as InvokeConfig<any, any, any, any, any, any>)\n ).src,\n input: undefined\n };\n }\n const referenced = machine.implementations.actors[src];\n return referenced\n ? 'transition' in referenced\n ? { src: referenced, input: undefined }\n : referenced\n : undefined;\n}\n","import isDevelopment from '#is-development';\nimport { Mailbox } from './Mailbox.ts';\nimport {\n createDoneActorEvent,\n createErrorActorEvent,\n createInitEvent\n} from './eventUtils.ts';\nimport { XSTATE_STOP } from './constants.ts';\nimport { devToolsAdapter } from './dev/index.ts';\nimport { reportUnhandledError } from './reportUnhandledError.ts';\nimport { symbolObservable } from './symbolObservable.ts';\nimport { createSystem } from './system.ts';\nimport {\n AreAllImplementationsAssumedToBeProvided,\n MissingImplementationsError\n} from './typegenTypes.ts';\nimport type {\n ActorContext,\n ActorSystem,\n AnyActorLogic,\n AnyStateMachine,\n EventFromLogic,\n SnapshotFrom,\n AnyActorRef,\n DoneActorEvent,\n Snapshot\n} from './types.ts';\nimport {\n ActorRef,\n EventObject,\n InteropSubscribable,\n ActorOptions,\n Observer,\n Subscription\n} from './types.ts';\nimport { toObserver } from './utils.ts';\n\nexport const $$ACTOR_TYPE = 1;\n\nexport type SnapshotListener<TLogic extends AnyActorLogic> = (\n state: SnapshotFrom<TLogic>\n) => void;\n\nexport type EventListener<TEvent extends EventObject = EventObject> = (\n event: TEvent\n) => void;\n\nexport type Listener = () => void;\nexport type ErrorListener = (error: any) => void;\n\nexport interface Clock {\n setTimeout(fn: (...args: any[]) => void, timeout: number): any;\n clearTimeout(id: any): void;\n}\n\nexport enum ActorStatus {\n NotStarted,\n Running,\n Stopped\n}\n\n/**\n * @deprecated Use `ActorStatus` instead.\n */\nexport const InterpreterStatus = ActorStatus;\n\nconst defaultOptions = {\n clock: {\n setTimeout: (fn, ms) => {\n return setTimeout(fn, ms);\n },\n clearTimeout: (id) => {\n return clearTimeout(id);\n }\n } as Clock,\n logger: console.log.bind(console),\n devTools: false\n};\n\nexport class Actor<TLogic extends AnyActorLogic>\n implements ActorRef<EventFromLogic<TLogic>, SnapshotFrom<TLogic>>\n{\n /**\n * The current internal state of the actor.\n */\n private _state!: SnapshotFrom<TLogic>;\n /**\n * The clock that is responsible for setting and clearing timeouts, such as delayed events and transitions.\n */\n public clock: Clock;\n public options: Readonly<ActorOptions<TLogic>>;\n\n /**\n * The unique identifier for this actor relative to its parent.\n */\n public id: string;\n\n private mailbox: Mailbox<EventFromLogic<TLogic>> = new Mailbox(\n this._process.bind(this)\n );\n\n private delayedEventsMap: Record<string, unknown> = {};\n\n private observers: Set<Observer<SnapshotFrom<TLogic>>> = new Set();\n private logger: (...args: any[]) => void;\n /**\n * Whether the service is started.\n */\n public status: ActorStatus = ActorStatus.NotStarted;\n\n // Actor Ref\n public _parent?: ActorRef<any, any>;\n public ref: ActorRef<EventFromLogic<TLogic>, SnapshotFrom<TLogic>>;\n // TODO: add typings for system\n private _actorContext: ActorContext<\n SnapshotFrom<TLogic>,\n EventFromLogic<TLogic>,\n any\n >;\n\n private _systemId: string | undefined;\n\n /**\n * The globally unique process ID for this invocation.\n */\n public sessionId: string;\n\n public system: ActorSystem<any>;\n private _doneEvent?: DoneActorEvent;\n\n public src?: string;\n\n /**\n * Creates a new actor instance for the given logic with the provided options, if any.\n *\n * @param logic The logic to create an actor from\n * @param options Actor options\n */\n constructor(public logic: TLogic, options?: ActorOptions<TLogic>) {\n const resolvedOptions = {\n ...defaultOptions,\n ...options\n } as ActorOptions<TLogic> & typeof defaultOptions;\n\n const { clock, logger, parent, id, systemId, inspect } = resolvedOptions;\n\n this.system = parent?.system ?? createSystem(this);\n\n if (inspect && !parent) {\n // Always inspect at the system-level\n this.system.inspect(toObserver(inspect));\n }\n\n if (systemId) {\n this._systemId = systemId;\n this.system._set(systemId, this);\n }\n\n this.sessionId = this.system._bookId();\n this.id = id ?? this.sessionId;\n this.logger = logger;\n this.clock = clock;\n this._parent = parent;\n this.options = resolvedOptions;\n this.src = resolvedOptions.src;\n this.ref = this;\n this._actorContext = {\n self: this,\n id: this.id,\n sessionId: this.sessionId,\n logger: this.logger,\n defer: (fn) => {\n this._deferred.push(fn);\n },\n system: this.system,\n stopChild: (child) => {\n if (child._parent !== this) {\n throw new Error(\n `Cannot stop child actor ${child.id} of ${this.id} because it is not a child`\n );\n }\n (child as any)._stop();\n }\n };\n\n // Ensure that the send method is bound to this Actor instance\n // if destructured\n this.send = this.send.bind(this);\n this.system._sendInspectionEvent({\n type: '@xstate.actor',\n actorRef: this\n });\n this._initState();\n }\n\n private _initState() {\n this._state = this.options.state\n ? this.logic.restoreState\n ? this.logic.restoreState(this.options.state, this._actorContext)\n : this.options.state\n : this.logic.getInitialState(this._actorContext, this.options?.input);\n }\n\n // array of functions to defer\n private _deferred: Array<() => void> = [];\n\n private update(snapshot: SnapshotFrom<TLogic>, event: EventObject): void {\n // Update state\n this._state = snapshot;\n\n // Execute deferred effects\n let deferredFn: (typeof this._deferred)[number] | undefined;\n\n while ((deferredFn = this._deferred.shift())) {\n deferredFn();\n }\n\n for (const observer of this.observers) {\n // TODO: should observers be notified in case of the error?\n try {\n observer.next?.(snapshot);\n } catch (err) {\n reportUnhandledError(err);\n }\n }\n\n switch ((this._state as any).status) {\n case 'done':\n this._stopProcedure();\n this._complete();\n this._doneEvent = createDoneActorEvent(\n this.id,\n (this._state as any).output\n );\n if (this._parent) {\n this.system._relay(this, this._parent, this._doneEvent);\n }\n\n break;\n case 'error':\n this._stopProcedure();\n this._error((this._state as any).error);\n if (this._parent) {\n this.system._relay(\n this,\n this._parent,\n createErrorActorEvent(this.id, (this._state as any).error)\n );\n }\n break;\n }\n this.system._sendInspectionEvent({\n type: '@xstate.snapshot',\n actorRef: this,\n event,\n snapshot\n });\n }\n\n public subscribe(observer: Observer<SnapshotFrom<TLogic>>): Subscription;\n public subscribe(\n nextListener?: (state: SnapshotFrom<TLogic>) => void,\n errorListener?: (error: any) => void,\n completeListener?: () => void\n ): Subscription;\n public subscribe(\n nextListenerOrObserver?:\n | ((state: SnapshotFrom<TLogic>) => void)\n | Observer<SnapshotFrom<TLogic>>,\n errorListener?: (error: any) => void,\n completeListener?: () => void\n ): Subscription {\n const observer = toObserver(\n nextListenerOrObserver,\n errorListener,\n completeListener\n );\n\n if (this.status !== ActorStatus.Stopped) {\n this.observers.add(observer);\n } else {\n try {\n observer.complete?.();\n } catch (err) {\n reportUnhandledError(err);\n }\n }\n\n return {\n unsubscribe: () => {\n this.observers.delete(observer);\n }\n };\n }\n\n /**\n * Starts the Actor from the initial state\n */\n public start(): this {\n if (this.status === ActorStatus.Running) {\n // Do not restart the service if it is already started\n return this;\n }\n\n this.system._register(this.sessionId, this);\n if (this._systemId) {\n this.system._set(this._systemId, this);\n }\n this.status = ActorStatus.Running;\n\n const initEvent = createInitEvent(this.options.input);\n\n this.system._sendInspectionEvent({\n type: '@xstate.event',\n sourceRef: this._parent,\n targetRef: this,\n event: initEvent\n });\n\n const status = (this._state as any).status;\n\n switch (status) {\n case 'done':\n // a state machine can be \"done\" upon initialization (it could reach a final state using initial microsteps)\n // we still need to complete observers, flush deferreds etc\n this.update(\n this._state,\n initEvent as unknown as EventFromLogic<TLogic>\n );\n // fallthrough\n case 'error':\n // TODO: rethink cleanup of observers, mailbox, etc\n return this;\n }\n\n if (this.logic.start) {\n try {\n this.logic.start(this._state, this._actorContext);\n } catch (err) {\n this._stopProcedure();\n this._error(err);\n this._parent?.send(createErrorActorEvent(this.id, err));\n return this;\n }\n }\n\n // TODO: this notifies all subscribers but usually this is redundant\n // there is no real change happening here\n // we need to rethink if this needs to be refactored\n this.update(this._state, initEvent as unknown as EventFromLogic<TLogic>);\n\n if (this.options.devTools) {\n this.attachDevTools();\n }\n\n this.mailbox.start();\n\n return this;\n }\n\n private _process(event: EventFromLogic<TLogic>) {\n // TODO: reexamine what happens when an action (or a guard or smth) throws\n let nextState;\n let caughtError;\n try {\n nextState = this.logic.transition(this._state, event, this._actorContext);\n } catch (err) {\n // we wrap it in a box so we can rethrow it later even if falsy value gets caught here\n caughtError = { err };\n }\n\n if (caughtError) {\n const { err } = caughtError;\n\n this._stopProcedure();\n this._error(err);\n this._parent?.send(createErrorActorEvent(this.id, err));\n return;\n }\n\n this.update(nextState, event);\n if (event.type === XSTATE_STOP) {\n this._stopProcedure();\n this._complete();\n }\n }\n\n private _stop(): this {\n if (this.status === ActorStatus.Stopped) {\n return this;\n }\n this.mailbox.clear();\n if (this.status === ActorStatus.NotStarted) {\n this.status = ActorStatus.Stopped;\n return this;\n }\n this.mailbox.enqueue({ type: XSTATE_STOP } as any);\n\n return this;\n }\n\n /**\n * Stops the Actor and unsubscribe all listeners.\n */\n public stop(): this {\n if (this._parent) {\n throw new Error('A non-root actor cannot be stopped directly.');\n }\n return this._stop();\n }\n private _complete(): void {\n for (const observer of this.observers) {\n try {\n observer.complete?.();\n } catch (err) {\n reportUnhandledError(err);\n }\n }\n this.observers.clear();\n }\n private _error(err: unknown): void {\n if (!this.observers.size) {\n if (!this._parent) {\n reportUnhandledError(err);\n }\n return;\n }\n let reportError = false;\n\n for (const observer of this.observers) {\n const errorListener = observer.error;\n reportError ||= !errorListener;\n try {\n errorListener?.(err);\n } catch (err2) {\n reportUnhandledError(err2);\n }\n }\n this.observers.clear();\n if (reportError) {\n reportUnhandledError(err);\n }\n }\n private _stopProcedure(): this {\n if (this.status !== ActorStatus.Running) {\n // Actor already stopped; do nothing\n return this;\n }\n\n // Cancel all delayed events\n for (const key of Object.keys(this.delayedEventsMap)) {\n this.clock.clearTimeout(this.delayedEventsMap[key]);\n }\n\n // TODO: mailbox.reset\n this.mailbox.clear();\n // TODO: after `stop` we must prepare ourselves for receiving events again\n // events sent *after* stop signal must be queued\n // it seems like this should be the common behavior for all of our consumers\n // so perhaps this should be unified somehow for all of them\n this.mailbox = new Mailbox(this._process.bind(this));\n\n this.status = ActorStatus.Stopped;\n this.system._unregister(this);\n\n return this;\n }\n\n /**\n * @internal\n */\n public _send(event: EventFromLogic<TLogic>) {\n if (this.status === ActorStatus.Stopped) {\n // do nothing\n if (isDevelopment) {\n const eventString = JSON.stringify(event);\n\n console.warn(\n `Event \"${event.type}\" was sent to stopped actor \"${this.id} (${this.sessionId})\". This actor has already reached its final state, and will not transition.\\nEvent: ${eventString}`\n );\n }\n return;\n }\n\n this.mailbox.enqueue(event);\n }\n\n /**\n * Sends an event to the running Actor to trigger a transition.\n *\n * @param event The event to send\n */\n public send(event: EventFromLogic<TLogic>) {\n if (isDevelopment && typeof event === 'string') {\n throw new Error(\n `Only event objects may be sent to actors; use .send({ type: \"${event}\" }) instead`\n );\n }\n this.system._relay(undefined, this, event);\n }\n\n // TODO: make private (and figure out a way to do this within the machine)\n public delaySend(params: {\n event: EventObject;\n id: string | undefined;\n delay: number;\n to?: AnyActorRef;\n }): void {\n const { event, id, delay } = params;\n const timerId = this.clock.setTimeout(() => {\n this.system._relay(\n this,\n params.to ?? this,\n event as EventFromLogic<TLogic>\n );\n }, delay);\n\n // TODO: consider the rehydration story here\n if (id) {\n this.delayedEventsMap[id] = timerId;\n }\n }\n\n // TODO: make private (and figure out a way to do this within the machine)\n public cancel(sendId: string | number): void {\n this.clock.clearTimeout(this.delayedEventsMap[sendId]);\n delete this.delayedEventsMap[sendId];\n }\n\n private attachDevTools(): void {\n const { devTools } = this.options;\n if (devTools) {\n const resolvedDevToolsAdapter =\n typeof devTools === 'function' ? devTools : devToolsAdapter;\n\n resolvedDevToolsAdapter(this);\n }\n }\n public toJSON() {\n return {\n xstate$$type: $$ACTOR_TYPE,\n id: this.id\n };\n }\n\n public getPersistedState(): Snapshot<unknown> {\n return this.logic.getPersistedState(this._state);\n }\n\n public [symbolObservable](): InteropSubscribable<SnapshotFrom<TLogic>> {\n return this;\n }\n\n public getSnapshot(): SnapshotFrom<TLogic> {\n return this._state;\n }\n}\n\n/**\n * Creates a new `ActorRef` instance for the given machine with the provided options, if any.\n *\n * @param machine The machine to create an actor from\n * @param options `ActorRef` options\n */\nexport function createActor<TMachine extends AnyStateMachine>(\n machine: AreAllImplementationsAssumedToBeProvided<\n TMachine['__TResolvedTypesMeta']\n > extends true\n ? TMachine\n : MissingImplementationsError<TMachine['__TResolvedTypesMeta']>,\n options?: ActorOptions<TMachine>\n): Actor<TMachine>;\nexport function createActor<TLogic extends AnyActorLogic>(\n logic: TLogic,\n options?: ActorOptions<TLogic>\n): Actor<TLogic>;\nexport function createActor(logic: any, options?: ActorOptions<any>): any {\n const interpreter = new Actor(logic, options);\n\n return interpreter;\n}\n\n/**\n * Creates a new Interpreter instance for the given machine with the provided options, if any.\n *\n * @deprecated Use `createActor` instead\n */\nexport const interpret = createActor;\n\n/**\n * @deprecated Use `Actor` instead.\n */\nexport type Interpreter = typeof Actor;\n","import {\n ActorLogic,\n ActorContext,\n ActorSystem,\n EventObject,\n ActorRefFrom,\n AnyActorSystem,\n Snapshot\n} from '../types';\n\nexport type TransitionSnapshot<TContext> = Snapshot<undefined> & {\n context: TContext;\n};\n\nexport type TransitionActorLogic<\n TContext,\n TEvent extends EventObject,\n TInput\n> = ActorLogic<TransitionSnapshot<TContext>, TEvent, TInput, AnyActorSystem>;\n\nexport type TransitionActorRef<\n TContext,\n TEvent extends EventObject\n> = ActorRefFrom<\n TransitionActorLogic<TransitionSnapshot<TContext>, TEvent, unknown>\n>;\n\n/**\n * Returns actor logic from a transition function and its initial state.\n *\n * A transition function is a function that takes the current state and an event and returns the next state.\n *\n * @param transition The transition function that returns the next state given the current state and event.\n * @param initialContext The initial state of the transition function.\n * @returns Actor logic\n */\nexport function fromTransition<\n TContext,\n TEvent extends EventObject,\n TSystem extends ActorSystem<any>,\n TInput\n>(\n transition: (\n state: TContext,\n event: TEvent,\n actorContext: ActorContext<TransitionSnapshot<TContext>, TEvent, TSystem>\n ) => TContext,\n initialContext:\n | TContext\n | (({\n input,\n self\n }: {\n input: TInput;\n self: TransitionActorRef<TContext, TEvent>;\n }) => TContext) // TODO: type\n): TransitionActorLogic<TContext, TEvent, TInput> {\n return {\n config: transition,\n transition: (state, event, actorContext) => {\n return {\n ...state,\n context: transition(state.context, event as TEvent, actorContext as any)\n };\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n context:\n typeof initialContext === 'function'\n ? (initialContext as any)({ input })\n : initialContext\n };\n },\n getPersistedState: (state) => state,\n restoreState: (state: any) => state\n };\n}\n","import {\n ActorLogic,\n ActorRefFrom,\n ActorSystem,\n AnyActorSystem,\n Snapshot\n} from '../types';\nimport { XSTATE_STOP } from '../constants';\n\nexport type PromiseSnapshot<TOutput, TInput> = Snapshot<TOutput> & {\n input: TInput | undefined;\n};\n\nconst resolveEventType = '$$xstate.resolve';\nconst rejectEventType = '$$xstate.reject';\n\nexport type PromiseActorEvents<T> =\n | {\n type: typeof resolveEventType;\n data: T;\n }\n | {\n type: typeof rejectEventType;\n data: any;\n }\n | {\n type: typeof XSTATE_STOP;\n };\n\nexport type PromiseActorLogic<TOutput, TInput = unknown> = ActorLogic<\n PromiseSnapshot<TOutput, TInput>,\n { type: string; [k: string]: unknown },\n TInput, // input\n ActorSystem<any>\n>;\n\nexport type PromiseActorRef<TOutput> = ActorRefFrom<\n PromiseActorLogic<TOutput, unknown>\n>;\n\nexport function fromPromise<TOutput, TInput = unknown>(\n // TODO: add types\n promiseCreator: ({\n input,\n system\n }: {\n input: TInput;\n system: AnyActorSystem;\n self: PromiseActorRef<TOutput>;\n }) => PromiseLike<TOutput>\n): PromiseActorLogic<TOutput, TInput> {\n // TODO: add event types\n const logic: PromiseActorLogic<TOutput, TInput> = {\n config: promiseCreator,\n transition: (state, event) => {\n if (state.status !== 'active') {\n return state;\n }\n\n switch (event.type) {\n case resolveEventType: {\n const resolvedValue = (event as any).data;\n return {\n ...state,\n status: 'done',\n output: resolvedValue,\n input: undefined\n };\n }\n case rejectEventType:\n return {\n ...state,\n status: 'error',\n error: (event as any).data,\n input: undefined\n };\n case XSTATE_STOP:\n return {\n ...state,\n status: 'stopped',\n input: undefined\n };\n default:\n return state;\n }\n },\n start: (state, { self, system }) => {\n // TODO: determine how to allow customizing this so that promises\n // can be restarted if necessary\n if (state.status !== 'active') {\n return;\n }\n\n const resolvedPromise = Promise.resolve(\n promiseCreator({ input: state.input!, system, self })\n );\n\n resolvedPromise.then(\n (response) => {\n if (self.getSnapshot().status !== 'active') {\n return;\n }\n system._relay(self, self, { type: resolveEventType, data: response });\n },\n (errorData) => {\n if (self.getSnapshot().status !== 'active') {\n return;\n }\n system._relay(self, self, { type: rejectEventType, data: errorData });\n }\n );\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n input\n };\n },\n getPersistedState: (state) => state,\n restoreState: (state: any) => state\n };\n\n return logic;\n}\n","import { createActor } from '../interpreter.ts';\nimport type { ActorRef, AnyEventObject, Snapshot } from '../types.ts';\nimport { fromTransition } from './transition.ts';\nexport { fromCallback, type CallbackActorLogic } from './callback.ts';\nexport {\n fromEventObservable,\n fromObservable,\n type ObservableActorLogic\n} from './observable.ts';\nexport { fromPromise, type PromiseActorLogic } from './promise.ts';\nexport {\n fromTransition,\n type TransitionActorLogic,\n type TransitionSnapshot\n} from './transition.ts';\n\nconst emptyLogic = fromTransition((_) => undefined, undefined);\n\nexport function createEmptyActor(): ActorRef<\n AnyEventObject,\n Snapshot<undefined>\n> {\n return createActor(emptyLogic);\n}\n","import {\n ActorLogic,\n EventObject,\n AnyActorSystem,\n AnyEventObject,\n ActorSystem,\n ActorRefFrom,\n TODO,\n Snapshot\n} from '../types';\nimport { XSTATE_STOP } from '../constants.ts';\n\ntype CallbackSnapshot<TInput, TEvent> = Snapshot<undefined> & {\n input: TInput;\n _receivers: Set<(e: TEvent) => void>;\n _dispose: (() => void) | void;\n};\n\nexport type CallbackActorLogic<\n TEvent extends EventObject,\n TInput = unknown\n> = ActorLogic<\n CallbackSnapshot<TInput, TEvent>,\n TEvent,\n TInput,\n ActorSystem<any>\n>;\n\nexport type CallbackActorRef<\n TEvent extends EventObject,\n TInput = unknown\n> = ActorRefFrom<CallbackActorLogic<TEvent, TInput>>;\n\nexport type Receiver<TEvent extends EventObject> = (\n listener: {\n bivarianceHack(event: TEvent): void;\n }['bivarianceHack']\n) => void;\n\nexport type InvokeCallback<\n TEvent extends EventObject = AnyEventObject,\n TSentEvent extends EventObject = AnyEventObject,\n TInput = unknown\n> = ({\n input,\n system,\n self,\n sendBack,\n receive\n}: {\n input: TInput;\n system: AnyActorSystem;\n self: CallbackActorRef<TEvent>;\n sendBack: (event: TSentEvent) => void;\n receive: Receiver<TEvent>;\n}) => (() => void) | void;\n\nexport function fromCallback<TEvent extends EventObject, TInput = unknown>(\n invokeCallback: InvokeCallback<TEvent, AnyEventObject, TInput>\n): CallbackActorLogic<TEvent, TInput> {\n const logic: CallbackActorLogic<TEvent, TInput> = {\n config: invokeCallback,\n start: (_state, { self, system }) => {\n system._relay(self, self, { type: 'xstate.create' });\n },\n transition: (state, event, { self, system }) => {\n if (event.type === 'xstate.create') {\n const sendBack = (eventForParent: AnyEventObject) => {\n if (state.status === 'stopped') {\n return;\n }\n\n if (self._parent) {\n system._relay(self, self._parent, eventForParent);\n }\n };\n\n const receive: Receiver<TEvent> = (newListener) => {\n state._receivers.add(newListener);\n };\n\n state._dispose = invokeCallback({\n input: state.input,\n system,\n self: self as TODO,\n sendBack,\n receive\n });\n\n return state;\n }\n\n if (event.type === XSTATE_STOP) {\n state = {\n ...state,\n status: 'stopped',\n error: undefined\n };\n\n if (typeof state._dispose === 'function') {\n state._dispose();\n }\n return state;\n }\n\n state._receivers.forEach((receiver) => receiver(event));\n\n return state;\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n input,\n _receivers: new Set(),\n _dispose: undefined\n };\n },\n getPersistedState: ({ _dispose, _receivers, ...rest }) => rest,\n restoreState: (state: any) => ({\n _receivers: new Set(),\n _dispose: undefined,\n ...state\n })\n };\n\n return logic;\n}\n","import { XSTATE_STOP } from '../constants';\nimport {\n Subscribable,\n ActorLogic,\n EventObject,\n Subscription,\n AnyActorSystem,\n ActorRefFrom,\n Snapshot\n} from '../types';\n\nexport type ObservableSnapshot<TContext, TInput> = Snapshot<undefined> & {\n context: TContext | undefined;\n input: TInput | undefined;\n _subscription: Subscription | undefined;\n};\n\nexport type ObservableActorLogic<TContext, TInput> = ActorLogic<\n ObservableSnapshot<TContext, TInput>,\n { type: string; [k: string]: unknown },\n TInput,\n AnyActorSystem\n>;\n\nexport type ObservableActorRef<TContext> = ActorRefFrom<\n ObservableActorLogic<TContext, any>\n>;\n\nexport function fromObservable<TContext, TInput>(\n observableCreator: ({\n input,\n system\n }: {\n input: TInput;\n system: AnyActorSystem;\n self: ObservableActorRef<TContext>;\n }) => Subscribable<TContext>\n): ObservableActorLogic<TContext, TInput> {\n const nextEventType = '$$xstate.next';\n const errorEventType = '$$xstate.error';\n const completeEventType = '$$xstate.complete';\n\n // TODO: add event types\n const logic: ObservableActorLogic<TContext, TInput> = {\n config: observableCreator,\n transition: (snapshot, event, { self, id, defer, system }) => {\n if (snapshot.status !== 'active') {\n return snapshot;\n }\n\n switch (event.type) {\n case nextEventType: {\n const newSnapshot = {\n ...snapshot,\n context: event.data as TContext\n };\n return newSnapshot;\n }\n case errorEventType:\n return {\n ...snapshot,\n status: 'error',\n error: (event as any).data,\n input: undefined,\n _subscription: undefined\n };\n case completeEventType:\n return {\n ...snapshot,\n status: 'done',\n input: undefined,\n _subscription: undefined\n };\n case XSTATE_STOP:\n snapshot._subscription!.unsubscribe();\n return {\n ...snapshot,\n status: 'stopped',\n input: undefined,\n _subscription: undefined\n };\n default:\n return snapshot;\n }\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n context: undefined,\n input,\n _subscription: undefined\n };\n },\n start: (state, { self, system }) => {\n if (state.status === 'done') {\n // Do not restart a completed observable\n return;\n }\n state._subscription = observableCreator({\n input: state.input!,\n system,\n self\n }).subscribe({\n next: (value) => {\n system._relay(self, self, { type: nextEventType, data: value });\n },\n error: (err) => {\n system._relay(self, self, { type: errorEventType, data: err });\n },\n complete: () => {\n system._relay(self, self, { type: completeEventType });\n }\n });\n },\n getPersistedState: ({ _subscription, ...state }) => state,\n restoreState: (state) => ({\n ...(state as any),\n _subscription: undefined\n })\n };\n\n return logic;\n}\n\n/**\n * Creates event observable logic that listens to an observable\n * that delivers event objects.\n *\n *\n * @param lazyObservable A function that creates an observable\n * @returns Event observable logic\n */\n\nexport function fromEventObservable<T extends EventObject, TInput>(\n lazyObservable: ({\n input,\n system\n }: {\n input: TInput;\n system: AnyActorSystem;\n self: ObservableActorRef<T>;\n }) => Subscribable<T>\n): ObservableActorLogic<T, TInput> {\n const errorEventType = '$$xstate.error';\n const completeEventType = '$$xstate.complete';\n\n // TODO: event types\n const logic: ObservableActorLogic<T, TInput> = {\n config: lazyObservable,\n transition: (state, event) => {\n if (state.status !== 'active') {\n return state;\n }\n\n switch (event.type) {\n case errorEventType:\n return {\n ...state,\n status: 'error',\n error: (event as any).data,\n input: undefined,\n _subscription: undefined\n };\n case completeEventType:\n return {\n ...state,\n status: 'done',\n input: undefined,\n _subscription: undefined\n };\n case XSTATE_STOP:\n state._subscription!.unsubscribe();\n return {\n ...state,\n status: 'stopped',\n input: undefined,\n _subscription: undefined\n };\n default:\n return state;\n }\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n context: undefined,\n input,\n _subscription: undefined\n };\n },\n start: (state, { self, system }) => {\n if (state.status === 'done') {\n // Do not restart a completed observable\n return;\n }\n\n state._subscription = lazyObservable({\n input: state.input!,\n system,\n self\n }).subscribe({\n next: (value) => {\n if (self._parent) {\n system._relay(self, self._parent, value);\n }\n },\n error: (err) => {\n system._relay(self, self, { type: errorEventType, data: err });\n },\n complete: () => {\n system._relay(self, self, { type: completeEventType });\n }\n });\n },\n getPersistedState: ({ _subscription, ...state }) => state,\n restoreState: (state: any) => ({\n ...state,\n _subscription: undefined\n })\n };\n\n return logic;\n}\n"],"names":["Mailbox","constructor","_process","this","_active","_current","_last","start","flush","clear","next","enqueue","event","enqueued","value","consumed","XSTATE_STOP","createErrorActorEvent","id","data","type","getDevTools","w","globalThis","self","window","__xstate__","devToolsAdapter","service","devTools","register","reportUnhandledError","err","setTimeout","symbolObservable","Symbol","observable","idCounter","toObserver","nextHandler","errorHandler","completionHandler","isObserver","undefined","bind","error","complete","ActorStatus","defaultOptions","clock","fn","ms","clearTimeout","logger","console","log","Actor","logic","options","_state","mailbox","delayedEventsMap","observers","Set","status","NotStarted","_parent","ref","_actorContext","_systemId","sessionId","system","_doneEvent","src","_deferred","resolvedOptions","parent","systemId","inspect","rootActor","children","Map","keyedActors","reverseKeyedActors","WeakMap","_bookId","_register","actorRef","set","_unregister","delete","get","_set","existing","Error","observer","add","_sendInspectionEvent","resolvedInspectionEvent","rootId","forEach","_relay","source","target","sourceRef","targetRef","_send","createSystem","defer","push","stopChild","child","_stop","send","_initState","state","restoreState","getInitialState","input","update","snapshot","deferredFn","shift","_stopProcedure","_complete","invokeId","output","_error","subscribe","nextListenerOrObserver","errorListener","completeListener","Stopped","unsubscribe","Running","initEvent","attachDevTools","nextState","caughtError","transition","stop","size","reportError","err2","key","Object","keys","delaySend","params","delay","timerId","to","cancel","sendId","toJSON","xstate$$type","getPersistedState","getSnapshot","fromTransition","initialContext","config","actorContext","context","_","resolveEventType","rejectEventType","emptyLogic","invokeCallback","sendBack","eventForParent","receive","newListener","_receivers","_dispose","receiver","rest","lazyObservable","errorEventType","completeEventType","_subscription","observableCreator","nextEventType","promiseCreator","resolvedValue","Promise","resolve","then","response","errorData"],"mappings":"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"}
1
+ {"version":3,"file":"xstate-actors.umd.min.js","sources":["../../src/Mailbox.ts","../../src/constants.ts","../../src/eventUtils.ts","../../src/dev/index.ts","../../src/reportUnhandledError.ts","../../src/symbolObservable.ts","../../src/system.ts","../../src/utils.ts","../../src/interpreter.ts","../../src/actors/transition.ts","../../src/actors/promise.ts","../../src/actors/index.ts","../../src/actors/callback.ts","../../src/actors/observable.ts"],"sourcesContent":["interface MailboxItem<T> {\n value: T;\n next: MailboxItem<T> | null;\n}\n\nexport class Mailbox<T> {\n private _active: boolean = false;\n private _current: MailboxItem<T> | null = null;\n private _last: MailboxItem<T> | null = null;\n\n constructor(private _process: (ev: T) => void) {}\n\n public start() {\n this._active = true;\n this.flush();\n }\n\n public clear(): void {\n // we can't set _current to null because we might be currently processing\n // and enqueue following clear shouldnt start processing the enqueued item immediately\n if (this._current) {\n this._current.next = null;\n this._last = this._current;\n }\n }\n\n public enqueue(event: T): void {\n const enqueued = {\n value: event,\n next: null\n };\n\n if (this._current) {\n this._last!.next = enqueued;\n this._last = enqueued;\n return;\n }\n\n this._current = enqueued;\n this._last = enqueued;\n\n if (this._active) {\n this.flush();\n }\n }\n\n private flush() {\n while (this._current) {\n // atm the given _process is responsible for implementing proper try/catch handling\n // we assume here that this won't throw in a way that can affect this mailbox\n const consumed = this._current;\n this._process(consumed.value);\n this._current = consumed.next;\n }\n this._last = null;\n }\n}\n","export const STATE_DELIMITER = '.';\nexport const TARGETLESS_KEY = '';\nexport const NULL_EVENT = '';\nexport const STATE_IDENTIFIER = '#';\nexport const WILDCARD = '*';\nexport const XSTATE_INIT = 'xstate.init';\nexport const XSTATE_ERROR = 'xstate.error';\nexport const XSTATE_STOP = 'xstate.stop';\n","import { XSTATE_INIT } from './constants.ts';\nimport { DoneActorEvent, DoneStateEvent, ErrorActorEvent } from './types.ts';\n\n/**\n * Returns an event that represents an implicit event that\n * is sent after the specified `delay`.\n *\n * @param delayRef The delay in milliseconds\n * @param id The state node ID where this event is handled\n */\nexport function createAfterEvent(delayRef: number | string, id?: string) {\n const idSuffix = id ? `#${id}` : '';\n return { type: `xstate.after(${delayRef})${idSuffix}` } as const;\n}\n\n/**\n * Returns an event that represents that a final state node\n * has been reached in the parent state node.\n *\n * @param id The final state node's parent state node `id`\n * @param output The data to pass into the event\n */\nexport function createDoneStateEvent(\n id: string,\n output?: unknown\n): DoneStateEvent {\n return {\n type: `xstate.done.state.${id}`,\n output\n };\n}\n\n/**\n * Returns an event that represents that an invoked service has terminated.\n *\n * An invoked service is terminated when it has reached a top-level final state node,\n * but not when it is canceled.\n *\n * @param invokeId The invoked service ID\n * @param output The data to pass into the event\n */\nexport function createDoneActorEvent(\n invokeId: string,\n output?: unknown\n): DoneActorEvent {\n return {\n type: `xstate.done.actor.${invokeId}`,\n output\n };\n}\n\nexport function createErrorActorEvent(\n id: string,\n data?: unknown\n): ErrorActorEvent {\n return { type: `xstate.error.actor.${id}`, data };\n}\n\nexport function createInitEvent(input: unknown) {\n return { type: XSTATE_INIT, input } as const;\n}\n","import isDevelopment from '#is-development';\nimport { AnyActor, DevToolsAdapter } from '../types.ts';\n\ninterface DevInterface {\n services: Set<AnyActor>;\n register(service: AnyActor): void;\n onRegister(listener: ServiceListener): void;\n}\ntype ServiceListener = (service: AnyActor) => void;\n\nexport interface XStateDevInterface {\n register: (service: AnyActor) => void;\n unregister: (service: AnyActor) => void;\n onRegister: (listener: ServiceListener) => {\n unsubscribe: () => void;\n };\n services: Set<AnyActor>;\n}\n\n// From https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis\nexport function getGlobal(): typeof globalThis | undefined {\n if (typeof globalThis !== 'undefined') {\n return globalThis;\n }\n if (typeof self !== 'undefined') {\n return self;\n }\n if (typeof window !== 'undefined') {\n return window;\n }\n if (typeof global !== 'undefined') {\n return global;\n }\n if (isDevelopment) {\n console.warn(\n 'XState could not find a global object in this environment. Please let the maintainers know and raise an issue here: https://github.com/statelyai/xstate/issues'\n );\n }\n}\n\nfunction getDevTools(): DevInterface | undefined {\n const w = getGlobal();\n if (!!(w as any).__xstate__) {\n return (w as any).__xstate__;\n }\n\n return undefined;\n}\n\nexport function registerService(service: AnyActor) {\n if (typeof window === 'undefined') {\n return;\n }\n\n const devTools = getDevTools();\n\n if (devTools) {\n devTools.register(service);\n }\n}\n\nexport const devToolsAdapter: DevToolsAdapter = (service) => {\n if (typeof window === 'undefined') {\n return;\n }\n\n const devTools = getDevTools();\n\n if (devTools) {\n devTools.register(service);\n }\n};\n","/**\n * This function makes sure that unhandled errors are thrown in a separate macrotask.\n * It allows those errors to be detected by global error handlers and reported to bug tracking services\n * without interrupting our own stack of execution.\n *\n * @param err error to be thrown\n */\nexport function reportUnhandledError(err: unknown) {\n setTimeout(() => {\n throw err;\n });\n}\n","export const symbolObservable: typeof Symbol.observable = (() =>\n (typeof Symbol === 'function' && Symbol.observable) ||\n '@@observable')() as any;\n","import {\n AnyEventObject,\n ActorSystem,\n ActorSystemInfo,\n AnyActorRef,\n Observer,\n Snapshot\n} from './types.ts';\n\nlet idCounter = 0;\nexport function createSystem<T extends ActorSystemInfo>(\n rootActor: AnyActorRef\n): ActorSystem<T> {\n const children = new Map<string, AnyActorRef>();\n const keyedActors = new Map<keyof T['actors'], AnyActorRef | undefined>();\n const reverseKeyedActors = new WeakMap<AnyActorRef, keyof T['actors']>();\n const observers = new Set<Observer<InspectionEvent>>();\n\n const system: ActorSystem<T> = {\n _bookId: () => `x:${idCounter++}`,\n _register: (sessionId, actorRef) => {\n children.set(sessionId, actorRef);\n return sessionId;\n },\n _unregister: (actorRef) => {\n children.delete(actorRef.sessionId);\n const systemId = reverseKeyedActors.get(actorRef);\n\n if (systemId !== undefined) {\n keyedActors.delete(systemId);\n reverseKeyedActors.delete(actorRef);\n }\n },\n get: (systemId) => {\n return keyedActors.get(systemId) as T['actors'][any];\n },\n _set: (systemId, actorRef) => {\n const existing = keyedActors.get(systemId);\n if (existing && existing !== actorRef) {\n throw new Error(\n `Actor with system ID '${systemId as string}' already exists.`\n );\n }\n\n keyedActors.set(systemId, actorRef);\n reverseKeyedActors.set(actorRef, systemId);\n },\n inspect: (observer) => {\n observers.add(observer);\n },\n _sendInspectionEvent: (event) => {\n const resolvedInspectionEvent: InspectionEvent = {\n ...event,\n rootId: rootActor.sessionId\n };\n observers.forEach((observer) => observer.next?.(resolvedInspectionEvent));\n },\n _relay: (source, target, event) => {\n system._sendInspectionEvent({\n type: '@xstate.event',\n sourceRef: source,\n actorRef: target,\n event\n });\n\n target._send(event);\n }\n };\n\n return system;\n}\nexport interface BaseInspectionEventProperties {\n rootId: string; // the session ID of the root\n /**\n * The relevant actorRef for the inspection event.\n * - For snapshot events, this is the `actorRef` of the snapshot.\n * - For event events, this is the target `actorRef` (recipient of event).\n * - For actor events, this is the `actorRef` of the registered actor.\n */\n actorRef: AnyActorRef;\n}\n\nexport interface InspectedSnapshotEvent extends BaseInspectionEventProperties {\n type: '@xstate.snapshot';\n event: AnyEventObject; // { type: string, ... }\n snapshot: Snapshot<unknown>;\n}\n\nexport interface InspectedEventEvent extends BaseInspectionEventProperties {\n type: '@xstate.event';\n // The source might not exist, e.g. when:\n // - root init events\n // - events sent from external (non-actor) sources\n sourceRef: AnyActorRef | undefined;\n event: AnyEventObject; // { type: string, ... }\n}\n\nexport interface InspectedActorEvent extends BaseInspectionEventProperties {\n type: '@xstate.actor';\n}\n\nexport type InspectionEvent =\n | InspectedSnapshotEvent\n | InspectedEventEvent\n | InspectedActorEvent;\n","import isDevelopment from '#is-development';\nimport { AnyActorLogic, AnyState } from './index.ts';\nimport { STATE_DELIMITER, TARGETLESS_KEY } from './constants.ts';\nimport type { StateNode } from './StateNode.ts';\nimport type {\n ActorLogic,\n AnyEventObject,\n EventObject,\n MachineContext,\n Mapper,\n Observer,\n ErrorActorEvent,\n SingleOrArray,\n StateLike,\n StateValue,\n Subscribable,\n TransitionConfigTarget,\n AnyActorRef,\n AnyTransitionConfig,\n NonReducibleUnknown,\n AnyStateMachine,\n InvokeConfig\n} from './types.ts';\n\nexport function keys<T extends object>(value: T): Array<keyof T & string> {\n return Object.keys(value) as Array<keyof T & string>;\n}\n\nexport function matchesState(\n parentStateId: StateValue,\n childStateId: StateValue\n): boolean {\n const parentStateValue = toStateValue(parentStateId);\n const childStateValue = toStateValue(childStateId);\n\n if (typeof childStateValue === 'string') {\n if (typeof parentStateValue === 'string') {\n return childStateValue === parentStateValue;\n }\n\n // Parent more specific than child\n return false;\n }\n\n if (typeof parentStateValue === 'string') {\n return parentStateValue in childStateValue;\n }\n\n return Object.keys(parentStateValue).every((key) => {\n if (!(key in childStateValue)) {\n return false;\n }\n\n return matchesState(parentStateValue[key], childStateValue[key]);\n });\n}\n\nexport function toStatePath(stateId: string | string[]): string[] {\n try {\n if (isArray(stateId)) {\n return stateId;\n }\n\n return stateId.toString().split(STATE_DELIMITER);\n } catch (e) {\n throw new Error(`'${stateId}' is not a valid state path.`);\n }\n}\n\nexport function isStateLike(state: any): state is AnyState {\n return (\n typeof state === 'object' &&\n 'value' in state &&\n 'context' in state &&\n 'event' in state\n );\n}\n\nexport function toStateValue(\n stateValue: StateLike<any> | StateValue | string[]\n): StateValue {\n if (isStateLike(stateValue)) {\n return stateValue.value;\n }\n\n if (isArray(stateValue)) {\n return pathToStateValue(stateValue);\n }\n\n if (typeof stateValue !== 'string') {\n return stateValue as StateValue;\n }\n\n const statePath = toStatePath(stateValue as string);\n\n return pathToStateValue(statePath);\n}\n\nexport function pathToStateValue(statePath: string[]): StateValue {\n if (statePath.length === 1) {\n return statePath[0];\n }\n\n const value: StateValue = {};\n let marker = value;\n\n for (let i = 0; i < statePath.length - 1; i++) {\n if (i === statePath.length - 2) {\n marker[statePath[i]] = statePath[i + 1];\n } else {\n const previous = marker;\n marker = {};\n previous[statePath[i]] = marker;\n }\n }\n\n return value;\n}\n\nexport function mapValues<P, O extends Record<string, unknown>>(\n collection: O,\n iteratee: (item: O[keyof O], key: keyof O, collection: O, i: number) => P\n): { [key in keyof O]: P };\nexport function mapValues(\n collection: Record<string, unknown>,\n iteratee: (\n item: unknown,\n key: string,\n collection: Record<string, unknown>,\n i: number\n ) => unknown\n) {\n const result: Record<string, unknown> = {};\n\n const collectionKeys = Object.keys(collection);\n for (let i = 0; i < collectionKeys.length; i++) {\n const key = collectionKeys[i];\n result[key] = iteratee(collection[key], key, collection, i);\n }\n\n return result;\n}\n\nexport function mapFilterValues<T, P>(\n collection: { [key: string]: T },\n iteratee: (item: T, key: string, collection: { [key: string]: T }) => P,\n predicate: (item: T) => boolean\n): { [key: string]: P } {\n const result: { [key: string]: P } = {};\n\n for (const key of Object.keys(collection)) {\n const item = collection[key];\n\n if (!predicate(item)) {\n continue;\n }\n\n result[key] = iteratee(item, key, collection);\n }\n\n return result;\n}\n\n/**\n * Retrieves a value at the given path.\n * @param props The deep path to the prop of the desired value\n */\nexport function path<T extends Record<string, any>>(props: string[]): any {\n return (object: T): any => {\n let result: T = object;\n\n for (const prop of props) {\n result = result[prop as keyof typeof result];\n }\n\n return result;\n };\n}\n\nexport function toStatePaths(stateValue: StateValue | undefined): string[][] {\n if (!stateValue) {\n return [[]];\n }\n\n if (typeof stateValue === 'string') {\n return [[stateValue]];\n }\n\n const result = flatten(\n Object.keys(stateValue).map((key) => {\n const subStateValue = stateValue[key];\n\n if (\n typeof subStateValue !== 'string' &&\n (!subStateValue || !Object.keys(subStateValue).length)\n ) {\n return [[key]];\n }\n\n return toStatePaths(stateValue[key]).map((subPath) => {\n return [key].concat(subPath);\n });\n })\n );\n\n return result;\n}\n\nexport function flatten<T>(array: Array<T | T[]>): T[] {\n return ([] as T[]).concat(...array);\n}\n\nexport function toArrayStrict<T>(value: readonly T[] | T): readonly T[] {\n if (isArray(value)) {\n return value;\n }\n return [value];\n}\n\nexport function toArray<T>(value: readonly T[] | T | undefined): readonly T[] {\n if (value === undefined) {\n return [];\n }\n return toArrayStrict(value);\n}\n\nexport function resolveOutput<\n TContext extends MachineContext,\n TExpressionEvent extends EventObject\n>(\n mapper:\n | Mapper<TContext, TExpressionEvent, unknown, EventObject>\n | NonReducibleUnknown,\n context: TContext,\n event: TExpressionEvent,\n self: AnyActorRef\n): unknown {\n if (typeof mapper === 'function') {\n return mapper({ context, event, self });\n }\n\n if (\n isDevelopment &&\n !!mapper &&\n typeof mapper === 'object' &&\n Object.values(mapper).some((val) => typeof val === 'function')\n ) {\n console.warn(\n `Dynamically mapping values to individual properties is deprecated. Use a single function that returns the mapped object instead.\\nFound object containing properties whose values are possibly mapping functions: ${Object.entries(\n mapper\n )\n .filter(([key, value]) => typeof value === 'function')\n .map(\n ([key, value]) =>\n `\\n - ${key}: ${(value as () => any)\n .toString()\n .replace(/\\n\\s*/g, '')}`\n )\n .join('')}`\n );\n }\n\n return mapper;\n}\n\nexport function isBuiltInEvent(eventType: string): boolean {\n return /^(done|error)\\./.test(eventType);\n}\n\nexport function isPromiseLike(value: any): value is PromiseLike<any> {\n if (value instanceof Promise) {\n return true;\n }\n // Check if shape matches the Promise/A+ specification for a \"thenable\".\n if (\n value !== null &&\n (typeof value === 'function' || typeof value === 'object') &&\n typeof value.then === 'function'\n ) {\n return true;\n }\n return false;\n}\n\nexport function isActorLogic(value: any): value is ActorLogic<any, any> {\n return (\n value !== null &&\n typeof value === 'object' &&\n 'transition' in value &&\n typeof value.transition === 'function'\n );\n}\n\nexport function partition<T, A extends T, B extends T>(\n items: T[],\n predicate: (item: T) => item is A\n): [A[], B[]] {\n const [truthy, falsy] = [[], []] as [A[], B[]];\n\n for (const item of items) {\n if (predicate(item)) {\n truthy.push(item);\n } else {\n falsy.push(item as B);\n }\n }\n\n return [truthy, falsy];\n}\n\nexport function isArray(value: any): value is readonly any[] {\n return Array.isArray(value);\n}\n\nexport function isObservable<T>(value: any): value is Subscribable<T> {\n return (\n !!value && 'subscribe' in value && typeof value.subscribe === 'function'\n );\n}\n\nexport function isErrorActorEvent(\n event: AnyEventObject\n): event is ErrorActorEvent {\n return event.type.startsWith('xstate.error.actor');\n}\n\nexport function toTransitionConfigArray<\n TContext extends MachineContext,\n TEvent extends EventObject\n>(\n configLike: SingleOrArray<AnyTransitionConfig | TransitionConfigTarget>\n): Array<AnyTransitionConfig> {\n return toArrayStrict(configLike).map((transitionLike) => {\n if (\n typeof transitionLike === 'undefined' ||\n typeof transitionLike === 'string'\n ) {\n return { target: transitionLike };\n }\n\n return transitionLike;\n });\n}\n\nexport function normalizeTarget<\n TContext extends MachineContext,\n TEvent extends EventObject\n>(\n target: SingleOrArray<string | StateNode<TContext, TEvent>> | undefined\n): ReadonlyArray<string | StateNode<TContext, TEvent>> | undefined {\n if (target === undefined || target === TARGETLESS_KEY) {\n return undefined;\n }\n return toArray(target);\n}\n\nexport function reportUnhandledExceptionOnInvocation(\n originalError: any,\n currentError: any,\n id: string\n) {\n if (isDevelopment) {\n const originalStackTrace = originalError.stack\n ? ` Stacktrace was '${originalError.stack}'`\n : '';\n if (originalError === currentError) {\n // tslint:disable-next-line:no-console\n console.error(\n `Missing onError handler for invocation '${id}', error was '${originalError}'.${originalStackTrace}`\n );\n } else {\n const stackTrace = currentError.stack\n ? ` Stacktrace was '${currentError.stack}'`\n : '';\n // tslint:disable-next-line:no-console\n console.error(\n `Missing onError handler and/or unhandled exception/promise rejection for invocation '${id}'. ` +\n `Original error: '${originalError}'. ${originalStackTrace} Current error is '${currentError}'.${stackTrace}`\n );\n }\n }\n}\n\nexport function toObserver<T>(\n nextHandler?: Observer<T> | ((value: T) => void),\n errorHandler?: (error: any) => void,\n completionHandler?: () => void\n): Observer<T> {\n const isObserver = typeof nextHandler === 'object';\n const self = isObserver ? nextHandler : undefined;\n\n return {\n next: (isObserver ? nextHandler.next : nextHandler)?.bind(self),\n error: (isObserver ? nextHandler.error : errorHandler)?.bind(self),\n complete: (isObserver ? nextHandler.complete : completionHandler)?.bind(\n self\n )\n };\n}\n\nexport function createInvokeId(stateNodeId: string, index: number): string {\n return `${stateNodeId}[${index}]`;\n}\n\nexport function resolveReferencedActor(machine: AnyStateMachine, src: string) {\n if (src.startsWith('xstate#')) {\n const [, indexStr] = src.match(/\\[(\\d+)\\]$/)!;\n const node = machine.getStateNodeById(src.slice(7, -(indexStr.length + 2)));\n const invokeConfig = node.config.invoke!;\n return {\n src: (Array.isArray(invokeConfig)\n ? invokeConfig[indexStr as any]\n : (invokeConfig as InvokeConfig<any, any, any, any, any, any>)\n ).src,\n input: undefined\n };\n }\n const referenced = machine.implementations.actors[src];\n return referenced\n ? 'transition' in referenced\n ? { src: referenced, input: undefined }\n : referenced\n : undefined;\n}\n","import isDevelopment from '#is-development';\nimport { Mailbox } from './Mailbox.ts';\nimport {\n createDoneActorEvent,\n createErrorActorEvent,\n createInitEvent\n} from './eventUtils.ts';\nimport { XSTATE_STOP } from './constants.ts';\nimport { devToolsAdapter } from './dev/index.ts';\nimport { reportUnhandledError } from './reportUnhandledError.ts';\nimport { symbolObservable } from './symbolObservable.ts';\nimport { createSystem } from './system.ts';\nimport {\n AreAllImplementationsAssumedToBeProvided,\n MissingImplementationsError\n} from './typegenTypes.ts';\nimport type {\n ActorScope,\n ActorSystem,\n AnyActorLogic,\n AnyStateMachine,\n EventFromLogic,\n SnapshotFrom,\n AnyActorRef,\n DoneActorEvent,\n Snapshot\n} from './types.ts';\nimport {\n ActorRef,\n EventObject,\n InteropSubscribable,\n ActorOptions,\n Observer,\n Subscription\n} from './types.ts';\nimport { toObserver } from './utils.ts';\n\nexport const $$ACTOR_TYPE = 1;\n\nexport type SnapshotListener<TLogic extends AnyActorLogic> = (\n state: SnapshotFrom<TLogic>\n) => void;\n\nexport type EventListener<TEvent extends EventObject = EventObject> = (\n event: TEvent\n) => void;\n\nexport type Listener = () => void;\nexport type ErrorListener = (error: any) => void;\n\nexport interface Clock {\n setTimeout(fn: (...args: any[]) => void, timeout: number): any;\n clearTimeout(id: any): void;\n}\n\nexport enum ActorStatus {\n NotStarted,\n Running,\n Stopped\n}\n\n/**\n * @deprecated Use `ActorStatus` instead.\n */\nexport const InterpreterStatus = ActorStatus;\n\nconst defaultOptions = {\n clock: {\n setTimeout: (fn, ms) => {\n return setTimeout(fn, ms);\n },\n clearTimeout: (id) => {\n return clearTimeout(id);\n }\n } as Clock,\n logger: console.log.bind(console),\n devTools: false\n};\n\n/**\n * An Actor is a running process that can receive events, send events and change its behavior based on the events it receives, which can cause effects outside of the actor. When you run a state machine, it becomes an actor.\n */\nexport class Actor<TLogic extends AnyActorLogic>\n implements ActorRef<EventFromLogic<TLogic>, SnapshotFrom<TLogic>>\n{\n /**\n * The current internal state of the actor.\n */\n private _state!: SnapshotFrom<TLogic>;\n /**\n * The clock that is responsible for setting and clearing timeouts, such as delayed events and transitions.\n */\n public clock: Clock;\n public options: Readonly<ActorOptions<TLogic>>;\n\n /**\n * The unique identifier for this actor relative to its parent.\n */\n public id: string;\n\n private mailbox: Mailbox<EventFromLogic<TLogic>> = new Mailbox(\n this._process.bind(this)\n );\n\n private delayedEventsMap: Record<string, unknown> = {};\n\n private observers: Set<Observer<SnapshotFrom<TLogic>>> = new Set();\n private logger: (...args: any[]) => void;\n /**\n * Whether the service is started.\n */\n public status: ActorStatus = ActorStatus.NotStarted;\n\n // Actor Ref\n public _parent?: ActorRef<any, any>;\n public ref: ActorRef<EventFromLogic<TLogic>, SnapshotFrom<TLogic>>;\n // TODO: add typings for system\n private _actorScope: ActorScope<\n SnapshotFrom<TLogic>,\n EventFromLogic<TLogic>,\n any\n >;\n\n private _systemId: string | undefined;\n\n /**\n * The globally unique process ID for this invocation.\n */\n public sessionId: string;\n\n /**\n * The system to which this actor belongs.\n */\n public system: ActorSystem<any>;\n private _doneEvent?: DoneActorEvent;\n\n public src?: string;\n\n /**\n * Creates a new actor instance for the given logic with the provided options, if any.\n *\n * @param logic The logic to create an actor from\n * @param options Actor options\n */\n constructor(public logic: TLogic, options?: ActorOptions<TLogic>) {\n const resolvedOptions = {\n ...defaultOptions,\n ...options\n } as ActorOptions<TLogic> & typeof defaultOptions;\n\n const { clock, logger, parent, id, systemId, inspect } = resolvedOptions;\n\n this.system = parent?.system ?? createSystem(this);\n\n if (inspect && !parent) {\n // Always inspect at the system-level\n this.system.inspect(toObserver(inspect));\n }\n\n this.sessionId = this.system._bookId();\n this.id = id ?? this.sessionId;\n this.logger = logger;\n this.clock = clock;\n this._parent = parent;\n this.options = resolvedOptions;\n this.src = resolvedOptions.src;\n this.ref = this;\n this._actorScope = {\n self: this,\n id: this.id,\n sessionId: this.sessionId,\n logger: this.logger,\n defer: (fn) => {\n this._deferred.push(fn);\n },\n system: this.system,\n stopChild: (child) => {\n if (child._parent !== this) {\n throw new Error(\n `Cannot stop child actor ${child.id} of ${this.id} because it is not a child`\n );\n }\n (child as any)._stop();\n }\n };\n\n // Ensure that the send method is bound to this Actor instance\n // if destructured\n this.send = this.send.bind(this);\n this.system._sendInspectionEvent({\n type: '@xstate.actor',\n actorRef: this\n });\n this._initState();\n\n if (systemId && (this._state as any).status === 'active') {\n this._systemId = systemId;\n this.system._set(systemId, this);\n }\n }\n\n private _initState() {\n this._state = this.options.state\n ? this.logic.restoreState\n ? this.logic.restoreState(this.options.state, this._actorScope)\n : this.options.state\n : this.logic.getInitialState(this._actorScope, this.options?.input);\n }\n\n // array of functions to defer\n private _deferred: Array<() => void> = [];\n\n private update(snapshot: SnapshotFrom<TLogic>, event: EventObject): void {\n // Update state\n this._state = snapshot;\n\n // Execute deferred effects\n let deferredFn: (typeof this._deferred)[number] | undefined;\n\n while ((deferredFn = this._deferred.shift())) {\n deferredFn();\n }\n\n for (const observer of this.observers) {\n // TODO: should observers be notified in case of the error?\n try {\n observer.next?.(snapshot);\n } catch (err) {\n reportUnhandledError(err);\n }\n }\n\n switch ((this._state as any).status) {\n case 'done':\n this._stopProcedure();\n this._complete();\n this._doneEvent = createDoneActorEvent(\n this.id,\n (this._state as any).output\n );\n if (this._parent) {\n this.system._relay(this, this._parent, this._doneEvent);\n }\n\n break;\n case 'error':\n this._stopProcedure();\n this._error((this._state as any).error);\n if (this._parent) {\n this.system._relay(\n this,\n this._parent,\n createErrorActorEvent(this.id, (this._state as any).error)\n );\n }\n break;\n }\n this.system._sendInspectionEvent({\n type: '@xstate.snapshot',\n actorRef: this,\n event,\n snapshot\n });\n }\n\n /**\n * Subscribe an observer to an actor’s snapshot values.\n *\n * @remarks\n * The observer will receive the actor’s snapshot value when it is emitted. The observer can be:\n * - A plain function that receives the latest snapshot, or\n * - An observer object whose `.next(snapshot)` method receives the latest snapshot\n *\n * @example\n * ```ts\n * // Observer as a plain function\n * const subscription = actor.subscribe((snapshot) => {\n * console.log(snapshot);\n * });\n * ```\n *\n * @example\n * ```ts\n * // Observer as an object\n * const subscription = actor.subscribe({\n * next(snapshot) {\n * console.log(snapshot);\n * },\n * error(err) {\n * // ...\n * },\n * complete() {\n * // ...\n * },\n * });\n * ```\n *\n * The return value of `actor.subscribe(observer)` is a subscription object that has an `.unsubscribe()` method. You can call `subscription.unsubscribe()` to unsubscribe the observer:\n *\n * @example\n * ```ts\n * const subscription = actor.subscribe((snapshot) => {\n * // ...\n * });\n *\n * // Unsubscribe the observer\n * subscription.unsubscribe();\n * ```\n *\n * When the actor is stopped, all of its observers will automatically be unsubscribed.\n *\n * @param observer - Either a plain function that receives the latest snapshot, or an observer object whose `.next(snapshot)` method receives the latest snapshot\n */\n public subscribe(observer: Observer<SnapshotFrom<TLogic>>): Subscription;\n public subscribe(\n nextListener?: (state: SnapshotFrom<TLogic>) => void,\n errorListener?: (error: any) => void,\n completeListener?: () => void\n ): Subscription;\n public subscribe(\n nextListenerOrObserver?:\n | ((state: SnapshotFrom<TLogic>) => void)\n | Observer<SnapshotFrom<TLogic>>,\n errorListener?: (error: any) => void,\n completeListener?: () => void\n ): Subscription {\n const observer = toObserver(\n nextListenerOrObserver,\n errorListener,\n completeListener\n );\n\n if (this.status !== ActorStatus.Stopped) {\n this.observers.add(observer);\n } else {\n try {\n observer.complete?.();\n } catch (err) {\n reportUnhandledError(err);\n }\n }\n\n return {\n unsubscribe: () => {\n this.observers.delete(observer);\n }\n };\n }\n\n /**\n * Starts the Actor from the initial state\n */\n public start(): this {\n if (this.status === ActorStatus.Running) {\n // Do not restart the service if it is already started\n return this;\n }\n\n this.system._register(this.sessionId, this);\n if (this._systemId) {\n this.system._set(this._systemId, this);\n }\n this.status = ActorStatus.Running;\n\n const initEvent = createInitEvent(this.options.input);\n\n this.system._sendInspectionEvent({\n type: '@xstate.event',\n sourceRef: this._parent,\n actorRef: this,\n event: initEvent\n });\n\n const status = (this._state as any).status;\n\n switch (status) {\n case 'done':\n // a state machine can be \"done\" upon initialization (it could reach a final state using initial microsteps)\n // we still need to complete observers, flush deferreds etc\n this.update(\n this._state,\n initEvent as unknown as EventFromLogic<TLogic>\n );\n // fallthrough\n case 'error':\n // TODO: rethink cleanup of observers, mailbox, etc\n return this;\n }\n\n if (this.logic.start) {\n try {\n this.logic.start(this._state, this._actorScope);\n } catch (err) {\n this._stopProcedure();\n this._error(err);\n this._parent?.send(createErrorActorEvent(this.id, err));\n return this;\n }\n }\n\n // TODO: this notifies all subscribers but usually this is redundant\n // there is no real change happening here\n // we need to rethink if this needs to be refactored\n this.update(this._state, initEvent as unknown as EventFromLogic<TLogic>);\n\n if (this.options.devTools) {\n this.attachDevTools();\n }\n\n this.mailbox.start();\n\n return this;\n }\n\n private _process(event: EventFromLogic<TLogic>) {\n // TODO: reexamine what happens when an action (or a guard or smth) throws\n let nextState;\n let caughtError;\n try {\n nextState = this.logic.transition(this._state, event, this._actorScope);\n } catch (err) {\n // we wrap it in a box so we can rethrow it later even if falsy value gets caught here\n caughtError = { err };\n }\n\n if (caughtError) {\n const { err } = caughtError;\n\n this._stopProcedure();\n this._error(err);\n this._parent?.send(createErrorActorEvent(this.id, err));\n return;\n }\n\n this.update(nextState, event);\n if (event.type === XSTATE_STOP) {\n this._stopProcedure();\n this._complete();\n }\n }\n\n private _stop(): this {\n if (this.status === ActorStatus.Stopped) {\n return this;\n }\n this.mailbox.clear();\n if (this.status === ActorStatus.NotStarted) {\n this.status = ActorStatus.Stopped;\n return this;\n }\n this.mailbox.enqueue({ type: XSTATE_STOP } as any);\n\n return this;\n }\n\n /**\n * Stops the Actor and unsubscribe all listeners.\n */\n public stop(): this {\n if (this._parent) {\n throw new Error('A non-root actor cannot be stopped directly.');\n }\n return this._stop();\n }\n private _complete(): void {\n for (const observer of this.observers) {\n try {\n observer.complete?.();\n } catch (err) {\n reportUnhandledError(err);\n }\n }\n this.observers.clear();\n }\n private _error(err: unknown): void {\n if (!this.observers.size) {\n if (!this._parent) {\n reportUnhandledError(err);\n }\n return;\n }\n let reportError = false;\n\n for (const observer of this.observers) {\n const errorListener = observer.error;\n reportError ||= !errorListener;\n try {\n errorListener?.(err);\n } catch (err2) {\n reportUnhandledError(err2);\n }\n }\n this.observers.clear();\n if (reportError) {\n reportUnhandledError(err);\n }\n }\n private _stopProcedure(): this {\n if (this.status !== ActorStatus.Running) {\n // Actor already stopped; do nothing\n return this;\n }\n\n // Cancel all delayed events\n for (const key of Object.keys(this.delayedEventsMap)) {\n this.clock.clearTimeout(this.delayedEventsMap[key]);\n }\n\n // TODO: mailbox.reset\n this.mailbox.clear();\n // TODO: after `stop` we must prepare ourselves for receiving events again\n // events sent *after* stop signal must be queued\n // it seems like this should be the common behavior for all of our consumers\n // so perhaps this should be unified somehow for all of them\n this.mailbox = new Mailbox(this._process.bind(this));\n\n this.status = ActorStatus.Stopped;\n this.system._unregister(this);\n\n return this;\n }\n\n /**\n * @internal\n */\n public _send(event: EventFromLogic<TLogic>) {\n if (this.status === ActorStatus.Stopped) {\n // do nothing\n if (isDevelopment) {\n const eventString = JSON.stringify(event);\n\n console.warn(\n `Event \"${event.type}\" was sent to stopped actor \"${this.id} (${this.sessionId})\". This actor has already reached its final state, and will not transition.\\nEvent: ${eventString}`\n );\n }\n return;\n }\n\n this.mailbox.enqueue(event);\n }\n\n /**\n * Sends an event to the running Actor to trigger a transition.\n *\n * @param event The event to send\n */\n public send(event: EventFromLogic<TLogic>) {\n if (isDevelopment && typeof event === 'string') {\n throw new Error(\n `Only event objects may be sent to actors; use .send({ type: \"${event}\" }) instead`\n );\n }\n this.system._relay(undefined, this, event);\n }\n\n /**\n * TODO: figure out a way to do this within the machine\n * @internal\n */\n public delaySend(params: {\n event: EventObject;\n id: string | undefined;\n delay: number;\n to?: AnyActorRef;\n }): void {\n const { event, id, delay } = params;\n const timerId = this.clock.setTimeout(() => {\n this.system._relay(\n this,\n params.to ?? this,\n event as EventFromLogic<TLogic>\n );\n }, delay);\n\n // TODO: consider the rehydration story here\n if (id) {\n this.delayedEventsMap[id] = timerId;\n }\n }\n\n /**\n * TODO: figure out a way to do this within the machine\n * @internal\n */\n public cancel(sendId: string | number): void {\n this.clock.clearTimeout(this.delayedEventsMap[sendId]);\n delete this.delayedEventsMap[sendId];\n }\n\n private attachDevTools(): void {\n const { devTools } = this.options;\n if (devTools) {\n const resolvedDevToolsAdapter =\n typeof devTools === 'function' ? devTools : devToolsAdapter;\n\n resolvedDevToolsAdapter(this);\n }\n }\n public toJSON() {\n return {\n xstate$$type: $$ACTOR_TYPE,\n id: this.id\n };\n }\n\n public getPersistedState(): Snapshot<unknown> {\n return this.logic.getPersistedState(this._state);\n }\n\n public [symbolObservable](): InteropSubscribable<SnapshotFrom<TLogic>> {\n return this;\n }\n\n /**\n * Read an actor’s snapshot synchronously.\n *\n * @remarks\n * The snapshot represent an actor's last emitted value.\n *\n * When an actor receives an event, its internal state may change.\n * An actor may emit a snapshot when a state transition occurs.\n *\n * Note that some actors, such as callback actors generated with `fromCallback`, will not emit snapshots.\n *\n * @see {@link Actor.subscribe} to subscribe to an actor’s snapshot values.\n * @see {@link Actor.getPersistedState} to persist the internal state of an actor (which is more than just a snapshot).\n */\n public getSnapshot(): SnapshotFrom<TLogic> {\n return this._state;\n }\n}\n\n/**\n * Creates a new `ActorRef` instance for the given machine with the provided options, if any.\n *\n * @param machine The machine to create an actor from\n * @param options `ActorRef` options\n */\nexport function createActor<TMachine extends AnyStateMachine>(\n machine: AreAllImplementationsAssumedToBeProvided<\n TMachine['__TResolvedTypesMeta']\n > extends true\n ? TMachine\n : MissingImplementationsError<TMachine['__TResolvedTypesMeta']>,\n options?: ActorOptions<TMachine>\n): Actor<TMachine>;\nexport function createActor<TLogic extends AnyActorLogic>(\n logic: TLogic,\n options?: ActorOptions<TLogic>\n): Actor<TLogic>;\nexport function createActor(logic: any, options?: ActorOptions<any>): any {\n const interpreter = new Actor(logic, options);\n\n return interpreter;\n}\n\n/**\n * Creates a new Interpreter instance for the given machine with the provided options, if any.\n *\n * @deprecated Use `createActor` instead\n */\nexport const interpret = createActor;\n\n/**\n * @deprecated Use `Actor` instead.\n */\nexport type Interpreter = typeof Actor;\n","import {\n ActorLogic,\n ActorScope,\n ActorSystem,\n EventObject,\n ActorRefFrom,\n AnyActorSystem,\n Snapshot\n} from '../types';\n\nexport type TransitionSnapshot<TContext> = Snapshot<undefined> & {\n context: TContext;\n};\n\nexport type TransitionActorLogic<\n TContext,\n TEvent extends EventObject,\n TInput\n> = ActorLogic<TransitionSnapshot<TContext>, TEvent, TInput, AnyActorSystem>;\n\nexport type TransitionActorRef<\n TContext,\n TEvent extends EventObject\n> = ActorRefFrom<\n TransitionActorLogic<TransitionSnapshot<TContext>, TEvent, unknown>\n>;\n\n/**\n * Returns actor logic from a transition function and its initial state.\n *\n * A transition function is a function that takes the current state and an event and returns the next state.\n *\n * @param transition The transition function that returns the next state given the current state and event.\n * @param initialContext The initial state of the transition function.\n * @returns Actor logic\n */\nexport function fromTransition<\n TContext,\n TEvent extends EventObject,\n TSystem extends ActorSystem<any>,\n TInput\n>(\n transition: (\n state: TContext,\n event: TEvent,\n actorScope: ActorScope<TransitionSnapshot<TContext>, TEvent, TSystem>\n ) => TContext,\n initialContext:\n | TContext\n | (({\n input,\n self\n }: {\n input: TInput;\n self: TransitionActorRef<TContext, TEvent>;\n }) => TContext) // TODO: type\n): TransitionActorLogic<TContext, TEvent, TInput> {\n return {\n config: transition,\n transition: (state, event, actorScope) => {\n return {\n ...state,\n context: transition(state.context, event as TEvent, actorScope as any)\n };\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n context:\n typeof initialContext === 'function'\n ? (initialContext as any)({ input })\n : initialContext\n };\n },\n getPersistedState: (state) => state,\n restoreState: (state: any) => state\n };\n}\n","import {\n ActorLogic,\n ActorRefFrom,\n ActorSystem,\n AnyActorSystem,\n Snapshot\n} from '../types';\nimport { XSTATE_STOP } from '../constants';\n\nexport type PromiseSnapshot<TOutput, TInput> = Snapshot<TOutput> & {\n input: TInput | undefined;\n};\n\nconst resolveEventType = '$$xstate.resolve';\nconst rejectEventType = '$$xstate.reject';\n\nexport type PromiseActorEvents<T> =\n | {\n type: typeof resolveEventType;\n data: T;\n }\n | {\n type: typeof rejectEventType;\n data: any;\n }\n | {\n type: typeof XSTATE_STOP;\n };\n\nexport type PromiseActorLogic<TOutput, TInput = unknown> = ActorLogic<\n PromiseSnapshot<TOutput, TInput>,\n { type: string; [k: string]: unknown },\n TInput, // input\n ActorSystem<any>\n>;\n\nexport type PromiseActorRef<TOutput> = ActorRefFrom<\n PromiseActorLogic<TOutput, unknown>\n>;\n\nexport function fromPromise<TOutput, TInput = unknown>(\n // TODO: add types\n promiseCreator: ({\n input,\n system\n }: {\n input: TInput;\n system: AnyActorSystem;\n self: PromiseActorRef<TOutput>;\n }) => PromiseLike<TOutput>\n): PromiseActorLogic<TOutput, TInput> {\n // TODO: add event types\n const logic: PromiseActorLogic<TOutput, TInput> = {\n config: promiseCreator,\n transition: (state, event) => {\n if (state.status !== 'active') {\n return state;\n }\n\n switch (event.type) {\n case resolveEventType: {\n const resolvedValue = (event as any).data;\n return {\n ...state,\n status: 'done',\n output: resolvedValue,\n input: undefined\n };\n }\n case rejectEventType:\n return {\n ...state,\n status: 'error',\n error: (event as any).data,\n input: undefined\n };\n case XSTATE_STOP:\n return {\n ...state,\n status: 'stopped',\n input: undefined\n };\n default:\n return state;\n }\n },\n start: (state, { self, system }) => {\n // TODO: determine how to allow customizing this so that promises\n // can be restarted if necessary\n if (state.status !== 'active') {\n return;\n }\n\n const resolvedPromise = Promise.resolve(\n promiseCreator({ input: state.input!, system, self })\n );\n\n resolvedPromise.then(\n (response) => {\n if (self.getSnapshot().status !== 'active') {\n return;\n }\n system._relay(self, self, { type: resolveEventType, data: response });\n },\n (errorData) => {\n if (self.getSnapshot().status !== 'active') {\n return;\n }\n system._relay(self, self, { type: rejectEventType, data: errorData });\n }\n );\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n input\n };\n },\n getPersistedState: (state) => state,\n restoreState: (state: any) => state\n };\n\n return logic;\n}\n","import { createActor } from '../interpreter.ts';\nimport type { ActorRef, AnyEventObject, Snapshot } from '../types.ts';\nimport { fromTransition } from './transition.ts';\nexport { fromCallback, type CallbackActorLogic } from './callback.ts';\nexport {\n fromEventObservable,\n fromObservable,\n type ObservableActorLogic\n} from './observable.ts';\nexport { fromPromise, type PromiseActorLogic } from './promise.ts';\nexport {\n fromTransition,\n type TransitionActorLogic,\n type TransitionSnapshot\n} from './transition.ts';\n\nconst emptyLogic = fromTransition((_) => undefined, undefined);\n\nexport function createEmptyActor(): ActorRef<\n AnyEventObject,\n Snapshot<undefined>\n> {\n return createActor(emptyLogic);\n}\n","import {\n ActorLogic,\n EventObject,\n AnyActorSystem,\n AnyEventObject,\n ActorSystem,\n ActorRefFrom,\n TODO,\n Snapshot\n} from '../types';\nimport { XSTATE_STOP } from '../constants.ts';\n\ntype CallbackSnapshot<TInput, TEvent> = Snapshot<undefined> & {\n input: TInput;\n _receivers: Set<(e: TEvent) => void>;\n _dispose: (() => void) | void;\n};\n\nexport type CallbackActorLogic<\n TEvent extends EventObject,\n TInput = unknown\n> = ActorLogic<\n CallbackSnapshot<TInput, TEvent>,\n TEvent,\n TInput,\n ActorSystem<any>\n>;\n\nexport type CallbackActorRef<\n TEvent extends EventObject,\n TInput = unknown\n> = ActorRefFrom<CallbackActorLogic<TEvent, TInput>>;\n\nexport type Receiver<TEvent extends EventObject> = (\n listener: {\n bivarianceHack(event: TEvent): void;\n }['bivarianceHack']\n) => void;\n\nexport type InvokeCallback<\n TEvent extends EventObject = AnyEventObject,\n TSentEvent extends EventObject = AnyEventObject,\n TInput = unknown\n> = ({\n input,\n system,\n self,\n sendBack,\n receive\n}: {\n /**\n * Data that was provided to the callback actor\n * @see {@link https://stately.ai/docs/input | Input docs}\n */\n input: TInput;\n /**\n * The actor system to which the callback actor belongs\n */\n system: AnyActorSystem;\n /**\n * The parent actor of the callback actor\n */\n self: CallbackActorRef<TEvent>;\n /**\n * A function that can send events back to the parent actor\n */\n sendBack: (event: TSentEvent) => void;\n /**\n * A function that can be called with a listener function argument;\n * the listener is then called whenever events are received by the callback actor\n */\n receive: Receiver<TEvent>;\n}) => (() => void) | void;\n\n/**\n * An actor logic creator which returns callback logic as defined by a callback function.\n *\n * @remarks\n * Useful for subscription-based or other free-form logic that can send events back to the parent actor.\n *\n * Actors created from callback logic (“callback actors”) can:\n * - Receive events via the `receive` function\n * - Send events to the parent actor via the `sendBack` function\n *\n * Callback actors are a bit different from other actors in that they:\n * - Do not work with `onDone`\n * - Do not produce a snapshot using `.getSnapshot()`\n * - Do not emit values when used with `.subscribe()`\n * - Can not be stopped with `.stop()`\n *\n * @param invokeCallback - The callback function used to describe the callback logic\n * The callback function is passed an object with the following properties:\n * - `receive` - A function that can send events back to the parent actor; the listener is then called whenever events are received by the callback actor\n * - `sendBack` - A function that can send events back to the parent actor\n * - `input` - Data that was provided to the callback actor\n * - `self` - The parent actor of the callback actor\n * - `system` - The actor system to which the callback actor belongs\n * The callback function can (optionally) return a cleanup function, which is called when the actor is stopped.\n * @see {@link InvokeCallback} for more information about the callback function and its object argument\n * @see {@link https://stately.ai/docs/input | Input docs} for more information about how input is passed\n\n * @returns Callback logic\n *\n * @example\n * ```typescript\n * const callbackLogic = fromCallback(({ sendBack, receive }) => {\n * let lockStatus = 'unlocked';\n *\n * const handler = (event) => {\n * if (lockStatus === 'locked') {\n * return;\n * }\n * sendBack(event);\n * };\n *\n * receive((event) => {\n * if (event.type === 'lock') {\n * lockStatus = 'locked';\n * } else if (event.type === 'unlock') {\n * lockStatus = 'unlocked';\n * }\n * });\n *\n * document.body.addEventListener('click', handler);\n *\n * return () => {\n * document.body.removeEventListener('click', handler);\n * };\n * });\n * ```\n */\nexport function fromCallback<TEvent extends EventObject, TInput = unknown>(\n invokeCallback: InvokeCallback<TEvent, AnyEventObject, TInput>\n): CallbackActorLogic<TEvent, TInput> {\n const logic: CallbackActorLogic<TEvent, TInput> = {\n config: invokeCallback,\n start: (_state, { self, system }) => {\n system._relay(self, self, { type: 'xstate.create' });\n },\n transition: (state, event, { self, system }) => {\n if (event.type === 'xstate.create') {\n const sendBack = (eventForParent: AnyEventObject) => {\n if (state.status === 'stopped') {\n return;\n }\n\n if (self._parent) {\n system._relay(self, self._parent, eventForParent);\n }\n };\n\n const receive: Receiver<TEvent> = (newListener) => {\n state._receivers.add(newListener);\n };\n\n state._dispose = invokeCallback({\n input: state.input,\n system,\n self: self as TODO,\n sendBack,\n receive\n });\n\n return state;\n }\n\n if (event.type === XSTATE_STOP) {\n state = {\n ...state,\n status: 'stopped',\n error: undefined\n };\n\n if (typeof state._dispose === 'function') {\n state._dispose();\n }\n return state;\n }\n\n state._receivers.forEach((receiver) => receiver(event));\n\n return state;\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n input,\n _receivers: new Set(),\n _dispose: undefined\n };\n },\n getPersistedState: ({ _dispose, _receivers, ...rest }) => rest,\n restoreState: (state: any) => ({\n _receivers: new Set(),\n _dispose: undefined,\n ...state\n })\n };\n\n return logic;\n}\n","import { XSTATE_STOP } from '../constants';\nimport {\n Subscribable,\n ActorLogic,\n EventObject,\n Subscription,\n AnyActorSystem,\n ActorRefFrom,\n Snapshot\n} from '../types';\n\nexport type ObservableSnapshot<TContext, TInput> = Snapshot<undefined> & {\n context: TContext | undefined;\n input: TInput | undefined;\n _subscription: Subscription | undefined;\n};\n\nexport type ObservableActorLogic<TContext, TInput> = ActorLogic<\n ObservableSnapshot<TContext, TInput>,\n { type: string; [k: string]: unknown },\n TInput,\n AnyActorSystem\n>;\n\nexport type ObservableActorRef<TContext> = ActorRefFrom<\n ObservableActorLogic<TContext, any>\n>;\n\nexport function fromObservable<TContext, TInput>(\n observableCreator: ({\n input,\n system\n }: {\n input: TInput;\n system: AnyActorSystem;\n self: ObservableActorRef<TContext>;\n }) => Subscribable<TContext>\n): ObservableActorLogic<TContext, TInput> {\n const nextEventType = '$$xstate.next';\n const errorEventType = '$$xstate.error';\n const completeEventType = '$$xstate.complete';\n\n // TODO: add event types\n const logic: ObservableActorLogic<TContext, TInput> = {\n config: observableCreator,\n transition: (snapshot, event, { self, id, defer, system }) => {\n if (snapshot.status !== 'active') {\n return snapshot;\n }\n\n switch (event.type) {\n case nextEventType: {\n const newSnapshot = {\n ...snapshot,\n context: event.data as TContext\n };\n return newSnapshot;\n }\n case errorEventType:\n return {\n ...snapshot,\n status: 'error',\n error: (event as any).data,\n input: undefined,\n _subscription: undefined\n };\n case completeEventType:\n return {\n ...snapshot,\n status: 'done',\n input: undefined,\n _subscription: undefined\n };\n case XSTATE_STOP:\n snapshot._subscription!.unsubscribe();\n return {\n ...snapshot,\n status: 'stopped',\n input: undefined,\n _subscription: undefined\n };\n default:\n return snapshot;\n }\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n context: undefined,\n input,\n _subscription: undefined\n };\n },\n start: (state, { self, system }) => {\n if (state.status === 'done') {\n // Do not restart a completed observable\n return;\n }\n state._subscription = observableCreator({\n input: state.input!,\n system,\n self\n }).subscribe({\n next: (value) => {\n system._relay(self, self, { type: nextEventType, data: value });\n },\n error: (err) => {\n system._relay(self, self, { type: errorEventType, data: err });\n },\n complete: () => {\n system._relay(self, self, { type: completeEventType });\n }\n });\n },\n getPersistedState: ({ _subscription, ...state }) => state,\n restoreState: (state) => ({\n ...(state as any),\n _subscription: undefined\n })\n };\n\n return logic;\n}\n\n/**\n * Creates event observable logic that listens to an observable\n * that delivers event objects.\n *\n *\n * @param lazyObservable A function that creates an observable\n * @returns Event observable logic\n */\n\nexport function fromEventObservable<T extends EventObject, TInput>(\n lazyObservable: ({\n input,\n system\n }: {\n input: TInput;\n system: AnyActorSystem;\n self: ObservableActorRef<T>;\n }) => Subscribable<T>\n): ObservableActorLogic<T, TInput> {\n const errorEventType = '$$xstate.error';\n const completeEventType = '$$xstate.complete';\n\n // TODO: event types\n const logic: ObservableActorLogic<T, TInput> = {\n config: lazyObservable,\n transition: (state, event) => {\n if (state.status !== 'active') {\n return state;\n }\n\n switch (event.type) {\n case errorEventType:\n return {\n ...state,\n status: 'error',\n error: (event as any).data,\n input: undefined,\n _subscription: undefined\n };\n case completeEventType:\n return {\n ...state,\n status: 'done',\n input: undefined,\n _subscription: undefined\n };\n case XSTATE_STOP:\n state._subscription!.unsubscribe();\n return {\n ...state,\n status: 'stopped',\n input: undefined,\n _subscription: undefined\n };\n default:\n return state;\n }\n },\n getInitialState: (_, input) => {\n return {\n status: 'active',\n output: undefined,\n error: undefined,\n context: undefined,\n input,\n _subscription: undefined\n };\n },\n start: (state, { self, system }) => {\n if (state.status === 'done') {\n // Do not restart a completed observable\n return;\n }\n\n state._subscription = lazyObservable({\n input: state.input!,\n system,\n self\n }).subscribe({\n next: (value) => {\n if (self._parent) {\n system._relay(self, self._parent, value);\n }\n },\n error: (err) => {\n system._relay(self, self, { type: errorEventType, data: err });\n },\n complete: () => {\n system._relay(self, self, { type: completeEventType });\n }\n });\n },\n getPersistedState: ({ _subscription, ...state }) => state,\n restoreState: (state: any) => ({\n ...state,\n _subscription: undefined\n })\n };\n\n return logic;\n}\n"],"names":["Mailbox","constructor","_process","this","_active","_current","_last","start","flush","clear","next","enqueue","event","enqueued","value","consumed","XSTATE_STOP","createErrorActorEvent","id","data","type","getDevTools","w","globalThis","self","window","__xstate__","devToolsAdapter","service","devTools","register","reportUnhandledError","err","setTimeout","symbolObservable","Symbol","observable","idCounter","toObserver","nextHandler","errorHandler","completionHandler","isObserver","undefined","bind","error","complete","ActorStatus","defaultOptions","clock","fn","ms","clearTimeout","logger","console","log","Actor","logic","options","_state","mailbox","delayedEventsMap","observers","Set","status","NotStarted","_parent","ref","_actorScope","_systemId","sessionId","system","_doneEvent","src","_deferred","resolvedOptions","parent","systemId","inspect","rootActor","children","Map","keyedActors","reverseKeyedActors","WeakMap","_bookId","_register","actorRef","set","_unregister","delete","get","_set","existing","Error","observer","add","_sendInspectionEvent","resolvedInspectionEvent","rootId","forEach","_relay","source","target","sourceRef","_send","createSystem","defer","push","stopChild","child","_stop","send","_initState","state","restoreState","getInitialState","input","update","snapshot","deferredFn","shift","_stopProcedure","_complete","invokeId","output","_error","subscribe","nextListenerOrObserver","errorListener","completeListener","Stopped","unsubscribe","Running","initEvent","attachDevTools","nextState","caughtError","transition","stop","size","reportError","err2","key","Object","keys","delaySend","params","delay","timerId","to","cancel","sendId","toJSON","xstate$$type","getPersistedState","getSnapshot","fromTransition","initialContext","config","actorScope","context","_","resolveEventType","rejectEventType","emptyLogic","invokeCallback","sendBack","eventForParent","receive","newListener","_receivers","_dispose","receiver","rest","lazyObservable","errorEventType","completeEventType","_subscription","observableCreator","nextEventType","promiseCreator","resolvedValue","Promise","resolve","then","response","errorData"],"mappings":"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"}
@@ -1,7 +1,7 @@
1
1
  import { State } from "./State.js";
2
2
  import { StateNode } from "./StateNode.js";
3
3
  import type { AreAllImplementationsAssumedToBeProvided, MarkAllImplementationsAsProvided, ResolveTypegenMeta, TypegenDisabled } from "./typegenTypes.js";
4
- import type { ActorContext, ActorLogic, EventObject, InternalMachineImplementations, MachineConfig, MachineContext, MachineImplementationsSimplified, MachineTypes, NoInfer, StateConfig, StateMachineDefinition, StateValue, TransitionDefinition, ParameterizedObject, AnyActorContext, ProvidedActor, Equals, TODO, Snapshot } from "./types.js";
4
+ import type { ActorScope, ActorLogic, EventObject, InternalMachineImplementations, MachineConfig, MachineContext, MachineImplementationsSimplified, MachineTypes, NoInfer, StateConfig, StateMachineDefinition, StateValue, TransitionDefinition, ParameterizedObject, AnyActorScope, ProvidedActor, Equals, TODO, Snapshot } from "./types.js";
5
5
  export declare const STATE_IDENTIFIER = "#";
6
6
  export declare const WILDCARD = "*";
7
7
  export type MachineSnapshot<TContext extends MachineContext, TEvent extends EventObject, TActor extends ProvidedActor, TTag extends string, TOutput, TResolvedTypesMeta = TypegenDisabled> = (State<TContext, TEvent, TActor, TTag, TResolvedTypesMeta> & {
@@ -69,7 +69,7 @@ export declare class StateMachine<TContext extends MachineContext, TEvent extend
69
69
  * @param state The current State instance or state value
70
70
  * @param event The received event
71
71
  */
72
- transition(state: MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>, event: TEvent, actorCtx: ActorContext<typeof state, TEvent>): MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>;
72
+ transition(state: MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>, event: TEvent, actorScope: ActorScope<typeof state, TEvent>): MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>;
73
73
  /**
74
74
  * Determines the next state given the current `state` and `event`.
75
75
  * Calculates a microstep.
@@ -77,7 +77,7 @@ export declare class StateMachine<TContext extends MachineContext, TEvent extend
77
77
  * @param state The current state
78
78
  * @param event The received event
79
79
  */
80
- microstep(state: MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>, event: TEvent, actorCtx: AnyActorContext): Array<MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>>;
80
+ microstep(state: MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>, event: TEvent, actorScope: AnyActorScope): Array<MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>>;
81
81
  getTransitionData(state: MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>, event: TEvent): Array<TransitionDefinition<TContext, TEvent>>;
82
82
  /**
83
83
  * The initial state _before_ evaluating any microsteps.
@@ -87,14 +87,14 @@ export declare class StateMachine<TContext extends MachineContext, TEvent extend
87
87
  /**
88
88
  * Returns the initial `State` instance, with reference to `self` as an `ActorRef`.
89
89
  */
90
- getInitialState(actorCtx: ActorContext<MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>, TEvent>, input?: TInput): MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>;
90
+ getInitialState(actorScope: ActorScope<MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>, TEvent>, input?: TInput): MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>;
91
91
  start(state: MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>): void;
92
92
  getStateNodeById(stateId: string): StateNode<TContext, TEvent>;
93
93
  get definition(): StateMachineDefinition<TContext, TEvent>;
94
94
  toJSON(): StateMachineDefinition<TContext, TEvent>;
95
95
  getPersistedState(state: MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>): Snapshot<unknown>;
96
96
  createState(stateConfig: MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta> | StateConfig<TContext, TEvent>): MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>;
97
- restoreState(snapshot: Snapshot<unknown>, _actorCtx: ActorContext<MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>, TEvent>): MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>;
97
+ restoreState(snapshot: Snapshot<unknown>, _actorScope: ActorScope<MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>, TEvent>): MachineSnapshot<TContext, TEvent, TActor, TTag, TOutput, TResolvedTypesMeta>;
98
98
  /**@deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
99
99
  __TContext: TContext;
100
100
  /** @deprecated an internal property acting as a "phantom" type, not meant to be used at runtime */
@@ -10,11 +10,85 @@ export type Receiver<TEvent extends EventObject> = (listener: {
10
10
  bivarianceHack(event: TEvent): void;
11
11
  }['bivarianceHack']) => void;
12
12
  export type InvokeCallback<TEvent extends EventObject = AnyEventObject, TSentEvent extends EventObject = AnyEventObject, TInput = unknown> = ({ input, system, self, sendBack, receive }: {
13
+ /**
14
+ * Data that was provided to the callback actor
15
+ * @see {@link https://stately.ai/docs/input | Input docs}
16
+ */
13
17
  input: TInput;
18
+ /**
19
+ * The actor system to which the callback actor belongs
20
+ */
14
21
  system: AnyActorSystem;
22
+ /**
23
+ * The parent actor of the callback actor
24
+ */
15
25
  self: CallbackActorRef<TEvent>;
26
+ /**
27
+ * A function that can send events back to the parent actor
28
+ */
16
29
  sendBack: (event: TSentEvent) => void;
30
+ /**
31
+ * A function that can be called with a listener function argument;
32
+ * the listener is then called whenever events are received by the callback actor
33
+ */
17
34
  receive: Receiver<TEvent>;
18
35
  }) => (() => void) | void;
36
+ /**
37
+ * An actor logic creator which returns callback logic as defined by a callback function.
38
+ *
39
+ * @remarks
40
+ * Useful for subscription-based or other free-form logic that can send events back to the parent actor.
41
+ *
42
+ * Actors created from callback logic (“callback actors”) can:
43
+ * - Receive events via the `receive` function
44
+ * - Send events to the parent actor via the `sendBack` function
45
+ *
46
+ * Callback actors are a bit different from other actors in that they:
47
+ * - Do not work with `onDone`
48
+ * - Do not produce a snapshot using `.getSnapshot()`
49
+ * - Do not emit values when used with `.subscribe()`
50
+ * - Can not be stopped with `.stop()`
51
+ *
52
+ * @param invokeCallback - The callback function used to describe the callback logic
53
+ * The callback function is passed an object with the following properties:
54
+ * - `receive` - A function that can send events back to the parent actor; the listener is then called whenever events are received by the callback actor
55
+ * - `sendBack` - A function that can send events back to the parent actor
56
+ * - `input` - Data that was provided to the callback actor
57
+ * - `self` - The parent actor of the callback actor
58
+ * - `system` - The actor system to which the callback actor belongs
59
+ * The callback function can (optionally) return a cleanup function, which is called when the actor is stopped.
60
+ * @see {@link InvokeCallback} for more information about the callback function and its object argument
61
+ * @see {@link https://stately.ai/docs/input | Input docs} for more information about how input is passed
62
+
63
+ * @returns Callback logic
64
+ *
65
+ * @example
66
+ * ```typescript
67
+ * const callbackLogic = fromCallback(({ sendBack, receive }) => {
68
+ * let lockStatus = 'unlocked';
69
+ *
70
+ * const handler = (event) => {
71
+ * if (lockStatus === 'locked') {
72
+ * return;
73
+ * }
74
+ * sendBack(event);
75
+ * };
76
+ *
77
+ * receive((event) => {
78
+ * if (event.type === 'lock') {
79
+ * lockStatus = 'locked';
80
+ * } else if (event.type === 'unlock') {
81
+ * lockStatus = 'unlocked';
82
+ * }
83
+ * });
84
+ *
85
+ * document.body.addEventListener('click', handler);
86
+ *
87
+ * return () => {
88
+ * document.body.removeEventListener('click', handler);
89
+ * };
90
+ * });
91
+ * ```
92
+ */
19
93
  export declare function fromCallback<TEvent extends EventObject, TInput = unknown>(invokeCallback: InvokeCallback<TEvent, AnyEventObject, TInput>): CallbackActorLogic<TEvent, TInput>;
20
94
  export {};
@@ -1,4 +1,4 @@
1
- import { ActorLogic, ActorContext, ActorSystem, EventObject, ActorRefFrom, AnyActorSystem, Snapshot } from "../types.js";
1
+ import { ActorLogic, ActorScope, ActorSystem, EventObject, ActorRefFrom, AnyActorSystem, Snapshot } from "../types.js";
2
2
  export type TransitionSnapshot<TContext> = Snapshot<undefined> & {
3
3
  context: TContext;
4
4
  };
@@ -13,7 +13,7 @@ export type TransitionActorRef<TContext, TEvent extends EventObject> = ActorRefF
13
13
  * @param initialContext The initial state of the transition function.
14
14
  * @returns Actor logic
15
15
  */
16
- export declare function fromTransition<TContext, TEvent extends EventObject, TSystem extends ActorSystem<any>, TInput>(transition: (state: TContext, event: TEvent, actorContext: ActorContext<TransitionSnapshot<TContext>, TEvent, TSystem>) => TContext, initialContext: TContext | (({ input, self }: {
16
+ export declare function fromTransition<TContext, TEvent extends EventObject, TSystem extends ActorSystem<any>, TInput>(transition: (state: TContext, event: TEvent, actorScope: ActorScope<TransitionSnapshot<TContext>, TEvent, TSystem>) => TContext, initialContext: TContext | (({ input, self }: {
17
17
  input: TInput;
18
18
  self: TransitionActorRef<TContext, TEvent>;
19
19
  }) => TContext)): TransitionActorLogic<TContext, TEvent, TInput>;
@@ -1,6 +1,6 @@
1
1
  import { symbolObservable } from "./symbolObservable.js";
2
2
  import { AreAllImplementationsAssumedToBeProvided, MissingImplementationsError } from "./typegenTypes.js";
3
- import type { ActorSystem, AnyActorLogic, AnyStateMachine, EventFromLogic, SnapshotFrom, AnyActorRef, Snapshot } from "./types.js";
3
+ import type { ActorSystem, AnyActorLogic, AnyStateMachine, EventFromLogic, SnapshotFrom, Snapshot } from "./types.js";
4
4
  import { ActorRef, EventObject, InteropSubscribable, ActorOptions, Observer, Subscription } from "./types.js";
5
5
  export declare const $$ACTOR_TYPE = 1;
6
6
  export type SnapshotListener<TLogic extends AnyActorLogic> = (state: SnapshotFrom<TLogic>) => void;
@@ -20,6 +20,9 @@ export declare enum ActorStatus {
20
20
  * @deprecated Use `ActorStatus` instead.
21
21
  */
22
22
  export declare const InterpreterStatus: typeof ActorStatus;
23
+ /**
24
+ * An Actor is a running process that can receive events, send events and change its behavior based on the events it receives, which can cause effects outside of the actor. When you run a state machine, it becomes an actor.
25
+ */
23
26
  export declare class Actor<TLogic extends AnyActorLogic> implements ActorRef<EventFromLogic<TLogic>, SnapshotFrom<TLogic>> {
24
27
  logic: TLogic;
25
28
  /**
@@ -45,12 +48,15 @@ export declare class Actor<TLogic extends AnyActorLogic> implements ActorRef<Eve
45
48
  status: ActorStatus;
46
49
  _parent?: ActorRef<any, any>;
47
50
  ref: ActorRef<EventFromLogic<TLogic>, SnapshotFrom<TLogic>>;
48
- private _actorContext;
51
+ private _actorScope;
49
52
  private _systemId;
50
53
  /**
51
54
  * The globally unique process ID for this invocation.
52
55
  */
53
56
  sessionId: string;
57
+ /**
58
+ * The system to which this actor belongs.
59
+ */
54
60
  system: ActorSystem<any>;
55
61
  private _doneEvent?;
56
62
  src?: string;
@@ -64,6 +70,54 @@ export declare class Actor<TLogic extends AnyActorLogic> implements ActorRef<Eve
64
70
  private _initState;
65
71
  private _deferred;
66
72
  private update;
73
+ /**
74
+ * Subscribe an observer to an actor’s snapshot values.
75
+ *
76
+ * @remarks
77
+ * The observer will receive the actor’s snapshot value when it is emitted. The observer can be:
78
+ * - A plain function that receives the latest snapshot, or
79
+ * - An observer object whose `.next(snapshot)` method receives the latest snapshot
80
+ *
81
+ * @example
82
+ * ```ts
83
+ * // Observer as a plain function
84
+ * const subscription = actor.subscribe((snapshot) => {
85
+ * console.log(snapshot);
86
+ * });
87
+ * ```
88
+ *
89
+ * @example
90
+ * ```ts
91
+ * // Observer as an object
92
+ * const subscription = actor.subscribe({
93
+ * next(snapshot) {
94
+ * console.log(snapshot);
95
+ * },
96
+ * error(err) {
97
+ * // ...
98
+ * },
99
+ * complete() {
100
+ * // ...
101
+ * },
102
+ * });
103
+ * ```
104
+ *
105
+ * The return value of `actor.subscribe(observer)` is a subscription object that has an `.unsubscribe()` method. You can call `subscription.unsubscribe()` to unsubscribe the observer:
106
+ *
107
+ * @example
108
+ * ```ts
109
+ * const subscription = actor.subscribe((snapshot) => {
110
+ * // ...
111
+ * });
112
+ *
113
+ * // Unsubscribe the observer
114
+ * subscription.unsubscribe();
115
+ * ```
116
+ *
117
+ * When the actor is stopped, all of its observers will automatically be unsubscribed.
118
+ *
119
+ * @param observer - Either a plain function that receives the latest snapshot, or an observer object whose `.next(snapshot)` method receives the latest snapshot
120
+ */
67
121
  subscribe(observer: Observer<SnapshotFrom<TLogic>>): Subscription;
68
122
  subscribe(nextListener?: (state: SnapshotFrom<TLogic>) => void, errorListener?: (error: any) => void, completeListener?: () => void): Subscription;
69
123
  /**
@@ -85,13 +139,6 @@ export declare class Actor<TLogic extends AnyActorLogic> implements ActorRef<Eve
85
139
  * @param event The event to send
86
140
  */
87
141
  send(event: EventFromLogic<TLogic>): void;
88
- delaySend(params: {
89
- event: EventObject;
90
- id: string | undefined;
91
- delay: number;
92
- to?: AnyActorRef;
93
- }): void;
94
- cancel(sendId: string | number): void;
95
142
  private attachDevTools;
96
143
  toJSON(): {
97
144
  xstate$$type: number;
@@ -99,6 +146,20 @@ export declare class Actor<TLogic extends AnyActorLogic> implements ActorRef<Eve
99
146
  };
100
147
  getPersistedState(): Snapshot<unknown>;
101
148
  [symbolObservable](): InteropSubscribable<SnapshotFrom<TLogic>>;
149
+ /**
150
+ * Read an actor’s snapshot synchronously.
151
+ *
152
+ * @remarks
153
+ * The snapshot represent an actor's last emitted value.
154
+ *
155
+ * When an actor receives an event, its internal state may change.
156
+ * An actor may emit a snapshot when a state transition occurs.
157
+ *
158
+ * Note that some actors, such as callback actors generated with `fromCallback`, will not emit snapshots.
159
+ *
160
+ * @see {@link Actor.subscribe} to subscribe to an actor’s snapshot values.
161
+ * @see {@link Actor.getPersistedState} to persist the internal state of an actor (which is more than just a snapshot).
162
+ */
102
163
  getSnapshot(): SnapshotFrom<TLogic>;
103
164
  }
104
165
  /**