ioworkspace

type ExportOptions struct {
	// WorkspaceID is the source workspace ID for the export (required)
	WorkspaceID idwrap.IDWrap

	// IncludeHTTP determines whether to include HTTP requests in the export
	IncludeHTTP bool

	// IncludeFlows determines whether to include flows in the export
	IncludeFlows bool

	// IncludeEnvironments determines whether to include environments in the export
	IncludeEnvironments bool

	// IncludeFiles determines whether to include file structure in the export
	IncludeFiles bool

	// ExportFormat specifies the output format (e.g., "json", "yaml", "zip")
	ExportFormat string

	// FilterByFolderID optionally filters export to a specific folder and its children
	FilterByFolderID *idwrap.IDWrap

	// FilterByFlowIDs optionally filters export to specific flows
	FilterByFlowIDs []idwrap.IDWrap

	// FilterByHTTPIDs optionally filters export to specific HTTP requests
	FilterByHTTPIDs []idwrap.IDWrap
}

type FlowCleanup struct {
	// FlowID is the flow that owns the cleanup block.
	FlowID idwrap.IDWrap
	// CleanupFlowID is the hidden flow holding the cleanup nodes. It is
	// Bundle.Flows[0].ID.
	CleanupFlowID idwrap.IDWrap
	// Steps lists the cleanup steps in execution order.
	Steps []FlowCleanupStep
	// Bundle holds the cleanup flow and every entity its nodes need (nodes,
	// HTTP and GraphQL requests and their children).
	Bundle *WorkspaceBundle
}

type FlowCleanupStep struct {
	NodeID idwrap.IDWrap
	Name   string
	// DependsOn names other cleanup steps of the same block. A step whose
	// dependency did not succeed is skipped.
	DependsOn []string
	// References names the steps (normal or cleanup) whose output this step's
	// templates read. A step referencing a step that produced no output (it
	// never ran) is skipped instead of being sent with an unresolved template.
	References []string
}

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

type ImportOptions struct {
	// WorkspaceID is the target workspace ID for the import (required)
	WorkspaceID idwrap.IDWrap

	// ParentFolderID is the optional parent folder to import files under
	ParentFolderID *idwrap.IDWrap

	// CreateFiles determines whether to create file entries during import
	CreateFiles bool

	// MergeMode determines how to handle conflicts with existing entities
	// - "skip": Skip entities that already exist
	// - "replace": Replace existing entities with imported ones
	// - "create_new": Create new entities even if similar ones exist
	MergeMode string

	// PreserveIDs determines whether to preserve entity IDs from the source
	// If false, new IDs will be generated during import
	PreserveIDs bool

	// ImportHTTP determines whether to import HTTP requests
	ImportHTTP bool

	// ImportFlows determines whether to import flows
	ImportFlows bool

	// ImportEnvironments determines whether to import environments
	ImportEnvironments bool

	// StartOrder is the starting order value for imported files
	StartOrder float64

	// ImportFlowCleanups stores each FlowCleanup's hidden cleanup flow and its
	// entities, so a runner can build and execute the cleanup nodes. It
	// requires PreserveIDs, because FlowCleanup refers to nodes and flows by
	// their bundle IDs. When false (the desktop import path), cleanup blocks
	// are dropped with a warning.
	ImportFlowCleanups bool
}

type ImportResult struct {
	// Entity counts
	HTTPRequestsCreated            int
	HTTPSearchParamsCreated        int
	HTTPHeadersCreated             int
	HTTPBodyFormsCreated           int
	HTTPBodyUrlencodedCreated      int
	HTTPBodyRawCreated             int
	HTTPAssertsCreated             int
	FilesCreated                   int
	FlowsCreated                   int
	FlowVariablesCreated           int
	FlowNodesCreated               int
	FlowEdgesCreated               int
	FlowRequestNodesCreated        int
	FlowConditionNodesCreated      int
	FlowForNodesCreated            int
	FlowForEachNodesCreated        int
	FlowJSNodesCreated             int
	FlowAINodesCreated             int
	FlowAIProviderNodesCreated     int
	FlowAIMemoryNodesCreated       int
	FlowGraphQLNodesCreated        int
	FlowWsConnectionNodesCreated   int
	FlowWsSendNodesCreated         int
	FlowWaitNodesCreated           int
	FlowSubFlowTriggerNodesCreated int
	FlowSubFlowReturnNodesCreated  int
	FlowRunSubFlowNodesCreated     int
	WebSocketsCreated              int
	WebSocketHeadersCreated        int
	GraphQLRequestsCreated         int
	GraphQLHeadersCreated          int
	GraphQLAssertsCreated          int
	EnvironmentsCreated            int
	EnvironmentVarsCreated         int

	// ID mappings for reference (old ID -> new ID)
	HTTPIDMap        map[idwrap.IDWrap]idwrap.IDWrap
	FlowIDMap        map[idwrap.IDWrap]idwrap.IDWrap
	NodeIDMap        map[idwrap.IDWrap]idwrap.IDWrap
	FileIDMap        map[idwrap.IDWrap]idwrap.IDWrap
	EnvironmentIDMap map[idwrap.IDWrap]idwrap.IDWrap
	WebSocketIDMap   map[idwrap.IDWrap]idwrap.IDWrap
}

type WorkspaceBundle struct {
	// Workspace metadata
	Workspace mworkspace.Workspace

	// HTTP requests and associated data structures
	HTTPRequests       []mhttp.HTTP
	HTTPSearchParams   []mhttp.HTTPSearchParam
	HTTPHeaders        []mhttp.HTTPHeader
	HTTPBodyForms      []mhttp.HTTPBodyForm
	HTTPBodyUrlencoded []mhttp.HTTPBodyUrlencoded
	HTTPBodyRaw        []mhttp.HTTPBodyRaw
	HTTPAsserts        []mhttp.HTTPAssert

	// GraphQL requests and associated data
	GraphQLRequests []mgraphql.GraphQL
	GraphQLHeaders  []mgraphql.GraphQLHeader
	GraphQLAsserts  []mgraphql.GraphQLAssert

	// WebSocket requests and associated data
	WebSockets       []mwebsocket.WebSocket
	WebSocketHeaders []mwebsocket.WebSocketHeader

	// File organization
	Files []mfile.File

	// Flow structures
	Flows         []mflow.Flow
	FlowVariables []mflow.FlowVariable
	FlowNodes     []mflow.Node
	FlowEdges     []mflow.Edge

	// Flow node implementations by type
	FlowRequestNodes        []mflow.NodeRequest
	FlowConditionNodes      []mflow.NodeIf
	FlowForNodes            []mflow.NodeFor
	FlowForEachNodes        []mflow.NodeForEach
	FlowJSNodes             []mflow.NodeJS
	FlowAINodes             []mflow.NodeAI
	FlowAIProviderNodes     []mflow.NodeAiProvider
	FlowAIMemoryNodes       []mflow.NodeMemory
	FlowGraphQLNodes        []mflow.NodeGraphQL
	FlowWsConnectionNodes   []mflow.NodeWsConnection
	FlowWsSendNodes         []mflow.NodeWsSend
	FlowWaitNodes           []mflow.NodeWait
	FlowSubFlowTriggerNodes []mflow.NodeSubFlowTrigger
	FlowSubFlowReturnNodes  []mflow.NodeSubFlowReturn
	FlowRunSubFlowNodes     []mflow.NodeRunSubFlow

	// Environments and variables
	Environments    []menv.Env
	EnvironmentVars []menv.Variable

	// Credentials (metadata only, secrets are never exported)
	Credentials []mcredential.Credential

	// LoadScenarios carries the yamlflow `load:` block so it survives the
	// YAML import -> export round trip.
	//
	// Unlike every other field here it is NOT database-backed: Import ignores
	// it and Export never populates it, because there is no storage for load
	// scenarios yet (Phase 2). Only the file-to-file path (the CLI and the
	// yamlflow translator) reads and writes it.
	LoadScenarios []mload.Scenario

	// FlowCleanups carries each flow's yamlflow `cleanup:` steps: steps that
	// run after the flow's normal steps finish, whether they passed or failed.
	//
	// Like LoadScenarios it is file-only: the cleanup entities live in each
	// FlowCleanup's own Bundle rather than in the slices above, so a regular
	// Import does not store them (and says so) and Export never populates
	// this field. Import stores them only when ImportOptions.ImportFlowCleanups
	// is set, which the CLI does so it can execute them.
	FlowCleanups []FlowCleanup

	// AIChecks carries the yamlflow AI checks: the file's and flows' judge:,
	// quality: and iterations:, and each step's expect: block (by flow node ID).
	// Import stores the flows' settings (with the file's folded in) and the
	// steps' blocks; Export reads them back as flow settings and steps. Expect
	// blocks of cleanup steps live in the cleanup's own Bundle.
	AIChecks *mexpect.Checks

	// HTTPStreams carries request steps' stream: settings, by HTTP request.
	HTTPStreams []mhttp.HTTPStream

	// HTTPNoRedirects lists the HTTP requests of steps with follow_redirects: false.
	// File-only: the CLI applies it to the built nodes; the workspace DB does not store it.
	HTTPNoRedirects []idwrap.IDWrap
}