@stackables/bridge 1.1.1 → 1.3.0

package/build/types.d.ts

@@ -54,6 +54,12 @@ export type Bridge = {
     handles: HandleBinding[];
     /** Connection wires */
     wires: Wire[];
+    /**
+     * Iterator handle names for array mapping blocks.
+     * Key: the array destination field name (first path component of `to`).
+     * Value: the iterator handle alias declared with `[] as <iter> { }`.
+     */
+    arrayIterators?: Record<string, string>;
     /**
      * Pipe fork registry — one entry per pipe use.
      * Maps the fork's trunk key to the originating handle name and the base
@@ -73,6 +79,11 @@ export type Bridge = {
             instance?: number;
         };
     }>;
+    /**
+     * When set, this bridge was declared with the passthrough shorthand:
+     * `bridge Type.field with <name>`. The value is the define/tool name.
+     */
+    passthrough?: string;
 };
 /**
  * A handle binding — declares a named data source available in a bridge.
@@ -86,12 +97,19 @@ export type HandleBinding = {
 } | {
     handle: string;
     kind: "input";
+} | {
+    handle: string;
+    kind: "output";
 } | {
     handle: string;
     kind: "context";
 } | {
     handle: string;
     kind: "const";
+} | {
+    handle: string;
+    kind: "define";
+    name: string;
 };
 /** Internal module identifier for the bridge's own trunk (input args + output fields) */
 export declare const SELF_MODULE = "_";
@@ -203,7 +221,36 @@ export type ConstDef = {
     value: string;
 };
 /** Union of all instruction types */
-export type Instruction = Bridge | ToolDef | ConstDef;
+export type Instruction = Bridge | ToolDef | ConstDef | DefineDef;
+/**
+ * Define block — a reusable named subgraph (pipeline / macro).
+ *
+ * At parse time a define is stored as a template.  When a bridge declares
+ * `with <define> as <handle>`, the define's handles and wires are inlined
+ * into the bridge with namespaced identifiers for isolation.
+ *
+ * Example:
+ *   define secureProfile {
+ *     with userApi as api
+ *     with input as i
+ *     with output as o
+ *     api.id <- i.userId
+ *     o.name <- api.login
+ *   }
+ */
+export type DefineDef = {
+    kind: "define";
+    /** Define name — referenced in bridge `with` declarations */
+    name: string;
+    /** Declared handles (tools, input, output, etc.) */
+    handles: HandleBinding[];
+    /** Connection wires (same format as Bridge wires) */
+    wires: Wire[];
+    /** Array iterators (same as Bridge) */
+    arrayIterators?: Record<string, string>;
+    /** Pipe fork registry (same as Bridge) */
+    pipeHandles?: Bridge["pipeHandles"];
+};
 /**
  * Pluggable cache store for httpCall.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackables/bridge",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "Declarative dataflow for GraphQL",
   "main": "./build/index.js",
   "type": "module",
@@ -11,6 +11,7 @@
   "scripts": {
     "prepack": "tsc",
     "test": "node --import tsx/esm --test test/*.test.ts",
+    "e2e": "node --import tsx/esm --test e2e/e2e.test.ts",
     "semantic-release": "semantic-release -b main"
   },
   "repository": {