codeapp-js 0.3.0 → 1.0.1

package/dev files/customConnector.js

@@ -1,98 +0,0 @@
-// 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,120 +0,0 @@
-import { getClient, getContext } from "./power-apps-data.js";
-
-// ── Table Registry (populated at runtime via registerTable) ────
-let oDataSources = {};
-
-// ── Register a Dataverse table for use by the library ──────────
-export function registerTable(sTableName, sPrimaryKey) {
-  oDataSources[sTableName] = {
-    tableId: '',
-    version: '',
-    primaryKey: sPrimaryKey,
-    dataSourceType: 'Dataverse',
-    apis: {}
-  };
-  // reset client so it picks up the new table on next call
-  oSharedClient = null;
-}
-
-// ── Initialize SDK & Client ────────────────────────────────────
-let oSharedClient = null;
-
-function getSharedClient() {
-  if (!oSharedClient) {
-    oSharedClient = getClient(oDataSources);
-  }
-  return oSharedClient;
-}
-
-// ── Ensure value is an array (accepts array or comma-separated string)
-function ensureArray(value) {
-  if (!value) return value;
-  if (Array.isArray(value)) return value;
-  if (typeof value === 'string') return value.split(',').map(function (s) { return s.trim(); });
-  return value;
-}
-
-// ── Unwrap SDK response ────────────────────────────────────────
-function unwrapResult(result) {
-  if (result && result.success === false) {
-    var sMsg = result.error ? (result.error.message || JSON.stringify(result.error)) : 'Operation failed';
-    throw new Error(sMsg);
-  }
-  return result && 'data' in result ? result.data : result;
-}
-
-// ── Create ─────────────────────────────────────────────────────
-export async function createItem(tableName, primaryKey, record) {
-  const client = getSharedClient();
-  const result = await client.createRecordAsync(tableName, record);
-  return unwrapResult(result);
-}
-
-// ── Read (single) ──────────────────────────────────────────────
-export async function getItem(tableName, primaryKey, id, select) {
-  const client = getSharedClient();
-  select = ensureArray(select);
-  const options = select ? { select } : undefined;
-  const result = await client.retrieveRecordAsync(tableName, id, options);
-  return unwrapResult(result);
-}
-
-// ── List (multiple) ────────────────────────────────────────────
-export async function listItems(tableName, primaryKey, { filter, select, orderBy, top, skip } = {}) {
-  const client = getSharedClient();
-  select = ensureArray(select);
-  orderBy = ensureArray(orderBy);
-  const result = await client.retrieveMultipleRecordsAsync(tableName, {
-    filter,
-    select,
-    orderBy,
-    top,
-    skip,
-  });
-  var unwrapped = unwrapResult(result);
-  return { entities: Array.isArray(unwrapped) ? unwrapped : [] };
-}
-
-// ── Update ─────────────────────────────────────────────────────
-export async function updateItem(tableName, primaryKey, id, changedFields) {
-  const client = getSharedClient();
-  const result = await client.updateRecordAsync(tableName, id, changedFields);
-  return unwrapResult(result);
-}
-
-// ── Delete ─────────────────────────────────────────────────────
-export async function deleteItem(tableName, primaryKey, id) {
-  const client = getSharedClient();
-  const result = await client.deleteRecordAsync(tableName, id);
-  return unwrapResult(result);
-}
-
-// ── 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) {
-  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() {
-  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,55 +0,0 @@
-import { getClient } from "./power-apps-data.js";
-
-// ── All Table Definitions ──────────────────────────────────────
-const ALL_DATA_SOURCES = {
-  environmentvariabledefinitions: { tableId: "", version: "", primaryKey: "environmentvariabledefinitionid", dataSourceType: "Dataverse", apis: {} },
-  environmentvariablevalues:      { tableId: "", version: "", primaryKey: "environmentvariablevalueid",      dataSourceType: "Dataverse", apis: {} },
-};
-
-// ── Initialize SDK & Client ────────────────────────────────────
-let oSharedClient = null;
-
-function getSharedClient() {
-  if (!oSharedClient) {
-    oSharedClient = getClient(ALL_DATA_SOURCES);
-  }
-  return oSharedClient;
-}
-
-// ── Unwrap SDK response ────────────────────────────────────────
-function unwrapResult(result) {
-  if (result && result.success === false) {
-    let sMsg = result.error ? (result.error.message || JSON.stringify(result.error)) : "Operation failed";
-    throw new Error(sMsg);
-  }
-  return result && "data" in result ? result.data : result;
-}
-
-// ── Get Environment Variable (single query with expand) ────────
-export async function getEnvironmentVariable(sSchemaName) {
-  let client = getSharedClient();
-
-  // Try single query: filter values by expanded definition schema name
-  let valResult = await client.retrieveMultipleRecordsAsync("environmentvariablevalues", {
-    filter: "EnvironmentVariableDefinitionId/schemaname eq '" + sSchemaName + "'",
-    select: ["value"],
-    expand: [{ name: "EnvironmentVariableDefinitionId", select: ["defaultvalue", "schemaname"] }],
-  });
-  let aVals = unwrapResult(valResult);
-
-  // If value record exists, return it
-  if (Array.isArray(aVals) && aVals.length > 0 && aVals[0].value) {
-    return aVals[0].value;
-  }
-
-  // No value record — fall back to definition default value
-  let defResult = await client.retrieveMultipleRecordsAsync("environmentvariabledefinitions", {
-    filter: "schemaname eq '" + sSchemaName + "'",
-    select: ["defaultvalue"],
-  });
-  let aDefs = unwrapResult(defResult);
-  if (!Array.isArray(aDefs) || aDefs.length === 0) {
-    throw new Error("Environment variable not found: " + sSchemaName);
-  }
-  return aDefs[0].defaultvalue || "";
-}

package/dev files/office365groups.js

@@ -1,65 +0,0 @@
-import { getClient } from "./power-apps-data.js";
-
-// ── Data source name (must match connectionReferences in power.config.json) ──
-const DATA_SOURCE = "Office365Groups";
-
-// ── Initialize SDK client for the Office 365 Groups connector ──
-function initClient() {
-  const dataSourcesInfo = {
-    [DATA_SOURCE]: {
-      tableId: "",
-      version: "",
-      primaryKey: "",
-      dataSourceType: "Connector",
-      apis: {},
-    },
-  };
-  return getClient(dataSourcesInfo);
-}
-
-// ── Internal: execute a connector operation ────────────────────
-async function execOp(operationName, parameters) {
-  const client = await initClient();
-  return client.executeAsync({
-    connectorOperation: {
-      tableName: DATA_SOURCE,
-      operationName,
-      parameters,
-    },
-  });
-}
-
-// ═══════════════════════════════════════════════════════════════
-//  GENERIC
-// ═══════════════════════════════════════════════════════════════
-
-// ── Call any Office 365 Groups operation by name ───────────────
-export async function callGroupsOperation(operationName, parameters = {}) {
-  return execOp(operationName, parameters);
-}
-
-// ── Open HTTP Request ──────────────────────────────────────────
-export async function openHttpRequest({ method = "GET", uri, headers, body }) {
-  return execOp("HttpRequest", {
-    method,
-    uri,
-    headers: headers || {},
-    body: body || "",
-  });
-}
-
-// ═══════════════════════════════════════════════════════════════
-//  GROUPS
-// ═══════════════════════════════════════════════════════════════
-
-// ── List My Groups ─────────────────────────────────────────────
-export async function listMyGroups() {
-  return execOp("ListOwnedGroups", {});
-}
-
-// ── List Members of a Group ────────────────────────────────────
-export async function listGroupMembers(groupId) {
-  return execOp("ListGroupMembers", {
-    groupId,
-  });
-}

package/dev files/office365users.js

@@ -1,169 +0,0 @@
-import { getClient } from "./power-apps-data.js";
-
-// ── Data source name (must match connectionReferences in power.config.json) ──
-const DATA_SOURCE = "office365users";
-
-// ── Initialize SDK client for the Office 365 Users connector ───
-function initClient() {
-  const dataSourcesInfo = {
-    [DATA_SOURCE]: {
-      tableId: "",
-      version: "",
-      primaryKey: "",
-      dataSourceType: "Connector",
-      apis: {
-        MyProfile_V2: {
-          path: "/{connectionId}/codeless/v1.0/me",
-          method: "GET",
-          parameters: [
-            { name: "connectionId", in: "path", required: true },
-          ],
-        },
-        UserProfile_V2: {
-          path: "/{connectionId}/codeless/v1.0/users/{id}",
-          method: "GET",
-          parameters: [
-            { name: "connectionId", in: "path", required: true },
-            { name: "id", in: "path", required: true },
-          ],
-        },
-        Manager_V2: {
-          path: "/{connectionId}/codeless/v1.0/users/{id}/manager",
-          method: "GET",
-          parameters: [
-            { name: "connectionId", in: "path", required: true },
-            { name: "id", in: "path", required: true },
-          ],
-        },
-        DirectReports_V2: {
-          path: "/{connectionId}/codeless/v1.0/users/{id}/directReports",
-          method: "GET",
-          parameters: [
-            { name: "connectionId", in: "path", required: true },
-            { name: "id", in: "path", required: true },
-          ],
-        },
-        UserPhoto_V2: {
-          path: "/{connectionId}/codeless/v1.0/users/{id}/photo/$value",
-          method: "GET",
-          parameters: [
-            { name: "connectionId", in: "path", required: true },
-            { name: "id", in: "path", required: true },
-          ],
-          responseInfo: { "200": "image/jpeg" },
-        },
-        SearchUser_V2: {
-          path: "/{connectionId}/codeless/v1.0/users",
-          method: "GET",
-          parameters: [
-            { name: "connectionId", in: "path", required: true },
-            { name: "searchTerm", in: "query", required: false },
-            { name: "$top", in: "query", required: false },
-            { name: "$skip", in: "query", required: false },
-          ],
-        },
-        HttpRequest: {
-          path: "/{connectionId}/codeless/v1.0/httprequest",
-          method: "POST",
-          parameters: [
-            { name: "connectionId", in: "path", required: true },
-          ],
-        },
-      },
-    },
-  };
-  return getClient(dataSourcesInfo);
-}
-
-// ── Internal: execute a connector operation ────────────────────
-async function execOp(operationName, parameters) {
-  const client = await initClient();
-  const result = await client.executeAsync({
-    connectorOperation: {
-      tableName: DATA_SOURCE,
-      operationName,
-      parameters,
-    },
-  });
-  if (!result.success) {
-    throw new Error(result.error?.message || "Operation failed");
-  }
-  return result.data;
-}
-
-// ═══════════════════════════════════════════════════════════════
-//  GENERIC
-// ═══════════════════════════════════════════════════════════════
-
-// ── Call any Office 365 Users operation by name ────────────────
-export async function callUsersOperation(operationName, parameters = {}) {
-  return execOp(operationName, parameters);
-}
-
-// ── Open HTTP Request ──────────────────────────────────────────
-export async function openHttpRequest({ method = "GET", uri, headers, body }) {
-  return execOp("HttpRequest", {
-    method,
-    uri,
-    headers: headers || {},
-    body: body || "",
-  });
-}
-
-// ═══════════════════════════════════════════════════════════════
-//  PROFILE
-// ═══════════════════════════════════════════════════════════════
-
-// ── Get My Profile ─────────────────────────────────────────────
-export async function getMyProfile() {
-  return execOp("MyProfile_V2", {});
-}
-
-// ── Get User Profile ───────────────────────────────────────────
-export async function getUserProfile(userId) {
-  return execOp("UserProfile_V2", {
-    id: userId,
-  });
-}
-
-// ═══════════════════════════════════════════════════════════════
-//  MANAGER & REPORTS
-// ═══════════════════════════════════════════════════════════════
-
-// ── Get Manager ────────────────────────────────────────────────
-export async function getManager(userId) {
-  return execOp("Manager_V2", {
-    id: userId,
-  });
-}
-
-// ── Get Direct Reports ─────────────────────────────────────────
-export async function getDirectReports(userId) {
-  return execOp("DirectReports_V2", {
-    id: userId,
-  });
-}
-
-// ═══════════════════════════════════════════════════════════════
-//  PHOTO
-// ═══════════════════════════════════════════════════════════════
-
-// ── Get User Photo ─────────────────────────────────────────────
-export async function getUserPhoto(userId) {
-  return execOp("UserPhoto_V2", {
-    id: userId,
-  });
-}
-
-// ═══════════════════════════════════════════════════════════════
-//  SEARCH
-// ═══════════════════════════════════════════════════════════════
-
-// ── Search for Users ───────────────────────────────────────────
-export async function searchForUsers({ searchTerm, top, skip } = {}) {
-  const params = {};
-  if (searchTerm) params.searchTerm = searchTerm;
-  if (top != null) params.$top = top;
-  if (skip != null) params.$skip = skip;
-  return execOp("SearchUser_V2", params);
-}