@microsoft/apps 0.0.1 → 0.4.0

package/dist/data/metadata/dataverse/dataverseMetadata.js

@@ -0,0 +1,118 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+const entityClusterModeEnum = {
+    0: 'Partitioned',
+    1: 'Replicated',
+    2: 'Local',
+};
+export function getEntityClusterModeName(value) {
+    return entityClusterModeEnum[value];
+}
+const ownershipTypeEnum = {
+    0: 'None',
+    1: 'UserOwned',
+    2: 'TeamOwned',
+    4: 'BusinessOwned',
+    8: 'OrganizationOwned',
+    16: 'BusinessParented',
+    32: 'Filtered',
+};
+export function getOwnershipTypeName(value) {
+    return ownershipTypeEnum[value];
+}
+const privilegeTypeEnum = {
+    0: 'None',
+    1: 'Create',
+    2: 'Read',
+    3: 'Write',
+    4: 'Delete',
+    5: 'Assign',
+    6: 'Share',
+    7: 'Append',
+    8: 'AppendTo',
+};
+export function getPrivilegeTypeName(value) {
+    return privilegeTypeEnum[value];
+}
+const attributeTypeCodeEnum = {
+    0: 'Boolean',
+    1: 'Customer',
+    2: 'DateTime',
+    3: 'Decimal',
+    4: 'Double',
+    5: 'Integer',
+    6: 'Lookup',
+    7: 'Memo',
+    8: 'Money',
+    9: 'Owner',
+    10: 'PartyList',
+    11: 'Picklist',
+    12: 'State',
+    13: 'Status',
+    14: 'String',
+    15: 'Uniqueidentifier',
+    16: 'CalendarRules',
+    17: 'Virtual',
+    18: 'BigInt',
+    19: 'ManagedProperty',
+    20: 'EntityName',
+};
+export function getAttributeTypeCodeName(value) {
+    return attributeTypeCodeEnum[value];
+}
+const attributeRequiredLevelEnum = {
+    0: 'None',
+    1: 'SystemRequired',
+    2: 'ApplicationRequired',
+    3: 'Recommended',
+};
+export function getAttributeRequiredLevelName(value) {
+    return attributeRequiredLevelEnum[value];
+}
+const relationshipTypeEnum = {
+    0: 'OneToManyRelationship',
+    1: 'ManyToManyRelationship',
+};
+export function getRelationshipTypeName(value) {
+    return relationshipTypeEnum[value];
+}
+const securityTypesEnum = {
+    0: 'None', // No security privileges are checked during create or update operations.
+    1: 'Append', // The Append and AppendTo privileges are checked for create or update operations.
+    2: 'ParentChild', // Security for the referencing entity record is derived from the referenced entity record.
+    8: 'Pointer', // Security for the referencing entity record is derived from a pointer record.
+    16: 'Inheritance', // The referencing entity record inherits security from the referenced security record.
+};
+export function getSecurityTypesName(value) {
+    return securityTypesEnum[value];
+}
+const associatedMenuBehaviorEnum = {
+    0: 'UseCollectionName',
+    1: 'UseLabel',
+    2: 'DoNotDisplay',
+};
+export function getAssociatedMenuBehaviorName(value) {
+    return associatedMenuBehaviorEnum[value];
+}
+const associatedMenuGroupEnum = {
+    0: 'Details',
+    1: 'Sales',
+    2: 'Service',
+    3: 'Marketing',
+};
+export function getAssociatedMenuGroupName(value) {
+    return associatedMenuGroupEnum[value];
+}
+const cascadeTypeEnum = {
+    0: 'NoCascade', // Do nothing.
+    1: 'Cascade', // Perform the action on all referencing entity records associated with the referenced entity record.
+    2: 'Active', //	Perform the action on all active referencing entity records associated with the referenced entity record.
+    3: 'UserOwned', // Perform the action on all referencing entity records owned by the same user as the referenced entity record.
+    4: 'RemoveLink', // Remove the value of the referencing attribute for all referencing entity records associated with the referenced entity record.
+    5: 'Restrict', // Prevent the Referenced entity record from being deleted when referencing entities exist.
+};
+export function getCascadeTypeName(value) {
+    return cascadeTypeEnum[value];
+}
+//# sourceMappingURL=dataverseMetadata.js.map

package/dist/data/metadata/dataverse/dataverseMetadata.js.map

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

package/dist/data/metadata/dataverse/index.d.ts

@@ -0,0 +1,6 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export type { EntityMetadata, GetEntityMetadataOptions } from './dataverseMetadata';
+export { getAssociatedMenuBehaviorName, getAssociatedMenuGroupName, getAttributeRequiredLevelName, getAttributeTypeCodeName, getCascadeTypeName, getEntityClusterModeName, getOwnershipTypeName, getPrivilegeTypeName, getRelationshipTypeName, getSecurityTypesName, } from './dataverseMetadata';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/metadata/dataverse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/data/metadata/dataverse/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,6BAA6B,EAC7B,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/data/metadata/dataverse/index.js

@@ -0,0 +1,5 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export { getAssociatedMenuBehaviorName, getAssociatedMenuGroupName, getAttributeRequiredLevelName, getAttributeTypeCodeName, getCascadeTypeName, getEntityClusterModeName, getOwnershipTypeName, getPrivilegeTypeName, getRelationshipTypeName, getSecurityTypesName, } from './dataverseMetadata';
+//# sourceMappingURL=index.js.map

package/dist/data/metadata/dataverse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/data/metadata/dataverse/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,6BAA6B,EAC7B,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/data/multiSelectPicklistUtils.d.ts

@@ -0,0 +1,34 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Serializes MultiSelectPicklist fields in a Dataverse record before sending to the API.
+ *
+ * The Dataverse Web API expects MultiSelectPicklist values as comma-separated strings
+ * (e.g. `"100,200,300"`), but the generated TypeScript types represent them as number arrays
+ * (e.g. `[100, 200, 300]`). This function converts any listed field whose current value is an
+ * array into that wire format. An empty array is serialized as `null` because Dataverse rejects
+ * an empty string for this column type — `null` is the correct way to clear the field.
+ *
+ * A shallow copy of the record is returned so the caller's object is not mutated.
+ *
+ * @param record - The record being sent to `createRecordAsync` or `updateRecordAsync`.
+ * @param fields - Names of all MultiSelectPicklist columns declared on this entity.
+ * @returns A new record object with array-valued picklist fields replaced by comma-separated strings,
+ *   or `null` for empty arrays.
+ */
+export declare function serializeMultiSelectPicklistFields(record: Record<string, unknown>, fields: readonly string[]): Record<string, unknown>;
+/**
+ * Deserializes MultiSelectPicklist fields in a Dataverse record returned from the API.
+ *
+ * The Dataverse Web API returns MultiSelectPicklist values as comma-separated strings
+ * (e.g. `"100,200,300"`), but the generated TypeScript types represent them as number arrays.
+ * This function mutates the record in place, converting each listed field from its wire format
+ * back to an array. An empty string (`""`) is treated as an empty array.
+ *
+ * @param record - The record returned by `retrieveRecordAsync` or `retrieveMultipleRecordsAsync`.
+ *                 Mutated in place.
+ * @param fields - Names of all MultiSelectPicklist columns declared on this entity.
+ */
+export declare function deserializeMultiSelectPicklistFields(record: Record<string, unknown>, fields: readonly string[]): void;
+//# sourceMappingURL=multiSelectPicklistUtils.d.ts.map

package/dist/data/multiSelectPicklistUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiSelectPicklistUtils.d.ts","sourceRoot":"","sources":["../../src/data/multiSelectPicklistUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,IAAI,CAON"}

package/dist/data/multiSelectPicklistUtils.js

@@ -0,0 +1,51 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Serializes MultiSelectPicklist fields in a Dataverse record before sending to the API.
+ *
+ * The Dataverse Web API expects MultiSelectPicklist values as comma-separated strings
+ * (e.g. `"100,200,300"`), but the generated TypeScript types represent them as number arrays
+ * (e.g. `[100, 200, 300]`). This function converts any listed field whose current value is an
+ * array into that wire format. An empty array is serialized as `null` because Dataverse rejects
+ * an empty string for this column type — `null` is the correct way to clear the field.
+ *
+ * A shallow copy of the record is returned so the caller's object is not mutated.
+ *
+ * @param record - The record being sent to `createRecordAsync` or `updateRecordAsync`.
+ * @param fields - Names of all MultiSelectPicklist columns declared on this entity.
+ * @returns A new record object with array-valued picklist fields replaced by comma-separated strings,
+ *   or `null` for empty arrays.
+ */
+export function serializeMultiSelectPicklistFields(record, fields) {
+    const result = { ...record };
+    for (const field of fields) {
+        if (Array.isArray(result[field])) {
+            const arr = result[field];
+            // Dataverse requires null (not an empty string) to clear a MultiSelectPicklist field.
+            result[field] = arr.length > 0 ? arr.join(',') : null;
+        }
+    }
+    return result;
+}
+/**
+ * Deserializes MultiSelectPicklist fields in a Dataverse record returned from the API.
+ *
+ * The Dataverse Web API returns MultiSelectPicklist values as comma-separated strings
+ * (e.g. `"100,200,300"`), but the generated TypeScript types represent them as number arrays.
+ * This function mutates the record in place, converting each listed field from its wire format
+ * back to an array. An empty string (`""`) is treated as an empty array.
+ *
+ * @param record - The record returned by `retrieveRecordAsync` or `retrieveMultipleRecordsAsync`.
+ *                 Mutated in place.
+ * @param fields - Names of all MultiSelectPicklist columns declared on this entity.
+ */
+export function deserializeMultiSelectPicklistFields(record, fields) {
+    for (const field of fields) {
+        const value = record[field];
+        if (typeof value === 'string') {
+            record[field] = value !== '' ? value.split(',').map(Number) : [];
+        }
+    }
+}
+//# sourceMappingURL=multiSelectPicklistUtils.js.map

package/dist/data/multiSelectPicklistUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiSelectPicklistUtils.js","sourceRoot":"","sources":["../../src/data/multiSelectPicklistUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kCAAkC,CAChD,MAA+B,EAC/B,MAAyB;IAEzB,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAa,CAAC;YACtC,sFAAsF;YACtF,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oCAAoC,CAClD,MAA+B,EAC/B,MAAyB;IAEzB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import * as app from './app/index';
+import * as data from './data/index';
+import * as telemetry from './telemetry/index';
+export { app, data, telemetry };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import * as app from './app/index';
+import * as data from './data/index';
+import * as telemetry from './telemetry/index';
+export { app, data, telemetry };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC"}

package/dist/internal/communication/getAppConnections.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { type AppDataSourceConfig } from '@microsoft/apps-common/communication';
+/**
+ * Fetch the app's resolved connection configs from the host, keyed by entity
+ * (data source) name. Keys are normalized to lowercase to match existing SDK
+ * lookup conventions.
+ */
+export declare function getAppConnections(): Promise<Record<string, AppDataSourceConfig>>;
+//# sourceMappingURL=getAppConnections.d.ts.map

package/dist/internal/communication/getAppConnections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAppConnections.d.ts","sourceRoot":"","sources":["../../../src/internal/communication/getAppConnections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAW,MAAM,sCAAsC,CAAC;AAIzF;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAStF"}

package/dist/internal/communication/getAppConnections.js

@@ -0,0 +1,20 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { Methods } from '@microsoft/apps-common/communication';
+import { getSdkChannel } from '../sdkChannel';
+/**
+ * Fetch the app's resolved connection configs from the host, keyed by entity
+ * (data source) name. Keys are normalized to lowercase to match existing SDK
+ * lookup conventions.
+ */
+export async function getAppConnections() {
+    const channel = await getSdkChannel();
+    const result = await channel.send(Methods.Data.getAppConnections);
+    const lowercased = {};
+    for (const [key, value] of Object.entries(result)) {
+        lowercased[key.toLowerCase()] = value;
+    }
+    return lowercased;
+}
+//# sourceMappingURL=getAppConnections.js.map

package/dist/internal/communication/getAppConnections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAppConnections.js","sourceRoot":"","sources":["../../../src/internal/communication/getAppConnections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA4B,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAEzF,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAElE,MAAM,UAAU,GAAwC,EAAE,CAAC;IAC3D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/internal/communication/index.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Centralized JSON-RPC channel helpers. All host-facing calls in this package
+ * should go through this folder so the channel surface stays auditable.
+ */
+export { getAppConnections } from './getAppConnections';
+export { sendHttpRequest } from './sendHttpRequest';
+export { trackEvent } from './trackEvent';
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/communication/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/communication/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/internal/communication/index.js

@@ -0,0 +1,11 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Centralized JSON-RPC channel helpers. All host-facing calls in this package
+ * should go through this folder so the channel surface stays auditable.
+ */
+export { getAppConnections } from './getAppConnections';
+export { sendHttpRequest } from './sendHttpRequest';
+export { trackEvent } from './trackEvent';
+//# sourceMappingURL=index.js.map

package/dist/internal/communication/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/communication/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/internal/communication/sendHttpRequest.d.ts

@@ -0,0 +1,17 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { type HttpSendParams, type HttpSendResult } from '@microsoft/apps-common/communication';
+/**
+ * Send an HTTP request through the host's JSON-RPC channel.
+ *
+ * The host validates the URL against resolved connection origins, injects
+ * the appropriate Authorization header via its auth middleware, and runs
+ * the request through retry/circuit-breaker/tracking middleware. Network
+ * metrics are reported automatically — the SDK does not need to track them.
+ *
+ * Binary request bodies should be passed as base64 with `bodyEncoding: 'base64'`.
+ * Binary response bodies arrive base64-encoded with `bodyEncoding: 'base64'`.
+ */
+export declare function sendHttpRequest(params: HttpSendParams): Promise<HttpSendResult>;
+//# sourceMappingURL=sendHttpRequest.d.ts.map

package/dist/internal/communication/sendHttpRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendHttpRequest.d.ts","sourceRoot":"","sources":["../../../src/internal/communication/sendHttpRequest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EAEpB,MAAM,sCAAsC,CAAC;AAI9C;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAGrF"}

package/dist/internal/communication/sendHttpRequest.js

@@ -0,0 +1,21 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { Methods, } from '@microsoft/apps-common/communication';
+import { getSdkChannel } from '../sdkChannel';
+/**
+ * Send an HTTP request through the host's JSON-RPC channel.
+ *
+ * The host validates the URL against resolved connection origins, injects
+ * the appropriate Authorization header via its auth middleware, and runs
+ * the request through retry/circuit-breaker/tracking middleware. Network
+ * metrics are reported automatically — the SDK does not need to track them.
+ *
+ * Binary request bodies should be passed as base64 with `bodyEncoding: 'base64'`.
+ * Binary response bodies arrive base64-encoded with `bodyEncoding: 'base64'`.
+ */
+export async function sendHttpRequest(params) {
+    const channel = await getSdkChannel();
+    return channel.send(Methods.Http.send, params);
+}
+//# sourceMappingURL=sendHttpRequest.js.map

package/dist/internal/communication/sendHttpRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendHttpRequest.js","sourceRoot":"","sources":["../../../src/internal/communication/sendHttpRequest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGL,OAAO,GACR,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAsB;IAC1D,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/internal/communication/trackEvent.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Send a structured telemetry event to the host.
+ *
+ * Fire-and-forget. Errors during the call (channel unavailable, etc.) are
+ * swallowed so logger failures never break the app.
+ */
+export declare function trackEvent(eventName: string, properties?: Record<string, unknown>): void;
+//# sourceMappingURL=trackEvent.d.ts.map

package/dist/internal/communication/trackEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackEvent.d.ts","sourceRoot":"","sources":["../../../src/internal/communication/trackEvent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQxF"}

package/dist/internal/communication/trackEvent.js

@@ -0,0 +1,21 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { Methods } from '@microsoft/apps-common/communication';
+import { getSdkChannel } from '../sdkChannel';
+/**
+ * Send a structured telemetry event to the host.
+ *
+ * Fire-and-forget. Errors during the call (channel unavailable, etc.) are
+ * swallowed so logger failures never break the app.
+ */
+export function trackEvent(eventName, properties) {
+    getSdkChannel()
+        .then((channel) => {
+        channel.notify(Methods.Telemetry.trackEvent, { eventName, properties });
+    })
+        .catch(() => {
+        // Channel unavailable — silently degrade.
+    });
+}
+//# sourceMappingURL=trackEvent.js.map

package/dist/internal/communication/trackEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackEvent.js","sourceRoot":"","sources":["../../../src/internal/communication/trackEvent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,UAAoC;IAChF,aAAa,EAAE;SACZ,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAChB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,0CAA0C;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/internal/sdkChannel.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { type Channel } from '@microsoft/apps-common/communication';
+/**
+ * Get or create the App SDK's dedicated channel to the host.
+ *
+ * When `window.__platformBridge` is available (runtime — bridge script injected
+ * by the gateway), the bridge's `initialize()` method creates the channel.
+ *
+ * When the bridge is absent (authoring — no bridge script), the SDK falls back
+ * to creating a MessageChannel directly and transferring a port to the host
+ * via `window.parent.postMessage`.
+ *
+ * The channel is cached — subsequent calls return the same instance.
+ */
+export declare function getSdkChannel(): Promise<Channel>;
+//# sourceMappingURL=sdkChannel.d.ts.map

package/dist/internal/sdkChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkChannel.d.ts","sourceRoot":"","sources":["../../src/internal/sdkChannel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,OAAO,EAKb,MAAM,sCAAsC,CAAC;AAI9C;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAKhD"}

package/dist/internal/sdkChannel.js

@@ -0,0 +1,42 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { createChannelReceiver, MessagePortChannel, PortTransferType, transferPort, } from '@microsoft/apps-common/communication';
+let sdkChannelPromise = null;
+/**
+ * Get or create the App SDK's dedicated channel to the host.
+ *
+ * When `window.__platformBridge` is available (runtime — bridge script injected
+ * by the gateway), the bridge's `initialize()` method creates the channel.
+ *
+ * When the bridge is absent (authoring — no bridge script), the SDK falls back
+ * to creating a MessageChannel directly and transferring a port to the host
+ * via `window.parent.postMessage`.
+ *
+ * The channel is cached — subsequent calls return the same instance.
+ */
+export function getSdkChannel() {
+    if (!sdkChannelPromise) {
+        sdkChannelPromise = initSdkChannel();
+    }
+    return sdkChannelPromise;
+}
+async function initSdkChannel() {
+    // Create a receiver for host → SDK actions (subscriptions, push updates)
+    const sdkReceiver = createChannelReceiver();
+    if (window.__platformBridge) {
+        // Runtime: bridge script is injected, use it
+        return window.__platformBridge.connect(sdkReceiver);
+    }
+    // Authoring fallback: no bridge script, self-initialize via window.parent
+    const { port1, port2 } = new MessageChannel();
+    transferPort(window.parent, port2, PortTransferType.SdkPort, '*');
+    const channel = new MessagePortChannel(port1, {
+        receiver: sdkReceiver,
+        component: 'app-sdk',
+        componentVersion: '0.1.0',
+    });
+    await channel.connect();
+    return channel;
+}
+//# sourceMappingURL=sdkChannel.js.map

package/dist/internal/sdkChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkChannel.js","sourceRoot":"","sources":["../../src/internal/sdkChannel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,sCAAsC,CAAC;AAE9C,IAAI,iBAAiB,GAA4B,IAAI,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iBAAiB,GAAG,cAAc,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,yEAAyE;IACzE,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;IAC5C,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,6CAA6C;QAC7C,OAAO,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtD,CAAC;IAED,0EAA0E;IAC1E,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,cAAc,EAAE,CAAC;IAE9C,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,KAAK,EAAE;QAC5C,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,SAAS;QACpB,gBAAgB,EAAE,OAAO;KAC1B,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/internal/telemetry.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Send a telemetry event to the host.
+ *
+ * Fire-and-forget — does not await channel readiness synchronously.
+ * The event is queued if the channel isn't ready yet.
+ */
+export declare function trackEvent(eventName: string, properties?: Record<string, unknown>): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/internal/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/internal/telemetry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIxF"}

package/dist/internal/telemetry.js

@@ -0,0 +1,17 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { Methods } from '@microsoft/apps-common/communication';
+import { getSdkChannel } from './sdkChannel';
+/**
+ * Send a telemetry event to the host.
+ *
+ * Fire-and-forget — does not await channel readiness synchronously.
+ * The event is queued if the channel isn't ready yet.
+ */
+export function trackEvent(eventName, properties) {
+    getSdkChannel().then((channel) => {
+        channel.notify(Methods.Telemetry.trackEvent, { eventName, properties });
+    });
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/internal/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/internal/telemetry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,UAAoC;IAChF,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/telemetry/Logger.types.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { Metric } from '@microsoft/apps-common/metrics';
+/**
+ * Developer-facing logger interface.
+ *
+ * App developers provide an implementation via initializeLogger() or setConfig().
+ * The logger receives structured metrics streamed from the host (session load,
+ * network requests, data request summaries).
+ */
+export interface ILogger {
+    /** Receive a structured metric from the host. */
+    logMetric?(value: Metric): void;
+}
+//# sourceMappingURL=Logger.types.d.ts.map

package/dist/telemetry/Logger.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.types.d.ts","sourceRoot":"","sources":["../../src/telemetry/Logger.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,iDAAiD;IACjD,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC"}

package/dist/telemetry/Logger.types.js

@@ -0,0 +1,5 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=Logger.types.js.map

package/dist/telemetry/Logger.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.types.js","sourceRoot":"","sources":["../../src/telemetry/Logger.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/telemetry/LoggerManager.d.ts

@@ -0,0 +1,17 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ILogger } from './Logger.types';
+/**
+ * Initialize the developer logger and subscribe to host metric streaming.
+ *
+ * When called, the SDK subscribes to Telemetry.subscribeMetrics via the
+ * channel's stream() method. The host yields metrics as they're collected
+ * (network requests, session load, data request summaries). Each metric
+ * is forwarded to the developer's ILogger.logMetric().
+ *
+ * The subscription runs in the background — this function starts the
+ * stream consumer and returns immediately.
+ */
+export declare function initializeLogger(logger: ILogger): void;
+//# sourceMappingURL=LoggerManager.d.ts.map

package/dist/telemetry/LoggerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerManager.d.ts","sourceRoot":"","sources":["../../src/telemetry/LoggerManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAKtD"}