@keeprer/js

Official TypeScript / JavaScript client for Keeprer — The Lightweight No-Code Database & Headless Backend.

📦 Features

• ⚡ Zero Dependencies: Powered by native fetch.
• 🛡️ Full TypeScript Support: Auto-complete and type inference.
• 🎯 Fluent Supabase-style API: Chain filters like .eq(), .gt(), .sort(), .limit().
• 🔐 Scoped API Keys: Supports pk_ (publishable/read-only) and sk_ (secret/read-write).

🚀 Quick Start

Installation

npm install @keeprer/js
# or yarn add @keeprer/js
# or pnpm add @keeprer/js

Initialize Client

import { createClient } from "@keeprer/js"

const keeprer = createClient("https://keeprer.space", "pk_xxxxxxxxxxxx")

📖 Usage Examples

1. Query Records (Select & Filter)

// Query products where status is active and price > 100
const { data, total, error } = await keeprer
  .from("products")
  .select()
  .eq("status", "active")
  .gt("price", 100)
  .sort("-created_at")
  .limit(20)

console.log(data) // [{ id: "...", name: "Shirt", price: 350, ... }]

2. Insert Records (Create)

// Insert single row
const { data: item, error } = await keeprer
  .from("products")
  .insert({
    name: "เสื้อยืด Keeprer",
    price: 350,
    status: "in_stock",
  })

// Batch insert up to 500 rows
const { data: items } = await keeprer
  .from("products")
  .insert([
    { name: "Item 1", price: 100 },
    { name: "Item 2", price: 200 },
  ])

3. Update Record (Patch)

const { data: updated, error } = await keeprer
  .from("products")
  .update("row_uuid_here", {
    price: 290,
  })

4. Delete Record (Delete)

const { success, error } = await keeprer
  .from("products")
  .delete("row_uuid_here")

5. Inspect Schema

const { table, fields } = await keeprer
  .from("products")
  .schema()

🔑 Security Best Practices

• Frontend (React, Next.js client, Vue, Mobile apps): Always use a publishable key starting with pk_... or toggle the table to Public mode in Keeprer.
• Backend (Node.js, Express, Next.js Server Actions, Python): Use a secret key starting with sk_... kept securely in environment variables.

📄 License

MIT © Keeprer Team