@wix/himalaya-cli 0.1099.0 → 0.1100.0

package/dist/cli.mjs

@@ -4290,6 +4290,17 @@ var init_splash = __esm({
   }
 });
 
+// ../../core/dev-server/tier5-bundles-src/wix-sdk-auto-aliases.generated.mjs
+var AUTO_WIX_SDK;
+var init_wix_sdk_auto_aliases_generated = __esm({
+  "../../core/dev-server/tier5-bundles-src/wix-sdk-auto-aliases.generated.mjs"() {
+    "use strict";
+    AUTO_WIX_SDK = {
+      "@himalaya/wix-comments": { pkg: "comments", index: "stdlib/wix-sdk-auto/comments/index.generated.ts", curated: "comments-v1" }
+    };
+  }
+});
+
 // ../../core/dev-server/tier5-bundles-src/build-lib.mjs
 var build_lib_exports = {};
 __export(build_lib_exports, {
@@ -4882,6 +4893,7 @@ var _compilerP, __dirname, REPO_ROOT4, SDK, alias, sourceAliases, SRC_DIR, OUT_D
 var init_build_lib = __esm({
   "../../core/dev-server/tier5-bundles-src/build-lib.mjs"() {
     "use strict";
+    init_wix_sdk_auto_aliases_generated();
     __dirname = dirname8(fileURLToPath5(import.meta.url));
     REPO_ROOT4 = resolve8(__dirname, "../../..");
     SDK = (d) => resolve8(REPO_ROOT4, `stdlib/wix-sdk/${d}/src/index.ts`);
@@ -4973,7 +4985,6 @@ var init_build_lib = __esm({
       "@himalaya/wix-ecom": SDK("ecom"),
       "@himalaya/wix-redirects": SDK("redirects-v1"),
       "@himalaya/wix-blog": SDK("blog-v3"),
-      "@himalaya/wix-comments": SDK("comments-v1"),
       "@himalaya/wix-users": SDK("users"),
       "@himalaya/wix-new-releases": SDK("new-releases"),
       "@himalaya/wix-business-feed": SDK("business-feed"),
@@ -5021,6 +5032,10 @@ var init_build_lib = __esm({
       "@himalaya/wix-notifications": SDK("notifications-v3"),
       "@himalaya/wix-seo": SDK("seo-v1")
     };
+    for (const [key2, e] of Object.entries(AUTO_WIX_SDK)) {
+      if (key2 in alias) throw new Error(`build-lib.mjs: ${key2} is hand-listed AND in wix-sdk-auto-aliases.generated.mjs \u2014 delete the hand-listed entry`);
+      alias[key2] = resolve8(REPO_ROOT4, e.index);
+    }
     sourceAliases = Object.fromEntries(Object.entries(alias).flatMap(([name, target]) => [
       [name, target],
       [name.replace(/^@himalaya\//, "@wix/himalaya/"), target]
@@ -6741,7 +6756,6 @@ function walk(node, registry, path2, out2) {
 var SYSTEM_FONT_FAMILY, TONAL_ELEVATION_ALPHA;
 var init_tokens = __esm({
   "../../core/ts/src/tokens.ts"() {
-    "use strict";
     SYSTEM_FONT_FAMILY = "$system";
     TONAL_ELEVATION_ALPHA = [0, 0.05, 0.08, 0.11, 0.12, 0.14];
   }
@@ -6768,7 +6782,6 @@ function resolveTranslation(value, catalog, sourceCatalog) {
 var BINDING_SIGILS, BINDING_SIGIL_RE, TRANSLATION_PREFIX, TRANSLATION_KEY_RE;
 var init_bindings = __esm({
   "../../core/ts/src/bindings.ts"() {
-    "use strict";
     BINDING_SIGILS = ["service", "flag", "item", "t"];
     BINDING_SIGIL_RE = new RegExp(
       `^\\$(?:${BINDING_SIGILS.filter((s) => s !== "t").join("|")})\\b|^\\$t:`

package/guides/release-notes.md

@@ -14,6 +14,15 @@ areas, always in the same order, so you can skim for the one you care about.
 
 ---
 
+## 2026-09-28
+
+### Logic, data & SDKs
+
+- **`@himalaya/wix-comments` now exposes every `@wix/comments` module as a namespace**
+  (`comments`, `ratings`, `widgets`, `categories`, `commentContexts`, `contentRevisions`), called
+  with the REST request object — e.g. `comments.createComment({ comment })`. Existing imports are
+  unchanged. (#3476)
+
 ## 2026-09-25
 
 ### Preview, push & release

package/guides/sdk-reference.json

@@ -8411,7 +8411,7 @@
   },
   {
     "name": "@himalaya/wix-comments",
-    "source": "stdlib/wix-sdk/comments-v1/src/index.ts",
+    "source": "stdlib/wix-sdk-auto/comments/index.generated.ts",
     "description": "Comments on any resource",
     "api": [
       {
@@ -10240,12 +10240,24 @@
         "http": "POST /comments/v1/bulk/comments/reactions/get",
         "scope": "visitor"
       },
+      {
+        "name": "BLOG_COMMENTS_APP_ID",
+        "kind": "const",
+        "jsdoc": "",
+        "decl": "export const BLOG_COMMENTS_APP_ID = \"14bcded7-0066-7c35-14d7-466cb3f09103\";"
+      },
       {
         "name": "WixBlogCommentRow",
         "kind": "type",
         "jsdoc": "",
         "decl": "export type WixBlogCommentRow = {\n  id: string;\n  authorName: string;\n  text: string;\n  createdDate: string;\n};"
       },
+      {
+        "name": "blogCommentRow",
+        "kind": "function",
+        "jsdoc": "/** A created or listed comment as the blog screen's row. Accepts the curated and the auto-tier\n *  (`comments.createComment`) response shapes alike — both are the same REST wire object. */",
+        "decl": "export function blogCommentRow(comment: BlogCommentLike | undefined): WixBlogCommentRow;"
+      },
       {
         "name": "createBlogComment",
         "kind": "function",
@@ -10258,6 +10270,284 @@
         "jsdoc": "",
         "decl": "export async function listBlogComments(postId: string): Promise<WixBlogCommentRow[]>;",
         "http": "GET /comments/v1/comments/list-by-resource?{…}"
+      },
+      {
+        "name": "categories.createCategory",
+        "kind": "function",
+        "jsdoc": "/**\n * Creates a new category.\n *\n * @permissionId WIX_COMMENTS.CATEGORY_CREATE\n * @fqn wix.comments.categories.v1.CommentsCategories.CreateCategory\n *\n * POST /comments/v1/categories\n */",
+        "decl": "export function createCategory(req: CreateCategoryRequest = {} as CreateCategoryRequest, opts?: WixCallOptions): Promise<CreateCategoryResponse>;",
+        "http": "POST /comments/v1/categories"
+      },
+      {
+        "name": "categories.deleteCategory",
+        "kind": "function",
+        "jsdoc": "/**\n * Deletes a category.\n *\n * @permissionId WIX_COMMENTS.CATEGORY_DELETE\n * @fqn wix.comments.categories.v1.CommentsCategories.DeleteCategory\n *\n * DELETE /comments/v1/categories/{categoryId}\n */",
+        "decl": "export function deleteCategory(req: DeleteCategoryRequest, opts?: WixCallOptions): Promise<DeleteCategoryResponse>;",
+        "http": "DELETE /comments/v1/categories/{categoryId}"
+      },
+      {
+        "name": "categories.getCategory",
+        "kind": "function",
+        "jsdoc": "/**\n * Retrieves a category by ID.\n *\n * @permissionId WIX_COMMENTS.CATEGORY_READ\n * @fqn wix.comments.categories.v1.CommentsCategories.GetCategory\n *\n * GET /comments/v1/categories/{categoryId}\n */",
+        "decl": "export function getCategory(req: GetCategoryRequest, opts?: WixCallOptions): Promise<GetCategoryResponse>;",
+        "http": "GET /comments/v1/categories/{categoryId}"
+      },
+      {
+        "name": "categories.queryCategory",
+        "kind": "function",
+        "jsdoc": "/**\n * Creates a query to retrieve a list of comment categories.\n *\n * @permissionId WIX_COMMENTS.CATEGORY_READ\n * @fqn wix.comments.categories.v1.CommentsCategories.QueryCategory\n *\n * POST /comments/v1/categories/query\n */",
+        "decl": "export function queryCategory(req: QueryCategoryRequest = {} as QueryCategoryRequest, opts?: WixCallOptions): Promise<QueryCategoryResponse>;",
+        "http": "POST /comments/v1/categories/query"
+      },
+      {
+        "name": "categories.updateCategory",
+        "kind": "function",
+        "jsdoc": "/**\n * Updates a category.\n *\n * @permissionId WIX_COMMENTS.CATEGORY_EDIT\n * @fqn wix.comments.categories.v1.CommentsCategories.UpdateCategory\n *\n * PATCH /comments/v1/categories/{categoryId}\n */",
+        "decl": "export function updateCategory(req: UpdateCategoryRequest, opts?: WixCallOptions): Promise<UpdateCategoryResponse>;",
+        "http": "PATCH /comments/v1/categories/{categoryId}"
+      },
+      {
+        "name": "commentContexts.getCommentContext",
+        "kind": "function",
+        "jsdoc": "/**\n * Retrieves the comment permissions resolved for the current identity in the specified context.\n *\n * @permissionId WIX_COMMENTS.COMMENT_CONTEXT_READ\n * @fqn wix.comments.context.v1.CommentsContextHost.GetCommentContext\n *\n * GET /comments/v1/contexts/{appId}\n */",
+        "decl": "export function getCommentContext(req: GetCommentContextRequest, opts?: WixCallOptions): Promise<GetCommentContextResponse>;",
+        "http": "GET /comments/v1/contexts/{appId}"
+      },
+      {
+        "name": "comments.addCommentReaction",
+        "kind": "function",
+        "jsdoc": "/**\n * Adds the current identity's reaction to a comment.\n *\n * @scope visitor — an anonymous visitor session is enough.\n * @permissionId comments:v2:comment:add_comment_reaction\n * @fqn wix.comments.ng.v1.CommentsNg.AddCommentReaction\n *\n * POST /comments/v1/comments/{commentId}/reactions\n */",
+        "decl": "export function addCommentReaction(req: AddCommentReactionRequest, opts?: WixCallOptions): Promise<AddCommentReactionResponse>;",
+        "http": "POST /comments/v1/comments/{commentId}/reactions",
+        "scope": "visitor"
+      },
+      {
+        "name": "comments.bulkDeleteComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Deletes multiple comments.\n *\n * @permissionId WIX_COMMENTS.BULK_COMMENT_DELETE\n * @fqn wix.comments.ng.v1.CommentsNg.BulkDeleteComment\n *\n * PUT /comments/v1/bulk/comments/delete-by-filter\n */",
+        "decl": "export function bulkDeleteComment(req: BulkDeleteCommentRequest = {} as BulkDeleteCommentRequest, opts?: WixCallOptions): Promise<BulkDeleteCommentResponse>;",
+        "http": "PUT /comments/v1/bulk/comments/delete-by-filter"
+      },
+      {
+        "name": "comments.bulkGetCommentReactions",
+        "kind": "function",
+        "jsdoc": "/**\n * Retrieves reactions for multiple comments.\n *\n * @scope visitor — an anonymous visitor session is enough.\n * @permissionId comments:v2:comment:bulk_get_comment_reactions\n * @fqn wix.comments.ng.v1.CommentsNg.BulkGetCommentReactions\n *\n * POST /comments/v1/bulk/comments/reactions/get\n */",
+        "decl": "export function bulkGetCommentReactions(req: BulkGetCommentReactionsRequest = {} as BulkGetCommentReactionsRequest, opts?: WixCallOptions): Promise<BulkGetCommentReactionsResponse>;",
+        "http": "POST /comments/v1/bulk/comments/reactions/get",
+        "scope": "visitor"
+      },
+      {
+        "name": "comments.bulkHideComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Hides multiple comments. The comment status becomes `HIDDEN`.\n *\n * @permissionId WIX_COMMENTS.BULK_COMMENT_HIDE\n * @fqn wix.comments.ng.v1.CommentsNg.BulkHideComment\n *\n * PUT /comments/v1/bulk/comments/hide-by-filter\n */",
+        "decl": "export function bulkHideComment(req: BulkHideCommentRequest = {} as BulkHideCommentRequest, opts?: WixCallOptions): Promise<BulkHideCommentResponse>;",
+        "http": "PUT /comments/v1/bulk/comments/hide-by-filter"
+      },
+      {
+        "name": "comments.bulkModerateDraftContent",
+        "kind": "function",
+        "jsdoc": "/**\n * Moderates the draft content of multiple comments that match the specified filter.\n *\n * @permissionId WIX_COMMENTS.BULK_COMMENT_MODERATE_DRAFT_CONTENT\n * @fqn wix.comments.ng.v1.CommentsNg.BulkModerateDraftContent\n *\n * POST /comments/v1/bulk/comments/moderate-by-filter\n */",
+        "decl": "export function bulkModerateDraftContent(req: BulkModerateDraftContentRequest = {} as BulkModerateDraftContentRequest, opts?: WixCallOptions): Promise<BulkModerateDraftContentResponse>;",
+        "http": "POST /comments/v1/bulk/comments/moderate-by-filter"
+      },
+      {
+        "name": "comments.bulkMoveCommentByFilter",
+        "kind": "function",
+        "jsdoc": "/**\n * Moves multiple comments to another resource.\n *\n * @permissionId WIX_COMMENTS.BULK_COMMENT_MOVE\n * @fqn wix.comments.ng.v1.CommentsNg.BulkMoveCommentByFilter\n *\n * PUT /comments/v1/bulk/comments/move-by-filter\n */",
+        "decl": "export function bulkMoveCommentByFilter(req: BulkMoveCommentByFilterRequest = {} as BulkMoveCommentByFilterRequest, opts?: WixCallOptions): Promise<BulkMoveCommentByFilterResponse>;",
+        "http": "PUT /comments/v1/bulk/comments/move-by-filter"
+      },
+      {
+        "name": "comments.bulkPublishComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Publishes multiple comments with the `HIDDEN` status. The comment status becomes `PUBLISHED`.\n *\n * @permissionId WIX_COMMENTS.BULK_COMMENT_PUBLISH\n * @fqn wix.comments.ng.v1.CommentsNg.BulkPublishComment\n *\n * POST /comments/v1/bulk/comments/publish-by-filter\n */",
+        "decl": "export function bulkPublishComment(req: BulkPublishCommentRequest = {} as BulkPublishCommentRequest, opts?: WixCallOptions): Promise<BulkPublishCommentResponse>;",
+        "http": "POST /comments/v1/bulk/comments/publish-by-filter"
+      },
+      {
+        "name": "comments.countComments",
+        "kind": "function",
+        "jsdoc": "/**\n * Counts comments, given the specified filtering. Comments with the `HIDDEN` status are not included in the response.\n *\n * @permissionId WIX_COMMENTS.COMMENT_COUNT\n * @fqn wix.comments.ng.v1.CommentsNg.CountComments\n *\n * POST /comments/v1/comments/count\n */",
+        "decl": "export function countComments(req: CountCommentsRequest = {} as CountCommentsRequest, opts?: WixCallOptions): Promise<CountCommentsResponse>;",
+        "http": "POST /comments/v1/comments/count"
+      },
+      {
+        "name": "comments.createComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Creates a new comment.\n *\n * @scope member — requires a signed-in site member.\n * @permissionId WIX_COMMENTS.COMMENT_CREATE\n * @permissionId WIX_COMMENTS.COMMENT_OVERRIDE_AUTHOR\n * @permissionId WIX_COMMENTS.COMMENT_OVERRIDE_COMMENT_DATE\n * @fqn wix.comments.ng.v1.CommentsNg.CreateComment\n *\n * POST /comments/v1/comments\n */",
+        "decl": "export function createComment(req: CreateCommentRequest = {} as CreateCommentRequest, opts?: WixCallOptions): Promise<CreateCommentResponse>;",
+        "http": "POST /comments/v1/comments",
+        "scope": "member"
+      },
+      {
+        "name": "comments.deleteComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Deletes a comment.\n *\n * @permissionId WIX_COMMENTS.COMMENT_DELETE\n * @fqn wix.comments.ng.v1.CommentsNg.DeleteComment\n *\n * DELETE /comments/v1/comments/{commentId}\n */",
+        "decl": "export function deleteComment(req: DeleteCommentRequest, opts?: WixCallOptions): Promise<DeleteCommentResponse>;",
+        "http": "DELETE /comments/v1/comments/{commentId}"
+      },
+      {
+        "name": "comments.getComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Retrieves a comment.\n *\n * @permissionId WIX_COMMENTS.COMMENT_READ\n * @fqn wix.comments.ng.v1.CommentsNg.GetComment\n *\n * GET /comments/v1/comments/{commentId}\n */",
+        "decl": "export function getComment(req: GetCommentRequest, opts?: WixCallOptions): Promise<GetCommentResponse>;",
+        "http": "GET /comments/v1/comments/{commentId}"
+      },
+      {
+        "name": "comments.getCommentThread",
+        "kind": "function",
+        "jsdoc": "/**\n * Returns a thread of a comment or a reply.\n *\n * @permissionId WIX_COMMENTS.COMMENT_THREAD\n * @fqn wix.comments.ng.v1.CommentsNg.GetCommentThread\n *\n * GET /comments/v1/comments/{commentId}/thread\n */",
+        "decl": "export function getCommentThread(req: GetCommentThreadRequest, opts?: WixCallOptions): Promise<GetCommentThreadResponse>;",
+        "http": "GET /comments/v1/comments/{commentId}/thread"
+      },
+      {
+        "name": "comments.hideComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Hides a comment in a widget. The comment status becomes `HIDDEN`.\n *\n * @permissionId WIX_COMMENTS.COMMENT_HIDE\n * @fqn wix.comments.ng.v1.CommentsNg.HideComment\n *\n * PUT /comments/v1/comments/{commentId}/hide\n */",
+        "decl": "export function hideComment(req: HideCommentRequest, opts?: WixCallOptions): Promise<HideCommentResponse>;",
+        "http": "PUT /comments/v1/comments/{commentId}/hide"
+      },
+      {
+        "name": "comments.listCommentsByResource",
+        "kind": "function",
+        "jsdoc": "/**\n * Lists published comments and replies from a specified resource, such as a blog post.\n *\n * @permissionId WIX_COMMENTS.COMMENT_LIST\n * @fqn wix.comments.ng.v1.CommentsNg.ListCommentsByResource\n *\n * GET /comments/v1/comments/list-by-resource\n */",
+        "decl": "export function listCommentsByResource(req: ListCommentsByResourceRequest = {} as ListCommentsByResourceRequest, opts?: WixCallOptions): Promise<ListCommentsByResourceResponse>;",
+        "http": "GET /comments/v1/comments/list-by-resource"
+      },
+      {
+        "name": "comments.markComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Sets `marked` to `TRUE` to mark a comment.\n *\n * @permissionId WIX_COMMENTS.COMMENT_MARK\n * @fqn wix.comments.ng.v1.CommentsNg.MarkComment\n *\n * PUT /comments/v1/comments/{commentId}/mark\n */",
+        "decl": "export function markComment(req: MarkCommentRequest, opts?: WixCallOptions): Promise<MarkCommentResponse>;",
+        "http": "PUT /comments/v1/comments/{commentId}/mark"
+      },
+      {
+        "name": "comments.moderateDraftContent",
+        "kind": "function",
+        "jsdoc": "/**\n * Moderates the draft content of a comment.\n *\n * @permissionId WIX_COMMENTS.COMMENT_MODERATE_DRAFT_CONTENT\n * @fqn wix.comments.ng.v1.CommentsNg.ModerateDraftContent\n *\n * POST /comments/v1/comments/{commentId}/moderate\n */",
+        "decl": "export function moderateDraftContent(req: ModerateDraftContentRequest, opts?: WixCallOptions): Promise<ModerateDraftContentResponse>;",
+        "http": "POST /comments/v1/comments/{commentId}/moderate"
+      },
+      {
+        "name": "comments.publishComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Publishes a comment with the `HIDDEN` status. The comment status becomes `PUBLISHED`.\n *\n * @permissionId WIX_COMMENTS.COMMENT_PUBLISH\n * @fqn wix.comments.ng.v1.CommentsNg.PublishComment\n *\n * PUT /comments/v1/comments/{commentId}/publish\n */",
+        "decl": "export function publishComment(req: PublishCommentRequest, opts?: WixCallOptions): Promise<PublishCommentResponse>;",
+        "http": "PUT /comments/v1/comments/{commentId}/publish"
+      },
+      {
+        "name": "comments.queryComments",
+        "kind": "function",
+        "jsdoc": "/**\n * Creates a query to retrieve a list of comments.\n *\n * @permissionId WIX_COMMENTS.COMMENT_QUERY\n * @fqn wix.comments.ng.v1.CommentsNg.QueryComments\n *\n * POST /comments/v1/comments/query-cursor\n */",
+        "decl": "export function queryComments(req: QueryCommentsRequest = {} as QueryCommentsRequest, opts?: WixCallOptions): Promise<QueryCommentsResponse>;",
+        "http": "POST /comments/v1/comments/query-cursor"
+      },
+      {
+        "name": "comments.removeCommentReaction",
+        "kind": "function",
+        "jsdoc": "/**\n * Removes the current identity's reaction from a comment.\n *\n * @scope visitor — an anonymous visitor session is enough.\n * @permissionId comments:v2:comment:remove_comment_reaction\n * @fqn wix.comments.ng.v1.CommentsNg.RemoveCommentReaction\n *\n * POST /comments/v1/comments/{commentId}/reactions/remove\n */",
+        "decl": "export function removeCommentReaction(req: RemoveCommentReactionRequest, opts?: WixCallOptions): Promise<RemoveCommentReactionResponse>;",
+        "http": "POST /comments/v1/comments/{commentId}/reactions/remove",
+        "scope": "visitor"
+      },
+      {
+        "name": "comments.unmarkComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Sets `marked` to `FALSE` to unmark a comment.\n *\n * @permissionId WIX_COMMENTS.COMMENT_MARK\n * @fqn wix.comments.ng.v1.CommentsNg.UnmarkComment\n *\n * PUT /comments/v1/comments/{commentId}/unmark\n */",
+        "decl": "export function unmarkComment(req: UnmarkCommentRequest, opts?: WixCallOptions): Promise<UnmarkCommentResponse>;",
+        "http": "PUT /comments/v1/comments/{commentId}/unmark"
+      },
+      {
+        "name": "comments.updateComment",
+        "kind": "function",
+        "jsdoc": "/**\n * Updates a comment.\n *\n * @scope member — requires a signed-in site member.\n * @permissionId WIX_COMMENTS.COMMENT_UPDATE\n * @fqn wix.comments.ng.v1.CommentsNg.UpdateComment\n *\n * PATCH /comments/v1/comments/{commentId}\n */",
+        "decl": "export function updateComment(req: UpdateCommentRequest, opts?: WixCallOptions): Promise<UpdateCommentResponse>;",
+        "http": "PATCH /comments/v1/comments/{commentId}",
+        "scope": "member"
+      },
+      {
+        "name": "contentRevisions.listCommentContentRevisions",
+        "kind": "function",
+        "jsdoc": "/**\n * Retrieves saved previous content versions for a comment.\n *\n * @permissionId WIX_COMMENTS_CONTENT_REVISIONS.LIST_REVISIONS\n * @fqn wix.comments.revisions.v1.CommentContentRevisions.ListCommentContentRevisions\n *\n * GET /comments/v1/content-revisions/{commentId}\n */",
+        "decl": "export function listCommentContentRevisions(req: ListCommentContentRevisionsRequest, opts?: WixCallOptions): Promise<ListCommentContentRevisionsResponse>;",
+        "http": "GET /comments/v1/content-revisions/{commentId}"
+      },
+      {
+        "name": "ratings.createRating",
+        "kind": "function",
+        "jsdoc": "/**\n * Creates resource rating, if member/visitor has already created an rating it will be updated with provided value\n *\n * @fqn wix.comments.ratings.v1.CommentsRatings.CreateRating\n *\n * POST /comments/v1/comment/resource/{resourceRatingResourceId}/rating\n */",
+        "decl": "export function createRating(req: V1CreateRatingRequest, opts?: WixCallOptions): Promise<V1CreateRatingResponse>;",
+        "http": "POST /comments/v1/comment/resource/{resourceRatingResourceId}/rating"
+      },
+      {
+        "name": "ratings.getMyRating",
+        "kind": "function",
+        "jsdoc": "/**\n * Returns rating for current caller\n *\n * @fqn wix.comments.ratings.v1.CommentsRatings.GetMyRating\n *\n * GET /comments/v1/comment/resource/{resourceId}/rating/my\n */",
+        "decl": "export function getMyRating(req: V1GetMyRatingRequest, opts?: WixCallOptions): Promise<V1GetMyRatingResponse>;",
+        "http": "GET /comments/v1/comment/resource/{resourceId}/rating/my"
+      },
+      {
+        "name": "ratings.getResourceSummary",
+        "kind": "function",
+        "jsdoc": "/**\n * @fqn wix.comments.ratings.v1.CommentsRatings.GetResourceSummary\n */",
+        "decl": "export function getResourceSummary(req: GetResourceSummaryRequest, opts?: WixCallOptions): Promise<GetResourceSummaryResponse>;",
+        "http": "GET /comments/v1/comment/resource/{resourceId}/summary"
+      },
+      {
+        "name": "ratings.removeMyRating",
+        "kind": "function",
+        "jsdoc": "/**\n * Removes rating for current caller\n *\n * @fqn wix.comments.ratings.v1.CommentsRatings.RemoveMyRating\n *\n * DELETE /comments/v1/comment/resource/{resourceId}/rating/my\n */",
+        "decl": "export function removeMyRating(req: RemoveMyRatingRequest, opts?: WixCallOptions): Promise<RemoveMyRatingResponse>;",
+        "http": "DELETE /comments/v1/comment/resource/{resourceId}/rating/my"
+      },
+      {
+        "name": "widgets.createCommentsWidget",
+        "kind": "function",
+        "jsdoc": "/**\n * Creates a new CommentsWidget\n *\n * @permissionId WIX_COMMENTS.COMMENTS_WIDGET_CREATE\n * @fqn wix.comments.categories.v1.CommentsWidgetRegistry.CreateCommentsWidget\n *\n * POST /api/v1/comments/widgets\n */",
+        "decl": "export function createCommentsWidget(req: CreateCommentsWidgetRequest = {} as CreateCommentsWidgetRequest, opts?: WixCallOptions): Promise<CreateCommentsWidgetResponse>;",
+        "http": "POST /api/v1/comments/widgets"
+      },
+      {
+        "name": "widgets.deleteCommentsWidget",
+        "kind": "function",
+        "jsdoc": "/**\n * Delete a CommentsWidget\n *\n * @permissionId WIX_COMMENTS.COMMENTS_WIDGET_DELETE\n * @fqn wix.comments.categories.v1.CommentsWidgetRegistry.DeleteCommentsWidget\n *\n * DELETE /api/v1/comments/widgets/{commentsWidgetId}\n */",
+        "decl": "export function deleteCommentsWidget(req: DeleteCommentsWidgetRequest, opts?: WixCallOptions): Promise<DeleteCommentsWidgetResponse>;",
+        "http": "DELETE /api/v1/comments/widgets/{commentsWidgetId}"
+      },
+      {
+        "name": "widgets.getCommentsWidget",
+        "kind": "function",
+        "jsdoc": "/**\n * Get a CommentsWidget by id\n *\n * @permissionId WIX_COMMENTS.COMMENTS_WIDGET_READ\n * @fqn wix.comments.categories.v1.CommentsWidgetRegistry.GetCommentsWidget\n *\n * GET /api/v1/comments/widgets/{commentsWidgetId}\n */",
+        "decl": "export function getCommentsWidget(req: GetCommentsWidgetRequest, opts?: WixCallOptions): Promise<GetCommentsWidgetResponse>;",
+        "http": "GET /api/v1/comments/widgets/{commentsWidgetId}"
+      },
+      {
+        "name": "widgets.queryCommentsWidget",
+        "kind": "function",
+        "jsdoc": "/**\n * Query CommentsWidgets using [WQL - Wix Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language)\n *\n * @permissionId WIX_COMMENTS.COMMENTS_WIDGET_QUERY\n * @fqn wix.comments.categories.v1.CommentsWidgetRegistry.QueryCommentsWidget\n *\n * POST /api/v1/comments/widgets/query\n */",
+        "decl": "export function queryCommentsWidget(req: QueryCommentsWidgetRequest = {} as QueryCommentsWidgetRequest, opts?: WixCallOptions): Promise<QueryCommentsWidgetResponse>;",
+        "http": "POST /api/v1/comments/widgets/query"
+      },
+      {
+        "name": "widgets.queryCommentsWidgetResources",
+        "kind": "function",
+        "jsdoc": "/**\n * Returns all registered widget resource ids contained in metaSite\n *\n * @permissionId WIX_COMMENTS.COMMENTS_WIDGET_RESOURCES_QUERY\n * @fqn wix.comments.categories.v1.CommentsWidgetRegistry.QueryCommentsWidgetResources\n *\n * POST /api/v1/comments/widgets/resources/query\n */",
+        "decl": "export function queryCommentsWidgetResources(req: QueryCommentsWidgetResourcesRequest = {} as QueryCommentsWidgetResourcesRequest, opts?: WixCallOptions): Promise<QueryCommentsWidgetResourcesResponse>;",
+        "http": "POST /api/v1/comments/widgets/resources/query"
+      },
+      {
+        "name": "widgets.registerCommentsWidget",
+        "kind": "function",
+        "jsdoc": "/**\n * Registers CommentsWidget. Whenever a widget is loaded for the first time or its resourceId changes, it saves the new resource information about the widget\n *\n * @permissionId WIX_COMMENTS.COMMENTS_WIDGET_REGISTER\n * @fqn wix.comments.categories.v1.CommentsWidgetRegistry.RegisterCommentsWidget\n *\n * POST /api/v1/comments/widgets/register\n */",
+        "decl": "export function registerCommentsWidget(req: RegisterCommentsWidgetRequest = {} as RegisterCommentsWidgetRequest, opts?: WixCallOptions): Promise<RegisterCommentsWidgetResponse>;",
+        "http": "POST /api/v1/comments/widgets/register"
+      },
+      {
+        "name": "widgets.updateCommentsWidget",
+        "kind": "function",
+        "jsdoc": "/**\n * Update CommentsWidget, supports partial update Pass the latest `revision` for a successful update\n *\n * @permissionId WIX_COMMENTS.COMMENTS_WIDGET_EDIT\n * @fqn wix.comments.categories.v1.CommentsWidgetRegistry.UpdateCommentsWidget\n *\n * PATCH /api/v1/comments/widgets/{commentsWidgetId}\n */",
+        "decl": "export function updateCommentsWidget(req: UpdateCommentsWidgetRequest, opts?: WixCallOptions): Promise<UpdateCommentsWidgetResponse>;",
+        "http": "PATCH /api/v1/comments/widgets/{commentsWidgetId}"
       }
     ]
   },

package/guides/wix-api-usage.md

@@ -124,9 +124,42 @@ package `@himalaya/wix-<domain>` (unversioned name; the REST version is in the p
 > display helpers (note the V3 count field is `itemCounter`, not `numberOfProducts`).
 > `himi sdk wix-stores-collections` lists both surfaces. Pick the pair that matches your site's catalog version.
 
+## Namespaces: every module of a Wix package
+
+Some `@himalaya/wix-<pkg>` packages also export every module of the matching `@wix/<pkg>` npm
+package as a namespace — the auto tier (see [the codegen guide's "Auto tier"
+section](codegen-wix-sdk.md)). `@himalaya/wix-comments` is the first: it re-exports
+`@wix/comments`'s six modules as `comments`, `ratings`, `widgets`, `categories`,
+`commentContexts`, and `contentRevisions`.
+
+```ts
+import { comments } from "@himalaya/wix-comments";
+
+const { comment } = await comments.createComment({
+  comment: { appId, contextId, resourceId, content: { richContent } },
+});
+await comments.getComment({ commentId: comment.id });
+```
+
+Each namespace function takes **one argument: the REST request object exactly as the REST
+reference shows it** — path params are just fields of that object (`commentId` above becomes
+`/comments/v1/comments/{commentId}`, filled from `req.commentId`). Module and method names mirror
+`@wix/<pkg>` itself, so the REST docs for that package describe these functions directly. Every
+function also takes the same optional trailing `opts?: WixCallOptions` as the rest of the SDK.
+`@scope` appears on a function's JSDoc only where it has actually been observed (a curated
+domain's own scope, or an entry in `codegen/wix/auto/scopes.json` with evidence) — never guessed
+from Wix's own `@applicableIdentity` annotation, which does not mean what our visitor/member/owner
+vocabulary means.
+
+Namespaces are additive: existing flat imports from a package that already had one (e.g.
+`createBlogComment` from `@himalaya/wix-comments`) are unchanged and keep working side by side
+with the namespace form. Only packages listed in `codegen/wix/auto/tier.json` get a namespace —
+for everything else, the raw `wixApi.call` escape hatch below is still how you reach it.
+
 ## Raw wixApi for un-codegen'd endpoints
 
-For a Wix endpoint with no generated client:
+For a Wix endpoint with no generated client, and for any `@wix/<pkg>` not yet in the auto tier
+(`codegen/wix/auto/tier.json`):
 
 ```ts
 // call() returns the PARSED JSON body already (the bridge JSON.parses it; raw string if the body isn't JSON).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1099.0",
+  "version": "0.1100.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -67,5 +67,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "abd3482789935a7c1024e42bc726a232ef26e4612586b570d0b0fda7"
+  "falconPackageHash": "68cdc39c9c03d2468161a8b72b3300d9d3e61008b2edc6cb496f27e9"
 }