@pierre/storage 0.1.0 → 0.1.2

package/README.md

@@ -2,6 +2,14 @@
 
 Pierre Git Storage SDK for TypeScript/JavaScript applications.
 
+## End-to-End Smoke Test
+
+- `node packages/git-storage-sdk/tests/full-workflow.js -e production -s pierre -k /home/ian/pierre-prod-key.pem`  
+  Drives
+  the Pierre workflow via the SDK: creates a repository, writes commits, fetches branch and diff
+  data, and confirms storage APIs. Swap in your own private key path when running outside this
+  workstation and adjust `-e`/`-s` for non-production environments.
+
 ## Installation
 
 ```bash
@@ -431,7 +439,7 @@ interface CommitResult {
   refUpdate: RefUpdate;
 }
 
-interface ResetCommitOptions {
+interface RestoreCommitOptions {
   targetBranch: string;
   targetCommitSha: string;
   commitMessage?: string;
@@ -440,7 +448,7 @@ interface ResetCommitOptions {
   committer?: CommitSignature;
 }
 
-interface ResetCommitResult {
+interface RestoreCommitResult {
   commitSha: string;
   treeSha: string;
   targetBranch: string;
@@ -483,7 +491,7 @@ try {
 -
 ```
 
-- Mutating operations (commit builder, `resetCommit`) throw `RefUpdateError` when the backend
+- Mutating operations (commit builder, `restoreCommit`) throw `RefUpdateError` when the backend
   reports a ref failure. Inspect `error.status`, `error.reason`, `error.message`, and
   `error.refUpdate` for details.
 

package/dist/index.cjs

@@ -125,7 +125,7 @@ var commitPackCommitSchema = zod.z.object({
   pack_bytes: zod.z.number(),
   blob_count: zod.z.number()
 });
-var resetCommitCommitSchema = commitPackCommitSchema.omit({ blob_count: true });
+var restoreCommitCommitSchema = commitPackCommitSchema.omit({ blob_count: true });
 var refUpdateResultWithOptionalsSchema = zod.z.object({
   branch: zod.z.string().optional(),
   old_sha: zod.z.string().optional(),
@@ -138,16 +138,16 @@ var commitPackAckSchema = zod.z.object({
   commit: commitPackCommitSchema,
   result: refUpdateResultSchema
 });
-var resetCommitAckSchema = zod.z.object({
-  commit: resetCommitCommitSchema,
+var restoreCommitAckSchema = zod.z.object({
+  commit: restoreCommitCommitSchema,
   result: refUpdateResultSchema.extend({ success: zod.z.literal(true) })
 });
 var commitPackResponseSchema = zod.z.object({
   commit: commitPackCommitSchema.partial().optional().nullable(),
   result: refUpdateResultWithOptionalsSchema
 });
-var resetCommitResponseSchema = zod.z.object({
-  commit: resetCommitCommitSchema.partial().optional().nullable(),
+var restoreCommitResponseSchema = zod.z.object({
+  commit: restoreCommitCommitSchema.partial().optional().nullable(),
   result: refUpdateResultWithOptionalsSchema
 });
 var errorEnvelopeSchema = zod.z.object({
@@ -980,7 +980,7 @@ var STORAGE_BASE_URL = "code.storage";
 var API_VERSION = 1;
 var apiInstanceMap = /* @__PURE__ */ new Map();
 var DEFAULT_TOKEN_TTL_SECONDS = 60 * 60;
-var RESET_COMMIT_ALLOWED_STATUS = [
+var RESTORE_COMMIT_ALLOWED_STATUS = [
   400,
   // Bad Request - validation errors
   401,
@@ -1023,11 +1023,11 @@ function toRefUpdate2(result) {
     newSha: result.new_sha
   };
 }
-function buildResetCommitResult(ack) {
+function buildRestoreCommitResult(ack) {
   const refUpdate = toRefUpdate2(ack.result);
   if (!ack.result.success) {
     throw new RefUpdateError(
-      ack.result.message ?? `Reset commit failed with status ${ack.result.status}`,
+      ack.result.message ?? `Restore commit failed with status ${ack.result.status}`,
       {
         status: ack.result.status,
         message: ack.result.message,
@@ -1056,12 +1056,12 @@ function toPartialRefUpdate(branch, oldSha, newSha) {
   }
   return Object.keys(refUpdate).length > 0 ? refUpdate : void 0;
 }
-function parseResetCommitPayload(payload) {
-  const ack = resetCommitAckSchema.safeParse(payload);
+function parseRestoreCommitPayload(payload) {
+  const ack = restoreCommitAckSchema.safeParse(payload);
   if (ack.success) {
     return { ack: ack.data };
   }
-  const failure = resetCommitResponseSchema.safeParse(payload);
+  const failure = restoreCommitResponseSchema.safeParse(payload);
   if (failure.success) {
     const result = failure.data.result;
     return {
@@ -1074,7 +1074,7 @@ function parseResetCommitPayload(payload) {
   }
   return null;
 }
-function httpStatusToResetStatus(status) {
+function httpStatusToRestoreStatus(status) {
   switch (status) {
     case 409:
       return "conflict";
@@ -1328,23 +1328,23 @@ var RepoImpl = class {
     }
     return;
   }
-  async resetCommit(options) {
+  async restoreCommit(options) {
     const targetBranch = options?.targetBranch?.trim();
     if (!targetBranch) {
-      throw new Error("resetCommit targetBranch is required");
+      throw new Error("restoreCommit targetBranch is required");
     }
     if (targetBranch.startsWith("refs/")) {
-      throw new Error("resetCommit targetBranch must not include refs/ prefix");
+      throw new Error("restoreCommit targetBranch must not include refs/ prefix");
     }
     const targetCommitSha = options?.targetCommitSha?.trim();
     if (!targetCommitSha) {
-      throw new Error("resetCommit targetCommitSha is required");
+      throw new Error("restoreCommit targetCommitSha is required");
     }
     const commitMessage = options?.commitMessage?.trim();
     const authorName = options.author?.name?.trim();
     const authorEmail = options.author?.email?.trim();
     if (!authorName || !authorEmail) {
-      throw new Error("resetCommit author name and email are required");
+      throw new Error("restoreCommit author name and email are required");
     }
     const ttl = resolveCommitTtlSeconds(options);
     const jwt = await this.generateJWT(this.id, {
@@ -1370,24 +1370,28 @@ var RepoImpl = class {
       const committerName = options.committer.name?.trim();
       const committerEmail = options.committer.email?.trim();
       if (!committerName || !committerEmail) {
-        throw new Error("resetCommit committer name and email are required when provided");
+        throw new Error("restoreCommit committer name and email are required when provided");
       }
       metadata.committer = {
         name: committerName,
         email: committerEmail
       };
     }
-    const response = await this.api.post({ path: "repos/reset-commits", body: { metadata } }, jwt, {
-      allowedStatus: [...RESET_COMMIT_ALLOWED_STATUS]
-    });
+    const response = await this.api.post(
+      { path: "repos/restore-commit", body: { metadata } },
+      jwt,
+      {
+        allowedStatus: [...RESTORE_COMMIT_ALLOWED_STATUS]
+      }
+    );
     const payload = await response.json();
-    const parsed = parseResetCommitPayload(payload);
+    const parsed = parseRestoreCommitPayload(payload);
     if (parsed && "ack" in parsed) {
-      return buildResetCommitResult(parsed.ack);
+      return buildRestoreCommitResult(parsed.ack);
     }
     const failure = parsed && "failure" in parsed ? parsed.failure : void 0;
-    const status = failure?.status ?? httpStatusToResetStatus(response.status);
-    const message = failure?.message ?? `Reset commit failed with HTTP ${response.status}` + (response.statusText ? ` ${response.statusText}` : "");
+    const status = failure?.status ?? httpStatusToRestoreStatus(response.status);
+    const message = failure?.message ?? `Restore commit failed with HTTP ${response.status}` + (response.statusText ? ` ${response.statusText}` : "");
     throw new RefUpdateError(message, {
       status,
       refUpdate: failure?.refUpdate