event-manual

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

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

@event/* 全パッケージの役割と主要 export。各パッケージから解説章へ、 章から実装レシピへ相互に辿れる。

DB スキーマ・リファレンス（Field Manifest から自動生成）

全 entity × field の型・layer（core / extension）・writableBy・制約を DEFAULT_MANIFEST から自動生成。手書きしない DB runbook。

@event/schema.

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

解説章:ch.6 イベントデータの取得ch.11 コアデータモデルch.43 既存3アプリの収束計画ch.45 パッケージ API リファレンス

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

@event/fours-sdk. · ./client

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

解説章:ch.4 環境変数リファレンスch.5 4S 統合の全体像ch.6 イベントデータの取得ch.7 ユーザー / 組織プロフィールch.8 ログインレス session-handoffch.9 本人確認と認可ch.10 同期モードch.24 パーソナルシェアカードch.38 認証と認可ch.43 既存3アプリの収束計画ch.45 パッケージ API リファレンス

  • 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。

解説章:ch.4 環境変数リファレンスch.14 コンテンツストアch.38 認証と認可ch.40 ビルド設定 & セキュリティヘッダch.41 デプロイ & cronch.43 既存3アプリの収束計画ch.45 パッケージ API リファレンス

  • 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。

解説章:ch.12 JSON-as-DB コンテンツモデルch.13 スキーマ駆動 Admin CMSch.14 コンテンツストアch.43 既存3アプリの収束計画ch.45 パッケージ API リファレンス

  • 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 は元実装と挙動差分ゼロを実証済み。

解説章:ch.18 セッションカード レイアウトエンジンch.19 手動ファイン調整エディタch.23 日本語タイポグラフィch.43 既存3アプリの収束計画ch.45 パッケージ API リファレンス

  • 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。

解説章:ch.9 本人確認と認可ch.37 Admin シェルとナビ登録ch.38 認証と認可ch.42 新機能の追加ch.43 既存3アプリの収束計画ch.45 パッケージ API リファレンス

  • 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 汚染なし。

解説章:ch.22 レンダリングパイプラインch.30 見積 & 証明書ch.39 アセットストアと一括ダウンロードch.43 既存3アプリの収束計画ch.45 パッケージ API リファレンス

  • (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 防止で拒否）

@event/feedback.

サーベイ / IMDb 加重ランキング / ライブ投票。常時受付・常に匿名。

解説章:ch.26 サーベイ & フィードバックch.27 スコアリング & リーダーボードch.28 ライブエンゲージメントch.45 パッケージ API リファレンス

  • createSubmitHandler / createFeedbackStore公開 submit（honeypot / uaHash upsert）+ 永続（dev fs / 本番 Blob）
  • rankSubjects / rankingContext / subjectScoreIMDb 加重（会場ベースライン縮約・全1331票で数値等価検証済）
  • DEFAULT_FACE_SCALE / aggregate / responsesToCsv3顔スケール（values/scores 二系統）+ 集計 / CSV
  • createLiveStore / hostKeyFor / verifyHostKeylive poll（KV view-follow）+ 導出 host key

@event/crm-schema.

MCP-first 二層 DB。固定コア（手書き migration）+ meta jsonb 拡張 + Field Manifest。

解説章:ch.15 MCP-first 二層 DBch.45 パッケージ API リファレンス

  • DEFAULT_MANIFEST / createManifestIndex / addExtensionFieldField Manifest（単一真実源）+ splitPatch 検証 + カラム追加
  • guardedUpdate / guardedArchiveversion 楽観ロック + core/meta 振り分け + 追記専用 audit
  • db / CRM_TABLES / auditLoglazy Neon Proxy（未設定でも import で落ちない）+ org/user/member/entity_lp/compliance

@event/mcp. · ./ui

この app を MCP server として公開。同一 EventTool[] を stdio + HTTP 両方で。

解説章:ch.15 MCP-first 二層 DBch.45 パッケージ API リファレンス

  • createEventMcpServer / startStdio / createMcpHttpHandlerserver 本体 + stdio + HTTP(JSON-RPC 2.0 / Bearer)
  • contentToolGroup / foursToolGroup / dbToolGroupCMS 読み書き / 4S 照会 / DB（schema_addField=カラム追加・migration_propose=人間承認）
  • resolveMcpSettings / generateConnectionConfig設定（content/mcp-settings.json）+ 接続 .mcp.json 生成
  • (ui) McpConnectionPanel / mcpSettingsResourceSchema設定画面 /admin/settings/mcp（GenericForm 駆動）

@event/booking. · ./ui

予約（定員/waitlist/冪等 dedup）+ 見積（basis-point 税・純関数）+ 見積書帳票 UI。

解説章:ch.29 予約 & キャパシティch.30 見積 & 証明書ch.45 パッケージ API リファレンス

  • computeQuote / makeEstimateNo / yen / formatJst税 inclusive/exclusive 見積（DB 不要の純関数）+ 採番
  • createReservationStore / createBookingActions / defineBookingConfig定員判定→waitlist・rate-limit・kill-switch・冪等 dedup の一気通貫
  • defineReservationTable / reservationTableSql予約テーブル定義 + migration SQL 生成（partial-unique index 付き）
  • createBlobQuoteStore / createNeonQuoteStore見積レコード永続（Blob / Neon 両対応）
  • (ui) QuoteDocumentQuoteRecord → A4 御見積書の純 React 帳票。asset-kit exportPdf で PDF 化（server-only barrel と別サブパス）

@event/mailer.

Resend transactional + branded shell + Slack Block Kit。キー未設定は fail-safe。

解説章:ch.36 メールch.45 パッケージ API リファレンス

  • createMailer / resolveBrand送信（onMissingKey: noop/throw）+ ブランド shell
  • invitationTemplate / otpTemplate / notifyTemplate / renderShell / ctaButtonテンプレレジストリ（subject/html/text）
  • slackBlocks / keyValueBlocks / postToSlack運用 Slack 通知（Block Kit）

@event/networking.

entity-linking マッチング + PII 最小 registry + k-anonymity。ドメイン語彙は注入式。

解説章:ch.32 マッチング & ディレクトリch.33 プライバシーch.34 リファラル & ファクションch.45 パッケージ API リファレンス

  • buildDictionary / matchName / linkFromText / jaroWinkler / diceCoefficient正規化→辞書→類似度→AUTO/REVIEW/AMBIGUOUS 閾値判定
  • hasGrantedConsent / isEligibleForListing / sanitizeSubjectsForPublicconsent gating + 公開射影（fail-closed）
  • applyKAnonymity / maskKAnonymity / K_MIN / safeScalar小セル秘匿（k=5）
  • resolveTier / resolvePerks / rankByCount / createRegistrySchemaリファラル tier/perk + registry drizzle schema factory

@event/spatial.

SvgHotspotLayer + lane-packing タイムテーブル + 会場 config。

解説章:ch.35 マップ & タイムテーブルch.45 パッケージ API リファレンス

  • SvgHotspotLayerインライン SVG + overlay hit 形状 + hover/select + ディープリンク（"use client"）
  • packTimeslots / assignLanes / formatTime 群重なり区間→レーン割当（純関数）+ JST 固定整形
  • SpatialConfig / timetable model会場 SVG / viewBox / hotspot 座標テーブル + track/room/timeslot 型

@event/visuals.

EventBrand + FormatRegistry + HUD chrome + cutout。書き出しは asset-kit に委譲。

解説章:ch.17 デザイントークンch.20 フォーマット & サイズマトリクスch.21 HUD/chrome システムch.22 レンダリングパイプラインch.23 日本語タイポグラフィch.24 パーソナルシェアカードch.25 スピーカー切り抜きch.45 パッケージ API リファレンス

  • resolveBrand / brandCssVars / DEFAULT_BRANDブランドトークン（--vis-*）解決
  • SNS_FORMATS / VENUE_FORMATS / createFormatRegistrySNS + 印刷（mm-PDF / √2）サイズマトリクス
  • VisualChromegrid / grain / corner / watermark の HUD 合成（"use client"）
  • removeBackground / canvasLumaKeyBackend / CutoutBackend背景除去（zero-dep canvas fallback + MODNet/@imgly 差し込み口）

@event/i18n.

多言語 UI プリミティブ。pickLang 2形対応 + LangProvider + cookie 永続。

解説章:ch.16 多言語 i18n

  • pickLang / hasCJK / Lang{ja,en} record と {value,valueEn} 対の両形対応（4S languages.en fallback 規則）
  • LangProvider / useLang / useT / <T>"use client" context + 出し分けフック
  • langFromCookie / langToCookieSSR 初期言語解決（hydration 一致）

@event/leads.

リード獲得パイプライン。honeypot→rate-limit→検証→persist-first→fan-out。

解説章:ch.31 リード獲得パイプライン

  • createLeadHandler / leadInputSchemaWeb 標準 Request→Response（保存を通知より先に確定 = リードを失わない）
  • createContentLeadStore / createMemoryRateLimiter永続（dev fs / 本番 Blob）+ IP レート制限
  • createSlackLeadSink / createMailerLeadSink通知 sink（キー未設定なら no-op）

@event/design.

デザイントークン層 + Worldview（世界観1宣言→4面派生）。zero-dep 純関数。

解説章:ch.44 デザイン専用カスタマイズ

  • defineDesign / tokensToCssVars / DESIGN_PRESETS型付きトークン → globals.css 実変数へ写像 + slots
  • defineWorldviewパレット+書体+ムードの単一宣言（デザイン世界観の真実源）
  • worldviewToDesignInput / worldviewToBrand / worldviewToCardTheme / worldviewToMailBrandサイト / ビジュアル / カード / メール4面への純関数派生
  • withAlpha / mix / isDarkhex 色演算（派生の基盤）

@event/motion.

モーショングラフィックス・プリミティブ（zero-dep）。連動はネイティブ CSS scroll-driven、発火は IntersectionObserver。

解説章:ch.47 モーショングラフィックス

  • MotionStyles / MOTION_CSSモーション CSS 注入（easing/keyframes/scroll-driven・reduced-motion 全停止）
  • Revealビューポート入場リビール（dir/delay で stagger・"use client"）
  • CountUp入場カウントアップ（prefix/suffix は RSC-safe・reduced-motion は即値）