ppio-sandbox 1.0.3-b1 → 1.1.1-a2

package/dist/{chunk-MMBQNTJE.mjs → chunk-KU764YSO.mjs}

@@ -48,7 +48,7 @@ import createClient from "openapi-fetch";
 import platform from "platform";
 
 // package.json
-var version = "1.0.3-b1";
+var version = "1.1.1-a2";
 
 // src/core/api/metadata.ts
 function getRuntime() {
@@ -1128,6 +1128,209 @@ var CommandHandle = class {
   }
 };
 
+// src/core/template/templateApi.ts
+var TemplateApi = class {
+  constructor() {
+  }
+  /**
+   * List templates with pagination support (user's default team only).
+   *
+   * @param opts template list options.
+   *
+   * @returns paginated template list response.
+   *
+   * @example
+   * ```ts
+   * const response = await TemplateApi.listTemplates({
+   *   templateType: 'snapshot_template',
+   *   page: 1,
+   *   limit: 20,
+   * })
+   * console.log('Total templates:', response.total)
+   * console.log('Templates:', response.templates)
+   * ```
+   */
+  static async listTemplates(opts) {
+    const config = new ConnectionConfig(opts);
+    const client = new ApiClient(config);
+    const res = await client.api.GET("/v2/templates", {
+      params: {
+        query: {
+          template_type: opts == null ? void 0 : opts.templateType,
+          page: opts == null ? void 0 : opts.page,
+          limit: opts == null ? void 0 : opts.limit
+        }
+      },
+      signal: config.getSignal(opts == null ? void 0 : opts.requestTimeoutMs)
+    });
+    const err = handleApiError(res);
+    if (err) {
+      throw err;
+    }
+    if (!res.data) {
+      throw new Error("Template list response data is missing");
+    }
+    const templates = (res.data.templates || []).map(
+      (t) => ({
+        templateId: t.templateID,
+        aliases: t.aliases,
+        buildCount: t.buildCount,
+        buildId: t.buildID,
+        cpuCount: t.cpuCount,
+        createdAt: new Date(t.createdAt),
+        createdBy: t.createdBy,
+        diskSizeMB: t.diskSizeMB,
+        envdVersion: t.envdVersion,
+        lastSpawnedAt: new Date(t.lastSpawnedAt),
+        memoryMB: t.memoryMB,
+        metadata: t.metadata,
+        public: t.public,
+        spawnCount: t.spawnCount,
+        templateType: t.templateType,
+        originSandboxID: t.originSandboxID,
+        updatedAt: new Date(t.updatedAt)
+      })
+    );
+    return {
+      templates,
+      page: res.data.page,
+      limit: res.data.limit,
+      total: res.data.total,
+      totalPages: res.data.totalPages
+    };
+  }
+  /**
+   * Delete a template by its ID.
+   *
+   * @param templateId template ID to delete.
+   * @param opts API options.
+   *
+   * @returns `true` if the template was deleted successfully.
+   *
+   * @example
+   * ```ts
+   * await TemplateApi.deleteTemplate('template-id')
+   * console.log('Template deleted successfully')
+   * ```
+   */
+  static async deleteTemplate(templateId, opts) {
+    const config = new ConnectionConfig(opts);
+    const client = new ApiClient(config);
+    const res = await client.api.DELETE("/templates/{templateID}", {
+      params: {
+        path: {
+          templateID: templateId
+        }
+      },
+      signal: config.getSignal(opts == null ? void 0 : opts.requestTimeoutMs)
+    });
+    const err = handleApiError(res);
+    if (err) {
+      throw err;
+    }
+    return res.response.status === 204;
+  }
+};
+var TemplatePaginator = class {
+  constructor(opts) {
+    var _a2, _b;
+    this.config = new ConnectionConfig(opts);
+    this.client = new ApiClient(this.config);
+    this._hasNext = true;
+    this._currentPage = ((_a2 = opts == null ? void 0 : opts.page) != null ? _a2 : 1) - 1;
+    this._totalPages = void 0;
+    this.templateType = opts == null ? void 0 : opts.templateType;
+    this.limit = (_b = opts == null ? void 0 : opts.limit) != null ? _b : 20;
+  }
+  /**
+   * Returns true if there are more pages to fetch.
+   */
+  get hasNext() {
+    return this._hasNext;
+  }
+  /**
+   * Returns the current page number (1-based).
+   */
+  get currentPage() {
+    return this._currentPage + 1;
+  }
+  /**
+   * Returns the total number of pages (if known).
+   */
+  get totalPages() {
+    return this._totalPages;
+  }
+  /**
+   * Get the next page of templates.
+   *
+   * @throws Error if there are no more pages to fetch. Call this method only if `hasNext` is `true`.
+   *
+   * @returns Paginated template list response.
+   */
+  async nextPage() {
+    if (!this.hasNext) {
+      throw new Error("No more pages to fetch");
+    }
+    this._currentPage++;
+    const res = await this.client.api.GET("/v2/templates", {
+      params: {
+        query: {
+          template_type: this.templateType,
+          page: this._currentPage + 1,
+          // API expects 1-based page
+          limit: this.limit
+        }
+      },
+      signal: this.config.getSignal()
+    });
+    const err = handleApiError(res);
+    if (err) {
+      throw err;
+    }
+    if (!res.data) {
+      throw new Error("Template list response data is missing");
+    }
+    this._totalPages = res.data.totalPages;
+    this._hasNext = this._currentPage + 1 < res.data.totalPages;
+    const templates = (res.data.templates || []).map(
+      (t) => ({
+        templateId: t.templateID,
+        aliases: t.aliases,
+        buildCount: t.buildCount,
+        buildId: t.buildID,
+        cpuCount: t.cpuCount,
+        createdAt: new Date(t.createdAt),
+        createdBy: t.createdBy,
+        diskSizeMB: t.diskSizeMB,
+        envdVersion: t.envdVersion,
+        lastSpawnedAt: new Date(t.lastSpawnedAt),
+        memoryMB: t.memoryMB,
+        metadata: t.metadata,
+        public: t.public,
+        spawnCount: t.spawnCount,
+        templateType: t.templateType,
+        originSandboxID: t.originSandboxID,
+        updatedAt: new Date(t.updatedAt)
+      })
+    );
+    return {
+      templates,
+      page: res.data.page,
+      limit: res.data.limit,
+      total: res.data.total,
+      totalPages: res.data.totalPages
+    };
+  }
+  /**
+   * Reset the paginator to the first page.
+   */
+  reset() {
+    this._currentPage = 0;
+    this._hasNext = true;
+    this._totalPages = void 0;
+  }
+};
+
 // src/core/sandbox/index.ts
 import { createConnectTransport } from "@connectrpc/connect-web";
 
@@ -1739,7 +1942,8 @@ var SandboxApi = class {
     }));
     return {
       count: res.data.count,
-      sandboxes
+      sandboxes,
+      snapshotTemplateId: res.data.snapshotTemplateId
     };
   }
   static async createSandbox(template, timeoutMs, opts) {
@@ -1807,6 +2011,92 @@ var SandboxApi = class {
     }
     return true;
   }
+  /**
+   * Reset sandbox memory and optionally resume the sandbox.
+   *
+   * @param sandboxId sandbox ID.
+   * @param opts reset options.
+   *
+   * @returns `true` if reset succeeded; `false` if conflict (no-op).
+   */
+  static async reset(sandboxId, opts) {
+    var _a2, _b, _c;
+    const config = new ConnectionConfig(opts);
+    const client = new ApiClient(config);
+    const res = await client.api.POST("/sandboxes/{sandboxID}/reset", {
+      params: {
+        path: {
+          sandboxID: sandboxId
+        }
+      },
+      body: __spreadValues({
+        resume: (_a2 = opts == null ? void 0 : opts.resume) != null ? _a2 : true
+      }, typeof (opts == null ? void 0 : opts.timeoutMs) === "number" ? { timeout: timeoutToSeconds(opts.timeoutMs) } : {}),
+      signal: config.getSignal(opts == null ? void 0 : opts.requestTimeoutMs)
+    });
+    if (((_b = res.error) == null ? void 0 : _b.code) === 404) {
+      throw new NotFoundError(`Sandbox ${sandboxId} not found`);
+    }
+    if (((_c = res.error) == null ? void 0 : _c.code) === 409) {
+      return false;
+    }
+    const err = handleApiError(res);
+    if (err) {
+      throw err;
+    }
+    return true;
+  }
+  /**
+   * Commit the sandbox to create a template snapshot.
+   *
+   * @param sandboxId sandbox ID.
+   * @param opts commit options.
+   *
+   * @returns template information.
+   */
+  static async commit(sandboxId, opts) {
+    var _a2;
+    const config = new ConnectionConfig(opts);
+    const client = new ApiClient(config);
+    const res = await client.api.POST("/sandboxes/{sandboxID}/commit", {
+      params: {
+        path: {
+          sandboxID: sandboxId
+        }
+      },
+      body: (opts == null ? void 0 : opts.alias) ? { alias: opts.alias } : void 0,
+      signal: config.getSignal(opts == null ? void 0 : opts.requestTimeoutMs)
+    });
+    if (((_a2 = res.error) == null ? void 0 : _a2.code) === 404) {
+      throw new NotFoundError(`Sandbox ${sandboxId} not found`);
+    }
+    const err = handleApiError(res);
+    if (err) {
+      throw err;
+    }
+    if (!res.data) {
+      throw new Error("Commit response data is missing");
+    }
+    return {
+      templateId: res.data.templateID,
+      aliases: res.data.aliases,
+      buildCount: res.data.buildCount,
+      buildId: res.data.buildID,
+      cpuCount: res.data.cpuCount,
+      createdAt: new Date(res.data.createdAt),
+      createdBy: res.data.createdBy,
+      diskSizeMB: res.data.diskSizeMB,
+      envdVersion: res.data.envdVersion,
+      lastSpawnedAt: new Date(res.data.lastSpawnedAt),
+      memoryMB: res.data.memoryMB,
+      metadata: res.data.metadata,
+      public: res.data.public,
+      spawnCount: res.data.spawnCount,
+      templateType: res.data.templateType,
+      originSandboxID: res.data.originSandboxID,
+      updatedAt: new Date(res.data.updatedAt)
+    };
+  }
 };
 var SandboxPaginator = class {
   constructor(opts) {
@@ -2061,7 +2351,17 @@ var Sandbox = class extends SandboxApi {
         envdAccessToken: sb.envdAccessToken
       }, config));
     });
-    return instances;
+    return {
+      count: res.count,
+      snapshotTemplateId: res.snapshotTemplateId,
+      sandboxes: instances
+    };
+  }
+  /**
+   * Reset sandbox memory and optionally resume the sandbox.
+   */
+  static async reset(sandboxId, opts) {
+    return await SandboxApi.reset(sandboxId, opts);
   }
   /**
    * Connect to a sandbox. If the sandbox is paused, it will be automatically resumed.
@@ -2184,6 +2484,30 @@ var Sandbox = class extends SandboxApi {
   async betaPause(opts) {
     return await SandboxApi.betaPause(this.sandboxId, opts);
   }
+  /**
+   * Reset sandbox memory and optionally resume the sandbox.
+   */
+  async reset(opts) {
+    return await SandboxApi.reset(this.sandboxId, opts);
+  }
+  /**
+   * Commit the sandbox to create a template snapshot.
+   *
+   * This creates a snapshot of the current sandbox state that can be used as a template to create new sandboxes.
+   *
+   * @param opts commit options including optional alias for the template.
+   *
+   * @returns template information.
+   *
+   * @example
+   * ```ts
+   * const template = await sandbox.commit({ alias: 'my-custom-template' })
+   * console.log('Created template:', template.templateId)
+   * ```
+   */
+  async commit(opts) {
+    return await SandboxApi.commit(this.sandboxId, __spreadValues(__spreadValues({}, this.connectionConfig), opts));
+  }
   /**
    * Get the URL to upload a file to the sandbox.
    *
@@ -2330,7 +2654,9 @@ export {
   FilesystemEventType,
   FileType2 as FileType,
   CommandExitError,
+  TemplateApi,
+  TemplatePaginator,
   Sandbox,
   core_default
 };
-//# sourceMappingURL=chunk-MMBQNTJE.mjs.map
+//# sourceMappingURL=chunk-KU764YSO.mjs.map