iextengine

type BuiltInAppExtFuncs map[appdef.FullQName]BuiltInExtFunc

type BuiltInExtFunc func(ctx context.Context, io IExtensionIO) error

type BuiltInExtFuncs map[istructs.AppQName]BuiltInAppExtFuncs // Provided to construct factory of engines

type ExtEngineConfig struct {
	// MemoryLimitPages limits the maximum memory pages available to the extension
	// 1 page = 2^16 bytes.
	//
	// Default value is 2^8 so the total available memory is 2^24 bytes
	MemoryLimitPages uint
}

type ExtensionEngineFactories map[appdef.ExtensionEngineKind]IExtensionEngineFactory

type ExtensionLimits struct {

	// Default is 0 (execution interval not specified)
	ExecutionInterval time.Duration
}

type ExtensionPackage struct {
	QualifiedName  string
	ModuleUrl      *url.URL
	ExtensionNames []string
}

type IExtensionEngine interface {
	SetLimits(limits ExtensionLimits)
	Invoke(ctx context.Context, extName appdef.FullQName, io IExtensionIO) (err error)
	Close(ctx context.Context)
}

type IExtensionEngineFactory interface {
	// LocalPath is a path package data can be got from
	// - packages is not used for ExtensionEngineKind_BuiltIn
	// - config is not used for ExtensionEngineKind_BuiltIn
	New(ctx context.Context, app istructs.AppQName, packages []ExtensionPackage, config *ExtEngineConfig, numEngines int) ([]IExtensionEngine, error)
}

type IExtensionIO interface {
	istructs.IState
	istructs.IIntents
	istructs.IPkgNameResolver
}

type IExtensionsModule interface {
	// Returns URL to a resource
	//
	// Example: file:///home/user1/myextension.wasm
	GetURL() string
}