@voidhash/mimic 0.0.1-alpha.7 → 0.0.1-alpha.8

package/dist/server/index.cjs

@@ -0,0 +1,191 @@
+const require_Document = require('../Document-ChuFrTk1.cjs');
+
+//#region src/server/ServerDocument.ts
+var ServerDocument_exports = /* @__PURE__ */ require_Document.__export({ make: () => make });
+/**
+* Creates a new ServerDocument for the given schema.
+*/
+const make = (options) => {
+	const { schema, initialState, initialVersion = 0, onBroadcast, onRejection, maxTransactionHistory = 1e3 } = options;
+	let _document = require_Document.make(schema, { initial: initialState });
+	let _version = initialVersion;
+	const _processedTransactions = /* @__PURE__ */ new Set();
+	const _transactionOrder = [];
+	/**
+	* Records a transaction as processed, maintaining the history limit.
+	*/
+	const recordTransaction = (transactionId) => {
+		_processedTransactions.add(transactionId);
+		_transactionOrder.push(transactionId);
+		while (_transactionOrder.length > maxTransactionHistory) {
+			const oldest = _transactionOrder.shift();
+			if (oldest) _processedTransactions.delete(oldest);
+		}
+	};
+	/**
+	* Validates that the transaction can be applied to the current state.
+	* Creates a temporary document and attempts to apply the operations.
+	*/
+	const validateTransaction = (transaction) => {
+		if (require_Document.isEmpty(transaction)) return {
+			valid: false,
+			reason: "Transaction is empty"
+		};
+		if (_processedTransactions.has(transaction.id)) return {
+			valid: false,
+			reason: "Transaction has already been processed"
+		};
+		const currentState = _document.get();
+		const tempDoc = require_Document.make(schema, { initial: currentState });
+		try {
+			tempDoc.apply(transaction.ops);
+			return { valid: true };
+		} catch (error) {
+			return {
+				valid: false,
+				reason: error instanceof Error ? error.message : String(error)
+			};
+		}
+	};
+	return {
+		schema,
+		get: () => {
+			return _document.get();
+		},
+		getVersion: () => {
+			return _version;
+		},
+		submit: (transaction) => {
+			const validation = validateTransaction(transaction);
+			if (!validation.valid) {
+				onRejection === null || onRejection === void 0 || onRejection(transaction.id, validation.reason);
+				return {
+					success: false,
+					reason: validation.reason
+				};
+			}
+			try {
+				_document.apply(transaction.ops);
+			} catch (error) {
+				const reason = error instanceof Error ? error.message : String(error);
+				onRejection === null || onRejection === void 0 || onRejection(transaction.id, reason);
+				return {
+					success: false,
+					reason
+				};
+			}
+			_version += 1;
+			recordTransaction(transaction.id);
+			onBroadcast({
+				type: "transaction",
+				transaction,
+				version: _version
+			});
+			return {
+				success: true,
+				version: _version
+			};
+		},
+		getSnapshot: () => {
+			return {
+				type: "snapshot",
+				state: _document.get(),
+				version: _version
+			};
+		},
+		hasProcessed: (transactionId) => {
+			return _processedTransactions.has(transactionId);
+		}
+	};
+};
+
+//#endregion
+//#region src/server/errors.ts
+/**
+* Base error class for all mimic-server errors.
+*/
+var MimicServerError = class extends Error {
+	constructor(message) {
+		super(message);
+		require_Document._defineProperty(this, "_tag", "MimicServerError");
+		this.name = "MimicServerError";
+	}
+};
+/**
+* Error thrown when a transaction fails validation.
+*/
+var ValidationError = class extends MimicServerError {
+	constructor(transactionId, message) {
+		super(`Transaction ${transactionId} validation failed: ${message}`);
+		require_Document._defineProperty(this, "_tag", "ValidationError");
+		require_Document._defineProperty(this, "transactionId", void 0);
+		this.name = "ValidationError";
+		this.transactionId = transactionId;
+	}
+};
+/**
+* Error thrown when an operation is invalid for the current schema.
+*/
+var InvalidOperationError = class extends MimicServerError {
+	constructor(operationKind, path, message) {
+		super(`Invalid operation ${operationKind} at path "${path}": ${message}`);
+		require_Document._defineProperty(this, "_tag", "InvalidOperationError");
+		require_Document._defineProperty(this, "operationKind", void 0);
+		require_Document._defineProperty(this, "path", void 0);
+		this.name = "InvalidOperationError";
+		this.operationKind = operationKind;
+		this.path = path;
+	}
+};
+/**
+* Error thrown when an operation cannot be applied to the current state.
+*/
+var StateValidationError = class extends MimicServerError {
+	constructor(transactionId, message, cause) {
+		super(`Transaction ${transactionId} cannot be applied to current state: ${message}`);
+		require_Document._defineProperty(this, "_tag", "StateValidationError");
+		require_Document._defineProperty(this, "transactionId", void 0);
+		require_Document._defineProperty(this, "cause", void 0);
+		this.name = "StateValidationError";
+		this.transactionId = transactionId;
+		this.cause = cause;
+	}
+};
+/**
+* Error thrown when attempting to apply an empty transaction.
+*/
+var EmptyTransactionError = class extends MimicServerError {
+	constructor(transactionId) {
+		super(`Transaction ${transactionId} is empty and cannot be applied`);
+		require_Document._defineProperty(this, "_tag", "EmptyTransactionError");
+		require_Document._defineProperty(this, "transactionId", void 0);
+		this.name = "EmptyTransactionError";
+		this.transactionId = transactionId;
+	}
+};
+/**
+* Error thrown when a duplicate transaction is submitted.
+*/
+var DuplicateTransactionError = class extends MimicServerError {
+	constructor(transactionId) {
+		super(`Transaction ${transactionId} has already been processed`);
+		require_Document._defineProperty(this, "_tag", "DuplicateTransactionError");
+		require_Document._defineProperty(this, "transactionId", void 0);
+		this.name = "DuplicateTransactionError";
+		this.transactionId = transactionId;
+	}
+};
+
+//#endregion
+exports.DuplicateTransactionError = DuplicateTransactionError;
+exports.EmptyTransactionError = EmptyTransactionError;
+exports.InvalidOperationError = InvalidOperationError;
+exports.MimicServerError = MimicServerError;
+Object.defineProperty(exports, 'ServerDocument', {
+  enumerable: true,
+  get: function () {
+    return ServerDocument_exports;
+  }
+});
+exports.StateValidationError = StateValidationError;
+exports.ValidationError = ValidationError;

package/dist/server/index.d.cts

@@ -0,0 +1,148 @@
+import { a as InferState, h as __export, n as AnyPrimitive, u as Transaction } from "../Primitive-BK7kfHJZ.cjs";
+
+//#region src/server/ServerDocument.d.ts
+declare namespace ServerDocument_d_exports {
+  export { ErrorMessage, ServerDocument, ServerDocumentOptions, ServerMessage, SnapshotMessage, SubmitResult, TransactionMessage, make };
+}
+/**
+ * Message sent when broadcasting a committed transaction.
+ */
+interface TransactionMessage {
+  readonly type: "transaction";
+  readonly transaction: Transaction;
+  /** Server-assigned version number for ordering */
+  readonly version: number;
+}
+/**
+ * Message sent when a transaction is rejected.
+ */
+interface ErrorMessage {
+  readonly type: "error";
+  readonly transactionId: string;
+  readonly reason: string;
+}
+/**
+ * Message sent as a full state snapshot.
+ */
+interface SnapshotMessage {
+  readonly type: "snapshot";
+  readonly state: unknown;
+  readonly version: number;
+}
+/**
+ * Union of all server messages that can be broadcast.
+ */
+type ServerMessage = TransactionMessage | ErrorMessage | SnapshotMessage;
+/**
+ * Result of submitting a transaction to the server.
+ */
+type SubmitResult = {
+  readonly success: true;
+  readonly version: number;
+} | {
+  readonly success: false;
+  readonly reason: string;
+};
+/**
+ * Options for creating a ServerDocument.
+ */
+interface ServerDocumentOptions<TSchema extends AnyPrimitive> {
+  /** The schema defining the document structure */
+  readonly schema: TSchema;
+  /** Initial state (optional, will use schema defaults if not provided) */
+  readonly initialState?: InferState<TSchema>;
+  /** Initial version number (optional, defaults to 0) */
+  readonly initialVersion?: number;
+  /** Called when a transaction is successfully applied and should be broadcast */
+  readonly onBroadcast: (message: TransactionMessage) => void;
+  /** Called when a transaction is rejected (optional, for logging/metrics) */
+  readonly onRejection?: (transactionId: string, reason: string) => void;
+  /** Maximum number of processed transaction IDs to track for deduplication */
+  readonly maxTransactionHistory?: number;
+}
+/**
+ * A ServerDocument maintains the authoritative state and processes client transactions.
+ */
+interface ServerDocument<TSchema extends AnyPrimitive> {
+  /** The schema defining this document's structure */
+  readonly schema: TSchema;
+  /** Returns the current authoritative state */
+  get(): InferState<TSchema> | undefined;
+  /** Returns the current version number */
+  getVersion(): number;
+  /**
+   * Submits a transaction for processing.
+   * Validates and applies the transaction if valid, or rejects it with a reason.
+   * @param transaction - The transaction to process
+   * @returns SubmitResult indicating success with version or failure with reason
+   */
+  submit(transaction: Transaction): SubmitResult;
+  /**
+   * Returns a snapshot of the current state and version.
+   * Used to initialize new clients or resync after drift.
+   */
+  getSnapshot(): SnapshotMessage;
+  /**
+   * Checks if a transaction has already been processed.
+   * @param transactionId - The transaction ID to check
+   */
+  hasProcessed(transactionId: string): boolean;
+}
+/**
+ * Creates a new ServerDocument for the given schema.
+ */
+declare const make: <TSchema extends AnyPrimitive>(options: ServerDocumentOptions<TSchema>) => ServerDocument<TSchema>;
+//#endregion
+//#region src/server/errors.d.ts
+/**
+ * Base error class for all mimic-server errors.
+ */
+declare class MimicServerError extends Error {
+  readonly _tag: string;
+  constructor(message: string);
+}
+/**
+ * Error thrown when a transaction fails validation.
+ */
+declare class ValidationError extends MimicServerError {
+  readonly _tag = "ValidationError";
+  readonly transactionId: string;
+  constructor(transactionId: string, message: string);
+}
+/**
+ * Error thrown when an operation is invalid for the current schema.
+ */
+declare class InvalidOperationError extends MimicServerError {
+  readonly _tag = "InvalidOperationError";
+  readonly operationKind: string;
+  readonly path: string;
+  constructor(operationKind: string, path: string, message: string);
+}
+/**
+ * Error thrown when an operation cannot be applied to the current state.
+ */
+declare class StateValidationError extends MimicServerError {
+  readonly _tag = "StateValidationError";
+  readonly transactionId: string;
+  readonly cause?: Error;
+  constructor(transactionId: string, message: string, cause?: Error);
+}
+/**
+ * Error thrown when attempting to apply an empty transaction.
+ */
+declare class EmptyTransactionError extends MimicServerError {
+  readonly _tag = "EmptyTransactionError";
+  readonly transactionId: string;
+  constructor(transactionId: string);
+}
+/**
+ * Error thrown when a duplicate transaction is submitted.
+ */
+declare class DuplicateTransactionError extends MimicServerError {
+  readonly _tag = "DuplicateTransactionError";
+  readonly transactionId: string;
+  constructor(transactionId: string);
+}
+//#endregion
+export { DuplicateTransactionError, EmptyTransactionError, type ErrorMessage, InvalidOperationError, MimicServerError, ServerDocument_d_exports as ServerDocument, type ServerDocumentOptions, type ServerMessage, type SnapshotMessage, StateValidationError, type SubmitResult, type TransactionMessage, ValidationError };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"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,EAAA,MAAuB;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

@@ -0,0 +1,148 @@
+import { a as InferState, n as AnyPrimitive, u as Transaction } from "../Primitive-D1kdB6za.mjs";
+
+//#region src/server/ServerDocument.d.ts
+declare namespace ServerDocument_d_exports {
+  export { ErrorMessage, ServerDocument, ServerDocumentOptions, ServerMessage, SnapshotMessage, SubmitResult, TransactionMessage, make };
+}
+/**
+ * Message sent when broadcasting a committed transaction.
+ */
+interface TransactionMessage {
+  readonly type: "transaction";
+  readonly transaction: Transaction;
+  /** Server-assigned version number for ordering */
+  readonly version: number;
+}
+/**
+ * Message sent when a transaction is rejected.
+ */
+interface ErrorMessage {
+  readonly type: "error";
+  readonly transactionId: string;
+  readonly reason: string;
+}
+/**
+ * Message sent as a full state snapshot.
+ */
+interface SnapshotMessage {
+  readonly type: "snapshot";
+  readonly state: unknown;
+  readonly version: number;
+}
+/**
+ * Union of all server messages that can be broadcast.
+ */
+type ServerMessage = TransactionMessage | ErrorMessage | SnapshotMessage;
+/**
+ * Result of submitting a transaction to the server.
+ */
+type SubmitResult = {
+  readonly success: true;
+  readonly version: number;
+} | {
+  readonly success: false;
+  readonly reason: string;
+};
+/**
+ * Options for creating a ServerDocument.
+ */
+interface ServerDocumentOptions<TSchema extends AnyPrimitive> {
+  /** The schema defining the document structure */
+  readonly schema: TSchema;
+  /** Initial state (optional, will use schema defaults if not provided) */
+  readonly initialState?: InferState<TSchema>;
+  /** Initial version number (optional, defaults to 0) */
+  readonly initialVersion?: number;
+  /** Called when a transaction is successfully applied and should be broadcast */
+  readonly onBroadcast: (message: TransactionMessage) => void;
+  /** Called when a transaction is rejected (optional, for logging/metrics) */
+  readonly onRejection?: (transactionId: string, reason: string) => void;
+  /** Maximum number of processed transaction IDs to track for deduplication */
+  readonly maxTransactionHistory?: number;
+}
+/**
+ * A ServerDocument maintains the authoritative state and processes client transactions.
+ */
+interface ServerDocument<TSchema extends AnyPrimitive> {
+  /** The schema defining this document's structure */
+  readonly schema: TSchema;
+  /** Returns the current authoritative state */
+  get(): InferState<TSchema> | undefined;
+  /** Returns the current version number */
+  getVersion(): number;
+  /**
+   * Submits a transaction for processing.
+   * Validates and applies the transaction if valid, or rejects it with a reason.
+   * @param transaction - The transaction to process
+   * @returns SubmitResult indicating success with version or failure with reason
+   */
+  submit(transaction: Transaction): SubmitResult;
+  /**
+   * Returns a snapshot of the current state and version.
+   * Used to initialize new clients or resync after drift.
+   */
+  getSnapshot(): SnapshotMessage;
+  /**
+   * Checks if a transaction has already been processed.
+   * @param transactionId - The transaction ID to check
+   */
+  hasProcessed(transactionId: string): boolean;
+}
+/**
+ * Creates a new ServerDocument for the given schema.
+ */
+declare const make: <TSchema extends AnyPrimitive>(options: ServerDocumentOptions<TSchema>) => ServerDocument<TSchema>;
+//#endregion
+//#region src/server/errors.d.ts
+/**
+ * Base error class for all mimic-server errors.
+ */
+declare class MimicServerError extends Error {
+  readonly _tag: string;
+  constructor(message: string);
+}
+/**
+ * Error thrown when a transaction fails validation.
+ */
+declare class ValidationError extends MimicServerError {
+  readonly _tag = "ValidationError";
+  readonly transactionId: string;
+  constructor(transactionId: string, message: string);
+}
+/**
+ * Error thrown when an operation is invalid for the current schema.
+ */
+declare class InvalidOperationError extends MimicServerError {
+  readonly _tag = "InvalidOperationError";
+  readonly operationKind: string;
+  readonly path: string;
+  constructor(operationKind: string, path: string, message: string);
+}
+/**
+ * Error thrown when an operation cannot be applied to the current state.
+ */
+declare class StateValidationError extends MimicServerError {
+  readonly _tag = "StateValidationError";
+  readonly transactionId: string;
+  readonly cause?: Error;
+  constructor(transactionId: string, message: string, cause?: Error);
+}
+/**
+ * Error thrown when attempting to apply an empty transaction.
+ */
+declare class EmptyTransactionError extends MimicServerError {
+  readonly _tag = "EmptyTransactionError";
+  readonly transactionId: string;
+  constructor(transactionId: string);
+}
+/**
+ * Error thrown when a duplicate transaction is submitted.
+ */
+declare class DuplicateTransactionError extends MimicServerError {
+  readonly _tag = "DuplicateTransactionError";
+  readonly transactionId: string;
+  constructor(transactionId: string);
+}
+//#endregion
+export { DuplicateTransactionError, EmptyTransactionError, type ErrorMessage, InvalidOperationError, MimicServerError, ServerDocument_d_exports as ServerDocument, type ServerDocumentOptions, type ServerMessage, type SnapshotMessage, StateValidationError, type SubmitResult, type TransactionMessage, ValidationError };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,182 @@
+import { t as __export } from "../chunk-CLMFDpHK.mjs";
+import { m as _defineProperty, n as make$1, o as isEmpty } from "../Document-CwiAFTIq.mjs";
+
+//#region src/server/ServerDocument.ts
+var ServerDocument_exports = /* @__PURE__ */ __export({ make: () => make });
+/**
+* Creates a new ServerDocument for the given schema.
+*/
+const make = (options) => {
+	const { schema, initialState, initialVersion = 0, onBroadcast, onRejection, maxTransactionHistory = 1e3 } = options;
+	let _document = make$1(schema, { initial: initialState });
+	let _version = initialVersion;
+	const _processedTransactions = /* @__PURE__ */ new Set();
+	const _transactionOrder = [];
+	/**
+	* Records a transaction as processed, maintaining the history limit.
+	*/
+	const recordTransaction = (transactionId) => {
+		_processedTransactions.add(transactionId);
+		_transactionOrder.push(transactionId);
+		while (_transactionOrder.length > maxTransactionHistory) {
+			const oldest = _transactionOrder.shift();
+			if (oldest) _processedTransactions.delete(oldest);
+		}
+	};
+	/**
+	* Validates that the transaction can be applied to the current state.
+	* Creates a temporary document and attempts to apply the operations.
+	*/
+	const validateTransaction = (transaction) => {
+		if (isEmpty(transaction)) return {
+			valid: false,
+			reason: "Transaction is empty"
+		};
+		if (_processedTransactions.has(transaction.id)) return {
+			valid: false,
+			reason: "Transaction has already been processed"
+		};
+		const currentState = _document.get();
+		const tempDoc = make$1(schema, { initial: currentState });
+		try {
+			tempDoc.apply(transaction.ops);
+			return { valid: true };
+		} catch (error) {
+			return {
+				valid: false,
+				reason: error instanceof Error ? error.message : String(error)
+			};
+		}
+	};
+	return {
+		schema,
+		get: () => {
+			return _document.get();
+		},
+		getVersion: () => {
+			return _version;
+		},
+		submit: (transaction) => {
+			const validation = validateTransaction(transaction);
+			if (!validation.valid) {
+				onRejection === null || onRejection === void 0 || onRejection(transaction.id, validation.reason);
+				return {
+					success: false,
+					reason: validation.reason
+				};
+			}
+			try {
+				_document.apply(transaction.ops);
+			} catch (error) {
+				const reason = error instanceof Error ? error.message : String(error);
+				onRejection === null || onRejection === void 0 || onRejection(transaction.id, reason);
+				return {
+					success: false,
+					reason
+				};
+			}
+			_version += 1;
+			recordTransaction(transaction.id);
+			onBroadcast({
+				type: "transaction",
+				transaction,
+				version: _version
+			});
+			return {
+				success: true,
+				version: _version
+			};
+		},
+		getSnapshot: () => {
+			return {
+				type: "snapshot",
+				state: _document.get(),
+				version: _version
+			};
+		},
+		hasProcessed: (transactionId) => {
+			return _processedTransactions.has(transactionId);
+		}
+	};
+};
+
+//#endregion
+//#region src/server/errors.ts
+/**
+* Base error class for all mimic-server errors.
+*/
+var MimicServerError = class extends Error {
+	constructor(message) {
+		super(message);
+		_defineProperty(this, "_tag", "MimicServerError");
+		this.name = "MimicServerError";
+	}
+};
+/**
+* Error thrown when a transaction fails validation.
+*/
+var ValidationError = class extends MimicServerError {
+	constructor(transactionId, message) {
+		super(`Transaction ${transactionId} validation failed: ${message}`);
+		_defineProperty(this, "_tag", "ValidationError");
+		_defineProperty(this, "transactionId", void 0);
+		this.name = "ValidationError";
+		this.transactionId = transactionId;
+	}
+};
+/**
+* Error thrown when an operation is invalid for the current schema.
+*/
+var InvalidOperationError = class extends MimicServerError {
+	constructor(operationKind, path, message) {
+		super(`Invalid operation ${operationKind} at path "${path}": ${message}`);
+		_defineProperty(this, "_tag", "InvalidOperationError");
+		_defineProperty(this, "operationKind", void 0);
+		_defineProperty(this, "path", void 0);
+		this.name = "InvalidOperationError";
+		this.operationKind = operationKind;
+		this.path = path;
+	}
+};
+/**
+* Error thrown when an operation cannot be applied to the current state.
+*/
+var StateValidationError = class extends MimicServerError {
+	constructor(transactionId, message, cause) {
+		super(`Transaction ${transactionId} cannot be applied to current state: ${message}`);
+		_defineProperty(this, "_tag", "StateValidationError");
+		_defineProperty(this, "transactionId", void 0);
+		_defineProperty(this, "cause", void 0);
+		this.name = "StateValidationError";
+		this.transactionId = transactionId;
+		this.cause = cause;
+	}
+};
+/**
+* Error thrown when attempting to apply an empty transaction.
+*/
+var EmptyTransactionError = class extends MimicServerError {
+	constructor(transactionId) {
+		super(`Transaction ${transactionId} is empty and cannot be applied`);
+		_defineProperty(this, "_tag", "EmptyTransactionError");
+		_defineProperty(this, "transactionId", void 0);
+		this.name = "EmptyTransactionError";
+		this.transactionId = transactionId;
+	}
+};
+/**
+* Error thrown when a duplicate transaction is submitted.
+*/
+var DuplicateTransactionError = class extends MimicServerError {
+	constructor(transactionId) {
+		super(`Transaction ${transactionId} has already been processed`);
+		_defineProperty(this, "_tag", "DuplicateTransactionError");
+		_defineProperty(this, "transactionId", void 0);
+		this.name = "DuplicateTransactionError";
+		this.transactionId = transactionId;
+	}
+};
+
+//#endregion
+export { DuplicateTransactionError, EmptyTransactionError, InvalidOperationError, MimicServerError, ServerDocument_exports as ServerDocument, StateValidationError, ValidationError };
+//# sourceMappingURL=index.mjs.map