@livx.cc/native-kit 0.45.7 → 0.45.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.45.7",
+  "version": "0.45.9",
   "description": "Isomorphic native-capabilities kit for PWAs — same API in browser and in an appwrap native shell. Zero dependencies.",
   "license": "MIT",
   "author": "Elya Livshitz",

package/src/core/web-adapter.ts

@@ -144,11 +144,13 @@ export class WebAdapter implements NativeKitAdapter {
 
       case 'share.share':
         if (!navigator.share) throw new KitError('UNSUPPORTED', 'Web Share API unavailable');
-        await navigator.share({ title: p.title, text: p.text, url: p.url }).catch((e: Error) => {
-          if (e.name === 'AbortError') return; // user dismissed — not an error
-          throw new KitError('NATIVE_ERROR', e.message);
-        });
-        return undefined as T;
+        return (await navigator.share({ title: p.title, text: p.text, url: p.url }).then(
+          () => ({ completed: true }),
+          (e: Error) => {
+            if (e.name === 'AbortError') return { completed: false }; // user dismissed — not an error
+            throw new KitError('NATIVE_ERROR', e.message);
+          }
+        )) as T;
 
       case 'share.files': {
         const files = ((p.files ?? []) as Array<{ name: string; mimeType: string; base64: string }>).map(
@@ -156,11 +158,13 @@ export class WebAdapter implements NativeKitAdapter {
         );
         const data: ShareData = { files, title: p.title, text: p.text };
         if (!navigator.canShare?.(data)) throw new KitError('UNSUPPORTED', 'Sharing files is unavailable here');
-        await navigator.share(data).catch((e: Error) => {
-          if (e.name === 'AbortError') return; // user dismissed
-          throw new KitError('NATIVE_ERROR', e.message);
-        });
-        return undefined as T;
+        return (await navigator.share(data).then(
+          () => ({ completed: true }),
+          (e: Error) => {
+            if (e.name === 'AbortError') return { completed: false }; // user dismissed
+            throw new KitError('NATIVE_ERROR', e.message);
+          }
+        )) as T;
       }
 
       case 'storage.get':

package/src/index.ts

@@ -22,7 +22,7 @@ export type {
   Unsubscribe,
 } from './core/types';
 export type { ImpactStyle, NotifyType } from './modules/haptics';
-export type { SharePayload, ShareFile } from './modules/share';
+export type { SharePayload, ShareFile, ShareResult } from './modules/share';
 export type { Orientation, OrientationLock } from './modules/screen';
 export type { KeyboardInfo } from './modules/keyboard';
 export type { FsDirectory, FsEncoding, FsEntry, PickedFile } from './modules/fs';

package/src/modules/share.ts

@@ -13,6 +13,15 @@ export interface ShareFile {
   base64: string;
 }
 
+/** How a share sheet ended. `completed` is false when the person dismissed it. `activity` is the OS
+ * activity they picked when the platform reports one (iOS UIActivityType, e.g.
+ * `com.apple.UIKit.activity.SaveToCameraRoll`); web `navigator.share` and the Android chooser never
+ * name it. `undefined` from the call = a shell that predates this result (resolved on present). */
+export interface ShareResult {
+  completed: boolean;
+  activity?: string;
+}
+
 export class ShareModule {
   constructor(private kit: NativeKit) {}
 
@@ -26,12 +35,14 @@ export class ShareModule {
     return this.kit.capability('shareFiles');
   }
 
-  share(payload: SharePayload): Promise<void> {
-    return this.kit.invoke('share.share', payload);
+  // Both resolve when the sheet is DISMISSED (not when it opens), so no watchdog: a person may take
+  // their time picking a target, and a deadline could only false-timeout mid-interaction.
+  share(payload: SharePayload): Promise<ShareResult | undefined> {
+    return this.kit.invoke('share.share', payload, { timeoutMs: 'none' });
   }
 
   /** Share one or more files (iOS UIActivity / web `navigator.share({files})`). */
-  files(files: ShareFile[], opts?: { title?: string; text?: string }): Promise<void> {
-    return this.kit.invoke('share.files', { files, ...opts });
+  files(files: ShareFile[], opts?: { title?: string; text?: string }): Promise<ShareResult | undefined> {
+    return this.kit.invoke('share.files', { files, ...opts }, { timeoutMs: 'none' });
   }
 }