@apvee/spfx-react-toolkit 1.0.0 → 1.2.0

package/lib/hooks/useSPFxHttpClient.js

@@ -0,0 +1,275 @@
+// useSPFxHttpClient.ts
+// Hook to access generic HTTP client with state management
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { useMemo, useState, useCallback } from 'react';
+import { useSPFxServiceScope } from './useSPFxServiceScope';
+import { HttpClient } from '@microsoft/sp-http';
+/**
+ * Hook to access generic HTTP client with built-in state management
+ *
+ * Provides native HttpClient for generic HTTP requests to external APIs,
+ * webhooks, or any non-SharePoint endpoints. For SharePoint REST API calls,
+ * use useSPFxSPHttpClient instead.
+ *
+ * Offers two usage patterns:
+ *
+ * 1. **invoke()** - Automatic state management (loading + error tracking)
+ * 2. **client** - Direct access for full control
+ *
+ * For type safety, import SPFx types:
+ * ```typescript
+ * import { HttpClient } from '@microsoft/sp-http';
+ * ```
+ *
+ * Requirements:
+ * - SPFx ServiceScope with HttpClient service
+ * - Network access to target endpoints
+ * - CORS configured on external APIs (if applicable)
+ *
+ * @remarks
+ * This hook consumes HttpClient from SPFx ServiceScope using dependency injection.
+ * The service is consumed lazily (only when this hook is used) and cached for optimal
+ * performance. The client is always available (non-undefined) after Provider initialization.
+ *
+ * **Key Differences from SPHttpClient:**
+ * - HttpClient: Generic HTTP calls to any URL (public APIs, webhooks)
+ * - SPHttpClient: SharePoint-specific REST API calls with integrated authentication
+ *
+ * Use HttpClient for external APIs, SPHttpClient for SharePoint `/_api/` endpoints.
+ *
+ * @example Using invoke with public API
+ * ```tsx
+ * function WeatherWidget() {
+ *   const { invoke, isLoading, error, clearError } = useSPFxHttpClient();
+ *   const [weather, setWeather] = useState<any>(null);
+ *
+ *   const loadWeather = () => {
+ *     invoke(client =>
+ *       client.get(
+ *         'https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_KEY',
+ *         HttpClient.configurations.v1
+ *       ).then(res => res.json())
+ *     ).then(data => setWeather(data));
+ *   };
+ *
+ *   useEffect(() => { loadWeather(); }, []);
+ *
+ *   if (isLoading) return <Spinner />;
+ *   if (error) return (
+ *     <MessageBar messageBarType={MessageBarType.error}>
+ *       {error.message}
+ *       <Link onClick={() => { clearError(); loadWeather(); }}>Retry</Link>
+ *     </MessageBar>
+ *   );
+ *
+ *   return <div>Temperature: {weather?.main?.temp}</div>;
+ * }
+ * ```
+ *
+ * @example Using client directly for advanced control
+ * ```tsx
+ * import { HttpClient } from '@microsoft/sp-http';
+ *
+ * function NewsReader() {
+ *   const { client } = useSPFxHttpClient();
+ *   const [articles, setArticles] = useState([]);
+ *   const [loading, setLoading] = useState(false);
+ *
+ *   // client is always available after Provider initialization
+ *
+ *   const loadNews = async () => {
+ *     setLoading(true);
+ *     try {
+ *       const response = await client.get(
+ *         'https://newsapi.org/v2/top-headlines?country=us&apiKey=YOUR_KEY',
+ *         HttpClient.configurations.v1
+ *       );
+ *       const data = await response.json();
+ *       setArticles(data.articles);
+ *     } catch (err) {
+ *       console.error(err);
+ *     } finally {
+ *       setLoading(false);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <>
+ *       <button onClick={loadNews} disabled={loading}>Load News</button>
+ *       {loading && <Spinner />}
+ *       <ul>{articles.map(a => <li key={a.url}>{a.title}</li>)}</ul>
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @example POST to external webhook
+ * ```tsx
+ * function NotificationSender() {
+ *   const { invoke, isLoading } = useSPFxHttpClient();
+ *
+ *   const sendNotification = (message: string) => {
+ *     invoke(client =>
+ *       client.post(
+ *         'https://hooks.slack.com/services/YOUR/WEBHOOK/URL',
+ *         HttpClient.configurations.v1,
+ *         {
+ *           headers: { 'Content-Type': 'application/json' },
+ *           body: JSON.stringify({ text: message })
+ *         }
+ *       )
+ *     ).then(() => console.log('Notification sent'));
+ *   };
+ *
+ *   return (
+ *     <button onClick={() => sendNotification('Hello from SPFx!')} disabled={isLoading}>
+ *       Send to Slack
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @example Polling external API
+ * ```tsx
+ * function StatusMonitor() {
+ *   const { invoke } = useSPFxHttpClient();
+ *   const [status, setStatus] = useState<string>('unknown');
+ *
+ *   useEffect(() => {
+ *     const interval = setInterval(() => {
+ *       invoke(client =>
+ *         client.get(
+ *           'https://status.example.com/api/health',
+ *           HttpClient.configurations.v1
+ *         ).then(res => res.json())
+ *       ).then(data => setStatus(data.status));
+ *     }, 30000); // Poll every 30 seconds
+ *
+ *     return () => clearInterval(interval);
+ *   }, [invoke]);
+ *
+ *   return <div>Service Status: {status}</div>;
+ * }
+ * ```
+ *
+ * @example CORS-enabled REST API
+ * ```tsx
+ * function ExternalDataGrid() {
+ *   const { invoke, isLoading, error } = useSPFxHttpClient();
+ *   const [data, setData] = useState([]);
+ *
+ *   const fetchData = () => {
+ *     invoke(client =>
+ *       client.get(
+ *         'https://api.contoso.com/v1/records',
+ *         HttpClient.configurations.v1,
+ *         {
+ *           headers: {
+ *             'Accept': 'application/json',
+ *             'X-API-Key': 'your-api-key'
+ *           }
+ *         }
+ *       ).then(res => res.json())
+ *     ).then(records => setData(records));
+ *   };
+ *
+ *   useEffect(() => { fetchData(); }, []);
+ *
+ *   return (
+ *     <DetailsList
+ *       items={data}
+ *       isLoading={isLoading}
+ *       error={error}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export function useSPFxHttpClient() {
+    var _this = this;
+    var consume = useSPFxServiceScope().consume;
+    // Lazy consume HttpClient from ServiceScope (cached by useMemo)
+    var client = useMemo(function () {
+        return consume(HttpClient.serviceKey);
+    }, [consume]);
+    // State management
+    var _a = useState(false), isLoading = _a[0], setIsLoading = _a[1];
+    var _b = useState(undefined), error = _b[0], setError = _b[1];
+    // Invoke with automatic state management
+    var invoke = useCallback(function (fn) { return __awaiter(_this, void 0, void 0, function () {
+        var result, err_1, error_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!client) {
+                        throw new Error('HttpClient not initialized. Check SPFx context.');
+                    }
+                    setIsLoading(true);
+                    setError(undefined);
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, 4, 5]);
+                    return [4 /*yield*/, fn(client)];
+                case 2:
+                    result = _a.sent();
+                    return [2 /*return*/, result];
+                case 3:
+                    err_1 = _a.sent();
+                    error_1 = err_1 instanceof Error ? err_1 : new Error(String(err_1));
+                    setError(error_1);
+                    throw error_1;
+                case 4:
+                    setIsLoading(false);
+                    return [7 /*endfinally*/];
+                case 5: return [2 /*return*/];
+            }
+        });
+    }); }, [client]);
+    // Clear error helper
+    var clearError = useCallback(function () {
+        setError(undefined);
+    }, []);
+    return {
+        client: client,
+        invoke: invoke,
+        isLoading: isLoading,
+        error: error,
+        clearError: clearError,
+    };
+}
+//# sourceMappingURL=useSPFxHttpClient.js.map

package/lib/hooks/useSPFxHttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSPFxHttpClient.js","sourceRoot":"","sources":["../../src/hooks/useSPFxHttpClient.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAgDhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoLG;AACH,MAAM,UAAU,iBAAiB;IAAjC,iBAgDC;IA/CS,IAAA,OAAO,GAAK,mBAAmB,EAAE,QAA1B,CAA2B;IAE1C,gEAAgE;IAChE,IAAM,MAAM,GAAG,OAAO,CAAC;QACrB,OAAO,OAAO,CAAa,UAAU,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,mBAAmB;IACb,IAAA,KAA4B,QAAQ,CAAC,KAAK,CAAC,EAA1C,SAAS,QAAA,EAAE,YAAY,QAAmB,CAAC;IAC5C,IAAA,KAAoB,QAAQ,CAAoB,SAAS,CAAC,EAAzD,KAAK,QAAA,EAAE,QAAQ,QAA0C,CAAC;IAEjE,yCAAyC;IACzC,IAAM,MAAM,GAAG,WAAW,CACxB,UAAU,EAAsC;;;;;oBAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;oBACrE,CAAC;oBAED,YAAY,CAAC,IAAI,CAAC,CAAC;oBACnB,QAAQ,CAAC,SAAS,CAAC,CAAC;;;;oBAGH,qBAAM,EAAE,CAAC,MAAM,CAAC,EAAA;;oBAAzB,MAAM,GAAG,SAAgB;oBAC/B,sBAAO,MAAM,EAAC;;;oBAER,UAAQ,KAAG,YAAY,KAAK,CAAC,CAAC,CAAC,KAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAG,CAAC,CAAC,CAAC;oBAClE,QAAQ,CAAC,OAAK,CAAC,CAAC;oBAChB,MAAM,OAAK,CAAC;;oBAEZ,YAAY,CAAC,KAAK,CAAC,CAAC;;;;;SAEvB,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,qBAAqB;IACrB,IAAM,UAAU,GAAG,WAAW,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,MAAM,QAAA;QACN,MAAM,QAAA;QACN,SAAS,WAAA;QACT,KAAK,OAAA;QACL,UAAU,YAAA;KACX,CAAC;AACJ,CAAC"}

package/lib/hooks/useSPFxMSGraphClient.d.ts

@@ -1,4 +1,4 @@
-import type { MSGraphClientV3 } from '@microsoft/sp-http';
+import { MSGraphClientV3 } from '@microsoft/sp-http';
 /**
  * Return type for useSPFxMSGraphClient hook
  */
@@ -54,14 +54,19 @@ export interface SPFxMSGraphClientInfo {
  *
  * And import SPFx types:
  * ```typescript
- * import type { MSGraphClientV3 } from '@microsoft/sp-http';
+ * import { MSGraphClientV3 } from '@microsoft/sp-http';
  * import type * as MicrosoftGraph from '@microsoft/microsoft-graph-types';
  * ```
  *
  * Requirements:
- * - MSGraphClientFactory available in SPFx context (v1.15.0+)
+ * - SPFx ServiceScope with MSGraphClientFactory service (v1.15.0+)
  * - Appropriate Microsoft Graph permissions granted by admin
  *
+ * @remarks
+ * This hook consumes MSGraphClientFactory from SPFx ServiceScope using dependency injection.
+ * The factory is consumed lazily and cached. The factory.getClient() method is then called
+ * asynchronously to obtain the MSGraphClientV3 instance, which may be undefined until initialized.
+ *
  * @example Using invoke with state management
  * ```tsx
  * import type * as MicrosoftGraph from '@microsoft/microsoft-graph-types';
@@ -94,7 +99,7 @@ export interface SPFxMSGraphClientInfo {
  *
  * @example Using client directly for advanced control
  * ```tsx
- * import type { MSGraphClientV3 } from '@microsoft/sp-http';
+ * import { MSGraphClientV3 } from '@microsoft/sp-http';
  * import type * as MicrosoftGraph from '@microsoft/microsoft-graph-types';
  *
  * function MessagesList() {

package/lib/hooks/useSPFxMSGraphClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSPFxMSGraphClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxMSGraphClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IAE7C;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhF;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAElC,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6JG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CAkE5D"}
+{"version":3,"file":"useSPFxMSGraphClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxMSGraphClient.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IAE7C;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhF;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAElC,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkKG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CA6D5D"}

package/lib/hooks/useSPFxMSGraphClient.js

@@ -36,8 +36,9 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
-import { useState, useCallback, useEffect } from 'react';
-import { useSPFxContext } from './useSPFxContext';
+import { useMemo, useState, useCallback, useEffect } from 'react';
+import { useSPFxServiceScope } from './useSPFxServiceScope';
+import { MSGraphClientFactory } from '@microsoft/sp-http';
 /**
  * Hook to access Microsoft Graph client with built-in state management
  *
@@ -54,14 +55,19 @@ import { useSPFxContext } from './useSPFxContext';
  *
  * And import SPFx types:
  * ```typescript
- * import type { MSGraphClientV3 } from '@microsoft/sp-http';
+ * import { MSGraphClientV3 } from '@microsoft/sp-http';
  * import type * as MicrosoftGraph from '@microsoft/microsoft-graph-types';
  * ```
  *
  * Requirements:
- * - MSGraphClientFactory available in SPFx context (v1.15.0+)
+ * - SPFx ServiceScope with MSGraphClientFactory service (v1.15.0+)
  * - Appropriate Microsoft Graph permissions granted by admin
  *
+ * @remarks
+ * This hook consumes MSGraphClientFactory from SPFx ServiceScope using dependency injection.
+ * The factory is consumed lazily and cached. The factory.getClient() method is then called
+ * asynchronously to obtain the MSGraphClientV3 instance, which may be undefined until initialized.
+ *
  * @example Using invoke with state management
  * ```tsx
  * import type * as MicrosoftGraph from '@microsoft/microsoft-graph-types';
@@ -94,7 +100,7 @@ import { useSPFxContext } from './useSPFxContext';
  *
  * @example Using client directly for advanced control
  * ```tsx
- * import type { MSGraphClientV3 } from '@microsoft/sp-http';
+ * import { MSGraphClientV3 } from '@microsoft/sp-http';
  * import type * as MicrosoftGraph from '@microsoft/microsoft-graph-types';
  *
  * function MessagesList() {
@@ -198,19 +204,18 @@ import { useSPFxContext } from './useSPFxContext';
  */
 export function useSPFxMSGraphClient() {
     var _this = this;
-    var spfxContext = useSPFxContext().spfxContext;
+    var consume = useSPFxServiceScope().consume;
+    // Lazy consume MSGraphClientFactory from ServiceScope (cached by useMemo)
+    var factory = useMemo(function () {
+        return consume(MSGraphClientFactory.serviceKey);
+    }, [consume]);
     var _a = useState(undefined), client = _a[0], setClient = _a[1];
     var _b = useState(false), isLoading = _b[0], setIsLoading = _b[1];
     var _c = useState(undefined), error = _c[0], setError = _c[1];
-    // Initialize Graph client
+    // Initialize Graph client (factory.getClient is async)
     useEffect(function () {
-        var ctx = spfxContext;
-        if (!ctx.msGraphClientFactory) {
-            console.warn('MSGraphClientFactory not available in SPFx context');
-            return;
-        }
         // Get MSGraphClientV3 (version 3 of Microsoft Graph JavaScript Client Library)
-        ctx.msGraphClientFactory
+        factory
             .getClient('3')
             .then(function (graphClient) {
             setClient(graphClient);
@@ -218,7 +223,7 @@ export function useSPFxMSGraphClient() {
             .catch(function (err) {
             console.error('Failed to initialize MSGraphClient:', err);
         });
-    }, [spfxContext]);
+    }, [factory]);
     // Invoke with automatic state management
     var invoke = useCallback(function (fn) { return __awaiter(_this, void 0, void 0, function () {
         var result, err_1, error_1;

package/lib/hooks/useSPFxMSGraphClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSPFxMSGraphClient.js","sourceRoot":"","sources":["../../src/hooks/useSPFxMSGraphClient.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA+ClD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6JG;AACH,MAAM,UAAU,oBAAoB;IAApC,iBAkEC;IAjES,IAAA,WAAW,GAAK,cAAc,EAAE,YAArB,CAAsB;IACnC,IAAA,KAAsB,QAAQ,CAA8B,SAAS,CAAC,EAArE,MAAM,QAAA,EAAE,SAAS,QAAoD,CAAC;IACvE,IAAA,KAA4B,QAAQ,CAAC,KAAK,CAAC,EAA1C,SAAS,QAAA,EAAE,YAAY,QAAmB,CAAC;IAC5C,IAAA,KAAoB,QAAQ,CAAoB,SAAS,CAAC,EAAzD,KAAK,QAAA,EAAE,QAAQ,QAA0C,CAAC;IAEjE,0BAA0B;IAC1B,SAAS,CAAC;QACR,IAAM,GAAG,GAAG,WAIX,CAAC;QAEF,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,+EAA+E;QAC/E,GAAG,CAAC,oBAAoB;aACrB,SAAS,CAAC,GAAG,CAAC;aACd,IAAI,CAAC,UAAC,WAA4B;YACjC,SAAS,CAAC,WAAW,CAAC,CAAC;QACzB,CAAC,CAAC;aACD,KAAK,CAAC,UAAC,GAAU;YAChB,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,yCAAyC;IACzC,IAAM,MAAM,GAAG,WAAW,CACxB,UAAU,EAA2C;;;;;oBACnD,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;oBACpF,CAAC;oBAED,YAAY,CAAC,IAAI,CAAC,CAAC;oBACnB,QAAQ,CAAC,SAAS,CAAC,CAAC;;;;oBAGH,qBAAM,EAAE,CAAC,MAAM,CAAC,EAAA;;oBAAzB,MAAM,GAAG,SAAgB;oBAC/B,sBAAO,MAAM,EAAC;;;oBAER,UAAQ,KAAG,YAAY,KAAK,CAAC,CAAC,CAAC,KAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAG,CAAC,CAAC,CAAC;oBAClE,QAAQ,CAAC,OAAK,CAAC,CAAC;oBAChB,MAAM,OAAK,CAAC;;oBAEZ,YAAY,CAAC,KAAK,CAAC,CAAC;;;;;SAEvB,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,qBAAqB;IACrB,IAAM,UAAU,GAAG,WAAW,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,MAAM,QAAA;QACN,MAAM,QAAA;QACN,SAAS,WAAA;QACT,KAAK,OAAA;QACL,UAAU,YAAA;KACX,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useSPFxMSGraphClient.js","sourceRoot":"","sources":["../../src/hooks/useSPFxMSGraphClient.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAmB,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AA8C3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkKG;AACH,MAAM,UAAU,oBAAoB;IAApC,iBA6DC;IA5DS,IAAA,OAAO,GAAK,mBAAmB,EAAE,QAA1B,CAA2B;IAE1C,0EAA0E;IAC1E,IAAM,OAAO,GAAG,OAAO,CAAC;QACtB,OAAO,OAAO,CAAuB,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACxE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAER,IAAA,KAAsB,QAAQ,CAA8B,SAAS,CAAC,EAArE,MAAM,QAAA,EAAE,SAAS,QAAoD,CAAC;IACvE,IAAA,KAA4B,QAAQ,CAAC,KAAK,CAAC,EAA1C,SAAS,QAAA,EAAE,YAAY,QAAmB,CAAC;IAC5C,IAAA,KAAoB,QAAQ,CAAoB,SAAS,CAAC,EAAzD,KAAK,QAAA,EAAE,QAAQ,QAA0C,CAAC;IAEjE,uDAAuD;IACvD,SAAS,CAAC;QACR,+EAA+E;QAC/E,OAAO;aACJ,SAAS,CAAC,GAAG,CAAC;aACd,IAAI,CAAC,UAAC,WAA4B;YACjC,SAAS,CAAC,WAAW,CAAC,CAAC;QACzB,CAAC,CAAC;aACD,KAAK,CAAC,UAAC,GAAU;YAChB,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,yCAAyC;IACzC,IAAM,MAAM,GAAG,WAAW,CACxB,UAAU,EAA2C;;;;;oBACnD,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;oBACpF,CAAC;oBAED,YAAY,CAAC,IAAI,CAAC,CAAC;oBACnB,QAAQ,CAAC,SAAS,CAAC,CAAC;;;;oBAGH,qBAAM,EAAE,CAAC,MAAM,CAAC,EAAA;;oBAAzB,MAAM,GAAG,SAAgB;oBAC/B,sBAAO,MAAM,EAAC;;;oBAER,UAAQ,KAAG,YAAY,KAAK,CAAC,CAAC,CAAC,KAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAG,CAAC,CAAC,CAAC;oBAClE,QAAQ,CAAC,OAAK,CAAC,CAAC;oBAChB,MAAM,OAAK,CAAC;;oBAEZ,YAAY,CAAC,KAAK,CAAC,CAAC;;;;;SAEvB,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,qBAAqB;IACrB,IAAM,UAAU,GAAG,WAAW,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,MAAM,QAAA;QACN,MAAM,QAAA;QACN,SAAS,WAAA;QACT,KAAK,OAAA;QACL,UAAU,YAAA;KACX,CAAC;AACJ,CAAC"}

package/lib/hooks/useSPFxOneDriveAppData.d.ts

@@ -17,6 +17,11 @@ export interface SPFxOneDriveAppDataResult<T> {
      * Cleared on successful load or write.
      */
     readonly error: Error | undefined;
+    /**
+     * True if the file does not exist in OneDrive (404 / itemNotFound).
+     * In the legacy signature this is treated as a non-error.
+     */
+    readonly isNotFound: boolean;
     /**
      * Loading state for write operations.
      * True during write() calls.
@@ -72,6 +77,25 @@ export interface SPFxOneDriveAppDataResult<T> {
      */
     readonly isReady: boolean;
 }
+/**
+ * Optional configuration for useSPFxOneDriveAppData.
+ */
+export interface SPFxOneDriveAppDataOptions<T> {
+    /** Optional folder/namespace identifier for file organization. */
+    folder?: string;
+    /** Whether to automatically load file on mount. Default: true */
+    autoFetch?: boolean;
+    /**
+     * Default value to use when the file is missing (404).
+     * If provided, load() will set data to this value and will not set error.
+     */
+    defaultValue?: T;
+    /**
+     * If true, when the file is missing (404) and defaultValue is provided,
+     * the hook will attempt to create the file by writing defaultValue.
+     */
+    createIfMissing?: boolean;
+}
 /**
  * Hook to manage JSON files in user's OneDrive appRoot folder
  *
@@ -261,4 +285,5 @@ export interface SPFxOneDriveAppDataResult<T> {
  * ```
  */
 export declare function useSPFxOneDriveAppData<T = unknown>(fileName: string, folder?: string, autoFetch?: boolean): SPFxOneDriveAppDataResult<T>;
+export declare function useSPFxOneDriveAppData<T = unknown>(fileName: string, options?: SPFxOneDriveAppDataOptions<T>): SPFxOneDriveAppDataResult<T>;
 //# sourceMappingURL=useSPFxOneDriveAppData.d.ts.map

package/lib/hooks/useSPFxOneDriveAppData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSPFxOneDriveAppData.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxOneDriveAppData.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,KAAK,GAAG,SAAS,CAAC;IAEvC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2LG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAChD,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,GAAE,OAAc,GACxB,yBAAyB,CAAC,CAAC,CAAC,CA4J9B"}
+{"version":3,"file":"useSPFxOneDriveAppData.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxOneDriveAppData.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,KAAK,GAAG,SAAS,CAAC;IAEvC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2LG;AAEH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAChD,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,OAAO,GAClB,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAGhC,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAChD,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,0BAA0B,CAAC,CAAC,CAAC,GACtC,yBAAyB,CAAC,CAAC,CAAC,CAAC"}