yumemi/server
back の宣言 ── 生成器が app の src/server.gleam の const を読み、src/gen/registry.mjs /
http_runtime.mjs / shell.mjs / queue_runtime.mjs / cron_runtime.mjs を書く(0.11.1、WGy)。
置く const は下のとおり。どれも無くてよい(無ければ空の表)。
pub const routes: List(Route)── Service の (method, path) の上書き。導出規則(entry の prefix と Entity / Args の型)と同じ行は書かない。公開の URL(REST v1、鍵の発行)は導出に寄せず、ここで固定するpub const aliases: List(Alias)── 同じ Service(または attached の口)の 2 本目の口(REST v1 の別名)pub const attached: List(Attached)── Service でない HTTP の口(session・blob・media・socket など)。 面のapi.gleamのattached表も、ここから書くpub const cron: List(Cron)── 式と、その式で回す仕事pub const durable_objects: List(DurableObject)── class 名と、実装を持つ ★ の adapter。Lambdaを宣言した app は"<gear>:<道>"(gear の Workers の module)を指す行だけ書ける(第 60 条、0.16.0)pub const hooks: List(Hook)── 宣言から導けない業務の行の口。生成物が import する ★ は、ここに名を 書いたものだけpub const reads: List(ManualRead)── 手書きの SQL で引く読み。生成器は型付きの口と runtime の振り分けを書き、 SQL と行の写し(hook)は ★pub const roots: List(RootShape)── root の導出(allow の Entity と Args の key の型)と違う Service の rootpub const storage: List(Storage)── Entity の器と列の写像。導出(Neon のapp.<module>、Property 名 = 列名、payload の無い sum は text、record と List は jsonb)と違う Entity の Property だけを書くpub const attached_roles: List(AttachedRole)── 機関を framework が持つ attached の口の役(session・ browser の申告・path の残りを取る口)。framework の JS は app の口の名を知らず、ここから受けるpub const browser: BrowserCookie── browser の署名 cookie(ユニークの印と申告)の名・鍵の binding・期間と申告の種類pub const consents: List(String)── 同意の種類の名(要件と門のConsented/ConsentedForの綴りを生成器が止める)pub const media: Media── 画像の variant の表。生成器が面ごとにsrc/gen/media.gleamを書くpub const subject_free: List(String)── 入口の主体の集合(Subjects([..]))に session の主体が入っていなくても 通す Service の名。主体を切り替える前に読む口(店の面の/switchが並べる、party の持つ店の主体)だけを書く (gate-1 r2。framework の JS は Service の名を知らない)
0.16.0 の語(指し先と B1〜B15)の宣言の型は、下の「0.16.0」の節に先に置く(便 D0)。生成と runtime は語ごとの便で入り、 まだ入っていない語を宣言したアプリは、生成器が exit 1(「生成器の不足:0.16.0 の便 <名> で入る」)で止める。
pub const targets: List(Target)── 指し先。無ければ[Workers]と読み、生成物は 0.15.0 と同じpub const verbs: List(ManualVerb)── 手書きの SQL の verb の口(B2)。readsにはRead(B1)も書けるpub const wakes: List(Wake)── 行ごとの時刻の起床(B5)pub const quotas: List(Quota)── 人ごと・暦日ごとの回数の天井(B6)pub const before: List(Before)── 入口の前段(B7)pub const challenge: Challenge── 人の確かめの業者(B8)。要件はyumemi/requireのChallengedpub const systems: List(System)── アプリの間の読みの入口(B10)。呼ぶ側は connector のSystemCallpub const blobs: Blobs── 媒体の置き場と認可(B11)pub const edge: Edge── 媒体の variant の変換と縁のキャッシュ(B11c)。blobsとmediaの上に置くpub const seals: List(Seal)──Sealedの持ち主ごとの鍵(B12)。鍵の替えは cron のRekeypub const failures: List(Failure)── 失敗の符号と status、制約名と符号(B13)pub const intake: List(Intake)── 入力の形と入口の検査(B15)
framework の JS が app に求めるもの(npm の依存と db/queries/framework/** の SQL)は README を見よ。
Service は名(module の名、article_publish)で指す ── Service の値は型引数が Service ごとに違い、
1 つの List に並ばないため。名が Service に無ければ生成器が exit 4 で名指しする。
path の変数は :name(registry の綴り)。
Types
pub type Alias {
Alias(
name: String,
service: String,
method: Method,
path: String,
credential: Credential,
external_id: Bool,
)
AttachedAlias(
name: String,
attached: String,
method: Method,
path: String,
credential: Credential,
who: Who,
)
}
Constructors
-
Alias( name: String, service: String, method: Method, path: String, credential: Credential, external_id: Bool, )Service の 2 本目の口。
external_id: Trueは path の:external_idを店の外部 id として 引き直し、Args のidに入れる。 -
AttachedAlias( name: String, attached: String, method: Method, path: String, credential: Credential, who: Who, )attached の口の 2 本目。
attached の口のうち、機関を framework の JS(yumemi/server/http.mjs)が持つものの役(WGy r4、0.12)。
framework は app の口の名を知らない ── どの attached の名がどの役かを app がここで渡す
(pub const attached_roles: List(AttachedRole))。1 つの口に役を 2 つ以上書いてよい。
名が attached に無ければ生成器が exit 4 で名指しする。申告の kind が browser.declarations に無ければ exit 4。
pub type AttachedRole {
Declare(attached: String, kind: String)
NeedsDeclared(attached: String, kind: String)
ReadSession(attached: String)
SwitchSubject(attached: String)
TailPath(attached: String)
}
Constructors
-
Declare(attached: String, kind: String)申告
kindを browser の署名 cookie に焼く(印が無ければ作る)。行はframework/browserの SQL(引数に kind) -
NeedsDeclared(attached: String, kind: String)申告
kindが無ければ 403{"code": "declaration_missing", "declaration": kind}で閉じる -
ReadSession(attached: String)session の中身(party・主体・同意
consents・申告declared)を返す -
SwitchSubject(attached: String)session の主体を切り替える。行は
framework/session_subject_staffの SQL -
TailPath(attached: String)path の最後の穴(
:key)が/を含む残り全部を取り、GET と HEAD で受ける
入口の前段(B7、pub const before: List(Before))。dispatch の前に宣言の順で呼ぶ ★ の関数
(request, x) => Promise<Request|Response>。hook は hooks の名(★ の関数の置き場は hooks が持つ)
pub type Before {
Before(hook: String)
}
Constructors
-
Before(hook: String)
対象の種類 1 つの媒体の読み(B11a、D0 のゲート 2 の P1-1 の裁定)。kind は媒体の読みの URL
<入口の prefix>/_yumemi/media/<kind>/<id>/<key> の種類の字、service は :id の行を閲覧者として読む読みの Service
(Args の 1 つ目が id)、fields は key を持つ行の欄(Service の Out の欄の名、Blob か List(Blob) か Option(Blob))。
行が読めて、欄のどれかに要求の key が在るときだけ配る。読めなければ 404(存在を漏らさない)。service は媒体の読みの入口に
口の在る Service で、その門(入口・相・requires の申告と同意・allow)は直に呼ぶときと同じに当たる(403 は 403 のまま)
pub type BlobAccess {
BlobAccess(kind: String, service: String, fields: List(String))
}
Constructors
-
BlobAccess(kind: String, service: String, fields: List(String))
媒体の置き場と認可(B11、pub const blobs: Blobs)。store は置き場の env の名(Workers は R2 の binding、Lambda は
S3 の bucket の名)、record_party は上げた party を記録するか(記録すれば、媒体を Blob の Args で行に付けられるのは
上げた party と同じ party の書きだけ)、orphan_hours は行に付かない媒体を消すまでの時間(過ぎた媒体は付けられない)、
reclaim は行から外れた媒体を戻して消すか(B11b r2)、access は対象ごとの認可の読み。
reclaim: True は「付いた媒体は Entity の Blob の欄(record・List・Option・alias の中も)にだけ在る」の宣言で、
どの Entity の行にも key の無い付いた媒体の印を戻し、orphan_hours の後に消す。★ の表だけが指す媒体も消えるので、
そういう表を持つ app は False(付いた媒体は消さない)
pub type Blobs {
Blobs(
store: String,
record_party: Bool,
orphan_hours: Int,
reclaim: Bool,
access: List(BlobAccess),
)
}
Constructors
-
Blobs( store: String, record_party: Bool, orphan_hours: Int, reclaim: Bool, access: List(BlobAccess), )
browser の署名 cookie(pub const browser: BrowserCookie、0.12)。cookie は cookie の名、key_binding は HMAC の鍵を
持つ env の binding(.get() で文字列を返す Secret Store)、max_age_days は cookie の Max-Age(印の寿命)。
payload の id(32 桁の hex)がユニークの印で、申告は印の上の欄(declarations)になる。宣言が無ければ印も申告も無い。
pub type BrowserCookie {
BrowserCookie(
cookie: String,
key_binding: String,
max_age_days: Int,
declarations: List(Declaration),
)
}
Constructors
-
BrowserCookie( cookie: String, key_binding: String, max_age_days: Int, declarations: List(Declaration), )
人の確かめの業者(B8、pub const challenge: Challenge)。要件は yumemi/require の Challenged(action)。
field は要求の本文で token を運ぶ欄の名、secret は siteverify の鍵を持つ秘密の env の名、provider は業者を選ぶ
env の名(値は turnstile / recaptcha)。業者を宣言でなく env で選ぶのは、指し先ごとに値を替えるため(第 62 条)
pub type Challenge {
Challenge(field: String, secret: String, provider: String)
}
Constructors
-
Challenge(field: String, secret: String, provider: String)
口が受ける媒体。entry の Credential と同じ 2 値(ApiKey の per_minute は entry が持つ)。
pub type Credential {
Session
ApiKey
}
Constructors
-
Session -
ApiKey
申告の種類。kind は app が名付ける([a-z][a-z0-9_]*)、claim は payload で申告の時刻を持つ欄の名、
max_age_days は申告の有効期間(cookie の max_age_days 以下)。cookie が有効でも申告が期間より古ければ「申告なし」。
pub type Declaration {
Declaration(kind: String, claim: String, max_age_days: Int)
ConsentDeclaration(
kind: String,
claim: String,
max_age_days: Int,
consent: String,
)
}
Constructors
-
Declaration(kind: String, claim: String, max_age_days: Int) -
ConsentDeclaration( kind: String, claim: String, max_age_days: Int, consent: String, )session の主体が同意
consent(consentsの名)を持てば、申告kindを満たしたと読み、browser の cookie に申告を 焼き直す(B9、0.16.0)。叩き台はDeclarationにconsent: Option(String)を足す形だが、欄を足すと今のDeclaration(kind:, claim:, max_age_days:)が型の誤りで落ちるので、構成子を分けてconsentを必須の字にした
pub type DurableObject {
DurableObject(
class: String,
module: String,
adapter: String,
methods: List(String),
)
}
Constructors
-
DurableObject( class: String, module: String, adapter: String, methods: List(String), )classは wrangler の class 名、moduleはsrc/からの ★ の道(user_do)、adapterは その module が export する class、methodsは DO の RPC として外へ出す method の名。
媒体の variant の変換と縁のキャッシュ(B11c、pub const edge: Edge)。blobs の媒体の読みの口
(<入口の prefix>/_yumemi/media/<kind>/<id>/<key>)に ?v=<name>(media の variant の名)を足すと variant を配る。
images は Workers の Images の binding の名で、在れば無い variant をその場で WebP に変換して置き場の <key>/<name> に置く。
Lambda は変換しない(変換済みの <key>/<name> だけを配り、無ければ原本を配る)。cache は公開の媒体の縁のキャッシュ。
見た目と速さのための宣言で、認可は変えない(公開でない媒体は縁に置かない)
pub type Edge {
Edge(
images: option.Option(String),
cache: option.Option(EdgeCache),
)
}
Constructors
-
Edge( images: option.Option(String), cache: option.Option(EdgeCache), )
縁のキャッシュ(B11c)。env は purge の設定の env の名の頭、seconds は縁に残す長さ(秒)。Workers は Cache API と
Cloudflare の purge(<env>_ZONE の zone の ID と秘密 <env>_TOKEN の API token)、Lambda は CloudFront の
キャッシュ(応答の s-maxage)と CreateInvalidation(<env>_DISTRIBUTION の distribution の ID、実行ロールの鍵)。
purge の設定が無い指し先は縁に置かない(消せない物は置かない)。縁に置くのは、session も印も無い閲覧者が読めた媒体だけ
pub type EdgeCache {
EdgeCache(env: String, seconds: Int)
}
Constructors
-
EdgeCache(env: String, seconds: Int)
pub type FaceEntry {
FaceEntry(face: String, module: String)
}
Constructors
-
FaceEntry(face: String, module: String)面の入口を ★ の module にする(無ければ生成の
src/gen/shell.mjs)。faceは面(= 入口)の名、moduleは面の dir からの道(拡張子無し、.mjsの file)。面のsrc/の.mjsは第 5・6 条が止めるのでsrc/の外に置く(例:musearch のwww/worker/entry.mjsはmodule: "worker/entry")。module は Workers の main と同じ形 ──defaultのfetch(request, env, ctx)か、名前のfetchを export する(yumemi-016-c8)
失敗の符号と status(B13、pub const failures: List(Failure))。
pub type Failure {
Status(code: String, status: Int)
ServiceStatus(service: String, code: String, status: Int)
Constraint(name: String, code: String)
}
Constructors
-
Status(code: String, status: Int)符号
codeの失敗を HTTP の statusstatusで返す -
ServiceStatus(service: String, code: String, status: Int)Service
serviceの符号codeの失敗だけを statusstatusで返す。同じ符号のStatusより先に効く -
Constraint(name: String, code: String)DB の制約名
nameの違反を符号codeの失敗に写す
pub type Hook {
Hook(name: String, module: String)
}
Constructors
-
Hook(name: String, module: String)moduleはsrc/からの ★ の道(hooks)、nameはその module が export する関数の名。
入力の形と入口の検査(B15、pub const intake: List(Intake))。叩き台は置き場を決めていない。3 つとも「入口が Service の
前にする扱いの上書き」なので 1 つの const に並べた
pub type Intake {
EmptyIsNone(service: String)
Idempotent(service: String, enabled: Bool)
Origins(entry: String, env: String)
}
Constructors
-
EmptyIsNone(service: String)Service
serviceの Args のOption(_)の欄で、空の字''をNoneと読む(B15a) -
Idempotent(service: String, enabled: Bool)Service
serviceの冪等の記録を外す(enabled: False、B15b)。Trueは既定と同じ -
Origins(entry: String, env: String)入口
entry(entry.entriesの名)が受ける origin の表を envenvから読む(B15b)
pub type Job {
EachDue(service: String, query: String)
Hooked(service: String, hook: String)
Windowed(service: String, windows: List(Window))
Rekey(seal: String)
}
Constructors
-
EachDue(service: String, query: String)列挙の読み(
<service>/<query>の SQL、穴は$1= 起動時刻)の行ごとに Service を 1 回ずつ呼ぶ。 行のidを Args の 1 つ目へ入れる。CAS に負けた行は飛ばして次へ。 -
Hooked(service: String, hook: String)hook が Args を作り、Service を 1 回呼ぶ(期間の計算など、宣言から導けない行)。
-
Windowed(service: String, windows: List(Window))起床の予定の時刻から窓を計算して Args の欄に入れ、Service を 1 回呼ぶ(B14、0.16.0)。
Hookedの期間の計算を宣言にしたもの。 叩き台のwindow: Window1 つをwindows: List(Window)にした ── musearch の rollup は 1 つの Args に前日・前月・ 保持の境の 3 欄を入れるので、窓が欄ごとに要る。欄の名はWindowのargが持つ -
Rekey(seal: String)Sealの前の鍵で包んだ DEK を今の鍵で包み直す(B12b、0.16.0)。sealはsealsのname
手書きの SQL(db/queries/<service>/<query>.sql、★)で引く読み(WGy r3)。生成器は
gen/reads/<service>.gleam の型付きの口(<query>(<args>, then:))と runtime の振り分けを書き、
行の写しは hook(hooks に宣言した ★ の関数)が持つ。型は Gleam の綴り(List(course.Course))、
imports はその綴りが要る import の行の中身(entity/course)。引数が 2 つ以上なら口は組で渡す。
pub type ManualRead {
ManualRead(
service: String,
query: String,
args: List(#(String, String)),
returns: String,
imports: List(String),
hook: String,
)
Read(
service: String,
query: String,
args: List(#(String, String)),
returns: String,
imports: List(String),
)
}
Constructors
-
ManualRead( service: String, query: String, args: List(#(String, String)), returns: String, imports: List(String), hook: String, ) -
Read( service: String, query: String, args: List(#(String, String)), returns: String, imports: List(String), )行の写しを生成器が
returnsの型から書く読み(B1、0.16.0)。ManualReadからhookを外した形で、同じreadsに並ぶ ── 写せない欄に当たったらManualReadに戻す道を 1 行の書き替えで残すため、別の const にしない
手書きの SQL の verb の口(B2、0.16.0、pub const verbs: List(ManualVerb))。SQL は db/queries/<service>/<query>.sql(★)。
生成器が引数の並べ替え・値型の写し・at と新しい id の差し込みを書き、src/gen/verbs/<service>.gleam に型付きの口 <name> を出す。
args は #(名, 型) の並びで、型に "yumemi.At"・"yumemi.NewKey" を書けば runtime が入れる。lock: True の文は
transaction の先頭に置く(1 つの Service に 2 つは exit 4)。checks は同じ transaction に積む確かめの文の query の名。
確かめは口の文の直後に積み、0 行か 1 列目が偽・NULL の行があれば transaction ごと取り消して業務の失敗 <名> にする
(B2b)。型には Key(<Entity>)(生成の key の在る Entity)と List(<表の型>)(jsonb の穴)も書ける。2 つ以上の
Service が呼ぶ口は 1 つの Service に宣言し、他の Service は gen/verbs/<service> を import して呼ぶ。
const の名を manual_verbs にしないのは、ER の外の module の manual_verbs(手書きの verb の名の表)と取り違えるため
pub type ManualVerb {
ManualVerb(
service: String,
name: String,
query: String,
args: List(#(String, String)),
lock: Bool,
checks: List(String),
)
}
Constructors
-
ManualVerb( service: String, name: String, query: String, args: List(#(String, String)), lock: Bool, checks: List(String), )
画像の variant の表(pub const media: Media、0.12)。path は配る口の頭(/media)、theme_background は頁の色の
地の画像に使う variant の名。生成器は面ごとに src/gen/media.gleam(Variant の enum と url)を書く。
pub type Media {
Media(
path: String,
variants: List(Variant),
theme_background: String,
)
}
Constructors
-
Media( path: String, variants: List(Variant), theme_background: String, )
pub type Port {
Call(name: String, op: String)
Send(name: String, op: String)
Enqueue(name: String, kind: String)
Fetch(name: String, module: String, js: String, arity: Int)
Pure(name: String, module: String, js: String, arity: Int)
SystemCall(name: String, system: String, method: String)
}
Constructors
-
Call(name: String, op: String)framework の operations の
call(Read の境界)。opは operations の口の名 -
Send(name: String, op: String)framework の operations の
call(Write の境界)。通知のように応答を使わない口 -
Enqueue(name: String, kind: String)framework の operations の
enqueue(Write の境界)。kindは Queue の kind -
Fetch(name: String, module: String, js: String, arity: Int)★ の JS の関数(
moduleはsrc/からの道、拡張子無し)。ctx を先頭に取り Promise を返す(Read の境界) -
Pure(name: String, module: String, js: String, arity: Int)★ の JS の純関数
-
SystemCall(name: String, system: String, method: String)別のアプリの読みの入口(
systems)の口を呼ぶ(B10、0.16.0)。systemは呼ぶ先の入口の名、methodはその口の名。 Workers は service binding、Lambda は env<SYSTEM>_URLへ署名付きの POST(Read の境界)。叩き台の名はSystemだが、 入口の宣言の型Systemの構成子と同じ module に並ぶのでSystemCallにした
回数の天井(B6、pub const quotas: List(Quota))。services の要求を、人ごと・暦日ごとに数え、超えたら 429
quota_exceeded。party は session の party ごとの上限、browser は browser の印ごとの上限(party の無い要求)、
zone は暦日の区切りの時刻帯。上限は叩き台どおり Int で、0 は「その主体には使わせない」
pub type Quota {
Quota(
name: String,
services: List(String),
party: Int,
browser: Int,
zone: String,
)
}
Constructors
-
Quota( name: String, services: List(String), party: Int, browser: Int, zone: String, )
root の形の上書き(WGy r3)。導出は「allow の Entity の key の型が Args に在れば、その Entity の行」。 作る Service(Args の key は新しい行の鍵)や、主体の行を root にする Service はここに書く。
pub type RootShape {
Rootless(service: String)
OwnRoot(service: String)
RootOf(service: String, entity: String)
WithVersion(service: String)
Carried(
service: String,
name: String,
type_: String,
import_: String,
)
QueueParty(service: String, party: String)
}
Constructors
-
Rootless(service: String)root に Entity の行を持たない(
Root(at, seed)) -
OwnRoot(service: String)root を主体(session の subject)の行にする。Entity は allow の Entity
-
RootOf(service: String, entity: String)root を
entity(module 名)の行にする。鍵は Args のid -
WithVersion(service: String)root に行の
version列(楽観ロックの版、Entity のレコードに無い列)をversion: Intで載せる -
Carried( service: String, name: String, type_: String, import_: String, )root に入口が運ぶ値を載せる(
browser= 署名した browser cookie の id)。type_は Gleam の綴り、import_はその綴りが要る import の行の中身 -
QueueParty(service: String, party: String)queue の consumer
service(root の 1 文を持たず、自分を queue で呼ぶ Service の root を借りる)が、 借りた root を session の partypartyとして読む(root の 1 文と verb のpartyの穴・audit の party)。 書かなければ consumer は party 無しで読む(gate-1 r2、framework の JS から主体の名を抜いた)
pub type Route {
Route(service: String, method: Method, path: String)
RouteVia(
service: String,
method: Method,
path: String,
credential: Credential,
)
Internal(service: String)
}
Constructors
-
Route(service: String, method: Method, path: String)導出の (method, path) をこれに替える。媒体は導出どおり(
Sessionの入口)。 -
RouteVia( service: String, method: Method, path: String, credential: Credential, )媒体を明示する口。
ApiKeyなら REST v1 の入口だけが持つ。 -
Internal(service: String)HTTP の口を持たない Service(queue・cron・Service からの呼び出しだけ)。
Sealed の持ち主ごとの鍵(B12a、pub const seals: List(Seal))。kek は今の KEK の秘密の env の名、previous は
替える前の KEK(替えの間だけ書く)、dek は DEK の持ち方。鍵の替えは cron の Rekey(seal: name)
pub type Seal {
Seal(
name: String,
kek: String,
previous: option.Option(String),
dek: SealKey,
)
}
Constructors
-
Seal( name: String, kek: String, previous: option.Option(String), dek: SealKey, )
DEK の持ち方。叩き台は PerOwner だけで、今の for_staff(KEK で直に封じる)は宣言を要らないので構成子を足さない
pub type SealKey {
PerOwner(entity: String)
}
Constructors
-
PerOwner(entity: String)Entity
entity(module 名)の行ごとに DEK を持ち、KEK で包む。AAD は runtime が Entity の名と行の鍵から組む
Entity の器と列の写像(WGy r3、鷹野の裁定)。entity は Entity の module 名(muse_setting_spec)、
property はレコードの欄の名(type_)。生成器は verb の SQL をこの写像で書き、穴の契約
(Property 1 つに穴 1 つ、値は codec の encode)は変えない ── 割る・写すのは SQL の側でする。
pub type Storage {
InObject(entity: String, object: String)
InSchema(entity: String, schema: String)
Derived(entity: String, property: String)
ReadFrom(entity: String, relation: String)
Column(entity: String, property: String, column: String)
Text(
entity: String,
property: String,
values: List(#(String, String)),
)
Split(
entity: String,
property: String,
columns: List(#(String, String)),
)
Array(entity: String, property: String, element: String)
}
Constructors
-
InObject(entity: String, object: String)0.16.0 で閉じた(生成器が exit 4 で止める)。Entity の正本は Postgres だけ ── Durable Object の SQLite は Lambda から 読めない。構成子は 0.17.0 で消す(消すと
server.gleamが型の誤りで落ち、生成器が名指しできないので 1 版だけ残す) -
InSchema(entity: String, schema: String)Entity の表を
appでない schema に置く(public)。生成器はこの Entity の表を<schema>.<表>で書く。 書かなければapp(yumemi/schema.app) -
Derived(entity: String, property: String)表の列に持たない Property(読む SQL が別の表から渡す値)。生成器はこの Property を表の列として扱わない ── create・update の verb の列と値、RETURNING、Draft・Created から外す。手書きの root・読みの SQL が Property 名の列で渡し、行の写し(codec・hook)は今の形で受ける。
ReadFromが無ければ、生成の読みはこの Entity の行を渡せない -
ReadFrom(entity: String, relation: String)Entity の読みを表とは別の relation(view)から引く。
relationは Entity の schema の中の名(store_view)。 生成の読み(from・join・矢印・has・allow の経路・with の子)はこの relation を書き、verb(create・update・ put・delete・RETURNING・行を掴む文)と FK は表のまま。この Entity のDerivedの Property は relation が 列で渡すものとして、生成の読みが行をまるごと渡し、名指しで引く -
Column(entity: String, property: String, column: String)Property の列名を替える(
type_→type、default→default_value) -
Text( entity: String, property: String, values: List(#(String, String)), )payload の無い構成子だけの sum を text 1 列で持つ。
valuesは (構成子, 列の値)。 列名は Property 名(Columnがあればその列) -
Split( entity: String, property: String, columns: List(#(String, String)), )record(または
Option(record))の Property を複数の列に割る。columnsは (record の欄, 列) -
Array(entity: String, property: String, element: String)List(<値型>)を PG の配列で持つ。elementは要素の SQL の型(uuid)
アプリの間の読みの入口(B10、pub const systems: List(System))。主体は Staff でなく入口そのもので、AppSystem と同じ並び。
name は入口の名(呼ぶ側の SystemCall の system)
pub type System {
System(name: String, methods: List(SystemMethod))
}
Constructors
-
System(name: String, methods: List(SystemMethod))
入口の口 1 つ。name は口の名、service は呼ぶ読みの Service、fields は返す欄(Service の Out の欄の名)。
欄を絞るのは、入口が別のアプリへ渡すものを宣言で見えるようにするため
pub type SystemMethod {
SystemMethod(
name: String,
service: String,
fields: List(String),
)
}
Constructors
-
SystemMethod(name: String, service: String, fields: List(String))
pub type Variant {
ImageVariant(
name: String,
width: Int,
height: option.Option(Int),
fit: Fit,
)
}
Constructors
-
ImageVariant( name: String, width: Int, height: option.Option(Int), fit: Fit, )nameは[a-z][a-z0-9_]*(URL の?v=<name>)。heightが None なら幅だけで縮める
行ごとの時刻の起床(B5、pub const wakes: List(Wake))。列挙の読み <service>/<query>(穴 $1 = 起床の時刻)の
行ごとに Service を 1 回呼ぶ ── EachDue と同じ読みを、FW の決め打ちの毎分の式で回す。式を書かせないのは、粒度
(1 分)を FW が持ち、指し先ごとの式の写し(第 59 条)を利用者に背負わせないため
pub type Wake {
Wake(service: String, query: String)
}
Constructors
-
Wake(service: String, query: String)
Service でない口の主体。Anyone は未ログインを通し、Party は session の party を要る。
pub type Who {
Anyone
Party
}
Constructors
-
Anyone -
Party
Windowed の Args の 1 欄(B14、0.16.0)。arg は Service の Args の欄の名、zone は暦の区切りの時刻帯(Asia/Tokyo)。
叩き台の 3 つに HoursBefore・ScheduledAt を足した ── musearch の hooks.mjs 1〜56 の掃除の境(ttl_hours 前、起床の時刻)も
同じ hook で作っていて、これが無いと 1〜56 が消えない。
pub type Window {
PreviousDay(arg: String, zone: String)
PreviousMonth(arg: String, zone: String)
MonthsBefore(arg: String, months: Int, zone: String)
HoursBefore(arg: String, hours: Int)
ScheduledAt(arg: String)
}
Constructors
-
PreviousDay(arg: String, zone: String)予定の時刻の前日(
Date) -
PreviousMonth(arg: String, zone: String)予定の時刻が月の 1 日なら前月の 1 日(
Some(Date))、それ以外はNone。欄の型はOption(Date) -
MonthsBefore(arg: String, months: Int, zone: String)予定の時刻の
monthsか月前の同じ時刻(DateTime、月末は月の最終日に寄せる)。叩き台のnをmonthsにし、 月の数え方が時刻帯に依るのでzoneを足した -
HoursBefore(arg: String, hours: Int)予定の時刻の
hours時間前(DateTime) -
ScheduledAt(arg: String)予定の時刻そのもの(
DateTime)