668869b6c7
* feat(plugins): define TaskQueue host service interface Add the TaskQueueService interface with CreateQueue, Enqueue, GetTaskStatus, and CancelTask methods plus QueueConfig struct. * feat(plugins): define TaskWorker capability for task execution callbacks * feat(plugins): add taskqueue permission to manifest schema Add TaskQueuePermission with maxConcurrency option. * feat(plugins): implement TaskQueue service with SQLite persistence and workers Per-plugin SQLite database with queues and tasks tables. Worker goroutines dequeue tasks and invoke nd_task_execute callback. Exponential backoff retries, rate limiting via delayMs, automatic cleanup of terminal tasks. * feat(plugins): require TaskWorker capability for taskqueue permission * feat(plugins): register TaskQueue host service in manager * feat(plugins): add test-taskqueue plugin for integration testing * feat(plugins): add integration tests for TaskQueue host service * docs: document TaskQueue module for persistent task queues Signed-off-by: Deluan <deluan@navidrome.org> * fix(plugins): harden TaskQueue host service with validation and safety improvements Add input validation (queue name length, payload size limits), extract status string constants to eliminate raw SQL literals, make CreateQueue idempotent via upsert for crash recovery, fix RetentionMs default check for negative values, cap exponential backoff at 1 hour to prevent overflow, and replace manual mutex-based delay enforcement with rate.Limiter from golang.org/x/time/rate for correct concurrent worker serialization. * refactor(plugins): remove capability check for TaskWorker in TaskQueue host service Signed-off-by: Deluan <deluan@navidrome.org> * fix(plugins): use context-aware database execution in TaskQueue host service Signed-off-by: Deluan <deluan@navidrome.org> * refactor(plugins): streamline task queue configuration and error handling Signed-off-by: Deluan <deluan@navidrome.org> * feat(plugins): increase maxConcurrency for task queue and handle budget exhaustion Signed-off-by: Deluan <deluan@navidrome.org> * refactor(plugins): simplify goroutine management in task queue service Signed-off-by: Deluan <deluan@navidrome.org> * feat(plugins): update TaskWorker interface to return status messages and refactor task queue service Signed-off-by: Deluan <deluan@navidrome.org> * feat(plugins): add ClearQueue function to remove pending tasks from a specified queue Signed-off-by: Deluan <deluan@navidrome.org> * refactor(plugins): use migrateDB for task queue schema and fix constant name collision Replaced the raw db.Exec call in createTaskQueueSchema with migrateDB, matching the pattern used by createKVStoreSchema. This enables version-tracked schema migrations via SQLite's PRAGMA user_version, allowing future schema changes to be appended incrementally. Also renamed cleanupInterval to taskCleanupInterval to resolve a redeclaration conflict with host_kvstore.go. * regenerate PDKs Signed-off-by: Deluan <deluan@navidrome.org> --------- Signed-off-by: Deluan <deluan@navidrome.org>
106 lines
3.5 KiB
Go
106 lines
3.5 KiB
Go
// Code generated by ndpgen. DO NOT EDIT.
|
|
//
|
|
// This file contains mock implementations for non-WASM builds.
|
|
// These mocks allow IDE support, compilation, and unit testing on non-WASM platforms.
|
|
// Plugin authors can use the exported mock instances to set expectations in tests.
|
|
//
|
|
//go:build !wasip1
|
|
|
|
package host
|
|
|
|
import "github.com/stretchr/testify/mock"
|
|
|
|
// QueueConfig represents the QueueConfig data structure.
|
|
// QueueConfig holds configuration for a task queue.
|
|
type QueueConfig struct {
|
|
Concurrency int32 `json:"concurrency"`
|
|
MaxRetries int32 `json:"maxRetries"`
|
|
BackoffMs int64 `json:"backoffMs"`
|
|
DelayMs int64 `json:"delayMs"`
|
|
RetentionMs int64 `json:"retentionMs"`
|
|
}
|
|
|
|
// TaskInfo represents the TaskInfo data structure.
|
|
// TaskInfo holds the current state of a task.
|
|
type TaskInfo struct {
|
|
Status string `json:"status"`
|
|
Message string `json:"message"`
|
|
Attempt int32 `json:"attempt"`
|
|
}
|
|
|
|
// mockTaskService is the mock implementation for testing.
|
|
type mockTaskService struct {
|
|
mock.Mock
|
|
}
|
|
|
|
// TaskMock is the auto-instantiated mock instance for testing.
|
|
// Use this to set expectations: host.TaskMock.On("MethodName", args...).Return(values...)
|
|
var TaskMock = &mockTaskService{}
|
|
|
|
// CreateQueue is the mock method for TaskCreateQueue.
|
|
func (m *mockTaskService) CreateQueue(name string, config QueueConfig) error {
|
|
args := m.Called(name, config)
|
|
return args.Error(0)
|
|
}
|
|
|
|
// TaskCreateQueue delegates to the mock instance.
|
|
// CreateQueue creates a named task queue with the given configuration.
|
|
// Zero-value fields in config use sensible defaults.
|
|
// If a queue with the same name already exists, returns an error.
|
|
// On startup, this also recovers any stale "running" tasks from a previous crash.
|
|
func TaskCreateQueue(name string, config QueueConfig) error {
|
|
return TaskMock.CreateQueue(name, config)
|
|
}
|
|
|
|
// Enqueue is the mock method for TaskEnqueue.
|
|
func (m *mockTaskService) Enqueue(queueName string, payload []byte) (string, error) {
|
|
args := m.Called(queueName, payload)
|
|
return args.String(0), args.Error(1)
|
|
}
|
|
|
|
// TaskEnqueue delegates to the mock instance.
|
|
// Enqueue adds a task to the named queue. Returns the task ID.
|
|
// payload is opaque bytes passed back to the plugin on execution.
|
|
func TaskEnqueue(queueName string, payload []byte) (string, error) {
|
|
return TaskMock.Enqueue(queueName, payload)
|
|
}
|
|
|
|
// Get is the mock method for TaskGet.
|
|
func (m *mockTaskService) Get(taskID string) (*TaskInfo, error) {
|
|
args := m.Called(taskID)
|
|
return args.Get(0).(*TaskInfo), args.Error(1)
|
|
}
|
|
|
|
// TaskGet delegates to the mock instance.
|
|
// Get returns the current state of a task including its status,
|
|
// message, and attempt count.
|
|
func TaskGet(taskID string) (*TaskInfo, error) {
|
|
return TaskMock.Get(taskID)
|
|
}
|
|
|
|
// Cancel is the mock method for TaskCancel.
|
|
func (m *mockTaskService) Cancel(taskID string) error {
|
|
args := m.Called(taskID)
|
|
return args.Error(0)
|
|
}
|
|
|
|
// TaskCancel delegates to the mock instance.
|
|
// Cancel cancels a pending task. Returns error if already
|
|
// running, completed, or failed.
|
|
func TaskCancel(taskID string) error {
|
|
return TaskMock.Cancel(taskID)
|
|
}
|
|
|
|
// ClearQueue is the mock method for TaskClearQueue.
|
|
func (m *mockTaskService) ClearQueue(queueName string) (int64, error) {
|
|
args := m.Called(queueName)
|
|
return args.Get(0).(int64), args.Error(1)
|
|
}
|
|
|
|
// TaskClearQueue delegates to the mock instance.
|
|
// ClearQueue removes all pending tasks from the named queue.
|
|
// Running tasks are not affected. Returns the number of tasks removed.
|
|
func TaskClearQueue(queueName string) (int64, error) {
|
|
return TaskMock.ClearQueue(queueName)
|
|
}
|