@ductape/sdk 0.3.1 → 0.3.3

package/dist/index.d.ts

@@ -9,6 +9,7 @@ import { FeatureService } from './features';
 import { type IPortableFunctionContract } from './functions';
 export * from './context';
 export * from './resilience';
+import type { IUploadOptions, IDeleteOptions, ISignedUrlOptions } from './storage';
 import { BrokersService } from './brokers';
 import { IHealthcheckDefineOptions, IDefinedHealthcheck, IQuotaDefineOptions, IDefinedQuota, IFallbackDefineOptions, IDefinedFallback, IRateLimitDefinition, IRateLimitConsumeInput } from './resilience';
 import { AgentsService } from './agents';
@@ -370,7 +371,7 @@ export default class Ductape implements IDuctape {
     private scheduleAllHealthcheckJobs;
     /**
      * Schedules a single healthcheck job with the given interval (ms).
-     * If interval is not provided, defaults to 60s.
+     * The caller supplies the probe-aware default when no explicit interval exists.
      */
     private scheduleHealthcheckJob;
     setUserId(user_id: string): void;
@@ -1027,14 +1028,7 @@ export default class Ductape implements IDuctape {
          * @param data - The upload options.
          * @returns The upload result with file URL.
          */
-        upload: (data: {
-            product: string;
-            env: string;
-            storage: string;
-            fileName: string;
-            buffer: string | Buffer;
-            mimeType?: string;
-        }) => Promise<import("./storage").IStorageResult>;
+        upload: (data: IUploadOptions) => Promise<import("./storage").IStorageResult>;
         /**
          * Downloads a file from cloud storage (top-level convenience method).
          * @param data - The download options.
@@ -1051,12 +1045,7 @@ export default class Ductape implements IDuctape {
          * @param data - The delete options.
          * @returns The delete result.
          */
-        remove: (data: {
-            product: string;
-            env: string;
-            storage: string;
-            fileName: string;
-        }) => Promise<import("./storage").IDeleteResult>;
+        remove: (data: IDeleteOptions) => Promise<import("./storage").IDeleteResult>;
         /**
          * Lists files in cloud storage with pagination (top-level convenience method).
          * @param data - The list options.
@@ -1076,14 +1065,7 @@ export default class Ductape implements IDuctape {
          * @param data - The signed URL options.
          * @returns The signed URL result.
          */
-        getSignedUrl: (data: {
-            product: string;
-            env: string;
-            storage: string;
-            fileName: string;
-            expiresIn?: number;
-            action?: "read" | "write";
-        }) => Promise<import("./storage").ISignedUrlResult>;
+        getSignedUrl: (data: ISignedUrlOptions) => Promise<import("./storage").ISignedUrlResult>;
         /**
          * Gets storage statistics (file counts and sizes by type).
          * Efficiently counts all files without downloading content.
@@ -2066,7 +2048,11 @@ export default class Ductape implements IDuctape {
             update: (options: IActionUpdateOptions) => Promise<void>;
             fetch: (tag: string) => Promise<import("./database").IActionDefinition>;
             list: (databaseTag: string) => Promise<import("./database").IActionDefinition[]>;
-            delete: (tag: string) => Promise<void>;
+            delete: (tag: string) => Promise<{
+                tag: string;
+                deleted: true;
+                mutationState: "confirmed";
+            }>;
             dispatch: (data: IDBActionDispatchInput) => Promise<IDispatchResult>;
         };
         /**
@@ -3919,7 +3905,7 @@ export default class Ductape implements IDuctape {
             resource: string;
             method: string;
             folder_id?: string;
-        }) => Promise<void>;
+        }) => Promise<IAppAction>;
         /**
          * Fetches all actions for an app.
          * @param {string} appTag - The app tag.
@@ -4089,7 +4075,7 @@ export default class Ductape implements IDuctape {
             resource: string;
             method: string;
             folder_id?: string;
-        }) => Promise<void>;
+        }) => Promise<IAppAction>;
         /**
          * Fetches all actions for an app.
          * @param {string} appTag - The app tag.
@@ -4348,9 +4334,15 @@ export default class Ductape implements IDuctape {
          * @returns {Promise<any>} The fetched log data.
          */
         fetch: (params: LogQueryParams) => Promise<any>;
+        productObservability: (productTag: string, params?: Record<string, unknown>) => Promise<any>;
         publish: () => Promise<void>;
     };
     private initUserAuth;
+    /** Treat malformed/opaque tokens as usable, but proactively renew JWTs that
+     * expire within the next minute so background workers never begin with a
+     * credential that can expire mid-probe. */
+    private accessTokenNeedsRefresh;
+    private invalidateAuthBoundServices;
     private performUserAuth;
     private runtimeAuth;
     private applyRuntimeSnapshot;
@@ -4389,7 +4381,7 @@ export default class Ductape implements IDuctape {
                 refreshedAt?: number;
                 error?: string;
             };
-            connections: "degraded" | "ready" | "warming";
+            connections: "ready" | "warming" | "degraded";
         };
         warmup: {
             databases: {

package/dist/index.js

@@ -64,6 +64,7 @@ const types_1 = require("./types");
 const index_types_1 = require("./types/index.types");
 const runtime_defaults_1 = require("./runtime/runtime-defaults");
 const healthcheck_cache_key_1 = require("./resilience/healthcheck-cache-key");
+const healthcheck_interval_1 = require("./resilience/healthcheck-interval");
 const enums_1 = require("./types/enums");
 const productsApi_service_1 = require("./api/services/productsApi.service");
 const bootstrap_cache_1 = require("./products/bootstrap-cache");
@@ -5414,6 +5415,11 @@ class Ductape {
                     throw new Error(error);
                 }
             },
+            productObservability: async (productTag, params = {}) => {
+                if (!this.loggerService)
+                    this.loggerService = this.createNewLogger();
+                return this.loggerService.productObservability(productTag, params);
+            },
             publish: async () => { },
         };
         if (typeof window !== 'undefined') {
@@ -5606,6 +5612,7 @@ class Ductape {
      * Schedules all healthcheck jobs for all products and environments.
      */
     async scheduleAllHealthcheckJobs() {
+        var _a, _b;
         // Fetch all products (or use this.products if already loaded)
         const products = this.products ||
             (await this.productsApi.fetchWorkspaceProducts(enums_1.PublicStates.ALL, {
@@ -5636,7 +5643,7 @@ class Ductape {
                         tag: healthcheck.tag,
                     };
                     const jobId = `healthcheck-exec-${healthcheck.tag}-${env.slug}`;
-                    await this.scheduleHealthcheckJob(jobId, jobData, healthcheck.interval);
+                    await this.scheduleHealthcheckJob(jobId, jobData, (_a = healthcheck.interval) !== null && _a !== void 0 ? _a : (0, healthcheck_interval_1.defaultHealthcheckIntervalMs)((_b = healthcheck.probe) === null || _b === void 0 ? void 0 : _b.type));
                     scheduledCount++;
                 }
             }
@@ -5645,14 +5652,14 @@ class Ductape {
     }
     /**
      * Schedules a single healthcheck job with the given interval (ms).
-     * If interval is not provided, defaults to 60s.
+     * The caller supplies the probe-aware default when no explicit interval exists.
      */
     async scheduleHealthcheckJob(jobId, jobData, interval) {
         const job = await this.healthCheckQueue.getJob(jobId);
         if (job) {
             await job.remove();
         }
-        const repeat = interval ? { every: interval } : { every: 60000 };
+        const repeat = { every: interval !== null && interval !== void 0 ? interval : (0, healthcheck_interval_1.defaultHealthcheckIntervalMs)() };
         await this.healthCheckQueue.add('healthchecks-updater', jobData, { repeat, jobId });
     }
     setUserId(user_id) {
@@ -5726,16 +5733,56 @@ class Ductape {
         this.authInFlight = this.performUserAuth(subCheck).finally(() => { this.authInFlight = undefined; });
         return await this.authInFlight;
     }
+    /** Treat malformed/opaque tokens as usable, but proactively renew JWTs that
+     * expire within the next minute so background workers never begin with a
+     * credential that can expire mid-probe. */
+    accessTokenNeedsRefresh(token) {
+        if (!token)
+            return true;
+        try {
+            const payload = token.split('.')[1];
+            if (!payload)
+                return false;
+            const normalized = payload.replace(/-/g, '+').replace(/_/g, '/');
+            const decoded = JSON.parse(Buffer.from(normalized, 'base64').toString('utf8'));
+            return typeof decoded.exp === 'number' && decoded.exp * 1000 <= Date.now() + 60000;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    async invalidateAuthBoundServices() {
+        var _a;
+        await ((_a = this._databaseService) === null || _a === void 0 ? void 0 : _a.closeAll().catch(() => undefined));
+        this.productBuilders.clear();
+        this.appBuilders.clear();
+        this._databaseService = null;
+        this._graphService = null;
+        this._featureService = null;
+        this._agentsService = null;
+        this._modelService = null;
+        this._vectorService = null;
+        this._warehouseService = null;
+        this._cacheService = null;
+        this._secretsService = null;
+        this._cloudService = null;
+        this._sessionsService = null;
+        this._quotaService = null;
+        this._fallbackService = null;
+        this._healthcheckService = null;
+        this._brokersService = null;
+    }
     async performUserAuth(subCheck = true) {
         var _a, _b;
         // Skip if already authenticated with valid credentials
-        if (this.token && this.public_key) {
+        if (this.token && this.public_key && !this.accessTokenNeedsRefresh(this.token)) {
             if (this.runtimeSyncEnabled && !this.runtimeManifest)
                 await this.refreshRuntimeSnapshot(true);
             return;
         }
         // Only reset if we need to re-authenticate
-        if (!this.token || !this.public_key) {
+        if (!this.token || !this.public_key || this.accessTokenNeedsRefresh(this.token)) {
+            const hadAuthenticatedServices = Boolean(this.token && this.public_key);
             this.token = null;
             this.public_key = null;
             this.session = null;
@@ -5744,6 +5791,8 @@ class Ductape {
                 await this.refreshUserAccessToken();
                 await this.createNewAppBuilderSession();
             }
+            if (hadAuthenticatedServices)
+                await this.invalidateAuthBoundServices();
         }
         try {
             //await this.validateWorkspace(subCheck);