@nodaro/sdk 2.64.0 → 2.65.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{chunk-R63TTR35.cjs → chunk-3CB4WYEY.cjs} +2 -2
- package/dist/{chunk-R63TTR35.cjs.map → chunk-3CB4WYEY.cjs.map} +1 -1
- package/dist/{chunk-E3ZMKMY7.js → chunk-3TRBBYSN.js} +4 -3
- package/dist/chunk-3TRBBYSN.js.map +1 -0
- package/dist/{chunk-3OARKXWT.cjs → chunk-4DCXJ77J.cjs} +6 -4
- package/dist/chunk-4DCXJ77J.cjs.map +1 -0
- package/dist/{chunk-C7DOFDP2.cjs → chunk-BYFLERF3.cjs} +18 -18
- package/dist/{chunk-C7DOFDP2.cjs.map → chunk-BYFLERF3.cjs.map} +1 -1
- package/dist/{chunk-AAUVNTWE.cjs → chunk-C3LJ7HIH.cjs} +4 -3
- package/dist/chunk-C3LJ7HIH.cjs.map +1 -0
- package/dist/{chunk-T7N7DFQJ.js → chunk-CRIQLLR2.js} +2 -2
- package/dist/{chunk-T7N7DFQJ.js.map → chunk-CRIQLLR2.js.map} +1 -1
- package/dist/{chunk-KBRMAEBT.cjs → chunk-GKTZHICS.cjs} +3 -3
- package/dist/{chunk-KBRMAEBT.cjs.map → chunk-GKTZHICS.cjs.map} +1 -1
- package/dist/{chunk-K2VWXAGK.js → chunk-HAS6PMQN.js} +6 -4
- package/dist/chunk-HAS6PMQN.js.map +1 -0
- package/dist/{chunk-GHVCV4S5.cjs → chunk-HVF5DRGQ.cjs} +2 -2
- package/dist/{chunk-GHVCV4S5.cjs.map → chunk-HVF5DRGQ.cjs.map} +1 -1
- package/dist/{chunk-5LI4CVJB.cjs → chunk-HW3CSUVC.cjs} +2 -2
- package/dist/chunk-HW3CSUVC.cjs.map +1 -0
- package/dist/{chunk-NODNRXHA.js → chunk-HW6U7WXU.js} +3 -3
- package/dist/{chunk-NODNRXHA.js.map → chunk-HW6U7WXU.js.map} +1 -1
- package/dist/{chunk-YT7HGYVO.js → chunk-K2QVR3LG.js} +10 -10
- package/dist/{chunk-YT7HGYVO.js.map → chunk-K2QVR3LG.js.map} +1 -1
- package/dist/{chunk-VQOUF4F5.js → chunk-MCXZV3CW.js} +20 -9
- package/dist/chunk-MCXZV3CW.js.map +1 -0
- package/dist/{chunk-3QFTP5P5.js → chunk-OHC4JIUP.js} +10 -2
- package/dist/chunk-OHC4JIUP.js.map +1 -0
- package/dist/{chunk-H3HUZT3T.js → chunk-OVFH7L2T.js} +2 -2
- package/dist/{chunk-H3HUZT3T.js.map → chunk-OVFH7L2T.js.map} +1 -1
- package/dist/{chunk-GA4LZZKQ.cjs → chunk-PGT4BXR2.cjs} +10 -2
- package/dist/chunk-PGT4BXR2.cjs.map +1 -0
- package/dist/{chunk-A42R7UT7.js → chunk-SVWEWBXI.js} +2 -2
- package/dist/chunk-SVWEWBXI.js.map +1 -0
- package/dist/{chunk-GGIWDFER.cjs → chunk-XSYNVD3X.cjs} +20 -9
- package/dist/chunk-XSYNVD3X.cjs.map +1 -0
- package/dist/entries/audio.cjs +2 -2
- package/dist/entries/audio.d.cts +10 -0
- package/dist/entries/audio.d.ts +10 -0
- package/dist/entries/audio.js +1 -1
- package/dist/entries/billing.cjs +2 -2
- package/dist/entries/billing.d.cts +18 -7
- package/dist/entries/billing.d.ts +18 -7
- package/dist/entries/billing.js +1 -1
- package/dist/entries/cast-swap.cjs +2 -2
- package/dist/entries/cast-swap.d.cts +29 -7
- package/dist/entries/cast-swap.d.ts +29 -7
- package/dist/entries/cast-swap.js +1 -1
- package/dist/entries/client.cjs +14 -14
- package/dist/entries/client.js +9 -9
- package/dist/entries/content-rights.cjs +2 -2
- package/dist/entries/content-rights.d.cts +4 -2
- package/dist/entries/content-rights.d.ts +4 -2
- package/dist/entries/content-rights.js +1 -1
- package/dist/entries/core.cjs +5 -5
- package/dist/entries/core.js +1 -1
- package/dist/entries/jobs.cjs +2 -2
- package/dist/entries/jobs.d.cts +24 -8
- package/dist/entries/jobs.d.ts +24 -8
- package/dist/entries/jobs.js +1 -1
- package/dist/entries/trends.cjs +2 -2
- package/dist/entries/trends.d.cts +11 -2
- package/dist/entries/trends.d.ts +11 -2
- package/dist/entries/trends.js +1 -1
- package/dist/entries/voices.cjs +2 -2
- package/dist/entries/voices.d.cts +16 -5
- package/dist/entries/voices.d.ts +16 -5
- package/dist/entries/voices.js +1 -1
- package/dist/index.cjs +22 -22
- package/dist/index.d.cts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +9 -9
- package/package.json +3 -3
- package/dist/chunk-3OARKXWT.cjs.map +0 -1
- package/dist/chunk-3QFTP5P5.js.map +0 -1
- package/dist/chunk-5LI4CVJB.cjs.map +0 -1
- package/dist/chunk-A42R7UT7.js.map +0 -1
- package/dist/chunk-AAUVNTWE.cjs.map +0 -1
- package/dist/chunk-E3ZMKMY7.js.map +0 -1
- package/dist/chunk-GA4LZZKQ.cjs.map +0 -1
- package/dist/chunk-GGIWDFER.cjs.map +0 -1
- package/dist/chunk-K2VWXAGK.js.map +0 -1
- package/dist/chunk-VQOUF4F5.js.map +0 -1
|
@@ -462,17 +462,28 @@ interface VoiceRemixInput {
|
|
|
462
462
|
}
|
|
463
463
|
/** Input for {@link VoicesResource.dub}. Provide exactly ONE source:
|
|
464
464
|
* `audioUrl` (dubbed audio out), `videoUrl` (the dubbed VIDEO out, plus the
|
|
465
|
-
* dubbed audio track as `output_data.audioUrl`), or `sourceUrl` (a
|
|
466
|
-
*
|
|
467
|
-
* of the dubbed span; the span is capped
|
|
468
|
-
* `startTime`/`endTime` to dub part of a longer source. */
|
|
465
|
+
* dubbed audio track as `output_data.audioUrl`), or `sourceUrl` (a link to
|
|
466
|
+
* a video's page, or a direct link to a file, that the dubbing service
|
|
467
|
+
* fetches itself). Priced per minute of the dubbed span; the span is capped
|
|
468
|
+
* at 30 minutes — use `startTime`/`endTime` to dub part of a longer source. */
|
|
469
469
|
interface DubbingInput {
|
|
470
470
|
/** URL of the audio to dub (audio mode). */
|
|
471
471
|
audioUrl?: string;
|
|
472
472
|
/** URL of the video to dub — the result is the dubbed VIDEO (+ audio track). */
|
|
473
473
|
videoUrl?: string;
|
|
474
|
-
/**
|
|
474
|
+
/**
|
|
475
|
+
* A link to a video's page, or a direct link to a file, that the dubbing
|
|
476
|
+
* service fetches itself: an import of that link, made under the content
|
|
477
|
+
* rights declaration (see `confirmationId`).
|
|
478
|
+
*/
|
|
475
479
|
sourceUrl?: string;
|
|
480
|
+
/**
|
|
481
|
+
* The content rights confirmation for `sourceUrl` (`contentRights.confirm()`).
|
|
482
|
+
* Without one, a deployment that requires a confirmation refuses the dub with
|
|
483
|
+
* `403`, unless the request comes through a key or an agent whose account
|
|
484
|
+
* holds a standing authorization.
|
|
485
|
+
*/
|
|
486
|
+
confirmationId?: string;
|
|
476
487
|
/** Target language ISO code (2–10 chars), e.g. `"es"`, `"pt-BR"`. */
|
|
477
488
|
targetLanguage: string;
|
|
478
489
|
/** Source language ISO code; auto-detected when omitted. */
|
package/dist/entries/voices.d.ts
CHANGED
|
@@ -462,17 +462,28 @@ interface VoiceRemixInput {
|
|
|
462
462
|
}
|
|
463
463
|
/** Input for {@link VoicesResource.dub}. Provide exactly ONE source:
|
|
464
464
|
* `audioUrl` (dubbed audio out), `videoUrl` (the dubbed VIDEO out, plus the
|
|
465
|
-
* dubbed audio track as `output_data.audioUrl`), or `sourceUrl` (a
|
|
466
|
-
*
|
|
467
|
-
* of the dubbed span; the span is capped
|
|
468
|
-
* `startTime`/`endTime` to dub part of a longer source. */
|
|
465
|
+
* dubbed audio track as `output_data.audioUrl`), or `sourceUrl` (a link to
|
|
466
|
+
* a video's page, or a direct link to a file, that the dubbing service
|
|
467
|
+
* fetches itself). Priced per minute of the dubbed span; the span is capped
|
|
468
|
+
* at 30 minutes — use `startTime`/`endTime` to dub part of a longer source. */
|
|
469
469
|
interface DubbingInput {
|
|
470
470
|
/** URL of the audio to dub (audio mode). */
|
|
471
471
|
audioUrl?: string;
|
|
472
472
|
/** URL of the video to dub — the result is the dubbed VIDEO (+ audio track). */
|
|
473
473
|
videoUrl?: string;
|
|
474
|
-
/**
|
|
474
|
+
/**
|
|
475
|
+
* A link to a video's page, or a direct link to a file, that the dubbing
|
|
476
|
+
* service fetches itself: an import of that link, made under the content
|
|
477
|
+
* rights declaration (see `confirmationId`).
|
|
478
|
+
*/
|
|
475
479
|
sourceUrl?: string;
|
|
480
|
+
/**
|
|
481
|
+
* The content rights confirmation for `sourceUrl` (`contentRights.confirm()`).
|
|
482
|
+
* Without one, a deployment that requires a confirmation refuses the dub with
|
|
483
|
+
* `403`, unless the request comes through a key or an agent whose account
|
|
484
|
+
* holds a standing authorization.
|
|
485
|
+
*/
|
|
486
|
+
confirmationId?: string;
|
|
476
487
|
/** Target language ISO code (2–10 chars), e.g. `"es"`, `"pt-BR"`. */
|
|
477
488
|
targetLanguage: string;
|
|
478
489
|
/** Source language ISO code; auto-detected when omitted. */
|
package/dist/entries/voices.js
CHANGED
package/dist/index.cjs
CHANGED
|
@@ -56,16 +56,16 @@ require('./chunk-IS26FJO7.cjs');
|
|
|
56
56
|
require('./chunk-RQSGS7ZK.cjs');
|
|
57
57
|
require('./chunk-43NO4SGC.cjs');
|
|
58
58
|
require('./chunk-JOX5BJ6K.cjs');
|
|
59
|
-
var
|
|
59
|
+
var chunkBYFLERF3_cjs = require('./chunk-BYFLERF3.cjs');
|
|
60
60
|
var chunkWUM6CWTE_cjs = require('./chunk-WUM6CWTE.cjs');
|
|
61
61
|
var chunkLKH5M44B_cjs = require('./chunk-LKH5M44B.cjs');
|
|
62
62
|
var chunkRKW3N463_cjs = require('./chunk-RKW3N463.cjs');
|
|
63
|
-
var
|
|
63
|
+
var chunkHVF5DRGQ_cjs = require('./chunk-HVF5DRGQ.cjs');
|
|
64
64
|
var chunkKMNSPC72_cjs = require('./chunk-KMNSPC72.cjs');
|
|
65
65
|
var chunkUPGZTLK7_cjs = require('./chunk-UPGZTLK7.cjs');
|
|
66
66
|
var chunkUIDVH3GP_cjs = require('./chunk-UIDVH3GP.cjs');
|
|
67
67
|
var chunkW5VHATSR_cjs = require('./chunk-W5VHATSR.cjs');
|
|
68
|
-
var
|
|
68
|
+
var chunk3CB4WYEY_cjs = require('./chunk-3CB4WYEY.cjs');
|
|
69
69
|
var chunk3B47IHB3_cjs = require('./chunk-3B47IHB3.cjs');
|
|
70
70
|
var chunkGB6C5OEZ_cjs = require('./chunk-GB6C5OEZ.cjs');
|
|
71
71
|
var chunkSYVNY3AH_cjs = require('./chunk-SYVNY3AH.cjs');
|
|
@@ -95,23 +95,23 @@ var chunkA3S55XGF_cjs = require('./chunk-A3S55XGF.cjs');
|
|
|
95
95
|
var chunkGRATHB3C_cjs = require('./chunk-GRATHB3C.cjs');
|
|
96
96
|
var chunkVUTNNRDW_cjs = require('./chunk-VUTNNRDW.cjs');
|
|
97
97
|
var chunkWUKIJJG2_cjs = require('./chunk-WUKIJJG2.cjs');
|
|
98
|
-
var
|
|
98
|
+
var chunkHW3CSUVC_cjs = require('./chunk-HW3CSUVC.cjs');
|
|
99
99
|
var chunkRR45WBME_cjs = require('./chunk-RR45WBME.cjs');
|
|
100
100
|
var chunk2DZWWIJ4_cjs = require('./chunk-2DZWWIJ4.cjs');
|
|
101
101
|
var chunkWK4VXPPZ_cjs = require('./chunk-WK4VXPPZ.cjs');
|
|
102
102
|
var chunk43FVH6LJ_cjs = require('./chunk-43FVH6LJ.cjs');
|
|
103
103
|
var chunkYFS2LMG4_cjs = require('./chunk-YFS2LMG4.cjs');
|
|
104
|
-
var
|
|
104
|
+
var chunk4DCXJ77J_cjs = require('./chunk-4DCXJ77J.cjs');
|
|
105
105
|
var chunkTBFA6QPH_cjs = require('./chunk-TBFA6QPH.cjs');
|
|
106
106
|
require('./chunk-KP2DIIKO.cjs');
|
|
107
|
-
var
|
|
107
|
+
var chunkGKTZHICS_cjs = require('./chunk-GKTZHICS.cjs');
|
|
108
108
|
var chunkP2JYDWZT_cjs = require('./chunk-P2JYDWZT.cjs');
|
|
109
109
|
var chunkA3XA6UNM_cjs = require('./chunk-A3XA6UNM.cjs');
|
|
110
110
|
var chunk4BAHF762_cjs = require('./chunk-4BAHF762.cjs');
|
|
111
111
|
var chunkJOXZ4ZIF_cjs = require('./chunk-JOXZ4ZIF.cjs');
|
|
112
|
-
var
|
|
113
|
-
var
|
|
114
|
-
var
|
|
112
|
+
var chunkPGT4BXR2_cjs = require('./chunk-PGT4BXR2.cjs');
|
|
113
|
+
var chunkXSYNVD3X_cjs = require('./chunk-XSYNVD3X.cjs');
|
|
114
|
+
var chunkC3LJ7HIH_cjs = require('./chunk-C3LJ7HIH.cjs');
|
|
115
115
|
var chunkBPWUWUZ3_cjs = require('./chunk-BPWUWUZ3.cjs');
|
|
116
116
|
var chunkXZQ6Z4T6_cjs = require('./chunk-XZQ6Z4T6.cjs');
|
|
117
117
|
|
|
@@ -151,11 +151,11 @@ Object.defineProperty(exports, "unwrapEditPlanOutput", {
|
|
|
151
151
|
});
|
|
152
152
|
Object.defineProperty(exports, "NodaroClient", {
|
|
153
153
|
enumerable: true,
|
|
154
|
-
get: function () { return
|
|
154
|
+
get: function () { return chunkBYFLERF3_cjs.NodaroClient; }
|
|
155
155
|
});
|
|
156
156
|
Object.defineProperty(exports, "createClient", {
|
|
157
157
|
enumerable: true,
|
|
158
|
-
get: function () { return
|
|
158
|
+
get: function () { return chunkBYFLERF3_cjs.createClient; }
|
|
159
159
|
});
|
|
160
160
|
Object.defineProperty(exports, "WorkflowsResource", {
|
|
161
161
|
enumerable: true,
|
|
@@ -171,7 +171,7 @@ Object.defineProperty(exports, "TrendRadarResource", {
|
|
|
171
171
|
});
|
|
172
172
|
Object.defineProperty(exports, "TrendsResource", {
|
|
173
173
|
enumerable: true,
|
|
174
|
-
get: function () { return
|
|
174
|
+
get: function () { return chunkHVF5DRGQ_cjs.TrendsResource; }
|
|
175
175
|
});
|
|
176
176
|
Object.defineProperty(exports, "TutorialsResource", {
|
|
177
177
|
enumerable: true,
|
|
@@ -191,7 +191,7 @@ Object.defineProperty(exports, "VideoProResource", {
|
|
|
191
191
|
});
|
|
192
192
|
Object.defineProperty(exports, "VoicesResource", {
|
|
193
193
|
enumerable: true,
|
|
194
|
-
get: function () { return
|
|
194
|
+
get: function () { return chunk3CB4WYEY_cjs.VoicesResource; }
|
|
195
195
|
});
|
|
196
196
|
Object.defineProperty(exports, "WebhooksResource", {
|
|
197
197
|
enumerable: true,
|
|
@@ -391,7 +391,7 @@ Object.defineProperty(exports, "GalleryResource", {
|
|
|
391
391
|
});
|
|
392
392
|
Object.defineProperty(exports, "JobsResource", {
|
|
393
393
|
enumerable: true,
|
|
394
|
-
get: function () { return
|
|
394
|
+
get: function () { return chunkHW3CSUVC_cjs.JobsResource; }
|
|
395
395
|
});
|
|
396
396
|
Object.defineProperty(exports, "KEEPER_KINDS", {
|
|
397
397
|
enumerable: true,
|
|
@@ -419,7 +419,7 @@ Object.defineProperty(exports, "CompetitorsResource", {
|
|
|
419
419
|
});
|
|
420
420
|
Object.defineProperty(exports, "ContentRightsResource", {
|
|
421
421
|
enumerable: true,
|
|
422
|
-
get: function () { return
|
|
422
|
+
get: function () { return chunk4DCXJ77J_cjs.ContentRightsResource; }
|
|
423
423
|
});
|
|
424
424
|
Object.defineProperty(exports, "CopilotResource", {
|
|
425
425
|
enumerable: true,
|
|
@@ -427,19 +427,19 @@ Object.defineProperty(exports, "CopilotResource", {
|
|
|
427
427
|
});
|
|
428
428
|
Object.defineProperty(exports, "CallbackAuth", {
|
|
429
429
|
enumerable: true,
|
|
430
|
-
get: function () { return
|
|
430
|
+
get: function () { return chunkGKTZHICS_cjs.CallbackAuth; }
|
|
431
431
|
});
|
|
432
432
|
Object.defineProperty(exports, "NodaroClientCore", {
|
|
433
433
|
enumerable: true,
|
|
434
|
-
get: function () { return
|
|
434
|
+
get: function () { return chunkGKTZHICS_cjs.NodaroClientCore; }
|
|
435
435
|
});
|
|
436
436
|
Object.defineProperty(exports, "StaticTokenAuth", {
|
|
437
437
|
enumerable: true,
|
|
438
|
-
get: function () { return
|
|
438
|
+
get: function () { return chunkGKTZHICS_cjs.StaticTokenAuth; }
|
|
439
439
|
});
|
|
440
440
|
Object.defineProperty(exports, "supabaseAuth", {
|
|
441
441
|
enumerable: true,
|
|
442
|
-
get: function () { return
|
|
442
|
+
get: function () { return chunkGKTZHICS_cjs.supabaseAuth; }
|
|
443
443
|
});
|
|
444
444
|
Object.defineProperty(exports, "AlreadyRunningError", {
|
|
445
445
|
enumerable: true,
|
|
@@ -579,15 +579,15 @@ Object.defineProperty(exports, "AppsResource", {
|
|
|
579
579
|
});
|
|
580
580
|
Object.defineProperty(exports, "AudioResource", {
|
|
581
581
|
enumerable: true,
|
|
582
|
-
get: function () { return
|
|
582
|
+
get: function () { return chunkPGT4BXR2_cjs.AudioResource; }
|
|
583
583
|
});
|
|
584
584
|
Object.defineProperty(exports, "BillingResource", {
|
|
585
585
|
enumerable: true,
|
|
586
|
-
get: function () { return
|
|
586
|
+
get: function () { return chunkXSYNVD3X_cjs.BillingResource; }
|
|
587
587
|
});
|
|
588
588
|
Object.defineProperty(exports, "CastSwapResource", {
|
|
589
589
|
enumerable: true,
|
|
590
|
-
get: function () { return
|
|
590
|
+
get: function () { return chunkC3LJ7HIH_cjs.CastSwapResource; }
|
|
591
591
|
});
|
|
592
592
|
Object.defineProperty(exports, "CatalogsResource", {
|
|
593
593
|
enumerable: true,
|
package/dist/index.d.cts
CHANGED
|
@@ -20,7 +20,7 @@ export { ApplyEdlInput, AudioSyncInput, AudioSyncOffset, AudioSyncResult, AudioS
|
|
|
20
20
|
export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, CreditCapCode, CreditCapExceededError, ForbiddenError, HeldFinalRun, IMPORT_REFUSAL_CODES, ImportRefusalCode, ImportRefusedError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, MODEL_UNAVAILABLE_CODES, ModelUnavailableCode, ModelUnavailableError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictCode, WorkflowConflictError, throwFromResponse } from './entries/errors.cjs';
|
|
21
21
|
export { CancelExecutionParams, ExecutionStatus, ExecutionTriggerType, ExecutionsResource, ListExecutionsForWorkflowParams, ListExecutionsPage, NodeExecutionState, WorkflowExecution, WorkflowExecutionSummary } from './entries/executions.cjs';
|
|
22
22
|
export { BrowseGalleryParams, GalleryItem, GalleryMediaType, GalleryPage, GalleryResource, ToggleFavoriteResult } from './entries/gallery.cjs';
|
|
23
|
-
export { CancelJobResult, CreditStatus, CreditsHint, DeleteJobResult, InputRefusedHint, Job, JobErrorHint, JobFromUploadParams, JobQueueInfo, JobRating, JobRatingFilter, JobSessionRef, JobSource, JobStatus, JobStatusResult, JobsResource, ListJobsPage, ListJobsParams, PolicyBlockHint, QueueTimeoutHint, RateJobResult, SafetyBlockHint } from './entries/jobs.cjs';
|
|
23
|
+
export { CancelJobResult, CreditStatus, CreditsHint, DeleteJobResult, InputRefusedHint, Job, JobErrorHint, JobFromUploadParams, JobQueueInfo, JobRating, JobRatingFilter, JobSessionRef, JobSource, JobStatus, JobStatusResult, JobsResource, ListJobsPage, ListJobsParams, PolicyBlockHint, QueueTimeoutHint, RateJobResult, RequestRefusedHint, SafetyBlockHint } from './entries/jobs.cjs';
|
|
24
24
|
export { CopyKeeperResult, KEEPER_KINDS, KeeperCatalogItem, KeeperCatalogPage, KeeperCatalogParams, KeeperKind, KeepersResource, SetKeeperCatalogInput, SetKeeperCatalogResult } from './entries/keepers.cjs';
|
|
25
25
|
export { LibraryAsset, LibraryResource, ListLibraryParams, ListLibraryResult } from './entries/library.cjs';
|
|
26
26
|
export { LlmResource, LlmStructuredInput, LlmStructuredJobInput, LlmStructuredJobOutput, LlmStructuredResult } from './entries/llm.cjs';
|
package/dist/index.d.ts
CHANGED
|
@@ -20,7 +20,7 @@ export { ApplyEdlInput, AudioSyncInput, AudioSyncOffset, AudioSyncResult, AudioS
|
|
|
20
20
|
export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, CreditCapCode, CreditCapExceededError, ForbiddenError, HeldFinalRun, IMPORT_REFUSAL_CODES, ImportRefusalCode, ImportRefusedError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, MODEL_UNAVAILABLE_CODES, ModelUnavailableCode, ModelUnavailableError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictCode, WorkflowConflictError, throwFromResponse } from './entries/errors.js';
|
|
21
21
|
export { CancelExecutionParams, ExecutionStatus, ExecutionTriggerType, ExecutionsResource, ListExecutionsForWorkflowParams, ListExecutionsPage, NodeExecutionState, WorkflowExecution, WorkflowExecutionSummary } from './entries/executions.js';
|
|
22
22
|
export { BrowseGalleryParams, GalleryItem, GalleryMediaType, GalleryPage, GalleryResource, ToggleFavoriteResult } from './entries/gallery.js';
|
|
23
|
-
export { CancelJobResult, CreditStatus, CreditsHint, DeleteJobResult, InputRefusedHint, Job, JobErrorHint, JobFromUploadParams, JobQueueInfo, JobRating, JobRatingFilter, JobSessionRef, JobSource, JobStatus, JobStatusResult, JobsResource, ListJobsPage, ListJobsParams, PolicyBlockHint, QueueTimeoutHint, RateJobResult, SafetyBlockHint } from './entries/jobs.js';
|
|
23
|
+
export { CancelJobResult, CreditStatus, CreditsHint, DeleteJobResult, InputRefusedHint, Job, JobErrorHint, JobFromUploadParams, JobQueueInfo, JobRating, JobRatingFilter, JobSessionRef, JobSource, JobStatus, JobStatusResult, JobsResource, ListJobsPage, ListJobsParams, PolicyBlockHint, QueueTimeoutHint, RateJobResult, RequestRefusedHint, SafetyBlockHint } from './entries/jobs.js';
|
|
24
24
|
export { CopyKeeperResult, KEEPER_KINDS, KeeperCatalogItem, KeeperCatalogPage, KeeperCatalogParams, KeeperKind, KeepersResource, SetKeeperCatalogInput, SetKeeperCatalogResult } from './entries/keepers.js';
|
|
25
25
|
export { LibraryAsset, LibraryResource, ListLibraryParams, ListLibraryResult } from './entries/library.js';
|
|
26
26
|
export { LlmResource, LlmStructuredInput, LlmStructuredJobInput, LlmStructuredJobOutput, LlmStructuredResult } from './entries/llm.js';
|
package/dist/index.js
CHANGED
|
@@ -54,16 +54,16 @@ import './chunk-M6Y5TOYE.js';
|
|
|
54
54
|
import './chunk-KARJ7P7Y.js';
|
|
55
55
|
import './chunk-SUCHGNYT.js';
|
|
56
56
|
import './chunk-SLPD47SR.js';
|
|
57
|
-
export { NodaroClient, createClient } from './chunk-
|
|
57
|
+
export { NodaroClient, createClient } from './chunk-K2QVR3LG.js';
|
|
58
58
|
export { WorkflowsResource } from './chunk-33HT46A3.js';
|
|
59
59
|
export { WorkspacesResource } from './chunk-Z5GLY4R3.js';
|
|
60
60
|
export { TrendRadarResource } from './chunk-TLTPIS2A.js';
|
|
61
|
-
export { TrendsResource } from './chunk-
|
|
61
|
+
export { TrendsResource } from './chunk-OVFH7L2T.js';
|
|
62
62
|
export { TutorialsResource } from './chunk-HPXE3NZW.js';
|
|
63
63
|
export { UploadsResource } from './chunk-P2C33IOF.js';
|
|
64
64
|
export { UserSettingsResource } from './chunk-LR5TGCJP.js';
|
|
65
65
|
export { VideoProResource } from './chunk-ERLXU47J.js';
|
|
66
|
-
export { VoicesResource } from './chunk-
|
|
66
|
+
export { VoicesResource } from './chunk-CRIQLLR2.js';
|
|
67
67
|
export { WebhooksResource } from './chunk-YN6CBIIB.js';
|
|
68
68
|
export { ReduceResource } from './chunk-IHKIYVZQ.js';
|
|
69
69
|
export { SavedPostsResource } from './chunk-NCCBS6GU.js';
|
|
@@ -93,23 +93,23 @@ export { DeveloperAppsResource } from './chunk-65E3JBFZ.js';
|
|
|
93
93
|
export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from './chunk-T23YD5BR.js';
|
|
94
94
|
export { ExecutionsResource, OUTPUT_BEARING_NODE_STATUSES, nodeStateMayCarryOutput } from './chunk-22XXTB2R.js';
|
|
95
95
|
export { GalleryResource } from './chunk-JDEZHITT.js';
|
|
96
|
-
export { JobsResource } from './chunk-
|
|
96
|
+
export { JobsResource } from './chunk-SVWEWBXI.js';
|
|
97
97
|
export { KEEPER_KINDS, KeepersResource } from './chunk-MQWZFWHE.js';
|
|
98
98
|
export { LibraryResource } from './chunk-P6E4QDJN.js';
|
|
99
99
|
export { CollectionsResource } from './chunk-4WRDR4GN.js';
|
|
100
100
|
export { CommunityResource } from './chunk-SFB4YLCS.js';
|
|
101
101
|
export { CompetitorsResource } from './chunk-BU5A6K4C.js';
|
|
102
|
-
export { ContentRightsResource } from './chunk-
|
|
102
|
+
export { ContentRightsResource } from './chunk-HAS6PMQN.js';
|
|
103
103
|
export { CopilotResource } from './chunk-MQRPXZW5.js';
|
|
104
104
|
import './chunk-A75Q7UEU.js';
|
|
105
|
-
export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from './chunk-
|
|
105
|
+
export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from './chunk-HW6U7WXU.js';
|
|
106
106
|
export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, CreditCapExceededError, ForbiddenError, IMPORT_REFUSAL_CODES, ImportRefusedError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, MODEL_UNAVAILABLE_CODES, ModelUnavailableError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictError, throwFromResponse } from './chunk-WNXX3B2A.js';
|
|
107
107
|
export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ASSET_TYPES, CREATURE_ATTACH_COLUMNS, CreaturesResource } from './chunk-HUYI5G3D.js';
|
|
108
108
|
export { CreditsResource } from './chunk-7QK2NXJA.js';
|
|
109
109
|
export { AppsResource } from './chunk-7LODCIQK.js';
|
|
110
|
-
export { AudioResource } from './chunk-
|
|
111
|
-
export { BillingResource } from './chunk-
|
|
112
|
-
export { CastSwapResource } from './chunk-
|
|
110
|
+
export { AudioResource } from './chunk-OHC4JIUP.js';
|
|
111
|
+
export { BillingResource } from './chunk-MCXZV3CW.js';
|
|
112
|
+
export { CastSwapResource } from './chunk-3TRBBYSN.js';
|
|
113
113
|
export { CatalogsResource } from './chunk-KG4R454Z.js';
|
|
114
114
|
export { CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, CharactersResource, PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints, buildPersonSeedPrompt } from './chunk-CBDUHYTR.js';
|
|
115
115
|
//# sourceMappingURL=index.js.map
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nodaro/sdk",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.65.1",
|
|
4
4
|
"description": "Typed REST client for the Nodaro API — workflows, jobs, executions, apps, characters, and more.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -332,8 +332,8 @@
|
|
|
332
332
|
"test:watch": "vitest"
|
|
333
333
|
},
|
|
334
334
|
"dependencies": {
|
|
335
|
-
"@nodaro/shared": "^3.
|
|
336
|
-
"@nodaro/prompts": "^1.
|
|
335
|
+
"@nodaro/shared": "^3.55.0",
|
|
336
|
+
"@nodaro/prompts": "^1.50.1"
|
|
337
337
|
},
|
|
338
338
|
"peerDependencies": {
|
|
339
339
|
"@fingerprintjs/fingerprintjs": "^5.2.0",
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/resources/content-rights.ts"],"names":[],"mappings":";;;AA8CO,IAAM,wBAAN,MAA4B;AAAA,EACjC,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,MAAM,WAAA,GAAiD;AACrD,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAA4C,OAAO,gCAAgC,CAAA;AACjH,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAQ,KAAA,EAAwF;AACpG,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAA6C,QAAQ,4BAAA,EAA8B,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAChI,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,aAAA,GAA4D;AAChE,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAqD,OAAO,kCAAkC,CAAA;AAC5H,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,UAAU,KAAA,EAA4E;AAC1F,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAA8C,QAAQ,kCAAA,EAAoC,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AACvI,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA,EAGA,MAAM,mBAAA,GAAqD;AACzD,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAwC,UAAU,kCAAkC,CAAA;AAClH,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AACF","file":"chunk-3OARKXWT.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Content rights — the declaration a person confirms before a link is\n * imported, and the confirmation a download then carries. Mirrors\n * `/v1/content-rights/*` (`backend/src/routes/content-rights.ts`).\n *\n * The flow: show {@link ContentRightsResource.declaration}'s text with a\n * checkbox, call {@link ContentRightsResource.confirm} with the link once it\n * is ticked, and pass the answered `id` as `confirmationId` to\n * `media.downloadVideo`. One confirmation is good for one download of that\n * link, by the same account, within an hour. Whether a download WITHOUT a\n * confirmation is refused is the deployment's setting\n * (`content_rights_required`); a client always sends one.\n *\n * An import through an API key or an AI agent has nobody to tick a box: the\n * person authorizes those imports ONCE, in their own session, with\n * {@link ContentRightsResource.authorize} (the standing authorization), and\n * every such import is then recorded as a confirmation derived from it.\n * {@link ContentRightsResource.authorization} reads the current one and\n * {@link ContentRightsResource.revokeAuthorization} ends it.\n */\n\nexport interface ContentRightsDeclaration {\n /** The declaration's version; a confirmation names the version it agreed to. */\n version: number\n /** The text the person confirms, verbatim. */\n text: string\n}\n\nexport interface ContentRightsConfirmation {\n /** The id a download carries as `confirmationId`. */\n id: string\n declarationVersion: number\n /** After this the confirmation no longer opens a download (ISO 8601). */\n expiresAt: string\n}\n\nexport interface ContentRightsAuthorization {\n id: string\n /** The declaration version the person authorized; a newer declaration asks for a new authorization. */\n declarationVersion: number\n /** When it was given (ISO 8601). */\n createdAt: string\n}\n\nexport class ContentRightsResource {\n constructor(private client: NodaroClientCore) {}\n\n /** `GET /v1/content-rights/declaration` → the current text and its version. Public: needs no credential. */\n async declaration(): Promise<ContentRightsDeclaration> {\n const res = await this.client.request<{ data: ContentRightsDeclaration }>(\"GET\", \"/v1/content-rights/declaration\")\n return res.data\n }\n\n /**\n * `POST /v1/content-rights/confirm` → the confirmation for one link, under\n * the declaration version the person saw. `409 rights_confirmation_stale`\n * when the declaration changed since: read it again and ask again.\n */\n async confirm(input: { url: string; declarationVersion: number }): Promise<ContentRightsConfirmation> {\n const res = await this.client.request<{ data: ContentRightsConfirmation }>(\"POST\", \"/v1/content-rights/confirm\", { body: input })\n return res.data\n }\n\n /**\n * `GET /v1/content-rights/authorization` → the account's standing\n * authorization for imports through its API keys and AI agents, or `null`\n * when there is none (never given, revoked, or given under an older\n * declaration than the current one).\n */\n async authorization(): Promise<ContentRightsAuthorization | null> {\n const res = await this.client.request<{ data: ContentRightsAuthorization | null }>(\"GET\", \"/v1/content-rights/authorization\")\n return res.data\n }\n\n /**\n * `POST /v1/content-rights/authorization` → records that the person\n * authorized imports through their keys and agents under the declaration\n * version they saw. The person's own session only: a key or an agent\n * answers `403 forbidden`. `409 rights_confirmation_stale` when the\n * declaration changed since: read it again and ask again.\n */\n async authorize(input: { declarationVersion: number }): Promise<ContentRightsAuthorization> {\n const res = await this.client.request<{ data: ContentRightsAuthorization }>(\"POST\", \"/v1/content-rights/authorization\", { body: input })\n return res.data\n }\n\n /** `DELETE /v1/content-rights/authorization` → revokes the standing authorization (the record stays). The person's own session only. */\n async revokeAuthorization(): Promise<{ revoked: boolean }> {\n const res = await this.client.request<{ data: { revoked: boolean } }>(\"DELETE\", \"/v1/content-rights/authorization\")\n return res.data\n }\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/resources/audio.ts"],"names":[],"mappings":";AA+CO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpB,SAAS,KAAA,EAAoI;AAC3I,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,wBAAwB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC/F;AAAA;AAAA,EAGA,QAAQ,KAAA,EAAyD;AAC/D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,uBAAuB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC9F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QAAQ,KAAA,EAQuB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,gBAAgB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACvF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,IAAI,KAAA,EAY2B;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,iBAAiB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACxF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,KAAA,EAOkB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,qBAAqB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC5F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,KAAA,EAMoB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,mBAAmB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC1F;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAAQ,KAAA,EAA+G;AACrH,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,qBAAqB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC5F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,WAAW,KAAA,EAOoB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,kBAAkB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACzF;AACF","file":"chunk-3QFTP5P5.js","sourcesContent":["import type { AudioFxPreset } from \"@nodaro/shared/media\"\nimport type { TranscribeProvider } from \"@nodaro/shared/models\"\nimport type { Transcript } from \"@nodaro/shared/edl\"\nexport type { TranscribeProvider } from \"@nodaro/shared/models\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * One word of a {@link AudioResource.transcribe} result — caption-shaped, in\n * MILLISECONDS, and structurally the `captions[]` entry `media.addCaptions()`\n * takes, so a word list can be passed straight through. `speaker` is present\n * only on a diarized `elevenlabs-stt` run.\n */\nexport interface TranscribeWord {\n text: string\n startMs: number\n endMs: number\n timestampMs?: number | null\n confidence?: number | null\n speaker?: string\n}\n\n/**\n * A completed transcribe job's `output_data` (read it off `jobs.get(jobId)`).\n *\n * Mind the units: `words` and `json.words` are in MILLISECONDS, while the\n * top-level `segments` are in SECONDS (the raw per-utterance ranges) — present\n * only on the legacy lanes; `elevenlabs-stt` returns none, so read `words`.\n */\nexport interface TranscribeJobOutput {\n /** The full transcript as one string. */\n text: string\n /** Detected (or requested) language code. */\n language?: string\n /** Per-word timings, ms — present on the word-level lanes. */\n words?: TranscribeWord[]\n /** The normalized {@link Transcript} (ms), the shape `edit.*` consumes. */\n json?: Transcript\n /** Per-utterance ranges in SECONDS — not ms, unlike everything above. */\n segments?: Array<{ start: number; end: number; text: string }>\n}\n\n/**\n * Audio primitives — the building blocks Voice Changer Pro composes internally\n * (separation, isolation, effect, mix, level) plus speech-to-text, exposed\n * standalone so a consumer can run any single step or assemble its own\n * pipeline. Each returns a job id to poll (`jobs.get(jobId)`).\n */\nexport class AudioResource {\n constructor(private client: NodaroClientCore) {}\n\n /**\n * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).\n * `mode` `\"vocal_instrumental\"` (default) splits voice from music/SFX;\n * `\"stems\"` returns the full drums/bass/other/… breakdown. `quality`\n * `auto` (default) / `fast` / `best`.\n */\n separate(input: { audioUrl: string; mode?: \"vocal_instrumental\" | \"stems\"; quality?: \"auto\" | \"fast\" | \"best\" }): Promise<{ jobId: string }> {\n return this.client.request<{ jobId: string }>(\"POST\", \"/v1/audio-separation\", { body: input })\n }\n\n /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */\n isolate(input: { audioUrl: string }): Promise<{ jobId: string }> {\n return this.client.request<{ jobId: string }>(\"POST\", \"/v1/audio-isolation\", { body: input })\n }\n\n /**\n * Apply a reverb / echo / telephone / megaphone effect to an audio track\n * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.\n * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;\n * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.\n */\n applyFx(input: {\n audioUrl: string\n preset?: AudioFxPreset\n mix?: number\n delayMs?: number\n decay?: number\n eqLow?: number\n eqHigh?: number\n }): Promise<{ jobId: string }> {\n return this.client.request<{ jobId: string }>(\"POST\", \"/v1/audio-fx\", { body: input })\n }\n\n /**\n * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`\n * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set\n * per-track level. `duck` puts a music bed under speech: every track EXCEPT\n * `duck.under` (the 0-based index of the voice track) dips while that track\n * is loud and rises back in its pauses (sidechain compression). `amount`\n * (0–100, default 75) is how hard; `thresholdDb` (-60–0, default -30),\n * `ratio` (1–20, overrides `amount`), `attackMs` (1–2000, default 20) and\n * `releaseMs` (10–9000, default 500) are optional fine controls. A ducked mix\n * sums its tracks rather than averaging them, so the voice keeps its level;\n * the price is the same with or without a duck. `endAt` (`\"longest\"`, the\n * default, or `\"voice\"`) says where the mix ends: `\"voice\"` ends it when the\n * voice (the `duck.under` track) ends (needs `duck`). A video URL is a track\n * too: its audio is mixed, and a video with no sound is a silent track.\n */\n mix(input: {\n audioUrls: string[]\n trackVolumes?: number[]\n duck?: {\n under: number\n amount?: number\n thresholdDb?: number\n ratio?: number\n attackMs?: number\n releaseMs?: number\n }\n endAt?: \"longest\" | \"voice\"\n }): Promise<{ jobId: string }> {\n return this.client.request<{ jobId: string }>(\"POST\", \"/v1/mix-audio\", { body: input })\n }\n\n /**\n * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):\n * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`\n * seconds. Provide `audioUrl` or `videoUrl`.\n */\n adjustVolume(input: {\n audioUrl?: string\n videoUrl?: string\n volume?: number\n normalize?: boolean\n fadeIn?: number\n fadeOut?: number\n }): Promise<{ jobId: string }> {\n return this.client.request<{ jobId: string }>(\"POST\", \"/v1/adjust-volume\", { body: input })\n }\n\n /**\n * Shift pitch and/or change tempo with Rubber Band (`POST /v1/pitch-tempo`):\n * `semitones` −12…+12 (default 0), `tempo` 0.5…2 with the pitch kept\n * (default 1; fixed at 1 for a video), `preserveFormants` (default true).\n * Provide exactly one of `audioUrl` or `videoUrl` — a video keeps its picture.\n * Input up to 30 minutes, priced per started minute.\n */\n pitchTempo(input: {\n audioUrl?: string\n videoUrl?: string\n semitones?: number\n tempo?: number\n preserveFormants?: boolean\n }): Promise<{ jobId: string }> {\n return this.client.request<{ jobId: string }>(\"POST\", \"/v1/pitch-tempo\", { body: input })\n }\n\n /**\n * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each\n * segment is a `url` with an optional `[startTime, endTime]` sub-range.\n */\n combine(input: { segments: Array<{ url: string; startTime?: number; endTime?: number }> }): Promise<{ jobId: string }> {\n return this.client.request<{ jobId: string }>(\"POST\", \"/v1/combine-audio\", { body: input })\n }\n\n /**\n * Transcribe an audio (or video) track to text (`POST /v1/transcribe`).\n *\n * Three engines are accepted. `elevenlabs-stt` (Scribe) is always word-level,\n * flag or not, and is the only lane that honours `diarize` (who spoke) and\n * `tagAudioEvents` (laughter, applause, …); `incredibly-fast-whisper` returns\n * word timings when you ask for them. `whisper` returns NO word timings at\n * all — named explicitly or reached by OMITTING `provider`, which still falls\n * back to it — so asking it for them (`wordTimestamps: true`) is rejected with\n * a `400 validation_error` at ingress, before any credit is spent. A kinetic\n * caption render therefore has to name one of the other two.\n *\n * Poll `jobs.get(jobId)`; the finished job's `output_data` is a\n * {@link TranscribeJobOutput}: `text` (the whole transcript), `words`\n * (caption-shaped, in MILLISECONDS), `json` (the normalized\n * {@link Transcript}, also ms) — and a top-level `segments` array that is in\n * SECONDS, not ms.\n *\n * `words` is the caption source for a kinetic burn-in: hand it to\n * `media.addCaptions()` as `captions` with `autoTranscribe: false` and the\n * render uses those exact words (correct the `text` of an entry in between\n * and the fix is what burns in).\n */\n transcribe(input: {\n audioUrl: string\n provider?: TranscribeProvider\n language?: string\n diarize?: boolean\n tagAudioEvents?: boolean\n wordTimestamps?: boolean\n }): Promise<{ jobId: string }> {\n return this.client.request<{ jobId: string }>(\"POST\", \"/v1/transcribe\", { body: input })\n }\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/resources/jobs.ts"],"names":[],"mappings":";;;AAgXA,SAAS,UAAU,KAAA,EAAmE;AACpF,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,MAAA;AAChC,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,KAAA,CAAM,KAAK,GAAG,CAAA;AAC3D;AAkCO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAI,EAAA,EAAoC;AACtC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,IAAA,CAAK,MAAA,GAAyB,EAAC,EAA0B;AACvD,IAAA,MAAM,EAAE,QAAQ,IAAA,EAAM,MAAA,EAAQ,WAAW,YAAA,EAAc,GAAG,MAAK,GAAI,MAAA;AACnE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAsB,KAAA,EAAO,UAAA,EAAY;AAAA,MAC1D,KAAA,EAAO;AAAA,QACL,GAAG,IAAA;AAAA,QACH,MAAA,EAAQ,UAAU,MAAM,CAAA;AAAA,QACxB,IAAA,EAAM,UAAU,IAAI,CAAA;AAAA,QACpB,MAAA,EAAQ,UAAU,MAAM,CAAA;AAAA,QACxB,SAAA,EAAW,SAAA,KAAc,MAAA,GAAY,MAAA,GAAY,OAAO,SAAS,CAAA;AAAA,QACjE,YAAA,EAAc,eAAe,MAAA,GAAS;AAAA;AACxC,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,WAAW,MAAA,EAAqD;AAC9D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAuB,MAAA,EAAQ,wBAAwB,EAAE,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC5F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAA,CAAK,IAAY,MAAA,EAAkD;AACjE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAuB,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA,CAAA,EAAW;AAAA,MAC5F,IAAA,EAAM,EAAE,MAAA;AAAO,KAChB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,EAAA,EAAgD;AACxD,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,OAAO,EAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,MAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAA,CAAO,EAAA,EAAY,OAAA,GAAiC,EAAC,EAA6B;AAChF,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,QAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AAAA,MAClC,OAAA,CAAQ,UAAU,EAAE,KAAA,EAAO,EAAE,OAAA,EAAS,MAAA,EAAO,EAAE,GAAI;AAAC,KACtD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAQ,EAAA,EAAwC;AAC9C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,QAAA,CAAU,CAAA;AAAA,EACjF;AACF","file":"chunk-5LI4CVJB.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * A job's lifecycle status. Hand-copied mirror of `JOB_STATUSES` in the\n * platform's `backend/src/lib/job-status.ts` — nothing links the two at build\n * time, so a new member has to be added here in the same change.\n *\n * `pending_review` is IN-FLIGHT, NOT TERMINAL: a job policy registered by the\n * deployment held the output for a human reviewer. Treat it like `processing`\n * in a `switch` — keep waiting, do not re-run — and it resolves to `completed`\n * (approved), `failed` (rejected, carrying an `error_hint` with\n * `kind: \"policy-block\"`) or `cancelled` (a held job is cancellable like any\n * in-flight job). `credit_status` reads `\"reserved\"` for the whole hold. Only\n * appears on deployments that register a job policy; `runAndWait` throws\n * {@link JobHeldError} on the first held tick rather than waiting it out.\n */\nexport type JobStatus =\n | \"pending\"\n | \"queued\"\n | \"processing\"\n | \"pending_review\"\n | \"completed\"\n | \"failed\"\n | \"cancelled\"\n\n/**\n * A PROVIDER's verdict: the model's own safety filter refused the output.\n * `class` distinguishes a deterministic block (copyright/likeness — retrying\n * the same request never helps) from `safety`, whose filter is known to be\n * non-deterministic for some models: `retried` says whether the worker\n * already spent its one extra attempt, and `suggestedProvider` — present\n * only when the catalog declares a fallback for the model that failed — is a\n * real model id the SAME prompt/references can be retried on.\n */\nexport type SafetyBlockHint = {\n kind: \"safety-block\"\n class: \"copyright\" | \"likeness\" | \"safety\"\n retried: boolean\n suggestedProvider?: string\n /**\n * Present when the provider named the input it refused — not the prompt or\n * the output. `\"input_video\"`: the input video itself; sending a different\n * clip is the fix. `\"input_image\"`: one of the input images, refused as\n * possibly copyrighted (with `class: \"copyright\"`); sending a different\n * picture is the fix. Treat an unknown value as absent.\n */\n subject?: \"input_video\" | \"input_image\"\n}\n\n/**\n * A NODARO-side verdict, not a provider's: a job policy registered by the\n * deployment rejected the request (`hookPoint: \"request\"` — nothing ran, and\n * the call itself failed with {@link JobBlockedError}) or the finished output\n * (`hookPoint: \"result\"` — the result was blocked and never published).\n *\n * `reason` is USER-SAFE BY CONTRACT — the platform guarantees the policy's\n * machine text (scores, labels) never reaches it — so show it to the person\n * who made the request as-is. `policyId` identifies the deployment's policy,\n * not a Nodaro product feature. Only occurs on deployments that register a\n * job policy.\n */\nexport type PolicyBlockHint = {\n kind: \"policy-block\"\n policyId: string\n reason: string\n hookPoint: \"request\" | \"result\"\n}\n\n/**\n * The job ran out of credits partway: a step that reserves its own credits\n * (for example, the video a Cast Swap or trend run dispatches) was refused —\n * the balance could not cover it, or a plan or workspace cap was reached. The\n * job failed and its credits were refunded; ask the person to top up (or raise\n * the cap), then run it again.\n *\n * `code` is the refusal's own code, a lowercase snake_case token — for\n * example `insufficient_credits`, `free_video_limit`, `instance_cap_reached`,\n * `budget_exceeded`, `member_cap_exceeded` or `user_allowance_exceeded`. Treat\n * an unknown code like `insufficient_credits`.\n */\nexport type CreditsHint = {\n kind: \"credits\"\n code: string\n}\n\n/**\n * The provider refused the job's input video without naming a content-policy\n * class (its message is about the file, not a policy). Treat it like any\n * other failure — no fallback model is offered — except that the input to\n * change is known: send a different clip.\n */\nexport type InputRefusedHint = {\n kind: \"input-refused\"\n subject: \"input_video\"\n}\n\n/**\n * The job never got a slot to run in, so it did not run, and its credits were\n * refunded. `reason`: `timeout` — it waited longer than the platform's queue\n * timeout for one of the account's concurrency slots; `lost` — its place in\n * line was lost and could not be restored; `live-wait` — a synchronous call\n * could not get a slot within its wait limit. `waitedMinutes` is the whole\n * minutes it waited, rounded down. Run it again; treat an unknown `reason`\n * like `timeout`.\n */\nexport type QueueTimeoutHint = {\n kind: \"queue-timeout\"\n reason: \"timeout\" | \"lost\" | \"live-wait\"\n waitedMinutes: number\n}\n\n/**\n * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable\n * failure verdict, so a caller can act on it without parsing `error_message`\n * prose. One column, several verdict sources; `kind` is the discriminant.\n *\n * HAND-COPIED MIRROR of `ErrorHint` in the platform's\n * `backend/src/lib/safety-block.ts` (which names this file in its own\n * comment). Nothing links the two at build time: a new arm there has to be\n * pasted here verbatim in the same change, with a changeset.\n * `packages/client/dist/index.d.ts` is REBUILT, never hand-edited.\n */\nexport type JobErrorHint = SafetyBlockHint | PolicyBlockHint | CreditsHint | InputRefusedHint | QueueTimeoutHint\n\n/**\n * The billing lifecycle of a job's credit reservation — `usage_logs.status`\n * for the job's `usage_log_id`. `null` when the job has no usage log (e.g. a\n * free run) or hasn't reserved credits yet.\n */\nexport type CreditStatus = \"reserved\" | \"committed\" | \"refunded\"\n\n/**\n * Where a job (or a workflow run) that is waiting for a free concurrency slot\n * stands in line — the `queue` field of a status read. Present ONLY while it\n * waits (a job's `status` is `queued`); absent on every other read, and when\n * the server could not read the line at that moment.\n *\n * HAND-COPIED MIRROR of `QueueInfo` in the platform's\n * `backend/src/lib/concurrency-lanes/queue-info.ts` (its `lane`, `reason` and\n * `upgradeHint` lists are `vocabulary.ts` there). Nothing links the two at\n * build time: a change there has to be pasted here in the same change, with a\n * changeset. Treat an unknown `lane` or `reason` like a known one you do not\n * special-case.\n */\nexport interface JobQueueInfo {\n /**\n * The kind of work it waits to run as: `provider` (a call to an AI\n * provider), `llm` (a text model call), `local` (processing on the\n * platform's servers) or `run` (a whole workflow run or pipeline).\n */\n lane: \"provider\" | \"llm\" | \"local\" | \"run\"\n /** Its place in line: `1` runs next. */\n position: number\n /** How many of that kind its line runs at once (`0` for a `server_busy` wait). */\n limit: number\n /** How many run in that line now (`0` for a `server_busy` wait). */\n running: number\n /**\n * `user_lane`: the line (yours, or the workspace's) is full. `provider_ceiling`:\n * the provider is busy across the platform. `server_busy`: the server is busy\n * across the platform.\n */\n reason: \"user_lane\" | \"provider_ceiling\" | \"server_busy\"\n /** How long it has waited so far, in whole seconds, from when it first started waiting for a slot. */\n waitedSeconds: number\n /**\n * What would let more run at once — set only when the line itself is full\n * (`reason: \"user_lane\"`): `\"plan\"`, a bigger plan; `\"workspace\"`, the\n * workspace's plan (the work is billed to a workspace). `null` otherwise.\n */\n upgradeHint: \"plan\" | \"workspace\" | null\n}\n\n/** A job owner's rating of their job — set with {@link JobsResource.rate}. */\nexport type JobRating = \"good\" | \"bad\"\n\n/**\n * The `rating` filter of {@link JobsResource.list}: one rating, any rating\n * (`\"rated\"`) or none (`\"unrated\"`).\n */\nexport type JobRatingFilter = JobRating | \"rated\" | \"unrated\"\n\n/**\n * Job record returned to non-admin SDK consumers. Field names are snake_case\n * to match the wire format (per the OpenAPI fix in Phase 1).\n *\n * Sensitive fields stripped server-side for non-admin callers:\n * `provider`, `provider_cost`, `display_cost`, `credits_actual`. USD\n * pricing is admin-only across api/sdk/mcp — non-admin consumers see\n * only the `credits` abstraction. Server-only nested job data (including\n * Recast's private remux base) is stripped for every caller, including admins.\n */\nexport interface Job {\n id: string\n status: JobStatus\n progress: number\n user_id: string\n input_data: unknown\n output_data: unknown\n error_message: string | null\n /** Present on a failed job the worker classified as a provider\n * content-policy block (`kind: \"safety-block\"`) or that a deployment's job\n * policy rejected (`kind: \"policy-block\"`); absent/null otherwise.\n * User-safe by construction — narrow on `kind` before reading the rest. */\n error_hint?: JobErrorHint | null\n /** PR9: the job's credit reservation lifecycle, derived server-side from\n * `usage_logs.status`. `null` when there is no usage log to report. Never\n * changes the meaning of `credits` (the reserved amount) below. */\n credit_status?: CreditStatus | null\n /** The credits the job itself HELD when it was accepted. Never changes — a\n * job can settle below it; read {@link Job.credits_charged} for what it cost. */\n credits: number | null\n /**\n * What the job actually cost once its hold settled, INCLUDING the steps it\n * ran: a job that runs other jobs for you (a Nodaro Motion run's reference\n * preparation, mask and video) is charged for each, and they are not listed\n * on their own. A step adds its charge once it settles. Can be lower than\n * {@link Job.credits_held} (the unused part goes back to the balance). `0`\n * when the run's own hold was refunded, plus any settled steps (a refunded\n * Nodaro Motion run whose reference and mask steps committed reads\n * `credit_status: \"refunded\"` with `credits_charged: 165`). `null` while the\n * job's own hold is still open (even when some steps have settled), when\n * nothing in the run was reserved, or when its steps could not be read for a\n * moment (unknown — never a lower figure). Sum this — not `credits` — to\n * total spend. Returned by `get()` and `list()`.\n */\n credits_charged?: number | null\n /** The run's hold: the job's own `credits` plus its steps' holds (equals `credits` for a job with no steps). */\n credits_held?: number | null\n /** What went back from `credits_held` once every hold in the run settled; `null` until then. */\n credits_released?: number | null\n job_type: string | null\n created_at: string\n started_at: string | null\n completed_at: string | null\n /**\n * Provenance: which kind of caller created the job — one of\n * `\"internal\" | \"mcp\" | \"app\" | \"cli\" | \"sdk\" | \"extension\" | \"web\" | \"api\"`.\n * `source_detail` narrows it (origin host, `extension/<name>` label,\n * `sdk/<version>`, MCP client name, developer-app id). Descriptive only;\n * lets a library view label or filter media by origin.\n */\n source?: string | null\n source_detail?: string | null\n /** The generation session this job was born in (the `sessionId` sent with\n * the generation request), or null. See `client.sessions`. */\n session_id?: string | null\n /**\n * With `list({ withSessions: true })`: every session that holds the job now,\n * each linkable — empty when it is in no session (General). Absent otherwise.\n */\n sessions?: JobSessionRef[]\n /**\n * When the job was deleted, on a job read from the Trash\n * (`client.trash.list()`). A deleted job is left out of every other read, so\n * this is otherwise absent or `null`.\n */\n deleted_at?: string | null\n /**\n * Whether the job's owner favorited it (`client.gallery.toggleFavorite`).\n * Returned by `get()` and `list()`. Absent from an older server, and when\n * the server could not read it for a moment — treat absent as unknown,\n * never as `false`.\n */\n favorited?: boolean\n /**\n * The owner's rating of the job ({@link JobsResource.rate}), or `null` when\n * unrated. Returned by `get()` and `list()`; absent like `favorited`.\n */\n rating?: JobRating | null\n /**\n * Where the job stands in line while it waits for a free slot: present on\n * `get()` only while `status` is `queued` (never on `list()`). See\n * {@link JobQueueInfo}.\n */\n queue?: JobQueueInfo\n}\n\nexport interface CancelJobResult {\n success: true\n cancelled: number\n /**\n * `true` when the job could not be stopped because its provider call is\n * already running — a metered LLM job's call, an external provider task. It\n * finishes and is charged only what it used.\n */\n inFlight?: boolean\n}\n\n/**\n * The kind of caller that created a job (`Job.source`). Hand-copied mirror of\n * `JOB_SOURCES` in the platform's `backend/src/lib/job-source.ts`.\n */\nexport type JobSource = \"internal\" | \"mcp\" | \"app\" | \"cli\" | \"sdk\" | \"extension\" | \"web\" | \"api\"\n\nexport interface DeleteJobResult {\n success: true\n}\n\n/** A session that holds a job now (`Job.sessions`). */\nexport interface JobSessionRef {\n id: string\n title: string | null\n /** The session's project, or `null` when it has none. */\n projectId: string | null\n}\n\nexport interface ListJobsParams {\n /** One status or several (a job matching any of them). An unknown status is a 400. */\n status?: JobStatus | readonly JobStatus[]\n /** Exact match on `input_data.type` — the route that created the job\n * (`\"llm-structured\"`, `\"video-analysis\"`, …). One value or several (up to 20). */\n type?: string | readonly string[]\n /** Exact match on `input_data.origin` — the client app that sent it. */\n origin?: string\n /** The surface that created the job (`Job.source`): `\"mcp\"` lists what your\n * MCP clients (Claude, ChatGPT, …) made. One value or several. */\n source?: JobSource | readonly JobSource[]\n /** `true`: only jobs you favorited; `false`: only jobs you did not. */\n favorited?: boolean\n /** Your rating: `\"good\"`, `\"bad\"`, any (`\"rated\"`) or none (`\"unrated\"`). */\n rating?: JobRatingFilter\n /** The jobs of one generate-image batch (`count` / `models`) — its `batchId`. */\n batchId?: string\n /**\n * The jobs a session of this project holds now — or, `\"none\"`, a session\n * with no project. Each job once, however many sessions hold it. Not with\n * `inSession: false`.\n */\n projectId?: string | \"none\"\n /**\n * `false`: the jobs no session holds now (General), whatever session they\n * were born in. `true`: the jobs at least one session holds.\n */\n inSession?: boolean\n /** `true`: each job carries `sessions`, the sessions that hold it now. */\n withSessions?: boolean\n /** Page size, 1–100 (server default 50). */\n limit?: number\n /** The previous page's `next`. */\n cursor?: string\n}\n\n/** What {@link JobsResource.rate} answers: the job's rating now. */\nexport interface RateJobResult {\n data: { jobId: string; rating: JobRating | null }\n}\n\n/**\n * {@link JobsResource.fromUpload}'s body: an image edited in the browser,\n * already stored with `client.uploads.upload`, and what it was made from.\n */\nexport interface JobFromUploadParams {\n /** The edited image's `assetId`, as `client.uploads.upload` returned it. */\n assetId: string\n /** The job whose image was edited. */\n sourceJobId?: string\n /** Which of `sourceJobId`'s images was edited, when it made several. Default: its `imageUrl`. */\n sourceImageUrl?: string\n /** The upload that was edited, when the source is not a job. Not with `sourceJobId`. */\n sourceAssetId?: string\n /** The editor's design state, stored with `client.uploads.uploadJson`, so the edit can be reopened. */\n editStateUrl?: string\n /** The generation session to file the job in. */\n sessionId?: string\n}\n\n/** A list filter value as the query string carries it: several are comma-separated. */\nfunction listParam(value: string | readonly string[] | undefined): string | undefined {\n if (value === undefined) return undefined\n return typeof value === \"string\" ? value : value.join(\",\")\n}\n\nexport interface ListJobsPage {\n /**\n * A page may hold fewer than `limit` rows — even none — and still carry a\n * `next`. Page on `next`, never on `data.length`.\n */\n data: Job[]\n /** Pass back as `cursor` for the next page; `null` on the last one. */\n next: string | null\n}\n\n/**\n * Lean job status returned by `GET /v1/jobs/:id/status`. Skips the\n * `input_data` JSONB and cost columns. Its `output_data` still goes\n * through the server-only nested-field redaction. Intended for poll loops that\n * only need progress/output/error, and when the job finished.\n */\nexport interface JobStatusResult {\n id: string\n status: JobStatus\n progress?: number\n output_data?: unknown\n error_message?: string | null\n /** PR9: see {@link Job.error_hint}. */\n error_hint?: JobErrorHint | null\n /** PR9: see {@link Job.credit_status}. */\n credit_status?: CreditStatus | null\n /** When the job finished, on the server's clock; null until it has. */\n completed_at?: string | null\n /** Present only while `status` is `queued` (the job waits for a free slot). See {@link JobQueueInfo}. */\n queue?: JobQueueInfo\n}\n\nexport class JobsResource {\n constructor(private client: NodaroClientCore) {}\n\n /** Get a single job by ID. */\n get(id: string): Promise<{ data: Job }> {\n return this.client.request(\"GET\", `/v1/jobs/${encodeURIComponent(id)}`)\n }\n\n /**\n * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and\n * `origin` filter on the job's own `input_data`, which every job carries —\n * a client app lists its runs with `{ type: \"llm-structured\", origin: \"studio\" }`.\n * `status` and `type` take one value or a list; `favorited` and `rating`\n * filter on your own marks, `source` on the surface that created the job.\n * `projectId` / `inSession` filter on where the job is now (a project's\n * sessions, or General), and `withSessions` says which sessions each job is\n * in — for \"everything in this project\". Every filter combines with AND,\n * and each job carries `favorited` and `rating`. A deleted job is never\n * listed: read the Trash with `client.trash.list()`.\n */\n list(params: ListJobsParams = {}): Promise<ListJobsPage> {\n const { status, type, source, inSession, withSessions, ...rest } = params\n return this.client.request<ListJobsPage>(\"GET\", \"/v1/jobs\", {\n query: {\n ...rest,\n status: listParam(status),\n type: listParam(type),\n source: listParam(source),\n inSession: inSession === undefined ? undefined : String(inSession),\n withSessions: withSessions ? \"true\" : undefined,\n },\n })\n }\n\n /**\n * Record an image edited in the browser as a job (`POST /v1/jobs/from-upload`):\n * a completed, private, free `image-edit` job whose `output_data.imageUrl` is\n * the upload, linked to its source in `input_data` (`sourceJobId` /\n * `sourceAssetId`, `sourceImageUrl`). It then lists, rates, favorites and\n * files into a session like any image job. One upload is one job: the same\n * `assetId` again returns the same job. OAuth apps need the `assets:write`\n * scope. A deployment's job policy can refuse the image ({@link JobBlockedError}).\n */\n fromUpload(params: JobFromUploadParams): Promise<{ data: Job }> {\n return this.client.request<{ data: Job }>(\"POST\", \"/v1/jobs/from-upload\", { body: params })\n }\n\n /**\n * Rate one of your jobs `\"good\"` or `\"bad\"`, or clear the rating with\n * `null` (`PUT /v1/jobs/:id/rating`). Only the job's owner rates it — anyone\n * else's job is a `NotFoundError`. The rating reads back as `Job.rating`\n * and filters {@link list}. OAuth apps need the `assets:write` scope.\n */\n rate(id: string, rating: JobRating | null): Promise<RateJobResult> {\n return this.client.request<RateJobResult>(\"PUT\", `/v1/jobs/${encodeURIComponent(id)}/rating`, {\n body: { rating },\n })\n }\n\n /**\n * Get the lean status of a single job (poll-loop friendly).\n * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/\n * output_data/error_message, with far less wire/CPU cost than `get()`.\n * Same auth + ownership semantics as {@link get}.\n */\n getStatus(id: string): Promise<{ data: JobStatusResult }> {\n return this.client.request(\n \"GET\",\n `/v1/jobs/${encodeURIComponent(id)}/status`,\n )\n }\n\n /**\n * Cancel a job. Server route is `POST /v1/jobs/:jobId/cancel`.\n * Refunds any reserved credit holds. A running LLM job priced per model\n * (metered) whose call has already started answers\n * `{ success: true, cancelled: 0, inFlight: true }`: it finishes and is\n * charged only what it used. A job stopped before its call starts is\n * refunded, except for what an earlier attempt of the same job already used\n * (a retry after a billed attempt): that is charged.\n */\n cancel(id: string): Promise<CancelJobResult> {\n return this.client.request(\n \"POST\",\n `/v1/jobs/${encodeURIComponent(id)}/cancel`,\n )\n }\n\n /**\n * Delete a job: it goes to the Trash (`client.trash.list()`). It is left out\n * of every read from then on, stays restorable for 30 days ({@link restore},\n * back into the sessions it was in), and is then deleted for good, as a\n * delete always was (a copy saved to the Library stays). `{ forever: true }` deletes a job already in the Trash for good now;\n * on a live job it fails with a 409 `NodaroError` whose `code` is\n * `\"not_in_trash\"`. Only the job's owner (or an admin) may delete it; a job\n * that is still running keeps running — cancel it first when its worker\n * should stop ({@link cancel}). Nothing is refunded. OAuth apps need the\n * `assets:write` scope.\n */\n delete(id: string, options: { forever?: boolean } = {}): Promise<DeleteJobResult> {\n return this.client.request(\n \"DELETE\",\n `/v1/jobs/${encodeURIComponent(id)}`,\n options.forever ? { query: { forever: \"true\" } } : {},\n )\n }\n\n /**\n * Bring a deleted job back from the Trash: it reappears in every read and in\n * every session it was in. A job that is not in the Trash succeeds too.\n * OAuth apps need the `assets:write` scope.\n */\n restore(id: string): Promise<{ success: true }> {\n return this.client.request(\"POST\", `/v1/jobs/${encodeURIComponent(id)}/restore`)\n }\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/resources/jobs.ts"],"names":[],"mappings":";AAgXA,SAAS,UAAU,KAAA,EAAmE;AACpF,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,MAAA;AAChC,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,KAAA,CAAM,KAAK,GAAG,CAAA;AAC3D;AAkCO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAI,EAAA,EAAoC;AACtC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,IAAA,CAAK,MAAA,GAAyB,EAAC,EAA0B;AACvD,IAAA,MAAM,EAAE,QAAQ,IAAA,EAAM,MAAA,EAAQ,WAAW,YAAA,EAAc,GAAG,MAAK,GAAI,MAAA;AACnE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAsB,KAAA,EAAO,UAAA,EAAY;AAAA,MAC1D,KAAA,EAAO;AAAA,QACL,GAAG,IAAA;AAAA,QACH,MAAA,EAAQ,UAAU,MAAM,CAAA;AAAA,QACxB,IAAA,EAAM,UAAU,IAAI,CAAA;AAAA,QACpB,MAAA,EAAQ,UAAU,MAAM,CAAA;AAAA,QACxB,SAAA,EAAW,SAAA,KAAc,MAAA,GAAY,MAAA,GAAY,OAAO,SAAS,CAAA;AAAA,QACjE,YAAA,EAAc,eAAe,MAAA,GAAS;AAAA;AACxC,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,WAAW,MAAA,EAAqD;AAC9D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAuB,MAAA,EAAQ,wBAAwB,EAAE,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC5F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAA,CAAK,IAAY,MAAA,EAAkD;AACjE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAuB,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA,CAAA,EAAW;AAAA,MAC5F,IAAA,EAAM,EAAE,MAAA;AAAO,KAChB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,EAAA,EAAgD;AACxD,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,OAAO,EAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,MAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAA,CAAO,EAAA,EAAY,OAAA,GAAiC,EAAC,EAA6B;AAChF,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,QAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AAAA,MAClC,OAAA,CAAQ,UAAU,EAAE,KAAA,EAAO,EAAE,OAAA,EAAS,MAAA,EAAO,EAAE,GAAI;AAAC,KACtD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAQ,EAAA,EAAwC;AAC9C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,QAAA,CAAU,CAAA;AAAA,EACjF;AACF","file":"chunk-A42R7UT7.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * A job's lifecycle status. Hand-copied mirror of `JOB_STATUSES` in the\n * platform's `backend/src/lib/job-status.ts` — nothing links the two at build\n * time, so a new member has to be added here in the same change.\n *\n * `pending_review` is IN-FLIGHT, NOT TERMINAL: a job policy registered by the\n * deployment held the output for a human reviewer. Treat it like `processing`\n * in a `switch` — keep waiting, do not re-run — and it resolves to `completed`\n * (approved), `failed` (rejected, carrying an `error_hint` with\n * `kind: \"policy-block\"`) or `cancelled` (a held job is cancellable like any\n * in-flight job). `credit_status` reads `\"reserved\"` for the whole hold. Only\n * appears on deployments that register a job policy; `runAndWait` throws\n * {@link JobHeldError} on the first held tick rather than waiting it out.\n */\nexport type JobStatus =\n | \"pending\"\n | \"queued\"\n | \"processing\"\n | \"pending_review\"\n | \"completed\"\n | \"failed\"\n | \"cancelled\"\n\n/**\n * A PROVIDER's verdict: the model's own safety filter refused the output.\n * `class` distinguishes a deterministic block (copyright/likeness — retrying\n * the same request never helps) from `safety`, whose filter is known to be\n * non-deterministic for some models: `retried` says whether the worker\n * already spent its one extra attempt, and `suggestedProvider` — present\n * only when the catalog declares a fallback for the model that failed — is a\n * real model id the SAME prompt/references can be retried on.\n */\nexport type SafetyBlockHint = {\n kind: \"safety-block\"\n class: \"copyright\" | \"likeness\" | \"safety\"\n retried: boolean\n suggestedProvider?: string\n /**\n * Present when the provider named the input it refused — not the prompt or\n * the output. `\"input_video\"`: the input video itself; sending a different\n * clip is the fix. `\"input_image\"`: one of the input images, refused as\n * possibly copyrighted (with `class: \"copyright\"`); sending a different\n * picture is the fix. Treat an unknown value as absent.\n */\n subject?: \"input_video\" | \"input_image\"\n}\n\n/**\n * A NODARO-side verdict, not a provider's: a job policy registered by the\n * deployment rejected the request (`hookPoint: \"request\"` — nothing ran, and\n * the call itself failed with {@link JobBlockedError}) or the finished output\n * (`hookPoint: \"result\"` — the result was blocked and never published).\n *\n * `reason` is USER-SAFE BY CONTRACT — the platform guarantees the policy's\n * machine text (scores, labels) never reaches it — so show it to the person\n * who made the request as-is. `policyId` identifies the deployment's policy,\n * not a Nodaro product feature. Only occurs on deployments that register a\n * job policy.\n */\nexport type PolicyBlockHint = {\n kind: \"policy-block\"\n policyId: string\n reason: string\n hookPoint: \"request\" | \"result\"\n}\n\n/**\n * The job ran out of credits partway: a step that reserves its own credits\n * (for example, the video a Cast Swap or trend run dispatches) was refused —\n * the balance could not cover it, or a plan or workspace cap was reached. The\n * job failed and its credits were refunded; ask the person to top up (or raise\n * the cap), then run it again.\n *\n * `code` is the refusal's own code, a lowercase snake_case token — for\n * example `insufficient_credits`, `free_video_limit`, `instance_cap_reached`,\n * `budget_exceeded`, `member_cap_exceeded` or `user_allowance_exceeded`. Treat\n * an unknown code like `insufficient_credits`.\n */\nexport type CreditsHint = {\n kind: \"credits\"\n code: string\n}\n\n/**\n * The provider refused the job's input video without naming a content-policy\n * class (its message is about the file, not a policy). Treat it like any\n * other failure — no fallback model is offered — except that the input to\n * change is known: send a different clip.\n */\nexport type InputRefusedHint = {\n kind: \"input-refused\"\n subject: \"input_video\"\n}\n\n/**\n * The job never got a slot to run in, so it did not run, and its credits were\n * refunded. `reason`: `timeout` — it waited longer than the platform's queue\n * timeout for one of the account's concurrency slots; `lost` — its place in\n * line was lost and could not be restored; `live-wait` — a synchronous call\n * could not get a slot within its wait limit. `waitedMinutes` is the whole\n * minutes it waited, rounded down. Run it again; treat an unknown `reason`\n * like `timeout`.\n */\nexport type QueueTimeoutHint = {\n kind: \"queue-timeout\"\n reason: \"timeout\" | \"lost\" | \"live-wait\"\n waitedMinutes: number\n}\n\n/**\n * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable\n * failure verdict, so a caller can act on it without parsing `error_message`\n * prose. One column, several verdict sources; `kind` is the discriminant.\n *\n * HAND-COPIED MIRROR of `ErrorHint` in the platform's\n * `backend/src/lib/safety-block.ts` (which names this file in its own\n * comment). Nothing links the two at build time: a new arm there has to be\n * pasted here verbatim in the same change, with a changeset.\n * `packages/client/dist/index.d.ts` is REBUILT, never hand-edited.\n */\nexport type JobErrorHint = SafetyBlockHint | PolicyBlockHint | CreditsHint | InputRefusedHint | QueueTimeoutHint\n\n/**\n * The billing lifecycle of a job's credit reservation — `usage_logs.status`\n * for the job's `usage_log_id`. `null` when the job has no usage log (e.g. a\n * free run) or hasn't reserved credits yet.\n */\nexport type CreditStatus = \"reserved\" | \"committed\" | \"refunded\"\n\n/**\n * Where a job (or a workflow run) that is waiting for a free concurrency slot\n * stands in line — the `queue` field of a status read. Present ONLY while it\n * waits (a job's `status` is `queued`); absent on every other read, and when\n * the server could not read the line at that moment.\n *\n * HAND-COPIED MIRROR of `QueueInfo` in the platform's\n * `backend/src/lib/concurrency-lanes/queue-info.ts` (its `lane`, `reason` and\n * `upgradeHint` lists are `vocabulary.ts` there). Nothing links the two at\n * build time: a change there has to be pasted here in the same change, with a\n * changeset. Treat an unknown `lane` or `reason` like a known one you do not\n * special-case.\n */\nexport interface JobQueueInfo {\n /**\n * The kind of work it waits to run as: `provider` (a call to an AI\n * provider), `llm` (a text model call), `local` (processing on the\n * platform's servers) or `run` (a whole workflow run or pipeline).\n */\n lane: \"provider\" | \"llm\" | \"local\" | \"run\"\n /** Its place in line: `1` runs next. */\n position: number\n /** How many of that kind its line runs at once (`0` for a `server_busy` wait). */\n limit: number\n /** How many run in that line now (`0` for a `server_busy` wait). */\n running: number\n /**\n * `user_lane`: the line (yours, or the workspace's) is full. `provider_ceiling`:\n * the provider is busy across the platform. `server_busy`: the server is busy\n * across the platform.\n */\n reason: \"user_lane\" | \"provider_ceiling\" | \"server_busy\"\n /** How long it has waited so far, in whole seconds, from when it first started waiting for a slot. */\n waitedSeconds: number\n /**\n * What would let more run at once — set only when the line itself is full\n * (`reason: \"user_lane\"`): `\"plan\"`, a bigger plan; `\"workspace\"`, the\n * workspace's plan (the work is billed to a workspace). `null` otherwise.\n */\n upgradeHint: \"plan\" | \"workspace\" | null\n}\n\n/** A job owner's rating of their job — set with {@link JobsResource.rate}. */\nexport type JobRating = \"good\" | \"bad\"\n\n/**\n * The `rating` filter of {@link JobsResource.list}: one rating, any rating\n * (`\"rated\"`) or none (`\"unrated\"`).\n */\nexport type JobRatingFilter = JobRating | \"rated\" | \"unrated\"\n\n/**\n * Job record returned to non-admin SDK consumers. Field names are snake_case\n * to match the wire format (per the OpenAPI fix in Phase 1).\n *\n * Sensitive fields stripped server-side for non-admin callers:\n * `provider`, `provider_cost`, `display_cost`, `credits_actual`. USD\n * pricing is admin-only across api/sdk/mcp — non-admin consumers see\n * only the `credits` abstraction. Server-only nested job data (including\n * Recast's private remux base) is stripped for every caller, including admins.\n */\nexport interface Job {\n id: string\n status: JobStatus\n progress: number\n user_id: string\n input_data: unknown\n output_data: unknown\n error_message: string | null\n /** Present on a failed job the worker classified as a provider\n * content-policy block (`kind: \"safety-block\"`) or that a deployment's job\n * policy rejected (`kind: \"policy-block\"`); absent/null otherwise.\n * User-safe by construction — narrow on `kind` before reading the rest. */\n error_hint?: JobErrorHint | null\n /** PR9: the job's credit reservation lifecycle, derived server-side from\n * `usage_logs.status`. `null` when there is no usage log to report. Never\n * changes the meaning of `credits` (the reserved amount) below. */\n credit_status?: CreditStatus | null\n /** The credits the job itself HELD when it was accepted. Never changes — a\n * job can settle below it; read {@link Job.credits_charged} for what it cost. */\n credits: number | null\n /**\n * What the job actually cost once its hold settled, INCLUDING the steps it\n * ran: a job that runs other jobs for you (a Nodaro Motion run's reference\n * preparation, mask and video) is charged for each, and they are not listed\n * on their own. A step adds its charge once it settles. Can be lower than\n * {@link Job.credits_held} (the unused part goes back to the balance). `0`\n * when the run's own hold was refunded, plus any settled steps (a refunded\n * Nodaro Motion run whose reference and mask steps committed reads\n * `credit_status: \"refunded\"` with `credits_charged: 165`). `null` while the\n * job's own hold is still open (even when some steps have settled), when\n * nothing in the run was reserved, or when its steps could not be read for a\n * moment (unknown — never a lower figure). Sum this — not `credits` — to\n * total spend. Returned by `get()` and `list()`.\n */\n credits_charged?: number | null\n /** The run's hold: the job's own `credits` plus its steps' holds (equals `credits` for a job with no steps). */\n credits_held?: number | null\n /** What went back from `credits_held` once every hold in the run settled; `null` until then. */\n credits_released?: number | null\n job_type: string | null\n created_at: string\n started_at: string | null\n completed_at: string | null\n /**\n * Provenance: which kind of caller created the job — one of\n * `\"internal\" | \"mcp\" | \"app\" | \"cli\" | \"sdk\" | \"extension\" | \"web\" | \"api\"`.\n * `source_detail` narrows it (origin host, `extension/<name>` label,\n * `sdk/<version>`, MCP client name, developer-app id). Descriptive only;\n * lets a library view label or filter media by origin.\n */\n source?: string | null\n source_detail?: string | null\n /** The generation session this job was born in (the `sessionId` sent with\n * the generation request), or null. See `client.sessions`. */\n session_id?: string | null\n /**\n * With `list({ withSessions: true })`: every session that holds the job now,\n * each linkable — empty when it is in no session (General). Absent otherwise.\n */\n sessions?: JobSessionRef[]\n /**\n * When the job was deleted, on a job read from the Trash\n * (`client.trash.list()`). A deleted job is left out of every other read, so\n * this is otherwise absent or `null`.\n */\n deleted_at?: string | null\n /**\n * Whether the job's owner favorited it (`client.gallery.toggleFavorite`).\n * Returned by `get()` and `list()`. Absent from an older server, and when\n * the server could not read it for a moment — treat absent as unknown,\n * never as `false`.\n */\n favorited?: boolean\n /**\n * The owner's rating of the job ({@link JobsResource.rate}), or `null` when\n * unrated. Returned by `get()` and `list()`; absent like `favorited`.\n */\n rating?: JobRating | null\n /**\n * Where the job stands in line while it waits for a free slot: present on\n * `get()` only while `status` is `queued` (never on `list()`). See\n * {@link JobQueueInfo}.\n */\n queue?: JobQueueInfo\n}\n\nexport interface CancelJobResult {\n success: true\n cancelled: number\n /**\n * `true` when the job could not be stopped because its provider call is\n * already running — a metered LLM job's call, an external provider task. It\n * finishes and is charged only what it used.\n */\n inFlight?: boolean\n}\n\n/**\n * The kind of caller that created a job (`Job.source`). Hand-copied mirror of\n * `JOB_SOURCES` in the platform's `backend/src/lib/job-source.ts`.\n */\nexport type JobSource = \"internal\" | \"mcp\" | \"app\" | \"cli\" | \"sdk\" | \"extension\" | \"web\" | \"api\"\n\nexport interface DeleteJobResult {\n success: true\n}\n\n/** A session that holds a job now (`Job.sessions`). */\nexport interface JobSessionRef {\n id: string\n title: string | null\n /** The session's project, or `null` when it has none. */\n projectId: string | null\n}\n\nexport interface ListJobsParams {\n /** One status or several (a job matching any of them). An unknown status is a 400. */\n status?: JobStatus | readonly JobStatus[]\n /** Exact match on `input_data.type` — the route that created the job\n * (`\"llm-structured\"`, `\"video-analysis\"`, …). One value or several (up to 20). */\n type?: string | readonly string[]\n /** Exact match on `input_data.origin` — the client app that sent it. */\n origin?: string\n /** The surface that created the job (`Job.source`): `\"mcp\"` lists what your\n * MCP clients (Claude, ChatGPT, …) made. One value or several. */\n source?: JobSource | readonly JobSource[]\n /** `true`: only jobs you favorited; `false`: only jobs you did not. */\n favorited?: boolean\n /** Your rating: `\"good\"`, `\"bad\"`, any (`\"rated\"`) or none (`\"unrated\"`). */\n rating?: JobRatingFilter\n /** The jobs of one generate-image batch (`count` / `models`) — its `batchId`. */\n batchId?: string\n /**\n * The jobs a session of this project holds now — or, `\"none\"`, a session\n * with no project. Each job once, however many sessions hold it. Not with\n * `inSession: false`.\n */\n projectId?: string | \"none\"\n /**\n * `false`: the jobs no session holds now (General), whatever session they\n * were born in. `true`: the jobs at least one session holds.\n */\n inSession?: boolean\n /** `true`: each job carries `sessions`, the sessions that hold it now. */\n withSessions?: boolean\n /** Page size, 1–100 (server default 50). */\n limit?: number\n /** The previous page's `next`. */\n cursor?: string\n}\n\n/** What {@link JobsResource.rate} answers: the job's rating now. */\nexport interface RateJobResult {\n data: { jobId: string; rating: JobRating | null }\n}\n\n/**\n * {@link JobsResource.fromUpload}'s body: an image edited in the browser,\n * already stored with `client.uploads.upload`, and what it was made from.\n */\nexport interface JobFromUploadParams {\n /** The edited image's `assetId`, as `client.uploads.upload` returned it. */\n assetId: string\n /** The job whose image was edited. */\n sourceJobId?: string\n /** Which of `sourceJobId`'s images was edited, when it made several. Default: its `imageUrl`. */\n sourceImageUrl?: string\n /** The upload that was edited, when the source is not a job. Not with `sourceJobId`. */\n sourceAssetId?: string\n /** The editor's design state, stored with `client.uploads.uploadJson`, so the edit can be reopened. */\n editStateUrl?: string\n /** The generation session to file the job in. */\n sessionId?: string\n}\n\n/** A list filter value as the query string carries it: several are comma-separated. */\nfunction listParam(value: string | readonly string[] | undefined): string | undefined {\n if (value === undefined) return undefined\n return typeof value === \"string\" ? value : value.join(\",\")\n}\n\nexport interface ListJobsPage {\n /**\n * A page may hold fewer than `limit` rows — even none — and still carry a\n * `next`. Page on `next`, never on `data.length`.\n */\n data: Job[]\n /** Pass back as `cursor` for the next page; `null` on the last one. */\n next: string | null\n}\n\n/**\n * Lean job status returned by `GET /v1/jobs/:id/status`. Skips the\n * `input_data` JSONB and cost columns. Its `output_data` still goes\n * through the server-only nested-field redaction. Intended for poll loops that\n * only need progress/output/error, and when the job finished.\n */\nexport interface JobStatusResult {\n id: string\n status: JobStatus\n progress?: number\n output_data?: unknown\n error_message?: string | null\n /** PR9: see {@link Job.error_hint}. */\n error_hint?: JobErrorHint | null\n /** PR9: see {@link Job.credit_status}. */\n credit_status?: CreditStatus | null\n /** When the job finished, on the server's clock; null until it has. */\n completed_at?: string | null\n /** Present only while `status` is `queued` (the job waits for a free slot). See {@link JobQueueInfo}. */\n queue?: JobQueueInfo\n}\n\nexport class JobsResource {\n constructor(private client: NodaroClientCore) {}\n\n /** Get a single job by ID. */\n get(id: string): Promise<{ data: Job }> {\n return this.client.request(\"GET\", `/v1/jobs/${encodeURIComponent(id)}`)\n }\n\n /**\n * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and\n * `origin` filter on the job's own `input_data`, which every job carries —\n * a client app lists its runs with `{ type: \"llm-structured\", origin: \"studio\" }`.\n * `status` and `type` take one value or a list; `favorited` and `rating`\n * filter on your own marks, `source` on the surface that created the job.\n * `projectId` / `inSession` filter on where the job is now (a project's\n * sessions, or General), and `withSessions` says which sessions each job is\n * in — for \"everything in this project\". Every filter combines with AND,\n * and each job carries `favorited` and `rating`. A deleted job is never\n * listed: read the Trash with `client.trash.list()`.\n */\n list(params: ListJobsParams = {}): Promise<ListJobsPage> {\n const { status, type, source, inSession, withSessions, ...rest } = params\n return this.client.request<ListJobsPage>(\"GET\", \"/v1/jobs\", {\n query: {\n ...rest,\n status: listParam(status),\n type: listParam(type),\n source: listParam(source),\n inSession: inSession === undefined ? undefined : String(inSession),\n withSessions: withSessions ? \"true\" : undefined,\n },\n })\n }\n\n /**\n * Record an image edited in the browser as a job (`POST /v1/jobs/from-upload`):\n * a completed, private, free `image-edit` job whose `output_data.imageUrl` is\n * the upload, linked to its source in `input_data` (`sourceJobId` /\n * `sourceAssetId`, `sourceImageUrl`). It then lists, rates, favorites and\n * files into a session like any image job. One upload is one job: the same\n * `assetId` again returns the same job. OAuth apps need the `assets:write`\n * scope. A deployment's job policy can refuse the image ({@link JobBlockedError}).\n */\n fromUpload(params: JobFromUploadParams): Promise<{ data: Job }> {\n return this.client.request<{ data: Job }>(\"POST\", \"/v1/jobs/from-upload\", { body: params })\n }\n\n /**\n * Rate one of your jobs `\"good\"` or `\"bad\"`, or clear the rating with\n * `null` (`PUT /v1/jobs/:id/rating`). Only the job's owner rates it — anyone\n * else's job is a `NotFoundError`. The rating reads back as `Job.rating`\n * and filters {@link list}. OAuth apps need the `assets:write` scope.\n */\n rate(id: string, rating: JobRating | null): Promise<RateJobResult> {\n return this.client.request<RateJobResult>(\"PUT\", `/v1/jobs/${encodeURIComponent(id)}/rating`, {\n body: { rating },\n })\n }\n\n /**\n * Get the lean status of a single job (poll-loop friendly).\n * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/\n * output_data/error_message, with far less wire/CPU cost than `get()`.\n * Same auth + ownership semantics as {@link get}.\n */\n getStatus(id: string): Promise<{ data: JobStatusResult }> {\n return this.client.request(\n \"GET\",\n `/v1/jobs/${encodeURIComponent(id)}/status`,\n )\n }\n\n /**\n * Cancel a job. Server route is `POST /v1/jobs/:jobId/cancel`.\n * Refunds any reserved credit holds. A running LLM job priced per model\n * (metered) whose call has already started answers\n * `{ success: true, cancelled: 0, inFlight: true }`: it finishes and is\n * charged only what it used. A job stopped before its call starts is\n * refunded, except for what an earlier attempt of the same job already used\n * (a retry after a billed attempt): that is charged.\n */\n cancel(id: string): Promise<CancelJobResult> {\n return this.client.request(\n \"POST\",\n `/v1/jobs/${encodeURIComponent(id)}/cancel`,\n )\n }\n\n /**\n * Delete a job: it goes to the Trash (`client.trash.list()`). It is left out\n * of every read from then on, stays restorable for 30 days ({@link restore},\n * back into the sessions it was in), and is then deleted for good, as a\n * delete always was (a copy saved to the Library stays). `{ forever: true }` deletes a job already in the Trash for good now;\n * on a live job it fails with a 409 `NodaroError` whose `code` is\n * `\"not_in_trash\"`. Only the job's owner (or an admin) may delete it; a job\n * that is still running keeps running — cancel it first when its worker\n * should stop ({@link cancel}). Nothing is refunded. OAuth apps need the\n * `assets:write` scope.\n */\n delete(id: string, options: { forever?: boolean } = {}): Promise<DeleteJobResult> {\n return this.client.request(\n \"DELETE\",\n `/v1/jobs/${encodeURIComponent(id)}`,\n options.forever ? { query: { forever: \"true\" } } : {},\n )\n }\n\n /**\n * Bring a deleted job back from the Trash: it reappears in every read and in\n * every session it was in. A job that is not in the Trash succeeds too.\n * OAuth apps need the `assets:write` scope.\n */\n restore(id: string): Promise<{ success: true }> {\n return this.client.request(\"POST\", `/v1/jobs/${encodeURIComponent(id)}/restore`)\n }\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/resources/cast-swap.ts"],"names":["nodaroMotionEngineFrom"],"mappings":";;;;;AAokBO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASpB,GAAA,CAAI,QAAwB,OAAA,EAA6E;AACvG,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,eAAA,EAAiB;AAAA,MAClD,IAAA,EAAM,MAAA;AAAA,MACN,GAAI,OAAA,EAAS,cAAA,GAAiB,EAAE,OAAA,EAAS,EAAE,iBAAA,EAAmB,OAAA,CAAQ,cAAA,EAAe,EAAE,GAAI;AAAC,KAC7F,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,WAAA,GAA4C;AAC1C,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,4BAA4B,CAAA;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,SAAS,MAAA,EAAmD;AAChE,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,QAAQ,wBAAA,EAA0B,EAAE,IAAA,EAAM,MAAA,EAAQ,CAAA;AAE5G,IAAA,MAAM,MAAA,GAASA,6BAAA,CAAuB,KAAA,EAAO,MAAM,CAAA;AACnD,IAAA,OAAO,MAAA,IAAU,WAAW,KAAA,CAAM,MAAA,GAAS,EAAE,GAAG,KAAA,EAAO,QAAO,GAAI,KAAA;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,oBAAoB,KAAA,EAAqD;AACvE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,CAAA,cAAA,EAAiB,kBAAA,CAAmB,KAAK,CAAC,CAAA,sBAAA,CAAA,EAA0B,EAAE,IAAA,EAAM,IAAI,CAAA;AAAA,EACrH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,WAAA,CAAY,KAAA,EAAe,MAAA,GAAoC,EAAC,EAAuC;AACrG,IAAA,MAAM,IAAA,GAAO,OAAO,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU,GAAI,EAAC;AACjF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,CAAA,cAAA,EAAiB,kBAAA,CAAmB,KAAK,CAAC,CAAA,aAAA,CAAA,EAAiB,EAAE,IAAA,EAAM,CAAA;AAAA,EACxG;AACF","file":"chunk-AAUVNTWE.cjs","sourcesContent":["import { nodaroMotionEngineFrom } from \"@nodaro/shared/models\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Nodaro Motion (the `castSwap` resource; routes `/v1/cast-swap`) — replace\n * the people, pets, products and/or the location in a short video with your\n * own references, keeping its motion, framing, timing and sound (the clip's\n * audio is kept, and the result is the clip's length).\n *\n * Before the video, each person, pet and product role's photos are turned\n * into one clean reference picture by an image model. This costs extra\n * credits (`breakdown.references` in the estimate), charged when it runs, even\n * if the video then fails; it adds about a minute, falls back to your own\n * photos if it fails, and is turned off with `prepareReferences: false`.\n * Locations are not prepared.\n *\n * Engines: a run is made on Nodaro Motion Prism (`engine` left out, or\n * `\"motion-prism\"`) or Nodaro Motion Pulse (`\"motion-pulse\"`). Pulse renders 720p\n * (its default) or 1080p and has no draft; it makes a new take guided by the\n * clip and pictures, so its Full Quality is a new take at 1080p rather than\n * the same take re-rendered (`CastSwapFullQualityEstimate.kind`).\n *\n * How the clip is prepared for the video model (for one, whether faces are\n * hidden first, and whether a refused clip is retried) is set by Nodaro for\n * each engine; a run cannot change it. `faceMasking` is no longer read\n * (deprecated: accepted and ignored).\n *\n * Cloud edition only: `/v1/cast-swap` is served by the cloud plugin and 404s\n * on self-hosted installs. `run()` answers 202 with a job id; follow it with\n * `client.jobs.get(jobId)` / `client.jobs.getStatus(jobId)` like any other job.\n *\n * Repeats: pass `{ idempotencyKey }` to `run()` and it is sent as the\n * `Idempotency-Key` header. A repeat with the same key within the credit\n * guard's dedup window (about 10 s) answers 200 `{ jobId, deduped: true }` with\n * an `X-Dedup-Hit` header; a later one answers 202 with the first run's\n * `jobId`. Nothing new is started or charged.\n *\n * Refusals (thrown as a `NodaroError` subclass; body `{ error: { code, message } }`), before\n * anything is charged: 400 `validation_error` (the body: no role with images,\n * no reference, no `prePrompt` or `postPrompt` and no art style (Flex on\n * Nodaro Motion Prism), more roles of a kind\n * than allowed, more than 30 images in all, `draft: true` above 480p, a\n * `prePrompt` or `postPrompt` over 4,000 characters); on Nodaro Motion Pulse,\n * `draft_unsupported` (`draft: true`), `resolution_unsupported` (480p),\n * `output_format_unsupported` (a MOV edit output) and `too_many_images` (more\n * than 10 images in the run, across every role and fixed reference);\n * `raw_reference_token` (also in a reference's `line`),\n * `invalid_role_mention` (also any `{role:N}` in a reference's `line`),\n * `unsafe_url`, `video_unreadable`, `clip_out_of_range` (4–30 s),\n * `preview_out_of_range`, `unnamed_role_needs_picture` (a role with no name\n * and no image), `no_roles_in_preview` (a preview that would change nothing,\n * judged on what it sends: no role kept in it with images, no fixed\n * reference, no `prePrompt` or `postPrompt` and no art style), `prompt_too_long`\n * (the prompt would build too long: a `{role:N}` reads as the role's name when\n * it sends no images; Nodaro Motion Pulse's cap is 8,000 characters); 401; 402 `insufficient_credits` (`run()` only); 404\n * (a `sessionId` you may not use, `run()` only); 422 `job_blocked` (`run()`\n * only); 503 `host_too_old` (both); 503 `estimate_unavailable` (`estimate()`\n * only).\n */\n\n/**\n * The engine a Nodaro Motion run is made on, by its public id. Left out =\n * `\"motion-prism\"`.\n *\n * - `\"motion-prism\"` (Nodaro Motion Prism): 480p (the default, a draft unless\n * `draft: false`), 720p or 1080p; Full Quality re-renders a draft's own take\n * at 1080p.\n * - `\"motion-pulse\"` (Nodaro Motion Pulse): 720p (the default) or 1080p, never a\n * draft (`draft: true` answers 400 `draft_unsupported`); Full Quality makes a\n * new take at 1080p from a completed 720p run's inputs. A preview is still\n * 4 s from `previewStart`.\n */\nexport type CastSwapEngine = \"motion-prism\" | \"motion-pulse\"\n\n/**\n * The engine ids an older client sent: the earlier public ids (`\"motion-pro\"`\n * = `\"motion-prism\"`, `\"motion-lite\"` = `\"motion-pulse\"`) and the internal\n * ones (`\"seedance-2-5\"`, `\"kling-4\"`). Still accepted in a request; never\n * returned.\n * @deprecated use {@link CastSwapEngine}.\n */\nexport type CastSwapEngineLegacyId = \"motion-pro\" | \"motion-lite\" | \"seedance-2-5\" | \"kling-4\"\n\n/**\n * How a run follows its clip. Left out = `\"precise\"`.\n *\n * - `\"precise\"`: follows the clip exactly.\n * - `\"motion\"`: follows the clip's movement and takes the looks from your\n * photos, more freely than `\"precise\"`. Its price may differ from\n * `\"precise\"`'s: the estimate shows the exact price.\n */\nexport type CastSwapStyle = \"precise\" | \"motion\"\n\n/**\n * Where a Nodaro Motion Pulse run cuts the clip to whole seconds (Pulse renders\n * whole seconds; asked for more than the clip, it would stretch the motion):\n * - `\"cut-end\"` (the default): drop the fraction of a second at its end;\n * - `\"cut-start\"`: drop it at its start.\n */\nexport type CastSwapMotionLength = \"cut-end\" | \"cut-start\"\n\n/** @deprecated use {@link CastSwapMotionLength}. */\nexport type CastSwapKlingLength = CastSwapMotionLength\n\n/** Whether a swapped subject takes this trait from the references (`\"new\"`) or keeps the video's (`\"original\"`). */\nexport type CastSwapTraitSource = \"new\" | \"original\"\n\n/**\n * Preview-only settings, on every role kind; a full run (`preview` not `true`)\n * ignores both.\n */\nexport interface CastSwapRolePreviewSettings {\n /** The name used instead of `name` in a preview. Same rules as `name` (1–200 characters). */\n previewName?: string\n /**\n * `false` leaves this role out of the preview: its reference images are not\n * sent, not prepared and not charged, and a `{role:N}` naming it reads as its\n * `previewName`, else its `name`. Default `true`. A preview that would\n * change nothing (no role kept in it with images, no fixed reference, no pre\n * or post prompt and no art style) answers 400 `no_roles_in_preview`.\n */\n inPreview?: boolean\n}\n\n/** A person in the video to recast. */\nexport interface CastSwapPersonRole extends CastSwapRolePreviewSettings {\n kind: \"person\"\n /** How the person is told apart in the video, e.g. `\"the woman that attacks\"`.\n *\n * Direct runs only: omit it (or leave it empty) and the role is named by its\n * first picture — matched to the subject in the video it fits best; such a\n * role needs at least one image (else 400 `unnamed_role_needs_picture`). A\n * trend run's roles are always named (400 `role_name_required`).\n */\n name?: string\n /** 0–3 images of ONE person. Empty or `null` keeps the original person. */\n images: string[] | null\n /** Body from the references or the video. Default `\"new\"`. */\n body?: CastSwapTraitSource\n /** Outfit from the references or the video. Default `\"new\"`. */\n outfit?: CastSwapTraitSource\n /** Hairstyle and haircut from the references or the video. Default `\"new\"`. */\n hair?: CastSwapTraitSource\n}\n\n/** The place the video happens in. */\nexport interface CastSwapLocationRole extends CastSwapRolePreviewSettings {\n kind: \"location\"\n /** How the place is named. Default `\"the setting\"`. */\n name?: string\n /** 0–3 images of ONE place. Empty or `null` keeps the original place. */\n images: string[] | null\n}\n\n/** An animal in the video to recast. */\nexport interface CastSwapPetRole extends CastSwapRolePreviewSettings {\n kind: \"pet\"\n /** How the animal is told apart in the video, e.g. `\"the dog\"`.\n *\n * Direct runs only: omit it (or leave it empty) and the role is named by its\n * first picture — matched to the subject in the video it fits best; such a\n * role needs at least one image (else 400 `unnamed_role_needs_picture`). A\n * trend run's roles are always named (400 `role_name_required`).\n */\n name?: string\n /** 0–3 images of ONE animal. Empty or `null` keeps the original animal. */\n images: string[] | null\n /** Body (shape, size and build) from the references or the video. Default `\"new\"`. */\n body?: CastSwapTraitSource\n /** Coat (fur, colors and markings) from the references or the video. Default `\"new\"`. */\n coat?: CastSwapTraitSource\n}\n\n/** An object in the video to recast. */\nexport interface CastSwapProductRole extends CastSwapRolePreviewSettings {\n kind: \"product\"\n /** How the object is told apart in the video, e.g. `\"the can\"`.\n *\n * Direct runs only: omit it (or leave it empty) and the role is named by its\n * first picture — matched to the subject in the video it fits best; such a\n * role needs at least one image (else 400 `unnamed_role_needs_picture`). A\n * trend run's roles are always named (400 `role_name_required`).\n */\n name?: string\n /** 0–3 images of ONE product. Empty or `null` keeps the original object. */\n images: string[] | null\n /** Shape and proportions from the references or the video. Default `\"new\"`. */\n shape?: CastSwapTraitSource\n /** Finish (colors, materials, label and markings) from the references or the video. Default `\"new\"`. */\n finish?: CastSwapTraitSource\n}\n\nexport type CastSwapRole = CastSwapPersonRole | CastSwapLocationRole | CastSwapPetRole | CastSwapProductRole\n\n/**\n * A fixed reference: 1–3 images of ONE thing that no role replaces, and the\n * line that says what it is (`\"the glass she drinks from\"`). Sent as given,\n * never prepared; its images count toward the 30.\n */\nexport interface CastSwapReference {\n /** 1–3 http(s) image URLs of one thing. */\n images: string[]\n /**\n * What it is, 1–500 characters. `{image}` in the line stands for this\n * reference's first image (`\"Use {image} for the sky\"`); a line without it\n * gets it appended. A `{role:N}` or a raw `{image:` / `{video:` / `{audio:`\n * token answers 400.\n */\n line: string\n}\n\n/**\n * @deprecated Nodaro sets this per engine; a run's `faceMasking` is ignored.\n */\nexport interface CastSwapFaceMaskingZone {\n leftPct?: number\n rightPct?: number\n topPct?: number\n bottomPct?: number\n}\n\n/**\n * @deprecated Nodaro sets how the clip is prepared for the video model, per\n * engine; a run cannot change it. A `faceMasking` sent is accepted and\n * ignored (no error), so older code keeps working unchanged.\n */\nexport interface CastSwapFaceMasking {\n mode: \"off\" | \"always\" | \"auto\"\n fill?: \"blur\" | \"depth\"\n minFaceHeightPct?: number\n maxFaceHeightPct?: number\n zone?: CastSwapFaceMaskingZone | null\n blurStrengthPct?: number\n threshold?: number\n}\n\n/** The body of `POST /v1/cast-swap` and `POST /v1/cast-swap/estimate`. */\nexport interface CastSwapParams {\n /** The source clip, 4–30 seconds. */\n videoUrl: string\n /**\n * Who and what to swap: at most 6 person roles, 1 location role, 3 pet roles\n * and 3 product roles, with at most 30 images in all. A role with no images\n * is skipped (that subject or place stays as in the video). At least one role\n * with images, a fixed reference, a `prePrompt` or `postPrompt`, or an art\n * style (`direction`, Flex on Nodaro Motion Prism) is required. With an art\n * style and nothing to swap, a run restyles the whole clip (see `direction`).\n */\n roles: CastSwapRole[]\n /**\n * Fixed references (at most 5): things the video should show that no role\n * replaces, each with the line that names it. Their images count toward the\n * 30. A reference alone is enough for a run (no role needs images).\n */\n references?: CastSwapReference[]\n /**\n * Your own words placed at the start of the prompt, before the role\n * instructions; at most 4,000 characters. Mention a role as `{role:N}`, as in\n * `postPrompt`; the same 400 refusals apply (an N outside 1..`roles.length`,\n * a raw `{image:` / `{video:` / `{audio:` token).\n */\n prePrompt?: string\n /**\n * Extra instructions in your own words, at most 4,000 characters. Mention a\n * role as `{role:N}`, where N is its 1-based position in `roles`\n * (`{role:1}` is `roles[0]`; empty roles count).\n *\n * The route answers 400, before charging, for an N outside 1..`roles.length`,\n * for a raw `{image:` / `{video:` / `{audio:` token in the pre or post prompt\n * or a role's `name`, for a clip outside 4–30 s, and for a preview past the clip's\n * end (`previewStart + 4` > its length).\n */\n postPrompt?: string\n /** `true` runs on 4 seconds of the clip, starting at `previewStart`: a cheap check of the roles and choices. */\n preview?: boolean\n /** Where the preview starts, in seconds. Default 0. */\n previewStart?: number\n /**\n * The engine (see {@link CastSwapEngine}). Default `\"motion-prism\"`. The job\n * records it in `input_data.engine`, and a completed job's output in its\n * `engine`. The ids an older client sent ({@link CastSwapEngineLegacyId})\n * are still accepted.\n */\n engine?: CastSwapEngine | CastSwapEngineLegacyId\n /**\n * How the run follows the clip (see {@link CastSwapStyle}). Default\n * `\"precise\"`; the job records it in `input_data.style`.\n */\n style?: CastSwapStyle\n /**\n * A direct run on Nodaro Motion Prism: an art style that restyles the whole\n * video, as a `direction.style` id of the platform's `style` picker catalog\n * (the same ids an image's `direction.style` takes); the platform words it.\n * A Flex run (`style: \"motion\"`) takes one, and so does a Precise run where\n * {@link CastSwapResource.styleChoice} answers `preciseArtStyle` true for the\n * engine: Precise's edit of the clip, drawn in the art style. Refused with\n * 400 `unknown_art_style` (not in the catalog), `art_style_not_supported` (a\n * saved moodboard, `moodboard:…`) or `art_style_needs_flex` (a trend run, a\n * Flex run whose prompt is made Precise by Nodaro's setting for how Flex\n * runs are prepared, or a Precise request on an engine from before Precise\n * runs took one), and on Nodaro Motion Pulse with `art_style_needs_prism`.\n * The estimate (sent with the same `direction`) shows the price: it changes\n * only where Nodaro's setting for such runs first redraws the role pictures\n * in the art style.\n *\n * Style only: with no role with images and no fixed reference, the art style\n * alone is the run's change (a pre or post prompt is still added). It\n * restyles the whole clip, keeping the people, places, motion and sound, and\n * is charged for what it runs (the estimate shows it; no clip-preparation\n * `privacy` part). By default a black-and-white art style comes out\n * monochrome. Nodaro may run it the way other art-style runs run instead,\n * priced as those are and not made monochrome.\n * A preview takes its full run's path. Runs this way only on a Flex run, and\n * only where {@link CastSwapResource.styleChoice} answers `styleOnly` true\n * for the engine; elsewhere on Nodaro Motion Prism an art style alone is\n * refused (on a Precise run too), and one with a pre or post prompt runs as\n * any other art-style run. The job records it in `input_data.direction`.\n */\n direction?: { style: string }\n /**\n * Nodaro Motion Pulse only (Prism ignores it): which end of the clip is cut to\n * whole seconds (see {@link CastSwapMotionLength}). Default `\"cut-end\"`.\n */\n motionLength?: CastSwapMotionLength\n /** @deprecated use {@link motionLength} (still accepted). */\n klingLength?: CastSwapKlingLength\n /**\n * The output resolution. Nodaro Motion Prism: `\"480p\"` (default), `\"720p\"` or\n * `\"1080p\"`. Nodaro Motion Pulse: `\"720p\"` (default) or `\"1080p\"`; `\"480p\"`\n * answers 400.\n */\n resolution?: \"480p\" | \"720p\" | \"1080p\"\n /**\n * Render as a draft (Nodaro Motion Prism only). Defaults to `true` at 480p and\n * `false` above it; `true` with `\"720p\"` or `\"1080p\"` answers 400 (draft is\n * 480p only). Nodaro Motion Pulse has no draft: `true` answers 400\n * `draft_unsupported`.\n */\n draft?: boolean\n /**\n * Turn each person, pet and product role's photos into one clean reference\n * picture before the video (extra credits, shown in `breakdown.references`;\n * about a minute longer; falls back to your own photos if it fails).\n * Default `true`.\n */\n prepareReferences?: boolean\n /**\n * Ignored: Nodaro sets how the clip is prepared, per engine. Accepted (no\n * error) so older code keeps working.\n * @deprecated leave it out.\n */\n faceMasking?: CastSwapFaceMasking\n /**\n * `\"draft\"` means 480p draft.\n * @deprecated use `resolution` + `draft`.\n */\n quality?: \"draft\"\n /** A generation session to file the result in. */\n sessionId?: string\n /** The client app that sent the run (stored on the job as `input_data.origin`). */\n origin?: string\n}\n\n/** What a run would cost, in credits. */\nexport interface CastSwapEstimate {\n /**\n * The engine the run would use, by its public id (absent from an older\n * server = `\"motion-prism\"`). An id an older server answers is read as the\n * public id it names.\n */\n engine?: CastSwapEngine\n /**\n * What is held when the run starts. The run is charged what it actually\n * costs, which is expected to be `expectedCredits`.\n */\n totalCredits: number\n /**\n * The charge the run is expected to come to. Never above `totalCredits`\n * (on Nodaro Motion Pulse it equals it: Pulse renders exactly the length\n * asked for, so the hold is what it settles at). Absent from an older\n * server: read `totalCredits` then.\n */\n expectedCredits?: number\n /**\n * The parts of the quote, by name, for display only:\n * - `base`: the run itself (its base fee). A server before Cast Swap 0.396.0\n * names it `castSwap` instead: read `base`, else `castSwap`;\n * - `references`: preparing the reference pictures (0 when\n * `prepareReferences` is off or there is nothing to prepare);\n * - `motion`: what the video holds (on Nodaro Motion Pulse, what it costs);\n * - `motionExpected`: what the video is expected to be charged, never above\n * `motion` (Nodaro Motion Prism);\n * - `privacy`: preparing the clip, when the engine's setting does. In both\n * totals when it always runs; outside both when it is the retry\n * (`privacyCredits`).\n * - `prompt`: the prompt written for the run by a language model, when\n * Nodaro's setting for the engine does so (absent otherwise).\n * - `referenceAudio`: preparing the clip's sound for the video model, when\n * Nodaro's setting for the engine runs that step (absent otherwise).\n *\n * `motion` and `motionExpected` are alternatives, so the parts sum to more\n * than either total: read `totalCredits` and `expectedCredits`, never the\n * sum. Other parts may appear.\n */\n breakdown: {\n base?: number\n /** @deprecated read {@link base} (an older server answered this name for the same part). */\n castSwap?: number\n references: number\n motion?: number\n motionExpected?: number\n privacy?: number\n prompt?: number\n referenceAudio?: number\n } & Record<string, number>\n /**\n * The extra credits charged only if the video model refuses the clip and\n * the run is retried (Nodaro's setting for the engine decides whether it\n * does). Not in `totalCredits` or `expectedCredits`; `run()` needs credits\n * for both the hold and this (else 402).\n */\n privacyCredits?: number\n /** @deprecated read {@link privacyCredits} (an older server answered this name). */\n maskingCredits?: number\n /**\n * `true` when the video is made at Auto length (every Nodaro Motion Prism\n * run): the final charge is expected to come out lower than `totalCredits`,\n * at about `expectedCredits`. `false` on Nodaro Motion Pulse.\n */\n settlesLower: boolean\n}\n\n/** Per-call options for {@link CastSwapResource.run}. */\nexport interface CastSwapRunOptions {\n /**\n * Sent as the `Idempotency-Key` header, unchanged (the SDK checks nothing;\n * an empty string sends no header, like no key).\n * The server takes 8–200 characters and answers 400 for any other length.\n * Reuse the same value when retrying the same run: within about 10 s the\n * repeat answers 200 `{ jobId, deduped: true }`, later 202 with the first\n * run's `jobId`. Nothing new is started or charged.\n */\n idempotencyKey?: string\n}\n\n/**\n * What a Full Quality version would be: `\"same-take\"` re-renders a Nodaro\n * Motion Prism draft's own take at 1080p; `\"new-take\"` makes a new Nodaro Motion Pulse take at\n * 1080p from a 720p run's inputs (it will not match the 720p run frame for\n * frame). The 720p run or draft stays either way.\n */\nexport type CastSwapFullQualityKind = \"same-take\" | \"new-take\"\n\n/**\n * What a Full Quality version of a run would cost\n * (`POST /v1/cast-swap/:jobId/full-quality/estimate`): a Nodaro Motion Prism\n * draft, or a completed Nodaro Motion Pulse run at 720p.\n */\nexport interface CastSwapFullQualityEstimate {\n /**\n * Which Full Quality this is ({@link CastSwapFullQualityKind}), so it can\n * be worded right. Absent from an older server: `\"same-take\"`.\n */\n kind?: CastSwapFullQualityKind\n /** The quote in credits: `breakdown.base` plus the 1080p render (same take) or the new take. */\n totalCredits: number\n /**\n * The parts of the quote, by name, for display only: `base` (the Full\n * Quality job's own steps; a server before Cast Swap 0.396.0 names it\n * `castSwap` instead: read `base`, else `castSwap`), and `motionHd` (a same\n * take: the 1080p render, 0 when an earlier try of this draft already\n * finished that render, which is then reused) or `motion` (a new take).\n */\n breakdown: {\n base?: number\n /** @deprecated read {@link base} (an older server answered this name for the same part). */\n castSwap?: number\n motionHd?: number\n motion?: number\n } & Record<string, number>\n /** ISO time until which the run can be finished at Full Quality (7 days after it completed). */\n availableUntil: string\n}\n\n/** Options for {@link CastSwapResource.fullQuality}. */\nexport interface CastSwapFullQualityParams {\n /** A generation session to file the Full Quality result in. */\n sessionId?: string\n}\n\n/** The Full Quality job (`POST /v1/cast-swap/:jobId/full-quality`). */\nexport interface CastSwapFullQualityResult {\n jobId: string\n /** `true` when this run's Full Quality was already running or done: that job is answered, nothing new is started or charged. */\n existing?: boolean\n}\n\n/**\n * The `code` of a Full Quality refusal (`NodaroError.code`), all before\n * anything is charged:\n * - `unauthorized` (401): no authenticated user;\n * - `not_found` (404): not your job, or not a Nodaro Motion run; also a\n * `sessionId` you may not use;\n * - `not_completed` (409): the run has not finished;\n * - `not_a_draft` (409): the run is neither a Nodaro Motion Prism draft nor a\n * Nodaro Motion Pulse run at 720p (a Pulse run at 1080p is already Full Quality);\n * - `draft_expired` (410): more than 7 days after the draft completed, or\n * the draft can no longer be finished at Full Quality;\n * - `full_quality_pending` (409, `details.retryable: true`): not final — an\n * earlier try's 1080p render of this draft is being reviewed, or has not\n * started yet; try again later (once the review ends). The only refusal\n * that ends on its own;\n * - `full_quality_unavailable` (409): final — nothing kept to re-render, no\n * readable completion time, or the 1080p finalize refuses this draft; on\n * the start only, also \"failed too many times\" (every try failed) or no\n * try can be started for this run;\n * - `insufficient_credits` (402), or in a workspace `budget_exceeded`,\n * `member_cap_exceeded` or `user_allowance_exceeded`;\n * - `job_blocked` (422): the request was blocked by the job policy;\n * - `job_read_failed` (503, retryable), `estimate_unavailable` (503, try\n * again shortly), `host_too_old` (503).\n *\n * Open-ended: a code not listed here may still arrive.\n */\nexport type CastSwapFullQualityRefusalCode =\n | \"unauthorized\"\n | \"not_found\"\n | \"not_completed\"\n | \"not_a_draft\"\n | \"draft_expired\"\n | \"full_quality_pending\"\n | \"full_quality_unavailable\"\n | \"insufficient_credits\"\n | \"budget_exceeded\"\n | \"member_cap_exceeded\"\n | \"user_allowance_exceeded\"\n | \"job_blocked\"\n | \"job_read_failed\"\n | \"estimate_unavailable\"\n | \"host_too_old\"\n | (string & {})\n\n/**\n * Who decides a direct run's style on one engine:\n * - `\"user\"`: the person (the request's `style`, left out = `\"precise\"`);\n * show a Style control;\n * - `\"precise\"` / `\"flex\"`: an admin forced it — every direct run and quote\n * of that engine runs Precise / Flex (`style: \"motion\"`) whatever the\n * request's `style` says; show no Style control.\n *\n * A trend run keeps its own trend's style.\n */\nexport type CastSwapStyleChoiceOption = \"user\" | \"precise\" | \"flex\"\n\n/** What {@link CastSwapResource.styleChoice} answers: every engine's choice, by its public id. */\nexport interface CastSwapStyleChoice {\n engines: Record<CastSwapEngine, CastSwapStyleChoiceOption>\n /**\n * Per engine, whether the engine takes style-only runs: a Flex run\n * (`style: \"motion\"`) with an art style (`direction`) and nothing to swap\n * (no role with images, no fixed reference). It follows the engine alone, so\n * read it with {@link engines}: an engine answered `\"precise\"` drops the art\n * style, so such a request is refused as `validation_error` and, with anything\n * else to change, runs and is quoted as Precise. Nodaro Motion Pulse is always\n * `false` (it takes no art style). Absent from an older server, and\n * an engine missing from it: `false`.\n */\n styleOnly?: Partial<Record<CastSwapEngine, boolean>>\n /**\n * Per engine, whether a Precise run (no `style`, or `\"precise\"`) takes an\n * art style (`direction`), as a Flex run does: Precise's edit of the clip,\n * drawn in the art style. Not on its own: a Precise run with nothing else to\n * change is still refused. Where it is `true`, an engine answered\n * `\"precise\"` keeps a Flex request's art style. Nodaro Motion Pulse is always\n * `false` (it takes no art style). Absent from an older server, and an engine\n * missing from it: `false` (offer an art style on Flex runs alone).\n */\n preciseArtStyle?: Partial<Record<CastSwapEngine, boolean>>\n}\n\nexport class CastSwapResource {\n constructor(private client: NodaroClientCore) {}\n\n /**\n * Start a Nodaro Motion run (`POST /v1/cast-swap`, 202 `{ jobId }`). Returns the\n * job to follow. With `options.idempotencyKey` (sent as the\n * `Idempotency-Key` header; 8–200 characters, else 400) a repeat with the\n * same key within about 10 s answers 200 `{ jobId, deduped: true }`, a later\n * one 202 with the first run's `jobId`; nothing new starts.\n */\n run(params: CastSwapParams, options?: CastSwapRunOptions): Promise<{ jobId: string; deduped?: boolean }> {\n return this.client.request(\"POST\", \"/v1/cast-swap\", {\n body: params,\n ...(options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}),\n })\n }\n\n /**\n * Whether people choose a direct run's style, per engine\n * (`GET /v1/cast-swap/style-choice`): `\"user\"` = show a Style control;\n * `\"precise\"` / `\"flex\"` = an admin forced that style for the engine, so a\n * run's `style` is overridden and the control is best hidden. Its\n * `styleOnly` says, per engine, whether a Flex run with an art style and\n * nothing to swap restyles the whole clip there. Where it is not `true`\n * (absent, or an engine missing from it, included) on Nodaro Motion Prism, an\n * art style alone is refused, and one with a pre or post prompt runs as any\n * other art-style run. Its `preciseArtStyle` says, per engine, whether a\n * Precise run takes an art style there too.\n * Public (no sign-in needed); the answer may be up to a minute old.\n */\n styleChoice(): Promise<CastSwapStyleChoice> {\n return this.client.request(\"GET\", \"/v1/cast-swap/style-choice\")\n }\n\n /** Quote a run before starting it (`POST /v1/cast-swap/estimate`); spends nothing. */\n async estimate(params: CastSwapParams): Promise<CastSwapEstimate> {\n const quote = await this.client.request<CastSwapEstimate>(\"POST\", \"/v1/cast-swap/estimate\", { body: params })\n // An older server names the engine by an earlier id: answered as the public id it names.\n const engine = nodaroMotionEngineFrom(quote?.engine)\n return engine && engine !== quote.engine ? { ...quote, engine } : quote\n }\n\n /**\n * Quote finishing a run at Full Quality (`POST\n * /v1/cast-swap/:jobId/full-quality/estimate`); spends nothing. `jobId` is a\n * finished Nodaro Motion Prism DRAFT run, or a finished Nodaro Motion Pulse\n * run at 720p (a Nodaro Motion or trend run); the quote's `kind` says whether it is the same take\n * re-rendered or a new take. The quote\n * does not look for a Full Quality already running: when one is,\n * {@link fullQuality} answers it (`existing: true`) and charges nothing.\n * Refusals: {@link CastSwapFullQualityRefusalCode}.\n */\n fullQualityEstimate(jobId: string): Promise<CastSwapFullQualityEstimate> {\n return this.client.request(\"POST\", `/v1/cast-swap/${encodeURIComponent(jobId)}/full-quality/estimate`, { body: {} })\n }\n\n /**\n * Finish a run at Full Quality (`POST /v1/cast-swap/:jobId/full-quality`):\n * at 1080p, with the clip's audio, as a new job linked to the run — a\n * Nodaro Motion Prism draft's own take re-rendered, or a new Nodaro Motion Pulse take from a\n * 720p run's inputs (the quote's `kind`). SPENDS CREDITS: quote it first with\n * {@link fullQualityEstimate}. Answers 202 `{ jobId }`, or 200\n * `{ jobId, existing: true }` when this run's Full Quality is already\n * running or done (one per run; a failed one may be asked again). Follow\n * the job with `client.jobs.get(jobId)`. No `Idempotency-Key` is taken: the\n * server keys the job by the draft. The new job keeps the draft's origin.\n * Refusals: {@link CastSwapFullQualityRefusalCode}.\n */\n fullQuality(jobId: string, params: CastSwapFullQualityParams = {}): Promise<CastSwapFullQualityResult> {\n const body = params.sessionId !== undefined ? { sessionId: params.sessionId } : {}\n return this.client.request(\"POST\", `/v1/cast-swap/${encodeURIComponent(jobId)}/full-quality`, { body })\n }\n}\n"]}
|