refactor: expose reference sources independently of standalone setup

src/sources/reference.js

@@ -0,0 +1,10 @@
+import { createUsgsEarthquakeSource } from '../layers/earthquakes/source.js';
+import { createBundledCableSource } from '../layers/submarineCables/bundledSource.js';
+
+/** Construct the existing reference feeds independently of application setup. */
+export function createReferenceSources() {
+  return {
+    earthquakes: createUsgsEarthquakeSource(),
+    cables: createBundledCableSource(),
+  };
+}

src/sources/reference.test.mjs

@@ -0,0 +1,21 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { createReferenceSources } from './reference.js';
+import { createStandaloneReferenceSources } from '../standalone/layerSources.js';
+
+test('reference factories retain compatibility without starting acquisition or sharing instances', (t) => {
+  let requests = 0;
+  t.mock.method(globalThis, 'fetch', () => {
+    requests++;
+    throw new Error('unexpected acquisition');
+  });
+  assert.equal(createReferenceSources, createStandaloneReferenceSources);
+  const first = createReferenceSources();
+  const second = createReferenceSources();
+  assert.deepEqual(Object.keys(first), ['earthquakes', 'cables']);
+  assert.notEqual(first.earthquakes, second.earthquakes);
+  assert.notEqual(first.cables, second.cables);
+  assert.equal(typeof first.earthquakes.getSnapshot, 'function');
+  assert.equal(typeof first.cables.fetch, 'function');
+  assert.equal(requests, 0);
+});

src/standalone/layerSources.js

@@ -7,26 +7,18 @@ import { createCctvSource } from '../layers/cctv/source.js';
 import { createRadioSource } from '../layers/radio/source.js';
 import { createTrafficSource } from '../layers/traffic/source.js';
 import { createBikeshareSource } from '../layers/bikeshare/source.js';
-import { createInstallationSource } from '../layers/installations/index.js';
-import { createSatelliteSource } from '../layers/satellites/index.js';
-import { createLaunchSource } from '../layers/launches/index.js';
-import { createOverpassAlprSource } from '../layers/alpr/index.js';
-import { createFirmsSource } from '../layers/firms/index.js';
-import { createUsgsEarthquakeSource } from '../layers/earthquakes/source.js';
-import { createBundledCableSource } from '../layers/submarineCables/bundledSource.js';
-
-/** Existing reference feeds, usable independently of live source selection. */
-export function createStandaloneReferenceSources() {
-  return {
-    earthquakes: createUsgsEarthquakeSource(),
-    cables: createBundledCableSource(),
-  };
-}
+import { createInstallationSource } from '../layers/installations/source.js';
+import { createSatelliteSource } from '../layers/satellites/source.js';
+import { createLaunchSource } from '../layers/launches/source.js';
+import { createOverpassAlprSource } from '../layers/alpr/source.js';
+import { createFirmsSource } from '../layers/firms/source.js';
+import { createReferenceSources } from '../sources/reference.js';
+export { createReferenceSources as createStandaloneReferenceSources } from '../sources/reference.js';
 
 /** Select standalone providers without starting their acquisition. */
 export function createStandaloneLayerSources() {
   return {
-    ...createStandaloneReferenceSources(),
+    ...createReferenceSources(),
     flights: createOpenSkySource(),
     military: createAdsbLolSource(),
     vessels: createAisStreamSource({