@wix/auto_sdk_containers_projects 1.0.22 → 1.0.23

package/build/internal/cjs/index.d.ts

@@ -103,9 +103,12 @@ interface SaveProjectDesignSignature {
      * A `CHECKPOINT` message is then added to the conversation. If the checkpoint can't be added, the
      * design is still saved.
      *
-     * For projects whose `platform` is `HIMALAYA_MOBILE`, call
+     * For a new `HIMALAYA_MOBILE` project, call
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * and specify its returned `canonicalApp` when saving the design. For an already claimed project,
+     * call
      * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
-     * first, and specify the returned `canonicalApp`.
+     * and specify the returned `canonicalApp`.
      * @param - ID of the project whose design to save.
      * @param - ID of the release that the user is currently viewing.
      *
@@ -167,9 +170,14 @@ interface StartMobileBuildSignature {
      * [Get Latest Mobile Builds](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-latest-mobile-builds)
      * with `himalayaControlToken`.
      *
-     * For projects whose `platform` is `HIMALAYA_MOBILE`, call
+     * For a new `HIMALAYA_MOBILE` project, call
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * before starting a build. For an existing project, call
      * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
-     * first, and specify the returned `canonicalApp`.
+     * and specify the returned `canonicalApp`.
+     *
+     * If a build can't start for a platform, the response lists that platform in
+     * `failedPlatforms` while returning any builds that did start in `builds`.
      * @param - ID of the project to build.
      * @param - Platforms to build. One build is started for each platform.
      */
@@ -195,18 +203,11 @@ interface GetLatestMobileBuildsSignature {
 declare function claimHimalayaApp$1(httpClient: HttpClient): ClaimHimalayaAppSignature;
 interface ClaimHimalayaAppSignature {
     /**
-     * Claims the canonical Himalaya app for a NEW site-tenanted project, or returns the one already
-     * bound to it.
-     *
-     * This exists so the BROWSER never asserts the (MetaSite, project) pair to Himalaya. Containers
-     * is the authority on project -> MetaSite: it reads the project from its own store with a
-     * consistent read and takes the MetaSite from this call's identity context, then claims
-     * server-to-server with a site USER token minted for the initiating collaborator. Himalaya
-     * recognises that token as minted by THIS service and trusts the pair on that basis. A dashboard
-     * calling Himalaya directly could name another site's project UUID and reserve its global slug.
-     *
-     * Idempotent per pair: an already-claimed project returns its existing canonical app.
-     * @param - Site-tenanted Containers project to claim a Himalaya app for.
+     * Claims the app associated with a project, or retrieves its existing claim.
+     *
+     * An authorized site collaborator can call this method for a new `HIMALAYA_MOBILE` project
+     * before using its app. Repeating the call for the same project returns the same `canonicalApp`.
+     * @param - ID of the site project whose app to claim or retrieve.
      */
     (projectId: string): Promise<NonNullablePaths<ClaimHimalayaAppResponse, `authorizationVersion` | `metaSiteId` | `projectId` | `canonicalApp`, 0>>;
 }

package/build/internal/cjs/index.typings.d.ts

@@ -2363,7 +2363,9 @@ interface SaveProjectDesignRequest {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      * This isn't the app's ID.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
@@ -2558,7 +2560,9 @@ interface StartMobileBuildRequest {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
      * @maxLength 200
@@ -2771,26 +2775,26 @@ interface PlatformMobileBuilds {
 }
 interface ClaimHimalayaAppRequest {
     /**
-     * Site-tenanted Containers project to claim a Himalaya app for.
+     * ID of the site project whose app to claim or retrieve.
      * @format GUID
      */
     projectId: string;
 }
 interface ClaimHimalayaAppResponse {
-    /** Version of the authorization capability contract. Matches GetHimalayaAuthorizationResponse. */
+    /** Version of the response format. Currently always `1`. */
     authorizationVersion?: number;
     /**
-     * Trusted MetaSite selected from request identity context, never from the request body.
+     * ID of the Wix site that owns the project.
      * @format GUID
      */
     metaSiteId?: string;
     /**
-     * Site-tenanted Containers project the app is bound to.
+     * ID of the project the app is associated with.
      * @format GUID
      */
     projectId?: string;
     /**
-     * Canonical Himalaya app slug, newly claimed or already bound.
+     * Canonical app slug, newly claimed or already associated with the project.
      * @maxLength 200
      */
     canonicalApp?: string;
@@ -3008,9 +3012,12 @@ declare function regenerateProjectIcon(projectId: string, prompt: string): Promi
  * A `CHECKPOINT` message is then added to the conversation. If the checkpoint can't be added, the
  * design is still saved.
  *
- * For projects whose `platform` is `HIMALAYA_MOBILE`, call
+ * For a new `HIMALAYA_MOBILE` project, call
+ * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+ * and specify its returned `canonicalApp` when saving the design. For an already claimed project,
+ * call
  * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
- * first, and specify the returned `canonicalApp`.
+ * and specify the returned `canonicalApp`.
  * @param projectId - ID of the project whose design to save.
  * @param baseReleaseId - ID of the release that the user is currently viewing.
  *
@@ -3044,7 +3051,9 @@ interface SaveProjectDesignOptions {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      * This isn't the app's ID.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
@@ -3140,9 +3149,14 @@ declare function getHimalayaAuthorization(projectId: string): Promise<NonNullabl
  * [Get Latest Mobile Builds](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-latest-mobile-builds)
  * with `himalayaControlToken`.
  *
- * For projects whose `platform` is `HIMALAYA_MOBILE`, call
+ * For a new `HIMALAYA_MOBILE` project, call
+ * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+ * before starting a build. For an existing project, call
  * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
- * first, and specify the returned `canonicalApp`.
+ * and specify the returned `canonicalApp`.
+ *
+ * If a build can't start for a platform, the response lists that platform in
+ * `failedPlatforms` while returning any builds that did start in `builds`.
  * @param projectId - ID of the project to build.
  * @param platforms - Platforms to build. One build is started for each platform.
  * @public
@@ -3178,7 +3192,9 @@ interface StartMobileBuildOptions {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
      * @maxLength 200
@@ -3235,18 +3251,11 @@ interface GetLatestMobileBuildsOptions {
     himalayaControlToken?: string;
 }
 /**
- * Claims the canonical Himalaya app for a NEW site-tenanted project, or returns the one already
- * bound to it.
- *
- * This exists so the BROWSER never asserts the (MetaSite, project) pair to Himalaya. Containers
- * is the authority on project -> MetaSite: it reads the project from its own store with a
- * consistent read and takes the MetaSite from this call's identity context, then claims
- * server-to-server with a site USER token minted for the initiating collaborator. Himalaya
- * recognises that token as minted by THIS service and trusts the pair on that basis. A dashboard
- * calling Himalaya directly could name another site's project UUID and reserve its global slug.
+ * Claims the app associated with a project, or retrieves its existing claim.
  *
- * Idempotent per pair: an already-claimed project returns its existing canonical app.
- * @param projectId - Site-tenanted Containers project to claim a Himalaya app for.
+ * An authorized site collaborator can call this method for a new `HIMALAYA_MOBILE` project
+ * before using its app. Repeating the call for the same project returns the same `canonicalApp`.
+ * @param projectId - ID of the site project whose app to claim or retrieve.
  * @public
  * @documentationMaturity preview
  * @requiredField projectId

package/build/internal/cjs/meta.d.ts

@@ -2408,7 +2408,9 @@ interface SaveProjectDesignRequest {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      * This isn't the app's ID.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
@@ -2603,7 +2605,9 @@ interface StartMobileBuildRequest {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
      * @maxLength 200
@@ -2816,26 +2820,26 @@ interface PlatformMobileBuilds {
 }
 interface ClaimHimalayaAppRequest {
     /**
-     * Site-tenanted Containers project to claim a Himalaya app for.
+     * ID of the site project whose app to claim or retrieve.
      * @format GUID
      */
     projectId: string;
 }
 interface ClaimHimalayaAppResponse {
-    /** Version of the authorization capability contract. Matches GetHimalayaAuthorizationResponse. */
+    /** Version of the response format. Currently always `1`. */
     authorizationVersion?: number;
     /**
-     * Trusted MetaSite selected from request identity context, never from the request body.
+     * ID of the Wix site that owns the project.
      * @format GUID
      */
     metaSiteId?: string;
     /**
-     * Site-tenanted Containers project the app is bound to.
+     * ID of the project the app is associated with.
      * @format GUID
      */
     projectId?: string;
     /**
-     * Canonical Himalaya app slug, newly claimed or already bound.
+     * Canonical app slug, newly claimed or already associated with the project.
      * @maxLength 200
      */
     canonicalApp?: string;

package/build/internal/es/index.d.mts

@@ -103,9 +103,12 @@ interface SaveProjectDesignSignature {
      * A `CHECKPOINT` message is then added to the conversation. If the checkpoint can't be added, the
      * design is still saved.
      *
-     * For projects whose `platform` is `HIMALAYA_MOBILE`, call
+     * For a new `HIMALAYA_MOBILE` project, call
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * and specify its returned `canonicalApp` when saving the design. For an already claimed project,
+     * call
      * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
-     * first, and specify the returned `canonicalApp`.
+     * and specify the returned `canonicalApp`.
      * @param - ID of the project whose design to save.
      * @param - ID of the release that the user is currently viewing.
      *
@@ -167,9 +170,14 @@ interface StartMobileBuildSignature {
      * [Get Latest Mobile Builds](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-latest-mobile-builds)
      * with `himalayaControlToken`.
      *
-     * For projects whose `platform` is `HIMALAYA_MOBILE`, call
+     * For a new `HIMALAYA_MOBILE` project, call
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * before starting a build. For an existing project, call
      * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
-     * first, and specify the returned `canonicalApp`.
+     * and specify the returned `canonicalApp`.
+     *
+     * If a build can't start for a platform, the response lists that platform in
+     * `failedPlatforms` while returning any builds that did start in `builds`.
      * @param - ID of the project to build.
      * @param - Platforms to build. One build is started for each platform.
      */
@@ -195,18 +203,11 @@ interface GetLatestMobileBuildsSignature {
 declare function claimHimalayaApp$1(httpClient: HttpClient): ClaimHimalayaAppSignature;
 interface ClaimHimalayaAppSignature {
     /**
-     * Claims the canonical Himalaya app for a NEW site-tenanted project, or returns the one already
-     * bound to it.
-     *
-     * This exists so the BROWSER never asserts the (MetaSite, project) pair to Himalaya. Containers
-     * is the authority on project -> MetaSite: it reads the project from its own store with a
-     * consistent read and takes the MetaSite from this call's identity context, then claims
-     * server-to-server with a site USER token minted for the initiating collaborator. Himalaya
-     * recognises that token as minted by THIS service and trusts the pair on that basis. A dashboard
-     * calling Himalaya directly could name another site's project UUID and reserve its global slug.
-     *
-     * Idempotent per pair: an already-claimed project returns its existing canonical app.
-     * @param - Site-tenanted Containers project to claim a Himalaya app for.
+     * Claims the app associated with a project, or retrieves its existing claim.
+     *
+     * An authorized site collaborator can call this method for a new `HIMALAYA_MOBILE` project
+     * before using its app. Repeating the call for the same project returns the same `canonicalApp`.
+     * @param - ID of the site project whose app to claim or retrieve.
      */
     (projectId: string): Promise<NonNullablePaths<ClaimHimalayaAppResponse, `authorizationVersion` | `metaSiteId` | `projectId` | `canonicalApp`, 0>>;
 }

package/build/internal/es/index.typings.d.mts

@@ -2363,7 +2363,9 @@ interface SaveProjectDesignRequest {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      * This isn't the app's ID.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
@@ -2558,7 +2560,9 @@ interface StartMobileBuildRequest {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
      * @maxLength 200
@@ -2771,26 +2775,26 @@ interface PlatformMobileBuilds {
 }
 interface ClaimHimalayaAppRequest {
     /**
-     * Site-tenanted Containers project to claim a Himalaya app for.
+     * ID of the site project whose app to claim or retrieve.
      * @format GUID
      */
     projectId: string;
 }
 interface ClaimHimalayaAppResponse {
-    /** Version of the authorization capability contract. Matches GetHimalayaAuthorizationResponse. */
+    /** Version of the response format. Currently always `1`. */
     authorizationVersion?: number;
     /**
-     * Trusted MetaSite selected from request identity context, never from the request body.
+     * ID of the Wix site that owns the project.
      * @format GUID
      */
     metaSiteId?: string;
     /**
-     * Site-tenanted Containers project the app is bound to.
+     * ID of the project the app is associated with.
      * @format GUID
      */
     projectId?: string;
     /**
-     * Canonical Himalaya app slug, newly claimed or already bound.
+     * Canonical app slug, newly claimed or already associated with the project.
      * @maxLength 200
      */
     canonicalApp?: string;
@@ -3008,9 +3012,12 @@ declare function regenerateProjectIcon(projectId: string, prompt: string): Promi
  * A `CHECKPOINT` message is then added to the conversation. If the checkpoint can't be added, the
  * design is still saved.
  *
- * For projects whose `platform` is `HIMALAYA_MOBILE`, call
+ * For a new `HIMALAYA_MOBILE` project, call
+ * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+ * and specify its returned `canonicalApp` when saving the design. For an already claimed project,
+ * call
  * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
- * first, and specify the returned `canonicalApp`.
+ * and specify the returned `canonicalApp`.
  * @param projectId - ID of the project whose design to save.
  * @param baseReleaseId - ID of the release that the user is currently viewing.
  *
@@ -3044,7 +3051,9 @@ interface SaveProjectDesignOptions {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      * This isn't the app's ID.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
@@ -3140,9 +3149,14 @@ declare function getHimalayaAuthorization(projectId: string): Promise<NonNullabl
  * [Get Latest Mobile Builds](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-latest-mobile-builds)
  * with `himalayaControlToken`.
  *
- * For projects whose `platform` is `HIMALAYA_MOBILE`, call
+ * For a new `HIMALAYA_MOBILE` project, call
+ * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+ * before starting a build. For an existing project, call
  * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
- * first, and specify the returned `canonicalApp`.
+ * and specify the returned `canonicalApp`.
+ *
+ * If a build can't start for a platform, the response lists that platform in
+ * `failedPlatforms` while returning any builds that did start in `builds`.
  * @param projectId - ID of the project to build.
  * @param platforms - Platforms to build. One build is started for each platform.
  * @public
@@ -3178,7 +3192,9 @@ interface StartMobileBuildOptions {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
      * @maxLength 200
@@ -3235,18 +3251,11 @@ interface GetLatestMobileBuildsOptions {
     himalayaControlToken?: string;
 }
 /**
- * Claims the canonical Himalaya app for a NEW site-tenanted project, or returns the one already
- * bound to it.
- *
- * This exists so the BROWSER never asserts the (MetaSite, project) pair to Himalaya. Containers
- * is the authority on project -> MetaSite: it reads the project from its own store with a
- * consistent read and takes the MetaSite from this call's identity context, then claims
- * server-to-server with a site USER token minted for the initiating collaborator. Himalaya
- * recognises that token as minted by THIS service and trusts the pair on that basis. A dashboard
- * calling Himalaya directly could name another site's project UUID and reserve its global slug.
+ * Claims the app associated with a project, or retrieves its existing claim.
  *
- * Idempotent per pair: an already-claimed project returns its existing canonical app.
- * @param projectId - Site-tenanted Containers project to claim a Himalaya app for.
+ * An authorized site collaborator can call this method for a new `HIMALAYA_MOBILE` project
+ * before using its app. Repeating the call for the same project returns the same `canonicalApp`.
+ * @param projectId - ID of the site project whose app to claim or retrieve.
  * @public
  * @documentationMaturity preview
  * @requiredField projectId

package/build/internal/es/meta.d.mts

@@ -2408,7 +2408,9 @@ interface SaveProjectDesignRequest {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      * This isn't the app's ID.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
@@ -2603,7 +2605,9 @@ interface StartMobileBuildRequest {
     himalayaControlToken: string;
     /**
      * Canonical slug of the project's app, exactly as returned in `canonicalApp` by
-     * [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization).
+     * [Claim Himalaya App](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/claim-himalaya-app)
+     * for a new project or [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization)
+     * for an already claimed project.
      *
      * Required when the project's `platform` is `HIMALAYA_MOBILE`. The value is verified on the server.
      * @maxLength 200
@@ -2816,26 +2820,26 @@ interface PlatformMobileBuilds {
 }
 interface ClaimHimalayaAppRequest {
     /**
-     * Site-tenanted Containers project to claim a Himalaya app for.
+     * ID of the site project whose app to claim or retrieve.
      * @format GUID
      */
     projectId: string;
 }
 interface ClaimHimalayaAppResponse {
-    /** Version of the authorization capability contract. Matches GetHimalayaAuthorizationResponse. */
+    /** Version of the response format. Currently always `1`. */
     authorizationVersion?: number;
     /**
-     * Trusted MetaSite selected from request identity context, never from the request body.
+     * ID of the Wix site that owns the project.
      * @format GUID
      */
     metaSiteId?: string;
     /**
-     * Site-tenanted Containers project the app is bound to.
+     * ID of the project the app is associated with.
      * @format GUID
      */
     projectId?: string;
     /**
-     * Canonical Himalaya app slug, newly claimed or already bound.
+     * Canonical app slug, newly claimed or already associated with the project.
      * @maxLength 200
      */
     canonicalApp?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/auto_sdk_containers_projects",
-  "version": "1.0.22",
+  "version": "1.0.23",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -50,5 +50,5 @@
       "fqdn": "wix.containers.projects.v1.project"
     }
   },
-  "falconPackageHash": "355bf4836af856b9442409f249277646ed83c39fe98aa7ee6585ca72"
+  "falconPackageHash": "1d9ecc6e61d758dfec953c8cd425fb869e5b14973bbaa1405ac208a7"
 }