🎉 feat: Init drupal-vite package (#162)

* 🎉 feat: Init drupal-vite package

* ✨ feat: update vite plugin options

Author: enZane

packages/drupal-vite/.gitignore

@@ -0,0 +1,34 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+build
+
+# code coverage
+coverage
+*.lcov
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

packages/drupal-vite/README.md

@@ -0,0 +1,175 @@
+# drupal-vite
+
+> A Vite plugin that streamlines Drupal integration with your frontend projects.
+
+## Features
+
+- Simplified Drupal API connection setup
+- OAuth authentication handling
+- Preconfigured GraphQL client
+- Flexible environment configuration options
+- Custom GraphQL client extensions
+
+## Installation
+
+```bash
+# Using npm
+npm install drupal-vite
+
+# Using yarn
+yarn add drupal-vite
+
+# Using pnpm
+pnpm add drupal-vite
+
+# Using bun
+bun add drupal-vite
+```
+
+## Quick Start
+
+Add the plugin to your Vite configuration:
+
+```typescript
+import { defineConfig } from "vite";
+import { drupal } from "drupal-vite";
+
+export default defineConfig({
+  plugins: [
+    drupal(),
+    // other plugins...
+  ],
+});
+```
+
+## Configuration
+
+The plugin offers several configuration approaches to suit your workflow:
+
+### Using Environment Variables
+
+Set these environment variables in your project:
+
+```env
+DRUPAL_URL=https://your-drupal-site.com
+DRUPAL_CLIENT_ID=your-client-id
+DRUPAL_CLIENT_SECRET=your-client-secret
+```
+
+### Using Custom Environment Variables
+
+Reference your own environment variables:
+
+```typescript
+drupal({
+  drupalUrl: "MY_DRUPAL_URL", // Will use process.env.MY_DRUPAL_URL
+  simple_oauth: {
+    clientID: "MY_CLIENT_ID", // Will use process.env.MY_CLIENT_ID
+    clientSecret: "MY_CLIENT_SECRET", // Will use process.env.MY_CLIENT_SECRET
+  },
+});
+```
+
+### Direct Configuration
+
+Configure options directly in your Vite config file:
+
+```typescript
+import { defineConfig } from "vite";
+import { drupal } from "drupal-vite";
+
+export default defineConfig({
+  plugins: [
+    drupal({
+      // Drupal instance URL
+      drupalUrl: "https://your-drupal-site.com",
+
+      // OAuth credentials
+      simple_oauth: {
+        clientID: "your-client-id",
+        clientSecret: "your-client-secret",
+      },
+
+      // GraphQL settings
+      graphql: {
+        endpoint: "/graphql", // Default: /graphql
+      },
+    }),
+  ],
+});
+```
+
+## Using the Client
+
+After configuration, access the Drupal client in your code:
+
+```typescript
+import { getDrupalClient } from 'drupal-vite/client';
+
+// Get a preconfigured GraphQL client
+const client = await getDrupalClient();
+
+const query = graphql(`
+query route($path: String!) {
+  route(path: $path, revision: "CURRENT") {
+    __typename
+  }
+}`
+
+// Execute GraphQL operations
+const result = await client.query(query, { path: "/example" });
+```
+
+## Advanced Configuration
+
+Create a `drupal-decoupled.config.ts` file in your project root to customize the [GraphQL urql client](https://nearform.com/open-source/urql):
+
+```typescript
+// drupal-decoupled.config.ts
+import { fetchExchange, cacheExchange } from "@urql/core";
+
+export default {
+  exchanges: [cacheExchange, fetchExchange],
+};
+```
+
+## Development
+
+### Setup
+
+```bash
+# Install dependencies
+bun install
+
+# Build the package
+bun run build:all
+```
+
+### Local Testing with yalc
+
+Use [yalc](https://github.com/wclr/yalc) to test locally in another project:
+
+1. Install yalc globally:
+
+   ```bash
+   npm install -g yalc
+   # or
+   bun install -g yalc
+   ```
+
+2. Build and publish to your local yalc store:
+
+   ```bash
+   bun run yalc:publish
+   ```
+
+3. Add the package to your test project:
+
+   ```bash
+   yalc add drupal-vite
+   ```
+
+4. Push updates after making changes:
+   ```bash
+   bun run yalc:publish --push
+   ```

packages/drupal-vite/bun.lock

@@ -0,0 +1,19 @@
+declare module "drupal-vite/client" {
+  import type { drupalAuthClient } from "drupal-auth-client";
+  import type { Client } from "@urql/core";
+
+  /**
+   * Gets the Drupal authentication token and related data
+   * 
+   * @returns A promise resolving to the Drupal auth data
+   */
+  export function getDrupalAuth(): ReturnType<typeof drupalAuthClient>;
+
+  /**
+   * Gets a configured Drupal GraphQL client with authentication
+   * Uses any custom configuration from drupal-decoupled.config.ts if available
+   * 
+   * @returns A promise resolving to a configured URQL Client for Drupal
+   */
+  export function getDrupalClient(): Promise<Client>;
+}

packages/drupal-vite/client.d.ts

@@ -0,0 +1,54 @@
+{
+  "name": "drupal-vite",
+  "version": "0.0.0",
+  "description": "Vite plugin for Drupal integration",
+  "module": "build/index.js",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "types": "./build/index.d.ts"
+    },
+    "./client": {
+      "types": "./build/client.d.ts"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "client": ["./build/client.d.ts"]
+    }
+  },
+  "files": [
+    "build",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./build --format esm --target node",
+    "build:types": "tsc --emitDeclarationOnly --declaration --outDir build",
+    "copy:dts": "cp client.d.ts build/client.d.ts",
+    "build:all": "bun run build && bun run build:types && bun run copy:dts",
+    "prepublishOnly": "bun run build:all",
+    "yalc:publish": "bun run build:all && yalc publish"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "vite": "^6.3.5"
+  },
+  "peerDependencies": {
+    "typescript": "^5",
+    "vite": "^6.0.0",
+    "@urql/core": "^5.1.1"
+  },
+  "dependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "drupal-auth-client": "^1.0.2",
+    "fs-extra": "^11.3.0"
+  },
+  "keywords": [
+    "vite-plugin",
+    "drupal",
+    "decoupled"
+  ]
+}