@apvee/spfx-react-toolkit 1.0.0 → 1.2.0

package/lib/hooks/useSPFxOneDriveAppData.js

@@ -38,204 +38,25 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 };
 import { useState, useCallback, useEffect, useRef } from 'react';
 import { useSPFxMSGraphClient } from './useSPFxMSGraphClient';
-/**
- * Hook to manage JSON files in user's OneDrive appRoot folder
- *
- * Provides unified read/write operations for JSON data stored in OneDrive's special
- * appRoot folder (accessible per-app, user-scoped storage).
- *
- * Features:
- * - Automatic JSON serialization/deserialization
- * - Separate loading states for read/write operations
- * - Optional auto-fetch on mount
- * - Folder/namespace support for file organization
- * - Type-safe with TypeScript generics
- * - Memory leak safe with mounted state tracking
- * - Error handling for both read and write operations
- *
- * Requirements:
- * - Microsoft Graph permissions: Files.ReadWrite or Files.ReadWrite.AppFolder
- * - User must be authenticated
- *
- * @param fileName - Name of the JSON file (e.g., 'config.json', 'settings.json')
- * @param folder - Optional folder/namespace identifier for file organization.
- *                 Will be sanitized to prevent path traversal.
- *                 Examples: 'my-app', instanceId (GUID), 'config-v2'
- * @param autoFetch - Whether to automatically load file on mount. Default: true
- *
- * @returns Object with data, loading states, error states, and read/write functions
- *
- * @example Basic usage - auto-fetch from root
- * ```tsx
- * import type { MyConfig } from './types';
- *
- * function ConfigPanel() {
- *   const { data, isLoading, error, write, isWriting } =
- *     useSPFxOneDriveAppData<MyConfig>('config.json');
- *
- *   if (isLoading) return <Spinner label="Loading configuration..." />;
- *   if (error) return <MessageBar messageBarType={MessageBarType.error}>
- *     Failed to load: {error.message}
- *   </MessageBar>;
- *
- *   const handleSave = async (newConfig: MyConfig) => {
- *     try {
- *       await write(newConfig);
- *       console.log('Saved successfully!');
- *     } catch (err) {
- *       console.error('Save failed:', err);
- *     }
- *   };
- *
- *   return (
- *     <div>
- *       <TextField
- *         value={data?.title}
- *         onChange={(_, val) => handleSave({ ...data, title: val })}
- *         disabled={isWriting}
- *       />
- *       {isWriting && <Spinner label="Saving..." />}
- *     </div>
- *   );
- * }
- * ```
- *
- * @example With folder namespace
- * ```tsx
- * // Store files in a dedicated folder
- * const { data, write } = useSPFxOneDriveAppData<State>(
- *   'state.json',
- *   'my-app-v2'  // Files stored in appRoot:/my-app-v2/state.json
- * );
- * ```
- *
- * @example Per-instance storage (multi-instance support)
- * ```tsx
- * // Each WebPart instance has its own data
- * const { id } = useSPFxInstanceInfo();
- * const { data, write } = useSPFxOneDriveAppData<Settings>(
- *   'settings.json',
- *   id  // Files stored in appRoot:/abc-123-guid/settings.json
- * );
- * ```
- *
- * @example Lazy loading (manual load)
- * ```tsx
- * const { data, load, isLoading, write } = useSPFxOneDriveAppData<Cache>(
- *   'cache.json',
- *   'my-app',
- *   false  // Don't auto-fetch
- * );
- *
- * return (
- *   <div>
- *     <button onClick={load} disabled={isLoading}>
- *       {isLoading ? 'Loading...' : 'Load Cache'}
- *     </button>
- *     {data && <pre>{JSON.stringify(data, null, 2)}</pre>}
- *   </div>
- * );
- * ```
- *
- * @example Multiple files in same namespace
- * ```tsx
- * function MyApp() {
- *   const config = useSPFxOneDriveAppData<Config>('config.json', 'myapp');
- *   const state = useSPFxOneDriveAppData<State>('state.json', 'myapp');
- *   const cache = useSPFxOneDriveAppData<Cache>('cache.json', 'myapp');
- *
- *   // All files stored in appRoot:/myapp/
- *   // Easy to manage and clean up as a group
- * }
- * ```
- *
- * @example Error handling and retry
- * ```tsx
- * function DataManager() {
- *   const { data, error, load, writeError, write, isReady } =
- *     useSPFxOneDriveAppData<MyData>('data.json');
- *
- *   if (error) {
- *     return (
- *       <MessageBar
- *         messageBarType={MessageBarType.error}
- *         actions={<button onClick={load}>Retry</button>}
- *       >
- *         Load failed: {error.message}
- *       </MessageBar>
- *     );
- *   }
- *
- *   if (writeError) {
- *     return (
- *       <MessageBar messageBarType={MessageBarType.warning}>
- *         Save failed: {writeError.message}
- *       </MessageBar>
- *     );
- *   }
- *
- *   if (!isReady) return <Spinner />;
- *
- *   return <DataDisplay data={data} onSave={write} />;
- * }
- * ```
- *
- * @example CRUD-like operations
- * ```tsx
- * interface TodoList {
- *   items: Array<{ id: string; text: string; done: boolean }>;
- * }
- *
- * function TodoApp() {
- *   const { data, write, isLoading, isWriting } =
- *     useSPFxOneDriveAppData<TodoList>('todos.json', 'todo-app');
- *
- *   const addTodo = async (text: string) => {
- *     const newItem = { id: crypto.randomUUID(), text, done: false };
- *     await write({
- *       items: [...(data?.items ?? []), newItem]
- *     });
- *   };
- *
- *   const toggleTodo = async (id: string) => {
- *     await write({
- *       items: data?.items.map(item =>
- *         item.id === id ? { ...item, done: !item.done } : item
- *       ) ?? []
- *     });
- *   };
- *
- *   const deleteTodo = async (id: string) => {
- *     await write({
- *       items: data?.items.filter(item => item.id !== id) ?? []
- *     });
- *   };
- *
- *   if (isLoading) return <Spinner />;
- *
- *   return (
- *     <div>
- *       <TodoList
- *         items={data?.items ?? []}
- *         onToggle={toggleTodo}
- *         onDelete={deleteTodo}
- *       />
- *       <AddTodoForm onAdd={addTodo} disabled={isWriting} />
- *     </div>
- *   );
- * }
- * ```
- */
-export function useSPFxOneDriveAppData(fileName, folder, autoFetch) {
+export function useSPFxOneDriveAppData(fileName, folderOrOptions, autoFetch) {
     var _this = this;
+    var _a, _b;
     if (autoFetch === void 0) { autoFetch = true; }
     var client = useSPFxMSGraphClient().client;
+    var options = typeof folderOrOptions === 'object' && folderOrOptions !== null
+        ? folderOrOptions
+        : { folder: folderOrOptions, autoFetch: autoFetch };
+    var folder = options.folder;
+    var shouldAutoFetch = (_a = options.autoFetch) !== null && _a !== void 0 ? _a : true;
+    var defaultValue = options.defaultValue;
+    var createIfMissing = (_b = options.createIfMissing) !== null && _b !== void 0 ? _b : false;
     // State management
-    var _a = useState(undefined), data = _a[0], setData = _a[1];
-    var _b = useState(false), isLoading = _b[0], setIsLoading = _b[1];
-    var _c = useState(undefined), error = _c[0], setError = _c[1];
-    var _d = useState(false), isWriting = _d[0], setIsWriting = _d[1];
-    var _e = useState(undefined), writeError = _e[0], setWriteError = _e[1];
+    var _c = useState(defaultValue), data = _c[0], setData = _c[1];
+    var _d = useState(false), isLoading = _d[0], setIsLoading = _d[1];
+    var _e = useState(undefined), error = _e[0], setError = _e[1];
+    var _f = useState(false), isWriting = _f[0], setIsWriting = _f[1];
+    var _g = useState(undefined), writeError = _g[0], setWriteError = _g[1];
+    var _h = useState(false), isNotFound = _h[0], setIsNotFound = _h[1];
     // Track component mounted state to prevent memory leaks
     var isMounted = useRef(true);
     useEffect(function () {
@@ -258,59 +79,68 @@ export function useSPFxOneDriveAppData(fileName, folder, autoFetch) {
         }
         return "".concat(basePath, "/").concat(file, ":/content");
     }, []);
+    var isNotFoundError = useCallback(function (err) {
+        var _a, _b, _c, _d, _e, _f;
+        var anyErr = err;
+        if ((anyErr === null || anyErr === void 0 ? void 0 : anyErr.statusCode) === 404 || (anyErr === null || anyErr === void 0 ? void 0 : anyErr.status) === 404)
+            return true;
+        var code = (_a = anyErr === null || anyErr === void 0 ? void 0 : anyErr.code) !== null && _a !== void 0 ? _a : (_c = (_b = anyErr === null || anyErr === void 0 ? void 0 : anyErr.body) === null || _b === void 0 ? void 0 : _b.error) === null || _c === void 0 ? void 0 : _c.code;
+        if (code && /itemnotfound/i.test(code))
+            return true;
+        var message = (_d = anyErr === null || anyErr === void 0 ? void 0 : anyErr.message) !== null && _d !== void 0 ? _d : (_f = (_e = anyErr === null || anyErr === void 0 ? void 0 : anyErr.body) === null || _e === void 0 ? void 0 : _e.error) === null || _f === void 0 ? void 0 : _f.message;
+        if (message && /(\b404\b|not found|itemnotfound)/i.test(message))
+            return true;
+        return false;
+    }, []);
     /**
-     * Load file from OneDrive
-     * Updates data, isLoading, and error states
+     * Write data to OneDrive file
+     * Creates file if it doesn't exist, updates if it does (upsert)
+     * Updates isWriting and writeError states
      */
-    var load = useCallback(function () { return __awaiter(_this, void 0, void 0, function () {
-        var apiPath, fileContent, err_1, error_1;
+    var write = useCallback(function (content) { return __awaiter(_this, void 0, void 0, function () {
+        var apiPath, jsonContent, err_1, error_1;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
                     if (!client) {
-                        console.warn('Graph client not available yet. Skipping load.');
-                        return [2 /*return*/];
+                        throw new Error('Graph client not available. Cannot write file.');
                     }
                     if (!fileName) {
-                        console.warn('fileName is required. Skipping load.');
-                        return [2 /*return*/];
+                        throw new Error('fileName is required. Cannot write file.');
                     }
-                    setIsLoading(true);
-                    setError(undefined);
+                    setIsWriting(true);
+                    setWriteError(undefined);
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 3, 4, 5]);
                     apiPath = buildApiPath(fileName, folder);
-                    return [4 /*yield*/, client.api(apiPath).get()];
+                    jsonContent = JSON.stringify(content);
+                    return [4 /*yield*/, client
+                            .api(apiPath)
+                            .header('Content-Type', 'application/json')
+                            .put(jsonContent)];
                 case 2:
-                    fileContent = _a.sent();
+                    _a.sent();
                     if (isMounted.current) {
-                        // Parse JSON if response is string, otherwise use as-is
-                        if (typeof fileContent === 'string') {
-                            try {
-                                setData(JSON.parse(fileContent));
-                            }
-                            catch (parseError) {
-                                throw new Error("Failed to parse JSON: ".concat(parseError instanceof Error ? parseError.message : 'Unknown error'));
-                            }
-                        }
-                        else {
-                            setData(fileContent);
-                        }
+                        // Update local data to reflect successful write
+                        setData(content);
+                        setIsNotFound(false);
+                        // Clear read error if write succeeds (fresh state)
+                        setError(undefined);
                     }
                     return [3 /*break*/, 5];
                 case 3:
                     err_1 = _a.sent();
                     if (isMounted.current) {
                         error_1 = err_1 instanceof Error ? err_1 : new Error(String(err_1));
-                        setError(error_1);
-                        // Don't throw - allow component to handle error via state
-                        console.error('Failed to load file from OneDrive:', error_1);
+                        setWriteError(error_1);
+                        console.error('Failed to write file to OneDrive:', error_1);
                     }
-                    return [3 /*break*/, 5];
+                    // Re-throw to allow caller to handle
+                    throw err_1;
                 case 4:
                     if (isMounted.current) {
-                        setIsLoading(false);
+                        setIsWriting(false);
                     }
                     return [7 /*endfinally*/];
                 case 5: return [2 /*return*/];
@@ -318,67 +148,101 @@ export function useSPFxOneDriveAppData(fileName, folder, autoFetch) {
         });
     }); }, [client, fileName, folder, buildApiPath]);
     /**
-     * Write data to OneDrive file
-     * Creates file if it doesn't exist, updates if it does (upsert)
-     * Updates isWriting and writeError states
+     * Load file from OneDrive
+     * Updates data, isLoading, and error states
      */
-    var write = useCallback(function (content) { return __awaiter(_this, void 0, void 0, function () {
-        var apiPath, jsonContent, err_2, error_2;
+    var load = useCallback(function () { return __awaiter(_this, void 0, void 0, function () {
+        var apiPath, fileContent, err_2, notFound, writeErr_1, error_2;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
                     if (!client) {
-                        throw new Error('Graph client not available. Cannot write file.');
+                        console.warn('Graph client not available yet. Skipping load.');
+                        return [2 /*return*/];
                     }
                     if (!fileName) {
-                        throw new Error('fileName is required. Cannot write file.');
+                        console.warn('fileName is required. Skipping load.');
+                        return [2 /*return*/];
                     }
-                    setIsWriting(true);
-                    setWriteError(undefined);
+                    setIsLoading(true);
+                    setError(undefined);
+                    setIsNotFound(false);
                     _a.label = 1;
                 case 1:
-                    _a.trys.push([1, 3, 4, 5]);
+                    _a.trys.push([1, 3, 12, 13]);
                     apiPath = buildApiPath(fileName, folder);
-                    jsonContent = JSON.stringify(content);
-                    return [4 /*yield*/, client
-                            .api(apiPath)
-                            .header('Content-Type', 'application/json')
-                            .put(jsonContent)];
+                    return [4 /*yield*/, client.api(apiPath).get()];
                 case 2:
-                    _a.sent();
+                    fileContent = _a.sent();
                     if (isMounted.current) {
-                        // Update local data to reflect successful write
-                        setData(content);
-                        // Clear read error if write succeeds (fresh state)
-                        setError(undefined);
+                        // Parse JSON if response is string, otherwise use as-is
+                        if (typeof fileContent === 'string') {
+                            try {
+                                setData(JSON.parse(fileContent));
+                            }
+                            catch (parseError) {
+                                throw new Error("Failed to parse JSON: ".concat(parseError instanceof Error ? parseError.message : 'Unknown error'));
+                            }
+                        }
+                        else {
+                            setData(fileContent);
+                        }
+                        setIsNotFound(false);
                     }
-                    return [3 /*break*/, 5];
+                    return [3 /*break*/, 13];
                 case 3:
                     err_2 = _a.sent();
-                    if (isMounted.current) {
-                        error_2 = err_2 instanceof Error ? err_2 : new Error(String(err_2));
-                        setWriteError(error_2);
-                        console.error('Failed to write file to OneDrive:', error_2);
-                    }
-                    // Re-throw to allow caller to handle
-                    throw err_2;
+                    if (!isMounted.current) return [3 /*break*/, 11];
+                    notFound = isNotFoundError(err_2);
+                    setIsNotFound(notFound);
+                    if (!notFound) return [3 /*break*/, 10];
+                    if (!(defaultValue !== undefined)) return [3 /*break*/, 8];
+                    setData(defaultValue);
+                    if (!createIfMissing) return [3 /*break*/, 7];
+                    _a.label = 4;
                 case 4:
+                    _a.trys.push([4, 6, , 7]);
+                    return [4 /*yield*/, write(defaultValue)];
+                case 5:
+                    _a.sent();
+                    return [3 /*break*/, 7];
+                case 6:
+                    writeErr_1 = _a.sent();
+                    // write() already updates writeError state
+                    console.error('Failed to create missing file in OneDrive:', writeErr_1);
+                    return [3 /*break*/, 7];
+                case 7: return [3 /*break*/, 9];
+                case 8:
+                    setData(undefined);
+                    _a.label = 9;
+                case 9:
+                    setError(undefined);
+                    console.info('OneDrive file not found. isNotFound=true');
+                    return [2 /*return*/];
+                case 10:
+                    error_2 = err_2 instanceof Error ? err_2 : new Error(String(err_2));
+                    setError(error_2);
+                    // Don't throw - allow component to handle error via state
+                    console.error('Failed to load file from OneDrive:', error_2);
+                    _a.label = 11;
+                case 11: return [3 /*break*/, 13];
+                case 12:
                     if (isMounted.current) {
-                        setIsWriting(false);
+                        setIsLoading(false);
                     }
                     return [7 /*endfinally*/];
-                case 5: return [2 /*return*/];
+                case 13: return [2 /*return*/];
             }
         });
-    }); }, [client, fileName, folder, buildApiPath]);
+    }); }, [client, fileName, folder, buildApiPath, defaultValue, createIfMissing, isNotFoundError, write]);
     // Auto-fetch on mount if enabled
     useEffect(function () {
-        if (autoFetch && client && fileName) {
+        if (shouldAutoFetch && client && fileName) {
             load().catch(function () {
                 // Error already handled in load() function
             });
         }
-    }, [autoFetch, client, fileName, load]);
+    }, [shouldAutoFetch, client, fileName, load]);
     // Computed state: ready when data loaded successfully
     var isReady = !isLoading && !error && data !== undefined;
     return {
@@ -387,6 +251,7 @@ export function useSPFxOneDriveAppData(fileName, folder, autoFetch) {
         error: error,
         isWriting: isWriting,
         writeError: writeError,
+        isNotFound: isNotFound,
         load: load,
         write: write,
         isReady: isReady,

package/lib/hooks/useSPFxOneDriveAppData.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSPFxOneDriveAppData.js","sourceRoot":"","sources":["../../src/hooks/useSPFxOneDriveAppData.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useSPFxOneDriveAppData.js","sourceRoot":"","sources":["../../src/hooks/useSPFxOneDriveAppData.ts"],"names":[],"mappings":"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"}

package/lib/hooks/useSPFxPageContext.d.ts

@@ -1,4 +1,4 @@
-import type { PageContext } from '@microsoft/sp-page-context';
+import { PageContext } from '@microsoft/sp-page-context';
 /**
  * Hook to access SharePoint page context
  *
@@ -13,8 +13,8 @@ import type { PageContext } from '@microsoft/sp-page-context';
  * @returns SharePoint page context object
  *
  * @remarks
- * This hook extracts and returns the `pageContext` property from the SPFx context.
- * If you need access to the full SPFx context object, use `useSPFxContext` instead.
+ * This hook consumes PageContext from SPFx ServiceScope using dependency injection.
+ * The service is consumed lazily (only when this hook is used) and cached for performance.
  *
  * @example
  * ```tsx

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

@@ -1 +1 @@
-{"version":3,"file":"useSPFxPageContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxPageContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAehD"}
+{"version":3,"file":"useSPFxPageContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxPageContext.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAQhD"}

package/lib/hooks/useSPFxPageContext.js

@@ -1,6 +1,8 @@
 // useSPFxPageContext.ts
 // Hook to access SharePoint page context
-import { useSPFxContext } from './useSPFxContext';
+import { useMemo } from 'react';
+import { PageContext } from '@microsoft/sp-page-context';
+import { useSPFxServiceScope } from './useSPFxServiceScope';
 /**
  * Hook to access SharePoint page context
  *
@@ -15,8 +17,8 @@ import { useSPFxContext } from './useSPFxContext';
  * @returns SharePoint page context object
  *
  * @remarks
- * This hook extracts and returns the `pageContext` property from the SPFx context.
- * If you need access to the full SPFx context object, use `useSPFxContext` instead.
+ * This hook consumes PageContext from SPFx ServiceScope using dependency injection.
+ * The service is consumed lazily (only when this hook is used) and cached for performance.
  *
  * @example
  * ```tsx
@@ -36,14 +38,11 @@ import { useSPFxContext } from './useSPFxContext';
  * @see {@link useSPFxContext} for accessing the full SPFx context
  */
 export function useSPFxPageContext() {
-    var spfxContext = useSPFxContext().spfxContext;
-    // Extract pageContext from SPFx context
-    // All SPFx contexts have pageContext property
-    var ctx = spfxContext;
-    if (!ctx.pageContext) {
-        throw new Error('SPFx context does not contain pageContext. ' +
-            'This should never happen with valid SPFx contexts.');
-    }
-    return ctx.pageContext;
+    var consume = useSPFxServiceScope().consume;
+    // Lazy consume PageContext from ServiceScope (cached by useMemo)
+    // ServiceScope is guaranteed to be finished by SPFxProvider guard
+    return useMemo(function () {
+        return consume(PageContext.serviceKey);
+    }, [consume]);
 }
 //# sourceMappingURL=useSPFxPageContext.js.map

package/lib/hooks/useSPFxPageContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSPFxPageContext.js","sourceRoot":"","sources":["../../src/hooks/useSPFxPageContext.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,yCAAyC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,kBAAkB;IACxB,IAAA,WAAW,GAAK,cAAc,EAAE,YAArB,CAAsB;IAEzC,wCAAwC;IACxC,8CAA8C;IAC9C,IAAM,GAAG,GAAG,WAA4C,CAAC;IAEzD,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,6CAA6C;YAC7C,oDAAoD,CACrD,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC,WAAW,CAAC;AACzB,CAAC"}
+{"version":3,"file":"useSPFxPageContext.js","sourceRoot":"","sources":["../../src/hooks/useSPFxPageContext.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,yCAAyC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,kBAAkB;IACxB,IAAA,OAAO,GAAK,mBAAmB,EAAE,QAA1B,CAA2B;IAE1C,iEAAiE;IACjE,kEAAkE;IAClE,OAAO,OAAO,CAAC;QACb,OAAO,OAAO,CAAc,WAAW,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAChB,CAAC"}

package/lib/hooks/useSPFxSPHttpClient.d.ts

@@ -1,4 +1,4 @@
-import type { SPHttpClient } from '@microsoft/sp-http';
+import { SPHttpClient } from '@microsoft/sp-http';
 /**
  * Return type for useSPFxSPHttpClient hook
  */
@@ -6,8 +6,9 @@ export interface SPFxSPHttpClientInfo {
     /**
      * Native SPHttpClient from SPFx.
      * Provides access to SharePoint REST APIs with built-in authentication.
+     * Always available (non-undefined) after Provider initialization.
      */
-    readonly client: SPHttpClient | undefined;
+    readonly client: SPHttpClient;
     /**
      * Invoke SharePoint REST API call with automatic state management.
      * Tracks loading state and captures errors automatically.
@@ -54,13 +55,18 @@ export interface SPFxSPHttpClientInfo {
  *
  * For type safety, import SPFx types:
  * ```typescript
- * import type { SPHttpClient } from '@microsoft/sp-http';
+ * import { SPHttpClient } from '@microsoft/sp-http';
  * ```
  *
  * Requirements:
- * - SPHttpClient available in SPFx context
+ * - SPFx ServiceScope with SPHttpClient service
  * - Appropriate SharePoint permissions for target APIs
  *
+ * @remarks
+ * This hook consumes SPHttpClient 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.
+ *
  * @param initialBaseUrl - Base URL for SharePoint site (optional, defaults to current site)
  *
  * @example Using invoke with state management
@@ -94,14 +100,14 @@ export interface SPFxSPHttpClientInfo {
  *
  * @example Using client directly for advanced control
  * ```tsx
- * import type { SPHttpClient } from '@microsoft/sp-http';
+ * import { SPHttpClient } from '@microsoft/sp-http';
  *
  * function ListItems() {
  *   const { client, baseUrl } = useSPFxSPHttpClient();
  *   const [items, setItems] = useState([]);
  *   const [loading, setLoading] = useState(false);
  *
- *   if (!client) return <Spinner label="Initializing HTTP client..." />;
+ *   // client is always available after Provider initialization
  *
  *   const loadItems = async () => {
  *     setLoading(true);

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

@@ -1 +1 @@
-{"version":3,"file":"useSPFxSPHttpClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxSPHttpClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IAE1C;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7E;;;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,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3C,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0KG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAiFjF"}
+{"version":3,"file":"useSPFxSPHttpClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxSPHttpClient.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7E;;;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,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3C,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+KG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAqEjF"}