@ryusenkei/maezae 0.2.0 → 0.3.0

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

@@ -0,0 +1,56 @@
+/** 外の画面を表示する位置（編集画面のパネル） */
+export declare const EMBED_PLACEMENTS: readonly ["panel"];
+/** 外の画面を表示する位置 */
+export type EmbedPlacement = (typeof EMBED_PLACEMENTS)[number];
+/** 外の画面の登録（secret は末尾だけを伏せずに返す） */
+export type ExternalScreen = Readonly<{
+    id: string;
+    label: string;
+    type: string;
+    url: string;
+    placement: EmbedPlacement;
+    secret: string;
+    enabled: boolean;
+}>;
+/** 編集画面に置く外の画面（鍵なし、編集できるアカウントに返す） */
+export type EmbedEntry = Readonly<{
+    id: string;
+    label: string;
+    url: string;
+    placement: EmbedPlacement;
+}>;
+/** 署名つきの文脈の内容（id は行の ID で新規は null、origin は管理画面のオリジン） */
+export type EmbedContext = Readonly<{
+    tenant: string;
+    account: Readonly<{
+        id: string;
+        role: string;
+    }>;
+    type: string;
+    id: string | null;
+    origin: string;
+}>;
+/** URL のクエリの名前（署名つきの文脈） */
+export declare const EMBED_CONTEXT_PARAM = "ctx";
+/** 文脈の有効期間（秒） */
+export declare const EMBED_CONTEXT_TTL_SEC = 600;
+/** postMessage の種類 */
+export declare const EMBED_MESSAGES: {
+    readonly ready: "maezae:ready";
+    readonly values: "maezae:values";
+    readonly set: "maezae:set";
+    readonly height: "maezae:height";
+};
+/** 外の画面と管理画面の間のメッセージ */
+export type EmbedMessage = Readonly<{
+    type: typeof EMBED_MESSAGES.ready;
+}> | Readonly<{
+    type: typeof EMBED_MESSAGES.values;
+    values: Readonly<Record<string, unknown>>;
+}> | Readonly<{
+    type: typeof EMBED_MESSAGES.set;
+    values: Readonly<Record<string, unknown>>;
+}> | Readonly<{
+    type: typeof EMBED_MESSAGES.height;
+    height: number;
+}>;

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

@@ -0,0 +1,22 @@
+import { type ErrorCode, type ErrorParams, type ErrorTarget } from './errors.js';
+/** コアの対象の表示名（エラーの文と操作の履歴で共通、モジュールの対象は ModuleManifest の targets） */
+export declare const TARGET_LABELS: Record<ErrorTarget, string>;
+/** 型の id・マスタの種類からエラーの対象（対象の一覧になければ fallback） */
+export declare const targetOf: (id: string, fallback: ErrorTarget) => ErrorTarget;
+/**
+ * 対象ごとの文の追加（モジュールの manifest の messages、キーは対象の id）
+ * - own: 自分のものだけを操作できるときの文
+ * - noLink: 結び付くエントリーがないアカウントの文、{name} は結び付くコンテンツタイプの表示名
+ */
+export type TargetMessages = Readonly<{
+    own?: Readonly<Record<string, string>>;
+    noLink?: Readonly<Record<string, string>>;
+}>;
+/** エラーの文（targets は対象の表示名、messages は対象ごとの文の追加、サーバーはモジュールの対象と文を含めた表） */
+export declare const errorLabel: (code: ErrorCode, params?: ErrorParams, targets?: Readonly<Record<string, string>>, messages?: TargetMessages) => string;
+/** モジュールの対象ごとの文をまとめる（同じ対象はあとのモジュールの文） */
+export declare const mergeMessages: (list: readonly (TargetMessages | undefined)[]) => TargetMessages;
+/** エラーのトーストの見出し（項目ごとの理由がすべて未入力なら必須項目のエラー、スキーマの文は「〜が未入力」で統一） */
+export declare const errorTitle: (code: ErrorCode, issues?: readonly {
+    message: string;
+}[]) => string;

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

@@ -0,0 +1,97 @@
+/** 変更の操作で受け付ける本文の大きさ（/api、バイト数、multipart のアップロードは ASSET_SIZE_MAX） */
+export declare const JSON_BODY_MAX: number;
+/** エラーのコードと HTTP の状態 */
+export declare const ERROR_STATUS: {
+    readonly invalid_input: 400;
+    readonly submit_unmet: 400;
+    readonly publish_unmet: 400;
+    readonly save_unmet: 403;
+    readonly version_required: 400;
+    readonly file_required: 400;
+    readonly file_too_large: 400;
+    readonly unsupported_image: 400;
+    readonly invalid_dimensions: 400;
+    readonly https_required: 400;
+    readonly invalid_style: 400;
+    readonly login_required: 401;
+    readonly invalid_mcp_token: 401;
+    readonly preview_token_required: 401;
+    readonly api_key_required: 401;
+    readonly invalid_api_key: 401;
+    readonly account_not_found: 403;
+    readonly invalid_preview_token: 403;
+    readonly mcp_not_allowed: 403;
+    readonly admin_only: 403;
+    readonly forbidden: 403;
+    readonly editorial_only: 403;
+    readonly no_linked_entry: 403;
+    readonly own_only: 403;
+    readonly not_visible: 403;
+    readonly published_admin_only: 403;
+    readonly cannot_remove_self: 403;
+    readonly cannot_change_owner: 403;
+    readonly not_found: 404;
+    readonly read_only: 405;
+    readonly in_use: 409;
+    readonly duplicate_name: 409;
+    readonly duplicate_email: 409;
+    readonly duplicate_id: 409;
+    readonly version_conflict: 409;
+    readonly article_editing: 409;
+    readonly invalid_state: 409;
+    readonly unpublish_first: 409;
+    readonly body_too_large: 413;
+    readonly rate_limited: 429;
+    readonly upstream_failed: 502;
+    readonly not_configured: 503;
+    readonly unavailable: 503;
+    readonly job_failed: 500;
+    readonly internal_error: 500;
+    readonly network_error: 0;
+};
+/** エラーのコード（network_error は画面の側だけ、通信の失敗と JSON でない応答） */
+export type ErrorCode = keyof typeof ERROR_STATUS;
+/**
+ * コアの操作や表示の対象（not_found・own_only などの params.target）
+ * - 型の対象: 型の id、表示名はスキーマ
+ * - モジュールの対象: ModuleManifest の targets
+ */
+export type ErrorTarget = 'request' | 'role' | 'media' | 'entry' | 'asset' | 'mcp' | 'version' | 'profile' | 'portrait' | 'extension' | 'account' | 'comment' | 'view' | 'webhook' | 'external_function' | 'external_screen' | 'api_key';
+/** エラーの補足の値（コードごとに使用する項目だけ） */
+export type ErrorParams = {
+    /**
+     * 対象: not_found・own_only・forbidden・not_visible・no_linked_entry・editorial_only
+     * - 文字列: モジュールの対象・コンテンツタイプの id
+     */
+    target?: ErrorTarget | (string & {});
+    /** 件数: in_use */
+    count?: number;
+    /** 使用先: in_use */
+    by?: 'uses' | 'places' | 'outputs' | 'entry' | 'writers' | 'members' | 'accounts';
+    /** 状態の不一致の理由: invalid_state */
+    reason?: 'not_draft' | 'not_in_review' | 'request_handled' | 'deleted' | 'not_deleted' | 'schema_confirm' | 'no_publishing' | 'no_review';
+    /** 取得の対象: upstream_failed */
+    resource?: 'page' | 'image' | 'webhook';
+    /**
+     * 名前
+     * - no_linked_entry: 結び付くコンテンツタイプの表示名、account_not_found: メールアドレス
+     * - not_configured: 設定の名前、job_failed: 失敗の理由、in_use の entry: 参照する型と項目
+     */
+    name?: string;
+};
+/**
+ * エラーの応答の本文
+ * - login: ログインなしのとき、CMS 自身が受け持つログインの入り口
+ * - requestId: 5xx の相関の ID（問い合わせのときにログと突き合わせ）
+ */
+export type ErrorBody = {
+    code: ErrorCode;
+    params?: ErrorParams;
+    issues?: {
+        path: string;
+        message: string;
+    }[];
+    login?: string;
+    requestId?: string;
+    error: string;
+};

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;