own-auth 0.1.4 → 0.1.5

package/README.md

@@ -33,7 +33,6 @@ export const auth = createOwnAuth({
 
 ```bash
 psql "$DATABASE_URL" -f node_modules/own-auth/migrations/001_initial.sql
-psql "$DATABASE_URL" -f node_modules/own-auth/migrations/002_hosted_projects.sql
 ```
 
 ## Basic Usage
@@ -51,11 +50,110 @@ const session = await auth.getCurrentSession(sessionToken);
 await auth.signOut(sessionToken);
 ```
 
+## Common Methods
+
+Sign in:
+
+```ts
+const login = await auth.signInEmailPassword({
+  email: "founder@example.com",
+  password: "correct-horse"
+});
+```
+
+Sessions:
+
+```ts
+const current = await auth.requireCurrentSession(sessionToken);
+
+await auth.revokeAllSessions(current.user.id);
+```
+
+Magic links:
+
+```ts
+await auth.requestMagicLink({ email: "founder@example.com" });
+
+const magicLogin = await auth.verifyMagicLink({ token });
+```
+
+Email verification:
+
+```ts
+await auth.requestEmailVerification({ email: "founder@example.com" });
+
+const verifiedUser = await auth.verifyEmail({ token });
+```
+
+Password reset:
+
+```ts
+await auth.requestPasswordReset({ email: "founder@example.com" });
+
+await auth.resetPassword({
+  token,
+  newPassword: "new-correct-horse"
+});
+```
+
+SMS OTP:
+
+```ts
+await auth.requestSmsOtp({ phone: "+15551234567" });
+
+const phoneLogin = await auth.verifySmsOtp({
+  phone: "+15551234567",
+  code: "123456"
+});
+```
+
+Organisations and invites:
+
+```ts
+const { organisation } = await auth.createOrganisation({
+  name: "Acme",
+  ownerUserId: user.id
+});
+
+await auth.inviteMember({
+  organisationId: organisation.id,
+  email: "teammate@example.com",
+  invitedByUserId: user.id,
+  role: "member"
+});
+```
+
+API keys and permissions:
+
+```ts
+const createdKey = await auth.createApiKey({
+  name: "Production key",
+  organisationId: organisation.id,
+  actorUserId: user.id,
+  scopes: ["users:read"]
+});
+
+const verifiedKey = await auth.verifyApiKey(createdKey.rawKey, ["users:read"]);
+
+const canManageKeys = await auth.checkPermission(
+  organisation.id,
+  user.id,
+  "manage_api_keys"
+);
+```
+
+Audit events:
+
+```ts
+const events = await auth.listAuditEvents({
+  organisationId: organisation.id
+});
+```
+
 ## Exports
 
 - `own-auth`: auth engine, providers, types, test storage
 - `own-auth/migrations/001_initial.sql`: core auth tables
-- `own-auth/migrations/002_hosted_projects.sql`: hosted project tables
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "own-auth",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "description": "Framework-independent TypeScript auth engine with Postgres storage.",
   "license": "MIT",