Organization
├── Workspaces (isolated environments)
│   ├── Applications (your apps)
│   │   ├── Database (entities/tables)
│   │   ├── Server Functions (custom logic)
│   │   └── Deployments (releases)

// Example: Products Entity
{
  name: "products",
  fields: [
    { name: "id", type: "uuid", primary: true },
    { name: "name", type: "string", required: true },
    { name: "description", type: "text" },
    { name: "price", type: "decimal", required: true },
    { name: "category_id", type: "uuid", foreignKey: "categories.id" },
    { name: "is_active", type: "boolean", default: true },
    { name: "created_at", type: "timestamp", default: "now()" },
    { name: "updated_at", type: "timestamp" }
  ]
}

"Create a product management dashboard with:
- A header with logo and user menu
- Sidebar navigation with Products, Categories, Orders
- Main content area with a data table showing products
- Add/Edit product modal with form
- Stats cards showing total products, revenue, orders"

// functions/calculate-order-total.ts
export async function calculateOrderTotal(orderId: string) {
  const order = await db.orders.findById(orderId);
  const items = await db.orderItems.find({ order_id: orderId });

  let subtotal = 0;
  for (const item of items) {
    subtotal += item.quantity * item.unit_price;
  }

  const tax = subtotal * 0.08; // 8% tax
  const total = subtotal + tax;

  await db.orders.update(orderId, {
    subtotal,
    tax,
    total
  });

  return { subtotal, tax, total };
}

// Before creating a new user
{
  entity: "users",
  event: "before_create",
  action: async (data) => {
    // Validate email domain
    if (!data.email.endsWith("@company.com")) {
      throw new Error("Only company emails allowed");
    }
    // Hash password
    data.password = await hashPassword(data.password);
    return data;
  }
}

// After creating an order
{
  entity: "orders",
  event: "after_create",
  action: async (data) => {
    // Send confirmation email
    await sendEmail({
      to: data.customer_email,
      template: "order-confirmation",
      data: { orderId: data.id }
    });
    // Update inventory
    await updateInventory(data.items);
  }
}

Development → Staging → Production
     │           │           │
     ▼           ▼           ▼
  Auto-deploy  Manual     Approval
               promote    required

// Install the SDK
npm install @algorithmshift/client

// Initialize
import { AlgorithmShiftClient } from '@algorithmshift/client';

const client = new AlgorithmShiftClient({
  workspaceId: 'your-workspace-id',
  apiKey: 'your-api-key'
});

// Fetch data
const products = await client.entities.products.find({
  where: { is_active: true },
  orderBy: { created_at: 'desc' },
  limit: 10
});

// Create record
const newProduct = await client.entities.products.create({
  name: 'New Product',
  price: 29.99,
  category_id: 'category-uuid'
});

// Call custom function
const total = await client.functions.calculateOrderTotal('order-uuid');