@ibgib/node-gib 0.0.10 → 0.0.14

package/dist/serve-gib/path-helper.mjs

@@ -0,0 +1,107 @@
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { validateIbGibAddr } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from './server-constants.mjs';
+import { FORBIDDEN_PATTERNS, MAX_PATH_LENGTH, VALID_STATIC_PATH_REGEX } from './path-constants.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * little helper function just to DRY out code.
+ */
+export function runtimeErrorValidationStrings(lc, error) {
+    const emsg = `${lc} ${extractErrorMsg(error)}`;
+    console.error(emsg);
+    return [`runtime error: ${emsg}`];
+}
+/**
+ * Validates that a path is safe from common attacks and under max length.
+ */
+export function validateRawPath(rawPath) {
+    const lc = `[${validateRawPath.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 80bd6f63e6c83b8e943b90383e044826)`);
+        }
+        const errors = [];
+        if (!rawPath || rawPath.length > MAX_PATH_LENGTH) {
+            errors.push(`path too long. MAX_PATH_LENGTH: ${MAX_PATH_LENGTH}, incoming path length: ${rawPath.length}`);
+        }
+        for (const pattern of FORBIDDEN_PATTERNS) {
+            if (pattern.test(rawPath)) {
+                errors.push(`invalid path. contains forbidden pattern.source: ${pattern.source} (E: 56a228fb9473a086b83d0088b5af1826)`);
+            }
+        }
+        return errors;
+    }
+    catch (error) {
+        return runtimeErrorValidationStrings(lc, error);
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+/**
+ * simple boolean wrapper for {@link validateRawPath}
+ */
+export function isSafePath(path) {
+    const errors = validateRawPath(path);
+    return errors.length === 0;
+}
+export function validateStaticPath(path) {
+    const lc = `[${validateStaticPath.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 4f9cf8ffd528c7dd88324529528eeb26)`);
+        }
+        const errors = [];
+        if (!VALID_STATIC_PATH_REGEX.test(path)) {
+            errors.push(`static path fails to match VALID_STATIC_PATH_REGEX of ${VALID_STATIC_PATH_REGEX} (E: dfdf38a0439d4d09186e6fa81ab66826) `);
+        }
+        return errors;
+    }
+    catch (error) {
+        return runtimeErrorValidationStrings(lc, error);
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+/**
+ * Validates a static file path.
+ */
+export function isValidStaticPath(path) {
+    if (!isSafePath(path)) {
+        return false;
+    }
+    const errors = validateStaticPath(path);
+    return errors.length === 0;
+}
+/**
+ * Decodes and validates a single ibGib address segment from a URL path.
+ * Uses the library's internal validateIbGibAddr for deep checking.
+ */
+export function validateAddressSegment(encodedAddr) {
+    const lc = `[${validateAddressSegment.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 1bb9ff7e1aefb77b670b2519658cc126)`);
+        }
+        if (!encodedAddr) {
+            throw new Error(`(UNEXPECTED) falsy encodedAddr? We're expecting to have already guaranteed there are no double-slashes (i.e. no empty segments) (E: 7be7668e7b8c9fbbdf56f0fe19f92e26)`);
+        }
+        const addr = decodeURIComponent(encodedAddr);
+        const errors = validateIbGibAddr({ addr });
+        return errors ?? [];
+    }
+    catch (error) {
+        return runtimeErrorValidationStrings(lc, error);
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=path-helper.mjs.map

package/dist/serve-gib/path-helper.mjs.map

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

package/dist/serve-gib/path-helper.respec.d.mts

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

package/dist/serve-gib/path-helper.respec.d.mts.map

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

package/dist/serve-gib/path-helper.respec.mjs

@@ -0,0 +1,83 @@
+// import { respecfully, iReckon, ifWe } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+// import {
+//     isSafePath, isValidStaticPath,
+//     // API_PATHS, getPathParams, MAX_PATH_LENGTH,
+//     validateAddressSegment
+// } from './path-helper.mjs';
+// import { MAX_PATH_LENGTH } from './path-constants.mts';
+export {};
+// const sir = `[${import.meta.url}]`;
+// await respecfully(sir, 'Path Helper Validation', async () => {
+//     await respecfully(sir, 'isSafePath', async () => {
+//         await ifWe(sir, 'valid simple paths', async () => {
+//             iReckon(sir, isSafePath('/api/health')).isGonnaBeTrue();
+//             iReckon(sir, isSafePath('/index.html')).isGonnaBeTrue();
+//         });
+//         await ifWe(sir, 'too long paths', async () => {
+//             const longPath = '/'.repeat(MAX_PATH_LENGTH + 1);
+//             iReckon(sir, isSafePath(longPath)).isGonnaBeFalse();
+//         });
+//         await ifWe(sir, 'directory traversal attempts', async () => {
+//             iReckon(sir, isSafePath('/../etc/passwd')).isGonnaBeFalse();
+//             iReckon(sir, isSafePath('/api/../../etc/passwd')).isGonnaBeFalse();
+//         });
+//         await ifWe(sir, 'null bytes', async () => {
+//             iReckon(sir, isSafePath('/api/health\0')).isGonnaBeFalse();
+//         });
+//         await ifWe(sir, 'redundant slashes', async () => {
+//             iReckon(sir, isSafePath('/api//health')).isGonnaBeFalse();
+//         });
+//         await ifWe(sir, 'dot-file access', async () => {
+//             iReckon(sir, isSafePath('/.env')).isGonnaBeFalse();
+//             iReckon(sir, isSafePath('/scripts/.hidden')).isGonnaBeFalse();
+//             iReckon(sir, isSafePath('/.git/config')).isGonnaBeFalse();
+//         });
+//     });
+//     await respecfully(sir, 'validateAddressSegment', async () => {
+//         await ifWe(sir, 'valid encoded addresses', async () => {
+//             const validGib = 'a'.repeat(64);
+//             iReckon(sir, validateAddressSegment(`someib%5E${validGib}`)).isGonnaBeTrue();
+//             // gib with dots (common in sha256.sha256)
+//             const dotGib = `${validGib}.${validGib}`;
+//             iReckon(sir, validateAddressSegment(`someib%5E${dotGib}`)).isGonnaBeTrue();
+//         });
+//         await ifWe(sir, 'invalid encoded addresses', async () => {
+//             iReckon(sir, validateAddressSegment('no_delim')).isGonnaBeFalse();
+//             iReckon(sir, validateAddressSegment('%5Estarts_with_delim')).isGonnaBeFalse();
+//             iReckon(sir, validateAddressSegment('too%5Emany%5Edelims')).isGonnaBeFalse();
+//             iReckon(sir, validateAddressSegment('too%5Emany..dots')).isGonnaBeFalse();
+//             iReckon(sir, validateAddressSegment('invalid_chars_!%5Eabc')).isGonnaBeFalse();
+//         });
+//     });
+//     await respecfully(sir, 'API_PATHS Regexes', async () => {
+//         await ifWe(sir, 'HEALTH regex', async () => {
+//             iReckon(sir, API_PATHS.HEALTH.test('/api/health')).isGonnaBeTrue();
+//             iReckon(sir, API_PATHS.HEALTH.test('/api/health/')).isGonnaBeTrue();
+//             iReckon(sir, API_PATHS.HEALTH.test('/api/health/more')).isGonnaBeFalse();
+//         });
+//         await ifWe(sir, 'IBGIB_ADDR regex', async () => {
+//             // valid encoded addr: someib%5Esomegib
+//             const addr = '/api/ibgib/someib%5Esomegib';
+//             iReckon(sir, API_PATHS.IBGIB_ADDR.test(addr)).isGonnaBeTrue();
+//             const params = getPathParams(addr, API_PATHS.IBGIB_ADDR);
+//             iReckon(sir, params?.[0]).isGonnaBe('someib%5Esomegib');
+//         });
+//         await ifWe(sir, 'IBGIB_GRAPH regex', async () => {
+//             const path = '/api/ibgib/graph/someib%5Esomegib';
+//             iReckon(sir, API_PATHS.IBGIB_GRAPH.test(path)).isGonnaBeTrue();
+//             const params = getPathParams(path, API_PATHS.IBGIB_GRAPH);
+//             iReckon(sir, params?.[0]).isGonnaBe('someib%5Esomegib');
+//         });
+//         await ifWe(sir, 'KEYSTONE regex', async () => {
+//             iReckon(sir, API_PATHS.KEYSTONE.test('/api/keystone')).isGonnaBeTrue();
+//             iReckon(sir, API_PATHS.KEYSTONE.test('/api/keystone/')).isGonnaBeTrue();
+//         });
+//         await ifWe(sir, 'KEYSTONE_EVOLVE regex', async () => {
+//             const path = '/api/keystone/evolve/someib%5Esomegib';
+//             iReckon(sir, API_PATHS.KEYSTONE_EVOLVE.test(path)).isGonnaBeTrue();
+//             const params = getPathParams(path, API_PATHS.KEYSTONE_EVOLVE);
+//             iReckon(sir, params?.[0]).isGonnaBe('someib%5Esomegib');
+//         });
+//     });
+// });
+//# sourceMappingURL=path-helper.respec.mjs.map

package/dist/serve-gib/path-helper.respec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-helper.respec.mjs","sourceRoot":"","sources":["../../src/serve-gib/path-helper.respec.mts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,WAAW;AACX,qCAAqC;AACrC,oDAAoD;AACpD,6BAA6B;AAC7B,8BAA8B;AAC9B,0DAA0D;;AAE1D,sCAAsC;AAEtC,iEAAiE;AAEjE,yDAAyD;AACzD,8DAA8D;AAC9D,uEAAuE;AACvE,uEAAuE;AACvE,cAAc;AAEd,0DAA0D;AAC1D,gEAAgE;AAChE,mEAAmE;AACnE,cAAc;AAEd,wEAAwE;AACxE,2EAA2E;AAC3E,kFAAkF;AAClF,cAAc;AAEd,sDAAsD;AACtD,0EAA0E;AAC1E,cAAc;AAEd,6DAA6D;AAC7D,yEAAyE;AACzE,cAAc;AAEd,2DAA2D;AAC3D,kEAAkE;AAClE,6EAA6E;AAC7E,yEAAyE;AACzE,cAAc;AACd,UAAU;AAEV,qEAAqE;AACrE,mEAAmE;AACnE,+CAA+C;AAC/C,4FAA4F;AAC5F,yDAAyD;AACzD,wDAAwD;AACxD,0FAA0F;AAC1F,cAAc;AAEd,qEAAqE;AACrE,iFAAiF;AACjF,6FAA6F;AAC7F,4FAA4F;AAC5F,yFAAyF;AACzF,8FAA8F;AAC9F,cAAc;AACd,UAAU;AAEV,gEAAgE;AAChE,wDAAwD;AACxD,kFAAkF;AAClF,mFAAmF;AACnF,wFAAwF;AACxF,cAAc;AAEd,4DAA4D;AAC5D,sDAAsD;AACtD,0DAA0D;AAC1D,6EAA6E;AAE7E,wEAAwE;AACxE,uEAAuE;AACvE,cAAc;AAEd,6DAA6D;AAC7D,gEAAgE;AAChE,8EAA8E;AAE9E,yEAAyE;AACzE,uEAAuE;AACvE,cAAc;AAEd,0DAA0D;AAC1D,sFAAsF;AACtF,uFAAuF;AACvF,cAAc;AAEd,iEAAiE;AACjE,oEAAoE;AACpE,kFAAkF;AAElF,6EAA6E;AAC7E,uEAAuE;AACvE,cAAc;AACd,UAAU;AACV,MAAM"}

package/dist/serve-gib/serve-gib-helpers.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @module serve-gib/serve-gib-helpers
+ *
+ * General purpose helper functions for the serve-gib framework.
+ */
+/**
+ * Validates and coerces a boolean query parameter in place on the queryParams object.
+ *
+ * @param queryParams The parsed query parameters object
+ * @param key The specific key to validate and coerce
+ * @param errors Array to push error messages into if validation fails
+ */
+export declare function validateAndCoerceBooleanQueryParam(queryParams: any, key: string, errors: string[]): void;
+//# sourceMappingURL=serve-gib-helpers.d.mts.map

package/dist/serve-gib/serve-gib-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-gib-helpers.d.mts","sourceRoot":"","sources":["../../src/serve-gib/serve-gib-helpers.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAC9C,WAAW,EAAE,GAAG,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EAAE,GACjB,IAAI,CAcN"}

package/dist/serve-gib/serve-gib-helpers.mjs

@@ -0,0 +1,30 @@
+/**
+ * @module serve-gib/serve-gib-helpers
+ *
+ * General purpose helper functions for the serve-gib framework.
+ */
+/**
+ * Validates and coerces a boolean query parameter in place on the queryParams object.
+ *
+ * @param queryParams The parsed query parameters object
+ * @param key The specific key to validate and coerce
+ * @param errors Array to push error messages into if validation fails
+ */
+export function validateAndCoerceBooleanQueryParam(queryParams, key, errors) {
+    const rawVal = queryParams[key];
+    if (typeof rawVal === 'string' &&
+        (rawVal.toLowerCase() === 'true' || rawVal.toLowerCase() === 'false')) {
+        queryParams[key] = rawVal.toLowerCase() === 'true';
+    }
+    else if (typeof rawVal === 'boolean') {
+        // do nothing, it's already a boolean
+    }
+    else if (rawVal !== undefined) {
+        errors.push(`invalid value for "${key}". typeof should either be string or boolean. (E: c28ef87a2d4b4a6faef9a2c8db05b637)`);
+    }
+    else {
+        // It's undefined, which means it wasn't provided in the URL.
+        // We do not error here because default parameters apply later or it may be optional.
+    }
+}
+//# sourceMappingURL=serve-gib-helpers.mjs.map

package/dist/serve-gib/serve-gib-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-gib-helpers.mjs","sourceRoot":"","sources":["../../src/serve-gib/serve-gib-helpers.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,kCAAkC,CAC9C,WAAgB,EAChB,GAAW,EACX,MAAgB;IAEhB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAC1B,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,EACvE,CAAC;QACC,WAAW,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;IACvD,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,qCAAqC;IACzC,CAAC;SAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,qFAAqF,CAAC,CAAC;IAChI,CAAC;SAAM,CAAC;QACJ,6DAA6D;QAC7D,qFAAqF;IACzF,CAAC;AACL,CAAC"}

package/dist/serve-gib/serve-gib-v1.d.mts

@@ -0,0 +1,40 @@
+/**
+ * @module serve-gib/serve-gib-v1
+ *
+ * The main entry point for processing incoming requests in the serve-gib
+ * framework.
+ */
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { RequestContext, ServeGibHandler } from './types.mjs';
+export interface ServeGibOptions {
+    /** Pipeline of handlers to check in order. */
+    handlers: ServeGibHandler<any, any>[];
+    /** Dedicated handler for errors (404, 500, etc.). */
+    errorHandler: ServeGibHandler<any, any>;
+    /** Port the server is listening on. */
+    port: number;
+    /**
+     * Root data directory for the server. We will use this as the root dir for
+     * all spaces that house multitenant ibgib data.
+     */
+    dataDir: string;
+}
+export declare class ServeGib_V1 {
+    private options;
+    private lc;
+    constructor(options: ServeGibOptions);
+    /**
+     * Entry point for all incoming HTTP requests.
+     */
+    handleRequest(req: IncomingMessage, res: ServerResponse): Promise<void>;
+    /**
+     * Builds request context (e.g. extracting/decoding URL, path segments, body
+     * content, etc.), and initializes the request's metaspace if applicable.
+     */
+    prepareContext(req: IncomingMessage): Promise<RequestContext>;
+    /** Reads the full request body as UTF-8. */
+    private readBody;
+    /** Sends the response result to the client. */
+    private sendResponse;
+}
+//# sourceMappingURL=serve-gib-v1.d.mts.map

package/dist/serve-gib/serve-gib-v1.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-gib-v1.d.mts","sourceRoot":"","sources":["../../src/serve-gib/serve-gib-v1.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAK5D,OAAO,EAAE,cAAc,EAAkB,eAAe,EAAsB,MAAM,aAAa,CAAC;AAIlG,MAAM,WAAW,eAAe;IAC5B,8CAA8C;IAC9C,QAAQ,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IACtC,qDAAqD;IACrD,YAAY,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,WAAW;IAGR,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,EAAE,CAA2B;IAErC,YAAoB,OAAO,EAAE,eAAe,EAAK;IAEjD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD5E;IAED;;;OAGG;IACU,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAyCzE;IAED,4CAA4C;IAC5C,OAAO,CAAC,QAAQ;IAShB,+CAA+C;IAC/C,OAAO,CAAC,YAAY;CAsBvB"}

package/dist/serve-gib/serve-gib-v1.mjs

@@ -0,0 +1,157 @@
+/**
+ * @module serve-gib/serve-gib-v1
+ *
+ * The main entry point for processing incoming requests in the serve-gib
+ * framework.
+ */
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from './constants.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+export class ServeGib_V1 {
+    options;
+    lc = `[${ServeGib_V1.name}]`;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Entry point for all incoming HTTP requests.
+     */
+    async handleRequest(req, res) {
+        const lc = `${this.lc}[${this.handleRequest.name}]`;
+        const start = Date.now();
+        let reqCtx;
+        try {
+            // Contextualize the request
+            reqCtx = await this.prepareContext(req);
+            if (!reqCtx) {
+                throw new Error(`(UNEXPECTED) reqCtx falsy? couldn't prepare context? (E: 401888c0f649dfdf0e2d21f86b3ff826)`);
+            }
+            // Execute pipeline
+            let result;
+            for (const handler of this.options.handlers) {
+                result = await handler.handleRoute(reqCtx);
+                if (result) {
+                    break;
+                }
+            }
+            // Fallback if no handler matched
+            if (!result) {
+                result = await this.options.errorHandler.handleRoute(reqCtx);
+            }
+            // Final output
+            if (result) {
+                this.sendResponse(res, result);
+            }
+            else {
+                // If even the error handler didn't produce a result
+                this.sendResponse(res, { status: 404, body: 'Not Found' });
+            }
+        }
+        catch (error) {
+            console.error(`${lc} Fatal error handling ${req.method} ${req.url}: ${extractErrorMsg(error)}`);
+            try {
+                // Try to use the error handler for the fatal error
+                if (reqCtx) {
+                    const errorResult = await this.options.errorHandler.handleRoute(reqCtx);
+                    this.sendResponse(res, errorResult ?? { status: 500, body: 'Internal Server Error' });
+                }
+                else {
+                    throw new Error(`errored before reqCtx could be set. (E: d77ab84b4f8874e188cfa8e9895f1226)`);
+                }
+            }
+            catch (innerError) {
+                // Total collapse fallback
+                console.error(`${lc} Collapse in error handler: ${extractErrorMsg(innerError)}`);
+                res.writeHead(500);
+                res.end('Critical Server Error');
+            }
+        }
+        finally {
+            const duration = Date.now() - start;
+            // Standard access logging
+            console.log(`${lc} ${req.method} ${req.url} -> ${res.statusCode} (${duration}ms)`);
+        }
+    }
+    /**
+     * Builds request context (e.g. extracting/decoding URL, path segments, body
+     * content, etc.), and initializes the request's metaspace if applicable.
+     */
+    async prepareContext(req) {
+        const lc = `${this.lc}[${this.prepareContext.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: ad9e9c678d0538c2d1e16ca8063d4426)`);
+            }
+            /**
+             * These are NOT all of the validation we do on the context, rather,
+             * it is just simple initial validation.
+             */
+            const initialValidationErrors = [];
+            const rawUrl = req.url ?? '/';
+            const protocol = req.headers['x-forwarded-proto'] || 'http'; // todo: who owns the req.headers? Can an attacker manipulate this?
+            const url = new URL(rawUrl, `${protocol}://localhost:${this.options.port}`); // todo: wth?? Why are we hard-coding localhost? in the URL object?
+            const pathname = url.pathname;
+            const rawPathSegments = pathname.split('/');
+            const decodedPathSegments = rawPathSegments.map(s => decodeURIComponent(s));
+            const body = await this.readBody(req);
+            const reqCtx = {
+                rawUrl,
+                pathname,
+                method: req.method?.toUpperCase() ?? 'GET',
+                protocol,
+                body,
+                rawPathSegments,
+                decodedPathSegments,
+                url,
+                dataDir: this.options.dataDir,
+                headers: req.headers,
+            };
+            return reqCtx;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /** Reads the full request body as UTF-8. */
+    readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on('data', (chunk) => chunks.push(chunk));
+            req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+            req.on('error', reject);
+        });
+    }
+    /** Sends the response result to the client. */
+    sendResponse(res, result) {
+        const lc = `${this.lc}[${this.sendResponse.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 37369cf120c14780e8652bf27ada1726)`);
+            }
+            const { status, headers = {}, body, isJson = false } = result;
+            let payload = body;
+            if (isJson) {
+                headers['Content-Type'] = 'application/json; charset=utf-8';
+                payload = JSON.stringify(body);
+            }
+            res.writeHead(status, headers);
+            res.end(payload);
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=serve-gib-v1.mjs.map

package/dist/serve-gib/serve-gib-v1.mjs.map

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

package/dist/serve-gib/serve-gib.respec.d.mts

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

package/dist/serve-gib/serve-gib.respec.d.mts.map

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

package/dist/serve-gib/serve-gib.respec.mjs

@@ -0,0 +1,85 @@
+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 './handlers/api/health.handler.mjs';
+import { ErrorHandler } from './handlers/error-handler.mjs';
+const sir = `[${import.meta.url}]`;
+await respecfully(sir, 'ServeGib ServeGib_V1', async () => {
+    await ifWe(sir, 'construct a RouteInfo object', async () => {
+        const serveGib = new ServeGib_V1({
+            port: 3000,
+            dataDir: './test-data',
+            handlers: [],
+            errorHandler: new ErrorHandler()
+        });
+        // Mock request
+        const req = {
+            url: '/api/health?foo=bar',
+            method: 'GET',
+            headers: { 'x-forwarded-proto': 'https' },
+            on: (event, cb) => {
+                if (event === 'end') {
+                    cb();
+                }
+            } // immediate end for readBody
+        };
+        const info = await serveGib.prepareContext(req);
+        iReckon(sir, info.pathname).isGonnaBe('/api/health');
+        iReckon(sir, info.method).isGonnaBe('GET');
+        iReckon(sir, info.protocol).isGonnaBe('https');
+        iReckon(sir, info.decodedPathSegments).includes('api');
+        iReckon(sir, info.decodedPathSegments).includes('health');
+    });
+    await ifWe(sir, 'execute a handler in the pipeline', async () => {
+        const health = new HealthHandler();
+        const serveGib = new ServeGib_V1({
+            port: 3000,
+            dataDir: './test-data',
+            handlers: [health],
+            errorHandler: new ErrorHandler()
+        });
+        // Mock objects
+        const req = {
+            url: '/api/health',
+            method: 'GET',
+            headers: {},
+            on: (event, cb) => {
+                if (event === 'end') {
+                    cb();
+                }
+            }
+        };
+        const res = {
+            writeHead: () => { },
+            end: () => { },
+            statusCode: 200
+        };
+        await serveGib.handleRequest(req, res);
+        iReckon(sir, res.statusCode).isGonnaBe(200);
+    });
+    await ifWe(sir, 'fall back to error handler when no handler matches', async () => {
+        const serveGib = new ServeGib_V1({
+            port: 3000,
+            dataDir: './test-data',
+            handlers: [],
+            errorHandler: new ErrorHandler()
+        });
+        const req = {
+            url: '/not/found',
+            method: 'GET',
+            headers: {},
+            on: (event, cb) => {
+                if (event === 'end') {
+                    cb();
+                }
+            }
+        };
+        const res = {
+            writeHead: () => { },
+            end: () => { },
+            statusCode: 404
+        };
+        await serveGib.handleRequest(req, res);
+        iReckon(sir, res.statusCode).isGonnaBe(404);
+    });
+});
+//# sourceMappingURL=serve-gib.respec.mjs.map

package/dist/serve-gib/serve-gib.respec.mjs.map

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

package/dist/serve-gib/server-constants.d.mts

@@ -0,0 +1,3 @@
+export declare const GLOBAL_LOG_A_LOT = false;
+export declare const GLOBAL_TIMER_NAME = "[space^gib server timer]";
+//# sourceMappingURL=server-constants.d.mts.map

package/dist/serve-gib/server-constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-constants.d.mts","sourceRoot":"","sources":["../../src/serve-gib/server-constants.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,iBAAiB,6BAA6B,CAAC"}

package/dist/serve-gib/server-constants.mjs

@@ -0,0 +1,3 @@
+export const GLOBAL_LOG_A_LOT = false;
+export const GLOBAL_TIMER_NAME = '[space^gib server timer]';
+//# sourceMappingURL=server-constants.mjs.map

package/dist/serve-gib/server-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-constants.mjs","sourceRoot":"","sources":["../../src/serve-gib/server-constants.mts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC"}