@im-nobsidian/core 0.1.7 → 0.1.9

package/dist/index.d.ts

@@ -246,6 +246,8 @@ interface SyncRecord {
     readonly fileType: FileType;
     readonly status: SyncStatus;
     readonly baseSnapshot: Buffer | null;
+    readonly localMtime: string | null;
+    readonly localFileSize: number | null;
     readonly version: number;
     readonly createdAt: string;
     readonly updatedAt: string;
@@ -279,21 +281,25 @@ interface ProgressItem {
 type ProgressCallback = (current: number, total: number, item: ProgressItem) => void;
 interface PushOptions {
     readonly paths?: string[];
+    readonly excludePaths?: string[];
     readonly force?: boolean;
     readonly dryRun?: boolean;
     readonly onProgress?: ProgressCallback;
+    readonly signal?: AbortSignal;
 }
 interface PullOptions {
     readonly paths?: string[];
     readonly force?: boolean;
     readonly dryRun?: boolean;
     readonly onProgress?: ProgressCallback;
+    readonly signal?: AbortSignal;
 }
 interface SyncOptions {
     readonly paths?: string[];
     readonly force?: boolean;
     readonly dryRun?: boolean;
     readonly onProgress?: ProgressCallback;
+    readonly signal?: AbortSignal;
 }
 interface PushResult {
     readonly created: number;
@@ -460,7 +466,35 @@ declare class ConfigManager {
     isInitialized(): Promise<boolean>;
 }
 
-declare class StateDB {
+interface IStateDB {
+    close(): void;
+    getByPath(path: string): SyncRecord | null;
+    getByNotionId(pageId: string): SyncRecord | null;
+    getByStatus(status: SyncStatus): SyncRecord[];
+    getAll(): SyncRecord[];
+    upsert(record: UpsertSyncRecord): SyncRecord;
+    updateStatus(id: string, status: SyncStatus): void;
+    updateHash(id: string, hash: string, snapshot?: Buffer | Uint8Array | null): void;
+    setNotionLastEdited(id: string, lastEdited: string): void;
+    updateStatCache(id: string, mtime: string, fileSize: number): void;
+    setNotionParentId(id: string, parentId: string): void;
+    delete(id: string): void;
+    resolveWikilink(text: string): WikilinkEntry | null;
+    resolvePageId(pageId: string): WikilinkEntry | null;
+    upsertWikilink(entry: WikilinkEntry): void;
+    getMeta(key: string): string | null;
+    setMeta(key: string, value: string): void;
+    isFileRegistered(localPath: string): boolean;
+    getFileRegistry(localPath: string): FileRegistryEntry | null;
+    getFilesByPageId(notionPageId: string): FileRegistryEntry[];
+    registerFile(entry: RegisterFileInput): void;
+    deleteFileRegistry(localPath: string): void;
+    storePreserveMarkers(path: string, markers: PreserveMarker[]): void;
+    getPreserveMarkers(path: string): PreserveMarker[];
+    transaction<T>(fn: () => T): T;
+}
+
+declare class StateDB implements IStateDB {
     private readonly db;
     private constructor();
     static open(dbPath: string): StateDB;
@@ -475,6 +509,7 @@ declare class StateDB {
     updateStatus(id: string, status: SyncStatus): void;
     updateHash(id: string, hash: string, snapshot?: Buffer | null): void;
     setNotionLastEdited(id: string, lastEdited: string): void;
+    updateStatCache(id: string, mtime: string, fileSize: number): void;
     setNotionParentId(id: string, parentId: string): void;
     delete(id: string): void;
     resolveWikilink(text: string): WikilinkEntry | null;
@@ -505,6 +540,8 @@ interface UpsertSyncRecord {
     readonly fileType: SyncRecord["fileType"];
     readonly status: SyncRecord["status"];
     readonly baseSnapshot?: Buffer | null;
+    readonly localMtime?: string | null;
+    readonly localFileSize?: number | null;
 }
 interface FileRegistryEntry {
     readonly id: string;
@@ -528,12 +565,14 @@ interface NotionClientOptions {
     readonly token: string;
     readonly concurrency?: number;
     readonly timeoutMs?: number;
+    readonly fetch?: typeof globalThis.fetch;
 }
 declare class NotionClient {
     private readonly client;
     private readonly sema;
     private readonly token;
     private readonly propertyMapper;
+    private readonly customFetch?;
     constructor(options: NotionClientOptions);
     getInternalClient(): Client;
     getPage(pageId: string): Promise<PageObjectResponse>;
@@ -604,6 +643,10 @@ declare class NotionClient {
         results: PageObjectResponse[];
         nextCursor: string | null;
     }>;
+    searchRecentPages(since: string): Promise<Array<{
+        id: string;
+        last_edited_time: string;
+    }>>;
     getChildPages(parentId: string): Promise<PageObjectResponse[]>;
     getChildDatabaseIds(parentId: string): Promise<string[]>;
     getChildPagesRecursive(parentId: string): Promise<PageObjectResponse[]>;
@@ -751,7 +794,8 @@ interface FileInfo {
 }
 declare class ChangeDetector {
     private readonly stateDb;
-    constructor(stateDb: StateDB);
+    constructor(stateDb: IStateDB);
+    detectLocalChangesFast(stats: FileStatInfo[], readFile: (path: string) => Promise<string>): Promise<LocalChange[]>;
     detectLocalChanges(currentFiles: FileInfo[]): LocalChange[];
     private detectMoves;
 }
@@ -761,6 +805,11 @@ interface NonMdFileInfo {
     readonly size: number;
     readonly mtime: string;
 }
+interface FileStatInfo {
+    readonly path: string;
+    readonly mtime: string;
+    readonly size: number;
+}
 interface VaultFS {
     readFile(path: string): Promise<string>;
     readBinary(path: string): Promise<Buffer>;
@@ -771,7 +820,9 @@ interface VaultFS {
     exists(path: string): Promise<boolean>;
     ensureFolder(path: string): Promise<void>;
     listMarkdownFiles(): Promise<FileInfo[]>;
+    listMarkdownFileStats(): Promise<FileStatInfo[]>;
     listNonMarkdownFiles(): Promise<NonMdFileInfo[]>;
+    getFileStat(path: string): Promise<FileStatInfo | null>;
 }
 
 declare class SyncOrchestrator {
@@ -789,14 +840,22 @@ declare class SyncOrchestrator {
     private dbSchemaLoaded;
     private _pullImageCount;
     private _pullFileCount;
-    constructor(config: Config, stateDb: StateDB, notionClient: NotionClient, vaultFs: VaultFS);
+    constructor(config: Config, stateDb: IStateDB, notionClient: NotionClient, vaultFs: VaultFS, customFetch?: typeof globalThis.fetch);
     push(options?: PushOptions): Promise<PushResult>;
     pull(options?: PullOptions): Promise<PullResult>;
     sync(options?: SyncOptions): Promise<SyncResult>;
     status(): Promise<StatusResult>;
+    statusLocal(): Promise<StatusResult>;
+    fetch(): Promise<{
+        newPages: number;
+        deletedPages: number;
+        modifiedPages: number;
+        duration: number;
+    }>;
     private buildConflictsFromRecords;
     private get isDatabaseMode();
     private discoverChildDatabases;
+    private pullDiscoveredDatabases;
     private resolveNotionLinks;
     private ensureDbSchema;
     private pushCreate;
@@ -804,16 +863,18 @@ declare class SyncOrchestrator {
     private pushDelete;
     private pushMove;
     private detectRemoteChanges;
+    private detectRemoteChangesIncremental;
+    private isTrackedParent;
     private pullCreate;
     private pullUpdate;
     private pullDelete;
     private ensureFolderPage;
     private resolveNotionParent;
+    private repairFolderRecords;
     private isFolderNote;
     private resolveParentPath;
     private pushCreatePage;
     private pushUpdatePage;
-    private computePatches;
     private fetchPageMarkdown;
     private extractParentId;
     private resolveBlockToPageId;
@@ -840,10 +901,13 @@ declare class NodeVaultFS implements VaultFS {
     exists(path: string): Promise<boolean>;
     ensureFolder(path: string): Promise<void>;
     listMarkdownFiles(): Promise<FileInfo[]>;
+    listMarkdownFileStats(): Promise<FileStatInfo[]>;
+    getFileStat(path: string): Promise<FileStatInfo | null>;
     listNonMarkdownFiles(): Promise<NonMdFileInfo[]>;
     private matchesPattern;
     private isExcluded;
     private walkDirNonMd;
+    private walkDirStats;
     private walkDir;
 }
 
@@ -861,7 +925,9 @@ declare class ImageHandler {
     private readonly vaultFs;
     private readonly attachmentFolder;
     private readonly notionClient?;
-    constructor(vaultFs: VaultFS, attachmentFolder?: string, notionClient?: NotionClient | undefined);
+    private readonly customFetch?;
+    constructor(vaultFs: VaultFS, attachmentFolder?: string, notionClient?: NotionClient | undefined, customFetch?: typeof globalThis.fetch);
+    private get fetchFn();
     downloadImage(url: string, pageTitle: string): Promise<ImageDownloadResult>;
     downloadAllImages(markdown: string, pageTitle: string): Promise<{
         content: string;
@@ -900,7 +966,7 @@ declare class FileHandler {
     private readonly notionClient;
     private readonly stateDb;
     private readonly sema;
-    constructor(vaultFs: VaultFS, notionClient: NotionClient, stateDb: StateDB);
+    constructor(vaultFs: VaultFS, notionClient: NotionClient, stateDb: IStateDB);
     pushFilesForFolder(folderPageId: string, folderPath: string): Promise<FileUploadResult[]>;
     pushAllFiles(): Promise<FileUploadResult[]>;
     downloadFileBlock(url: string, filename: string, targetFolder: string): Promise<FileDownloadResult>;
@@ -937,7 +1003,7 @@ declare class DatabaseSyncer {
     private readonly pipeline;
     private readonly imageHandler;
     private readonly propertyMapper;
-    constructor(config: Config, stateDb: StateDB, notionClient: NotionClient, vaultFs: VaultFS, pipeline: ConversionPipeline, imageHandler: ImageHandler);
+    constructor(config: Config, stateDb: IStateDB, notionClient: NotionClient, vaultFs: VaultFS, pipeline: ConversionPipeline, imageHandler: ImageHandler);
     pullAll(): Promise<DatabaseSyncResult>;
     pushAll(): Promise<DatabaseSyncResult>;
     pullDatabase(dbConfig: DatabaseSyncConfig): Promise<DatabaseSyncResult>;
@@ -1115,7 +1181,7 @@ interface ResolutionResult {
 declare class ConflictResolver {
     private readonly stateDb;
     private readonly vaultFs;
-    constructor(stateDb: StateDB, vaultFs: VaultFS);
+    constructor(stateDb: IStateDB, vaultFs: VaultFS);
     resolve(conflict: Conflict, choice: ResolutionChoice): Promise<ResolutionResult>;
     resolveByStrategy(conflict: Conflict, strategy: ConflictStrategy): Promise<ResolutionResult>;
     resolveAll(conflicts: Conflict[], strategy: ConflictStrategy): Promise<ResolutionResult[]>;
@@ -1287,6 +1353,13 @@ declare function getVisibleProperties(viewConfig: ViewConfig): Array<{
     name: string;
     width?: number;
 }>;
+interface FilterCondition {
+    property: string;
+    operator: "equals" | "contains" | "startsWith" | "isEmpty" | "isNotEmpty" | "gt" | "lt" | "between";
+    value?: string | number | boolean;
+    valueTo?: string | number;
+}
+declare function filterEntries(entries: DBEntry[], searchQuery?: string, filters?: FilterCondition[]): DBEntry[];
 
 declare function getNotionColor(color: NotionColor | string): string;
 declare function getNotionBgColor(color: NotionColor | string): string;
@@ -1315,4 +1388,4 @@ interface PipelineOptions {
 }
 declare function createDefaultPipeline(options?: PipelineOptions): ConversionPipeline;
 
-export { BlockConverter, type CalendarEntry, CalloutRestorer, CalloutTransformer, ChangeDetector, ColorAnnotator, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, type ConversionContext, type ConversionPath, ConversionPipeline, type ConversionResult, type CoverConfig, type DBEntry, DEFAULT_CONFIG, type DatabaseSyncConfig, type DatabaseSyncResult, DatabaseSyncer, type DatabaseViewsConfig, EmbedResolver, EntryEditor, type FailedOperation, type FileDownloadResult, FileHandler, type FileInfo, type FileSystemEntry, type FileType, type FileUploadResult, FileWatcher, FrontmatterExtractor, FrontmatterGenerator, type GroupByConfig, type GroupedEntries, HtmlAnnotationStripper, type ImageDownloadResult, ImageHandler, type ImageReference, InlineDBParser, type LocalChange, LocalImageRestorer, type Logger, type MappingResult, type MappingType, MathNormalizer, MentionToWikilink, type MergeConflictRegion, type MergeResult, NodeVaultFS, type NonMdFileInfo, type NotionBlock, NotionBlockBuilder, NotionClient, type NotionClientOptions, type NotionColor, type NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type OperationType, type PageCover, type PageCreationPlan, type PageIcon, type PathFilterConfig, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, type RemoteChange, type ResolutionChoice, type ResolutionResult, type RichTextSegment, StateDB, type StatusResult, type SyncDirection, type SyncOptions, SyncOrchestrator, type SyncRecord, type SyncResult, type SyncStatus, TreeMapper, UnsupportedBlockStripper, type UpsertSyncRecord, type VaultFS, type ViewConfig, ViewDataProvider, type ViewPropertyConfig, type ViewRenderData, type ViewType, type WatchSyncOptions, WatchSyncService, type WikilinkEntry, WikilinkResolver, computeBufferHash, computeHash, createDefaultPipeline, extractCalendarEntries, filterByMonth, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, normalizeNotionId, notionIdsEqual, sanitizeFileName, setLogger, sortEntries, threeWayMerge };
+export { BlockConverter, type CalendarEntry, CalloutRestorer, CalloutTransformer, ChangeDetector, ColorAnnotator, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, type ConversionContext, type ConversionPath, ConversionPipeline, type ConversionResult, type CoverConfig, type DBEntry, DEFAULT_CONFIG, type DatabaseSyncConfig, type DatabaseSyncResult, DatabaseSyncer, type DatabaseViewsConfig, EmbedResolver, EntryEditor, type FailedOperation, type FileDownloadResult, FileHandler, type FileInfo, type FileRegistryEntry, type FileStatInfo, type FileSystemEntry, type FileType, type FileUploadResult, FileWatcher, type FilterCondition, FrontmatterExtractor, FrontmatterGenerator, type GroupByConfig, type GroupedEntries, HtmlAnnotationStripper, type IStateDB, type ImageDownloadResult, ImageHandler, type ImageReference, InlineDBParser, type LocalChange, LocalImageRestorer, type Logger, type MappingResult, type MappingType, MathNormalizer, MentionToWikilink, type MergeConflictRegion, type MergeResult, NodeVaultFS, type NonMdFileInfo, type NotionBlock, NotionBlockBuilder, NotionClient, type NotionClientOptions, type NotionColor, type NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type OperationType, type PageCover, type PageCreationPlan, type PageIcon, type PathFilterConfig, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, type RegisterFileInput, type RemoteChange, type ResolutionChoice, type ResolutionResult, type RichTextSegment, StateDB, type StatusResult, type SyncDirection, type SyncOptions, SyncOrchestrator, type SyncRecord, type SyncResult, type SyncStatus, TreeMapper, UnsupportedBlockStripper, type UpsertSyncRecord, type VaultFS, type ViewConfig, ViewDataProvider, type ViewPropertyConfig, type ViewRenderData, type ViewType, type WatchSyncOptions, WatchSyncService, type WikilinkEntry, WikilinkResolver, computeBufferHash, computeHash, createDefaultPipeline, extractCalendarEntries, filterByMonth, filterEntries, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, normalizeNotionId, notionIdsEqual, sanitizeFileName, setLogger, sortEntries, threeWayMerge };