Guide
Examples
Plugins
Reference
Guide
Examples
Plugins
Reference

Attribution (Blame)

Attribution enables seeing who made changes and when, providing transparency and accountability in collaborative environments. Lix surfaces attribution for every modification - from document edits to configuration updates.

Blame

Examples

Find out who authored a change

When a user selects an element in your application (like a table cell, paragraph, or form field), you can query the attribution for that entity.

import { openLix } from "@lix-js/sdk";
// Assume that `selectedEntity` is the entity the user has selected in your application
const selectedEntity = {
  entity_id: "example-entity",
  schema_key: "json_property",
  file_id: "/example.json",
};

// For demonstration, we'll query an actual entity from the database
const actualEntity = await lix.db
  .selectFrom("state")
  .selectAll()
  .limit(1)
  .executeTakeFirst();

if (actualEntity) {
  // Query the change information for this entity
  console.log(
    `Entity ${actualEntity.entity_id} was last modified at ${actualEntity.updated_at}`
  );
  console.log(`Change ID: ${actualEntity.change_id}`);
  console.log(`Entity type: ${actualEntity.schema_key}`);
} else {
  console.log("No entities found in the database");
}

File change attribution

import { openLix } from "@lix-js/sdk";

// Assume that `selectedEntity` is the entity the user has selected in your application
const selectedEntity = {
  entity_id: "example-entity",
  schema_key: "json_property",
  file_id: "/example.json",
};

// For demonstration, we'll query an actual entity from the database
const actualEntity = await lix.db
  .selectFrom("state")
  .selectAll()
  .limit(1)
  .executeTakeFirst();

if (actualEntity) {
  // Query the change information for this entity
  console.log(
    `Entity ${actualEntity.entity_id} was last modified at ${actualEntity.updated_at}`
  );
  console.log(`Change ID: ${actualEntity.change_id}`);
  console.log(`Entity type: ${actualEntity.schema_key}`);
} else {
  console.log("No entities found in the database");
}
const fileEntity = await lix.db
  .selectFrom("file")
  .where("path", "=", "/example.json")
  .selectAll()
  .executeTakeFirst();

if (fileEntity) {
  console.log(
    `File ${fileEntity.path} was last modified at ${fileEntity.lixcol_updated_at}`
  );
  console.log(`File change ID: ${fileEntity.lixcol_change_id}`);
} else {
  console.log(
    "File /example.json not found - run getting-started example first"
  );
}
ON THIS PAGE