@picsart/ai-sdk 3.17.6 → 3.19.0

package/index.d.ts

@@ -1223,32 +1223,13 @@ type ModelInputById = {
         resolution?: "720p" | "1024p" | "1080p";
         duration?: 4 | 8 | 12 | 16 | 20;
     };
-    "topaz-enhance-cgi": {
-        imageUrls: [string, ...string[]];
-    };
-    "topaz-enhance-high-fidelity-v2": {
-        imageUrls: [string, ...string[]];
-    };
-    "topaz-enhance-low-res-v2": {
-        imageUrls: [string, ...string[]];
-    };
-    "topaz-enhance-recovery": {
-        imageUrls: [string, ...string[]];
-    };
-    "topaz-enhance-recovery-v2": {
-        imageUrls: [string, ...string[]];
-    };
-    "topaz-enhance-redefine": {
-        imageUrls: [string, ...string[]];
-    };
-    "topaz-enhance-standard-v2": {
-        imageUrls: [string, ...string[]];
-    };
-    "topaz-enhance-text-refine": {
-        imageUrls: [string, ...string[]];
-    };
     "topaz-upscale-image": {
         imageUrls: [string, ...string[]];
+        model?: "Standard V2" | "Standard MAX" | "Low Resolution V2" | "High Fidelity V2" | "CGI" | "Text Refine" | "Redefine" | "Recovery" | "Recovery V2" | "Wonder" | "Wonder 3";
+    };
+    "topaz-upscale-video": {
+        videoUrl: string;
+        model?: "Proteus" | "Artemis HQ" | "Artemis MQ" | "Artemis LQ" | "Nyx" | "Nyx Fast" | "Nyx XL" | "Nyx HF" | "Gaia HQ" | "Gaia CG" | "Gaia 2" | "Starlight Precise 1" | "Starlight Precise 2" | "Starlight Precise 2.5" | "Starlight HQ" | "Starlight Mini" | "Starlight Sharp" | "Starlight Fast 1" | "Starlight Fast 2";
     };
     "veed-fabric-v1": {
         prompt?: string;
@@ -1798,6 +1779,8 @@ interface ModelMeta {
     readonly features: ModelFeature[];
     readonly badges: BadgeType[];
     readonly provider: ProviderInfo;
+    /** Release / availability tier (EAI-3). Absent on the definition ⇒ `'production'`. */
+    readonly release: ReleaseTag;
 }
 /** Parameter operations — fluent access to model params, schemas, defaults. */
 interface ModelParamsAccessor {
@@ -1870,6 +1853,14 @@ interface ModelDescriptor {
 interface ModelFilter$1 {
     output?: GenerationMode;
     provider?: string;
+    /**
+     * Release tiers to include. Omitted ⇒ the default visible set
+     * (`['production', 'general-availability']`). List the tiers you want
+     * explicitly to opt into `preview` — e.g. `['preview']` for stage-only
+     * models, or all three to include everything. `disabled`/`deprecated`
+     * models stay hidden regardless.
+     */
+    release?: ReleaseTag[];
 }
 
 type AppProvider = 'picsart' | 'google' | 'kling' | 'grok' | 'openai' | 'flux' | 'ideogram' | 'elevenlabs' | 'minimax' | 'wan' | 'seedance' | 'ltx' | 'seedream' | 'hunyuan' | 'pika' | 'runway' | 'luma' | 'ovi' | 'creatify' | 'veed' | 'bytedance' | 'qwen' | 'reve' | 'recraft' | 'videography' | 'topaz' | 'heygen' | 'happyhorse' | 'pixverse' | 'anthropic' | 'async';
@@ -2007,6 +1998,12 @@ interface Constraint {
     then: Record<string, Restriction>;
 }
 type BadgeType = 'new' | 'popular' | 'coming-soon' | 'fast' | 'premium' | 'hot';
+/**
+ * Model release / availability tier. See `ModelDefinition.release`.
+ * Ordered widest-exposure-last: `preview` (stage only) → `production` (our
+ * apps) → `general-availability` (enterprise / external use).
+ */
+type ReleaseTag = 'preview' | 'production' | 'general-availability';
 interface ModelDefinition {
     id: string;
     name: string;
@@ -2038,6 +2035,7 @@ interface ModelDefinition {
      * from default catalog lookups, same as `disabled`.
      */
     deprecated?: boolean;
+    release?: ReleaseTag;
     mode: GenerationMode;
     inputType: InputType;
     modelId?: string;
@@ -2242,15 +2240,8 @@ declare const Models: {
     readonly Sora2: "sora-2";
     readonly Sora2Extend: "sora-2-extend";
     readonly Sora2Pro: "sora-2-pro";
-    readonly TopazEnhanceCgi: "topaz-enhance-cgi";
-    readonly TopazEnhanceHighFidelityV2: "topaz-enhance-high-fidelity-v2";
-    readonly TopazEnhanceLowResV2: "topaz-enhance-low-res-v2";
-    readonly TopazEnhanceRecovery: "topaz-enhance-recovery";
-    readonly TopazEnhanceRecoveryV2: "topaz-enhance-recovery-v2";
-    readonly TopazEnhanceRedefine: "topaz-enhance-redefine";
-    readonly TopazEnhanceStandardV2: "topaz-enhance-standard-v2";
-    readonly TopazEnhanceTextRefine: "topaz-enhance-text-refine";
     readonly TopazUpscaleImage: "topaz-upscale-image";
+    readonly TopazUpscaleVideo: "topaz-upscale-video";
     readonly VeedFabricV1: "veed-fabric-v1";
     readonly VeedFabricV1Fast: "veed-fabric-v1-fast";
     readonly Veo31: "veo-3.1";
@@ -2321,9 +2312,13 @@ declare function isPricingLoaded(): boolean;
 
 /** Look up a single model descriptor by id. */
 type ModelFunction = (id: string) => ModelDescriptor;
-declare function _all(): ModelDescriptor[];
+declare function _all(filter?: {
+    release?: readonly ReleaseTag[];
+}): ModelDescriptor[];
 declare function _find(filter: ModelFilter$1): ModelDescriptor[];
-declare function _search(query: string): ModelDescriptor[];
+declare function _search(query: string, filter?: {
+    release?: readonly ReleaseTag[];
+}): ModelDescriptor[];
 /** Look up a single model descriptor: `Model('flux-2-pro').params()`. */
 declare const Model: ModelFunction;
 /**
@@ -2367,8 +2362,32 @@ declare function decodeDeepLinkPayload(encoded: string): DeepLinkResult | null;
 
 /** All models from all vendors. */
 declare const ALL_MODELS: ModelDefinition[];
+/**
+ * Models for a generation mode. By default returns only default-visible models
+ * (production / general-availability — preview, disabled and deprecated are
+ * hidden). `includeDisabled = true` returns every model of the mode, bypassing
+ * all gates. For release-tier filtering use `catalog.find({ output, release })`.
+ */
 declare const getModelsByMode: (mode: ModelDefinition["mode"], includeDisabled?: boolean) => ModelDefinition[];
 
+/**
+ * Release tags shown by default in discovery. `preview` is stage-only and
+ * opt-in (pass `release: ['preview', ...]`) — it is never in the default set.
+ */
+declare const DEFAULT_VISIBLE_RELEASES: readonly ReleaseTag[];
+/** Effective release tag of a model — absent ⇒ `'production'`. */
+declare const releaseOf: (m: ModelDefinition) => ReleaseTag;
+/**
+ * Whether `m` is visible for the requested `releases` (default: the production
+ * + general-availability set).
+ *
+ * `disabled` and `deprecated` are hard hides layered on top of `release`: a
+ * model carrying either is never visible, regardless of its release tag or the
+ * requested set. (`disabled` is being phased out in favour of
+ * `release: 'preview'` — EAI-3 — but is still honoured during the migration.)
+ */
+declare function isVisibleForReleases(m: ModelDefinition, releases?: readonly ReleaseTag[]): boolean;
+
 /** Look up a model by its ID or vendor modelId. */
 declare const getModel: (id: string) => ModelDefinition | undefined;
 /** Find a model by ID, workflow name, or display name (case-insensitive). */
@@ -2377,4 +2396,4 @@ declare const findModel: (ref: string) => ModelDefinition | undefined;
 /** Effect scenes that require two input images (e.g. hugs, kisses, swaps). */
 declare const KLING_DUAL_IMAGE_EFFECTS: ReadonlySet<string>;
 
-export { ALL_MODELS, type AiClient, type ApiResponse, type ApiRunOptions, type ApiSchemas, type ApisClient, type AppIdentity, type AppType, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type ClientConfig, type CreditRange, type CreditRangeContext, type DeepLinkResult, type DriveAttributes, type DriveClient, type DriveConfig, type DriveFile, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type EnumOption, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerateTextResult, type GenerationContext, type GenerationFile, type GenerationMode, KLING_DUAL_IMAGE_EFFECTS, type ListOptions, type MediaModelId, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type ModelFilter$1 as ModelFilter, type ModelInput, type ModelInputById, type ModelMeta, type ModelParams, type ModelParamsAccessor, Models, type ObjectDescriptor, type ObjectEntry, type ParamDescriptor, type ParamEntry, type ParamOption, type PayloadDriveFolderOptions, type PayloadDriveOptions, type PricingOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type SaveParams, type SdkPayload, type SdkTransport, type TextDescriptor, type TextEntry, type TextModelId, type TextModelInputById, type TypedModelId, type UserReaction, type ValidationResult$1 as ValidationResult, type VoiceOption, type WorkflowJobHandle, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, parseGeneration };
+export { ALL_MODELS, type AiClient, type ApiResponse, type ApiRunOptions, type ApiSchemas, type ApisClient, type AppIdentity, type AppType, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type ClientConfig, type CreditRange, type CreditRangeContext, DEFAULT_VISIBLE_RELEASES, type DeepLinkResult, type DriveAttributes, type DriveClient, type DriveConfig, type DriveFile, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type EnumOption, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerateTextResult, type GenerationContext, type GenerationFile, type GenerationMode, KLING_DUAL_IMAGE_EFFECTS, type ListOptions, type MediaModelId, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type ModelFilter$1 as ModelFilter, type ModelInput, type ModelInputById, type ModelMeta, type ModelParams, type ModelParamsAccessor, Models, type ObjectDescriptor, type ObjectEntry, type ParamDescriptor, type ParamEntry, type ParamOption, type PayloadDriveFolderOptions, type PayloadDriveOptions, type PricingOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type ReleaseTag, type SaveParams, type SdkPayload, type SdkTransport, type TextDescriptor, type TextEntry, type TextModelId, type TextModelInputById, type TypedModelId, type UserReaction, type ValidationResult$1 as ValidationResult, type VoiceOption, type WorkflowJobHandle, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, isVisibleForReleases, parseGeneration, releaseOf };

package/index.js

@@ -639,6 +639,14 @@ function transferValues(newParams, prev) {
   return ctx;
 }
 
+// src/core/visibility.ts
+var DEFAULT_VISIBLE_RELEASES = ["production", "general-availability"];
+var releaseOf = (m) => m.release ?? "production";
+function isVisibleForReleases(m, releases = DEFAULT_VISIBLE_RELEASES) {
+  if (m.disabled || m.deprecated) return false;
+  return releases.includes(releaseOf(m));
+}
+
 // src/core/providers.ts
 var providers = {
   picsart: { color: "#FF3399", label: "PA", name: "Picsart" },
@@ -1028,6 +1036,7 @@ function defineModels(provider, configs) {
     if (c.addedAt !== void 0) model.addedAt = c.addedAt;
     if (c.disabled !== void 0) model.disabled = c.disabled;
     if (c.deprecated !== void 0) model.deprecated = c.deprecated;
+    if (c.release !== void 0) model.release = c.release;
     if (c.modelId !== void 0) model.modelId = c.modelId;
     if (c.constraints !== void 0) model.constraints = c.constraints;
     const contract = createModelContract(model);
@@ -6909,63 +6918,96 @@ var { MODELS: MODELS29 } = defineModels("recraft", [
 ]);
 
 // src/vendors/catalog/topaz.ts
-var buildTopazUpscalePayload = (ctx) => ({
-  face_enhancement: false,
-  face_enhancement_creativity: 0,
-  face_enhancement_strength: 0.8,
-  output_format: "png",
-  subject_detection: "All",
-  model: "Standard V2",
-  image_url: ctx.imageUrls?.[0] ?? "",
-  upscale_factor: 2,
-  crop_to_fill: false
-});
-var buildTopazEnhancePayload = (model) => (ctx) => ({
-  image_url: ctx.imageUrls?.[0] ?? "",
-  upscale_factor: 1,
-  output_format: "png",
-  model
-});
-var TOPAZ_ENHANCE_VARIANTS = [
-  { key: "standard-v2", label: "Topaz Standard", model: "Standard V2" },
-  { key: "low-res-v2", label: "Topaz Low Res", model: "Low Resolution V2" },
-  { key: "cgi", label: "Topaz CGI", model: "CGI" },
-  { key: "high-fidelity-v2", label: "Topaz Hi-Fi", model: "High Fidelity V2" },
-  { key: "text-refine", label: "Topaz Text", model: "Text Refine" },
-  { key: "redefine", label: "Topaz Redefine", model: "Redefine" },
-  { key: "recovery", label: "Topaz Recovery", model: "Recovery" },
-  { key: "recovery-v2", label: "Topaz Recovery V2", model: "Recovery V2" }
+var TOPAZ_IMAGE_MODEL_OPTIONS = [
+  "Standard V2",
+  "Standard MAX",
+  "Low Resolution V2",
+  "High Fidelity V2",
+  "CGI",
+  "Text Refine",
+  "Redefine",
+  "Recovery",
+  "Recovery V2",
+  "Wonder",
+  "Wonder 3"
+];
+var TOPAZ_VIDEO_MODEL_OPTIONS = [
+  "Proteus",
+  "Artemis HQ",
+  "Artemis MQ",
+  "Artemis LQ",
+  "Nyx",
+  "Nyx Fast",
+  "Nyx XL",
+  "Nyx HF",
+  "Gaia HQ",
+  "Gaia CG",
+  "Gaia 2",
+  "Starlight Precise 1",
+  "Starlight Precise 2",
+  "Starlight Precise 2.5",
+  "Starlight HQ",
+  "Starlight Mini",
+  "Starlight Sharp",
+  "Starlight Fast 1",
+  "Starlight Fast 2"
 ];
 var { MODELS: MODELS30 } = defineModels("topaz", [
   {
     id: "topaz-upscale-image",
-    name: "Topaz HD Upscale",
+    name: "Topaz Image Upscale",
     addedAt: "2026-03-06",
     workflow: "topaz/upscale/image",
-    buildPayload: buildTopazUpscalePayload,
     estimatedTime: 30,
     mode: "image",
     inputType: "i2i",
-    description: "2x image upscale with Topaz AI.",
+    description: "Image upscaling and enhancement with Topaz AI \u2014 Standard, Hi-Fi, CGI, Recovery and Wonder models.",
     features: [feat("Upscale", "quality"), feat("Image Required", "input")],
-    paramConfig: { ...params.imageInput(1, "Image", true) }
+    paramConfig: {
+      ...params.imageInput(1, "Image", true),
+      ...p.enum("model", [...TOPAZ_IMAGE_MODEL_OPTIONS], "Standard V2", { label: "Model" })
+    }
   },
-  ...TOPAZ_ENHANCE_VARIANTS.map((v) => ({
-    id: `topaz-enhance-${v.key}`,
-    modelId: "topaz-upscale-image",
-    addedAt: "2026-03-06",
-    name: v.label,
-    workflow: "topaz/upscale/image",
-    buildPayload: buildTopazEnhancePayload(v.model),
-    estimatedTime: 30,
-    mode: "image",
-    inputType: "i2i",
-    description: `${v.model} image enhancement`,
-    features: [feat("Enhancement", "quality"), feat("Image Required", "input")],
-    paramConfig: { ...params.imageInput(1, "Image", true) }
-  }))
+  {
+    id: "topaz-upscale-video",
+    name: "Topaz Video Upscale",
+    addedAt: "2026-07-21",
+    workflow: "topaz/upscale/video",
+    estimatedTime: 600,
+    mode: "video",
+    inputType: "v2v",
+    description: "Video upscaling and enhancement with Topaz AI \u2014 Proteus, Artemis, Nyx, Gaia and Starlight models.",
+    features: [feat("Upscale", "quality"), feat("Video Required", "input")],
+    paramConfig: {
+      ...params.videoInput("Source Video", "asset", true),
+      ...p.enum("model", [...TOPAZ_VIDEO_MODEL_OPTIONS], "Proteus", { label: "Model" })
+    }
+  }
 ]);
 
+// src/vendors/catalog/topaz.payloads.ts
+var buildTopazImagePayload = (input) => ({
+  image_url: input.imageUrls[0],
+  model: input.model ?? "Standard V2",
+  upscale_factor: 2,
+  output_format: "png",
+  face_enhancement: false,
+  face_enhancement_creativity: 0,
+  face_enhancement_strength: 0.8,
+  subject_detection: "All",
+  crop_to_fill: false
+});
+var buildTopazVideoPayload = (input) => ({
+  video_url: input.videoUrl,
+  model: input.model ?? "Proteus",
+  upscale_factor: 2,
+  H264_output: false
+});
+registerPayloads(MODELS30, {
+  "topaz-upscale-image": buildTopazImagePayload,
+  "topaz-upscale-video": buildTopazVideoPayload
+});
+
 // src/vendors/catalog/picsart.ts
 var MAX_WORDS = 77;
 var truncateWords = (text) => {
@@ -7826,7 +7868,7 @@ var ALL_MODELS = [
   ...MODELS35,
   ...MODELS36
 ];
-var getModelsByMode = (mode, includeDisabled = false) => ALL_MODELS.filter((m) => m.mode === mode && (includeDisabled || !m.disabled && !m.deprecated));
+var getModelsByMode = (mode, includeDisabled = false) => ALL_MODELS.filter((m) => m.mode === mode && (includeDisabled || isVisibleForReleases(m)));
 
 // src/core/contracts.ts
 function requireObject(value, message) {
@@ -9617,12 +9659,14 @@ var ModelMetaImpl = class {
   features;
   badges;
   provider;
+  release;
   constructor(def) {
     this.mode = def.mode;
     this.inputType = def.inputType;
     this.description = def.description;
     this.features = def.features;
     this.badges = def.badge ?? [];
+    this.release = def.release ?? "production";
     this.provider = {
       id: def.provider,
       name: def.providerName,
@@ -9678,21 +9722,24 @@ var ModelDescriptorImpl = class {
 function _model(id) {
   return new ModelDescriptorImpl(resolveModel(id));
 }
-function _all() {
-  return ALL_MODELS.filter((m) => !m.disabled && !m.deprecated).map((m) => new ModelDescriptorImpl(m));
+function _all(filter = {}) {
+  const releases = filter.release ?? DEFAULT_VISIBLE_RELEASES;
+  return ALL_MODELS.filter((m) => isVisibleForReleases(m, releases)).map((m) => new ModelDescriptorImpl(m));
 }
 function _find(filter) {
+  const releases = filter.release ?? DEFAULT_VISIBLE_RELEASES;
   return ALL_MODELS.filter((m) => {
-    if (m.disabled || m.deprecated) return false;
+    if (!isVisibleForReleases(m, releases)) return false;
     if (filter.output && m.mode !== filter.output) return false;
     if (filter.provider && m.provider !== filter.provider) return false;
     return true;
   }).map((m) => new ModelDescriptorImpl(m));
 }
-function _search(query) {
+function _search(query, filter = {}) {
+  const releases = filter.release ?? DEFAULT_VISIBLE_RELEASES;
   const q = query.toLowerCase();
   return ALL_MODELS.filter(
-    (m) => !m.disabled && !m.deprecated && (m.id.toLowerCase().includes(q) || m.name.toLowerCase().includes(q) || m.provider.toLowerCase().includes(q))
+    (m) => isVisibleForReleases(m, releases) && (m.id.toLowerCase().includes(q) || m.name.toLowerCase().includes(q) || m.provider.toLowerCase().includes(q))
   ).map((m) => new ModelDescriptorImpl(m));
 }
 var Model = _model;
@@ -9882,15 +9929,8 @@ var Seedream50Pro = "seedream-5.0-pro";
 var Sora2 = "sora-2";
 var Sora2Extend = "sora-2-extend";
 var Sora2Pro = "sora-2-pro";
-var TopazEnhanceCgi = "topaz-enhance-cgi";
-var TopazEnhanceHighFidelityV2 = "topaz-enhance-high-fidelity-v2";
-var TopazEnhanceLowResV2 = "topaz-enhance-low-res-v2";
-var TopazEnhanceRecovery = "topaz-enhance-recovery";
-var TopazEnhanceRecoveryV2 = "topaz-enhance-recovery-v2";
-var TopazEnhanceRedefine = "topaz-enhance-redefine";
-var TopazEnhanceStandardV2 = "topaz-enhance-standard-v2";
-var TopazEnhanceTextRefine = "topaz-enhance-text-refine";
 var TopazUpscaleImage = "topaz-upscale-image";
+var TopazUpscaleVideo = "topaz-upscale-video";
 var VeedFabricV1 = "veed-fabric-v1";
 var VeedFabricV1Fast = "veed-fabric-v1-fast";
 var Veo31 = "veo-3.1";
@@ -10078,15 +10118,8 @@ var Models = {
   Sora2,
   Sora2Extend,
   Sora2Pro,
-  TopazEnhanceCgi,
-  TopazEnhanceHighFidelityV2,
-  TopazEnhanceLowResV2,
-  TopazEnhanceRecovery,
-  TopazEnhanceRecoveryV2,
-  TopazEnhanceRedefine,
-  TopazEnhanceStandardV2,
-  TopazEnhanceTextRefine,
   TopazUpscaleImage,
+  TopazUpscaleVideo,
   VeedFabricV1,
   VeedFabricV1Fast,
   Veo31,
@@ -10314,4 +10347,4 @@ function decodeDeepLinkPayload(encoded) {
   return deserializePayload(encoded);
 }
 
-export { ALL_MODELS, ExecutionMode as ApiRunMode, KLING_DUAL_IMAGE_EFFECTS, Model, Models, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, parseGeneration };
+export { ALL_MODELS, ExecutionMode as ApiRunMode, DEFAULT_VISIBLE_RELEASES, KLING_DUAL_IMAGE_EFFECTS, Model, Models, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, isVisibleForReleases, parseGeneration, releaseOf };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picsart/ai-sdk",
-  "version": "3.17.6",
+  "version": "3.19.0",
   "type": "module",
   "description": "Type-safe SDK for 100+ AI models — image, video, audio, and text generation with Picsart",
   "license": "MIT",