@pierre/storage 1.3.2 → 1.4.0

package/README.md

@@ -214,6 +214,24 @@ const branches = await repo.listBranches({
 });
 console.log(branches.branches);
 
+// List tags
+const tags = await repo.listTags({
+  limit: 10,
+  cursor: undefined, // for pagination
+});
+console.log(tags.tags);
+
+// Create a lightweight tag at a commit SHA
+const createdTag = await repo.createTag({
+  name: 'v1.0.0',
+  target: '0123456789abcdef0123456789abcdef01234567',
+});
+console.log(createdTag.message);
+
+// Delete a tag
+const deletedTag = await repo.deleteTag({ name: 'v1.0.0' });
+console.log(deletedTag.message);
+
 // List commits
 const commits = await repo.listCommits({
   branch: 'main', // optional

package/dist/index.cjs

@@ -168,6 +168,25 @@ var createBranchResponseSchema = zod.z.object({
   target_is_ephemeral: zod.z.boolean(),
   commit_sha: zod.z.string().nullable().optional()
 });
+var tagInfoSchema = zod.z.object({
+  cursor: zod.z.string(),
+  name: zod.z.string(),
+  sha: zod.z.string()
+});
+var listTagsResponseSchema = zod.z.object({
+  tags: zod.z.array(tagInfoSchema),
+  next_cursor: zod.z.string().nullable().optional(),
+  has_more: zod.z.boolean()
+});
+var createTagResponseSchema = zod.z.object({
+  name: zod.z.string(),
+  sha: zod.z.string(),
+  message: zod.z.string()
+});
+var deleteTagResponseSchema = zod.z.object({
+  name: zod.z.string(),
+  message: zod.z.string()
+});
 var refUpdateResultSchema = zod.z.object({
   branch: zod.z.string(),
   old_sha: zod.z.string(),
@@ -530,7 +549,7 @@ function concatChunks(a, b) {
 
 // package.json
 var package_default = {
-  version: "1.3.2"};
+  version: "1.4.0"};
 
 // src/version.ts
 var PACKAGE_NAME = "code-storage-sdk";
@@ -1684,6 +1703,33 @@ function transformCreateBranchResult(raw) {
     commitSha: raw.commit_sha ?? void 0
   };
 }
+function transformTagInfo(raw) {
+  return {
+    cursor: raw.cursor,
+    name: raw.name,
+    sha: raw.sha
+  };
+}
+function transformListTagsResult(raw) {
+  return {
+    tags: raw.tags.map(transformTagInfo),
+    nextCursor: raw.next_cursor ?? void 0,
+    hasMore: raw.has_more
+  };
+}
+function transformCreateTagResult(raw) {
+  return {
+    name: raw.name,
+    sha: raw.sha,
+    message: raw.message
+  };
+}
+function transformDeleteTagResult(raw) {
+  return {
+    name: raw.name,
+    message: raw.message
+  };
+}
 function transformListReposResult(raw) {
   return {
     repos: raw.repos.map((repo) => ({
@@ -1956,6 +2002,31 @@ var RepoImpl = class {
       next_cursor: raw.next_cursor ?? void 0
     });
   }
+  async listTags(options) {
+    const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+    const jwt = await this.generateJWT(this.id, {
+      permissions: ["git:read"],
+      ttl
+    });
+    const cursor = options?.cursor;
+    const limit = options?.limit;
+    let params;
+    if (typeof cursor === "string" || typeof limit === "number") {
+      params = {};
+      if (typeof cursor === "string") {
+        params.cursor = cursor;
+      }
+      if (typeof limit === "number") {
+        params.limit = limit.toString();
+      }
+    }
+    const response = await this.api.get({ path: "repos/tags", params }, jwt);
+    const raw = listTagsResponseSchema.parse(await response.json());
+    return transformListTagsResult({
+      ...raw,
+      next_cursor: raw.next_cursor ?? void 0
+    });
+  }
   async listCommits(options) {
     const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
     const jwt = await this.generateJWT(this.id, {
@@ -2288,6 +2359,50 @@ var RepoImpl = class {
     const raw = createBranchResponseSchema.parse(await response.json());
     return transformCreateBranchResult(raw);
   }
+  async createTag(options) {
+    const name = options?.name?.trim();
+    if (!name) {
+      throw new Error("createTag name is required");
+    }
+    if (name.startsWith("refs/")) {
+      throw new Error("createTag name must not start with refs/");
+    }
+    const target = options?.target?.trim();
+    if (!target) {
+      throw new Error("createTag target is required");
+    }
+    const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+    const jwt = await this.generateJWT(this.id, {
+      permissions: ["git:write"],
+      ttl
+    });
+    const response = await this.api.post(
+      { path: "repos/tags", body: { name, target } },
+      jwt
+    );
+    const raw = createTagResponseSchema.parse(await response.json());
+    return transformCreateTagResult(raw);
+  }
+  async deleteTag(options) {
+    const name = options?.name?.trim();
+    if (!name) {
+      throw new Error("deleteTag name is required");
+    }
+    if (name.startsWith("refs/")) {
+      throw new Error("deleteTag name must not start with refs/");
+    }
+    const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+    const jwt = await this.generateJWT(this.id, {
+      permissions: ["git:read", "git:write"],
+      ttl
+    });
+    const response = await this.api.delete(
+      { path: "repos/tags", body: { name } },
+      jwt
+    );
+    const raw = deleteTagResponseSchema.parse(await response.json());
+    return transformDeleteTagResult(raw);
+  }
   async restoreCommit(options) {
     const targetBranch = options?.targetBranch?.trim();
     if (!targetBranch) {