@adaas/a-utils 0.0.8 → 0.0.9

package/.nvmrc

@@ -1 +1 @@
-v20.10.0
+v22.20.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { A_CommonHelper } from './src/helpers/A_Common.helper';
+export { A_IdentityHelper } from './src/helpers/A_ID.helper';
 export { A_ScheduleHelper } from './src/helpers/A_Schedule.helper';
 export { A_Error } from './src/global/A_Error.class';
 export { A_ServerError } from './src/global/A_ServerError.class';

package/dist/index.js

@@ -1,10 +1,12 @@
 "use strict";
 // ====================== EXPORTS ======================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.A_CONSTANTS__ERROR_CODES = exports.A_Polyfills = exports.A_ScheduleObject = exports.ASEID = exports.A_ServerError = exports.A_Error = exports.A_ScheduleHelper = exports.A_CommonHelper = void 0;
+exports.A_CONSTANTS__ERROR_CODES = exports.A_Polyfills = exports.A_ScheduleObject = exports.ASEID = exports.A_ServerError = exports.A_Error = exports.A_ScheduleHelper = exports.A_IdentityHelper = exports.A_CommonHelper = void 0;
 // --- Helpers ---
 var A_Common_helper_1 = require("./src/helpers/A_Common.helper");
 Object.defineProperty(exports, "A_CommonHelper", { enumerable: true, get: function () { return A_Common_helper_1.A_CommonHelper; } });
+var A_ID_helper_1 = require("./src/helpers/A_ID.helper");
+Object.defineProperty(exports, "A_IdentityHelper", { enumerable: true, get: function () { return A_ID_helper_1.A_IdentityHelper; } });
 var A_Schedule_helper_1 = require("./src/helpers/A_Schedule.helper");
 Object.defineProperty(exports, "A_ScheduleHelper", { enumerable: true, get: function () { return A_Schedule_helper_1.A_ScheduleHelper; } });
 // --- Global ---

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAEA,wDAAwD;;;AAGxD,kBAAkB;AAClB,iEAA+D;AAAtD,iHAAA,cAAc,OAAA;AACvB,qEAAmE;AAA1D,qHAAA,gBAAgB,OAAA;AAGzB,iBAAiB;AACjB,4DAAqD;AAA5C,wGAAA,OAAO,OAAA;AAChB,wEAAiE;AAAxD,oHAAA,aAAa,OAAA;AAEtB,wDAAiD;AAAxC,oGAAA,KAAK,OAAA;AAEd,8EAAuE;AAA9D,0HAAA,gBAAgB,OAAA;AAIzB,wDAEiC;AAD7B,0GAAA,WAAW,OAAA;AAGf,oBAAoB;AACpB,qEAA4E;AAAnE,4HAAA,wBAAwB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAEA,wDAAwD;;;AAGxD,kBAAkB;AAClB,iEAA+D;AAAtD,iHAAA,cAAc,OAAA;AACvB,yDAA6D;AAApD,+GAAA,gBAAgB,OAAA;AACzB,qEAAmE;AAA1D,qHAAA,gBAAgB,OAAA;AAGzB,iBAAiB;AACjB,4DAAqD;AAA5C,wGAAA,OAAO,OAAA;AAChB,wEAAiE;AAAxD,oHAAA,aAAa,OAAA;AAEtB,wDAAiD;AAAxC,oGAAA,KAAK,OAAA;AAEd,8EAAuE;AAA9D,0HAAA,gBAAgB,OAAA;AAIzB,wDAEiC;AAD7B,0GAAA,WAAW,OAAA;AAGf,oBAAoB;AACpB,qEAA4E;AAAnE,4HAAA,wBAAwB,OAAA"}

package/dist/src/helpers/A_ID.helper.d.ts

@@ -0,0 +1,17 @@
+export type A_ID_TYPES__TimeId_Parts = {
+    timestamp: Date;
+    random: string;
+};
+export declare class A_IdentityHelper {
+    /**
+   * Generates a short, time-based unique ID.
+   * Encodes current time (ms since epoch) and random bits in base36.
+   * Example: "mb4f1g-7f9a1c"
+   */
+    static generateTimeId(parts?: A_ID_TYPES__TimeId_Parts): string;
+    /**
+     * Parses a short ID back into its parts.
+     * Returns an object with the original timestamp (as Date) and random string.
+     */
+    static parseTimeId(id: string): A_ID_TYPES__TimeId_Parts;
+}

package/dist/src/helpers/A_ID.helper.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_IdentityHelper = void 0;
+class A_IdentityHelper {
+    /**
+   * Generates a short, time-based unique ID.
+   * Encodes current time (ms since epoch) and random bits in base36.
+   * Example: "mb4f1g-7f9a1c"
+   */
+    static generateTimeId(parts = { timestamp: new Date(), random: Math.random().toString(36).slice(2, 8) }) {
+        const time = parts.timestamp.getTime().toString(36); // base36-encoded timestamp
+        const random = parts.random; // use provided random string
+        return `${time}-${random}`;
+    }
+    /**
+     * Parses a short ID back into its parts.
+     * Returns an object with the original timestamp (as Date) and random string.
+     */
+    static parseTimeId(id) {
+        const [timePart, randomPart] = id.split('-');
+        const timestamp = new Date(parseInt(timePart, 36));
+        return { timestamp, random: randomPart };
+    }
+}
+exports.A_IdentityHelper = A_IdentityHelper;
+//# sourceMappingURL=A_ID.helper.js.map

package/dist/src/helpers/A_ID.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A_ID.helper.js","sourceRoot":"","sources":["../../../src/helpers/A_ID.helper.ts"],"names":[],"mappings":";;;AAOA,MAAa,gBAAgB;IACzB;;;;KAIC;IACD,MAAM,CAAC,cAAc,CACjB,QAAkC,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAE3G,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B;QAChF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,6BAA6B;QAC1D,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,EAAU;QACzB,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QACnD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC7C,CAAC;CAEJ;AAxBD,4CAwBC"}

package/index.ts

@@ -5,6 +5,7 @@
 
 // --- Helpers ---
 export { A_CommonHelper } from './src/helpers/A_Common.helper';
+export { A_IdentityHelper } from './src/helpers/A_ID.helper';
 export { A_ScheduleHelper } from './src/helpers/A_Schedule.helper';
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-utils",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "A-Utils is a set of utilities that are used across the ADAAS ecosystem. This package is designed to be a collection of utilities that are used across the ADAAS ecosystem.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/helpers/A_ID.helper.ts

@@ -0,0 +1,32 @@
+
+export type A_ID_TYPES__TimeId_Parts = {
+    timestamp: Date;
+    random: string;
+}
+
+
+export class A_IdentityHelper {
+    /**
+   * Generates a short, time-based unique ID.
+   * Encodes current time (ms since epoch) and random bits in base36.
+   * Example: "mb4f1g-7f9a1c"
+   */
+    static generateTimeId(
+        parts: A_ID_TYPES__TimeId_Parts = { timestamp: new Date(), random: Math.random().toString(36).slice(2, 8) }
+    ): string {
+        const time = parts.timestamp.getTime().toString(36); // base36-encoded timestamp
+        const random = parts.random; // use provided random string
+        return `${time}-${random}`;
+    }
+
+    /**
+     * Parses a short ID back into its parts.
+     * Returns an object with the original timestamp (as Date) and random string.
+     */
+    static parseTimeId(id: string): A_ID_TYPES__TimeId_Parts {
+        const [timePart, randomPart] = id.split('-');
+        const timestamp = new Date(parseInt(timePart, 36));
+        return { timestamp, random: randomPart };
+    }
+
+}

package/tests/default.test.ts

@@ -1,4 +1,5 @@
 import { A_CommonHelper } from '@adaas/a-utils/helpers/A_Common.helper';
+import { A_IdentityHelper } from '@adaas/a-utils/helpers/A_ID.helper';
 import { A_ScheduleHelper } from '@adaas/a-utils/helpers/A_Schedule.helper';
 import { A_TYPES__DeepPartial } from '@adaas/a-utils/types/A_Common.types';
 import { config } from 'dotenv';
@@ -147,8 +148,6 @@ describe('CommonHelper Tests', () => {
 
         const merged = A_CommonHelper.deepCloneAndMerge(t2, t);
 
-        console.log('merged: ', merged)
-
         expect(merged.a).toBe('a');
         expect(merged.b).toBe('bb');
         expect(merged.c.d).toBe('ddd');
@@ -157,4 +156,18 @@ describe('CommonHelper Tests', () => {
         expect((merged as any).some.d).toBe('dd');
         expect(merged.f('names')).toBe('names');
     });
+    it('should generate and then parse Unique time based IDs', async () => {
+        const id = A_IdentityHelper.generateTimeId();
+        const parts = A_IdentityHelper.parseTimeId(id);
+
+        expect(id).toBeDefined();
+        expect(parts.timestamp).toBeInstanceOf(Date);
+        expect(parts.random).toHaveLength(6);
+
+        // Check that the timestamp is recent (within the last minute)
+        const now = Date.now();
+        const timestamp = parts.timestamp.getTime();
+        expect(timestamp).toBeLessThanOrEqual(now);
+        expect(timestamp).toBeGreaterThan(now - 60000); // within the last minute
+    });
 });