@orkestrel/scaffold 0.0.74 → 0.0.75

package/dist/src/server/index.d.cts

@@ -837,7 +837,7 @@ export declare interface ManifestEntry {
 }
 
 /**
- * Tests whether a captured directory is still the same directory.
+ * Tests whether a path still holds the captured directory identity.
  *
  * @param anchor - The identity captured earlier.
  * @returns True if the path still holds a physical directory of that exact device and
@@ -1606,7 +1606,8 @@ export declare class Materializer implements MaterializerInterface {
             * @returns The anchor, or `undefined` when the path is not a physical directory.
             *
             * @remarks
-            * Device and inode rather than the path, because the path is the thing that can
+            * Native bigint device and inode values preserve the filesystem identity without
+            * numeric rounding. Device and inode rather than the path, because the path can
             * be swapped underneath a write. An anchor captured before a mutation and
             * checked again after it proves the directory written into sits where the
             * inspected one sat, not that it is the one that was inspected.
@@ -1615,7 +1616,8 @@ export declare class Materializer implements MaterializerInterface {
             * ```ts
             * import { readAnchor } from '@orkestrel/scaffold/server'
             *
-            * readAnchor('/tmp/project') // { path: '/tmp/project', device: 1, inode: 2 }
+            * const anchor = readAnchor(process.cwd())
+            * anchor !== undefined && typeof anchor.device === 'bigint' && typeof anchor.inode === 'bigint' // true for a physical directory
             * ```
             */
            export declare function readAnchor(path: string): WriteAnchor | undefined;
@@ -2463,14 +2465,14 @@ export declare class Materializer implements MaterializerInterface {
                     * Represents one physical directory identity captured across a write transaction.
                     *
                     * @remarks
-                    * Device and inode locate the directory and do not date it. Two directories
-                    * occupying one slot at different times share an anchor, so an anchor proves
+                    * Native bigint device and inode values locate the directory and do not date it.
+                    * Two directories occupying one slot at different times share an anchor, so an anchor proves
                     * where a write lands and never that the directory was left alone.
                     */
                    export declare interface WriteAnchor {
                        readonly path: string;
-                       readonly device: number;
-                       readonly inode: number;
+                       readonly device: bigint;
+                       readonly inode: bigint;
                    }
 
                    /** Reports the final directory anchor of a write transaction and the subset one call created. */

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

@@ -837,7 +837,7 @@ export declare interface ManifestEntry {
 }
 
 /**
- * Tests whether a captured directory is still the same directory.
+ * Tests whether a path still holds the captured directory identity.
  *
  * @param anchor - The identity captured earlier.
  * @returns True if the path still holds a physical directory of that exact device and
@@ -1606,7 +1606,8 @@ export declare class Materializer implements MaterializerInterface {
             * @returns The anchor, or `undefined` when the path is not a physical directory.
             *
             * @remarks
-            * Device and inode rather than the path, because the path is the thing that can
+            * Native bigint device and inode values preserve the filesystem identity without
+            * numeric rounding. Device and inode rather than the path, because the path can
             * be swapped underneath a write. An anchor captured before a mutation and
             * checked again after it proves the directory written into sits where the
             * inspected one sat, not that it is the one that was inspected.
@@ -1615,7 +1616,8 @@ export declare class Materializer implements MaterializerInterface {
             * ```ts
             * import { readAnchor } from '@orkestrel/scaffold/server'
             *
-            * readAnchor('/tmp/project') // { path: '/tmp/project', device: 1, inode: 2 }
+            * const anchor = readAnchor(process.cwd())
+            * anchor !== undefined && typeof anchor.device === 'bigint' && typeof anchor.inode === 'bigint' // true for a physical directory
             * ```
             */
            export declare function readAnchor(path: string): WriteAnchor | undefined;
@@ -2463,14 +2465,14 @@ export declare class Materializer implements MaterializerInterface {
                     * Represents one physical directory identity captured across a write transaction.
                     *
                     * @remarks
-                    * Device and inode locate the directory and do not date it. Two directories
-                    * occupying one slot at different times share an anchor, so an anchor proves
+                    * Native bigint device and inode values locate the directory and do not date it.
+                    * Two directories occupying one slot at different times share an anchor, so an anchor proves
                     * where a write lands and never that the directory was left alone.
                     */
                    export declare interface WriteAnchor {
                        readonly path: string;
-                       readonly device: number;
-                       readonly inode: number;
+                       readonly device: bigint;
+                       readonly inode: bigint;
                    }
 
                    /** Reports the final directory anchor of a write transaction and the subset one call created. */

package/dist/src/server/index.js

@@ -1775,7 +1775,8 @@ function stageInventory(checkout, path = HOST_INVENTORY_PATH) {
 * @returns The anchor, or `undefined` when the path is not a physical directory.
 *
 * @remarks
-* Device and inode rather than the path, because the path is the thing that can
+* Native bigint device and inode values preserve the filesystem identity without
+* numeric rounding. Device and inode rather than the path, because the path can
 * be swapped underneath a write. An anchor captured before a mutation and
 * checked again after it proves the directory written into sits where the
 * inspected one sat, not that it is the one that was inspected.
@@ -1784,11 +1785,12 @@ function stageInventory(checkout, path = HOST_INVENTORY_PATH) {
 * ```ts
 * import { readAnchor } from '@orkestrel/scaffold/server'
 *
-* readAnchor('/tmp/project') // { path: '/tmp/project', device: 1, inode: 2 }
+* const anchor = readAnchor(process.cwd())
+* anchor !== undefined && typeof anchor.device === 'bigint' && typeof anchor.inode === 'bigint' // true for a physical directory
 * ```
 */
 function readAnchor(path) {
-	const status = attempt(() => lstatSync(path));
+	const status = attempt(() => lstatSync(path, { bigint: true }));
 	if (!status.success || !status.value.isDirectory() || status.value.isSymbolicLink()) return;
 	return {
 		path,
@@ -1797,7 +1799,7 @@ function readAnchor(path) {
 	};
 }
 /**
-* Tests whether a captured directory is still the same directory.
+* Tests whether a path still holds the captured directory identity.
 *
 * @param anchor - The identity captured earlier.
 * @returns True if the path still holds a physical directory of that exact device and