@im-nobsidian/core 0.1.4 → 0.1.6

package/dist/index.d.ts

@@ -379,6 +379,62 @@ interface WikilinkEntry {
     readonly aliases: readonly string[];
 }
 
+type ViewType = "table" | "board" | "list" | "calendar" | "timeline" | "gallery" | "form" | "chart" | "map" | "dashboard";
+interface ViewPropertyConfig {
+    readonly propertyId: string;
+    readonly propertyName?: string;
+    readonly visible?: boolean;
+    readonly width?: number;
+    readonly wrap?: boolean;
+}
+interface CoverConfig {
+    readonly type: "page_cover" | "page_content" | "page_content_first" | "property";
+    readonly propertyId?: string;
+}
+interface GroupByConfig {
+    readonly type: string;
+    readonly propertyId: string;
+    readonly propertyName?: string;
+    readonly sort?: "manual" | "ascending" | "descending";
+    readonly hideEmptyGroups?: boolean;
+}
+interface ViewConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly type: ViewType;
+    readonly dataSourceId?: string | null;
+    readonly filter?: unknown;
+    readonly sorts?: Array<{
+        readonly property?: string;
+        readonly timestamp?: "created_time" | "last_edited_time";
+        readonly direction: "ascending" | "descending";
+    }>;
+    readonly properties?: ViewPropertyConfig[];
+    readonly groupBy?: GroupByConfig;
+    readonly cover?: CoverConfig;
+    readonly coverSize?: "small" | "medium" | "large";
+    readonly coverAspect?: "contain" | "cover";
+    readonly datePropertyId?: string;
+    readonly datePropertyName?: string;
+    readonly viewRange?: "week" | "month";
+}
+interface DatabaseViewsConfig {
+    readonly databaseId: string;
+    readonly databaseName?: string;
+    readonly lastSynced: string;
+    readonly views: ViewConfig[];
+}
+interface PageCover {
+    readonly type: "file" | "external";
+    readonly url: string;
+    readonly expiryTime?: string;
+}
+interface PageIcon {
+    readonly type: "emoji" | "external" | "file" | "icon";
+    readonly value: string;
+    readonly color?: string;
+}
+
 declare class ConfigManager {
     private readonly vaultRoot;
     private config;
@@ -469,6 +525,7 @@ interface NotionClientOptions {
 declare class NotionClient {
     private readonly client;
     private readonly sema;
+    private readonly token;
     private readonly propertyMapper;
     constructor(options: NotionClientOptions);
     getInternalClient(): Client;
@@ -496,6 +553,8 @@ declare class NotionClient {
         replaceAll?: boolean;
     }>): Promise<PageMarkdownResponse>;
     movePage(pageId: string, newParentId: string, newParentType: "page" | "database"): Promise<PageObjectResponse>;
+    private fetchDatabaseLegacy;
+    getDatabaseTitle(databaseId: string): Promise<string>;
     getDatabaseSchema(databaseId: string): Promise<Record<string, {
         id: string;
         type: string;
@@ -511,6 +570,8 @@ declare class NotionClient {
     queryAllDatabasePages(databaseId: string, filter?: unknown): Promise<PageObjectResponse[]>;
     getDataSourceId(databaseId: string): Promise<string>;
     archivePage(pageId: string): Promise<void>;
+    getFileBlockUrl(blockId: string): Promise<string | null>;
+    getBlock(blockId: string): Promise<BlockObjectResponse>;
     listChildren(blockId: string, options?: {
         startCursor?: string;
         pageSize?: number;
@@ -519,6 +580,8 @@ declare class NotionClient {
         nextCursor: string | null;
     }>;
     fetchAllChildren(blockId: string): Promise<BlockObjectResponse[]>;
+    private static readonly CONTAINER_BLOCK_TYPES;
+    fetchAllChildrenDeep(blockId: string): Promise<BlockObjectResponse[]>;
     appendChildren(blockId: string, children: unknown[]): Promise<void>;
     deleteBlock(blockId: string): Promise<void>;
     uploadFile(fileData: Blob, filename: string, contentType: string): Promise<string>;
@@ -535,9 +598,17 @@ declare class NotionClient {
         nextCursor: string | null;
     }>;
     getChildPages(parentId: string): Promise<PageObjectResponse[]>;
+    getChildDatabaseIds(parentId: string): Promise<string[]>;
     getChildPagesRecursive(parentId: string): Promise<PageObjectResponse[]>;
+    listDatabaseViews(databaseId: string): Promise<ViewConfig[]>;
+    getView(viewId: string): Promise<ViewConfig | null>;
+    getDatabaseViewsConfig(databaseId: string): Promise<DatabaseViewsConfig>;
+    extractCover(page: PageObjectResponse): PageCover | null;
+    extractIcon(page: PageObjectResponse): PageIcon | null;
     extractTitle(page: PageObjectResponse): string;
     extractProperties(page: PageObjectResponse): Record<string, unknown>;
+    private lastRequestTime;
+    private readonly minRequestInterval;
     private withRateLimit;
     private executeWithRetry;
 }
@@ -716,6 +787,8 @@ declare class SyncOrchestrator {
     status(): Promise<StatusResult>;
     private buildConflictsFromRecords;
     private get isDatabaseMode();
+    private discoverChildDatabases;
+    private resolveNotionLinks;
     private ensureDbSchema;
     private pushCreate;
     private pushUpdate;
@@ -734,6 +807,7 @@ declare class SyncOrchestrator {
     private computePatches;
     private fetchPageMarkdown;
     private extractParentId;
+    private resolveBlockToPageId;
     private cleanupInterruptedSync;
     private resolveUniqueFilePath;
 }
@@ -788,8 +862,16 @@ declare class ImageHandler {
     uploadAndAppendImages(pageId: string, images: ImageReference[]): Promise<ImageUploadResult[]>;
     private readImageFromVault;
     private getContentTypeFromPath;
+    downloadAllFiles(markdown: string, pageTitle: string): Promise<{
+        content: string;
+        downloads: ImageDownloadResult[];
+    }>;
+    private parseNotionFileUrl;
+    private downloadFile;
     private isNotionImageUrl;
+    private isNotionFileUrl;
     private guessExtension;
+    private guessFileExtension;
 }
 
 type NotionBlockType = "image" | "pdf" | "video" | "audio" | "file";
@@ -849,7 +931,8 @@ declare class DatabaseSyncer {
     constructor(config: Config, stateDb: StateDB, notionClient: NotionClient, vaultFs: VaultFS, pipeline: ConversionPipeline, imageHandler: ImageHandler);
     pullAll(): Promise<DatabaseSyncResult>;
     pushAll(): Promise<DatabaseSyncResult>;
-    private pullDatabase;
+    pullDatabase(dbConfig: DatabaseSyncConfig): Promise<DatabaseSyncResult>;
+    private pullDatabaseViews;
     private pullDatabasePage;
     private pushDatabase;
 }
@@ -1121,6 +1204,85 @@ declare class WatchSyncService {
     private executeSync;
 }
 
+interface DBEntry {
+    readonly path: string;
+    readonly title: string;
+    readonly icon?: string;
+    readonly cover?: string;
+    readonly properties: Record<string, PropertyValue>;
+}
+type PropertyValue = string | number | boolean | null | string[] | {
+    start: string;
+    end?: string;
+};
+interface GroupedEntries {
+    readonly groupName: string;
+    readonly groupColor?: NotionColor;
+    readonly entries: DBEntry[];
+}
+interface CalendarEntry {
+    readonly entry: DBEntry;
+    readonly date: string;
+    readonly endDate?: string;
+}
+type NotionColor = "default" | "gray" | "brown" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "red";
+interface ViewRenderData {
+    readonly databaseId: string;
+    readonly databaseName?: string;
+    readonly viewConfig: ViewConfig;
+    readonly entries: DBEntry[];
+    readonly grouped?: GroupedEntries[];
+    readonly calendarEntries?: CalendarEntry[];
+    readonly propertyNames: string[];
+    readonly schema?: Record<string, PropertySchema>;
+}
+interface PropertySchema {
+    readonly name: string;
+    readonly type: string;
+    readonly options?: PropertyOption[];
+}
+interface PropertyOption {
+    readonly name: string;
+    readonly color?: NotionColor;
+}
+
+declare class ViewDataProvider {
+    private readonly vaultFs;
+    constructor(vaultFs: VaultFS);
+    loadAllViewConfigs(): Promise<Record<string, DatabaseViewsConfig>>;
+    getViewConfigs(databaseId: string): Promise<DatabaseViewsConfig | null>;
+    collectEntries(folderPath: string): Promise<DBEntry[]>;
+    buildViewData(databaseId: string, viewId: string, folderPath: string, schema?: Record<string, PropertySchema>): Promise<ViewRenderData | null>;
+    buildDefaultViewData(databaseId: string, folderPath: string, schema?: Record<string, PropertySchema>): Promise<ViewRenderData | null>;
+    processViewData(entries: DBEntry[], viewConfig: ViewConfig, databaseId: string, databaseName?: string, schema?: Record<string, PropertySchema>): ViewRenderData;
+}
+
+declare class EntryEditor {
+    private readonly vaultFs;
+    constructor(vaultFs: VaultFS);
+    updateProperty(entryPath: string, propertyName: string, newValue: PropertyValue): Promise<void>;
+    createEntry(folderPath: string, title: string, properties: Record<string, PropertyValue>): Promise<string>;
+    moveEntryToGroup(entry: DBEntry, groupProperty: string, newGroupValue: string): Promise<void>;
+    updateDate(entryPath: string, dateProperty: string, newDate: string): Promise<void>;
+}
+
+declare function sortEntries(entries: DBEntry[], sorts: NonNullable<ViewConfig["sorts"]>): DBEntry[];
+declare function groupEntries(entries: DBEntry[], groupByProperty: string, options?: {
+    sort?: "ascending" | "descending";
+    hideEmptyGroups?: boolean;
+}): GroupedEntries[];
+declare function extractCalendarEntries(entries: DBEntry[], dateProperty: string): CalendarEntry[];
+declare function filterByMonth(calendarEntries: CalendarEntry[], year: number, month: number): CalendarEntry[];
+declare function getVisibleProperties(viewConfig: ViewConfig): Array<{
+    id: string;
+    name: string;
+    width?: number;
+}>;
+
+declare function getNotionColor(color: NotionColor | string): string;
+declare function getNotionBgColor(color: NotionColor | string): string;
+declare function generateColorCSS(): string;
+
 declare function computeHash(content: string): string;
 declare function computeBufferHash(buffer: Buffer): string;
 
@@ -1144,4 +1306,4 @@ interface PipelineOptions {
 }
 declare function createDefaultPipeline(options?: PipelineOptions): ConversionPipeline;
 
-export { BlockConverter, CalloutRestorer, CalloutTransformer, ChangeDetector, ColorAnnotator, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, type ConversionContext, type ConversionPath, ConversionPipeline, type ConversionResult, DEFAULT_CONFIG, type DatabaseSyncConfig, type DatabaseSyncResult, DatabaseSyncer, EmbedResolver, type FailedOperation, type FileDownloadResult, FileHandler, type FileInfo, type FileSystemEntry, type FileType, type FileUploadResult, FileWatcher, FrontmatterExtractor, FrontmatterGenerator, 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 NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type OperationType, type PageCreationPlan, type PathFilterConfig, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, 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 WatchSyncOptions, WatchSyncService, type WikilinkEntry, WikilinkResolver, computeBufferHash, computeHash, createDefaultPipeline, generateId, getLogger, normalizeNotionId, notionIdsEqual, sanitizeFileName, setLogger, 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 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, 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 };