codeapp-js 0.1.1 → 0.2.1

package/examples/solution explorer/dist/codeapp.js

@@ -0,0 +1,1098 @@
+import { getClient, 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(Object.assign({}, oInitialDataSources, oDataSources));
+  }
+  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;
+}
+
+// ── 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
+  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 || "";
+  });
+}
+
+// ────────────────────────────────────────────────────────────────────────────
+// ─────────────────────────────── Dataverse ──────────────────────────────────
+// ────────────────────────────────────────────────────────────────────────────
+
+// ── Table Registry (populated at runtime via registerTable) ────
+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: '',
+    primaryKey: sPrimaryKey,
+    dataSourceType: 'Dataverse',
+    apis: {}
+  };
+  // 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)
+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;
+}
+
+// ── 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);
+  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) {
+  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 ─────────────────────────────────────────────
+export async function callUnboundAction(tableName, primaryKey, 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() {
+  return _dbgWrap('whoAmI', [], async function() {
+  var oAllSources = Object.assign({}, oInitialDataSources, oDataSources);
+  var result = await callActionAsync(oAllSources, 'WhoAmI', {});
+  var data = unwrapResult(result);
+  return data.UserId || data.userid || data.systemuserid || data;
+  });
+}
+
+// ────────────────────────────────────────────────────────────────────────────
+// ─────────────────────────────── SharePoint ─────────────────────────────────
+// ────────────────────────────────────────────────────────────────────────────
+
+// ── Data source name (must match connectionReferences in power.config.json) ──
+const DATA_SOURCE_SP = "sharepointonline";
+
+// ── Initialize SDK client for the SharePoint connector ─────────
+function initSpClient() {
+  const dataSourcesInfo = {
+    [DATA_SOURCE_SP]: {
+      tableId: "",
+      version: "",
+      primaryKey: "",
+      dataSourceType: "Connector",
+      apis: {
+        GetItems: {
+          path: "/{connectionId}/datasets/{siteUrl}/tables/{table}/items",
+          method: "GET",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", 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 },
+          ],
+        },
+        GetItem: {
+          path: "/{connectionId}/datasets/{siteUrl}/tables/{table}/items/{id}",
+          method: "GET",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+            { name: "table", in: "path", required: true },
+            { name: "id", in: "path", required: true },
+          ],
+        },
+        PostItem: {
+          path: "/{connectionId}/datasets/{siteUrl}/tables/{table}/items",
+          method: "POST",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+            { name: "table", in: "path", required: true },
+            { name: "item", in: "body", required: true },
+          ],
+        },
+        PatchItem: {
+          path: "/{connectionId}/datasets/{siteUrl}/tables/{table}/items/{id}",
+          method: "PATCH",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+            { name: "table", in: "path", required: true },
+            { name: "id", in: "path", required: true },
+            { name: "item", in: "body", required: true },
+          ],
+        },
+        DeleteItem: {
+          path: "/{connectionId}/datasets/{siteUrl}/tables/{table}/items/{id}",
+          method: "DELETE",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+            { name: "table", in: "path", required: true },
+            { name: "id", in: "path", required: true },
+          ],
+        },
+        GetTables: {
+          path: "/{connectionId}/datasets/{siteUrl}/tables",
+          method: "GET",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+          ],
+        },
+        GetDataSetsMetadata: {
+          path: "/{connectionId}/datasets/{siteUrl}",
+          method: "GET",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+          ],
+        },
+        CreateFile: {
+          path: "/{connectionId}/datasets/{siteUrl}/files",
+          method: "POST",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+            { name: "folderPath", in: "query", required: true },
+            { name: "name", in: "query", required: true },
+            { name: "body", in: "body", required: true },
+          ],
+        },
+        UpdateFile: {
+          path: "/{connectionId}/datasets/{siteUrl}/files/{id}",
+          method: "PUT",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+            { name: "id", in: "path", required: true },
+            { name: "body", in: "body", required: true },
+          ],
+        },
+        DeleteFile: {
+          path: "/{connectionId}/datasets/{siteUrl}/files/{id}",
+          method: "DELETE",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+            { name: "id", in: "path", required: true },
+          ],
+        },
+        MoveFile: {
+          path: "/{connectionId}/datasets/{siteUrl}/files/{id}/moveto",
+          method: "POST",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+            { name: "id", in: "path", required: true },
+            { name: "destinationFolderPath", in: "query", required: true },
+            { name: "newFileName", in: "query", required: false },
+          ],
+        },
+        GetFileMetadata: {
+          path: "/{connectionId}/datasets/{siteUrl}/files/{id}",
+          method: "GET",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+            { name: "siteUrl", in: "path", required: true },
+            { name: "id", in: "path", required: true },
+          ],
+        },
+        HttpRequest: {
+          path: "/{connectionId}/httprequest",
+          method: "POST",
+          parameters: [
+            { name: "connectionId", in: "path", required: true },
+          ],
+        },
+      },
+    },
+  };
+  return getClient(dataSourcesInfo);
+}
+
+// ── Internal: execute a connector operation ────────────────────
+async function execSpOp(operationName, parameters) {
+  const client = await initSpClient();
+  const result = await client.executeAsync({
+    connectorOperation: {
+      tableName: DATA_SOURCE_SP,
+      operationName,
+      parameters,
+    },
+  });
+  if (!result.success) {
+    throw new Error(result.error?.message || "Operation failed");
+  }
+  return result.data;
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  GENERIC
+// ═══════════════════════════════════════════════════════════════
+
+// ── Call any SharePoint connector operation by name ─────────────
+export async function callSharePointOperation(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 _dbgWrap('sendHttpRequest', [{ method, uri, headers, body }], async function() {
+  return execSpOp("HttpRequest", {
+    method,
+    uri,
+    headers: headers || {},
+    body: body || "",
+  });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  ITEMS (standard API — uses list ID)
+// ═══════════════════════════════════════════════════════════════
+
+// ── 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 execSpOp("GetItems", params);
+  });
+}
+
+// ── Get Item ───────────────────────────────────────────────────
+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 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 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 deleteSpItem(sSiteUrl, sListId, iItemId) {
+  return _dbgWrap('deleteSpItem', [sSiteUrl, sListId, iItemId], async function() {
+  return execSpOp("DeleteItem", {
+    siteUrl: encodeURIComponent(sSiteUrl),
+    table: sListId,
+    id: iItemId,
+  });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  ITEMS (HTTP API — uses list name)
+// ═══════════════════════════════════════════════════════════════
+
+// ── 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);
+  if (orderBy)      aQuery.push("$orderby=" + orderBy);
+  if (top != null)  aQuery.push("$top=" + 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": "*" } });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  TABLES / LISTS
+// ═══════════════════════════════════════════════════════════════
+
+// ── List Tables (Lists) ────────────────────────────────────────
+export async function listTables(sSiteUrl) {
+  return _dbgWrap('listTables', [sSiteUrl], async function() {
+  return execSpOp("GetTables", {
+    siteUrl: encodeURIComponent(sSiteUrl),
+  });
+  });
+}
+
+// ── List Library (Document Libraries) ──────────────────────────
+export async function listLibrary(sSiteUrl) {
+  return _dbgWrap('listLibrary', [sSiteUrl], async function() {
+  return execSpOp("GetDataSetsMetadata", {
+    siteUrl: encodeURIComponent(sSiteUrl),
+  });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  FILES
+// ═══════════════════════════════════════════════════════════════
+
+// ── Create File ────────────────────────────────────────────────
+export async function createFile(sSiteUrl, sLibraryName, sFileName, fileContent) {
+  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 _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 _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 _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 _dbgWrap('getFileMetadata', [sSiteUrl, sFileId], async function() {
+  return execSpOp("GetFileMetadata", {
+    siteUrl: encodeURIComponent(sSiteUrl),
+    id: sFileId,
+  });
+  });
+}
+
+// ────────────────────────────────────────────────────────────────────────────
+// ────────────────────────────── Outlook365 ──────────────────────────────────
+// ────────────────────────────────────────────────────────────────────────────
+
+// ── Data source name (must match connectionReferences in power.config.json) ──
+const DATA_SOURCE_CANDIDATES = ["office365outlook", "Office365Outlook", "office365"];
+const OUTLOOK_APIS = {
+  GetEmailsV3: {
+    path: "/{connectionId}/v3/Mail",
+    method: "GET",
+    parameters: [
+      { name: "connectionId", in: "path", required: true },
+      { name: "folderPath", in: "query", required: false },
+      { name: "to", in: "query", required: false },
+      { name: "cc", in: "query", required: false },
+      { name: "toOrCc", in: "query", required: false },
+      { name: "from", in: "query", required: false },
+      { name: "importance", in: "query", required: false },
+      { name: "fetchOnlyWithAttachment", in: "query", required: false },
+      { name: "subjectFilter", in: "query", required: false },
+      { name: "fetchOnlyUnread", in: "query", required: false },
+      { name: "fetchOnlyFlagged", in: "query", required: false },
+      { name: "mailboxAddress", in: "query", required: false },
+      { name: "includeAttachments", in: "query", required: false },
+      { name: "searchQuery", in: "query", required: false },
+      { name: "top", in: "query", required: false },
+    ],
+  },
+};
+
+// ── Initialize SDK client for the Office 365 Outlook connector ──
+function initOutlookClient() {
+  const dataSourcesInfo = {};
+
+  DATA_SOURCE_CANDIDATES.forEach((sDataSourceName) => {
+    dataSourcesInfo[sDataSourceName] = {
+      tableId: "",
+      version: "",
+      primaryKey: "",
+      dataSourceType: "Connector",
+      apis: OUTLOOK_APIS,
+    };
+  });
+
+  return getClient(dataSourcesInfo);
+}
+
+function stringifyOutlookError(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 unwrapOutlookResult(oResult) {
+  if (oResult && oResult.success === false) {
+    var sMessage = stringifyOutlookError(oResult.error);
+    if (oResult.data !== undefined) {
+      sMessage += " | data: " + stringifyOutlookError(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 execOutlookOp(operationName, parameters) {
+  const client = await initOutlookClient();
+  const aErrors = [];
+
+  for (let iIndex = 0; iIndex < DATA_SOURCE_CANDIDATES.length; iIndex += 1) {
+    const sDataSourceName = DATA_SOURCE_CANDIDATES[iIndex];
+
+    try {
+      const result = await client.executeAsync({
+        connectorOperation: {
+          tableName: sDataSourceName,
+          operationName,
+          parameters,
+        },
+      });
+
+      return unwrapOutlookResult(result);
+    } catch (oErr) {
+      const sMessage = stringifyOutlookError(oErr);
+      aErrors.push(sDataSourceName + ": " + sMessage);
+
+      if (sMessage.indexOf("Connection reference not found") === -1) {
+        throw oErr;
+      }
+    }
+  }
+
+  throw new Error("No Outlook connection reference matched. Tried: " + aErrors.join(" || "));
+}
+
+// ── List Emails ────────────────────────────────────────────────
+export async function listEmails({ folderId = "Inbox", fetchOnlyUnread, searchQuery, top, skip } = {}) {
+  return _dbgWrap('listEmails', [{ folderId, fetchOnlyUnread, searchQuery, top, skip }], async function() {
+  void skip;
+
+  return execOutlookOp("GetEmailsV3", {
+    folderPath: folderId,
+    fetchOnlyUnread,
+    searchQuery,
+    top: top != null ? top : 10,
+  });
+  });
+}
+
+// ────────────────────────────────────────────────────────────────────────────
+// ─────────────────────────────── O365 User ──────────────────────────────────
+// ────────────────────────────────────────────────────────────────────────────
+
+// ── Data source name (must match connectionReferences in power.config.json) ──
+const DATA_SOURCE_USERS = "office365users";
+
+// ── Initialize SDK client for the Office 365 Users connector ───
+function initUsersClient() {
+  const dataSourcesInfo = {
+    [DATA_SOURCE_USERS]: {
+      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 execUsersOp(operationName, parameters) {
+  const client = await initUsersClient();
+  const result = await client.executeAsync({
+    connectorOperation: {
+      tableName: DATA_SOURCE_USERS,
+      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 _dbgWrap('callUsersOperation', [operationName, parameters], async function() {
+  return execUsersOp(operationName, parameters);
+  });
+}
+
+// ── Open HTTP Request ──────────────────────────────────────────
+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 || "",
+  });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  PROFILE
+// ═══════════════════════════════════════════════════════════════
+
+// ── Get My Profile ─────────────────────────────────────────────
+export async function getMyProfile() {
+  return _dbgWrap('getMyProfile', [], async function() {
+  return execUsersOp("MyProfile_V2", {});
+  });
+}
+
+// ── Get User Profile ───────────────────────────────────────────
+export async function getUserProfile(userId) {
+  return _dbgWrap('getUserProfile', [userId], async function() {
+  return execUsersOp("UserProfile_V2", {
+    id: userId,
+  });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  MANAGER & REPORTS
+// ═══════════════════════════════════════════════════════════════
+
+// ── Get Manager ────────────────────────────────────────────────
+export async function getManager(userId) {
+  return _dbgWrap('getManager', [userId], async function() {
+  return execUsersOp("Manager_V2", {
+    id: userId,
+  });
+  });
+}
+
+// ── Get Direct Reports ─────────────────────────────────────────
+export async function getDirectReports(userId) {
+  return _dbgWrap('getDirectReports', [userId], async function() {
+  return execUsersOp("DirectReports_V2", {
+    id: userId,
+  });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  PHOTO
+// ═══════════════════════════════════════════════════════════════
+
+// ── Get User Photo ─────────────────────────────────────────────
+export async function getUserPhoto(userId) {
+  return _dbgWrap('getUserPhoto', [userId], async function() {
+  return execUsersOp("UserPhoto_V2", {
+    id: userId,
+  });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  SEARCH
+// ═══════════════════════════════════════════════════════════════
+
+// ── 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 execUsersOp("SearchUser_V2", params);
+  });
+}
+
+// ────────────────────────────────────────────────────────────────────────────
+// ────────────────────────────── O365 Groups──────────────────────────────────
+// ────────────────────────────────────────────────────────────────────────────
+
+
+// ── Data source name (must match connectionReferences in power.config.json) ──
+const DATA_SOURCE_GROUPS = "Office365Groups";
+
+// ── Initialize SDK client for the Office 365 Groups connector ──
+function initGroupsClient() {
+  const dataSourcesInfo = {
+    [DATA_SOURCE_GROUPS]: {
+      tableId: "",
+      version: "",
+      primaryKey: "",
+      dataSourceType: "Connector",
+      apis: {},
+    },
+  };
+  return getClient(dataSourcesInfo);
+}
+
+// ── Internal: execute a connector operation ────────────────────
+async function execGroupsOp(operationName, parameters) {
+  const client = await initGroupsClient();
+  return client.executeAsync({
+    connectorOperation: {
+      tableName: DATA_SOURCE_GROUPS,
+      operationName,
+      parameters,
+    },
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  GENERIC
+// ═══════════════════════════════════════════════════════════════
+
+// ── Call any Office 365 Groups operation by name ───────────────
+export async function callGroupsOperation(operationName, parameters = {}) {
+  return _dbgWrap('callGroupsOperation', [operationName, parameters], async function() {
+  return execGroupsOp(operationName, parameters);
+  });
+}
+
+// ── Open HTTP Request ──────────────────────────────────────────
+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 || "",
+  });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  GROUPS
+// ═══════════════════════════════════════════════════════════════
+
+// ── List My Groups ─────────────────────────────────────────────
+export async function listMyGroups() {
+  return _dbgWrap('listMyGroups', [], async function() {
+  return execGroupsOp("ListOwnedGroups", {});
+  });
+}
+
+// ── List Members of a Group ────────────────────────────────────
+export async function listGroupMembers(groupId) {
+  return _dbgWrap('listGroupMembers', [groupId], async function() {
+  return execGroupsOp("ListGroupMembers", {
+    groupId,
+  });
+  });
+}