@commercengine/pos 0.4.6 → 0.5.0

package/README.md

@@ -464,18 +464,22 @@ const pos = new PosSDK({
 
 The SDK is written in TypeScript and provides full type safety with advanced schema handling:
 
-### Schema-Specific Typing
-The POS SDK handles both regular storefront operations and admin operations with proper type safety. When both schemas define the same endpoint (like `/pos/orders`), the SDK automatically uses the appropriate schema based on the operation:
+### Single-Spec Typing
+The SDK is generated from the dedicated POS OpenAPI spec, which describes the
+full surface — storefront-backed and admin-proxied operations alike — in one
+document. Every method is typed from the same `paths` schema:
 
 ```typescript
-// Regular POS operation (POST) - uses storefront schema
+// Storefront-backed POS operation
 await pos.createOrder({ cart_id: "cart-123" });
 
-// Admin POS operation (GET) - uses admin schema  
+// Admin-proxied POS operation, same client, same schema
 await pos.listOrders({ page: 1, limit: 10 });
 ```
 
-This ensures you get proper TypeScript autocompletion and validation for each operation without any type conflicts.
+Where an admin operation's schema shares a name with a different storefront
+definition, the admin one carries an `Admin` prefix (`AdminOrder`,
+`AdminPagination`, …), so there are no type conflicts.
 
 ```typescript
 import type {