yumemi/gen/emit/blobs
媒体の置き場と認可(0.16.0、yumemi-016-b11a)── pub const blobs: server.Blobs を宣言した app にだけ出す(宣言しない app の
生成物は 1 字も変わらない)。設計の正典は tech _drafts/yumemi-lambda/design.v0.md の「B11 媒体の一生」「契約の働き 9〜11」。
db/framework/blob.sql── 上げた媒体の記録の表の DDL。生成器が ▲ として吐き、app の DB に当てるのは DDL の便(鷹野専管)- SQL の既定
framework/blob_{attach,pending,record,sweep}──sql.mjsに足す(app に ★ があれば勝つ)。掃除の時間 (orphan_hours)は runtime が境の時刻にして渡す - 外れた媒体(B11b):
reclaim: Trueを宣言した app だけ、Entity の欄の型(Blob・List・Option・1 構成子の record・ alias、入れ子も)から「key がどこかの行に在る」述語を組み(text の列は=、jsonb の列と text の列の record は型紙の@>、text[]はANY)、framework/blob_detach(付いた行のうち参照の無い行の印を戻す)とframework/blob_sweepの「参照の無い」に使う。reclaim: False・Blobの欄の無い app は述語もblob_detachも出さない(B11a の掃除のまま ── ★ の表の参照を消さない) http_runtime.mjsのblobs(置き場の env の名・記録・時間・認可の表)── runtime はyumemi/server/blobs.mjsとhttp.mjs- env の表(
targets.json)── 置き場の名(Workers は R2 の binding、Lambda は bucket の名)・endpoint・region・鍵
第 73 条 媒体の置き場(exit 4):orphan_hours が 1 未満、access の kind が [a-z][a-z0-9_]* でない・2 つ以上、
service が無い・読みの Service でない・allow が System だけ・どの入口にも口を持たない・Args が無い、fields が空・
重なる・Service の Out の欄に無い(Out が欄を持つ 1 構成子の record でない)・型が Blob・List(Blob)・
Option(Blob) でない。置き場の名の形と Lambda の名との重なりは第 62 条(env の名)が見る。
第 83 条 媒体の変換と縁のキャッシュ(exit 4、B11c):edge を宣言したのに blobs が無い、images を書いたのに media の
variant が無い、images・cache の env の名が [A-Z][A-Z0-9_]* でない、cache の seconds が 60〜2592000(30 日)の外。
条でない警告の行(exit 0):targets に Lambda を持つ app の edge は、Lambda で落とすもの(変換、関数の中の縁のキャッシュ)を
1 行で出す(決まったこと「落としてよいのは見た目と速さだけ、落としたものは health と警告の行に出す」)。
第 78 条 媒体の戻し(exit 4、B11b r2):reclaim: True で、Entity の欄の Blob の在る所を述語にできない ── 構成子が
2 つ以上・欄に名の無い・opaque・型引数のある型や組の中、自分を欄に持つ record の中、text の列に key の字でも JSON の
object でもなく入る(alias の List は SQL の配列の字)、storage の Split の列の奥・Text、Durable Object の器の Entity。
Types
Entity の Blob の在る所 1 つ(B11b):表(schema 付き)・列・列の中の形
pub type BlobColumn {
BlobColumn(table: String, column: String, shape: ColumnShape)
}
Constructors
-
BlobColumn(table: String, column: String, shape: ColumnShape)
pub type ColumnShape {
Single
Json(Template)
TextJson(Template)
SqlArray
}
Constructors
-
SingleBlob・Option(Blob)・Blobの alias(text の列)、storageのSplitColumnsで record の欄から割った列 -
Json(Template)jsonb の列の中の型紙(
List(Blob)は[key]、record は{"<欄>": …})。@>で key を探す(B11b r2) -
TextJson(Template)text の列に入った record(driver が object を JSON の字にする ── 同じ module の record の欄は text の列)。
::jsonbにして型紙の@>で探す -
SqlArrayList(Blob)をstorageで SQL の配列(text[])にした列
Values
pub fn columns(
app: model.App,
units: List(source.Unit),
) -> #(List(BlobColumn), List(String))
Entity の Blob の在る所(宣言の順)と、述語を組めない欄(第 78 条の字)。Entity の型を source から辿る ── record
(1 構成子・欄が全部名付き、別 module も)・その List・Option・入れ子・alias の中の Blob を拾う。表に列を持たない
Derived の Property は見ない
pub fn env_rows(
app: model.App,
) -> List(#(String, String, String))
env の表の行(出どころ, 名, “vars” か “secret”)
pub fn files(app: model.App) -> List(types.File)
pub fn live_sql(
app: model.App,
units: List(source.Unit),
) -> option.Option(String)
「b.key がどこかの Entity の行の Blob の欄に在る」の SQL。reclaim: True を宣言し、欄が在り、第 78 条に当たらない
app だけ(それ以外は None ── 戻しを出さず、掃除は付かない媒体だけ)。b は framework.blob の別名
pub fn notes(
app: model.App,
units: List(source.Unit),
) -> List(stop.Note)
第 73・78・83 条と、Lambda で落とすものの警告の行(B11c)
pub fn queries(
app: model.App,
units: List(source.Unit),
) -> List(#(String, String))
pub fn spec_js(
app: model.App,
units: List(source.Unit),
) -> String
http_runtime.mjs の blobs の定義(宣言の無い app は空の字)