@ryusenkei/maezae 0.1.0 → 0.3.0

package/dist/types/cms-contract/src/extensions.d.ts

@@ -0,0 +1,75 @@
+import type { ConnectionPoint, ContentTypePoint, ModuleBase, PermissionTarget, SettingField } from './modules.js';
+/** 拡張機能の状態（API /api/extensions の行） */
+export type ExtensionState = Readonly<{
+    id: string;
+    label: string;
+    description: string;
+    /** コアに組み込みのモジュール */
+    builtIn: boolean;
+    /** 導入先の設定でオフにできない（常にオン） */
+    required: boolean;
+    enabled: boolean;
+    contentTypes: Required<ContentTypePoint>;
+    permissions: readonly PermissionTarget[];
+    /** 必要な外部の接続と、接続済みか */
+    connections: readonly (ConnectionPoint & Readonly<{
+        connected: boolean;
+    }>)[];
+    settingFields: readonly SettingField[];
+    /** 設定のページで編集する項目の現在値（キーは settingFields の key） */
+    settings: Readonly<Record<string, unknown>>;
+    /** 設定値の入力（導入先の指定に画面で保存した値を重ねたもの、管理画面・MCP が manifest.settings で解釈、組み込みのモジュールは空） */
+    settingsInput: Readonly<Record<string, unknown>>;
+    /** サーバーの側が追加するもの（定期の処理・記事の規則は表示名） */
+    adds: Readonly<{
+        jobs: readonly string[];
+        rules: readonly string[];
+        calendar: boolean;
+        delivery: boolean;
+    }>;
+}>;
+/** 拡張機能の切り替えと設定の保存（PUT /api/extensions/:id の本文） */
+export type ExtensionUpdate = Readonly<{
+    enabled?: boolean;
+    settings?: Readonly<Record<string, unknown>>;
+}>;
+/**
+ * カレンダーの予定（API /api/calendar の行、at は ISO 8601、path は管理画面の経路）
+ * - source: 記事の公開は core、モジュールはその id、設定で掲載する日付のフィールドは calendarFieldSource
+ */
+export type CalendarItem = Readonly<{
+    source: string;
+    id: string;
+    title: string;
+    at: string;
+    path: string | null;
+}>;
+/** カレンダーに掲載する日付のフィールド（type はコンテンツタイプの id、field は最上位の date・datetime のフィールドのキー） */
+export type CalendarField = Readonly<{
+    type: string;
+    field: string;
+}>;
+/** 日付のフィールドの予定が持つ source（`field:<型>.<フィールド>`） */
+export declare const calendarFieldSource: (f: CalendarField) => string;
+/**
+ * ダッシュボードの対応待ちの行（API /api/dashboard の overall.pending）
+ * - kind: レビュー待ちは review、承認待ちは request、モジュールはその id
+ * - type: 対象のコンテンツタイプの id（件数だけの行は null）
+ * - title: 対象の名前で件数だけの行は null、count: 件数で1件の行は1
+ * - by: 提出・依頼した人、at: 最新の日時（UTC の ISO 8601）、path: 管理画面の経路
+ */
+export type PendingItem = Readonly<{
+    kind: string;
+    type: string | null;
+    title: string | null;
+    count: number;
+    by: string | null;
+    at: string | null;
+    path: string | null;
+}>;
+/** 拡張機能が持つフィールドの持ち主（キーは `型/フィールド`、値はモジュールの id、重複は例外） */
+export declare function fieldOwnersOf(modules: readonly Pick<ModuleBase, 'id' | 'about'>[]): ReadonlyMap<string, string>;
+/** 権限の対象の一覧（モジュールの id つき、id の重複は例外） */
+export declare function permissionTargetsOf(modules: readonly Pick<ModuleBase, 'id' | 'about'>[]): readonly (PermissionTarget & Readonly<{
+    module: string;
+}>)[];

package/dist/types/cms-contract/src/fieldRules.d.ts

@@ -0,0 +1,37 @@
+import type { FieldRef } from './modules.js';
+type Values = Readonly<Record<string, unknown>>;
+/** 拡張機能のフィールドの規則（type・key の項目に対する宣言） */
+export type FieldRule = FieldRef & Readonly<{
+    /** 値を拡張機能が決定（人と AI の入力の対象外） */
+    auto?: boolean;
+    /** ほかの項目の値で決まる値（項目 from の値ごとの値、表にない値は otherwise） */
+    derive?: Readonly<{
+        from: string;
+        map: Readonly<Record<string, string>>;
+        otherwise: string;
+    }>;
+    /** 表示の条件（項目 key の値が in のいずれかのときだけ表示、条件に合わないときは値を空に） */
+    when?: Readonly<{
+        key: string;
+        in: readonly string[];
+    }>;
+    /** 型の公開が可のアカウントだけが選択できる選択肢（AI は選択不可、message は拒否の理由） */
+    restricted?: Readonly<{
+        values: readonly string[];
+        message: string;
+    }>;
+}>;
+/** 表示の条件に合わない項目の key */
+export declare const hiddenFieldsOf: (rules: readonly FieldRule[], type: string, values: Values) => ReadonlySet<string>;
+/** 値を拡張機能が決定する項目の key */
+export declare const autoFieldsOf: (rules: readonly FieldRule[], type: string) => ReadonlySet<string>;
+/** 規則を適用した値（決まる値を設定し、表示の条件に合わない項目は空に） */
+export declare function applyFieldRules<V extends Values>(rules: readonly FieldRule[], type: string, values: V): V;
+/** 選択できない選択肢の値（項目の key ごと、公開が可のアカウントでは空、AI の候補は publisher を false で判定） */
+export declare function restrictedChoicesOf(rules: readonly FieldRule[], type: string, publisher: boolean): Readonly<Record<string, readonly string[]>>;
+/** 選択できない選択肢を選択した値の問題（path は項目の key） */
+export declare const restrictedProblemsOf: (rules: readonly FieldRule[], type: string, values: Values, publisher: boolean) => Readonly<{
+    path: string;
+    message: string;
+}>[];
+export {};

package/dist/types/cms-contract/src/functions.d.ts

@@ -0,0 +1,71 @@
+/** 依頼する時点（save_check は型の保存前、publish_check は提出・公開の前の検査） */
+export declare const FUNCTION_HOOKS: readonly ["save_check", "publish_check"];
+/** 依頼する時点 */
+export type FunctionHook = (typeof FUNCTION_HOOKS)[number];
+/** 時点の表示名 */
+export declare const FUNCTION_HOOK_LABELS: Readonly<Record<FunctionHook, string>>;
+/** 時間切れ・失敗・不正な応答のときの扱い（block は保存・提出・公開を拒否、pass は通過） */
+export type FunctionOnError = 'block' | 'pass';
+/** 外の関数の登録（url・secret は末尾だけを伏せずに返す、lastStatus は最新の呼び出しで返った HTTP の状態、送れなかったときは0） */
+export type ExternalFunction = Readonly<{
+    id: string;
+    label: string;
+    hook: FunctionHook;
+    type: string;
+    url: string;
+    secret: string;
+    onError: FunctionOnError;
+    enabled: boolean;
+    lastStatus: number | null;
+    lastAt: string | null;
+}>;
+/** 保存前の検査の本文（id は作成なら null、values は宣言と拡張機能で補正した後の項目の値、user は操作した人のアカウントの ID とロール） */
+export type SaveCheckRequest = Readonly<{
+    hook: 'save_check';
+    type: string;
+    id: string | null;
+    values: Readonly<Record<string, unknown>>;
+    user: Readonly<{
+        id: string;
+        role: string;
+    }>;
+    at: string;
+}>;
+/**
+ * 保存前の検査の応答（HTTP の状態は 2xx）
+ * - problems: 1件でもあれば保存を拒否（path は項目の key、message は画面に表示する理由）
+ * - values: 補正する項目だけの値（入力に重ねる、なしは補正なし）
+ */
+export type SaveCheckResponse = Readonly<{
+    problems?: readonly Readonly<{
+        path: string;
+        message: string;
+    }>[];
+    values?: Readonly<Record<string, unknown>>;
+}>;
+/** 提出・公開前の検査の本文（stage は submit か publish、values は保存済みの行の値、id はテストの呼び出しだけ null） */
+export type PublishCheckRequest = Readonly<{
+    hook: 'publish_check';
+    type: string;
+    id: string | null;
+    stage: 'submit' | 'publish';
+    values: Readonly<Record<string, unknown>>;
+    user: Readonly<{
+        id: string;
+        role: string;
+    }>;
+    at: string;
+}>;
+/** 提出・公開前の検査の応答（HTTP の状態は 2xx、problems が1件でもあれば提出・公開を拒否、値の補正はなし） */
+export type PublishCheckResponse = Readonly<{
+    problems?: readonly Readonly<{
+        path: string;
+        message: string;
+    }>[];
+}>;
+/** 外の関数への依頼の本文 */
+export type FunctionRequest = SaveCheckRequest | PublishCheckRequest;
+/** 送信記録の出来事（<型の id>.<時点>） */
+export declare const functionEventOf: (type: string, hook: FunctionHook) => string;
+/** 送信記録の出来事の表示名（types は型の id と表示名、形が違えばそのまま） */
+export declare function functionEventLabel(event: string, types: Readonly<Record<string, string>>): string;

package/dist/types/cms-contract/src/index.d.ts

@@ -0,0 +1,19 @@
+export { API_KEY_RATE, type ApiKey } from './apiKeys.js';
+export { ASSET_BULK_MAX, ASSET_IMAGE_TYPES, ASSET_SIZE_MAX } from './assets.js';
+export { errorLabel, errorTitle, mergeMessages, TARGET_LABELS, targetOf, type TargetMessages } from './errorLabels.js';
+export { ERROR_STATUS, JSON_BODY_MAX, type ErrorBody, type ErrorCode, type ErrorParams, type ErrorTarget } from './errors.js';
+export { STATUS } from './labels.js';
+export { ANALYTICS_MODULE, BUILTIN_MODULES, OG_FONTS, OG_MODULE, type OgFont, type OgSettings } from './builtins.js';
+export { type CalendarField, calendarFieldSource, type CalendarItem, type ExtensionState, type ExtensionUpdate, fieldOwnersOf, type PendingItem, permissionTargetsOf } from './extensions.js';
+export { type CallApi, type ConnectionPoint, type ContentTypePoint, createModules, type FieldRef, type McpModule, type McpModuleContext, type McpParts, type McpTool, type ModuleAbout, type ModuleBase, moduleBaseOf, type ModuleContext, type ModuleInstance, type ModuleManifest, type ModuleSettingsInput, type ModuleSide, moduleTargetsOf, type PermissionTarget, type SettingField } from './modules.js';
+export { applyFieldRules, autoFieldsOf, type FieldRule, hiddenFieldsOf, restrictedChoicesOf, restrictedProblemsOf } from './fieldRules.js';
+export { pendingIds, pendingValue } from './pending.js';
+export { type AccountLink, type Action, ACTION_LEVELS, ACTIONS, allows, ANY_TARGET, canChangeRow, canDeleteContent, canEditContent, canPublishContent, canReadContent, canReadRow, canSubmitContent, checkPermissions, type ContentAccess, type Level, LEVELS, levelOf, ownsContent, ownsRow, type Permissions, type RowAccess } from './permissions.js';
+export { ADMIN_PERMISSIONS, ADMIN_ROLE, isAdmin, rolePermissionsOf, type Role, SYSTEM_ROLES, type User, WRITER_ROLE } from './roles.js';
+export { isServerPath, OPS_PATHS, SERVER_PATHS } from './paths.js';
+export { CONFIG_FORMAT, type ConfigBundle, type ConfigPreview } from './transfer.js';
+export { EMBED_CONTEXT_PARAM, EMBED_CONTEXT_TTL_SEC, EMBED_MESSAGES, EMBED_PLACEMENTS, type EmbedContext, type EmbedEntry, type EmbedMessage, type EmbedPlacement, type ExternalScreen } from './embeds.js';
+export { type ExternalFunction, FUNCTION_HOOK_LABELS, FUNCTION_HOOKS, functionEventLabel, functionEventOf, type FunctionHook, type FunctionOnError, type FunctionRequest, type PublishCheckRequest, type PublishCheckResponse, type SaveCheckRequest, type SaveCheckResponse } from './functions.js';
+export { parseWebhookEvent, type Webhook, WEBHOOK_ACTION_LABELS, type WebhookBody, WEBHOOK_ACTIONS, type WebhookAction, type WebhookEvent, webhookEventLabel, webhookEventOf, type WebhookKind } from './webhooks.js';
+export { type SavedView, VIEW_ACTIONS, type ViewAction, type ViewDefinition } from './views.js';
+export { canManageSettings, isSettingsTarget, managedAreasOf, SETTINGS_AREA_LABELS, SETTINGS_AREAS, type SettingsArea, settingsTarget } from './settings.js';

package/dist/types/cms-contract/src/labels.d.ts

@@ -0,0 +1,6 @@
+/** 公開の状態 */
+export declare const STATUS: {
+    readonly draft: "下書き";
+    readonly review: "レビュー待ち";
+    readonly published: "公開済み";
+};

package/dist/types/cms-contract/src/modules.d.ts

@@ -0,0 +1,144 @@
+import type { FieldRule } from './fieldRules.js';
+import type { TargetMessages } from './errorLabels.js';
+/** 導入先が有効にするモジュール（キーはモジュールの id、値はモジュールの設定値） */
+export type ModuleSettingsInput = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+/** 拡張機能が持つフィールド（type はコンテンツタイプの id、key はフィールドのキー） */
+export type FieldRef = Readonly<{
+    type: string;
+    key: string;
+}>;
+/** 拡張機能が追加するコンテンツタイプとフィールド（types は型の id、fields はほかの型へ追加するフィールド） */
+export type ContentTypePoint = Readonly<{
+    types?: readonly string[];
+    fields?: readonly FieldRef[];
+}>;
+/** 権限の対象（id は役割の表の識別子） */
+export type PermissionTarget = Readonly<{
+    id: string;
+    label: string;
+}>;
+/** 拡張機能が必要とする外部の接続（接続の状態はサーバーの側の connections で判定） */
+export type ConnectionPoint = Readonly<{
+    id: string;
+    label: string;
+}>;
+/** 設定のページの項目（key は設定値のキー、kind は入力の種類） */
+export type SettingField = Readonly<{
+    key: string;
+    label: string;
+    kind: 'number' | 'text' | 'boolean';
+    min?: number;
+    unit?: string;
+}>;
+/** 設定値から作成する値（メソッドの形で引数を双変にし、ModuleManifest<unknown> の一覧に入れられるように） */
+type FromSettings<S, T> = {
+    make(settings: S): T;
+}['make'];
+/** モジュールの共通の定義（S はモジュールの設定値） */
+export type ModuleManifest<S = Readonly<Record<string, never>>> = Readonly<{
+    id: string;
+    label: string;
+    /** 拡張機能の画面に表示する説明（1文） */
+    description?: string;
+    /** エラーの文と操作の履歴の対象（キーは対象の id、値は表示名） */
+    targets?: Readonly<Record<string, string>>;
+    /** 対象ごとのエラーの文（自分のものだけの操作・結び付くエントリーがないアカウント、対象の型が設定値のモジュールは設定値から作成） */
+    messages?: TargetMessages | FromSettings<S, TargetMessages>;
+    /** 導入先の指定・画面で保存した値からモジュールの設定値（不正な値は例外） */
+    settings: (input: Readonly<Record<string, unknown>>) => S;
+    /** コンテンツタイプの口（対象の型が設定値のモジュールは設定値から作成） */
+    contentTypes?: ContentTypePoint | FromSettings<S, ContentTypePoint>;
+    /** 権限の対象の口 */
+    permissions?: readonly PermissionTarget[];
+    /** 必要な外部の接続 */
+    connections?: readonly ConnectionPoint[];
+    /** 設定のページで編集できる項目（画面で保存した値は導入先の指定より優先） */
+    settingFields?: readonly SettingField[];
+    /** フィールドの宣言（設定値から作成、例: 種類で決まる名義） */
+    fieldRules?(settings: S): readonly FieldRule[];
+    /** 拡張機能が送る Webhook の出来事（キーは出来事の名前 <対象>.<操作>、値は表示名、設定の「連携」で選択） */
+    webhookEvents?: Readonly<Record<string, string>>;
+}>;
+/** 拡張機能の宣言（組み立てたモジュールの about、拡張機能の画面と口の判定に使用） */
+export type ModuleAbout = Readonly<{
+    description: string;
+    contentTypes: Required<ContentTypePoint>;
+    permissions: readonly PermissionTarget[];
+    connections: readonly ConnectionPoint[];
+    settingFields: readonly SettingField[];
+}>;
+/** 各側の create の引数（site は導入先の設定値） */
+export type ModuleContext<S> = Readonly<{
+    settings: S;
+    site: Readonly<{
+        id: string;
+        name: string;
+        origin: string;
+        timeZone: string;
+    }>;
+}>;
+/** 各側のモジュール（P は側ごとの内容、create は組み立ての時点で1回） */
+export type ModuleSide<S, P> = Readonly<{
+    manifest: ModuleManifest<S>;
+    create(ctx: ModuleContext<S>): P;
+}>;
+/** 組み立てたモジュールの共通の部分（fieldRules・messages は組み立ての時点の設定値で作成） */
+export type ModuleBase = Readonly<{
+    id: string;
+    label: string;
+    targets: Readonly<Record<string, string>>;
+    about: ModuleAbout;
+    fieldRules: readonly FieldRule[];
+    messages: TargetMessages;
+    webhookEvents: Readonly<Record<string, string>>;
+}>;
+/** 組み立てたモジュール（共通の定義と、側ごとの内容） */
+export type ModuleInstance<P> = ModuleBase & P;
+/** manifest から組み立てたモジュールの共通の部分（コアに組み込みのモジュールも使用、settings はモジュールの設定値） */
+export declare function moduleBaseOf<S>(manifest: ModuleManifest<S>, settings?: S): ModuleBase;
+/** MCP の側から CMS の API の呼び出し（パスと JSON の本文、応答は JSON） */
+export type CallApi = (method: string, path: string, body?: unknown) => Promise<{
+    status: number;
+    data: unknown;
+}>;
+/** MCP のツール */
+export type McpTool = {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    /** クライアント向けの付加情報（ChatGPT の openai/fileParams など） */
+    _meta?: Record<string, unknown>;
+    run: (args: Record<string, unknown>, api: CallApi) => Promise<{
+        status: number;
+        data: unknown;
+    }>;
+};
+/** MCP の側の内容 */
+export type McpParts = Readonly<{
+    tools?: readonly McpTool[];
+}>;
+/** MCP の側の引数（本文の Markdown への変換は CMS の API の /api/body/markdown） */
+export type McpModuleContext<S> = ModuleContext<S>;
+/** MCP の側のモジュール */
+export type McpModule<S = unknown> = Readonly<{
+    manifest: ModuleManifest<S>;
+    create(ctx: McpModuleContext<S>): McpParts;
+}>;
+/**
+ * 登録した側のモジュールを導入先の設定で組み立て
+ * - 登録は導入先の設定 modules にある id だけ（ない id・重複は例外）
+ * - complete: 設定にある id がすべて登録されているか（サーバーの側、DB と migration を持つため、builtins は組み込みのモジュールの id で設定値だけを持つ）
+ */
+export declare function createModules<P>(registered: readonly ModuleSide<unknown, P>[], config: Readonly<{
+    settings: ModuleContext<unknown>['site'];
+    modules?: ModuleSettingsInput;
+}>, options?: Readonly<{
+    complete?: boolean;
+    builtins?: readonly string[];
+}>): ModuleInstance<P>[];
+/** モジュールの対象の表示名をまとめた表（キーの重複は例外） */
+export declare function moduleTargetsOf(modules: readonly Readonly<{
+    id: string;
+    targets: Readonly<Record<string, string>>;
+}>[], core: Readonly<Record<string, string>>): Readonly<Record<string, string>>;
+export {};

package/dist/types/cms-contract/src/paths.d.ts

@@ -0,0 +1,6 @@
+/** サーバーが受け持つパスの頭（API・画像・プレビュー・ログインの入り口） */
+export declare const SERVER_PATHS: readonly ["/api", "/media", "/preview", "/auth"];
+/** 運営者の経路とヘルスチェックのパス（Access の内側で転送、サーバーの ops.ts が鍵で保護） */
+export declare const OPS_PATHS: readonly ["/healthz", "/ops"];
+/** サーバーが受け持つパスか（パスの頭と一致、または頭の下、運営者の経路を含む） */
+export declare const isServerPath: (pathname: string) => boolean;

package/dist/types/cms-contract/src/pending.d.ts

@@ -0,0 +1,4 @@
+/** 追加の依頼を記事に付ける値 */
+export declare const pendingValue: (requestId: string) => string;
+/** 記事の値のうち、承認待ちの依頼の ID */
+export declare const pendingIds: (values: readonly string[]) => string[];

package/dist/types/cms-contract/src/permissions.d.ts

@@ -0,0 +1,69 @@
+import type { User } from './roles.js';
+/** 操作 */
+export declare const ACTIONS: readonly ["read", "create", "update", "publish", "delete"];
+/** 操作 */
+export type Action = (typeof ACTIONS)[number];
+/** 段階 */
+export declare const LEVELS: readonly ["all", "own", "approval", "none"];
+/** 段階 */
+export type Level = (typeof LEVELS)[number];
+/** 操作ごとに選択できる段階（作成に持ち主はなく、承認は作成と公開だけ） */
+export declare const ACTION_LEVELS: Readonly<Record<Action, readonly Level[]>>;
+/** 権限の表（キーは対象の id、'*' は表にない対象の既定、操作がなければ不可） */
+export type Permissions = Readonly<Record<string, Readonly<Partial<Record<Action, Level>>>>>;
+/** 表にない対象の既定のキー */
+export declare const ANY_TARGET = "*";
+type Holder = Pick<User, 'permissions'>;
+/** 対象と操作の段階 */
+export declare const levelOf: (user: Holder, target: string, action: Action) => Level;
+/** 操作できるか（owned は自分が持ち主の行か、承認が必要は不可） */
+export declare const allows: (user: Holder, target: string, action: Action, owned?: boolean) => boolean;
+/** 行の値（持ち主か・公開中か） */
+export type RowAccess = Readonly<{
+    owned: boolean;
+    published: boolean;
+}>;
+/** 行を閲覧できるか */
+export declare const canReadRow: (user: Holder, target: string, row: RowAccess) => boolean;
+/** 行を変更・削除できるか（公開中の行は公開の権限も必要） */
+export declare const canChangeRow: (user: Holder, target: string, action: "update" | "delete", row: RowAccess) => boolean;
+/**
+ * 権限の表の検査（不正な値は理由の文の配列）
+ * - targets: 対象の id（'*' は常に可）
+ */
+export declare function checkPermissions(input: unknown, targets: readonly string[]): {
+    value: Permissions;
+} | {
+    problems: string[];
+};
+/** アカウントの結び付き（設定）: type はアカウントが結び付くコンテンツタイプ、owners は対象ごとに持ち主を表す参照の項目の key */
+export type AccountLink = Readonly<{
+    type: string | null;
+    owners: Readonly<Record<string, string>>;
+}>;
+type Owner = Pick<User, 'id' | 'entryId' | 'link'>;
+/**
+ * 行の持ち主か
+ * - 持ち主の項目がある対象: 項目の値に、アカウントが結び付くエントリーを含む
+ * - 結び付くコンテンツタイプの行: 結び付くエントリーそのもの
+ * - ほかの対象: 作成したアカウント（行の created_by、アカウントの ID）
+ */
+export declare const ownsRow: (user: Owner, target: string, row: Readonly<Record<string, unknown>>) => boolean;
+type Subject = Pick<User, 'permissions' | 'id' | 'entryId' | 'link'>;
+/** 権限の判定で使用する行の値（行のまま、持ち主の項目を含む） */
+export type ContentAccess = Readonly<Record<string, unknown>> & Readonly<{
+    status: string;
+}>;
+/** 行の持ち主か（ownsRow、持ち主のいない行は公開が全体で可のアカウント） */
+export declare const ownsContent: (user: Subject, target: string, a: ContentAccess) => boolean;
+/** 行を編集できるか（公開中の行は公開の権限も必要、サーバーは公開中の行の拒否を別のエラーで返す） */
+export declare const canEditContent: (user: Subject, target: string, a: ContentAccess) => boolean;
+/** 行を閲覧できるか */
+export declare const canReadContent: (user: Subject, target: string, a: ContentAccess) => boolean;
+/** 行を公開・予約・差し戻し・非公開にできるか（本文を変更しない操作のため、編集の権限は不要） */
+export declare const canPublishContent: (user: Subject, target: string, a: ContentAccess) => boolean;
+/** 行をレビューに提出できるか（編集でき、公開が承認が必要以上） */
+export declare const canSubmitContent: (user: Subject, target: string, a: ContentAccess) => boolean;
+/** 行を削除できるか */
+export declare const canDeleteContent: (user: Subject, target: string, a: ContentAccess) => boolean;
+export {};

package/dist/types/cms-contract/src/roles.d.ts

@@ -0,0 +1,35 @@
+import { type AccountLink, type Permissions } from './permissions.js';
+/** 管理者のロールの ID */
+export declare const ADMIN_ROLE = "admin";
+/** ライターのロールの ID（新しいアカウントの既定・MCP の権限） */
+export declare const WRITER_ROLE = "writer";
+/** 管理者の権限の表（すべての対象・操作が可、DB の値より優先） */
+export declare const ADMIN_PERMISSIONS: Permissions;
+/** ロールの権限の表（管理者のロールは固定の表、ほかは保存した表） */
+export declare const rolePermissionsOf: (roleId: string, stored: Permissions) => Permissions;
+/** 削除できないロールの ID */
+export declare const SYSTEM_ROLES: readonly string[];
+/** ロール（API /api/roles の行） */
+export type Role = Readonly<{
+    id: string;
+    label: string;
+    permissions: Permissions;
+}>;
+/**
+ * ログイン中のアカウント
+ * - id: アカウントの ID（操作の履歴・版の作成者・担当者などに保存する値、メールアドレスは表 accounts だけ）
+ * - role: ロールの ID、entryId: 結び付くエントリー（なしは null）、link: 結び付きの設定
+ * - token: MCP のログインの方式（MCP からの操作だけ）
+ */
+export type User = Readonly<{
+    id: string;
+    email: string;
+    role: string;
+    roleLabel: string;
+    permissions: Permissions;
+    entryId: string | null;
+    link: AccountLink;
+    token?: string;
+}>;
+/** 設定を扱える（管理者のロールの）アカウントか */
+export declare const isAdmin: (user: Pick<User, "role">) => boolean;

package/dist/types/cms-contract/src/settings.d.ts

@@ -0,0 +1,19 @@
+import { type User } from './roles.js';
+/**
+ * 設定の領域
+ * - general: 一般、content: コンテンツタイプ・メニュー・画像サイズ、extensions: 拡張機能
+ * - integrations: 連携・プレビューとデプロイ、data: インポート・エクスポート
+ */
+export declare const SETTINGS_AREAS: readonly ["general", "content", "extensions", "integrations", "data"];
+/** 設定の領域 */
+export type SettingsArea = (typeof SETTINGS_AREAS)[number];
+/** 権限の表での設定の領域の id */
+export declare const settingsTarget: (area: SettingsArea) => string;
+/** 権限の表の対象が設定の領域か */
+export declare const isSettingsTarget: (id: string) => boolean;
+/** 設定の領域を扱えるか（管理者は常に可、ほかは対象の更新が可のときだけ） */
+export declare const canManageSettings: (user: Pick<User, "role" | "permissions">, area: SettingsArea) => boolean;
+/** 扱える設定の領域（空は設定の層を開けない） */
+export declare const managedAreasOf: (user: Pick<User, "role" | "permissions">) => readonly SettingsArea[];
+/** 設定の領域の表示名 */
+export declare const SETTINGS_AREA_LABELS: Readonly<Record<SettingsArea, string>>;

package/dist/types/cms-contract/src/transfer.d.ts

@@ -0,0 +1,48 @@
+import type { Permissions } from './permissions.js';
+import type { ViewDefinition } from './views.js';
+/** スキーマと設定の形式の名前 */
+export declare const CONFIG_FORMAT = "cms-config";
+/** スキーマと設定（schema はコンテンツスキーマ ContentModel・screens は画面設定 ScreenSettings の形、roles は管理者以外、views はチームのビュー） */
+export type ConfigBundle = Readonly<{
+    format: typeof CONFIG_FORMAT;
+    version: 1;
+    exported_at: string;
+    schema: unknown;
+    screens: unknown;
+    roles: readonly Readonly<{
+        id: string;
+        label: string;
+        permissions: Permissions;
+    }>[];
+    views: readonly Readonly<{
+        id: string;
+        type: string;
+        label: string;
+        definition: ViewDefinition;
+        roles: readonly string[];
+    }>[];
+    extensions: readonly Readonly<{
+        id: string;
+        enabled: boolean;
+        settings: Readonly<Record<string, unknown>>;
+    }>[];
+}>;
+/** スキーマと設定の読み込みの確認（schema はスキーマの変更、ほかは追加と更新の件数） */
+export type ConfigPreview = Readonly<{
+    schema: readonly Readonly<{
+        id: string;
+        level: 'safe' | 'confirm' | 'forbidden';
+        message: string;
+        count: number | null;
+    }>[];
+    roles: Readonly<{
+        added: number;
+        updated: number;
+    }>;
+    views: Readonly<{
+        added: number;
+        updated: number;
+    }>;
+    extensions: number;
+    screens: boolean;
+}>;

package/dist/types/cms-contract/src/views.d.ts

@@ -0,0 +1,21 @@
+/** ビューで許可できる一括操作（assign: 担当者の割り当て、publish: 公開） */
+export declare const VIEW_ACTIONS: readonly ["assign", "publish"];
+/** ビューで許可できる一括操作 */
+export type ViewAction = (typeof VIEW_ACTIONS)[number];
+/** ビューの内容（filters は列の id ごとの絞り込みの値、query は検索の文、columns は表示する列、editable は一覧で編集する列） */
+export type ViewDefinition = Readonly<{
+    filters: Readonly<Record<string, string>>;
+    query: string;
+    columns: readonly string[];
+    editable: readonly string[];
+    actions: readonly ViewAction[];
+}>;
+/** 保存したビュー（owner がなければチームのビュー、roles は見られるロールの ID で空はすべて） */
+export type SavedView = Readonly<{
+    id: string;
+    owner: string | null;
+    type: string;
+    label: string;
+    definition: ViewDefinition;
+    roles: readonly string[];
+}>;

package/dist/types/cms-contract/src/webhooks.d.ts

@@ -0,0 +1,45 @@
+/** 送れる操作（レビューの依頼・公開・非公開・差し戻し） */
+export declare const WEBHOOK_ACTIONS: readonly ["submitted", "published", "unpublished", "rejected"];
+/** 送れる操作 */
+export type WebhookAction = (typeof WEBHOOK_ACTIONS)[number];
+/** 送れる出来事（編集機能を持つ型の <型の id>.<操作> と、拡張機能が宣言した出来事） */
+export type WebhookEvent = `${string}.${string}`;
+/** 操作の表示名（画面の選択肢と、Slack の文） */
+export declare const WEBHOOK_ACTION_LABELS: Readonly<Record<WebhookAction, string>>;
+/** 型と操作の出来事 */
+export declare const webhookEventOf: (type: string, action: WebhookAction) => WebhookEvent;
+/** 出来事の型と操作（形が不正なら null） */
+export declare function parseWebhookEvent(event: string): Readonly<{
+    type: string;
+    action: WebhookAction;
+}> | null;
+/** 出来事の表示名（types は型の id と表示名で型の表示名と操作の表示名、moduleEvents は拡張機能の出来事の表示名） */
+export declare function webhookEventLabel(event: string, types: Readonly<Record<string, string>>, moduleEvents?: Readonly<Record<string, string>>): string;
+/** Webhook の形式 */
+export type WebhookKind = 'json' | 'slack';
+/** Webhook（url・secret は末尾だけを伏せずに返す、secret の null は署名なし、lastStatus は最新の送信で返った HTTP の状態、送れなかったときは0） */
+export type Webhook = Readonly<{
+    id: string;
+    label: string;
+    kind: WebhookKind;
+    url: string;
+    secret: string | null;
+    events: readonly WebhookEvent[];
+    enabled: boolean;
+    lastStatus: number | null;
+    lastAt: string | null;
+}>;
+/**
+ * json の形式の本文（編集機能を持つ型の出来事、署名はヘッダー x-cms-signature で登録ごとの鍵）
+ * - item: 行の ID と題、by: 操作した人の表示名、at: 送信の日時（ISO 8601）
+ */
+export type WebhookBody = Readonly<{
+    event: WebhookEvent;
+    type: string;
+    item: Readonly<{
+        id: string;
+        title: string;
+    }>;
+    by: string;
+    at: string;
+}>;