@livx.cc/native-kit 0.45.9 → 0.45.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.45.9",
+  "version": "0.45.10",
   "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

@@ -72,6 +72,7 @@ export class WebAdapter implements NativeKitAdapter {
       haptics: 'vibrate' in navigator ? 'web' : 'none',
       share: 'share' in navigator ? 'web' : 'none',
       shareFiles: typeof n.canShare === 'function' ? 'web' : 'none', // navigator.canShare({files}) gates at call time
+      saveToPhotos: 'none', // a browser cannot write to the photo library — explicit, so a shell never inherits 'web'
       orientation: screen?.orientation ? 'web' : 'none', // Screen Orientation API (lock needs fullscreen)
       storage: 'web',
       secureStorage: 'none',

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, ShareResult } from './modules/share';
+export type { SharePayload, ShareFile, ShareResult, SaveToPhotosResult } 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

@@ -22,6 +22,15 @@ export interface ShareResult {
   activity?: string;
 }
 
+/** What {@link ShareModule.saveToPhotos} resolves with. Never throws for a refusal: `saved:false` +
+ * `reason` — 'denied' (the person said no / Settings forbids it), 'unsupported' (not an image or video,
+ * or this shell/platform cannot write to the library: browsers, older native builds), 'failed'. */
+export interface SaveToPhotosResult {
+  saved: boolean;
+  reason?: 'denied' | 'unsupported' | 'failed';
+  message?: string;
+}
+
 export class ShareModule {
   constructor(private kit: NativeKit) {}
 
@@ -35,6 +44,22 @@ export class ShareModule {
     return this.kit.capability('shareFiles');
   }
 
+  /** Direct save into the photo library — 'native' only in a shell that has the handler. Absent on web
+   * (a browser cannot write to Photos) and on native builds that predate it: branch on this and fall
+   * back to {@link files} (whose sheet offers "Save Image/Video"). */
+  get saveToPhotosCapability() {
+    return this.kit.capability('saveToPhotos');
+  }
+
+  /** Save ONE image or video straight into Photos (iOS add-only access, Android MediaStore) — no share
+   * sheet. Resolves `{ saved:false, reason:'unsupported' }` without calling the shell when unavailable. */
+  async saveToPhotos(file: ShareFile): Promise<SaveToPhotosResult> {
+    await this.kit.ready().catch(() => {});
+    if (this.saveToPhotosCapability !== 'native') return { saved: false, reason: 'unsupported', message: 'saving to Photos is not available here' };
+    // No watchdog: the first call waits on the OS permission prompt.
+    return this.kit.invoke('share.saveToPhotos', file, { timeoutMs: 'none' });
+  }
+
   // 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> {