@react-pakistan/util-functions 1.25.22 → 1.25.24

package/general/crypto.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Encrypt a string using a password. Returns a base64 payload containing
+ * salt + iv + authTag + ciphertext.
+ */
+export declare function encryptString(plain: string, password: string): string;
+/**
+ * Decrypt a base64 payload produced by `encryptString` using the same password.
+ */
+export declare function decryptString(payload: string, password: string): string;

package/general/crypto.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encryptString = encryptString;
+exports.decryptString = decryptString;
+var crypto_1 = require("crypto");
+var ALGORITHM = 'aes-256-gcm';
+var SALT_LENGTH = 16;
+var IV_LENGTH = 12;
+var TAG_LENGTH = 16;
+var KEY_LENGTH = 32;
+/**
+ * Encrypt a string using a password. Returns a base64 payload containing
+ * salt + iv + authTag + ciphertext.
+ */
+function encryptString(plain, password) {
+    var salt = (0, crypto_1.randomBytes)(SALT_LENGTH);
+    var iv = (0, crypto_1.randomBytes)(IV_LENGTH);
+    var key = (0, crypto_1.scryptSync)(password, salt, KEY_LENGTH);
+    var cipher = (0, crypto_1.createCipheriv)(ALGORITHM, key, iv);
+    var ciphertext = Buffer.concat([
+        cipher.update(plain, 'utf8'),
+        cipher.final(),
+    ]);
+    var tag = cipher.getAuthTag();
+    var out = Buffer.concat([salt, iv, tag, ciphertext]);
+    return out.toString('base64');
+}
+/**
+ * Decrypt a base64 payload produced by `encryptString` using the same password.
+ */
+function decryptString(payload, password) {
+    var data = Buffer.from(payload, 'base64');
+    var salt = data.slice(0, SALT_LENGTH);
+    var iv = data.slice(SALT_LENGTH, SALT_LENGTH + IV_LENGTH);
+    var tag = data.slice(SALT_LENGTH + IV_LENGTH, SALT_LENGTH + IV_LENGTH + TAG_LENGTH);
+    var ciphertext = data.slice(SALT_LENGTH + IV_LENGTH + TAG_LENGTH);
+    var key = (0, crypto_1.scryptSync)(password, salt, KEY_LENGTH);
+    var decipher = (0, crypto_1.createDecipheriv)(ALGORITHM, key, iv);
+    decipher.setAuthTag(tag);
+    var decrypted = Buffer.concat([
+        decipher.update(ciphertext),
+        decipher.final(),
+    ]);
+    return decrypted.toString('utf8');
+}

package/general/index.d.ts

@@ -72,6 +72,7 @@ export * from './get-number-of-days-in-month';
 export * from './get-pathname';
 export * from './get-week-day';
 export * from './image-url-to-base64';
+export * from './is-created-or-updated';
 export * from './is-next-button-disabled';
 export * from './is-odd';
 export * from './is-previous-button-disabled';
@@ -89,6 +90,7 @@ export * from './text-to-enum';
 export * from './time-out';
 export * from './truncate-text';
 export * from './type';
+export * from './crypto';
 export * from './upload-blob-to-private-supabase';
 export * from './upload-blob-to-public-supabase';
 export * from './upload-image-to-private-supabase';

package/general/index.js

@@ -88,6 +88,7 @@ __exportStar(require("./get-number-of-days-in-month"), exports);
 __exportStar(require("./get-pathname"), exports);
 __exportStar(require("./get-week-day"), exports);
 __exportStar(require("./image-url-to-base64"), exports);
+__exportStar(require("./is-created-or-updated"), exports);
 __exportStar(require("./is-next-button-disabled"), exports);
 __exportStar(require("./is-odd"), exports);
 __exportStar(require("./is-previous-button-disabled"), exports);
@@ -105,6 +106,7 @@ __exportStar(require("./text-to-enum"), exports);
 __exportStar(require("./time-out"), exports);
 __exportStar(require("./truncate-text"), exports);
 __exportStar(require("./type"), exports);
+__exportStar(require("./crypto"), exports);
 __exportStar(require("./upload-blob-to-private-supabase"), exports);
 __exportStar(require("./upload-blob-to-public-supabase"), exports);
 __exportStar(require("./upload-image-to-private-supabase"), exports);

package/general/is-created-or-updated.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Utility to determine whether a returned entity was just created
+ * by comparing createdAt and updatedAt timestamps.
+ *
+ * Returns `true` if createdAt and updatedAt are present and equal (created),
+ * otherwise returns `false` (updated or timestamps missing).
+ */
+export declare function isCreatedOrUpdated(entity: {
+    createdAt?: string | Date | null;
+    updatedAt?: string | Date | null;
+}): boolean;

package/general/is-created-or-updated.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCreatedOrUpdated = isCreatedOrUpdated;
+/**
+ * Utility to determine whether a returned entity was just created
+ * by comparing createdAt and updatedAt timestamps.
+ *
+ * Returns `true` if createdAt and updatedAt are present and equal (created),
+ * otherwise returns `false` (updated or timestamps missing).
+ */
+function isCreatedOrUpdated(entity) {
+    if (!entity)
+        return false;
+    var toDate = function (v) {
+        if (v === undefined || v === null)
+            return undefined;
+        if (typeof v === 'string')
+            return new Date(v);
+        return v instanceof Date ? v : new Date(String(v));
+    };
+    var created = toDate(entity.createdAt);
+    var updated = toDate(entity.updatedAt);
+    if (!created || !updated)
+        return false;
+    return created.getTime() === updated.getTime();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-pakistan/util-functions",
-  "version": "1.25.22",
+  "version": "1.25.24",
   "description": "A library of all util functions",
   "main": "index.js",
   "scripts": {