Product credits

const systems = await nozle.creditSystems.list()

for (const system of systems) {
  console.log(system.code, system.unitName, system.status)
}

const balance = await nozle.credits.getBalance(
  'workspace_123',
  'ai_credits',
)

console.log(balance.available) // exact decimal string
console.log(balance.sources)

const allBalances = await nozle.credits.listBalances('workspace_123')

const page = await nozle.credits.listOperations('workspace_123', {
  creditSystemCode: 'ai_credits',
  limit: 25,
})

const nextPage = page.next_cursor
  ? await nozle.credits.listOperations('workspace_123', {
      creditSystemCode: 'ai_credits',
      limit: 25,
      cursor: page.next_cursor,
    })
  : null

const balance = await nozle.credits.getEntityBalance(
  'workspace_123',
  'user_42',
  'ai_credits',
)

console.log(balance.entity_available)
console.log(balance.shared_available)
console.log(balance.effective_available)
console.log(balance.pool_policy)

const allBalances = await nozle.credits.listEntityBalances(
  'workspace_123',
  'user_42',
)

const history = await nozle.credits.listEntityOperations(
  'workspace_123',
  'user_42',
  {
    creditSystemCode: 'ai_credits',
    limit: 25,
  },
)

const allocation = await nozle.credits.allocate(
  'workspace_123',
  'user_42',
  {
    creditSystemCode: 'ai_credits',
    amount: '100.000000000001',
  },
  { idempotencyKey: 'allocate-user-42-100-v1' },
)

console.log(allocation.transferred)
console.log(allocation.parent_sources)
console.log(allocation.entity_sources)
console.log(allocation.replayed)

const deallocation = await nozle.credits.deallocate(
  'workspace_123',
  'user_42',
  {
    creditSystemCode: 'ai_credits',
    amount: '25',
  },
  { idempotencyKey: 'deallocate-user-42-25-v1' },
)

const check = await nozle.usage.check({
  customerId: 'workspace_123',
  entityId: 'user_42',
  featureCode: 'agent_execution',
  creditSystemCode: 'ai_credits',
  properties: { model: 'example-model' },
  occurredAt: new Date().toISOString(),
})

console.log(check.advisory) // true
console.log(check.allowed)
console.log(check.credits_required)
console.log(check.projected_remaining)
console.log(check.projected_deductions)

// Store one time per unit of work and reuse it on every retry.
const timestamp = execution.startedAt.toISOString()

const result = await nozle.usage.track(
  {
    customerId: 'workspace_123',
    entityId: 'user_42',
    featureCode: 'agent_execution',
    creditSystemCode: 'ai_credits',
    properties: { model: 'example-model' },
    timestamp,
  },
  { idempotencyKey: 'agent-execution-0183f' },
)

if (!result.allowed) {
  console.log(result.reason, result.available)
}