codeapp-js 0.1.1 → 0.2.1

package/codeApp/dist/codeapp.js

@@ -1,17 +1,20 @@
-import { getClient } from "@microsoft/power-apps/data";
-
-// ── All Table Definitions ──────────────────────────────────────
-const ALL_DATA_SOURCES = {
-  environmentvariabledefinitions: { tableId: "", version: "", primaryKey: "environmentvariabledefinitionid", dataSourceType: "Dataverse", apis: {} },
-  environmentvariablevalues:      { tableId: "", version: "", primaryKey: "environmentvariablevalueid",      dataSourceType: "Dataverse", apis: {} },
-};
+import { getClient, getContext, callActionAsync } from "./power-apps-data.js";
 
 // ── Initialize SDK & Client ────────────────────────────────────
 let oSharedClient = null;
+let oInitialDataSources = {};
+
+// ── Set initial data sources (call before any API calls) ───────
+export function initDataSources(oSources) {
+  return _dbgWrap('initDataSources', [oSources], function() {
+  oInitialDataSources = oSources || {};
+  oSharedClient = null;
+  });
+}
 
 function getSharedClient() {
   if (!oSharedClient) {
-    oSharedClient = getClient(ALL_DATA_SOURCES);
+    oSharedClient = getClient(Object.assign({}, oInitialDataSources, oDataSources));
   }
   return oSharedClient;
 }
@@ -25,8 +28,172 @@ function unwrapResult(result) {
   return result && "data" in result ? result.data : result;
 }
 
+// ── Debugger ───────────────────────────────────────────────────
+let _bDebugActive = false;
+let _aDebugEntries = [];
+let _eDebugPanel = null;
+let _eDebugIcon = null;
+let _eDebugList = null;
+let _iDebugCounter = 0;
+
+function _dbgWrap(sName, aArgs, fnBody) {
+  if (!_bDebugActive) return fnBody();
+  let oEntry = { iId: ++_iDebugCounter, sName: sName, aArgs: _dbgClone(aArgs), iTime: Date.now() };
+  _aDebugEntries.unshift(oEntry);
+  _dbgRenderEntry(oEntry, true);
+  let oResult;
+  try {
+    oResult = fnBody();
+  } catch (oErr) {
+    oEntry.oError = oErr && oErr.message ? oErr.message : String(oErr);
+    oEntry.iDuration = Date.now() - oEntry.iTime;
+    _dbgRenderEntry(oEntry, false);
+    throw oErr;
+  }
+  if (oResult && typeof oResult.then === 'function') {
+    return oResult.then(function(oVal) {
+      oEntry.oResult = _dbgClone(oVal);
+      oEntry.iDuration = Date.now() - oEntry.iTime;
+      _dbgRenderEntry(oEntry, false);
+      return oVal;
+    }, function(oErr) {
+      oEntry.oError = oErr && oErr.message ? oErr.message : String(oErr);
+      oEntry.iDuration = Date.now() - oEntry.iTime;
+      _dbgRenderEntry(oEntry, false);
+      throw oErr;
+    });
+  }
+  oEntry.oResult = _dbgClone(oResult);
+  oEntry.iDuration = Date.now() - oEntry.iTime;
+  _dbgRenderEntry(oEntry, false);
+  return oResult;
+}
+
+function _dbgClone(oVal) {
+  try { return JSON.parse(JSON.stringify(oVal)); }
+  catch (oErr) { return String(oVal); }
+}
+
+function _dbgFormatTime(iTimestamp) {
+  let oDate = new Date(iTimestamp);
+  let sH = String(oDate.getHours()).padStart(2, '0');
+  let sM = String(oDate.getMinutes()).padStart(2, '0');
+  let sS = String(oDate.getSeconds()).padStart(2, '0');
+  let sMs = String(oDate.getMilliseconds()).padStart(3, '0');
+  return sH + ':' + sM + ':' + sS + '.' + sMs;
+}
+
+function _dbgEscapeHtml(sStr) {
+  if (typeof sStr !== 'string') sStr = String(sStr);
+  return sStr.replace(new RegExp('&', 'g'), '&amp;').replace(new RegExp('<', 'g'), '&lt;').replace(new RegExp('>', 'g'), '&gt;');
+}
+
+function _dbgRenderEntry(oEntry, bPending) {
+  if (!_eDebugList) return;
+  let sId = 'dbg-' + oEntry.iId;
+  let eRow = _eDebugList.querySelector('[data-dbg-id="' + sId + '"]');
+  if (!eRow) {
+    eRow = document.createElement('div');
+    eRow.setAttribute('data-dbg-id', sId);
+    eRow.style.cssText = 'border-bottom:1px solid #333;padding:6px 8px;font-size:12px;cursor:pointer;';
+    _eDebugList.prepend(eRow);
+  }
+  let sStatus = bPending ? '\u23F3' : (oEntry.oError ? '\u274C' : '\u2705');
+  let sDuration = bPending ? '\u2026' : oEntry.iDuration + 'ms';
+  eRow.innerHTML = '<div style="display:flex;justify-content:space-between;align-items:center;gap:6px;">'
+    + '<span style="flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;"><strong>' + sStatus + ' ' + _dbgEscapeHtml(oEntry.sName) + '</strong></span>'
+    + '<span style="color:#888;font-size:11px;white-space:nowrap;">' + _dbgFormatTime(oEntry.iTime) + ' | ' + sDuration + '</span>'
+    + '<button class="dbg-copy" style="background:#333;color:#e0e0e0;border:1px solid #555;border-radius:3px;padding:1px 6px;cursor:pointer;font-size:11px;white-space:nowrap;" title="Copy to clipboard">⎘</button>'
+    + '</div>';
+  eRow.querySelector('.dbg-copy').onclick = function(e) {
+    e.stopPropagation();
+    let oData = { name: oEntry.sName, args: oEntry.aArgs, time: _dbgFormatTime(oEntry.iTime) };
+    if (oEntry.oError) { oData.error = oEntry.oError; }
+    else if (oEntry.oResult !== undefined) { oData.result = oEntry.oResult; }
+    if (oEntry.iDuration !== undefined) { oData.duration = oEntry.iDuration + 'ms'; }
+    navigator.clipboard.writeText(JSON.stringify(oData, null, 2)).then(function() {
+      let eBtn = eRow.querySelector('.dbg-copy');
+      eBtn.textContent = '\u2713';
+      setTimeout(function() { eBtn.textContent = '\u2398'; }, 1000);
+    });
+  };
+  eRow.onclick = function() {
+    let eDetail = eRow.querySelector('.dbg-detail');
+    if (eDetail) { eDetail.remove(); return; }
+    eDetail = document.createElement('div');
+    eDetail.className = 'dbg-detail';
+    eDetail.style.cssText = 'margin-top:4px;padding:4px;background:#1a1a2e;border-radius:4px;font-size:11px;overflow:auto;max-height:300px;';
+    let sArgsHtml = '<div style="color:#61dafb;margin-bottom:4px;"><b>Args:</b> <pre style="margin:2px 0;white-space:pre-wrap;word-break:break-all;">' + _dbgEscapeHtml(JSON.stringify(oEntry.aArgs, null, 2)) + '</pre></div>';
+    let sResultHtml = '';
+    if (oEntry.oError) {
+      sResultHtml = '<div style="color:#ff6b6b;"><b>Error:</b> <pre style="margin:2px 0;white-space:pre-wrap;word-break:break-all;">' + _dbgEscapeHtml(oEntry.oError) + '</pre></div>';
+    } else if (!bPending) {
+      sResultHtml = '<div style="color:#a8e6cf;"><b>Result:</b> <pre style="margin:2px 0;white-space:pre-wrap;word-break:break-all;">' + _dbgEscapeHtml(JSON.stringify(oEntry.oResult, null, 2)) + '</pre></div>';
+    }
+    eDetail.innerHTML = sArgsHtml + sResultHtml;
+    eRow.appendChild(eDetail);
+  };
+  if (_eDebugIcon) {
+    let eBadge = _eDebugIcon.querySelector('.dbg-badge');
+    if (eBadge) eBadge.textContent = String(_aDebugEntries.length);
+  }
+}
+
+function _dbgInjectUI() {
+  _eDebugIcon = document.createElement('div');
+  _eDebugIcon.id = 'codeapp-debug-icon';
+  _eDebugIcon.innerHTML = '<span style="font-size:18px;">\uD83D\uDC1B</span>'
+    + '<span class="dbg-badge" style="position:absolute;top:-4px;right:-4px;background:#ff6b6b;color:#fff;font-size:10px;border-radius:50%;width:18px;height:18px;display:flex;align-items:center;justify-content:center;">0</span>';
+  _eDebugIcon.style.cssText = 'position:fixed;top:10px;right:70px;z-index:999999;width:36px;height:36px;background:#1e1e2e;border:1px solid #444;border-radius:50%;display:flex;align-items:center;justify-content:center;cursor:pointer;box-shadow:0 2px 8px rgba(0,0,0,0.4);user-select:none;';
+  _eDebugIcon.onclick = function() {
+    _eDebugPanel.style.display = _eDebugPanel.style.display === 'none' ? 'flex' : 'none';
+  };
+  document.body.appendChild(_eDebugIcon);
+
+  _eDebugPanel = document.createElement('div');
+  _eDebugPanel.id = 'codeapp-debug-panel';
+  _eDebugPanel.style.cssText = 'position:fixed;top:0;right:0;z-index:999998;width:420px;height:100vh;background:#16161e;color:#e0e0e0;font-family:monospace;display:none;flex-direction:column;box-shadow:-4px 0 16px rgba(0,0,0,0.5);';
+
+  let eHeader = document.createElement('div');
+  eHeader.style.cssText = 'padding:10px 12px;background:#1e1e2e;border-bottom:1px solid #333;display:flex;justify-content:space-between;align-items:center;flex-shrink:0;';
+  eHeader.innerHTML = '<span style="font-weight:bold;font-size:14px;">\uD83D\uDC1B codeapp.js Debugger</span>';
+  let eClear = document.createElement('button');
+  eClear.textContent = 'Clear';
+  eClear.style.cssText = 'background:#333;color:#e0e0e0;border:1px solid #555;border-radius:4px;padding:3px 10px;cursor:pointer;font-size:12px;';
+  eClear.onclick = function() {
+    _aDebugEntries = [];
+    _eDebugList.innerHTML = '';
+    let eBadge = _eDebugIcon.querySelector('.dbg-badge');
+    if (eBadge) eBadge.textContent = '0';
+  };
+  eHeader.appendChild(eClear);
+  _eDebugPanel.appendChild(eHeader);
+
+  _eDebugList = document.createElement('div');
+  _eDebugList.style.cssText = 'flex:1;overflow-y:auto;';
+  _eDebugPanel.appendChild(_eDebugList);
+  document.body.appendChild(_eDebugPanel);
+
+  // Render entries logged before UI was ready
+  _aDebugEntries.slice().reverse().forEach(function(oEntry) {
+    _dbgRenderEntry(oEntry, false);
+  });
+}
+
+export function enableDebugger() {
+  console.warn("Debug mode enabled: all API calls will be logged in the debug panel. Call enableDebugger() only in development environments.");
+  if (_bDebugActive) return;
+  _bDebugActive = true;
+  if (document.body) {
+    _dbgInjectUI();
+  } else {
+    document.addEventListener('DOMContentLoaded', _dbgInjectUI);
+  }
+}
+
 // ── Get Environment Variable (single query with expand) ────────
 export async function getEnvironmentVariable(sSchemaName) {
+  return _dbgWrap('getEnvironmentVariable', [sSchemaName], async function() {
   let client = getSharedClient();
 
   // Try single query: filter values by expanded definition schema name
@@ -52,6 +219,7 @@ export async function getEnvironmentVariable(sSchemaName) {
     throw new Error("Environment variable not found: " + sSchemaName);
   }
   return aDefs[0].defaultvalue || "";
+  });
 }
 
 // ────────────────────────────────────────────────────────────────────────────
@@ -63,6 +231,7 @@ let oDataSources = {};
 
 // ── Register a Dataverse table for use by the library ──────────
 export function registerTable(sTableName, sPrimaryKey) {
+  return _dbgWrap('registerTable', [sTableName, sPrimaryKey], function() {
   oDataSources[sTableName] = {
     tableId: '',
     version: '',
@@ -72,6 +241,7 @@ export function registerTable(sTableName, sPrimaryKey) {
   };
   // reset client so it picks up the new table on next call
   oSharedClient = null;
+  });
 }
 
 // ── Ensure value is an array (accepts array or comma-separated string)
@@ -82,33 +252,29 @@ function ensureArray(value) {
   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) {
+  return _dbgWrap('createItem', [tableName, primaryKey, record], async function() {
   const client = getSharedClient();
   const result = await client.createRecordAsync(tableName, record);
   return unwrapResult(result);
+  });
 }
 
 // ── Read (single) ──────────────────────────────────────────────
 export async function getItem(tableName, primaryKey, id, select) {
+  return _dbgWrap('getItem', [tableName, primaryKey, id, select], async function() {
   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 } = {}) {
+  return _dbgWrap('listItems', [tableName, primaryKey, { filter, select, orderBy, top, skip }], async function() {
   const client = getSharedClient();
   select = ensureArray(select);
   orderBy = ensureArray(orderBy);
@@ -121,35 +287,48 @@ export async function listItems(tableName, primaryKey, { filter, select, orderBy
   });
   var unwrapped = unwrapResult(result);
   return { entities: Array.isArray(unwrapped) ? unwrapped : [] };
+  });
 }
 
 // ── Update ─────────────────────────────────────────────────────
 export async function updateItem(tableName, primaryKey, id, changedFields) {
+  return _dbgWrap('updateItem', [tableName, primaryKey, id, changedFields], async function() {
   const client = getSharedClient();
   const result = await client.updateRecordAsync(tableName, id, changedFields);
   return unwrapResult(result);
+  });
 }
 
 // ── Delete ─────────────────────────────────────────────────────
 export async function deleteItem(tableName, primaryKey, id) {
+  return _dbgWrap('deleteItem', [tableName, primaryKey, id], async function() {
   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.
+// 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) {
-  const client = getSharedClient();
-  const result = await client.invokeActionAsync(tableName, actionName, params);
+  return _dbgWrap('callUnboundAction', [tableName, primaryKey, actionName, params], async function() {
+  var oAllSources = Object.assign({}, oInitialDataSources, oDataSources);
+  var result = await callActionAsync(oAllSources, 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;
+  return _dbgWrap('whoAmI', [], async function() {
+  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;
+  });
 }
 
 // ────────────────────────────────────────────────────────────────────────────
@@ -160,7 +339,7 @@ export async function whoAmI() {
 const DATA_SOURCE_SP = "sharepointonline";
 
 // ── Initialize SDK client for the SharePoint connector ─────────
-function initClient() {
+function initSpClient() {
   const dataSourcesInfo = {
     [DATA_SOURCE_SP]: {
       tableId: "",
@@ -302,8 +481,8 @@ function initClient() {
 }
 
 // ── Internal: execute a connector operation ────────────────────
-async function execOp(operationName, parameters) {
-  const client = await initClient();
+async function execSpOp(operationName, parameters) {
+  const client = await initSpClient();
   const result = await client.executeAsync({
     connectorOperation: {
       tableName: DATA_SOURCE_SP,
@@ -323,17 +502,21 @@ async function execOp(operationName, parameters) {
 
 // ── Call any SharePoint connector operation by name ─────────────
 export async function callSharePointOperation(operationName, parameters = {}) {
-  return execOp(operationName, parameters);
+  return _dbgWrap('callSharePointOperation', [operationName, parameters], async function() {
+  return execSpOp(operationName, parameters);
+  });
 }
 
 // ── Send HTTP Request (for list-name-based operations) ─────────
 export async function sendHttpRequest({ method = "GET", uri, headers, body }) {
-  return execOp("HttpRequest", {
+  return _dbgWrap('sendHttpRequest', [{ method, uri, headers, body }], async function() {
+  return execSpOp("HttpRequest", {
     method,
     uri,
     headers: headers || {},
     body: body || "",
   });
+  });
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -342,49 +525,59 @@ export async function sendHttpRequest({ method = "GET", uri, headers, body }) {
 
 // ── Get Items ──────────────────────────────────────────────────
 export async function getItems(sSiteUrl, sListId, { filter, orderBy, top, skip } = {}) {
+  return _dbgWrap('getItems', [sSiteUrl, sListId, { filter, orderBy, top, skip }], async function() {
   let params = { siteUrl: encodeURIComponent(sSiteUrl), table: sListId };
   if (filter)       params.$filter = filter;
   if (orderBy)      params.$orderby = orderBy;
   if (top != null)  params.$top = top;
   if (skip != null) params.$skip = skip;
-  return execOp("GetItems", params);
+  return execSpOp("GetItems", params);
+  });
 }
 
 // ── Get Item ───────────────────────────────────────────────────
-export async function getItem(sSiteUrl, sListId, iItemId) {
-  return execOp("GetItem", {
+export async function getSpItem(sSiteUrl, sListId, iItemId) {
+  return _dbgWrap('getSpItem', [sSiteUrl, sListId, iItemId], async function() {
+  return execSpOp("GetItem", {
     siteUrl: encodeURIComponent(sSiteUrl),
     table: sListId,
     id: iItemId,
   });
+  });
 }
 
 // ── Create Item ────────────────────────────────────────────────
-export async function createItem(sSiteUrl, sListId, oFields) {
-  return execOp("PostItem", {
+export async function createSpItem(sSiteUrl, sListId, oFields) {
+  return _dbgWrap('createSpItem', [sSiteUrl, sListId, oFields], async function() {
+  return execSpOp("PostItem", {
     siteUrl: encodeURIComponent(sSiteUrl),
     table: sListId,
     item: oFields,
   });
+  });
 }
 
 // ── Update Item ────────────────────────────────────────────────
-export async function updateItem(sSiteUrl, sListId, iItemId, oChangedFields) {
-  return execOp("PatchItem", {
+export async function updateSpItem(sSiteUrl, sListId, iItemId, oChangedFields) {
+  return _dbgWrap('updateSpItem', [sSiteUrl, sListId, iItemId, oChangedFields], async function() {
+  return execSpOp("PatchItem", {
     siteUrl: encodeURIComponent(sSiteUrl),
     table: sListId,
     id: iItemId,
     item: oChangedFields,
   });
+  });
 }
 
 // ── Delete Item ────────────────────────────────────────────────
-export async function deleteItem(sSiteUrl, sListId, iItemId) {
-  return execOp("DeleteItem", {
+export async function deleteSpItem(sSiteUrl, sListId, iItemId) {
+  return _dbgWrap('deleteSpItem', [sSiteUrl, sListId, iItemId], async function() {
+  return execSpOp("DeleteItem", {
     siteUrl: encodeURIComponent(sSiteUrl),
     table: sListId,
     id: iItemId,
   });
+  });
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -393,6 +586,7 @@ export async function deleteItem(sSiteUrl, sListId, iItemId) {
 
 // ── Get Items by List Name ─────────────────────────────────────
 export async function getItemsByName(sSiteUrl, sListName, { filter, orderBy, top, skip } = {}) {
+  return _dbgWrap('getItemsByName', [sSiteUrl, sListName, { filter, orderBy, top, skip }], async function() {
   let sUri = sSiteUrl + "/_api/web/lists/getbytitle('" + sListName + "')/items";
   let aQuery = [];
   if (filter)       aQuery.push("$filter=" + filter);
@@ -401,30 +595,39 @@ export async function getItemsByName(sSiteUrl, sListName, { filter, orderBy, top
   if (skip != null) aQuery.push("$skip=" + skip);
   if (aQuery.length > 0) sUri = sUri + "?" + aQuery.join("&");
   return sendHttpRequest({ method: "GET", uri: sUri, headers: { Accept: "application/json;odata=nometadata" } });
+  });
 }
 
 // ── Get Item by List Name ──────────────────────────────────────
 export async function getItemByName(sSiteUrl, sListName, iItemId) {
+  return _dbgWrap('getItemByName', [sSiteUrl, sListName, iItemId], async function() {
   let sUri = sSiteUrl + "/_api/web/lists/getbytitle('" + sListName + "')/items(" + iItemId + ")";
   return sendHttpRequest({ method: "GET", uri: sUri, headers: { Accept: "application/json;odata=nometadata" } });
+  });
 }
 
 // ── Create Item by List Name ───────────────────────────────────
 export async function createItemByName(sSiteUrl, sListName, oFields) {
+  return _dbgWrap('createItemByName', [sSiteUrl, sListName, oFields], async function() {
   let sUri = sSiteUrl + "/_api/web/lists/getbytitle('" + sListName + "')/items";
   return sendHttpRequest({ method: "POST", uri: sUri, headers: { Accept: "application/json;odata=nometadata", "Content-Type": "application/json;odata=nometadata" }, body: JSON.stringify(oFields) });
+  });
 }
 
 // ── Update Item by List Name ───────────────────────────────────
 export async function updateItemByName(sSiteUrl, sListName, iItemId, oChangedFields) {
+  return _dbgWrap('updateItemByName', [sSiteUrl, sListName, iItemId, oChangedFields], async function() {
   let sUri = sSiteUrl + "/_api/web/lists/getbytitle('" + sListName + "')/items(" + iItemId + ")";
   return sendHttpRequest({ method: "PATCH", uri: sUri, headers: { Accept: "application/json;odata=nometadata", "Content-Type": "application/json;odata=nometadata", "If-Match": "*" }, body: JSON.stringify(oChangedFields) });
+  });
 }
 
 // ── Delete Item by List Name ───────────────────────────────────
 export async function deleteItemByName(sSiteUrl, sListName, iItemId) {
+  return _dbgWrap('deleteItemByName', [sSiteUrl, sListName, iItemId], async function() {
   let sUri = sSiteUrl + "/_api/web/lists/getbytitle('" + sListName + "')/items(" + iItemId + ")";
   return sendHttpRequest({ method: "DELETE", uri: sUri, headers: { Accept: "application/json;odata=nometadata", "If-Match": "*" } });
+  });
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -433,16 +636,20 @@ export async function deleteItemByName(sSiteUrl, sListName, iItemId) {
 
 // ── List Tables (Lists) ────────────────────────────────────────
 export async function listTables(sSiteUrl) {
-  return execOp("GetTables", {
+  return _dbgWrap('listTables', [sSiteUrl], async function() {
+  return execSpOp("GetTables", {
     siteUrl: encodeURIComponent(sSiteUrl),
   });
+  });
 }
 
 // ── List Library (Document Libraries) ──────────────────────────
 export async function listLibrary(sSiteUrl) {
-  return execOp("GetDataSetsMetadata", {
+  return _dbgWrap('listLibrary', [sSiteUrl], async function() {
+  return execSpOp("GetDataSetsMetadata", {
     siteUrl: encodeURIComponent(sSiteUrl),
   });
+  });
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -451,47 +658,57 @@ export async function listLibrary(sSiteUrl) {
 
 // ── Create File ────────────────────────────────────────────────
 export async function createFile(sSiteUrl, sLibraryName, sFileName, fileContent) {
-  return execOp("CreateFile", {
+  return _dbgWrap('createFile', [sSiteUrl, sLibraryName, sFileName, fileContent], async function() {
+  return execSpOp("CreateFile", {
     siteUrl: encodeURIComponent(sSiteUrl),
     folderPath: sLibraryName,
     name: sFileName,
     body: fileContent,
   });
+  });
 }
 
 // ── Update File ────────────────────────────────────────────────
 export async function updateFile(sSiteUrl, sFileId, fileContent) {
-  return execOp("UpdateFile", {
+  return _dbgWrap('updateFile', [sSiteUrl, sFileId, fileContent], async function() {
+  return execSpOp("UpdateFile", {
     siteUrl: encodeURIComponent(sSiteUrl),
     id: sFileId,
     body: fileContent,
   });
+  });
 }
 
 // ── Delete File ────────────────────────────────────────────────
 export async function deleteFile(sSiteUrl, sFileId) {
-  return execOp("DeleteFile", {
+  return _dbgWrap('deleteFile', [sSiteUrl, sFileId], async function() {
+  return execSpOp("DeleteFile", {
     siteUrl: encodeURIComponent(sSiteUrl),
     id: sFileId,
   });
+  });
 }
 
 // ── Move File ──────────────────────────────────────────────────
 export async function moveFile(sSiteUrl, sSourceFileId, sDestinationFolderPath, sNewFileName) {
-  return execOp("MoveFile", {
+  return _dbgWrap('moveFile', [sSiteUrl, sSourceFileId, sDestinationFolderPath, sNewFileName], async function() {
+  return execSpOp("MoveFile", {
     siteUrl: encodeURIComponent(sSiteUrl),
     id: sSourceFileId,
     destinationFolderPath: sDestinationFolderPath,
     newFileName: sNewFileName || "",
   });
+  });
 }
 
 // ── Get File Metadata ──────────────────────────────────────────
 export async function getFileMetadata(sSiteUrl, sFileId) {
-  return execOp("GetFileMetadata", {
+  return _dbgWrap('getFileMetadata', [sSiteUrl, sFileId], async function() {
+  return execSpOp("GetFileMetadata", {
     siteUrl: encodeURIComponent(sSiteUrl),
     id: sFileId,
   });
+  });
 }
 
 // ────────────────────────────────────────────────────────────────────────────
@@ -525,7 +742,7 @@ const OUTLOOK_APIS = {
 };
 
 // ── Initialize SDK client for the Office 365 Outlook connector ──
-function initClient() {
+function initOutlookClient() {
   const dataSourcesInfo = {};
 
   DATA_SOURCE_CANDIDATES.forEach((sDataSourceName) => {
@@ -541,7 +758,7 @@ function initClient() {
   return getClient(dataSourcesInfo);
 }
 
-function stringifyErrorDetails(oError) {
+function stringifyOutlookError(oError) {
   if (!oError) return "Operation failed";
   if (typeof oError === "string") return oError;
   if (oError instanceof Error) return oError.message || "Operation failed";
@@ -559,11 +776,11 @@ function stringifyErrorDetails(oError) {
   }
 }
 
-function unwrapResult(oResult) {
+function unwrapOutlookResult(oResult) {
   if (oResult && oResult.success === false) {
-    var sMessage = stringifyErrorDetails(oResult.error);
+    var sMessage = stringifyOutlookError(oResult.error);
     if (oResult.data !== undefined) {
-      sMessage += " | data: " + stringifyErrorDetails(oResult.data);
+      sMessage += " | data: " + stringifyOutlookError(oResult.data);
     }
     throw new Error(sMessage);
   }
@@ -576,8 +793,8 @@ function unwrapResult(oResult) {
 }
 
 // ── Internal: execute a connector operation ────────────────────
-async function execOp(operationName, parameters) {
-  const client = await initClient();
+async function execOutlookOp(operationName, parameters) {
+  const client = await initOutlookClient();
   const aErrors = [];
 
   for (let iIndex = 0; iIndex < DATA_SOURCE_CANDIDATES.length; iIndex += 1) {
@@ -592,9 +809,9 @@ async function execOp(operationName, parameters) {
         },
       });
 
-      return unwrapResult(result);
+      return unwrapOutlookResult(result);
     } catch (oErr) {
-      const sMessage = stringifyErrorDetails(oErr);
+      const sMessage = stringifyOutlookError(oErr);
       aErrors.push(sDataSourceName + ": " + sMessage);
 
       if (sMessage.indexOf("Connection reference not found") === -1) {
@@ -608,14 +825,16 @@ async function execOp(operationName, parameters) {
 
 // ── 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 execOp("GetEmailsV3", {
+  return execOutlookOp("GetEmailsV3", {
     folderPath: folderId,
     fetchOnlyUnread,
     searchQuery,
     top: top != null ? top : 10,
   });
+  });
 }
 
 // ────────────────────────────────────────────────────────────────────────────
@@ -626,7 +845,7 @@ export async function listEmails({ folderId = "Inbox", fetchOnlyUnread, searchQu
 const DATA_SOURCE_USERS = "office365users";
 
 // ── Initialize SDK client for the Office 365 Users connector ───
-function initClient() {
+function initUsersClient() {
   const dataSourcesInfo = {
     [DATA_SOURCE_USERS]: {
       tableId: "",
@@ -698,8 +917,8 @@ function initClient() {
 }
 
 // ── Internal: execute a connector operation ────────────────────
-async function execOp(operationName, parameters) {
-  const client = await initClient();
+async function execUsersOp(operationName, parameters) {
+  const client = await initUsersClient();
   const result = await client.executeAsync({
     connectorOperation: {
       tableName: DATA_SOURCE_USERS,
@@ -719,17 +938,21 @@ async function execOp(operationName, parameters) {
 
 // ── Call any Office 365 Users operation by name ────────────────
 export async function callUsersOperation(operationName, parameters = {}) {
-  return execOp(operationName, parameters);
+  return _dbgWrap('callUsersOperation', [operationName, parameters], async function() {
+  return execUsersOp(operationName, parameters);
+  });
 }
 
 // ── Open HTTP Request ──────────────────────────────────────────
-export async function openHttpRequest({ method = "GET", uri, headers, body }) {
-  return execOp("HttpRequest", {
+export async function openUsersHttpRequest({ method = "GET", uri, headers, body }) {
+  return _dbgWrap('openUsersHttpRequest', [{ method, uri, headers, body }], async function() {
+  return execUsersOp("HttpRequest", {
     method,
     uri,
     headers: headers || {},
     body: body || "",
   });
+  });
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -738,14 +961,18 @@ export async function openHttpRequest({ method = "GET", uri, headers, body }) {
 
 // ── Get My Profile ─────────────────────────────────────────────
 export async function getMyProfile() {
-  return execOp("MyProfile_V2", {});
+  return _dbgWrap('getMyProfile', [], async function() {
+  return execUsersOp("MyProfile_V2", {});
+  });
 }
 
 // ── Get User Profile ───────────────────────────────────────────
 export async function getUserProfile(userId) {
-  return execOp("UserProfile_V2", {
+  return _dbgWrap('getUserProfile', [userId], async function() {
+  return execUsersOp("UserProfile_V2", {
     id: userId,
   });
+  });
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -754,16 +981,20 @@ export async function getUserProfile(userId) {
 
 // ── Get Manager ────────────────────────────────────────────────
 export async function getManager(userId) {
-  return execOp("Manager_V2", {
+  return _dbgWrap('getManager', [userId], async function() {
+  return execUsersOp("Manager_V2", {
     id: userId,
   });
+  });
 }
 
 // ── Get Direct Reports ─────────────────────────────────────────
 export async function getDirectReports(userId) {
-  return execOp("DirectReports_V2", {
+  return _dbgWrap('getDirectReports', [userId], async function() {
+  return execUsersOp("DirectReports_V2", {
     id: userId,
   });
+  });
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -772,9 +1003,11 @@ export async function getDirectReports(userId) {
 
 // ── Get User Photo ─────────────────────────────────────────────
 export async function getUserPhoto(userId) {
-  return execOp("UserPhoto_V2", {
+  return _dbgWrap('getUserPhoto', [userId], async function() {
+  return execUsersOp("UserPhoto_V2", {
     id: userId,
   });
+  });
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -783,11 +1016,13 @@ export async function getUserPhoto(userId) {
 
 // ── Search for Users ───────────────────────────────────────────
 export async function searchForUsers({ searchTerm, top, skip } = {}) {
+  return _dbgWrap('searchForUsers', [{ searchTerm, top, skip }], async function() {
   const params = {};
   if (searchTerm) params.searchTerm = searchTerm;
   if (top != null) params.$top = top;
   if (skip != null) params.$skip = skip;
-  return execOp("SearchUser_V2", params);
+  return execUsersOp("SearchUser_V2", params);
+  });
 }
 
 // ────────────────────────────────────────────────────────────────────────────
@@ -799,7 +1034,7 @@ export async function searchForUsers({ searchTerm, top, skip } = {}) {
 const DATA_SOURCE_GROUPS = "Office365Groups";
 
 // ── Initialize SDK client for the Office 365 Groups connector ──
-function initClient() {
+function initGroupsClient() {
   const dataSourcesInfo = {
     [DATA_SOURCE_GROUPS]: {
       tableId: "",
@@ -813,8 +1048,8 @@ function initClient() {
 }
 
 // ── Internal: execute a connector operation ────────────────────
-async function execOp(operationName, parameters) {
-  const client = await initClient();
+async function execGroupsOp(operationName, parameters) {
+  const client = await initGroupsClient();
   return client.executeAsync({
     connectorOperation: {
       tableName: DATA_SOURCE_GROUPS,
@@ -830,17 +1065,21 @@ async function execOp(operationName, parameters) {
 
 // ── Call any Office 365 Groups operation by name ───────────────
 export async function callGroupsOperation(operationName, parameters = {}) {
-  return execOp(operationName, parameters);
+  return _dbgWrap('callGroupsOperation', [operationName, parameters], async function() {
+  return execGroupsOp(operationName, parameters);
+  });
 }
 
 // ── Open HTTP Request ──────────────────────────────────────────
-export async function openHttpRequest({ method = "GET", uri, headers, body }) {
-  return execOp("HttpRequest", {
+export async function openGroupsHttpRequest({ method = "GET", uri, headers, body }) {
+  return _dbgWrap('openGroupsHttpRequest', [{ method, uri, headers, body }], async function() {
+  return execGroupsOp("HttpRequest", {
     method,
     uri,
     headers: headers || {},
     body: body || "",
   });
+  });
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -849,12 +1088,16 @@ export async function openHttpRequest({ method = "GET", uri, headers, body }) {
 
 // ── List My Groups ─────────────────────────────────────────────
 export async function listMyGroups() {
-  return execOp("ListOwnedGroups", {});
+  return _dbgWrap('listMyGroups', [], async function() {
+  return execGroupsOp("ListOwnedGroups", {});
+  });
 }
 
 // ── List Members of a Group ────────────────────────────────────
 export async function listGroupMembers(groupId) {
-  return execOp("ListGroupMembers", {
+  return _dbgWrap('listGroupMembers', [groupId], async function() {
+  return execGroupsOp("ListGroupMembers", {
     groupId,
   });
+  });
 }