@ibgib/core-gib 0.0.8 → 0.0.11

package/src/witness/robbot/robbot-helper.mts

@@ -97,11 +97,11 @@ export async function validateCommonRobbotIbGib({
 }): Promise<string[] | undefined> {
     const lc = `[${validateCommonRobbotIbGib.name}]`;
     try {
+        if (logalot) { console.log(`${lc} starting... (I: f7b34d791a483b8c5a9d188da66d3f22)`); }
         const intrinsicErrors: string[] = await validateIbGibIntrinsically({ ibGib: robbotIbGib }) ?? [];
 
         if (!robbotIbGib.data) { throw new Error(`robbotIbGib.data required (E: 754a8d2540610696aff04b0d159daa23)`); }
         const ibErrors: string[] = [];
-        if (logalot) { console.log(`${lc} starting... (I: f7b34d791a483b8c5a9d188da66d3f22)`); }
         let { robbotClassname, robbotName, robbotId } = parseRobbotIb({ robbotIb: robbotIbGib.ib });
         if (!robbotClassname) { ibErrors.push(`robbotClassname required (E: 3234d39bf1c74ec3aff59f374282dfc8)`); }
         if (!robbotName) { ibErrors.push(`robbotName required (E: b329dcc62ff548d7aa0681393b2c7057)`); }

package/src/witness/robbot/{robbot-helper.spec.mts → robbot-helper.respec.mts}

@@ -1,3 +1,9 @@
+import {
+    firstOfEach, firstOfAll, ifWe,
+    lastOfEach, lastOfAll,
+    ifWeMight, iReckon, respecfully
+} from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+const maam = `[${import.meta.url}]`, sir = maam;
 // import { getIbAndGib } from '@ibgib/ts-gib';
 // import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
 // import { getGibInfo } from 'ts-gib/dist/V1/transforms/transform-helper';
@@ -10,9 +16,9 @@
 import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
 import { getSpaceDelimitedSaferRequestText } from "./robbot-helper.mjs";
 
-describe('getRequestTextFromComment', () => {
+await respecfully(sir, 'getRequestTextFromComment', async () => {
 
-    it('should get request text with single-char escape', () => {
+    await ifWe(sir, 'should get request text with single-char escape', () => {
         ['?', '??', '/', '/esc'].forEach(escape => {
             ['help', 'hi',].forEach(requestText => {
                 const text = escape + requestText;
@@ -23,7 +29,7 @@ describe('getRequestTextFromComment', () => {
                     data: { text }
                 }
                 const resRequestText = getSpaceDelimitedSaferRequestText({ ibGib, requestEscapeString: escape });
-                expect(resRequestText).toEqual(requestText);
+                iReckon(sir, resRequestText).isGonnaBe(requestText);
             });
         });
     });
@@ -31,7 +37,7 @@ describe('getRequestTextFromComment', () => {
 
 
 
-// describe('RobbotSessionIb', () => {
+// await respecfully(sir, 'RobbotSessionIb', () => {
 
 //     // one big test because jasmine unfortunately makes you declare variables
 //     // multiple times to get async working, which doesn't scale, so it's a bad
@@ -58,12 +64,12 @@ describe('getRequestTextFromComment', () => {
 //             contextTjpGib: commentGibInfo.tjpGib,
 //             sessionId,
 //         });
-//         expect(ib).toBeTruthy();
-//         expect(ib.startsWith(ROBBOT_SESSION_ATOM)).toBe(true, `doesnt start with robbot session atom. (${ib})`);
-//         expect(ib.match(timestampInTicks)).toBeTruthy(`timestampInTicks not included. (${ib}\n${timestampInTicks})`);
-//         expect(ib.match(sessionId)).toBeTruthy(`sessionId.\nib: ${ib}\nsessionId: ${sessionId}`);
-//         expect(ib.match(robbot.data.name)).toBeTruthy('robbot name');
-//         expect(ib.match(robbot.data.uuid)).toBeTruthy('robbot uuid');
+//         expect(ib).isGonnaBeTruthy();
+//         expect(ib.startsWith(ROBBOT_SESSION_ATOM)).isGonnaBe(true, `doesnt start with robbot session atom. (${ib})`);
+//         expect(ib.match(timestampInTicks)).isGonnaBeTruthy(`timestampInTicks not included. (${ib}\n${timestampInTicks})`);
+//         expect(ib.match(sessionId)).isGonnaBeTruthy(`sessionId.\nib: ${ib}\nsessionId: ${sessionId}`);
+//         expect(ib.match(robbot.data.name)).isGonnaBeTruthy('robbot name');
+//         expect(ib.match(robbot.data.uuid)).isGonnaBeTruthy('robbot uuid');
 
 //         let { timestamp, robbotName,
 //             robbotClassname, robbotId, robbotTjpGib,
@@ -71,14 +77,14 @@ describe('getRequestTextFromComment', () => {
 //             addlMetadata: addlMetadata_Out
 //         } = parseRobbotSessionIb({ ib });
 
-//         expect(timestamp).toBe(timestampInTicks, 'timestampInTicks');
-//         expect(robbotName).toBe(robbot.data.name, 'robbot name');
-//         expect(robbotClassname).toBe(robbot.data.classname, 'robbot classname');
-//         expect(robbotId).toBe(robbot.data.uuid, 'robbot uuid');
-//         expect(robbotTjpGib).toBe(getGibInfo({ gib: robbot.gib }).tjpGib, 'robbot tjpgib');
-//         expect(sessionId_Out).toBe(sessionId, 'sessionId');
-//         expect(contextTjpGib).toBe(getGibInfo({ gib: commentIbGib.gib }).tjpGib, 'contextTjpGib');
-//         expect(addlMetadata_Out).toBe(undefined, 'addlMetadata');
+//         expect(timestamp).isGonnaBe(timestampInTicks, 'timestampInTicks');
+//         expect(robbotName).isGonnaBe(robbot.data.name, 'robbot name');
+//         expect(robbotClassname).isGonnaBe(robbot.data.classname, 'robbot classname');
+//         expect(robbotId).isGonnaBe(robbot.data.uuid, 'robbot uuid');
+//         expect(robbotTjpGib).isGonnaBe(getGibInfo({ gib: robbot.gib }).tjpGib, 'robbot tjpgib');
+//         expect(sessionId_Out).isGonnaBe(sessionId, 'sessionId');
+//         expect(contextTjpGib).isGonnaBe(getGibInfo({ gib: commentIbGib.gib }).tjpGib, 'contextTjpGib');
+//         expect(addlMetadata_Out).isGonnaBe(undefined, 'addlMetadata');
 
 //         // #endregion get/parse normal, no metadata
 
@@ -92,13 +98,13 @@ describe('getRequestTextFromComment', () => {
 //             addlMetadata,
 //         });
 
-//         expect(ib).toBeTruthy();
-//         expect(ib.startsWith(ROBBOT_SESSION_ATOM)).toBe(true, `2 doesnt start with robbot session atom. (${ib})`);
-//         expect(ib.match(timestampInTicks)).toBeTruthy(`2 timestampInTicks not included. (${ib}\n${timestampInTicks})`);
-//         expect(ib.match(sessionId)).toBeTruthy(`2 sessionId.\nib: ${ib}\nsessionId: ${sessionId}`);
-//         expect(ib.match(robbot.data.name)).toBeTruthy('2 robbot name');
-//         expect(ib.match(robbot.data.uuid)).toBeTruthy('2 robbot uuid');
-//         expect(ib.match(addlMetadata)).toBeTruthy('addlMetadata');
+//         expect(ib).isGonnaBeTruthy();
+//         expect(ib.startsWith(ROBBOT_SESSION_ATOM)).isGonnaBe(true, `2 doesnt start with robbot session atom. (${ib})`);
+//         expect(ib.match(timestampInTicks)).isGonnaBeTruthy(`2 timestampInTicks not included. (${ib}\n${timestampInTicks})`);
+//         expect(ib.match(sessionId)).isGonnaBeTruthy(`2 sessionId.\nib: ${ib}\nsessionId: ${sessionId}`);
+//         expect(ib.match(robbot.data.name)).isGonnaBeTruthy('2 robbot name');
+//         expect(ib.match(robbot.data.uuid)).isGonnaBeTruthy('2 robbot uuid');
+//         expect(ib.match(addlMetadata)).isGonnaBeTruthy('addlMetadata');
 
 //         // thanks https://flaviocopes.com/javascript-destructure-object-to-existing-variable/
 //         ({
@@ -107,14 +113,14 @@ describe('getRequestTextFromComment', () => {
 //             sessionId: sessionId_Out, contextTjpGib, addlMetadata: addlMetadata_Out
 //         } = parseRobbotSessionIb({ ib }));
 
-//         expect(timestamp).toBe(timestampInTicks, '2 timestampInTicks');
-//         expect(robbotName).toBe(robbot.data.name, '2 robbot name');
-//         expect(robbotClassname).toBe(robbot.data.classname, '2 robbot classname');
-//         expect(robbotId).toBe(robbot.data.uuid, '2 robbot uuid');
-//         expect(robbotTjpGib).toBe(getGibInfo({ gib: robbot.gib }).tjpGib, '2 robbot tjpgib');
-//         expect(sessionId_Out).toBe(sessionId, '2 sessionId');
-//         expect(contextTjpGib).toBe(getGibInfo({ gib: commentIbGib.gib }).tjpGib, '2 contextTjpGib');
-//         expect(addlMetadata_Out).toBe(addlMetadata, 'addlMetadata');
+//         expect(timestamp).isGonnaBe(timestampInTicks, '2 timestampInTicks');
+//         expect(robbotName).isGonnaBe(robbot.data.name, '2 robbot name');
+//         expect(robbotClassname).isGonnaBe(robbot.data.classname, '2 robbot classname');
+//         expect(robbotId).isGonnaBe(robbot.data.uuid, '2 robbot uuid');
+//         expect(robbotTjpGib).isGonnaBe(getGibInfo({ gib: robbot.gib }).tjpGib, '2 robbot tjpgib');
+//         expect(sessionId_Out).isGonnaBe(sessionId, '2 sessionId');
+//         expect(contextTjpGib).isGonnaBe(getGibInfo({ gib: commentIbGib.gib }).tjpGib, '2 contextTjpGib');
+//         expect(addlMetadata_Out).isGonnaBe(addlMetadata, 'addlMetadata');
 
 //         // #endregion with addl metadata
 

package/src/witness/robbot/robbot-types.mts

@@ -5,17 +5,18 @@ import { IbGibData_V1, IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/in
 
 import {
     WitnessData_V1, WitnessRel8ns_V1,
-    WitnessCmdData, WitnessCmdRel8ns, WitnessCmdIbGib,
     WitnessResultData, WitnessResultRel8ns, WitnessResultIbGib,
 } from '../witness-types.mjs';
 import { CommentIbGib_V1 } from '../../common/comment/comment-types.mjs';
 import { ROBBOT_TAG_TJP_ADDRS_REL8N_NAME } from './robbot-constants.mjs';
 import { IbGibRobbotAny } from './robbot-base-v1.mjs';
+import { WitnessWithContextData_V1, WitnessWithContextRel8ns_V1 } from '../witness-with-context/witness-with-context-types.mjs';
+import { WitnessCmdData, WitnessCmdRel8ns, WitnessCmdIbGib, } from '../witness-cmd/witness-cmd-types.mjs';
 
 
 export type RobbotTransparency = 'transparent' | 'translucent' | 'opaque';
 
-export interface RobbotData_V1 extends WitnessData_V1 {
+export interface RobbotData_V1 extends WitnessWithContextData_V1 {
 
     /**
      * Name of a Robbot instance...after all, Robbie was only the first Robbot.
@@ -172,7 +173,7 @@ export const DEFAULT_ROBBOT_REQUEST_MAX_LENGTH = 100;
 // }
 // export const VALID_ROBBOT_OUTPUT_MODES = Object.values(RobbotOutputMode);
 
-export interface RobbotRel8ns_V1 extends WitnessRel8ns_V1 {
+export interface RobbotRel8ns_V1 extends WitnessWithContextRel8ns_V1 {
     [ROBBOT_TAG_TJP_ADDRS_REL8N_NAME]?: TjpIbGibAddr[];
 }
 
@@ -338,6 +339,7 @@ export const ROBBOT_SESSION_REL8N_NAME = 'session';
  */
 export const ROBBOT_INTERACTION_REL8N_NAME = 'interaction';
 
+export const ROBBOT_ATOM = "robbot";
 export const ROBBOT_SESSION_ATOM = 'robbot_session';
 export const ROBBOT_ANALYSIS_ATOM = 'robbot_analysis';
 export const ROBBOT_INTERACTION_ATOM = 'robbot_interaction';

package/src/witness/space/filesystem-space/filesystem-space-v1.mts

@@ -266,7 +266,7 @@ export abstract class FilesystemSpace_V1<
     TResultData extends FilesystemSpaceResultData,
     TResultRel8ns extends FilesystemSpaceResultRel8ns,
     TData extends FilesystemSpaceData_V1 = FilesystemSpaceData_V1,
-    TRel8ns extends IbGibRel8ns_V1 = IbGibRel8ns_V1
+    TRel8ns extends FilesystemSpaceRel8ns_V1 = FilesystemSpaceRel8ns_V1
 > extends SpaceBase_V1<
     IbGib_V1,
     TOptionsData,

package/src/witness/space/filesystem-space/{filesystem-space-v1.spec.mts → filesystem-space-v1.respec.mts}

@@ -1,3 +1,9 @@
+import {
+    firstOfEach, firstOfAll, ifWe,
+    lastOfEach, lastOfAll,
+    ifWeMight, iReckon, respecfully
+} from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+const maam = `[${import.meta.url}]`, sir = maam;
 import { getUUID, } from '@ibgib/helper-gib';
 import { getIbGibAddr } from '@ibgib/ts-gib';
 
@@ -5,7 +11,7 @@ import {
     testSpace_createAndInit,
     testSpace_persistTransformResult,
     testSpace_PutGetDelete
-} from '../space-spec-helper.mjs';
+} from '../space-respec-helper.mjs';
 import { FilesystemSpace_V1, } from './filesystem-space-v1.mjs';
 import {
     PutIbGibFileOpts, PutIbGibFileResult,
@@ -48,10 +54,11 @@ class MockFilesystemSpace_V1 extends FilesystemSpace_V1<any, any, any, any> {
 
 }
 
-describe(`[${FilesystemSpace_V1.name} specs]`, () => {
+await respecfully(sir, `[${FilesystemSpace_V1.name} specs]`, async () => {
 
-    testSpace_createAndInit({
-        // useFit: true,
+    await testSpace_createAndInit({
+        respecfulTitle: sir,
+        // shortcircuitRespec: true,
         fnGetInitialData: async () => {
             return {
                 name: (await getUUID()).substring(0, 8),
@@ -66,8 +73,9 @@ describe(`[${FilesystemSpace_V1.name} specs]`, () => {
         },
     })
 
-    testSpace_PutGetDelete({
-        // useFit: true,
+    await testSpace_PutGetDelete({
+        respecfulTitle: sir,
+        // shortcircuitRespec: true,
         fnGetInitialData: async () => {
             return {
                 name: (await getUUID()).substring(0, 8),
@@ -82,8 +90,9 @@ describe(`[${FilesystemSpace_V1.name} specs]`, () => {
         },
     });
 
-    testSpace_persistTransformResult({
-        // useFit: true,
+    await testSpace_persistTransformResult({
+        respecfulTitle: sir,
+        // shortcircuitRespec: true,
         fnGetInitialData: async () => {
             return {
                 name: (await getUUID()).substring(0, 8),

package/src/witness/space/filesystem-space/node-filesystem-space-v1.mts

@@ -7,20 +7,12 @@ import { getIbAndGib, getIbGibAddr, IbGibAddr } from '@ibgib/ts-gib';
 import { IbGib_V1, IbGibRel8ns_V1, GIB, ROOT, isPrimitive, getGib, } from '@ibgib/ts-gib/dist/V1/index.mjs';
 import { validateIbGibIntrinsically } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
 
-import { SpaceBase_V1 } from '../space-base-v1.mjs';
-import {
-    IbGibSpaceData, IbGibSpaceOptionsData, IbGibSpaceOptionsRel8ns,
-    IbGibSpaceOptionsIbGib, IbGibSpaceResultData, IbGibSpaceResultRel8ns,
-    IbGibSpaceResultIbGib,
-    IbGibSpaceData_Subpathed
-} from '../space-types.mjs';
-import { argy_ } from '../../witness-helper.mjs';
-import { isBinary, getBinHashAndExt } from '../../../common/other/ibgib-helper.mjs';
-import { parseSpaceIb, getSpaceIb, getSpecialIbGib, getTjpIbGib, } from '../space-helper.mjs';
+import { isBinary, } from '../../../common/other/ibgib-helper.mjs';
+import { parseSpaceIb, getSpaceIb, } from '../space-helper.mjs';
 import { DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS, IBGIB_SPACE_NAME_DEFAULT, ZERO_SPACE_ID } from '../space-constants.mjs';
 import { GLOBAL_LOG_A_LOT } from '../../../core-constants.mjs';
 import {
-    DeleteIbGibFileOpts, DeleteIbGibFilesResult, Directory, Encoding,
+    DeleteIbGibFileOpts, DeleteIbGibFilesResult,
     GetIbGibFileOpts,
     GetIbGibFileResult,
     PutIbGibFileOpts,

package/src/witness/space/filesystem-space/{node-filesystem-space-v1.node.spec.mts → node-filesystem-space-v1.node.respec.mts}

@@ -1,14 +1,19 @@
 import { default as pathUtils } from 'path';
 import { rm } from 'node:fs/promises';
 
+import { firstOfAll, ifWe, ifWeMight, iReckon, lastOfAll, respecfully, respecfullyDear } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+const maam = `[${import.meta.url}]`, sir = maam;
 import { delay, getUUID, } from '@ibgib/helper-gib';
 
 import {
     testSpace_createAndInit,
     testSpace_persistTransformResult,
     testSpace_PutGetDelete
-} from '../space-spec-helper.mjs';
-import { getCurrentFilename, specGetBaseSubPath, specGetSpaceDescription, specGetSpaceId, specGetSpaceName } from '../../../spec-helper.node.spec.mjs';
+} from '../space-respec-helper.mjs';
+import {
+    getCurrentFilename, specGetBaseSubPath, specGetSpaceDescription,
+    specGetSpaceId, specGetSpaceName
+} from '../../../spec-helper.node.respec.mjs';
 import { NodeFilesystemSpace_V1, NodeFilesystemSpaceData_V1 } from './node-filesystem-space-v1.mjs';
 import { IBGIB_ENCODING } from './filesystem-constants.mjs';
 
@@ -19,12 +24,8 @@ function specGetBaseDir(uuid: string): string {
     return pathUtils.join(TEST_BASE_DIR_ROOT, specGetSpaceName(uuid));
 }
 
-
-describe(`[${NodeFilesystemSpace_V1.name} specs]`, () => {
-    beforeAll(() => {
-
-    });
-    afterAll(async () => {
+await respecfully(sir, `[${NodeFilesystemSpace_V1.name} specs]`, async () => {
+    lastOfAll(sir, async () => {
         // rm -rf TEST_BASE_DIR_ROOT
         // comment this out if you want to examine generated ibgib data
         await rm(TEST_BASE_DIR_ROOT, {
@@ -33,8 +34,9 @@ describe(`[${NodeFilesystemSpace_V1.name} specs]`, () => {
         });
     });
 
-    testSpace_createAndInit({
-        // useFit: true,
+    await testSpace_createAndInit({
+        respecfulTitle: sir,
+        // shortcircuitRespec: true,
         fnGetInitialData: async () => {
             const uuid = await specGetSpaceId();
             return {
@@ -67,8 +69,9 @@ describe(`[${NodeFilesystemSpace_V1.name} specs]`, () => {
         },
     })
 
-    testSpace_PutGetDelete({
-        // useFit: true,
+    await testSpace_PutGetDelete({
+        respecfulTitle: sir,
+        // shortcircuitRespec: true,
         fnBeforeEach: async () => {
 
         },
@@ -105,8 +108,9 @@ describe(`[${NodeFilesystemSpace_V1.name} specs]`, () => {
         },
     });
 
-    testSpace_persistTransformResult({
-        // useFit: true,
+    await testSpace_persistTransformResult({
+        respecfulTitle: sir,
+        // shortcircuitRespec: true,
         fnGetInitialData: async () => {
             const uuid = await specGetSpaceId();
             return {

package/src/witness/space/inner-space/{inner-space-v1.spec.mts → inner-space-v1.respec.mts}

@@ -1,16 +1,23 @@
+import {
+    firstOfEach, firstOfAll, ifWe,
+    lastOfEach, lastOfAll,
+    ifWeMight, iReckon, respecfully
+} from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+const maam = `[${import.meta.url}]`, sir = maam;
 import { getUUID, } from '@ibgib/helper-gib';
 
 import {
     testSpace_createAndInit,
     testSpace_persistTransformResult,
     testSpace_PutGetDelete
-} from '../space-spec-helper.mjs';
+} from '../space-respec-helper.mjs';
 import { InnerSpace_V1, } from './inner-space-v1.mjs';
 
-describe(`[${InnerSpace_V1.name} specs]`, () => {
+await respecfully(sir, `[${InnerSpace_V1.name} specs]`, async () => {
 
-    testSpace_createAndInit({
-        // useFit: true,
+    await testSpace_createAndInit({
+        respecfulTitle: sir,
+        // shortcircuitRespec: true,
         fnGetInitialData: async () => {
             return {
                 name: (await getUUID()).substring(0, 8),
@@ -25,8 +32,9 @@ describe(`[${InnerSpace_V1.name} specs]`, () => {
         },
     })
 
-    testSpace_PutGetDelete({
-        // useFit: true,
+    await testSpace_PutGetDelete({
+        respecfulTitle: sir,
+        // shortcircuitRespec: true,
         fnGetInitialData: async () => {
             return {
                 name: (await getUUID()).substring(0, 8),
@@ -41,8 +49,9 @@ describe(`[${InnerSpace_V1.name} specs]`, () => {
         },
     });
 
-    testSpace_persistTransformResult({
-        // useFit: true,
+    await testSpace_persistTransformResult({
+        respecfulTitle: sir,
+        // shortcircuitRespec: true,
         fnGetInitialData: async () => {
             return {
                 name: (await getUUID()).substring(0, 8),