@nodaro/sdk 2.29.0 → 2.31.0

package/dist/entries/templates.d.ts

@@ -0,0 +1,110 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Workflow-template marketplace — the PUBLIC-BY-DESIGN surfaces only:
+ * browse cards, a single template with its full snapshot, and the free
+ * clone-into-my-project action. Creator/admin surfaces (publish, mine,
+ * favorites, metadata patch, tutorial flags) are deliberately NOT part of
+ * the public SDK contract; first-party apps reach them via
+ * `client.request()`.
+ */
+/** Card returned by the marketplace browse (no snapshot payload). */
+interface TemplateBrowseCard {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */
+    estimatedCredits: number;
+    /**
+     * Credits per minute of the recording the template is given, when its price
+     * follows that recording's length (an Apply EDL render of a whole episode,
+     * an Edit Plan pass): the price is `estimatedCredits` plus this per minute.
+     * 0 or absent when the price does not depend on a recording's length.
+     */
+    estimatedPerMinuteCredits?: number;
+    /**
+     * The listed price is a range: `estimatedCredits` / `estimatedPerMinuteCredits`
+     * are "from" (the saved settings), these "up to" — the most a run can cost over
+     * the template's exposed fields. Present only when they differ from "from".
+     */
+    maxEstimatedCredits?: number;
+    maxEstimatedPerMinuteCredits?: number;
+    category: string;
+    outputTypes: string[];
+    tags: string[];
+    nodeTypesUsed: string[];
+    providersUsed: string[];
+    nodeCount: number;
+    complexity: string;
+    previewMediaUrl: string | null;
+    previewMediaType: "image" | "video" | null;
+    creatorId: string;
+    creatorDisplayName: string | null;
+    cloneCount: number;
+    favoriteCount: number;
+    createdAt: string;
+}
+type TemplateSort = "newest" | "popular" | "most-favorited";
+interface BrowseTemplatesParams {
+    /** Opaque cursor from the previous page's `nextCursor`. */
+    cursor?: string;
+    limit?: number;
+    category?: string;
+    outputType?: string;
+    tag?: string;
+    /** Full-text search over name/description/tags. */
+    search?: string;
+    sort?: TemplateSort;
+    /** Only templates using this node type. */
+    nodeType?: string;
+    /** Only templates using this provider/model id. */
+    provider?: string;
+    complexity?: string;
+}
+interface BrowseTemplatesResult {
+    data: TemplateBrowseCard[];
+    /** Pass back as `cursor` to fetch the next page; `null` on the last page. */
+    nextCursor: string | null;
+}
+/**
+ * A single public template (`GET /v1/templates/:slug`) — the browse-card
+ * fields plus the full workflow snapshot the viewer/clone consume. The route
+ * returns the whole camelCased row, so additional columns may appear beyond
+ * the ones typed here; the index signature keeps them reachable without
+ * casting.
+ */
+interface Template extends TemplateBrowseCard {
+    markdownDescription: string | null;
+    /** React Flow node snapshots (generic node JSON, execution data stripped on clone). */
+    snapshotNodes: unknown[];
+    snapshotEdges: unknown[];
+    snapshotSettings: Record<string, unknown>;
+    /** Channels the template is listed in (e.g. "marketplace", "tutorial"). */
+    listedIn: string[];
+    readonly [key: string]: unknown;
+}
+interface CloneTemplateParams {
+    /** Target project (must belong to the caller). */
+    projectId: string;
+    /** Optional name for the cloned workflow; defaults to the template's name. */
+    name?: string;
+}
+interface CloneTemplateResult {
+    workflowId: string;
+    projectId: string;
+}
+declare class TemplatesResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** Browse the public template marketplace (cursor-paginated, no auth required). */
+    browse(params?: BrowseTemplatesParams): Promise<BrowseTemplatesResult>;
+    /** Fetch one public template by slug, including its full workflow snapshot. */
+    get(slug: string): Promise<Template>;
+    /** Clone a template into one of the caller's projects. Free — no credits charged. */
+    clone(slug: string, params: CloneTemplateParams): Promise<CloneTemplateResult>;
+}
+
+export { type BrowseTemplatesParams, type BrowseTemplatesResult, type CloneTemplateParams, type CloneTemplateResult, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource };

package/dist/entries/templates.js

@@ -0,0 +1,4 @@
+import '../chunk-LHRQXWI5.js';
+export { TemplatesResource } from '../chunk-6OGGJQVA.js';
+//# sourceMappingURL=templates.js.map
+//# sourceMappingURL=templates.js.map

package/dist/entries/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"templates.js"}

package/dist/entries/tutorials.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-VLCNNA76.cjs');
+var chunkBRV7Z4GD_cjs = require('../chunk-BRV7Z4GD.cjs');
+
+
+
+Object.defineProperty(exports, "TutorialsResource", {
+  enumerable: true,
+  get: function () { return chunkBRV7Z4GD_cjs.TutorialsResource; }
+});
+//# sourceMappingURL=tutorials.cjs.map
+//# sourceMappingURL=tutorials.cjs.map

package/dist/entries/tutorials.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"tutorials.cjs"}

package/dist/entries/tutorials.d.cts

@@ -0,0 +1,63 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Public tutorials directory (`GET /v1/tutorials`) — video tutorials and
+ * flow (template) tutorials, pre-grouped under the shared category taxonomy.
+ * Read-only by design; curation is an admin surface outside the public SDK.
+ */
+interface TutorialVideoItem {
+    id: string;
+    type: "video";
+    title: string;
+    description: string | null;
+    videoUrl: string;
+    thumbnailUrl: string | null;
+    categoryId: string;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** A workflow template surfaced as a tutorial; `slug` feeds `client.templates`. */
+interface TutorialFlowItem {
+    id: string;
+    type: "flow";
+    templateId: string;
+    slug: string | null;
+    title: string;
+    description: string | null;
+    markdownDescription: string | null;
+    previewMediaUrl: string | null;
+    previewMediaType: "image" | "video" | null;
+    complexity: string;
+    /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */
+    estimatedCredits: number;
+    /** Credits per minute of the recording the template is given (see `TemplateBrowseCard`); 0 or absent when none. */
+    estimatedPerMinuteCredits?: number;
+    nodeTypesUsed: string[];
+    providersUsed: string[];
+    nodeCount: number;
+    categoryId: string;
+    tutorialSortOrder: number;
+    workflowId: string;
+    createdAt: string;
+}
+interface TutorialCategory {
+    id: string;
+    name: string;
+    slug: string;
+    sortOrder: number;
+    videos: TutorialVideoItem[];
+    flows: TutorialFlowItem[];
+}
+declare class TutorialsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** All enabled tutorial categories with their videos and flow tutorials. Public. */
+    list(): Promise<{
+        categories: TutorialCategory[];
+    }>;
+}
+
+export { type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource };

package/dist/entries/tutorials.d.ts

@@ -0,0 +1,63 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Public tutorials directory (`GET /v1/tutorials`) — video tutorials and
+ * flow (template) tutorials, pre-grouped under the shared category taxonomy.
+ * Read-only by design; curation is an admin surface outside the public SDK.
+ */
+interface TutorialVideoItem {
+    id: string;
+    type: "video";
+    title: string;
+    description: string | null;
+    videoUrl: string;
+    thumbnailUrl: string | null;
+    categoryId: string;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** A workflow template surfaced as a tutorial; `slug` feeds `client.templates`. */
+interface TutorialFlowItem {
+    id: string;
+    type: "flow";
+    templateId: string;
+    slug: string | null;
+    title: string;
+    description: string | null;
+    markdownDescription: string | null;
+    previewMediaUrl: string | null;
+    previewMediaType: "image" | "video" | null;
+    complexity: string;
+    /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */
+    estimatedCredits: number;
+    /** Credits per minute of the recording the template is given (see `TemplateBrowseCard`); 0 or absent when none. */
+    estimatedPerMinuteCredits?: number;
+    nodeTypesUsed: string[];
+    providersUsed: string[];
+    nodeCount: number;
+    categoryId: string;
+    tutorialSortOrder: number;
+    workflowId: string;
+    createdAt: string;
+}
+interface TutorialCategory {
+    id: string;
+    name: string;
+    slug: string;
+    sortOrder: number;
+    videos: TutorialVideoItem[];
+    flows: TutorialFlowItem[];
+}
+declare class TutorialsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** All enabled tutorial categories with their videos and flow tutorials. Public. */
+    list(): Promise<{
+        categories: TutorialCategory[];
+    }>;
+}
+
+export { type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource };

package/dist/entries/tutorials.js

@@ -0,0 +1,4 @@
+import '../chunk-VT237QF2.js';
+export { TutorialsResource } from '../chunk-DPSMVOM3.js';
+//# sourceMappingURL=tutorials.js.map
+//# sourceMappingURL=tutorials.js.map

package/dist/entries/tutorials.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"tutorials.js"}

package/dist/entries/uploads.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-ZE5RISBZ.cjs');
+var chunkZQQABQMH_cjs = require('../chunk-ZQQABQMH.cjs');
+
+
+
+Object.defineProperty(exports, "UploadsResource", {
+  enumerable: true,
+  get: function () { return chunkZQQABQMH_cjs.UploadsResource; }
+});
+//# sourceMappingURL=uploads.cjs.map
+//# sourceMappingURL=uploads.cjs.map

package/dist/entries/uploads.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"uploads.cjs"}

package/dist/entries/uploads.d.cts

@@ -0,0 +1,44 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Result of a successful `POST /v1/upload`. Mirrors the route's `data` envelope
+ * (`backend/src/routes/upload.ts`), the source of truth — keep in sync if that
+ * response changes. The route also returns loosely-typed extracted `metadata`;
+ * it is omitted here until a consumer needs a typed shape (add it shaped to
+ * that need rather than inventing `Record<string, unknown>` surface now).
+ */
+interface UploadResult {
+    /** Public R2 URL of the stored asset (always present on success). */
+    readonly url: string;
+    /** Storage row id; `null` when no asset row was written (e.g. unauthenticated). */
+    readonly assetId: string | null;
+    /** Generated thumbnail URL (images/video); `null` for audio or on failure. */
+    readonly thumbnailUrl: string | null;
+    /** Server-classified asset category (e.g. "image" | "video" | "audio"). */
+    readonly category: string;
+    /** Display filename (server override or the original). */
+    readonly filename: string;
+    /** Final MIME type after server normalization. */
+    readonly mimeType: string;
+    /** Stored byte size. */
+    readonly sizeBytes: number;
+    /** R2 object key. */
+    readonly r2Key: string;
+}
+declare class UploadsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * Upload one file (`POST /v1/upload`, multipart — the file rides the `file`
+     * field). The SDK's `request` detects the `FormData` body and lets the
+     * runtime set the multipart boundary. Returns the persisted asset's public
+     * URL + storage metadata (unwraps the `{ data }` envelope). Throws
+     * `StorageExceededError` (413) over the storage cap and the SDK's other typed
+     * errors on the usual statuses.
+     */
+    upload(file: File): Promise<UploadResult>;
+}
+
+export { type UploadResult, UploadsResource };

package/dist/entries/uploads.d.ts

@@ -0,0 +1,44 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Result of a successful `POST /v1/upload`. Mirrors the route's `data` envelope
+ * (`backend/src/routes/upload.ts`), the source of truth — keep in sync if that
+ * response changes. The route also returns loosely-typed extracted `metadata`;
+ * it is omitted here until a consumer needs a typed shape (add it shaped to
+ * that need rather than inventing `Record<string, unknown>` surface now).
+ */
+interface UploadResult {
+    /** Public R2 URL of the stored asset (always present on success). */
+    readonly url: string;
+    /** Storage row id; `null` when no asset row was written (e.g. unauthenticated). */
+    readonly assetId: string | null;
+    /** Generated thumbnail URL (images/video); `null` for audio or on failure. */
+    readonly thumbnailUrl: string | null;
+    /** Server-classified asset category (e.g. "image" | "video" | "audio"). */
+    readonly category: string;
+    /** Display filename (server override or the original). */
+    readonly filename: string;
+    /** Final MIME type after server normalization. */
+    readonly mimeType: string;
+    /** Stored byte size. */
+    readonly sizeBytes: number;
+    /** R2 object key. */
+    readonly r2Key: string;
+}
+declare class UploadsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * Upload one file (`POST /v1/upload`, multipart — the file rides the `file`
+     * field). The SDK's `request` detects the `FormData` body and lets the
+     * runtime set the multipart boundary. Returns the persisted asset's public
+     * URL + storage metadata (unwraps the `{ data }` envelope). Throws
+     * `StorageExceededError` (413) over the storage cap and the SDK's other typed
+     * errors on the usual statuses.
+     */
+    upload(file: File): Promise<UploadResult>;
+}
+
+export { type UploadResult, UploadsResource };

package/dist/entries/uploads.js

@@ -0,0 +1,4 @@
+import '../chunk-CGNVHN4V.js';
+export { UploadsResource } from '../chunk-T3SYREY4.js';
+//# sourceMappingURL=uploads.js.map
+//# sourceMappingURL=uploads.js.map

package/dist/entries/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"uploads.js"}

package/dist/entries/video-pro.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-QRHJEITQ.cjs');
+var chunkW5VHATSR_cjs = require('../chunk-W5VHATSR.cjs');
+
+
+
+Object.defineProperty(exports, "VideoProResource", {
+  enumerable: true,
+  get: function () { return chunkW5VHATSR_cjs.VideoProResource; }
+});
+//# sourceMappingURL=video-pro.cjs.map
+//# sourceMappingURL=video-pro.cjs.map

package/dist/entries/video-pro.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"video-pro.cjs"}

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

@@ -0,0 +1,60 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Generate Video Pro control surface (Cloud edition) — the checkpointed
+ * long-video engine's stop/continue operations. The generation itself is
+ * dispatched like any other node (`POST /v1/generate-video-pro`); these
+ * endpoints act on an EXISTING run:
+ *
+ * - `stop(jobId)` — graceful stop: the engine abandons the in-flight segment
+ *   generation (that segment is still billed — the provider keeps rendering
+ *   it), skips all remaining segments, stitches everything completed so far
+ *   into the job's FINAL video, and refunds the untouched remainder of the
+ *   reserve. A job that hasn't started yet is cancelled with a full refund
+ *   instead. Poll the job as usual: it completes with `output_data.pro
+ *   .stopped === true` and `stoppedAtSegment`.
+ *
+ * - `continueRun(jobId, opts?)` — a NEW job that resumes from
+ *   `opts.fromSegment` (1-based; omitted → the first not-yet-delivered
+ *   segment). Segments before it are reused from the parent; everything from
+ *   it on is regenerated (overriding the parent's takes). Charged only for
+ *   the regenerated segments plus the flat pro fee. Works on stopped, failed
+ *   (with ≥1 delivered segment), and fully completed runs (tail re-roll via
+ *   an explicit `fromSegment`).
+ */
+interface StopVideoProResult {
+    jobId: string;
+    /** Present when the run was processing — the engine finalizes within
+     *  seconds; keep polling the job. */
+    stopping?: boolean;
+    /** Present when the job had not started — the generic cancel ran instead
+     *  (full refund). */
+    success?: boolean;
+    cancelled?: number;
+}
+interface ContinueVideoProResult {
+    /** The NEW job to poll — the continuation run. */
+    jobId: string;
+    continuedFromJobId?: string;
+    /** 1-based first regenerated segment. */
+    fromSegment?: number;
+    segmentCount?: number;
+    /** Present when an idempotency key matched an existing continuation. */
+    deduped?: boolean;
+}
+declare class VideoProResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** Gracefully stop a running generate-video-pro job (keep + deliver the
+     *  completed segments; refund the rest). */
+    stop(jobId: string): Promise<StopVideoProResult>;
+    /** Continue a stopped/failed/completed run from a segment (a NEW job).
+     *  Named `continueRun` because `continue` is a reserved word. */
+    continueRun(jobId: string, opts?: {
+        fromSegment?: number;
+    }): Promise<ContinueVideoProResult>;
+}
+
+export { type ContinueVideoProResult, type StopVideoProResult, VideoProResource };

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

@@ -0,0 +1,60 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Generate Video Pro control surface (Cloud edition) — the checkpointed
+ * long-video engine's stop/continue operations. The generation itself is
+ * dispatched like any other node (`POST /v1/generate-video-pro`); these
+ * endpoints act on an EXISTING run:
+ *
+ * - `stop(jobId)` — graceful stop: the engine abandons the in-flight segment
+ *   generation (that segment is still billed — the provider keeps rendering
+ *   it), skips all remaining segments, stitches everything completed so far
+ *   into the job's FINAL video, and refunds the untouched remainder of the
+ *   reserve. A job that hasn't started yet is cancelled with a full refund
+ *   instead. Poll the job as usual: it completes with `output_data.pro
+ *   .stopped === true` and `stoppedAtSegment`.
+ *
+ * - `continueRun(jobId, opts?)` — a NEW job that resumes from
+ *   `opts.fromSegment` (1-based; omitted → the first not-yet-delivered
+ *   segment). Segments before it are reused from the parent; everything from
+ *   it on is regenerated (overriding the parent's takes). Charged only for
+ *   the regenerated segments plus the flat pro fee. Works on stopped, failed
+ *   (with ≥1 delivered segment), and fully completed runs (tail re-roll via
+ *   an explicit `fromSegment`).
+ */
+interface StopVideoProResult {
+    jobId: string;
+    /** Present when the run was processing — the engine finalizes within
+     *  seconds; keep polling the job. */
+    stopping?: boolean;
+    /** Present when the job had not started — the generic cancel ran instead
+     *  (full refund). */
+    success?: boolean;
+    cancelled?: number;
+}
+interface ContinueVideoProResult {
+    /** The NEW job to poll — the continuation run. */
+    jobId: string;
+    continuedFromJobId?: string;
+    /** 1-based first regenerated segment. */
+    fromSegment?: number;
+    segmentCount?: number;
+    /** Present when an idempotency key matched an existing continuation. */
+    deduped?: boolean;
+}
+declare class VideoProResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** Gracefully stop a running generate-video-pro job (keep + deliver the
+     *  completed segments; refund the rest). */
+    stop(jobId: string): Promise<StopVideoProResult>;
+    /** Continue a stopped/failed/completed run from a segment (a NEW job).
+     *  Named `continueRun` because `continue` is a reserved word. */
+    continueRun(jobId: string, opts?: {
+        fromSegment?: number;
+    }): Promise<ContinueVideoProResult>;
+}
+
+export { type ContinueVideoProResult, type StopVideoProResult, VideoProResource };

package/dist/entries/video-pro.js

@@ -0,0 +1,4 @@
+import '../chunk-VPAUN75Q.js';
+export { VideoProResource } from '../chunk-ERLXU47J.js';
+//# sourceMappingURL=video-pro.js.map
+//# sourceMappingURL=video-pro.js.map

package/dist/entries/video-pro.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"video-pro.js"}

package/dist/entries/voices.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-KTTL7BND.cjs');
+var chunkR63TTR35_cjs = require('../chunk-R63TTR35.cjs');
+
+
+
+Object.defineProperty(exports, "VoicesResource", {
+  enumerable: true,
+  get: function () { return chunkR63TTR35_cjs.VoicesResource; }
+});
+//# sourceMappingURL=voices.cjs.map
+//# sourceMappingURL=voices.cjs.map

package/dist/entries/voices.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"voices.cjs"}