@superblocksteam/shared 0.9108.0

package/dist-esm/refactoring/updates.js

@@ -0,0 +1,192 @@
+import { get, isEqual, isArray } from 'lodash';
+import { isValidStepDef } from '../types';
+import { refactorNameInString, refactorNameInValue } from './refactor';
+import { createTriggerStepRenamer } from './rename';
+const PAGE_WIDGET_ID = '0';
+export async function getUpdatesInWidgets({ widgets, oldName, newName, dataTree, extractPairs, namespace }) {
+    let updates = [];
+    for (const [widgetId, widget] of Object.entries(widgets)) {
+        if (widget.widgetName === oldName) {
+            updates.push({
+                entityId: widgetId,
+                propertyName: 'widgetName',
+                propertyValue: newName
+            });
+            // if it's a table, rename in all of the cached columns (which aren't dynamic)
+            if (widget.type === 'TABLE_WIDGET') {
+                const tableWidget = widget;
+                const cachedSettings = Object.keys(tableWidget.cachedColumnSettings ?? {}).reduce((accum, key) => {
+                    Object.entries(tableWidget.cachedColumnSettings[key]).forEach(([k, v]) => {
+                        if (typeof v === 'string') {
+                            accum.push(`cachedColumnSettings.${key}.${k}`);
+                        }
+                    });
+                    return accum;
+                }, []);
+                await Promise.all(cachedSettings.map(async (key) => {
+                    const binding = get(widget, key);
+                    const withNewName = await refactorNameInString({
+                        value: binding,
+                        oldName,
+                        newName,
+                        dataTree,
+                        namespace,
+                        extractPairs
+                    });
+                    if (binding !== withNewName) {
+                        updates.push({
+                            entityId: widgetId,
+                            propertyName: key,
+                            propertyValue: withNewName
+                        });
+                    }
+                }));
+            }
+        }
+        if (widget.dynamicBindingPathList) {
+            await Promise.all(widget.dynamicBindingPathList.map(async ({ key }) => {
+                const binding = get(widget, key);
+                const withNewName = await refactorNameInValue({
+                    oldValue: binding,
+                    oldName,
+                    newName,
+                    dataTree,
+                    namespace,
+                    extractPairs
+                });
+                if (!isEqual(binding, withNewName)) {
+                    updates.push({
+                        entityId: widgetId,
+                        propertyName: key,
+                        propertyValue: withNewName
+                    });
+                }
+            }));
+        }
+        if (widget.dynamicTriggerPathList) {
+            const renameInTriggerStep = createTriggerStepRenamer({
+                oldName,
+                newName,
+                dataTree,
+                addUpdate: (payload) => {
+                    updates.push({
+                        ...payload,
+                        entityId: widgetId
+                    });
+                },
+                extractEvaluationPairs: extractPairs,
+                namespace
+            });
+            await Promise.all(widget.dynamicTriggerPathList.map(async ({ key }) => {
+                const trigger = get(widget, key);
+                if (!isArray(trigger)) {
+                    return;
+                }
+                await Promise.all(trigger.map(async (step, index) => {
+                    if (!isValidStepDef(step))
+                        return;
+                    await renameInTriggerStep(step, key, index);
+                }));
+            }));
+        }
+        // Canvas widgets also contain API response info
+        if (widgetId === PAGE_WIDGET_ID && 'apis' in widget) {
+            const apiUpdates = await updateNameInEntityMap({
+                entityMap: widget.apis,
+                parentId: widgetId,
+                parentKey: 'apis',
+                oldName,
+                newName,
+                dataTree,
+                extractPairs,
+                namespace
+            });
+            updates = [...updates, ...apiUpdates];
+        }
+    }
+    return updates;
+}
+export async function updateNameInEntityMap({ entityMap, parentKey, parentId = '', oldName, newName, dataTree, extractPairs, namespace }) {
+    if (!entityMap)
+        return [];
+    const updates = [];
+    const renameInTriggerStep = createTriggerStepRenamer({
+        oldName,
+        newName,
+        dataTree,
+        addUpdate: (payload) => {
+            updates.push({
+                ...payload,
+                entityId: parentId
+            });
+        },
+        extractEvaluationPairs: extractPairs,
+        namespace
+    });
+    if ('timerMap' in entityMap) {
+        const timers = entityMap.timerMap;
+        await Promise.all(Object.values(timers).map(async (timer) => {
+            if (timer.name === oldName) {
+                updates.push({
+                    propertyName: `${parentKey}.timerMap.${timer.id}.name`,
+                    propertyValue: newName,
+                    entityId: timer.id
+                });
+            }
+            await Promise.all(timer?.steps?.map(async (step, index) => {
+                if (!isValidStepDef(step))
+                    return;
+                const mappedKey = `${parentKey}.timerMap.${timer.id}.steps`;
+                await renameInTriggerStep(step, mappedKey, index);
+            }));
+        }));
+    }
+    else if ('apiMap' in entityMap) {
+        const apis = entityMap.apiMap;
+        for (const api of Object.values(apis)) {
+            await Promise.all((api.dynamicTriggerPathList ?? [])?.map(async ({ key }) => {
+                const mappedKey = `${parentKey}.apiMap.${api.id}.${key}`;
+                const triggers = get(api, key, []);
+                await Promise.all(triggers.map(async (step, index) => {
+                    if (!isValidStepDef(step))
+                        return;
+                    await renameInTriggerStep(step, mappedKey, index);
+                }));
+            }));
+        }
+    }
+    else if ('stateVarMap' in entityMap) {
+        const stateVars = entityMap.stateVarMap;
+        for (const stateVar of Object.values(stateVars)) {
+            if (stateVar.name === oldName) {
+                updates.push({
+                    propertyName: `${parentKey}.stateVarMap.${stateVar.id}.name`,
+                    propertyValue: newName,
+                    entityId: stateVar.id
+                });
+            }
+            if (stateVar.dynamicBindingPathList) {
+                await Promise.all(stateVar.dynamicBindingPathList.map(async ({ key }) => {
+                    const value = get(stateVar, key);
+                    const newValue = await refactorNameInValue({
+                        oldValue: value,
+                        oldName,
+                        newName,
+                        dataTree,
+                        namespace,
+                        extractPairs
+                    });
+                    if (!isEqual(value, newValue)) {
+                        updates.push({
+                            entityId: parentId ?? stateVar.id,
+                            propertyName: `${parentKey}.stateVarMap.${stateVar.id}.defaultValue`,
+                            propertyValue: newValue
+                        });
+                    }
+                }));
+            }
+        }
+    }
+    return updates;
+}
+//# sourceMappingURL=updates.js.map

package/dist-esm/refactoring/updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.js","sourceRoot":"","sources":["../../src/refactoring/updates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAW,cAAc,EAA8B,MAAM,UAAU,CAAC;AAE/E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAkB,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAKpD,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAiD,EACxF,OAAO,EACP,OAAO,EACP,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,SAAS,EAQV;IACC,IAAI,OAAO,GAAqB,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACxD,IAAI,MAAM,CAAC,UAAU,KAAK,OAAO,EAAE;YACjC,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,QAAQ;gBAClB,YAAY,EAAE,YAAY;gBAC1B,aAAa,EAAE,OAAO;aACvB,CAAC,CAAC;YAEH,8EAA8E;YAC9E,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE;gBAClC,MAAM,WAAW,GAAG,MAA0F,CAAC;gBAE/G,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBAC/F,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;wBACvE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE;4BACzB,KAAK,CAAC,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;yBAChD;oBACH,CAAC,CAAC,CAAC;oBACH,OAAO,KAAK,CAAC;gBACf,CAAC,EAAE,EAAc,CAAC,CAAC;gBACnB,MAAM,OAAO,CAAC,GAAG,CACf,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;oBACvC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAW,CAAC;oBAC3C,MAAM,WAAW,GAAG,MAAM,oBAAoB,CAAC;wBAC7C,KAAK,EAAE,OAAO;wBACd,OAAO;wBACP,OAAO;wBACP,QAAQ;wBACR,SAAS;wBACT,YAAY;qBACb,CAAC,CAAC;oBACH,IAAI,OAAO,KAAK,WAAW,EAAE;wBAC3B,OAAO,CAAC,IAAI,CAAC;4BACX,QAAQ,EAAE,QAAQ;4BAClB,YAAY,EAAE,GAAG;4BACjB,aAAa,EAAE,WAAW;yBAC3B,CAAC,CAAC;qBACJ;gBACH,CAAC,CAAC,CACH,CAAC;aACH;SACF;QAED,IAAI,MAAM,CAAC,sBAAsB,EAAE;YACjC,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;gBAClD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACjC,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC;oBAC5C,QAAQ,EAAE,OAAO;oBACjB,OAAO;oBACP,OAAO;oBACP,QAAQ;oBACR,SAAS;oBACT,YAAY;iBACb,CAAC,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE;oBAClC,OAAO,CAAC,IAAI,CAAC;wBACX,QAAQ,EAAE,QAAQ;wBAClB,YAAY,EAAE,GAAG;wBACjB,aAAa,EAAE,WAAW;qBAC3B,CAAC,CAAC;iBACJ;YACH,CAAC,CAAC,CACH,CAAC;SACH;QAED,IAAI,MAAM,CAAC,sBAAsB,EAAE;YACjC,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;gBACnD,OAAO;gBACP,OAAO;gBACP,QAAQ;gBACR,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;oBACrB,OAAO,CAAC,IAAI,CAAC;wBACX,GAAG,OAAO;wBACV,QAAQ,EAAE,QAAQ;qBACnB,CAAC,CAAC;gBACL,CAAC;gBACD,sBAAsB,EAAE,YAAY;gBACpC,SAAS;aACV,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;gBAClD,MAAM,OAAO,GAAwB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAwB,CAAC;gBAC7E,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;oBACrB,OAAO;iBACR;gBACD,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAa,EAAE,KAAK,EAAE,EAAE;oBACzC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;wBAAE,OAAO;oBAClC,MAAM,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC9C,CAAC,CAAC,CACH,CAAC;YACJ,CAAC,CAAC,CACH,CAAC;SACH;QAED,gDAAgD;QAChD,IAAI,QAAQ,KAAK,cAAc,IAAI,MAAM,IAAI,MAAM,EAAE;YACnD,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC;gBAC7C,SAAS,EAAE,MAAM,CAAC,IAAuB;gBACzC,QAAQ,EAAE,QAAQ;gBAClB,SAAS,EAAE,MAAM;gBACjB,OAAO;gBACP,OAAO;gBACP,QAAQ;gBACR,YAAY;gBACZ,SAAS;aACV,CAAC,CAAC;YAEH,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC;SACvC;KACF;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,SAAS,EACT,SAAS,EACT,QAAQ,GAAG,EAAE,EACb,OAAO,EACP,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,SAAS,EAUV;IACC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;QACnD,OAAO;QACP,OAAO;QACP,QAAQ;QACR,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACrB,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,OAAO;gBACV,QAAQ,EAAE,QAAQ;aACnB,CAAC,CAAC;QACL,CAAC;QACD,sBAAsB,EAAE,YAAY;QACpC,SAAS;KACV,CAAC,CAAC;IAEH,IAAI,UAAU,IAAI,SAAS,EAAE;QAC3B,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;QAClC,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACxC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE;gBAC1B,OAAO,CAAC,IAAI,CAAC;oBACX,YAAY,EAAE,GAAG,SAAS,aAAa,KAAK,CAAC,EAAE,OAAO;oBACtD,aAAa,EAAE,OAAO;oBACtB,QAAQ,EAAE,KAAK,CAAC,EAAE;iBACnB,CAAC,CAAC;aACJ;YACD,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;gBACtC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;oBAAE,OAAO;gBAClC,MAAM,SAAS,GAAG,GAAG,SAAS,aAAa,KAAK,CAAC,EAAE,QAAQ,CAAC;gBAC5D,MAAM,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;KACH;SAAM,IAAI,QAAQ,IAAI,SAAS,EAAE;QAChC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YACrC,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;gBACxD,MAAM,SAAS,GAAG,GAAG,SAAS,WAAW,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC;gBACzD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAsB,CAAC;gBACxD,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAa,EAAE,KAAK,EAAE,EAAE;oBAC1C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;wBAAE,OAAO;oBAClC,MAAM,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;gBACpD,CAAC,CAAC,CACH,CAAC;YACJ,CAAC,CAAC,CACH,CAAC;SACH;KACF;SAAM,IAAI,aAAa,IAAI,SAAS,EAAE;QACrC,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC;QACxC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YAC/C,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE;gBAC7B,OAAO,CAAC,IAAI,CAAC;oBACX,YAAY,EAAE,GAAG,SAAS,gBAAgB,QAAQ,CAAC,EAAE,OAAO;oBAC5D,aAAa,EAAE,OAAO;oBACtB,QAAQ,EAAE,QAAQ,CAAC,EAAE;iBACtB,CAAC,CAAC;aACJ;YACD,IAAI,QAAQ,CAAC,sBAAsB,EAAE;gBACnC,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;oBACpD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;oBACjC,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC;wBACzC,QAAQ,EAAE,KAAK;wBACf,OAAO;wBACP,OAAO;wBACP,QAAQ;wBACR,SAAS;wBACT,YAAY;qBACb,CAAC,CAAC;oBACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE;wBAC7B,OAAO,CAAC,IAAI,CAAC;4BACX,QAAQ,EAAE,QAAQ,IAAI,QAAQ,CAAC,EAAE;4BACjC,YAAY,EAAE,GAAG,SAAS,gBAAgB,QAAQ,CAAC,EAAE,eAAe;4BACpE,aAAa,EAAE,QAAQ;yBACxB,CAAC,CAAC;qBACJ;gBACH,CAAC,CAAC,CACH,CAAC;aACH;SACF;KACF;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist-esm/relay/builder.d.ts

@@ -0,0 +1,44 @@
+import { Relay } from './index';
+export declare class RelayBuilder {
+    private relay;
+    constructor();
+    build(): Relay;
+    /**
+     * Relay a request header using a different name.
+     * Header relay rules aren't case-sensitive because http headers aren't case sensitive.
+     * @param from The name of the request header to relay from the incoming request.
+     * @param to   The new name of the request header to relay to the outgoing request.
+     */
+    relayHeaderRename(from: string, to: string): RelayBuilder;
+    /**
+     * Relay request headers using the same names.
+     * @param from The names of the incoming request headers to relay from.
+     *
+     * Header relay rules aren't case-sensitive because http headers aren't case sensitive.
+     */
+    relayHeaders(from: string[]): RelayBuilder;
+    /**
+     * Relay a request query parameter using a different name.
+     * @param from The name of the request query parameter to relay from the incoming request.
+     * @param to   The new name of the request query parameter to relay to the outgoing request.
+     */
+    relayQueryRename(from: string, to: string): RelayBuilder;
+    /**
+     * Relay request query parameters using the same names.
+     * @param from The names of the incoming request query parameters to relay from.
+     */
+    relayQuery(from: string[]): RelayBuilder;
+    /**
+     * Relay request a query body field using a different name.
+     * @param from The name of the request body field to relay from the incoming request.
+     * @param to   The new name of the request body field to relay to the outgoing request.
+     */
+    relayBodyRename(from: string, to: string): RelayBuilder;
+    /**
+     * Relay query body fields using the same names.
+     * @param from: The names of the incoming request body fields to relay from.
+     */
+    relayBody(from: string[]): RelayBuilder;
+}
+export declare function relayBuilder(): RelayBuilder;
+//# sourceMappingURL=builder.d.ts.map

package/dist-esm/relay/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/relay/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAQ;;IAMd,KAAK,IAAI,KAAK;IAIrB;;;;;OAKG;IACI,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY;IAKhE;;;;;OAKG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY;IAKjD;;;;OAIG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY;IAK/D;;;OAGG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY;IAK/C;;;;OAIG;IACI,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY;IAK9D;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY;CAI/C;AAED,wBAAgB,YAAY,IAAI,YAAY,CAE3C"}

package/dist-esm/relay/builder.js

@@ -0,0 +1,66 @@
+export class RelayBuilder {
+    constructor() {
+        this.relay = { headers: [], query: [], body: [] };
+    }
+    build() {
+        return this.relay;
+    }
+    /**
+     * Relay a request header using a different name.
+     * Header relay rules aren't case-sensitive because http headers aren't case sensitive.
+     * @param from The name of the request header to relay from the incoming request.
+     * @param to   The new name of the request header to relay to the outgoing request.
+     */
+    relayHeaderRename(from, to) {
+        this.relay.headers.push({ [from.toLowerCase()]: to.toLowerCase() });
+        return this;
+    }
+    /**
+     * Relay request headers using the same names.
+     * @param from The names of the incoming request headers to relay from.
+     *
+     * Header relay rules aren't case-sensitive because http headers aren't case sensitive.
+     */
+    relayHeaders(from) {
+        this.relay.headers.push(...from);
+        return this;
+    }
+    /**
+     * Relay a request query parameter using a different name.
+     * @param from The name of the request query parameter to relay from the incoming request.
+     * @param to   The new name of the request query parameter to relay to the outgoing request.
+     */
+    relayQueryRename(from, to) {
+        this.relay.query.push({ [from]: to });
+        return this;
+    }
+    /**
+     * Relay request query parameters using the same names.
+     * @param from The names of the incoming request query parameters to relay from.
+     */
+    relayQuery(from) {
+        this.relay.query.push(...from);
+        return this;
+    }
+    /**
+     * Relay request a query body field using a different name.
+     * @param from The name of the request body field to relay from the incoming request.
+     * @param to   The new name of the request body field to relay to the outgoing request.
+     */
+    relayBodyRename(from, to) {
+        this.relay.body.push({ [from]: to });
+        return this;
+    }
+    /**
+     * Relay query body fields using the same names.
+     * @param from: The names of the incoming request body fields to relay from.
+     */
+    relayBody(from) {
+        this.relay.body.push(...from);
+        return this;
+    }
+}
+export function relayBuilder() {
+    return new RelayBuilder();
+}
+//# sourceMappingURL=builder.js.map

package/dist-esm/relay/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/relay/builder.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IAGvB;QACE,IAAI,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACpD,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,iBAAiB,CAAC,IAAY,EAAE,EAAU;QAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,YAAY,CAAC,IAAc;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,gBAAgB,CAAC,IAAY,EAAE,EAAU;QAC9C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,IAAc;QAC9B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,IAAY,EAAE,EAAU;QAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,SAAS,CAAC,IAAc;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}

package/dist-esm/relay/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Relay is used by browser, or any caller, to ask agents forward specific request headers,
+ * request query parameters, and request body fields contained in the incoming request,
+ * to all subsequent outgoing agent -> server requests (if there's any).
+ *
+ * Relay will always override the original outgoing requests' payload, if a conflict happens.
+ *
+ * In browser -> agent requests, a sample incoming request with Relay rules in its body looks like below:
+ * headers: {
+ *   Authorization: authorization-value,
+ *   x-superblocks-agent-id: agent-id-value
+ * }
+ *
+ * query: {
+ *   environment: environment-value,
+ * }
+ *
+ * body: {
+ *  relays: {
+ *   // Relay x-superblocks-agent-id to the same name. Relay Authorization to a new name x-superblocks-api-key.
+ *   headers: [{Authorization: x-superblocks-api-key}, x-superblocks-agent-id],
+ *
+ *   // Relay environment to the same name.
+ *   query: [environment],
+ *
+ *   // Relay isPublished to a new name viewMode.
+ *   body: [{isPublished: viewMode}]
+ *  },
+ *  isPublished: isPublished-value,
+ * }
+ *
+ * Now in the subsequent outgoing agent -> server requests, the relayed field will show up as
+ *
+ * headers: {
+ *   ...existing_headers,
+ *   x-superblocks-api-key: authorization-value,
+ *   x-superblocks-agent-id: agent-id-value
+ * }
+ *
+ * query: {
+ *   ...existing_query,
+ *   environment: environment-value
+ * }
+ *
+ * body: {
+ *   ...existing_body,
+ *   viewMode: isPublished-value
+ * }
+ *
+ */
+export * from './types';
+export * from './builder';
+//# sourceMappingURL=index.d.ts.map

package/dist-esm/relay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/relay/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist-esm/relay/index.js

@@ -0,0 +1,53 @@
+/**
+ * Relay is used by browser, or any caller, to ask agents forward specific request headers,
+ * request query parameters, and request body fields contained in the incoming request,
+ * to all subsequent outgoing agent -> server requests (if there's any).
+ *
+ * Relay will always override the original outgoing requests' payload, if a conflict happens.
+ *
+ * In browser -> agent requests, a sample incoming request with Relay rules in its body looks like below:
+ * headers: {
+ *   Authorization: authorization-value,
+ *   x-superblocks-agent-id: agent-id-value
+ * }
+ *
+ * query: {
+ *   environment: environment-value,
+ * }
+ *
+ * body: {
+ *  relays: {
+ *   // Relay x-superblocks-agent-id to the same name. Relay Authorization to a new name x-superblocks-api-key.
+ *   headers: [{Authorization: x-superblocks-api-key}, x-superblocks-agent-id],
+ *
+ *   // Relay environment to the same name.
+ *   query: [environment],
+ *
+ *   // Relay isPublished to a new name viewMode.
+ *   body: [{isPublished: viewMode}]
+ *  },
+ *  isPublished: isPublished-value,
+ * }
+ *
+ * Now in the subsequent outgoing agent -> server requests, the relayed field will show up as
+ *
+ * headers: {
+ *   ...existing_headers,
+ *   x-superblocks-api-key: authorization-value,
+ *   x-superblocks-agent-id: agent-id-value
+ * }
+ *
+ * query: {
+ *   ...existing_query,
+ *   environment: environment-value
+ * }
+ *
+ * body: {
+ *   ...existing_body,
+ *   viewMode: isPublished-value
+ * }
+ *
+ */
+export * from './types';
+export * from './builder';
+//# sourceMappingURL=index.js.map

package/dist-esm/relay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/relay/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist-esm/relay/types.d.ts

@@ -0,0 +1,9 @@
+export type RelayRules = (string | Record<string, string>)[];
+export interface Relay {
+    headers: RelayRules;
+    query: RelayRules;
+    body: RelayRules;
+}
+export declare const NO_RELAY: Relay;
+export declare const RELAY_BODY_FIELD_NAME = "relays";
+//# sourceMappingURL=types.d.ts.map

package/dist-esm/relay/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/relay/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;AAE7D,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,eAAO,MAAM,QAAQ,EAAE,KAA4C,CAAC;AAEpE,eAAO,MAAM,qBAAqB,WAAW,CAAC"}

package/dist-esm/relay/types.js

@@ -0,0 +1,3 @@
+export const NO_RELAY = { headers: [], body: [], query: [] };
+export const RELAY_BODY_FIELD_NAME = 'relays';
+//# sourceMappingURL=types.js.map

package/dist-esm/relay/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/relay/types.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,QAAQ,GAAU,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAEpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAC"}

package/dist-esm/signing/JSON/fast.d.ts

@@ -0,0 +1,2 @@
+export declare function stableJSONStringify_fast(value: unknown): string | undefined;
+//# sourceMappingURL=fast.d.ts.map

package/dist-esm/signing/JSON/fast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast.d.ts","sourceRoot":"","sources":["../../../src/signing/JSON/fast.ts"],"names":[],"mappings":"AAiBA,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE3E"}

package/dist-esm/signing/JSON/fast.js

@@ -0,0 +1,20 @@
+// A replacer function to be used with JSON.stringify.
+// It sorts the keys of an object so that they are traversed by `JSON.stringify` in the canonical order.
+function replacer(_key, value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return value;
+    }
+    // `value` is an object
+    const sortedObj = {};
+    Object.keys(value)
+        .sort()
+        .forEach((key) => {
+        sortedObj[key] = value[key];
+    });
+    return sortedObj;
+}
+// export so that it can be used in tests
+export function stableJSONStringify_fast(value) {
+    return JSON.stringify(value, replacer);
+}
+//# sourceMappingURL=fast.js.map

package/dist-esm/signing/JSON/fast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast.js","sourceRoot":"","sources":["../../../src/signing/JSON/fast.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,wGAAwG;AACxG,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACvE,OAAO,KAAK,CAAC;KACd;IACD,uBAAuB;IACvB,MAAM,SAAS,GAAG,EAAE,CAAC;IACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;SACf,IAAI,EAAE;SACN,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACL,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/dist-esm/signing/JSON/index.d.ts

@@ -0,0 +1,5 @@
+import { stableJSONStringify_fast } from './fast';
+export declare const testStringSrc: string;
+export declare const testStringOut: string;
+export declare const stableJSONStringify: typeof stableJSONStringify_fast;
+//# sourceMappingURL=index.d.ts.map

package/dist-esm/signing/JSON/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/signing/JSON/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAC;AAuElD,eAAO,MAAM,aAAa,QAAyC,CAAC;AACpE,eAAO,MAAM,aAAa,QAAqD,CAAC;AAKhF,eAAO,MAAM,mBAAmB,iCAAuE,CAAC"}

package/dist-esm/signing/JSON/index.js

@@ -0,0 +1,69 @@
+import { stableJSONStringify_fast } from './fast';
+import { stableJSONStringify_portable } from './portable';
+// For some signing operations, we need to be able to sign JSON objects in a deterministic and stable way.
+// `JSON.stringify` is not guaranteed to produce a stable output, so we provide our own implementation instead.
+// In general, there are several reasons why JSON serialization might not be stable:
+// * JSON allows insignificant whitespace to be inserted in various places.  `JSON.stringify` does not do that though.
+// * The keys in an object can be serialized in any order. `JSON.stringify` is not stable in that regard because it (mostly)
+//   respects the order in which the keys were added to the object (with the exception of keys that could be interpreted as
+//   indices, which are serialized in numeric order and before all keys).
+// * The characters in a string can be escaped in various ways. For example, the character `\n` can be represented as `\n` or
+//   as `\u000a` and the character `A` can be represented as `A` or as `\u0041`. The EcmaScript spec does not specify which
+//   representation `JSON.stringify` should use. It seems that `JSON.stringify` in modern browsers uses the shortest
+//   representation, but that is not guaranteed by the spec.
+// * Objects can provide a `toJSON` method that behaves in an arbitrary way.
+// * Numbers can be represented in various ways. For example, the number `0` can be represented as `0`, `-0`, `+0`, `0.0`, `-0.0`,
+// Our implementation of `stableJSONStringify` addresses most of these issues:
+// * It does not insert insignificant whitespace.
+// * It sorts the keys in an object in a canonical order defined below.
+// * It uses the shortest representation for each character in a string.
+// * It respects `toJSON` methods, but it cannot protect against `toJSON` implementations that behave in an arbitrary way. We assume
+//   that we will serialize only standard EcmaScript objects such as `Date` which have well-defined `toJSON` methods.
+// * It does not attempt to canonicalize numbers, we rely on the fact the `toJSON` method of numbers returns a string that uses the
+//   shortest representation.
+// Canonical order for object keys:
+// * Keys that could be interpreted as indices are sorted by numeric value and before all other keys. See `isIndexKey` for the definition.
+// * Other keys are sorted in lexicographic case-insensitive order, based on Unicode code points. See `compareObjectKeys` for the details.
+// The rationale for using this order instead of a lexicographical order on all keys is that it allows us to leverage
+// `JSON.stringify` to obtain a more performant implementation.
+// Shortest representation of characters in strings:
+// * We only escape the characters that need to be escaped according to RFC 8259. If a character has a two character escape sequence,
+//   we use that escape sequence. All other characters are represented as a numeric \uXXXX escape sequence. In those sequences, we
+//   always use lowercase hexadecimal digits.
+// * All other characters are represented as unescaped literal characters (i.e. they are represented as themselves).
+// We provide two implementations of `stableJSONStringify`:
+// * `stableJSONStringify_portable` is a portable but slower implementation.
+// * `stableJSONStringify_fast` is a faster implementation that partially relies on the native `JSON.stringify`. This implementation
+//   is not guaranteed to produce the same output as `stableJSONStringify_portable` under all JavaScript engines. Then reason for that is
+//   that `JSON.stringify` is not guaranteed to produce the shortest representation for strings,
+//   but it should do that under most modern JavaScript engines. So we only use this implementation after testing that it
+//   handles strings correctly. This should be the case under all modern JavaScript engines.
+// Some test strings that we use to test that the fast implementation produces the correct output
+// They are broken down into categories of characters
+const testStrings = [
+    {
+        // All C0 control characters: they should represented as \uXXXX numeric escapes, except for \b, \f, \n, \r, \t, which should be represented as \b, \f, \n, \r, \t
+        src: `\x00\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a\x0b\x0c\x0d\x0e\x0f\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f`,
+        out: `\\u0000\\u0001\\u0002\\u0003\\u0004\\u0005\\u0006\\u0007\\b\\t\\n\\u000b\\f\\r\\u000e\\u000f\\u0010\\u0011\\u0012\\u0013\\u0014\\u0015\\u0016\\u0017\\u0018\\u0019\\u001a\\u001b\\u001c\\u001d\\u001e\\u001f`
+    },
+    {
+        // All C1 control characters: they should be represented literally
+        src: `\x80\x81\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x8b\x8c\x8d\x8e\x8f\x90\x91\x92\x93\x94\x95\x96\x97\x98\x99\x9a\x9b\x9c\x9d\x9e\x9f`,
+        out: `\x80\x81\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x8b\x8c\x8d\x8e\x8f\x90\x91\x92\x93\x94\x95\x96\x97\x98\x99\x9a\x9b\x9c\x9d\x9e\x9f`
+    },
+    {
+        // Other characters: they should be represented literally. We test:
+        // * Some ASCII characters
+        // * Some non-ASCII characters in the Basic Multilingual Plane
+        // * Some characters outside the Basic Multilingual Plane
+        src: `aπ€ℤ🍔`,
+        out: `aπ€ℤ🍔`
+    }
+];
+// export so that it can be used in tests
+export const testStringSrc = testStrings.map((x) => x.src).join('');
+export const testStringOut = '"' + testStrings.map((x) => x.out).join('') + '"';
+// TODO: send a log event if the portable but slower implementation is used
+const canUseFast = stableJSONStringify_fast(testStringSrc) === testStringOut;
+export const stableJSONStringify = canUseFast ? stableJSONStringify_fast : stableJSONStringify_portable;
+//# sourceMappingURL=index.js.map

package/dist-esm/signing/JSON/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/signing/JSON/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1D,0GAA0G;AAC1G,+GAA+G;AAE/G,oFAAoF;AACpF,sHAAsH;AACtH,4HAA4H;AAC5H,2HAA2H;AAC3H,yEAAyE;AACzE,6HAA6H;AAC7H,2HAA2H;AAC3H,oHAAoH;AACpH,4DAA4D;AAC5D,4EAA4E;AAC5E,kIAAkI;AAElI,8EAA8E;AAC9E,iDAAiD;AACjD,uEAAuE;AACvE,wEAAwE;AACxE,oIAAoI;AACpI,qHAAqH;AACrH,mIAAmI;AACnI,6BAA6B;AAE7B,mCAAmC;AACnC,0IAA0I;AAC1I,0IAA0I;AAC1I,qHAAqH;AACrH,+DAA+D;AAE/D,oDAAoD;AACpD,qIAAqI;AACrI,kIAAkI;AAClI,6CAA6C;AAC7C,oHAAoH;AAEpH,2DAA2D;AAC3D,4EAA4E;AAC5E,oIAAoI;AACpI,yIAAyI;AACzI,gGAAgG;AAChG,yHAAyH;AACzH,4FAA4F;AAE5F,iGAAiG;AACjG,qDAAqD;AACrD,MAAM,WAAW,GAAmC;IAClD;QACE,iKAAiK;QACjK,GAAG,EAAE,kIAAkI;QACvI,GAAG,EAAE,8MAA8M;KACpN;IACD;QACE,kEAAkE;QAClE,GAAG,EAAE,kIAAkI;QACvI,GAAG,EAAE,kIAAkI;KACxI;IACD;QACE,mEAAmE;QACnE,0BAA0B;QAC1B,8DAA8D;QAC9D,yDAAyD;QACzD,GAAG,EAAE,QAAQ;QACb,GAAG,EAAE,QAAQ;KACd;CACF,CAAC;AAEF,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;AAEhF,2EAA2E;AAC3E,MAAM,UAAU,GAAG,wBAAwB,CAAC,aAAa,CAAC,KAAK,aAAa,CAAC;AAE7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,4BAA4B,CAAC"}

package/dist-esm/signing/JSON/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist-esm/signing/JSON/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/signing/JSON/index.test.ts"],"names":[],"mappings":""}