Files
tasks/chasm/registry_test.go
zeekay 40351cce6f rip: delete temporal fork — native ZAP-only tasksd
Goes from 135 MB binary with 1153 files importing go.temporal.io and 224
importing google.golang.org/grpc to a 10 MB native binary with ZERO of
either.

Deleted:
- tasks/, tasktests/, service/, chasm/, client/, api/, proto/, tools/
- cmd/tools/, components/, docker/
- schema/{cassandra,elasticsearch,mysql,postgresql,sqlite}/
- 40 tainted common/ subdirs + 7 top-level common files
- tests/testutils (no longer referenced after surviving deps drop common)

New cmd/tasksd (~100 lines) boots tasks.Embed (zap.Node) + http.Server.
New pkg/tasks/embed.go registers ZAP handlers for the SDK opcode surface
(0x0060-0x00A5). Workflow handlers return a 501 "not yet implemented"
envelope; native engine lands behind this contract.

Build:  go build ./cmd/tasksd → 10 MB
Vet:    go vet ./... → clean
Boot:   tasksd --zap-port 9999 --http :7243
Probes: /healthz, /v1/tasks/health → 200
UI:     /_/tasks/, / → 200 (embedded Vite bundle)
ZAP:    _tasks._tcp on :9999 (mDNS disabled; direct connect)

go.mod: tidy. No go.temporal.io. No google.golang.org/grpc.
2026-04-26 14:06:21 -07:00

535 lines
17 KiB
Go

package chasm_test
import (
"reflect"
"testing"
"github.com/nexus-rpc/sdk-go/nexus"
"github.com/stretchr/testify/require"
"github.com/stretchr/testify/suite"
"go.temporal.io/server/chasm"
"go.temporal.io/server/common/log"
"go.uber.org/mock/gomock"
)
type (
RegistryTestSuite struct {
suite.Suite
logger log.Logger
}
testTask1 struct{}
testTask2 struct{}
testTaskComponentInterface interface {
DoSomething()
}
// testComponentWithVisibility is a test component that has a Visibility field.
testComponentWithVisibility struct {
chasm.UnimplementedComponent
Visibility chasm.Field[*chasm.Visibility]
}
)
func (t *testComponentWithVisibility) LifecycleState(_ chasm.Context) chasm.LifecycleState {
return chasm.LifecycleStateRunning
}
func TestRegistryTestSuite(t *testing.T) {
suite.Run(t, new(RegistryTestSuite))
}
func (s *RegistryTestSuite) SetupTest() {
s.logger = log.NewTestLogger()
}
func (s *RegistryTestSuite) TestRegistry_RegisterComponents_Success() {
r := chasm.NewRegistry(s.logger)
ctrl := gomock.NewController(s.T())
lib := chasm.NewMockLibrary(ctrl)
lib.EXPECT().Name().Return("TestLibrary").AnyTimes()
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
chasm.NewRegistrableComponent[*chasm.MockComponent]("Component1"),
})
lib.EXPECT().Tasks().Return(nil)
lib.EXPECT().NexusServices().Return(nil)
lib.EXPECT().NexusServiceProcessors().Return(nil)
err := r.Register(lib)
require.NoError(s.T(), err)
rc1, ok := r.Component("TestLibrary.Component1")
require.True(s.T(), ok)
require.Equal(s.T(), "TestLibrary.Component1", rc1.FqType())
missingRC, ok := r.Component("TestLibrary.Component2")
require.False(s.T(), ok)
require.Nil(s.T(), missingRC)
cInstance1 := chasm.NewMockComponent(ctrl)
rc2, ok := r.ComponentFor(cInstance1)
require.True(s.T(), ok)
require.Equal(s.T(), "TestLibrary.Component1", rc2.FqType())
rc2, ok = r.ComponentOf(reflect.TypeOf(cInstance1))
require.True(s.T(), ok)
require.Equal(s.T(), "TestLibrary.Component1", rc2.FqType())
cInstance2 := "invalid component instance"
rc3, ok := r.ComponentFor(cInstance2)
require.False(s.T(), ok)
require.Nil(s.T(), rc3)
}
func (s *RegistryTestSuite) TestRegistry_RegisterComponents_WithDetached() {
r := chasm.NewRegistry(s.logger)
ctrl := gomock.NewController(s.T())
lib := chasm.NewMockLibrary(ctrl)
lib.EXPECT().Name().Return("TestLibrary").AnyTimes()
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
chasm.NewRegistrableComponent[*chasm.MockComponent]("DetachedComponent", chasm.WithDetached()),
})
lib.EXPECT().Tasks().Return(nil)
lib.EXPECT().NexusServices().Return(nil)
lib.EXPECT().NexusServiceProcessors().Return(nil)
err := r.Register(lib)
s.Require().NoError(err)
// Detached component should have IsDetached() return true
detachedRC, ok := r.Component("TestLibrary.DetachedComponent")
s.Require().True(ok)
s.Require().True(detachedRC.IsDetached())
// Verify that a component without WithDetached() has IsDetached() return false
normalRC := chasm.NewRegistrableComponent[*chasm.MockComponent]("NormalComponent")
s.Require().False(normalRC.IsDetached())
}
func (s *RegistryTestSuite) TestRegistry_RegisterTasks_Success() {
r := chasm.NewRegistry(s.logger)
ctrl := gomock.NewController(s.T())
lib := chasm.NewMockLibrary(ctrl)
lib.EXPECT().Name().Return("TestLibrary").AnyTimes()
lib.EXPECT().Components().Return(nil)
lib.EXPECT().NexusServices().Return(nil)
lib.EXPECT().NexusServiceProcessors().Return(nil)
lib.EXPECT().Tasks().Return([]*chasm.RegistrableTask{
chasm.NewRegistrableSideEffectTask(
"Task1",
chasm.NewMockSideEffectTaskHandler[*chasm.MockComponent, testTask1](ctrl),
chasm.WithTaskGroup("test-task-group"),
),
chasm.NewRegistrablePureTask(
"Task2",
chasm.NewMockPureTaskHandler[testTaskComponentInterface, testTask2](ctrl),
),
})
err := r.Register(lib)
require.NoError(s.T(), err)
rt1, ok := r.Task("TestLibrary.Task1")
require.True(s.T(), ok)
require.Equal(s.T(), "TestLibrary.Task1", rt1.FqType())
s.Require().Equal("test-task-group", rt1.TaskGroup())
missingRT, ok := r.Task("TestLibrary.TaskMissing")
require.False(s.T(), ok)
require.Nil(s.T(), missingRT)
tInstance1 := testTask2{}
rt2, ok := r.TaskFor(tInstance1)
require.True(s.T(), ok)
require.Equal(s.T(), "TestLibrary.Task2", rt2.FqType())
s.Require().Equal(rt2.FqType(), rt2.TaskGroup())
rt2, ok = r.TaskOf(reflect.TypeOf(tInstance1))
require.True(s.T(), ok)
require.Equal(s.T(), "TestLibrary.Task2", rt2.FqType())
tInstance2 := "invalid task instance"
rt3, ok := r.TaskFor(tInstance2)
require.False(s.T(), ok)
require.Nil(s.T(), rt3)
}
func (s *RegistryTestSuite) TestRegistry_Register_LibraryError() {
ctrl := gomock.NewController(s.T())
lib := chasm.NewMockLibrary(ctrl)
s.T().Run("library name must not be empty", func(t *testing.T) {
lib.EXPECT().Name().Return("")
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "name must not be empty")
})
s.T().Run("library name must follow rules", func(t *testing.T) {
lib.EXPECT().Name().Return("bad.lib.name")
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "name must follow golang identifier rules")
})
}
func (s *RegistryTestSuite) TestRegistry_RegisterComponents_Error() {
ctrl := gomock.NewController(s.T())
lib := chasm.NewMockLibrary(ctrl)
lib.EXPECT().Name().Return("TestLibrary").AnyTimes()
s.T().Run("component name must not be empty", func(t *testing.T) {
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
chasm.NewRegistrableComponent[*chasm.MockComponent](""),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "name must not be empty")
})
s.T().Run("component name must follow rules", func(t *testing.T) {
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
chasm.NewRegistrableComponent[*chasm.MockComponent]("bad.component.name"),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "name must follow golang identifier rules")
})
s.T().Run("component is already registered by name", func(t *testing.T) {
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
chasm.NewRegistrableComponent[*chasm.MockComponent]("Component1"),
chasm.NewRegistrableComponent[*chasm.MockComponent]("Component1"),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "is already registered")
})
s.T().Run("component is already registered by type", func(t *testing.T) {
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
chasm.NewRegistrableComponent[*chasm.MockComponent]("Component1"),
chasm.NewRegistrableComponent[*chasm.MockComponent]("Component2"),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "is already registered")
})
s.T().Run("component is already registered in another library", func(t *testing.T) {
lib2 := chasm.NewMockLibrary(ctrl)
lib2.EXPECT().Name().Return("TestLibrary2").AnyTimes()
component := chasm.NewRegistrableComponent[*chasm.MockComponent]("Component1")
lib2.EXPECT().Components().Return([]*chasm.RegistrableComponent{
component,
})
lib2.EXPECT().Tasks().Return(nil)
lib2.EXPECT().NexusServices().Return(nil)
lib2.EXPECT().NexusServiceProcessors().Return(nil)
r2 := chasm.NewRegistry(s.logger)
err := r2.Register(lib2)
require.NoError(t, err)
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
component,
})
r := chasm.NewRegistry(s.logger)
err = r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "is already registered in library TestLibrary2")
})
s.T().Run("component must be a struct", func(t *testing.T) {
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
chasm.NewRegistrableComponent[chasm.Component]("Component1"),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "must be struct or pointer to struct")
})
s.Run("duplicate search attribute alias panics", func() {
s.Require().PanicsWithValue("registrable component validation error: search attribute alias \"MyAlias\" is already defined",
func() {
chasm.NewRegistrableComponent[*chasm.MockComponent](
"Component1",
chasm.WithSearchAttributes(
chasm.NewSearchAttributeBool("MyAlias", chasm.SearchAttributeFieldBool01),
chasm.NewSearchAttributeInt("MyAlias", chasm.SearchAttributeFieldInt01),
),
)
},
)
})
s.Run("duplicate search attribute field panics", func() {
s.Require().PanicsWithValue("registrable component validation error: search attribute field \"TemporalBool01\" is already defined",
func() {
chasm.NewRegistrableComponent[*chasm.MockComponent](
"Component1",
chasm.WithSearchAttributes(
chasm.NewSearchAttributeBool("Alias1", chasm.SearchAttributeFieldBool01),
chasm.NewSearchAttributeBool("Alias2", chasm.SearchAttributeFieldBool01),
),
)
},
)
})
s.Run("valid search attributes do not panic", func() {
s.Require().NotPanics(func() {
chasm.NewRegistrableComponent[*chasm.MockComponent](
"Component1",
chasm.WithSearchAttributes(
chasm.NewSearchAttributeBool("Completed", chasm.SearchAttributeFieldBool01),
chasm.NewSearchAttributeInt("Count", chasm.SearchAttributeFieldInt01),
chasm.NewSearchAttributeKeyword("Status", chasm.SearchAttributeFieldKeyword01),
),
)
})
})
s.Run("ExecutionStatus alias is allowed for CHASM components", func() {
s.Require().NotPanics(func() {
chasm.NewRegistrableComponent[*chasm.MockComponent](
"Component1",
chasm.WithSearchAttributes(
chasm.NewSearchAttributeKeyword("ExecutionStatus", chasm.SearchAttributeFieldLowCardinalityKeyword01),
),
)
})
})
s.Run("TaskQueue preallocated search attribute is allowed", func() {
s.Require().NotPanics(func() {
chasm.NewRegistrableComponent[*chasm.MockComponent](
"Component1",
chasm.WithSearchAttributes(
chasm.SearchAttributeTaskQueue,
),
)
})
})
s.Run("CHASM system search attribute alias panics", func() {
s.Require().PanicsWithValue(
"registrable component validation error: CHASM search attribute alias \"WorkflowId\" is a CHASM system search attribute",
func() {
chasm.NewRegistrableComponent[*chasm.MockComponent](
"Component1",
chasm.WithSearchAttributes(
chasm.NewSearchAttributeKeyword("WorkflowId", chasm.SearchAttributeFieldKeyword01),
),
)
},
)
})
s.Run("component with Visibility field must have businessID alias", func() {
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
chasm.NewRegistrableComponent[*testComponentWithVisibility]("ComponentWithVis"),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
s.Require().Error(err)
s.Require().Contains(err.Error(), "has Field[*Visibility] but no businessID alias")
})
s.Run("component with Visibility field and businessID alias succeeds", func() {
lib.EXPECT().Components().Return([]*chasm.RegistrableComponent{
chasm.NewRegistrableComponent[*testComponentWithVisibility](
"ComponentWithVis",
chasm.WithBusinessIDAlias("MyBusinessId"),
),
})
lib.EXPECT().Tasks().Return(nil)
lib.EXPECT().NexusServices().Return(nil)
lib.EXPECT().NexusServiceProcessors().Return(nil)
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
s.Require().NoError(err)
})
}
func (s *RegistryTestSuite) TestRegistry_RegisterTasks_Error() {
ctrl := gomock.NewController(s.T())
lib := chasm.NewMockLibrary(ctrl)
lib.EXPECT().Name().Return("TestLibrary").AnyTimes()
lib.EXPECT().Components().Return(nil).AnyTimes()
s.T().Run("task name must not be empty", func(t *testing.T) {
r := chasm.NewRegistry(s.logger)
lib.EXPECT().Tasks().Return([]*chasm.RegistrableTask{
chasm.NewRegistrablePureTask[*chasm.MockComponent, testTask1](
"",
chasm.NewMockPureTaskHandler[*chasm.MockComponent, testTask1](ctrl),
),
})
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "name must not be empty")
})
s.T().Run("task name must follow rules", func(t *testing.T) {
lib.EXPECT().Tasks().Return([]*chasm.RegistrableTask{
chasm.NewRegistrablePureTask[*chasm.MockComponent, testTask1](
"bad.task.name",
chasm.NewMockPureTaskHandler[*chasm.MockComponent, testTask1](ctrl),
),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "name must follow golang identifier rules")
})
s.T().Run("task is already registered by name", func(t *testing.T) {
lib.EXPECT().Tasks().Return([]*chasm.RegistrableTask{
chasm.NewRegistrablePureTask[*chasm.MockComponent, testTask1](
"Task1",
chasm.NewMockPureTaskHandler[*chasm.MockComponent, testTask1](ctrl),
),
chasm.NewRegistrableSideEffectTask[*chasm.MockComponent, testTask1](
"Task1",
chasm.NewMockSideEffectTaskHandler[*chasm.MockComponent, testTask1](ctrl),
),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "is already registered")
})
s.T().Run("task is already registered by type", func(t *testing.T) {
lib.EXPECT().Tasks().Return([]*chasm.RegistrableTask{
chasm.NewRegistrablePureTask[*chasm.MockComponent, testTask1](
"Task1",
chasm.NewMockPureTaskHandler[*chasm.MockComponent, testTask1](ctrl),
),
chasm.NewRegistrablePureTask[*chasm.MockComponent, testTask1](
"Task2",
chasm.NewMockPureTaskHandler[*chasm.MockComponent, testTask1](ctrl),
),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
require.Error(t, err)
require.Contains(t, err.Error(), "is already registered")
})
s.Run("task is already registered in another library", func() {
lib2 := chasm.NewMockLibrary(ctrl)
lib2.EXPECT().Name().Return("TestLibrary2").AnyTimes()
lib2.EXPECT().Components().Return(nil)
lib2.EXPECT().NexusServices().Return(nil)
lib2.EXPECT().NexusServiceProcessors().Return(nil)
task := chasm.NewRegistrablePureTask[*chasm.MockComponent, testTask1](
"Task1",
chasm.NewMockPureTaskHandler[*chasm.MockComponent, testTask1](ctrl),
)
lib2.EXPECT().Tasks().Return([]*chasm.RegistrableTask{task})
r2 := chasm.NewRegistry(s.logger)
err := r2.Register(lib2)
s.Require().NoError(err)
lib.EXPECT().Tasks().Return([]*chasm.RegistrableTask{task})
r := chasm.NewRegistry(s.logger)
err = r.Register(lib)
s.ErrorContains(err, "is already registered in library TestLibrary2")
})
s.Run("task must be struct", func() {
lib.EXPECT().Tasks().Return([]*chasm.RegistrableTask{
chasm.NewRegistrablePureTask[*chasm.MockComponent, string](
"Task1",
chasm.NewMockPureTaskHandler[*chasm.MockComponent, string](ctrl),
),
})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
s.ErrorContains(err, "must be struct or pointer to struct")
})
}
func (s *RegistryTestSuite) TestRegistry_RegisterNexusServices_Success() {
r := chasm.NewRegistry(s.logger)
ctrl := gomock.NewController(s.T())
lib := chasm.NewMockLibrary(ctrl)
lib.EXPECT().Name().Return("TestLibrary").AnyTimes()
lib.EXPECT().Components().Return(nil)
lib.EXPECT().Tasks().Return(nil)
lib.EXPECT().NexusServiceProcessors().Return(nil)
svc1 := nexus.NewService("Service1")
svc2 := nexus.NewService("Service2")
lib.EXPECT().NexusServices().Return([]*nexus.Service{svc1, svc2})
err := r.Register(lib)
s.Require().NoError(err)
services := r.NexusServices()
s.Require().Len(services, 2)
s.Require().Contains(services, "Service1")
s.Require().Contains(services, "Service2")
s.Require().Equal(svc1, services["Service1"])
s.Require().Equal(svc2, services["Service2"])
}
func (s *RegistryTestSuite) TestRegistry_RegisterNexusServices_Error() {
ctrl := gomock.NewController(s.T())
lib := chasm.NewMockLibrary(ctrl)
lib.EXPECT().Name().Return("TestLibrary").AnyTimes()
lib.EXPECT().Components().Return(nil).AnyTimes()
lib.EXPECT().Tasks().Return(nil).AnyTimes()
lib.EXPECT().NexusServiceProcessors().Return(nil).AnyTimes()
s.Run("nexus service is already registered", func() {
svc := nexus.NewService("Service1")
lib.EXPECT().NexusServices().Return([]*nexus.Service{svc, svc})
r := chasm.NewRegistry(s.logger)
err := r.Register(lib)
s.Require().ErrorContains(err, "is already registered")
})
}
func (s *RegistryTestSuite) TestRegistry_RegisterNexusServiceProcessors() {
r := chasm.NewRegistry(s.logger)
ctrl := gomock.NewController(s.T())
lib := chasm.NewMockLibrary(ctrl)
lib.EXPECT().Name().Return("TestLibrary").AnyTimes()
lib.EXPECT().Components().Return(nil)
lib.EXPECT().Tasks().Return(nil)
lib.EXPECT().NexusServices().Return(nil)
proc1 := chasm.NewNexusServiceProcessor("ServiceProcessor1")
proc2 := chasm.NewNexusServiceProcessor("ServiceProcessor2")
lib.EXPECT().NexusServiceProcessors().Return([]*chasm.NexusServiceProcessor{proc1, proc2})
err := r.Register(lib)
s.Require().NoError(err)
// Verify the processors were registered by attempting to use them
// We can verify registration indirectly by trying to register them again which should fail
err = r.NexusEndpointProcessor.RegisterServiceProcessor(proc1)
s.Require().ErrorContains(err, "already registered")
err = r.NexusEndpointProcessor.RegisterServiceProcessor(proc2)
s.Require().ErrorContains(err, "already registered")
}