@microsoft/power-apps 0.3.1

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"}