freestyle-sandboxes 0.1.25 → 0.1.27

package/index.cjs

@@ -6325,8 +6325,14 @@ class VmSpec {
     this.with = withBuilders ?? {};
   }
 }
+function isVmSpecLike(value) {
+  return !!value && typeof value === "object" && "raw" in value && "with" in value;
+}
+function isVmTemplateLike(value) {
+  return !!value && typeof value === "object" && "raw" in value && "with" in value;
+}
 async function convertSpecSnapshotsToTemplates(spec, processBuilders = true) {
-  if (!spec.raw.snapshot) {
+  if (!isVmSpecLike(spec.raw.snapshot)) {
     return void 0;
   }
   let innerSpec = spec.raw.snapshot;
@@ -6335,7 +6341,7 @@ async function convertSpecSnapshotsToTemplates(spec, processBuilders = true) {
   }
   const { snapshot: nestedSnapshot, ...innerRaw } = innerSpec.raw;
   let nestedTemplate;
-  if (nestedSnapshot instanceof VmSpec) {
+  if (isVmSpecLike(nestedSnapshot)) {
     nestedTemplate = await convertSpecSnapshotsToTemplates(innerSpec, false);
   }
   return new VmTemplate({
@@ -6353,7 +6359,7 @@ async function processOuterSpecBuilders(spec) {
       }
       if (builder.configureSnapshotSpec) {
         let snapshotSpec;
-        if (spec.raw.snapshot instanceof VmSpec) {
+        if (isVmSpecLike(spec.raw.snapshot)) {
           snapshotSpec = spec.raw.snapshot;
         } else {
           snapshotSpec = new VmSpec({});
@@ -6374,7 +6380,7 @@ async function processSpecTree(spec) {
       }
       if (builder.configureSnapshotSpec) {
         let snapshotSpec;
-        if (spec.raw.snapshot instanceof VmSpec) {
+        if (isVmSpecLike(spec.raw.snapshot)) {
           snapshotSpec = spec.raw.snapshot;
         } else {
           snapshotSpec = new VmSpec({});
@@ -6384,14 +6390,14 @@ async function processSpecTree(spec) {
       }
     }
   }
-  if (spec.raw.snapshot instanceof VmSpec) {
+  if (isVmSpecLike(spec.raw.snapshot)) {
     spec.raw.snapshot = await processSpecTree(spec.raw.snapshot);
   }
   return spec;
 }
 function collectSpecBuilders(spec) {
   let builders = {};
-  if (spec.raw.snapshot instanceof VmSpec) {
+  if (isVmSpecLike(spec.raw.snapshot)) {
     builders = collectSpecBuilders(spec.raw.snapshot);
   }
   if (spec.with) {
@@ -6427,8 +6433,8 @@ class VmsNamespace {
    * @returns A VM instance representing the created VM
    */
   async create(options = {}) {
-    if (options.snapshot instanceof VmSpec) {
-      if (options.spec instanceof VmSpec) {
+    if (isVmSpecLike(options.snapshot)) {
+      if (isVmSpecLike(options.spec)) {
         if (!options.spec.raw.snapshot) {
           options.spec.raw.snapshot = options.snapshot;
         }
@@ -6478,10 +6484,10 @@ class VmsNamespace {
       const { snapshot: _snapshot, ...rest } = options;
       options = rest;
     }
-    if (options.spec instanceof VmSpec && options.with) {
+    if (isVmSpecLike(options.spec) && options.with) {
       options.spec = mergeWithBuildersIntoSpec(options.spec, options.with);
     }
-    if (options.spec instanceof VmSpec) {
+    if (isVmSpecLike(options.spec)) {
       let spec = options.spec;
       spec = await processOuterSpecBuilders(spec);
       const { snapshot, ...outerSpecOptions } = spec.raw;
@@ -6501,19 +6507,19 @@ class VmsNamespace {
         options.with = spec.with;
       }
     }
-    const specBuilders = options.spec instanceof VmSpec ? collectSpecBuilders(options.spec) : void 0;
-    const templateBuilders = options.template instanceof VmTemplate ? options.template.with : void 0;
+    const specBuilders = isVmSpecLike(options.spec) ? collectSpecBuilders(options.spec) : void 0;
+    const templateBuilders = isVmTemplateLike(options.template) ? options.template.with : void 0;
     const builders = {
       ...templateBuilders || {},
       ...specBuilders || {},
       ...options.with || {}
     };
-    const { with: _, ...baseConfig } = options;
+    const { with: _, spec: _spec, ...baseConfig } = options;
     let config = baseConfig;
-    if (config.template instanceof VmTemplate) {
+    if (isVmTemplateLike(config.template)) {
       config.template = await processTemplateTree(config.template);
     }
-    if (config.template instanceof VmTemplate) {
+    if (isVmTemplateLike(config.template)) {
       config.template = await ensureNestedTemplates(
         config.template,
         this.snapshots
@@ -6566,7 +6572,7 @@ class VmsNamespace {
     const response = await this.freestyle._apiClient.post("/v1/vms", {
       body: {
         ...config,
-        template: config.template instanceof VmTemplate ? config.template["raw"] : config.template,
+        template: isVmTemplateLike(config.template) ? config.template["raw"] : config.template,
         // Cast systemd since we've processed SystemdServiceInput[] to RawSystemdService[]
         systemd: config.systemd,
         // Normalize git options - default config to {}
@@ -6667,8 +6673,8 @@ class VmSnapshotsNamespace {
   }
   async ensure(options) {
     let requestOptions = options;
-    if (requestOptions.snapshot instanceof VmSpec) {
-      if (requestOptions.spec instanceof VmSpec) {
+    if (isVmSpecLike(requestOptions.snapshot)) {
+      if (isVmSpecLike(requestOptions.spec)) {
         if (!requestOptions.spec.raw.snapshot) {
           requestOptions.spec.raw.snapshot = requestOptions.snapshot;
         }
@@ -6680,7 +6686,7 @@ class VmSnapshotsNamespace {
       const { snapshot: _snapshot, ...rest } = requestOptions;
       requestOptions = rest;
     }
-    if (requestOptions.spec instanceof VmSpec) {
+    if (isVmSpecLike(requestOptions.spec)) {
       let spec = requestOptions.spec;
       spec = await processSpecTree(spec);
       const { snapshot: _snapshotSpec, ...outerSpecOptions } = spec.raw;
@@ -6695,12 +6701,12 @@ class VmSnapshotsNamespace {
       const { spec: _spec, ...rest } = requestOptions;
       requestOptions = rest;
     }
-    if (requestOptions.template instanceof VmTemplate) {
+    if (isVmTemplateLike(requestOptions.template)) {
       const processedTemplate = await processTemplateTree(
         requestOptions.template
       );
       requestOptions.template = processedTemplate;
-      if (processedTemplate.raw.template instanceof VmTemplate) {
+      if (isVmTemplateLike(processedTemplate.raw.template)) {
         requestOptions.template = await ensureNestedTemplates(
           processedTemplate,
           this
@@ -6715,7 +6721,7 @@ class VmSnapshotsNamespace {
     return this.apiClient.post("/v1/vms/snapshots", {
       body: {
         ...requestOptions,
-        template: requestOptions.template instanceof VmTemplate ? requestOptions.template.raw : requestOptions.template
+        template: isVmTemplateLike(requestOptions.template) ? requestOptions.template.raw : requestOptions.template
       }
     }).catch((e) => {
       enhanceError(e);
@@ -6757,7 +6763,7 @@ async function processTemplateTree(template) {
       }
       if (builder.configureNestedTemplate) {
         let nestedTemplate;
-        if (template.raw.template instanceof VmTemplate) {
+        if (isVmTemplateLike(template.raw.template)) {
           nestedTemplate = template.raw.template;
         } else {
           nestedTemplate = new VmTemplate({});
@@ -6808,7 +6814,7 @@ async function processTemplateTree(template) {
       })
     );
   }
-  if (template.raw.template instanceof VmTemplate) {
+  if (isVmTemplateLike(template.raw.template)) {
     template.raw.template = await processTemplateTree(
       template.raw.template
     );
@@ -6817,7 +6823,7 @@ async function processTemplateTree(template) {
 }
 async function ensureNestedTemplates(template, snapshots) {
   const templates = [template];
-  while (templates.at(-1)?.raw.template instanceof VmTemplate) {
+  while (isVmTemplateLike(templates.at(-1)?.raw.template)) {
     const innerTemplate = templates.at(-1).raw.template;
     templates.at(-1).raw.template = void 0;
     templates.push(innerTemplate);
@@ -7004,6 +7010,51 @@ async function readFiles(directory) {
   return files;
 }
 
+async function debugCreateRequests(freestyle, options = {}) {
+  const requests = [];
+  let snapshotCounter = 0;
+  let vmCounter = 0;
+  const apiClient = freestyle._apiClient;
+  const originalPost = apiClient.post.bind(freestyle._apiClient);
+  const mockPost = (async (path, ...args) => {
+    const rawBody = args[0] && "body" in args[0] ? args[0].body : void 0;
+    const clonedBody = JSON.parse(JSON.stringify(rawBody ?? null));
+    if (path === "/v1/vms/snapshots") {
+      requests.push({
+        path: "/v1/vms/snapshots",
+        body: clonedBody
+      });
+      snapshotCounter += 1;
+      return {
+        snapshotId: `__debug_snapshot_${snapshotCounter}__`
+      };
+    }
+    if (path === "/v1/vms") {
+      requests.push({
+        path: "/v1/vms",
+        body: clonedBody
+      });
+      vmCounter += 1;
+      return {
+        id: `__debug_vm_${vmCounter}__`,
+        domains: [],
+        consoleUrl: "https://debug.local/console"
+      };
+    }
+    return originalPost(
+      path,
+      ...args
+    );
+  });
+  apiClient.post = mockPost;
+  try {
+    await freestyle.vms.create(options);
+  } finally {
+    apiClient.post = originalPost;
+  }
+  return requests;
+}
+
 class Freestyle {
   /**
    * @internal
@@ -7089,5 +7140,6 @@ exports.VmSpec = VmSpec;
 exports.VmTemplate = VmTemplate;
 exports.VmWith = VmWith;
 exports.VmWithInstance = VmWithInstance;
+exports.debugCreateRequests = debugCreateRequests;
 exports.freestyle = freestyle;
 exports.readFiles = readFiles;

package/index.d.cts

@@ -13835,6 +13835,21 @@ declare function readFiles(directory: string): Promise<{
     encoding: string;
 }[]>;
 
+type DebugCreateApiRequest = {
+    path: "/v1/vms/snapshots" | "/v1/vms";
+    body: unknown;
+};
+/**
+ * Simulate what the SDK would POST during `freestyle.vms.create(...)` and
+ * return all request bodies in execution order without network calls.
+ */
+declare function debugCreateRequests<T extends Record<string, VmWith>>(freestyle: Freestyle, options?: CreateVmOptions & {
+    with?: T;
+    template?: VmTemplate<T>;
+    spec?: VmSpec<T>;
+    snapshot?: VmSpec<T>;
+}): Promise<DebugCreateApiRequest[]>;
+
 type FreestyleOptions = ApiClientConfig;
 declare class Freestyle {
     readonly domains: DomainsNamespace;
@@ -13856,5 +13871,5 @@ declare class Freestyle {
  */
 declare const freestyle: Freestyle;
 
-export { CronNamespace, Deployment, errors as Errors, FileSystem, Freestyle, GitRepo, Identity, requests as Requests, responses as Responses, Systemd, SystemdService, Vm, VmBuilder, VmService, VmSpec, VmTemplate, VmWith, VmWithInstance, freestyle, readFiles };
+export { CronNamespace, Deployment, errors as Errors, FileSystem, Freestyle, GitRepo, Identity, requests as Requests, responses as Responses, Systemd, SystemdService, Vm, VmBuilder, VmService, VmSpec, VmTemplate, VmWith, VmWithInstance, debugCreateRequests, freestyle, readFiles };
 export type { CreateVmOptions, CronSchedule, FreestyleOptions, SystemdServiceInput };

package/index.d.mts

@@ -13835,6 +13835,21 @@ declare function readFiles(directory: string): Promise<{
     encoding: string;
 }[]>;
 
+type DebugCreateApiRequest = {
+    path: "/v1/vms/snapshots" | "/v1/vms";
+    body: unknown;
+};
+/**
+ * Simulate what the SDK would POST during `freestyle.vms.create(...)` and
+ * return all request bodies in execution order without network calls.
+ */
+declare function debugCreateRequests<T extends Record<string, VmWith>>(freestyle: Freestyle, options?: CreateVmOptions & {
+    with?: T;
+    template?: VmTemplate<T>;
+    spec?: VmSpec<T>;
+    snapshot?: VmSpec<T>;
+}): Promise<DebugCreateApiRequest[]>;
+
 type FreestyleOptions = ApiClientConfig;
 declare class Freestyle {
     readonly domains: DomainsNamespace;
@@ -13856,5 +13871,5 @@ declare class Freestyle {
  */
 declare const freestyle: Freestyle;
 
-export { CronNamespace, Deployment, errors as Errors, FileSystem, Freestyle, GitRepo, Identity, requests as Requests, responses as Responses, Systemd, SystemdService, Vm, VmBuilder, VmService, VmSpec, VmTemplate, VmWith, VmWithInstance, freestyle, readFiles };
+export { CronNamespace, Deployment, errors as Errors, FileSystem, Freestyle, GitRepo, Identity, requests as Requests, responses as Responses, Systemd, SystemdService, Vm, VmBuilder, VmService, VmSpec, VmTemplate, VmWith, VmWithInstance, debugCreateRequests, freestyle, readFiles };
 export type { CreateVmOptions, CronSchedule, FreestyleOptions, SystemdServiceInput };

package/index.mjs

@@ -6323,8 +6323,14 @@ class VmSpec {
     this.with = withBuilders ?? {};
   }
 }
+function isVmSpecLike(value) {
+  return !!value && typeof value === "object" && "raw" in value && "with" in value;
+}
+function isVmTemplateLike(value) {
+  return !!value && typeof value === "object" && "raw" in value && "with" in value;
+}
 async function convertSpecSnapshotsToTemplates(spec, processBuilders = true) {
-  if (!spec.raw.snapshot) {
+  if (!isVmSpecLike(spec.raw.snapshot)) {
     return void 0;
   }
   let innerSpec = spec.raw.snapshot;
@@ -6333,7 +6339,7 @@ async function convertSpecSnapshotsToTemplates(spec, processBuilders = true) {
   }
   const { snapshot: nestedSnapshot, ...innerRaw } = innerSpec.raw;
   let nestedTemplate;
-  if (nestedSnapshot instanceof VmSpec) {
+  if (isVmSpecLike(nestedSnapshot)) {
     nestedTemplate = await convertSpecSnapshotsToTemplates(innerSpec, false);
   }
   return new VmTemplate({
@@ -6351,7 +6357,7 @@ async function processOuterSpecBuilders(spec) {
       }
       if (builder.configureSnapshotSpec) {
         let snapshotSpec;
-        if (spec.raw.snapshot instanceof VmSpec) {
+        if (isVmSpecLike(spec.raw.snapshot)) {
           snapshotSpec = spec.raw.snapshot;
         } else {
           snapshotSpec = new VmSpec({});
@@ -6372,7 +6378,7 @@ async function processSpecTree(spec) {
       }
       if (builder.configureSnapshotSpec) {
         let snapshotSpec;
-        if (spec.raw.snapshot instanceof VmSpec) {
+        if (isVmSpecLike(spec.raw.snapshot)) {
           snapshotSpec = spec.raw.snapshot;
         } else {
           snapshotSpec = new VmSpec({});
@@ -6382,14 +6388,14 @@ async function processSpecTree(spec) {
       }
     }
   }
-  if (spec.raw.snapshot instanceof VmSpec) {
+  if (isVmSpecLike(spec.raw.snapshot)) {
     spec.raw.snapshot = await processSpecTree(spec.raw.snapshot);
   }
   return spec;
 }
 function collectSpecBuilders(spec) {
   let builders = {};
-  if (spec.raw.snapshot instanceof VmSpec) {
+  if (isVmSpecLike(spec.raw.snapshot)) {
     builders = collectSpecBuilders(spec.raw.snapshot);
   }
   if (spec.with) {
@@ -6425,8 +6431,8 @@ class VmsNamespace {
    * @returns A VM instance representing the created VM
    */
   async create(options = {}) {
-    if (options.snapshot instanceof VmSpec) {
-      if (options.spec instanceof VmSpec) {
+    if (isVmSpecLike(options.snapshot)) {
+      if (isVmSpecLike(options.spec)) {
         if (!options.spec.raw.snapshot) {
           options.spec.raw.snapshot = options.snapshot;
         }
@@ -6476,10 +6482,10 @@ class VmsNamespace {
       const { snapshot: _snapshot, ...rest } = options;
       options = rest;
     }
-    if (options.spec instanceof VmSpec && options.with) {
+    if (isVmSpecLike(options.spec) && options.with) {
       options.spec = mergeWithBuildersIntoSpec(options.spec, options.with);
     }
-    if (options.spec instanceof VmSpec) {
+    if (isVmSpecLike(options.spec)) {
       let spec = options.spec;
       spec = await processOuterSpecBuilders(spec);
       const { snapshot, ...outerSpecOptions } = spec.raw;
@@ -6499,19 +6505,19 @@ class VmsNamespace {
         options.with = spec.with;
       }
     }
-    const specBuilders = options.spec instanceof VmSpec ? collectSpecBuilders(options.spec) : void 0;
-    const templateBuilders = options.template instanceof VmTemplate ? options.template.with : void 0;
+    const specBuilders = isVmSpecLike(options.spec) ? collectSpecBuilders(options.spec) : void 0;
+    const templateBuilders = isVmTemplateLike(options.template) ? options.template.with : void 0;
     const builders = {
       ...templateBuilders || {},
       ...specBuilders || {},
       ...options.with || {}
     };
-    const { with: _, ...baseConfig } = options;
+    const { with: _, spec: _spec, ...baseConfig } = options;
     let config = baseConfig;
-    if (config.template instanceof VmTemplate) {
+    if (isVmTemplateLike(config.template)) {
       config.template = await processTemplateTree(config.template);
     }
-    if (config.template instanceof VmTemplate) {
+    if (isVmTemplateLike(config.template)) {
       config.template = await ensureNestedTemplates(
         config.template,
         this.snapshots
@@ -6564,7 +6570,7 @@ class VmsNamespace {
     const response = await this.freestyle._apiClient.post("/v1/vms", {
       body: {
         ...config,
-        template: config.template instanceof VmTemplate ? config.template["raw"] : config.template,
+        template: isVmTemplateLike(config.template) ? config.template["raw"] : config.template,
         // Cast systemd since we've processed SystemdServiceInput[] to RawSystemdService[]
         systemd: config.systemd,
         // Normalize git options - default config to {}
@@ -6665,8 +6671,8 @@ class VmSnapshotsNamespace {
   }
   async ensure(options) {
     let requestOptions = options;
-    if (requestOptions.snapshot instanceof VmSpec) {
-      if (requestOptions.spec instanceof VmSpec) {
+    if (isVmSpecLike(requestOptions.snapshot)) {
+      if (isVmSpecLike(requestOptions.spec)) {
         if (!requestOptions.spec.raw.snapshot) {
           requestOptions.spec.raw.snapshot = requestOptions.snapshot;
         }
@@ -6678,7 +6684,7 @@ class VmSnapshotsNamespace {
       const { snapshot: _snapshot, ...rest } = requestOptions;
       requestOptions = rest;
     }
-    if (requestOptions.spec instanceof VmSpec) {
+    if (isVmSpecLike(requestOptions.spec)) {
       let spec = requestOptions.spec;
       spec = await processSpecTree(spec);
       const { snapshot: _snapshotSpec, ...outerSpecOptions } = spec.raw;
@@ -6693,12 +6699,12 @@ class VmSnapshotsNamespace {
       const { spec: _spec, ...rest } = requestOptions;
       requestOptions = rest;
     }
-    if (requestOptions.template instanceof VmTemplate) {
+    if (isVmTemplateLike(requestOptions.template)) {
       const processedTemplate = await processTemplateTree(
         requestOptions.template
       );
       requestOptions.template = processedTemplate;
-      if (processedTemplate.raw.template instanceof VmTemplate) {
+      if (isVmTemplateLike(processedTemplate.raw.template)) {
         requestOptions.template = await ensureNestedTemplates(
           processedTemplate,
           this
@@ -6713,7 +6719,7 @@ class VmSnapshotsNamespace {
     return this.apiClient.post("/v1/vms/snapshots", {
       body: {
         ...requestOptions,
-        template: requestOptions.template instanceof VmTemplate ? requestOptions.template.raw : requestOptions.template
+        template: isVmTemplateLike(requestOptions.template) ? requestOptions.template.raw : requestOptions.template
       }
     }).catch((e) => {
       enhanceError(e);
@@ -6755,7 +6761,7 @@ async function processTemplateTree(template) {
       }
       if (builder.configureNestedTemplate) {
         let nestedTemplate;
-        if (template.raw.template instanceof VmTemplate) {
+        if (isVmTemplateLike(template.raw.template)) {
           nestedTemplate = template.raw.template;
         } else {
           nestedTemplate = new VmTemplate({});
@@ -6806,7 +6812,7 @@ async function processTemplateTree(template) {
       })
     );
   }
-  if (template.raw.template instanceof VmTemplate) {
+  if (isVmTemplateLike(template.raw.template)) {
     template.raw.template = await processTemplateTree(
       template.raw.template
     );
@@ -6815,7 +6821,7 @@ async function processTemplateTree(template) {
 }
 async function ensureNestedTemplates(template, snapshots) {
   const templates = [template];
-  while (templates.at(-1)?.raw.template instanceof VmTemplate) {
+  while (isVmTemplateLike(templates.at(-1)?.raw.template)) {
     const innerTemplate = templates.at(-1).raw.template;
     templates.at(-1).raw.template = void 0;
     templates.push(innerTemplate);
@@ -7002,6 +7008,51 @@ async function readFiles(directory) {
   return files;
 }
 
+async function debugCreateRequests(freestyle, options = {}) {
+  const requests = [];
+  let snapshotCounter = 0;
+  let vmCounter = 0;
+  const apiClient = freestyle._apiClient;
+  const originalPost = apiClient.post.bind(freestyle._apiClient);
+  const mockPost = (async (path, ...args) => {
+    const rawBody = args[0] && "body" in args[0] ? args[0].body : void 0;
+    const clonedBody = JSON.parse(JSON.stringify(rawBody ?? null));
+    if (path === "/v1/vms/snapshots") {
+      requests.push({
+        path: "/v1/vms/snapshots",
+        body: clonedBody
+      });
+      snapshotCounter += 1;
+      return {
+        snapshotId: `__debug_snapshot_${snapshotCounter}__`
+      };
+    }
+    if (path === "/v1/vms") {
+      requests.push({
+        path: "/v1/vms",
+        body: clonedBody
+      });
+      vmCounter += 1;
+      return {
+        id: `__debug_vm_${vmCounter}__`,
+        domains: [],
+        consoleUrl: "https://debug.local/console"
+      };
+    }
+    return originalPost(
+      path,
+      ...args
+    );
+  });
+  apiClient.post = mockPost;
+  try {
+    await freestyle.vms.create(options);
+  } finally {
+    apiClient.post = originalPost;
+  }
+  return requests;
+}
+
 class Freestyle {
   /**
    * @internal
@@ -7071,4 +7122,4 @@ function createLazyFreestyle(options = {}) {
 }
 const freestyle = createLazyFreestyle();
 
-export { CronNamespace, Deployment, errors as Errors, FileSystem, Freestyle, GitRepo, Identity, Systemd, SystemdService, Vm, VmBuilder, VmService, VmSpec, VmTemplate, VmWith, VmWithInstance, freestyle, readFiles };
+export { CronNamespace, Deployment, errors as Errors, FileSystem, Freestyle, GitRepo, Identity, Systemd, SystemdService, Vm, VmBuilder, VmService, VmSpec, VmTemplate, VmWith, VmWithInstance, debugCreateRequests, freestyle, readFiles };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "freestyle-sandboxes",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "type": "module",
   "exports": {
     "require": {