browser_launch.go RawHistoryFolder

1package port
2
3import (
4	"context"
5	"io"
6)
7
8// BrowserWindowOpener opens browser URLs received through the launch relay.
9type BrowserWindowOpener interface {
10	OpenExternalURL(ctx context.Context, url string) error
11	OpenFreshWindow(ctx context.Context, url string) error
12}
13
14// BrowserInstanceOpener opens or focuses a logical UI instance inside a shared
15// browser runtime. Implementations must keep one dedicated window per name.
16type BrowserInstanceOpener interface {
17	OpenInstance(ctx context.Context, name, url string) error
18}
19
20// BrowserInstanceLaunchRelay delivers launches for logical UI instances.
21// It is separate from BrowserLaunchRelay so other engine adapters do not need
22// to implement CEF-specific multi-instance behavior.
23type BrowserInstanceLaunchRelay interface {
24	DeliverOpenInstance(ctx context.Context, name, url string) (bool, error)
25}
26
27// BrowserLaunchRelay delivers browser URL launch requests.
28type BrowserLaunchRelay interface {
29	// DeliverOpenExternalURL attempts to deliver a request to open an external URL.
30	// The bool reports whether the relay accepted the request; false means the
31	// caller should treat it as undelivered and try another path.
32	// An error may still be returned with delivered=true when the relay accepted
33	// the request but could not confirm completion before the caller timed out.
34	DeliverOpenExternalURL(ctx context.Context, url string) (bool, error)
35	// DeliverOpenFreshWindow attempts to deliver a request that must open in a
36	// new browser window, independently of external-link workspace settings.
37	DeliverOpenFreshWindow(ctx context.Context, url string) (bool, error)
38	Listen(ctx context.Context, opener BrowserWindowOpener) (io.Closer, error)
39}
40
41// BrowserLaunchRelayPreparer binds the socket while the caller holds the
42// separate namespace lease. Listen starts serving it and returns a closer that
43// stops serving without releasing namespace ownership.
44type BrowserLaunchRelayPreparer interface {
45	Prepare(namespaceLease io.Closer) error
46}
47
48// AlreadyRunningAppRelaunchHandlerSetter configures a handler for CEF relaunches.
49type AlreadyRunningAppRelaunchHandlerSetter interface {
50	SetAlreadyRunningAppRelaunchHandler(func(string))
51}