@wix/himalaya-cli 0.1292.0 → 0.1293.0

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

@@ -11,4 +11,39 @@ export declare function postToPage(msg: unknown): void;
  * The latest registered handler wins. Call this once during the bundle's setup.
  */
 export declare function onPageMessage(cb: (msg: unknown) => void): void;
+export interface PageCapabilityRequest {
+    v: 1;
+    id: string;
+    capability: string;
+    method: string;
+    args: unknown[];
+}
+export interface PageCapabilityResponse {
+    v: 1;
+    id: string;
+    ok: boolean;
+    result?: unknown;
+    error?: {
+        message: string;
+        code?: string;
+    };
+}
+export interface ExposedPageCapability {
+    module: Record<string, unknown>;
+    methods: readonly string[];
+}
+/**
+ * Expose selected typed @himalaya/* modules to the hosting page.
+ *
+ * The worker author must pass both the imported module and its explicit verb allowlist:
+ *
+ *   import * as health from "@wix/himalaya/health";
+ *   exposeCapabilitiesToPage({
+ *     health: { module: health, methods: ["availability", "query"] },
+ *   });
+ *
+ * The bundle still has to declare `webview` plus every exposed capability. Importing only
+ * selected modules keeps native permissions and `himi dist` additions opt-in.
+ */
+export declare function exposeCapabilitiesToPage(capabilities: Readonly<Record<string, ExposedPageCapability>>): void;
 export declare const version = 1;

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

@@ -0,0 +1,88 @@
+import type * as AppInfoSdk from "@wix/himalaya/app-info";
+import type * as AudioRecordSdk from "@wix/himalaya/audio-record";
+import type * as Base44Sdk from "@wix/himalaya/base44";
+import type * as BiometricsSdk from "@wix/himalaya/biometrics";
+import type * as BrowserAuthSdk from "@wix/himalaya/browser-auth";
+import type * as CalendarSdk from "@wix/himalaya/calendar";
+import type * as CallsSdk from "@wix/himalaya/calls";
+import type * as CameraSdk from "@wix/himalaya/camera";
+import type * as ClipboardSdk from "@wix/himalaya/clipboard";
+import type * as ContactsSdk from "@wix/himalaya/contacts";
+import type * as FilePickerSdk from "@wix/himalaya/file-picker";
+import type * as FilesSdk from "@wix/himalaya/files";
+import type * as GodotSdk from "@wix/himalaya/godot";
+import type * as HapticSdk from "@wix/himalaya/haptic";
+import type * as HealthSdk from "@wix/himalaya/health";
+import type * as HimiAppsSdk from "@wix/himalaya/himi-apps";
+import type * as IapSdk from "@wix/himalaya/iap";
+import type * as KeyboardSdk from "@wix/himalaya/keyboard";
+import type * as LiveActivitySdk from "@wix/himalaya/live-activity";
+import type * as LocalDatabaseSdk from "@wix/himalaya/local-db";
+import type * as LocationSdk from "@wix/himalaya/location";
+import type * as MediaPlaybackSdk from "@wix/himalaya/media-playback";
+import type * as MotionSdk from "@wix/himalaya/motion";
+import type * as OnDeviceAiSdk from "@wix/himalaya/on-device-ai";
+import type * as OpenUrlSdk from "@wix/himalaya/open-url";
+import type * as PdfSdk from "@wix/himalaya/pdf";
+import type * as PhotosSdk from "@wix/himalaya/photos";
+import type * as PresignedUploadSdk from "@wix/himalaya/presigned-upload";
+import type * as PushSdk from "@wix/himalaya/push";
+import type * as ReleaseControlSdk from "@wix/himalaya/release-control";
+import type * as SecureStorageSdk from "@wix/himalaya/secure-storage";
+import type * as ShareSdk from "@wix/himalaya/share";
+import type * as SpeakerDiarizationSdk from "@wix/himalaya/speaker-diarization";
+import type * as SpeechSdk from "@wix/himalaya/speech";
+import type * as SystemIntentsSdk from "@wix/himalaya/system-intents";
+import type * as TasksSdk from "@wix/himalaya/tasks";
+import type * as UiSdk from "@wix/himalaya/ui";
+import type * as WixCashierSdk from "@wix/himalaya/wix-cashier";
+type PageModule<T> = {
+    readonly [P in keyof T as T[P] extends (...args: any[]) => any ? P : T[P] extends readonly unknown[] ? never : T[P] extends object ? keyof PageModule<T[P]> extends never ? never : P : never]: T[P] extends (...args: infer A) => infer R ? (...args: A) => R : T[P] extends readonly unknown[] ? never : T[P] extends object ? PageModule<T[P]> : never;
+};
+/** Every typed request/response capability a trusted WebView page can ask its companion worker for.
+ * Availability is still opt-in: the worker imports a subset and its logic-bundle manifest declares
+ * that same subset; every other namespace/method is ignored. */
+export interface HimalayaPageCapabilities {
+    readonly "app_info": PageModule<typeof AppInfoSdk>;
+    readonly "audio_record": PageModule<typeof AudioRecordSdk>;
+    readonly "base44": PageModule<typeof Base44Sdk>;
+    readonly "biometrics": PageModule<typeof BiometricsSdk>;
+    readonly "browser_auth": PageModule<typeof BrowserAuthSdk>;
+    readonly "calendar": PageModule<typeof CalendarSdk>;
+    readonly "calls": PageModule<typeof CallsSdk>;
+    readonly "camera": PageModule<typeof CameraSdk>;
+    readonly "clipboard": PageModule<typeof ClipboardSdk>;
+    readonly "contacts": PageModule<typeof ContactsSdk>;
+    readonly "file_picker": PageModule<typeof FilePickerSdk>;
+    readonly "files": PageModule<typeof FilesSdk>;
+    readonly "godot": PageModule<typeof GodotSdk>;
+    readonly "haptic": PageModule<typeof HapticSdk>;
+    readonly "health": PageModule<typeof HealthSdk>;
+    readonly "himi_apps": PageModule<typeof HimiAppsSdk>;
+    readonly "iap": PageModule<typeof IapSdk>;
+    readonly "keyboard": PageModule<typeof KeyboardSdk>;
+    readonly "live_activity": PageModule<typeof LiveActivitySdk>;
+    readonly "local_database": PageModule<typeof LocalDatabaseSdk>;
+    readonly "location": PageModule<typeof LocationSdk>;
+    readonly "media_playback": PageModule<typeof MediaPlaybackSdk>;
+    readonly "motion": PageModule<typeof MotionSdk>;
+    readonly "on_device_ai": PageModule<typeof OnDeviceAiSdk>;
+    readonly "open_url": PageModule<typeof OpenUrlSdk>;
+    readonly "pdf": PageModule<typeof PdfSdk>;
+    readonly "photos": PageModule<typeof PhotosSdk>;
+    readonly "presigned_upload": PageModule<typeof PresignedUploadSdk>;
+    readonly "push": PageModule<typeof PushSdk>;
+    readonly "release_control": PageModule<typeof ReleaseControlSdk>;
+    readonly "secure_storage": PageModule<typeof SecureStorageSdk>;
+    readonly "share": PageModule<typeof ShareSdk>;
+    readonly "speaker_diarization": PageModule<typeof SpeakerDiarizationSdk>;
+    readonly "speech": PageModule<typeof SpeechSdk>;
+    readonly "system_intents": PageModule<typeof SystemIntentsSdk>;
+    readonly "tasks": PageModule<typeof TasksSdk>;
+    readonly "ui": PageModule<typeof UiSdk>;
+    readonly "wix_cashier": PageModule<typeof WixCashierSdk>;
+}
+export type HimalayaPageSdk = HimalayaPageCapabilities & {
+    readonly version: 1;
+};
+export {};

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

@@ -0,0 +1,68 @@
+import type { HimalayaPageSdk } from "./capabilities.generated.js";
+export type { HimalayaPageCapabilities, HimalayaPageSdk } from "./capabilities.generated.js";
+export interface WebViewPageRequest {
+    v: 1;
+    id: string;
+    capability: string;
+    method: string;
+    args: unknown[];
+}
+export interface WebViewPageError {
+    message: string;
+    code?: string;
+}
+export interface WebViewPageResponse {
+    v: 1;
+    id: string;
+    ok: boolean;
+    result?: unknown;
+    error?: WebViewPageError;
+}
+/** Invoke one method through the companion worker. Primarily useful to generated bindings. */
+export declare function call<T>(capability: string, method: string, args?: unknown[], timeoutMs?: number): Promise<T>;
+/**
+ * Typed SDK proxy for every request/response capability in CAPABILITY_REGISTRY.
+ * A namespace is usable only when this screen's companion worker explicitly imported and
+ * exposed it and the bundle + host both declared it.
+ */
+export declare const himalaya: HimalayaPageSdk;
+/** Convenience named export; equivalent to `himalaya.health`. */
+export declare const health: {
+    readonly healthError: (code: import("@wix/himalaya/health").HealthErrorCode, message: string) => import("@wix/himalaya/health").HealthError;
+    readonly isHealthError: (e: unknown) => boolean;
+    readonly availability: () => Promise<import("@wix/himalaya/health").HealthAvailability>;
+    readonly requestPermission: (p: {
+        read: import("@wix/himalaya/health").HealthType[];
+        write?: import("@wix/himalaya/health").HealthWriteType[];
+    }) => Promise<{
+        granted: import("@wix/himalaya/health").HealthType[];
+    }>;
+    readonly getPermissionStatus: (p: {
+        types: import("@wix/himalaya/health").HealthType[];
+    }) => Promise<Record<import("@wix/himalaya/health").HealthType, import("@wix/himalaya/health").HealthPermissionState>>;
+    readonly query: (p: import("@wix/himalaya/health").HealthQuery) => Promise<{
+        samples: import("@wix/himalaya/health").HealthSample[];
+    }>;
+    readonly saveWorkout: (w: import("@wix/himalaya/health").Workout) => Promise<{
+        id: string;
+    }>;
+    readonly health: {
+        readonly availability: () => Promise<import("@wix/himalaya/health").HealthAvailability>;
+        readonly requestPermission: (p: {
+            read: import("@wix/himalaya/health").HealthType[];
+            write?: import("@wix/himalaya/health").HealthWriteType[];
+        }) => Promise<{
+            granted: import("@wix/himalaya/health").HealthType[];
+        }>;
+        readonly getPermissionStatus: (p: {
+            types: import("@wix/himalaya/health").HealthType[];
+        }) => Promise<Record<import("@wix/himalaya/health").HealthType, import("@wix/himalaya/health").HealthPermissionState>>;
+        readonly query: (p: import("@wix/himalaya/health").HealthQuery) => Promise<{
+            samples: import("@wix/himalaya/health").HealthSample[];
+        }>;
+        readonly saveWorkout: (w: import("@wix/himalaya/health").Workout) => Promise<{
+            id: string;
+        }>;
+    };
+};
+export declare const version = 1;

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

@@ -0,0 +1,88 @@
+// ../../core/sdk/webview-page/src/index.ts
+var pending = /* @__PURE__ */ new Map();
+var installedOn;
+var nextId = 1;
+function workerBridge() {
+  const bridge = globalThis.HimalayaWorker;
+  if (!bridge || typeof bridge.post !== "function" || typeof bridge.onMessage !== "function") {
+    throw new Error(
+      "@himalaya/webview-page: this page is not inside a worker-backed Himalaya WebView."
+    );
+  }
+  if (installedOn !== bridge) {
+    bridge.onMessage(receive);
+    installedOn = bridge;
+  }
+  return bridge;
+}
+function isResponse(value) {
+  if (!value || typeof value !== "object") return false;
+  const r = value;
+  return r.v === 1 && typeof r.id === "string" && typeof r.ok === "boolean";
+}
+function receive(message) {
+  if (!isResponse(message)) return;
+  const call2 = pending.get(message.id);
+  if (!call2) return;
+  pending.delete(message.id);
+  clearTimeout(call2.timeout);
+  if (message.ok) {
+    call2.resolve(message.result);
+    return;
+  }
+  const error = new Error(message.error?.message ?? "Himalaya capability call failed");
+  if (message.error?.code) Object.assign(error, { code: message.error.code });
+  call2.reject(error);
+}
+function call(capability, method, args = [], timeoutMs = 3e4) {
+  const bridge = workerBridge();
+  const id = `page-${Date.now().toString(36)}-${nextId++}`;
+  const request = { v: 1, id, capability, method, args };
+  return new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      pending.delete(id);
+      reject(new Error(`Himalaya capability call timed out: ${capability}.${method}`));
+    }, timeoutMs);
+    pending.set(id, { resolve, reject, timeout });
+    if (!bridge.post(request)) {
+      clearTimeout(timeout);
+      pending.delete(id);
+      reject(new Error("@himalaya/webview-page: the native page-to-worker bridge refused the request."));
+    }
+  });
+}
+var members = /* @__PURE__ */ new Map();
+function pageMember(capability, path) {
+  const key = `${capability}:${path.join(".")}`;
+  let member = members.get(key);
+  if (member) return member;
+  member = new Proxy(function() {
+  }, {
+    get(_target, property) {
+      if (typeof property !== "string" || property === "then") return void 0;
+      return pageMember(capability, [...path, property]);
+    },
+    apply(_target, _thisArg, args) {
+      if (path.length === 0) throw new Error(`Himalaya capability namespace is not callable: ${capability}`);
+      return call(capability, path.join("."), args);
+    }
+  });
+  members.set(key, member);
+  return member;
+}
+var himalaya = new Proxy({ version: 1 }, {
+  get(target, property) {
+    if (property === "version") return target.version;
+    if (typeof property !== "string" || property === "then") return void 0;
+    return pageMember(property, []);
+  }
+});
+var health = himalaya.health;
+var version = 1;
+export {
+  call,
+  health,
+  himalaya,
+  version
+};
+//# sourceMappingURL=webview-page.mjs.map

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

@@ -14,8 +14,51 @@ function postToPage(msg) {
 function onPageMessage(cb) {
   runtime().onPageMessage(cb);
 }
+function pageRequest(value) {
+  if (!value || typeof value !== "object") return null;
+  const request = value;
+  if (request.v !== 1 || typeof request.id !== "string" || !/^[A-Za-z0-9-]{1,96}$/.test(request.id) || typeof request.capability !== "string" || !/^[a-z][a-z0-9_]{0,63}$/.test(request.capability) || typeof request.method !== "string" || !/^[A-Za-z][A-Za-z0-9_]{0,63}(?:\.[A-Za-z][A-Za-z0-9_]{0,63}){0,3}$/.test(request.method) || !Array.isArray(request.args) || request.args.length > 12) return null;
+  return request;
+}
+function pageError(value) {
+  if (!(value instanceof Error)) return { message: "Himalaya capability call failed" };
+  const code = value.code;
+  return {
+    message: value.message,
+    ...typeof code === "string" && code ? { code } : {}
+  };
+}
+function exposeCapabilitiesToPage(capabilities) {
+  const allowed = new Map(
+    Object.entries(capabilities).map(([id, entry]) => [id, {
+      module: entry.module,
+      methods: new Set(entry.methods)
+    }])
+  );
+  onPageMessage((message) => {
+    const request = pageRequest(message);
+    if (!request) return;
+    const capability = allowed.get(request.capability);
+    let candidate = capability?.module;
+    let receiver = void 0;
+    for (const segment of request.method.split(".")) {
+      if (!candidate || typeof candidate !== "object" || !Object.prototype.hasOwnProperty.call(candidate, segment)) {
+        candidate = void 0;
+        break;
+      }
+      receiver = candidate;
+      candidate = candidate[segment];
+    }
+    if (!capability || !capability.methods.has(request.method) || typeof candidate !== "function") return;
+    void Promise.resolve().then(() => candidate.apply(receiver, request.args)).then(
+      (result) => postToPage({ v: 1, id: request.id, ok: true, result }),
+      (error) => postToPage({ v: 1, id: request.id, ok: false, error: pageError(error) })
+    );
+  });
+}
 var version = 1;
 export {
+  exposeCapabilitiesToPage,
   onPageMessage,
   postToPage,
   version

package/dist/authoring-runtime/node_modules/@wix/himalaya/package.json

@@ -246,6 +246,10 @@
       "types": "./dist/_types/core/sdk/webview/src/index.d.ts",
       "import": "./dist/webview.mjs"
     },
+    "./webview-page": {
+      "types": "./dist/_types/core/sdk/webview-page/src/index.d.ts",
+      "import": "./dist/webview-page.mjs"
+    },
     "./widget": {
       "types": "./dist/_types/core/sdk/widget/src/index.d.ts",
       "import": "./dist/widget.mjs"