@proteinjs/db-spanner-common 1.1.30 → 1.1.32

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.1.32](https://github.com/proteinjs/db/compare/@proteinjs/db-spanner-common@1.1.31...@proteinjs/db-spanner-common@1.1.32) (2026-06-08)
+
+
+### Bug Fixes
+
+* support top-level array values in JsonColumn ([6a4922b](https://github.com/proteinjs/db/commit/6a4922bb40487bb3e251a66408557c0d74635607))
+
+
+
+
+
 ## [1.1.30](https://github.com/proteinjs/db/compare/@proteinjs/db-spanner-common@1.1.29...@proteinjs/db-spanner-common@1.1.30) (2026-04-18)
 
 **Note:** Version bump only for package @proteinjs/db-spanner-common

package/dist/generated/index.js

@@ -19,7 +19,7 @@ require("@proteinjs/db");
 require("@proteinjs/logger");
 require("@proteinjs/reflection");
 /** Generate Source Graph */
-var sourceGraph = "{\"options\":{\"directed\":true,\"multigraph\":false,\"compound\":false},\"nodes\":[{\"v\":\"@proteinjs/db-spanner-common/JsonColumn\",\"value\":{\"packageName\":\"@proteinjs/db-spanner-common\",\"name\":\"JsonColumn\",\"filePath\":\"/home/runner/work/db/db/packages/spanner-common/src/columns/JsonColumn.ts\",\"qualifiedName\":\"@proteinjs/db-spanner-common/JsonColumn\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"name\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"},{\"name\":\"options\",\"type\":{\"packageName\":\"@proteinjs/db\",\"name\":\"ColumnOptions\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db/ColumnOptions\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"}],\"methods\":[{\"name\":\"serialize\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<T | null>\",\"filePath\":null,\"qualifiedName\":\"/Promise<T | null>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fieldValue\",\"type\":{\"packageName\":\"\",\"name\":\"T | null | undefined\",\"filePath\":null,\"qualifiedName\":\"/T | null | undefined\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"deserialize\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<T | null>\",\"filePath\":null,\"qualifiedName\":\"/Promise<T | null>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"serializedFieldValue\",\"type\":{\"packageName\":\"\",\"name\":\"T\",\"filePath\":null,\"qualifiedName\":\"/T\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[\"/T\"],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/db\",\"name\":\"Column\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db/Column\",\"properties\":[],\"methods\":[],\"typeParameters\":[\"/T\",\"/any\"],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/db/Column\"}],\"edges\":[{\"v\":\"@proteinjs/db-spanner-common/JsonColumn\",\"w\":\"@proteinjs/db/Column\",\"value\":\"implements interface\"}]}";
+var sourceGraph = "{\"options\":{\"directed\":true,\"multigraph\":false,\"compound\":false},\"nodes\":[{\"v\":\"@proteinjs/db-spanner-common/JsonColumn\",\"value\":{\"packageName\":\"@proteinjs/db-spanner-common\",\"name\":\"JsonColumn\",\"filePath\":\"/home/runner/work/db/db/packages/spanner-common/src/columns/JsonColumn.ts\",\"qualifiedName\":\"@proteinjs/db-spanner-common/JsonColumn\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"name\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"},{\"name\":\"options\",\"type\":{\"packageName\":\"@proteinjs/db\",\"name\":\"ColumnOptions\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db/ColumnOptions\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":true,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\"}],\"methods\":[{\"name\":\"serialize\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<any>\",\"filePath\":null,\"qualifiedName\":\"/Promise<any>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fieldValue\",\"type\":{\"packageName\":\"\",\"name\":\"T | null | undefined\",\"filePath\":null,\"qualifiedName\":\"/T | null | undefined\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"deserialize\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<T | null>\",\"filePath\":null,\"qualifiedName\":\"/Promise<T | null>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"serializedFieldValue\",\"type\":{\"packageName\":\"\",\"name\":\"any\",\"filePath\":null,\"qualifiedName\":\"/any\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[\"/T\"],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/db\",\"name\":\"Column\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db/Column\",\"properties\":[],\"methods\":[],\"typeParameters\":[\"/T\",\"/any\"],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/db/Column\"}],\"edges\":[{\"v\":\"@proteinjs/db-spanner-common/JsonColumn\",\"w\":\"@proteinjs/db/Column\",\"value\":\"implements interface\"}]}";
 /** Generate Source Links */
 var JsonColumn_1 = require("../src/columns/JsonColumn");
 var sourceLinks = {

package/dist/generated/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,yBAAuB;AACvB,6BAA2B;AAC3B,iCAA+B;AAG/B,4BAA4B;AAE5B,IAAM,WAAW,GAAG,k9EAAk9E,CAAC;AAGv+E,4BAA4B;AAE5B,wDAAuD;AAEvD,IAAM,WAAW,GAAG;IACnB,yCAAyC,EAAE,uBAAU;CACrD,CAAC;AAGF,kCAAkC;AAElC,oDAAyD;AACzD,6BAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAGjD,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,yBAAuB;AACvB,6BAA2B;AAC3B,iCAA+B;AAG/B,4BAA4B;AAE5B,IAAM,WAAW,GAAG,48EAA48E,CAAC;AAGj+E,4BAA4B;AAE5B,wDAAuD;AAEvD,IAAM,WAAW,GAAG;IACnB,yCAAyC,EAAE,uBAAU;CACrD,CAAC;AAGF,kCAAkC;AAElC,oDAAyD;AACzD,6BAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAGjD,2CAAyB"}

package/dist/src/columns/JsonColumn.d.ts

@@ -1,9 +1,20 @@
 import { Column, ColumnOptions } from '@proteinjs/db';
+/**
+ * A column backed by a Spanner `JSON` value.
+ *
+ * Spanner infers a DML parameter's type from the JS value's shape, so a top-level
+ * ARRAY is sent as `ARRAY<JSON>` — which a `JSON` column rejects ("Value has type
+ * ARRAY<JSON> which cannot be inserted into column ..., which has type JSON"). To
+ * let a JSON column hold an array, we wrap arrays in a single marker object on
+ * write (so the driver sends one JSON document) and unwrap on read. Object values
+ * pass through untouched, so object-valued JSON columns are unaffected. The
+ * wrapping is invisible to consumers — the field round-trips as the same array.
+ */
 export declare class JsonColumn<T> implements Column<T, any> {
     name: string;
     options?: ColumnOptions | undefined;
     constructor(name: string, options?: ColumnOptions | undefined);
-    serialize(fieldValue: T | null | undefined): Promise<T | null>;
-    deserialize(serializedFieldValue: T): Promise<T | null>;
+    serialize(fieldValue: T | null | undefined): Promise<any>;
+    deserialize(serializedFieldValue: any): Promise<T | null>;
 }
 //# sourceMappingURL=JsonColumn.d.ts.map

package/dist/src/columns/JsonColumn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JsonColumn.d.ts","sourceRoot":"","sources":["../../../src/columns/JsonColumn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEtD,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC;IAEzC,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC;gBADR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,2BAAe;IAG1B,SAAS,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAQ9D,WAAW,CAAC,oBAAoB,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAO9D"}
+{"version":3,"file":"JsonColumn.d.ts","sourceRoot":"","sources":["../../../src/columns/JsonColumn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQtD;;;;;;;;;;GAUG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC;IAEzC,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC;gBADR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,2BAAe;IAG1B,SAAS,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC;IAYzD,WAAW,CAAC,oBAAoB,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAgBhE"}

package/dist/src/columns/JsonColumn.js

@@ -37,6 +37,22 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JsonColumn = void 0;
+/**
+ * Reserved key used to wrap a top-level array stored in a JSON column. Namespaced
+ * so it cannot collide with a real object value's own fields. See JsonColumn.
+ */
+var JSON_ARRAY_MARKER = '__jsonColumnArray';
+/**
+ * A column backed by a Spanner `JSON` value.
+ *
+ * Spanner infers a DML parameter's type from the JS value's shape, so a top-level
+ * ARRAY is sent as `ARRAY<JSON>` — which a `JSON` column rejects ("Value has type
+ * ARRAY<JSON> which cannot be inserted into column ..., which has type JSON"). To
+ * let a JSON column hold an array, we wrap arrays in a single marker object on
+ * write (so the driver sends one JSON document) and unwrap on read. Object values
+ * pass through untouched, so object-valued JSON columns are unaffected. The
+ * wrapping is invisible to consumers — the field round-trips as the same array.
+ */
 var JsonColumn = /** @class */ (function () {
     function JsonColumn(name, options) {
         this.name = name;
@@ -44,10 +60,14 @@ var JsonColumn = /** @class */ (function () {
     }
     JsonColumn.prototype.serialize = function (fieldValue) {
         return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
+            var _a;
+            return __generator(this, function (_b) {
                 if (fieldValue === undefined || fieldValue == null) {
                     return [2 /*return*/, null];
                 }
+                if (Array.isArray(fieldValue)) {
+                    return [2 /*return*/, (_a = {}, _a[JSON_ARRAY_MARKER] = fieldValue, _a)];
+                }
                 return [2 /*return*/, fieldValue];
             });
         });
@@ -58,6 +78,13 @@ var JsonColumn = /** @class */ (function () {
                 if (serializedFieldValue === undefined || serializedFieldValue == null) {
                     return [2 /*return*/, null];
                 }
+                // A raw array can appear if a row predates this wrapping; pass it through.
+                if (Array.isArray(serializedFieldValue)) {
+                    return [2 /*return*/, serializedFieldValue];
+                }
+                if (typeof serializedFieldValue === 'object' && Array.isArray(serializedFieldValue[JSON_ARRAY_MARKER])) {
+                    return [2 /*return*/, serializedFieldValue[JSON_ARRAY_MARKER]];
+                }
                 return [2 /*return*/, serializedFieldValue];
             });
         });

package/dist/src/columns/JsonColumn.js.map

@@ -1 +1 @@
-{"version":3,"file":"JsonColumn.js","sourceRoot":"","sources":["../../../src/columns/JsonColumn.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;IACE,oBACS,IAAY,EACZ,OAAuB;QADvB,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAgB;IAC7B,CAAC;IAEE,8BAAS,GAAf,UAAgB,UAAgC;;;gBAC9C,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,IAAI,IAAI,EAAE;oBAClD,sBAAO,IAAI,EAAC;iBACb;gBAED,sBAAO,UAAU,EAAC;;;KACnB;IAEK,gCAAW,GAAjB,UAAkB,oBAAuB;;;gBACvC,IAAI,oBAAoB,KAAK,SAAS,IAAI,oBAAoB,IAAI,IAAI,EAAE;oBACtE,sBAAO,IAAI,EAAC;iBACb;gBAED,sBAAO,oBAAoB,EAAC;;;KAC7B;IACH,iBAAC;AAAD,CAAC,AArBD,IAqBC;AArBY,gCAAU"}
+{"version":3,"file":"JsonColumn.js","sourceRoot":"","sources":["../../../src/columns/JsonColumn.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;GAGG;AACH,IAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAE9C;;;;;;;;;;GAUG;AACH;IACE,oBACS,IAAY,EACZ,OAAuB;QADvB,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAgB;IAC7B,CAAC;IAEE,8BAAS,GAAf,UAAgB,UAAgC;;;;gBAC9C,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,IAAI,IAAI,EAAE;oBAClD,sBAAO,IAAI,EAAC;iBACb;gBAED,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;oBAC7B,gCAAS,GAAC,iBAAiB,IAAG,UAAU,OAAG;iBAC5C;gBAED,sBAAO,UAAU,EAAC;;;KACnB;IAEK,gCAAW,GAAjB,UAAkB,oBAAyB;;;gBACzC,IAAI,oBAAoB,KAAK,SAAS,IAAI,oBAAoB,IAAI,IAAI,EAAE;oBACtE,sBAAO,IAAI,EAAC;iBACb;gBAED,2EAA2E;gBAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE;oBACvC,sBAAO,oBAAyB,EAAC;iBAClC;gBAED,IAAI,OAAO,oBAAoB,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,EAAE;oBACtG,sBAAO,oBAAoB,CAAC,iBAAiB,CAAM,EAAC;iBACrD;gBAED,sBAAO,oBAAyB,EAAC;;;KAClC;IACH,iBAAC;AAAD,CAAC,AAlCD,IAkCC;AAlCY,gCAAU"}

package/generated/index.ts

@@ -7,7 +7,7 @@ import '@proteinjs/reflection';
 /** Generate Source Graph */
 
 const sourceGraph =
-  '{"options":{"directed":true,"multigraph":false,"compound":false},"nodes":[{"v":"@proteinjs/db-spanner-common/JsonColumn","value":{"packageName":"@proteinjs/db-spanner-common","name":"JsonColumn","filePath":"/home/runner/work/db/db/packages/spanner-common/src/columns/JsonColumn.ts","qualifiedName":"@proteinjs/db-spanner-common/JsonColumn","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"name","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"},{"name":"options","type":{"packageName":"@proteinjs/db","name":"ColumnOptions","filePath":null,"qualifiedName":"@proteinjs/db/ColumnOptions","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"public"}],"methods":[{"name":"serialize","returnType":{"packageName":"","name":"Promise<T | null>","filePath":null,"qualifiedName":"/Promise<T | null>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fieldValue","type":{"packageName":"","name":"T | null | undefined","filePath":null,"qualifiedName":"/T | null | undefined","typeParameters":null,"directParents":null}}]},{"name":"deserialize","returnType":{"packageName":"","name":"Promise<T | null>","filePath":null,"qualifiedName":"/Promise<T | null>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"serializedFieldValue","type":{"packageName":"","name":"T","filePath":null,"qualifiedName":"/T","typeParameters":null,"directParents":null}}]}],"typeParameters":["/T"],"directParentInterfaces":[{"packageName":"@proteinjs/db","name":"Column","filePath":null,"qualifiedName":"@proteinjs/db/Column","properties":[],"methods":[],"typeParameters":["/T","/any"],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/db/Column"}],"edges":[{"v":"@proteinjs/db-spanner-common/JsonColumn","w":"@proteinjs/db/Column","value":"implements interface"}]}';
+  '{"options":{"directed":true,"multigraph":false,"compound":false},"nodes":[{"v":"@proteinjs/db-spanner-common/JsonColumn","value":{"packageName":"@proteinjs/db-spanner-common","name":"JsonColumn","filePath":"/home/runner/work/db/db/packages/spanner-common/src/columns/JsonColumn.ts","qualifiedName":"@proteinjs/db-spanner-common/JsonColumn","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"name","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public"},{"name":"options","type":{"packageName":"@proteinjs/db","name":"ColumnOptions","filePath":null,"qualifiedName":"@proteinjs/db/ColumnOptions","typeParameters":null,"directParents":null},"isOptional":true,"isAbstract":false,"isStatic":false,"visibility":"public"}],"methods":[{"name":"serialize","returnType":{"packageName":"","name":"Promise<any>","filePath":null,"qualifiedName":"/Promise<any>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fieldValue","type":{"packageName":"","name":"T | null | undefined","filePath":null,"qualifiedName":"/T | null | undefined","typeParameters":null,"directParents":null}}]},{"name":"deserialize","returnType":{"packageName":"","name":"Promise<T | null>","filePath":null,"qualifiedName":"/Promise<T | null>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"serializedFieldValue","type":{"packageName":"","name":"any","filePath":null,"qualifiedName":"/any","typeParameters":null,"directParents":null}}]}],"typeParameters":["/T"],"directParentInterfaces":[{"packageName":"@proteinjs/db","name":"Column","filePath":null,"qualifiedName":"@proteinjs/db/Column","properties":[],"methods":[],"typeParameters":["/T","/any"],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/db/Column"}],"edges":[{"v":"@proteinjs/db-spanner-common/JsonColumn","w":"@proteinjs/db/Column","value":"implements interface"}]}';
 
 /** Generate Source Links */
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteinjs/db-spanner-common",
-  "version": "1.1.30",
+  "version": "1.1.32",
   "description": "Common libs for Google Spanner",
   "publishConfig": {
     "access": "public"
@@ -21,12 +21,12 @@
     "watch": "reflection-watch"
   },
   "dependencies": {
-    "@proteinjs/db": "^1.21.9",
-    "@proteinjs/logger": "^1.0.18",
+    "@proteinjs/db": "^1.21.10",
+    "@proteinjs/logger": "^1.0.19",
     "@proteinjs/reflection": "^1.1.11"
   },
   "devDependencies": {
-    "@proteinjs/reflection-build": "^1.4.6",
+    "@proteinjs/reflection-build": "^1.4.7",
     "@types/jest": "29.5.5",
     "@types/node": "14.0.27",
     "@typescript-eslint/eslint-plugin": "7.8.0",
@@ -40,5 +40,5 @@
   },
   "main": "./dist/generated/index.js",
   "types": "./dist/generated/index.d.ts",
-  "gitHead": "75411714e31c9033803f328cb43fa922d77d9782"
+  "gitHead": "504df2602db4460ac0d941ef94e0681a52209f73"
 }

package/src/columns/JsonColumn.ts

@@ -1,24 +1,54 @@
 import { Column, ColumnOptions } from '@proteinjs/db';
 
+/**
+ * Reserved key used to wrap a top-level array stored in a JSON column. Namespaced
+ * so it cannot collide with a real object value's own fields. See JsonColumn.
+ */
+const JSON_ARRAY_MARKER = '__jsonColumnArray';
+
+/**
+ * A column backed by a Spanner `JSON` value.
+ *
+ * Spanner infers a DML parameter's type from the JS value's shape, so a top-level
+ * ARRAY is sent as `ARRAY<JSON>` — which a `JSON` column rejects ("Value has type
+ * ARRAY<JSON> which cannot be inserted into column ..., which has type JSON"). To
+ * let a JSON column hold an array, we wrap arrays in a single marker object on
+ * write (so the driver sends one JSON document) and unwrap on read. Object values
+ * pass through untouched, so object-valued JSON columns are unaffected. The
+ * wrapping is invisible to consumers — the field round-trips as the same array.
+ */
 export class JsonColumn<T> implements Column<T, any> {
   constructor(
     public name: string,
     public options?: ColumnOptions
   ) {}
 
-  async serialize(fieldValue: T | null | undefined): Promise<T | null> {
+  async serialize(fieldValue: T | null | undefined): Promise<any> {
     if (fieldValue === undefined || fieldValue == null) {
       return null;
     }
 
+    if (Array.isArray(fieldValue)) {
+      return { [JSON_ARRAY_MARKER]: fieldValue };
+    }
+
     return fieldValue;
   }
 
-  async deserialize(serializedFieldValue: T): Promise<T | null> {
+  async deserialize(serializedFieldValue: any): Promise<T | null> {
     if (serializedFieldValue === undefined || serializedFieldValue == null) {
       return null;
     }
 
-    return serializedFieldValue;
+    // A raw array can appear if a row predates this wrapping; pass it through.
+    if (Array.isArray(serializedFieldValue)) {
+      return serializedFieldValue as T;
+    }
+
+    if (typeof serializedFieldValue === 'object' && Array.isArray(serializedFieldValue[JSON_ARRAY_MARKER])) {
+      return serializedFieldValue[JSON_ARRAY_MARKER] as T;
+    }
+
+    return serializedFieldValue as T;
   }
 }