@ibgib/core-gib 0.0.4

package/dist/witness/space/space-types.mjs

@@ -0,0 +1,52 @@
+import { ENCRYPTION_REL8N_NAME } from '../../common/encrypt/encrypt-constants.mjs';
+import { BOOTSTRAP_DATA_DEFAULT_SPACE_ID_KEY, BOOTSTRAP_DATA_KNOWN_SPACE_IDS_KEY } from './bootstrap/bootstrap-constants.mjs';
+/** Cmds for interacting with ibgib spaces.  */
+export const IbGibSpaceOptionsCmd = {
+    /** Retrieve ibGib(s) out of the space (does not remove them). */
+    get: 'get',
+    /** Registers/imports ibGib(s) into the space. */
+    put: 'put',
+    /** Delete an ibGib from a space */
+    delete: 'delete',
+};
+/**
+ * Flags to affect the command's interpretation.
+ */
+export const IbGibSpaceOptionsCmdModifier = {
+    /**
+     * Only interested if possibility to do command.
+     *
+     * This can be due to authorization or other.
+     */
+    can: 'can',
+    /**
+     * Only return the addresses of ibgibs
+     */
+    addrs: 'addrs',
+    /**
+     * Only interested in the latest one(s).
+     *
+     * The incoming addr(s) should be the tjp(s), since "latest"
+     * only makes sense with unique timelines which are referenced by
+     * their tjps.
+     *
+     * ## notes
+     *
+     * ATOW I'm actually using this in the aws dynamodb ibgib space to
+     * get "newer" ibgibs, not just the latest.
+     */
+    latest: 'latest',
+    /**
+     * Ask to get updates on tjps in ibGibAddrs.
+     */
+    watch: 'watch',
+    /*
+     * Ask to stop getting updates on tjps in ibGibAddrs.
+     */
+    unwatch: 'unwatch',
+    /**
+     * Get the tjp ibgibs/addrs for given ibgib(s)
+     */
+    tjps: 'tjps',
+};
+//# sourceMappingURL=space-types.mjs.map

package/dist/witness/space/space-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-types.mjs","sourceRoot":"","sources":["../../../src/witness/space/space-types.mts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,mCAAmC,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AA0F9H,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,iEAAiE;IACjE,GAAG,EAAE,KAA6B;IAClC,iDAAiD;IACjD,GAAG,EAAE,KAA6B;IAClC,mCAAmC;IACnC,MAAM,EAAE,QAAgC;CAC3C,CAAA;AAOD;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IACxC;;;;OAIG;IACH,GAAG,EAAE,KAAqC;IAC1C;;OAEG;IACH,KAAK,EAAE,OAAuC;IAC9C;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,QAAwC;IAChD;;OAEG;IACH,KAAK,EAAE,OAAuC;IAC9C;;OAEG;IACH,OAAO,EAAE,SAAyC;IAClD;;OAEG;IACH,IAAI,EAAE,MAAsC;CAC/C,CAAA"}

package/dist/witness/witness-base-v1.d.ts

@@ -0,0 +1,144 @@
+import { IbGibRel8ns } from '@ibgib/ts-gib';
+import { IbGib_V1, IbGibRel8ns_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
+import { WitnessData_V1, WitnessRel8ns_V1, Witness_V1 } from './witness-types.mjs';
+import { ErrorIbGib_V1 } from '../common/error/error-types.mjs';
+export declare abstract class WitnessBase_V1<TOptionsData extends any, TOptionsRel8ns extends IbGibRel8ns_V1, TOptionsIbGib extends IbGib_V1<TOptionsData, TOptionsRel8ns>, TResultData extends any, TResultRel8ns extends IbGibRel8ns_V1, TResultIbGib extends IbGib_V1<TResultData, TResultRel8ns> | ErrorIbGib_V1, TData extends WitnessData_V1 = any, TRel8ns extends IbGibRel8ns_V1 = IbGibRel8ns_V1> implements Witness_V1<TOptionsData, TOptionsRel8ns, TOptionsIbGib, // options arg
+TResultData, TResultRel8ns, TResultIbGib, // result
+TData, TRel8ns> {
+    /**
+     * Log context for convenience with logging. (Ignore if you don't want to use this.)
+     */
+    protected lc: string;
+    /**
+     * Optional arg for verbose logging.
+     */
+    protected set trace(value: boolean);
+    protected get trace(): boolean;
+    /**
+     * Optional configuration for `witness` call.
+     * If true, then this space will catch any error that propagates up
+     * from the `witnessImpl` function.
+     *
+     * ## notes
+     *
+     * Descendants of Witness who don't override the base `witness` function
+     * (but rather override `witnessImpl` as expected) don't need to check
+     * for this explicitly, since it is referenced in the base `witness`
+     * function implementation.
+     */
+    protected set catchAllErrors(value: boolean);
+    protected get catchAllErrors(): boolean;
+    /**
+     * Used per use case in implementing class.
+     *
+     * This property is a simple property (no getter/setter with backing
+     * fields).  This is to simplify usage with DTOs (Data Transfer Objects) for
+     * storing in spaces.
+     */
+    ib: string;
+    /**
+     * Used per use case in implementing class.
+     *
+     * This property is a simple property (no getter/setter with backing
+     * fields).  This is to simplify usage with DTOs (Data Transfer Objects) for
+     * storing in spaces.
+     */
+    gib: string | undefined;
+    /**
+     * Used per use case in implementing class.
+     *
+     * This property is a simple property (no getter/setter with backing
+     * fields).  This is to simplify usage with DTOs (Data Transfer Objects) for
+     * storing in spaces.
+     */
+    data: TData | undefined;
+    /**
+     * Used per use case in implementing class.
+     *
+     * This property is a simple property (no getter/setter with backing
+     * fields).  This is to simplify usage with DTOs (Data Transfer Objects) for
+     * storing in spaces.
+     */
+    rel8ns: TRel8ns | undefined;
+    constructor(initialData?: TData, initialRel8ns?: TRel8ns);
+    /**
+     * Creates a data transfer object (dto) snapshot out of this
+     * witness' `ib`, `gib`, `data` and `rel8ns` properties.
+     *
+     * I say "snapshot" because this copies each property
+     * (`ib`, `gib`, `data`, `rel8ns`).
+     *
+     * ## thoughts
+     *
+     * Witness classes need to be able to persist their ibgib
+     * just as regular data. But witnesses have the additional
+     * layer of behavior (e.g. the `witness` function) that
+     * will not persist (until we get more integrated version control
+     * types of functionality in ibgib).
+     *
+     * @returns dto ibgib object with just clones of this.ib/gib/data/rel8ns props.
+     *
+     * @see {loadIbGibDto}
+     */
+    toIbGibDto(): IbGib_V1<TData, TRel8ns>;
+    /**
+     * (Re)hydrates this witness class with the ibgib information from the dto.
+     *
+     * ## notes
+     *
+     * * You can extend this function for witness-specific behavior when loading.
+     *
+     * @param dto ib, gib, data & rel8ns to load for this witness ibgib instance.
+     *
+     * @see {toIbGibDto}
+     */
+    loadIbGibDto(dto: IbGib_V1<TData, TRel8ns>): Promise<void>;
+    /**
+     * The primary function of a witness is...well... to witness things.
+     *
+     * So this is the base implementation that includes validation
+     * plumbing, tracing, error checking/catching - all depending
+     * on witness configuration.
+     *
+     *
+     * ## usage
+     *
+     * Only override this function if you really want custom handling of
+     * the plumbing.  Instead override `witnessImpl`.
+     *
+     * {@see validateThis}
+     * {@see validateWitnessArg}
+     *
+     * @param arg
+     * @returns
+     */
+    witness(arg: TOptionsIbGib): Promise<TResultIbGib | undefined>;
+    protected abstract witnessImpl(arg: TOptionsIbGib): Promise<TResultIbGib | undefined>;
+    /**
+     * Validate the incoming arg.
+     *
+     * Override this in descending classes per use case.
+     */
+    protected validateWitnessArg(arg: TOptionsIbGib): Promise<string[]>;
+    /**
+     * Validate this witness object, checking its own `data` and `rel8ns`, and
+     * possibly other state.
+     *
+     * ## notes
+     *
+     * ATOW base implementation of this just checks for non-falsy
+     * `this.ib` and `this.gib`
+     */
+    protected validateThis(): Promise<string[]>;
+    /**
+     * Empty implementation in this base class.
+     *
+     * @see {@link WitnessData_V1.persistOptsAndResultIbGibs}
+     */
+    protected persistOptsAndResultIbGibs({ arg, result }: {
+        arg: TOptionsIbGib;
+        result: TResultIbGib | undefined;
+    }): Promise<void>;
+}
+export type WitnessAny = WitnessBase_V1<any, IbGibRel8ns_V1, IbGib_V1, any, IbGibRel8ns, IbGib_V1, WitnessData_V1, WitnessRel8ns_V1>;
+//# sourceMappingURL=witness-base-v1.d.ts.map

package/dist/witness/witness-base-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-base-v1.d.ts","sourceRoot":"","sources":["../../src/witness/witness-base-v1.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAa,MAAM,iCAAiC,CAAC;AAItF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAG,MAAM,qBAAqB,CAAC;AAEpF,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAMhE,8BAAsB,cAAc,CAChC,YAAY,SAAS,GAAG,EACxB,cAAc,SAAS,cAAc,EACrC,aAAa,SAAS,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,EAC5D,WAAW,SAAS,GAAG,EACvB,aAAa,SAAS,cAAc,EACpC,YAAY,SAAS,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,GAAG,aAAa,EACzE,KAAK,SAAS,cAAc,GAAG,GAAG,EAClC,OAAO,SAAS,cAAc,GAAG,cAAc,CAE/C,YAAW,UAAU,CACjB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc;AAC3D,WAAW,EAAE,aAAa,EAAE,YAAY,EAAK,SAAS;AACtD,KAAK,EAAE,OAAO,CACjB;IAED;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,CAA8B;IAElD;;OAEG;IACH,SAAS,KAAK,KAAK,CAAC,KAAK,EAAE,OAAO,EASjC;IACD,SAAS,KAAK,KAAK,IAAI,OAAO,CAAsC;IAEpE;;;;;;;;;;;OAWG;IACH,SAAS,KAAK,cAAc,CAAC,KAAK,EAAE,OAAO,EAS1C;IACD,SAAS,KAAK,cAAc,IAAI,OAAO,CAKtC;IAID;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAM;IAEhB;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAExB;;;;;;OAMG;IACH,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IAExB;;;;;;OAMG;IACH,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;gBAIhB,WAAW,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,OAAO;IAKxD;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IActC;;;;;;;;;;OAUG;IACH,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B1D;;;;;;;;;;;;;;;;;;OAkBG;IACG,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAmCpE,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAErF;;;;OAIG;cACa,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4BzE;;;;;;;;OAQG;cACa,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAajD;;;;OAIG;IACH,SAAS,CAAC,0BAA0B,CAAC,EACjC,GAAG,EACH,MAAM,EACT,EAAE;QACC,GAAG,EAAE,aAAa,CAAC;QACnB,MAAM,EAAE,YAAY,GAAG,SAAS,CAAA;KACnC,GAAG,OAAO,CAAC,IAAI,CAAC;CAMpB;AAED,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/witness/witness-base-v1.js

@@ -0,0 +1,300 @@
+import * as h from '@ibgib/helper-gib';
+import { getIbGibAddr } from '@ibgib/ts-gib';
+import { sha256v1, } from '@ibgib/ts-gib/dist/V1/index.mjs';
+import { getGibInfo } from '@ibgib/ts-gib/dist/V1/transforms/transform-helper.mjs';
+import { validateGib, validateIb, validateIbGibIntrinsically } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
+import { toDto } from '../common/other/ibgib-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../core-constants.mjs';
+const logalot = GLOBAL_LOG_A_LOT || false;
+export class WitnessBase_V1 {
+    /**
+     * Optional arg for verbose logging.
+     */
+    set trace(value) {
+        const lc = `${this.lc}[set trace]`;
+        if (value === (this.data?.trace || false)) {
+            return;
+        }
+        if (this.data) {
+            this.data.trace = value;
+            delete this.gib; // gib is invalid now
+        }
+        else {
+            console.warn(`${lc} data is falsy. Can't set.`);
+        }
+    }
+    get trace() { return this.data?.trace ?? false; }
+    /**
+     * Optional configuration for `witness` call.
+     * If true, then this space will catch any error that propagates up
+     * from the `witnessImpl` function.
+     *
+     * ## notes
+     *
+     * Descendants of Witness who don't override the base `witness` function
+     * (but rather override `witnessImpl` as expected) don't need to check
+     * for this explicitly, since it is referenced in the base `witness`
+     * function implementation.
+     */
+    set catchAllErrors(value) {
+        const lc = `${this.lc}[set catchAllErrors]`;
+        if (value === this.data?.catchAllErrors) {
+            return;
+        }
+        if (this.data) {
+            this.data.catchAllErrors = value;
+            delete this.gib;
+        }
+        else {
+            console.error(`${lc} data is falsy. Can't set value.`);
+        }
+    }
+    get catchAllErrors() {
+        const lc = `${this.lc}[catchAllErrors]`;
+        const result = this.data?.catchAllErrors || false;
+        if (logalot || this.trace) {
+            console.log(`${lc} result: ${result}`);
+        }
+        return result;
+    }
+    // #endregion IbGib interface fields: ib, gib, data, rel8ns
+    constructor(initialData, initialRel8ns) {
+        /**
+         * Log context for convenience with logging. (Ignore if you don't want to use this.)
+         */
+        this.lc = `[${WitnessBase_V1.name}]`;
+        // #region IbGib interface fields: ib, gib, data, rel8ns
+        /**
+         * Used per use case in implementing class.
+         *
+         * This property is a simple property (no getter/setter with backing
+         * fields).  This is to simplify usage with DTOs (Data Transfer Objects) for
+         * storing in spaces.
+         */
+        this.ib = '';
+        if (initialData) {
+            this.data = initialData;
+        }
+        if (initialRel8ns) {
+            this.rel8ns = initialRel8ns;
+        }
+    }
+    /**
+     * Creates a data transfer object (dto) snapshot out of this
+     * witness' `ib`, `gib`, `data` and `rel8ns` properties.
+     *
+     * I say "snapshot" because this copies each property
+     * (`ib`, `gib`, `data`, `rel8ns`).
+     *
+     * ## thoughts
+     *
+     * Witness classes need to be able to persist their ibgib
+     * just as regular data. But witnesses have the additional
+     * layer of behavior (e.g. the `witness` function) that
+     * will not persist (until we get more integrated version control
+     * types of functionality in ibgib).
+     *
+     * @returns dto ibgib object with just clones of this.ib/gib/data/rel8ns props.
+     *
+     * @see {loadIbGibDto}
+     */
+    toIbGibDto() {
+        return toDto({ ibGib: this });
+        // const lc = `${this.lc}[${this.toIbGibDto.name}]`;
+        // if (!this.ib) { console.warn(`${lc} this.ib is falsy. (W: 60162e3ab42941e9a68cd6adc8d23387)`); }
+        // if (!this.gib) { console.warn(`${lc} this.gib is falsy. (W: 61dc535639dc410d874635013fce5b8a)`); }
+        // let dtoIbGib: IbGib_V1<TData, TRel8ns> = { ib: (this.ib || '').slice() };
+        // if (this.gib) { dtoIbGib.gib = this.gib.slice(); };
+        // if (this.data) { dtoIbGib.data = h.clone(this.data); }
+        // if (this.rel8ns) { dtoIbGib.rel8ns = h.clone(this.rel8ns); }
+        // return dtoIbGib;
+    }
+    /**
+     * (Re)hydrates this witness class with the ibgib information from the dto.
+     *
+     * ## notes
+     *
+     * * You can extend this function for witness-specific behavior when loading.
+     *
+     * @param dto ib, gib, data & rel8ns to load for this witness ibgib instance.
+     *
+     * @see {toIbGibDto}
+     */
+    loadIbGibDto(dto) {
+        const lc = `${this.lc}[${this.loadIbGibDto.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting...`);
+            }
+            if (!dto.ib) {
+                console.warn(`${lc} dto.ib is falsy.`);
+            }
+            if (!dto.gib) {
+                console.warn(`${lc} dto.gib is falsy.`);
+            }
+            this.ib = h.clone(dto.ib);
+            this.gib = h.clone(dto.gib);
+            if (dto.data) {
+                this.data = h.clone(dto.data);
+            }
+            else {
+                delete this.data;
+            }
+            if (dto.rel8ns) {
+                this.rel8ns = h.clone(dto.rel8ns);
+            }
+            else {
+                delete this.rel8ns;
+            }
+            return Promise.resolve();
+        }
+        catch (error) {
+            console.error(`${lc} ${error.message}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * The primary function of a witness is...well... to witness things.
+     *
+     * So this is the base implementation that includes validation
+     * plumbing, tracing, error checking/catching - all depending
+     * on witness configuration.
+     *
+     *
+     * ## usage
+     *
+     * Only override this function if you really want custom handling of
+     * the plumbing.  Instead override `witnessImpl`.
+     *
+     * {@see validateThis}
+     * {@see validateWitnessArg}
+     *
+     * @param arg
+     * @returns
+     */
+    async witness(arg) {
+        const lc = `${this.lc}[${this.witness.name}]`;
+        try {
+            if (!this.gib) {
+                this.gib = await sha256v1(this.toIbGibDto());
+            }
+            const validationErrors_this = await this.validateThis();
+            if (validationErrors_this?.length > 0) {
+                for (const error of validationErrors_this) {
+                    console.error(`${lc} ${error}`);
+                }
+                throw new Error(`internal witness validation failed. See \`WitnessBase_V1.validateThis\` (E: 2b5f73cadbfa416ba189346f3c31cd0c)`);
+            }
+            const validationErrors_arg = await this.validateWitnessArg(arg);
+            if (validationErrors_arg?.length > 0) {
+                for (const error of validationErrors_arg) {
+                    console.error(`${lc} ${error}`);
+                }
+                debugger;
+                throw new Error(`arg validation failed. See \`WitnessBase_V1.validateWitnessArg\` (E: 51531a1d928a485e8ffc277145ec44e9)`);
+            }
+            if (logalot || this.trace) {
+                console.log(`${lc} addr: ${getIbGibAddr(arg)}`);
+            }
+            if (logalot) {
+                console.log(`${lc} addr: ${getIbGibAddr(arg)} (I: f4cf13a44c4e4fc3903f14018e616c64)`);
+            }
+            const result = await this.witnessImpl(arg);
+            // persist the arg and result if we're configured to do so it is up
+            // to the implementation whether or not to throw on this.
+            if (this.data?.persistOptsAndResultIbGibs) {
+                await this.persistOptsAndResultIbGibs({ arg, result });
+            }
+            return result;
+        }
+        catch (error) {
+            console.error(`${lc} ${error.message || 'unknown error (E: 3e22bea4c7fb4668bf13d7146b927869)'}`);
+            if (!this.catchAllErrors) {
+                throw error;
+            }
+            else {
+                return; // undefined
+            }
+        }
+    }
+    /**
+     * Validate the incoming arg.
+     *
+     * Override this in descending classes per use case.
+     */
+    async validateWitnessArg(arg) {
+        const lc = `${this.lc}[${this.validateWitnessArg.name}]`;
+        try {
+            const errors = [];
+            if (!arg) {
+                errors.push(`arg required (E: a222db3b668e4bb09cfd82e75c07bfa6)`);
+            }
+            const ibErrors = validateIb({ ib: arg?.ib });
+            if (ibErrors?.length ?? 0 > 0) {
+                errors.push(`invalid arg.ib (E: 2ae362ef274d4c3bb9716800f2106d28) errors: ${ibErrors.join('\n')}`);
+            }
+            const gibErrors = validateGib({ gib: arg?.gib });
+            if (gibErrors?.length ?? 0 > 0) {
+                errors.push(`invalid arg.gib (E: 73be275058084d768a39299337f2ce34) errors: ${gibErrors.join('\n')}`);
+            }
+            const intrinsicErrors = await validateIbGibIntrinsically({ ibGib: arg });
+            if (intrinsicErrors?.length ?? 0 > 0) {
+                errors.push(`arg ibgib invalid intrinsically (E: 73be275058084d768a39299337f2ce34) errors: ${intrinsicErrors.join('\n')}`);
+            }
+            else if (!this.data?.allowPrimitiveArgs) {
+                // further check to see if primitive
+                const gibInfo = getGibInfo({ gib: arg.gib });
+                if (gibInfo.isPrimitive) {
+                    errors.push(`arg is primitive (i.e. gib === "gib") and witness.data.allowPrimitiveArgs is falsy. (E: d0aa3d7ad4f54b01bd0023300d15ecd9)`);
+                }
+            }
+            return errors;
+        }
+        catch (error) {
+            console.error(`${lc} ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Validate this witness object, checking its own `data` and `rel8ns`, and
+     * possibly other state.
+     *
+     * ## notes
+     *
+     * ATOW base implementation of this just checks for non-falsy
+     * `this.ib` and `this.gib`
+     */
+    async validateThis() {
+        const lc = `${this.lc}[${this.validateThis.name}]`;
+        const errors = [];
+        try {
+            if (!this.ib) {
+                errors.push(`this.ib is falsy.`);
+            }
+            if (!this.gib) {
+                errors.push(`this.gib is falsy.`);
+            }
+        }
+        catch (error) {
+            console.error(`${lc} ${error.message}`);
+            throw error;
+        }
+        return errors;
+    }
+    /**
+     * Empty implementation in this base class.
+     *
+     * @see {@link WitnessData_V1.persistOptsAndResultIbGibs}
+     */
+    persistOptsAndResultIbGibs({ arg, result }) {
+        const lc = `${this.lc}[${this.persistOptsAndResultIbGibs.name}]`;
+        console.warn(`${lc} not implemented in this base class. Override this in descendent class. (W: 087514e851704322a4ec8069a73ce944)`);
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=witness-base-v1.js.map

package/dist/witness/witness-base-v1.js.map

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

package/dist/witness/witness-constants.d.mts

@@ -0,0 +1,3 @@
+export declare const WITNESS_ARG_METADATA_STRING = "witness_arg";
+export declare const WITNESS_RESULT_METADATA_STRING = "witness_result";
+//# sourceMappingURL=witness-constants.d.mts.map

package/dist/witness/witness-constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-constants.d.mts","sourceRoot":"","sources":["../../src/witness/witness-constants.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,gBAAgB,CAAC;AACzD,eAAO,MAAM,8BAA8B,mBAAmB,CAAC"}

package/dist/witness/witness-constants.mjs

@@ -0,0 +1,3 @@
+export const WITNESS_ARG_METADATA_STRING = 'witness_arg';
+export const WITNESS_RESULT_METADATA_STRING = 'witness_result';
+//# sourceMappingURL=witness-constants.mjs.map

package/dist/witness/witness-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-constants.mjs","sourceRoot":"","sources":["../../src/witness/witness-constants.mts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,aAAa,CAAC;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,gBAAgB,CAAC"}

package/dist/witness/witness-form-builder.d.mts

@@ -0,0 +1,45 @@
+import { DynamicFormBuilder } from '../common/form/form-helper.mjs';
+import { WitnessData_V1 } from '../witness/witness-types.mjs';
+/**
+ * Fluent-style builder helper class.
+ *
+ * I'm making this to share common fields' settings among witness classes.
+ *
+ * Descend from this class for sharing other commonalities.
+ */
+export declare class WitnessFormBuilder extends DynamicFormBuilder {
+    protected lc: string;
+    allowPrimitiveArgs({ of, required, }: {
+        of: boolean | undefined;
+        required?: boolean;
+    }): WitnessFormBuilder;
+    catchAllErrors({ of, required, }: {
+        of: boolean | undefined;
+        required?: boolean;
+    }): WitnessFormBuilder;
+    persistOptsAndResultIbGibs({ of, required, }: {
+        of: boolean | undefined;
+        required?: boolean;
+    }): WitnessFormBuilder;
+    trace({ of, required, }: {
+        of: boolean | undefined;
+        required?: boolean;
+    }): WitnessFormBuilder;
+    /**
+     * Includes common witness fields.
+     *
+     * All common fields default to `true`, so set any you want to skip to
+     * `false`.
+     *
+     * @returns `this` for fluent builder
+     */
+    commonWitnessFields({ data, allowPrimitiveArgs, catchAllErrors, persistOptsAndResultIbGibs, trace, version, }: {
+        data: WitnessData_V1;
+        allowPrimitiveArgs?: boolean;
+        catchAllErrors?: boolean;
+        persistOptsAndResultIbGibs?: boolean;
+        trace?: boolean;
+        version?: boolean;
+    }): WitnessFormBuilder;
+}
+//# sourceMappingURL=witness-form-builder.d.mts.map

package/dist/witness/witness-form-builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-form-builder.d.mts","sourceRoot":"","sources":["../../src/witness/witness-form-builder.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI9D;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,kBAAkB;IACtD,SAAS,CAAC,EAAE,EAAE,MAAM,CAAkC;IAEtD,kBAAkB,CAAC,EACf,EAAE,EACF,QAAe,GAClB,EAAE;QACC,EAAE,EAAE,OAAO,GAAG,SAAS,CAAC;QACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,kBAAkB;IActB,cAAc,CAAC,EACX,EAAE,EACF,QAAe,GAClB,EAAE;QACC,EAAE,EAAE,OAAO,GAAG,SAAS,CAAC;QACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,kBAAkB;IActB,0BAA0B,CAAC,EACvB,EAAE,EACF,QAAe,GAClB,EAAE;QACC,EAAE,EAAE,OAAO,GAAG,SAAS,CAAC;QACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,kBAAkB;IActB,KAAK,CAAC,EACF,EAAE,EACF,QAAQ,GACX,EAAE;QACC,EAAE,EAAE,OAAO,GAAG,SAAS,CAAC;QACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,kBAAkB;IActB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAChB,IAAI,EACJ,kBAAyB,EACzB,cAAqB,EACrB,0BAAiC,EACjC,KAAY,EACZ,OAAc,GACjB,EAAE;QACC,IAAI,EAAE,cAAc,CAAC;QACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,0BAA0B,CAAC,EAAE,OAAO,CAAC;QACrC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,kBAAkB;CASzB"}