@components-kit/open-workbook-backend 0.1.0

package/dist/state-store.d.ts

@@ -0,0 +1,26 @@
+import type { BackupRecord, PlanRecord, TemplateRecord } from "@components-kit/open-workbook-excel-core";
+import type { AgentRecord, CollaborationEvent, ConflictRecord, ConflictTelemetryRecord, LockLeasePolicy, LockRecord, PermissionState, TaskRecord, TransactionRecord, WorkbookRegion } from "@components-kit/open-workbook-protocol";
+export interface RuntimeStateSnapshot {
+    version: 1;
+    savedAt: string;
+    agents: AgentRecord[];
+    tasks: TaskRecord[];
+    locks: LockRecord[];
+    lockLeasePolicy?: LockLeasePolicy | undefined;
+    transactions: TransactionRecord[];
+    conflicts: ConflictRecord[];
+    conflictTelemetry?: ConflictTelemetryRecord[] | undefined;
+    collaborationEvents: CollaborationEvent[];
+    templates?: TemplateRecord[] | undefined;
+    regions?: WorkbookRegion[] | undefined;
+    permissions?: PermissionState | undefined;
+    plans?: PlanRecord[] | undefined;
+    backups?: BackupRecord[] | undefined;
+}
+export declare class RuntimeStateStore {
+    readonly filePath: string;
+    constructor(stateDir?: string);
+    load(): RuntimeStateSnapshot | undefined;
+    save(snapshot: RuntimeStateSnapshot): void;
+}
+//# sourceMappingURL=state-store.d.ts.map

package/dist/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../src/state-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AACzG,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,UAAU,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,cAAc,EACf,MAAM,wCAAwC,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,iBAAiB,CAAC,EAAE,uBAAuB,EAAE,GAAG,SAAS,CAAC;IAC1D,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,SAAS,CAAC,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;IACzC,OAAO,CAAC,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;IACvC,WAAW,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;CACtC;AAED,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,SAAoB;IAIxC,IAAI,IAAI,oBAAoB,GAAG,SAAS;IA2BxC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;CAM3C"}

package/dist/state-store.js

@@ -0,0 +1,44 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import path from "node:path";
+export class RuntimeStateStore {
+    filePath;
+    constructor(stateDir = defaultStateDir()) {
+        this.filePath = path.join(stateDir, "collaboration-state.json");
+    }
+    load() {
+        if (!existsSync(this.filePath)) {
+            return undefined;
+        }
+        const parsed = JSON.parse(readFileSync(this.filePath, "utf8"));
+        if (parsed.version !== 1) {
+            return undefined;
+        }
+        return {
+            version: 1,
+            savedAt: parsed.savedAt ?? new Date(0).toISOString(),
+            agents: parsed.agents ?? [],
+            tasks: parsed.tasks ?? [],
+            locks: parsed.locks ?? [],
+            lockLeasePolicy: parsed.lockLeasePolicy,
+            transactions: parsed.transactions ?? [],
+            conflicts: parsed.conflicts ?? [],
+            conflictTelemetry: parsed.conflictTelemetry ?? [],
+            collaborationEvents: parsed.collaborationEvents ?? [],
+            templates: parsed.templates ?? [],
+            regions: parsed.regions ?? [],
+            permissions: parsed.permissions,
+            plans: parsed.plans ?? [],
+            backups: parsed.backups ?? []
+        };
+    }
+    save(snapshot) {
+        mkdirSync(path.dirname(this.filePath), { recursive: true });
+        const tmpPath = `${this.filePath}.${process.pid}.tmp`;
+        writeFileSync(tmpPath, `${JSON.stringify(snapshot, null, 2)}\n`, "utf8");
+        renameSync(tmpPath, this.filePath);
+    }
+}
+function defaultStateDir() {
+    return process.env.OPEN_WORKBOOK_STATE_DIR ?? path.resolve(process.cwd(), ".open-workbook/state");
+}
+//# sourceMappingURL=state-store.js.map

package/dist/state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../src/state-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,IAAI,MAAM,WAAW,CAAC;AAiC7B,MAAM,OAAO,iBAAiB;IACnB,QAAQ,CAAS;IAE1B,YAAY,QAAQ,GAAG,eAAe,EAAE;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;IAClE,CAAC;IAED,IAAI;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAkC,CAAC;QAChG,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;YACpD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;YACzB,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;YACvC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;YACjC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,EAAE;YACjD,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,EAAE;YACrD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;SAC9B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAA8B;QACjC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QACtD,aAAa,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF;AAED,SAAS,eAAe;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;AACpG,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@components-kit/open-workbook-backend",
+  "version": "0.1.0",
+  "description": "Local backend broker for Open Workbook add-in sessions, backups, snapshots, plans, and permissions.",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://github.com/components-kit/open-workbook#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/components-kit/open-workbook.git",
+    "directory": "apps/backend"
+  },
+  "bugs": {
+    "url": "https://github.com/components-kit/open-workbook/issues"
+  },
+  "keywords": [
+    "excel",
+    "mcp",
+    "office-js",
+    "websocket",
+    "spreadsheet"
+  ],
+  "exports": {
+    "./runtime": {
+      "types": "./dist/runtime-service.d.ts",
+      "default": "./dist/runtime-service.js"
+    },
+    "./server": {
+      "types": "./dist/addin-websocket-server.d.ts",
+      "default": "./dist/addin-websocket-server.js"
+    },
+    "./file-bridge": {
+      "types": "./dist/native-file-bridge-server.d.ts",
+      "default": "./dist/native-file-bridge-server.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ws": "^8.18.0",
+    "@components-kit/open-workbook-excel-core": "0.1.0",
+    "@components-kit/open-workbook-protocol": "0.1.0",
+    "@components-kit/open-workbook-office-js-engine": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.13",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "dev": "node --enable-source-maps dist/index.js"
+  }
+}