Add vendor directory and update vendorHash to null

vendor/github.com/pressly/goose/v3/database/store.go

@@ -0,0 +1,66 @@
+package database
+
+import (
+	"context"
+	"errors"
+	"time"
+)
+
+var (
+	// ErrVersionNotFound must be returned by [GetMigration] or [GetLatestVersion] when a migration
+	// does not exist.
+	ErrVersionNotFound = errors.New("version not found")
+
+	// ErrNotImplemented must be returned by methods that are not implemented.
+	ErrNotImplemented = errors.New("not implemented")
+)
+
+// Store is an interface that defines methods for tracking and managing migrations. It is used by
+// the goose package to interact with a database. By defining a Store interface, multiple
+// implementations can be created to support different databases without reimplementing the
+// migration logic.
+//
+// This package provides several dialects that implement the Store interface. While most users won't
+// need to create their own Store, if you need to support a database that isn't currently supported,
+// you can implement your own!
+type Store interface {
+	// Tablename is the name of the version table. This table is used to record applied migrations
+	// and must not be an empty string.
+	Tablename() string
+	// CreateVersionTable creates the version table, which is used to track migrations.
+	CreateVersionTable(ctx context.Context, db DBTxConn) error
+	// Insert a version id into the version table.
+	Insert(ctx context.Context, db DBTxConn, req InsertRequest) error
+	// Delete a version id from the version table.
+	Delete(ctx context.Context, db DBTxConn, version int64) error
+	// GetMigration retrieves a single migration by version id. If the query succeeds, but the
+	// version is not found, this method must return [ErrVersionNotFound].
+	GetMigration(ctx context.Context, db DBTxConn, version int64) (*GetMigrationResult, error)
+	// GetLatestVersion retrieves the last applied migration version. If no migrations exist, this
+	// method must return [ErrVersionNotFound].
+	GetLatestVersion(ctx context.Context, db DBTxConn) (int64, error)
+	// ListMigrations retrieves all migrations sorted in descending order by id or timestamp. If
+	// there are no migrations, return empty slice with no error. Typically this method will return
+	// at least one migration, because the initial version (0) is always inserted into the version
+	// table when it is created.
+	ListMigrations(ctx context.Context, db DBTxConn) ([]*ListMigrationsResult, error)
+}
+
+type InsertRequest struct {
+	Version int64
+
+	// TODO(mf): in the future, we maybe want to expand this struct so implementors can store
+	// additional information. See the following issues for more information:
+	//  - https://github.com/pressly/goose/issues/422
+	//  - https://github.com/pressly/goose/issues/288
+}
+
+type GetMigrationResult struct {
+	Timestamp time.Time
+	IsApplied bool
+}
+
+type ListMigrationsResult struct {
+	Version   int64
+	IsApplied bool
+}