@ibgib/core-gib 0.0.4

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

@@ -0,0 +1,116 @@
+import { IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
+import { IbGibAddr } from '@ibgib/ts-gib';
+import { HashAlgorithm } from '@ibgib/helper-gib';
+import { SaltStrategy } from '@ibgib/encrypt-gib';
+import { ENCRYPTION_REL8N_NAME } from './encrypt-constants.mjs';
+export type SecretType = "password";
+export declare const SecretType: {
+    password: "password";
+};
+export declare const VALID_SECRET_TYPES: "password"[];
+export interface SecretInfo {
+    name: string;
+    description?: string;
+    expirationUTC: string;
+    type: SecretType;
+}
+export interface SecretInfo_Password extends SecretInfo {
+    type: 'password';
+    /**
+     * We won't save the entire hash, just the hash.slice(16),
+     * because we are not checking to give authority, we are
+     * just checking to see if the user entered the same
+     * password for their own check.
+     *
+     * ## warnings
+     * NOTHING giving actual authorization should look at this.
+     */
+    hash16816_SHA256: string;
+    /**
+     * Public hint to help you remember your secret (or help the bad person
+     * attack your secret).
+     */
+    hint?: string;
+}
+export type SecretData_V1 = SecretInfo;
+export interface SecretRel8ns_V1 extends IbGibRel8ns_V1 {
+}
+export interface SecretIbGib_V1 extends IbGib_V1<SecretData_V1, SecretRel8ns_V1> {
+}
+export interface EncryptionInfo {
+    name: string;
+    description?: string;
+    method: EncryptionMethod;
+}
+export type EncryptionMethod = 'encrypt-gib (weak)';
+export declare const EncryptionMethod: {
+    encrypt_gib_weak: "encrypt-gib (weak)";
+};
+export interface EncryptionInfo {
+    method: EncryptionMethod;
+}
+export interface EncryptionInfo_EncryptGib extends EncryptionInfo {
+    method: 'encrypt-gib (weak)';
+    /**
+     * This is the algorithm that encrypt-gib will use in its
+     * internal hashing round function to encrypt the data.
+     */
+    hashAlgorithm: HashAlgorithm;
+    /**
+     * This is an initial number of recursions to perform to "get farther away"
+     * from the password. It is a one-time cost at the beginning of the
+     * entire encryption process, so it does not cost more with more data.
+     */
+    initialRecursions: number;
+    /**
+     * This is the number of internal hashes per round function, which is per
+     * hex character of data. So the more recursions here, the longer it is
+     * going to take to encrypt/decrypt.
+     */
+    recursionsPerHash?: number;
+    /**
+     * Salt used throughout hashing in encryption/decryption. The longer and
+     * more random, the better for security. But there is also a resource cost.
+     */
+    salt: string;
+    /**
+     * Stronger are the perHash options.
+     *
+     *    'prependPerHash' | 'appendPerHash' | 'initialPrepend' | 'initialAppend';
+     */
+    saltStrategy?: SaltStrategy;
+    /**
+     * The encrypted data is a delimited list of indices.
+     *
+     * @default "," (comma-delimited)
+     */
+    encryptedDataDelimiter?: string;
+}
+export type EncryptionData_V1 = EncryptionInfo_EncryptGib;
+export interface EncryptionRel8ns_V1 extends IbGibRel8ns_V1 {
+}
+/**
+ * IbGib that represents encryption settings
+ */
+export interface EncryptionIbGib extends IbGib_V1<EncryptionData_V1, EncryptionRel8ns_V1> {
+}
+/**
+ * Data for the actual encrypted ciphertext.
+ */
+export interface CiphertextData<TMetadata = any> {
+    ciphertext?: string;
+    metadata?: TMetadata;
+}
+/**
+ * Rel8ns for the actual encrypted ciphertext
+ */
+export interface CiphertextRel8ns extends IbGibRel8ns_V1 {
+    [ENCRYPTION_REL8N_NAME]?: IbGibAddr[];
+}
+/**
+ * Ibgib for the actual encrypted content, as opposed to the
+ * encryption secret (password) or encryption method/algorithm.
+ */
+export interface CiphertextIbGib_V1<TMetadata = any> extends IbGib_V1<CiphertextData<TMetadata>, CiphertextRel8ns> {
+}
+//# sourceMappingURL=encrypt-types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encrypt-types.d.mts","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAG,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AACpC,eAAO,MAAM,UAAU;;CAEtB,CAAA;AACD,eAAO,MAAM,kBAAkB,cAAqC,CAAC;AAErE,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACnD,IAAI,EAAE,UAAU,CAAC;IACjB;;;;;;;;OAQG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC;AAEvC,MAAM,WAAW,eAAgB,SAAQ,cAAc;CACtD;AAED,MAAM,WAAW,cAAe,SAAQ,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;CAC/E;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AACpD,eAAO,MAAM,gBAAgB;;CAE5B,CAAA;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,yBAA0B,SAAQ,cAAc;IAC7D,MAAM,EAAE,oBAAoB,CAAA;IAC5B;;;OAGG;IACH,aAAa,EAAE,aAAa,CAAC;IAC7B;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAE1D,MAAM,WAAW,mBAAoB,SAAQ,cAAc;CAAI;AAE/D;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;CAAI;AAE7F;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,SAAS,GAAG,GAAG;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD,CAAC,qBAAqB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,SAAS,GAAG,GAAG,CAC/C,SAAQ,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAChE"}

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

@@ -0,0 +1,9 @@
+import { ENCRYPTION_REL8N_NAME } from './encrypt-constants.mjs';
+export const SecretType = {
+    password: 'password',
+};
+export const VALID_SECRET_TYPES = Object.values(SecretType).concat();
+export const EncryptionMethod = {
+    encrypt_gib_weak: 'encrypt-gib (weak)',
+};
+//# sourceMappingURL=encrypt-types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encrypt-types.mjs","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-types.mts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,QAAQ,EAAE,UAAwB;CACrC,CAAA;AACD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC;AA0CrE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,gBAAgB,EAAE,oBAAwC;CAC7D,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Used in ErrorIbGib_V1.ib
+ */
+export declare const DEFAULT_ERROR_MSG_IB_SUBSTRING_LENGTH = 20;
+/**
+ * regexp for an error ibgib's (ErrorIbGib_V1) ib property.
+ */
+export declare const ERROR_IB_REGEXP: RegExp;
+//# sourceMappingURL=error-constants.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-constants.d.mts","sourceRoot":"","sources":["../../../src/common/error/error-constants.mts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,qCAAqC,KAAK,CAAC;AACxD;;GAEG;AACH,eAAO,MAAM,eAAe,QAA6C,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Used in ErrorIbGib_V1.ib
+ */
+export const DEFAULT_ERROR_MSG_IB_SUBSTRING_LENGTH = 20;
+/**
+ * regexp for an error ibgib's (ErrorIbGib_V1) ib property.
+ */
+export const ERROR_IB_REGEXP = /^error (\w+) ([a-fA-F\d]{32}|undefined)$/;
+//# sourceMappingURL=error-constants.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-constants.mjs","sourceRoot":"","sources":["../../../src/common/error/error-constants.mts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,CAAC;AACxD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,0CAA0C,CAAC"}

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

@@ -0,0 +1,43 @@
+import { Ib } from '@ibgib/ts-gib';
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
+import { ErrorData_V1, ErrorIbGib_V1 } from './error-types.mjs';
+/**
+ * Generates an ib based on a raw error msg.
+ *
+ * ## future
+ *
+ * If this is changed in the future, then without versioning of some sort, this
+ * will change the error constant ibgibs that rely on this functions
+ * deterministic qualities.
+ *
+ * @returns the error's `ib`
+ */
+export declare function getErrorIb({ rawMsg, }: {
+    rawMsg: string;
+}): Ib;
+/**
+ * Parses a raw error/exception message.
+ *
+ * If it has sections that I personally use (usually), then it will break that
+ * out. otherwise, it will just have the `rawMsg` as the msg body and raw msg.
+ *
+ * @see {@link ErrorData_V1}
+ */
+export declare function parseRawErrorMsg({ rawMsg, }: {
+    rawMsg: string;
+}): ErrorData_V1;
+/**
+ * Builds a "constant" error ibgib based on the given `rawMsg`.
+ *
+ * @returns constant error ibgib built from given `rawMsg`
+ *
+ * @see {@link ErrorData_V1}
+ * @see {@link ErrorIbGib_V1}
+ */
+export declare function errorIbGib({ rawMsg }: {
+    rawMsg: string;
+}): Promise<ErrorIbGib_V1>;
+export declare function isError({ ibGib }: {
+    ibGib: IbGib_V1;
+}): boolean;
+//# sourceMappingURL=error-helper.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-helper.d.mts","sourceRoot":"","sources":["../../../src/common/error/error-helper.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAkB,MAAM,mBAAmB,CAAC;AAQhF;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,EACvB,MAAM,GACT,EAAE;IACC,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,EAAE,CAwBL;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,EAC7B,MAAM,GACT,EAAE;IACC,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,YAAY,CA4Cf;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAiBjF;AAED,wBAAgB,OAAO,CAAC,EACpB,KAAK,EACR,EAAE;IACC,KAAK,EAAE,QAAQ,CAAA;CAClB,GAAG,OAAO,CAYV"}

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

@@ -0,0 +1,167 @@
+import { GLOBAL_LOG_A_LOT } from '../../core-constants.mjs';
+import { constantIbGib } from '../other/ibgib-helper.mjs';
+import { DEFAULT_ERROR_MSG_IB_SUBSTRING_LENGTH, ERROR_IB_REGEXP } from './error-constants.mjs';
+import { ERROR_MSG_LOCATION_ONLY_REGEXP, ERROR_MSG_WITH_ID_CAPTURE_GROUPS_REGEXP } from '@ibgib/helper-gib';
+const logalot = GLOBAL_LOG_A_LOT || false;
+/**
+ * Generates an ib based on a raw error msg.
+ *
+ * ## future
+ *
+ * If this is changed in the future, then without versioning of some sort, this
+ * will change the error constant ibgibs that rely on this functions
+ * deterministic qualities.
+ *
+ * @returns the error's `ib`
+ */
+export function getErrorIb({ rawMsg, }) {
+    const lc = `[${getErrorIb.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        const parsed = parseRawErrorMsg({ rawMsg });
+        const saferText = parsed.body.replace(/\s/g, '_').replace(/\W/g, '');
+        let msgSlice;
+        if (saferText.length > DEFAULT_ERROR_MSG_IB_SUBSTRING_LENGTH) {
+            msgSlice =
+                saferText.substring(0, DEFAULT_ERROR_MSG_IB_SUBSTRING_LENGTH);
+        }
+        else if (saferText.length > 0) {
+            msgSlice = saferText;
+        }
+        else {
+            // msg only has characters/nonalphanumerics ?
+            throw new Error(`(UNEXPECTED) error msg should have characters/alphanumerics... (E: a3b9cd11a44cc7892a748819c2885422)`);
+        }
+        return `error ${msgSlice} ${parsed.uuid ?? 'undefined'}`;
+    }
+    catch (error) {
+        console.error(`${lc} ${error.message}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+/**
+ * Parses a raw error/exception message.
+ *
+ * If it has sections that I personally use (usually), then it will break that
+ * out. otherwise, it will just have the `rawMsg` as the msg body and raw msg.
+ *
+ * @see {@link ErrorData_V1}
+ */
+export function parseRawErrorMsg({ rawMsg, }) {
+    const lc = `[${parseRawErrorMsg.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        if (!rawMsg) {
+            throw new Error(`(UNEXPECTED) rawMsg required (E: e5bd3b433a1781ebe885534cd2495622)`);
+        }
+        let data;
+        let regexResult = rawMsg.match(ERROR_MSG_WITH_ID_CAPTURE_GROUPS_REGEXP);
+        if (regexResult) {
+            // has id section
+            const [_, location, unexpectedAtStart, body, idSection, unexpectedAtEnd] = regexResult;
+            if (!body) {
+                throw new Error(`invalid error msg body (E: a675e6855cca96519d33d44ea5400922)`);
+            }
+            data = {
+                success: false,
+                raw: rawMsg,
+                body: body?.trim(),
+                uuid: idSection.slice(4, 36),
+            };
+            if (location) {
+                data.location = location;
+            }
+            if (unexpectedAtStart || unexpectedAtEnd) {
+                data.unexpected = true;
+            }
+        }
+        else {
+            // no id or unexpected regex (maybe changed?)
+            data = {
+                success: false,
+                raw: rawMsg,
+                body: rawMsg,
+            };
+            let regexResultLocation = rawMsg.match(ERROR_MSG_LOCATION_ONLY_REGEXP);
+            if (regexResultLocation) {
+                const [_, location] = regexResultLocation;
+                data.location = location;
+            }
+            if (rawMsg.toLowerCase().includes(`(unexpected)`)) {
+                data.unexpected = true;
+            }
+        }
+        return data;
+    }
+    catch (error) {
+        console.error(`${lc} ${error.message}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+/**
+ * Builds a "constant" error ibgib based on the given `rawMsg`.
+ *
+ * @returns constant error ibgib built from given `rawMsg`
+ *
+ * @see {@link ErrorData_V1}
+ * @see {@link ErrorIbGib_V1}
+ */
+export function errorIbGib({ rawMsg }) {
+    const lc = `[${errorIbGib.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        return constantIbGib({
+            parentPrimitiveIb: 'error',
+            ib: getErrorIb({ rawMsg }),
+            data: parseRawErrorMsg({ rawMsg }),
+            ibRegExpPattern: ERROR_IB_REGEXP.source,
+        });
+    }
+    catch (error) {
+        console.error(`${lc} ${error.message}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+export function isError({ ibGib }) {
+    const lc = `[${isError.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        if (!ibGib) {
+            throw new Error(`ibGib required (E: 1d756fbbd96f1734b97ba013537ed522)`);
+        }
+        return ibGib.ib.startsWith('error ');
+    }
+    catch (error) {
+        console.error(`${lc} ${error.message}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=error-helper.mjs.map

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

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

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

@@ -0,0 +1,58 @@
+import { IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
+/**
+ * I format my errors nowadays usually using an id and a possible (unexpected) flag.
+ * Sometimes I put the unexpected flag at the beginning, sometimes at the end.
+ */
+export interface ErrorData_V1 {
+    /**
+     * raw error message
+     */
+    raw: string;
+    /**
+     * I usually have lc's (log contexts) all over my code, if that isn't obvious or
+     * if you're not looking at the code. Anyway, I prepend error/info/warning msgs
+     * with the location like this:
+     *
+     * ```
+     * [MyClass][Foo] some error (E: hash123)
+     * ```
+     *
+     * So the bits in the brackets are the location. In this case, it's
+     * `[MyClass][Foo]` meaning in the function `Foo` on the class `MyClass`.
+     */
+    location?: string;
+    /**
+     * error message sans any metadata
+     */
+    body: string;
+    /**
+     * if the error is thrown more of an assertion, and it's an edge case just
+     * weird error, then I often add `"(UNEXPECTED)"` to the msg. This flag
+     * indicates that.
+     */
+    unexpected?: boolean;
+    /**
+     * I often include error ids.
+     */
+    uuid?: string;
+    /**
+     * All errors should have `errorIbGib.data.success` = false
+     */
+    success: false;
+}
+export interface ErrorRel8ns_V1 extends IbGibRel8ns_V1 {
+}
+/**
+ * Encapsulates data on errors that are thrown in this code base.
+ *
+ * ## driving intent
+ *
+ * I'm creating this for error constant ibgibs when I want to wrap an error
+ * message in an ibgib for whatever reason.
+ *
+ * Specifically I'm working on the random robbot and want the ability to return an error
+ * or add an error to a context ibgib.
+ */
+export interface ErrorIbGib_V1 extends IbGib_V1<ErrorData_V1, ErrorRel8ns_V1> {
+}
+//# sourceMappingURL=error-types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-types.d.mts","sourceRoot":"","sources":["../../../src/common/error/error-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;CAErD;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAc,SAAQ,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;CAE5E"}

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

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

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

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

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

@@ -0,0 +1,97 @@
+import { DynamicForm, FormItemInfo } from './form-items.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 DynamicFormBuilder {
+    protected lc: string;
+    protected items: FormItemInfo[];
+    protected what: string;
+    /**
+     * pool of uuids pre-calculated to be passed in to the builder. if this is
+     * falsy, then it will use a Math.random() based approach.
+     */
+    protected idPool: string[];
+    /**
+     * hacky wrapper for this.idPool.pop()
+     */
+    protected getNewId(): string;
+    /**
+     * Start fluent calls with this.
+     */
+    forA({ what, }: {
+        /**
+         * Common name for the reified concrete type of the witness.
+         *
+         * Used in things like placeholders, descriptions, etc.
+         *
+         * @example "robbot" or "space"
+         */
+        what: string;
+    }): DynamicFormBuilder;
+    protected addItem(item: FormItemInfo): void;
+    /**
+     * Empty function simply for more natural looking fluent syntax.
+     *
+     * You can override this for custom form builders that descend from this
+     * class.
+     *
+     * @returns this
+     */
+    with<T extends DynamicFormBuilder>({ idPool, }: {
+        /**
+         * pre-built pool of uuids to draw from. this builder
+         * will mutate this array.
+         */
+        idPool?: string[];
+    }): T;
+    /**
+     * I'm not a great fluent builder writer for TypeScript,
+     * and this function acts as a caster for which members of
+     * which concrete classes to expose for the proceeding builder lines.
+     *
+     *
+     * Basically, you use this to typecast the builder, possibly redundantly since
+     * I don't have any ordering implemented atow.
+     *
+     * @returns typecasted fluent builder
+     */
+    and<T extends DynamicFormBuilder>(): T;
+    name<T extends DynamicFormBuilder>({ of: value, required, }: {
+        of: string;
+        required?: boolean;
+    }): T;
+    description({ of: value, required, defaultValue, }: {
+        of: string;
+        required?: boolean;
+        defaultValue?: string;
+    }): DynamicFormBuilder;
+    classname({ of, required, }: {
+        of: string;
+        required?: boolean;
+    }): DynamicFormBuilder;
+    uuid({ of, label, required, }: {
+        of: string;
+        label?: string;
+        required?: boolean;
+    }): DynamicFormBuilder;
+    version({ of, required, }: {
+        of: string | undefined;
+        required?: boolean;
+    }): DynamicFormBuilder;
+    /**
+     * To pass in a completely customized item info.
+     *
+     * @returns `this` for fluent builder
+     */
+    customItem(item: FormItemInfo): DynamicFormBuilder;
+    outputItems(): FormItemInfo[];
+    outputForm({ formName, label, }: {
+        formName: string;
+        label?: string;
+    }): DynamicForm;
+}
+//# sourceMappingURL=form-helper.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-helper.d.mts","sourceRoot":"","sources":["../../../src/common/form/form-helper.mts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAK7D;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC3B,SAAS,CAAC,EAAE,EAAE,MAAM,CAAkC;IACtD,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,CAAM;IACrC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAM;IAC5B;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAEhC;;OAEG;IACH,SAAS,CAAC,QAAQ,IAAI,MAAM;IAmB5B;;OAEG;IACH,IAAI,CAAC,EACD,IAAI,GACP,EAAE;QACC;;;;;;WAMG;QACH,IAAI,EAAE,MAAM,CAAC;KAChB,GAAG,kBAAkB;IAKtB,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY;IAKpC;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,SAAS,kBAAkB,EAAE,EAC/B,MAAM,GACT,EAAE;QACC;;;WAGG;QACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,GAAG,CAAC;IAKL;;;;;;;;;;OAUG;IACH,GAAG,CAAC,CAAC,SAAS,kBAAkB,KAAK,CAAC;IAEtC,IAAI,CAAC,CAAC,SAAS,kBAAkB,EAAE,EAC/B,EAAE,EAAE,KAAK,EACT,QAAe,GAClB,EAAE;QACC,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,CAAC;IAgBL,WAAW,CAAC,EACR,EAAE,EAAE,KAAK,EACT,QAAQ,EACR,YAAY,GACf,EAAE;QACC,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,kBAAkB;IAkBtB,SAAS,CAAC,EACN,EAAE,EACF,QAAe,GAClB,EAAE;QACC,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,kBAAkB;IAiBtB,IAAI,CAAC,EACD,EAAE,EACF,KAAK,EACL,QAAQ,GACX,EAAE;QACC,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,kBAAkB;IAgBtB,OAAO,CAAC,EACJ,EAAE,EACF,QAAQ,GACX,EAAE;QACC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,kBAAkB;IActB;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,kBAAkB;IAMlD,WAAW,IAAI,YAAY,EAAE;IAI7B,UAAU,CAAC,EACP,QAAQ,EACR,KAAK,GACR,EAAE;QACC,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,WAAW;CASlB"}