Auth Server Setup

This guide will walk you through setting up Melody Auth in both Cloudflare (remote/production or local/development) and Node.js environments.

Cloudflare Remote/Production Environment

1. Cloudflare Account Setup

Sign up for a Cloudflare account if you don't have one already.
Install Wrangler CLI and Authenticate:
```
npx wrangler
wrangler login
```

2. Cloudflare Resource Creation

In your Cloudflare dashboard:

Create a Worker:
- Go to "Compute(Workers)" -> "Workers & Pages" -> Click "Create" button
- Name the worker "melody-auth"
- After creation, open the worker -> "Settings" -> "Variables and Secrets"
- Add a variable named "AUTH_SERVER_URL" with the value set to your worker's URL (e.g., https://melody-auth.[your-account-name].workers.dev)
Create a D1 Database:
- Go to "Storage & Databases" -> "D1 SQL Database"
- Click "Create" button
Create a KV Storage:
- Go to "Storage & Databases" -> "KV"
- Click "Create" button

3. Cloudflare Worker Secrets Setup

In your Cloudflare dashboard:

Go to "Compute(Workers)" -> "Workers & Pages"
Select your "melody-auth" worker
Click on "Settings" -> "Variables and Secrets"
Include the required environment variables for any email, SMS, or social sign-in providers you plan to use.
Define an environment variable “ENVIRONMENT” and ensure it is set to a value other than “dev”.

4. Project Setup

Clone the Repository:

git clone git@github.com:ValueMelody/melody-auth.git
cd melody-auth
npm install
npm run build

Configure server/wrangler.toml: Replace the KV and D1 IDs with the resources you created:

[[kv_namespaces]]
binding = "KV"
id = "your_kv_namespace_id"

[[d1_databases]]
binding = "DB"
database_name = "melody-auth"
database_id = "your_d1_database_id"

5. Initial Deployment

Run the following commands

cd server
npm run prod:secret:generate
npm run prod:migration:apply
npm run prod:deploy

Now you are all set, you can verify your deployment by accessing: [your_worker_url]/.well-known/openid-configuration

6.Future Deployments

To pull the latest code and redeploy:

git pull origin main
cd server
npm run prod:migration:apply # If there are new migrations
npm run prod:deploy

Cloudflare Local/Development Environment

To set up your local development environment, follow these steps:

git clone git@github.com:ValueMelody/melody-auth.git
cd melody-auth
npm install
npm run build

cd server
cp .dev.vars.example .dev.vars
# Include the required environment variables for any email, SMS, or social sign-in providers you plan to use.
# Make sure the environment variable "ENVIRONMENT" is set to "dev" for your local environment.

npm run dev:secret:generate
npm run dev:migration:apply
npm run dev:start

Cloudflare Multiple Remote Environments

When managing several remote environments (e.g., dev, demo, QA, staging, production) on Cloudflare, you can follow these steps:

Provision Resources:
Create the Worker, D1, and KV resources for your new environment via the Cloudflare dashboard.
Duplicate the Configuration File:
Copy an existing toml file (such as server/wrangler.toml or server/demo.wrangler.toml) and rename it to something like [envName].wrangler.toml.
Update Resource Identifiers:
Edit your new [envName].wrangler.toml file to replace the resource names, KV ID, and D1 ID with those corresponding to your newly created resources.
Generate Secrets:
Run the secret generation script using your new configuration file:
```
node ./src/scripts/generate-secret.cjs prod [envName].wrangler.toml
```
Apply D1 Migrations:
Execute the D1 migration command for your new environment's D1 resource:
```
wrangler d1 migrations apply [d1 name for your new environment] --remote
```

Deploy the Worker:
Build and deploy your Worker with the new environment's name:

npm run build && wrangler deploy --minify src/index.tsx --config [envName].wrangler.toml

Begin by setting up your PostgreSQL and Redis servers, and ensure you have the connection strings ready for integration. Please also ensure you are using Node.js version 20.05 or higher for compatibility.

2. Project setup

git clone git@github.com:ValueMelody/melody-auth.git
cd melody-auth
npm install
npm run build

cd server
cp .dev.vars.example .dev.vars
# Fill in PostgreSQL & Redis connection strings
# Include the required environment variables for any email, SMS, or social sign-in providers you plan to use.
# Make sure the environment variable "ENVIRONMENT" is set to "dev" for your local environment.

npm run node:secret:generate
npm run node:migration:apply
npm run node:dev

This starts the server in development mode using Node.js, connected to your local or remote databases.

3. Production Build

To build and run in production:

# Make sure the environment variable "ENVIRONMENT" is set to a value other than "dev" for your production build.
cd server
npm run node:build
npm run node:start

4.Future Deployments