@casual-simulation/aux-runtime 3.2.13 → 3.2.14-alpha.7893057655

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@casual-simulation/aux-runtime",
-    "version": "3.2.13",
+    "version": "3.2.14-alpha.7893057655",
     "description": "Runtime for AUX projects",
     "main": "index.js",
     "types": "index.d.ts",
@@ -32,8 +32,8 @@
         "access": "public"
     },
     "dependencies": {
-        "@casual-simulation/aux-common": "^3.2.12",
-        "@casual-simulation/aux-records": "^3.2.13",
+        "@casual-simulation/aux-common": "^3.2.14-alpha.7893057655",
+        "@casual-simulation/aux-records": "^3.2.14-alpha.7893057655",
         "@casual-simulation/crypto": "^3.2.7",
         "@casual-simulation/engine262": "0.0.1-4de2170374e22761996e46eb1362f4496ee57f8f",
         "@casual-simulation/error-stack-parser": "^2.0.7",
@@ -79,5 +79,5 @@
         "**/*.d.ts",
         "**/*.def"
     ],
-    "gitHead": "552756631484a984db430ca842834a1a08935f38"
+    "gitHead": "937496446cf48d34fd5e0da41a53b4616b386f1b"
 }

package/runtime/AuxLibrary.d.ts

@@ -1,6 +1,6 @@
 import { AuxGlobalContext, DEBUG_STRING } from './AuxGlobalContext';
-import { BotTags, Bot, ShowChatOptions, BotAction, BotsState, CameraType, BarcodeFormat, PortalType, ShowInputOptions, LocalFormAnimationAction, ShareOptions, Easing, BotAnchorPoint, RuntimeBot, BotSpace, EaseType, RegisterPrefixOptions, OpenCircleWipeOptions, SuperShoutAction, ShowToastAction, ShowJoinCodeAction, RequestFullscreenAction, ExitFullscreenAction, ShowHtmlAction, HideHtmlAction, SetClipboardAction, FocusOnBotAction, ShowChatBarAction, EnableARAction, EnableVRAction, DownloadAction, ShowUploadAuxFileAction, OpenQRCodeScannerAction, ShowQRCodeAction, OpenBarcodeScannerAction, ShowBarcodeAction, LoadServerAction, UnloadServerAction, ReplaceDragBotAction, ShowInputForTagAction, GoToDimensionAction, GoToURLAction, OpenURLAction, OpenConsoleAction, RejectAction, FocusOnOptions, SnapTarget, AddDropSnapTargetsAction, RecordingOptions, Recording, SyntheticVoice, EnablePOVAction, EnableCustomDraggingAction, SetAppOutputAction, Record, RecordReference, PartialBotsState, ParsedBotLink, ConvertGeolocationToWhat3WordsOptions, BeginAudioRecordingAction, MediaPermssionOptions, ImageClassifierOptions, AddDropGridTargetsAction, InstUpdate, StartFormAnimationOptions, StopFormAnimationOptions, FormAnimationData, WakeLockConfiguration, EnableXROptions, ShowConfirmOptions, Geolocation, OpenPhotoCameraOptions, Photo } from '@casual-simulation/aux-common/bots';
-import { AIChatOptions, AIGenerateSkyboxOptions, AIGenerateImageOptions, JoinRoomActionOptions, RoomOptions, RoomTrackOptions, SetRoomTrackOptions, RoomRemoteOptions, DataRecordOptions, RecordActionOptions } from './RecordsEvents';
+import { BotTags, Bot, ShowChatOptions, BotAction, BotsState, CameraType, BarcodeFormat, PortalType, ShowInputOptions, LocalFormAnimationAction, ShareOptions, Easing, BotAnchorPoint, RuntimeBot, BotSpace, EaseType, RegisterPrefixOptions, OpenCircleWipeOptions, SuperShoutAction, ShowToastAction, ShowJoinCodeAction, RequestFullscreenAction, ExitFullscreenAction, ShowHtmlAction, HideHtmlAction, SetClipboardAction, FocusOnBotAction, ShowChatBarAction, EnableARAction, EnableVRAction, DownloadAction, ShowUploadAuxFileAction, OpenQRCodeScannerAction, ShowQRCodeAction, OpenBarcodeScannerAction, ShowBarcodeAction, LoadServerAction, UnloadServerAction, ReplaceDragBotAction, ShowInputForTagAction, GoToDimensionAction, GoToURLAction, OpenURLAction, OpenConsoleAction, RejectAction, FocusOnOptions, SnapTarget, AddDropSnapTargetsAction, RecordingOptions, Recording, SyntheticVoice, EnablePOVAction, EnableCustomDraggingAction, SetAppOutputAction, PartialBotsState, ParsedBotLink, ConvertGeolocationToWhat3WordsOptions, BeginAudioRecordingAction, MediaPermssionOptions, ImageClassifierOptions, AddDropGridTargetsAction, InstUpdate, StartFormAnimationOptions, StopFormAnimationOptions, FormAnimationData, WakeLockConfiguration, EnableXROptions, ShowConfirmOptions, Geolocation, OpenPhotoCameraOptions, Photo } from '@casual-simulation/aux-common/bots';
+import { AIChatOptions, AIGenerateSkyboxOptions, AIGenerateImageOptions, JoinRoomActionOptions, RoomOptions, RoomTrackOptions, SetRoomTrackOptions, RoomRemoteOptions, DataRecordOptions, RecordActionOptions, ListDataOptions } from './RecordsEvents';
 import { RemoteAction, AvailablePermissions } from '@casual-simulation/aux-common';
 import '@casual-simulation/aux-common/polyfill/Array.first.polyfill';
 import '@casual-simulation/aux-common/polyfill/Array.last.polyfill';
@@ -10,8 +10,8 @@ import '@casual-simulation/aux-common/BlobPolyfill';
 import { AuxDevice } from './AuxDevice';
 import { AuxVersion } from './AuxVersion';
 import { Vector3, Vector2, Quaternion, Rotation } from '@casual-simulation/aux-common/math';
-import { CreatePublicRecordKeyResult, GetDataResult, RecordDataResult, RecordFileFailure, EraseDataResult, EraseFileResult, ListDataResult, AddCountResult, GetCountResult, GrantMarkerPermissionResult, RevokeMarkerPermissionResult, GrantRoleResult, RevokeRoleResult } from '@casual-simulation/aux-records';
-import type { AIChatMessage, ListStudiosResult } from '@casual-simulation/aux-records';
+import { CreatePublicRecordKeyResult, GetDataResult, RecordDataResult, RecordFileFailure, EraseDataResult, EraseFileResult, ListDataResult, AddCountResult, GetCountResult, GrantMarkerPermissionResult, GrantRoleResult, RevokeRoleResult } from '@casual-simulation/aux-records';
+import type { AIChatMessage, GrantResourcePermissionResult, ListStudiosResult, RevokePermissionResult } from '@casual-simulation/aux-records';
 import { DateTime } from 'luxon';
 import * as hooks from 'preact/hooks';
 import { render } from 'preact';
@@ -273,25 +273,6 @@ export interface BotFilterFunction {
     sort?: (bot: Bot) => any;
     [DEBUG_STRING]?: string;
 }
-export interface RecordFilter {
-    recordFilter: true;
-    [DEBUG_STRING]?: string;
-}
-export interface AuthIdRecordFilter extends RecordFilter {
-    authID: string;
-}
-export interface SpaceFilter extends BotFilterFunction, RecordFilter {
-    space: string;
-    toJSON: () => RecordFilter;
-}
-export interface AddressRecordFilter extends RecordFilter {
-    address: string;
-}
-export interface IDRecordFilter extends BotFilterFunction, RecordFilter {
-    id: string;
-    toJSON: () => RecordFilter;
-}
-export type RecordFilters = AuthIdRecordFilter | SpaceFilter | AddressRecordFilter | IDRecordFilter | RecordReference;
 /**
  * Defines the options for {@link experiment.speakText}.
  *
@@ -377,27 +358,6 @@ export interface TagSpecificApiOptions {
      */
     config: RuntimeBot;
 }
-/**
- * Defines an interface that represents a set of records that were retrieved.
- */
-export interface GetRecordsResult {
-    /**
-     * The set of records that were retrieved.
-     */
-    records: Record[];
-    /**
-     * The total number of records that the query would have returned.
-     */
-    totalCount: number;
-    /**
-     * Whether there are more records available to retrieve for the query.
-     */
-    hasMoreRecords: boolean;
-    /**
-     * Gets the set page of records.
-     */
-    getMoreRecords(): Promise<GetRecordsResult>;
-}
 export declare const GET_RUNTIME: unique symbol;
 /**
  * Defines an interface for objects that represent a debugger and can retrieve their internal runtime.
@@ -1618,6 +1578,9 @@ export interface SetRoomOptionsSuccess {
 }
 /**
  * Defines an interface that represents a failed "set room options" request.
+ *
+ * @dochash types/os/portals
+ * @docname SetRoomOptionsFailure
  */
 export interface SetRoomOptionsFailure {
     success: false;
@@ -1874,6 +1837,9 @@ export interface RaycastResult {
 }
 /**
  * Defines an interface that represents the intersection of a bot and ray.
+ *
+ * @dochash types/os/portals
+ * @docname BotIntersection
  */
 export interface BotIntersection {
     /**
@@ -2340,8 +2306,8 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             requestAuthBotInBackground: () => Promise<Bot>;
             getPublicRecordKey: (name: string) => Promise<CreatePublicRecordKeyResult>;
             getSubjectlessPublicRecordKey: (name: string) => Promise<CreatePublicRecordKeyResult>;
-            grantRecordMarkerPermission: (recordName: string, marker: string, permission: AvailablePermissions, options?: RecordActionOptions) => Promise<GrantMarkerPermissionResult>;
-            revokeRecordMarkerPermission: (recordName: string, marker: string, permission: AvailablePermissions, options?: RecordActionOptions) => Promise<RevokeMarkerPermissionResult>;
+            grantPermission: (recordName: string, permission: AvailablePermissions, options?: RecordActionOptions) => Promise<GrantMarkerPermissionResult | GrantResourcePermissionResult>;
+            revokePermission: (recordName: string, permissionId: string, options?: RecordActionOptions) => Promise<RevokePermissionResult>;
             grantInstAdminPermission: (recordName: string, options?: RecordActionOptions) => Promise<GrantRoleResult>;
             grantUserRole: (recordName: string, role: string, userId: string, expireTimeMs?: number, options?: RecordActionOptions) => Promise<GrantRoleResult>;
             revokeUserRole: (recordName: string, role: string, userId: string, options?: RecordActionOptions) => Promise<RevokeRoleResult>;
@@ -2353,6 +2319,7 @@ export declare function createDefaultLibrary(context: AuxGlobalContext): {
             getData: (recordKeyOrName: string, address: string, endpoint?: string) => Promise<GetDataResult>;
             getManualApprovalData: (recordKeyOrName: string, address: string, endpoint?: string) => Promise<GetDataResult>;
             listData: (recordKeyOrName: string, startingAddress?: string, endpoint?: string) => Promise<ListDataResult>;
+            listDataByMarker: (recordKeyOrName: string, marker: string, startingAddress?: string, options?: ListDataOptions) => Promise<ListDataResult>;
             eraseData: (recordKeyOrName: string, address: string, endpoint?: string) => Promise<EraseDataResult>;
             eraseManualApprovalData: (recordKeyOrName: string, address: string, endpoint?: string) => Promise<EraseDataResult>;
             recordFile: (recordKeyOrName: string, data: any, options?: RecordFileOptions, endpoint?: string) => Promise<RecordFileApiResult>;

package/runtime/AuxLibrary.js

@@ -20,7 +20,7 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 import { DEBUG_STRING, debugStringifyFunction, } from './AuxGlobalContext';
 import { hasValue, trimTag, isBot, BOT_SPACE_TAG, toast as toastMessage, tip as tipMessage, hideTips as hideTipMessages, showJoinCode as calcShowJoinCode, requestFullscreen, exitFullscreen, html as htmlMessage, hideHtml as hideHtmlMessage, setClipboard as calcSetClipboard, tweenTo as calcTweenTo, showChat as calcShowChat, hideChat as calcHideChat, runScript, getMediaPermission as calcGetMediaPermission, getAverageFrameRate as calcGetAverageFrameRate, enableAR as calcEnableAR, disableAR as calcDisableAR, enableVR as calcEnableVR, disableVR as calcDisableVR, arSupported as calcARSupported, vrSupported as calcVRSupported, showUploadAuxFile as calcShowUploadAuxFile, openQRCodeScanner as calcOpenQRCodeScanner, showQRCode as calcShowQRCode, openBarcodeScanner as calcOpenBarcodeScanner, showBarcode as calcShowBarcode, importAUX as calcImportAUX, showInputForTag as calcShowInputForTag, showInput as calcShowInput, showConfirm as calcShowConfirm, replaceDragBot as calcReplaceDragBot, goToDimension as calcGoToDimension, goToURL as calcGoToURL, openURL as calcOpenURL, playSound as calcPlaySound, bufferSound as calcBufferSound, cancelSound as calcCancelSound, shell as calcShell, reject as calcReject, localFormAnimation as calcLocalFormAnimation, webhook as calcWebhook, superShout as calcSuperShout, share as calcShare, registerPrefix as calcRegisterPrefix, localPositionTween as calcLocalPositionTween, localRotationTween as calcLocalRotationTween, showUploadFiles as calcShowUploadFiles, download, loadSimulation, unloadSimulation, getUploadState, addState, getPortalTag, KNOWN_PORTALS, openConsole, tagsOnBot, getOriginalObject, getBotSpace, trimEvent, CREATE_ACTION_NAME, CREATE_ANY_ACTION_NAME, DESTROY_ACTION_NAME, ORIGINAL_OBJECT, getRemoteCount, getRemotes, listInstUpdates as calcListInstUpdates, getInstStateFromUpdates as calcGetInstStateFromUpdates, action, calculateAnchorPoint, calculateAnchorPointOffset, getBotPosition as calcGetBotPosition, getBotRotation as calcGetBotRotation, isRuntimeBot, SET_TAG_MASK_SYMBOL, CLEAR_TAG_MASKS_SYMBOL, getBotScale, EDIT_TAG_SYMBOL, EDIT_TAG_MASK_SYMBOL, circleWipe, addDropSnap as calcAddDropSnap, addDropGrid as calcAddDropGrid, animateToPosition, beginAudioRecording as calcBeginAudioRecording, endAudioRecording as calcEndAudioRecording, beginRecording as calcBeginRecording, endRecording as calcEndRecording, speakText as calcSpeakText, getVoices as calcGetVoices, getGeolocation as calcGetGeolocation, cancelAnimation, disablePOV, enablePOV, enableCustomDragging as calcEnableCustomDragging, MINI_PORTAL, registerCustomApp, setAppOutput, unregisterCustomApp, requestAuthData as calcRequestAuthData, createBot, defineGlobalBot as calcDefineGlobalBot, TEMPORARY_BOT_PARTITION_ID, convertToString, GET_TAG_MASKS_SYMBOL, isBotLink, parseBotLink, createBotLink, convertGeolocationToWhat3Words as calcConvertGeolocationToWhat3Words, meetCommand as calcMeetCommand, meetFunction as calcMeetFunction, openImageClassifier as calcOpenImageClassifier, isBotDate, DATE_TAG_PREFIX, parseBotDate, realNumberOrDefault, raycastFromCamera as calcRaycastFromCamera, raycastInPortal as calcRaycastInPortal, calculateRayFromCamera as calcCalculateRayFromCamera, bufferFormAddressGltf, startFormAnimation as calcStartFormAnimation, stopFormAnimation as calcStopFormAnimation, listFormAnimations as calcListFormAnimations, calculateStringTagValue, createInitializationUpdate as calcCreateInitalizationUpdate, applyUpdatesToInst as calcApplyUpdatesToInst, configureWakeLock, getWakeLockConfiguration as calcGetWakeLockConfiguration, analyticsRecordEvent as calcAnalyticsRecordEvent, KNOWN_TAGS, isStoredVersion2, getCurrentInstUpdate as calcGetCurrentInstUpdate, openPhotoCamera as calcOpenPhotoCamera, getEasing, enableCollaboration as calcEnableCollaboration, reportInst as calcReportInst, } from '@casual-simulation/aux-common/bots';
-import { aiChat, aiGenerateSkybox, aiGenerateImage, grantRecordMarkerPermission as calcGrantRecordMarkerPermission, revokeRecordMarkerPermission as calcRevokeRecordMarkerPermission, grantInstAdminPermission as calcGrantInstAdminPermission, grantUserRole as calcGrantUserRole, revokeUserRole as calcRevokeUserRole, grantInstRole as calcGrantInstRole, revokeInstRole as calcRevokeInstRole, listUserStudios as calcListUserStudios, joinRoom as calcJoinRoom, leaveRoom as calcLeaveRoom, setRoomOptions as calcSetRoomOptions, getRoomOptions as calcGetRoomOptions, getRoomTrackOptions as calcGetRoomTrackOptions, setRoomTrackOptions as calcSetRoomTrackOptions, getRoomRemoteOptions as calcGetRoomRemoteOptions, listDataRecord, recordEvent as calcRecordEvent, getEventCount as calcGetEventCount, getFile as calcGetFile, eraseFile as calcEraseFile, getPublicRecordKey as calcGetPublicRecordKey, recordData as calcRecordData, getRecordData, eraseRecordData, recordFile as calcRecordFile, } from './RecordsEvents';
+import { aiChat, aiGenerateSkybox, aiGenerateImage, grantRecordPermission as calcGrantRecordPermission, revokeRecordPermission as calcRevokeRecordPermission, grantInstAdminPermission as calcGrantInstAdminPermission, grantUserRole as calcGrantUserRole, revokeUserRole as calcRevokeUserRole, grantInstRole as calcGrantInstRole, revokeInstRole as calcRevokeInstRole, listUserStudios as calcListUserStudios, joinRoom as calcJoinRoom, leaveRoom as calcLeaveRoom, setRoomOptions as calcSetRoomOptions, getRoomOptions as calcGetRoomOptions, getRoomTrackOptions as calcGetRoomTrackOptions, setRoomTrackOptions as calcSetRoomTrackOptions, getRoomRemoteOptions as calcGetRoomRemoteOptions, listDataRecord, recordEvent as calcRecordEvent, getEventCount as calcGetEventCount, getFile as calcGetFile, eraseFile as calcEraseFile, getPublicRecordKey as calcGetPublicRecordKey, recordData as calcRecordData, getRecordData, eraseRecordData, recordFile as calcRecordFile, listDataRecordByMarker, } from './RecordsEvents';
 import { sortBy, every, cloneDeep, union, isEqual, flatMap, } from 'lodash';
 import { remote as calcRemote, DEFAULT_BRANCH_NAME, } from '@casual-simulation/aux-common';
 import { RanOutOfEnergyError } from './AuxResults';
@@ -532,8 +532,8 @@ export function createDefaultLibrary(context) {
                 requestAuthBotInBackground,
                 getPublicRecordKey,
                 getSubjectlessPublicRecordKey,
-                grantRecordMarkerPermission,
-                revokeRecordMarkerPermission,
+                grantPermission,
+                revokePermission,
                 grantInstAdminPermission,
                 grantUserRole,
                 revokeUserRole,
@@ -545,6 +545,7 @@ export function createDefaultLibrary(context) {
                 getData,
                 getManualApprovalData,
                 listData,
+                listDataByMarker,
                 eraseData,
                 eraseManualApprovalData,
                 recordFile,
@@ -4605,41 +4606,39 @@ export function createDefaultLibrary(context) {
         return addAsyncAction(task, event);
     }
     /**
-     * Grants the given marker the given permission in the given record.
+     * Grants the given permission in the given record.
      *
      * See [Record Security](page:learn/records/security) for more information.
      *
      * @param recordName the name of the record.
-     * @param marker the marker that the permission should be added to.
      * @param permission the permission that should be added.
      * @param options the options for the operation.
      *
      * @dochash actions/os/records
      * @docgroup 01-records
-     * @docname os.grantRecordMarkerPermission
+     * @docname os.grantPermission
      */
-    function grantRecordMarkerPermission(recordName, marker, permission, options) {
+    function grantPermission(recordName, permission, options) {
         const task = context.createTask();
-        const event = calcGrantRecordMarkerPermission(recordName, marker, permission, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcGrantRecordPermission(recordName, permission, options !== null && options !== void 0 ? options : {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
-     * Revokes the given permission from the given marker in the given record.
+     * Revokes the permission with the given ID from the the given record.
      *
      * See [Record Security](page:learn/records/security) for more information.
      *
      * @param recordName the name of the record.
-     * @param marker the name of the marker that the permission should be removed from.
-     * @param permission the permission that should be removed.
+     * @param permissionId the ID of the permission that should be removed.
      * @param options the options for the operation.
      *
      * @dochash actions/os/records
      * @docgroup 01-records
-     * @docname os.revokeRecordMarkerPermission
+     * @docname os.revokePermission
      */
-    function revokeRecordMarkerPermission(recordName, marker, permission, options) {
+    function revokePermission(recordName, permissionId, options) {
         const task = context.createTask();
-        const event = calcRevokeRecordMarkerPermission(recordName, marker, permission, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcRevokeRecordPermission(recordName, permissionId, options !== null && options !== void 0 ? options : {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -4783,6 +4782,26 @@ export function createDefaultLibrary(context) {
      *     os.toast("Failed " + result.errorMessage);
      * }
      *
+     * @example Record data to the user's personal record
+     * const result = await os.recordData(authBot.id, 'myAddress', 'myData');
+     *
+     * if (result.success) {
+     *     os.toast("Success!");
+     * } else {
+     *     os.toast("Failed " + result.errorMessage);
+     * }
+     *
+     * @example Record data with a custom marker
+     * const result = await os.recordData(authBot.id, 'myAddress', 'myData', {
+     *     marker: 'myMarker'
+     * });
+     *
+     * if (result.success) {
+     *     os.toast("Success!");
+     * } else {
+     *     os.toast("Failed " + result.errorMessage);
+     * }
+     *
      * @dochash actions/os/records
      * @docgroup 01-records
      * @docname os.recordData
@@ -4961,6 +4980,76 @@ export function createDefaultLibrary(context) {
         const event = listDataRecord(recordName, startingAddress, options, task.taskId);
         return addAsyncAction(task, event);
     }
+    /**
+     * Gets a partial list of [data](glossary:data-record) with the given marker that is stored in the given record.
+     * Optionally accepts the address before the first item that should be included in the list.
+     * Returns a promise that resolves with an object that contains the items (if successful) or information about the error that occurred.
+     *
+     * @param recordKeyOrName the record name or a record key. This indicates the record that the data should be retrieved from.
+     * Note that you don't need a record key in order to retrieve public data from a record. Using a record name will work just fine.
+     * @param marker The marker that needs to be assigned to the data items that should be included in the list.
+     * e.g. Using "publicRead" will return all data items with the "publicRead" marker.
+     * @param startingAddress the address after which items will be included in the list.
+     * Since items are ordered within the record by address, this can be used as way to iterate through all the data items in a record.
+     * If omitted, then the list will start with the first item.
+     * @param options The options for the operation.
+     *
+     * @example Get a list of publicRead data items in a record
+     * const result = await os.listDataByMarker('myRecord', 'publicRead');
+     * if (result.success) {
+     *     os.toast(result.items);
+     * } else {
+     *     os.toast("Failed " + result.errorMessage);
+     * }
+     *
+     * @example List all the items that have the publicRead marker in a record
+     * let lastAddress;
+     * let items = [];
+     * while(true) {
+     *     const result = await os.listDataByMarker('myRecord', 'publicRead', lastAddress);
+     *     if (result.success) {
+     *         console.log(result.items);
+     *         items.push(...result.items);
+     *         if (result.items.length > 0) {
+     *             lastAddress = result.items[result.items.length - 1].address;
+     *         } else {
+     *             // result.items is empty, so we can break out of the loop
+     *             break;
+     *         }
+     *     } else {
+     *         os.toast("Failed " + result.errorMessage);
+     *         break;
+     *     }
+     * }
+     *
+     * @example List publicRead items in descending order
+     * const result = await os.listDataByMarker('myRecord', 'publicRead', null, { sort: 'descending' });
+     * if (result.success) {
+     *     os.toast(result.items);
+     * } else {
+     *     os.toast("Failed " + result.errorMessage);
+     * }
+     *
+     * @example List publicRead items stored at "myContainer" in descending order
+     * const result = await os.listDataByMarker('myRecord', 'publicRead:myContainer', null, { sort: 'descending' });
+     * if (result.success) {
+     *     os.toast(result.items);
+     * } else {
+     *     os.toast("Failed " + result.errorMessage);
+     * }
+     *
+     * @dochash actions/os/records
+     * @docgroup 01-records
+     * @docname os.listDataByMarker
+     */
+    function listDataByMarker(recordKeyOrName, marker, startingAddress = null, options = {}) {
+        const recordName = isRecordKey(recordKeyOrName)
+            ? parseRecordKey(recordKeyOrName)[0]
+            : recordKeyOrName;
+        const task = context.createTask();
+        const event = listDataRecordByMarker(recordName, marker, startingAddress, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
     /**
      * Erases the [data](glossary:data-record) stored at the given address in the given [record](glossary:record).
      * Returns a promise that resolves with an object that contains the data (if successful) or information about the error that occurred.