@t4h.framework/transforms 0.0.0-experimental-20260907052843

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

@@ -0,0 +1,123 @@
+---
+name: framework-transforms
+description: >-
+  Guides correct use of @t4h.framework/transforms in workflows: converting a
+  JSON document (an array of records, possibly nested inside an envelope) into
+  NDJSON so it can be fanned out with `split` from @t4h.framework/fs. Use
+  whenever a workflow receives a JSON batch file that is NOT NDJSON — an API
+  response or uploaded file shaped like `{ "a": { "b": [ ...records ] } }` —
+  and each record must become its own workflow run, or when the user mentions
+  converting JSON to NDJSON, splitting a JSON array, a records envelope, or
+  the symbols `json`, `Json`, `toNDJson`, `JsonToNDJsonActivity`. Prefer this
+  skill over parsing JSON in workflow code or hand-rolling delimiters over
+  JSON text.
+---
+
+# @t4h.framework/transforms
+
+Format conversions for workflow files. Package path:
+`framework/packages/transforms`. Peer dependencies: `@t4h.framework/core`,
+`@t4h.framework/fs`.
+
+## Import surface
+
+```typescript
+import { json, Json, JsonToNDJsonActivity } from '@t4h.framework/transforms'
+```
+
+`json(binary, options)` is the entry point: it captures the source document
+and returns a `Json` value whose `.toX()` methods run the actual transform —
+today `toNDJson()`, each future target (`toCsv`, ...) being one more method.
+Only the `.toX()` call does work; `json(...)` itself is synchronous and free.
+
+## Workflow usage
+
+The canonical pipeline — download a JSON batch file, normalize it to NDJSON,
+fan it out one workflow per record:
+
+```typescript
+import { split, Split } from '@t4h.framework/fs'
+import { request } from '@t4h.framework/http'
+import { json } from '@t4h.framework/transforms'
+
+const main = new Workflow(inputSchema, async ({ url }) => {
+  const response = await request({ url })
+
+  // { "registros": { "registro": [ {...}, {...} ] } }
+  const ndjson = await json(response.body.binary, {
+    path: 'registros.registro',
+  }).toNDJson()
+
+  return await split(ndjson, processRecord, { delimiter: Split.line() })
+})
+```
+
+Each child workflow receives one record as a raw JSON line (`Type.String()`
+input, `JSON.parse` it) — see the **framework-fs-split** skill for the
+`split`/`join` side.
+
+## `json(binary, options).toNDJson()`
+
+```typescript
+function json(binary: Binary, options?: JsonOptions): Json
+Json.prototype.toNDJson(): Promise<Binary>
+```
+
+`toNDJson()` rewrites the document as NDJSON — one line per element of the
+target array — and resolves with the `Binary` of the new file. Only that
+reference reaches workflow history; the content never does.
+
+| Option     | Default | Behavior                                                                                       |
+| ---------- | ------- | ---------------------------------------------------------------------------------------------- |
+| `path`     | —       | Dot path to the array of records (`'registros.registro'`). Omit when the document root is the array. |
+| `encoding` | `utf8`  | Encoding used to decode the source binary before parsing.                                      |
+
+Behaviors you can rely on:
+
+- **Formatting-agnostic.** Minified, pretty-printed, arbitrary whitespace and
+  BOM-prefixed documents all produce identical output. Values containing
+  `"},{"`, escaped quotes, or nested structures are preserved exactly —
+  records are re-serialized, never text-sliced.
+- **Any element type.** Array elements may be objects, arrays or scalars;
+  each becomes one `JSON.stringify`'d line. An empty array yields an empty
+  (zero-line) file, which `split` resolves as an empty batch.
+- **Fail-fast on shape mismatches.** `toNDJson()` rejects with a `TypeError`
+  when the `path` cannot be resolved or does not land on an array, and with a
+  `SyntaxError` on invalid JSON. There is no partial output.
+
+## Limits
+
+The source document is parsed **in memory** inside the activity — fits files
+up to tens of megabytes comfortably. For gigabyte-scale JSON a streaming
+scanner would be needed; this package does not provide one today.
+
+## Runtime requirements
+
+- Claim provider: `FileSystemClaim` (from `@t4h.framework/fs`).
+- Production whitelist: register `JsonToNDJsonActivity` via
+  `runtime.addActivity`.
+
+## Anti-patterns
+
+- **Parsing the batch file in workflow code.** `response.body.json()` is for
+  small API payloads: on a batch file it re-reads and re-parses the whole
+  document on every replay and holds it in workflow memory. Normalize with
+  `toNDJson()` and fan out with `split` instead.
+- **Hand-rolling delimiters over JSON text.** `Split.char('},{')` over a JSON
+  document breaks on formatting changes and on values containing structural
+  characters. JSON is parsed, never text-split.
+- **Expecting records in the workflow.** The transform resolves with a
+  `Binary` reference; records only materialize inside each child workflow run
+  started by `split`.
+- **Iterating records and calling `startWorkflow` per item.** That pushes N
+  entries into parent history; `split` keeps it O(1). See
+  **framework-fs-split**.
+
+## Related skills
+
+- `framework-fs-split` — `split`/`join`/`read`: fanning the NDJSON out into a
+  batch of workflows and folding results back.
+- `framework-http` — downloading the source file; `response.body.binary` is
+  the natural input to `json(...)`.
+- `framework-workflow-testing` — the harness for testing workflows that use
+  this pipeline.

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# @t4h.framework/transforms
+
+## 0.0.0-experimental-20260907052843
+
+### Patch Changes
+
+- Updated dependencies [[`a30386e`](https://github.com/tech4humans-brasil/framework/commit/a30386ebf832d1eec5989b0a12a56d91a6999421)]:
+  - @t4h.framework/core@0.0.0-experimental-20260907052843
+  - @t4h.framework/fs@0.0.0-experimental-20260907052843
+
+## 0.1.2
+
+### Patch Changes
+
+- Re-releases the accidental `1.0.0` as a patch. `1.0.0` was published by mistake (changesets bumps peer dependents with a major when a peer dependency gets a minor bump); this package stays on the `0.x` line.
+- Updated dependencies [[`8c56f76`](https://github.com/tech4humans-brasil/framework/commit/8c56f7697390a1ea966d1e91ff5f35ce5751a0d7), [`8c56f76`](https://github.com/tech4humans-brasil/framework/commit/8c56f7697390a1ea966d1e91ff5f35ce5751a0d7)]:
+  - @t4h.framework/fs@0.8.0
+
+## 0.1.1
+
+### Patch Changes
+
+- [`095c3a9`](https://github.com/tech4humans-brasil/framework/commit/095c3a91191b9f541519447f212a8e9509065569) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Republish with resolved dependency versions. The previous release leaked the `workspace:^` protocol into the published manifests, breaking installs outside the monorepo.
+
+## 0.1.0
+
+### Minor Changes
+
+- [`34698e3`](https://github.com/tech4humans-brasil/framework/commit/34698e34d0dc7f28a1e790d95d596a67d23e0c2e) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Initialize package

package/README.md

@@ -0,0 +1,43 @@
+# @t4h.framework/transforms
+
+Data transform activities for workflows.
+
+## JSON to NDJSON
+
+Rewrites a JSON document into NDJSON — one record per line — so it can be
+consumed by line-oriented activities such as `split` from
+`@t4h.framework/fs`. The transform is formatting-agnostic: minified,
+pretty-printed and BOM-prefixed documents all produce the same output.
+
+```typescript
+import { split, Split } from '@t4h.framework/fs'
+import { json } from '@t4h.framework/transforms'
+
+// { "registros": { "registro": [{ ... }, { ... }] } }
+const ndjson = await json(response.body.binary, {
+  path: 'registros.registro',
+}).toNDJson()
+
+const batch = await split(ndjson, registroWorkflow, {
+  delimiter: Split.line(),
+})
+```
+
+Omit `path` when the document root is the array itself. `json` captures the
+source document and its options; each `.toX()` method runs a dedicated
+transform activity, leaving room for other targets (`toCsv`, ...) later.
+
+### Options
+
+| Option     | Default | Description                                        |
+| ---------- | ------- | -------------------------------------------------- |
+| `path`     | —       | Dot path to the array of records (`a.b.c`)         |
+| `encoding` | `utf8`  | Encoding used to decode the source binary          |
+
+### Limits
+
+The source document is parsed in memory, so this activity fits files up to
+tens of megabytes. Only the resulting `Binary` reference crosses the
+activity boundary — the content itself never enters the workflow history.
+
+Peer dependencies: `@t4h.framework/core`, `@t4h.framework/fs`.

package/dist/activities/JsonToNDJsonActivity.d.ts

@@ -0,0 +1,13 @@
+import { type Binary, SyncActivity } from '@t4h.framework/core';
+import type { JsonOptions } from '../json.js';
+export type JsonToNDJsonActivityInput = {
+    binary: Binary;
+    options: JsonOptions;
+};
+export declare class JsonToNDJsonActivity extends SyncActivity<readonly [binary: Binary, options: JsonOptions], JsonToNDJsonActivityInput, Binary, Binary> {
+    private readonly claims;
+    toInput(binary: Binary, options: JsonOptions): JsonToNDJsonActivityInput;
+    run({ binary, options, }: JsonToNDJsonActivityInput): Promise<Binary>;
+    toOutput(output: Binary): Binary;
+}
+//# sourceMappingURL=JsonToNDJsonActivity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JsonToNDJsonActivity.d.ts","sourceRoot":"","sources":["../../src/activities/JsonToNDJsonActivity.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAS,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAUtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,qBAAa,oBAAqB,SAAQ,YAAY,CACpD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,EAC/C,yBAAyB,EACzB,MAAM,EACN,MAAM,CACP;IACC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IAEK,OAAO,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,GACnB,yBAAyB;IAIf,GAAG,CAAC,EACf,MAAM,EACN,OAAO,GACR,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGxC"}

package/dist/activities/JsonToNDJsonActivity.js

@@ -0,0 +1,135 @@
+import { Readable } from 'node:stream';
+import { StringDecoder } from 'node:string_decoder';
+import { Claim, SyncActivity } from '@t4h.framework/core';
+import { FileSystemClaim } from '@t4h.framework/fs';
+import chain from 'stream-chain';
+import { none } from 'stream-chain/defs.js';
+import { parser } from 'stream-json/parser.js';
+import { streamArray, } from 'stream-json/streamers/stream-array.js';
+export class JsonToNDJsonActivity extends SyncActivity {
+    claims = new Claim({
+        fs: FileSystemClaim,
+    });
+    toInput(binary, options) {
+        return { binary, options };
+    }
+    async run({ binary, options, }) {
+        const encoding = options.encoding ?? 'utf8';
+        const records = chain([
+            Readable.from(decode(await binary.stream(), encoding)),
+            parser({ packValues: true, streamValues: false }),
+            navigate(options.path),
+            streamArray(),
+        ]);
+        return await this.claims.fs.write(`transform/${this.id}.ndjson`, Readable.from(toLines(records)));
+    }
+    toOutput(output) {
+        return output;
+    }
+}
+async function* decode(source, encoding) {
+    const decoder = new StringDecoder(encoding);
+    let first = true;
+    for await (const chunk of source) {
+        let text = decoder.write(chunk);
+        if (first && text) {
+            first = false;
+            // external producers often prepend a byte order mark
+            if (text.charCodeAt(0) === 0xfeff)
+                text = text.slice(1);
+        }
+        if (text)
+            yield text;
+    }
+    const rest = decoder.end();
+    if (rest)
+        yield rest;
+}
+function navigate(path) {
+    const segments = path ? path.split('.') : [];
+    let mode = 'root';
+    let index = 0;
+    let depth = 0;
+    let matches = false;
+    const notArray = () => new TypeError(path
+        ? `Expected an array at "${path}" in the JSON document`
+        : 'Expected the JSON document root to be an array');
+    const unresolvable = (length) => new TypeError(`Could not resolve "${segments.slice(0, length).join('.')}" in the JSON document`);
+    return token => {
+        switch (mode) {
+            case 'root':
+                if (segments.length === 0) {
+                    if (token.name !== 'startArray')
+                        throw notArray();
+                    mode = 'forward';
+                    depth = 1;
+                    return token;
+                }
+                if (token.name !== 'startObject')
+                    throw unresolvable(1);
+                mode = 'key';
+                return none;
+            case 'key':
+                if (token.name === 'endObject')
+                    throw index === segments.length - 1
+                        ? notArray()
+                        : unresolvable(index + 2);
+                matches = token.name === 'keyValue' && token.value === segments[index];
+                mode = 'value';
+                return none;
+            case 'value':
+                if (!matches) {
+                    if (token.name === 'startObject' || token.name === 'startArray') {
+                        mode = 'skip';
+                        depth = 1;
+                    }
+                    else {
+                        mode = 'key';
+                    }
+                    return none;
+                }
+                if (index === segments.length - 1) {
+                    if (token.name !== 'startArray')
+                        throw notArray();
+                    mode = 'forward';
+                    depth = 1;
+                    return token;
+                }
+                if (token.name !== 'startObject')
+                    throw unresolvable(index + 2);
+                index += 1;
+                mode = 'key';
+                return none;
+            case 'skip':
+                if (token.name === 'startObject' || token.name === 'startArray')
+                    depth += 1;
+                else if (token.name === 'endObject' || token.name === 'endArray')
+                    depth -= 1;
+                if (depth === 0)
+                    mode = 'key';
+                return none;
+            case 'forward':
+                if (token.name === 'startObject' || token.name === 'startArray')
+                    depth += 1;
+                else if (token.name === 'endObject' || token.name === 'endArray')
+                    depth -= 1;
+                if (depth === 0)
+                    mode = 'done';
+                return token;
+            case 'done':
+                return none;
+        }
+    };
+}
+async function* toLines(records) {
+    try {
+        for await (const { value } of records)
+            yield JSON.stringify(value) + '\n';
+    }
+    catch (error) {
+        throw error instanceof Error && error.message.startsWith('Parser')
+            ? new SyntaxError(error.message)
+            : error;
+    }
+}
+//# sourceMappingURL=JsonToNDJsonActivity.js.map

package/dist/activities/JsonToNDJsonActivity.js.map

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

package/dist/json.d.ts

@@ -0,0 +1,13 @@
+import { type Binary } from '@t4h.framework/core';
+export type JsonOptions = {
+    path?: string;
+    encoding?: BufferEncoding;
+};
+export declare class Json {
+    readonly binary: Binary;
+    readonly options: JsonOptions;
+    constructor(binary: Binary, options: JsonOptions);
+    toNDJson(): Promise<Binary>;
+}
+export declare function json(binary: Binary, options?: JsonOptions): Json;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,qBAAqB,CAAA;AAI1D,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC1B,CAAA;AAED,qBAAa,IAAI;aAEG,MAAM,EAAE,MAAM;aACd,OAAO,EAAE,WAAW;gBADpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW;IAGzB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAOzC;AAED,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI,CAEpE"}

package/dist/json.js

@@ -0,0 +1,17 @@
+import { History } from '@t4h.framework/core';
+import { JsonToNDJsonActivity } from './activities/JsonToNDJsonActivity.js';
+export class Json {
+    binary;
+    options;
+    constructor(binary, options) {
+        this.binary = binary;
+        this.options = options;
+    }
+    async toNDJson() {
+        return await History.reconciler(JsonToNDJsonActivity, this.binary, this.options);
+    }
+}
+export function json(binary, options = {}) {
+    return new Json(binary, options);
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAO3E,MAAM,OAAO,IAAI;IAEG;IACA;IAFlB,YACkB,MAAc,EACd,OAAoB;QADpB,WAAM,GAAN,MAAM,CAAQ;QACd,YAAO,GAAP,OAAO,CAAa;IACnC,CAAC;IAEG,KAAK,CAAC,QAAQ;QACnB,OAAO,MAAM,OAAO,CAAC,UAAU,CAC7B,oBAAoB,EACpB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,CACb,CAAA;IACH,CAAC;CACF;AAED,MAAM,UAAU,IAAI,CAAC,MAAc,EAAE,UAAuB,EAAE;IAC5D,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAClC,CAAC"}

package/dist/transforms.d.ts

@@ -0,0 +1,3 @@
+export * from './activities/JsonToNDJsonActivity.js';
+export * from './json.js';
+//# sourceMappingURL=transforms.d.ts.map

package/dist/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../src/transforms.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA;AACpD,cAAc,WAAW,CAAA"}

package/dist/transforms.js

@@ -0,0 +1,3 @@
+export * from './activities/JsonToNDJsonActivity.js';
+export * from './json.js';
+//# sourceMappingURL=transforms.js.map

package/dist/transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.js","sourceRoot":"","sources":["../src/transforms.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA;AACpD,cAAc,WAAW,CAAA"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@t4h.framework/transforms",
+  "version": "0.0.0-experimental-20260907052843",
+  "description": "Data transform activities for the T4H Framework",
+  "homepage": "https://github.com/tech4humans-brasil/framework/tree/main/packages/transforms",
+  "bugs": "https://github.com/tech4humans-brasil/framework/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tech4humans-brasil/framework.git",
+    "directory": "packages/transforms"
+  },
+  "license": "MIT",
+  "author": "Tech4Humans <contact@tech4h.com.br> (https://tech4h.com.br)",
+  "type": "module",
+  "exports": {
+    "types": "./dist/transforms.d.ts",
+    "import": "./dist/transforms.js"
+  },
+  "module": "./dist/transforms.js",
+  "types": "./dist/transforms.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    ".ai"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint .",
+    "prepublishOnly": "yarn build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@t4h.framework/core": "^0.0.0-experimental-20260907052843",
+    "@t4h.framework/fs": "^0.0.0-experimental-20260907052843",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@t4h.framework/core": "^0.0.0-experimental-20260907052843",
+    "@t4h.framework/fs": "^0.0.0-experimental-20260907052843"
+  },
+  "packageManager": "yarn@4.12.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "stream-chain": "^4.2.5",
+    "stream-json": "^3.5.0"
+  }
+}