yumemi/gen/emit/lambda

Lambda の殻と deploy の表(0.16.0、yumemi-016-c4b)── server.targets に Lambda を宣言した app にだけ、back の生成物の 後に次を書く。宣言しない app(Lambda の無い app)には何も足さず、back の生成物は 1 字も変わらない。設計の正典は tech _drafts/yumemi-lambda/design.v0.md の「生成器の出力」「契約の働き 1・2・4」「新しい条文」。

file中身
src/gen/shell.lambda.mjsexport const handler = lambda(app, {build, crons, secrets, count, sockets})(back.lambda_shell)。面を持つ app は faces・statics も渡す(下)
db/framework/live_socket.sql合図の接続の表の DDL(emit/live_socket、yumemi-016-c7。SQL の既定は back の sql.mjs)
src/gen/targets.jsondeploy の台本が読む表:関数の入口、env の名(字・秘密の別、framework か app の宣言か)、cron の式の組、SQS の受け、面の入口の module と静的な file の dir、CloudFront の割り
src/gen/build.mjsback が書いた版の印の input を、生成物と ★ の中身まで含めた hash(deploy_hash)に替えて書き直す

版の印の input(C2 のゲート 2 の P1-2 の裁定):宣言の字の hash(back.back_hash)だけでは、Service の ★ や ★ の JS を 替えた待機の側を見分けられない(障害 F4)。deploy_hash は yumemi の release、app の ★(src/**/*.gleam、src/ の下の 生成の印の無い file を拡張子によらず全部、db/queries/**/*.sql)、manifest.toml(依存の版)と、この回の app の側の生成物 (src/ の下、build.mjs・targets.json を除く)を道の順に並べた sha256 の頭 12 桁。back_hash は生成物の頭の印にも 使うので替えず、この hash は health・build.mjs・targets.json の input にだけ使う。

面(yumemi-016-c8、design.v0「契約の働き 7」「契約の働き 9〜11」):app と全部の面を 1 つの関数に入れる。殻は host と path で 振り分ける(<prefix> と media.path で始まる path は app、それ以外は host の入口の面 ── target/faces.mjs)。面の入口は生成の <面>/src/gen/shell.mjs、FaceEntry(face:, module:) を宣言した面は ★ の <面の dir>/<module>.mjs。束の形:殻は app の build (<app>/build/dev/javascript/<app>/gen/)から面の build(<面の dir>/build/dev/javascript/<面の package>/gen/shell.mjs)か ★ の module を相対の道で import する ── 面ごとに gleam build してから殻を束ねれば、面の依存は面の build から引かれる。静的な file は 面の priv/static を関数の束の static/<面>/ に置き(targets.json の statics)、殻は生成器が書く表(道 → content-type と hash)にある道だけを返す。束ねた後に書き替わる _yumemi/client.mjs の hash は空で、殻が byte から引く。面を持たない app の 殻は C4b のまま。

★ の警告(条でない、exit 0):★ の JS が Workers の部品に触れていれば 1 行(gear.workers_parts の走査)。★ は利用者の 責任なので止めない。

Types

1 行:名、置き場(vars は Lambda の env の字、secret は Secrets Manager)、誰が読むか(framework か app)、出どころ、 注(無ければ “”)。

pub type EnvRow {
  EnvRow(
    name: String,
    kind: String,
    by: String,
    source: String,
    note: String,
  )
}

Constructors

  • EnvRow(
      name: String,
      kind: String,
      by: String,
      source: String,
      note: String,
    )

Lambda の 1 つの関数に入れる面(yumemi-016-c8)。name は面(= 入口)の名、dir は app の dir から面の package への道、 package は面の gleam.toml の名、statics はこの回の面の priv/static の file(static_files)

pub type Face {
  Face(
    name: String,
    dir: String,
    package: String,
    statics: List(#(String, String)),
  )
}

Constructors

  • Face(
      name: String,
      dir: String,
      package: String,
      statics: List(#(String, String)),
    )

Values

pub fn app_label(dir: String) -> String

警告の頭に出す app の名(道を解いてから最後の名)

pub fn content_type(path: String) -> String

静的な file の content-type(拡張子から。知らない拡張子は application/octet-stream)。字の形には charset=utf-8 を付ける

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

(Workers の式, Scheduler の式, 出どころ)。server.cron の式(写せない式は第 59 条が止めるので外す)と、行ごとの時刻の 起床の毎分の式(wakes を宣言した app だけ、* * * * *、yumemi-016-b5)と、framework の数える口の集計の式(器 Store に 数える面のある app だけ、0 1 * * *)。同じ式は先の行だけを残す(server.cron に毎分の式があれば wakes の行を重ねない)。

pub fn deploy_hash(
  units: List(source.Unit),
  stars: List(#(String, String)),
  app_queries: List(#(String, String)),
  generated: List(types.File),
) -> String

health・build.mjs・targets.json の input。yumemi の release、★(Gleam・src/ の下の生成の印の無い file・SQL)と manifest.toml、src/ の下の生成物(build.mjs・targets.json を除く)を道の順に「印 道\n中身」で並べた sha256 の頭 12 桁。 ★ の file のうち、この回に生成器が書く道(印の無い targets.json ほか)は ★ でなく生成物の側で数える。

pub fn emit(
  app: model.App,
  units: List(source.Unit),
  hashes: hash.Hashes,
  app_queries: List(#(String, String)),
  generated: List(types.File),
  back_files: List(types.File),
  stars: List(#(String, String)),
  label: String,
  faces: List(Face),
) -> #(List(types.File), List(stop.Note))

back の生成物(back_files)に Lambda の殻を足す。Lambda を宣言しない app は back_files をそのまま返す。 generated はこの回の back の外の生成物(面のものも混じる ── src/ の下だけを hash に入れる)、stars は ★ の file (star_scripts)、label は警告の頭に出す app の名(app_label)。

pub fn env_table(app: model.App) -> List(EnvRow)

app の宣言が読む名(第 62 条と同じ表)と、framework が決め打ちで読む名。同じ名は先の行(app の宣言)を残す。

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

Secrets Manager から読む名(env_table の秘密)

pub fn star_notes(
  stars: List(#(String, String)),
  label: String,
) -> List(stop.Note)

★ の JS(src/ の下の .mjs・.js・.cjs)が Workers の部品に触れていれば 1 行(exit 0)。最初の 1 か所を 「字(src/ からの道:行)」で名指し、残りを数える。

pub fn star_scripts(app_dir: String) -> List(#(String, String))

★ の file(app の dir からの道, 中身)。src/ の下の生成の印の無い file(.gleam を除く、JS は字・ほかは sha256:<hex>)と manifest.toml。

pub fn static_files(face_dir: String) -> List(#(String, String))

面の静的な file(<面の dir>/priv/static の下、/ から始まる道, byte の sha256 の頭 12 桁)

pub const viewer_request: String

viewer-request の CloudFront Function(cloudfront-js-2.0)。viewer の Host を x-forwarded-host に毎回上書きする (viewer が送った x-forwarded-host は捨てる)。PoC P5 で確かめた形

✨ Search Document