WP-Query-Builder/interfaces/InsertionBuilder.php

<?php
namespace DatabaseHelper\interfaces;

interface InsertionBuilder
{
    /**
     * Initializes an InsertionBuilder with a table blueprint.
     * @param TableBlueprint $table Table to insert data into.
     */
    public function __construct(TableBlueprint $table);

    /**
     * Specifies a single column-value pair for insertion.
     * @param string $col Column name to insert into.
     * @param mixed $val Value to insert.
     * @return InsertionBuilder Current instance for method chaining.
     */
    public function data(string $col, mixed $val): InsertionBuilder;

    /**
     * Marks the current row as complete and finalizes it for insertion.
     * After calling done(), only finalized rows will be inserted.
     * @return InsertionBuilder Current instance for method chaining.
     */
    public function done(): InsertionBuilder;

    /**
     * Executes the insert query.
     * Automatically determines whether to insert a single row or batch insert.
     * @return void
     */
    public function insert(): void;
}