@venizia/ignis-helpers 0.0.7-0 → 0.0.8-0

package/dist/common/constants/grpc.d.ts

@@ -0,0 +1,60 @@
+import { ValueOf } from '../types';
+export declare class GRPC {
+    /** Standard gRPC methods (lowercase). */
+    static readonly Methods: {
+        readonly UNARY: "unary";
+        readonly SERVER_STREAMING: "server_streaming";
+        readonly CLIENT_STREAMING: "client_streaming";
+        readonly BIDI_STREAMING: "bidi_streaming";
+    };
+    /** Standard gRPC protocol headers (PROTOCOL-HTTP2.md). */
+    static readonly Headers: {
+        readonly CONTENT_TYPE: "content-type";
+        readonly TE: "te";
+        readonly USER_AGENT: "user-agent";
+        readonly GRPC_TIMEOUT: "grpc-timeout";
+        readonly GRPC_ENCODING: "grpc-encoding";
+        readonly GRPC_ACCEPT_ENCODING: "grpc-accept-encoding";
+        readonly GRPC_MESSAGE_TYPE: "grpc-message-type";
+        readonly GRPC_STATUS: "grpc-status";
+        readonly GRPC_MESSAGE: "grpc-message";
+        readonly GRPC_STATUS_DETAILS_BIN: "grpc-status-details-bin";
+        readonly GRPC_PREVIOUS_RPC_ATTEMPTS: "grpc-previous-rpc-attempts";
+        readonly GRPC_RETRY_PUSHBACK_MS: "grpc-retry-pushback-ms";
+        readonly GRPC_TRACE_BIN: "grpc-trace-bin";
+        readonly GRPC_TAGS_BIN: "grpc-tags-bin";
+    };
+    /** gRPC MIME / Content-Type values. */
+    static readonly HeaderValues: {
+        readonly GRPC: "application/grpc";
+        readonly GRPC_PROTO: "application/grpc+proto";
+        readonly GRPC_JSON: "application/grpc+json";
+        readonly GRPC_WEB: "application/grpc-web";
+        readonly GRPC_WEB_PROTO: "application/grpc-web+proto";
+        readonly GRPC_WEB_JSON: "application/grpc-web+json";
+        readonly GRPC_WEB_TEXT: "application/grpc-web-text";
+    };
+    /** Standard gRPC status codes (google.rpc.Code). */
+    static readonly ResultCodes: {
+        readonly OK: 0;
+        readonly CANCELLED: 1;
+        readonly UNKNOWN: 2;
+        readonly INVALID_ARGUMENT: 3;
+        readonly DEADLINE_EXCEEDED: 4;
+        readonly NOT_FOUND: 5;
+        readonly ALREADY_EXISTS: 6;
+        readonly PERMISSION_DENIED: 7;
+        readonly RESOURCE_EXHAUSTED: 8;
+        readonly FAILED_PRECONDITION: 9;
+        readonly ABORTED: 10;
+        readonly OUT_OF_RANGE: 11;
+        readonly UNIMPLEMENTED: 12;
+        readonly INTERNAL: 13;
+        readonly UNAVAILABLE: 14;
+        readonly DATA_LOSS: 15;
+        readonly UNAUTHENTICATED: 16;
+    };
+}
+export type TGrpcMethod = ValueOf<typeof GRPC.Methods>;
+export type TGrpcResultCode = ValueOf<typeof GRPC.ResultCodes>;
+//# sourceMappingURL=grpc.d.ts.map

package/dist/common/constants/grpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc.d.ts","sourceRoot":"","sources":["../../../src/common/constants/grpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,qBAAa,IAAI;IACf,yCAAyC;IACzC,MAAM,CAAC,QAAQ,CAAC,OAAO;;;;;MAKZ;IAEX,0DAA0D;IAC1D,MAAM,CAAC,QAAQ,CAAC,OAAO;;;;;;;;;;;;;;;MAmBZ;IAEX,uCAAuC;IACvC,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;MAQjB;IAEX,oDAAoD;IACpD,MAAM,CAAC,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;MAkBhB;CACZ;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC"}

package/dist/common/constants/grpc.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRPC = void 0;
+class GRPC {
+    /** Standard gRPC methods (lowercase). */
+    static { this.Methods = {
+        UNARY: 'unary',
+        SERVER_STREAMING: 'server_streaming',
+        CLIENT_STREAMING: 'client_streaming',
+        BIDI_STREAMING: 'bidi_streaming',
+    }; }
+    /** Standard gRPC protocol headers (PROTOCOL-HTTP2.md). */
+    static { this.Headers = {
+        CONTENT_TYPE: 'content-type',
+        TE: 'te',
+        USER_AGENT: 'user-agent',
+        GRPC_TIMEOUT: 'grpc-timeout',
+        GRPC_ENCODING: 'grpc-encoding',
+        GRPC_ACCEPT_ENCODING: 'grpc-accept-encoding',
+        GRPC_MESSAGE_TYPE: 'grpc-message-type',
+        GRPC_STATUS: 'grpc-status',
+        GRPC_MESSAGE: 'grpc-message',
+        GRPC_STATUS_DETAILS_BIN: 'grpc-status-details-bin',
+        GRPC_PREVIOUS_RPC_ATTEMPTS: 'grpc-previous-rpc-attempts',
+        GRPC_RETRY_PUSHBACK_MS: 'grpc-retry-pushback-ms',
+        GRPC_TRACE_BIN: 'grpc-trace-bin',
+        GRPC_TAGS_BIN: 'grpc-tags-bin',
+    }; }
+    /** gRPC MIME / Content-Type values. */
+    static { this.HeaderValues = {
+        GRPC: 'application/grpc',
+        GRPC_PROTO: 'application/grpc+proto',
+        GRPC_JSON: 'application/grpc+json',
+        GRPC_WEB: 'application/grpc-web',
+        GRPC_WEB_PROTO: 'application/grpc-web+proto',
+        GRPC_WEB_JSON: 'application/grpc-web+json',
+        GRPC_WEB_TEXT: 'application/grpc-web-text',
+    }; }
+    /** Standard gRPC status codes (google.rpc.Code). */
+    static { this.ResultCodes = {
+        OK: 0,
+        CANCELLED: 1,
+        UNKNOWN: 2,
+        INVALID_ARGUMENT: 3,
+        DEADLINE_EXCEEDED: 4,
+        NOT_FOUND: 5,
+        ALREADY_EXISTS: 6,
+        PERMISSION_DENIED: 7,
+        RESOURCE_EXHAUSTED: 8,
+        FAILED_PRECONDITION: 9,
+        ABORTED: 10,
+        OUT_OF_RANGE: 11,
+        UNIMPLEMENTED: 12,
+        INTERNAL: 13,
+        UNAVAILABLE: 14,
+        DATA_LOSS: 15,
+        UNAUTHENTICATED: 16,
+    }; }
+}
+exports.GRPC = GRPC;
+//# sourceMappingURL=grpc.js.map

package/dist/common/constants/grpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc.js","sourceRoot":"","sources":["../../../src/common/constants/grpc.ts"],"names":[],"mappings":";;;AAEA,MAAa,IAAI;IACf,yCAAyC;aACzB,YAAO,GAAG;QACxB,KAAK,EAAE,OAAO;QACd,gBAAgB,EAAE,kBAAkB;QACpC,gBAAgB,EAAE,kBAAkB;QACpC,cAAc,EAAE,gBAAgB;KACxB,CAAC;IAEX,0DAA0D;aAC1C,YAAO,GAAG;QACxB,YAAY,EAAE,cAAc;QAC5B,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,YAAY;QAExB,YAAY,EAAE,cAAc;QAC5B,aAAa,EAAE,eAAe;QAC9B,oBAAoB,EAAE,sBAAsB;QAC5C,iBAAiB,EAAE,mBAAmB;QAEtC,WAAW,EAAE,aAAa;QAC1B,YAAY,EAAE,cAAc;QAC5B,uBAAuB,EAAE,yBAAyB;QAElD,0BAA0B,EAAE,4BAA4B;QACxD,sBAAsB,EAAE,wBAAwB;QAEhD,cAAc,EAAE,gBAAgB;QAChC,aAAa,EAAE,eAAe;KACtB,CAAC;IAEX,uCAAuC;aACvB,iBAAY,GAAG;QAC7B,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,wBAAwB;QACpC,SAAS,EAAE,uBAAuB;QAClC,QAAQ,EAAE,sBAAsB;QAChC,cAAc,EAAE,4BAA4B;QAC5C,aAAa,EAAE,2BAA2B;QAC1C,aAAa,EAAE,2BAA2B;KAClC,CAAC;IAEX,oDAAoD;aACpC,gBAAW,GAAG;QAC5B,EAAE,EAAE,CAAC;QACL,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,gBAAgB,EAAE,CAAC;QACnB,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,CAAC;QACZ,cAAc,EAAE,CAAC;QACjB,iBAAiB,EAAE,CAAC;QACpB,kBAAkB,EAAE,CAAC;QACrB,mBAAmB,EAAE,CAAC;QACtB,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,EAAE;QAChB,aAAa,EAAE,EAAE;QACjB,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,EAAE;QACb,eAAe,EAAE,EAAE;KACX,CAAC;;AA7Db,oBA8DC"}

package/dist/common/constants/http.d.ts

@@ -1,15 +1,54 @@
 import { ValueOf } from '../types';
 export declare class HTTP {
+    /** Standard and common HTTP headers (lowercase per HTTP/2 convention). */
     static readonly Headers: {
-        readonly AUTHORIZATION: "authorization";
-        readonly CACHE_CONTROL: "cache-control";
         readonly CONTENT_DISPOSITION: "content-disposition";
         readonly CONTENT_ENCODING: "content-encoding";
         readonly CONTENT_LENGTH: "content-length";
         readonly CONTENT_TYPE: "content-type";
         readonly CONTENT_RANGE: "content-range";
+        readonly CONTENT_SECURITY_POLICY: "content-security-policy";
+        readonly ACCEPT: "accept";
+        readonly ACCEPT_ENCODING: "accept-encoding";
+        readonly ACCEPT_LANGUAGE: "accept-language";
+        readonly AUTHORIZATION: "authorization";
+        readonly COOKIE: "cookie";
+        readonly HOST: "host";
+        readonly IF_MODIFIED_SINCE: "if-modified-since";
+        readonly IF_NONE_MATCH: "if-none-match";
+        readonly ORIGIN: "origin";
+        readonly REFERER: "referer";
+        readonly USER_AGENT: "user-agent";
+        readonly ALLOW: "allow";
+        readonly CACHE_CONTROL: "cache-control";
         readonly ETAG: "etag";
         readonly LAST_MODIFIED: "last-modified";
+        readonly LOCATION: "location";
+        readonly RETRY_AFTER: "retry-after";
+        readonly SET_COOKIE: "set-cookie";
+        readonly VARY: "vary";
+        readonly WWW_AUTHENTICATE: "www-authenticate";
+        readonly ACCESS_CONTROL_ALLOW_CREDENTIALS: "access-control-allow-credentials";
+        readonly ACCESS_CONTROL_ALLOW_HEADERS: "access-control-allow-headers";
+        readonly ACCESS_CONTROL_ALLOW_METHODS: "access-control-allow-methods";
+        readonly ACCESS_CONTROL_ALLOW_ORIGIN: "access-control-allow-origin";
+        readonly ACCESS_CONTROL_EXPOSE_HEADERS: "access-control-expose-headers";
+        readonly ACCESS_CONTROL_MAX_AGE: "access-control-max-age";
+        readonly ACCESS_CONTROL_REQUEST_HEADERS: "access-control-request-headers";
+        readonly ACCESS_CONTROL_REQUEST_METHOD: "access-control-request-method";
+        readonly CONNECTION: "connection";
+        readonly TRANSFER_ENCODING: "transfer-encoding";
+        readonly UPGRADE: "upgrade";
+        readonly STRICT_TRANSPORT_SECURITY: "strict-transport-security";
+        readonly X_CONTENT_TYPE_OPTIONS: "x-content-type-options";
+        readonly X_FRAME_OPTIONS: "x-frame-options";
+        readonly FORWARDED: "forwarded";
+        readonly X_FORWARDED_FOR: "x-forwarded-for";
+        readonly X_FORWARDED_HOST: "x-forwarded-host";
+        readonly X_FORWARDED_PROTO: "x-forwarded-proto";
+        readonly X_RATELIMIT_LIMIT: "x-ratelimit-limit";
+        readonly X_RATELIMIT_REMAINING: "x-ratelimit-remaining";
+        readonly X_RATELIMIT_RESET: "x-ratelimit-reset";
         readonly REQUEST_TRACING_ID: "x-request-id";
         readonly REQUEST_DEVICE_INFO: "x-device-info";
         readonly REQUEST_CHANNEL: "x-request-channel";
@@ -17,13 +56,34 @@ export declare class HTTP {
         readonly RESPONSE_COUNT_DATA: "x-response-count";
         readonly RESPONSE_FORMAT: "x-response-format";
     };
+    /** Common MIME / Content-Type values. */
     static readonly HeaderValues: {
         readonly APPLICATION_FORM_URLENCODED: "application/x-www-form-urlencoded";
+        readonly APPLICATION_GRAPHQL_JSON: "application/graphql+json";
+        readonly APPLICATION_GZIP: "application/gzip";
+        readonly APPLICATION_JAVASCRIPT: "application/javascript";
         readonly APPLICATION_JSON: "application/json";
-        readonly APPPLICATION_OCTET_STREAM: "application/octet-stream";
+        readonly APPLICATION_MSGPACK: "application/msgpack";
+        readonly APPLICATION_NDJSON: "application/x-ndjson";
+        readonly APPLICATION_OCTET_STREAM: "application/octet-stream";
+        readonly APPLICATION_PDF: "application/pdf";
+        readonly APPLICATION_PROTOBUF: "application/x-protobuf";
+        readonly APPLICATION_XML: "application/xml";
+        readonly APPLICATION_ZIP: "application/zip";
         readonly MULTIPART_FORM_DATA: "multipart/form-data";
+        readonly TEXT_CSS: "text/css";
+        readonly TEXT_CSV: "text/csv";
+        readonly TEXT_EVENT_STREAM: "text/event-stream";
+        readonly TEXT_HTML: "text/html";
         readonly TEXT_PLAIN: "text/plain";
+        readonly TEXT_XML: "text/xml";
+        readonly IMAGE_GIF: "image/gif";
+        readonly IMAGE_JPEG: "image/jpeg";
+        readonly IMAGE_PNG: "image/png";
+        readonly IMAGE_SVG: "image/svg+xml";
+        readonly IMAGE_WEBP: "image/webp";
     };
+    /** Standard HTTP methods (lowercase). */
     static readonly Methods: {
         readonly GET: "get";
         readonly POST: "post";
@@ -33,10 +93,15 @@ export declare class HTTP {
         readonly HEAD: "head";
         readonly OPTIONS: "options";
     };
+    /** HTTP status codes grouped by class (1xx–5xx). */
     static readonly ResultCodes: {
-        readonly RS_FAIL: 0;
-        readonly RS_SUCCESS: 1;
-        readonly RS_UNKNOWN_ERROR: -199;
+        /** 1xx — Informational. */
+        readonly RS_1: {
+            readonly Continue: 100;
+            readonly SwitchingProtocols: 101;
+            readonly EarlyHints: 103;
+        };
+        /** 2xx — Success. */
         readonly RS_2: {
             readonly Ok: 200;
             readonly Created: 201;
@@ -47,6 +112,7 @@ export declare class HTTP {
             readonly PartialContent: 206;
             readonly MultiStatus: 207;
         };
+        /** 3xx — Redirection. */
         readonly RS_3: {
             readonly MovedPermanently: 301;
             readonly Found: 302;
@@ -54,6 +120,7 @@ export declare class HTTP {
             readonly TemporaryRedirect: 307;
             readonly PermanentRedirect: 308;
         };
+        /** 4xx — Client error. */
         readonly RS_4: {
             readonly BadRequest: 400;
             readonly Unauthorized: 401;
@@ -82,6 +149,7 @@ export declare class HTTP {
             readonly RequestHeaderFieldsTooLarge: 431;
             readonly UnavailableForLegalReasons: 451;
         };
+        /** 5xx — Server error. */
         readonly RS_5: {
             readonly InternalServerError: 500;
             readonly NotImplemented: 501;

package/dist/common/constants/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/common/constants/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,qBAAa,IAAI;IACf,MAAM,CAAC,QAAQ,CAAC,OAAO;;;;;;;;;;;;;;;;MAoBZ;IAEX,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;MAMjB;IAEX,MAAM,CAAC,QAAQ,CAAC,OAAO;;;;;;;;MAQZ;IAEX,MAAM,CAAC,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgEhB;CACZ;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/common/constants/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,qBAAa,IAAI;IACf,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAuEZ;IAEX,yCAAyC;IACzC,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;MAgCjB;IAEX,yCAAyC;IACzC,MAAM,CAAC,QAAQ,CAAC,OAAO;;;;;;;;MAQZ;IAEX,oDAAoD;IACpD,MAAM,CAAC,QAAQ,CAAC,WAAW;QACzB,2BAA2B;;;;;;QAO3B,qBAAqB;;;;;;;;;;;QAYrB,yBAAyB;;;;;;;;QASzB,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8B1B,0BAA0B;;;;;;;;;;;;MAYjB;CACZ;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC"}

package/dist/common/constants/http.js

@@ -2,16 +2,64 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HTTP = void 0;
 class HTTP {
+    /** Standard and common HTTP headers (lowercase per HTTP/2 convention). */
     static { this.Headers = {
-        AUTHORIZATION: 'authorization',
-        CACHE_CONTROL: 'cache-control',
+        // Content
         CONTENT_DISPOSITION: 'content-disposition',
         CONTENT_ENCODING: 'content-encoding',
         CONTENT_LENGTH: 'content-length',
         CONTENT_TYPE: 'content-type',
         CONTENT_RANGE: 'content-range',
+        CONTENT_SECURITY_POLICY: 'content-security-policy',
+        // Request — content negotiation & conditionals
+        ACCEPT: 'accept',
+        ACCEPT_ENCODING: 'accept-encoding',
+        ACCEPT_LANGUAGE: 'accept-language',
+        AUTHORIZATION: 'authorization',
+        COOKIE: 'cookie',
+        HOST: 'host',
+        IF_MODIFIED_SINCE: 'if-modified-since',
+        IF_NONE_MATCH: 'if-none-match',
+        ORIGIN: 'origin',
+        REFERER: 'referer',
+        USER_AGENT: 'user-agent',
+        // Response — caching, auth challenges & redirects
+        ALLOW: 'allow',
+        CACHE_CONTROL: 'cache-control',
         ETAG: 'etag',
         LAST_MODIFIED: 'last-modified',
+        LOCATION: 'location',
+        RETRY_AFTER: 'retry-after',
+        SET_COOKIE: 'set-cookie',
+        VARY: 'vary',
+        WWW_AUTHENTICATE: 'www-authenticate',
+        // CORS (RFC 6454 / Fetch spec)
+        ACCESS_CONTROL_ALLOW_CREDENTIALS: 'access-control-allow-credentials',
+        ACCESS_CONTROL_ALLOW_HEADERS: 'access-control-allow-headers',
+        ACCESS_CONTROL_ALLOW_METHODS: 'access-control-allow-methods',
+        ACCESS_CONTROL_ALLOW_ORIGIN: 'access-control-allow-origin',
+        ACCESS_CONTROL_EXPOSE_HEADERS: 'access-control-expose-headers',
+        ACCESS_CONTROL_MAX_AGE: 'access-control-max-age',
+        ACCESS_CONTROL_REQUEST_HEADERS: 'access-control-request-headers',
+        ACCESS_CONTROL_REQUEST_METHOD: 'access-control-request-method',
+        // Transport
+        CONNECTION: 'connection',
+        TRANSFER_ENCODING: 'transfer-encoding',
+        UPGRADE: 'upgrade',
+        // Security
+        STRICT_TRANSPORT_SECURITY: 'strict-transport-security',
+        X_CONTENT_TYPE_OPTIONS: 'x-content-type-options',
+        X_FRAME_OPTIONS: 'x-frame-options',
+        // Proxy / forwarding (de facto standard)
+        FORWARDED: 'forwarded',
+        X_FORWARDED_FOR: 'x-forwarded-for',
+        X_FORWARDED_HOST: 'x-forwarded-host',
+        X_FORWARDED_PROTO: 'x-forwarded-proto',
+        // Rate limiting (de facto standard)
+        X_RATELIMIT_LIMIT: 'x-ratelimit-limit',
+        X_RATELIMIT_REMAINING: 'x-ratelimit-remaining',
+        X_RATELIMIT_RESET: 'x-ratelimit-reset',
+        // Ignis custom
         REQUEST_TRACING_ID: 'x-request-id',
         REQUEST_DEVICE_INFO: 'x-device-info',
         REQUEST_CHANNEL: 'x-request-channel',
@@ -19,13 +67,38 @@ class HTTP {
         RESPONSE_COUNT_DATA: 'x-response-count',
         RESPONSE_FORMAT: 'x-response-format',
     }; }
+    /** Common MIME / Content-Type values. */
     static { this.HeaderValues = {
+        // Application
         APPLICATION_FORM_URLENCODED: 'application/x-www-form-urlencoded',
+        APPLICATION_GRAPHQL_JSON: 'application/graphql+json',
+        APPLICATION_GZIP: 'application/gzip',
+        APPLICATION_JAVASCRIPT: 'application/javascript',
         APPLICATION_JSON: 'application/json',
-        APPPLICATION_OCTET_STREAM: 'application/octet-stream',
+        APPLICATION_MSGPACK: 'application/msgpack',
+        APPLICATION_NDJSON: 'application/x-ndjson',
+        APPLICATION_OCTET_STREAM: 'application/octet-stream',
+        APPLICATION_PDF: 'application/pdf',
+        APPLICATION_PROTOBUF: 'application/x-protobuf',
+        APPLICATION_XML: 'application/xml',
+        APPLICATION_ZIP: 'application/zip',
+        // Multipart
         MULTIPART_FORM_DATA: 'multipart/form-data',
+        // Text
+        TEXT_CSS: 'text/css',
+        TEXT_CSV: 'text/csv',
+        TEXT_EVENT_STREAM: 'text/event-stream',
+        TEXT_HTML: 'text/html',
         TEXT_PLAIN: 'text/plain',
+        TEXT_XML: 'text/xml',
+        // Image
+        IMAGE_GIF: 'image/gif',
+        IMAGE_JPEG: 'image/jpeg',
+        IMAGE_PNG: 'image/png',
+        IMAGE_SVG: 'image/svg+xml',
+        IMAGE_WEBP: 'image/webp',
     }; }
+    /** Standard HTTP methods (lowercase). */
     static { this.Methods = {
         GET: 'get',
         POST: 'post',
@@ -35,10 +108,15 @@ class HTTP {
         HEAD: 'head',
         OPTIONS: 'options',
     }; }
+    /** HTTP status codes grouped by class (1xx–5xx). */
     static { this.ResultCodes = {
-        RS_FAIL: 0,
-        RS_SUCCESS: 1,
-        RS_UNKNOWN_ERROR: -199,
+        /** 1xx — Informational. */
+        RS_1: {
+            Continue: 100,
+            SwitchingProtocols: 101,
+            EarlyHints: 103,
+        },
+        /** 2xx — Success. */
         RS_2: {
             Ok: 200,
             Created: 201,
@@ -49,6 +127,7 @@ class HTTP {
             PartialContent: 206,
             MultiStatus: 207,
         },
+        /** 3xx — Redirection. */
         RS_3: {
             MovedPermanently: 301,
             Found: 302,
@@ -56,6 +135,7 @@ class HTTP {
             TemporaryRedirect: 307,
             PermanentRedirect: 308,
         },
+        /** 4xx — Client error. */
         RS_4: {
             BadRequest: 400,
             Unauthorized: 401,
@@ -84,6 +164,7 @@ class HTTP {
             RequestHeaderFieldsTooLarge: 431,
             UnavailableForLegalReasons: 451,
         },
+        /** 5xx — Server error. */
         RS_5: {
             InternalServerError: 500,
             NotImplemented: 501,

package/dist/common/constants/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/common/constants/http.ts"],"names":[],"mappings":";;;AAEA,MAAa,IAAI;aACC,YAAO,GAAG;QACxB,aAAa,EAAE,eAAe;QAC9B,aAAa,EAAE,eAAe;QAC9B,mBAAmB,EAAE,qBAAqB;QAC1C,gBAAgB,EAAE,kBAAkB;QACpC,cAAc,EAAE,gBAAgB;QAChC,YAAY,EAAE,cAAc;QAC5B,aAAa,EAAE,eAAe;QAC9B,IAAI,EAAE,MAAM;QAEZ,aAAa,EAAE,eAAe;QAE9B,kBAAkB,EAAE,cAAc;QAClC,mBAAmB,EAAE,eAAe;QACpC,eAAe,EAAE,mBAAmB;QAEpC,kBAAkB,EAAE,iBAAiB;QACrC,mBAAmB,EAAE,kBAAkB;QAEvC,eAAe,EAAE,mBAAmB;KAC5B,CAAC;aAEK,iBAAY,GAAG;QAC7B,2BAA2B,EAAE,mCAAmC;QAChE,gBAAgB,EAAE,kBAAkB;QACpC,yBAAyB,EAAE,0BAA0B;QACrD,mBAAmB,EAAE,qBAAqB;QAC1C,UAAU,EAAE,YAAY;KAChB,CAAC;aAEK,YAAO,GAAG;QACxB,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,SAAS;KACV,CAAC;aAEK,gBAAW,GAAG;QAC5B,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,gBAAgB,EAAE,CAAC,GAAG;QAEtB,IAAI,EAAE;YACJ,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,GAAG;YACZ,QAAQ,EAAE,GAAG;YACb,2BAA2B,EAAE,GAAG;YAChC,SAAS,EAAE,GAAG;YACd,YAAY,EAAE,GAAG;YACjB,cAAc,EAAE,GAAG;YACnB,WAAW,EAAE,GAAG;SACjB;QAED,IAAI,EAAE;YACJ,gBAAgB,EAAE,GAAG;YACrB,KAAK,EAAE,GAAG;YACV,WAAW,EAAE,GAAG;YAChB,iBAAiB,EAAE,GAAG;YACtB,iBAAiB,EAAE,GAAG;SACvB;QAED,IAAI,EAAE;YACJ,UAAU,EAAE,GAAG;YACf,YAAY,EAAE,GAAG;YACjB,eAAe,EAAE,GAAG;YACpB,SAAS,EAAE,GAAG;YACd,QAAQ,EAAE,GAAG;YACb,gBAAgB,EAAE,GAAG;YACrB,aAAa,EAAE,GAAG;YAClB,cAAc,EAAE,GAAG;YACnB,QAAQ,EAAE,GAAG;YACb,IAAI,EAAE,GAAG;YACT,cAAc,EAAE,GAAG;YACnB,kBAAkB,EAAE,GAAG;YACvB,eAAe,EAAE,GAAG;YACpB,UAAU,EAAE,GAAG;YACf,oBAAoB,EAAE,GAAG;YACzB,mBAAmB,EAAE,GAAG;YACxB,iBAAiB,EAAE,GAAG;YACtB,mBAAmB,EAAE,GAAG;YACxB,MAAM,EAAE,GAAG;YACX,gBAAgB,EAAE,GAAG;YACrB,QAAQ,EAAE,GAAG;YACb,eAAe,EAAE,GAAG;YACpB,oBAAoB,EAAE,GAAG;YACzB,eAAe,EAAE,GAAG;YACpB,2BAA2B,EAAE,GAAG;YAChC,0BAA0B,EAAE,GAAG;SAChC;QAED,IAAI,EAAE;YACJ,mBAAmB,EAAE,GAAG;YACxB,cAAc,EAAE,GAAG;YACnB,UAAU,EAAE,GAAG;YACf,kBAAkB,EAAE,GAAG;YACvB,cAAc,EAAE,GAAG;YACnB,uBAAuB,EAAE,GAAG;YAC5B,mBAAmB,EAAE,GAAG;YACxB,YAAY,EAAE,GAAG;YACjB,6BAA6B,EAAE,GAAG;SACnC;KACO,CAAC;;AAzGb,oBA0GC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/common/constants/http.ts"],"names":[],"mappings":"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"}

package/dist/common/constants/index.d.ts

@@ -1,4 +1,5 @@
 export * from './app';
+export * from './grpc';
 export * from './http';
 export * from './mime';
 //# sourceMappingURL=index.d.ts.map

package/dist/common/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}

package/dist/common/constants/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./app"), exports);
+__exportStar(require("./grpc"), exports);
 __exportStar(require("./http"), exports);
 __exportStar(require("./mime"), exports);
 //# sourceMappingURL=index.js.map

package/dist/common/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,yCAAuB;AACvB,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,yCAAuB;AACvB,yCAAuB;AACvB,yCAAuB"}

package/dist/modules/queue/kafka/admin.d.ts

@@ -0,0 +1,32 @@
+import { Admin } from '@platformatic/kafka';
+import { BaseKafkaHelper } from './base';
+import type { IKafkaAdminOptions } from './common/types';
+/**
+ * KafkaAdminHelper — Wrapper around `@platformatic/kafka` Admin.
+ *
+ * Provides scoped logging, lifecycle management, and health tracking.
+ * Use `getAdmin()` to access the full Admin API directly.
+ *
+ * @example
+ * const helper = KafkaAdminHelper.newInstance({
+ *   bootstrapBrokers: ['127.0.0.1:29092'],
+ *   clientId: 'my-admin',
+ *   onBrokerConnect: ({ broker }) => console.log(`Connected to ${broker.host}:${broker.port}`),
+ * });
+ *
+ * const admin = helper.getAdmin();
+ * await admin.createTopics({ topics: ['my-topic'], partitions: 3, replicas: 1 });
+ *
+ * helper.isHealthy(); // true when connected
+ *
+ * await helper.close();
+ */
+export declare class KafkaAdminHelper extends BaseKafkaHelper<Admin> {
+    constructor(opts: IKafkaAdminOptions);
+    static newInstance(opts: IKafkaAdminOptions): KafkaAdminHelper;
+    getAdmin(): Admin;
+    close(opts?: {
+        isForce?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=admin.d.ts.map

package/dist/modules/queue/kafka/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../../src/modules/queue/kafka/admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAiB,SAAQ,eAAe,CAAC,KAAK,CAAC;gBAC9C,IAAI,EAAE,kBAAkB;IA6BpC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,gBAAgB;IAI9D,QAAQ,IAAI,KAAK;IAIX,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBzD"}

package/dist/modules/queue/kafka/admin.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KafkaAdminHelper = void 0;
+const kafka_1 = require("@platformatic/kafka");
+const base_1 = require("./base");
+const constants_1 = require("./common/constants");
+/**
+ * KafkaAdminHelper — Wrapper around `@platformatic/kafka` Admin.
+ *
+ * Provides scoped logging, lifecycle management, and health tracking.
+ * Use `getAdmin()` to access the full Admin API directly.
+ *
+ * @example
+ * const helper = KafkaAdminHelper.newInstance({
+ *   bootstrapBrokers: ['127.0.0.1:29092'],
+ *   clientId: 'my-admin',
+ *   onBrokerConnect: ({ broker }) => console.log(`Connected to ${broker.host}:${broker.port}`),
+ * });
+ *
+ * const admin = helper.getAdmin();
+ * await admin.createTopics({ topics: ['my-topic'], partitions: 3, replicas: 1 });
+ *
+ * helper.isHealthy(); // true when connected
+ *
+ * await helper.close();
+ */
+class KafkaAdminHelper extends base_1.BaseKafkaHelper {
+    constructor(opts) {
+        super({
+            scope: KafkaAdminHelper.name,
+            identifier: opts.identifier ?? 'kafka-admin',
+            shutdownTimeout: opts.shutdownTimeout,
+            client: new kafka_1.Admin({
+                clientId: opts.clientId,
+                bootstrapBrokers: opts.bootstrapBrokers,
+                sasl: opts.sasl,
+                tls: opts.tls,
+                ssl: opts.ssl,
+                connectTimeout: opts.connectTimeout,
+                requestTimeout: opts.requestTimeout,
+                retries: opts.retries ?? constants_1.KafkaDefaults.RETRIES,
+                retryDelay: opts.retryDelay ?? constants_1.KafkaDefaults.RETRY_DELAY,
+            }),
+            onBrokerConnect: opts.onBrokerConnect,
+            onBrokerDisconnect: opts.onBrokerDisconnect,
+        });
+        this.configureBrokerEvents();
+        this.logger.info('[constructor] Kafka Admin CREATED | ClientId: %s | Brokers: %j', opts.clientId, opts.bootstrapBrokers);
+    }
+    static newInstance(opts) {
+        return new KafkaAdminHelper(opts);
+    }
+    getAdmin() {
+        return this.client;
+    }
+    async close(opts) {
+        const force = opts?.isForce ?? false;
+        if (force) {
+            await this.closeClient();
+        }
+        else {
+            try {
+                await this.gracefulCloseClient();
+            }
+            catch {
+                this.logger.warn('[close] Graceful shutdown timed out, forcing close');
+                await this.closeClient();
+            }
+        }
+        this.healthStatus = constants_1.KafkaHealthStatuses.DISCONNECTED;
+        this.logger.info('[close] Admin closed | Force: %s', force);
+    }
+}
+exports.KafkaAdminHelper = KafkaAdminHelper;
+//# sourceMappingURL=admin.js.map

package/dist/modules/queue/kafka/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../../../src/modules/queue/kafka/admin.ts"],"names":[],"mappings":";;;AAAA,+CAA4C;AAC5C,iCAAyC;AACzC,kDAAwE;AAGxE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,gBAAiB,SAAQ,sBAAsB;IAC1D,YAAY,IAAwB;QAClC,KAAK,CAAC;YACJ,KAAK,EAAE,gBAAgB,CAAC,IAAI;YAC5B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,aAAa;YAC5C,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM,EAAE,IAAI,aAAK,CAAC;gBAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,yBAAa,CAAC,OAAO;gBAC9C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,yBAAa,CAAC,WAAW;aACzD,CAAC;YACF,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;SAC5C,CAAC,CAAC;QAEH,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,gEAAgE,EAChE,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,gBAAgB,CACtB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAwB;QACzC,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAA4B;QACtC,MAAM,KAAK,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;QAErC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;gBACvE,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,+BAAmB,CAAC,YAAY,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;CACF;AAvDD,4CAuDC"}

package/dist/modules/queue/kafka/base.d.ts

@@ -0,0 +1,38 @@
+import type { Base, BaseOptions } from '@platformatic/kafka';
+import { BaseHelper } from '@venizia/ignis-helpers';
+import { type TKafkaHealthStatus } from './common/constants';
+import type { TKafkaBrokerEventCallback } from './common/types';
+export interface IKafkaBaseOptions<TClient extends Base<BaseOptions>> {
+    scope: string;
+    identifier: string;
+    client: TClient;
+    shutdownTimeout?: number;
+    onBrokerConnect?: TKafkaBrokerEventCallback;
+    onBrokerDisconnect?: TKafkaBrokerEventCallback;
+}
+/**
+ * BaseKafkaHelper — Shared health tracking and broker event wiring
+ * for all Kafka helpers (producer, consumer, admin).
+ *
+ * Generic `TClient` is the platformatic client type (Producer, Consumer, Admin).
+ * Subclasses create the client, pass it via `super({ client })`, and access it
+ * through `this.client`. Broker events are wired automatically in the constructor.
+ */
+export declare abstract class BaseKafkaHelper<TClient extends Base<BaseOptions>> extends BaseHelper {
+    protected readonly client: TClient;
+    protected readonly shutdownTimeout: number;
+    protected healthStatus: TKafkaHealthStatus;
+    private readonly onBrokerConnect?;
+    private readonly onBrokerDisconnect?;
+    constructor(opts: IKafkaBaseOptions<TClient>);
+    isHealthy(): boolean;
+    isReady(): boolean;
+    getHealthStatus(): TKafkaHealthStatus;
+    protected configureBrokerConnect(): void;
+    protected configureBrokerDisconnect(): void;
+    protected configureBrokerFailed(): void;
+    protected configureBrokerEvents(): void;
+    protected closeClient(): Promise<void>;
+    protected gracefulCloseClient(): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/modules/queue/kafka/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/modules/queue/kafka/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAA8B,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,IAAI,CAAC,WAAW,CAAC;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAC5C,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,8BAAsB,eAAe,CAAC,OAAO,SAAS,IAAI,CAAC,WAAW,CAAC,CAAE,SAAQ,UAAU;IACzF,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAE3C,SAAS,CAAC,YAAY,EAAE,kBAAkB,CAA+B;IAEzE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAA4B;IAC7D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAA4B;gBAEpD,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC;IAQ5C,SAAS,IAAI,OAAO;IAIpB,OAAO,IAAI,OAAO;IAIlB,eAAe,IAAI,kBAAkB;IAIrC,SAAS,CAAC,sBAAsB;IAYhC,SAAS,CAAC,yBAAyB;IAYnC,SAAS,CAAC,qBAAqB;IAW/B,SAAS,CAAC,qBAAqB,IAAI,IAAI;IAMvC,SAAS,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,SAAS,CAAC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/C"}