@korajs/server 0.3.3 → 0.5.0

package/README.md

@@ -52,6 +52,39 @@ await server.start()
 | `SqliteServerStore` | Built-in | Small deployments, prototyping |
 | `PostgresServerStore` | Built-in | Production |
 
+## Mixed Auth (Authenticated + Anonymous)
+
+For apps where some users are authenticated and others are anonymous:
+
+```typescript
+import { MixedAuthProvider } from '@korajs/server'
+
+const server = createKoraServer({
+  store: serverStore,
+  auth: new MixedAuthProvider({
+    primary: authRoutes.toSyncAuthProvider(),
+    anonymousScopes: { responses: {} },
+  }),
+})
+```
+
+## Materialized Collections
+
+Enable server-side queries on your data:
+
+```typescript
+await store.setSchema(schema)
+
+// Query with filters
+const forms = await store.queryCollection('forms', {
+  where: { status: 'published' },
+  limit: 10,
+})
+
+// Count records
+const count = await store.countCollection('responses', { formId: 'abc' })
+```
+
 ## Configuration
 
 ```typescript
@@ -64,6 +97,16 @@ createKoraServer({
 })
 ```
 
+## Testing
+
+Integration tests include **store parity** coverage for `MemoryServerStore` and `SqliteServerStore`. To run the same parity suite against a live PostgreSQL database:
+
+```bash
+DATABASE_URL="postgres://user:pass@localhost:5432/kora_test" pnpm --filter @korajs/server test -- tests/integration/server-store-parity.test.ts
+```
+
+Postgres tests are skipped when `DATABASE_URL` is unset.
+
 ## License
 
 MIT