@octane-xplat/platform 0.1.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octane-xplat/platform",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
@@ -16,12 +16,23 @@
     "nativescript-clipboard": "2.1.1"
   },
   "devDependencies": {
+    "@nativescript-community/octane": "0.2.1",
     "@nativescript/core": "9.1.2",
     "octane": "0.4.0"
   },
   "peerDependencies": {
+    "@nativescript-community/octane": ">=0.2.1 <1",
+    "@nativescript/core": ">=9.1.0 <10",
     "octane": ">=0.1.51 <1"
   },
+  "peerDependenciesMeta": {
+    "@nativescript-community/octane": {
+      "optional": true
+    },
+    "@nativescript/core": {
+      "optional": true
+    }
+  },
   "description": "Headless platform capabilities for Octane xplat — web + NativeScript leaf pairs",
   "files": [
     "src"

package/src/clipboard.native.ts

@@ -1,17 +1,30 @@
-// Clipboard — pasteboard via nativescript-clipboard (sync API wrapped async
-// to keep the shared contract awaitable on both sides).
-import { getTextSync, setTextSync } from 'nativescript-clipboard';
+// Core provides native clipboard writes. The plugin remains for reading text,
+// which Core does not expose.
+import { Utils } from '@nativescript/core';
+import { getTextSync } from 'nativescript-clipboard';
 
-export const clipboard = {
-	async write(text: string): Promise<boolean> {
-		setTextSync(text);
+async function writeText(text: string): Promise<boolean> {
+	try {
+		Utils.copyToClipboard(text);
 		return true;
-	},
-	async read(): Promise<string | null> {
-		try {
-			return getTextSync();
-		} catch {
-			return null;
-		}
-	},
+	} catch {
+		return false;
+	}
+}
+
+async function readText(): Promise<string | null> {
+	try {
+		return getTextSync();
+	} catch {
+		return null;
+	}
+}
+
+export const clipboard = {
+	canCopy: true,
+	writeText,
+	readText,
+	// Keep the original names available for existing consumers.
+	write: writeText,
+	read: readText,
 };

package/src/clipboard.web.ts

@@ -1,18 +1,29 @@
-// Clipboard — async permission-gated on web; read may be denied silently.
+// Clipboard — browser support is feature-detected; writes can still be denied
+// by browser policy or permission state.
+const canCopy = typeof navigator !== 'undefined' && typeof navigator.clipboard?.writeText === 'function';
+
+async function writeText(text: string): Promise<boolean> {
+	try {
+		await navigator.clipboard.writeText(text);
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+async function readText(): Promise<string | null> {
+	try {
+		return await navigator.clipboard.readText();
+	} catch {
+		return null;
+	}
+}
+
 export const clipboard = {
-	async write(text: string): Promise<boolean> {
-		try {
-			await navigator.clipboard.writeText(text);
-			return true;
-		} catch {
-			return false;
-		}
-	},
-	async read(): Promise<string | null> {
-		try {
-			return await navigator.clipboard.readText();
-		} catch {
-			return null;
-		}
-	},
+	canCopy,
+	writeText,
+	readText,
+	// Keep the original names available for existing consumers.
+	write: writeText,
+	read: readText,
 };

package/src/files.native.ts

@@ -20,5 +20,11 @@ export const files = {
 		f.writeTextSync(text);
 		return { name, uri: p };
 	},
-	release(_ref: FileRef): void {},
+	release(ref: FileRef): void {
+		const cachePrefix = knownFolders.temp().path + '/';
+		if (!ref.uri.startsWith(cachePrefix)) return;
+		try {
+			File.fromPath(ref.uri).removeSync();
+		} catch {}
+	},
 };

package/src/index.ts

@@ -3,9 +3,20 @@
 // Hook-bearing services live in .tsrx files with .ts shims so tsc's
 // moduleSuffixes can reach them (docs/module-resolution.md).
 export type {
-	AppState, BiometricsImpl, Capability, DeviceInfo, FileRef, HapticsImpl,
-	Insets, Locale, NotificationsImpl, PermissionKind, SecureStore,
-	ShareResult, WindowSize,
+	AppState,
+	BiometricsImpl,
+	Capability,
+	DeviceInfo,
+	FileRef,
+	HapticsImpl,
+	PickedImage,
+	Insets,
+	Locale,
+	NotificationsImpl,
+	PermissionKind,
+	SecureStore,
+	ShareResult,
+	WindowSize,
 } from './types';
 export { device } from './device';
 export { storage } from './storage';

package/src/media.native.ts

@@ -1,15 +1,37 @@
-// Media picking — @nativescript/imagepicker presents the system picker and
-// yields ImageAssets; the FileRef uri is the asset's file path.
-import { create as createImagePicker } from '@nativescript/imagepicker';
-import type { FileRef } from './types';
+// Media picking — store a temporary JPEG for NativeScript Image and return a
+// data URL for APIs that persist image payloads.
+import { create as createImagePicker, ImagePickerMediaType } from '@nativescript/imagepicker';
+import { ImageSource, knownFolders, path } from '@nativescript/core';
+import { files } from './files';
+import type { PickedImage } from './types';
 
 export const media = {
-	async pickImage(): Promise<FileRef | null> {
-		const picker = createImagePicker({ mode: 'single' });
-		await picker.authorize();
-		const [asset] = await picker.present();
-		if (!asset) return null;
-		const uri = (asset as any).ios ?? (asset as any).android ?? '';
-		return { name: 'image', uri: String(uri) };
+	/** Opens the native image picker; returns null when permission is denied or selection is canceled. */
+	async pickImage(): Promise<PickedImage | null> {
+		const picker = createImagePicker({ mode: 'single', mediaType: ImagePickerMediaType.Image });
+		const permission = await picker.authorize();
+		if (!permission.authorized) return null;
+
+		const [selection] = await picker.present();
+		if (!selection) return null;
+
+		const source = await ImageSource.fromAsset(selection.asset);
+		const filename = `octane-image-${Date.now()}-${Math.random().toString(36).slice(2)}.jpg`;
+		const uri = path.join(knownFolders.temp().path, filename);
+		const ref = {
+			name: selection.originalFilename || selection.filename || 'image.jpg',
+			uri,
+		};
+
+		try {
+			const saved = await source.saveToFileAsync(uri, 'jpeg', 85);
+			if (!saved) throw new Error('Could not save the selected image to temporary storage');
+
+			const base64 = await source.toBase64StringAsync('jpeg', 85);
+			return { ...ref, dataUrl: `data:image/jpeg;base64,${base64}` };
+		} catch (error) {
+			files.release(ref);
+			throw error;
+		}
 	},
 };

package/src/media.web.ts

@@ -1,10 +1,30 @@
-// Media picking — web leaf. <input type=file accept="image/*"> → FileRef
-// (object URL). Multi-select stays out of v1.
-import type { FileRef } from './types';
+// Media picking — web leaf. Keep an object URL for previews and a data URL for
+// APIs that persist image payloads. Multi-select stays out of v1.
+import type { PickedImage } from './types';
 import { files } from './files';
 
 export const media = {
-	async pickImage(): Promise<FileRef | null> {
-		return files.pick('image/*');
+	/** Opens the browser image picker; returns null when selection is canceled. */
+	async pickImage(): Promise<PickedImage | null> {
+		const file = await files.pick('image/*');
+		if (!file) return null;
+
+		try {
+			const blob = await (await fetch(file.uri)).blob();
+			const dataUrl = await new Promise<string>((resolve, reject) => {
+				const reader = new FileReader();
+				reader.onload = () => {
+					if (typeof reader.result === 'string') resolve(reader.result);
+					else reject(new Error('Could not read the selected image'));
+				};
+				reader.onerror = () =>
+					reject(reader.error ?? new Error('Could not read the selected image'));
+				reader.readAsDataURL(blob);
+			});
+			return { ...file, dataUrl };
+		} catch (error) {
+			files.release(file);
+			throw error;
+		}
 	},
 };

package/src/types.ts

@@ -40,6 +40,15 @@ export interface FileRef {
 	uri: string;
 }
 
+/**
+ * Result of `media.pickImage()`: a displayable URI and an upload data URL.
+ * Native URIs point to temporary JPEG files; call `files.release()` when the
+ * preview is no longer needed.
+ */
+export interface PickedImage extends FileRef {
+	dataUrl: string;
+}
+
 export interface Locale {
 	tag: string;
 	language: string;