@g9tm/syncdata 1.2.1

package/dist/client/storeTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeTypes.js","sourceRoot":"","sources":["../../src/client/storeTypes.ts"],"names":[],"mappings":"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","sourcesContent":["// Twins of G9SyncData.Client/Storage/*.cs: the client store contract, its records, local commands, revocation rules\n// and apply diagnostics. The engine is store-agnostic; `@g9tm/syncdata/sqlite` is the implementation.\nimport type { G9EMoveOutPolicy } from '../abstractions/enums.js';\nimport type { G9Long } from '../abstractions/long.js';\nimport type { G9SyncParameters } from '../abstractions/parameters.js';\nimport type {\n  G9DtBackfillRequest,\n  G9DtCommand,\n  G9DtHelloResult,\n  G9DtNegotiatedTable,\n  G9DtPullContinuation,\n  G9DtPullPlan,\n  G9DtPushResult,\n  G9DtSubscriptionDefinition,\n  G9DtSubscriptionRef,\n  G9DtSyncChunk,\n  G9DtTableColumns,\n  G9DtTableDigest,\n} from '../protocol/dtos.js';\nimport type { G9SyncClientModel } from './model.js';\n\n// ---------------------------------------------------------------- server state and subscriptions\n\n/** What the client last learned from the server (`G9CClientServerState`). */\nexport interface G9ClientServerState {\n  epoch: string | null;\n  lastHelloUtcMs: number | null;\n  /** Server clock minus device clock, ms. */\n  serverClockOffsetMs: number;\n  tables: G9DtNegotiatedTable[];\n  definitions: G9DtSubscriptionDefinition[];\n}\n\n/** `G9ESubscriptionState`. */\nexport const G9ESubscriptionState = {\n  Active: 0,\n  NeedsReconcile: 1,\n  Failed: 2,\n} as const;\nexport type G9ESubscriptionState = (typeof G9ESubscriptionState)[keyof typeof G9ESubscriptionState];\n\n/** A local subscription (`G9CSyncSubscriptionRecord`). Times are epoch milliseconds UTC. */\nexport interface G9SyncSubscriptionRecord {\n  key: string;\n  name: string;\n  parameters: G9SyncParameters;\n  /** Membership slot (bit) for persistent subscriptions; the shared ephemeral slot otherwise. */\n  slot: number;\n  ephemeral: boolean;\n  ttlMs: number | null;\n  cursor: string | null;\n  /** The move-out policy the server last announced; kept so it still applies once access is gone. */\n  moveOutPolicy: G9EMoveOutPolicy | null;\n  definitionHash: string | null;\n  authHash: string | null;\n  state: G9ESubscriptionState;\n  lastErrorCode: string | null;\n  createdUtcMs: number;\n  lastSuccessUtcMs: number | null;\n  lastReconcileUtcMs: number | null;\n  lastAccessUtcMs: number | null;\n}\n\n/** `G9CSyncSubscriptionRecord.ToReference()`. */\nexport function toSubscriptionRef(record: G9SyncSubscriptionRecord): G9DtSubscriptionRef {\n  return {\n    name: record.name,\n    parameters: record.parameters.values,\n    cursor: record.cursor,\n    definitionHash: record.definitionHash,\n    authHash: record.authHash,\n  };\n}\n\n/** A partial update of a subscription record; absent members are left unchanged (`G9CSubscriptionUpdate`). */\nexport interface G9SubscriptionUpdate {\n  cursor?: string | null;\n  definitionHash?: string | null;\n  authHash?: string | null;\n  state?: G9ESubscriptionState | null;\n  errorCode?: string | null;\n  clearError?: boolean;\n  succeeded?: boolean;\n  reconciled?: boolean;\n  accessed?: boolean;\n  clearCursor?: boolean;\n}\n\n// ---------------------------------------------------------------- push and pull\n\n/** A push batch built from dirty rows (`G9CPushBatch`). */\nexport interface G9PushBatch {\n  batchId: number;\n  /** Highest local change sequence included; rows changed after it stay dirty after the acknowledgement. */\n  maxSequence: number;\n  frames: Uint8Array[];\n  tables: G9DtTableColumns[];\n  rowCount: number;\n  /** True when the byte budget ended the batch early: more pending rows follow. */\n  truncated: boolean;\n  /** Rows rejected on the device while building the batch (G9S-REJ-TOO-LARGE). */\n  rejectedLocally: number;\n  /** Commands carried by this batch, in device order. */\n  commands: G9DtCommand[];\n}\n\n/** A pull being staged, persisted across restarts (`G9CStagedPull`). */\nexport interface G9StagedPull {\n  runId: string;\n  plan: G9DtPullPlan;\n  createdUtcMs: number;\n  backfills: G9DtBackfillRequest[];\n  /** What the world looked like when the plan was made (ADR-0046); a run only resumes a stage whose generation matches. */\n  generation: string | null;\n  /** The cursor each planned subscription had when the plan was made, by subscription key (ADR-0060). */\n  plannedFromCursors: { [subscriptionKey: string]: string | null };\n  /** The device clock when the stage began, assigned by the store. */\n  stageSequence: number;\n}\n\n/** One committed slice of a staged pull (`G9CApplySlice`). */\nexport interface G9ApplySlice {\n  report: G9ApplyReport;\n  rowsApplied: number;\n  rowsAppliedTotal: number;\n  rowsPlanned: number;\n  isFinal: boolean;\n}\n\n/** `G9CResumePoint`. */\nexport interface G9ResumePoint {\n  continuation: G9DtPullContinuation | null;\n  stagedRows: number;\n  stagedBytes: number;\n  complete: boolean;\n}\n\n// ---------------------------------------------------------------- reports\n\n/** Why a table large enough for index deferral kept its indexes live. */\nexport const REASON_TABLE_NOT_EMPTY = 'table-not-empty';\nconst MAX_FOREIGN_TRIGGER_NAMES = 10;\n\n/** How an apply ran, as opposed to what it changed (`G9CApplyDiagnostics`, ADR-0058). */\nexport class G9ApplyDiagnostics {\n  transactions = 0;\n  transactionsWithTriggersSkipped = 0;\n  readonly foreignTriggers: string[] = [];\n  readonly deferredIndexes: { [table: string]: number } = {};\n  readonly liveIndexReasons: { [table: string]: string } = {};\n  readonly rowsByTable: { [table: string]: number } = {};\n  readonly msByTable: { [table: string]: number } = {};\n  indexRebuildMs = 0;\n  elapsedMs = 0;\n\n  /** True when every transaction ran with trigger execution off, false when any ran with it on, null when nothing was applied. */\n  get triggersSkipped(): boolean | null {\n    return this.transactions === 0 ? null : this.transactionsWithTriggersSkipped === this.transactions;\n  }\n\n  get deferredIndexCount(): number {\n    let total = 0;\n    for (const key of Object.keys(this.deferredIndexes)) total += this.deferredIndexes[key] as number;\n    return total;\n  }\n\n  merge(other: G9ApplyDiagnostics): void {\n    this.transactions += other.transactions;\n    this.transactionsWithTriggersSkipped += other.transactionsWithTriggersSkipped;\n    this.indexRebuildMs += other.indexRebuildMs;\n    this.elapsedMs += other.elapsedMs;\n    for (const name of other.foreignTriggers) {\n      if (this.foreignTriggers.length >= MAX_FOREIGN_TRIGGER_NAMES) break;\n      if (!this.foreignTriggers.some((n) => n.toLowerCase() === name.toLowerCase())) this.foreignTriggers.push(name);\n    }\n    addAll(this.deferredIndexes, other.deferredIndexes);\n    for (const key of Object.keys(other.liveIndexReasons)) this.liveIndexReasons[key] = other.liveIndexReasons[key] as string;\n    addAll(this.rowsByTable, other.rowsByTable);\n    addAll(this.msByTable, other.msByTable);\n  }\n\n  /** One line for a log: what engaged, what did not and why, and the tables that took the time. */\n  toString(): string {\n    if (this.transactions === 0) return 'nothing applied';\n    let text = `${this.transactions} transaction(s) in ${this.elapsedMs} ms; triggers `;\n    text +=\n      this.triggersSkipped === true\n        ? 'skipped'\n        : this.transactionsWithTriggersSkipped === 0\n          ? 'LIVE'\n          : `skipped in ${this.transactionsWithTriggersSkipped} of ${this.transactions}`;\n    if (this.foreignTriggers.length > 0) text += ' (foreign: ' + this.foreignTriggers.join(', ') + ')';\n    const deferred = Object.keys(this.deferredIndexes);\n    if (deferred.length > 0) {\n      text += `; ${this.deferredIndexCount} index(es) rebuilt after the load in ${this.indexRebuildMs} ms (` + deferred.map((t) => t + ':' + this.deferredIndexes[t]).join(', ') + ')';\n    }\n    const live = Object.keys(this.liveIndexReasons);\n    if (live.length > 0) text += '; live indexes on ' + live.map((t) => t + ' (' + this.liveIndexReasons[t] + ')').join(', ');\n    const slowest = Object.keys(this.msByTable)\n      .sort((a, b) => (this.msByTable[b] as number) - (this.msByTable[a] as number))\n      .slice(0, 4);\n    if (slowest.length > 0) {\n      text +=\n        '; ' +\n        slowest\n          .map((t) => {\n            const ms = this.msByTable[t] as number;\n            const rows = this.rowsByTable[t] ?? 0;\n            const rate = ms > 0 ? Math.floor((rows * 1000) / ms) : rows;\n            return `${t} ${rows} rows in ${ms} ms (${rate}/s)`;\n          })\n          .join(', ');\n    }\n    return text;\n  }\n}\n\nfunction addAll(target: { [key: string]: number }, source: { [key: string]: number }): void {\n  for (const key of Object.keys(source)) target[key] = (target[key] ?? 0) + (source[key] as number);\n}\n\n/** What an apply changed (`G9CApplyReport`). */\nexport class G9ApplyReport {\n  upserts = 0;\n  deletes = 0;\n  moveOuts = 0;\n  membershipAdded = 0;\n  /** Rows skipped because they carry a pending local change. */\n  skippedDirty = 0;\n  accepted = 0;\n  rejected = 0;\n  conflicts = 0;\n  commandsCompleted = 0;\n  revokedDeleted = 0;\n  revokedQuarantined = 0;\n  revokedRetained = 0;\n  /** Changed keys per local table (capped per table). */\n  readonly changedKeys: { [localTable: string]: string[] } = {};\n  /** Upserts whose row already held exactly the incoming values (ADR-0058). */\n  unchangedRows = 0;\n  readonly diagnostics = new G9ApplyDiagnostics();\n\n  get total(): number {\n    return this.upserts + this.deletes + this.moveOuts;\n  }\n\n  merge(other: G9ApplyReport): void {\n    this.unchangedRows += other.unchangedRows;\n    this.diagnostics.merge(other.diagnostics);\n    this.upserts += other.upserts;\n    this.deletes += other.deletes;\n    this.moveOuts += other.moveOuts;\n    this.membershipAdded += other.membershipAdded;\n    this.skippedDirty += other.skippedDirty;\n    this.accepted += other.accepted;\n    this.rejected += other.rejected;\n    this.conflicts += other.conflicts;\n    this.commandsCompleted += other.commandsCompleted;\n    this.revokedDeleted += other.revokedDeleted;\n    this.revokedQuarantined += other.revokedQuarantined;\n    this.revokedRetained += other.revokedRetained;\n    for (const table of Object.keys(other.changedKeys)) {\n      const list = this.changedKeys[table] ?? (this.changedKeys[table] = []);\n      for (const key of other.changedKeys[table] as string[]) list.push(key);\n    }\n  }\n}\n\n/** A local row as seen by reconciliation (`G9CLocalRowEntry`). */\nexport interface G9LocalRowEntry {\n  key: string;\n  bucket: number;\n  version: number;\n  hash: G9Long;\n  member: boolean;\n  dirty: boolean;\n}\n\nexport interface G9PendingTable {\n  localTable: string;\n  upserts: number;\n  deletes: number;\n  rejected: number;\n}\n\nexport interface G9PendingSummary {\n  totalRows: number;\n  rejectedRows: number;\n  /** Commands recorded on the device and not yet executed by the server. */\n  pendingCommands: number;\n  tables: G9PendingTable[];\n}\n\n/** One entry of the local change feed (`G9CChangeFeedEntry`). */\nexport interface G9ChangeFeedEntry {\n  sequence: number;\n  key: string;\n  deleted: boolean;\n  localPending: boolean;\n}\n\nexport interface G9SyncRejection {\n  localTable: string;\n  key: string;\n  code: string;\n  message: string | null;\n  sqlState: string | null;\n  constraint: string | null;\n  column: string | null;\n  details: string | null;\n  atUtcMs: number;\n}\n\n/** A persisted summary of one run (`G9CSyncRunReport`); serialized with the .NET JSON names into g9_runs. */\nexport interface G9SyncRunReport {\n  runId: string;\n  startedUtcMs: number;\n  durationMs: number;\n  outcome: string;\n  priority: string;\n  errorCode: string | null;\n  errorMessage: string | null;\n  pushed: number;\n  rejected: number;\n  conflicts: number;\n  downloaded: number;\n  applied: number;\n  downloadedBytes: number;\n  subscriptions: string[];\n  phaseMs: { [phase: string]: number };\n  triggersSkipped: boolean | null;\n  foreignTriggers: string[];\n  applyTransactions: number;\n  indexesDeferred: number;\n  indexRebuildMs: number;\n  liveIndexReasons: { [table: string]: string };\n  unchangedRows: number;\n}\n\n// ---------------------------------------------------------------- local commands (ADR-0025)\n\n/** `G9ELocalCommandState`. */\nexport const G9ELocalCommandState = {\n  Pending: 0,\n  Ok: 1,\n  Rejected: 2,\n  Superseded: 3,\n} as const;\nexport type G9ELocalCommandState = (typeof G9ELocalCommandState)[keyof typeof G9ELocalCommandState];\n\n/** A command recorded on this device (`G9CLocalCommand`). */\nexport interface G9LocalCommand {\n  commandId: string;\n  sequence: number;\n  name: string;\n  version: number;\n  payload: string;\n  createdUtcMs: number;\n  state: G9ELocalCommandState;\n  code: string | null;\n  message: string | null;\n  result: string | null;\n  completedUtcMs: number | null;\n}\n\n/** What to record (`G9CCommandRequest`). */\nexport interface G9CommandRequest {\n  name: string;\n  version?: number;\n  /** JSON payload for the server's handler. */\n  payload: string;\n}\n\n/** A value an app binds through {@link G9LocalCommandWriter}: the SQLite driver's value forms, plus booleans. */\nexport type G9LocalSqlArgument = null | number | string | boolean | ArrayBuffer | Uint8Array | { int64: string } | G9Long;\n\n/**\n * Writes a command's local effects in the transaction that records it (`IG9LocalCommandWriter`). Rows written here are\n * not uploaded as row changes; they are protected from pulls until the server's result arrives.\n */\nexport interface G9LocalCommandWriter {\n  /** Executes SQL; parameters bind positionally as `$p0`, `$p1`, … */\n  execute(sql: string, ...args: G9LocalSqlArgument[]): Promise<number>;\n  scalar(sql: string, ...args: G9LocalSqlArgument[]): Promise<unknown>;\n}\n\n// ---------------------------------------------------------------- revocation (ADR-0026)\n\n/** `G9ERevocationReason`. */\nexport const G9ERevocationReason = {\n  LeftScope: 0,\n  Unsubscribed: 1,\n  Expired: 2,\n  AccessRevoked: 3,\n} as const;\nexport type G9ERevocationReason = (typeof G9ERevocationReason)[keyof typeof G9ERevocationReason];\n\n/** `G9ERevocationDisposition`. */\nexport const G9ERevocationDisposition = {\n  Delete: 0,\n  MarkRevoked: 1,\n  Quarantine: 2,\n  Retain: 3,\n} as const;\nexport type G9ERevocationDisposition = (typeof G9ERevocationDisposition)[keyof typeof G9ERevocationDisposition];\n\n/** A row no subscription holds any more, as a revocation rule sees it (`G9CRevokedRow`). */\nexport interface G9RevokedRow {\n  localTable: string;\n  key: string;\n  reason: G9ERevocationReason;\n  subscriptionKey: string | null;\n  hasPendingChanges: boolean;\n  isRejected: boolean;\n  /** Column values (key included) as stored locally; empty when the row no longer exists locally. */\n  values: { [column: string]: unknown };\n}\n\n/** Lets a custom rule change the row before its disposition applies. */\nexport interface G9RevokedRowEditor {\n  set(column: string, value: unknown): void;\n}\n\nexport interface G9RevocationRule {\n  readonly name: string;\n  readonly condition: (row: G9RevokedRow) => boolean;\n  readonly decide: (row: G9RevokedRow, editor: G9RevokedRowEditor) => G9ERevocationDisposition;\n  readonly retainWhile: ((row: G9RevokedRow) => boolean) | null;\n}\n\n/** Ordered revocation rules (`G9CRevocationPolicy`): the first matching rule decides. */\nexport class G9RevocationPolicy {\n  readonly rules: readonly G9RevocationRule[];\n\n  private constructor(rules: readonly G9RevocationRule[]) {\n    this.rules = rules;\n  }\n\n  /** No rules: delete clean rows, quarantine rows with pending changes. */\n  static readonly default = new G9RevocationPolicy([]);\n\n  static create(configure: (builder: G9RevocationPolicyBuilder) => void): G9RevocationPolicy {\n    const builder = new G9RevocationPolicyBuilder();\n    configure(builder);\n    return new G9RevocationPolicy(builder.rules.slice());\n  }\n\n  decide(row: G9RevokedRow, editor: G9RevokedRowEditor): { rule: G9RevocationRule | null; disposition: G9ERevocationDisposition } {\n    for (const rule of this.rules) {\n      if (rule.condition(row)) return { rule, disposition: rule.decide(row, editor) };\n    }\n    return { rule: null, disposition: row.hasPendingChanges ? G9ERevocationDisposition.Quarantine : G9ERevocationDisposition.Delete };\n  }\n\n  find(name: string): G9RevocationRule | null {\n    for (const rule of this.rules) if (rule.name === name) return rule;\n    return null;\n  }\n}\n\nexport class G9RevocationPolicyBuilder {\n  readonly rules: G9RevocationRule[] = [];\n\n  when(name: string, condition: (row: G9RevokedRow) => boolean): G9RevocationActionBuilder {\n    if (typeof name !== 'string' || name.trim() === '') throw new TypeError('A rule needs a name.');\n    if (this.rules.some((r) => r.name === name)) throw new RangeError(`Revocation rule '${name}' is declared twice.`);\n    return new G9RevocationActionBuilder(this, name, condition);\n  }\n\n  /** Rows of one local table. */\n  forTable(name: string, localTable: string, condition?: (row: G9RevokedRow) => boolean): G9RevocationActionBuilder {\n    const table = localTable.toLowerCase();\n    return this.when(name, (row) => row.localTable.toLowerCase() === table && (condition ? condition(row) : true));\n  }\n}\n\nexport class G9RevocationActionBuilder {\n  private readonly _owner: G9RevocationPolicyBuilder;\n  private readonly _name: string;\n  private readonly _condition: (row: G9RevokedRow) => boolean;\n\n  constructor(owner: G9RevocationPolicyBuilder, name: string, condition: (row: G9RevokedRow) => boolean) {\n    this._owner = owner;\n    this._name = name;\n    this._condition = condition;\n  }\n\n  delete(): G9RevocationPolicyBuilder {\n    return this._add(() => G9ERevocationDisposition.Delete, null);\n  }\n\n  markRevoked(): G9RevocationPolicyBuilder {\n    return this._add(() => G9ERevocationDisposition.MarkRevoked, null);\n  }\n\n  quarantine(): G9RevocationPolicyBuilder {\n    return this._add(() => G9ERevocationDisposition.Quarantine, null);\n  }\n\n  retainWhile(retainWhile: (row: G9RevokedRow) => boolean): G9RevocationPolicyBuilder {\n    return this._add(() => G9ERevocationDisposition.Retain, retainWhile);\n  }\n\n  custom(decide: (row: G9RevokedRow, editor: G9RevokedRowEditor) => G9ERevocationDisposition): G9RevocationPolicyBuilder {\n    return this._add(decide, null);\n  }\n\n  private _add(\n    decide: (row: G9RevokedRow, editor: G9RevokedRowEditor) => G9ERevocationDisposition,\n    retainWhile: ((row: G9RevokedRow) => boolean) | null,\n  ): G9RevocationPolicyBuilder {\n    this._owner.rules.push({ name: this._name, condition: this._condition, decide, retainWhile });\n    return this._owner;\n  }\n}\n\n/** A row in the holding area (`G9CQuarantinedRow`). */\nexport interface G9QuarantinedRow {\n  localTable: string;\n  key: string;\n  reason: G9ERevocationReason;\n  rule: string | null;\n  hadPendingChanges: boolean;\n  values: { [column: string]: unknown };\n  atUtcMs: number;\n}\n\n/** A row kept in the app's table after revocation (`G9CRetainedRow`). */\nexport interface G9RetainedRow {\n  localTable: string;\n  key: string;\n  disposition: G9ERevocationDisposition;\n  reason: G9ERevocationReason;\n  rule: string | null;\n  atUtcMs: number;\n}\n\n// ---------------------------------------------------------------- failures\n\n/** What went wrong inside a client store, in terms an application can act on (`G9ELocalStoreFailure`). */\nexport const G9ELocalStoreFailure = {\n  Other: 0,\n  Corrupt: 1,\n  DiskFull: 2,\n  Busy: 3,\n} as const;\nexport type G9ELocalStoreFailure = (typeof G9ELocalStoreFailure)[keyof typeof G9ELocalStoreFailure];\n\n/** Implemented by a store's errors so the engine can give a run's failure a stable code (`IG9SyncLocalStoreFailure`). */\nexport interface G9SyncLocalStoreFailure {\n  readonly localStoreFailure: G9ELocalStoreFailure;\n}\n\nexport function isLocalStoreFailure(error: unknown): error is G9SyncLocalStoreFailure {\n  return typeof error === 'object' && error !== null && typeof (error as { localStoreFailure?: unknown }).localStoreFailure === 'number';\n}\n\n// ---------------------------------------------------------------- the store contract\n\n/**\n * The client storage provider (`IG9SyncClientStore`): local tables, change capture, subscription membership,\n * staging, apply and metadata. Every method takes an optional AbortSignal (the CancellationToken twin).\n */\nexport interface G9SyncClientStore {\n  initialize(model: G9SyncClientModel, signal?: AbortSignal): Promise<void>;\n  getClientId(signal?: AbortSignal): Promise<string>;\n  getServerState(signal?: AbortSignal): Promise<G9ClientServerState>;\n  saveHello(hello: G9DtHelloResult, signal?: AbortSignal): Promise<void>;\n  getPendingBackfills(signal?: AbortSignal): Promise<G9DtBackfillRequest[]>;\n\n  getSubscriptions(signal?: AbortSignal): Promise<G9SyncSubscriptionRecord[]>;\n  ensureSubscription(\n    name: string,\n    parameters: G9SyncParameters,\n    ephemeral: boolean,\n    ttlMs: number | null,\n    adoptExistingRows: boolean,\n    signal?: AbortSignal,\n  ): Promise<G9SyncSubscriptionRecord>;\n  removeSubscription(key: string, policy: G9EMoveOutPolicy, signal?: AbortSignal): Promise<void>;\n  releaseSubscriptionRows(key: string, signal?: AbortSignal): Promise<G9ApplyReport>;\n  updateSubscription(key: string, update: G9SubscriptionUpdate, signal?: AbortSignal): Promise<void>;\n  collectExpiredEphemeral(utcNowMs: number, signal?: AbortSignal): Promise<number>;\n\n  buildPushBatch(tables: readonly G9DtNegotiatedTable[], maxRows: number, maxBytes: number, signal?: AbortSignal): Promise<G9PushBatch | null>;\n  forgetUploadedRows(localTable: string, keys: readonly string[] | null, signal?: AbortSignal): Promise<number>;\n  applyPushResult(batch: G9PushBatch, result: G9DtPushResult, signal?: AbortSignal): Promise<G9ApplyReport>;\n\n  getStagedPull(signal?: AbortSignal): Promise<G9StagedPull | null>;\n  /** The newest staged pull planned under exactly this generation, or null (ADR-0060). */\n  getStagedPullForGeneration(generation: string, signal?: AbortSignal): Promise<G9StagedPull | null>;\n  beginStagedPull(pull: G9StagedPull, signal?: AbortSignal): Promise<void>;\n  pruneStagedPulls(olderThanUtcMs: number, maxBytes: number, keepGeneration: string | null, signal?: AbortSignal): Promise<number>;\n  discardAllStagedPulls(signal?: AbortSignal): Promise<number>;\n  stageChunk(runId: string, chunk: G9DtSyncChunk, signal?: AbortSignal): Promise<void>;\n  getResumePoint(runId: string, signal?: AbortSignal): Promise<G9ResumePoint>;\n  applyStagedPull(\n    runId: string,\n    rowsApplied: ((rows: number) => void) | null,\n    slices: ((slice: G9ApplySlice) => void) | null,\n    signal?: AbortSignal,\n  ): Promise<G9ApplyReport>;\n  discardStagedPull(runId: string, signal?: AbortSignal): Promise<void>;\n\n  computeDigest(subscriptionKey: string, table: G9DtNegotiatedTable, signal?: AbortSignal): Promise<G9DtTableDigest>;\n  readLocalEntries(\n    subscriptionKey: string,\n    table: G9DtNegotiatedTable,\n    buckets: ReadonlySet<number>,\n    serverKeys: ReadonlySet<string>,\n    signal?: AbortSignal,\n  ): Promise<G9LocalRowEntry[]>;\n  applyReconcile(\n    subscriptionKey: string,\n    table: G9DtNegotiatedTable,\n    fetchedFrames: readonly Uint8Array[],\n    addMembership: readonly string[],\n    moveOut: readonly string[],\n    policy: G9EMoveOutPolicy,\n    signal?: AbortSignal,\n  ): Promise<G9ApplyReport>;\n\n  getPendingSummary(signal?: AbortSignal): Promise<G9PendingSummary>;\n  enqueueCommand(\n    request: G9CommandRequest,\n    applyLocally: ((writer: G9LocalCommandWriter, signal?: AbortSignal) => Promise<void>) | null,\n    signal?: AbortSignal,\n  ): Promise<G9LocalCommand>;\n  getQuarantined(signal?: AbortSignal): Promise<G9QuarantinedRow[]>;\n  restoreQuarantined(localTable: string, key: string, signal?: AbortSignal): Promise<number>;\n  discardQuarantined(localTable: string | null, key: string | null, signal?: AbortSignal): Promise<number>;\n  getRetained(signal?: AbortSignal): Promise<G9RetainedRow[]>;\n  reevaluateRetained(signal?: AbortSignal): Promise<number>;\n  getCommands(state: G9ELocalCommandState | null, limit: number, signal?: AbortSignal): Promise<G9LocalCommand[]>;\n  readChangeFeed(localTable: string, afterSequence: number, limit: number, signal?: AbortSignal): Promise<G9ChangeFeedEntry[]>;\n  getChangeSequence(signal?: AbortSignal): Promise<number>;\n  getChangeFeedFloor(signal?: AbortSignal): Promise<number>;\n  getRejections(signal?: AbortSignal): Promise<G9SyncRejection[]>;\n  retryRejected(localTable: string | null, key: string | null, signal?: AbortSignal): Promise<number>;\n  markDirty(localTable: string, keys: readonly string[], signal?: AbortSignal): Promise<number>;\n  adoptExistingRows(signal?: AbortSignal): Promise<number>;\n  saveRunReport(report: G9SyncRunReport, keep: number, signal?: AbortSignal): Promise<void>;\n  getRecentRunReports(count: number, signal?: AbortSignal): Promise<G9SyncRunReport[]>;\n  getPhaseStatistics(signal?: AbortSignal): Promise<{ [key: string]: number }>;\n  recordPhaseStatistics(samples: { [key: string]: number }, signal?: AbortSignal): Promise<void>;\n  purgeDeletedFeed(keep: number, signal?: AbortSignal): Promise<number>;\n  dispose(): Promise<void>;\n}\n"]}

package/dist/client/transport.d.ts

@@ -0,0 +1,19 @@
+import type { G9DtChangesAvailable, G9DtFetchRowsRequest, G9DtHelloRequest, G9DtHelloResult, G9DtPullContinuation, G9DtPullPlan, G9DtPullRequest, G9DtPushRequest, G9DtPushResult, G9DtReconcileRequest, G9DtSyncChunk } from '../protocol/dtos.js';
+/**
+ * Carries protocol calls to a G9SyncData server. Implementations: SignalR (`@g9tm/syncdata/signalr`, and its Lynx
+ * wiring in `@g9tm/syncdata-lynx`) and the in-memory test transport (`@g9tm/syncdata/testing`). Failures surface as
+ * G9SyncException; transport faults use G9S-NET-FAILURE.
+ */
+export interface G9SyncTransport {
+    readonly isConnected: boolean;
+    /** Subscribes to server "pokes" (tables changed); returns the unsubscribe function. */
+    onChangesAvailable(handler: (changes: G9DtChangesAvailable) => void): () => void;
+    connect(signal?: AbortSignal): Promise<void>;
+    hello(request: G9DtHelloRequest, signal?: AbortSignal): Promise<G9DtHelloResult>;
+    push(request: G9DtPushRequest, chunks: AsyncIterable<G9DtSyncChunk>, signal?: AbortSignal): Promise<G9DtPushResult>;
+    planPull(request: G9DtPullRequest, signal?: AbortSignal): Promise<G9DtPullPlan>;
+    pull(token: string, continuation: G9DtPullContinuation | null, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk>;
+    reconcile(request: G9DtReconcileRequest, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk>;
+    fetchRows(request: G9DtFetchRowsRequest, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk>;
+    dispose(): Promise<void>;
+}

package/dist/client/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/client/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"","sourcesContent":["// Twin of G9SyncData.Client/Transport/IG9SyncTransport.cs.\nimport type {\n  G9DtChangesAvailable,\n  G9DtFetchRowsRequest,\n  G9DtHelloRequest,\n  G9DtHelloResult,\n  G9DtPullContinuation,\n  G9DtPullPlan,\n  G9DtPullRequest,\n  G9DtPushRequest,\n  G9DtPushResult,\n  G9DtReconcileRequest,\n  G9DtSyncChunk,\n} from '../protocol/dtos.js';\n\n/**\n * Carries protocol calls to a G9SyncData server. Implementations: SignalR (`@g9tm/syncdata/signalr`, and its Lynx\n * wiring in `@g9tm/syncdata-lynx`) and the in-memory test transport (`@g9tm/syncdata/testing`). Failures surface as\n * G9SyncException; transport faults use G9S-NET-FAILURE.\n */\nexport interface G9SyncTransport {\n  readonly isConnected: boolean;\n  /** Subscribes to server \"pokes\" (tables changed); returns the unsubscribe function. */\n  onChangesAvailable(handler: (changes: G9DtChangesAvailable) => void): () => void;\n  connect(signal?: AbortSignal): Promise<void>;\n  hello(request: G9DtHelloRequest, signal?: AbortSignal): Promise<G9DtHelloResult>;\n  push(request: G9DtPushRequest, chunks: AsyncIterable<G9DtSyncChunk>, signal?: AbortSignal): Promise<G9DtPushResult>;\n  planPull(request: G9DtPullRequest, signal?: AbortSignal): Promise<G9DtPullPlan>;\n  pull(token: string, continuation: G9DtPullContinuation | null, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk>;\n  reconcile(request: G9DtReconcileRequest, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk>;\n  fetchRows(request: G9DtFetchRowsRequest, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk>;\n  dispose(): Promise<void>;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/** The package version; equal to the .NET packages' (G9SyncDataVersion) — one release, both sides. */
+export declare const VERSION = "1.2.1";
+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';
+export { EMPTY_GUID, guidToN, newGuid, normalizeGuid, tryNormalizeGuid } from './abstractions/guid.js';
+export { G9SyncKey } from './abstractions/key.js';
+export { G9SyncDigest } from './abstractions/digest.js';
+export { G9SyncParameters, escapeDataString } from './abstractions/parameters.js';
+export * from './protocol/dtos.js';
+export { G9SyncHubErrors, G9SyncProtocol, negotiateFrameVersion, tableGroup } from './protocol/protocol.js';
+export { bytesField, dateTimeMs, fromMessagePackNames, G9WireGuid, GUID_EXTENSION_TYPE, readChangesAvailable, readContinuation, readHelloResult, readPullPlan, readPushResult, readReconcileSummary, readSyncChunk, toMessagePackNames, type G9WireFormat, } from './protocol/wire.js';
+export { G9ECompression, G9EPushRowOp, G9ERowBatchOp, G9RowBatchFormat, G9RowBatchFormatError } from './protocol/rowBatch/format.js';
+export { G9RowBatchWriter, type G9DateTimeOffsetValue, type G9DateTimeValue, type G9FrameCompressor } from './protocol/rowBatch/writer.js';
+export { G9RowBatchReader, getDefaultFrameDecompressor, openRowBatch, openRowBatchSync, readFrameHeader, setDefaultFrameDecompressor, type G9FrameDecompressor, type G9FrameHeader, type G9OpenRowBatchOptions, } from './protocol/rowBatch/reader.js';
+export { decimalToDouble, formatDecimal, formatDouble, parseDecimal, type DecimalParts } from './internal/dotnetFormat.js';
+export { G9SyncClientModel, G9SyncClientModelBuilder, G9SyncClientTable, G9SyncClientTableBuilder, type G9SyncClientColumn, type G9SyncClientIndex } from './client/model.js';
+export * from './client/storeTypes.js';
+export type { G9SyncTransport } from './client/transport.js';
+export { G9ESyncPhase, G9SyncProgressTracker, phaseName, type G9DtSyncProgress } from './client/progress.js';
+export { G9ESyncOutcome, G9ESyncPriority, G9SyncPostStep, G9SyncRun, describeModelProblem, isTransientError, normalizeError, outcomeName, priorityName, resolveEngineOptions, type G9RowsAppliedEvent, type G9SubscriptionOptions, type G9SyncEngineOptions, type G9SyncHealth, type G9SyncHostHooks, type G9SyncLogger, type G9SyncLogLevel, type G9SyncModelProblem, type G9SyncPostStepContext, type G9SyncRequest, type G9SyncRunResult, } from './client/runs.js';
+export { G9SyncEngine, stageGeneration } from './client/engine.js';
+export { base64ToBytes, bytesToBase64 } from './internal/base64.js';
+export { utf8Decode, utf8Encode } from './internal/utf8.js';
+export { md5 } from './internal/md5.js';
+export { sha256, toHex } from './internal/sha256.js';
+export { cancellationError, createAbortController, delay, linkSignals, onAbort, yieldToEventLoop } from './internal/abort.js';

package/dist/index.js

@@ -0,0 +1,35 @@
+// @g9tm/syncdata — the TypeScript twin of the G9SyncData .NET client (abstractions, protocol, engine). The SQLite store
+// is `@g9tm/syncdata/sqlite`, the SignalR transport `@g9tm/syncdata/signalr`, Node helpers `@g9tm/syncdata/node`, test
+// 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.2.1';
+// abstractions
+export { G9EConflictPolicy, G9EMoveOutPolicy, G9ESyncColumnType, G9ESyncDirection, columnTypeName, isColumnType } from './abstractions/enums.js';
+export { G9SyncErrorCodes, G9SyncException, isRetryableCode, isSyncException } from './abstractions/errors.js';
+export { G9Long, parseJson, stringifyJson } from './abstractions/long.js';
+export { EMPTY_GUID, guidToN, newGuid, normalizeGuid, tryNormalizeGuid } from './abstractions/guid.js';
+export { G9SyncKey } from './abstractions/key.js';
+export { G9SyncDigest } from './abstractions/digest.js';
+export { G9SyncParameters, escapeDataString } from './abstractions/parameters.js';
+// protocol
+export * from './protocol/dtos.js';
+export { G9SyncHubErrors, G9SyncProtocol, negotiateFrameVersion, tableGroup } from './protocol/protocol.js';
+export { bytesField, dateTimeMs, fromMessagePackNames, G9WireGuid, GUID_EXTENSION_TYPE, readChangesAvailable, readContinuation, readHelloResult, readPullPlan, readPushResult, readReconcileSummary, readSyncChunk, toMessagePackNames, } from './protocol/wire.js';
+export { G9ECompression, G9EPushRowOp, G9ERowBatchOp, G9RowBatchFormat, G9RowBatchFormatError } from './protocol/rowBatch/format.js';
+export { G9RowBatchWriter } from './protocol/rowBatch/writer.js';
+export { G9RowBatchReader, getDefaultFrameDecompressor, openRowBatch, openRowBatchSync, readFrameHeader, setDefaultFrameDecompressor, } from './protocol/rowBatch/reader.js';
+export { decimalToDouble, formatDecimal, formatDouble, parseDecimal } from './internal/dotnetFormat.js';
+// client
+export { G9SyncClientModel, G9SyncClientModelBuilder, G9SyncClientTable, G9SyncClientTableBuilder } from './client/model.js';
+export * from './client/storeTypes.js';
+export { G9ESyncPhase, G9SyncProgressTracker, phaseName } from './client/progress.js';
+export { G9ESyncOutcome, G9ESyncPriority, G9SyncPostStep, G9SyncRun, describeModelProblem, isTransientError, normalizeError, outcomeName, priorityName, resolveEngineOptions, } from './client/runs.js';
+export { G9SyncEngine, stageGeneration } from './client/engine.js';
+// helpers the Lynx package and tests share
+export { base64ToBytes, bytesToBase64 } from './internal/base64.js';
+export { utf8Decode, utf8Encode } from './internal/utf8.js';
+export { md5 } from './internal/md5.js';
+export { sha256, toHex } from './internal/sha256.js';
+export { cancellationError, createAbortController, delay, linkSignals, onAbort, yieldToEventLoop } from './internal/abort.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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\n// is `@g9tm/syncdata/sqlite`, the SignalR transport `@g9tm/syncdata/signalr`, Node helpers `@g9tm/syncdata/node`, test\n// doubles `@g9tm/syncdata/testing`, the pure-JavaScript Brotli decoder `@g9tm/syncdata/brotli-js`; Lynx wiring is the\n// separate package `@g9tm/syncdata-lynx`. Every public type keeps its .NET name without the G9C prefix (PARITY.md).\n\n/** The package version; equal to the .NET packages' (G9SyncDataVersion) — one release, both sides. */\nexport const VERSION = '1.2.1';\n\n// abstractions\nexport { G9EConflictPolicy, G9EMoveOutPolicy, G9ESyncColumnType, G9ESyncDirection, columnTypeName, isColumnType } from './abstractions/enums.js';\nexport { G9SyncErrorCodes, G9SyncException, isRetryableCode, isSyncException, type G9SyncExceptionOptions } from './abstractions/errors.js';\nexport { G9Long, parseJson, stringifyJson } from './abstractions/long.js';\nexport { EMPTY_GUID, guidToN, newGuid, normalizeGuid, tryNormalizeGuid } from './abstractions/guid.js';\nexport { G9SyncKey } from './abstractions/key.js';\nexport { G9SyncDigest } from './abstractions/digest.js';\nexport { G9SyncParameters, escapeDataString } from './abstractions/parameters.js';\n\n// protocol\nexport * from './protocol/dtos.js';\nexport { G9SyncHubErrors, G9SyncProtocol, negotiateFrameVersion, tableGroup } from './protocol/protocol.js';\nexport {\n  bytesField,\n  dateTimeMs,\n  fromMessagePackNames,\n  G9WireGuid,\n  GUID_EXTENSION_TYPE,\n  readChangesAvailable,\n  readContinuation,\n  readHelloResult,\n  readPullPlan,\n  readPushResult,\n  readReconcileSummary,\n  readSyncChunk,\n  toMessagePackNames,\n  type G9WireFormat,\n} from './protocol/wire.js';\nexport { G9ECompression, G9EPushRowOp, G9ERowBatchOp, G9RowBatchFormat, G9RowBatchFormatError } from './protocol/rowBatch/format.js';\nexport { G9RowBatchWriter, type G9DateTimeOffsetValue, type G9DateTimeValue, type G9FrameCompressor } from './protocol/rowBatch/writer.js';\nexport {\n  G9RowBatchReader,\n  getDefaultFrameDecompressor,\n  openRowBatch,\n  openRowBatchSync,\n  readFrameHeader,\n  setDefaultFrameDecompressor,\n  type G9FrameDecompressor,\n  type G9FrameHeader,\n  type G9OpenRowBatchOptions,\n} from './protocol/rowBatch/reader.js';\nexport { decimalToDouble, formatDecimal, formatDouble, parseDecimal, type DecimalParts } from './internal/dotnetFormat.js';\n\n// client\nexport { G9SyncClientModel, G9SyncClientModelBuilder, G9SyncClientTable, G9SyncClientTableBuilder, type G9SyncClientColumn, type G9SyncClientIndex } from './client/model.js';\nexport * from './client/storeTypes.js';\nexport type { G9SyncTransport } from './client/transport.js';\nexport { G9ESyncPhase, G9SyncProgressTracker, phaseName, type G9DtSyncProgress } from './client/progress.js';\nexport {\n  G9ESyncOutcome,\n  G9ESyncPriority,\n  G9SyncPostStep,\n  G9SyncRun,\n  describeModelProblem,\n  isTransientError,\n  normalizeError,\n  outcomeName,\n  priorityName,\n  resolveEngineOptions,\n  type G9RowsAppliedEvent,\n  type G9SubscriptionOptions,\n  type G9SyncEngineOptions,\n  type G9SyncHealth,\n  type G9SyncHostHooks,\n  type G9SyncLogger,\n  type G9SyncLogLevel,\n  type G9SyncModelProblem,\n  type G9SyncPostStepContext,\n  type G9SyncRequest,\n  type G9SyncRunResult,\n} from './client/runs.js';\nexport { G9SyncEngine, stageGeneration } from './client/engine.js';\n\n// helpers the Lynx package and tests share\nexport { base64ToBytes, bytesToBase64 } from './internal/base64.js';\nexport { utf8Decode, utf8Encode } from './internal/utf8.js';\nexport { md5 } from './internal/md5.js';\nexport { sha256, toHex } from './internal/sha256.js';\nexport { cancellationError, createAbortController, delay, linkSignals, onAbort, yieldToEventLoop } from './internal/abort.js';\n"]}

package/dist/internal/abort.d.ts

@@ -0,0 +1,21 @@
+type Listener = () => void;
+/** An AbortController (native when the runtime has one). */
+export interface G9AbortController {
+    readonly signal: AbortSignal;
+    abort(reason?: unknown): void;
+}
+export declare function createAbortController(): G9AbortController;
+/** Calls `callback` once when `signal` aborts (at once when it already has); returns the unsubscribe function. */
+export declare function onAbort(signal: AbortSignal | null | undefined, callback: Listener): () => void;
+/** A controller that aborts when any of `signals` does (`CancellationTokenSource.CreateLinkedTokenSource`). */
+export declare function linkSignals(...signals: (AbortSignal | null | undefined)[]): G9AbortController & {
+    dispose(): void;
+};
+/** The error a cancelled operation rejects with (name `AbortError`, like DOM's). */
+export declare function cancellationError(message?: string): Error;
+export declare function throwIfAborted(signal: AbortSignal | null | undefined): void;
+/** `Task.Delay(ms, token)`. */
+export declare function delay(ms: number, signal?: AbortSignal | null): Promise<void>;
+/** Lets the event loop run (Lynx: keeps the background thread responsive during long applies). */
+export declare function yieldToEventLoop(): Promise<void>;
+export {};

package/dist/internal/abort.js

@@ -0,0 +1,125 @@
+// Cancellation (the CancellationToken twin) over AbortSignal. Lynx has AbortController on globalThis; a runtime without
+// one gets a minimal stand-in with the same surface, so the library never depends on it existing.
+class FallbackSignal {
+    constructor() {
+        this.aborted = false;
+        this.reason = undefined;
+        this.onabort = null;
+        this._listeners = [];
+    }
+    addEventListener(_type, listener) {
+        this._listeners.push(listener);
+    }
+    removeEventListener(_type, listener) {
+        const index = this._listeners.indexOf(listener);
+        if (index >= 0)
+            this._listeners.splice(index, 1);
+    }
+    /** @internal */
+    fire(reason) {
+        if (this.aborted)
+            return;
+        this.aborted = true;
+        this.reason = reason;
+        const listeners = this._listeners.splice(0, this._listeners.length);
+        for (const listener of listeners) {
+            try {
+                listener();
+            }
+            catch {
+                // a listener must not stop the others
+            }
+        }
+        if (this.onabort) {
+            try {
+                this.onabort.call(this);
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+export function createAbortController() {
+    const Native = globalThis.AbortController;
+    if (typeof Native === 'function')
+        return new Native();
+    const signal = new FallbackSignal();
+    return {
+        signal: signal,
+        abort: (reason) => signal.fire(reason === undefined ? cancellationError() : reason),
+    };
+}
+/** Calls `callback` once when `signal` aborts (at once when it already has); returns the unsubscribe function. */
+export function onAbort(signal, callback) {
+    if (!signal)
+        return noop;
+    if (signal.aborted) {
+        callback();
+        return noop;
+    }
+    let done = false;
+    const listener = () => {
+        if (done)
+            return;
+        done = true;
+        callback();
+    };
+    signal.addEventListener('abort', listener);
+    return () => {
+        done = true;
+        signal.removeEventListener('abort', listener);
+    };
+}
+function noop() {
+    // nothing to undo
+}
+/** A controller that aborts when any of `signals` does (`CancellationTokenSource.CreateLinkedTokenSource`). */
+export function linkSignals(...signals) {
+    const controller = createAbortController();
+    const unsubscribes = [];
+    for (const signal of signals) {
+        unsubscribes.push(onAbort(signal, () => controller.abort(signal ? signal.reason : undefined)));
+    }
+    return {
+        signal: controller.signal,
+        abort: (reason) => controller.abort(reason),
+        dispose: () => {
+            for (const unsubscribe of unsubscribes)
+                unsubscribe();
+        },
+    };
+}
+/** The error a cancelled operation rejects with (name `AbortError`, like DOM's). */
+export function cancellationError(message = 'The operation was canceled.') {
+    const error = new Error(message);
+    error.name = 'AbortError';
+    return error;
+}
+export function throwIfAborted(signal) {
+    if (signal && signal.aborted)
+        throw cancellationError();
+}
+/** `Task.Delay(ms, token)`. */
+export function delay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal && signal.aborted) {
+            reject(cancellationError());
+            return;
+        }
+        let unsubscribe = noop;
+        const timer = setTimeout(() => {
+            unsubscribe();
+            resolve();
+        }, Math.max(0, ms));
+        unsubscribe = onAbort(signal, () => {
+            clearTimeout(timer);
+            reject(cancellationError());
+        });
+    });
+}
+/** Lets the event loop run (Lynx: keeps the background thread responsive during long applies). */
+export function yieldToEventLoop() {
+    return new Promise((resolve) => setTimeout(resolve, 0));
+}
+//# sourceMappingURL=abort.js.map

package/dist/internal/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../src/internal/abort.ts"],"names":[],"mappings":"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","sourcesContent":["// Cancellation (the CancellationToken twin) over AbortSignal. Lynx has AbortController on globalThis; a runtime without\n// one gets a minimal stand-in with the same surface, so the library never depends on it existing.\n\ntype Listener = () => void;\n\ninterface MinimalSignal {\n  readonly aborted: boolean;\n  readonly reason: unknown;\n  addEventListener(type: 'abort', listener: Listener, options?: { once?: boolean }): void;\n  removeEventListener(type: 'abort', listener: Listener): void;\n}\n\nclass FallbackSignal implements MinimalSignal {\n  aborted = false;\n  reason: unknown = undefined;\n  onabort: ((this: unknown) => void) | null = null;\n  private readonly _listeners: Listener[] = [];\n\n  addEventListener(_type: 'abort', listener: Listener): void {\n    this._listeners.push(listener);\n  }\n\n  removeEventListener(_type: 'abort', listener: Listener): void {\n    const index = this._listeners.indexOf(listener);\n    if (index >= 0) this._listeners.splice(index, 1);\n  }\n\n  /** @internal */\n  fire(reason: unknown): void {\n    if (this.aborted) return;\n    this.aborted = true;\n    this.reason = reason;\n    const listeners = this._listeners.splice(0, this._listeners.length);\n    for (const listener of listeners) {\n      try {\n        listener();\n      } catch {\n        // a listener must not stop the others\n      }\n    }\n    if (this.onabort) {\n      try {\n        this.onabort.call(this);\n      } catch {\n        // ignore\n      }\n    }\n  }\n}\n\n/** An AbortController (native when the runtime has one). */\nexport interface G9AbortController {\n  readonly signal: AbortSignal;\n  abort(reason?: unknown): void;\n}\n\nexport function createAbortController(): G9AbortController {\n  const Native = (globalThis as { AbortController?: new () => G9AbortController }).AbortController;\n  if (typeof Native === 'function') return new Native();\n  const signal = new FallbackSignal();\n  return {\n    signal: signal as unknown as AbortSignal,\n    abort: (reason?: unknown) => signal.fire(reason === undefined ? cancellationError() : reason),\n  };\n}\n\n/** Calls `callback` once when `signal` aborts (at once when it already has); returns the unsubscribe function. */\nexport function onAbort(signal: AbortSignal | null | undefined, callback: Listener): () => void {\n  if (!signal) return noop;\n  if (signal.aborted) {\n    callback();\n    return noop;\n  }\n  let done = false;\n  const listener = (): void => {\n    if (done) return;\n    done = true;\n    callback();\n  };\n  (signal as unknown as MinimalSignal).addEventListener('abort', listener);\n  return () => {\n    done = true;\n    (signal as unknown as MinimalSignal).removeEventListener('abort', listener);\n  };\n}\n\nfunction noop(): void {\n  // nothing to undo\n}\n\n/** A controller that aborts when any of `signals` does (`CancellationTokenSource.CreateLinkedTokenSource`). */\nexport function linkSignals(...signals: (AbortSignal | null | undefined)[]): G9AbortController & { dispose(): void } {\n  const controller = createAbortController();\n  const unsubscribes: (() => void)[] = [];\n  for (const signal of signals) {\n    unsubscribes.push(onAbort(signal, () => controller.abort(signal ? signal.reason : undefined)));\n  }\n  return {\n    signal: controller.signal,\n    abort: (reason?: unknown) => controller.abort(reason),\n    dispose: () => {\n      for (const unsubscribe of unsubscribes) unsubscribe();\n    },\n  };\n}\n\n/** The error a cancelled operation rejects with (name `AbortError`, like DOM's). */\nexport function cancellationError(message = 'The operation was canceled.'): Error {\n  const error = new Error(message);\n  error.name = 'AbortError';\n  return error;\n}\n\nexport function throwIfAborted(signal: AbortSignal | null | undefined): void {\n  if (signal && signal.aborted) throw cancellationError();\n}\n\n/** `Task.Delay(ms, token)`. */\nexport function delay(ms: number, signal?: AbortSignal | null): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    if (signal && signal.aborted) {\n      reject(cancellationError());\n      return;\n    }\n    let unsubscribe: () => void = noop;\n    const timer = setTimeout(() => {\n      unsubscribe();\n      resolve();\n    }, Math.max(0, ms));\n    unsubscribe = onAbort(signal, () => {\n      clearTimeout(timer);\n      reject(cancellationError());\n    });\n  });\n}\n\n/** Lets the event loop run (Lynx: keeps the background thread responsive during long applies). */\nexport function yieldToEventLoop(): Promise<void> {\n  return new Promise<void>((resolve) => setTimeout(resolve, 0));\n}\n"]}

package/dist/internal/base64.d.ts

@@ -0,0 +1,8 @@
+/** Standard (RFC 4648, padded) base64 of `bytes` — what System.Text.Json writes and reads for `byte[]`. */
+export declare function bytesToBase64(bytes: Uint8Array): string;
+/** The table-driven encoder (exported for tests; use {@link bytesToBase64}). */
+export declare function bytesToBase64Js(bytes: Uint8Array): string;
+/** Decodes standard or url-safe base64 (padding optional, whitespace ignored). Throws on any other character. */
+export declare function base64ToBytes(text: string): Uint8Array;
+/** The table-driven decoder (exported for tests; use {@link base64ToBytes}). */
+export declare function base64ToBytesJs(text: string): Uint8Array;

package/dist/internal/base64.js

@@ -0,0 +1,85 @@
+// Base64 helpers that work in browsers, WebViews, Node and Lynx without Buffer, btoa or atob (Lynx's background
+// thread has none of them). They use the native Uint8Array.prototype.toBase64 / Uint8Array.fromBase64 (ES2026) when
+// the runtime has them, and a table-driven codec otherwise.
+const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+const ENCODE = [];
+const DECODE = new Int16Array(256).fill(-1);
+for (let i = 0; i < ALPHABET.length; i++) {
+    ENCODE[i] = ALPHABET.charAt(i);
+    DECODE[ALPHABET.charCodeAt(i)] = i;
+}
+// base64url digits decode too (they never collide with the standard ones).
+DECODE['-'.charCodeAt(0)] = 62;
+DECODE['_'.charCodeAt(0)] = 63;
+/** Standard (RFC 4648, padded) base64 of `bytes` — what System.Text.Json writes and reads for `byte[]`. */
+export function bytesToBase64(bytes) {
+    const native = bytes.toBase64;
+    if (typeof native === 'function')
+        return native.call(bytes);
+    return bytesToBase64Js(bytes);
+}
+/** The table-driven encoder (exported for tests; use {@link bytesToBase64}). */
+export function bytesToBase64Js(bytes) {
+    const parts = [];
+    const length = bytes.length;
+    const whole = length - (length % 3);
+    let line = '';
+    for (let i = 0; i < whole; i += 3) {
+        const n = (bytes[i] << 16) | (bytes[i + 1] << 8) | bytes[i + 2];
+        line += ENCODE[n >>> 18] + ENCODE[(n >>> 12) & 63] + ENCODE[(n >>> 6) & 63] + ENCODE[n & 63];
+        // Joining bounded pieces keeps string building linear on engines without rope strings.
+        if (line.length >= 8192) {
+            parts.push(line);
+            line = '';
+        }
+    }
+    const rest = length - whole;
+    if (rest === 1) {
+        const n = bytes[whole] << 16;
+        line += ENCODE[n >>> 18] + ENCODE[(n >>> 12) & 63] + '==';
+    }
+    else if (rest === 2) {
+        const n = (bytes[whole] << 16) | (bytes[whole + 1] << 8);
+        line += ENCODE[n >>> 18] + ENCODE[(n >>> 12) & 63] + ENCODE[(n >>> 6) & 63] + '=';
+    }
+    parts.push(line);
+    return parts.join('');
+}
+/** Decodes standard or url-safe base64 (padding optional, whitespace ignored). Throws on any other character. */
+export function base64ToBytes(text) {
+    const native = Uint8Array.fromBase64;
+    if (typeof native === 'function') {
+        try {
+            return native(text);
+        }
+        catch {
+            // Fall through to the table codec, which also accepts url-safe digits and missing padding.
+        }
+    }
+    return base64ToBytesJs(text);
+}
+/** The table-driven decoder (exported for tests; use {@link base64ToBytes}). */
+export function base64ToBytesJs(text) {
+    const out = new Uint8Array(Math.floor((text.length * 3) / 4) + 3);
+    let size = 0;
+    let buffer = 0;
+    let bits = 0;
+    for (let i = 0; i < text.length; i++) {
+        const code = text.charCodeAt(i);
+        if (code === 61 /* = */)
+            break;
+        if (code === 32 || code === 9 || code === 10 || code === 13)
+            continue;
+        const value = code < 256 ? DECODE[code] : -1;
+        if (value < 0)
+            throw new SyntaxError(`Invalid base64 character at position ${i}.`);
+        buffer = ((buffer << 6) | value) & 0xffffff;
+        bits += 6;
+        if (bits >= 8) {
+            bits -= 8;
+            out[size++] = (buffer >>> bits) & 0xff;
+        }
+    }
+    return out.subarray(0, size);
+}
+//# sourceMappingURL=base64.js.map

package/dist/internal/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/internal/base64.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,oHAAoH;AACpH,4DAA4D;AAK5D,MAAM,QAAQ,GAAG,kEAAkE,CAAC;AACpF,MAAM,MAAM,GAAa,EAAE,CAAC;AAC5B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;IACzC,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AACD,2EAA2E;AAC3E,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAE/B,2GAA2G;AAC3G,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,MAAM,MAAM,GAAI,KAAmC,CAAC,QAAQ,CAAC;IAC7D,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACnE,IAAI,IAAI,MAAM,CAAC,CAAC,KAAK,EAAE,CAAE,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAE,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAE,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAE,CAAC;QACjG,uFAAuF;QACvF,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC;IAC5B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAE,IAAI,EAAE,CAAC;QAC9B,IAAI,IAAI,MAAM,CAAC,CAAC,KAAK,EAAE,CAAE,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAE,GAAG,IAAI,CAAC;IAC9D,CAAC;SAAM,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC;QAC3D,IAAI,IAAI,MAAM,CAAC,CAAC,KAAK,EAAE,CAAE,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAE,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAE,GAAG,GAAG,CAAC;IACvF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAI,UAA0C,CAAC,UAAU,CAAC;IACtE,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,2FAA2F;QAC7F,CAAC;IACH,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,EAAE,CAAC,OAAO;YAAE,MAAM;QAC/B,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS;QACtE,MAAM,KAAK,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,WAAW,CAAC,wCAAwC,CAAC,GAAG,CAAC,CAAC;QACnF,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,QAAQ,CAAC;QAC5C,IAAI,IAAI,CAAC,CAAC;QACV,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACd,IAAI,IAAI,CAAC,CAAC;YACV,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["// Base64 helpers that work in browsers, WebViews, Node and Lynx without Buffer, btoa or atob (Lynx's background\n// thread has none of them). They use the native Uint8Array.prototype.toBase64 / Uint8Array.fromBase64 (ES2026) when\n// the runtime has them, and a table-driven codec otherwise.\n\ntype NativeToBase64 = { toBase64?: () => string };\ntype NativeFromBase64 = { fromBase64?: (text: string) => Uint8Array };\n\nconst ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\nconst ENCODE: string[] = [];\nconst DECODE = new Int16Array(256).fill(-1);\nfor (let i = 0; i < ALPHABET.length; i++) {\n  ENCODE[i] = ALPHABET.charAt(i);\n  DECODE[ALPHABET.charCodeAt(i)] = i;\n}\n// base64url digits decode too (they never collide with the standard ones).\nDECODE['-'.charCodeAt(0)] = 62;\nDECODE['_'.charCodeAt(0)] = 63;\n\n/** Standard (RFC 4648, padded) base64 of `bytes` — what System.Text.Json writes and reads for `byte[]`. */\nexport function bytesToBase64(bytes: Uint8Array): string {\n  const native = (bytes as unknown as NativeToBase64).toBase64;\n  if (typeof native === 'function') return native.call(bytes);\n  return bytesToBase64Js(bytes);\n}\n\n/** The table-driven encoder (exported for tests; use {@link bytesToBase64}). */\nexport function bytesToBase64Js(bytes: Uint8Array): string {\n  const parts: string[] = [];\n  const length = bytes.length;\n  const whole = length - (length % 3);\n  let line = '';\n  for (let i = 0; i < whole; i += 3) {\n    const n = (bytes[i]! << 16) | (bytes[i + 1]! << 8) | bytes[i + 2]!;\n    line += ENCODE[n >>> 18]! + ENCODE[(n >>> 12) & 63]! + ENCODE[(n >>> 6) & 63]! + ENCODE[n & 63]!;\n    // Joining bounded pieces keeps string building linear on engines without rope strings.\n    if (line.length >= 8192) {\n      parts.push(line);\n      line = '';\n    }\n  }\n  const rest = length - whole;\n  if (rest === 1) {\n    const n = bytes[whole]! << 16;\n    line += ENCODE[n >>> 18]! + ENCODE[(n >>> 12) & 63]! + '==';\n  } else if (rest === 2) {\n    const n = (bytes[whole]! << 16) | (bytes[whole + 1]! << 8);\n    line += ENCODE[n >>> 18]! + ENCODE[(n >>> 12) & 63]! + ENCODE[(n >>> 6) & 63]! + '=';\n  }\n  parts.push(line);\n  return parts.join('');\n}\n\n/** Decodes standard or url-safe base64 (padding optional, whitespace ignored). Throws on any other character. */\nexport function base64ToBytes(text: string): Uint8Array {\n  const native = (Uint8Array as unknown as NativeFromBase64).fromBase64;\n  if (typeof native === 'function') {\n    try {\n      return native(text);\n    } catch {\n      // Fall through to the table codec, which also accepts url-safe digits and missing padding.\n    }\n  }\n  return base64ToBytesJs(text);\n}\n\n/** The table-driven decoder (exported for tests; use {@link base64ToBytes}). */\nexport function base64ToBytesJs(text: string): Uint8Array {\n  const out = new Uint8Array(Math.floor((text.length * 3) / 4) + 3);\n  let size = 0;\n  let buffer = 0;\n  let bits = 0;\n  for (let i = 0; i < text.length; i++) {\n    const code = text.charCodeAt(i);\n    if (code === 61 /* = */) break;\n    if (code === 32 || code === 9 || code === 10 || code === 13) continue;\n    const value = code < 256 ? DECODE[code]! : -1;\n    if (value < 0) throw new SyntaxError(`Invalid base64 character at position ${i}.`);\n    buffer = ((buffer << 6) | value) & 0xffffff;\n    bits += 6;\n    if (bits >= 8) {\n      bits -= 8;\n      out[size++] = (buffer >>> bits) & 0xff;\n    }\n  }\n  return out.subarray(0, size);\n}\n"]}

package/dist/internal/dotnetFormat.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `double.ToString(CultureInfo.InvariantCulture)` (.NET Core 3.0+): the shortest round-trip digits, in fixed notation
+ * unless the decimal exponent is 17 or more, or below -4, then `d.dddE+XX` (the golden vectors pin both edges).
+ */
+export declare function formatDouble(value: number): string;
+/** The parts of a .NET `decimal`: 96-bit magnitude as three 32-bit words, a scale 0..28 and a sign. */
+export interface DecimalParts {
+    lo: number;
+    mid: number;
+    hi: number;
+    scale: number;
+    negative: boolean;
+}
+/** `decimal.ToString(CultureInfo.InvariantCulture)`: every digit of the magnitude, the scale kept (`1.50`, `0.000`). */
+export declare function formatDecimal(parts: DecimalParts): string;
+/**
+ * `(double)decimal` exactly as .NET computes it (`DecCalc.VarR8FromDec`): `((double)low64 + (double)high · 2^64) /
+ * 10^scale`, each step an IEEE double operation, so the result matches .NET to the bit (it is not always the correctly
+ * rounded value, and must not be: the server compares what .NET stored).
+ */
+export declare function decimalToDouble(parts: DecimalParts): number;
+/**
+ * Parses invariant decimal text (`decimal.Parse(text, NumberStyles.Number | NumberStyles.AllowExponent, Invariant)`
+ * for the forms SQLite and .NET produce: sign, digits, one '.', an optional exponent). Digits past 28 significant are
+ * rounded half to even… as .NET does (to the 96-bit limit). Returns null for text that is not a number.
+ */
+export declare function parseDecimal(text: string): DecimalParts | null;
+/**
+ * `(decimal)double` exactly as .NET converts it (`new decimal(double)`, VarDecFromR8): the value rounded to 15
+ * significant digits, then trailing zeros dropped. Throws `RangeError` for NaN, infinities and |value| ≥ 7.9e28.
+ */
+export declare function doubleToDecimal(value: number): DecimalParts;