@ibgib/web-gib 0.0.15 → 0.0.16

package/dist/keystone/keystone-helpers.mjs

@@ -1,155 +0,0 @@
-import { extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
-import { getIbAndGib } from "@ibgib/ts-gib/dist/helper.mjs";
-import { GLOBAL_LOG_A_LOT } from "../constants.mjs";
-import { KEYSTONE_ATOM } from "./keystone-constants.mjs";
-const logalot = GLOBAL_LOG_A_LOT;
-/**
- * space-delimited keystone ib containing select keystone metadata.
- *
- * NOTE: This must match {@link parseKeystoneIb}
- * @see {@link KeystoneIbInfo_V1}
- */
-export async function getKeystoneIb({ keystoneData, }) {
-    const lc = `[${getKeystoneIb.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting... (I: c3022a146faac9730154f34d1439a225)`);
-        }
-        const atom = KEYSTONE_ATOM;
-        const ib = [
-            atom,
-        ].join(' ');
-        return ib;
-    }
-    catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)}`);
-        throw error;
-    }
-    finally {
-        if (logalot) {
-            console.log(`${lc} complete.`);
-        }
-    }
-}
-/**
- * NOTE: This must match {@link getKeystoneIb}
- * @see {@link KeystoneIbInfo_V1}
- */
-export async function parseKeystoneIb({ ib, }) {
-    const lc = `[${parseKeystoneIb.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting... (I: 73cb6832984255ed48b2f44db6a21e25)`);
-        }
-        const [atom] = ib.split(' ');
-        if (atom !== KEYSTONE_ATOM) {
-            throw new Error(`invalid keystone ib. atom found in ib (${atom}) does not match keystone atom (${KEYSTONE_ATOM}) (E: 79b3d587824c4271b6e60acc76e0c825)`);
-        }
-        return {
-            atom,
-        };
-    }
-    catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)}`);
-        throw error;
-    }
-    finally {
-        if (logalot) {
-            console.log(`${lc} complete.`);
-        }
-    }
-}
-/**
- * The Policy Engine.
- * Calculates exactly which challenges MUST be consumed based on config and demands.
- * Enforces STRICT DISTINCTNESS (No double-dipping).
- */
-export function getDeterministicRequirements({ pool, requiredChallengeIds, targetAddr }) {
-    const behavior = pool.config.behavior;
-    const mandatory = new Set();
-    // Start with all available IDs.
-    // We assume Object.keys respects insertion order (ES2015+), crucial for FIFO.
-    let available = Object.keys(pool.challenges);
-    // ---------------------------------------------------------
-    // 1. Alice's Demands (Explicit Requirements)
-    // ---------------------------------------------------------
-    if (requiredChallengeIds && requiredChallengeIds.length > 0) {
-        for (const id of requiredChallengeIds) {
-            if (!pool.challenges[id]) {
-                throw new Error(`(UNEXPECTED) Required challenge ID not found in pool: ${id} (E: 2c9f8...)`);
-            }
-            // Strict: Consume it.
-            if (!available.includes(id)) {
-                // Should be caught by check above, but handles duplicates in 'demands'
-                continue;
-            }
-            mandatory.add(id);
-        }
-        // Remove from available pool
-        available = available.filter(id => !mandatory.has(id));
-    }
-    // ---------------------------------------------------------
-    // 2. Target Binding (Explicit Buckets)
-    // ---------------------------------------------------------
-    if (behavior.targetBindingChars > 0 && targetAddr) {
-        const { gib } = getIbAndGib({ ibGibAddr: targetAddr });
-        if (gib) {
-            // Get required hex prefixes (e.g. 'a', 'b', 'c', '1')
-            const prefixes = gib.substring(0, behavior.targetBindingChars).toLowerCase();
-            for (const char of prefixes) {
-                // Look in the Explicit Bucket
-                const bucket = pool.bindingMap[char] || [];
-                // Find the first ID in this bucket that is still in 'available'
-                const match = bucket.find(id => available.includes(id));
-                if (!match) {
-                    throw new Error(`Entropy Exhaustion. Cannot satisfy binding for char '${char}'. (E: 8d3a1...)`);
-                }
-                // Strict: Consume it.
-                mandatory.add(match);
-                available = available.filter(id => id !== match);
-            }
-        }
-    }
-    // ---------------------------------------------------------
-    // 3. FIFO (Sequential)
-    // ---------------------------------------------------------
-    if (behavior.selectSequentially > 0) {
-        // Take the first N from the remaining available list
-        if (available.length < behavior.selectSequentially) {
-            throw new Error(`Entropy Exhaustion. Insufficient challenges for FIFO requirement. (E: 9c2b4...)`);
-        }
-        const fifoIds = available.slice(0, behavior.selectSequentially);
-        fifoIds.forEach(id => mandatory.add(id));
-        // Remove from available
-        available = available.slice(behavior.selectSequentially);
-    }
-    return { mandatoryIds: mandatory, availableIds: available };
-}
-/**
- * Helper to update the Binding Map when adding new Challenge IDs.
- * Uses "Implicit Bucketing" (ID start char) but can be extended for full coverage.
- */
-export function addToBindingMap(map, challengeId) {
-    const firstChar = challengeId.charAt(0).toLowerCase();
-    // Validate it is hex
-    if (/[0-9a-f]/.test(firstChar)) {
-        if (!map[firstChar])
-            map[firstChar] = [];
-        map[firstChar].push(challengeId);
-        // OPTIONAL: Implement Full Coverage Strategy here?
-        // e.g. map[challengeId[1]].push(challengeId) ...
-        // For V1, we stick to Native/Implicit bucket (Index 0).
-    }
-}
-/**
- * Helper to clean up Binding Map when removing IDs.
- */
-export function removeFromBindingMap(map, challengeId) {
-    // Since we don't know exactly which buckets an ID is in (if we did multi-bucket),
-    // we strictly should scan all. For V1 Native, we check first char.
-    // SAFE IMPLEMENTATION: Scan all buckets.
-    for (const key of Object.keys(map)) {
-        map[key] = map[key].filter(id => id !== challengeId);
-    }
-}
-//# sourceMappingURL=keystone-helpers.mjs.map

package/dist/keystone/keystone-helpers.mjs.map

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

package/dist/keystone/keystone-service-v1.d.mts

@@ -1,81 +0,0 @@
-import { IbGibSpaceAny } from '@ibgib/core-gib/dist/witness/space/space-base-v1.mjs';
-import { MetaspaceService } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs';
-import { KeystoneIbGib_V1, KeystonePoolConfig, KeystoneClaim } from './keystone-types.mjs';
-/**
- * Facade for managing Keystone Identities.
- *
- * Handles Genesis, Authorized Evolution (Signing), and Validation.
- */
-export declare class KeystoneService_V1 {
-    protected lc: string;
-    /**
-     * Creates a brand new Keystone Identity Timeline.
-     */
-    genesis({ masterSecret, configs, metaspace, space, }: {
-        masterSecret: string;
-        configs: KeystonePoolConfig[];
-        metaspace: MetaspaceService;
-        space: IbGibSpaceAny;
-    }): Promise<KeystoneIbGib_V1>;
-    /**
-     * Signs a claim using a hybrid selection strategy.
-     * Supports: Mandatory IDs (Alice) + Sequential (FIFO) + Random (Stochastic).
-     */
-    sign({ latestKeystone, masterSecret, claim, poolId, requiredChallengeIds, frameDetails, metaspace, space, }: {
-        latestKeystone: KeystoneIbGib_V1;
-        masterSecret: string;
-        claim: Partial<KeystoneClaim>;
-        poolId?: string;
-        requiredChallengeIds?: string[];
-        frameDetails?: any;
-        metaspace: MetaspaceService;
-        space: IbGibSpaceAny;
-    }): Promise<KeystoneIbGib_V1>;
-    /**
-     * Validates the transition from Prev -> Curr.
-     * Enforces Cryptography AND Behavioral Policy.
-     *
-     * @returns Array of validation error strings. Empty array means Valid.
-     */
-    validate({ currentIbGib, prevIbGib, }: {
-        currentIbGib: KeystoneIbGib_V1;
-        prevIbGib: KeystoneIbGib_V1;
-        metaspace: MetaspaceService;
-        space: IbGibSpaceAny;
-    }): Promise<string[]>;
-    /**
-     * Permanently revokes the Identity.
-     *
-     * Logic:
-     * 1. Locates the 'revoke' pool.
-     * 2. Consumes ALL available challenges in that pool (Scorched Earth).
-     * 3. Sets the revocationInfo on the new frame.
-     */
-    revoke({ latestKeystone, masterSecret, reason, frameDetails, metaspace, space, }: {
-        latestKeystone: KeystoneIbGib_V1;
-        masterSecret: string;
-        reason?: string;
-        frameDetails?: any;
-        metaspace: MetaspaceService;
-        space?: IbGibSpaceAny;
-    }): Promise<KeystoneIbGib_V1>;
-    /**
-     * Generates an opaque, collision-resistant ID for a challenge.
-     * Hash(Salt + Timestamp + Index)
-     */
-    private generateOpaqueChallengeId;
-    private applyReplenishmentStrategy;
-    /**
-     * Creates a new keystone ibgib that has no dna and no past.
-     */
-    private createKeystoneIbGibImpl;
-    /**
-     * for signing/revoking, the newData is entirely new per frame, i.e., we
-     * replace all relevant keystone information. IOW we are not just patching
-     * the data by adding or replacing keys, we are providing all pools, claim,
-     * solutions, required, and frameDetails. So this implementation is required
-     * to remove each of the old keys in the call to {@link mut8}.
-     */
-    private evolveKeystoneIbGibImpl;
-}
-//# sourceMappingURL=keystone-service-v1.d.mts.map

package/dist/keystone/keystone-service-v1.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"keystone-service-v1.d.mts","sourceRoot":"","sources":["../../src/keystone/keystone-service-v1.mts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kEAAkE,CAAC;AAGpG,OAAO,EAEH,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EAOhB,MAAM,sBAAsB,CAAC;AAW9B;;;;GAIG;AACH,qBAAa,kBAAkB;IAC3B,SAAS,CAAC,EAAE,EAAE,MAAM,CAAkC;IAEtD;;OAEG;IACG,OAAO,CAAC,EACV,YAAY,EACZ,OAAO,EACP,SAAS,EACT,KAAK,GACR,EAAE;QACC,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,kBAAkB,EAAE,CAAC;QAC9B,SAAS,EAAE,gBAAgB,CAAC;QAC5B,KAAK,EAAE,aAAa,CAAC;KACxB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqD7B;;;OAGG;IACG,IAAI,CAAC,EACP,cAAc,EACd,YAAY,EACZ,KAAK,EACL,MAAM,EACN,oBAAyB,EACzB,YAAY,EACZ,SAAS,EACT,KAAK,GACR,EAAE;QACC,cAAc,EAAE,gBAAgB,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;QAChC,YAAY,CAAC,EAAE,GAAG,CAAC;QACnB,SAAS,EAAE,gBAAgB,CAAC;QAC5B,KAAK,EAAE,aAAa,CAAC;KACxB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmH7B;;;;;OAKG;IACG,QAAQ,CAAC,EACX,YAAY,EACZ,SAAS,GACZ,EAAE;QACC,YAAY,EAAE,gBAAgB,CAAC;QAC/B,SAAS,EAAE,gBAAgB,CAAC;QAC5B,SAAS,EAAE,gBAAgB,CAAC;QAC5B,KAAK,EAAE,aAAa,CAAC;KACxB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmGrB;;;;;;;OAOG;IACG,MAAM,CAAC,EACT,cAAc,EACd,YAAY,EACZ,MAAoC,EACpC,YAAY,EACZ,SAAS,EACT,KAAK,GACR,EAAE;QACC,cAAc,EAAE,gBAAgB,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,GAAG,CAAC;QACnB,SAAS,EAAE,gBAAgB,CAAC;QAC5B,KAAK,CAAC,EAAE,aAAa,CAAC;KACzB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2F7B;;;OAGG;YACW,yBAAyB;YAgBzB,0BAA0B;IA+ExC;;OAEG;YACW,uBAAuB;IA0ErC;;;;;;OAMG;YACW,uBAAuB;CAuExC"}