outlook-cli 1.2.0

package/config.js

@@ -0,0 +1,84 @@
+/**
+ * Configuration for Outlook MCP Server
+ */
+const path = require('path');
+const os = require('os');
+const pkg = require('./package.json');
+
+require('dotenv').config();
+
+function readEnv(...keys) {
+  for (const key of keys) {
+    const value = process.env[key];
+    if (value !== undefined && value !== '') {
+      return value;
+    }
+  }
+
+  return '';
+}
+
+function readScopes() {
+  const rawScopes = readEnv('OUTLOOK_SCOPES', 'MS_SCOPES');
+  if (!rawScopes) {
+    return [
+      'offline_access',
+      'Mail.Read',
+      'Mail.ReadWrite',
+      'Mail.Send',
+      'User.Read',
+      'Calendars.Read',
+      'Calendars.ReadWrite'
+    ];
+  }
+
+  return rawScopes
+    .split(/[\s,]+/)
+    .map((scope) => scope.trim())
+    .filter(Boolean);
+}
+
+// Ensure we have a home directory path even if process.env.HOME is undefined
+const homeDir = process.env.HOME || process.env.USERPROFILE || os.homedir() || '/tmp';
+const tokenStorePath = readEnv('OUTLOOK_TOKEN_STORE_PATH', 'MS_TOKEN_STORE_PATH') || path.join(homeDir, '.outlook-mcp-tokens.json');
+const redirectUri = readEnv('OUTLOOK_REDIRECT_URI', 'MS_REDIRECT_URI') || 'http://localhost:3333/auth/callback';
+const authServerUrl = readEnv('OUTLOOK_AUTH_SERVER_URL', 'MS_AUTH_SERVER_URL') || 'http://localhost:3333';
+const tokenEndpoint = readEnv('OUTLOOK_TOKEN_ENDPOINT', 'MS_TOKEN_ENDPOINT') || 'https://login.microsoftonline.com/consumers/oauth2/v2.0/token';
+
+module.exports = {
+  // Server information
+  SERVER_NAME: "outlook-assistant",
+  SERVER_VERSION: pkg.version,
+  
+  // Test mode setting
+  USE_TEST_MODE: process.env.USE_TEST_MODE === 'true',
+  DEBUG_LOGS: process.env.OUTLOOK_DEBUG === 'true' || process.env.MCP_DEBUG === 'true',
+  
+  // Authentication configuration
+  AUTH_CONFIG: {
+    clientId: readEnv('OUTLOOK_CLIENT_ID', 'MS_CLIENT_ID'),
+    clientSecret: readEnv('OUTLOOK_CLIENT_SECRET', 'MS_CLIENT_SECRET'),
+    redirectUri,
+    scopes: readScopes(),
+    tokenStorePath,
+    authServerUrl,
+    tokenEndpoint
+  },
+  
+  // Microsoft Graph API
+  GRAPH_API_ENDPOINT: 'https://graph.microsoft.com/v1.0/',
+  
+  // Email constants
+  EMAIL_SELECT_FIELDS: 'id,subject,from,toRecipients,ccRecipients,receivedDateTime,bodyPreview,hasAttachments,importance,isRead',
+  EMAIL_DETAIL_FIELDS: 'id,subject,from,toRecipients,ccRecipients,bccRecipients,receivedDateTime,bodyPreview,body,hasAttachments,importance,isRead,internetMessageHeaders',
+  
+  // Calendar constants
+  CALENDAR_SELECT_FIELDS: 'id,subject,bodyPreview,start,end,location,organizer,attendees,isAllDay,isCancelled',
+  
+  // Pagination
+  DEFAULT_PAGE_SIZE: 25,
+  MAX_RESULT_COUNT: 50,
+
+  // Timezone
+  DEFAULT_TIMEZONE: "Central European Standard Time",
+};

package/docs/PROJECT-STRUCTURE.md

@@ -0,0 +1,52 @@
+# Project Structure
+
+This repository is organized for both runtime clarity and npm publish hygiene.
+
+Canonical repository:
+
+- https://github.com/selvin-paul-raj/outlook-cli
+
+## Runtime directories
+
+- `auth/`: token management and auth tools
+- `email/`: email listing, search, read, send, mark-read
+- `calendar/`: event list/create/decline/cancel/delete
+- `folder/`: folder list/create and message move
+- `rules/`: inbox rule list/create/sequence update
+- `utils/`: Graph API and OData helpers
+
+## Runtime entry points
+
+- `cli.js`: global CLI binary (`outlook-cli`)
+- `index.js`: stdio MCP server entry point
+- `outlook-auth-server.js`: local auth callback server
+- `tool-registry.js`: shared tool registry used by CLI and MCP
+- `config.js`: centralized configuration and env resolution
+
+## Documentation layout
+
+- `README.md`: package overview and first-run flow
+- `CLI.md`: command quick reference
+- `QUICKSTART.md`: short setup walkthrough
+- `docs/REFERENCE.md`: exhaustive command/tool/parameter reference
+- `docs/PUBLISHING.md`: release and npm publish checklist
+
+## Test layout
+
+- `test/auth/`: auth and token storage tests
+- `test/calendar/`: calendar operation tests
+
+## Packaging strategy (`package.json` -> `files`)
+
+The publish tarball includes only runtime code and docs required by users:
+
+- runtime modules (`auth`, `email`, `calendar`, `folder`, `rules`, `utils`)
+- entry points (`cli.js`, `index.js`, `outlook-auth-server.js`, `tool-registry.js`, `config.js`)
+- docs (`README.md`, `CLI.md`, `QUICKSTART.md`, `docs/`)
+- `LICENSE`
+
+Excluded by design:
+
+- tests and local workspace artifacts
+- `.env` files and secrets
+- development-only notes

package/docs/PUBLISHING.md

@@ -0,0 +1,86 @@
+# Publishing Checklist (npm)
+
+Canonical repository:
+
+- https://github.com/selvin-paul-raj/outlook-cli
+
+## 1. Pre-flight
+
+```bash
+npm install
+npm test
+npm pack --dry-run
+```
+
+Ensure `npm pack --dry-run` includes only intended runtime files and docs.
+
+## 2. Versioning
+
+Update version based on release type:
+
+```bash
+npm version patch
+# or
+npm version minor
+# or
+npm version major
+```
+
+## 3. Verify package metadata
+
+Check in `package.json`:
+
+- `name` is correct (`outlook-cli`)
+- `bin` points to `./cli.js`
+- `engines.node` matches supported runtime
+- `files` list contains only publishable content
+- `license` is set
+
+## 4. Verify CLI behavior
+
+```bash
+node cli.js --help
+node cli.js commands --json
+node cli.js update --json
+```
+
+## 5. Publish
+
+Login once if needed:
+
+```bash
+npm login
+```
+
+Publish:
+
+```bash
+npm publish --access public
+```
+
+## 5.1 Push GitHub release metadata
+
+```bash
+git push origin main
+git push origin --tags
+```
+
+Then create a GitHub release from the pushed tag in:
+
+- https://github.com/selvin-paul-raj/outlook-cli/releases
+
+## 6. Post-publish smoke test
+
+```bash
+npm i -g outlook-cli@latest
+outlook-cli --version
+outlook-cli commands
+```
+
+## 7. Suggested release notes format
+
+- New commands and flags
+- Breaking changes
+- Bug fixes
+- Documentation updates
+- Migration notes (if any)