Core - States

What states are in the Deva Core, how to set one with this.state(), how to list them with this.states(), and the full list.

What a state is

A state records the condition a Deva or a piece of work is in right now: online, idle, waiting, pending, valid, or catch for an error. Each time you set one, the Core records it and broadcasts a devacore:state event. Actions say what is being done, and states say what condition it is in while it happens.

Setting a state: this.state()

this.state(<state>, <emit_value>)

<state> is a key from the list below, such as 'try', 'valid' or 'catch'.
<emit_value> is optional extra text added to the record. Use it to say what the state applies to, such as a function name and an id.

this.state('try', key);                              // work is starting inside a try block
this.state('valid', `_getFeature:${key}`);           // the data passed its check
this.state('catch', `_getFeature:${key}`);           // an error was caught

When you call it:

The Core checks that the Deva is active. If it is not, it returns the offline message.
If the state name is not in the list below, the call is ignored without an error. Check the spelling against the list.
Otherwise the Core sets the current state and builds a record with a unique id, the state key, the label plus your extra text, the agent, the client, and a timestamp.
The record is hashed with md5, sha256 and sha512, emitted as devacore:state, and returned to you.

Listing the states: this.states()

const states = this.states();

This returns every state the Deva knows about as one data packet, with its own id, the agent, the client, a timestamp, and the md5, sha256 and sha512 hashes. The list itself is under states.value, as key and label pairs. If the Deva is not active it returns the offline message. Calling it also records a states action and a data state of its own, so reading the list leaves a trace like everything else.

The matching functions this.actions(), this.zones(), this.intents() and the others work the same way for their lists.

Available states

There are 115 states.

online: 🤩 Online
offline: 😴 Offline
active: 😀 Active
inactive: 🥱 Inactive
idle: 🚘 Idle
talk: 📢 Talk
listen: 👂 Listen
ask: 🗣️ Ask
question: 💬 Question
cmd: 🪖 Command
answer: 💡 Answer
wait: ⏳ Wait
pause: ⏸️ Pause
resume: 🚙 Resume
pending: ⏳ Pending
connect: 📳 Connect
disconnect: 📴 Disconnect
send: 📬 Send
receive: 📪 Receive
return: 🤿 Return
resolve: 🤝 Resolve
reject: 🧱 Reject
init: 🟠 Init
start: 🟢 Start
enter: 🚪 Enter
done: ☑️ Done
ready: ⭐️ Ready
finish: 🏁 Finish
complete: ✅ Complete
stop: 🔴 Stop
close: 📦 Close
leave: 🫣 Leave
exit: 🚪 Exit
shutdown: 🔌 Shutdown
open: 🥫 Open
begin: 🗺️ Begin
end: 🎬 End
load: 📦 Load
unload: 🥡 Unload
set: 🖖 Set
let: 🥬 Let
const: 🔩 Const
get: 💠 Get
put: 🤝 Put
push: 🫸 Push
pull: 👉 Pull
while: 🔁 While
loop: 🔃 Loop
async: 🦿 Async
await: 💛 Await
continue: ❤️ Continue
break: 💔 Break
search: 🔎 Search
memory: 💭 Memory
signature: ✍️️ Signature
invalid: 🖍️ Invalid
valid: ✏️ Valid
abort: 💥 Abort
help: 💙 Help
authorized: 🔑 Authorized
unauthorized: 🏴 Unauthorized
Done: ☑️ Done
glitch: 😡 Glitch
intruder: 🦹‍♂️ Intruder
snooper: 👀 Snooper
scam: 🙅‍♂️ Scam
fraud: 🤬 Fraud
crime: 🚔 Crime
official: 🫡 Official
unofficial: 🤥 Unofficial
approved: 🎖️ Approved
denied: 🖕 Denied
try: 🏸 Try
catch: ⚾️ Catch
finally: 🏆 Finally
view: 👓 View
license: 🪪 License
feecting: 🏄 Feecting
data: 💾 Data
error: ❌ Error
log: 🪵 Log
report: 🗂️ Report
security: 🚨 Security
legal: 🏛️ Legal
support: 💼 Support
services: 🛠️ Services
systems: 🖥️ Systems
emergency: 🛟 Emergency
ingress: 🫴 Ingress
egress: 🫳 Egress
go: 🚘 Go
do: 🛹 Do
make: 🖌️ Make
write: 📝 Write
create: 🎨 Create
destroy: 💣 Destroy
save: 📀 Save
build: 👷️ Build
true: 🟢 True
false: 🔴 False
safe: ⚪️ Safe
unsafe: ⚫️ Unsafe
correct: 🟦 Correct
incorrect: 🟥 Incorrect
clean: 🧼 Clean
dirty: 🧹 Dirty
friend: 🦸 Friend
enemy: 🦹 Enemy
fake: 🥸 Fake
real: 😲 Real
mature: 🧓 Mature
immature: 🧒 Immature
consent: ✍️ Consent
onfunc: 🎚️ onFunction
romance: 🌹 Romance