@nanobpm/nano-ide-ext-types 1.3.0 → 1.4.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;
@@ -141,6 +141,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 +218,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.4.0",
   "description": "TypeScript types for the nano-ide.ext.json extension manifest (ADR 0007).",
   "license": "Apache-2.0",
   "type": "module",