Function computeSnapshotHash

packages/convert/src/snapshot/hash.ts:22–52

(file: SnapshotHashInput)

 * @returns Hash string in format 'sha256:{hex}'
 */
export function computeSnapshotHash(file: SnapshotHashInput): string {
  const parts: string[] = []

  // Version
  parts.push(`version:${file.version}`)

  // Environment hash
  if (file.environment?.hash) {
    parts.push(`env:${file.environment.hash}`)
  }

  // Integrations (sorted for determinism)
  const integrations = file.project.integrations ?? []
  const sortedIntegrations = [...integrations].sort((a, b) => a.id.localeCompare(b.id))
  for (const integration of sortedIntegrations) {
    parts.push(`integration:${integration.id}:${integration.type}`)
  }

  // All block content hashes (preserve notebook and block order)
  for (const notebook of file.project.notebooks) {
    for (const block of notebook.blocks) {
      if (block.contentHash) {
        parts.push(`block:${block.id}:${block.contentHash}`)
      }
    }
  }

  const combined = parts.join('\n')
  const hash = createHash('sha256').update(combined, 'utf-8').digest('hex')
  return `sha256:${hash}`
}

/**
 * Adds content hashes to all blocks in a DeepnoteFile that don't already have them.