@auto-engineer/file-upload 1.147.0 → 1.149.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @auto-engineer/file-upload@1.147.0 build /home/runner/work/auto-engineer/auto-engineer/packages/file-upload
+> @auto-engineer/file-upload@1.149.0 build /home/runner/work/auto-engineer/auto-engineer/packages/file-upload
 > tsc && tsx ../../scripts/fix-esm-imports.ts
 
 Fixed ESM imports in dist/

package/.turbo/turbo-test.log

@@ -1,5 +1,5 @@
 
-> @auto-engineer/file-upload@1.146.0 test /home/runner/work/auto-engineer/auto-engineer/packages/file-upload
+> @auto-engineer/file-upload@1.148.0 test /home/runner/work/auto-engineer/auto-engineer/packages/file-upload
 > vitest run --reporter=dot
 
 
@@ -9,6 +9,6 @@
 
  Test Files  1 passed (1)
       Tests  10 passed (10)
-   Start at  19:11:22
-   Duration  2.37s (transform 451ms, setup 0ms, collect 464ms, tests 220ms, environment 0ms, prepare 516ms)
+   Start at  07:22:17
+   Duration  2.20s (transform 364ms, setup 0ms, collect 328ms, tests 271ms, environment 0ms, prepare 482ms)
 

package/.turbo/turbo-type-check.log

@@ -1,4 +1,4 @@
 
-> @auto-engineer/file-upload@1.146.0 type-check /home/runner/work/auto-engineer/auto-engineer/packages/file-upload
+> @auto-engineer/file-upload@1.148.0 type-check /home/runner/work/auto-engineer/auto-engineer/packages/file-upload
 > tsc --noEmit
 

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @auto-engineer/file-upload
 
+## 1.149.0
+
+### Minor Changes
+
+- [`e1eebbd`](https://github.com/BeOnAuto/auto-engineer/commit/e1eebbdf4f209780e790094d2e6887c4fa809f98) Thanks [@github-actions[bot]](https://github.com/github-actions%5Bbot%5D)! - - **server-generator-apollo-emmett**: add Given state ref hints to state.ts.ejs
+  - **server-generator-apollo-emmett**: context-aware nonCommandField instructions
+  - **server-generator-apollo-emmett**: add state context instruction
+  - **server-generator-apollo-emmett**: extract shared template helpers
+  - **server-generator-apollo-emmett**: filter state refs from hasGivenEvents in decide.ts.ejs
+
+### Patch Changes
+
+- [`d38c81e`](https://github.com/BeOnAuto/auto-engineer/commit/d38c81e7bb442a39626564cf4f6d8d55b60d0a38) Thanks [@SamHatoum](https://github.com/SamHatoum)! -
+
+## 1.148.0
+
+### Minor Changes
+
+- [`d5ba3a0`](https://github.com/BeOnAuto/auto-engineer/commit/d5ba3a0e3fb0f6a9ad7a3a8b1815590ea77a5b42) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - Added state context instruction to generated decide handlers, preventing unnecessary narrowing when Given steps contain only state references
+
+- [`e0cdc4e`](https://github.com/BeOnAuto/auto-engineer/commit/e0cdc4e3363ad84d4bc49996a600ac75c97ccc38) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - Added context-aware classification of non-command fields in generated decide.ts scaffolds, distinguishing between date-derived, state-derived, and not-yet-tested fields
+
+- [`9195db7`](https://github.com/BeOnAuto/auto-engineer/commit/9195db78cb707d658866cee99a1c73d34fb4efde) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - Extracted shared template helpers into a dedicated module for cleaner code generation
+
+- [`abb6540`](https://github.com/BeOnAuto/auto-engineer/commit/abb6540db7196ed7935c8a8610695828f9035fc3) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - Added status variant hints from Given state references to the state template, helping implementers create matching discriminated union variants
+
+- [`9195db7`](https://github.com/BeOnAuto/auto-engineer/commit/9195db78cb707d658866cee99a1c73d34fb4efde) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - Extracted shared template helper functions into a dedicated module for better code reuse across generators
+  - Simplified template specs by removing inline duplicate definitions in favor of the shared helpers
+
+### Patch Changes
+
+- [`88fb1da`](https://github.com/BeOnAuto/auto-engineer/commit/88fb1da2b222de04dd4959d87657395ee960a6ce) Thanks [@github-actions[bot]](https://github.com/github-actions%5Bbot%5D)! - - **server-generator-apollo-emmett**: skip empty file plans in scaffold output
+  - **server-generator-apollo-emmett**: filter state refs from given() in decide.specs.ts.ejs
+  - **server-generator-apollo-emmett**: move CS Given states from events to states array
+  - **global**: version packages
+  - **server-generator-apollo-emmett**: mark G1+G2 ketchup plan complete
+
+- [`4255f6d`](https://github.com/BeOnAuto/auto-engineer/commit/4255f6db0d128979e573244a615886482ce799b0) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - Updated ketchup plan for state reference fix in decide template generator
+  - Marked generator bug fix milestones G1 and G2 as complete
+
+- [`62f1ea3`](https://github.com/BeOnAuto/auto-engineer/commit/62f1ea3dd1b4275211574e3df9d9a6571ae9b27a) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - Fixed scaffold generation to correctly distinguish between event and state references in decision handlers
+  - Prevented contradictory instructions from appearing in generated code when Given clauses contain only state references
+
+- [`ba4f5c9`](https://github.com/BeOnAuto/auto-engineer/commit/ba4f5c9749fb1c15d444e78ca9a2689817f039cb) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - Added implementation plan for decide.ts code generation fixes in the Apollo Emmett server generator
+
 ## 1.147.0
 
 ### Minor Changes

package/README.md

@@ -0,0 +1,141 @@
+# @auto-engineer/file-upload
+
+Upload file content to local disk, an HTTP endpoint, or cloud storage via a presigned-URL signer.
+
+---
+
+## Purpose
+
+Without `@auto-engineer/file-upload`, you would have to implement three separate upload strategies (local filesystem, direct HTTP PUT, presigned-URL signing flow) and wire up the branching logic yourself every time a component needs to persist a file.
+
+---
+
+## Installation
+
+```bash
+pnpm add @auto-engineer/file-upload
+```
+
+## Quick Start
+
+```typescript
+import { uploadFile } from '@auto-engineer/file-upload';
+
+// Write to local disk
+await uploadFile('output/report.json', content, {
+  uploadUrl: 'file:///tmp/artifacts',
+  prefix: 'my-project',
+  writeFile: (path, data) => fs.promises.writeFile(path, data),
+  mkdir: (path) => fs.promises.mkdir(path, { recursive: true }),
+});
+
+// Upload via direct HTTP PUT
+await uploadFile('output/report.json', content, {
+  uploadUrl: 'https://storage.example.com/bucket',
+  prefix: 'my-project',
+  fetch,
+});
+
+// Upload via presigned-URL signer
+await uploadFile('output/report.json', content, {
+  signerUrl: 'https://signer.example.com/sign',
+  signerToken: 'my-token',
+  prefix: 'my-project',
+  fetch,
+});
+```
+
+---
+
+## How-to Guides
+
+### Write files to a local directory
+
+Set `uploadUrl` to a `file://` URL. Provide `writeFile` and `mkdir` callbacks so the function can create directories and write bytes.
+
+```typescript
+await uploadFile('data.json', content, {
+  uploadUrl: 'file:///var/artifacts',
+  writeFile: (p, d) => fs.promises.writeFile(p, d),
+  mkdir: (p) => fs.promises.mkdir(p, { recursive: true }),
+});
+```
+
+### Upload directly to an HTTP endpoint
+
+Set `uploadUrl` to an `http://` or `https://` URL. The file is PUT to `{uploadUrl}/{prefix}/{relativePath}`.
+
+```typescript
+await uploadFile('data.json', content, {
+  uploadUrl: 'https://storage.example.com/bucket',
+  prefix: 'proj-1',
+  fetch,
+});
+```
+
+### Upload via a presigned-URL signer
+
+Omit `uploadUrl` and set `signerUrl` and `signerToken`. The function POSTs `{ key }` to the signer, receives `{ url }` back, then PUTs the content to that presigned URL.
+
+```typescript
+await uploadFile('data.json', content, {
+  signerUrl: 'https://signer.example.com/sign',
+  signerToken: process.env.SIGNER_TOKEN,
+  fetch,
+});
+```
+
+### Skip uploading entirely
+
+If neither `uploadUrl` nor `signerUrl` is provided, `uploadFile` returns immediately with no side effects.
+
+---
+
+## API Reference
+
+### `uploadFile(relativePath, content, deps)`
+
+Uploads a file using the strategy determined by `deps`.
+
+| Parameter      | Type                    | Description                          |
+| -------------- | ----------------------- | ------------------------------------ |
+| `relativePath` | `string`                | Destination path relative to prefix  |
+| `content`      | `Uint8Array`            | Raw file bytes                       |
+| `deps`         | `UploadDeps`            | Configuration and injected functions |
+
+Returns `Promise<void>`. Throws on non-OK HTTP responses.
+
+### `UploadDeps`
+
+```typescript
+interface UploadDeps {
+  uploadUrl?: string;    // file:// for local, http(s):// for direct PUT
+  prefix?: string;       // Optional path prefix prepended to the key
+  signerUrl?: string;    // URL of the presigned-URL signer service
+  signerToken?: string;  // Bearer token sent to the signer
+  fetch?: typeof globalThis.fetch;
+  writeFile?: (path: string, data: Uint8Array) => Promise<void>;
+  mkdir?: (path: string) => Promise<void>;
+}
+```
+
+**Strategy resolution order:**
+
+1. `uploadUrl` starts with `file://` -- write to local filesystem using `writeFile` and `mkdir`
+2. `uploadUrl` starts with `http` -- direct PUT to `{uploadUrl}/{key}`
+3. `signerUrl` is set -- POST to signer, then PUT to the returned presigned URL
+4. None of the above -- no-op
+
+---
+
+## Architecture
+
+The package exports a single function with no external dependencies. All I/O is injected through the `UploadDeps` parameter (`fetch`, `writeFile`, `mkdir`), making the function fully testable without mocks at the module level.
+
+```
+uploadFile(relativePath, content, deps)
+  ├─ file:// mode   → mkdir + writeFile to local path
+  ├─ http PUT mode   → PUT content to {uploadUrl}/{key}
+  ├─ signer mode     → POST to signerUrl → PUT to presigned URL
+  └─ no-op           → return immediately
+```

package/package.json

@@ -13,7 +13,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.147.0",
+  "version": "1.149.0",
   "scripts": {
     "build": "tsc && tsx ../../scripts/fix-esm-imports.ts",
     "test": "vitest run --reporter=dot",