@adaas/a-server 0.0.22 → 0.0.24

package/src/lib/A-Response/A-Response.error.ts

@@ -0,0 +1,6 @@
+import { A_Error } from "@adaas/a-concept"
+
+
+export class A_ResponseError extends A_Error {
+
+}

package/src/lib/A-Response/A-Response.types.ts

@@ -0,0 +1,127 @@
+import { ServerResponse } from "http";
+import type { A_Response } from "./A-Response.entity";
+import { A_TYPES__Entity_Serialized } from "@adaas/a-concept";
+import { A_ResponseFeatures } from "./A-Response.constants";
+
+
+export type A_Response_Constructor = {
+    /**
+     * Should correspond to Request id
+     */
+    id: string,
+    scope: string,
+    shard: string,
+    response: ServerResponse,
+}
+
+
+export type A_Response_Serialized<T extends any> = {
+    status: number;
+    headersSent: boolean;
+    size: number;
+    data: T;
+    redirectURL?: string;
+} & A_TYPES__Entity_Serialized;
+
+export type A_Response_SendResponseObject<_ResponseType = any> = Record<string, _ResponseType>;
+
+// Enhanced types for comprehensive response processing
+
+/**
+ * Cookie configuration for setting response cookies
+ */
+export type A_Response_CookieOptions = {
+    domain?: string;
+    path?: string;
+    secure?: boolean;
+    httpOnly?: boolean;
+    maxAge?: number;
+    expires?: Date;
+    sameSite?: 'strict' | 'lax' | 'none';
+    signed?: boolean;
+};
+
+
+export type A_ResponseFeatureNames = typeof A_ResponseFeatures[keyof typeof A_ResponseFeatures];
+
+
+/**
+ * Response streaming options
+ */
+export type A_Response_StreamOptions = {
+    chunkSize?: number;
+    delay?: number;
+    encoding?: BufferEncoding;
+    transform?: (chunk: any) => any;
+    onProgress?: (bytesWritten: number, totalBytes: number) => void;
+    onComplete?: () => void;
+    onError?: (error: Error) => void;
+};
+
+
+
+/**
+ * Response compression options
+ */
+export type A_Response_CompressionOptions = {
+    threshold?: number;
+    level?: number;
+    strategy?: number;
+    chunkSize?: number;
+    windowBits?: number;
+    memLevel?: number;
+};
+
+/**
+ * File download options
+ */
+export type A_Response_DownloadOptions = {
+    filename?: string;
+    contentType?: string;
+    disposition?: 'attachment' | 'inline';
+    maxAge?: number;
+    etag?: boolean;
+    lastModified?: boolean;
+    cacheControl?: string;
+};
+
+/**
+ * Response caching options
+ */
+export type A_Response_CacheOptions = {
+    maxAge?: number;
+    sMaxAge?: number;
+    noCache?: boolean;
+    noStore?: boolean;
+    mustRevalidate?: boolean;
+    proxyRevalidate?: boolean;
+    immutable?: boolean;
+    private?: boolean;
+    public?: boolean;
+    etag?: string;
+    lastModified?: Date;
+};
+
+/**
+ * Response configuration options
+ */
+export type A_Response_Options = {
+    autoCompress?: boolean;
+    compressionThreshold?: number;
+    enableCaching?: boolean;
+    defaultCacheMaxAge?: number;
+    enableMetrics?: boolean;
+    enableEtag?: boolean;
+    enableLastModified?: boolean;
+    charset?: string;
+    defaultContentType?: string;
+    maxRedirects?: number;
+    enableCookies?: boolean;
+    enableSessions?: boolean;
+};
+
+
+/**
+ * Response Event Listener Function
+ */
+export type A_Response_Listener = (res?: A_Response) => void;