@an5/adapters 0.1.3 → 0.2.1

package/README.md

@@ -1,8 +1,8 @@
 # an5Adapters
 
-Standalone runtime adapters for AN5 ORM. Provides connection pooling, query execution, typed table clients in TypeScript, Python, .NET, and Google Sheets API.
-
-Adapters are runtime packages only. They do not import generated `an5Client` artifacts; generated clients or applications can pass model metadata explicitly when table-name mapping or field type coercion is needed.
+Standalone runtime adapters for AN5 ORM. Provides connection pooling, query execution, typed table clients in TypeScript, Python, .NET, and Google Sheets API.
+
+Adapters are runtime packages only. They do not import generated `an5Client` artifacts; generated clients or applications can pass model metadata explicitly when table-name mapping or field type coercion is needed.
 
 ## Features
 
@@ -19,7 +19,7 @@ Adapters are runtime packages only. They do not import generated `an5Client` art
 ### TypeScript
 
 ```bash
-npm install @an5/adapters
+npm install an5-adapters
 ```
 
 ### Python
@@ -39,17 +39,17 @@ dotnet add package An5Adapters
 ### TypeScript
 
 ```typescript
-import { createAn5Adapter, setAdapterMetadata } from '@an5/adapters';
-
-setAdapterMetadata({
-  modelToTable: { User: 'dbo.users' },
-  modelFields: {
-    User: {
-      id: { ts: 'string', sql: 'uniqueidentifier', isId: true },
-      active: { ts: 'boolean', sql: 'bit' },
-    },
-  },
-});
+import { createAn5Adapter, setAdapterMetadata } from 'an5-adapters';
+
+setAdapterMetadata({
+  modelToTable: { User: 'dbo.users' },
+  modelFields: {
+    User: {
+      id: { ts: 'string', sql: 'uniqueidentifier', isId: true },
+      active: { ts: 'boolean', sql: 'bit' },
+    },
+  },
+});
 
 const db = createAn5Adapter({
   connectionString: 'sqlserver://localhost:1433;database=mydb;user=sa;password=pass',
@@ -71,18 +71,18 @@ await db.$transaction(async (tx) => {
 ### Python
 
 ```python
-from an5_adapter import create_an5_adapter
-from base.metadata import set_adapter_metadata
-
-set_adapter_metadata({
-    "modelToTable": {"User": "dbo.users"},
-    "modelFields": {
-        "User": {
-            "id": {"py": "str", "sql": "uniqueidentifier", "isId": True},
-            "active": {"py": "bool", "sql": "bit"},
-        }
-    },
-})
+from an5_adapter import create_an5_adapter
+from base.metadata import set_adapter_metadata
+
+set_adapter_metadata({
+    "modelToTable": {"User": "dbo.users"},
+    "modelFields": {
+        "User": {
+            "id": {"py": "str", "sql": "uniqueidentifier", "isId": True},
+            "active": {"py": "bool", "sql": "bit"},
+        }
+    },
+})
 
 db = create_an5_adapter("sqlserver://localhost:1433;database=mydb;user=sa;password=pass")
 
@@ -120,9 +120,9 @@ db.Transaction(tx => {
 ### Google Sheets
 
 ```typescript
-import { createAn5Adapter } from '@an5/adapters';
-
-const db = createAn5Adapter({
+import { createAn5SheetsAdapter } from 'an5-adapters';
+
+const db = createAn5SheetsAdapter({
   spreadsheetId: '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms',
   // Option 1: client email + private key
   clientEmail: 'sa@project.iam.gserviceaccount.com',
@@ -160,7 +160,7 @@ await db.table('users').deleteAll();
 ### Integrated factory (auto-detect adapter)
 
 ```typescript
-import { createAn5Adapter, createAdapter, An5Adapter } from '@an5/adapters';
+import { createAn5Adapter, createAdapter, An5Adapter } from 'an5-adapters';
 
 // Auto-detects from connection string
 const sqlDb = createAn5Adapter({ connectionString: 'sqlserver://localhost:1433;database=mydb;user=sa;password=pass' });
@@ -189,18 +189,18 @@ const sheetsDb3 = new An5Adapter({
 - Numeric strings (without leading zeros) are auto-coerced; `"00123"` stays string
 - Boolean strings `"true"` / `"false"` are auto-coerced
 - Sheet names with spaces are automatically escaped (A1 notation)
-- Supports service account JSON or individual `clientEmail`+`privateKey`
-- Automatic retry with exponential backoff for rate limits (429/500/503)
-
-### Provider Imports
-
-Use the package root for normal applications:
-
-```typescript
-import { createAn5Adapter } from '@an5/adapters';
-```
-
-Provider folders are still available to source-level consumers through `typescript/*`, but the public factory in `typescript/an5Adapter.ts` is the preferred entry point. The old `unified.ts` entry point has been removed because the factory now lives directly in `An5Adapter`.
+- Supports service account JSON or individual `clientEmail`+`privateKey`
+- Automatic retry with exponential backoff for rate limits (429/500/503)
+
+### Provider Imports
+
+Use the package root for normal applications:
+
+```typescript
+import { createAn5Adapter, createAn5SheetsAdapter } from 'an5-adapters';
+```
+
+Provider folders are still available to source-level consumers through `typescript/*`, but the public factory in `typescript/an5Adapter.ts` is the preferred entry point. The old `unified.ts` entry point has been removed because the factory now lives directly in `An5Adapter`.
 
 ## API Reference
 
@@ -245,7 +245,7 @@ Provider folders are still available to source-level consumers through `typescri
 - TypeScript providers live under `typescript/{base,mssql,postgres,mysql,sqlite,googlesheets}`.
 - Python providers live under `python/{base,mssql,postgres}`, with `python/an5_adapter.py` kept as the public facade.
 - .NET providers live under `dotnet/{Base,Mssql,Postgres}`, with `dotnet/an5Adapter.cs` kept as the public facade.
-- Adapters do not depend on generated `an5Client` artifacts; generated clients may pass metadata in explicitly when they need model/table mapping.
+- Adapters do not depend on generated `an5-client` artifacts; generated clients may pass metadata in explicitly when they need model/table mapping.
 
 ## Testing