kokojs

Complete SDK for Koko user pods and runtime environments with authentication client and database support.

Installation

npm install kokojs
# or
pnpm add kokojs
# or
yarn add kokojs

Packages

Authentication Client (kokojs/client)

Authentication client for Koko applications with built-in token management, auto-refresh, and localStorage integration.

import { createAuthClient } from 'kokojs/client';

const auth = createAuthClient({
  authUrl: 'https://your-app.com/auth/login',
  refreshUrl: 'https://your-app.com/auth/refresh',
  autoRefresh: true,
  onUnauthorized: async () => {
    window.location.href = '/login';
  }
});

// Initialize and check authentication
const { authenticated, token } = auth.init();

// Make authenticated requests
const response = await auth.fetch('https://api.example.com/user/profile');

Full documentation

Database API (kokojs/db)

Pod-scoped SQLite API with a Supabase-style query builder interface.

import { db } from 'kokojs/db';

// Select with filters
const { data, error } = await db.from('users')
  .select('id, name, email')
  .eq('status', 'active')
  .limit(10);

// Insert records
await db.from('users').insert({
  name: 'John Doe',
  email: '[email protected]'
});

// Update records
await db.from('users')
  .update({ status: 'inactive' })
  .eq('id', 123);

Full documentation

SDK (kokojs/sdk)

Complete SDK for Koko user pods and remote runtime environments.

import { koko, sql, fs, auth } from 'kokojs/sdk';

// Check pod connection
console.log(koko.ping()); // "pong"
console.log(koko.podId());

// Execute SQL queries
const result = await sql.query('SELECT * FROM users WHERE age > ?', [18]);

// File operations
const content = await fs.readText('/data/config.json');
await fs.writeText('/data/output.txt', 'Hello, world!');

// Authentication
const user = auth.getUser();
if (user) {
  console.log(user.id, user.roles);
}

Full documentation

Features

• Authentication: Token management, auto-refresh, localStorage integration
• Database: Fluent query builder, CRUD operations, SQLite support
• SQL API: Execute SQL queries with parameter binding
• File System: Read/write files in pod storage
• Environment: Access to pod environment variables
• Dual Mode: Works in both native and remote environments

License

MIT - Copyright (c) 2026 KokoLabs.io

Links

• GitHub Repository
• npm Package