@mysetup/helpers 2.0.1 → 2.0.3

package/README.md

@@ -0,0 +1,46 @@
+# @mysetup/helpers
+
+Shared utility helpers for browser and server applications.
+
+## Installation
+
+```bash
+pnpm add @mysetup/helpers
+```
+
+## Supported libraries and runtimes
+
+| Supported         | Notes                                                         |
+| ----------------- | ------------------------------------------------------------- |
+| Vite              | Root exports are supported                                    |
+| Next.js           | Root exports are supported; crypto helpers are server-only    |
+| Node.js           | Full support including `@mysetup/helpers/crypto`              |
+| Browser-only APIs | `getTextWidth` and `setCookie` should only run in the browser |
+
+## Browser and universal usage
+
+```ts
+import {
+    formatPhoneNumber,
+    generateCacheKey,
+    getDateTimeDiff,
+} from "@mysetup/helpers";
+
+const formatted = formatPhoneNumber("9876543210");
+const cacheKey = generateCacheKey("brand", "production", "users");
+const diff = getDateTimeDiff("2025-01-01T00:00:00Z");
+```
+
+## Node.js only usage
+
+```ts
+import { decodeData, encodeData } from "@mysetup/helpers/crypto";
+
+const encrypted = encodeData("hello", process.env.DATA_KEY || "");
+const decrypted = decodeData(encrypted, process.env.DATA_KEY || "");
+```
+
+## Notes
+
+- `getTextWidth` and `setCookie` should only be called in the browser.
+- `encodeData` and `decodeData` should only be used in Node.js or other runtimes that expose the Node `crypto` module.

package/dist/index.d.ts

@@ -1,2 +1 @@
 export * from "./src";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/arrayMethods/arrayMethods.d.ts

@@ -6,4 +6,3 @@
  * @returns lonest string in array
  */
 export declare function longestStrInArray<T extends object>(array: T[], key: keyof T): string;
-//# sourceMappingURL=arrayMethods.d.ts.map

package/dist/src/arrayMethods/index.d.ts

@@ -1,2 +1 @@
 export * from "./arrayMethods";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/formatPhoneNumber/formatPhoneNumber.d.ts

@@ -1,3 +1,2 @@
 export declare function formatPhoneNumber(phoneNumber: string): string | null;
 export declare const phoneNumberAutoFormat: (phoneNumber: string) => string;
-//# sourceMappingURL=formatPhoneNumber.d.ts.map

package/dist/src/formatPhoneNumber/index.d.ts

@@ -1,2 +1 @@
 export * from "./formatPhoneNumber";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generate-cache-key/generate-cache-key.d.ts

@@ -1,2 +1 @@
 export declare const generateCacheKey: (brand: string, environment: string, key: string) => string;
-//# sourceMappingURL=generate-cache-key.d.ts.map

package/dist/src/generate-cache-key/index.d.ts

@@ -1,2 +1 @@
 export * from "./generate-cache-key";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/getCrypto/getCrypto.d.ts

@@ -1,3 +1,2 @@
 export declare const encodeData: (data: string, dataKey: string) => string;
 export declare const decodeData: (encryptedData: string, dataKey: string) => string;
-//# sourceMappingURL=getCrypto.d.ts.map

package/dist/src/getCrypto/index.d.ts

@@ -1,2 +1 @@
 export * from "./getCrypto";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/getDateTimeDiff/getDateTimeDiff.d.ts

@@ -8,4 +8,3 @@ export declare const getDateTimeDiff: (fromDate: string, toDate?: string) => {
     minutes: () => number;
     asMilliseconds: () => number;
 };
-//# sourceMappingURL=getDateTimeDiff.d.ts.map

package/dist/src/getDateTimeDiff/index.d.ts

@@ -1,2 +1 @@
 export * from "./getDateTimeDiff";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/getTextWidth/getTextWidth.d.ts

@@ -5,4 +5,3 @@
  * @returns width in px of the given text
  */
 export declare const getTextWidth: (text: string, font?: string) => number | undefined;
-//# sourceMappingURL=getTextWidth.d.ts.map

package/dist/src/getTextWidth/index.d.ts

@@ -1,2 +1 @@
 export * from "./getTextWidth";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts

@@ -1,8 +1,6 @@
 export * from "./arrayMethods";
 export * from "./formatPhoneNumber";
 export * from "./generate-cache-key";
-export * from "./getCrypto";
 export * from "./getDateTimeDiff";
 export * from "./getTextWidth";
 export * from "./setCookie";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/index.js

@@ -1,7 +1,6 @@
 export * from "./arrayMethods";
 export * from "./formatPhoneNumber";
 export * from "./generate-cache-key";
-export * from "./getCrypto";
 export * from "./getDateTimeDiff";
 export * from "./getTextWidth";
 export * from "./setCookie";

package/dist/src/setCookie/index.d.ts

@@ -1,2 +1 @@
 export * from "./setCookie";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/setCookie/setCookie.d.ts

@@ -1,2 +1 @@
 export declare const setCookie: (cname: string, cvalue: string, exdays: number) => void;
-//# sourceMappingURL=setCookie.d.ts.map

package/package.json

@@ -1,53 +1,71 @@
 {
-    "name": "@mysetup/helpers",
-    "version": "2.0.1",
-    "license": "MIT",
-    "main": "dist/index.js",
-    "files": [
-        "dist"
-    ],
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js",
-            "require": "./dist/index.js"
-        },
-        "./package.json": "./package.json"
+  "name": "@mysetup/helpers",
+  "version": "2.0.3",
+  "description": "Shared utility helpers for browser and server applications.",
+  "author": "krishnaraj <krishnaraj.webdev@gmail.com>",
+  "license": "MIT",
+  "keywords": [
+    "helpers",
+    "utilities",
+    "typescript",
+    "react",
+    "nodejs"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
     },
-    "scripts": {
-        "build": "rm -rf ./dist && tsc -p tsconfig.build.json",
-        "lint": "eslint .",
-        "test": "jest",
-        "test:update": "pnpm test -- -u",
-        "test:coverage": "jest --coverage",
-        "typecheck": "tsc --noEmit",
-        "format": "prettier --write \"**/*.{ts,tsx,md,js,mjs,json}\"",
-        "checks": "pnpm typecheck && pnpm lint && pnpm test",
-        "clean": "rm -rf node_modules .swc dist pnpm-lock.yaml && echo \"✅  Successfully removed \""
+    "./crypto": {
+      "types": "./dist/src/getCrypto/index.d.ts",
+      "import": "./dist/src/getCrypto/index.js",
+      "require": "./dist/src/getCrypto/index.js"
     },
-    "dependencies": {
-        "@mysetup/logger": "latest",
-        "dayjs": "^1.11.13"
-    },
-    "devDependencies": {
-        "@mysetup/eslint-config": "latest",
-        "@mysetup/jest-config": "latest",
-        "@mysetup/prettier-config": "latest",
-        "@mysetup/tsconfig": "latest",
-        "@mysetup/types": "latest",
-        "@types/jest": "^29.5.14",
-        "@types/node": "^22.13.1",
-        "@types/react": "^18.3.1",
-        "@types/react-dom": "^18.3.1",
-        "jest": "^29.7.0",
-        "next": "^15.1.9",
-        "react": "^18.3.1",
-        "react-dom": "^18.3.1",
-        "typescript": "5.5.4"
-    },
-    "prettier": "@mysetup/prettier-config",
-    "engines": {
-        "node": ">=20.15.1"
-    },
-    "packageManager": "pnpm@9.9.0"
-}
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "dayjs": "^1.11.13",
+    "@mysetup/logger": "^2.0.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.13.1",
+    "@types/react": "^18.3.1",
+    "@types/react-dom": "^18.3.1",
+    "jest": "^29.7.0",
+    "next": "^15.1.9",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "5.5.4",
+    "@mysetup/tsconfig": "^2.0.4",
+    "@mysetup/eslint-config": "^2.0.5",
+    "@mysetup/prettier-config": "^2.0.4",
+    "@mysetup/jest-config": "^2.0.4",
+    "@mysetup/types": "^2.0.7"
+  },
+  "prettier": "@mysetup/prettier-config",
+  "engines": {
+    "node": ">=20.15.1"
+  },
+  "scripts": {
+    "build": "node ../scripts/package-fs.cjs remove dist && tsc -p tsconfig.build.json",
+    "lint": "node ../scripts/run-eslint.cjs .",
+    "test": "jest",
+    "test:update": "pnpm test -- -u",
+    "test:coverage": "jest --coverage",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write \"**/*.{ts,tsx,md,js,mjs,json}\"",
+    "checks": "pnpm typecheck && pnpm lint && pnpm test && pnpm build",
+    "clean": "node ../scripts/package-fs.cjs remove node_modules .swc dist pnpm-lock.yaml && echo \"Cleaned\""
+  }
+}

package/dist/index.d.ts.map

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

package/dist/src/arrayMethods/arrayMethods.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"arrayMethods.d.ts","sourceRoot":"","sources":["../../../src/arrayMethods/arrayMethods.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAc3E"}

package/dist/src/arrayMethods/index.d.ts.map

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

package/dist/src/formatPhoneNumber/formatPhoneNumber.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatPhoneNumber.d.ts","sourceRoot":"","sources":["../../../src/formatPhoneNumber/formatPhoneNumber.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUpE;AAED,eAAO,MAAM,qBAAqB,gBAAiB,MAAM,KAAG,MAM3D,CAAC"}

package/dist/src/formatPhoneNumber/index.d.ts.map

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

package/dist/src/generate-cache-key/generate-cache-key.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate-cache-key.d.ts","sourceRoot":"","sources":["../../../src/generate-cache-key/generate-cache-key.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,UAClB,MAAM,eACA,MAAM,OACd,MAAM,WAGd,CAAC"}

package/dist/src/generate-cache-key/index.d.ts.map

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

package/dist/src/getCrypto/getCrypto.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getCrypto.d.ts","sourceRoot":"","sources":["../../../src/getCrypto/getCrypto.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,SAAU,MAAM,WAAW,MAAM,KAAG,MAgB1D,CAAC;AAEF,eAAO,MAAM,UAAU,kBAAmB,MAAM,WAAW,MAAM,KAAG,MAoBnE,CAAC"}

package/dist/src/getCrypto/index.d.ts.map

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

package/dist/src/getDateTimeDiff/getDateTimeDiff.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getDateTimeDiff.d.ts","sourceRoot":"","sources":["../../../src/getDateTimeDiff/getDateTimeDiff.ts"],"names":[],"mappings":"AACA,OAAO,cAAc,MAAM,uBAAuB,CAAC;AAMnD,eAAO,MAAM,eAAe,aAAc,MAAM,WAAW,MAAM;;;;;;;;CAqChE,CAAC"}

package/dist/src/getDateTimeDiff/index.d.ts.map

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

package/dist/src/getTextWidth/getTextWidth.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getTextWidth.d.ts","sourceRoot":"","sources":["../../../src/getTextWidth/getTextWidth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,SAAU,MAAM,SAAS,MAAM,uBAWvD,CAAC"}

package/dist/src/getTextWidth/index.d.ts.map

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/src/setCookie/index.d.ts.map

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

package/dist/src/setCookie/setCookie.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setCookie.d.ts","sourceRoot":"","sources":["../../../src/setCookie/setCookie.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,UAAW,MAAM,UAAU,MAAM,UAAU,MAAM,SAKtE,CAAC"}