universal-picgo 2.1.1 → 3.0.1

package/dist/src/db/externalPicGo/index.d.ts

@@ -13,6 +13,7 @@ declare class ExternalPicgoConfigDb implements IPicgoDb<IExternalPicgoConfig> {
         picListApiUrl: string;
         picListApiKey: string;
     };
+    private initReady;
     constructor(ctx: IPicGo);
     read(flush?: boolean): IJSON;
     get(key: string): any;
@@ -21,6 +22,21 @@ declare class ExternalPicgoConfigDb implements IPicgoDb<IExternalPicgoConfig> {
     unset(key: string, value: any): boolean;
     saveConfig(config: Partial<IExternalPicgoConfig>): void;
     removeConfig(config: IExternalPicgoConfig): void;
+    get isAsync(): boolean;
+    /**
+     * Wait for async backend to load remote data.
+     *
+     * PicGo 3.0: Local defaults are seeded immediately in the constructor
+     * for UI display. When ensureReady() resolves:
+     *   - If remote data exists, it replaces the local defaults.
+     *   - If remote data is missing, local defaults are kept and persisted.
+     *
+     * This prevents the v2 bug where constructor-time safeSet would
+     * overwrite real remote user configuration with generated defaults.
+     */
+    ensureReady(): Promise<void>;
+    flush(): Promise<void>;
+    private doSafeSet;
     safeSet(key: string, value: any): void;
 }
 export default ExternalPicgoConfigDb;

package/dist/src/headless/UniversalPicGoHeadlessManager.d.ts

@@ -5,17 +5,18 @@ declare class UniversalPicGoHeadlessManager implements IPicGoHeadlessManager {
     private readonly ctx;
     constructor(options?: PicGoHeadlessManagerOptions);
     getContext(): IPicGo;
-    getConfig(): IConfig;
-    getCurrentUploader(): string;
-    setCurrentUploader(uploaderId: string): PicGoValidationResult;
+    getConfig(): Promise<IConfig>;
+    getCurrentUploader(): Promise<string>;
+    setCurrentUploader(uploaderId: string): Promise<PicGoValidationResult>;
     listUploaders(): PicGoUploaderListItem[];
     getUploaderSchema(uploaderId: string): PicGoUploaderConfigSchema;
-    getUploaderConfig<T extends Record<string, unknown> = Record<string, unknown>>(uploaderId: string): T;
+    getUploaderConfig<T extends Record<string, unknown> = Record<string, unknown>>(uploaderId: string): Promise<T>;
     validateUploaderConfig(uploaderId: string, config: Record<string, unknown>): PicGoValidationResult;
-    saveUploaderConfig(uploaderId: string, config: Record<string, unknown>, options?: PicGoHeadlessSaveUploaderConfigOptions): PicGoValidationResult;
+    saveUploaderConfig(uploaderId: string, config: Record<string, unknown>, options?: PicGoHeadlessSaveUploaderConfigOptions): Promise<PicGoValidationResult>;
     auditUploaderSchemas(): PicGoUploaderSchemaAuditResult;
     upload(input?: any[]): Promise<IImgInfo[]>;
     private hasUploader;
+    private ensureReady;
     private withSchemaDefaults;
     private unknownUploaderResult;
     private unknownUploaderError;

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

@@ -79,14 +79,14 @@ export interface PicGoHeadlessSaveUploaderConfigOptions {
 }
 export interface IPicGoHeadlessManager {
     getContext(): IPicGo;
-    getConfig(): IConfig;
-    getCurrentUploader(): string;
-    setCurrentUploader(uploaderId: string): PicGoValidationResult;
+    getConfig(): Promise<IConfig>;
+    getCurrentUploader(): Promise<string>;
+    setCurrentUploader(uploaderId: string): Promise<PicGoValidationResult>;
     listUploaders(): PicGoUploaderListItem[];
     getUploaderSchema(uploaderId: string): PicGoUploaderConfigSchema;
-    getUploaderConfig<T extends Record<string, unknown> = Record<string, unknown>>(uploaderId: string): T;
+    getUploaderConfig<T extends Record<string, unknown> = Record<string, unknown>>(uploaderId: string): Promise<T>;
     validateUploaderConfig(uploaderId: string, config: Record<string, unknown>): PicGoValidationResult;
-    saveUploaderConfig(uploaderId: string, config: Record<string, unknown>, options?: PicGoHeadlessSaveUploaderConfigOptions): PicGoValidationResult;
+    saveUploaderConfig(uploaderId: string, config: Record<string, unknown>, options?: PicGoHeadlessSaveUploaderConfigOptions): Promise<PicGoValidationResult>;
     auditUploaderSchemas(): PicGoUploaderSchemaAuditResult;
     upload(input?: any[]): Promise<IImgInfo[]>;
 }

package/dist/src/headless/uploaderSchemas.d.ts

@@ -3,7 +3,7 @@ import { IPicGo } from '../types';
 
 export declare const BUILT_IN_UPLOADER_IDS: readonly ["github", "gitlab", "aliyun", "tcyun", "qiniu", "upyun", "smms", "imgur", "awss3", "lsky"];
 export type BuiltInUploaderId = (typeof BUILT_IN_UPLOADER_IDS)[number];
-export declare const isBuiltInUploaderId: (uploaderId: string) => uploaderId is "smms" | "github" | "gitlab" | "aliyun" | "tcyun" | "qiniu" | "upyun" | "imgur" | "awss3" | "lsky";
+export declare const isBuiltInUploaderId: (uploaderId: string) => uploaderId is "smms" | "lsky" | "github" | "gitlab" | "aliyun" | "tcyun" | "qiniu" | "upyun" | "imgur" | "awss3";
 export declare const listPicGoUploaders: (ctx: IPicGo) => PicGoUploaderListItem[];
 export declare const getPicGoUploaderSchema: (ctx: IPicGo, uploaderId: string) => PicGoUploaderConfigSchema | undefined;
 export declare const auditBuiltInUploaderSchemas: (ctx: IPicGo) => PicGoUploaderSchemaAuditResult;

package/dist/src/index.d.ts

@@ -21,5 +21,6 @@ export { isFileOrBlob, calculateMD5, isSiyuanProxyAvailable };
 export { deepMerge, getByPath, setByPath, unsetByPath };
 export { isElectronRuntime, isPicGoPluginPackageName, isThirdPartyPluginRuntimeAvailable };
 export { win, currentWin, parentWin, hasNodeEnv };
+export { createUnifiedPicGoConfigFacade, type ConfigDomain, type ReadyUnifiedPicGoConfigFacade, type UnifiedConfigSnapshot, type UnifiedConfigMigrationState, type UnifiedPicGoConfigFacadeOptions, type UnifiedConfigPaths, type PasteTakeoverSnapshot, type SiyuanConfigLike, UNIFIED_CONFIG_MIGRATION_VERSION, ConfigReadError, ConfigFlushError, ConfigNotReadyError, } from './config';
 export { type IPicGo, type IImgInfo, type IPicgoDb, type IConfig, type IExternalPicgoConfig, type IPicBedType, type IUploaderConfigItem, type IUploaderConfigListItem, type IPluginConfig, type IPicGoPlugin, type IUniversalPicGoOptions, };
 export { BUILT_IN_UPLOADER_IDS, PICGO_HEADLESS_ERROR_CODES, PicGoHeadlessError, auditBuiltInUploaderSchemas, getPicGoUploaderSchema, isBuiltInUploaderId, listPicGoUploaders, type BuiltInUploaderId, type IPicGoHeadlessManager, type PicGoHeadlessErrorCode, type PicGoHeadlessErrorInput, type PicGoHeadlessManagerOptions, type PicGoHeadlessSaveUploaderConfigOptions, type PicGoUploaderConfigSchema, type PicGoUploaderListItem, type PicGoUploaderSchemaAuditResult, type PicGoUploaderSchemaChoice, type PicGoUploaderSchemaField, type PicGoUploaderSchemaFieldType, type PicGoValidationFieldError, type PicGoValidationResult, } from './headless';

package/dist/src/utils/common.d.ts

@@ -130,8 +130,8 @@ export declare const getNormalPluginName: (nameOrPath: string, logger: ILogger)
 /**
  * 思源笔记内置代理是否可用。
  *
- * `siyuan.proxy` 中保存的端口会随思源重启失效，因此这里不再依赖落盘 origin，
- * 只判断当前运行时 window 是否为思源环境。
+ * 快速路径：`win.siyuan` 全局对象存在（iframe / Electron）→ 直接 true。
+ * 回退路径：同域浏览器直开时通过同步 HEAD 请求验证 API 可达性。
  */
 export declare const isSiyuanProxyAvailable: () => boolean;
 export declare const getSiyuanProxyUrl: () => any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-picgo",
-  "version": "2.1.1",
+  "version": "3.0.1",
   "type": "module",
   "description": "picgo lib for node, browser and electron",
   "main": "./dist/index.js",
@@ -38,7 +38,7 @@
     "mime": "^4.0.3",
     "queue": "^7.0.0",
     "zhi-lib-base": "^0.8.0",
-    "universal-picgo-store": "2.1.1"
+    "universal-picgo-store": "3.0.1"
   },
   "publishConfig": {
     "access": "public"
@@ -48,6 +48,7 @@
     "dev": "vite build --watch",
     "build": "vite build",
     "start": "vite preview",
-    "test": "npx vitest --watch"
+    "test": "vitest run",
+    "test:watch": "npx vitest --watch"
   }
 }