npm - @spteck/react-controls-v2 - Versions diffs - 2.0.0 - Mend

@spteck/react-controls-v2 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (592) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2025 João Mendes
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,420 @@
+# @spteck/react-controls-v2 v2
+> Framework-agnostic React UI controls library based on Fluent UI 9 - Works seamlessly with Vite, Next.js, and SPFx!
+## 🎯 What's New in V2?
+**V2 is a complete rewrite** that eliminates all SPFx-specific dependencies, making these controls truly universal:
+- ✅ **Zero SPFx dependencies** in the core library
+- ✅ **Works in any React app**: Vite, Next.js, Create React App, SPFx
+- ✅ **Abstraction layer** for flexibility and testability
+- ✅ **Tree-shakeable** - only import what you need
+- ✅ **Full TypeScript support** with comprehensive types
+- ✅ **Modern build system** using Vite
+## 📦 Installation
+### For Vite/Next.js/Standard React Apps
+```bash
+npm install @spteck/react-controls-v2
+```
+### For SPFx Applications
+```bash
+npm install @spteck/react-controls-v2 @spteck/react-controls-v2-spfx-adapter
+```
+## 🚀 Quick Start
+### 1. Vite/React Application
+```typescript
+import React from 'react';
+import {
+  UniversalProvider,
+  UserCard,
+  DefaultGraphClient,
+  ConsoleLoggingProvider,
+  LocalStorageProvider
+} from '@spteck/react-controls-v2';
+function App() {
+  const context = {
+    graphClient: new DefaultGraphClient({
+      accessToken: 'YOUR_ACCESS_TOKEN'
+    }),
+    loggingProvider: new ConsoleLoggingProvider('MyApp'),
+    storageProvider: new LocalStorageProvider(),
+    pageContext: {
+      user: {
+        displayName: 'John Doe',
+        email: 'john@contoso.com',
+        loginName: 'john@contoso.com'
+      }
+    }
+  };
+  return (
+    <UniversalProvider context={context}>
+      <div className="App">
+        <h1>My Application</h1>
+        <UserCard userId="user-id-123" />
+      </div>
+    </UniversalProvider>
+  );
+}
+export default App;
+```
+### 2. Next.js Application
+```typescript
+// app/layout.tsx or pages/_app.tsx
+import {
+  UniversalProvider,
+  DefaultGraphClient,
+  IApplicationContext
+} from '@spteck/react-controls-v2';
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  // You can fetch the access token from your auth provider (NextAuth, etc.)
+  const context: IApplicationContext = {
+    graphClient: new DefaultGraphClient({
+      getAccessToken: async (scopes) => {
+        // Your logic to get token
+        return await getAccessToken(scopes);
+      }
+    }),
+    pageContext: {
+      user: {
+        displayName: 'Current User',
+        email: 'user@contoso.com',
+        loginName: 'user@contoso.com'
+      }
+    }
+  };
+  return (
+    <html lang="en">
+      <body>
+        <UniversalProvider context={context}>
+          {children}
+        </UniversalProvider>
+      </body>
+    </html>
+  );
+}
+```
+### 3. SPFx Application
+```typescript
+import * as React from 'react';
+import * as ReactDom from 'react-dom';
+import { BaseClientSideWebPart } from '@microsoft/sp-webpart-base';
+import { UniversalProvider } from '@spteck/react-controls-v2';
+import { SPFxContextAdapter } from '@spteck/react-controls-v2-spfx-adapter';
+import { UserCard } from '@spteck/react-controls-v2';
+export default class MyWebPart extends BaseClientSideWebPart {
+  public render(): void {
+    // Convert SPFx context to Universal context
+    const universalContext = SPFxContextAdapter.adapt(
+      this.context,
+      'MyWebPart'
+    );
+    const element = (
+      <UniversalProvider context={universalContext}>
+        <div>
+          <h2>Hello from SPFx!</h2>
+          <UserCard userId="user-123" />
+        </div>
+      </UniversalProvider>
+    );
+    ReactDom.render(element, this.domElement);
+  }
+}
+```
+## 🏗️ Architecture
+### Abstraction Layer
+The library uses an abstraction layer that allows it to work across different platforms:
+```typescript
+interface IApplicationContext {
+  pageContext?: IPageContext;
+  graphClient?: IGraphProvider;
+  authProvider?: IAuthenticationProvider;
+  loggingProvider?: ILoggingProvider;
+  storageProvider?: IStorageProvider;
+}
+```
+### Providers
+#### Default Providers (For Vite/Next.js)
+```typescript
+import {
+  DefaultGraphClient,
+  ConsoleLoggingProvider,
+  LocalStorageProvider
+} from '@spteck/react-controls-v2/providers';
+const graphClient = new DefaultGraphClient({
+  accessToken: 'token',
+  // OR
+  getAccessToken: async (scopes) => await fetchToken(scopes)
+});
+const logger = new ConsoleLoggingProvider('MyApp');
+const storage = new LocalStorageProvider('myapp_');
+```
+#### SPFx Providers (via Adapter)
+```typescript
+import { SPFxContextAdapter } from '@spteck/react-controls-v2-spfx-adapter';
+const context = SPFxContextAdapter.adapt(this.context, 'ComponentName');
+// This automatically provides SPFx-native implementations of all providers
+```
+## 📚 Available Components
+### Layout Components
+- `Card` - Flexible card container
+- `Grid` - Responsive grid system
+- `Layout` - Page layout wrapper
+- `Space` - Spacing component
+- `Stack` - Vertical/horizontal stack
+- `AspectRatio` - Maintain aspect ratios
+- `Center` - Center content
+- `Container` - Content container
+- `Carousel` - Image/content carousel
+- `Popup` - Popup dialogs
+### UI Components
+- `TypographyControl` - Text styling
+- `ButtonMenu` - Button with dropdown menu
+- `RenderLabel` - Label rendering
+- `RenderSpinner` - Loading spinners
+### Data Components
+*(More components coming in future releases)*
+## 🎣 Available Hooks
+### useApplicationContext
+Access the application context anywhere in your component tree:
+```typescript
+import { useApplicationContext } from '@spteck/react-controls-v2';
+function MyComponent() {
+  const context = useApplicationContext();
+  const user = context?.pageContext?.user;
+  return <div>Welcome, {user?.displayName}!</div>;
+}
+```
+### useGraphAPI
+Make Microsoft Graph API calls:
+```typescript
+import { useGraphAPI } from '@spteck/react-controls-v2';
+function UserProfile() {
+  const { getUser, getCurrentUser } = useGraphAPI();
+  useEffect(() => {
+    async function fetchUser() {
+      const user = await getCurrentUser();
+      console.log(user);
+    }
+    fetchUser();
+  }, []);
+  return <div>...</div>;
+}
+```
+### useLogging
+Logging with different levels:
+```typescript
+import { useLogging, LogLevel, ErrorType } from '@spteck/react-controls-v2';
+function MyComponent() {
+  const { log, error, warn, info } = useLogging();
+  useEffect(() => {
+    info('Component mounted');
+    log('Custom log message', LogLevel.Verbose);
+  }, []);
+  const handleError = (err: Error) => {
+    error('An error occurred', err, ErrorType.Error);
+  };
+  return <div>...</div>;
+}
+```
+### useIndexedDBCache
+Caching with expiration:
+```typescript
+import { useIndexedDBCache } from '@spteck/react-controls-v2';
+function CachedDataComponent() {
+  const { getCachedData, setCachedData } = useIndexedDBCache();
+  useEffect(() => {
+    async function loadData() {
+      const cached = await getCachedData('myKey');
+      if (!cached) {
+        const freshData = await fetchData();
+        await setCachedData('myKey', freshData, 60); // Cache for 60 minutes
+      }
+    }
+    loadData();
+  }, []);
+  return <div>...</div>;
+}
+```
+### usePolling
+Poll data at regular intervals:
+```typescript
+import { usePolling } from '@spteck/react-controls-v2';
+function LiveDataComponent() {
+  const { startPolling, stopPolling, isPolling } = usePolling(
+    async () => {
+      const data = await fetchLiveData();
+      setData(data);
+    },
+    5000, // Poll every 5 seconds
+    true  // Start immediately
+  );
+  return (
+    <div>
+      <button onClick={startPolling}>Start</button>
+      <button onClick={stopPolling}>Stop</button>
+      {isPolling && <span>Polling...</span>}
+    </div>
+  );
+}
+```
+### useTimeZoneHelper
+Handle timezone conversions:
+```typescript
+import { useTimeZoneHelper } from '@spteck/react-controls-v2';
+function DateDisplay() {
+  const { formatInTimeZone, timeZone } = useTimeZoneHelper();
+  const formattedDate = formatInTimeZone(
+    new Date(),
+    'yyyy-MM-dd HH:mm:ss',
+    'America/New_York'
+  );
+  return <div>Current timezone: {timeZone}</div>;
+}
+```
+## 🔧 Utility Functions
+### Lodash Utilities
+```typescript
+import { debounce, throttle, cloneDeep } from '@spteck/react-controls-v2';
+const debouncedSearch = debounce((query) => {
+  performSearch(query);
+}, 300);
+```
+## 🎨 Theming
+All components use Fluent UI 9 theming. You can wrap your app with Fluent UI providers:
+```typescript
+import { FluentProvider, webLightTheme } from '@fluentui/react-components';
+import { UniversalProvider } from '@spteck/react-controls-v2';
+function App() {
+  return (
+    <FluentProvider theme={webLightTheme}>
+      <UniversalProvider context={myContext}>
+        <YourApp />
+      </UniversalProvider>
+    </FluentProvider>
+  );
+}
+```
+## 📖 Migration from V1
+If you're migrating from V1 (the SPFx-dependent version):
+1. **For SPFx apps**: Install the adapter package and use `SPFxContextAdapter.adapt()`
+2. **For non-SPFx apps**: Replace context with `IApplicationContext`
+3. **Update imports**: Change from `@spteck/m365-hooks` to internal hooks
+4. **Provider setup**: Wrap your app with `UniversalProvider`
+Example migration:
+```typescript
+// V1 (SPFx only)
+import { UserCard } from '@spteck/react-controls';
+<UserCard context={this.context} userId="123" />
+// V2 (SPFx)
+import { UniversalProvider, UserCard } from '@spteck/react-controls-v2';
+import { SPFxContextAdapter } from '@spteck/react-controls-v2-spfx-adapter';
+const universalContext = SPFxContextAdapter.adapt(this.context);
+<UniversalProvider context={universalContext}>
+  <UserCard userId="123" />
+</UniversalProvider>
+// V2 (Non-SPFx)
+import { UniversalProvider, UserCard } from '@spteck/react-controls-v2';
+<UniversalProvider context={myCustomContext}>
+  <UserCard userId="123" />
+</UniversalProvider>
+```
+## 🤝 Contributing
+Contributions are welcome! Please read our contributing guidelines before submitting PRs.
+## 📄 License
+MIT © João Mendes
+## 🔗 Links
+- [NPM Package](https://www.npmjs.com/package/@spteck/react-controls-v2)
+- [GitHub Repository](https://github.com/joaojmendes/react-controls)
+- [Documentation](https://github.com/joaojmendes/react-controls/tree/main/v2)
+## ⭐ Show your support
+Give a ⭐️ if this project helped you!

package/dist/ILoggingProvider-C4FFlnQ0.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ "use strict";var r=(r=>(r[r.Verbose=0]="Verbose",r[r.Info=1]="Info",r[r.Warning=2]="Warning",r[r.Error=3]="Error",r))(r\|\|{}),o=(r=>(r.Error="Error",r.Warning="Warning",r.Info="Info",r))(o\|\|{});exports.ErrorType=o,exports.LogLevel=r;
2	+ //# sourceMappingURL=ILoggingProvider-C4FFlnQ0.js.map

package/dist/ILoggingProvider-C4FFlnQ0.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ILoggingProvider-C4FFlnQ0.js","sources":["../src/abstractions/ILoggingProvider.ts"],"sourcesContent":["/**\n * Log levels for logging operations\n */\nexport enum LogLevel {\n Verbose = 0,\n Info = 1,\n Warning = 2,\n Error = 3,\n}\n\n/**\n * Error types for categorizing errors\n */\nexport enum ErrorType {\n Error = 'Error',\n Warning = 'Warning',\n Info = 'Info',\n}\n\n/**\n * Logging provider interface\n * Implementations should handle logging to various targets (console, Application Insights, etc.)\n */\nexport interface ILoggingProvider {\n /**\n * Logs a message with the specified level\n * @param message - The message to log\n * @param level - The severity level of the log\n * @param data - Optional additional data to include\n */\n log(message: string, level: LogLevel, data?: any): void;\n\n /**\n * Logs an error\n * @param message - The error message\n * @param error - Optional Error object\n * @param errorType - Optional error type categorization\n */\n error(message: string, error?: Error, errorType?: ErrorType): void;\n\n /**\n * Logs a warning\n * @param message - The warning message\n * @param data - Optional additional data\n */\n warn(message: string, data?: any): void;\n\n /**\n * Logs an informational message\n * @param message - The info message\n * @param data - Optional additional data\n */\n info(message: string, data?: any): void;\n\n /**\n * Logs a verbose/debug message\n * @param message - The debug message\n * @param data - Optional additional data\n */\n verbose(message: string, data?: any): void;\n}\n"],"names":["LogLevel","ErrorType"],"mappings":"aAGO,IAAKA,GAAAA,IACVA,EAAAA,UAAU,GAAV,UACAA,EAAAA,OAAO,GAAP,OACAA,EAAAA,UAAU,GAAV,UACAA,EAAAA,QAAQ,GAAR,QAJUA,IAAAA,GAAA,IAUAC,GAAAA,IACVA,EAAA,MAAQ,QACRA,EAAA,QAAU,UACVA,EAAA,KAAO,OAHGA,IAAAA,GAAA"}

package/dist/ILoggingProvider-CYYYCGLY.mjs ADDED Viewed

@@ -0,0 +1,18 @@
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["Verbose"] = 0] = "Verbose";
+  LogLevel2[LogLevel2["Info"] = 1] = "Info";
+  LogLevel2[LogLevel2["Warning"] = 2] = "Warning";
+  LogLevel2[LogLevel2["Error"] = 3] = "Error";
+  return LogLevel2;
+})(LogLevel || {});
+var ErrorType = /* @__PURE__ */ ((ErrorType2) => {
+  ErrorType2["Error"] = "Error";
+  ErrorType2["Warning"] = "Warning";
+  ErrorType2["Info"] = "Info";
+  return ErrorType2;
+})(ErrorType || {});
+export {
+  ErrorType as E,
+  LogLevel as L
+};
+//# sourceMappingURL=ILoggingProvider-CYYYCGLY.mjs.map

package/dist/ILoggingProvider-CYYYCGLY.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ILoggingProvider-CYYYCGLY.mjs","sources":["../src/abstractions/ILoggingProvider.ts"],"sourcesContent":["/**\n * Log levels for logging operations\n */\nexport enum LogLevel {\n Verbose = 0,\n Info = 1,\n Warning = 2,\n Error = 3,\n}\n\n/**\n * Error types for categorizing errors\n */\nexport enum ErrorType {\n Error = 'Error',\n Warning = 'Warning',\n Info = 'Info',\n}\n\n/**\n * Logging provider interface\n * Implementations should handle logging to various targets (console, Application Insights, etc.)\n */\nexport interface ILoggingProvider {\n /**\n * Logs a message with the specified level\n * @param message - The message to log\n * @param level - The severity level of the log\n * @param data - Optional additional data to include\n */\n log(message: string, level: LogLevel, data?: any): void;\n\n /**\n * Logs an error\n * @param message - The error message\n * @param error - Optional Error object\n * @param errorType - Optional error type categorization\n */\n error(message: string, error?: Error, errorType?: ErrorType): void;\n\n /**\n * Logs a warning\n * @param message - The warning message\n * @param data - Optional additional data\n */\n warn(message: string, data?: any): void;\n\n /**\n * Logs an informational message\n * @param message - The info message\n * @param data - Optional additional data\n */\n info(message: string, data?: any): void;\n\n /**\n * Logs a verbose/debug message\n * @param message - The debug message\n * @param data - Optional additional data\n */\n verbose(message: string, data?: any): void;\n}\n"],"names":["LogLevel","ErrorType"],"mappings":"AAGO,IAAK,6BAAAA,cAAL;AACLA,YAAAA,UAAA,aAAU,CAAA,IAAV;AACAA,YAAAA,UAAA,UAAO,CAAA,IAAP;AACAA,YAAAA,UAAA,aAAU,CAAA,IAAV;AACAA,YAAAA,UAAA,WAAQ,CAAA,IAAR;AAJU,SAAAA;AAAA,GAAA,YAAA,CAAA,CAAA;AAUL,IAAK,8BAAAC,eAAL;AACLA,aAAA,OAAA,IAAQ;AACRA,aAAA,SAAA,IAAU;AACVA,aAAA,MAAA,IAAO;AAHG,SAAAA;AAAA,GAAA,aAAA,CAAA,CAAA;"}

package/dist/abstractions/IApplicationContext.d.ts ADDED Viewed

@@ -0,0 +1,37 @@
+import { IPageContext } from './IPageContext';
+import { IGraphProvider } from './IGraphProvider';
+import { IAuthenticationProvider } from './IAuthenticationProvider';
+import { ILoggingProvider } from './ILoggingProvider';
+import { IStorageProvider } from './IStorageProvider';
+/**
+ * Main application context interface
+ * This provides all the necessary context and providers for the controls
+ */
+export interface IApplicationContext {
+    /**
+     * Page context containing user, site, web, and other contextual information
+     */
+    pageContext?: IPageContext;
+    /**
+     * Microsoft Graph API provider for making Graph requests
+     */
+    graphClient?: IGraphProvider;
+    /**
+     * Authentication provider for managing tokens and user authentication
+     */
+    authProvider?: IAuthenticationProvider;
+    /**
+     * Logging provider for application logging
+     */
+    loggingProvider?: ILoggingProvider;
+    /**
+     * Storage provider for caching and persistence
+     */
+    storageProvider?: IStorageProvider;
+    /**
+     * Custom properties for extensibility
+     */
+    custom?: Record<string, any>;
+}
+//# sourceMappingURL=IApplicationContext.d.ts.map

package/dist/abstractions/IApplicationContext.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"IApplicationContext.d.ts","sourceRoot":"","sources":["../../src/abstractions/IApplicationContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAE7B;;OAEG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAEvC;;OAEG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAEnC;;OAEG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAEnC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B"}

package/dist/abstractions/IAuthenticationProvider.d.ts ADDED Viewed

@@ -0,0 +1,25 @@
+import { IUserInfo } from './IPageContext';
+/**
+ * Authentication provider interface
+ * Implementations should handle authentication flows and token management
+ */
+export interface IAuthenticationProvider {
+    /**
+     * Gets an access token for the specified scopes
+     * @param scopes - Array of permission scopes required
+     * @returns Promise with the access token
+     */
+    getAccessToken(scopes: string[]): Promise<string>;
+    /**
+     * Gets information about the current authenticated user
+     * @returns Promise with user information
+     */
+    getCurrentUser(): Promise<IUserInfo>;
+    /**
+     * Checks if the user is currently authenticated
+     * @returns Promise with boolean indicating authentication status
+     */
+    isAuthenticated(): Promise<boolean>;
+}
+//# sourceMappingURL=IAuthenticationProvider.d.ts.map

package/dist/abstractions/IAuthenticationProvider.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"IAuthenticationProvider.d.ts","sourceRoot":"","sources":["../../src/abstractions/IAuthenticationProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElD;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAErC;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC"}

package/dist/abstractions/IGraphProvider.d.ts ADDED Viewed

@@ -0,0 +1,42 @@
+/**
+ * Microsoft Graph API provider interface
+ * Implementations should handle authentication and HTTP requests to Microsoft Graph
+ */
+export interface IGraphProvider {
+    /**
+     * Performs a GET request to Microsoft Graph
+     * @param endpoint - The Graph API endpoint (e.g., '/me' or '/users/{userId}')
+     * @returns Promise with the response data
+     */
+    get<T>(endpoint: string): Promise<T>;
+    /**
+     * Performs a POST request to Microsoft Graph
+     * @param endpoint - The Graph API endpoint
+     * @param data - The data to send in the request body
+     * @returns Promise with the response data
+     */
+    post<T>(endpoint: string, data: any): Promise<T>;
+    /**
+     * Performs a PATCH request to Microsoft Graph
+     * @param endpoint - The Graph API endpoint
+     * @param data - The data to send in the request body
+     * @returns Promise with the response data
+     */
+    patch<T>(endpoint: string, data: any): Promise<T>;
+    /**
+     * Performs a DELETE request to Microsoft Graph
+     * @param endpoint - The Graph API endpoint
+     * @returns Promise resolved when the deletion is complete
+     */
+    delete(endpoint: string): Promise<void>;
+    /**
+     * Performs a GET request to Microsoft Graph and returns the response with additional metadata
+     * @param endpoint - The Graph API endpoint
+     * @returns Promise with the full response including @odata.nextLink, etc.
+     */
+    getWithMetadata<T>(endpoint: string): Promise<{
+        value: T;
+        '@odata.nextLink'?: string;
+    }>;
+}
+//# sourceMappingURL=IGraphProvider.d.ts.map

package/dist/abstractions/IGraphProvider.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"IGraphProvider.d.ts","sourceRoot":"","sources":["../../src/abstractions/IGraphProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAErC;;;;;OAKG;IACH,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAElD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzF"}

package/dist/abstractions/ILoggingProvider.d.ts ADDED Viewed

@@ -0,0 +1,56 @@
+/**
+ * Log levels for logging operations
+ */
+export declare enum LogLevel {
+    Verbose = 0,
+    Info = 1,
+    Warning = 2,
+    Error = 3
+}
+/**
+ * Error types for categorizing errors
+ */
+export declare enum ErrorType {
+    Error = "Error",
+    Warning = "Warning",
+    Info = "Info"
+}
+/**
+ * Logging provider interface
+ * Implementations should handle logging to various targets (console, Application Insights, etc.)
+ */
+export interface ILoggingProvider {
+    /**
+     * Logs a message with the specified level
+     * @param message - The message to log
+     * @param level - The severity level of the log
+     * @param data - Optional additional data to include
+     */
+    log(message: string, level: LogLevel, data?: any): void;
+    /**
+     * Logs an error
+     * @param message - The error message
+     * @param error - Optional Error object
+     * @param errorType - Optional error type categorization
+     */
+    error(message: string, error?: Error, errorType?: ErrorType): void;
+    /**
+     * Logs a warning
+     * @param message - The warning message
+     * @param data - Optional additional data
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * Logs an informational message
+     * @param message - The info message
+     * @param data - Optional additional data
+     */
+    info(message: string, data?: any): void;
+    /**
+     * Logs a verbose/debug message
+     * @param message - The debug message
+     * @param data - Optional additional data
+     */
+    verbose(message: string, data?: any): void;
+}
+//# sourceMappingURL=ILoggingProvider.d.ts.map

package/dist/abstractions/ILoggingProvider.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ILoggingProvider.d.ts","sourceRoot":"","sources":["../../src/abstractions/ILoggingProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,OAAO,IAAI;IACX,IAAI,IAAI;IACR,OAAO,IAAI;IACX,KAAK,IAAI;CACV;AAED;;GAEG;AACH,oBAAY,SAAS;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAExD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAEnE;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAExC;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAExC;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CAC5C"}