npm - @almadar/std - Versions diffs - 17.0.3 → 17.1.0 - Mend

@almadar/std 17.0.3 → 17.1.0

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 (313) hide show

package/behaviors/registry/net/atoms/std-http-fetch.orb CHANGED Viewed

	@@ -1 +1 @@
1	- {"typeContractVersion":1,"types":{"HttpHeader":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}]},"name":"std-http-fetch","version":"1.0.0","description":"std-http-fetch — the HTTP client of a program that runs in a browser host, which has no sockets (spec/net/http-fetch.lolo). It answers the events std-http-client answers: HTTP_SEND { key, method, target, headers, body, stream } becomes one os/fetch of method, origin knob plus target, the headers and the body bytes (timeoutMs from the knob), and the host's raw status, headers and body come back as HTTP_REPLIED { key, status, headers, body } for any status (header names lower-cased, repeats joined with a comma and a space, as std-http-client). The origin knob must be declared in egress; the kernel answers an undeclared origin denied without asking the host. A request the atom will not write (method, header or target the patterns refuse, or a header naming framing or a credential) answers HTTP_FAILED kind refused, as std-http-client. A stream of sse or jsonl asks os/fetch with stream true: the host answers at the head, the body is read with os/recv on the handle (config.recvBytes at a time) and each complete frame is answered as HTTP_STREAM_EVENT { key, data, event, id } while the body is still arriving (the framing of std-http-client) The framing is std-http-frame, composed in this atom as the sibling trait FetchFrame: a program that asks for a stream composes FetchFrame beside this trait., then HTTP_REPLIED with an empty body when the body ends and the handle is closed. One stream is in flight per frame; a second HTTP_SEND meanwhile answers HTTP_FAILED kind refused. Any other stream answers HTTP_FAILED kind refused. A host failure keeps its kind denied or timeout, else io; a native host answers os/fetch unsupported, which is io here: a native program composes std-http-client instead. Nothing follows a redirect that the host's fetch does not.","orbitals":[{"name":"HttpFetchOrbital","id":"orb_0MD1Q9EFWM7YA0PPJJMXE0R2X5","uses":[{"from":"almadar-std/http-fetch","as":"Spec"},{"from":"std/behaviors/std-http-frame","as":"Frame"}],"entity":{"name":"HttpFetchFlight","id":"ent_9MD0HJTDWX6YEQAT2Y5650E3CE","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"key","type":"string","default":"","description":"The key of the stream in flight."},{"nullable":false,"name":"stream","type":"string","default":"none","description":"none, sse or jsonl."},{"nullable":false,"name":"handle","type":"number","default":-1,"description":"The open streamed response, -1 when none."},{"nullable":false,"name":"dec","type":"bytes","default":"","description":"Body bytes read and not yet framed."},{"nullable":false,"name":"status","type":"number","default":0,"description":"The status of the streamed head."},{"nullable":false,"name":"headers","type":"array","default":[],"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"value":{"nullable":false,"name":"value","type":"string","required":true}},"projectedFrom":{"type":"HttpHeader"}},"description":"The headers of the streamed head, names lower-cased."},{"nullable":false,"name":"total","type":"number","default":0,"description":"Body bytes read so far."},{"nullable":false,"name":"eof","type":"boolean","default":false,"description":"The body ended."},{"nullable":false,"name":"flushed","type":"boolean","default":false,"description":"The unterminated rest of the body was framed."}],"invariants":[[">=","@entity.total",0]]},"traits":[{"ref":"Frame.traits.HttpFrame","id":"trt_K3D277YS84CM2DCXCSD025Z9RY","name":"FetchFrame","listens":[{"event":"HF_FRAME","triggers":"FRAME_RUN","source":{"kind":"trait","trait":"HttpFetch"}}]},{"name":"HttpFetch","id":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB","effectRow":[{"kind":"emit","resource":"HF_AFTER"},{"kind":"emit","resource":"HF_FRAME"},{"kind":"emit","resource":"HF_FRAMED"},{"kind":"emit","resource":"HTTP_FAILED"},{"kind":"emit","resource":"HTTP_REPLIED"},{"kind":"emit","resource":"HTTP_STREAM_EVENT"},{"kind":"os/close"},{"kind":"os/fetch"},{"kind":"os/recv"},{"kind":"set","resource":"@entity.dec"},{"kind":"set","resource":"@entity.eof"},{"kind":"set","resource":"@entity.flushed"},{"kind":"set","resource":"@entity.handle"},{"kind":"set","resource":"@entity.headers"},{"kind":"set","resource":"@entity.key"},{"kind":"set","resource":"@entity.status"},{"kind":"set","resource":"@entity.stream"},{"kind":"set","resource":"@entity.total"}],"linkedEntity":"HttpFetchFlight","linkedEntityId":"ent_9MD0HJTDWX6YEQAT2Y5650E3CE","entityRefIds":{"HttpFetchFlight":"ent_9MD0HJTDWX6YEQAT2Y5650E3CE"},"emits":[{"event":"HTTP_REPLIED","eventId":"evt_RKHQHKYZ6NFKAS1MJ21TJJTZRF","description":"The response, of any status, whole.","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"body","type":"bytes","required":true}]},{"event":"HTTP_STREAM_EVENT","eventId":"evt_N4CK3059B1MNGJQD4YK6NA72ZW","description":"One complete frame of a streamed response (sse or jsonl).","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"data","type":"string","required":true},{"nullable":true,"name":"event","type":"string"},{"nullable":true,"name":"id","type":"string"}]},{"event":"HTTP_FAILED","eventId":"evt_P8637JGGT78D3NS4G9PHEEQVWN","description":"The call produced no response: kind refused (nothing sent), denied, timeout, encoding (a stream frame is not UTF-8) or io.","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}]},{"event":"HF_HEAD","eventId":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","description":"Internal: the os/fetch answer of a streamed fetch, at the head.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":true,"name":"handle","type":"number"}]},{"event":"HF_HEAD_FAILED","eventId":"evt_CP9H1BH22AH156XPDZHPP5NBDD","description":"Internal: the os/fetch failure of a streamed fetch.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}]},{"event":"HF_READ","eventId":"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF","description":"Internal: one os/recv answer of a streamed response.","tier":"internal","payloadSchema":[{"nullable":false,"name":"data","type":"bytes","required":true},{"nullable":false,"name":"eof","type":"boolean","required":true}]},{"event":"HF_IO_FAILED","eventId":"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8","description":"Internal: an os/recv of a streamed response failed.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"event":"HF_FRAMED","eventId":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","description":"Internal: body bytes were read; frame a stream or read more.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"n","type":"number","required":true}]},{"event":"HF_AFTER","eventId":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","description":"Internal: no frame is complete; read more or finish.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"n","type":"number","required":true}]},{"event":"HF_FRAME","eventId":"evt_SV29N9H57QJKVVR4RVK2AE1DK1","description":"Internal: the unframed stream bytes, for the framer.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"stream","type":"string","required":true},{"nullable":false,"name":"data","type":"bytes","required":true},{"nullable":false,"name":"final","type":"boolean","required":true}]},{"event":"HF_CLOSED","eventId":"evt_5D6VCFW26P13BA8J6GC0433Y82","description":"Internal: the streamed response was closed.","tier":"internal"},{"event":"HF_REPLIED","eventId":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","description":"Internal: the os/fetch answer.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true}]},{"event":"HF_FAILED","eventId":"evt_AJ07NBK596JMK850P91E35XKWK","description":"Internal: the os/fetch failure.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}]}],"listens":[{"event":"FRAME_EVENT","triggers":"HF_FRAME_EVENT","triggersId":"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST","source":{"kind":"trait","trait":"FetchFrame","traitId":"trt_K3D277YS84CM2DCXCSD025Z9RY"}},{"event":"FRAME_DRAINED","triggers":"HF_DRAINED","triggersId":"evt_NGZ60X63PE1V79SDTS5M39TF2V","source":{"kind":"trait","trait":"FetchFrame","traitId":"trt_K3D277YS84CM2DCXCSD025Z9RY"}},{"event":"FRAME_FAILED","triggers":"HF_FRAME_FAILED","triggersId":"evt_CBV66CZV7AXKN9C547MF74MC23","source":{"kind":"trait","trait":"FetchFrame","traitId":"trt_K3D277YS84CM2DCXCSD025Z9RY"}}],"stateMachine":{"states":[{"name":"ready","isInitial":true},{"name":"opening"},{"name":"streaming"}],"events":[{"key":"INIT","id":"evt_X88FR9PFD47PJ874HMAB410RPY","name":"Initialize"},{"key":"HTTP_SEND","id":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","name":"Http Send","description":"Make one HTTP call; answered HTTP_REPLIED or HTTP_FAILED, and with a stream each frame as HTTP_STREAM_EVENT first.","synonyms":"browser http client, fetch","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"method","type":"string","required":true},{"nullable":false,"name":"target","type":"string","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":false,"name":"stream","type":"string","required":true}],"listened":true},{"key":"HF_REPLIED","id":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","name":"Hf Replied","description":"Internal: the os/fetch answer.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true}],"listened":true},{"key":"HF_FAILED","id":"evt_AJ07NBK596JMK850P91E35XKWK","name":"Hf Failed","description":"Internal: the os/fetch failure.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}],"listened":true},{"key":"HF_CLOSED","id":"evt_5D6VCFW26P13BA8J6GC0433Y82","name":"Hf Closed","description":"Internal: the streamed response was closed.","tier":"internal","listened":true},{"key":"HF_HEAD","id":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","name":"Hf Head","description":"Internal: the os/fetch answer of a streamed fetch, at the head.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":true,"name":"handle","type":"number"}],"listened":true},{"key":"HF_HEAD_FAILED","id":"evt_CP9H1BH22AH156XPDZHPP5NBDD","name":"Hf Head Failed","description":"Internal: the os/fetch failure of a streamed fetch.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}],"listened":true},{"key":"HF_IO_FAILED","id":"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8","name":"Hf Io Failed","description":"Internal: an os/recv of a streamed response failed.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"},{"nullable":false,"name":"kind","type":"string"}],"listened":true},{"key":"HF_READ","id":"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF","name":"Hf Read","description":"Internal: one os/recv answer of a streamed response.","tier":"internal","payloadSchema":[{"nullable":false,"name":"data","type":"bytes","required":true},{"nullable":false,"name":"eof","type":"boolean","required":true}],"listened":true},{"key":"HF_FRAMED","id":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","name":"Hf Framed","description":"Internal: body bytes were read; frame a stream or read more.","tier":"internal","payloadSchema":[{"nullable":false,"name":"n","type":"number","required":true}]},{"key":"HF_DRAINED","id":"evt_NGZ60X63PE1V79SDTS5M39TF2V","name":"Hf Drained","payloadSchema":[{"nullable":false,"name":"rest","type":"bytes","required":true}],"listened":true},{"key":"HF_FRAME_EVENT","id":"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST","name":"Hf Frame Event","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"data","type":"string","required":true},{"nullable":true,"name":"event","type":"string"},{"nullable":true,"name":"id","type":"string"}],"listened":true},{"key":"HF_FRAME_FAILED","id":"evt_CBV66CZV7AXKN9C547MF74MC23","name":"Hf Frame Failed","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}],"listened":true},{"key":"HF_AFTER","id":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","name":"Hf After","description":"Internal: no frame is complete; read more or finish.","tier":"internal","payloadSchema":[{"nullable":false,"name":"n","type":"number","required":true}]},{"key":"HTTP_REPLIED","id":"evt_RKHQHKYZ6NFKAS1MJ21TJJTZRF","name":"Http Replied","description":"The response, of any status, whole.","tier":"primary","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"body","type":"bytes","required":true}]},{"key":"HTTP_STREAM_EVENT","id":"evt_N4CK3059B1MNGJQD4YK6NA72ZW","name":"Http Stream Event","description":"One complete frame of a streamed response (sse or jsonl).","tier":"primary","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"data","type":"string","required":true},{"nullable":true,"name":"event","type":"string"},{"nullable":true,"name":"id","type":"string"}]},{"key":"HTTP_FAILED","id":"evt_P8637JGGT78D3NS4G9PHEEQVWN","name":"Http Failed","description":"The call produced no response: kind refused (nothing sent), denied, timeout, encoding (a stream frame is not UTF-8) or io.","tier":"primary","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}]},{"key":"HF_FRAME","id":"evt_SV29N9H57QJKVVR4RVK2AE1DK1","name":"Hf Frame","description":"Internal: the unframed stream bytes, for the framer.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"stream","type":"string","required":true},{"nullable":false,"name":"data","type":"bytes","required":true},{"nullable":false,"name":"final","type":"boolean","required":true}]}],"transitions":[{"from":"ready","to":"ready","event":"INIT","eventId":"evt_X88FR9PFD47PJ874HMAB410RPY"},{"from":"ready","to":"ready","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","guard":["not",["and",["validate/pattern","@payload.method","@config.tokenPattern"],["validate/pattern","@payload.target","@config.targetPattern"],["array/includes","@config.streams","@payload.stream"],["array/every","@payload.headers",["fn","h",["and",["validate/pattern","@h.name","@config.tokenPattern"],["validate/pattern","@h.value","@config.valuePattern"],["not",["array/includes","@config.framingHeaders",["str/lower","@h.name"]]],["not",["array/includes","@config.credentialHeaders",["str/lower","@h.name"]]]]]]]],"effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"the request cannot be written: a method, header, target or stream is not allowed, or a header names framing the fetch sets or carries a credential","kind":"refused"}]]},{"from":"ready","to":"ready","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","guard":["and",["=","@payload.stream","none"],["and",["validate/pattern","@payload.method","@config.tokenPattern"],["validate/pattern","@payload.target","@config.targetPattern"],["array/includes","@config.streams","@payload.stream"],["array/every","@payload.headers",["fn","h",["and",["validate/pattern","@h.name","@config.tokenPattern"],["validate/pattern","@h.value","@config.valuePattern"],["not",["array/includes","@config.framingHeaders",["str/lower","@h.name"]]],["not",["array/includes","@config.credentialHeaders",["str/lower","@h.name"]]]]]]]],"effects":[["os/fetch","@payload.method",["str/concat","@config.origin","@payload.target"],{"headers":"@payload.headers","body":"@payload.body","timeoutMs":"@config.timeoutMs"},{"key":"@payload.key","emit":{"success":"HF_REPLIED","failure":"HF_FAILED"}}]]},{"from":"ready","to":"opening","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","guard":["and",["!=","@payload.stream","none"],["and",["validate/pattern","@payload.method","@config.tokenPattern"],["validate/pattern","@payload.target","@config.targetPattern"],["array/includes","@config.streams","@payload.stream"],["array/every","@payload.headers",["fn","h",["and",["validate/pattern","@h.name","@config.tokenPattern"],["validate/pattern","@h.value","@config.valuePattern"],["not",["array/includes","@config.framingHeaders",["str/lower","@h.name"]]],["not",["array/includes","@config.credentialHeaders",["str/lower","@h.name"]]]]]]]],"effects":[["set","@entity.key","@payload.key"],["set","@entity.stream","@payload.stream"],["set","@entity.handle",-1],["set","@entity.dec",["bytes/from-string",""]],["set","@entity.total",0],["set","@entity.eof",false],["set","@entity.flushed",false],["os/fetch","@payload.method",["str/concat","@config.origin","@payload.target"],{"headers":"@payload.headers","body":"@payload.body","timeoutMs":"@config.timeoutMs","stream":true},{"key":"@payload.key","emit":{"success":"HF_HEAD","failure":"HF_HEAD_FAILED"}}]]},{"from":"ready","to":"ready","event":"HF_REPLIED","eventId":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","effects":[["emit","HTTP_REPLIED",{"key":"@payload.key","status":"@payload.status","headers":["default",["object/fromEntries",["array/map","@payload.headers",["fn","h",[["str/lower","@h.name"],["str/join",["array/map",["array/filter","@payload.headers",["fn","g",["=",["str/lower","@g.name"],["str/lower","@h.name"]]]],["fn","g","@g.value"]],", "]]]]],{}],"body":"@payload.body"}]]},{"from":"ready","to":"ready","event":"HF_FAILED","eventId":"evt_AJ07NBK596JMK850P91E35XKWK","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"@payload.error","kind":["if",["or",["=","@payload.kind","denied"],["=","@payload.kind","timeout"]],"@payload.kind","io"]}]]},{"from":"ready","to":"ready","event":"HF_CLOSED","eventId":"evt_5D6VCFW26P13BA8J6GC0433Y82"},{"from":"opening","to":"opening","event":"INIT","eventId":"evt_X88FR9PFD47PJ874HMAB410RPY"},{"from":"opening","to":"opening","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"a stream is in flight on this frame","kind":"refused"}]]},{"from":"opening","to":"opening","event":"HF_REPLIED","eventId":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","effects":[["emit","HTTP_REPLIED",{"key":"@payload.key","status":"@payload.status","headers":["default",["object/fromEntries",["array/map","@payload.headers",["fn","h",[["str/lower","@h.name"],["str/join",["array/map",["array/filter","@payload.headers",["fn","g",["=",["str/lower","@g.name"],["str/lower","@h.name"]]]],["fn","g","@g.value"]],", "]]]]],{}],"body":"@payload.body"}]]},{"from":"opening","to":"opening","event":"HF_FAILED","eventId":"evt_AJ07NBK596JMK850P91E35XKWK","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"@payload.error","kind":["if",["or",["=","@payload.kind","denied"],["=","@payload.kind","timeout"]],"@payload.kind","io"]}]]},{"from":"opening","to":"opening","event":"HF_CLOSED","eventId":"evt_5D6VCFW26P13BA8J6GC0433Y82"},{"from":"opening","to":"ready","event":"HF_HEAD","eventId":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","guard":["==","@payload.handle",null],"effects":[["emit","HTTP_FAILED",{"key":"@entity.key","error":"the host answered a streamed fetch with no handle","kind":"io"}]]},{"from":"opening","to":"streaming","event":"HF_HEAD","eventId":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","guard":["!=","@payload.handle",null],"effects":[["set","@entity.handle",["default","@payload.handle",-1]],["set","@entity.status","@payload.status"],["set","@entity.headers",["array/map","@payload.headers",["fn","h",{"name":["str/lower","@h.name"],"value":"@h.value"}]]],["os/recv","@payload.handle","@config.recvBytes",{"key":"read","emit":{"success":"HF_READ","failure":"HF_IO_FAILED"}}]]},{"from":"opening","to":"ready","event":"HF_HEAD_FAILED","eventId":"evt_CP9H1BH22AH156XPDZHPP5NBDD","effects":[["emit","HTTP_FAILED",{"key":"@entity.key","error":"@payload.error","kind":["if",["or",["=","@payload.kind","denied"],["=","@payload.kind","timeout"]],"@payload.kind","io"]}]]},{"from":"streaming","to":"streaming","event":"INIT","eventId":"evt_X88FR9PFD47PJ874HMAB410RPY"},{"from":"streaming","to":"streaming","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"a stream is in flight on this frame","kind":"refused"}]]},{"from":"streaming","to":"streaming","event":"HF_REPLIED","eventId":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","effects":[["emit","HTTP_REPLIED",{"key":"@payload.key","status":"@payload.status","headers":["default",["object/fromEntries",["array/map","@payload.headers",["fn","h",[["str/lower","@h.name"],["str/join",["array/map",["array/filter","@payload.headers",["fn","g",["=",["str/lower","@g.name"],["str/lower","@h.name"]]]],["fn","g","@g.value"]],", "]]]]],{}],"body":"@payload.body"}]]},{"from":"streaming","to":"streaming","event":"HF_FAILED","eventId":"evt_AJ07NBK596JMK850P91E35XKWK","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"@payload.error","kind":["if",["or",["=","@payload.kind","denied"],["=","@payload.kind","timeout"]],"@payload.kind","io"]}]]},{"from":"streaming","to":"streaming","event":"HF_CLOSED","eventId":"evt_5D6VCFW26P13BA8J6GC0433Y82"},{"from":"streaming","to":"ready","event":"HF_IO_FAILED","eventId":"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8","effects":[["os/close","@entity.handle",{"key":"close","emit":{"success":"HF_CLOSED","failure":"HF_CLOSED"}}],["set","@entity.handle",-1],["emit","HTTP_FAILED",{"key":"@entity.key","error":"@payload.error","kind":["if",["or",["=","@payload.kind","denied"],["=","@payload.kind","timeout"]],"@payload.kind","io"]}]]},{"from":"streaming","to":"streaming","event":"HF_READ","eventId":"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF","effects":[["set","@entity.dec",["bytes/concat",["@entity.dec","@payload.data"]]],["set","@entity.total",["+","@entity.total",["bytes/length","@payload.data"]]],["set","@entity.eof","@payload.eof"],["emit","HF_FRAMED",{"n":["+","@entity.total",["bytes/length","@entity.dec"]]}]]},{"from":"streaming","to":"streaming","event":"HF_FRAMED","eventId":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","guard":[">","@entity.total","@config.maxBody"],"effects":[["os/close","@entity.handle",{"key":"close","emit":{"success":"HF_CLOSED","failure":"HF_CLOSED"}}],["set","@entity.handle",-1],["emit","HTTP_FAILED",{"key":"@entity.key","error":"the body is past the largest body","kind":"io"}]]},{"from":"streaming","to":"streaming","event":"HF_FRAMED","eventId":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","guard":["<=","@entity.total","@config.maxBody"],"effects":[["emit","HF_FRAME",{"key":"@entity.key","stream":"@entity.stream","data":"@entity.dec","final":false}]]},{"from":"streaming","to":"streaming","event":"HF_DRAINED","eventId":"evt_NGZ60X63PE1V79SDTS5M39TF2V","effects":[["set","@entity.dec","@payload.rest"],["emit","HF_AFTER",{"n":["+","@entity.total",["bytes/length","@entity.dec"]]}]]},{"from":"streaming","to":"streaming","event":"HF_FRAME_EVENT","eventId":"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST","effects":[["emit","HTTP_STREAM_EVENT",{"key":"@payload.key","data":"@payload.data","event":"@payload.event","id":"@payload.id"}]]},{"from":"streaming","to":"streaming","event":"HF_FRAME_FAILED","eventId":"evt_CBV66CZV7AXKN9C547MF74MC23","effects":[["os/close","@entity.handle",{"key":"close","emit":{"success":"HF_CLOSED","failure":"HF_CLOSED"}}],["set","@entity.handle",-1],["emit","HTTP_FAILED",{"key":"@payload.key","error":"@payload.error","kind":"@payload.kind"}]]},{"from":"streaming","to":"streaming","event":"HF_AFTER","eventId":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","guard":["not","@entity.eof"],"effects":[["os/recv","@entity.handle","@config.recvBytes",{"key":"read","emit":{"success":"HF_READ","failure":"HF_IO_FAILED"}}]]},{"from":"streaming","to":"streaming","event":"HF_AFTER","eventId":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","guard":["and","@entity.eof",["not","@entity.flushed"],[">",["bytes/length","@entity.dec"],0]],"effects":[["set","@entity.flushed",true],["emit","HF_FRAME",{"key":"@entity.key","stream":"@entity.stream","data":"@entity.dec","final":true}]]},{"from":"streaming","to":"ready","event":"HF_AFTER","eventId":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","guard":["and","@entity.eof",["or","@entity.flushed",["=",["bytes/length","@entity.dec"],0]]],"effects":[["os/close","@entity.handle",{"key":"close","emit":{"success":"HF_CLOSED","failure":"HF_CLOSED"}}],["set","@entity.handle",-1],["set","@entity.dec",["bytes/from-string",""]],["emit","HTTP_REPLIED",{"key":"@entity.key","status":"@entity.status","headers":["default",["object/fromEntries",["array/map","@entity.headers",["fn","h",["@h.name",["str/join",["array/map",["array/filter","@entity.headers",["fn","g",["=","@g.name","@h.name"]]],["fn","g","@g.value"]],", "]]]]],{}],"body":["bytes/from-string",""]}]]}]},"config":{"origin":{"nullable":false,"type":"url","default":"https://api.example.test","label":"Origin","description":"The scheme and host every request is made against (no trailing slash); declared in egress.","tier":"infra"},"timeoutMs":{"nullable":false,"type":"number","default":30000,"label":"Timeout","description":"The longest the host waits for the fetch to answer.","tier":"infra"},"tokenPattern":{"nullable":false,"type":"string","default":"^[!#$%&'+.^_`\|~0-9A-Za-z-]+$","label":"Token","description":"What a method or header name must match.","tier":"domain"},"valuePattern":{"nullable":false,"type":"string","default":"^[^\\x00-\\x08\\x0a-\\x1f\\x7f]$","label":"Header value","description":"What a header value may hold: no control character other than a tab.","tier":"domain"},"targetPattern":{"nullable":false,"type":"string","default":"^/[^ \\x00-\\x20\\x7f]*$","label":"Target","description":"A request target: a slash and no space or control character.","tier":"domain"},"streams":{"nullable":false,"type":"[string]","default":["none","sse","jsonl"],"label":"Streams","description":"The stream framings a call may ask for.","tier":"domain","items":{"nullable":false,"type":"string"}},"recvBytes":{"nullable":false,"type":"number","default":16384,"label":"Read size","description":"The most bytes one os/recv of a streamed response takes.","tier":"infra"},"maxBody":{"nullable":false,"type":"number","default":67108864,"label":"Largest body","description":"A streamed body past this many bytes fails.","tier":"infra"},"credentialHeaders":{"nullable":false,"type":"[string]","default":["authorization","proxy-authorization","cookie","x-api-key"],"label":"Credential headers","description":"Header names that carry a credential. A payload never carries one: credentials ride a secret slot, so a call that sets one here is refused.","tier":"domain","items":{"nullable":false,"type":"string"}},"framingHeaders":{"nullable":false,"type":"[string]","default":["host","content-length","transfer-encoding","connection"],"label":"Framing headers","description":"Header names the fetch sets itself; a call that sets one is refused.","tier":"domain","items":{"nullable":false,"type":"string"}}},"dispatch":"client","sourceDeclaration":{"traitId":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB","fingerprint":"54d407c1e3105b464ab644c1da1950255836ded1131c05f88ea67d823fe0b575"}}],"pages":[{"name":"HttpFetchPage","id":"pag_PQ1JY8Z3BNHNTN3E2WM0CPQJY8","path":"","protocol":"boot","traits":[{"ref":"HttpFetch","refId":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},{"ref":"FetchFrame","refId":"trt_K3D277YS84CM2DCXCSD025Z9RY"}]}],"types":{"HttpHeader":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}]}}],"egress":["https://api.example.test"],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_9MD0HJTDWX6YEQAT2Y5650E3CE":{"id":"ent_9MD0HJTDWX6YEQAT2Y5650E3CE","kind":"entity","bakedName":"HttpFetchFlight","curName":"HttpFetchFlight","renames":[],"owner":"workspace"},"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8":{"id":"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8","kind":"event","bakedName":"HF_IO_FAILED","curName":"HF_IO_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_5D6VCFW26P13BA8J6GC0433Y82":{"id":"evt_5D6VCFW26P13BA8J6GC0433Y82","kind":"event","bakedName":"HF_CLOSED","curName":"HF_CLOSED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_5V5S9JFEB9Q5MQDD4HSR926E0P":{"id":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","kind":"event","bakedName":"HF_HEAD","curName":"HF_HEAD","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q":{"id":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","kind":"event","bakedName":"HTTP_SEND","curName":"HTTP_SEND","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_AJ07NBK596JMK850P91E35XKWK":{"id":"evt_AJ07NBK596JMK850P91E35XKWK","kind":"event","bakedName":"HF_FAILED","curName":"HF_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_CBV66CZV7AXKN9C547MF74MC23":{"id":"evt_CBV66CZV7AXKN9C547MF74MC23","kind":"event","bakedName":"HF_FRAME_FAILED","curName":"HF_FRAME_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_CP9H1BH22AH156XPDZHPP5NBDD":{"id":"evt_CP9H1BH22AH156XPDZHPP5NBDD","kind":"event","bakedName":"HF_HEAD_FAILED","curName":"HF_HEAD_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST":{"id":"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST","kind":"event","bakedName":"HF_FRAME_EVENT","curName":"HF_FRAME_EVENT","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF":{"id":"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF","kind":"event","bakedName":"HF_READ","curName":"HF_READ","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_N4CK3059B1MNGJQD4YK6NA72ZW":{"id":"evt_N4CK3059B1MNGJQD4YK6NA72ZW","kind":"event","bakedName":"HTTP_STREAM_EVENT","curName":"HTTP_STREAM_EVENT","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH":{"id":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","kind":"event","bakedName":"HF_FRAMED","curName":"HF_FRAMED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_NGZ60X63PE1V79SDTS5M39TF2V":{"id":"evt_NGZ60X63PE1V79SDTS5M39TF2V","kind":"event","bakedName":"HF_DRAINED","curName":"HF_DRAINED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_P8637JGGT78D3NS4G9PHEEQVWN":{"id":"evt_P8637JGGT78D3NS4G9PHEEQVWN","kind":"event","bakedName":"HTTP_FAILED","curName":"HTTP_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0":{"id":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","kind":"event","bakedName":"HF_REPLIED","curName":"HF_REPLIED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_RKHQHKYZ6NFKAS1MJ21TJJTZRF":{"id":"evt_RKHQHKYZ6NFKAS1MJ21TJJTZRF","kind":"event","bakedName":"HTTP_REPLIED","curName":"HTTP_REPLIED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_SV29N9H57QJKVVR4RVK2AE1DK1":{"id":"evt_SV29N9H57QJKVVR4RVK2AE1DK1","kind":"event","bakedName":"HF_FRAME","curName":"HF_FRAME","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_T7PMXV03NK1TSXDFBFYAC1NWMK":{"id":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","kind":"event","bakedName":"HF_AFTER","curName":"HF_AFTER","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_X88FR9PFD47PJ874HMAB410RPY":{"id":"evt_X88FR9PFD47PJ874HMAB410RPY","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"orb_0MD1Q9EFWM7YA0PPJJMXE0R2X5":{"id":"orb_0MD1Q9EFWM7YA0PPJJMXE0R2X5","kind":"orbital","bakedName":"HttpFetchOrbital","curName":"HttpFetchOrbital","renames":[],"owner":"workspace"},"pag_PQ1JY8Z3BNHNTN3E2WM0CPQJY8":{"id":"pag_PQ1JY8Z3BNHNTN3E2WM0CPQJY8","kind":"page","bakedName":"HttpFetchPage","curName":"HttpFetchPage","renames":[],"owner":"workspace"},"trt_K3D277YS84CM2DCXCSD025Z9RY":{"id":"trt_K3D277YS84CM2DCXCSD025Z9RY","kind":"trait","bakedName":"FetchFrame","curName":"FetchFrame","renames":[],"owner":"workspace"},"trt_M2MAHXAQDHBPRMGX0KTJ283WWB":{"id":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB","kind":"trait","bakedName":"HttpFetch","curName":"HttpFetch","renames":[],"owner":"workspace"}}}}
1	+ {"typeContractVersion":1,"types":{"HttpHeader":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}]},"name":"std-http-fetch","version":"1.0.0","description":"std-http-fetch — the HTTP client of a program that runs in a browser host, which has no sockets (spec/net/http-fetch.lolo). It answers the events std-http-client answers: HTTP_SEND { key, method, target, headers, body, stream } becomes one os/fetch of method, origin knob plus target, the headers and the body bytes (timeoutMs from the knob), and the host's raw status, headers and body come back as HTTP_REPLIED { key, status, headers, body } for any status (header names lower-cased, repeats joined with a comma and a space, as std-http-client). The origin knob must be declared in egress; the kernel answers an undeclared origin denied without asking the host. A request the atom will not write (method, header or target the patterns refuse, or a header naming framing or a credential) answers HTTP_FAILED kind refused, as std-http-client. A stream of sse or jsonl asks os/fetch with stream true: the host answers at the head, the body is read with os/recv on the handle (config.recvBytes at a time) and each complete frame is answered as HTTP_STREAM_EVENT { key, data, event, id } while the body is still arriving (the framing of std-http-client) The framing is std-http-frame, composed in this atom as the sibling trait FetchFrame: a program that asks for a stream composes FetchFrame beside this trait., then HTTP_REPLIED with an empty body when the body ends and the handle is closed. One stream is in flight per frame; a second HTTP_SEND meanwhile answers HTTP_FAILED kind refused. Any other stream answers HTTP_FAILED kind refused. A host failure keeps its kind denied or timeout, else io; a native host answers os/fetch unsupported, which is io here: a native program composes std-http-client instead. Nothing follows a redirect that the host's fetch does not.","orbitals":[{"name":"HttpFetchOrbital","id":"orb_0MD1Q9EFWM7YA0PPJJMXE0R2X5","uses":[{"from":"almadar-std/http-fetch","as":"Spec"},{"from":"std/behaviors/std-http-frame","as":"Frame"}],"entity":{"name":"HttpFetchFlight","id":"ent_9MD0HJTDWX6YEQAT2Y5650E3CE","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"key","type":"string","default":"","description":"The key of the stream in flight."},{"nullable":false,"name":"stream","type":"string","default":"none","description":"none, sse or jsonl."},{"nullable":false,"name":"handle","type":"number","default":-1,"description":"The open streamed response, -1 when none."},{"nullable":false,"name":"dec","type":"bytes","default":"","description":"Body bytes read and not yet framed."},{"nullable":false,"name":"status","type":"number","default":0,"description":"The status of the streamed head."},{"nullable":false,"name":"headers","type":"array","default":[],"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"value":{"nullable":false,"name":"value","type":"string","required":true}},"projectedFrom":{"type":"HttpHeader"}},"description":"The headers of the streamed head, names lower-cased."},{"nullable":false,"name":"total","type":"number","default":0,"description":"Body bytes read so far."},{"nullable":false,"name":"eof","type":"boolean","default":false,"description":"The body ended."},{"nullable":false,"name":"flushed","type":"boolean","default":false,"description":"The unterminated rest of the body was framed."}],"invariants":[[">=","@entity.total",0]]},"traits":[{"ref":"Frame.traits.HttpFrame","id":"trt_K3D277YS84CM2DCXCSD025Z9RY","name":"FetchFrame","listens":[{"event":"HF_FRAME","triggers":"FRAME_RUN","source":{"kind":"trait","trait":"HttpFetch"}}]},{"name":"HttpFetch","id":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB","effectRow":[{"kind":"emit","resource":"HF_AFTER"},{"kind":"emit","resource":"HF_FRAME"},{"kind":"emit","resource":"HF_FRAMED"},{"kind":"emit","resource":"HTTP_FAILED"},{"kind":"emit","resource":"HTTP_REPLIED"},{"kind":"emit","resource":"HTTP_STREAM_EVENT"},{"kind":"os/close"},{"kind":"os/fetch"},{"kind":"os/recv"},{"kind":"set","resource":"@entity.dec"},{"kind":"set","resource":"@entity.eof"},{"kind":"set","resource":"@entity.flushed"},{"kind":"set","resource":"@entity.handle"},{"kind":"set","resource":"@entity.headers"},{"kind":"set","resource":"@entity.key"},{"kind":"set","resource":"@entity.status"},{"kind":"set","resource":"@entity.stream"},{"kind":"set","resource":"@entity.total"}],"linkedEntity":"HttpFetchFlight","linkedEntityId":"ent_9MD0HJTDWX6YEQAT2Y5650E3CE","entityRefIds":{"HttpFetchFlight":"ent_9MD0HJTDWX6YEQAT2Y5650E3CE"},"emits":[{"event":"HTTP_REPLIED","eventId":"evt_RKHQHKYZ6NFKAS1MJ21TJJTZRF","description":"The response, of any status, whole.","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"body","type":"bytes","required":true}]},{"event":"HTTP_STREAM_EVENT","eventId":"evt_N4CK3059B1MNGJQD4YK6NA72ZW","description":"One complete frame of a streamed response (sse or jsonl).","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"data","type":"string","required":true},{"nullable":true,"name":"event","type":"string"},{"nullable":true,"name":"id","type":"string"}]},{"event":"HTTP_FAILED","eventId":"evt_P8637JGGT78D3NS4G9PHEEQVWN","description":"The call produced no response: kind refused (nothing sent), denied, unsupported (the host cannot fetch), timeout, encoding (a stream frame is not UTF-8) or io.","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}]},{"event":"HF_HEAD","eventId":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","description":"Internal: the os/fetch answer of a streamed fetch, at the head.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":true,"name":"handle","type":"number"}]},{"event":"HF_HEAD_FAILED","eventId":"evt_CP9H1BH22AH156XPDZHPP5NBDD","description":"Internal: the os/fetch failure of a streamed fetch.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}]},{"event":"HF_READ","eventId":"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF","description":"Internal: one os/recv answer of a streamed response.","tier":"internal","payloadSchema":[{"nullable":false,"name":"data","type":"bytes","required":true},{"nullable":false,"name":"eof","type":"boolean","required":true}]},{"event":"HF_IO_FAILED","eventId":"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8","description":"Internal: an os/recv of a streamed response failed.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"event":"HF_FRAMED","eventId":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","description":"Internal: body bytes were read; frame a stream or read more.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"n","type":"number","required":true}]},{"event":"HF_AFTER","eventId":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","description":"Internal: no frame is complete; read more or finish.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"n","type":"number","required":true}]},{"event":"HF_FRAME","eventId":"evt_SV29N9H57QJKVVR4RVK2AE1DK1","description":"Internal: the unframed stream bytes, for the framer.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"stream","type":"string","required":true},{"nullable":false,"name":"data","type":"bytes","required":true},{"nullable":false,"name":"final","type":"boolean","required":true}]},{"event":"HF_CLOSED","eventId":"evt_5D6VCFW26P13BA8J6GC0433Y82","description":"Internal: the streamed response was closed.","tier":"internal"},{"event":"HF_REPLIED","eventId":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","description":"Internal: the os/fetch answer.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true}]},{"event":"HF_FAILED","eventId":"evt_AJ07NBK596JMK850P91E35XKWK","description":"Internal: the os/fetch failure.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}]}],"listens":[{"event":"FRAME_EVENT","triggers":"HF_FRAME_EVENT","triggersId":"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST","source":{"kind":"trait","trait":"FetchFrame","traitId":"trt_K3D277YS84CM2DCXCSD025Z9RY"}},{"event":"FRAME_DRAINED","triggers":"HF_DRAINED","triggersId":"evt_NGZ60X63PE1V79SDTS5M39TF2V","source":{"kind":"trait","trait":"FetchFrame","traitId":"trt_K3D277YS84CM2DCXCSD025Z9RY"}},{"event":"FRAME_FAILED","triggers":"HF_FRAME_FAILED","triggersId":"evt_CBV66CZV7AXKN9C547MF74MC23","source":{"kind":"trait","trait":"FetchFrame","traitId":"trt_K3D277YS84CM2DCXCSD025Z9RY"}}],"stateMachine":{"states":[{"name":"ready","isInitial":true},{"name":"opening"},{"name":"streaming"}],"events":[{"key":"INIT","id":"evt_X88FR9PFD47PJ874HMAB410RPY","name":"Initialize"},{"key":"HTTP_SEND","id":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","name":"Http Send","description":"Make one HTTP call; answered HTTP_REPLIED or HTTP_FAILED, and with a stream each frame as HTTP_STREAM_EVENT first.","synonyms":"browser http client, fetch","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"method","type":"string","required":true},{"nullable":false,"name":"target","type":"string","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":false,"name":"stream","type":"string","required":true}],"listened":true},{"key":"HF_REPLIED","id":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","name":"Hf Replied","description":"Internal: the os/fetch answer.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true}],"listened":true},{"key":"HF_FAILED","id":"evt_AJ07NBK596JMK850P91E35XKWK","name":"Hf Failed","description":"Internal: the os/fetch failure.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}],"listened":true},{"key":"HF_CLOSED","id":"evt_5D6VCFW26P13BA8J6GC0433Y82","name":"Hf Closed","description":"Internal: the streamed response was closed.","tier":"internal","listened":true},{"key":"HF_HEAD","id":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","name":"Hf Head","description":"Internal: the os/fetch answer of a streamed fetch, at the head.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":true,"name":"handle","type":"number"}],"listened":true},{"key":"HF_HEAD_FAILED","id":"evt_CP9H1BH22AH156XPDZHPP5NBDD","name":"Hf Head Failed","description":"Internal: the os/fetch failure of a streamed fetch.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string"},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}],"listened":true},{"key":"HF_IO_FAILED","id":"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8","name":"Hf Io Failed","description":"Internal: an os/recv of a streamed response failed.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"},{"nullable":false,"name":"kind","type":"string"}],"listened":true},{"key":"HF_READ","id":"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF","name":"Hf Read","description":"Internal: one os/recv answer of a streamed response.","tier":"internal","payloadSchema":[{"nullable":false,"name":"data","type":"bytes","required":true},{"nullable":false,"name":"eof","type":"boolean","required":true}],"listened":true},{"key":"HF_FRAMED","id":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","name":"Hf Framed","description":"Internal: body bytes were read; frame a stream or read more.","tier":"internal","payloadSchema":[{"nullable":false,"name":"n","type":"number","required":true}]},{"key":"HF_DRAINED","id":"evt_NGZ60X63PE1V79SDTS5M39TF2V","name":"Hf Drained","payloadSchema":[{"nullable":false,"name":"rest","type":"bytes","required":true}],"listened":true},{"key":"HF_FRAME_EVENT","id":"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST","name":"Hf Frame Event","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"data","type":"string","required":true},{"nullable":true,"name":"event","type":"string"},{"nullable":true,"name":"id","type":"string"}],"listened":true},{"key":"HF_FRAME_FAILED","id":"evt_CBV66CZV7AXKN9C547MF74MC23","name":"Hf Frame Failed","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}],"listened":true},{"key":"HF_AFTER","id":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","name":"Hf After","description":"Internal: no frame is complete; read more or finish.","tier":"internal","payloadSchema":[{"nullable":false,"name":"n","type":"number","required":true}]},{"key":"HTTP_REPLIED","id":"evt_RKHQHKYZ6NFKAS1MJ21TJJTZRF","name":"Http Replied","description":"The response, of any status, whole.","tier":"primary","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"body","type":"bytes","required":true}]},{"key":"HTTP_STREAM_EVENT","id":"evt_N4CK3059B1MNGJQD4YK6NA72ZW","name":"Http Stream Event","description":"One complete frame of a streamed response (sse or jsonl).","tier":"primary","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"data","type":"string","required":true},{"nullable":true,"name":"event","type":"string"},{"nullable":true,"name":"id","type":"string"}]},{"key":"HTTP_FAILED","id":"evt_P8637JGGT78D3NS4G9PHEEQVWN","name":"Http Failed","description":"The call produced no response: kind refused (nothing sent), denied, unsupported (the host cannot fetch), timeout, encoding (a stream frame is not UTF-8) or io.","tier":"primary","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}]},{"key":"HF_FRAME","id":"evt_SV29N9H57QJKVVR4RVK2AE1DK1","name":"Hf Frame","description":"Internal: the unframed stream bytes, for the framer.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"stream","type":"string","required":true},{"nullable":false,"name":"data","type":"bytes","required":true},{"nullable":false,"name":"final","type":"boolean","required":true}]}],"transitions":[{"from":"ready","to":"ready","event":"INIT","eventId":"evt_X88FR9PFD47PJ874HMAB410RPY"},{"from":"ready","to":"ready","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","guard":["not",["and",["validate/pattern","@payload.method","@config.tokenPattern"],["validate/pattern","@payload.target","@config.targetPattern"],["array/includes","@config.streams","@payload.stream"],["array/every","@payload.headers",["fn","h",["and",["validate/pattern","@h.name","@config.tokenPattern"],["validate/pattern","@h.value","@config.valuePattern"],["not",["array/includes","@config.framingHeaders",["str/lower","@h.name"]]],["not",["array/includes","@config.credentialHeaders",["str/lower","@h.name"]]]]]]]],"effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"the request cannot be written: a method, header, target or stream is not allowed, or a header names framing the fetch sets or carries a credential","kind":"refused"}]]},{"from":"ready","to":"ready","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","guard":["and",["=","@payload.stream","none"],["and",["validate/pattern","@payload.method","@config.tokenPattern"],["validate/pattern","@payload.target","@config.targetPattern"],["array/includes","@config.streams","@payload.stream"],["array/every","@payload.headers",["fn","h",["and",["validate/pattern","@h.name","@config.tokenPattern"],["validate/pattern","@h.value","@config.valuePattern"],["not",["array/includes","@config.framingHeaders",["str/lower","@h.name"]]],["not",["array/includes","@config.credentialHeaders",["str/lower","@h.name"]]]]]]]],"effects":[["os/fetch","@payload.method",["str/concat","@config.origin","@payload.target"],{"headers":"@payload.headers","body":"@payload.body","timeoutMs":"@config.timeoutMs"},{"key":"@payload.key","emit":{"success":"HF_REPLIED","failure":"HF_FAILED"}}]]},{"from":"ready","to":"opening","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","guard":["and",["!=","@payload.stream","none"],["and",["validate/pattern","@payload.method","@config.tokenPattern"],["validate/pattern","@payload.target","@config.targetPattern"],["array/includes","@config.streams","@payload.stream"],["array/every","@payload.headers",["fn","h",["and",["validate/pattern","@h.name","@config.tokenPattern"],["validate/pattern","@h.value","@config.valuePattern"],["not",["array/includes","@config.framingHeaders",["str/lower","@h.name"]]],["not",["array/includes","@config.credentialHeaders",["str/lower","@h.name"]]]]]]]],"effects":[["set","@entity.key","@payload.key"],["set","@entity.stream","@payload.stream"],["set","@entity.handle",-1],["set","@entity.dec",["bytes/from-string",""]],["set","@entity.total",0],["set","@entity.eof",false],["set","@entity.flushed",false],["os/fetch","@payload.method",["str/concat","@config.origin","@payload.target"],{"headers":"@payload.headers","body":"@payload.body","timeoutMs":"@config.timeoutMs","stream":true},{"key":"@payload.key","emit":{"success":"HF_HEAD","failure":"HF_HEAD_FAILED"}}]]},{"from":"ready","to":"ready","event":"HF_REPLIED","eventId":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","effects":[["emit","HTTP_REPLIED",{"key":"@payload.key","status":"@payload.status","headers":["default",["object/fromEntries",["array/map","@payload.headers",["fn","h",[["str/lower","@h.name"],["str/join",["array/map",["array/filter","@payload.headers",["fn","g",["=",["str/lower","@g.name"],["str/lower","@h.name"]]]],["fn","g","@g.value"]],", "]]]]],{}],"body":"@payload.body"}]]},{"from":"ready","to":"ready","event":"HF_FAILED","eventId":"evt_AJ07NBK596JMK850P91E35XKWK","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"@payload.error","kind":["if",["array/includes",["denied","unsupported","timeout"],"@payload.kind"],"@payload.kind","io"]}]]},{"from":"ready","to":"ready","event":"HF_CLOSED","eventId":"evt_5D6VCFW26P13BA8J6GC0433Y82"},{"from":"opening","to":"opening","event":"INIT","eventId":"evt_X88FR9PFD47PJ874HMAB410RPY"},{"from":"opening","to":"opening","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"a stream is in flight on this frame","kind":"refused"}]]},{"from":"opening","to":"opening","event":"HF_REPLIED","eventId":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","effects":[["emit","HTTP_REPLIED",{"key":"@payload.key","status":"@payload.status","headers":["default",["object/fromEntries",["array/map","@payload.headers",["fn","h",[["str/lower","@h.name"],["str/join",["array/map",["array/filter","@payload.headers",["fn","g",["=",["str/lower","@g.name"],["str/lower","@h.name"]]]],["fn","g","@g.value"]],", "]]]]],{}],"body":"@payload.body"}]]},{"from":"opening","to":"opening","event":"HF_FAILED","eventId":"evt_AJ07NBK596JMK850P91E35XKWK","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"@payload.error","kind":["if",["array/includes",["denied","unsupported","timeout"],"@payload.kind"],"@payload.kind","io"]}]]},{"from":"opening","to":"opening","event":"HF_CLOSED","eventId":"evt_5D6VCFW26P13BA8J6GC0433Y82"},{"from":"opening","to":"ready","event":"HF_HEAD","eventId":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","guard":["==","@payload.handle",null],"effects":[["emit","HTTP_FAILED",{"key":"@entity.key","error":"the host answered a streamed fetch with no handle","kind":"io"}]]},{"from":"opening","to":"streaming","event":"HF_HEAD","eventId":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","guard":["!=","@payload.handle",null],"effects":[["set","@entity.handle",["default","@payload.handle",-1]],["set","@entity.status","@payload.status"],["set","@entity.headers",["array/map","@payload.headers",["fn","h",{"name":["str/lower","@h.name"],"value":"@h.value"}]]],["os/recv","@payload.handle","@config.recvBytes",{"key":"read","emit":{"success":"HF_READ","failure":"HF_IO_FAILED"}}]]},{"from":"opening","to":"ready","event":"HF_HEAD_FAILED","eventId":"evt_CP9H1BH22AH156XPDZHPP5NBDD","effects":[["emit","HTTP_FAILED",{"key":"@entity.key","error":"@payload.error","kind":["if",["array/includes",["denied","unsupported","timeout"],"@payload.kind"],"@payload.kind","io"]}]]},{"from":"streaming","to":"streaming","event":"INIT","eventId":"evt_X88FR9PFD47PJ874HMAB410RPY"},{"from":"streaming","to":"streaming","event":"HTTP_SEND","eventId":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"a stream is in flight on this frame","kind":"refused"}]]},{"from":"streaming","to":"streaming","event":"HF_REPLIED","eventId":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","effects":[["emit","HTTP_REPLIED",{"key":"@payload.key","status":"@payload.status","headers":["default",["object/fromEntries",["array/map","@payload.headers",["fn","h",[["str/lower","@h.name"],["str/join",["array/map",["array/filter","@payload.headers",["fn","g",["=",["str/lower","@g.name"],["str/lower","@h.name"]]]],["fn","g","@g.value"]],", "]]]]],{}],"body":"@payload.body"}]]},{"from":"streaming","to":"streaming","event":"HF_FAILED","eventId":"evt_AJ07NBK596JMK850P91E35XKWK","effects":[["emit","HTTP_FAILED",{"key":"@payload.key","error":"@payload.error","kind":["if",["array/includes",["denied","unsupported","timeout"],"@payload.kind"],"@payload.kind","io"]}]]},{"from":"streaming","to":"streaming","event":"HF_CLOSED","eventId":"evt_5D6VCFW26P13BA8J6GC0433Y82"},{"from":"streaming","to":"ready","event":"HF_IO_FAILED","eventId":"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8","effects":[["os/close","@entity.handle",{"key":"close","emit":{"success":"HF_CLOSED","failure":"HF_CLOSED"}}],["set","@entity.handle",-1],["emit","HTTP_FAILED",{"key":"@entity.key","error":"@payload.error","kind":["if",["array/includes",["denied","unsupported","timeout"],"@payload.kind"],"@payload.kind","io"]}]]},{"from":"streaming","to":"streaming","event":"HF_READ","eventId":"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF","effects":[["set","@entity.dec",["bytes/concat",["@entity.dec","@payload.data"]]],["set","@entity.total",["+","@entity.total",["bytes/length","@payload.data"]]],["set","@entity.eof","@payload.eof"],["emit","HF_FRAMED",{"n":["+","@entity.total",["bytes/length","@entity.dec"]]}]]},{"from":"streaming","to":"streaming","event":"HF_FRAMED","eventId":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","guard":[">","@entity.total","@config.maxBody"],"effects":[["os/close","@entity.handle",{"key":"close","emit":{"success":"HF_CLOSED","failure":"HF_CLOSED"}}],["set","@entity.handle",-1],["emit","HTTP_FAILED",{"key":"@entity.key","error":"the body is past the largest body","kind":"io"}]]},{"from":"streaming","to":"streaming","event":"HF_FRAMED","eventId":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","guard":["<=","@entity.total","@config.maxBody"],"effects":[["emit","HF_FRAME",{"key":"@entity.key","stream":"@entity.stream","data":"@entity.dec","final":false}]]},{"from":"streaming","to":"streaming","event":"HF_DRAINED","eventId":"evt_NGZ60X63PE1V79SDTS5M39TF2V","effects":[["set","@entity.dec","@payload.rest"],["emit","HF_AFTER",{"n":["+","@entity.total",["bytes/length","@entity.dec"]]}]]},{"from":"streaming","to":"streaming","event":"HF_FRAME_EVENT","eventId":"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST","effects":[["emit","HTTP_STREAM_EVENT",{"key":"@payload.key","data":"@payload.data","event":"@payload.event","id":"@payload.id"}]]},{"from":"streaming","to":"streaming","event":"HF_FRAME_FAILED","eventId":"evt_CBV66CZV7AXKN9C547MF74MC23","effects":[["os/close","@entity.handle",{"key":"close","emit":{"success":"HF_CLOSED","failure":"HF_CLOSED"}}],["set","@entity.handle",-1],["emit","HTTP_FAILED",{"key":"@payload.key","error":"@payload.error","kind":"@payload.kind"}]]},{"from":"streaming","to":"streaming","event":"HF_AFTER","eventId":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","guard":["not","@entity.eof"],"effects":[["os/recv","@entity.handle","@config.recvBytes",{"key":"read","emit":{"success":"HF_READ","failure":"HF_IO_FAILED"}}]]},{"from":"streaming","to":"streaming","event":"HF_AFTER","eventId":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","guard":["and","@entity.eof",["not","@entity.flushed"],[">",["bytes/length","@entity.dec"],0]],"effects":[["set","@entity.flushed",true],["emit","HF_FRAME",{"key":"@entity.key","stream":"@entity.stream","data":"@entity.dec","final":true}]]},{"from":"streaming","to":"ready","event":"HF_AFTER","eventId":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","guard":["and","@entity.eof",["or","@entity.flushed",["=",["bytes/length","@entity.dec"],0]]],"effects":[["os/close","@entity.handle",{"key":"close","emit":{"success":"HF_CLOSED","failure":"HF_CLOSED"}}],["set","@entity.handle",-1],["set","@entity.dec",["bytes/from-string",""]],["emit","HTTP_REPLIED",{"key":"@entity.key","status":"@entity.status","headers":["default",["object/fromEntries",["array/map","@entity.headers",["fn","h",["@h.name",["str/join",["array/map",["array/filter","@entity.headers",["fn","g",["=","@g.name","@h.name"]]],["fn","g","@g.value"]],", "]]]]],{}],"body":["bytes/from-string",""]}]]}]},"config":{"origin":{"nullable":false,"type":"url","default":"https://api.example.test","label":"Origin","description":"The scheme and host every request is made against (no trailing slash); declared in egress.","tier":"infra"},"timeoutMs":{"nullable":false,"type":"number","default":30000,"label":"Timeout","description":"The longest the host waits for the fetch to answer.","tier":"infra"},"tokenPattern":{"nullable":false,"type":"string","default":"^[!#$%&'+.^_`\|~0-9A-Za-z-]+$","label":"Token","description":"What a method or header name must match.","tier":"domain"},"valuePattern":{"nullable":false,"type":"string","default":"^[^\\x00-\\x08\\x0a-\\x1f\\x7f]$","label":"Header value","description":"What a header value may hold: no control character other than a tab.","tier":"domain"},"targetPattern":{"nullable":false,"type":"string","default":"^/[^ \\x00-\\x20\\x7f]*$","label":"Target","description":"A request target: a slash and no space or control character.","tier":"domain"},"streams":{"nullable":false,"type":"[string]","default":["none","sse","jsonl"],"label":"Streams","description":"The stream framings a call may ask for.","tier":"domain","items":{"nullable":false,"type":"string"}},"recvBytes":{"nullable":false,"type":"number","default":16384,"label":"Read size","description":"The most bytes one os/recv of a streamed response takes.","tier":"infra"},"maxBody":{"nullable":false,"type":"number","default":67108864,"label":"Largest body","description":"A streamed body past this many bytes fails.","tier":"infra"},"credentialHeaders":{"nullable":false,"type":"[string]","default":["authorization","proxy-authorization","cookie","x-api-key"],"label":"Credential headers","description":"Header names that carry a credential. A payload never carries one: credentials ride a secret slot, so a call that sets one here is refused.","tier":"domain","items":{"nullable":false,"type":"string"}},"framingHeaders":{"nullable":false,"type":"[string]","default":["host","content-length","transfer-encoding","connection"],"label":"Framing headers","description":"Header names the fetch sets itself; a call that sets one is refused.","tier":"domain","items":{"nullable":false,"type":"string"}}},"dispatch":"client","sourceDeclaration":{"traitId":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB","fingerprint":"40d6656464f9961bbb11aa45f6e8992f9d0d90c871cb2161b6f35af697aeb400"}}],"pages":[{"name":"HttpFetchPage","id":"pag_PQ1JY8Z3BNHNTN3E2WM0CPQJY8","path":"","protocol":"boot","traits":[{"ref":"HttpFetch","refId":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},{"ref":"FetchFrame","refId":"trt_K3D277YS84CM2DCXCSD025Z9RY"}]}],"types":{"HttpHeader":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}]}}],"egress":["https://api.example.test"],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_9MD0HJTDWX6YEQAT2Y5650E3CE":{"id":"ent_9MD0HJTDWX6YEQAT2Y5650E3CE","kind":"entity","bakedName":"HttpFetchFlight","curName":"HttpFetchFlight","renames":[],"owner":"workspace"},"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8":{"id":"evt_51YJ7RFM57T2KKAV2AR9ZGW8T8","kind":"event","bakedName":"HF_IO_FAILED","curName":"HF_IO_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_5D6VCFW26P13BA8J6GC0433Y82":{"id":"evt_5D6VCFW26P13BA8J6GC0433Y82","kind":"event","bakedName":"HF_CLOSED","curName":"HF_CLOSED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_5V5S9JFEB9Q5MQDD4HSR926E0P":{"id":"evt_5V5S9JFEB9Q5MQDD4HSR926E0P","kind":"event","bakedName":"HF_HEAD","curName":"HF_HEAD","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q":{"id":"evt_8GREZWCRWGCE80VN1F4FBXRZ2Q","kind":"event","bakedName":"HTTP_SEND","curName":"HTTP_SEND","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_AJ07NBK596JMK850P91E35XKWK":{"id":"evt_AJ07NBK596JMK850P91E35XKWK","kind":"event","bakedName":"HF_FAILED","curName":"HF_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_CBV66CZV7AXKN9C547MF74MC23":{"id":"evt_CBV66CZV7AXKN9C547MF74MC23","kind":"event","bakedName":"HF_FRAME_FAILED","curName":"HF_FRAME_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_CP9H1BH22AH156XPDZHPP5NBDD":{"id":"evt_CP9H1BH22AH156XPDZHPP5NBDD","kind":"event","bakedName":"HF_HEAD_FAILED","curName":"HF_HEAD_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST":{"id":"evt_H8YK9B9ZZMZZTDBSEA28QQZ9ST","kind":"event","bakedName":"HF_FRAME_EVENT","curName":"HF_FRAME_EVENT","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF":{"id":"evt_HCB5ZK3G1BR0NJ3KFZ46M6WZVF","kind":"event","bakedName":"HF_READ","curName":"HF_READ","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_N4CK3059B1MNGJQD4YK6NA72ZW":{"id":"evt_N4CK3059B1MNGJQD4YK6NA72ZW","kind":"event","bakedName":"HTTP_STREAM_EVENT","curName":"HTTP_STREAM_EVENT","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH":{"id":"evt_NGYKJ3KBQANVNBMTY3XN4G1HYH","kind":"event","bakedName":"HF_FRAMED","curName":"HF_FRAMED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_NGZ60X63PE1V79SDTS5M39TF2V":{"id":"evt_NGZ60X63PE1V79SDTS5M39TF2V","kind":"event","bakedName":"HF_DRAINED","curName":"HF_DRAINED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_P8637JGGT78D3NS4G9PHEEQVWN":{"id":"evt_P8637JGGT78D3NS4G9PHEEQVWN","kind":"event","bakedName":"HTTP_FAILED","curName":"HTTP_FAILED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0":{"id":"evt_QY6XBHJSMZCTFP0TNTA4AHVWG0","kind":"event","bakedName":"HF_REPLIED","curName":"HF_REPLIED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_RKHQHKYZ6NFKAS1MJ21TJJTZRF":{"id":"evt_RKHQHKYZ6NFKAS1MJ21TJJTZRF","kind":"event","bakedName":"HTTP_REPLIED","curName":"HTTP_REPLIED","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_SV29N9H57QJKVVR4RVK2AE1DK1":{"id":"evt_SV29N9H57QJKVVR4RVK2AE1DK1","kind":"event","bakedName":"HF_FRAME","curName":"HF_FRAME","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_T7PMXV03NK1TSXDFBFYAC1NWMK":{"id":"evt_T7PMXV03NK1TSXDFBFYAC1NWMK","kind":"event","bakedName":"HF_AFTER","curName":"HF_AFTER","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"evt_X88FR9PFD47PJ874HMAB410RPY":{"id":"evt_X88FR9PFD47PJ874HMAB410RPY","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB"},"orb_0MD1Q9EFWM7YA0PPJJMXE0R2X5":{"id":"orb_0MD1Q9EFWM7YA0PPJJMXE0R2X5","kind":"orbital","bakedName":"HttpFetchOrbital","curName":"HttpFetchOrbital","renames":[],"owner":"workspace"},"pag_PQ1JY8Z3BNHNTN3E2WM0CPQJY8":{"id":"pag_PQ1JY8Z3BNHNTN3E2WM0CPQJY8","kind":"page","bakedName":"HttpFetchPage","curName":"HttpFetchPage","renames":[],"owner":"workspace"},"trt_K3D277YS84CM2DCXCSD025Z9RY":{"id":"trt_K3D277YS84CM2DCXCSD025Z9RY","kind":"trait","bakedName":"FetchFrame","curName":"FetchFrame","renames":[],"owner":"workspace"},"trt_M2MAHXAQDHBPRMGX0KTJ283WWB":{"id":"trt_M2MAHXAQDHBPRMGX0KTJ283WWB","kind":"trait","bakedName":"HttpFetch","curName":"HttpFetch","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/net/atoms/std-npm-lookup.orb CHANGED Viewed

	@@ -1 +1 @@
1	- {"typeContractVersion":1,"types":{"HttpHeader":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"LookupDist":[{"nullable":true,"name":"tarball","type":"string"}],"LookupPackument":[{"nullable":false,"name":"versions","type":"Map<string,LookupVersionDoc>","items":{"nullable":true,"name":"","type":"LookupVersionDoc","projectedFrom":{"type":"LookupVersionDoc"}}},{"nullable":false,"name":"dist-tags","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}],"LookupVersionDoc":[{"nullable":true,"name":"dist","type":"LookupDist","projectedFrom":{"type":"LookupDist"}}]},"name":"std-npm-lookup","version":"1.0.0","description":"std-npm-lookup — a read-only client of an npm-protocol registry (public npm or GitHub Packages; the origin is the registry knob and the bearer token is the token credential, both from config). GET only, never a write. One ask at a time; an ask during another answers NPM_LOOKUP_REFUSED npm_busy. NPM_LOOKUP { requestId, name, tag } reads the packument and answers NPM_LOOKED { requestId, name, versions (semver ascending), distTags, version } where version is the dist-tag tag points to (latest when tag is empty), empty when the package has no such tag, and tarballs maps each version to its tarball url, empty when the packument gives none or the url sits outside the registry origin; whether a version exists is its membership in versions. A reply is classified in NPM_LOOKUP_REFUSED.code: 401 and 403 are auth, 404 absent, 5xx unreachable, any other status unexpected; a transport failure is unreachable, an unset credential unconfigured.","orbitals":[{"name":"NpmLookupOrbital","id":"orb_H9VWCD63371HKNT9C78K9WGTJ3","uses":[{"from":"almadar-std/npm-lookup","as":"Spec"},{"from":"std/behaviors/std-http-client","as":"Http"},{"from":"std/behaviors/std-timeout","as":"Timeout"}],"entity":{"name":"NpmLookupAsk","id":"ent_XWTAVVENW2AY17HC1YZB0N5121","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"requestId","type":"string","default":"","description":"The caller's name for the ask in flight."},{"nullable":false,"name":"name","type":"string","default":"","description":"The package the ask in flight is about."},{"nullable":false,"name":"tag","type":"string","default":"","description":"The dist-tag whose version the ask wants; latest when empty."}]},"traits":[{"ref":"Http.traits.HttpClient","id":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X","name":"LookupHttp","config":{"host":{"type":"unknown","default":"registry.npmjs.org","wired":true},"port":{"type":"unknown","default":443,"wired":true},"tls":{"type":"unknown","default":true,"wired":true},"serverName":{"type":"unknown","default":"registry.npmjs.org","wired":true},"dynamicHost":{"type":"unknown","default":true,"wired":true},"credential":{"type":"unknown","default":"NPM_REGISTRY_TOKEN","wired":true}},"listens":[{"event":"NPM_LOOKUP_HTTP_SEND","triggers":"HTTP_SEND","source":{"kind":"trait","trait":"NpmLookup"}},{"event":"TIMED_OUT","triggers":"HTTP_CANCEL","payloadMapping":{"key":"@payload.key"},"source":{"kind":"trait","trait":"LookupTimeout"}}]},{"ref":"Timeout.traits.Timeout","id":"trt_ZXN02GETP5DB2Z57EJVBK8DF8N","name":"LookupTimeout","config":{"timeoutMs":{"type":"unknown","default":20000,"wired":true},"cancelOnDeadline":{"type":"unknown","default":false,"wired":true}},"listens":[{"event":"NPM_LOOKUP_HTTP_SEND","triggers":"START","payloadMapping":{"key":["as","@payload.key","CallKey"]},"source":{"kind":"trait","trait":"NpmLookup"}},{"event":"HTTP_REPLIED","triggers":"SUCCEEDED","payloadMapping":{"key":["as","@payload.key","CallKey"]},"source":{"kind":"trait","trait":"LookupHttp"}},{"event":"HTTP_FAILED","triggers":"FAILED","payloadMapping":{"key":["as","@payload.key","CallKey"],"error":"@payload.error"},"source":{"kind":"trait","trait":"LookupHttp"}}]},{"name":"NpmLookup","id":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ","effectRow":[{"kind":"emit","resource":"NPM_LOOKED"},{"kind":"emit","resource":"NPM_LOOKUP_GET"},{"kind":"emit","resource":"NPM_LOOKUP_HTTP_SEND"},{"kind":"emit","resource":"NPM_LOOKUP_REFUSED"},{"kind":"set","resource":"@entity.name"},{"kind":"set","resource":"@entity.requestId"},{"kind":"set","resource":"@entity.tag"}],"linkedEntity":"NpmLookupAsk","linkedEntityId":"ent_XWTAVVENW2AY17HC1YZB0N5121","entityRefIds":{"NpmLookupAsk":"ent_XWTAVVENW2AY17HC1YZB0N5121"},"emits":[{"event":"NPM_LOOKED","eventId":"evt_TXGA3EQEF3Q7HP0X836FQYM7C6","description":"The package's published versions, semver ascending, its dist-tags, the version the asked tag points to, and each version's tarball url.","synonyms":"versions list, published versions, dist-tags, latest version, version exists","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"versions","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"distTags","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"version","type":"string","required":true},{"nullable":false,"name":"tarballs","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"event":"NPM_LOOKUP_REFUSED","eventId":"evt_7XVMB5ZQ0JVG93V5D4XS4HQVGZ","description":"The lookup failed: code is auth, absent, unreachable, unexpected, unconfigured or npm_busy.","synonyms":"registry failed, 401, unauthorized, not found","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"code","type":"string","required":true},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"error","type":"string","required":true}]},{"event":"NPM_LOOKUP_GET","eventId":"evt_PWS6Q87EE7Q73GX56PD2B385RM","description":"Internal: read the packument of the package in flight.","tier":"internal","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true}]},{"event":"NPM_LOOKUP_HTTP_SEND","eventId":"evt_13ABNG67MA3T5DPDP21306J5M7","description":"Internal: the registry read, for the HTTP client.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"method","type":"string","required":true},{"nullable":false,"name":"target","type":"string","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":false,"name":"stream","type":"string","required":true},{"nullable":false,"name":"host","type":"string"}]}],"listens":[{"event":"HTTP_REPLIED","triggers":"NPM_LOOKUP_PACKUMENT","triggersId":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","payloadMapping":{"status":"@payload.status","headers":"@payload.headers","body":["default",["bytes/to-string","@payload.body"],""]},"guard":["=","@payload.key","lookup"],"source":{"kind":"trait","trait":"LookupHttp","traitId":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X"}},{"event":"HTTP_FAILED","triggers":"NPM_LOOKUP_UNREACHABLE","triggersId":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","payloadMapping":{"error":"@payload.error","kind":"@payload.kind"},"guard":["=","@payload.key","lookup"],"source":{"kind":"trait","trait":"LookupHttp","traitId":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X"}},{"event":"TIMED_OUT","triggers":"NPM_LOOKUP_UNREACHABLE","triggersId":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","payloadMapping":{"error":["str/concat","timeout of ","@payload.timeoutMs","ms exceeded"],"kind":"timeout"},"guard":["=","@payload.key","lookup"],"source":{"kind":"trait","trait":"LookupTimeout","traitId":"trt_ZXN02GETP5DB2Z57EJVBK8DF8N"}}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"looking"}],"events":[{"key":"INIT","id":"evt_CKB8B5XM6ET37DD249J8258ZQB","name":"Initialize"},{"key":"NPM_LOOKUP","id":"evt_K4TY7RJ6N93AMVZDGY25CDQCQT","name":"Npm Lookup","description":"Read the package's published versions and dist-tags.","synonyms":"npm view, list versions, dist-tags, latest version, version exists","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"tag","type":"string"}],"listened":true},{"key":"NPM_LOOKUP_GET","id":"evt_PWS6Q87EE7Q73GX56PD2B385RM","name":"Npm Lookup Get","description":"Internal: read the packument of the package in flight.","tier":"internal","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true}]},{"key":"NPM_LOOKUP_PACKUMENT","id":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","name":"Npm Lookup Packument","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"body","type":"string","required":true}],"listened":true},{"key":"NPM_LOOKUP_UNREACHABLE","id":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","name":"Npm Lookup Unreachable","payloadSchema":[{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}],"listened":true},{"key":"NPM_LOOKED","id":"evt_TXGA3EQEF3Q7HP0X836FQYM7C6","name":"Npm Looked","description":"The package's published versions, semver ascending, its dist-tags, the version the asked tag points to, and each version's tarball url.","synonyms":"versions list, published versions, dist-tags, latest version, version exists","tier":"primary","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"versions","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"distTags","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"version","type":"string","required":true},{"nullable":false,"name":"tarballs","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"key":"NPM_LOOKUP_REFUSED","id":"evt_7XVMB5ZQ0JVG93V5D4XS4HQVGZ","name":"Npm Lookup Refused","description":"The lookup failed: code is auth, absent, unreachable, unexpected, unconfigured or npm_busy.","synonyms":"registry failed, 401, unauthorized, not found","tier":"primary","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"code","type":"string","required":true},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"error","type":"string","required":true}]},{"key":"NPM_LOOKUP_HTTP_SEND","id":"evt_13ABNG67MA3T5DPDP21306J5M7","name":"Npm Lookup Http Send","description":"Internal: the registry read, for the HTTP client.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"method","type":"string","required":true},{"nullable":false,"name":"target","type":"string","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":false,"name":"stream","type":"string","required":true},{"nullable":false,"name":"host","type":"string"}]}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_CKB8B5XM6ET37DD249J8258ZQB"},{"from":"idle","to":"looking","event":"NPM_LOOKUP","eventId":"evt_K4TY7RJ6N93AMVZDGY25CDQCQT","effects":[["set","@entity.requestId","@payload.requestId"],["set","@entity.name","@payload.name"],["set","@entity.tag",["default","@payload.tag","latest"]],["emit","NPM_LOOKUP_GET",{"requestId":"@payload.requestId"}]]},{"from":"looking","to":"idle","event":"INIT","eventId":"evt_CKB8B5XM6ET37DD249J8258ZQB"},{"from":"looking","to":"looking","event":"NPM_LOOKUP","eventId":"evt_K4TY7RJ6N93AMVZDGY25CDQCQT","effects":[["emit","NPM_LOOKUP_REFUSED",{"requestId":"@payload.requestId","name":"@payload.name","code":"npm_busy","status":0,"error":["str/concat","the registry is being asked about ","@entity.name"]}]]},{"from":"looking","to":"idle","event":"NPM_LOOKUP_GET","eventId":"evt_PWS6Q87EE7Q73GX56PD2B385RM","guard":["not",["str/startsWith","@config.registry","https://"]],"effects":[["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":"unconfigured","status":0,"error":"the registry knob must be an https:// origin"}]]},{"from":"looking","to":"looking","event":"NPM_LOOKUP_GET","eventId":"evt_PWS6Q87EE7Q73GX56PD2B385RM","guard":["str/startsWith","@config.registry","https://"],"effects":[["emit","NPM_LOOKUP_HTTP_SEND",{"key":"lookup","method":"GET","target":["str/concat","/",["str/slice","@entity.name",0,1],["str/encode-uri-component",["str/slice","@entity.name",1,["str/len","@entity.name"]]]],"headers":[{"name":"accept","value":"application/json"}],"body":["bytes/from-string",""],"stream":"none","host":["str/slice","@config.registry",8,["str/len","@config.registry"]]}]]},{"from":"looking","to":"idle","event":"NPM_LOOKUP_PACKUMENT","eventId":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","guard":["=","@payload.status",200],"effects":[["let",[["doc",["json/parse","@payload.body","LookupPackument"]]],["if",["=","@doc",null],["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":"unexpected","status":"@payload.status","error":["str/concat","the registry answered ","@entity.name"," with a packument that is not JSON"]}],["let",[["rows",["array/map",["object/keys",["object/get","@doc","versions",{}]],["fn","v",{"version":"@v","key":["let",[["parts",["str/split",["str/replace-pattern","@v","-.$",""],"."]]],["if",["!=",["array/len","@parts"],3],null,["let",[["p0",["array/nth","@parts",0]],["p1",["array/nth","@parts",1]],["p2",["array/nth","@parts",2]]],["if",["and",["validate/required","@p0"],["and",["validate/required","@p1"],["validate/required","@p2"]]],["let",[["major",["str/to-number","@p0"]],["minor",["str/to-number","@p1"]],["patch",["str/to-number","@p2"]]],["if",["or",["=","@major",null],["=","@minor",null],["=","@patch",null]],null,["+",["",1000000000000,"@major"],["",1000000,"@minor"],"@patch"]]],null]]]]}]]]],["if",["array/some","@rows",["fn","r",["=","@r.key",null]]],["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":"unexpected","status":"@payload.status","error":["str/concat","the registry listed a version of ","@entity.name"," that is not semver"]}],["emit","NPM_LOOKED",{"requestId":"@entity.requestId","name":"@entity.name","versions":["array/map",["array/sort","@rows","key","asc"],["fn","r","@r.version"]],"distTags":["object/get","@doc","dist-tags",{}],"tarballs":["object/mapValues",["object/get","@doc","versions",{}],["fn","d",["if",["validate/required","@d"],["let",[["u",["object/get",["object/get","@d","dist",{}],"tarball",""]]],["if",["str/startsWith","@u","@config.registry"],"@u",""]],""]]],"version":["object/get",["object/get","@doc","dist-tags",{}],"@entity.tag",""]}]]]]]]},{"from":"looking","to":"idle","event":"NPM_LOOKUP_PACKUMENT","eventId":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","guard":["!=","@payload.status",200],"effects":[["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":["if",["or",["=","@payload.status",401],["=","@payload.status",403]],"auth",["if",["=","@payload.status",404],"absent",["if",[">=","@payload.status",500],"unreachable","unexpected"]]],"status":"@payload.status","error":["str/concat","the registry answered ","@payload.status"," for ","@entity.name"]}]]},{"from":"looking","to":"idle","event":"NPM_LOOKUP_UNREACHABLE","eventId":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","effects":[["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":["if",["=","@payload.kind","denied"],"unconfigured","unreachable"],"status":0,"error":"@payload.error"}]]}]},"config":{"registry":{"nullable":false,"type":"url","default":"https://registry.npmjs.org","label":"Registry origin","description":"The registry origin (https://host, no trailing slash); the host must be granted in net. https://npm.pkg.github.com for GitHub Packages, whose composer sets the LookupHttp credential.","synonyms":"npm registry, github packages","tier":"infra"}},"sourceDeclaration":{"traitId":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ","fingerprint":"ce38d504ac0ef1eb70d757feb61c7d15bc726b9ad9702498f4adcfd9ba503239"}}],"pages":[{"name":"NpmLookupPage","id":"pag_0NB3VC4WAGE58215SEG09MGJTH","path":"","protocol":"boot","traits":[{"ref":"NpmLookup","refId":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},{"ref":"LookupHttp","refId":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X"},{"ref":"LookupTimeout","refId":"trt_ZXN02GETP5DB2Z57EJVBK8DF8N"}]}],"types":{"HttpHeader":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"LookupDist":[{"nullable":true,"name":"tarball","type":"string"}],"LookupPackument":[{"nullable":false,"name":"versions","type":"Map<string,LookupVersionDoc>","items":{"nullable":true,"name":"","type":"LookupVersionDoc","projectedFrom":{"type":"LookupVersionDoc"}}},{"nullable":false,"name":"dist-tags","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}],"LookupVersionDoc":[{"nullable":true,"name":"dist","type":"LookupDist","projectedFrom":{"type":"LookupDist"}}]}}],"osGrants":{"fs":[],"exec":[],"net":[{"target":"registry.npmjs.org:443","kinds":["tcp"]},{"target":".npmjs.org:443","kinds":["tcp"]},{"target":"*.pkg.github.com:443","kinds":["tcp"]}],"env":[],"stdio":[],"sys":[],"desktop":[]},"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_XWTAVVENW2AY17HC1YZB0N5121":{"id":"ent_XWTAVVENW2AY17HC1YZB0N5121","kind":"entity","bakedName":"NpmLookupAsk","curName":"NpmLookupAsk","renames":[],"owner":"workspace"},"evt_13ABNG67MA3T5DPDP21306J5M7":{"id":"evt_13ABNG67MA3T5DPDP21306J5M7","kind":"event","bakedName":"NPM_LOOKUP_HTTP_SEND","curName":"NPM_LOOKUP_HTTP_SEND","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_7XVMB5ZQ0JVG93V5D4XS4HQVGZ":{"id":"evt_7XVMB5ZQ0JVG93V5D4XS4HQVGZ","kind":"event","bakedName":"NPM_LOOKUP_REFUSED","curName":"NPM_LOOKUP_REFUSED","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_CKB8B5XM6ET37DD249J8258ZQB":{"id":"evt_CKB8B5XM6ET37DD249J8258ZQB","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_K4TY7RJ6N93AMVZDGY25CDQCQT":{"id":"evt_K4TY7RJ6N93AMVZDGY25CDQCQT","kind":"event","bakedName":"NPM_LOOKUP","curName":"NPM_LOOKUP","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_PWS6Q87EE7Q73GX56PD2B385RM":{"id":"evt_PWS6Q87EE7Q73GX56PD2B385RM","kind":"event","bakedName":"NPM_LOOKUP_GET","curName":"NPM_LOOKUP_GET","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_TXGA3EQEF3Q7HP0X836FQYM7C6":{"id":"evt_TXGA3EQEF3Q7HP0X836FQYM7C6","kind":"event","bakedName":"NPM_LOOKED","curName":"NPM_LOOKED","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC":{"id":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","kind":"event","bakedName":"NPM_LOOKUP_UNREACHABLE","curName":"NPM_LOOKUP_UNREACHABLE","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC":{"id":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","kind":"event","bakedName":"NPM_LOOKUP_PACKUMENT","curName":"NPM_LOOKUP_PACKUMENT","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"orb_H9VWCD63371HKNT9C78K9WGTJ3":{"id":"orb_H9VWCD63371HKNT9C78K9WGTJ3","kind":"orbital","bakedName":"NpmLookupOrbital","curName":"NpmLookupOrbital","renames":[],"owner":"workspace"},"pag_0NB3VC4WAGE58215SEG09MGJTH":{"id":"pag_0NB3VC4WAGE58215SEG09MGJTH","kind":"page","bakedName":"NpmLookupPage","curName":"NpmLookupPage","renames":[],"owner":"workspace"},"trt_WHD72YKS2DWH6JNPXBYCM85JXJ":{"id":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ","kind":"trait","bakedName":"NpmLookup","curName":"NpmLookup","renames":[],"owner":"workspace"},"trt_YHACMFTC3561JMDC2ZGGQ5PD8X":{"id":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X","kind":"trait","bakedName":"LookupHttp","curName":"LookupHttp","renames":[],"owner":"workspace"},"trt_ZXN02GETP5DB2Z57EJVBK8DF8N":{"id":"trt_ZXN02GETP5DB2Z57EJVBK8DF8N","kind":"trait","bakedName":"LookupTimeout","curName":"LookupTimeout","renames":[],"owner":"workspace"}}}}
1	+ {"typeContractVersion":1,"types":{"HttpHeader":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"LookupDist":[{"nullable":true,"name":"tarball","type":"string"}],"LookupPackument":[{"nullable":false,"name":"versions","type":"Map<string,LookupVersionDoc>","items":{"nullable":true,"name":"","type":"LookupVersionDoc","projectedFrom":{"type":"LookupVersionDoc"}}},{"nullable":false,"name":"dist-tags","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}],"LookupVersionDoc":[{"nullable":true,"name":"dist","type":"LookupDist","projectedFrom":{"type":"LookupDist"}}]},"name":"std-npm-lookup","version":"1.0.0","description":"std-npm-lookup — a read-only client of an npm-protocol registry (public npm or GitHub Packages; the origin is the registry knob and the bearer token is the token credential, both from config). GET only, never a write. One ask at a time; an ask during another answers NPM_LOOKUP_REFUSED npm_busy. NPM_LOOKUP { requestId, name, tag } reads the packument and answers NPM_LOOKED { requestId, name, versions (semver ascending), distTags, version } where version is the dist-tag tag points to (latest when tag is empty), empty when the package has no such tag, and tarballs maps each version to its tarball url, empty when the packument gives none or the url sits outside the registry origin; whether a version exists is its membership in versions. A reply is classified in NPM_LOOKUP_REFUSED.code: 401 and 403 are auth, 404 absent, 5xx unreachable, any other status unexpected; a transport failure is unreachable, an unset credential unconfigured.","orbitals":[{"name":"NpmLookupOrbital","id":"orb_H9VWCD63371HKNT9C78K9WGTJ3","uses":[{"from":"almadar-std/npm-lookup","as":"Spec"},{"from":"std/behaviors/std-http-client","as":"Http"},{"from":"std/behaviors/std-timeout","as":"Timeout"}],"entity":{"name":"NpmLookupAsk","id":"ent_XWTAVVENW2AY17HC1YZB0N5121","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"requestId","type":"string","default":"","description":"The caller's name for the ask in flight."},{"nullable":false,"name":"name","type":"string","default":"","description":"The package the ask in flight is about."},{"nullable":false,"name":"tag","type":"string","default":"","description":"The dist-tag whose version the ask wants; latest when empty."}]},"traits":[{"ref":"Http.traits.HttpClient","id":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X","name":"LookupHttp","config":{"host":{"type":"unknown","default":"registry.npmjs.org","wired":true},"port":{"type":"unknown","default":443,"wired":true},"tls":{"type":"unknown","default":true,"wired":true},"serverName":{"type":"unknown","default":"registry.npmjs.org","wired":true},"dynamicHost":{"type":"unknown","default":true,"wired":true},"credential":{"type":"unknown","default":"NPM_REGISTRY_TOKEN","wired":true}},"listens":[{"event":"NPM_LOOKUP_HTTP_SEND","triggers":"HTTP_SEND","source":{"kind":"trait","trait":"NpmLookup"}},{"event":"TIMED_OUT","triggers":"HTTP_CANCEL","payloadMapping":{"key":"@payload.key"},"source":{"kind":"trait","trait":"LookupTimeout"}}]},{"ref":"Timeout.traits.Timeout","id":"trt_ZXN02GETP5DB2Z57EJVBK8DF8N","name":"LookupTimeout","config":{"timeoutMs":{"type":"unknown","default":20000,"wired":true},"cancelOnDeadline":{"type":"unknown","default":false,"wired":true}},"listens":[{"event":"NPM_LOOKUP_HTTP_SEND","triggers":"START","payloadMapping":{"key":["as","@payload.key","CallKey"]},"source":{"kind":"trait","trait":"NpmLookup"}},{"event":"HTTP_REPLIED","triggers":"SUCCEEDED","payloadMapping":{"key":["as","@payload.key","CallKey"]},"source":{"kind":"trait","trait":"LookupHttp"}},{"event":"HTTP_FAILED","triggers":"FAILED","payloadMapping":{"key":["as","@payload.key","CallKey"],"error":"@payload.error"},"source":{"kind":"trait","trait":"LookupHttp"}}]},{"name":"NpmLookup","id":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ","effectRow":[{"kind":"emit","resource":"NPM_LOOKED"},{"kind":"emit","resource":"NPM_LOOKUP_GET"},{"kind":"emit","resource":"NPM_LOOKUP_HTTP_SEND"},{"kind":"emit","resource":"NPM_LOOKUP_REFUSED"},{"kind":"set","resource":"@entity.name"},{"kind":"set","resource":"@entity.requestId"},{"kind":"set","resource":"@entity.tag"}],"linkedEntity":"NpmLookupAsk","linkedEntityId":"ent_XWTAVVENW2AY17HC1YZB0N5121","entityRefIds":{"NpmLookupAsk":"ent_XWTAVVENW2AY17HC1YZB0N5121"},"emits":[{"event":"NPM_LOOKED","eventId":"evt_TXGA3EQEF3Q7HP0X836FQYM7C6","description":"The package's published versions, semver ascending, its dist-tags, the version the asked tag points to, and each version's tarball url.","synonyms":"versions list, published versions, dist-tags, latest version, version exists","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"versions","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"distTags","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"version","type":"string","required":true},{"nullable":false,"name":"tarballs","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"event":"NPM_LOOKUP_REFUSED","eventId":"evt_7XVMB5ZQ0JVG93V5D4XS4HQVGZ","description":"The lookup failed: code is auth, absent, unreachable, unexpected, unconfigured or npm_busy.","synonyms":"registry failed, 401, unauthorized, not found","tier":"primary","scope":"external","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"code","type":"string","required":true},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"error","type":"string","required":true}]},{"event":"NPM_LOOKUP_GET","eventId":"evt_PWS6Q87EE7Q73GX56PD2B385RM","description":"Internal: read the packument of the package in flight.","tier":"internal","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true}]},{"event":"NPM_LOOKUP_HTTP_SEND","eventId":"evt_13ABNG67MA3T5DPDP21306J5M7","description":"Internal: the registry read, for the HTTP client.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"method","type":"string","required":true},{"nullable":false,"name":"target","type":"string","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":false,"name":"stream","type":"string","required":true},{"nullable":false,"name":"host","type":"string"}]}],"listens":[{"event":"HTTP_REPLIED","triggers":"NPM_LOOKUP_PACKUMENT","triggersId":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","payloadMapping":{"status":"@payload.status","headers":"@payload.headers","body":["default",["bytes/to-string","@payload.body"],""]},"guard":["=","@payload.key","lookup"],"source":{"kind":"trait","trait":"LookupHttp","traitId":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X"}},{"event":"HTTP_FAILED","triggers":"NPM_LOOKUP_UNREACHABLE","triggersId":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","payloadMapping":{"error":"@payload.error","kind":"@payload.kind"},"guard":["=","@payload.key","lookup"],"source":{"kind":"trait","trait":"LookupHttp","traitId":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X"}},{"event":"TIMED_OUT","triggers":"NPM_LOOKUP_UNREACHABLE","triggersId":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","payloadMapping":{"error":["str/concat","timeout of ","@payload.timeoutMs","ms exceeded"],"kind":"timeout"},"guard":["=","@payload.key","lookup"],"source":{"kind":"trait","trait":"LookupTimeout","traitId":"trt_ZXN02GETP5DB2Z57EJVBK8DF8N"}}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"looking"}],"events":[{"key":"INIT","id":"evt_CKB8B5XM6ET37DD249J8258ZQB","name":"Initialize"},{"key":"NPM_LOOKUP","id":"evt_K4TY7RJ6N93AMVZDGY25CDQCQT","name":"Npm Lookup","description":"Read the package's published versions and dist-tags.","synonyms":"npm view, list versions, dist-tags, latest version, version exists","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"tag","type":"string"}],"listened":true},{"key":"NPM_LOOKUP_GET","id":"evt_PWS6Q87EE7Q73GX56PD2B385RM","name":"Npm Lookup Get","description":"Internal: read the packument of the package in flight.","tier":"internal","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true}]},{"key":"NPM_LOOKUP_PACKUMENT","id":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","name":"Npm Lookup Packument","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"body","type":"string","required":true}],"listened":true},{"key":"NPM_LOOKUP_UNREACHABLE","id":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","name":"Npm Lookup Unreachable","payloadSchema":[{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"kind","type":"string","required":true}],"listened":true},{"key":"NPM_LOOKED","id":"evt_TXGA3EQEF3Q7HP0X836FQYM7C6","name":"Npm Looked","description":"The package's published versions, semver ascending, its dist-tags, the version the asked tag points to, and each version's tarball url.","synonyms":"versions list, published versions, dist-tags, latest version, version exists","tier":"primary","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"versions","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"distTags","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"version","type":"string","required":true},{"nullable":false,"name":"tarballs","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"key":"NPM_LOOKUP_REFUSED","id":"evt_7XVMB5ZQ0JVG93V5D4XS4HQVGZ","name":"Npm Lookup Refused","description":"The lookup failed: code is auth, absent, unreachable, unexpected, unconfigured or npm_busy.","synonyms":"registry failed, 401, unauthorized, not found","tier":"primary","payloadSchema":[{"nullable":false,"name":"requestId","type":"string","required":true},{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"code","type":"string","required":true},{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"error","type":"string","required":true}]},{"key":"NPM_LOOKUP_HTTP_SEND","id":"evt_13ABNG67MA3T5DPDP21306J5M7","name":"Npm Lookup Http Send","description":"Internal: the registry read, for the HTTP client.","tier":"internal","payloadSchema":[{"nullable":false,"name":"key","type":"string","required":true},{"nullable":false,"name":"method","type":"string","required":true},{"nullable":false,"name":"target","type":"string","required":true},{"nullable":false,"name":"headers","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"items":{"nullable":false,"name":"","type":"HttpHeader","projectedFrom":{"type":"HttpHeader"}}},{"nullable":false,"name":"body","type":"bytes","required":true},{"nullable":false,"name":"stream","type":"string","required":true},{"nullable":false,"name":"host","type":"string"}]}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_CKB8B5XM6ET37DD249J8258ZQB"},{"from":"idle","to":"looking","event":"NPM_LOOKUP","eventId":"evt_K4TY7RJ6N93AMVZDGY25CDQCQT","effects":[["set","@entity.requestId","@payload.requestId"],["set","@entity.name","@payload.name"],["set","@entity.tag",["default","@payload.tag","latest"]],["emit","NPM_LOOKUP_GET",{"requestId":"@payload.requestId"}]]},{"from":"looking","to":"idle","event":"INIT","eventId":"evt_CKB8B5XM6ET37DD249J8258ZQB"},{"from":"looking","to":"looking","event":"NPM_LOOKUP","eventId":"evt_K4TY7RJ6N93AMVZDGY25CDQCQT","effects":[["emit","NPM_LOOKUP_REFUSED",{"requestId":"@payload.requestId","name":"@payload.name","code":"npm_busy","status":0,"error":["str/concat","the registry is being asked about ","@entity.name"]}]]},{"from":"looking","to":"idle","event":"NPM_LOOKUP_GET","eventId":"evt_PWS6Q87EE7Q73GX56PD2B385RM","guard":["not",["str/startsWith","@config.registry","https://"]],"effects":[["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":"unconfigured","status":0,"error":"the registry knob must be an https:// origin"}]]},{"from":"looking","to":"looking","event":"NPM_LOOKUP_GET","eventId":"evt_PWS6Q87EE7Q73GX56PD2B385RM","guard":["str/startsWith","@config.registry","https://"],"effects":[["emit","NPM_LOOKUP_HTTP_SEND",{"key":"lookup","method":"GET","target":["str/concat","/",["str/slice","@entity.name",0,1],["str/encode-uri-component",["str/slice","@entity.name",1,["str/len","@entity.name"]]]],"headers":[{"name":"accept","value":"application/json"}],"body":["bytes/from-string",""],"stream":"none","host":["str/slice","@config.registry",8,["str/len","@config.registry"]]}]]},{"from":"looking","to":"idle","event":"NPM_LOOKUP_PACKUMENT","eventId":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","guard":["=","@payload.status",200],"effects":[["let",[["doc",["json/parse","@payload.body","LookupPackument"]]],["if",["=","@doc",null],["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":"unexpected","status":"@payload.status","error":["str/concat","the registry answered ","@entity.name"," with a packument that is not JSON"]}],["let",[["rows",["array/map",["object/keys",["object/get","@doc","versions",{}]],["fn","v",{"version":"@v","key":["let",[["parts",["str/split",["str/replace-pattern","@v","-.$",""],"."]]],["if",["!=",["array/len","@parts"],3],null,["let",[["p0",["array/nth","@parts",0]],["p1",["array/nth","@parts",1]],["p2",["array/nth","@parts",2]]],["if",["and",["validate/required","@p0"],["and",["validate/required","@p1"],["validate/required","@p2"]]],["let",[["major",["str/to-number","@p0"]],["minor",["str/to-number","@p1"]],["patch",["str/to-number","@p2"]]],["if",["or",["=","@major",null],["=","@minor",null],["=","@patch",null]],null,["+",["",1000000000000,"@major"],["",1000000,"@minor"],"@patch"]]],null]]]]}]]]],["if",["array/some","@rows",["fn","r",["=","@r.key",null]]],["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":"unexpected","status":"@payload.status","error":["str/concat","the registry listed a version of ","@entity.name"," that is not semver"]}],["emit","NPM_LOOKED",{"requestId":"@entity.requestId","name":"@entity.name","versions":["array/map",["array/sort","@rows","key","asc"],["fn","r","@r.version"]],"distTags":["object/get","@doc","dist-tags",{}],"tarballs":["object/mapValues",["object/get","@doc","versions",{}],["fn","d",["if",["validate/required","@d"],["let",[["u",["object/get",["object/get","@d","dist",{}],"tarball",""]]],["if",["str/startsWith","@u","@config.registry"],"@u",""]],""]]],"version":["object/get",["object/get","@doc","dist-tags",{}],"@entity.tag",""]}]]]]]]},{"from":"looking","to":"idle","event":"NPM_LOOKUP_PACKUMENT","eventId":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","guard":["!=","@payload.status",200],"effects":[["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":["if",["or",["=","@payload.status",401],["=","@payload.status",403]],"auth",["if",["=","@payload.status",404],"absent",["if",[">=","@payload.status",500],"unreachable","unexpected"]]],"status":"@payload.status","error":["str/concat","the registry answered ","@payload.status"," for ","@entity.name"]}]]},{"from":"looking","to":"idle","event":"NPM_LOOKUP_UNREACHABLE","eventId":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","effects":[["emit","NPM_LOOKUP_REFUSED",{"requestId":"@entity.requestId","name":"@entity.name","code":["if",["array/includes",["denied","unsupported"],"@payload.kind"],"unconfigured","unreachable"],"status":0,"error":"@payload.error"}]]}]},"config":{"registry":{"nullable":false,"type":"url","default":"https://registry.npmjs.org","label":"Registry origin","description":"The registry origin (https://host, no trailing slash); the host must be granted in net. https://npm.pkg.github.com for GitHub Packages, whose composer sets the LookupHttp credential.","synonyms":"npm registry, github packages","tier":"infra"}},"sourceDeclaration":{"traitId":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ","fingerprint":"c7fa99eed17b2879c7c1690c1c628ecc04a79ed87896c09479c654aa3b4e66fa"}}],"pages":[{"name":"NpmLookupPage","id":"pag_0NB3VC4WAGE58215SEG09MGJTH","path":"","protocol":"boot","traits":[{"ref":"NpmLookup","refId":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},{"ref":"LookupHttp","refId":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X"},{"ref":"LookupTimeout","refId":"trt_ZXN02GETP5DB2Z57EJVBK8DF8N"}]}],"types":{"HttpHeader":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"value","type":"string","required":true}],"LookupDist":[{"nullable":true,"name":"tarball","type":"string"}],"LookupPackument":[{"nullable":false,"name":"versions","type":"Map<string,LookupVersionDoc>","items":{"nullable":true,"name":"","type":"LookupVersionDoc","projectedFrom":{"type":"LookupVersionDoc"}}},{"nullable":false,"name":"dist-tags","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}],"LookupVersionDoc":[{"nullable":true,"name":"dist","type":"LookupDist","projectedFrom":{"type":"LookupDist"}}]}}],"osGrants":{"fs":[],"exec":[],"net":[{"target":"registry.npmjs.org:443","kinds":["tcp"]},{"target":".npmjs.org:443","kinds":["tcp"]},{"target":"*.pkg.github.com:443","kinds":["tcp"]}],"env":[],"stdio":[],"sys":[],"desktop":[]},"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_XWTAVVENW2AY17HC1YZB0N5121":{"id":"ent_XWTAVVENW2AY17HC1YZB0N5121","kind":"entity","bakedName":"NpmLookupAsk","curName":"NpmLookupAsk","renames":[],"owner":"workspace"},"evt_13ABNG67MA3T5DPDP21306J5M7":{"id":"evt_13ABNG67MA3T5DPDP21306J5M7","kind":"event","bakedName":"NPM_LOOKUP_HTTP_SEND","curName":"NPM_LOOKUP_HTTP_SEND","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_7XVMB5ZQ0JVG93V5D4XS4HQVGZ":{"id":"evt_7XVMB5ZQ0JVG93V5D4XS4HQVGZ","kind":"event","bakedName":"NPM_LOOKUP_REFUSED","curName":"NPM_LOOKUP_REFUSED","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_CKB8B5XM6ET37DD249J8258ZQB":{"id":"evt_CKB8B5XM6ET37DD249J8258ZQB","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_K4TY7RJ6N93AMVZDGY25CDQCQT":{"id":"evt_K4TY7RJ6N93AMVZDGY25CDQCQT","kind":"event","bakedName":"NPM_LOOKUP","curName":"NPM_LOOKUP","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_PWS6Q87EE7Q73GX56PD2B385RM":{"id":"evt_PWS6Q87EE7Q73GX56PD2B385RM","kind":"event","bakedName":"NPM_LOOKUP_GET","curName":"NPM_LOOKUP_GET","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_TXGA3EQEF3Q7HP0X836FQYM7C6":{"id":"evt_TXGA3EQEF3Q7HP0X836FQYM7C6","kind":"event","bakedName":"NPM_LOOKED","curName":"NPM_LOOKED","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC":{"id":"evt_VPBY7XVCHRP8W5ADAT18EKZ3EC","kind":"event","bakedName":"NPM_LOOKUP_UNREACHABLE","curName":"NPM_LOOKUP_UNREACHABLE","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC":{"id":"evt_ZRXZSQHW4AY25DNGYVXQBRP1NC","kind":"event","bakedName":"NPM_LOOKUP_PACKUMENT","curName":"NPM_LOOKUP_PACKUMENT","renames":[],"owner":"workspace","parent":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ"},"orb_H9VWCD63371HKNT9C78K9WGTJ3":{"id":"orb_H9VWCD63371HKNT9C78K9WGTJ3","kind":"orbital","bakedName":"NpmLookupOrbital","curName":"NpmLookupOrbital","renames":[],"owner":"workspace"},"pag_0NB3VC4WAGE58215SEG09MGJTH":{"id":"pag_0NB3VC4WAGE58215SEG09MGJTH","kind":"page","bakedName":"NpmLookupPage","curName":"NpmLookupPage","renames":[],"owner":"workspace"},"trt_WHD72YKS2DWH6JNPXBYCM85JXJ":{"id":"trt_WHD72YKS2DWH6JNPXBYCM85JXJ","kind":"trait","bakedName":"NpmLookup","curName":"NpmLookup","renames":[],"owner":"workspace"},"trt_YHACMFTC3561JMDC2ZGGQ5PD8X":{"id":"trt_YHACMFTC3561JMDC2ZGGQ5PD8X","kind":"trait","bakedName":"LookupHttp","curName":"LookupHttp","renames":[],"owner":"workspace"},"trt_ZXN02GETP5DB2Z57EJVBK8DF8N":{"id":"trt_ZXN02GETP5DB2Z57EJVBK8DF8N","kind":"trait","bakedName":"LookupTimeout","curName":"LookupTimeout","renames":[],"owner":"workspace"}}}}