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.mjs | export 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.json | deploy の台本が読む表:関数の入口、env の名(字・秘密の別、framework か app の宣言か)、cron の式の組、SQS の受け、面の入口の module と静的な file の dir、CloudFront の割り |
src/gen/build.mjs | back が書いた版の印の 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 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 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 で確かめた形