deepline 0.1.55 → 0.1.56

package/dist/repo/shared_libs/plays/dataset.ts

@@ -55,14 +55,34 @@ export type PlayDatasetInput<T> =
   | AsyncIterable<T>
   | PlayDataset<T>;
 
+/**
+ * Durable handle for rows produced by `ctx.csv(...)` or `ctx.map(...).run()`.
+ *
+ * A `PlayDataset` is not a normal in-memory array. It points at runtime-managed
+ * rows, usually backed by persisted sheet storage, and carries metadata such as
+ * dataset kind, dataset id, table namespace, count, and preview rows.
+ *
+ * Pass dataset handles directly into later `ctx.map(...)` stages by default so
+ * Deepline keeps row progress, retries, memory use, and table output under
+ * runtime control. Use `count()` and `peek()` for bounded inspection. Use
+ * `materialize(limit)` or async iteration only when the dataset is intentionally
+ * small and bounded.
+ */
 export interface PlayDataset<T> extends AsyncIterable<T> {
   readonly [PLAY_DATASET_BRAND]: true;
+  /** Dataset kind. */
   readonly datasetKind: PlayDatasetKind;
+  /** Dataset id. */
   readonly datasetId: string;
+  /** Backing store info. */
   readonly backing?: PlayDatasetBacking;
+  /** Display label. */
   readonly sourceLabel?: string | null;
+  /** Runtime table name. */
   readonly tableNamespace?: string | null;
+  /** Row count. */
   count(): Promise<number>;
+  /** Preview rows. */
   peek(limit?: number): Promise<T[]>;
   /**
    * Explicit escape hatch for bounded result sets.
@@ -310,7 +330,11 @@ export async function materializePlayDatasetInput<T>(
   input: PlayDatasetInput<T>,
 ): Promise<T[]> {
   if (isPlayDataset(input)) {
-    return await input.materialize();
+    const rows: T[] = [];
+    for await (const row of input) {
+      rows.push(row);
+    }
+    return rows;
   }
 
   if (Array.isArray(input)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.55",
+  "version": "0.1.56",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {