@nodaro/sdk 2.54.0 → 2.55.0

package/dist/entries/trends.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import { CastSwapEngine } from './cast-swap.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
@@ -50,7 +50,8 @@ interface TrendCard {
     /**
      * The original's display copy, the same address as {@link TrendDetail.original}
      * (without its length and preview start). Absent on a version without a
-     * display copy (and from an older server).
+     * display copy (and from an older server). On a trend that hides its
+     * original, its first example instead (then the same as {@link cover}).
      */
     original?: {
         videoUrl: string;
@@ -62,7 +63,8 @@ interface TrendCard {
      * Every example's video, in the page's order, so a list can show each clip
      * without reading the trend's page. Empty on a trend with only its original;
      * absent from an older server. The pictures each slot used are on the page
-     * ({@link TrendDetail.examples}).
+     * ({@link TrendDetail.examples}). On a trend that hides its original, from
+     * its second example (the first is {@link original}).
      */
     examples?: Array<{
         videoUrl: string;
@@ -84,7 +86,8 @@ interface TrendDetailSlot {
     kind: TrendSlotKind;
     /**
      * A required slot needs pictures; an optional one left empty takes the
-     * chosen example's, or, on a trend with no example, stays as in the original;
+     * chosen example's, or, on a trend with no example (or when that example has
+     * none for it), stays as in the original;
      * except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
      */
     required: boolean;
@@ -110,20 +113,25 @@ interface TrendExample {
     posterUrl?: string;
     width: number;
     height: number;
-    /** Slot key → the pictures this example used for it. */
+    /**
+     * Slot key → the pictures this example used for it. An optional slot the
+     * example kept as in the original has no key; a run that leaves that slot
+     * empty with this example keeps it as in the original too.
+     */
     slots: Record<string, string[]>;
 }
 /**
  * The clip a trend recasts, as you may show it: a browser-safe copy (H.264
- * MP4) of the clip every run starts from. Its fields parallel
- * {@link TrendExample}'s.
+ * MP4) of the clip every run starts from. On a trend that hides its original,
+ * its first example instead (the original clip is then never sent). Its fields
+ * parallel {@link TrendExample}'s.
  */
 interface TrendOriginal {
     videoUrl: string;
     posterUrl?: string;
     width: number;
     height: number;
-    /** The copy's length, in seconds. */
+    /** The copy's length (on a trend that hides its original, the first example's), in seconds. */
     durationSec: number;
     /**
      * Where the 4-second preview starts in the clip, in seconds (`0` included),
@@ -141,6 +149,7 @@ interface TrendDetail extends TrendCard {
     /**
      * The original clip every run starts from, to show beside the examples.
      * Absent only on a version without a display copy (and from an older server).
+     * On a trend that hides its original, its first example (see {@link TrendOriginal}).
      */
     original?: TrendOriginal;
     /** The engine every run of this trend uses. Absent (an older server) = `"motion-prism"`. */
@@ -154,7 +163,11 @@ interface TrendDetail extends TrendCard {
      */
     resolutions: TrendResolution[];
     slots: TrendDetailSlot[];
-    /** Finished runs to show beside the original; may be empty (a trend with only its original). */
+    /**
+     * Finished runs to show beside the original; may be empty (a trend with only
+     * its original). On a trend that hides its original, from its second example
+     * (the first is {@link original}).
+     */
     examples: TrendExample[];
 }
 /** What you put in one slot of a run: 1–3 pictures, and the chips the slot offers ({@link TrendDetailSlot.chips}). */
@@ -166,14 +179,18 @@ interface TrendRunRequest {
     /**
      * Slot key → what you put in it. Every required slot needs pictures; an
      * optional slot left out takes the chosen example's, or, on a trend with no
-     * example, stays as in the original; except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
+     * example (or when that example has none for it), stays as in the original; except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
      * 1–3 pictures per slot.
      */
     slots: Record<string, TrendRunSlot>;
     /**
      * 1-based example whose pictures fill the optional slots you leave empty
-     * (never in a Full depth trend, which records `example: 0`). Default 1. Leave it out on a trend with no examples: sending one there
-     * answers 400 `example_out_of_range` (and `0` is a `validation_error`).
+     * (never in a Full depth trend, which records `example: 0`), numbering the
+     * examples as {@link TrendDetail.examples} lists them. Default 1. Leave it out on a trend with no examples: sending one there
+     * answers 400 `example_out_of_range` (and `0` is a `validation_error`). On a
+     * trend that hides its original ({@link TrendDetail.original} is its first
+     * example), `1` is still the first entry of `examples`, and leaving it out
+     * fills the slots from the example shown as the original.
      */
     example?: number;
     /** Your own words, at most 1,000 characters. Mention a slot as `{slot:<key>}`. */
@@ -255,8 +272,8 @@ interface TrendRunDisplaySlot extends TrendChips {
     images: string[];
     /**
      * `true` when the slot was left empty and the example's pictures filled it.
-     * `false` with no `images`: left empty on a trend with no example, so it
-     * stayed as in the original.
+     * `false` with no `images`: left empty on a trend with no example, or the
+     * chosen example has no pictures for it, so it stayed as in the original.
      */
     fromExample: boolean;
     /**
@@ -298,10 +315,13 @@ interface TrendRun {
         name: string;
     };
     /**
-     * The 1-based example used for empty optional slots; `0` = none was used (the
-     * trend had no example, or is a Full depth trend): never show it as "Example 0".
+     * The 1-based example used for empty optional slots, numbered as the trend's
+     * page listed its examples for the version the run ran on ({@link trend}'s
+     * `version`); `0` = none was used (the trend had no example, or is a Full
+     * depth trend): never show it as "Example 0". Absent when the run used the
+     * example a trend that hides its original shows as its original.
      */
-    example: number;
+    example?: number;
     slots: TrendRunDisplaySlot[];
     details?: string;
     preview: boolean;

package/dist/entries/trends.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import { CastSwapEngine } from './cast-swap.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
@@ -50,7 +50,8 @@ interface TrendCard {
     /**
      * The original's display copy, the same address as {@link TrendDetail.original}
      * (without its length and preview start). Absent on a version without a
-     * display copy (and from an older server).
+     * display copy (and from an older server). On a trend that hides its
+     * original, its first example instead (then the same as {@link cover}).
      */
     original?: {
         videoUrl: string;
@@ -62,7 +63,8 @@ interface TrendCard {
      * Every example's video, in the page's order, so a list can show each clip
      * without reading the trend's page. Empty on a trend with only its original;
      * absent from an older server. The pictures each slot used are on the page
-     * ({@link TrendDetail.examples}).
+     * ({@link TrendDetail.examples}). On a trend that hides its original, from
+     * its second example (the first is {@link original}).
      */
     examples?: Array<{
         videoUrl: string;
@@ -84,7 +86,8 @@ interface TrendDetailSlot {
     kind: TrendSlotKind;
     /**
      * A required slot needs pictures; an optional one left empty takes the
-     * chosen example's, or, on a trend with no example, stays as in the original;
+     * chosen example's, or, on a trend with no example (or when that example has
+     * none for it), stays as in the original;
      * except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
      */
     required: boolean;
@@ -110,20 +113,25 @@ interface TrendExample {
     posterUrl?: string;
     width: number;
     height: number;
-    /** Slot key → the pictures this example used for it. */
+    /**
+     * Slot key → the pictures this example used for it. An optional slot the
+     * example kept as in the original has no key; a run that leaves that slot
+     * empty with this example keeps it as in the original too.
+     */
     slots: Record<string, string[]>;
 }
 /**
  * The clip a trend recasts, as you may show it: a browser-safe copy (H.264
- * MP4) of the clip every run starts from. Its fields parallel
- * {@link TrendExample}'s.
+ * MP4) of the clip every run starts from. On a trend that hides its original,
+ * its first example instead (the original clip is then never sent). Its fields
+ * parallel {@link TrendExample}'s.
  */
 interface TrendOriginal {
     videoUrl: string;
     posterUrl?: string;
     width: number;
     height: number;
-    /** The copy's length, in seconds. */
+    /** The copy's length (on a trend that hides its original, the first example's), in seconds. */
     durationSec: number;
     /**
      * Where the 4-second preview starts in the clip, in seconds (`0` included),
@@ -141,6 +149,7 @@ interface TrendDetail extends TrendCard {
     /**
      * The original clip every run starts from, to show beside the examples.
      * Absent only on a version without a display copy (and from an older server).
+     * On a trend that hides its original, its first example (see {@link TrendOriginal}).
      */
     original?: TrendOriginal;
     /** The engine every run of this trend uses. Absent (an older server) = `"motion-prism"`. */
@@ -154,7 +163,11 @@ interface TrendDetail extends TrendCard {
      */
     resolutions: TrendResolution[];
     slots: TrendDetailSlot[];
-    /** Finished runs to show beside the original; may be empty (a trend with only its original). */
+    /**
+     * Finished runs to show beside the original; may be empty (a trend with only
+     * its original). On a trend that hides its original, from its second example
+     * (the first is {@link original}).
+     */
     examples: TrendExample[];
 }
 /** What you put in one slot of a run: 1–3 pictures, and the chips the slot offers ({@link TrendDetailSlot.chips}). */
@@ -166,14 +179,18 @@ interface TrendRunRequest {
     /**
      * Slot key → what you put in it. Every required slot needs pictures; an
      * optional slot left out takes the chosen example's, or, on a trend with no
-     * example, stays as in the original; except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
+     * example (or when that example has none for it), stays as in the original; except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
      * 1–3 pictures per slot.
      */
     slots: Record<string, TrendRunSlot>;
     /**
      * 1-based example whose pictures fill the optional slots you leave empty
-     * (never in a Full depth trend, which records `example: 0`). Default 1. Leave it out on a trend with no examples: sending one there
-     * answers 400 `example_out_of_range` (and `0` is a `validation_error`).
+     * (never in a Full depth trend, which records `example: 0`), numbering the
+     * examples as {@link TrendDetail.examples} lists them. Default 1. Leave it out on a trend with no examples: sending one there
+     * answers 400 `example_out_of_range` (and `0` is a `validation_error`). On a
+     * trend that hides its original ({@link TrendDetail.original} is its first
+     * example), `1` is still the first entry of `examples`, and leaving it out
+     * fills the slots from the example shown as the original.
      */
     example?: number;
     /** Your own words, at most 1,000 characters. Mention a slot as `{slot:<key>}`. */
@@ -255,8 +272,8 @@ interface TrendRunDisplaySlot extends TrendChips {
     images: string[];
     /**
      * `true` when the slot was left empty and the example's pictures filled it.
-     * `false` with no `images`: left empty on a trend with no example, so it
-     * stayed as in the original.
+     * `false` with no `images`: left empty on a trend with no example, or the
+     * chosen example has no pictures for it, so it stayed as in the original.
      */
     fromExample: boolean;
     /**
@@ -298,10 +315,13 @@ interface TrendRun {
         name: string;
     };
     /**
-     * The 1-based example used for empty optional slots; `0` = none was used (the
-     * trend had no example, or is a Full depth trend): never show it as "Example 0".
+     * The 1-based example used for empty optional slots, numbered as the trend's
+     * page listed its examples for the version the run ran on ({@link trend}'s
+     * `version`); `0` = none was used (the trend had no example, or is a Full
+     * depth trend): never show it as "Example 0". Absent when the run used the
+     * example a trend that hides its original shows as its original.
      */
-    example: number;
+    example?: number;
     slots: TrendRunDisplaySlot[];
     details?: string;
     preview: boolean;

package/dist/entries/trends.js

@@ -1,4 +1,4 @@
 import '../chunk-YCVRQZT3.js';
-export { TrendsResource } from '../chunk-HAVIVOLO.js';
+export { TrendsResource } from '../chunk-HFYNZ4SO.js';
 //# sourceMappingURL=trends.js.map
 //# sourceMappingURL=trends.js.map

package/dist/entries/tutorials.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/tutorials.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/uploads.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/uploads.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/user-settings.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/user-settings.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/video-pro.d.cts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/video-pro.d.ts

@@ -1,4 +1,4 @@
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/voices.d.cts

@@ -3,7 +3,7 @@ export { SharedVoice, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryRespons
 import { AudioFxPreset } from '@nodaro/shared/media';
 export { AudioFxPreset } from '@nodaro/shared/media';
 import { DialogueProvider } from '@nodaro/shared/models';
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/voices.d.ts

@@ -3,7 +3,7 @@ export { SharedVoice, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryRespons
 import { AudioFxPreset } from '@nodaro/shared/media';
 export { AudioFxPreset } from '@nodaro/shared/media';
 import { DialogueProvider } from '@nodaro/shared/models';
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 

package/dist/entries/webhooks.d.cts

@@ -1,6 +1,6 @@
-import { f as WebhookEvent } from '../webhooks-Dn_DtNTD.cjs';
-export { C as CreateWebhookEndpointInput, a as CreatedWebhookEndpoint, J as JobWebhookEvent, L as ListWebhookDeliveriesParams, P as PingWebhookEvent, R as RotateWebhookSecretInput, b as RotatedWebhookSecret, U as UpdateWebhookEndpointInput, W as WebhookDelivery, c as WebhookDeliveryPage, d as WebhookDeliveryStatus, e as WebhookEndpoint, g as WebhookEventType, h as WebhookJobEvent, i as WebhooksResource } from '../webhooks-Dn_DtNTD.cjs';
-import '../developer-apps-zSQXWmEG.cjs';
+import { f as WebhookEvent } from '../webhooks-tg3VN39V.cjs';
+export { C as CreateWebhookEndpointInput, a as CreatedWebhookEndpoint, J as JobWebhookEvent, L as ListWebhookDeliveriesParams, P as PingWebhookEvent, R as RotateWebhookSecretInput, b as RotatedWebhookSecret, U as UpdateWebhookEndpointInput, W as WebhookDelivery, c as WebhookDeliveryPage, d as WebhookDeliveryStatus, e as WebhookEndpoint, g as WebhookEventType, h as WebhookJobEvent, i as WebhooksResource } from '../webhooks-tg3VN39V.cjs';
+import '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import './jobs.cjs';

package/dist/entries/webhooks.d.ts

@@ -1,6 +1,6 @@
-import { f as WebhookEvent } from '../webhooks-BJawEIz8.js';
-export { C as CreateWebhookEndpointInput, a as CreatedWebhookEndpoint, J as JobWebhookEvent, L as ListWebhookDeliveriesParams, P as PingWebhookEvent, R as RotateWebhookSecretInput, b as RotatedWebhookSecret, U as UpdateWebhookEndpointInput, W as WebhookDelivery, c as WebhookDeliveryPage, d as WebhookDeliveryStatus, e as WebhookEndpoint, g as WebhookEventType, h as WebhookJobEvent, i as WebhooksResource } from '../webhooks-BJawEIz8.js';
-import '../developer-apps-zSQXWmEG.js';
+import { f as WebhookEvent } from '../webhooks-C2DZTK4n.js';
+export { C as CreateWebhookEndpointInput, a as CreatedWebhookEndpoint, J as JobWebhookEvent, L as ListWebhookDeliveriesParams, P as PingWebhookEvent, R as RotateWebhookSecretInput, b as RotatedWebhookSecret, U as UpdateWebhookEndpointInput, W as WebhookDelivery, c as WebhookDeliveryPage, d as WebhookDeliveryStatus, e as WebhookEndpoint, g as WebhookEventType, h as WebhookJobEvent, i as WebhooksResource } from '../webhooks-C2DZTK4n.js';
+import '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import './jobs.js';

package/dist/entries/workflows.d.cts

@@ -2,7 +2,7 @@ import { GenericNode, GenericEdge } from '@nodaro/shared/types';
 export { GenericEdge, GenericNode } from '@nodaro/shared/types';
 import { WorkflowExport, WorkflowImportReport } from '@nodaro/shared/workflow';
 export { WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject } from '@nodaro/shared/workflow';
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import { CollaboratorRole, WorkflowVisibility } from '@nodaro/shared/organizations';
 import '@nodaro/shared/apps';
 

package/dist/entries/workflows.d.ts

@@ -2,7 +2,7 @@ import { GenericNode, GenericEdge } from '@nodaro/shared/types';
 export { GenericEdge, GenericNode } from '@nodaro/shared/types';
 import { WorkflowExport, WorkflowImportReport } from '@nodaro/shared/workflow';
 export { WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject } from '@nodaro/shared/workflow';
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import { CollaboratorRole, WorkflowVisibility } from '@nodaro/shared/organizations';
 import '@nodaro/shared/apps';
 

package/dist/entries/workspaces.d.cts

@@ -1,5 +1,5 @@
 import { WorkspaceSettings, WorkspaceSummary, WorkspaceView, OrgPage, WorkspaceMemberView, WorkspaceRole, MemberStatus, JoinCodeView, UsageQuery, UsageReport, UsageLogEntry } from '@nodaro/shared/organizations';
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/apps';
 
 /**

package/dist/entries/workspaces.d.ts

@@ -1,5 +1,5 @@
 import { WorkspaceSettings, WorkspaceSummary, WorkspaceView, OrgPage, WorkspaceMemberView, WorkspaceRole, MemberStatus, JoinCodeView, UsageQuery, UsageReport, UsageLogEntry } from '@nodaro/shared/organizations';
-import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/apps';
 
 /**