@bendyline/squisq 2.1.0 → 2.3.0

package/dist/chunk-JOQYPRDZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/versions/paths.ts","../src/versions/operations.ts","../src/versions/DocumentVersionManager.ts"],"sourcesContent":["/**\n * Path conventions for version snapshots.\n *\n * Snapshots live at `<VERSIONS_PREFIX><basename>.<timestamp>[<-suffix>].md`.\n * The optional numeric suffix (`-2`, `-3`, ...) is appended only when two\n * snapshots collide on the same UTC second.\n */\n\nimport {\n  buildSnapshotPath,\n  parseSnapshotPath,\n  type SnapshotPathStrategy,\n} from './snapshotStore.js';\n\n/** Subfolder (inside the ContentContainer) that holds version snapshots. */\nexport const VERSIONS_PREFIX = '.versions/';\n\n/** Internal strategy shared with the generic snapshot store. */\nexport const DOCUMENT_VERSION_PATHS: SnapshotPathStrategy = Object.freeze({\n  prefix: VERSIONS_PREFIX,\n  extension: 'md',\n});\n\n/**\n * Strip the directory and extension from a document path to produce the\n * basename used in version filenames. `subdir/index.md` -> `index`.\n */\nexport function getDocBasename(documentPath: string): string {\n  const slash = documentPath.lastIndexOf('/');\n  const file = slash >= 0 ? documentPath.slice(slash + 1) : documentPath;\n  const dot = file.lastIndexOf('.');\n  return dot > 0 ? file.slice(0, dot) : file;\n}\n\n/**\n * Build a version snapshot path. Optionally append a collision suffix\n * (e.g. `2`, `3`) when two saves land on the same UTC second.\n */\nexport function buildVersionPath(basename: string, date: Date, collision = 0): string {\n  return buildSnapshotPath(DOCUMENT_VERSION_PATHS, basename, date, collision);\n}\n\n/**\n * Parse a version snapshot path. Returns null if it doesn't match the\n * convention (so unrelated files stored under `.versions/` are ignored).\n */\nexport function parseVersionPath(\n  path: string,\n): { basename: string; timestamp: Date; collision: number } | null {\n  return parseSnapshotPath(DOCUMENT_VERSION_PATHS, path);\n}\n","/**\n * Pure-ish version operations against a {@link ContentContainer}.\n *\n * These functions are the canonical implementation. {@link DocumentVersionManager}\n * is a thin wrapper that captures a container reference for ergonomics.\n */\n\nimport type { ContentContainer } from '../storage/ContentContainer.js';\nimport { DOCUMENT_VERSION_PATHS, getDocBasename } from './paths.js';\nimport {\n  coalesceSnapshots,\n  listSnapshots,\n  pruneSnapshots,\n  readTextSnapshot,\n  saveTextSnapshot,\n} from './snapshotStore.js';\nimport type {\n  CoalesceOptions,\n  PrunePolicy,\n  RevertOptions,\n  SaveVersionOptions,\n  SaveVersionResult,\n  Version,\n} from './types.js';\n\nasync function resolveBasename(\n  container: ContentContainer,\n  override: string | undefined,\n): Promise<string | null> {\n  if (override) return override;\n  const docPath = await container.getDocumentPath();\n  if (!docPath) return null;\n  return getDocBasename(docPath);\n}\n\nasync function resolveDocPath(container: ContentContainer): Promise<string> {\n  // Default to `index.md` when the container has no document yet — matches\n  // `MemoryContentContainer.writeDocument`'s default.\n  const docPath = await container.getDocumentPath();\n  return docPath ?? 'index.md';\n}\n\n/**\n * List all snapshots in the container, newest-first.\n *\n * @param basename Optional filter: when set, only versions whose basename\n *   matches are returned.\n */\nexport async function listVersions(\n  container: ContentContainer,\n  basename?: string,\n): Promise<Version[]> {\n  return listSnapshots(container, DOCUMENT_VERSION_PATHS, basename);\n}\n\n/**\n * Read the markdown content of a snapshot. Returns null if the snapshot\n * doesn't exist.\n */\nexport async function readVersion(\n  container: ContentContainer,\n  version: Version | string,\n): Promise<string | null> {\n  return readTextSnapshot(container, version);\n}\n\n/**\n * Save a new snapshot of the document if its content differs from the\n * latest existing snapshot.\n */\nexport async function saveVersion(\n  container: ContentContainer,\n  options: SaveVersionOptions = {},\n): Promise<SaveVersionResult> {\n  const content = options.content ?? (await container.readDocument());\n  if (content === null || content === undefined) {\n    return { saved: false, version: null, reason: 'no-document' };\n  }\n  if (content.length === 0) {\n    return { saved: false, version: null, reason: 'empty' };\n  }\n\n  const basename = await resolveBasename(container, options.basename);\n  if (!basename) {\n    return { saved: false, version: null, reason: 'no-document' };\n  }\n\n  return saveTextSnapshot(container, DOCUMENT_VERSION_PATHS, {\n    content,\n    basename,\n    mimeType: 'text/markdown',\n    now: options.now,\n    force: options.force,\n  });\n}\n\n/**\n * Revert the document to a prior snapshot. By default, the *current*\n * document is snapshotted first so the revert is itself recoverable.\n */\nexport async function revertToVersion(\n  container: ContentContainer,\n  version: Version | string,\n  options: RevertOptions = {},\n): Promise<{ reverted: boolean; snapshotted: Version | null }> {\n  const content = await readVersion(container, version);\n  if (content === null) {\n    return { reverted: false, snapshotted: null };\n  }\n\n  let snapshotted: Version | null = null;\n  if (options.snapshotCurrent !== false) {\n    const result = await saveVersion(container);\n    snapshotted = result.version;\n  }\n\n  const docPath = await resolveDocPath(container);\n  await container.writeDocument(content, docPath);\n  return { reverted: true, snapshotted };\n}\n\n/**\n * Delete snapshots that don't satisfy the policy. Returns the deleted\n * versions in their original (newest-first) order.\n */\nexport async function pruneVersions(\n  container: ContentContainer,\n  policy: PrunePolicy,\n  basename?: string,\n): Promise<Version[]> {\n  return pruneSnapshots(container, DOCUMENT_VERSION_PATHS, policy, basename);\n}\n\n/**\n * Collapse adjacent snapshots that occurred close together — keeping the\n * newer one — to keep history readable across rapid edits.\n */\nexport async function coalesceVersions(\n  container: ContentContainer,\n  options: CoalesceOptions = {},\n  basename?: string,\n): Promise<Version[]> {\n  return coalesceSnapshots(container, DOCUMENT_VERSION_PATHS, options, basename);\n}\n","/**\n * Convenience wrapper around the version operations that captures a\n * {@link ContentContainer} reference and an optional basename override.\n *\n * Hosts that prefer a stable handle (e.g. to pass into a UI component)\n * use this; everything it does is also reachable as a free function.\n */\n\nimport type { ContentContainer } from '../storage/ContentContainer.js';\nimport {\n  coalesceVersions,\n  listVersions,\n  pruneVersions,\n  readVersion,\n  revertToVersion,\n  saveVersion,\n} from './operations.js';\nimport type {\n  CoalesceOptions,\n  PrunePolicy,\n  RevertOptions,\n  SaveVersionOptions,\n  SaveVersionResult,\n  Version,\n} from './types.js';\n\nexport interface DocumentVersionManagerOptions {\n  /**\n   * Override the document basename used in version filenames. Defaults to\n   * the basename of `container.getDocumentPath()` resolved at call time.\n   */\n  basename?: string;\n}\n\nexport class DocumentVersionManager {\n  private readonly container: ContentContainer;\n  private readonly basename: string | undefined;\n\n  constructor(container: ContentContainer, options: DocumentVersionManagerOptions = {}) {\n    this.container = container;\n    this.basename = options.basename;\n  }\n\n  saveVersion(options: SaveVersionOptions = {}): Promise<SaveVersionResult> {\n    return saveVersion(this.container, { basename: this.basename, ...options });\n  }\n\n  listVersions(): Promise<Version[]> {\n    return listVersions(this.container, this.basename);\n  }\n\n  readVersion(version: Version | string): Promise<string | null> {\n    return readVersion(this.container, version);\n  }\n\n  revertToVersion(\n    version: Version | string,\n    options?: RevertOptions,\n  ): Promise<{ reverted: boolean; snapshotted: Version | null }> {\n    return revertToVersion(this.container, version, options);\n  }\n\n  pruneVersions(policy: PrunePolicy): Promise<Version[]> {\n    return pruneVersions(this.container, policy, this.basename);\n  }\n\n  coalesceVersions(options?: CoalesceOptions): Promise<Version[]> {\n    return coalesceVersions(this.container, options, this.basename);\n  }\n}\n"],"mappings":"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","names":[]}