@coralai/sps-plugin-storage-sync 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -31,6 +31,7 @@ interface ApplyCtx {
     };
     reflect: {
         get(name: string): unknown;
+        provide(name: string, value?: unknown): () => void;
     };
 }
 export declare function apply(ctx: ApplyCtx, config: StorageSyncConfig): void;

package/dist/index.js

@@ -1,3 +1,4 @@
+import { MinioBackend } from './MinioBackend.js';
 import { runSyncPass } from './syncRunner.js';
 export { Config } from './schema.js';
 export const name = 'storage-sync';
@@ -58,6 +59,19 @@ export function apply(ctx, config) {
             ctx.logger?.warn?.(`[sps-sync] 一轮失败(忽略): ${err instanceof Error ? err.message : String(err)}`);
         }
     };
+    // 🔴 **把桶的读写能力提供出去** —— 宿主不认识桶,但别的插件可能需要读它
+    //    (实例:`gameforge-art` 读 `library/public/audio/<product>/` 当 BGM 兜底)。
+    //    2026-08-28 事故:宿主删掉 `sps.storage` 时只扫了自己仓内的消费方,
+    //    没查线上装着的插件 ⇒ gameforge-art 永远 PENDING、六个 art.* 能力全缺席。
+    //    ⇒ 契约留在 `@coralai/sps-plugin-api`,**实现跟着持有桶凭据的这个插件走**。
+    const backend = new MinioBackend(config);
+    const disposeStorage = ctx.reflect.provide('sps.storage', {
+        configured: () => Boolean(config.endpoint && config.bucket && config.enabled !== false),
+        get: (key) => backend.get(key),
+        list: (prefix) => backend.list(prefix),
+        put: (key, bytes, contentType) => backend.put(key, bytes, contentType),
+    });
+    ctx.effect(() => disposeStorage());
     log(`[sps-sync] 常驻:间隔=${intervalMs}ms 范围=近 ${sinceDays || '∞'} 天`);
     void tick().finally(schedule);
     // 插件卸载/重挂时停掉循环 —— 否则改一次配置就多一个循环在跑。

package/dist/schema.js

@@ -15,7 +15,7 @@ import Schema from '@deepseek-ai/schemastery';
 export const Config = Schema.object({
     enabled: Schema.boolean()
         .default(false)
-        .description('是否开启同步。**默认关** —— 没配桶时开着只会每轮打日志。'),
+        .description('是否开启同步。默认关 —— 没配桶时开着只会每轮打日志。'),
     endpoint: Schema.string().description('S3 兼容端点,如 http://127.0.0.1:9000'),
     bucket: Schema.string().description('桶名。插件只认这一个名字,不认识桶里的语义分区。'),
     accessKey: Schema.string().role('secret').description('访问密钥 ID'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralai/sps-plugin-storage-sync",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "工作区 → 对象存储同步:把节点本地盘上的用户产物搬到共享面(S3 兼容桶)。",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,7 +28,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@coralai/sps-plugin-api": "^0.13.0"
+    "@coralai/sps-plugin-api": "^0.14.0"
   },
   "optionalDependencies": {
     "minio": "^8.0.7"