@mnaoumov/obsidian-lib 10.3.0 → 10.4.0

package/dist/lib/cjs/bulk-operation-progress.d.cts

@@ -0,0 +1,33 @@
+/// <reference path="./library-references.d.cts" />
+/**
+ * @file
+ *
+ * A realm-wide progress signal for bulk operations.
+ *
+ * A bulk operation wrapped in git commits holds a lease lock whose heartbeat must be refreshed by the operation's
+ * own progress, never by a free-running timer, so a hung operation goes stale like a crashed one. Rather than
+ * threading a callback through every plugin's call chain, the wrapper subscribes here while it runs, and
+ * {@link loop} reports after every item it processes. Code that drives a bulk operation without `loop()` calls
+ * {@link reportBulkOperationProgress} itself.
+ *
+ * The listener set lives in the shared-state bag under a versioned key, so a `loop()` bundled by one plugin's copy
+ * of this library reaches a listener registered by another's. Its shape is a cross-copy wire format: a `Set` of
+ * plain functions, read structurally.
+ */
+/**
+ * A listener notified whenever a bulk operation makes progress.
+ */
+export type BulkOperationProgressListener = () => void;
+/**
+ * Subscribes to bulk-operation progress.
+ *
+ * @param listener - The listener to notify on every progress report.
+ * @returns A function that unsubscribes the listener.
+ */
+export declare function registerBulkOperationProgressListener(listener: BulkOperationProgressListener): () => void;
+/**
+ * Reports that a bulk operation has made progress, such as finishing one item.
+ *
+ * A listener that throws is skipped, so a progress report can never fail the operation reporting it.
+ */
+export declare function reportBulkOperationProgress(): void;

package/dist/lib/cjs/bulk-operation.cjs

@@ -0,0 +1,220 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+(function () {
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return "/";
+    },
+    env: {},
+    platform: "android"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+  if (existingProcess.versions?.node) {
+    return;
+  }
+  const existingProcessRecord = existingProcess;
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+  existingProcessRecord["browser"] = true;
+}
+
+ensureBrowserProcess();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+  require = Object.assign(
+    (id) => requirePatched(id),
+    originalRequire,
+    {
+      __isPatched: true
+    }
+  );
+  function extractDefault($module) {
+    return $module && $module.__esModule && "default" in $module ? $module.default : $module;
+  }
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/autocomplete",
+    "@codemirror/collab",
+    "@codemirror/commands",
+    "@codemirror/language",
+    "@codemirror/lint",
+    "@codemirror/search",
+    "@codemirror/state",
+    "@codemirror/text",
+    "@codemirror/view",
+    "@lezer/common",
+    "@lezer/highlight",
+    "@lezer/lr",
+    "obsidian"
+  ]);
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/closebrackets",
+    "@codemirror/comment",
+    "@codemirror/fold",
+    "@codemirror/gutter",
+    "@codemirror/highlight",
+    "@codemirror/history",
+    "@codemirror/matchbrackets",
+    "@codemirror/panel",
+    "@codemirror/rangeset",
+    "@codemirror/rectangular-selection",
+    "@codemirror/stream-parser",
+    "@codemirror/tooltip"
+  ]);
+  function requirePatched(id) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
+      return originalRequire?.(id);
+    }
+    const app = globalThis.app;
+    if (app?.isMobile) {
+      if (id === "process" || id === "node:process") {
+        console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Fake process object is returned instead.`);
+        return process;
+      }
+    } else {
+      const $module = originalRequire?.(id);
+      if ($module) {
+        return extractDefault($module);
+      }
+    }
+    console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Empty object is returned instead.`);
+    return {};
+  }
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var bulk_operation_exports = {};
+__export(bulk_operation_exports, {
+  BULK_OPERATION_LOCK_FILE_NAME: () => BULK_OPERATION_LOCK_FILE_NAME,
+  BULK_OPERATION_LOCK_STALE_AFTER_IN_MILLISECONDS: () => BULK_OPERATION_LOCK_STALE_AFTER_IN_MILLISECONDS,
+  OPERATION_TRAILER_KEY: () => OPERATION_TRAILER_KEY,
+  PLUGIN_TRAILER_KEY: () => PLUGIN_TRAILER_KEY,
+  buildBeforeOperationCommitSubject: () => buildBeforeOperationCommitSubject,
+  buildOperationCommitMessage: () => buildOperationCommitMessage,
+  formatOperationId: () => formatOperationId,
+  getNextOperationId: () => getNextOperationId,
+  isBulkOperationLock: () => isBulkOperationLock,
+  isBulkOperationLockStale: () => isBulkOperationLockStale,
+  parseBulkOperationCommit: () => parseBulkOperationCommit,
+  parseOperationNumber: () => parseOperationNumber
+});
+module.exports = __toCommonJS(bulk_operation_exports);
+var import_reg_exp = require('@mnaoumov/typescript-lib/reg-exp');
+var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
+const BULK_OPERATION_LOCK_FILE_NAME = "obsidian-bulk-operation.json";
+const BULK_OPERATION_LOCK_STALE_AFTER_IN_MILLISECONDS = 12e4;
+const OPERATION_TRAILER_KEY = "Obsidian-Bulk-Operation";
+const PLUGIN_TRAILER_KEY = "Obsidian-Plugin";
+const OPERATION_ID_PREFIX = "OP";
+const isBulkOperationLockImpl = (0, import_type_guards.objectTypeGuard)({
+  heartbeatAt: import_type_guards.isNumber,
+  host: import_type_guards.isString,
+  operationId: import_type_guards.isString,
+  pluginId: import_type_guards.isString,
+  processId: import_type_guards.isNumber,
+  processStartedAt: import_type_guards.isNumber,
+  startedAt: import_type_guards.isNumber
+});
+function buildBeforeOperationCommitSubject(operationId) {
+  return `chore: before ${operationId}`;
+}
+function buildOperationCommitMessage(params) {
+  const subject = params.isInterrupted ? `${params.operationId} interrupted` : `${params.operationId}: ${normalizeSummary(params.summary ?? "")}`;
+  const body = `Timestamp: ${params.timestamp.toISOString()}
+Changed-Files: ${String(params.changedFileCount)}
+${PLUGIN_TRAILER_KEY}: ${params.pluginId}
+${OPERATION_TRAILER_KEY}: ${params.operationId}`;
+  return { body, subject };
+}
+function formatOperationId(operationNumber) {
+  return `${OPERATION_ID_PREFIX}${String(operationNumber)}`;
+}
+function getNextOperationId(subjects) {
+  let maxOperationNumber = 0;
+  for (const subject of subjects) {
+    const operationNumber = parseOperationNumber(subject);
+    if (operationNumber !== null && operationNumber > maxOperationNumber) {
+      maxOperationNumber = operationNumber;
+    }
+  }
+  return formatOperationId(maxOperationNumber + 1);
+}
+function isBulkOperationLock(value) {
+  return isBulkOperationLockImpl(value);
+}
+function isBulkOperationLockStale(lock, context) {
+  if (context.now - lock.heartbeatAt >= BULK_OPERATION_LOCK_STALE_AFTER_IN_MILLISECONDS) {
+    return true;
+  }
+  if (lock.host !== context.host) {
+    return false;
+  }
+  const wasHeartbeatBeforeBoot = context.bootedAt !== null && lock.heartbeatAt < context.bootedAt;
+  return wasHeartbeatBeforeBoot || context.isProcessAlive(lock.processId) === false;
+}
+function parseBulkOperationCommit(params) {
+  const match = /^OP(?<operationNumber>\d+)(?<kind>:| interrupted$)/.exec(params.subject);
+  if (!match) {
+    return null;
+  }
+  return {
+    date: params.date,
+    isInterrupted: (0, import_reg_exp.getMandatoryNamedGroup)(match, "kind") !== ":",
+    operationId: formatOperationId(Number((0, import_reg_exp.getMandatoryNamedGroup)(match, "operationNumber"))),
+    sha: params.sha,
+    subject: params.subject
+  };
+}
+function parseOperationNumber(subject) {
+  const match = /^(?:chore: before )?OP(?<operationNumber>\d+)(?::| interrupted$|$)/.exec(subject);
+  return match ? Number((0, import_reg_exp.getMandatoryNamedGroup)(match, "operationNumber")) : null;
+}
+function normalizeSummary(summary) {
+  const normalized = summary.replaceAll(/\s+/g, " ").trim();
+  return normalized || "bulk operation";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BULK_OPERATION_LOCK_FILE_NAME,
+  BULK_OPERATION_LOCK_STALE_AFTER_IN_MILLISECONDS,
+  OPERATION_TRAILER_KEY,
+  PLUGIN_TRAILER_KEY,
+  buildBeforeOperationCommitSubject,
+  buildOperationCommitMessage,
+  formatOperationId,
+  getNextOperationId,
+  isBulkOperationLock,
+  isBulkOperationLockStale,
+  parseBulkOperationCommit,
+  parseOperationNumber
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9idWxrLW9wZXJhdGlvbi50cyJdLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBmaWxlXG4gKlxuICogVGhlIHBsYXRmb3JtLW5ldXRyYWwgaGFsZiBvZiBidWxrLW9wZXJhdGlvbiBnaXQgY29tbWl0czogdGhlIGxlYXNlLWxvY2sgcmVjb3JkLCB0aGUgYE9QPG4+YCBpZHMgYW5kIHRoZSBjb21taXRcbiAqIG1lc3NhZ2VzIHRoYXQgY2FycnkgdGhlbS5cbiAqXG4gKiBBIGJ1bGsgb3BlcmF0aW9uIHdyYXBwZWQgYnkgYEJ1bGtPcGVyYXRpb25Db21taXRDb21wb25lbnRgIGxhbmRzIGluIHRoZSB2YXVsdCdzIGdpdCByZXBvIGFzIG9uZSBjb21taXQgd2hvc2VcbiAqIHN1YmplY3QgaXMgYE9QPG4+OiA8c3VtbWFyeT5gLCBwcmVjZWRlZCAod2hlbiB0aGUgdHJlZSB3YXMgZGlydHkpIGJ5IGEgYGNob3JlOiBiZWZvcmUgT1A8bj5gIGNvbW1pdCBob2xkaW5nXG4gKiB3aGF0ZXZlciB3YXMgcGVuZGluZywgc28gYGdpdCByZXZlcnRgIG9mIHRoZSBgT1A8bj5gIGNvbW1pdCB1bmRvZXMgZXhhY3RseSB0aGF0IG9wZXJhdGlvbi4gRXZlcnl0aGluZyBpbiB0aGlzXG4gKiBtb2R1bGUgaXMgcHVyZSwgc28gaXQgaXMgc2hhcmVkIGJ5IHRoZSBkZXNrdG9wIGdpdCBsYXllciBhbmQgYnkgdGhlIHNjaGVkdWxlZCBhdXRvY29tbWl0IHRoYXQgcmVhZHMgdGhlIHNhbWUgbG9jay5cbiAqXG4gKiBUaGUgbG9jayByZWNvcmQgYW5kIHRoZSBjb21taXQgbWVzc2FnZSB0cmFpbGVycyBhcmUgYSB3aXJlIGZvcm1hdCBiZXR3ZWVuIHBsdWdpbnMgYnVpbHQgb24gZGlmZmVyZW50IGNvcGllcyBvZlxuICogdGhpcyBsaWJyYXJ5IGFuZCB0aGUgdmF1bHQgYXV0b2NvbW1pdCBzY3JpcHQ6IGZpZWxkcyBtYXkgYmUgYWRkZWQsIG5ldmVyIHJlbmFtZWQgb3IgcmVpbnRlcnByZXRlZC5cbiAqL1xuXG5pbXBvcnQgeyBnZXRNYW5kYXRvcnlOYW1lZEdyb3VwIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3JlZy1leHAnO1xuaW1wb3J0IHtcbiAgaXNOdW1iZXIsXG4gIGlzU3RyaW5nLFxuICBvYmplY3RUeXBlR3VhcmRcbn0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGUtZ3VhcmRzJztcblxuLyoqXG4gKiBUaGUgbmFtZSBvZiB0aGUgbGVhc2UtbG9jayBmaWxlLCBjcmVhdGVkIGluc2lkZSB0aGUgcmVwbydzIGdpdCBkaXJlY3Rvcnkgc28gaXQgaXMgbmV2ZXIgY29tbWl0dGVkIG9yXG4gKiBzeW5jZWQuXG4gKi9cbmV4cG9ydCBjb25zdCBCVUxLX09QRVJBVElPTl9MT0NLX0ZJTEVfTkFNRSA9ICdvYnNpZGlhbi1idWxrLW9wZXJhdGlvbi5qc29uJztcblxuLyoqXG4gKiBIb3cgbG9uZyBhIGxvY2sgbWF5IGdvIHdpdGhvdXQgYSBoZWFydGJlYXQgYmVmb3JlIGl0IGNvdW50cyBhcyBzdGFsZS5cbiAqXG4gKiBJdCBlcnJzIGxvbmcgb24gcHVycG9zZTogaG9sZGluZyBhIGRlYWQgbG9jayB0b28gbG9uZyBvbmx5IG1ha2VzIGFuIGF1dG9jb21taXQgc2tpcCBhIHRpY2ssIHdoaWxlIGRlY2xhcmluZyBhXG4gKiBsaXZlIG9uZSBzdGFsZSBzcGxpdHMgaXRzIG9wZXJhdGlvbiBhY3Jvc3MgdHdvIGNvbW1pdHMuXG4gKi9cbmV4cG9ydCBjb25zdCBCVUxLX09QRVJBVElPTl9MT0NLX1NUQUxFX0FGVEVSX0lOX01JTExJU0VDT05EUyA9IDEyMF8wMDA7XG5cbi8qKlxuICogVGhlIHRyYWlsZXIga2V5IG5hbWluZyB0aGUgb3BlcmF0aW9uIGlkIGluIGEgYnVsay1vcGVyYXRpb24gY29tbWl0IGJvZHkuXG4gKi9cbmV4cG9ydCBjb25zdCBPUEVSQVRJT05fVFJBSUxFUl9LRVkgPSAnT2JzaWRpYW4tQnVsay1PcGVyYXRpb24nO1xuXG4vKipcbiAqIFRoZSB0cmFpbGVyIGtleSBuYW1pbmcgdGhlIHBsdWdpbiBpbiBhIGJ1bGstb3BlcmF0aW9uIGNvbW1pdCBib2R5LlxuICovXG5leHBvcnQgY29uc3QgUExVR0lOX1RSQUlMRVJfS0VZID0gJ09ic2lkaWFuLVBsdWdpbic7XG5cbmNvbnN0IE9QRVJBVElPTl9JRF9QUkVGSVggPSAnT1AnO1xuXG5jb25zdCBpc0J1bGtPcGVyYXRpb25Mb2NrSW1wbCA9IG9iamVjdFR5cGVHdWFyZDxCdWxrT3BlcmF0aW9uTG9jaz4oe1xuICBoZWFydGJlYXRBdDogaXNOdW1iZXIsXG4gIGhvc3Q6IGlzU3RyaW5nLFxuICBvcGVyYXRpb25JZDogaXNTdHJpbmcsXG4gIHBsdWdpbklkOiBpc1N0cmluZyxcbiAgcHJvY2Vzc0lkOiBpc051bWJlcixcbiAgcHJvY2Vzc1N0YXJ0ZWRBdDogaXNOdW1iZXIsXG4gIHN0YXJ0ZWRBdDogaXNOdW1iZXJcbn0pO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayBidWlsZE9wZXJhdGlvbkNvbW1pdE1lc3NhZ2V9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEJ1aWxkT3BlcmF0aW9uQ29tbWl0TWVzc2FnZVBhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgbnVtYmVyIG9mIGZpbGVzIHRoZSBjb21taXQgY2hhbmdlcy5cbiAgICovXG4gIHJlYWRvbmx5IGNoYW5nZWRGaWxlQ291bnQ6IG51bWJlcjtcblxuICAvKipcbiAgICogV2hldGhlciB0aGUgb3BlcmF0aW9uIHdhcyBpbnRlcnJ1cHRlZC5cbiAgICovXG4gIHJlYWRvbmx5IGlzSW50ZXJydXB0ZWQ/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBUaGUgb3BlcmF0aW9uIGlkLCBzdWNoIGFzIGBPUDEyYC5cbiAgICovXG4gIHJlYWRvbmx5IG9wZXJhdGlvbklkOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBpZCBvZiB0aGUgcGx1Z2luIHRoYXQgcmFuIHRoZSBvcGVyYXRpb24uXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBBIG9uZS1saW5lIGRlc2NyaXB0aW9uIG9mIHRoZSBvcGVyYXRpb24uIElnbm9yZWQgZm9yIGFuIGludGVycnVwdGVkIG9wZXJhdGlvbi5cbiAgICovXG4gIHJlYWRvbmx5IHN1bW1hcnk/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFdoZW4gdGhlIG9wZXJhdGlvbiByYW4uXG4gICAqL1xuICByZWFkb25seSB0aW1lc3RhbXA6IERhdGU7XG59XG5cbi8qKlxuICogQSBidWxrLW9wZXJhdGlvbiBjb21taXQgZm91bmQgaW4gdGhlIHJlcG8gaGlzdG9yeS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBCdWxrT3BlcmF0aW9uQ29tbWl0IHtcbiAgLyoqXG4gICAqIFRoZSBjb21taXQgZGF0ZSwgYXMgYW4gSVNPIDg2MDEgc3RyaW5nLlxuICAgKi9cbiAgcmVhZG9ubHkgZGF0ZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRoZSBjb21taXQgcmVjb3JkcyBhbiBpbnRlcnJ1cHRlZCBvcGVyYXRpb24gcmF0aGVyIHRoYW4gYSBjb21wbGV0ZWQgb25lLlxuICAgKi9cbiAgcmVhZG9ubHkgaXNJbnRlcnJ1cHRlZDogYm9vbGVhbjtcblxuICAvKipcbiAgICogVGhlIG9wZXJhdGlvbiBpZCwgc3VjaCBhcyBgT1AxMmAuXG4gICAqL1xuICByZWFkb25seSBvcGVyYXRpb25JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgZnVsbCBjb21taXQgaGFzaC5cbiAgICovXG4gIHJlYWRvbmx5IHNoYTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgY29tbWl0IHN1YmplY3QuXG4gICAqL1xuICByZWFkb25seSBzdWJqZWN0OiBzdHJpbmc7XG59XG5cbi8qKlxuICogVGhlIGxlYXNlLWxvY2sgcmVjb3JkIHN0b3JlZCBpbiBgLmdpdC9vYnNpZGlhbi1idWxrLW9wZXJhdGlvbi5qc29uYCB3aGlsZSBhIGJ1bGsgb3BlcmF0aW9uIHJ1bnMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQnVsa09wZXJhdGlvbkxvY2sge1xuICAvKipcbiAgICogV2hlbiB0aGUgbG9jayB3YXMgbGFzdCByZWZyZXNoZWQgYnkgdGhlIG9wZXJhdGlvbidzIHByb2dyZXNzLCBhcyBlcG9jaCBtaWxsaXNlY29uZHMuXG4gICAqL1xuICByZWFkb25seSBoZWFydGJlYXRBdDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUgaG9zdCBuYW1lIG9mIHRoZSBtYWNoaW5lIHJ1bm5pbmcgdGhlIG9wZXJhdGlvbi5cbiAgICovXG4gIHJlYWRvbmx5IGhvc3Q6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIG9wZXJhdGlvbiBpZCwgc3VjaCBhcyBgT1AxMmAuXG4gICAqL1xuICByZWFkb25seSBvcGVyYXRpb25JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgaWQgb2YgdGhlIHBsdWdpbiBydW5uaW5nIHRoZSBvcGVyYXRpb24uXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgaWQgb2YgdGhlIHByb2Nlc3MgcnVubmluZyBPYnNpZGlhbi4gT25seSBhIGZhc3QgcGF0aCBmb3IgYW4gYXBwIGNyYXNoOyBzdGFsZW5lc3MgbmV2ZXIgZGVwZW5kcyBvbiBpdC5cbiAgICovXG4gIHJlYWRvbmx5IHByb2Nlc3NJZDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBXaGVuIHRoZSBwcm9jZXNzIHJ1bm5pbmcgT2JzaWRpYW4gc3RhcnRlZCwgYXMgZXBvY2ggbWlsbGlzZWNvbmRzLCBzbyBhIHJlY3ljbGVkIHByb2Nlc3MgaWQgaXMgbm90IG1pc3Rha2VuIGZvclxuICAgKiB0aGUgb3JpZ2luYWwgb25lLlxuICAgKi9cbiAgcmVhZG9ubHkgcHJvY2Vzc1N0YXJ0ZWRBdDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBXaGVuIHRoZSBvcGVyYXRpb24gc3RhcnRlZCwgYXMgZXBvY2ggbWlsbGlzZWNvbmRzLlxuICAgKi9cbiAgcmVhZG9ubHkgc3RhcnRlZEF0OiBudW1iZXI7XG59XG5cbi8qKlxuICogVGhlIGZhY3RzIHtAbGluayBpc0J1bGtPcGVyYXRpb25Mb2NrU3RhbGV9IHdlaWdocyBiZXNpZGVzIHRoZSBoZWFydGJlYXQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQnVsa09wZXJhdGlvbkxvY2tTdGFsZW5lc3NDb250ZXh0IHtcbiAgLyoqXG4gICAqIFdoZW4gdGhpcyBtYWNoaW5lIGxhc3QgYm9vdGVkLCBhcyBlcG9jaCBtaWxsaXNlY29uZHMsIG9yIGBudWxsYCB3aGVuIHVua25vd24uXG4gICAqL1xuICByZWFkb25seSBib290ZWRBdDogbnVsbCB8IG51bWJlcjtcblxuICAvKipcbiAgICogVGhlIGhvc3QgbmFtZSBvZiB0aGlzIG1hY2hpbmUuXG4gICAqL1xuICByZWFkb25seSBob3N0OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdGhlIHByb2Nlc3MgcmVjb3JkZWQgaW4gdGhlIGxvY2sgaXMgc3RpbGwgcnVubmluZyBvbiB0aGlzIG1hY2hpbmUsIG9yIGBudWxsYCB3aGVuIGl0IGNhbm5vdCBiZSB0b2xkLlxuICAgKi9cbiAgcmVhZG9ubHkgaXNQcm9jZXNzQWxpdmU6IChwcm9jZXNzSWQ6IG51bWJlcikgPT4gYm9vbGVhbiB8IG51bGw7XG5cbiAgLyoqXG4gICAqIFRoZSBjdXJyZW50IHRpbWUsIGFzIGVwb2NoIG1pbGxpc2Vjb25kcy5cbiAgICovXG4gIHJlYWRvbmx5IG5vdzogbnVtYmVyO1xufVxuXG4vKipcbiAqIFRoZSBjb21taXQgbWVzc2FnZSBvZiBvbmUgYnVsay1vcGVyYXRpb24gY29tbWl0LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIE9wZXJhdGlvbkNvbW1pdE1lc3NhZ2Uge1xuICAvKipcbiAgICogVGhlIGNvbW1pdCBib2R5OiB0aGUgdGltZXN0YW1wLCB0aGUgcGx1Z2luIGFuZCB0aGUgY291bnRzLCBhcyBnaXQgdHJhaWxlcnMuXG4gICAqL1xuICByZWFkb25seSBib2R5OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBjb21taXQgc3ViamVjdC5cbiAgICovXG4gIHJlYWRvbmx5IHN1YmplY3Q6IHN0cmluZztcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgcGFyc2VCdWxrT3BlcmF0aW9uQ29tbWl0fS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQYXJzZUJ1bGtPcGVyYXRpb25Db21taXRQYXJhbXMge1xuICAvKipcbiAgICogVGhlIGNvbW1pdCBkYXRlLCBhcyBhbiBJU08gODYwMSBzdHJpbmcuXG4gICAqL1xuICByZWFkb25seSBkYXRlOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBmdWxsIGNvbW1pdCBoYXNoLlxuICAgKi9cbiAgcmVhZG9ubHkgc2hhOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBjb21taXQgc3ViamVjdC5cbiAgICovXG4gIHJlYWRvbmx5IHN1YmplY3Q6IHN0cmluZztcbn1cblxuLyoqXG4gKiBCdWlsZHMgdGhlIHN1YmplY3Qgb2YgdGhlIGNvbW1pdCB0aGF0IHNhdmVzIHdoYXRldmVyIHdhcyBwZW5kaW5nIGJlZm9yZSBhbiBvcGVyYXRpb24uXG4gKlxuICogQHBhcmFtIG9wZXJhdGlvbklkIC0gVGhlIG9wZXJhdGlvbiBpZCwgc3VjaCBhcyBgT1AxMmAuXG4gKiBAcmV0dXJucyBUaGUgY29tbWl0IHN1YmplY3QuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBidWlsZEJlZm9yZU9wZXJhdGlvbkNvbW1pdFN1YmplY3Qob3BlcmF0aW9uSWQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiBgY2hvcmU6IGJlZm9yZSAke29wZXJhdGlvbklkfWA7XG59XG5cbi8qKlxuICogQnVpbGRzIHRoZSBtZXNzYWdlIG9mIHRoZSBjb21taXQgcmVjb3JkaW5nIGEgYnVsayBvcGVyYXRpb24sIG9yIGFuIGludGVycnVwdGVkIG9uZS5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMuXG4gKiBAcmV0dXJucyBUaGUgY29tbWl0IHN1YmplY3QgYW5kIGJvZHkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBidWlsZE9wZXJhdGlvbkNvbW1pdE1lc3NhZ2UocGFyYW1zOiBCdWlsZE9wZXJhdGlvbkNvbW1pdE1lc3NhZ2VQYXJhbXMpOiBPcGVyYXRpb25Db21taXRNZXNzYWdlIHtcbiAgY29uc3Qgc3ViamVjdCA9IHBhcmFtcy5pc0ludGVycnVwdGVkXG4gICAgPyBgJHtwYXJhbXMub3BlcmF0aW9uSWR9IGludGVycnVwdGVkYFxuICAgIDogYCR7cGFyYW1zLm9wZXJhdGlvbklkfTogJHtub3JtYWxpemVTdW1tYXJ5KHBhcmFtcy5zdW1tYXJ5ID8/ICcnKX1gO1xuICAvLyBHaXQgdHJhaWxlcnMsIG9uZSBwZXIgbGluZSwgc28gYGdpdCBsb2cgLS1ncmVwYCBhbmQgYGdpdCBpbnRlcnByZXQtdHJhaWxlcnNgIGJvdGggcmVhZCB0aGVtLlxuICBjb25zdCBib2R5ID0gYFRpbWVzdGFtcDogJHtwYXJhbXMudGltZXN0YW1wLnRvSVNPU3RyaW5nKCl9XFxuQ2hhbmdlZC1GaWxlczogJHtTdHJpbmcocGFyYW1zLmNoYW5nZWRGaWxlQ291bnQpfVxcbmBcbiAgICArIGAke1BMVUdJTl9UUkFJTEVSX0tFWX06ICR7cGFyYW1zLnBsdWdpbklkfVxcbiR7T1BFUkFUSU9OX1RSQUlMRVJfS0VZfTogJHtwYXJhbXMub3BlcmF0aW9uSWR9YDtcbiAgcmV0dXJuIHsgYm9keSwgc3ViamVjdCB9O1xufVxuXG4vKipcbiAqIEZvcm1hdHMgYW4gb3BlcmF0aW9uIGlkIGZyb20gaXRzIG51bWJlci5cbiAqXG4gKiBAcGFyYW0gb3BlcmF0aW9uTnVtYmVyIC0gVGhlIG9wZXJhdGlvbiBudW1iZXIuXG4gKiBAcmV0dXJucyBUaGUgb3BlcmF0aW9uIGlkLCBzdWNoIGFzIGBPUDEyYC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGZvcm1hdE9wZXJhdGlvbklkKG9wZXJhdGlvbk51bWJlcjogbnVtYmVyKTogc3RyaW5nIHtcbiAgcmV0dXJuIGAke09QRVJBVElPTl9JRF9QUkVGSVh9JHtTdHJpbmcob3BlcmF0aW9uTnVtYmVyKX1gO1xufVxuXG4vKipcbiAqIEZpbmRzIHRoZSBuZXh0IG9wZXJhdGlvbiBpZCBmcm9tIHRoZSBzdWJqZWN0cyBvZiB0aGUgYnVsay1vcGVyYXRpb24gY29tbWl0cyBhbHJlYWR5IGluIHRoZSBoaXN0b3J5LlxuICpcbiAqIEBwYXJhbSBzdWJqZWN0cyAtIENvbW1pdCBzdWJqZWN0czsgYW55dGhpbmcgdGhhdCBpcyBub3QgYSBidWxrLW9wZXJhdGlvbiBzdWJqZWN0IGlzIGlnbm9yZWQuXG4gKiBAcmV0dXJucyBgT1A8bj5gIHdpdGggbiBvbmUgcGFzdCB0aGUgaGlnaGVzdCBudW1iZXIgZm91bmQsIG9yIGBPUDFgIHdoZW4gdGhlcmUgaXMgbm9uZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldE5leHRPcGVyYXRpb25JZChzdWJqZWN0czogcmVhZG9ubHkgc3RyaW5nW10pOiBzdHJpbmcge1xuICBsZXQgbWF4T3BlcmF0aW9uTnVtYmVyID0gMDtcbiAgZm9yIChjb25zdCBzdWJqZWN0IG9mIHN1YmplY3RzKSB7XG4gICAgY29uc3Qgb3BlcmF0aW9uTnVtYmVyID0gcGFyc2VPcGVyYXRpb25OdW1iZXIoc3ViamVjdCk7XG4gICAgaWYgKG9wZXJhdGlvbk51bWJlciAhPT0gbnVsbCAmJiBvcGVyYXRpb25OdW1iZXIgPiBtYXhPcGVyYXRpb25OdW1iZXIpIHtcbiAgICAgIG1heE9wZXJhdGlvbk51bWJlciA9IG9wZXJhdGlvbk51bWJlcjtcbiAgICB9XG4gIH1cbiAgcmV0dXJuIGZvcm1hdE9wZXJhdGlvbklkKG1heE9wZXJhdGlvbk51bWJlciArIDEpO1xufVxuXG4vKipcbiAqIENoZWNrcyB3aGV0aGVyIGEgdmFsdWUgaGFzIHRoZSBzaGFwZSBvZiBhIHtAbGluayBCdWxrT3BlcmF0aW9uTG9ja30uXG4gKlxuICogQHBhcmFtIHZhbHVlIC0gVGhlIHZhbHVlIHJlYWQgZnJvbSB0aGUgbG9jayBmaWxlLlxuICogQHJldHVybnMgV2hldGhlciBpdCBpcyBhIGxvY2sgcmVjb3JkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNCdWxrT3BlcmF0aW9uTG9jayh2YWx1ZTogdW5rbm93bik6IHZhbHVlIGlzIEJ1bGtPcGVyYXRpb25Mb2NrIHtcbiAgcmV0dXJuIGlzQnVsa09wZXJhdGlvbkxvY2tJbXBsKHZhbHVlKTtcbn1cblxuLyoqXG4gKiBEZWNpZGVzIHdoZXRoZXIgYSBsZWFzZSBsb2NrIGlzIHN0YWxlLCBzbyB3aG9ldmVyIGZpbmRzIGl0IG1heSBjb21taXQgdGhlIGxlZnRvdmVycyBhbmQgcmVtb3ZlIGl0LlxuICpcbiAqIFRoZSBoZWFydGJlYXQgaXMgdGhlIHJ1bGU7IHRoZSByZWJvb3QgYW5kIGNyYXNoZWQtcHJvY2VzcyBjaGVja3MgYXJlIG9ubHkgZmFzdCBwYXRocyB0aGF0IHNob3J0ZW4gdGhlIHdhaXQsIGFuZFxuICogbmVpdGhlciBjYW4gbWFrZSBhIGxvY2sgd2l0aCBhIGZyZXNoIGhlYXJ0YmVhdCBvbiBhbm90aGVyIG1hY2hpbmUgc3RhbGUuXG4gKlxuICogQHBhcmFtIGxvY2sgLSBUaGUgbG9jayByZWNvcmQuXG4gKiBAcGFyYW0gY29udGV4dCAtIFRoZSBmYWN0cyBhYm91dCB0aGlzIG1hY2hpbmUuXG4gKiBAcmV0dXJucyBXaGV0aGVyIHRoZSBsb2NrIGlzIHN0YWxlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNCdWxrT3BlcmF0aW9uTG9ja1N0YWxlKGxvY2s6IEJ1bGtPcGVyYXRpb25Mb2NrLCBjb250ZXh0OiBCdWxrT3BlcmF0aW9uTG9ja1N0YWxlbmVzc0NvbnRleHQpOiBib29sZWFuIHtcbiAgaWYgKGNvbnRleHQubm93IC0gbG9jay5oZWFydGJlYXRBdCA+PSBCVUxLX09QRVJBVElPTl9MT0NLX1NUQUxFX0FGVEVSX0lOX01JTExJU0VDT05EUykge1xuICAgIHJldHVybiB0cnVlO1xuICB9XG5cbiAgaWYgKGxvY2suaG9zdCAhPT0gY29udGV4dC5ob3N0KSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG5cbiAgY29uc3Qgd2FzSGVhcnRiZWF0QmVmb3JlQm9vdCA9IGNvbnRleHQuYm9vdGVkQXQgIT09IG51bGwgJiYgbG9jay5oZWFydGJlYXRBdCA8IGNvbnRleHQuYm9vdGVkQXQ7XG4gIHJldHVybiB3YXNIZWFydGJlYXRCZWZvcmVCb290IHx8IGNvbnRleHQuaXNQcm9jZXNzQWxpdmUobG9jay5wcm9jZXNzSWQpID09PSBmYWxzZTtcbn1cblxuLyoqXG4gKiBQYXJzZXMgYSBidWxrLW9wZXJhdGlvbiBjb21taXQgc3ViamVjdCBpbnRvIHRoZSBjb21taXQgaXQgZGVzY3JpYmVzLCBza2lwcGluZyB0aGUgYGNob3JlOiBiZWZvcmVgIGNvbW1pdHMsIHdoaWNoXG4gKiBhcmUgbm90IG9wZXJhdGlvbnMuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBjb21taXQncyBoYXNoLCBkYXRlIGFuZCBzdWJqZWN0LlxuICogQHJldHVybnMgVGhlIGJ1bGstb3BlcmF0aW9uIGNvbW1pdCwgb3IgYG51bGxgIHdoZW4gdGhlIHN1YmplY3QgaXMgbm90IG9uZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlQnVsa09wZXJhdGlvbkNvbW1pdChwYXJhbXM6IFBhcnNlQnVsa09wZXJhdGlvbkNvbW1pdFBhcmFtcyk6IEJ1bGtPcGVyYXRpb25Db21taXQgfCBudWxsIHtcbiAgY29uc3QgbWF0Y2ggPSAvXk9QKD88b3BlcmF0aW9uTnVtYmVyPlxcZCspKD88a2luZD46fCBpbnRlcnJ1cHRlZCQpLy5leGVjKHBhcmFtcy5zdWJqZWN0KTtcbiAgaWYgKCFtYXRjaCkge1xuICAgIHJldHVybiBudWxsO1xuICB9XG4gIHJldHVybiB7XG4gICAgZGF0ZTogcGFyYW1zLmRhdGUsXG4gICAgaXNJbnRlcnJ1cHRlZDogZ2V0TWFuZGF0b3J5TmFtZWRHcm91cChtYXRjaCwgJ2tpbmQnKSAhPT0gJzonLFxuICAgIG9wZXJhdGlvbklkOiBmb3JtYXRPcGVyYXRpb25JZChOdW1iZXIoZ2V0TWFuZGF0b3J5TmFtZWRHcm91cChtYXRjaCwgJ29wZXJhdGlvbk51bWJlcicpKSksXG4gICAgc2hhOiBwYXJhbXMuc2hhLFxuICAgIHN1YmplY3Q6IHBhcmFtcy5zdWJqZWN0XG4gIH07XG59XG5cbi8qKlxuICogUGFyc2VzIHRoZSBvcGVyYXRpb24gbnVtYmVyIG91dCBvZiBhIGJ1bGstb3BlcmF0aW9uIGNvbW1pdCBzdWJqZWN0LlxuICpcbiAqIFJlY29nbml6ZXMgYE9QPG4+OiA8c3VtbWFyeT5gLCBgT1A8bj4gaW50ZXJydXB0ZWRgIGFuZCBgY2hvcmU6IGJlZm9yZSBPUDxuPmAuXG4gKlxuICogQHBhcmFtIHN1YmplY3QgLSBUaGUgY29tbWl0IHN1YmplY3QuXG4gKiBAcmV0dXJucyBUaGUgb3BlcmF0aW9uIG51bWJlciwgb3IgYG51bGxgIHdoZW4gdGhlIHN1YmplY3QgaXMgbm90IGEgYnVsay1vcGVyYXRpb24gc3ViamVjdC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlT3BlcmF0aW9uTnVtYmVyKHN1YmplY3Q6IHN0cmluZyk6IG51bGwgfCBudW1iZXIge1xuICBjb25zdCBtYXRjaCA9IC9eKD86Y2hvcmU6IGJlZm9yZSApP09QKD88b3BlcmF0aW9uTnVtYmVyPlxcZCspKD86OnwgaW50ZXJydXB0ZWQkfCQpLy5leGVjKHN1YmplY3QpO1xuICByZXR1cm4gbWF0Y2ggPyBOdW1iZXIoZ2V0TWFuZGF0b3J5TmFtZWRHcm91cChtYXRjaCwgJ29wZXJhdGlvbk51bWJlcicpKSA6IG51bGw7XG59XG5cbmZ1bmN0aW9uIG5vcm1hbGl6ZVN1bW1hcnkoc3VtbWFyeTogc3RyaW5nKTogc3RyaW5nIHtcbiAgY29uc3Qgbm9ybWFsaXplZCA9IHN1bW1hcnkucmVwbGFjZUFsbCgvXFxzKy9nLCAnICcpLnRyaW0oKTtcbiAgcmV0dXJuIG5vcm1hbGl6ZWQgfHwgJ2J1bGsgb3BlcmF0aW9uJztcbn1cbiJdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7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

package/dist/lib/cjs/bulk-operation.d.cts

@@ -0,0 +1,237 @@
+/// <reference path="./library-references.d.cts" />
+/**
+ * @file
+ *
+ * The platform-neutral half of bulk-operation git commits: the lease-lock record, the `OP<n>` ids and the commit
+ * messages that carry them.
+ *
+ * A bulk operation wrapped by `BulkOperationCommitComponent` lands in the vault's git repo as one commit whose
+ * subject is `OP<n>: <summary>`, preceded (when the tree was dirty) by a `chore: before OP<n>` commit holding
+ * whatever was pending, so `git revert` of the `OP<n>` commit undoes exactly that operation. Everything in this
+ * module is pure, so it is shared by the desktop git layer and by the scheduled autocommit that reads the same lock.
+ *
+ * The lock record and the commit message trailers are a wire format between plugins built on different copies of
+ * this library and the vault autocommit script: fields may be added, never renamed or reinterpreted.
+ */
+/**
+ * The name of the lease-lock file, created inside the repo's git directory so it is never committed or
+ * synced.
+ */
+export declare const BULK_OPERATION_LOCK_FILE_NAME = "obsidian-bulk-operation.json";
+/**
+ * How long a lock may go without a heartbeat before it counts as stale.
+ *
+ * It errs long on purpose: holding a dead lock too long only makes an autocommit skip a tick, while declaring a
+ * live one stale splits its operation across two commits.
+ */
+export declare const BULK_OPERATION_LOCK_STALE_AFTER_IN_MILLISECONDS = 120000;
+/**
+ * The trailer key naming the operation id in a bulk-operation commit body.
+ */
+export declare const OPERATION_TRAILER_KEY = "Obsidian-Bulk-Operation";
+/**
+ * The trailer key naming the plugin in a bulk-operation commit body.
+ */
+export declare const PLUGIN_TRAILER_KEY = "Obsidian-Plugin";
+/**
+ * Parameters for {@link buildOperationCommitMessage}.
+ */
+export interface BuildOperationCommitMessageParams {
+    /**
+     * The number of files the commit changes.
+     */
+    readonly changedFileCount: number;
+    /**
+     * Whether the operation was interrupted.
+     */
+    readonly isInterrupted?: boolean;
+    /**
+     * The operation id, such as `OP12`.
+     */
+    readonly operationId: string;
+    /**
+     * The id of the plugin that ran the operation.
+     */
+    readonly pluginId: string;
+    /**
+     * A one-line description of the operation. Ignored for an interrupted operation.
+     */
+    readonly summary?: string;
+    /**
+     * When the operation ran.
+     */
+    readonly timestamp: Date;
+}
+/**
+ * A bulk-operation commit found in the repo history.
+ */
+export interface BulkOperationCommit {
+    /**
+     * The commit date, as an ISO 8601 string.
+     */
+    readonly date: string;
+    /**
+     * Whether the commit records an interrupted operation rather than a completed one.
+     */
+    readonly isInterrupted: boolean;
+    /**
+     * The operation id, such as `OP12`.
+     */
+    readonly operationId: string;
+    /**
+     * The full commit hash.
+     */
+    readonly sha: string;
+    /**
+     * The commit subject.
+     */
+    readonly subject: string;
+}
+/**
+ * The lease-lock record stored in `.git/obsidian-bulk-operation.json` while a bulk operation runs.
+ */
+export interface BulkOperationLock {
+    /**
+     * When the lock was last refreshed by the operation's progress, as epoch milliseconds.
+     */
+    readonly heartbeatAt: number;
+    /**
+     * The host name of the machine running the operation.
+     */
+    readonly host: string;
+    /**
+     * The operation id, such as `OP12`.
+     */
+    readonly operationId: string;
+    /**
+     * The id of the plugin running the operation.
+     */
+    readonly pluginId: string;
+    /**
+     * The id of the process running Obsidian. Only a fast path for an app crash; staleness never depends on it.
+     */
+    readonly processId: number;
+    /**
+     * When the process running Obsidian started, as epoch milliseconds, so a recycled process id is not mistaken for
+     * the original one.
+     */
+    readonly processStartedAt: number;
+    /**
+     * When the operation started, as epoch milliseconds.
+     */
+    readonly startedAt: number;
+}
+/**
+ * The facts {@link isBulkOperationLockStale} weighs besides the heartbeat.
+ */
+export interface BulkOperationLockStalenessContext {
+    /**
+     * When this machine last booted, as epoch milliseconds, or `null` when unknown.
+     */
+    readonly bootedAt: null | number;
+    /**
+     * The host name of this machine.
+     */
+    readonly host: string;
+    /**
+     * Whether the process recorded in the lock is still running on this machine, or `null` when it cannot be told.
+     */
+    readonly isProcessAlive: (processId: number) => boolean | null;
+    /**
+     * The current time, as epoch milliseconds.
+     */
+    readonly now: number;
+}
+/**
+ * The commit message of one bulk-operation commit.
+ */
+export interface OperationCommitMessage {
+    /**
+     * The commit body: the timestamp, the plugin and the counts, as git trailers.
+     */
+    readonly body: string;
+    /**
+     * The commit subject.
+     */
+    readonly subject: string;
+}
+/**
+ * Parameters for {@link parseBulkOperationCommit}.
+ */
+export interface ParseBulkOperationCommitParams {
+    /**
+     * The commit date, as an ISO 8601 string.
+     */
+    readonly date: string;
+    /**
+     * The full commit hash.
+     */
+    readonly sha: string;
+    /**
+     * The commit subject.
+     */
+    readonly subject: string;
+}
+/**
+ * Builds the subject of the commit that saves whatever was pending before an operation.
+ *
+ * @param operationId - The operation id, such as `OP12`.
+ * @returns The commit subject.
+ */
+export declare function buildBeforeOperationCommitSubject(operationId: string): string;
+/**
+ * Builds the message of the commit recording a bulk operation, or an interrupted one.
+ *
+ * @param params - The parameters.
+ * @returns The commit subject and body.
+ */
+export declare function buildOperationCommitMessage(params: BuildOperationCommitMessageParams): OperationCommitMessage;
+/**
+ * Formats an operation id from its number.
+ *
+ * @param operationNumber - The operation number.
+ * @returns The operation id, such as `OP12`.
+ */
+export declare function formatOperationId(operationNumber: number): string;
+/**
+ * Finds the next operation id from the subjects of the bulk-operation commits already in the history.
+ *
+ * @param subjects - Commit subjects; anything that is not a bulk-operation subject is ignored.
+ * @returns `OP<n>` with n one past the highest number found, or `OP1` when there is none.
+ */
+export declare function getNextOperationId(subjects: readonly string[]): string;
+/**
+ * Checks whether a value has the shape of a {@link BulkOperationLock}.
+ *
+ * @param value - The value read from the lock file.
+ * @returns Whether it is a lock record.
+ */
+export declare function isBulkOperationLock(value: unknown): value is BulkOperationLock;
+/**
+ * Decides whether a lease lock is stale, so whoever finds it may commit the leftovers and remove it.
+ *
+ * The heartbeat is the rule; the reboot and crashed-process checks are only fast paths that shorten the wait, and
+ * neither can make a lock with a fresh heartbeat on another machine stale.
+ *
+ * @param lock - The lock record.
+ * @param context - The facts about this machine.
+ * @returns Whether the lock is stale.
+ */
+export declare function isBulkOperationLockStale(lock: BulkOperationLock, context: BulkOperationLockStalenessContext): boolean;
+/**
+ * Parses a bulk-operation commit subject into the commit it describes, skipping the `chore: before` commits, which
+ * are not operations.
+ *
+ * @param params - The commit's hash, date and subject.
+ * @returns The bulk-operation commit, or `null` when the subject is not one.
+ */
+export declare function parseBulkOperationCommit(params: ParseBulkOperationCommitParams): BulkOperationCommit | null;
+/**
+ * Parses the operation number out of a bulk-operation commit subject.
+ *
+ * Recognizes `OP<n>: <summary>`, `OP<n> interrupted` and `chore: before OP<n>`.
+ *
+ * @param subject - The commit subject.
+ * @returns The operation number, or `null` when the subject is not a bulk-operation subject.
+ */
+export declare function parseOperationNumber(subject: string): null | number;

package/dist/lib/cjs/command-handlers/index.cjs

@@ -106,6 +106,7 @@ __export(command_handlers_exports, {
   "global-command-handler": () => global_command_handler,
   "open-demo-vault-command-handler": () => open_demo_vault_command_handler,
   "open-settings-command-handler": () => open_settings_command_handler,
+  "undo-bulk-operation-command-handler": () => undo_bulk_operation_command_handler,
   "unlock-active-note-command-handler": () => unlock_active_note_command_handler
 });
 module.exports = __toCommonJS(command_handlers_exports);
@@ -118,6 +119,7 @@ var folder_command_handler = __toESM(((module) => module && module.__esModule &&
 var global_command_handler = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./global-command-handler.cjs')), 1);
 var open_demo_vault_command_handler = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./open-demo-vault-command-handler.cjs')), 1);
 var open_settings_command_handler = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./open-settings-command-handler.cjs')), 1);
+var undo_bulk_operation_command_handler = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./undo-bulk-operation-command-handler.cjs')), 1);
 var unlock_active_note_command_handler = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./unlock-active-note-command-handler.cjs')), 1);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -130,6 +132,7 @@ var unlock_active_note_command_handler = __toESM(((module) => module && module._
   "global-command-handler": null,
   "open-demo-vault-command-handler": null,
   "open-settings-command-handler": null,
+  "undo-bulk-operation-command-handler": null,
   "unlock-active-note-command-handler": null
 });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb21tYW5kLWhhbmRsZXJzL2luZGV4LnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qIFRISVMgSVMgQSBHRU5FUkFURUQvQlVORExFRCBGSUxFIEJZIEJVSUxEIFNDUklQVCAqL1xuXG5leHBvcnQgKiBhcyAnYWJzdHJhY3QtZmlsZS1jb21tYW5kLWhhbmRsZXInIGZyb20gJy4vYWJzdHJhY3QtZmlsZS1jb21tYW5kLWhhbmRsZXIudHMnO1xuZXhwb3J0ICogYXMgJ2NvbW1hbmQtaGFuZGxlci1jb21wb25lbnQnIGZyb20gJy4vY29tbWFuZC1oYW5kbGVyLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAnY29tbWFuZC1oYW5kbGVyJyBmcm9tICcuL2NvbW1hbmQtaGFuZGxlci50cyc7XG5leHBvcnQgKiBhcyAnZWRpdG9yLWNvbW1hbmQtaGFuZGxlcicgZnJvbSAnLi9lZGl0b3ItY29tbWFuZC1oYW5kbGVyLnRzJztcbmV4cG9ydCAqIGFzICdmaWxlLWNvbW1hbmQtaGFuZGxlcicgZnJvbSAnLi9maWxlLWNvbW1hbmQtaGFuZGxlci50cyc7XG5leHBvcnQgKiBhcyAnZm9sZGVyLWNvbW1hbmQtaGFuZGxlcicgZnJvbSAnLi9mb2xkZXItY29tbWFuZC1oYW5kbGVyLnRzJztcbmV4cG9ydCAqIGFzICdnbG9iYWwtY29tbWFuZC1oYW5kbGVyJyBmcm9tICcuL2dsb2JhbC1jb21tYW5kLWhhbmRsZXIudHMnO1xuZXhwb3J0ICogYXMgJ29wZW4tZGVtby12YXVsdC1jb21tYW5kLWhhbmRsZXInIGZyb20gJy4vb3Blbi1kZW1vLXZhdWx0LWNvbW1hbmQtaGFuZGxlci50cyc7XG5leHBvcnQgKiBhcyAnb3Blbi1zZXR0aW5ncy1jb21tYW5kLWhhbmRsZXInIGZyb20gJy4vb3Blbi1zZXR0aW5ncy1jb21tYW5kLWhhbmRsZXIudHMnO1xuZXhwb3J0ICogYXMgJ3VubG9jay1hY3RpdmUtbm90ZS1jb21tYW5kLWhhbmRsZXInIGZyb20gJy4vdW5sb2NrLWFjdGl2ZS1ub3RlLWNvbW1hbmQtaGFuZGxlci50cyc7XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUEseUNBQUFBO0FBQUEsRUFBQSx5QkFBQUM7QUFBQSxFQUFBLG1DQUFBQztBQUFBLEVBQUEsZ0NBQUFDO0FBQUEsRUFBQSw4QkFBQUM7QUFBQSxFQUFBLGdDQUFBQztBQUFBLEVBQUEsZ0NBQUFDO0FBQUEsRUFBQSx5Q0FBQUM7QUFBQSxFQUFBLHVDQUFBQztBQUFBLEVBQUEsNENBQUFDO0FBQUE7QUFBQTtBQUVBLElBQUFULGdDQUFpRDtBQUNqRCxJQUFBRSw0QkFBNkM7QUFDN0MsSUFBQUQsa0JBQW1DO0FBQ25DLElBQUFFLHlCQUEwQztBQUMxQyxJQUFBQyx1QkFBd0M7QUFDeEMsSUFBQUMseUJBQTBDO0FBQzFDLElBQUFDLHlCQUEwQztBQUMxQyxJQUFBQyxrQ0FBbUQ7QUFDbkQsSUFBQUMsZ0NBQWlEO0FBQ2pELElBQUFDLHFDQUFzRDsiLCJuYW1lcyI6WyJhYnN0cmFjdC1maWxlLWNvbW1hbmQtaGFuZGxlciIsImNvbW1hbmQtaGFuZGxlciIsImNvbW1hbmQtaGFuZGxlci1jb21wb25lbnQiLCJlZGl0b3ItY29tbWFuZC1oYW5kbGVyIiwiZmlsZS1jb21tYW5kLWhhbmRsZXIiLCJmb2xkZXItY29tbWFuZC1oYW5kbGVyIiwiZ2xvYmFsLWNvbW1hbmQtaGFuZGxlciIsIm9wZW4tZGVtby12YXVsdC1jb21tYW5kLWhhbmRsZXIiLCJvcGVuLXNldHRpbmdzLWNvbW1hbmQtaGFuZGxlciIsInVubG9jay1hY3RpdmUtbm90ZS1jb21tYW5kLWhhbmRsZXIiXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb21tYW5kLWhhbmRsZXJzL2luZGV4LnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qIFRISVMgSVMgQSBHRU5FUkFURUQvQlVORExFRCBGSUxFIEJZIEJVSUxEIFNDUklQVCAqL1xuXG5leHBvcnQgKiBhcyAnYWJzdHJhY3QtZmlsZS1jb21tYW5kLWhhbmRsZXInIGZyb20gJy4vYWJzdHJhY3QtZmlsZS1jb21tYW5kLWhhbmRsZXIudHMnO1xuZXhwb3J0ICogYXMgJ2NvbW1hbmQtaGFuZGxlci1jb21wb25lbnQnIGZyb20gJy4vY29tbWFuZC1oYW5kbGVyLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyAnY29tbWFuZC1oYW5kbGVyJyBmcm9tICcuL2NvbW1hbmQtaGFuZGxlci50cyc7XG5leHBvcnQgKiBhcyAnZWRpdG9yLWNvbW1hbmQtaGFuZGxlcicgZnJvbSAnLi9lZGl0b3ItY29tbWFuZC1oYW5kbGVyLnRzJztcbmV4cG9ydCAqIGFzICdmaWxlLWNvbW1hbmQtaGFuZGxlcicgZnJvbSAnLi9maWxlLWNvbW1hbmQtaGFuZGxlci50cyc7XG5leHBvcnQgKiBhcyAnZm9sZGVyLWNvbW1hbmQtaGFuZGxlcicgZnJvbSAnLi9mb2xkZXItY29tbWFuZC1oYW5kbGVyLnRzJztcbmV4cG9ydCAqIGFzICdnbG9iYWwtY29tbWFuZC1oYW5kbGVyJyBmcm9tICcuL2dsb2JhbC1jb21tYW5kLWhhbmRsZXIudHMnO1xuZXhwb3J0ICogYXMgJ29wZW4tZGVtby12YXVsdC1jb21tYW5kLWhhbmRsZXInIGZyb20gJy4vb3Blbi1kZW1vLXZhdWx0LWNvbW1hbmQtaGFuZGxlci50cyc7XG5leHBvcnQgKiBhcyAnb3Blbi1zZXR0aW5ncy1jb21tYW5kLWhhbmRsZXInIGZyb20gJy4vb3Blbi1zZXR0aW5ncy1jb21tYW5kLWhhbmRsZXIudHMnO1xuZXhwb3J0ICogYXMgJ3VuZG8tYnVsay1vcGVyYXRpb24tY29tbWFuZC1oYW5kbGVyJyBmcm9tICcuL3VuZG8tYnVsay1vcGVyYXRpb24tY29tbWFuZC1oYW5kbGVyLnRzJztcbmV4cG9ydCAqIGFzICd1bmxvY2stYWN0aXZlLW5vdGUtY29tbWFuZC1oYW5kbGVyJyBmcm9tICcuL3VubG9jay1hY3RpdmUtbm90ZS1jb21tYW5kLWhhbmRsZXIudHMnO1xuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBLHlDQUFBQTtBQUFBLEVBQUEseUJBQUFDO0FBQUEsRUFBQSxtQ0FBQUM7QUFBQSxFQUFBLGdDQUFBQztBQUFBLEVBQUEsOEJBQUFDO0FBQUEsRUFBQSxnQ0FBQUM7QUFBQSxFQUFBLGdDQUFBQztBQUFBLEVBQUEseUNBQUFDO0FBQUEsRUFBQSx1Q0FBQUM7QUFBQSxFQUFBLDZDQUFBQztBQUFBLEVBQUEsNENBQUFDO0FBQUE7QUFBQTtBQUVBLElBQUFWLGdDQUFpRDtBQUNqRCxJQUFBRSw0QkFBNkM7QUFDN0MsSUFBQUQsa0JBQW1DO0FBQ25DLElBQUFFLHlCQUEwQztBQUMxQyxJQUFBQyx1QkFBd0M7QUFDeEMsSUFBQUMseUJBQTBDO0FBQzFDLElBQUFDLHlCQUEwQztBQUMxQyxJQUFBQyxrQ0FBbUQ7QUFDbkQsSUFBQUMsZ0NBQWlEO0FBQ2pELElBQUFDLHNDQUF1RDtBQUN2RCxJQUFBQyxxQ0FBc0Q7IiwibmFtZXMiOlsiYWJzdHJhY3QtZmlsZS1jb21tYW5kLWhhbmRsZXIiLCJjb21tYW5kLWhhbmRsZXIiLCJjb21tYW5kLWhhbmRsZXItY29tcG9uZW50IiwiZWRpdG9yLWNvbW1hbmQtaGFuZGxlciIsImZpbGUtY29tbWFuZC1oYW5kbGVyIiwiZm9sZGVyLWNvbW1hbmQtaGFuZGxlciIsImdsb2JhbC1jb21tYW5kLWhhbmRsZXIiLCJvcGVuLWRlbW8tdmF1bHQtY29tbWFuZC1oYW5kbGVyIiwib3Blbi1zZXR0aW5ncy1jb21tYW5kLWhhbmRsZXIiLCJ1bmRvLWJ1bGstb3BlcmF0aW9uLWNvbW1hbmQtaGFuZGxlciIsInVubG9jay1hY3RpdmUtbm90ZS1jb21tYW5kLWhhbmRsZXIiXX0=

package/dist/lib/cjs/command-handlers/index.d.cts

@@ -8,4 +8,5 @@ export * as 'folder-command-handler' from './folder-command-handler.cjs';
 export * as 'global-command-handler' from './global-command-handler.cjs';
 export * as 'open-demo-vault-command-handler' from './open-demo-vault-command-handler.cjs';
 export * as 'open-settings-command-handler' from './open-settings-command-handler.cjs';
+export * as 'undo-bulk-operation-command-handler' from './undo-bulk-operation-command-handler.cjs';
 export * as 'unlock-active-note-command-handler' from './unlock-active-note-command-handler.cjs';