@apvee/spfx-react-toolkit 1.0.0

package/lib/core/provider-listview-commandset.js

@@ -0,0 +1,48 @@
+// provider-listview-commandset.tsx
+// Type-safe provider for ListView Command Sets
+import * as React from 'react';
+import { SPFxProviderBase } from './provider-base.internal';
+/**
+ * SPFx context provider specifically for ListView Command Sets.
+ *
+ * This is a type-safe wrapper around the base provider that accepts a ListView Command Set instance
+ * directly without requiring type casting. Use this provider in ListView Command Sets instead of the
+ * generic `SPFxProvider`.
+ *
+ * @param props - The component props.
+ * @returns The provider component.
+ *
+ * @example
+ * ```tsx
+ * import { SPFxListViewCommandSetProvider } from 'spfx-react-toolkit';
+ * import { Dialog } from '@microsoft/sp-dialog';
+ *
+ * export default class MyCommandSet extends BaseListViewCommandSet<IMyProps> {
+ *   public onExecute(event: IListViewCommandSetExecuteEventParameters): void {
+ *     switch (event.itemId) {
+ *       case 'COMMAND_1':
+ *         // Create a dialog container
+ *         const dialog = Dialog.alert({
+ *           title: 'Custom Dialog',
+ *           message: this._renderDialog()
+ *         });
+ *         break;
+ *     }
+ *   }
+ *
+ *   private _renderDialog(): React.ReactElement {
+ *     return React.createElement(
+ *       SPFxListViewCommandSetProvider,
+ *       { instance: this },
+ *       React.createElement(MyComponent)
+ *     );
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export function SPFxListViewCommandSetProvider(props) {
+    return React.createElement(SPFxProviderBase, { instance: props.instance }, props.children);
+}
+//# sourceMappingURL=provider-listview-commandset.js.map

package/lib/core/provider-listview-commandset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-listview-commandset.js","sourceRoot":"","sources":["../../src/core/provider-listview-commandset.tsx"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,+CAA+C;AAE/C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAoB5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAkD;IAElD,OAAO,oBAAC,gBAAgB,IAAC,QAAQ,EAAE,KAAK,CAAC,QAAiB,IAAG,KAAK,CAAC,QAAQ,CAAoB,CAAC;AAClG,CAAC"}

package/lib/core/provider-webpart.d.ts

@@ -0,0 +1,48 @@
+import * as React from 'react';
+import type { BaseClientSideWebPart } from '@microsoft/sp-webpart-base';
+/**
+ * Props for the SPFx WebPart-specific provider component.
+ *
+ * @template TProps - The properties type for the WebPart.
+ * @public
+ */
+export interface SPFxWebPartProviderProps<TProps extends {} = {}> {
+    /**
+     * The SPFx WebPart instance.
+     */
+    instance: BaseClientSideWebPart<TProps>;
+    /**
+     * The children to render within the provider.
+     */
+    children?: React.ReactNode;
+}
+/**
+ * SPFx context provider specifically for WebParts.
+ *
+ * This is a type-safe wrapper around the base provider that accepts a WebPart instance
+ * directly without requiring type casting. Use this provider in WebParts instead of the
+ * generic `SPFxProvider`.
+ *
+ * @param props - The component props.
+ * @returns The provider component.
+ *
+ * @example
+ * ```tsx
+ * import { SPFxWebPartProvider } from 'spfx-react-toolkit';
+ *
+ * export default class MyWebPart extends BaseClientSideWebPart<IMyWebPartProps> {
+ *   public render(): void {
+ *     const element = React.createElement(
+ *       SPFxWebPartProvider,
+ *       { instance: this },
+ *       React.createElement(MyComponent)
+ *     );
+ *     ReactDom.render(element, this.domElement);
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function SPFxWebPartProvider<TProps extends {} = {}>(props: SPFxWebPartProviderProps<TProps>): JSX.Element;
+//# sourceMappingURL=provider-webpart.d.ts.map

package/lib/core/provider-webpart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-webpart.d.ts","sourceRoot":"","sources":["../../src/core/provider-webpart.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE;IAC9D;;OAEG;IACH,QAAQ,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACxD,KAAK,EAAE,wBAAwB,CAAC,MAAM,CAAC,GACtC,GAAG,CAAC,OAAO,CAEb"}

package/lib/core/provider-webpart.js

@@ -0,0 +1,36 @@
+// provider-webpart.tsx
+// Type-safe provider for WebParts
+import * as React from 'react';
+import { SPFxProviderBase } from './provider-base.internal';
+/**
+ * SPFx context provider specifically for WebParts.
+ *
+ * This is a type-safe wrapper around the base provider that accepts a WebPart instance
+ * directly without requiring type casting. Use this provider in WebParts instead of the
+ * generic `SPFxProvider`.
+ *
+ * @param props - The component props.
+ * @returns The provider component.
+ *
+ * @example
+ * ```tsx
+ * import { SPFxWebPartProvider } from 'spfx-react-toolkit';
+ *
+ * export default class MyWebPart extends BaseClientSideWebPart<IMyWebPartProps> {
+ *   public render(): void {
+ *     const element = React.createElement(
+ *       SPFxWebPartProvider,
+ *       { instance: this },
+ *       React.createElement(MyComponent)
+ *     );
+ *     ReactDom.render(element, this.domElement);
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export function SPFxWebPartProvider(props) {
+    return React.createElement(SPFxProviderBase, { instance: props.instance }, props.children);
+}
+//# sourceMappingURL=provider-webpart.js.map

package/lib/core/provider-webpart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-webpart.js","sourceRoot":"","sources":["../../src/core/provider-webpart.tsx"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,kCAAkC;AAElC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAoB5D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAuC;IAEvC,OAAO,oBAAC,gBAAgB,IAAC,QAAQ,EAAE,KAAK,CAAC,QAAiB,IAAG,KAAK,CAAC,QAAQ,CAAoB,CAAC;AAClG,CAAC"}

package/lib/core/types.d.ts

@@ -0,0 +1,84 @@
+/// <reference types="react" />
+import type { BaseClientSideWebPart } from '@microsoft/sp-webpart-base';
+import type { BaseApplicationCustomizer } from '@microsoft/sp-application-base';
+import type { BaseListViewCommandSet, BaseFieldCustomizer } from '@microsoft/sp-listview-extensibility';
+/**
+ * Type of SPFx host component
+ */
+export type HostKind = 'WebPart' | 'AppCustomizer' | 'FieldCustomizer' | 'CommandSet' | 'ACE';
+/**
+ * Union type for all SPFx component instances
+ * Uses actual SPFx base classes for full type safety and API access
+ */
+export type SPFxComponent<TProps extends {} = {}> = BaseClientSideWebPart<TProps> | BaseApplicationCustomizer<TProps> | BaseListViewCommandSet<TProps> | BaseFieldCustomizer<TProps>;
+/**
+ * Union type for all SPFx context types
+ * Provides type-safe access to common context properties across all SPFx components
+ *
+ * @remarks
+ * All SPFx contexts include these common properties:
+ * - `pageContext` - SharePoint page context
+ * - `serviceScope` - Service locator for SPFx services
+ * - `instanceId` - Unique identifier for the component instance
+ *
+ * For component-specific properties, use type narrowing or casting:
+ * ```typescript
+ * const ctx = useSPFxContext();
+ * if (ctx.kind === 'WebPart') {
+ *   const wpContext = ctx.spfxContext as WebPartContext;
+ *   // Access WebPart-specific properties
+ * }
+ * ```
+ */
+export type SPFxContextType = BaseClientSideWebPart<any>['context'] | BaseApplicationCustomizer<any>['context'] | BaseListViewCommandSet<any>['context'] | BaseFieldCustomizer<any>['context'];
+/**
+ * Container size information
+ */
+export interface ContainerSize {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Props accepted by SPFxProvider (instance-based API)
+ *
+ * @example
+ * ```tsx
+ * // In your WebPart render():
+ * public render(): void {
+ *   const element = React.createElement(
+ *     SPFxProvider,
+ *     { instance: this },
+ *     React.createElement(MyComponent)
+ *   );
+ *   ReactDom.render(element, this.domElement);
+ * }
+ * ```
+ */
+export interface SPFxProviderProps<TProps extends {} = {}> {
+    /** SPFx component instance (WebPart, ApplicationCustomizer, etc.) */
+    readonly instance: SPFxComponent<TProps>;
+    /** Children to render */
+    readonly children?: React.ReactNode;
+}
+/**
+ * Context value provided by SPFxProvider
+ * Contains only static metadata, no reactive state
+ *
+ * @remarks
+ * The `spfxContext` property provides type-safe access to common SPFx context properties
+ * like `pageContext`, `serviceScope`, and `instanceId`. For component-specific properties,
+ * use type narrowing with the `kind` property.
+ */
+export interface SPFxContextValue {
+    /** Unique identifier for this SPFx instance */
+    readonly instanceId: string;
+    /**
+     * SPFx context object with full type safety
+     * Provides access to common properties: pageContext, serviceScope, instanceId
+     * For component-specific properties, use type narrowing based on `kind`
+     */
+    readonly spfxContext: SPFxContextType;
+    /** Type of host component */
+    readonly kind: HostKind;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAExG;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,eAAe,GACf,iBAAiB,GACjB,YAAY,GACZ,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,IAC5C,qBAAqB,CAAC,MAAM,CAAC,GAC7B,yBAAyB,CAAC,MAAM,CAAC,GACjC,sBAAsB,CAAC,MAAM,CAAC,GAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,eAAe,GAEvB,qBAAqB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAErC,yBAAyB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAEzC,sBAAsB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAEtC,mBAAmB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE;IACvD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAEzC,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB"}

package/lib/core/types.js

@@ -0,0 +1,4 @@
+// types.ts
+// Core type definitions for SPFx React Toolkit
+export {};
+//# sourceMappingURL=types.js.map

package/lib/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,+CAA+C"}

package/lib/hooks/index.d.ts

@@ -0,0 +1,34 @@
+export * from './useSPFxAadHttpClient';
+export * from './useSPFxContainerInfo';
+export * from './useSPFxContainerSize';
+export * from './useSPFxCorrelationInfo';
+export * from './useSPFxCrossSitePermissions';
+export * from './useSPFxDisplayMode';
+export * from './useSPFxEnvironmentInfo';
+export * from './useSPFxFluent9ThemeInfo';
+export * from './useSPFxHubSiteInfo';
+export * from './useSPFxInstanceInfo';
+export * from './useSPFxListInfo';
+export * from './useSPFxLocaleInfo';
+export * from './useSPFxLogger';
+export * from './useSPFxMSGraphClient';
+export * from './useSPFxOneDriveAppData';
+export * from './useSPFxPageContext';
+export * from './useSPFxPageType';
+export * from './useSPFxPerformance';
+export * from './useSPFxPermissions';
+export * from './useSPFxPnP';
+export * from './useSPFxPnPContext';
+export * from './useSPFxPnPList';
+export * from './useSPFxPnPSearch';
+export * from './useSPFxProperties';
+export * from './useSPFxSPHttpClient';
+export * from './useSPFxServiceScope';
+export * from './useSPFxSiteInfo';
+export * from './useSPFxStorage';
+export * from './useSPFxTeams';
+export * from './useSPFxTenantProperty';
+export * from './useSPFxThemeInfo';
+export * from './useSPFxUserInfo';
+export * from './useSPFxUserPhoto';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/lib/hooks/index.js

@@ -0,0 +1,34 @@
+export * from './useSPFxAadHttpClient';
+export * from './useSPFxContainerInfo';
+export * from './useSPFxContainerSize';
+export * from './useSPFxCorrelationInfo';
+export * from './useSPFxCrossSitePermissions';
+export * from './useSPFxDisplayMode';
+export * from './useSPFxEnvironmentInfo';
+export * from './useSPFxFluent9ThemeInfo';
+export * from './useSPFxHubSiteInfo';
+export * from './useSPFxInstanceInfo';
+export * from './useSPFxListInfo';
+export * from './useSPFxLocaleInfo';
+export * from './useSPFxLogger';
+export * from './useSPFxMSGraphClient';
+export * from './useSPFxOneDriveAppData';
+export * from './useSPFxPageContext';
+export * from './useSPFxPageType';
+export * from './useSPFxPerformance';
+export * from './useSPFxPermissions';
+export * from './useSPFxPnP';
+export * from './useSPFxPnPContext';
+export * from './useSPFxPnPList';
+export * from './useSPFxPnPSearch';
+export * from './useSPFxProperties';
+export * from './useSPFxSPHttpClient';
+export * from './useSPFxServiceScope';
+export * from './useSPFxSiteInfo';
+export * from './useSPFxStorage';
+export * from './useSPFxTeams';
+export * from './useSPFxTenantProperty';
+export * from './useSPFxThemeInfo';
+export * from './useSPFxUserInfo';
+export * from './useSPFxUserPhoto';
+//# sourceMappingURL=index.js.map

package/lib/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/lib/hooks/useSPFxAadHttpClient.d.ts

@@ -0,0 +1,231 @@
+import type { AadHttpClient } from '@microsoft/sp-http';
+/**
+ * Return type for useSPFxAadHttpClient hook
+ */
+export interface SPFxAadHttpClientInfo {
+    /**
+     * Native AadHttpClient from SPFx.
+     * Provides access to Azure AD-secured APIs with built-in authentication.
+     * Undefined until resourceUrl is set and client initialization completes.
+     */
+    readonly client: AadHttpClient | undefined;
+    /**
+     * Invoke Azure AD API call with automatic state management.
+     * Tracks loading state and captures errors automatically.
+     *
+     * @param fn - Function that receives AadHttpClient and returns a promise
+     * @returns Promise with the result
+     *
+     * @example
+     * ```tsx
+     * const { invoke, resourceUrl } = useSPFxAadHttpClient('https://api.contoso.com');
+     *
+     * const data = await invoke(client =>
+     *   client.get(`${resourceUrl}/api/orders`, AadHttpClient.configurations.v1)
+     *     .then(res => res.json())
+     * );
+     * ```
+     */
+    readonly invoke: <T>(fn: (client: AadHttpClient) => Promise<T>) => Promise<T>;
+    /**
+     * Loading state - true during invoke() calls.
+     * Does not track direct client usage.
+     */
+    readonly isLoading: boolean;
+    /**
+     * Last error from invoke() calls.
+     * Does not capture errors from direct client usage.
+     */
+    readonly error: Error | undefined;
+    /** Clear the current error */
+    readonly clearError: () => void;
+    /** Set or change the resource URL (triggers client re-initialization) */
+    readonly setResourceUrl: (url: string) => void;
+    /** Current Azure AD resource URL or App ID */
+    readonly resourceUrl: string | undefined;
+}
+/**
+ * Hook to access Azure AD-secured APIs with built-in state management
+ *
+ * Provides native AadHttpClient for authenticated Azure AD-secured API access.
+ * 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 type { AadHttpClient } from '@microsoft/sp-http';
+ * ```
+ *
+ * Requirements:
+ * - Add permissions to package-solution.json webApiPermissionRequests
+ * - Admin must grant permissions in SharePoint Admin Center
+ * - AadHttpClientFactory available in SPFx context
+ *
+ * @param initialResourceUrl - Azure AD resource URL or App ID (optional, can be set later)
+ *
+ * @example Using invoke with state management
+ * ```tsx
+ * function OrdersList() {
+ *   const { invoke, isLoading, error, clearError, resourceUrl } = useSPFxAadHttpClient(
+ *     'https://api.contoso.com'
+ *   );
+ *   const [orders, setOrders] = useState<Order[]>([]);
+ *
+ *   const loadOrders = () => {
+ *     invoke(client =>
+ *       client.get(
+ *         `${resourceUrl}/api/orders`,
+ *         AadHttpClient.configurations.v1
+ *       ).then(res => res.json())
+ *     ).then(data => setOrders(data));
+ *   };
+ *
+ *   useEffect(() => { loadOrders(); }, []);
+ *
+ *   if (isLoading) return <Spinner />;
+ *   if (error) return (
+ *     <MessageBar messageBarType={MessageBarType.error}>
+ *       {error.message}
+ *       <Link onClick={() => { clearError(); loadOrders(); }}>Retry</Link>
+ *     </MessageBar>
+ *   );
+ *
+ *   return <ul>{orders.map(o => <li key={o.id}>{o.total}</li>)}</ul>;
+ * }
+ * ```
+ *
+ * @example Using client directly for advanced control
+ * ```tsx
+ * import type { AadHttpClient } from '@microsoft/sp-http';
+ *
+ * function ProductsManager() {
+ *   const { client, resourceUrl } = useSPFxAadHttpClient('https://api.contoso.com');
+ *   const [products, setProducts] = useState([]);
+ *   const [loading, setLoading] = useState(false);
+ *
+ *   if (!client) return <Spinner label="Initializing AAD client..." />;
+ *
+ *   const loadProducts = async () => {
+ *     setLoading(true);
+ *     try {
+ *       const response = await client.get(
+ *         `${resourceUrl}/api/products`,
+ *         AadHttpClient.configurations.v1
+ *       );
+ *       const data = await response.json();
+ *       setProducts(data);
+ *     } catch (err) {
+ *       console.error(err);
+ *     } finally {
+ *       setLoading(false);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <>
+ *       <button onClick={loadProducts} disabled={loading}>Load</button>
+ *       {loading && <Spinner />}
+ *       <DetailsList items={products} />
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @example CRUD operations with invoke
+ * ```tsx
+ * function ItemsManager() {
+ *   const { invoke, isLoading, error, resourceUrl } = useSPFxAadHttpClient(
+ *     'https://api.contoso.com'
+ *   );
+ *   const [items, setItems] = useState([]);
+ *
+ *   const loadItems = () => {
+ *     invoke(client =>
+ *       client.get(
+ *         `${resourceUrl}/api/items`,
+ *         AadHttpClient.configurations.v1
+ *       ).then(res => res.json())
+ *     ).then(data => setItems(data));
+ *   };
+ *
+ *   const createItem = (item: any) => {
+ *     invoke(client =>
+ *       client.post(
+ *         `${resourceUrl}/api/items`,
+ *         AadHttpClient.configurations.v1,
+ *         { body: JSON.stringify(item) }
+ *       ).then(res => res.json())
+ *     ).then(loadItems);
+ *   };
+ *
+ *   const updateItem = (id: string, changes: any) => {
+ *     invoke(client =>
+ *       client.post(
+ *         `${resourceUrl}/api/items/${id}`,
+ *         AadHttpClient.configurations.v1,
+ *         {
+ *           headers: { 'X-HTTP-Method': 'PATCH' },
+ *           body: JSON.stringify(changes)
+ *         }
+ *       )
+ *     ).then(loadItems);
+ *   };
+ *
+ *   const deleteItem = (id: string) => {
+ *     invoke(client =>
+ *       client.post(
+ *         `${resourceUrl}/api/items/${id}`,
+ *         AadHttpClient.configurations.v1,
+ *         { headers: { 'X-HTTP-Method': 'DELETE' } }
+ *       )
+ *     ).then(loadItems);
+ *   };
+ *
+ *   return (
+ *     <ItemsUI
+ *       items={items}
+ *       loading={isLoading}
+ *       error={error}
+ *       onCreate={createItem}
+ *       onUpdate={updateItem}
+ *       onDelete={deleteItem}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example Lazy initialization with setResourceUrl
+ * ```tsx
+ * function DynamicApi() {
+ *   const { invoke, setResourceUrl, resourceUrl, clearError } = useSPFxAadHttpClient();
+ *   const [data, setData] = useState(null);
+ *
+ *   const loadFromApi = async (apiUrl: string) => {
+ *     clearError();
+ *     setResourceUrl(apiUrl);
+ *
+ *     // Wait for client initialization, then fetch
+ *     setTimeout(() => {
+ *       invoke(client =>
+ *         client.get(
+ *           `${apiUrl}/api/data`,
+ *           AadHttpClient.configurations.v1
+ *         ).then(res => res.json())
+ *       ).then(setData);
+ *     }, 100);
+ *   };
+ *
+ *   return (
+ *     <>
+ *       <button onClick={() => loadFromApi('https://api1.contoso.com')}>API 1</button>
+ *       <button onClick={() => loadFromApi('https://api2.contoso.com')}>API 2</button>
+ *       {data && <pre>{JSON.stringify(data, null, 2)}</pre>}
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export declare function useSPFxAadHttpClient(initialResourceUrl?: string): SPFxAadHttpClientInfo;
+//# sourceMappingURL=useSPFxAadHttpClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSPFxAadHttpClient.d.ts","sourceRoot":"","sources":["../../src/hooks/useSPFxAadHttpClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsLG;AACH,wBAAgB,oBAAoB,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAiFvF"}