@an5/orm 1.3.0 → 1.3.2

package/dist/generator/src/dotnet-generator.js

@@ -968,9 +968,22 @@ namespace An5Orm
                 {
                     try
                     {
-                        if (rawVal is string jsonStr)
+                        if (rawVal is List<double> dblList)
                         {
-                            rowVector = ParseDoubleArray(jsonStr);
+                            rowVector = dblList;
+                        }
+                        else
+                        {
+                            var decoded = DecodeVectorColumn(rawVal);
+                            if (decoded != null)
+                            {
+                                rowVector = new List<double>(decoded.Length);
+                                for (int i = 0; i < decoded.Length; i++) rowVector.Add(decoded[i]);
+                            }
+                            else if (rawVal is string jsonStr)
+                            {
+                                rowVector = ParseDoubleArray(jsonStr);
+                            }
                         }
                     }
                     catch { }
@@ -978,8 +991,31 @@ namespace An5Orm
 
                 if (rowVector != null && rowVector.Count == vector.Count)
                 {
-                    double sim = CosineSimilarity(vector, rowVector);
-                    double distance = distanceMetric.Equals("cosine", StringComparison.OrdinalIgnoreCase) ? (1.0 - sim) : sim;
+                    double distance;
+                    if (distanceMetric.Equals("euclidean", StringComparison.OrdinalIgnoreCase) || distanceMetric.Equals("l2", StringComparison.OrdinalIgnoreCase))
+                    {
+                        double sum = 0.0;
+                        for (int i = 0; i < vector.Count; i++)
+                        {
+                            double diff = vector[i] - rowVector[i];
+                            sum += diff * diff;
+                        }
+                        distance = Math.Sqrt(sum);
+                    }
+                    else if (distanceMetric.Equals("dot", StringComparison.OrdinalIgnoreCase) || distanceMetric.Equals("inner_product", StringComparison.OrdinalIgnoreCase) || distanceMetric.Equals("ip", StringComparison.OrdinalIgnoreCase))
+                    {
+                        double dot = 0.0;
+                        for (int i = 0; i < vector.Count; i++)
+                        {
+                            dot += vector[i] * rowVector[i];
+                        }
+                        distance = -dot;
+                    }
+                    else
+                    {
+                        double sim = CosineSimilarity(vector, rowVector);
+                        distance = 1.0 - sim;
+                    }
                     results.Add(Tuple.Create(row, distance));
                 }
             }

package/dist/generator/src/golang-generator.js

@@ -1157,37 +1157,39 @@ func (c *TableClient[T]) VectorSearch(ctx context.Context, vector []float64, opt
 \tvecStr := string(vecBytes)
 
 \t// 1. Primary path: dialect-aware native SQL vector query
-\tvar sqlQuery string
-\tqueryArgs := append([]interface{}{vecStr}, whereQueryArgs...)
-\tif c.Dialect == DialectPostgres {
-\t\top := "<=>"
-\t\tif strings.EqualFold(distanceMetric, "euclidean") { op = "<->" }
-\t\tif strings.EqualFold(distanceMetric, "dot") { op = "<#>" }
-\t\tvcol := c.quoteName(vectorField)
-\t\tsqlQuery = fmt.Sprintf("SELECT *, (%s %s $1::vector) AS distance FROM %s", vcol, op, c.quoteTable())
-\t\tif whereCl != "" {
-\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL AND (%s)", vcol, whereCl)
-\t\t} else {
-\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL", vcol)
-\t\t}
-\t\tsqlQuery += fmt.Sprintf(" ORDER BY distance ASC LIMIT %d", take)
-\t} else {
-\t\tvcol := c.quoteName(vectorField)
-\t\tsqlQuery = fmt.Sprintf(
-\t\t\t"SELECT TOP (%d) *, VECTOR_DISTANCE('%s', CAST(%s AS VECTOR(%d, float32)), CAST(? AS VECTOR(%d, float32))) AS distance FROM %s WITH (NOLOCK)",
-\t\t\ttake, distanceMetric, vcol, dim, dim, c.quoteTable(),
-\t\t)
-\t\tif whereCl != "" {
-\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL AND (%s)", vcol, whereCl)
+\tif c.Dialect != DialectSqlite {
+\t\tvar sqlQuery string
+\t\tqueryArgs := append([]interface{}{vecStr}, whereQueryArgs...)
+\t\tif c.Dialect == DialectPostgres {
+\t\t\top := "<=>"
+\t\t\tif strings.EqualFold(distanceMetric, "euclidean") { op = "<->" }
+\t\t\tif strings.EqualFold(distanceMetric, "dot") { op = "<#>" }
+\t\t\tvcol := c.quoteName(vectorField)
+\t\t\tsqlQuery = fmt.Sprintf("SELECT *, (%s %s $1::vector) AS distance FROM %s", vcol, op, c.quoteTable())
+\t\t\tif whereCl != "" {
+\t\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL AND (%s)", vcol, whereCl)
+\t\t\t} else {
+\t\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL", vcol)
+\t\t\t}
+\t\t\tsqlQuery += fmt.Sprintf(" ORDER BY distance ASC LIMIT %d", take)
 \t\t} else {
-\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL", vcol)
+\t\t\tvcol := c.quoteName(vectorField)
+\t\t\tsqlQuery = fmt.Sprintf(
+\t\t\t\t"SELECT TOP (%d) *, VECTOR_DISTANCE('%s', CAST(%s AS VECTOR(%d, float32)), CAST(? AS VECTOR(%d, float32))) AS distance FROM %s WITH (NOLOCK)",
+\t\t\t\ttake, distanceMetric, vcol, dim, dim, c.quoteTable(),
+\t\t\t)
+\t\t\tif whereCl != "" {
+\t\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL AND (%s)", vcol, whereCl)
+\t\t\t} else {
+\t\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL", vcol)
+\t\t\t}
+\t\t\tsqlQuery += " ORDER BY distance ASC"
 \t\t}
-\t\tsqlQuery += " ORDER BY distance ASC"
-\t}
 
-\tnativeRows, nativeErr := c.queryAndScan(ctx, sqlQuery, queryArgs...)
-\tif nativeErr == nil {
-\t\treturn nativeRows, nil
+\t\tnativeRows, nativeErr := c.queryAndScan(ctx, sqlQuery, queryArgs...)
+\t\tif nativeErr == nil {
+\t\t\treturn nativeRows, nil
+\t\t}
 \t}
 
 \t// 2. Fallback: in-memory similarity

package/dist/generator/src/java-generator.js

@@ -1243,7 +1243,9 @@ import an5.adapters.An5Adapter;
  *
  * <pre>
  * try (An5DbContext db = new An5DbContext(An5Config.connectionString())) {
- *   User ada = db.getUser().findUnique(Filters.eq("name", "Ada"));
+ *   An5OrmTypes.UserWhere where = new An5OrmTypes.UserWhere();
+ *   where.Name = An5OrmTypes.StringFilter.is("Ada");
+ *   User ada = db.getUser().findUnique(where.toMap());
  * }
  * </pre>
  */

package/dist/generator/src/python-generator.js

@@ -56,7 +56,7 @@ class PythonGenerator {
     }
     generateOrmTypes(models, outputDir) {
         let content = '# This file is auto-generated. Do not edit directly.\n';
-        content += '"""\nAN5 ORM typed filter/args dataclasses for type-safe queries.\n\nUsage example::\n\n    db.user.find_many(where=UserWhereInput(name=StringFilter(contains="John")),\n                      order_by=UserOrderByInput(created_at="desc"),\n                      take=10)\n"""\n';
+        content += '"""\nAN5 ORM typed filter/args dataclasses.\n\nThese describe the filter shapes the Python client accepts. The adapter reads plain\ndicts, not these dataclasses, and it quotes every key verbatim, so use the schema\nfield names (`createdAt`, not `created_at`):\n\n    db.user.find_many(where={"name": {"contains": "John"}},\n                      order_by={"createdAt": "desc"},\n                      take=10)\n"""\n';
         content += 'from __future__ import annotations\n';
         content += 'from dataclasses import dataclass, field\n';
         content += 'from typing import List, Optional, Any\n';
@@ -318,9 +318,11 @@ class PythonGenerator {
         }
         content += 'class An5Client:\n';
         content += '    """AN5 Python ORM Client - type-safe database access.\n\n';
+        content += '    Query keys are schema field names, used verbatim: the SQL builder quotes a key\n';
+        content += '    as-is, so `createdAt` reaches the database and `created_at` does not.\n\n';
         content += '    Usage:\n';
         content += '        db = An5Client()\n';
-        content += '        users = db.user.find_many(where={"name": {"contains": "John"}}, order_by={"created_at": "asc"}, take=10)\n';
+        content += '        users = db.user.find_many(where={"name": {"contains": "John"}}, order_by={"createdAt": "asc"}, take=10)\n';
         content += '        user  = db.user.find_first(where={"id": "abc"})\n';
         content += '        new   = db.user.create(data={"name": "Alice", "email": "alice@example.com"})\n';
         content += '    """\n';

package/generator/src/dotnet-generator.ts

@@ -986,9 +986,22 @@ namespace An5Orm
                 {
                     try
                     {
-                        if (rawVal is string jsonStr)
+                        if (rawVal is List<double> dblList)
                         {
-                            rowVector = ParseDoubleArray(jsonStr);
+                            rowVector = dblList;
+                        }
+                        else
+                        {
+                            var decoded = DecodeVectorColumn(rawVal);
+                            if (decoded != null)
+                            {
+                                rowVector = new List<double>(decoded.Length);
+                                for (int i = 0; i < decoded.Length; i++) rowVector.Add(decoded[i]);
+                            }
+                            else if (rawVal is string jsonStr)
+                            {
+                                rowVector = ParseDoubleArray(jsonStr);
+                            }
                         }
                     }
                     catch { }
@@ -996,8 +1009,31 @@ namespace An5Orm
 
                 if (rowVector != null && rowVector.Count == vector.Count)
                 {
-                    double sim = CosineSimilarity(vector, rowVector);
-                    double distance = distanceMetric.Equals("cosine", StringComparison.OrdinalIgnoreCase) ? (1.0 - sim) : sim;
+                    double distance;
+                    if (distanceMetric.Equals("euclidean", StringComparison.OrdinalIgnoreCase) || distanceMetric.Equals("l2", StringComparison.OrdinalIgnoreCase))
+                    {
+                        double sum = 0.0;
+                        for (int i = 0; i < vector.Count; i++)
+                        {
+                            double diff = vector[i] - rowVector[i];
+                            sum += diff * diff;
+                        }
+                        distance = Math.Sqrt(sum);
+                    }
+                    else if (distanceMetric.Equals("dot", StringComparison.OrdinalIgnoreCase) || distanceMetric.Equals("inner_product", StringComparison.OrdinalIgnoreCase) || distanceMetric.Equals("ip", StringComparison.OrdinalIgnoreCase))
+                    {
+                        double dot = 0.0;
+                        for (int i = 0; i < vector.Count; i++)
+                        {
+                            dot += vector[i] * rowVector[i];
+                        }
+                        distance = -dot;
+                    }
+                    else
+                    {
+                        double sim = CosineSimilarity(vector, rowVector);
+                        distance = 1.0 - sim;
+                    }
                     results.Add(Tuple.Create(row, distance));
                 }
             }

package/generator/src/golang-generator.ts

@@ -1180,37 +1180,39 @@ func (c *TableClient[T]) VectorSearch(ctx context.Context, vector []float64, opt
 \tvecStr := string(vecBytes)
 
 \t// 1. Primary path: dialect-aware native SQL vector query
-\tvar sqlQuery string
-\tqueryArgs := append([]interface{}{vecStr}, whereQueryArgs...)
-\tif c.Dialect == DialectPostgres {
-\t\top := "<=>"
-\t\tif strings.EqualFold(distanceMetric, "euclidean") { op = "<->" }
-\t\tif strings.EqualFold(distanceMetric, "dot") { op = "<#>" }
-\t\tvcol := c.quoteName(vectorField)
-\t\tsqlQuery = fmt.Sprintf("SELECT *, (%s %s $1::vector) AS distance FROM %s", vcol, op, c.quoteTable())
-\t\tif whereCl != "" {
-\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL AND (%s)", vcol, whereCl)
-\t\t} else {
-\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL", vcol)
-\t\t}
-\t\tsqlQuery += fmt.Sprintf(" ORDER BY distance ASC LIMIT %d", take)
-\t} else {
-\t\tvcol := c.quoteName(vectorField)
-\t\tsqlQuery = fmt.Sprintf(
-\t\t\t"SELECT TOP (%d) *, VECTOR_DISTANCE('%s', CAST(%s AS VECTOR(%d, float32)), CAST(? AS VECTOR(%d, float32))) AS distance FROM %s WITH (NOLOCK)",
-\t\t\ttake, distanceMetric, vcol, dim, dim, c.quoteTable(),
-\t\t)
-\t\tif whereCl != "" {
-\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL AND (%s)", vcol, whereCl)
+\tif c.Dialect != DialectSqlite {
+\t\tvar sqlQuery string
+\t\tqueryArgs := append([]interface{}{vecStr}, whereQueryArgs...)
+\t\tif c.Dialect == DialectPostgres {
+\t\t\top := "<=>"
+\t\t\tif strings.EqualFold(distanceMetric, "euclidean") { op = "<->" }
+\t\t\tif strings.EqualFold(distanceMetric, "dot") { op = "<#>" }
+\t\t\tvcol := c.quoteName(vectorField)
+\t\t\tsqlQuery = fmt.Sprintf("SELECT *, (%s %s $1::vector) AS distance FROM %s", vcol, op, c.quoteTable())
+\t\t\tif whereCl != "" {
+\t\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL AND (%s)", vcol, whereCl)
+\t\t\t} else {
+\t\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL", vcol)
+\t\t\t}
+\t\t\tsqlQuery += fmt.Sprintf(" ORDER BY distance ASC LIMIT %d", take)
 \t\t} else {
-\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL", vcol)
+\t\t\tvcol := c.quoteName(vectorField)
+\t\t\tsqlQuery = fmt.Sprintf(
+\t\t\t\t"SELECT TOP (%d) *, VECTOR_DISTANCE('%s', CAST(%s AS VECTOR(%d, float32)), CAST(? AS VECTOR(%d, float32))) AS distance FROM %s WITH (NOLOCK)",
+\t\t\t\ttake, distanceMetric, vcol, dim, dim, c.quoteTable(),
+\t\t\t)
+\t\t\tif whereCl != "" {
+\t\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL AND (%s)", vcol, whereCl)
+\t\t\t} else {
+\t\t\t\tsqlQuery += fmt.Sprintf(" WHERE %s IS NOT NULL", vcol)
+\t\t\t}
+\t\t\tsqlQuery += " ORDER BY distance ASC"
 \t\t}
-\t\tsqlQuery += " ORDER BY distance ASC"
-\t}
 
-\tnativeRows, nativeErr := c.queryAndScan(ctx, sqlQuery, queryArgs...)
-\tif nativeErr == nil {
-\t\treturn nativeRows, nil
+\t\tnativeRows, nativeErr := c.queryAndScan(ctx, sqlQuery, queryArgs...)
+\t\tif nativeErr == nil {
+\t\t\treturn nativeRows, nil
+\t\t}
 \t}
 
 \t// 2. Fallback: in-memory similarity

package/generator/src/java-generator.ts

@@ -1284,7 +1284,9 @@ import an5.adapters.An5Adapter;
  *
  * <pre>
  * try (An5DbContext db = new An5DbContext(An5Config.connectionString())) {
- *   User ada = db.getUser().findUnique(Filters.eq("name", "Ada"));
+ *   An5OrmTypes.UserWhere where = new An5OrmTypes.UserWhere();
+ *   where.Name = An5OrmTypes.StringFilter.is("Ada");
+ *   User ada = db.getUser().findUnique(where.toMap());
  * }
  * </pre>
  */

package/generator/src/python-generator.ts

@@ -64,7 +64,7 @@ export class PythonGenerator {
 
   private generateOrmTypes(models: Model[], outputDir: string) {
     let content = '# This file is auto-generated. Do not edit directly.\n';
-    content += '"""\nAN5 ORM typed filter/args dataclasses for type-safe queries.\n\nUsage example::\n\n    db.user.find_many(where=UserWhereInput(name=StringFilter(contains="John")),\n                      order_by=UserOrderByInput(created_at="desc"),\n                      take=10)\n"""\n';
+    content += '"""\nAN5 ORM typed filter/args dataclasses.\n\nThese describe the filter shapes the Python client accepts. The adapter reads plain\ndicts, not these dataclasses, and it quotes every key verbatim, so use the schema\nfield names (`createdAt`, not `created_at`):\n\n    db.user.find_many(where={"name": {"contains": "John"}},\n                      order_by={"createdAt": "desc"},\n                      take=10)\n"""\n';
     content += 'from __future__ import annotations\n';
     content += 'from dataclasses import dataclass, field\n';
     content += 'from typing import List, Optional, Any\n';
@@ -358,9 +358,11 @@ export class PythonGenerator {
 
     content += 'class An5Client:\n';
     content += '    """AN5 Python ORM Client - type-safe database access.\n\n';
+    content += '    Query keys are schema field names, used verbatim: the SQL builder quotes a key\n';
+    content += '    as-is, so `createdAt` reaches the database and `created_at` does not.\n\n';
     content += '    Usage:\n';
     content += '        db = An5Client()\n';
-    content += '        users = db.user.find_many(where={"name": {"contains": "John"}}, order_by={"created_at": "asc"}, take=10)\n';
+    content += '        users = db.user.find_many(where={"name": {"contains": "John"}}, order_by={"createdAt": "asc"}, take=10)\n';
     content += '        user  = db.user.find_first(where={"id": "abc"})\n';
     content += '        new   = db.user.create(data={"name": "Alice", "email": "alice@example.com"})\n';
     content += '    """\n';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@an5/orm",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "The lightweight ORM for SQL Server with support for TypeScript, Python, .NET (C#), Go, Rust, Java, Kotlin, and Swift.",
   "license": "MIT",
   "main": "dist/index.js",