@nanobpm/nano-ide-ext-types 1.3.0 → 1.5.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type ExtKind = "lang" | "app" | "example" | "theme";
+export type ExtKind = "lang" | "app" | "example" | "theme" | "trigger";
 export interface FileType {
     /** File extension including the dot, e.g. ".rs". */
     ext: string;
@@ -48,7 +48,20 @@ export interface RunConfig {
 }
 export interface TemplateSpec {
     id: string;
+    /** Short human-facing title rendered on the New Project template card. */
     label: string;
+    /** One-line description rendered on the template card. Older packs instead
+     * cram "Title — description" into `label`; the console's template menu
+     * splits that on the em-dash as a fallback, but new packs should set this.
+     * Hosts that don't understand `description` render `label` alone, so if you
+     * must support such a host, keep the combined "Title — description" `label`
+     * (the em-dash split then keeps modern cards correct too). */
+    description?: string;
+    /** Language pack id this template's project uses, when it differs from what
+     * the pack implies (lang packs → the pack id; app/example packs →
+     * `requires[0]`, else "deno"). Drives the card's language icon AND the
+     * scaffolded project's `lang`. */
+    lang?: string;
 }
 /**
  * The console's design-token vocabulary (nanobpmn
@@ -141,6 +154,53 @@ export interface SignatureParam {
     /** Markdown documentation for this parameter. */
     documentation?: string;
 }
+/**
+ * One config field a pack surfaces in the console (read-only in the IDE config
+ * panel; for a trigger source, the fields a trigger of this `kind` renders).
+ */
+export interface ConfigField {
+    /** Stable key within the pack (the manifest trigger's `config[key]`). */
+    key: string;
+    /** Human-facing label. */
+    label: string;
+    /** What the field controls. */
+    description?: string;
+    /** Environment variable this field reads its current value from, if any. */
+    env?: string;
+    /** Documented default when unset. */
+    default?: string;
+}
+/**
+ * How a trigger source pack's events reach the runtime (ADR 0025 §6). Only
+ * `webhook` — the universal ingress the driver POSTs to — is honoured in v1;
+ * the field is forward-declared so a pack states its contract explicitly.
+ */
+export type SourceTransport = "webhook";
+/**
+ * One trigger source **kind** a `kind: "trigger"` pack contributes (ADR 0025
+ * §6). Registering a `kind` lets a manifest trigger use it and the
+ * console/validation recognise it. The pack's out-of-process `driver` (a
+ * Node/Deno process, ADR 0038/0036) emits events over the trigger ingress; the
+ * runtime owns the inbox/dispatch/retry — the pack only produces events.
+ */
+export interface TriggerSourceSpec {
+    /** The `type` string a manifest trigger uses (e.g. "mqtt", "imap"). */
+    kind: string;
+    /** Human label for the console source picker. */
+    displayName?: string;
+    /** How the runtime receives this source's events. Defaults to "webhook". */
+    transport?: SourceTransport;
+    /** Config fields the console renders for a trigger of this kind. */
+    configFields?: ConfigField[];
+    /**
+     * Pack-relative path to the out-of-process driver entrypoint (a Node/Deno
+     * `.ts`/`.js`/`.mjs` file). When present, the runtime auto-launches and
+     * supervises the driver while an App with a trigger of this `kind` runs
+     * (ADR 0025 phase 4): one child process per such trigger, restarted with
+     * backoff on crash, killed when the App stops. Absent = declaration-only.
+     */
+    driver?: string;
+}
 export interface ExtManifest {
     id: string;
     kind: ExtKind;
@@ -171,5 +231,9 @@ export interface ExtManifest {
     intellisense?: LangIntellisense[];
     /** Built-in packs set this; published packs omit it. */
     builtin?: boolean;
+    /** trigger packs: the trigger source kinds this pack contributes (ADR 0025
+     * §6). Each entry registers a `type` a manifest trigger can use; the pack's
+     * out-of-process driver emits events over the trigger ingress. */
+    triggerSources?: TriggerSourceSpec[];
 }
 export declare const MANIFEST_FILE = "nano-ide.ext.json";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanobpm/nano-ide-ext-types",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "TypeScript types for the nano-ide.ext.json extension manifest (ADR 0007).",
   "license": "Apache-2.0",
   "type": "module",