fix: align models with server responses and add integration tests

Fix DatabaseTableColumn, DatabaseTableForeignKey, FunctionMetadata,
and DatabaseMetadata models to match actual server camelCase fields.
Fix FunctionsClient.list_functions to handle wrapped response format.
Add 15 integration tests covering auth, database CRUD, functions,
metadata, and table admin.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: jwfing

insforge/database/models.py

@@ -15,28 +15,31 @@ class DatabaseQueryResponse(BaseModel):
 class DatabaseTableForeignKey(BaseModel):
     model_config = ConfigDict(extra="ignore", populate_by_name=True)
 
-    table: str
-    column: str
-    on_delete: str = Field(alias="on_delete")
+    constraint_name: str | None = Field(default=None, alias="constraint_name")
+    reference_table: str = Field(alias="referenceTable")
+    reference_column: str = Field(alias="referenceColumn")
+    on_delete: str = Field(default="NO ACTION", alias="onDelete")
+    on_update: str | None = Field(default=None, alias="onUpdate")
 
 
 class DatabaseTableColumn(BaseModel):
     model_config = ConfigDict(extra="ignore", populate_by_name=True)
 
-    name: str
+    name: str = Field(alias="columnName")
     type: str
-    nullable: bool
-    unique: bool
-    default: str | None = None
+    nullable: bool = Field(alias="isNullable")
+    unique: bool = Field(alias="isUnique")
+    default_value: str | None = Field(default=None, alias="defaultValue")
     is_primary_key: bool = Field(alias="isPrimaryKey")
     foreign_key: DatabaseTableForeignKey | None = Field(default=None, alias="foreignKey")
 
 
 class DatabaseTableSchemaResponse(BaseModel):
     model_config = ConfigDict(extra="ignore", populate_by_name=True)
 
-    table_name: str
+    table_name: str = Field(alias="tableName")
     columns: list[DatabaseTableColumn] = Field(default_factory=list)
+    record_count: int | str | None = Field(default=None, alias="recordCount")
 
 
 ColumnType = Literal["string", "datetime", "integer", "float", "boolean", "uuid", "json", "file"]

insforge/functions/client.py

@@ -86,7 +86,8 @@ async def list_functions(self, *, access_token: str | None = None) -> list[Funct
             "/api/functions",
             access_token=access_token,
         )
-        return [FunctionMetadata.model_validate(item) for item in payload]
+        items = payload.get("functions", []) if isinstance(payload, dict) else payload
+        return [FunctionMetadata.model_validate(item) for item in items]
 
     async def get_function(
         self,

insforge/functions/models.py

@@ -11,16 +11,16 @@
 
 
 class FunctionMetadata(BaseModel):
-    model_config = ConfigDict(extra="ignore")
+    model_config = ConfigDict(extra="ignore", populate_by_name=True)
 
     id: str
     slug: str
     name: str
     description: str | None = None
     status: Literal["draft", "active", "error"]
-    created_at: datetime
-    updated_at: datetime
-    deployed_at: datetime | None = None
+    created_at: datetime = Field(alias="createdAt")
+    updated_at: datetime = Field(alias="updatedAt")
+    deployed_at: datetime | None = Field(default=None, alias="deployedAt")
 
 
 class FunctionDetails(FunctionMetadata):

insforge/metadata/models.py

@@ -30,18 +30,16 @@ class AppMetadata(BaseModel):
 class DatabaseMetadataTable(BaseModel):
     model_config = ConfigDict(extra="ignore", populate_by_name=True)
 
-    name: str
+    name: str = Field(alias="tableName")
     record_count: int = Field(alias="recordCount")
 
 
 class DatabaseMetadata(BaseModel):
     model_config = ConfigDict(extra="ignore", populate_by_name=True)
 
     tables: list[DatabaseMetadataTable] = Field(default_factory=list)
-    total_tables: int = Field(alias="totalTables")
-    total_records: int = Field(alias="totalRecords")
-    database_size: str = Field(alias="databaseSize")
-    last_updated: datetime = Field(alias="lastUpdated")
+    total_size_in_gb: float | None = Field(default=None, alias="totalSizeInGB")
+    hint: str | None = None
 
 
 class ApiKeyMetadata(BaseModel):

tests/database/test_database_admin.py

@@ -51,14 +51,14 @@ async def fake_request(method: str, url: httpx.URL, **kwargs: object) -> httpx.R
             return httpx.Response(
                 200,
                 json={
-                    "table_name": "posts",
+                    "tableName": "posts",
                     "columns": [
                         {
-                            "name": "id",
+                            "columnName": "id",
                             "type": "uuid",
-                            "nullable": False,
-                            "unique": True,
-                            "default": "gen_random_uuid()",
+                            "isNullable": False,
+                            "isUnique": True,
+                            "defaultValue": "gen_random_uuid()",
                             "isPrimaryKey": True,
                             "foreignKey": None,
                         }
@@ -95,7 +95,7 @@ async def fake_request(method: str, url: httpx.URL, **kwargs: object) -> httpx.R
             captured["method"] = method
             captured["url"] = str(url)
             captured["kwargs"] = kwargs
-            return httpx.Response(200, json={"table_name": "analytics/events", "columns": []})
+            return httpx.Response(200, json={"tableName": "analytics/events", "columns": []})
 
         async with InsforgeClient(
             base_url="https://example.com",

tests/functions/test_functions_client.py

@@ -138,18 +138,20 @@ async def fake_request(method: str, url: httpx.URL, **kwargs: object) -> httpx.R
             captured["kwargs"] = kwargs
             return httpx.Response(
                 200,
-                json=[
-                    {
-                        "id": "123e4567-e89b-12d3-a456-426614174000",
-                        "slug": "hello-world",
-                        "name": "Hello World Function",
-                        "description": "Returns a greeting message",
-                        "status": "active",
-                        "created_at": "2024-01-21T10:30:00Z",
-                        "updated_at": "2024-01-21T10:35:00Z",
-                        "deployed_at": "2024-01-21T10:35:00Z",
-                    }
-                ],
+                json={
+                    "functions": [
+                        {
+                            "id": "123e4567-e89b-12d3-a456-426614174000",
+                            "slug": "hello-world",
+                            "name": "Hello World Function",
+                            "description": "Returns a greeting message",
+                            "status": "active",
+                            "createdAt": "2024-01-21T10:30:00Z",
+                            "updatedAt": "2024-01-21T10:35:00Z",
+                            "deployedAt": "2024-01-21T10:35:00Z",
+                        }
+                    ],
+                },
             )
 
         async with InsforgeClient(

tests/metadata/test_metadata_client.py

@@ -64,13 +64,10 @@ async def fake_request(method: str, url: httpx.URL, **kwargs: object) -> httpx.R
                 200,
                 json={
                     "tables": [
-                        {"name": "posts", "recordCount": 42},
-                        {"name": "comments", "recordCount": 57},
+                        {"tableName": "posts", "recordCount": 42},
+                        {"tableName": "comments", "recordCount": 57},
                     ],
-                    "totalTables": 2,
-                    "totalRecords": 99,
-                    "databaseSize": "128 MB",
-                    "lastUpdated": "2026-03-28T00:00:00Z",
+                    "totalSizeInGB": 0.128,
                 },
             )
 
@@ -89,7 +86,7 @@ async def fake_request(method: str, url: httpx.URL, **kwargs: object) -> httpx.R
     assert captured["kwargs"]["headers"]["X-API-Key"] == "ins_test"
     assert captured["kwargs"]["headers"]["Authorization"] == "Bearer admin_token"
     assert isinstance(result, DatabaseMetadata)
-    assert result.total_records == 99
+    assert result.total_size_in_gb == 0.128
     assert result.tables[0].name == "posts"