Enthusiast

Medusa Enthusiast Plugin

A Medusa plugin that integrates with Enthusiast.

Prerequisite

1. Access to Enthusiast instance
2. Enthusiast with configured Medusa integration Docs
3. Medusa v2.x
4. Node.js >= 20

Installation

Install the plugin in your Medusa project:

npm install @upsidelab/medusa-plugin-enthusiast

Configuration

Environment Variables

Set you .env file in project root directory:

1ENTHUSIAST_API_URL=http://localhost:10000
2ENTHUSIAST_WS_URL=ws://localhost:10000
3ENTHUSIAST_SERVICE_ACCOUNT_TOKEN=<generated-service-account-token>
4ENTHUSIAST_INTEGRATION_NAME=Medusa
5ENTHUSIAST_MEDUSA_BACKEND_URL=http://host.docker.internal:9000
6ENTHUSIAST_MEDUSA_ADMIN_URL=http://localhost:9000

• ENTHUSIAST_API_URL: Your Enthusiast instance base API url.
• ENTHUSIAST_WS_URL: Your Enthusiast instance base WS url.
• ENTHUSIAST_SERVICE_ACCOUNT_TOKEN: Your Enthusiast admin service account's token.
• ENTHUSIAST_INTEGRATION_NAME: Your Enthusiast instance Medusa integration name.
• ENTHUSIAST_MEDUSA_BACKEND_URL(Optional): Your medusa backend url, where Enthusiast can send request to (default is set to http://host.docker.internal:9000 for local docker development or admin.backendUrl is set)
• ENTHUSIAST_MEDUSA_ADMIN_URL(Optional): Your medusa admin url (default is set to http://localhost:9000)

Enable plugin in Medusa

Add below entry to your plugins array:

medusa-config.ts

1{
2  resolve: "@upsidelab/medusa-plugin-enthusiast",
3  options: {
4        enthusiastApiUrl: process.env.ENTHUSIAST_API_URL,
5        enthusiastWSUrl: process.env.ENTHUSIAST_WS_URL,
6        enthusiastServiceAccountToken: process.env.ENTHUSIAST_SERVICE_ACCOUNT_TOKEN,
7        enthusiastMedusaIntegrationName: process.env.ENTHUSIAST_INTEGRATION_NAME,
8        medusaBackendUrl: process.env.ENTHUSIAST_MEDUSA_BACKEND_URL,
9        medusaAdminUrl: process.env.ENTHUSIAST_MEDUSA_ADMIN_URL,
10      }
11}

Run Database Migrations

After installing and configuring the plugin, run database migrations to create the required tables:

npx medusa db:migrate

Generating service account key

Run command on your Enthusiast instance or go to Manage -> Service accounts in Enthusiast to generate Admin permission service account token. Command:

python manage.py createadminserviceaccount -n <name of your integration>

Usage

Once installed and configured, you can access the Enthusiast plugin in your Medusa Admin:

• Main Enthusiast Page: Navigate to the "Enthusiast" section in the admin sidebar
• Settings: Go to Settings -> Enthusiast to manage datasets and configurations