@ibgib/core-gib 0.0.89 → 0.0.90

package/dist/common/tag/tag-constants.d.mts

@@ -16,6 +16,4 @@ export declare const DEFAULT_TAG_ICON = "pricetag-outline";
  * Default description when creating a tag.
  */
 export declare const DEFAULT_TAG_DESCRIPTION = "This is a tag used for organizing data.";
-export declare const TAG_TEXT_REGEXP: RegExp;
-export declare const TAG_TEXT_REGEXP_DESCRIPTION = "tag text must start and end with an alphanumeric, and can contain a hyphen, question mark, dot or space.";
 //# sourceMappingURL=tag-constants.d.mts.map

package/dist/common/tag/tag-constants.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tag-constants.d.mts","sourceRoot":"","sources":["../../../src/common/tag/tag-constants.mts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAG1C,eAAO,MAAM,sBAAsB,UAElC,CAAC;AAEF,eAAO,MAAM,sBAAsB,UAElC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD;;GAEG;AACH,eAAO,MAAM,uBAAuB,4CAA4C,CAAC;AAEjF,eAAO,MAAM,eAAe,QAAgC,CAAC;AAC7D,eAAO,MAAM,2BAA2B,6GAA6G,CAAC"}
+{"version":3,"file":"tag-constants.d.mts","sourceRoot":"","sources":["../../../src/common/tag/tag-constants.mts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAG1C,eAAO,MAAM,sBAAsB,UAElC,CAAC;AAEF,eAAO,MAAM,sBAAsB,UAElC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD;;GAEG;AACH,eAAO,MAAM,uBAAuB,4CAA4C,CAAC"}

package/dist/common/tag/tag-constants.mjs

@@ -23,6 +23,6 @@ export const DEFAULT_TAG_ICON = 'pricetag-outline';
  * Default description when creating a tag.
  */
 export const DEFAULT_TAG_DESCRIPTION = 'This is a tag used for organizing data.';
-export const TAG_TEXT_REGEXP = /^\w[\w .\-?!]{1,30}[\w.?!]$/;
-export const TAG_TEXT_REGEXP_DESCRIPTION = `tag text must start and end with an alphanumeric, and can contain a hyphen, question mark, dot or space.`;
+// export const TAG_TEXT_REGEXP = /^\w[\w .\-?!]{1,30}[\w.?!]$/;
+// export const TAG_TEXT_REGEXP_DESCRIPTION = `tag text must start and end with an alphanumeric, and can contain a hyphen, question mark, dot or space.`;
 //# sourceMappingURL=tag-constants.mjs.map

package/dist/common/tag/tag-constants.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tag-constants.mjs","sourceRoot":"","sources":["../../../src/common/tag/tag-constants.mts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,sDAAsD;AACtD,+DAA+D;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAG1C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,GAAG;CACN,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AACnD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,yCAAyC,CAAC;AAEjF,MAAM,CAAC,MAAM,eAAe,GAAG,6BAA6B,CAAC;AAC7D,MAAM,CAAC,MAAM,2BAA2B,GAAG,0GAA0G,CAAC"}
+{"version":3,"file":"tag-constants.mjs","sourceRoot":"","sources":["../../../src/common/tag/tag-constants.mts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,sDAAsD;AACtD,+DAA+D;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAG1C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,GAAG;CACN,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AACnD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,yCAAyC,CAAC;AAEjF,gEAAgE;AAChE,yJAAyJ"}

package/dist/common/tag/tag-helper.d.mts

@@ -0,0 +1,39 @@
+import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
+import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
+import { TagIbGib_V1 } from "./tag-types.mjs";
+import { MetaspaceService } from "../../witness/space/metaspace/metaspace-types.mjs";
+import { IbGibSpaceAny } from "../../witness/space/space-base-v1.mjs";
+/**
+ * relates an ibgib provided by {@link ibGib} or {@link addr} to the latest
+ * version of the given {@link tagIbGib}.
+ *
+ * persists this result in the same {@link space} and registers the newly
+ * created tag ibgib via the {@link metaspace}.
+ *
+ * @returns new tag ibgib that has the ibgib related to it
+ * @see {@link TAGGED_REL8N_NAME}
+ */
+export declare function rel8ToTag({ ibGib, addr, tagIbGib, metaspace, space, }: {
+    /**
+     * the ibgib that we're relating to the tag. can also provide just the
+     * {@link addr}.
+     */
+    ibGib?: IbGib_V1;
+    /**
+     * the ibgib addr that we're relating to the tag.
+     */
+    addr?: IbGibAddr;
+    /**
+     * the tag that we're relating to
+     */
+    tagIbGib: TagIbGib_V1;
+    /**
+     * it's meta
+     */
+    metaspace: MetaspaceService;
+    /**
+     * space in which the tag exists on the tags special ibgib index
+     */
+    space: IbGibSpaceAny;
+}): Promise<TagIbGib_V1>;
+//# sourceMappingURL=tag-helper.d.mts.map

package/dist/common/tag/tag-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-helper.d.mts","sourceRoot":"","sources":["../../../src/common/tag/tag-helper.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAK3D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAItE;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,KAAK,GACR,EAAE;IACC;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC;IACtB;;OAEG;IACH,SAAS,EAAE,gBAAgB,CAAC;IAC5B;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkCvB"}

package/dist/common/tag/tag-helper.mjs

@@ -0,0 +1,55 @@
+import { extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { getIbGibAddr } from "@ibgib/ts-gib/dist/helper.mjs";
+import { rel8 } from "@ibgib/ts-gib/dist/V1/transforms/rel8.mjs";
+import { GLOBAL_LOG_A_LOT } from "../../core-constants.mjs";
+import { TAGGED_REL8N_NAME } from "./tag-constants.mjs";
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * relates an ibgib provided by {@link ibGib} or {@link addr} to the latest
+ * version of the given {@link tagIbGib}.
+ *
+ * persists this result in the same {@link space} and registers the newly
+ * created tag ibgib via the {@link metaspace}.
+ *
+ * @returns new tag ibgib that has the ibgib related to it
+ * @see {@link TAGGED_REL8N_NAME}
+ */
+export async function rel8ToTag({ ibGib, addr, tagIbGib, metaspace, space, }) {
+    const lc = `[${rel8ToTag.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: b1fd25ec28bce8f1916b4ab55f48a724)`);
+        }
+        if (addr && ibGib && addr !== getIbGibAddr({ ibGib })) {
+            throw new Error(`both addr (${addr}) and ibGib (${getIbGibAddr({ ibGib })}) are provided but addr does not match addr of ibGib. (E: f2c14234a78c917fb9f587beaee89324)`);
+        }
+        if (!addr && !ibGib) {
+            throw new Error(`either addr or ibGib required (E: 3d580f8ecc251a0c81c7ea8bc3d38524)`);
+        }
+        addr ?? (addr = getIbGibAddr({ ibGib }));
+        const latestTagAddr = await metaspace.getLatestAddr({ addr, ibGib, space });
+        if (latestTagAddr !== getIbGibAddr({ ibGib: tagIbGib })) {
+            let resGetLatestTag = await metaspace.get({ addr: latestTagAddr, space });
+            if (!resGetLatestTag.success || resGetLatestTag.ibGibs?.length !== 1) {
+                throw new Error(`could not get latest tag (${latestTagAddr}) from space (${space.ib}). error: ${resGetLatestTag.errorMsg ?? '[unknown error (E: a4e31c98398b417db8f617f98a5f2741)]'} (E: 73c085d81efdab0e7b8939222ec07524)`);
+            }
+            tagIbGib = resGetLatestTag.ibGibs.at(0);
+        }
+        const rel8nsToAddByAddr = { [TAGGED_REL8N_NAME]: [addr] };
+        const resRel8ToTag = await rel8({ src: tagIbGib, rel8nsToAddByAddr, dna: true, nCounter: true });
+        const newTagIbGib = resRel8ToTag.newIbGib;
+        await metaspace.persistTransformResult({ resTransform: resRel8ToTag, space });
+        await metaspace.registerNewIbGib({ ibGib: newTagIbGib, space });
+        return newTagIbGib;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=tag-helper.mjs.map

package/dist/common/tag/tag-helper.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/core-gib",
-  "version": "0.0.89",
+  "version": "0.0.90",
   "description": "ibgib core functionality, including base architecture for witnesses, spaces, apps, robbots, etc., as well as shared utility functions. Node v19+ needed for heavily-used isomorphic webcrypto hashing consumed in both node and browsers.",
   "funding": {
     "type": "individual",

package/src/common/tag/tag-constants.mts

@@ -30,5 +30,5 @@ export const DEFAULT_TAG_ICON = 'pricetag-outline';
  */
 export const DEFAULT_TAG_DESCRIPTION = 'This is a tag used for organizing data.';
 
-export const TAG_TEXT_REGEXP = /^\w[\w .\-?!]{1,30}[\w.?!]$/;
-export const TAG_TEXT_REGEXP_DESCRIPTION = `tag text must start and end with an alphanumeric, and can contain a hyphen, question mark, dot or space.`;
+// export const TAG_TEXT_REGEXP = /^\w[\w .\-?!]{1,30}[\w.?!]$/;
+// export const TAG_TEXT_REGEXP_DESCRIPTION = `tag text must start and end with an alphanumeric, and can contain a hyphen, question mark, dot or space.`;

package/src/common/tag/tag-helper.mts

@@ -0,0 +1,87 @@
+import { extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
+import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
+import { getIbGibAddr } from "@ibgib/ts-gib/dist/helper.mjs";
+import { rel8 } from "@ibgib/ts-gib/dist/V1/transforms/rel8.mjs";
+
+import { GLOBAL_LOG_A_LOT } from "../../core-constants.mjs";
+import { TagIbGib_V1 } from "./tag-types.mjs";
+import { TAGGED_REL8N_NAME } from "./tag-constants.mjs";
+import { MetaspaceService } from "../../witness/space/metaspace/metaspace-types.mjs";
+import { IbGibSpaceAny } from "../../witness/space/space-base-v1.mjs";
+
+const logalot = GLOBAL_LOG_A_LOT;
+
+/**
+ * relates an ibgib provided by {@link ibGib} or {@link addr} to the latest
+ * version of the given {@link tagIbGib}.
+ *
+ * persists this result in the same {@link space} and registers the newly
+ * created tag ibgib via the {@link metaspace}.
+ *
+ * @returns new tag ibgib that has the ibgib related to it
+ * @see {@link TAGGED_REL8N_NAME}
+ */
+export async function rel8ToTag({
+    ibGib,
+    addr,
+    tagIbGib,
+    metaspace,
+    space,
+}: {
+    /**
+     * the ibgib that we're relating to the tag. can also provide just the
+     * {@link addr}.
+     */
+    ibGib?: IbGib_V1,
+    /**
+     * the ibgib addr that we're relating to the tag.
+     */
+    addr?: IbGibAddr,
+    /**
+     * the tag that we're relating to
+     */
+    tagIbGib: TagIbGib_V1,
+    /**
+     * it's meta
+     */
+    metaspace: MetaspaceService,
+    /**
+     * space in which the tag exists on the tags special ibgib index
+     */
+    space: IbGibSpaceAny,
+}): Promise<TagIbGib_V1> {
+    const lc = `[${rel8ToTag.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: b1fd25ec28bce8f1916b4ab55f48a724)`); }
+
+        if (addr && ibGib && addr !== getIbGibAddr({ ibGib })) { throw new Error(`both addr (${addr}) and ibGib (${getIbGibAddr({ ibGib })}) are provided but addr does not match addr of ibGib. (E: f2c14234a78c917fb9f587beaee89324)`); }
+
+        if (!addr && !ibGib) { throw new Error(`either addr or ibGib required (E: 3d580f8ecc251a0c81c7ea8bc3d38524)`); }
+        addr ??= getIbGibAddr({ ibGib });
+
+        const latestTagAddr = await metaspace.getLatestAddr({ addr, ibGib, space });
+        if (latestTagAddr !== getIbGibAddr({ ibGib: tagIbGib })) {
+            let resGetLatestTag = await metaspace.get({ addr: latestTagAddr, space });
+            if (!resGetLatestTag.success || resGetLatestTag.ibGibs?.length !== 1) {
+                throw new Error(`could not get latest tag (${latestTagAddr}) from space (${space.ib}). error: ${resGetLatestTag.errorMsg ?? '[unknown error (E: a4e31c98398b417db8f617f98a5f2741)]'} (E: 73c085d81efdab0e7b8939222ec07524)`);
+            }
+            tagIbGib = resGetLatestTag.ibGibs!.at(0)! as TagIbGib_V1;
+        }
+
+        const rel8nsToAddByAddr = { [TAGGED_REL8N_NAME]: [addr] };
+        const resRel8ToTag =
+            await rel8({ src: tagIbGib, rel8nsToAddByAddr, dna: true, nCounter: true });
+        const newTagIbGib = resRel8ToTag.newIbGib as TagIbGib_V1;
+
+        await metaspace.persistTransformResult({ resTransform: resRel8ToTag, space });
+        await metaspace.registerNewIbGib({ ibGib: newTagIbGib, space });
+
+        return newTagIbGib;
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
+    }
+}