@wix/himalaya-cli 0.1592.0 → 0.1594.0

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

@@ -13,4 +13,56 @@ export declare function getPermissionStatus(): Promise<PermissionStatus>;
 export declare function requestPermission(): Promise<PermissionStatus>;
 /** Search contacts by name (requires read permission). [] when denied/no match. */
 export declare function search(query: string, limit?: number): Promise<Contact[]>;
+/** One labelled phone number or email address. `label` is free text ("work", "mobile"…);
+ *  each host maps the common ones to its native label and keeps the rest as a custom label. */
+export interface ContactField {
+    label?: string;
+    value: string;
+}
+/** A contact to create. At least one of `givenName`, `familyName` or `organization` must be
+ *  non-blank; every list holds at most {@link MAX_CONTACT_ENTRIES} entries. */
+export interface NewContact {
+    givenName?: string;
+    familyName?: string;
+    organization?: string;
+    phones?: ContactField[];
+    emails?: ContactField[];
+    urls?: string[];
+    note?: string;
+}
+/** The most entries `phones`, `emails` or `urls` may carry. */
+export declare const MAX_CONTACT_ENTRIES = 20;
+/** Why a create verb rejected. */
+export type ContactsErrorCode = "invalid_contact" | "permission_denied" | "unavailable";
+/** A create-verb rejection: an `Error` named "ContactsError" carrying a stable `code`. (A plain
+ *  Error, not a subclass — Tier-5 bundles target an engine without class syntax.) Branch on
+ *  `isContactsError(e) && e.code === "permission_denied"`. */
+export interface ContactsError extends Error {
+    name: "ContactsError";
+    code: ContactsErrorCode;
+}
+/** Build a coded contacts rejection. */
+export declare function contactsError(code: ContactsErrorCode, message?: string): ContactsError;
+/** Whether `e` is a coded contacts rejection. */
+export declare function isContactsError(e: unknown): e is ContactsError;
+/** Validate and normalize a {@link NewContact}: strings trimmed, blank entries dropped, blank
+ *  fields omitted. Throws `invalid_contact` when there is no name or organization, or a list
+ *  holds more than {@link MAX_CONTACT_ENTRIES} entries. Every host re-checks the same rules. */
+export declare function normalizeNewContact(contact: NewContact): NewContact;
+/** Open the OS new-contact sheet prefilled with `contact` — the recommended way to save a
+ *  contact: it needs NO contacts permission, because the user reviews and confirms the save.
+ *  Resolves `{ saved: true }` when the user saved it, `{ saved: false }` on cancel. Web
+ *  downloads a `.vcf` instead (and resolves `saved: true` once the download is handed off).
+ *  Rejects `invalid_contact` (see {@link normalizeNewContact}) or `unavailable`. */
+export declare function presentNewContact(contact: NewContact): Promise<{
+    saved: boolean;
+}>;
+/** Write `contact` straight into the address book and resolve its new `id`. Needs contacts
+ *  WRITE permission — ask with {@link requestPermission} first; without it this rejects
+ *  `permission_denied` (it never prompts). Rejects `invalid_contact`, or `unavailable` where
+ *  the host has no address book (web). Prefer {@link presentNewContact} unless the app already
+ *  holds the permission. */
+export declare function add(contact: NewContact): Promise<{
+    id: string;
+}>;
 export declare const version = 1;

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

@@ -9,7 +9,7 @@ export declare const CAPABILITY_REGISTRY: {
     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", "prepareImage", "scanQR"];
     readonly clipboard: readonly ["hasImage", "hasText", "readText", "writeImage", "writeText"];
-    readonly contacts: readonly ["getPermissionStatus", "pick", "requestPermission", "search"];
+    readonly contacts: readonly ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"];
     readonly file_picker: readonly ["pick", "pickDirectoryForExport"];
     readonly files: readonly ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"];
     readonly godot: readonly ["loadPack", "release", "send"];

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

@@ -24,7 +24,7 @@ var CAPABILITY_REGISTRY = {
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
   "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasImage", "hasText", "readText", "writeImage", "writeText"],
-  "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
+  "contacts": ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
   "files": ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"],
   "godot": ["loadPack", "release", "send"],

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

@@ -24,7 +24,7 @@ var CAPABILITY_REGISTRY = {
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
   "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasImage", "hasText", "readText", "writeImage", "writeText"],
-  "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
+  "contacts": ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
   "files": ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"],
   "godot": ["loadPack", "release", "send"],

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

@@ -24,7 +24,7 @@ var CAPABILITY_REGISTRY = {
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
   "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasImage", "hasText", "readText", "writeImage", "writeText"],
-  "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
+  "contacts": ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
   "files": ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"],
   "godot": ["loadPack", "release", "send"],

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

@@ -24,7 +24,7 @@ var CAPABILITY_REGISTRY = {
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
   "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasImage", "hasText", "readText", "writeImage", "writeText"],
-  "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
+  "contacts": ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
   "files": ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"],
   "godot": ["loadPack", "release", "send"],
@@ -86,10 +86,99 @@ async function search(query, limit) {
   const r = await dispatch("capability.contacts.search", params);
   return Array.isArray(r?.items) ? r.items : [];
 }
+var MAX_CONTACT_ENTRIES = 20;
+var CODES = ["invalid_contact", "permission_denied", "unavailable"];
+function contactsError(code, message) {
+  const text = !message ? code : message.startsWith(code) ? message : `${code}: ${message}`;
+  const err = new Error(text);
+  err.name = "ContactsError";
+  err.code = code;
+  return err;
+}
+function isContactsError(e) {
+  return e instanceof Error && e.name === "ContactsError" && CODES.includes(e.code);
+}
+function codeOf(err) {
+  const msg = err instanceof Error ? err.message : String(err ?? "");
+  let best = null;
+  for (const c of CODES) {
+    const m = new RegExp(`(^|[^a-z_])${c}([^a-z_]|$)`).exec(msg);
+    if (!m) continue;
+    const at = m.index + m[1].length;
+    if (!best || at < best.at) best = { code: c, at };
+  }
+  return best?.code ?? null;
+}
+var trimmed = (v) => typeof v === "string" ? v.trim() : "";
+function fields(list, name) {
+  if (list == null) return [];
+  if (!Array.isArray(list)) throw contactsError("invalid_contact", `${name} must be an array`);
+  if (list.length > MAX_CONTACT_ENTRIES) throw contactsError("invalid_contact", `${name} holds more than ${MAX_CONTACT_ENTRIES} entries`);
+  const out = [];
+  for (const entry of list) {
+    const value = trimmed(entry?.value);
+    if (!value) continue;
+    const label = trimmed(entry.label);
+    out.push(label ? { label, value } : { value });
+  }
+  return out;
+}
+function normalizeNewContact(contact) {
+  if (contact == null || typeof contact !== "object") throw contactsError("invalid_contact", "contact must be an object");
+  const out = {};
+  const givenName = trimmed(contact.givenName);
+  const familyName = trimmed(contact.familyName);
+  const organization = trimmed(contact.organization);
+  if (!givenName && !familyName && !organization) {
+    throw contactsError("invalid_contact", "a contact needs a givenName, familyName or organization");
+  }
+  if (givenName) out.givenName = givenName;
+  if (familyName) out.familyName = familyName;
+  if (organization) out.organization = organization;
+  const phones = fields(contact.phones, "phones");
+  if (phones.length) out.phones = phones;
+  const emails = fields(contact.emails, "emails");
+  if (emails.length) out.emails = emails;
+  if (contact.urls != null) {
+    if (!Array.isArray(contact.urls)) throw contactsError("invalid_contact", "urls must be an array");
+    if (contact.urls.length > MAX_CONTACT_ENTRIES) throw contactsError("invalid_contact", `urls holds more than ${MAX_CONTACT_ENTRIES} entries`);
+    const urls = contact.urls.map(trimmed).filter((u) => u.length > 0);
+    if (urls.length) out.urls = urls;
+  }
+  const note = trimmed(contact.note);
+  if (note) out.note = note;
+  return out;
+}
+async function coded(call) {
+  try {
+    return await call();
+  } catch (err) {
+    const code = codeOf(err);
+    if (code) throw contactsError(code, err instanceof Error ? err.message : String(err));
+    throw err;
+  }
+}
+async function presentNewContact(contact) {
+  const wire = { contact: JSON.stringify(normalizeNewContact(contact)) };
+  const r = await coded(() => dispatch("capability.contacts.presentNewContact", wire));
+  return { saved: r?.saved === true };
+}
+async function add(contact) {
+  const wire = { contact: JSON.stringify(normalizeNewContact(contact)) };
+  const r = await coded(() => dispatch("capability.contacts.add", wire));
+  if (typeof r?.id !== "string" || r.id.length === 0) throw contactsError("unavailable", "the host returned no contact id");
+  return { id: r.id };
+}
 var version = 1;
 export {
+  MAX_CONTACT_ENTRIES,
+  add,
+  contactsError,
   getPermissionStatus,
+  isContactsError,
+  normalizeNewContact,
   pick,
+  presentNewContact,
   requestPermission,
   search,
   version

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

@@ -24,7 +24,7 @@ var CAPABILITY_REGISTRY = {
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
   "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasImage", "hasText", "readText", "writeImage", "writeText"],
-  "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
+  "contacts": ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
   "files": ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"],
   "godot": ["loadPack", "release", "send"],

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

@@ -24,7 +24,7 @@ var CAPABILITY_REGISTRY = {
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
   "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasImage", "hasText", "readText", "writeImage", "writeText"],
-  "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
+  "contacts": ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
   "files": ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"],
   "godot": ["loadPack", "release", "send"],

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

@@ -24,7 +24,7 @@ var CAPABILITY_REGISTRY = {
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
   "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasImage", "hasText", "readText", "writeImage", "writeText"],
-  "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
+  "contacts": ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
   "files": ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"],
   "godot": ["loadPack", "release", "send"],

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

@@ -9,7 +9,7 @@ var CAPABILITY_REGISTRY = {
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
   "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasImage", "hasText", "readText", "writeImage", "writeText"],
-  "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
+  "contacts": ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
   "files": ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"],
   "godot": ["loadPack", "release", "send"],

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

@@ -24,7 +24,7 @@ var CAPABILITY_REGISTRY = {
   "calls": ["answer", "availability", "getPermissionStatus", "getState", "hangup", "listCalls", "offer", "receiveSignal", "reject", "requestPermission", "setMuted", "setRingback", "setSpeaker", "signalNext", "signalStart", "signalStop", "start", "subscribeEvents"],
   "camera": ["capture", "pickDocument", "prepareImage", "scanQR"],
   "clipboard": ["hasImage", "hasText", "readText", "writeImage", "writeText"],
-  "contacts": ["getPermissionStatus", "pick", "requestPermission", "search"],
+  "contacts": ["add", "getPermissionStatus", "pick", "presentNewContact", "requestPermission", "search"],
   "file_picker": ["pick", "pickDirectoryForExport"],
   "files": ["download", "export", "list", "readText", "remove", "stat", "storageInfo", "write"],
   "godot": ["loadPack", "release", "send"],