@g9tm/syncdata 1.5.8 → 1.5.9

package/dist/abstractions/errors.d.ts

@@ -23,7 +23,12 @@ export declare const G9SyncErrorCodes: {
     readonly TokenExpired: "G9S-TOKEN-EXPIRED";
     readonly RejectValidation: "G9S-REJ-VALIDATION";
     readonly RejectConstraint: "G9S-REJ-CONSTRAINT";
+    /** No subscription of the caller authorises uploads to the table: passes once the missing subscription is held. */
     readonly RejectPermission: "G9S-REJ-PERMISSION";
+    /** The server's row is outside every subscription the caller may write to (no longer theirs). Since 1.5.9. */
+    readonly RejectOutsideScope: "G9S-REJ-OUTSIDE-SCOPE";
+    /** After the push the row would be outside every subscription the caller may write to. Since 1.5.9. */
+    readonly RejectLeavesScope: "G9S-REJ-LEAVES-SCOPE";
     readonly RejectDirection: "G9S-REJ-DIRECTION";
     readonly RejectTooMany: "G9S-REJ-TOO-MANY";
     /** One row is larger than the server accepts in a push: rejected on the device, every other row still uploads. */

package/dist/abstractions/errors.js

@@ -25,7 +25,12 @@ export const G9SyncErrorCodes = {
     TokenExpired: 'G9S-TOKEN-EXPIRED',
     RejectValidation: 'G9S-REJ-VALIDATION',
     RejectConstraint: 'G9S-REJ-CONSTRAINT',
+    /** No subscription of the caller authorises uploads to the table: passes once the missing subscription is held. */
     RejectPermission: 'G9S-REJ-PERMISSION',
+    /** The server's row is outside every subscription the caller may write to (no longer theirs). Since 1.5.9. */
+    RejectOutsideScope: 'G9S-REJ-OUTSIDE-SCOPE',
+    /** After the push the row would be outside every subscription the caller may write to. Since 1.5.9. */
+    RejectLeavesScope: 'G9S-REJ-LEAVES-SCOPE',
     RejectDirection: 'G9S-REJ-DIRECTION',
     RejectTooMany: 'G9S-REJ-TOO-MANY',
     /** One row is larger than the server accepts in a push: rejected on the device, every other row still uploads. */

package/dist/abstractions/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/abstractions/errors.ts"],"names":[],"mappings":"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","sourcesContent":["// Twins of G9SyncData.Abstractions/G9SyncErrorCodes.cs and G9CSyncException.cs. A code is a public API: never\r\n// repurpose one, only add — and add it on both sides in the same change.\r\n\r\n/** Stable, support-facing error codes. The client classifies failures by these codes, never by message text. */\r\nexport const G9SyncErrorCodes = {\r\n  NetworkFailure: 'G9S-NET-FAILURE',\r\n  ServerError: 'G9S-SRV-ERROR',\r\n  Canceled: 'G9S-CANCELED',\r\n\r\n  Unauthorized: 'G9S-AUTH-401',\r\n  UpgradeRequired: 'G9S-VER-UPGRADE',\r\n  ProtocolMismatch: 'G9S-VER-PROTOCOL',\r\n\r\n  ModelInvalid: 'G9S-MODEL-INVALID',\r\n  SchemaUpgradeRequired: 'G9S-SCH-UPGRADE',\r\n  UnknownTable: 'G9S-SCH-UNKNOWN-TABLE',\r\n  /** A column declared with a type the server's column does not have (ADR-0061): it syncs in neither direction. */\r\n  ModelTypeMismatch: 'G9S-MODEL-TYPE-MISMATCH',\r\n  /** The server is at its limit of concurrent pulls or pushes (ADR-0062). Retryable. */\r\n  ServerBusy: 'G9S-SRV-BUSY',\r\n\r\n  UnknownSubscription: 'G9S-SUB-UNKNOWN',\r\n  InvalidParameters: 'G9S-SUB-PARAM',\r\n  SubscriptionForbidden: 'G9S-SUB-FORBIDDEN',\r\n\r\n  ResyncEpoch: 'G9S-RSY-EPOCH',\r\n  ResyncHorizon: 'G9S-RSY-HORIZON',\r\n  ResyncAuthChanged: 'G9S-RSY-AUTH',\r\n  TokenInvalid: 'G9S-TOKEN-INVALID',\r\n  TokenExpired: 'G9S-TOKEN-EXPIRED',\r\n\r\n  RejectValidation: 'G9S-REJ-VALIDATION',\r\n  RejectConstraint: 'G9S-REJ-CONSTRAINT',\r\n  RejectPermission: 'G9S-REJ-PERMISSION',\r\n  RejectDirection: 'G9S-REJ-DIRECTION',\r\n  RejectTooMany: 'G9S-REJ-TOO-MANY',\r\n  /** One row is larger than the server accepts in a push: rejected on the device, every other row still uploads. */\r\n  RejectTooLarge: 'G9S-REJ-TOO-LARGE',\r\n  RejectMalformed: 'G9S-REJ-MALFORMED',\r\n\r\n  CommandUnknown: 'G9S-CMD-UNKNOWN',\r\n  CommandRejected: 'G9S-CMD-REJECTED',\r\n\r\n  ConflictServerWins: 'G9S-CON-SERVER-WINS',\r\n  ConflictColumns: 'G9S-CON-COLUMNS',\r\n  ConflictDeleted: 'G9S-CON-DELETED',\r\n  ConflictResolverRejected: 'G9S-CON-RESOLVER',\r\n\r\n  /** The server could not build or serve a planned snapshot file (ADR-0072); the client replans the pull as rows. */\r\n  SnapshotFileUnavailable: 'G9S-FILE-UNAVAILABLE',\r\n  /** A downloaded snapshot file failed the device's checks; nothing of it was applied and the pull is replanned as rows. */\r\n  SnapshotFileCorrupt: 'G9S-FILE-CORRUPT',\r\n  LocalStoreError: 'G9S-LOCAL-STORE',\r\n  /** The device database is damaged or not a database (ADR-0068). Export what is readable and rebuild from the server. */\r\n  LocalStoreCorrupt: 'G9S-LOCAL-CORRUPT',\r\n  /** The device ran out of storage while the store was writing. */\r\n  LocalStoreDiskFull: 'G9S-LOCAL-DISK-FULL',\r\n  /** Another connection held the write lock longer than the busy timeout. Retryable. */\r\n  LocalStoreBusy: 'G9S-LOCAL-BUSY',\r\n\r\n  Unknown: 'G9S-UNKNOWN',\r\n} as const;\r\n\r\nconst RETRYABLE: { [code: string]: true } = {\r\n  'G9S-NET-FAILURE': true,\r\n  'G9S-SRV-ERROR': true,\r\n  'G9S-SRV-BUSY': true,\r\n  'G9S-TOKEN-EXPIRED': true,\r\n  'G9S-RSY-EPOCH': true,\r\n  'G9S-RSY-HORIZON': true,\r\n  'G9S-RSY-AUTH': true,\r\n  'G9S-LOCAL-BUSY': true,\r\n};\r\n\r\n/** True for failures a later attempt may succeed at without any change to data or code (`G9SyncErrorCodes.IsRetryable`). */\r\nexport function isRetryableCode(code: string): boolean {\r\n  return RETRYABLE[code] === true;\r\n}\r\n\r\n/** Options of {@link G9SyncException}. */\r\nexport interface G9SyncExceptionOptions {\r\n  /** Overrides the default retryability of the code. */\r\n  retryable?: boolean;\r\n  /** Structured detail (JSON or text) for logs. Never shown to end users. */\r\n  details?: string | null;\r\n  /** The underlying failure. */\r\n  cause?: unknown;\r\n}\r\n\r\n/**\r\n * The single error type G9SyncData throws for expected failures (twin of `G9CSyncException`). Always carries a stable\r\n * {@link code}; callers switch on the code, never on the message.\r\n */\r\nexport class G9SyncException extends Error {\r\n  /** Stable error code (see {@link G9SyncErrorCodes}). */\r\n  readonly code: string;\r\n  /** True when retrying without changes may succeed. */\r\n  readonly retryable: boolean;\r\n  /** Optional structured detail (JSON or text) for logs. */\r\n  readonly details: string | null;\r\n\r\n  constructor(code: string, message: string, options?: G9SyncExceptionOptions) {\r\n    super(message);\r\n    this.name = 'G9SyncException';\r\n    this.code = code;\r\n    this.retryable = options?.retryable ?? isRetryableCode(code);\r\n    this.details = options?.details ?? null;\r\n    if (options && 'cause' in options) {\r\n      Object.defineProperty(this, 'cause', { value: options.cause, enumerable: false, writable: true, configurable: true });\r\n    }\r\n    // ES2019 output: keep instanceof working for subclasses compiled to functions.\r\n    Object.setPrototypeOf(this, new.target.prototype);\r\n  }\r\n}\r\n\r\n/** True for a {@link G9SyncException} (also across bundles that each carry a copy of the class). */\r\nexport function isSyncException(error: unknown): error is G9SyncException {\r\n  return (\r\n    error instanceof G9SyncException ||\r\n    (typeof error === 'object' &&\r\n      error !== null &&\r\n      (error as { name?: unknown }).name === 'G9SyncException' &&\r\n      typeof (error as { code?: unknown }).code === 'string')\r\n  );\r\n}\r\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/abstractions/errors.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,yEAAyE;AAEzE,gHAAgH;AAChH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE,cAAc;IAExB,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IAEpC,YAAY,EAAE,mBAAmB;IACjC,qBAAqB,EAAE,iBAAiB;IACxC,YAAY,EAAE,uBAAuB;IACrC,iHAAiH;IACjH,iBAAiB,EAAE,yBAAyB;IAC5C,sFAAsF;IACtF,UAAU,EAAE,cAAc;IAE1B,mBAAmB,EAAE,iBAAiB;IACtC,iBAAiB,EAAE,eAAe;IAClC,qBAAqB,EAAE,mBAAmB;IAE1C,WAAW,EAAE,eAAe;IAC5B,aAAa,EAAE,iBAAiB;IAChC,iBAAiB,EAAE,cAAc;IACjC,YAAY,EAAE,mBAAmB;IACjC,YAAY,EAAE,mBAAmB;IAEjC,gBAAgB,EAAE,oBAAoB;IACtC,gBAAgB,EAAE,oBAAoB;IACtC,mHAAmH;IACnH,gBAAgB,EAAE,oBAAoB;IACtC,8GAA8G;IAC9G,kBAAkB,EAAE,uBAAuB;IAC3C,uGAAuG;IACvG,iBAAiB,EAAE,sBAAsB;IACzC,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,kBAAkB;IACjC,kHAAkH;IAClH,cAAc,EAAE,mBAAmB;IACnC,eAAe,EAAE,mBAAmB;IAEpC,cAAc,EAAE,iBAAiB;IACjC,eAAe,EAAE,kBAAkB;IAEnC,kBAAkB,EAAE,qBAAqB;IACzC,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,wBAAwB,EAAE,kBAAkB;IAE5C,mHAAmH;IACnH,uBAAuB,EAAE,sBAAsB;IAC/C,0HAA0H;IAC1H,mBAAmB,EAAE,kBAAkB;IACvC,eAAe,EAAE,iBAAiB;IAClC,wHAAwH;IACxH,iBAAiB,EAAE,mBAAmB;IACtC,iEAAiE;IACjE,kBAAkB,EAAE,qBAAqB;IACzC,sFAAsF;IACtF,cAAc,EAAE,gBAAgB;IAEhC,OAAO,EAAE,aAAa;CACd,CAAC;AAEX,MAAM,SAAS,GAA6B;IAC1C,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,IAAI;IACvB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;CACvB,CAAC;AAEF,4HAA4H;AAC5H,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAClC,CAAC;AAYD;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAQxC,YAAY,IAAY,EAAE,OAAe,EAAE,OAAgC;;QACzE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,mCAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,IAAI,CAAC;QACxC,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACxH,CAAC;QACD,+EAA+E;QAC/E,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,KAAK,YAAY,eAAe;QAChC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACxB,KAAK,KAAK,IAAI;YACb,KAA4B,CAAC,IAAI,KAAK,iBAAiB;YACxD,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAC1D,CAAC;AACJ,CAAC","sourcesContent":["// Twins of G9SyncData.Abstractions/G9SyncErrorCodes.cs and G9CSyncException.cs. A code is a public API: never\r\n// repurpose one, only add — and add it on both sides in the same change.\r\n\r\n/** Stable, support-facing error codes. The client classifies failures by these codes, never by message text. */\r\nexport const G9SyncErrorCodes = {\r\n  NetworkFailure: 'G9S-NET-FAILURE',\r\n  ServerError: 'G9S-SRV-ERROR',\r\n  Canceled: 'G9S-CANCELED',\r\n\r\n  Unauthorized: 'G9S-AUTH-401',\r\n  UpgradeRequired: 'G9S-VER-UPGRADE',\r\n  ProtocolMismatch: 'G9S-VER-PROTOCOL',\r\n\r\n  ModelInvalid: 'G9S-MODEL-INVALID',\r\n  SchemaUpgradeRequired: 'G9S-SCH-UPGRADE',\r\n  UnknownTable: 'G9S-SCH-UNKNOWN-TABLE',\r\n  /** A column declared with a type the server's column does not have (ADR-0061): it syncs in neither direction. */\r\n  ModelTypeMismatch: 'G9S-MODEL-TYPE-MISMATCH',\r\n  /** The server is at its limit of concurrent pulls or pushes (ADR-0062). Retryable. */\r\n  ServerBusy: 'G9S-SRV-BUSY',\r\n\r\n  UnknownSubscription: 'G9S-SUB-UNKNOWN',\r\n  InvalidParameters: 'G9S-SUB-PARAM',\r\n  SubscriptionForbidden: 'G9S-SUB-FORBIDDEN',\r\n\r\n  ResyncEpoch: 'G9S-RSY-EPOCH',\r\n  ResyncHorizon: 'G9S-RSY-HORIZON',\r\n  ResyncAuthChanged: 'G9S-RSY-AUTH',\r\n  TokenInvalid: 'G9S-TOKEN-INVALID',\r\n  TokenExpired: 'G9S-TOKEN-EXPIRED',\r\n\r\n  RejectValidation: 'G9S-REJ-VALIDATION',\r\n  RejectConstraint: 'G9S-REJ-CONSTRAINT',\r\n  /** No subscription of the caller authorises uploads to the table: passes once the missing subscription is held. */\r\n  RejectPermission: 'G9S-REJ-PERMISSION',\r\n  /** The server's row is outside every subscription the caller may write to (no longer theirs). Since 1.5.9. */\r\n  RejectOutsideScope: 'G9S-REJ-OUTSIDE-SCOPE',\r\n  /** After the push the row would be outside every subscription the caller may write to. Since 1.5.9. */\r\n  RejectLeavesScope: 'G9S-REJ-LEAVES-SCOPE',\r\n  RejectDirection: 'G9S-REJ-DIRECTION',\r\n  RejectTooMany: 'G9S-REJ-TOO-MANY',\r\n  /** One row is larger than the server accepts in a push: rejected on the device, every other row still uploads. */\r\n  RejectTooLarge: 'G9S-REJ-TOO-LARGE',\r\n  RejectMalformed: 'G9S-REJ-MALFORMED',\r\n\r\n  CommandUnknown: 'G9S-CMD-UNKNOWN',\r\n  CommandRejected: 'G9S-CMD-REJECTED',\r\n\r\n  ConflictServerWins: 'G9S-CON-SERVER-WINS',\r\n  ConflictColumns: 'G9S-CON-COLUMNS',\r\n  ConflictDeleted: 'G9S-CON-DELETED',\r\n  ConflictResolverRejected: 'G9S-CON-RESOLVER',\r\n\r\n  /** The server could not build or serve a planned snapshot file (ADR-0072); the client replans the pull as rows. */\r\n  SnapshotFileUnavailable: 'G9S-FILE-UNAVAILABLE',\r\n  /** A downloaded snapshot file failed the device's checks; nothing of it was applied and the pull is replanned as rows. */\r\n  SnapshotFileCorrupt: 'G9S-FILE-CORRUPT',\r\n  LocalStoreError: 'G9S-LOCAL-STORE',\r\n  /** The device database is damaged or not a database (ADR-0068). Export what is readable and rebuild from the server. */\r\n  LocalStoreCorrupt: 'G9S-LOCAL-CORRUPT',\r\n  /** The device ran out of storage while the store was writing. */\r\n  LocalStoreDiskFull: 'G9S-LOCAL-DISK-FULL',\r\n  /** Another connection held the write lock longer than the busy timeout. Retryable. */\r\n  LocalStoreBusy: 'G9S-LOCAL-BUSY',\r\n\r\n  Unknown: 'G9S-UNKNOWN',\r\n} as const;\r\n\r\nconst RETRYABLE: { [code: string]: true } = {\r\n  'G9S-NET-FAILURE': true,\r\n  'G9S-SRV-ERROR': true,\r\n  'G9S-SRV-BUSY': true,\r\n  'G9S-TOKEN-EXPIRED': true,\r\n  'G9S-RSY-EPOCH': true,\r\n  'G9S-RSY-HORIZON': true,\r\n  'G9S-RSY-AUTH': true,\r\n  'G9S-LOCAL-BUSY': true,\r\n};\r\n\r\n/** True for failures a later attempt may succeed at without any change to data or code (`G9SyncErrorCodes.IsRetryable`). */\r\nexport function isRetryableCode(code: string): boolean {\r\n  return RETRYABLE[code] === true;\r\n}\r\n\r\n/** Options of {@link G9SyncException}. */\r\nexport interface G9SyncExceptionOptions {\r\n  /** Overrides the default retryability of the code. */\r\n  retryable?: boolean;\r\n  /** Structured detail (JSON or text) for logs. Never shown to end users. */\r\n  details?: string | null;\r\n  /** The underlying failure. */\r\n  cause?: unknown;\r\n}\r\n\r\n/**\r\n * The single error type G9SyncData throws for expected failures (twin of `G9CSyncException`). Always carries a stable\r\n * {@link code}; callers switch on the code, never on the message.\r\n */\r\nexport class G9SyncException extends Error {\r\n  /** Stable error code (see {@link G9SyncErrorCodes}). */\r\n  readonly code: string;\r\n  /** True when retrying without changes may succeed. */\r\n  readonly retryable: boolean;\r\n  /** Optional structured detail (JSON or text) for logs. */\r\n  readonly details: string | null;\r\n\r\n  constructor(code: string, message: string, options?: G9SyncExceptionOptions) {\r\n    super(message);\r\n    this.name = 'G9SyncException';\r\n    this.code = code;\r\n    this.retryable = options?.retryable ?? isRetryableCode(code);\r\n    this.details = options?.details ?? null;\r\n    if (options && 'cause' in options) {\r\n      Object.defineProperty(this, 'cause', { value: options.cause, enumerable: false, writable: true, configurable: true });\r\n    }\r\n    // ES2019 output: keep instanceof working for subclasses compiled to functions.\r\n    Object.setPrototypeOf(this, new.target.prototype);\r\n  }\r\n}\r\n\r\n/** True for a {@link G9SyncException} (also across bundles that each carry a copy of the class). */\r\nexport function isSyncException(error: unknown): error is G9SyncException {\r\n  return (\r\n    error instanceof G9SyncException ||\r\n    (typeof error === 'object' &&\r\n      error !== null &&\r\n      (error as { name?: unknown }).name === 'G9SyncException' &&\r\n      typeof (error as { code?: unknown }).code === 'string')\r\n  );\r\n}\r\n"]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** The package version; equal to the .NET packages' (G9SyncDataVersion) — one release, both sides. */
-export declare const VERSION = "1.5.8";
+export declare const VERSION = "1.5.9";
 export { G9EConflictPolicy, G9EMoveOutPolicy, G9ESyncColumnType, G9ESyncDirection, columnTypeName, isColumnType } from './abstractions/enums.js';
 export { G9SyncErrorCodes, G9SyncException, isRetryableCode, isSyncException, type G9SyncExceptionOptions } from './abstractions/errors.js';
 export { G9Long, parseJson, stringifyJson } from './abstractions/long.js';

package/dist/index.js

@@ -3,7 +3,7 @@
 // doubles `@g9tm/syncdata/testing`, the pure-JavaScript Brotli decoder `@g9tm/syncdata/brotli-js`; Lynx wiring is the
 // separate package `@g9tm/syncdata-lynx`. Every public type keeps its .NET name without the G9C prefix (PARITY.md).
 /** The package version; equal to the .NET packages' (G9SyncDataVersion) — one release, both sides. */
-export const VERSION = '1.5.8';
+export const VERSION = '1.5.9';
 // abstractions
 export { G9EConflictPolicy, G9EMoveOutPolicy, G9ESyncColumnType, G9ESyncDirection, columnTypeName, isColumnType } from './abstractions/enums.js';
 export { G9SyncErrorCodes, G9SyncException, isRetryableCode, isSyncException } from './abstractions/errors.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wHAAwH;AACxH,uHAAuH;AACvH,sHAAsH;AACtH,oHAAoH;AAEpH,sGAAsG;AACtG,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACjJ,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAA+B,MAAM,0BAA0B,CAAC;AAC5I,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACvG,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAElF,WAAW;AACX,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC5G,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACrI,OAAO,EAAE,gBAAgB,EAA4E,MAAM,+BAA+B,CAAC;AAC3I,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,2BAA2B,GAI5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAqB,MAAM,4BAA4B,CAAC;AAE3H,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,wBAAwB,EAAmD,MAAM,mBAAmB,CAAC;AAC9K,cAAc,wBAAwB,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AAC7G,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,oBAAoB,GAYrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnE,2CAA2C;AAC3C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["// @g9tm/syncdata — the TypeScript twin of the G9SyncData .NET client (abstractions, protocol, engine). The SQLite store\r\n// is `@g9tm/syncdata/sqlite`, the SignalR transport `@g9tm/syncdata/signalr`, Node helpers `@g9tm/syncdata/node`, test\r\n// doubles `@g9tm/syncdata/testing`, the pure-JavaScript Brotli decoder `@g9tm/syncdata/brotli-js`; Lynx wiring is the\r\n// separate package `@g9tm/syncdata-lynx`. Every public type keeps its .NET name without the G9C prefix (PARITY.md).\r\n\r\n/** The package version; equal to the .NET packages' (G9SyncDataVersion) — one release, both sides. */\r\nexport const VERSION = '1.5.8';\r\n\r\n// abstractions\r\nexport { G9EConflictPolicy, G9EMoveOutPolicy, G9ESyncColumnType, G9ESyncDirection, columnTypeName, isColumnType } from './abstractions/enums.js';\r\nexport { G9SyncErrorCodes, G9SyncException, isRetryableCode, isSyncException, type G9SyncExceptionOptions } from './abstractions/errors.js';\r\nexport { G9Long, parseJson, stringifyJson } from './abstractions/long.js';\r\nexport { EMPTY_GUID, guidToN, newGuid, normalizeGuid, tryNormalizeGuid } from './abstractions/guid.js';\r\nexport { G9SyncKey } from './abstractions/key.js';\r\nexport { G9SyncDigest } from './abstractions/digest.js';\r\nexport { G9SyncParameters, escapeDataString } from './abstractions/parameters.js';\r\n\r\n// protocol\r\nexport * from './protocol/dtos.js';\r\nexport { G9SyncHubErrors, G9SyncProtocol, negotiateFrameVersion, tableGroup } from './protocol/protocol.js';\r\nexport {\r\n  bytesField,\r\n  dateTimeMs,\r\n  fromMessagePackNames,\r\n  G9WireGuid,\r\n  GUID_EXTENSION_TYPE,\r\n  readChangesAvailable,\r\n  readContinuation,\r\n  readHelloResult,\r\n  readPullPlan,\r\n  readPushResult,\r\n  readReconcileSummary,\r\n  readSyncChunk,\r\n  toMessagePackNames,\r\n  type G9WireFormat,\r\n} from './protocol/wire.js';\r\nexport { G9ECompression, G9EPushRowOp, G9ERowBatchOp, G9RowBatchFormat, G9RowBatchFormatError } from './protocol/rowBatch/format.js';\r\nexport { G9RowBatchWriter, type G9DateTimeOffsetValue, type G9DateTimeValue, type G9FrameCompressor } from './protocol/rowBatch/writer.js';\r\nexport {\r\n  G9RowBatchReader,\r\n  getDefaultFrameDecompressor,\r\n  openRowBatch,\r\n  openRowBatchSync,\r\n  readFrameHeader,\r\n  setDefaultFrameDecompressor,\r\n  type G9FrameDecompressor,\r\n  type G9FrameHeader,\r\n  type G9OpenRowBatchOptions,\r\n} from './protocol/rowBatch/reader.js';\r\nexport { decimalToDouble, formatDecimal, formatDouble, parseDecimal, type DecimalParts } from './internal/dotnetFormat.js';\r\n\r\n// client\r\nexport { G9SyncClientModel, G9SyncClientModelBuilder, G9SyncClientTable, G9SyncClientTableBuilder, type G9SyncClientColumn, type G9SyncClientIndex } from './client/model.js';\r\nexport * from './client/storeTypes.js';\r\nexport type { G9SyncTransport } from './client/transport.js';\r\nexport { G9ESyncPhase, G9SyncProgressTracker, phaseName, type G9DtSyncProgress } from './client/progress.js';\r\nexport {\r\n  G9ESyncOutcome,\r\n  G9ESyncPriority,\r\n  G9SyncPostStep,\r\n  G9SyncRun,\r\n  describeModelProblem,\r\n  isTransientError,\r\n  normalizeError,\r\n  outcomeName,\r\n  priorityName,\r\n  resolveEngineOptions,\r\n  type G9RowsAppliedEvent,\r\n  type G9SubscriptionOptions,\r\n  type G9SyncEngineOptions,\r\n  type G9SyncHealth,\r\n  type G9SyncHostHooks,\r\n  type G9SyncLogger,\r\n  type G9SyncLogLevel,\r\n  type G9SyncModelProblem,\r\n  type G9SyncPostStepContext,\r\n  type G9SyncRequest,\r\n  type G9SyncRunResult,\r\n} from './client/runs.js';\r\nexport { G9SyncEngine, stageGeneration } from './client/engine.js';\r\n\r\n// helpers the Lynx package and tests share\r\nexport { base64ToBytes, bytesToBase64 } from './internal/base64.js';\r\nexport { utf8Decode, utf8Encode } from './internal/utf8.js';\r\nexport { md5 } from './internal/md5.js';\r\nexport { sha256, toHex } from './internal/sha256.js';\r\nexport { cancellationError, createAbortController, delay, linkSignals, onAbort, yieldToEventLoop } from './internal/abort.js';\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wHAAwH;AACxH,uHAAuH;AACvH,sHAAsH;AACtH,oHAAoH;AAEpH,sGAAsG;AACtG,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACjJ,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAA+B,MAAM,0BAA0B,CAAC;AAC5I,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACvG,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAElF,WAAW;AACX,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC5G,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACrI,OAAO,EAAE,gBAAgB,EAA4E,MAAM,+BAA+B,CAAC;AAC3I,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,2BAA2B,GAI5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAqB,MAAM,4BAA4B,CAAC;AAE3H,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,wBAAwB,EAAmD,MAAM,mBAAmB,CAAC;AAC9K,cAAc,wBAAwB,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AAC7G,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,oBAAoB,GAYrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnE,2CAA2C;AAC3C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["// @g9tm/syncdata — the TypeScript twin of the G9SyncData .NET client (abstractions, protocol, engine). The SQLite store\r\n// is `@g9tm/syncdata/sqlite`, the SignalR transport `@g9tm/syncdata/signalr`, Node helpers `@g9tm/syncdata/node`, test\r\n// doubles `@g9tm/syncdata/testing`, the pure-JavaScript Brotli decoder `@g9tm/syncdata/brotli-js`; Lynx wiring is the\r\n// separate package `@g9tm/syncdata-lynx`. Every public type keeps its .NET name without the G9C prefix (PARITY.md).\r\n\r\n/** The package version; equal to the .NET packages' (G9SyncDataVersion) — one release, both sides. */\r\nexport const VERSION = '1.5.9';\r\n\r\n// abstractions\r\nexport { G9EConflictPolicy, G9EMoveOutPolicy, G9ESyncColumnType, G9ESyncDirection, columnTypeName, isColumnType } from './abstractions/enums.js';\r\nexport { G9SyncErrorCodes, G9SyncException, isRetryableCode, isSyncException, type G9SyncExceptionOptions } from './abstractions/errors.js';\r\nexport { G9Long, parseJson, stringifyJson } from './abstractions/long.js';\r\nexport { EMPTY_GUID, guidToN, newGuid, normalizeGuid, tryNormalizeGuid } from './abstractions/guid.js';\r\nexport { G9SyncKey } from './abstractions/key.js';\r\nexport { G9SyncDigest } from './abstractions/digest.js';\r\nexport { G9SyncParameters, escapeDataString } from './abstractions/parameters.js';\r\n\r\n// protocol\r\nexport * from './protocol/dtos.js';\r\nexport { G9SyncHubErrors, G9SyncProtocol, negotiateFrameVersion, tableGroup } from './protocol/protocol.js';\r\nexport {\r\n  bytesField,\r\n  dateTimeMs,\r\n  fromMessagePackNames,\r\n  G9WireGuid,\r\n  GUID_EXTENSION_TYPE,\r\n  readChangesAvailable,\r\n  readContinuation,\r\n  readHelloResult,\r\n  readPullPlan,\r\n  readPushResult,\r\n  readReconcileSummary,\r\n  readSyncChunk,\r\n  toMessagePackNames,\r\n  type G9WireFormat,\r\n} from './protocol/wire.js';\r\nexport { G9ECompression, G9EPushRowOp, G9ERowBatchOp, G9RowBatchFormat, G9RowBatchFormatError } from './protocol/rowBatch/format.js';\r\nexport { G9RowBatchWriter, type G9DateTimeOffsetValue, type G9DateTimeValue, type G9FrameCompressor } from './protocol/rowBatch/writer.js';\r\nexport {\r\n  G9RowBatchReader,\r\n  getDefaultFrameDecompressor,\r\n  openRowBatch,\r\n  openRowBatchSync,\r\n  readFrameHeader,\r\n  setDefaultFrameDecompressor,\r\n  type G9FrameDecompressor,\r\n  type G9FrameHeader,\r\n  type G9OpenRowBatchOptions,\r\n} from './protocol/rowBatch/reader.js';\r\nexport { decimalToDouble, formatDecimal, formatDouble, parseDecimal, type DecimalParts } from './internal/dotnetFormat.js';\r\n\r\n// client\r\nexport { G9SyncClientModel, G9SyncClientModelBuilder, G9SyncClientTable, G9SyncClientTableBuilder, type G9SyncClientColumn, type G9SyncClientIndex } from './client/model.js';\r\nexport * from './client/storeTypes.js';\r\nexport type { G9SyncTransport } from './client/transport.js';\r\nexport { G9ESyncPhase, G9SyncProgressTracker, phaseName, type G9DtSyncProgress } from './client/progress.js';\r\nexport {\r\n  G9ESyncOutcome,\r\n  G9ESyncPriority,\r\n  G9SyncPostStep,\r\n  G9SyncRun,\r\n  describeModelProblem,\r\n  isTransientError,\r\n  normalizeError,\r\n  outcomeName,\r\n  priorityName,\r\n  resolveEngineOptions,\r\n  type G9RowsAppliedEvent,\r\n  type G9SubscriptionOptions,\r\n  type G9SyncEngineOptions,\r\n  type G9SyncHealth,\r\n  type G9SyncHostHooks,\r\n  type G9SyncLogger,\r\n  type G9SyncLogLevel,\r\n  type G9SyncModelProblem,\r\n  type G9SyncPostStepContext,\r\n  type G9SyncRequest,\r\n  type G9SyncRunResult,\r\n} from './client/runs.js';\r\nexport { G9SyncEngine, stageGeneration } from './client/engine.js';\r\n\r\n// helpers the Lynx package and tests share\r\nexport { base64ToBytes, bytesToBase64 } from './internal/base64.js';\r\nexport { utf8Decode, utf8Encode } from './internal/utf8.js';\r\nexport { md5 } from './internal/md5.js';\r\nexport { sha256, toHex } from './internal/sha256.js';\r\nexport { cancellationError, createAbortController, delay, linkSignals, onAbort, yieldToEventLoop } from './internal/abort.js';\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@g9tm/syncdata",
-  "version": "1.5.8",
+  "version": "1.5.9",
   "description": "TypeScript twin of the G9SyncData .NET client for Lynx, Node and browsers: the sync engine, the G9RowBatch protocol, the SQLite client store (same schema as the .NET store) and the SignalR transport.",
   "license": "MIT",
   "author": "Iman Kari (G9TM)",