docs: updates following authentication flow changes (#8706)

* docs: updates following authentication flow changes

* generate sidebar

* added open api specs

* fix up OAS

* changes to existing pages

* change sidebar items

* update marketplace recipe

www/apps/api-reference/specs/store/components/schemas/AdminTaxRegion.yaml

@@ -87,11 +87,11 @@ properties:
     type: array
     description: The tax region's tax rates.
     items:
-      $ref: ./AdminTaxRate.yaml
+      type: object
   parent:
-    $ref: ./AdminTaxRegion.yaml
+    type: object
   children:
     type: array
     description: The tax region's children.
     items:
-      $ref: ./AdminTaxRegion.yaml
+      type: object

www/apps/api-reference/specs/store/components/schemas/AuthAdminSessionResponse.yaml

@@ -0,0 +1,10 @@
+type: object
+description: The authenticated user's details.
+x-schemaName: AuthAdminSessionResponse
+required:
+  - user
+properties:
+  user:
+    title: user
+    description: The logged-in user.
+    $ref: ./AdminUser.yaml

www/apps/api-reference/specs/store/components/schemas/AuthResponse.yaml

@@ -0,0 +1,10 @@
+type: object
+description: The authentication's details.
+x-schemaName: AuthResponse
+required:
+  - token
+properties:
+  token:
+    type: string
+    title: token
+    description: The JWT token used for registration or authentication.

www/apps/api-reference/specs/store/components/schemas/AuthStoreSessionResponse.yaml

@@ -0,0 +1,10 @@
+type: object
+description: The authenticated customer's details.
+x-schemaName: AuthStoreSessionResponse
+required:
+  - user
+properties:
+  user:
+    title: user
+    description: The logged-in customer.
+    $ref: ./StoreCustomer.yaml