@sponson/adapters 0.4.0 → 0.5.0

package/dist/http-adapter-list.js

@@ -0,0 +1,421 @@
+/**
+ * `http.list_item`: one value kept in a collection held by a parent object (an allowed origin, a callback URL, a
+ * config var), by read-modify-write. The collection is a JSON array, a delimited string or a keyed map (`shape`).
+ * See ADR 0017 and docs/plan-format.md#httplist_item.
+ *
+ * - Key: `<parent.path>#<list_path>=<item>`: which collection, and which item in it (for map items of an array,
+ *   the value of `key_field`; for a keyed map, the entry's name). The provider block is part of the ledger
+ *   identity already.
+ * - Id: the item's locator as canonical JSON (how to read and write the parent, where and how the collection is
+ *   stored, which item), so `destroy` needs nothing but the ledger.
+ * - Hash: the item's state in canonical JSON: the value itself, the declared fields of a map item, or a keyed
+ *   entry's value.
+ * - Writes replace the whole collection (`PUT`, or `PATCH`/`POST` sent as idempotent, so a dropped connection is
+ *   retried), except a keyed map with `send: field`, which is sent as a merge patch of the one entry (`null`
+ *   deletes it). Then the parent is read again: the write counts only once the item is seen as planned. A
+ *   collection that loses the item to a concurrent writer is written again, up to MAX_ATTEMPTS times.
+ * - Lock: the parent object (`lockOn`, ADR 0019), so Sponson's writers in other scopes and environments never
+ *   interleave between a read and a write. There is no precondition (ETag): only a writer outside Sponson can.
+ */
+import { SponsonError, canonicalJson } from "@sponson/core";
+import { ABSENT, SENSITIVE, assertNoPending, desiredSide, paramError } from "./common.js";
+import { isObject } from "./http.js";
+import { failedWith, httpClient, withLineCredential, write } from "./http-adapter-client.js";
+import { expandRecipe } from "./recipes.js";
+import { ADAPTER, apiBlock, apiEnvironment, at, credentialInputs, fieldTokens, fillPath, firstMarker, isKeep, parseApi, parseListItem, pointerTokens, projection, setAt, stateHash } from "./http-adapter-spec.js";
+/** Read-modify-write rounds before giving up on a collection that keeps changing under us. */
+export const MAX_ATTEMPTS = 3;
+/** What `read` found, kept for `diff` and `apply` of the same inspection. */
+const found = new WeakMap();
+/** The item's identity: the value, the `key_field` of a map item, or a keyed entry's name (strings for both string shapes). */
+function keyValue(spec) {
+    if (spec.shape !== "array")
+        return firstMarker(spec.item) ? spec.item : String(spec.item);
+    return spec.keyField === undefined ? spec.item : at(spec.item, fieldTokens(spec.keyField));
+}
+function text(v) {
+    return typeof v === "string" ? v : canonicalJson(v);
+}
+/** The locator, or undefined while a value it depends on is pending. */
+function locatorOf(spec) {
+    const read = fillPath(spec.parent.readPath, spec.vars);
+    const path = fillPath(spec.parent.path, spec.vars);
+    const item = keyValue(spec);
+    if (read === undefined || path === undefined || firstMarker(item) !== undefined)
+        return undefined;
+    return {
+        read,
+        ...(spec.parent.readMethod === "POST" ? { read_method: "POST" } : {}),
+        write: `${spec.parent.method} ${path}`,
+        list: spec.listPath,
+        send: spec.parent.send,
+        ...(spec.parent.itemPath !== "" ? { item_path: spec.parent.itemPath } : {}),
+        shape: spec.shape,
+        ...(spec.shape === "delimited" ? { sep: spec.separator } : {}),
+        ...(spec.keyField !== undefined ? { key_field: spec.keyField } : {}),
+        ...(spec.parent.contentType ? { content_type: spec.parent.contentType } : {}),
+        item,
+        ...(spec.destroy === "keep" ? { keep: true } : {}),
+        ...(spec.parent.ifMissing === "empty" ? { missing_empty: true } : {}),
+        ...(spec.parent.whenEmpty === "delete" ? { delete_empty: true } : {}),
+        // Only when set, so the record ids of lines that do not use it are unchanged.
+        ...(spec.parent.writeListPath !== undefined ? { write_list: spec.parent.writeListPath } : {}),
+    };
+}
+function writePath(loc) {
+    return loc.write.slice(loc.write.indexOf(" ") + 1);
+}
+function keyOf(loc) {
+    return `${writePath(loc)}#${loc.list}=${text(loc.item)}`;
+}
+/**
+ * What the ledger knows a line's item by: its key and record id (the locator), or undefined while pending. The
+ * recipe identity lock (recipes.test.ts) pins it per recipe op.
+ */
+export function listItemIdentity(spec) {
+    const loc = locatorOf(spec);
+    return loc ? { key: keyOf(loc), id: canonicalJson(loc) } : undefined;
+}
+function labelOf(spec, loc) {
+    return `${spec.api} ${writePath(loc)}${loc.list} item ${text(loc.item)}`;
+}
+function sameKey(a, b) {
+    return a !== undefined && canonicalJson(a) === canonicalJson(b);
+}
+// ---------------------------------------------------------------------------
+// The three shapes
+// ---------------------------------------------------------------------------
+function badShape(loc, expected) {
+    return new SponsonError("PROVIDER_RESPONSE", `${ADAPTER}: ${loc.read_method ?? "GET"} ${loc.read}: expected ${expected} at \`list_path\` ${loc.list || '""'}`, { adapter: ADAPTER, param: "list_path" });
+}
+/** The identifying value of one array element: itself, or its `key_field`; undefined when it has none. */
+function arrayKey(e, keyField) {
+    if (keyField === undefined)
+        return isObject(e) || Array.isArray(e) ? undefined : e;
+    return isObject(e) ? at(e, fieldTokens(keyField)) : undefined;
+}
+/**
+ * The collection as entries. Absent or null is empty. In an XML document a list of one is its element alone (and
+ * an empty element is ""), so for an XML API a lone value is a list of one.
+ */
+function decode(raw, loc, xml) {
+    if (raw === undefined || raw === null || (xml && raw === ""))
+        return [];
+    if (loc.shape === "array") {
+        if (xml && !Array.isArray(raw))
+            raw = [raw];
+        if (!Array.isArray(raw))
+            throw badShape(loc, "a list");
+        return raw.map((value) => ({ key: arrayKey(value, loc.key_field), value }));
+    }
+    if (loc.shape === "delimited") {
+        if (typeof raw !== "string")
+            throw badShape(loc, `a string of values separated by "${loc.sep ?? ","}"`);
+        return raw
+            .split(loc.sep ?? ",")
+            .map((s) => s.trim())
+            .filter((s) => s !== "")
+            .map((s) => ({ key: s, value: s }));
+    }
+    if (!isObject(raw))
+        throw badShape(loc, "a map");
+    return Object.entries(raw).map(([key, value]) => ({ key, value }));
+}
+/** Entries as the collection the provider stores. */
+function encode(entries, loc) {
+    if (loc.shape === "array")
+        return entries.map((e) => e.value);
+    if (loc.shape === "delimited")
+        return entries.map((e) => String(e.value)).join(loc.sep ?? ",");
+    return Object.fromEntries(entries.map((e) => [String(e.key), e.value]));
+}
+/** `value` placed at `tokens` in `doc`; at the root, the value is the whole body. */
+function place(doc, tokens, value) {
+    return tokens.length === 0 ? value : setAt(doc, tokens, value);
+}
+/**
+ * The fields an entry is compared by, when the plan declares a map: an array's map item, or a keyed entry's map
+ * value (a merge patch leaves fields the plan no longer sets, so only the declared ones count).
+ */
+function declaredFields(spec) {
+    const declared = spec.shape === "map" ? spec.value : spec.shape === "array" ? spec.item : undefined;
+    return isObject(declared) ? Object.keys(declared) : undefined;
+}
+/** The state an entry is compared by: the value, or the declared fields of a map. */
+function entryState(spec, entry) {
+    const fields = declaredFields(spec);
+    return fields ? projection(entry.value, fields) : entry.value;
+}
+/** The desired state; `{ keep: true }` takes the live entry's value. */
+function desiredState(spec, entry) {
+    if (spec.shape === "map")
+        return isKeep(spec.value) ? (entry ? entryState(spec, entry) : null) : spec.value;
+    if (spec.shape === "delimited" || !isObject(spec.item))
+        return spec.shape === "delimited" ? String(spec.item) : spec.item;
+    return Object.fromEntries(Object.entries(spec.item).map(([f, v]) => [f, isKeep(v) ? (at(entry?.value, fieldTokens(f)) ?? null) : v]));
+}
+/** The value to store: the item, a keyed entry's value, or a map item's declared (non-kept) fields over the live one. */
+function nextValue(spec, entry) {
+    if (spec.shape === "map")
+        return spec.value;
+    if (spec.shape === "delimited" || !isObject(spec.item))
+        return desiredState(spec, entry);
+    const set = Object.entries(spec.item).filter(([, v]) => !isKeep(v));
+    return set.reduce((o, [f, v]) => setAt(o, fieldTokens(f), v), isObject(entry?.value) ? entry.value : {});
+}
+function hasKeep(spec) {
+    if (spec.shape === "map")
+        return isKeep(spec.value);
+    return isObject(spec.item) && Object.values(spec.item).some(isKeep);
+}
+/**
+ * In an XML document a field of one element reads as that element alone. Where the line's map item declares a field
+ * as a list (S3's `AllowedMethod: [GET]`), a lone value is that list of one, so a one-element list compares equal.
+ */
+function xmlLists(spec, value) {
+    if (!isObject(spec.item) || !isObject(value))
+        return value;
+    let out = value;
+    for (const [f, declared] of Object.entries(spec.item)) {
+        const live = at(out, fieldTokens(f));
+        if (Array.isArray(declared) && live !== undefined && live !== null && !Array.isArray(live))
+            out = setAt(out, fieldTokens(f), [live]);
+    }
+    return out;
+}
+/** The parent object and its collection; with `if_missing: empty`, a parent that is not there is empty. */
+async function readParent(conn, loc, spec) {
+    let body;
+    try {
+        // A read sent as a POST changes nothing, so it is retried like a GET.
+        body = loc.read_method === "POST" ? await conn.api.post(loc.read, undefined, undefined, { idempotent: true }) : await conn.api.get(loc.read);
+    }
+    catch (e) {
+        if (loc.missing_empty && failedWith(e, "PROVIDER_NOT_FOUND", []))
+            return { doc: {}, entries: [] };
+        throw e;
+    }
+    const doc = loc.item_path ? at(body, pointerTokens(loc.item_path)) : body;
+    if (!isObject(doc))
+        throw loc.item_path ? new SponsonError("PROVIDER_RESPONSE", `${ADAPTER}: ${loc.read_method ?? "GET"} ${loc.read}: no object at \`parent.item_path\` ${loc.item_path}`, { adapter: ADAPTER, param: "parent.item_path" }) : badShape(loc, "an object");
+    const entries = decode(at(doc, pointerTokens(loc.list)), loc, conn.xml);
+    return { doc, entries: conn.xml && spec?.shape === "array" ? entries.map((e) => ({ key: e.key, value: xmlLists(spec, e.value) })) : entries };
+}
+function clientFor(actx, loc) {
+    return { api: httpClient(actx, loc.content_type ? { contentType: loc.content_type } : {}), xml: parseApi(actx.provider, "providers.http.<api>").encoding === "xml" };
+}
+/** What a write sends besides the collection: nothing, the parent read just before, or the listed fields of it. */
+function sentAlong(send, doc) {
+    if (send === "field" || send === "collection")
+        return {};
+    if (send === "parent")
+        return doc;
+    return send.reduce((body, f) => {
+        const v = at(doc, fieldTokens(f));
+        return v === undefined ? body : setAt(body, fieldTokens(f), v);
+    }, {});
+}
+/**
+ * Write the collection after one change (`value: null` removes `key`): a keyed map with `send: field` as a merge
+ * patch of that entry, anything else as the whole collection, alone or in the parent read just before.
+ */
+async function writeChange(api, loc, doc, entries, change) {
+    const tokens = pointerTokens(loc.write_list ?? loc.list);
+    const space = loc.write.indexOf(" ");
+    if (loc.delete_empty && entries.length === 0) {
+        // An API that refuses an empty collection (S3 CORS needs at least one rule) removes it instead.
+        try {
+            await write(api, "DELETE", loc.write.slice(space + 1), undefined, true);
+        }
+        catch (e) {
+            if (!failedWith(e, "PROVIDER_NOT_FOUND", []))
+                throw e;
+        }
+        return;
+    }
+    let body;
+    if (loc.shape === "map" && loc.send === "field")
+        body = place({}, tokens, { [String(change.key)]: change.value });
+    else
+        body = place(sentAlong(loc.send, doc), tokens, encode(entries, loc));
+    await write(api, loc.write.slice(0, space), loc.write.slice(space + 1), body, true);
+}
+function raced(loc, what) {
+    return new SponsonError("PROVIDER_CONFLICT", `${ADAPTER}: ${loc.read}${loc.list}: ${what} after ${MAX_ATTEMPTS} read-modify-write attempts; another writer keeps changing it`, { adapter: ADAPTER, path: loc.read });
+}
+function keepWithoutItem(label) {
+    return paramError(ADAPTER, `${label} declares \`{ keep: true }\` but is not there, so there is no value to keep. Give it a value or remove it.`, "item");
+}
+function isPlanned(spec, entry) {
+    return entry !== undefined && stateHash(entryState(spec, entry)) === stateHash(desiredState(spec, entry));
+}
+/**
+ * Put the item in the collection until a fresh read shows it as planned. Returns whether this call added it (it
+ * was absent from the collection it read and wrote).
+ */
+async function ensure(actx, spec, loc, label) {
+    const conn = clientFor(actx, loc);
+    let added = false;
+    for (let attempt = 0; attempt <= MAX_ATTEMPTS; attempt++) {
+        const { doc, entries } = await readParent(conn, loc, spec);
+        const idx = entries.findIndex((e) => sameKey(e.key, loc.item));
+        if (isPlanned(spec, entries[idx]))
+            return added;
+        if (attempt === MAX_ATTEMPTS)
+            break;
+        if (idx < 0) {
+            if (hasKeep(spec))
+                throw keepWithoutItem(label);
+            if (!added)
+                await actx.intend([keyOf(loc)]);
+            added = true;
+        }
+        actx.log(`${idx < 0 ? "add" : "update"} ${label}`);
+        const change = { key: loc.item, value: nextValue(spec, entries[idx]) };
+        const next = idx < 0 ? [...entries, change] : entries.map((e, i) => (i === idx ? change : e));
+        await writeChange(conn.api, loc, doc, next, change);
+    }
+    throw raced(loc, "the item is still not as planned");
+}
+/** Take the item out until a fresh read no longer shows it; a missing parent counts as gone. */
+async function remove(conn, loc) {
+    for (let attempt = 0; attempt <= MAX_ATTEMPTS; attempt++) {
+        let parent;
+        try {
+            parent = await readParent(conn, loc);
+        }
+        catch (e) {
+            if (failedWith(e, "PROVIDER_NOT_FOUND", []))
+                return;
+            throw e;
+        }
+        const rest = parent.entries.filter((e) => !sameKey(e.key, loc.item));
+        if (rest.length === parent.entries.length)
+            return;
+        if (attempt === MAX_ATTEMPTS)
+            break;
+        await writeChange(conn.api, loc, parent.doc, rest, { key: loc.item, value: null });
+    }
+    throw raced(loc, "the item is still there");
+}
+function parseLocator(id, key) {
+    try {
+        const loc = JSON.parse(id);
+        if (typeof loc.read === "string" && typeof loc.write === "string" && typeof loc.list === "string")
+            return loc;
+    }
+    catch {
+        // reported below
+    }
+    throw new SponsonError("INTERNAL", `${ADAPTER}: ${key}: record id is not a list item locator`, { adapter: ADAPTER, key });
+}
+// ---------------------------------------------------------------------------
+// The op
+// ---------------------------------------------------------------------------
+function recordOf(loc, spec, entry, label) {
+    return { key: keyOf(loc), id: canonicalJson(loc), hash: stateHash(entryState(spec, entry)), label };
+}
+function side(state) {
+    const marker = firstMarker(state);
+    return marker ? desiredSide(marker, false) : { state: "literal", value: text(state) };
+}
+function diffExisting(spec, key, label, current, entry) {
+    const before = entry === undefined ? SENSITIVE : { state: "literal", value: text(entryState(spec, entry)) };
+    const desired = desiredState(spec, entry);
+    if (firstMarker(desired) !== undefined)
+        return { key, kind: "update", label, before, after: side(desired) };
+    if (stateHash(desired) === current.hash)
+        return { key, kind: "unchanged", label };
+    return { key, kind: "update", label, before, after: side(desired) };
+}
+/**
+ * The parent object's identity for its lock (ADR 0019): `http:<base URL><parent path>`. The base URL is the API
+ * block's `base_url` (not its `base_url_env` override, so every runner names the object alike) without user info,
+ * query or fragment: an identity is written to receipts, so it never carries a credential. Every collection of
+ * one parent shares the lock, since `send: parent` writes them all back.
+ */
+function parentLock(params, provider) {
+    const spec = parseListItem(params);
+    const path = fillPath(spec.parent.path, spec.vars);
+    if (path === undefined || typeof provider.base_url !== "string")
+        return null;
+    const base = new URL(provider.base_url);
+    return `${ADAPTER}:${base.protocol}//${base.host}${base.pathname.replace(/\/+$/, "")}${path}`;
+}
+/** `http.list_item`: one value kept in a collection on a parent object, by read-modify-write. */
+export const listItem = {
+    outputs: {},
+    // A recipe line's params are checked before any request (PARAM_INVALID naming the param); it declares no outputs.
+    outputsFor: (params) => (params.recipe === undefined ? {} : (expandRecipe(params, "list_item"), {})),
+    providerFor: apiBlock,
+    credentialInputs: credentialInputs("list_item"),
+    lockOn: parentLock,
+    writesEnvironment: apiEnvironment,
+    async read(actx, params) {
+        const spec = parseListItem(params);
+        const loc = locatorOf(spec);
+        // Nothing can be in a list read with a credential that does not exist yet (its line is still to be created).
+        if (!loc || firstMarker(spec.credential) !== undefined)
+            return null;
+        const { entries } = await readParent(clientFor(withLineCredential(actx, spec.credential), loc), loc, spec);
+        const entry = entries.find((e) => sameKey(e.key, loc.item));
+        if (entry === undefined)
+            return null;
+        const state = { resources: [recordOf(loc, spec, entry, labelOf(spec, loc))], outputs: {} };
+        found.set(state, entry);
+        return state;
+    },
+    diff(live, params) {
+        const spec = parseListItem(params);
+        const loc = locatorOf(spec);
+        if (!loc)
+            return [{ key: "(pending)", kind: "create", label: `${spec.api} list item`, before: ABSENT, after: desiredSide(firstMarker(params) ?? "", false) }];
+        const key = keyOf(loc);
+        const label = labelOf(spec, loc);
+        const current = live?.resources.find((r) => r.key === key);
+        if (current)
+            return [diffExisting(spec, key, label, current, live ? found.get(live) : undefined)];
+        if (hasKeep(spec))
+            throw keepWithoutItem(label);
+        return [{ key, kind: "create", label, before: ABSENT, after: side(desiredState(spec, undefined)) }];
+    },
+    async apply(actx, params, live) {
+        assertNoPending(params, ADAPTER);
+        const spec = parseListItem(params);
+        const loc = locatorOf(spec);
+        const key = keyOf(loc);
+        const label = labelOf(spec, loc);
+        const current = live?.resources.find((r) => r.key === key);
+        const entry = live ? found.get(live) : undefined;
+        if (current && isPlanned(spec, entry))
+            return { resources: [current], outputs: {}, created: [] };
+        const added = await ensure(withLineCredential(actx, spec.credential), spec, loc, label);
+        const hash = stateHash(desiredState(spec, entry));
+        return { resources: [{ key, id: canonicalJson(loc), hash, label }], outputs: {}, created: added ? [key] : [] };
+    },
+    async destroy(actx, resources) {
+        for (const r of resources) {
+            if (r.id === "")
+                continue; // an intent never located: nothing was added under it
+            const loc = parseLocator(r.id, r.key);
+            if (loc.keep)
+                continue; // `destroy: keep`: left in place on purpose
+            await remove(clientFor(actx, loc), loc);
+        }
+    },
+    /** Every item of the collection: any of them may be one a scope (or nobody) manages. */
+    async listScope(actx, params) {
+        const spec = parseListItem(params);
+        const loc = locatorOf(spec);
+        if (!loc || firstMarker(spec.credential) !== undefined)
+            return [];
+        const { entries } = await readParent(clientFor(withLineCredential(actx, spec.credential), loc), loc, spec);
+        return entries.flatMap((e) => {
+            if (e.key === undefined || isObject(e.key) || Array.isArray(e.key))
+                return [];
+            const l = { ...loc, item: e.key };
+            return [recordOf(l, spec, e, labelOf(spec, l))];
+        });
+    },
+};
+//# sourceMappingURL=http-adapter-list.js.map

package/dist/http-adapter-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter-list.js","sourceRoot":"","sources":["../src/http-adapter-list.ts"],"names":[],"mappings":"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"}

package/dist/http-adapter-resource.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `http.resource`: one object per item in a REST API (a feature flag, a webhook endpoint), declared entirely in the
+ * plan. See ADR 0017 and docs/plan-format.md#httpresource.
+ *
+ * - Key: where the object lives and what identifies it there: `<find.path>[<field>=<value>,…]` when it is located
+ *   by `find`, else its `read.path` (a URL that names it). A GraphQL `find` or `read` stands in for the path as
+ *   `graphql:<root field>(<variables>)<data path>`. The provider block (base URL, credential) is part of the ledger
+ *   identity already.
+ * - Id: the request that removes it, `DELETE /things/<id>` (`KEEP /things/<id>` with `destroy: keep`), plus any
+ *   `gone_status`, or `GRAPHQL {"query":…,"variables":…}` for a GraphQL delete, so `destroy` needs nothing but the
+ *   ledger. A new provider id makes a new record id: replaced
+ *   outside Sponson.
+ * - Hash: `sha256(canonicalJson({ <field>: <value> }))` over the declared `fields` only; `diff` compares the same
+ *   form, so a console edit of a declared field is `changed` drift and anything else the provider stores is not.
+ */
+import { type OpSpec } from "@sponson/core";
+import { type ResourceSpec } from "./http-adapter-spec.js";
+/** The resource key, or undefined while a value it depends on is pending. */
+export declare function resourceKey(spec: ResourceSpec): string | undefined;
+/**
+ * What the ledger knows a line's object by: its key, and its record id with `id` standing for the provider's id.
+ * The recipe identity lock (recipes.test.ts) pins it per recipe op.
+ */
+export declare function resourceIdentity(spec: ResourceSpec, id: string): {
+    key: string | undefined;
+    id: string;
+};
+/** `http.resource`: one object per item, located by a path or by `find`, its declared `fields` kept as planned. */
+export declare const resource: OpSpec;