@ibiliaze/stringman 3.2.0 → 3.3.0

package/dist/index.d.ts

@@ -127,3 +127,14 @@ export declare const getRandomString: (length: number) => string;
  * @returns true if the URL is a video, false otherwise
  */
 export declare const isVideoUrl: (url: string) => boolean;
+/**
+ * Returns the client's public IP address by querying external "IP echo" services.
+ *
+ * Strategy:
+ *  - Try an endpoint that supports IPv6 first, then fall back to IPv4-only.
+ *  - Use `cache: 'no-store'` to avoid any cached/stale responses from intermediaries.
+ *  - If a request fails (network/CORS/HTTP error), move on to the next endpoint.
+ *
+ * @throws Error if no endpoint returns a valid IP.
+ */
+export declare const getPublicIP: () => Promise<string>;

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isVideoUrl = exports.getRandomString = exports.extractImageSrcs = exports.select = exports.query = exports.getCloudinaryPublicId = exports.dp = exports.megaTrim = exports.superTrim = void 0;
+exports.getPublicIP = exports.isVideoUrl = exports.getRandomString = exports.extractImageSrcs = exports.select = exports.query = exports.getCloudinaryPublicId = exports.dp = exports.megaTrim = exports.superTrim = void 0;
 /**
  * Clean up extra whitespace in a string.
  *
@@ -199,3 +199,32 @@ const isVideoUrl = (url) => {
     }
 };
 exports.isVideoUrl = isVideoUrl;
+/**
+ * Returns the client's public IP address by querying external "IP echo" services.
+ *
+ * Strategy:
+ *  - Try an endpoint that supports IPv6 first, then fall back to IPv4-only.
+ *  - Use `cache: 'no-store'` to avoid any cached/stale responses from intermediaries.
+ *  - If a request fails (network/CORS/HTTP error), move on to the next endpoint.
+ *
+ * @throws Error if no endpoint returns a valid IP.
+ */
+const getPublicIP = async () => {
+    const urls = [
+        'https://api64.ipify.org?format=json', // IPv6/IPv4
+        'https://api.ipify.org?format=json', // IPv4 fallback
+    ];
+    for (const url of urls) {
+        try {
+            const r = await fetch(url, { cache: 'no-store' });
+            if (!r.ok)
+                continue;
+            const { ip } = await r.json();
+            if (ip)
+                return ip;
+        }
+        catch { }
+    }
+    throw new Error('Public IP unavailable');
+};
+exports.getPublicIP = getPublicIP;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@ibiliaze/stringman",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
     "pub": "npm publish --access public",
-    "git": "git add .; git commit -m 'changes'; git tag -a v3.2.0 -m 'v3.2.0'; git push origin v3.2.0; git push",
+    "git": "git add .; git commit -m 'changes'; git tag -a v3.3.0 -m 'v3.3.0'; git push origin v3.3.0; git push",
     "push": "npm run build; npm run git; npm run pub"
   },
   "author": "Ibi Hasanli",

package/src/index.ts

@@ -201,3 +201,29 @@ export const isVideoUrl = (url: string): boolean => {
     return false;
   }
 };
+
+/**
+ * Returns the client's public IP address by querying external "IP echo" services.
+ *
+ * Strategy:
+ *  - Try an endpoint that supports IPv6 first, then fall back to IPv4-only.
+ *  - Use `cache: 'no-store'` to avoid any cached/stale responses from intermediaries.
+ *  - If a request fails (network/CORS/HTTP error), move on to the next endpoint.
+ *
+ * @throws Error if no endpoint returns a valid IP.
+ */
+export const getPublicIP = async (): Promise<string> => {
+  const urls = [
+    'https://api64.ipify.org?format=json', // IPv6/IPv4
+    'https://api.ipify.org?format=json', // IPv4 fallback
+  ];
+  for (const url of urls) {
+    try {
+      const r = await fetch(url, { cache: 'no-store' });
+      if (!r.ok) continue;
+      const { ip } = await r.json();
+      if (ip) return ip;
+    } catch {}
+  }
+  throw new Error('Public IP unavailable');
+};