@venizia/ignis-helpers 0.0.4-0 → 0.0.4-1

package/dist/helpers/index.d.ts

@@ -10,5 +10,6 @@ export * from './redis';
 export * from './socket-io';
 export * from './storage';
 export * from './testing';
+export * from './uid';
 export * from './worker-thread';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AAEvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AAEvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,iBAAiB,CAAC"}

package/dist/helpers/index.js

@@ -26,5 +26,6 @@ __exportStar(require("./redis"), exports);
 __exportStar(require("./socket-io"), exports);
 __exportStar(require("./storage"), exports);
 __exportStar(require("./testing"), exports);
+__exportStar(require("./uid"), exports);
 __exportStar(require("./worker-thread"), exports);
 //# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AAEvB,yCAAuB;AACvB,2CAAyB;AACzB,wCAAsB;AACtB,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,8CAA4B;AAC5B,4CAA0B;AAC1B,4CAA0B;AAC1B,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AAEvB,yCAAuB;AACvB,2CAAyB;AACzB,wCAAsB;AACtB,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,8CAA4B;AAC5B,4CAA0B;AAC1B,4CAA0B;AAC1B,wCAAsB;AACtB,kDAAgC"}

package/dist/helpers/uid/helper.d.ts

@@ -0,0 +1,117 @@
+import { BaseHelper } from '../base';
+/**
+ * Snowflake ID Configuration Constants (48-10-12)
+ * - 48 bits: timestamp (~8,919 years from epoch)
+ * - 10 bits: worker ID (1024 workers max)
+ * - 12 bits: sequence (4096 per ms per worker)
+ */
+export declare class SnowflakeConfig {
+    static readonly DEFAULT_EPOCH: bigint;
+    static readonly TIMESTAMP_BITS: bigint;
+    static readonly WORKER_ID_BITS: bigint;
+    static readonly SEQUENCE_BITS: bigint;
+    static readonly MAX_WORKER_ID: bigint;
+    static readonly MAX_SEQUENCE: bigint;
+    static readonly WORKER_ID_SHIFT: bigint;
+    static readonly TIMESTAMP_SHIFT: bigint;
+    static readonly MAX_CLOCK_BACKWARD_MS: bigint;
+    static readonly MAX_TIMESTAMP_MS: bigint;
+    static readonly WARNING_THRESHOLD_MS: bigint;
+}
+export interface IIdGeneratorOptions {
+    workerId?: number;
+    epoch?: bigint;
+}
+export interface ISnowflakeParsedId {
+    raw: bigint;
+    timestamp: Date;
+    workerId: number;
+    sequence: number;
+}
+/**
+ * Snowflake ID Generator with Base62 Encoding
+ *
+ * Generates unique, time-sortable IDs suitable for distributed systems.
+ * Output is Base62 encoded to fit within 15 characters limit.
+ *
+ * @example
+ * ```typescript
+ * // Initialize with defaults (workerId: 199, epoch: 2025-01-01 00:00:00 UTC)
+ * const generator = new SnowflakeUidHelper();
+ *
+ * // Or with custom values
+ * const customGenerator = new SnowflakeUidHelper({
+ *   workerId: 123,
+ *   epoch: BigInt(1735689600000),
+ * });
+ *
+ * // Generate transaction number
+ * const txnNumber = generator.nextId(); // e.g., "9du1sJXO88"
+ *
+ * // Generate raw snowflake (bigint)
+ * const snowflakeId = generator.nextSnowflake(); // e.g., 130546360012247045n
+ * ```
+ *
+ * @description
+ * Snowflake ID Structure (70 bits):
+ * - 48 bits: timestamp in ms since epoch (2025-01-01) - ~8,919 years
+ * - 10 bits: worker ID - 1024 unique workers
+ * - 12 bits: sequence number - 4096 IDs per ms per worker
+ *
+ * Base62 Output: 10-12 chars (max 12 chars, within 15-char limit)
+ * Throughput: 4,096,000 IDs/second/worker
+ * Max workers: 1024
+ * Lifespan: Until ~10,944 AD
+ */
+export declare class SnowflakeUidHelper extends BaseHelper {
+    private readonly workerId;
+    private readonly epoch;
+    private sequence;
+    private lastTimestamp;
+    constructor(opts?: IIdGeneratorOptions);
+    /**
+     * Generate next unique ID as Base62 string
+     * @returns Base62 encoded ID (max 12 chars, fits 15 char limit)
+     */
+    nextId(): string;
+    /**
+     * Generate next unique ID as raw Snowflake bigint
+     * @returns 70-bit Snowflake ID
+     */
+    nextSnowflake(): bigint;
+    /**
+     * Encode a bigint to Base62 string
+     */
+    encodeBase62(num: bigint): string;
+    /**
+     * Decode a Base62 string to bigint
+     */
+    decodeBase62(str: string): bigint;
+    /**
+     * Extract timestamp from a Snowflake ID
+     * @returns Date when the ID was generated
+     */
+    extractTimestamp(id: bigint): Date;
+    /**
+     * Extract worker ID from a Snowflake ID
+     */
+    extractWorkerId(id: bigint): number;
+    /**
+     * Extract sequence from a Snowflake ID
+     */
+    extractSequence(id: bigint): number;
+    /**
+     * Parse a Base62 ID and extract its components
+     */
+    parseId(base62Id: string): ISnowflakeParsedId;
+    /**
+     * Get current worker ID
+     */
+    getWorkerId(): number;
+    private currentTimestamp;
+    private waitForNextMs;
+    private validateWorkerId;
+    private validateEpoch;
+    private checkExpiryWarning;
+}
+//# sourceMappingURL=helper.d.ts.map

package/dist/helpers/uid/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../src/helpers/uid/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKrC;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,MAAM,CAAC,QAAQ,CAAC,aAAa,SAAyB;IACtD,MAAM,CAAC,QAAQ,CAAC,cAAc,SAAc;IAC5C,MAAM,CAAC,QAAQ,CAAC,cAAc,SAAc;IAC5C,MAAM,CAAC,QAAQ,CAAC,aAAa,SAAc;IAC3C,MAAM,CAAC,QAAQ,CAAC,aAAa,SAAyC;IACtE,MAAM,CAAC,QAAQ,CAAC,YAAY,SAAyC;IACrE,MAAM,CAAC,QAAQ,CAAC,eAAe,SAAc;IAC7C,MAAM,CAAC,QAAQ,CAAC,eAAe,SAAc;IAC7C,MAAM,CAAC,QAAQ,CAAC,qBAAqB,SAAe;IAGpD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,SAAyC;IACzE,MAAM,CAAC,QAAQ,CAAC,oBAAoB,SAA2D;CAChG;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,aAAa,CAAsB;gBAE/B,IAAI,CAAC,EAAE,mBAAmB;IAoBtC;;;OAGG;IACH,MAAM,IAAI,MAAM;IAKhB;;;OAGG;IACH,aAAa,IAAI,MAAM;IA8CvB;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAkBjC;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAkBjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAMnC;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB;IAU7C;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,kBAAkB;CAiB3B"}

package/dist/helpers/uid/helper.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnowflakeUidHelper = exports.SnowflakeConfig = void 0;
+const constants_1 = require("../../common/constants");
+const base_1 = require("../base");
+const app_error_1 = require("../error/app-error");
+const BASE62_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+/**
+ * Snowflake ID Configuration Constants (48-10-12)
+ * - 48 bits: timestamp (~8,919 years from epoch)
+ * - 10 bits: worker ID (1024 workers max)
+ * - 12 bits: sequence (4096 per ms per worker)
+ */
+class SnowflakeConfig {
+    static { this.DEFAULT_EPOCH = BigInt(1735689600000); } // 2025-01-01 00:00:00 UTC
+    static { this.TIMESTAMP_BITS = BigInt(48); }
+    static { this.WORKER_ID_BITS = BigInt(10); }
+    static { this.SEQUENCE_BITS = BigInt(12); }
+    static { this.MAX_WORKER_ID = (BigInt(1) << BigInt(10)) - BigInt(1); } // 1023
+    static { this.MAX_SEQUENCE = (BigInt(1) << BigInt(12)) - BigInt(1); } // 4095
+    static { this.WORKER_ID_SHIFT = BigInt(12); }
+    static { this.TIMESTAMP_SHIFT = BigInt(22); } // 10 + 12
+    static { this.MAX_CLOCK_BACKWARD_MS = BigInt(100); }
+    // 48 bits max = ~8,919 years, warn 10 years before expiry (~8,909 years)
+    static { this.MAX_TIMESTAMP_MS = (BigInt(1) << BigInt(48)) - BigInt(1); }
+    static { this.WARNING_THRESHOLD_MS = BigInt(Math.floor(8909 * 365.25 * 24 * 60 * 60 * 1000)); } // ~8,909 years
+}
+exports.SnowflakeConfig = SnowflakeConfig;
+/**
+ * Snowflake ID Generator with Base62 Encoding
+ *
+ * Generates unique, time-sortable IDs suitable for distributed systems.
+ * Output is Base62 encoded to fit within 15 characters limit.
+ *
+ * @example
+ * ```typescript
+ * // Initialize with defaults (workerId: 199, epoch: 2025-01-01 00:00:00 UTC)
+ * const generator = new SnowflakeUidHelper();
+ *
+ * // Or with custom values
+ * const customGenerator = new SnowflakeUidHelper({
+ *   workerId: 123,
+ *   epoch: BigInt(1735689600000),
+ * });
+ *
+ * // Generate transaction number
+ * const txnNumber = generator.nextId(); // e.g., "9du1sJXO88"
+ *
+ * // Generate raw snowflake (bigint)
+ * const snowflakeId = generator.nextSnowflake(); // e.g., 130546360012247045n
+ * ```
+ *
+ * @description
+ * Snowflake ID Structure (70 bits):
+ * - 48 bits: timestamp in ms since epoch (2025-01-01) - ~8,919 years
+ * - 10 bits: worker ID - 1024 unique workers
+ * - 12 bits: sequence number - 4096 IDs per ms per worker
+ *
+ * Base62 Output: 10-12 chars (max 12 chars, within 15-char limit)
+ * Throughput: 4,096,000 IDs/second/worker
+ * Max workers: 1024
+ * Lifespan: Until ~10,944 AD
+ */
+class SnowflakeUidHelper extends base_1.BaseHelper {
+    constructor(opts) {
+        super({ scope: SnowflakeUidHelper.name });
+        this.sequence = BigInt(0);
+        this.lastTimestamp = BigInt(-1);
+        const workerId = opts?.workerId ?? 199;
+        const epoch = opts?.epoch ?? SnowflakeConfig.DEFAULT_EPOCH;
+        this.validateWorkerId(workerId);
+        this.workerId = BigInt(workerId);
+        this.validateEpoch(epoch);
+        this.epoch = epoch;
+        this.logger.info('[constructor] Initialized | workerId: %d | epoch: %s | epochDate: %s', workerId, epoch.toString(), new Date(Number(epoch)).toISOString());
+    }
+    /**
+     * Generate next unique ID as Base62 string
+     * @returns Base62 encoded ID (max 12 chars, fits 15 char limit)
+     */
+    nextId() {
+        const snowflake = this.nextSnowflake();
+        return this.encodeBase62(snowflake);
+    }
+    /**
+     * Generate next unique ID as raw Snowflake bigint
+     * @returns 70-bit Snowflake ID
+     */
+    nextSnowflake() {
+        let timestamp = this.currentTimestamp();
+        // Handle clock going backward
+        if (timestamp < this.lastTimestamp) {
+            const diff = this.lastTimestamp - timestamp;
+            this.logger.warn('[nextSnowflake] Clock moved backward | diff: %d ms', Number(diff));
+            // Wait for clock to catch up (max 100ms)
+            if (diff <= SnowflakeConfig.MAX_CLOCK_BACKWARD_MS) {
+                timestamp = this.waitForNextMs(this.lastTimestamp);
+            }
+            else {
+                throw (0, app_error_1.getError)({
+                    statusCode: constants_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                    message: `[IdGenerator][nextSnowflake] Clock moved backward by ${diff}ms. Refusing to generate ID.`,
+                });
+            }
+        }
+        // Same millisecond - increment sequence
+        if (timestamp === this.lastTimestamp) {
+            this.sequence = (this.sequence + BigInt(1)) & SnowflakeConfig.MAX_SEQUENCE;
+            // Sequence exhausted for this millisecond
+            if (this.sequence === BigInt(0)) {
+                timestamp = this.waitForNextMs(timestamp);
+            }
+        }
+        else {
+            // New millisecond - reset sequence
+            this.sequence = BigInt(0);
+        }
+        this.lastTimestamp = timestamp;
+        // Check for approaching sequence expiry (10 years before end)
+        this.checkExpiryWarning(timestamp);
+        // Compose the 70-bit ID
+        const id = ((timestamp - this.epoch) << SnowflakeConfig.TIMESTAMP_SHIFT) |
+            (this.workerId << SnowflakeConfig.WORKER_ID_SHIFT) |
+            this.sequence;
+        return id;
+    }
+    /**
+     * Encode a bigint to Base62 string
+     */
+    encodeBase62(num) {
+        if (num === BigInt(0)) {
+            return BASE62_CHARS[0];
+        }
+        let result = '';
+        let value = num;
+        const base = BigInt(BASE62_CHARS.length);
+        while (value > BigInt(0)) {
+            const remainder = value % base;
+            result = BASE62_CHARS[Number(remainder)] + result;
+            value = value / base;
+        }
+        return result;
+    }
+    /**
+     * Decode a Base62 string to bigint
+     */
+    decodeBase62(str) {
+        let result = BigInt(0);
+        const base = BigInt(BASE62_CHARS.length);
+        for (const char of str) {
+            const index = BASE62_CHARS.indexOf(char);
+            if (index === -1) {
+                throw (0, app_error_1.getError)({
+                    statusCode: constants_1.HTTP.ResultCodes.RS_4.BadRequest,
+                    message: `[IdGenerator][decodeBase62] Invalid Base62 character: ${char}`,
+                });
+            }
+            result = result * base + BigInt(index);
+        }
+        return result;
+    }
+    /**
+     * Extract timestamp from a Snowflake ID
+     * @returns Date when the ID was generated
+     */
+    extractTimestamp(id) {
+        const timestamp = (id >> SnowflakeConfig.TIMESTAMP_SHIFT) + this.epoch;
+        return new Date(Number(timestamp));
+    }
+    /**
+     * Extract worker ID from a Snowflake ID
+     */
+    extractWorkerId(id) {
+        const extractedWorkerId = (id >> SnowflakeConfig.WORKER_ID_SHIFT) & SnowflakeConfig.MAX_WORKER_ID;
+        return Number(extractedWorkerId);
+    }
+    /**
+     * Extract sequence from a Snowflake ID
+     */
+    extractSequence(id) {
+        return Number(id & SnowflakeConfig.MAX_SEQUENCE);
+    }
+    /**
+     * Parse a Base62 ID and extract its components
+     */
+    parseId(base62Id) {
+        const raw = this.decodeBase62(base62Id);
+        return {
+            raw,
+            timestamp: this.extractTimestamp(raw),
+            workerId: this.extractWorkerId(raw),
+            sequence: this.extractSequence(raw),
+        };
+    }
+    /**
+     * Get current worker ID
+     */
+    getWorkerId() {
+        return Number(this.workerId);
+    }
+    currentTimestamp() {
+        return BigInt(Date.now());
+    }
+    waitForNextMs(lastTimestamp) {
+        let timestamp = this.currentTimestamp();
+        while (timestamp <= lastTimestamp) {
+            timestamp = this.currentTimestamp();
+        }
+        return timestamp;
+    }
+    validateWorkerId(workerId) {
+        if (workerId < 0 || workerId > Number(SnowflakeConfig.MAX_WORKER_ID)) {
+            throw (0, app_error_1.getError)({
+                statusCode: constants_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: `[IdGenerator][validateWorkerId] Worker ID must be between 0 and ${SnowflakeConfig.MAX_WORKER_ID} | received: ${workerId}`,
+            });
+        }
+    }
+    validateEpoch(epoch) {
+        const now = BigInt(Date.now());
+        if (epoch <= BigInt(0)) {
+            throw (0, app_error_1.getError)({
+                statusCode: constants_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: `[IdGenerator][validateEpoch] Epoch must be a positive number | received: ${epoch}`,
+            });
+        }
+        if (epoch > now) {
+            throw (0, app_error_1.getError)({
+                statusCode: constants_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: `[IdGenerator][validateEpoch] Epoch cannot be in the future | received: ${epoch} (${new Date(Number(epoch)).toISOString()}) | now: ${now}`,
+            });
+        }
+    }
+    checkExpiryWarning(timestamp) {
+        const elapsedMs = timestamp - this.epoch;
+        if (elapsedMs < SnowflakeConfig.WARNING_THRESHOLD_MS) {
+            return;
+        }
+        const remainingMs = SnowflakeConfig.MAX_TIMESTAMP_MS - elapsedMs;
+        const remainingYears = Number(remainingMs) / (365.25 * 24 * 60 * 60 * 1000);
+        const expiryDate = new Date(Number(this.epoch + SnowflakeConfig.MAX_TIMESTAMP_MS));
+        this.logger.warn('[checkExpiryWarning] Snowflake ID sequence approaching expiry | remainingYears: %.2f | expiryDate: %s | action: Plan migration to new epoch', remainingYears, expiryDate.toISOString());
+    }
+}
+exports.SnowflakeUidHelper = SnowflakeUidHelper;
+//# sourceMappingURL=helper.js.map

package/dist/helpers/uid/helper.js.map

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

package/dist/helpers/uid/index.d.ts

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

package/dist/helpers/uid/index.d.ts.map

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

package/dist/helpers/uid/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./helper"), exports);
+//# sourceMappingURL=index.js.map

package/dist/helpers/uid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/uid/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-helpers",
-  "version": "0.0.4-0",
+  "version": "0.0.4-1",
   "description": "Utility helpers for the Ignis Framework - logging, cron, Redis, queues, storage, and more",
   "keywords": [
     "ignis",