@banata-auth/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Banata Auth Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# @banata-auth/sdk
+
+Server-side SDK for the Banata Auth platform — manage users, organizations, SSO, RBAC, webhooks, and more.
+
+## Installation
+
+```bash
+npm install @banata-auth/sdk
+```
+
+## Quick start
+
+```ts
+import { BanataAuth } from "@banata-auth/sdk";
+
+const banataAuth = new BanataAuth({
+  apiKey: "sk_live_...",
+  baseUrl: "https://your-convex-site.convex.site",
+});
+
+// List users
+const users = await banataAuth.userManagement.listUsers();
+
+// Create organization
+const org = await banataAuth.organizations.createOrganization({
+  name: "Acme Corp",
+});
+
+// Manage webhooks
+const endpoint = await banataAuth.webhooks.createEndpoint({
+  url: "https://example.com/webhooks",
+  eventTypes: ["user.created"],
+});
+
+// Verify webhook signatures
+const event = await banataAuth.webhooks.constructEvent({
+  payload: body,
+  sigHeader: headers["webhook-signature"],
+  secret: webhookSecret,
+});
+```
+
+## Resources
+
+| Resource | Description |
+|----------|-------------|
+| `userManagement` | CRUD users, list sessions, ban/unban |
+| `organizations` | Create/manage organizations and members |
+| `sso` | SSO connection management |
+| `directorySync` | SCIM directory sync |
+| `rbac` | Role-based access control |
+| `apiKeys` | API key lifecycle management |
+| `webhooks` | Webhook endpoints and signature verification |
+| `emails` | Send emails and manage templates (`emails.send()`, `emails.templates.list()`) |
+| `auditLogs` | Audit event creation and querying |
+| `events` | Event streaming |
+| `portal` | Admin portal link generation |
+| `vault` | Secret storage |
+| `domains` | Domain verification |
+| `projects` | Multi-tenant project management |
+
+## Features
+
+- Automatic retry with exponential backoff (5xx and 429)
+- `Retry-After` header support for rate limiting
+- Typed error classes (`AuthenticationError`, `RateLimitError`, etc.)
+- Configurable timeout and retry count
+
+## License
+
+MIT