lightspeed/platform/turnkey_presets

Turnkey app-platform defaults and presets contracts for M58.

Types

Secure admin defaults.

pub type AdminDefaults {
  AdminDefaults(
    provider_module: String,
    audit_sink_module: String,
    approval_required: Bool,
    break_glass_role: String,
  )
}

Constructors

  • AdminDefaults(
      provider_module: String,
      audit_sink_module: String,
      approval_required: Bool,
      break_glass_role: String,
    )

Secure auth defaults.

pub type AuthDefaults {
  AuthDefaults(
    provider_module: String,
    session_ttl_minutes: Int,
    mfa_required: Bool,
    passkeys_required: Bool,
    password_min_length: Int,
  )
}

Constructors

  • AuthDefaults(
      provider_module: String,
      session_ttl_minutes: Int,
      mfa_required: Bool,
      passkeys_required: Bool,
      password_min_length: Int,
    )

Secure billing defaults.

pub type BillingDefaults {
  BillingDefaults(
    provider_module: String,
    webhook_verification: Bool,
    dunning_enabled: Bool,
    idempotency_required: Bool,
  )
}

Constructors

  • BillingDefaults(
      provider_module: String,
      webhook_verification: Bool,
      dunning_enabled: Bool,
      idempotency_required: Bool,
    )

Critical platform flow certified by deterministic fixtures.

pub type CriticalFlow {
  SignupWithMfaFlow
  AdminBreakGlassApprovalFlow
  BillingWebhookReconciliationFlow
  PolicyDeniedAuditTrailFlow
  EmailVerificationDeliveryFlow
  QueueReplayRecoveryFlow
}

Constructors

  • SignupWithMfaFlow
  • AdminBreakGlassApprovalFlow
  • BillingWebhookReconciliationFlow
  • PolicyDeniedAuditTrailFlow
  • EmailVerificationDeliveryFlow
  • QueueReplayRecoveryFlow

Secure email defaults.

pub type EmailDefaults {
  EmailDefaults(
    provider_module: String,
    domain_authentication_required: Bool,
    suppression_list_enabled: Bool,
    signed_templates_required: Bool,
  )
}

Constructors

  • EmailDefaults(
      provider_module: String,
      domain_authentication_required: Bool,
      suppression_list_enabled: Bool,
      signed_templates_required: Bool,
    )

Explicit override seam contract.

pub type OverrideHook {
  OverrideHook(
    seam: PresetSeam,
    module: String,
    hook: String,
    rationale: String,
  )
}

Constructors

  • OverrideHook(
      seam: PresetSeam,
      module: String,
      hook: String,
      rationale: String,
    )

Secure policy defaults.

pub type PolicyDefaults {
  PolicyDefaults(
    provider_module: String,
    deny_by_default: Bool,
    tenant_scoped: Bool,
    decision_trace_enabled: Bool,
  )
}

Constructors

  • PolicyDefaults(
      provider_module: String,
      deny_by_default: Bool,
      tenant_scoped: Bool,
      decision_trace_enabled: Bool,
    )

Override seam for one platform domain.

pub type PresetSeam {
  AuthSeam
  AdminSeam
  BillingSeam
  PolicySeam
  EmailSeam
  QueueSeam
}

Constructors

  • AuthSeam
  • AdminSeam
  • BillingSeam
  • PolicySeam
  • EmailSeam
  • QueueSeam

Secure queue defaults.

pub type QueueDefaults {
  QueueDefaults(
    provider_module: String,
    max_attempts: Int,
    dead_letter_enabled: Bool,
    idempotency_required: Bool,
    replay_checkpoint_required: Bool,
  )
}

Constructors

  • QueueDefaults(
      provider_module: String,
      max_attempts: Int,
      dead_letter_enabled: Bool,
      idempotency_required: Bool,
      replay_checkpoint_required: Bool,
    )

Deterministic reference app scenario for M58.

pub type ReferenceScenario {
  ReferenceScenario(
    name: String,
    preset: StarterPreset,
    flows: List(CriticalFlow),
    seed: String,
  )
}

Constructors

Production-shaped starter preset.

pub type StarterPreset {
  StarterPreset(
    name: String,
    scaffold_command: String,
    auth: AuthDefaults,
    admin: AdminDefaults,
    billing: BillingDefaults,
    policy: PolicyDefaults,
    email: EmailDefaults,
    queue: QueueDefaults,
    override_hooks: List(OverrideHook),
    requires_framework_internal_edits: Bool,
  )
}

Constructors

Values

pub fn critical_flow_signature(preset: StarterPreset) -> String

Stable critical-flow support signature for one preset.

pub fn fixture_snapshots() -> List(#(String, String))

Deterministic fixture snapshots for M58 drift gates.

pub fn flow_label(flow: CriticalFlow) -> String

Critical flow label.

pub fn has_explicit_override_seams(preset: StarterPreset) -> Bool

True when every seam has at least one explicit override hook.

pub fn name(preset: StarterPreset) -> String

Preset name accessor.

pub fn override_hook(
  seam: PresetSeam,
  module: String,
  hook: String,
  rationale: String,
) -> OverrideHook

Build one override hook.

pub fn override_hooks(
  preset: StarterPreset,
) -> List(OverrideHook)

Override hooks accessor.

pub fn override_surface_signature(
  preset: StarterPreset,
) -> String

Stable override surface signature for one preset.

pub fn override_without_internal_edits(
  preset: StarterPreset,
) -> Bool

True when overrides avoid framework internals edits.

pub fn profile_version_label() -> String

Stable M58 profile version label.

pub fn reference_presets() -> List(StarterPreset)

Deterministic M58 reference presets.

pub fn reference_scenarios() -> List(ReferenceScenario)

Deterministic reference scenarios for fixture certification.

pub fn required_critical_flows() -> List(CriticalFlow)

Required critical flows for M58 certification.

pub fn requires_framework_internal_edits(
  preset: StarterPreset,
) -> Bool

Framework-internal-edits accessor.

pub fn scaffold_command(preset: StarterPreset) -> String

One-command scaffold accessor.

pub fn scaffoldable_secure_baseline(
  preset: StarterPreset,
) -> Bool

True when one preset is ready as secure turnkey baseline.

pub fn scenario_certified(scenario: ReferenceScenario) -> Bool

True when one reference scenario is certified.

pub fn scenario_flows(
  scenario: ReferenceScenario,
) -> List(CriticalFlow)

Scenario flows accessor.

pub fn scenario_name(scenario: ReferenceScenario) -> String

Scenario name accessor.

pub fn scenario_preset(
  scenario: ReferenceScenario,
) -> StarterPreset

Scenario preset accessor.

pub fn scenario_signature(scenario: ReferenceScenario) -> String

Stable scenario signature.

pub fn seam_label(seam: PresetSeam) -> String

Override seam label.

pub fn secure_defaults(preset: StarterPreset) -> Bool

True when secure defaults are prewired.

pub fn secure_marketplace_preset() -> StarterPreset

Secure marketplace starter preset.

pub fn secure_operations_preset() -> StarterPreset

Secure operations-heavy starter preset.

pub fn secure_saas_preset() -> StarterPreset

Secure SaaS starter preset.

pub fn signature(preset: StarterPreset) -> String

Stable preset signature.

pub fn snapshot_signature() -> String

Deterministic M58 snapshot signature.

pub const snapshot_version: Int
pub fn starter_scaffold_ready(preset: StarterPreset) -> Bool

True when scaffold command represents one safe starter invocation.

pub fn supports_flow(
  preset: StarterPreset,
  flow: CriticalFlow,
) -> Bool

True when one critical flow is supported by preset defaults.

pub fn valid(preset: StarterPreset) -> Bool

Validate one starter preset contract.

pub fn with_override_hook(
  preset: StarterPreset,
  new_hook: OverrideHook,
) -> StarterPreset

Add one override hook when missing.

Search Document