@casual-simulation/aux-runtime 3.8.1 → 3.10.2

package/runtime/AuxLibrary.js

@@ -1,13 +1,16 @@
 import { DEBUG_STRING, debugStringifyFunction } from './AuxGlobalContext';
-import { hasValue, trimTag, isBot, BOT_SPACE_TAG, toast as toastMessage, getScriptIssues as scriptIssues, 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, showAlert as calcShowAlert, 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, classifyImages as calcOpenClassifyImages, 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, showAccountInfo as calcShowAccountInfo, reportInst as calcReportInst, getRecordsEndpoint as calcGetRecordsEndpoint, ldrawCountAddressBuildSteps as calcLdrawCountAddressBuildSteps, ldrawCountTextBuildSteps as calcLdrawCountTextBuildSteps, calculateViewportCoordinatesFromPosition as calcCalculateViewportCoordinatesFromPosition, calculateScreenCoordinatesFromViewportCoordinates as calcCalculateScreenCoordinatesFromViewportCoordinates, calculateViewportCoordinatesFromScreenCoordinates as calcCalculateViewportCoordinatesFromScreenCoordinates, capturePortalScreenshot as calcCapturePortalScreenshot, createStaticHtml as calcCreateStaticHtmlFromBots, recordLoom, watchLoom, getLoomMetadata, loadSharedDocument, installAuxFile as calcInstallAuxFile, calculateStringListTagValue, calculateScreenCoordinatesFromPosition as calcCalculateScreenCoordinatesFromPosition, addMapLayer as calcAddMapLayer, removeMapLayer as calcRemoveMapLayer, GET_DYNAMIC_LISTENERS_SYMBOL, ADD_BOT_LISTENER_SYMBOL, REMOVE_BOT_LISTENER_SYMBOL, trackConfigBotTags as calcTrackConfigBotTags, } from '@casual-simulation/aux-common/bots';
-import { aiChat, aiChatStream, aiListChatModels, aiGenerateSkybox, aiGenerateImage, grantRecordPermission as calcGrantRecordPermission, revokeRecordPermission as calcRevokeRecordPermission, listPermissions as calcListPermissions, grantInstAdminPermission as calcGrantInstAdminPermission, grantUserRole as calcGrantUserRole, revokeUserRole as calcRevokeUserRole, grantInstRole as calcGrantInstRole, revokeInstRole as calcRevokeInstRole, listUserStudios as calcListUserStudios, listStudioRecords as calcListStudioRecords, 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, aiHumeGetAccessToken, aiSloydGenerateModel, recordWebhook as calcRecordWebhook, getWebhook as calcGetWebhook, listWebhooks as calcListWebhooks, listWebhooksByMarker as calcListWebhooksByMarker, eraseWebhook as calcEraseWebhook, runWebhook as calcRunWebhook, recordNotification as calcRecordNotification, getNotification as calcGetNotification, listNotifications as calcListNotifications, listNotificationsByMarker as calcListNotificationsByMarker, eraseNotification as calcEraseNotification, subscribeToNotification as calcSubscribeToNotification, unsubscribeFromNotification as calcUnsubscribeFromNotification, sendNotification as calcSendNotification, listNotificationSubscriptions as calcListNotificationSubscriptions, listUserNotificationSubscriptions as calcListUserNotificationSubscriptions, aiOpenAICreateRealtimeSession, grantEntitlements as calcGrantEntitlements, recordPackageVersion as calcRecordPackageVersion, erasePackageVersion as calcErasePackageVersion, listPackageVersions as calcListPackageVersions, getPackageVersion as calcGetPackageVersion, recordPackageContainer as calcRecordPackageContainer, erasePackageContaienr as calcErasePackageContainer, listPackageContainers as calcListPackageContainers, listPackageContainersByMarker as calcListPackageContainersByMarker, getPackageContainer as calcGetPackageContainer, installPackage as calcInstallPackage, listInstalledPackages as calcListInstalledPackages, listInsts as calcListInsts, listInstsByMarker as calcListInstsByMarker, recordsCallProcedure, } from './RecordsEvents';
+import { hasValue, trimTag, isBot, BOT_SPACE_TAG, toast as toastMessage, getScriptIssues as scriptIssues, 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, generateQRCode as calcGenerateQRCode, openBarcodeScanner as calcOpenBarcodeScanner, showBarcode as calcShowBarcode, importAUX as calcImportAUX, showInputForTag as calcShowInputForTag, showInput as calcShowInput, showConfirm as calcShowConfirm, showAlert as calcShowAlert, 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, signOut as calcSignOut, 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, classifyImages as calcOpenClassifyImages, 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, showAccountInfo as calcShowAccountInfo, reportInst as calcReportInst, getRecordsEndpoint as calcGetRecordsEndpoint, ldrawCountAddressBuildSteps as calcLdrawCountAddressBuildSteps, ldrawCountTextBuildSteps as calcLdrawCountTextBuildSteps, calculateViewportCoordinatesFromPosition as calcCalculateViewportCoordinatesFromPosition, calculateScreenCoordinatesFromViewportCoordinates as calcCalculateScreenCoordinatesFromViewportCoordinates, calculateViewportCoordinatesFromScreenCoordinates as calcCalculateViewportCoordinatesFromScreenCoordinates, capturePortalScreenshot as calcCapturePortalScreenshot, createStaticHtml as calcCreateStaticHtmlFromBots, recordLoom, watchLoom, getLoomMetadata, loadSharedDocument, installAuxFile as calcInstallAuxFile, calculateStringListTagValue, calculateScreenCoordinatesFromPosition as calcCalculateScreenCoordinatesFromPosition, addMapLayer as calcAddMapLayer, removeMapLayer as calcRemoveMapLayer, GET_DYNAMIC_LISTENERS_SYMBOL, ADD_BOT_LISTENER_SYMBOL, REMOVE_BOT_LISTENER_SYMBOL, trackConfigBotTags as calcTrackConfigBotTags, } from '@casual-simulation/aux-common/bots';
+import { aiChat, aiChatStream, aiListChatModels, aiGenerateSkybox, aiGenerateImage, grantRecordPermission as calcGrantRecordPermission, revokeRecordPermission as calcRevokeRecordPermission, listPermissions as calcListPermissions, grantInstAdminPermission as calcGrantInstAdminPermission, grantUserRole as calcGrantUserRole, revokeUserRole as calcRevokeUserRole, grantInstRole as calcGrantInstRole, revokeInstRole as calcRevokeInstRole, listUserStudios as calcListUserStudios, listStudioRecords as calcListStudioRecords, 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, aiHumeGetAccessToken, aiSloydGenerateModel, recordWebhook as calcRecordWebhook, getWebhook as calcGetWebhook, listWebhooks as calcListWebhooks, listWebhooksByMarker as calcListWebhooksByMarker, eraseWebhook as calcEraseWebhook, runWebhook as calcRunWebhook, recordNotification as calcRecordNotification, getNotification as calcGetNotification, listNotifications as calcListNotifications, listNotificationsByMarker as calcListNotificationsByMarker, eraseNotification as calcEraseNotification, subscribeToNotification as calcSubscribeToNotification, unsubscribeFromNotification as calcUnsubscribeFromNotification, sendNotification as calcSendNotification, listNotificationSubscriptions as calcListNotificationSubscriptions, listUserNotificationSubscriptions as calcListUserNotificationSubscriptions, 
+// getXpUserMeta,
+// createXpContract,
+aiOpenAICreateRealtimeSession, grantEntitlements as calcGrantEntitlements, recordPackageVersion as calcRecordPackageVersion, erasePackageVersion as calcErasePackageVersion, listPackageVersions as calcListPackageVersions, getPackageVersion as calcGetPackageVersion, recordPackageContainer as calcRecordPackageContainer, erasePackageContaienr as calcErasePackageContainer, listPackageContainers as calcListPackageContainers, listPackageContainersByMarker as calcListPackageContainersByMarker, getPackageContainer as calcGetPackageContainer, installPackage as calcInstallPackage, listInstalledPackages as calcListInstalledPackages, listInsts as calcListInsts, listInstsByMarker as calcListInstsByMarker, recordsCallProcedure, recordStoreItem as calcRecordStoreItem, getStoreItem as calcGetStoreItem, eraseStoreItem as calcEraseStoreItem, listStoreItems as calcListStoreItems, listStoreItemsByMarker as calcListStoreItemsByMarker, purchaseStoreItem as calcPurchaseStoreItem, } from './RecordsEvents';
 import { sortBy, cloneDeep, union, isEqual } from 'es-toolkit/compat';
 import { remote as calcRemote, DEFAULT_BRANCH_NAME, formatVersionNumber, parseVersionNumber, PRIVATE_MARKER, } from '@casual-simulation/aux-common';
 import { RanOutOfEnergyError } from './AuxResults';
 import '@casual-simulation/aux-common/polyfill/Array.first.polyfill';
 import '@casual-simulation/aux-common/polyfill/Array.last.polyfill';
 import { embedBase64InPdf, getEmbeddedBase64FromPdf, toHexString as utilToHexString, fromHexString as utilFromHexString, } from './Utils';
-import { convertToCopiableValue } from '@casual-simulation/aux-common/partitions/PartitionUtils';
+import { constructInitializationUpdateFromPreviousUpdates, convertToCopiableValue, } from '@casual-simulation/aux-common/partitions/PartitionUtils';
 import { sha256 as hashSha256, sha512 as hashSha512, hmac as calcHmac, sha1 as hashSha1, } from 'hash.js';
 import stableStringify from '@casual-simulation/fast-json-stable-stringify';
 import { encrypt as realEncrypt, decrypt as realDecrypt, keypair as realKeypair, sign as realSign, verify as realVerify, asymmetricKeypair as realAsymmetricKeypair, asymmetricEncrypt as realAsymmetricEncrypt, asymmetricDecrypt as realAsymmetricDecrypt, isAsymmetricKeypair, isAsymmetricEncrypted, isEncrypted, } from '@casual-simulation/crypto';
@@ -34,6 +37,7 @@ import { constructInitializationUpdate, mergeInstUpdates as calcMergeInstUpdates
 import { CasualOSError } from './CasualOSError';
 import { attachRuntime, detachRuntime } from './RuntimeEvents';
 import { query as q } from './database/DatabaseUtils';
+// import type { PurchasableItem } from '@casual-simulation/aux-records/casualware/PurchasableItemRecordsStore';
 const _html = htm.bind(h);
 const html = ((...args) => {
     return _html(...args);
@@ -124,7 +128,6 @@ expect.extend({
     },
 });
 function getBotSnapshot(bot) {
-    var _a;
     let b = {
         id: bot.id,
         space: bot.space,
@@ -134,7 +137,7 @@ function getBotSnapshot(bot) {
     };
     let masks = isRuntimeBot(bot)
         ? bot[GET_TAG_MASKS_SYMBOL]()
-        : cloneDeep((_a = bot.masks) !== null && _a !== void 0 ? _a : {});
+        : cloneDeep(bot.masks ?? {});
     if (Object.keys(masks).length > 0) {
         b.masks = masks;
     }
@@ -576,6 +579,7 @@ export function createDefaultLibrary(context) {
                 closeQRCodeScanner,
                 showQRCode,
                 hideQRCode,
+                generateQRCode,
                 openBarcodeScanner,
                 closeBarcodeScanner,
                 showBarcode,
@@ -738,6 +742,7 @@ export function createDefaultLibrary(context) {
                 reportInst,
                 requestAuthBot,
                 requestAuthBotInBackground,
+                signOut,
                 createRecord,
                 getPublicRecordKey,
                 getSubjectlessPublicRecordKey,
@@ -813,6 +818,12 @@ export function createDefaultLibrary(context) {
                 listUserStudios,
                 listStudioRecords,
                 getRecordsEndpoint,
+                recordStoreItem,
+                getStoreItem,
+                eraseStoreItem,
+                listStoreItems,
+                listStoreItemsByMarker,
+                purchaseStoreItem,
                 convertGeolocationToWhat3Words,
                 raycastFromCamera,
                 raycast,
@@ -858,6 +869,20 @@ export function createDefaultLibrary(context) {
                 _attachDebugger,
                 _detachDebugger,
             },
+            xp: {
+                recordContract: xpRecordContract,
+                getContract: xpGetContract,
+                listContracts: xpListContracts,
+                getContractPricing: xpGetContractPricing,
+                purchaseContract: xpPurchaseContract,
+                cancelContract: xpCancelContract,
+                invoiceContract: xpInvoiceContract,
+                cancelInvoice: xpCancelInvoice,
+                listInvoices: xpListInvoices,
+                payInvoice: xpPayInvoice,
+                payout: xpPayout,
+                getAccountBalances: xpGetAccountBalances,
+            },
             portal: {
                 registerPrefix,
             },
@@ -968,7 +993,7 @@ export function createDefaultLibrary(context) {
             },
         },
         tagSpecificApi: {
-            create: tagAsInterpretableFunction((options) => (...args) => { var _a; return create((_a = options.bot) === null || _a === void 0 ? void 0 : _a.id, ...args); }, (options) => (...args) => { var _a; return unwind(create((_a = options.bot) === null || _a === void 0 ? void 0 : _a.id, ...args)); }),
+            create: tagAsInterpretableFunction((options) => (...args) => create(options.bot?.id, ...args), (options) => (...args) => unwind(create(options.bot?.id, ...args))),
             setTimeout: botTimer('timeout', setTimeout, true),
             setInterval: botTimer('interval', setInterval, false),
             watchPortal: watchPortalBots(),
@@ -1076,6 +1101,7 @@ export function createDefaultLibrary(context) {
             let valid = true;
             const generatorWrapper = {
                 [Symbol.iterator]: () => generatorWrapper,
+                [Symbol.dispose]: () => { },
                 next(value) {
                     if (!valid) {
                         return {
@@ -1831,7 +1857,7 @@ export function createDefaultLibrary(context) {
      * @docname getJSON
      */
     function getJSON(data) {
-        if (hasValue(data === null || data === void 0 ? void 0 : data[ORIGINAL_OBJECT])) {
+        if (hasValue(data?.[ORIGINAL_OBJECT])) {
             return stableStringify(data[ORIGINAL_OBJECT]);
         }
         return stableStringify(data);
@@ -1850,7 +1876,7 @@ export function createDefaultLibrary(context) {
      * @docname getFormattedJSON
      */
     function getFormattedJSON(data) {
-        if (hasValue(data === null || data === void 0 ? void 0 : data[ORIGINAL_OBJECT])) {
+        if (hasValue(data?.[ORIGINAL_OBJECT])) {
             return stableStringify(data[ORIGINAL_OBJECT], { space: 2 });
         }
         return stableStringify(data, { space: 2 });
@@ -1865,7 +1891,6 @@ export function createDefaultLibrary(context) {
      * @docname getSnapshot
      */
     function getSnapshot(bots) {
-        var _a;
         if (!Array.isArray(bots)) {
             return getSnapshot([bots]);
         }
@@ -1884,7 +1909,7 @@ export function createDefaultLibrary(context) {
             }
             let masks = isRuntimeBot(bot)
                 ? bot[GET_TAG_MASKS_SYMBOL]()
-                : cloneDeep((_a = bot.masks) !== null && _a !== void 0 ? _a : {});
+                : cloneDeep(bot.masks ?? {});
             if (Object.keys(masks).length > 0) {
                 b.masks = masks;
             }
@@ -2129,7 +2154,7 @@ export function createDefaultLibrary(context) {
         const final = addAsyncResultAction(task, action).then((result) => {
             const choice = result.choices[0];
             if (returnString) {
-                return choice === null || choice === void 0 ? void 0 : choice.content;
+                return choice?.content;
             }
             return choice;
         });
@@ -2164,7 +2189,7 @@ export function createDefaultLibrary(context) {
                         continue;
                     }
                     if (returnString) {
-                        const content = choice === null || choice === void 0 ? void 0 : choice.content;
+                        const content = choice?.content;
                         if (!hasValue(content)) {
                             continue;
                         }
@@ -2245,7 +2270,7 @@ export function createDefaultLibrary(context) {
             action = aiGenerateImage(prompt, negativePrompt, task.taskId);
         }
         else {
-            let { endpoint, ...parameters } = options !== null && options !== void 0 ? options : {};
+            let { endpoint, ...parameters } = options ?? {};
             action = aiGenerateImage({
                 ...parameters,
                 prompt,
@@ -2255,23 +2280,19 @@ export function createDefaultLibrary(context) {
             }, task.taskId);
         }
         const final = addAsyncResultAction(task, action).then((result) => {
-            var _a;
             if (returnObject) {
                 return {
                     ...result,
-                    images: result.images.map((image) => {
-                        var _a;
-                        return ({
-                            ...image,
-                            url: toBase64Url(image.base64, (_a = image.mimeType) !== null && _a !== void 0 ? _a : 'image/png'),
-                        });
-                    }),
+                    images: result.images.map((image) => ({
+                        ...image,
+                        url: toBase64Url(image.base64, image.mimeType ?? 'image/png'),
+                    })),
                 };
             }
             else {
                 const image = result.images[0];
                 const base64 = image.base64;
-                return toBase64Url(base64, (_a = image.mimeType) !== null && _a !== void 0 ? _a : 'image/png');
+                return toBase64Url(base64, image.mimeType ?? 'image/png');
             }
         });
         final[ORIGINAL_OBJECT] = action;
@@ -2480,7 +2501,7 @@ export function createDefaultLibrary(context) {
      */
     function tip(message, pixelX, pixelY, duration) {
         const task = context.createTask();
-        const action = tipMessage(convertToCopiableValue(message), pixelX !== null && pixelX !== void 0 ? pixelX : null, pixelY !== null && pixelY !== void 0 ? pixelY : null, (duration !== null && duration !== void 0 ? duration : 2) * 1000, task.taskId);
+        const action = tipMessage(convertToCopiableValue(message), pixelX ?? null, pixelY ?? null, (duration ?? 2) * 1000, task.taskId);
         return addAsyncAction(task, action);
     }
     /**
@@ -2768,7 +2789,7 @@ export function createDefaultLibrary(context) {
         const finalOptions = {
             duration: 1,
             easing: 'quadratic',
-            ...(options !== null && options !== void 0 ? options : {}),
+            ...(options ?? {}),
         };
         let action;
         if (botOrPosition === null) {
@@ -2953,6 +2974,7 @@ export function createDefaultLibrary(context) {
             isCollaborative: null,
             allowCollaborationUpgrade: null,
             ab1BootstrapUrl: null,
+            comID: null,
         };
     }
     /**
@@ -3389,8 +3411,7 @@ export function createDefaultLibrary(context) {
      * @docname os.getAuxFileForBots
      */
     function getAuxFileForBots(bots, options) {
-        var _a;
-        const version = (_a = options === null || options === void 0 ? void 0 : options.version) !== null && _a !== void 0 ? _a : 2;
+        const version = options?.version ?? 2;
         if (version === 1) {
             let state = {};
             for (let bot of bots) {
@@ -3429,7 +3450,7 @@ export function createDefaultLibrary(context) {
      */
     function installAuxFile(aux, mode) {
         const task = context.createTask(true, true);
-        const action = calcRemote(calcInstallAuxFile(aux, mode !== null && mode !== void 0 ? mode : 'default'), undefined, undefined, task.taskId);
+        const action = calcRemote(calcInstallAuxFile(aux, mode ?? 'default'), undefined, undefined, task.taskId);
         return addAsyncAction(task, action);
     }
     /**
@@ -3545,6 +3566,40 @@ export function createDefaultLibrary(context) {
         const event = calcShowQRCode(false);
         return addAction(event);
     }
+    /**
+     * Generates a [QR Code](https://en.wikipedia.org/wiki/QR_code) for the given data and returns a [Data URL](https://developer.mozilla.org/en-US/docs/web/http/basics_of_http/data_urls) that can be used in an img tag or as a {@tag formAddress}.
+     *
+     * Returns a promise that resolves with the data URL string.
+     *
+     * @param code the text or data that the generated QR Code should represent.
+     * @param options the options that should be used when generating the QR Code.
+     *
+     * @example Generate a QR Code that contains the data "hello".
+     * const qrCodeUrl = await os.generateQRCode("hello");
+     * masks.formAddress = qrCodeUrl;
+     *
+     * @example Generate a QR Code that links to https://example.com
+     * const qrCodeUrl = await os.generateQRCode("https://example.com");
+     * masks.formAddress = qrCodeUrl;
+     *
+     * @example Generate a QR Code with custom colors.
+     * const qrCodeUrl = await os.generateQRCode("Custom QR Code", {
+     *   color: {
+     *    dark: "#0000FFFF",
+     *    light: "#FFFF00FF"
+     *   }
+     * });
+     * masks.formAddress = qrCodeUrl;
+     *
+     * @dochash actions/os/barcodes
+     * @docname os.generateQRCode
+     * @docgroup 10-qr-code
+     */
+    function generateQRCode(code, options) {
+        const task = context.createTask();
+        const event = calcGenerateQRCode(code, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
     /**
      * Opens the [Barcode](https://en.wikipedia.org/wiki/Barcode) scanner.
      * While open, each scanned Barcode will send a {@tag @onBarcodeScanned} shout. Optionally accepts which camera to use for scanning. (front/back)
@@ -3870,7 +3925,7 @@ export function createDefaultLibrary(context) {
                 }
             }
         }
-        catch (_a) {
+        catch {
             // Ignore errors
         }
         const task = context.createTask();
@@ -4053,10 +4108,11 @@ export function createDefaultLibrary(context) {
      * @docgroup 10-config-values
      */
     function getCurrentServer() {
-        var _a;
         const user = context.playerBot;
         if (user) {
-            let inst = (_a = getTag(user, 'inst')) !== null && _a !== void 0 ? _a : getTag(user, 'staticInst');
+            let inst = getTag(user, 'inst') ??
+                getTag(user, 'staticInst') ??
+                getTag(user, 'tempInst');
             if (hasValue(inst)) {
                 if (Array.isArray(inst)) {
                     return inst[0].toString();
@@ -4076,10 +4132,9 @@ export function createDefaultLibrary(context) {
      * @docgroup 10-config-values
      */
     function getCurrentInstRecord() {
-        var _a;
         const user = context.playerBot;
         if (user) {
-            return (_a = getTag(user, 'record')) !== null && _a !== void 0 ? _a : null;
+            return getTag(user, 'record') ?? null;
         }
         return null;
     }
@@ -4697,8 +4752,8 @@ export function createDefaultLibrary(context) {
     function closeCircleWipe(options) {
         const task = context.createTask();
         const event = circleWipe(false, {
-            color: (options === null || options === void 0 ? void 0 : options.color) || 'black',
-            duration: (options === null || options === void 0 ? void 0 : options.duration) || 1,
+            color: options?.color || 'black',
+            duration: options?.duration || 1,
         }, task.taskId);
         return addAsyncAction(task, event);
     }
@@ -4736,8 +4791,8 @@ export function createDefaultLibrary(context) {
     function openCircleWipe(options) {
         const task = context.createTask();
         const event = circleWipe(true, {
-            color: (options === null || options === void 0 ? void 0 : options.color) || 'black',
-            duration: (options === null || options === void 0 ? void 0 : options.duration) || 1,
+            color: options?.color || 'black',
+            duration: options?.duration || 1,
         }, task.taskId);
         return addAsyncAction(task, event);
     }
@@ -5024,6 +5079,274 @@ export function createDefaultLibrary(context) {
         const event = calcGetGeolocation(task.taskId);
         return addAsyncAction(task, event);
     }
+    /**
+     * Creates a new contract record in the XP system.
+     *
+     * @param recordName The name of the record that the contract should be stored in.
+     * @param contract The contract record data.
+     * @param options The options for the request.
+     *
+     * @dochash actions/xp
+     * @doctitle xpExchange Actions
+     * @docsidebar xpExchange
+     * @docdescription Actions for working with the xpExchange.
+     * @docname xp.recordContract
+     */
+    function xpRecordContract(recordName, contract, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            recordContract: {
+                input: {
+                    recordName,
+                    item: contract,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Gets the contract with the given address.
+     *
+     * @param recordName The name of the record that the contract is stored in.
+     * @param address The address of the contract.
+     * @param options The options for the request.
+     *
+     * @dochash actions/xp
+     * @docname xp.getContract
+     */
+    function xpGetContract(recordName, address, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            getContract: {
+                input: {
+                    recordName,
+                    address,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Gets a list of contracts from the given record.
+     *
+     * @param recordName The name of the record that the contracts are stored in.
+     * @param address The address that the contracts should be listed after. If null, then the first page of contracts will be returned.
+     * @param options The options for the request.
+     * @returns A promise that resolves with the list of contracts.
+     *
+     * @dochash actions/xp
+     * @docname xp.listContracts
+     */
+    function xpListContracts(recordName, address = null, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            listContracts: {
+                input: {
+                    recordName,
+                    address,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Gets the pricing for the given contract.
+     *
+     * @param recordName The name of the record that the contracts are stored in.
+     * @param address The address of the contract.
+     * @param options The options for the request.
+     * @returns A promise that resolves with the pricing details for the contract.
+     *
+     * @dochash actions/xp
+     * @docname xp.getContractPricing
+     */
+    function xpGetContractPricing(recordName, address = null, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            getContractPricing: {
+                input: {
+                    recordName,
+                    address,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Attempts to purchase a contract via the xpExchange.
+     *
+     * @param request The request for the purchase.
+     * @param options The options for the request.
+     * @returns A promise that resolves when the purchase is complete. Returns a URL to redirect the user to if additional payment details need to be collected.
+     *
+     * @dochash actions/xp
+     * @docname xp.purchaseContract
+     */
+    function xpPurchaseContract(request, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            purchaseContract: {
+                input: {
+                    recordName: request.recordName,
+                    contract: {
+                        address: request.address,
+                        expectedCost: request.expectedCost,
+                        currency: request.currency,
+                    },
+                    returnUrl: request.returnUrl,
+                    successUrl: request.successUrl,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Cancels a contract contract via the xpExchange and refunds any funds.
+     *
+     * @param recordName The name of the record that the contract is stored in.
+     * @param address The address of the contract to cancel.
+     * @param options The options for the request.
+     * @returns A promise that resolves when the contract is cancelled.
+     *
+     * @dochash actions/xp
+     * @docname xp.cancelContract
+     */
+    function xpCancelContract(recordName, address, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            cancelContract: {
+                input: {
+                    recordName: recordName,
+                    address: address,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Creates a new invoice for the given contract.
+     *
+     * @param request The request for the invoice.
+     * @param options The options for the request.
+     * @returns A promise that resolves when the invoice is created.
+     *
+     * @dochash actions/xp
+     * @docname xp.invoiceContract
+     */
+    function xpInvoiceContract(request, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            invoiceContract: {
+                input: {
+                    contractId: request.contractId,
+                    amount: request.amount,
+                    note: request.note,
+                    payoutDestination: request.payoutDestination,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Voids (cancels) an invoice.
+     *
+     * @param invoiceId The ID of the invoice to void.
+     * @param options The options for the request.
+     * @returns A promise that resolves when the invoice is voided.
+     *
+     * @dochash actions/xp
+     * @docname xp.voidInvoice
+     */
+    function xpCancelInvoice(invoiceId, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            cancelInvoice: {
+                input: {
+                    invoiceId,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Lists the invoices for the given contract.
+     *
+     * @param contractId The ID of the contract to list invoices for.
+     * @param options The options for the request.
+     * @returns A promise that resolves with the invoices for the contract.
+     *
+     * @dochash actions/xp
+     * @docname xp.listInvoices
+     */
+    function xpListInvoices(contractId, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            listContractInvoices: {
+                input: {
+                    contractId,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Pays an invoice. This will attempt to transfer funds from the contract account to the user holding the contract.
+     *
+     * @param invoiceId The ID of the invoice to pay.
+     * @param options The options for the request.
+     * @returns A promise that resolves when the invoice is paid.
+     */
+    function xpPayInvoice(invoiceId, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            payContractInvoice: {
+                input: {
+                    invoiceId,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Attempts to payout funds from the user's account to their linked payout destination.
+     *
+     * @param request The payout request.
+     * @param options The options for the request.
+     * @returns A promise that resolves when the payout is complete.
+     *
+     * @dochash actions/xp
+     * @docname xp.payout
+     */
+    function xpPayout(request, options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            payoutAccount: {
+                input: {
+                    amount: request.amount,
+                    destination: request.destination,
+                },
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Attempts to retrieve the account balances for the user's account.
+     *
+     * @param options The options for the request.
+     * @returns A promise that resolves with the account balances.
+     *
+     * @dochash actions/xp
+     * @docname xp.getAccountBalances
+     */
+    function xpGetAccountBalances(options = {}) {
+        const task = context.createTask();
+        const event = recordsCallProcedure({
+            getBalances: {
+                input: {},
+            },
+        }, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
     /**
      * Specifies that the given prefix should be used to indicate that the tag contains script content.
      * Use this function to specify custom prefixes that function similarly to `@` or `🧬`.
@@ -5056,8 +5379,8 @@ export function createDefaultLibrary(context) {
         }
         const task = context.createTask();
         const event = calcRegisterPrefix(prefix, {
-            language: (options === null || options === void 0 ? void 0 : options.language) || 'javascript',
-            name: options === null || options === void 0 ? void 0 : options.name,
+            language: options?.language || 'javascript',
+            name: options?.name,
         }, task.taskId);
         return addAsyncAction(task, event);
     }
@@ -5303,6 +5626,23 @@ export function createDefaultLibrary(context) {
         const event = calcDefineGlobalBot(name, botId, task.taskId);
         return addAsyncAction(task, event);
     }
+    /**
+     * Signs out the current user by revoking their session.
+     * Returns a promise that resolves when the sign out request has been processed.
+     *
+     * @example Sign out the current user
+     * await os.signOut();
+     * os.toast("Signed out!");
+     *
+     * @dochash actions/os/records
+     * @docgroup 01-records
+     * @docname os.signOut
+     */
+    function signOut() {
+        const task = context.createTask();
+        const event = calcSignOut(task.taskId);
+        return addAsyncAction(task, event);
+    }
     /**
      * Creates a record with the given name. If a studio is specified, then the record will be created in the given studio.
      * If not specified, then the record will be owned by the current user.
@@ -5451,7 +5791,7 @@ export function createDefaultLibrary(context) {
      */
     function grantPermission(recordName, permission, options) {
         const task = context.createTask();
-        const event = calcGrantRecordPermission(recordName, permission, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcGrantRecordPermission(recordName, permission, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -5469,7 +5809,7 @@ export function createDefaultLibrary(context) {
      */
     function revokePermission(recordName, permissionId, options) {
         const task = context.createTask();
-        const event = calcRevokeRecordPermission(recordName, permissionId, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcRevokeRecordPermission(recordName, permissionId, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -5525,7 +5865,7 @@ export function createDefaultLibrary(context) {
      */
     function grantInstAdminPermission(recordName, options) {
         const task = context.createTask();
-        const event = calcGrantInstAdminPermission(recordName, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcGrantInstAdminPermission(recordName, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -5551,7 +5891,7 @@ export function createDefaultLibrary(context) {
      */
     function grantUserRole(recordName, role, userId, expireTimeMs = null, options) {
         const task = context.createTask();
-        const event = calcGrantUserRole(recordName, role, userId, expireTimeMs, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcGrantUserRole(recordName, role, userId, expireTimeMs, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -5573,7 +5913,7 @@ export function createDefaultLibrary(context) {
      */
     function revokeUserRole(recordName, role, userId, options) {
         const task = context.createTask();
-        const event = calcRevokeUserRole(recordName, role, userId, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcRevokeUserRole(recordName, role, userId, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -5627,7 +5967,7 @@ export function createDefaultLibrary(context) {
      */
     function revokeInstRole(recordName, role, inst, options) {
         const task = context.createTask();
-        const event = calcRevokeInstRole(recordName, role, inst, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcRevokeInstRole(recordName, role, inst, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -5730,7 +6070,6 @@ export function createDefaultLibrary(context) {
      * @param endpointOrOptions The options that should be used. Optional.
      */
     function baseRecordData(recordKey, address, data, requiresApproval, endpointOrOptions = null) {
-        var _a;
         const task = context.createTask();
         let options = {};
         if (hasValue(endpointOrOptions)) {
@@ -5743,7 +6082,7 @@ export function createDefaultLibrary(context) {
                 if (hasValue(marker)) {
                     options.markers = [
                         endpointOrOptions.marker,
-                        ...((_a = endpointOrOptions.markers) !== null && _a !== void 0 ? _a : []),
+                        ...(endpointOrOptions.markers ?? []),
                     ];
                 }
             }
@@ -6163,7 +6502,7 @@ export function createDefaultLibrary(context) {
      */
     function recordWebhook(recordName, webhook, options) {
         const task = context.createTask();
-        const event = calcRecordWebhook(recordName, webhook, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcRecordWebhook(recordName, webhook, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6184,7 +6523,7 @@ export function createDefaultLibrary(context) {
      */
     function runWebhook(recordName, address, input, options) {
         const task = context.createTask();
-        const event = calcRunWebhook(recordName, address, input, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcRunWebhook(recordName, address, input, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6204,7 +6543,7 @@ export function createDefaultLibrary(context) {
      */
     function getWebhook(recordName, address, options) {
         const task = context.createTask();
-        const event = calcGetWebhook(recordName, address, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcGetWebhook(recordName, address, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6221,7 +6560,7 @@ export function createDefaultLibrary(context) {
      */
     function eraseWebhook(recordName, address, options) {
         const task = context.createTask();
-        const event = calcEraseWebhook(recordName, address, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcEraseWebhook(recordName, address, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6240,7 +6579,7 @@ export function createDefaultLibrary(context) {
      */
     function listWebhooks(recordName, startingAddress = null, options) {
         const task = context.createTask();
-        const event = calcListWebhooks(recordName, startingAddress, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcListWebhooks(recordName, startingAddress, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6261,7 +6600,7 @@ export function createDefaultLibrary(context) {
      */
     function listWebhooksByMarker(recordName, marker, startingAddress = null, options) {
         const task = context.createTask();
-        const event = calcListWebhooksByMarker(recordName, marker, startingAddress, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcListWebhooksByMarker(recordName, marker, startingAddress, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6295,7 +6634,7 @@ export function createDefaultLibrary(context) {
      */
     function recordNotification(recordName, notification, options) {
         const task = context.createTask();
-        const event = calcRecordNotification(recordName, notification, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcRecordNotification(recordName, notification, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6315,7 +6654,7 @@ export function createDefaultLibrary(context) {
      */
     function getNotification(recordName, address, options) {
         const task = context.createTask();
-        const event = calcGetNotification(recordName, address, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcGetNotification(recordName, address, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6332,7 +6671,7 @@ export function createDefaultLibrary(context) {
      */
     function eraseNotification(recordName, address, options) {
         const task = context.createTask();
-        const event = calcEraseNotification(recordName, address, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcEraseNotification(recordName, address, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6351,7 +6690,7 @@ export function createDefaultLibrary(context) {
      */
     function listNotifications(recordName, startingAddress = null, options) {
         const task = context.createTask();
-        const event = calcListNotifications(recordName, startingAddress, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcListNotifications(recordName, startingAddress, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6372,7 +6711,7 @@ export function createDefaultLibrary(context) {
      */
     function listNotificationsByMarker(recordName, marker, startingAddress = null, options) {
         const task = context.createTask();
-        const event = calcListNotificationsByMarker(recordName, marker, startingAddress, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcListNotificationsByMarker(recordName, marker, startingAddress, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6395,7 +6734,7 @@ export function createDefaultLibrary(context) {
      */
     function subscribeToNotification(recordName, address, options) {
         const task = context.createTask();
-        const event = calcSubscribeToNotification(recordName, address, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcSubscribeToNotification(recordName, address, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6414,7 +6753,7 @@ export function createDefaultLibrary(context) {
      */
     function unsubscribeFromNotification(subscriptionId, options) {
         const task = context.createTask();
-        const event = calcUnsubscribeFromNotification(subscriptionId, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcUnsubscribeFromNotification(subscriptionId, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6441,7 +6780,7 @@ export function createDefaultLibrary(context) {
      */
     function sendNotification(recordName, address, payload, options) {
         const task = context.createTask();
-        const event = calcSendNotification(recordName, address, payload, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcSendNotification(recordName, address, payload, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6462,7 +6801,7 @@ export function createDefaultLibrary(context) {
      */
     function listNotificationSubscriptions(recordName, address, options) {
         const task = context.createTask();
-        const event = calcListNotificationSubscriptions(recordName, address, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcListNotificationSubscriptions(recordName, address, options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6481,7 +6820,7 @@ export function createDefaultLibrary(context) {
      */
     function listUserNotificationSubscriptions(options) {
         const task = context.createTask();
-        const event = calcListUserNotificationSubscriptions(options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcListUserNotificationSubscriptions(options ?? {}, task.taskId);
         const final = addAsyncResultAction(task, event);
         final[ORIGINAL_OBJECT] = event;
         return final;
@@ -6567,7 +6906,6 @@ export function createDefaultLibrary(context) {
      * @docname os.recordFile
      */
     function recordFile(recordKeyOrName, data, options, endpoint = null) {
-        var _a;
         if (!hasValue(recordKeyOrName)) {
             throw new Error('recordKeyOrName must be provided.');
         }
@@ -6584,7 +6922,7 @@ export function createDefaultLibrary(context) {
             if (hasValue(marker)) {
                 recordOptions.markers = [
                     options.marker,
-                    ...((_a = options.markers) !== null && _a !== void 0 ? _a : []),
+                    ...(options.markers ?? []),
                 ];
             }
         }
@@ -6592,7 +6930,7 @@ export function createDefaultLibrary(context) {
             recordOptions.endpoint = endpoint;
         }
         const task = context.createTask();
-        const event = calcRecordFile(recordKeyOrName, convertToCopiableValue(data), options === null || options === void 0 ? void 0 : options.description, options === null || options === void 0 ? void 0 : options.mimeType, recordOptions, task.taskId);
+        const event = calcRecordFile(recordKeyOrName, convertToCopiableValue(data), options?.description, options?.mimeType, recordOptions, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -6951,13 +7289,12 @@ export function createDefaultLibrary(context) {
      * @docname os.recordPackageVersion
      */
     function recordPackageVersion(request, options = {}) {
-        var _a;
         const task = context.createTask();
         const event = calcRecordPackageVersion({
             recordName: request.recordName,
             address: request.address,
             key: request.key,
-            entitlements: (_a = request.entitlements) !== null && _a !== void 0 ? _a : [],
+            entitlements: request.entitlements ?? [],
             description: request.description,
             markers: request.markers,
             state: {
@@ -7042,7 +7379,7 @@ export function createDefaultLibrary(context) {
         const task = context.createTask();
         const event = calcRecordPackageContainer(recordName, address, typeof markers === 'string'
             ? [markers]
-            : markers !== null && markers !== void 0 ? markers : [PRIVATE_MARKER], options, task.taskId);
+            : markers ?? [PRIVATE_MARKER], options, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -7138,7 +7475,7 @@ export function createDefaultLibrary(context) {
      */
     function installPackage(recordName, address, key, options = {}) {
         const task = context.createTask();
-        const event = calcInstallPackage(recordName, address, key !== null && key !== void 0 ? key : null, options, task.taskId);
+        const event = calcInstallPackage(recordName, address, key ?? null, options, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -7352,7 +7689,7 @@ export function createDefaultLibrary(context) {
                     recordName,
                     marker,
                     address: startingAddress,
-                    sort: options === null || options === void 0 ? void 0 : options.sort,
+                    sort: options?.sort,
                 },
             },
         }, options, task.taskId);
@@ -7604,7 +7941,7 @@ export function createDefaultLibrary(context) {
                     recordName,
                     marker,
                     address: startingAddress,
-                    sort: options === null || options === void 0 ? void 0 : options.sort,
+                    sort: options?.sort,
                 },
             },
         }, options, task.taskId);
@@ -7726,6 +8063,148 @@ export function createDefaultLibrary(context) {
         const event = calcGetRecordsEndpoint(task.taskId);
         return addAsyncAction(task, event);
     }
+    /**
+     * Creates or updates a store item in a record.
+     *
+     * Returns a promise that resolves with an object that indicates whether the operation was successful or unsuccessful.
+     *
+     * @param recordName the name of the record that the store item should be created or updated in.
+     * @param address the address of the item in the record.
+     * @param item the item that should be stored in the record.
+     * @param options the options that should be used to store the item.
+     *
+     * @example Record an item that can be purchased by anyone
+     * await os.recordStoreItem('myRecord', 'myItem', {
+     *    name: 'My Item',
+     *    description: 'Description of my item!'
+     *    imageUrls: [],
+     *    currency: 'usd',
+     *    cost: 100, // $1.00
+     *    roleName: 'roleToBeGranted',
+     *    roleGrantTimeMs: null,
+     *    markers: ['publicRead']
+     * });
+     *
+     * @dochash actions/os/records
+     * @docgroup 01-store
+     * @docname os.recordStoreItem
+     */
+    function recordStoreItem(recordName, address, item, options = {}) {
+        const task = context.createTask();
+        const event = calcRecordStoreItem(recordName, address, item, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Gets the item with the given address from the specified record.
+     *
+     * Returns a promise that resolves with the item that was stored in the record.
+     *
+     * @param recordName the name of the record that the store item should be retrieved from.
+     * @param address the address of the item in the record.
+     * @param options the options that should be used to get the item.
+     *
+     * @example Get an item by address
+     * const item = await os.getStoreItem('myRecord', 'myItem');
+     *
+     * @dochash actions/os/records
+     * @docgroup 01-store
+     * @docname os.getStoreItem
+     */
+    function getStoreItem(recordName, address, options = {}) {
+        const task = context.createTask();
+        const event = calcGetStoreItem(recordName, address, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Deletes the item with the given address from the specified record.
+     *
+     * Returns a promise that resolves with the status of the operation.
+     *
+     * @param recordName the name of the record that the store item should be deleted from.
+     * @param address the address of the item that should be deleted.
+     * @param options the options that should be used to get the item.
+     *
+     * @example Delete an item by address
+     * const result = await os.eraseStoreItem('myRecord', 'myItem');
+     *
+     * @dochash actions/os/records
+     * @docgroup 01-store
+     * @docname os.eraseStoreItem
+     */
+    function eraseStoreItem(recordName, address, options = {}) {
+        const task = context.createTask();
+        const event = calcEraseStoreItem(recordName, address, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Gets a partial list of store items from the given record.
+     * You must have permission to access all items in the record to list them.
+     *
+     * Returns a promise that contains the items in the list.
+     *
+     * @param recordName the name of the record that the store item should be deleted from.
+     * @param startingAddress the address that the items should be listed after.
+     * @param options the options that should be used to get the item.
+     *
+     * @example List all items in the record
+     * const result = await os.listStoreItems('myRecord');
+     *
+     * @dochash actions/os/records
+     * @docgroup 01-store
+     * @docname os.listStoreItems
+     */
+    function listStoreItems(recordName, startingAddress = null, options = {}) {
+        const task = context.createTask();
+        const event = calcListStoreItems(recordName, startingAddress, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Gets a partial list of store items that have the given marker from the given record.
+     * You must have permission to access the given marker in the record to list them.
+     *
+     * Returns a promise that contains the items in the list.
+     *
+     * @param recordName the name of the record that the store item should be deleted from.
+     * @param marker the marker that the items should have.
+     * @param startingAddress the address that the items should be listed after.
+     * @param options the options that should be used to get the item.
+     *
+     * @example List all items in the record with the 'publicRead' marker
+     * const result = await os.listStoreItemsByMarker('myRecord', 'publicRead');
+     *
+     * @dochash actions/os/records
+     * @docgroup 01-store
+     * @docname os.listStoreItemsByMarker
+     */
+    function listStoreItemsByMarker(recordName, marker, startingAddress = null, options = {}) {
+        const task = context.createTask();
+        const event = calcListStoreItemsByMarker(recordName, marker, startingAddress, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
+    /**
+     * Attempts to purchase the given store item from the specified record.
+     *
+     * Returns a promise that resolves when the
+     *
+     * @param recordName the name of the record that the store item should be purchased from.
+     * @param item the item that should be purchased from the store.
+     * @param options the options that should be used to purchase the item.
+     *
+     * @example Purchase an item from the store
+     * const item = await os.getStoreItem('myRecord', 'myItem');
+     * const result = await os.purchaseStoreItem('myRecord', item);
+     *
+     * console.log(result);
+     *
+     * @dochash actions/os/records
+     * @docgroup 01-store
+     * @docname os.purchaseStoreItem
+     */
+    function purchaseStoreItem(recordName, item, options = {}) {
+        const task = context.createTask();
+        const event = calcPurchaseStoreItem(recordName, item, options, task.taskId);
+        return addAsyncAction(task, event);
+    }
     /**
      * Converts the given geolocation to a [what3words](https://what3words.com/) address. Returns a promise that resolves with the 3 word address.
      * @param location The latitude and longitude that should be converted to a 3 word address.
@@ -8020,7 +8499,7 @@ export function createDefaultLibrary(context) {
         const botIds = Array.isArray(botOrBots)
             ? botOrBots.map((b) => (isBot(b) ? b.id : b))
             : [isBot(botOrBots) ? botOrBots.id : botOrBots];
-        const event = calcStartFormAnimation(botIds, nameOrIndex, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcStartFormAnimation(botIds, nameOrIndex, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -8056,7 +8535,7 @@ export function createDefaultLibrary(context) {
         const botIds = Array.isArray(botOrBots)
             ? botOrBots.map((b) => (isBot(b) ? b.id : b))
             : [isBot(botOrBots) ? botOrBots.id : botOrBots];
-        const event = calcStopFormAnimation(botIds, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcStopFormAnimation(botIds, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -8077,14 +8556,13 @@ export function createDefaultLibrary(context) {
      * @docorder 2
      */
     function listFormAnimations(botOrAddress) {
-        var _a;
         let address;
         let bot = isBot(botOrAddress)
             ? botOrAddress
             : context.state[botOrAddress];
         if (bot) {
             address =
-                (_a = calculateStringTagValue(null, bot, 'auxFormAnimationAddress', null)) !== null && _a !== void 0 ? _a : calculateStringTagValue(null, bot, 'auxFormAddress', null);
+                calculateStringTagValue(null, bot, 'auxFormAnimationAddress', null) ?? calculateStringTagValue(null, bot, 'auxFormAddress', null);
         }
         else if (typeof botOrAddress === 'string') {
             address = botOrAddress;
@@ -8359,7 +8837,7 @@ export function createDefaultLibrary(context) {
             instName = getCurrentServer();
             recordName = getCurrentInstRecord();
             branchName = recordOrName;
-            markers = inst === null || inst === void 0 ? void 0 : inst.markers;
+            markers = inst?.markers;
         }
         else if (!inst && !name) {
             // Called as getSharedDocument(name)
@@ -8375,7 +8853,7 @@ export function createDefaultLibrary(context) {
             recordName = recordOrName;
             instName = inst;
             branchName = name;
-            markers = options === null || options === void 0 ? void 0 : options.markers;
+            markers = options?.markers;
         }
         const event = loadSharedDocument(recordName, instName, `doc/${branchName}`, task.taskId, markers);
         return addAsyncAction(task, event);
@@ -8548,33 +9026,35 @@ export function createDefaultLibrary(context) {
         return addAsyncAction(task, event);
     }
     /**
-     * Creates an inst update that, when applied, ensures the given bots are created on this inst. Returns a promise that resolves with the inst update.
+     * Creates an inst update that, when applied in addition to the previous update(s), ensures the given bots are created or updated on this inst. Returns a promise that resolves with the inst update.
      *
      * Note that you can apply the same update multiple times and you will end up with only one version of the bots saved in the update. Additionally, future changes to the bots will be preserved even if the update is applied again.
      *
      * This feature makes inst updates useful when you want to ensure that an experience starts in an initial state but also able to change over time.
      *
-     * Unlike {@link os.getCurrentInstUpdate}, this function creates an update that is not linked to this inst. This means that applying the update to the inst it was created in will create duplicate bots.
-     *
-     * @param bots the list of bots that should be included in the update.
-     *
-     * @example Create an update with this bot and save it to a tag
-     * const update = await os.createInitializationUpdate([thisBot]);
-     * tags.savedUpdate = update;
-     *
-     * @example Create an update with all the bots in the home dimension
-     * const update = await os.createInitializationUpdate(getBots(inDimension('home')));
-     * tags.savedUpdate = update;
+     * Unlike {@link os.createInitializationUpdate}, this function creates an update that is linked to the previous update(s). This means that this update will overwrite the previous update(s) when applied to the same inst.
      *
-     * @dochash actions/os/spaces
-     * @docname os.createInitializationUpdate
-     * @docgroup 10-updates
+     * @param previousUpdate The previous update or list of updates that this update should be based on and include.
+     * @param bots The bots that reflect the final state that should be achieved when this update is applied in addition to the previous update(s).
      */
-    function createInitializationUpdate(bots) {
-        const convertedBots = bots.map((b) => isRuntimeBot(b) ? createBot(b.id, b.tags.toJSON(), b.space) : b);
-        const task = context.createTask(true, true);
-        const event = calcRemote(calcCreateInitalizationUpdate(convertedBots), undefined, undefined, task.taskId);
-        return addAsyncAction(task, event);
+    function createInitializationUpdate(previousUpdateOrBots, bots) {
+        if (arguments.length === 2) {
+            const convertedBots = bots.map((b) => isRuntimeBot(b) ? createBot(b.id, b.tags.toJSON(), b.space) : b);
+            if (!Array.isArray(previousUpdateOrBots)) {
+                previousUpdateOrBots = [previousUpdateOrBots];
+            }
+            const previousUpdates = previousUpdateOrBots;
+            const update = constructInitializationUpdateFromPreviousUpdates(previousUpdates, convertedBots);
+            return Promise.resolve(update);
+        }
+        else {
+            const convertedBots = previousUpdateOrBots.map((b) => isRuntimeBot(b)
+                ? createBot(b.id, b.tags.toJSON(), b.space)
+                : b);
+            const task = context.createTask(true, true);
+            const event = calcRemote(calcCreateInitalizationUpdate(convertedBots), undefined, undefined, task.taskId);
+            return addAsyncAction(task, event);
+        }
     }
     /**
      * Applies the given updates to the current inst. Returns a promise that resolves once the updates have been applied.
@@ -8883,10 +9363,9 @@ export function createDefaultLibrary(context) {
         }
     }
     async function _retryWebhook(options) {
-        var _a, _b, _c, _d;
         const retryCount = Math.min(options.retryCount, MAX_RETRY_COUNT);
-        const timeToWait = Math.max(0, Math.min((_a = options.retryAfterMs) !== null && _a !== void 0 ? _a : DEFAULT_RETRY_AFTER_MS, MAX_RETRY_AFTER_MS));
-        const statusCodes = (_b = options.retryStatusCodes) !== null && _b !== void 0 ? _b : DEFUALT_RETRY_STATUS_CODES;
+        const timeToWait = Math.max(0, Math.min(options.retryAfterMs ?? DEFAULT_RETRY_AFTER_MS, MAX_RETRY_AFTER_MS));
+        const statusCodes = options.retryStatusCodes ?? DEFUALT_RETRY_STATUS_CODES;
         let retries = 0;
         while (true) {
             try {
@@ -8896,7 +9375,7 @@ export function createDefaultLibrary(context) {
                 if (retries >= retryCount) {
                     throw err;
                 }
-                else if (!statusCodes.includes((_d = (_c = err.response) === null || _c === void 0 ? void 0 : _c.status) !== null && _d !== void 0 ? _d : 0)) {
+                else if (!statusCodes.includes(err.response?.status ?? 0)) {
                     throw err;
                 }
                 await sleep(timeToWait);
@@ -9721,7 +10200,7 @@ export function createDefaultLibrary(context) {
      */
     function beginAudioRecording(options) {
         const task = context.createTask();
-        const action = calcBeginAudioRecording(options !== null && options !== void 0 ? options : {}, task.taskId);
+        const action = calcBeginAudioRecording(options ?? {}, task.taskId);
         return addAsyncAction(task, action);
     }
     /**
@@ -10119,11 +10598,10 @@ export function createDefaultLibrary(context) {
      * @docname experiment.speakText
      */
     function speakText(text, options) {
-        var _a;
-        options = options !== null && options !== void 0 ? options : {};
+        options = options ?? {};
         const task = context.createTask();
         const voice = typeof options.voice === 'object'
-            ? (_a = options.voice) === null || _a === void 0 ? void 0 : _a.name
+            ? options.voice?.name
             : options.voice;
         const action = calcSpeakText(text, {
             ...options,
@@ -12829,7 +13307,7 @@ export function createDefaultLibrary(context) {
      */
     function joinRoom(roomName, options) {
         const task = context.createTask();
-        const event = calcJoinRoom(roomName, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcJoinRoom(roomName, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**
@@ -12853,7 +13331,7 @@ export function createDefaultLibrary(context) {
      */
     function leaveRoom(roomName, options) {
         const task = context.createTask();
-        const event = calcLeaveRoom(roomName, options !== null && options !== void 0 ? options : {}, task.taskId);
+        const event = calcLeaveRoom(roomName, options ?? {}, task.taskId);
         return addAsyncAction(task, event);
     }
     /**