@voidhash/mimic 0.0.2 → 0.0.3

package/dist/server/index.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/server/ServerDocument.ts","../../src/server/errors.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UAWiB,kBAAA;;wBAEO;;;;;;AAFxB;AAUiB,UAAA,YAAA,CAAY;EASZ,SAAA,IAAA,EAAA,OAAe;EASpB,SAAA,aAAa,EAAA,MAAA;EAAG,SAAA,MAAA,EAAA,MAAA;;;;AAS5B;AAWiB,UA7BA,eAAA,CA6BqB;EAAiB,SAAA,IAAA,EAAA,UAAA;EAEpC,SAAA,KAAA,EAAA,OAAA;EAE4B,SAAA,OAAA,EAAA,MAAA;;;;AAc/C;AAAgD,KAtCpC,aAAA,GAAgB,kBAsCoB,GAtCC,YAsCD,GAtCgB,eAsChB;;;;AAgB1B,KA7CV,YAAA,GA6CU;EAA0B,SAAA,OAAA,EAAA,IAAA;EAM/B,SAAA,OAAA,EAAA,MAAA;CAAe,GAAA;EAgBnB,SAuJZ,OAAA,EAAA,KAAA;EAvJoC,SAAA,MAAA,EAAA,MAAA;CACJ;;;;AAChB,UA1DA,qBA0DA,CAAA,gBA1DsC,YA0DtC,CAAA,CAAA;;mBAxDE;;ECpDN,SAAA,YAAiB,CAAA,EDsDJ,UCtDiB,CDsDI,OCtDJ,CAAA;EAW9B;EAcA,SAAA,cAAA,CAAsB,EAAA,MAAA;EAgBtB;EAGe,SAAA,WAAA,EAAA,CAAA,OAAA,EDcM,kBCdN,EAAA,GAAA,IAAA;EAEkC;EALpB,SAAA,WAAA,CAAA,EAAA,CAAA,aAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAAgB;EAgB7C,SAAA,qBAAsB,CAAA,EAAA,MAAQ;AAc3C;;;;UDHiB,+BAA+B;;mBAE7B;;SAGV,WAAqB;;;;;;;;;sBAWR,cAA0B;;;;;iBAM/B;;;;;;;;;;cAgBJ,uBAAwB,uBAC1B,sBAAsB,aAC9B,eAAe;;;;;;cC5GL,gBAAA,SAAyB,KAAA;;;;;;;cAWzB,eAAA,SAAwB,gBAAA;;;EDTpB,WAAA,CAAA,aAAkB,EAAA,MAEX,EAAA,OAAA,EAAuB,MAAA;AAQ/C;AASA;AASA;;AAAiD,cCLpC,qBAAA,SAA8B,gBAAA,CDKM;EAAe,SAAA,IAAA,GAAA,uBAAA;EAAe,SAAA,aAAA,EAAA,MAAA;EASnE,SAAA,IAAA,EAAY,MAAA;EAWP,WAAA,CAAA,aAAqB,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA;;;;;AAQJ,cCjBrB,oBAAA,SAA6B,gBAAA,CDiBR;EAAkB,SAAA,IAAA,GAAA,sBAAA;EAUnC,SAAA,aAAc,EAAA,MAAA;EAAiB,SAAA,KAAA,CAAA,ECxBpB,KDwBoB;EAE7B,WAAA,CAAA,aAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,EAAA,KAAA,CAAA,ECxB2C,KDwB3C;;;;;AAoBF,cCjCJ,qBAAA,SAA8B,gBAAA,CDiC1B;EAAe,SAAA,IAAA,GAAA,uBAAA;EAgBnB,SAuJZ,aAAA,EAAA,MAAA;EAvJoC,WAAA,CAAA,aAAA,EAAA,MAAA;;;;;AAEpB,cCrCJ,yBAAA,SAAkC,gBAAA,CDqC9B;;;;AC5GjB"}

package/dist/server/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/server/ServerDocument.ts","../../src/server/errors.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UAWiB,kBAAA;;wBAEO;;;;;;;AAFP,UAUA,YAAA,CAVkB;EAUlB,SAAA,IAAA,EAAY,OAAA;EASZ,SAAA,aAAe,EAAA,MAAA;EASpB,SAAA,MAAA,EAAa,MAAA;;;;;AASb,UAlBK,eAAA,CAkBO;EAWP,SAAA,IAAA,EAAA,UAAqB;EAAiB,SAAA,KAAA,EAAA,OAAA;EAEpC,SAAA,OAAA,EAAA,MAAA;;;;;AAgBF,KAtCL,aAAA,GAAgB,kBAsCG,GAtCkB,YAsClB,GAtCiC,eAsCjC;;;;AAKtB,KAlCG,YAAA,GAkCH;EAWa,SAAA,OAAA,EAAA,IAAA;EAA0B,SAAA,OAAA,EAAA,MAAA;CAM/B,GAAA;EAAe,SAAA,OAAA,EAAA,KAAA;EAgBnB,SAuJZ,MAAA,EAAA,MAAA;CAvJoC;;;;AAElC,UA1Dc,qBA0Dd,CAAA,gBA1DoD,YA0DpD,CAAA,CAAA;EAAc;mBAxDE;;0BAEO,WAAqB;ECtDlC;EAWA,SAAA,cAAgB,CAAA,EAAA,MAAQ;EAcxB;EAgBA,SAAA,WAAA,EAAA,CAAqB,OAAA,EDiBA,kBCjBA,EAAA,GAAA,IAAA;EAGN;EAEkC,SAAA,WAAA,CAAA,EAAA,CAAA,aAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EALpB;EAAgB,SAAA,qBAAA,CAAA,EAAA,MAAA;AAgB1D;AAcA;;;UDHiB,+BAA+B;;mBAE7B;;SAGV,WAAqB;;;;;;;;;sBAWR,cAA0B;;;;;iBAM/B;;;;;;;;;;cAgBJ,uBAAwB,uBAC1B,sBAAsB,aAC9B,eAAe;;;;;;cC5GL,gBAAA,SAAyB,KAAA;;;;;;;cAWzB,eAAA,SAAwB,gBAAA;;;;ADTrC;AAUA;AASA;AASA;AAA4B,cCLf,qBAAA,SAA8B,gBAAA,CDKf;EAAqB,SAAA,IAAA,GAAA,uBAAA;EAAe,SAAA,aAAA,EAAA,MAAA;EAAe,SAAA,IAAA,EAAA,MAAA;EASnE,WAAA,CAAA,aAAY,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA;AAWxB;;;;AAI0B,cCbb,oBAAA,SAA6B,gBAAA,CDahB;EAIQ,SAAA,IAAA,GAAA,sBAAA;EAAkB,SAAA,aAAA,EAAA,MAAA;EAUnC,SAAA,KAAA,CAAA,ECxBW,KDwBG;EAAiB,WAAA,CAAA,aAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,EAAA,KAAA,CAAA,ECtBc,KDsBd;;;;;AAgBA,cC3BnC,qBAAA,SAA8B,gBAAA,CD2BK;EAM/B,SAAA,IAAA,GAAA,uBAAA;EAAe,SAAA,aAAA,EAAA,MAAA;EAgBnB,WAuJZ,CAAA,aAAA,EAAA,MAAA;;;;;AArJE,cCrCU,yBAAA,SAAkC,gBAAA,CDqC5C;EAAc,SAAA,IAAA,GAAA,2BAAA"}

package/dist/server/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":["Document.make","_transactionOrder: string[]","Transaction.isEmpty"],"sources":["../../src/server/ServerDocument.ts","../../src/server/errors.ts"],"sourcesContent":["import * as Document from \"../Document\";\nimport * as Transaction from \"../Transaction\";\nimport type * as Primitive from \"../Primitive\";\n\n// =============================================================================\n// Server Message Types (matching client's Transport expectations)\n// =============================================================================\n\n/**\n * Message sent when broadcasting a committed transaction.\n */\nexport interface TransactionMessage {\n  readonly type: \"transaction\";\n  readonly transaction: Transaction.Transaction;\n  /** Server-assigned version number for ordering */\n  readonly version: number;\n}\n\n/**\n * Message sent when a transaction is rejected.\n */\nexport interface ErrorMessage {\n  readonly type: \"error\";\n  readonly transactionId: string;\n  readonly reason: string;\n}\n\n/**\n * Message sent as a full state snapshot.\n */\nexport interface SnapshotMessage {\n  readonly type: \"snapshot\";\n  readonly state: unknown;\n  readonly version: number;\n}\n\n/**\n * Union of all server messages that can be broadcast.\n */\nexport type ServerMessage = TransactionMessage | ErrorMessage | SnapshotMessage;\n\n// =============================================================================\n// Submit Result Types\n// =============================================================================\n\n/**\n * Result of submitting a transaction to the server.\n */\nexport type SubmitResult =\n  | { readonly success: true; readonly version: number }\n  | { readonly success: false; readonly reason: string };\n\n// =============================================================================\n// Server Document Types\n// =============================================================================\n\n/**\n * Options for creating a ServerDocument.\n */\nexport interface ServerDocumentOptions<TSchema extends Primitive.AnyPrimitive> {\n  /** The schema defining the document structure */\n  readonly schema: TSchema;\n  /** Initial state (optional, will use schema defaults if not provided) */\n  readonly initialState?: Primitive.InferState<TSchema>;\n  /** Initial version number (optional, defaults to 0) */\n  readonly initialVersion?: number;\n  /** Called when a transaction is successfully applied and should be broadcast */\n  readonly onBroadcast: (message: TransactionMessage) => void;\n  /** Called when a transaction is rejected (optional, for logging/metrics) */\n  readonly onRejection?: (transactionId: string, reason: string) => void;\n  /** Maximum number of processed transaction IDs to track for deduplication */\n  readonly maxTransactionHistory?: number;\n}\n\n/**\n * A ServerDocument maintains the authoritative state and processes client transactions.\n */\nexport interface ServerDocument<TSchema extends Primitive.AnyPrimitive> {\n  /** The schema defining this document's structure */\n  readonly schema: TSchema;\n\n  /** Returns the current authoritative state */\n  get(): Primitive.InferState<TSchema> | undefined;\n\n  /** Returns the current version number */\n  getVersion(): number;\n\n  /**\n   * Submits a transaction for processing.\n   * Validates and applies the transaction if valid, or rejects it with a reason.\n   * @param transaction - The transaction to process\n   * @returns SubmitResult indicating success with version or failure with reason\n   */\n  submit(transaction: Transaction.Transaction): SubmitResult;\n\n  /**\n   * Returns a snapshot of the current state and version.\n   * Used to initialize new clients or resync after drift.\n   */\n  getSnapshot(): SnapshotMessage;\n\n  /**\n   * Checks if a transaction has already been processed.\n   * @param transactionId - The transaction ID to check\n   */\n  hasProcessed(transactionId: string): boolean;\n}\n\n// =============================================================================\n// Server Document Implementation\n// =============================================================================\n\n/**\n * Creates a new ServerDocument for the given schema.\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  options: ServerDocumentOptions<TSchema>\n): ServerDocument<TSchema> => {\n  const {\n    schema,\n    initialState,\n    initialVersion = 0,\n    onBroadcast,\n    onRejection,\n    maxTransactionHistory = 1000,\n  } = options;\n\n  // ==========================================================================\n  // Internal State\n  // ==========================================================================\n\n  // The authoritative document\n  let _document = Document.make(schema, { initial: initialState });\n\n  // Current version number (incremented on each successful transaction)\n  let _version = initialVersion;\n\n  // Track processed transaction IDs for deduplication\n  const _processedTransactions = new Set<string>();\n  const _transactionOrder: string[] = [];\n\n  // ==========================================================================\n  // Helper Functions\n  // ==========================================================================\n\n  /**\n   * Records a transaction as processed, maintaining the history limit.\n   */\n  const recordTransaction = (transactionId: string): void => {\n    _processedTransactions.add(transactionId);\n    _transactionOrder.push(transactionId);\n\n    // Evict oldest transactions if over limit\n    while (_transactionOrder.length > maxTransactionHistory) {\n      const oldest = _transactionOrder.shift();\n      if (oldest) {\n        _processedTransactions.delete(oldest);\n      }\n    }\n  };\n\n  /**\n   * Validates that the transaction can be applied to the current state.\n   * Creates a temporary document and attempts to apply the operations.\n   */\n  const validateTransaction = (\n    transaction: Transaction.Transaction\n  ): { valid: true } | { valid: false; reason: string } => {\n    // Check for empty transaction\n    if (Transaction.isEmpty(transaction)) {\n      return { valid: false, reason: \"Transaction is empty\" };\n    }\n\n    // Check for duplicate transaction\n    if (_processedTransactions.has(transaction.id)) {\n      return { valid: false, reason: \"Transaction has already been processed\" };\n    }\n\n    // Create a temporary document with current state to test the operations\n    const currentState = _document.get();\n    const tempDoc = Document.make(schema, { initial: currentState });\n\n    try {\n      // Attempt to apply all operations\n      tempDoc.apply(transaction.ops);\n      return { valid: true };\n    } catch (error) {\n      // Operations failed to apply\n      const message = error instanceof Error ? error.message : String(error);\n      return { valid: false, reason: message };\n    }\n  };\n\n  // ==========================================================================\n  // Public API\n  // ==========================================================================\n\n  const serverDocument: ServerDocument<TSchema> = {\n    schema,\n\n    get: (): Primitive.InferState<TSchema> | undefined => {\n      return _document.get();\n    },\n\n    getVersion: (): number => {\n      return _version;\n    },\n\n    submit: (transaction: Transaction.Transaction): SubmitResult => {\n      // Validate the transaction\n      const validation = validateTransaction(transaction);\n\n      if (!validation.valid) {\n        // Notify rejection callback if provided\n        onRejection?.(transaction.id, validation.reason);\n\n        return {\n          success: false,\n          reason: validation.reason,\n        };\n      }\n\n      // Apply the transaction to the authoritative state\n      try {\n        _document.apply(transaction.ops);\n      } catch (error) {\n        // This shouldn't happen since we validated, but handle gracefully\n        const reason = error instanceof Error ? error.message : String(error);\n        onRejection?.(transaction.id, reason);\n        return { success: false, reason };\n      }\n\n      // Increment version\n      _version += 1;\n\n      // Record as processed\n      recordTransaction(transaction.id);\n\n      // Broadcast the confirmed transaction\n      const message: TransactionMessage = {\n        type: \"transaction\",\n        transaction,\n        version: _version,\n      };\n      onBroadcast(message);\n\n      return {\n        success: true,\n        version: _version,\n      };\n    },\n\n    getSnapshot: (): SnapshotMessage => {\n      return {\n        type: \"snapshot\",\n        state: _document.get(),\n        version: _version,\n      };\n    },\n\n    hasProcessed: (transactionId: string): boolean => {\n      return _processedTransactions.has(transactionId);\n    },\n  };\n\n  return serverDocument;\n};\n","import type * as Transaction from \"../Transaction\";\n\n// =============================================================================\n// Server Errors\n// =============================================================================\n\n/**\n * Base error class for all mimic-server errors.\n */\nexport class MimicServerError extends Error {\n  readonly _tag: string = \"MimicServerError\";\n  constructor(message: string) {\n    super(message);\n    this.name = \"MimicServerError\";\n  }\n}\n\n/**\n * Error thrown when a transaction fails validation.\n */\nexport class ValidationError extends MimicServerError {\n  override readonly _tag = \"ValidationError\";\n  readonly transactionId: string;\n\n  constructor(transactionId: string, message: string) {\n    super(`Transaction ${transactionId} validation failed: ${message}`);\n    this.name = \"ValidationError\";\n    this.transactionId = transactionId;\n  }\n}\n\n/**\n * Error thrown when an operation is invalid for the current schema.\n */\nexport class InvalidOperationError extends MimicServerError {\n  override readonly _tag = \"InvalidOperationError\";\n  readonly operationKind: string;\n  readonly path: string;\n\n  constructor(operationKind: string, path: string, message: string) {\n    super(`Invalid operation ${operationKind} at path \"${path}\": ${message}`);\n    this.name = \"InvalidOperationError\";\n    this.operationKind = operationKind;\n    this.path = path;\n  }\n}\n\n/**\n * Error thrown when an operation cannot be applied to the current state.\n */\nexport class StateValidationError extends MimicServerError {\n  override readonly _tag = \"StateValidationError\";\n  readonly transactionId: string;\n  override readonly cause?: Error;\n\n  constructor(transactionId: string, message: string, cause?: Error) {\n    super(`Transaction ${transactionId} cannot be applied to current state: ${message}`);\n    this.name = \"StateValidationError\";\n    this.transactionId = transactionId;\n    this.cause = cause;\n  }\n}\n\n/**\n * Error thrown when attempting to apply an empty transaction.\n */\nexport class EmptyTransactionError extends MimicServerError {\n  override readonly _tag = \"EmptyTransactionError\";\n  readonly transactionId: string;\n\n  constructor(transactionId: string) {\n    super(`Transaction ${transactionId} is empty and cannot be applied`);\n    this.name = \"EmptyTransactionError\";\n    this.transactionId = transactionId;\n  }\n}\n\n/**\n * Error thrown when a duplicate transaction is submitted.\n */\nexport class DuplicateTransactionError extends MimicServerError {\n  override readonly _tag = \"DuplicateTransactionError\";\n  readonly transactionId: string;\n\n  constructor(transactionId: string) {\n    super(`Transaction ${transactionId} has already been processed`);\n    this.name = \"DuplicateTransactionError\";\n    this.transactionId = transactionId;\n  }\n}\n"],"mappings":"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"}