fs.change - Mesa Docs

Mounted filesystems expose change controls under fs.change.

fs.change.new()

Create and switch to a new change from a bookmark or existing change.

const result = await fs.change.new({ repo: 'app', bookmark: 'main', message: 'Try new copy' });
console.log(result.changeOid);

string

required

Repository name.

string | undefined

Bookmark to fork from. Mutually exclusive with changeId.

string | undefined

Change ID to fork from. Mutually exclusive with bookmark.

string | undefined

Description for the new change. Omit to create the change with no description; pass "" explicitly for an empty description.

fs.change.edit()

Switch to an existing editable change. This never creates a new change.

await fs.change.edit({ repo: 'app', changeId: 'zyxwvutsrqponmlkzyxwvutsrqponmlk' });

string

required

Repository name.

string | undefined

Bookmark whose existing change should be edited. Mutually exclusive with changeId.

string | undefined

Existing change ID to edit. Mutually exclusive with bookmark.

fs.change.list()

List changes reachable from the current checkout’s commit.

const changes = await fs.change.list({ repo: 'app', limit: 10 });

string

required

Repository name.

number | undefined

Maximum number of changes to return. Defaults to 50. Pass 0 for no limit.

fs.change.current()

Return the currently active change for a repo.

const current = await fs.change.current({ repo: 'app' });
console.log(current.changeId, current.commitOid);

string

required

Repository name.

Response types

string

Hex-encoded change OID of the now-active change.

string

Hex-encoded change ID.

string

Hex-encoded commit OID the change currently points to.

​fs.change.new()

​fs.change.edit()

​fs.change.list()

​fs.change.current()

​Response types

fs.change.new()

fs.change.edit()

fs.change.list()

fs.change.current()

Response types