yumemi/gen/emit/system
アプリの間の読みの入口(B10、server.systems)と呼ぶ側の口(SystemCall)の生成(0.16.0、yumemi-016-c9)。字だけを返し、
置き場は back(Workers の殻 shell.mjs・Lambda の殻 shell.lambda.mjs・connector の .gleam)と runtime
(connector の表)が持つ。runtime の中身は framework の server/system.mjs。設計の正典は tech
_drafts/yumemi-lambda/design.v0.md の「B10」「契約の働き 7」。
| 宣言 | Workers | Lambda |
|---|---|---|
systems の入口 1 つ | export const <Pascal>=systemEntrypoint(..)(WorkerEntrypoint、口は <口>(input))と POST <prefix>/_yumemi/system/<名>/<口>(署名付き) | POST <prefix>/_yumemi/system/<名>/<口>(署名付き) |
AppSystem(Lambda を宣言した app) | 今の export const AppSystem と POST <prefix>/_yumemi/system/app/<口>(署名付き) | POST <prefix>/_yumemi/system/app/<口>(署名付き) |
connector の SystemCall | service binding <SYSTEM> の RPC(無ければ下と同じ) | env <SYSTEM>_URL へ署名付きの POST |
鍵は入口ごと(r2、ゲート 2 の P0-1):AppSystem の HTTP は YUMEMI_APP_SYSTEM_KEY、入口 <名> は <NAME>_SYSTEM_KEY(と
それぞれの _PREVIOUS)。呼ぶ側の SystemCall(system: "<名>") は <NAME>_SYSTEM_KEY で署名する。
やり直しの断り(yumemi-016-c10):署名は v2(要求ごとの nonce を含む)。殻の systemHttp に database・observe・run を
渡し、署名の合った要求の nonce を表 framework.system_nonce に入れる(DDL と SQL の既定は emit/system_nonce、出すのは
この口を出す app だけ)。
宣言しない app(systems も SystemCall も Lambda も無い)の生成物は 1 字も変わらない(AppSystem の HTTP の口は、
Lambda を宣言した app にだけ足す。Workers の殻にも足すのは、片方の指し先だけを Lambda に切り替えても呼べるようにするため)。
第 69 条 アプリの間の読みの入口(exit 4):入口の名・口の名が [a-z][a-z0-9_]* でない、入口の名が app(AppSystem の
HTTP の名)、同じ入口の名・同じ入口の中の同じ口の名が 2 つ以上、入口の class の名(名の PascalCase)が AppSystem・
YumemiLive・durable_objects の class・ほかの入口の class と重なる、口の名が WorkerEntrypoint の予約の名、口の無い入口、
口の Service が無い・読みの Service でない・allow が System の句だけでない、返す欄が無い・重なる・Service の Out の欄に
無い(Out が欄を持つ 1 構成子の record でない)。SystemCall の system・method が [a-z][a-z0-9_]* でない・system が
app・method が WorkerEntrypoint の予約の名(r3)。入口と SystemCall の名から作る env と binding の名(<NAME>・
<NAME>_URL・<NAME>_SYSTEM_KEY・その _PREVIOUS)が framework の名(YUMEMI_・AWS_・LAMBDA_ の頭、DATABASE_URL・
OUTBOX ほか)と重なる・入口と SystemCall の間で重なる・app の他の宣言が読む env・binding の名(blobs の store、KEK・seals、
<ENTRY>_HOST ほか、targets.declared_env_rows)と重なる(r3)。
Values
pub const app_key_note: String
AppSystem の鍵の行の注(r3 ── 名は全部の app で同じ YUMEMI_APP_SYSTEM_KEY だが、値は揃えない。揃えると、その値を
確かめに持つ app のどれでも他の app の app/session を発行できる)
pub fn call_key(system: String, method: String) -> String
runtime の ctx.call が引く connector の表の鍵(system:<入口>/<口>)
pub fn calls(app: model.App) -> List(#(String, String, String))
connector の SystemCall の口(入口の名, 口の名, connector の名)。重ねない
pub fn env_rows(
app: model.App,
) -> List(#(String, String, String))
入口と SystemCall が読む env の (出どころ, 名, “vars” か “secret”)。受ける側は入口ごとの鍵と前の鍵、呼ぶ側は呼ぶ先の
入口ごとの <SYSTEM>_URL と鍵(重ねない)
pub fn lambda_text(
app: model.App,
mcp: Bool,
) -> #(String, String)
Lambda の殻の import と口の組み(AppSystem は宣言に依らず、B10 の入口は宣言した app だけ)。mcp は MCP の入口を持つ app
pub fn notes(
app: model.App,
units: List(source.Unit),
declared: List(#(String, String, String)),
) -> List(stop.Note)
第 69 条。宣言の無い app は 1 行も出さない。declared は app の他の宣言が読む env・binding の (出どころ, 名, 読み方)
(targets.declared_env_rows。targets がこの module を import するので引数で受ける)
pub fn port_text(
name: String,
system: String,
method: String,
) -> String
connector の .gleam の口 1 つ(call は operations の call)
pub fn runtime_text(app: model.App) -> #(String, String, String)
runtime の connector の表の行('system:<入口>/<口>':systemCall(..))と名の表の行、import。SystemCall の無い app は空
pub fn workers_exports(app: model.App) -> String
Workers の殻の export(入口ごとの WorkerEntrypoint)。入口を宣言しない app は空
pub fn workers_text(
app: model.App,
mcp: Bool,
with_app: Bool,
) -> #(String, String, String, String)
Workers の殻の字(worker.mjs の import の行に足す名、その後の import、observe の後に置く組み、handlers に足す欄)。
B10 の入口は宣言した app、AppSystem の HTTP は Lambda を宣言した app(with_app)だけ。どちらも無い app は空