kreo-client 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# kreo-client
+
+The official **KREO** JavaScript / TypeScript client. A tiny, typed, **zero-dependency** wrapper over the KREO API — a real Postgres backend with an instant REST API, realtime, cache and file storage.
+
+Works in the **browser, Node 18+, Bun, Deno and edge** runtimes.
+
+## Install
+
+```bash
+npm i kreo-client
+```
+
+## Quickstart (5 lines)
+
+```ts
+import { createClient } from "kreo-client";
+
+const kreo = createClient({ apiKey: process.env.KREO_KEY! });
+
+const { data, error } = await kreo.from("todos").select().limit(10);
+console.log(data);
+```
+
+Get your API key in **Dashboard → API Keys**. Use a **secret key** (`kreo_live_…`) on a server, or a **public key** (`pk_live_…`, domain-locked) in the browser.
+
+## Read
+
+```ts
+// filter, order, paginate
+const { data } = await kreo
+  .from("orders")
+  .select()
+  .eq("status", "paid")
+  .order("created_at", "desc")
+  .range(0, 19);          // first 20 rows
+```
+
+## Write
+
+```ts
+await kreo.from("todos").insert({ title: "Buy milk", done: false });
+await kreo.from("todos").update({ done: true }).eq("id", 42);
+await kreo.from("todos").delete().eq("id", 42);
+```
+
+## Typed rows
+
+```ts
+type Todo = { id: number; title: string; done: boolean };
+
+const { data } = await kreo.from<Todo>("todos").select();
+//     ^? Todo[] | null
+```
+
+> Tip: run `npx kreo types` (the KREO CLI) to generate exact types for **all** your tables.
+
+## Realtime
+
+```ts
+kreo.channel("messages")
+  .on("INSERT", ({ row }) => console.log("new message", row))
+  .subscribe();
+```
+
+## File storage
+
+```ts
+const { data } = await kreo.storage.upload(file, { bucket: "avatars", visibility: "public" });
+console.log(data?.url);
+
+const url = kreo.storage.publicUrl(fileId);
+const { data: signed } = await kreo.storage.sign(fileId, 3600); // private, 1h
+```
+
+## Vector search
+
+```ts
+const { data } = await kreo.from("documents").search({
+  column: "embedding",
+  vector: [/* your query embedding */],
+  metric: "cosine",
+  limit: 10,
+});
+```
+
+## Raw SQL
+
+```ts
+const { data } = await kreo.sql("SELECT plan, count(*) FROM customers GROUP BY plan");
+```
+
+## API shape
+
+Every call returns `{ data, error }` (never throws on HTTP errors). Reads also return `{ count, total }`.
+
+```ts
+const { data, error } = await kreo.from("todos").select();
+if (error) console.error(error.message, error.status);
+```
+
+---
+
+Docs: <https://app.kreo.work/docs> · Made by [KREO](https://kreo.work) · MIT

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var h=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var R=Object.prototype.hasOwnProperty;var y=(n,e)=>{for(var t in e)h(n,t,{get:e[t],enumerable:!0})},v=(n,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of T(e))!R.call(n,r)&&r!==t&&h(n,r,{get:()=>e[r],enumerable:!(s=f(e,r))||s.enumerable});return n};var k=n=>v(h({},"__esModule",{value:!0}),n);var C={};y(C,{KreoClient:()=>c,KreoError:()=>a,createClient:()=>w,default:()=>P});module.exports=k(C);var a=class extends Error{constructor(e,t,s=null){super(e),this.name="KreoError",this.status=t,this.code=s}},K="https://app.kreo.work",d=class{constructor(e,t,s){this.url=e;this.apiKey=t;this.extra=s}headers(e=!0){let t={"x-kreo-api-key":this.apiKey,...this.extra};return e&&(t["Content-Type"]="application/json"),t}async request(e,t,s,r=!1){let i;try{i=await fetch(this.url+t,{method:e,headers:this.headers(!r&&s!==void 0),body:s===void 0?void 0:r?s:JSON.stringify(s)})}catch(l){return{data:null,error:new a(l.message||"Network error",0),raw:null}}let o=null;try{o=await i.json()}catch{}if(!i.ok){let l=o??{};return{data:null,error:new a(l.error||i.statusText,i.status,l.pgCode??null),raw:o}}return{data:o,error:null,raw:o}}},p=class{constructor(e,t){this.t=e;this.table=t;this.filters={}}eq(e,t){return this.filters[e]=String(t),this}match(e){for(let t in e)this.filters[t]=String(e[t]);return this}order(e,t="asc"){return this._order=e,this._dir=t,this}limit(e){return this._limit=e,this}offset(e){return this._offset=e,this}range(e,t){return this._offset=e,this._limit=t-e+1,this}buildQuery(){let e=new URLSearchParams;this._limit!=null&&e.set("limit",String(this._limit)),this._offset!=null&&e.set("offset",String(this._offset)),this._order&&(e.set("order",this._order),e.set("dir",this._dir??"asc"));for(let s in this.filters)e.set(s,this.filters[s]);let t=e.toString();return t?`?${t}`:""}then(e,t){return this.t.request("GET",`/api/rest/${encodeURIComponent(this.table)}${this.buildQuery()}`).then(r=>({data:r.error?null:r.data.data,error:r.error,count:r.error?null:r.data.count,total:r.error?null:r.data.total})).then(e,t)}},u=class{constructor(e,t,s,r){this.t=e;this.table=t;this.method=s;this.values=r}eq(e,t){return e==="id"&&(this.id=t),this}then(e,t){if(this.id==null)return Promise.resolve({data:null,error:new a('update()/delete() require .eq("id", value)',400)}).then(e,t);let s=`/api/rest/${encodeURIComponent(this.table)}?id=${encodeURIComponent(String(this.id))}`;return this.t.request(this.method,s,this.method==="PUT"?this.values:void 0).then(i=>({data:i.error?null:i.data?.data??i.data,error:i.error})).then(e,t)}},g=class{constructor(e,t){this.t=e;this.table=t}select(){return new p(this.t,this.table)}async insert(e){let t=await this.t.request("POST",`/api/rest/${encodeURIComponent(this.table)}`,e);return{data:t.error?null:t.data?.data??t.data,error:t.error}}update(e){return new u(this.t,this.table,"PUT",e)}delete(){return new u(this.t,this.table,"DELETE")}async search(e){let t=await this.t.request("POST",`/api/rest/${encodeURIComponent(this.table)}/search`,e);return{data:t.error?null:t.data.data,error:t.error,count:t.error?null:t.data.count,total:null}}},b=class{constructor(e){this.t=e}async upload(e,t={}){let s=new FormData;s.append("file",e,t.filename??e.name??"file"),t.bucket&&s.append("bucket",t.bucket),t.visibility&&s.append("visibility",t.visibility);let r=await this.t.request("POST","/api/storage/upload",s,!0);return{data:r.error?null:{...r.data.file,url:r.data.url},error:r.error}}async list(e={}){let t=e.bucket?`?bucket=${encodeURIComponent(e.bucket)}`:"",s=await this.t.request("GET",`/api/storage/files${t}`),r=Array.isArray(s.data)?s.data:s.data?.files??null;return{data:s.error?null:r,error:s.error}}async remove(e){return await this.t.request("DELETE",`/api/storage/files/${encodeURIComponent(e)}`)}async sign(e,t=3600){return await this.t.request("POST","/api/storage/sign",{id:e,expiresIn:t})}publicUrl(e){return`${this.t.url}/api/storage/public/${encodeURIComponent(e)}`}},m=class{constructor(e,t,s){this.url=e;this.apiKey=t;this.table=s;this.ws=null;this.handlers=[]}on(e,t){return this.handlers.push({op:e,cb:t}),this}where(e){return this.filter=e,this}subscribe(){let e=globalThis.WebSocket;if(!e)throw new a("WebSocket is not available. Use a browser, Node 22+, or a WebSocket polyfill.",0);let t=this.url.replace(/^http/,"ws")+`/api/realtime/?apiKey=${encodeURIComponent(this.apiKey)}`;return this.ws=new e(t),this.ws.onopen=()=>this.ws?.send(JSON.stringify({type:"subscribe",table:this.table,filter:this.filter})),this.ws.onmessage=s=>{let r;try{r=JSON.parse(String(s.data))}catch{return}if(!(r.type!=="change"||!r.op))for(let i of this.handlers)(i.op==="*"||i.op===r.op)&&i.cb({op:r.op,table:r.table??this.table,row:r.row??{}})},this}unsubscribe(){try{this.ws?.send(JSON.stringify({type:"unsubscribe",table:this.table}))}catch{}try{this.ws?.close()}catch{}this.ws=null}},c=class{constructor(e){if(!e?.apiKey)throw new a("createClient requires an apiKey.",0);let t=(e.url??K).replace(/\/$/,"");this.apiKey=e.apiKey,this.t=new d(t,e.apiKey,e.headers??{}),this.storage=new b(this.t)}from(e){return new g(this.t,e)}async sql(e){let t=await this.t.request("POST","/api/db/query",{query_string:e});return{data:t.error?null:t.data,error:t.error}}channel(e){return new m(this.t.url,this.apiKey,e)}};function w(n){return new c(typeof n=="string"?{apiKey:n}:n)}var P=w;0&&(module.exports={KreoClient,KreoError,createClient});

package/dist/index.d.cts

@@ -0,0 +1,165 @@
+/**
+ * kreo-client — the official KREO JavaScript / TypeScript client.
+ *
+ * A tiny, dependency-free wrapper over the KREO public HTTP API. Works in the
+ * browser, Node 18+, Bun, Deno and edge runtimes (uses global fetch/FormData;
+ * realtime uses global WebSocket, available in browsers and Node 22+).
+ *
+ *   import { createClient } from "kreo-client";
+ *   const kreo = createClient({ apiKey: "kreo_live_..." });
+ *   const { data } = await kreo.from("todos").select().limit(10);
+ */
+interface KreoClientOptions {
+    /** Your KREO API key (kreo_live_… secret, or pk_live_… public key). */
+    apiKey: string;
+    /** API base URL. Defaults to https://app.kreo.work */
+    url?: string;
+    /** Extra headers merged into every request. */
+    headers?: Record<string, string>;
+}
+declare class KreoError extends Error {
+    status: number;
+    code: string | null;
+    constructor(message: string, status: number, code?: string | null);
+}
+interface KreoResult<T> {
+    data: T | null;
+    error: KreoError | null;
+}
+interface KreoListResult<T> {
+    data: T[] | null;
+    error: KreoError | null;
+    count: number | null;
+    total: number | null;
+}
+type Row = Record<string, unknown>;
+declare class Transport {
+    url: string;
+    private apiKey;
+    private extra;
+    constructor(url: string, apiKey: string, extra: Record<string, string>);
+    headers(json?: boolean): Record<string, string>;
+    request<T>(method: string, path: string, body?: unknown, isForm?: boolean): Promise<{
+        data: T | null;
+        error: KreoError | null;
+        raw: unknown;
+    }>;
+}
+declare class SelectBuilder<T extends Row> implements PromiseLike<KreoListResult<T>> {
+    private t;
+    private table;
+    private filters;
+    private _limit?;
+    private _offset?;
+    private _order?;
+    private _dir?;
+    constructor(t: Transport, table: string);
+    /** Exact-match filter: WHERE column = value (combined with AND). */
+    eq(column: string, value: string | number | boolean): this;
+    /** Apply several exact-match filters at once. */
+    match(obj: Record<string, string | number | boolean>): this;
+    order(column: string, dir?: "asc" | "desc"): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    /** Zero-based inclusive range, e.g. range(0, 9) → 10 rows. */
+    range(from: number, to: number): this;
+    private buildQuery;
+    then<R1 = KreoListResult<T>, R2 = never>(onfulfilled?: ((v: KreoListResult<T>) => R1 | PromiseLike<R1>) | null, onrejected?: ((r: unknown) => R2 | PromiseLike<R2>) | null): PromiseLike<R1 | R2>;
+}
+declare class WriteBuilder<T extends Row> implements PromiseLike<KreoResult<T>> {
+    private t;
+    private table;
+    private method;
+    private values?;
+    private id?;
+    constructor(t: Transport, table: string, method: "PUT" | "DELETE", values?: Partial<T> | undefined);
+    /** Target the row by its primary key: .eq("id", 42). Required for update/delete. */
+    eq(column: string, value: string | number): this;
+    then<R1 = KreoResult<T>, R2 = never>(onfulfilled?: ((v: KreoResult<T>) => R1 | PromiseLike<R1>) | null, onrejected?: ((r: unknown) => R2 | PromiseLike<R2>) | null): PromiseLike<R1 | R2>;
+}
+declare class KreoTable<T extends Row> {
+    private t;
+    private table;
+    constructor(t: Transport, table: string);
+    /** Read rows. Chain .eq / .order / .limit / .range, then await. */
+    select(): SelectBuilder<T>;
+    /** Insert one row. */
+    insert(values: Partial<T>): Promise<KreoResult<T>>;
+    /** Update the row matched by .eq("id", …). */
+    update(values: Partial<T>): WriteBuilder<T>;
+    /** Delete the row matched by .eq("id", …). */
+    delete(): WriteBuilder<T>;
+    /** Vector similarity search against a pgvector column. */
+    search(opts: {
+        column: string;
+        vector: number[];
+        metric?: "cosine" | "l2" | "inner_product";
+        limit?: number;
+        select?: string[];
+    }): Promise<KreoListResult<T & {
+        distance: number;
+    }>>;
+}
+declare class KreoStorage {
+    private t;
+    constructor(t: Transport);
+    upload(file: Blob | File, opts?: {
+        bucket?: string;
+        visibility?: "public" | "private";
+        filename?: string;
+    }): Promise<KreoResult<{
+        id: string;
+        bucket: string;
+        url?: string;
+    }>>;
+    list(opts?: {
+        bucket?: string;
+    }): Promise<KreoResult<unknown[]>>;
+    remove(id: string): Promise<KreoResult<{
+        deleted: boolean;
+    }>>;
+    /** Create a time-limited signed URL for a private file (seconds, max 7 days). */
+    sign(id: string, expiresIn?: number): Promise<KreoResult<{
+        url: string;
+    }>>;
+    /** Direct public URL for a PUBLIC file (no auth needed to open it). */
+    publicUrl(id: string): string;
+}
+type ChangeOp = "INSERT" | "UPDATE" | "DELETE";
+type ChangeHandler = (payload: {
+    op: ChangeOp;
+    table: string;
+    row: Row;
+}) => void;
+declare class KreoChannel {
+    private url;
+    private apiKey;
+    private table;
+    private ws;
+    private handlers;
+    private filter?;
+    constructor(url: string, apiKey: string, table: string);
+    on(op: ChangeOp | "*", cb: ChangeHandler): this;
+    where(filter: Record<string, string | number | boolean>): this;
+    subscribe(): this;
+    unsubscribe(): void;
+}
+declare class KreoClient {
+    private t;
+    private apiKey;
+    storage: KreoStorage;
+    constructor(opts: KreoClientOptions);
+    /** Query a table. `kreo.from<MyRow>("todos")` for typed rows. */
+    from<T extends Row = Row>(table: string): KreoTable<T>;
+    /** Run raw SQL against your own schema (needs a key with the right permission). */
+    sql<T = Row>(query: string): Promise<KreoResult<{
+        rows: T[];
+        columns?: string[];
+    }>>;
+    /** Open a realtime channel for a table (requires realtime enabled on it). */
+    channel(table: string): KreoChannel;
+}
+/** Create a KREO client. Pass an options object or just your API key string. */
+declare function createClient(opts: KreoClientOptions | string): KreoClient;
+
+export { KreoClient, type KreoClientOptions, KreoError, type KreoListResult, type KreoResult, createClient, createClient as default };

package/dist/index.d.ts

@@ -0,0 +1,165 @@
+/**
+ * kreo-client — the official KREO JavaScript / TypeScript client.
+ *
+ * A tiny, dependency-free wrapper over the KREO public HTTP API. Works in the
+ * browser, Node 18+, Bun, Deno and edge runtimes (uses global fetch/FormData;
+ * realtime uses global WebSocket, available in browsers and Node 22+).
+ *
+ *   import { createClient } from "kreo-client";
+ *   const kreo = createClient({ apiKey: "kreo_live_..." });
+ *   const { data } = await kreo.from("todos").select().limit(10);
+ */
+interface KreoClientOptions {
+    /** Your KREO API key (kreo_live_… secret, or pk_live_… public key). */
+    apiKey: string;
+    /** API base URL. Defaults to https://app.kreo.work */
+    url?: string;
+    /** Extra headers merged into every request. */
+    headers?: Record<string, string>;
+}
+declare class KreoError extends Error {
+    status: number;
+    code: string | null;
+    constructor(message: string, status: number, code?: string | null);
+}
+interface KreoResult<T> {
+    data: T | null;
+    error: KreoError | null;
+}
+interface KreoListResult<T> {
+    data: T[] | null;
+    error: KreoError | null;
+    count: number | null;
+    total: number | null;
+}
+type Row = Record<string, unknown>;
+declare class Transport {
+    url: string;
+    private apiKey;
+    private extra;
+    constructor(url: string, apiKey: string, extra: Record<string, string>);
+    headers(json?: boolean): Record<string, string>;
+    request<T>(method: string, path: string, body?: unknown, isForm?: boolean): Promise<{
+        data: T | null;
+        error: KreoError | null;
+        raw: unknown;
+    }>;
+}
+declare class SelectBuilder<T extends Row> implements PromiseLike<KreoListResult<T>> {
+    private t;
+    private table;
+    private filters;
+    private _limit?;
+    private _offset?;
+    private _order?;
+    private _dir?;
+    constructor(t: Transport, table: string);
+    /** Exact-match filter: WHERE column = value (combined with AND). */
+    eq(column: string, value: string | number | boolean): this;
+    /** Apply several exact-match filters at once. */
+    match(obj: Record<string, string | number | boolean>): this;
+    order(column: string, dir?: "asc" | "desc"): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    /** Zero-based inclusive range, e.g. range(0, 9) → 10 rows. */
+    range(from: number, to: number): this;
+    private buildQuery;
+    then<R1 = KreoListResult<T>, R2 = never>(onfulfilled?: ((v: KreoListResult<T>) => R1 | PromiseLike<R1>) | null, onrejected?: ((r: unknown) => R2 | PromiseLike<R2>) | null): PromiseLike<R1 | R2>;
+}
+declare class WriteBuilder<T extends Row> implements PromiseLike<KreoResult<T>> {
+    private t;
+    private table;
+    private method;
+    private values?;
+    private id?;
+    constructor(t: Transport, table: string, method: "PUT" | "DELETE", values?: Partial<T> | undefined);
+    /** Target the row by its primary key: .eq("id", 42). Required for update/delete. */
+    eq(column: string, value: string | number): this;
+    then<R1 = KreoResult<T>, R2 = never>(onfulfilled?: ((v: KreoResult<T>) => R1 | PromiseLike<R1>) | null, onrejected?: ((r: unknown) => R2 | PromiseLike<R2>) | null): PromiseLike<R1 | R2>;
+}
+declare class KreoTable<T extends Row> {
+    private t;
+    private table;
+    constructor(t: Transport, table: string);
+    /** Read rows. Chain .eq / .order / .limit / .range, then await. */
+    select(): SelectBuilder<T>;
+    /** Insert one row. */
+    insert(values: Partial<T>): Promise<KreoResult<T>>;
+    /** Update the row matched by .eq("id", …). */
+    update(values: Partial<T>): WriteBuilder<T>;
+    /** Delete the row matched by .eq("id", …). */
+    delete(): WriteBuilder<T>;
+    /** Vector similarity search against a pgvector column. */
+    search(opts: {
+        column: string;
+        vector: number[];
+        metric?: "cosine" | "l2" | "inner_product";
+        limit?: number;
+        select?: string[];
+    }): Promise<KreoListResult<T & {
+        distance: number;
+    }>>;
+}
+declare class KreoStorage {
+    private t;
+    constructor(t: Transport);
+    upload(file: Blob | File, opts?: {
+        bucket?: string;
+        visibility?: "public" | "private";
+        filename?: string;
+    }): Promise<KreoResult<{
+        id: string;
+        bucket: string;
+        url?: string;
+    }>>;
+    list(opts?: {
+        bucket?: string;
+    }): Promise<KreoResult<unknown[]>>;
+    remove(id: string): Promise<KreoResult<{
+        deleted: boolean;
+    }>>;
+    /** Create a time-limited signed URL for a private file (seconds, max 7 days). */
+    sign(id: string, expiresIn?: number): Promise<KreoResult<{
+        url: string;
+    }>>;
+    /** Direct public URL for a PUBLIC file (no auth needed to open it). */
+    publicUrl(id: string): string;
+}
+type ChangeOp = "INSERT" | "UPDATE" | "DELETE";
+type ChangeHandler = (payload: {
+    op: ChangeOp;
+    table: string;
+    row: Row;
+}) => void;
+declare class KreoChannel {
+    private url;
+    private apiKey;
+    private table;
+    private ws;
+    private handlers;
+    private filter?;
+    constructor(url: string, apiKey: string, table: string);
+    on(op: ChangeOp | "*", cb: ChangeHandler): this;
+    where(filter: Record<string, string | number | boolean>): this;
+    subscribe(): this;
+    unsubscribe(): void;
+}
+declare class KreoClient {
+    private t;
+    private apiKey;
+    storage: KreoStorage;
+    constructor(opts: KreoClientOptions);
+    /** Query a table. `kreo.from<MyRow>("todos")` for typed rows. */
+    from<T extends Row = Row>(table: string): KreoTable<T>;
+    /** Run raw SQL against your own schema (needs a key with the right permission). */
+    sql<T = Row>(query: string): Promise<KreoResult<{
+        rows: T[];
+        columns?: string[];
+    }>>;
+    /** Open a realtime channel for a table (requires realtime enabled on it). */
+    channel(table: string): KreoChannel;
+}
+/** Create a KREO client. Pass an options object or just your API key string. */
+declare function createClient(opts: KreoClientOptions | string): KreoClient;
+
+export { KreoClient, type KreoClientOptions, KreoError, type KreoListResult, type KreoResult, createClient, createClient as default };

package/dist/index.js

@@ -0,0 +1 @@
+var a=class extends Error{constructor(e,t,r=null){super(e),this.name="KreoError",this.status=t,this.code=r}},m="https://app.kreo.work",c=class{constructor(e,t,r){this.url=e;this.apiKey=t;this.extra=r}headers(e=!0){let t={"x-kreo-api-key":this.apiKey,...this.extra};return e&&(t["Content-Type"]="application/json"),t}async request(e,t,r,s=!1){let n;try{n=await fetch(this.url+t,{method:e,headers:this.headers(!s&&r!==void 0),body:r===void 0?void 0:s?r:JSON.stringify(r)})}catch(l){return{data:null,error:new a(l.message||"Network error",0),raw:null}}let o=null;try{o=await n.json()}catch{}if(!n.ok){let l=o??{};return{data:null,error:new a(l.error||n.statusText,n.status,l.pgCode??null),raw:o}}return{data:o,error:null,raw:o}}},h=class{constructor(e,t){this.t=e;this.table=t;this.filters={}}eq(e,t){return this.filters[e]=String(t),this}match(e){for(let t in e)this.filters[t]=String(e[t]);return this}order(e,t="asc"){return this._order=e,this._dir=t,this}limit(e){return this._limit=e,this}offset(e){return this._offset=e,this}range(e,t){return this._offset=e,this._limit=t-e+1,this}buildQuery(){let e=new URLSearchParams;this._limit!=null&&e.set("limit",String(this._limit)),this._offset!=null&&e.set("offset",String(this._offset)),this._order&&(e.set("order",this._order),e.set("dir",this._dir??"asc"));for(let r in this.filters)e.set(r,this.filters[r]);let t=e.toString();return t?`?${t}`:""}then(e,t){return this.t.request("GET",`/api/rest/${encodeURIComponent(this.table)}${this.buildQuery()}`).then(s=>({data:s.error?null:s.data.data,error:s.error,count:s.error?null:s.data.count,total:s.error?null:s.data.total})).then(e,t)}},u=class{constructor(e,t,r,s){this.t=e;this.table=t;this.method=r;this.values=s}eq(e,t){return e==="id"&&(this.id=t),this}then(e,t){if(this.id==null)return Promise.resolve({data:null,error:new a('update()/delete() require .eq("id", value)',400)}).then(e,t);let r=`/api/rest/${encodeURIComponent(this.table)}?id=${encodeURIComponent(String(this.id))}`;return this.t.request(this.method,r,this.method==="PUT"?this.values:void 0).then(n=>({data:n.error?null:n.data?.data??n.data,error:n.error})).then(e,t)}},d=class{constructor(e,t){this.t=e;this.table=t}select(){return new h(this.t,this.table)}async insert(e){let t=await this.t.request("POST",`/api/rest/${encodeURIComponent(this.table)}`,e);return{data:t.error?null:t.data?.data??t.data,error:t.error}}update(e){return new u(this.t,this.table,"PUT",e)}delete(){return new u(this.t,this.table,"DELETE")}async search(e){let t=await this.t.request("POST",`/api/rest/${encodeURIComponent(this.table)}/search`,e);return{data:t.error?null:t.data.data,error:t.error,count:t.error?null:t.data.count,total:null}}},p=class{constructor(e){this.t=e}async upload(e,t={}){let r=new FormData;r.append("file",e,t.filename??e.name??"file"),t.bucket&&r.append("bucket",t.bucket),t.visibility&&r.append("visibility",t.visibility);let s=await this.t.request("POST","/api/storage/upload",r,!0);return{data:s.error?null:{...s.data.file,url:s.data.url},error:s.error}}async list(e={}){let t=e.bucket?`?bucket=${encodeURIComponent(e.bucket)}`:"",r=await this.t.request("GET",`/api/storage/files${t}`),s=Array.isArray(r.data)?r.data:r.data?.files??null;return{data:r.error?null:s,error:r.error}}async remove(e){return await this.t.request("DELETE",`/api/storage/files/${encodeURIComponent(e)}`)}async sign(e,t=3600){return await this.t.request("POST","/api/storage/sign",{id:e,expiresIn:t})}publicUrl(e){return`${this.t.url}/api/storage/public/${encodeURIComponent(e)}`}},g=class{constructor(e,t,r){this.url=e;this.apiKey=t;this.table=r;this.ws=null;this.handlers=[]}on(e,t){return this.handlers.push({op:e,cb:t}),this}where(e){return this.filter=e,this}subscribe(){let e=globalThis.WebSocket;if(!e)throw new a("WebSocket is not available. Use a browser, Node 22+, or a WebSocket polyfill.",0);let t=this.url.replace(/^http/,"ws")+`/api/realtime/?apiKey=${encodeURIComponent(this.apiKey)}`;return this.ws=new e(t),this.ws.onopen=()=>this.ws?.send(JSON.stringify({type:"subscribe",table:this.table,filter:this.filter})),this.ws.onmessage=r=>{let s;try{s=JSON.parse(String(r.data))}catch{return}if(!(s.type!=="change"||!s.op))for(let n of this.handlers)(n.op==="*"||n.op===s.op)&&n.cb({op:s.op,table:s.table??this.table,row:s.row??{}})},this}unsubscribe(){try{this.ws?.send(JSON.stringify({type:"unsubscribe",table:this.table}))}catch{}try{this.ws?.close()}catch{}this.ws=null}},b=class{constructor(e){if(!e?.apiKey)throw new a("createClient requires an apiKey.",0);let t=(e.url??m).replace(/\/$/,"");this.apiKey=e.apiKey,this.t=new c(t,e.apiKey,e.headers??{}),this.storage=new p(this.t)}from(e){return new d(this.t,e)}async sql(e){let t=await this.t.request("POST","/api/db/query",{query_string:e});return{data:t.error?null:t.data,error:t.error}}channel(e){return new g(this.t.url,this.apiKey,e)}};function w(i){return new b(typeof i=="string"?{apiKey:i}:i)}var f=w;export{b as KreoClient,a as KreoError,w as createClient,f as default};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "kreo-client",
+  "version": "0.1.0",
+  "description": "Official KREO JavaScript / TypeScript client — a tiny, typed, dependency-free wrapper over the KREO API (Postgres + instant REST, auth, realtime, cache & storage).",
+  "keywords": ["kreo", "baas", "backend", "postgres", "rest", "realtime", "supabase-alternative", "firebase-alternative"],
+  "license": "MIT",
+  "homepage": "https://kreo.work",
+  "repository": { "type": "git", "url": "https://github.com/kreo-work/kreo-js" },
+  "bugs": { "url": "mailto:contact@kreo.work" },
+  "author": "KREO",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --minify",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": { "node": ">=18" },
+  "publishConfig": { "access": "public" }
+}