@pitcher/js-api 1.27.3 → 1.28.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);
 }
@@ -3519,6 +3764,10 @@ const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	__proto__: null,
 	aiComplete,
 	aiGetCapabilities,
+	appsDbDeleteEntry,
+	appsDbGetEntries,
+	appsDbPsql,
+	appsDbUpsertEntry,
 	assignCanvasTheme,
 	close: close$2,
 	createCanvas: createCanvas$1,
@@ -4148,7 +4397,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 +4462,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 +4473,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");
         }