roamjs-components 0.85.1 → 0.86.0-alpha.2

package/src/queries/getAllBlockUidsAndTexts.ts

@@ -0,0 +1,6 @@
+const getAllBlockUidsAndTexts = (): { uid: string; text: string }[] =>
+  window.roamAlphaAPI
+    .q(`[:find ?u ?s :where [?e :block/uid ?u] [?e :block/string ?s]]`)
+    .map((f) => ({ uid: f[0] as string, text: f[1] as string }));
+
+export default getAllBlockUidsAndTexts;

package/src/queries/getAllPageNames.ts

@@ -0,0 +1,6 @@
+const getAllPageNames = (): string[] =>
+  window.roamAlphaAPI
+    .q("[:find ?s :where [?e :node/title ?s]]")
+    .map((b) => b[0] as string);
+
+export default getAllPageNames;

package/src/queries/getAttributeValueByBlockAndName.ts

@@ -0,0 +1,23 @@
+import { PullBlock } from "../types";
+import normalizePageTitle from "./normalizePageTitle";
+
+const getAttributeValueByBlockAndName = ({
+  name,
+  uid,
+}: {
+  name: string;
+  uid: string;
+}) =>
+  (
+    (
+      window.roamAlphaAPI.data.fast.q(
+        `[:find (pull ?b [:block/string]) :where [?a :node/title "${normalizePageTitle(
+          name
+        )}"] [?p :block/uid "${uid}"] [?b :block/refs ?a] [?b :block/parents ?p]]`
+      )?.[0]?.[0] as PullBlock
+    )?.[":block/string"] || ""
+  )
+    .slice(name.length + 2)
+    .trim();
+
+export default getAttributeValueByBlockAndName;

package/src/queries/getBasicTreeByParentUid.ts

@@ -0,0 +1,21 @@
+import { PullBlock, RoamBasicNode } from "../types";
+
+const sortBasicNodes = (c: PullBlock[]): RoamBasicNode[] =>
+  c
+    .sort((a, b) => (a[":block/order"] || 0) - (b[":block/order"] || 0))
+    .map((node) => ({
+      children: sortBasicNodes(node[":block/children"] || []),
+      uid: node[":block/uid"] || "",
+      text: node[":block/string"] || "",
+    }));
+
+const getBasicTreeByParentUid = (uid: string): RoamBasicNode[] =>
+  sortBasicNodes(
+    window.roamAlphaAPI.data.fast
+      .q(
+        `[:find (pull ?c [:block/string :block/uid :block/order {:block/children ...}]) :where [?b :block/uid "${uid}"] [?b :block/children ?c]]`
+      )
+      .map((a) => a[0] as PullBlock)
+  );
+
+export default getBasicTreeByParentUid;

package/src/queries/getBlockUidAndTextIncludingText.ts

@@ -0,0 +1,15 @@
+import { PullBlock } from "../types";
+
+const getBlockUidAndTextIncludingText = (
+  t: string
+): { uid: string; text: string }[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?block [:block/uid :block/string]) :where [?block :block/string ?contents] [(clojure.string/includes? ?contents  "${t}")]]`
+    ) as [PullBlock][]
+  ).map(([block]) => ({
+    uid: block[":block/uid"] || "",
+    text: block[":block/string"] || "",
+  }));
+
+export default getBlockUidAndTextIncludingText;

package/src/queries/getBlockUidByTextOnPage.ts

@@ -0,0 +1,12 @@
+const getBlockUidByTextOnPage = ({
+  text,
+  title,
+}: {
+  text: string;
+  title: string;
+}): string =>
+  (window.roamAlphaAPI.q(
+    `[:find ?u :where [?b :block/page ?p] [?b :block/uid ?u] [?b :block/string "${text}"] [?p :node/title "${title}"]]`
+  )?.[0]?.[0] as string) || "";
+
+export default getBlockUidByTextOnPage;

package/src/queries/getBlockUidsAndTextsReferencingPage.ts

@@ -0,0 +1,18 @@
+import { PullBlock } from "../types";
+import normalizePageTitle from "./normalizePageTitle";
+
+const getBlockUidsAndTextsReferencingPage = (
+  title: string
+): { uid: string; text: string }[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?r [:block/uid :block/string]) :where [?p :node/title "${normalizePageTitle(
+        title
+      )}"] [?r :block/refs ?p]]`
+    ) as [PullBlock][]
+  ).map(([node]) => ({
+    uid: node[":block/uid"] || "",
+    text: node[":block/string"] || "",
+  }));
+
+export default getBlockUidsAndTextsReferencingPage;

package/src/queries/getBlockUidsByPageTitle.ts

@@ -0,0 +1,12 @@
+import normalizePageTitle from "./normalizePageTitle";
+
+const getBlockUidsByPageTitle = (title: string): string[] =>
+  window.roamAlphaAPI
+    .q(
+      `[:find ?u :where  [?b :block/uid ?u] [?b :block/page ?e] [?e :node/title "${normalizePageTitle(
+        title
+      )}"]]`
+    )
+    .map((b) => b[0] as string);
+
+export default getBlockUidsByPageTitle;

package/src/queries/getBlockUidsReferencingBlock.ts

@@ -0,0 +1,10 @@
+import { PullBlock } from "../types";
+
+const getBlockUidsReferencingBlock = (uid: string): string[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?r [:block/uid]) :where [?b :block/uid "${uid}"] [?r :block/refs ?b]]`
+    ) as [PullBlock][]
+  ).map((s) => s[0][":block/uid"] || "");
+
+export default getBlockUidsReferencingBlock;

package/src/queries/getBlockUidsReferencingPage.ts

@@ -0,0 +1,13 @@
+import { PullBlock } from "../types";
+import normalizePageTitle from "./normalizePageTitle";
+
+const getBlockUidsReferencingPage = (title: string): string[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?r [:block/uid]) :where [?p :node/title "${normalizePageTitle(
+        title
+      )}"] [?r :block/refs ?p]]`
+    ) as [PullBlock][]
+  ).map((s) => s[0][":block/uid"] || "");
+
+export default getBlockUidsReferencingPage;

package/src/queries/getBlockUidsWithParentUid.ts

@@ -0,0 +1,10 @@
+
+
+const getBlockUidsWithParentUid = (uid: string): string[] =>
+  window.roamAlphaAPI
+    .q(
+      `[:find ?u :where [?c :block/uid ?u] [?c :block/parents ?b] [?b :block/uid "${uid}"]]`
+    )
+    .map((r) => r[0] as string);
+
+export default getBlockUidsWithParentUid;

package/src/queries/getChildrenLengthByPageUid.ts

@@ -0,0 +1,7 @@
+// @deprecated - use getChildrenLengthByParentUid instead
+const getChildrenLengthByPageUid = (uid: string): number =>
+  window.roamAlphaAPI.pull("[:block/children]", [":block/uid", uid])?.[
+    ":block/children"
+  ]?.length || 0;
+
+export default getChildrenLengthByPageUid;

package/src/queries/getChildrenLengthByParentUid.ts

@@ -0,0 +1,6 @@
+const getChildrenLengthByPageUid = (uid: string): number =>
+  window.roamAlphaAPI.pull("[:block/children]", [":block/uid", uid])?.[
+    ":block/children"
+  ]?.length || 0;
+
+export default getChildrenLengthByPageUid;

package/src/queries/getCreateTimeByBlockUid.ts

@@ -0,0 +1,6 @@
+const getCreateTimeByBlockUid = (uid: string): number =>
+  window.roamAlphaAPI.pull(`[:edit/time]`, [":block/uid", uid])?.[
+    ":create/time"
+  ] || 0;
+
+export default getCreateTimeByBlockUid;

package/src/queries/getCurrentUser.ts

@@ -0,0 +1,12 @@
+const getCurrentUser = (): string[] => {
+  const globalAppState = JSON.parse(
+    localStorage.getItem("globalAppState") || '["","",[]]'
+  ) as (string | string[])[];
+  const userIndex = globalAppState.findIndex((s) => s === "~:user");
+  if (userIndex > 0) {
+    return globalAppState[userIndex + 1] as string[];
+  }
+  return [];
+};
+
+export default getCurrentUser;

package/src/queries/getCurrentUserDisplayName.ts

@@ -0,0 +1,9 @@
+import getCurrentUserUid from "./getCurrentUserUid";
+import getDisplayNameByUid from "./getDisplayNameByUid";
+
+const getCurrentUserDisplayName = (): string => {
+  const uid = getCurrentUserUid();
+  return getDisplayNameByUid(uid);
+};
+
+export default getCurrentUserDisplayName;

package/src/queries/getCurrentUserEmail.ts

@@ -0,0 +1,12 @@
+import getCurrentUser from "./getCurrentUser";
+
+const getCurrentUserEmail = (): string => {
+  const userArray = getCurrentUser();
+  const emailIndex = userArray.findIndex((s) => s === "~:email");
+  if (emailIndex > 0) {
+    return userArray[emailIndex + 1];
+  }
+  return "";
+};
+
+export default getCurrentUserEmail;

package/src/queries/getCurrentUserUid.ts

@@ -0,0 +1,12 @@
+import getCurrentUser from "./getCurrentUser";
+
+const getCurrentUserUid = (): string => {
+  const userArray = getCurrentUser();
+  const uidIndex = userArray.findIndex((s) => s === "~:uid");
+  if (uidIndex > 0) {
+    return userArray[uidIndex + 1];
+  }
+  return "";
+};
+
+export default getCurrentUserUid;

package/src/queries/getDisplayNameByEmail.ts

@@ -0,0 +1,6 @@
+const getDisplayNameByEmail = (email: string): string =>
+  (window.roamAlphaAPI.q(
+    `[:find ?name :where[?e :user/display-name ?name] [?e :user/email "${email}"]]`
+  )?.[0]?.[0] as string) || "";
+
+export default getDisplayNameByEmail;

package/src/queries/getDisplayNameByUid.ts

@@ -0,0 +1,6 @@
+const getDisplayNameByUid = (uid: string): string =>
+  (window.roamAlphaAPI.q(
+    `[:find ?s :where [?e :user/uid "${uid}"] [?e :user/display-page ?p] [?p :node/title ?s]]`
+  )?.[0]?.[0] as string) || "";
+
+export default getDisplayNameByUid;

package/src/queries/getEditTimeByBlockUid.ts

@@ -0,0 +1,6 @@
+const getEditTimeByBlockUid = (uid: string): number =>
+  window.roamAlphaAPI.pull(`[:edit/time]`, [":block/uid", uid])?.[
+    ":edit/time"
+  ] || 0;
+
+export default getEditTimeByBlockUid;

package/src/queries/getEditedUserEmailByBlockUid.ts

@@ -0,0 +1,6 @@
+const getEditedUserEmailByBlockUid = (blockUid: string): string =>
+  (window.roamAlphaAPI.q(
+    `[:find ?e :where [?u :user/email ?e] [?b :edit/user ?u] [?b :block/uid "${blockUid}"]]`
+  )?.[0]?.[0] as string) || "";
+
+export default getEditedUserEmailByBlockUid;

package/src/queries/getFirstChildTextByBlockUid.ts

@@ -0,0 +1,8 @@
+
+
+const getFirstChildTextByBlockUid = (blockUid: string): string =>
+  window.roamAlphaAPI.q(
+    `[:find ?s :where [?c :block/string ?s] [?c :block/order 0] [?p :block/children ?c] [?p :block/uid "${blockUid}"]]`
+  )?.[0]?.[0] as string;
+
+export default getFirstChildTextByBlockUid;

package/src/queries/getFirstChildUidByBlockUid.ts

@@ -0,0 +1,6 @@
+import getNthChildUidByBlockUid from "./getNthChildUidByBlockUid";
+
+const getFirstChildUidByBlockUid = (blockUid: string): string =>
+  getNthChildUidByBlockUid({ blockUid, order: 0 });
+
+export default getFirstChildUidByBlockUid;

package/src/queries/getFullTreeByParentUid.ts

@@ -0,0 +1,60 @@
+import type { PullBlock, TreeNode, ViewType } from "../types";
+
+const formatRoamNode = (n: PullBlock | null): TreeNode => {
+  if (!n)
+    return {
+      text: "",
+      open: true,
+      order: 0,
+      uid: "",
+      children: [],
+      parents: [],
+      heading: 0,
+      viewType: "bullet",
+      editTime: new Date(0),
+      props: { imageResize: {}, iframe: {} },
+      textAlign: "left",
+    };
+  const viewType =
+    ((n[":block/parents"] || [])
+      .find((a) => typeof a[":children/view-type"] === "string")
+      ?.[":children/view-type"]?.replace?.(/^:/, "") as ViewType) || "bullet";
+  return {
+    text: n[":block/string"] || n[":node/title"] || "",
+    open: typeof n[":block/open"] === "undefined" ? true : n[":block/open"],
+    order: n[":block/order"] || 0,
+    uid: n[":block/uid"] || "",
+    heading: n[":block/heading"] || 0,
+    viewType,
+    editTime: new Date(n[":edit/time"] || 0),
+    props: { imageResize: {}, iframe: {} },
+    textAlign: n[":block/text-align"] || "left",
+    children: (n[":block/children"] || [])
+      .sort((a, b) => (a[":block/order"] || 0) - (b[":block/order"] || 0))
+      .map(formatRoamNode),
+    parents: (n[":block/parents"] || []).map((n) => n?.[":db/id"] || 0),
+  };
+};
+
+const getFullTreeByParentUid = (uid: string): TreeNode =>
+  formatRoamNode(
+    window.roamAlphaAPI.pull(
+      `[
+      :block/string 
+      :node/title 
+      :block/uid 
+      :block/order 
+      :block/heading 
+      :block/open 
+      :children/view-type
+      :block/text-align
+      :edit/time 
+      :block/props
+      {:block/parents [:children/view-type]}
+      {:block/children ...}
+    ]`,
+      [`:block/uid`, uid]
+    )
+  );
+
+export default getFullTreeByParentUid;

package/src/queries/getLinkedPageTitlesUnderUid.ts

@@ -0,0 +1,8 @@
+const getLinkedPageTitlesUnderUid = (uid: string): string[] =>
+  window.roamAlphaAPI
+    .q(
+      `[:find ?t :where [?r :node/title ?t] [?c :block/refs ?r] [?c :block/parents ?b] [?b :block/uid "${uid}"]]`
+    )
+    .map((r) => r[0] as string);
+
+export default getLinkedPageTitlesUnderUid;

package/src/queries/getNthChildUidByBlockUid.ts

@@ -0,0 +1,16 @@
+import type { PullBlock } from "../types/native";
+
+const getNthChildUidByBlockUid = ({
+  blockUid,
+  order,
+}: {
+  blockUid: string;
+  order: number;
+}): string =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?c [:block/uid]) :where [?p :block/uid "${blockUid}"] [?p :block/children ?c] [?c :block/order ${order}] ]`
+    )?.[0]?.[0] as PullBlock
+  )?.[":block/uid"] || "";
+
+export default getNthChildUidByBlockUid;

package/src/queries/getOrderByBlockUid.ts

@@ -0,0 +1,6 @@
+const getOrderByBlockUid = (blockUid: string): number =>
+  window.roamAlphaAPI.q(
+    `[:find ?o :where [?r :block/order ?o] [?r :block/uid "${blockUid}"]]`
+  )?.[0]?.[0] as number;
+
+export default getOrderByBlockUid;

package/src/queries/getPageTitleByBlockUid.ts

@@ -0,0 +1,8 @@
+const getPageTitleByBlockUid = (blockUid: string): string =>
+  (
+    window.roamAlphaAPI.q(
+      `[:find (pull ?p [:node/title]) :where [?e :block/uid "${blockUid}"] [?e :block/page ?p]]`
+    )?.[0]?.[0] as { title?: string }
+  )?.title || "";
+
+export default getPageTitleByBlockUid;

package/src/queries/getPageTitleByPageUid.ts

@@ -0,0 +1,11 @@
+import { PullBlock } from "../types";
+
+export const getPageTitleByPageUid = (pageUid: string): string =>
+  (
+    window.roamAlphaAPI.pull(`[:node/title]`, [
+      ":block/uid",
+      pageUid,
+    ]) as PullBlock
+  )?.[":node/title"] || "";
+
+export default getPageTitleByPageUid;

package/src/queries/getPageTitleReferencesByPageTitle.ts

@@ -0,0 +1,13 @@
+import { PullBlock } from "../types";
+import normalizePageTitle from "./normalizePageTitle";
+
+const getPageTitleReferencesByPageTitle = (title: string): string[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?b [:node/title]) :where [?r :node/title "${normalizePageTitle(
+        title
+      )}"] [?c :block/refs ?r] [?c :block/page ?b]]`
+    ) as [PullBlock][]
+  ).map((p) => p[0][":node/title"] as string);
+
+export default getPageTitleReferencesByPageTitle;

package/src/queries/getPageTitlesAndBlockUidsReferencingPage.ts

@@ -0,0 +1,18 @@
+import { PullBlock } from "../types";
+import normalizePageTitle from "./normalizePageTitle";
+
+const getPageTitlesAndBlockUidsReferencingPage = (
+  pageName: string
+): { title: string; uid: string }[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?pr [:node/title]) (pull ?r [:block/uid]) :where [?p :node/title "${normalizePageTitle(
+        pageName
+      )}"] [?r :block/refs ?p] [?r :block/page ?pr]]`
+    ) as [PullBlock, PullBlock][]
+  ).map(([pr, r]) => ({
+    title: pr?.[":node/title"] || "",
+    uid: r?.[":block/uid"] || "",
+  }));
+
+export default getPageTitlesAndBlockUidsReferencingPage;

package/src/queries/getPageTitlesAndUidsDirectlyReferencingPage.ts

@@ -0,0 +1,18 @@
+import { PullBlock } from "../types";
+import normalizePageTitle from "./normalizePageTitle";
+
+const getPageTitlesAndUidsDirectlyReferencingPage = (
+  pageName: string
+): { title: string; uid: string }[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?r [:node/title :block/uid]) :where [?p :node/title "${normalizePageTitle(
+        pageName
+      )}"] [?r :block/refs ?p]]`
+    ) as [PullBlock][]
+  ).map(([block]) => ({
+    title: block[":node/title"] || "",
+    uid: block[":block/uid"] || "",
+  }));
+
+export default getPageTitlesAndUidsDirectlyReferencingPage;

package/src/queries/getPageTitlesReferencingBlockUid.ts

@@ -0,0 +1,10 @@
+import { PullBlock } from "../types";
+
+const getPageTitlesReferencingBlockUid = (uid: string): string[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?p [:node/title]) :where [?r :block/uid "${uid}"] [?b :block/refs ?r] [?b :block/page ?p]]`
+    ) as [PullBlock][]
+  ).map((s) => s[0]?.[":node/title"] || "");
+
+export default getPageTitlesReferencingBlockUid;

package/src/queries/getPageTitlesStartingWithPrefix.ts

@@ -0,0 +1,8 @@
+const getPageTitlesStartingWithPrefix = (prefix: string): string[] =>
+  window.roamAlphaAPI
+    .q(
+      `[:find ?title :where [?b :node/title ?title] [(clojure.string/starts-with? ?title  "${prefix}")]]`
+    )
+    .map((r) => r[0] as string);
+
+export default getPageTitlesStartingWithPrefix;

package/src/queries/getPageUidByBlockUid.ts

@@ -0,0 +1,8 @@
+const getPageUidByBlockUid = (blockUid: string): string =>
+  (
+    window.roamAlphaAPI.q(
+      `[:find (pull ?p [:block/uid]) :where [?e :block/uid "${blockUid}"] [?e :block/page ?p]]`
+    )?.[0]?.[0] as { uid?: string }
+  )?.uid || "";
+
+export default getPageUidByBlockUid;

package/src/queries/getPageUidByPageTitle.ts

@@ -0,0 +1,10 @@
+const getPageUidByPageTitle = (title: string): string => {
+  if (!title) return "";
+  return (
+    window.roamAlphaAPI.pull("[:block/uid]", [":node/title", title])?.[
+      ":block/uid"
+    ] || ""
+  );
+};
+
+export default getPageUidByPageTitle;

package/src/queries/getPageViewType.ts

@@ -0,0 +1,11 @@
+import normalizePageTitle from "./normalizePageTitle";
+import type { ViewType } from "../types";
+
+const getPageViewType = (title: string): ViewType =>
+  (window.roamAlphaAPI.q(
+    `[:find ?v :where [?e :children/view-type ?v] [?e :node/title "${normalizePageTitle(
+      title
+    )}"]]`
+  )?.[0]?.[0] as ViewType) || "bullet";
+
+export default getPageViewType;

package/src/queries/getParentTextByBlockUid.ts

@@ -0,0 +1,6 @@
+const getParentTextByBlockUid = (blockUid: string): string =>
+  (window.roamAlphaAPI.q(
+    `[:find ?s :where [?e :block/uid "${blockUid}"] [?p :block/children ?e] [?p :block/string ?s]]`
+  )?.[0]?.[0] as string) || "";
+
+export default getParentTextByBlockUid;

package/src/queries/getParentTextByBlockUidAndTag.ts

@@ -0,0 +1,12 @@
+const getParentTextByBlockUidAndTag = ({
+  blockUid,
+  tag,
+}: {
+  blockUid: string;
+  tag: string;
+}): string =>
+  (window.roamAlphaAPI.q(
+    `[:find ?s :where [?t :node/title "${tag}"] [?p :block/refs ?t] [?p :block/string ?s] [?b :block/parents ?p] [?b :block/uid "${blockUid}"]]`
+  )?.[0]?.[0] as string) || "";
+
+export default getParentTextByBlockUidAndTag;

package/src/queries/getParentUidByBlockUid.ts

@@ -0,0 +1,10 @@
+import type { PullBlock } from "../types/native";
+
+const getParentUidByBlockUid = (blockUid: string): string =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?p [:block/uid]) :where [?e :block/uid "${blockUid}"] [?p :block/children ?e]]`
+    )?.[0]?.[0] as PullBlock
+  )?.[":block/uid"] || "";
+
+export default getParentUidByBlockUid;

package/src/queries/getParentUidsOfBlockUid.ts

@@ -0,0 +1,10 @@
+import type { PullBlock } from "../types";
+
+const getParentUidsOfBlockUid = (uid: string): string[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?p [:block/uid]) :where [?b :block/uid "${uid}"] [?b :block/parents ?p] ]`
+    ) as [PullBlock][]
+  ).map((r) => r[0][":block/uid"] || "");
+
+export default getParentUidsOfBlockUid;

package/src/queries/getSettingsByEmail.ts

@@ -0,0 +1,8 @@
+import type { UserSettings } from "../types";
+
+const getSettingsByEmail = (email: string): UserSettings =>
+  (window.roamAlphaAPI.q(
+    `[:find ?settings :where[?e :user/settings ?settings] [?e :user/email "${email}"]]`
+  )?.[0]?.[0] as UserSettings) || {};
+
+export default getSettingsByEmail;

package/src/queries/getShallowTreeByParentUid.ts

@@ -0,0 +1,17 @@
+import { PullBlock } from "../types";
+
+const getShallowTreeByParentUid = (
+  parentUid: string
+): { uid: string; text: string }[] =>
+  (
+    window.roamAlphaAPI.data.fast.q(
+      `[:find (pull ?c [:block/uid :block/string :block/order]) :where [?b :block/uid "${parentUid}"] [?b :block/children ?c]]`
+    ) as [PullBlock][]
+  )
+    .sort((a, b) => (a[0][":block/order"] || 0) - (b[0][":block/order"] || 0))
+    .map(([a]) => ({
+      uid: a[":block/uid"] || "",
+      text: a[":block/string"] || "",
+    }));
+
+export default getShallowTreeByParentUid;

package/src/queries/getTextByBlockUid.ts

@@ -0,0 +1,8 @@
+const getTextByBlockUid = (uid = ""): string =>
+  (uid &&
+    window.roamAlphaAPI.pull("[:block/string]", [":block/uid", uid])?.[
+      ":block/string"
+    ]) ||
+  "";
+
+export default getTextByBlockUid;

package/src/queries/index.ts

@@ -0,0 +1,5 @@
+throw new Error(
+  `Do not import from roamjs-components/queries directly. Instead import the *query* you need directly. For example: 
+    
+  import getTextByBlockUid from "roamjs-components/queries/getTextByBlockUid;"`
+);

package/src/queries/isLiveBlock.ts

@@ -0,0 +1,4 @@
+const isLiveBlock = (uid: string) =>
+  !!window.roamAlphaAPI.pull("[:db/id]", [":block/uid", uid]);
+
+export default isLiveBlock;

package/src/queries/isTagOnPage.ts

@@ -0,0 +1,12 @@
+import normalizePageTitle from "./normalizePageTitle";
+
+const isTagOnPage = ({ tag, title }: { tag: string; title: string }): boolean =>
+  !!window.roamAlphaAPI.q(
+    `[:find ?r :where [?r :node/title "${normalizePageTitle(
+      tag
+    )}"] [?b :block/refs ?r] [?b :block/page ?p] [?p :node/title "${normalizePageTitle(
+      title
+    )}"]]`
+  )?.[0]?.[0];
+
+export default isTagOnPage;

package/src/queries/normalizePageTitle.ts

@@ -0,0 +1,4 @@
+const normalizePageTitle = (title: string): string =>
+  title.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+
+export default normalizePageTitle;

package/src/scripts/index.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("@samepage/scripts/cli");