codai-sdk 0.68.0 → 0.69.0

package/dist/index.js

@@ -1985,6 +1985,8 @@ var Exports = class {
 
 //#endregion
 //#region src/resources/creatives.ts
+/** True when a `build` answer is the 202 carousel / print export job (poll `exports.wait(r.export.id)`). */
+const isPagedBuild = (r) => "export" in r && r.export != null;
 const path$5 = (id, tail = "") => `/v1/studio/creatives/${encodeURIComponent(id)}${tail}`;
 const lottieQuery = (q) => ({
 	format: q.format,
@@ -2326,6 +2328,11 @@ var Creatives = class {
 	* Studio document (`document`, exactly the `POST /v1/studio/documents` body). Converter notes come back in
 	* `warnings`. The file is free; `preview: true` also queues a billed preview (poll it with
 	* `documents.waitForPreview`). 400 `not_supported_for_kind` (video / image) or `invalid_spec`.
+	*
+	* A carousel (`format: 'png'` zip of slides or `'pdf'`) or print (`'pdf'`, PDF/X-4 with bleed and optional
+	* `crop_marks`) creative answers HTTP 202 with a queued export job in `export` (`format_id` picks the format,
+	* `quote_micro_usd` is held). Tell the two apart with `isPagedBuild`, poll with `exports.wait(r.export.id)` or use
+	* `buildAndWait`.
 	*/
 	build(id, body = {}, opts = {}) {
 		return this.http.json(path$5(id, "/build"), {
@@ -2337,6 +2344,69 @@ var Creatives = class {
 		});
 	}
 	/**
+	* `build`, then — for a carousel / print creative — poll the export job until it has `succeeded` or `failed`
+	* (`exports.wait`). Resolves to the 200 build for deck / doc / sheet, or to the finished `StudioExport`.
+	*/
+	async buildAndWait(id, body = {}, opts = {}) {
+		const r = await this.build(id, body, {
+			ext: opts.ext,
+			signal: opts.signal
+		});
+		if (!isPagedBuild(r)) return r;
+		const e = r.export;
+		if (e.status === "succeeded" || e.status === "failed") return e;
+		return new Exports(this.http).wait(e.id, opts);
+	}
+	/**
+	* Social post copy for a carousel, image or video creative: a caption + hashtags per platform (`platforms`,
+	* default Instagram + LinkedIn; `language` `ro` (default) | `en`; optional `brief`, `tone`, `seq`) and one alt text
+	* per slide, every answer repaired to the platform's hard limits (changes listed in `fixes`). Nothing is written to
+	* the creative. Token-metered (`cost_micro_usd`) under a small wallet hold (402 `insufficient_funds`); 400
+	* `not_supported_for_kind`, 422 `no_post_copy`, 504 `timeout`. `idempotencyKey` replays a retry (24 h).
+	*/
+	postCopy(id, body = {}, opts = {}) {
+		return this.http.json(path$5(id, "/post-copy"), {
+			method: "POST",
+			body: stripUndefined(body),
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: !opts.idempotencyKey
+		});
+	}
+	/**
+	* Edit a video clip by its transcript: delete word ranges (`remove: [{ from_word, to_word }]`, indexes into the
+	* clip asset's cached transcript from `captions`) from video node `node_id`; the pieces are placed back to back as
+	* one new version (`base_seq` rebased like `edit`, locks honoured unless `force`). Free. 409 `captions_required`
+	* (run `captions` on that clip first) or `stale`; video creatives only.
+	*/
+	transcriptCut(id, body, opts = {}) {
+		return this.http.json(path$5(id, "/transcript-cut"), {
+			method: "POST",
+			body: stripUndefined(body),
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: true
+		});
+	}
+	/**
+	* Generate a new picture for an `image` node (`prompt`, optional `model`, `aspect_ratio` — default the closest
+	* ratio of the node box — `base_seq`, `force`) and swap it in as one new version. A node with a `castId` sends that
+	* cast entry's `refAssetIds` as references and appends its `description`, so the subject stays consistent. Billed
+	* like `images.generate` (402 `insufficient_funds`); 400 `content_filtered` charges nothing. `idempotencyKey`
+	* replays a retry (24 h).
+	*/
+	regenerateNode(id, nodeId, body, opts = {}) {
+		return this.http.json(path$5(id, `/nodes/${encodeURIComponent(nodeId)}/regenerate`), {
+			method: "POST",
+			body: stripUndefined(body),
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: !opts.idempotencyKey
+		});
+	}
+	/**
 	* Re-apply a brand kit (`brand_kit_id`) or a flat token map (`tokens`) to the creative as one new version: literal
 	* colours equal to the old brand become token refs, `snap: true` maps every other colour to the nearest kit colour,
 	* `fonts` (default true) sets heading / body font refs by role, locked nodes are skipped unless `force`. The kit
@@ -2802,7 +2872,8 @@ function abortableSleep$3(ms, signal) {
 }
 const toBody = (input) => ({
 	asset_ids: input.assetIds ?? [],
-	params: input.params ?? {}
+	params: input.params ?? {},
+	...input.maskPngB64 !== void 0 ? { mask_png_b64: input.maskPngB64 } : {}
 });
 /** A run answer is a job (async op, HTTP 202) when `object` is `media_op.job`. */
 const isMediaOpJob = (r) => r.object === "media_op.job";
@@ -6770,6 +6841,9 @@ const OPERATION_METHODS = {
 	getStudioExport: "exports.retrieve",
 	createCreativeFromDocument: "creatives.fromDocument",
 	buildCreative: "creatives.build",
+	writeCreativePostCopy: "creatives.postCopy",
+	transcriptCutCreative: "creatives.transcriptCut",
+	regenerateCreativeNode: "creatives.regenerateNode",
 	createSystemOne: "systemOne.create",
 	createTranscription: "audio.transcribe",
 	createSpeech: "audio.speech",
@@ -7556,5 +7630,5 @@ function allKeys(obj) {
 }
 
 //#endregion
-export { AbuseReports, Account, AgentRuns, Agents, Assets, Audio, Batches, Billing, BrandKits, Cards, Chat, ChatCompletions, Codai, Codai as default, CodaiApps, CodaiError, Creatives, Devices, Documents, Embeddings, EnvironmentFiles, EnvironmentJobs, EnvironmentMembers, EnvironmentPorts, EnvironmentSecrets, EnvironmentTasks, Environments, Exports, Feedback, Health, Heartbeats, Hosts, HttpClient, Images, JAM_CLOSE_CODES, JAM_SCALES, JAM_SUBPROTOCOL, Jam, JamSession, Keys, Lists, LyricsResource, MediaOps, Memory, Messages, Models, Music, Notifications, OPERATION_METHODS, OrgMembers, Orgs, OsGate, PROVENANCE_MAX_BYTES, PhoneModels, Productions, Projects, Prompts, Provenance, RESOLVE_ATTESTATION_PAYLOAD_TYPE, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, Realtime, RealtimeSession, Receipts, Referrals, Renders, Research, Resolve, ResolveError, ResolveInsufficientFundsError, Responses, STREAMING_OPERATIONS, SandboxFiles, Sandboxes, ScheduleExecutor, SchedulerHosts, Schedules, SessionControls, SessionEvents, SessionLease, SessionShares, Sessions, Settings, Sfx, Shares, SystemOne, TUS_CHUNK_BYTES, Tasks, Templates, Tokens, Tools, Transcripts, Triggers, Usage, Vault, VaultDevices, Verify, Videos, VoiceRevocations, extensionHeaders, frameJson, isAssetDto, isMediaOpJob, isMediaOpJobFinished, isProductionFinished, isResearchFinished, jamUrl, mergeToolCall, readSse, realtimeUrl, resolveAttestationStatement, settingsConflictCurrent, shareTokenFrom, uploadIdFromLocation, vaultUnlockMessage, verifyAttestationWithKeys, verifyResolveWebhook };
+export { AbuseReports, Account, AgentRuns, Agents, Assets, Audio, Batches, Billing, BrandKits, Cards, Chat, ChatCompletions, Codai, Codai as default, CodaiApps, CodaiError, Creatives, Devices, Documents, Embeddings, EnvironmentFiles, EnvironmentJobs, EnvironmentMembers, EnvironmentPorts, EnvironmentSecrets, EnvironmentTasks, Environments, Exports, Feedback, Health, Heartbeats, Hosts, HttpClient, Images, JAM_CLOSE_CODES, JAM_SCALES, JAM_SUBPROTOCOL, Jam, JamSession, Keys, Lists, LyricsResource, MediaOps, Memory, Messages, Models, Music, Notifications, OPERATION_METHODS, OrgMembers, Orgs, OsGate, PROVENANCE_MAX_BYTES, PhoneModels, Productions, Projects, Prompts, Provenance, RESOLVE_ATTESTATION_PAYLOAD_TYPE, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, Realtime, RealtimeSession, Receipts, Referrals, Renders, Research, Resolve, ResolveError, ResolveInsufficientFundsError, Responses, STREAMING_OPERATIONS, SandboxFiles, Sandboxes, ScheduleExecutor, SchedulerHosts, Schedules, SessionControls, SessionEvents, SessionLease, SessionShares, Sessions, Settings, Sfx, Shares, SystemOne, TUS_CHUNK_BYTES, Tasks, Templates, Tokens, Tools, Transcripts, Triggers, Usage, Vault, VaultDevices, Verify, Videos, VoiceRevocations, extensionHeaders, frameJson, isAssetDto, isMediaOpJob, isMediaOpJobFinished, isPagedBuild, isProductionFinished, isResearchFinished, jamUrl, mergeToolCall, readSse, realtimeUrl, resolveAttestationStatement, settingsConflictCurrent, shareTokenFrom, uploadIdFromLocation, vaultUnlockMessage, verifyAttestationWithKeys, verifyResolveWebhook };
 //# sourceMappingURL=index.js.map