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」。

宣言WorkersLambda
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 の SystemCallservice 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: String

AppSystem の HTTP の鍵の名(server/system.mjs の appKeyName)

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 declared(app: model.App) -> Bool

入口を宣言した app か

pub fn env_rows(
  app: model.App,
) -> List(#(String, String, String))

入口と SystemCall が読む env の (出どころ, 名, “vars” か “secret”)。受ける側は入口ごとの鍵と前の鍵、呼ぶ側は呼ぶ先の 入口ごとの <SYSTEM>_URL と鍵(重ねない)

pub fn key_name(system: String) -> String

入口の鍵の名(server/system.mjs の keyNames)

pub fn key_names(app: model.App) -> List(String)

鍵の行の名(注 key_note を添える)

pub const key_note: String

鍵の行の注(targets.json の env の表)

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 は空

✨ Search Document