Nuxt Medusa 模块使用教程

1. 项目介绍

Nuxt Medusa 是一个为 Nuxt.js 应用程序设计的 Medusa.js SDK 封装模块。它提供了对 Medusa API 的便捷访问，支持 TypeScript，并且与 Nuxt 3 兼容。通过此模块，开发者可以轻松地在 Nuxt 应用中集成 Medusa 服务，打造电商平台。

2. 项目快速启动

安装依赖

首先，你需要在你的 Nuxt 项目中添加 @nuxtjs/medusa 模块。

npx nuxi@latest module add medusa

配置环境变量

接下来，创建一个 .env 文件并在其中设置 MEDUSA_URL 环境变量：

MEDUSA_URL=http://localhost:9000

确保你的 Medusa 服务正在运行，且 URL 与 .env 文件中设置的一致。

初始化客户端

在你的 Nuxt 页面或组件中，你可以使用 useMedusaClient 组合函数来初始化客户端，并获取数据。

<script setup lang="ts">
import { useMedusaClient } from '@nuxtjs/medusa';

const client = useMedusaClient();
const { products } = await client.store.product.list();
</script>

在模板中展示产品列表：

<template>
  <div v-for="product in products" :key="product.id">
    {{ product.title }}
  </div>
</template>

3. 应用案例和最佳实践

集成 CORS

如果你的 Nuxt 项目和 Medusa 服务不在同一个域上，你可能需要配置 CORS。确保在 Medusa 的 medusa-config.js 文件中设置了 process.env.STORE_CORS 变量，以允许来自你的 Nuxt 项目的跨域请求。

// medusa-config.js
module.exports = {
  // ... 其他配置
  cors: {
    origin: process.env.STORE_CORS || 'http://localhost:3000',
    // ... 其他 CORS 配置
  },
};

API 路由使用

在 Nuxt 的 API 路由中，你可以使用 serverMedusaClient 来处理服务器端的请求。

// pages/api/products/[id].ts
import { defineEventHandler } from 'h3';
import { serverMedusaClient } from '@nuxtjs/medusa';

export default defineEventHandler(async (event) => {
  const { id } = event.context.params;
  const client = serverMedusaClient(event);
  const product = await client.products.retrieve(id);
  return product;
});

4. 典型生态项目

• Nuxt.js: 用于构建服务端渲染的 Vue 应用程序的框架。
• Medusa.js: 一个开源的电商后台解决方案，提供灵活的 API 来管理产品、订单、库存等。
• TypeScript: 在 Nuxt Medusa 中使用 TypeScript，以确保类型安全和更好的开发体验。

通过以上教程，你可以快速开始使用 Nuxt Medusa 模块，并在此基础上构建你的电商平台。