@microsoft/power-apps 1.0.0

package/lib/internal/data/core/common/types.d.ts

@@ -0,0 +1,230 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { DataSourcesInfo, IOperationResult } from '../types';
+/**
+ * Base interface for operation context
+ */
+export interface IOperationContext {
+    isExecuteAsync?: boolean;
+    clientConfig?: IClientConfig;
+    operationName?: string;
+    correlationId?: string;
+    timestamp?: Date;
+    responseInfo?: Record<string, IApiResponseInfo>;
+    batchId?: string;
+    datasetName?: string;
+    isDataVerseOperation?: boolean;
+}
+export interface IApiResponseInfo {
+    type?: string | null;
+    format?: string | null;
+}
+/**
+ * Base interface for client configuration
+ */
+export interface IClientConfig {
+    baseUrl?: string;
+    timeout?: number;
+    retryAttempts?: number;
+}
+/**
+ * Interface for HTTP request configuration
+ */
+export interface IHttpRequestConfig {
+    url: string;
+    method: HttpMethod;
+    apiId: string;
+    tableName: string;
+    headers?: {
+        [key: string]: string;
+    };
+    body?: string;
+}
+/**
+ * Interface for HTTP request headers
+ */
+export interface IHttpHeaders {
+    Accept: string;
+    'x-ms-protocol-semantics': string;
+    ServiceNamespace: string;
+    Authorization: string;
+    'x-ms-pa-client-custom-headers-options': string;
+    'x-ms-enable-selects': string;
+    'x-ms-pa-client-telemetry-options': string;
+    'x-ms-pa-client-telemetry-additional-data': string;
+    BatchInfo?: string;
+}
+/**
+ * HTTP methods supported by the client
+ */
+export declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE",
+    PATCH = "PATCH"
+}
+/**
+ * Interface for OData response format
+ * @template T The type of data in the response
+ */
+export interface ODataResponse<T> {
+    '@odata.context'?: string;
+    value: T;
+}
+/**
+ * Interface for metadata operation configuration
+ */
+export interface IMetadataOperationConfig {
+    service: string;
+    action: string;
+    params?: unknown[];
+}
+/**
+ * Interface for operation execution result
+ */
+export type OperationExecutionResponse = [Record<string, object>, ArrayBuffer];
+/**
+ * Type alias for possible response data formats
+ */
+export type ResponseData = Record<string, unknown> | ArrayBuffer;
+/**
+ * Type alias for request body in data operations
+ */
+export type RequestBody = Record<string, unknown>;
+/**
+ * Interface for API definition details
+ */
+export interface IApiDefinition {
+    path: string;
+    method: string;
+    parameters: Array<{
+        name: string;
+        in: string;
+        required: boolean;
+        type: string;
+    }>;
+}
+/**
+ * Interface for connection API details
+ */
+export interface IConnectionApi {
+    path: string;
+    method?: string;
+    parameters?: string[];
+}
+/**
+ * Interface for connection reference details
+ */
+export interface IConnectionReference {
+    apiId?: string;
+    connectionName?: string;
+    datasetName?: string;
+    datasetNameOverride?: string;
+    isShareableConnection?: string;
+    runtimePolicyName?: string;
+    runtimeUrl?: string;
+}
+/**
+ * Interface for table schema information
+ */
+export interface ITableSchema {
+    name: string;
+    displayName?: string;
+    fields: Record<string, IFieldSchema>;
+}
+/**
+ * Interface for field schema information
+ */
+export interface IFieldSchema {
+    name: string;
+    type: string;
+    required?: boolean;
+    maxLength?: number;
+    defaultValue?: unknown;
+}
+/**
+ * Interface for Dataverse-specific requests
+ */
+export interface IDataverseRequest {
+    /** HTTP method for the request */
+    method: string;
+    /** Request path */
+    path: string;
+    /** Optional request headers */
+    headers?: Record<string, string>;
+    /** Optional request body */
+    body?: unknown;
+}
+/**
+ * Supported data source types in the PowerDataRuntime
+ */
+export declare enum DataSources {
+    /** Dataverse data source */
+    Dataverse = "Dataverse",
+    /** Generic connector data source */
+    Connector = "Connector"
+}
+/**
+ * Interface for metadata operations
+ */
+export interface IMetadataOperations {
+    /**
+     * Gets available connections
+     */
+    getConnections(context?: IOperationContext): Promise<IOperationResult<IConnectionReference[]>>;
+    /**
+     * Gets APIs available for a connection
+     */
+    getConnectionApis(connectionId: string, context?: IOperationContext): Promise<IOperationResult<IConnectionApi[]>>;
+}
+/**
+ * Interface for runtime client provider
+ */
+export interface IRuntimeClientProvider {
+    getDataClientAsync(config?: IClientConfig): Promise<IRuntimeDataClient>;
+    getMetadataClientAsync(config?: IClientConfig): Promise<IRuntimeMetadataClient>;
+}
+/**
+ * Interface for runtime data client
+ */
+export interface IRuntimeDataClient {
+    createDataAsync<TRequest, TResponse>(url: string, connectionApi: string, serviceNamespace: string, body: TRequest, context?: IOperationContext): Promise<IOperationResult<TResponse>>;
+    updateDataAsync<TRequest, TResponse>(url: string, connectionApi: string, serviceNamespace: string, body: TRequest, context?: IOperationContext): Promise<IOperationResult<TResponse>>;
+    deleteDataAsync(url: string, connectionApi: string, serviceNamespace: string, context?: IOperationContext): Promise<IOperationResult<void>>;
+    retrieveDataAsync<TResponse>(url: string, connectionApi: string, serviceNamespace: string, method: HttpMethod, headers?: {
+        [key: string]: string;
+    }, body?: unknown, context?: IOperationContext): Promise<IOperationResult<TResponse>>;
+}
+/**
+ * Interface for runtime metadata client
+ */
+export interface IRuntimeMetadataClient {
+    getAppConnectionConfigsAsync(context?: IOperationContext): Promise<IOperationResult<IConnectionReference>>;
+    getAppDataSourceConfigsAsync(context?: IOperationContext): Promise<IOperationResult<IConnectionApi>>;
+}
+/**
+ * Interface for PowerDataSourcesInfoProvider
+ */
+export interface IPowerDataSourcesInfoProvider {
+    getDataSourcesInfo(): Promise<DataSourcesInfo>;
+}
+/**
+ * Interface defining the XRM context shape
+ */
+export interface IXrmContext {
+    context: {
+        getClientUrl(): string;
+        getVersion(): string;
+    };
+    WebApi: {
+        createRecord<TRequest, TResponse>(entityLogicalName: string, data: TRequest): Promise<TResponse>;
+        updateRecord<TRequest, TResponse>(entityLogicalName: string, id: string, data: Partial<TRequest>): Promise<TResponse>;
+        deleteRecord(entityLogicalName: string, id: string): Promise<void>;
+        retrieveRecord<TResponse>(entityLogicalName: string, id: string, options?: string): Promise<TResponse>;
+        retrieveMultipleRecords<TResponse>(entityLogicalName: string, options?: string, maxPageSize?: number): Promise<TResponse>;
+        execute<TRequest, TResponse>(request: TRequest): Promise<TResponse>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/internal/data/core/common/types.d.ts.map

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

package/lib/internal/data/core/common/types.js

@@ -0,0 +1,25 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * HTTP methods supported by the client
+ */
+export var HttpMethod;
+(function (HttpMethod) {
+    HttpMethod["GET"] = "GET";
+    HttpMethod["POST"] = "POST";
+    HttpMethod["PUT"] = "PUT";
+    HttpMethod["DELETE"] = "DELETE";
+    HttpMethod["PATCH"] = "PATCH";
+})(HttpMethod || (HttpMethod = {}));
+/**
+ * Supported data source types in the PowerDataRuntime
+ */
+export var DataSources;
+(function (DataSources) {
+    /** Dataverse data source */
+    DataSources["Dataverse"] = "Dataverse";
+    /** Generic connector data source */
+    DataSources["Connector"] = "Connector";
+})(DataSources || (DataSources = {}));
+//# sourceMappingURL=types.js.map

package/lib/internal/data/core/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/internal/data/core/common/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2EH;;GAEG;AACH,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,2BAAa,CAAA;IACb,yBAAW,CAAA;IACX,+BAAiB,CAAA;IACjB,6BAAe,CAAA;AACjB,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB;AAqHD;;GAEG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,4BAA4B;IAC5B,sCAAuB,CAAA;IACvB,oCAAoC;IACpC,sCAAuB,CAAA;AACzB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB"}

package/lib/internal/data/core/common/utils.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export declare function arrayBufferToBase64(buffer: ArrayBuffer): string;
+export declare function convertArrayBufferToString(buf: ArrayBuffer): string;
+/**
+ * Strict encode: encodeURIComponent, but also encode ( and )
+ */
+export declare function strictEncode(str: string): string;
+/**
+ * Extracts the Dataverse base URL and encoded path from a full Dataverse API URL.
+ * @param url - The full Dataverse API URL (should contain /api/data/v9.0/)
+ * @returns An object with baseUrl (up to /api/data/v9.0) and encodedPath (strict encoded path after /api/data/v9.0/)
+ */
+export declare function extractDataverseUrlParts(url: string): {
+    baseUrl: string;
+    encodedPath: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/lib/internal/data/core/common/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/internal/data/core/common/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE/D;AAOD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAWnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAO9F"}

package/lib/internal/data/core/common/utils.js

@@ -0,0 +1,47 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/*
+ * Converts an ArrayBuffer to a Base64 string
+ * @param buffer - The ArrayBuffer to convert
+ * @return The Base64 encoded string
+ */
+export function arrayBufferToBase64(buffer) {
+    return window.btoa(convertArrayBufferToString(buffer));
+}
+/*
+ * Converts an ArrayBuffer to a string
+ * @param buf - The ArrayBuffer to convert
+ * @return The converted string
+ */
+export function convertArrayBufferToString(buf) {
+    // String.fromCharCode range max is 65535
+    if (buf.byteLength <= 65535) {
+        return String.fromCharCode(...new Uint8Array(buf));
+    }
+    let binary = '';
+    for (let i = 0, bytes = new Uint8Array(buf); i < bytes.byteLength; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return binary;
+}
+/**
+ * Strict encode: encodeURIComponent, but also encode ( and )
+ */
+export function strictEncode(str) {
+    return encodeURIComponent(str).replace(/\(/g, '%28').replace(/\)/g, '%29');
+}
+/**
+ * Extracts the Dataverse base URL and encoded path from a full Dataverse API URL.
+ * @param url - The full Dataverse API URL (should contain /api/data/v9.0/)
+ * @returns An object with baseUrl (up to /api/data/v9.0) and encodedPath (strict encoded path after /api/data/v9.0/)
+ */
+export function extractDataverseUrlParts(url) {
+    const baseUrlMatch = url.match(/^(https?:\/\/[^/]+\/api\/data\/v9\.0)/);
+    const baseUrl = baseUrlMatch ? baseUrlMatch[1] : '';
+    // Extract and encode the path after /api/data/v9.0/
+    const pathMatch = url.match(/\/api\/data\/v9\.0\/(.+)$/);
+    const encodedPath = pathMatch ? strictEncode(pathMatch[1]) : '';
+    return { baseUrl, encodedPath };
+}
+//# sourceMappingURL=utils.js.map

package/lib/internal/data/core/common/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../src/internal/data/core/common/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,OAAO,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAgB;IACzD,yCAAyC;IACzC,IAAI,GAAG,CAAC,UAAU,IAAI,KAAK,EAAE;QAC3B,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;KACpD;IAED,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE;QACtE,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACzC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,oDAAoD;IACpD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/lib/internal/data/core/data/connectorDataOperation.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 { IDataOperation, 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 ConnectorDataOperation {
+    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=connectorDataOperation.d.ts.map

package/lib/internal/data/core/data/connectorDataOperation.d.ts.map

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