@microsoft/power-apps 1.0.0

package/lib/internal/data/core/runtime/powerDataRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerDataRuntime.d.ts","sourceRoot":"","sources":["../../../../../src/internal/data/core/runtime/powerDataRuntime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAE7B,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAIvF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,4BAA4B,EAAE,6BAA6B,CAAC;IAC5D,sBAAsB,EAAE,uBAAuB,CAAC;IAChD,GAAG,EAAE,WAAW,CAAC;IACjB,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,cAAc,CAAU;IAEhC;;;;OAIG;gBACS,MAAM,EAAE,2BAA2B;IAoB/C;;;OAGG;IACH,IAAW,IAAI,IAAI,eAAe,CAMjC;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,mBAAmB,CAMzC;IAED;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAGlC"}

package/lib/internal/data/core/runtime/powerDataRuntime.js

@@ -0,0 +1,116 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { RuntimeDataOperations } from '../data/runtimeDataOperations';
+import { RuntimeMetadataOperations } from '../metadata/runtimeMetadataOperations';
+import { RuntimeClientProvider } from '../runtimeClient/runtimeClientProvider';
+import { DataverseDataOperation } from '../data/dataverseDataOperation';
+import { ConnectorDataOperation } from '../data/connectorDataOperation';
+import { RuntimeDataSourceService } from '../metadata/runtimeDataSourceService';
+import { Log } from '../telemetry/log';
+import { ErrorCodes, getErrorMessage, PowerDataRuntimeError } from '../error/error';
+/**
+ * PowerDataRuntime provides a unified interface for data and metadata operations
+ * in the Power runtime environment.
+ */
+export class PowerDataRuntime {
+    _clientProvider;
+    _dataSourceService;
+    _xrm;
+    _dataOperations;
+    _metadataOperations;
+    _isInitialized;
+    /**
+     * Creates a new instance of PowerDataRuntime
+     * @param params - Initialization parameters
+     * @throws DataRuntimeError if initialization fails
+     */
+    constructor(params) {
+        try {
+            this._validateInitParams(params);
+            // Initialize the telemetry logger
+            Log.createInstance(params.powerOperationExecutor);
+            this._clientProvider = new RuntimeClientProvider(params.powerOperationExecutor);
+            this._dataSourceService = new RuntimeDataSourceService(params.powerDataSourcesInfoProvider);
+            this._xrm = params.xrm;
+            this._isInitialized = false;
+            this._initialize();
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                Log.trackException(error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Gets the Data operations interface
+     * @throws PowerDataRuntimeError if operations are not initialized
+     */
+    get Data() {
+        this._ensureInitialized();
+        if (!this._dataOperations) {
+            this._dataOperations = this._createDataOperations();
+        }
+        return this._dataOperations;
+    }
+    /**
+     * Gets the Metadata operations interface
+     * @throws PowerDataRuntimeError if operations are not initialized
+     */
+    get Metadata() {
+        this._ensureInitialized();
+        if (!this._metadataOperations) {
+            this._metadataOperations = this._createMetadataOperations();
+        }
+        return this._metadataOperations;
+    }
+    /**
+     * Validates initialization parameters
+     * @param params - Parameters to validate
+     * @throws PowerDataRuntimeError if validation fails
+     */
+    _validateInitParams(params) {
+        if (!params.xrm) {
+            throw new PowerDataRuntimeError(ErrorCodes.InvalidXrmInfo);
+        }
+    }
+    /**
+     * Ensures the PowerDataRuntime is initialized
+     * @throws PowerDataRuntimeError if not initialized
+     */
+    _ensureInitialized() {
+        if (!this._isInitialized) {
+            throw new PowerDataRuntimeError(ErrorCodes.OperationsNotInitialized);
+        }
+    }
+    /**
+     * Initializes the PowerDataRuntime components
+     * @throws PowerDataRuntimeError if initialization fails
+     */
+    _initialize() {
+        try {
+            this._dataOperations = this._createDataOperations();
+            this._metadataOperations = this._createMetadataOperations();
+            this._isInitialized = true;
+        }
+        catch (error) {
+            throw new PowerDataRuntimeError(ErrorCodes.InitializationFailed, getErrorMessage(error));
+        }
+    }
+    /**
+     * Creates a new instance of DataOperations
+     */
+    _createDataOperations() {
+        const dataverseOperation = new DataverseDataOperation(this._xrm, this._dataSourceService, this._clientProvider);
+        const connectorOperation = new ConnectorDataOperation(this._clientProvider, this._dataSourceService);
+        return new RuntimeDataOperations(dataverseOperation, connectorOperation, this._dataSourceService);
+    }
+    /**
+     * Creates a new instance of MetadataOperations
+     */
+    _createMetadataOperations() {
+        return new RuntimeMetadataOperations(this._clientProvider);
+    }
+}
+//# sourceMappingURL=powerDataRuntime.js.map

package/lib/internal/data/core/runtime/powerDataRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerDataRuntime.js","sourceRoot":"","sources":["../../../../../src/internal/data/core/runtime/powerDataRuntime.ts"],"names":[],"mappings":"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"}

package/lib/internal/data/core/runtime/powerDataRuntimeInstance.d.ts

@@ -0,0 +1,20 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { PowerDataRuntime } from './powerDataRuntime';
+import { IPowerDataSourcesInfoProvider, IXrmContext } from '../common/types';
+import { IPowerOperationExecutor } from '../types';
+/**
+ * Gets or creates a singleton instance of PowerDataRuntime
+ * @param powerDataSourcesInfoProvider - Data sources info provider to initialize the PowerDataRuntime
+ * @param powerOperationExecutor - Optional power operation executor to initialize the PowerDataRuntime
+ * @param xrm - Optional xrm object to initialize the PowerDataRuntime
+ * @returns PowerDataRuntime instance
+ */
+export declare function getPowerDataRuntime(powerDataSourcesInfoProvider: IPowerDataSourcesInfoProvider, powerOperationExecutor: IPowerOperationExecutor, xrm?: IXrmContext): PowerDataRuntime;
+/**
+ * Resets the PowerDataRuntime singleton instance.
+ * Useful for testing or reinitialization.
+ */
+export declare function resetPowerDataRuntimeInstance(): void;
+//# sourceMappingURL=powerDataRuntimeInstance.d.ts.map

package/lib/internal/data/core/runtime/powerDataRuntimeInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerDataRuntimeInstance.d.ts","sourceRoot":"","sources":["../../../../../src/internal/data/core/runtime/powerDataRuntimeInstance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAQnD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,4BAA4B,EAAE,6BAA6B,EAC3D,sBAAsB,EAAE,uBAAuB,EAC/C,GAAG,CAAC,EAAE,WAAW,GAChB,gBAAgB,CASlB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAIpD"}

package/lib/internal/data/core/runtime/powerDataRuntimeInstance.js

@@ -0,0 +1,36 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { PowerDataRuntime } from './powerDataRuntime';
+import { Log } from '../telemetry/log';
+/**
+ * Singleton instance of PowerDataRuntime
+ */
+let powerDataRuntimeInstance;
+/**
+ * Gets or creates a singleton instance of PowerDataRuntime
+ * @param powerDataSourcesInfoProvider - Data sources info provider to initialize the PowerDataRuntime
+ * @param powerOperationExecutor - Optional power operation executor to initialize the PowerDataRuntime
+ * @param xrm - Optional xrm object to initialize the PowerDataRuntime
+ * @returns PowerDataRuntime instance
+ */
+export function getPowerDataRuntime(powerDataSourcesInfoProvider, powerOperationExecutor, xrm) {
+    if (!powerDataRuntimeInstance) {
+        powerDataRuntimeInstance = new PowerDataRuntime({
+            powerDataSourcesInfoProvider,
+            powerOperationExecutor,
+            xrm: xrm ?? { WebApi: {} },
+        });
+    }
+    return powerDataRuntimeInstance;
+}
+/**
+ * Resets the PowerDataRuntime singleton instance.
+ * Useful for testing or reinitialization.
+ */
+export function resetPowerDataRuntimeInstance() {
+    powerDataRuntimeInstance = undefined;
+    // Reset the Log instance as well to ensure a clean state
+    Log.resetInstance();
+}
+//# sourceMappingURL=powerDataRuntimeInstance.js.map

package/lib/internal/data/core/runtime/powerDataRuntimeInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerDataRuntimeInstance.js","sourceRoot":"","sources":["../../../../../src/internal/data/core/runtime/powerDataRuntimeInstance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC;;GAEG;AACH,IAAI,wBAAsD,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,4BAA2D,EAC3D,sBAA+C,EAC/C,GAAiB;IAEjB,IAAI,CAAC,wBAAwB,EAAE;QAC7B,wBAAwB,GAAG,IAAI,gBAAgB,CAAC;YAC9C,4BAA4B;YAC5B,sBAAsB;YACtB,GAAG,EAAE,GAAG,IAAK,EAAE,MAAM,EAAE,EAAE,EAAkB;SAC5C,CAAC,CAAC;KACJ;IACD,OAAO,wBAAwB,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B;IAC3C,wBAAwB,GAAG,SAAS,CAAC;IACrC,yDAAyD;IACzD,GAAG,CAAC,aAAa,EAAE,CAAC;AACtB,CAAC"}

package/lib/internal/data/core/runtime/powerDataSourcesInfoProvider.d.ts

@@ -0,0 +1,34 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { IPowerDataSourcesInfoProvider } from '../common/types';
+import { DataSourcesInfo } from '../types';
+/**
+ * Singleton provider for managing data sources information.
+ */
+declare class PowerDataSourcesInfoProvider implements IPowerDataSourcesInfoProvider {
+    private static instance;
+    private dataSourcesInfo;
+    /**
+     * Private constructor to enforce the singleton pattern.
+     * @param dataSourcesInfo The data sources information to initialize the provider with.
+     */
+    private constructor();
+    /**
+     * Retrieves the singleton instance of PowerDataSourcesInfoProvider.
+     * If the instance does not exist, it initializes it with the provided data sources info.
+     *
+     * @param dataSourcesInfo Optional parameter to initialize the instance if it doesn't exist.
+     * @returns The singleton instance of PowerDataSourcesInfoProvider.
+     * @throws Error if the instance is not initialized and no dataSourcesInfo is provided.
+     */
+    static getInstance(dataSourcesInfo?: DataSourcesInfo): PowerDataSourcesInfoProvider;
+    /**
+     * Retrieves the data sources information.
+     *
+     * @returns A promise resolving to the data sources information.
+     */
+    getDataSourcesInfo(): Promise<DataSourcesInfo>;
+}
+export default PowerDataSourcesInfoProvider;
+//# sourceMappingURL=powerDataSourcesInfoProvider.d.ts.map

package/lib/internal/data/core/runtime/powerDataSourcesInfoProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerDataSourcesInfoProvider.d.ts","sourceRoot":"","sources":["../../../../../src/internal/data/core/runtime/powerDataSourcesInfoProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C;;GAEG;AACH,cAAM,4BAA6B,YAAW,6BAA6B;IACzE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6C;IACpE,OAAO,CAAC,eAAe,CAAkB;IAEzC;;;OAGG;IACH,OAAO;IAIP;;;;;;;OAOG;WACW,WAAW,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,4BAA4B;IAU1F;;;;OAIG;IACU,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;CAG5D;AAED,eAAe,4BAA4B,CAAC"}

package/lib/internal/data/core/runtime/powerDataSourcesInfoProvider.js

@@ -0,0 +1,45 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { ErrorCodes, PowerDataRuntimeError } from '../error/error';
+/**
+ * Singleton provider for managing data sources information.
+ */
+class PowerDataSourcesInfoProvider {
+    static instance = null;
+    dataSourcesInfo;
+    /**
+     * Private constructor to enforce the singleton pattern.
+     * @param dataSourcesInfo The data sources information to initialize the provider with.
+     */
+    constructor(dataSourcesInfo) {
+        this.dataSourcesInfo = dataSourcesInfo;
+    }
+    /**
+     * Retrieves the singleton instance of PowerDataSourcesInfoProvider.
+     * If the instance does not exist, it initializes it with the provided data sources info.
+     *
+     * @param dataSourcesInfo Optional parameter to initialize the instance if it doesn't exist.
+     * @returns The singleton instance of PowerDataSourcesInfoProvider.
+     * @throws Error if the instance is not initialized and no dataSourcesInfo is provided.
+     */
+    static getInstance(dataSourcesInfo) {
+        if (!this.instance) {
+            if (!dataSourcesInfo) {
+                throw new PowerDataRuntimeError(ErrorCodes.DataSourcesInfoNotFound);
+            }
+            this.instance = new PowerDataSourcesInfoProvider(dataSourcesInfo);
+        }
+        return this.instance;
+    }
+    /**
+     * Retrieves the data sources information.
+     *
+     * @returns A promise resolving to the data sources information.
+     */
+    async getDataSourcesInfo() {
+        return this.dataSourcesInfo;
+    }
+}
+export default PowerDataSourcesInfoProvider;
+//# sourceMappingURL=powerDataSourcesInfoProvider.js.map

package/lib/internal/data/core/runtime/powerDataSourcesInfoProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerDataSourcesInfoProvider.js","sourceRoot":"","sources":["../../../../../src/internal/data/core/runtime/powerDataSourcesInfoProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;GAEG;AACH,MAAM,4BAA4B;IACxB,MAAM,CAAC,QAAQ,GAAwC,IAAI,CAAC;IAC5D,eAAe,CAAkB;IAEzC;;;OAGG;IACH,YAAoB,eAAgC;QAClD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,WAAW,CAAC,eAAiC;QACzD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAClB,IAAI,CAAC,eAAe,EAAE;gBACpB,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;aACrE;YACD,IAAI,CAAC,QAAQ,GAAG,IAAI,4BAA4B,CAAC,eAAe,CAAC,CAAC;SACnE;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,kBAAkB;QAC7B,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;;AAGH,eAAe,4BAA4B,CAAC"}

package/lib/internal/data/core/runtimeClient/runtimeClientProvider.d.ts

@@ -0,0 +1,43 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { IRuntimeClientProvider, IRuntimeDataClient, IRuntimeMetadataClient } from '../common/types';
+import { IPowerOperationExecutor } from '../types';
+/**
+ * RuntimeClientProvider manages the lifecycle of runtime clients for data and metadata operations.
+ * Implements a lazy initialization pattern for clients and ensures proper error handling.
+ */
+export declare class RuntimeClientProvider implements IRuntimeClientProvider {
+    private _dataClient;
+    private _metadataClient;
+    private readonly _operationExecutor;
+    constructor(powerOperationExecutor: IPowerOperationExecutor);
+    /**
+     * Gets or initializes the data client
+     * @throws Error if client initialization fails
+     * @returns Promise resolving to IRuntimeDataClient
+     */
+    getDataClientAsync(): Promise<IRuntimeDataClient>;
+    /**
+     * Gets or initializes the metadata client
+     * @throws Error if client initialization fails
+     * @returns Promise resolving to IRuntimeMetadataClient
+     */
+    getMetadataClientAsync(): Promise<IRuntimeMetadataClient>;
+    /**
+     * Initializes the data client
+     * @returns Promise resolving to IRuntimeDataClient
+     */
+    private _initializeDataClient;
+    /**
+     * Initializes the metadata client
+     * @returns Promise resolving to IRuntimeMetadataClient
+     */
+    private _initializeMetadataClient;
+    /**
+     * Resets both clients, forcing re-initialization on next use
+     * Useful for testing or recovering from error states
+     */
+    reset(): void;
+}
+//# sourceMappingURL=runtimeClientProvider.d.ts.map

package/lib/internal/data/core/runtimeClient/runtimeClientProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeClientProvider.d.ts","sourceRoot":"","sources":["../../../../../src/internal/data/core/runtimeClient/runtimeClientProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAKnD;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAGlE,OAAO,CAAC,WAAW,CAAiC;IAGpD,OAAO,CAAC,eAAe,CAAqC;IAI5D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0B;gBAKjD,sBAAsB,EAAE,uBAAuB;IAI3D;;;;OAIG;IACU,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAgB9D;;;;OAIG;IACU,sBAAsB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAgBtE;;;OAGG;YACW,qBAAqB;IAInC;;;OAGG;YACW,yBAAyB;IAIvC;;;OAGG;IACI,KAAK,IAAI,IAAI;CAIrB"}

package/lib/internal/data/core/runtimeClient/runtimeClientProvider.js

@@ -0,0 +1,87 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { RuntimeDataClient } from './runtimeDataClient';
+import { RuntimeMetadataClient } from './runtimeMetadataClient';
+import { ErrorCodes, getErrorMessage, PowerDataRuntimeError } from '../error/error';
+/**
+ * RuntimeClientProvider manages the lifecycle of runtime clients for data and metadata operations.
+ * Implements a lazy initialization pattern for clients and ensures proper error handling.
+ */
+export class RuntimeClientProvider {
+    // Private members for data and metadata clients
+    // The data client is responsible for handling data operations
+    _dataClient;
+    // The metadata client is responsible for handling metadata operations
+    _metadataClient;
+    // The operation executor is used to execute operations on the clients
+    // It is an instance of IPowerOperationExecutor, which provides the necessary methods for executing operations
+    _operationExecutor;
+    // Constructor for RuntimeClientProvider
+    // Accepts an optional IPowerOperationExecutor instance for executing operations
+    // If not provided, uses the default PowerOperationExecutor instance
+    constructor(powerOperationExecutor) {
+        this._operationExecutor = powerOperationExecutor;
+    }
+    /**
+     * Gets or initializes the data client
+     * @throws Error if client initialization fails
+     * @returns Promise resolving to IRuntimeDataClient
+     */
+    async getDataClientAsync() {
+        try {
+            if (!this._dataClient) {
+                this._dataClient = await this._initializeDataClient();
+            }
+            if (!this._dataClient) {
+                throw new PowerDataRuntimeError(ErrorCodes.DataClientNotInitialized);
+            }
+            return this._dataClient;
+        }
+        catch (error) {
+            throw new PowerDataRuntimeError(ErrorCodes.DataClientInitFailed, getErrorMessage(error));
+        }
+    }
+    /**
+     * Gets or initializes the metadata client
+     * @throws Error if client initialization fails
+     * @returns Promise resolving to IRuntimeMetadataClient
+     */
+    async getMetadataClientAsync() {
+        try {
+            if (!this._metadataClient) {
+                this._metadataClient = await this._initializeMetadataClient();
+            }
+            if (!this._metadataClient) {
+                throw new PowerDataRuntimeError(ErrorCodes.MetadataClientNotInitialized);
+            }
+            return this._metadataClient;
+        }
+        catch (error) {
+            throw new PowerDataRuntimeError(ErrorCodes.MetadataClientInitFailed, getErrorMessage(error));
+        }
+    }
+    /**
+     * Initializes the data client
+     * @returns Promise resolving to IRuntimeDataClient
+     */
+    async _initializeDataClient() {
+        return RuntimeDataClient.createInstanceAsync(this._operationExecutor);
+    }
+    /**
+     * Initializes the metadata client
+     * @returns Promise resolving to IRuntimeMetadataClient
+     */
+    async _initializeMetadataClient() {
+        return RuntimeMetadataClient.createInstanceAsync(this._operationExecutor);
+    }
+    /**
+     * Resets both clients, forcing re-initialization on next use
+     * Useful for testing or recovering from error states
+     */
+    reset() {
+        this._dataClient = undefined;
+        this._metadataClient = undefined;
+    }
+}
+//# sourceMappingURL=runtimeClientProvider.js.map

package/lib/internal/data/core/runtimeClient/runtimeClientProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeClientProvider.js","sourceRoot":"","sources":["../../../../../src/internal/data/core/runtimeClient/runtimeClientProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEpF;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IAChC,gDAAgD;IAChD,8DAA8D;IACtD,WAAW,CAAiC;IAEpD,sEAAsE;IAC9D,eAAe,CAAqC;IAE5D,sEAAsE;IACtE,8GAA8G;IAC7F,kBAAkB,CAA0B;IAE7D,wCAAwC;IACxC,gFAAgF;IAChF,oEAAoE;IACpE,YAAY,sBAA+C;QACzD,IAAI,CAAC,kBAAkB,GAAG,sBAAsB,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,kBAAkB;QAC7B,IAAI;YACF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;gBACrB,IAAI,CAAC,WAAW,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;aACvD;YAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;gBACrB,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;aACtE;YAED,OAAO,IAAI,CAAC,WAAW,CAAC;SACzB;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,oBAAoB,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;SAC1F;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,sBAAsB;QACjC,IAAI;YACF,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;gBACzB,IAAI,CAAC,eAAe,GAAG,MAAM,IAAI,CAAC,yBAAyB,EAAE,CAAC;aAC/D;YAED,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;gBACzB,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAC;aAC1E;YAED,OAAO,IAAI,CAAC,eAAe,CAAC;SAC7B;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,wBAAwB,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;SAC9F;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,qBAAqB;QACjC,OAAO,iBAAiB,CAAC,mBAAmB,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACxE,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,yBAAyB;QACrC,OAAO,qBAAqB,CAAC,mBAAmB,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACI,KAAK;QACV,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IACnC,CAAC;CACF"}

package/lib/internal/data/core/runtimeClient/runtimeDataClient.d.ts

@@ -0,0 +1,112 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { IOperationContext, IRuntimeDataClient } from '../common/types';
+import { HttpMethod } from '../common/types';
+import { IOperationResult, IPowerOperationExecutor } from '../types';
+/**
+ * RuntimeDataClient handles data operations through PowerOperationExecutor
+ */
+export declare class RuntimeDataClient implements IRuntimeDataClient {
+    private readonly _powerOperationExecutor;
+    private static readonly SERVICES;
+    private static readonly ACTIONS;
+    private static readonly REQUEST_SOURCE;
+    constructor(_powerOperationExecutor: IPowerOperationExecutor);
+    /**
+     * Creates a new instance of RuntimeDataClient
+     */
+    static createInstanceAsync(powerOperationExecutor: IPowerOperationExecutor): Promise<IRuntimeDataClient>;
+    /**
+     * Creates data using POST method
+     * @param url - The URL for the request
+     * @param apiId - The API ID for authentication
+     * @param tableName - The name of the table to access
+     * @param body - The request body for the POST method
+     * @param operationName - Optional operation name for telemetry
+     * @return Promise resolving to the response data
+     * @throws Error if the request fails or the response is invalid
+     * @throws Error if the request body is invalid
+     */
+    createDataAsync<TRequest, TResponse>(url: string, apiId: string, tableName: string, body: TRequest, context?: IOperationContext): Promise<IOperationResult<TResponse>>;
+    /**
+     * Updates data using PATCH method
+     * @param url - The URL for the request
+     * @param apiId - The API ID for authentication
+     * @param tableName - The name of the table to access
+     * @param body - The request body for the PATCH method
+     * @param operationName - Optional operation name for telemetry
+     * @return Promise resolving to the response data
+     * @throws Error if the request fails or the response is invalid
+     * @throws Error if the request body is invalid
+     */
+    updateDataAsync<TRequest, TResponse>(url: string, apiId: string, tableName: string, body: TRequest, context?: IOperationContext): Promise<IOperationResult<TResponse>>;
+    /**
+     * Deletes data using DELETE method
+     * @param url - The URL for the request
+     * @param connectionApi - The API ID for authentication
+     * @param serviceNamespace - The name of the service namespace
+     * @param operationName - Optional operation name for telemetry
+     * @return Promise resolving to the response data
+     * @throws Error if the request fails or the response is invalid
+     */
+    deleteDataAsync(url: string, connectionApi: string, serviceNamespace: string, context?: IOperationContext): Promise<IOperationResult<void>>;
+    /**
+     * Retrieves data using GET or POST method
+     * @param url - The URL for the request
+     * @param apiId - The API ID for authentication
+     * @param tableName - The name of the table to access
+     * @param method - The HTTP method
+     * @param body - Optional request body for POST method
+     * @param context - Optional operation context
+     * @param operationName - Optional operation name for telemetry
+     * @return Promise resolving to the response data
+     * @throws Error if the request fails or the response is invalid
+     */
+    retrieveDataAsync<TRequest, TResponse>(url: string, apiId: string, tableName: string, method: HttpMethod, headers?: {
+        [key: string]: string;
+    }, body?: unknown, context?: IOperationContext): Promise<IOperationResult<TResponse>>;
+    /**
+     * Gets an access token for the specified API.
+     * If the API is Dataverse, retrieves a dynamic resource token; otherwise, retrieves a standard appservice API token.
+     * @param apiId - The API ID for authentication
+     * @param datasetName - Optional dataset name for Dataverse
+     * @returns Promise resolving to the access token
+     * @throws Error if token acquisition fails
+     */
+    private _getAccessToken;
+    private _mergePreferHeaders;
+    /**
+     * Creates headers for the HTTP request.
+     * Combines default headers with any custom headers provided in the config.
+     * Custom headers are optional and take precedence over default headers.
+     * @param token - The access token for authentication
+     * @param config - The HTTP request configuration
+     * @return The headers for the request
+     * @throws Error if header creation fails
+     */
+    private _createHeaders;
+    /**
+     * Executes an HTTP request with the given configuration
+     * @param config - The HTTP request configuration
+     * @param context - Optional operation context
+     * @return Promise resolving to the response data
+     * @throws Error if the request fails or the response is invalid
+     * @throws Error if the response content type is invalid
+     */
+    private _executeRequest;
+    private _ensureContext;
+    /**
+     * Checks if the given URL is a Dataverse API call
+     * @param url - The URL to check
+     * @returns True if the URL is a Dataverse API call, false otherwise
+     */
+    private _isDataverseCall;
+    /**
+     * Decodes ArrayBuffer to string, handling both browser and Node.js environments
+     * @param buffer - The ArrayBuffer to decode
+     * @returns The decoded string
+     */
+    private _decodeArrayBuffer;
+}
+//# sourceMappingURL=runtimeDataClient.d.ts.map

package/lib/internal/data/core/runtimeClient/runtimeDataClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeDataClient.d.ts","sourceRoot":"","sources":["../../../../../src/internal/data/core/runtimeClient/runtimeDataClient.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAIL,iBAAiB,EACjB,kBAAkB,EAGnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAqB,MAAM,UAAU,CAAC;AAWxF;;GAEG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAuB9C,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IApBpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAG9B;IAKF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAI7B;IAIF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAkB;gBAI3B,uBAAuB,EAAE,uBAAuB;IAE7E;;OAEG;WACW,mBAAmB,CAC/B,sBAAsB,EAAE,uBAAuB,GAC9C,OAAO,CAAC,kBAAkB,CAAC;IAI9B;;;;;;;;;;OAUG;IACU,eAAe,CAAC,QAAQ,EAAE,SAAS,EAC9C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IA4BvC;;;;;;;;;;OAUG;IACU,eAAe,CAAC,QAAQ,EAAE,SAAS,EAC9C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IA4BvC;;;;;;;;OAQG;IACU,eAAe,CAC1B,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAqBlC;;;;;;;;;;;OAWG;IACU,iBAAiB,CAAC,QAAQ,EAAE,SAAS,EAChD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EACnC,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAuBvC;;;;;;;OAOG;YACW,eAAe;IAuB7B,OAAO,CAAC,mBAAmB;IAqB3B;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IA+CtB;;;;;;;OAOG;YACW,eAAe;IA2I7B,OAAO,CAAC,cAAc;IAetB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CA0B3B"}