v2

LICENSE.md

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright © 2020 Nikita Tokarchuk
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

go.mod

@@ -4,7 +4,6 @@ require (
 	github.com/google/go-cmp v0.3.0 // indirect
 	github.com/klauspost/compress v1.10.1 // indirect
 	github.com/pkg/errors v0.9.1 // indirect
-	github.com/stretchr/testify v1.5.1
 	github.com/xdg/stringprep v1.0.0 // indirect
 	go.mongodb.org/mongo-driver v1.3.0
 	golang.org/x/crypto v0.0.0-20200221231518-2aa609cf4a9d // indirect

go.sum

@@ -71,8 +71,6 @@ github.com/stretchr/objx v0.1.1/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+
 github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
 github.com/stretchr/testify v1.3.0 h1:TivCn/peBQ7UY8ooIcPgZFpTNSz0Q2U6UrFlUfqbe0Q=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
-github.com/stretchr/testify v1.5.1 h1:nOGnQDM7FYENwehXlg/kFVnos3rEvtKTjRvOWSzb6H4=
-github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA=
 github.com/tidwall/pretty v1.0.0 h1:HsD+QiTn7sK6flMKIvNmpqz1qrpP3Ps6jOKIKMooyg4=
 github.com/tidwall/pretty v1.0.0/go.mod h1:XNkn88O1ChpSDQmQeStsy+sBenx6DDtFZJxhVysOjyk=
 github.com/xdg/scram v0.0.0-20180814205039-7eeb5667e42c h1:u40Z8hqBAAQyv+vATcGgV0YCnDjqSL7/q/JyPhhJSPk=
@@ -115,5 +113,4 @@ golang.org/x/tools v0.0.0-20190531172133-b3315ee88b7d/go.mod h1:/rFqwRUd4F7ZHNgw
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI=
-gopkg.in/yaml.v2 v2.2.2 h1:ZCJp+EgiOT7lHqUV2J862kp8Qj64Jo6az82+3Td9dZw=
 gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=

mongox/base/getid.go

@@ -1,33 +1,28 @@
 package base
 
 import (
-	"fmt"
-
 	"go.mongodb.org/mongo-driver/bson/primitive"
 
 	"github.com/mainnika/mongox-go-driver/v2/mongox"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/utils"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
 )
 
 // GetID returns source document id
 func GetID(source interface{}) (id interface{}) {
 
 	switch doc := source.(type) {
-	case mongox.OIDBased:
+	case mongox.BaseObjectID:
 		return getObjectIDOrGenerate(doc)
-	case mongox.StringBased:
+	case mongox.BaseString:
 		return getStringIDOrPanic(doc)
-	case mongox.JSONBased:
+	case mongox.BaseObject:
 		return getObjectOrPanic(doc)
-	case mongox.InterfaceBased:
-		return getInterfaceOrPanic(doc)
-
 	default:
-		panic(fmt.Errorf("source contains malformed document, %v", source))
+		panic(errors.Malformedf("source contains malformed document, %v", source))
 	}
 }
 
-func getObjectIDOrGenerate(source mongox.OIDBased) (id primitive.ObjectID) {
+func getObjectIDOrGenerate(source mongox.BaseObjectID) (id primitive.ObjectID) {
 
 	id = source.GetID()
 	if id != primitive.NilObjectID {
@@ -40,32 +35,22 @@ func getObjectIDOrGenerate(source mongox.OIDBased) (id primitive.ObjectID) {
 	return
 }
 
-func getStringIDOrPanic(source mongox.StringBased) (id string) {
+func getStringIDOrPanic(source mongox.BaseString) (id string) {
 
 	id = source.GetID()
 	if id != "" {
 		return id
 	}
 
-	panic(fmt.Errorf("source contains malformed document, %v", source))
+	panic(errors.Malformedf("victim contains malformed document, %v", source))
 }
 
-func getObjectOrPanic(source mongox.JSONBased) (id primitive.D) {
+func getObjectOrPanic(source mongox.BaseObject) (id primitive.D) {
 
 	id = source.GetID()
 	if id != nil {
 		return id
 	}
 
-	panic(fmt.Errorf("source contains malformed document, %v", source))
+	panic(errors.Malformedf("victim contains malformed document, %v", source))
-}
-
-func getInterfaceOrPanic(source mongox.InterfaceBased) (id interface{}) {
-
-	id = source.GetID()
-	if !utils.IsNil(id) {
-		return id
-	}
-
-	panic(fmt.Errorf("source contains malformed document, %v", source))
 }

mongox/base/getid_test.go

@@ -1,42 +0,0 @@
-package base
-
-import (
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-	"go.mongodb.org/mongo-driver/bson/primitive"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox/base/jsonbased"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/base/oidbased"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/base/stringbased"
-)
-
-type DocWithCustomInterface struct {
-	ID int `bson:"_id" json:"_id" collection:"4"`
-}
-
-func (d *DocWithCustomInterface) GetID() interface{} {
-	return d.ID
-}
-
-func (d *DocWithCustomInterface) SetID(interface{}) {
-	panic("not implemented")
-}
-
-func TestGetID(t *testing.T) {
-
-	type DocWithObjectID struct {
-		oidbased.Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-	type DocWithObject struct {
-		jsonbased.Primary `bson:",inline" json:",inline" collection:"2"`
-	}
-	type DocWithString struct {
-		stringbased.Primary `bson:",inline" json:",inline" collection:"3"`
-	}
-
-	assert.Equal(t, primitive.ObjectID([12]byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2}), GetID(&DocWithObjectID{oidbased.Primary{[12]byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2}}}))
-	assert.Equal(t, primitive.D{{"1", "2"}}, GetID(&DocWithObject{jsonbased.Primary{primitive.D{{"1", "2"}}}}))
-	assert.Equal(t, "foobar", GetID(&DocWithString{stringbased.Primary{"foobar"}}))
-	assert.Equal(t, 420, GetID(&DocWithCustomInterface{ID: 420}))
-}

mongox/base/getprotection.go

@@ -2,16 +2,14 @@ package base
 
 import (
 	"reflect"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox/base/protection"
 )
 
 // GetProtection function finds protection field in the source document otherwise returns nil
-func GetProtection(source interface{}) (key *protection.Key) {
+func GetProtection(source interface{}) *Protection {
 
 	v := reflect.ValueOf(source)
 	if v.Kind() != reflect.Ptr || v.IsNil() {
-		return
+		return nil
 	}
 
 	el := v.Elem()
@@ -19,22 +17,17 @@ func GetProtection(source interface{}) (key *protection.Key) {
 
 	for i := 0; i < numField; i++ {
 		field := el.Field(i)
-		if !field.CanInterface() {
-			continue
-		}
 
 		switch field.Interface().(type) {
-		case *protection.Key:
+		case *Protection:
-			key = field.Interface().(*protection.Key)
+			return field.Interface().(*Protection)
-		case protection.Key:
+		case Protection:
 			ptr := field.Addr()
-			key = ptr.Interface().(*protection.Key)
+			return ptr.Interface().(*Protection)
 		default:
 			continue
 		}
-
-		return
 	}
 
-	return
+	return nil
 }

mongox/base/jsonbased/id.go

@@ -1,24 +0,0 @@
-package jsonbased
-
-import (
-	"go.mongodb.org/mongo-driver/bson/primitive"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox"
-)
-
-var _ mongox.JSONBased = (*Primary)(nil)
-
-// Primary is a structure with object as an _id field
-type Primary struct {
-	ID primitive.D `bson:"_id" json:"_id"`
-}
-
-// GetID returns an _id
-func (p *Primary) GetID() (id primitive.D) {
-	return p.ID
-}
-
-// SetID sets an _id
-func (p *Primary) SetID(id primitive.D) {
-	p.ID = id
-}

mongox/base/jsonbased/id_test.go

@@ -1,80 +0,0 @@
-package jsonbased
-
-import (
-	"encoding/json"
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-	"go.mongodb.org/mongo-driver/bson/primitive"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox-testing/database"
-)
-
-func Test_GetID(t *testing.T) {
-
-	type DocWithObject struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	doc := &DocWithObject{Primary{primitive.D{{"1", "one"}, {"2", "two"}}}}
-
-	assert.Equal(t, primitive.D{{"1", "one"}, {"2", "two"}}, doc.GetID())
-}
-
-func Test_SetID(t *testing.T) {
-
-	type DocWithObject struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	doc := &DocWithObject{Primary{primitive.D{{"1", "one"}, {"2", "two"}}}}
-
-	doc.SetID(primitive.D{{"3", "three"}, {"4", "you"}})
-
-	assert.Equal(t, primitive.D{{"3", "three"}, {"4", "you"}}, doc.Primary.ID)
-	assert.Equal(t, primitive.D{{"3", "three"}, {"4", "you"}}, doc.GetID())
-}
-
-func Test_SaveLoad(t *testing.T) {
-
-	type DocWithObjectID struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	db, err := database.NewEphemeral("mongodb://localhost")
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	defer db.Close()
-
-	doc1 := &DocWithObjectID{Primary{primitive.D{{"1", "one"}, {"2", "two"}}}}
-	doc2 := &DocWithObjectID{}
-
-	err = db.SaveOne(doc1)
-	assert.NoError(t, err)
-
-	err = db.LoadOne(doc2)
-	assert.NoError(t, err)
-
-	assert.Equal(t, doc1, doc2)
-
-	bytes1, _ := json.Marshal(doc1)
-	bytes2, _ := json.Marshal(doc2)
-
-	assert.Equal(t, bytes1, bytes2)
-}
-
-func Test_Marshal(t *testing.T) {
-
-	type DocWithObjectID struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	id := primitive.D{{"1", "one"}, {"2", "two"}}
-	doc := &DocWithObjectID{Primary{id}}
-
-	bytes, err := json.Marshal(doc)
-	assert.NoError(t, err)
-	assert.Equal(t, `{"_id":[{"Key":"1","Value":"one"},{"Key":"2","Value":"two"}]}`, string(bytes))
-}

mongox/base/object.go

@@ -0,0 +1,24 @@
+package base
+
+import (
+	"go.mongodb.org/mongo-driver/bson/primitive"
+
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
+)
+
+var _ mongox.BaseObject = &Object{}
+
+// Object is a structure with object as an _id field
+type Object struct {
+	ID primitive.D `bson:"_id,omitempty" json:"_id,omitempty"`
+}
+
+// GetID returns an _id
+func (db *Object) GetID() primitive.D {
+	return db.ID
+}
+
+// SetID sets an _id
+func (db *Object) SetID(id primitive.D) {
+	db.ID = id
+}

mongox/base/objectid.go

@@ -0,0 +1,24 @@
+package base
+
+import (
+	"go.mongodb.org/mongo-driver/bson/primitive"
+
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
+)
+
+var _ mongox.BaseObjectID = &ObjectID{}
+
+// ObjectID is a structure with objectId as an _id field
+type ObjectID struct {
+	ID primitive.ObjectID `bson:"_id,omitempty" json:"_id,omitempty"`
+}
+
+// GetID returns an _id
+func (db *ObjectID) GetID() primitive.ObjectID {
+	return db.ID
+}
+
+// SetID sets an _id
+func (db *ObjectID) SetID(id primitive.ObjectID) {
+	db.ID = id
+}

mongox/base/oidbased/id.go

@@ -1,24 +0,0 @@
-package oidbased
-
-import (
-	"go.mongodb.org/mongo-driver/bson/primitive"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox"
-)
-
-var _ mongox.OIDBased = (*Primary)(nil)
-
-// Primary is a structure with objectId as the primary key
-type Primary struct {
-	ID primitive.ObjectID `bson:"_id" json:"_id"`
-}
-
-// GetID returns an _id
-func (p *Primary) GetID() (id primitive.ObjectID) {
-	return p.ID
-}
-
-// SetID sets an _id
-func (p *Primary) SetID(id primitive.ObjectID) {
-	p.ID = id
-}

mongox/base/oidbased/id_test.go

@@ -1,80 +0,0 @@
-package oidbased
-
-import (
-	"encoding/json"
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-	"go.mongodb.org/mongo-driver/bson/primitive"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox-testing/database"
-)
-
-func Test_GetID(t *testing.T) {
-
-	type DocWithObjectID struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	doc := &DocWithObjectID{Primary{[12]byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2}}}
-
-	assert.Equal(t, primitive.ObjectID([12]byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2}), doc.GetID())
-}
-
-func Test_SetID(t *testing.T) {
-
-	type DocWithObjectID struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	doc := &DocWithObjectID{}
-
-	doc.SetID([12]byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2})
-
-	assert.Equal(t, primitive.ObjectID([12]byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2}), doc.Primary.ID)
-	assert.Equal(t, primitive.ObjectID([12]byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2}), doc.GetID())
-}
-
-func Test_SaveLoad(t *testing.T) {
-
-	type DocWithObjectID struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	db, err := database.NewEphemeral("mongodb://localhost")
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	defer db.Close()
-
-	doc1 := &DocWithObjectID{}
-	doc2 := &DocWithObjectID{}
-
-	err = db.SaveOne(doc1)
-	assert.NoError(t, err)
-
-	err = db.LoadOne(doc2)
-	assert.NoError(t, err)
-
-	assert.Equal(t, doc1, doc2)
-
-	bytes1, _ := json.Marshal(doc1)
-	bytes2, _ := json.Marshal(doc2)
-
-	assert.Equal(t, bytes1, bytes2)
-}
-
-func Test_Marshal(t *testing.T) {
-
-	type DocWithObjectID struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	id, _ := primitive.ObjectIDFromHex("feadbeeffeadbeeffeadbeef")
-	doc := &DocWithObjectID{Primary{id}}
-
-	bytes, err := json.Marshal(doc)
-	assert.NoError(t, err)
-	assert.Equal(t, `{"_id":"feadbeeffeadbeeffeadbeef"}`, string(bytes))
-}

mongox/base/protection.go

@@ -1,11 +1,11 @@
-package protection
+package base
 
 import (
 	"go.mongodb.org/mongo-driver/bson/primitive"
 )
 
-// Key field stores unique document id and version
+// Protection field stores unique document id and version
-type Key struct {
+type Protection struct {
 	X primitive.ObjectID `bson:"_x" json:"_x" index:",hashed"`
 	V int64              `bson:"_v" json:"_v"`
 }

mongox/base/reset.go

@@ -1,18 +1,15 @@
 package base
 
 import (
-	"fmt"
 	"reflect"
+
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
 )
 
 // Reset function creates new zero object for the target pointer
 func Reset(target interface{}) {
 
-	type resetter interface {
+	resettable, canReset := target.(mongox.Resetter)
-		Reset()
-	}
-
-	resettable, canReset := target.(resetter)
 	if canReset {
 		resettable.Reset()
 		return
@@ -20,7 +17,7 @@ func Reset(target interface{}) {
 
 	v := reflect.ValueOf(target)
 	if v.Kind() != reflect.Ptr {
-		panic(fmt.Errorf("reset target should be a pointer"))
+		panic("reset target should be a pointer")
 	}
 
 	t := v.Elem().Type()

mongox/base/string.go

@@ -0,0 +1,22 @@
+package base
+
+import (
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
+)
+
+var _ mongox.BaseString = &String{}
+
+// String is a structure with string as an _id field
+type String struct {
+	ID string `bson:"_id,omitempty" json:"_id,omitempty"`
+}
+
+// GetID returns an _id
+func (db *String) GetID() string {
+	return db.ID
+}
+
+// SetID sets an _id
+func (db *String) SetID(id string) {
+	db.ID = id
+}

mongox/base/stringbased/id.go

@@ -1,22 +0,0 @@
-package stringbased
-
-import (
-	"github.com/mainnika/mongox-go-driver/v2/mongox"
-)
-
-var _ mongox.StringBased = (*Primary)(nil)
-
-// Primary is a structure with string as an _id field
-type Primary struct {
-	ID string `bson:"_id" json:"_id"`
-}
-
-// GetID returns an _id
-func (p *Primary) GetID() (id string) {
-	return p.ID
-}
-
-// SetID sets an _id
-func (p *Primary) SetID(id string) {
-	p.ID = id
-}

mongox/base/stringbased/id_test.go

@@ -1,78 +0,0 @@
-package stringbased
-
-import (
-	"encoding/json"
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox-testing/database"
-)
-
-func Test_GetID(t *testing.T) {
-
-	type DocWithString struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	doc := &DocWithString{Primary{"foobar"}}
-
-	assert.Equal(t, "foobar", doc.GetID())
-}
-
-func Test_SetID(t *testing.T) {
-
-	type DocWithString struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	doc := &DocWithString{Primary{"foobar"}}
-
-	doc.SetID("rockrockrock")
-
-	assert.Equal(t, "rockrockrock", doc.Primary.ID)
-	assert.Equal(t, "rockrockrock", doc.GetID())
-}
-
-func Test_SaveLoad(t *testing.T) {
-
-	type DocWithObjectID struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	db, err := database.NewEphemeral("mongodb://localhost")
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	defer db.Close()
-
-	doc1 := &DocWithObjectID{Primary{"foobar"}}
-	doc2 := &DocWithObjectID{}
-
-	err = db.SaveOne(doc1)
-	assert.NoError(t, err)
-
-	err = db.LoadOne(doc2)
-	assert.NoError(t, err)
-
-	assert.Equal(t, doc1, doc2)
-
-	bytes1, _ := json.Marshal(doc1)
-	bytes2, _ := json.Marshal(doc2)
-
-	assert.Equal(t, bytes1, bytes2)
-}
-
-func Test_Marshal(t *testing.T) {
-
-	type DocWithObjectID struct {
-		Primary `bson:",inline" json:",inline" collection:"1"`
-	}
-
-	doc := &DocWithObjectID{Primary{"foobar"}}
-
-	bytes, err := json.Marshal(doc)
-	assert.NoError(t, err)
-	assert.Equal(t, `{"_id":"foobar"}`, string(bytes))
-}

mongox/common/common.go

@@ -0,0 +1,162 @@
+package common
+
+import (
+	"reflect"
+	"strconv"
+	"strings"
+
+	"go.mongodb.org/mongo-driver/bson/primitive"
+	"go.mongodb.org/mongo-driver/mongo"
+	"go.mongodb.org/mongo-driver/mongo/options"
+
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
+)
+
+func createSimpleLoad(db mongox.Database, target interface{}, composed *query.Query) (cursor *mongo.Cursor, err error) {
+
+	collection := db.GetCollectionOf(target)
+	opts := options.Find()
+
+	opts.Sort = composed.Sorter()
+	opts.Limit = composed.Limiter()
+	opts.Skip = composed.Skipper()
+
+	return collection.Find(db.Context(), composed.M(), opts)
+}
+
+func createAggregateLoad(db mongox.Database, target interface{}, composed *query.Query) (cursor *mongo.Cursor, err error) {
+
+	collection := db.GetCollectionOf(target)
+	opts := options.Aggregate()
+
+	pipeline := primitive.A{}
+
+	if !composed.Empty() {
+		pipeline = append(pipeline, primitive.M{"$match": primitive.M{"$expr": composed.M()}})
+	}
+	if composed.Sorter() != nil {
+		pipeline = append(pipeline, primitive.M{"$sort": composed.Sorter()})
+	}
+	if composed.Skipper() != nil {
+		pipeline = append(pipeline, primitive.M{"$skip": *composed.Skipper()})
+	}
+	if composed.Limiter() != nil {
+		pipeline = append(pipeline, primitive.M{"$limit": *composed.Limiter()})
+	}
+
+	el := reflect.ValueOf(target).Elem()
+	elType := el.Type()
+	numField := elType.NumField()
+	_, preloads := composed.Preloader()
+
+	for i := 0; i < numField; i++ {
+
+		field := elType.Field(i)
+		tag := field.Tag
+
+		preloadTag, ok := tag.Lookup("preload")
+		if !ok {
+			continue
+		}
+		jsonTag, ok := tag.Lookup("json")
+		if jsonTag == "-" {
+			return nil, errors.Malformedf("preload private field is impossible")
+		}
+
+		jsonData := strings.SplitN(jsonTag, ",", 2)
+		jsonName := field.Name
+		if len(jsonData) > 0 {
+			jsonName = strings.TrimSpace(jsonData[0])
+		}
+
+		preloadData := strings.Split(preloadTag, ",")
+		if len(preloadData) == 0 {
+			continue
+		}
+		if len(preloadData) == 1 {
+			panic("there is no foreign field")
+		}
+
+		localField := strings.TrimSpace(preloadData[0])
+		if len(localField) == 0 {
+			localField = "_id"
+		}
+
+		foreignField := strings.TrimSpace(preloadData[1])
+		if len(foreignField) == 0 {
+			panic("there is no foreign field")
+		}
+
+		preloadLimiter := 100
+		preloadReversed := false
+		if len(preloadData) > 2 {
+			stringLimit := strings.TrimSpace(preloadData[2])
+			intLimit := preloadLimiter
+
+			preloadReversed = strings.HasPrefix(stringLimit, "-")
+			if preloadReversed {
+				stringLimit = stringLimit[1:]
+			}
+
+			intLimit, err = strconv.Atoi(stringLimit)
+			if err == nil {
+				preloadLimiter = intLimit
+			}
+		}
+
+		for _, preload := range preloads {
+			if preload != jsonName {
+				continue
+			}
+
+			isSlice := el.Field(i).Kind() == reflect.Slice
+
+			typ := el.Field(i).Type()
+			if typ.Kind() == reflect.Slice {
+				typ = typ.Elem()
+			}
+			if typ.Kind() != reflect.Ptr {
+				panic("preload field should have ptr type")
+			}
+
+			lookupCollection := db.GetCollectionOf(reflect.Zero(typ).Interface())
+			lookupVars := primitive.M{"selector": "$" + localField}
+			lookupPipeline := primitive.A{
+				primitive.M{"$match": primitive.M{"$expr": primitive.M{"$eq": primitive.A{"$" + foreignField, "$$selector"}}}},
+			}
+
+			if preloadReversed {
+				lookupPipeline = append(lookupPipeline, primitive.M{"$sort": primitive.M{"_id": -1}})
+			}
+			if isSlice && preloadLimiter > 0 {
+				lookupPipeline = append(lookupPipeline, primitive.M{"$limit": preloadLimiter})
+			} else if !isSlice {
+				lookupPipeline = append(lookupPipeline, primitive.M{"$limit": 1})
+			}
+
+			pipeline = append(pipeline, primitive.M{
+				"$lookup": primitive.M{
+					"from":     lookupCollection.Name(),
+					"let":      lookupVars,
+					"pipeline": lookupPipeline,
+					"as":       jsonName,
+				},
+			})
+
+			if isSlice {
+				continue
+			}
+
+			pipeline = append(pipeline, primitive.M{
+				"$unwind": primitive.M{
+					"preserveNullAndEmptyArrays": true,
+					"path":                       "$" + jsonName,
+				},
+			})
+		}
+	}
+
+	return collection.Aggregate(db.Context(), pipeline, opts)
+}

mongox/common/count.go

@@ -0,0 +1,32 @@
+package common
+
+import (
+	"go.mongodb.org/mongo-driver/mongo"
+	"go.mongodb.org/mongo-driver/mongo/options"
+
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
+)
+
+// Count function counts documents in the database by query
+// target is used only to get collection by tag so it'd be better to use nil ptr here
+func Count(db mongox.Database, target interface{}, filters ...interface{}) (int64, error) {
+
+	collection := db.GetCollectionOf(target)
+	opts := options.Count()
+	composed := query.Compose(filters...)
+
+	opts.Limit = composed.Limiter()
+	opts.Skip = composed.Skipper()
+
+	result, err := collection.CountDocuments(db.Context(), composed.M(), opts)
+	if err == mongo.ErrNoDocuments {
+		return 0, errors.NotFoundErrorf("%s", err)
+	}
+	if err != nil {
+		return 0, errors.InternalErrorf("can't decode desult: %s", err)
+	}
+
+	return result, nil
+}

mongox/common/deletearray.go

@@ -1,40 +1,41 @@
-package database
+package common
 
 import (
-	"fmt"
 	"reflect"
 
 	"go.mongodb.org/mongo-driver/bson/primitive"
 	"go.mongodb.org/mongo-driver/mongo/options"
 
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
 	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
 )
 
 // DeleteArray removes documents list from a database by their ids
-func (d *Database) DeleteArray(target interface{}) (err error) {
+func DeleteArray(db mongox.Database, target interface{}) error {
 
 	targetV := reflect.ValueOf(target)
 	targetT := targetV.Type()
 
 	targetK := targetV.Kind()
 	if targetK != reflect.Ptr {
-		panic(fmt.Errorf("target is not a ptr"))
+		panic(errors.Malformedf("target is not a ptr"))
 	}
 
 	targetSliceV := targetV.Elem()
 	targetSliceT := targetT.Elem()
 	if targetSliceT.Kind() != reflect.Slice {
-		panic(fmt.Errorf("target should be a ptr to a slice"))
+		panic(errors.Malformedf("target should be a ptr to a slice"))
 	}
 
 	targetSliceElemT := targetSliceT.Elem()
 	if targetSliceElemT.Kind() != reflect.Ptr {
-		panic(fmt.Errorf("target slice should contain ptrs"))
+		panic(errors.Malformedf("target slice should contain ptrs"))
 	}
 
 	zeroElem := reflect.Zero(targetSliceElemT)
 	targetLen := targetSliceV.Len()
-	collection := d.GetCollectionOf(zeroElem.Interface())
+	collection := db.GetCollectionOf(zeroElem.Interface())
 	opts := options.Delete()
 	ids := primitive.A{}
 
@@ -44,16 +45,16 @@ func (d *Database) DeleteArray(target interface{}) (err error) {
 	}
 
 	if len(ids) == 0 {
-		return fmt.Errorf("can't delete zero elements")
+		return errors.Malformedf("can't delete zero elements")
 	}
 
-	result, err := collection.DeleteMany(d.Context(), primitive.M{"_id": primitive.M{"$in": ids}}, opts)
+	result, err := collection.DeleteMany(db.Context(), primitive.M{"_id": primitive.M{"$in": ids}}, opts)
 	if err != nil {
-		return
+		return errors.NotFoundErrorf("can't create find and delete result: %s", err)
 	}
 	if result.DeletedCount != int64(targetLen) {
-		err = fmt.Errorf("can't verify delete result: removed count mismatch %d != %d", result.DeletedCount, targetLen)
+		return errors.InternalErrorf("can't verify delete result: removed count mismatch %d != %d", result.DeletedCount, targetLen)
 	}
 
-	return
+	return nil
 }

mongox/common/deleteone.go

@@ -1,28 +1,29 @@
-package database
+package common
 
 import (
-	"fmt"
 	"time"
 
 	"go.mongodb.org/mongo-driver/bson/primitive"
+	"go.mongodb.org/mongo-driver/mongo"
 	"go.mongodb.org/mongo-driver/mongo/options"
 
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
 	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
 	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/utils"
 )
 
 // DeleteOne removes a document from a database and then returns it into target
-func (d *Database) DeleteOne(target interface{}, filters ...interface{}) (err error) {
+func DeleteOne(db mongox.Database, target interface{}, filters ...interface{}) error {
 
-	collection := d.GetCollectionOf(target)
+	collection := db.GetCollectionOf(target)
 	opts := &options.FindOneAndDeleteOptions{}
 	composed := query.Compose(filters...)
 	protected := base.GetProtection(target)
 
 	opts.Sort = composed.Sorter()
 
-	if !utils.IsNil(target) {
+	if target != nil {
 		composed.And(primitive.M{"_id": base.GetID(target)})
 	}
 
@@ -32,12 +33,18 @@ func (d *Database) DeleteOne(target interface{}, filters ...interface{}) (err er
 		protected.V = time.Now().Unix()
 	}
 
-	result := collection.FindOneAndDelete(d.Context(), composed.M(), opts)
+	result := collection.FindOneAndDelete(db.Context(), composed.M(), opts)
 	if result.Err() != nil {
-		return fmt.Errorf("can't create find one and delete result: %w", result.Err())
+		return errors.InternalErrorf("can't create find one and delete result: %s", result.Err())
 	}
 
-	err = result.Decode(target)
+	err := result.Decode(target)
-
+	if err == mongo.ErrNoDocuments {
-	return
+		return errors.NotFoundErrorf("%s", err)
+	}
+	if err != nil {
+		return errors.InternalErrorf("can't decode result: %s", err)
+	}
+
+	return nil
 }

mongox/common/loadarray.go

@@ -0,0 +1,78 @@
+package common
+
+import (
+	"reflect"
+
+	"go.mongodb.org/mongo-driver/mongo"
+
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
+)
+
+// LoadArray loads an array of documents from the database by query
+func LoadArray(db mongox.Database, target interface{}, filters ...interface{}) error {
+
+	targetV := reflect.ValueOf(target)
+	targetT := targetV.Type()
+
+	targetK := targetV.Kind()
+	if targetK != reflect.Ptr {
+		panic(errors.InternalErrorf("target is not a ptr"))
+	}
+
+	targetSliceV := targetV.Elem()
+	targetSliceT := targetT.Elem()
+	if targetSliceT.Kind() != reflect.Slice {
+		panic(errors.InternalErrorf("target should be a ptr to a slice"))
+	}
+
+	targetSliceElemT := targetSliceT.Elem()
+	if targetSliceElemT.Kind() != reflect.Ptr {
+		panic(errors.InternalErrorf("target slice should contain ptrs"))
+	}
+
+	composed := query.Compose(filters...)
+	zeroElem := reflect.Zero(targetSliceElemT)
+	hasPreloader, _ := composed.Preloader()
+
+	var result *mongo.Cursor
+	var err error
+
+	if hasPreloader {
+		result, err = createAggregateLoad(db, zeroElem.Interface(), composed)
+	} else {
+		result, err = createSimpleLoad(db, zeroElem.Interface(), composed)
+	}
+	if err != nil {
+		return errors.InternalErrorf("can't create find result: %s", err)
+	}
+
+	defer result.Close(db.Context())
+	var i int
+
+	for i = 0; result.Next(db.Context()); {
+		if targetSliceV.Len() == i {
+			elem := reflect.New(targetSliceElemT.Elem())
+			if err = result.Decode(elem.Interface()); err == nil {
+				targetSliceV = reflect.Append(targetSliceV, elem)
+			} else {
+				continue
+			}
+		} else {
+			elem := targetSliceV.Index(i).Interface()
+			base.Reset(elem)
+			if err = result.Decode(elem); err != nil {
+				continue
+			}
+		}
+
+		i++
+	}
+
+	targetSliceV = targetSliceV.Slice(0, i)
+	targetV.Elem().Set(targetSliceV)
+
+	return nil
+}

mongox/common/loadone.go

@@ -0,0 +1,38 @@
+package common
+
+import (
+	"go.mongodb.org/mongo-driver/mongo"
+
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
+)
+
+// LoadOne function loads a first single target document by a query
+func LoadOne(db mongox.Database, target interface{}, filters ...interface{}) error {
+
+	composed := query.Compose(append(filters, query.Limit(1))...)
+	hasPreloader, _ := composed.Preloader()
+
+	var result *mongo.Cursor
+	var err error
+
+	if hasPreloader {
+		result, err = createAggregateLoad(db, target, composed)
+	} else {
+		result, err = createSimpleLoad(db, target, composed)
+	}
+	if err != nil {
+		return errors.InternalErrorf("can't create find result: %s", err)
+	}
+
+	hasNext := result.Next(db.Context())
+	if !hasNext {
+		return errors.NotFoundErrorf("can't find result: %s", result.Err())
+	}
+
+	base.Reset(target)
+
+	return result.Decode(target)
+}

mongox/common/loadstream.go

@@ -0,0 +1,78 @@
+package common
+
+import (
+	"context"
+
+	"go.mongodb.org/mongo-driver/mongo"
+
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
+)
+
+// StreamLoader is a controller for a database cursor
+type StreamLoader struct {
+	*mongo.Cursor
+	ctx    context.Context
+	target interface{}
+}
+
+// DecodeNext loads next documents to a target or returns an error
+func (l *StreamLoader) DecodeNext() error {
+
+	hasNext := l.Cursor.Next(l.ctx)
+
+	if !hasNext {
+		return errors.NotFoundErrorf("%s", mongo.ErrNoDocuments)
+	}
+
+	base.Reset(l.target)
+
+	err := l.Decode(l.target)
+	if err != nil {
+		return errors.InternalErrorf("can't decode desult: %s", err)
+	}
+
+	return nil
+}
+
+// Next loads next documents but doesn't perform decoding
+func (l *StreamLoader) Next() error {
+
+	hasNext := l.Cursor.Next(l.ctx)
+	if !hasNext {
+		return errors.NotFoundErrorf("%s", mongo.ErrNoDocuments)
+	}
+
+	return nil
+}
+
+// Close cursor
+func (l *StreamLoader) Close() error {
+
+	return l.Cursor.Close(l.ctx)
+}
+
+// LoadStream function loads documents one by one into a target channel
+func LoadStream(db mongox.Database, target interface{}, filters ...interface{}) (*StreamLoader, error) {
+
+	var cursor *mongo.Cursor
+	var err error
+
+	composed := query.Compose(filters...)
+	hasPreloader, _ := composed.Preloader()
+
+	if hasPreloader {
+		cursor, err = createAggregateLoad(db, target, composed)
+	} else {
+		cursor, err = createSimpleLoad(db, target, composed)
+	}
+	if err != nil {
+		return nil, errors.InternalErrorf("can't create find result: %s", err)
+	}
+
+	l := &StreamLoader{Cursor: cursor, ctx: db.Context(), target: target}
+
+	return l, nil
+}

mongox/common/saveone.go

@@ -1,4 +1,4 @@
-package database
+package common
 
 import (
 	"time"
@@ -7,14 +7,16 @@ import (
 	"go.mongodb.org/mongo-driver/bson/primitive"
 	"go.mongodb.org/mongo-driver/mongo/options"
 
+	"github.com/mainnika/mongox-go-driver/v2/mongox"
 	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
 	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
 )
 
 // SaveOne saves a single source document to the database
-func (d *Database) SaveOne(source interface{}) (err error) {
+func SaveOne(db mongox.Database, source interface{}) error {
 
-	collection := d.GetCollectionOf(source)
+	collection := db.GetCollectionOf(source)
 	opts := options.FindOneAndReplace()
 	id := base.GetID(source)
 	protected := base.GetProtection(source)
@@ -29,9 +31,9 @@ func (d *Database) SaveOne(source interface{}) (err error) {
 		protected.V = time.Now().Unix()
 	}
 
-	result := collection.FindOneAndReplace(d.Context(), composed.M(), source, opts)
+	result := collection.FindOneAndReplace(db.Context(), composed.M(), source, opts)
 	if result.Err() != nil {
-		return result.Err()
+		return errors.NotFoundErrorf("%s", result.Err())
 	}
 
 	return result.Decode(source)

mongox/database/callbacks.go

@@ -1,19 +0,0 @@
-package database
-
-import (
-	"context"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
-)
-
-func onDecode(ctx context.Context, iter interface{}, callbacks ...query.OnDecode) (err error) {
-
-	for _, cb := range callbacks {
-		err = cb(ctx, iter)
-		if err != nil {
-			return
-		}
-	}
-
-	return
-}

mongox/database/count.go

@@ -1,23 +0,0 @@
-package database
-
-import (
-	"go.mongodb.org/mongo-driver/mongo/options"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
-)
-
-// Count function counts documents in the database by query
-// target is used only to get collection by tag so it'd be better to use nil ptr here
-func (d *Database) Count(target interface{}, filters ...interface{}) (result int64, err error) {
-
-	collection := d.GetCollectionOf(target)
-	opts := options.Count()
-	composed := query.Compose(filters...)
-
-	opts.Limit = composed.Limiter()
-	opts.Skip = composed.Skipper()
-
-	result, err = collection.CountDocuments(d.Context(), composed.M(), opts)
-
-	return
-}

mongox/database/database.go

@@ -2,71 +2,58 @@ package database
 
 import (
 	"context"
-	"fmt"
 	"reflect"
-	"strconv"
-	"strings"
 
-	"go.mongodb.org/mongo-driver/bson/primitive"
+	"go.mongodb.org/mongo-driver/mongo"
-	"go.mongodb.org/mongo-driver/mongo/options"
 
 	"github.com/mainnika/mongox-go-driver/v2/mongox"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
 )
 
 // Database handler
 type Database struct {
-	client *mongox.Client
+	client *mongo.Client
 	dbname string
 	ctx    context.Context
 }
 
 // NewDatabase function creates new database instance with mongo client and empty context
-func NewDatabase(client *mongox.Client, dbname string) (db mongox.Database) {
+func NewDatabase(client *mongo.Client, dbname string) mongox.Database {
 
-	db = &Database{
+	db := &Database{}
-		client: client,
+	db.client = client
-		dbname: dbname,
+	db.dbname = dbname
-	}
 
-	return
+	return db
 }
 
 // Client function returns a mongo client
-func (d *Database) Client() (client *mongox.Client) {
+func (d *Database) Client() mongox.MongoClient {
 	return d.client
 }
 
 // Context function returns a context
-func (d *Database) Context() (ctx context.Context) {
+func (d *Database) Context() context.Context {
-
+	return d.ctx
-	ctx = d.ctx
-	if ctx == nil {
-		ctx = context.Background()
-	}
-
-	return
 }
 
 // Name function returns a database name
-func (d *Database) Name() (name string) {
+func (d *Database) Name() string {
 	return d.dbname
 }
 
 // New function creates new database context with same client
-func (d *Database) New(ctx context.Context) (db mongox.Database) {
+func (d *Database) New(ctx context.Context) mongox.Database {
 
-	if ctx == nil {
+	if ctx != nil {
 		ctx = context.Background()
 	}
 
-	db = &Database{
+	return &Database{
 		client: d.client,
 		dbname: d.dbname,
 		ctx:    ctx,
 	}
-
-	return
 }
 
 // GetCollectionOf returns the collection object by the «collection» tag of the given document;
@@ -75,7 +62,7 @@ func (d *Database) New(ctx context.Context) (db mongox.Database) {
 //     base.ObjectID `bson:",inline" json:",inline" collection:"foobars"`
 // 	   ...
 // Will panic if there is no «collection» tag
-func (d *Database) GetCollectionOf(document interface{}) (collection *mongox.Collection) {
+func (d *Database) GetCollectionOf(document interface{}) mongox.MongoCollection {
 
 	el := reflect.TypeOf(document).Elem()
 	numField := el.NumField()
@@ -91,152 +78,5 @@ func (d *Database) GetCollectionOf(document interface{}) (collection *mongox.Col
 		return d.client.Database(d.dbname).Collection(found)
 	}
 
-	panic(fmt.Errorf("document %v does not have a collection tag", document))
+	panic(errors.InternalErrorf("document %v does not have a collection tag", document))
-}
-
-func (d *Database) createSimpleLoad(target interface{}, composed *query.Query) (cursor *mongox.Cursor, err error) {
-
-	collection := d.GetCollectionOf(target)
-	opts := options.Find()
-
-	opts.Sort = composed.Sorter()
-	opts.Limit = composed.Limiter()
-	opts.Skip = composed.Skipper()
-
-	return collection.Find(d.Context(), composed.M(), opts)
-}
-
-func (d *Database) createAggregateLoad(target interface{}, composed *query.Query) (cursor *mongox.Cursor, err error) {
-
-	collection := d.GetCollectionOf(target)
-	opts := options.Aggregate()
-
-	pipeline := primitive.A{}
-
-	if !composed.Empty() {
-		pipeline = append(pipeline, primitive.M{"$match": composed.M()})
-	}
-	if composed.Sorter() != nil {
-		pipeline = append(pipeline, primitive.M{"$sort": composed.Sorter()})
-	}
-	if composed.Skipper() != nil {
-		pipeline = append(pipeline, primitive.M{"$skip": *composed.Skipper()})
-	}
-	if composed.Limiter() != nil {
-		pipeline = append(pipeline, primitive.M{"$limit": *composed.Limiter()})
-	}
-
-	el := reflect.ValueOf(target).Elem()
-	elType := el.Type()
-	numField := elType.NumField()
-	_, preloads := composed.Preloader()
-
-	for i := 0; i < numField; i++ {
-
-		field := elType.Field(i)
-		tag := field.Tag
-
-		preloadTag, ok := tag.Lookup("preload")
-		if !ok {
-			continue
-		}
-		jsonTag, _ := tag.Lookup("json")
-		if jsonTag == "-" {
-			panic(fmt.Errorf("preload private field is impossible"))
-		}
-
-		jsonData := strings.SplitN(jsonTag, ",", 2)
-		jsonName := field.Name
-		if len(jsonData) > 0 {
-			jsonName = strings.TrimSpace(jsonData[0])
-		}
-
-		preloadData := strings.Split(preloadTag, ",")
-		if len(preloadData) == 0 {
-			continue
-		}
-		if len(preloadData) == 1 {
-			panic(fmt.Errorf("there is no foreign field"))
-		}
-
-		localField := strings.TrimSpace(preloadData[0])
-		if len(localField) == 0 {
-			localField = "_id"
-		}
-
-		foreignField := strings.TrimSpace(preloadData[1])
-		if len(foreignField) == 0 {
-			panic(fmt.Errorf("there is no foreign field"))
-		}
-
-		preloadLimiter := 100
-		preloadReversed := false
-		if len(preloadData) > 2 {
-			stringLimit := strings.TrimSpace(preloadData[2])
-			intLimit := preloadLimiter
-
-			preloadReversed = strings.HasPrefix(stringLimit, "-")
-			if preloadReversed {
-				stringLimit = stringLimit[1:]
-			}
-
-			intLimit, err = strconv.Atoi(stringLimit)
-			if err == nil {
-				preloadLimiter = intLimit
-			}
-		}
-
-		for _, preload := range preloads {
-			if preload != jsonName {
-				continue
-			}
-
-			isSlice := el.Field(i).Kind() == reflect.Slice
-
-			typ := el.Field(i).Type()
-			if typ.Kind() == reflect.Slice {
-				typ = typ.Elem()
-			}
-			if typ.Kind() != reflect.Ptr {
-				panic(fmt.Errorf("preload field should have ptr type"))
-			}
-
-			lookupCollection := d.GetCollectionOf(reflect.Zero(typ).Interface())
-			lookupVars := primitive.M{"selector": "$" + localField}
-			lookupPipeline := primitive.A{
-				primitive.M{"$match": primitive.M{"$expr": primitive.M{"$eq": primitive.A{"$" + foreignField, "$$selector"}}}},
-			}
-
-			if preloadReversed {
-				lookupPipeline = append(lookupPipeline, primitive.M{"$sort": primitive.M{"_id": -1}})
-			}
-			if isSlice && preloadLimiter > 0 {
-				lookupPipeline = append(lookupPipeline, primitive.M{"$limit": preloadLimiter})
-			} else if !isSlice {
-				lookupPipeline = append(lookupPipeline, primitive.M{"$limit": 1})
-			}
-
-			pipeline = append(pipeline, primitive.M{
-				"$lookup": primitive.M{
-					"from":     lookupCollection.Name(),
-					"let":      lookupVars,
-					"pipeline": lookupPipeline,
-					"as":       jsonName,
-				},
-			})
-
-			if isSlice {
-				continue
-			}
-
-			pipeline = append(pipeline, primitive.M{
-				"$unwind": primitive.M{
-					"preserveNullAndEmptyArrays": true,
-					"path":                       "$" + jsonName,
-				},
-			})
-		}
-	}
-
-	return collection.Aggregate(d.Context(), pipeline, opts)
 }

mongox/database/index.go

@@ -1,136 +0,0 @@
-package database
-
-import (
-	"bytes"
-	"fmt"
-	"reflect"
-	"strconv"
-	"strings"
-	"text/template"
-
-	"go.mongodb.org/mongo-driver/bson/primitive"
-	"go.mongodb.org/mongo-driver/mongo"
-	"go.mongodb.org/mongo-driver/mongo/options"
-)
-
-// IndexEnsure function ensures index in mongo collection of document
-//   `index:""` -- https://docs.mongodb.com/manual/indexes/#create-an-index
-//   `index:"-"` -- (descending)
-//   `index:"-,+foo,+-bar"` -- https://docs.mongodb.com/manual/core/index-compound
-//   `index:"-,+foo,+-bar,unique"` -- https://docs.mongodb.com/manual/core/index-unique
-//   `index:"-,+foo,+-bar,unique,allowNull"` -- https://docs.mongodb.com/manual/core/index-partial
-//   `index:"-,unique,allowNull,expireAfter=86400"` -- https://docs.mongodb.com/manual/core/index-ttl
-//   `index:"-,unique,allowNull,expireAfter={{.Expire}}"` -- evaluate index as a golang template with `cfg` arguments
-func (d *Database) IndexEnsure(cfg interface{}, document interface{}) (err error) {
-
-	el := reflect.ValueOf(document).Elem().Type()
-	numField := el.NumField()
-	documents := d.GetCollectionOf(document)
-
-	for i := 0; i < numField; i++ {
-
-		field := el.Field(i)
-		tag := field.Tag
-
-		indexTag, ok := tag.Lookup("index")
-		if !ok {
-			continue
-		}
-		bsonTag, ok := tag.Lookup("bson")
-		if !ok {
-			return fmt.Errorf("bson tag is not defined for field:%v document:%v", field, document)
-		}
-
-		var tmpBuffer = &bytes.Buffer{}
-		var tpl *template.Template
-
-		tpl, err = template.New("").Parse(indexTag)
-		if err != nil {
-			panic(fmt.Errorf("invalid prop template %v, err:%w", indexTag, err))
-		}
-		err = tpl.Execute(tmpBuffer, cfg)
-		if err != nil {
-			panic(fmt.Errorf("failed to evaluate prop template %v, err:%w", indexTag, err))
-		}
-
-		indexString := tmpBuffer.String()
-		indexValues := strings.Split(indexString, ",")
-		bsonValues := strings.Split(bsonTag, ",")
-
-		var f = false
-		var t = true
-		var key = bsonValues[0]
-		var name = fmt.Sprintf("%s_%s_", indexString, key)
-
-		if len(key) == 0 {
-			panic(fmt.Errorf("cannot evaluate index key"))
-		}
-
-		opts := &options.IndexOptions{
-			Background: &f,
-			Unique:     &f,
-			Name:       &name,
-		}
-
-		index := primitive.D{{Key: key, Value: 1}}
-		if indexValues[0] == "-" {
-			index = primitive.D{{Key: key, Value: -1}}
-		}
-
-		for _, prop := range indexValues[1:] {
-			var left string
-			var right string
-
-			pair := strings.SplitN(prop, "=", 2)
-			left = pair[0]
-			if len(pair) > 1 {
-				right = pair[1]
-			}
-
-			switch {
-			case left == "unique":
-				opts.Unique = &t
-
-			case left == "allowNull":
-				expression, isMap := opts.PartialFilterExpression.(primitive.M)
-				if !isMap || expression == nil {
-					expression = primitive.M{}
-				}
-
-				expression[key] = primitive.M{"$exists": true}
-				opts.PartialFilterExpression = expression
-
-			case left == "expireAfter":
-				expireAfter, err := strconv.Atoi(right)
-				if err != nil || expireAfter < 1 {
-					panic(fmt.Errorf("invalid expireAfter value, err: %w", err))
-				}
-
-				expireAfterInt32 := int32(expireAfter)
-				opts.ExpireAfterSeconds = &expireAfterInt32
-
-			case len(left) > 0 && left[0] == '+':
-				compoundValue := left[1:]
-				if len(compoundValue) == 0 {
-					panic(fmt.Errorf("invalid compound value"))
-				}
-
-				if compoundValue[0] == '-' {
-					index = append(index, primitive.E{compoundValue[1:], -1})
-				} else {
-					index = append(index, primitive.E{compoundValue, 1})
-				}
-
-			default:
-				panic(fmt.Errorf("unsupported flag:%q in tag:%q of type:%s", prop, tag, el))
-			}
-		}
-
-		_, err = documents.Indexes().CreateOne(d.Context(), mongo.IndexModel{Keys: index, Options: opts})
-		if err != nil {
-			return
-		}
-	}
-
-	return
-}

mongox/database/index_test.go

@@ -1,156 +0,0 @@
-package database_test
-
-import (
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox-testing/database"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/base/oidbased"
-)
-
-func TestDatabase_Ensure(t *testing.T) {
-
-	db, err := database.NewEphemeral("mongodb://localhost")
-	if err != nil {
-		t.Fatal(err)
-	}
-	defer db.Close()
-
-	testvalues := []struct {
-		doc      interface{}
-		settings map[string]interface{}
-		index    map[string]interface{}
-	}{
-		{
-			doc: &struct {
-				oidbased.Primary `bson:",inline" json:",inline" collection:"1"`
-
-				Foobar int `bson:"foobar" json:"foobar" index:"-,unique,allowNull,expireAfter=86400"`
-				Foo    int `bson:"foo" json:"foo"`
-				Bar    int `bson:"bar" json:"bar"`
-			}{},
-			index: map[string]interface{}{
-				"background":         false,
-				"expireAfterSeconds": int32(86400),
-				"key": map[string]interface{}{
-					"foobar": int32(-1),
-				},
-				"name": "-,unique,allowNull,expireAfter=86400_foobar_",
-				"partialFilterExpression": map[string]interface{}{
-					"foobar": map[string]interface{}{"$exists": true},
-				},
-				"unique": true,
-			},
-		},
-		{
-			doc: &struct {
-				oidbased.Primary `bson:",inline" json:",inline" collection:"2"`
-
-				Foobar int `bson:"foobar" json:"foobar" index:",unique"`
-			}{},
-			index: map[string]interface{}{
-				"background": false,
-				"key": map[string]interface{}{
-					"foobar": int32(1),
-				},
-				"name":   ",unique_foobar_",
-				"unique": true,
-			},
-		},
-		{
-			doc: &struct {
-				oidbased.Primary `bson:",inline" json:",inline" collection:"3"`
-
-				Foobar int `bson:"foobar" json:"foobar" index:"-,+foo,+-bar,unique,allowNull"`
-				Foo    int `bson:"foo" json:"foo"`
-				Bar    int `bson:"bar" json:"bar"`
-			}{},
-			index: map[string]interface{}{
-				"background": false,
-				"key": map[string]interface{}{
-					"foobar": int32(-1),
-					"foo":    int32(1),
-					"bar":    int32(-1),
-				},
-				"name": "-,+foo,+-bar,unique,allowNull_foobar_",
-				"partialFilterExpression": map[string]interface{}{
-					"foobar": map[string]interface{}{"$exists": true},
-				},
-				"unique": true,
-			},
-		},
-		{
-			doc: &struct {
-				oidbased.Primary `bson:",inline" json:",inline" collection:"4"`
-
-				Foobar int `bson:"foobar" json:"foobar" index:""`
-				Foo    int `bson:"foo" json:"foo"`
-				Bar    int `bson:"bar" json:"bar"`
-			}{},
-			index: map[string]interface{}{
-				"background": false,
-				"key": map[string]interface{}{
-					"foobar": int32(1),
-				},
-				"name": "_foobar_",
-			},
-		},
-		{
-			doc: &struct {
-				oidbased.Primary `bson:",inline" json:",inline" collection:"5"`
-
-				Foobar int `bson:"foobar" json:"foobar" index:"-"`
-				Foo    int `bson:"foo" json:"foo"`
-				Bar    int `bson:"bar" json:"bar"`
-			}{},
-			index: map[string]interface{}{
-				"background": false,
-				"key": map[string]interface{}{
-					"foobar": int32(-1),
-				},
-				"name": "-_foobar_",
-			},
-		},
-		{
-			doc: &struct {
-				oidbased.Primary `bson:",inline" json:",inline" collection:"1"`
-
-				Foobar int `bson:"foobar" json:"foobar" index:"-,unique,allowNull,expireAfter={{.Expire}}"`
-				Foo    int `bson:"foo" json:"foo"`
-				Bar    int `bson:"bar" json:"bar"`
-			}{},
-			settings: map[string]interface{}{
-				"Expire": 86400,
-			},
-			index: map[string]interface{}{
-				"background":         false,
-				"expireAfterSeconds": int32(86400),
-				"key": map[string]interface{}{
-					"foobar": int32(-1),
-				},
-				"name": "-,unique,allowNull,expireAfter=86400_foobar_",
-				"partialFilterExpression": map[string]interface{}{
-					"foobar": map[string]interface{}{"$exists": true},
-				},
-				"unique": true,
-			},
-		},
-	}
-
-	for _, tt := range testvalues {
-		err = db.IndexEnsure(tt.settings, tt.doc)
-		assert.NoError(t, err)
-
-		indexes, _ := db.GetCollectionOf(tt.doc).Indexes().List(db.Context())
-		index := new(map[string]interface{})
-
-		indexes.Next(db.Context()) // skip _id_
-		indexes.Next(db.Context())
-		indexes.Decode(&index)
-
-		for k, v := range tt.index {
-			assert.Equal(t, v, (*index)[k])
-		}
-	}
-}

mongox/database/loadarray.go

@@ -1,85 +0,0 @@
-package database
-
-import (
-	"fmt"
-	"reflect"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
-)
-
-// LoadArray loads an array of documents from the database by query
-func (d *Database) LoadArray(target interface{}, filters ...interface{}) (err error) {
-
-	targetV := reflect.ValueOf(target)
-	targetT := targetV.Type()
-
-	targetK := targetV.Kind()
-	if targetK != reflect.Ptr {
-		panic(fmt.Errorf("target is not a ptr"))
-	}
-
-	targetSliceV := targetV.Elem()
-	targetSliceT := targetT.Elem()
-	if targetSliceT.Kind() != reflect.Slice {
-		panic(fmt.Errorf("target should be a ptr to a slice"))
-	}
-
-	targetSliceElemT := targetSliceT.Elem()
-	if targetSliceElemT.Kind() != reflect.Ptr {
-		panic(fmt.Errorf("target slice should contain ptrs"))
-	}
-
-	composed := query.Compose(filters...)
-	zeroElem := reflect.Zero(targetSliceElemT)
-	hasPreloader, _ := composed.Preloader()
-
-	var result *mongox.Cursor
-	var i int
-
-	if hasPreloader {
-		result, err = d.createAggregateLoad(zeroElem.Interface(), composed)
-	} else {
-		result, err = d.createSimpleLoad(zeroElem.Interface(), composed)
-	}
-	if err != nil {
-		err = fmt.Errorf("can't create find result: %w", err)
-		return
-	}
-
-	for i = 0; result.Next(d.Context()); {
-
-		var elem interface{}
-
-		if targetSliceV.Len() == i {
-			value := reflect.New(targetSliceElemT.Elem())
-			err = result.Decode(value.Interface())
-			elem = value.Interface()
-			if err == nil {
-				targetSliceV = reflect.Append(targetSliceV, value)
-			}
-		} else {
-			elem = targetSliceV.Index(i).Interface()
-			base.Reset(elem)
-			err = result.Decode(elem)
-		}
-		if err != nil {
-			_ = result.Close(d.Context())
-			return
-		}
-
-		err = onDecode(d.ctx, elem, composed.OnDecode()...)
-		if err != nil {
-			_ = result.Close(d.Context())
-			return
-		}
-
-		i++
-	}
-
-	targetSliceV = targetSliceV.Slice(0, i)
-	targetV.Elem().Set(targetSliceV)
-
-	return result.Close(d.Context())
-}

mongox/database/loadone.go

@@ -1,49 +0,0 @@
-package database
-
-import (
-	"fmt"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
-)
-
-// LoadOne function loads a first single target document by a query
-func (d *Database) LoadOne(target interface{}, filters ...interface{}) (err error) {
-
-	composed := query.Compose(append(filters, query.Limit(1))...)
-	hasPreloader, _ := composed.Preloader()
-
-	var result *mongox.Cursor
-
-	if hasPreloader {
-		result, err = d.createAggregateLoad(target, composed)
-	} else {
-		result, err = d.createSimpleLoad(target, composed)
-	}
-	if err != nil {
-		return fmt.Errorf("can't create find result: %w", err)
-	}
-
-	hasNext := result.Next(d.Context())
-	if result.Err() != nil {
-		return err
-	}
-	if !hasNext {
-		return mongox.ErrNoDocuments
-	}
-
-	base.Reset(target)
-
-	err = result.Decode(target)
-	if err != nil {
-		return
-	}
-
-	err = onDecode(d.ctx, target, composed.OnDecode()...)
-	if err != nil {
-		return
-	}
-
-	return
-}

mongox/database/loadstream.go

@@ -1,31 +0,0 @@
-package database
-
-import (
-	"fmt"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
-)
-
-// LoadStream function loads documents one by one into a target channel
-func (d *Database) LoadStream(target interface{}, filters ...interface{}) (loader mongox.StreamLoader, err error) {
-
-	var cursor *mongox.Cursor
-
-	composed := query.Compose(filters...)
-	hasPreloader, _ := composed.Preloader()
-
-	if hasPreloader {
-		cursor, err = d.createAggregateLoad(target, composed)
-	} else {
-		cursor, err = d.createSimpleLoad(target, composed)
-	}
-	if err != nil {
-		err = fmt.Errorf("can't create find result: %w", err)
-		return
-	}
-
-	loader = &StreamLoader{cur: cursor, ctx: d.Context(), target: target, query: composed}
-
-	return
-}

mongox/database/streamloader.go

@@ -1,80 +0,0 @@
-package database
-
-import (
-	"context"
-
-	"github.com/mainnika/mongox-go-driver/v2/mongox"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/query"
-)
-
-// StreamLoader is a controller for a database cursor
-type StreamLoader struct {
-	cur    *mongox.Cursor
-	query  *query.Query
-	ctx    context.Context
-	target interface{}
-}
-
-// DecodeNext loads next documents to a target or returns an error
-func (l *StreamLoader) DecodeNext() (err error) {
-
-	err = l.Next()
-	if err != nil {
-		return
-	}
-
-	err = l.Decode()
-	if err != nil {
-		return
-	}
-
-	return
-}
-
-// Decode function decodes the current cursor document into the target
-func (l *StreamLoader) Decode() (err error) {
-
-	base.Reset(l.target)
-
-	err = l.cur.Decode(l.target)
-	if err != nil {
-		return
-	}
-
-	err = onDecode(l.ctx, l.target, l.query.OnDecode()...)
-	if err != nil {
-		return
-	}
-
-	return
-}
-
-// Next loads next documents but doesn't perform decoding
-func (l *StreamLoader) Next() (err error) {
-
-	hasNext := l.cur.Next(l.ctx)
-	err = l.cur.Err()
-
-	if err != nil {
-		return
-	}
-	if !hasNext {
-		err = mongox.ErrNoDocuments
-	}
-
-	return
-}
-
-func (l *StreamLoader) Cursor() (cursor *mongox.Cursor) {
-	return l.cur
-}
-
-// Close cursor
-func (l *StreamLoader) Close() (err error) {
-	return l.cur.Close(l.ctx)
-}
-
-func (l *StreamLoader) Err() (err error) {
-	return l.cur.Err()
-}

mongox/errors.go

@@ -1,20 +0,0 @@
-package mongox
-
-import (
-	"go.mongodb.org/mongo-driver/mongo"
-)
-
-// Reexported mongo errors
-var (
-	ErrMissingResumeToken  = mongo.ErrMissingResumeToken
-	ErrNilCursor           = mongo.ErrNilCursor
-	ErrUnacknowledgedWrite = mongo.ErrUnacknowledgedWrite
-	ErrClientDisconnected  = mongo.ErrClientDisconnected
-	ErrNilDocument         = mongo.ErrNilDocument
-	ErrEmptySlice          = mongo.ErrEmptySlice
-	ErrInvalidIndexValue   = mongo.ErrInvalidIndexValue
-	ErrNonStringIndexName  = mongo.ErrNonStringIndexName
-	ErrMultipleIndexDrop   = mongo.ErrMultipleIndexDrop
-	ErrWrongClient         = mongo.ErrWrongClient
-	ErrNoDocuments         = mongo.ErrNoDocuments
-)

mongox/errors/internalerror.go

@@ -0,0 +1,16 @@
+package errors
+
+import "fmt"
+
+// InternalError error
+type InternalError string
+
+// Error message
+func (ie InternalError) Error() string {
+	return fmt.Sprintf("internal error, %s", string(ie))
+}
+
+// InternalErrorf function creates an instance of InternalError
+func InternalErrorf(format string, params ...interface{}) error {
+	return InternalError(fmt.Sprintf(format, params...))
+}

mongox/errors/malformed.go

@@ -0,0 +1,16 @@
+package errors
+
+import "fmt"
+
+// Malformed error
+type Malformed string
+
+// Error message
+func (m Malformed) Error() string {
+	return fmt.Sprintf("Malformed, %s", string(m))
+}
+
+// Malformedf creates an instance of Malformed
+func Malformedf(format string, params ...interface{}) error {
+	return Malformed(fmt.Sprintf(format, params...))
+}

mongox/errors/notfound.go

@@ -0,0 +1,16 @@
+package errors
+
+import "fmt"
+
+// NotFound error
+type NotFound string
+
+// Error message
+func (nf NotFound) Error() string {
+	return fmt.Sprintf("can not find, %s", string(nf))
+}
+
+// NotFoundErrorf function creates an instance of BadRequestError
+func NotFoundErrorf(format string, params ...interface{}) error {
+	return NotFound(fmt.Sprintf(format, params...))
+}

mongox/mongox.go

@@ -5,62 +5,95 @@ import (
 
 	"go.mongodb.org/mongo-driver/bson/primitive"
 	"go.mongodb.org/mongo-driver/mongo"
-)
+	"go.mongodb.org/mongo-driver/mongo/options"
-
+	"go.mongodb.org/mongo-driver/mongo/readpref"
-// Reexport basic mongo structs
-type (
-	Cursor     = mongo.Cursor
-	Client     = mongo.Client
-	Collection = mongo.Collection
 )
 
 // Database is the mongox database interface
 type Database interface {
-	Client() (client *Client)
+	Client() MongoClient
-	Context() (context context.Context)
+	Context() context.Context
-	Name() (name string)
+	Name() string
-	New(ctx context.Context) (db Database)
+	New(ctx context.Context) Database
-	GetCollectionOf(document interface{}) (collection *Collection)
+	GetCollectionOf(document interface{}) MongoCollection
-	Count(target interface{}, filters ...interface{}) (count int64, err error)
-	DeleteArray(target interface{}) (err error)
-	DeleteOne(target interface{}, filters ...interface{}) (err error)
-	LoadArray(target interface{}, filters ...interface{}) (err error)
-	LoadOne(target interface{}, filters ...interface{}) (err error)
-	LoadStream(target interface{}, filters ...interface{}) (loader StreamLoader, err error)
-	SaveOne(source interface{}) (err error)
-	IndexEnsure(cfg interface{}, document interface{}) (err error)
 }
 
-// StreamLoader is a interface to control database cursor
+// MongoClient is the mongo client interface
-type StreamLoader interface {
+type MongoClient interface {
-	Cursor() (cursor *Cursor)
+	Connect(ctx context.Context) error
-	DecodeNext() (err error)
+	Disconnect(ctx context.Context) error
-	Decode() (err error)
+	Ping(ctx context.Context, rp *readpref.ReadPref) error
-	Next() (err error)
+	StartSession(opts ...*options.SessionOptions) (mongo.Session, error)
-	Close() (err error)
+	Database(name string, opts ...*options.DatabaseOptions) *mongo.Database
-	Err() (err error)
+	ListDatabases(ctx context.Context, filter interface{}, opts ...*options.ListDatabasesOptions) (mongo.ListDatabasesResult, error)
+	ListDatabaseNames(ctx context.Context, filter interface{}, opts ...*options.ListDatabasesOptions) ([]string, error)
+	UseSession(ctx context.Context, fn func(mongo.SessionContext) error) error
+	UseSessionWithOptions(ctx context.Context, opts *options.SessionOptions, fn func(mongo.SessionContext) error) error
+	Watch(ctx context.Context, pipeline interface{}, opts ...*options.ChangeStreamOptions) (*mongo.ChangeStream, error)
+	NumberSessionsInProgress() int
 }
 
-// OIDBased is an interface for documents that have objectId type for the _id field
+// MongoCollection is the mongo collection interface
-type OIDBased interface {
+type MongoCollection interface {
-	GetID() (id primitive.ObjectID)
+	Clone(opts ...*options.CollectionOptions) (*mongo.Collection, error)
+	Name() string
+	Database() *mongo.Database
+	BulkWrite(ctx context.Context, models []mongo.WriteModel, opts ...*options.BulkWriteOptions) (*mongo.BulkWriteResult, error)
+	InsertOne(ctx context.Context, document interface{}, opts ...*options.InsertOneOptions) (*mongo.InsertOneResult, error)
+	InsertMany(ctx context.Context, documents []interface{}, opts ...*options.InsertManyOptions) (*mongo.InsertManyResult, error)
+	DeleteOne(ctx context.Context, filter interface{}, opts ...*options.DeleteOptions) (*mongo.DeleteResult, error)
+	DeleteMany(ctx context.Context, filter interface{}, opts ...*options.DeleteOptions) (*mongo.DeleteResult, error)
+	UpdateOne(ctx context.Context, filter interface{}, update interface{}, opts ...*options.UpdateOptions) (*mongo.UpdateResult, error)
+	UpdateMany(ctx context.Context, filter interface{}, update interface{}, opts ...*options.UpdateOptions) (*mongo.UpdateResult, error)
+	ReplaceOne(ctx context.Context, filter interface{}, replacement interface{}, opts ...*options.ReplaceOptions) (*mongo.UpdateResult, error)
+	Aggregate(ctx context.Context, pipeline interface{}, opts ...*options.AggregateOptions) (*mongo.Cursor, error)
+	CountDocuments(ctx context.Context, filter interface{}, opts ...*options.CountOptions) (int64, error)
+	EstimatedDocumentCount(ctx context.Context, opts ...*options.EstimatedDocumentCountOptions) (int64, error)
+	Distinct(ctx context.Context, fieldName string, filter interface{}, opts ...*options.DistinctOptions) ([]interface{}, error)
+	Find(ctx context.Context, filter interface{}, opts ...*options.FindOptions) (*mongo.Cursor, error)
+	FindOne(ctx context.Context, filter interface{}, opts ...*options.FindOneOptions) *mongo.SingleResult
+	FindOneAndDelete(ctx context.Context, filter interface{}, opts ...*options.FindOneAndDeleteOptions) *mongo.SingleResult
+	FindOneAndReplace(ctx context.Context, filter interface{}, replacement interface{}, opts ...*options.FindOneAndReplaceOptions) *mongo.SingleResult
+	FindOneAndUpdate(ctx context.Context, filter interface{}, update interface{}, opts ...*options.FindOneAndUpdateOptions) *mongo.SingleResult
+	Watch(ctx context.Context, pipeline interface{}, opts ...*options.ChangeStreamOptions) (*mongo.ChangeStream, error)
+	Indexes() mongo.IndexView
+	Drop(ctx context.Context) error
+}
+
+// Saver is an interface for documents that can be saved
+type Saver interface {
+	Save(db Database) error
+}
+
+// Deleter is an interface for documents that can be deleted
+type Deleter interface {
+	Delete(db Database) error
+}
+
+// Loader is an interface for documents that can be loaded
+type Loader interface {
+	Load(db Database, filters ...interface{}) error
+}
+
+// Resetter is an interface for documenta that can be resetted
+type Resetter interface {
+	Reset()
+}
+
+// BaseObjectID is an interface for documents that have objectId type for the _id field
+type BaseObjectID interface {
+	GetID() primitive.ObjectID
 	SetID(id primitive.ObjectID)
 }
 
-// StringBased is an interface for documents that have string type for the _id field
+// BaseString is an interface for documents that have string type for the _id field
-type StringBased interface {
+type BaseString interface {
-	GetID() (id string)
+	GetID() string
 	SetID(id string)
 }
 
-// JSONBased is an interface for documents that have object type for the _id field
+// BaseObject is an interface for documents that have object type for the _id field
-type JSONBased interface {
+type BaseObject interface {
-	GetID() (id primitive.D)
+	GetID() primitive.D
 	SetID(id primitive.D)
 }
-
-// InterfaceBased is an interface for documents that have custom declated type for the _id field
-type InterfaceBased interface {
-	GetID() (id interface{})
-	SetID(id interface{})
-}

mongox/query/callbacks.go

@@ -1,7 +0,0 @@
-package query
-
-import (
-	"context"
-)
-
-type OnDecode func(ctx context.Context, iter interface{}) (err error)

mongox/query/compose.go

@@ -1,50 +1,43 @@
 package query
 
 import (
-	"fmt"
-
 	"go.mongodb.org/mongo-driver/bson"
 	"go.mongodb.org/mongo-driver/bson/primitive"
 
-	"github.com/mainnika/mongox-go-driver/v2/mongox/base/protection"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/base"
-	"github.com/mainnika/mongox-go-driver/v2/mongox/utils"
+	"github.com/mainnika/mongox-go-driver/v2/mongox/errors"
 )
 
 // Compose is a function to compose filters into a single query
-func Compose(filters ...interface{}) (query *Query) {
+func Compose(filters ...interface{}) *Query {
 
-	query = &Query{}
+	q := &Query{}
 
 	for _, f := range filters {
-		if !Push(query, f) {
+		if !Push(q, f) {
-			panic(fmt.Errorf("unknown filter %v", f))
+			panic(errors.InternalErrorf("unknown filter %v", f))
 		}
 	}
 
-	return
+	return q
 }
 
 // Push applies single filter to a query
-func Push(q *Query, f interface{}) (ok bool) {
+func Push(q *Query, f interface{}) bool {
 
-	if utils.IsNil(f) {
+	ok := false
-		return true
-	}
-
-	ok = false
 	ok = ok || applyBson(q, f)
 	ok = ok || applyLimit(q, f)
 	ok = ok || applySort(q, f)
 	ok = ok || applySkip(q, f)
 	ok = ok || applyProtection(q, f)
 	ok = ok || applyPreloader(q, f)
-	ok = ok || applyCallbacks(q, f)
 
 	return ok
 }
 
 // applyBson is a fallback for a custom bson.M
-func applyBson(q *Query, f interface{}) (ok bool) {
+func applyBson(q *Query, f interface{}) bool {
 
 	if f, ok := f.(bson.M); ok {
 		q.And(f)
@@ -55,7 +48,7 @@ func applyBson(q *Query, f interface{}) (ok bool) {
 }
 
 // applyLimits extends query with a limiter
-func applyLimit(q *Query, f interface{}) (ok bool) {
+func applyLimit(q *Query, f interface{}) bool {
 
 	if f, ok := f.(Limiter); ok {
 		q.limiter = f
@@ -66,7 +59,7 @@ func applyLimit(q *Query, f interface{}) (ok bool) {
 }
 
 // applySort extends query with a sort rule
-func applySort(q *Query, f interface{}) (ok bool) {
+func applySort(q *Query, f interface{}) bool {
 
 	if f, ok := f.(Sorter); ok {
 		q.sorter = f
@@ -77,7 +70,7 @@ func applySort(q *Query, f interface{}) (ok bool) {
 }
 
 // applySkip extends query with a skip number
-func applySkip(q *Query, f interface{}) (ok bool) {
+func applySkip(q *Query, f interface{}) bool {
 
 	if f, ok := f.(Skipper); ok {
 		q.skipper = f
@@ -87,16 +80,19 @@ func applySkip(q *Query, f interface{}) (ok bool) {
 	return false
 }
 
-func applyProtection(q *Query, f interface{}) (ok bool) {
+func applyProtection(q *Query, f interface{}) bool {
 
 	var x *primitive.ObjectID
 	var v *int64
 
 	switch f := f.(type) {
-	case protection.Key:
+	case base.Protection:
 		x = &f.X
 		v = &f.V
-	case *protection.Key:
+	case *base.Protection:
+		if f == nil {
+			return false
+		}
 		x = &f.X
 		v = &f.V
 
@@ -115,7 +111,7 @@ func applyProtection(q *Query, f interface{}) (ok bool) {
 	return true
 }
 
-func applyPreloader(q *Query, f interface{}) (ok bool) {
+func applyPreloader(q *Query, f interface{}) bool {
 
 	if f, ok := f.(Preloader); ok {
 		q.preloader = f
@@ -124,14 +120,3 @@ func applyPreloader(q *Query, f interface{}) (ok bool) {
 
 	return false
 }
-
-func applyCallbacks(q *Query, f interface{}) (ok bool) {
-
-	switch cb := f.(type) {
-	case OnDecode:
-		q.ondecode = append(q.ondecode, cb)
-		ok = true
-	}
-
-	return
-}

mongox/query/limit.go

@@ -2,7 +2,7 @@ package query
 
 // Limiter is a filter to limit the result
 type Limiter interface {
-	Limit() (limit *int64)
+	Limit() *int64
 }
 
 // Limit is a simple implementation of the Limiter filter
@@ -11,14 +11,12 @@ type Limit int64
 var _ Limiter = Limit(0)
 
 // Limit returns a limit
-func (l Limit) Limit() (limit *int64) {
+func (l Limit) Limit() *int64 {
 
-	if l <= 0 {
+	lim := int64(l)
-		return
+	if lim <= 0 {
+		return nil
 	}
 
-	limit = new(int64)
+	return &lim
-	*limit = int64(l)
-
-	return
 }

mongox/query/preload.go

@@ -2,7 +2,7 @@ package query
 
 // Preloader is a filter to skip the result
 type Preloader interface {
-	Preload() (preloads []string)
+	Preload() []string
 }
 
 // Preload is a simple implementation of the Skipper filter
@@ -11,6 +11,7 @@ type Preload []string
 var _ Preloader = Preload{}
 
 // Preload returns a preload list
-func (l Preload) Preload() (preloads []string) {
+func (l Preload) Preload() []string {
-	return l
+
+	return Preload(l)
 }

mongox/query/query.go

@@ -2,6 +2,8 @@ package query
 
 import (
 	"go.mongodb.org/mongo-driver/bson"
+
+	"reflect"
 )
 
 // Query is an enchanched bson.M map
@@ -11,11 +13,10 @@ type Query struct {
 	sorter    Sorter
 	skipper   Skipper
 	preloader Preloader
-	ondecode  []OnDecode
 }
 
 // And function pushes the elem query to the $and array of the query
-func (q *Query) And(elem bson.M) (query *Query) {
+func (q *Query) And(elem bson.M) *Query {
 
 	if q.m == nil {
 		q.m = bson.M{}
@@ -34,59 +35,61 @@ func (q *Query) And(elem bson.M) (query *Query) {
 }
 
 // Limiter returns limiter value or nil
-func (q *Query) Limiter() (limit *int64) {
+func (q *Query) Limiter() *int64 {
 
 	if q.limiter == nil {
-		return
+		return nil
 	}
 
 	return q.limiter.Limit()
 }
 
 // Sorter is a sort rule for a query
-func (q *Query) Sorter() (sort interface{}) {
+func (q *Query) Sorter() interface{} {
 
 	if q.sorter == nil {
-		return
+		return nil
 	}
 
 	return q.sorter.Sort()
 }
 
 // Skipper is a skipper for a query
-func (q *Query) Skipper() (skip *int64) {
+func (q *Query) Skipper() *int64 {
 
 	if q.skipper == nil {
-		return
+		return nil
 	}
 
 	return q.skipper.Skip()
 }
 
 // Preloader is a preloader list for a query
-func (q *Query) Preloader() (ok bool, preloads []string) {
+func (q *Query) Preloader() (empty bool, preloader []string) {
 
 	if q.preloader == nil {
 		return false, nil
 	}
 
-	preloads = q.preloader.Preload()
+	preloader = q.preloader.Preload()
-	ok = len(preloads) > 0
 
-	return
+	if len(preloader) == 0 {
+		return false, nil
 	}
 
-// OnDecode callback is called after the mongo decode function
+	return true, preloader
-func (q *Query) OnDecode() (callbacks []OnDecode) {
-	return q.ondecode
 }
 
 // Empty checks the query for any content
-func (q *Query) Empty() (isEmpty bool) {
+func (q *Query) Empty() bool {
-	return len(q.m) == 0
+
+	qv := reflect.ValueOf(q.m)
+	keys := qv.MapKeys()
+
+	return len(keys) == 0
 }
 
 // M returns underlying query map
-func (q *Query) M() (m bson.M) {
+func (q *Query) M() bson.M {
 	return q.m
 }

mongox/query/skip.go

@@ -2,7 +2,7 @@ package query
 
 // Skipper is a filter to skip the result
 type Skipper interface {
-	Skip() (skip *int64)
+	Skip() *int64
 }
 
 // Skip is a simple implementation of the Skipper filter
@@ -11,14 +11,12 @@ type Skip int64
 var _ Skipper = Skip(0)
 
 // Skip returns a skip number
-func (l Skip) Skip() (skip *int64) {
+func (l Skip) Skip() *int64 {
 
-	if l <= 0 {
+	lim := int64(l)
-		return
+	if lim <= 0 {
+		return nil
 	}
 
-	skip = new(int64)
+	return &lim
-	*skip = int64(l)
-
-	return
 }

mongox/query/sort.go

@@ -6,7 +6,7 @@ import (
 
 // Sorter is a filter to sort the data before query
 type Sorter interface {
-	Sort() (sort bson.M)
+	Sort() bson.M
 }
 
 // Sort is a simple implementations of the Sorter filter
@@ -15,6 +15,6 @@ type Sort bson.M
 var _ Sorter = &Sort{}
 
 // Sort returns a slice of fields which have to be sorted
-func (f Sort) Sort() (sort bson.M) {
+func (f Sort) Sort() bson.M {
 	return bson.M(f)
 }

mongox/tempdb/tempdb.go

@@ -1,4 +1,4 @@
-package database
+package tempdb
 
 import (
 	"context"
@@ -12,24 +12,24 @@ import (
 	"github.com/mainnika/mongox-go-driver/v2/mongox/database"
 )
 
-// EphemeralDatabase is a temporary database connection that will be destroyed after close
+// TempDB is a temporary database connection that will be destroyed after close
-type EphemeralDatabase struct {
+type TempDB struct {
 	mongox.Database
 }
 
-// NewEphemeral creates new mongo connection
+// NewTempDB creates new mongo connection
-func NewEphemeral(URI string) (db *EphemeralDatabase, err error) {
+func NewTempDB(URI string) (tempdb *TempDB, err error) {
 
 	name := strconv.Itoa(rand.Int())
 	opts := options.Client().ApplyURI(URI)
 	client, err := mongo.Connect(context.Background(), opts)
 
-	db = &EphemeralDatabase{Database: database.NewDatabase(client, name)}
+	tempdb = &TempDB{Database: database.NewDatabase(client, name)}
 
 	return
 }
 
 // Close the connection and drop database
-func (e *EphemeralDatabase) Close() (err error) {
+func (tdb *TempDB) Close() {
-	return e.Client().Database(e.Name()).Drop(e.Context())
+	_ = tdb.Client().Database(tdb.Name()).Drop(tdb.Context())
 }

mongox/utils/isnil.go

@@ -1,23 +0,0 @@
-package utils
-
-import (
-	"unsafe"
-)
-
-// IsNil function evaluates the interface value to nil
-func IsNil(i interface{}) (isNil bool) {
-
-	type iface struct {
-		_   unsafe.Pointer
-		ptr unsafe.Pointer
-	}
-
-	unpacked := (*iface)(unsafe.Pointer(&i))
-	if unpacked.ptr == nil {
-		isNil = true
-		return
-	}
-
-	isNil = *(*unsafe.Pointer)(unpacked.ptr) == nil
-	return
-}

mongox/utils/isnil_test.go

@@ -1,32 +0,0 @@
-package utils
-
-import (
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-)
-
-func TestIsNil(t *testing.T) {
-
-	testvalues := []struct {
-		i     interface{}
-		isnil bool
-	}{
-		{nil, true},
-		{(*string)(nil), true},
-		{([]string)(nil), true},
-		{(map[string]string)(nil), true},
-		{(func() bool)(nil), true},
-		{(chan func() bool)(nil), true},
-		{"", true},
-		{0, true},
-		{append(([]string)(nil), ""), false},
-		{[]string{}, false},
-		{1, false},
-		{"1", false},
-	}
-
-	for _, tt := range testvalues {
-		assert.Equal(t, tt.isnil, IsNil(tt.i))
-	}
-}