@serve.zone/interfaces 7.8.0 → 7.10.0

package/changelog.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2026-06-10 - 7.10.0
+
+### Features
+
+- add deployment archive retention setting (settings)
+  - Adds optional deploymentArchiveRetentionDays to ICloudlySettings for configuring archived deployment record retention.
+  - Documents the default retention period as 90 days.
+
+## 2026-06-10 - 7.9.0
+
+### Features
+
+- add archived deployment metadata and query support (deployment)
+  - Add optional archivedAt timestamp to deployment data for retained archived records.
+  - Add optional includeArchived flag to getDeployments requests.
+
 ## 2026-06-10 - 7.8.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/interfaces',
-    version: '7.8.0',
+    version: '7.10.0',
     description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=

package/dist_ts/data/deployment.d.ts

@@ -62,4 +62,10 @@ export interface IDeployment {
         memoryUsedMB: number;
         lastUpdated: number;
     };
+    /**
+     * Set when the deployment disappeared from runtime snapshots. Archived
+     * deployments are kept for lookup and log retention (default 90 days)
+     * and are excluded from active runtime views.
+     */
+    archivedAt?: number;
 }

package/dist_ts/data/settings.d.ts

@@ -5,6 +5,7 @@
 export interface ICloudlySettings {
     hetznerToken?: string;
     cloudflareToken?: string;
+    deploymentArchiveRetentionDays?: string;
     baseosJoinToken?: string;
     corebuildWorkerUrl?: string;
     corebuildWorkerToken?: string;

package/dist_ts/requests/deployment.d.ts

@@ -21,6 +21,8 @@ export interface IReq_Any_Cloudly_GetDeployments extends plugins.typedrequestInt
     method: 'getDeployments';
     request: {
         identity: IIdentity;
+        /** Include archived deployments (default: active only). */
+        includeArchived?: boolean;
     };
     response: {
         deployments: IDeployment[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "7.8.0",
+  "version": "7.10.0",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.",
   "exports": {

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@serve.zone/interfaces',
-  version: '7.8.0',
+  version: '7.10.0',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 }

package/ts/data/deployment.ts

@@ -81,4 +81,11 @@ export interface IDeployment {
     memoryUsedMB: number;
     lastUpdated: number;
   };
+
+  /**
+   * Set when the deployment disappeared from runtime snapshots. Archived
+   * deployments are kept for lookup and log retention (default 90 days)
+   * and are excluded from active runtime views.
+   */
+  archivedAt?: number;
 }

package/ts/data/settings.ts

@@ -9,6 +9,9 @@ export interface ICloudlySettings {
   hetznerToken?: string;
   cloudflareToken?: string;
 
+  // Retention for archived deployment records in days (default 90)
+  deploymentArchiveRetentionDays?: string;
+
   // BaseOS enrollment
   baseosJoinToken?: string;
 

package/ts/requests/deployment.ts

@@ -32,6 +32,8 @@ extends plugins.typedrequestInterfaces.implementsTR<
   method: 'getDeployments';
   request: {
     identity: IIdentity;
+    /** Include archived deployments (default: active only). */
+    includeArchived?: boolean;
   };
   response: {
     deployments: IDeployment[];