resource_testbed

func RunTypeScriptTest ¶

func RunTypeScriptTest(
	ctx context.Context,
	le *logrus.Entry,
	pluginID string,
	tsFilePath string,
) (success bool, errorMsg string, err error)

RunTypeScriptTest builds a wrapper around a TypeScript test file and runs it in QuickJS. The test file should export a default async function with signature:

export default async function main(
  backendAPI: BackendAPI,
  abortSignal: AbortSignal,
  testbedRoot: TestbedRoot,
)

The wrapper automatically sets up the resources client, testbed root, and reports test results via MarkTestResult. This is the recommended way to run TypeScript E2E tests.

Example test file (my-test.ts):

import type { BackendAPI } from '@aptre/bldr-sdk'
import type { TestbedRoot } from '../../../sdk/testbed/testbed.js'

export default async function main(
  backendAPI: BackendAPI,
  abortSignal: AbortSignal,
  testbedRoot: TestbedRoot,
) {
  // Create a world engine
  using engine = await testbedRoot.createWorld('my-engine')

  // Do your test logic here
  const ws = engine.asWorldState()
  using obj = await ws.createObject('test-key', {})
  console.log('Test passed!')
}

Usage in Go test:

func TestMyFeature(t *testing.T) {
    ctx := context.Background()
    log := logrus.New()
    log.SetLevel(logrus.DebugLevel)
    le := logrus.NewEntry(log)

    success, errorMsg, err := RunTypeScriptTest(ctx, le, "my-test", "my-test.ts")
    if err != nil {
        t.Fatal(err)
    }
    if !success {
        t.Fatalf("test failed: %s", errorMsg)
    }
}

func SetupResourceClient ¶

func SetupResourceClient(ctx context.Context, t *testing.T, tb *world_testbed.Testbed) (*resource_client.Client, func())

SetupResourceClient creates pipes, muxed connections, and resource client for testing. Returns the resource client and a cleanup function.

func SetupTestbedWithClient ¶

func SetupTestbedWithClient(ctx context.Context, t *testing.T) (*world_testbed.Testbed, *resource_client.Client, func())

SetupTestbedWithClient creates a hydra testbed and resource client for testing. Returns the testbed, resource client, and a cleanup function.