@syncular/core 0.30.16 → 0.32.0

package/dist/errors.d.ts

@@ -12,3 +12,13 @@ export declare class DecodeError extends Error {
     readonly code: string;
     constructor(code: string, message: string);
 }
+/**
+ * A value the row codec cannot encode (SPEC.md §7.1 authoring validation,
+ * §6.1 push payloads). Structural failures stay plain `Error`s; this class
+ * marks exactly the value refusals, so a client can classify them without
+ * inspecting message text.
+ */
+export declare class EncodeError extends Error {
+    readonly name = "EncodeError";
+    readonly code = "sync.invalid_request";
+}

package/dist/errors.js

@@ -15,3 +15,13 @@ export class DecodeError extends Error {
         this.code = code;
     }
 }
+/**
+ * A value the row codec cannot encode (SPEC.md §7.1 authoring validation,
+ * §6.1 push payloads). Structural failures stay plain `Error`s; this class
+ * marks exactly the value refusals, so a client can classify them without
+ * inspecting message text.
+ */
+export class EncodeError extends Error {
+    name = 'EncodeError';
+    code = 'sync.invalid_request';
+}

package/dist/render.d.ts

@@ -8,7 +8,7 @@
  * fields embedded as parsed JSON.
  */
 import type { SyncMessage } from './message.js';
-import type { RowColumn, SparseRowValue } from './row-codec.js';
+import type { RowColumn, RowValue, SparseRowValue } from './row-codec.js';
 import type { RowsSegment } from './segment.js';
 export type JsonValue = null | boolean | number | string | JsonValue[] | {
     [key: string]: JsonValue;
@@ -18,6 +18,10 @@ export declare function bytesToBase64(bytes: Uint8Array): string;
 export declare function renderMessageValue(message: SyncMessage): JsonValue;
 /** `render(bytes) → json` for SSP2 messages (§11). */
 export declare function renderMessage(bytes: Uint8Array): JsonValue;
+/** Render a decoded full row (§11) as JSON keyed by column name. */
+export declare function renderRowValues(columns: readonly RowColumn[], values: readonly RowValue[]): {
+    [column: string]: JsonValue;
+};
 export declare function renderRowsSegmentValue(segment: RowsSegment): JsonValue;
 /** `render(bytes) → json` for standalone SSG2 rows segments (§11 rule 8). */
 export declare function renderRowsSegment(bytes: Uint8Array): JsonValue;

package/dist/render.js

@@ -275,6 +275,13 @@ function renderRowValue(column, value) {
     }
     return value;
 }
+/** Render a decoded full row (§11) as JSON keyed by column name. */
+export function renderRowValues(columns, values) {
+    return Object.fromEntries(columns.map((column, i) => [
+        column.name,
+        renderRowValue(column, values[i] ?? null),
+    ]));
+}
 function renderColumnTable(columns) {
     return columns.map((column) => ({
         name: column.name,
@@ -291,10 +298,7 @@ export function renderRowsSegmentValue(segment) {
         columns: renderColumnTable(segment.columns),
         blocks: segment.blocks.map((block) => block.map((row) => ({
             serverVersion: row.serverVersion,
-            values: Object.fromEntries(segment.columns.map((column, i) => [
-                column.name,
-                renderRowValue(column, row.values[i] ?? null),
-            ])),
+            values: renderRowValues(segment.columns, row.values),
         }))),
     };
 }

package/dist/row-codec.js

@@ -14,7 +14,7 @@
  */
 import { parseBlobRef } from './blob-ref.js';
 import { ByteReader, ByteWriter } from './bytes.js';
-import { DecodeError } from './errors.js';
+import { DecodeError, EncodeError } from './errors.js';
 /** Wire tags, unchanged from v1's binary-table-v1 assignment (SPEC.md §2.4). */
 const TYPE_TO_TAG = {
     string: 1,
@@ -43,25 +43,25 @@ function writeValue(writer, column, value) {
         case 'json':
         case 'blob_ref':
             if (typeof value !== 'string') {
-                throw new Error(`column ${column.name} (${column.type}) requires a string value`);
+                throw new EncodeError(`column ${column.name} (${column.type}) requires a string value`);
             }
             writer.str(value);
             return;
         case 'integer':
             if (typeof value !== 'number' || !Number.isSafeInteger(value)) {
-                throw new Error(`column ${column.name} (integer) requires a safe integer value`);
+                throw new EncodeError(`column ${column.name} (integer) requires a safe integer value`);
             }
             writer.i64(value);
             return;
         case 'float':
             if (typeof value !== 'number') {
-                throw new Error(`column ${column.name} (float) requires a number value`);
+                throw new EncodeError(`column ${column.name} (float) requires a number value`);
             }
             writer.f64(value);
             return;
         case 'boolean':
             if (typeof value !== 'boolean') {
-                throw new Error(`column ${column.name} (boolean) requires a boolean value`);
+                throw new EncodeError(`column ${column.name} (boolean) requires a boolean value`);
             }
             writer.bool(value);
             return;
@@ -71,7 +71,7 @@ function writeValue(writer, column, value) {
             // opaque CRDT bytes (§5.10), no structural validation. `crdtType`
             // selects the server merger and never touches the codec.
             if (!(value instanceof Uint8Array)) {
-                throw new Error(`column ${column.name} (${column.type}) requires a Uint8Array value`);
+                throw new EncodeError(`column ${column.name} (${column.type}) requires a Uint8Array value`);
             }
             writer.bytes(value);
             return;
@@ -152,7 +152,7 @@ export function encodeSparseRow(columns, primaryKeyIndex, values) {
             continue;
         if (value === null) {
             if (!column.nullable) {
-                throw new Error(`column ${column.name} is not nullable`);
+                throw new EncodeError(`column ${column.name} is not nullable`);
             }
             nulls[present >> 3] = (nulls[present >> 3] ?? 0) | (1 << (present & 7));
         }
@@ -240,7 +240,7 @@ export function writeRow(writer, columns, values) {
             continue;
         if (values[i] === null) {
             if (!column.nullable) {
-                throw new Error(`column ${column.name} is not nullable`);
+                throw new EncodeError(`column ${column.name} is not nullable`);
             }
             bitmap[i >> 3] = (bitmap[i >> 3] ?? 0) | (1 << (i & 7));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/core",
-  "version": "0.30.16",
+  "version": "0.32.0",
   "description": "Core protocol types and shared utilities for the Syncular sync framework",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",

package/src/errors.ts

@@ -16,3 +16,14 @@ export class DecodeError extends Error {
     this.code = code;
   }
 }
+
+/**
+ * A value the row codec cannot encode (SPEC.md §7.1 authoring validation,
+ * §6.1 push payloads). Structural failures stay plain `Error`s; this class
+ * marks exactly the value refusals, so a client can classify them without
+ * inspecting message text.
+ */
+export class EncodeError extends Error {
+  override readonly name = 'EncodeError';
+  readonly code = 'sync.invalid_request';
+}

package/src/render.ts

@@ -322,6 +322,19 @@ function renderRowValue(column: RowColumn, value: RowValue): JsonValue {
   return value;
 }
 
+/** Render a decoded full row (§11) as JSON keyed by column name. */
+export function renderRowValues(
+  columns: readonly RowColumn[],
+  values: readonly RowValue[],
+): { [column: string]: JsonValue } {
+  return Object.fromEntries(
+    columns.map((column, i) => [
+      column.name,
+      renderRowValue(column, values[i] ?? null),
+    ]),
+  );
+}
+
 function renderColumnTable(columns: readonly RowColumn[]): JsonValue {
   return columns.map((column) => ({
     name: column.name,
@@ -340,12 +353,7 @@ export function renderRowsSegmentValue(segment: RowsSegment): JsonValue {
     blocks: segment.blocks.map((block) =>
       block.map((row) => ({
         serverVersion: row.serverVersion,
-        values: Object.fromEntries(
-          segment.columns.map((column, i) => [
-            column.name,
-            renderRowValue(column, row.values[i] ?? null),
-          ]),
-        ),
+        values: renderRowValues(segment.columns, row.values),
       })),
     ),
   };

package/src/row-codec.ts

@@ -14,7 +14,7 @@
  */
 import { parseBlobRef } from './blob-ref';
 import { ByteReader, ByteWriter } from './bytes';
-import { DecodeError } from './errors';
+import { DecodeError, EncodeError } from './errors';
 
 export type ColumnType =
   | 'string'
@@ -98,7 +98,7 @@ function writeValue(
     case 'json':
     case 'blob_ref':
       if (typeof value !== 'string') {
-        throw new Error(
+        throw new EncodeError(
           `column ${column.name} (${column.type}) requires a string value`,
         );
       }
@@ -106,7 +106,7 @@ function writeValue(
       return;
     case 'integer':
       if (typeof value !== 'number' || !Number.isSafeInteger(value)) {
-        throw new Error(
+        throw new EncodeError(
           `column ${column.name} (integer) requires a safe integer value`,
         );
       }
@@ -114,7 +114,7 @@ function writeValue(
       return;
     case 'float':
       if (typeof value !== 'number') {
-        throw new Error(
+        throw new EncodeError(
           `column ${column.name} (float) requires a number value`,
         );
       }
@@ -122,7 +122,7 @@ function writeValue(
       return;
     case 'boolean':
       if (typeof value !== 'boolean') {
-        throw new Error(
+        throw new EncodeError(
           `column ${column.name} (boolean) requires a boolean value`,
         );
       }
@@ -134,7 +134,7 @@ function writeValue(
       // opaque CRDT bytes (§5.10), no structural validation. `crdtType`
       // selects the server merger and never touches the codec.
       if (!(value instanceof Uint8Array)) {
-        throw new Error(
+        throw new EncodeError(
           `column ${column.name} (${column.type}) requires a Uint8Array value`,
         );
       }
@@ -237,7 +237,7 @@ export function encodeSparseRow(
     if (column === undefined || value === undefined) continue;
     if (value === null) {
       if (!column.nullable) {
-        throw new Error(`column ${column.name} is not nullable`);
+        throw new EncodeError(`column ${column.name} is not nullable`);
       }
       nulls[present >> 3] = (nulls[present >> 3] ?? 0) | (1 << (present & 7));
     }
@@ -350,7 +350,7 @@ export function writeRow(
     if (column === undefined) continue;
     if (values[i] === null) {
       if (!column.nullable) {
-        throw new Error(`column ${column.name} is not nullable`);
+        throw new EncodeError(`column ${column.name} is not nullable`);
       }
       bitmap[i >> 3] = (bitmap[i >> 3] ?? 0) | (1 << (i & 7));
     }