@stapel/listings-react 0.7.0 → 0.8.1

package/manifest.json

@@ -1,10 +1,10 @@
 {
   "$generated": "by scripts/gen-manifest.mjs — do not edit; drift-gated (pnpm gen:manifest:check)",
   "package": "@stapel/listings-react",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "backend": {
     "module": "stapel-listings",
-    "contract": ">=0.7 <0.8"
+    "contract": ">=0.9 <0.10"
   },
   "layers": [
     "api",
@@ -19,119 +19,119 @@
     "listings_api_v1_listings_archive_create": {
       "method": "POST",
       "path": "/listings/api/v1/listings/{id}/archive/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "ListingActionResponse"
     },
     "listings_api_v1_listings_complete_create": {
       "method": "POST",
       "path": "/listings/api/v1/listings/{id}/complete/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "ListingActionResponse"
     },
     "listings_api_v1_listings_create": {
       "method": "POST",
       "path": "/listings/api/v1/listings/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": "ListingDraft",
       "response": "ListingDraft"
     },
     "listings_api_v1_listings_destroy": {
       "method": "DELETE",
       "path": "/listings/api/v1/listings/{id}/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "DeleteResponse"
     },
     "listings_api_v1_listings_favorite_create": {
       "method": "POST",
       "path": "/listings/api/v1/listings/{id}/favorite/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "FavoriteToggleResponse"
     },
     "listings_api_v1_listings_list": {
       "method": "GET",
       "path": "/listings/api/v1/listings/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "PaginatedListingCardList"
     },
     "listings_api_v1_listings_my_counters_retrieve": {
       "method": "GET",
       "path": "/listings/api/v1/listings/my/counters/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "MyCountersResponse"
     },
     "listings_api_v1_listings_my_favorites_list": {
       "method": "GET",
       "path": "/listings/api/v1/listings/my/favorites/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "PaginatedListingCardList"
     },
     "listings_api_v1_listings_my_listings_list": {
       "method": "GET",
       "path": "/listings/api/v1/listings/my/listings/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "PaginatedMyListingCardList"
     },
     "listings_api_v1_listings_partial_update": {
       "method": "PATCH",
       "path": "/listings/api/v1/listings/{id}/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": "PatchedListingDraft",
       "response": "ListingDraft"
     },
     "listings_api_v1_listings_publish_create": {
       "method": "POST",
       "path": "/listings/api/v1/listings/{id}/publish/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "PublishResponse"
     },
     "listings_api_v1_listings_retrieve": {
       "method": "GET",
       "path": "/listings/api/v1/listings/{id}/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "ListingDetail"
     },
     "listings_api_v1_listings_save_draft_create": {
       "method": "POST",
       "path": "/listings/api/v1/listings/{id}/save-draft/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "ListingDraft"
     },
     "listings_api_v1_listings_status_retrieve": {
       "method": "GET",
       "path": "/listings/api/v1/listings/{id}/status/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "ListingStatus"
     },
     "listings_api_v1_listings_unfavorite_create": {
       "method": "POST",
       "path": "/listings/api/v1/listings/{id}/unfavorite/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "FavoriteToggleResponse"
     },
     "listings_api_v1_listings_update": {
       "method": "PUT",
       "path": "/listings/api/v1/listings/{id}/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": "ListingDraft",
       "response": "ListingDraft"
     },
     "listings_api_v1_listings_validate_draft_retrieve": {
       "method": "GET",
       "path": "/listings/api/v1/listings/{id}/validate-draft/",
-      "tag": "Listings",
+      "tag": "listings",
       "request": null,
       "response": "ValidationBatchResult"
     }
@@ -507,6 +507,11 @@
       "params": [],
       "remediation": "retry"
     },
+    "error.403.listing_anonymous_not_allowed": {
+      "status": 403,
+      "params": [],
+      "remediation": "retry"
+    },
     "error.403.listing_not_owner": {
       "status": 403,
       "params": [],
@@ -705,7 +710,8 @@
       "description": "The plainest place to see the load-state discipline: 'you have not saved anything yet' and 'we could not load your favourites' are two arms, not one. Merging them is the substitution that turned a 5xx into an empty result page on 2026-08-09. A visitor makes no request at all and is shown ONE state — the reason plus the door — where the pane used to render a blocked notice with a spinner turning underneath it. The pager renders only when there is a page to go to.",
       "component": "FavoritesPane",
       "covers": [
-        "Favorites"
+        "Favorites",
+        "LISTINGS_ELEVATION_ACTIONS"
       ],
       "tokens": [
         "surface-raised"
@@ -803,6 +809,7 @@
     "error.401.unauthorized",
     "error.402.payment_required",
     "error.403.forbidden",
+    "error.403.listing_anonymous_not_allowed",
     "error.403.listing_not_owner",
     "error.403.network_blocked",
     "error.403.verification_enrollment_required",
@@ -838,10 +845,10 @@
     "listings.card.favorite_add",
     "listings.card.favorite_remove",
     "listings.card.no_photo",
-    "listings.card.open",
     "listings.card.photo_unavailable",
     "listings.card.price_absent",
     "listings.card.sign_in",
+    "listings.card.untitled",
     "listings.compose.auto_republish",
     "listings.compose.blocked.busy",
     "listings.compose.blocked.details_unavailable",
@@ -965,6 +972,7 @@
       "EMPTY_LOCATION",
       "Favorites",
       "IMAGES_FIELD",
+      "LISTINGS_ELEVATION_ACTIONS",
       "LISTINGS_ERRORS",
       "LISTINGS_ERROR_CODES",
       "LISTINGS_FLOWS",
@@ -1030,6 +1038,7 @@
       "useCompleteListing",
       "useCreateDraft",
       "useDeleteListing",
+      "useElevatableMandateGate",
       "useFavoriteListing",
       "useFavoriteToggle",
       "useFavorites",

package/nav-manifest.json

@@ -1,6 +1,6 @@
 {
   "package": "@stapel/listings-react",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "entries": [
     {
       "id": "listings.detail",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stapel/listings-react",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Headless React pair for stapel-listings: a typed client over the draft twin, the composer that turns a category schema into a submittable listing, and the owner's dashboard. Two independent axes are rendered as two — lifecycle `status` decides visibility and `moderation_status` decides nothing about it, so an edit to a live listing stays live and says 'under review' instead of vanishing. Feature values are drawn and mirrored by @stapel/attributes-react; photos arrive as an injected upload bag whose `refs` ARE `images_draft` and whose `settled` gates the submit; a publish refusal is routed onto the control that caused it by slug. Zero visual opinion in the main entry; an opt-in /default subpath ships the antd skin.",
   "license": "MIT",
   "repository": {
@@ -48,9 +48,9 @@
   ],
   "size-limit": [
     {
-      "name": "index — the headless pair (client + status axes + draft model + hooks): no antd",
+      "name": "index — the headless pair (client + status axes + draft model + hooks): no antd. Raised 11 -> 11.5 KB for the elevation gate (useElevatableMandateGate + core's useElevation): the anonymous arm can now mint an identity for a named action instead of refusing, and that is a state hook the gate did not previously carry",
       "path": "dist/index.js",
-      "limit": "11 KB"
+      "limit": "11.5 KB"
     },
     {
       "name": "default — the antd skin (card, detail, composer, dashboard, the four named slots and the delete confirmation) must stay out of the main bundle",
@@ -70,7 +70,7 @@
   ],
   "peerDependencies": {
     "@stapel/attributes-react": ">=0.1.0",
-    "@stapel/core": ">=0.18.1 <1.0.0",
+    "@stapel/core": ">=0.19.0 <1.0.0",
     "@stapel/currencies-react": ">=0.2.0",
     "@stapel/image": ">=0.2.0",
     "@stapel/tokens-antd": ">=0.7.0",
@@ -103,12 +103,12 @@
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
     "@stapel/attributes-react": "^0.3.1",
-    "@stapel/core": "^0.18.1",
+    "@stapel/core": "^0.20.0",
     "@stapel/currencies-react": "^0.2.0",
-    "@stapel/image": "^0.4.1",
+    "@stapel/image": "^0.4.2",
     "@stapel/showcase": "^0.3.0",
-    "@stapel/tokens": "^0.5.1",
-    "@stapel/tokens-antd": "^0.7.0"
+    "@stapel/tokens": "^0.6.0",
+    "@stapel/tokens-antd": "^0.8.0"
   },
   "engines": {
     "node": ">=22"

package/src/analytics/generated/events.json

@@ -1,7 +1,7 @@
 {
   "$generated": "by scripts/gen-events.mjs — do not edit; drift-gated (pnpm gen:events:check)",
   "package": "@stapel/listings-react",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "defined": [],
   "flows": []
 }

package/src/api/generated/schema.ts

@@ -12,12 +12,21 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticatedOrReadOnly`
          */
         get: operations["listings_api_v1_listings_list"];
         put?: never;
         /**
-         * @description Listings CRUD plus owner lifecycle actions and favorites.
+         * @description Open a draft — the first act of becoming a seller, so the guest
+         *     wall stands here and not only at ``publish``.
          *
          *     **Permissions:** `IsAuthenticatedOrReadOnly`
          */
@@ -38,6 +47,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticatedOrReadOnly`
          */
         get: operations["listings_api_v1_listings_retrieve"];
@@ -53,6 +70,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticatedOrReadOnly`
          */
         delete: operations["listings_api_v1_listings_destroy"];
@@ -61,6 +86,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticatedOrReadOnly`
          */
         patch: operations["listings_api_v1_listings_partial_update"];
@@ -78,6 +111,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticated`
          */
         post: operations["listings_api_v1_listings_archive_create"];
@@ -120,6 +161,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticated`
          */
         post: operations["listings_api_v1_listings_favorite_create"];
@@ -139,7 +188,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * @description Listings CRUD plus owner lifecycle actions and favorites.
+         * @description Put a listing in front of buyers — the act the wall is named for:
+         *     a seller nobody can reach again is not a seller.
          *
          *     **Permissions:** `IsAuthenticated`
          */
@@ -181,6 +231,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `AllowAny`
          */
         get: operations["listings_api_v1_listings_status_retrieve"];
@@ -204,6 +262,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticated`
          */
         post: operations["listings_api_v1_listings_unfavorite_create"];
@@ -223,6 +289,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticated`
          */
         get: operations["listings_api_v1_listings_validate_draft_retrieve"];
@@ -244,6 +318,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticated`
          */
         get: operations["listings_api_v1_listings_my_counters_retrieve"];
@@ -265,6 +347,14 @@ export interface paths {
         /**
          * @description Listings CRUD plus owner lifecycle actions and favorites.
          *
+         *     Read and write live in one class, so the guest wall
+         *     (:func:`anonymous_write_refusal`, the ``ALLOW_ANONYMOUS_WRITES`` switch)
+         *     is applied per ACTION and never as a class permission: an anonymous
+         *     session must keep browsing and keep its favorites, and only the
+         *     authorship actions — ``create``, ``update``/``partial_update``,
+         *     ``save-draft``, ``publish`` — are the ones that turn a caller into a
+         *     seller.
+         *
          *     **Permissions:** `IsAuthenticated`
          */
         get: operations["listings_api_v1_listings_my_favorites_list"];