@ibgib/core-gib 0.0.52 → 0.0.53

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

@@ -11,6 +11,14 @@ export declare const MAX_ENCRYPTION_PASSWORD_LENGTH = 9999999;
 export declare const DEFAULT_ENCRYPTION_SALT_STRATEGY: SaltStrategy;
 export declare const DEFAULT_ENCRYPTION_RECURSIONS_PER_HASH = 10;
 export declare const DEFAULT_ENCRYPTION_HASH_ALGORITHM = "SHA-256";
+/**
+ * atom at the start of encryption ibgibs' `ib`.
+ */
+export declare const ENCRYPTION_ATOM = "encryption";
+/**
+ * default regexp for a simple name string.
+ */
+export declare const ENCRYPTION_NAME_REGEXP: RegExp;
 /**
  * An encryptions ibgib uses this rel8n name for its children encryptions.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"encrypt-constants.d.mts","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-constants.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,eAAO,MAAM,qCAAqC,QAAQ,CAAC;AAC3D,eAAO,MAAM,iCAAiC,OAAO,CAAC;AACtD,eAAO,MAAM,iCAAiC,WAAW,CAAC;AAC1D,eAAO,MAAM,kCAAkC,IAAI,CAAC;AACpD,eAAO,MAAM,kCAAkC,OAAO,CAAC;AACvD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAChD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,8BAA8B,UAAU,CAAC;AACtD,eAAO,MAAM,gCAAgC,EAAE,YAAyC,CAAC;AACzF,eAAO,MAAM,sCAAsC,KAAK,CAAC;AACzD,eAAO,MAAM,iCAAiC,YAAY,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAClD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAC"}
+{"version":3,"file":"encrypt-constants.d.mts","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-constants.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,eAAO,MAAM,qCAAqC,QAAQ,CAAC;AAC3D,eAAO,MAAM,iCAAiC,OAAO,CAAC;AACtD,eAAO,MAAM,iCAAiC,WAAW,CAAC;AAC1D,eAAO,MAAM,kCAAkC,IAAI,CAAC;AACpD,eAAO,MAAM,kCAAkC,OAAO,CAAC;AACvD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAChD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,8BAA8B,UAAU,CAAC;AACtD,eAAO,MAAM,gCAAgC,EAAE,YAAyC,CAAC;AACzF,eAAO,MAAM,sCAAsC,KAAK,CAAC;AACzD,eAAO,MAAM,iCAAiC,YAAY,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAA6B,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAClD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAC"}

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

@@ -11,6 +11,14 @@ export const MAX_ENCRYPTION_PASSWORD_LENGTH = 9999999;
 export const DEFAULT_ENCRYPTION_SALT_STRATEGY = SaltStrategy.appendPerHash;
 export const DEFAULT_ENCRYPTION_RECURSIONS_PER_HASH = 10;
 export const DEFAULT_ENCRYPTION_HASH_ALGORITHM = 'SHA-256';
+/**
+ * atom at the start of encryption ibgibs' `ib`.
+ */
+export const ENCRYPTION_ATOM = 'encryption';
+/**
+ * default regexp for a simple name string.
+ */
+export const ENCRYPTION_NAME_REGEXP = /^[a-zA-Z0-9_\-.]{1,255}$/;
 /**
  * An encryptions ibgib uses this rel8n name for its children encryptions.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"encrypt-constants.mjs","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-constants.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,MAAM,CAAC,MAAM,qCAAqC,GAAG,KAAK,CAAC;AAC3D,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,CAAC;AACtD,MAAM,CAAC,MAAM,iCAAiC,GAAG,QAAQ,CAAC;AAC1D,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,CAAC;AACvD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAChD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC;AACtD,MAAM,CAAC,MAAM,gCAAgC,GAAiB,YAAY,CAAC,aAAa,CAAC;AACzF,MAAM,CAAC,MAAM,sCAAsC,GAAG,EAAE,CAAC;AACzD,MAAM,CAAC,MAAM,iCAAiC,GAAG,SAAS,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAClD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC"}
+{"version":3,"file":"encrypt-constants.mjs","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-constants.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,MAAM,CAAC,MAAM,qCAAqC,GAAG,KAAK,CAAC;AAC3D,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,CAAC;AACtD,MAAM,CAAC,MAAM,iCAAiC,GAAG,QAAQ,CAAC;AAC1D,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,CAAC;AACvD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAChD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC;AACtD,MAAM,CAAC,MAAM,gCAAgC,GAAiB,YAAY,CAAC,aAAa,CAAC;AACzF,MAAM,CAAC,MAAM,sCAAsC,GAAG,EAAE,CAAC;AACzD,MAAM,CAAC,MAAM,iCAAiC,GAAG,SAAS,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAClD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC"}

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

@@ -1,2 +1,45 @@
-export {};
+/**
+ * @module encrypt helper/util/etc. functions
+ *
+ * this is where you will find helper functions like those that generate
+ * and parse ibs for encryption ibgibs.
+ */
+import { Ib } from '@ibgib/ts-gib/dist/types.mjs';
+import { EncryptionData_V1, EncryptionIbGib_V1, EncryptionInfo, EncryptionMethod } from './encrypt-types.mjs';
+import { MetaspaceService } from "../../witness/space/metaspace/metaspace-types.mjs";
+import { IbGibSpaceAny } from "../../witness/space/space-base-v1.mjs";
+export declare function validateCommonEncryptionData({ data, }: {
+    data?: EncryptionData_V1;
+}): string[];
+export declare function validateCommonEncryptionIbGib({ ibGib, }: {
+    ibGib: EncryptionIbGib_V1;
+}): Promise<string[] | undefined>;
+/**
+ * builds the ib based on data.
+ *
+ * atow (02/2024) this is only data.name and data.method.
+ *
+ * @returns `${ENCRYPTION_ATOM} ${method} ${name}` atow (02/2024)
+ */
+export declare function getEncryptionIb({ data, }: {
+    data: EncryptionData_V1;
+}): Ib;
+/**
+ * Current schema is `${ENCRYPTION_ATOM} ${method} ${name}`
+ *
+ * NOTE this is space-delimited
+ */
+export declare function parseEncryptionIb({ ib, }: {
+    ib: Ib;
+}): {
+    atom: string;
+    method: string;
+    name: string;
+};
+export declare function createAndRegisterNewEncryption({ encryptionMethod, encryptionInfo, metaspace, space, }: {
+    encryptionMethod: EncryptionMethod;
+    encryptionInfo: EncryptionInfo;
+    metaspace: MetaspaceService;
+    space: IbGibSpaceAny;
+}): Promise<EncryptionIbGib_V1>;
 //# sourceMappingURL=encrypt-helper.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"encrypt-helper.d.mts","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-helper.mts"],"names":[],"mappings":""}
+{"version":3,"file":"encrypt-helper.d.mts","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-helper.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,EAAE,EAAE,EAAG,MAAM,8BAA8B,CAAC;AAKnD,OAAO,EACH,iBAAiB,EAAE,kBAAkB,EACrC,cAAc,EAA6B,gBAAgB,EAE9D,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAStE,wBAAgB,4BAA4B,CAAC,EACzC,IAAI,GACP,EAAE;IACC,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC5B,GAAG,MAAM,EAAE,CAgDX;AAiED,wBAAsB,6BAA6B,CAAC,EAChD,KAAK,GACR,EAAE;IACC,KAAK,EAAE,kBAAkB,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CA+BhC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC5B,IAAI,GACP,EAAE;IACC,IAAI,EAAE,iBAAiB,CAAC;CAC3B,GAAG,EAAE,CAaL;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAC9B,EAAE,GACL,EAAE;IACC,EAAE,EAAE,EAAE,CAAC;CACV,GAAG;IACA,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB,CAkBA;AAGD,wBAAsB,8BAA8B,CAAC,EACjD,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,KAAK,GACR,EAAE;IACC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsB9B"}

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

@@ -1,2 +1,309 @@
-export {};
+/**
+ * @module encrypt helper/util/etc. functions
+ *
+ * this is where you will find helper functions like those that generate
+ * and parse ibs for encryption ibgibs.
+ */
+// import * as pathUtils from 'path';
+// import { statSync } from 'node:fs';
+// import { readFile, } from 'node:fs/promises';
+// import * as readline from 'node:readline/promises';
+// import { stdin, stdout } from 'node:process'; // decide if use this or not
+import { extractErrorMsg, } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { CLASSNAME_REGEXP, UUID_REGEXP, } from '@ibgib/helper-gib/dist/constants.mjs';
+import { HASH_ALGORITHMS, SALT_STRATEGIES } from '@ibgib/encrypt-gib/dist/types.mjs';
+import { validateIbGibIntrinsically } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
+import { Factory_V1 } from "@ibgib/ts-gib/dist/V1/factory.mjs";
+import { GLOBAL_LOG_A_LOT } from "../../core-constants.mjs";
+import { EncryptionMethod, VALID_ENCRYPTION_METHODS, } from './encrypt-types.mjs';
+import { ENCRYPTION_REL8N_NAME, ENCRYPTION_ATOM, ENCRYPTION_NAME_REGEXP, } from './encrypt-constants.mjs';
+import { SpecialIbGibType } from '../other/other-types.mjs';
+/**
+ * for verbose logging
+ */
+const logalot = GLOBAL_LOG_A_LOT;
+export function validateCommonEncryptionData({ data, }) {
+    const lc = `[${validateCommonEncryptionData.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting...`);
+        }
+        if (!data) {
+            throw new Error(`data required (E: )`);
+        }
+        const errors = [];
+        const { name, uuid, classname, method, } = data;
+        if (name) {
+            if (!name.match(ENCRYPTION_NAME_REGEXP)) {
+                errors.push(`name must match regexp: ${ENCRYPTION_NAME_REGEXP} (E: )`);
+            }
+        }
+        else {
+            errors.push(`name required. (E: )`);
+        }
+        if (method) {
+            if (!VALID_ENCRYPTION_METHODS.includes(method)) {
+                errors.push(`method (${method}) is invalid. must be one of ${VALID_ENCRYPTION_METHODS.join(', ')} (E: )`);
+            }
+        }
+        else {
+            errors.push(`method required. (E: )`);
+        }
+        if (uuid) {
+            if (!uuid.match(UUID_REGEXP)) {
+                errors.push(`uuid must match regexp: ${UUID_REGEXP} (E: )`);
+            }
+        }
+        if (classname) {
+            if (!classname.match(CLASSNAME_REGEXP)) {
+                errors.push(`classname must match regexp: ${CLASSNAME_REGEXP} (E: )`);
+            }
+        }
+        if (method === EncryptionMethod.encrypt_gib_weak) {
+            const encryptGibErrors = validateCommonEncryptionData_encryptGib({ data });
+            encryptGibErrors.forEach(x => errors.push(x));
+        }
+        return errors;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+function validateCommonEncryptionData_encryptGib({ data, }) {
+    const lc = `[${validateCommonEncryptionData_encryptGib.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 2da8272bd687b2c488a4af0c592b1524)`);
+        }
+        const errors = [];
+        if (data.encryptedDataDelimiter) {
+            if (typeof data.encryptedDataDelimiter !== 'string') {
+                errors.push(`encryptedDataDelimiter must be string (E: fcd4f6b27a084b219244cfbab641f840)`);
+            }
+        }
+        if (data.hashAlgorithm) {
+            if (!HASH_ALGORITHMS.includes(data.hashAlgorithm)) {
+                errors.push(`invalid hashAlgorithm (${data.hashAlgorithm}). must be one of ${HASH_ALGORITHMS}. (E: 5f7a75b2d1164e07b10a78adc155774a)`);
+            }
+        }
+        if (data.initialRecursions) {
+            if (typeof data.initialRecursions !== 'number') {
+                errors.push(`invalid initialRecursions (${data.initialRecursions}, typeof: ${typeof data.initialRecursions}). must be type "number" (E: 03c3f5fae9fe48bf92bb82ec806fa293)`);
+            }
+            else if (data.initialRecursions < 0) {
+                errors.push(`invalid dataRecursions (${data.initialRecursions}). must be positive integer or 0. (E: a12658e792c8448a9b31d8e0b001a1b2)`);
+            }
+        }
+        else {
+            errors.push(`initialRecursions required. (E: bb14b31042074f9aad4ed8fc08846c62)`);
+        }
+        if (data.recursionsPerHash) {
+            if (typeof data.recursionsPerHash !== 'number') {
+                errors.push(`invalid recursionsPerHash (${data.recursionsPerHash}, typeof: ${typeof data.recursionsPerHash}). must be type "number" (E: b373d88bf22043408c1da42df9902211)`);
+            }
+            else if (data.recursionsPerHash <= 0) {
+                errors.push(`invalid recursionsPerHash (${data.recursionsPerHash}). must be positive integer. (E: 7eec3ccd22ed4bbf96c06479e2de02b7)`);
+            }
+        }
+        if (data.salt) {
+            if (typeof data.salt !== 'string') {
+                errors.push(`invalid salt (${data.salt}, typeof: ${typeof data.salt}). must be "string". (E: 0bee1f049dfd4f6e937cd423bb1b0c90)`);
+            }
+        }
+        else {
+            errors.push(`salt required. (E: 7ee8e2a760184999b13e7966a8057b2b)`);
+        }
+        if (data.saltStrategy) {
+            if (!SALT_STRATEGIES.includes(data.saltStrategy)) {
+                errors.push(`invalid saltStrategy (${data.saltStrategy}). must be one of ${SALT_STRATEGIES}. (E: 7da81150e5144c448876e950e373e7e5)`);
+            }
+        }
+        return errors;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+export async function validateCommonEncryptionIbGib({ ibGib, }) {
+    const lc = `[${validateCommonEncryptionIbGib.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: )`);
+        }
+        const intrinsicErrors = await validateIbGibIntrinsically({ ibGib: ibGib }) ?? [];
+        if (!ibGib.data) {
+            throw new Error(`EncryptionIbGib.data required (E: )`);
+        }
+        const ibErrors = [];
+        // ib
+        let { atom, method, name, } = parseEncryptionIb({ ib: ibGib.ib });
+        if (atom !== ENCRYPTION_ATOM) {
+            ibErrors.push(`invalid encryption atom. must be ${ENCRYPTION_ATOM} (E: )`);
+        }
+        if (!method) {
+            ibErrors.push(`encryption method required (E: )`);
+        }
+        if (!name) {
+            ibErrors.push(`encryption name required (E: )`);
+        }
+        // data
+        const dataErrors = validateCommonEncryptionData({ data: ibGib.data });
+        let result = [...(intrinsicErrors ?? []), ...(ibErrors ?? []), ...(dataErrors ?? [])];
+        if (result.length > 0) {
+            return result;
+        }
+        else {
+            return undefined;
+        }
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+/**
+ * builds the ib based on data.
+ *
+ * atow (02/2024) this is only data.name and data.method.
+ *
+ * @returns `${ENCRYPTION_ATOM} ${method} ${name}` atow (02/2024)
+ */
+export function getEncryptionIb({ data, }) {
+    const lc = `[${getEncryptionIb.name}]`;
+    try {
+        const validationErrors = validateCommonEncryptionData({ data });
+        if (validationErrors.length > 0) {
+            throw new Error(`invalid Encryption data: ${validationErrors} (E: )`);
+        }
+        const { name, method } = data;
+        return `${ENCRYPTION_ATOM} ${method} ${name}`;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+/**
+ * Current schema is `${ENCRYPTION_ATOM} ${method} ${name}`
+ *
+ * NOTE this is space-delimited
+ */
+export function parseEncryptionIb({ ib, }) {
+    const lc = `[${parseEncryptionIb.name}]`;
+    try {
+        if (!ib) {
+            throw new Error(`Encryption ib required (E: )`);
+        }
+        const [atom, method, name] = ib.split(' ');
+        if (atom !== ENCRYPTION_ATOM) {
+            throw new Error(`atom !== ${ENCRYPTION_ATOM} (E: )`);
+        }
+        if (method !== EncryptionMethod.encrypt_gib_weak) {
+            console.warn(`${lc} method !== EncryptionMethod.encrypt_gib_weak. atow (02/2024) .ncrypt_gib_weak is the only thing we got. (W: )`);
+        }
+        if (!name.match(ENCRYPTION_NAME_REGEXP)) {
+            throw new Error(`!name.match(ENCRYPTION_NAME_REGEXP) (E: )`);
+        }
+        return { atom, method, name, };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+export async function createAndRegisterNewEncryption({ encryptionMethod, encryptionInfo, metaspace, space, }) {
+    const lc = `[${createAndRegisterNewEncryption.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: )`);
+        }
+        let resEncryptionIbGib;
+        if (encryptionMethod !== EncryptionMethod.encrypt_gib_weak) {
+            throw new Error(`unknown encryptionMethod (${encryptionMethod}). only "encrypt-gib" encryption method currently implemented. (E: )`);
+        }
+        resEncryptionIbGib = await createAndRegisterNewEncryption_encryptGib({
+            encryptionInfo: encryptionInfo,
+            metaspace,
+            space,
+        });
+        return resEncryptionIbGib;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+async function createAndRegisterNewEncryption_encryptGib({ encryptionInfo, metaspace, space, }) {
+    const lc = `[${createAndRegisterNewEncryption_encryptGib.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: )`);
+        }
+        const { method: encryptionMethod } = encryptionInfo;
+        if (encryptionMethod !== 'encrypt-gib (weak)') {
+            throw new Error(`(UNEXPECTED) encryptionMethod !== 'encrypt-gib (weak)'? (E: )`);
+        }
+        // create the encryption ibgib
+        const data = {
+            ...encryptionInfo,
+        };
+        const resFirstGen = await Factory_V1.firstGen({
+            ib: getEncryptionIb({ data }),
+            parentIbGib: Factory_V1.primitive({ ib: ENCRYPTION_ATOM }),
+            data,
+            dna: true,
+            nCounter: true,
+            tjp: { timestamp: true, },
+        });
+        const encryptionIbGib = resFirstGen.newIbGib;
+        // validate right away before anything else
+        const validationErrors = await validateCommonEncryptionIbGib({ ibGib: encryptionIbGib }) ?? [];
+        if (validationErrors.length > 0) {
+            throw new Error(`(UNEXPECTED) newly created encryptionIbGib has validationErrors? validationErrors: ${validationErrors} (E: )`);
+        }
+        // save first in the space...
+        await metaspace.persistTransformResult({ resTransform: resFirstGen, space });
+        // register the new encryption with the ibgib space in general...
+        await metaspace.registerNewIbGib({ ibGib: encryptionIbGib, space });
+        // register the new encryption with the encryptions index
+        await metaspace.rel8ToSpecialIbGib({
+            type: SpecialIbGibType.encryptions,
+            rel8nName: ENCRYPTION_REL8N_NAME,
+            ibGibsToRel8: [encryptionIbGib],
+            space,
+        });
+        return encryptionIbGib;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
 //# sourceMappingURL=encrypt-helper.mjs.map

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

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

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

@@ -1,20 +1,39 @@
 import { HashAlgorithm } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { IbGibData_V1, IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
 import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
 import { SaltStrategy } from '@ibgib/encrypt-gib/dist/types.mjs';
 import { ENCRYPTION_REL8N_NAME } from './encrypt-constants.mjs';
-export interface EncryptionInfo {
-    name: string;
-    description?: string;
-    method: EncryptionMethod;
-}
 export type EncryptionMethod = 'encrypt-gib (weak)';
+/**
+ * Discriminator for the algorithm used in encryption that specifies the
+ * algorithm used in encryption.
+ *
+ * The value of this will decide which descending encryption interface is used
+ * that specifies parameters specific to this method.
+ */
 export declare const EncryptionMethod: {
+    /**
+     * custom probably very weak algorithm that uses indexing into a recursive
+     * hash-based rounding function instead of keystream generation.
+     */
     encrypt_gib_weak: "encrypt-gib (weak)";
 };
+export declare const VALID_ENCRYPTION_METHODS: "encrypt-gib (weak)"[];
+/**
+ * Encryption-specific information that will form the {@link EncryptionData_V1}
+ * shape. If you examine that interface, you'll see that it is this type
+ */
 export interface EncryptionInfo {
+    name: string;
+    description?: string;
+    /**
+     * @see {@link EncryptionMethod}
+     */
     method: EncryptionMethod;
 }
+/**
+ * Parameter information that is specific to the encrypt-gib algorithm.
+ */
 export interface EncryptionInfo_EncryptGib extends EncryptionInfo {
     method: 'encrypt-gib (weak)';
     /**
@@ -52,11 +71,19 @@ export interface EncryptionInfo_EncryptGib extends EncryptionInfo {
      */
     encryptedDataDelimiter?: string;
 }
-export type EncryptionData_V1 = EncryptionInfo_EncryptGib;
+/**
+ * @see {@link EncryptionIbGib_V1}
+ */
+export type EncryptionData_V1 = IbGibData_V1 & EncryptionInfo & (EncryptionInfo_EncryptGib);
+/**
+ * @see {@link EncryptionIbGib_V1}
+ */
 export interface EncryptionRel8ns_V1 extends IbGibRel8ns_V1 {
 }
 /**
- * IbGib that represents encryption settings
+ * IbGib that represents encryption settings.
+ *
+ * This determines the {@link EncryptionMethod}
  */
 export interface EncryptionIbGib_V1 extends IbGib_V1<EncryptionData_V1, EncryptionRel8ns_V1> {
 }

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

@@ -1 +1 @@
-{"version":3,"file":"encrypt-types.d.mts","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAG,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,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,kBAAmB,SAAQ,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;CAAI;AAEhG;;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"}
+{"version":3,"file":"encrypt-types.d.mts","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,SAAS,EAAG,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AACpD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;IACzB;;;OAGG;;CAEN,CAAA;AACD,eAAO,MAAM,wBAAwB,wBAAkC,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,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;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,cAAc,GAAG,CAC5D,yBAAyB,CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;CAAI;AAE/D;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;CAAI;AAEhG;;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

@@ -1,5 +1,17 @@
 import { ENCRYPTION_REL8N_NAME } from './encrypt-constants.mjs';
+/**
+ * Discriminator for the algorithm used in encryption that specifies the
+ * algorithm used in encryption.
+ *
+ * The value of this will decide which descending encryption interface is used
+ * that specifies parameters specific to this method.
+ */
 export const EncryptionMethod = {
+    /**
+     * custom probably very weak algorithm that uses indexing into a recursive
+     * hash-based rounding function instead of keystream generation.
+     */
     encrypt_gib_weak: 'encrypt-gib (weak)',
 };
+export const VALID_ENCRYPTION_METHODS = Object.values(EncryptionMethod);
 //# sourceMappingURL=encrypt-types.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"encrypt-types.mjs","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-types.mts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAWhE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,gBAAgB,EAAE,oBAAwC;CAC7D,CAAA"}
+{"version":3,"file":"encrypt-types.mjs","sourceRoot":"","sources":["../../../src/common/encrypt/encrypt-types.mts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAKhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B;;;OAGG;IACH,gBAAgB,EAAE,oBAAwC;CAC7D,CAAA;AACD,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"secret-helper.d.mts","sourceRoot":"","sources":["../../../src/common/secret/secret-helper.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAEmC,aAAa,EACtD,MAAM,iDAAiD,CAAC;AAGzD,OAAO,EAAE,EAAE,EAAG,MAAM,8BAA8B,CAAC;AAKnD,OAAO,EAAE,kCAAkC,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAuB,UAAU,EAAuB,MAAM,oBAAoB,CAAC;AAEzK,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAUtE,wBAAgB,wBAAwB,CAAC,EACrC,IAAI,GACP,EAAE;IACC,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,GAAG,MAAM,EAAE,CA6DX;AAED,wBAAsB,yBAAyB,CAAC,EAC5C,KAAK,GACR,EAAE;IACC,KAAK,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CA+BhC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EACxB,IAAI,GACP,EAAE;IACC,IAAI,EAAE,aAAa,CAAC;CACvB,GAAG,EAAE,CAaL;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAC1B,EAAE,GACL,EAAE;IACC,EAAE,EAAE,EAAE,CAAC;CACV,GAAG;IACA,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB,CAkBA;AAGD,wBAAsB,0BAA0B,CAAC,EAC7C,UAAU,EACV,UAAU,EACV,SAAS,EACT,KAAK,GACR,EAAE;IACC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuB1B;AAiED;;;;;;;;;;;GAWG;AACH,wBAAsB,qCAAqC,CAAC,EACxD,QAAQ,EACR,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,SAAS,GACZ,EAAE;IACC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC;IACzB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAqD9C;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,EAC1C,QAAQ,EACR,SAAS,GACZ,EAAE;IACC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,kCAAkC,CAAC;CACjD,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBnB"}
+{"version":3,"file":"secret-helper.d.mts","sourceRoot":"","sources":["../../../src/common/secret/secret-helper.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAEmC,aAAa,EACtD,MAAM,iDAAiD,CAAC;AAGzD,OAAO,EAAE,EAAE,EAAG,MAAM,8BAA8B,CAAC;AAKnD,OAAO,EAAE,kCAAkC,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAuB,UAAU,EAAuB,MAAM,oBAAoB,CAAC;AAEzK,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAUtE,wBAAgB,wBAAwB,CAAC,EACrC,IAAI,GACP,EAAE;IACC,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,GAAG,MAAM,EAAE,CA6DX;AAED,wBAAsB,yBAAyB,CAAC,EAC5C,KAAK,GACR,EAAE;IACC,KAAK,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CA+BhC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EACxB,IAAI,GACP,EAAE;IACC,IAAI,EAAE,aAAa,CAAC;CACvB,GAAG,EAAE,CAaL;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAC1B,EAAE,GACL,EAAE;IACC,EAAE,EAAE,EAAE,CAAC;CACV,GAAG;IACA,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB,CAkBA;AAGD,wBAAsB,0BAA0B,CAAC,EAC7C,UAAU,EACV,UAAU,EACV,SAAS,EACT,KAAK,GACR,EAAE;IACC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuB1B;AAiED;;;;;;;;;;;GAWG;AACH,wBAAsB,qCAAqC,CAAC,EACxD,QAAQ,EACR,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,SAAS,GACZ,EAAE;IACC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC;IACzB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAqD9C;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,EAC1C,QAAQ,EACR,SAAS,GACZ,EAAE;IACC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,kCAAkC,CAAC;CACjD,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBnB"}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/core-gib",
-  "version": "0.0.52",
+  "version": "0.0.53",
   "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.",
   "repository": {
     "url": "https://gitlab.com/ibgib/core-gib",

package/src/common/encrypt/encrypt-constants.mts

@@ -13,6 +13,16 @@ export const DEFAULT_ENCRYPTION_SALT_STRATEGY: SaltStrategy = SaltStrategy.appen
 export const DEFAULT_ENCRYPTION_RECURSIONS_PER_HASH = 10;
 export const DEFAULT_ENCRYPTION_HASH_ALGORITHM = 'SHA-256';
 
+/**
+ * atom at the start of encryption ibgibs' `ib`.
+ */
+export const ENCRYPTION_ATOM = 'encryption';
+
+/**
+ * default regexp for a simple name string.
+ */
+export const ENCRYPTION_NAME_REGEXP = /^[a-zA-Z0-9_\-.]{1,255}$/;
+
 /**
  * An encryptions ibgib uses this rel8n name for its children encryptions.
  */

package/src/common/encrypt/encrypt-helper.mts

@@ -0,0 +1,345 @@
+/**
+ * @module encrypt helper/util/etc. functions
+ *
+ * this is where you will find helper functions like those that generate
+ * and parse ibs for encryption ibgibs.
+ */
+
+// import * as pathUtils from 'path';
+// import { statSync } from 'node:fs';
+// import { readFile, } from 'node:fs/promises';
+// import * as readline from 'node:readline/promises';
+// import { stdin, stdout } from 'node:process'; // decide if use this or not
+
+import {
+    extractErrorMsg, delay, getSaferSubstring,
+    getTimestampInTicks, getUUID, pretty, HashAlgorithm, getTimestamp,
+} from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { CLASSNAME_REGEXP, UUID_REGEXP, } from '@ibgib/helper-gib/dist/constants.mjs';
+import { HASH_ALGORITHMS, SALT_STRATEGIES } from '@ibgib/encrypt-gib/dist/types.mjs';
+import { Ib, } from '@ibgib/ts-gib/dist/types.mjs';
+import { validateIbGibIntrinsically } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
+import { Factory_V1 } from "@ibgib/ts-gib/dist/V1/factory.mjs";
+
+import { GLOBAL_LOG_A_LOT } from "../../core-constants.mjs";
+import {
+    EncryptionData_V1, EncryptionIbGib_V1,
+    EncryptionInfo, EncryptionInfo_EncryptGib, EncryptionMethod,
+    VALID_ENCRYPTION_METHODS,
+} from './encrypt-types.mjs';
+import { ENCRYPTION_REL8N_NAME, ENCRYPTION_ATOM, ENCRYPTION_NAME_REGEXP, } from './encrypt-constants.mjs';
+import { MetaspaceService } from "../../witness/space/metaspace/metaspace-types.mjs";
+import { IbGibSpaceAny } from "../../witness/space/space-base-v1.mjs";
+import { SpecialIbGibType } from '../other/other-types.mjs';
+import { encrypt } from '@ibgib/encrypt-gib/dist/encrypt-decrypt.mjs';
+
+/**
+ * for verbose logging
+ */
+const logalot = GLOBAL_LOG_A_LOT;
+
+export function validateCommonEncryptionData({
+    data,
+}: {
+    data?: EncryptionData_V1,
+}): string[] {
+    const lc = `[${validateCommonEncryptionData.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting...`); }
+        if (!data) { throw new Error(`data required (E: )`); }
+        const errors: string[] = [];
+        const { name, uuid, classname, method, } = data;
+
+        if (name) {
+            if (!name.match(ENCRYPTION_NAME_REGEXP)) {
+                errors.push(`name must match regexp: ${ENCRYPTION_NAME_REGEXP} (E: )`);
+            }
+        } else {
+            errors.push(`name required. (E: )`);
+        }
+
+        if (method) {
+            if (!VALID_ENCRYPTION_METHODS.includes(method)) {
+                errors.push(`method (${method}) is invalid. must be one of ${VALID_ENCRYPTION_METHODS.join(', ')} (E: )`);
+            }
+        } else {
+            errors.push(`method required. (E: )`);
+        }
+
+        if (uuid) {
+            if (!uuid.match(UUID_REGEXP)) {
+                errors.push(`uuid must match regexp: ${UUID_REGEXP} (E: )`);
+            }
+        }
+
+        if (classname) {
+            if (!classname.match(CLASSNAME_REGEXP)) {
+                errors.push(`classname must match regexp: ${CLASSNAME_REGEXP} (E: )`);
+            }
+        }
+
+        if (method === EncryptionMethod.encrypt_gib_weak) {
+            const encryptGibErrors = validateCommonEncryptionData_encryptGib({ data });
+            encryptGibErrors.forEach(x => errors.push(x));
+        }
+
+        return errors;
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
+    }
+}
+
+function validateCommonEncryptionData_encryptGib({
+    data,
+}: {
+    data: EncryptionData_V1,
+}): string[] {
+    const lc = `[${validateCommonEncryptionData_encryptGib.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: 2da8272bd687b2c488a4af0c592b1524)`); }
+        const errors: string[] = [];
+
+        if (data.encryptedDataDelimiter) {
+            if (typeof data.encryptedDataDelimiter !== 'string') {
+                errors.push(`encryptedDataDelimiter must be string (E: fcd4f6b27a084b219244cfbab641f840)`);
+            }
+        }
+
+        if (data.hashAlgorithm) {
+            if (!HASH_ALGORITHMS.includes(data.hashAlgorithm)) {
+                errors.push(`invalid hashAlgorithm (${data.hashAlgorithm}). must be one of ${HASH_ALGORITHMS}. (E: 5f7a75b2d1164e07b10a78adc155774a)`);
+            }
+        }
+
+        if (data.initialRecursions) {
+            if (typeof data.initialRecursions !== 'number') {
+                errors.push(`invalid initialRecursions (${data.initialRecursions}, typeof: ${typeof data.initialRecursions}). must be type "number" (E: 03c3f5fae9fe48bf92bb82ec806fa293)`);
+            } else if (data.initialRecursions < 0) {
+                errors.push(`invalid dataRecursions (${data.initialRecursions}). must be positive integer or 0. (E: a12658e792c8448a9b31d8e0b001a1b2)`);
+            }
+        } else {
+            errors.push(`initialRecursions required. (E: bb14b31042074f9aad4ed8fc08846c62)`);
+        }
+
+        if (data.recursionsPerHash) {
+            if (typeof data.recursionsPerHash !== 'number') {
+                errors.push(`invalid recursionsPerHash (${data.recursionsPerHash}, typeof: ${typeof data.recursionsPerHash}). must be type "number" (E: b373d88bf22043408c1da42df9902211)`);
+            } else if (data.recursionsPerHash <= 0) {
+                errors.push(`invalid recursionsPerHash (${data.recursionsPerHash}). must be positive integer. (E: 7eec3ccd22ed4bbf96c06479e2de02b7)`);
+            }
+        }
+
+        if (data.salt) {
+            if (typeof data.salt !== 'string') {
+                errors.push(`invalid salt (${data.salt}, typeof: ${typeof data.salt}). must be "string". (E: 0bee1f049dfd4f6e937cd423bb1b0c90)`)
+            }
+        } else {
+            errors.push(`salt required. (E: 7ee8e2a760184999b13e7966a8057b2b)`)
+        }
+
+        if (data.saltStrategy) {
+            if (!SALT_STRATEGIES.includes(data.saltStrategy)) {
+                errors.push(`invalid saltStrategy (${data.saltStrategy}). must be one of ${SALT_STRATEGIES}. (E: 7da81150e5144c448876e950e373e7e5)`);
+            }
+        }
+
+        return errors;
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
+    }
+}
+
+export async function validateCommonEncryptionIbGib({
+    ibGib,
+}: {
+    ibGib: EncryptionIbGib_V1,
+}): Promise<string[] | undefined> {
+    const lc = `[${validateCommonEncryptionIbGib.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: )`); }
+        const intrinsicErrors: string[] = await validateIbGibIntrinsically({ ibGib: ibGib }) ?? [];
+
+        if (!ibGib.data) { throw new Error(`EncryptionIbGib.data required (E: )`); }
+        const ibErrors: string[] = [];
+
+        // ib
+        let { atom, method, name, } =
+            parseEncryptionIb({ ib: ibGib.ib });
+        if (atom !== ENCRYPTION_ATOM) { ibErrors.push(`invalid encryption atom. must be ${ENCRYPTION_ATOM} (E: )`); }
+        if (!method) { ibErrors.push(`encryption method required (E: )`); }
+        if (!name) { ibErrors.push(`encryption name required (E: )`); }
+
+        // data
+        const dataErrors = validateCommonEncryptionData({ data: ibGib.data });
+
+        let result = [...(intrinsicErrors ?? []), ...(ibErrors ?? []), ...(dataErrors ?? [])];
+        if (result.length > 0) {
+            return result;
+        } else {
+            return undefined;
+        }
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
+    }
+}
+
+/**
+ * builds the ib based on data.
+ *
+ * atow (02/2024) this is only data.name and data.method.
+ *
+ * @returns `${ENCRYPTION_ATOM} ${method} ${name}` atow (02/2024)
+ */
+export function getEncryptionIb({
+    data,
+}: {
+    data: EncryptionData_V1,
+}): Ib {
+    const lc = `[${getEncryptionIb.name}]`;
+    try {
+        const validationErrors = validateCommonEncryptionData({ data });
+        if (validationErrors.length > 0) { throw new Error(`invalid Encryption data: ${validationErrors} (E: )`); }
+
+        const { name, method } = data;
+
+        return `${ENCRYPTION_ATOM} ${method} ${name}`;
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+
+/**
+ * Current schema is `${ENCRYPTION_ATOM} ${method} ${name}`
+ *
+ * NOTE this is space-delimited
+ */
+export function parseEncryptionIb({
+    ib,
+}: {
+    ib: Ib,
+}): {
+    atom: string,
+    method: string,
+    name: string,
+} {
+    const lc = `[${parseEncryptionIb.name}]`;
+    try {
+        if (!ib) { throw new Error(`Encryption ib required (E: )`); }
+
+        const [atom, method, name] = ib.split(' ');
+
+        if (atom !== ENCRYPTION_ATOM) { throw new Error(`atom !== ${ENCRYPTION_ATOM} (E: )`); }
+
+        if (method !== EncryptionMethod.encrypt_gib_weak) { console.warn(`${lc} method !== EncryptionMethod.encrypt_gib_weak. atow (02/2024) .ncrypt_gib_weak is the only thing we got. (W: )`) }
+
+        if (!name.match(ENCRYPTION_NAME_REGEXP)) { throw new Error(`!name.match(ENCRYPTION_NAME_REGEXP) (E: )`); }
+
+        return { atom, method, name, };
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+
+
+export async function createAndRegisterNewEncryption({
+    encryptionMethod,
+    encryptionInfo,
+    metaspace,
+    space,
+}: {
+    encryptionMethod: EncryptionMethod,
+    encryptionInfo: EncryptionInfo,
+    metaspace: MetaspaceService,
+    space: IbGibSpaceAny,
+}): Promise<EncryptionIbGib_V1> {
+    const lc = `[${createAndRegisterNewEncryption.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: )`); }
+
+        let resEncryptionIbGib: EncryptionIbGib_V1;
+
+        if (encryptionMethod !== EncryptionMethod.encrypt_gib_weak) { throw new Error(`unknown encryptionMethod (${encryptionMethod}). only "encrypt-gib" encryption method currently implemented. (E: )`); }
+
+        resEncryptionIbGib = await createAndRegisterNewEncryption_encryptGib({
+            encryptionInfo: encryptionInfo as EncryptionInfo_EncryptGib,
+            metaspace,
+            space,
+        });
+
+        return resEncryptionIbGib;
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
+    }
+}
+
+async function createAndRegisterNewEncryption_encryptGib({
+    encryptionInfo,
+    metaspace,
+    space,
+}: {
+    encryptionInfo: EncryptionInfo_EncryptGib,
+    metaspace: MetaspaceService,
+    space: IbGibSpaceAny,
+}): Promise<EncryptionIbGib_V1> {
+    const lc = `[${createAndRegisterNewEncryption_encryptGib.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: )`); }
+
+        const { method: encryptionMethod } = encryptionInfo;
+        if (encryptionMethod !== 'encrypt-gib (weak)') { throw new Error(`(UNEXPECTED) encryptionMethod !== 'encrypt-gib (weak)'? (E: )`); }
+
+        // create the encryption ibgib
+        const data: EncryptionData_V1 = {
+            ...encryptionInfo,
+        };
+        const resFirstGen = await Factory_V1.firstGen({
+            ib: getEncryptionIb({ data }),
+            parentIbGib: Factory_V1.primitive({ ib: ENCRYPTION_ATOM }),
+            data,
+            dna: true,
+            nCounter: true,
+            tjp: { timestamp: true, },
+        });
+        const encryptionIbGib = resFirstGen.newIbGib as EncryptionIbGib_V1;
+
+        // validate right away before anything else
+        const validationErrors =
+            await validateCommonEncryptionIbGib({ ibGib: encryptionIbGib }) ?? [];
+        if (validationErrors.length > 0) { throw new Error(`(UNEXPECTED) newly created encryptionIbGib has validationErrors? validationErrors: ${validationErrors} (E: )`); }
+
+        // save first in the space...
+        await metaspace.persistTransformResult({ resTransform: resFirstGen, space });
+
+        // register the new encryption with the ibgib space in general...
+        await metaspace.registerNewIbGib({ ibGib: encryptionIbGib, space });
+
+        // register the new encryption with the encryptions index
+        await metaspace.rel8ToSpecialIbGib({
+            type: SpecialIbGibType.encryptions,
+            rel8nName: ENCRYPTION_REL8N_NAME,
+            ibGibsToRel8: [encryptionIbGib],
+            space,
+        });
+
+        return encryptionIbGib;
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete.`); }
+    }
+}

package/src/common/encrypt/encrypt-types.mts

@@ -1,5 +1,5 @@
 import { HashAlgorithm } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { IbGibData_V1, IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
 import { IbGibAddr, } from '@ibgib/ts-gib/dist/types.mjs';
 import { SaltStrategy } from '@ibgib/encrypt-gib/dist/types.mjs';
 
@@ -7,21 +7,39 @@ import { ENCRYPTION_REL8N_NAME } from './encrypt-constants.mjs';
 
 
 
-export interface EncryptionInfo {
-    name: string;
-    description?: string;
-    method: EncryptionMethod;
-}
-
 export type EncryptionMethod = 'encrypt-gib (weak)';
+/**
+ * Discriminator for the algorithm used in encryption that specifies the
+ * algorithm used in encryption.
+ *
+ * The value of this will decide which descending encryption interface is used
+ * that specifies parameters specific to this method.
+ */
 export const EncryptionMethod = {
+    /**
+     * custom probably very weak algorithm that uses indexing into a recursive
+     * hash-based rounding function instead of keystream generation.
+     */
     encrypt_gib_weak: 'encrypt-gib (weak)' as EncryptionMethod,
 }
+export const VALID_ENCRYPTION_METHODS = Object.values(EncryptionMethod);
 
+/**
+ * Encryption-specific information that will form the {@link EncryptionData_V1}
+ * shape. If you examine that interface, you'll see that it is this type
+ */
 export interface EncryptionInfo {
-    method: EncryptionMethod,
+    name: string;
+    description?: string;
+    /**
+     * @see {@link EncryptionMethod}
+     */
+    method: EncryptionMethod;
 }
 
+/**
+ * Parameter information that is specific to the encrypt-gib algorithm.
+ */
 export interface EncryptionInfo_EncryptGib extends EncryptionInfo {
     method: 'encrypt-gib (weak)'
     /**
@@ -60,12 +78,22 @@ export interface EncryptionInfo_EncryptGib extends EncryptionInfo {
     encryptedDataDelimiter?: string;
 }
 
-export type EncryptionData_V1 = EncryptionInfo_EncryptGib; // extend this with logical OR later
+/**
+ * @see {@link EncryptionIbGib_V1}
+ */
+export type EncryptionData_V1 = IbGibData_V1 & EncryptionInfo & (
+    EncryptionInfo_EncryptGib // extends this with logical OR of subtypes
+);
 
+/**
+ * @see {@link EncryptionIbGib_V1}
+ */
 export interface EncryptionRel8ns_V1 extends IbGibRel8ns_V1 { }
 
 /**
- * IbGib that represents encryption settings
+ * IbGib that represents encryption settings.
+ *
+ * This determines the {@link EncryptionMethod}
  */
 export interface EncryptionIbGib_V1 extends IbGib_V1<EncryptionData_V1, EncryptionRel8ns_V1> { }
 

package/src/common/secret/secret-helper.mts

@@ -5,8 +5,6 @@
  * and parse ibs for secret.
  */
 
-
-
 // import * as pathUtils from 'path';
 // import { statSync } from 'node:fs';
 // import { readFile, } from 'node:fs/promises';