@microsoft/power-apps 0.3.1

package/lib/internal/data/core/data/defaultOperationOrchestrator.js

@@ -0,0 +1,249 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { DataSources } from '../common/types';
+import { createErrorResponse, DataOperationErrorMessages } from '../error/error';
+import { getDataOperationExecutor } from '../../../../data/powerAppsData';
+/**
+ * RuntimeDataOperations provides a unified interface for performing data operations
+ * across different data sources.
+ */
+export class DefaultDataOperationOrchestrator {
+    _dataverseOperation;
+    _connectorOperation;
+    _connectionsService;
+    // Static identifiers for services and actions
+    // Used to identify specific services and actions within the PowerApps environment
+    constructor(_dataverseOperation, _connectorOperation, _connectionsService) {
+        this._dataverseOperation = _dataverseOperation;
+        this._connectorOperation = _connectorOperation;
+        this._connectionsService = _connectionsService;
+    }
+    /**
+     * Creates a new record in the specified data source.
+     * @param tableName - The name of the table.
+     * @param data - The record data to create.
+     * @returns A promise that resolves to the operation result.
+     * @throws DataOperationError if the operation fails.
+     */
+    async createRecordAsync(tableName, data) {
+        try {
+            this._validateParams({ tableName, data });
+            const executor = await this._getExecutor(tableName);
+            return await executor.createRecordAsync(tableName, data);
+        }
+        catch (error) {
+            return createErrorResponse(error, 'Create record operation failed');
+        }
+    }
+    /**
+     * Updates an existing record in the specified data source.
+     * @param tableName - The name of the table.
+     * @param id - The ID of the record to update.
+     * @param data - The updated record data.
+     * @returns A promise that resolves to the operation result.
+     * @throws DataOperationError if the operation fails.
+     */
+    async updateRecordAsync(tableName, id, data) {
+        try {
+            this._validateParams({ tableName, id, data });
+            const executor = await this._getExecutor(tableName);
+            return await executor.updateRecordAsync(tableName, id, data);
+        }
+        catch (error) {
+            return createErrorResponse(error, 'Update record operation failed');
+        }
+    }
+    /**
+     * Deletes a record from the specified data source.
+     * @param tableName - The name of the table.
+     * @param id - The ID of the record to delete.
+     * @returns A promise that resolves to the operation result.
+     * @throws DataOperationError if the operation fails.
+     */
+    async deleteRecordAsync(tableName, id) {
+        try {
+            this._validateParams({ tableName, id });
+            const executor = await this._getExecutor(tableName);
+            return await executor.deleteRecordAsync(tableName, id);
+        }
+        catch (error) {
+            return createErrorResponse(error, 'Delete record operation failed');
+        }
+    }
+    /**
+     * Retrieves a record from the specified data source.
+     * @param tableName - The name of the table.
+     * @param id - The ID of the record to retrieve.
+     * @param options - Optional operation options.
+     * @returns A promise that resolves to the operation result.
+     * @throws DataOperationError if the operation fails.
+     */
+    async retrieveRecordAsync(tableName, id, options) {
+        try {
+            this._validateParams({ tableName, id });
+            const executor = await this._getExecutor(tableName);
+            const optionsString = this._convertOptionsToString(options);
+            return await executor.retrieveRecordAsync(tableName, id, optionsString, options?.maxPageSize);
+        }
+        catch (error) {
+            return createErrorResponse(error, 'Retrieve record operation failed');
+        }
+    }
+    /**
+     * Retrieves multiple records from the specified data source.
+     * @param tableName - The name of the table.
+     * @param options - Optional operation options.
+     * @returns A promise that resolves to the operation result.
+     * @throws DataOperationError if the operation fails.
+     */
+    async retrieveMultipleRecordsAsync(tableName, options) {
+        try {
+            this._validateParams({ tableName });
+            const executor = await this._getExecutor(tableName);
+            const optionsString = this._convertOptionsToString(options);
+            return await executor.retrieveMultipleRecordsAsync(tableName, optionsString, options?.maxPageSize);
+        }
+        catch (error) {
+            return createErrorResponse(error, 'Retrieve multiple records operation failed');
+        }
+    }
+    /**
+     * Executes a data operation on the specified data source.
+     * @param operation - The operation to execute
+     * @returns A promise that resolves to the operation result.
+     * @throws DataOperationError if the operation fails.
+     */
+    async executeAsync(operation) {
+        try {
+            this._validateParams({ operation });
+            const executor = await this._getExecutor('', operation.connectorOperation ? DataSources.Connector : DataSources.Dataverse);
+            return await executor.executeAsync(operation);
+        }
+        catch (error) {
+            return createErrorResponse(error, 'Execute operation failed');
+        }
+    }
+    /**
+     * Retrieves the appropriate executor based on the data source.
+     * @param dataSource - The data source to retrieve the executor for.
+     * @returns The corresponding executor instance.
+     * @throws DataOperationError if the data source is invalid.
+     * // TODO: Add Dataverse support
+     */
+    async _getExecutor(tableName, dataSource) {
+        const dataOperationExecutorOverride = getDataOperationExecutor();
+        if (dataOperationExecutorOverride) {
+            return dataOperationExecutorOverride;
+        }
+        const dataSourceType = dataSource || (await this._connectionsService.getDataSource(tableName)).dataSourceType;
+        switch (dataSourceType) {
+            case DataSources.Dataverse:
+                return this._dataverseOperation;
+            case DataSources.Connector:
+                return this._connectorOperation;
+            default:
+                return this._connectorOperation;
+        }
+    }
+    /**
+     * Validates the input parameters for data operations.
+     * @param params - The parameters to validate.
+     * @throws DataOperationError if validation fails.
+     */
+    _validateParams(params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (!value) {
+                throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: ${key} is required`);
+            }
+        }
+    }
+    /**
+     * Converts operation options to a query string format.
+     * @param options - The operation options to convert.
+     * @returns The formatted query string.
+     */
+    _convertOptionsToString(options) {
+        if (!options) {
+            return '';
+        }
+        this._validateOptions(options);
+        const parts = [];
+        if (options.select && options.select.length > 0) {
+            parts.push(`$select=${encodeURIComponent(options.select.map((s) => s.trim().replace(/%20/g, '+').replace(/'/g, '%27')).join(','))}`);
+        }
+        if (options.filter) {
+            const encodedFilter = encodeURIComponent(options.filter.trim())
+                .replace(/%20/g, '+')
+                .replace(/'/g, '%27');
+            parts.push(`$filter=${encodedFilter}`);
+        }
+        if (options.orderBy && options.orderBy.length > 0) {
+            parts.push(`$orderby=${encodeURIComponent(options.orderBy.map((s) => s.trim().replace(/%20/g, '+').replace(/'/g, '%27')).join(','))}`);
+        }
+        if (options.top !== undefined && options.top !== null) {
+            parts.push(`$top=${options.top}`);
+        }
+        if (options.skip !== undefined && options.skip !== null) {
+            parts.push(`$skip=${options.skip}`);
+        }
+        if (options.count !== undefined && options.count !== null) {
+            parts.push(`$count=${options.count}`);
+        }
+        if (options.skipToken && options.skipToken.trim() !== '') {
+            parts.push(`$skiptoken=${encodeURIComponent(options.skipToken.trim())}`);
+        }
+        return parts.length ? `?${parts.join('&')}` : '';
+    }
+    /**
+     * Validates the operation options.
+     * @param options - The operation options to validate.
+     * @throws Error if validation fails.
+     */
+    _validateOptions(options) {
+        // maxPageSize must be a number
+        if (options.maxPageSize && typeof options.maxPageSize !== 'number') {
+            throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: maxPageSize must be a number`);
+        }
+        /*
+        select
+        - must be an array of string
+        - no empty strings allowed
+        - no null or undefined values allowed
+        */
+        if (options.select) {
+            if (!Array.isArray(options.select)) {
+                throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: select must be an array of strings`);
+            }
+            if (options.select.some((s) => typeof s !== 'string' || s.trim() === '')) {
+                throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: select must contain only non-empty strings`);
+            }
+        }
+        // filter must be a string
+        if (options.filter && typeof options.filter !== 'string') {
+            throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: filter must be a string`);
+        }
+        // orderBy must be an array of strings
+        if (options.orderBy) {
+            if (!Array.isArray(options.orderBy)) {
+                throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: orderBy must be an array of strings`);
+            }
+            if (options.orderBy.some((s) => typeof s !== 'string' || s.trim() === '')) {
+                throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: orderBy must contain only non-empty strings`);
+            }
+        }
+        // top must be a number
+        if (options.top && typeof options.top !== 'number') {
+            throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: top must be a number`);
+        }
+        // skip must be a number
+        if (options.skip && typeof options.skip !== 'number') {
+            throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: skip must be a number`);
+        }
+        // count must be a boolean
+        if (options.count && typeof options.count !== 'boolean') {
+            throw new Error(`${DataOperationErrorMessages.InvalidOperationParameters}: count must be a boolean`);
+        }
+    }
+}
+//# sourceMappingURL=defaultOperationOrchestrator.js.map

package/lib/internal/data/core/data/defaultOperationOrchestrator.js.map

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

package/lib/internal/data/core/data/executors/connectorDataOperationExecutor.d.ts

@@ -0,0 +1,160 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { IConnectionReference, IRuntimeClientProvider } from '../../common/types';
+import { RuntimeDataSourceService } from '../../metadata/runtimeDataSourceService';
+import type { IDataOperation, IDataOperationExecutor, IOperationResult } from '../../types';
+/**
+ * Type for connection references mapping
+ */
+export type ConnectionReferences = Record<string, IConnectionReference>;
+/**
+ * Interface for connector operation configuration
+ */
+export interface IConnectorOperationConfig {
+    tableName: string;
+    apiId: string;
+    runtimeUrl: string;
+    connectionName: string;
+    datasetName?: string;
+    tableId: string;
+    version?: string;
+    datasetNameOverride?: string;
+}
+/**
+ * ConnectorDataOperation provides functionality for performing CRUD operations
+ * against connector data sources using the Runtime Data Client.
+ */
+export declare class ConnectorDataOperationExecutor implements IDataOperationExecutor {
+    private readonly _clientProvider;
+    private readonly _connectionsService;
+    private _databaseReferences;
+    private _connectionReferences;
+    constructor(clientProvider: IRuntimeClientProvider, connectionsService: RuntimeDataSourceService);
+    /**
+     * Creates a new record in the specified table
+     */
+    createRecordAsync<TRequest, TResponse>(tableName: string, data: TRequest): Promise<IOperationResult<TResponse>>;
+    /**
+     * Updates an existing record in the specified table
+     */
+    updateRecordAsync<TRequest, TResponse>(tableName: string, id: string, data: TRequest): Promise<IOperationResult<TResponse>>;
+    /**
+     * Deletes a record from the specified table
+     */
+    deleteRecordAsync(tableName: string, id: string): Promise<IOperationResult<void>>;
+    /**
+     * Retrieves a single record from the specified table
+     */
+    retrieveRecordAsync<TResponse>(tableName: string, id: string, options: string): Promise<IOperationResult<TResponse>>;
+    /**
+     * Retrieves multiple records from the specified table
+     */
+    retrieveMultipleRecordsAsync<TResponse>(tableName: string, options: string): Promise<IOperationResult<TResponse[]>>;
+    /**
+     * Executes a custom operation on the data source
+     */
+    executeAsync<TRequest, TResponse>(operation: IDataOperation<TRequest>): Promise<IOperationResult<TResponse>>;
+    /**
+     * Determines the appropriate HTTP method for a request
+     * @param requestUrl - The URL for the request
+     * @param dataSourceInfo - The data source information
+     * @param operation - The operation name
+     * @returns The HTTP method to use
+     */
+    private _getHttpMethod;
+    /**
+     * Builds the operation body parameters
+     */
+    private _buildOperationBody;
+    /**
+     * Builds operation body parameters from the operation and data source info
+     */
+    private _buildOperationBodyParam;
+    /**
+     * Builds the operation header for a given data operation if required.
+     *
+     * @template TRequest - The type of the request payload for the data operation.
+     * @param dataOperationRequest - The data operation containing details about the connector operation.
+     * @param tableName - The name of the table associated with the data operation.
+     * @returns A promise that resolves to the operation header as a string if a header parameter is required,
+     *          or `undefined` if no header parameter is needed.
+     */
+    private _buildOperationHeader;
+    /**
+     * Builds the operation header parameters as a JSON string for a given data operation.
+     *
+     * @template TRequest - The type of the request object for the data operation.
+     * @param dataOperationRequest - The data operation containing connector operation details and parameters.
+     * @param tableName - The name of the table associated with the data operation.
+     * @returns A promise that resolves to a JSON string representing the header parameters,
+     *          or `undefined` if no `header` parameters are available.
+     */
+    private _buildOperationHeaderParam;
+    /**
+     * Constructs the request URL for table operations
+     * @param tableName - The name of the table
+     * @param connectionReference - The connection reference
+     * @param options - Optional URL parameters
+     * @param encodeOptions - Whether to encode the options
+     * @returns The constructed URL
+     */
+    private _buildTableUrl;
+    /**
+     * Builds the operation URL
+     */
+    private _buildOperationUrl;
+    /**
+     * Gets the connection references
+     */
+    private _getConnectionReferencesAsync;
+    /**
+     * Gets the database references
+     */
+    private _getDatabaseReferencesAsync;
+    /**
+     * Gets the metadata client instance
+     */
+    private _getMetadataClient;
+    /**
+     * Gets the connection reference for a table
+     */
+    private _getConnectionReference;
+    /**
+     * Gets both the data client and connection reference
+     */
+    private _getClientsAndConnection;
+    /**
+     * Builds the URL for shared SQL operations
+     */
+    private _buildSharedSqlOperationUrl;
+    /**
+     * Builds the URL for standard operations
+     */
+    private _buildStandardOperationUrl;
+    /**
+     * Normalizes the parameter name by replacing hyphens with underscores and performs case-insensitive matching
+     */
+    private _getNormalizedParamValue;
+    /**
+     * Processes operation parameters into path and query parameters
+     */
+    private _processParameters;
+    /**
+     * Gets the operation configuration
+     */
+    private _getOperationConfig;
+    /**
+     * Initializes the clients
+     */
+    private _getReferences;
+    /**
+     * Validates constructor parameters
+     */
+    private _validateConstructorParams;
+    /**
+     * Constructs the final URL
+     */
+    private _constructUrl;
+}
+//# sourceMappingURL=connectorDataOperationExecutor.d.ts.map

package/lib/internal/data/core/data/executors/connectorDataOperationExecutor.d.ts.map

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