@ibgib/node-gib 0.0.18 → 0.0.20

package/src/serve-gib/identity-index/identity-index-service.mts

@@ -218,9 +218,19 @@ let _identityIndexService: IdentityIndexService | undefined;
 /**
  * Singleton factory getter for the IdentityIndexService.
  */
-export function getIdentityIndexService(): IdentityIndexService {
+export function getIdentityIndexService(opts?: IdentityIndexServiceOptions): IdentityIndexService {
+    if (opts) {
+        return new IdentityIndexService(opts);
+    }
     if (!_identityIndexService) {
         _identityIndexService = new IdentityIndexService();
     }
     return _identityIndexService;
 }
+
+/**
+ * Resets the cached singleton instance (useful during testing across different data directories).
+ */
+export function resetIdentityIndexService(): void {
+    _identityIndexService = undefined;
+}

package/src/serve-gib/index.mts

@@ -36,6 +36,7 @@ export * from './handlers/api/keystone/sso-link.handler.mjs';
 export * from './handlers/api/keystone/sso-login.handler.mjs';
 export * from './handlers/api/identity/keystone-custodian-genesis.handler.mjs';
 export * from './handlers/api/identity/keystone-custodian-register-delegate.handler.mjs';
+export * from './handlers/api/identity/keystone-custodian-add-master-password.handler.mjs';
 export * from './handlers/api/email/email-inbound.handler.mjs';
 export * from './handlers/api/email/email-outbound.handler.mjs';
 export * from './handlers/api/email/email-verification-code.handler.mjs';
@@ -60,6 +61,7 @@ import { SsoLoginHandler } from './handlers/api/keystone/sso-login.handler.mjs';
 import { SsoConfigHandler } from './handlers/api/keystone/sso-config.handler.mjs';
 import { KeystoneCustodianGenesisHandler } from './handlers/api/identity/keystone-custodian-genesis.handler.mjs';
 import { KeystoneCustodianRegisterDelegateHandler } from './handlers/api/identity/keystone-custodian-register-delegate.handler.mjs';
+import { KeystoneCustodianAddMasterPasswordHandler } from './handlers/api/identity/keystone-custodian-add-master-password.handler.mjs';
 import { EmailInboundHandler } from './handlers/api/email/email-inbound.handler.mjs';
 import { EmailOutboundHandler } from './handlers/api/email/email-outbound.handler.mjs';
 import { EmailVerificationCodeHandler } from './handlers/api/email/email-verification-code.handler.mjs';
@@ -89,6 +91,7 @@ export function getStandardServeGibHandlers(opts: StandardHandlersOptions = {}):
         new SsoConfigHandler(),
         new KeystoneCustodianGenesisHandler(),
         new KeystoneCustodianRegisterDelegateHandler(),
+        new KeystoneCustodianAddMasterPasswordHandler(),
         new EmailInboundHandler(),
         new EmailOutboundHandler(),
         new EmailVerificationCodeHandler(),

package/src/serve-gib/path-constants.mts

@@ -134,6 +134,11 @@ export const API_PATH_REGEXES = {
      * /api/identity/custodian/register-delegate
      */
     KEYSTONE_CUSTODIAN_REGISTER_DELEGATE: /^\/api\/identity\/custodian\/register-delegate\/?$/i,
+
+    /**
+     * /api/identity/custodian/add-master-password
+     */
+    KEYSTONE_CUSTODIAN_ADD_MASTER_PASSWORD: /^\/api\/identity\/custodian\/add-master-password\/?$/i,
 };
 
 export const VALID_STATIC_PATH_REGEX = /^\/[a-zA-Z0-9\-_\.\/]*$/;

package/data/identity_index/email/hashes/32/13/49/e64f32730f01a61ada211f29eaf0a210fc2386b668ad04d7e8a9b16766.json

@@ -1,4 +0,0 @@
-{
-  "tjpAddr": "keystone^MULTIEMAIL_TJP",
-  "createdAt": 1786369164040
-}

package/dist/serve-gib/handlers/api/ibgib/ibgib-handler-types.d.mts

@@ -1,41 +0,0 @@
-import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
-import { DomainInfo } from "../../../types.mjs";
-export interface IbGibParams {
-    domainInfo: DomainInfo;
-    ibGibIb: string;
-    ibGibGib: string;
-    ibGibAddr: IbGibAddr;
-}
-export declare const DEFAULT_QUERY_PARAMS_GET_IBGIB: {
-    /**
-     * If true, will get the latest ibgib.
-     */
-    getLatest: boolean;
-    /**
-     * If true, will get the ibgib's entire dependency graph
-     */
-    getGraph: boolean;
-    /**
-     * If true, returns only the resolved address (addr) rather than the full
-     * ibgib or graph body. Useful for a lightweight "tip check" before initiating
-     * a full sync: client compares `latestAddr` with its locally known addr.
-     *
-     * ## notes
-     *
-     * Typically combined with `getLatest: true` to ask "what is the server's
-     * current tip for this timeline?" without paying the cost of fetching the
-     * full ibgib body or graph.
-     *
-     * When `getLatest: false` and `addrOnly: true`, returns the addr as-is
-     * (i.e., confirms the given addr exists on the server).
-     */
-    addrOnly: boolean;
-};
-/**
- * @see {@link DEFAULT_QUERY_PARAMS_GET_IBGIB} key/values for jsdocs
- */
-export type IbGibGetQueryParams = Partial<typeof DEFAULT_QUERY_PARAMS_GET_IBGIB>;
-export type KNOWN_QUERY_PARAMS_IBGIB_GET = keyof IbGibGetQueryParams;
-export declare const KNOWN_QUERY_PARAMS_IBGIB_GET: KNOWN_QUERY_PARAMS_IBGIB_GET[];
-export declare function isKnownQueryParamsKey_IbGibGet(key: any): key is KNOWN_QUERY_PARAMS_IBGIB_GET;
-//# sourceMappingURL=ibgib-handler-types.d.mts.map

package/dist/serve-gib/handlers/api/ibgib/ibgib-handler-types.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ibgib-handler-types.d.mts","sourceRoot":"","sources":["../../../../../src/serve-gib/handlers/api/ibgib/ibgib-handler-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;CACxB;AAGD,eAAO,MAAM,8BAA8B;IACvC;;OAEG;IACH,SAAS;IACT;;OAEG;IACH,QAAQ;IACR;;;;;;;;;;;;;OAaG;IACH,QAAQ;CACX,CAAC;AACF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACjF,MAAM,MAAM,4BAA4B,GAAG,MAAM,mBAAmB,CAAC;AACrE,eAAO,MAAM,4BAA4B,EAAkD,4BAA4B,EAAE,CAAC;AAC1H,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,4BAA4B,CAI5F"}

package/dist/serve-gib/handlers/api/ibgib/ibgib-handler-types.mjs

@@ -1,34 +0,0 @@
-// #region IbGibGetQueryParams
-export const DEFAULT_QUERY_PARAMS_GET_IBGIB = {
-    /**
-     * If true, will get the latest ibgib.
-     */
-    getLatest: false, // Default to false for regular ibgibs
-    /**
-     * If true, will get the ibgib's entire dependency graph
-     */
-    getGraph: false, // Default to false for regular ibgibs
-    /**
-     * If true, returns only the resolved address (addr) rather than the full
-     * ibgib or graph body. Useful for a lightweight "tip check" before initiating
-     * a full sync: client compares `latestAddr` with its locally known addr.
-     *
-     * ## notes
-     *
-     * Typically combined with `getLatest: true` to ask "what is the server's
-     * current tip for this timeline?" without paying the cost of fetching the
-     * full ibgib body or graph.
-     *
-     * When `getLatest: false` and `addrOnly: true`, returns the addr as-is
-     * (i.e., confirms the given addr exists on the server).
-     */
-    addrOnly: false,
-};
-export const KNOWN_QUERY_PARAMS_IBGIB_GET = Object.keys(DEFAULT_QUERY_PARAMS_GET_IBGIB);
-export function isKnownQueryParamsKey_IbGibGet(key) {
-    return !!key && typeof key === 'string' ?
-        KNOWN_QUERY_PARAMS_IBGIB_GET.includes(key) :
-        false;
-}
-// #endregion IbGibGetQueryParams
-//# sourceMappingURL=ibgib-handler-types.mjs.map

package/dist/serve-gib/handlers/api/ibgib/ibgib-handler-types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ibgib-handler-types.mjs","sourceRoot":"","sources":["../../../../../src/serve-gib/handlers/api/ibgib/ibgib-handler-types.mts"],"names":[],"mappings":"AAWA,8BAA8B;AAC9B,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC1C;;OAEG;IACH,SAAS,EAAE,KAAK,EAAE,sCAAsC;IACxD;;OAEG;IACH,QAAQ,EAAE,KAAK,EAAE,sCAAsC;IACvD;;;;;;;;;;;;;OAaG;IACH,QAAQ,EAAE,KAAK;CAClB,CAAC;AAMF,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAmC,CAAC;AAC1H,MAAM,UAAU,8BAA8B,CAAC,GAAQ;IACnD,OAAO,CAAC,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC;QACrC,4BAA4B,CAAC,QAAQ,CAAC,GAAU,CAAC,CAAC,CAAC;QACnD,KAAK,CAAC;AACd,CAAC;AACD,iCAAiC"}

package/dist/serve-gib/handlers/api/ibgib/ibgib.handler.d.mts

@@ -1,26 +0,0 @@
-/**
- * @module serve-gib/handlers/api/ibgib
- */
-import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
-import { ServeGibHandlerWithMetaspaceBase } from '../../handler-base.mjs';
-import { RequestContext, ResponseResult, ServeGibHttpMethod } from '../../../types.mjs';
-import { IbGibGetQueryParams, IbGibParams } from './ibgib-handler-types.mjs';
-export interface IbGibGraphResponseBody {
-    addr: string;
-    count: number;
-    graph: Record<string, IbGib_V1>;
-}
-/**
- * GET /api/ibgib/:domainAddr/:ibGibAddr
- */
-export declare class IbGibHandler extends ServeGibHandlerWithMetaspaceBase<IbGibParams, IbGibGetQueryParams> {
-    protected lc: string;
-    protected method: ServeGibHttpMethod;
-    protected regex: RegExp;
-    protected parseParamsImpl(reqCtx: RequestContext<IbGibParams, IbGibGetQueryParams>): Promise<IbGibParams | undefined>;
-    protected validateQueryParams({ queryParams }: {
-        queryParams: any;
-    }): Promise<string[]>;
-    protected handleRouteImpl(reqCtx: RequestContext<IbGibParams, IbGibGetQueryParams>): Promise<ResponseResult | undefined>;
-}
-//# sourceMappingURL=ibgib.handler.d.mts.map

package/dist/serve-gib/handlers/api/ibgib/ibgib.handler.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ibgib.handler.d.mts","sourceRoot":"","sources":["../../../../../src/serve-gib/handlers/api/ibgib/ibgib.handler.mts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxF,OAAO,EAC6B,mBAAmB,EAAE,WAAW,EAEnE,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACnC;AAID;;GAEG;AACH,qBAAa,YAAa,SAAQ,gCAAgC,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAChG,UAAmB,EAAE,EAAE,MAAM,CAA4B;IACzD,UAAmB,MAAM,EAAE,kBAAkB,CAAS;IACtD,UAAmB,KAAK,SAA+B;IAEvD,UAAyB,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,WAAW,EAAE,mBAAmB,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAsBnI;IAED,UAAyB,mBAAmB,CAAC,EAAE,WAAW,EAAE,EAAE;QAAE,WAAW,EAAE,GAAG,CAAC;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmCtG;IAED,UAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,WAAW,EAAE,mBAAmB,CAAC,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA8E7H;CACJ"}

package/dist/serve-gib/handlers/api/ibgib/ibgib.handler.mjs

@@ -1,179 +0,0 @@
-/**
- * @module serve-gib/handlers/api/ibgib
- */
-import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { GLOBAL_LOG_A_LOT } from '../../../constants.mjs';
-import { ServeGibHandlerWithMetaspaceBase } from '../../handler-base.mjs';
-import { validateAddressSegment } from '../../../path-helper.mjs';
-import { API_PATH_REGEXES } from '../../../path-constants.mjs';
-import { DEFAULT_QUERY_PARAMS_GET_IBGIB, isKnownQueryParamsKey_IbGibGet, KNOWN_QUERY_PARAMS_IBGIB_GET } from './ibgib-handler-types.mjs';
-import { validateAndCoerceBooleanQueryParam } from '../../../serve-gib-helpers.mjs';
-const logalot = GLOBAL_LOG_A_LOT;
-/**
- * GET /api/ibgib/:domainAddr/:ibGibAddr
- */
-export class IbGibHandler extends ServeGibHandlerWithMetaspaceBase {
-    lc = `[${IbGibHandler.name}]`;
-    method = 'GET';
-    regex = API_PATH_REGEXES.IBGIB_ADDR;
-    async parseParamsImpl(reqCtx) {
-        const lc = `${this.lc}[${this.parseParamsImpl.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            const match = reqCtx.pathname.match(this.regex);
-            if (!match) {
-                throw new Error(`(UNEXPECTED) match falsy for regex? at this point, we have passed canHandleRoute, so this should parse correctly. (E: 8ce0810a3a88f420639bf8286df1d826)`);
-            }
-            const domainIb = decodeURIComponent(match[1]);
-            const domainGib = decodeURIComponent(match[2]);
-            const domainAddr = getIbGibAddr({ ib: domainIb, gib: domainGib });
-            const ibGibIb = decodeURIComponent(match[3]);
-            const ibGibGib = decodeURIComponent(match[4]);
-            const ibGibAddr = getIbGibAddr({ ib: ibGibIb, gib: ibGibGib });
-            return {
-                ibGibIb, ibGibGib, ibGibAddr,
-                domainInfo: this.getDomainInfo({ domainAddr }),
-            };
-        }
-        catch (error) {
-            console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    async validateQueryParams({ queryParams }) {
-        const lc = `${this.lc}[${this.validateQueryParams.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            const errors = [];
-            // strict checking
-            const queryParamsKeys = Object.keys(queryParams);
-            const invalidKeys = queryParamsKeys.filter(x => !isKnownQueryParamsKey_IbGibGet(x));
-            if (invalidKeys.length > 0) {
-                throw new Error(`invalid query params keys: ${invalidKeys.join(', ')}. valid query params keys: ${KNOWN_QUERY_PARAMS_IBGIB_GET.join(', ')} (E: b7e8a9f2c1d34e56b89a01d4f2e7c326)`);
-            }
-            const ValidationFns = {
-                getLatest: async () => validateAndCoerceBooleanQueryParam(queryParams, 'getLatest', errors),
-                getGraph: async () => validateAndCoerceBooleanQueryParam(queryParams, 'getGraph', errors),
-                addrOnly: async () => validateAndCoerceBooleanQueryParam(queryParams, 'addrOnly', errors),
-            };
-            // execute all validation functions
-            for (const fn of Object.values(ValidationFns)) {
-                await fn();
-            }
-            return errors;
-        }
-        catch (error) {
-            console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    async handleRouteImpl(reqCtx) {
-        const lc = `${this.lc}[${this.handleRouteImpl.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: 03d6a889b1f8af879c0f7158a3b3de26)`);
-            }
-            if (logalot) {
-                console.log(`${lc} starting... (I: 03d6a889b1f8af879c0f7158a3b3de26)`);
-            }
-            if (!reqCtx.metaspace) {
-                throw new Error(`(UNEXPECTED) metaspace falsy? we should have initialized it by now since this is a domain-dependent handler (E: 864661c668d2aa1918b7ee677a7d9c26)`);
-            }
-            const { ibGibIb, ibGibGib } = reqCtx.params;
-            if (!ibGibIb || !ibGibGib) {
-                return undefined;
-            }
-            // Reconstruct addr from params
-            const rawAddr = `${ibGibIb}^${ibGibGib}`;
-            if (!validateAddressSegment(rawAddr))
-                return this.error(400, 'Invalid address format');
-            const addr = rawAddr;
-            const queryParams = {
-                ...DEFAULT_QUERY_PARAMS_GET_IBGIB,
-                ...(reqCtx.queryParams ?? {}),
-            };
-            const { getLatest, getGraph, addrOnly } = queryParams;
-            const space = await reqCtx.metaspace.getLocalUserSpace({ lock: false });
-            if (!space) {
-                throw new Error(`(UNEXPECTED) couldn't get default local user space? (E: ec6161ea3a08892ad8bfd1b7b0d79826)`);
-            }
-            let addr_latest = addr;
-            if (getLatest) {
-                const latestAddr = await reqCtx.metaspace.getLatestAddr({ addr, space });
-                if (latestAddr) {
-                    addr_latest = latestAddr;
-                }
-            }
-            // Lightweight tip-check: return only the resolved address.
-            // Client uses this to decide whether a full sync is necessary
-            // without incurring the cost of fetching the full ibgib or graph.
-            if (addrOnly && !getGraph) {
-                return this.ok({ addr: addr_latest, clientAddr: addr });
-            } /* <<<<< returns early */
-            if (getGraph) {
-                const resGraph = await reqCtx.metaspace.getDependencyGraph({
-                    ibGibAddr: addr_latest,
-                    space,
-                    live: getLatest,
-                });
-                const addrs = Object.keys(resGraph);
-                if (addrs.length > 0) {
-                    if (addrOnly) {
-                        // Return only the address list for delta negotiation (smart diff):
-                        // client compares these against what it already has to determine
-                        // the minimal set it needs to fetch.
-                        return this.ok({ addr: addr_latest, clientAddr: addr, addrs });
-                    }
-                    else {
-                        const responseBody = {
-                            addr: addr_latest,
-                            count: addrs.length,
-                            graph: resGraph
-                        };
-                        return this.ok(responseBody);
-                    }
-                }
-                else {
-                    return this.notFound(`Graph not found for ${addr_latest} (E: 89b259f13ae5e4f0d8287f6c0475a826)`);
-                }
-            }
-            else {
-                const resGet = await reqCtx.metaspace.get({ space, addr: addr_latest });
-                if (resGet.success && resGet.ibGibs?.length === 1) {
-                    const ibGib = resGet.ibGibs[0];
-                    return this.ok(ibGib);
-                }
-                else {
-                    return this.notFound(`IbGib not found for ${addr_latest} (E: 017621e0a8086832ff06cfc884b8c426)`);
-                }
-            }
-        }
-        catch (error) {
-            if (logalot) {
-                console.error(extractErrorMsg(error));
-            }
-            return this.error(500, extractErrorMsg(error));
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-}
-//# sourceMappingURL=ibgib.handler.mjs.map

package/dist/serve-gib/handlers/api/ibgib/ibgib.handler.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ibgib.handler.mjs","sourceRoot":"","sources":["../../../../../src/serve-gib/handlers/api/ibgib/ibgib.handler.mts"],"names":[],"mappings":"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"}

package/src/serve-gib/handlers/api/ibgib/ibgib-handler-types.mts

@@ -1,49 +0,0 @@
-import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
-
-import { DomainInfo } from "../../../types.mjs";
-
-export interface IbGibParams {
-    domainInfo: DomainInfo;
-    ibGibIb: string;
-    ibGibGib: string;
-    ibGibAddr: IbGibAddr;
-}
-
-// #region IbGibGetQueryParams
-export const DEFAULT_QUERY_PARAMS_GET_IBGIB = {
-    /**
-     * If true, will get the latest ibgib.
-     */
-    getLatest: false, // Default to false for regular ibgibs
-    /**
-     * If true, will get the ibgib's entire dependency graph
-     */
-    getGraph: false, // Default to false for regular ibgibs
-    /**
-     * If true, returns only the resolved address (addr) rather than the full
-     * ibgib or graph body. Useful for a lightweight "tip check" before initiating
-     * a full sync: client compares `latestAddr` with its locally known addr.
-     *
-     * ## notes
-     *
-     * Typically combined with `getLatest: true` to ask "what is the server's
-     * current tip for this timeline?" without paying the cost of fetching the
-     * full ibgib body or graph.
-     *
-     * When `getLatest: false` and `addrOnly: true`, returns the addr as-is
-     * (i.e., confirms the given addr exists on the server).
-     */
-    addrOnly: false,
-};
-/**
- * @see {@link DEFAULT_QUERY_PARAMS_GET_IBGIB} key/values for jsdocs
- */
-export type IbGibGetQueryParams = Partial<typeof DEFAULT_QUERY_PARAMS_GET_IBGIB>;
-export type KNOWN_QUERY_PARAMS_IBGIB_GET = keyof IbGibGetQueryParams;
-export const KNOWN_QUERY_PARAMS_IBGIB_GET = Object.keys(DEFAULT_QUERY_PARAMS_GET_IBGIB) as KNOWN_QUERY_PARAMS_IBGIB_GET[];
-export function isKnownQueryParamsKey_IbGibGet(key: any): key is KNOWN_QUERY_PARAMS_IBGIB_GET {
-    return !!key && typeof key === 'string' ?
-        KNOWN_QUERY_PARAMS_IBGIB_GET.includes(key as any) :
-        false;
-}
-// #endregion IbGibGetQueryParams

package/src/serve-gib/handlers/api/ibgib/ibgib.handler.mts

@@ -1,176 +0,0 @@
-/**
- * @module serve-gib/handlers/api/ibgib
- */
-
-import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
-
-import { GLOBAL_LOG_A_LOT } from '../../../constants.mjs';
-import { ServeGibHandlerWithMetaspaceBase } from '../../handler-base.mjs';
-import { RequestContext, ResponseResult, ServeGibHttpMethod } from '../../../types.mjs';
-import { validateAddressSegment } from '../../../path-helper.mjs';
-import { API_PATH_REGEXES } from '../../../path-constants.mjs';
-import {
-    DEFAULT_QUERY_PARAMS_GET_IBGIB, IbGibGetQueryParams, IbGibParams,
-    isKnownQueryParamsKey_IbGibGet, KNOWN_QUERY_PARAMS_IBGIB_GET
-} from './ibgib-handler-types.mjs';
-import { validateAndCoerceBooleanQueryParam } from '../../../serve-gib-helpers.mjs';
-
-export interface IbGibGraphResponseBody {
-    addr: string;
-    count: number;
-    graph: Record<string, IbGib_V1>;
-}
-
-const logalot = GLOBAL_LOG_A_LOT;
-
-/**
- * GET /api/ibgib/:domainAddr/:ibGibAddr
- */
-export class IbGibHandler extends ServeGibHandlerWithMetaspaceBase<IbGibParams, IbGibGetQueryParams> {
-    protected override lc: string = `[${IbGibHandler.name}]`;
-    protected override method: ServeGibHttpMethod = 'GET';
-    protected override regex = API_PATH_REGEXES.IBGIB_ADDR;
-
-    protected override async parseParamsImpl(reqCtx: RequestContext<IbGibParams, IbGibGetQueryParams>): Promise<IbGibParams | undefined> {
-        const lc = `${this.lc}[${this.parseParamsImpl.name}]`;
-        try {
-            if (logalot) { console.log(`${lc} starting...`); }
-            const match = reqCtx.pathname.match(this.regex);
-            if (!match) { throw new Error(`(UNEXPECTED) match falsy for regex? at this point, we have passed canHandleRoute, so this should parse correctly. (E: 8ce0810a3a88f420639bf8286df1d826)`); }
-            const domainIb = decodeURIComponent(match[1]);
-            const domainGib = decodeURIComponent(match[2]);
-            const domainAddr = getIbGibAddr({ ib: domainIb, gib: domainGib });
-            const ibGibIb = decodeURIComponent(match[3]);
-            const ibGibGib = decodeURIComponent(match[4]);
-            const ibGibAddr = getIbGibAddr({ ib: ibGibIb, gib: ibGibGib });
-            return {
-                ibGibIb, ibGibGib, ibGibAddr,
-                domainInfo: this.getDomainInfo({ domainAddr }),
-            };
-        } catch (error) {
-            console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
-        } finally {
-            if (logalot) { console.log(`${lc} complete.`); }
-        }
-    }
-
-    protected override async validateQueryParams({ queryParams }: { queryParams: any; }): Promise<string[]> {
-        const lc = `${this.lc}[${this.validateQueryParams.name}]`;
-        try {
-            if (logalot) { console.log(`${lc} starting...`); }
-
-            const errors: string[] = [];
-
-            // strict checking
-            const queryParamsKeys = Object.keys(queryParams);
-            const invalidKeys: string[] = queryParamsKeys.filter(x => !isKnownQueryParamsKey_IbGibGet(x));
-            if (invalidKeys.length > 0) {
-                throw new Error(`invalid query params keys: ${invalidKeys.join(', ')}. valid query params keys: ${KNOWN_QUERY_PARAMS_IBGIB_GET.join(', ')} (E: b7e8a9f2c1d34e56b89a01d4f2e7c326)`);
-            }
-
-            // Enforce that EVERY key must have a validation function mapping
-            type ValidationFn = () => Promise<void>;
-            const ValidationFns: Record<KNOWN_QUERY_PARAMS_IBGIB_GET, ValidationFn> = {
-                getLatest: async () => validateAndCoerceBooleanQueryParam(queryParams, 'getLatest', errors),
-                getGraph: async () => validateAndCoerceBooleanQueryParam(queryParams, 'getGraph', errors),
-                addrOnly: async () => validateAndCoerceBooleanQueryParam(queryParams, 'addrOnly', errors),
-            };
-
-            // execute all validation functions
-            for (const fn of Object.values(ValidationFns)) {
-                await fn();
-            }
-
-            return errors;
-
-        } catch (error) {
-            console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
-        } finally {
-            if (logalot) { console.log(`${lc} complete.`); }
-        }
-    }
-
-    protected async handleRouteImpl(reqCtx: RequestContext<IbGibParams, IbGibGetQueryParams>): Promise<ResponseResult | undefined> {
-        const lc = `${this.lc}[${this.handleRouteImpl.name}]`;
-        try {
-            if (logalot) { console.log(`${lc} starting... (I: 03d6a889b1f8af879c0f7158a3b3de26)`); }
-
-            if (logalot) { console.log(`${lc} starting... (I: 03d6a889b1f8af879c0f7158a3b3de26)`); }
-            if (!reqCtx.metaspace) { throw new Error(`(UNEXPECTED) metaspace falsy? we should have initialized it by now since this is a domain-dependent handler (E: 864661c668d2aa1918b7ee677a7d9c26)`); }
-
-            const { ibGibIb, ibGibGib } = reqCtx.params as IbGibParams;
-            if (!ibGibIb || !ibGibGib) { return undefined; }
-
-            // Reconstruct addr from params
-            const rawAddr = `${ibGibIb}^${ibGibGib}`;
-            if (!validateAddressSegment(rawAddr)) return this.error(400, 'Invalid address format');
-            const addr = rawAddr;
-
-            const queryParams = {
-                ...DEFAULT_QUERY_PARAMS_GET_IBGIB,
-                ...(reqCtx.queryParams ?? {}),
-            };
-
-            const { getLatest, getGraph, addrOnly } = queryParams;
-
-            const space = await reqCtx.metaspace.getLocalUserSpace({ lock: false });
-            if (!space) { throw new Error(`(UNEXPECTED) couldn't get default local user space? (E: ec6161ea3a08892ad8bfd1b7b0d79826)`); }
-
-            let addr_latest: string = addr;
-            if (getLatest) {
-                const latestAddr = await reqCtx.metaspace.getLatestAddr({ addr, space });
-                if (latestAddr) { addr_latest = latestAddr; }
-            }
-
-            // Lightweight tip-check: return only the resolved address.
-            // Client uses this to decide whether a full sync is necessary
-            // without incurring the cost of fetching the full ibgib or graph.
-            if (addrOnly && !getGraph) {
-                return this.ok({ addr: addr_latest, clientAddr: addr });
-            } /* <<<<< returns early */
-
-            if (getGraph) {
-                const resGraph = await reqCtx.metaspace.getDependencyGraph({
-                    ibGibAddr: addr_latest,
-                    space,
-                    live: getLatest,
-                });
-                const addrs = Object.keys(resGraph);
-                if (addrs.length > 0) {
-                    if (addrOnly) {
-                        // Return only the address list for delta negotiation (smart diff):
-                        // client compares these against what it already has to determine
-                        // the minimal set it needs to fetch.
-                        return this.ok({ addr: addr_latest, clientAddr: addr, addrs });
-                    } else {
-                        const responseBody: IbGibGraphResponseBody = {
-                            addr: addr_latest,
-                            count: addrs.length,
-                            graph: resGraph
-                        };
-                        return this.ok(responseBody);
-                    }
-                } else {
-                    return this.notFound(`Graph not found for ${addr_latest} (E: 89b259f13ae5e4f0d8287f6c0475a826)`);
-                }
-            } else {
-                const resGet = await reqCtx.metaspace.get({ space, addr: addr_latest });
-                if (resGet.success && resGet.ibGibs?.length === 1) {
-                    const ibGib = resGet.ibGibs[0];
-                    return this.ok(ibGib);
-                } else {
-                    return this.notFound(`IbGib not found for ${addr_latest} (E: 017621e0a8086832ff06cfc884b8c426)`);
-                }
-            }
-        } catch (error) {
-            if (logalot) { console.error(extractErrorMsg(error)) }
-            return this.error(500, extractErrorMsg(error));
-        } finally {
-            if (logalot) { console.log(`${lc} complete.`); }
-        }
-    }
-}