transloadit 4.1.2 → 4.1.3

package/src/alphalib/types/robots/image-generate.ts

@@ -34,10 +34,13 @@ export const robotImageGenerateInstructionsSchema = robotBase
   .merge(robotUse)
   .extend({
     robot: z.literal('/image/generate'),
-    model: z.string(),
+    model: z
+      .string()
+      .optional()
+      .describe('The AI model to use for image generation. Defaults to google/nano-banana.'),
     prompt: z.string().describe('The prompt describing the desired image content.'),
     format: z
-      .enum(['jpeg', 'png', 'gif', 'webp', 'svg'])
+      .enum(['jpeg', 'jpg', 'png', 'gif', 'webp', 'svg'])
       .optional()
       .describe('Format of the generated image.'),
     seed: z.number().optional().describe('Seed for the random number generator.'),
@@ -69,7 +72,7 @@ export type RobotImageGenerateInstructionsWithHiddenFields = z.infer<
 >
 
 export const interpolatableRobotImageGenerateInstructionsSchema = interpolateRobot(
-  robotImageGenerateInstructionsSchema,
+  robotImageGenerateInstructionsWithHiddenFieldsSchema,
 )
 export type InterpolatableRobotImageGenerateInstructions =
   InterpolatableRobotImageGenerateInstructionsInput

package/src/alphalib/types/robots/meta-write.ts

@@ -53,8 +53,7 @@ export const robotMetaWriteInstructionsSchema = robotBase
 **Note:** This <dfn>Robot</dfn> currently accepts images, videos and audio files.
 `),
     data_to_write: z
-      .object({})
-      .passthrough()
+      .record(z.unknown())
       .default({})
       .describe(`
 A key/value map defining the metadata to write into the file.

package/src/alphalib/types/templateCredential.ts

@@ -20,6 +20,7 @@ export const templateCredentialsSchema = z
       ),
     type: z
       .enum([
+        'ai',
         'azure',
         'backblaze',
         'cloudflare',

package/src/cli/OutputCtl.ts

@@ -2,7 +2,7 @@
  * Log levels following syslog severity (https://en.wikipedia.org/wiki/Syslog#Severity_level)
  * Lower numbers = more severe, higher numbers = more verbose
  */
-export const LOG_LEVEL = {
+const LOG_LEVEL = {
   ERR: 3, // Error conditions
   WARN: 4, // Warning conditions
   NOTICE: 5, // Normal but significant (default)

package/src/cli/commands/BaseCommand.ts

@@ -6,7 +6,7 @@ import { getEnvCredentials } from '../helpers.ts'
 import type { IOutputCtl } from '../OutputCtl.ts'
 import OutputCtl, { LOG_LEVEL_DEFAULT, LOG_LEVEL_NAMES, parseLogLevel } from '../OutputCtl.ts'
 
-export abstract class BaseCommand extends Command {
+abstract class BaseCommand extends Command {
   logLevelOption = Option.String('-l,--log-level', {
     description: `Log level: ${LOG_LEVEL_NAMES.join(', ')} or 3-8 (default: notice)`,
   })

package/src/cli/commands/assemblies.ts

@@ -36,7 +36,7 @@ export interface AssemblyGetOptions {
   assemblies: string[]
 }
 
-export interface AssemblyDeleteOptions {
+interface AssemblyDeleteOptions {
   assemblies: string[]
 }
 

package/src/cli/commands/notifications.ts

@@ -7,12 +7,12 @@ import { AuthenticatedCommand } from './BaseCommand.ts'
 
 // --- Types and business logic ---
 
-export interface NotificationsReplayOptions {
+interface NotificationsReplayOptions {
   notify_url?: string
   assemblies: string[]
 }
 
-export async function replay(
+async function replay(
   output: IOutputCtl,
   client: Transloadit,
   { notify_url, assemblies }: NotificationsReplayOptions,

package/src/cli/commands/templates.ts

@@ -33,11 +33,11 @@ export interface TemplateModifyOptions {
   file: string
 }
 
-export interface TemplateDeleteOptions {
+interface TemplateDeleteOptions {
   templates: string[]
 }
 
-export interface TemplateListOptions {
+interface TemplateListOptions {
   before?: string
   after?: string
   order?: 'asc' | 'desc'
@@ -162,7 +162,7 @@ const TemplateIdSchema = z.object({
   id: z.string(),
 })
 
-export function list(
+function list(
   output: IOutputCtl,
   client: Transloadit,
   { before, after, order, sort, fields }: TemplateListOptions,

package/src/cli/helpers.ts

@@ -1,6 +1,5 @@
 import fs from 'node:fs'
 import type { Readable } from 'node:stream'
-import type { APIError } from './types.ts'
 import { isAPIError } from './types.ts'
 
 export function getEnvCredentials(): { authKey: string; authSecret: string } | null {
@@ -35,8 +34,9 @@ export function formatAPIError(err: unknown): string {
   return String(err)
 }
 
-// Re-export APIError type for convenience
-export type { APIError }
+// Re-export APIError type for CLI consumers relying on deep imports.
+/** @public */
+export type { APIError } from './types.ts'
 
 export function zip<A, B>(listA: A[], listB: B[]): [A, B][]
 export function zip<T>(...lists: T[][]): T[][]

package/src/cli/types.ts

@@ -1,23 +1,15 @@
 import { z } from 'zod'
 import type { Steps } from '../alphalib/types/template.ts'
 import { optionalStepsSchema } from '../alphalib/types/template.ts'
-import type { BillResponse, ListedTemplate, TemplateResponse } from '../apiTypes.ts'
-import type { AssemblyStatus, Transloadit } from '../Transloadit.ts'
-import type { IOutputCtl } from './OutputCtl.ts'
-
-// Re-export transloadit types for CLI use
-export type { AssemblyStatus, BillResponse, ListedTemplate, TemplateResponse }
-export type { Transloadit }
-export type { CreateAssemblyOptions } from '../Transloadit.ts'
 
 // Zod schemas for runtime validation
-export const APIErrorSchema = z.object({
+const APIErrorSchema = z.object({
   error: z.string(),
   message: z.string(),
 })
 export type APIError = z.infer<typeof APIErrorSchema>
 
-export const TransloaditAPIErrorSchema = z.object({
+const TransloaditAPIErrorSchema = z.object({
   error: z.string().optional(),
   message: z.string(),
   code: z.string().optional(),
@@ -54,98 +46,6 @@ export interface TemplateFile {
   data: TemplateFileData
 }
 
-// Template list item (from API)
-export interface TemplateListItem {
-  id: string
-  modified: string
-  name?: string
-}
-
-// CLI Invocation types
-export interface BaseInvocation {
-  error?: boolean
-  message?: string
-  mode: string
-  action?: string
-  logLevel?: number
-  jsonMode?: boolean
-}
-
-export interface AssemblyInvocation extends BaseInvocation {
-  mode: 'assemblies'
-  action?: 'create' | 'get' | 'list' | 'delete' | 'replay'
-  inputs: string[]
-  output?: string
-  recursive?: boolean
-  watch?: boolean
-  del?: boolean
-  reprocessStale?: boolean
-  steps?: string
-  template?: string
-  fields?: Record<string, string>
-  assemblies?: string[]
-  before?: string
-  after?: string
-  keywords?: string[]
-  notify_url?: string
-  reparse?: boolean
-}
-
-export interface TemplateInvocation extends BaseInvocation {
-  mode: 'templates'
-  action?: 'create' | 'get' | 'list' | 'delete' | 'modify' | 'sync'
-  templates?: string[]
-  template?: string
-  name?: string
-  file?: string
-  files?: string[]
-  before?: string
-  after?: string
-  order?: 'asc' | 'desc'
-  sort?: string
-  fields?: string[]
-  recursive?: boolean
-}
-
-export interface BillInvocation extends BaseInvocation {
-  mode: 'bills'
-  action?: 'get'
-  months: string[]
-}
-
-export interface NotificationInvocation extends BaseInvocation {
-  mode: 'assembly-notifications'
-  action?: 'list' | 'replay'
-  assemblies?: string[]
-  notify_url?: string
-  type?: string
-  assembly_id?: string
-  pagesize?: number
-}
-
-export interface HelpInvocation extends BaseInvocation {
-  mode: 'help' | 'version' | 'register'
-}
-
-export type Invocation =
-  | AssemblyInvocation
-  | TemplateInvocation
-  | BillInvocation
-  | NotificationInvocation
-  | HelpInvocation
-
-// Command handler type
-export type CommandHandler<T extends BaseInvocation = BaseInvocation> = (
-  output: IOutputCtl,
-  client: Transloadit | undefined,
-  invocation: T,
-) => void | Promise<void>
-
-// Type guard for Error
-export function isError(value: unknown): value is Error {
-  return value instanceof Error
-}
-
 // Helper to ensure error is Error type
 export function ensureError(value: unknown): Error {
   if (value instanceof Error) {
@@ -168,16 +68,3 @@ export function isTransloaditAPIError(value: unknown): value is TransloaditAPIEr
 export function isErrnoException(value: unknown): value is NodeJS.ErrnoException {
   return value instanceof Error && 'code' in value
 }
-
-// Safe array access helper
-export function safeGet<T>(arr: T[], index: number): T | undefined {
-  return arr[index]
-}
-
-// Assert defined helper
-export function assertDefined<T>(value: T | undefined | null, message: string): T {
-  if (value === undefined || value === null) {
-    throw new Error(message)
-  }
-  return value
-}

package/CHANGELOG.md

@@ -1,257 +0,0 @@
-# Changelog
-
-You may also want to refer to [GitHub releases](https://github.com/transloadit/node-sdk/releases).
-
-## Unreleased
-
-- TBD
-
-## v4.1.2
-
-Released: 2025-12-08.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v4.1.1...v4.1.2).
-
-- CLI accepts `TRANSLOADIT_AUTH_KEY`/`TRANSLOADIT_AUTH_SECRET` as aliases for `TRANSLOADIT_KEY`/`TRANSLOADIT_SECRET` when authenticating commands.
-- Internal: fix lint import ordering to keep CI green.
-
-## v4.1.1
-
-Released: 2025-12-08.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v4.1.0...v4.1.1).
-
-- CLI now accepts `TRANSLOADIT_AUTH_KEY`/`TRANSLOADIT_AUTH_SECRET` in addition to `TRANSLOADIT_KEY`/`TRANSLOADIT_SECRET` when authenticating commands.
-
-## v4.1.0
-
-Released: 2025-12-08.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v4.0.7...v4.1.0).
-
-- Add `signal` option to `createAssembly()` for cancelling in-flight HTTP requests and TUS uploads via `AbortController`
-- Add `signal` and `onPoll` options to `awaitAssemblyCompletion()` for cancellation and early termination (useful for custom progress reporting or superseding assemblies in watch mode)
-- Integrate transloadify CLI into the SDK, providing `assemblies`, `templates`, `bills`, and `assembly-notifications` commands
-- Add `--log-level (-l)` CLI option using syslog severity levels (err=3, warn=4, notice=5, info=6, debug=7, trace=8)
-- Add `--endpoint` CLI option for custom API endpoint (also reads `TRANSLOADIT_ENDPOINT` env var)
-- Add `--single-assembly` flag to `assemblies create` for passing multiple input files to a single assembly
-- Add `--concurrency` option to `assemblies create` to limit parallel processing (default: 5)
-- Fix file descriptor exhaustion by closing streams immediately and creating fresh ones on demand
-- Apply stricter biome lint rules (noExplicitAny, useAwait, noForEach, noNonNullAssertion)
-
-## v4.0.7
-
-Released: 2025-11-26.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v4.0.6...v4.0.7).
-
-- [x] Update schemas to match the latest API changes.
-
-## v4.0.6
-
-Released: 2025-11-04.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v4.0.5...v4.0.6).
-
-- [x] Re-export `AssemblyInstructions` and `AssemblyInstructionsInput` at the package entry to match the migration guide and TypeScript examples.
-
-## v4.0.5
-
-Released: 2025-10-16.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v4.0.1...v4.0.5).
-
-- [x] Add `smart_sig` CLI to return Smart CDN URLs via `getSignedSmartCDNUrl`, making it suitable as the cross-SDK reference implementation.
-- [x] Add `sig` CLI command for generating request signatures, including an `--algorithm` flag for choosing the HMAC digest.
-- [x] Ensure the CLI entrypoint executes when invoked through npm/yarn bin shims by resolving symlinks before bootstrapping.
-- [x] Harden validation and tests around CLI invocation paths.
-
-v4.0.2, v4.0.3, and v4.0.4 were broken releases
-
-## v4.0.1
-
-Released: 2025-09-18.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v4.0.0...v4.0.1).
-
-- [x] Re-published v4.0.0 under v4.0.1 to fix release metadata. No functional changes.
-
-## v4.0.0
-
-Released: 2025-09-18.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v3.0.2...v4.0.0).
-
-- [x] **Breaking:** Package is now pure ESM, requires Node.js 20+, and exports `{ Transloadit }` instead of a default client.
-- [x] **Breaking** `TransloaditError` removed in favor of a new, slightly different `ApiError`.
-- [x] Added end-to-end TypeScript typings for robots, assemblies, templates, and responses, so assembly instructions now autocomplete every robot and its supported parameters. Notably, Assembly instructions and statuses are validates against rich TypeScript types; migrate to the new `AssemblyInstructionsInput` types and `AssemblyStatus` in responses.
-- [x] New rich error stacktraces that aid in debugging issues.
-- [x] Added opt-in `validateResponses` safeguard and a `getSignedSmartCDNUrl` helper for generating signed Smart CDN URLs.
-- [x] Fix broken rate limiting #217
-- [x] Modernized tooling, tests, and examples (Vitest, Biome, TypeScript examples). See [MIGRATION.md](./MIGRATION.md) for a guided upgrade path.
-
-## v3.0.2
-
-Released: 2021-04-06.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v3.0.1...v3.0.2).
-
-- [x] Generate assembly IDs on the client to avoid relying on server timing.
-- [x] Completed TypeScript surface for assembly responses by adding missing output properties.
-
-## v3.0.1
-
-Released: 2021-03-31.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v3.0.0...v3.0.1).
-
-- [x] Fixed the published default export to match the actual runtime client.
-
-## v3.0.0
-
-Released: 2021-03-16.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v2.0.10...v3.0.0).
-
-- [x] Finalized the promise-based client by removing legacy wrappers and tightening trailing-slash validation.
-- [x] Expanded continuous testing, linting, and documentation coverage ahead of the stable v3 release.
-- [x] Improved `createAssembly` diagnostics by logging assembly IDs and exposing replayed assembly URLs.
-
-## v2.0.10
-
-Released: 2020-02-25.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v2.0.9...v2.0.10).
-
-- [x] Update dependencies, thank you @dagreatbrendino
-
-## v2.0.9
-
-Released: 2018-12-06.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v2.0.5...v2.0.9).
-
-- [x] Add more helpful message to assembly error (#73)
-- [x] Add Assembly ID to unknown errors
-- [x] Upgrade linting and fix newly found errors
-
-## v2.0.7
-
-Released: 2018-12-06.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v2.0.5...v2.0.7).
-
-- [x] Fix Transloadit-Client header test for once and all (#62)
-- [x] Fix bug causing progressCb to only be fired once
-
-## v2.0.5
-
-Released: 2018-12-06.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v2.0.4...v2.0.5).
-
-- [x] Make resize image example more usable irl
-- [x] Update Readme to include example for progressCb.
-- [x] Fix failing test due to version increase (#61)
-- [x] Update npm-run-all to lose event-stream dependency
-
-## v2.0.4
-
-Released: 2018-11-05.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v2.0.3...v2.0.4).
-
-- [x] Send transloadit-client header (#59)
-
-## v2.0.3
-
-Released: 2018-10-29.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v2.0.2...v2.0.3).
-
-- [x] When adding a stream that throws an error, do not send it to Transloadit
-
-## v2.0.2
-
-Released: 2018-10-24.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v2.0.1...v2.0.2).
-
-- [x] Fix bug: invoke callback when there are no tus files to upload
-
-## v2.0.1
-
-Released: 2018-06-18.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v2.0.0...v2.0.1).
-
-- [x] Fix bug: invoke callback when waitforcompmletion is false
-
-## v2.0.0
-
-Released: 2018-06-08.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v1.11.0...v2.0.0).
-
-- [x] (MAJOR) Use of **tus** client to enable resumable uploads. (not strictly speaking breaking the api, but big enough of an implementation change to warant a major so you can take extra care things work well)
-- [x] Support Assembly Progress Callback (this supports progress during file uploads and assemby execution).
-
-## v1.11.0
-
-Released: 2018-05-23.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v1.10.2...v1.11.0).
-
-- [x] Add Assembly URL to error console logs for easier debugging. (Q: should the node sdk log to console at all? should it not just work with callbacks and the caller decides what to write to what medium?)
-
-## v1.10.3
-
-Released: 2018-01-09.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v1.10.1...v1.10.3).
-
-- [x] Remove unused region parameter (@tim-kos)
-
-## v1.10.2
-
-Released: 2017-10-15.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v1.10.0...v1.10.2).
-
-- [x] Update lib files (@ifedapoolarewaju)
-
-## v1.10.1
-
-Released: 2017-10-02.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v1.10.0...v1.10.1).
-
-- [x] fix: check path for only direct Readable instances (@ifedapoolarewaju)
-
-## v1.10.0
-
-Released: 2017-09-28.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v1.9.6...v1.10.0).
-
-- [x] Do not retry infinitely if there is an unrecoverable error. Fixes #47. (@tim-kos)
-- [x] Add the ability to wait for the encoding results of an assembly before the callback to createAssembly() is called (@tim-kos)
-
-## v1.9.6
-
-Released: 2017-09-26.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v1.9.5...v1.9.6).
-
-- [x] Fix bug that threw `TypeError: Cannot read property 'body' of undefined` (https://github.com/transloadit/node-sdk/issues/48) (@kvz)
-- [x] Fix linting issues (@kvz)
-- [x] Refactor via invig.io (@kvz)
-- [x] Upgrade dependencies (@kvz)
-
-## v1.9.5
-
-Released: 2017-09-26.
-
-[Diff](https://github.com/transloadit/node-sdk/compare/v0.0.22...1.9.5).
-
-- [x] Start tracking CHANGELOG.md