@moyodb/sdk 1.1.0 → 1.3.0

package/dist/node-storage.d.mts

@@ -1,6 +1,9 @@
+export const MISSING_DATABASE_MESSAGE: string;
+
 export interface NodeStorageOptions {
     lockToken?: string;
     encodedDbName?: string;
+    createIfMissing?: boolean;
 }
 
 export interface NodeStorageHandle {
@@ -8,5 +11,6 @@ export interface NodeStorageHandle {
     close(): void;
 }
 
+export function ensureStorageRoot(directory: string, createIfMissing?: boolean): string;
 export function installNodeStorage(directory: string, options?: NodeStorageOptions): Promise<NodeStorageHandle>;
 export function releaseNodeStorageLease(directory: string, lockToken: string): boolean;

package/dist/node-storage.mjs

@@ -6,6 +6,10 @@ import { isMainThread } from 'node:worker_threads';
 const LOCK_DIRECTORY = '.moyodb.lock';
 const PENDING_PREFIX = '.moyodb.pending-';
 const TOKEN_PATTERN = /^[a-f\d]{8}-[a-f\d]{4}-[a-f\d]{4}-[a-f\d]{4}-[a-f\d]{12}$/i;
+// NativeFileBackend rejects a larger record without deleting it.
+const MAX_LEASE_RECORD_BYTES = 1024;
+const MAX_LEASE_PID = 0xffffffff;
+export const MISSING_DATABASE_MESSAGE = 'database missing and create_if_missing=false';
 let installedStorage = null;
 
 function namedError(name, message, cause) {
@@ -84,9 +88,12 @@ function readLease(directory, token) {
     const lockDirectory = join(directory, LOCK_DIRECTORY);
     entryStat(lockDirectory, 'directory');
     const recordPath = join(lockDirectory, `${validateToken(token)}.json`);
-    entryStat(recordPath, 'file');
+    const stat = entryStat(recordPath, 'file');
+    if (stat.size > MAX_LEASE_RECORD_BYTES) {
+        throw namedError('DatabaseBusyError', 'storage lock owner cannot be verified');
+    }
     const owner = JSON.parse(fs.readFileSync(recordPath, 'utf8'));
-    if (owner.token !== token || !Number.isSafeInteger(owner.pid) || owner.pid <= 0) {
+    if (owner.token !== token || !Number.isSafeInteger(owner.pid) || owner.pid <= 0 || owner.pid > MAX_LEASE_PID) {
         throw namedError('DatabaseBusyError', 'storage lock owner cannot be verified');
     }
     return { lockDirectory, recordPath, owner };
@@ -556,7 +563,26 @@ function mountedRoot(storage, encodedDbName) {
     return new MountedDirectoryHandle(storage, '', 'stackdb', () => stackdb);
 }
 
-export async function installNodeStorage(directory, { lockToken = randomUUID(), encodedDbName } = {}) {
+export function ensureStorageRoot(directory, createIfMissing = true) {
+    const path = validateDirectory(directory);
+    if (!createIfMissing) {
+        try {
+            entryStat(path, 'directory');
+        } catch (error) {
+            if (error?.code === 'ENOENT') throw namedError('StorageError', MISSING_DATABASE_MESSAGE);
+            if (error?.name === 'TypeMismatchError' || error?.name === 'SecurityError') throw error;
+            throw storageError(error);
+        }
+        return path;
+    }
+    fs.mkdirSync(path, { recursive: true });
+    return path;
+}
+
+export async function installNodeStorage(
+    directory,
+    { lockToken = randomUUID(), encodedDbName, createIfMissing = true } = {}
+) {
     if (isMainThread) throw new Error('Node storage must be installed in a dedicated worker');
     if (installedStorage) throw new Error('Node storage is already installed in this worker');
     const path = validateDirectory(directory);
@@ -567,6 +593,15 @@ export async function installNodeStorage(directory, { lockToken = randomUUID(),
     ) {
         throw new TypeError('encodedDbName must be the lowercase hexadecimal UTF-8 database name');
     }
+    if (createIfMissing === false) {
+        try {
+            entryStat(path, 'directory');
+        } catch (error) {
+            if (error?.code === 'ENOENT') throw namedError('StorageError', MISSING_DATABASE_MESSAGE);
+            if (error?.name === 'TypeMismatchError' || error?.name === 'SecurityError') throw error;
+            throw storageError(error);
+        }
+    }
     let canonical;
     try {
         fs.mkdirSync(path, { recursive: true, mode: 0o700 });

package/dist/node-worker-client.d.ts

@@ -6,6 +6,7 @@ export interface NodeWorkerData {
     lockToken: string;
     ownerWaitMs: number;
     encodedDbName: string;
+    createIfMissing: boolean;
 }
 export declare class NodeWorkerTransport {
     #private;

package/dist/node-worker-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-worker-client.d.ts","sourceRoot":"","sources":["../src/node-worker-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,mBAAmB;;IAC5B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IASrC,YAAY,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,IAAI,EAgCzD;IAED,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAE,YAAY,EAAO,GAAG,IAAI,CAEjE;IAED,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,GAAG,IAAI,CAOjF;IAED,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,GAAG,IAAI,CAEpF;IAED,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAM3B;CAQJ"}
+{"version":3,"file":"node-worker-client.d.ts","sourceRoot":"","sources":["../src/node-worker-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,mBAAmB;;IAC5B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IASrC,YAAY,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,IAAI,EAgCzD;IAED,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAE,YAAY,EAAO,GAAG,IAAI,CAEjE;IAED,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,GAAG,IAAI,CAOjF;IAED,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,GAAG,IAAI,CAEpF;IAED,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAM3B;CAQJ"}

package/dist/node-worker.mjs

@@ -54,7 +54,8 @@ async function acquireStorage() {
         try {
             return await installNodeStorage(workerData.directory, {
                 lockToken: workerData.lockToken,
-                encodedDbName: workerData.encodedDbName
+                encodedDbName: workerData.encodedDbName,
+                createIfMissing: workerData.createIfMissing !== false
             });
         } catch (error) {
             const remaining = deadline - performance.now();

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACtF,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;CACrB;AAmLD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,EAAE,CAAC,CAOpF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1F;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAY3G;AAED,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,SAAS,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACtF,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;CACrB;AA2LD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,EAAE,CAAC,CAOpF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1F;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAY3G;AAED,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,SAAS,CAAC"}