From 933b31326737f7d4d8fc794c276fda157ac5cc1b Mon Sep 17 00:00:00 2001
From: Jan-Niclas Loosen <mail@jnloos.de>
Date: Fri, 24 Jan 2025 13:26:48 +0100
Subject: [PATCH] Finalize database interface

---
 require.php                  | 10 ++++++
 src/Query.php                | 12 --------
 src/QueryBuilder.php         | 19 ------------
 src/Update.php               | 12 --------
 src/interfaces/Database.php  | 59 ++++++++++++++++++++++++++++++++++++
 src/interfaces/Insertion.php |  8 +++++
 src/interfaces/Migration.php |  8 +++++
 src/interfaces/Query.php     |  8 +++++
 src/interfaces/Table.php     |  8 +++++
 src/interfaces/Update.php    |  8 +++++
 10 files changed, 109 insertions(+), 43 deletions(-)
 create mode 100644 require.php
 delete mode 100644 src/Query.php
 delete mode 100644 src/QueryBuilder.php
 delete mode 100644 src/Update.php
 create mode 100644 src/interfaces/Database.php
 create mode 100644 src/interfaces/Insertion.php
 create mode 100644 src/interfaces/Migration.php
 create mode 100644 src/interfaces/Query.php
 create mode 100644 src/interfaces/Table.php
 create mode 100644 src/interfaces/Update.php

diff --git a/require.php b/require.php
new file mode 100644
index 0000000..0cfb281
--- /dev/null
+++ b/require.php
@@ -0,0 +1,10 @@
+<?php
+// Require all interfaces
+require './src/interfaces/Database.php';
+require './src/interfaces/Insertion.php';
+require './src/interfaces/Migration.php';
+require './src/interfaces/Query.php';
+require './src/interfaces/Table.php';
+require './src/interfaces/Update.php';
+
+// Require all classes
\ No newline at end of file
diff --git a/src/Query.php b/src/Query.php
deleted file mode 100644
index 3ef6e68..0000000
--- a/src/Query.php
+++ /dev/null
@@ -1,12 +0,0 @@
-<?php
-
-namespace QueryBuilder;
-
-interface Query
-{
-    /**
-     * Finishes the database query.
-     * @return array Query Results
-     */
-    public function query() : array;
-}
\ No newline at end of file
diff --git a/src/QueryBuilder.php b/src/QueryBuilder.php
deleted file mode 100644
index e8f4cd3..0000000
--- a/src/QueryBuilder.php
+++ /dev/null
@@ -1,19 +0,0 @@
-<?php
-namespace QueryBuilder;
-
-interface QueryBuilder
-{
-    /**
-     * Initializes a Query instance.
-     * @param string ...$tableNames Instance will query on the joined tables.
-     * @return Query Generated instance to build on.
-     */
-    public static function makeQuery(string ...$tableNames) : Query;
-
-    /**
-     * Initializes an Update instance.
-     * @param string ...$tableNames Instance will update on the joined tables.
-     * @return Update Generated instance to build on.
-     */
-    public static function makeUpdate(string ...$tableNames) : Update;
-}
\ No newline at end of file
diff --git a/src/Update.php b/src/Update.php
deleted file mode 100644
index c50016f..0000000
--- a/src/Update.php
+++ /dev/null
@@ -1,12 +0,0 @@
-<?php
-
-namespace QueryBuilder;
-
-interface Update
-{
-    /**
-     * Finishes the database update.
-     * @return array Query Results
-     */
-    public function query() : array;
-}
\ No newline at end of file
diff --git a/src/interfaces/Database.php b/src/interfaces/Database.php
new file mode 100644
index 0000000..ef2546f
--- /dev/null
+++ b/src/interfaces/Database.php
@@ -0,0 +1,59 @@
+<?php
+namespace DatabaseHelper\interfaces;
+
+interface Database
+{
+    /**
+     * Initializes a Table instance to represent a database table.
+     * This instance can be used to define and finalĺy create database tables.
+     *
+     * @param string $tableName The name of the table.
+     * @return Table Generated Table instance.
+     */
+    public static function makeTable(string $tableName): Table;
+
+    /**
+     * Initializes a Migration instance for managing database migrations for the specified table.
+     *
+     * @param Table $table The table for which the migration is being created.
+     * @return Migration Generated Migration instance.
+     */
+    public static function makeMigration(Table $table): Migration;
+
+    /**
+     * Initializes a Query instance to perform operations on the specified tables.
+     * When multiple tables are provided, they will be joined automatically for the query.
+     *
+     * @param Table ...$tables One or more Table instances.
+     * @return Query Generated Query instance.
+     */
+    public static function makeQuery(Table ...$tables): Query;
+
+    /**
+     * Initializes a Query instance specifically for inserting data into the specified tables.
+     * When multiple tables are provided, they will be joined automatically for the insertion.
+     *
+     * @param Table ...$tables One or more Table instances.
+     * @return Query Generated Query instance.
+     */
+    public static function makeInsertion(Table ...$tables): Query;
+
+    /**
+     * Initializes an Update instance to perform updates on the specified tables.
+     * When multiple tables are provided, they will be joined automatically.
+     *
+     * @param Table ...$tables One or more Table instances.
+     * @return Update Generated Update instance.
+     */
+    public static function makeUpdate(Table ...$tables): Update;
+
+    /**
+     * Standardizes table names by ensuring they include the WordPress database prefix.
+     * If the prefix is not already present, it will be added.
+     * The provided name(s) are passed by reference and will be modified directly.
+     *
+     * @param string &...$tableName The table names to standardize.
+     */
+    public static function standardizeTableNames(string &...$tableName): string;
+
+}
diff --git a/src/interfaces/Insertion.php b/src/interfaces/Insertion.php
new file mode 100644
index 0000000..4aff2fe
--- /dev/null
+++ b/src/interfaces/Insertion.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace DatabaseHelper\interfaces;
+
+interface Insertion
+{
+    public function exec() : array;
+}
\ No newline at end of file
diff --git a/src/interfaces/Migration.php b/src/interfaces/Migration.php
new file mode 100644
index 0000000..7e0e5d5
--- /dev/null
+++ b/src/interfaces/Migration.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace DatabaseHelper\interfaces;
+
+interface Migration
+{
+    public function exec() : array;
+}
\ No newline at end of file
diff --git a/src/interfaces/Query.php b/src/interfaces/Query.php
new file mode 100644
index 0000000..a6965be
--- /dev/null
+++ b/src/interfaces/Query.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace DatabaseHelper\interfaces;
+
+interface Query
+{
+    public function exec() : array;
+}
\ No newline at end of file
diff --git a/src/interfaces/Table.php b/src/interfaces/Table.php
new file mode 100644
index 0000000..c00f9d9
--- /dev/null
+++ b/src/interfaces/Table.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace DatabaseHelper\interfaces;
+
+interface Table
+{
+    public function exec() : void;
+}
\ No newline at end of file
diff --git a/src/interfaces/Update.php b/src/interfaces/Update.php
new file mode 100644
index 0000000..00499d1
--- /dev/null
+++ b/src/interfaces/Update.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace DatabaseHelper\interfaces;
+
+interface Update
+{
+    public function exec() : array;
+}
\ No newline at end of file