jazz-tools 0.14.27 → 0.15.0

package/src/expo/index.ts

@@ -0,0 +1,6 @@
+export * from "jazz-tools/react-native-core";
+
+export * from "./provider.js";
+export * from "./storage/expo-secure-store-adapter.js";
+export * from "./storage/expo-sqlite-adapter.js";
+export * from "./auth/clerk/index.js";

package/src/expo/provider.tsx

@@ -0,0 +1,29 @@
+import {
+  Account,
+  AccountClass,
+  AnyAccountSchema,
+  CoValueFromRaw,
+} from "jazz-tools";
+import {
+  JazzProviderCore,
+  JazzProviderProps,
+} from "jazz-tools/react-native-core";
+import React, { useMemo } from "react";
+import { ExpoSecureStoreAdapter } from "./storage/expo-secure-store-adapter.js";
+import { ExpoSQLiteAdapter } from "./storage/expo-sqlite-adapter.js";
+
+export function JazzExpoProvider<
+  S extends
+    | (AccountClass<Account> & CoValueFromRaw<Account>)
+    | AnyAccountSchema,
+>(props: JazzProviderProps<S>) {
+  const storage = useMemo(() => {
+    return props.storage ?? new ExpoSQLiteAdapter();
+  }, [props.storage]);
+
+  const kvStore = useMemo(() => {
+    return props.kvStore ?? new ExpoSecureStoreAdapter();
+  }, [props.kvStore]);
+
+  return <JazzProviderCore {...props} storage={storage} kvStore={kvStore} />;
+}

package/src/expo/storage/expo-secure-store-adapter.ts

@@ -0,0 +1,29 @@
+import * as SecureStore from "expo-secure-store";
+import type { KvStore } from "jazz-tools/react-native-core";
+
+export class ExpoSecureStoreAdapter implements KvStore {
+  async get(key: string): Promise<string | null> {
+    return SecureStore.getItemAsync(key, {
+      requireAuthentication: false,
+      keychainAccessible: SecureStore.AFTER_FIRST_UNLOCK,
+    });
+  }
+
+  async set(key: string, value: string): Promise<void> {
+    return SecureStore.setItemAsync(key, value, {
+      requireAuthentication: false,
+      keychainAccessible: SecureStore.AFTER_FIRST_UNLOCK,
+    });
+  }
+
+  async delete(key: string): Promise<void> {
+    return SecureStore.deleteItemAsync(key, {
+      requireAuthentication: false,
+      keychainAccessible: SecureStore.AFTER_FIRST_UNLOCK,
+    });
+  }
+
+  async clearAll(): Promise<void> {
+    throw new Error("Not implemented");
+  }
+}

package/src/expo/storage/expo-sqlite-adapter.ts

@@ -0,0 +1,94 @@
+import { deleteDatabaseAsync, openDatabaseAsync } from "expo-sqlite";
+import type { SQLiteBindValue, SQLiteDatabase } from "expo-sqlite";
+import { type SQLiteDatabaseDriverAsync } from "jazz-tools/react-native-core";
+
+export class ExpoSQLiteAdapter implements SQLiteDatabaseDriverAsync {
+  private db: SQLiteDatabase | null = null;
+  private dbName: string;
+
+  public constructor(dbName: string = "jazz-storage") {
+    this.dbName = dbName;
+  }
+
+  public async initialize(): Promise<void> {
+    if (this.db) {
+      return;
+    }
+
+    const db = await openDatabaseAsync(this.dbName, {
+      useNewConnection: true,
+    });
+    await db.execAsync("PRAGMA journal_mode = WAL");
+    this.db = db;
+  }
+
+  public async query<T>(sql: string, params?: unknown[]): Promise<T[]> {
+    if (!this.db) {
+      throw new Error("Database not initialized");
+    }
+
+    const result = await this.db.getAllAsync(
+      sql,
+      params?.map((p) => p as SQLiteBindValue) ?? [],
+    );
+
+    return result as T[];
+  }
+
+  public async get<T>(sql: string, params?: unknown[]): Promise<T | undefined> {
+    if (!this.db) {
+      throw new Error("Database not initialized");
+    }
+
+    const result = await this.db.getFirstAsync(
+      sql,
+      params?.map((p) => p as SQLiteBindValue) ?? [],
+    );
+
+    return (result as T) ?? undefined;
+  }
+
+  public async run(sql: string, params?: unknown[]) {
+    if (!this.db) {
+      throw new Error("Database not initialized");
+    }
+
+    await this.db.runAsync(sql, params?.map((p) => p as SQLiteBindValue) ?? []);
+  }
+
+  public async transaction(callback: () => unknown) {
+    if (!this.db) {
+      throw new Error("Database not initialized");
+    }
+
+    await this.db.withTransactionAsync(async () => {
+      await callback();
+    });
+  }
+
+  /**
+   * Deletes and re-initialises the database.
+   * Dropping every table would not account for internal data, such as PRAGMAs, so deletion is required to completely clear the database.
+   */
+  public async clearLocalData(): Promise<void> {
+    if (!this.db) {
+      throw new Error("Database not initialized");
+    }
+
+    // We must close the database before attempting to delete it.
+    // However, this may fail if the database was already closed; if so, we can still proceed to deletion.
+    try {
+      await this.db.closeAsync();
+    } catch (e) {
+      console.error(e);
+    }
+
+    await deleteDatabaseAsync(this.dbName);
+    this.db = null;
+    await this.initialize();
+  }
+
+  public async closeDb(): Promise<void> {
+    // Keeping the database open and reusing the same connection over multiple ctx instances.
+  }
+}

package/src/expo/testing.ts

@@ -0,0 +1 @@
+export * from "jazz-tools/react-native-core/testing";

package/src/index.ts

@@ -1,3 +1 @@
-export * from "./exports.js";
-
-export { MAX_RECOMMENDED_TX_SIZE, cojsonInternals } from "cojson";
+export * from "./tools/index.js";

package/src/inspector/custom-element.tsx

@@ -0,0 +1,63 @@
+import { Account } from "jazz-tools";
+import { JazzInspectorInternal } from "jazz-tools/inspector";
+import { createRoot } from "react-dom/client";
+
+export class JazzInspectorElement extends HTMLElement {
+  private root: ReturnType<typeof createRoot> | null = null;
+
+  account: Account | null = null;
+
+  private interval: ReturnType<typeof setInterval> | undefined;
+
+  loadAccount() {
+    try {
+      const value = Account.getMe();
+
+      if (value !== this.account) {
+        this.account = value;
+        this.render();
+      }
+    } catch {}
+  }
+
+  startAccountPolling() {
+    if (this.interval) return;
+
+    this.loadAccount();
+
+    this.interval = setInterval(() => {
+      this.loadAccount();
+    }, 1000);
+  }
+
+  stopAccountPolling() {
+    if (this.interval) clearInterval(this.interval);
+  }
+
+  connectedCallback() {
+    this.root = createRoot(this);
+    this.startAccountPolling();
+    this.render();
+  }
+
+  disconnectedCallback() {
+    this.root?.unmount();
+    this.root = null;
+    this.stopAccountPolling();
+  }
+
+  private render() {
+    if (!this.account) {
+      return;
+    }
+
+    this.root?.render(
+      <JazzInspectorInternal
+        localNode={this.account._raw.core.node}
+        accountId={this.account._raw.id}
+      />,
+    );
+  }
+}
+
+customElements.define("jazz-inspector", JazzInspectorElement);

package/src/inspector/index.ts

@@ -0,0 +1,23 @@
+import React from "react";
+
+export { JazzInspector, JazzInspectorInternal } from "./viewer/new-app.js";
+export { PageStack } from "./viewer/page-stack.js";
+export { Breadcrumbs } from "./viewer/breadcrumbs.js";
+export { AccountOrGroupText } from "./viewer/account-or-group-text.js";
+
+export { Button } from "./ui/button.js";
+export { Input } from "./ui/input.js";
+export { Select } from "./ui/select.js";
+export { Icon } from "./ui/icon.js";
+export { GlobalStyles } from "./ui/global-styles.js";
+
+export {
+  resolveCoValue,
+  useResolvedCoValue,
+} from "./viewer/use-resolve-covalue.js";
+
+export type { PageInfo } from "./viewer/types.js";
+
+import { setup } from "goober";
+
+setup(React.createElement);

package/src/inspector/register-custom-element.ts

@@ -0,0 +1,3 @@
+if (typeof window !== "undefined" && process.env.NODE_ENV === "development") {
+  import("./custom-element.js");
+}

package/src/inspector/ui/badge.tsx

@@ -0,0 +1,20 @@
+import { styled } from "goober";
+
+const StyledBadge = styled("span")<{ className?: string }>`
+  font-size: 0.875rem;
+  font-weight: 500;
+  padding: 0.125rem 0.25rem;
+  margin-left: -0.125rem;
+  border-radius: var(--j-radius-sm);
+  background-color: var(--j-foreground);
+  display: inline-block;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  color: var(--j-text-color-strong);
+`;
+
+export function Badge({
+  children,
+  className,
+}: React.PropsWithChildren<{ className?: string }>) {
+  return <StyledBadge className={className}>{children}</StyledBadge>;
+}

package/src/inspector/ui/button.tsx

@@ -0,0 +1,81 @@
+import { styled } from "goober";
+import { forwardRef } from "react";
+
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+  variant?: "primary" | "secondary" | "link" | "plain";
+  children?: React.ReactNode;
+  className?: string;
+  disabled?: boolean;
+}
+
+const StyledButton = styled("button")<{ variant: string; disabled?: boolean }>`
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  text-align: center;
+  transition: colors 0.2s;
+  border-radius: var(--j-radius-lg);
+  pointer-events: ${(props) => (props.disabled ? "none" : "auto")};
+  opacity: ${(props) => (props.disabled ? 0.5 : 1)};
+  cursor: ${(props) => (props.disabled ? "not-allowed" : "pointer")};
+
+  ${(props) => {
+    switch (props.variant) {
+      case "primary":
+        return `
+          padding: 0.375rem 0.75rem;
+          background-color: var(--j-primary-color);
+          border-color: var(--j-primary-color);
+          color: white;
+          font-weight: 500;
+        `;
+      case "secondary":
+        return `
+          padding: 0.375rem 0.75rem;
+          color: var(--j-text-color-strong);
+          border: 1px solid var(--j-border-color);
+          font-weight: 500;
+          &:hover {
+            border-color: var(--j-border-color-hover);
+          }
+        `;
+      case "link":
+        return `
+          color: var(--j-link-color);
+          &:hover {
+            text-decoration: underline;
+          }
+        `;
+      default:
+        return "";
+    }
+  }}
+`;
+
+export const Button = forwardRef<HTMLButtonElement, ButtonProps>(
+  (
+    {
+      className,
+      children,
+      variant = "primary",
+      disabled,
+      type = "button",
+      ...buttonProps
+    },
+    ref,
+  ) => {
+    return (
+      <StyledButton
+        ref={ref}
+        {...buttonProps}
+        disabled={disabled}
+        className={className}
+        type={type}
+        variant={variant}
+      >
+        {children}
+      </StyledButton>
+    );
+  },
+);

package/src/inspector/ui/card.tsx

@@ -0,0 +1,23 @@
+import { styled } from "goober";
+export const Card = styled("div")`
+  background-color: var(--j-background);
+  border-radius: var(--j-radius-lg);
+  box-shadow: var(--j-shadow-sm);
+  border: 1px solid var(--j-border-color);
+  padding: 1rem;
+  text-align: left;
+  overflow-x: hidden;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+`;
+
+export const CardHeader = styled("div")`
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+`;
+
+export const CardBody = styled("div")`
+  flex: 1;
+`;

package/src/inspector/ui/global-styles.tsx

@@ -0,0 +1,74 @@
+import { styled } from "goober";
+
+export const GlobalStyles = styled("div")`
+  /* Colors */
+  --j-primary-color: #146AFF;
+  --j-link-color: var(--j-primary-color);
+  --j-success-color: oklch(52.7% 0.154 150.069);
+  --j-destructive-color: oklch(50.5% 0.213 27.518);
+  
+  /* Neutral Colors */
+  --j-neutral-100: #faf8f8;
+  --j-neutral-200: #e5e3e4;
+  --j-neutral-300: #d0cecf;
+  --j-neutral-400: #bbbaba;
+  --j-neutral-500: #a8a6a6;
+  --j-neutral-600: #858484;
+  --j-neutral-700: #6b696a;
+  --j-neutral-900: #2f2e2e;
+  --j-neutral-925: #1b1a1a;
+  --j-neutral-950: #151414;
+  
+  /* Text Colors */
+  --j-text-color: var(--j-neutral-700);
+  --j-text-color-strong: var(--j-neutral-900);
+
+  /* Border Colors */
+  --j-border-color: var(--j-neutral-200);
+  --j-border-color-hover: var(--j-neutral-300);
+  --j-border-dark: var(--j-neutral-900);
+  --j-border-focus: var(--j-primary-color);
+
+  /* Background Colors */
+  --j-background: #FFFFFF;
+  --j-foreground: var(--j-neutral-100);
+
+  /* Border Radius */
+  --j-radius-sm: 0.25rem;
+  --j-radius-md: 0.375rem;
+  --j-radius-lg: 0.5rem;
+
+  /* Shadows */
+  --j-shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+
+  @media (prefers-color-scheme: dark) {
+    --j-text-color: var(--j-neutral-400);
+    --j-border-color: var(--j-neutral-900);
+    --j-background: var(--j-neutral-950);
+    --j-foreground: var(--j-neutral-925);
+    --j-border-color-hover: var(--j-neutral-700);
+    --j-text-color-strong: var(--j-neutral-100);
+    --j-success-color: oklch(72.3% 0.219 149.579);
+    --j-destructive-color: oklch(63.7% 0.237 25.331);
+  }
+  
+  *:focus {
+    outline: none;
+  }
+  
+  *:focus-visible {
+    box-shadow: 0 0 0 2px var(--j-link-color);
+  }
+  
+  .j-sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
+`;

package/src/inspector/ui/grid.tsx

@@ -0,0 +1,48 @@
+import { styled } from "goober";
+
+const GridThreeColumns = styled("div")`
+  display: grid;
+  grid-template-columns: repeat(1, minmax(0, 1fr));
+  gap: 1rem;
+  
+  @media (min-width: 768px) {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+  
+  @media (min-width: 1280px) {
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+  }
+`;
+
+const GridTwoColumns = styled("div")`
+  display: grid;
+  grid-template-columns: repeat(1, minmax(0, 1fr));
+  gap: 1rem;
+  
+  @media (min-width: 768px) {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+`;
+
+const GridOneColumn = styled("div")`
+  display: grid;
+  grid-template-columns: repeat(1, minmax(0, 1fr));
+  gap: 1rem;
+`;
+
+export function Grid(
+  props: React.HTMLAttributes<HTMLElement> & { cols: 1 | 2 | 3 },
+) {
+  const { cols, children, ...rest } = props;
+
+  switch (cols) {
+    case 1:
+      return <GridOneColumn {...rest}>{children}</GridOneColumn>;
+    case 2:
+      return <GridTwoColumns {...rest}>{children}</GridTwoColumns>;
+    case 3:
+      return <GridThreeColumns {...rest}>{children}</GridThreeColumns>;
+    default:
+      throw new Error(`Invalid number of columns: ${cols}`);
+  }
+}

package/src/inspector/ui/heading.tsx

@@ -0,0 +1,15 @@
+import { styled } from "goober";
+
+const StyledHeading = styled("h1")<{ className?: string }>`
+  font-size: 1.125rem;
+  text-align: center;
+  font-weight: 500;
+  color: var(--j-text-color-strong);
+`;
+
+export function Heading({
+  children,
+  className,
+}: React.PropsWithChildren<{ className?: string }>) {
+  return <StyledHeading className={className}>{children}</StyledHeading>;
+}

package/src/inspector/ui/icon.tsx

@@ -0,0 +1,71 @@
+import { ChevronDownIcon } from "./icons/chevron-down-icon.js";
+import { DeleteIcon } from "./icons/delete-icon.js";
+import { LinkIcon } from "./icons/link-icon.js";
+
+const icons = {
+  chevronDown: ChevronDownIcon,
+  delete: DeleteIcon,
+  link: LinkIcon,
+};
+
+// copied from tailwind line height https://tailwindcss.com/docs/font-size
+const sizes = {
+  "2xs": 14,
+  xs: 16,
+  sm: 20,
+  md: 24,
+  lg: 28,
+  xl: 28,
+  "2xl": 32,
+  "3xl": 36,
+  "4xl": 40,
+  "5xl": 48,
+  "6xl": 60,
+  "7xl": 72,
+  "8xl": 96,
+  "9xl": 128,
+};
+
+const strokeWidths = {
+  "2xs": 2.5,
+  xs: 2,
+  sm: 2,
+  md: 1.5,
+  lg: 1.5,
+  xl: 1.5,
+  "2xl": 1.25,
+  "3xl": 1.25,
+  "4xl": 1.25,
+  "5xl": 1,
+  "6xl": 1,
+  "7xl": 1,
+  "8xl": 1,
+  "9xl": 1,
+};
+
+export function Icon({
+  name,
+  size = "md",
+  className,
+  ...svgProps
+}: {
+  name?: keyof typeof icons;
+  size?: keyof typeof sizes;
+} & React.SVGProps<SVGSVGElement>) {
+  if (!name || !icons.hasOwnProperty(name)) {
+    throw new Error(`Icon not found: ${name}`);
+  }
+
+  // @ts-ignore
+  const IconComponent = icons?.hasOwnProperty(name) ? icons[name] : icon;
+
+  return (
+    <IconComponent
+      aria-hidden="true"
+      size={sizes[size]}
+      strokeWidth={strokeWidths[size]}
+      strokeLinecap="round"
+      {...svgProps}
+    />
+  );
+}

package/src/inspector/ui/icons/chevron-down-icon.tsx

@@ -0,0 +1,16 @@
+export function ChevronDownIcon(props: React.SVGProps<SVGSVGElement>) {
+  return (
+    <svg
+      {...props}
+      xmlns="http://www.w3.org/2000/svg"
+      width="24"
+      height="24"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeLinejoin="round"
+    >
+      <path d="m6 9 6 6 6-6" />
+    </svg>
+  );
+}

package/src/inspector/ui/icons/delete-icon.tsx

@@ -0,0 +1,19 @@
+export function DeleteIcon(props: React.SVGProps<SVGSVGElement>) {
+  return (
+    <svg
+      {...props}
+      xmlns="http://www.w3.org/2000/svg"
+      width="24"
+      height="24"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeLinejoin="round"
+      className="lucide lucide-trash-icon lucide-trash"
+    >
+      <path d="M3 6h18" />
+      <path d="M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6" />
+      <path d="M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2" />
+    </svg>
+  );
+}

package/src/inspector/ui/icons/link-icon.tsx

@@ -0,0 +1,18 @@
+export function LinkIcon(props: React.SVGProps<SVGSVGElement>) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      fill="none"
+      viewBox="0 0 24 24"
+      strokeWidth={1.5}
+      stroke="currentColor"
+      {...props}
+    >
+      <path
+        strokeLinecap="round"
+        strokeLinejoin="round"
+        d="M13.19 8.688a4.5 4.5 0 0 1 1.242 7.244l-4.5 4.5a4.5 4.5 0 0 1-6.364-6.364l1.757-1.757m13.35-.622 1.757-1.757a4.5 4.5 0 0 0-6.364-6.364l-4.5 4.5a4.5 4.5 0 0 0 1.242 7.244"
+      />
+    </svg>
+  );
+}