isomorphic-jj 1.4.3 → 1.7.0

package/src/utils/errors.js

@@ -1,14 +1,14 @@
 /**
  * JJError - Custom error class for isomorphic-jj
- * 
+ *
  * Provides structured errors with error codes, context, and user-actionable suggestions.
  */
 export class JJError extends Error {
   /**
    * @param {string} code - Error code (e.g., 'CHANGE_NOT_FOUND')
    * @param {string} message - Human-readable error message
-   * @param {Object} [context={}] - Additional error context
-   * @param {string} [context.suggestion] - User-actionable suggestion
+   * @param {Object.<string, any>} [context] - Additional error context. May
+   *   include a `suggestion` string plus any other diagnostic fields.
    */
   constructor(code, message, context = {}) {
     super(message);

package/src/utils/id-generation.js

@@ -1,15 +1,15 @@
 /**
  * ID Generation utilities for isomorphic-jj
- * 
+ *
  * Generates stable change IDs and operation IDs using cryptographically secure random values.
  */
 
 /**
  * Generate a stable change ID
- * 
+ *
  * Uses 128-bit cryptographically random value encoded as 32-character hex string.
  * Collision probability is negligible (2^128 space).
- * 
+ *
  * @returns {string} 32-character lowercase hex string
  */
 export function generateChangeId() {
@@ -22,7 +22,7 @@ export function generateChangeId() {
  *
  * Uses SHA-256 hash of operation content for integrity verification.
  *
- * @param {Object} operation - Operation data
+ * @param {Object.<string, any>} operation - Operation data
  * @returns {Promise<string>} 64-character lowercase hex string (SHA-256)
  */
 export async function generateOperationId(operation) {

package/src/utils/validation.js

@@ -1,6 +1,6 @@
 /**
  * Validation utilities for isomorphic-jj
- * 
+ *
  * Provides validation functions for change IDs, paths, bookmark names, etc.
  */
 
@@ -8,7 +8,7 @@ import { JJError } from './errors.js';
 
 /**
  * Validate a change ID
- * 
+ *
  * @param {string} changeId - Change ID to validate
  * @throws {JJError} If change ID is invalid
  */
@@ -84,7 +84,7 @@ export function validatePath(path) {
 
 /**
  * Validate a bookmark name (follows Git ref name rules)
- * 
+ *
  * @param {string} name - Bookmark name to validate
  * @throws {JJError} If bookmark name is invalid
  */
@@ -115,13 +115,9 @@ export function validateBookmarkName(name) {
   }
 
   if (name.startsWith('.') || name.endsWith('.')) {
-    throw new JJError(
-      'INVALID_BOOKMARK_NAME',
-      'Bookmark name cannot start or end with "."',
-      {
-        name,
-      }
-    );
+    throw new JJError('INVALID_BOOKMARK_NAME', 'Bookmark name cannot start or end with "."', {
+      name,
+    });
   }
 
   if (name.endsWith('.lock')) {