@ibgib/node-gib 0.0.22 → 0.0.24

package/dist/vcs/workspace-space-helper.mjs

@@ -0,0 +1,71 @@
+/**
+ * @module workspace-space-helper
+ *
+ * Helper for managing NodeWorkspaceProjectionSpace_V1 in metaspace.
+ */
+import { extractErrorMsg, getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { NodeWorkspaceProjectionSpace_V1 } from '../witness/space/node-workspace-projection-space/node-workspace-projection-space-v1.mjs';
+import { GLOBAL_LOG_A_LOT } from '@ibgib/core-gib/dist/core-constants.mjs';
+const lcFile = `[workspace-space-helper]`;
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * Gets an existing projection space for a workspace root or instantiates and returns a NodeWorkspaceProjectionSpace_V1.
+ */
+export async function getOrCreateWorkspaceProjectionSpace({ metaspace, workspaceRoot, vcsFolderName = '.vcsgib', backingSpace, branchAddr, name, }) {
+    const lc = `${lcFile}[${getOrCreateWorkspaceProjectionSpace.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: genuuid)`);
+        }
+        if (!metaspace || !workspaceRoot || !backingSpace) {
+            throw new Error(`metaspace, workspaceRoot, and backingSpace are required (E: genuuid)`);
+        }
+        const spaceName = name || `ws_${workspaceRoot.replace(/[^a-zA-Z0-9_]/g, '_')}`;
+        const localSpaces = (await metaspace.getLocalUserSpaces({ lock: false })) || [];
+        const existingSpace = localSpaces.find(s => (s.data?.name === spaceName || s.ib === spaceName) ||
+            (s.data?.classname?.includes('WorkspaceProjectionSpace') && s.data?.workspaceRoot === workspaceRoot));
+        if (existingSpace) {
+            const spaceId = existingSpace.data?.uuid || existingSpace.data?.spaceId || spaceName;
+            if (logalot) {
+                console.log(`${lc} Found existing workspace projection space ${spaceName} (spaceId: ${spaceId})`);
+            }
+            return {
+                space: existingSpace,
+                spaceId,
+                spaceName,
+            };
+        }
+        const spaceUuid = await getUUID();
+        const space = new NodeWorkspaceProjectionSpace_V1({
+            initialData: {
+                workspaceRoot,
+                vcsFolderName,
+                classname: 'NodeWorkspaceProjectionSpace_V1',
+                name: spaceName,
+                uuid: spaceUuid,
+                version: '1',
+                branchAddr,
+            },
+            backingSpace,
+        });
+        await space.initialized;
+        if (logalot) {
+            console.log(`${lc} Created new workspace projection space ${spaceName} (spaceId: ${spaceUuid})`);
+        }
+        return {
+            space,
+            spaceId: spaceUuid,
+            spaceName,
+        };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: genuuid)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=workspace-space-helper.mjs.map

package/dist/vcs/workspace-space-helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-space-helper.mjs","sourceRoot":"","sources":["../../src/vcs/workspace-space-helper.mts"],"names":[],"mappings":"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"}

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-constants.d.mts

@@ -0,0 +1,7 @@
+/**
+ * @module node-workspace-projection-space-constants
+ *
+ * Constants for Node.js workspace projection spaces.
+ */
+export declare const DEFAULT_NODE_WORKSPACE_PROJECTION_SPACE_DESCRIPTION = "Node.js space witness for projecting and observing workspace hierarchies on physical disk.";
+//# sourceMappingURL=node-workspace-projection-space-constants.d.mts.map

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-workspace-projection-space-constants.d.mts","sourceRoot":"","sources":["../../../../src/witness/space/node-workspace-projection-space/node-workspace-projection-space-constants.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,mDAAmD,+FACgC,CAAC"}

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-constants.mjs

@@ -0,0 +1,7 @@
+/**
+ * @module node-workspace-projection-space-constants
+ *
+ * Constants for Node.js workspace projection spaces.
+ */
+export const DEFAULT_NODE_WORKSPACE_PROJECTION_SPACE_DESCRIPTION = 'Node.js space witness for projecting and observing workspace hierarchies on physical disk.';
+//# sourceMappingURL=node-workspace-projection-space-constants.mjs.map

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-workspace-projection-space-constants.mjs","sourceRoot":"","sources":["../../../../src/witness/space/node-workspace-projection-space/node-workspace-projection-space-constants.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,mDAAmD,GAC5D,4FAA4F,CAAC"}

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-types.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @module node-workspace-projection-space-types
+ *
+ * Types for Node.js workspace projection spaces.
+ */
+import { WorkspaceProjectionSpaceData_V1, WorkspaceProjectionSpaceRel8ns_V1 } from '@ibgib/core-gib/dist/witness/space/workspace-projection-space/workspace-projection-space-types.mjs';
+/**
+ * Data payload for NodeWorkspaceProjectionSpace_V1.
+ */
+export interface NodeWorkspaceProjectionSpaceData_V1 extends WorkspaceProjectionSpaceData_V1 {
+}
+export declare const DEFAULT_NODE_WORKSPACE_PROJECTION_SPACE_DATA_V1: NodeWorkspaceProjectionSpaceData_V1;
+export interface NodeWorkspaceProjectionSpaceRel8ns_V1 extends WorkspaceProjectionSpaceRel8ns_V1 {
+}
+//# sourceMappingURL=node-workspace-projection-space-types.d.mts.map

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-workspace-projection-space-types.d.mts","sourceRoot":"","sources":["../../../../src/witness/space/node-workspace-projection-space/node-workspace-projection-space-types.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,+BAA+B,EAC/B,iCAAiC,EACpC,MAAM,oGAAoG,CAAC;AAU5G;;GAEG;AACH,MAAM,WAAW,mCAAoC,SAAQ,+BAA+B;CAC3F;AAED,eAAO,MAAM,+CAA+C,EAAE,mCAc7D,CAAC;AAEF,MAAM,WAAW,qCAAsC,SAAQ,iCAAiC;CAC/F"}

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-types.mjs

@@ -0,0 +1,23 @@
+/**
+ * @module node-workspace-projection-space-types
+ *
+ * Types for Node.js workspace projection spaces.
+ */
+import { DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS, IBGIB_SPACE_NAME_DEFAULT, ZERO_SPACE_ID } from '@ibgib/core-gib/dist/witness/space/space-constants.mjs';
+import { DEFAULT_NODE_WORKSPACE_PROJECTION_SPACE_DESCRIPTION } from './node-workspace-projection-space-constants.mjs';
+export const DEFAULT_NODE_WORKSPACE_PROJECTION_SPACE_DATA_V1 = {
+    version: '1',
+    uuid: ZERO_SPACE_ID,
+    name: IBGIB_SPACE_NAME_DEFAULT,
+    classname: 'NodeWorkspaceProjectionSpace_V1',
+    workspaceRoot: '',
+    vcsFolderName: '.vcsgib',
+    persistOptsAndResultIbGibs: false,
+    validateIbGibAddrsMatchIbGibs: false,
+    longPollingIntervalMs: DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS,
+    allowPrimitiveArgs: false,
+    catchAllErrors: true,
+    description: DEFAULT_NODE_WORKSPACE_PROJECTION_SPACE_DESCRIPTION,
+    trace: false,
+};
+//# sourceMappingURL=node-workspace-projection-space-types.mjs.map

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-workspace-projection-space-types.mjs","sourceRoot":"","sources":["../../../../src/witness/space/node-workspace-projection-space/node-workspace-projection-space-types.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACH,uCAAuC,EACvC,wBAAwB,EACxB,aAAa,EAChB,MAAM,wDAAwD,CAAC;AAChE,OAAO,EACH,mDAAmD,EACtD,MAAM,iDAAiD,CAAC;AAQzD,MAAM,CAAC,MAAM,+CAA+C,GAAwC;IAChG,OAAO,EAAE,GAAG;IACZ,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,wBAAwB;IAC9B,SAAS,EAAE,iCAAiC;IAC5C,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,SAAS;IACxB,0BAA0B,EAAE,KAAK;IACjC,6BAA6B,EAAE,KAAK;IACpC,qBAAqB,EAAE,uCAAuC;IAC9D,kBAAkB,EAAE,KAAK;IACzB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,mDAAmD;IAChE,KAAK,EAAE,KAAK;CACf,CAAC"}

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-v1.d.mts

@@ -0,0 +1,66 @@
+/**
+ * @module node-workspace-projection-space-v1
+ *
+ * Concrete Node.js workspace projection space implementation.
+ * Projects B2tFS items to physical OS disk and scans physical directories.
+ */
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { IbGibSpaceAny } from '@ibgib/core-gib/dist/witness/space/space-base-v1.mjs';
+import { WorkspaceProjectionSpaceBase_V1 } from '@ibgib/core-gib/dist/witness/space/workspace-projection-space/workspace-projection-space-base-v1.mjs';
+import { WorkspaceScanResultData } from '@ibgib/core-gib/dist/witness/space/workspace-projection-space/workspace-projection-space-types.mjs';
+import { B2tFSItemIbGib_V1 } from '@ibgib/core-gib/dist/vcs/item/item-types.mjs';
+import { NodeWorkspaceProjectionSpaceData_V1, NodeWorkspaceProjectionSpaceRel8ns_V1 } from './node-workspace-projection-space-types.mjs';
+export interface NodeWorkspaceProjectionSpaceOpts {
+    initialData?: NodeWorkspaceProjectionSpaceData_V1;
+    initialRel8ns?: NodeWorkspaceProjectionSpaceRel8ns_V1;
+    backingSpace?: IbGibSpaceAny;
+}
+/**
+ * Node.js Workspace Projection Space that projects B2tFS item DAGs directly onto
+ * the local filesystem and scans physical directories to report workspace state.
+ */
+export declare class NodeWorkspaceProjectionSpace_V1 extends WorkspaceProjectionSpaceBase_V1<NodeWorkspaceProjectionSpaceData_V1, NodeWorkspaceProjectionSpaceRel8ns_V1> {
+    protected lc: string;
+    /** Backing CAS space where source BinIbGibs and child items reside */
+    backingSpace?: IbGibSpaceAny;
+    constructor(initialDataOrOpts?: NodeWorkspaceProjectionSpaceData_V1 | NodeWorkspaceProjectionSpaceOpts, initialRel8ns?: NodeWorkspaceProjectionSpaceRel8ns_V1);
+    /**
+     * Projects an item (and its recursive child hierarchy or binary payload) onto the physical workspace.
+     */
+    protected putItemToWorkspaceImpl({ item, subPath, }: {
+        item: B2tFSItemIbGib_V1;
+        subPath?: string;
+    }): Promise<void>;
+    /**
+     * Scans the physical workspace directory and returns file observations and pending companion notes.
+     */
+    protected scanWorkspaceImpl({ subPath, filterPatterns, }: {
+        subPath?: string;
+        filterPatterns?: string[];
+    }): Promise<WorkspaceScanResultData>;
+    /**
+     * Unlinks a file, folder, or comment file from disk.
+     */
+    protected deleteFromWorkspaceImpl({ relPath, ibGib, }: {
+        relPath?: string;
+        ibGib?: IbGib_V1;
+    }): Promise<void>;
+    /**
+     * Reads raw bytes of a physical workspace file from disk.
+     */
+    protected getFileBytesImpl({ relPath, }: {
+        relPath: string;
+    }): Promise<Uint8Array | undefined>;
+    /**
+     * Recursively scans physical directories on disk.
+     */
+    private scanDirRecursive;
+    private isCommentMetadataFilename;
+    private extractCommentTopicName;
+    private isFiltered;
+    /**
+     * Helper to fetch an IbGib strictly from backingSpace with fail-fast validation.
+     */
+    private fetchIbGib;
+}
+//# sourceMappingURL=node-workspace-projection-space-v1.d.mts.map

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-v1.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-workspace-projection-space-v1.d.mts","sourceRoot":"","sources":["../../../../src/witness/space/node-workspace-projection-space/node-workspace-projection-space-v1.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAErF,OAAO,EAAE,+BAA+B,EAAE,MAAM,sGAAsG,CAAC;AACvJ,OAAO,EACH,uBAAuB,EAG1B,MAAM,oGAAoG,CAAC;AAC5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAGjF,OAAO,EACH,mCAAmC,EACnC,qCAAqC,EAExC,MAAM,6CAA6C,CAAC;AAIrD,MAAM,WAAW,gCAAgC;IAC7C,WAAW,CAAC,EAAE,mCAAmC,CAAC;IAClD,aAAa,CAAC,EAAE,qCAAqC,CAAC;IACtD,YAAY,CAAC,EAAE,aAAa,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,+BAAgC,SAAQ,+BAA+B,CAChF,mCAAmC,EACnC,qCAAqC,CACxC;IACG,UAAmB,EAAE,EAAE,MAAM,CAA+C;IAE5E,sEAAsE;IACtE,YAAY,CAAC,EAAE,aAAa,CAAC;IAE7B,YACI,iBAAiB,CAAC,EAAE,mCAAmC,GAAG,gCAAgC,EAC1F,aAAa,CAAC,EAAE,qCAAqC,EAiBxD;IAID;;OAEG;IACH,UAAyB,sBAAsB,CAAC,EAC5C,IAAI,EACJ,OAAO,GACV,EAAE;QACC,IAAI,EAAE,iBAAiB,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyEhB;IAED;;OAEG;IACH,UAAyB,iBAAiB,CAAC,EACvC,OAAO,EACP,cAAc,GACjB,EAAE;QACC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC7B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA4CnC;IAED;;OAEG;IACH,UAAyB,uBAAuB,CAAC,EAC7C,OAAO,EACP,KAAK,GACR,EAAE;QACC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBhB;IAED;;OAEG;IACH,UAAyB,gBAAgB,CAAC,EACtC,OAAO,GACV,EAAE;QACC,OAAO,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAWlC;IAMD;;OAEG;YACW,gBAAgB;IAsG9B,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,UAAU;IAIlB;;OAEG;YACW,UAAU;CAsB3B"}

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-v1.mjs

@@ -0,0 +1,326 @@
+/**
+ * @module node-workspace-projection-space-v1
+ *
+ * Concrete Node.js workspace projection space implementation.
+ * Projects B2tFS items to physical OS disk and scans physical directories.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { clone, extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '@ibgib/core-gib/dist/core-constants.mjs';
+import { getFromSpace } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { WorkspaceProjectionSpaceBase_V1 } from '@ibgib/core-gib/dist/witness/space/workspace-projection-space/workspace-projection-space-base-v1.mjs';
+import { isPathFiltered, parseFilterFileContent } from '@ibgib/core-gib/dist/vcs/filter/glob-helper.mjs';
+import { DEFAULT_NODE_WORKSPACE_PROJECTION_SPACE_DATA_V1, } from './node-workspace-projection-space-types.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * Node.js Workspace Projection Space that projects B2tFS item DAGs directly onto
+ * the local filesystem and scans physical directories to report workspace state.
+ */
+export class NodeWorkspaceProjectionSpace_V1 extends WorkspaceProjectionSpaceBase_V1 {
+    lc = `[${NodeWorkspaceProjectionSpace_V1.name}]`;
+    /** Backing CAS space where source BinIbGibs and child items reside */
+    backingSpace;
+    constructor(initialDataOrOpts, initialRel8ns) {
+        let data;
+        let rel8ns = initialRel8ns;
+        let backingSpace;
+        if (initialDataOrOpts && ('workspaceRoot' in initialDataOrOpts || 'name' in initialDataOrOpts)) {
+            data = initialDataOrOpts;
+        }
+        else if (initialDataOrOpts && typeof initialDataOrOpts === 'object') {
+            const opts = initialDataOrOpts;
+            data = opts.initialData;
+            rel8ns = opts.initialRel8ns ?? initialRel8ns;
+            backingSpace = opts.backingSpace;
+        }
+        super(data ?? clone(DEFAULT_NODE_WORKSPACE_PROJECTION_SPACE_DATA_V1), rel8ns);
+        this.backingSpace = backingSpace;
+    }
+    // #region Implementation of Abstract Extension Hooks
+    /**
+     * Projects an item (and its recursive child hierarchy or binary payload) onto the physical workspace.
+     */
+    async putItemToWorkspaceImpl({ item, subPath, }) {
+        const lc = `${this.lc}[${this.putItemToWorkspaceImpl.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} projecting item to workspace...`);
+            }
+            const workspaceRoot = this.data?.workspaceRoot;
+            if (!workspaceRoot) {
+                throw new Error(`${lc} workspaceRoot is required in space data (E: genuuid)`);
+            }
+            if (!item || !item.data) {
+                throw new Error(`${lc} item and item.data are required (E: genuuid)`);
+            }
+            const { fsType, name } = item.data;
+            let itemRelPath;
+            if (subPath === undefined) {
+                itemRelPath = fsType === 'folder' ? '' : (name || '');
+            }
+            else {
+                itemRelPath = name ? (subPath ? path.join(subPath, name) : name) : subPath;
+            }
+            const targetPath = itemRelPath ? path.join(workspaceRoot, itemRelPath) : workspaceRoot;
+            if (fsType === 'folder') {
+                await fs.mkdir(targetPath, { recursive: true });
+                const childAddrs = item.rel8ns?.b2tFS_child || item.rel8ns?.b2tfs_child || [];
+                for (const childAddr of childAddrs) {
+                    const childItem = (await this.fetchIbGib(childAddr));
+                    await this.putItemToWorkspaceImpl({
+                        item: childItem,
+                        subPath: itemRelPath,
+                    });
+                }
+            }
+            else if (fsType === 'file') {
+                await fs.mkdir(path.dirname(targetPath), { recursive: true });
+                if (!item.rel8ns) {
+                    throw new Error(`${lc} item.rel8ns required for file item (E: genuuid)`);
+                }
+                const binAddrs = item.rel8ns.bin;
+                if (!binAddrs || binAddrs.length === 0) {
+                    throw new Error(`${lc} item.rel8ns.bin required for file item ${name} (E: genuuid)`);
+                }
+                const latestBinAddr = binAddrs.at(-1);
+                const binIbGib = await this.fetchIbGib(latestBinAddr);
+                if (binIbGib.data === undefined) {
+                    throw new Error(`${lc} BinIbGib at addr ${latestBinAddr} has undefined data (E: genuuid)`);
+                }
+                let fileData;
+                if (binIbGib.data instanceof Uint8Array || Buffer.isBuffer(binIbGib.data)) {
+                    fileData = binIbGib.data;
+                }
+                else if (typeof binIbGib.data === 'string') {
+                    fileData = binIbGib.data;
+                }
+                else if (typeof binIbGib.data === 'object') {
+                    const vals = Object.values(binIbGib.data);
+                    fileData = new Uint8Array(vals);
+                }
+                else {
+                    fileData = new Uint8Array(0);
+                }
+                await fs.writeFile(targetPath, fileData);
+            }
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)} (E: genuuid)`);
+            throw error;
+        }
+    }
+    /**
+     * Scans the physical workspace directory and returns file observations and pending companion notes.
+     */
+    async scanWorkspaceImpl({ subPath, filterPatterns, }) {
+        const lc = `${this.lc}[${this.scanWorkspaceImpl.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting physical scan...`);
+            }
+            const workspaceRoot = this.data?.workspaceRoot;
+            if (!workspaceRoot) {
+                throw new Error(`${lc} workspaceRoot is required in space data (E: genuuid)`);
+            }
+            const scanDir = subPath ? path.join(workspaceRoot, subPath) : workspaceRoot;
+            const vcsFolderName = this.data?.vcsFolderName || '.vcsgib';
+            let patterns = filterPatterns ?? this.data?.filterPatterns;
+            if (!patterns || patterns.length === 0) {
+                try {
+                    const ignorePath = path.join(workspaceRoot, '.ibgibignore');
+                    const ignoreContent = await fs.readFile(ignorePath, 'utf8');
+                    patterns = parseFilterFileContent(ignoreContent);
+                }
+                catch {
+                    patterns = [];
+                }
+            }
+            const files = new Map();
+            const pendingComments = [];
+            await this.scanDirRecursive({
+                dirPath: scanDir,
+                baseDir: workspaceRoot,
+                vcsFolderName,
+                filterPatterns: patterns,
+                outFiles: files,
+                outComments: pendingComments,
+            });
+            return {
+                files,
+                pendingComments,
+            };
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)} (E: genuuid)`);
+            throw error;
+        }
+    }
+    /**
+     * Unlinks a file, folder, or comment file from disk.
+     */
+    async deleteFromWorkspaceImpl({ relPath, ibGib, }) {
+        const lc = `${this.lc}[${this.deleteFromWorkspaceImpl.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} deleting from workspace...`);
+            }
+            const workspaceRoot = this.data?.workspaceRoot;
+            if (!workspaceRoot) {
+                throw new Error(`${lc} workspaceRoot is required (E: genuuid)`);
+            }
+            const targetRelPath = relPath || ibGib?.data?.name;
+            if (!targetRelPath) {
+                throw new Error(`${lc} relPath or item name required for deletion (E: genuuid)`);
+            }
+            const fullPath = path.join(workspaceRoot, targetRelPath);
+            await fs.rm(fullPath, { recursive: true, force: true });
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)} (E: genuuid)`);
+            throw error;
+        }
+    }
+    /**
+     * Reads raw bytes of a physical workspace file from disk.
+     */
+    async getFileBytesImpl({ relPath, }) {
+        const lc = `${this.lc}[${this.getFileBytesImpl.name}]`;
+        try {
+            const workspaceRoot = this.data?.workspaceRoot;
+            if (!workspaceRoot) {
+                return undefined;
+            }
+            const fullPath = path.isAbsolute(relPath) ? relPath : path.join(workspaceRoot, relPath);
+            const buf = await fs.readFile(fullPath);
+            return new Uint8Array(buf);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // #endregion
+    // #region Internal Helpers
+    /**
+     * Recursively scans physical directories on disk.
+     */
+    async scanDirRecursive({ dirPath, baseDir, vcsFolderName, filterPatterns, outFiles, outComments, }) {
+        const lc = `${this.lc}[${this.scanDirRecursive.name}]`;
+        let entries = [];
+        try {
+            entries = await fs.readdir(dirPath, { withFileTypes: true });
+        }
+        catch (error) {
+            console.error(`${lc} Failed to read directory ${dirPath}: ${extractErrorMsg(error)} (E: genuuid)`);
+            throw error;
+        }
+        for (const entry of entries) {
+            const fullEntryPath = path.join(dirPath, entry.name);
+            const relPath = path.relative(baseDir, fullEntryPath).replace(/\\/g, '/');
+            // Exclude VCS metadata folders, .git, and worktrees folder 'b'
+            if (relPath === vcsFolderName || relPath.startsWith(vcsFolderName + '/') ||
+                relPath === '.git' || relPath.startsWith('.git/') ||
+                relPath === 'b' || relPath.startsWith('b/')) {
+                continue;
+            }
+            if (this.isFiltered(relPath, entry.isDirectory(), filterPatterns)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                outFiles.set(relPath, {
+                    relPath,
+                    fullPath: fullEntryPath,
+                    isDirectory: true,
+                });
+                await this.scanDirRecursive({
+                    dirPath: fullEntryPath,
+                    baseDir,
+                    vcsFolderName,
+                    filterPatterns,
+                    outFiles,
+                    outComments,
+                });
+            }
+            else if (entry.isFile()) {
+                if (this.isCommentMetadataFilename(entry.name)) {
+                    const parentRelPath = path.relative(baseDir, dirPath).replace(/\\/g, '/');
+                    const normalizedParent = parentRelPath === '.' ? '' : parentRelPath;
+                    let content = '';
+                    try {
+                        content = await fs.readFile(fullEntryPath, 'utf8');
+                    }
+                    catch (error) {
+                        console.error(`${lc} Failed to read comment file ${fullEntryPath}: ${extractErrorMsg(error)} (E: genuuid)`);
+                        throw error;
+                    }
+                    const topicName = this.extractCommentTopicName(entry.name);
+                    const targetRelPath = normalizedParent ? `${normalizedParent}/${topicName}` : topicName;
+                    outComments.push({
+                        commentRelPath: relPath,
+                        commentFullPath: fullEntryPath,
+                        targetRelPath,
+                        targetType: entry.name.startsWith('.ib.') ? 'file' : 'folder',
+                        topicName,
+                        content,
+                    });
+                }
+                else {
+                    let fileHash;
+                    let size;
+                    try {
+                        const fileData = await fs.readFile(fullEntryPath);
+                        fileHash = crypto.createHash('sha256').update(fileData).digest('hex');
+                        size = fileData.length;
+                    }
+                    catch (error) {
+                        console.error(`${lc} Failed to read file ${fullEntryPath}: ${extractErrorMsg(error)} (E: genuuid)`);
+                        throw error;
+                    }
+                    outFiles.set(relPath, {
+                        relPath,
+                        fullPath: fullEntryPath,
+                        isDirectory: false,
+                        fileHash,
+                        size,
+                    });
+                }
+            }
+        }
+    }
+    isCommentMetadataFilename(filename) {
+        return filename.startsWith('.ib.') && filename.endsWith('.md') && filename.length > '.ib..md'.length;
+    }
+    extractCommentTopicName(filename) {
+        if (!this.isCommentMetadataFilename(filename)) {
+            return '';
+        }
+        return filename.slice(4, -3);
+    }
+    isFiltered(relPath, isDirectory, filterPatterns) {
+        return isPathFiltered({ relativePath: relPath, isDirectory, filterPatterns });
+    }
+    /**
+     * Helper to fetch an IbGib strictly from backingSpace with fail-fast validation.
+     */
+    async fetchIbGib(addr) {
+        const lc = `${this.lc}[${this.fetchIbGib.name}]`;
+        try {
+            if (!this.backingSpace) {
+                throw new Error(`${lc} backingSpace required to fetch IbGib at ${addr} (E: genuuid)`);
+            }
+            const resGet = await getFromSpace({ space: this.backingSpace, addrs: [addr] });
+            if (!resGet.success || !resGet.ibGibs || resGet.ibGibs.length === 0) {
+                const resIbGib = resGet.rawResultIbGib;
+                const addrsNotFound = resIbGib?.data?.addrsNotFound ?? 'unknown';
+                throw new Error(`${lc} couldn't find addr ${addr} in backingSpace. addrsNotFound: ${addrsNotFound} (E: genuuid)`);
+            }
+            return resGet.ibGibs[0];
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)} (E: genuuid)`);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=node-workspace-projection-space-v1.mjs.map

package/dist/witness/space/node-workspace-projection-space/node-workspace-projection-space-v1.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-workspace-projection-space-v1.mjs","sourceRoot":"","sources":["../../../../src/witness/space/node-workspace-projection-space/node-workspace-projection-space-v1.mts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/node-gib",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "Node and server-specific ibGib code, i.e., things that don't run in the browser.",
   "funding": {
     "type": "individual",
@@ -24,10 +24,10 @@
   "author": "William Raiford",
   "license": "ISC",
   "dependencies": {
-    "@ibgib/helper-gib": "^0.0.37",
-    "@ibgib/ts-gib": "^0.5.34",
-    "@ibgib/core-gib": "^0.1.77",
-    "@ibgib/encrypt-gib": "^0.3.1"
+    "@ibgib/helper-gib": "^0.0.38",
+    "@ibgib/ts-gib": "^0.5.35",
+    "@ibgib/core-gib": "^0.1.79",
+    "@ibgib/encrypt-gib": "^0.3.2"
   },
   "devDependencies": {
     "@types/node": "^20.2.1"

package/src/email/aws/email-receiver-aws.mts

@@ -18,7 +18,7 @@ export class EmailReceiverAws extends EmailReceiverBase {
             try {
                 rawData = JSON.parse(rawData);
             } catch {
-                throw new Error('Invalid JSON string in AWS inbound payload. (E: 6f7890123456789abcdef6a7b8c9d0e1)');
+                throw new Error('Invalid JSON string in AWS inbound payload. (E: genuuid)');
             }
         }
 
@@ -27,7 +27,7 @@ export class EmailReceiverAws extends EmailReceiverBase {
             try {
                 const certUrl = new URL(rawData.SigningCertURL);
                 if (certUrl.protocol !== 'https:' || !certUrl.hostname.endsWith('.amazonaws.com')) {
-                    throw new Error(`Invalid SNS SigningCertURL host: ${rawData.SigningCertURL} (E: a9b8c7d6e5f432109876543210fedcba)`);
+                    throw new Error(`Invalid SNS SigningCertURL host: ${rawData.SigningCertURL} (E: genuuid)`);
                 }
             } catch (err: any) {
                 if (err?.message?.includes('(E: ')) { throw err; }
@@ -45,7 +45,7 @@ export class EmailReceiverAws extends EmailReceiverBase {
         }
 
         if (!rawData || typeof rawData !== 'object') {
-            throw new Error('Invalid payload structure for AWS SES email parsing. (E: 7890123456789abcdef7a8b9c0d1e2f3)');
+            throw new Error('Invalid payload structure for AWS SES email parsing. (E: genuuid)');
         }
 
         const mail = rawData.mail || {};

package/src/email/aws/email-sender-aws.mts

@@ -27,7 +27,7 @@ export class EmailSenderAws extends EmailSenderBase {
     constructor(options: EmailSenderAwsOptions) {
         super();
         if (!options.accessKeyId || !options.secretAccessKey) {
-            throw new Error('EmailSenderAws requires accessKeyId and secretAccessKey. (E: 5e6f7890123456789abcdef5a6b7c8d9)');
+            throw new Error('EmailSenderAws requires accessKeyId and secretAccessKey. (E: genuuid)');
         }
         this.accessKeyId = options.accessKeyId;
         this.secretAccessKey = options.secretAccessKey;