@ibgib/core-gib 0.1.2 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/core-gib",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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",
@@ -47,9 +47,9 @@
   "author": "William Raiford",
   "license": "ISC",
   "dependencies": {
-    "@ibgib/encrypt-gib": "^0.2.32",
-    "@ibgib/helper-gib": "^0.0.31",
-    "@ibgib/ts-gib": "^0.5.24"
+    "@ibgib/encrypt-gib": "^0.2.33",
+    "@ibgib/helper-gib": "^0.0.32",
+    "@ibgib/ts-gib": "^0.5.25"
   },
   "devDependencies": {
     "@types/node": "^20.2.1"

package/src/common/other/other-helper.respec.mts

@@ -28,7 +28,7 @@
 // /**
 //  * for verbose logging
 //  */
-// const logalot = GLOBAL_LOG_A_LOT || true; // change this when you want to turn off verbose logging
+// const logalot = GLOBAL_LOG_A_LOT; // change this when you want to turn off verbose logging
 
 // const lcFile: string = `[${pathUtils.basename(import.meta.url)}]`;
 

package/src/common/pubsub/observable/observable-helper.mts

@@ -34,7 +34,7 @@ import { SUBJECT_ATOM } from '../subject/subject-constants.mjs';
 /**
  * for logging. import this constant from your project.
  */
-const logalot = GLOBAL_LOG_A_LOT; // remove the true to "turn off" verbose logging
+const logalot = GLOBAL_LOG_A_LOT;
 
 export function validateCommonObservableData({
     data,

package/src/common/pubsub/subject/subject-helper.mts

@@ -36,7 +36,7 @@ import { Subject_V1_Factory } from './subject-v1.mjs';
 /**
  * for logging. import this constant from your project.
  */
-const logalot = GLOBAL_LOG_A_LOT; // remove the true to "turn off" verbose logging
+const logalot = GLOBAL_LOG_A_LOT;
 
 export function validateCommonSubjectData({
     data,

package/src/common/pubsub/subscription/subscription-helper.mts

@@ -32,7 +32,7 @@ import { Subscription_V1, Subscription_V1_Factory } from './subscription-v1.mjs'
 /**
  * for logging. import this constant from your project.
  */
-const logalot = GLOBAL_LOG_A_LOT; // remove the true to "turn off" verbose logging
+const logalot = GLOBAL_LOG_A_LOT;
 
 export function validateCommonSubscriptionData({
     data,

package/src/witness/space/inner-space/inner-space-v1.respec.mts

@@ -16,14 +16,12 @@ import {
     testSpace_putGetDelete,
     testSpace_registerNewIbGib_GetLatest,
 } from '../space-respec-helper.mjs';
-import { InnerSpace_V1,  } from './inner-space-v1.mjs';
+import { InnerSpace_V1, } from './inner-space-v1.mjs';
 import { createTimeline, getHistory, mut8Timeline } from '../../../timeline/timeline-api.mjs';
 import { MetaspaceService } from '../metaspace/metaspace-types.mjs';
 import { Metaspace_Innerspace } from '../metaspace/metaspace-innerspace/metaspace-innerspace.mjs';
 // import { getLatestAddrs, putInSpace } from '../space-helper.mjs';
 
-// ifWeMight() // don't remove this line while we're actively testing on this file. it is a limitation of my shortcut discovery script that it looks for a regex that matches ifWeMight/respecfullyDear followed by an open paren
-
 const logalot = true;
 /**
  * not sure where to put this, but we probably will want to reuse this in the
@@ -71,8 +69,8 @@ async function getNewInitializedInMemoryMetaspaceForTesting({
     }
 }
 
-await respecfullyDear(sir, 'metaspace setup itself', async () => {
-    await ifWeMight(sir, 'should init a metaspace', async () => {
+await respecfully(sir, 'metaspace setup itself', async () => {
+    await ifWe(sir, 'should init a metaspace', async () => {
         const testSpaceName = 'TestSpaceName';
 
         const metaspace = await getNewInitializedInMemoryMetaspaceForTesting({
@@ -83,7 +81,7 @@ await respecfullyDear(sir, 'metaspace setup itself', async () => {
     });
 });
 
-// await respecfullyDear(sir, `[${InnerSpace_V1.name} specs]`, async () => {
+// await respecfully(sir, `[${InnerSpace_V1.name} specs]`, async () => {
 
 //     await testSpace_createAndInit({
 //         respecfulTitle: sir,

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

@@ -53,7 +53,7 @@ import { newUpMetaStone } from '../../common/meta-stone/meta-stone-helper.mjs';
 import { WITNESS_ATOM } from '../witness-constants.mjs';
 import { SyncSpaceIbGib } from './outer-space/outer-space-types.mjs';
 
-let logalot = GLOBAL_LOG_A_LOT || true;
+let logalot = GLOBAL_LOG_A_LOT;
 
 
 /**

package/dist/witness/keystone/keystone-base-v1.d.mts

@@ -1,177 +0,0 @@
-import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
-import { WitnessWithContextBase_V1 } from '../witness-with-context/witness-with-context-base-v1.mjs';
-import { ErrorIbGib_V1 } from '../../common/error/error-types.mjs';
-import { KeystoneData_V1, KeystoneRel8ns_V1, KeystoneIbGib_V1, KeystoneOptionsIbGib, KeystoneOptionsData, KeystoneOptionsRel8ns, KeystoneResultIbGib, KeystoneResultData, KeystoneResultRel8ns } from './keystone-types.mjs';
-import { PicIbGib_V1 } from '../../common/pic/pic-types.mjs';
-import { CommentIbGib_V1 } from '../../common/comment/comment-types.mjs';
-/**
- * Keystone is the last major piece of the ibgib architecture. This is used to
- * implement distributed identity that gets added on-chain alongside other data
- * and metadata, instead of only relying solely upon asymmetric crypto for e.g.
- * signatures.
- *
- * Override this class with specific concrete implementations of keystones,
- * which atow I believe will differ mainly in their specific challenge
- * implementations.
- *
- * ## notes
- *
- * ### composite keystones
- *
- * At first I was thinking I was going to make keystones composite (super
- * keystones with rel8ns pointing to other keystones), but at least to start
- * with, I will have a specific concrete implementation class that covers
- * multiple keystone composition.
- */
-export declare abstract class KeystoneBase_V1<TChallenges, TSolutions, TOptionsData extends KeystoneOptionsData, TOptionsRel8ns extends KeystoneOptionsRel8ns, TOptionsIbGib extends KeystoneOptionsIbGib<IbGib_V1, TOptionsData, TOptionsRel8ns>, TResultData extends KeystoneResultData, TResultRel8ns extends KeystoneResultRel8ns, TResultIbGib extends KeystoneResultIbGib<IbGib_V1, TResultData, TResultRel8ns> | ErrorIbGib_V1, TData extends KeystoneData_V1<TChallenges, TSolutions>, TRel8ns extends KeystoneRel8ns_V1> extends WitnessWithContextBase_V1<TOptionsData, TOptionsRel8ns, TOptionsIbGib, TResultData, TResultRel8ns, TResultIbGib, TData, TRel8ns> implements KeystoneIbGib_V1<TData, TRel8ns> {
-    /**
-     * Log context for convenience with logging. (Ignore if you don't want to use this.)
-     */
-    protected lc: string;
-    constructor(initialData?: TData, initialRel8ns?: TRel8ns);
-    /**
-     * At this point in time, the arg has already been intrinsically validated,
-     * as well as the internal state of this keystone.
-     */
-    protected witnessImpl(arg: TOptionsIbGib): Promise<TResultIbGib | undefined>;
-    /**
-     * Base routing executes different if incoming is a cmd options arg, i.e.,
-     * if the `data.cmd` is truthy (atow). {@link isArg} is expected to be true
-     * at this point. If not, logs an error, **but does not throw**, and returns
-     * undefined.
-     *
-     * Default routing checks arg for command, or if not, checks if comment/pic.
-     * If neither of those, then returns undefined atow.
-     *
-     * Override this function to create more advanced custom routing.
-     *
-     * ## notes
-     *
-     * In general, an app ibgib acts more like a normal application in that it
-     * accepts commands and not requests. Robbots are more geared to requests,
-     * handled semantically.
-     *
-     * @see {@link isArg}
-     * @see {@link doCmdArg}
-     * @see {@link doDefault}.
-     */
-    protected routeAndDoArg({ arg, }: {
-        arg: TOptionsIbGib;
-    }): Promise<TResultIbGib | undefined>;
-    /**
-     * By default, this routes to {@link doCmdIb}, {@link doCmdGib} & {@link
-     * doCmdIbgib}. This is largely to limit scope of responsibility of app to
-     * basic functions. But this is not a concrete rule written in stone.
-     *
-     * You can always override this and route to other commands before calling
-     * this with `super.doCmdArg` as a fallback (if you still want to use this
-     * function.)
-     *
-     * Note that this @throws an error if the data.cmd is not recognized. In this
-     * implementation, this occurs if it isn't an ib/gib/ibgib _command_.
-     *
-     * ## commands
-     *
-     * ### confirm
-     *
-     * confirm possession of the keystone via the keystone's challenges as set
-     * out in the keystone's metadata.
-     *
-     * ### confirm final
-     *
-     * final confirmation of a secret of the stone. "kills" the stone once used.
-     * The point is to verify if a participant has the full secret of the stone,
-     * and not just mimicked part of the stone's ownership.
-     *
-     * ### revoke
-     *
-     * revoke due to being broken.
-     * maybe is a flavor of the confirm final?
-     */
-    protected doCmdArg({ arg, }: {
-        arg: TOptionsIbGib;
-    }): Promise<TResultIbGib>;
-    protected doCmdIb({ arg, }: {
-        arg: TOptionsIbGib;
-    }): Promise<TResultIbGib>;
-    /**
-     * this is the primary command handler when extending a keystone, i.e.  when
-     * signing some payload.
-     */
-    protected abstract extend({ arg }: {
-        arg: TOptionsIbGib;
-    }): Promise<TResultIbGib>;
-    protected doCmdGib({ arg, }: {
-        arg: TOptionsIbGib;
-    }): Promise<TResultIbGib>;
-    protected doCmdIbgib({ arg, }: {
-        arg: TOptionsIbGib;
-    }): Promise<TResultIbGib>;
-    /**
-     * Stubbed in base class for convenience. Doesn't have to be implemented.
-     *
-     * in the future, this may be able to be used for physical object
-     * verification via picture.
-     */
-    protected doPic({ ibGib, }: {
-        ibGib: PicIbGib_V1;
-    }): Promise<TResultIbGib | undefined>;
-    /**
-     * Stubbed in base class for convenience. Doesn't have to be implemented.
-     *
-     * in the future, this may be able to handle natural language and route
-     * accordingly.
-     */
-    protected doComment({ ibGib, }: {
-        ibGib: CommentIbGib_V1;
-    }): Promise<TResultIbGib | undefined>;
-    protected doNonArg({ ibGib, }: {
-        ibGib: TOptionsIbGib;
-    }): Promise<TResultIbGib | undefined>;
-    /**
-     * Stubbed in base class for convenience. Doesn't have to be implemented.
-     */
-    protected doDefault({ ibGib, }: {
-        ibGib: TOptionsIbGib;
-    }): Promise<TResultIbGib | undefined>;
-    /**
-     * validates against common app qualities.
-     *
-     * Override this with a call to `super.validateThis` for custom validation
-     * for descending app classes.
-     *
-     * @returns validation errors common to all apps, if any errors exist.
-     */
-    protected validateThis(): Promise<string[]>;
-    /**
-     * builds an arg ibGib.
-     *
-     * wrapper convenience to avoid long generic calls.
-     */
-    argy<TOptionsData extends KeystoneOptionsData = KeystoneOptionsData, TOptionsRel8ns extends KeystoneOptionsRel8ns = KeystoneOptionsRel8ns, TOptionsIbGib extends KeystoneOptionsIbGib<IbGib_V1, TOptionsData, TOptionsRel8ns> = KeystoneOptionsIbGib<IbGib_V1, TOptionsData, TOptionsRel8ns>>({ argData, ibMetadata, noTimestamp, ibGibs, }: {
-        argData: TOptionsData;
-        ibMetadata?: string;
-        noTimestamp?: boolean;
-        ibGibs?: IbGib_V1[];
-    }): Promise<TOptionsIbGib>;
-    /**
-     * builds a result ibGib, if indeed a result ibgib is required.
-     *
-     * This is only useful in apps that have more structured inputs/outputs.
-     * For those that simply accept any ibgib incoming and return a
-     * primitive like ib^gib or whatever, then this is unnecessary.
-     *
-     * wrapper convenience to avoid long generic calls.
-     */
-    resulty<TResultData extends KeystoneResultData = KeystoneResultData, TResultRel8ns extends KeystoneResultRel8ns = KeystoneResultRel8ns, TResultIbGib extends KeystoneResultIbGib<IbGib_V1, TResultData, TResultRel8ns> = KeystoneResultIbGib<IbGib_V1, TResultData, TResultRel8ns>>({ resultData, ibGibs, }: {
-        resultData: TResultData;
-        ibGibs?: IbGib_V1[];
-    }): Promise<TResultIbGib>;
-}
-/**
- * useful for when passing around instances of keystones where implementation
- * details are not important.
- */
-export interface IbGibKeystoneAny extends KeystoneBase_V1<any, any, any, any, any, any, any, any, any, any> {
-}
-//# sourceMappingURL=keystone-base-v1.d.mts.map

package/dist/witness/keystone/keystone-base-v1.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"keystone-base-v1.d.mts","sourceRoot":"","sources":["../../../src/witness/keystone/keystone-base-v1.mts"],"names":[],"mappings":"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"}

package/dist/witness/keystone/keystone-base-v1.mjs

@@ -1,397 +0,0 @@
-import { argy_, isArg, isCommand, resulty_ } from '../witness-helper.mjs';
-import { WitnessWithContextBase_V1 } from '../witness-with-context/witness-with-context-base-v1.mjs';
-import { getErrorIbGib } from '../../common/error/error-helper.mjs';
-import { KeystoneCmd,
-// KeystoneCmd,
-// KeystoneCmdData, KeystoneCmdRel8ns, KeystoneCmdIbGib,
-// KeystoneResultData, KeystoneResultRel8ns, KeystoneResultIbGib,
- } from './keystone-types.mjs';
-import { validateCommonKeystoneData } from './keystone-helper.mjs';
-import { GLOBAL_LOG_A_LOT } from '../../core-constants.mjs';
-const logalot = GLOBAL_LOG_A_LOT;
-/**
- * Keystone is the last major piece of the ibgib architecture. This is used to
- * implement distributed identity that gets added on-chain alongside other data
- * and metadata, instead of only relying solely upon asymmetric crypto for e.g.
- * signatures.
- *
- * Override this class with specific concrete implementations of keystones,
- * which atow I believe will differ mainly in their specific challenge
- * implementations.
- *
- * ## notes
- *
- * ### composite keystones
- *
- * At first I was thinking I was going to make keystones composite (super
- * keystones with rel8ns pointing to other keystones), but at least to start
- * with, I will have a specific concrete implementation class that covers
- * multiple keystone composition.
- */
-export class KeystoneBase_V1 extends WitnessWithContextBase_V1 {
-    /**
-     * Log context for convenience with logging. (Ignore if you don't want to use this.)
-     */
-    lc = `[${KeystoneBase_V1.name}]`;
-    // /**
-    //  * Reference to the local ibgibs service, which is one way at getting at the
-    //  * local user space.
-    //  */
-    // metaspace: MetaspaceService | undefined;
-    constructor(initialData, initialRel8ns) {
-        super(initialData, initialRel8ns);
-    }
-    /**
-     * At this point in time, the arg has already been intrinsically validated,
-     * as well as the internal state of this keystone.
-     */
-    async witnessImpl(arg) {
-        const lc = `${this.lc}[${this.witnessImpl.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            await this.loadNewerSelfIfAvailable();
-            let result = undefined;
-            if (isArg({ ibGib: arg })) {
-                result = await this.routeAndDoArg({ arg });
-            }
-            else {
-                result = await this.doNonArg({ ibGib: arg });
-            }
-            // if we didn't get a result, try the default.
-            if (!result) {
-                console.warn(`${lc} result still falsy. doing default handler. (W: 924d1fc93ad5464e81f71f2783d778a8)`);
-                result = await this.doDefault({ ibGib: arg });
-            }
-            if (!result) {
-                console.warn(`${lc} result falsy...Could not produce result? Was doDefault implemented in concrete class? (W: 78861cb3c37546fa8f0b2bee4c50f832)`);
-            }
-            return result;
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    /**
-     * Base routing executes different if incoming is a cmd options arg, i.e.,
-     * if the `data.cmd` is truthy (atow). {@link isArg} is expected to be true
-     * at this point. If not, logs an error, **but does not throw**, and returns
-     * undefined.
-     *
-     * Default routing checks arg for command, or if not, checks if comment/pic.
-     * If neither of those, then returns undefined atow.
-     *
-     * Override this function to create more advanced custom routing.
-     *
-     * ## notes
-     *
-     * In general, an app ibgib acts more like a normal application in that it
-     * accepts commands and not requests. Robbots are more geared to requests,
-     * handled semantically.
-     *
-     * @see {@link isArg}
-     * @see {@link doCmdArg}
-     * @see {@link doDefault}.
-     */
-    async routeAndDoArg({ arg, }) {
-        const lc = `${this.lc}[${this.routeAndDoArg.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            const ibGib = arg;
-            if (!isArg({ ibGib })) {
-                throw new Error(`ibGib is not an arg (E: 7e5ed6e3be45480e992c75a1c21f1b4e)`);
-            }
-            if (isCommand({ ibGib })) {
-                return this.doCmdArg({ arg });
-            }
-            else {
-                return undefined;
-            }
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            if (this.data?.catchAllErrors) {
-                return (await getErrorIbGib({ rawMsg: error.message }));
-            }
-            else {
-                throw error;
-            }
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    // #region do cmd args
-    /**
-     * By default, this routes to {@link doCmdIb}, {@link doCmdGib} & {@link
-     * doCmdIbgib}. This is largely to limit scope of responsibility of app to
-     * basic functions. But this is not a concrete rule written in stone.
-     *
-     * You can always override this and route to other commands before calling
-     * this with `super.doCmdArg` as a fallback (if you still want to use this
-     * function.)
-     *
-     * Note that this @throws an error if the data.cmd is not recognized. In this
-     * implementation, this occurs if it isn't an ib/gib/ibgib _command_.
-     *
-     * ## commands
-     *
-     * ### confirm
-     *
-     * confirm possession of the keystone via the keystone's challenges as set
-     * out in the keystone's metadata.
-     *
-     * ### confirm final
-     *
-     * final confirmation of a secret of the stone. "kills" the stone once used.
-     * The point is to verify if a participant has the full secret of the stone,
-     * and not just mimicked part of the stone's ownership.
-     *
-     * ### revoke
-     *
-     * revoke due to being broken.
-     * maybe is a flavor of the confirm final?
-     */
-    doCmdArg({ arg, }) {
-        const lc = `${this.lc}[${this.doCmdArg.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            if (!arg.data?.cmd) {
-                throw new Error(`invalid cmd arg. arg.data.cmd required. (E: 470aabf26ca6406b84dbae3b9b39639d)`);
-            }
-            if (arg.data.cmd === KeystoneCmd.ib) {
-                return this.doCmdIb({ arg: arg });
-            }
-            else if (arg.data.cmd === KeystoneCmd.gib) {
-                return this.doCmdGib({ arg: arg });
-            }
-            else if (arg.data.cmd === KeystoneCmd.ibgib) {
-                return this.doCmdIbgib({ arg: arg });
-            }
-            else {
-                throw new Error(`unknown arg.data.cmd: ${arg.data.cmd} (E: 0eb81ae8c3834f47865af0ac7b7a9fd6)`);
-            }
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    doCmdIb({ arg, }) {
-        return this.extend({ arg });
-    }
-    doCmdGib({ arg, }) {
-        const lc = `${this.lc}[${this.doCmdGib.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            throw new Error(`not implemented in base class (E: bb16814f46984a9dafac5b85d8ec1f74)`);
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    doCmdIbgib({ arg, }) {
-        const lc = `${this.lc}[${this.doCmdIbgib.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            throw new Error(`not implemented in base class (E: 6f3ed691d16a43f49145b2ed46fb28ba)`);
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    // #endregion do cmd args
-    // #region other stubbed do functions (doPic, doComment, doDefault)
-    /**
-     * Stubbed in base class for convenience. Doesn't have to be implemented.
-     *
-     * in the future, this may be able to be used for physical object
-     * verification via picture.
-     */
-    doPic({ ibGib, }) {
-        const lc = `${this.lc}[${this.doPic.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            throw new Error(`not implemented in base class (E: ce5c9b30622f4b3bab198dde04de75e7)`);
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    /**
-     * Stubbed in base class for convenience. Doesn't have to be implemented.
-     *
-     * in the future, this may be able to handle natural language and route
-     * accordingly.
-     */
-    doComment({ ibGib, }) {
-        const lc = `${this.lc}[${this.doComment.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            throw new Error(`not implemented in base class (E: c90f5bddaa58446fb4de638816974b6c)`);
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    doNonArg({ ibGib, }) {
-        const lc = `${this.lc}[${this.doNonArg.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            return this.doDefault({ ibGib });
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    /**
-     * Stubbed in base class for convenience. Doesn't have to be implemented.
-     */
-    doDefault({ ibGib, }) {
-        const lc = `${this.lc}[${this.doDefault.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            throw new Error(`not implemented in base class (E: bee031bb4c974a71bae82df7cff2b4e1)`);
-            // return this.doDefaultImpl({ibGib});
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    // #endregion other stubbed do functions (doPic, doComment, doDefault)
-    /**
-     * validates against common app qualities.
-     *
-     * Override this with a call to `super.validateThis` for custom validation
-     * for descending app classes.
-     *
-     * @returns validation errors common to all apps, if any errors exist.
-     */
-    async validateThis() {
-        const lc = `${this.lc}[${this.validateThis.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            if (!this.data) {
-                throw new Error(`(UNEXPECTED) this.data falsy? (E: bd4b0fc836774eb288b8b07ec79cb4af)`);
-            }
-            const errors = [
-                // ...await super.validateThis(),
-                ...validateCommonKeystoneData({ appData: this.data }),
-            ];
-            return errors;
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    /**
-     * builds an arg ibGib.
-     *
-     * wrapper convenience to avoid long generic calls.
-     */
-    async argy({ argData, ibMetadata, noTimestamp, ibGibs, }) {
-        const arg = await argy_({
-            argData,
-            ibMetadata,
-            noTimestamp
-        });
-        if (ibGibs) {
-            arg.ibGibs = ibGibs;
-        }
-        return arg;
-    }
-    /**
-     * builds a result ibGib, if indeed a result ibgib is required.
-     *
-     * This is only useful in apps that have more structured inputs/outputs.
-     * For those that simply accept any ibgib incoming and return a
-     * primitive like ib^gib or whatever, then this is unnecessary.
-     *
-     * wrapper convenience to avoid long generic calls.
-     */
-    async resulty({ resultData, ibGibs, }) {
-        const result = await resulty_({
-            // ibMetadata: getKeystoneResultMetadata({space: this}),
-            resultData,
-        });
-        if (ibGibs) {
-            result.ibGibs = ibGibs;
-        }
-        return result;
-    }
-}
-//# sourceMappingURL=keystone-base-v1.mjs.map