@zyno-io/ts-server-foundation 26.712.36

package/dist/src/type-compiler/index.cjs

@@ -0,0 +1,6 @@
+const path = require('node:path');
+
+module.exports = context => ({
+    name: 'tsf-type-metadata',
+    source: path.join(context.dirname, 'go')
+});

package/dist/src/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { AbstractClassType, ClassType, TypeAnnotation } from '../reflection';
+export { assert, cast, is } from '../reflection';
+export * from './primitives';
+export * from './type-annotations';
+export * from './phone';
+export * from './runtime';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACjD,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/src/types/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = exports.is = exports.cast = exports.assert = void 0;
+const tslib_1 = require("tslib");
+var reflection_1 = require("../reflection");
+Object.defineProperty(exports, "assert", { enumerable: true, get: function () { return reflection_1.assert; } });
+Object.defineProperty(exports, "cast", { enumerable: true, get: function () { return reflection_1.cast; } });
+Object.defineProperty(exports, "is", { enumerable: true, get: function () { return reflection_1.is; } });
+tslib_1.__exportStar(require("./primitives"), exports);
+tslib_1.__exportStar(require("./type-annotations"), exports);
+tslib_1.__exportStar(require("./phone"), exports);
+tslib_1.__exportStar(require("./runtime"), exports);
+exports.__tsfTypeAliases = ({ "ArrowFunction": { kind: 2, typeName: "(...args: any[]) => any", typeName: "ArrowFunction" }, "ArrowFunctionNoArgs": { kind: 2, typeName: "() => any", typeName: "ArrowFunctionNoArgs" }, "ConcretePrimitive": { kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }], typeName: "ConcretePrimitive" }, "DateString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^\\d{4}-\\d{2}-\\d{2}$" }] }] }, { kind: 2, typeName: "DatabaseField", database: { "*": { type: "DATE" } } }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "date" } } }], typeName: "DateString" }, "DefinedPrimitive": { kind: 12, types: [{ kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }], typeName: "ConcretePrimitive" }, { kind: 5 }], typeName: "DefinedPrimitive" }, "EmailAddress": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^[a-zA-Z0-9_+.-]+@[a-zA-Z0-9-.]+\\.[a-zA-Z]+$" }] }] }], typeName: "EmailAddress" }, "HasDefault": { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:hasDefault": { kind: 4 } }, typeName: "HasDefault" }, "MySQLCoordinate": { kind: 13, types: [{ kind: 16, typeName: "Coordinate", classType: () => (typeof Coordinate !== "undefined" ? Coordinate : (typeof exports !== "undefined" ? exports.Coordinate : undefined)) }, { kind: 2, typeName: "MySQL", database: { mysql: { type: "point" } } }], typeName: "MySQLCoordinate" }, "NonEmptyTrimmedString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:trim": { kind: 4 } } }, { kind: 2, typeName: "MinLength", validation: [{ name: "minLength", args: [{ kind: 10, literal: 1 }] }] }], typeName: "NonEmptyTrimmedString" }, "NullableMySQLCoordinate": { kind: 12, types: [{ kind: 13, types: [{ kind: 16, typeName: "Coordinate", classType: () => (typeof Coordinate !== "undefined" ? Coordinate : (typeof exports !== "undefined" ? exports.Coordinate : undefined)) }, { kind: 2, typeName: "MySQL", database: { mysql: { type: "point" } } }] }, { kind: 5 }], typeName: "NullableMySQLCoordinate" }, "PhoneNumber": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Validator", validation: [{ name: "validator", args: [{ kind: 10, literal: "phone" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "phone" } } }], typeName: "PhoneNumber" }, "PhoneNumberNANP": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Validator", validation: [{ name: "validator", args: [{ kind: 10, literal: "phoneNanp" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "phoneNanp" } } }], typeName: "PhoneNumberNANP" }, "Primitive": { kind: 12, types: [{ kind: 12, types: [{ kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }], typeName: "ConcretePrimitive" }, { kind: 5 }], typeName: "DefinedPrimitive" }, { kind: 4 }], typeName: "Primitive" }, "StrictBool": { kind: 12, types: [{ kind: 10, literal: true }, { kind: 10, literal: false }], typeName: "StrictBool" }, "TrimmedString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:trim": { kind: 4 } } }], typeName: "TrimmedString" }, "UUID": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^(?:urn:uuid:)?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "uuid" } } }], typeName: "UUID" }, "UnsignedNumber": { kind: 13, types: [{ kind: 7 }, { kind: 2, typeName: "Minimum", validation: [{ name: "minimum", args: [{ kind: 10, literal: 0 }] }] }], typeName: "UnsignedNumber" }, "UuidString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^(?:urn:uuid:)?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "uuidString" } } }], typeName: "UuidString" }, "ValidDate": { kind: 13, types: [{ kind: 16, typeName: "Date", classType: () => (typeof Date !== "undefined" ? Date : (typeof exports !== "undefined" ? exports.Date : undefined)) }, { kind: 2, typeName: "Validator", validation: [{ name: "validator", args: [{ kind: 10, literal: "validDate" }] }] }], typeName: "ValidDate" }, "VoidFunction": { kind: 2, typeName: "() => void", typeName: "VoidFunction" } });
+//# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;AACA,4CAAiD;AAAxC,oGAAA,MAAM,OAAA;AAAE,kGAAA,IAAI,OAAA;AAAE,gGAAA,EAAE,OAAA;AACzB,uDAA6B;AAC7B,6DAAmC;AACnC,kDAAwB;AACxB,oDAA0B"}

package/dist/src/types/phone.d.ts

@@ -0,0 +1,6 @@
+import type { TsfTypeTag, TsfValidatorTag } from '../reflection';
+export declare function cleanPhone(value: string, country?: string): string | null;
+export declare function formatPhoneFriendly(value: string, country?: string): string | null;
+export type PhoneNumber = string & TsfValidatorTag<'string', 'phone'> & TsfTypeTag<'string', 'phone'>;
+export type PhoneNumberNANP = string & TsfValidatorTag<'string', 'phoneNanp'> & TsfTypeTag<'string', 'phoneNanp'>;
+//# sourceMappingURL=phone.d.ts.map

package/dist/src/types/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../../src/types/phone.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAOjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAa,GAAG,MAAM,GAAG,IAAI,CAG/E;AAYD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKlF;AA+BD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACtG,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC"}

package/dist/src/types/phone.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = void 0;
+exports.cleanPhone = cleanPhone;
+exports.formatPhoneFriendly = formatPhoneFriendly;
+const reflection_1 = require("../reflection");
+const google_libphonenumber_1 = require("google-libphonenumber");
+const type_annotations_1 = require("./type-annotations");
+const phoneFormatter = google_libphonenumber_1.PhoneNumberUtil.getInstance();
+const InvalidPhoneSymbol = '¡InvalidPhone¡';
+function cleanPhone(value, country = 'US') {
+    const cleaned = cleanPhoneInternal(value, country);
+    return cleaned === InvalidPhoneSymbol ? null : cleaned;
+}
+function cleanPhoneInternal(value, country = 'US', stripUSPrefix = false) {
+    if (typeof value !== 'string')
+        return InvalidPhoneSymbol;
+    const number = tryOrErrorSync(() => phoneFormatter.parseAndKeepRawInput(value, country));
+    if (number instanceof Error)
+        return InvalidPhoneSymbol;
+    if (!phoneFormatter.isValidNumber(number))
+        return InvalidPhoneSymbol;
+    const result = phoneFormatter.format(number, google_libphonenumber_1.PhoneNumberFormat.E164);
+    if (!stripUSPrefix)
+        return result;
+    return result.startsWith('+1') ? result.slice(2) : InvalidPhoneSymbol;
+}
+function formatPhoneFriendly(value, country) {
+    const number = tryOrErrorSync(() => phoneFormatter.parse(value, country));
+    if (number instanceof Error)
+        return null;
+    if (!phoneFormatter.isValidNumber(number))
+        return null;
+    return phoneFormatter.format(number, google_libphonenumber_1.PhoneNumberFormat.NATIONAL);
+}
+function validatePhone(value) {
+    if (value === InvalidPhoneSymbol) {
+        return new reflection_1.ValidatorError('invalidPhone', 'The phone number is invalid.');
+    }
+}
+reflection_1.validationRegistry.register('phone', validatePhone);
+reflection_1.validationRegistry.register('phoneNanp', validatePhone);
+reflection_1.deserializer.addDecorator(t => {
+    const typeType = (0, type_annotations_1.getFirstTypeAnnotation)(t, 'tsf:type');
+    return typeType?.kind === reflection_1.ReflectionKind.literal && typeType.literal === 'phone';
+}, (_type, state) => {
+    state.addTransform(value => cleanPhoneInternal(value));
+});
+reflection_1.deserializer.addDecorator(t => {
+    const typeType = (0, type_annotations_1.getFirstTypeAnnotation)(t, 'tsf:type');
+    return typeType?.kind === reflection_1.ReflectionKind.literal && typeType.literal === 'phoneNanp';
+}, (_type, state) => {
+    state.addTransform(value => cleanPhoneInternal(value, 'US', true));
+});
+function tryOrErrorSync(fn) {
+    try {
+        return fn();
+    }
+    catch (error) {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+}
+exports.__tsfTypeAliases = ({ "PhoneNumber": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Validator", validation: [{ name: "validator", args: [{ kind: 10, literal: "phone" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "phone" } } }], typeName: "PhoneNumber" }, "PhoneNumberNANP": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Validator", validation: [{ name: "validator", args: [{ kind: 10, literal: "phoneNanp" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "phoneNanp" } } }], typeName: "PhoneNumberNANP" } });
+//# sourceMappingURL=phone.js.map

package/dist/src/types/phone.js.map

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

package/dist/src/types/primitives.d.ts

@@ -0,0 +1,33 @@
+export type ConcretePrimitive = string | number | boolean;
+export type DefinedPrimitive = ConcretePrimitive | null;
+export type Primitive = DefinedPrimitive | undefined;
+export type StrictBool = true | false;
+export type KVObject<T = any> = Record<string, T>;
+export type NestedKVObject<T = any> = KVObject<T | T[] | KVObject<T>>;
+export type Serializable<T = ConcretePrimitive> = T | T[] | NestedKVObject<T> | NestedKVObject<T>[];
+export type RequireFields<T, K extends keyof T> = T & {
+    [P in K]-?: T[P];
+};
+type NullUnionKeys<T extends object> = {
+    [K in keyof T]-?: null extends T[K] ? K : never;
+}[keyof T];
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+};
+export type Overwrite<A extends object, B extends object> = Simplify<Omit<A, keyof B> & B>;
+export type OptionalNulls<T extends object> = Simplify<Omit<T, NullUnionKeys<T>> & Partial<Pick<T, NullUnionKeys<T>>>>;
+export type StringKeyOf<T> = Extract<keyof T, string>;
+export type ObjectKeysMatching<O extends object, V> = {
+    [K in StringKeyOf<O>]: O[K] extends V ? (O[K] extends (...args: any[]) => any ? never : K) : V extends O[K] ? K : never;
+}[StringKeyOf<O>];
+export type ArrowFunction = (...args: any[]) => any;
+export type ArrowFunctionNoArgs = () => any;
+export type VoidFunction = () => void;
+type IfAny<T, Y, N> = 0 extends 1 & T ? Y : N;
+type DefinitelyFunction<T> = IfAny<T, never, T extends (...args: any[]) => any ? T : never>;
+export type MethodsOf<T> = {
+    [K in keyof T as DefinitelyFunction<T[K]> extends never ? never : K]: T[K];
+};
+export type MethodKeys<T> = keyof MethodsOf<T>;
+export {};
+//# sourceMappingURL=primitives.d.ts.map

package/dist/src/types/primitives.d.ts.map

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

package/dist/src/types/primitives.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = void 0;
+exports.__tsfTypeAliases = ({ "ArrowFunction": { kind: 2, typeName: "(...args: any[]) => any", typeName: "ArrowFunction" }, "ArrowFunctionNoArgs": { kind: 2, typeName: "() => any", typeName: "ArrowFunctionNoArgs" }, "ConcretePrimitive": { kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }], typeName: "ConcretePrimitive" }, "DefinedPrimitive": { kind: 12, types: [{ kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }], typeName: "ConcretePrimitive" }, { kind: 5 }], typeName: "DefinedPrimitive" }, "Primitive": { kind: 12, types: [{ kind: 12, types: [{ kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }], typeName: "ConcretePrimitive" }, { kind: 5 }], typeName: "DefinedPrimitive" }, { kind: 4 }], typeName: "Primitive" }, "StrictBool": { kind: 12, types: [{ kind: 10, literal: true }, { kind: 10, literal: false }], typeName: "StrictBool" }, "VoidFunction": { kind: 2, typeName: "() => void", typeName: "VoidFunction" } });
+//# sourceMappingURL=primitives.js.map

package/dist/src/types/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/types/primitives.ts"],"names":[],"mappings":""}

package/dist/src/types/runtime.d.ts

@@ -0,0 +1,5 @@
+import type { ClassType } from '../reflection';
+export declare function getClassName(value: unknown): string;
+export declare function isClass(value: unknown): value is ClassType;
+export declare function uuid(): string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/src/types/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/types/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAInD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE1D;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B"}

package/dist/src/types/runtime.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClassName = getClassName;
+exports.isClass = isClass;
+exports.uuid = uuid;
+const uuid_1 = require("../helpers/utils/uuid");
+function getClassName(value) {
+    if (typeof value === 'function')
+        return value.name || 'anonymous class';
+    if (value && typeof value === 'object')
+        return value.constructor?.name || 'anonymous class';
+    return String(value);
+}
+function isClass(value) {
+    return Boolean(typeof value === 'function' && value.prototype && value.prototype.constructor === value);
+}
+function uuid() {
+    return (0, uuid_1.uuid7)();
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/types/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/types/runtime.ts"],"names":[],"mappings":";;;;;AAAA,gDAA8C;AAG9C,sBAA6B,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC,IAAI,IAAI,iBAAiB,CAAC;IACxE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,iBAAiB,CAAC;IAC5F,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED,iBAAwB,KAAc;IAClC,OAAO,OAAO,CAAC,OAAO,KAAK,KAAK,UAAU,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC;AAC5G,CAAC;AAED;IACI,OAAO,IAAA,YAAK,GAAE,CAAC;AACnB,CAAC"}

package/dist/src/types/type-annotations.d.ts

@@ -0,0 +1,28 @@
+import type { MaxLength, MinLength, Minimum, MySQL, Type, TypeAnnotation, TypiaFormat, TsfDatabaseFieldTag, TsfTypeTag, TsfTypiaTag, TsfValidatorTag } from '../reflection';
+export type DateString = string & TypiaFormat<'date'> & TsfDatabaseFieldTag<{
+    type: 'DATE';
+}> & TsfTypeTag<'string', 'date'>;
+export type OnUpdate<T extends string> = TypeAnnotation<'tsf:onUpdate', T>;
+export type HasDefault = TypeAnnotation<'tsf:hasDefault'>;
+export type WithDefault<T> = T & HasDefault;
+export type UuidString = string & TypiaFormat<'uuid'> & TsfTypeTag<'string', 'uuidString'>;
+export type { UUID } from '../reflection';
+export type UnsignedNumber = number & Minimum<0>;
+export declare class Coordinate {
+    x: number;
+    y: number;
+}
+export type MySQLCoordinate = Coordinate & MySQL<{
+    type: 'point';
+}>;
+export type NullableMySQLCoordinate = (Coordinate & MySQL<{
+    type: 'point';
+}>) | null;
+export type Length<T extends number> = string & MinLength<T> & MaxLength<T> & TsfTypiaTag<'string', 'tsf:length', T>;
+export type ValidDate = Date & TsfValidatorTag<'object', 'validDate'>;
+export type TrimmedString = string & TsfTypiaTag<'string', 'tsf:trim'>;
+export type NonEmptyTrimmedString = TrimmedString & MinLength<1>;
+export declare function getFirstTypeAnnotation(t: Type, ...names: string[]): Type | undefined;
+export declare const EMAIL_REGEX: RegExp;
+export type EmailAddress = string & TypiaFormat<'email'>;
+//# sourceMappingURL=type-annotations.d.ts.map

package/dist/src/types/type-annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-annotations.d.ts","sourceRoot":"","sources":["../../../src/types/type-annotations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,SAAS,EACT,SAAS,EACT,OAAO,EACP,KAAK,EACL,IAAI,EACJ,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,eAAe,EAClB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7H,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,cAAc,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;AAC3E,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAC3F,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjD,qBAAa,UAAU;IACnB,CAAC,EAAG,MAAM,CAAC;IACX,CAAC,EAAG,MAAM,CAAC;CACd;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AACpE,MAAM,MAAM,uBAAuB,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAErF,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAUrH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAEtE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACvE,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAEjE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,oBAKjE;AASD,eAAO,MAAM,WAAW,QAAyC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC"}

package/dist/src/types/type-annotations.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = exports.EMAIL_REGEX = exports.Coordinate = void 0;
+exports.getFirstTypeAnnotation = getFirstTypeAnnotation;
+const reflection_1 = require("../reflection");
+let _CoordinateMetadata_1;
+class Coordinate {
+    x;
+    y;
+    static __tsfType = _CoordinateMetadata_1 = ({ kind: 16, name: "Coordinate", typeName: "Coordinate", classType: () => Coordinate, properties: [{ name: "x", type: { kind: 7 }, optional: false }, { name: "y", type: { kind: 7 }, optional: false }], methods: [], hasConstructor: false, constructorParameters: [] });
+}
+exports.Coordinate = Coordinate;
+_CoordinateMetadata_1.classType = Coordinate;
+Coordinate.__tsfType = _CoordinateMetadata_1;
+function validateDate(value) {
+    if (!(value instanceof Date) || Number.isNaN(value.getTime())) {
+        return new reflection_1.ValidatorError('invalidDate', 'The date is invalid.');
+    }
+}
+reflection_1.validationRegistry.register('validDate', validateDate);
+function getFirstTypeAnnotation(t, ...names) {
+    for (const name of names) {
+        const annotation = reflection_1.typeAnnotation.getType(t, name);
+        if (annotation)
+            return annotation;
+    }
+}
+reflection_1.deserializer.addDecorator(t => getFirstTypeAnnotation(t, 'tsf:trim') !== undefined, (_type, state) => {
+    state.addTransform(value => (typeof value === 'string' ? value.trim() : value));
+});
+exports.EMAIL_REGEX = /^[a-z0-9_+.-]+@[a-z0-9-.]+\.[a-z]+$/i;
+exports.__tsfTypeAliases = ({ "DateString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^\\d{4}-\\d{2}-\\d{2}$" }] }] }, { kind: 2, typeName: "DatabaseField", database: { "*": { type: "DATE" } } }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "date" } } }], typeName: "DateString" }, "EmailAddress": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^[a-zA-Z0-9_+.-]+@[a-zA-Z0-9-.]+\\.[a-zA-Z]+$" }] }] }], typeName: "EmailAddress" }, "HasDefault": { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:hasDefault": { kind: 4 } }, typeName: "HasDefault" }, "MySQLCoordinate": { kind: 13, types: [{ kind: 16, typeName: "Coordinate", classType: () => (typeof Coordinate !== "undefined" ? Coordinate : (typeof exports !== "undefined" ? exports.Coordinate : undefined)) }, { kind: 2, typeName: "MySQL", database: { mysql: { type: "point" } } }], typeName: "MySQLCoordinate" }, "NonEmptyTrimmedString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:trim": { kind: 4 } } }, { kind: 2, typeName: "MinLength", validation: [{ name: "minLength", args: [{ kind: 10, literal: 1 }] }] }], typeName: "NonEmptyTrimmedString" }, "NullableMySQLCoordinate": { kind: 12, types: [{ kind: 13, types: [{ kind: 16, typeName: "Coordinate", classType: () => (typeof Coordinate !== "undefined" ? Coordinate : (typeof exports !== "undefined" ? exports.Coordinate : undefined)) }, { kind: 2, typeName: "MySQL", database: { mysql: { type: "point" } } }] }, { kind: 5 }], typeName: "NullableMySQLCoordinate" }, "TrimmedString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:trim": { kind: 4 } } }], typeName: "TrimmedString" }, "UUID": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^(?:urn:uuid:)?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "uuid" } } }], typeName: "UUID" }, "UnsignedNumber": { kind: 13, types: [{ kind: 7 }, { kind: 2, typeName: "Minimum", validation: [{ name: "minimum", args: [{ kind: 10, literal: 0 }] }] }], typeName: "UnsignedNumber" }, "UuidString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^(?:urn:uuid:)?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "uuidString" } } }], typeName: "UuidString" }, "ValidDate": { kind: 13, types: [{ kind: 16, typeName: "Date", classType: () => (typeof Date !== "undefined" ? Date : (typeof exports !== "undefined" ? exports.Date : undefined)) }, { kind: 2, typeName: "Validator", validation: [{ name: "validator", args: [{ kind: 10, literal: "validDate" }] }] }], typeName: "ValidDate" } });
+//# sourceMappingURL=type-annotations.js.map

package/dist/src/types/type-annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-annotations.js","sourceRoot":"","sources":["../../../src/types/type-annotations.ts"],"names":[],"mappings":";;;;AAAA,8CAAiG;;AAuBjG;IACI,CAAC,CAAU;IACX,CAAC,CAAU;;CACd;;;;AAOD,SAAS,YAAY,CAAC,KAAc;IAChC,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAI,2BAAc,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IACrE,CAAC;AACL,CAAC;AAED,+BAAkB,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAOvD,gCAAuC,CAAO,EAAE,GAAG,KAAe;IAC9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,2BAAc,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,UAAU;YAAE,OAAO,UAAU,CAAC;IACtC,CAAC;AACL,CAAC;AAED,yBAAY,CAAC,YAAY,CACrB,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,SAAS,EACxD,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;IACb,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACpF,CAAC,CACJ,CAAC;AAEW,QAAA,WAAW,GAAG,sCAAsC,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,2 @@
+export * from './types/index';
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/src/types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./types/index"), exports);
+exports.__tsfTypeAliases = ({ "ArrowFunction": { kind: 2, typeName: "(...args: any[]) => any", typeName: "ArrowFunction" }, "ArrowFunctionNoArgs": { kind: 2, typeName: "() => any", typeName: "ArrowFunctionNoArgs" }, "ConcretePrimitive": { kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }], typeName: "ConcretePrimitive" }, "DateString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^\\d{4}-\\d{2}-\\d{2}$" }] }] }, { kind: 2, typeName: "DatabaseField", database: { "*": { type: "DATE" } } }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "date" } } }], typeName: "DateString" }, "DefinedPrimitive": { kind: 12, types: [{ kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }], typeName: "ConcretePrimitive" }, { kind: 5 }], typeName: "DefinedPrimitive" }, "EmailAddress": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^[a-zA-Z0-9_+.-]+@[a-zA-Z0-9-.]+\\.[a-zA-Z]+$" }] }] }], typeName: "EmailAddress" }, "HasDefault": { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:hasDefault": { kind: 4 } }, typeName: "HasDefault" }, "MySQLCoordinate": { kind: 13, types: [{ kind: 16, typeName: "Coordinate", classType: () => (typeof Coordinate !== "undefined" ? Coordinate : (typeof exports !== "undefined" ? exports.Coordinate : undefined)) }, { kind: 2, typeName: "MySQL", database: { mysql: { type: "point" } } }], typeName: "MySQLCoordinate" }, "NonEmptyTrimmedString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:trim": { kind: 4 } } }, { kind: 2, typeName: "MinLength", validation: [{ name: "minLength", args: [{ kind: 10, literal: 1 }] }] }], typeName: "NonEmptyTrimmedString" }, "NullableMySQLCoordinate": { kind: 12, types: [{ kind: 13, types: [{ kind: 16, typeName: "Coordinate", classType: () => (typeof Coordinate !== "undefined" ? Coordinate : (typeof exports !== "undefined" ? exports.Coordinate : undefined)) }, { kind: 2, typeName: "MySQL", database: { mysql: { type: "point" } } }] }, { kind: 5 }], typeName: "NullableMySQLCoordinate" }, "PhoneNumber": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Validator", validation: [{ name: "validator", args: [{ kind: 10, literal: "phone" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "phone" } } }], typeName: "PhoneNumber" }, "PhoneNumberNANP": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Validator", validation: [{ name: "validator", args: [{ kind: 10, literal: "phoneNanp" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "phoneNanp" } } }], typeName: "PhoneNumberNANP" }, "Primitive": { kind: 12, types: [{ kind: 12, types: [{ kind: 12, types: [{ kind: 6 }, { kind: 7 }, { kind: 8 }], typeName: "ConcretePrimitive" }, { kind: 5 }], typeName: "DefinedPrimitive" }, { kind: 4 }], typeName: "Primitive" }, "StrictBool": { kind: 12, types: [{ kind: 10, literal: true }, { kind: 10, literal: false }], typeName: "StrictBool" }, "TrimmedString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:trim": { kind: 4 } } }], typeName: "TrimmedString" }, "UUID": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^(?:urn:uuid:)?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "uuid" } } }], typeName: "UUID" }, "UnsignedNumber": { kind: 13, types: [{ kind: 7 }, { kind: 2, typeName: "Minimum", validation: [{ name: "minimum", args: [{ kind: 10, literal: 0 }] }] }], typeName: "UnsignedNumber" }, "UuidString": { kind: 13, types: [{ kind: 6 }, { kind: 2, typeName: "Format", validation: [{ name: "pattern", args: [{ kind: 10, literal: "^(?:urn:uuid:)?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$" }] }] }, { kind: 2, typeName: "TypeAnnotation", annotations: { "tsf:type": { kind: 10, literal: "uuidString" } } }], typeName: "UuidString" }, "ValidDate": { kind: 13, types: [{ kind: 16, typeName: "Date", classType: () => (typeof Date !== "undefined" ? Date : (typeof exports !== "undefined" ? exports.Date : undefined)) }, { kind: 2, typeName: "Validator", validation: [{ name: "validator", args: [{ kind: 10, literal: "validDate" }] }] }], typeName: "ValidDate" }, "VoidFunction": { kind: 2, typeName: "() => void", typeName: "VoidFunction" } });
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;;AAAA,wDAA8B"}

package/docs/.vitepress/config.mts

@@ -0,0 +1,85 @@
+import { defineConfig } from 'vitepress';
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+    srcDir: 'content',
+    title: '@zyno-io/ts-server-foundation',
+    description: 'TypeScript server foundation with reflected type metadata',
+    base: '/ts-server-foundation/',
+
+    themeConfig: {
+        // https://vitepress.dev/reference/default-theme-config
+        nav: [
+            { text: 'Home', link: '/' },
+            { text: 'Overview', link: '/overview' },
+            { text: 'Getting Started', link: '/getting-started' },
+            { text: 'Release', link: '/release' }
+        ],
+
+        sidebar: [
+            {
+                text: 'Introduction',
+                items: [
+                    { text: 'Feature Overview', link: '/overview' },
+                    { text: 'Getting Started', link: '/getting-started' },
+                    { text: 'Public API', link: '/public-api' },
+                    { text: 'Dependency Injection', link: '/di' },
+                    { text: 'Configuration', link: '/configuration' },
+                    { text: 'Environment', link: '/env' },
+                    { text: 'Release', link: '/release' },
+                    { text: 'Documentation Maintenance', link: '/documentation-plan' }
+                ]
+            },
+            {
+                text: 'Current Core',
+                items: [
+                    { text: 'Database', link: '/database' },
+                    { text: 'SQL', link: '/sql' },
+                    { text: 'Migrations', link: '/migrations' },
+                    { text: 'HTTP', link: '/http' },
+                    { text: 'Uploads', link: '/uploads' },
+                    { text: 'OpenAPI', link: '/openapi' },
+                    { text: 'Authentication', link: '/authentication' },
+                    { text: 'Health Checks', link: '/health' },
+                    { text: 'Logging', link: '/logging' },
+                    { text: 'Types', link: '/types' },
+                    { text: 'Type Reflection', link: '/reflection' },
+                    { text: 'Type Reflection Architecture', link: '/type-reflection-architecture' }
+                ]
+            },
+            {
+                text: 'Services',
+                items: [
+                    { text: 'Workers', link: '/worker' },
+                    { text: 'SRPC', link: '/srpc' },
+                    { text: 'DevConsole', link: '/devconsole' },
+                    { text: 'Redis', link: '/redis' },
+                    { text: 'Leader Service', link: '/leader-service' },
+                    { text: 'Mail', link: '/mail' },
+                    { text: 'Mesh Service', link: '/mesh-service' },
+                    { text: 'Mesh Client Tracking', link: '/mesh-client' }
+                ]
+            },
+            {
+                text: 'Utilities',
+                items: [
+                    { text: 'Helpers', link: '/helpers' },
+                    { text: 'Telemetry', link: '/telemetry' },
+                    { text: 'Testing', link: '/testing' },
+                    { text: 'CLI Tools', link: '/cli' }
+                ]
+            }
+        ],
+
+        socialLinks: [{ icon: 'github', link: 'https://github.com/zyno-io/ts-server-foundation' }],
+
+        search: {
+            provider: 'local'
+        },
+
+        footer: {
+            message: 'Released under the MIT License.',
+            copyright: 'Copyright © 2024-present Signal 24'
+        }
+    }
+});

package/docs/content/CONTRIBUTING.md

@@ -0,0 +1,53 @@
+# Contributing To Documentation
+
+## Quick Start
+
+```bash
+corepack yarn install
+corepack yarn docs:dev
+```
+
+Edit Markdown files under `docs/content/`. The dev server reloads as files change.
+
+Before handing off docs changes, run:
+
+```bash
+corepack yarn docs:build
+```
+
+## Adding A New Page
+
+1. Create a Markdown file in `docs/content/`.
+2. Add frontmatter only when the page needs custom title/description metadata.
+3. Add the page to `docs/.vitepress/config.mts`.
+4. Link related pages together with relative Markdown links, for example `[HTTP](./http.md)`.
+
+## Markdown
+
+Use fenced code blocks with language names:
+
+```ts
+const app = createApp({
+    config: AppConfig
+});
+```
+
+VitePress custom containers are available when they add real signal:
+
+```md
+::: warning
+This API is not available in production mode.
+:::
+```
+
+## Style
+
+- Prefer current `@zyno-io/ts-server-foundation` examples.
+- Use `tsf` command names.
+- Keep HTTP parameter examples explicit: `HttpBody`, `HttpQueries`, `HttpQuery`, `HttpPath`, `HttpHeader`, `FileUpload`, and `HttpRequest`.
+- Keep database docs focused on `BaseDatabase`, sessions, active-record helpers, migrations, and SQL fragments.
+- Run `corepack yarn docs:build` after sidebar or link changes.
+
+## Deployment
+
+Documentation merged to `main` is built and deployed to GitHub Pages by `.github/workflows/deploy-docs.yml`. Changes mirrored from GitLab to GitHub trigger the same push workflow. Use `workflow_dispatch` in GitHub Actions when a deployment must be retried without another content change.

package/docs/content/README-DEV.md

@@ -0,0 +1,59 @@
+# Documentation Site Development
+
+This package uses VitePress for the documentation site.
+
+## Layout
+
+```text
+docs/
+├── .vitepress/
+│   └── config.mts
+├── content/
+│   ├── index.md
+│   ├── getting-started.md
+│   ├── public/
+│   │   └── images/
+│   └── ...
+└── scripts/
+```
+
+VitePress is configured with `srcDir: 'content'`, so editable pages live in `docs/content/`. Static files live in `docs/content/public/`.
+
+## Commands
+
+Run commands from the repository root:
+
+```bash
+corepack yarn install
+corepack yarn docs:dev
+corepack yarn docs:build
+corepack yarn docs:preview
+```
+
+`docs:dev` starts the VitePress dev server. Because the site has `base: '/ts-server-foundation/'`, the local site is served under that base path.
+
+`docs:build` writes generated output to `docs/.vitepress/dist/`. That directory is ignored and should not be edited by hand.
+
+## Adding Pages
+
+1. Create or edit Markdown files in `docs/content/`.
+2. Add new pages to `docs/.vitepress/config.mts` so they appear in the sidebar.
+3. Run `corepack yarn docs:build` before publishing docs changes.
+
+## Images
+
+Place images in `docs/content/public/images/` and reference them from Markdown with `/images/...`:
+
+```md
+![Alt text](/images/example.png)
+```
+
+## Deployment
+
+GitHub Pages deployment is defined in `.github/workflows/deploy-docs.yml`. A push to `main` that changes docs, the workflow, or the root dependency metadata installs the immutable Yarn dependencies, runs `yarn docs:build`, uploads `docs/.vitepress/dist/`, and deploys it through the `github-pages` environment.
+
+The workflow can also be started manually from the GitHub Actions tab. The repository's Pages source must remain set to **GitHub Actions**. The published site is <https://zyno-io.github.io/ts-server-foundation/>.
+
+## Notes
+
+Prefer examples that compile against `@zyno-io/ts-server-foundation`. Document reflected type metadata where it affects user-facing behavior, and otherwise keep pages focused on the TSF APIs that applications import.

package/docs/content/README.md

@@ -0,0 +1,52 @@
+# Documentation
+
+`@zyno-io/ts-server-foundation` is a TypeScript server foundation for HTTP APIs, dependency injection, configuration, database access, workers, SRPC, logging, telemetry, and development tooling.
+
+The TSF compiler emits reflected type metadata used by validation, OpenAPI, routing, DI, config, and database schema extraction. Application code should use the TSF APIs documented here.
+
+## Core Docs
+
+| Document                                                          | Description                                                                                               |
+| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| [Feature Overview](./overview.md)                                 | Capability map, architecture boundaries, operational model, and links to every detailed feature guide.   |
+| [Getting Started](./getting-started.md)                           | Installation, app creation, module options, DI, lifecycle, and environment requirements.                  |
+| [Public API](./public-api.md)                                     | Package export surface, root imports, OTel bootstrap imports, and `app.http` boundary.                    |
+| [Dependency Injection](./di.md)                                   | Providers, scopes, request contexts, module exports, and controller/service lifecycle.                    |
+| [Configuration](./configuration.md)                               | `BaseAppConfig`, `Env`, env-file loading, child-process env preservation, and built-in config keys.       |
+| [Environment](./env.md)                                           | `Env`, snapshots, process-env conversion, config loading behavior, and test patterns.                     |
+| [Database](./database.md)                                         | MySQL/PostgreSQL database layer, active record, sessions, transactions, raw SQL, locks, and schema tools. |
+| [SQL](./sql.md)                                                   | SQL fragments, bindings, identifiers, joins, rendering, and trusted raw SQL escape hatches.               |
+| [Migrations](./migrations.md)                                     | Migration files, schema diffing, migration runner, reset, charset, and CLI options.                       |
+| [HTTP](./http.md)                                                 | HTTP router, explicit request parameter annotations, multipart uploads, raw streaming, and responses.     |
+| [Uploads](./uploads.md)                                           | Multipart parsing, `FileUpload`, temporary-file cleanup, cached body reads, and raw request streams.      |
+| [OpenAPI](./openapi.md)                                           | Route/schema serialization, explicit query/body rules, `ApiResponse<T, Status>`, and generation commands. |
+| [Authentication](./authentication.md)                             | JWTs, request helpers, auth middleware, basic auth, password hashing, and reset tokens.                   |
+| [Health Checks](./health.md)                                      | `/healthz`, `HealthcheckService`, custom checks, and request logging.                                     |
+| [Logging](./logging.md)                                           | Pino logging, pretty output, context data, request logs, and error reporting.                             |
+| [Types](./types.md)                                               | Runtime and schema type annotations, including DB/OpenAPI effects for custom types.                       |
+| [Type Reflection](./reflection.md)                                | Public runtime reflection, annotation readers, custom validators/deserializers, and shared aliases.       |
+| [Type Reflection Architecture](./type-reflection-architecture.md) | Compiler metadata policy shared by validation, OpenAPI, and database extraction.                          |
+
+## Services
+
+| Document                                 | Description                                                                                            |
+| ---------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| [Workers](./worker.md)                   | BullMQ-backed workers, in-process execution, cron scheduling, recording, and DI-owned job handlers.    |
+| [Redis](./redis.md)                      | Redis options, cache, mutex, broadcast channels, distributed methods, and BullMQ prefixes.             |
+| [DevConsole](./devconsole.md)            | Development dashboard for routes, OpenAPI, requests, SRPC, DB queries, mutexes, and workers.           |
+| [SRPC](./srpc.md)                        | WebSocket RPC with generated proto types, authentication hooks, bidirectional calls, and byte streams. |
+| [Leader Service](./leader-service.md)    | Redis-backed leader election.                                                                          |
+| [Mail](./mail.md)                        | DI-registered SMTP/Postmark mail service and templates.                                                |
+| [Mesh Service](./mesh-service.md)        | Redis-backed cross-node typed messaging and broadcasts.                                                |
+| [Mesh Client Tracking](./mesh-client.md) | Cross-node client registry, invocation, and SRPC mesh integration.                                     |
+
+## Utilities And Operations
+
+| Document                                             | Description                                                                                                   |
+| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| [Helpers](./helpers.md)                              | Async context, promises, objects, JSON, streams, crypto, validation, dates, errors, UUIDs, and Redis helpers. |
+| [Telemetry](./telemetry.md)                          | OpenTelemetry bootstrap, span helpers, metrics endpoint, shutdown, and Sentry helpers.                        |
+| [Testing](./testing.md)                              | Testing facade, mock HTTP requests, isolated test databases, seed hooks, and assertion helpers.               |
+| [CLI Tools](./cli.md)                                | `tsf`, `tsf-dev`, `tsf-test`, `tsf-migrate`, `tsf-gen-proto`, and app scaffolding.                            |
+| [Release](./release.md)                              | Build, test, OpenAPI generation, package contents, tarball inspection, and publish checklist.                 |
+| [Documentation Maintenance](./documentation-plan.md) | How to keep the docs aligned with implementation changes.                                                     |