@the-vcsi/msgraph 0.0.1

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@the-vcsi/msgraph",
+  "version": "0.0.1",
+  "description": "sv CLI add-on for Microsoft Graph / SharePoint integration",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": ["src"],
+  "keywords": ["sv-add", "svelte", "sveltekit", "microsoft-graph", "sharepoint"],
+  "dependencies": {
+    "sv": "^0.11.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Vermont-Complex-Systems/vcsi-starter"
+  },
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,64 @@
+import { defineAddon, defineAddonOptions } from 'sv/core';
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Read templates from files (testable, lintable)
+const FETCH_SCRIPT = readFileSync(join(__dirname, 'templates/fetch-msgraph.js'), 'utf8');
+const APP_SETTINGS = readFileSync(join(__dirname, 'templates/appSettings.js'), 'utf8');
+const ENV_EXAMPLE = readFileSync(join(__dirname, 'templates/.env.example'), 'utf8');
+
+const options = defineAddonOptions()
+  .add('siteId', {
+    question: 'SharePoint site ID (get from Graph Explorer or Azure Portal):',
+    type: 'string'
+  })
+  .build();
+
+export default defineAddon({
+  id: '@the-vcsi/msgraph',
+  options,
+
+  run: ({ sv, options: opts }) => {
+    // Create the fetch script
+    sv.file('scripts/fetch-msgraph.js', () => FETCH_SCRIPT);
+
+    // Create app settings config with user-provided siteId
+    const appSettings = APP_SETTINGS.replace(/__SITE_ID__/g, opts.siteId || 'YOUR_SITE_ID');
+    sv.file('src/appSettings.js', () => appSettings);
+
+    // Append to .env.example (or create if doesn't exist)
+    sv.file('.env.example', (content) => {
+      if (content && content.includes('tenantId')) {
+        return content; // Already has msgraph config
+      }
+      return (content || '') + '\n' + ENV_EXAMPLE;
+    });
+
+    // Add npm script and dependencies
+    sv.file('package.json', (content) => {
+      const pkg = JSON.parse(content);
+      pkg.scripts = pkg.scripts || {};
+      pkg.scripts['fetch:sharepoint'] = 'node scripts/fetch-msgraph.js';
+
+      // Add required dependencies
+      pkg.dependencies = pkg.dependencies || {};
+      pkg.dependencies['@azure/identity'] = '^4.0.0';
+      pkg.dependencies['@microsoft/microsoft-graph-client'] = '^3.0.0';
+      pkg.dependencies['dotenv'] = '^16.0.0';
+
+      return JSON.stringify(pkg, null, 2);
+    });
+
+    console.log('\n  Microsoft Graph integration added!');
+    console.log('  1. Copy .env.example to .env');
+    console.log('  2. Get credentials from Azure Portal > App registrations:');
+    console.log('     - tenantId: Directory (tenant) ID');
+    console.log('     - clientId: Application (client) ID');
+    console.log('     - clientSecret: Certificates & secrets > New client secret');
+    console.log('  3. Run: npm install');
+    console.log('  4. Run: npm run fetch:sharepoint');
+  }
+});

package/src/templates/.env.example

@@ -0,0 +1,6 @@
+# Microsoft Graph / SharePoint Integration
+# Get these values from Azure Portal > App registrations
+
+tenantId=your-tenant-id
+clientId=your-client-id
+clientSecret=your-client-secret

package/src/templates/appSettings.js

@@ -0,0 +1,14 @@
+// https://learn.microsoft.com/en-us/graph/tutorials/javascript?tabs=aad
+// Configuration for Microsoft Graph API
+
+export const settings = {
+  clientId: process.env.clientId,
+  tenantId: process.env.tenantId,
+  clientSecret: process.env.clientSecret,
+  // SharePoint site ID - get from Graph Explorer or Azure Portal
+  siteId: '__SITE_ID__',
+  // Default scopes for client credentials flow
+  scopes: ['https://graph.microsoft.com/.default'],
+};
+
+export default settings;

package/src/templates/fetch-msgraph.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+
+import 'dotenv/config';
+import { writeFileSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { ClientSecretCredential } from '@azure/identity';
+import { Client } from '@microsoft/microsoft-graph-client';
+import { TokenCredentialAuthenticationProvider } from '@microsoft/microsoft-graph-client/authProviders/azureTokenCredentials/index.js';
+import settings from '../src/appSettings.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const STORIES_DIR = join(__dirname, '..', 'src', 'lib', 'stories');
+const DATA_STORY_FILE = 'data-story.xlsx';
+
+function createClient() {
+  const credential = new ClientSecretCredential(
+    settings.tenantId || process.env.tenantId,
+    settings.clientId || process.env.clientId,
+    settings.clientSecret || process.env.clientSecret
+  );
+
+  const authProvider = new TokenCredentialAuthenticationProvider(credential, {
+    scopes: settings.scopes,
+  });
+
+  return Client.initWithMiddleware({ authProvider });
+}
+
+function sanitizeFilename(name) {
+  return name
+    .replace(/\.(xlsx|xlsm|xls)$/i, '')
+    .replace(/[^a-zA-Z0-9-_]/g, '-')
+    .toLowerCase();
+}
+
+function excelDateToString(serial) {
+  const utcDays = Math.floor(serial - 25569);
+  const date = new Date(utcDays * 86400 * 1000);
+  return date.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' });
+}
+
+function convertToStoryJson(rows) {
+  const [header, ...dataRows] = rows;
+
+  const result = {
+    title: '',
+    subtitle: '',
+    authors: [],
+    date: '',
+    SectionTitle: ''
+  };
+
+  let currentAuthor = {};
+
+  for (const row of dataRows) {
+    const section = String(row[0] || '').trim().toLowerCase();
+    const key = String(row[1] || '').trim();
+    const value = row[2];
+
+    if (!section || !key) continue;
+
+    if (section === 'meta') {
+      const keyLower = key.toLowerCase();
+      if (keyLower === 'title') result.title = value;
+      else if (keyLower === 'subtitle') result.subtitle = value;
+      else if (keyLower === 'sectiontitle') result.SectionTitle = value;
+      else if (keyLower === 'date') {
+        result.date = typeof value === 'number' ? excelDateToString(value) : value;
+      }
+    } else if (section === 'author') {
+      if (key.toLowerCase() === 'name') {
+        currentAuthor = { name: value };
+      } else if (key.toLowerCase() === 'url') {
+        currentAuthor.url = value;
+        result.authors.push(currentAuthor);
+        currentAuthor = {};
+      }
+    } else {
+      if (!result[section]) {
+        result[section] = [];
+      }
+      result[section].push({ type: key, value: String(value) });
+    }
+  }
+
+  return result;
+}
+
+async function main() {
+  const client = createClient();
+
+  let site;
+  try {
+    site = await client.api(`/sites/${settings.siteId}`).get();
+  } catch (error) {
+    console.error(`Error: ${error.code} - ${error.message}`);
+    throw error;
+  }
+
+  console.log(`Site: ${site.webUrl}`);
+
+  const drives = await client.api(`/sites/${site.id}/drives`).get();
+  const driveId = drives.value[0].id;
+
+  const items = await client.api(`/drives/${driveId}/root/children`).get();
+  const dataStoryFile = items.value.find(
+    (item) => item.file && item.name.toLowerCase() === DATA_STORY_FILE.toLowerCase()
+  );
+
+  if (!dataStoryFile) {
+    console.log(`\n${DATA_STORY_FILE} not found`);
+    return;
+  }
+
+  console.log(`\nProcessing: ${dataStoryFile.name}`);
+
+  const worksheets = await client
+    .api(`/drives/${driveId}/items/${dataStoryFile.id}/workbook/worksheets`)
+    .get();
+
+  for (const sheet of worksheets.value) {
+    console.log(`  Sheet: ${sheet.name}`);
+
+    try {
+      const usedRange = await client
+        .api(
+          `/drives/${driveId}/items/${dataStoryFile.id}/workbook/worksheets/${sheet.id}/usedRange`
+        )
+        .get();
+
+      const values = usedRange.values || [];
+
+      if (values.length === 0) {
+        console.log(`    (empty sheet, skipping)`);
+        continue;
+      }
+
+      const sheetName = sanitizeFilename(sheet.name);
+      const storyDir = join(STORIES_DIR, sheetName, 'data');
+      mkdirSync(storyDir, { recursive: true });
+
+      const json = convertToStoryJson(values);
+      const filepath = join(storyDir, 'copy.json');
+      writeFileSync(filepath, JSON.stringify(json, null, '\t'), 'utf8');
+
+      console.log(`    -> ${filepath}`);
+    } catch (error) {
+      console.error(`    Error reading sheet: ${error.message}`);
+    }
+  }
+
+  console.log('\nDone!');
+}
+
+main().catch(console.error);