@ryusenkei/maezae 0.16.0 → 0.18.0

package/dist/types/body/src/types.d.ts

@@ -1,16 +1,30 @@
-/** インラインの装飾（strong・em・code・s・mark・sup・sub） */
-export type Mark = 'strong' | 'em' | 'code' | 'strike' | 'mark' | 'sup' | 'sub';
-/** リンク（HTML の a の href・title・rel） */
+/** インラインの装飾（strong・em・code・s・mark・sup・sub・u） */
+export type Mark = 'strong' | 'em' | 'code' | 'strike' | 'mark' | 'sup' | 'sub' | 'underline';
+/** リンク（HTML の a の href・title・rel、target は別のタブ） */
 export type Link = Readonly<{
     href: string;
     title?: string;
     rel?: string;
+    target?: '_blank';
 }>;
-/** 装飾・リンクつきの文字列 */
+/** 名前のついた値（name は本文の設定で宣言した名前、value は元の CSS の値、どちらか1つ以上） */
+export type Named = Readonly<{
+    name?: string;
+    value?: string;
+}>;
+/** 文字の見た目（styles は本文の設定で宣言した名前のついた装飾、例: microCMS のカスタム class） */
+export type TextStyle = Readonly<{
+    color?: Named;
+    background?: Named;
+    size?: Named;
+    styles?: readonly string[];
+}>;
+/** 装飾・リンク・見た目つきの文字列 */
 export type Text = Readonly<{
     text: string;
     marks?: readonly Mark[];
     link?: Link;
+    style?: TextStyle;
 }>;
 /** インラインのコンポーネント（例: 注、属性は文字列だけ、text は中の文字） */
 export type InlineComponent = Readonly<{
@@ -24,6 +38,20 @@ export type Inline = string | Text | InlineComponent;
 export type Rich = readonly Inline[];
 /** 見出しの段階 */
 export type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+/** 揃え（段落・見出し・表のセル） */
+export type Align = 'left' | 'center' | 'right' | 'justify';
+/** 画像の横の位置 */
+export type ImageAlign = 'left' | 'center' | 'right';
+/** 属性つきの表のセル（content はセルの中の段落、header は見出しのセル、colspan・rowspan は結合） */
+export type TableCell = Readonly<{
+    content: readonly Rich[];
+    header?: boolean;
+    colspan?: number;
+    rowspan?: number;
+    align?: Align;
+}>;
+/** 表のセル（断片の列だけのセルか、属性つきのセル） */
+export type Cell = Rich | TableCell;
 /** リストの1項目（children は入れ子のリスト） */
 export type ListItem = Readonly<{
     content: Rich;
@@ -40,12 +68,14 @@ export type List = Readonly<{
 export type StandardBlock<M> = Readonly<{
     type: 'paragraph';
     content: Rich;
+    align?: Align;
     variant?: string;
 }> | Readonly<{
     type: 'heading';
     level: HeadingLevel;
     content: Rich;
     id?: string;
+    align?: Align;
     variant?: string;
 }> | List | Readonly<{
     type: 'quote';
@@ -60,19 +90,26 @@ export type StandardBlock<M> = Readonly<{
     code: string;
     lang?: string;
     caption?: string;
+    filename?: string;
     variant?: string;
 }> | Readonly<{
     type: 'image';
     media: M;
     alt?: string;
     caption?: string;
+    link?: Link;
+    align?: ImageAlign;
     variant?: string;
 }> | Readonly<{
     type: 'table';
     head?: readonly Rich[];
-    rows: readonly (readonly Rich[])[];
+    rows: readonly (readonly Cell[])[];
     caption?: string;
     variant?: string;
+}> | Readonly<{
+    type: 'file';
+    media: M;
+    label?: string;
 }> | Readonly<{
     type: 'divider';
 }> | Readonly<{
@@ -89,3 +126,7 @@ export type ComponentBlock = Readonly<{
 export type Block<M> = StandardBlock<M> | ComponentBlock;
 /** 本文 */
 export type Body<M> = readonly Block<M>[];
+/** 属性つきのセルか */
+export declare const isTableCell: (cell: Cell) => cell is TableCell;
+/** セルの中の段落（断片の列だけのセルは1段落） */
+export declare const cellParagraphs: (cell: Cell) => readonly Rich[];

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

@@ -1,7 +1,29 @@
+/** 鍵の種類 */
+export declare const API_KEY_KINDS: readonly ["server"];
+/** 鍵の種類 */
+export type ApiKeyKind = (typeof API_KEY_KINDS)[number];
+/** 鍵の操作 */
+export declare const API_KEY_OPERATIONS: readonly ["read", "read_drafts", "create", "update", "publish", "delete"];
+/** 鍵の操作 */
+export type ApiKeyOperation = (typeof API_KEY_OPERATIONS)[number];
+/** 書き込みの操作（書き込みの API（#500）まで画面で選べない） */
+export declare const API_KEY_WRITE_OPERATIONS: readonly ["create", "update", "publish", "delete"];
+/** 権限のキーで、すべての型（後から足す型を含む） */
+export declare const API_KEY_ALL_TYPES = "*";
+/** 鍵の権限（キーは型の id か API_KEY_ALL_TYPES） */
+export type ApiKeyPermissions = Readonly<Record<string, readonly ApiKeyOperation[]>>;
+/** 権限を省略した鍵と既存の鍵の権限 */
+export declare const DEFAULT_API_KEY_PERMISSIONS: {
+    readonly "*": readonly ["read"];
+};
+/** 鍵の権限が型の操作を許すか（read は read_drafts でも満たす） */
+export declare function apiKeyAllows(permissions: ApiKeyPermissions, type: string, operation: ApiKeyOperation): boolean;
 /** 一覧に表示する API の鍵（tail は鍵の末尾、revokedAt は失効の日時で有効なら null） */
 export type ApiKey = Readonly<{
     id: string;
     label: string;
+    kind: ApiKeyKind;
+    permissions: ApiKeyPermissions;
     tail: string;
     createdAt: string;
     revokedAt: string | null;
@@ -11,3 +33,8 @@ export declare const API_KEY_RATE: {
     readonly limit: 600;
     readonly period: 60;
 };
+/** 公開のエンドポイントで鍵や媒体の照合に失敗した要求の、接続元の IP ごとの上限（period 秒で limit 回、超えた IP は照合の前に429、platform#45） */
+export declare const PUBLIC_FAILURE_RATE: {
+    readonly limit: 30;
+    readonly period: 60;
+};

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

@@ -8,3 +8,5 @@ export declare const ASSET_BULK_MAX = 500;
 export declare const ASSET_IMAGE_TYPES: readonly ["image/jpeg", "image/png", "image/webp", "image/gif"];
 /** 画像1枚の大きさの上限（バイト、アップロード・取り込みで共通） */
 export declare const ASSET_SIZE_MAX: number;
+/** ファイルの実体の大きさの上限（バイト、本文の中のファイルの取り込み） */
+export declare const ASSET_FILE_SIZE_MAX: number;

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

@@ -10,6 +10,7 @@ export declare const ERROR_STATUS: {
     readonly file_required: 400;
     readonly file_too_large: 400;
     readonly unsupported_image: 400;
+    readonly unsupported_file: 400;
     readonly invalid_dimensions: 400;
     readonly https_required: 400;
     readonly invalid_style: 400;
@@ -20,6 +21,7 @@ export declare const ERROR_STATUS: {
     readonly invalid_api_key: 401;
     readonly account_not_found: 403;
     readonly invalid_preview_token: 403;
+    readonly api_key_forbidden: 403;
     readonly mcp_not_allowed: 403;
     readonly admin_only: 403;
     readonly forbidden: 403;
@@ -62,7 +64,7 @@ export type ErrorTarget = 'request' | 'role' | 'media' | 'entry' | 'asset' | 'mc
 /** エラーの補足の値（コードごとに使用する項目だけ） */
 export type ErrorParams = {
     /**
-     * 対象: not_found・own_only・forbidden・not_visible・no_linked_entry・editorial_only
+     * 対象: not_found・own_only・forbidden・not_visible・no_linked_entry・editorial_only・api_key_forbidden
      * - 文字列: モジュールの対象・コンテンツタイプの id
      */
     target?: ErrorTarget | (string & {});
@@ -71,9 +73,9 @@ export type ErrorParams = {
     /** 使用先: in_use */
     by?: 'uses' | 'places' | 'outputs' | 'entry' | 'writers' | 'members' | 'accounts';
     /** 状態の不一致の理由: invalid_state */
-    reason?: 'not_draft' | 'no_draft' | 'not_in_review' | 'request_handled' | 'deleted' | 'not_deleted' | 'schema_confirm' | 'no_publishing' | 'no_review';
+    reason?: 'not_draft' | 'no_draft' | 'not_in_review' | 'request_handled' | 'deleted' | 'not_deleted' | 'schema_confirm' | 'no_publishing' | 'no_review' | 'not_published';
     /** 取得の対象: upstream_failed */
-    resource?: 'page' | 'image' | 'webhook';
+    resource?: 'page' | 'image' | 'webhook' | 'microcms' | 'file';
     /**
      * 名前
      * - no_linked_entry: 結び付くコンテンツタイプの表示名、account_not_found: メールアドレス

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

@@ -36,7 +36,7 @@ export type ImportItemReport = Readonly<{
     source: string;
     type: string;
     id: string | null;
-    status: 'created' | 'ready' | 'skipped';
+    status: 'created' | 'updated' | 'ready' | 'skipped';
     problems: readonly ImportProblem[];
 }>;
 /** 画像の結果（checked は試しの実行で取得できた、asset は保存した画像の ID） */
@@ -71,6 +71,7 @@ export type ImportReport = Readonly<{
     summary: Readonly<{
         items: number;
         created: number;
+        updated: number;
         ready: number;
         skipped: number;
         images: Readonly<Record<ImportImage['status'], number>>;
@@ -99,3 +100,34 @@ export declare const sourceOf: (item: ImportItem, index: number) => string;
 export declare function importReportOf(dryRun: boolean, parts: Omit<ImportReport, 'dryRun' | 'summary'>): ImportReport;
 /** 分けて送った取り込みの報告を1つに（同じ URL の画像は先の結果） */
 export declare function mergeImportReports(dryRun: boolean, reports: readonly ImportReport[], extra?: Partial<Omit<ImportReport, 'dryRun' | 'summary'>>): ImportReport;
+/** microCMS から取り込む API（schema は API のスキーマの JSON、relations は関係の項目の fieldId と先のエンドポイント） */
+export type MicroCmsApiInput = Readonly<{
+    endpoint: string;
+    label: string;
+    format: 'list' | 'object';
+    schema: unknown;
+    relations: Readonly<Record<string, string>>;
+    privateMedia?: boolean;
+}>;
+/** microCMS の型の変換の注意（path は型の id と項目） */
+export type MicroCmsNote = Readonly<{
+    level: 'error' | 'warning';
+    path: string;
+    message: string;
+}>;
+/** 本文の変換で捨てたもの（what は要素・属性・style の項目・class） */
+export type MicroCmsDropped = Readonly<{
+    what: string;
+    count: number;
+}>;
+/** microCMS のコンテンツの1ページの取り込みの結果（next は次のページの offset、なしは終わり、tooLarge は大きすぎて残さなかった元の HTML） */
+export type MicroCmsContentResult = Readonly<{
+    report: ImportReport;
+    total: number;
+    next: number | null;
+    dropped: readonly MicroCmsDropped[];
+    tooLarge: readonly Readonly<{
+        id: string;
+        field: string;
+    }>[];
+}>;

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

@@ -1,21 +1,22 @@
-export { API_KEY_RATE, type ApiKey } from './apiKeys.js';
-export { ASSET_BULK_MAX, ASSET_IMAGE_TYPES, ASSET_SIZE_MAX } from './assets.js';
+export { API_KEY_ALL_TYPES, API_KEY_KINDS, API_KEY_OPERATIONS, API_KEY_RATE, API_KEY_WRITE_OPERATIONS, PUBLIC_FAILURE_RATE, apiKeyAllows, type ApiKey, type ApiKeyKind, type ApiKeyOperation, type ApiKeyPermissions, DEFAULT_API_KEY_PERMISSIONS } from './apiKeys.js';
+export { ASSET_BULK_MAX, ASSET_FILE_SIZE_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 { CHANGES_LABELS, 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 { ADMIN_PERMISSIONS, ADMIN_ROLE, defaultRoleOf, 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 { IMPORT_ITEMS_MAX, IMPORT_PROBLEM_LABELS, IMPORT_PROBLEMS, type ImportIdChange, type ImportIdConflict, importIdOf, type ImportIdPlan, type ImportImage, type ImportItem, type ImportItemReport, type ImportProblem, type ImportProblemCode, type ImportReport, importReportOf, mergeImportReports, planImportIds, sourceOf } from './import.js';
+export { IMPORT_ITEMS_MAX, IMPORT_PROBLEM_LABELS, IMPORT_PROBLEMS, type ImportIdChange, type ImportIdConflict, importIdOf, type ImportIdPlan, type ImportImage, type ImportItem, type ImportItemReport, type ImportProblem, type ImportProblemCode, type ImportReport, importReportOf, mergeImportReports, type MicroCmsApiInput, type MicroCmsContentResult, type MicroCmsDropped, type MicroCmsNote, planImportIds, sourceOf } from './import.js';
 export { EMBED_CONTEXT_NEXT_PARAM, 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 { isWebhookAction, parseWebhookEvent, type Webhook, WEBHOOK_ACTION_LABELS, type WebhookBody, WEBHOOK_ACTIONS, type WebhookAction, type WebhookDelivery, type WebhookEvent, webhookEventLabel, webhookEventOf, type WebhookKind, type WebhookModuleBody, type WebhookSubscription, webhookSubscriptionLabel, WEBHOOK_VERSION, type WebhookVersion } from './webhooks.js';
 export { CONTRACT_VERSION_HEADER, DELIVERY_VERSION } from './versions.js';
 export { type SavedView, VIEW_ACTIONS, type ViewAction, type ViewDefinition } from './views.js';
+export { ENTRY_ACTIONS, ENTRY_STATES, type EntryAction, entryActions, type EntryChanges, entryGuard, type EntryGuard, type EntryGuardInput, type EntryRow, type EntryState, entryStateOf, isLiveState, type WorkflowPublishing } from './workflow.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

@@ -4,3 +4,8 @@ export declare const STATUS: {
     readonly review: "レビュー待ち";
     readonly published: "公開済み";
 };
+/** 公開中・予約の行の未公開の変更（#596） */
+export declare const CHANGES_LABELS: {
+    readonly draft: "未公開の変更あり";
+    readonly review: "変更のレビュー待ち";
+};

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

@@ -1,7 +1,7 @@
 import { type AccountLink, type Permissions } from './permissions.js';
 /** 管理者のロールの ID */
 export declare const ADMIN_ROLE = "admin";
-/** ライターのロールの ID（新しいアカウントの既定・MCP の権限） */
+/** ライターのロールの ID（あれば新しいアカウントの既定、削除できる） */
 export declare const WRITER_ROLE = "writer";
 /** 管理者の権限の表（すべての対象・操作が可、DB の値より優先） */
 export declare const ADMIN_PERMISSIONS: Permissions;
@@ -9,6 +9,8 @@ export declare const ADMIN_PERMISSIONS: Permissions;
 export declare const rolePermissionsOf: (roleId: string, stored: Permissions) => Permissions;
 /** 削除できないロールの ID */
 export declare const SYSTEM_ROLES: readonly string[];
+/** 新しいアカウントの既定のロール（ライター、なければ管理者以外の最初のロール、それもなければ管理者） */
+export declare const defaultRoleOf: (roles: readonly Pick<Role, "id">[]) => string;
 /** ロール（API /api/roles の行） */
 export type Role = Readonly<{
     id: string;

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

@@ -1,5 +1,5 @@
-/** ビューで許可できる一括操作（assign: 担当者の割り当て、publish: 公開） */
-export declare const VIEW_ACTIONS: readonly ["assign", "publish"];
+/** ビューで許可できる一括操作（名前は行の操作 workflow.ts の EntryAction と同じ、assign は担当者の割り当て） */
+export declare const VIEW_ACTIONS: readonly ["assign", "submit", "publish", "unpublish", "delete"];
 /** ビューで許可できる一括操作 */
 export type ViewAction = (typeof VIEW_ACTIONS)[number];
 /** ビューの内容（filters は列の id ごとの絞り込みの値、query は検索の文、columns は表示する列、editable は一覧で編集する列） */

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

@@ -0,0 +1,49 @@
+import type { ErrorCode, ErrorParams } from './errors.js';
+import { type ContentAccess } from './permissions.js';
+import type { User } from './roles.js';
+/** 型の公開の管理（model の Publishing と同じ値） */
+export type WorkflowPublishing = 'none' | 'draft' | 'review';
+/** 行の派生の状態 */
+export declare const ENTRY_STATES: readonly ["draft", "returned", "review", "scheduled", "published"];
+export type EntryState = (typeof ENTRY_STATES)[number];
+/** 公開中・予約の行の未公開の変更（none はなし、review はレビュー待ち） */
+export type EntryChanges = 'none' | 'draft' | 'review';
+/** 行の操作（publish は公開・予約・再公開・変更の公開、unpublish は下書きに戻す・予約の取り消し、discard は未公開の変更の破棄） */
+export declare const ENTRY_ACTIONS: readonly ["save", "submit", "reject", "publish", "unpublish", "discard", "delete", "assign"];
+export type EntryAction = (typeof ENTRY_ACTIONS)[number];
+/** 判定に使う行の値（API の形: has_draft・draft_status は未公開の変更、持ち主の項目と created_by を含む） */
+export type EntryRow = ContentAccess & Readonly<{
+    published_at?: unknown;
+    review_note?: unknown;
+    has_draft?: unknown;
+    draft_status?: unknown;
+}>;
+type Subject = Pick<User, 'permissions' | 'id' | 'entryId' | 'link'>;
+/** 判定の材料（target は型の id、now は ISO の日時） */
+export type EntryGuardInput = Readonly<{
+    publishing: WorkflowPublishing;
+    user: Subject;
+    target: string;
+    row: EntryRow;
+    now: string;
+}>;
+/** 判定の結果（拒否はエラーのコードと引数） */
+export type EntryGuard = {
+    ok: true;
+} | {
+    ok: false;
+    code: Exclude<ErrorCode, 'network_error'>;
+    params?: ErrorParams;
+};
+/** 行の派生の状態と未公開の変更 */
+export declare function entryStateOf(row: EntryRow, now: string): {
+    state: EntryState;
+    changes: EntryChanges;
+};
+/** 公開中か予約の状態か */
+export declare const isLiveState: (state: EntryState) => boolean;
+/** 行の操作の可否 */
+export declare function entryGuard({ publishing, user, target, row, now }: EntryGuardInput, action: EntryAction): EntryGuard;
+/** 行に許される操作（ENTRY_ACTIONS の順） */
+export declare const entryActions: (input: EntryGuardInput) => EntryAction[];
+export {};

package/dist/types/model/src/asset.d.ts

@@ -25,7 +25,7 @@ export type LocalImage = Readonly<{
     height: number;
     format: string;
 }>;
-/** 実体の共通の項目（ID は UUID で R2 のキーと同じ、sha256 は内容のハッシュで同じ画像の重複を防止、ファイル名は保存しない） */
+/** 実体の共通の項目（ID は UUID で R2 のキーと同じ、sha256 は内容のハッシュで同じ画像の重複を防止、visibility は非公開の実体だけ private） */
 type AssetBase = Readonly<{
     id: string;
     mimeType: string;
@@ -37,6 +37,7 @@ type AssetBase = Readonly<{
     hotspot?: Hotspot;
     crop?: Crop;
     createdAt: string;
+    visibility?: 'private';
 }>;
 /** 画像の実体（Sanity の sanity.imageAsset、代替テキストと hotspot は画像ごとに1つ） */
 export type ImageAsset = AssetBase & Readonly<{
@@ -48,8 +49,13 @@ export type VideoAsset = AssetBase & Readonly<{
     duration?: number;
     poster?: string;
 }>;
+/** ファイルの実体（本文の中のファイル、name は元のファイル名、寸法は0） */
+export type FileAsset = AssetBase & Readonly<{
+    kind: 'file';
+    name?: string;
+}>;
 /** 実体（CMS のメディアにある1件） */
-export type Asset = ImageAsset | VideoAsset;
+export type Asset = ImageAsset | VideoAsset | FileAsset;
 /** 使用する側が保存する実体の参照（Sanity の image の asset、表示のときに実体の寸法・代替テキスト・hotspot を合わせて Media に解決） */
 export type AssetRef = Readonly<{
     asset: string;

package/dist/types/model/src/index.d.ts

@@ -2,13 +2,13 @@ export { fieldZod, jsonSchemaOf, normalizeValues, zodOf, type ValueOptions } fro
 export { assetRefSchema, cropSchema, hotspotSchema, mediaSchema, type Asset, type AssetRef, type Crop, type Hotspot, type LocalImage, type Media } from './asset.js';
 export { coverPosition, coverStart, cropRect, croppedHotspot, objectPosition, stillOf, type CropRect } from './image.js';
 export { IMAGE_TYPE, VIDEO_TYPE } from './media.js';
-export { IMAGE_SIZE_MAX, imageParamsOf, mediaExtOf, mediaMimeOf, mediaPathOf, parseMediaPath, withImageParams, type ImageParams, type MediaPath } from './mediaUrl.js';
+export { IMAGE_SIZE_MAX, imageParamsOf, MEDIA_SIGNING_KEY_BLOB, mediaBlobKeyOf, mediaExtOf, mediaKindOf, mediaMimeOf, mediaPathOf, parseMediaPath, signMediaUrl, verifyMediaUrl, withImageParams, type ImageParams, type AssetKind, type MediaPath } from './mediaUrl.js';
 export { diffSchema, renameType, type ChangeKind, type ChangeLevel, type DiffOptions, type SchemaChange } from './changes.js';
 export { dateRoleFieldsOf, primaryTypeOf, requiredPrimaryTypeOf, SOURCES_FIELD, sourceIdsOf, sourcesFieldOf, sourceTypeOf, type SourcesField } from './capabilities.js';
 export { appliesTo, checkFields, fieldsFor } from './check.js';
 export { deliveredFields, emptyValues, pickValues, referencedIds, referencesOf, valueFieldsOf } from './values.js';
 export { entryRefsOf, type EntryRef } from './refs.js';
-export { acceptsRole, bodyFieldsOf, computedFieldsOf, FIELD_ROLES, idInputOf, initialValueOf, isEditorial, isInputField, isListType, isMediaType, isSingleton, isStoredType, MEDIA_TYPE_IDS, optionLabelOf, optionsOf, publishingOf, requestReferencesOf, resolvedRolesOf, roleFieldOf, toneOf, typeOf, type ComputedKind, type FieldRole, type FieldRoles, type FieldComputed, type ContentFormat, type ContentModel, type ContentType, type FieldCondition, type FieldDef, type FieldDerive, type FieldFixedBy, type CountDef, type FieldProblem, type MediaKind, type OptionTone, type Publishing, type ReferenceRules, type SelectOption } from './model.js';
+export { acceptsRole, bodyFieldsOf, computedFieldsOf, FIELD_ROLES, idInputOf, initialValueOf, isEditorial, isInputField, isListType, isMediaType, isSingleton, isStoredType, MEDIA_TYPE_IDS, optionLabelOf, optionsOf, publishingOf, requestReferencesOf, resolvedRolesOf, roleFieldOf, toneOf, typeOf, type ComputedKind, type FieldRole, type FieldRoles, type FieldComputed, type ContentFormat, type ContentModel, type ContentType, type FieldCondition, type FieldDef, type FieldDerive, type FieldFixedBy, type CountDef, type FieldProblem, type MediaKind, type OptionTone, type Publishing, type ReferenceRules, type SelectOption, usesReview } from './model.js';
 export { hasPublicPage, imageFrameOf, pagePathOf, publicPathOf, withPagesFrom, type ImageFrame, type ImageFrameDef, type PageDef, type PageEntry, type PageRule } from './page.js';
 export { schemaRulesOf, type SchemaRule } from './rules.js';
 export { parseModel } from './schema.js';

package/dist/types/model/src/mediaUrl.d.ts

@@ -1,11 +1,15 @@
 import type { CropRect } from './image.js';
+/** 実体の種類 */
+export type AssetKind = 'image' | 'video' | 'file';
+/** 形式の実体の種類 */
+export declare const mediaKindOf: (mimeType: string) => AssetKind;
 /** 形式の拡張子（配信しない形式は null） */
 export declare const mediaExtOf: (mimeType: string) => string | null;
 /** 拡張子の形式（配信しない拡張子は null） */
 export declare const mediaMimeOf: (ext: string) => string | null;
 /** 配信 URL のパスの要素（寸法は画像だけ） */
 export type MediaPath = Readonly<{
-    kind: 'image' | 'video';
+    kind: AssetKind;
     project: string;
     id: string;
     ext: string;
@@ -14,7 +18,7 @@ export type MediaPath = Readonly<{
 }>;
 /** 配信 URL のパス（媒体・ID の形が不正、配信しない形式なら null） */
 export declare function mediaPathOf({ kind, project, id, mimeType, width, height }: Readonly<{
-    kind: 'image' | 'video';
+    kind: AssetKind;
     project: string;
     id: string;
     mimeType: string;
@@ -23,6 +27,20 @@ export declare function mediaPathOf({ kind, project, id, mimeType, width, height
 }>): string | null;
 /** 配信 URL のパスを解析（形が違えば null） */
 export declare function parseMediaPath(pathname: string): MediaPath | null;
+/** 保存先のキー（媒体の接頭辞の後、非公開は private/ の下） */
+export declare const mediaBlobKeyOf: (id: string, visibility: "public" | "private") => string;
+/** 非公開のメディアの署名の鍵の保存先のキー（媒体の接頭辞の後、配信 URL の ID の形にない「.」で始め、パスから届かない） */
+export declare const MEDIA_SIGNING_KEY_BLOB = ".media-signing";
+/**
+ * 非公開のメディアの署名つきの URL（exp と sig のクエリを付ける、ほかのクエリは残す）
+ * - secret: 媒体の非公開のメディアの署名の鍵、expiresInSec: 期限までの秒、now: 今の UNIX ミリ秒
+ */
+export declare function signMediaUrl(url: string, secret: string, options?: Readonly<{
+    expiresInSec?: number;
+    now?: number;
+}>): Promise<string>;
+/** 署名つきの URL の検査（期限の内で、どれかの鍵の署名と一致すれば期限の UNIX 秒、ほかは null） */
+export declare function verifyMediaUrl(url: URL, secrets: readonly string[], now?: number): Promise<number | null>;
 /** 画像の変換のクエリ（w・h は表示の画素、rect は元の画像の画素での切り抜き、auto=format はブラウザに合わせた形式） */
 export type ImageParams = Readonly<{
     w?: number;

package/dist/types/model/src/model.d.ts

@@ -112,10 +112,12 @@ export type FieldDef = FieldBase & Readonly<{
     type: 'media'; /** 受け付けるメディアの種類（なしはすべて） */
     accept?: readonly MediaKind[];
     multiple?: boolean; /** 画像の枠（先頭から条件に合うもの、page.ts） */
-    frames?: readonly ImageFrameDef[];
+    frames?: readonly ImageFrameDef[]; /** 非公開のメディアだけ（アップロードと取り込みは非公開、公開の実体は保存で拒否） */
+    visibility?: 'private';
 } & Counts) | {
     type: 'body';
-    profile: BodyProfile;
+    profile: BodyProfile; /** 本文の画像とファイルは非公開のメディアだけ */
+    visibility?: 'private';
 } | ({
     type: 'group'; /** まとまりの中の項目（Sanity の object、microCMS のカスタムフィールド） */
     fields: readonly FieldDef[];
@@ -178,10 +180,16 @@ export declare const publishingOf: (type: ContentType) => Publishing;
 export declare const isListType: (type: ContentType) => boolean;
 /**
  * 編集の機能を持つ型か（公開の管理がある一覧の型）
- * - 機能: 版・楽観ロック・編集中のリース・コメント・担当者・公開の前の点検
- * - 提出と差し戻し: レビューありの型だけ
+ * - 機能: 版・楽観ロック・編集中のリース・コメント・公開の前の点検
+ * - 提出と差し戻し・担当者: レビューありの型だけ（usesReview）
  */
 export declare const isEditorial: (type: ContentType) => boolean;
+/**
+ * レビューのワークフローを持つ型か（レビューありの一覧の型）
+ * - 機能: 提出と差し戻し・担当者（レビューを担当するアカウント）
+ * - 下書きと公開の型: 担当者の表示・割り当て・一括の割り当てを出さない
+ */
+export declare const usesReview: (type: ContentType) => boolean;
 /** 型の行を表 entries に保存するか（メディアの型を除くすべて） */
 export declare const isStoredType: (type: ContentType) => boolean;
 /** コンテンツスキーマの型（id から、なければ例外: 導入先の設定の誤り） */

package/dist/types/sdk/src/body.d.ts

@@ -1,2 +1,2 @@
-export { blockSchemaOf, citesOf, DESCRIPTION_MAX, descriptionOf, excerptOf, isSafeHref, linksOf, plainOf, READING_SPEED, readMinOf } from '../../body/src/index.js';
-export type { Block, Body, BodyProfile, ComponentBlock, DeclaredComponent, HeadingLevel, Inline, InlineComponent, Link, List, ListItem, Mark, PropSchema, PropsSchema, PropType, Rich, StandardBlock, Text } from '../../body/src/index.js';
+export { blockSchemaOf, bodyToHtml, cellParagraphs, citesOf, DESCRIPTION_MAX, descriptionOf, EMBED_PROVIDERS, embedOfUrl, embedSrcOf, excerptOf, isSafeCssValue, isSafeHref, isTableCell, linksOf, plainOf, READING_SPEED, readMinOf } from '../../body/src/index.js';
+export type { Align, Block, Body, BodyProfile, Cell, ComponentBlock, DeclaredComponent, EmbedProvider, EmbedTarget, HeadingLevel, ImageAlign, Inline, InlineComponent, Link, List, ListItem, Mark, Named, NamedStyle, NamedValue, PropSchema, PropsSchema, PropType, RenderedImage, RenderOptions, Rich, StandardBlock, TableCell, Text, TextStyle } from '../../body/src/index.js';

package/dist/types/sdk/src/delivery/index.d.ts

@@ -2,7 +2,7 @@ export { cachedDelivery, memoryDeliveryCache, type DeliveryCache } from './cache
 export { readChanges, type Change, type ChangesPage } from './changes.js';
 export { createDeliveryClient, DELIVERY_PATH, DeliveryError, subPath, type BundleResult, type Delivery, type DeliveryClient, type Prefetched } from './client.js';
 export { deliveredImageUrl, mediaOf, type ImageUrl, type MediaOf } from './media.js';
-export { imageParamsOf, parseMediaPath, withImageParams, type ImageParams, type MediaPath } from '../../../model/src/index.js';
+export { imageParamsOf, parseMediaPath, signMediaUrl, withImageParams, type ImageParams, type MediaPath } from '../../../model/src/index.js';
 export type { FieldPath, Selected } from './fields.js';
 export { listParams, type ListFilter, type ListQuery, type Page } from './query.js';
 export { createDeliveryClock, fieldOf, limitOf, optionLabels, pagePath, type DeliveryClock } from './schema.js';

package/dist/types/sdk/src/delivery/values.d.ts

@@ -5,14 +5,18 @@ export type Item = Readonly<Record<string, unknown>>;
 /** 配信 API が解決した実体（url は配信 URL で配信のオリジンがある CMS だけ、hotspot・crop は元の画像に対する割合） */
 export type DeliveredAsset = Readonly<{
     id: string;
-    kind: 'image' | 'video';
+    kind: 'image' | 'video' | 'file';
     url?: string;
     width: number;
     height: number;
     alt: string;
     hotspot?: Hotspot;
     crop?: Crop;
-    poster?: DeliveredAsset | null;
+    poster?: DeliveredAsset | null; /** 非公開の実体（url は署名のない配信 URL、signMediaUrl で署名して渡す） */
+    visibility?: 'private'; /** ファイルの元のファイル名・形式・大きさ（バイト） */
+    name?: string;
+    mimeType?: string;
+    size?: number;
 }>;
 /** 項目の1つ分の値（複数の値を持つ項目は FieldValue が配列に、query.ts の絞り込みの値と共通） */
 export type SingleValue<F extends FieldDef> = F extends {

package/dist/types/sdk/src/delivery.d.ts

@@ -1,2 +1,2 @@
-export { cachedDelivery, createDeliveryClient, createDeliveryClock, deliveredImageUrl, DELIVERY_PATH, DeliveryError, fieldOf, imageParamsOf, limitOf, listParams, mediaOf, memoryDeliveryCache, optionLabels, pagePath, parseMediaPath, readChanges, subPath, withImageParams } from './delivery/index.js';
+export { cachedDelivery, createDeliveryClient, createDeliveryClock, deliveredImageUrl, DELIVERY_PATH, DeliveryError, fieldOf, imageParamsOf, limitOf, listParams, mediaOf, memoryDeliveryCache, optionLabels, pagePath, parseMediaPath, readChanges, signMediaUrl, subPath, withImageParams } from './delivery/index.js';
 export type { BundleResult, Change, ChangesPage, DeliveredAsset, Delivery, DeliveryCache, DeliveryClient, DeliveryClock, FieldValue, ImageParams, ImageUrl, Item, ItemMeta, ItemOf, FieldPath, ListFilter, ListQuery, MediaOf, MediaPath, Page, Prefetched, Selected } from './delivery/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryusenkei/maezae",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "maezae の導入先のサイト向けの SDK（配信 API の取得・本文の型・プレビューの署名・手元の開発の配信 API）",
   "license": "UNLICENSED",
   "author": "RYUSENKEI",