@syncular/core 0.30.16 → 0.31.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/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.31.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/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));
     }