@picsart/ai-sdk 7.1.0 → 7.2.0

package/index.d.ts

@@ -1348,6 +1348,16 @@ interface GenerateOptions {
 interface InitModelCatalogOptions {
     /** Restrict what the catalog load requests — mode, provider, release, deprecated, search. */
     filtersOptions?: ModelCatalogFilters;
+    /**
+     * How often, in seconds, to re-pull the catalog in the background after the
+     * first load so a long-lived process picks up new/changed models without
+     * restarting. The timer arms only after the initial load succeeds and
+     * re-fetches with the same `filtersOptions`. A refresh that fails leaves the
+     * previously loaded catalog in place (the next tick retries).
+     *
+     * Default `-1` — no scheduled refresh (any value `<= 0` disables it).
+     */
+    refreshIntervalSeconds?: number;
 }
 /**
  * Non-text (image/video/audio) model id. Dynamic-only: ids are plain strings

package/index.js

@@ -625,7 +625,23 @@ var CATALOG_PATH = "/gw-v2/v1/models-catalog";
 var _loadPromise = null;
 var _loaded = false;
 var _key = null;
+var _refreshTimer = null;
 var keyOf = (apiUrl, filters) => `${apiUrl}::${JSON.stringify(filters ?? {})}`;
+function clearRefreshSchedule() {
+  if (_refreshTimer) {
+    clearInterval(_refreshTimer);
+    _refreshTimer = null;
+  }
+}
+function scheduleRefresh(f, apiUrl, filters, seconds) {
+  clearRefreshSchedule();
+  if (!(seconds > 0)) return;
+  _refreshTimer = setInterval(() => {
+    void refreshModelCatalog(f, apiUrl, filters).catch(() => {
+    });
+  }, seconds * 1e3);
+  _refreshTimer.unref?.();
+}
 function buildQuery(filters) {
   const query = new URLSearchParams();
   query.set("include", "schema,constraints,routing");
@@ -654,7 +670,7 @@ async function fetchAndInstall(f, apiUrl, filters) {
   const models = deserializeCatalog(await res.json());
   installCatalog(models);
 }
-function loadModelCatalog(f, apiUrl, filters) {
+function loadModelCatalog(f, apiUrl, filters, refreshIntervalSeconds = -1) {
   const key = keyOf(apiUrl, filters);
   if (_loadPromise) {
     if (_key !== key) {
@@ -663,11 +679,13 @@ function loadModelCatalog(f, apiUrl, filters) {
         { status: 409, code: "catalog_conflict" }
       ));
     }
+    if (_loaded) scheduleRefresh(f, apiUrl, filters, refreshIntervalSeconds);
     return _loadPromise;
   }
   _key = key;
   _loadPromise = fetchAndInstall(f, apiUrl, filters).then(() => {
     _loaded = true;
+    scheduleRefresh(f, apiUrl, filters, refreshIntervalSeconds);
   }).catch((err) => {
     _loadPromise = null;
     _key = null;
@@ -675,6 +693,26 @@ function loadModelCatalog(f, apiUrl, filters) {
   });
   return _loadPromise;
 }
+function refreshModelCatalog(f, apiUrl, filters) {
+  const key = keyOf(apiUrl, filters);
+  const prevPromise = _loadPromise;
+  const prevLoaded = _loaded;
+  const prevKey = _key;
+  const p2 = fetchAndInstall(f, apiUrl, filters).then(() => {
+    _loaded = true;
+  }).catch((err) => {
+    if (_loadPromise === p2) {
+      _loadPromise = prevPromise;
+      _loaded = prevLoaded;
+      _key = prevKey;
+    }
+    throw err;
+  });
+  _loadPromise = p2;
+  _loaded = false;
+  _key = key;
+  return p2;
+}
 function whenModelCatalogLoaded() {
   return _loadPromise;
 }
@@ -3784,7 +3822,12 @@ function createClient(config) {
           code: "validation_error"
         });
       }
-      return loadModelCatalog(authedFetch, config.apiUrl, initOptions?.filtersOptions);
+      return loadModelCatalog(
+        authedFetch,
+        config.apiUrl,
+        initOptions?.filtersOptions,
+        initOptions?.refreshIntervalSeconds
+      );
     },
     /**
      * Validate params against the model's descriptors without generating.

package/package.json

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