@wix/himalaya-cli 0.1382.0 → 0.1383.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/camera/src/index.d.ts

@@ -1,3 +1,4 @@
+import type { FileHandle } from "@wix/himalaya/sdk-types";
 export type CaptureSource = "camera" | "library";
 export interface CaptureOptions {
     source: CaptureSource;
@@ -34,4 +35,20 @@ export declare function pickDocument(): Promise<PickedDocument | null>;
  * the decoded string, or `null` if the user cancelled / no code was found.
  */
 export declare function scanQR(): Promise<string | null>;
-export declare const version = 1;
+export interface PreparedImage {
+    file: FileHandle;
+    /** Small JPEG preview; full upload bytes stay in the file substrate. */
+    previewUri: string;
+    width: number;
+    height: number;
+}
+/** Normalize a picked substrate image for uploading without moving its full
+ * bytes through the worker. Native hosts decode HEIC/HEIF, apply orientation,
+ * and bound the dimensions/encoded size. Unsupported browser codecs fail
+ * explicitly instead of returning an unpreviewable original. Requires camera
+ * capability version 2; does not present a picker or request camera access. */
+export declare function prepareImage(file: FileHandle, options?: {
+    maxEdgePixels?: number;
+    maxBytes?: number;
+}): Promise<PreparedImage>;
+export declare const version = 2;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/file-picker/src/index.d.ts

@@ -1,17 +1,27 @@
-import type { FileHandle } from "@wix/himalaya/sdk-types";
+import type { FileHandle, FileSelectionRejection, FileSelectionResult } from "@wix/himalaya/sdk-types";
 export type { FileHandle } from "@wix/himalaya/sdk-types";
 export interface FilePickOptions {
     /** Allowed types — UTType identifiers (iOS) or MIME types (Android/web). */
     types?: string[];
     /** Allow selecting multiple documents. */
     multiple?: boolean;
+    /** Rejected before materializing bytes; an unknown provider length is bounded while reading. */
+    maxBytes?: number;
+    /** Optional source-image limit, before host preparation. Defaults to maxBytes. */
+    maxImageBytes?: number;
+    maxItems?: number;
+    maxTotalBytes?: number;
 }
-/** Present the OS document picker. Resolves the picked documents as FileHandles
- *  copied into the substrate, or [] on cancel. */
+export type FilePickRejection = FileSelectionRejection;
+export type FilePickResult = FileSelectionResult;
+/** Detailed bounded selection: valid files survive alongside explicit refusals. */
+export declare function pickDetailed(options?: FilePickOptions): Promise<FilePickResult>;
+/** Present the document picker and return accepted substrate FileHandles, or []
+ *  on cancellation. Use pickDetailed to inspect explicit import refusals. */
 export declare function pick(options?: FilePickOptions): Promise<FileHandle[]>;
 /** Export a substrate file out to a user-chosen location (save/export picker). */
 export declare function pickDirectoryForExport(file: FileHandle | string): Promise<{
     exported: boolean;
 }>;
 /** Capability version, for bundles that gate on min binary version. */
-export declare const version = 1;
+export declare const version = 2;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/files/src/index.d.ts

@@ -37,4 +37,4 @@ export declare function remove(ref: FileHandle | string): Promise<void>;
 /** Stat a path, or `null` if it doesn't exist (the existence check for handles). */
 export declare function stat(path: string): Promise<FileStat | null>;
 /** Capability version, for bundles that gate on min binary version. */
-export declare const version = 1;
+export declare const version = 2;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/photos/src/index.d.ts

@@ -1,13 +1,18 @@
-import type { FileHandle, PermissionStatus } from "@wix/himalaya/sdk-types";
+import type { FileHandle, PermissionStatus, FileSelectionResult } from "@wix/himalaya/sdk-types";
 export type { FileHandle, PermissionStatus } from "@wix/himalaya/sdk-types";
 export interface PickOptions {
     /** Max items to pick (default: platform default, usually 1). */
     limit?: number;
     /** Media kinds to offer. */
     type?: "images" | "videos" | "any";
+    maxBytes?: number;
+    maxTotalBytes?: number;
 }
-/** Present the OS photo picker (no permission). Resolves the picked items as
- *  FileHandles copied into the substrate, or [] on cancel. */
+/** Present the OS photo picker without a permission prompt. Returns substrate
+ *  FileHandles and explicit count/size/total refusals; cancellation returns empty arrays. */
+export declare function pickDetailed(options?: PickOptions): Promise<FileSelectionResult>;
+/** Present the photo picker and return accepted substrate FileHandles, or [] on
+ *  cancellation. Use pickDetailed to inspect explicit import refusals. */
 export declare function pick(options?: PickOptions): Promise<FileHandle[]>;
 /** Save a file (from files/camera/etc.) into the user's photo library. The only
  *  permission-gated method in v1. */
@@ -17,4 +22,4 @@ export declare function saveToLibrary(file: FileHandle | string): Promise<{
 /** Add-to-library permission status (no prompt). `limited` = iOS limited access. */
 export declare function getSavePermissionStatus(): Promise<PermissionStatus>;
 /** Capability version, for bundles that gate on min binary version. */
-export declare const version = 1;
+export declare const version = 2;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/presigned-upload/src/index.d.ts

@@ -62,4 +62,4 @@ export declare function put(url: string, bytes: {
  */
 export declare function putFile(url: string, ref: FileHandle | string, opts?: UploadOptions): Promise<UploadResult>;
 /** Capability version, for bundles that gate on min binary version. */
-export declare const version = 1;
+export declare const version = 2;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/sdk-types/src/capabilities.generated.d.ts

@@ -7,7 +7,7 @@ export declare const CAPABILITY_REGISTRY: {
     readonly browser_auth: readonly ["start"];
     readonly calendar: readonly ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"];
     readonly calls: readonly ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"];
-    readonly camera: readonly ["capture", "pickDocument", "scanQR"];
+    readonly camera: readonly ["capture", "pickDocument", "prepareImage", "scanQR"];
     readonly clipboard: readonly ["hasText", "readText", "writeText"];
     readonly contacts: readonly ["getPermissionStatus", "pick", "requestPermission", "search"];
     readonly file_picker: readonly ["pick", "pickDirectoryForExport"];

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/sdk-types/src/index.d.ts

@@ -15,6 +15,18 @@ export interface FileHandle {
     mimeType: string;
     /** Byte length of the file the handle points at. */
     sizeBytes: number;
+    /** Opaque owner-partition stamp; hosts reject use after an account switch. */
+    ownerScope?: string;
+}
+/** A bounded OS selection can retain valid files while explaining rejected ones. */
+export interface FileSelectionRejection {
+    name: string;
+    mimeType: string;
+    reason: "size" | "count" | "total";
+}
+export interface FileSelectionResult {
+    items: FileHandle[];
+    rejected: FileSelectionRejection[];
 }
 /** OS permission state for a gated capability (the R1 permission triad).
  *  `undetermined` ⇒ not yet asked; `limited` ⇒ a partial grant (iOS limited

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/audio-record.mjs

@@ -22,7 +22,7 @@ var CAPABILITY_REGISTRY = {
   "browser_auth": ["start"],
   "calendar": ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"],
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
-  "camera": ["capture", "pickDocument", "scanQR"],
+  "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasText", "readText", "writeText"],
   "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/calendar.mjs

@@ -22,7 +22,7 @@ var CAPABILITY_REGISTRY = {
   "browser_auth": ["start"],
   "calendar": ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"],
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
-  "camera": ["capture", "pickDocument", "scanQR"],
+  "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasText", "readText", "writeText"],
   "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/calls.mjs

@@ -22,7 +22,7 @@ var CAPABILITY_REGISTRY = {
   "browser_auth": ["start"],
   "calendar": ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"],
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
-  "camera": ["capture", "pickDocument", "scanQR"],
+  "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasText", "readText", "writeText"],
   "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/camera.mjs

@@ -48,10 +48,26 @@ async function scanQR() {
   if (!result || result.cancelled) return null;
   return result.code ?? null;
 }
-var version = 1;
+async function prepareImage(file, options) {
+  const result = await dispatch("capability.camera.prepareImage", {
+    uri: file.uri,
+    name: file.name,
+    mimeType: file.mimeType,
+    ...file.ownerScope ? { ownerScope: file.ownerScope } : {},
+    maxEdgePixels: options?.maxEdgePixels ?? 2048,
+    maxBytes: options?.maxBytes ?? 4 * 1024 * 1024
+  });
+  if (result?.error) throw new Error(`camera.prepareImage: ${result.error}`);
+  if (!result?.file?.uri || typeof result.width !== "number" || typeof result.height !== "number") {
+    throw new Error("camera.prepareImage: native handler returned no prepared image");
+  }
+  return { file: result.file, previewUri: result.previewUri ?? "", width: result.width, height: result.height };
+}
+var version = 2;
 export {
   capturePhoto,
   pickDocument,
+  prepareImage,
   scanQR,
   version
 };

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/contacts.mjs

@@ -22,7 +22,7 @@ var CAPABILITY_REGISTRY = {
   "browser_auth": ["start"],
   "calendar": ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"],
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
-  "camera": ["capture", "pickDocument", "scanQR"],
+  "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasText", "readText", "writeText"],
   "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/file-picker.mjs

@@ -14,21 +14,33 @@ function dispatch(handlerId, params, _options) {
 }
 
 // ../../core/sdk/file-picker/src/index.ts
-async function pick(options) {
+async function pickDetailed(options) {
   const params = {};
-  if (options?.types && options.types.length > 0) params.types = options.types.join(",");
+  if (options?.types?.length) params.types = options.types.join(",");
   if (options?.multiple) params.multiple = "true";
+  for (const key of ["maxBytes", "maxImageBytes", "maxItems", "maxTotalBytes"]) {
+    const n = options?.[key];
+    if (n !== void 0) {
+      if (!Number.isSafeInteger(n) || n <= 0) throw new Error(`file-picker: ${key} must be a positive safe integer`);
+      params[key] = String(n);
+    }
+  }
   const r = await dispatch("capability.file_picker.pick", params);
-  return Array.isArray(r?.items) ? r.items : [];
+  return { items: Array.isArray(r?.items) ? r.items : [], rejected: Array.isArray(r?.rejected) ? r.rejected : [] };
+}
+async function pick(options) {
+  return (await pickDetailed(options)).items;
 }
 async function pickDirectoryForExport(file) {
   const uri = typeof file === "string" ? file : file.uri;
-  const r = await dispatch("capability.file_picker.pickDirectoryForExport", { uri });
+  const ownerScope = typeof file === "string" ? void 0 : file.ownerScope;
+  const r = await dispatch("capability.file_picker.pickDirectoryForExport", { uri, ...ownerScope ? { ownerScope } : {} });
   return { exported: r?.exported === true };
 }
-var version = 1;
+var version = 2;
 export {
   pick,
+  pickDetailed,
   pickDirectoryForExport,
   version
 };

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/files.mjs

@@ -26,7 +26,8 @@ function toHandle(r, fallbackPath) {
     uri: r?.uri ?? fallbackPath,
     name: r?.name ?? basename(fallbackPath),
     mimeType: r?.mimeType ?? "application/octet-stream",
-    sizeBytes: typeof r?.sizeBytes === "number" ? r.sizeBytes : 0
+    sizeBytes: typeof r?.sizeBytes === "number" ? r.sizeBytes : 0,
+    ...r?.ownerScope ? { ownerScope: r.ownerScope } : {}
   };
 }
 async function write(path, content, opts) {
@@ -38,11 +39,11 @@ async function write(path, content, opts) {
   return toHandle(r, path);
 }
 async function readText(ref) {
-  const r = await dispatch("capability.files.readText", { uri: refToPath(ref) });
+  const r = await dispatch("capability.files.readText", { uri: refToPath(ref), ...typeof ref !== "string" && ref.ownerScope ? { ownerScope: ref.ownerScope } : {} });
   return r?.text ?? "";
 }
 async function readBase64(ref) {
-  const r = await dispatch("capability.files.readBase64", { uri: refToPath(ref) });
+  const r = await dispatch("capability.files.readBase64", { uri: refToPath(ref), ...typeof ref !== "string" && ref.ownerScope ? { ownerScope: ref.ownerScope } : {} });
   if (r?.error) throw new Error(`files.readBase64: ${r.error}`);
   return r?.base64 ?? "";
 }
@@ -51,13 +52,16 @@ async function list(dirPath) {
   return Array.isArray(r?.items) ? r.items : [];
 }
 async function remove(ref) {
-  await dispatch("capability.files.remove", { uri: refToPath(ref) });
+  await dispatch("capability.files.remove", {
+    uri: refToPath(ref),
+    ...typeof ref !== "string" && ref.ownerScope ? { ownerScope: ref.ownerScope } : {}
+  });
 }
 async function stat(path) {
   const r = await dispatch("capability.files.stat", { path });
   return r?.stat ?? null;
 }
-var version = 1;
+var version = 2;
 export {
   list,
   readBase64,

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/location.mjs

@@ -22,7 +22,7 @@ var CAPABILITY_REGISTRY = {
   "browser_auth": ["start"],
   "calendar": ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"],
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
-  "camera": ["capture", "pickDocument", "scanQR"],
+  "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasText", "readText", "writeText"],
   "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/motion.mjs

@@ -22,7 +22,7 @@ var CAPABILITY_REGISTRY = {
   "browser_auth": ["start"],
   "calendar": ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"],
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
-  "camera": ["capture", "pickDocument", "scanQR"],
+  "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasText", "readText", "writeText"],
   "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/photos.mjs

@@ -22,7 +22,7 @@ var CAPABILITY_REGISTRY = {
   "browser_auth": ["start"],
   "calendar": ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"],
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
-  "camera": ["capture", "pickDocument", "scanQR"],
+  "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasText", "readText", "writeText"],
   "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
@@ -68,25 +68,37 @@ function normalizePermissionStatus(s) {
 function toHandles(items) {
   return Array.isArray(items) ? items : [];
 }
-async function pick(options) {
+async function pickDetailed(options) {
   const params = { type: options?.type ?? "images" };
   if (typeof options?.limit === "number") params.limit = options.limit;
+  for (const key of ["maxBytes", "maxTotalBytes"]) {
+    const n = options?.[key];
+    if (n !== void 0) {
+      if (!Number.isSafeInteger(n) || n <= 0) throw new Error(`photos: ${key} must be a positive safe integer`);
+      params[key] = n;
+    }
+  }
   const r = await dispatch("capability.photos.pick", params);
-  return toHandles(r?.items);
+  return { items: toHandles(r?.items), rejected: Array.isArray(r?.rejected) ? r.rejected : [] };
+}
+async function pick(options) {
+  return (await pickDetailed(options)).items;
 }
 async function saveToLibrary(file) {
   const uri = typeof file === "string" ? file : file.uri;
-  const r = await dispatch("capability.photos.saveToLibrary", { uri });
+  const ownerScope = typeof file === "string" ? void 0 : file.ownerScope;
+  const r = await dispatch("capability.photos.saveToLibrary", { uri, ...ownerScope ? { ownerScope } : {} });
   return { saved: r?.saved === true };
 }
 async function getSavePermissionStatus() {
   const r = await dispatch("capability.photos.getSavePermissionStatus");
   return normalizePermissionStatus(r?.status);
 }
-var version = 1;
+var version = 2;
 export {
   getSavePermissionStatus,
   pick,
+  pickDetailed,
   saveToLibrary,
   version
 };

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/presigned-upload.mjs

@@ -41,12 +41,13 @@ async function putFile(url, ref, opts) {
     await dispatch("capability.presigned_upload.putFile", {
       url: url ?? "",
       uri: typeof ref === "string" ? ref : ref?.uri ?? "",
+      ...typeof ref !== "string" && ref?.ownerScope ? { ownerScope: ref.ownerScope } : {},
       contentType: opts?.contentType ?? "",
       method: opts?.method ?? "PUT"
     })
   );
 }
-var version = 1;
+var version = 2;
 export {
   MAX_INLINE_BASE64_BYTES,
   MAX_UPLOAD_BYTES,

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/sdk-types.mjs

@@ -7,7 +7,7 @@ var CAPABILITY_REGISTRY = {
   "browser_auth": ["start"],
   "calendar": ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"],
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
-  "camera": ["capture", "pickDocument", "scanQR"],
+  "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasText", "readText", "writeText"],
   "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/share.mjs

@@ -21,6 +21,9 @@ async function share(options) {
   if (options.subject) params.subject = options.subject;
   if (options.files && options.files.length > 0) {
     params.files = JSON.stringify(options.files.map((f) => f.uri));
+    if (options.files.some((f) => f.ownerScope)) {
+      params.fileOwners = JSON.stringify(options.files.map((f) => f.ownerScope ?? ""));
+    }
   }
   const r = await dispatch("capability.share.share", params);
   return { completed: r?.completed === true };

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/tasks.mjs

@@ -22,7 +22,7 @@ var CAPABILITY_REGISTRY = {
   "browser_auth": ["start"],
   "calendar": ["createEvent", "deleteEvent", "getPermissionStatus", "listEvents", "requestPermission", "updateEvent"],
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
-  "camera": ["capture", "pickDocument", "scanQR"],
+  "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasText", "readText", "writeText"],
   "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],