docs: auth examples

docs/content/2.features/1.useMedusaClient.md

@@ -35,6 +35,19 @@ Authenticating users with `authenticate` method:
 ```vue
 <script lang="ts" setup>
   const client = useMedusaClient();
+
   await client.auth.authenticate({ email: '[email protected]', password: 'test1234' });
 </script>
 ```
+
+This will create a new cookie called `connect.sid` that will have a `httpOnly` flag set to true (which means that it is not accessible from the frontend JS code).
+
+You can now fetch the data about currently logged in user like following:
+
+```vue
+<script lang="ts" setup>
+  const client = useMedusaClient();
+
+  const { customer } = await client.auth.getSession()
+</script>
+```

docs/content/2.features/2.serverMedusaClient.md

@@ -42,3 +42,21 @@ Finally, let's fetch this data in our Vue components by using `$fetch` like foll
   const products = data.value.products
 </script>
 ```
+
+## Fetching data as authenticated user
+
+To fetch the data as authenticated user (for example to get the data about currently logged in user) on the server you need to pass the cookies that are send from the browser as custom headers to the method like following:
+
+```ts
+import { serverMedusaClient } from '#medusa/server'
+
+export default eventHandler(async (event) => {
+  const client = serverMedusaClient(event)
+
+  const { customer } = await client.auth.getSession({
+    Cookie: event.node.req.headers.cookie,
+  });
+
+  return customer
+})
+```

playground/server/api/customer.ts

@@ -0,0 +1,11 @@
+import { serverMedusaClient } from '#medusa/server'
+
+export default eventHandler(async (event) => {
+  const client = serverMedusaClient(event)
+
+  const { customer } = await client.auth.getSession({
+    Cookie: event.node.req.headers.cookie,
+  });
+
+  return customer
+})