@wix/auto_sdk_containers_projects 1.0.3 → 1.0.4

package/build/cjs/index.d.ts

@@ -1,6 +1,6 @@
 import { HttpClient, NonNullablePaths, MaybeContext, BuildRESTFunction } from '@wix/sdk-types';
-import { Project, ResumeProjectResponse, SaveProjectDesignOptions, SaveProjectDesignResponse, GetHimalayaAuthorizationResponse } from './index.typings.js';
-export { AccountInfo, ActionEvent, CreateAgentSessionRequest, CreateAgentSessionResponse, CreateProjectRequest, CreateProjectResponse, CursorPaging, CursorPagingMetadata, Cursors, DeleteProjectRequest, DeleteProjectResponse, DomainEvent, DomainEventBodyOneOf, EntityCreatedEvent, EntityDeletedEvent, EntityUpdatedEvent, GetHimalayaAuthorizationRequest, GetProjectRequest, GetProjectResponse, IdentificationData, IdentificationDataIdOneOf, ListProjectsForCurrentUserRequest, ListProjectsForCurrentUserResponse, ListProjectsOptions, ListProjectsRequest, ListProjectsResponse, MessageEnvelope, Platform, PlatformWithLiterals, ProjectPlanReady, ProjectResumeRequested, ProjectStartRequested, ProjectStatus, ProjectStatusWithLiterals, RefreshAgentSiteTokenRequest, RefreshAgentSiteTokenResponse, RegenerateProjectIconRequest, RegenerateProjectIconResponse, RegenerateProjectNameRequest, RegenerateProjectNameResponse, RestoreInfo, ResumeProjectRequest, SandboxStatus, SandboxStatusWithLiterals, SaveProjectDesignRequest, StartProjectRequest, StartProjectResponse, UpdateProject, UpdateProjectRequest, UpdateProjectResponse, WebhookIdentityType, WebhookIdentityTypeWithLiterals } from './index.typings.js';
+import { Project, ResumeProjectResponse, SaveProjectDesignOptions, SaveProjectDesignResponse, RestoreReleaseOptions, RestoreReleaseResponse, GetHimalayaAuthorizationResponse } from './index.typings.js';
+export { AccountInfo, ActionEvent, CreateAgentSessionRequest, CreateAgentSessionResponse, CreateProjectRequest, CreateProjectResponse, CursorPaging, CursorPagingMetadata, Cursors, DeleteProjectRequest, DeleteProjectResponse, DomainEvent, DomainEventBodyOneOf, EntityCreatedEvent, EntityDeletedEvent, EntityUpdatedEvent, GetHimalayaAuthorizationRequest, GetProjectRequest, GetProjectResponse, IdentificationData, IdentificationDataIdOneOf, ListProjectsForCurrentUserRequest, ListProjectsForCurrentUserResponse, ListProjectsOptions, ListProjectsRequest, ListProjectsResponse, MessageEnvelope, Platform, PlatformWithLiterals, ProjectPlanReady, ProjectResumeRequested, ProjectStartRequested, ProjectStatus, ProjectStatusWithLiterals, RefreshAgentSiteTokenRequest, RefreshAgentSiteTokenResponse, RegenerateProjectIconRequest, RegenerateProjectIconResponse, RegenerateProjectNameRequest, RegenerateProjectNameResponse, RestoreInfo, RestoreReleaseRequest, ResumeProjectRequest, SandboxStatus, SandboxStatusWithLiterals, SaveProjectDesignRequest, StartProjectRequest, StartProjectResponse, UpdateProject, UpdateProjectRequest, UpdateProjectResponse, WebhookIdentityType, WebhookIdentityTypeWithLiterals } from './index.typings.js';
 
 declare function getProject$1(httpClient: HttpClient): GetProjectSignature;
 interface GetProjectSignature {
@@ -27,14 +27,33 @@ interface SaveProjectDesignSignature {
      *
      * Synchronous: the Himalaya write completes before this call returns. Never touches the project's
      * sandbox, runs a build, or activates the app — the saved release stays a draft, so what the live
-     * app serves is unaffected. Persists nothing on our side: this creates no entity and posts no
-     * chat checkpoint.
+     * app serves is unaffected. Persists no entity of its own. When `conversation_id` is supplied it
+     * posts a CHECKPOINT message for the saved release into that conversation (best-effort — a chat
+     * failure never fails the save); omit it to skip the checkpoint.
      * @param - Project whose design is being saved. The caller must own it.
      * @param - The Himalaya release ID currently displayed by the client. The saved draft branches from
      * exactly this release, even when a newer release exists for the app.
      */
     (projectId: string, baseReleaseId: string, options?: NonNullablePaths<SaveProjectDesignOptions, `himalayaControlToken` | `tokensJson`, 0>): Promise<NonNullablePaths<SaveProjectDesignResponse, `himalayaReleaseId` | `previewToken`, 0>>;
 }
+declare function restoreRelease$1(httpClient: HttpClient): RestoreReleaseSignature;
+interface RestoreReleaseSignature {
+    /**
+     * Restores an earlier version by pointing the project's editable head at `release_id`: the client
+     * then previews that release and the next edit (design save or AI edit) branches from it. Pure
+     * project state — sets `head_release_id` and nothing in Himalaya: it does NOT activate the release,
+     * so the live app end-users run is untouched (a later publish/build is what carries head live).
+     *
+     * `release_id` is a Himalaya release id the caller already holds from the project's own release
+     * ledger, scoped to this project's app; the server stores it as head without re-reading Himalaya.
+     * When `conversation_id` is supplied, a CHECKPOINT message for the restored release is posted into
+     * it (best-effort — a chat failure never fails the restore); omit it to skip the checkpoint.
+     * @param - Project whose head is being moved. The caller must own it.
+     * @param - The Himalaya release to make the project's editable head. Not a GUID — a Himalaya release id
+     * (e.g. `rel-<hash>` / `<sha>-<hash>`), taken from the project's own release ledger.
+     */
+    (projectId: string, releaseId: string, options?: RestoreReleaseOptions): Promise<NonNullablePaths<RestoreReleaseResponse, `project.name` | `project.status` | `project.sandboxStatus` | `project.metaSiteIds` | `project.platform`, 1>>;
+}
 declare function getHimalayaAuthorization$1(httpClient: HttpClient): GetHimalayaAuthorizationSignature;
 interface GetHimalayaAuthorizationSignature {
     /**
@@ -48,6 +67,7 @@ interface GetHimalayaAuthorizationSignature {
 declare const getProject: MaybeContext<BuildRESTFunction<typeof getProject$1> & typeof getProject$1>;
 declare const resumeProject: MaybeContext<BuildRESTFunction<typeof resumeProject$1> & typeof resumeProject$1>;
 declare const saveProjectDesign: MaybeContext<BuildRESTFunction<typeof saveProjectDesign$1> & typeof saveProjectDesign$1>;
+declare const restoreRelease: MaybeContext<BuildRESTFunction<typeof restoreRelease$1> & typeof restoreRelease$1>;
 declare const getHimalayaAuthorization: MaybeContext<BuildRESTFunction<typeof getHimalayaAuthorization$1> & typeof getHimalayaAuthorization$1>;
 
-export { GetHimalayaAuthorizationResponse, Project, ResumeProjectResponse, SaveProjectDesignOptions, SaveProjectDesignResponse, getHimalayaAuthorization, getProject, resumeProject, saveProjectDesign };
+export { GetHimalayaAuthorizationResponse, Project, RestoreReleaseOptions, RestoreReleaseResponse, ResumeProjectResponse, SaveProjectDesignOptions, SaveProjectDesignResponse, getHimalayaAuthorization, getProject, restoreRelease, resumeProject, saveProjectDesign };

package/build/cjs/index.js

@@ -31,6 +31,7 @@ __export(index_exports, {
   listProjects: () => listProjects4,
   regenerateProjectIcon: () => regenerateProjectIcon4,
   regenerateProjectName: () => regenerateProjectName4,
+  restoreRelease: () => restoreRelease4,
   resumeProject: () => resumeProject4,
   saveProjectDesign: () => saveProjectDesign4,
   updateProject: () => updateProject4
@@ -284,6 +285,33 @@ function saveProjectDesign(payload) {
   }
   return __saveProjectDesign;
 }
+function restoreRelease(payload) {
+  function __restoreRelease({ host }) {
+    const metadata = {
+      entityFqdn: "wix.containers.projects.v1.project",
+      method: "POST",
+      methodFqn: "wix.containers.projects.v1.ContainersProjects.RestoreRelease",
+      packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
+      url: resolveWixContainersProjectsV1ContainersProjectsUrl({
+        protoPath: "/v1/projects/{projectId}/restore-release",
+        data: payload,
+        host
+      }),
+      data: payload,
+      transformResponse: (payload2) => (0, import_transform_paths.transformPaths)(payload2, [
+        {
+          transformFn: import_timestamp2.transformRESTTimestampToSDKTimestamp,
+          paths: TRANSFORM_PATHS_0
+        }
+      ])
+    };
+    return metadata;
+  }
+  return __restoreRelease;
+}
 function listProjects(payload) {
   function __listProjects({ host }) {
     const metadata = {
@@ -540,7 +568,8 @@ async function saveProjectDesign2(projectId, baseReleaseId, options) {
     baseReleaseId,
     tokensJson: options?.tokensJson,
     himalayaControlToken: options?.himalayaControlToken,
-    canonicalApp: options?.canonicalApp
+    canonicalApp: options?.canonicalApp,
+    conversationId: options?.conversationId
   });
   const reqOpts = saveProjectDesign(payload);
   sideEffects?.onSiteCall?.();
@@ -558,7 +587,8 @@ async function saveProjectDesign2(projectId, baseReleaseId, options) {
           baseReleaseId: "$[1]",
           tokensJson: "$[2].tokensJson",
           himalayaControlToken: "$[2].himalayaControlToken",
-          canonicalApp: "$[2].canonicalApp"
+          canonicalApp: "$[2].canonicalApp",
+          conversationId: "$[2].conversationId"
         },
         singleArgumentUnchanged: false
       },
@@ -568,6 +598,39 @@ async function saveProjectDesign2(projectId, baseReleaseId, options) {
     throw transformedError;
   }
 }
+async function restoreRelease2(projectId, releaseId, options) {
+  const { httpClient, sideEffects } = arguments[3];
+  const payload = (0, import_rename_all_nested_keys.renameKeysFromSDKRequestToRESTRequest)({
+    projectId,
+    releaseId,
+    himalayaControlToken: options?.himalayaControlToken,
+    conversationId: options?.conversationId
+  });
+  const reqOpts = restoreRelease(payload);
+  sideEffects?.onSiteCall?.();
+  try {
+    const result = await httpClient.request(reqOpts);
+    sideEffects?.onSuccess?.(result);
+    return (0, import_rename_all_nested_keys.renameKeysFromRESTResponseToSDKResponse)(result.data);
+  } catch (err) {
+    const transformedError = (0, import_transform_error.transformError)(
+      err,
+      {
+        spreadPathsToArguments: {},
+        explicitPathsToArguments: {
+          projectId: "$[0]",
+          releaseId: "$[1]",
+          himalayaControlToken: "$[2].himalayaControlToken",
+          conversationId: "$[2].conversationId"
+        },
+        singleArgumentUnchanged: false
+      },
+      ["projectId", "releaseId", "options"]
+    );
+    sideEffects?.onError?.(err);
+    throw transformedError;
+  }
+}
 async function listProjects2(options) {
   const { httpClient, sideEffects } = arguments[1];
   const payload = (0, import_rename_all_nested_keys.renameKeysFromSDKRequestToRESTRequest)({
@@ -681,6 +744,15 @@ function saveProjectDesign3(httpClient) {
     { httpClient }
   );
 }
+function restoreRelease3(httpClient) {
+  return (projectId, releaseId, options) => restoreRelease2(
+    projectId,
+    releaseId,
+    options,
+    // @ts-ignore
+    { httpClient }
+  );
+}
 function listProjects3(httpClient) {
   return (options) => listProjects2(
     options,
@@ -706,6 +778,7 @@ var resumeProject4 = /* @__PURE__ */ (0, import_rest_modules3.createRESTModule)(
 var regenerateProjectName4 = /* @__PURE__ */ (0, import_rest_modules3.createRESTModule)(regenerateProjectName3);
 var regenerateProjectIcon4 = /* @__PURE__ */ (0, import_rest_modules3.createRESTModule)(regenerateProjectIcon3);
 var saveProjectDesign4 = /* @__PURE__ */ (0, import_rest_modules3.createRESTModule)(saveProjectDesign3);
+var restoreRelease4 = /* @__PURE__ */ (0, import_rest_modules3.createRESTModule)(restoreRelease3);
 var listProjects4 = /* @__PURE__ */ (0, import_rest_modules3.createRESTModule)(listProjects3);
 var getHimalayaAuthorization4 = /* @__PURE__ */ (0, import_rest_modules3.createRESTModule)(getHimalayaAuthorization3);
 // Annotate the CommonJS export names for ESM import in node:
@@ -721,6 +794,7 @@ var getHimalayaAuthorization4 = /* @__PURE__ */ (0, import_rest_modules3.createR
   listProjects,
   regenerateProjectIcon,
   regenerateProjectName,
+  restoreRelease,
   resumeProject,
   saveProjectDesign,
   updateProject