@apvee/spfx-react-toolkit 1.2.1 → 1.3.0

package/lib/extensions/spFxReactToolkitTest/SpFxReactToolkitTestApplicationCustomizer.d.ts

@@ -0,0 +1,14 @@
+import { BaseApplicationCustomizer } from '@microsoft/sp-application-base';
+/**
+ * If your command set uses the ClientSideComponentProperties JSON input,
+ * it will be deserialized into the BaseExtension.properties object.
+ * You can define an interface to describe it.
+ */
+export interface ISpFxReactToolkitTestApplicationCustomizerProperties {
+    testMessage: string;
+}
+/** A Custom Action which can be run during execution of a Client Side Application */
+export default class SpFxReactToolkitTestApplicationCustomizer extends BaseApplicationCustomizer<ISpFxReactToolkitTestApplicationCustomizerProperties> {
+    onInit(): Promise<void>;
+}
+//# sourceMappingURL=SpFxReactToolkitTestApplicationCustomizer.d.ts.map

package/lib/extensions/spFxReactToolkitTest/SpFxReactToolkitTestApplicationCustomizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpFxReactToolkitTestApplicationCustomizer.d.ts","sourceRoot":"","sources":["../../../src/extensions/spFxReactToolkitTest/SpFxReactToolkitTestApplicationCustomizer.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAOxC;;;;GAIG;AACH,MAAM,WAAW,oDAAoD;IAEnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qFAAqF;AACrF,MAAM,CAAC,OAAO,OAAO,yCACnB,SAAQ,yBAAyB,CAAC,oDAAoD,CAAC;IAEhF,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAc/B"}

package/lib/extensions/spFxReactToolkitTest/SpFxReactToolkitTestApplicationCustomizer.js

@@ -0,0 +1,41 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import { Log } from '@microsoft/sp-core-library';
+import { BaseApplicationCustomizer } from '@microsoft/sp-application-base';
+import { Dialog } from '@microsoft/sp-dialog';
+import * as strings from 'SpFxReactToolkitTestApplicationCustomizerStrings';
+var LOG_SOURCE = 'SpFxReactToolkitTestApplicationCustomizer';
+/** A Custom Action which can be run during execution of a Client Side Application */
+var SpFxReactToolkitTestApplicationCustomizer = /** @class */ (function (_super) {
+    __extends(SpFxReactToolkitTestApplicationCustomizer, _super);
+    function SpFxReactToolkitTestApplicationCustomizer() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    SpFxReactToolkitTestApplicationCustomizer.prototype.onInit = function () {
+        Log.info(LOG_SOURCE, "Initialized ".concat(strings.Title));
+        var message = this.properties.testMessage;
+        if (!message) {
+            message = '(No properties were provided.)';
+        }
+        Dialog.alert("Hello from ".concat(strings.Title, ":\n\n").concat(message)).catch(function () {
+            /* handle error */
+        });
+        return Promise.resolve();
+    };
+    return SpFxReactToolkitTestApplicationCustomizer;
+}(BaseApplicationCustomizer));
+export default SpFxReactToolkitTestApplicationCustomizer;
+//# sourceMappingURL=SpFxReactToolkitTestApplicationCustomizer.js.map

package/lib/extensions/spFxReactToolkitTest/SpFxReactToolkitTestApplicationCustomizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpFxReactToolkitTestApplicationCustomizer.js","sourceRoot":"","sources":["../../../src/extensions/spFxReactToolkitTest/SpFxReactToolkitTestApplicationCustomizer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AACjD,OAAO,EACL,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,KAAK,OAAO,MAAM,kDAAkD,CAAC;AAE5E,IAAM,UAAU,GAAW,2CAA2C,CAAC;AAYvE,qFAAqF;AACrF;IACU,6DAA+E;IADzF;;IAiBA,CAAC;IAdQ,0DAAM,GAAb;QACE,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAe,OAAO,CAAC,KAAK,CAAE,CAAC,CAAC;QAErD,IAAI,OAAO,GAAW,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,gCAAgC,CAAC;QAC7C,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,qBAAc,OAAO,CAAC,KAAK,kBAAQ,OAAO,CAAE,CAAC,CAAC,KAAK,CAAC;YAC/D,kBAAkB;QACpB,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACH,gDAAC;AAAD,CAAC,AAjBD,CACU,yBAAyB,GAgBlC"}

package/lib/extensions/spFxReactToolkitTest/SpFxReactToolkitTestApplicationCustomizer.manifest.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/spfx/client-side-extension-manifest.schema.json",
+
+  "id": "4c2e58cc-1253-43e5-bfa3-b22a07ace279",
+  "alias": "SpFxReactToolkitTestApplicationCustomize",
+  "componentType": "Extension",
+  "extensionType": "ApplicationCustomizer",
+
+  // The "*" signifies that the version should be taken from the package.json
+  "version": "*",
+  "manifestVersion": 2,
+
+  // If true, the component can only be installed on sites where Custom Script is allowed.
+  // Components that allow authors to embed arbitrary script code should set this to true.
+  // https://support.office.com/en-us/article/Turn-scripting-capabilities-on-or-off-1f2c515f-5d7e-448a-9fd7-835da935584f
+  "requiresCustomScript": false
+}

package/lib/extensions/spFxReactToolkitTest/loc/en-us.js

@@ -0,0 +1,5 @@
+define([], function() {
+  return {
+    "Title": "SpFxReactToolkitTestApplicationCustomizer"
+  }
+});

package/lib/hooks/useSPFxAadHttpClient.d.ts

@@ -15,6 +15,7 @@ export interface SPFxAadHttpClientInfo {
      *
      * @param fn - Function that receives AadHttpClient and returns a promise
      * @returns Promise with the result
+     * @throws Error if client is not initialized yet
      *
      * @example
      * ```tsx
@@ -35,6 +36,7 @@ export interface SPFxAadHttpClientInfo {
     /**
      * Last error from invoke() calls.
      * Does not capture errors from direct client usage.
+     * @see initError for initialization errors
      */
     readonly error: Error | undefined;
     /** Clear the current error */
@@ -43,6 +45,50 @@ export interface SPFxAadHttpClientInfo {
     readonly setResourceUrl: (url: string) => void;
     /** Current Azure AD resource URL or App ID */
     readonly resourceUrl: string | undefined;
+    /**
+     * True while the AAD client is being initialized.
+     * Use this to show a loading indicator during startup.
+     *
+     * @example
+     * ```tsx
+     * const { client, isInitializing } = useSPFxAadHttpClient('https://api.contoso.com');
+     *
+     * if (isInitializing) return <Spinner label="Initializing AAD client..." />;
+     * if (!client) return <Error message="AAD client unavailable" />;
+     * ```
+     */
+    readonly isInitializing: boolean;
+    /**
+     * Error that occurred during client initialization.
+     * If set, the client will remain undefined.
+     *
+     * @example
+     * ```tsx
+     * const { initError } = useSPFxAadHttpClient('https://api.contoso.com');
+     *
+     * if (initError) {
+     *   return <MessageBar messageBarType={MessageBarType.error}>
+     *     Failed to initialize AAD client: {initError.message}
+     *   </MessageBar>;
+     * }
+     * ```
+     */
+    readonly initError: Error | undefined;
+    /**
+     * Computed state: true when client is ready for use.
+     * Equivalent to: client !== undefined && !isInitializing && !initError
+     *
+     * @example
+     * ```tsx
+     * const { isReady, invoke, resourceUrl } = useSPFxAadHttpClient('https://api.contoso.com');
+     *
+     * if (!isReady) return <Spinner />;
+     *
+     * // Safe to use client or invoke
+     * const data = await invoke(c => c.get(`${resourceUrl}/api/data`, ...).then(r => r.json()));
+     * ```
+     */
+    readonly isReady: boolean;
 }
 /**
  * Hook to access Azure AD-secured APIs with built-in state management

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

@@ -1 +1 @@
-{"version":3,"file":"useSPFxAadHttpClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxAadHttpClient.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAwB,MAAM,oBAAoB,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAE3C;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9E;;;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;IAEhC,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/C,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2LG;AACH,wBAAgB,oBAAoB,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,qBAAqB,CA+CvF"}
+{"version":3,"file":"useSPFxAadHttpClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxAadHttpClient.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAwB,MAAM,oBAAoB,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAE3C;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9E;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAElC,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAEhC,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/C,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEzC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAEjC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,SAAS,CAAC;IAEtC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2LG;AACH,wBAAgB,oBAAoB,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAsGvF"}

package/lib/hooks/useSPFxAadHttpClient.js

@@ -1,6 +1,6 @@
 // useSPFxAadHttpClient.ts
 // Hook to access Azure AD-secured APIs with state management
-import { useMemo, useState, useEffect } from 'react';
+import { useMemo, useState, useEffect, useRef } from 'react';
 import { useSPFxServiceScope } from './useSPFxServiceScope';
 import { AadHttpClientFactory } from '@microsoft/sp-http';
 import { useAsyncInvoke } from './useAsyncInvoke.internal';
@@ -194,32 +194,74 @@ import { useAsyncInvoke } from './useAsyncInvoke.internal';
  */
 export function useSPFxAadHttpClient(initialResourceUrl) {
     var consume = useSPFxServiceScope().consume;
+    // ═══════════════════════════════════════════════════════════════════════════
+    // STATE
+    // ═══════════════════════════════════════════════════════════════════════════
+    var _a = useState(initialResourceUrl), resourceUrl = _a[0], setResourceUrl = _a[1];
+    var _b = useState(undefined), client = _b[0], setClient = _b[1];
+    var _c = useState(!!initialResourceUrl), isInitializing = _c[0], setIsInitializing = _c[1];
+    var _d = useState(undefined), initError = _d[0], setInitError = _d[1];
+    // ═══════════════════════════════════════════════════════════════════════════
+    // REFS (for cleanup and preventing memory leaks)
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Track component mounted state to prevent memory leaks
+    var isMountedRef = useRef(true);
+    // Cleanup on unmount
+    useEffect(function () {
+        return function () {
+            isMountedRef.current = false;
+        };
+    }, []);
+    // ═══════════════════════════════════════════════════════════════════════════
+    // FACTORY (lazy consume from ServiceScope)
+    // ═══════════════════════════════════════════════════════════════════════════
     // Lazy consume AadHttpClientFactory from ServiceScope (cached by useMemo)
     var factory = useMemo(function () {
         return consume(AadHttpClientFactory.serviceKey);
     }, [consume]);
-    // State management for resourceUrl and client
-    var _a = useState(initialResourceUrl), resourceUrl = _a[0], setResourceUrl = _a[1];
-    var _b = useState(undefined), client = _b[0], setClient = _b[1];
+    // ═══════════════════════════════════════════════════════════════════════════
+    // INITIALIZATION EFFECT
+    // ═══════════════════════════════════════════════════════════════════════════
     // Initialize client when resourceUrl changes
     useEffect(function () {
-        // Reset client immediately when resourceUrl changes
+        // Reset client and error immediately when resourceUrl changes
         setClient(undefined);
+        setInitError(undefined);
         if (!resourceUrl) {
+            setIsInitializing(false);
             return;
         }
+        setIsInitializing(true);
         // Get AadHttpClient for the specified resource
         factory
             .getClient(resourceUrl)
             .then(function (aadClient) {
-            setClient(aadClient);
+            // Only update state if still mounted
+            if (isMountedRef.current) {
+                setClient(aadClient);
+                setIsInitializing(false);
+            }
         })
             .catch(function (err) {
-            console.error('Failed to initialize AadHttpClient:', err);
+            // Only update state if still mounted
+            if (isMountedRef.current) {
+                var error_1 = err instanceof Error ? err : new Error(String(err));
+                setInitError(error_1);
+                setIsInitializing(false);
+                console.error('Failed to initialize AadHttpClient:', error_1);
+            }
         });
     }, [resourceUrl, factory]);
+    // ═══════════════════════════════════════════════════════════════════════════
+    // ASYNC INVOKE PATTERN
+    // ═══════════════════════════════════════════════════════════════════════════
     // Use shared async invocation pattern
-    var _c = useAsyncInvoke(client, 'AadHttpClient not initialized. Set resourceUrl and wait for client initialization.'), invoke = _c.invoke, isLoading = _c.isLoading, error = _c.error, clearError = _c.clearError;
+    var _e = useAsyncInvoke(client, 'AadHttpClient not initialized. Set resourceUrl and wait for client initialization, or check initError.'), invoke = _e.invoke, isLoading = _e.isLoading, error = _e.error, clearError = _e.clearError;
+    // ═══════════════════════════════════════════════════════════════════════════
+    // COMPUTED STATE & RETURN
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Computed: ready when client is available and no errors
+    var isReady = client !== undefined && !isInitializing && !initError;
     return {
         client: client,
         invoke: invoke,
@@ -228,6 +270,9 @@ export function useSPFxAadHttpClient(initialResourceUrl) {
         clearError: clearError,
         setResourceUrl: setResourceUrl,
         resourceUrl: resourceUrl,
+        isInitializing: isInitializing,
+        initError: initError,
+        isReady: isReady,
     };
 }
 //# sourceMappingURL=useSPFxAadHttpClient.js.map

package/lib/hooks/useSPFxAadHttpClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSPFxAadHttpClient.js","sourceRoot":"","sources":["../../src/hooks/useSPFxAadHttpClient.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,6DAA6D;AAE7D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAiB,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAsD3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2LG;AACH,MAAM,UAAU,oBAAoB,CAAC,kBAA2B;IACtD,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;IAEd,8CAA8C;IACxC,IAAA,KAAgC,QAAQ,CAAqB,kBAAkB,CAAC,EAA/E,WAAW,QAAA,EAAE,cAAc,QAAoD,CAAC;IACjF,IAAA,KAAsB,QAAQ,CAA4B,SAAS,CAAC,EAAnE,MAAM,QAAA,EAAE,SAAS,QAAkD,CAAC;IAE3E,6CAA6C;IAC7C,SAAS,CAAC;QACR,oDAAoD;QACpD,SAAS,CAAC,SAAS,CAAC,CAAC;QAErB,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,+CAA+C;QAC/C,OAAO;aACJ,SAAS,CAAC,WAAW,CAAC;aACtB,IAAI,CAAC,UAAC,SAAwB;YAC7B,SAAS,CAAC,SAAS,CAAC,CAAC;QACvB,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,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3B,sCAAsC;IAChC,IAAA,KAA2C,cAAc,CAC7D,MAAM,EACN,oFAAoF,CACrF,EAHO,MAAM,YAAA,EAAE,SAAS,eAAA,EAAE,KAAK,WAAA,EAAE,UAAU,gBAG3C,CAAC;IAEF,OAAO;QACL,MAAM,QAAA;QACN,MAAM,QAAA;QACN,SAAS,WAAA;QACT,KAAK,OAAA;QACL,UAAU,YAAA;QACV,cAAc,gBAAA;QACd,WAAW,aAAA;KACZ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useSPFxAadHttpClient.js","sourceRoot":"","sources":["../../src/hooks/useSPFxAadHttpClient.ts"],"names":[],"mappings":"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"}

package/lib/hooks/useSPFxHttpClient.d.ts

@@ -6,15 +6,16 @@ export interface SPFxHttpClientInfo {
     /**
      * Native HttpClient from SPFx.
      * Provides access to generic HTTP endpoints (non-SharePoint).
-     * Always available (non-undefined) after Provider initialization.
+     * Will be undefined if ServiceScope is not available.
      */
-    readonly client: HttpClient;
+    readonly client: HttpClient | undefined;
     /**
      * Invoke HTTP API call with automatic state management.
      * Tracks loading state and captures errors automatically.
      *
      * @param fn - Function that receives HttpClient and returns a promise
      * @returns Promise with the result
+     * @throws Error if client is not available
      *
      * @example
      * ```tsx
@@ -39,6 +40,21 @@ export interface SPFxHttpClientInfo {
     readonly error: Error | undefined;
     /** Clear the current error */
     readonly clearError: () => void;
+    /**
+     * Computed state: true when client is ready for use.
+     * Equivalent to: client !== undefined
+     *
+     * @example
+     * ```tsx
+     * const { isReady, invoke } = useSPFxHttpClient();
+     *
+     * if (!isReady) return <Spinner label="Waiting for HttpClient..." />;
+     *
+     * // Safe to use invoke
+     * const data = await invoke(c => c.get(...).then(r => r.json()));
+     * ```
+     */
+    readonly isReady: boolean;
 }
 /**
  * Hook to access generic HTTP client with built-in state management

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

@@ -1 +1 @@
-{"version":3,"file":"useSPFxHttpClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxHttpClient.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3E;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwLG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAqBtD"}
+{"version":3,"file":"useSPFxHttpClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxHttpClient.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAExC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3E;;;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;IAEhC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwLG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CA+BtD"}

package/lib/hooks/useSPFxHttpClient.js

@@ -192,17 +192,27 @@ import { useAsyncInvoke } from './useAsyncInvoke.internal';
 export function useSPFxHttpClient() {
     var consume = useSPFxServiceScope().consume;
     // Lazy consume HttpClient from ServiceScope (cached by useMemo)
+    // Returns undefined if ServiceScope is not available
     var client = useMemo(function () {
-        return consume(HttpClient.serviceKey);
+        try {
+            return consume(HttpClient.serviceKey);
+        }
+        catch (err) {
+            console.error('Failed to consume HttpClient from ServiceScope:', err);
+            return undefined;
+        }
     }, [consume]);
     // Use shared async invocation pattern
-    var _a = useAsyncInvoke(client, 'HttpClient not initialized. Check SPFx context.'), invoke = _a.invoke, isLoading = _a.isLoading, error = _a.error, clearError = _a.clearError;
+    var _a = useAsyncInvoke(client, 'HttpClient not available. Check SPFx context and ServiceScope.'), invoke = _a.invoke, isLoading = _a.isLoading, error = _a.error, clearError = _a.clearError;
+    // Computed: ready when client is available
+    var isReady = client !== undefined;
     return {
         client: client,
         invoke: invoke,
         isLoading: isLoading,
         error: error,
         clearError: clearError,
+        isReady: isReady,
     };
 }
 //# sourceMappingURL=useSPFxHttpClient.js.map

package/lib/hooks/useSPFxHttpClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSPFxHttpClient.js","sourceRoot":"","sources":["../../src/hooks/useSPFxHttpClient.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,2DAA2D;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAgD3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwLG;AACH,MAAM,UAAU,iBAAiB;IACvB,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,sCAAsC;IAChC,IAAA,KAA2C,cAAc,CAC7D,MAAM,EACN,iDAAiD,CAClD,EAHO,MAAM,YAAA,EAAE,SAAS,eAAA,EAAE,KAAK,WAAA,EAAE,UAAU,gBAG3C,CAAC;IAEF,OAAO;QACL,MAAM,QAAA;QACN,MAAM,QAAA;QACN,SAAS,WAAA;QACT,KAAK,OAAA;QACL,UAAU,YAAA;KACX,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useSPFxHttpClient.js","sourceRoot":"","sources":["../../src/hooks/useSPFxHttpClient.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,2DAA2D;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAiE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwLG;AACH,MAAM,UAAU,iBAAiB;IACvB,IAAA,OAAO,GAAK,mBAAmB,EAAE,QAA1B,CAA2B;IAE1C,gEAAgE;IAChE,qDAAqD;IACrD,IAAM,MAAM,GAAG,OAAO,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,OAAO,CAAa,UAAU,CAAC,UAAU,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,GAAG,CAAC,CAAC;YACtE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,sCAAsC;IAChC,IAAA,KAA2C,cAAc,CAC7D,MAAM,EACN,gEAAgE,CACjE,EAHO,MAAM,YAAA,EAAE,SAAS,eAAA,EAAE,KAAK,WAAA,EAAE,UAAU,gBAG3C,CAAC;IAEF,2CAA2C;IAC3C,IAAM,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC;IAErC,OAAO;QACL,MAAM,QAAA;QACN,MAAM,QAAA;QACN,SAAS,WAAA;QACT,KAAK,OAAA;QACL,UAAU,YAAA;QACV,OAAO,SAAA;KACR,CAAC;AACJ,CAAC"}

package/lib/hooks/useSPFxMSGraphClient.d.ts

@@ -6,6 +6,7 @@ export interface SPFxMSGraphClientInfo {
     /**
      * Native MSGraphClientV3 from SPFx.
      * Provides access to Microsoft Graph API with built-in authentication.
+     * Will be undefined until initialization completes.
      */
     readonly client: MSGraphClientV3 | undefined;
     /**
@@ -14,6 +15,7 @@ export interface SPFxMSGraphClientInfo {
      *
      * @param fn - Function that receives Graph client and returns a promise
      * @returns Promise with the result
+     * @throws Error if client is not initialized yet
      *
      * @example
      * ```tsx
@@ -27,16 +29,61 @@ export interface SPFxMSGraphClientInfo {
     readonly invoke: <T>(fn: (client: MSGraphClientV3) => Promise<T>) => Promise<T>;
     /**
      * Loading state - true during invoke() calls.
-     * Does not track direct client usage.
+     * Does not track direct client usage or initialization.
      */
     readonly isLoading: boolean;
     /**
      * Last error from invoke() calls.
-     * Does not capture errors from direct client usage.
+     * Does not capture errors from direct client usage or initialization.
+     * @see initError for initialization errors
      */
     readonly error: Error | undefined;
-    /** Clear the current error */
+    /** Clear the current error from invoke() calls */
     readonly clearError: () => void;
+    /**
+     * True while the Graph client is being initialized.
+     * Use this to show a loading indicator during startup.
+     *
+     * @example
+     * ```tsx
+     * const { client, isInitializing } = useSPFxMSGraphClient();
+     *
+     * if (isInitializing) return <Spinner label="Initializing Graph..." />;
+     * if (!client) return <Error message="Graph client unavailable" />;
+     * ```
+     */
+    readonly isInitializing: boolean;
+    /**
+     * Error that occurred during client initialization.
+     * If set, the client will remain undefined.
+     *
+     * @example
+     * ```tsx
+     * const { initError } = useSPFxMSGraphClient();
+     *
+     * if (initError) {
+     *   return <MessageBar messageBarType={MessageBarType.error}>
+     *     Failed to initialize Graph: {initError.message}
+     *   </MessageBar>;
+     * }
+     * ```
+     */
+    readonly initError: Error | undefined;
+    /**
+     * Computed state: true when client is ready for use.
+     * Equivalent to: client !== undefined && !isInitializing && !initError
+     *
+     * @example
+     * ```tsx
+     * const { isReady, client, invoke } = useSPFxMSGraphClient();
+     *
+     * if (!isReady) return <Spinner />;
+     *
+     * // Safe to use client or invoke
+     * const data = await invoke(c => c.api('/me').get());
+     * ```
+     */
+    readonly isReady: boolean;
 }
 /**
  * Hook to access Microsoft Graph client with built-in state management

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,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAG3E;;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,CAoC5D"}
+{"version":3,"file":"useSPFxMSGraphClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxMSGraphClient.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAG3E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IAE7C;;;;;;;;;;;;;;;;OAgBG;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;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAElC,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAEhC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAEjC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,SAAS,CAAC;IAEtC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkKG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CAqG5D"}

package/lib/hooks/useSPFxMSGraphClient.js

@@ -1,6 +1,6 @@
 // useSPFxMSGraphClient.ts
 // Hook to access Microsoft Graph client with state management
-import { useMemo, useState, useEffect } from 'react';
+import { useMemo, useState, useEffect, useRef } from 'react';
 import { useSPFxServiceScope } from './useSPFxServiceScope';
 import { MSGraphClientFactory } from '@microsoft/sp-http';
 import { useAsyncInvoke } from './useAsyncInvoke.internal';
@@ -169,31 +169,84 @@ import { useAsyncInvoke } from './useAsyncInvoke.internal';
  */
 export function useSPFxMSGraphClient() {
     var consume = useSPFxServiceScope().consume;
+    // ═══════════════════════════════════════════════════════════════════════════
+    // STATE
+    // ═══════════════════════════════════════════════════════════════════════════
+    var _a = useState(undefined), client = _a[0], setClient = _a[1];
+    var _b = useState(true), isInitializing = _b[0], setIsInitializing = _b[1];
+    var _c = useState(undefined), initError = _c[0], setInitError = _c[1];
+    // ═══════════════════════════════════════════════════════════════════════════
+    // REFS (for cleanup and preventing double initialization)
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Track component mounted state to prevent memory leaks
+    var isMountedRef = useRef(true);
+    // Track if initialization has been attempted (prevent double init)
+    var initAttemptedRef = useRef(false);
+    // Cleanup on unmount
+    useEffect(function () {
+        return function () {
+            isMountedRef.current = false;
+        };
+    }, []);
+    // ═══════════════════════════════════════════════════════════════════════════
+    // FACTORY (lazy consume from ServiceScope)
+    // ═══════════════════════════════════════════════════════════════════════════
     // 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];
+    // ═══════════════════════════════════════════════════════════════════════════
+    // INITIALIZATION EFFECT
+    // ═══════════════════════════════════════════════════════════════════════════
     // Initialize Graph client (factory.getClient is async)
     useEffect(function () {
+        // Prevent double initialization
+        if (initAttemptedRef.current) {
+            return;
+        }
+        initAttemptedRef.current = true;
+        // Reset state for new initialization
+        setIsInitializing(true);
+        setInitError(undefined);
         // Get MSGraphClientV3 (version 3 of Microsoft Graph JavaScript Client Library)
         factory
             .getClient('3')
             .then(function (graphClient) {
-            setClient(graphClient);
+            // Only update state if still mounted
+            if (isMountedRef.current) {
+                setClient(graphClient);
+                setIsInitializing(false);
+            }
         })
             .catch(function (err) {
-            console.error('Failed to initialize MSGraphClient:', err);
+            // Only update state if still mounted
+            if (isMountedRef.current) {
+                var error_1 = err instanceof Error ? err : new Error(String(err));
+                setInitError(error_1);
+                setIsInitializing(false);
+                console.error('Failed to initialize MSGraphClient:', error_1);
+            }
         });
     }, [factory]);
+    // ═══════════════════════════════════════════════════════════════════════════
+    // ASYNC INVOKE PATTERN
+    // ═══════════════════════════════════════════════════════════════════════════
     // Use shared async invocation pattern
-    var _b = useAsyncInvoke(client, 'Graph client not initialized. Wait for client to be available.'), invoke = _b.invoke, isLoading = _b.isLoading, error = _b.error, clearError = _b.clearError;
+    var _d = useAsyncInvoke(client, 'Graph client not initialized. Wait for client to be available or check initError.'), invoke = _d.invoke, isLoading = _d.isLoading, error = _d.error, clearError = _d.clearError;
+    // ═══════════════════════════════════════════════════════════════════════════
+    // COMPUTED STATE & RETURN
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Computed: ready when client is available and no errors
+    var isReady = client !== undefined && !isInitializing && !initError;
     return {
         client: client,
         invoke: invoke,
         isLoading: isLoading,
         error: error,
         clearError: clearError,
+        isInitializing: isInitializing,
+        initError: initError,
+        isReady: isReady,
     };
 }
 //# sourceMappingURL=useSPFxMSGraphClient.js.map

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,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAmB,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA8C3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkKG;AACH,MAAM,UAAU,oBAAoB;IAC1B,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;IAE7E,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,sCAAsC;IAChC,IAAA,KAA2C,cAAc,CAC7D,MAAM,EACN,gEAAgE,CACjE,EAHO,MAAM,YAAA,EAAE,SAAS,eAAA,EAAE,KAAK,WAAA,EAAE,UAAU,gBAG3C,CAAC;IAEF,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":"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"}

package/lib/hooks/useSPFxOneDriveAppData.d.ts

@@ -284,6 +284,5 @@ export interface SPFxOneDriveAppDataOptions<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,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"}
+{"version":3,"file":"useSPFxOneDriveAppData.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxOneDriveAppData.ts"],"names":[],"mappings":"AA4DA;;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;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAChD,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,0BAA0B,CAAC,CAAC,CAAC,GACtC,yBAAyB,CAAC,CAAC,CAAC,CAqP9B"}