@dxos/client-services 0.1.49 → 0.1.50-next.1bfebf8

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

@@ -5,4 +5,5 @@ export * from './packlets/services';
 export * from './packlets/spaces';
 export * from './packlets/storage';
 export * from './packlets/vault';
+export * from './packlets/locks';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/types/src/packlets/locks/browser.d.ts

@@ -0,0 +1,16 @@
+import { ResourceLock, ResourceLockOptions } from './resource-lock';
+export declare class Lock implements ResourceLock {
+    private readonly _broadcastChannel;
+    private readonly _lockKey;
+    private readonly _onAcquire;
+    private readonly _onRelease;
+    private _releaseTrigger;
+    constructor({ lockKey, onAcquire, onRelease }: ResourceLockOptions);
+    get lockKey(): string;
+    acquire(): Promise<void>;
+    release(): Promise<void>;
+    private _onMessage;
+    private _requestLock;
+}
+export declare const isLocked: (lockPath: string) => never;
+//# sourceMappingURL=browser.d.ts.map

package/dist/types/src/packlets/locks/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../../src/packlets/locks/browser.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAQpE,qBAAa,IAAK,YAAW,YAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA+C;IACjF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,eAAe,CAAiB;gBAE5B,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,mBAAmB;IAOlE,IACI,OAAO,WAEV;IAEK,OAAO;IAgBP,OAAO;IAIb,OAAO,CAAC,UAAU;YAMJ,YAAY;CAqB3B;AAGD,eAAO,MAAM,QAAQ,aAAc,MAAM,UAExC,CAAC"}

package/dist/types/src/packlets/locks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './resource-lock';
+export * from './node';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/packlets/locks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/packlets/locks/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC"}

package/dist/types/src/packlets/locks/node.d.ts

@@ -0,0 +1,13 @@
+import { ResourceLock, ResourceLockOptions } from './resource-lock';
+export declare class Lock implements ResourceLock {
+    private readonly _lockPath;
+    private readonly _onAcquire;
+    private readonly _onRelease;
+    private _releaseTrigger;
+    constructor({ lockKey: lockPath, onAcquire, onRelease }: ResourceLockOptions);
+    get lockKey(): string;
+    acquire(): Promise<void>;
+    release(): Promise<void>;
+}
+export declare const isLocked: (lockPath: string) => boolean;
+//# sourceMappingURL=node.d.ts.map

package/dist/types/src/packlets/locks/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../../src/packlets/locks/node.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGpE,qBAAa,IAAK,YAAW,YAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,eAAe,CAAiB;gBAE5B,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,mBAAmB;IAM5E,IACI,OAAO,WAEV;IAEK,OAAO;IAYP,OAAO;CAQd;AAED,eAAO,MAAM,QAAQ,aAAc,MAAM,YAAiC,CAAC"}

package/dist/types/src/packlets/locks/resource-lock.d.ts

@@ -0,0 +1,16 @@
+import { MaybePromise } from '@dxos/util';
+export type ResourceLockOptions = {
+    lockKey: string;
+    onAcquire?: () => MaybePromise<void>;
+    onRelease?: () => MaybePromise<void>;
+};
+/**
+ * Resource lock. Used to coordinate access to shared resources.
+ * For example, start only one `ServicesHost` at a time.
+ */
+export interface ResourceLock {
+    lockKey: string;
+    acquire(): Promise<void>;
+    release(): Promise<void>;
+}
+//# sourceMappingURL=resource-lock.d.ts.map

package/dist/types/src/packlets/locks/resource-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-lock.d.ts","sourceRoot":"","sources":["../../../../../src/packlets/locks/resource-lock.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;CACtC,CAAC;AAGF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/types/src/packlets/services/service-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-host.d.ts","sourceRoot":"","sources":["../../../../../src/packlets/services/service-host.ts"],"names":[],"mappings":"AAOA,OAAO,EAAuB,cAAc,EAA6B,MAAM,uBAAuB,CAAC;AACvG,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC,OAAO,EAAE,aAAa,EAA0B,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAgD,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGvG,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAYtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAErD,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;IAE3B,eAAe,EAAG,cAAc,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;gBAEV,EACV,MAAM,EACN,YAA0C,EAE1C,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,OAAO,EAEP,OAAO,GACR,GAAE,wBAA6B;IAgDhC,IAAI,MAAM,YAET;IAED,IAAI,eAAe,oCAElB;IAED,IAAI,WAAW,sDAEd;IAED,IAAI,QAAQ,4BAEX;IAED;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,iBAAiB;IA6B9C,IAAI;IAyEJ,KAAK;IAeL,KAAK;CAUZ"}
+{"version":3,"file":"service-host.d.ts","sourceRoot":"","sources":["../../../../../src/packlets/services/service-host.ts"],"names":[],"mappings":"AAOA,OAAO,EAAuB,cAAc,EAA6B,MAAM,uBAAuB,CAAC;AACvG,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC,OAAO,EAAE,aAAa,EAA0B,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAgD,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGvG,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAYtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAe;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAErD,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;IAE3B,eAAe,EAAG,cAAc,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;gBAEV,EACV,MAAM,EACN,YAA0C,EAE1C,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,OAAO,EAEP,OAAO,GACR,GAAE,wBAA6B;IAgDhC,IAAI,MAAM,YAET;IAED,IAAI,eAAe,oCAElB;IAED,IAAI,WAAW,sDAEd;IAED,IAAI,QAAQ,4BAEX;IAED;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,iBAAiB;IA6B9C,IAAI;IAyEJ,KAAK;IAeL,KAAK;CAUZ"}

package/dist/types/src/packlets/vault/index.d.ts

@@ -1,7 +1,6 @@
 export * from './iframe-host-runtime';
 export * from './iframe-proxy-runtime';
 export * from './shell-runtime';
-export * from './vault-resource-lock';
 export * from './worker-runtime';
 export * from './worker-session';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/packlets/vault/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/packlets/vault/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/packlets/vault/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/client-services",
-  "version": "0.1.49",
+  "version": "0.1.50-next.1bfebf8",
   "description": "DXOS client services implementation",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -9,6 +9,7 @@
   "main": "dist/lib/node/index.cjs",
   "browser": {
     "jsondown": false,
+    "./src/packlets/locks/node.ts": "./src/packlets/locks/browser.ts",
     "./dist/lib/node/index.cjs": "./dist/lib/browser/index.mjs",
     "./testing.js": "./dist/lib/browser/packlets/testing/index.mjs"
   },
@@ -20,38 +21,40 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/async": "0.1.49",
-    "@dxos/client-protocol": "0.1.49",
-    "@dxos/codec-protobuf": "0.1.49",
-    "@dxos/config": "0.1.49",
-    "@dxos/context": "0.1.49",
-    "@dxos/credentials": "0.1.49",
-    "@dxos/debug": "0.1.49",
-    "@dxos/document-model": "0.1.49",
-    "@dxos/echo-db": "0.1.49",
-    "@dxos/crypto": "0.1.49",
-    "@dxos/echo-pipeline": "0.1.49",
-    "@dxos/errors": "0.1.49",
-    "@dxos/feed-store": "0.1.49",
-    "@dxos/keyring": "0.1.49",
-    "@dxos/keys": "0.1.49",
-    "@dxos/log": "0.1.49",
-    "@dxos/messaging": "0.1.49",
-    "@dxos/model-factory": "0.1.49",
-    "@dxos/network-manager": "0.1.49",
-    "@dxos/node-std": "0.1.49",
-    "@dxos/protocols": "0.1.49",
-    "@dxos/random-access-storage": "0.1.49",
-    "@dxos/rpc": "0.1.49",
-    "@dxos/teleport": "0.1.49",
-    "@dxos/teleport-extension-gossip": "0.1.49",
-    "@dxos/text-model": "0.1.49",
-    "@dxos/timeframe": "0.1.49",
-    "@dxos/util": "0.1.49"
+    "@types/lockfile": "^1.0.2",
+    "lockfile": "^1.0.4",
+    "@dxos/async": "0.1.50-next.1bfebf8",
+    "@dxos/client-protocol": "0.1.50-next.1bfebf8",
+    "@dxos/codec-protobuf": "0.1.50-next.1bfebf8",
+    "@dxos/config": "0.1.50-next.1bfebf8",
+    "@dxos/context": "0.1.50-next.1bfebf8",
+    "@dxos/credentials": "0.1.50-next.1bfebf8",
+    "@dxos/crypto": "0.1.50-next.1bfebf8",
+    "@dxos/debug": "0.1.50-next.1bfebf8",
+    "@dxos/document-model": "0.1.50-next.1bfebf8",
+    "@dxos/echo-db": "0.1.50-next.1bfebf8",
+    "@dxos/echo-pipeline": "0.1.50-next.1bfebf8",
+    "@dxos/errors": "0.1.50-next.1bfebf8",
+    "@dxos/feed-store": "0.1.50-next.1bfebf8",
+    "@dxos/keyring": "0.1.50-next.1bfebf8",
+    "@dxos/keys": "0.1.50-next.1bfebf8",
+    "@dxos/log": "0.1.50-next.1bfebf8",
+    "@dxos/messaging": "0.1.50-next.1bfebf8",
+    "@dxos/model-factory": "0.1.50-next.1bfebf8",
+    "@dxos/network-manager": "0.1.50-next.1bfebf8",
+    "@dxos/node-std": "0.1.50-next.1bfebf8",
+    "@dxos/protocols": "0.1.50-next.1bfebf8",
+    "@dxos/random-access-storage": "0.1.50-next.1bfebf8",
+    "@dxos/rpc": "0.1.50-next.1bfebf8",
+    "@dxos/teleport": "0.1.50-next.1bfebf8",
+    "@dxos/teleport-extension-gossip": "0.1.50-next.1bfebf8",
+    "@dxos/text-model": "0.1.50-next.1bfebf8",
+    "@dxos/timeframe": "0.1.50-next.1bfebf8",
+    "@dxos/util": "0.1.50-next.1bfebf8"
   },
   "devDependencies": {
     "@types/readable-stream": "^2.3.9",
-    "@dxos/signal": "0.1.49"
+    "@dxos/signal": "0.1.50-next.1bfebf8"
   },
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -9,3 +9,4 @@ export * from './packlets/services';
 export * from './packlets/spaces';
 export * from './packlets/storage';
 export * from './packlets/vault';
+export * from './packlets/locks';

package/src/packlets/{vault/vault-resource-lock.ts → locks/browser.ts}

@@ -5,27 +5,23 @@
 import { asyncTimeout, Trigger } from '@dxos/async';
 import { RESOURCE_LOCK_TIMEOUT } from '@dxos/client-protocol';
 import { log, logInfo } from '@dxos/log';
-import { MaybePromise } from '@dxos/util';
+
+import { ResourceLock, ResourceLockOptions } from './resource-lock';
 
 enum Message {
   ACQUIRING = 'acquiring',
 }
 
-export type VaultResourceLockOptions = {
-  lockKey: string;
-  onAcquire?: () => MaybePromise<void>;
-  onRelease?: () => MaybePromise<void>;
-};
-
+// TODO(mykola): Factor out.
 // TODO(burdon): Extend to support locking for web and NodeJS (use npm lockfile). Use to lock agents.
-export class VaultResourceLock {
+export class Lock implements ResourceLock {
   private readonly _broadcastChannel = new BroadcastChannel('vault-resource-lock');
   private readonly _lockKey: string;
-  private readonly _onAcquire: VaultResourceLockOptions['onAcquire'];
-  private readonly _onRelease: VaultResourceLockOptions['onRelease'];
+  private readonly _onAcquire: ResourceLockOptions['onAcquire'];
+  private readonly _onRelease: ResourceLockOptions['onRelease'];
   private _releaseTrigger = new Trigger();
 
-  constructor({ lockKey, onAcquire, onRelease }: VaultResourceLockOptions) {
+  constructor({ lockKey, onAcquire, onRelease }: ResourceLockOptions) {
     this._lockKey = lockKey;
     this._onAcquire = onAcquire;
     this._onRelease = onRelease;
@@ -85,3 +81,8 @@ export class VaultResourceLock {
     log('recieved lock', { steal });
   }
 }
+
+// TODO(mykola): Implement.
+export const isLocked = (lockPath: string) => {
+  throw new Error('Not implemented');
+};

package/src/packlets/locks/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export * from './resource-lock';
+export * from './node';

package/src/packlets/locks/node.ts

@@ -0,0 +1,52 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import lockfile from 'lockfile';
+
+import { Trigger } from '@dxos/async';
+import { log, logInfo } from '@dxos/log';
+
+import { ResourceLock, ResourceLockOptions } from './resource-lock';
+
+// TODO(mykola): Factor out.
+export class Lock implements ResourceLock {
+  private readonly _lockPath: string;
+  private readonly _onAcquire: ResourceLockOptions['onAcquire'];
+  private readonly _onRelease: ResourceLockOptions['onRelease'];
+  private _releaseTrigger = new Trigger();
+
+  constructor({ lockKey: lockPath, onAcquire, onRelease }: ResourceLockOptions) {
+    this._lockPath = lockPath;
+    this._onAcquire = onAcquire;
+    this._onRelease = onRelease;
+  }
+
+  @logInfo
+  get lockKey() {
+    return this._lockPath;
+  }
+
+  async acquire() {
+    log('acquiring lock...');
+    if (lockfile.checkSync(this.lockKey)) {
+      throw new Error(`Lock already acquired: ${this._lockPath}`);
+    }
+
+    lockfile.lockSync(this._lockPath);
+    await this._onAcquire?.();
+
+    log('acquired lock');
+  }
+
+  async release() {
+    if (!lockfile.checkSync(this._lockPath)) {
+      throw new Error(`Lock already acquired: ${this._lockPath}`);
+    }
+
+    await this._onRelease?.();
+    lockfile.unlockSync(this._lockPath);
+  }
+}
+
+export const isLocked = (lockPath: string) => lockfile.checkSync(lockPath);

package/src/packlets/locks/resource-lock.ts

@@ -0,0 +1,24 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { MaybePromise } from '@dxos/util';
+
+export type ResourceLockOptions = {
+  lockKey: string;
+  onAcquire?: () => MaybePromise<void>;
+  onRelease?: () => MaybePromise<void>;
+};
+
+// TODO(mykola): Factor out.
+/**
+ * Resource lock. Used to coordinate access to shared resources.
+ * For example, start only one `ServicesHost` at a time.
+ */
+export interface ResourceLock {
+  lockKey: string;
+
+  acquire(): Promise<void>;
+
+  release(): Promise<void>;
+}

package/src/packlets/services/service-host.ts

@@ -21,12 +21,12 @@ import { DevicesServiceImpl } from '../devices';
 import { DevtoolsServiceImpl, DevtoolsHostEvents } from '../devtools';
 import { IdentityServiceImpl } from '../identity';
 import { InvitationsServiceImpl } from '../invitations';
+import { Lock, ResourceLock } from '../locks';
 import { LoggingServiceImpl } from '../logging';
 import { NetworkServiceImpl } from '../network';
 import { SpacesServiceImpl } from '../spaces';
 import { createStorageObjects } from '../storage';
 import { SystemServiceImpl } from '../system';
-import { VaultResourceLock } from '../vault';
 import { ServiceContext } from './service-context';
 import { ServiceRegistry } from './service-registry';
 
@@ -54,7 +54,7 @@ export type InitializeOptions = {
  * Remote service implementation.
  */
 export class ClientServicesHost {
-  private readonly _resourceLock?: VaultResourceLock;
+  private readonly _resourceLock?: ResourceLock;
   private readonly _serviceRegistry: ServiceRegistry<ClientServices>;
   private readonly _systemService: SystemServiceImpl;
   private readonly _loggingService: LoggingServiceImpl;
@@ -88,17 +88,17 @@ export class ClientServicesHost {
       this.initialize({ config, transportFactory, signalManager });
     }
 
-    this._resourceLock = lockKey
-      ? new VaultResourceLock({
-          lockKey,
-          onAcquire: () => {
-            if (!this._opening) {
-              void this.open();
-            }
-          },
-          onRelease: () => this.close(),
-        })
-      : undefined;
+    if (lockKey) {
+      this._resourceLock = new Lock({
+        lockKey,
+        onAcquire: () => {
+          if (!this._opening) {
+            void this.open();
+          }
+        },
+        onRelease: () => this.close(),
+      });
+    }
 
     this._systemService = new SystemServiceImpl({
       config: this._config,

package/src/packlets/vault/index.ts

@@ -5,6 +5,5 @@
 export * from './iframe-host-runtime';
 export * from './iframe-proxy-runtime';
 export * from './shell-runtime';
-export * from './vault-resource-lock';
 export * from './worker-runtime';
 export * from './worker-session';