instasave-sdk 1.0.8 → 1.0.9

package/README.md

@@ -1,6 +1,6 @@
 # InstaSave SDK
 
-[![Version](https://img.shields.io/badge/version-1.0.8-blue.svg)](https://github.com/nykadamec/instasave-sdk/releases/tag/v1.0.8)
+[![Version](https://img.shields.io/badge/version-1.0.9-blue.svg)](https://github.com/nykadamec/instasave-sdk/releases/tag/v1.0.9)
 [![Changelog](https://img.shields.io/badge/changelog-latest-green.svg)](https://github.com/nykadamec/instasave-sdk/blob/main/CHANGELOG.md)
 
 📸 Simple Instagram scraper for downloading images from posts

package/dist/url-normalizer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * URL normalization for consistent Instagram post URLs
+ */
+export declare class URLNormalizer {
+    /**
+     * Normalize Instagram URL to consistent format
+     */
+    static normalizeInstagramUrl(url: string): string;
+    /**
+     * Extract post ID from URL object
+     */
+    private static extractPostId;
+    /**
+     * Check if URL is Instagram post URL
+     */
+    static isInstagramPostUrl(url: string): boolean;
+    /**
+     * Get post ID from URL
+     */
+    static getPostId(url: string): string;
+    /**
+     * Normalize multiple URLs
+     */
+    static normalizeUrls(urls: string[]): string[];
+}
+//# sourceMappingURL=url-normalizer.d.ts.map

package/dist/url-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-normalizer.d.ts","sourceRoot":"","sources":["../src/url-normalizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAmBjD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAwB5B;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAU/C;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAerC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAG/C"}

package/dist/url-normalizer.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * URL normalization for consistent Instagram post URLs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.URLNormalizer = void 0;
+class URLNormalizer {
+    /**
+     * Normalize Instagram URL to consistent format
+     */
+    static normalizeInstagramUrl(url) {
+        try {
+            const urlObj = new URL(url);
+            // Extract post ID from various URL formats
+            const postId = this.extractPostId(urlObj);
+            if (!postId) {
+                throw new Error('Invalid Instagram post URL - no post ID found');
+            }
+            // Return normalized format
+            return `https://www.instagram.com/p/${postId}/`;
+        }
+        catch (error) {
+            throw new Error(`Failed to normalize URL: ${url} - ${error}`);
+        }
+    }
+    /**
+     * Extract post ID from URL object
+     */
+    static extractPostId(urlObj) {
+        const pathname = urlObj.pathname;
+        // Pattern 1: /p/POST_ID/
+        const directMatch = pathname.match(/\/p\/([^\/]+)/);
+        if (directMatch) {
+            return directMatch[1];
+        }
+        // Pattern 2: /username/p/POST_ID/
+        const userMatch = pathname.match(/\/[^\/]+\/p\/([^\/]+)/);
+        if (userMatch) {
+            return userMatch[1];
+        }
+        // Pattern 3: /reel/POST_ID/
+        const reelMatch = pathname.match(/\/reel\/([^\/]+)/);
+        if (reelMatch) {
+            return reelMatch[1];
+        }
+        return null;
+    }
+    /**
+     * Check if URL is Instagram post URL
+     */
+    static isInstagramPostUrl(url) {
+        try {
+            const urlObj = new URL(url);
+            return urlObj.hostname.includes('instagram.com') &&
+                this.extractPostId(urlObj) !== null;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get post ID from URL
+     */
+    static getPostId(url) {
+        try {
+            const urlObj = new URL(url);
+            const postId = this.extractPostId(urlObj);
+            if (!postId) {
+                throw new Error('No post ID found in URL');
+            }
+            return postId;
+        }
+        catch (error) {
+            throw new Error(`Failed to extract post ID from: ${url} - ${error}`);
+        }
+    }
+    /**
+     * Normalize multiple URLs
+     */
+    static normalizeUrls(urls) {
+        return urls.map(url => this.normalizeInstagramUrl(url));
+    }
+}
+exports.URLNormalizer = URLNormalizer;
+//# sourceMappingURL=url-normalizer.js.map

package/dist/url-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-normalizer.js","sourceRoot":"","sources":["../src/url-normalizer.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,MAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,GAAW;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAE5B,2CAA2C;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YAED,2BAA2B;YAC3B,OAAO,+BAA+B,MAAM,GAAG,CAAC;QAElD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,aAAa,CAAC,MAAW;QACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAEjC,yBAAyB;QACzB,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QAED,kCAAkC;QAClC,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC1D,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QAED,4BAA4B;QAC5B,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACrD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAW;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC;gBACzC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,GAAW;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAc;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF;AAvFD,sCAuFC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instasave-sdk",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Instagram image scraper SDK with authentication support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",