npm install @fireberry/sdk

import FireberryClientSDK from "@fireberry/sdk/client";

// 1. Create the client
const client = new FireberryClientSDK();

// 2. Initialize (required before using context or API)
await client.initializeContext();

// 3. Use context and API
const { user, record } = client.context;
const { fullName } = user;
console.log(`Hello, ${fullName}!`);

const results = await client.api.query(1, {
  fields: "accountid,accountname",
  query: 'status = "active"',
});

await client.initializeContext();

const { user, record } = client.context;

// User info (always available)
console.log(user.id); // User's unique ID
console.log(user.fullName); // User's display name
console.log(user.organizationId); // User's organization ID

// Record info (only in Record components)
console.log(record.id); // Current record ID
console.log(record.type); // Object type number

const results = await client.api.query(objectType, {
  fields: "accountid,accountname,status,createdon",
  query: 'status = "active"',
  page_size: 20, // optional
  page_number: 1, // optional
});

const result = await client.api.create(objectType, {
  name: "New Project",
  status: "active",
  priority: "high",
});

if (result.success) {
  console.log("Created:", result.data.id);
}

const result = await client.api.update(objectType, recordId, {
  status: "completed",
});

if (result.success) {
  console.log("Updated successfully");
}

const result = await client.api.delete(objectType, recordId);

if (result.success) {
  console.log("Deleted");
}

interface ResponseData {
  success: boolean;
  data: any;
  error?: {
    status: number;
    statusText: string;
    data: { Message?: string };
  };
  requestId: string;
}

const result = await client.api.query(1, {
  fields: "accountid,accountname",
  query: 'status = "active"',
});

if (result.success) {
  console.log("Data:", result.data);
} else {
  console.error("Error:", result.error?.data.Message);
}

const settings = await client.app.settings.get();

await client.app.settings.set({ theme: "dark", language: "en" });

await client.system.badge.show({
  number: 5,
  badgeType: "info",
});

// Show unread messages count
await client.system.badge.show({
  number: 12,
  badgeType: "info",
});

// Show error count
await client.system.badge.show({
  number: 3,
  badgeType: "error",
});

await client.system.badge.hide();

await client.system.callbar.show({
  callInfo: {
    number: 1234567890,
    status: "Talking",
  },
  objectConfig: [
    {
      objectType: "1",
      order: 1,
      fields: [
        { name: "accountname" },
        { name: "email" },
      ],
    },
  ],
  placemment: "bottom-end",
});

// Display callbar for incoming call
await client.system.callbar.show({
  callInfo: {
    number: 5551234567,
    status: "Ringing",
  },
  objectConfig: [
    {
      objectType: "1",
      fields: [
        { name: "accountname", },
        { name: "phone"},
        { name: "email" },
      ],
    },
  ],
  placemment: "bottom-end",
});

await client.system.callbar.hide();

import FireberryClientSDK from "@fireberry/sdk/client";

const client = new FireberryClientSDK<ResponseDataType, SettingsType>();
//                                    ^^^^^^^^^^^^^^^^  ^^^^^^^^^^^^
//                                    1st: API data     2nd: Settings shape

import FireberryClientSDK from "@fireberry/sdk/client";

// Define the shape of records your API calls return
interface Account {
  accountid: string;
  accountname: string;
  status: string;
  telephone1?: string;
}

// Define the shape of your app's settings
interface MySettings {
  theme?: string;
  pinnedItems?: { id: string; name: string }[];
}

// Create a fully-typed client
const client = new FireberryClientSDK<Account, MySettings>();
await client.initializeContext();

// API responses are typed
const results = await client.api.query(1, {
  fields: "accountid,accountname,status",
  query: 'status = "active"',
});
// results.data is typed as Account

// Settings are typed
const settings = await client.app.settings.get();
// settings is typed as MySettings

import { useEffect, useState } from "react";
import FireberryClientSDK from "@fireberry/sdk/client";

function TaskList() {
  const [client] = useState(() => new FireberryClientSDK());
  const [tasks, setTasks] = useState([]);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    async function init() {
      await client.initializeContext();

      const result = await client.api.query(1, {
        fields: "accountid,accountname,status",
        query: 'status != "completed"',
      });

      if (result.success) {
        setTasks(Array.isArray(result.data) ? result.data : [result.data]);
      }
      setLoading(false);
    }

    init();
  }, [client]);

  const completeTask = async (taskId) => {
    const result = await client.api.update(1, taskId, { status: "completed" });
    if (result.success) {
      setTasks(tasks.filter((t) => t.accountid !== taskId));
    }
  };

  if (loading) return <div>Loading...</div>;

  return (
    <ul>
      {tasks.map((task) => (
        <li key={task.accountid}>
          {task.accountname}
          <button onClick={() => completeTask(task.id)}>Complete</button>
        </li>
      ))}
    </ul>
  );
}

// Clean up event listeners and pending requests
client.destroy();

useEffect(() => {
  const client = new FireberryClientSDK();
  // ... setup

  return () => client.destroy();
}, []);