bun-types 1.2.21-canary.20250819T140628 → 1.2.21-canary.20250821T140634

package/bun.d.ts

@@ -14,7 +14,6 @@
  * This module aliases `globalThis.Bun`.
  */
 declare module "bun" {
-  type DistributedOmit<T, K extends PropertyKey> = T extends T ? Omit<T, K> : never;
   type PathLike = string | NodeJS.TypedArray | ArrayBufferLike | URL;
   type ArrayBufferView<TArrayBuffer extends ArrayBufferLike = ArrayBufferLike> =
     | NodeJS.TypedArray<TArrayBuffer>
@@ -68,38 +67,30 @@ declare module "bun" {
           ? T
           : Otherwise // Not defined in lib dom (or anywhere else), so no conflict. We can safely use our own definition
         : Otherwise; // Lib dom not loaded anyway, so no conflict. We can safely use our own definition
-  }
-
-  /** @deprecated This type is unused in Bun's types and might be removed in the near future */
-  type Platform =
-    | "aix"
-    | "android"
-    | "darwin"
-    | "freebsd"
-    | "haiku"
-    | "linux"
-    | "openbsd"
-    | "sunos"
-    | "win32"
-    | "cygwin"
-    | "netbsd";
-
-  /** @deprecated This type is unused in Bun's types and might be removed in the near future */
-  type Architecture = "arm" | "arm64" | "ia32" | "mips" | "mipsel" | "ppc" | "ppc64" | "s390" | "s390x" | "x64";
 
-  /** @deprecated This type is unused in Bun's types and might be removed in the near future */
-  type UncaughtExceptionListener = (error: Error, origin: UncaughtExceptionOrigin) => void;
-
-  /**
-   * Most of the time the unhandledRejection will be an Error, but this should not be relied upon
-   * as *anything* can be thrown/rejected, it is therefore unsafe to assume that the value is an Error.
-   *
-   * @deprecated This type is unused in Bun's types and might be removed in the near future
-   */
-  type UnhandledRejectionListener = (reason: unknown, promise: Promise<unknown>) => void;
+    /**
+     * Like Omit, but correctly distributes over unions. Most useful for removing
+     * properties from union options objects, like {@link Bun.SQL.Options}
+     *
+     * @example
+     * ```ts
+     * type X = Bun.DistributedOmit<{type?: 'a', url?: string} | {type?: 'b', flag?: boolean}, "url">
+     * // `{type?: 'a'} | {type?: 'b', flag?: boolean}` (Omit applied to each union item instead of entire type)
+     *
+     * type X = Omit<{type?: 'a', url?: string} | {type?: 'b', flag?: boolean}, "url">;
+     * // `{type?: "a" | "b" | undefined}` (Missing `flag` property and no longer a union)
+     * ```
+     */
+    type DistributedOmit<T, K extends PropertyKey> = T extends T ? Omit<T, K> : never;
 
-  /** @deprecated This type is unused in Bun's types and might be removed in the near future */
-  type MultipleResolveListener = (type: MultipleResolveType, promise: Promise<unknown>, value: unknown) => void;
+    type KeysInBoth<A, B> = Extract<keyof A, keyof B>;
+    type MergeInner<A, B> = Omit<A, KeysInBoth<A, B>> &
+      Omit<B, KeysInBoth<A, B>> & {
+        [Key in KeysInBoth<A, B>]: A[Key] | B[Key];
+      };
+    type Merge<A, B> = MergeInner<A, B> & MergeInner<B, A>;
+    type DistributedMerge<T, Else = T> = T extends T ? Merge<T, Exclude<Else, T>> : never;
+  }
 
   interface ErrorEventInit extends EventInit {
     colno?: number;
@@ -1276,678 +1267,6 @@ declare module "bun" {
     stat(): Promise<import("node:fs").Stats>;
   }
 
-  namespace SQL {
-    type AwaitPromisesArray<T extends Array<PromiseLike<any>>> = {
-      [K in keyof T]: Awaited<T[K]>;
-    };
-
-    type ContextCallbackResult<T> = T extends Array<PromiseLike<any>> ? AwaitPromisesArray<T> : Awaited<T>;
-    type ContextCallback<T, SQL> = (sql: SQL) => Promise<T>;
-
-    /**
-     * Configuration options for SQL client connection and behavior
-     *
-     * @example
-     * ```ts
-     * const config: Bun.SQL.Options = {
-     *   host: 'localhost',
-     *   port: 5432,
-     *   user: 'dbuser',
-     *   password: 'secretpass',
-     *   database: 'myapp',
-     *   idleTimeout: 30,
-     *   max: 20,
-     *   onconnect: (client) => {
-     *     console.log('Connected to database');
-     *   }
-     * };
-     * ```
-     */
-    interface Options {
-      /**
-       * Connection URL (can be string or URL object)
-       */
-      url?: URL | string | undefined;
-
-      /**
-       * Database server hostname
-       * @default "localhost"
-       */
-      host?: string | undefined;
-
-      /**
-       * Database server hostname (alias for host)
-       * @deprecated Prefer {@link host}
-       * @default "localhost"
-       */
-      hostname?: string | undefined;
-
-      /**
-       * Database server port number
-       * @default 5432
-       */
-      port?: number | string | undefined;
-
-      /**
-       * Database user for authentication
-       * @default "postgres"
-       */
-      username?: string | undefined;
-
-      /**
-       * Database user for authentication (alias for username)
-       * @deprecated Prefer {@link username}
-       * @default "postgres"
-       */
-      user?: string | undefined;
-
-      /**
-       * Database password for authentication
-       * @default ""
-       */
-      password?: string | (() => MaybePromise<string>) | undefined;
-
-      /**
-       * Database password for authentication (alias for password)
-       * @deprecated Prefer {@link password}
-       * @default ""
-       */
-      pass?: string | (() => MaybePromise<string>) | undefined;
-
-      /**
-       * Name of the database to connect to
-       * @default The username value
-       */
-      database?: string | undefined;
-
-      /**
-       * Name of the database to connect to (alias for database)
-       * @deprecated Prefer {@link database}
-       * @default The username value
-       */
-      db?: string | undefined;
-
-      /**
-       * Database adapter/driver to use
-       * @default "postgres"
-       */
-      adapter?: "postgres" /*| "sqlite" | "mysql"*/ | (string & {}) | undefined;
-
-      /**
-       * Maximum time in seconds to wait for connection to become available
-       * @default 0 (no timeout)
-       */
-      idleTimeout?: number | undefined;
-
-      /**
-       * Maximum time in seconds to wait for connection to become available (alias for idleTimeout)
-       * @deprecated Prefer {@link idleTimeout}
-       * @default 0 (no timeout)
-       */
-      idle_timeout?: number | undefined;
-
-      /**
-       * Maximum time in seconds to wait when establishing a connection
-       * @default 30
-       */
-      connectionTimeout?: number | undefined;
-
-      /**
-       * Maximum time in seconds to wait when establishing a connection (alias for connectionTimeout)
-       * @deprecated Prefer {@link connectionTimeout}
-       * @default 30
-       */
-      connection_timeout?: number | undefined;
-
-      /**
-       * Maximum time in seconds to wait when establishing a connection (alias for connectionTimeout)
-       * @deprecated Prefer {@link connectionTimeout}
-       * @default 30
-       */
-      connectTimeout?: number | undefined;
-
-      /**
-       * Maximum time in seconds to wait when establishing a connection (alias for connectionTimeout)
-       * @deprecated Prefer {@link connectionTimeout}
-       * @default 30
-       */
-      connect_timeout?: number | undefined;
-
-      /**
-       * Maximum lifetime in seconds of a connection
-       * @default 0 (no maximum lifetime)
-       */
-      maxLifetime?: number | undefined;
-
-      /**
-       * Maximum lifetime in seconds of a connection (alias for maxLifetime)
-       * @deprecated Prefer {@link maxLifetime}
-       * @default 0 (no maximum lifetime)
-       */
-      max_lifetime?: number | undefined;
-
-      /**
-       * Whether to use TLS/SSL for the connection
-       * @default false
-       */
-      tls?: TLSOptions | boolean | undefined;
-
-      /**
-       * Whether to use TLS/SSL for the connection (alias for tls)
-       * @default false
-       */
-      ssl?: TLSOptions | boolean | undefined;
-
-      // `.path` is currently unsupported in Bun, the implementation is incomplete.
-      //
-      // /**
-      //  * Unix domain socket path for connection
-      //  * @default ""
-      //  */
-      // path?: string | undefined;
-
-      /**
-       * Callback function executed when a connection is established
-       */
-      onconnect?: ((client: SQL) => void) | undefined;
-
-      /**
-       * Callback function executed when a connection is closed
-       */
-      onclose?: ((client: SQL) => void) | undefined;
-
-      /**
-       * Postgres client runtime configuration options
-       *
-       * @see https://www.postgresql.org/docs/current/runtime-config-client.html
-       */
-      connection?: Record<string, string | boolean | number> | undefined;
-
-      /**
-       * Maximum number of connections in the pool
-       * @default 10
-       */
-      max?: number | undefined;
-
-      /**
-       * By default values outside i32 range are returned as strings. If this is true, values outside i32 range are returned as BigInts.
-       * @default false
-       */
-      bigint?: boolean | undefined;
-
-      /**
-       * Automatic creation of prepared statements
-       * @default true
-       */
-      prepare?: boolean | undefined;
-    }
-
-    /**
-     * Represents a SQL query that can be executed, with additional control methods
-     * Extends Promise to allow for async/await usage
-     */
-    interface Query<T> extends Promise<T> {
-      /**
-       * Indicates if the query is currently executing
-       */
-      active: boolean;
-
-      /**
-       * Indicates if the query has been cancelled
-       */
-      cancelled: boolean;
-
-      /**
-       * Cancels the executing query
-       */
-      cancel(): Query<T>;
-
-      /**
-       * Executes the query as a simple query, no parameters are allowed but can execute multiple commands separated by semicolons
-       */
-      simple(): Query<T>;
-
-      /**
-       * Executes the query
-       */
-      execute(): Query<T>;
-
-      /**
-       * Returns the raw query result
-       */
-      raw(): Query<T>;
-
-      /**
-       * Returns only the values from the query result
-       */
-      values(): Query<T>;
-    }
-
-    /**
-     * Callback function type for transaction contexts
-     * @param sql Function to execute SQL queries within the transaction
-     */
-    type TransactionContextCallback<T> = ContextCallback<T, TransactionSQL>;
-
-    /**
-     * Callback function type for savepoint contexts
-     * @param sql Function to execute SQL queries within the savepoint
-     */
-    type SavepointContextCallback<T> = ContextCallback<T, SavepointSQL>;
-
-    /**
-     * SQL.Helper represents a parameter or serializable
-     * value inside of a query.
-     *
-     * @example
-     * ```ts
-     * const helper = sql(users, 'id');
-     * await sql`insert into users ${helper}`;
-     * ```
-     */
-    interface Helper<T> {
-      readonly value: T[];
-      readonly columns: (keyof T)[];
-    }
-  }
-
-  /**
-   * Main SQL client interface providing connection and transaction management
-   */
-  interface SQL extends AsyncDisposable {
-    /**
-     * Executes a SQL query using template literals
-     * @example
-     * ```ts
-     * const [user] = await sql<Users[]>`select * from users where id = ${1}`;
-     * ```
-     */
-    <T = any>(strings: TemplateStringsArray, ...values: unknown[]): SQL.Query<T>;
-
-    /**
-     * Execute a SQL query using a string
-     *
-     * @example
-     * ```ts
-     * const users = await sql<User[]>`SELECT * FROM users WHERE id = ${1}`;
-     * ```
-     */
-    <T = any>(string: string): SQL.Query<T>;
-
-    /**
-     * Helper function for inserting an object into a query
-     *
-     * @example
-     * ```ts
-     * // Insert an object
-     * const result = await sql`insert into users ${sql(users)} returning *`;
-     *
-     * // Or pick specific columns
-     * const result = await sql`insert into users ${sql(users, "id", "name")} returning *`;
-     *
-     * // Or a single object
-     * const result = await sql`insert into users ${sql(user)} returning *`;
-     * ```
-     */
-    <T extends { [Key in PropertyKey]: unknown }>(obj: T | T[] | readonly T[]): SQL.Helper<T>;
-
-    /**
-     * Helper function for inserting an object into a query, supporting specific columns
-     *
-     * @example
-     * ```ts
-     * // Insert an object
-     * const result = await sql`insert into users ${sql(users)} returning *`;
-     *
-     * // Or pick specific columns
-     * const result = await sql`insert into users ${sql(users, "id", "name")} returning *`;
-     *
-     * // Or a single object
-     * const result = await sql`insert into users ${sql(user)} returning *`;
-     * ```
-     */
-    <T extends { [Key in PropertyKey]: unknown }, Keys extends keyof T = keyof T>(
-      obj: T | T[] | readonly T[],
-      ...columns: readonly Keys[]
-    ): SQL.Helper<Pick<T, Keys>>;
-
-    /**
-     * Helper function for inserting any serializable value into a query
-     *
-     * @example
-     * ```ts
-     * const result = await sql`SELECT * FROM users WHERE id IN ${sql([1, 2, 3])}`;
-     * ```
-     */
-    <T>(value: T): SQL.Helper<T>;
-
-    /**
-     * Commits a distributed transaction also know as prepared transaction in postgres or XA transaction in MySQL
-     *
-     * @param name - The name of the distributed transaction
-     *
-     * @example
-     * ```ts
-     * await sql.commitDistributed("my_distributed_transaction");
-     * ```
-     */
-    commitDistributed(name: string): Promise<void>;
-
-    /**
-     * Rolls back a distributed transaction also know as prepared transaction in postgres or XA transaction in MySQL
-     *
-     * @param name - The name of the distributed transaction
-     *
-     * @example
-     * ```ts
-     * await sql.rollbackDistributed("my_distributed_transaction");
-     * ```
-     */
-    rollbackDistributed(name: string): Promise<void>;
-
-    /** Waits for the database connection to be established
-     *
-     * @example
-     * ```ts
-     * await sql.connect();
-     * ```
-     */
-    connect(): Promise<SQL>;
-
-    /**
-     * Closes the database connection with optional timeout in seconds. If timeout is 0, it will close immediately, if is not provided it will wait for all queries to finish before closing.
-     *
-     * @param options - The options for the close
-     *
-     * @example
-     * ```ts
-     * await sql.close({ timeout: 1 });
-     * ```
-     */
-    close(options?: { timeout?: number }): Promise<void>;
-
-    /**
-     * Closes the database connection with optional timeout in seconds. If timeout is 0, it will close immediately, if is not provided it will wait for all queries to finish before closing.
-     * This is an alias of {@link SQL.close}
-     *
-     * @param options - The options for the close
-     *
-     * @example
-     * ```ts
-     * await sql.end({ timeout: 1 });
-     * ```
-     */
-    end(options?: { timeout?: number }): Promise<void>;
-
-    /**
-     * Flushes any pending operations
-     *
-     * @example
-     * ```ts
-     * sql.flush();
-     * ```
-     */
-    flush(): void;
-
-    /**
-     * The reserve method pulls out a connection from the pool, and returns a client that wraps the single connection.
-     *
-     * This can be used for running queries on an isolated connection.
-     * Calling reserve in a reserved Sql will return a new reserved connection,  not the same connection (behavior matches postgres package).
-     *
-     * @example
-     * ```ts
-     * const reserved = await sql.reserve();
-     * await reserved`select * from users`;
-     * await reserved.release();
-     * // with in a production scenario would be something more like
-     * const reserved = await sql.reserve();
-     * try {
-     *   // ... queries
-     * } finally {
-     *   await reserved.release();
-     * }
-     *
-     * // Bun supports Symbol.dispose and Symbol.asyncDispose
-     * {
-     *  // always release after context (safer)
-     *  using reserved = await sql.reserve()
-     *  await reserved`select * from users`
-     * }
-     * ```
-     */
-    reserve(): Promise<ReservedSQL>;
-
-    /**
-     * Begins a new transaction.
-     *
-     * Will reserve a connection for the transaction and supply a scoped sql instance for all transaction uses in the callback function. sql.begin will resolve with the returned value from the callback function.
-     * BEGIN is automatically sent with the optional options, and if anything fails ROLLBACK will be called so the connection can be released and execution can continue.
-     * @example
-     * const [user, account] = await sql.begin(async sql => {
-     *   const [user] = await sql`
-     *     insert into users (
-     *       name
-     *     ) values (
-     *       'Murray'
-     *     )
-     *     returning *
-     *   `
-     *   const [account] = await sql`
-     *     insert into accounts (
-     *       user_id
-     *     ) values (
-     *       ${ user.user_id }
-     *     )
-     *     returning *
-     *   `
-     *   return [user, account]
-     * })
-     */
-    begin<const T>(fn: SQL.TransactionContextCallback<T>): Promise<SQL.ContextCallbackResult<T>>;
-
-    /**
-     * Begins a new transaction with options.
-     *
-     * Will reserve a connection for the transaction and supply a scoped sql instance for all transaction uses in the callback function. sql.begin will resolve with the returned value from the callback function.
-     * BEGIN is automatically sent with the optional options, and if anything fails ROLLBACK will be called so the connection can be released and execution can continue.
-     * @example
-     * const [user, account] = await sql.begin("read write", async sql => {
-     *   const [user] = await sql`
-     *     insert into users (
-     *       name
-     *     ) values (
-     *       'Murray'
-     *     )
-     *     returning *
-     *   `
-     *   const [account] = await sql`
-     *     insert into accounts (
-     *       user_id
-     *     ) values (
-     *       ${ user.user_id }
-     *     )
-     *     returning *
-     *   `
-     *   return [user, account]
-     * })
-     */
-    begin<const T>(options: string, fn: SQL.TransactionContextCallback<T>): Promise<SQL.ContextCallbackResult<T>>;
-
-    /**
-     * Alternative method to begin a transaction.
-     *
-     * Will reserve a connection for the transaction and supply a scoped sql instance for all transaction uses in the callback function. sql.transaction will resolve with the returned value from the callback function.
-     * BEGIN is automatically sent with the optional options, and if anything fails ROLLBACK will be called so the connection can be released and execution can continue.
-     * @alias begin
-     * @example
-     * const [user, account] = await sql.transaction(async sql => {
-     *   const [user] = await sql`
-     *     insert into users (
-     *       name
-     *     ) values (
-     *       'Murray'
-     *     )
-     *     returning *
-     *   `
-     *   const [account] = await sql`
-     *     insert into accounts (
-     *       user_id
-     *     ) values (
-     *       ${ user.user_id }
-     *     )
-     *     returning *
-     *   `
-     *   return [user, account]
-     * })
-     */
-    transaction<const T>(fn: SQL.TransactionContextCallback<T>): Promise<SQL.ContextCallbackResult<T>>;
-
-    /**
-     * Alternative method to begin a transaction with options
-     * Will reserve a connection for the transaction and supply a scoped sql instance for all transaction uses in the callback function. sql.transaction will resolve with the returned value from the callback function.
-     * BEGIN is automatically sent with the optional options, and if anything fails ROLLBACK will be called so the connection can be released and execution can continue.
-     *
-     * @alias {@link begin}
-     *
-     * @example
-     * const [user, account] = await sql.transaction("read write", async sql => {
-     *   const [user] = await sql`
-     *     insert into users (
-     *       name
-     *     ) values (
-     *       'Murray'
-     *     )
-     *     returning *
-     *   `
-     *   const [account] = await sql`
-     *     insert into accounts (
-     *       user_id
-     *     ) values (
-     *       ${ user.user_id }
-     *     )
-     *     returning *
-     *   `
-     *   return [user, account]
-     * });
-     */
-    transaction<const T>(options: string, fn: SQL.TransactionContextCallback<T>): Promise<SQL.ContextCallbackResult<T>>;
-
-    /**
-     * Begins a distributed transaction
-     * Also know as Two-Phase Commit, in a distributed transaction, Phase 1 involves the coordinator preparing nodes by ensuring data is written and ready to commit, while Phase 2 finalizes with nodes committing or rolling back based on the coordinator's decision, ensuring durability and releasing locks.
-     * In PostgreSQL and MySQL distributed transactions persist beyond the original session, allowing privileged users or coordinators to commit/rollback them, ensuring support for distributed transactions, recovery, and administrative tasks.
-     * beginDistributed will automatic rollback if any exception are not caught, and you can commit and rollback later if everything goes well.
-     * PostgreSQL natively supports distributed transactions using PREPARE TRANSACTION, while MySQL uses XA Transactions, and MSSQL also supports distributed/XA transactions. However, in MSSQL, distributed transactions are tied to the original session, the DTC coordinator, and the specific connection.
-     * These transactions are automatically committed or rolled back following the same rules as regular transactions, with no option for manual intervention from other sessions, in MSSQL distributed transactions are used to coordinate transactions using Linked Servers.
-     *
-     * @example
-     * await sql.beginDistributed("numbers", async sql => {
-     *   await sql`create table if not exists numbers (a int)`;
-     *   await sql`insert into numbers values(1)`;
-     * });
-     * // later you can call
-     * await sql.commitDistributed("numbers");
-     * // or await sql.rollbackDistributed("numbers");
-     */
-    beginDistributed<const T>(
-      name: string,
-      fn: SQL.TransactionContextCallback<T>,
-    ): Promise<SQL.ContextCallbackResult<T>>;
-
-    /** Alternative method to begin a distributed transaction
-     * @alias {@link beginDistributed}
-     */
-    distributed<const T>(name: string, fn: SQL.TransactionContextCallback<T>): Promise<SQL.ContextCallbackResult<T>>;
-
-    /**If you know what you're doing, you can use unsafe to pass any string you'd like.
-     * Please note that this can lead to SQL injection if you're not careful.
-     * You can also nest sql.unsafe within a safe sql expression. This is useful if only part of your fraction has unsafe elements.
-     * @example
-     * const result = await sql.unsafe(`select ${danger} from users where id = ${dragons}`)
-     */
-    unsafe<T = any>(string: string, values?: any[]): SQL.Query<T>;
-
-    /**
-     * Reads a file and uses the contents as a query.
-     * Optional parameters can be used if the file includes $1, $2, etc
-     * @example
-     * const result = await sql.file("query.sql", [1, 2, 3]);
-     */
-    file<T = any>(filename: string, values?: any[]): SQL.Query<T>;
-
-    /**
-     * Current client options
-     */
-    options: SQL.Options;
-  }
-
-  const SQL: {
-    /**
-     * Creates a new SQL client instance
-     *
-     * @param connectionString - The connection string for the SQL client
-     *
-     * @example
-     * ```ts
-     * const sql = new SQL("postgres://localhost:5432/mydb");
-     * const sql = new SQL(new URL("postgres://localhost:5432/mydb"));
-     * ```
-     */
-    new (connectionString: string | URL): SQL;
-
-    /**
-     * Creates a new SQL client instance with options
-     *
-     * @param connectionString - The connection string for the SQL client
-     * @param options - The options for the SQL client
-     *
-     * @example
-     * ```ts
-     * const sql = new SQL("postgres://localhost:5432/mydb", { idleTimeout: 1000 });
-     * ```
-     */
-    new (connectionString: string | URL, options: Omit<SQL.Options, "url">): SQL;
-
-    /**
-     * Creates a new SQL client instance with options
-     *
-     * @param options - The options for the SQL client
-     *
-     * @example
-     * ```ts
-     * const sql = new SQL({ url: "postgres://localhost:5432/mydb", idleTimeout: 1000 });
-     * ```
-     */
-    new (options?: SQL.Options): SQL;
-  };
-
-  /**
-   * Represents a reserved connection from the connection pool
-   * Extends SQL with additional release functionality
-   */
-  interface ReservedSQL extends SQL, Disposable {
-    /**
-     * Releases the client back to the connection pool
-     */
-    release(): void;
-  }
-
-  /**
-   * Represents a client within a transaction context
-   * Extends SQL with savepoint functionality
-   */
-  interface TransactionSQL extends SQL {
-    /** Creates a savepoint within the current transaction */
-    savepoint<T>(name: string, fn: SQLSavepointContextCallback<T>): Promise<T>;
-    savepoint<T>(fn: SQLSavepointContextCallback<T>): Promise<T>;
-  }
-
-  /**
-   * Represents a savepoint within a transaction
-   */
-  interface SavepointSQL extends SQL {}
-
   type CSRFAlgorithm = "blake2b256" | "blake2b512" | "sha256" | "sha384" | "sha512" | "sha512-256";
 
   interface CSRFGenerateOptions {
@@ -1995,16 +1314,6 @@ declare module "bun" {
     maxAge?: number;
   }
 
-  /**
-   * SQL client
-   */
-  const sql: SQL;
-
-  /**
-   * SQL client for PostgreSQL
-   */
-  const postgres: SQL;
-
   /**
    * Generate and verify CSRF tokens
    *
@@ -2319,12 +1628,24 @@ declare module "bun" {
     kind: ImportKind;
   }
 
+  namespace _BunBuildInterface {
+    type Architecture = "x64" | "arm64";
+    type Libc = "glibc" | "musl";
+    type SIMD = "baseline" | "modern";
+    type Target =
+      | `bun-darwin-${Architecture}`
+      | `bun-darwin-x64-${SIMD}`
+      | `bun-linux-${Architecture}`
+      | `bun-linux-${Architecture}-${Libc}`
+      | "bun-windows-x64"
+      | `bun-windows-x64-${SIMD}`
+      | `bun-linux-x64-${SIMD}-${Libc}`;
+  }
   /**
    * @see [Bun.build API docs](https://bun.com/docs/bundler#api)
    */
-  interface BuildConfig {
+  interface BuildConfigBase {
     entrypoints: string[]; // list of file path
-    outdir?: string; // output directory
     /**
      * @default "browser"
      */
@@ -2362,7 +1683,6 @@ declare module "bun" {
           asset?: string;
         }; // | string;
     root?: string; // project root
-    splitting?: boolean; // default true, enable code splitting
     plugins?: BunPlugin[];
     // manifest?: boolean; // whether to return manifest
     external?: string[];
@@ -2511,8 +1831,57 @@ declare module "bun" {
      * ```
      */
     tsconfig?: string;
+
+    outdir?: string;
   }
 
+  interface CompileBuildOptions {
+    target?: _BunBuildInterface.Target;
+    execArgv?: string[];
+    executablePath?: string;
+    outfile?: string;
+    windows?: {
+      hideConsole?: boolean;
+      icon?: string;
+      title?: string;
+    };
+  }
+
+  // Compile build config - uses outfile for executable output
+  interface CompileBuildConfig extends BuildConfigBase {
+    /**
+     * Create a standalone executable
+     *
+     * When `true`, creates an executable for the current platform.
+     * When a target string, creates an executable for that platform.
+     *
+     * @example
+     * ```ts
+     * // Create executable for current platform
+     * await Bun.build({
+     *   entrypoints: ['./app.js'],
+     *   compile: {
+     *     target: 'linux-x64',
+     *   },
+     *   outfile: './my-app'
+     * });
+     *
+     * // Cross-compile for Linux x64
+     * await Bun.build({
+     *   entrypoints: ['./app.js'],
+     *   compile: 'linux-x64',
+     *   outfile: './my-app'
+     * });
+     * ```
+     */
+    compile: boolean | _BunBuildInterface.Target | CompileBuildOptions;
+  }
+
+  /**
+   * @see [Bun.build API docs](https://bun.com/docs/bundler#api)
+   */
+  type BuildConfig = BuildConfigBase | CompileBuildConfig;
+
   /**
    * Hash and verify passwords using argon2 or bcrypt
    *
@@ -4383,11 +3752,11 @@ declare module "bun" {
    * The type of options that can be passed to {@link serve}, with support for `routes` and a safer requirement for `fetch`
    */
   type ServeFunctionOptions<T, R extends { [K in keyof R]: RouterTypes.RouteValue<Extract<K, string>> }> =
-    | (DistributedOmit<Exclude<Serve<T>, WebSocketServeOptions<T>>, "fetch"> & {
+    | (__internal.DistributedOmit<Exclude<Serve<T>, WebSocketServeOptions<T>>, "fetch"> & {
         routes: R;
         fetch?: (this: Server, request: Request, server: Server) => Response | Promise<Response>;
       })
-    | (DistributedOmit<Exclude<Serve<T>, WebSocketServeOptions<T>>, "routes"> & {
+    | (__internal.DistributedOmit<Exclude<Serve<T>, WebSocketServeOptions<T>>, "routes"> & {
         routes?: never;
         fetch: (this: Server, request: Request, server: Server) => Response | Promise<Response>;
       })