@venizia/ignis-helpers 0.0.9-1 → 0.1.1-0

package/README.md

@@ -20,7 +20,7 @@ Logging, Redis, queues (BullMQ/MQTT/Kafka), storage (MinIO/Disk/Memory), cryptog
 | :---: | :--- | :--- |
 | **1** | **14+ Production Modules** | Logger, Redis, Queue, Storage, Crypto, Network, and more |
 | **2** | **Pluggable Architecture** | Install only what you use via optional peer deps |
-| **3** | **Sub-Path Imports** | Tree-shake heavy modules with `@venizia/ignis-helpers/redis` |
+| **3** | **Sub-Path Imports** | Tree-shake heavy modules with `@venizia/ignis-helpers/bullmq`, `/minio`, `/kafka`, etc. |
 | **4** | **Consistent API** | Every helper extends `BaseHelper` with scoped logging |
 | **5** | **HfLogger** | Zero-allocation ring buffer logger for hot paths (~100-300ns) |
 | **6** | **Snowflake UID** | 70-bit distributed IDs at ~4M/sec/worker |
@@ -32,11 +32,9 @@ Logging, Redis, queues (BullMQ/MQTT/Kafka), storage (MinIO/Disk/Memory), cryptog
 The 5 most common imports:
 
 ```typescript
-import { LoggerFactory } from '@venizia/ignis-helpers';
-import { RedisHelper } from '@venizia/ignis-helpers/redis';
+import { LoggerFactory, RedisSingleHelper, AES } from '@venizia/ignis-helpers';
 import { BullMQHelper } from '@venizia/ignis-helpers/bullmq';
 import { MinioHelper } from '@venizia/ignis-helpers/minio';
-import { CryptoHelper } from '@venizia/ignis-helpers/crypto';
 ```
 
 ---
@@ -751,7 +749,7 @@ Additionally, the client logs `reconnecting` events automatically.
 
 ### Reconnection Behavior
 
-The `RedisHelper` uses exponential backoff for reconnection:
+The Redis helper (`AbstractRedisHelper`) uses exponential backoff for reconnection:
 
 ```
 Strategy: Math.max(Math.min(attempt * 2000, 5000), 1000) ms
@@ -840,7 +838,7 @@ await worker.close();
 - `removeOnComplete: true` -- clean up completed jobs automatically
 - `removeOnFail: true` -- clean up failed jobs automatically
 
-**Redis connection note:** BullMQ requires `maxRetriesPerRequest: null`. The `RedisHelper` sets this automatically. The BullMQ helper calls `redisConnection.getClient().duplicate()` for both queue and worker connections so they don't interfere with your main Redis client.
+**Redis connection note:** BullMQ requires `maxRetriesPerRequest: null`. The Redis helper sets this automatically. The BullMQ helper calls `redisConnection.getClient().duplicate()` for both queue and worker connections so they don't interfere with your main Redis client.
 
 **Supported roles:**
 
@@ -953,27 +951,7 @@ The MQTT client auto-connects on construction. If the client is already establis
 
 ### Kafka (Experimental)
 
-Apache Kafka helpers built on `@platformatic/kafka`. Import from the `@venizia/ignis-helpers/kafka` sub-path.
-
-**Constants and defaults:**
-
-| Constant                         | Default        | Description                           |
-| -------------------------------- | -------------- | ------------------------------------- |
-| `KafkaDefaults.CLIENT_ID`        | `ignis-kafka`  | Default client ID                     |
-| `KafkaDefaults.SESSION_TIMEOUT`  | `30000`        | Consumer session timeout (ms)         |
-| `KafkaDefaults.HEARTBEAT_INTERVAL` | `3000`       | Consumer heartbeat interval (ms)      |
-| `KafkaDefaults.MAX_WAIT_TIME`    | `5000`         | Max wait time for fetch (ms)          |
-| `KafkaDefaults.HIGH_WATER_MARK`  | `1024`         | Stream high water mark                |
-
-**Ack levels (`KafkaAcks`):**
-
-| Constant           | Value | Behavior               |
-| ------------------ | ----- | ---------------------- |
-| `KafkaAcks.NONE`   | `0`   | No acknowledgment      |
-| `KafkaAcks.LEADER` | `1`   | Leader only            |
-| `KafkaAcks.ALL`    | `-1`  | All in-sync replicas   |
-
-**Producer:**
+Apache Kafka helpers built on `@platformatic/kafka`, imported from the `@venizia/ignis-helpers/kafka` sub-path: `KafkaProducerHelper`, `KafkaConsumerHelper`, `KafkaAdminHelper`, and `KafkaSchemaRegistryHelper`, all extending a shared `BaseKafkaHelper` (scoped logging, per-broker health tracking, graceful shutdown, `newInstance()` factory pattern).
 
 ```typescript
 import { KafkaProducerHelper, KafkaAcks } from '@venizia/ignis-helpers/kafka';
@@ -981,173 +959,17 @@ import { KafkaProducerHelper, KafkaAcks } from '@venizia/ignis-helpers/kafka';
 const producer = KafkaProducerHelper.newInstance({
   identifier: 'my-producer',
   bootstrapBrokers: ['localhost:9092'],
-  clientId: 'my-app',               // Default: 'ignis-kafka'
-  acks: KafkaAcks.ALL,              // -1 = all replicas
-  timeout: 30000,                    // Connection timeout
-  retries: 5,                        // Connection retries
-  retryDelay: 100,                   // Delay between retries
-  autocreateTopics: true,            // Auto-create topics on send
-  onConnected: () => console.log('Producer connected'),
-  onDisconnected: () => console.log('Producer disconnected'),
-  onError: ({ error }) => console.error('Producer error:', error),
+  acks: KafkaAcks.ALL, // -1 = all in-sync replicas
 });
 
-// Send messages
 await producer.send({
-  messages: [
-    { topic: 'events', key: 'user-1', value: JSON.stringify({ action: 'login' }) },
-    { topic: 'events', key: 'user-2', value: JSON.stringify({ action: 'signup' }) },
-  ],
-  acks: KafkaAcks.ALL,
-});
-
-// Send batch (grouped by topic)
-await producer.sendBatch({
-  topicMessages: [
-    {
-      topic: 'orders',
-      messages: [
-        { key: 'order-1', value: JSON.stringify({ total: 99.99 }) },
-        { key: 'order-2', value: JSON.stringify({ total: 149.50 }) },
-      ],
-    },
-    {
-      topic: 'notifications',
-      messages: [
-        { key: 'notif-1', value: JSON.stringify({ type: 'email' }) },
-      ],
-    },
-  ],
+  messages: [{ topic: 'events', key: 'user-1', value: JSON.stringify({ action: 'login' }) }],
 });
 
-// Access underlying @platformatic/kafka Producer
-const rawProducer = producer.getProducer();
-
 await producer.close();
 ```
 
-**Consumer:**
-
-```typescript
-import { KafkaConsumerHelper } from '@venizia/ignis-helpers/kafka';
-
-const consumer = KafkaConsumerHelper.newInstance({
-  identifier: 'my-consumer',
-  bootstrapBrokers: ['localhost:9092'],
-  groupId: 'my-group',
-  topics: ['events'],
-  mode: 'latest',                    // 'latest' | 'earliest' | 'committed'
-  autocommit: true,                  // Auto-commit offsets (default: true)
-  sessionTimeout: 30_000,
-  heartbeatInterval: 3_000,
-  highWaterMark: 1024,
-  maxWaitTime: 5_000,
-
-  onMessage: async ({ message }) => {
-    console.log(`[${message.topic}:${message.partition}]`, message.value);
-    console.log('  key:', message.key);
-    console.log('  offset:', message.offset);
-    console.log('  timestamp:', message.timestamp);
-    console.log('  headers:', message.headers);
-
-    // Manual commit (when autocommit: false)
-    // await message.commit();
-  },
-  onError: ({ error }) => console.error('Consumer error:', error),
-  onConnected: () => console.log('Consumer connected'),
-  onDisconnected: () => console.log('Consumer disconnected'),
-  onGroupJoin: ({ groupId, memberId }) => console.log(`Joined ${groupId} as ${memberId}`),
-  onGroupLeave: () => console.log('Left consumer group'),
-  onRebalance: () => console.log('Rebalance triggered'),
-  onLag: ({ offsets }) => console.log('Consumer lag:', offsets),
-});
-
-// Start consuming (fires up the async consume loop)
-await consumer.start();
-
-// Flow control
-consumer.pause();          // Pause the message stream
-consumer.resume();         // Resume the message stream
-consumer.isPaused();       // Check if paused
-consumer.isConsuming();    // Check if actively consuming
-
-// Manual commit (when autocommit: false)
-await consumer.commit({
-  offsets: [{ topic: 'events', partition: 0, offset: 42n, leaderEpoch: 0 }],
-});
-
-// Lag monitoring
-consumer.startLagMonitoring({ interval: 10_000 }); // Check every 10s
-consumer.stopLagMonitoring();
-
-// Access underlying @platformatic/kafka Consumer
-const rawConsumer = consumer.getConsumer();
-
-await consumer.close();
-```
-
-**Admin:**
-
-```typescript
-import { KafkaAdminHelper, KafkaConfigResourceTypes } from '@venizia/ignis-helpers/kafka';
-
-const admin = KafkaAdminHelper.newInstance({
-  identifier: 'my-admin',
-  bootstrapBrokers: ['localhost:9092'],
-  onConnected: () => console.log('Admin connected'),
-});
-
-// Topic management
-await admin.createTopics({ topics: ['events', 'orders'], partitions: 3, replicas: 1 });
-await admin.deleteTopics({ topics: ['old-topic'] });
-const topics = await admin.listTopics();                     // string[]
-const topicsWithInternal = await admin.listTopics({ includeInternals: true });
-const metadata = await admin.metadata({ topics: ['events'] });
-
-// Partition management
-await admin.createPartitions({
-  topics: [{ name: 'events', count: 6 }],   // Increase to 6 partitions
-  validateOnly: false,
-});
-
-// Consumer group management
-const groups = await admin.listGroups({ states: ['Stable'] });
-const groupInfo = await admin.describeGroups({ groups: ['my-group'] });
-await admin.deleteGroups({ groups: ['old-group'] });
-
-// Offset management
-const offsets = await admin.listConsumerGroupOffsets({ groups: ['my-group'] });
-await admin.alterConsumerGroupOffsets({
-  groupId: 'my-group',
-  topics: [{
-    name: 'events',
-    partitionOffsets: [{ partition: 0, offset: 100n }],
-  }],
-});
-
-// Config management
-const configs = await admin.describeConfigs({
-  resources: [{
-    resourceType: KafkaConfigResourceTypes.TOPIC,  // 2
-    resourceName: 'events',
-  }],
-  includeSynonyms: false,
-  includeDocumentation: true,
-});
-
-await admin.alterConfigs({
-  resources: [{
-    resourceType: KafkaConfigResourceTypes.TOPIC,
-    resourceName: 'events',
-    configs: [{ name: 'retention.ms', value: '604800000' }], // 7 days
-  }],
-});
-
-// Access underlying @platformatic/kafka Admin
-const rawAdmin = admin.getAdmin();
-
-await admin.close();
-```
+Consumers support consumer groups, lag monitoring, and manual/auto commit; admin covers topic/partition/group/config management. Full API, constants, and examples: [Kafka reference](https://github.com/VENIZIA-AI/ignis/blob/main/docs/wiki/content/extensions/helpers/kafka/index.md) ([producer](https://github.com/VENIZIA-AI/ignis/blob/main/docs/wiki/content/extensions/helpers/kafka/producer.md), [consumer](https://github.com/VENIZIA-AI/ignis/blob/main/docs/wiki/content/extensions/helpers/kafka/consumer.md), [admin](https://github.com/VENIZIA-AI/ignis/blob/main/docs/wiki/content/extensions/helpers/kafka/admin.md)).
 
 ---
 
@@ -2906,13 +2728,14 @@ The helpers package is designed to integrate with the IGNIS framework's IoC cont
 **Binding helpers in the application lifecycle:**
 
 ```typescript
-import { BaseApplication, BootMixin } from '@venizia/ignis';
-import { RedisSingleHelper, Logger } from '@venizia/ignis-helpers';
+import { BaseApplication } from '@venizia/ignis';
+import { BootMixin } from '@venizia/ignis-boot';
+import { RedisSingleHelper } from '@venizia/ignis-helpers';
 
 class MyApplication extends BootMixin(BaseApplication) {
   async preConfigure() {
-    // Register Redis as a singleton binding
-    this.container.bind('datasources.Redis').to(
+    // BaseApplication extends the IoC Container directly -- bind on `this`, not `this.container`.
+    this.bind({ key: 'datasources.Redis' }).toValue(
       new RedisSingleHelper({
         name: 'main',
         host: process.env.REDIS_HOST,
@@ -2931,12 +2754,15 @@ class MyApplication extends BootMixin(BaseApplication) {
 
 ```typescript
 import { inject } from '@venizia/ignis-inversion';
-import { RedisHelper } from '@venizia/ignis-helpers';
+import { BaseService } from '@venizia/ignis';
+import { IRedisHelper } from '@venizia/ignis-helpers';
 
-export class CacheService {
+export class CacheService extends BaseService {
   constructor(
-    @inject({ key: 'datasources.Redis' }) private redis: RedisHelper,
-  ) {}
+    @inject({ key: 'datasources.Redis' }) private redis: IRedisHelper,
+  ) {
+    super({ scope: CacheService.name });
+  }
 
   async getCached(key: string) {
     return this.redis.getObject({ key });
@@ -2947,19 +2773,30 @@ export class CacheService {
 **Using helpers in controllers:**
 
 ```typescript
-import { controller, get } from '@venizia/ignis';
+import { BaseRestController, controller, get, jsonResponse, TRouteContext } from '@venizia/ignis';
 import { inject } from '@venizia/ignis-inversion';
+import { IRedisHelper } from '@venizia/ignis-helpers';
+import { z } from '@hono/zod-openapi';
 
 @controller({ path: '/health' })
-export class HealthController extends BaseController {
+export class HealthController extends BaseRestController {
   constructor(
-    @inject({ key: 'datasources.Redis' }) private redis: RedisHelper,
-  ) { super(); }
+    @inject({ key: 'datasources.Redis' }) private redis: IRedisHelper,
+  ) {
+    super({ scope: HealthController.name });
+  }
+
+  override binding() {}
 
-  @get('/')
-  async check() {
+  @get({
+    configs: {
+      path: '/',
+      responses: jsonResponse({ schema: z.object({ redis: z.string() }) }),
+    },
+  })
+  async check(context: TRouteContext) {
     const ping = await this.redis.ping();
-    return { redis: ping === 'PONG' ? 'up' : 'down' };
+    return context.json({ redis: ping === 'PONG' ? 'up' : 'down' }, 200);
   }
 }
 ```
@@ -3077,7 +2914,7 @@ try {
 
 ### Redis Connection Pooling
 
-- `RedisHelper` creates a single IoRedis connection by default. For high-throughput, consider multiple `RedisHelper` instances with different roles (read vs write).
+- Each Redis helper instance creates a single IoRedis connection by default. For high-throughput, consider multiple instances with different roles (read vs write).
 - BullMQ calls `.duplicate()` automatically -- it does not share your main connection.
 - The `maxRetriesPerRequest: null` setting prevents blocking on failed requests.
 - Use `autoConnect: false` (lazy connect) when you need to control connection timing.
@@ -3123,8 +2960,8 @@ IGNIS brings together the structured, enterprise development experience of **Loo
 ## Documentation
 
 - [IGNIS Repository](https://github.com/VENIZIA-AI/ignis)
-- [Getting Started](https://github.com/VENIZIA-AI/ignis/blob/main/docs/wiki/content/get-started/index.md)
-- [Helpers Reference](https://github.com/VENIZIA-AI/ignis/blob/main/docs/wiki/content/references/helpers/index.md)
+- [Getting Started](https://github.com/VENIZIA-AI/ignis/blob/main/docs/wiki/content/guides/get-started/5-minute-quickstart.md)
+- [Reference Index](https://github.com/VENIZIA-AI/ignis/blob/main/docs/wiki/content/references/index.md)
 
 ## License
 

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

@@ -92,6 +92,12 @@ export declare class HTTP {
         readonly DELETE: "delete";
         readonly HEAD: "head";
         readonly OPTIONS: "options";
+        readonly QUERY: "query";
+    };
+    /** Standard HTTP protocols (lowercase). */
+    static readonly Protocols: {
+        readonly HTTP: "http";
+        readonly HTTPS: "https";
     };
     /** HTTP status codes grouped by class (1xx–5xx). */
     static readonly ResultCodes: {
@@ -163,6 +169,7 @@ export declare class HTTP {
         };
     };
 }
-export type THttpMethod = ValueOf<typeof HTTP.Methods>;
+export type THttpMethod = ValueOf<typeof HTTP.Methods> | Uppercase<ValueOf<typeof HTTP.Methods>>;
+export type THttpProtocol = ValueOf<typeof HTTP.Protocols> | Uppercase<ValueOf<typeof HTTP.Protocols>>;
 export type THttpResultCode = ValueOf<typeof HTTP.ResultCodes>;
 //# sourceMappingURL=http.d.ts.map

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,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"}
+{"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;;;;;;;;;MASZ;IAEX,2CAA2C;IAC3C,MAAM,CAAC,QAAQ,CAAC,SAAS;;;MAGd;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,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACjG,MAAM,MAAM,aAAa,GACvB,OAAO,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AAC7E,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC"}

package/dist/common/constants/http.js

@@ -107,6 +107,12 @@ class HTTP {
         DELETE: 'delete',
         HEAD: 'head',
         OPTIONS: 'options',
+        QUERY: 'query',
+    }; }
+    /** Standard HTTP protocols (lowercase). */
+    static { this.Protocols = {
+        HTTP: 'http',
+        HTTPS: 'https',
     }; }
     /** HTTP status codes grouped by class (1xx–5xx). */
     static { this.ResultCodes = {

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

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

package/dist/common/index.d.ts

@@ -1,3 +1,4 @@
 export * from './constants';
+export * from './redact';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/common/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./constants"), exports);
+__exportStar(require("./redact"), exports);
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,2CAAyB;AACzB,0CAAwB"}

package/dist/common/redact.d.ts

@@ -0,0 +1,21 @@
+export declare const REDACTED = "[REDACTED]";
+/**
+ * Returns a copy of `value` with every secret-looking key replaced by `[REDACTED]`, so an options
+ * object can be logged without spilling a TLS private key, an SMTP password or a bearer token.
+ *
+ * Redaction is by KEY NAME, not by value shape: a secret is whatever a caller named like one, and
+ * that is the only signal available at this layer. Buffers and typed arrays are summarized rather
+ * than serialized - a `key: Buffer` is still a private key.
+ */
+export declare const redactSecrets: (value: unknown, seen?: WeakSet<object>) => unknown;
+/**
+ * Strips the credentials out of a connection URL: `mqtts://user:hunter2@broker:8883` becomes
+ * `mqtts://user:[REDACTED]@broker:8883`. A broker/database URL is routinely logged at boot, and the
+ * password sits in the authority section where {@link redactSecrets} - which matches on KEY names -
+ * cannot see it.
+ *
+ * A value that does not parse as a URL is returned unchanged: it carries no authority section, so
+ * there is nothing to strip, and blanking it would hide the very thing the log line is about.
+ */
+export declare const redactUrlCredentials: (url: string) => string;
+//# sourceMappingURL=redact.d.ts.map

package/dist/common/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/common/redact.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,sBAA4B,KAAG,OA+B5E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,MAelD,CAAC"}

package/dist/common/redact.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactUrlCredentials = exports.redactSecrets = exports.REDACTED = void 0;
+/**
+ * Keys whose VALUES must never reach a log line, a log aggregator or a crash report. Matched
+ * case-insensitively on the key name, at any depth.
+ */
+const SECRET_KEY_PATTERN = new RegExp([
+    // Options-object spellings (camelCase / snake_case).
+    '^(pass|password|passphrase|secret|token|apiKey|api_key|accessKey|access_key',
+    '|secretKey|secret_key|privateKey|private_key|key|cert|ca|pfx|credentials',
+    '|authorization|auth|jwtSecret|applicationSecret|connectionString)$',
+    // HTTP HEADER spellings. A header set is logged on every outbound request, and its names are
+    // kebab-case and often `x-`-prefixed - none of which the camelCase list above matches.
+    '|^(x-)?(api|auth|access|secret|session|csrf|xsrf)-(key|token|secret|id)$',
+    '|^(cookie|set-cookie|proxy-authorization|www-authenticate)$',
+].join(''), 'i');
+exports.REDACTED = '[REDACTED]';
+/**
+ * Returns a copy of `value` with every secret-looking key replaced by `[REDACTED]`, so an options
+ * object can be logged without spilling a TLS private key, an SMTP password or a bearer token.
+ *
+ * Redaction is by KEY NAME, not by value shape: a secret is whatever a caller named like one, and
+ * that is the only signal available at this layer. Buffers and typed arrays are summarized rather
+ * than serialized - a `key: Buffer` is still a private key.
+ */
+const redactSecrets = (value, seen = new WeakSet()) => {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (seen.has(value)) {
+        return '[Circular]';
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return value.map(entry => (0, exports.redactSecrets)(entry, seen));
+    }
+    if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer) {
+        return `[Binary ${value.byteLength ?? 0} bytes]`;
+    }
+    const source = value;
+    const result = {};
+    for (const key of Object.keys(source)) {
+        if (SECRET_KEY_PATTERN.test(key)) {
+            result[key] = exports.REDACTED;
+            continue;
+        }
+        result[key] = (0, exports.redactSecrets)(source[key], seen);
+    }
+    return result;
+};
+exports.redactSecrets = redactSecrets;
+/**
+ * Strips the credentials out of a connection URL: `mqtts://user:hunter2@broker:8883` becomes
+ * `mqtts://user:[REDACTED]@broker:8883`. A broker/database URL is routinely logged at boot, and the
+ * password sits in the authority section where {@link redactSecrets} - which matches on KEY names -
+ * cannot see it.
+ *
+ * A value that does not parse as a URL is returned unchanged: it carries no authority section, so
+ * there is nothing to strip, and blanking it would hide the very thing the log line is about.
+ */
+const redactUrlCredentials = (url) => {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return url;
+    }
+    if (!parsed.password) {
+        return url;
+    }
+    parsed.password = exports.REDACTED;
+    return decodeURIComponent(parsed.toString());
+};
+exports.redactUrlCredentials = redactUrlCredentials;
+//# sourceMappingURL=redact.js.map

package/dist/common/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/common/redact.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAM,kBAAkB,GAAG,IAAI,MAAM,CACnC;IACE,qDAAqD;IACrD,6EAA6E;IAC7E,0EAA0E;IAC1E,oEAAoE;IAEpE,6FAA6F;IAC7F,uFAAuF;IACvF,0EAA0E;IAC1E,6DAA6D;CAC9D,CAAC,IAAI,CAAC,EAAE,CAAC,EACV,GAAG,CACJ,CAAC;AAEW,QAAA,QAAQ,GAAG,YAAY,CAAC;AAErC;;;;;;;GAOG;AACI,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,OAAO,IAAI,OAAO,EAAU,EAAW,EAAE;IACrF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEhB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAA,qBAAa,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QAC9D,OAAO,WAAY,KAAyB,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAG,KAAkB,CAAC;IAClC,MAAM,MAAM,GAAc,EAAE,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAQ,CAAC;YACvB,SAAS;QACX,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,GAAG,IAAA,qBAAa,EAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AA/BW,QAAA,aAAa,iBA+BxB;AAEF;;;;;;;;GAQG;AACI,MAAM,oBAAoB,GAAG,CAAC,GAAW,EAAU,EAAE;IAC1D,IAAI,MAAW,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,CAAC,QAAQ,GAAG,gBAAQ,CAAC;IAC3B,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC;AAfW,QAAA,oBAAoB,wBAe/B"}

package/dist/common/types.d.ts

@@ -1,3 +1,5 @@
+import { isClass } from '@venizia/ignis-inversion';
+export { isClass };
 export type TNullable<T> = T | undefined | null;
 export type AnyType = any;
 export type AnyObject = Record<string | symbol | number, any>;

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

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

package/dist/common/types.js

@@ -1,13 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveClass = exports.resolveValueAsync = exports.resolveValue = void 0;
+exports.resolveClass = exports.resolveValueAsync = exports.resolveValue = exports.isClass = void 0;
 const ignis_inversion_1 = require("@venizia/ignis-inversion");
+Object.defineProperty(exports, "isClass", { enumerable: true, get: function () { return ignis_inversion_1.isClass; } });
 /** Resolves a value-or-resolver, returning class constructors as-is. */
 const resolveValue = (valueOrResolver) => {
     if (typeof valueOrResolver !== 'function') {
         return valueOrResolver;
     }
-    if ((0, ignis_inversion_1.isClassConstructor)(valueOrResolver)) {
+    if ((0, ignis_inversion_1.isClass)(valueOrResolver)) {
         return valueOrResolver;
     }
     return valueOrResolver();
@@ -18,7 +19,7 @@ const resolveValueAsync = async (valueOrResolver) => {
     if (typeof valueOrResolver !== 'function') {
         return valueOrResolver;
     }
-    if ((0, ignis_inversion_1.isClassConstructor)(valueOrResolver)) {
+    if ((0, ignis_inversion_1.isClass)(valueOrResolver)) {
         return valueOrResolver;
     }
     return valueOrResolver();

package/dist/common/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":";;;AAAA,8DAA8D;AAkC9D,wEAAwE;AACjE,MAAM,YAAY,GAAG,CAAI,eAAoC,EAAK,EAAE;IACzE,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,IAAA,oCAAkB,EAAC,eAA2B,CAAC,EAAE,CAAC;QACpD,OAAO,eAAoB,CAAC;IAC9B,CAAC;IAED,OAAQ,eAAgC,EAAE,CAAC;AAC7C,CAAC,CAAC;AAVW,QAAA,YAAY,gBAUvB;AAEF,qCAAqC;AAC9B,MAAM,iBAAiB,GAAG,KAAK,EACpC,eAAyC,EAC7B,EAAE;IACd,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,IAAA,oCAAkB,EAAC,eAA2B,CAAC,EAAE,CAAC;QACpD,OAAO,eAAoB,CAAC;IAC9B,CAAC;IAED,OAAQ,eAAqC,EAAE,CAAC;AAClD,CAAC,CAAC;AAZW,QAAA,iBAAiB,qBAY5B;AAEF,6EAA6E;AACtE,MAAM,YAAY,GAAG,CAC1B,GAA8C,EAC1B,EAAE;IACtB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,IAAA,oBAAY,EAAC,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC;AARW,QAAA,YAAY,gBAQvB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":";;;AAAA,8DAAmD;AAI1C,wFAJA,yBAAO,OAIA;AAkChB,wEAAwE;AACjE,MAAM,YAAY,GAAG,CAAI,eAAoC,EAAK,EAAE;IACzE,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,IAAA,yBAAO,EAAC,eAAe,CAAC,EAAE,CAAC;QAC7B,OAAO,eAAoB,CAAC;IAC9B,CAAC;IAED,OAAQ,eAAgC,EAAE,CAAC;AAC7C,CAAC,CAAC;AAVW,QAAA,YAAY,gBAUvB;AAEF,qCAAqC;AAC9B,MAAM,iBAAiB,GAAG,KAAK,EACpC,eAAyC,EAC7B,EAAE;IACd,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,IAAA,yBAAO,EAAC,eAAe,CAAC,EAAE,CAAC;QAC7B,OAAO,eAAoB,CAAC;IAC9B,CAAC;IAED,OAAQ,eAAqC,EAAE,CAAC;AAClD,CAAC,CAAC;AAZW,QAAA,iBAAiB,qBAY5B;AAEF,6EAA6E;AACtE,MAAM,YAAY,GAAG,CAC1B,GAA8C,EAC1B,EAAE;IACtB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,IAAA,oBAAY,EAAC,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC;AARW,QAAA,YAAY,gBAQvB"}

package/dist/modules/cron/cron.helper.d.ts

@@ -18,8 +18,16 @@ export declare class CronHelper extends BaseHelper {
     instance: CronJob;
     constructor(opts: ICronHelperOptions);
     static newInstance(opts: ICronHelperOptions): CronHelper;
-    configure(): void;
+    /** Builds the job. Synchronous, so the constructor still THROWS on a bad cronTime. */
+    protected buildInstance(): void;
+    /**
+     * Async because `CronJob.stop()` resolves only once an IN-FLIGHT tick has finished. Fire-and-
+     * forgetting it lets the replacement job start while the old handler is still running - the very
+     * double-fire this stop exists to prevent.
+     */
+    configure(): Promise<void>;
     start(): void;
+    stop(): Promise<void>;
     modifyCronTime(opts: {
         cronTime: string;
         shouldFireOnTick?: boolean;

package/dist/modules/cron/cron.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cron.helper.d.ts","sourceRoot":"","sources":["../../../src/modules/cron/cron.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAY,MAAM,MAAM,CAAC;AAIhE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAChD;AAED,qBAAa,UAAW,SAAQ,UAAU;IACxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,WAAW,CAAC,CAA+B;IACnD,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,EAAE,CAAC,CAAS;IACpB,OAAO,CAAC,YAAY,CAAC,CAAkC;IAEhD,QAAQ,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,kBAAkB;IAcpC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,kBAAkB;IAI3C,SAAS;IAiBT,KAAK;IASL,cAAc,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE;IAUrE,SAAS,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;CAcrC"}
+{"version":3,"file":"cron.helper.d.ts","sourceRoot":"","sources":["../../../src/modules/cron/cron.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAY,MAAM,MAAM,CAAC;AAIhE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAChD;AAED,qBAAa,UAAW,SAAQ,UAAU;IACxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,WAAW,CAAC,CAA+B;IACnD,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,EAAE,CAAC,CAAS;IACpB,OAAO,CAAC,YAAY,CAAC,CAAkC;IAEhD,QAAQ,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,kBAAkB;IAcpC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,kBAAkB;IAI3C,sFAAsF;IACtF,SAAS,CAAC,aAAa,IAAI,IAAI;IAuB/B;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAQhC,KAAK;IASC,IAAI;IASV,cAAc,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE;IAwBrE,SAAS,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;CAcrC"}