@nodaro/sdk 2.55.0 → 2.57.0

package/dist/entries/errors.d.ts

@@ -21,7 +21,31 @@ declare class UnauthorizedError extends NodaroError {
 }
 declare class ForbiddenError extends NodaroError {
     readonly missingScope?: string | undefined;
-    constructor(message?: string, missingScope?: string | undefined);
+    /** `code` defaults to `"forbidden"`; {@link ModelUnavailableError} passes its own. */
+    constructor(message?: string, missingScope?: string | undefined, code?: string);
+}
+type ModelUnavailableCode = "model_not_available" | "model_disabled";
+/**
+ * The 403 codes {@link ModelUnavailableError} carries: a model this
+ * deployment does not offer (`model_not_available` — outside its edition or
+ * surface, or hidden by its operator) and a model an admin switched off on
+ * the models page (`model_disabled`).
+ */
+declare const MODEL_UNAVAILABLE_CODES: ReadonlySet<ModelUnavailableCode>;
+/**
+ * HTTP 403 refusing the MODEL, not the caller: this deployment does not offer
+ * it, or an admin switched it off. Answered by the credit guard before any
+ * credits are held (the LLM and pipeline lanes still answer a switched-off
+ * model with a 402 for now).
+ * Choosing another model is the remedy — retrying, topping up or a wider
+ * scope changes nothing. A {@link ForbiddenError}, so existing catches keep
+ * working; `code` is the server's own code and says which. The envelope
+ * names no model: what was refused is the request's own `provider` (or, for
+ * a fan-out, one of its `models`).
+ */
+declare class ModelUnavailableError extends ForbiddenError {
+    readonly code: ModelUnavailableCode;
+    constructor(code: ModelUnavailableCode, message?: string);
 }
 declare class NotFoundError extends NodaroError {
     constructor(message?: string);
@@ -62,9 +86,20 @@ declare class CreditCapExceededError extends InsufficientCreditsError {
     readonly code: CreditCapCode;
     constructor(code: CreditCapCode, message?: string, required?: number, available?: number);
 }
+/**
+ * HTTP 413: what was sent does not fit. `code` is always `storage_exceeded`;
+ * `reason` is the platform's own code, when the answer carried one:
+ * `storage_limit_exceeded` is a full storage, while `file_too_large` is a
+ * single file over the limit, not a full storage (likewise
+ * `payload_too_large`, `post_too_large`, `duration_exceeded`).
+ */
 declare class StorageExceededError extends NodaroError {
     readonly limitBytes?: number | undefined;
-    constructor(message?: string, limitBytes?: number | undefined);
+    /** The platform's own code for this 413, e.g. `storage_limit_exceeded` or `file_too_large`. */
+    readonly reason?: string | undefined;
+    constructor(message?: string, limitBytes?: number | undefined, 
+    /** The platform's own code for this 413, e.g. `storage_limit_exceeded` or `file_too_large`. */
+    reason?: string | undefined);
 }
 /**
  * Optimistic-concurrency rejection (HTTP 409 `workflow_conflict`): the workflow
@@ -373,4 +408,4 @@ interface ApiErrorBody {
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, type CreditCapCode, CreditCapExceededError, ForbiddenError, type HeldFinalRun, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, type WorkflowConflictCode, WorkflowConflictError, throwFromResponse };
+export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, type CreditCapCode, CreditCapExceededError, ForbiddenError, type HeldFinalRun, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, MODEL_UNAVAILABLE_CODES, type ModelUnavailableCode, ModelUnavailableError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, type WorkflowConflictCode, WorkflowConflictError, throwFromResponse };

package/dist/entries/errors.js

@@ -1,4 +1,4 @@
 import '../chunk-CJFIOVBA.js';
-export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, CreditCapExceededError, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictError, throwFromResponse } from '../chunk-L6T44A3G.js';
+export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, CreditCapExceededError, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, MODEL_UNAVAILABLE_CODES, ModelUnavailableError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictError, throwFromResponse } from '../chunk-JJMQ2EVL.js';
 //# sourceMappingURL=errors.js.map
 //# sourceMappingURL=errors.js.map

package/dist/entries/locations.d.cts

@@ -2,7 +2,7 @@ import { LocationAssetType, CharacterAspectRatio, LocationAttachColumn, Surround
 export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.cjs';
-import { l as GenerationSessionParams } from '../nodes-Ceetyyh0.cjs';
+import { l as GenerationSessionParams } from '../nodes-BZavad1T.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/locations.d.ts

@@ -2,7 +2,7 @@ import { LocationAssetType, CharacterAspectRatio, LocationAttachColumn, Surround
 export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.js';
-import { l as GenerationSessionParams } from '../nodes-B74WaY9r.js';
+import { l as GenerationSessionParams } from '../nodes-1u7MPrD5.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/media.cjs

@@ -1,15 +1,15 @@
 'use strict';
 
 require('../chunk-RHETJOUM.cjs');
-var chunkXALPYUZI_cjs = require('../chunk-XALPYUZI.cjs');
-require('../chunk-FRQJNGJS.cjs');
-require('../chunk-FM2KM5TY.cjs');
+var chunk3Y5TDB5K_cjs = require('../chunk-3Y5TDB5K.cjs');
+require('../chunk-KU3UITCU.cjs');
+require('../chunk-GSE7SB3I.cjs');
 
 
 
 Object.defineProperty(exports, "MediaResource", {
   enumerable: true,
-  get: function () { return chunkXALPYUZI_cjs.MediaResource; }
+  get: function () { return chunk3Y5TDB5K_cjs.MediaResource; }
 });
 //# sourceMappingURL=media.cjs.map
 //# sourceMappingURL=media.cjs.map

package/dist/entries/media.js

@@ -1,6 +1,6 @@
 import '../chunk-ES2E65HT.js';
-export { MediaResource } from '../chunk-24JE54FQ.js';
-import '../chunk-7CUWAVWB.js';
-import '../chunk-L6T44A3G.js';
+export { MediaResource } from '../chunk-ND7JMM5H.js';
+import '../chunk-YYMX3VN7.js';
+import '../chunk-JJMQ2EVL.js';
 //# sourceMappingURL=media.js.map
 //# sourceMappingURL=media.js.map

package/dist/entries/nodes.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 var chunk7CK6I4CT_cjs = require('../chunk-7CK6I4CT.cjs');
-var chunkVHTDOACT_cjs = require('../chunk-VHTDOACT.cjs');
-require('../chunk-FM2KM5TY.cjs');
+var chunkGWTKYJJO_cjs = require('../chunk-GWTKYJJO.cjs');
+require('../chunk-GSE7SB3I.cjs');
 
 
 
@@ -16,7 +16,7 @@ Object.defineProperty(exports, "PROMPT_SUFFIX_KEY", {
 });
 Object.defineProperty(exports, "NodesResource", {
   enumerable: true,
-  get: function () { return chunkVHTDOACT_cjs.NodesResource; }
+  get: function () { return chunkGWTKYJJO_cjs.NodesResource; }
 });
 //# sourceMappingURL=nodes.cjs.map
 //# sourceMappingURL=nodes.cjs.map

package/dist/entries/nodes.d.cts

@@ -4,7 +4,7 @@ export { GeminiOmniVoicePresetId, ImageAspectRatio, ImageEditProvider, ImageEdit
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PromptAffixFields } from '@nodaro/shared/nodes';
 export { SocialPlatform, SocialPost, SocialPostAuthor, SocialPostMedia, SocialPostMetrics, SocialSearchCount, SocialSearchMode, SocialSearchParams, SocialSearchPeriod, SocialSearchSort, SocialSearchVideoKind } from '@nodaro/shared/social';
 export { GenerateMaskOutput, GenerateMaskRequest, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution } from '@nodaro/shared/media';
-export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-Ceetyyh0.cjs';
+export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-BZavad1T.cjs';
 export { TopazUpscaleFactor } from '@nodaro/shared/credits';
 export { ImageToImageAttachColumn } from '@nodaro/shared/entities';
 import '@nodaro/shared/scene3d';

package/dist/entries/nodes.d.ts

@@ -4,7 +4,7 @@ export { GeminiOmniVoicePresetId, ImageAspectRatio, ImageEditProvider, ImageEdit
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PromptAffixFields } from '@nodaro/shared/nodes';
 export { SocialPlatform, SocialPost, SocialPostAuthor, SocialPostMedia, SocialPostMetrics, SocialSearchCount, SocialSearchMode, SocialSearchParams, SocialSearchPeriod, SocialSearchSort, SocialSearchVideoKind } from '@nodaro/shared/social';
 export { GenerateMaskOutput, GenerateMaskRequest, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution } from '@nodaro/shared/media';
-export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-B74WaY9r.js';
+export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-1u7MPrD5.js';
 export { TopazUpscaleFactor } from '@nodaro/shared/credits';
 export { ImageToImageAttachColumn } from '@nodaro/shared/entities';
 import '@nodaro/shared/scene3d';

package/dist/entries/nodes.js

@@ -1,5 +1,5 @@
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY } from '../chunk-ZYPH2FPT.js';
-export { NodesResource } from '../chunk-47ULSVO2.js';
-import '../chunk-L6T44A3G.js';
+export { NodesResource } from '../chunk-ALDXFMD7.js';
+import '../chunk-JJMQ2EVL.js';
 //# sourceMappingURL=nodes.js.map
 //# sourceMappingURL=nodes.js.map

package/dist/entries/objects.d.cts

@@ -2,7 +2,7 @@ import { ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio } from '@nodaro/
 export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.cjs';
-import { l as GenerationSessionParams } from '../nodes-Ceetyyh0.cjs';
+import { l as GenerationSessionParams } from '../nodes-BZavad1T.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/objects.d.ts

@@ -2,7 +2,7 @@ import { ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio } from '@nodaro/
 export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.js';
-import { l as GenerationSessionParams } from '../nodes-B74WaY9r.js';
+import { l as GenerationSessionParams } from '../nodes-1u7MPrD5.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';

package/dist/entries/scene3d.d.cts

@@ -1,5 +1,5 @@
-import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-Ceetyyh0.cjs';
-export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-Ceetyyh0.cjs';
+import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-BZavad1T.cjs';
+export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-BZavad1T.cjs';
 import { Scene3DAssetRef } from '@nodaro/shared/scene3d';
 import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
 import '@nodaro/shared/types';

package/dist/entries/scene3d.d.ts

@@ -1,5 +1,5 @@
-import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-B74WaY9r.js';
-export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-B74WaY9r.js';
+import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-1u7MPrD5.js';
+export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-1u7MPrD5.js';
 import { Scene3DAssetRef } from '@nodaro/shared/scene3d';
 import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
 import '@nodaro/shared/types';

package/dist/entries/studio.cjs

@@ -1,22 +1,22 @@
 'use strict';
 
 require('../chunk-ZJGFLJ2Z.cjs');
-var chunkNKH2UFSD_cjs = require('../chunk-NKH2UFSD.cjs');
-require('../chunk-FM2KM5TY.cjs');
+var chunkTSM3S2QS_cjs = require('../chunk-TSM3S2QS.cjs');
+require('../chunk-GSE7SB3I.cjs');
 
 
 
 Object.defineProperty(exports, "StudioProductionsResource", {
   enumerable: true,
-  get: function () { return chunkNKH2UFSD_cjs.StudioProductionsResource; }
+  get: function () { return chunkTSM3S2QS_cjs.StudioProductionsResource; }
 });
 Object.defineProperty(exports, "StudioResource", {
   enumerable: true,
-  get: function () { return chunkNKH2UFSD_cjs.StudioResource; }
+  get: function () { return chunkTSM3S2QS_cjs.StudioResource; }
 });
 Object.defineProperty(exports, "isStudioGenerateEstimate", {
   enumerable: true,
-  get: function () { return chunkNKH2UFSD_cjs.isStudioGenerateEstimate; }
+  get: function () { return chunkTSM3S2QS_cjs.isStudioGenerateEstimate; }
 });
 //# sourceMappingURL=studio.cjs.map
 //# sourceMappingURL=studio.cjs.map

package/dist/entries/studio.js

@@ -1,5 +1,5 @@
 import '../chunk-PMTM26LL.js';
-export { StudioProductionsResource, StudioResource, isStudioGenerateEstimate } from '../chunk-AUKHMT53.js';
-import '../chunk-L6T44A3G.js';
+export { StudioProductionsResource, StudioResource, isStudioGenerateEstimate } from '../chunk-VTL4DBX4.js';
+import '../chunk-JJMQ2EVL.js';
 //# sourceMappingURL=studio.js.map
 //# sourceMappingURL=studio.js.map

package/dist/entries/uploads.cjs

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

package/dist/entries/uploads.d.cts

@@ -39,6 +39,24 @@ declare class UploadsResource {
      * errors on the usual statuses.
      */
     upload(file: File): Promise<UploadResult>;
+    /**
+     * Copy a picture from a web address into your storage
+     * (`POST /v1/media/import-url`, body `{ url }`). The platform fetches it
+     * (http(s) only, never a private address, up to 20 MB), keeps it only if it
+     * decodes as an image (JPEG, PNG, WebP, GIF; HEIC/HEIF and AVIF are
+     * converted to JPEG or PNG), and stores it as an upload of yours, so its address serves
+     * the pixels to the browser (a canvas can read it). Returns the stored
+     * picture (unwraps the `{ data }` envelope).
+     *
+     * Throws `StorageExceededError` on a 413, its `reason` telling the two
+     * apart: `storage_limit_exceeded` is a full storage (the quota is in
+     * `details` — `usedBytes`, `quotaBytes`, `remainingBytes`, `tier`), and
+     * `file_too_large` a picture over 20 MB. Throws a `NodaroError` with `code`
+     * `validation_error` (400: not an http(s) address, or not an image) or
+     * `fetch_failed` (422: the address could not be reached or answered with an
+     * error).
+     */
+    importUrl(url: string): Promise<ImportUrlResult>;
     /**
      * Store a JSON document (`POST /v1/upload-json`, up to 25 MB) and get its
      * public URL — e.g. an image editor's design state, passed to
@@ -53,5 +71,27 @@ interface UploadJsonResult {
     /** Public URL of the stored JSON document. */
     readonly url: string;
 }
+/**
+ * Result of {@link UploadsResource.importUrl}. Mirrors the route's `data`:
+ * the fields of {@link UploadResult} it shares, plus the picture's size.
+ */
+interface ImportUrlResult {
+    /** Public URL of the stored picture. */
+    readonly url: string;
+    /** Generated thumbnail URL; `null` when it could not be made. */
+    readonly thumbnailUrl: string | null;
+    /** Storage row id; `null` when no asset row was written. */
+    readonly assetId: string | null;
+    /** Final MIME type (a HEIC/HEIF or AVIF source is stored as JPEG or PNG). */
+    readonly mimeType: string;
+    /** Stored byte size. */
+    readonly sizeBytes: number;
+    /** Display filename: the address's last path segment, else `imported-<id>.<ext>`. */
+    readonly filename: string;
+    /** Width in pixels; 0 when it could not be read. */
+    readonly width: number;
+    /** Height in pixels; 0 when it could not be read. */
+    readonly height: number;
+}
 
-export { type UploadJsonResult, type UploadResult, UploadsResource };
+export { type ImportUrlResult, type UploadJsonResult, type UploadResult, UploadsResource };

package/dist/entries/uploads.d.ts

@@ -39,6 +39,24 @@ declare class UploadsResource {
      * errors on the usual statuses.
      */
     upload(file: File): Promise<UploadResult>;
+    /**
+     * Copy a picture from a web address into your storage
+     * (`POST /v1/media/import-url`, body `{ url }`). The platform fetches it
+     * (http(s) only, never a private address, up to 20 MB), keeps it only if it
+     * decodes as an image (JPEG, PNG, WebP, GIF; HEIC/HEIF and AVIF are
+     * converted to JPEG or PNG), and stores it as an upload of yours, so its address serves
+     * the pixels to the browser (a canvas can read it). Returns the stored
+     * picture (unwraps the `{ data }` envelope).
+     *
+     * Throws `StorageExceededError` on a 413, its `reason` telling the two
+     * apart: `storage_limit_exceeded` is a full storage (the quota is in
+     * `details` — `usedBytes`, `quotaBytes`, `remainingBytes`, `tier`), and
+     * `file_too_large` a picture over 20 MB. Throws a `NodaroError` with `code`
+     * `validation_error` (400: not an http(s) address, or not an image) or
+     * `fetch_failed` (422: the address could not be reached or answered with an
+     * error).
+     */
+    importUrl(url: string): Promise<ImportUrlResult>;
     /**
      * Store a JSON document (`POST /v1/upload-json`, up to 25 MB) and get its
      * public URL — e.g. an image editor's design state, passed to
@@ -53,5 +71,27 @@ interface UploadJsonResult {
     /** Public URL of the stored JSON document. */
     readonly url: string;
 }
+/**
+ * Result of {@link UploadsResource.importUrl}. Mirrors the route's `data`:
+ * the fields of {@link UploadResult} it shares, plus the picture's size.
+ */
+interface ImportUrlResult {
+    /** Public URL of the stored picture. */
+    readonly url: string;
+    /** Generated thumbnail URL; `null` when it could not be made. */
+    readonly thumbnailUrl: string | null;
+    /** Storage row id; `null` when no asset row was written. */
+    readonly assetId: string | null;
+    /** Final MIME type (a HEIC/HEIF or AVIF source is stored as JPEG or PNG). */
+    readonly mimeType: string;
+    /** Stored byte size. */
+    readonly sizeBytes: number;
+    /** Display filename: the address's last path segment, else `imported-<id>.<ext>`. */
+    readonly filename: string;
+    /** Width in pixels; 0 when it could not be read. */
+    readonly width: number;
+    /** Height in pixels; 0 when it could not be read. */
+    readonly height: number;
+}
 
-export { type UploadJsonResult, type UploadResult, UploadsResource };
+export { type ImportUrlResult, type UploadJsonResult, type UploadResult, UploadsResource };

package/dist/entries/uploads.js

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