@pitcher/js-api 1.27.3 → 1.29.0

package/js-api.esm.js

@@ -2511,6 +2511,251 @@ async function piaSearchAnswer(payload) {
   }
 }
 
+const APPS_DB_BASE_PATH = "/core/api/protected/appsdb";
+async function fetchAppsDbContext() {
+  const env = await highLevelApi.API.request("get_env");
+  const claimsDomain = env?.pitcher?.token_claims?.["https://pitcher.com/claims/urls"]?.custom_domain;
+  const metadataDomain = env?.pitcher?.organization?.metadata?.custom_domain;
+  let origin = claimsDomain || metadataDomain || "";
+  if (origin && !origin.startsWith("http")) origin = `https://${origin}`;
+  return {
+    isIos: (env?.mode ?? env?.pitcher?.mode) === "IOS",
+    origin,
+    accessToken: env?.pitcher?.access_token ?? "",
+    instanceId: env?.pitcher?.instance?.id
+  };
+}
+const CONTEXT_TTL_MS = 6e4;
+let contextCache = null;
+function getAppsDbContext() {
+  if (contextCache && Date.now() - contextCache.fetchedAt < CONTEXT_TTL_MS) {
+    return contextCache.promise;
+  }
+  const promise = fetchAppsDbContext();
+  contextCache = { promise, fetchedAt: Date.now() };
+  promise.catch(() => {
+    if (contextCache?.promise === promise) contextCache = null;
+  });
+  return promise;
+}
+async function appsDbRestFetch(ctx, path, init) {
+  const base = ctx.origin || (typeof window !== "undefined" ? window.location.origin : "");
+  const url = new URL(`${base}${APPS_DB_BASE_PATH}${path}`);
+  Object.entries(init.params ?? {}).forEach(([key, value]) => {
+    if (value !== void 0 && value !== null) url.searchParams.set(key, String(value));
+  });
+  const response = await fetch(url.toString(), {
+    method: init.method,
+    credentials: "include",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${ctx.accessToken}`,
+      ...ctx.instanceId ? { "x-instance-id": ctx.instanceId } : {}
+    },
+    ...init.body !== void 0 ? { body: JSON.stringify(init.body) } : {}
+  });
+  if (!response.ok) {
+    let errorBody;
+    try {
+      errorBody = await response.json();
+    } catch {
+      errorBody = void 0;
+    }
+    const error = new Error(
+      `AppsDB request failed: ${response.status}${errorBody?.error ? ` — ${errorBody.error}` : ""}`
+    );
+    error.status = response.status;
+    throw error;
+  }
+  if (response.status === 204 || response.status === 205) return void 0;
+  const text = await response.text();
+  return text ? JSON.parse(text) : void 0;
+}
+function hasErrorCode(error, code) {
+  return error?.error_code === code || error?.errorCode === code || error?.code === code || typeof error?.reason === "string" && error.reason.includes(code) || typeof error?.message === "string" && error.message.includes(code);
+}
+function isTypeNotSyncedError(error) {
+  return hasErrorCode(error, "type_not_synced");
+}
+function isBridgeUnsupportedError(error) {
+  return hasErrorCode(error, "requestTypeDoesNotExists");
+}
+function parsePsqlLiteral(raw) {
+  if (/^'.*'$/.test(raw)) return raw.slice(1, -1).replace(/''/g, "'");
+  if (/^-?\d+(\.\d+)?$/.test(raw)) return Number(raw);
+  if (/^true$/i.test(raw)) return true;
+  if (/^false$/i.test(raw)) return false;
+  if (/^null$/i.test(raw)) return null;
+  return void 0;
+}
+function stripQuotedLiterals(where) {
+  return where.replace(/'(?:[^']|'')*'/g, "''");
+}
+function splitTopLevelAnd(where) {
+  const parts = [];
+  let current = "";
+  let inQuote = false;
+  let i = 0;
+  while (i < where.length) {
+    const char = where[i];
+    if (char === "'") {
+      if (inQuote && where[i + 1] === "'") {
+        current += "''";
+        i += 2;
+        continue;
+      }
+      inQuote = !inQuote;
+      current += char;
+      i += 1;
+      continue;
+    }
+    if (!inQuote) {
+      const separator = where.slice(i).match(/^ AND /i);
+      if (separator) {
+        parts.push(current);
+        current = "";
+        i += separator[0].length;
+        continue;
+      }
+    }
+    current += char;
+    i += 1;
+  }
+  if (inQuote) return null;
+  parts.push(current);
+  return parts;
+}
+function parseSimplePsql(query) {
+  const normalized = query.replace(/\s+/g, " ").trim();
+  const match = normalized.match(/^SELECT \* FROM ([A-Za-z0-9_]+)( WHERE (.+))?$/i);
+  if (!match) return null;
+  const type = match[1];
+  const where = match[3];
+  if (!where) return { type, conditions: [] };
+  if (/\bOR\b|\bNOT\b|\bLIKE\b|\bIN\b|[<>]|!=/i.test(stripQuotedLiterals(where))) return null;
+  const rawConditions = splitTopLevelAnd(where);
+  if (!rawConditions) return null;
+  const conditions = [];
+  for (const part of rawConditions) {
+    const condition = part.trim().match(/^([A-Za-z0-9_.]+) ?= ?(.+)$/);
+    if (!condition) return null;
+    const value = parsePsqlLiteral(condition[2].trim());
+    if (value === void 0) return null;
+    conditions.push({ path: condition[1], value });
+  }
+  return { type, conditions };
+}
+function entryMatches(entry, conditions) {
+  return conditions.every(({ path, value }) => {
+    const actual = path.split(".").reduce((acc, key) => acc == null ? void 0 : acc[key], entry);
+    if (value === null) return actual === null || actual === void 0;
+    if (actual === null || actual === void 0) return false;
+    return String(actual) === String(value);
+  });
+}
+async function appsDbGetEntries(payload) {
+  if (!payload?.type || typeof payload.type !== "string") {
+    return Promise.reject(new Error("type is required and must be a non-empty string"));
+  }
+  const ctx = await getAppsDbContext();
+  if (ctx.isIos) {
+    try {
+      return await highLevelApi.API.request("appsdb_get_entries", payload);
+    } catch (error) {
+      if (!isTypeNotSyncedError(error) && !isBridgeUnsupportedError(error)) throw error;
+    }
+  }
+  return appsDbRestFetch(ctx, "", { method: "GET", params: payload });
+}
+async function appsDbUpsertEntry(payload) {
+  if (!payload?.data || typeof payload.data !== "object") {
+    return Promise.reject(new Error("data is required and must be an object"));
+  }
+  if (!payload.id && !payload.type) {
+    return Promise.reject(new Error("type is required when creating an entry (no id provided)"));
+  }
+  const ctx = await getAppsDbContext();
+  if (ctx.isIos) {
+    try {
+      return await highLevelApi.API.request("appsdb_upsert_entry", payload);
+    } catch (error) {
+      if (!isBridgeUnsupportedError(error)) throw error;
+    }
+  }
+  if (payload.id) {
+    return appsDbRestFetch(ctx, `/${encodeURIComponent(payload.id)}`, { method: "PUT", body: { data: payload.data } });
+  }
+  return appsDbRestFetch(ctx, "", { method: "POST", body: payload });
+}
+async function appsDbDeleteEntry(payload) {
+  if (!payload?.id || typeof payload.id !== "string") {
+    return Promise.reject(new Error("id is required and must be a non-empty string"));
+  }
+  const ctx = await getAppsDbContext();
+  if (ctx.isIos) {
+    try {
+      return await highLevelApi.API.request("appsdb_delete_entry", payload);
+    } catch (error) {
+      if (!isBridgeUnsupportedError(error)) throw error;
+    }
+  }
+  await appsDbRestFetch(ctx, `/${encodeURIComponent(payload.id)}`, { method: "DELETE" });
+}
+async function isDeviceOffline() {
+  try {
+    return Boolean(await highLevelApi.API.request("is_offline"));
+  } catch {
+    return false;
+  }
+}
+const MIRROR_PAGE_LIMIT = 1e3;
+async function psqlFromMirror(parsed) {
+  try {
+    const entries = [];
+    let hasMore = true;
+    while (hasMore) {
+      const result = await highLevelApi.API.request("appsdb_get_entries", {
+        type: parsed.type,
+        limit: MIRROR_PAGE_LIMIT,
+        offset: entries.length
+      });
+      const page = result?.entries ?? [];
+      entries.push(...page);
+      hasMore = Boolean(result?.hasMore) && page.length > 0;
+    }
+    const matched = entries.filter((entry) => entryMatches(entry, parsed.conditions));
+    return { entries: matched, totalCount: matched.length, hasMore: false };
+  } catch (error) {
+    if (isTypeNotSyncedError(error) || isBridgeUnsupportedError(error)) return null;
+    throw error;
+  }
+}
+async function appsDbPsql(payload) {
+  if (!payload?.query || typeof payload.query !== "string") {
+    return Promise.reject(new Error("query is required and must be a non-empty string"));
+  }
+  const ctx = await getAppsDbContext();
+  if (ctx.isIos) {
+    const parsed = parseSimplePsql(payload.query);
+    let mirrorUnavailable = false;
+    if (parsed && await isDeviceOffline()) {
+      const local = await psqlFromMirror(parsed);
+      if (local) return local;
+      mirrorUnavailable = true;
+    }
+    try {
+      return await appsDbRestFetch(ctx, "/psql", { method: "POST", body: payload });
+    } catch (error) {
+      if (parsed && !mirrorUnavailable && error instanceof TypeError) {
+        const local = await psqlFromMirror(parsed);
+        if (local) return local;
+      }
+      throw error;
+    }
+  }
+  return appsDbRestFetch(ctx, "/psql", { method: "POST", body: payload });
+}
+
 function open$2(payload = {}) {
   return this.API.request("open", payload);
 }
@@ -2528,10 +2773,6 @@ function isOffline() {
   return this.API.request("is_offline");
 }
 
-function getLanguages() {
-  return this.API.request("get_languages");
-}
-
 function getCanvases$1(payload) {
   return this.API.request("get_canvases", payload);
 }
@@ -3515,10 +3756,73 @@ function assignCanvasTheme(payload) {
   return this.API.request("assign_canvas_theme", payload);
 }
 
+const STT_ERROR_CODES = [
+  "STT_DISABLED",
+  "STT_DEVICE_UNSUPPORTED",
+  "STT_MODEL_NOT_READY",
+  "STT_BUSY",
+  "STT_MIC_PERMISSION_DENIED",
+  "STT_NOT_RECORDING",
+  "STT_CAPTURE_FAILED",
+  "STT_ERROR"
+];
+function asSttUnsupportedError(error) {
+  const marker = "requestTypeDoesNotExists";
+  const e = error;
+  const isUnsupported = e?.error_code === marker || e?.errorCode === marker || e?.code === marker || typeof e?.reason === "string" && e.reason.includes(marker) || typeof e?.message === "string" && e.message.includes(marker);
+  return isUnsupported ? new Error("STT_DEVICE_UNSUPPORTED: dictation is not supported by this app version") : error;
+}
+function sttStart(payload) {
+  return this.API.request("stt.start", payload).catch((error) => {
+    throw asSttUnsupportedError(error);
+  });
+}
+function sttAvailability() {
+  return this.API.request("stt.availability");
+}
+function sttWarmup() {
+  return this.API.request("stt.warmup");
+}
+function sttStop(payload) {
+  return this.API.request("stt.stop", payload).catch((error) => {
+    throw asSttUnsupportedError(error);
+  });
+}
+function sttErrorCode(error) {
+  const e = error;
+  const direct = e?.code ?? e?.error_code ?? e?.errorCode;
+  if (typeof direct === "string" && STT_ERROR_CODES.includes(direct)) {
+    return direct;
+  }
+  const text = typeof e?.reason === "string" ? e.reason : typeof e?.message === "string" ? e.message : "";
+  return STT_ERROR_CODES.find((code) => text.includes(code));
+}
+
+const TTS_ERROR_CODES = ["TTS_EMPTY_TEXT", "TTS_VOICE_UNAVAILABLE", "TTS_ERROR"];
+function ttsSpeak(payload) {
+  return this.API.request("tts.speak", payload);
+}
+function ttsStop() {
+  return this.API.request("tts.stop");
+}
+function ttsErrorCode(error) {
+  const e = error;
+  const direct = e?.code ?? e?.error_code ?? e?.errorCode;
+  if (typeof direct === "string" && TTS_ERROR_CODES.includes(direct)) {
+    return direct;
+  }
+  const text = typeof e?.reason === "string" ? e.reason : typeof e?.message === "string" ? e.message : "";
+  return TTS_ERROR_CODES.find((code) => text.includes(code));
+}
+
 const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	__proto__: null,
 	aiComplete,
 	aiGetCapabilities,
+	appsDbDeleteEntry,
+	appsDbGetEntries,
+	appsDbPsql,
+	appsDbUpsertEntry,
 	assignCanvasTheme,
 	close: close$2,
 	createCanvas: createCanvas$1,
@@ -3556,7 +3860,6 @@ const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	getFolder,
 	getFolders,
 	getInstanceMetadataTemplates: getInstanceMetadataTemplates$1,
-	getLanguages,
 	getSectionsByIds,
 	getThemes,
 	getUsers: getUsers$1,
@@ -3578,10 +3881,18 @@ const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	shareCanvas,
 	showPeerSession,
 	showSyncbox,
+	sttAvailability,
+	sttErrorCode,
+	sttStart,
+	sttStop,
+	sttWarmup,
 	submitUserFeedback,
 	toast: toast$2,
 	track,
 	triggerNonFilesSync,
+	ttsErrorCode,
+	ttsSpeak,
+	ttsStop,
 	unassignCanvasTheme,
 	updateCanvas: updateCanvas$2,
 	updateCanvasIndicators,
@@ -3698,6 +4009,8 @@ var PitcherEventName = /* @__PURE__ */ ((PitcherEventName2) => {
   PitcherEventName2["SYNC_BADGE_VALUE_REPORTED"] = "sync_badge_value_reported";
   PitcherEventName2["SYNC_BOX_RESOLVE_ERROR_TAPPED"] = "sync_box_resolve_error_tapped";
   PitcherEventName2["PEER_CONNECTIVITY_EVENT"] = "peer_connectivity_event";
+  PitcherEventName2["STT_PARTIAL"] = "stt.partial";
+  PitcherEventName2["STT_INTERRUPTED"] = "stt.interrupted";
   return PitcherEventName2;
 })(PitcherEventName || {});
 var PitcherBroadcastedEventName = /* @__PURE__ */ ((PitcherBroadcastedEventName2) => {
@@ -4148,7 +4461,10 @@ function getTopPitcherWindow(current = window) {
 }
 
 const TRUNCATE_LENGTH_TRIGGER = 10;
+const RAW_RESPONSE_METHODS = ["appsdb_get_entries", "appsdb_upsert_entry", "appsdb_delete_entry"];
 const RAW_PAYLOAD_METHODS = [
+  // AppsDB `data` is an opaque app-owned blob — snake-casing its keys would corrupt stored payloads
+  "appsdb_upsert_entry",
   "crm_create",
   "crm_upsert",
   "crm_describe",
@@ -4210,7 +4526,7 @@ class LowLevelApi extends EventEmitter {
         this.options.logLevel === "debug" && console.log(`Callback ${id} response:`, res);
         if (res.response.status === "ok") {
           resolve(
-            this.options.casing === "camel" ? camelCaseKeys(res.response.body) : res.response.body
+            this.options.casing === "camel" && !RAW_RESPONSE_METHODS.includes(type) ? camelCaseKeys(res.response.body) : res.response.body
           );
           if (type === "get_env") updateOnlineHandlersEnv(res.response.body);
         } else if (res.response.status === "error") {
@@ -4221,7 +4537,9 @@ class LowLevelApi extends EventEmitter {
               js_api_response: JSON.stringify(truncateObject(res, 3, TRUNCATE_LENGTH_TRIGGER))
             });
           }
-          reject(this.options.casing === "camel" ? camelCaseKeys(res.response.body) : res.response.body);
+          reject(
+            this.options.casing === "camel" && !RAW_RESPONSE_METHODS.includes(type) ? camelCaseKeys(res.response.body) : res.response.body
+          );
         } else {
           throw new Error("unsupported response status");
         }