@salesforce/lds-default-luvio 0.1.0-dev1

package/LICENSE.txt

@@ -0,0 +1,82 @@
+Terms of Use
+
+Copyright 2022 Salesforce, Inc. All rights reserved.
+
+These Terms of Use govern the download, installation, and/or use of this
+software provided by Salesforce, Inc. ("Salesforce") (the "Software"), were
+last updated on April 15, 2022, and constitute a legally binding
+agreement between you and Salesforce. If you do not agree to these Terms of
+Use, do not install or use the Software.
+
+Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free
+copyright license to reproduce, prepare derivative works of, publicly
+display, publicly perform, sublicense, and distribute the Software and
+derivative works subject to these Terms. These Terms shall be included in
+all copies or substantial portions of the Software.
+
+Subject to the limited rights expressly granted hereunder, Salesforce
+reserves all rights, title, and interest in and to all intellectual
+property subsisting in the Software. No rights are granted to you hereunder
+other than as expressly set forth herein. Users residing in countries on
+the United States Office of Foreign Assets Control sanction list, or which
+are otherwise subject to a US export embargo, may not use the Software.
+
+Implementation of the Software may require development work, for which you
+are responsible. The Software may contain bugs, errors and
+incompatibilities and is made available on an AS IS basis without support,
+updates, or service level commitments.
+
+Salesforce reserves the right at any time to modify, suspend, or
+discontinue, the Software (or any part thereof) with or without notice. You
+agree that Salesforce shall not be liable to you or to any third party for
+any modification, suspension, or discontinuance.
+
+You agree to defend Salesforce against any claim, demand, suit or
+proceeding made or brought against Salesforce by a third party arising out
+of or accruing from (a) your use of the Software, and (b) any application
+you develop with the Software that infringes any copyright, trademark,
+trade secret, trade dress, patent, or other intellectual property right of
+any person or defames any person or violates their rights of publicity or
+privacy (each a "Claim Against Salesforce"), and will indemnify Salesforce
+from any damages, attorney fees, and costs finally awarded against
+Salesforce as a result of, or for any amounts paid by Salesforce under a
+settlement approved by you in writing of, a Claim Against Salesforce,
+provided Salesforce (x) promptly gives you written notice of the Claim
+Against Salesforce, (y) gives you sole control of the defense and
+settlement of the Claim Against Salesforce (except that you may not settle
+any Claim Against Salesforce unless it unconditionally releases Salesforce
+of all liability), and (z) gives you all reasonable assistance, at your
+expense.
+
+WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT
+SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES,
+INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL,
+PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA,
+OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN
+CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU
+HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+These Terms of Use shall be governed exclusively by the internal laws of
+the State of California, without regard to its conflicts of laws
+rules. Each party hereby consents to the exclusive jurisdiction of the
+state and federal courts located in San Francisco County, California to
+adjudicate any dispute arising out of or relating to these Terms of Use and
+the download, installation, and/or use of the Software. Except as expressly
+stated herein, these Terms of Use constitute the entire agreement between
+the parties, and supersede all prior and contemporaneous agreements,
+proposals, or representations, written or oral, concerning their subject
+matter. No modification, amendment, or waiver of any provision of these
+Terms of Use shall be effective unless it is by an update to these Terms of
+Use that Salesforce makes available, or is in writing and signed by the
+party against whom the modification, amendment, or waiver is to be
+asserted.
+
+Data Privacy: Salesforce may collect, process, and store device,
+system, and other information related to your use of the Software. This
+information includes, but is not limited to, IP address, user metrics, and
+other data ("Usage Data"). Salesforce may use Usage Data for analytics,
+product development, and marketing purposes. You acknowledge that files
+generated in conjunction with the Software may contain sensitive or
+confidential data, and you are solely responsible for anonymizing and
+protecting such data.

package/dist/es/es2018/main.js

@@ -0,0 +1,138 @@
+/**
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/*
+ *  ATTENTION!
+ *  THIS IS A GENERATED FILE FROM https://github.com/salesforce-experience-platform-emu/lds-lightning-platform
+ *  If you would like to contribute to LDS, please follow the steps outlined in the git repo.
+ *  Any changes made to this file in p4 will be automatically overwritten.
+ *  *******************************************************************************************
+ */
+/* proxy-compat-disable */
+import { Luvio, Environment, InMemoryStore } from '@luvio/engine';
+
+/*
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Callbacks to be invoked when registrations happen,
+ */
+const callbacks$1 = [];
+/**
+ * Registrations that have already occurred.
+ *
+ * Note that Registrations are maintained as a list rather than a map to allow
+ * the same id to be registered multiple times with potentially different
+ * data.
+ */
+const registrations = [];
+/**
+ * Invokes callback for each Registration, both past & future. That is, callback
+ * will be invoked exactly as many times as register() is called.
+ *
+ * Note that Registration ids are not guaranteed to be unique. The meaning of
+ * multiple Registrations with the same id is determined by the caller(s) of
+ * register().
+ */
+function forEachRegistration(callback) {
+    callbacks$1.push(callback);
+    registrations.forEach((r) => callback(r));
+}
+/**
+ * Invokes callback when the specified id is registered.
+ *
+ * Note that callback may be invoked:
+ *
+ *    - multiple times if multiple calls to register() specify the id
+ *    - never if the specified id is never registered
+ */
+function withRegistration(id, callback) {
+    forEachRegistration((r) => {
+        if (r.id === id) {
+            callback(r);
+        }
+    });
+}
+/**
+ * Register an id and associated data.
+ *
+ * Callers of register() should make types available that include:
+ *
+ *    - the id they will register
+ *    - definitions for any additional properties on their Registration objects
+ *
+ * For example:
+ *
+ *    export type MyRegistration = {
+ *        id: 'myRegistrationId',
+ *
+ *        // some value that others might need
+ *        myValue: string,
+ *
+ *        // some function that others might want to call
+ *        myFunction: () => void,
+ *    };
+ *    register({ id: 'myRegistrationId', myValue: 'foo', myFunction: () => {} } as MyRegistration);
+ *
+ * The registry itself does not dictate the format of ids nor attempt to coordinate
+ * uniqueness of id values.
+ *
+ * The same id can be registered multiple times with different Registration
+ * objects.
+ */
+function register(r) {
+    registrations.push(r);
+    callbacks$1.forEach((callback) => callback(r));
+}
+
+/*
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+// most recently set default Luvio instance
+let defaultLuvio;
+// callbacks to be invoked when default luvio instance is set/changed
+let callbacks = [];
+/**
+ * Constructs/sets the default Luvio instance. Any previously-set default luvio instance
+ * is overwritten.
+ */
+function setDefaultLuvio(params) {
+    const newLuvio = 'luvio' in params
+        ? params.luvio
+        : 'environment' in params
+            ? new Luvio(params.environment)
+            : 'networkAdapter' in params
+                ? new Luvio(new Environment(params.store || new InMemoryStore(), params.networkAdapter))
+                : undefined;
+    if (newLuvio === undefined) {
+        // eslint-disable-next-line @salesforce/lds/no-error-in-production
+        throw new Error('unable to construct default Luvio instance from supplied parameters');
+    }
+    defaultLuvio = newLuvio;
+    // inform observers
+    for (let i = 0; i < callbacks.length; ++i) {
+        callbacks[i](defaultLuvio);
+    }
+}
+/**
+ * Registers a callback to be invoked with the default Luvio instance. Note that the
+ * callback may be invoked multiple times if the default Luvio changes.
+ *
+ * @param callback callback to be invoked with default Luvio instance
+ */
+function withDefaultLuvio(callback) {
+    if (defaultLuvio) {
+        callback(defaultLuvio);
+    }
+    callbacks.push(callback);
+}
+
+export { forEachRegistration, register, setDefaultLuvio, withDefaultLuvio, withRegistration };
+// version: 0.1.0-dev1-54c03dd38c

package/dist/es/es2018/types/src/main.d.ts

@@ -0,0 +1,30 @@
+import type { NetworkAdapter } from '@luvio/engine';
+import { Environment, Luvio, InMemoryStore } from '@luvio/engine';
+/**
+ * Parameters accepted by setDefaultLuvio.
+ */
+export type SetDefaultLuvioParameters = {
+    luvio: Luvio;
+} | {
+    environment: Environment;
+} | {
+    store?: InMemoryStore;
+    networkAdapter: NetworkAdapter;
+};
+/**
+ * Callback used to inform interested parties that a new default Luvio has been set.
+ */
+export type Callback = (luvio: Luvio) => void;
+/**
+ * Constructs/sets the default Luvio instance. Any previously-set default luvio instance
+ * is overwritten.
+ */
+export declare function setDefaultLuvio(params: SetDefaultLuvioParameters): void;
+/**
+ * Registers a callback to be invoked with the default Luvio instance. Note that the
+ * callback may be invoked multiple times if the default Luvio changes.
+ *
+ * @param callback callback to be invoked with default Luvio instance
+ */
+export declare function withDefaultLuvio(callback: Callback): void;
+export * from './registry';

package/dist/es/es2018/types/src/registry.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Registration information. Actual Registration objects will typically contain
+ * additional fields. Id values and additional fields in the Registration should
+ * be specified in types exported by the code that calls register().
+ */
+export type Registration = {
+    id: string;
+};
+/**
+ * Callback used to inform interested parties that something has been registered.
+ */
+export type RegistrationCallback<R = Registration> = (registration: R) => void;
+/**
+ * Invokes callback for each Registration, both past & future. That is, callback
+ * will be invoked exactly as many times as register() is called.
+ *
+ * Note that Registration ids are not guaranteed to be unique. The meaning of
+ * multiple Registrations with the same id is determined by the caller(s) of
+ * register().
+ */
+export declare function forEachRegistration(callback: RegistrationCallback): void;
+/**
+ * Invokes callback when the specified id is registered.
+ *
+ * Note that callback may be invoked:
+ *
+ *    - multiple times if multiple calls to register() specify the id
+ *    - never if the specified id is never registered
+ */
+export declare function withRegistration<R extends Registration>(id: R['id'], callback: RegistrationCallback<R>): void;
+/**
+ * Register an id and associated data.
+ *
+ * Callers of register() should make types available that include:
+ *
+ *    - the id they will register
+ *    - definitions for any additional properties on their Registration objects
+ *
+ * For example:
+ *
+ *    export type MyRegistration = {
+ *        id: 'myRegistrationId',
+ *
+ *        // some value that others might need
+ *        myValue: string,
+ *
+ *        // some function that others might want to call
+ *        myFunction: () => void,
+ *    };
+ *    register({ id: 'myRegistrationId', myValue: 'foo', myFunction: () => {} } as MyRegistration);
+ *
+ * The registry itself does not dictate the format of ids nor attempt to coordinate
+ * uniqueness of id values.
+ *
+ * The same id can be registered multiple times with different Registration
+ * objects.
+ */
+export declare function register<R extends Registration = Registration>(r: R): void;

package/dist/es/es2018/types/src/sfdc.d.ts

@@ -0,0 +1,2 @@
+export * from './main';
+export { Environment, GraphNode, HttpStatusCode, InMemoryStore, Luvio, Reader, StoreResolveResultState, adapterToNetworkPriority, coerceAdapterRequestContext, createCustomAdapterEventEmitter, emitAdapterEvent, } from '@luvio/engine';

package/package.json

@@ -0,0 +1,73 @@
+{
+    "name": "@salesforce/lds-default-luvio",
+    "version": "0.1.0-dev1",
+    "license": "SEE LICENSE IN LICENSE.txt",
+    "description": "rendezvous point for producers & consumers of the default luvio instance",
+    "bugs": "This software is provided as-is with no support provided.",
+    "main": "dist/es/es2018/main.js",
+    "module": "dist/es/es2018/main.js",
+    "types": "dist/es/es2018/types/src/main.d.ts",
+    "files": [
+        "dist",
+        "LICENSE.txt",
+        "sfdc"
+    ],
+    "exports": {
+        ".": {
+            "types": "./dist/es/es2018/types/src/main.d.ts",
+            "import": "./dist/es/es2018/main.js",
+            "require": "./dist/es/es2018/main.js"
+        },
+        "./sfdc": {
+            "types": "./sfdc/ldsEngine.d.ts",
+            "import": "./sfdc/ldsEngine.js",
+            "default": "./sfdc/ldsEngine.js"
+        },
+        "./sfdcNoAura": {
+            "types": "./sfdc/ldsEngineNoAura.d.ts",
+            "import": "./sfdc/ldsEngineNoAura.js",
+            "default": "./sfdc/ldsEngineNoAura.js"
+        }
+    },
+    "sfdc": {
+        "srcOverride": "sfdc/ldsEngine.js",
+        "path": "forcelds/ldsEngine/",
+        "publishedFileName": "ldsEngine.js",
+        "overrides": {
+            "outputModuleName": "ldsEngine",
+            "artifacts": {
+                "ldsEngineNoAura.js": {
+                    "output": {
+                        "path": "ui-bridge-components/modules/native/ldsEngineMobile/ldsEngineMobile.js"
+                    }
+                }
+            }
+        }
+    },
+    "scripts": {
+        "prepare": "yarn build",
+        "build": "rollup --bundleConfigAsCjs --config rollup.config.js",
+        "clean": "rm -rf dist sfdc",
+        "test:unit": "jest",
+        "test:debug": "node --inspect-brk ../../node_modules/.bin/jest --runInBand",
+        "release:corejar": "yarn build && ../core-build/scripts/core.js --name=lds-default-luvio"
+    },
+    "dependencies": {
+        "@luvio/engine": "0.158.7"
+    },
+    "nx": {
+        "targets": {
+            "build": {
+                "outputs": [
+                    "{projectRoot}/dist",
+                    "{projectRoot}/sfdc"
+                ]
+            },
+            "build:raml": {
+                "outputs": [
+                    "{projectRoot}/src/generated"
+                ]
+            }
+        }
+    }
+}

package/sfdc/ldsEngine.d.ts

@@ -0,0 +1 @@
+export * from './types/sfdc';

package/sfdc/ldsEngine.js

@@ -0,0 +1,187 @@
+/**
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/**
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/*
+ *  ATTENTION!
+ *  THIS IS A GENERATED FILE FROM https://github.com/salesforce-experience-platform-emu/lds-lightning-platform
+ *  If you would like to contribute to LDS, please follow the steps outlined in the git repo.
+ *  Any changes made to this file in p4 will be automatically overwritten.
+ *  *******************************************************************************************
+ */
+/* proxy-compat-disable */
+import { Luvio, Environment, InMemoryStore } from 'force/luvioEngine';
+export { Environment, GraphNode, HttpStatusCode, InMemoryStore, Luvio, Reader, StoreResolveResultState, adapterToNetworkPriority, coerceAdapterRequestContext, createCustomAdapterEventEmitter, emitAdapterEvent } from 'force/luvioEngine';
+import networkAdapter from 'force/ldsNetwork';
+
+/*
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Callbacks to be invoked when registrations happen,
+ */
+const callbacks$1 = [];
+/**
+ * Registrations that have already occurred.
+ *
+ * Note that Registrations are maintained as a list rather than a map to allow
+ * the same id to be registered multiple times with potentially different
+ * data.
+ */
+const registrations = [];
+/**
+ * Invokes callback for each Registration, both past & future. That is, callback
+ * will be invoked exactly as many times as register() is called.
+ *
+ * Note that Registration ids are not guaranteed to be unique. The meaning of
+ * multiple Registrations with the same id is determined by the caller(s) of
+ * register().
+ */
+function forEachRegistration(callback) {
+    callbacks$1.push(callback);
+    registrations.forEach((r) => callback(r));
+}
+/**
+ * Invokes callback when the specified id is registered.
+ *
+ * Note that callback may be invoked:
+ *
+ *    - multiple times if multiple calls to register() specify the id
+ *    - never if the specified id is never registered
+ */
+function withRegistration(id, callback) {
+    forEachRegistration((r) => {
+        if (r.id === id) {
+            callback(r);
+        }
+    });
+}
+/**
+ * Register an id and associated data.
+ *
+ * Callers of register() should make types available that include:
+ *
+ *    - the id they will register
+ *    - definitions for any additional properties on their Registration objects
+ *
+ * For example:
+ *
+ *    export type MyRegistration = {
+ *        id: 'myRegistrationId',
+ *
+ *        // some value that others might need
+ *        myValue: string,
+ *
+ *        // some function that others might want to call
+ *        myFunction: () => void,
+ *    };
+ *    register({ id: 'myRegistrationId', myValue: 'foo', myFunction: () => {} } as MyRegistration);
+ *
+ * The registry itself does not dictate the format of ids nor attempt to coordinate
+ * uniqueness of id values.
+ *
+ * The same id can be registered multiple times with different Registration
+ * objects.
+ */
+function register(r) {
+    registrations.push(r);
+    callbacks$1.forEach((callback) => callback(r));
+}
+
+/*
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+// most recently set default Luvio instance
+let defaultLuvio;
+// callbacks to be invoked when default luvio instance is set/changed
+let callbacks = [];
+/**
+ * Constructs/sets the default Luvio instance. Any previously-set default luvio instance
+ * is overwritten.
+ */
+function setDefaultLuvio(params) {
+    const newLuvio = 'luvio' in params
+        ? params.luvio
+        : 'environment' in params
+            ? new Luvio(params.environment)
+            : 'networkAdapter' in params
+                ? new Luvio(new Environment(params.store || new InMemoryStore(), params.networkAdapter))
+                : undefined;
+    if (newLuvio === undefined) {
+        // eslint-disable-next-line @salesforce/lds/no-error-in-production
+        throw new Error('unable to construct default Luvio instance from supplied parameters');
+    }
+    defaultLuvio = newLuvio;
+    // inform observers
+    for (let i = 0; i < callbacks.length; ++i) {
+        callbacks[i](defaultLuvio);
+    }
+}
+/**
+ * Registers a callback to be invoked with the default Luvio instance. Note that the
+ * callback may be invoked multiple times if the default Luvio changes.
+ *
+ * @param callback callback to be invoked with default Luvio instance
+ */
+function withDefaultLuvio(callback) {
+    if (defaultLuvio) {
+        callback(defaultLuvio);
+    }
+    callbacks.push(callback);
+}
+
+/*
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+// bundling of lds-default-luvio and @luvio/engine for core
+// The code in lds-runtime-aura (force/ldsEngineCreator) depends on Aura module
+// services to invoke its LDS initialization logic. Unfortunately, Aura component
+// tests do not support module services and have no analogous function. The net
+// result is that LDS is never initialized in the iframe that loads the Aura
+// component test & any attempts to create an LWC component that uses an LDS
+// adapter fail because the wire adapter constructors are undefined (W-9233247).
+//
+// The code below is the least offensive workaround we could come up with. When
+// this code (force/ldsEngine) is loaded via static imports in an Aura component
+// test iframe, it will perform a minimal initialization of LDS that allows
+// the test to run and access data on the server. The instrumentation and
+// configuration initialization steps from lds-runtime-aura are skipped to
+// keep the logic simpler & faster.
+//
+// For future reference, here are the values we see from getApp():
+//
+// - for a regular .app, the name of the app, e.g. "one:one"
+// - for the top-level iframe of a .app loaded in JSTEST mode, "aurajstest:jstest"
+// - for the top-level iframe of a .cmp loaded in JSTEST mode, undefined
+// - for a test iframe of a .cmp or .app test loaded via
+//   /auratest/test.app?testName=..&aura.mode=AUTOJSTEST, undefined
+// - for a test iframe loaded via /aura?... (no clue where/how these are
+//   generated), undefined
+if (typeof $A !== 'undefined' &&
+    $A.getContext().getMode().indexOf('AUTOJSTEST') > -1 &&
+    $A.getContext().getApp() === undefined) {
+    const storeOptions = {
+        scheduler: () => { },
+    };
+    const store = new InMemoryStore(storeOptions);
+    const environment = new Environment(store, networkAdapter);
+    const luvio = new Luvio(environment);
+    setDefaultLuvio({ luvio });
+}
+
+export { forEachRegistration, register, setDefaultLuvio, withDefaultLuvio, withRegistration };
+// version: 0.1.0-dev1-54c03dd38c

package/sfdc/ldsEngineNoAura.d.ts

@@ -0,0 +1 @@
+export * from './types/main';

package/sfdc/ldsEngineNoAura.js

@@ -0,0 +1,144 @@
+/**
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/**
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/*
+ *  ATTENTION!
+ *  THIS IS A GENERATED FILE FROM https://github.com/salesforce-experience-platform-emu/lds-lightning-platform
+ *  If you would like to contribute to LDS, please follow the steps outlined in the git repo.
+ *  Any changes made to this file in p4 will be automatically overwritten.
+ *  *******************************************************************************************
+ */
+/* proxy-compat-disable */
+import { Luvio, Environment, InMemoryStore } from 'force/luvioEngine';
+
+/*
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Callbacks to be invoked when registrations happen,
+ */
+const callbacks$1 = [];
+/**
+ * Registrations that have already occurred.
+ *
+ * Note that Registrations are maintained as a list rather than a map to allow
+ * the same id to be registered multiple times with potentially different
+ * data.
+ */
+const registrations = [];
+/**
+ * Invokes callback for each Registration, both past & future. That is, callback
+ * will be invoked exactly as many times as register() is called.
+ *
+ * Note that Registration ids are not guaranteed to be unique. The meaning of
+ * multiple Registrations with the same id is determined by the caller(s) of
+ * register().
+ */
+function forEachRegistration(callback) {
+    callbacks$1.push(callback);
+    registrations.forEach((r) => callback(r));
+}
+/**
+ * Invokes callback when the specified id is registered.
+ *
+ * Note that callback may be invoked:
+ *
+ *    - multiple times if multiple calls to register() specify the id
+ *    - never if the specified id is never registered
+ */
+function withRegistration(id, callback) {
+    forEachRegistration((r) => {
+        if (r.id === id) {
+            callback(r);
+        }
+    });
+}
+/**
+ * Register an id and associated data.
+ *
+ * Callers of register() should make types available that include:
+ *
+ *    - the id they will register
+ *    - definitions for any additional properties on their Registration objects
+ *
+ * For example:
+ *
+ *    export type MyRegistration = {
+ *        id: 'myRegistrationId',
+ *
+ *        // some value that others might need
+ *        myValue: string,
+ *
+ *        // some function that others might want to call
+ *        myFunction: () => void,
+ *    };
+ *    register({ id: 'myRegistrationId', myValue: 'foo', myFunction: () => {} } as MyRegistration);
+ *
+ * The registry itself does not dictate the format of ids nor attempt to coordinate
+ * uniqueness of id values.
+ *
+ * The same id can be registered multiple times with different Registration
+ * objects.
+ */
+function register(r) {
+    registrations.push(r);
+    callbacks$1.forEach((callback) => callback(r));
+}
+
+/*
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+// most recently set default Luvio instance
+let defaultLuvio;
+// callbacks to be invoked when default luvio instance is set/changed
+let callbacks = [];
+/**
+ * Constructs/sets the default Luvio instance. Any previously-set default luvio instance
+ * is overwritten.
+ */
+function setDefaultLuvio(params) {
+    const newLuvio = 'luvio' in params
+        ? params.luvio
+        : 'environment' in params
+            ? new Luvio(params.environment)
+            : 'networkAdapter' in params
+                ? new Luvio(new Environment(params.store || new InMemoryStore(), params.networkAdapter))
+                : undefined;
+    if (newLuvio === undefined) {
+        // eslint-disable-next-line @salesforce/lds/no-error-in-production
+        throw new Error('unable to construct default Luvio instance from supplied parameters');
+    }
+    defaultLuvio = newLuvio;
+    // inform observers
+    for (let i = 0; i < callbacks.length; ++i) {
+        callbacks[i](defaultLuvio);
+    }
+}
+/**
+ * Registers a callback to be invoked with the default Luvio instance. Note that the
+ * callback may be invoked multiple times if the default Luvio changes.
+ *
+ * @param callback callback to be invoked with default Luvio instance
+ */
+function withDefaultLuvio(callback) {
+    if (defaultLuvio) {
+        callback(defaultLuvio);
+    }
+    callbacks.push(callback);
+}
+
+export { forEachRegistration, register, setDefaultLuvio, withDefaultLuvio, withRegistration };
+// version: 0.1.0-dev1-54c03dd38c

package/sfdc/types/main.d.ts

@@ -0,0 +1,30 @@
+import type { NetworkAdapter } from '@luvio/engine';
+import { Environment, Luvio, InMemoryStore } from '@luvio/engine';
+/**
+ * Parameters accepted by setDefaultLuvio.
+ */
+export type SetDefaultLuvioParameters = {
+    luvio: Luvio;
+} | {
+    environment: Environment;
+} | {
+    store?: InMemoryStore;
+    networkAdapter: NetworkAdapter;
+};
+/**
+ * Callback used to inform interested parties that a new default Luvio has been set.
+ */
+export type Callback = (luvio: Luvio) => void;
+/**
+ * Constructs/sets the default Luvio instance. Any previously-set default luvio instance
+ * is overwritten.
+ */
+export declare function setDefaultLuvio(params: SetDefaultLuvioParameters): void;
+/**
+ * Registers a callback to be invoked with the default Luvio instance. Note that the
+ * callback may be invoked multiple times if the default Luvio changes.
+ *
+ * @param callback callback to be invoked with default Luvio instance
+ */
+export declare function withDefaultLuvio(callback: Callback): void;
+export * from './registry';

package/sfdc/types/registry.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Registration information. Actual Registration objects will typically contain
+ * additional fields. Id values and additional fields in the Registration should
+ * be specified in types exported by the code that calls register().
+ */
+export type Registration = {
+    id: string;
+};
+/**
+ * Callback used to inform interested parties that something has been registered.
+ */
+export type RegistrationCallback<R = Registration> = (registration: R) => void;
+/**
+ * Invokes callback for each Registration, both past & future. That is, callback
+ * will be invoked exactly as many times as register() is called.
+ *
+ * Note that Registration ids are not guaranteed to be unique. The meaning of
+ * multiple Registrations with the same id is determined by the caller(s) of
+ * register().
+ */
+export declare function forEachRegistration(callback: RegistrationCallback): void;
+/**
+ * Invokes callback when the specified id is registered.
+ *
+ * Note that callback may be invoked:
+ *
+ *    - multiple times if multiple calls to register() specify the id
+ *    - never if the specified id is never registered
+ */
+export declare function withRegistration<R extends Registration>(id: R['id'], callback: RegistrationCallback<R>): void;
+/**
+ * Register an id and associated data.
+ *
+ * Callers of register() should make types available that include:
+ *
+ *    - the id they will register
+ *    - definitions for any additional properties on their Registration objects
+ *
+ * For example:
+ *
+ *    export type MyRegistration = {
+ *        id: 'myRegistrationId',
+ *
+ *        // some value that others might need
+ *        myValue: string,
+ *
+ *        // some function that others might want to call
+ *        myFunction: () => void,
+ *    };
+ *    register({ id: 'myRegistrationId', myValue: 'foo', myFunction: () => {} } as MyRegistration);
+ *
+ * The registry itself does not dictate the format of ids nor attempt to coordinate
+ * uniqueness of id values.
+ *
+ * The same id can be registered multiple times with different Registration
+ * objects.
+ */
+export declare function register<R extends Registration = Registration>(r: R): void;

package/sfdc/types/sfdc.d.ts

@@ -0,0 +1,2 @@
+export * from './main';
+export { Environment, GraphNode, HttpStatusCode, InMemoryStore, Luvio, Reader, StoreResolveResultState, adapterToNetworkPriority, coerceAdapterRequestContext, createCustomAdapterEventEmitter, emitAdapterEvent, } from '@luvio/engine';