sandlot 0.2.0 → 0.2.2

package/src/types.ts

@@ -22,6 +22,12 @@ export interface IBundler {
    * Bundle source files from a filesystem into a single output
    */
   bundle(options: BundleOptions): Promise<BundleResult>;
+
+  /**
+   * Dispose of resources held by the bundler (optional).
+   * Called by Sandlot.dispose() to clean up background services.
+   */
+  dispose?(): Promise<void>;
 }
 
 export interface BundleOptions {
@@ -366,8 +372,11 @@ export interface BuildSuccess {
   warnings: BundleWarning[];
 }
 
-export interface BuildFailure {
-  success: false;
+/**
+ * Details about why a build failed.
+ * Used by both BuildResult and RunResult.
+ */
+export interface BuildFailureDetails {
   /** Which phase of the build failed */
   phase: BuildPhase;
   /** Error message (for entry failures) */
@@ -380,6 +389,10 @@ export interface BuildFailure {
   bundleWarnings?: BundleWarning[];
 }
 
+export interface BuildFailure extends BuildFailureDetails {
+  success: false;
+}
+
 
 // -----------------------------------------------------------------------------
 // Install/Uninstall Types
@@ -500,11 +513,8 @@ export interface RunOptions {
  * If `buildFailure` is present, the build failed before execution.
  */
 export interface RunResult extends ExecuteResult {
-  /** If build failed, contains failure details */
-  buildFailure?: {
-    phase: BuildPhase;
-    message?: string;
-  };
+  /** If build failed, contains failure details (same structure as BuildFailure) */
+  buildFailure?: BuildFailureDetails;
 }
 
 // -----------------------------------------------------------------------------
@@ -665,4 +675,25 @@ export interface Sandlot {
    * The shared module registry (if shared modules were provided)
    */
   readonly sharedModules: ISharedModuleRegistry | null;
+
+  /**
+   * Dispose of resources held by this Sandlot instance.
+   * 
+   * This should be called when you're done using Sandlot to allow
+   * the process to exit cleanly. It stops any background services
+   * like the esbuild child process.
+   * 
+   * After calling dispose(), this instance should not be used.
+   * 
+   * @example
+   * ```ts
+   * const sandlot = await createNodeSandlot();
+   * const sandbox = await sandlot.createSandbox();
+   * 
+   * // ... do work ...
+   * 
+   * await sandlot.dispose(); // Allow process to exit
+   * ```
+   */
+  dispose(): Promise<void>;
 }