@asturiu/v0-sdk 0.0.0-stage → 1.0.0

package/dist/branding.d.ts

@@ -0,0 +1,131 @@
+/**
+ * What a Tenant's repository may set of its branding and portal options, and
+ * the rule for branding images (ADR-038, ADR-039). Pure and dependency-free:
+ * the Engine checks writes with these, the Admin UI and a Tenant's
+ * application prepare them.
+ */
+import { type PortalOptions, type PortalPage, type PortalSwitch } from "./portal-options.js";
+import type { PortalThemeSpec } from "./theme.js";
+/** Who edits a tab: a person in the Admin UI, or the Tenant's application (ADR-038, decision 3). */
+export declare const TENANT_SOURCES: readonly ["admin_ui", "repository"];
+export type TenantSource = (typeof TENANT_SOURCES)[number];
+export interface TenantSources {
+    branding: TenantSource;
+    portal: TenantSource;
+    /** ADR-061 §10. */
+    tiers: TenantSource;
+}
+/** A Tenant's sources, `admin_ui` where unset or unreadable. */
+export declare function tenantSourcesOf(raw: {
+    sources?: unknown;
+} | null | undefined): TenantSources;
+/**
+ * The branding keys a repository sets (ADR-038, decision 2). Everything else
+ * — `portal_url`, `product_url`, `app_url`, `billing_url`, the support
+ * addresses — decides where a customer is sent and stays with an administrator.
+ */
+export declare const BRANDING_REPOSITORY_KEYS: readonly ["theme", "primary_color", "logo_url", "logo_dark_url", "favicon_url"];
+export type BrandingRepositoryKey = (typeof BRANDING_REPOSITORY_KEYS)[number];
+/**
+ * What `PUT /tenant/v0/branding` takes and `GET /tenant/v0/branding` answers:
+ * the whole look of the portal, as the Admin UI's Branding tab edits it, and
+ * no address. A key left out of a `PUT` is cleared.
+ */
+export interface RepositoryBranding {
+    /** The portal theme (ADR-033): a preset and overrides from the kit's closed lists (`THEME_*`). */
+    theme?: PortalThemeSpec;
+    /** `#rrggbb`. Used only while no theme is set. */
+    primary_color?: string;
+    /** Inline images (`inlineImage(bytes, type)`), at most `INLINE_IMAGE_MAX_BYTES` each. */
+    logo_url?: string;
+    /** The logo drawn on dark backgrounds. */
+    logo_dark_url?: string;
+    favicon_url?: string;
+}
+/**
+ * The page modes a repository sets (ADR-039): whether a page shows. A
+ * `redirect` carries the address a customer is sent to and stays with an
+ * administrator.
+ */
+export declare const PORTAL_REPOSITORY_PAGE_MODES: readonly ["portal", "off"];
+export type PortalRepositoryPageMode = (typeof PORTAL_REPOSITORY_PAGE_MODES)[number];
+/**
+ * What `PUT /tenant/v0/portal` takes: every switch (one left out is on) and
+ * which pages show (one left out is back to its default). A page an administrator
+ * moved to the Tenant's application keeps its redirect.
+ */
+export type RepositoryPortal = Partial<Record<PortalSwitch, boolean>> & {
+    pages?: Partial<Record<PortalPage, {
+        mode: PortalRepositoryPageMode;
+    }>>;
+};
+/** The portal options a repository sets: the switches and which pages show. Redirects and their URLs stay with an administrator. */
+export declare const PORTAL_REPOSITORY_KEYS: readonly ["account_link", "open_app", "back_link", "language_menu", "appearance", "pages"];
+/**
+ * The repository's part of a stored branding, as `GET /tenant/v0/branding`
+ * answers it and `PUT` takes it back: the theme, the colour and the images,
+ * images only when inline (a link stored before ADR-038 is not shown anyway).
+ */
+export declare function repositoryBrandingOf(branding: unknown): RepositoryBranding;
+/**
+ * The repository's part of stored portal options, as `GET /tenant/v0/portal`
+ * answers it: every switch, every page that is not redirected, and the pages
+ * an administrator moved to the Tenant's application (without their URLs).
+ */
+export declare function repositoryPortalOf(portal: unknown, ctx?: {
+    collection?: string;
+}): {
+    portal: Record<PortalSwitch, boolean> & {
+        pages: Partial<Record<PortalPage, {
+            mode: PortalRepositoryPageMode;
+        }>>;
+    };
+    redirected: PortalPage[];
+};
+/**
+ * A repository's portal options over the stored ones (ADR-039): the switches
+ * and page modes it sends replace the stored ones, one left out is back to
+ * its default, and a page an administrator redirected keeps its redirect
+ * (`kept`, when the body names it). `problems` are what the body may not
+ * hold, each with its path; the record's own rules (security and privacy
+ * never off, plan not off while the platform bills) are the Tenant schema's.
+ */
+export declare function mergeRepositoryPortal(stored: unknown, body: Record<string, unknown>): {
+    portal: Record<string, unknown>;
+    kept: PortalPage[];
+    problems: {
+        path: string;
+        message: string;
+    }[];
+};
+/**
+ * Pages an administrator may not change while the Portal tab comes from the
+ * repository (ADR-039): an administrator moves a page to the Tenant's
+ * application, or brings a redirected page back to the portal; whether a page
+ * that is not redirected shows is the repository's.
+ */
+export declare function adminPageConflicts(stored: PortalOptions, patchPages: unknown): PortalPage[];
+/** Every image in `branding`, as a path into it (ADR-038, decision 6). */
+export declare const BRANDING_IMAGE_PATHS: readonly [readonly ["logo_url"], readonly ["logo_dark_url"], readonly ["favicon_url"], readonly ["theme", "background", "image_url"], readonly ["theme", "sign_in", "image_url"]];
+/** An inline base64 image of a type a browser shows in `<img>` and CSS. */
+export declare const INLINE_IMAGE_PATTERN: RegExp;
+export declare const INLINE_IMAGE_TYPES: readonly ["image/png", "image/jpeg", "image/gif", "image/webp", "image/svg+xml", "image/x-icon", "image/vnd.microsoft.icon"];
+/** The most an image may weigh, decoded. */
+export declare const INLINE_IMAGE_MAX_BYTES: number;
+/** The decoded size of an inline image, or null when the value is not one. */
+export declare function inlineImageBytes(v: unknown): number | null;
+/** The MIME type of an inline image, or null. */
+export declare function inlineImageType(v: unknown): string | null;
+/** An image file as the inline value `branding` takes: `inlineImage(await readFile("brand/logo.png"), "image/png")`. */
+export declare function inlineImage(bytes: Uint8Array, type: string): string;
+/**
+ * Images that break the rule: every image is inline and at most
+ * `INLINE_IMAGE_MAX_BYTES`, so the portal serves it from its own host and no
+ * other host sees who opens a portal page. A URL or a path on the Tenant's
+ * site is refused when it is written.
+ */
+export declare function brandingImageProblems(branding: unknown): {
+    path: string[];
+    message: string;
+}[];
+//# sourceMappingURL=branding.d.ts.map

package/dist/branding.d.ts.map

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

package/dist/branding.js

@@ -0,0 +1,206 @@
+/**
+ * What a Tenant's repository may set of its branding and portal options, and
+ * the rule for branding images (ADR-038, ADR-039). Pure and dependency-free:
+ * the Engine checks writes with these, the Admin UI and a Tenant's
+ * application prepare them.
+ */
+import { PORTAL_PAGES, PORTAL_SWITCHES, defaultPortalOptions, resolvePortalOptions } from "./portal-options.js";
+/** Who edits a tab: a person in the Admin UI, or the Tenant's application (ADR-038, decision 3). */
+export const TENANT_SOURCES = ["admin_ui", "repository"];
+/** A Tenant's sources, `admin_ui` where unset or unreadable. */
+export function tenantSourcesOf(raw) {
+    const s = raw?.sources && typeof raw.sources === "object" ? raw.sources : {};
+    const one = (v) => (v === "repository" ? "repository" : "admin_ui");
+    return { branding: one(s.branding), portal: one(s.portal), tiers: one(s.tiers) };
+}
+/**
+ * The branding keys a repository sets (ADR-038, decision 2). Everything else
+ * — `portal_url`, `product_url`, `app_url`, `billing_url`, the support
+ * addresses — decides where a customer is sent and stays with an administrator.
+ */
+export const BRANDING_REPOSITORY_KEYS = ["theme", "primary_color", "logo_url", "logo_dark_url", "favicon_url"];
+/**
+ * The page modes a repository sets (ADR-039): whether a page shows. A
+ * `redirect` carries the address a customer is sent to and stays with an
+ * administrator.
+ */
+export const PORTAL_REPOSITORY_PAGE_MODES = ["portal", "off"];
+/** The portal options a repository sets: the switches and which pages show. Redirects and their URLs stay with an administrator. */
+export const PORTAL_REPOSITORY_KEYS = [...PORTAL_SWITCHES, "pages"];
+const isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+/**
+ * The repository's part of a stored branding, as `GET /tenant/v0/branding`
+ * answers it and `PUT` takes it back: the theme, the colour and the images,
+ * images only when inline (a link stored before ADR-038 is not shown anyway).
+ */
+export function repositoryBrandingOf(branding) {
+    const b = isObj(branding) ? branding : {};
+    const out = {};
+    if (isObj(b.theme) && Object.keys(b.theme).length) {
+        const theme = JSON.parse(JSON.stringify(b.theme));
+        for (const part of ["background", "sign_in"]) {
+            const p = theme[part];
+            if (!isObj(p))
+                continue;
+            if (p.image_url !== undefined && inlineImageBytes(p.image_url) === null)
+                delete p.image_url;
+            if (!Object.keys(p).length)
+                delete theme[part];
+        }
+        if (Object.keys(theme).length)
+            out.theme = theme;
+    }
+    if (typeof b.primary_color === "string" && b.primary_color)
+        out.primary_color = b.primary_color;
+    for (const k of ["logo_url", "logo_dark_url", "favicon_url"])
+        if (inlineImageBytes(b[k]) !== null)
+            out[k] = b[k];
+    return out;
+}
+/**
+ * The repository's part of stored portal options, as `GET /tenant/v0/portal`
+ * answers it: every switch, every page that is not redirected, and the pages
+ * an administrator moved to the Tenant's application (without their URLs).
+ */
+export function repositoryPortalOf(portal, ctx = {}) {
+    const o = resolvePortalOptions(portal, ctx);
+    const pages = {};
+    const redirected = [];
+    for (const p of PORTAL_PAGES) {
+        const mode = o.pages[p].mode;
+        if (mode === "redirect")
+            redirected.push(p);
+        else
+            pages[p] = { mode };
+    }
+    const switches = Object.fromEntries(PORTAL_SWITCHES.map((k) => [k, o[k]]));
+    return { portal: { ...switches, pages }, redirected };
+}
+/**
+ * A repository's portal options over the stored ones (ADR-039): the switches
+ * and page modes it sends replace the stored ones, one left out is back to
+ * its default, and a page an administrator redirected keeps its redirect
+ * (`kept`, when the body names it). `problems` are what the body may not
+ * hold, each with its path; the record's own rules (security and privacy
+ * never off, plan not off while the platform bills) are the Tenant schema's.
+ */
+export function mergeRepositoryPortal(stored, body) {
+    const problems = [];
+    for (const k of Object.keys(body))
+        if (!PORTAL_REPOSITORY_KEYS.includes(k))
+            problems.push({ path: `portal.${k}`, message: `set in the Admin UI, not from a repository; accepted here: ${PORTAL_REPOSITORY_KEYS.join(", ")}` });
+    for (const k of PORTAL_SWITCHES)
+        if (k in body && typeof body[k] !== "boolean")
+            problems.push({ path: `portal.${k}`, message: "must be true or false" });
+    const s = isObj(stored) ? stored : {};
+    const storedPages = isObj(s.pages) ? s.pages : {};
+    if (body.pages !== undefined && !isObj(body.pages))
+        problems.push({ path: "portal.pages", message: "an object with a { mode } per page" });
+    const wanted = isObj(body.pages) ? body.pages : {};
+    for (const p of Object.keys(wanted))
+        if (!PORTAL_PAGES.includes(p))
+            problems.push({ path: `portal.pages.${p}`, message: `not a page; the pages are ${PORTAL_PAGES.join(", ")}` });
+    const pages = {};
+    const kept = [];
+    const defaults = defaultPortalOptions().pages;
+    for (const p of PORTAL_PAGES) {
+        const w = wanted[p];
+        let mode = defaults[p].mode === "off" ? "off" : "portal";
+        if (w !== undefined) {
+            if (!isObj(w) || Object.keys(w).some((k) => k !== "mode"))
+                problems.push({ path: `portal.pages.${p}`, message: "must be { mode: portal | off }; a URL is set by an administrator" });
+            else if (w.mode === "redirect")
+                problems.push({ path: `portal.pages.${p}.mode`, message: "moving a page to the Tenant's application takes its address, which an administrator sets in the Admin UI" });
+            else if (!PORTAL_REPOSITORY_PAGE_MODES.includes(w.mode))
+                problems.push({ path: `portal.pages.${p}.mode`, message: "must be portal or off" });
+            else
+                mode = w.mode;
+        }
+        const st = storedPages[p];
+        if (isObj(st) && st.mode === "redirect") {
+            pages[p] = st;
+            if (w !== undefined)
+                kept.push(p);
+        }
+        else
+            pages[p] = { mode };
+    }
+    const rest = Object.fromEntries(Object.entries(s).filter(([k]) => !PORTAL_REPOSITORY_KEYS.includes(k)));
+    const switches = Object.fromEntries(PORTAL_SWITCHES.filter((k) => typeof body[k] === "boolean").map((k) => [k, body[k]]));
+    return { portal: { ...rest, ...switches, pages }, kept, problems };
+}
+/**
+ * Pages an administrator may not change while the Portal tab comes from the
+ * repository (ADR-039): an administrator moves a page to the Tenant's
+ * application, or brings a redirected page back to the portal; whether a page
+ * that is not redirected shows is the repository's.
+ */
+export function adminPageConflicts(stored, patchPages) {
+    if (!isObj(patchPages))
+        return [];
+    const out = [];
+    for (const p of PORTAL_PAGES) {
+        const w = patchPages[p];
+        if (!isObj(w))
+            continue;
+        const from = stored.pages[p].mode;
+        if (w.mode === "redirect" || (from === "redirect" && w.mode === "portal"))
+            continue;
+        if (w.mode !== from)
+            out.push(p);
+    }
+    return out;
+}
+/** Every image in `branding`, as a path into it (ADR-038, decision 6). */
+export const BRANDING_IMAGE_PATHS = [["logo_url"], ["logo_dark_url"], ["favicon_url"], ["theme", "background", "image_url"], ["theme", "sign_in", "image_url"]];
+/** An inline base64 image of a type a browser shows in `<img>` and CSS. */
+export const INLINE_IMAGE_PATTERN = /^data:image\/(png|jpeg|gif|webp|svg\+xml|x-icon|vnd\.microsoft\.icon);base64,[A-Za-z0-9+/]+={0,2}$/;
+export const INLINE_IMAGE_TYPES = ["image/png", "image/jpeg", "image/gif", "image/webp", "image/svg+xml", "image/x-icon", "image/vnd.microsoft.icon"];
+/** The most an image may weigh, decoded. */
+export const INLINE_IMAGE_MAX_BYTES = 256 * 1024;
+/** The decoded size of an inline image, or null when the value is not one. */
+export function inlineImageBytes(v) {
+    if (typeof v !== "string" || !INLINE_IMAGE_PATTERN.test(v))
+        return null;
+    const data = v.slice(v.indexOf(",") + 1);
+    const pad = data.endsWith("==") ? 2 : data.endsWith("=") ? 1 : 0;
+    return Math.floor((data.length * 3) / 4) - pad;
+}
+/** The MIME type of an inline image, or null. */
+export function inlineImageType(v) {
+    return typeof v === "string" && INLINE_IMAGE_PATTERN.test(v) ? v.slice(5, v.indexOf(";")) : null;
+}
+/** An image file as the inline value `branding` takes: `inlineImage(await readFile("brand/logo.png"), "image/png")`. */
+export function inlineImage(bytes, type) {
+    if (!INLINE_IMAGE_TYPES.includes(type))
+        throw new Error(`an image of type ${type} is not accepted; use one of ${INLINE_IMAGE_TYPES.join(", ")}`);
+    let bin = "";
+    for (let i = 0; i < bytes.length; i += 0x8000)
+        bin += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+    return `data:${type};base64,${btoa(bin)}`;
+}
+/**
+ * Images that break the rule: every image is inline and at most
+ * `INLINE_IMAGE_MAX_BYTES`, so the portal serves it from its own host and no
+ * other host sees who opens a portal page. A URL or a path on the Tenant's
+ * site is refused when it is written.
+ */
+export function brandingImageProblems(branding) {
+    if (!branding || typeof branding !== "object")
+        return [];
+    const out = [];
+    for (const path of BRANDING_IMAGE_PATHS) {
+        let v = branding;
+        for (const k of path)
+            v = v && typeof v === "object" ? v[k] : undefined;
+        if (v === undefined || v === null || v === "")
+            continue;
+        const bytes = inlineImageBytes(v);
+        if (bytes === null)
+            out.push({ path: [...path], message: "must be an inline base64 image (data:image/png;base64,…); a URL or a path on the Tenant's site is not accepted (ADR-038)" });
+        else if (bytes > INLINE_IMAGE_MAX_BYTES)
+            out.push({ path: [...path], message: `must be at most ${INLINE_IMAGE_MAX_BYTES / 1024} KB; this one is ${Math.ceil(bytes / 1024)} KB` });
+    }
+    return out;
+}
+//# sourceMappingURL=branding.js.map

package/dist/branding.js.map

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

package/dist/changesets.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Tenant changesets (ADR-054 §7, ADR-059 §2, ADR-074 §9): what changed on the
+ * Tenant-facing surface, Engine release by Engine release. The documents are
+ * the Engine's: published on the Engine site and listed by
+ * `GET /tenant/v0/changesets`. The SDK carries none of them, only the shape of
+ * the answer, so an SDK installed months ago never holds a stale list.
+ */
+export interface ChangesetEntry {
+    number: number;
+    slug: string;
+    /** `<nnn>-<slug>.md`, under `/changesets/` on the Engine site. */
+    file: string;
+    date: string;
+    title: string;
+    /** What it applies to, as the document's header says it. */
+    applies_to: string;
+    /** The Engine decisions it follows from (`ADR-058`). */
+    decisions: string[];
+    /** Whether a Tenant may have to act: anything but a plain "No" in the header. */
+    action_required: boolean;
+    /** From when the old behaviour is gone, a date or an Engine version, when the change comes with a window. */
+    deadline: string | null;
+    /** The first SDK release that carries the change (ADR-074 §4); null for "No SDK change" or a changeset from before the row. */
+    sdk_version: string | null;
+}
+/** A changeset's status for one Tenant: its ticket's (ADR-059 §2). */
+export declare const CHANGESET_STATUSES: readonly ["new", "acknowledged", "in_progress", "on_hold", "resolved", "canceled"];
+export type ChangesetStatus = (typeof CHANGESET_STATUSES)[number];
+/** One changeset as a Tenant reads it from `GET /tenant/v0/changesets`: the entry, its address, and this Tenant's ticket when it has one. */
+export interface TenantChangeset extends ChangesetEntry {
+    url: string | null;
+    ticket: string | null;
+    status: ChangesetStatus | null;
+}
+/** The published document's address on the Engine site, or null when the site is not configured. */
+export declare function changesetUrl(site: string | null | undefined, c: Pick<ChangesetEntry, "file">): string | null;
+/** The Tenant's feedback (ADR-054 §7, ADR-059 §3): what the agent sends when the Engine cannot do what the application needs. */
+export declare const FEEDBACK_KINDS: readonly ["limitation", "defect", "question"];
+export type FeedbackKind = (typeof FEEDBACK_KINDS)[number];
+/** The platform's ticket type each feedback kind opens (ADR-058 §3). */
+export declare const FEEDBACK_TYPE: Record<FeedbackKind, "engine_limitation" | "engine_defect" | "engine_question">;
+export interface FeedbackReport {
+    kind: FeedbackKind;
+    area: string;
+    summary: string;
+    detail: string;
+    context: {
+        engine?: string;
+        changeset?: number | null;
+        skill?: string;
+    };
+    refusal?: {
+        status: number;
+        type?: string;
+        detail?: string;
+    };
+}
+//# sourceMappingURL=changesets.d.ts.map

package/dist/changesets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changesets.d.ts","sourceRoot":"","sources":["../src/changesets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iFAAiF;IACjF,eAAe,EAAE,OAAO,CAAC;IACzB,6GAA6G;IAC7G,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+HAA+H;IAC/H,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,oFAAqF,CAAC;AAErH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,6IAA6I;AAC7I,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAChC;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAE5G;AAED,iIAAiI;AACjI,eAAO,MAAM,cAAc,+CAAgD,CAAC;AAE5E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE,mBAAmB,GAAG,eAAe,GAAG,iBAAiB,CAA6F,CAAC;AAExM,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D"}

package/dist/changesets.js

@@ -0,0 +1,18 @@
+/**
+ * Tenant changesets (ADR-054 §7, ADR-059 §2, ADR-074 §9): what changed on the
+ * Tenant-facing surface, Engine release by Engine release. The documents are
+ * the Engine's: published on the Engine site and listed by
+ * `GET /tenant/v0/changesets`. The SDK carries none of them, only the shape of
+ * the answer, so an SDK installed months ago never holds a stale list.
+ */
+/** A changeset's status for one Tenant: its ticket's (ADR-059 §2). */
+export const CHANGESET_STATUSES = ["new", "acknowledged", "in_progress", "on_hold", "resolved", "canceled"];
+/** The published document's address on the Engine site, or null when the site is not configured. */
+export function changesetUrl(site, c) {
+    return site ? `${site.replace(/\/+$/, "")}/changesets/${c.file}` : null;
+}
+/** The Tenant's feedback (ADR-054 §7, ADR-059 §3): what the agent sends when the Engine cannot do what the application needs. */
+export const FEEDBACK_KINDS = ["limitation", "defect", "question"];
+/** The platform's ticket type each feedback kind opens (ADR-058 §3). */
+export const FEEDBACK_TYPE = { limitation: "engine_limitation", defect: "engine_defect", question: "engine_question" };
+//# sourceMappingURL=changesets.js.map

package/dist/changesets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changesets.js","sourceRoot":"","sources":["../src/changesets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAWrH,oGAAoG;AACpG,MAAM,UAAU,YAAY,CAAC,IAA+B,EAAE,CAA+B;IAC3F,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC;AAED,iIAAiI;AACjI,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAI5E,wEAAwE;AACxE,MAAM,CAAC,MAAM,aAAa,GAAoF,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/cli/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/cli/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":""}

package/dist/cli/bin.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * The `asturiu-v0-tenant` command (ADR-074 §5). Run it through the repository's package script
+ * (`"asturiu": "asturiu-v0-tenant"`) or `npx --no-install asturiu-v0-tenant`: never plain `npx`, which would fetch
+ * whatever the registry holds under that name when the SDK is not installed.
+ */
+import { run } from "./cli.js";
+// A closed pipe (`… | head`) ends the run quietly.
+for (const stream of [process.stdout, process.stderr])
+    stream.on("error", (e) => (e.code === "EPIPE" ? process.exit(0) : undefined));
+process.exitCode = await run(process.argv.slice(2));
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,mDAAmD;AACnD,KAAK,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;IAAE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAwB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAE5J,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/cli/changesets.d.ts

@@ -0,0 +1,14 @@
+import { type Ctx } from "./context.js";
+/**
+ * The prompt for the Tenant's coding agent, as a changeset document writes it: the first fenced block under the
+ * heading "Prompt for your coding agent". Text to show the person, never to run.
+ */
+export declare function promptOf(document: string): string | null;
+/** The pulled document of a changeset, with its prompt, when the repository has it. */
+export declare function pulledDocument(ctx: Ctx, file: string): {
+    path: string;
+    prompt: string | null;
+} | null;
+export declare function cmdChangesets(ctx: Ctx, args: string[]): Promise<void>;
+export declare function cmdChangeset(ctx: Ctx, args: string[]): Promise<void>;
+//# sourceMappingURL=changesets.d.ts.map

package/dist/cli/changesets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changesets.d.ts","sourceRoot":"","sources":["../../src/cli/changesets.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,GAAG,EAA0H,MAAM,cAAc,CAAC;AAYhK;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASxD;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAIrG;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,iBAiD3D;AA0CD,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,iBAK1D"}