event-manual / reference

パッケージ API リファレンス

v1 は主要 export の手書きサマリ。JSDoc 自動生成（typedoc）は後続で置換する。

@event/schema.

正規ドメイン型。ID は全域 id。LOCKED フィールドは 4S 所有。

  • Session / Speaker / Room / Venue / Sponsor / PassTier正規型セット
  • LOCKED_SESSION_FIELDS4S 所有フィールド登録簿（書き込み拒否の根拠）
  • CARD_OVERLAY_FIELDSカード手動調整オーバーレイの登録簿

@event/fours-sdk. · ./client

唯一の型付き 4S クライアント。全モジュールはこれを通して 4S を読む。

  • createFoursConfig / summarizeFoursConfigenv 一元解決（mode 判定 / normalizeBase）
  • fetchEvent / listSessionsFromEvent / listSpeakersFromEvent / listPassTiersevent 読み出し + adapter 合成
  • adaptSession / adaptSpeaker / adaptEventToVenueswire → 正規型（overlay seam 付き）
  • sessionSpeakerRefs / detectModeratorId / fourSLineupEditedAt新旧 API 互換 + moderator + last-writer-wins 基準
  • verify4SUser/users/me 本人確定（成功のみ 60s cache）
  • createSessionCodec / isResourceOwnerjose HS256 httpOnly cookie（推奨認証モデル）
  • verifyWebhookSignatureHMAC-SHA256（constant-time）
  • mergeCollection(Canonical) / safetyGuard3-layer merge + データ損失ガード
  • getServiceIdToken / fetchDescendantInfo / fetchEntryIndexservice/admin API
  • createLoginProxyHandler / createCognitoRefreshHandlerroute factories（列挙対策 / SSRF guard）
  • (client) use4SSession / consumeHandoff / tokenStoreブラウザ側セッション（handoff consume）

@event/core. · ./auth

共有インフラの背骨。./auth は edge-safe subpath。

  • createContentStorefs/GitHub 二重書き込み + sha256 楽観ロック + sha リトライ
  • createSharedPasswordAuth / constantTimeEqual / loginJitter共有パスワード認証（統一実装）
  • kv / hasKvUpstash KV（JSON-coercion ガード）+ dev shim
  • defineEnv / envExamplezod 検証 env（boot fail-fast）
  • withCronAuth / isCronAuthorizedBearer CRON_SECRET（503 fail-closed）
  • createNextConfig / buildCsp / buildSecurityHeadersCSP/HSTS/COOP 標準装備 factory

@event/cms. · ./ui · ./client

JSON-as-DB コンテンツモデル + schema 駆動 admin。

  • FieldSchema / ResourceSchemalocked/advanced/csvImport/publicFields 付き schema 型
  • createResourceRegistrysingleton 判定を shape から派生（三重宣言の廃止）
  • createContentReaderdev sample overlay（.local.json / 本番遮断）
  • createCmsActions / applyLockedGuard保存 factory + locked 二層防御（配列再帰）
  • createCmsRouteHandlers / (client) putResourceIf-Match 楽観ロック REST
  • validatePayload / getByPath / setByPath / pickPublicFields検証 / dot-path / allowlist projection
  • (ui) GenericForm / SplitView自動生成フォーム + Linear 風 list+edit

@event/session-card. · ./persist

1A–10A photo-first カード。engine は元実装と挙動差分ゼロを実証済み。

  • computeBalance / computeGridBalance / visualWidth / breakTitleLines純粋レイアウト数学（4コピー統合）
  • recommendedVariant / effectiveVariant人数→variant 解決（upsize のみ許可）
  • SessionCard / ScaledCard1920×1080 DOM 描画（onResolved 報告）+ 縮小プレビュー
  • SessionCardDesigner手動最終調整（DnD / \n 上書き / scale / auto-prefill）
  • resolveCardModelSession/Speaker + overlay → CardModel
  • (persist) createContentOverlayStoresingle-record PATCH + 楽観ロック×6 + KV ミラー

@event/shell. · ./ui

認証 realm / nav registry / admin シェル / chrome gate。

  • defineRealmsN-realm 共有パスワード認証の宣言的定義
  • createNavRegistryself-register 式 nav（中央配列の廃止）
  • createDevLoginHandlerワンクリック dev ログイン（三重ガード）
  • createAuthGateMiddleware境界ゲート（認可は action 側で再検査）
  • (ui) AdminNav / ChromeGate折りたたみナビ + ISR-safe chrome 出し分け

@event/asset-kit./server · ./capture · ./bulk · ./image

アセット保存 / capture / 一括 ZIP。client/server split で bundle 汚染なし。

  • (server) createAssetStore / createUploadHandlerBlob put + hash 冪等 rehost + upload route
  • (capture) captureCanvas / exportPng / exportPdf / exportAi / copyPngToClipboardmodern-screenshot 主 + fallback、物理 mm PDF / .ai
  • (bulk) bulkZip / downloadBlob / uniqPathworker-pool ZIP（~7 実装の統合）
  • (image) uploadImageWithVariantssharp variants（SVG は XSS 防止で拒否）