@objectstack/client 0.9.0 → 0.9.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @objectstack/client
 
+## 0.9.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectstack/spec@0.9.2
+  - @objectstack/core@0.9.2
+
+## 0.9.1
+
+### Patch Changes
+
+- Patch release for maintenance and stability improvements. All packages updated with unified versioning.
+- Updated dependencies
+  - @objectstack/spec@0.9.1
+  - @objectstack/core@0.9.1
+
 ## 0.8.2
 
 ### Patch Changes

package/README.md

@@ -12,6 +12,17 @@ The official TypeScript client for ObjectStack.
 - **View Storage**: Save, load, and share custom UI view configurations.
 - **Standardized Errors**: Machine-readable error codes with retry guidance.
 
+## 🤖 AI Development Context
+
+**Role**: Browser/Node Client SDK
+**Usage**:
+- Use this in Frontend Apps (React, etc.) or external Node scripts.
+- Interacts with `packages/runtime` over HTTP.
+
+**Key namespaces**:
+- `client.meta`: Metadata operations.
+- `client.data`: Data operations.
+
 ## Installation
 
 ```bash
@@ -157,10 +168,48 @@ try {
 }
 ```
 
-Common error codes:
-- `validation_error`: Input validation failed
-- `unauthenticated`: Authentication required
-- `permission_denied`: Insufficient permissions
-- `resource_not_found`: Resource does not exist
-- `rate_limit_exceeded`: Too many requests
+### Error Code Reference
+
+#### Client Errors (4xx)
+
+| Error Code | HTTP Status | Retryable | Description |
+|------------|-------------|-----------|-------------|
+| `validation_error` | 400 | No | Input validation failed. Check error.details for field-specific errors |
+| `unauthenticated` | 401 | No | Authentication required. Provide valid token |
+| `permission_denied` | 403 | No | Insufficient permissions for this operation |
+| `resource_not_found` | 404 | No | Resource does not exist. Verify object name or record ID |
+| `conflict` | 409 | No | Resource conflict (e.g., duplicate unique field) |
+| `rate_limit_exceeded` | 429 | Yes | Too many requests. Wait before retrying |
+
+#### Server Errors (5xx)
+
+| Error Code | HTTP Status | Retryable | Description |
+|------------|-------------|-----------|-------------|
+| `internal_error` | 500 | Yes | Server encountered an error. Retry with backoff |
+| `service_unavailable` | 503 | Yes | Service temporarily unavailable. Retry later |
+| `gateway_timeout` | 504 | Yes | Request timeout. Consider increasing timeout or retrying |
+
+**Retry Strategy Example:**
+
+```typescript
+async function retryableRequest<T>(fn: () => Promise<T>, maxRetries = 3): Promise<T> {
+  for (let i = 0; i < maxRetries; i++) {
+    try {
+      return await fn();
+    } catch (error: any) {
+      if (!error.retryable || i === maxRetries - 1) {
+        throw error;
+      }
+      // Exponential backoff
+      await new Promise(resolve => setTimeout(resolve, Math.pow(2, i) * 1000));
+    }
+  }
+  throw new Error('Max retries exceeded');
+}
+
+// Usage
+const data = await retryableRequest(() => 
+  client.data.create('todo_task', { subject: 'Task' })
+);
+```
 

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@objectstack/client",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Official Client SDK for ObjectStack Protocol",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@objectstack/spec": "0.9.0",
-    "@objectstack/core": "0.9.0"
+    "@objectstack/spec": "0.9.2",
+    "@objectstack/core": "0.9.2"
   },
   "devDependencies": {
     "typescript": "^5.0.0",