initiative-plugin-sdk 2.0.0

package/dist/contract.js

@@ -0,0 +1,167 @@
+/**
+ * The plug-in contract, as TypeScript.
+ *
+ * GENERATED from `manifest.contract.json` by `scripts/generate.mjs`. Do not
+ * edit it: change the contract and run `npm run generate`.
+ *
+ * These are the enums, caps and character sets the bundled JSON Schema is built
+ * from, and the shape of every object it defines, so this package's types
+ * cannot describe a manifest the schema refuses, nor miss a term it allows.
+ */
+export const FEATURES = ["dashboards", "embeds", "endpoints", "widgets"];
+export const PROTOCOLS = [1];
+export const CONNECTION_SCOPES = ["interactive", "static"];
+export const FLOW_TYPES = ["oauth2"];
+export const TOKEN_TYPES = ["jwt_bearer"];
+export const REVOKE_METHODS = ["github_grant", "hook", "rfc7009"];
+export const JWT_ALGORITHMS = ["ES256", "RS256"];
+export const FIELD_TYPES = ["bool", "int", "secret", "select", "string", "url"];
+export const VENDOR_FIELD_TYPES = ["secret", "string", "url"];
+export const GITHUB_PERMISSION_LEVELS = ["read", "write"];
+export const GITHUB_APP_VALUES = ["client_id", "client_secret", "id", "pem", "slug", "webhook_secret"];
+export const WEBHOOK_SCHEMES = ["hmac_sha1", "hmac_sha256"];
+export const WEBHOOK_ENCODINGS = ["base64", "hex"];
+export const PARAM_TYPES = ["bool", "datetime", "int", "select", "string", "url"];
+export const RETURN_VALUE_TYPES = ["bool", "datetime", "int", "string", "url"];
+export const DIRECTIONS = ["emit", "read", "write"];
+export const ACTOR_KINDS = ["installation", "member"];
+export const SCOPES = ["projects:read", "projects:write", "documents:read", "documents:write", "queues:read", "queues:write", "counter_groups:read", "counter_groups:write", "calendars:read", "calendars:write", "dashboards:read", "dashboards:write", "posts:read", "posts:write", "galleries:read", "galleries:write", "wikis:read", "wikis:write", "comments:read", "comments:write", "relationships:read", "relationships:write", "tags:read", "tags:write", "sharing:read", "sharing:write", "members:read", "initiatives:read", "initiatives:moderate", "community:admin"];
+export const SURFACE_SCOPES = ["community", "initiative"];
+export const EMBED_CAPABILITIES = ["camera", "clipboard-read", "clipboard-write", "display-capture", "fullscreen", "geolocation", "microphone"];
+export const LISTING_KINDS = ["plugin", "dashboard"];
+export const HTTP_METHODS = ["DELETE", "GET", "PATCH", "POST", "PUT"];
+export const PAGE_LIMITS = ["refuse", "truncate"];
+export const STATUS_RANGES = ["2xx", "3xx", "4xx", "5xx"];
+export const CONNECTION_STATES = ["ok", "removed", "suspended", "unavailable"];
+export const PLATFORM_CODES = ["invalid", "mapping-failed", "not-authorized", "not-found", "range-too-large"];
+/** Every cap the platform enforces, by the name the contract gives it. */
+export const CAPS = {
+    connections: 20,
+    fieldsPerConnection: 12,
+    vendorFields: 12,
+    githubAppPermissions: 100,
+    githubAppEvents: 100,
+    flowScopes: 24,
+    authorizeParams: 12,
+    tokenLifetimeSeconds: 600,
+    selectOptions: 24,
+    accessHintScopes: 24,
+    requiresTerms: 10,
+    widgets: 12,
+    widgetEndpoints: 8,
+    endpoints: 64,
+    paramsPerEndpoint: 12,
+    returnsPerEndpoint: 24,
+    embeds: 12,
+    embedCapabilities: 8,
+    bundledDashboards: 8,
+    dashboardWidgets: 50,
+    dashboardGridColumns: 12,
+    dashboardBindingParams: 12,
+    identifierLength: 64,
+    publicIdLength: 120,
+    pathLength: 200,
+    endpointIdLength: 200,
+    nameLength: 255,
+    labelLength: 120,
+    hintLength: 120,
+    descriptionLength: 500,
+    paramValueLength: 2000,
+    uidLength: 14,
+    textLength: 120,
+    locales: 40,
+    cacheTtlSeconds: 86400,
+    moduleSourceBytes: 65536,
+    sampleDataBytes: 32768,
+    serviceDefinitionBytes: 524288,
+    versionLength: 32,
+    publisherNameLength: 120,
+    urlLength: 300,
+    localeTagLength: 12,
+    widgetDescriptionLength: 400,
+    widgetOptions: 12,
+    valuesPerOption: 24,
+    identityKeyParts: 4,
+    pluginScopes: 24,
+    schedules: 8,
+    scheduleMinMinutes: 5,
+    scheduleMaxMinutes: 1440,
+    scheduleEveryLength: 5,
+    hosts: 8,
+    hostLength: 253,
+    steps: 3,
+    pages: 10,
+    perPage: 100,
+    requestQuery: 24,
+    requestHeaders: 12,
+    errorRules: 12,
+    unavailableCodes: 12,
+    webhookEvents: 32,
+    webhookStatuses: 12,
+    healthStates: 12,
+    statusCode: 599,
+    expressionLength: 16384,
+    graphqlLength: 16384,
+    expressionTimeMs: 1000,
+    expressionDepth: 500,
+    expressionOutputBytes: 1048576,
+};
+/** The character sets ids and paths are drawn from. */
+export const CHARSETS = {
+    identifier: "-0123456789_abcdefghijklmnopqrstuvwxyz",
+    namespacedId: "-.0123456789_abcdefghijklmnopqrstuvwxyz",
+    publicId: "-.0123456789_abcdefghijklmnopqrstuvwxyz",
+    uid: "0123456789ABCDEFGHJKMNPQRSTVWXYZ",
+    path: "-./0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_abcdefghijklmnopqrstuvwxyz",
+    headerName: "-0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",
+    fieldPath: "-.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_abcdefghijklmnopqrstuvwxyz",
+    localeTag: "-ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",
+    version: "0123456789.-+abcdefghijklmnopqrstuvwxyz",
+    artwork: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/._-",
+    queryName: "-.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ[]_abcdefghijklmnopqrstuvwxyz~",
+};
+/**
+ * Every field the contract declares, by the object that owns it.
+ *
+ * The inventory the platform holds its normalizer to, exported so a consumer
+ * can enumerate what a manifest may carry without parsing the schema.
+ */
+export const FIELDS = {
+    requires: ["all_of", "any_of"],
+    accessHint: ["api", "scopes"],
+    connectionField: ["key", "type", "required", "label", "options", "managed"],
+    vendor: ["label", "fields", "setup"],
+    vendorField: ["key", "type", "required", "label"],
+    githubAppManifestSetup: ["kind", "app", "values"],
+    githubAppManifest: ["name", "url", "public", "default_permissions", "default_events"],
+    endpointParam: ["key", "type", "required", "label", "options", "options_from", "list"],
+    endpointReturn: ["key", "type", "label", "list"],
+    connection: ["id", "scope", "label", "fields", "flow", "token", "access_hint", "health"],
+    connectionFlow: ["type", "authorize_url", "token_url", "client_id", "client_secret", "scopes", "pkce", "authorize_params", "install_url", "after_connect", "revoke", "revoke_url"],
+    connectionToken: ["type", "exchange_url", "iss", "key", "alg", "lifetime"],
+    webhooks: ["verify", "dedup", "route", "events", "status"],
+    webhookVerify: ["scheme", "header", "prefix", "encoding", "secret"],
+    webhookRoute: ["path", "header", "connection", "field"],
+    schedule: ["id", "every"],
+    endpoint: ["id", "label", "description", "returns", "group", "needs_subject", "direction", "params", "actors", "admin_only", "public", "requires", "cache_ttl_seconds", "identity", "unavailable", "request", "steps", "map", "errors"],
+    widget: ["id", "meta", "module_source", "endpoints", "sample_data", "requires"],
+    embed: ["id", "path", "name", "scopes", "admin_only", "capabilities", "requires"],
+    bundledDashboard: ["uid", "public_id", "name", "description", "layout", "widgets"],
+    bundledDashboardWidget: ["id", "type", "title", "grid", "binding"],
+    endpointIdentity: ["kind", "key"],
+    vendorAuth: ["header", "prefix"],
+    vendorRequest: ["method", "url", "query", "headers", "body", "graphql", "connection", "paging"],
+    graphqlRequest: ["query", "variables"],
+    requestStep: ["name", "request"],
+    pageNumberPaging: ["kind", "page_param", "per_page_param", "per_page", "items", "max_pages", "on_limit"],
+    linkHeaderPaging: ["kind", "items", "max_pages", "on_limit"],
+    cursorPaging: ["kind", "next", "more", "param", "variable", "items", "max_pages", "on_limit"],
+    errorRule: ["status", "when", "code"],
+    afterConnect: ["request", "steps", "map", "refuse_when", "code"],
+    connectionHealth: ["request", "every", "states"],
+    healthState: ["status", "when", "state"],
+    webhookEvent: ["when", "emit", "map"],
+    webhookStatus: ["when", "connection", "state"],
+    manifest: ["plugin_kind", "service", "features", "default_name", "hosts", "auth", "vendor", "connections", "webhooks", "schedules", "endpoints", "community_summary", "widgets", "embeds", "dashboards"],
+};
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/define.d.ts

@@ -0,0 +1,336 @@
+/**
+ * One typed definition of a plug-in.
+ *
+ * {@link definePlugin} takes everything a plug-in declares and does: its endpoints
+ * with their handlers, its hooks and schedules, its widgets and surfaces, and
+ * its listing. The same object routes Initiative's calls (`createPlugin`) and
+ * becomes the manifest (`initiative-plugin build`), so nothing is stated twice.
+ *
+ * {@link defineEndpoint} types one endpoint from its own declaration: its
+ * `params` type the handler's arguments and its `returns` type what the
+ * handler answers with.
+ *
+ * A declarative plug-in gives each endpoint a `request` (or `steps`) and a `map`
+ * in place of a handler, and names its `hosts`: Initiative then makes the
+ * calls and maps the answers itself, and there is no service to run. One plug-in
+ * is one kind or the other.
+ *
+ * Endpoints are named by their key. The manifest id is `plugin.<publicId>.<key>`,
+ * and everywhere a definition refers to an endpoint (a widget, a sample, a
+ * parameter's `options_from`, a bundled dashboard, `communitySummary`) it uses the
+ * key.
+ */
+import type { ActorKind, PluginScope, BundledDashboard, BundledDashboardWidget, Connection, Embed, Endpoint, EndpointParam, EndpointReturn, ErrorRule, Expression, Manifest, RequestStep, ReturnValueType, Scope, Vendor, VendorAuth, VendorRequest, WebhookEvent, Webhooks, Widget } from "./contract.js";
+import type { Client } from "./client.js";
+/**
+ * What every handler is handed as `context`: the value given to `createPlugin`.
+ *
+ * Empty until a plug-in says what it holds, by augmenting this interface:
+ *
+ * ```ts
+ * declare module "initiative-plugin-sdk/manifest" {
+ *   interface PluginContext { tracker: TrackerClient }
+ * }
+ * ```
+ */
+export interface PluginContext {
+}
+/** One declared parameter, keyed by its name. */
+export type ParamSpec = Omit<EndpointParam, "key">;
+/** One declared return, keyed by its name: its type, or the whole declaration. */
+export type ReturnSpec = ReturnValueType | Omit<EndpointReturn, "key">;
+type Scalar<T> = T extends "int" ? number : T extends "bool" ? boolean : string;
+type ReturnValue<S> = S extends ReturnValueType ? Scalar<S> : S extends {
+    type: infer T;
+    list: true;
+} ? Array<Scalar<T>> : S extends {
+    type: infer T;
+} ? Scalar<T> : never;
+/**
+ * What an endpoint answers with: its declared returns, by name. A `list`
+ * return is an array. Each may be left out or null; a key the endpoint does
+ * not declare is refused.
+ */
+export type Result<R> = {
+    [K in keyof R]?: ReturnValue<R[K]> | null;
+};
+/**
+ * A parameter as a caller sent it. Initiative sends strings; an automation
+ * may send numbers and booleans as they are.
+ */
+export type ParamValue = string | number | boolean;
+/** The parameters a call carries, by their declared names. */
+export type Params<P> = {
+    [K in keyof P]?: P[K] extends {
+        list: true;
+    } ? ParamValue[] : ParamValue;
+};
+/** Whose behalf a call is on: the community, or one of its members by this installation's reference for them. */
+export type Actor = {
+    kind: "installation";
+} | {
+    kind: "member";
+    member: string;
+};
+/** What every handler is handed. */
+export interface Call {
+    /** The installation: the community, by the reference this plug-in's install knows it by. */
+    installation: string;
+    /** Initiative, acting as whoever the call is for. */
+    client: Client;
+    context: PluginContext;
+}
+export interface EndpointCall<P> extends Call {
+    /** The endpoint's manifest id. */
+    endpoint: string;
+    params: Params<P>;
+    /** Initiative's own calls, for a widget, are the community's. */
+    actor: Actor;
+    /** The plug-in that made this call through Initiative, by its public id, or null for Initiative's own. */
+    caller: string | null;
+    /** The initiative the call is confined to, when it is. */
+    initiative: number | null;
+    /** Connection id → the handle Initiative gives a token for, where the call depends on one. */
+    connections: Record<string, string>;
+}
+/** What a handler answers with. `actor` says whose credential ran it; absent, the call's actor. */
+export interface Outcome<R> {
+    result: Result<R>;
+    actor?: ActorKind;
+}
+type Described = Omit<Endpoint, "id" | "direction" | "params" | "returns" | "request" | "steps" | "map" | "errors">;
+/** An endpoint Initiative calls: a `read`, or a `write` another plug-in calls through it. */
+export interface CallableEndpoint<P, R, D extends "read" | "write" = "read" | "write"> extends Described {
+    direction: D;
+    params?: P;
+    returns?: R;
+    handler: (call: EndpointCall<P>) => Promise<Outcome<R>>;
+}
+/**
+ * An endpoint a declarative plug-in answers without code: Initiative makes the
+ * `request`, or each of the `steps` in order, and `map` turns the answer into
+ * the endpoint's returns.
+ */
+export type DeclarativeEndpoint<P, R, D extends "read" | "write" = "read" | "write"> = Described & {
+    direction: D;
+    params?: P;
+    returns?: R;
+    map: Expression;
+    errors?: ErrorRule[];
+} & ({
+    request: VendorRequest;
+    steps?: never;
+} | {
+    steps: RequestStep[];
+    request?: never;
+});
+/** An announcement the plug-in emits: declared, never called. */
+export interface EmittedEndpoint<R> extends Described {
+    direction: "emit";
+    returns?: R;
+}
+export type EndpointDeclaration = CallableEndpoint<any, any> | DeclarativeEndpoint<any, any> | EmittedEndpoint<any>;
+/** One endpoint, typed from its own `params` and `returns`. */
+export declare function defineEndpoint<const R extends Record<string, ReturnSpec> = {}>(endpoint: EmittedEndpoint<R>): EmittedEndpoint<R>;
+export declare function defineEndpoint<D extends "read" | "write", const P extends Record<string, ParamSpec> = {}, const R extends Record<string, ReturnSpec> = {}>(endpoint: CallableEndpoint<P, R, D>): CallableEndpoint<P, R, D>;
+export declare function defineEndpoint<D extends "read" | "write", const P extends Record<string, ParamSpec> = {}, const R extends Record<string, ReturnSpec> = {}>(endpoint: DeclarativeEndpoint<P, R, D>): DeclarativeEndpoint<P, R, D>;
+/** What `after_connect` is sent, once a connection's flow has exchanged its code. */
+export interface AfterConnectCall extends Call {
+    /** The connection's manifest id. */
+    connection: string;
+    /** `member` for a member's own account, `installation` for the community's. */
+    actor: ActorKind;
+    /** The access token the flow just obtained, to look the account up with. */
+    access_token: string;
+    /** The flow's parameters, such as the `installation_id` an install page returned. */
+    params: Record<string, string>;
+}
+/** The connection's managed values and the account's label, or a refusal. */
+export type AfterConnectAnswer = {
+    values?: Record<string, unknown>;
+    account_label?: string;
+} | {
+    refuse: true;
+};
+/** What `revoke` is sent when a connection whose flow says `revoke: "hook"` ends. */
+export interface RevokeCall extends Call {
+    connection: string;
+    access_token: string | null;
+    refresh_token: string | null;
+}
+/** One vendor webhook delivery, which Initiative checked and routed to this installation. */
+export interface WebhookCall extends Call {
+    /** The static connection the delivery was routed by. */
+    connection: string;
+    /** The vendor's `x-` headers, lowercased. */
+    headers: Record<string, string>;
+    /** The body exactly as the vendor sent it. */
+    body: string;
+}
+/** One due schedule, for one installation. */
+export interface ScheduleCall extends Call {
+    schedule: string;
+    /** When this schedule last succeeded for the installation (ISO 8601), or null the first time. */
+    since: string | null;
+}
+/** The hooks Initiative calls while it runs connections and receives the vendor's webhooks. */
+export interface Hooks {
+    after_connect?: (call: AfterConnectCall) => Promise<AfterConnectAnswer>;
+    revoke?: (call: RevokeCall) => Promise<void>;
+    webhook?: (call: WebhookCall) => Promise<void>;
+}
+export interface ScheduleDeclaration {
+    /** A whole number of minutes (`15m`) or hours (`6h`). */
+    every: `${number}${"m" | "h"}`;
+    run: (call: ScheduleCall) => Promise<void>;
+}
+/** A member opening one of the plug-in's surfaces, as the handoff token names them. */
+export interface Handoff extends Call {
+    surface: string;
+    /** The member, by this installation's reference for them. */
+    viewer: string;
+    /** Whether the viewer administers the community. For shaping screens; not a grant. */
+    admin: boolean;
+    /** The initiative the surface was opened in, or null for the whole community. */
+    initiative: number | null;
+}
+export interface SurfaceCall {
+    request: Request;
+    /** Null for a request that carries no handoff token, such as the page's own files. */
+    handoff: Handoff | null;
+}
+/**
+ * A page of the plug-in that Initiative frames. The page is the plug-in's own; a
+ * request under its path that carries a handoff token reaches the handler with
+ * the handoff verified.
+ */
+export interface SurfaceDeclaration extends Omit<Embed, "id"> {
+    handler?: (call: SurfaceCall) => Promise<Response>;
+}
+type ReadName<E> = {
+    [K in keyof E]: E[K] extends {
+        direction: "read";
+    } ? K : never;
+}[keyof E] & string;
+type EmitName<E> = {
+    [K in keyof E]: E[K] extends {
+        direction: "emit";
+    } ? K : never;
+}[keyof E] & string;
+/** The vendor's webhooks. A declarative plug-in's events name the emit endpoint by its key. */
+export type WebhooksDeclaration<E> = Omit<Webhooks, "events"> & {
+    events?: Array<Omit<WebhookEvent, "emit"> & {
+        emit: EmitName<E>;
+    }>;
+};
+type ReturnsOf<X> = X extends {
+    returns?: infer R;
+} ? NonNullable<R> : {};
+/** A dashboard tile the plug-in contributes. `module` is the widget's source file. */
+export interface WidgetDeclaration<E> extends Omit<Widget, "id" | "module_source" | "endpoints" | "sample_data"> {
+    /** Read endpoints the widget may be bound to. */
+    endpoints?: readonly ReadName<E>[];
+    /**
+     * The widget's TypeScript module, relative to the plug-in's package: it exports
+     * `render(data)`. The build bundles it into the manifest's `module_source`.
+     */
+    module: string;
+    /** What each endpoint would answer, for a preview with no network call. */
+    sample_data?: {
+        [K in ReadName<E>]?: Result<ReturnsOf<E[K]>>;
+    };
+}
+export interface DashboardDeclaration<E, W> extends Omit<BundledDashboard, "widgets"> {
+    widgets: Array<Omit<BundledDashboardWidget, "type" | "binding"> & {
+        type: keyof W & string;
+        binding: Omit<BundledDashboardWidget["binding"], "endpoint_id"> & {
+            endpoint_id: ReadName<E>;
+        };
+    }>;
+}
+/**
+ * The plug-in's registry listing. `initiative-plugin build --registry <dir>` writes it
+ * while `version` is the package's own version.
+ */
+export interface ListingDeclaration {
+    /** The publisher's prefix, the part of the public id before the first dot. */
+    publisher: string;
+    /** One or two sentences for the listing's card. */
+    summary: string;
+    /** The listing page's longer text. Markdown. */
+    description?: string;
+    /** The listing's picture, relative to the plug-in's package. */
+    avatar: string;
+    version: string;
+    /** The oldest Initiative release this version runs on. */
+    minAppVersion?: string;
+    releaseNotes?: string;
+    /**
+     * A container plug-in's image for this version, pinned by digest. Every
+     * deployment runs its own copy and gives the key it signs with, so a listing
+     * names no keys. A declarative plug-in has none.
+     */
+    image?: string;
+    /** The most the plug-in may ever be granted. Absent: its `scopes`. */
+    scopeCeiling?: Array<Scope | PluginScope>;
+    referenceSectors?: string[];
+    /**
+     * The Docker Compose service an operator copies to run the image beside
+     * Initiative. `service` is the fragment, YAML text of at most 4096
+     * characters. Initiative fills two placeholders when it shows it: `${IMAGE}`,
+     * `image` above, and `${INITIATIVE_URL}`, the deployment's public address;
+     * any other `${…}` is refused. `baseUrl` is where the service answers on the
+     * Compose network, such as `http://tracker:8080`: an http or https URL of at
+     * most 512 characters. A container plug-in's only.
+     */
+    compose?: {
+        service: string;
+        baseUrl: string;
+    };
+}
+export interface PluginDefinition<E, W> {
+    /** `<publisher>.<slug>`. */
+    publicId: string;
+    /** The catalog id: 14 characters of Crockford base32, minted once (`initiative-plugin uid`). */
+    uid: string;
+    name: string;
+    scopes?: Array<Scope | PluginScope>;
+    /** A declarative plug-in's hosts: every host its requests may reach. Naming them makes the plug-in declarative. */
+    hosts?: string[];
+    /** How a declarative plug-in's requests carry their credential. Absent: `Authorization: Bearer <token>`. */
+    auth?: VendorAuth;
+    vendor?: Vendor;
+    /** Keyed by connection id. */
+    connections?: Record<string, Omit<Connection, "id">>;
+    webhooks?: WebhooksDeclaration<E>;
+    /** Keyed by schedule id. Each runs through the `schedule` hook. */
+    schedules?: Record<string, ScheduleDeclaration>;
+    endpoints?: E;
+    /** A read endpoint describing the community's standing with the plug-in's service. */
+    communitySummary?: ReadName<E>;
+    hooks?: Hooks;
+    widgets?: W;
+    /** Pages and panels, keyed by surface id. */
+    surfaces?: Record<string, SurfaceDeclaration>;
+    dashboards?: DashboardDeclaration<E, W>[];
+    listing?: ListingDeclaration;
+}
+/** Any plug-in's definition, as the server and the build read it. */
+export type AnyPlugin = Omit<PluginDefinition<any, any>, "endpoints" | "widgets"> & {
+    endpoints?: Record<string, EndpointDeclaration>;
+    widgets?: Record<string, WidgetDeclaration<any>>;
+};
+/** The plug-in, declared once. */
+export declare function definePlugin<const E extends Record<string, EndpointDeclaration> = {}, const W extends Record<string, WidgetDeclaration<E>> = {}>(definition: PluginDefinition<E, W>): PluginDefinition<E, W>;
+/** An endpoint's manifest id. */
+export declare function endpointId(plugin: {
+    publicId: string;
+}, name: string): string;
+/**
+ * The manifest a definition declares: its handlers left out, its keys made
+ * ids, in the contract's order. Each widget's `module_source` is taken from
+ * `modules` by widget id. A definition naming `hosts` is declarative, and its
+ * manifest has no `service` block.
+ */
+export declare function manifestOf(plugin: AnyPlugin, modules?: Record<string, string>): Manifest;
+export {};

package/dist/define.js

@@ -0,0 +1,120 @@
+/**
+ * One typed definition of a plug-in.
+ *
+ * {@link definePlugin} takes everything a plug-in declares and does: its endpoints
+ * with their handlers, its hooks and schedules, its widgets and surfaces, and
+ * its listing. The same object routes Initiative's calls (`createPlugin`) and
+ * becomes the manifest (`initiative-plugin build`), so nothing is stated twice.
+ *
+ * {@link defineEndpoint} types one endpoint from its own declaration: its
+ * `params` type the handler's arguments and its `returns` type what the
+ * handler answers with.
+ *
+ * A declarative plug-in gives each endpoint a `request` (or `steps`) and a `map`
+ * in place of a handler, and names its `hosts`: Initiative then makes the
+ * calls and maps the answers itself, and there is no service to run. One plug-in
+ * is one kind or the other.
+ *
+ * Endpoints are named by their key. The manifest id is `plugin.<publicId>.<key>`,
+ * and everywhere a definition refers to an endpoint (a widget, a sample, a
+ * parameter's `options_from`, a bundled dashboard, `communitySummary`) it uses the
+ * key.
+ */
+import { FEATURES } from "./contract.js";
+export function defineEndpoint(endpoint) {
+    return endpoint;
+}
+/** The plug-in, declared once. */
+export function definePlugin(definition) {
+    return definition;
+}
+/** An endpoint's manifest id. */
+export function endpointId(plugin, name) {
+    return `plugin.${plugin.publicId}.${name}`;
+}
+/**
+ * The manifest a definition declares: its handlers left out, its keys made
+ * ids, in the contract's order. Each widget's `module_source` is taken from
+ * `modules` by widget id. A definition naming `hosts` is declarative, and its
+ * manifest has no `service` block.
+ */
+export function manifestOf(plugin, modules = {}) {
+    const id = (name) => endpointId(plugin, name);
+    const blocks = {
+        vendor: plugin.vendor,
+        connections: listOf(plugin.connections, (key, connection) => ({ id: key, ...connection })),
+        webhooks: plugin.webhooks && {
+            ...plugin.webhooks,
+            ...(plugin.webhooks.events ? { events: plugin.webhooks.events.map((event) => ({ ...event, emit: id(event.emit) })) } : {}),
+        },
+        schedules: listOf(plugin.schedules, (key, schedule) => ({ id: key, every: schedule.every })),
+        endpoints: listOf(plugin.endpoints, (key, endpoint) => endpointOf(id(key), endpoint, id)),
+        community_summary: plugin.communitySummary === undefined ? undefined : id(plugin.communitySummary),
+        widgets: listOf(plugin.widgets, (key, widget) => widgetOf(key, widget, modules[key] ?? "", id)),
+        embeds: listOf(plugin.surfaces, (key, surface) => {
+            const { handler: _handler, ...embed } = surface;
+            return { id: key, ...embed };
+        }),
+        dashboards: plugin.dashboards?.map((dashboard) => ({
+            ...dashboard,
+            widgets: dashboard.widgets.map((widget) => ({
+                ...widget,
+                binding: { ...widget.binding, endpoint_id: id(widget.binding.endpoint_id) },
+            })),
+        })),
+    };
+    const present = Object.fromEntries(Object.entries(blocks).filter(([, value]) => value !== undefined));
+    return {
+        plugin_kind: "service",
+        ...(plugin.hosts
+            ? {}
+            : { service: { public_id: plugin.publicId, protocol: 1, ...(plugin.scopes ? { scopes: [...plugin.scopes] } : {}) } }),
+        features: FEATURES.filter((feature) => present[feature] !== undefined),
+        default_name: plugin.name,
+        ...(plugin.hosts ? { hosts: [...plugin.hosts] } : {}),
+        ...(plugin.auth ? { auth: plugin.auth } : {}),
+        ...present,
+    };
+}
+/** A record's entries as a list, or undefined when it holds none. */
+function listOf(record, build) {
+    const entries = Object.entries(record ?? {});
+    return entries.length ? entries.map(([key, value]) => build(key, value)) : undefined;
+}
+/** The declaration in the author's own order, with its keys made ids. */
+function endpointOf(endpointIdValue, endpoint, id) {
+    const out = { id: endpointIdValue };
+    for (const [key, value] of Object.entries(endpoint)) {
+        if (key === "handler")
+            continue;
+        if (key === "params") {
+            out.params = Object.entries(value).map(([name, param]) => ({
+                key: name,
+                ...param,
+                ...(param.options_from ? { options_from: { ...param.options_from, endpoint: id(param.options_from.endpoint) } } : {}),
+            }));
+        }
+        else if (key === "returns") {
+            out.returns = Object.entries(value).map(([name, spec]) => typeof spec === "string" ? { key: name, type: spec } : { key: name, ...spec });
+        }
+        else
+            out[key] = value;
+    }
+    return out;
+}
+function widgetOf(key, widget, source, id) {
+    const out = { id: key };
+    for (const [field, value] of Object.entries(widget)) {
+        if (field === "module")
+            out.module_source = source;
+        else if (field === "endpoints")
+            out.endpoints = value.map(id);
+        else if (field === "sample_data") {
+            out.sample_data = Object.fromEntries(Object.entries(value).map(([name, sample]) => [id(name), sample]));
+        }
+        else
+            out[field] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

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