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 は下のとおり。どれも無くてよい(無ければ空の表)。

0.16.0 の語(指し先と B1〜B15)の宣言の型は、下の「0.16.0」の節に先に置く(便 D0)。生成と runtime は語ごとの便で入り、 まだ入っていない語を宣言したアプリは、生成器が exit 1(「生成器の不足:0.16.0 の便 <名> で入る」)で止める。

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 本目。

pub type Attached {
  Attached(name: String, method: Method, path: String, who: Who)
}

Constructors

  • Attached(name: String, method: Method, path: String, who: Who)

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)

connector の FFI の口(WGy r2、鷹野の裁定 2)。型と typed な包みは ★ に置き、 生成物(src/gen/connector/<name>.gleam)は口だけを持つ ── 引数と戻りは型変数で、★ の包みが型を決める。

pub type Connector {
  Connector(name: String, ports: List(Port))
}

Constructors

  • Connector(name: String, ports: List(Port))

口が受ける媒体。entry の Credential と同じ 2 値(ApiKey の per_minute は entry が持つ)。

pub type Credential {
  Session
  ApiKey
}

Constructors

  • Session
  • ApiKey
pub type Cron {
  Cron(schedule: String, jobs: List(Job))
}

Constructors

  • Cron(schedule: String, jobs: List(Job))

    schedule は wrangler の式。表に無い式で起きたときは outbox の sweep だけを回す。

申告の種類。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

縁のキャッシュ(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 の status status で返す

  • ServiceStatus(service: String, code: String, status: Int)

    Service service の符号 code の失敗だけを status status で返す。同じ符号の Status より先に効く

  • Constraint(name: String, code: String)

    DB の制約名 name の違反を符号 code の失敗に写す

pub type Fit {
  ScaleDown
  Cover
  Contain
}

Constructors

  • ScaleDown
  • Cover
  • Contain
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 の表を env env から読む(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: Window 1 つを 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 Method {
  Get
  Post
  Put
  Delete
}

Constructors

  • Get
  • Post
  • Put
  • Delete
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 の party party として読む(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

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

入口の口 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 const targets: List(Target))。無ければ [Workers] と読む。

pub type Target {
  Workers
  Lambda(faces: List(FaceEntry))
}

Constructors

  • Workers
  • Lambda(faces: List(FaceEntry))

    faces は入口を ★ の module にする面だけを書く(書かない面は生成の src/gen/shell.mjs)

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)

✨ Search Document