workers

type Config struct {
	// WaitUntilTimeout bounds how long the executor is held after the
	// HTTP response has been written, waiting for ctx.waitUntil
	// promises to settle. Non-positive disables the timeout.
	WaitUntilTimeout time.Duration

	// SecretsPrefix is the environment-variable prefix consulted when
	// building env.SECRETS. A variable named "<prefix>API_KEY=abc"
	// appears as env.SECRETS.API_KEY. Empty string uses the default
	// "RAMUNE_SECRET_".
	SecretsPrefix string

	// ExtraEnvJS is JavaScript appended to the env builder. It runs
	// once per runtime with the partially-built env object exposed via
	// the globalThis.__extraEnvBindings hook. Used by callers (e.g.
	// ramune.toml loaders) to attach named bindings.
	ExtraEnvJS string

	// SQLitePath, when non-empty, opens a SQLite database at the given
	// filesystem path and installs env.DB (D1-compatible) and env.KV
	// (Workers-KV-like). When empty, env.DB / env.KV access throws
	// unless a KVBackend / DBBackend has been supplied. Mutually
	// exclusive with KVBackend and DBBackend.
	SQLitePath string

	// KVBackend, when non-nil, provides the storage for env.KV. See
	// the [KVBackend] interface docs. Mutually exclusive with
	// SQLitePath.
	KVBackend KVBackend

	// DBBackend, when non-nil, provides the SQL engine for env.DB.
	// See [DBBackend]. Mutually exclusive with SQLitePath.
	DBBackend DBBackend
}

type DBBackend interface {
	// Query runs a read statement (SELECT) and returns every row as a
	// map keyed by column name. Values use JS-friendly Go types:
	// string, float64, bool, nil, []byte (coerced to string at the
	// boundary).
	Query(sql string, params []any) (rows []map[string]any, err error)
	// Exec runs a write statement. changes is the rows-affected count,
	// lastInsertID is the last auto-increment id, or 0 if unsupported.
	Exec(sql string, params []any) (changes, lastInsertID int64, err error)
}

type KVBackend interface {
	// Get returns the value stored at (ns, key). ok is false when the
	// key does not exist; err is reserved for infrastructure failures.
	Get(ns, key string) (value string, ok bool, err error)
	// Put writes value at (ns, key), overwriting any existing value.
	Put(ns, key, value string) error
	// Delete removes (ns, key). Deleting a missing key must succeed.
	Delete(ns, key string) error
	// List returns up to limit keys within ns whose name starts with
	// prefix (empty prefix = all). Keys should be sorted ascending.
	List(ns, prefix string, limit int) (keys []string, err error)
}

type ModuleConfig struct {
	Route        string
	Cron         string
	HasFetch     bool
	HasScheduled bool
}

type Option func(*Config)

type Prepared struct {
	// contains filtered or unexported fields
}

type RamuneTOML struct {
	Dependencies map[string]string `toml:"dependencies"`
	Permissions  *TOMLPermissions  `toml:"permissions"`
	KVNamespaces []TOMLKVBinding   `toml:"kv_namespaces"`
	Secrets      *TOMLSecrets      `toml:"secrets"`
}

type TOMLDerived struct {
	Dependencies []string
	Permissions  *ramune.Permissions
	Options      []Option
}

type TOMLKVBinding struct {
	Binding   string `toml:"binding"`
	Namespace string `toml:"namespace"`
}

type TOMLPermissions struct {
	Net   string `toml:"net"`
	Read  string `toml:"read"`
	Write string `toml:"write"`
	Env   string `toml:"env"`
	Run   string `toml:"run"`

	NetHosts   []string `toml:"net_hosts"`
	ReadPaths  []string `toml:"read_paths"`
	WritePaths []string `toml:"write_paths"`
	EnvVars    []string `toml:"env_vars"`
	RunCmds    []string `toml:"run_cmds"`
}

type TOMLSecrets struct {
	Prefix string `toml:"prefix"`
}