@nodaro/sdk 2.53.1 → 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';
@@ -47,6 +47,31 @@ interface TrendCard {
         width: number;
         height: number;
     };
+    /**
+     * 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). On a trend that hides its
+     * original, its first example instead (then the same as {@link cover}).
+     */
+    original?: {
+        videoUrl: string;
+        posterUrl?: string;
+        width: number;
+        height: number;
+    };
+    /**
+     * 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}). On a trend that hides its original, from
+     * its second example (the first is {@link original}).
+     */
+    examples?: Array<{
+        videoUrl: string;
+        posterUrl?: string;
+        width: number;
+        height: number;
+    }>;
     /** How many slots of each kind the trend has. */
     needs: Record<TrendSlotKind, number>;
     /** The length of a full run, in seconds. */
@@ -61,7 +86,9 @@ 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;
     hint?: string;
@@ -86,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),
@@ -117,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"`. */
@@ -130,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}). */
@@ -142,13 +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. 1–3 pictures per slot.
+     * 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.
-     * 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`).
+     * 1-based example whose pictures fill the optional slots you leave empty
+     * (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>}`. */
@@ -230,10 +272,15 @@ 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;
+    /**
+     * `true` when the slot was left empty and the trend's own default pictures
+     * filled it (`fromExample` is then `false`). Absent otherwise.
+     */
+    fromDefault?: true;
 }
 /**
  * One of your trend runs (`runs()`, `getRun()`). Stays readable after the
@@ -268,10 +315,13 @@ interface TrendRun {
         name: string;
     };
     /**
-     * The 1-based example used for empty optional slots; `0` = the trend had no
-     * example (none was used: 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';
@@ -47,6 +47,31 @@ interface TrendCard {
         width: number;
         height: number;
     };
+    /**
+     * 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). On a trend that hides its
+     * original, its first example instead (then the same as {@link cover}).
+     */
+    original?: {
+        videoUrl: string;
+        posterUrl?: string;
+        width: number;
+        height: number;
+    };
+    /**
+     * 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}). On a trend that hides its original, from
+     * its second example (the first is {@link original}).
+     */
+    examples?: Array<{
+        videoUrl: string;
+        posterUrl?: string;
+        width: number;
+        height: number;
+    }>;
     /** How many slots of each kind the trend has. */
     needs: Record<TrendSlotKind, number>;
     /** The length of a full run, in seconds. */
@@ -61,7 +86,9 @@ 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;
     hint?: string;
@@ -86,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),
@@ -117,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"`. */
@@ -130,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}). */
@@ -142,13 +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. 1–3 pictures per slot.
+     * 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.
-     * 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`).
+     * 1-based example whose pictures fill the optional slots you leave empty
+     * (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>}`. */
@@ -230,10 +272,15 @@ 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;
+    /**
+     * `true` when the slot was left empty and the trend's own default pictures
+     * filled it (`fromExample` is then `false`). Absent otherwise.
+     */
+    fromDefault?: true;
 }
 /**
  * One of your trend runs (`runs()`, `getRun()`). Stays readable after the
@@ -268,10 +315,13 @@ interface TrendRun {
         name: string;
     };
     /**
-     * The 1-based example used for empty optional slots; `0` = the trend had no
-     * example (none was used: 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-35CNQ3WW.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';
 
 /**