xypriss 9.11.13 → 9.12.0

package/dist/src/types/NotFoundConfig.js

@@ -0,0 +1,82 @@
+import { Interface, Mod } from "reliant-type";
+const schm = Interface({
+    /**
+     * The title displayed in the browser tab and as the primary heading of the error page.
+     */
+    title: "string",
+    /**
+     * The descriptive message explaining the error to the user.
+     */
+    message: "string",
+    /**
+     * The original URL path that resulted in the 404 Not Found error.
+     */
+    requestedPath: "string",
+    /**
+     * The CSS class name applied to the body or container to define the visual theme (e.g., 'theme-dark').
+     */
+    mode: "dark|light|system", // pas besoin de mettre "?" à la fin vu qu'on utilise "partial" après qui s'occupe de ça
+    // themeClass: "auto|light|dark", // c'est rédondant, "mode" seul suffisais
+    /**
+     * A string containing raw CSS rules to be injected directly into the page for custom styling overrides.
+     */
+    customCSS: "string",
+    /**
+     * The absolute or relative URL of the favicon to be displayed in the browser's address bar or tabs.
+     */
+    faviconUrl: "string",
+    /**
+     * The HTTP method (e.g., GET, POST) used for the request that triggered the error.
+     */
+    requestedMethod: "string",
+    /**
+     * The name of the application or server instance, typically used for branding in headers or footers.
+     */
+    appName: "string",
+    /**
+     * The target URL for automatic or manual redirection from the error page.
+     */
+    redirectTo: "string",
+    /**
+     * The human-readable text for the redirection link or button.
+     */
+    redirectText: "string",
+    /**
+     * A client-side function executed to handle the redirection logic or countdown behavior.
+     */
+    // @fortify-ignore
+    redirectScript: "fn(...args: any[]) => void)?",
+    /**
+     * Contact information, an email address, for user assistance.
+     */
+    contactEmail: "string?",
+});
+export const validate404Cfg = (cfg) => {
+    const modSchm = Mod.omit(Mod.deepPartial(schm), [
+        "requestedMethod",
+        "requestedPath",
+    ]);
+    try {
+        const rs = modSchm.safeParse(cfg);
+        if (!rs.success) {
+            console.error("error: ", rs.errors.map((e) => e.message).join("\n"));
+            throw new Error(rs.errors.map((e) => e.message).join("\n"));
+        }
+        return rs.data;
+    }
+    catch (error) {
+        console.error("error: ", error);
+        throw error.message;
+    }
+};
+// validate404Cfg({
+//     enabled: true,
+//     title: "Page Not Found - XyPriss",
+//     message: "The page you're looking for doesn't exist.",
+//     redirectTo: "/",
+//     redirectScript: () => {
+//         console.log("redirecting...");
+//         return {}
+//     },
+// })
+//# sourceMappingURL=NotFoundConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NotFoundConfig.js","sourceRoot":"","sources":["../../../src/types/NotFoundConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAQ,GAAG,EAAQ,MAAM,cAAc,CAAC;AAE1D,MAAM,IAAI,GAAG,SAAS,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,QAAQ;IAEf;;OAEG;IACH,OAAO,EAAE,QAAQ;IAEjB;;OAEG;IACH,aAAa,EAAE,QAAQ;IAEvB;;OAEG;IACH,IAAI,EAAE,mBAAmB,EAAE,wFAAwF;IAEnH,2EAA2E;IAE3E;;OAEG;IACH,SAAS,EAAE,QAAQ;IAEnB;;OAEG;IACH,UAAU,EAAE,QAAQ;IAEpB;;OAEG;IACH,eAAe,EAAE,QAAQ;IAEzB;;OAEG;IACH,OAAO,EAAE,QAAQ;IAEjB;;OAEG;IACH,UAAU,EAAE,QAAQ;IAEpB;;OAEG;IACH,YAAY,EAAE,QAAQ;IAEtB;;OAEG;IACH,kBAAkB;IAClB,cAAc,EAAE,8BAA8B;IAE9C;;OAEG;IACH,YAAY,EAAE,SAAS;CAC1B,CAAC,CAAC;AAgBH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAmB,EAAE,EAAE;IAClD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;QAC5C,iBAAiB;QACjB,eAAe;KAClB,CAAC,CAAC;IACH,IAAI,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CACT,SAAS,EACT,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7C,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,CAAC;IACnB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,KAAK,CAAC,OAAO,CAAC;IACxB,CAAC;AACL,CAAC,CAAC;AAEF,mBAAmB;AACnB,qBAAqB;AACrB,yCAAyC;AACzC,6DAA6D;AAC7D,uBAAuB;AACvB,8BAA8B;AAC9B,yCAAyC;AACzC,oBAAoB;AACpB,SAAS;AAET,KAAK"}

package/dist/src/types/ReqPreCompiler.type.d.ts

@@ -0,0 +1,49 @@
+import { Request } from "./types";
+export interface RequestPattern {
+    id: string;
+    route: string;
+    method: string;
+    frequency: number;
+    avgResponseTime: number;
+    cacheHitRate: number;
+    complexity: number;
+    lastSeen: Date;
+    optimizationLevel: "none" | "basic" | "advanced" | "ultra";
+}
+export interface CompiledRoute {
+    pattern: RequestPattern;
+    compiledHandler: Function;
+    optimizedMiddleware: Function[];
+    cacheStrategy: "memory" | "redis" | "hybrid" | "skip";
+    executionPath: "fast" | "standard" | "complex";
+    precomputedData?: any;
+}
+export interface DynamicResponseGenerator {
+    pattern: string | RegExp;
+    generator: (req: Request, pattern: RequestPattern) => Promise<any> | any;
+    priority?: number;
+}
+export interface ResponseTemplate {
+    route: string;
+    method: string;
+    template: any;
+    cacheTTL?: number;
+}
+export interface PreCompilerConfig {
+    enabled: boolean;
+    learningPeriod: number;
+    optimizationThreshold: number;
+    maxCompiledRoutes: number;
+    aggressiveOptimization: boolean;
+    predictivePreloading: boolean;
+    customResponseGenerators?: DynamicResponseGenerator[];
+    responseTemplates?: ResponseTemplate[];
+    systemInfo?: {
+        serviceName?: string;
+        version?: string;
+        environment?: string;
+        customHealthData?: () => any;
+        customStatusData?: () => any;
+    };
+}
+//# sourceMappingURL=ReqPreCompiler.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReqPreCompiler.type.d.ts","sourceRoot":"","sources":["../../../src/types/ReqPreCompiler.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,IAAI,CAAC;IACf,iBAAiB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;CAC9D;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,eAAe,EAAE,QAAQ,CAAC;IAC1B,mBAAmB,EAAE,QAAQ,EAAE,CAAC;IAChC,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtD,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/C,eAAe,CAAC,EAAE,GAAG,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,OAAO,CAAC;IAChC,oBAAoB,EAAE,OAAO,CAAC;IAG9B,wBAAwB,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACtD,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,UAAU,CAAC,EAAE;QACT,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,MAAM,GAAG,CAAC;QAC7B,gBAAgB,CAAC,EAAE,MAAM,GAAG,CAAC;KAChC,CAAC;CACL"}

package/dist/src/types/ReqPreCompiler.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ReqPreCompiler.type.js.map

package/dist/src/types/ReqPreCompiler.type.js.map

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

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

@@ -0,0 +1,79 @@
+/**
+ * All HTTP status keys supported by the `Send` helper.
+ * Each key maps to a standard HTTP status code.
+ *
+ * — 2xx  Success
+ * — 3xx  Redirection
+ * — 4xx  Client errors
+ * — 5xx  Server errors
+ */
+export type SupportedStatus = "OK" | "CREATED" | "ACCEPTED" | "NO_CONTENT" | "MOVED_PERMANENTLY" | "FOUND" | "NOT_MODIFIED" | "BAD_REQUEST" | "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "METHOD_NOT_ALLOWED" | "NOT_ACCEPTABLE" | "CONFLICT" | "GONE" | "UNPROCESSABLE_ENTITY" | "LOCKED" | "TOO_MANY_REQUEST" | "PAYLOAD_TOO_LARGE" | "UNSUPPORTED_MEDIA_TYPE" | "REQUEST_TIMEOUT" | "PRECONDITION_FAILED" | "EXPECTATION_FAILED" | "IM_A_TEAPOT" | "INTERNAL_SERVER_ERR" | "NOT_IMPLEMENTED" | "BAD_GATEWAY" | "SERVICE_UNAVAILABLE" | "GATEWAY_TIMEOUT";
+/**
+ * Maps every {@link SupportedStatus} key to its corresponding HTTP status code.
+ */
+export type ISeConfigs = Record<SupportedStatus, number>;
+/**
+ * Signature shared by all public dispatch methods.
+ *
+ * @param message - Human-readable description shown to the API consumer.
+ * @param data    - Optional payload to attach to the response body.
+ */
+export type TSendPropsFn = (message?: string, data?: unknown) => void;
+/**
+ * Contract that the {@link Send} class must satisfy.
+ */
+export interface ISeResponder {
+    ok: TSendPropsFn;
+    created: TSendPropsFn;
+    accepted: TSendPropsFn;
+    noContent: () => void;
+    movedPermanently: TSendPropsFn;
+    found: TSendPropsFn;
+    notModified: () => void;
+    badRequest: TSendPropsFn;
+    unauthorized: TSendPropsFn;
+    forbidden: TSendPropsFn;
+    notFound: TSendPropsFn;
+    methodNotAllowed: TSendPropsFn;
+    notAcceptable: TSendPropsFn;
+    conflict: TSendPropsFn;
+    gone: TSendPropsFn;
+    unprocessableEntity: TSendPropsFn;
+    locked: TSendPropsFn;
+    tooManyRequest: TSendPropsFn;
+    payloadTooLarge: TSendPropsFn;
+    unsupportedMediaType: TSendPropsFn;
+    requestTimeout: TSendPropsFn;
+    preconditionFailed: TSendPropsFn;
+    expectationFailed: TSendPropsFn;
+    imATeapot: TSendPropsFn;
+    internalError: TSendPropsFn;
+    notImplemented: TSendPropsFn;
+    badGateway: TSendPropsFn;
+    serviceUnavailable: TSendPropsFn;
+    gatewayTimeout: TSendPropsFn;
+}
+/**
+ * Shape of every JSON response body produced by this helper.
+ *
+ * @property success    - `true` for 2xx responses, `false` for everything else.
+ * @property message    - Human-readable summary of the outcome.
+ * @property serverName - Identifier of the server that handled the request.
+ * @property data       - Optional payload (echoed from the caller when relevant).
+ * @property details    - Machine-readable metadata about the response.
+ */
+export interface IResTemplate {
+    success: boolean;
+    message: string;
+    serverName?: string;
+    data?: unknown;
+    details: {
+        /** Short label (e.g. `"Bad Request"`, `"OK"`). */
+        error: string;
+        /** Compact code derived from the status key (e.g. `"EBADR"`, `"SOK"`). */
+        statusCode: number;
+        /** The HTTP status code that was sent. */
+        errorCode: string;
+    };
+}
+//# sourceMappingURL=SendUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SendUtils.d.ts","sourceRoot":"","sources":["../../../src/types/SendUtils.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAErB,IAAI,GACJ,SAAS,GACT,UAAU,GACV,YAAY,GAEZ,mBAAmB,GACnB,OAAO,GACP,cAAc,GAEd,aAAa,GACb,cAAc,GACd,WAAW,GACX,WAAW,GACX,oBAAoB,GACpB,gBAAgB,GAChB,UAAU,GACV,MAAM,GACN,sBAAsB,GACtB,QAAQ,GACR,kBAAkB,GAClB,mBAAmB,GACnB,wBAAwB,GACxB,iBAAiB,GACjB,qBAAqB,GACrB,oBAAoB,GACpB,aAAa,GAEb,qBAAqB,GACrB,iBAAiB,GACjB,aAAa,GACb,qBAAqB,GACrB,iBAAiB,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,YAAY;IAEzB,EAAE,EAAE,YAAY,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB,gBAAgB,EAAE,YAAY,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,IAAI,CAAC;IAExB,UAAU,EAAE,YAAY,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,gBAAgB,EAAE,YAAY,CAAC;IAC/B,aAAa,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,mBAAmB,EAAE,YAAY,CAAC;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,YAAY,CAAC;IAC7B,eAAe,EAAE,YAAY,CAAC;IAC9B,oBAAoB,EAAE,YAAY,CAAC;IACnC,cAAc,EAAE,YAAY,CAAC;IAC7B,kBAAkB,EAAE,YAAY,CAAC;IACjC,iBAAiB,EAAE,YAAY,CAAC;IAChC,SAAS,EAAE,YAAY,CAAC;IAExB,aAAa,EAAE,YAAY,CAAC;IAC5B,cAAc,EAAE,YAAY,CAAC;IAC7B,UAAU,EAAE,YAAY,CAAC;IACzB,kBAAkB,EAAE,YAAY,CAAC;IACjC,cAAc,EAAE,YAAY,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,EAAE;QACL,kDAAkD;QAClD,KAAK,EAAE,MAAM,CAAC;QACd,0EAA0E;QAC1E,UAAU,EAAE,MAAM,CAAC;QACnB,0CAA0C;QAC1C,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL"}

package/dist/src/types/SendUtils.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Types & Interfaces
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=SendUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SendUtils.js","sourceRoot":"","sources":["../../../src/types/SendUtils.ts"],"names":[],"mappings":"AACA,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E"}