Forge Bitbucket Utilities

A package of helpers for interacting with Bitbucket.

unwrapUuid/wrapUuid

Bitbucket resource identifiers, such as those for workspaces and repositories, are formatted as UUIDs wrapped in braces.

There may be scenarios where Forge app developers need to use these resources with certain Forge APIs, but these APIs do not allow {} characters. An example of this is the Storage API. In these cases, you can use the unwrapUuid and wrapUuid functions to convert a Bitbucket resource ID between a wrapped and unwrapped UUID.

Usage:

import Resolver from "@forge/resolver";
import { storage } from "@forge/api";
import { unwrapUuid, wrapUuid } from "@forge/bitbucket";

const resolver = new Resolver();

resolver.define("storeValue", async (request) => {
  const repoId = request.context.extension.repository.uuid;
  await storage.set(unwrapUuid(repoId), "Hello, World!");
});

resolver.define("getValue", async (request) => {
  const repoId = request.context.extension.repository.uuid;
  return await storage.get(unwrapUuid(repoId));
});

export const resolverHandler = resolver.getDefinitions();