@voltius/plugin-types 0.36.0 → 0.38.0

package/index.d.ts

@@ -320,12 +320,40 @@ export interface PluginTransfer {
   owner?: string;
 }
 
+export type SyncProviderStatus = "idle" | "syncing" | "success" | "error" | "offline";
+
+export type SyncProviderAvailability = "active" | "not_configured" | "disabled" | "locked" | "needs_upgrade";
+
+/** What a sync provider plugin publishes under `publishState("sync-state", …)`. */
+export interface SyncProviderState {
+  status: SyncProviderStatus;
+  lastSync: Date | string | number | null;
+  error: string | null;
+  blobSizeBytes: number | null;
+  configured: boolean;
+}
+
+/** What a sync provider plugin passes to `plugins.expose`. */
+export interface SyncProviderPublicApi {
+  syncNow(): Promise<void>;
+}
+
+export interface SyncProviderSummary {
+  id: string;
+  label: string;
+  availability: SyncProviderAvailability;
+  status: SyncProviderStatus;
+  lastSync: string | null;
+  error: string | null;
+}
+
 export interface PluginSyncState {
-  status: "idle" | "syncing" | "success" | "error" | "offline";
+  status: SyncProviderStatus;
   lastSync: string | null;
   error: string | null;
   cloudActive: boolean;
   blobSizeBytes: number | null;
+  providers: SyncProviderSummary[];
 }
 
 export interface PluginHostPing {
@@ -1268,7 +1296,7 @@ export interface PluginAPI {
     /** Publish a plain, serialisable state snapshot for host UI to read, keyed
      *  by `<pluginId>::<key>`. Host surfaces subscribe to this instead of
      *  importing the plugin's runtime module. Cleared on unload/disable. */
-    publishState(key: string, value: unknown): void;
+    publishState<K extends string>(key: K, value: K extends "sync-state" ? SyncProviderState : unknown): void;
   };
 
   // Plugin-scoped key-value storage

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltius/plugin-types",
-  "version": "0.36.0",
+  "version": "0.38.0",
   "description": "TypeScript definitions for the Voltius plugin API",
   "types": "index.d.ts",
   "files": [