pareta 1.3.0 → 1.4.0

package/dist/index.d.cts

@@ -468,27 +468,41 @@ declare class Audio {
 }
 
 /**
- * `pa.images` — the image-generation capability lane, TS parity with the
- * Python SDK's `client.images`.
+ * `pa.images` — the image capability lanes (generate + edit), TS parity with
+ * the Python SDK's `client.images`.
  *
- * Dedicated route, not `chat.completions`:
- *   POST /v1/images/generations {prompt, size?, seed?} -> {created, model,
- *                                                          data: [{b64_json}], size}
+ * Dedicated routes, not `chat.completions`:
+ *   POST /v1/images/generations {prompt, size?, seed?}       -> {created, model,
+ *                                                                data: [{b64_json}], size}
+ *   POST /v1/images/edits       {prompt, image (b64), seed?} -> same shape
+ *
+ * Both run on Pareta's open image model (`hidream-1`) and are metered at a
+ * FLAT price per call — generation by image (every size costs the same;
+ * the model renders at full 2K internally), editing by edit (the output
+ * keeps the reference's aspect ratio). The `X-Pareta-Billed` response
+ * header carries the per-request receipt in micro-USD. Delivery sizes for
+ * generation (server-authoritative): 1024x1024 (default), 2048x2048,
+ * 2304x1728, 1728x2304, 2560x1440, 1440x2560.
  *
- * Generation runs on Pareta's open image model (`hidream-1`) and is metered
- * at a FLAT price per image — every size costs the same (the model renders
- * at full 2K quality internally regardless of the delivery size). The
- * `X-Pareta-Billed` response header carries the per-request receipt in
- * micro-USD. Delivery sizes today (server-authoritative): 1024x1024
- * (default), 2048x2048, 2304x1728, 1728x2304, 2560x1440, 1440x2560.
+ * Edit input follows the audio FileInput convention: a string is a FILE
+ * PATH (read via lazy node:fs — browser/edge bundles stay clean);
+ * Blob/ArrayBuffer/Uint8Array are raw bytes; `{ base64 }` passes
+ * pre-encoded image data through untouched.
  */
 
+type ImageInput = string | Blob | ArrayBuffer | Uint8Array | {
+    base64: string;
+};
 interface ImageGenerateOptions {
     /** Delivery size, e.g. "2560x1440" (omit for 1024x1024). Flat price. */
     size?: string;
     /** Pin the noise seed for reproducibility. */
     seed?: number;
 }
+interface ImageEditOptions {
+    /** Pin the noise seed for reproducibility. */
+    seed?: number;
+}
 declare class Images {
     private readonly client;
     constructor(client: Transport);
@@ -496,6 +510,11 @@ declare class Images {
      * whose `.image` is decoded PNG bytes (`.save(path)` writes a file in
      * Node). Billed flat per image. */
     generate(prompt: string, opts?: ImageGenerateOptions): Promise<ImageGeneration>;
+    /** Edit one reference image with a plain-language instruction (no mask).
+     * `image` is a file path, raw bytes, a Blob, or `{ base64 }` (≤25MB
+     * decoded). The output keeps the reference's aspect ratio. Billed flat
+     * per edit. */
+    edit(image: ImageInput, prompt: string, opts?: ImageEditOptions): Promise<ImageGeneration>;
 }
 
 /**
@@ -611,7 +630,7 @@ declare class Pareta implements Transport {
     stream<T = unknown>(method: string, path: string, opts?: StreamOptions): AsyncGenerator<T>;
 }
 
-declare const VERSION = "1.3.0";
+declare const VERSION = "1.4.0";
 
 /**
  * Typed error hierarchy for the Pareta SDK — a faithful port of the Python
@@ -703,4 +722,4 @@ declare class EndpointNotReadyError extends APIStatusError {
     constructor(message: string, init: APIStatusErrorInit);
 }
 
-export { APIConnectionError, APIStatusError, APITimeoutError, Audio, type AudioInput, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, Embeddings, type EmbeddingsFn, type EmbeddingsOptions, EndpointNotReadyError, type ErrorDetail, EvalItemResult, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, type ImageGenerateOptions, ImageGeneration, Images, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, Rerank, type RerankFn, type RerankOptions, RerankResult, type SSEEvent, Speech, type SpeechOptions, Task, TaskMatch, TaskMatchCandidate, Transcription, type TranscriptionOptions, type Transport, Usage, VERSION, type ValidationErrorItem };
+export { APIConnectionError, APIStatusError, APITimeoutError, Audio, type AudioInput, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, Embeddings, type EmbeddingsFn, type EmbeddingsOptions, EndpointNotReadyError, type ErrorDetail, EvalItemResult, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, type ImageEditOptions, type ImageGenerateOptions, ImageGeneration, type ImageInput, Images, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, Rerank, type RerankFn, type RerankOptions, RerankResult, type SSEEvent, Speech, type SpeechOptions, Task, TaskMatch, TaskMatchCandidate, Transcription, type TranscriptionOptions, type Transport, Usage, VERSION, type ValidationErrorItem };

package/dist/index.d.ts

@@ -468,27 +468,41 @@ declare class Audio {
 }
 
 /**
- * `pa.images` — the image-generation capability lane, TS parity with the
- * Python SDK's `client.images`.
+ * `pa.images` — the image capability lanes (generate + edit), TS parity with
+ * the Python SDK's `client.images`.
  *
- * Dedicated route, not `chat.completions`:
- *   POST /v1/images/generations {prompt, size?, seed?} -> {created, model,
- *                                                          data: [{b64_json}], size}
+ * Dedicated routes, not `chat.completions`:
+ *   POST /v1/images/generations {prompt, size?, seed?}       -> {created, model,
+ *                                                                data: [{b64_json}], size}
+ *   POST /v1/images/edits       {prompt, image (b64), seed?} -> same shape
+ *
+ * Both run on Pareta's open image model (`hidream-1`) and are metered at a
+ * FLAT price per call — generation by image (every size costs the same;
+ * the model renders at full 2K internally), editing by edit (the output
+ * keeps the reference's aspect ratio). The `X-Pareta-Billed` response
+ * header carries the per-request receipt in micro-USD. Delivery sizes for
+ * generation (server-authoritative): 1024x1024 (default), 2048x2048,
+ * 2304x1728, 1728x2304, 2560x1440, 1440x2560.
  *
- * Generation runs on Pareta's open image model (`hidream-1`) and is metered
- * at a FLAT price per image — every size costs the same (the model renders
- * at full 2K quality internally regardless of the delivery size). The
- * `X-Pareta-Billed` response header carries the per-request receipt in
- * micro-USD. Delivery sizes today (server-authoritative): 1024x1024
- * (default), 2048x2048, 2304x1728, 1728x2304, 2560x1440, 1440x2560.
+ * Edit input follows the audio FileInput convention: a string is a FILE
+ * PATH (read via lazy node:fs — browser/edge bundles stay clean);
+ * Blob/ArrayBuffer/Uint8Array are raw bytes; `{ base64 }` passes
+ * pre-encoded image data through untouched.
  */
 
+type ImageInput = string | Blob | ArrayBuffer | Uint8Array | {
+    base64: string;
+};
 interface ImageGenerateOptions {
     /** Delivery size, e.g. "2560x1440" (omit for 1024x1024). Flat price. */
     size?: string;
     /** Pin the noise seed for reproducibility. */
     seed?: number;
 }
+interface ImageEditOptions {
+    /** Pin the noise seed for reproducibility. */
+    seed?: number;
+}
 declare class Images {
     private readonly client;
     constructor(client: Transport);
@@ -496,6 +510,11 @@ declare class Images {
      * whose `.image` is decoded PNG bytes (`.save(path)` writes a file in
      * Node). Billed flat per image. */
     generate(prompt: string, opts?: ImageGenerateOptions): Promise<ImageGeneration>;
+    /** Edit one reference image with a plain-language instruction (no mask).
+     * `image` is a file path, raw bytes, a Blob, or `{ base64 }` (≤25MB
+     * decoded). The output keeps the reference's aspect ratio. Billed flat
+     * per edit. */
+    edit(image: ImageInput, prompt: string, opts?: ImageEditOptions): Promise<ImageGeneration>;
 }
 
 /**
@@ -611,7 +630,7 @@ declare class Pareta implements Transport {
     stream<T = unknown>(method: string, path: string, opts?: StreamOptions): AsyncGenerator<T>;
 }
 
-declare const VERSION = "1.3.0";
+declare const VERSION = "1.4.0";
 
 /**
  * Typed error hierarchy for the Pareta SDK — a faithful port of the Python
@@ -703,4 +722,4 @@ declare class EndpointNotReadyError extends APIStatusError {
     constructor(message: string, init: APIStatusErrorInit);
 }
 
-export { APIConnectionError, APIStatusError, APITimeoutError, Audio, type AudioInput, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, Embeddings, type EmbeddingsFn, type EmbeddingsOptions, EndpointNotReadyError, type ErrorDetail, EvalItemResult, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, type ImageGenerateOptions, ImageGeneration, Images, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, Rerank, type RerankFn, type RerankOptions, RerankResult, type SSEEvent, Speech, type SpeechOptions, Task, TaskMatch, TaskMatchCandidate, Transcription, type TranscriptionOptions, type Transport, Usage, VERSION, type ValidationErrorItem };
+export { APIConnectionError, APIStatusError, APITimeoutError, Audio, type AudioInput, AuthenticationError, BadRequestError, BaseModel, ChatCompletion, ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, Choice, ConflictError, Embeddings, type EmbeddingsFn, type EmbeddingsOptions, EndpointNotReadyError, type ErrorDetail, EvalItemResult, EvalResult, EvalRun, type EvalRunCreateParams, EvalRuns, EvalSet, EvalSets, type FileInput, type FilePart, FrontierModel, type FrontierSpec, type ImageEditOptions, type ImageGenerateOptions, ImageGeneration, type ImageInput, Images, InsufficientCreditsError, Message, Model, ModelList, NotFoundError, Pareta, ParetaError, type ParetaOptions, PermissionDeniedError, RateLimitError, Rerank, type RerankFn, type RerankOptions, RerankResult, type SSEEvent, Speech, type SpeechOptions, Task, TaskMatch, TaskMatchCandidate, Transcription, type TranscriptionOptions, type Transport, Usage, VERSION, type ValidationErrorItem };

package/dist/index.mjs

@@ -172,7 +172,7 @@ function parseSSE(reader, opts) {
 }
 
 // src/version.ts
-var VERSION = "1.3.0";
+var VERSION = "1.4.0";
 
 // src/money.ts
 var MICRO_PER_CENT = 10000n;
@@ -915,6 +915,21 @@ var Audio = class {
 
 // src/resources/images.ts
 var PATH3 = "/v1/images/generations";
+var EDIT_PATH = "/v1/images/edits";
+async function toBase642(image) {
+  if (typeof image === "string") {
+    const { readFile } = await import('fs/promises');
+    return bytesToBase64(new Uint8Array(await readFile(image)));
+  }
+  if (typeof image === "object" && image !== null && "base64" in image) {
+    if (!image.base64 || !image.base64.trim()) throw new ParetaError("image.base64 is empty");
+    return image.base64;
+  }
+  if (image instanceof Blob) return bytesToBase64(new Uint8Array(await image.arrayBuffer()));
+  const bytes = image instanceof Uint8Array ? image : new Uint8Array(image);
+  if (bytes.byteLength === 0) throw new ParetaError("image is empty");
+  return bytesToBase64(bytes);
+}
 var Images = class {
   constructor(client) {
     this.client = client;
@@ -933,6 +948,19 @@ var Images = class {
       cast: (raw) => new ImageGeneration(raw)
     });
   }
+  /** Edit one reference image with a plain-language instruction (no mask).
+   * `image` is a file path, raw bytes, a Blob, or `{ base64 }` (≤25MB
+   * decoded). The output keeps the reference's aspect ratio. Billed flat
+   * per edit. */
+  async edit(image, prompt, opts = {}) {
+    if (!prompt || !prompt.trim()) throw new ParetaError("prompt is required");
+    const body = { prompt, image: await toBase642(image) };
+    if (opts.seed !== void 0) body.seed = opts.seed;
+    return this.client.request("POST", EDIT_PATH, {
+      body,
+      cast: (raw) => new ImageGeneration(raw)
+    });
+  }
 };
 
 // src/resources/retrieval.ts