@resultdev/sdk 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+# @resultdev/sdk
+
+The SDK for apps built on Result Backend — authentication, database, file
+storage, serverless functions and realtime, one client.
+
+```bash
+npm install @resultdev/sdk
+```
+
+```ts
+import { createClient } from "@resultdev/sdk";
+
+export const backend = createClient({
+  baseUrl: process.env.NEXT_PUBLIC_BACKEND_URL!,
+  anonKey: process.env.NEXT_PUBLIC_BACKEND_ANON_KEY!,
+});
+```
+
+## Database
+
+```ts
+const { data, error } = await backend.database
+  .from("todos")
+  .select()
+  .order("created_at", { ascending: false });
+
+await backend.database.from("todos").insert([{ title: "Hello" }]);
+await backend.database.from("todos").update({ done: true }).eq("id", id);
+await backend.database.from("todos").delete().eq("id", id);
+```
+
+## Authentication
+
+```ts
+await backend.auth.signUp({ email, password, name });
+await backend.auth.signInWithPassword({ email, password });
+const { data } = await backend.auth.getCurrentUser();
+await backend.auth.signOut();
+```
+
+Once signed in, every database/storage/function call carries the user's
+session automatically — row-level-secured tables just work.
+
+## Storage
+
+```ts
+const { data } = await backend.storage.from("uploads").uploadAuto(file);
+```
+
+## Functions & realtime
+
+```ts
+await backend.functions.invoke("my-function", { method: "POST", body });
+backend.realtime.subscribe("room:1", (message) => console.log(message));
+```
+
+## Server-side (Next.js SSR)
+
+```ts
+import { createServerClient } from "@resultdev/sdk/ssr";
+```
+
+Admin operations (schema changes, service-level reads) use your app's admin
+key server-side — see your app's page in the Result dashboard for the
+credentials and the full agent prompt.