Added designation type lastInsertId.

src/Helper/RoutineLoaderHelper.php

@@ -215,7 +215,7 @@ private function extractDesignationType(): void
       throw new RoutineLoaderException('Unable to find the designation type of the stored routine');
     }
 
-    if (!in_array($this->designationType, ['none', 'row0', 'row1', 'rows', 'singleton0', 'singleton1']))
+    if (!in_array($this->designationType, ['lastInsertId', 'none', 'row0', 'row1', 'rows', 'singleton0', 'singleton1']))
     {
       throw new RoutineLoaderException("'%s' is not a valid designation type", $this->designationType);
     }

src/SqlitePdoDataLayer.php

@@ -454,6 +454,9 @@ public function insertRows(string $table, array $rows): void
    * Returns the ID of the last inserted row.
    *
    * @return int
+   *
+   * @since 1.0.0
+   * @api
    */
   public function lastInsertId(): int
   {

src/Wrapper/LastInsertIdWrapper.php

@@ -0,0 +1,43 @@
+<?php
+declare(strict_types=1);
+
+namespace SetBased\Stratum\SqlitePdo\Wrapper;
+
+/**
+ * Class for generating a wrapper method for a stored procedure that insert rows in a table with an auto increment key.
+ */
+class LastInsertIdWrapper extends Wrapper
+{
+  //--------------------------------------------------------------------------------------------------------------------
+  /**
+   * @inheritdoc
+   */
+  protected function getDocBlockReturnType(): string
+  {
+    return 'int';
+  }
+
+  //--------------------------------------------------------------------------------------------------------------------
+  /**
+   * @inheritdoc
+   */
+  protected function getReturnTypeDeclaration(): string
+  {
+    return ': int';
+  }
+
+  //--------------------------------------------------------------------------------------------------------------------
+  /**
+   * @inheritdoc
+   */
+  protected function writeResultHandler(): void
+  {
+    $this->codeStore->append('$this->executeNone($query);');
+    $this->codeStore->append('');
+    $this->codeStore->append('return $this->lastInsertId();');
+  }
+
+  //--------------------------------------------------------------------------------------------------------------------
+}
+
+//----------------------------------------------------------------------------------------------------------------------

src/Wrapper/Wrapper.php

@@ -71,6 +71,10 @@ public static function createRoutineWrapper(array $routine, PhpCodeStore $codeSt
   {
     switch ($routine['designation'])
     {
+      case 'lastInsertId':
+        $wrapper = new LastInsertIdWrapper($routine, $codeStore, $nameMangler);
+        break;
+
       case 'none':
         $wrapper = new NoneWrapper($routine, $codeStore, $nameMangler);
         break;

test/LastInsertIdTest.php

@@ -0,0 +1,28 @@
+<?php
+declare(strict_types=1);
+
+namespace SetBased\Stratum\SqlitePdo\Test;
+
+/**
+ * Test cases for stored routines with designation type lastInsertId.
+ */
+class LastInsertIdTest extends DataLayerTestCase
+{
+  //--------------------------------------------------------------------------------------------------------------------
+  /**
+   * Stored routine with designation type lastInsertId must returns IDs start with 1.
+   */
+  public function test01()
+  {
+    $id = $this->dataLayer->tstTestLastIncrementId('Hello');
+    self::assertEquals(1, $id);
+
+    $id = $this->dataLayer->tstTestLastIncrementId('World');
+    self::assertEquals(2, $id);
+  }
+
+  //--------------------------------------------------------------------------------------------------------------------
+}
+
+//----------------------------------------------------------------------------------------------------------------------
+

test/TestDataLayer.php

@@ -158,6 +158,27 @@ public function tstTestIllegalQuery(): array
     return $this->executeRows($query);
   }
 
+  //--------------------------------------------------------------------------------------------------------------------
+  /**
+   * Test case for designation type lastIncrementId.
+   *
+   * @param string|null $pTstTest Some value.
+   *
+   * @return int
+   */
+  public function tstTestLastIncrementId(?string $pTstTest): int
+  {
+    $replace = [':p_tst_test' => $this->quoteString($pTstTest)];
+    $query   = <<< EOT
+insert into TST_LAST_INCREMENT_ID( tst_test )
+values( :p_tst_test )
+EOT;
+    $query = str_repeat(PHP_EOL, 7).strtr($query, $replace);
+    $this->executeNone($query);
+
+    return $this->lastInsertId();
+  }
+
   //--------------------------------------------------------------------------------------------------------------------
   /**
    *

test/ddl/0100_create_tables.sql

@@ -98,3 +98,8 @@ values( 'spam'
 ;
 
 -- ---------------------------------------------------------------------------------------------------------------------
+drop table if exists TST_LAST_INCREMENT_ID;
+
+create table TST_LAST_INCREMENT_ID( tst_test varchar );
+
+-- ---------------------------------------------------------------------------------------------------------------------

test/psql/tst_test_last_increment_id.psql

@@ -0,0 +1,9 @@
+/**
+ * Test case for designation type lastIncrementId.
+ *
+ * @param varchar :p_tst_test Some value.
+ *
+ * @type lastInsertId
+ */
+insert into TST_LAST_INCREMENT_ID( tst_test )
+values( :p_tst_test )