universal-picgo 2.0.1 → 3.0.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-picgo",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "type": "module",
   "description": "picgo lib for node, browser and electron",
   "main": "./dist/index.js",
@@ -22,7 +22,8 @@
     "dev": "vite build --watch",
     "build": "vite build",
     "start": "vite preview",
-    "test": "npx vitest --watch"
+    "test": "vitest run",
+    "test:watch": "npx vitest --watch"
   },
   "devDependencies": {
     "@terwer/eslint-config-custom": "^1.3.6",
@@ -50,4 +51,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/dist/src/config/DefaultRecognition.d.ts

@@ -0,0 +1,55 @@
+import { IConfig, IExternalPicgoConfig } from '../types';
+import { ConfigDomain, SiyuanConfigLike } from './UnifiedConfigTypes';
+
+/**
+ * Default-generated recognition for v3 migration.
+ *
+ * During migration, each domain's owner file is classified as:
+ *   - "user-data": contains real user values → authoritative, do not overwrite
+ *   - "generated-default": only contains auto-generated defaults → can import legacy data
+ *   - "missing": does not exist → can import legacy data
+ *
+ * @module DefaultRecognition
+ * @since 3.0.0
+ */
+export type DefaultClassification = "user-data" | "generated-default" | "missing";
+/**
+ * Check if a PicGo main config contains only generated defaults.
+ *
+ * A config is "generated-default" when:
+ *   - Root keys are limited to {"picBed", "picgoPlugins", "siyuan"}
+ *   - picBed has only uploader="smms", current="smms" (no real uploader config)
+ *   - picgoPlugins is empty
+ *   - siyuan matches initial defaults exactly
+ */
+export declare function isPicgoMainGeneratedDefault(cfg: IConfig | null | undefined): boolean;
+/**
+ * Check if an external/PicList config contains only generated defaults.
+ *
+ * A config is "generated-default" when:
+ *   - Matches the default shape
+ *   - picListApiUrl is empty (non-empty = user data)
+ *   - picListApiKey is empty (non-empty = user data)
+ */
+export declare function isExternalPicgoGeneratedDefault(cfg: IExternalPicgoConfig | null | undefined): boolean;
+/**
+ * Check if a SiYuan connection config contains only generated defaults.
+ *
+ * A config is "generated-default" when:
+ *   - apiUrl matches default "http://127.0.0.1:6806"
+ *   - password is empty
+ *   - cookie is missing
+ *   - No user-edited optional fields
+ */
+export declare function isSiyuanConnectionGeneratedDefault(cfg: SiyuanConfigLike | null | undefined): boolean;
+/**
+ * Check if Lsky token state contains only generated defaults.
+ *
+ * Returns "generated-default" when uploader.lsky.token is absent.
+ * Any non-empty legacy token is user data.
+ */
+export declare function isLskyStateGeneratedDefault(tokenValue: string | null | undefined): boolean;
+/**
+ * Classify a domain's current owner file data as user-data, generated-default, or missing.
+ */
+export declare function classifyDomainDefaults(domain: ConfigDomain, data: any): DefaultClassification;

package/dist/src/config/DefaultRecognition.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/config/ExternalPicgoDefaultSurvival.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/config/MaskUtils.d.ts

@@ -0,0 +1,51 @@
+import { UnifiedConfigSnapshot } from './UnifiedConfigTypes';
+
+/**
+ * Mask utilities for sensitive configuration fields.
+ *
+ * Sensitive fields (passwords, tokens, keys, cookies) MUST be rendered
+ * as "******" in logs, errors, migration reports, diagnostics, and any
+ * non-persistence output. Real values MUST only exist in owner files
+ * and runtime memory needed for API calls.
+ *
+ * @module MaskUtils
+ * @since 3.0.0
+ */
+/**
+ * Determine whether a field name matches any sensitive field pattern.
+ */
+export declare function isSensitiveField(fieldName: string): boolean;
+/**
+ * Deep-clone and mask all sensitive fields in an object tree.
+ *
+ * Recursively walks the object. When a key matches a sensitive field
+ * pattern and the value is a non-empty string, replaces it with MASK_VALUE.
+ * Arrays are traversed element by element.
+ *
+ * IMPORTANT: The mask is applied to a deep CLONE — the original object
+ * is NEVER mutated. Masked values MUST NOT be written back to owner files.
+ *
+ * @param obj - Any JSON-serializable value.
+ * @returns Deep-cloned copy with sensitive string values replaced by "******".
+ */
+export declare function maskSensitiveFields<T = any>(obj: T): T;
+/**
+ * Mask sensitive fields in a unified config snapshot.
+ *
+ * Returns a deep-cloned copy with all passwords, tokens, cookies, and
+ * API keys replaced by "******". Safe for logging, diagnostics, and
+ * audit evidence.
+ *
+ * @param snapshot - The raw unified config snapshot.
+ * @returns Deep-cloned snapshot with all sensitive fields masked.
+ */
+export declare function maskSnapshot(snapshot: UnifiedConfigSnapshot): UnifiedConfigSnapshot;
+/**
+ * Mask a single config value if it is a string that matches a known
+ * sensitive field name context.
+ *
+ * @param value - The value string (or undefined).
+ * @param fieldName - The field name for sensitivity detection.
+ * @returns The original value if field is not sensitive or value is empty; "******" otherwise.
+ */
+export declare function maskIfSensitive(value: string | undefined, fieldName: string): string | undefined;

package/dist/src/config/MaskUtils.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/config/SettingsStorePattern.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/config/UnifiedConfigFacade.d.ts

@@ -0,0 +1,21 @@
+import { ReadyUnifiedPicGoConfigFacade, UnifiedPicGoConfigFacadeOptions } from './UnifiedConfigTypes';
+
+/**
+ * Create and initialize the unified async configuration facade.
+ *
+ * This async factory:
+ *   1. Resolves storage adapters for each unique owner file
+ *   2. Reads all owner files
+ *   3. Checks/executes v3 migration
+ *   4. Merges defaults where data is missing
+ *   5. Constructs the ready snapshot
+ *   6. Returns the ready facade
+ *
+ * The returned Promise MUST be awaited before any configuration access.
+ * Reading user config before resolve throws ConfigNotReadyError.
+ *
+ * @param options - Runtime options including SiYuan connection config,
+ *   paths, and optional storage adapter factory.
+ * @returns A Promise resolving to the ready facade.
+ */
+export declare function createUnifiedPicGoConfigFacade(options: UnifiedPicGoConfigFacadeOptions): Promise<ReadyUnifiedPicGoConfigFacade>;

package/dist/src/config/UnifiedConfigFacade.integration.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/config/UnifiedConfigFacade.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/config/UnifiedConfigTypes.d.ts

@@ -0,0 +1,323 @@
+import { IConfig, IExternalPicgoConfig } from '../types';
+
+/**
+ * Minimal SiYuan connection configuration.
+ *
+ * Defined locally to avoid circular dependency between universal-picgo
+ * and zhi-siyuan-picgo. The actual type in zhi-siyuan-picgo has the
+ * same shape and is used by the factory layer.
+ */
+export interface SiyuanConfigLike {
+    apiUrl?: string;
+    password?: string;
+    cookie?: string;
+    home?: string;
+    previewUrl?: string;
+    notebook?: string;
+    picgoUploadTimeout?: number;
+    passwordType?: unknown;
+}
+/**
+ * Per-domain routing key for the unified configuration facade.
+ *
+ * Each domain maps to a specific owner file and migration priority.
+ * @see design.md § Complete Configuration Domain Mapping
+ */
+export type ConfigDomain = "picgoMain" | "picgoSettings" | "siyuanBehavior" | "siyuanConnection" | "externalPicList" | "pluginValues" | "uploaderConfig" | "lskyState" | "pasteBootstrap";
+/** All configuration domains as a readonly array for iteration. */
+export declare const ALL_CONFIG_DOMAINS: readonly ConfigDomain[];
+/**
+ * Options passed to `createUnifiedPicGoConfigFacade`.
+ *
+ * Specifies runtime environment, storage resolution, and migration
+ * behavior for the unified async configuration facade.
+ */
+export interface UnifiedPicGoConfigFacadeOptions {
+    /** SiYuan connection config used to create the Kernel API wrapper. */
+    siyuanConfig: SiyuanConfigLike;
+    /** Logical paths / overrides for owner file resolution. */
+    paths: UnifiedConfigPaths;
+    /** Whether to run in dev mode (enables debug logging). */
+    isDev?: boolean;
+    /**
+     * Optional storage adapter factory.
+     * When provided, overrides the L1-L4 decision tree for all owner files.
+     */
+    storageAdapterFactory?: (dbPath: string) => import('universal-picgo-store').StorageAdapter;
+    /**
+     * Optional logger factory.
+     * When omitted, a simple console logger is used.
+     */
+    getLogger?: (name: string) => {
+        info: (...args: any[]) => void;
+        error: (...args: any[]) => void;
+        warn: (...args: any[]) => void;
+        debug: (...args: any[]) => void;
+    };
+}
+/**
+ * Path overrides for owner file resolution.
+ *
+ * All paths default to the environment-appropriate locations derived
+ * from the SiYuan workspace and host runtime.
+ */
+export interface UnifiedConfigPaths {
+    /** Override for PicGo main owner file path. */
+    configPath?: string;
+    /** Override/diagnostic identity for external/PicList owner file path. */
+    externalConfigPath?: string;
+    /** Override/diagnostic identity for SiYuan connection owner file path. */
+    siyuanConnectionConfigPath?: string;
+    /** Optional SiYuan workspace directory used by host factories/migration readers. */
+    workspaceDir?: string;
+    /** Optional user home/local PicGo directory used by migration readers. */
+    homeDir?: string;
+    /** Device-local runtime directory. */
+    baseDir?: string;
+    /** Alias for baseDir. */
+    runtimeDir?: string;
+    /** Device-local third-party plugin directory. */
+    pluginBaseDir?: string;
+    /** zhi npm helper path. */
+    zhiNpmPath?: string;
+}
+/**
+ * Paste takeover snapshot derived from ready owner file data.
+ *
+ * Constructed during facade initialization for synchronous paste
+ * event decisions without async boundary crossing.
+ */
+export interface PasteTakeoverSnapshot {
+    /** Whether auto-upload on paste is enabled. */
+    autoUpload: boolean;
+    /** Whether picture+text mixed paste is allowed (txtImageSwitch). */
+    allowPicAndText: boolean;
+    /** Whether replace link on upload is enabled. */
+    replaceLink: boolean;
+}
+/**
+ * Complete unified configuration snapshot assembled from all owner files.
+ *
+ * Returned by `ReadyUnifiedPicGoConfigFacade.getSnapshot()` and
+ * `reload()`. Contains pure serializable data — no Vue reactivity,
+ * no framework bindings.
+ */
+export interface UnifiedConfigSnapshot {
+    /** PicGo main config (uploader, picBed, siyuan behavior, etc.). */
+    picgo: IConfig;
+    /** External PicGo App / PicList route configuration. */
+    externalPicgo: IExternalPicgoConfig;
+    /** SiYuan connection configuration (apiUrl, password, cookie). */
+    siyuanConnection: SiyuanConfigLike;
+    /** Pre-warmed snapshot for synchronous paste takeover decisions. */
+    pasteTakeover: PasteTakeoverSnapshot;
+    /** V3 migration state tracker. */
+    migration: UnifiedConfigMigrationState;
+}
+/**
+ * Resolved unified async configuration facade.
+ *
+ * This is the ONLY production boundary for PicGo/plugin user
+ * configuration access in PicGo 3.0. All configuration reads,
+ * writes, and mutations must go through this interface.
+ *
+ * The facade is never half-ready: `createUnifiedPicGoConfigFacade()`
+ * returns a Promise that only resolves when all owner files are
+ * loaded, migration is complete (or skipped), and defaults are merged.
+ */
+export interface ReadyUnifiedPicGoConfigFacade {
+    /** Whether the underlying storage backends are sync or async. */
+    readonly storageMode: "sync" | "async";
+    /** Unique key identifying this facade instance. */
+    readonly instanceKey: string;
+    /**
+     * Return the full in-memory configuration snapshot.
+     * Synchronous — returns the last loaded state.
+     */
+    getSnapshot(): UnifiedConfigSnapshot;
+    /**
+     * Read the PicGo main configuration domain.
+     * Returns a deep-cloned snapshot to prevent accidental mutation.
+     */
+    getPicGoConfig(): Promise<IConfig>;
+    /**
+     * Read the external/PicList configuration domain.
+     */
+    getExternalPicGoConfig(): Promise<IExternalPicgoConfig>;
+    /**
+     * Read the SiYuan connection configuration domain.
+     * Note: password and cookie are real values in the returned object;
+     * callers must mask before displaying or logging.
+     */
+    getSiyuanConnectionConfig(): Promise<SiyuanConfigLike>;
+    /**
+     * Read the pre-warmed paste takeover snapshot.
+     * Synchronous — designed for paste event handlers.
+     */
+    getPasteTakeoverSnapshot(): Promise<PasteTakeoverSnapshot>;
+    /**
+     * Mutate the PicGo main configuration in-memory.
+     * The change is applied immediately; persistence is deferred.
+     * Mark the picgoMain (and any sub-domain) as dirty.
+     */
+    updatePicGoConfig(mutator: (draft: IConfig) => void): Promise<void>;
+    /**
+     * Mutate the external/PicList configuration in-memory.
+     */
+    updateExternalPicGoConfig(mutator: (draft: IExternalPicgoConfig) => void): Promise<void>;
+    /**
+     * Mutate the SiYuan connection configuration in-memory.
+     */
+    updateSiyuanConnectionConfig(mutator: (draft: SiyuanConfigLike) => void): Promise<void>;
+    /**
+     * Flush dirty domains to their owner files.
+     * If no domains specified, flushes all dirty domains.
+     * Throws ConfigFlushError on any write failure.
+     */
+    flush(domains?: ConfigDomain[]): Promise<void>;
+    /**
+     * Flush, then re-read from storage, then return refreshed snapshot.
+     * Uses writeVersion to avoid overwriting local changes with stale remote data.
+     */
+    reload(domains?: ConfigDomain[]): Promise<UnifiedConfigSnapshot>;
+    /**
+     * Return the current v3 migration state.
+     */
+    getMigrationState(): Promise<UnifiedConfigMigrationState>;
+    /**
+     * Explicitly retry failed domain migrations.
+     * Does not clear already-successful domains.
+     */
+    retryMigration(domains?: ConfigDomain[]): Promise<UnifiedConfigMigrationState>;
+    /**
+     * Return a deep-cloned snapshot with all sensitive fields masked as "******".
+     * Safe for logging, error messages, diagnostics, and audit evidence.
+     */
+    maskSnapshot(snapshot: UnifiedConfigSnapshot): UnifiedConfigSnapshot;
+}
+/** Per-domain migration status. */
+export type MigrationDomainStatus = "not-started" | "imported" | "skipped" | "failed";
+/** Global migration status. */
+export type MigrationGlobalStatus = "not-started" | "running" | "done" | "failed";
+/** Per-domain migration record. */
+export interface MigrationDomainState {
+    status: MigrationDomainStatus;
+    /** Identifiers of imported legacy sources (e.g., "v2-workspace-picgo.cfg.json"). */
+    importedSources: string[];
+    updatedAt?: number;
+    error?: string;
+}
+/**
+ * V3 unified async config source migration marker.
+ *
+ * Stored at `picgo.cfg.json:siyuan.picgoMigration` with
+ * version = "v3.0-unified-async-config-source".
+ */
+export interface UnifiedConfigMigrationState {
+    /** Fixed version marker for PicGo 3.0. */
+    version: "v3.0-unified-async-config-source";
+    /** Global migration status. */
+    status: MigrationGlobalStatus;
+    /** Unix timestamp of last status update. */
+    updatedAt?: number;
+    /** Error message if global status is "failed". */
+    error?: string;
+    /** Number of migration attempts. */
+    attempts: number;
+    /** Per-domain migration progress. */
+    domains: Record<ConfigDomain, MigrationDomainState>;
+}
+/** Fixed PicGo 3.0 unified async config migration marker version. */
+export declare const UNIFIED_CONFIG_MIGRATION_VERSION: "v3.0-unified-async-config-source";
+/** Initial migration state before any migration runs. */
+export declare const INITIAL_MIGRATION_STATE: UnifiedConfigMigrationState;
+/**
+ * Thrown when production code attempts to read user configuration
+ * before the unified facade has resolved (ready barrier not passed).
+ */
+export declare class ConfigNotReadyError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Thrown when flush() encounters a write failure for one or more domains.
+ * Contains per-domain failure details with owner file information.
+ */
+export declare class ConfigFlushError extends Error {
+    /** Per-domain flush failure details. */
+    readonly failures: ConfigFlushFailure[];
+    constructor(failures: ConfigFlushFailure[], message?: string);
+}
+/** Single domain flush failure detail. */
+export interface ConfigFlushFailure {
+    domain: ConfigDomain;
+    ownerFile: string;
+    storageKind?: string;
+    error: string;
+}
+/**
+ * Thrown when an owner file cannot be read.
+ *
+ * Async/remote backends (SiYuan Kernel, proxy storage, etc.) MUST fail
+ * explicitly instead of returning generated defaults. The details are
+ * intentionally serializable so UI/headless callers can surface the domain,
+ * owner file and backend kind.
+ */
+export declare class ConfigReadError extends Error {
+    readonly domain: ConfigDomain;
+    readonly ownerFile: string;
+    readonly storageKind: string;
+    readonly causeError?: unknown;
+    constructor(input: {
+        domain: ConfigDomain;
+        ownerFile: string;
+        storageKind: string;
+        error: unknown;
+        message?: string;
+    });
+}
+/**
+ * Regular expression patterns for detecting sensitive field names
+ * that must be masked in non-persistence outputs.
+ *
+ * These fields are stored as real values in owner files but MUST
+ * be rendered as "******" in logs, errors, migration reports,
+ * diagnostics, and smoke evidence.
+ */
+export declare const SENSITIVE_FIELD_PATTERNS: readonly RegExp[];
+/** Mask value used for all sensitive field outputs. */
+export declare const MASK_VALUE: "******";
+/**
+ * Owner file name for each configuration domain.
+ *
+ * Domains sharing the same owner file are flushed together
+ * when any of them is dirty.
+ */
+export declare const OWNER_FILE_MAP: Record<ConfigDomain, string>;
+/**
+ * Logical key prefix used for browser localStorage fallback.
+ */
+export declare const DEFAULT_LOGICAL_KEY_PREFIX: "universal-picgo";
+/** Logical key for PicGo main config in browser fallback. */
+export declare const MAIN_CONFIG_LOGICAL_KEY: "universal-picgo/picgo.cfg.json";
+/** Logical key for external/PicList config in browser fallback. */
+export declare const EXTERNAL_CONFIG_LOGICAL_KEY: "universal-picgo/external-picgo-cfg.json";
+/** Logical key for SiYuan connection config in browser fallback. */
+export declare const SIYUAN_CONNECTION_LOGICAL_KEY: "siyuan-cfg";
+/** Kernel-backed workspace path for PicGo main config. */
+export declare const KERNEL_MAIN_CONFIG_PATH: "/data/storage/syp/picgo/picgo.cfg.json";
+/** Kernel-backed workspace path for external/PicList config. */
+export declare const KERNEL_EXTERNAL_CONFIG_PATH: "/data/storage/syp/picgo/external-picgo-cfg.json";
+/** Kernel-backed workspace path for SiYuan connection config. */
+export declare const KERNEL_SIYUAN_CONNECTION_PATH: "/data/storage/syp/siyuan-cfg.json";
+/** Default values for PicGo main config. Matches ConfigDb.initialValue exactly. */
+export declare const PICGO_MAIN_DEFAULTS: Partial<IConfig>;
+/** Default values for external/PicList config. */
+export declare const EXTERNAL_PICGO_DEFAULTS: IExternalPicgoConfig;
+/** Default values for SiYuan connection config. */
+export declare const SIYUAN_CONNECTION_DEFAULTS: SiyuanConfigLike;
+/**
+ * Per-domain default factories.
+ *
+ * Each factory returns a fresh default object to avoid shared-mutation bugs.
+ */
+export declare const DOMAIN_DEFAULTS: Record<ConfigDomain, () => any>;

package/dist/src/config/UnifiedConfigTypes.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/config/V3MigrationService.d.ts

@@ -0,0 +1,36 @@
+import { ConfigDomain, UnifiedConfigMigrationState } from './UnifiedConfigTypes';
+
+export interface V3MigrationOptions {
+    /** Current in-memory data for each owner file. */
+    ownerFileData: Map<string, Record<string, any>>;
+    /** Existing migration state (from picgo.cfg.json:siyuan.picgoMigration). */
+    existingState?: Partial<UnifiedConfigMigrationState>;
+    /** Whether we're in a Node environment (for filesystem access). */
+    hasNodeEnv: boolean;
+    /** SiYuan workspace directory (if available). */
+    workspaceDir?: string;
+    /** Legacy home/local PicGo directory (if available). */
+    homeDir?: string;
+    /** Logger. */
+    logger?: {
+        info: (...args: any[]) => void;
+        warn: (...args: any[]) => void;
+        error: (...args: any[]) => void;
+    };
+}
+/**
+ * Execute or resume PicGo 3.0 unified async config migration.
+ *
+ * Implements per-domain idempotent migration with:
+ * - Domain granularity: successes are never rolled back
+ * - Default-generated recognition: only generated defaults can be replaced
+ * - Priority: workspace > home > browser
+ * - importedSources tracking
+ * - Retry via retryMigration(domains?)
+ */
+export declare function runV3Migration(options: V3MigrationOptions): Promise<UnifiedConfigMigrationState>;
+/**
+ * Retry failed domain migrations.
+ * Does NOT clear already-successful domains.
+ */
+export declare function retryV3Migration(options: V3MigrationOptions, domains?: ConfigDomain[]): Promise<UnifiedConfigMigrationState>;

package/dist/src/config/V3MigrationService.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/config/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PicGo 3.0 Unified Configuration barrel export.
+ *
+ * @module config
+ * @since 3.0.0
+ */
+export { createUnifiedPicGoConfigFacade } from './UnifiedConfigFacade';
+export { runV3Migration, retryV3Migration, type V3MigrationOptions } from './V3MigrationService';
+export { type ConfigDomain, type ReadyUnifiedPicGoConfigFacade, type UnifiedConfigSnapshot, type UnifiedConfigMigrationState, type UnifiedPicGoConfigFacadeOptions, type UnifiedConfigPaths, type PasteTakeoverSnapshot, type SiyuanConfigLike, type MigrationDomainState, type MigrationDomainStatus, type MigrationGlobalStatus, type ConfigFlushFailure, ALL_CONFIG_DOMAINS, OWNER_FILE_MAP, UNIFIED_CONFIG_MIGRATION_VERSION, INITIAL_MIGRATION_STATE, MASK_VALUE, SENSITIVE_FIELD_PATTERNS, MAIN_CONFIG_LOGICAL_KEY, EXTERNAL_CONFIG_LOGICAL_KEY, SIYUAN_CONNECTION_LOGICAL_KEY, KERNEL_MAIN_CONFIG_PATH, KERNEL_EXTERNAL_CONFIG_PATH, KERNEL_SIYUAN_CONNECTION_PATH, PICGO_MAIN_DEFAULTS, EXTERNAL_PICGO_DEFAULTS, SIYUAN_CONNECTION_DEFAULTS, DOMAIN_DEFAULTS, ConfigNotReadyError, ConfigFlushError, ConfigReadError, } from './UnifiedConfigTypes';
+export { maskSnapshot, maskSensitiveFields, maskIfSensitive, isSensitiveField } from './MaskUtils';
+export { isPicgoMainGeneratedDefault, isExternalPicgoGeneratedDefault, isSiyuanConnectionGeneratedDefault, classifyDomainDefaults, type DefaultClassification, } from './DefaultRecognition';

package/dist/src/core/ExternalPicgo.d.ts

@@ -1,5 +1,4 @@
-import { IImgInfo, IPicGo } from '../types';
-import { default as ExternalPicgoConfigDb } from '../db/externalPicGo';
+import { IExternalPicgoConfig, IImgInfo, IPicGo } from '../types';
 
 /**
  *外部的PicGO 上传 Api
@@ -12,13 +11,14 @@ declare class ExternalPicgo {
     private logger;
     private requestUrl;
     private readonly endpointUrl;
-    db: ExternalPicgoConfigDb;
-    constructor(ctx: IPicGo, isDev?: boolean);
+    private readonly configProvider?;
+    constructor(_ctx: IPicGo, isDev?: boolean, configProvider?: () => IExternalPicgoConfig);
     /**
      * 上传图片到PicGO
      *
      * @param input 路径数组，可为空，为空上传剪贴板
      */
     upload(input?: any[]): Promise<IImgInfo[] | Error>;
+    private getRouteConfig;
 }
 export { ExternalPicgo };

package/dist/src/core/PicListUploader.d.ts

@@ -0,0 +1,50 @@
+import { IExternalPicgoConfig, IImgInfo, IPicGo } from '../types';
+
+/**
+ * 远程 PicList 上传 API
+ *
+ * 对接远程 PicList 容器的图片上传接口。
+ * 与本地 ExternalPicgo 不同，此上传器通过 multipart/form-data 直接携带图片二进制数据。
+ *
+ * 接口规范：
+ * - URL: POST {apiUrl}?key={apiKey}
+ * - Content-Type: multipart/form-data
+ * - Body: file 字段，包含图片文件
+ * - 响应: { success: true, result: "https://..." }
+ *
+ * @author terwer
+ */
+declare class PicListUploader {
+    private readonly logger;
+    private readonly configProvider?;
+    constructor(_ctx: IPicGo, isDev?: boolean, configProvider?: () => IExternalPicgoConfig);
+    /**
+     * 上传图片到远程 PicList 服务
+     *
+     * @param input 文件路径、URL、Blob 或 File 数组。为空则上传剪贴板（不支持，会抛错）
+     * @returns 上传结果数组
+     */
+    upload(input?: any[]): Promise<IImgInfo[] | Error>;
+    /**
+     * 检查当前是否配置了 PicList（有远程 URL 和 API Key）
+     */
+    isPicListConfigured(): boolean;
+    private getRouteConfig;
+    /**
+     * 将输入项解析为 Blob 和文件名
+     */
+    private resolveFileData;
+    /**
+     * Node.js 环境：从文件系统读取图片
+     */
+    private resolveNodeFilePath;
+    /**
+     * 浏览器环境：通过 URL 获取图片数据
+     */
+    private resolveBrowserUrlOrPath;
+    /**
+     * 构建带 API Key 的请求 URL
+     */
+    private buildRequestUrl;
+}
+export { PicListUploader };

package/dist/src/core/PicListUploader.spec.d.ts

@@ -0,0 +1 @@
+export {};