@im-nobsidian/core 0.13.0 → 0.14.0

package/dist/index.d.ts

@@ -483,6 +483,28 @@ interface PushResult {
     readonly schemaEdits?: readonly SchemaEdit[];
     /** 볼트에서 고친 `.base` 보기를 Notion 보기에 올린 것(ADR-046) — dry-run 이면 올릴 것. */
     readonly viewEdits?: readonly ViewEdit[];
+    /**
+     * 볼트에서 DB 폴더 안팎 · 다른 DB 폴더로 옮겨 Notion 에서 페이지 ↔ 행 · 다른 DB 의 행이 된 노트(ADR-047) — dry-run 이면
+     * 될 것. 없으면 생략.
+     */
+    readonly placementChanges?: readonly PlacementChange[];
+    /** 볼트에서 옮기거나 이름을 바꾼 DB 폴더(ADR-047) — dry-run 이면 옮길 것. 없으면 생략. */
+    readonly databaseMoves?: readonly DatabaseMove[];
+}
+/** 옮긴 DB 폴더 하나 — {@link PushResult.databaseMoves}. */
+interface DatabaseMove {
+    readonly from: string;
+    readonly to: string;
+    /** Notion 의 DB 도 옮겼나(옮기나). false 면 DB 가 볼트가 받지 않는 곳에 있어 볼트 쪽 자리만 바뀐다. dry-run 은 모른다. */
+    readonly inNotion?: boolean;
+}
+/** 옮긴 노트 하나가 Notion 에서 바뀐 자리 — {@link PushResult.placementChanges}. */
+interface PlacementChange {
+    readonly path: string;
+    /** 무엇이 되었나 — DB 의 행 · 페이지. */
+    readonly becomes: "row" | "page";
+    /** 다른 DB 에서 온 행이 대상 DB 에 더한(더할) 열 — Notion 이 값이 있는 속성을 열로 더한다. 없으면 생략. */
+    readonly addedColumns?: readonly string[];
 }
 /** 고친 `.base` 의 보기 하나가 Notion 보기에 한 일 — {@link PushResult.viewEdits}. */
 interface ViewEdit {
@@ -1494,6 +1516,11 @@ interface DatabaseMeta {
     readonly properties: Readonly<Record<string, unknown>>;
     /** 페이지 본문 안에 놓인 인라인 DB 인가. */
     readonly isInline: boolean;
+    /**
+     * DB 가 바로 아래에 놓인 페이지 — 블록(토글 · 열) 안이거나 워크스페이스 맨 위면 null. 모르면(읽지 않았으면) 없다.
+     * Notion 에서 DB 를 옮겨도 수정 시각이 그대로라, 받은 DB 의 부모로만 옮긴 것을 안다(ADR-047).
+     */
+    readonly parentPageId?: string | null;
     /** DB 의 아이콘 · 커버 · 설명 · 제목 표시 — 받은 그대로. */
     readonly appearance?: DatabaseAppearance;
 }
@@ -1665,6 +1692,31 @@ declare class NotionClient {
      * 같은 부모로 다시 옮겨도 결과가 같아 모호한 실패는 다시 보낸다.
      */
     movePage(pageId: string, parentPageId: string): Promise<void>;
+    /**
+     * 페이지 · 행을 DB 의 data source 로 옮긴다 — 같은 `pages.move`. 페이지는 행이 되고, 다른 DB 의 행은 이 DB 의
+     * 행이 된다. id · 본문 · 자식은 그대로다(2026-10-27 실측). `database_id` 부모는 400 이라 data source 로만 옮긴다.
+     * 다른 DB 에서 오면 값이 있는 속성 가운데 이 DB 에 없는 것은 Notion 이 열로 더한다(2026-10-30 실측).
+     */
+    /**
+     * DB 의 지금 자리 — 부모와 제목. 볼트에서 옮긴 DB 폴더를 Notion 에서도 옮길지 정할 때 읽는다(ADR-047). 메타 캐시를 쓰지
+     * 않는다 — 옮기기 직전의 자리여야 한다.
+     *
+     * @returns 부모가 페이지면 `pageId`, 블록(토글 · 열 안의 인라인 DB) · 워크스페이스면 null.
+     */
+    getDatabasePlacement(databaseId: string): Promise<{
+        readonly parentType: string;
+        readonly pageId: string | null;
+        readonly title: string;
+    }>;
+    /**
+     * DB 를 다른 페이지 아래로 옮기거나 제목을 바꾼다(`databases.update`). 2026-10-30 실측 — 부모를 바꾸면 200 이고 DB id ·
+     * 행 · 보기는 그대로다. 같은 요청을 다시 보내도 결과가 같다.
+     */
+    updateDatabasePlacement(databaseId: string, change: {
+        readonly parentPageId?: string;
+        readonly title?: string;
+    }): Promise<void>;
+    movePageToDataSource(pageId: string, dataSourceId: string): Promise<void>;
     /**
      * 데이터베이스 1개를 신 모델(2025-09-03 data source 분리)로 조회한다 — DB 1회 + data source 마다 1회.
      * - title · data source 목록: database 객체에 그대로 존재한다.
@@ -2615,6 +2667,8 @@ interface FolderDatabaseReport extends FolderDatabaseDraft {
     readonly folder: string;
     readonly sidecarPath: string;
     readonly rows: number;
+    /** 그중 이미 Notion 페이지로 올라간 노트 — push 가 같은 페이지째 행으로 옮긴다(ADR-047). */
+    readonly pagesToRows: number;
 }
 
 /**
@@ -2664,6 +2718,7 @@ declare class SyncOrchestrator {
     private readonly placement;
     private readonly databaseCreator;
     private readonly planner;
+    private readonly databaseMover;
     private readonly remoteMoves;
     private readonly remoteRenames;
     private readonly linkUpdater;
@@ -3337,8 +3392,11 @@ interface DatabaseSyncResult {
 interface PlannedRow {
     readonly pageId: string;
     readonly path: string;
-    readonly operation: "create" | "update" | "delete";
+    /** `move` — Notion 에서 다른 페이지 아래로 옮긴 DB 의 폴더를 옮긴다(`pageId` 는 DB, ADR-047). */
+    readonly operation: "create" | "update" | "delete" | "move";
     readonly restore?: boolean;
+    /** Notion 에서 DB 안으로 옮긴 페이지가 행이 되며 옮길 것 — 노트와 하위 페이지 폴더 · 옮긴 DB 의 폴더(ADR-047). */
+    readonly moves?: readonly RemoteMove[];
 }
 /**
  * 행을 받는 진행 — 진행 표시가 페이지와 행을 한 목록 · 한 수로 보이게 한다. 행은 DB 를 조회해야 몇
@@ -3439,6 +3497,11 @@ declare class DatabaseSyncer {
          * 행 파일은 쓰지 않는다.
          */
         rescanRowChildren?: boolean;
+        /**
+         * 발견한 DB 다 — Notion 에서 다른 페이지 아래로 옮겼으면 볼트에서도 폴더를 옮기고 알린다({@link placementMoveOf}).
+         * 설정 파일에 적은 DB 의 폴더는 사용자가 정했다 — 주지 않는다.
+         */
+        onFolderMoved?: (move: RemoteMove) => void;
     }): Promise<DatabaseSyncResult>;
     /**
      * 받지 않는 행의 본문을 읽어 하위 페이지만 알린다(`--force`). 읽지 못한 행은 경고만 남긴다 — 그 행은 받을 것이
@@ -3456,7 +3519,14 @@ declare class DatabaseSyncer {
     planDatabase(dbConfig: DatabaseSyncConfig, opts?: {
         resolveDbFolder?: (databaseId: string) => string | null;
         paths?: readonly string[];
+        /** 발견한 DB 다 — Notion 에서 옮긴 DB 의 폴더 이동도 보인다({@link pullDatabase}). */
+        followPlacement?: boolean;
+        /**
+         * 볼트에서 옮긴 레코드 — dry-run 은 옮겨 적지 않아 이동 WAL 이 없다. 실제 pull 처럼 볼트가 먼저다.
+         */
+        movingInVault?: ReadonlySet<string>;
     }): Promise<PlannedRow[]>;
+    private planRows;
     /**
      * 이 DB 에서 볼 행을 조회한다. 범위(`paths`)가 이 DB 폴더에 닿지 않으면 조회하지 않는다 — 예전에는
      * 범위와 상관없이 모든 행을 만들고 고쳤다.
@@ -3615,6 +3685,8 @@ declare class DatabaseSyncer {
         properties: Record<string, unknown>;
         /** 받은 원격 본문의 지문(`remoteBodyFingerprint`). */
         bodyFingerprint: string;
+        /** 원격 본문에 페이지 시절의 속성 블록이 있었나 — 받으며 걷어 냈다. */
+        propertiesBlock: boolean;
     }>;
     /**
      * 행의 본문 밖이 지난 동기화 사본 그대로인가(N-05) — 제목과 보낼 수 있는 속성, 아이콘 · 커버.
@@ -3636,11 +3708,38 @@ declare class DatabaseSyncer {
     private rowPathOwners;
     /** 되살린 행의 경로를 가져가고 비운다. */
     takeRestoredRows(): string[];
+    /**
+     * Notion 에서 다른 페이지 아래로 옮긴 DB 의 폴더를 볼트에서도 옮긴다 — 옮겼으면 그 이동. 옮기지 못하면 까닭을 남기고
+     * 옛 자리에서 받는다.
+     */
+    private followPlacement;
+    /** 옮길 수 있으면 그 이동, 막혔으면 까닭을 알리고 null. */
+    private unblocked;
+    /** 볼트에서 옮기고 아직 올리지 않았나 — 이동 WAL, 또는 dry-run 이 옮겨 적지 않은 이번 이동. */
+    private movedInVault;
+    /**
+     * Notion 에서 다른 페이지 아래로 옮긴 발견 DB 의 폴더를 옮길 곳(ADR-047) — 제자리면 null.
+     *
+     * Notion 에서 DB 를 옮겨도 DB · 행의 수정 시각이 그대로라 받은 DB 의 부모로만 안다 — 전체 대조는 모든 DB 를 받으니
+     * 거기서 보인다. 새 자리는 처음 발견할 때와 같다 — 부모 페이지의 하위 폴더 이름 그대로, 루트면 `databases` 선반.
+     * 맨 위 폴더도 루트 아래로 본다(볼트에서 옮긴 DB 를 push 가 루트 아래에 둔다 — {@link DatabaseMover}).
+     * 다음은 옮기지 않는다.
+     *   - 부모가 블록(토글 · 열) 안 · 볼트가 모르는 페이지 — 볼트에 그 자리가 없다
+     *   - 볼트에서 옮긴 DB 폴더 · 부모 노트를 아직 올리지 않았다 — 볼트가 먼저다(push 가 Notion 을 옮긴다)
+     */
+    private placementMoveOf;
+    /** 이 폴더가 받는 DB — 설정한 DB 와 발견한 DB 에서. */
+    private databaseAt;
     /** 이름을 바꾼 행을 가져가고 비운다. */
     takeRenamedRows(): {
         renamed: RemoteMove[];
         applied: RemoteMove[];
     };
+    /**
+     * 행이 된 페이지의 하위 페이지 폴더 — 폴더 노트(`X/X.md`)는 든 폴더, 노트는 옆의 `X/`. 행의 하위 페이지는 `행/` 에
+     * 든다. 추적하는 노트가 없으면 null.
+     */
+    private adoptedChildrenOf;
     private pullDatabasePage;
 }
 
@@ -4654,4 +4753,4 @@ declare function readColumnLayout(lines: readonly string[]): (ColumnPlace | unde
 /** 열 이름표 — `열 2/3 · 50%`. 비율이 없으면 `열 2/3`. */
 declare function columnLabel(place: ColumnPlace): string;
 
-export { BaseFileGenerator, type BaseFileOptions, type BasePropertyOption, type BasePropertySchema, type BaseStatusGroup, type BaseSyncOptions, type BasesFilterNode, type BasesViewMapping, type BasesViewType, BlankLineCollapser, type BookmarkTarget, CONFIG_FILE, type CalendarEntry, type CalloutDesign, CalloutRestorer, CalloutTransformer, ChangeDetector, type ChangeDiff, ColorAnnotator, type ColumnPlace, type CompletenessFailure, type CompletenessLocalSource, type CompletenessOptions, type CompletenessRemoteSource, type CompletenessReport, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, ConnectionBoundaryError, ConnectionScopeError, type ConversionContext, type ConversionPath, ConversionPipeline, type ConversionResult, type CoverConfig, type DBEntry, DB_VIEWS_FILE, DB_VIEWS_PATH, DEFAULT_CONFIG, DEFAULT_TITLE_PROPERTY, DEFAULT_WATCH_DEBOUNCE_MS, DIFF_SIGN, type DatabaseCompleteness, type DatabaseSyncConfig, type DatabaseSyncResult, DatabaseSyncer, type DatabaseViewsConfig, type DeferredCode, type DegradeNote, type DesignColor, type DesignLine, type DesignSegment, type DiffHunk, type DiffLine, EmbedResolver, EntryEditor, type FailedOperation, type FidelityClassification, type FidelityContext, type FidelityDefect, type FidelityDefectForm, type FidelitySummary, type FileDownloadResult, FileHandler, type FileInfo, type FileRegistryEntry, type FileStatInfo, type FileSystemEntry, type FileType, type FileUploadResult, FileWatcher, type FilterCondition, FilteredVaultFS, type FolderDatabaseReport, type FolderMoveChange, FrontmatterExtractor, FrontmatterGenerator, type FullScanReason, GITIGNORE_ENTRY, type GatedOperation, type GroupByConfig, type GroupedEntries, IGNORE_FILE, INTERNAL_DIR, INTERNAL_DIR_GLOB, type IStateDB, type ImageDownloadResult, ImageHandler, type ImageReference, type InferredProperty, InlineAnnotationPreserver, InlineDBParser, type InlineStyle, type LineDiffOptions, type LineRange, type LocalChange, LocalImageRestorer, type LocalMoveAdoption, type LocalScan, type LocalScanOptions, type Logger, MARKER_BRAND, type MappingResult, type MappingType, MathNormalizer, MentionToWikilink, type MergeConflictRegion, type MergeResult, NOTION_COLOR_NAMES, NOTION_TOKEN_PREFIX, NOTION_TO_BASES_VIEW, type NestedFolderPage, type NestedFolderRecord, NodeVaultFS, type NonMdFileInfo, type NotionBlock, NotionBlockBuilder, NotionClient, type NotionClientOptions, type NotionColor, type NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type NotionSidecar, OBSIDIAN_CONFIG_DIR, type OperationType, type PageCompletenessRemoteSource, type PageCompletenessReport, type PageCover, type PageCreationPlan, type PageIcon, PathFilter, type PathFilterConfig, type PendingOperation, PendingWalError, type PlannedRow, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertyRename, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, RENDER_LINE_RULES, type ReadOnlySkip, type RecordPendingInput, type RegisterFileInput, type RemoteChange, type RemoteMove, type RemoteMoveSkip, type RemoteObservation, type RemoteScanInfo, type RenameHints, type RenameKind, type RenderFinding, type RenderLineRule, type ResolutionChoice, type ResolutionResult, type RichTextSegment, type RowProgress, SAVED_STATE_TABLES_QUERY, SEPARATOR_BODY, STATE_DB_FILE, STATE_DB_MIGRATIONS, STATE_DB_PATH, SavedStateDbError, type SchemaEdit, type SchemaFollowed, ScopedVaultFS, SidecarGenerator, type SidecarProperty, type SidecarView, StateDB, StateDbLockedError, type StateDbMigration, type StateDbTool, StateDbUnavailableError, StateLock, type StateLockClaim, type StateLockOwner, type StatusOptions, type StatusResult, type StyledRange, SyncBusyError, type SyncDirection, type SyncOptions, SyncOrchestrator, type SyncRecord, type SyncResult, type SyncStatus, type TableLineDesign, type TranslationResult, TreeMapper, UnsupportedBlockStripper, type UpsertSyncRecord, type VaultCompletenessReport, type VaultFS, type ViewConfig, ViewDataProvider, type ViewEdit, type ViewPropertyConfig, type ViewRenderData, type ViewType, WIKILINK_LOOKUPS, type WatchSyncOptions, type WatchSyncScope, WatchSyncService, type WikilinkEntry, type WikilinkLookup, WikilinkResolver, applicableChoices, assertNoPendingWal, basesViewMappingOf, basesViewTypeOf, choiceForStrategy, classifyBodyFidelity, columnLabel, compactNotionId, computeBufferHash, computeHash, configDirFrom, connectionFolderOf, createDefaultPipeline, extractCalendarEntries, filterByMonth, filterEntries, findConnectionFolders, findNestedFolderPages, formatUnifiedDiff, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, hasColumnLayout, hasDesignMarker, inAnyPathScope, isHeadingLine, isHeadingMarkerLine, isInternalPath, isMarkdownPath, isRemoteDeletion, lineDiff, lintRenderedMarkdown, matchesPathScope, normalizeNotionId, normalizeVaultPath, noteNameFromPath, notionIdFromInput, notionIdsEqual, operationLabel, parseDesignColor, parseIgnorePatterns, pendingWalBytes, readColumnLayout, readDesignLine, resolvePropertyName, sanitizeFileName, sectionLinesWithHeadingMarkers, setLogger, shortNotionId, sortEntries, stateDbLockPath, stateDbWalPath, stripMarkdownExtension, summarizeFidelity, systemTimeZone, threeWayMerge, toVaultPath, translateNotionFilter, verifyDatabaseCompleteness, verifyPageCompleteness, wikilinkLookupsIn };
+export { BaseFileGenerator, type BaseFileOptions, type BasePropertyOption, type BasePropertySchema, type BaseStatusGroup, type BaseSyncOptions, type BasesFilterNode, type BasesViewMapping, type BasesViewType, BlankLineCollapser, type BookmarkTarget, CONFIG_FILE, type CalendarEntry, type CalloutDesign, CalloutRestorer, CalloutTransformer, ChangeDetector, type ChangeDiff, ColorAnnotator, type ColumnPlace, type CompletenessFailure, type CompletenessLocalSource, type CompletenessOptions, type CompletenessRemoteSource, type CompletenessReport, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, ConnectionBoundaryError, ConnectionScopeError, type ConversionContext, type ConversionPath, ConversionPipeline, type ConversionResult, type CoverConfig, type DBEntry, DB_VIEWS_FILE, DB_VIEWS_PATH, DEFAULT_CONFIG, DEFAULT_TITLE_PROPERTY, DEFAULT_WATCH_DEBOUNCE_MS, DIFF_SIGN, type DatabaseCompleteness, type DatabaseMove, type DatabaseSyncConfig, type DatabaseSyncResult, DatabaseSyncer, type DatabaseViewsConfig, type DeferredCode, type DegradeNote, type DesignColor, type DesignLine, type DesignSegment, type DiffHunk, type DiffLine, EmbedResolver, EntryEditor, type FailedOperation, type FidelityClassification, type FidelityContext, type FidelityDefect, type FidelityDefectForm, type FidelitySummary, type FileDownloadResult, FileHandler, type FileInfo, type FileRegistryEntry, type FileStatInfo, type FileSystemEntry, type FileType, type FileUploadResult, FileWatcher, type FilterCondition, FilteredVaultFS, type FolderDatabaseReport, type FolderMoveChange, FrontmatterExtractor, FrontmatterGenerator, type FullScanReason, GITIGNORE_ENTRY, type GatedOperation, type GroupByConfig, type GroupedEntries, IGNORE_FILE, INTERNAL_DIR, INTERNAL_DIR_GLOB, type IStateDB, type ImageDownloadResult, ImageHandler, type ImageReference, type InferredProperty, InlineAnnotationPreserver, InlineDBParser, type InlineStyle, type LineDiffOptions, type LineRange, type LocalChange, LocalImageRestorer, type LocalMoveAdoption, type LocalScan, type LocalScanOptions, type Logger, MARKER_BRAND, type MappingResult, type MappingType, MathNormalizer, MentionToWikilink, type MergeConflictRegion, type MergeResult, NOTION_COLOR_NAMES, NOTION_TOKEN_PREFIX, NOTION_TO_BASES_VIEW, type NestedFolderPage, type NestedFolderRecord, NodeVaultFS, type NonMdFileInfo, type NotionBlock, NotionBlockBuilder, NotionClient, type NotionClientOptions, type NotionColor, type NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type NotionSidecar, OBSIDIAN_CONFIG_DIR, type OperationType, type PageCompletenessRemoteSource, type PageCompletenessReport, type PageCover, type PageCreationPlan, type PageIcon, PathFilter, type PathFilterConfig, type PendingOperation, PendingWalError, type PlacementChange, type PlannedRow, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertyRename, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, RENDER_LINE_RULES, type ReadOnlySkip, type RecordPendingInput, type RegisterFileInput, type RemoteChange, type RemoteMove, type RemoteMoveSkip, type RemoteObservation, type RemoteScanInfo, type RenameHints, type RenameKind, type RenderFinding, type RenderLineRule, type ResolutionChoice, type ResolutionResult, type RichTextSegment, type RowProgress, SAVED_STATE_TABLES_QUERY, SEPARATOR_BODY, STATE_DB_FILE, STATE_DB_MIGRATIONS, STATE_DB_PATH, SavedStateDbError, type SchemaEdit, type SchemaFollowed, ScopedVaultFS, SidecarGenerator, type SidecarProperty, type SidecarView, StateDB, StateDbLockedError, type StateDbMigration, type StateDbTool, StateDbUnavailableError, StateLock, type StateLockClaim, type StateLockOwner, type StatusOptions, type StatusResult, type StyledRange, SyncBusyError, type SyncDirection, type SyncOptions, SyncOrchestrator, type SyncRecord, type SyncResult, type SyncStatus, type TableLineDesign, type TranslationResult, TreeMapper, UnsupportedBlockStripper, type UpsertSyncRecord, type VaultCompletenessReport, type VaultFS, type ViewConfig, ViewDataProvider, type ViewEdit, type ViewPropertyConfig, type ViewRenderData, type ViewType, WIKILINK_LOOKUPS, type WatchSyncOptions, type WatchSyncScope, WatchSyncService, type WikilinkEntry, type WikilinkLookup, WikilinkResolver, applicableChoices, assertNoPendingWal, basesViewMappingOf, basesViewTypeOf, choiceForStrategy, classifyBodyFidelity, columnLabel, compactNotionId, computeBufferHash, computeHash, configDirFrom, connectionFolderOf, createDefaultPipeline, extractCalendarEntries, filterByMonth, filterEntries, findConnectionFolders, findNestedFolderPages, formatUnifiedDiff, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, hasColumnLayout, hasDesignMarker, inAnyPathScope, isHeadingLine, isHeadingMarkerLine, isInternalPath, isMarkdownPath, isRemoteDeletion, lineDiff, lintRenderedMarkdown, matchesPathScope, normalizeNotionId, normalizeVaultPath, noteNameFromPath, notionIdFromInput, notionIdsEqual, operationLabel, parseDesignColor, parseIgnorePatterns, pendingWalBytes, readColumnLayout, readDesignLine, resolvePropertyName, sanitizeFileName, sectionLinesWithHeadingMarkers, setLogger, shortNotionId, sortEntries, stateDbLockPath, stateDbWalPath, stripMarkdownExtension, summarizeFidelity, systemTimeZone, threeWayMerge, toVaultPath, translateNotionFilter, verifyDatabaseCompleteness, verifyPageCompleteness, wikilinkLookupsIn };