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/admin/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/admin/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/admin/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