universal-picgo 1.12.1 → 2.0.0

package/README.md

@@ -19,6 +19,54 @@ try {
 }
 ```
 
+## Headless manager contract
+
+`universal-picgo` also exports a UI-free manager for external consumers that
+own their own settings UI. The manager owns PicGo config shape, uploader schema,
+validation, current uploader state and upload execution; consumers should not
+copy uploader field definitions from `picgo-plugin-app`.
+
+```ts
+import { createPicGoHeadlessManager } from "universal-picgo"
+
+const manager = createPicGoHeadlessManager({
+  configPath,
+  runtimeDir,
+  pluginBaseDir,
+})
+
+const uploaders = manager.listUploaders()
+const schema = manager.getUploaderSchema("github")
+
+const validation = manager.saveUploaderConfig(
+  "github",
+  {
+    repo,
+    branch,
+    token,
+    path,
+    customUrl,
+  },
+  { setCurrent: true }
+)
+
+if (!validation.ok) {
+  console.error(validation.errors)
+}
+
+const result = await manager.upload(input)
+```
+
+The public methods are:
+
+- `getConfig()` / `getUploaderConfig(id)`：读取已初始化默认 section 的配置，并保留未知字段。
+- `listUploaders()`：列出 `universal-picgo` 注册的内置上传器。
+- `getUploaderSchema(id)`：返回普通可序列化的轻量表单字段元数据。
+- `validateUploaderConfig(id, config)`：返回结构化字段级校验结果。
+- `saveUploaderConfig(id, config, options)`：只写目标 `picBed.<id>` section；`unsafeRaw` 是文档化的高级逃逸口。
+- `getCurrentUploader()` / `setCurrentUploader(id)`：使用 PicGo 标准 `picBed.uploader` / `picBed.current` 结构。
+- `upload(input)`：上传前使用同一 schema 校验当前上传器配置。
+
 ## Deps
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-picgo",
-  "version": "1.12.1",
+  "version": "2.0.0",
   "type": "module",
   "description": "picgo lib for node, browser and electron",
   "main": "./dist/index.js",
@@ -21,7 +21,6 @@
     "@terwer/eslint-config-custom": "^1.3.6",
     "@terwer/vite-config-custom": "^0.7.6",
     "@types/mime": "^4.0.0",
-    "@types/mime-types": "^2.1.4",
     "vite-plugin-node-polyfills": "^0.22.0"
   },
   "dependencies": {
@@ -31,17 +30,15 @@
     "@smithy/protocol-http": "^4.0.0",
     "@smithy/querystring-builder": "^3.0.0",
     "@smithy/fetch-http-handler": "^3.0.1",
-    "@picgo/i18n": "^1.0.0",
-    "ali-oss": "^6.20.0",
     "axios": "^1.6.8",
     "dayjs": "^1.11.11",
+    "hash.js": "^1.1.7",
+    "js-md5": "^0.8.3",
     "js-yaml": "^4.1.0",
     "mime": "^4.0.3",
-    "mime-types": "^2.1.35",
     "queue": "^7.0.0",
     "zhi-lib-base": "^0.8.0",
-    "file-type": "^16.2.0",
-    "universal-picgo-store": "1.12.1"
+    "universal-picgo-store": "2.0.0"
   },
   "publishConfig": {
     "access": "public"

package/dist/README.md

@@ -1,52 +0,0 @@
-# universal-picgo
-
-picgo lib for node, browser and electron
-
-## Usage
-
-```js
-// usage
-import { UniversalPicGo } from "universal-picgo"
-
-try {
-  const picgo = new UniversalPicGo()
-  console.log("picgo =>", picgo)
-
-  const result = await picgo.upload()
-  console.log("upload success =>", result)
-} catch (e: any) {
-  console.error(e)
-}
-```
-
-## Deps
-
-```
-├── universal-picgo-store
-```
-
-## Dev
-
-```bash
-pnpm dev -F universal-picgo
-```
-
-## Build
-
-```bash
-pnpm build -F universal-picgo
-```
-
-## Test
-
-Execute the unit tests via [vitest](https://vitest.dev)
-
-```bash
-pnpm test -F universal-picgo
-```
-
-## Publish
-
-```bash
-pnpm publish -F universal-picgo --tag latest
-```

package/dist/index.d.ts

@@ -1 +0,0 @@
-export * from './src/index'