tevrocsdk 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,189 @@
+# Tevroc SDK
+
+JavaScript SDK for the `tevroc-api` 
+
+Supports:
+- ESM (import)
+- UMD (browser `<script>`)
+- CDN usage (unpkg/jsdelivr)
+
+---
+
+## Install
+
+### npm / ESM
+```bash
+npm install tevrocsdk
+```
+
+### Browser (UMD / CDN)
+Option 1: Local file
+``` html
+<script src="./tevroc-sdk.umd.js"></script>
+<script>
+  const tevroc = Tevroc.createClient({
+    baseUrl: "https://your-worker.example.workers.dev"
+  });
+</script>
+``` 
+
+Option 2: CDN (recommended)
+```html
+<script src="https://unpkg.com/tevrocsdk/dist/tevroc-sdk.umd.js"></script>
+<script>
+  const tevroc = Tevroc.createClient({
+    baseUrl: "https://your-worker.example.workers.dev"
+  });
+</script>
+```
+
+
+## Create a client
+
+```js
+import { createClient } from "tevrocsdk";
+
+const tevroc = createClient({
+  baseUrl: "http://localhost:8787",
+});
+```
+
+You can also pass an existing token:
+
+```js
+const tevroc = createClient({
+  baseUrl: "https://your-worker.example.workers.dev",
+  token: localStorage.getItem("tevroc_token"),
+});
+```
+
+## Auth
+
+```js
+const { token, user } = await tevroc.auth.login({
+  email: "ada@example.com",
+  password: "correct horse battery staple",
+});
+
+// The SDK stores the token on the client after login/register.
+const me = await tevroc.auth.me();
+```
+
+## Entities
+
+Entities are dynamic, like the Base44 SDK.
+
+```js
+const created = await tevroc.entities.Project.create({
+  name: "Launch site",
+  status: "active",
+});
+
+const projects = await tevroc.entities.Project.list({ limit: 20 });
+
+const filtered = await tevroc.entities.Project.query({
+  filter: { status: "active" },
+  limit: 10,
+});
+
+await tevroc.entities.Project.update(created.data.id, { status: "done" });
+```
+
+Available methods:
+
+- `list({ limit, offset })`
+- `get(id)`
+- `create(record)`
+- `update(id, patch)`
+- `delete(id)`
+- `query({ filter, limit })`
+- `bulkCreate(records)`
+- `bulkUpdate(records)`
+- `bulkDelete(ids)`
+- `import(records)`
+
+## Functions
+
+```js
+await tevroc.functions.invoke("ping", { hello: "world" });
+
+// Shorthand:
+await tevroc.functions.ping({ hello: "world" });
+```
+
+## Core integrations
+
+```js
+await tevroc.integrations.Core.InvokeLLM({
+  prompt: "Write a two-line launch checklist.",
+});
+
+await tevroc.integrations.Core.SendEmail({
+  to: "ada@example.com",
+  subject: "Hello",
+  text: "From Tevroc",
+});
+
+await tevroc.integrations.Core.UploadFile(file, {
+  filename: "report.pdf",
+  contentType: "application/pdf",
+});
+```
+
+## Agents
+
+```js
+const conversation = await tevroc.agents.Support.createConversation({
+  title: "Onboarding",
+});
+
+await tevroc.agents.Support.addMessage(conversation.data.id, {
+  role: "user",
+  content: "Help me configure my workspace",
+});
+
+const messages = await tevroc.agents.Support.listMessages(conversation.data.id);
+```
+
+## Connectors, logs, SSO, and custom integrations
+
+```js
+await tevroc.connectors.list();
+await tevroc.connectors.connect("slack", { config: { teamId: "T123" } });
+await tevroc.connectors.status("slack");
+
+await tevroc.logs.create({
+  level: "info",
+  message: "User opened dashboard",
+  context: { source: "web" },
+});
+
+await tevroc.customIntegrations.example.echo({ ok: true });
+await tevroc.sso.accessToken({ code: "provider-code" });
+```
+
+## Raw requests
+
+Use `request` for worker routes that do not have a convenience wrapper yet.
+
+```js
+const health = await tevroc.request("/health", { auth: false });
+```
+
+## Error handling
+
+API errors throw `TevrocError` with `status`, `code`, and `details`.
+
+```js
+import { TevrocError } from "tevrocsdk";
+
+try {
+  await tevroc.auth.me();
+} catch (error) {
+  if (error instanceof TevrocError && error.status === 401) {
+    // Ask the user to log in.
+  }
+}
+```
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tevrocsdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Base44-style JavaScript SDK for the Tevroc Worker API.",
   "main": "./tevroc-sdk.umd.js",
   "module": "./tevroc-sdk.esm.js",