@ibgib/core-gib 0.0.4

package/.vscode/core-gib-snippets.code-snippets

@@ -0,0 +1,189 @@
+{
+	// Place your ionic-gib workspace snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and
+	// description. Add comma separated ids of the languages where the snippet is applicable in the scope field. If scope
+	// is left empty or omitted, the snippet gets applied to all languages. The prefix is what is
+	// used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
+	// $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders.
+	// Placeholders with the same ids are connected.
+	// Example:
+	// "Print to console": {
+	//     "scope": "javascript,typescript",
+	//     "prefix": "log",
+	//     "body": [
+	//         "console.log('$1');",
+	//         "$2"
+	//     ],
+	//     "description": "Log output to console"
+	// }
+	"lc try..catch rethrow": {
+		"scope": "javascript,typescript",
+		"prefix": "lc_trycatch_rethrow",
+		"body": [
+			"const lc = `\\${this.lc}[\\${this.$1.name}]`;",
+			"try {",
+			"\t$SELECTION$0",
+			"} catch (error) {",
+			"\tconsole.error(`\\${lc} \\${error.message}`);",
+			"\tthrow error;",
+			"}"
+		],
+	},
+	"lc try..catch..finally rethrow": {
+		"scope": "javascript,typescript",
+		"prefix": "lc_trycatchfinally_rethrow",
+		"body": [
+			"const lc = `\\${this.lc}[\\${this.$1.name}]`;",
+			"try {",
+			"\t$SELECTION$0",
+			"} catch (error) {",
+			"\tconsole.error(`\\${lc} \\${error.message}`);",
+			"\tthrow error;",
+			"} finally {",
+			"\t$2",
+			"}"
+		],
+	},
+	"lc try..catch..finally rethrow with logging": {
+		"scope": "javascript,typescript",
+		"prefix": "lc_trycatchfinally_rethrow_withlogging",
+		"body": [
+			"const lc = `\\${this.lc}[\\${this.$1.name}]`;",
+			"try {",
+			"\tif (logalot) { console.log(`\\${lc} starting... (I: $RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$CURRENT_YEAR_SHORT)`); }",
+			"\t$SELECTION$0",
+			"} catch (error) {",
+			"\tconsole.error(`\\${lc} \\${error.message}`);",
+			"\tthrow error;",
+			"} finally {",
+			"\tif (logalot) { console.log(`\\${lc} complete.`); }",
+			"}"
+		],
+	},
+	"func async lc try..catch rethrow": {
+		"scope": "javascript,typescript",
+		"prefix": "func_lc_trycatch_rethrow",
+		"body": [
+			"${1:export async function} ${2:fnName}({",
+			"\t$3,",
+			"}: {",
+			"\t$3: $4,",
+			"}): Promise<$5> {",
+			"\tconst lc = `\\${this.lc}[\\${this.$2.name}]`;",
+			"\ttry {",
+			"\t\t$SELECTION$0",
+			"\t} catch (error) {",
+			"\t\tconsole.error(`\\${lc} \\${error.message}`);",
+			"\t\tthrow error;",
+			"\t}",
+			"}"
+		],
+	},
+	"func async lc try..catch..finally rethrow": {
+		"scope": "javascript,typescript",
+		"prefix": "func_lc_trycatchfinally_rethrow",
+		"body": [
+			"${1:export async function} ${2:fnName}({",
+			"\t$3,",
+			"}: {",
+			"\t$3: $4,",
+			"}): Promise<$5> {",
+			"\tconst lc = `\\${this.lc}[\\${this.$2.name}]`;",
+			"\ttry {",
+			"\t\t$SELECTION$0",
+			"\t} catch (error) {",
+			"\t\tconsole.error(`\\${lc} \\${error.message}`);",
+			"\t\tthrow error;",
+			"\t} finally {",
+			"\t\t$6",
+			"\t}",
+			"}"
+		],
+	},
+	"func async lc try..catch..finally rethrow with logging": {
+		"scope": "javascript,typescript",
+		"prefix": "func_lc_trycatchfinally_rethrow_withlogging",
+		"body": [
+			"${1:export async function} ${2:fnName}({",
+			"\t$3,",
+			"}: {",
+			"\t$3: $4,",
+			"}): Promise<$5> {",
+			"\tconst lc = `\\${this.lc}[\\${this.$2.name}]`;",
+			"\ttry {",
+			"\t\tif (logalot) { console.log(`\\${lc} starting... (I: $RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$CURRENT_YEAR_SHORT)`); }",
+			"\t\t$SELECTION$0",
+			"\t} catch (error) {",
+			"\t\tconsole.error(`\\${lc} \\${error.message}`);",
+			"\t\tthrow error;",
+			"\t} finally {",
+			"\t\tif (logalot) { console.log(`\\${lc} complete.`); }",
+			"\t}",
+			"}"
+		],
+	},
+	"throw new error with guid": {
+		"scope": "javascript,typescript",
+		"prefix": "throw_new_error_with_guid",
+		"body": [
+			"$0throw new Error(`$1 (E: $RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$CURRENT_YEAR_SHORT)`); "
+		],
+	},
+	"if..throw with guid": {
+		"scope": "javascript,typescript",
+		"prefix": "if_throw_with_guid",
+		"body": [
+			"$0if ($1) { throw new Error(`$2 (E: $RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$CURRENT_YEAR_SHORT)`); }"
+		],
+	},
+	"if logalot log": {
+		"scope": "javascript,typescript",
+		"prefix": "if_logalot_log",
+		"body": [
+			"$0if (logalot$1) { console.${2:log}(`\\${lc} $3 (I: $RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$CURRENT_YEAR_SHORT)`); }"
+		],
+	},
+	"surround log if logalot log": {
+		"scope": "javascript,typescript",
+		"prefix": "surround_log_if_logalot",
+		"body": [
+			"if (logalot) { $SELECTION }"
+		],
+	},
+	"surround if logalot timer console time-timeEnd": {
+		"scope": "javascript,typescript",
+		"prefix": "surround_if_logalot_timer_console_time_timeend",
+		"body": [
+			"let timerName: string;",
+			"const timerEnabled = true",
+			"if (logalot && timerEnabled) {",
+			"\ttimerName = lc.substring(0, ${1:24}) + '[timer $RANDOM_HEX]';",
+			"\tconsole.log(`\\${timerName} starting... (I: $RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$RANDOM_HEX$CURRENT_YEAR_SHORT)`);",
+			"\tconsole.time(timerName);",
+			"}",
+			"// can intersperse with calls to console.timeLog for intermediate times",
+			"// if (logalot) { console.timeLog(timerName); }",
+			"",
+			"$0$SELECTION",
+			"",
+			"if (logalot && timerEnabled) {",
+			"\tconsole.timeEnd(timerName);",
+			"\tconsole.log(`\\${timerName} complete.`);",
+			"}",
+		],
+	},
+	"if logalot global ibgib timer": {
+		"scope": "javascript,typescript",
+		"prefix": "if_logalot_ibgib_timer",
+		"body": [
+			"if (logalot) { console.log(`\\${lc}\\${GLOBAL_TIMER_NAME}`); console.timeLog(GLOBAL_TIMER_NAME); }$0"
+		],
+	},
+	"return early": {
+		"scope": "javascript,typescript",
+		"prefix": "return_early",
+		"description": "I like to indicate returning early in a function in a comment, so it's more obvious in the editor if I'm scanning for comments.",
+		"body": [
+			"return$1; /* <<<< returns early */$0",
+		],
+	},
+}

package/.vscode/launch.json

@@ -0,0 +1,24 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "npm debug",
+            "runtimeExecutable": "npm",
+            "runtimeArgs": [
+                "run",
+                "debug",
+            ],
+            "port": 9229,
+            "sourceMaps": true,
+            "skipFiles": [
+                "<node_internals>/**"
+            ]
+        },
+
+    ]
+}

package/.vscode/settings.json

@@ -0,0 +1,56 @@
+{
+    "typescript.tsdk": "node_modules/typescript/lib",
+    "search.exclude": {
+        "**/*.BAK": true,
+        "**/*.bak": true,
+        "**/dist": true
+    },
+    "files.watcherExclude": {
+        "**/*.BAK": true,
+        "**/*.bak": true
+    },
+    "editor.formatOnSave": true,
+    "files.insertFinalNewline": true,
+    "files.trimFinalNewlines": true,
+    "debug.node.autoAttach": "on",
+    "files.trimTrailingWhitespace": true,
+    "workbench.colorTheme": "Kimbie Dark",
+    "workbench.colorCustomizations": {
+        "editor.background": "#08143c",
+        "sideBar.background": "#0e1a42",
+        "editor.lineHighlightBackground": "#00ff2f18",
+        "activityBar.activeBackground": "#3333ff",
+        "activityBar.background": "#3333ff",
+        "activityBar.foreground": "#e7e7e7",
+        "activityBar.inactiveForeground": "#e7e7e799",
+        "activityBarBadge.background": "#600000",
+        "activityBarBadge.foreground": "#e7e7e7",
+        "commandCenter.border": "#e7e7e799",
+        "sash.hoverBorder": "#3333ff",
+        "statusBar.background": "#0000ff",
+        "statusBar.foreground": "#e7e7e7",
+        "statusBarItem.hoverBackground": "#3333ff",
+        "statusBarItem.remoteBackground": "#0000ff",
+        "statusBarItem.remoteForeground": "#e7e7e7",
+        "titleBar.activeBackground": "#0000ff",
+        "titleBar.activeForeground": "#e7e7e7",
+        "titleBar.inactiveBackground": "#0000ff99",
+        "titleBar.inactiveForeground": "#e7e7e799"
+    },
+    "editor.tokenColorCustomizations": {
+        "[Kimbie Dark]": {
+            "variables": "#c77a22",
+            "comments": "#fffb128c",
+            "textMateRules": [
+                {
+                    "name": "Lists",
+                    "scope": "markup.list",
+                    "settings": {
+                        "foreground": "#cb76d6"
+                    }
+                },
+            ],
+        }
+    },
+    "peacock.color": "blue"
+}

package/.vscode/tasks.json

@@ -0,0 +1,37 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=733558
+    // for the documentation about the tasks.json format
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "type": "npm",
+            "script": "build",
+            "group": "build",
+            "problemMatcher": []
+        },
+        {
+            "type": "npm",
+            "script": "test",
+            "group": "build",
+            "problemMatcher": []
+        },
+        {
+            "type": "npm",
+            "script": "clean",
+            "group": "build",
+            "problemMatcher": []
+        },
+        {
+            "type": "npm",
+            "script": "build:test",
+            "group": "build",
+            "problemMatcher": []
+        },
+        {
+            "type": "npm",
+            "script": "prepare:publish",
+            "group": "build",
+            "problemMatcher": []
+        }
+    ],
+}

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+## 0.0.1
+* getting basic folder structure going
+  * working mostly off of the existing ts-gib (v0.4.1)
+  * removed mocha
+  * trying out solutions for unit testing in both node and browser.
+    * spaces should be executing in both contexts.
+    * jasmine seems to be working atm for node.
+      * trying just jasmine because it "should" be able to work even
+        without using karma as the test runner.
+      * i only need rudimentary headless running at the space level (this lib)
+        because i'm not actually doing an app here.

package/README.md

@@ -0,0 +1,215 @@
+# 🚧 wip.
+
+I am working towards creating the fundamental es module package structure before
+pulling out behavior from the [ionic-gib](https://github.com/wraiford/ibgib/tree/v0.2.729/ionic-gib) project into this lib. so this is just a
+shell right now.
+
+# forward
+
+I have created a working MVP for ibgib that shows some of the potential for the
+architecture:
+
+* try it out
+  * https://ibgib.space
+* pre-refactored MVP codebase on GitHub
+  * `ionic-gib`: https://github.com/wraiford/ibgib/tree/v0.2.729/ionic-gib
+  * "pre-refactored" = doesn't use this core-gib lib, but rather is the
+    springboard/"carcass" for it.
+* base ibgib protocol graphing substrate lib on GitLab
+  * `ts-gib`: https://gitlab.com/ibgib/ts-gib/-/tree/master
+
+# core-gib
+
+`core-gib` is the intermediate ibgib substrate that provides functionality for basic ibgib interactions.
+
+This includes plumbing for the following primary areas:
+
+* witnesses
+* spaces
+* apps
+* robbots
+
+_note: many of these could technically be its own library, but at the very least for now these will stay within this core library until it seems they should be broken out._
+
+This sits on top of the lowest level `ts-gib` library, which provides the very basic
+primitives used in the mechanics of ibgib graphing.
+
+## witnesses
+
+An ibgib "witness" is the lowest level of ibgib in code that provides behavior
+that is associated with its ibgib data. It is so called because it's meant to
+convey to us that an ibgib is not some impartial, absolute function but rather
+_always has a POV_. It is like if you take a function and abstract away
+specifics of how it gets its information (be it on a stack, heap, at a local RAM
+location address, etc.)
+
+So in short, a witness is a distributed computation metaversal function, but
+personified in order to remind each of us of anything's fallibility (including
+computer functions).
+
+### witness in code
+
+With this in mind, let's look at the witness interface definitions in
+TypeScript, with generic types and comments removed for clarity.
+
+```typescript
+export interface IbGib {
+    ib: Ib;    // string
+    gib?: Gib; // string
+}
+
+export interface IbGibWithDataAndRel8ns<...> extends IbGib {
+    data?: TData;     // object/map of string->any
+    rel8ns?: TRel8ns; // map of string->string[]
+}
+
+export interface Witness<...> extends IbGibWithDataAndRel8ns<...> {
+    witness(arg: TIbGibIn): Promise<TIbGibOut | undefined>;
+}
+```
+
+This last `Witness` interface has a single member: the `witness` function. This
+accepts a single ibgib arg and returns a single ibgib arg. Since each ibgib is
+content addressed (*1), this allows for a function addressing scheme that
+effectively works in an infinite addressing space.
+
+Considering this, the ibgib + witness design can be thought of as a superset of
+all programming languages with `witness` ibgib acting similar to how we think of
+functions. So inter-witness communications are at the extreme of functional
+programming. Or said another way it can describe any programming language. But
+when it comes to execution, adding the isomorphic transformation into the ibgib
+description space would necessarily add overhead and most likely create
+unfeasible execution times (until computation power vastly improves relative to
+our current POV in time). Or in short, it would be NECESSARILY SLOWER, to the
+point of local impracticality.
+
+Still, it's important to think each witness as a universally addressed function,
+and each space as a special case witness whose job is colocation.
+
+[*1] primitives and other ibgibs without a gib hash, like "6^gib" or "hello^gib", are still "content addressed", it's simply the value is the address itself.
+
+## spaces
+
+So a "witness" is an ibgib with behavior, i.e. doesn't just have data. A "space"
+is one kind of witness. Its primary job is to collocate ibgib.
+
+_nuance: The implementation of "collocation" is not concrete and can be decided by - and vary wildly by - the implementing class._
+
+### types of spaces
+
+Ideally all spaces are to be considered equally, with the idea being that you
+"simply" treat them as buckets of data. As such, we can think of them like a
+bucket or a repo with just a couple capabilities: `get`, `put`, etc.
+
+But when dealing with the process of living, temporal data dynamics, we must
+consider one key aspect of data: **perspective**, i.e. POV. As such, there are
+necessarily(?) three "types" of space with respect to POV:
+
+1. local space
+2. outer space
+3. inner space
+
+These are currently implemented in the ionic-gib MVP as follows:
+
+1. local space
+  * implemented with [`IonicSpace_V1`](https://github.com/wraiford/ibgib/blob/ed2d09c411dfdbc916e7841f1a0ccb6b559c303a/ionic-gib/src/app/common/witnesses/spaces/ionic-space-v1.ts)
+  * uses [capacitor filesystem api (v4)](https://capacitorjs.com/docs/apis/filesystem)
+    as indexeddb substrate
+2. outer space
+  * implemented with [`AWSDynamoSpace_V1`](https://github.com/wraiford/ibgib/blob/ed2d09c411dfdbc916e7841f1a0ccb6b559c303a/ionic-gib/src/app/common/witnesses/spaces/aws-dynamo-space-v1.ts#L854)
+  * this is implemented as a "merge" space, in that when ibgibs are "put" into
+    the space, timelines are dynamically merged using a CRDT-like merging
+    algorithm that applies unapplied DNA transforms
+  * uses DynamoDB for most ibgib data stored as four string fields ([max string size of 400 KB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ServiceQuotas.html))
+  * uses S3 for larger ibgibs with DynamoDB entries that indicate S3 storage
+3. inner space
+  * the [InnerSpace_V1](https://github.com/wraiford/ibgib/blob/ed2d09c411dfdbc916e7841f1a0ccb6b559c303a/ionic-gib/src/app/common/witnesses/spaces/inner-space-v1.ts) is not used or tested
+  * it is only sketched
+  * better composeability will be required for inner spaces to be utilized
+
+## witnesses, and thus spaces, as universally addressed functions
+
+If you think of a function in a programming language, it has a couple of characteristics:
+
+* has an address
+* has at least one parameter, which ultimately has an an address (either in the stack/heap or a pointer to memory)
+* returns 0-1+ data structures
+
+
+## spaces related to witnesses
+
+## testing
+
+### importmaps - `npm run test:browser` fails
+
+as a workaround for bleeding edge ES module consumption (let alone testing
+frameworks for them), I have kluged a workaround by editing
+`/node_modules/jasmine-browser-runner/run.html.ejs` to include an import map
+section. So atow paste the following code before any other `script` tags in the
+`head` section.  (the versions may need to change):
+
+
+_note: atow I am copy/pasting this text whenever I reinstall `node_modules` folder._
+
+_note: if you are having CORS issues, it may be due to the cdn being down._
+
+
+using **unpkg**:
+
+```html
+  <script type="importmap">
+    {
+      "imports": {
+        "@ibgib/helper-gib": "https://unpkg.com/@ibgib/helper-gib@0.0.4/dist/index.mjs",
+        "@ibgib/helper-gib/": "https://unpkg.com/@ibgib/helper-gib@0.0.4/"
+      }
+    }
+  </script>
+```
+
+**using jsdelivr.net**:
+
+```html
+  <script type="importmap">
+    {
+      "imports": {
+        "@ibgib/helper-gib": "https://cdn.jsdelivr.net/npm/@ibgib/helper-gib@0.0.4/dist/index.mjs",
+        "@ibgib/helper-gib/": "https://cdn.jsdelivr.net/npm/@ibgib/helper-gib@0.0.4/"
+      }
+    }
+  </script>
+```
+
+
+# carcass related
+
+## find and replace patterns
+
+### remove constants scoping
+
+import \* as c from .+
+
+### scoped ts-gib for helper first
+
+(import .+')ts-gib(.*helper)';
+$1@ibgib/ts-gib$2.mjs';
+
+### scoped ts-gib for non-helper next
+
+(import .+')ts-gib(.*)';
+$1@ibgib/ts-gib$2';
+
+### non-mjs suffixed imports
+
+(from '.+[\w\/]\w\w\w)'
+$1.mjs'
+
+### add index.mjs explicit to folder imports
+
+(from '.+/V1)'
+$1/index.mjs'
+
+### convert cast to use `as` operator
+
+(<)(\w+)(>)([\w.!\?]+)(\W)
+($4 as $2)$5

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

@@ -0,0 +1,7 @@
+export {};
+/**
+ * @module aws-constants
+ *
+ * this is to be moved into the aws-dynamodb-sync-space-gib lib.
+ */
+//# sourceMappingURL=aws-constants.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aws-constants.d.mts","sourceRoot":"","sources":["../../src/common/aws-constants.mts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/common/aws-constants.mjs

@@ -0,0 +1,7 @@
+export {};
+/**
+ * @module aws-constants
+ *
+ * this is to be moved into the aws-dynamodb-sync-space-gib lib.
+ */
+//# sourceMappingURL=aws-constants.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aws-constants.mjs","sourceRoot":"","sources":["../../src/common/aws-constants.mts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/common/bin/bin-types.d.mts

@@ -0,0 +1,17 @@
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
+/**
+ * For pic binaries, this is a base 64 encoded string of the pic's image data.
+
+ * @see {@link BinIbGib_V1}
+ */
+export type BinData_V1 = any;
+/**
+ * IbGib for a binary, which right now atow just means a pic.
+ *
+ * Also for now, BinIbGib has no rel8ns, only data.
+ *
+ * @see {@link BinData_V1}
+ */
+export interface BinIbGib_V1 extends IbGib_V1<any> {
+}
+//# sourceMappingURL=bin-types.d.mts.map

package/dist/common/bin/bin-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin-types.d.mts","sourceRoot":"","sources":["../../../src/common/bin/bin-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAAC,GAAG,CAAC;CAAI"}

package/dist/common/bin/bin-types.mjs

@@ -0,0 +1,3 @@
+;
+export {};
+//# sourceMappingURL=bin-types.mjs.map

package/dist/common/bin/bin-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin-types.mjs","sourceRoot":"","sources":["../../../src/common/bin/bin-types.mts"],"names":[],"mappings":"AAgBsD,CAAC"}

package/dist/common/cache/cache-types.d.mts

@@ -0,0 +1,57 @@
+import { IbGibAddr } from '@ibgib/ts-gib';
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
+export interface IbGibCacheInfo {
+    /**
+     * The "primary key" of the cache info. If {@link addrScope} is not provided,
+     * then atow this will be the only location information for the ibGib.
+     */
+    addr: IbGibAddr;
+    /**
+     * If provided, this will be used to identify the cache info in combination
+     * with the addr. Else, just the addr will be used.
+     *
+     * So, e.g., you may store an ibGib item by
+     * @example { addr: comment abc^123, addrScope: 'item', ibGib, other: item }
+     */
+    addrScope?: string;
+    /**
+     * ibGib reference.
+     */
+    ibGib: IbGib_V1;
+    /**
+     * Place to store additional associated cached data with the ibGib.
+     *
+     * ## driving use case
+     *
+     * I want to cache the entire IbGibItem for many IbGibComponentBase classes to
+     * speed up the entire loading (not just the loading of the ibGib property
+     * itself from storage).
+     *
+     * atow I'm storing a separate entry with addr + this.lc for using this other
+     * property.
+     */
+    other?: any;
+    tjpAddr?: IbGibAddr;
+    tjpIbGib?: IbGib_V1;
+}
+/**
+ * Using this for a quick implementation for caching.
+ *
+ * ## future
+ *
+ * change this to an ibgib (in memory) innerspace. then we can pass in
+ * the innerspace ibgib instead of just setting a property. this will make
+ * it more extensible in the future (i think...)
+ */
+export interface IbGibCacheService {
+    has({ addr, addrScope }: {
+        addr: IbGibAddr;
+        addrScope?: string;
+    }): Promise<boolean>;
+    put(info: IbGibCacheInfo): Promise<void>;
+    get({ addr, addrScope }: {
+        addr: IbGibAddr;
+        addrScope?: string;
+    }): Promise<IbGibCacheInfo | undefined>;
+}
+//# sourceMappingURL=cache-types.d.mts.map

package/dist/common/cache/cache-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-types.d.mts","sourceRoot":"","sources":["../../../src/common/cache/cache-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAM,MAAM,iCAAiC,CAAC;AAG/D,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,QAAQ,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CACxG"}

package/dist/common/cache/cache-types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cache-types.mjs.map

package/dist/common/cache/cache-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-types.mjs","sourceRoot":"","sources":["../../../src/common/cache/cache-types.mts"],"names":[],"mappings":""}

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

@@ -0,0 +1,11 @@
+/**
+ * comment ibs atow are comment [commentText substring]
+ */
+export declare const DEFAULT_COMMENT_TEXT_IB_SUBSTRING_LENGTH = 20;
+/**
+ * comment ib can have additional metadata string,
+ *
+ * @example "comment thisisacomm here_is_addl_metadata"
+ */
+export declare const DEFAULT_COMMENT_METADATA_IB_SUBSTRING_LENGTH = 64;
+//# sourceMappingURL=comment-constants.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comment-constants.d.mts","sourceRoot":"","sources":["../../../src/common/comment/comment-constants.mts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,wCAAwC,KAAK,CAAC;AAC3D;;;;GAIG;AACH,eAAO,MAAM,4CAA4C,KAAK,CAAC"}