microsoft-onedrive-mock 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Meyer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1 +1,76 @@
-# microsoft-onedrive-mock
+# microsoft-onedrive-mock
+
+<br />
+
+<p style="text-align: center;">
+Mock-Server that simulates being Microsoft OneDrive (Graph API).<br />
+Used for testing the <a href="https://rxdb.info/" target="_blank">RxDB OneDrive-Sync</a>.<br />
+Sister project to <a href="https://github.com/pubkey/google-drive-mock" target="_blank">google-drive-mock</a>.<br />
+Mostly Vibe-Coded.<br />
+</p>
+
+## Installation
+
+```bash
+npm install microsoft-onedrive-mock
+```
+
+## Usage
+
+```typescript
+import { startServer } from 'microsoft-onedrive-mock';
+
+// start the server
+const port = 3000;
+const server = startServer(port);
+
+// Read the drive root
+const readResponse = await fetch(`http://localhost:3000/v1.0/me/drive/root`, {
+    method: 'GET',
+    headers: {
+        'Authorization': 'Bearer valid-token'
+    }
+});
+const folderContent = await readResponse.json();
+console.log('Read Root:', folderContent);
+
+// Stop the server
+server.close();
+
+```
+
+## Tech
+
+- TypeScript
+- Express
+- Vitest
+
+## Browser Testing
+
+To run tests inside a headless browser (Chromium):
+
+```bash
+npm run test:browser
+```
+
+## Real Microsoft Graph API Testing
+
+To run tests against the real Microsoft Graph / OneDrive API instead of the mock:
+
+1. Create a `.ENV` file (see `.ENV_EXAMPLE`):
+   ```
+   TEST_TARGET=real
+   ONEDRIVE_TOKEN=your-access-token
+   ```
+2. You can generate a valid `ONEDRIVE_TOKEN` quickly by running the included login script and following the browser prompts:
+   ```bash
+   npm run example:login
+   ```
+3. Run tests:
+   ```bash
+   npm run test:real
+   ```
+
+## Contributing
+
+GitHub issues for this project are closed. If you find a bug, please create a Pull Request with a test case reproducing the issue.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microsoft-onedrive-mock",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Mock-Server that simulates being Microsoft OneDrive. Used for testing.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,13 +18,33 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pubkey/microsoft-onedrive-mock.git"
+  },
+  "keywords": [
+    "microsoft-onedrive",
+    "onedrive",
+    "mock",
+    "testing",
+    "server",
+    "api",
+    "simulator",
+    "rxdb"
+  ],
+  "author": "pubkey",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/pubkey/microsoft-onedrive-mock/issues"
+  },
+  "homepage": "https://github.com/pubkey/microsoft-onedrive-mock#readme",
   "type": "commonjs",
   "peerDependencies": {
     "express": "5.2.1"
   },
   "devDependencies": {
     "@eslint/js": "9.39.2",
-    "@microsoft/microsoft-graph-types": "^2.43.1",
+    "@microsoft/microsoft-graph-types": "2.43.1",
     "@types/cors": "2.8.19",
     "@types/express": "5.0.6",
     "@types/node": "25.1.0",
@@ -40,9 +60,9 @@
     "playwright": "1.58.0",
     "start-server-and-test": "2.1.3",
     "supertest": "7.2.2",
-    "ts-node": "^10.9.2",
+    "ts-node": "10.9.2",
     "typescript": "5.9.3",
     "typescript-eslint": "8.54.0",
     "vitest": "4.0.18"
   }
-}
+}

package/.ENV_EXAMPLE

@@ -1,16 +0,0 @@
-# To run tests against the real Microsoft Graph API
-# Copy this file to .ENV and fill in the values
-
-# 'mock' (default) or 'real'
-TEST_TARGET=real
-
-# OAuth2 Access Token for your Microsoft Account
-# Get one via 'npm run example:login'
-ONEDRIVE_TOKEN=...
-
-# Optional: Simulate latency in ms (only works with TEST_TARGET=mock)
-# LATENCY=50
-
-# Client ID for the Microsoft Login Example
-ONEDRIVE_CLIENT_ID=e5...
-ONEDRIVE_TENANT_ID=common

package/.github/workflows/ci.yml

@@ -1,41 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [ main, master ]
-  pull_request:
-    branches: [ main, master ]
-
-jobs:
-  build-and-test:
-    runs-on: ubuntu-24.04
-
-    steps:
-    - uses: actions/checkout@v4
-    
-    - name: Use Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: '24'
-        cache: 'npm'
-        
-    - name: Install dependencies
-      run: npm install
-
-    - name: Lint
-      run: npm run lint
-
-    - name: Build
-      run: npm run build
-
-    - name: Test (Node)
-      run: npm test
-
-    - name: Install Playwright Browsers
-      run: npx playwright@1.58.0 install chromium
-
-    - name: Test (Browser)
-      run: npm run test:browser
-
-    - name: Test Slow
-      run: npm run test:slow

package/.github/workflows/release.yml

@@ -1,50 +0,0 @@
-name: Release
-
-on:
-  workflow_dispatch:
-    inputs:
-      version:
-        description: 'New Version (e.g. 1.0.0, or leave empty for patch)'
-        required: false
-        type: string
-
-jobs:
-  build:
-    runs-on: ubuntu-24.04
-    # @link https://docs.github.com/en/actions/using-jobs/assigning-permissions-to-jobs
-    permissions:
-      contents: write
-      # @link https://docs.npmjs.com/generating-provenance-statements#about-npm-provenance
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '24'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'npm'
-
-      - run: npm install
-      - name: Bump Version
-        id: bump
-        run: |
-            if [ -z "${{ inputs.version }}" ]; then
-              VERSION=$(npm version patch --no-git-tag-version)
-            else
-              VERSION=$(npm version ${{ inputs.version }} --no-git-tag-version)
-            fi
-            echo "version=${VERSION}" >> $GITHUB_OUTPUT
-      - run: npm run build
-      - run: npm run lint
-      - run: npm test
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Push changes
-        run: |
-          git config --global user.name 'github-actions[bot]'
-          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
-          git add package.json package-lock.json
-          git commit -m "release: ${{ steps.bump.outputs.version }}"
-          git push

package/eslint.config.mjs

@@ -1,15 +0,0 @@
-import globals from "globals";
-import pluginJs from "@eslint/js";
-import tseslint from "typescript-eslint";
-
-
-/** @type {import('eslint').Linter.Config[]} */
-export default [
-    { files: ["**/*.{js,mjs,cjs,ts}"] },
-    { languageOptions: { globals: globals.node } },
-    pluginJs.configs.recommended,
-    ...tseslint.configs.recommended,
-    {
-        ignores: ["dist/**", "coverage/**", "node_modules/**"]
-    }
-];

package/examples/device-login.ts

@@ -1,84 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-
-const clientId = 'e5f346a8-8996-4d46-9f93-6e6817d9078e';
-const tenantId = 'common';
-
-async function runDeviceLogin() {
-    const authority = `https://login.microsoftonline.com/${tenantId}/oauth2/v2.0`;
-
-    // 1. Get device code
-    const deviceCodeParams = new URLSearchParams();
-    deviceCodeParams.append('client_id', clientId);
-    deviceCodeParams.append('scope', 'Files.ReadWrite.All User.Read offline_access');
-
-    let deviceCodeRes;
-    try {
-        deviceCodeRes = await fetch(`${authority}/devicecode`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/x-www-form-urlencoded'
-            },
-            body: deviceCodeParams.toString()
-        });
-    } catch (e) {
-        console.error("Network error executing fetch request:", e);
-        return;
-    }
-
-    const deviceCodeData = await deviceCodeRes.json();
-    if (!deviceCodeRes.ok) {
-        console.error('❌ Failed to start device login:', deviceCodeData);
-        console.error('\nNOTE: Your Azure App must have "Allow public client flows" enabled in Authentication settings for Device Code flow to work.');
-        return;
-    }
-
-    console.log('\n====================================================');
-    console.log(deviceCodeData.message);
-    console.log('====================================================\n');
-
-    // 2. Poll for token
-    const tokenParams = new URLSearchParams();
-    tokenParams.append('grant_type', 'urn:ietf:params:oauth:grant-type:device_code');
-    tokenParams.append('client_id', clientId);
-    tokenParams.append('device_code', deviceCodeData.device_code);
-
-    let polling = true;
-    while (polling) {
-        await new Promise(resolve => setTimeout(resolve, deviceCodeData.interval * 1000));
-
-        const tokenRes = await fetch(`${authority}/token`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/x-www-form-urlencoded'
-            },
-            body: tokenParams.toString()
-        });
-
-        const tokenData = await tokenRes.json();
-
-        if (tokenRes.ok) {
-            console.log('\n✅ Successfully authenticated!');
-
-            // Save to .ENV
-            const envPath = path.resolve(__dirname, '../.ENV');
-            let envContent = fs.existsSync(envPath) ? fs.readFileSync(envPath, 'utf8') : '';
-            if (envContent.includes('ONEDRIVE_TOKEN=')) {
-                envContent = envContent.replace(/ONEDRIVE_TOKEN=[^\n]*/, `ONEDRIVE_TOKEN=${tokenData.access_token}`);
-            } else {
-                envContent += `\nONEDRIVE_TOKEN=${tokenData.access_token}\n`;
-            }
-            fs.writeFileSync(envPath, envContent);
-            console.log('✅ Updated .ENV with your new ONEDRIVE_TOKEN');
-            console.log('You can now run: npm run test:real');
-            polling = false;
-        } else if (tokenData.error !== 'authorization_pending') {
-            console.error('\n❌ Login failed:', tokenData.error_description || tokenData.error);
-            polling = false;
-        } else {
-            process.stdout.write('.');
-        }
-    }
-}
-
-runDeviceLogin();

package/examples/microsoft-login.html

@@ -1,227 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Microsoft OneDrive Token Generator</title>
-    <style>
-        body {
-            font-family: sans-serif;
-            padding: 20px;
-            max-width: 600px;
-            margin: 0 auto;
-        }
-
-        .form-group {
-            margin-bottom: 15px;
-        }
-
-        label {
-            display: block;
-            margin-bottom: 5px;
-            font-weight: bold;
-        }
-
-        input[type="text"] {
-            width: 100%;
-            padding: 8px;
-            box-sizing: border-box;
-        }
-
-        button {
-            padding: 10px 20px;
-            background-color: #0078d4;
-            color: white;
-            border: none;
-            cursor: pointer;
-            font-size: 16px;
-            border-radius: 4px;
-        }
-
-        button:hover {
-            background-color: #005a9e;
-        }
-
-        button#copy-btn {
-            background-color: #28a745;
-            margin-top: 10px;
-        }
-
-        button#copy-btn:hover {
-            background-color: #218838;
-        }
-
-        #token-display {
-            margin-top: 20px;
-            background: #f0f0f0;
-            padding: 15px;
-            border-radius: 4px;
-            display: none;
-        }
-
-        textarea {
-            width: 100%;
-            padding: 8px;
-            box-sizing: border-box;
-            border: 1px solid #ccc;
-            border-radius: 4px;
-            resize: vertical;
-            font-family: monospace;
-        }
-
-        .hidden {
-            display: none;
-        }
-    </style>
-    <!-- MSAL.js v3 -->
-    <script type="text/javascript" src="https://alcdn.msauth.net/browser/2.37.1/js/msal-browser.min.js"></script>
-</head>
-
-<body>
-
-    <h1>Microsoft OneDrive Login</h1>
-    <p>Enter your Client ID (Application ID) and Tenant ID to authenticate and get an access token. The login uses
-        MSAL.js for OAuth2 Implicit/SPA flow.</p>
-
-    <div class="form-group">
-        <label for="client-id">Client ID:</label>
-        <input type="text" id="client-id" placeholder="e.g. 11111111-1111-1111-1111-111111111111">
-    </div>
-
-    <div class="form-group">
-        <label for="tenant-id">Tenant ID:</label>
-        <input type="text" id="tenant-id" placeholder="e.g. common (or your specific tenant GUID)">
-    </div>
-
-    <button id="login-btn" onclick="handleAuth()">Login to Microsoft Graph</button>
-
-    <div id="token-display">
-        <h3>Access Token:</h3>
-        <textarea id="access-token" readonly rows="6"></textarea>
-        <button id="copy-btn" onclick="copyToken()">Copy Token</button>
-
-        <h3>Full .ENV Content:</h3>
-        <textarea id="env-content" readonly rows="12"></textarea>
-        <button id="copy-env-btn" onclick="copyEnv()">Copy .ENV</button>
-    </div>
-
-    <script>
-        let msalInstance = null;
-        let loginRequest = {
-            scopes: ["Files.ReadWrite.All", "User.Read"]
-        };
-
-        window.onload = async function () {
-            const storedClientId = localStorage.getItem('ms_client_id');
-            const storedTenantId = localStorage.getItem('ms_tenant_id') || 'common';
-            if (storedClientId) document.getElementById('client-id').value = storedClientId;
-            document.getElementById('tenant-id').value = storedTenantId;
-
-            // If we have clientId, we can initialize MSAL to check if we are returning from a redirect
-            if (storedClientId) {
-                initializeMsal(storedClientId, storedTenantId);
-                try {
-                    const response = await msalInstance.handleRedirectPromise();
-                    if (response && response.accessToken) {
-                        displayToken(response.accessToken, storedClientId, storedTenantId);
-                    }
-                } catch (err) {
-                    console.error("Redirect error:", err);
-                    alert("Failed to process login redirect: " + err.message);
-                }
-            }
-        }
-
-        function initializeMsal(clientId, tenantId) {
-            // Determine if the user is running on https or http
-            const currentOrigin = window.location.origin;
-            const redirectUri = currentOrigin + "/microsoft-login.html";
-
-            const msalConfig = {
-                auth: {
-                    clientId: clientId,
-                    authority: `https://login.microsoftonline.com/${tenantId}`,
-                    redirectUri: redirectUri,
-                }
-            };
-            msalInstance = new msal.PublicClientApplication(msalConfig);
-        }
-
-        async function handleAuth() {
-            const clientId = document.getElementById('client-id').value.trim();
-            const tenantId = document.getElementById('tenant-id').value.trim() || 'common';
-
-            if (!clientId) {
-                alert('Please enter a Client ID');
-                return;
-            }
-
-            localStorage.setItem('ms_client_id', clientId);
-            localStorage.setItem('ms_tenant_id', tenantId);
-
-            initializeMsal(clientId, tenantId);
-
-            try {
-                // Use redirect flow instead of popup. This avoids popup blockers and 
-                // cleanly returns the user to this page with the '#code=...' in the URL,
-                // which handleRedirectPromise() will then automatically exchange for the JWT Access Token!
-                await msalInstance.loginRedirect(loginRequest);
-            } catch (err) {
-                console.error(err);
-                alert('Login failed: ' + (err.message || err));
-            }
-        }
-
-        function displayToken(accessToken, clientId, tenantId) {
-            document.getElementById('token-display').style.display = 'block';
-            document.getElementById('access-token').value = accessToken;
-
-            const envContent = `# To run tests against the real Microsoft Graph API
-# Copy this file to .ENV and fill in the values
-
-# 'mock' (default) or 'real'
-TEST_TARGET=real
-
-# OAuth2 Access Token for your Microsoft Account
-# Get one via 'npm run example:login'
-ONEDRIVE_TOKEN=${accessToken}
-
-# Client ID for the Microsoft Login Example
-ONEDRIVE_CLIENT_ID=${clientId}
-ONEDRIVE_TENANT_ID=${tenantId}
-
-# Optional: Simulate latency in ms (only works with TEST_TARGET=mock)
-# LATENCY=50
-`;
-            document.getElementById('env-content').value = envContent;
-        }
-
-        function copyToken() {
-            copyToClipboard('access-token', 'copy-btn');
-        }
-
-        function copyEnv() {
-            copyToClipboard('env-content', 'copy-env-btn');
-        }
-
-        function copyToClipboard(elementId, buttonId) {
-            const textEl = document.getElementById(elementId);
-            textEl.select();
-            textEl.setSelectionRange(0, 99999);
-
-            navigator.clipboard.writeText(textEl.value).then(() => {
-                const btn = document.getElementById(buttonId);
-                const originalText = btn.innerText;
-                btn.innerText = 'Copied!';
-                setTimeout(() => {
-                    btn.innerText = originalText;
-                }, 2000);
-            }).catch(err => {
-                console.error('Failed to copy text: ', err);
-            });
-        }
-    </script>
-</body>
-
-</html>

package/examples/serve-login.ts

@@ -1,11 +0,0 @@
-import express from 'express';
-
-const app = express();
-const port = 8080;
-
-app.use(express.static(__dirname));
-
-app.listen(port, () => {
-    console.log(`Login example running at http://localhost:${port}/microsoft-login.html`);
-    console.log('NOTE: Ensure "http://localhost:8080/microsoft-login.html" is added as a Redirect URI in your Microsoft Entra ID app registration (SPA).');
-});

package/scripts/check-token.ts

@@ -1,70 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import * as https from 'https';
-
-const envPath = path.resolve(__dirname, '../.ENV');
-if (fs.existsSync(envPath)) {
-    const envContent = fs.readFileSync(envPath, 'utf8');
-    envContent.split('\n').forEach(line => {
-        const match = line.match(/^([^=]+)=(.*)$/);
-        if (match) {
-            const key = match[1].trim();
-            const value = match[2].trim().replace(/^['"]|['"]$/g, '');
-            if (!process.env[key]) {
-                process.env[key] = value;
-            }
-        }
-    });
-}
-
-const token = process.env.ONEDRIVE_TOKEN || process.env.GRAPH_TOKEN;
-
-if (!token) {
-    console.error('❌ Error: ONEDRIVE_TOKEN or GRAPH_TOKEN not found in environment or .ENV file.');
-    process.exit(1);
-}
-
-console.log('🔄 Verifying Microsoft Graph Token...');
-
-const options = {
-    hostname: 'graph.microsoft.com',
-    path: '/v1.0/me',
-    method: 'GET',
-    headers: {
-        'Authorization': `Bearer ${token}`,
-        'User-Agent': 'node-script'
-    }
-};
-
-const req = https.request(options, (res) => {
-    let data = '';
-
-    res.on('data', (chunk) => {
-        data += chunk;
-    });
-
-    res.on('end', () => {
-        if (res.statusCode === 200) {
-            try {
-                const body = JSON.parse(data);
-                console.log(`✅ Token is valid. User: ${body.userPrincipalName || body.displayName || 'Unknown'}`);
-                process.exit(0);
-            } catch (e: unknown) {
-                const msg = e instanceof Error ? e.message : String(e);
-                console.error('❌ Error parsing response:', msg);
-                process.exit(1);
-            }
-        } else {
-            console.error(`❌ Token verification failed. Update .ENV file with a valid token. Status: ${res.statusCode}`);
-            console.error('Response:', data);
-            process.exit(1);
-        }
-    });
-});
-
-req.on('error', (e) => {
-    console.error(`❌ Request error: ${e.message}`);
-    process.exit(1);
-});
-
-req.end();