@sanoma-ai/workflows 0.2.0 → 0.4.0

package/dist/sdk.js

@@ -0,0 +1,168 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { isObject } from "./resource.js";
+import { SCHEMA_FILE, schemaText } from "./schema.js";
+import { apiNameOf, DATA_VENDOR, problemLine } from "./shared.js";
+// A company's generated SDK, `.sanoma/api.ts`: the types of a site's `api` from `sanoma/site`,
+// written from `describeConfig` (types and JSDoc only: `api` itself is one generic client). It
+// augments `sanoma/site`'s `Register`, so it is type-checked only through the sites' generated
+// tsconfig, never the company's root one (Node, no DOM).
+/** Where `writeApi` writes, under a company's root. */
+export const API_FILE = join(".sanoma", "api.ts");
+const API_NAME_PROBLEM = "A site calls this workflow api.";
+/** `describeConfig`'s problem on a workflow whose api name is taken: `taken` says by what. */
+export const apiNameProblem = (api, taken) => `${API_NAME_PROBLEM}${api}, ${taken}: rename it`;
+/**
+ * `.sanoma/api.ts` for a description: one record type per collection, and `CompanyApi` (not `Api`,
+ * which inside `declare module "sanoma/site"` is the module's own), one member per
+ * workflow (`apiNameOf`), per vendor of the operations a person may call directly (`OpEntry.direct`,
+ * by resource) and `data` for the collections, each with its JSDoc; then `Register`'s
+ * augmentation. Pure: the same description gives the same text. A workflow whose api name another
+ * has, `describeConfig`'s problem on its entry, is left out, and its problem is in `problems`.
+ */
+export function generateApi(description) {
+    const problems = [];
+    const members = [];
+    for (const wf of description.workflows) {
+        const taken = wf.problems.filter((p) => p.message.startsWith(API_NAME_PROBLEM));
+        if (taken.length)
+            problems.push(...taken.map((p) => problemLine({ file: wf.file, ...p })));
+        else
+            members.push(workflowMember(wf));
+    }
+    // The ops are sorted by id, so by vendor and then resource.
+    const direct = description.ops.filter((op) => op.direct && op.vendor !== DATA_VENDOR);
+    for (const [vendor, ops] of Map.groupBy(direct, (op) => op.vendor)) {
+        const title = description.vendors[vendor]?.title ?? vendor;
+        const resources = [...Map.groupBy(ops, (op) => op.resource)].map(([resource, own]) => member(undefined, resource, block(own.map(opMember))));
+        members.push(member(`${title}: the operations a person may call directly.`, vendor, block(resources)));
+    }
+    if (description.collections.length) {
+        const data = description.collections.map((c) => member(collectionDoc(c), c.name, `CollectionApi<${recordName(c)}>`));
+        members.push(member("The company's collections.", DATA_VENDOR, block(data)));
+    }
+    const source = [
+        "// Generated by sanoma from sanoma.config.ts and the connectors it names; do not edit.",
+        "// The types of `api` from sanoma/site: what a site may call, as the person on the page.",
+        'import type { CollectionApi, OpFn, WorkflowFn } from "sanoma/site";',
+        ...description.collections.map((c) => `\n${jsdoc(`A record of ${c.title ?? c.name}.`)}type ${recordName(c)} = ${typeOf(c.record)};`),
+        "",
+        `interface CompanyApi ${block(members)}`,
+        "",
+        'declare module "sanoma/site" {',
+        "  interface Register {",
+        "    api: CompanyApi;",
+        "  }",
+        "}",
+        "",
+        "export {};",
+        "",
+    ].join("\n");
+    return { source, problems };
+}
+/**
+ * Writes `<root>/.sanoma/api.ts` (`generateApi`) when its text differs from the file's, so an
+ * editor or a dev server sees no change when there is none; `wrote` says whether it did.
+ */
+export async function writeApi(root, description) {
+    const file = join(root, API_FILE);
+    return { wrote: await writeChanged(file, generateApi(description).source), file };
+}
+/**
+ * The generated files, each written when its text changed: `.sanoma/api.ts` (`writeApi`) and the
+ * Cedar schema's text, `.sanoma/schema.cedarschema` (`schemaText` of `schemaOf`). `wrote` lists
+ * those written, relative to the root.
+ */
+export async function writeGenerated(root, description, schema) {
+    const [api, cedar] = await Promise.all([
+        writeApi(root, description),
+        writeChanged(join(root, SCHEMA_FILE), schemaText(schema)),
+    ]);
+    return { wrote: [...(api.wrote ? [API_FILE] : []), ...(cedar ? [SCHEMA_FILE] : [])] };
+}
+/** Writes `text` to `file` unless the file holds it already; true when it wrote. */
+async function writeChanged(file, text) {
+    if ((await readFile(file, "utf8").catch(() => undefined)) === text)
+        return false;
+    await mkdir(dirname(file), { recursive: true });
+    await writeFile(file, text);
+    return true;
+}
+const workflowMember = (wf) => member(`${wf.title ?? wf.name}: the workflow \`${wf.name}\`${wf.builtin ? ", built in" : ""}.`, apiNameOf(wf.name), `WorkflowFn<${typeOf(wf.input)}, unknown>`);
+const opMember = (op) => member(`${op.description ? `${op.description}\n\n` : ""}\`${op.id}\`, a ${op.effect}.`, op.name, `OpFn<${typeOf(op.input)}, unknown>`);
+const collectionDoc = (c) => `${c.title ?? c.name}: the collection \`${c.name}\`, keyed by \`${c.key}\`.`;
+/** A collection's record type's name: `outbound` gives `OutboundRecord`, never `CompanyApi` nor an imported type's. */
+const recordName = (c) => `${c.name[0].toUpperCase()}${c.name.slice(1)}Record`;
+/**
+ * A JSON Schema as a TypeScript type, for the kinds a start form draws (`fieldsOf` in the app):
+ * strings (a date-time among them), numbers, integers, booleans, enums and constants, objects and
+ * arrays, each property with its description, and unions of those, `null` among them (a
+ * collection's date, a date or a date-time; a nullable field); anything else is `unknown`.
+ */
+const typeOf = (schema) => union(alternatives(schema));
+/** One type of several: `unknown` when any is. */
+function union(types) {
+    const distinct = new Set(types);
+    return distinct.has("unknown") ? "unknown" : [...distinct].join(" | ");
+}
+/** The types a schema allows, one per alternative. */
+function alternatives(schema) {
+    if (!isObject(schema))
+        return ["unknown"];
+    if ("const" in schema && !isObject(schema.const) && !Array.isArray(schema.const)) {
+        return [JSON.stringify(schema.const)];
+    }
+    if (Array.isArray(schema.enum) && schema.enum.length && schema.enum.every((v) => v === null || !isObject(v))) {
+        return schema.enum.map((v) => JSON.stringify(v));
+    }
+    if (Array.isArray(schema.anyOf) && schema.anyOf.length)
+        return schema.anyOf.flatMap(alternatives);
+    if (Array.isArray(schema.type) && schema.type.length) {
+        return schema.type.flatMap((type) => alternatives({ ...schema, type }));
+    }
+    switch (schema.type) {
+        case "string":
+            return ["string"];
+        case "number":
+        case "integer":
+            return ["number"];
+        case "boolean":
+            return ["boolean"];
+        case "null":
+            return ["null"];
+        case "array": {
+            const item = typeOf(schema.items);
+            return [new Set(alternatives(schema.items)).size > 1 && item !== "unknown" ? `(${item})[]` : `${item}[]`];
+        }
+        case "object":
+            return [isObject(schema.properties) ? objectType(schema) : "Record<string, unknown>"];
+        default:
+            return ["unknown"];
+    }
+}
+function objectType(schema) {
+    const required = new Set(Array.isArray(schema.required) ? schema.required : []);
+    const lines = Object.entries(schema.properties).map(([name, prop]) => {
+        const doc = isObject(prop) && typeof prop.description === "string" ? jsdoc(prop.description) : "";
+        return `${doc}${key(name)}${required.has(name) ? "" : "?"}: ${typeOf(prop)};`;
+    });
+    // An object that takes other keys too.
+    if (schema.additionalProperties !== undefined && schema.additionalProperties !== false) {
+        lines.push("[key: string]: unknown;");
+    }
+    return block(lines);
+}
+/** A property's name, quoted when it is not an identifier. */
+const key = (name) => (/^[A-Za-z_$][\w$]*$/.test(name) ? name : JSON.stringify(name));
+/** A member, under its JSDoc when there is one. */
+const member = (doc, name, type) => `${doc ? jsdoc(doc) : ""}${key(name)}: ${type};`;
+/** `{ … }` around lines, each indented a level (a nested block's lines with it); `{}` for none. */
+const block = (lines) => lines.length ? `{\n${lines.map((l) => l.replace(/^(?=.)/gm, "  ")).join("\n")}\n}` : "{}";
+/** A JSDoc comment and the line break after it; `*\/` in the text cannot end it. */
+function jsdoc(text) {
+    const lines = text.replaceAll("*/", "*\\/").split("\n");
+    return lines.length === 1
+        ? `/** ${lines[0]} */\n`
+        : `/**\n${lines.map((l) => ` *${l ? ` ${l}` : ""}`).join("\n")}\n */\n`;
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/dist/shared.d.ts

@@ -1,6 +1,8 @@
+import type { RunSummary } from "./client.ts";
 import type { CredentialStatus } from "./env.ts";
 import type { ApprovalState, Approver, Principal } from "./define.ts";
-import type { ResourceProblem } from "./resources.ts";
+import type { LedgerRecord } from "./ledger.ts";
+import type { DeclaredResource, ResourceProblem } from "./resources.ts";
 import type { OutlineNode } from "./outline.ts";
 export type { Declared, Declaring, FieldReference, References, Resource, ResourceFields, ResourceSpec, } from "./resource.ts";
 export type { DeclaredResource, ResourceProblem } from "./resources.ts";
@@ -19,7 +21,77 @@ export declare const DRIFT_WORKFLOW = "drift";
  * change operations (`create`, `update`, `delete`).
  */
 export declare const APPLY_WORKFLOW = "apply";
-/** The workflows the runtime adds itself, which a config's own may not be named: drift and apply. */
+/**
+ * The vendor of the collections' operations, `data.<collection>.<op>`: a collection's `get`,
+ * `list`, `save` and `delete`. No connector may take it.
+ */
+export declare const DATA_VENDOR = "data";
+/** Every effect an operation may have, each an action group (`effect:<effect>`) of the Cedar schema. */
+export declare const EFFECTS: readonly ["read", "write", "publish", "send", "money", "access"];
+/** What a workflow start's action id starts with, as a policy names it: `workflow:<name>`. */
+export declare const WORKFLOW_ACTION = "workflow:";
+/** A site's folder name under `sites/`, its URL segment: what the app mounts and `readSites` reads. */
+export declare const SITE_NAME: RegExp;
+/**
+ * A record of a collection as `get`, `list` and `save` answer it: its key, the record, and when
+ * and by whom it was last saved (`updatedBy`: a person's id, or `run:<id>` for a run). A record
+ * saved under an older declaration comes back as it is stored, with `issues` saying where the
+ * fields no longer accept it.
+ */
+export type Saved<R = Record<string, unknown>> = {
+    key: string;
+    record: R;
+    /** ISO 8601. */
+    updatedAt: string;
+    updatedBy: string;
+    issues?: {
+        path: (string | number)[];
+        message: string;
+    }[];
+};
+/**
+ * What a collection's `list` takes: fields equal to a value or within a range (`where`), the
+ * field to sort by (`-field` for descending; by key otherwise), and how many at most (1 to
+ * 1000, default 100).
+ */
+export type ListQuery<R> = {
+    where?: {
+        [F in keyof R]?: Exclude<R[F], undefined> | Range<Exclude<R[F], undefined>>;
+    };
+    order?: (keyof R & string) | `-${keyof R & string}`;
+    limit?: number;
+};
+type Range<V> = {
+    gt?: V;
+    gte?: V;
+    lt?: V;
+    lte?: V;
+};
+/** How many records a collection's `list` answers: `default` when the query names no `limit`, `max` at most. */
+export declare const LIST_LIMIT: {
+    readonly default: 100;
+    readonly max: 1000;
+};
+/** The kinds of value a field holds: text, a number, true or false, a date (ISO 8601) or a person's id. */
+export declare const FIELD_TYPES: readonly ["text", "number", "boolean", "date", "person"];
+/**
+ * Throws unless `collection()` takes this declaration: the name a lowercase letter then letters
+ * and digits, at least one field, each a type, the type marked optional or an enum of distinct
+ * strings, the key a required text field, the title a string. `collection()` and the reader of
+ * `resources/data.ts` both ask it, so `sanoma check` refuses what the runtime would.
+ */
+export declare function checkCollection(declaration: {
+    name?: unknown;
+    key?: unknown;
+    fields?: unknown;
+    title?: unknown;
+}): void;
+/**
+ * The built-in call workflow's name: one operation that may be called directly (`isDirect`),
+ * made a run when the policy holds a direct call for an approval.
+ */
+export declare const CALL_WORKFLOW = "call";
+/** The workflows the runtime adds itself, which a config's own may not be named: drift, apply and call. */
 export declare const BUILT_IN_WORKFLOWS: ReadonlySet<string>;
 /**
  * Every run status, in the order a run may pass through them: waiting on the queue, running,
@@ -33,10 +105,63 @@ export declare const ENDED_STATUSES: readonly ["finished", "failed", "cancelled"
 /** True when the run has finished, failed or been cancelled. */
 export declare const isEnded: (status: RunStatus) => boolean;
 /**
- * True when `by` may decide the approval: `by.id` is the approver, or `by.groups` holds the
- * approver group. Pure: everything it reads is already recorded.
+ * Why the run's own actor may not decide an approval on it: separation of duties (`mayDecide`),
+ * while someone else could decide it.
+ */
+export declare const OWN_CHANGE = "own change";
+/** A run as `mayDecide` reads it: who started it, its own actor. */
+type DecidedRun = {
+    actor?: Pick<Principal, "id"> | undefined;
+};
+/**
+ * True when `by` may decide the approval on `run`: `by.id` is the approver, or `by.groups` holds
+ * the approver group. The run's own actor is refused only while someone else could decide (separation
+ * of duties): the approver is a group with another declared person in `people` (an agent does not
+ * count). Pure: everything it reads is passed in.
+ */
+export declare const mayDecide: (approval: Pick<ApprovalState, "approver">, by: Principal, run: DecidedRun, people: readonly PeopleResource[]) => boolean;
+/** Why `by` may not decide the approval on `run` (`mayDecide`), naming who may, or `OWN_CHANGE`; undefined when they may. */
+export declare function refusalOf({ approver }: Pick<ApprovalState, "approver">, by: Principal, run: DecidedRun, people: readonly PeopleResource[]): string | undefined;
+/** A declared resource as the people functions read it: only the runtime's people types count. */
+export type PeopleResource = Pick<DeclaredResource, "vendor" | "type" | "desired">;
+/** The group every agent is in, the runtime's own among them: no data file declares it. */
+export declare const AGENTS = "agents";
+/** The runtime's own agents (scenarios, the host check, scheduled runs), declared whether a data file names them or not. */
+export declare const RUNTIME_AGENTS: readonly string[];
+type PersonFields = {
+    id: string;
+    name?: string;
+    email?: string;
+    github?: string;
+};
+/** The groups a policy may name and a principal may be in: the declared ones and `agents`, sorted. */
+export declare const groupNamesOf: (resources: readonly PeopleResource[]) => string[];
+/** The declared people (`sanoma.person`), in the order declared: not agents, who never sign in. */
+export declare const personsOf: (resources: readonly PeopleResource[]) => PersonFields[];
+/** The ids of the declared people and agents (not the runtime's own). */
+export declare const principalIdsOf: (resources: readonly PeopleResource[]) => string[];
+/** True when the data files declare a person, agent or group: then only a declared principal is admitted. */
+export declare const declaresPeople: (resources: readonly PeopleResource[]) => boolean;
+/**
+ * The principal a declared person or agent (or one of the runtime's own agents) acts as, read
+ * from the data files' resources: its id, every group that lists it (and `agents` for an agent),
+ * sorted, and an agent's `onBehalfOf`. Undefined for an id nobody declares.
  */
-export declare function mayDecide(approval: Pick<ApprovalState, "approver">, by: Principal): boolean;
+export declare function principalOf(id: string, resources: readonly PeopleResource[]): Principal | undefined;
+/**
+ * Who `name` is as an approver: a declared group's name (or `agents`) as `{ group }`, else a
+ * declared person's or agent's id; undefined when it is neither.
+ */
+export declare function approverOf(name: string, resources: readonly PeopleResource[]): Approver | undefined;
+/**
+ * The id of the declared person a sign-in vouches for, or undefined: by email first, then by
+ * GitHub login (each ignoring case), then by id. Never an agent's: agents do not sign in.
+ */
+export declare function personOf(login: {
+    email?: string;
+    github?: string;
+    id?: string;
+}, resources: readonly PeopleResource[]): string | undefined;
 /** Who may decide, as text: the person's id, or "group <name>". */
 export declare const approverLabel: (approver: Approver) => string;
 /** An error's message, or the value as text when it is not an Error. */
@@ -67,3 +192,54 @@ export declare function problemLine(p: {
 export declare const isLoopback: (host: string) => boolean;
 /** Whether a driver's environment variable lets it run: set, or unset and optional. */
 export declare const credentialReady: ({ status, optional }: CredentialStatus) => boolean;
+/**
+ * A workflow's name in a site's `api`: kebab-case made camelCase, `outbound-next` as
+ * `api.outboundNext`. `describeConfig` reports two workflows that come out the same, or one that
+ * comes out as a vendor's id or `data`, as a problem on the workflow.
+ */
+export declare const apiNameOf: (name: string) => string;
+/**
+ * A workflow as a site's `api` has it (`api.<apiNameOf(name)>`), started as the person on the
+ * page. Called, it starts a run and resolves with its output once the run ends, or rejects with
+ * its error; `start` gives the run's id at once, and the rest read runs of this workflow.
+ */
+export interface WorkflowFn<I, O> {
+    (input: I): Promise<O>;
+    /** Starts a run with this input, and answers with its id. */
+    start(input: I): Promise<{
+        runId: string;
+    }>;
+    /** The run's output once it ends, or its error; `run_running` when it has not ended within `waitMs` (at most 20 s). */
+    result(runId: string, waitMs?: number): Promise<O>;
+    /** The newest finished run's output, and when it finished (ms since the epoch); null when none has. */
+    latest(): Promise<{
+        runId: string;
+        output: O;
+        at: number;
+    } | null>;
+    /** Its latest runs, newest first. */
+    runs(query?: {
+        limit?: number;
+    }): Promise<RunSummary[]>;
+    /** The run's approvals, decided and waiting. */
+    approvals(runId: string): Promise<ApprovalState[]>;
+    /** The run's ledger records, in order. */
+    ledger(runId: string): Promise<LedgerRecord[]>;
+}
+/** An operation a site may call directly (a read, or a collection's write), as the person on the page. */
+export type OpFn<I, O> = (input: I) => Promise<O>;
+/** A collection as a site's `api.data.<name>` has it: its four operations (`Saved`, `ListQuery`). */
+export interface CollectionApi<R> {
+    get: OpFn<{
+        key: string;
+    }, Saved<R> | null>;
+    list(query?: ListQuery<R>): Promise<Saved<R>[]>;
+    save: OpFn<{
+        record: R;
+    }, Saved<R>>;
+    delete: OpFn<{
+        key: string;
+    }, {
+        deleted: boolean;
+    }>;
+}

package/dist/shared.js

@@ -13,8 +13,85 @@ export const DRIFT_WORKFLOW = "drift";
  * change operations (`create`, `update`, `delete`).
  */
 export const APPLY_WORKFLOW = "apply";
-/** The workflows the runtime adds itself, which a config's own may not be named: drift and apply. */
-export const BUILT_IN_WORKFLOWS = new Set([DRIFT_WORKFLOW, APPLY_WORKFLOW]);
+/**
+ * The vendor of the collections' operations, `data.<collection>.<op>`: a collection's `get`,
+ * `list`, `save` and `delete`. No connector may take it.
+ */
+export const DATA_VENDOR = "data";
+/** Every effect an operation may have, each an action group (`effect:<effect>`) of the Cedar schema. */
+export const EFFECTS = ["read", "write", "publish", "send", "money", "access"];
+/** What a workflow start's action id starts with, as a policy names it: `workflow:<name>`. */
+export const WORKFLOW_ACTION = "workflow:";
+/** A site's folder name under `sites/`, its URL segment: what the app mounts and `readSites` reads. */
+export const SITE_NAME = /^[a-z][a-z0-9-]*$/;
+/** How many records a collection's `list` answers: `default` when the query names no `limit`, `max` at most. */
+export const LIST_LIMIT = { default: 100, max: 1000 };
+/** The kinds of value a field holds: text, a number, true or false, a date (ISO 8601) or a person's id. */
+export const FIELD_TYPES = ["text", "number", "boolean", "date", "person"];
+const COLLECTION_NAME = /^[a-z][a-zA-Z0-9]*$/;
+const FIELD_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const KINDS = `${FIELD_TYPES.map((t) => `"${t}"`).join(", ")}, { type, optional: true } or { enum: [...] }`;
+const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/**
+ * Throws unless `collection()` takes this declaration: the name a lowercase letter then letters
+ * and digits, at least one field, each a type, the type marked optional or an enum of distinct
+ * strings, the key a required text field, the title a string. `collection()` and the reader of
+ * `resources/data.ts` both ask it, so `sanoma check` refuses what the runtime would.
+ */
+export function checkCollection(declaration) {
+    const { name, key, fields, title } = declaration;
+    const where = `collection("${String(name)}")`;
+    if (typeof name !== "string" || !COLLECTION_NAME.test(name)) {
+        throw new Error(`${where}: the name must be a lowercase letter, then letters and digits, such as "outbound"`);
+    }
+    if (!isRecord(fields) || !Object.keys(fields).length) {
+        throw new Error(`${where}: it needs fields, by name: each one of ${KINDS}`);
+    }
+    for (const [field, kind] of Object.entries(fields))
+        checkField(where, field, kind);
+    const keyKind = typeof key === "string" && Object.hasOwn(fields, key) ? fields[key] : undefined;
+    if (!(keyKind === "text" || (isRecord(keyKind) && keyKind.type === "text" && keyKind.optional === undefined))) {
+        throw new Error(`${where}: the key "${String(key)}" must be one of its fields, a required "text" one`);
+    }
+    if (title !== undefined && typeof title !== "string")
+        throw new Error(`${where}: the title must be a string`);
+}
+/** Throws unless `kind` is a field `collection()` takes: a type, the type marked optional, or an enum of distinct strings. */
+function checkField(where, field, kind) {
+    const refused = (why) => new Error(`${where}: the field "${field}" ${why}`);
+    if (!FIELD_NAME.test(field))
+        throw refused("must be named with letters, digits and _, not a digit first");
+    const types = FIELD_TYPES;
+    const kinds = `is ${JSON.stringify(kind)}; a field is one of ${KINDS}`;
+    if (typeof kind === "string") {
+        if (!types.includes(kind))
+            throw refused(kinds);
+        return;
+    }
+    if (!isRecord(kind))
+        throw refused(kinds);
+    const { type, enum: values, optional, ...rest } = kind;
+    if (Object.keys(rest).length || (type === undefined) === (values === undefined))
+        throw refused(kinds);
+    if (optional !== undefined && optional !== true)
+        throw refused("may only be marked `optional: true`");
+    if (type !== undefined && !types.includes(type))
+        throw refused(kinds);
+    if (values !== undefined &&
+        (!Array.isArray(values) ||
+            !values.length ||
+            values.some((v) => typeof v !== "string") ||
+            new Set(values).size < values.length)) {
+        throw refused("needs an enum of distinct strings, at least one");
+    }
+}
+/**
+ * The built-in call workflow's name: one operation that may be called directly (`isDirect`),
+ * made a run when the policy holds a direct call for an approval.
+ */
+export const CALL_WORKFLOW = "call";
+/** The workflows the runtime adds itself, which a config's own may not be named: drift, apply and call. */
+export const BUILT_IN_WORKFLOWS = new Set([DRIFT_WORKFLOW, APPLY_WORKFLOW, CALL_WORKFLOW]);
 /**
  * Every run status, in the order a run may pass through them: waiting on the queue, running,
  * waiting for an approval, or ended. `waiting` is `running` with an approval pending.
@@ -25,12 +102,82 @@ export const ENDED_STATUSES = ["finished", "failed", "cancelled"];
 /** True when the run has finished, failed or been cancelled. */
 export const isEnded = (status) => ENDED_STATUSES.includes(status);
 /**
- * True when `by` may decide the approval: `by.id` is the approver, or `by.groups` holds the
- * approver group. Pure: everything it reads is already recorded.
+ * Why the run's own actor may not decide an approval on it: separation of duties (`mayDecide`),
+ * while someone else could decide it.
  */
-export function mayDecide(approval, by) {
-    const { approver } = approval;
-    return typeof approver === "string" ? approver === by.id : (by.groups?.includes(approver.group) ?? false);
+export const OWN_CHANGE = "own change";
+/**
+ * True when `by` may decide the approval on `run`: `by.id` is the approver, or `by.groups` holds
+ * the approver group. The run's own actor is refused only while someone else could decide (separation
+ * of duties): the approver is a group with another declared person in `people` (an agent does not
+ * count). Pure: everything it reads is passed in.
+ */
+export const mayDecide = (approval, by, run, people) => refusalOf(approval, by, run, people) === undefined;
+/** Why `by` may not decide the approval on `run` (`mayDecide`), naming who may, or `OWN_CHANGE`; undefined when they may. */
+export function refusalOf({ approver }, by, run, people) {
+    if (typeof approver === "string") {
+        return approver === by.id ? undefined : `${by.id} is not the approver; ${approverLabel(approver)} is`;
+    }
+    if (!by.groups?.includes(approver.group))
+        return `${by.id} is not in ${approverLabel(approver)}`;
+    if (by.id !== run.actor?.id)
+        return undefined;
+    const someoneElse = personsOf(people).some(({ id }) => id !== by.id && principalOf(id, people)?.groups?.includes(approver.group));
+    return someoneElse ? OWN_CHANGE : undefined;
+}
+/** The group every agent is in, the runtime's own among them: no data file declares it. */
+export const AGENTS = "agents";
+/** The runtime's own agents (scenarios, the host check, scheduled runs), declared whether a data file names them or not. */
+export const RUNTIME_AGENTS = ["scenarios", "host-check", "schedule"];
+/** The declared resources of one of the runtime's people types, by `desired`. */
+const peopleOfType = (resources, type) => resources.flatMap((r) => (r.vendor === "sanoma" && r.type === type ? [r.desired] : []));
+/** The groups a policy may name and a principal may be in: the declared ones and `agents`, sorted. */
+export const groupNamesOf = (resources) => [...new Set([...peopleOfType(resources, "group").map((g) => g.name), AGENTS])].toSorted();
+/** The declared people (`sanoma.person`), in the order declared: not agents, who never sign in. */
+export const personsOf = (resources) => peopleOfType(resources, "person");
+/** The ids of the declared people and agents (not the runtime's own). */
+export const principalIdsOf = (resources) => [...personsOf(resources), ...peopleOfType(resources, "agent")].map((p) => p.id);
+/** True when the data files declare a person, agent or group: then only a declared principal is admitted. */
+export const declaresPeople = (resources) => resources.some((r) => r.vendor === "sanoma");
+/**
+ * The principal a declared person or agent (or one of the runtime's own agents) acts as, read
+ * from the data files' resources: its id, every group that lists it (and `agents` for an agent),
+ * sorted, and an agent's `onBehalfOf`. Undefined for an id nobody declares.
+ */
+export function principalOf(id, resources) {
+    const agent = peopleOfType(resources, "agent").find((a) => a.id === id);
+    const isAgent = agent !== undefined || RUNTIME_AGENTS.includes(id);
+    if (!isAgent && !peopleOfType(resources, "person").some((p) => p.id === id))
+        return undefined;
+    const groups = peopleOfType(resources, "group")
+        .filter((g) => g.members.includes(id))
+        .map((g) => g.name);
+    return {
+        id,
+        groups: [...new Set(isAgent ? [...groups, AGENTS] : groups)].toSorted(),
+        ...(agent?.onBehalfOf !== undefined && { onBehalfOf: agent.onBehalfOf }),
+    };
+}
+/**
+ * Who `name` is as an approver: a declared group's name (or `agents`) as `{ group }`, else a
+ * declared person's or agent's id; undefined when it is neither.
+ */
+export function approverOf(name, resources) {
+    if (groupNamesOf(resources).includes(name))
+        return { group: name };
+    return principalOf(name, resources) && name;
+}
+/** True for two strings the same but for case: an email or a GitHub login. */
+const same = (a, b) => a !== undefined && b !== undefined && a.toLowerCase() === b.toLowerCase();
+/**
+ * The id of the declared person a sign-in vouches for, or undefined: by email first, then by
+ * GitHub login (each ignoring case), then by id. Never an agent's: agents do not sign in.
+ */
+export function personOf(login, resources) {
+    const people = personsOf(resources);
+    return (people.find((p) => same(p.email, login.email)) ??
+        people.find((p) => same(p.github, login.github)) ??
+        people.find((p) => login.id !== undefined && p.id === login.id))?.id;
 }
 /** Who may decide, as text: the person's id, or "group <name>". */
 export const approverLabel = (approver) => typeof approver === "string" ? approver : `group ${approver.group}`;
@@ -81,4 +228,10 @@ export function problemLine(p) {
 export const isLoopback = (host) => ["localhost", "::1", "[::1]"].includes(host) || /^127\.\d+\.\d+\.\d+$/.test(host);
 /** Whether a driver's environment variable lets it run: set, or unset and optional. */
 export const credentialReady = ({ status, optional }) => status === "set" || (status === "missing" && optional);
+/**
+ * A workflow's name in a site's `api`: kebab-case made camelCase, `outbound-next` as
+ * `api.outboundNext`. `describeConfig` reports two workflows that come out the same, or one that
+ * comes out as a vendor's id or `data`, as a problem on the workflow.
+ */
+export const apiNameOf = (name) => name.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
 //# sourceMappingURL=shared.js.map

package/dist/shared.js.map

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