@ibgib/node-gib 0.0.2

package/dist/witness/space/metaspace/metaspace-nodespace/metaspace-nodespace-helper.mjs

@@ -0,0 +1,267 @@
+import { extractErrorMsg, getTimestamp, getUUID, pretty } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { getGib, isPrimitive } from "@ibgib/ts-gib/dist/V1/transforms/transform-helper.mjs";
+import { GIB } from "@ibgib/ts-gib/dist/V1/constants.mjs";
+import { getIbAndGib } from "@ibgib/ts-gib/dist/helper.mjs";
+import { fnObs } from "@ibgib/core-gib/dist/common/pubsub/observer/observer-helper.mjs";
+import { isSpaceIb, spaceNameIsValid } from "@ibgib/core-gib/dist/witness/space/space-helper.mjs";
+import { IBGIB_BASE_DIR, IBGIB_BASE_SUBPATH, IBGIB_BIN_SUBPATH, IBGIB_DNA_SUBPATH, IBGIB_ENCODING, IBGIB_IBGIBS_SUBPATH, IBGIB_META_SUBPATH } from "@ibgib/core-gib/dist/witness/space/filesystem-space/filesystem-constants.mjs";
+import { DEFAULT_LOCAL_SPACE_DESCRIPTION, DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS, PERSIST_OPTS_AND_RESULTS_IBGIBS_DEFAULT } from "@ibgib/core-gib/dist/witness/space/space-constants.mjs";
+import { GLOBAL_LOG_A_LOT } from "../../../../constants.mjs";
+import { getFnPrompt } from "../../../../common/prompt-functions.mjs";
+import { NodeFilesystemSpace_V1 } from "../../node-filesystem-space/node-filesystem-space-v1.mjs";
+/**
+ * used in verbose logging (across all ibgib libs atow)
+ */
+const logalot = GLOBAL_LOG_A_LOT;
+export const fnCreateNewLocalSpace = async ({ allowCancel, spaceName, logalot, }) => {
+    const lc = `[fnCreateNewLocalSpace]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 15bcc16f4f3f9e40e743931a3965ff22)`);
+        }
+        if (spaceName && !spaceNameIsValid(spaceName)) {
+            throw new Error(`spaceName (${spaceName}) is invalid.  (E: 820b291cccf9f405f9e0cce87143e323)`);
+            // throw because this is used in RCLI and automated testing...
+        }
+        if (!spaceName) {
+            const promptName = async () => {
+                const fnPrompt = getFnPrompt();
+                const resName = await fnPrompt({
+                    title: 'greetings program', msg: `all of your data is stored locally on your device's "local space".
+
+so name your space with alphanumerics & underscores, like 'phone_alice' or 'web_bob_foo', or leave blank and get a random name.
+
+Enter space name:
+`
+                });
+                if (resName === '' && !allowCancel) {
+                    spaceName = 'space_' + (await getUUID()).slice(0, 10);
+                }
+                else {
+                    if (resName && spaceNameIsValid(resName)) {
+                        spaceName = resName;
+                    }
+                }
+            };
+            // ...prompt for name
+            await promptName();
+            if (!spaceName) {
+                return undefined; /* <<<< returns early */
+            }
+        }
+        // ...create in memory with defaults
+        const newLocalSpace = new NodeFilesystemSpace_V1(/*initialData*/ {
+            version: '1',
+            uuid: await getUUID(),
+            isTjp: true,
+            timestamp: getTimestamp(),
+            name: spaceName,
+            baseDir: IBGIB_BASE_DIR,
+            spaceSubPath: spaceName,
+            baseSubPath: IBGIB_BASE_SUBPATH,
+            binSubPath: IBGIB_BIN_SUBPATH,
+            dnaSubPath: IBGIB_DNA_SUBPATH,
+            ibgibsSubPath: IBGIB_IBGIBS_SUBPATH,
+            metaSubPath: IBGIB_META_SUBPATH,
+            encoding: IBGIB_ENCODING,
+            persistOptsAndResultIbGibs: PERSIST_OPTS_AND_RESULTS_IBGIBS_DEFAULT,
+            validateIbGibAddrsMatchIbGibs: true,
+            trace: false,
+            description: DEFAULT_LOCAL_SPACE_DESCRIPTION,
+            allowPrimitiveArgs: false,
+            catchAllErrors: true,
+            longPollingIntervalMs: DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS,
+        }, /*initialRel8ns*/ undefined);
+        if (logalot) {
+            console.log(`${lc} localSpace.ib: ${newLocalSpace.ib}`);
+        }
+        if (logalot) {
+            console.log(`${lc} localSpace.gib: ${newLocalSpace.gib} (before sha256v1)`);
+        }
+        if (logalot) {
+            console.log(`${lc} localSpace.data: ${pretty(newLocalSpace.data || 'falsy')}`);
+        }
+        if (logalot) {
+            console.log(`${lc} localSpace.rel8ns: ${pretty(newLocalSpace.rel8ns || 'falsy')}`);
+        }
+        // trying out with tjp, can't remember why didn't have it except for
+        // backwards compatability which i'm no longer shooting for (will be
+        // able to project old spaces to new ones i believe)
+        // newLocalSpace.gib = await getGib({ ibGib: newLocalSpace, hasTjp: false });
+        newLocalSpace.gib = await getGib({ ibGib: newLocalSpace, hasTjp: true });
+        if (newLocalSpace.gib === GIB) {
+            throw new Error(`localSpace.gib not updated correctly.`);
+        }
+        if (logalot) {
+            console.log(`${lc} localSpace.gib: ${newLocalSpace.gib} (after sha256v1)`);
+        }
+        return newLocalSpace;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+};
+export const fnDtoToSpace_nodeFilesystem = (spaceDto) => {
+    return Promise.resolve(NodeFilesystemSpace_V1.createFromDto(spaceDto));
+};
+/**
+ * wrapper around metaspace.syncIbGibs
+ * @param param0
+ * @returns
+ */
+export async function doSync_awaitAllSagas({ addr, metaspace, localSpace, syncSpaces, sagaReporter, verbose, }) {
+    const lc = `[${doSync_awaitAllSagas.name}]`;
+    try {
+        if (logalot || verbose) {
+            console.log(`${lc} starting... (I: 6110576156c3f9a946626ff299870324)`);
+        }
+        const { ib, gib } = getIbAndGib({ ibGibAddr: addr });
+        if (isPrimitive({ gib })) {
+            throw new Error(`can't sync primitive ibgib (${addr}) (E: 7f87261b5378e38d0f237afa35f52d24)`);
+        }
+        if (isSpaceIb({ ib })) {
+            throw new Error(`can't sync entire space ibgib (${addr}) (E: 00f8d70c4b6c7f8c3c8b26cf097ba724)`);
+        }
+        if (syncSpaces.length === 0) {
+            throw new Error(`syncSpaces required (E: 6015c1c2920fa5301defb91933998d24)`);
+        }
+        if (syncSpaces.some(x => !x.witness)) {
+            throw new Error(`(UNEXPECTED) syncSpaces.some(x => !x.witness)? sync spaces should all be witnesses (and have a witness function). these are not supposed to be just dtos (with ib, gib, data, rel8ns props). (E: 2a670f794b065576ee6df6cf22ffb324)`);
+        }
+        if (verbose) {
+            await sagaReporter('getDependencyGraph starting... (I: d20cf9d59432492ebafdc206e1ecb5dc)', null);
+        }
+        const dependencyGraph = await metaspace.getDependencyGraph({
+            space: localSpace,
+            ibGibAddr: addr,
+            live: true,
+            msBetweenRetries: 1_000,
+        });
+        if (verbose) {
+            await sagaReporter('getDependencyGraph complete. (I: a816ca4d1612409a914661bfe97bb4d1)', null);
+            await sagaReporter('syncIbGibs spinning off... (I: 83c8502f93ee46b7ae103d8ff5fa9b42)', null);
+        }
+        const sagas = await metaspace.syncIbGibs({
+            dependencyGraphIbGibs: Object.values(dependencyGraph),
+            syncSpaceIbGibs: syncSpaces,
+            localSpace,
+        }) ?? [];
+        if (sagas.length === 0) {
+            throw new Error(`(UNEXPECTED) metaspace.syncIbGibs returned undefined (no sagas)? (E: 14989ed4c654eb9419a1faaf35a3e224)`);
+        }
+        if (verbose) {
+            await sagaReporter('syncIbGibs spin off complete. these are not yet done, it/they are just spun off and going. (I: b99dd5938064415d87a5420dc37dc1b1)', sagas.at(0) ?? null);
+        }
+        let sagaCount = sagas.length;
+        let sagaErrorCounter = 0;
+        /**
+         * using this during debugging...
+         */
+        const sagaErrorMsgs = [];
+        let sagaCompleteOrErrorCounter = 0;
+        let allSagasCompletePromise = new Promise((resolve, reject) => {
+            const interval = setInterval(async () => {
+                if (sagaCompleteOrErrorCounter === sagaCount) {
+                    if (sagaErrorCounter > 0) {
+                        reject(`saga had errors: ${sagaErrorMsgs.join('|')} (E: 15d75f475612492e8d5d0bcf947fc72b)`);
+                    }
+                    clearInterval(interval);
+                    resolve();
+                }
+            }, 500);
+        });
+        const fnIncCompleteOrError = async (saga) => {
+            const lcInner = `${lc}[fnIncCompleteOrError]`;
+            if (logalot || verbose) {
+                console.log(`${lcInner} starting... (I: 782b3304e67d4ebdb0acce8147a9cd9f)`);
+            }
+            try {
+                sagaCompleteOrErrorCounter++;
+                let updateText;
+                if (sagaCompleteOrErrorCounter < sagaCount) {
+                    updateText = `saga (${saga.sagaId}) complete or errored. ONLY SOME (${sagaCompleteOrErrorCounter}/${sagaCount}) have completed or errored. still more to go...`;
+                }
+                else if (sagaCompleteOrErrorCounter === sagaCount) {
+                    updateText = `saga (${saga.sagaId}) complete or errored. ALL ${sagaCount} sync sagas COMPLETE OR ERRORED.`;
+                }
+                else {
+                    debugger; // unexpected error state. sagaCompleteOrErrorCounter > sagaCount
+                    updateText = `uhh, there is an error here. we have incremented sagaCompleteOrErrorCounter (${sagaCompleteOrErrorCounter}) to be greater than sagaCount (${sagaCount}) (E: 4d8373ee93f2466ab9e5c382ae9a3218)`;
+                }
+                if (logalot || verbose) {
+                    console.log(`${lc} ${updateText} (I: 976c3deaf7f1a592680f3364a0793524)`);
+                    await sagaReporter(`${lcInner} ${updateText}`, saga);
+                }
+            }
+            catch (error) {
+                console.error(`${lc} ${extractErrorMsg(error)}`);
+                throw error;
+            }
+            finally {
+                if (logalot || verbose) {
+                    console.log(`${lc}[fnIncCompleteOrError] complete. (I: 3eb96688a5880fe039445fc3d2374b24)`);
+                }
+            }
+        };
+        for (let i = 0; i < sagas.length; i++) {
+            const saga = sagas[i];
+            let subscription = await saga.syncStatus$.subscribe(fnObs({
+                next: async (status) => {
+                    // debugger; // syncStatus$ fnobs next
+                    if (logalot || verbose) {
+                        console.log(`${lc} console.dir(status)... (I: 87589e683c7be2067d3596a509deaf24)`);
+                        console.dir(status);
+                    }
+                    else {
+                        let statusCode = status.data?.statusCode;
+                        if (statusCode === "already_synced") {
+                            process.stdout.write('.');
+                        }
+                        else {
+                            console.log(statusCode);
+                        }
+                    }
+                },
+                complete: async () => {
+                    // debugger; // syncStatus$ fnobs complete before fnIncCompleteOrError
+                    if (logalot || verbose) {
+                        console.log(`${lc}[saga complete] triggered for saga (${saga.spaceId}, ${saga.multiSpaceOpId}). (I: 237a2d0db5944359b90335c83c9df60f)`);
+                    }
+                    await fnIncCompleteOrError(saga);
+                    await subscription.unsubscribe();
+                },
+                error: async (err) => {
+                    // debugger; // syncStatus$ fnobs error before fnIncCompleteOrError
+                    const errorMsg = extractErrorMsg(err);
+                    sagaErrorMsgs.push(errorMsg);
+                    if (errorMsg.includes('EAI_AGAIN')) {
+                        console.error(`this error may be because of no internet connection. ${errorMsg}`);
+                    }
+                    console.error(`${lc}[error] err: ${errorMsg} (E: fb1b0af934354cc6b41cfe455d1ba12d)`);
+                    sagaErrorCounter++;
+                    await fnIncCompleteOrError(saga);
+                    await subscription.unsubscribe();
+                    // sagaCompleteOrErrorCounter++;
+                }
+            }));
+        }
+        await allSagasCompletePromise;
+        return sagas;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot || verbose) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=metaspace-nodespace-helper.mjs.map

package/dist/witness/space/metaspace/metaspace-nodespace/metaspace-nodespace-helper.mjs.map

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

package/dist/witness/space/metaspace/metaspace-nodespace/metaspace-nodespace.d.mts

@@ -0,0 +1,98 @@
+/**
+ * @module node-metaspace driven by a node+fs storage substrate
+ *
+ * a metaspace is a space of spaces. it adds/removes spaces and does
+ * inter-spatial composition related things. it's similar to what people think
+ * of in terms of a node in a p2p network.
+ */
+import { IbGibSpaceAny } from '@ibgib/core-gib/dist/witness/space/space-base-v1.mjs';
+import { IbGibCacheService } from '@ibgib/core-gib/dist/common/cache/cache-types.mjs';
+import { MetaspaceBase } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-base.mjs';
+import { MetaspaceFactory } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs';
+/**
+ * All-purpose mega service (todo: which we'll need to break up!) to interact
+ * with ibgibs at the app/device level.
+ *
+ * This works with the local app user space.
+ *
+ * ## regarding special ibgibs
+ *
+ * Special ibgibs' behaviors are what hold in other apps configuration data.
+ * Of course the difference is that most special ibgibs can leverage the "on-chain"
+ * functionality of "regular" ibgibs.
+ *
+ * There are a couple meta ibgibs (which I also call "special"):
+ *   * roots^gib
+ *     * tracks other special root^gib ibgibs, which are like local app-level indexes.
+ *   * tags^gib
+ *     * tracks other special tag^gib ibgibs, which you can apply to any ibgib
+ *   * latest^gib
+ *     * tracks mappings between tjp -> latest ib^gib address
+ *     * ephemeral (deletes past rel8ns and past ibGib frames)
+ *   * ...
+ *
+ * ## regarding latest ibgibs
+ *
+ * The tjp (temporal junction point) defines atow the beginning of an ibGib
+ * timeline.  it's like the birthday for an ibGib. (Or you can think if it as
+ * the id for the stream of ibgib frames in a given timeline.)
+ *
+ * The latest ibGib in that timeline is also special, because it's often what
+ * you want to work with.
+ *
+ * So ideally, when an ibgib, A, has a tjp A1, and it is updated to A2, A3, An
+ * via `mut8` and/or `rel8` transforms, that ibgib creates a single timeline.
+ * This service attempts to track the relationship between that starting tjp
+ * address and its corresponding latest frame in that timeline, i.e., A1 -> An.
+ *
+ * ### mapping persistence implementation details
+ *
+ * The latest ibGib service is backed by a special ibgib that maintains the
+ * mapping index.  It does this by rel8-ing that special backing ibgib via the
+ * tjp pointer, e.g. [special latest ibgib^XXX000].rel8ns[A^TJP123] ===
+ * [A^N12345] . It does this via the ib^gib content address pointer, so this
+ * becomes a mapping from A^TJP123 to A^N12345.
+ *
+ * This backing ibGib is special (even for special ibGibs) in that:
+ *   * it does not relate itself with the current root of the application
+ *   * it does not maintain references to its past (i.e. rel8ns['past'] === [])
+ *   * it DELETES its previous incarnation from the files service
+ *
+ * In other words, this service is meant to be as ephemeral as possible. I am
+ * keeping it as an ibGib and not some other data format (like straight in
+ * storage/some other db) because I've found this is often useful and what I end
+ * up doing anyway to leverage other ibgib behavior. For example, in the future
+ * it may be good to take snapshots, which is a simple copy operation of the
+ * file persistence.
+ *
+ * ### current naive implementation notes
+ *
+ * questions:
+ *   * What do we want to do if we can't locate an ibGib record?
+ *   * How/when do we want to alert the user/our own code that we've found
+ *     multiple timelines for an ibGib with a tjp (usually a thing we want to
+ *     avoid)?
+ *   * Who do we want to notify when new ibGibs arrive?
+ *   * How often do we want to check external sources for latest?
+ *   * When do we get to merging ibGib timelines?
+ *
+ * This is behavior that is somewhat taken care of, e.g. in git, with the HEAD
+ * pointer for a repo.  But we're talking about here basically as a metarepo or
+ * "repo of repos", and unlike git, we don't want our HEAD metadata living "off
+ * chain" (outside of the DLT itself that it's modifying).  So eventually, what
+ * we want is just like what we want with ALL ibGibs: perspective. From "the
+ * app"'s perspective, the latest is mapped. But really, apps can't view slices
+ * of ibGib graphs in all sorts of interesting ways and still be productive &
+ * beneficial to the ecosystem as a whole.
+ */
+export declare class Metaspace_Nodespace extends MetaspaceBase {
+    protected cacheSvc: IbGibCacheService | undefined;
+    protected lc: string;
+    get zeroSpace(): IbGibSpaceAny;
+    constructor(cacheSvc: IbGibCacheService | undefined);
+    protected initializeMetaspaceFactory({ metaspaceFactory }: {
+        metaspaceFactory: MetaspaceFactory;
+    }): Promise<void>;
+    initializeZeroSpace(): Promise<void>;
+}
+//# sourceMappingURL=metaspace-nodespace.d.mts.map

package/dist/witness/space/metaspace/metaspace-nodespace/metaspace-nodespace.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaspace-nodespace.d.mts","sourceRoot":"","sources":["../../../../../src/witness/space/metaspace/metaspace-nodespace/metaspace-nodespace.mts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,iEAAiE,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,MAAM,kEAAkE,CAAC;AAQpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IAiBlD,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS;IAdnD,SAAS,CAAC,EAAE,EAAE,MAAM,CAAmC;IAEvD,IAAI,SAAS,IAAI,aAAa,CAO7B;gBAKW,QAAQ,EAAE,iBAAiB,GAAG,SAAS;cAanC,0BAA0B,CAAC,EAAE,gBAAgB,EAAE,EAAE;QAC/D,gBAAgB,EAAE,gBAAgB,CAAC;KACpC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBX,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAa3C"}

package/dist/witness/space/metaspace/metaspace-nodespace/metaspace-nodespace.mjs

@@ -0,0 +1,160 @@
+/**
+ * @module node-metaspace driven by a node+fs storage substrate
+ *
+ * a metaspace is a space of spaces. it adds/removes spaces and does
+ * inter-spatial composition related things. it's similar to what people think
+ * of in terms of a node in a p2p network.
+ */
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { MetaspaceBase } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-base.mjs';
+import { GLOBAL_LOG_A_LOT, GLOBAL_TIMER_NAME } from '../../../../constants.mjs';
+import { fnCreateNewLocalSpace, fnDtoToSpace_nodeFilesystem } from './metaspace-nodespace-helper.mjs';
+import { NodeFilesystemSpace_V1 } from '../../node-filesystem-space/node-filesystem-space-v1.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * All-purpose mega service (todo: which we'll need to break up!) to interact
+ * with ibgibs at the app/device level.
+ *
+ * This works with the local app user space.
+ *
+ * ## regarding special ibgibs
+ *
+ * Special ibgibs' behaviors are what hold in other apps configuration data.
+ * Of course the difference is that most special ibgibs can leverage the "on-chain"
+ * functionality of "regular" ibgibs.
+ *
+ * There are a couple meta ibgibs (which I also call "special"):
+ *   * roots^gib
+ *     * tracks other special root^gib ibgibs, which are like local app-level indexes.
+ *   * tags^gib
+ *     * tracks other special tag^gib ibgibs, which you can apply to any ibgib
+ *   * latest^gib
+ *     * tracks mappings between tjp -> latest ib^gib address
+ *     * ephemeral (deletes past rel8ns and past ibGib frames)
+ *   * ...
+ *
+ * ## regarding latest ibgibs
+ *
+ * The tjp (temporal junction point) defines atow the beginning of an ibGib
+ * timeline.  it's like the birthday for an ibGib. (Or you can think if it as
+ * the id for the stream of ibgib frames in a given timeline.)
+ *
+ * The latest ibGib in that timeline is also special, because it's often what
+ * you want to work with.
+ *
+ * So ideally, when an ibgib, A, has a tjp A1, and it is updated to A2, A3, An
+ * via `mut8` and/or `rel8` transforms, that ibgib creates a single timeline.
+ * This service attempts to track the relationship between that starting tjp
+ * address and its corresponding latest frame in that timeline, i.e., A1 -> An.
+ *
+ * ### mapping persistence implementation details
+ *
+ * The latest ibGib service is backed by a special ibgib that maintains the
+ * mapping index.  It does this by rel8-ing that special backing ibgib via the
+ * tjp pointer, e.g. [special latest ibgib^XXX000].rel8ns[A^TJP123] ===
+ * [A^N12345] . It does this via the ib^gib content address pointer, so this
+ * becomes a mapping from A^TJP123 to A^N12345.
+ *
+ * This backing ibGib is special (even for special ibGibs) in that:
+ *   * it does not relate itself with the current root of the application
+ *   * it does not maintain references to its past (i.e. rel8ns['past'] === [])
+ *   * it DELETES its previous incarnation from the files service
+ *
+ * In other words, this service is meant to be as ephemeral as possible. I am
+ * keeping it as an ibGib and not some other data format (like straight in
+ * storage/some other db) because I've found this is often useful and what I end
+ * up doing anyway to leverage other ibgib behavior. For example, in the future
+ * it may be good to take snapshots, which is a simple copy operation of the
+ * file persistence.
+ *
+ * ### current naive implementation notes
+ *
+ * questions:
+ *   * What do we want to do if we can't locate an ibGib record?
+ *   * How/when do we want to alert the user/our own code that we've found
+ *     multiple timelines for an ibGib with a tjp (usually a thing we want to
+ *     avoid)?
+ *   * Who do we want to notify when new ibGibs arrive?
+ *   * How often do we want to check external sources for latest?
+ *   * When do we get to merging ibGib timelines?
+ *
+ * This is behavior that is somewhat taken care of, e.g. in git, with the HEAD
+ * pointer for a repo.  But we're talking about here basically as a metarepo or
+ * "repo of repos", and unlike git, we don't want our HEAD metadata living "off
+ * chain" (outside of the DLT itself that it's modifying).  So eventually, what
+ * we want is just like what we want with ALL ibGibs: perspective. From "the
+ * app"'s perspective, the latest is mapped. But really, apps can't view slices
+ * of ibGib graphs in all sorts of interesting ways and still be productive &
+ * beneficial to the ecosystem as a whole.
+ */
+export class Metaspace_Nodespace extends MetaspaceBase {
+    cacheSvc;
+    // we won't get an object back, only a DTO ibGib essentially
+    lc = `[${Metaspace_Nodespace.name}]`;
+    get zeroSpace() {
+        const lc = `[${this.lc}][get zeroSpace]`;
+        if (this.metaspaceFactory.fnZeroSpaceFactory) {
+            return this.metaspaceFactory.fnZeroSpaceFactory();
+        }
+        else {
+            throw new Error(`${lc} (UNEXPECTED) this.metaspaceFactory.fnZeroSpaceFactory falsy. not initialized? (E: 9e6c6954dacd868b18c9f34a71e63523)`);
+        }
+    }
+    constructor(
+    // public modalController: ModalController,
+    // public alertController: AlertController,
+    cacheSvc) {
+        super(cacheSvc);
+        this.cacheSvc = cacheSvc;
+        const lc = `${this.lc}[ctor]`;
+        if (logalot) {
+            console.log(`${lc}${GLOBAL_TIMER_NAME}`);
+            console.timeLog(GLOBAL_TIMER_NAME);
+            console.log(`${lc} created. (I: 5690dc2ebf774df3a442bd463dee7455)`);
+        }
+    }
+    async initializeMetaspaceFactory({ metaspaceFactory }) {
+        const lc = `[${this.initializeMetaspaceFactory.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 5a29670439ac47634dcdfe25225c8223)`);
+            }
+            await super.initializeMetaspaceFactory({ metaspaceFactory });
+            metaspaceFactory.fnDefaultLocalSpaceFactory ??= (opts) => fnCreateNewLocalSpace(opts);
+            metaspaceFactory.fnDtoToSpace ??= (spaceDto) => fnDtoToSpace_nodeFilesystem(spaceDto);
+            this.metaspaceFactory.fnZeroSpaceFactory ??= () => {
+                // default to node space
+                const zeroSpace = new NodeFilesystemSpace_V1(/*initialData*/ undefined, /*initialRel8ns*/ undefined);
+                zeroSpace.gib = 'gib';
+                return zeroSpace;
+            };
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    async initializeZeroSpace() {
+        const lc = `[${this.initializeZeroSpace.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: a3364e9601c70c8163e67868e5d67723)`);
+            }
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=metaspace-nodespace.mjs.map

package/dist/witness/space/metaspace/metaspace-nodespace/metaspace-nodespace.mjs.map

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

package/dist/witness/space/node-filesystem-space/node-filesystem-space-helper.d.mts

@@ -0,0 +1,42 @@
+/**
+ * @module node-filesystem-space-helper
+ *
+ */
+import { NodeFilesystemSpace_V1 } from './node-filesystem-space-v1.mjs';
+import { FileDataInfo, FileEncoding } from './node-filesystem-space-types.mjs';
+/**
+ * tries to read the given path. if fails **FOR ANY REASON**, @returns `null`.
+ *
+ * does not throw
+ *
+ * @returns file contents as string or `null`
+ */
+export declare function tryRead({ path, directory, encoding, }: {
+    path: string;
+    directory: string;
+    encoding: string;
+}): Promise<string | Uint8Array | null>;
+export declare function tryRead_bin({ path, directory, encoding, }: {
+    path: string;
+    directory: string;
+    encoding: string;
+}): Promise<FileDataInfo | null>;
+/**
+ * basic validation for a node fs space ibgib
+ */
+export declare function validateNodeFilesystemSpace_V1Intrinsically({ space }: {
+    space: NodeFilesystemSpace_V1<any, any>;
+}): Promise<string[] | null>;
+/**
+ * gets the data and encoding of a given {@link inputPath} if that file exists.
+ * if it doesn't exist, this will throw an ENOENT error, but this is not logged
+ * as an error.
+ *
+ * this is because atow (03/2024) this is only used in a tryRead_bin function
+ * where the file often does not exist.
+ */
+export declare function getFileDataAndEncoding({ inputPath, encodingsToTry, }: {
+    inputPath: string;
+    encodingsToTry?: (FileEncoding | undefined)[];
+}): Promise<FileDataInfo>;
+//# sourceMappingURL=node-filesystem-space-helper.d.mts.map

package/dist/witness/space/node-filesystem-space/node-filesystem-space-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-filesystem-space-helper.d.mts","sourceRoot":"","sources":["../../../../src/witness/space/node-filesystem-space/node-filesystem-space-helper.mts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAkD,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAK/H;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,EAC1B,IAAI,EACJ,SAAS,EACT,QAAQ,GACX,EAAE;IACC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,CA2BtC;AAED,wBAAsB,WAAW,CAAC,EAC9B,IAAI,EACJ,SAAS,EACT,QAAQ,GACX,EAAE;IACC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAuC/B;AAED;;GAEG;AACH,wBAAsB,2CAA2C,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAyFlJ;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,SAAS,EACT,cAA+C,GAClD,EAAE;IACC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE,CAAC;CACjD,GAAG,OAAO,CAAC,YAAY,CAAC,CAwExB"}