@ibgib/node-gib 0.0.9 → 0.0.13

package/dist/serve-gib/handlers/api/email/email-outbound.handler.mjs

@@ -0,0 +1,72 @@
+/**
+ * @module serve-gib/handlers/api/email/email-outbound
+ *
+ * Handler for POST /api/email/send
+ */
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { EmailSenderAws } from '../../../../email/aws/email-sender-aws.mjs';
+import { EmailSenderMock } from '../../../../email/mock/email-sender-mock.mjs';
+import { API_PATH_REGEXES } from '../../../path-constants.mjs';
+import { ServeGibHandlerBase } from '../../handler-base.mjs';
+/**
+ * POST /api/email/send
+ * Validates request payload and dispatches outbound email via the active EmailSender driver.
+ */
+export class EmailOutboundHandler extends ServeGibHandlerBase {
+    lc = `[${EmailOutboundHandler.name}]`;
+    method = 'POST';
+    regex = API_PATH_REGEXES.EMAIL_SEND;
+    sender;
+    constructor(options = {}) {
+        super();
+        if (options.sender) {
+            this.sender = options.sender;
+        }
+        else {
+            const mode = process.env.EMAIL_MODE || 'mock';
+            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 {
+                this.sender = new EmailSenderMock();
+            }
+        }
+    }
+    async handleRouteImpl(reqCtx) {
+        const lc = `${this.lc}[${this.handleRouteImpl.name}]`;
+        try {
+            if (reqCtx.method !== 'POST') {
+                return this.error(405, 'Method Not Allowed');
+            }
+            if (!reqCtx.body) {
+                return this.error(400, 'Request body is empty');
+            }
+            let emailData;
+            try {
+                emailData = JSON.parse(reqCtx.body);
+            }
+            catch {
+                return this.error(400, 'Request body must be valid JSON');
+            }
+            const sendResult = await this.sender.sendEmail(emailData);
+            if (sendResult.success) {
+                console.log(`${lc} Successfully dispatched outbound email msgId: ${sendResult.messageId} (I: 0123456789abcdef0a1b2c3d4e5f6a7b)`);
+                return this.ok(sendResult, sendResult.statusCode || 200);
+            }
+            else {
+                console.error(`${lc} Failed to send email: ${sendResult.error} (E: 123456789abcdef1a2b3c4d5e6f7a8b9)`);
+                return this.error(sendResult.statusCode || 500, sendResult.error || 'Failed to send email');
+            }
+        }
+        catch (error) {
+            const emsg = extractErrorMsg(error);
+            console.error(`${lc} Outbound email error: ${emsg} (E: 23456789abcdef2a3b4c5d6e7f8a9b0c)`);
+            return this.error(500, `Outbound email error: ${emsg}`);
+        }
+    }
+}
+//# sourceMappingURL=email-outbound.handler.mjs.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * @module serve-gib/handlers/api/health
+ */
+import { ServeGibHandlerBase } from '../handler-base.mjs';
+import { RequestContext, ResponseResult, ServeGibHttpMethod } from '../../types.mjs';
+/**
+ * GET /api/health
+ */
+export declare class HealthHandler extends ServeGibHandlerBase {
+    protected method: ServeGibHttpMethod;
+    protected regex: RegExp;
+    protected handleRouteImpl(reqCtx: RequestContext): Promise<ResponseResult | undefined>;
+}
+//# sourceMappingURL=health.handler.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.handler.d.mts","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/api/health.handler.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrF;;GAEG;AACH,qBAAa,aAAc,SAAQ,mBAAmB;IAClD,UAAmB,MAAM,EAAE,kBAAkB,CAAS;IACtD,UAAmB,KAAK,SAA2B;IAEnD,UAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAM3F;CACJ"}

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

@@ -0,0 +1,21 @@
+/**
+ * @module serve-gib/handlers/api/health
+ */
+import { ServeGibHandlerBase } from '../handler-base.mjs';
+import { API_PATH_REGEXES } from '../../path-constants.mjs';
+/**
+ * GET /api/health
+ */
+export class HealthHandler extends ServeGibHandlerBase {
+    method = 'ALL';
+    regex = API_PATH_REGEXES.HEALTH;
+    async handleRouteImpl(reqCtx) {
+        if (reqCtx.method === 'GET') {
+            return this.ok({ status: 'ok', timestamp: new Date().toISOString() });
+        }
+        else {
+            throw new Error(`info.method !== 'GET' in ${HealthHandler.name} (E: bfff3c547b5827ca7845277804057f26)`);
+        }
+    }
+}
+//# sourceMappingURL=health.handler.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.handler.mjs","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/api/health.handler.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,mBAAmB;IAC/B,MAAM,GAAuB,KAAK,CAAC;IACnC,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAEzC,KAAK,CAAC,eAAe,CAAC,MAAsB;QAClD,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,4BAA4B,aAAa,CAAC,IAAI,wCAAwC,CAAC,CAAC;QAC5G,CAAC;IACL,CAAC;CACJ"}

package/dist/serve-gib/handlers/api/health.respec.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health.respec.d.mts.map

package/dist/serve-gib/handlers/api/health.respec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.respec.d.mts","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/api/health.respec.mts"],"names":[],"mappings":""}

package/dist/serve-gib/handlers/api/health.respec.mjs

@@ -0,0 +1,47 @@
+import { respecfully, iReckon, ifWe } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+import { ServeGib_V1 } from '../../serve-gib-v1.mjs';
+import { HealthHandler } from './health.handler.mjs';
+import { ErrorHandler } from '../error-handler.mjs';
+const sir = `[${import.meta.url}]`;
+await respecfully(sir, 'Health Handler Integration', async () => {
+    const testDataDir = './test-data-health';
+    const port = 3002;
+    await ifWe(sir, 'get a 200 OK from /api/health', async () => {
+        // 1. Setup ServeGib_V1
+        const serveGib = new ServeGib_V1({
+            port,
+            dataDir: testDataDir,
+            handlers: [new HealthHandler()],
+            errorHandler: new ErrorHandler()
+        });
+        // 2. Mock GET Request
+        const req = {
+            url: '/api/health',
+            method: 'GET',
+            headers: {},
+            on: (event, cb) => {
+                if (event === 'end') {
+                    cb();
+                }
+            }
+        };
+        let capturedStatus = 0;
+        let capturedBody = null;
+        const res = {
+            writeHead: (status) => {
+                capturedStatus = status;
+            },
+            end: (body) => {
+                capturedBody = JSON.parse(body);
+            },
+            statusCode: 0
+        };
+        // 3. Handle
+        await serveGib.handleRequest(req, res);
+        // 4. Verify
+        iReckon(sir, capturedStatus).asTo('captured status code').isGonnaBe(200);
+        iReckon(sir, capturedBody.status).asTo('captured body status').isGonnaBe('ok');
+        iReckon(sir, capturedBody.timestamp).asTo('captured body timestamp').isGonnaBe(capturedBody.timestamp);
+    });
+});
+//# sourceMappingURL=health.respec.mjs.map

package/dist/serve-gib/handlers/api/health.respec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.respec.mjs","sourceRoot":"","sources":["../../../../src/serve-gib/handlers/api/health.respec.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAa,MAAM,kDAAkD,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,GAAG,GAAG,IAAI,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC;AAEnC,MAAM,WAAW,CAAC,GAAG,EAAE,4BAA4B,EAAE,KAAK,IAAI,EAAE;IAC5D,MAAM,WAAW,GAAG,oBAAoB,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC;IAElB,MAAM,IAAI,CAAC,GAAG,EAAE,+BAA+B,EAAE,KAAK,IAAI,EAAE;QACxD,uBAAuB;QACvB,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC;YAC7B,IAAI;YACJ,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,CAAC,IAAI,aAAa,EAAE,CAAC;YAC/B,YAAY,EAAE,IAAI,YAAY,EAAE;SACnC,CAAC,CAAC;QAEH,sBAAsB;QACtB,MAAM,GAAG,GAAQ;YACb,GAAG,EAAE,aAAa;YAClB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE;YACX,EAAE,EAAE,CAAC,KAAa,EAAE,EAAO,EAAE,EAAE;gBAC3B,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;oBAAC,EAAE,EAAE,CAAC;gBAAC,CAAC;YAClC,CAAC;SACJ,CAAC;QAEF,IAAI,cAAc,GAAW,CAAC,CAAC;QAC/B,IAAI,YAAY,GAAQ,IAAI,CAAC;QAC7B,MAAM,GAAG,GAAQ;YACb,SAAS,EAAE,CAAC,MAAc,EAAE,EAAE;gBAC1B,cAAc,GAAG,MAAM,CAAC;YAC5B,CAAC;YACD,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE;gBAClB,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpC,CAAC;YACD,UAAU,EAAE,CAAC;SAChB,CAAC;QAEF,YAAY;QACZ,MAAM,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEvC,YAAY;QACZ,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,41 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,34 @@
+// #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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,26 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,179 @@
+/**
+ * @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

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

package/dist/serve-gib/handlers/api/keystone/keystone-check-email.handler.d.mts

@@ -0,0 +1,23 @@
+/**
+ * @module serve-gib/handlers/api/keystone/keystone-check-email.handler
+ *
+ * GET /api/keystone/check-email?email=foo@example.com
+ *
+ * Checks whether an email address is already registered in the server identity index.
+ */
+import { ServeGibHandlerBase } from '../../handler-base.mjs';
+import { RequestContext, ResponseResult, ServeGibHttpMethod } from '../../../types.mjs';
+/**
+ * GET /api/keystone/check-email
+ */
+export declare class KeystoneCheckEmailHandler extends ServeGibHandlerBase<undefined, {
+    email?: string;
+}> {
+    protected lc: string;
+    protected method: ServeGibHttpMethod;
+    protected regex: RegExp;
+    protected handleRouteImpl(reqCtx: RequestContext<undefined, {
+        email?: string;
+    }>): Promise<ResponseResult | undefined>;
+}
+//# sourceMappingURL=keystone-check-email.handler.d.mts.map

package/dist/serve-gib/handlers/api/keystone/keystone-check-email.handler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystone-check-email.handler.d.mts","sourceRoot":"","sources":["../../../../../src/serve-gib/handlers/api/keystone/keystone-check-email.handler.mts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxF;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,mBAAmB,CAAC,SAAS,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;IAC7F,UAAmB,EAAE,EAAE,MAAM,CAAyC;IACtE,UAAmB,MAAM,EAAE,kBAAkB,CAAS;IACtD,UAAmB,KAAK,SAAyC;IAEjE,UAAgB,eAAe,CAC3B,MAAM,EAAE,cAAc,CAAC,SAAS,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GACtD,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAgCrC;CACJ"}

package/dist/serve-gib/handlers/api/keystone/keystone-check-email.handler.mjs

@@ -0,0 +1,52 @@
+/**
+ * @module serve-gib/handlers/api/keystone/keystone-check-email.handler
+ *
+ * GET /api/keystone/check-email?email=foo@example.com
+ *
+ * Checks whether an email address is already registered in the server identity index.
+ */
+import * as path from 'node:path';
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { IdentityIndexService } from '../../../identity-index/identity-index-service.mjs';
+import { ServeGibHandlerBase } from '../../handler-base.mjs';
+import { API_PATH_REGEXES } from '../../../path-constants.mjs';
+/**
+ * GET /api/keystone/check-email
+ */
+export class KeystoneCheckEmailHandler extends ServeGibHandlerBase {
+    lc = `[${KeystoneCheckEmailHandler.name}]`;
+    method = 'GET';
+    regex = API_PATH_REGEXES.KEYSTONE_CHECK_EMAIL;
+    async handleRouteImpl(reqCtx) {
+        const lc = `${this.lc}[${this.handleRouteImpl.name}]`;
+        try {
+            // Anti-timing side-channel protection: add bounded random jitter delay (150ms-350ms)
+            const jitterMs = Math.floor(Math.random() * 200) + 150;
+            await new Promise(resolve => setTimeout(resolve, jitterMs));
+            const email = (reqCtx.queryParams?.email || '').trim();
+            if (!email) {
+                console.error(`${lc} Check-email request missing email query parameter.`);
+                return this.error(400, 'Query param email is required');
+            }
+            const indexService = new IdentityIndexService({ baseDir: path.join(reqCtx.dataDir, 'index') });
+            const record = await indexService.getEmailIndex({ email });
+            if (record) {
+                console.log(`${lc} Email '${email}' is already registered.`);
+                return this.ok({
+                    available: false,
+                    message: 'Email/Identity already registered'
+                });
+            }
+            console.log(`${lc} Email '${email}' is available.`);
+            return this.ok({
+                available: true
+            });
+        }
+        catch (error) {
+            const emsg = extractErrorMsg(error);
+            console.error(`${lc} ${emsg}`);
+            return this.error(500, emsg);
+        }
+    }
+}
+//# sourceMappingURL=keystone-check-email.handler.mjs.map

package/dist/serve-gib/handlers/api/keystone/keystone-check-email.handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystone-check-email.handler.mjs","sourceRoot":"","sources":["../../../../../src/serve-gib/handlers/api/keystone/keystone-check-email.handler.mts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAE1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,mBAAkD;IAC1E,EAAE,GAAW,IAAI,yBAAyB,CAAC,IAAI,GAAG,CAAC;IACnD,MAAM,GAAuB,KAAK,CAAC;IACnC,KAAK,GAAG,gBAAgB,CAAC,oBAAoB,CAAC;IAEvD,KAAK,CAAC,eAAe,CAC3B,MAAqD;QAErD,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC;QACtD,IAAI,CAAC;YACD,qFAAqF;YACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YACvD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,qDAAqD,CAAC,CAAC;gBAC1E,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,+BAA+B,CAAC,CAAC;YAC5D,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAC/F,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAE3D,IAAI,MAAM,EAAE,CAAC;gBACT,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,0BAA0B,CAAC,CAAC;gBAC7D,OAAO,IAAI,CAAC,EAAE,CAAC;oBACX,SAAS,EAAE,KAAK;oBAChB,OAAO,EAAE,mCAAmC;iBAC/C,CAAC,CAAC;YACP,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,iBAAiB,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,EAAE,CAAC;gBACX,SAAS,EAAE,IAAI;aAClB,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;IACL,CAAC;CACJ"}

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

@@ -0,0 +1,44 @@
+/**
+ * @module serve-gib/handlers/api/keystone/keystone-evolve.handler
+ *
+ * PUT /api/keystone/evolve/:domainAddr
+ *
+ * Receives an evolved domain keystone (`I^I1.Itjp`) and any related
+ * ibgibs (e.g., the `S^Stjp` session keystone).
+ *
+ * Validates the evolution, verifies the `S` session keystone, and persists
+ * them to the domain metaspace to authorize the sync session.
+ */
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { KeystoneIbGib_V1 } from '@ibgib/core-gib/dist/keystone/keystone-types.mjs';
+import { ServeGibHandlerWithMetaspaceBase } from '../../handler-base.mjs';
+import { ParamsWithDomain, RequestContext, ResponseResult } from '../../../types.mjs';
+interface EvolveParams extends ParamsWithDomain {
+    domainAddr: string;
+}
+/**
+ * Body payload for the Keystone Evolve REST API request.
+ */
+interface EvolveBody {
+    /** The main evolved keystone frame. */
+    keystoneIbGib: KeystoneIbGib_V1;
+    /**
+     * Array of other keystone frames related to this evolution.
+     * Ephemeral session keystones for sync, or persistent delegate keystones for manage.
+     */
+    relatedKeystoneIbGibs?: IbGib_V1[];
+    /** Optional map of providerId to token to revoke during unlinking. */
+    revokeTokens?: Record<string, string>;
+}
+export declare class KeystoneEvolveHandler extends ServeGibHandlerWithMetaspaceBase<EvolveParams, EvolveBody> {
+    protected lc: string;
+    protected method: 'PUT';
+    protected regex: RegExp;
+    protected parseParamsImpl(reqCtx: RequestContext<EvolveParams, any>): Promise<EvolveParams | undefined>;
+    protected validateQueryParams({ queryParams }: {
+        queryParams: any;
+    }): Promise<string[]>;
+    protected handleRouteImpl(reqCtx: RequestContext<EvolveParams>): Promise<ResponseResult>;
+}
+export {};
+//# sourceMappingURL=keystone-evolve.handler.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keystone-evolve.handler.d.mts","sourceRoot":"","sources":["../../../../../src/serve-gib/handlers/api/keystone/keystone-evolve.handler.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAKpF,OAAO,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAItF,UAAU,YAAa,SAAQ,gBAAgB;IAC3C,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,UAAU,UAAU;IAChB,uCAAuC;IACvC,aAAa,EAAE,gBAAgB,CAAC;IAChC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnC,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,qBAAa,qBAAsB,SAAQ,gCAAgC,CAAC,YAAY,EAAE,UAAU,CAAC;IACjG,UAAmB,EAAE,EAAE,MAAM,CAAqC;IAClE,UAAmB,MAAM,EAAE,KAAK,CAAS;IACzC,UAAmB,KAAK,SAAoC;IAE5D,UAAyB,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,YAAY,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAarH;IAED,UAAyB,mBAAmB,CAAC,EAAE,WAAW,EAAE,EAAE;QAAE,WAAW,EAAE,GAAG,CAAC;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEtG;IAED,UAAyB,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CA8EtG;CACJ"}