Portal Surface

interface Account {
  id: string;
  email: string | null;
  name: string | null;
  image: string | null;
  role: 'user' | 'admin' | string;
  workspaceId: string | null;   // currently-active workspace
  createdAt?: string;
}

interface WorkspaceListItem {
  id: string; name: string; slug: string;
  type: 'builder' | 'catalog' | string;
  origin: 'app' | 'import' | string;
  role: 'owner' | 'admin' | 'editor' | 'viewer' | string;
  ownerId: string; memberCount: number; createdAt: string;
  logoKey: string | null;   // ws-relative r2 key of default brand logo
}

interface UpdateWorkspaceInput {
  name?: string;
  slug?: string;                 // sanitized, must be globally unique
  listed?: boolean;              // opt into the public directory
  storeConversations?: boolean;  // opt into storing visitor chat transcripts
  defaultWorkflowId?: string | null;
  wrapConfig?: Record<string, unknown>;  // partial merge; whitelisted keys only
}

interface WorkspaceMember {
  id: string; userId: string; workspaceId: string;
  role: 'owner' | 'admin' | 'editor' | 'viewer' | string;
  email: string | null; name: string | null; image: string | null;
  createdAt: string;
}

interface CloudBrand {
  id: string; slug: string; name: string; isDefault: boolean;
  palette: string[]; fontFamily: string | null;
  createdAt?: string; updatedAt?: string;
}

interface ApiKeyMetadata {
  id: string; name: string;
  prefix: string;           // 'sk_ws_' + 12 chars
  rateLimit: number | null;
  lastUsedAt: string | null;
  createdAt: string;
  revokedAt: string | null;
}

interface MintedApiKey extends ApiKeyMetadata {
  key: string; // 'sk_ws_…'
}

interface CreditBalance {
  balance: { available: number; held: number; total: number };
  unit: 'credits';
  usdCents: { available: number; held: number; total: number };
}

interface CreditHistoryParams {
  limit?: number; offset?: number; type?: string;
}

interface CreditHistory {
  entries: LedgerEntry[]; total: number; limit: number; offset: number;
}

interface LedgerEntry {
  id: string; accountId: string; amountCredits: number;
  refType: string; refId: string | null;
  description: string | null; createdAt: string;
}

interface WorkflowSummary {
  id: string; slug: string; name: string;
  description?: string | null; icon?: string | null;
  folder?: string; createdAt: string; updatedAt?: string;
}