@ibgib/ts-gib 0.4.9

package/dist/V1/transforms/rel8.mjs

@@ -0,0 +1,176 @@
+import { getIbGibAddr, clone, getTimestamp } from '../../helper.mjs';
+import { Rel8n } from '../types.mjs';
+import { IBGIB_DELIMITER, FORBIDDEN_ADD_RENAME_REMOVE_REL8N_NAMES } from '../constants.mjs';
+import { buildDna, getGib, isPrimitive } from './transform-helper.mjs';
+/**
+ * Original-ish V1 transform behavior.
+ *
+ * NOTE:
+ *   This is NOT going to do the plan^gib stuff ATM.
+ *   Also this does NOT add any identity information ATM.
+ */
+/**
+ * Relate (and/or unrelate) other ibGib(s), thus mutating it **extrinsically**.
+ */
+export async function rel8(opts) {
+    const { noTimestamp, dna, linkedRel8ns, rel8nsToAddByAddr, rel8nsToRemoveByAddr, type = 'rel8' } = opts;
+    let src = opts.src;
+    const lc = '[rel8_v1]';
+    if (type !== 'rel8') {
+        throw new Error(`${lc} not a rel8 transform.`);
+    }
+    if (!opts.type) {
+        opts.type = 'rel8';
+    }
+    // #region validation
+    if (type !== 'rel8') {
+        throw new Error(`${lc} not a rel8 transform.`);
+    }
+    if (!opts.type) {
+        opts.type = 'rel8';
+    }
+    if (!src) {
+        throw new Error(`${lc} src required.`);
+    }
+    if (!src.ib) {
+        throw new Error(`${lc} src.ib required.`);
+    }
+    if (src.ib.includes(IBGIB_DELIMITER)) {
+        throw new Error(`${lc} ib can't contain hardcoded delimiter (${IBGIB_DELIMITER}) right now.`);
+    }
+    if (!src.gib) {
+        throw new Error(`${lc} src.gib required.`);
+    }
+    // if (!src.gib || src.gib === GIB) { throw new Error(`${lc} cannot relate to primitive ibGib.`); }
+    if (isPrimitive({ ibGib: src })) {
+        throw new Error(`${lc} cannot relate/unrelate primitive ibgib`);
+    }
+    // if neither add nor remove specified, what are we even doing?
+    const isAdding = rel8nsToAddByAddr && Object.keys(rel8nsToAddByAddr).length > 0;
+    const isRemoving = rel8nsToRemoveByAddr && Object.keys(rel8nsToRemoveByAddr).length > 0;
+    if (!(isAdding || isRemoving)) {
+        throw new Error(`${lc} gotta provide relations to either add or remove.`);
+    }
+    const srcAddr = getIbGibAddr({ ib: src.ib, gib: src.gib });
+    if (opts.srcAddr && srcAddr !== opts.srcAddr) {
+        throw new Error(`${lc} srcAddr from src does not equal opts.srcAddr`);
+    }
+    opts.srcAddr = srcAddr;
+    // validate all ibgib addresses to add/remove
+    const fnValidIbGibAddr = (s) => {
+        // for now, only requiring a single character and trailing delim.
+        // i.e. primitive with implied 'gib'
+        return s && typeof (s) === 'string' && s.length >= 2 &&
+            s.includes('^') && s.split('^')[0].length >= 1;
+    };
+    Object.keys(rel8nsToAddByAddr || {})
+        .map(x => (rel8nsToAddByAddr || {})[x])
+        .forEach(rel8ds => {
+        if (!(rel8ds && rel8ds.every(rel8d => fnValidIbGibAddr(rel8d)))) {
+            throw new Error(`${lc} Invalid rel8n attempt. Must be valid ibGibs. Did you include a delimiter (^)?`);
+        }
+    });
+    Object.keys(rel8nsToRemoveByAddr || {})
+        .map(x => (rel8nsToRemoveByAddr || {})[x])
+        .forEach(rel8ds => {
+        if (!(rel8ds && rel8ds.every(rel8d => fnValidIbGibAddr(rel8d)))) {
+            throw new Error(`${lc} Invalid remove rel8n attempt. Must be valid ibGibs. Did you include a delimiter (^)?`);
+        }
+    });
+    // #endregion validation
+    // we want to forget `src` proper very quickly because it may have other
+    // non-IbGib properties that are not relevant to our transform.
+    let dto = { ib: src.ib, gib: src.gib, };
+    if (src.data && Object.keys(src.data).length > 0) {
+        dto.data = src.data;
+    }
+    if (src.rel8ns && Object.keys(src.rel8ns).length > 0) {
+        dto.rel8ns = src.rel8ns;
+    }
+    src = dto;
+    const newIbGib = clone(src);
+    const data = clone(src.data || {});
+    if (opts.nCounter || Object.keys(data).includes('n')) {
+        if (Object.keys(data).includes('n')) {
+            if (Number.isInteger(data.n)) {
+                if (data.n >= 0) {
+                    data.n = data.n + 1;
+                }
+                else {
+                    console.warn(`${lc} data.n is less than 0, which is unexpected. Resetting data.n to 0.`);
+                    data.n = 0;
+                }
+            }
+            else {
+                throw new Error('cannot increment nCounter because data.n is not a number.');
+            }
+        }
+        else {
+            data.n = 0;
+        }
+    }
+    if (!noTimestamp) {
+        data.timestamp = getTimestamp();
+    }
+    const rel8ns = clone(src.rel8ns || {});
+    Object.keys(rel8nsToAddByAddr || {}).forEach(rel8nName => {
+        if (FORBIDDEN_ADD_RENAME_REMOVE_REL8N_NAMES.includes(rel8nName)) {
+            throw new Error(`${lc} Cannot manually add relationship: ${rel8nName}.`);
+        }
+        const existingRel8d = rel8ns[rel8nName] || [];
+        const toAddRel8d = rel8nsToAddByAddr[rel8nName];
+        const newRel8d = toAddRel8d.filter(x => !existingRel8d.includes(x));
+        rel8ns[rel8nName] = existingRel8d.concat(newRel8d);
+    });
+    Object.keys(rel8nsToRemoveByAddr || {}).forEach(rel8nName => {
+        if (FORBIDDEN_ADD_RENAME_REMOVE_REL8N_NAMES.includes(rel8nName)) {
+            throw new Error(`${lc} Cannot manually remove relationship: ${rel8nName}.`);
+        }
+        const existingRel8d = rel8ns[rel8nName] || [];
+        const toRemoveRel8d = rel8nsToRemoveByAddr[rel8nName] || [];
+        const prunedRel8d = existingRel8d.filter((x) => !toRemoveRel8d.includes(x));
+        if (prunedRel8d.length > 0) {
+            rel8ns[rel8nName] = prunedRel8d;
+        }
+        else {
+            delete rel8ns[rel8nName];
+        }
+    });
+    rel8ns.past = (rel8ns.past || []).concat([srcAddr]);
+    (linkedRel8ns || [])
+        .filter(linkedRel8nName => Object.keys(rel8ns).includes(linkedRel8nName))
+        .filter(linkedRel8nName => (rel8ns[linkedRel8nName] || []).length > 1)
+        .forEach(linkedRel8nName => {
+        // take the last item only, and put it in an array
+        let initialLength = rel8ns[linkedRel8nName].length;
+        rel8ns[linkedRel8nName] = [rel8ns[linkedRel8nName][initialLength - 1]];
+    });
+    // rel8ns.past = linkedRel8ns?.includes(Rel8n.past) ?
+    //     [srcAddr] :
+    //     (rel8ns.past || []).concat([srcAddr]);
+    if (data.isTjp) {
+        let tjpRel8n = rel8ns['tjp'] || [];
+        tjpRel8n.push(srcAddr);
+        rel8ns.tjp = tjpRel8n;
+        delete data.isTjp;
+    }
+    newIbGib.data = data;
+    newIbGib.rel8ns = rel8ns;
+    // newIbGib.gib = await sha256v1(newIbGib, '');
+    const hasTjp = (rel8ns.tjp?.length ?? 0) > 0;
+    let transformDna = null;
+    if (dna) {
+        transformDna = await buildDna(opts);
+        const dnaAddr = getIbGibAddr({ ibGib: transformDna });
+        rel8ns.dna = linkedRel8ns?.includes(Rel8n.dna) ?
+            rel8ns.dna = [dnaAddr] :
+            rel8ns.dna = (rel8ns.dna || []).concat(dnaAddr);
+    }
+    newIbGib.gib = await getGib({ ibGib: newIbGib, hasTjp });
+    const result = { newIbGib };
+    if (transformDna) {
+        result.dnas = [transformDna];
+    }
+    return result;
+}
+//# sourceMappingURL=rel8.mjs.map

package/dist/V1/transforms/rel8.mjs.map

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

package/dist/V1/transforms/transform-helper.d.mts

@@ -0,0 +1,92 @@
+import { TransformOpts, IbGib, Gib, IbGibAddr } from "../../types.mjs";
+import { GibInfo, IbGib_V1 } from "../types.mjs";
+export declare function buildDna<TSrc extends IbGib_V1, TOpts extends TransformOpts<TSrc>>(opts: TOpts): Promise<IbGib_V1>;
+export declare function isDna({ ibGib }: {
+    ibGib: IbGib;
+}): boolean;
+export declare function isPrimitive({ ibGib, gib }: {
+    ibGib?: IbGib_V1;
+    gib?: Gib;
+}): boolean;
+/**
+ * Generates the gib of a given `ibGib` depending on
+ * @returns gib - either bare hash for those with no tjp; or tjp-scoped hash; or 'gib' for primitives
+ */
+export declare function getGib({ ibGib, hasTjp, tjpAddr, gibDelimiter, isPrimitive, hashAlgorithm, }: {
+    /**
+     * We'll take the `ib`, `data`, and `rel8ns` from this
+     */
+    ibGib: IbGib_V1;
+    /**
+     * If true, then we'll treat this as having a tjp.
+     * If falsy, then we'll check the internals of the ibGib to see if it has a tjp.
+     */
+    hasTjp?: boolean;
+    /**
+     * @deprecated
+     *
+     * IGNORED
+     *
+     * This is now always searched for in the ibGib itself.
+     */
+    tjpAddr?: IbGibAddr;
+    /**
+     * What to use as the delimiter for the `gib`.
+     *
+     * @default GIB_DELIMITER
+     *
+     * ## notes
+     *
+     * This is not the same thing necessarily as the ib^gib delimiter.
+     * In fact the default gibDelimiter ATOW ('.') is different than the
+     * default ib^gib delimiter ('^').
+     */
+    gibDelimiter?: string;
+    /**
+     * If this is primitive, then the `gib` is always GIB ("gib" string literal).
+     */
+    isPrimitive?: boolean;
+    /**
+     * Hash algorithm to use when calculating the gib hash of the ibgib datum.
+     *
+     * ## notes
+     *
+     * * I'm just including this now to show where we will expand when working with
+     *   multiple hash algorithms. For now though, in all of V1, we use 'SHA-256'
+     *   when calculating the gib hashes. This is why I'm hard-coding the type
+     *   here instead of using this lib's `HashAlgorithm` type.
+     *   * This param is actually ignored ATOW.
+     * * In my current consuming use case (ionic-gib), though,
+     *   I am indeed using SHA-512 when encrypting using encrypt-gib. I only note
+     *   this in case someone sees "SHA-512" code somewhere and is confused.
+     */
+    hashAlgorithm?: 'SHA-256';
+}): Promise<string>;
+/**
+ * Parses gib (either via `gib` param or `ibGibAddr.gib`) and returns information
+ * about it.
+ *
+ * @returns Information about the given `gib` (or `gib` extracted from `ibGibAddr`)
+ */
+export declare function getGibInfo({ ibGibAddr, gib, gibDelimiter, }: {
+    /**
+     * If given, will extract `gib` from this.
+     */
+    ibGibAddr?: IbGibAddr;
+    /**
+     * `gib` to analyze.
+     */
+    gib?: Gib;
+    /**
+     * Delimiter among pieces of gib, if applicable.
+     *
+     * @default GIB_DELIMITER (ATOW '.')
+     *
+     * ## notes
+     *
+     * Some `gib` values will include tjp information, while others
+     * are just the hash.
+     */
+    gibDelimiter?: string;
+}): GibInfo;
+//# sourceMappingURL=transform-helper.d.mts.map

package/dist/V1/transforms/transform-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-helper.d.mts","sourceRoot":"","sources":["../../../src/V1/transforms/transform-helper.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,EAAM,SAAS,EAAG,MAAM,iBAAiB,CAAC;AAG5E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAG,MAAM,cAAc,CAAC;AAGlD,wBAAsB,QAAQ,CAAC,IAAI,SAAS,QAAQ,EAAE,KAAK,SAAS,aAAa,CAAC,IAAI,CAAC,EACnF,IAAI,EAAE,KAAK,GACZ,OAAO,CAAC,QAAQ,CAAC,CAgCnB;AAED,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG,OAAO,CAsB1D;AAED,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,GAAG,OAAO,CASpF;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,EACzB,KAAK,EACL,MAAM,EACN,OAAO,EACP,YAAY,EACZ,WAAW,EACX,aAAa,GAChB,EAAE;IACC;;OAEG;IACH,KAAK,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,EAAE,SAAS,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DlB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACvB,SAAS,EACT,GAAG,EACH,YAAY,GACf,EAAE;IACC;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;OAEG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC;IACV;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAmCV"}

package/dist/V1/transforms/transform-helper.mjs

@@ -0,0 +1,189 @@
+import { clone, getIbGibAddr, getIbAndGib, extractErrorMsg, } from "../../helper.mjs";
+import { sha256v1, } from "../sha256v1.mjs";
+import { IBGIB_DELIMITER, GIB, GIB_DELIMITER } from "../constants.mjs";
+export async function buildDna(opts) {
+    const transformData = clone(opts);
+    let lc = `[${buildDna.name}]`;
+    // remove references to the srcAddr, as this will be captured
+    // by the ibGib's `past` rel8n. This way, we can reapply dna
+    // to different src's more easily, as well as have less unique dna
+    if (transformData.srcAddr) {
+        delete transformData.srcAddr;
+    }
+    // remove all references to actual objects in this, we just
+    // want the data. ATOW, src is a reference to the src object
+    // and we only want the srcAddr
+    delete transformData.src;
+    // dna is never timestamped or uniquely identified hmm...
+    // or rel8d to anything...hmmm
+    // so much dna, best to minimize though of course we dont
+    // want to prematurely optimize...but there's a looooot of dna.
+    // best to share/reuse as much as possible.
+    const result = {
+        ib: transformData.type,
+        data: transformData,
+        rel8ns: {
+            ancestor: [
+                `${transformData.type.toString()}${IBGIB_DELIMITER}${GIB}` // e.g. fork^gib
+            ]
+        }
+    };
+    result.gib = await sha256v1(result);
+    return result;
+}
+export function isDna({ ibGib }) {
+    const lc = `[${isDna.name}]`;
+    try {
+        if (!ibGib) {
+            throw new Error(`ibGib required.`);
+        }
+        // console.log(`${lc} ibGib: ${pretty(ibGib)}`);
+        // ancestor is known transform is the best way for v1 ATOW
+        const knownTransformPrimitiveAddrs = ['fork', 'mut8', 'rel8', 'plan'].map(x => `${x}^${GIB}`); // plan from prev versions
+        const hasTransformAncestor = (ibGib.rel8ns) &&
+            (ibGib.rel8ns.ancestor) &&
+            (Array.isArray(ibGib.rel8ns.ancestor)) &&
+            (ibGib.rel8ns.ancestor).
+                some((x) => knownTransformPrimitiveAddrs.includes(x));
+        return hasTransformAncestor || false;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+export function isPrimitive({ ibGib, gib }) {
+    if (ibGib) {
+        return isPrimitive({ gib: ibGib.gib });
+    }
+    else if (gib) {
+        return gib === GIB;
+    }
+    else {
+        // falsy gib means it's primitive or a programming error...hmm
+        return true;
+    }
+}
+/**
+ * Generates the gib of a given `ibGib` depending on
+ * @returns gib - either bare hash for those with no tjp; or tjp-scoped hash; or 'gib' for primitives
+ */
+export async function getGib({ ibGib, hasTjp, tjpAddr, gibDelimiter, isPrimitive, hashAlgorithm, }) {
+    const lc = `[${getGib.name}]`;
+    try {
+        if (!ibGib) {
+            throw new Error(`ibGib required. (E: 17d073226b9d42fd841e5a94b065ef21)`);
+        }
+        if (isPrimitive) {
+            return GIB;
+        }
+        const ibGibHash = await sha256v1(ibGib, '');
+        const rel8ns = ibGib.rel8ns ?? {};
+        const data = ibGib.data ?? {};
+        gibDelimiter = gibDelimiter || GIB_DELIMITER;
+        if (!hasTjp) {
+            hasTjp = (rel8ns.tjp?.length ?? []) > 0 || data.isTjp || false;
+        }
+        if (hasTjp) {
+            let tjpAddrGib;
+            if (rel8ns.tjp) {
+                if (rel8ns.tjp.length === 1) {
+                    if (rel8ns.tjp[0]) { // checking for empty string
+                        tjpAddr = rel8ns.tjp[0];
+                    }
+                    else {
+                        throw new Error(`rel8ns.tjp[0] is falsy. (E: ed879d2b039543f8b1902e8b7b5a5a7b)`);
+                    }
+                }
+                else if (rel8ns.tjp.length > 1) {
+                    if (rel8ns.tjp[rel8ns.tjp.length - 1]) {
+                        console.warn(`${lc} found more than one tjp addr...only expecting 1 ATOW. (W: 10ed43f716e743e0afd1954f1ab46789)`);
+                        tjpAddr = rel8ns.tjp[rel8ns.tjp.length - 1];
+                    }
+                    else {
+                        throw new Error(`multiple tjp addrs, and the last (most recent) one is falsy. (E: bc835dc89be24075bba8b2b6616ea069)`);
+                    }
+                }
+                else {
+                    // empty rel8ns.tjp array?
+                    throw new Error(`hasTjp is true but rel8ns.tjp is empty array. (E: d08b2f9e86494814b5e7d7b4602b2ab7)`);
+                }
+            }
+            else if (data.isTjp) {
+                // the ibGib itself is the tjp
+                tjpAddr = getIbGibAddr({ ib: ibGib.ib, gib: ibGibHash });
+            }
+            else {
+                throw new Error(`hasTjp is true, but both ibGib.rel8ns.tjp and ibGib.data.isTjp are falsy. (E: 4e246897e52044789594d853bb5b66ee)`);
+            }
+            tjpAddrGib = tjpAddr ? getIbAndGib({ ibGibAddr: tjpAddr }).gib : undefined;
+            if (tjpAddrGib) {
+                // if the ibGib IS the tjp, then the gib is only the hash
+                // if the ibGib is NOT the tjp, then the gib is the hash plus
+                // tjpGib. note in the future, if multiple tjps are going, then
+                // tjpAddrGib itself may have another delim inside it, so we
+                // will end up with a gib with multiple delimiters.
+                return data.isTjp ? ibGibHash : `${ibGibHash}${GIB_DELIMITER}${tjpAddrGib}`;
+            }
+            else {
+                throw new Error(`hasTjp is true but could not find tjpAddrGib. (E: 1863df626b754744a1d431a683cb0ba0)`);
+            }
+        }
+        else {
+            // no tjp, so gib is just the hash
+            return ibGibHash;
+        }
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+/**
+ * Parses gib (either via `gib` param or `ibGibAddr.gib`) and returns information
+ * about it.
+ *
+ * @returns Information about the given `gib` (or `gib` extracted from `ibGibAddr`)
+ */
+export function getGibInfo({ ibGibAddr, gib, gibDelimiter, }) {
+    const lc = `[${getGibInfo.name}]`;
+    try {
+        if (!ibGibAddr && !gib) {
+            throw new Error(`Either ibGibAddr or gib required. (E: 25e3dcbe63cd44909032df12af9df75e)`);
+        }
+        gib = gib || getIbAndGib({ ibGibAddr }).gib;
+        if (gib === GIB) {
+            return { isPrimitive: true };
+        }
+        gibDelimiter = gibDelimiter ?? GIB_DELIMITER;
+        if (gib.includes(gibDelimiter)) {
+            const pieces = gib.split(gibDelimiter);
+            if (pieces.some(p => p === '')) {
+                throw new Error(`unexpected gib that contains gibDelimiter (${gibDelimiter}) but has at least one piece with empty string. (E: 75a94280045541009ee68182d12d3449)`);
+            }
+            const piecesCount = pieces.length;
+            if (piecesCount > 2) {
+                console.warn(`${lc} gib only expected to have two pieces ATOW. re-examine please. (W: aa4283ac5a5747a386a69966ecdad39d)`);
+            }
+            const punctiliarHashPiece = pieces.splice(0, 1);
+            return {
+                punctiliarHash: punctiliarHashPiece[0],
+                tjpGib: pieces.join(gibDelimiter),
+                piecesCount,
+                delimiter: gibDelimiter,
+            };
+        }
+        else {
+            return {
+                punctiliarHash: gib,
+                piecesCount: 1,
+                delimiter: gibDelimiter,
+            };
+        }
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=transform-helper.mjs.map

package/dist/V1/transforms/transform-helper.mjs.map

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

package/dist/V1/types.d.mts

@@ -0,0 +1,79 @@
+/**
+ * The core of the simplicity of the ibGib protocol is that you are
+ * taking two (or more) ibGibs and producing other ibGibs.
+ *
+ * There are three primary functions: mut8, rel8, fork
+ *
+ * These are actually different aspects of the single function of
+ * relationship and time, either:
+ *   1) Creating a 'new' timeline, or...
+ *   2) Extending an existing one.
+ *
+ * Mut8 is intrinsic, rel8 is extrinsic, fork is a new timeline.
+ * Mut8 changes a timeline, rel8 changes a timeline's link(s),
+ * fork creates a new timeline.
+ */
+import { IbGibRel8ns, IbGibAddr, IbGibWithDataAndRel8ns, Gib } from '../types.mjs';
+/**
+ * Need to see if I can remove this...
+ */
+export declare type IbGibData_V1 = {
+    [key: string]: any;
+    isTjp?: boolean;
+    n?: number;
+    timestamp?: string;
+    uuid?: string;
+};
+/**
+ * Convenience enum to avoid spelling mistakes. (optional)
+ */
+export declare enum Rel8n {
+    past = "past",
+    ancestor = "ancestor",
+    dna = "dna",
+    identity = "identity",
+    tjp = "tjp"
+}
+export interface IbGibRel8ns_V1 extends IbGibRel8ns {
+    [Rel8n.past]?: IbGibAddr[];
+    [Rel8n.identity]?: IbGibAddr[];
+    [Rel8n.ancestor]?: IbGibAddr[];
+    [Rel8n.dna]?: IbGibAddr[];
+    [Rel8n.tjp]?: IbGibAddr[];
+}
+export interface IbGib_V1<TData = IbGibData_V1, TRel8ns extends IbGibRel8ns_V1 = IbGibRel8ns_V1> extends IbGibWithDataAndRel8ns<TData, TRel8ns> {
+}
+export interface GibInfo {
+    /**
+     * Hash for this ibgib frame in time.
+     */
+    punctiliarHash?: string;
+    /**
+     * The gib for this ibgib's most recent tjp.
+     *
+     * ## notes
+     *
+     * ATOW, only one tjp expected really, though I've been coding
+     * with the possibility of having multiple tjp's similar to
+     * checkpoints.
+     */
+    tjpGib?: Gib;
+    /**
+     * If
+     */
+    piecesCount?: number;
+    /**
+     * If a delimiter is used in this gib, this is the delimiter.
+     *
+     * ## notes
+     *
+     * ATOW, the caller already knows the delimiter. But I'm thinking that
+     * I may be persisting this at some point and it would be good to include.
+     */
+    delimiter?: string;
+    /**
+     * True the gib is just 'gib' (GIB constant), else falsy.
+     */
+    isPrimitive?: boolean;
+}
+//# sourceMappingURL=types.d.mts.map

package/dist/V1/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/V1/types.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACH,WAAW,EAAE,SAAS,EAAE,sBAAsB,EAAE,GAAG,EACtD,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,CAAC,OAAO,MAAM,YAAY,GAAG;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,oBAAY,KAAK;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,GAAG,QAAQ;CACd;AACD,MAAM,WAAW,cAAe,SAAQ,WAAW;IAC/C,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;CAC7B;AACD,MAAM,WAAW,QAAQ,CAAC,KAAK,GAAG,YAAY,EAAE,OAAO,SAAS,cAAc,GAAG,cAAc,CAC3F,SAAQ,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC;CACjD;AAED,MAAM,WAAW,OAAO;IACpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/V1/types.mjs

@@ -0,0 +1,12 @@
+/**
+ * Convenience enum to avoid spelling mistakes. (optional)
+ */
+export var Rel8n;
+(function (Rel8n) {
+    Rel8n["past"] = "past";
+    Rel8n["ancestor"] = "ancestor";
+    Rel8n["dna"] = "dna";
+    Rel8n["identity"] = "identity";
+    Rel8n["tjp"] = "tjp";
+})(Rel8n || (Rel8n = {}));
+//# sourceMappingURL=types.mjs.map

package/dist/V1/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/V1/types.mts"],"names":[],"mappings":"AA8BA;;GAEG;AACH,MAAM,CAAN,IAAY,KAMX;AAND,WAAY,KAAK;IACb,sBAAa,CAAA;IACb,8BAAqB,CAAA;IACrB,oBAAW,CAAA;IACX,8BAAqB,CAAA;IACrB,oBAAW,CAAA;AACf,CAAC,EANW,KAAK,KAAL,KAAK,QAMhB"}

package/dist/helper.d.mts

@@ -0,0 +1,77 @@
+import { Ib, Gib, IbGib, IbGibAddr, IbAndGib } from './types.mjs';
+export type HashAlgorithm = 'SHA-256' | 'SHA-512';
+export declare const HashAlgorithm: {
+    [key: string]: HashAlgorithm;
+};
+export declare function clone(obj: any): any;
+export declare function getTimestamp(): string;
+/**
+ * Gets the ib^gib address from the given ib and gib or
+ * from the ibGib object.
+ *
+ * Need to refactor to getIbGibAddr
+ */
+export declare function getIbGibAddr({ ib, gib, ibGib, delimiter }: {
+    ib?: Ib;
+    gib?: Gib;
+    ibGib?: IbGib;
+    delimiter?: string;
+}): string;
+/**
+ * Get the ib and gib fields from an ibGib object or ibGibAddr
+ * with the given `delimiter`.
+ */
+export declare function getIbAndGib({ ibGib, ibGibAddr, delimiter }: {
+    ibGibAddr?: IbGibAddr;
+    ibGib?: IbGib;
+    delimiter?: string;
+}): IbAndGib;
+/**
+ * Simple hash function.
+ *
+ * NOTE:
+ *   This is not used for ibGib.gib values (ATOW)
+ *   but rather as a helper function for generating random UUIDs.
+ *
+ * @param s string to hash
+ * @param algorithm to use, currently only 'SHA-256'
+ */
+export declare function hash({ s, algorithm, }: {
+    s: string;
+    algorithm?: HashAlgorithm;
+}): Promise<string>;
+/**
+ * Simple func to generate UUID (sha-256 hash basically).
+ *
+ * @param seedSize size of seed for UUID generation
+ */
+export declare function getUUID(seedSize?: number): Promise<string>;
+/**
+ * Syntactic sugar for JSON.stringify(obj, null, 2);
+ *
+ * @param obj to pretty stringify
+ */
+export declare function pretty(obj: any): string;
+/**
+ * Just delays given number of ms.
+ *
+ * @param ms milliseconds to delay
+ */
+export declare function delay(ms: number): Promise<void>;
+/**
+ * extracts the error message from an error object/string/falsy arg.
+ *
+ * ## notes
+ *
+ * * some libs throw errors, some throw just strings.
+ * * who knows what else it could be.
+ *
+ * ## todo
+ *
+ * * extract inner errors/causes if we ever use this function extensively.
+ *
+ * @param error the error object in the catch area of the try..catch block.
+ * @returns error.message if it's a string, error itself if it's a string, or canned error messages if it's falsy or none of the above.
+ */
+export declare function extractErrorMsg(error: any): string;
+//# sourceMappingURL=helper.d.mts.map

package/dist/helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.mts","sourceRoot":"","sources":["../src/helper.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIlE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;AAClD,eAAO,MAAM,aAAa,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;CAGzD,CAAA;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,OAE7B;AACD,wBAAgB,YAAY,WAE3B;AACD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EACzB,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAe,EAClC,EAAE;IACC,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,UAIA;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,SAAS,EACT,SAAe,EAClB,EAAE;IACC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,QAAQ,CAyCX;AAED;;;;;;;;;GASG;AACH,wBAAsB,IAAI,CAAC,EACvB,CAAC,EACD,SAAqB,GACxB,EAAE;IACC,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,CAAC,EAAE,aAAa,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,QAAQ,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAW5D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAYlD"}