@codemation/node-example 0.0.27 → 0.0.29

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @codemation/node-example
 
+## 0.0.29
+
+### Patch Changes
+
+- Updated dependencies [[`88844f7`](https://github.com/MadeRelevant/codemation/commit/88844f75a48fe051e4cb895c710408855de14da4)]:
+  - @codemation/core@0.7.0
+
+## 0.0.28
+
+### Patch Changes
+
+- Updated dependencies [[`3044e73`](https://github.com/MadeRelevant/codemation/commit/3044e73fd3cfb33f8e2cbc579c10baf97ed94658), [`418434a`](https://github.com/MadeRelevant/codemation/commit/418434a6a2ad88a6254a94cb70e6f14b886df348), [`3774fd8`](https://github.com/MadeRelevant/codemation/commit/3774fd80bc357c7eb39957f6963c692f322c38eb), [`00bc135`](https://github.com/MadeRelevant/codemation/commit/00bc1351e2dd6222d5101dbff3602a76ead33ce1)]:
+  - @codemation/core@0.6.0
+
 ## 0.0.27
 
 ### Patch Changes

package/dist/index.d.cts

@@ -129,8 +129,10 @@ interface NodeExecutionContext<TConfig extends NodeConfigBase = NodeConfigBase>
   binary: NodeBinaryAttachmentService;
 }
 /**
- * Per-item runnable node: return JSON, an array to fan-out on `main`, or {@link emitPorts} for multi-port emission.
- * Engine applies `inputSchema.parse(item.json)` and passes the result as `args.input` (wire `item.json` is unchanged).
+ * Per-item runnable node: return JSON, an array to fan-out on `main`, an explicit `Item`, or {@link emitPorts}
+ * for multi-port emission. Engine applies `inputSchema.parse(item.json)` and passes the result as `args.input`
+ * (wire `item.json` is unchanged). Transform helpers may opt into binary preservation, while routers and
+ * pass-through nodes should return explicit items when they need to preserve full item state.
  */
 interface RunnableNodeExecuteArgs<TConfig extends RunnableNodeConfig<any, any> = RunnableNodeConfig<any, any>, TInputJson$1 = unknown> {
   readonly input: TInputJson$1;
@@ -156,6 +158,9 @@ interface RunnableNode<TConfig extends RunnableNodeConfig<any, any> = RunnableNo
 //#region ../core/src/contracts/workflowTypes.d.ts
 type WorkflowId = string;
 type NodeId = string;
+type NodeIdRef<TJson = unknown> = NodeId & Readonly<{
+  __codemationNodeJson?: TJson;
+}>;
 type OutputPortKey = string;
 type InputPortKey = string;
 type NodeKind = "trigger" | "node";
@@ -195,7 +200,6 @@ interface NodeConfigBase {
 }
 declare const runnableNodeInputType: unique symbol;
 declare const runnableNodeOutputType: unique symbol;
-type LineageCarryPolicy = "emitOnly" | "carryThrough";
 /**
  * Runnable node: **`TInputJson`** is what **`inputSchema`** validates on **`item.json`** (the wire payload).
  * **`TOutputJson`** is emitted `item.json` on outputs.
@@ -209,11 +213,6 @@ interface RunnableNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> ex
    * Resolution order: node instance `inputSchema`, then config `inputSchema`, then `z.unknown()`.
    */
   readonly inputSchema?: ZodType<TInputJson$1>;
-  /**
-   * Overrides default lineage propagation for `execute` outputs (binary/meta/paired).
-   * Routers with multiple {@link RunnableNode#outputPorts} default to **`carryThrough`**; others default to **`emitOnly`**.
-   */
-  readonly lineageCarry?: LineageCarryPolicy;
   /**
    * When an activation receives **zero** input items, the engine normally runs `execute` zero times.
    * Set to **`runOnce`** to run `execute` once with an empty `items` batch (and a synthetic wire item for schema parsing).
@@ -266,8 +265,8 @@ interface ParentExecutionRef {
 }
 interface RunDataSnapshot {
   getOutputs(nodeId: NodeId): NodeOutputs | undefined;
-  getOutputItems(nodeId: NodeId, output?: OutputPortKey): Items;
-  getOutputItem(nodeId: NodeId, itemIndex: number, output?: OutputPortKey): Item | undefined;
+  getOutputItems<TJson = unknown>(nodeId: NodeId | NodeIdRef<TJson>, output?: OutputPortKey): Items<TJson>;
+  getOutputItem<TJson = unknown>(nodeId: NodeId | NodeIdRef<TJson>, itemIndex: number, output?: OutputPortKey): Item<TJson> | undefined;
 }
 interface NodeErrorHandlerArgs<TConfig extends NodeConfigBase = NodeConfigBase> {
   readonly kind: "single" | "multi";

package/dist/index.d.ts

@@ -129,8 +129,10 @@ interface NodeExecutionContext<TConfig extends NodeConfigBase = NodeConfigBase>
   binary: NodeBinaryAttachmentService;
 }
 /**
- * Per-item runnable node: return JSON, an array to fan-out on `main`, or {@link emitPorts} for multi-port emission.
- * Engine applies `inputSchema.parse(item.json)` and passes the result as `args.input` (wire `item.json` is unchanged).
+ * Per-item runnable node: return JSON, an array to fan-out on `main`, an explicit `Item`, or {@link emitPorts}
+ * for multi-port emission. Engine applies `inputSchema.parse(item.json)` and passes the result as `args.input`
+ * (wire `item.json` is unchanged). Transform helpers may opt into binary preservation, while routers and
+ * pass-through nodes should return explicit items when they need to preserve full item state.
  */
 interface RunnableNodeExecuteArgs<TConfig extends RunnableNodeConfig<any, any> = RunnableNodeConfig<any, any>, TInputJson$1 = unknown> {
   readonly input: TInputJson$1;
@@ -156,6 +158,9 @@ interface RunnableNode<TConfig extends RunnableNodeConfig<any, any> = RunnableNo
 //#region ../core/src/contracts/workflowTypes.d.ts
 type WorkflowId = string;
 type NodeId = string;
+type NodeIdRef<TJson = unknown> = NodeId & Readonly<{
+  __codemationNodeJson?: TJson;
+}>;
 type OutputPortKey = string;
 type InputPortKey = string;
 type NodeKind = "trigger" | "node";
@@ -195,7 +200,6 @@ interface NodeConfigBase {
 }
 declare const runnableNodeInputType: unique symbol;
 declare const runnableNodeOutputType: unique symbol;
-type LineageCarryPolicy = "emitOnly" | "carryThrough";
 /**
  * Runnable node: **`TInputJson`** is what **`inputSchema`** validates on **`item.json`** (the wire payload).
  * **`TOutputJson`** is emitted `item.json` on outputs.
@@ -209,11 +213,6 @@ interface RunnableNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> ex
    * Resolution order: node instance `inputSchema`, then config `inputSchema`, then `z.unknown()`.
    */
   readonly inputSchema?: ZodType<TInputJson$1>;
-  /**
-   * Overrides default lineage propagation for `execute` outputs (binary/meta/paired).
-   * Routers with multiple {@link RunnableNode#outputPorts} default to **`carryThrough`**; others default to **`emitOnly`**.
-   */
-  readonly lineageCarry?: LineageCarryPolicy;
   /**
    * When an activation receives **zero** input items, the engine normally runs `execute` zero times.
    * Set to **`runOnce`** to run `execute` once with an empty `items` batch (and a synthetic wire item for schema parsing).
@@ -266,8 +265,8 @@ interface ParentExecutionRef {
 }
 interface RunDataSnapshot {
   getOutputs(nodeId: NodeId): NodeOutputs | undefined;
-  getOutputItems(nodeId: NodeId, output?: OutputPortKey): Items;
-  getOutputItem(nodeId: NodeId, itemIndex: number, output?: OutputPortKey): Item | undefined;
+  getOutputItems<TJson = unknown>(nodeId: NodeId | NodeIdRef<TJson>, output?: OutputPortKey): Items<TJson>;
+  getOutputItem<TJson = unknown>(nodeId: NodeId | NodeIdRef<TJson>, itemIndex: number, output?: OutputPortKey): Item<TJson> | undefined;
 }
 interface NodeErrorHandlerArgs<TConfig extends NodeConfigBase = NodeConfigBase> {
   readonly kind: "single" | "multi";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemation/node-example",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "publishConfig": {
     "access": "public"
   },
@@ -28,7 +28,7 @@
     }
   },
   "dependencies": {
-    "@codemation/core": "0.5.0"
+    "@codemation/core": "0.7.0"
   },
   "devDependencies": {
     "@types/node": "^25.3.5",