codeapp-js 0.2.1 → 0.3.0

package/examples/outlook Demo/dist/styles.css

@@ -1,84 +1,84 @@
-* {
-  box-sizing: border-box;
-  margin: 0;
-  padding: 0;
-}
-
-body {
-  font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
-  padding: 20px;
-  background: #f5f5f5;
-  color: #333;
-}
-
-h1 {
-  margin-bottom: 16px;
-}
-
-#loading {
-  font-size: 14px;
-  color: #666;
-}
-
-#error {
-  color: #d32f2f;
-  font-size: 14px;
-  margin-top: 12px;
-}
-
-table {
-  width: 100%;
-  border-collapse: collapse;
-  background: #fff;
-  border-radius: 4px;
-  overflow: hidden;
-  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.12);
-}
-
-th, td {
-  text-align: left;
-  padding: 10px 14px;
-  border-bottom: 1px solid #eee;
-}
-
-th {
-  background: #0078d4;
-  color: #fff;
-  font-weight: 600;
-}
-
-tr:last-child td {
-  border-bottom: none;
-}
-
-tr:hover td {
-  background: #f0f6ff;
-}
-
-@media (prefers-color-scheme: dark) {
-  body {
-    background: #1e1e1e;
-    color: #e0e0e0;
-  }
-
-  table {
-    background: #2d2d2d;
-    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.4);
-  }
-
-  th {
-    background: #0063b1;
-  }
-
-  td {
-    border-bottom-color: #444;
-  }
-
-  tr:hover td {
-    background: #383838;
-  }
-
-  #loading {
-    color: #aaa;
-  }
-}
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
+  padding: 20px;
+  background: #f5f5f5;
+  color: #333;
+}
+
+h1 {
+  margin-bottom: 16px;
+}
+
+#loading {
+  font-size: 14px;
+  color: #666;
+}
+
+#error {
+  color: #d32f2f;
+  font-size: 14px;
+  margin-top: 12px;
+}
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+  background: #fff;
+  border-radius: 4px;
+  overflow: hidden;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.12);
+}
+
+th, td {
+  text-align: left;
+  padding: 10px 14px;
+  border-bottom: 1px solid #eee;
+}
+
+th {
+  background: #0078d4;
+  color: #fff;
+  font-weight: 600;
+}
+
+tr:last-child td {
+  border-bottom: none;
+}
+
+tr:hover td {
+  background: #f0f6ff;
+}
+
+@media (prefers-color-scheme: dark) {
+  body {
+    background: #1e1e1e;
+    color: #e0e0e0;
+  }
+
+  table {
+    background: #2d2d2d;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.4);
+  }
+
+  th {
+    background: #0063b1;
+  }
+
+  td {
+    border-bottom-color: #444;
+  }
+
+  tr:hover td {
+    background: #383838;
+  }
+
+  #loading {
+    color: #aaa;
+  }
+}

package/examples/outlook Demo/readme.md

@@ -1,82 +1,82 @@
-# Outlook Inbox Demo
-
-Demo to show how to use the Office 365 Outlook connector to list inbox emails.
-
----
-
-## Prerequisites
-
-- A Power Platform environment with Code Apps enabled
-- VS Code
-- Recommend Copilot
-
----
-
-## 1. Install Power Platform CLI
-
-Install the PAC CLI via npm:
-
-```bash
-npm install -g microsoft.powerapps.cli
-```
-
-Or install through the [Power Platform Tools VS Code extension](https://marketplace.visualstudio.com/items?itemName=microsoft-IsvExpTools.powerplatform-vscode).
-
-Verify the install:
-
-```bash
-pac --version
-```
-
----
-
-## 2. Authenticate and Select Environment
-
-Create an auth profile and connect to your environment:
-
-```bash
-# Authenticate (opens browser for interactive login)
-pac auth create --environment https://<yourorg>.crm.dynamics.com
-
-# List auth profiles
-pac auth list
-
-# Select an existing profile (if you have multiple)
-pac auth select --index <profile-index>
-
-# Confirm you are connected to the correct environment
-pac env who
-```
-
-Replace `<yourorg>` with your Dataverse org name.
-
----
-
-## 3. Add the Outlook Skill File to VS Code
-
-This repo includes a skill file that gives Copilot the knowledge to build Outlook code apps:
-
-1. Copy the `Skills/outlookCodeApp/SKILL.md` file to your VS Code Copilot skills directory:
-   ```
-   ~/.copilot/skills/outlookCodeApp/SKILL.md
-   ```
-
-Once in place, Copilot will automatically use this skill when you ask it to build the code app.
-
----
-
-## 4. Setup
-
-Copy the contents of `dist copy` into a `dist` folder, then copy the `index.html` and `index.js` from this examples folder into `dist`, replacing the defaults.
-
----
-
-## 5. Deploy the App
-
-Update the power.config.json file with the target environment's id (it should be the same environment you have used in CLI auth).
-
-```bash
-pac code push --solutionName OutlookInbox
-```
-
-This packages the build output from `./dist` and deploys it as a code component inside the specified solution.
+# Outlook Inbox Demo
+
+Demo to show how to use the Office 365 Outlook connector to list inbox emails.
+
+---
+
+## Prerequisites
+
+- A Power Platform environment with Code Apps enabled
+- VS Code
+- Recommend Copilot
+
+---
+
+## 1. Install Power Platform CLI
+
+Install the PAC CLI via npm:
+
+```bash
+npm install -g microsoft.powerapps.cli
+```
+
+Or install through the [Power Platform Tools VS Code extension](https://marketplace.visualstudio.com/items?itemName=microsoft-IsvExpTools.powerplatform-vscode).
+
+Verify the install:
+
+```bash
+pac --version
+```
+
+---
+
+## 2. Authenticate and Select Environment
+
+Create an auth profile and connect to your environment:
+
+```bash
+# Authenticate (opens browser for interactive login)
+pac auth create --environment https://<yourorg>.crm.dynamics.com
+
+# List auth profiles
+pac auth list
+
+# Select an existing profile (if you have multiple)
+pac auth select --index <profile-index>
+
+# Confirm you are connected to the correct environment
+pac env who
+```
+
+Replace `<yourorg>` with your Dataverse org name.
+
+---
+
+## 3. Add the Outlook Skill File to VS Code
+
+This repo includes a skill file that gives Copilot the knowledge to build Outlook code apps:
+
+1. Copy the `Skills/outlookCodeApp/SKILL.md` file to your VS Code Copilot skills directory:
+   ```
+   ~/.copilot/skills/outlookCodeApp/SKILL.md
+   ```
+
+Once in place, Copilot will automatically use this skill when you ask it to build the code app.
+
+---
+
+## 4. Setup
+
+Copy the contents of `dist copy` into a `dist` folder, then copy the `index.html` and `index.js` from this examples folder into `dist`, replacing the defaults.
+
+---
+
+## 5. Deploy the App
+
+Update the power.config.json file with the target environment's id (it should be the same environment you have used in CLI auth).
+
+```bash
+pac code push --solutionName OutlookInbox
+```
+
+This packages the build output from `./dist` and deploys it as a code component inside the specified solution.

package/examples/outlook Demo2/agent/decision-log.md

@@ -0,0 +1,7 @@
+
+- Outlook inbox + send email app built with shared_office365 connector
+- Single shared client pattern per connections skill; DATA_SOURCE = 'office365'
+- power.config.json updated with office365 connectionReference
+- Operations used: GetEmailsV3 (list inbox), SendEmailV2 (send email)
+- CSS in separate dist/styles.css; editorial warm-tone design with Playfair Display + DM Sans
+- User still needs to: click Sync Connections button, then Deploy to push to environment

package/examples/{solution explorer → outlook Demo2}/dist/codeapp.js

@@ -1,4 +1,4 @@
-import { getClient, callActionAsync } from "./power-apps-data.js";
+import { getClient, getContext, callActionAsync } from "./power-apps-data.js";
 
 // ── Initialize SDK & Client ────────────────────────────────────
 let oSharedClient = null;
@@ -68,6 +68,7 @@ function _dbgWrap(sName, aArgs, fnBody) {
   _dbgRenderEntry(oEntry, false);
   return oResult;
 }
+
 function _dbgClone(oVal) {
   try { return JSON.parse(JSON.stringify(oVal)); }
   catch (oErr) { return String(oVal); }
@@ -308,6 +309,9 @@ export async function deleteItem(tableName, primaryKey, id) {
 }
 
 // ── Unbound Action ─────────────────────────────────────────────
+// Calls an unbound Dataverse action by POSTing to the action endpoint.
+// Do NOT add action names to power.config.json dataSources — they are
+// not entities and will cause deploy errors.
 export async function callUnboundAction(tableName, primaryKey, actionName, params) {
   return _dbgWrap('callUnboundAction', [tableName, primaryKey, actionName, params], async function() {
   var oAllSources = Object.assign({}, oInitialDataSources, oDataSources);
@@ -319,10 +323,11 @@ export async function callUnboundAction(tableName, primaryKey, actionName, param
 // ── WhoAmI ─────────────────────────────────────────────────────
 export async function whoAmI() {
   return _dbgWrap('whoAmI', [], async function() {
-  var oAllSources = Object.assign({}, oInitialDataSources, oDataSources);
-  var result = await callActionAsync(oAllSources, 'WhoAmI', {});
-  var data = unwrapResult(result);
-  return data.UserId || data.userid || data.systemuserid || data;
+  var oCtx = await getContext();
+  var sId = oCtx.UserId || oCtx.userId || oCtx.systemuserid;
+  if (sId) return sId;
+  if (oCtx.userSettings && oCtx.userSettings.userId) return oCtx.userSettings.userId;
+  return oCtx;
   });
 }
 
@@ -713,6 +718,7 @@ export async function getFileMetadata(sSiteUrl, sFileId) {
 // ── Data source name (must match connectionReferences in power.config.json) ──
 const DATA_SOURCE_CANDIDATES = ["office365outlook", "Office365Outlook", "office365"];
 const OUTLOOK_APIS = {
+  // ── Email operations ──
   GetEmailsV3: {
     path: "/{connectionId}/v3/Mail",
     method: "GET",
@@ -734,6 +740,100 @@ const OUTLOOK_APIS = {
       { name: "top", in: "query", required: false },
     ],
   },
+  SendEmailV2: {
+    path: "/{connectionId}/v2/Mail",
+    method: "POST",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "emailMessage", in: "body", required: true },
+    ],
+  },
+  ForwardEmail: {
+    path: "/{connectionId}/codeless/api/v2.0/me/messages/{message_id}/forward",
+    method: "POST",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "message_id", in: "path", required: true },
+      { name: "body", in: "body", required: true },
+    ],
+  },
+  ReplyToV3: {
+    path: "/{connectionId}/v3/Mail/ReplyTo/{messageId}",
+    method: "POST",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "messageId", in: "path", required: true },
+      { name: "replyParameters", in: "body", required: true },
+      { name: "mailboxAddress", in: "query", required: false },
+    ],
+  },
+  MoveV2: {
+    path: "/{connectionId}/v2/Mail/Move/{messageId}",
+    method: "POST",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "messageId", in: "path", required: true },
+      { name: "folderPath", in: "query", required: true },
+      { name: "mailboxAddress", in: "query", required: false },
+    ],
+  },
+  DeleteEmail: {
+    path: "/{connectionId}/Mail/{messageId}",
+    method: "DELETE",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "messageId", in: "path", required: true },
+    ],
+  },
+  SharedMailboxSendEmailV2: {
+    path: "/{connectionId}/v2/SharedMailbox/Mail",
+    method: "POST",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "emailMessage", in: "body", required: true },
+    ],
+  },
+  // ── Calendar operations ──
+  V4CalendarGetItems: {
+    path: "/{connectionId}/datasets/calendars/v4/tables/{table}/items",
+    method: "GET",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "table", in: "path", required: true },
+      { name: "$filter", in: "query", required: false },
+      { name: "$orderby", in: "query", required: false },
+      { name: "$top", in: "query", required: false },
+      { name: "$skip", in: "query", required: false },
+    ],
+  },
+  V4CalendarPostItem: {
+    path: "/{connectionId}/datasets/calendars/v4/tables/{table}/items",
+    method: "POST",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "table", in: "path", required: true },
+      { name: "item", in: "body", required: true },
+    ],
+  },
+  V4CalendarPatchItem: {
+    path: "/{connectionId}/datasets/calendars/v4/tables/{table}/items/{id}",
+    method: "PATCH",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "table", in: "path", required: true },
+      { name: "id", in: "path", required: true },
+      { name: "item", in: "body", required: true },
+    ],
+  },
+  CalendarDeleteItem: {
+    path: "/{connectionId}/datasets/calendars/tables/{table}/items/{id}",
+    method: "DELETE",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "table", in: "path", required: true },
+      { name: "id", in: "path", required: true },
+    ],
+  },
 };
 
 // ── Initialize SDK client for the Office 365 Outlook connector ──
@@ -818,16 +918,152 @@ async function execOutlookOp(operationName, parameters) {
   throw new Error("No Outlook connection reference matched. Tried: " + aErrors.join(" || "));
 }
 
+// ── Generic: call any Outlook connector operation ──────────────
+export async function callOutlookOperation(sOperationName, oParameters) {
+  return _dbgWrap('callOutlookOperation', [sOperationName, oParameters], async function() {
+  return execOutlookOp(sOperationName, oParameters);
+  });
+}
+
+// ── Send Email ─────────────────────────────────────────────────
+export async function sendEmail({ to, cc, bcc, subject, body, isHtml, importance, attachments } = {}) {
+  return _dbgWrap('sendEmail', [{ to, cc, bcc, subject, body, isHtml, importance, attachments }], async function() {
+  var oMessage = {
+    To: to,
+    Subject: subject,
+    Body: body,
+  };
+  if (cc) oMessage.Cc = cc;
+  if (bcc) oMessage.Bcc = bcc;
+  if (importance) oMessage.Importance = importance;
+  if (attachments) oMessage.Attachments = attachments;
+  if (isHtml === false) oMessage.IsHtml = false;
+
+  return execOutlookOp("SendEmailV2", { emailMessage: oMessage });
+  });
+}
+
+// ── Forward Email ──────────────────────────────────────────────
+export async function forwardEmail(sMessageId, { to, comment } = {}) {
+  return _dbgWrap('forwardEmail', [sMessageId, { to, comment }], async function() {
+  return execOutlookOp("ForwardEmail", {
+    message_id: sMessageId,
+    body: { ToRecipients: to, Comment: comment },
+  });
+  });
+}
+
+// ── Reply to Email ─────────────────────────────────────────────
+export async function replyToEmail(sMessageId, { comment, replyAll } = {}) {
+  return _dbgWrap('replyToEmail', [sMessageId, { comment, replyAll }], async function() {
+  return execOutlookOp("ReplyToV3", {
+    messageId: sMessageId,
+    replyParameters: { Body: comment, ReplyAll: replyAll === true },
+  });
+  });
+}
+
 // ── List Emails ────────────────────────────────────────────────
 export async function listEmails({ folderId = "Inbox", fetchOnlyUnread, searchQuery, top, skip } = {}) {
   return _dbgWrap('listEmails', [{ folderId, fetchOnlyUnread, searchQuery, top, skip }], async function() {
-  void skip;
-
   return execOutlookOp("GetEmailsV3", {
     folderPath: folderId,
-    fetchOnlyUnread,
-    searchQuery,
+    fetchOnlyUnread: fetchOnlyUnread,
+    searchQuery: searchQuery,
     top: top != null ? top : 10,
+    skip: skip,
+  });
+  });
+}
+
+// ── Send from Shared Mailbox ───────────────────────────────────
+export async function sendFromSharedMailbox(sSharedMailbox, { to, cc, bcc, subject, body, importance, attachments } = {}) {
+  return _dbgWrap('sendFromSharedMailbox', [sSharedMailbox, { to, cc, bcc, subject, body, importance, attachments }], async function() {
+  var oMessage = {
+    MailboxAddress: sSharedMailbox,
+    To: to,
+    Subject: subject,
+    Body: body,
+  };
+  if (cc) oMessage.Cc = cc;
+  if (bcc) oMessage.Bcc = bcc;
+  if (importance) oMessage.Importance = importance;
+  if (attachments) oMessage.Attachments = attachments;
+
+  return execOutlookOp("SharedMailboxSendEmailV2", { emailMessage: oMessage });
+  });
+}
+
+// ── Move Email ─────────────────────────────────────────────────
+export async function moveEmail(sMessageId, sDestinationFolderId) {
+  return _dbgWrap('moveEmail', [sMessageId, sDestinationFolderId], async function() {
+  return execOutlookOp("MoveV2", {
+    messageId: sMessageId,
+    folderPath: sDestinationFolderId,
+  });
+  });
+}
+
+// ── Delete Email ───────────────────────────────────────────────
+export async function deleteEmail(sMessageId) {
+  return _dbgWrap('deleteEmail', [sMessageId], async function() {
+  return execOutlookOp("DeleteEmail", { messageId: sMessageId });
+  });
+}
+
+// ── Create Event ───────────────────────────────────────────────
+export async function createEvent({ subject, start, end, attendees, body, location, importance, isAllDay, timeZone, calendarId } = {}) {
+  return _dbgWrap('createEvent', [{ subject, start, end, attendees, body, location, importance, isAllDay, timeZone, calendarId }], async function() {
+  var sAttendees = Array.isArray(attendees) ? attendees.join(";") : attendees;
+  var oItem = {
+    subject: subject,
+    start: start,
+    end: end,
+    timeZone: timeZone || "",
+  };
+  if (sAttendees) oItem.requiredAttendees = sAttendees;
+  if (body) oItem.body = body;
+  if (location) oItem.location = location;
+  if (importance) oItem.importance = importance;
+  if (isAllDay) oItem.isAllDay = true;
+
+  return execOutlookOp("V4CalendarPostItem", {
+    table: calendarId || "Calendar",
+    item: oItem,
+  });
+  });
+}
+
+// ── List Events ────────────────────────────────────────────────
+export async function listEvents({ calendarId = "Calendar", filter, orderBy, top, skip } = {}) {
+  return _dbgWrap('listEvents', [{ calendarId, filter, orderBy, top, skip }], async function() {
+  return execOutlookOp("V4CalendarGetItems", {
+    table: calendarId,
+    $filter: filter,
+    $orderby: orderBy,
+    $top: top,
+    $skip: skip,
+  });
+  });
+}
+
+// ── Edit Event ─────────────────────────────────────────────────
+export async function editEvent(sEventId, oChangedFields, sCalendarId) {
+  return _dbgWrap('editEvent', [sEventId, oChangedFields, sCalendarId], async function() {
+  return execOutlookOp("V4CalendarPatchItem", {
+    table: sCalendarId || "Calendar",
+    id: sEventId,
+    item: oChangedFields,
+  });
+  });
+}
+
+// ── Delete Event ───────────────────────────────────────────────
+export async function deleteEvent(sEventId, sCalendarId) {
+  return _dbgWrap('deleteEvent', [sEventId, sCalendarId], async function() {
+  return execOutlookOp("CalendarDeleteItem", {
+    table: sCalendarId || "Calendar",
+    id: sEventId,
   });
   });
 }