@ibgib/node-gib 0.0.17 → 0.0.19

package/src/serve-gib/handlers/api/email/email-verification-code.handler.mts

@@ -13,7 +13,7 @@ import { API_PATH_REGEXES } from '../../../path-constants.mjs';
 import { RequestContext, ResponseResult, ServeGibHttpMethod } from '../../../types.mjs';
 import { ServeGibHandlerBase } from '../../handler-base.mjs';
 import { GLOBAL_LOG_A_LOT } from '../../../constants.mjs';
-import { generateVerificationCode, getPendingStagingDir, getPendingTjpHash, savePendingCodeRecord, savePendingStagingKeystone } from '../../../../email/verify/email-verify-helpers.mjs';
+import { createDefaultEmailSender, generateVerificationCode, getPendingStagingDir, getPendingTjpHash, savePendingCodeRecord, savePendingStagingKeystone } from '../../../../email/verify/email-verify-helpers.mjs';
 import { validateEmail } from '../../../../email/email-helpers.mjs';
 import { normalizeEmail } from '../../../identity-index/identity-index-helpers.mjs';
 
@@ -42,27 +42,7 @@ export class EmailVerificationCodeHandler extends ServeGibHandlerBase {
 
     constructor(options: EmailMagicLinkHandlerOptions = {}) {
         super();
-
-        if (options.sender) {
-            this.sender = options.sender;
-        } else {
-            const isProd = process.env.NODE_ENV === 'production';
-            const mode = (process.env.EMAIL_MODE || (isProd ? 'aws' : 'mock')).toLowerCase();
-            if (mode === 'aws') {
-                this.sender = new EmailSenderAws({
-                    accessKeyId: process.env.AWS_ACCESS_KEY_ID || '',
-                    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY || '',
-                    region: process.env.AWS_REGION || 'us-east-1',
-                });
-            } else if (mode === 'mock') {
-                if (isProd) {
-                    throw new Error('EMAIL_MODE=mock is prohibited when NODE_ENV=production. (E: 897a6b5c4d3e2f10987654321fedcba0)');
-                }
-                this.sender = new EmailSenderMock();
-            } else {
-                throw new Error(`Unsupported EMAIL_MODE '${mode}'. Must be 'aws' or 'mock'. (E: 987a6b5c4d3e2f10987654321fedcba1)`);
-            }
-        }
+        this.sender = options.sender || createDefaultEmailSender();
     }
 
     protected async handleRouteImpl(reqCtx: RequestContext): Promise<ResponseResult | undefined> {

package/src/serve-gib/handlers/api/identity/keystone-custodian-genesis.handler.mts

@@ -126,9 +126,12 @@ export class KeystoneCustodianGenesisHandler extends ServeGibHandlerBase<undefin
                 const metaspace = await bootstrapDomainMetaspace(primaryTjpAddr, reqCtx.dataDir);
                 const space = await metaspace.getLocalUserSpace({ lock: false });
                 if (space) {
-                    const latestAddr = await metaspace.getLatestAddr({ addr: primaryTjpAddr, space }) ?? primaryTjpAddr;
-                    const getRes = await metaspace.get({ addrs: [latestAddr], space });
-                    primaryKeystone = getRes.ibGibs?.[0];
+                    const keystoneService = new KeystoneService_V1();
+                    primaryKeystone = await keystoneService.getLatestKeystone({
+                        addr: primaryTjpAddr,
+                        metaspace,
+                        space
+                    });
                 }
             } else {
                 // New custodian identity creation
@@ -136,7 +139,12 @@ export class KeystoneCustodianGenesisHandler extends ServeGibHandlerBase<undefin
                 console.log(`${lc} Creating new custodian primary identity for ${normEmail} (I: f123456789abcdef0123456789b0006)`);
 
                 const defaultUsername = username || normEmail.split('@')[0];
-                const primaryBuilder = KeystoneProfileBuilder.buildKeystone('sync')
+                const primaryProfileName = process.env.KEYSTONE_PROFILE_CUSTODIAN_PRIMARY;
+                if (!primaryProfileName || !primaryProfileName.trim()) {
+                    throw new Error('KEYSTONE_PROFILE_CUSTODIAN_PRIMARY environment variable is missing. Expected valid profile name like "primary-profile.dev" or "primary-profile.prod". (E: 1a2b3c4d5e6f7890123456789abcdef1)');
+                }
+
+                const primaryBuilder = KeystoneProfileBuilder.buildKeystone(primaryProfileName.trim() as any)
                     .withUsername(defaultUsername)
                     .withDescription(`Full Custodian Primary Identity for ${normEmail}`)
                     .withDetails({

package/src/serve-gib/handlers/api/identity/keystone-custodian-register-delegate.handler.mts

@@ -140,9 +140,11 @@ export class KeystoneCustodianRegisterDelegateHandler extends ServeGibHandlerBas
                 return this.error(500, `Could not load domain space for primary identity ${custodianReqs.primaryTjpAddr}`);
             }
 
-            const latestPrimaryAddr = await metaspace.getLatestAddr({ addr: custodianReqs.primaryTjpAddr, space }) ?? custodianReqs.primaryTjpAddr;
-            const getRes = await metaspace.get({ addrs: [latestPrimaryAddr], space });
-            const parentKeystone = getRes.ibGibs?.[0] as KeystoneIbGib_V1 | undefined;
+            const parentKeystone = await keystoneService.getLatestKeystone({
+                addr: custodianReqs.primaryTjpAddr,
+                metaspace,
+                space
+            });
 
             if (!parentKeystone) {
                 return this.error(404, `Primary identity keystone not found for address ${custodianReqs.primaryTjpAddr}`);

package/src/serve-gib/handlers/api/identity/keystone-custodian-register-delegate.respec.mts

@@ -59,7 +59,7 @@ await respecfully(sir, 'KeystoneCustodianRegisterDelegateHandler', async () => {
 
         // Step 2: Build client delegate keystone containing custodianReqs
         const delegateSecret = await deriveLocalCustodianDelegateSecret({ primaryTjpAddr });
-        const delegateBuilder = KeystoneProfileBuilder.buildKeystone('sync')
+        const delegateBuilder = KeystoneProfileBuilder.buildKeystone('sync-profile.dev')
             .withUsername('bob-sync-phone')
             .withDescription('Sync Delegate for bob on phone')
             .withDetails({

package/src/serve-gib/handlers/api/keystone/sso-login.handler.mts

@@ -8,7 +8,7 @@
  * generates a fresh single-turn `CustodianRequirements` payload, and returns it to the client.
  */
 
-import { extractErrorMsg, hash, getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { extractErrorMsg, hash, getUUID, getSaferSubstring } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
 import { getTjpAddr } from '@ibgib/core-gib/dist/common/other/ibgib-helper.mjs';
 import { KeystoneProfileBuilder } from '@ibgib/core-gib/dist/keystone/policy/keystone-profile-builder.mjs';
 import { KeystoneService_V1 } from '@ibgib/core-gib/dist/keystone/keystone-service-v1.mjs';
@@ -103,7 +103,9 @@ export class SsoLoginHandler extends ServeGibHandlerBase<undefined, undefined> {
             }
 
             const email = userInfo.email.trim().toLowerCase();
-            const username = userInfo.name || email.split('@')[0];
+            const rawSSOName = userInfo.name || '';
+            const username = getSaferSubstring({ text: rawSSOName || email.split('@')[0], length: 62, keepLiterals: ['_', '-'] })
+                ;
 
             // 2. Check if primary identity exists for this email
             const ssoConfig = loadSsoServerConfig();
@@ -122,10 +124,12 @@ export class SsoLoginHandler extends ServeGibHandlerBase<undefined, undefined> {
                 primaryTjpAddr = existingLookup.primaryTjpAddr;
                 const domainMetaspace = await bootstrapDomainMetaspace(primaryTjpAddr, reqCtx.dataDir);
                 const space = await domainMetaspace.getLocalUserSpace({ lock: false });
-
-                const latestPrimaryAddr = await domainMetaspace.getLatestAddr({ addr: primaryTjpAddr, space: space! }) ?? primaryTjpAddr;
-                const getRes = await domainMetaspace.get({ addrs: [latestPrimaryAddr], space: space! });
-                primaryKeystone = getRes.ibGibs?.[0];
+                const keystoneService = new KeystoneService_V1();
+                primaryKeystone = await keystoneService.getLatestKeystone({
+                    addr: primaryTjpAddr,
+                    metaspace: domainMetaspace,
+                    space: space!
+                });
             } else {
                 // First-time custodian identity creation
                 isNewIdentity = true;
@@ -133,13 +137,19 @@ export class SsoLoginHandler extends ServeGibHandlerBase<undefined, undefined> {
                 const tempDomainMetaspace = await bootstrapDomainMetaspace(`temp^${tempId}`, reqCtx.dataDir);
                 const tempSpace = await tempDomainMetaspace.getLocalUserSpace({ lock: false });
 
-                const primaryBuilder = KeystoneProfileBuilder.buildKeystone('domain')
+                const primaryProfileName = process.env.KEYSTONE_PROFILE_CUSTODIAN_PRIMARY;
+                if (!primaryProfileName || !primaryProfileName.trim()) {
+                    throw new Error('KEYSTONE_PROFILE_CUSTODIAN_PRIMARY environment variable is missing. Expected valid profile name like "primary-profile.dev" or "primary-profile.prod". (E: 2b3c4d5e6f7890123456789abcdef2)');
+                }
+
+                const primaryBuilder = KeystoneProfileBuilder.buildKeystone(primaryProfileName.trim() as any)
                     .withUsername(username)
                     .withEmails([email])
                     .withDetails({
                         client: 'space-gib-server',
                         role: 'custodian-primary',
                         custodianProvider: providerId,
+                        [`rawSSOName-${providerId}`]: rawSSOName,
                     });
 
                 const configs = await primaryBuilder.compileConfigs();

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