web-launch-kit 0.0.6 → 0.0.7

package/README.ko.md

@@ -119,10 +119,10 @@ flowchart TD
         A1{"intent given, but scheme /<br/>packageName / fallback missing?"}
         A1 -->|yes| A2["parseIntentURL:<br/>derive scheme · packageName · fallback"]
         A1 -->|no| A3
-        A2 --> A3{"scheme given, but intent missing?"}
+        A2 --> A3{"allowIntent, and scheme given<br/>but intent missing?"}
         A3 -->|yes| A4["createIntentURL:<br/>scheme + packageName + fallback"]
         A3 -->|no| A5
-        A4 --> A5["Priority list:<br/>intent (if canOpenIntent) ⭢ scheme (if canOpenScheme)<br/>⭢ fallback ⭢ app store (if canOpenScheme) ⭢ web store"]
+        A4 --> A5["Priority list:<br/>intent (if allowIntent and canOpenIntent) ⭢ scheme (if canOpenScheme)<br/>⭢ fallback ⭢ app store (if canOpenScheme) ⭢ web store"]
     end
 
     subgraph IOS["ios · resolveOptions"]
@@ -202,8 +202,8 @@ const openedBy = await LaunchKit.app({
 console.log(openedBy) // "universal" | "scheme" | "intent" | "fallback" | "store"
 ```
 
-플랫폼별 필드: 안드로이드는 `intent` / `scheme` / `packageName` / `fallback`(scheme ⇄ intent는
-서로에게서 유도됩니다), iOS는 `universal` / `scheme` / `bundleId` / `trackId`, Windows는
+플랫폼별 필드: 안드로이드는 `intent` / `scheme` / `packageName` / `fallback` /
+`allowIntent`(scheme ⇄ intent는 서로에게서 유도됩니다), iOS는 `universal` / `scheme` / `bundleId` / `trackId`, Windows는
 `scheme` / `packageFamilyName` / `productId`, macOS는 `scheme` / `bundleId` / `trackId`를
 받습니다. 모두 `fallback`, `timeout`, `allowAppStore`, `allowWebStore`를 함께 받습니다.
 
@@ -333,6 +333,13 @@ if (LaunchKit.utils.canOpenSetting) {
   그리고 파트너가 아닌 웨이보) 안에서는 커스텀 스킴·`intent://`·`market://` 같은 스토어 스킴이
   타임아웃을 소진하지 않고 미리 제외됩니다. 그래서 체인이 곧바로 `fallback` / 웹스토어로
   떨어집니다. 화이트리스트에 등록된 파트너 앱은 `assumeAllowedInApp: true`로 되돌립니다.
+- **`allowIntent: false`는 안드로이드의 `intent://` 경로를 제외합니다.** 유도된 `intent://`에는
+  `S.browser_fallback_url`이 실립니다 — `fallback`에 URL을 주면 그 URL, 아니면 `packageName`이
+  있을 때 스토어입니다. 그래서 그 이동은 브라우저가 첫 시도 안에서 직접 처리합니다. 앱이 없는
+  사용자를 스토어로 보내는 가장 빠른 경로지만, 동시에 첫 시도가 항상 어딘가에 도달하므로 그
+  뒤의 순수 스킴은 실행되지 않습니다. `allowIntent: false`로 이 경로를 아예 건너뛰면 순서를
+  체인이 결정합니다 — 스킴, `fallback`, 그리고 허용한 스토어 순입니다. 직접 넘긴 `intent`도 같이
+  제외되지만, 거기서 파싱한 scheme·`packageName`·`fallback`은 그대로 사용됩니다.
 - **`map()`은 각 후보에 OS별 타임아웃**을 사용하고, `app()`처럼 성공한 경로를 반환합니다.
 - **웹 폴백은 내비게이션 시점에 resolve합니다.** `fallback`이나 웹스토어 후보는 문서 자체를
   교체하므로 기다릴 앱 전환이 없습니다. 이동을 시작하는 즉시 resolve하며, 이동이 성공한 뒤에

package/README.md

@@ -120,10 +120,10 @@ flowchart TD
         A1{"intent given, but scheme /<br/>packageName / fallback missing?"}
         A1 -->|yes| A2["parseIntentURL:<br/>derive scheme · packageName · fallback"]
         A1 -->|no| A3
-        A2 --> A3{"scheme given, but intent missing?"}
+        A2 --> A3{"allowIntent, and scheme given<br/>but intent missing?"}
         A3 -->|yes| A4["createIntentURL:<br/>scheme + packageName + fallback"]
         A3 -->|no| A5
-        A4 --> A5["Priority list:<br/>intent (if canOpenIntent) ⭢ scheme (if canOpenScheme)<br/>⭢ fallback ⭢ app store (if canOpenScheme) ⭢ web store"]
+        A4 --> A5["Priority list:<br/>intent (if allowIntent and canOpenIntent) ⭢ scheme (if canOpenScheme)<br/>⭢ fallback ⭢ app store (if canOpenScheme) ⭢ web store"]
     end
 
     subgraph IOS["ios · resolveOptions"]
@@ -203,8 +203,8 @@ const openedBy = await LaunchKit.app({
 console.log(openedBy) // "universal" | "scheme" | "intent" | "fallback" | "store"
 ```
 
-Per-platform fields: Android accepts `intent` / `scheme` / `packageName` / `fallback`
-(scheme ⇄ intent are derived from each other); iOS accepts `universal` / `scheme` /
+Per-platform fields: Android accepts `intent` / `scheme` / `packageName` / `fallback` /
+`allowIntent` (scheme ⇄ intent are derived from each other); iOS accepts `universal` / `scheme` /
 `bundleId` / `trackId`; Windows accepts `scheme` / `packageFamilyName` / `productId`;
 macOS accepts `scheme` / `bundleId` / `trackId`. All accept `fallback`, `timeout`,
 `allowAppStore`, `allowWebStore`. 
@@ -216,7 +216,7 @@ UI — there is otherwise nothing on screen for the length of the timeout.
 await LaunchKit.app({
   android: { scheme: 'myapp://profile/42', packageName: 'com.example.myapp', allowWebStore: true },
   onAttempt({ by, index, total }) {
-    setStatus(by === 'store' ? '스토어로 이동합니다' : '앱을 여는 중… (' + (index + 1) + '/' + total + ')')
+    setStatus(by === 'store' ? 'Go to the store' : 'Opening the app… (' + (index + 1) + '/' + total + ')')
   },
 })
 ```
@@ -338,6 +338,14 @@ if (LaunchKit.utils.canOpenSetting) {
   burning their timeouts, so the chain falls straight through to `fallback` / web store
   (the only routes that work there). Whitelisted partner apps opt back in with
   `assumeAllowedInApp: true`.
+- **`allowIntent: false` drops the Android `intent://` route.** A derived `intent://` carries
+  `S.browser_fallback_url` — your `fallback` when you gave a URL, otherwise the store when a
+  `packageName` is present — so the browser handles that hop itself during the first attempt.
+  That is the fastest route to the store for a user without the app, but it also means the
+  first attempt always lands somewhere, and the plain scheme behind it never runs. Set
+  `allowIntent: false` to skip the route entirely and let the chain decide the order: scheme,
+  then `fallback`, then the store you allowed. An explicit `intent` is gated too, though the
+  scheme, `packageName` and `fallback` parsed out of it are still used.
 - **`map()` uses the per-OS timeout** for each candidate, and resolves with the route that
   worked just like `app()`.
 - **Web fallbacks resolve on navigation.** A `fallback` or web-store candidate replaces the

package/dist/index.d.ts

@@ -36,6 +36,7 @@ declare interface AppInfo {
 declare interface AndroidAppInfo extends AppInfo {
     intent?: URLCandidate;
     packageName?: string;
+    allowIntent?: boolean;
     assumeAllowedInApp?: boolean;
 }
 declare interface IOSAppInfo extends AppInfo {

package/dist/launch-kit.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version$3 = "0.0.6";
+var version$3 = "0.0.7";
 var packageJSON$3 = {
 	version: version$3};
 
@@ -2347,6 +2347,7 @@ function resolveOptions(option) {
     var timeout;
     var intent;
     var packageName;
+    var allowIntent = true;
     var bundleId;
     var trackId;
     var universal;
@@ -2356,6 +2357,7 @@ function resolveOptions(option) {
         case 'android':
             if (typeof option.android === 'undefined')
                 return [[], 0];
+            allowIntent = option.android.allowIntent !== false;
             intent = stripURL(option.android.intent);
             scheme = stripURL(option.android.scheme);
             fallback = stripURL(option.android.fallback);
@@ -2374,11 +2376,11 @@ function resolveOptions(option) {
                 if (typeof parsed.fallback !== 'undefined' && typeof fallback === 'undefined')
                     fallback = parsed.fallback;
             }
-            if (typeof scheme !== 'undefined' && typeof intent === 'undefined')
+            if (allowIntent && typeof scheme !== 'undefined' && typeof intent === 'undefined')
                 intent = createIntentURL(scheme, packageName, fallback);
             if (typeof timeout === 'undefined')
                 timeout = ANDROID_DEFAULT_TIMEOUT;
-            if (typeof intent !== 'undefined' && canOpenIntent())
+            if (allowIntent && typeof intent !== 'undefined' && canOpenIntent())
                 resolved.push(['intent', intent]);
             if (typeof scheme !== 'undefined' && allowScheme)
                 resolved.push(['scheme', scheme]);