@zyno-io/ts-server-foundation 26.712.36

package/dist/src/helpers/security/crypto.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = exports.Crypto = exports.NumericCharacters = exports.UpperCaseAlphanumericCharacters = exports.AlphanumericCharacters = exports.PrintableCharacters = void 0;
+exports.randomBytes = randomBytes;
+exports.randomBytesSync = randomBytesSync;
+exports.randomString = randomString;
+exports.randomStringSync = randomStringSync;
+const tslib_1 = require("tslib");
+const crypto = tslib_1.__importStar(require("node:crypto"));
+const node_util_1 = require("node:util");
+const app_1 = require("../../app");
+const randomBytesAsync = (0, node_util_1.promisify)(crypto.randomBytes);
+async function randomBytes(length, shouldReturnHex) {
+    const bytes = await randomBytesAsync(length);
+    return shouldReturnHex ? bytes.toString('hex') : bytes;
+}
+function randomBytesSync(length, shouldReturnHex) {
+    const bytes = crypto.randomBytes(length);
+    return shouldReturnHex ? bytes.toString('hex') : bytes;
+}
+exports.PrintableCharacters = Array.from({ length: 127 - 32 }, (_, index) => String.fromCharCode(index + 32)).join('');
+exports.AlphanumericCharacters = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+exports.UpperCaseAlphanumericCharacters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+exports.NumericCharacters = '0123456789';
+async function randomString(length, source = exports.AlphanumericCharacters) {
+    return randomStringFromBytes(await randomBytes(length), source);
+}
+function randomStringSync(length, source = exports.AlphanumericCharacters) {
+    return randomStringFromBytes(randomBytesSync(length), source);
+}
+let _CryptoMetadata_1;
+class Crypto {
+    static instance;
+    static encrypt(data) {
+        return this.getInstance().encrypt(data);
+    }
+    static decrypt(data) {
+        return this.getInstance().decrypt(data);
+    }
+    static reset() {
+        this.instance = undefined;
+    }
+    static getInstance() {
+        this.instance ??= new Crypto();
+        return this.instance;
+    }
+    key;
+    ivLength;
+    constructor(options = {}) {
+        const config = options.secret === undefined ? (0, app_1.getAppConfig)() : undefined;
+        this.key = parseSecret(options.secret ?? config?.CRYPTO_SECRET);
+        this.ivLength = parseIvLength(options.ivLength ?? config?.CRYPTO_IV_LENGTH);
+    }
+    encrypt(data) {
+        const inputIsBuffer = Buffer.isBuffer(data);
+        const input = inputIsBuffer ? data : Buffer.from(data);
+        const iv = crypto.randomBytes(this.ivLength);
+        const cipher = crypto.createCipheriv('aes-256-gcm', this.key, iv);
+        const encrypted = Buffer.concat([cipher.update(input), cipher.final()]);
+        const output = Buffer.concat([iv, encrypted, cipher.getAuthTag()]);
+        return inputIsBuffer ? output : output.toString('base64');
+    }
+    decrypt(data) {
+        const inputIsBuffer = Buffer.isBuffer(data);
+        const input = inputIsBuffer ? data : parseEncryptedString(data);
+        if (input.length < this.ivLength + 16)
+            throw new Error('Invalid encrypted payload');
+        const iv = input.subarray(0, this.ivLength);
+        const authTag = input.subarray(input.length - 16);
+        const encrypted = input.subarray(this.ivLength, input.length - 16);
+        const decipher = crypto.createDecipheriv('aes-256-gcm', this.key, iv);
+        decipher.setAuthTag(authTag);
+        const output = Buffer.concat([decipher.update(encrypted), decipher.final()]);
+        return inputIsBuffer ? output : output.toString('utf8');
+    }
+    static __tsfType = _CryptoMetadata_1 = ({ kind: 16, name: "Crypto", typeName: "Crypto", classType: () => Crypto, properties: [], methods: [{ name: "encrypt", parameters: [{ name: "data", type: { kind: 6 }, optional: false, default: false }], returnType: { kind: 6 } }, { name: "encrypt", parameters: [{ name: "data", type: { kind: 16, typeName: "Buffer", classType: () => (typeof Buffer !== "undefined" ? Buffer : (typeof exports !== "undefined" ? exports.Buffer : undefined)) }, optional: false, default: false }], returnType: { kind: 16, typeName: "Buffer", classType: () => (typeof Buffer !== "undefined" ? Buffer : (typeof exports !== "undefined" ? exports.Buffer : undefined)) } }, { name: "encrypt", parameters: [{ name: "data", type: { kind: 12, types: [{ kind: 6 }, { kind: 16, typeName: "Buffer", classType: () => (typeof Buffer !== "undefined" ? Buffer : (typeof exports !== "undefined" ? exports.Buffer : undefined)) }] }, optional: false, default: false }], returnType: { kind: 12, types: [{ kind: 6 }, { kind: 16, typeName: "Buffer", classType: () => (typeof Buffer !== "undefined" ? Buffer : (typeof exports !== "undefined" ? exports.Buffer : undefined)) }] } }, { name: "decrypt", parameters: [{ name: "data", type: { kind: 6 }, optional: false, default: false }], returnType: { kind: 6 } }, { name: "decrypt", parameters: [{ name: "data", type: { kind: 16, typeName: "Buffer", classType: () => (typeof Buffer !== "undefined" ? Buffer : (typeof exports !== "undefined" ? exports.Buffer : undefined)) }, optional: false, default: false }], returnType: { kind: 16, typeName: "Buffer", classType: () => (typeof Buffer !== "undefined" ? Buffer : (typeof exports !== "undefined" ? exports.Buffer : undefined)) } }, { name: "decrypt", parameters: [{ name: "data", type: { kind: 12, types: [{ kind: 6 }, { kind: 16, typeName: "Buffer", classType: () => (typeof Buffer !== "undefined" ? Buffer : (typeof exports !== "undefined" ? exports.Buffer : undefined)) }] }, optional: false, default: false }], returnType: { kind: 12, types: [{ kind: 6 }, { kind: 16, typeName: "Buffer", classType: () => (typeof Buffer !== "undefined" ? Buffer : (typeof exports !== "undefined" ? exports.Buffer : undefined)) }] } }], hasConstructor: true, constructorParameters: [{ name: "options", type: { kind: 18, typeName: "CryptoOptions", types: [{ kind: 20, name: "secret", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "ivLength", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }] }, optional: true, default: true }] });
+}
+exports.Crypto = Crypto;
+_CryptoMetadata_1.classType = Crypto;
+Crypto.__tsfType = _CryptoMetadata_1;
+function randomStringFromBytes(bytes, source) {
+    if (!source.length)
+        throw new Error('randomString source must not be empty');
+    return Array.from({ length: bytes.length }, (_, index) => source[bytes[index] % source.length]).join('');
+}
+function parseSecret(secret) {
+    if (!secret)
+        throw new Error('CRYPTO_SECRET is not set in application configuration');
+    if (secret.length === 64 && /^[0-9a-f]+$/i.test(secret))
+        return Buffer.from(secret, 'hex');
+    const key = Buffer.from(secret);
+    if (key.length !== 32)
+        throw new Error('CRYPTO_SECRET must be 32 bytes or 64 hex characters');
+    return key;
+}
+function parseIvLength(ivLength) {
+    ivLength ??= 12;
+    if (!Number.isInteger(ivLength) || ivLength < 12)
+        throw new Error('CRYPTO_IV_LENGTH must be an integer of at least 12 bytes for AES-GCM');
+    return ivLength;
+}
+function parseEncryptedString(data) {
+    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(data) || data.length % 4 === 1)
+        throw new Error('Invalid encrypted payload');
+    return Buffer.from(data, 'base64');
+}
+exports.__tsfTypeAliases = ({ "CryptoOptions": { kind: 18, typeName: "CryptoOptions", types: [{ kind: 20, name: "secret", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "ivLength", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }] } });
+//# sourceMappingURL=crypto.js.map

package/dist/src/helpers/security/crypto.js.map

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

package/dist/src/helpers/security/validation.d.ts

@@ -0,0 +1,3 @@
+export declare function assertInput(value: unknown, field?: string): asserts value;
+export declare function isValidEmail(value: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/helpers/security/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/helpers/security/validation.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAIzE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/src/helpers/security/validation.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertInput = assertInput;
+exports.isValidEmail = isValidEmail;
+const http_1 = require("../../http");
+function assertInput(value, field) {
+    if (value === undefined || value === null || value === '') {
+        throw new http_1.HttpBadRequestError(field ? `${field} is required` : 'missing parameters');
+    }
+}
+function isValidEmail(value) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/helpers/security/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/helpers/security/validation.ts"],"names":[],"mappings":";;;;AAAA,qCAAiD;AAEjD,qBAA4B,KAAc,EAAE,KAAc;IACtD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,0BAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;IACzF,CAAC;AACL,CAAC;AAED,sBAA6B,KAAa;IACtC,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC"}

package/dist/src/helpers/utils/date.d.ts

@@ -0,0 +1,4 @@
+export declare function sleepMs(ms: number): Promise<void>;
+export declare function sleepSecs(seconds: number): Promise<void>;
+export declare function extractDate(date: Date | string | number): string;
+//# sourceMappingURL=date.d.ts.map

package/dist/src/helpers/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../../src/helpers/utils/date.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAGhE"}

package/dist/src/helpers/utils/date.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleepMs = sleepMs;
+exports.sleepSecs = sleepSecs;
+exports.extractDate = extractDate;
+function sleepMs(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function sleepSecs(seconds) {
+    return sleepMs(seconds * 1000);
+}
+function extractDate(date) {
+    const value = date instanceof Date ? date : new Date(date);
+    return value.toISOString().slice(0, 10);
+}
+//# sourceMappingURL=date.js.map

package/dist/src/helpers/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../../src/helpers/utils/date.ts"],"names":[],"mappings":";;;;;AAAA,iBAAwB,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,mBAA0B,OAAe;IACrC,OAAO,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,qBAA4B,IAA4B;IACpD,MAAM,KAAK,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/src/helpers/utils/error.d.ts

@@ -0,0 +1,20 @@
+export interface DecoratedError extends Error {
+    cause?: unknown;
+    context?: Record<string, unknown>;
+}
+export declare const SentryLiftKeysToTagsFromLoggerContext: string[];
+export interface IErrorContext {
+    scope?: string;
+    scopeData?: Record<string, unknown>;
+    loggerContext?: Record<string, unknown>;
+    data?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export declare function isError(value: unknown): value is Error;
+export declare function getErrorMessage(value: unknown): string;
+export declare function toError(value: unknown, cause?: unknown): Error;
+export declare function tryOrErrorSync<T>(fn: () => T): T | Error;
+export declare function tryOrError<T>(fn: () => T | Promise<T>): Promise<T | Error>;
+export declare function setGlobalErrorReporter(reporter: (level: number, err: Error, context: IErrorContext) => void): void;
+export declare function reportError(level: number, err: Error, context: IErrorContext): void;
+//# sourceMappingURL=error.d.ts.map

package/dist/src/helpers/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../src/helpers/utils/error.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAe,SAAQ,KAAK;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,qCAAqC,EAAE,MAAM,EAAO,CAAC;AAElE,MAAM,WAAW,aAAa;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAOD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAI9D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAMxD;AAED,wBAAsB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAMhF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAElH;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAsBnF"}

package/dist/src/helpers/utils/error.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = exports.SentryLiftKeysToTagsFromLoggerContext = void 0;
+exports.isError = isError;
+exports.getErrorMessage = getErrorMessage;
+exports.toError = toError;
+exports.tryOrErrorSync = tryOrErrorSync;
+exports.tryOrError = tryOrError;
+exports.setGlobalErrorReporter = setGlobalErrorReporter;
+exports.reportError = reportError;
+const types_1 = require("node:util/types");
+const node_1 = require("@sentry/node");
+const env_1 = require("../../env");
+const helpers_1 = require("../../telemetry/otel/helpers");
+const sentry_1 = require("../../telemetry/sentry");
+exports.SentryLiftKeysToTagsFromLoggerContext = [];
+const errorHandlerState = {};
+function isError(value) {
+    return value instanceof Error || (0, types_1.isNativeError)(value);
+}
+function getErrorMessage(value) {
+    return isError(value) ? value.message : String(value);
+}
+function toError(value, cause) {
+    const error = isError(value) ? value : new Error(String(value));
+    if (cause !== undefined)
+        error.cause = toError(cause);
+    return error;
+}
+function tryOrErrorSync(fn) {
+    try {
+        return fn();
+    }
+    catch (error) {
+        return toError(error);
+    }
+}
+async function tryOrError(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        return toError(error);
+    }
+}
+function setGlobalErrorReporter(reporter) {
+    errorHandlerState.reporter = reporter;
+}
+function reportError(level, err, context) {
+    try {
+        errorHandlerState.reporter?.(level, err, context);
+    }
+    catch (reporterError) {
+        console.error('Global error reporter failed', reporterError);
+    }
+    if ((0, sentry_1.isSentryInstalled)()) {
+        const loggerContext = context.loggerContext ?? {};
+        const tags = pickTagKeys(loggerContext, exports.SentryLiftKeysToTagsFromLoggerContext);
+        const Details = {
+            ...context,
+            loggerContext: omitKeys(loggerContext, exports.SentryLiftKeysToTagsFromLoggerContext)
+        };
+        (0, node_1.captureException)(err, {
+            tags,
+            extra: { Details },
+            level: level === 1 ? 'fatal' : level === 3 ? 'warning' : 'error'
+        });
+    }
+    if (level === 1) {
+        sendSlackAlertNotification(err, context);
+    }
+}
+async function sendSlackAlertNotification(err, context) {
+    try {
+        const traceContext = (0, helpers_1.getTraceContext)();
+        const url = getSlackWebhookUrl();
+        if (!url)
+            return;
+        await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                text: compact([`:rotating_light: *${err.message}*`, getCauseMessage(err.cause) && `cause: ${getCauseMessage(err.cause)}`]).join('\n'),
+                attachments: [
+                    {
+                        color: 'danger',
+                        fields: compact([
+                            context.scope && {
+                                title: 'Scope',
+                                value: context.scope,
+                                short: true
+                            },
+                            traceContext && {
+                                title: 'Trace ID',
+                                value: traceContext.traceId,
+                                short: true
+                            },
+                            context.data && {
+                                title: 'Alert Data',
+                                value: JSON.stringify(context.data, null, 2),
+                                short: false
+                            },
+                            err.context && {
+                                title: 'Error Context',
+                                value: JSON.stringify(err.context, null, 2),
+                                short: false
+                            },
+                            context.scopeData && {
+                                title: 'Scope Data',
+                                value: JSON.stringify(context.scopeData, null, 2),
+                                short: false
+                            },
+                            context.loggerContext && {
+                                title: 'Logger Context',
+                                value: JSON.stringify(context.loggerContext, null, 2),
+                                short: false
+                            }
+                        ])
+                    }
+                ]
+            })
+        });
+    }
+    catch (error) {
+        console.error('Failed to send slack alert notification', error);
+    }
+}
+function getSlackWebhookUrl() {
+    try {
+        // Lazy require avoids a load-time cycle through app -> services -> logger -> error.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { getCurrentApp } = require('../../app/base');
+        return getCurrentApp().config?.ALERTS_SLACK_WEBHOOK_URL ?? env_1.Env.ALERTS_SLACK_WEBHOOK_URL;
+    }
+    catch {
+        return env_1.Env.ALERTS_SLACK_WEBHOOK_URL;
+    }
+}
+function getCauseMessage(cause) {
+    if (!cause)
+        return undefined;
+    if (isError(cause))
+        return cause.message;
+    if (typeof cause === 'object' && 'message' in cause)
+        return String(cause.message);
+    return String(cause);
+}
+function compact(values) {
+    return values.filter(Boolean);
+}
+function pickTagKeys(source, keys) {
+    return Object.fromEntries(keys.filter(key => isPrimitive(source[key])).map(key => [key, source[key]]));
+}
+function omitKeys(source, keys) {
+    const blocked = new Set(keys);
+    return Object.fromEntries(Object.entries(source).filter(([key]) => !blocked.has(key)));
+}
+function isPrimitive(value) {
+    return value === undefined || value === null || ['string', 'number', 'boolean', 'bigint', 'symbol'].includes(typeof value);
+}
+exports.__tsfTypeAliases = ({ "DecoratedError": { kind: 18, typeName: "DecoratedError", types: [{ kind: 20, name: "cause", type: { kind: 12, types: [{ kind: 2 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "context", type: { kind: 12, types: [{ kind: 18, typeName: "Record", utilityType: "Record", typeArguments: [{ kind: 6 }, { kind: 2 }], index: { kind: 2 }, types: [] }, { kind: 4 }] }, optional: true }], implements: [{ kind: 16, typeName: "Error", classType: () => (typeof Error !== "undefined" ? Error : (typeof exports !== "undefined" ? exports.Error : undefined)) }] }, "IErrorContext": { kind: 18, typeName: "IErrorContext", types: [{ kind: 20, name: "scope", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "scopeData", type: { kind: 12, types: [{ kind: 18, typeName: "Record", utilityType: "Record", typeArguments: [{ kind: 6 }, { kind: 2 }], index: { kind: 2 }, types: [] }, { kind: 4 }] }, optional: true }, { kind: 20, name: "loggerContext", type: { kind: 12, types: [{ kind: 18, typeName: "Record", utilityType: "Record", typeArguments: [{ kind: 6 }, { kind: 2 }], index: { kind: 2 }, types: [] }, { kind: 4 }] }, optional: true }, { kind: 20, name: "data", type: { kind: 12, types: [{ kind: 18, typeName: "Record", utilityType: "Record", typeArguments: [{ kind: 6 }, { kind: 2 }], index: { kind: 2 }, types: [] }, { kind: 4 }] }, optional: true }], index: { kind: 2 } }, "SentryTagValue": { kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }, { kind: 9 }, { kind: 2, typeName: "symbol" }, { kind: 5 }, { kind: 4 }], typeName: "SentryTagValue" } });
+//# sourceMappingURL=error.js.map

package/dist/src/helpers/utils/error.js.map

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

package/dist/src/helpers/utils/uuid.d.ts

@@ -0,0 +1,5 @@
+import { randomUUID } from 'node:crypto';
+export declare const uuid4: typeof randomUUID;
+export declare const uuid7: () => string;
+export declare function uuid7FromDate(date: Date): string;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/src/helpers/utils/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../../../src/helpers/utils/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,eAAO,MAAM,KAAK,mBAAa,CAAC;AAChC,eAAO,MAAM,KAAK,cAAS,CAAC;AAI5B,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD"}

package/dist/src/helpers/utils/uuid.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuid7 = exports.uuid4 = void 0;
+exports.uuid7FromDate = uuid7FromDate;
+const node_crypto_1 = require("node:crypto");
+const uuidv7_1 = require("uuidv7");
+exports.uuid4 = node_crypto_1.randomUUID;
+exports.uuid7 = uuidv7_1.uuidv7;
+const v7Generator = new uuidv7_1.V7Generator();
+function uuid7FromDate(date) {
+    return v7Generator.generateOrResetCore(date.getTime(), 10000).toString();
+}
+//# sourceMappingURL=uuid.js.map

package/dist/src/helpers/utils/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../../src/helpers/utils/uuid.ts"],"names":[],"mappings":";;;;AAAA,6CAAyC;AACzC,mCAA6C;AAEhC,QAAA,KAAK,GAAG,wBAAU,CAAC;AACnB,QAAA,KAAK,GAAG,eAAM,CAAC;AAE5B,MAAM,WAAW,GAAG,IAAI,oBAAW,EAAE,CAAC;AAEtC,uBAA8B,IAAU;IACpC,OAAO,WAAW,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC9E,CAAC"}

package/dist/src/http/auth.d.ts

@@ -0,0 +1,20 @@
+import { ParsedJwt } from '../auth/jwt';
+import type { BaseEntity } from '../database';
+import type { EntityClass } from '../database/metadata';
+import { HttpRequest } from './request';
+import type { RouteParameterResolverContext } from './decorators';
+export declare function getJwtFromRequest<T extends object = Record<string, unknown>>(request: HttpRequest): Promise<ParsedJwt<T> | undefined>;
+export declare function getSubjectFromRequestJwt(request: HttpRequest): Promise<string | undefined>;
+export declare function resolveEntityFromRequestJwt<T extends BaseEntity>(contextOrRequest: RouteParameterResolverContext | HttpRequest, EntityClass: EntityClass<T>): Promise<T | undefined>;
+export interface EntityValidator<T extends BaseEntity> {
+    getEntityIdFromRequest(request: HttpRequest): Promise<unknown>;
+    validateEntity?(request: HttpRequest, entity: T): Promise<void> | void;
+}
+export declare function createAuthMiddleware<T extends BaseEntity>(EntityClass: EntityClass<T>): {
+    new (): {
+        handle(request: HttpRequest): Promise<void>;
+        getEntityIdFromRequest(request: HttpRequest): Promise<unknown>;
+        loadAndValidateEntity(request: HttpRequest, id: unknown): Promise<void>;
+    };
+};
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/http/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/http/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAO,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAIlE,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAW3I;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAGhG;AAED,wBAAsB,2BAA2B,CAAC,CAAC,SAAS,UAAU,EAClE,gBAAgB,EAAE,6BAA6B,GAAG,WAAW,EAC7D,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAOxB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,UAAU;IACjD,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,cAAc,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1E;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;;wBAKxD,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;wCAKX,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;uCAM/B,WAAW,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;;EAQpF"}

package/dist/src/http/auth.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = void 0;
+exports.getJwtFromRequest = getJwtFromRequest;
+exports.getSubjectFromRequestJwt = getSubjectFromRequestJwt;
+exports.resolveEntityFromRequestJwt = resolveEntityFromRequestJwt;
+exports.createAuthMiddleware = createAuthMiddleware;
+const jwt_1 = require("../auth/jwt");
+const database_1 = require("../database");
+const errors_1 = require("./errors");
+const request_1 = require("./request");
+const store_1 = require("./store");
+const ParsedJwtSymbol = Symbol('ParsedJwt');
+async function getJwtFromRequest(request) {
+    return (0, store_1.getOrCacheValue)(request, ParsedJwtSymbol, async () => {
+        const jwt = await jwt_1.JWT.processWithRequest(request);
+        if (!jwt)
+            return undefined;
+        if (!jwt.isValid) {
+            if (!jwt.isSignatureValid)
+                throw new errors_1.HttpUnauthorizedError('Invalid JWT signature');
+            if (!jwt.isNotExpired)
+                throw new errors_1.HttpUnauthorizedError('Expired JWT');
+            throw new errors_1.HttpUnauthorizedError('Invalid JWT');
+        }
+        return jwt;
+    });
+}
+async function getSubjectFromRequestJwt(request) {
+    const jwt = await getJwtFromRequest(request);
+    return jwt?.subject;
+}
+async function resolveEntityFromRequestJwt(contextOrRequest, EntityClass) {
+    const requestOnly = contextOrRequest instanceof request_1.HttpRequest;
+    const request = requestOnly ? contextOrRequest : contextOrRequest.request;
+    const entityId = await getSubjectFromRequestJwt(request);
+    const entity = entityId === undefined ? undefined : await (0, database_1.getEntityOrUndefined)(EntityClass, entityId);
+    if (!entity && !requestOnly && contextOrRequest.type?.isOptional?.() !== true)
+        throw new errors_1.HttpUnauthorizedError();
+    return entity;
+}
+function createAuthMiddleware(EntityClass) {
+    const entityIdCacheKey = { kind: 'auth-entity-id', EntityClass };
+    const entityCacheKey = { kind: 'auth-entity', EntityClass };
+    return class AuthMiddleware {
+        async handle(request) {
+            const entityId = await (0, store_1.getOrCacheValue)(request, entityIdCacheKey, () => this.getEntityIdFromRequest(request));
+            await this.loadAndValidateEntity(request, entityId);
+        }
+        async getEntityIdFromRequest(request) {
+            const id = await getSubjectFromRequestJwt(request);
+            if (!id)
+                throw new errors_1.HttpUnauthorizedError();
+            return id;
+        }
+        async loadAndValidateEntity(request, id) {
+            const validate = this.validateEntity;
+            if (!validate)
+                return;
+            const entity = await (0, store_1.getOrCacheValue)(request, entityCacheKey, () => (0, database_1.getEntityOrUndefined)(EntityClass, id));
+            if (!entity)
+                throw new errors_1.HttpUnauthorizedError();
+            await validate.call(this, request, entity);
+        }
+    };
+}
+exports.__tsfTypeAliases = ({ "EntityValidator": { kind: 18, typeName: "EntityValidator", types: [] } });
+//# sourceMappingURL=auth.js.map

package/dist/src/http/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/http/auth.ts"],"names":[],"mappings":"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"}

package/dist/src/http/base.d.ts

@@ -0,0 +1,57 @@
+import { type Server, type ServerResponse } from 'node:http';
+import type { BaseAppConfig } from '../app/config';
+import type { ScopedLogger } from '../services';
+import { type HttpCorsConfig } from './cors';
+import { HttpRequest } from './request';
+import { MemoryHttpResponse, type HttpResponse } from './response';
+import { HttpRouter } from './router';
+import { type StaticFilesOptions } from './static-files';
+import { type HttpUpgradeHandler } from './upgrade';
+export interface HttpServerRuntimeOptions<C extends BaseAppConfig = BaseAppConfig> {
+    config: C;
+    router: HttpRouter;
+    logger: ScopedLogger;
+    frameworkConfig?: Record<string, unknown>;
+    serverConfig?: Record<string, unknown>;
+    cors?: HttpCorsConfig<C>;
+    staticFiles?: boolean | StaticFilesOptions;
+    packageName?: string;
+    devConsoleEnabled?: boolean;
+    listenHooks?: HttpServerListenHooks | (() => HttpServerListenHooks);
+}
+export interface HttpServerListenHooks {
+    start?: () => Promise<void>;
+    afterListen?: (server: Server) => Promise<void>;
+    onListenError?: (error: unknown) => Promise<void>;
+}
+export interface HttpRequestObservation {
+    request: HttpRequest;
+    response: HttpResponse;
+    startedAt: number;
+    durationMs: number;
+    error?: unknown;
+}
+export type HttpRequestObserver = (entry: HttpRequestObservation) => void;
+export declare class HttpServerRuntime<C extends BaseAppConfig = BaseAppConfig> {
+    private readonly options;
+    private readonly corsOptions;
+    private readonly staticFiles?;
+    private readonly appLogger;
+    private readonly requestLogger;
+    private readonly upgradeHandlers;
+    private readonly observers;
+    private server?;
+    constructor(options: HttpServerRuntimeOptions<C>);
+    request(request: HttpRequest, response?: HttpResponse): Promise<HttpResponse>;
+    listen(port?: number, host?: string, hooks?: HttpServerListenHooks): Promise<Server>;
+    registerUpgradeHandler(handler: HttpUpgradeHandler): () => void;
+    registerObserver(observer: HttpRequestObserver): () => void;
+    close(): Promise<void>;
+    private notifyObservers;
+    getPort(explicitPort?: number): number;
+    private shouldLogStartupDetails;
+    private handleNodeRequest;
+}
+export declare function writeNodeResponse(outgoing: ServerResponse, response: MemoryHttpResponse): void;
+export declare function writeUnhandledNodeError(outgoing: ServerResponse, error: unknown): void;
+//# sourceMappingURL=base.d.ts.map

package/dist/src/http/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/http/base.ts"],"names":[],"mappings":"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"}