IDs

Todo recurso tem um ID ($id): linha, tabela, banco, usuário, arquivo, bucket, time, function. Na criação, você escolhe entre deixar o SDK gerar ou informar o seu.

ids.ts

import { ID, TablesDB } from '@owbase/web';
import { client } from './client';

const db = new TablesDB(client);

// ID gerado pelo SDK: único, sem você precisar controlar nada.
await db.createRow({ databaseId: 'loja', tableId: 'pedidos', rowId: ID.unique(), data: { cliente: 'Ana', total: 120 } });

// ID escolhido por você: útil quando ele vem de outro sistema.
await db.createRow({ databaseId: 'loja', tableId: 'pedidos', rowId: ID.custom('pedido-2026-0001'), data: { cliente: 'Bia', total: 80 } });

Regras de um ID escolhido por você

• Até 36 caracteres.
• Só a-z, A-Z, 0-9, ponto (.), hífen (-) e sublinhado (_).
• Não pode começar com um caractere especial.
• Único dentro do seu escopo: duas linhas da mesma tabela não podem ter o mesmo ID (o erro é row_already_exists, status 409).

Quando usar cada um

• ID.unique(): o padrão. Evita colisão e não revela nada sobre o recurso.
• ID.custom('…'): quando o ID vem de outro sistema (número do pedido, código do produto) ou quando você quer um endereço legível, como uma tabela chamada pedidos ou um bucket fotos.

Os campos que começam com $ ($id, $createdAt, $updatedAt, $permissions) são do sistema e vêm em toda resposta.