codeapp-js 0.2.1 → 0.3.0

package/codeApp/src/generated/services/Office365UsersService.ts

@@ -0,0 +1,358 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ * This file is autogenerated. Do not edit this file directly.
+ */
+
+import type { ClientPhotoMetadata } from '../models/Office365UsersModel';
+import type { EntityListResponse_IReadOnlyList_User } from '../models/Office365UsersModel';
+import type { GraphTrending } from '../models/Office365UsersModel';
+import type { GraphUserUpdateable_V1 } from '../models/Office365UsersModel';
+import type { GraphUser_V1 } from '../models/Office365UsersModel';
+import type { IOperationResult } from '@microsoft/power-apps/data';
+import type { LinklessEntityListResponse_List_Person } from '../models/Office365UsersModel';
+import type { ObjectWithoutType } from '../models/Office365UsersModel';
+import type { User } from '../models/Office365UsersModel';
+import { dataSourcesInfo } from '../../../.power/schemas/appschemas/dataSourcesInfo';
+import { getClient } from '@microsoft/power-apps/data';
+
+export class Office365UsersService {
+  private static readonly dataSourceName = 'office365users';
+
+  private static readonly client = getClient(dataSourcesInfo);
+
+  /**
+   * Update my profile
+   * Updates the profile of the current user
+   */
+  public static async UpdateMyProfile(body?: GraphUserUpdateable_V1): Promise<IOperationResult<void>> {
+    const params: { body?: GraphUserUpdateable_V1 } = { body };
+    const result = await Office365UsersService.client.executeAsync<{ body?: GraphUserUpdateable_V1 }, void>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'UpdateMyProfile',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get my profile (V2)
+   * Retrieves the profile of the current user. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
+   */
+  public static async MyProfile_V2($select?: string): Promise<IOperationResult<GraphUser_V1>> {
+    const params: { $select?: string } = { $select };
+    const result = await Office365UsersService.client.executeAsync<{ $select?: string }, GraphUser_V1>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'MyProfile_V2',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Update my profile photo
+   * Updates the profile photo of the current user. The size of the photo must be less than 4 MB.
+   */
+  public static async UpdateMyPhoto(body: string, Content_Type: string): Promise<IOperationResult<void>> {
+    const params: { body: string, Content_Type: string } = { body, Content_Type };
+    const result = await Office365UsersService.client.executeAsync<{ body: string, Content_Type: string }, void>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'UpdateMyPhoto',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get my trending documents
+   * Retrieves the trending documents for the signed in user
+   */
+  public static async MyTrendingDocuments($filter?: string, extractSensitivityLabel?: boolean, fetchSensitivityLabelMetadata?: boolean): Promise<IOperationResult<{ value: GraphTrending[] }>> {
+    const params: { $filter?: string, extractSensitivityLabel?: boolean, fetchSensitivityLabelMetadata?: boolean } = { $filter, extractSensitivityLabel, fetchSensitivityLabelMetadata };
+    const result = await Office365UsersService.client.executeAsync<{ $filter?: string, extractSensitivityLabel?: boolean, fetchSensitivityLabelMetadata?: boolean }, { value: GraphTrending[] }>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'MyTrendingDocuments',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get relevant people
+   * Get relevant people.
+   */
+  public static async RelevantPeople(userId: string): Promise<IOperationResult<LinklessEntityListResponse_List_Person>> {
+    const params: { userId: string } = { userId };
+    const result = await Office365UsersService.client.executeAsync<{ userId: string }, LinklessEntityListResponse_List_Person>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'RelevantPeople',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get my profile (V1)
+   * Retrieves the profile of the current user.
+   */
+  public static async MyProfile(): Promise<IOperationResult<User>> {
+    const result = await Office365UsersService.client.executeAsync<void, User>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'MyProfile',
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get user profile (V1)
+   * Retrieves the profile of a specific user.
+   */
+  public static async UserProfile(userId: string): Promise<IOperationResult<User>> {
+    const params: { userId: string } = { userId };
+    const result = await Office365UsersService.client.executeAsync<{ userId: string }, User>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'UserProfile',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get user photo metadata
+   * Get user photo metadata.
+   */
+  public static async UserPhotoMetadata(userId: string): Promise<IOperationResult<ClientPhotoMetadata>> {
+    const params: { userId: string } = { userId };
+    const result = await Office365UsersService.client.executeAsync<{ userId: string }, ClientPhotoMetadata>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'UserPhotoMetadata',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get user photo (V1)
+   * Retrieves the photo of the specified user if they have one.
+   */
+  public static async UserPhoto(userId: string): Promise<IOperationResult<string>> {
+    const params: { userId: string } = { userId };
+    const result = await Office365UsersService.client.executeAsync<{ userId: string }, string>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'UserPhoto',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get manager (V1)
+   * Retrieves the profile of the specified user's manager.
+   */
+  public static async Manager(userId: string): Promise<IOperationResult<User>> {
+    const params: { userId: string } = { userId };
+    const result = await Office365UsersService.client.executeAsync<{ userId: string }, User>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'Manager',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get direct reports (V1)
+   * Retrieves the user profiles of the specified user's direct reports.
+   */
+  public static async DirectReports(userId: string): Promise<IOperationResult<User[]>> {
+    const params: { userId: string } = { userId };
+    const result = await Office365UsersService.client.executeAsync<{ userId: string }, User[]>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'DirectReports',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Search for users
+   * Retrieves the user profiles that match the search term.
+   */
+  public static async SearchUser(searchTerm?: string, top?: number): Promise<IOperationResult<User[]>> {
+    const params: { searchTerm?: string, top?: number } = { searchTerm, top };
+    const result = await Office365UsersService.client.executeAsync<{ searchTerm?: string, top?: number }, User[]>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'SearchUser',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Search for users (V2)
+   * Retrieves the user profiles that match the search term (V2).
+   */
+  public static async SearchUserV2(searchTerm?: string, top?: number, isSearchTermRequired?: boolean, skipToken?: string): Promise<IOperationResult<EntityListResponse_IReadOnlyList_User>> {
+    const params: { searchTerm?: string, top?: number, isSearchTermRequired?: boolean, skipToken?: string } = { searchTerm, top, isSearchTermRequired, skipToken };
+    const result = await Office365UsersService.client.executeAsync<{ searchTerm?: string, top?: number, isSearchTermRequired?: boolean, skipToken?: string }, EntityListResponse_IReadOnlyList_User>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'SearchUserV2',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Tests the connection
+   * Tests the connection.
+   */
+  public static async TestConnection(): Promise<IOperationResult<void>> {
+    const result = await Office365UsersService.client.executeAsync<void, void>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'TestConnection',
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get user profile (V2)
+   * Retrieves the profile of a specific user. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
+   */
+  public static async UserProfile_V2(id: string, $select?: string): Promise<IOperationResult<GraphUser_V1>> {
+    const params: { id: string, $select?: string } = { id, $select };
+    const result = await Office365UsersService.client.executeAsync<{ id: string, $select?: string }, GraphUser_V1>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'UserProfile_V2',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get manager (V2)
+   * Retrieves the profile of the specified user's manager. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
+   */
+  public static async Manager_V2(id: string, $select?: string): Promise<IOperationResult<GraphUser_V1>> {
+    const params: { id: string, $select?: string } = { id, $select };
+    const result = await Office365UsersService.client.executeAsync<{ id: string, $select?: string }, GraphUser_V1>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'Manager_V2',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get direct reports (V2)
+   * Retrieves the user profiles of the specified user's direct reports. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties
+   */
+  public static async DirectReports_V2(id: string, $select?: string, $top?: number): Promise<IOperationResult<{ value: GraphUser_V1[] }>> {
+    const params: { id: string, $select?: string, $top?: number } = { id, $select, $top };
+    const result = await Office365UsersService.client.executeAsync<{ id: string, $select?: string, $top?: number }, { value: GraphUser_V1[] }>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'DirectReports_V2',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get user photo (V2)
+   * Retrieves the photo of the specified user if they have one
+   */
+  public static async UserPhoto_V2(id: string): Promise<IOperationResult<string>> {
+    const params: { id: string } = { id };
+    const result = await Office365UsersService.client.executeAsync<{ id: string }, string>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'UserPhoto_V2',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Get trending documents
+   * Retrieves the trending documents for a user
+   */
+  public static async TrendingDocuments(id: string, $filter?: string, extractSensitivityLabel?: boolean, fetchSensitivityLabelMetadata?: boolean): Promise<IOperationResult<{ value: GraphTrending[] }>> {
+    const params: { id: string, $filter?: string, extractSensitivityLabel?: boolean, fetchSensitivityLabelMetadata?: boolean } = { id, $filter, extractSensitivityLabel, fetchSensitivityLabelMetadata };
+    const result = await Office365UsersService.client.executeAsync<{ id: string, $filter?: string, extractSensitivityLabel?: boolean, fetchSensitivityLabelMetadata?: boolean }, { value: GraphTrending[] }>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'TrendingDocuments',
+          parameters: params
+        },
+      });
+    return result;
+  }
+
+  /**
+   * Send an HTTP request
+   * Construct a Microsoft Graph REST API request to invoke. These segments are supported: 1st segement: /me, /users/<userId> 2nd segment: messages, mailFolders, events, calendar, calendars, outlook, inferenceClassification. Learn more: https://docs.microsoft.com/en-us/graph/use-the-api.
+   */
+  public static async HttpRequest(Uri: string, Method: string, Body?: string, ContentType?: string, CustomHeader1?: string, CustomHeader2?: string, CustomHeader3?: string, CustomHeader4?: string, CustomHeader5?: string): Promise<IOperationResult<ObjectWithoutType>> {
+    const params: { Uri: string, Method: string, Body?: string, ContentType?: string, CustomHeader1?: string, CustomHeader2?: string, CustomHeader3?: string, CustomHeader4?: string, CustomHeader5?: string } = { Uri, Method, Body, ContentType, CustomHeader1, CustomHeader2, CustomHeader3, CustomHeader4, CustomHeader5 };
+    const result = await Office365UsersService.client.executeAsync<{ Uri: string, Method: string, Body?: string, ContentType?: string, CustomHeader1?: string, CustomHeader2?: string, CustomHeader3?: string, CustomHeader4?: string, CustomHeader5?: string }, ObjectWithoutType>(
+      {
+        connectorOperation: {
+          tableName: Office365UsersService.dataSourceName,
+          operationName: 'HttpRequest',
+          parameters: params
+        },
+      });
+    return result;
+  }
+}

package/dev files/outlook.js

@@ -3,6 +3,7 @@ import { getClient } from "./power-apps-data.js";
 // ── 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",
@@ -24,6 +25,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 ──
@@ -78,7 +173,7 @@ function unwrapResult(oResult) {
 }
 
 // ── Internal: execute a connector operation ────────────────────
-async function execOp(operationName, parameters) {
+async function execOp(sOperationName, oParameters) {
   const client = await initClient();
   const aErrors = [];
 
@@ -86,15 +181,15 @@ async function execOp(operationName, parameters) {
     const sDataSourceName = DATA_SOURCE_CANDIDATES[iIndex];
 
     try {
-      const result = await client.executeAsync({
+      const oResult = await client.executeAsync({
         connectorOperation: {
           tableName: sDataSourceName,
-          operationName,
-          parameters,
+          operationName: sOperationName,
+          parameters: oParameters,
         },
       });
 
-      return unwrapResult(result);
+      return unwrapResult(oResult);
     } catch (oErr) {
       const sMessage = stringifyErrorDetails(oErr);
       aErrors.push(sDataSourceName + ": " + sMessage);
@@ -108,14 +203,128 @@ async function execOp(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 execOp(sOperationName, oParameters);
+}
+
+// ── Send Email ─────────────────────────────────────────────────
+export async function sendEmail({ to, cc, bcc, subject, body, isHtml, importance, attachments } = {}) {
+  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 execOp("SendEmailV2", { emailMessage: oMessage });
+}
+
+// ── Forward Email ──────────────────────────────────────────────
+export async function forwardEmail(sMessageId, { to, comment } = {}) {
+  return execOp("ForwardEmail", {
+    message_id: sMessageId,
+    body: { ToRecipients: to, Comment: comment },
+  });
+}
+
+// ── Reply to Email ─────────────────────────────────────────────
+export async function replyToEmail(sMessageId, { comment, replyAll } = {}) {
+  return execOp("ReplyToV3", {
+    messageId: sMessageId,
+    replyParameters: { Body: comment, ReplyAll: replyAll === true },
+  });
+}
+
 // ── List Emails ────────────────────────────────────────────────
 export async function listEmails({ folderId = "Inbox", fetchOnlyUnread, searchQuery, top, skip } = {}) {
-  void skip;
-
   return execOp("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 } = {}) {
+  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 execOp("SharedMailboxSendEmailV2", { emailMessage: oMessage });
+}
+
+// ── Move Email ─────────────────────────────────────────────────
+export async function moveEmail(sMessageId, sDestinationFolderId) {
+  return execOp("MoveV2", {
+    messageId: sMessageId,
+    folderPath: sDestinationFolderId,
+  });
+}
+
+// ── Delete Email ───────────────────────────────────────────────
+export async function deleteEmail(sMessageId) {
+  return execOp("DeleteEmail", { messageId: sMessageId });
+}
+
+// ── Create Event ───────────────────────────────────────────────
+export async function createEvent({ subject, start, end, attendees, body, location, importance, isAllDay, timeZone, calendarId } = {}) {
+  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 execOp("V4CalendarPostItem", {
+    table: calendarId || "Calendar",
+    item: oItem,
+  });
+}
+
+// ── List Events ────────────────────────────────────────────────
+export async function listEvents({ calendarId = "Calendar", filter, orderBy, top, skip } = {}) {
+  return execOp("V4CalendarGetItems", {
+    table: calendarId,
+    $filter: filter,
+    $orderby: orderBy,
+    $top: top,
+    $skip: skip,
+  });
+}
+
+// ── Edit Event ─────────────────────────────────────────────────
+export async function editEvent(sEventId, oChangedFields, sCalendarId) {
+  return execOp("V4CalendarPatchItem", {
+    table: sCalendarId || "Calendar",
+    id: sEventId,
+    item: oChangedFields,
+  });
+}
+
+// ── Delete Event ───────────────────────────────────────────────
+export async function deleteEvent(sEventId, sCalendarId) {
+  return execOp("CalendarDeleteItem", {
+    table: sCalendarId || "Calendar",
+    id: sEventId,
   });
 }