codeapp-js 0.2.2 → 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/customConnector.js

@@ -0,0 +1,98 @@
+// Custom Connector Utility for Power Apps Code-First SDK
+// This module provides generic functions to call any custom connector operation.
+// Usage: import and use callCustomConnectorOperation or openCustomConnectorHttpRequest.
+
+import { getClient } from "./power-apps-data.js";
+
+// ── Data source name (set to your custom connector name) ──
+const DATA_SOURCE_NAME = "<yourCustomConnectorName>"; // Replace with your connector name
+const CUSTOM_CONNECTOR_APIS = {};
+
+// ── Initialize SDK client for the custom connector ──
+function initClient() {
+  const dataSourcesInfo = {
+    [DATA_SOURCE_NAME]: {
+      tableId: "",
+      version: "",
+      primaryKey: "",
+      dataSourceType: "Connector",
+      apis: CUSTOM_CONNECTOR_APIS,
+    },
+  };
+  return getClient(dataSourcesInfo);
+}
+
+function stringifyErrorDetails(oError) {
+  if (!oError) return "Operation failed";
+  if (typeof oError === "string") return oError;
+  if (oError instanceof Error) return oError.message || "Operation failed";
+  var aPropertyNames = Object.getOwnPropertyNames(oError);
+  var oSerializable = {};
+  aPropertyNames.forEach((sName) => {
+    oSerializable[sName] = oError[sName];
+  });
+  try {
+    return JSON.stringify(oSerializable);
+  } catch {
+    return String(oError);
+  }
+}
+
+function unwrapResult(oResult) {
+  if (oResult && oResult.success === false) {
+    var sMessage = stringifyErrorDetails(oResult.error);
+    if (oResult.data !== undefined) {
+      sMessage += " | data: " + stringifyErrorDetails(oResult.data);
+    }
+    throw new Error(sMessage);
+  }
+  if (oResult && Object.prototype.hasOwnProperty.call(oResult, "data")) {
+    return oResult.data;
+  }
+  return oResult;
+}
+
+// ── Internal: execute a connector operation ────────────────────
+async function execOp(operationName, parameters) {
+  const client = await initClient();
+  try {
+    const result = await client.executeAsync({
+      connectorOperation: {
+        tableName: DATA_SOURCE_NAME,
+        operationName,
+        parameters,
+      },
+    });
+    return unwrapResult(result);
+  } catch (oErr) {
+    throw new Error(DATA_SOURCE_NAME + ": " + stringifyErrorDetails(oErr));
+  }
+}
+
+// ── Call any custom connector operation by name ───────────────
+export async function callCustomConnectorOperation(operationName, parameters = {}) {
+  return execOp(operationName, parameters);
+}
+
+// ── Open HTTP Request (for advanced scenarios) ────────────────
+export async function openCustomConnectorHttpRequest({ method = "GET", uri, headers, body }) {
+  const client = await initClient();
+  try {
+    const result = await client.executeAsync({
+      httpRequest: {
+        tableName: DATA_SOURCE_NAME,
+        method,
+        uri,
+        headers,
+        body,
+      },
+    });
+    return unwrapResult(result);
+  } catch (oErr) {
+    throw new Error(DATA_SOURCE_NAME + ": " + stringifyErrorDetails(oErr));
+  }
+}
+
+// ── Example Usage ─────────────────────────────────────────────
+// callCustomConnectorOperation("MyAction", { param1: "value" })
+// openCustomConnectorHttpRequest({ method: "POST", uri: "/myapi", body: { ... } })

package/dev files/dataverse.js

@@ -1,4 +1,4 @@
-import { getClient } from "@microsoft/power-apps/data";
+import { getClient, getContext } from "./power-apps-data.js";
 
 // ── Table Registry (populated at runtime via registerTable) ────
 let oDataSources = {};
@@ -90,16 +90,31 @@ export async function deleteItem(tableName, primaryKey, id) {
 }
 
 // ── Unbound Action ─────────────────────────────────────────────
+// Calls an unbound Dataverse action by POSTing to the action endpoint.
+// The actionName must be declared in power.config.json under
+// databaseReferences.default.cds.dataSources, e.g.:
+//   "WhoAmI": { "entitySetName": "WhoAmI", "logicalName": "whoami", "isHidden": false }
 export async function callUnboundAction(tableName, primaryKey, actionName, params) {
-  const client = getSharedClient();
-  const result = await client.invokeActionAsync(tableName, actionName, params);
+  if (!oDataSources[actionName]) {
+    oDataSources[actionName] = {
+      tableId: '',
+      version: '',
+      primaryKey: '',
+      dataSourceType: 'Dataverse',
+      apis: {}
+    };
+    oSharedClient = null;
+  }
+  var client = getSharedClient();
+  var result = await client.createRecordAsync(actionName, params || {});
   return unwrapResult(result);
 }
 
 // ── WhoAmI ─────────────────────────────────────────────────────
 export async function whoAmI() {
-  const client = getSharedClient();
-  const result = await client.invokeActionAsync('', '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;
 }

package/dev files/environmentVar.js

@@ -1,4 +1,4 @@
-import { getClient } from "@microsoft/power-apps/data";
+import { getClient } from "./power-apps-data.js";
 
 // ── All Table Definitions ──────────────────────────────────────
 const ALL_DATA_SOURCES = {

package/dev files/office365groups.js

@@ -1,4 +1,4 @@
-import { getClient } from "@microsoft/power-apps/data";
+import { getClient } from "./power-apps-data.js";
 
 // ── Data source name (must match connectionReferences in power.config.json) ──
 const DATA_SOURCE = "Office365Groups";

package/dev files/office365users.js

@@ -1,4 +1,4 @@
-import { getClient } from "@microsoft/power-apps/data";
+import { getClient } from "./power-apps-data.js";
 
 // ── Data source name (must match connectionReferences in power.config.json) ──
 const DATA_SOURCE = "office365users";

package/dev files/outlook.js

@@ -1,4 +1,4 @@
-import { getClient } from "@microsoft/power-apps/data";
+import { getClient } from "./power-apps-data.js";
 
 // ── Data source name (must match connectionReferences in power.config.json) ──
 const DATA_SOURCE_CANDIDATES = ["office365outlook", "Office365Outlook", "office365"];