@celsoft/coordinator 0.0.0 → 0.1.0

package/client/client.mjs

@@ -0,0 +1,28 @@
+/** The Bus Client: what a Landing Script imports as `@celsoft/coordinator/client` to act on the bus as the user, with the
+ * Run Token the server gave its run. */
+
+const url = process.env.COORDINATOR_BUS;
+const token = process.env.COORDINATOR_TOKEN;
+
+/** The slot this run is for, org/repo@track: the scope of the run; ask the bus (bus.send('slot', { slot })) for the rest. */
+export const slot = process.env.COORDINATOR_SLOT ?? null;
+
+async function call(path, body) {
+	if (!url || !token) throw new Error('no bus to reach: the coordinator runs this script as a Landing Script, which gives it one');
+	const r = await fetch(url + path, {
+		method: body === undefined ? 'GET' : 'POST',
+		headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+		body: body === undefined ? undefined : JSON.stringify(body),
+		signal: AbortSignal.timeout(60_000)
+	});
+	const data = await r.json();
+	if (!r.ok) throw new Error(String(data.error ?? r.statusText));
+	return data;
+}
+
+export const bus = {
+	/** Send a Message Type of the catalog as the user, with its body; answers with the bus's answer, or throws its refusal. */
+	send: (type, body = {}) => call('/api/user', { type, body }),
+	/** The whole bus, as the user sees it. */
+	state: () => call('/api/state')
+};

package/client/hooks.mjs

@@ -0,0 +1,7 @@
+/** Resolves the Bus Client's name to its file; every other import resolves as Node would. */
+export const NAME = '@celsoft/coordinator/client';
+const CLIENT = new URL('./client.mjs', import.meta.url).href;
+
+export async function resolve(specifier, context, next) {
+	return specifier === NAME ? { url: CLIENT, shortCircuit: true } : next(specifier, context);
+}

package/client/register.mjs

@@ -0,0 +1,5 @@
+/** Loaded before a Landing Script, so `import { bus } from '@celsoft/coordinator/client'` finds the Bus Client wherever the
+ * script lives. */
+import { register } from 'node:module';
+
+register('./hooks.mjs', import.meta.url);