universal-app-opener 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 universal-app-opener
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -18,86 +18,76 @@ yarn add universal-app-opener
 
 ## Usage
 
-### Basic Example
+### One-Click Open (Recommended)
 
-```typescript
-import { generateDeepLink, detectOS } from 'universal-app-opener';
+The simplest way to open a link - automatically detects platform and opens the appropriate app or web URL:
 
-const url = 'https://www.youtube.com/watch?v=dQw4w9WgXcQ';
-const result = generateDeepLink(url);
+```typescript
+import { openLink } from 'universal-app-opener';
 
-console.log(result);
-// {
-//   webUrl: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
-//   ios: 'vnd.youtube://watch?v=dQw4w9WgXcQ',
-//   android: 'intent://watch?v=dQw4w9WgXcQ#Intent;scheme=vnd.youtube;package=com.google.android.youtube;end',
-//   platform: 'youtube'
-// }
+openLink('https://www.youtube.com/watch?v=dQw4w9WgXcQ');
 ```
 
-### Opening Deep Links Based on Platform
+**With options:**
 
 ```typescript
-import { generateDeepLink, detectOS } from 'universal-app-opener';
+import { openLink } from 'universal-app-opener';
 
-function openLink(url: string) {
-  const os = detectOS();
-  const result = generateDeepLink(url);
-  
-  if (os === 'ios' && result.ios) {
-    window.location.href = result.ios;
-  } else if (os === 'android' && result.android) {
-    window.location.href = result.android;
-  } else {
-    window.open(result.webUrl, '_blank');
-  }
-}
-
-openLink('https://www.linkedin.com/in/iamsaban/');
+openLink('https://www.linkedin.com/in/iamsaban/', {
+  fallbackToWeb: true,    // Fallback to web if app not installed (default: true)
+  fallbackDelay: 2500,   // Delay before fallback in ms (default: 2500)
+  openInNewTab: false    // Open web URL in new tab (default: false)
+});
 ```
 
-### With Fallback to Web
+### Advanced Usage
+
+If you need more control, you can use the lower-level APIs:
 
 ```typescript
 import { generateDeepLink, detectOS } from 'universal-app-opener';
 
-function openLinkWithFallback(url: string) {
-  const os = detectOS();
-  const result = generateDeepLink(url);
-  
-  let deepLink: string | null = null;
-  
-  if (os === 'ios' && result.ios) {
-    deepLink = result.ios;
-  } else if (os === 'android' && result.android) {
-    deepLink = result.android;
-  }
-  
-  if (deepLink) {
-    window.location.href = deepLink;
-    setTimeout(() => {
-      window.location.href = result.webUrl;
-    }, 2500);
-  } else {
-    window.open(result.webUrl, '_blank');
-  }
+const result = generateDeepLink('https://www.youtube.com/watch?v=dQw4w9WgXcQ');
+const os = detectOS();
+
+if (os === 'ios' && result.ios) {
+  window.location.href = result.ios;
+} else if (os === 'android' && result.android) {
+  window.location.href = result.android;
+} else {
+  window.open(result.webUrl, '_blank');
 }
 ```
 
 ### CommonJS Usage
 
 ```javascript
-const { generateDeepLink, detectOS } = require('universal-app-opener');
+const { openLink, generateDeepLink } = require('universal-app-opener');
 
-const result = generateDeepLink('https://www.youtube.com/watch?v=dQw4w9WgXcQ');
-console.log(result.ios);
+openLink('https://www.youtube.com/watch?v=dQw4w9WgXcQ');
 ```
 
 ## API Reference
 
+### `openLink(url: string, options?: OpenLinkOptions): void`
+
+Opens a URL in the appropriate app or browser. Automatically detects platform and handles deep linking.
+
+**Parameters:**
+- `url` (string): The web URL to open (YouTube or LinkedIn)
+- `options` (optional): Configuration object
+  - `fallbackToWeb` (boolean): Fallback to web URL if app not installed (default: `true`)
+  - `fallbackDelay` (number): Delay in milliseconds before fallback (default: `2500`)
+  - `openInNewTab` (boolean): Open web URL in new tab (default: `false`)
+
+**Example:**
+```typescript
+openLink('https://www.youtube.com/watch?v=dQw4w9WgXcQ');
+```
+
 ### `generateDeepLink(url: string): DeepLinkResult`
 
-Converts a web URL into platform-specific deep links.
+Converts a web URL into platform-specific deep links. Returns the deep link data without opening it.
 
 **Parameters:**
 - `url` (string): The web URL to convert (YouTube or LinkedIn)

package/dist/index.d.mts

@@ -1,10 +1,22 @@
+type Platform = 'youtube' | 'linkedin' | 'instagram' | 'unknown';
 interface DeepLinkResult {
     webUrl: string;
     ios: string | null;
     android: string | null;
-    platform: 'youtube' | 'linkedin' | 'unknown';
+    platform: Platform;
 }
+interface DeepLinkHandler {
+    match(url: string): RegExpMatchArray | null;
+    build(url: string, match: RegExpMatchArray): DeepLinkResult;
+}
+
 declare function generateDeepLink(url: string): DeepLinkResult;
 declare function detectOS(): 'ios' | 'android' | 'desktop';
+interface OpenLinkOptions {
+    fallbackToWeb?: boolean;
+    fallbackDelay?: number;
+    openInNewTab?: boolean;
+}
+declare function openLink(url: string, options?: OpenLinkOptions): void;
 
-export { type DeepLinkResult, detectOS, generateDeepLink };
+export { type DeepLinkHandler, type DeepLinkResult, type OpenLinkOptions, type Platform, detectOS, generateDeepLink, openLink };

package/dist/index.d.ts

@@ -1,10 +1,22 @@
+type Platform = 'youtube' | 'linkedin' | 'instagram' | 'unknown';
 interface DeepLinkResult {
     webUrl: string;
     ios: string | null;
     android: string | null;
-    platform: 'youtube' | 'linkedin' | 'unknown';
+    platform: Platform;
 }
+interface DeepLinkHandler {
+    match(url: string): RegExpMatchArray | null;
+    build(url: string, match: RegExpMatchArray): DeepLinkResult;
+}
+
 declare function generateDeepLink(url: string): DeepLinkResult;
 declare function detectOS(): 'ios' | 'android' | 'desktop';
+interface OpenLinkOptions {
+    fallbackToWeb?: boolean;
+    fallbackDelay?: number;
+    openInNewTab?: boolean;
+}
+declare function openLink(url: string, options?: OpenLinkOptions): void;
 
-export { type DeepLinkResult, detectOS, generateDeepLink };
+export { type DeepLinkHandler, type DeepLinkResult, type OpenLinkOptions, type Platform, detectOS, generateDeepLink, openLink };

package/dist/index.js

@@ -21,25 +21,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   detectOS: () => detectOS,
-  generateDeepLink: () => generateDeepLink
+  generateDeepLink: () => generateDeepLink,
+  openLink: () => openLink
 });
 module.exports = __toCommonJS(index_exports);
-function generateDeepLink(url) {
-  const webUrl = url.trim();
-  const youtubeWatchMatch = webUrl.match(/youtube\.com\/watch\?v=([^&]+)/);
-  const youtubeShortMatch = webUrl.match(/youtu\.be\/([^?]+)/);
-  if (youtubeWatchMatch || youtubeShortMatch) {
-    const videoId = youtubeWatchMatch ? youtubeWatchMatch[1] : youtubeShortMatch[1];
-    return {
-      webUrl,
-      ios: `vnd.youtube://watch?v=${videoId}`,
-      android: `intent://watch?v=${videoId}#Intent;scheme=vnd.youtube;package=com.google.android.youtube;end`,
-      platform: "youtube"
-    };
-  }
-  const linkedinMatch = webUrl.match(/linkedin\.com\/in\/([^/?]+)/);
-  if (linkedinMatch) {
-    const profileId = linkedinMatch[1];
+
+// src/platforms/linkedin.ts
+var linkedinHandler = {
+  match: (url) => url.match(/linkedin\.com\/in\/([^/?]+)/),
+  build: (webUrl, match) => {
+    const profileId = match[1];
     return {
       webUrl,
       ios: `linkedin://in/${profileId}`,
@@ -47,6 +38,10 @@ function generateDeepLink(url) {
       platform: "linkedin"
     };
   }
+};
+
+// src/platforms/unknown.ts
+function unknownHandler(webUrl) {
   return {
     webUrl,
     ios: null,
@@ -54,6 +49,51 @@ function generateDeepLink(url) {
     platform: "unknown"
   };
 }
+
+// src/platforms/youtube.ts
+var youtubeHandler = {
+  match: (url) => url.match(/youtube\.com\/watch\?v=([^&]+)/) ?? url.match(/youtu\.be\/([^?]+)/),
+  build: (webUrl, match) => {
+    const videoId = match[1];
+    return {
+      webUrl,
+      ios: `vnd.youtube://watch?v=${videoId}`,
+      android: `intent://watch?v=${videoId}#Intent;scheme=vnd.youtube;package=com.google.android.youtube;end`,
+      platform: "youtube"
+    };
+  }
+};
+
+// src/platforms/instagram.ts
+var instagramHandler = {
+  match: (url) => url.match(/instagram\.com\/([^/?]+)/),
+  build: (webUrl, match) => {
+    const username = match[1];
+    return {
+      webUrl,
+      ios: `instagram://user?username=${username}`,
+      android: `intent://user?username=${username}#Intent;scheme=instagram;package=com.instagram.android;end`,
+      platform: "instagram"
+    };
+  }
+};
+
+// src/index.ts
+var handlers = [
+  youtubeHandler,
+  linkedinHandler,
+  instagramHandler
+];
+function generateDeepLink(url) {
+  const webUrl = url.trim();
+  for (const handler of handlers) {
+    const match = handler.match(webUrl);
+    if (match) {
+      return handler.build(webUrl, match);
+    }
+  }
+  return unknownHandler(webUrl);
+}
 function detectOS() {
   if (typeof window === "undefined") {
     return "desktop";
@@ -67,9 +107,43 @@ function detectOS() {
   }
   return "desktop";
 }
+function openLink(url, options = {}) {
+  const {
+    fallbackToWeb = true,
+    fallbackDelay = 2500,
+    openInNewTab = false
+  } = options;
+  const os = detectOS();
+  const result = generateDeepLink(url);
+  let deepLink = null;
+  if (os === "ios" && result.ios) {
+    deepLink = result.ios;
+  } else if (os === "android" && result.android) {
+    deepLink = result.android;
+  }
+  if (deepLink && (os === "ios" || os === "android")) {
+    window.location.href = deepLink;
+    if (fallbackToWeb) {
+      setTimeout(() => {
+        if (openInNewTab) {
+          window.open(result.webUrl, "_blank");
+        } else {
+          window.location.href = result.webUrl;
+        }
+      }, fallbackDelay);
+    }
+  } else {
+    if (openInNewTab) {
+      window.open(result.webUrl, "_blank");
+    } else {
+      window.location.href = result.webUrl;
+    }
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   detectOS,
-  generateDeepLink
+  generateDeepLink,
+  openLink
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface DeepLinkResult {\n  webUrl: string;\n  ios: string | null;\n  android: string | null;\n  platform: 'youtube' | 'linkedin' | 'unknown';\n}\n\nexport function generateDeepLink(url: string): DeepLinkResult {\n  const webUrl = url.trim();\n  \n  const youtubeWatchMatch = webUrl.match(/youtube\\.com\\/watch\\?v=([^&]+)/);\n  const youtubeShortMatch = webUrl.match(/youtu\\.be\\/([^?]+)/);\n  \n  if (youtubeWatchMatch || youtubeShortMatch) {\n    const videoId = youtubeWatchMatch ? youtubeWatchMatch[1] : youtubeShortMatch![1];\n    return {\n      webUrl,\n      ios: `vnd.youtube://watch?v=${videoId}`,\n      android: `intent://watch?v=${videoId}#Intent;scheme=vnd.youtube;package=com.google.android.youtube;end`,\n      platform: 'youtube'\n    };\n  }\n  \n  const linkedinMatch = webUrl.match(/linkedin\\.com\\/in\\/([^/?]+)/);\n  if (linkedinMatch) {\n    const profileId = linkedinMatch[1];\n    return {\n      webUrl,\n      ios: `linkedin://in/${profileId}`,\n      android: `intent://in/${profileId}#Intent;scheme=linkedin;package=com.linkedin.android;end`,\n      platform: 'linkedin'\n    };\n  }\n  \n  return {\n    webUrl,\n    ios: null,\n    android: null,\n    platform: 'unknown'\n  };\n}\n\nexport function detectOS(): 'ios' | 'android' | 'desktop' {\n  if (typeof window === 'undefined') {\n    return 'desktop';\n  }\n  \n  const userAgent = window.navigator.userAgent.toLowerCase();\n  \n  if (/iphone|ipad|ipod/.test(userAgent)) {\n    return 'ios';\n  }\n  \n  if (/android/.test(userAgent)) {\n    return 'android';\n  }\n  \n  return 'desktop';\n}\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOO,SAAS,iBAAiB,KAA6B;AAC5D,QAAM,SAAS,IAAI,KAAK;AAExB,QAAM,oBAAoB,OAAO,MAAM,gCAAgC;AACvE,QAAM,oBAAoB,OAAO,MAAM,oBAAoB;AAE3D,MAAI,qBAAqB,mBAAmB;AAC1C,UAAM,UAAU,oBAAoB,kBAAkB,CAAC,IAAI,kBAAmB,CAAC;AAC/E,WAAO;AAAA,MACL;AAAA,MACA,KAAK,yBAAyB,OAAO;AAAA,MACrC,SAAS,oBAAoB,OAAO;AAAA,MACpC,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,QAAM,gBAAgB,OAAO,MAAM,6BAA6B;AAChE,MAAI,eAAe;AACjB,UAAM,YAAY,cAAc,CAAC;AACjC,WAAO;AAAA,MACL;AAAA,MACA,KAAK,iBAAiB,SAAS;AAAA,MAC/B,SAAS,eAAe,SAAS;AAAA,MACjC,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,KAAK;AAAA,IACL,SAAS;AAAA,IACT,UAAU;AAAA,EACZ;AACF;AAEO,SAAS,WAA0C;AACxD,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,UAAU,UAAU,YAAY;AAEzD,MAAI,mBAAmB,KAAK,SAAS,GAAG;AACtC,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,KAAK,SAAS,GAAG;AAC7B,WAAO;AAAA,EACT;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/platforms/linkedin.ts","../src/platforms/unknown.ts","../src/platforms/youtube.ts","../src/platforms/instagram.ts"],"sourcesContent":["import { instagramHandler, linkedinHandler, unknownHandler, youtubeHandler } from \"./platforms\";\nimport { DeepLinkResult } from \"./types\";\n\nexport * from './types';\n\nconst handlers = [\n  youtubeHandler,\n  linkedinHandler,\n  instagramHandler\n];\nexport function generateDeepLink(url: string): DeepLinkResult {\n  const webUrl = url.trim();\n\n  for (const handler of handlers) {\n    const match = handler.match(webUrl);\n    if (match) {\n      return handler.build(webUrl, match);\n    }\n  }\n\n  return unknownHandler(webUrl);\n}\n\nexport function detectOS(): 'ios' | 'android' | 'desktop' {\n  if (typeof window === 'undefined') {\n    return 'desktop';\n  }\n\n  const userAgent = window.navigator.userAgent.toLowerCase();\n\n  if (/iphone|ipad|ipod/.test(userAgent)) {\n    return 'ios';\n  }\n\n  if (/android/.test(userAgent)) {\n    return 'android';\n  }\n\n  return 'desktop';\n}\n\nexport interface OpenLinkOptions {\n  fallbackToWeb?: boolean;\n  fallbackDelay?: number;\n  openInNewTab?: boolean;\n}\n\nexport function openLink(url: string, options: OpenLinkOptions = {}): void {\n  const {\n    fallbackToWeb = true,\n    fallbackDelay = 2500,\n    openInNewTab = false\n  } = options;\n\n  const os = detectOS();\n  const result = generateDeepLink(url);\n\n  let deepLink: string | null = null;\n\n  if (os === 'ios' && result.ios) {\n    deepLink = result.ios;\n  } else if (os === 'android' && result.android) {\n    deepLink = result.android;\n  }\n\n  if (deepLink && (os === 'ios' || os === 'android')) {\n    window.location.href = deepLink;\n\n    if (fallbackToWeb) {\n      setTimeout(() => {\n        if (openInNewTab) {\n          window.open(result.webUrl, '_blank');\n        } else {\n          window.location.href = result.webUrl;\n        }\n      }, fallbackDelay);\n    }\n  } else {\n    if (openInNewTab) {\n      window.open(result.webUrl, '_blank');\n    } else {\n      window.location.href = result.webUrl;\n    }\n  }\n}\n\n","import { DeepLinkHandler } from '../types';\n\nexport const linkedinHandler: DeepLinkHandler = {\n  match: (url) => url.match(/linkedin\\.com\\/in\\/([^/?]+)/),\n\n  build: (webUrl, match) => {\n    const profileId = match[1];\n\n    return {\n      webUrl,\n      ios: `linkedin://in/${profileId}`,\n      android: `intent://in/${profileId}#Intent;scheme=linkedin;package=com.linkedin.android;end`,\n      platform: 'linkedin',\n    };\n  },\n};\n","import { DeepLinkResult } from '../types';\n\nexport function unknownHandler(webUrl: string): DeepLinkResult {\n  return {\n    webUrl,\n    ios: null,\n    android: null,\n    platform: 'unknown',\n  };\n}\n","import { DeepLinkHandler } from '../types';\n\nexport const youtubeHandler: DeepLinkHandler = {\n  match: (url) =>\n    url.match(/youtube\\.com\\/watch\\?v=([^&]+)/) ??\n    url.match(/youtu\\.be\\/([^?]+)/),\n\n  build: (webUrl, match) => {\n    const videoId = match[1];\n\n    return {\n      webUrl,\n      ios: `vnd.youtube://watch?v=${videoId}`,\n      android: `intent://watch?v=${videoId}#Intent;scheme=vnd.youtube;package=com.google.android.youtube;end`,\n      platform: 'youtube',\n    };\n  },\n};\n","import { DeepLinkHandler } from '../types';\n\nexport const instagramHandler: DeepLinkHandler = {\n  match: (url) =>\n    url.match(/instagram\\.com\\/([^/?]+)/),\n\n  build: (webUrl, match) => {\n    const username = match[1];\n\n    return {\n      webUrl,\n      ios: `instagram://user?username=${username}`,\n      android: `intent://user?username=${username}#Intent;scheme=instagram;package=com.instagram.android;end`,\n      platform: 'instagram',\n    };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,IAAM,kBAAmC;AAAA,EAC9C,OAAO,CAAC,QAAQ,IAAI,MAAM,6BAA6B;AAAA,EAEvD,OAAO,CAAC,QAAQ,UAAU;AACxB,UAAM,YAAY,MAAM,CAAC;AAEzB,WAAO;AAAA,MACL;AAAA,MACA,KAAK,iBAAiB,SAAS;AAAA,MAC/B,SAAS,eAAe,SAAS;AAAA,MACjC,UAAU;AAAA,IACZ;AAAA,EACF;AACF;;;ACbO,SAAS,eAAe,QAAgC;AAC7D,SAAO;AAAA,IACL;AAAA,IACA,KAAK;AAAA,IACL,SAAS;AAAA,IACT,UAAU;AAAA,EACZ;AACF;;;ACPO,IAAM,iBAAkC;AAAA,EAC7C,OAAO,CAAC,QACN,IAAI,MAAM,gCAAgC,KAC1C,IAAI,MAAM,oBAAoB;AAAA,EAEhC,OAAO,CAAC,QAAQ,UAAU;AACxB,UAAM,UAAU,MAAM,CAAC;AAEvB,WAAO;AAAA,MACL;AAAA,MACA,KAAK,yBAAyB,OAAO;AAAA,MACrC,SAAS,oBAAoB,OAAO;AAAA,MACpC,UAAU;AAAA,IACZ;AAAA,EACF;AACF;;;ACfO,IAAM,mBAAoC;AAAA,EAC/C,OAAO,CAAC,QACN,IAAI,MAAM,0BAA0B;AAAA,EAEtC,OAAO,CAAC,QAAQ,UAAU;AACxB,UAAM,WAAW,MAAM,CAAC;AAExB,WAAO;AAAA,MACL;AAAA,MACA,KAAK,6BAA6B,QAAQ;AAAA,MAC1C,SAAS,0BAA0B,QAAQ;AAAA,MAC3C,UAAU;AAAA,IACZ;AAAA,EACF;AACF;;;AJXA,IAAM,WAAW;AAAA,EACf;AAAA,EACA;AAAA,EACA;AACF;AACO,SAAS,iBAAiB,KAA6B;AAC5D,QAAM,SAAS,IAAI,KAAK;AAExB,aAAW,WAAW,UAAU;AAC9B,UAAM,QAAQ,QAAQ,MAAM,MAAM;AAClC,QAAI,OAAO;AACT,aAAO,QAAQ,MAAM,QAAQ,KAAK;AAAA,IACpC;AAAA,EACF;AAEA,SAAO,eAAe,MAAM;AAC9B;AAEO,SAAS,WAA0C;AACxD,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,UAAU,UAAU,YAAY;AAEzD,MAAI,mBAAmB,KAAK,SAAS,GAAG;AACtC,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,KAAK,SAAS,GAAG;AAC7B,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAQO,SAAS,SAAS,KAAa,UAA2B,CAAC,GAAS;AACzE,QAAM;AAAA,IACJ,gBAAgB;AAAA,IAChB,gBAAgB;AAAA,IAChB,eAAe;AAAA,EACjB,IAAI;AAEJ,QAAM,KAAK,SAAS;AACpB,QAAM,SAAS,iBAAiB,GAAG;AAEnC,MAAI,WAA0B;AAE9B,MAAI,OAAO,SAAS,OAAO,KAAK;AAC9B,eAAW,OAAO;AAAA,EACpB,WAAW,OAAO,aAAa,OAAO,SAAS;AAC7C,eAAW,OAAO;AAAA,EACpB;AAEA,MAAI,aAAa,OAAO,SAAS,OAAO,YAAY;AAClD,WAAO,SAAS,OAAO;AAEvB,QAAI,eAAe;AACjB,iBAAW,MAAM;AACf,YAAI,cAAc;AAChB,iBAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,QACrC,OAAO;AACL,iBAAO,SAAS,OAAO,OAAO;AAAA,QAChC;AAAA,MACF,GAAG,aAAa;AAAA,IAClB;AAAA,EACF,OAAO;AACL,QAAI,cAAc;AAChB,aAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,IACrC,OAAO;AACL,aAAO,SAAS,OAAO,OAAO;AAAA,IAChC;AAAA,EACF;AACF;","names":[]}

package/dist/index.mjs

@@ -1,20 +1,8 @@
-// src/index.ts
-function generateDeepLink(url) {
-  const webUrl = url.trim();
-  const youtubeWatchMatch = webUrl.match(/youtube\.com\/watch\?v=([^&]+)/);
-  const youtubeShortMatch = webUrl.match(/youtu\.be\/([^?]+)/);
-  if (youtubeWatchMatch || youtubeShortMatch) {
-    const videoId = youtubeWatchMatch ? youtubeWatchMatch[1] : youtubeShortMatch[1];
-    return {
-      webUrl,
-      ios: `vnd.youtube://watch?v=${videoId}`,
-      android: `intent://watch?v=${videoId}#Intent;scheme=vnd.youtube;package=com.google.android.youtube;end`,
-      platform: "youtube"
-    };
-  }
-  const linkedinMatch = webUrl.match(/linkedin\.com\/in\/([^/?]+)/);
-  if (linkedinMatch) {
-    const profileId = linkedinMatch[1];
+// src/platforms/linkedin.ts
+var linkedinHandler = {
+  match: (url) => url.match(/linkedin\.com\/in\/([^/?]+)/),
+  build: (webUrl, match) => {
+    const profileId = match[1];
     return {
       webUrl,
       ios: `linkedin://in/${profileId}`,
@@ -22,6 +10,10 @@ function generateDeepLink(url) {
       platform: "linkedin"
     };
   }
+};
+
+// src/platforms/unknown.ts
+function unknownHandler(webUrl) {
   return {
     webUrl,
     ios: null,
@@ -29,6 +21,51 @@ function generateDeepLink(url) {
     platform: "unknown"
   };
 }
+
+// src/platforms/youtube.ts
+var youtubeHandler = {
+  match: (url) => url.match(/youtube\.com\/watch\?v=([^&]+)/) ?? url.match(/youtu\.be\/([^?]+)/),
+  build: (webUrl, match) => {
+    const videoId = match[1];
+    return {
+      webUrl,
+      ios: `vnd.youtube://watch?v=${videoId}`,
+      android: `intent://watch?v=${videoId}#Intent;scheme=vnd.youtube;package=com.google.android.youtube;end`,
+      platform: "youtube"
+    };
+  }
+};
+
+// src/platforms/instagram.ts
+var instagramHandler = {
+  match: (url) => url.match(/instagram\.com\/([^/?]+)/),
+  build: (webUrl, match) => {
+    const username = match[1];
+    return {
+      webUrl,
+      ios: `instagram://user?username=${username}`,
+      android: `intent://user?username=${username}#Intent;scheme=instagram;package=com.instagram.android;end`,
+      platform: "instagram"
+    };
+  }
+};
+
+// src/index.ts
+var handlers = [
+  youtubeHandler,
+  linkedinHandler,
+  instagramHandler
+];
+function generateDeepLink(url) {
+  const webUrl = url.trim();
+  for (const handler of handlers) {
+    const match = handler.match(webUrl);
+    if (match) {
+      return handler.build(webUrl, match);
+    }
+  }
+  return unknownHandler(webUrl);
+}
 function detectOS() {
   if (typeof window === "undefined") {
     return "desktop";
@@ -42,8 +79,42 @@ function detectOS() {
   }
   return "desktop";
 }
+function openLink(url, options = {}) {
+  const {
+    fallbackToWeb = true,
+    fallbackDelay = 2500,
+    openInNewTab = false
+  } = options;
+  const os = detectOS();
+  const result = generateDeepLink(url);
+  let deepLink = null;
+  if (os === "ios" && result.ios) {
+    deepLink = result.ios;
+  } else if (os === "android" && result.android) {
+    deepLink = result.android;
+  }
+  if (deepLink && (os === "ios" || os === "android")) {
+    window.location.href = deepLink;
+    if (fallbackToWeb) {
+      setTimeout(() => {
+        if (openInNewTab) {
+          window.open(result.webUrl, "_blank");
+        } else {
+          window.location.href = result.webUrl;
+        }
+      }, fallbackDelay);
+    }
+  } else {
+    if (openInNewTab) {
+      window.open(result.webUrl, "_blank");
+    } else {
+      window.location.href = result.webUrl;
+    }
+  }
+}
 export {
   detectOS,
-  generateDeepLink
+  generateDeepLink,
+  openLink
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface DeepLinkResult {\n  webUrl: string;\n  ios: string | null;\n  android: string | null;\n  platform: 'youtube' | 'linkedin' | 'unknown';\n}\n\nexport function generateDeepLink(url: string): DeepLinkResult {\n  const webUrl = url.trim();\n  \n  const youtubeWatchMatch = webUrl.match(/youtube\\.com\\/watch\\?v=([^&]+)/);\n  const youtubeShortMatch = webUrl.match(/youtu\\.be\\/([^?]+)/);\n  \n  if (youtubeWatchMatch || youtubeShortMatch) {\n    const videoId = youtubeWatchMatch ? youtubeWatchMatch[1] : youtubeShortMatch![1];\n    return {\n      webUrl,\n      ios: `vnd.youtube://watch?v=${videoId}`,\n      android: `intent://watch?v=${videoId}#Intent;scheme=vnd.youtube;package=com.google.android.youtube;end`,\n      platform: 'youtube'\n    };\n  }\n  \n  const linkedinMatch = webUrl.match(/linkedin\\.com\\/in\\/([^/?]+)/);\n  if (linkedinMatch) {\n    const profileId = linkedinMatch[1];\n    return {\n      webUrl,\n      ios: `linkedin://in/${profileId}`,\n      android: `intent://in/${profileId}#Intent;scheme=linkedin;package=com.linkedin.android;end`,\n      platform: 'linkedin'\n    };\n  }\n  \n  return {\n    webUrl,\n    ios: null,\n    android: null,\n    platform: 'unknown'\n  };\n}\n\nexport function detectOS(): 'ios' | 'android' | 'desktop' {\n  if (typeof window === 'undefined') {\n    return 'desktop';\n  }\n  \n  const userAgent = window.navigator.userAgent.toLowerCase();\n  \n  if (/iphone|ipad|ipod/.test(userAgent)) {\n    return 'ios';\n  }\n  \n  if (/android/.test(userAgent)) {\n    return 'android';\n  }\n  \n  return 'desktop';\n}\n\n"],"mappings":";AAOO,SAAS,iBAAiB,KAA6B;AAC5D,QAAM,SAAS,IAAI,KAAK;AAExB,QAAM,oBAAoB,OAAO,MAAM,gCAAgC;AACvE,QAAM,oBAAoB,OAAO,MAAM,oBAAoB;AAE3D,MAAI,qBAAqB,mBAAmB;AAC1C,UAAM,UAAU,oBAAoB,kBAAkB,CAAC,IAAI,kBAAmB,CAAC;AAC/E,WAAO;AAAA,MACL;AAAA,MACA,KAAK,yBAAyB,OAAO;AAAA,MACrC,SAAS,oBAAoB,OAAO;AAAA,MACpC,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,QAAM,gBAAgB,OAAO,MAAM,6BAA6B;AAChE,MAAI,eAAe;AACjB,UAAM,YAAY,cAAc,CAAC;AACjC,WAAO;AAAA,MACL;AAAA,MACA,KAAK,iBAAiB,SAAS;AAAA,MAC/B,SAAS,eAAe,SAAS;AAAA,MACjC,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,KAAK;AAAA,IACL,SAAS;AAAA,IACT,UAAU;AAAA,EACZ;AACF;AAEO,SAAS,WAA0C;AACxD,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,UAAU,UAAU,YAAY;AAEzD,MAAI,mBAAmB,KAAK,SAAS,GAAG;AACtC,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,KAAK,SAAS,GAAG;AAC7B,WAAO;AAAA,EACT;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/platforms/linkedin.ts","../src/platforms/unknown.ts","../src/platforms/youtube.ts","../src/platforms/instagram.ts","../src/index.ts"],"sourcesContent":["import { DeepLinkHandler } from '../types';\n\nexport const linkedinHandler: DeepLinkHandler = {\n  match: (url) => url.match(/linkedin\\.com\\/in\\/([^/?]+)/),\n\n  build: (webUrl, match) => {\n    const profileId = match[1];\n\n    return {\n      webUrl,\n      ios: `linkedin://in/${profileId}`,\n      android: `intent://in/${profileId}#Intent;scheme=linkedin;package=com.linkedin.android;end`,\n      platform: 'linkedin',\n    };\n  },\n};\n","import { DeepLinkResult } from '../types';\n\nexport function unknownHandler(webUrl: string): DeepLinkResult {\n  return {\n    webUrl,\n    ios: null,\n    android: null,\n    platform: 'unknown',\n  };\n}\n","import { DeepLinkHandler } from '../types';\n\nexport const youtubeHandler: DeepLinkHandler = {\n  match: (url) =>\n    url.match(/youtube\\.com\\/watch\\?v=([^&]+)/) ??\n    url.match(/youtu\\.be\\/([^?]+)/),\n\n  build: (webUrl, match) => {\n    const videoId = match[1];\n\n    return {\n      webUrl,\n      ios: `vnd.youtube://watch?v=${videoId}`,\n      android: `intent://watch?v=${videoId}#Intent;scheme=vnd.youtube;package=com.google.android.youtube;end`,\n      platform: 'youtube',\n    };\n  },\n};\n","import { DeepLinkHandler } from '../types';\n\nexport const instagramHandler: DeepLinkHandler = {\n  match: (url) =>\n    url.match(/instagram\\.com\\/([^/?]+)/),\n\n  build: (webUrl, match) => {\n    const username = match[1];\n\n    return {\n      webUrl,\n      ios: `instagram://user?username=${username}`,\n      android: `intent://user?username=${username}#Intent;scheme=instagram;package=com.instagram.android;end`,\n      platform: 'instagram',\n    };\n  },\n};\n","import { instagramHandler, linkedinHandler, unknownHandler, youtubeHandler } from \"./platforms\";\nimport { DeepLinkResult } from \"./types\";\n\nexport * from './types';\n\nconst handlers = [\n  youtubeHandler,\n  linkedinHandler,\n  instagramHandler\n];\nexport function generateDeepLink(url: string): DeepLinkResult {\n  const webUrl = url.trim();\n\n  for (const handler of handlers) {\n    const match = handler.match(webUrl);\n    if (match) {\n      return handler.build(webUrl, match);\n    }\n  }\n\n  return unknownHandler(webUrl);\n}\n\nexport function detectOS(): 'ios' | 'android' | 'desktop' {\n  if (typeof window === 'undefined') {\n    return 'desktop';\n  }\n\n  const userAgent = window.navigator.userAgent.toLowerCase();\n\n  if (/iphone|ipad|ipod/.test(userAgent)) {\n    return 'ios';\n  }\n\n  if (/android/.test(userAgent)) {\n    return 'android';\n  }\n\n  return 'desktop';\n}\n\nexport interface OpenLinkOptions {\n  fallbackToWeb?: boolean;\n  fallbackDelay?: number;\n  openInNewTab?: boolean;\n}\n\nexport function openLink(url: string, options: OpenLinkOptions = {}): void {\n  const {\n    fallbackToWeb = true,\n    fallbackDelay = 2500,\n    openInNewTab = false\n  } = options;\n\n  const os = detectOS();\n  const result = generateDeepLink(url);\n\n  let deepLink: string | null = null;\n\n  if (os === 'ios' && result.ios) {\n    deepLink = result.ios;\n  } else if (os === 'android' && result.android) {\n    deepLink = result.android;\n  }\n\n  if (deepLink && (os === 'ios' || os === 'android')) {\n    window.location.href = deepLink;\n\n    if (fallbackToWeb) {\n      setTimeout(() => {\n        if (openInNewTab) {\n          window.open(result.webUrl, '_blank');\n        } else {\n          window.location.href = result.webUrl;\n        }\n      }, fallbackDelay);\n    }\n  } else {\n    if (openInNewTab) {\n      window.open(result.webUrl, '_blank');\n    } else {\n      window.location.href = result.webUrl;\n    }\n  }\n}\n\n"],"mappings":";AAEO,IAAM,kBAAmC;AAAA,EAC9C,OAAO,CAAC,QAAQ,IAAI,MAAM,6BAA6B;AAAA,EAEvD,OAAO,CAAC,QAAQ,UAAU;AACxB,UAAM,YAAY,MAAM,CAAC;AAEzB,WAAO;AAAA,MACL;AAAA,MACA,KAAK,iBAAiB,SAAS;AAAA,MAC/B,SAAS,eAAe,SAAS;AAAA,MACjC,UAAU;AAAA,IACZ;AAAA,EACF;AACF;;;ACbO,SAAS,eAAe,QAAgC;AAC7D,SAAO;AAAA,IACL;AAAA,IACA,KAAK;AAAA,IACL,SAAS;AAAA,IACT,UAAU;AAAA,EACZ;AACF;;;ACPO,IAAM,iBAAkC;AAAA,EAC7C,OAAO,CAAC,QACN,IAAI,MAAM,gCAAgC,KAC1C,IAAI,MAAM,oBAAoB;AAAA,EAEhC,OAAO,CAAC,QAAQ,UAAU;AACxB,UAAM,UAAU,MAAM,CAAC;AAEvB,WAAO;AAAA,MACL;AAAA,MACA,KAAK,yBAAyB,OAAO;AAAA,MACrC,SAAS,oBAAoB,OAAO;AAAA,MACpC,UAAU;AAAA,IACZ;AAAA,EACF;AACF;;;ACfO,IAAM,mBAAoC;AAAA,EAC/C,OAAO,CAAC,QACN,IAAI,MAAM,0BAA0B;AAAA,EAEtC,OAAO,CAAC,QAAQ,UAAU;AACxB,UAAM,WAAW,MAAM,CAAC;AAExB,WAAO;AAAA,MACL;AAAA,MACA,KAAK,6BAA6B,QAAQ;AAAA,MAC1C,SAAS,0BAA0B,QAAQ;AAAA,MAC3C,UAAU;AAAA,IACZ;AAAA,EACF;AACF;;;ACXA,IAAM,WAAW;AAAA,EACf;AAAA,EACA;AAAA,EACA;AACF;AACO,SAAS,iBAAiB,KAA6B;AAC5D,QAAM,SAAS,IAAI,KAAK;AAExB,aAAW,WAAW,UAAU;AAC9B,UAAM,QAAQ,QAAQ,MAAM,MAAM;AAClC,QAAI,OAAO;AACT,aAAO,QAAQ,MAAM,QAAQ,KAAK;AAAA,IACpC;AAAA,EACF;AAEA,SAAO,eAAe,MAAM;AAC9B;AAEO,SAAS,WAA0C;AACxD,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,UAAU,UAAU,YAAY;AAEzD,MAAI,mBAAmB,KAAK,SAAS,GAAG;AACtC,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,KAAK,SAAS,GAAG;AAC7B,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAQO,SAAS,SAAS,KAAa,UAA2B,CAAC,GAAS;AACzE,QAAM;AAAA,IACJ,gBAAgB;AAAA,IAChB,gBAAgB;AAAA,IAChB,eAAe;AAAA,EACjB,IAAI;AAEJ,QAAM,KAAK,SAAS;AACpB,QAAM,SAAS,iBAAiB,GAAG;AAEnC,MAAI,WAA0B;AAE9B,MAAI,OAAO,SAAS,OAAO,KAAK;AAC9B,eAAW,OAAO;AAAA,EACpB,WAAW,OAAO,aAAa,OAAO,SAAS;AAC7C,eAAW,OAAO;AAAA,EACpB;AAEA,MAAI,aAAa,OAAO,SAAS,OAAO,YAAY;AAClD,WAAO,SAAS,OAAO;AAEvB,QAAI,eAAe;AACjB,iBAAW,MAAM;AACf,YAAI,cAAc;AAChB,iBAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,QACrC,OAAO;AACL,iBAAO,SAAS,OAAO,OAAO;AAAA,QAChC;AAAA,MACF,GAAG,aAAa;AAAA,IAClB;AAAA,EACF,OAAO;AACL,QAAI,cAAc;AAChB,aAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,IACrC,OAAO;AACL,aAAO,SAAS,OAAO,OAAO;AAAA,IAChC;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-app-opener",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "A zero-dependency library to generate deep links from HTTP URLs",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -17,11 +17,6 @@
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "prepublishOnly": "pnpm build"
-  },
   "keywords": [
     "deep-link",
     "mobile",
@@ -43,5 +38,9 @@
   "devDependencies": {
     "tsup": "^8.0.0",
     "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
   }
-}
+}