cloudcontrol

type CCDataSourceConfig struct {
	// BlueprintType is the Bluelink data source type, e.g. "aws/dynamodb/table".
	BlueprintType string
	// CFNType is the CloudFormation type name, e.g. "AWS::DynamoDB::Table".
	CFNType string
	Label   string
	// PlainTextSummary and FormattedDescription document the data source type.
	PlainTextSummary     string
	FormattedDescription string
	// Schema is the typed resource schema, reused to translate the
	// fetched Cloud Control properties into typed exports.
	// (overlays can make alterations to the schema)
	Schema *provider.ResourceDefinitionsSchema
	// Meta carries the per-type information the engine needs for identifier resolution
	// and CFN<->spec name translation.
	Meta CCResourceMeta
	// FilterFields declares the filterable fields exposed to practitioners.
	FilterFields map[string]*provider.DataSourceFilterSchema
	// ExportFields declares the (flattened) exportable fields.
	ExportFields map[string]*provider.DataSourceSpecSchema
	// DeriveIdentifierFromARN enables a fast path where a single `arn` equality filter
	// is resolved to the primary identifier by taking the ARN's final segment. Set for
	// name-style identifiers (e.g. eventBus name, table name); leave false where the
	// identifier is the ARN itself or a non-derivable form (e.g. an SQS queue URL).
	DeriveIdentifierFromARN bool
	// FormattedExamples holds rendered example markdown for the data source type.
	FormattedExamples []string
}

type CCResourceConfig struct {
	// BlueprintType is the Bluelink resource type, e.g. "aws/sqs/queue".
	BlueprintType string
	// CFNType is the CloudFormation type name, e.g. "AWS::SQS::Queue".
	CFNType              string
	Label                string
	PlainTextSummary     string
	FormattedDescription string
	// Schema is the generated resource spec schema (the engine augments it with
	// internal Cloud Control bookkeeping fields).
	Schema *provider.ResourceDefinitionsSchema
	// Meta carries per-type information the generic engine cannot infer at runtime.
	Meta CCResourceMeta
	// FormattedExamples holds rendered example markdown for the resource type.
	FormattedExamples []string
	// CommonTerminal hints whether the resource is not expected to link out.
	CommonTerminal bool
}

type CCResourceMeta struct {
	// PrimaryIdentifierField is the user-facing spec field that mirrors the CFN
	// primaryIdentifier which is also used as the resource definition's IDField.
	// For composite identifiers it holds the first component.
	PrimaryIdentifierField string
	// PrimaryIdentifierFields holds all components of a composite CFN
	// primaryIdentifier, in order. When set (length > 1), the engine joins the
	// component spec values with "|" to form Cloud Control's composite identifier
	// if no stored identifier is available. Empty for single-identifier types.
	PrimaryIdentifierFields []string
	// ComputedFields lists spec field paths (without the "spec." prefix) that map
	// to CFN readOnlyProperties. They are stripped from desired state and update patches.
	ComputedFields []string
	// CreateOnlyFields lists spec field paths mapping to CFN createOnlyProperties.
	// Changes to these route through MustRecreate, never an update patch.
	CreateOnlyFields []string
	// WriteOnlyFields lists spec field paths mapping to CFN writeOnlyProperties.
	// Cloud Control never returns these, so they are excluded from update diffs
	// and external state reconciliation.
	WriteOnlyFields []string
	// TagPropertyName is the spec/CFN property holding tags, or "" when untaggable.
	TagPropertyName string
	// TagShape describes how TagPropertyName encodes tags.
	TagShape TagShape
	// FieldNameOverrides maps a camelCase field path (with "*" for array/map
	// descent) to its CloudFormation property name. This is for fields where a simple
	// first-character flip does not round-trip, such as
	// "sseSpecification" <-> "SSESpecification".
	// Absent paths fall back to flipping the first character of the last path segment.
	FieldNameOverrides map[string]string
	// JSONStringFields lists camelCase field paths (with "*" for array/map descent)
	// that hold a CloudFormation free-form object encoded as a JSON string. The
	// engine parses the string into a JSON object when building Cloud Control
	// desired state and serialises the object back to a string when reading
	// external state.
	JSONStringFields []string
}

type TagShape int