@t4h.framework/fs 0.6.0 → 0.7.0

package/.ai/skills/framework-fs/SKILL.md

@@ -24,10 +24,11 @@ Public exports live in `src/fs.ts`:
 ```typescript
 import {
   FileSystemClaim,
-  // file fan-out / fold — see the framework-fs-split skill
+  // file fan-out / fold / windows — see the framework-fs-split skill
   split, Split, FileSplitActivity, type FileSplitOptions,
-  join, FileJoinActivity, type FileJoinOptions,
-  ByteDelimiterScanner, type FileSplitDelimiter, type ByteRange,
+  join, FileJoinActivity, type FileJoinOptions, type FileJoinWhere,
+  read, FileReadActivity, type FileReadOptions,
+  ByteDelimiterScanner, type FileSplitDelimiter, type ByteRange, type ByteTrim,
 } from '@t4h.framework/fs'
 ```
 
@@ -61,7 +62,7 @@ export abstract class FileSystemClaim {
 |--------|---------|
 | `write(path, readable)` | Persist stream or buffer at `path`; return a `Binary` handle (metadata + `stream()`). |
 | `read(path)` | Load an existing file at `path`; return a `Binary` handle. |
-| `slice(binary, range, encoding?)` | A view over a byte range of an existing binary, **without copying data**. When `encoding` is set, the runtime hydrates the slice as a decoded string instead of a binary — this is how `split` children receive plain strings. |
+| `slice(binary, range, encoding?)` | A view over a byte range of an existing binary, **without copying data**. When `encoding` is set, the runtime hydrates the slice as a decoded string instead of a binary — this is how `split` children receive plain strings. Implementations must **compose ranges**: slicing a slice is relative to it, and the stored range is absolute against the underlying file. |
 
 All methods may return synchronously or as a `Promise`. Implementations choose storage layout; callers should only rely on the returned `Binary` API.
 
@@ -95,6 +96,10 @@ read the resulting `Binary` (e.g. `await res.body.json()` / `text()`). Your only
 responsibility is that the runtime **registers a provider** (below). See
 **Known consumers** for which package primitives to orchestrate.
 
+This package's own workflow-facing primitives are `split`, `join` and `read`
+(small byte windows — headers, trailers — hydrated into the workflow as a
+string, capped at 1 MiB). See the `framework-fs-split` skill.
+
 ---
 
 ## Runtime provider
@@ -117,7 +122,7 @@ These packages depend on `@t4h.framework/fs` and declare `FileSystemClaim`; read
 |---------|--------|
 | `@t4h.framework/http` | The HTTP activity persists response bodies to `fs` and returns them wrapped in a `Body` — you read them with `res.body.json()` / `text()`. |
 | `@t4h.framework/jsx` | Render activities write their output to `fs` and hand back a `Binary` you consume in the workflow. |
-| `@t4h.framework/fs` itself | `FileSplitActivity` persists the durable copy and slices it by ranges; `FileJoinActivity` streams batch results into a new file. See the `framework-fs-split` skill. |
+| `@t4h.framework/fs` itself | `FileSplitActivity` persists the durable copy and slices it by ranges; `FileJoinActivity` streams batch results into a new file; `FileReadActivity` slices (or streams, when the binary is not file-backed) a small window into a string. See the `framework-fs-split` skill. |
 
 Orchestrate these package primitives from your workflow; the `fs` write/read happens inside them.
 

package/.ai/skills/framework-fs-split/SKILL.md

@@ -1,20 +1,23 @@
 ---
 name: framework-fs-split
 description: >-
-  Guides correct use of `split` and `join` from @t4h.framework/fs: fanning one
-  large file out into a batch of workflows (one per byte-range slice) and
-  folding the batch results back into a single file — with O(1) parent history
-  and bounded memory regardless of file size. Use whenever a workflow must
-  process a large file record by record — positional files, plain-text lines,
-  NDJSON, batch imports, per-record fan-out with an aggregated output (e.g. a
-  CSV report) — or when the user mentions splitting/chunking a file, running a
-  workflow per line/record, waiting for a batch, collecting batch results, or
-  the symbols `split`, `join`, `Split`, `FileSplitActivity`,
-  `FileJoinActivity`, `WorkflowBatchRef`, `WorkflowBatchClaim`. Prefer this
-  skill over hand-rolling stream loops + `startWorkflow` calls.
+  Guides correct use of `split`, `join` and `read` from @t4h.framework/fs:
+  fanning one large file out into a batch of workflows (one per byte-range
+  slice), folding the batch results back into a single file, and reading small
+  byte windows (headers, trailers) into the workflow — with O(1) parent
+  history and bounded memory regardless of file size. Use whenever a workflow
+  must process a large file record by record — positional files with
+  header/trailer, plain-text lines, NDJSON, batch imports, per-record fan-out
+  with an aggregated output (e.g. a CSV report) — or when the user mentions
+  splitting/chunking a file, trimming a header/trailer, reading a file header,
+  filtering batch results, running a workflow per line/record, waiting for a
+  batch, collecting batch results, or the symbols `split`, `join`, `read`,
+  `Split`, `FileSplitActivity`, `FileJoinActivity`, `FileReadActivity`,
+  `WorkflowBatchRef`, `WorkflowBatchClaim`. Prefer this skill over
+  hand-rolling stream loops + `startWorkflow` calls.
 ---
 
-# `split` / `join` — file fan-out and fold for workflows
+# `split` / `join` / `read` — file fan-out, fold and windows for workflows
 
 `split` turns **one file into a batch of workflows**: it streams the file once,
 cuts it into **byte-range slices** (never copying slice content), starts one
@@ -23,7 +26,7 @@ terminal**. `join` is the inverse: it folds the batch results back into a
 single file, streaming one result at a time.
 
 ```typescript
-import { split, join, Split } from '@t4h.framework/fs'
+import { read, split, join, Split } from '@t4h.framework/fs'
 
 const processRecord = new Workflow(
   { id: 'process-record', schema: Type.String() },
@@ -34,9 +37,13 @@ const processRecord = new Workflow(
 )
 
 const main = new Workflow(fileSchema, async (file: Binary) => {
+  const header = await read(file, { range: { start: 0, end: 240 } })
+  // header: string — recorded in history, never re-read on replay
+
   const batch = await split(file, processRecord, {
     delimiter: Split.char('\n10', { next: 2 }),
-    timeout: 3_600_000,
+    trim: { start: 241, end: 241 }, // header/trailer stay out of the batch
+    timeoutInMs: 3_600_000,
   })
   // this line only runs once the WHOLE batch is terminal;
   // batch: WorkflowBatchRef — { id: string, count: number }
@@ -128,9 +135,10 @@ multi-byte encodings cannot skew the ranges a ranged download will use.
 | Option | Default | Behavior |
 |--------|---------|----------|
 | `every` | `1` | Cut only every N delimiter occurrences — groups N records per child. One million lines with `every: 10_000` start 100 children, each receiving a raw block (inner delimiters untouched) to iterate locally. `keep` arithmetic applies only at actual cut points. |
+| `trim` | none | `{ start?, end? }` **bytes** cut off each end of the file before scanning — a positional header/trailer. Byte-based on purpose: a record-start delimiter (`'\n10'`) fuses the trailer into the last record's slice, so a record-count skip would drop a valid record along with it. Trimmed content never becomes a slice nor counts toward `every`; fetch it with `read`. Positional layouts make the byte counts constants — getting them right is the caller's business. |
 | `skipEmpty` | `true` | Drops zero-length slices (consecutive delimiters, file starting/ending with one) so they never become child workflows. Turn off when slice index must align 1:1 with record position. "Empty" means zero bytes — a whitespace-only line is a regular slice. |
 | `encoding` | `'utf8'` | Converts the delimiter to bytes and tells the runtime how to hydrate each slice for the child (string when set on the slice). |
-| `timeout` | none | Max milliseconds to await the batch; on expiry the activity **rejects** (reason `timeout`) instead of suspending forever — the safety net for a child that never reaches a terminal state. |
+| `timeoutInMs` | none | Max milliseconds to await the batch; on expiry the activity **rejects** (reason `timeout`) instead of suspending forever — the safety net for a child that never reaches a terminal state. |
 
 ---
 
@@ -150,7 +158,7 @@ Formats (content is the **child's** job — the child returns the final line;
 |--------|----------|
 | `lines` | Concatenates raw child outputs, one per line. Options: `header`, `separator` (default `'\n'`). Non-string outputs are JSON-stringified. |
 | `entries` | NDJSON dump of `{ index, status, output }`, one per line — the format-agnostic view of the batch, rejected children included by default. |
-| `csv` | Projects object outputs into RFC 4180 escaped columns. Options: `columns` (required; entries are `{ key, header? }` — `key` selects the value on the child output, `header` labels the header row, plain string is shorthand for `{ key }`), `delimiter` (default `','`), `header` (default `true`). Missing keys become empty cells; nested values are JSON inside the cell. Value *formatting* belongs in the child workflow (sandboxed user code); the join only owns layout. |
+| `csv` | Projects object outputs into RFC 4180 escaped columns. Options: `columns` (required; entries are `{ key, header? }` — `key` selects the value on the child output (a dot-path like `'meta.total'` reaches nested fields, matching the `where` semantics; a literal top-level key with dots wins over the nested path), `header` labels the header row, plain string is shorthand for `{ key }`), `delimiter` (default `','`), `header` (default `true`). Missing keys become empty cells; nested values selected whole are JSON inside the cell. Value *formatting* belongs in the child workflow (sandboxed user code); the join only owns layout. |
 
 **Status filter** (`status?: ('fulfilled' | 'rejected')[]`) selects which
 results make it into the file — there is no error policy. Defaults:
@@ -161,14 +169,92 @@ design; a reprocessing file of failures is one call away:
 const failures = await join(batch, { format: 'entries', status: ['rejected'] })
 ```
 
+**Where filter** (`where?`) narrows results with a **sift (MongoDB-style)
+query** over each entry's output, applied after `status`. Whitelisted subset
+only — declarative, JSON-only operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`,
+`$gte`, `$in`, `$nin`, `$exists`, `$not`, `$and`, `$or`, `$nor`, plus plain
+equality and dot-paths for nested fields. Pass the child output type as a
+generic to narrow top-level keys/values (dot-paths accepted, not narrowed):
+
+```typescript
+const relevant = await join<InvoiceResult>(batch, {
+  format: 'csv',
+  columns: ['id', 'total'],
+  where: { valid: true, total: { $gt: 100 }, 'meta.situacao': 'aprovada' },
+})
+```
+
+Non-serializable filters are rejected eagerly at `toInput` (`TypeError`):
+functions (incl. `$where`), `RegExp` (incl. `$regex`), `undefined`, operators
+outside the subset — a dropped closure would make the replay filter
+differently than the first execution. Arbitrary predicates belong in a custom
+activity in project code (the function then lives in versioned code).
+MongoDB semantics apply: array fields match by containment (`{ tags: 'a' }`
+matches `['a', 'b']`), object values compare deeply, no type coercion. The
+query compiles once and runs inside the existing streaming loop over
+already-hydrated outputs — same memory profile; app-side (decides what enters
+the file, not what leaves the database).
+
+---
+
+## `read`
+
+```typescript
+async function read(
+  binary: Binary,
+  options?: { range?: { start: number; end: number }; encoding?: BufferEncoding },
+): Promise<string>
+```
+
+Reads a byte window of a `Binary` into the workflow as a decoded string. The
+output is recorded in history (replay never re-reads the file), so reads are
+**capped at 1 MiB** — this is the primitive for headers, trailers and single
+records; a data file flows through `split`, never through `read`. `range`
+defaults to the whole binary (same cap applies); `encoding` defaults to
+`'utf8'`.
+
+Two paths under the hood:
+
+1. **Fast path** — `FileSystemClaim.slice`: on a file-backed binary a trailer
+   read is a ranged download, whatever the file size.
+2. **Streaming fallback** — binaries the claim cannot slice (e.g. an SFTP
+   reference): the stream is consumed up to the window and destroyed as soon
+   as it is filled. A header read pulls the first chunks only, whatever the
+   file size; a **trailing window over a non-sliceable binary** is the one
+   expensive case — the stream traverses the whole file to reach it.
+
+Reading a slice is **relative to the slice** (`range: { start: 0, end: 10 }`
+returns its first 10 bytes, not the underlying file's) — slice ranges compose.
+
+The positional-file recipe — header/trailer in the parent, records in the
+batch:
+
+```typescript
+const header = await read(file, { range: { start: 0, end: HEADER } })
+const trailer = await read(file, {
+  range: { start: file.contentLength - TRAILER, end: file.contentLength },
+})
+
+const batch = await split(file, processInvoice, {
+  delimiter: Split.char('\n10', { next: 2 }),
+  trim: { start: HEADER + 1, end: TRAILER + 1 }, // +1: boundary newlines
+})
+
+// e.g. validate the trailer's record count against batch.count
+```
+
 ---
 
 ## Runtime requirements
 
 - Claim providers: `FileSystemClaim` (with `slice`), `WorkflowClaim` (with
   `startMany`), and `WorkflowBatchClaim` (from `@t4h.framework/core`).
-- Production whitelist: `FileSplitActivity`, `FileJoinActivity` and core's
-  `StartManyWorkflowsActivity` must be registered via `runtime.addActivity`.
+- Production whitelist: `FileSplitActivity`, `FileJoinActivity`,
+  `FileReadActivity` and core's `StartManyWorkflowsActivity` must be
+  registered via `runtime.addActivity`.
+- `FileSystemClaim.slice` implementations must **compose ranges** when slicing
+  an already-sliced binary (relative in, absolute against the underlying file
+  out) — `read` and slice consumers rely on that semantics.
 - `FileSplitActivity` is an **AsyncActivity**: the heavy work happens in
   `bootstrap`, executed worker side atomically with the pending suspension —
   children cannot finish before the parent is awaiting them.
@@ -240,6 +326,15 @@ CSV escaping (quotes doubled, delimiter/newline wrapped); the status filter.
   intact (hash it, upload it), pass the `Binary` through.
 - **Forgetting `keep` on positional delimiters.** `Split.char('\n10')` without
   `{ next: 2 }` silently discards the record type code from every slice.
+- **Splitting a positional file without `trim`.** The header rides inside the
+  first slice (with `every: N` it silently consumes a record slot) and the
+  trailer fuses into the last one. Trim both ends; fetch them with `read`.
+- **Reading a data file with `read`.** The output lands in workflow history;
+  the 1 MiB cap is a guard, not a target. Records flow through `split`.
+- **Passing a function as a join filter.** Options serialize into history — a
+  closure cannot survive it, so `toInput` rejects functions, `$where`,
+  `RegExp` and out-of-subset operators with a `TypeError`. Use the `where`
+  sift subset or a custom activity whose predicate lives in versioned code.
 - **Hand-rolling the loop.** A stream-and-`startWorkflow` loop inside an
   activity re-parses on replay, misses the barrier, and pushes N entries into
   history.

package/README.md

@@ -1,7 +1,10 @@
 # @t4h.framework/fs
 
-File system claim for reading and writing files within activities, and a file
-split activity that fans a large file out into one child workflow per slice.
+File system claim for reading and writing files within activities, plus the
+workflow-facing file activities: `split` fans a large file out into one child
+workflow per slice, `join` folds the batch results back into a single file,
+and `read` brings a small byte window (a header, a trailer) into the workflow
+as a string.
 
 ## Claim
 
@@ -69,6 +72,41 @@ The runtime must supply a concrete implementation:
 { provide: FileSystemClaim, value: new LocalFileSystemClaimImpl() }
 ```
 
+## File read
+
+### read
+
+Reads a byte window of a `Binary` into the workflow as a decoded string. The
+output is recorded in the workflow history (replay never re-reads the file),
+which is why reads are capped at 1 MiB: this is the primitive for headers,
+trailers and single records — a data file flows through `split`, never through
+`read`.
+
+```typescript
+import { read } from '@t4h.framework/fs'
+
+const header = await read(file, { range: { start: 0, end: 240 } })
+
+const trailer = await read(file, {
+  range: { start: file.contentLength - 240, end: file.contentLength },
+})
+```
+
+Options: `range` (default: the whole binary, subject to the same cap) and
+`encoding` (default `'utf8'`).
+
+The activity tries `FileSystemClaim.slice` first — on a file-backed binary a
+trailer read is a ranged download, whatever the file size. Binaries the claim
+cannot slice (e.g. an SFTP reference) fall back to streaming: the stream is
+consumed up to the window and destroyed as soon as it is filled, so a header
+read pulls the first chunks only, whatever the file size. The one expensive
+case is a trailing window over a non-sliceable binary — the stream must
+traverse the whole file to reach it.
+
+Reading a slice is relative to the slice: `read(slice, { range: { start: 0,
+end: 10 } })` returns the first 10 bytes of the slice, not of the underlying
+file — slice ranges compose.
+
 ## File split
 
 ### split
@@ -148,9 +186,10 @@ start of the next slice.
 await split(file, workflow, {
   delimiter: Split.line(), // required: where to cut
   every: 10_000, // cut only every N occurrences (groups records)
+  trim: { start: 241, end: 241 }, // bytes cut off each end before scanning
   skipEmpty: false, // keep zero-length slices (default: skipped)
   encoding: 'latin1', // delimiter bytes + slice hydration (default: utf8)
-  timeout: 3_600_000, // max ms to await the batch; rejects on expiry
+  timeoutInMs: 3_600_000, // max ms to await the batch; rejects on expiry
 })
 ```
 
@@ -158,6 +197,23 @@ await split(file, workflow, {
 10_000` starts 100 children instead of one million; each child receives a
   raw block with its inner delimiters untouched and iterates locally. `keep`
   arithmetic only applies at actual cut points.
+- **`trim`** cuts a fixed number of bytes off each end of the file before
+  scanning — a positional header/trailer, which may not be aligned with the
+  record delimiter (a record-start delimiter like `Split.char('\n10')` fuses
+  the trailer into the last record's slice, so counting records would drop a
+  valid one along with it). Trimmed content never becomes a slice nor counts
+  toward `every`; fetch it with `read`. Getting the byte counts right is the
+  caller's business — positional layouts make them constants:
+
+  ```typescript
+  const header = await read(file, { range: { start: 0, end: 240 } })
+
+  const batch = await split(file, processInvoice, {
+    delimiter: Split.char('\n10', { next: 2 }),
+    trim: { start: 241, end: 241 }, // header + '\n', trailer + '\n'
+  })
+  ```
+
 - **`skipEmpty`** (default `true`) drops zero-length slices — consecutive
   delimiters, or a file starting/ending with one — so they never become child
   workflows. Turn it off when the slice index must align 1:1 with the record
@@ -166,7 +222,7 @@ await split(file, workflow, {
 - **`encoding`** converts the delimiter to bytes and tells the runtime how to
   hydrate each slice for the child. Offsets are always computed over raw
   bytes, so multi-byte encodings never skew the ranges.
-- **`timeout`** is the maximum time in milliseconds to await the batch. On
+- **`timeoutInMs`** is the maximum time in milliseconds to await the batch. On
   expiry the activity rejects (reason `timeout`) instead of suspending
   forever — the safety net for a child that never reaches a terminal state.
 
@@ -203,9 +259,12 @@ const csv = await join(batch, {
   default.
 - **`csv`** — projects object outputs into RFC 4180 escaped columns. Options:
   `columns` (required; each entry is `{ key, header? }` where `key` selects
-  the value on the child output and `header` is the label on the header row —
-  a plain string is shorthand for `{ key }`), `delimiter` (default `','`),
-  `header` (default `true`; emits the column labels as the first row).
+  the value on the child output — a dot-path like `'meta.total'` reaches
+  nested fields, matching the `where` semantics; a literal top-level key that
+  contains dots wins over the nested path — and `header` is the label on the
+  header row — a plain string is shorthand for `{ key }`), `delimiter`
+  (default `','`), `header` (default `true`; emits the column labels as the
+  first row).
 
 ### Status filter
 
@@ -218,6 +277,60 @@ rejected children for reprocessing is one call away:
 const failures = await join(batch, { format: 'entries', status: ['rejected'] })
 ```
 
+### Where filter
+
+`where` narrows results with a [sift](https://github.com/crcn/sift.js)
+(MongoDB-style) query over each entry's output, applied after the `status`
+filter. The accepted subset is deliberate — only declarative, JSON-only
+operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$nin`,
+`$exists`, `$not`, `$and`, `$or`, `$nor`, plus plain equality and dot-paths
+for nested fields:
+
+```typescript
+const relevant = await join(batch, {
+  format: 'csv',
+  columns: ['id', 'total'],
+  where: {
+    valid: true, // plain strict equality
+    total: { $gt: 100 }, // operators
+    'meta.situacao': 'aprovada', // dot-path into nested output
+    $or: [{ ref: 'a' }, { ref: 'b' }],
+  },
+})
+```
+
+`join` also accepts the child output type as a generic — top-level keys then
+narrow to its fields, with values typed by the field (dot-paths are accepted
+without narrowing):
+
+```typescript
+type InvoiceResult = { id: string; valid: boolean; total: number }
+
+await join<InvoiceResult>(batch, {
+  format: 'csv',
+  columns: ['id'],
+  where: { valid: true, total: { $gt: 100 } }, // { valid: 'yes' } rejects
+})
+```
+
+Anything that cannot serialize losslessly into the workflow history is
+rejected eagerly at `toInput` with a `TypeError`: functions (including
+`$where`), `RegExp` values (including `$regex`), `undefined`, and operators
+outside the subset — a dropped closure would make the replay filter
+differently than the first execution. For arbitrary predicates, write a
+custom activity in project code (the function then lives in versioned code,
+not in history).
+
+Two MongoDB semantics worth knowing: array fields match by containment
+(`{ tags: 'a' }` matches `tags: ['a', 'b']`), and equality against an object
+value compares deeply (never by reference). Comparisons never coerce types.
+
+Filtering runs inside the existing streaming loop, over outputs that are
+already hydrated one at a time — the query compiles once and adds one
+predicate call per entry, no extra serialization and no change to the memory
+profile. It is applied app-side: every child output is still fetched and
+parsed; `where` decides what enters the file, not what leaves the database.
+
 ### ByteDelimiterScanner
 
 The scanner behind `split` is exported for direct use. It is a pass-through

package/dist/activities/FileJoinActivity.d.ts

@@ -1,27 +1,47 @@
-import { type Binary, SyncActivity, type WorkflowBatchRef } from '@t4h.framework/core';
+import { type Binary, type Serializable, SyncActivity, type WorkflowBatchRef } from '@t4h.framework/core';
+import { CSV } from '../helpers/CSV.js';
 export type FileJoinStatus = 'fulfilled' | 'rejected';
-type FileJoinOptionsBase = {
+type FileJoinWhereOperators<TValue> = {
+    $eq?: TValue;
+    $ne?: TValue;
+    $lt?: TValue;
+    $lte?: TValue;
+    $gt?: TValue;
+    $gte?: TValue;
+    $in?: TValue[];
+    $nin?: TValue[];
+    $exists?: boolean;
+    $not?: FileJoinWhereCondition<TValue>;
+};
+type FileJoinWhereCondition<TValue> = TValue | FileJoinWhereOperators<TValue>;
+export type FileJoinWhere<TOutput = unknown> = ([TOutput] extends [object] ? {
+    [K in keyof TOutput]?: FileJoinWhereCondition<Exclude<TOutput[K], undefined>>;
+} & {
+    [path: `${string}.${string}`]: Serializable;
+} : Record<string, Serializable>) & {
+    $and?: FileJoinWhere<TOutput>[];
+    $or?: FileJoinWhere<TOutput>[];
+    $nor?: FileJoinWhere<TOutput>[];
+};
+type FileJoinOptionsBase<TOutput> = {
     status?: FileJoinStatus[];
+    where?: FileJoinWhere<TOutput>;
 };
-type FileJoinOptionsLines = FileJoinOptionsBase & {
+type FileJoinOptionsLines<TOutput> = FileJoinOptionsBase<TOutput> & {
     format: 'lines';
     header?: string;
     separator?: string;
 };
-type FileJoinOptionsEntries = FileJoinOptionsBase & {
+type FileJoinOptionsEntries<TOutput> = FileJoinOptionsBase<TOutput> & {
     format: 'entries';
 };
-export type FileJoinColumn = string | {
-    key: string;
-    header?: string;
-};
-type FileJoinOptionsCsv = FileJoinOptionsBase & {
+type FileJoinOptionsCsv<TOutput> = FileJoinOptionsBase<TOutput> & {
     format: 'csv';
-    columns: FileJoinColumn[];
+    columns: CSV.Column[];
     delimiter?: string;
     header?: boolean;
 };
-export type FileJoinOptions = FileJoinOptionsLines | FileJoinOptionsEntries | FileJoinOptionsCsv;
+export type FileJoinOptions<TOutput = unknown> = FileJoinOptionsLines<TOutput> | FileJoinOptionsEntries<TOutput> | FileJoinOptionsCsv<TOutput>;
 export type FileJoinActivityInput = {
     batch: string;
     options: FileJoinOptions;
@@ -34,6 +54,6 @@ export declare class FileJoinActivity extends SyncActivity<readonly [batch: Work
     private writeHeader;
     private toLine;
 }
-export declare function join(batch: WorkflowBatchRef, options: FileJoinOptions): Promise<Binary>;
+export declare function join<TOutput = unknown>(batch: WorkflowBatchRef, options: FileJoinOptions<TOutput>): Promise<Binary>;
 export {};
 //# sourceMappingURL=FileJoinActivity.d.ts.map

package/dist/activities/FileJoinActivity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileJoinActivity.d.ts","sourceRoot":"","sources":["../../src/activities/FileJoinActivity.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,MAAM,EAGX,YAAY,EAGZ,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAA;AAI5B,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,CAAA;AAErD,KAAK,mBAAmB,GAAG;IACzB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;CAC1B,CAAA;AAED,KAAK,oBAAoB,GAAG,mBAAmB,GAAG;IAChD,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,KAAK,sBAAsB,GAAG,mBAAmB,GAAG;IAClD,MAAM,EAAE,SAAS,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GACtB,MAAM,GACN;IACE,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAEL,KAAK,kBAAkB,GAAG,mBAAmB,GAAG;IAC9C,MAAM,EAAE,KAAK,CAAA;IACb,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,CAAA;AAEtB,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,eAAe,CAAA;CACzB,CAAA;AAgCD,qBAAa,gBAAiB,SAAQ,YAAY,CAChD,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,CAAC,EAC5D,qBAAqB,EACrB,MAAM,EACN,MAAM,CACP;IACC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGrB;IAEK,OAAO,CACZ,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,eAAe,GACvB,qBAAqB;IAIX,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCrE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;YAIzB,WAAW;IAkBzB,OAAO,CAAC,MAAM;CAsBf;AAED,wBAAsB,IAAI,CACxB,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAEjB"}
+{"version":3,"file":"FileJoinActivity.d.ts","sourceRoot":"","sources":["../../src/activities/FileJoinActivity.ts"],"names":[],"mappings":"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"}

package/dist/activities/FileJoinActivity.js

@@ -1,35 +1,24 @@
 import { once } from 'node:events';
 import { PassThrough } from 'node:stream';
 import { Claim, History, SyncActivity, WorkflowBatchClaim, } from '@t4h.framework/core';
+import sift from 'sift';
+import { OPERATIONS } from '../constants/operations.js';
 import { FileSystemClaim } from '../FileSystemClaim.js';
+import { CSV } from '../helpers/CSV.js';
+import { assertWhereSerializable } from '../tools/assert-where-serializable.js';
 const extensions = {
     lines: 'txt',
     entries: 'ndjson',
     csv: 'csv',
 };
-function columnKey(column) {
-    return typeof column === 'string' ? column : column.key;
-}
-function columnHeader(column) {
-    return typeof column === 'string' ? column : (column.header ?? column.key);
-}
-function csvEscape(value, delimiter) {
-    if (value === null || typeof value === 'undefined')
-        return '';
-    const text = typeof value === 'object' ? JSON.stringify(value) : String(value);
-    if (text.includes(delimiter) ||
-        text.includes('"') ||
-        text.includes('\n') ||
-        text.includes('\r'))
-        return `"${text.replaceAll('"', '""')}"`;
-    return text;
-}
 export class FileJoinActivity extends SyncActivity {
     claims = new Claim({
         fs: FileSystemClaim,
         batch: WorkflowBatchClaim,
     });
     toInput(batch, options) {
+        if (options.where)
+            assertWhereSerializable(options.where, 'where');
         return { batch: batch.id, options };
     }
     async run({ batch, options }) {
@@ -39,14 +28,19 @@ export class FileJoinActivity extends SyncActivity {
             if (!stream.write(line))
                 await once(stream, 'drain');
         };
-        const statuses = new Set(options.status ??
-            (options.format === 'entries'
-                ? ['fulfilled', 'rejected']
-                : ['fulfilled']));
+        const statuses = new Set(options.status ?? ['fulfilled']);
+        if (!options.status && options.format === 'entries')
+            statuses.add('rejected');
+        const matches = options.where &&
+            sift.createQueryTester(options.where, {
+                operations: OPERATIONS,
+            });
         await this.writeHeader(options, write);
         for await (const entry of this.claims.batch.outputs(batch)) {
             if (!statuses.has(entry.status))
                 continue;
+            if (matches && !matches(entry.output))
+                continue;
             await write(this.toLine(entry, options));
         }
         stream.end();
@@ -58,23 +52,16 @@ export class FileJoinActivity extends SyncActivity {
     async writeHeader(options, write) {
         if (options.format === 'lines' && options.header)
             await write(options.header + (options.separator ?? '\n'));
-        if (options.format === 'csv' && options.header !== false) {
-            const delimiter = options.delimiter ?? ',';
-            await write(options.columns
-                .map(column => csvEscape(columnHeader(column), delimiter))
-                .join(delimiter) + '\n');
-        }
+        if (options.format === 'csv' && options.header !== false)
+            await write(CSV.toHeader(options.columns, { delimiter: options.delimiter }));
     }
     toLine(entry, options) {
         if (options.format === 'entries')
             return JSON.stringify(entry) + '\n';
-        if (options.format === 'csv') {
-            const delimiter = options.delimiter ?? ',';
-            const output = (entry.output ?? {});
-            return (options.columns
-                .map(column => csvEscape(output[columnKey(column)], delimiter))
-                .join(delimiter) + '\n');
-        }
+        if (options.format === 'csv')
+            return CSV.toLine(entry.output, options.columns, {
+                delimiter: options.delimiter,
+            });
         const value = typeof entry.output === 'string'
             ? entry.output
             : JSON.stringify(entry.output);

package/dist/activities/FileJoinActivity.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileJoinActivity.js","sourceRoot":"","sources":["../../src/activities/FileJoinActivity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FileJoinActivity.js","sourceRoot":"","sources":["../../src/activities/FileJoinActivity.ts"],"names":[],"mappings":"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"}

package/dist/activities/FileReadActivity.d.ts

@@ -0,0 +1,22 @@
+import { type Binary, SyncActivity } from '@t4h.framework/core';
+export type FileReadOptions = {
+    range?: {
+        start: number;
+        end: number;
+    };
+    encoding?: BufferEncoding;
+};
+export type FileReadActivityInput = {
+    binary: Binary;
+    options: FileReadOptions;
+};
+export declare class FileReadActivity extends SyncActivity<readonly [binary: Binary, options: FileReadOptions], FileReadActivityInput, string, string> {
+    private readonly claims;
+    toInput(binary: Binary, options: FileReadOptions): FileReadActivityInput;
+    run({ binary, options, }: FileReadActivityInput): Promise<string>;
+    toOutput(output: string): string;
+    private slice;
+    private window;
+}
+export declare function read(binary: Binary, options?: FileReadOptions): Promise<string>;
+//# sourceMappingURL=FileReadActivity.d.ts.map

package/dist/activities/FileReadActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileReadActivity.d.ts","sourceRoot":"","sources":["../../src/activities/FileReadActivity.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAkB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAI/E,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,eAAe,CAAA;CACzB,CAAA;AAID,qBAAa,gBAAiB,SAAQ,YAAY,CAChD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,EACnD,qBAAqB,EACrB,MAAM,EACN,MAAM,CACP;IACC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IAEK,OAAO,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,qBAAqB;IAIX,GAAG,CAAC,EACf,MAAM,EACN,OAAO,GACR,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;YAIzB,KAAK;YAYL,MAAM;CAuCrB;AAED,wBAAsB,IAAI,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAEjB"}