@stackables/bridge 1.4.2 → 1.5.0

package/build/ExecutionTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionTree.d.ts","sourceRoot":"","sources":["../src/ExecutionTree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EAEN,WAAW,EACX,OAAO,EAGP,OAAO,EAER,MAAM,YAAY,CAAC;AAGpB,gFAAgF;AAChF,UAAU,IAAI;IACZ,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,KAAK,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAsChF,qBAAa,aAAa;IAQf,KAAK,EAAE,KAAK;IACnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,MAAM,CAAC;IAXjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,aAAa,CAAsE;gBAGlF,KAAK,EAAE,KAAK,EACX,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,CAAC,EAAE,OAAO,YAAA,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAA,EAC7B,MAAM,CAAC,EAAE,aAAa,YAAA;IA8BhC,oCAAoC;IACpC,OAAO,CAAC,WAAW;IAKnB;uGACmG;IACnG,OAAO,CAAC,YAAY;IAsBpB,oEAAoE;IACpE,OAAO,CAAC,oBAAoB;IA8D5B,mEAAmE;YACrD,gBAAgB;IA0B9B,2EAA2E;YAC7D,iBAAiB;IAgC/B,kDAAkD;IAClD,OAAO,CAAC,cAAc;IAgCtB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,GAAG;IAmF5B,MAAM,IAAI,aAAa;YAUT,UAAU;IA4BlB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAqCzC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI9B,6DAA6D;IAC7D,aAAa,IAAI,IAAI;IAqBrB;;oFAEgF;IAChF,OAAO,CAAC,YAAY;IA8Cd,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;CAsD1D"}
+{"version":3,"file":"ExecutionTree.d.ts","sourceRoot":"","sources":["../src/ExecutionTree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EAEN,WAAW,EACX,OAAO,EAGP,OAAO,EAER,MAAM,YAAY,CAAC;AAGpB,gFAAgF;AAChF,UAAU,IAAI;IACZ,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,KAAK,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAsChF,qBAAa,aAAa;IAQf,KAAK,EAAE,KAAK;IACnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,MAAM,CAAC;IAXjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,aAAa,CAAsE;gBAGlF,KAAK,EAAE,KAAK,EACX,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,CAAC,EAAE,OAAO,YAAA,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAA,EAC7B,MAAM,CAAC,EAAE,aAAa,YAAA;IA8BhC,oCAAoC;IACpC,OAAO,CAAC,WAAW;IAKnB;uGACmG;IACnG,OAAO,CAAC,YAAY;IAsBpB,oEAAoE;IACpE,OAAO,CAAC,oBAAoB;IA8D5B,mEAAmE;YACrD,gBAAgB;IA0B9B,2EAA2E;YAC7D,iBAAiB;IAyC/B,kDAAkD;IAClD,OAAO,CAAC,cAAc;IAgCtB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,GAAG;IA8F5B,MAAM,IAAI,aAAa;YAUT,UAAU;IAmClB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAqCzC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI9B,6DAA6D;IAC7D,aAAa,IAAI,IAAI;IAqBrB;;oFAEgF;IAChF,OAAO,CAAC,YAAY;IA8Cd,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;CA+E1D"}

package/build/ExecutionTree.js

@@ -186,10 +186,23 @@ export class ExecutionTree {
             throw new Error(`Unknown source "${handle}" in tool "${toolDef.name}"`);
         let value;
         if (dep.kind === "context") {
-            value = this.context ?? this.parent?.context;
+            // Walk the full parent chain for context
+            // eslint-disable-next-line @typescript-eslint/no-this-alias
+            let cursor = this;
+            while (cursor && value === undefined) {
+                value = cursor.context;
+                cursor = cursor.parent;
+            }
         }
         else if (dep.kind === "const") {
-            value = this.state[trunkKey({ module: SELF_MODULE, type: "Const", field: "const" })] ?? this.parent?.state[trunkKey({ module: SELF_MODULE, type: "Const", field: "const" })];
+            // Walk the full parent chain for const state
+            const constKey = trunkKey({ module: SELF_MODULE, type: "Const", field: "const" });
+            // eslint-disable-next-line @typescript-eslint/no-this-alias
+            let cursor = this;
+            while (cursor && value === undefined) {
+                value = cursor.state[constKey];
+                cursor = cursor.parent;
+            }
         }
         else if (dep.kind === "tool") {
             value = await this.resolveToolDep(dep.tool);
@@ -258,10 +271,23 @@ export class ExecutionTree {
             if (toolDef) {
                 await this.resolveToolWires(toolDef, input);
             }
-            // Resolve bridge wires and apply on top
-            const resolved = await Promise.all(bridgeWires.map(async (w) => {
-                const value = "value" in w ? w.value : await this.pullSingle(w.from);
-                return [w.to.path, value];
+            // Resolve bridge wires and apply on top.
+            // Group wires by target path so that || (null-fallback) and ??
+            // (error-fallback) semantics are honoured via resolveWires().
+            const wireGroups = new Map();
+            for (const w of bridgeWires) {
+                const key = w.to.path.join(".");
+                let group = wireGroups.get(key);
+                if (!group) {
+                    group = [];
+                    wireGroups.set(key, group);
+                }
+                group.push(w);
+            }
+            const groupEntries = Array.from(wireGroups.entries());
+            const resolved = await Promise.all(groupEntries.map(async ([, group]) => {
+                const value = await this.resolveWires(group);
+                return [group[0].to.path, value];
             }));
             for (const [path, value] of resolved) {
                 if (path.length === 0 && value != null && typeof value === "object") {
@@ -307,7 +333,14 @@ export class ExecutionTree {
     }
     async pullSingle(ref) {
         const key = trunkKey(ref);
-        let value = this.state[key] ?? this.parent?.state[key];
+        // Walk the full parent chain — shadow trees may be nested multiple levels
+        let value = undefined;
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        let cursor = this;
+        while (cursor && value === undefined) {
+            value = cursor.state[key];
+            cursor = cursor.parent;
+        }
         if (value === undefined) {
             this.state[key] = this.schedule(ref);
             value = this.state[key];
@@ -458,6 +491,30 @@ export class ExecutionTree {
                 return s;
             });
         }
+        // Fallback: if this shadow tree has stored element data, resolve the
+        // requested field directly from it. This handles passthrough arrays
+        // where the bridge maps an inner array (e.g. `.stops <- j.stops`) but
+        // doesn't explicitly wire each scalar field on the element type.
+        if (this.parent) {
+            const elementKey = trunkKey({ ...this.trunk, element: true });
+            const elementData = this.state[elementKey];
+            if (elementData != null && typeof elementData === "object" && !Array.isArray(elementData)) {
+                const fieldName = cleanPath[cleanPath.length - 1];
+                if (fieldName !== undefined && fieldName in elementData) {
+                    const value = elementData[fieldName];
+                    if (array && Array.isArray(value)) {
+                        // Nested array: wrap items in shadow trees so they can
+                        // resolve their own fields via this same fallback path.
+                        return value.map((item) => {
+                            const s = this.shadow();
+                            s.state[elementKey] = item;
+                            return s;
+                        });
+                    }
+                    return value;
+                }
+            }
+        }
         // Return self to trigger downstream resolvers
         return this;
     }

package/build/bridge-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-format.d.ts","sourceRoot":"","sources":["../src/bridge-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKR,WAAW,EAMd,MAAM,YAAY,CAAC;AA8CpB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CA0FvD;AAqwCD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAchD;AAID;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CA8BnE"}
+{"version":3,"file":"bridge-format.d.ts","sourceRoot":"","sources":["../src/bridge-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKR,WAAW,EAMd,MAAM,YAAY,CAAC;AA8CpB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CA0FvD;AAmxCD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAchD;AAID;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CA8BnE"}

package/build/bridge-format.js

@@ -409,6 +409,7 @@ function parseBridgeBlock(block, lineOffset, previousInstructions) {
             const [, targetStr, quotedValue, unquotedValue] = constantMatch;
             const value = quotedValue ?? unquotedValue;
             const toRef = resolveAddress(targetStr, handleRes, bridgeType, bridgeField, ln(i));
+            assertNoTargetIndices(toRef, ln(i));
             wires.push({ value, to: toRef });
             continue;
         }
@@ -427,6 +428,7 @@ function parseBridgeBlock(block, lineOffset, previousInstructions) {
                 assertNotReserved(iterHandle, ln(i), "iterator handle");
                 const fromRef = resolveAddress(fromClean, handleRes, bridgeType, bridgeField, ln(i));
                 const toRef = resolveAddress(targetStr, handleRes, bridgeType, bridgeField, ln(i));
+                assertNoTargetIndices(toRef, ln(i));
                 wires.push({ from: fromRef, to: toRef });
                 currentArrayToPath = toRef.path;
                 currentIterHandle = iterHandle;
@@ -469,6 +471,7 @@ function parseBridgeBlock(block, lineOffset, previousInstructions) {
                 fallbackInternalWires = wires.splice(preLen);
             }
             const toRef = resolveAddress(targetStr, handleRes, bridgeType, bridgeField, ln(i));
+            assertNoTargetIndices(toRef, ln(i));
             for (let ci = 0; ci < sourceParts.length; ci++) {
                 const isFirst = ci === 0;
                 const isLast = ci === sourceParts.length - 1;
@@ -927,6 +930,14 @@ function resolveAddress(address, handles, bridgeType, bridgeField, lineNum) {
     throw new Error(`${lineNum != null ? `Line ${lineNum}: ` : ""}Undeclared handle "${prefix}". ` +
         `Add 'with ${prefix}' or 'with ${prefix} as ${prefix}' to the bridge header.`);
 }
+/** Reject explicit array indices on the target (LHS) of a wire. */
+function assertNoTargetIndices(ref, lineNum) {
+    if (ref.path.some((seg) => /^\d+$/.test(seg))) {
+        throw new Error(`${lineNum != null ? `Line ${lineNum}: ` : ""}` +
+            `Explicit array index in wire target is not supported. ` +
+            `Use array mapping (\`[] as iter { }\`) instead.`);
+    }
+}
 // ── Const block parser ──────────────────────────────────────────────────────
 /**
  * Parse `const` declarations into ConstDef instructions.

package/build/bridge-transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-transform.d.ts","sourceRoot":"","sources":["../src/bridge-transform.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,EAAE,WAAW,EAAc,OAAO,EAAE,MAAM,YAAY,CAAC;AAGnE,MAAM,MAAM,aAAa,GAAG;IAC1B;;;kDAG8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;qEACiE;IACjE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvD,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GACzB,WAAW,EAAE,GACb,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,WAAW,EAAE,CAAC,CAAC;AAEtC,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,iBAAiB,EAC/B,OAAO,CAAC,EAAE,aAAa,GACtB,aAAa,CA0Ef"}
+{"version":3,"file":"bridge-transform.d.ts","sourceRoot":"","sources":["../src/bridge-transform.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,EAAE,WAAW,EAAc,OAAO,EAAE,MAAM,YAAY,CAAC;AAGnE,MAAM,MAAM,aAAa,GAAG;IAC1B;;;kDAG8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;qEACiE;IACjE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvD,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GACzB,WAAW,EAAE,GACb,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,WAAW,EAAE,CAAC,CAAC;AAEtC,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,iBAAiB,EAC/B,OAAO,CAAC,EAAE,aAAa,GACtB,aAAa,CA+Ef"}

package/build/bridge-transform.js

@@ -44,6 +44,11 @@ export function bridgeTransform(schema, instructions, options) {
                     }
                     // Kick off forced wires (<-!) at the root entry point
                     if (source instanceof ExecutionTree && !info.path.prev) {
+                        // Ensure input state exists even with no args (prevents
+                        // recursive scheduling of the input trunk → stack overflow).
+                        if (!args || Object.keys(args).length === 0) {
+                            source.push({});
+                        }
                         source.executeForced();
                     }
                     if (source instanceof ExecutionTree) {

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "@stackables/bridge",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "description": "Declarative dataflow for GraphQL",
   "main": "./build/index.js",
   "type": "module",
   "types": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "import": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
   "files": [
     "build",
     "README.md"