refactor: rename firstOrSave to firstOrCreate

adonis-typings/model.ts

@@ -717,7 +717,7 @@ declare module '@ioc:Adonis/Lucid/Model' {
     /**
      * Returns the first row or save it to the database
      */
-    firstOrSave<T extends ModelConstructorContract> (
+    firstOrCreate<T extends ModelConstructorContract> (
       this: T,
       search: any,
       savePayload?: any,

src/Orm/BaseModel/index.ts

@@ -416,7 +416,7 @@ export class BaseModel implements ModelContract {
   /**
    * Find model instance using a key/value pair
    */
-  public static async firstOrSave<T extends ModelConstructorContract> (
+  public static async firstOrCreate<T extends ModelConstructorContract> (
     this: T,
     search: any,
     savePayload?: any,

test/orm/base-model-options.spec.ts

@@ -436,7 +436,7 @@ test.group('Model options | Model.findMany', (group) => {
   })
 })
 
-test.group('Model options | Model.firstOrSave', (group) => {
+test.group('Model options | Model.firstOrCreate', (group) => {
   group.before(async () => {
     db = getDb()
     BaseModel = getBaseModel(ormAdapter(db))
@@ -465,7 +465,7 @@ test.group('Model options | Model.firstOrSave', (group) => {
 
     await db.insertQuery().table('users').insert({ username: 'virk' })
 
-    const user = await User.firstOrSave({ username: 'virk' }, undefined, { connection: 'secondary' })
+    const user = await User.firstOrCreate({ username: 'virk' }, undefined, { connection: 'secondary' })
     const total = await db.from('users').count('*', 'total')
 
     assert.equal(total[0].total, 1)
@@ -486,7 +486,7 @@ test.group('Model options | Model.firstOrSave', (group) => {
 
     await db.insertQuery().table('users').insert({ username: 'virk' })
 
-    const user = await User.firstOrSave({ username: 'nikk' }, undefined, { connection: 'secondary' })
+    const user = await User.firstOrCreate({ username: 'nikk' }, undefined, { connection: 'secondary' })
     const total = await db.from('users').count('*', 'total')
 
     assert.equal(total[0].total, 2)
@@ -508,7 +508,7 @@ test.group('Model options | Model.firstOrSave', (group) => {
     await db.insertQuery().table('users').insert({ username: 'virk' })
     const profiler = new Profiler({})
 
-    const user = await User.firstOrSave({ username: 'virk' }, undefined, { profiler })
+    const user = await User.firstOrCreate({ username: 'virk' }, undefined, { profiler })
     const total = await db.from('users').count('*', 'total')
 
     assert.equal(total[0].total, 1)
@@ -530,7 +530,7 @@ test.group('Model options | Model.firstOrSave', (group) => {
     await db.insertQuery().table('users').insert({ username: 'virk' })
     const profiler = new Profiler({})
 
-    const user = await User.firstOrSave({ username: 'nikk' }, undefined, { profiler })
+    const user = await User.firstOrCreate({ username: 'nikk' }, undefined, { profiler })
     const total = await db.from('users').count('*', 'total')
 
     assert.equal(total[0].total, 2)
@@ -551,7 +551,7 @@ test.group('Model options | Model.firstOrSave', (group) => {
     await db.insertQuery().table('users').insert({ username: 'virk' })
     const client = db.connection('secondary')
 
-    const user = await User.firstOrSave({ username: 'virk' }, undefined, { client })
+    const user = await User.firstOrCreate({ username: 'virk' }, undefined, { client })
     const total = await db.from('users').count('*', 'total')
 
     assert.equal(total[0].total, 1)
@@ -573,7 +573,7 @@ test.group('Model options | Model.firstOrSave', (group) => {
     await db.insertQuery().table('users').insert({ username: 'virk' })
     const client = db.connection('secondary')
 
-    const user = await User.firstOrSave({ username: 'nikk' }, undefined, { client })
+    const user = await User.firstOrCreate({ username: 'nikk' }, undefined, { client })
     const total = await db.from('users').count('*', 'total')
 
     assert.equal(total[0].total, 2)
@@ -595,7 +595,7 @@ test.group('Model options | Model.firstOrSave', (group) => {
     await db.insertQuery().table('users').insert({ username: 'virk' })
     const client = await db.connection('secondary').transaction()
 
-    const user = await User.firstOrSave({ username: 'virk' }, undefined, { client })
+    const user = await User.firstOrCreate({ username: 'virk' }, undefined, { client })
     await client.commit()
 
     const total = await db.from('users').count('*', 'total')
@@ -618,7 +618,7 @@ test.group('Model options | Model.firstOrSave', (group) => {
 
     const client = await db.connection('secondary').transaction()
 
-    const user = await User.firstOrSave({ username: 'virk' }, undefined, { client })
+    const user = await User.firstOrCreate({ username: 'virk' }, undefined, { client })
     await client.rollback()
 
     const total = await db.from('users').count('*', 'total')

test/orm/base-model.spec.ts

@@ -1569,7 +1569,7 @@ test.group('Base Model | fetch', (group) => {
     }
 
     await db.insertQuery().table('users').insert({ username: 'virk' })
-    const user = await User.firstOrSave({ userName: 'virk' })
+    const user = await User.firstOrCreate({ userName: 'virk' })
 
     const totalUsers = await db.query().from('users').count('*', 'total')
 
@@ -1592,7 +1592,7 @@ test.group('Base Model | fetch', (group) => {
     }
 
     await db.insertQuery().table('users').insert({ username: 'virk' })
-    const user = await User.firstOrSave({ userName: 'nikk' }, { email: '[email protected]' })
+    const user = await User.firstOrCreate({ userName: 'nikk' }, { email: '[email protected]' })
 
     const totalUsers = await db.query().from('users').count('*', 'total')