---
id: TST-PFM-INT-610
title: Extension runtime execution
kind: unit
product_area: platform
module: integrations
revision: 1
status: draft
source_sha:
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
  macroservice-libraries: 54536a441935c6e09fdb7f96f0bec71c52ba4e03
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
repository: macroservice-libraries
files:
  - packages/extensions/src/extensions.spec.ts
implements: []
environment: mock
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 1
isolation: 'The test process owns its inputs, fake clocks and any replaced runtime ports.'
test_cases:
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#validates the input before
      anything else: nothing is read, delivered or recorded
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses a mode the point does not
      declare
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses an idempotency key
      outside commit mode
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#never calls a transport inside a
      transaction
  - provenance: test
    source: 'macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses a point of another kind'
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#answers the default when no
      binding matches, and calls nothing
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#answers the most specific
      handler’s validated output and records the invocation
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#carries the business idempotency
      key in commit mode
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#caps the handler’s timeout at the
      point’s ceiling
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses under a closed policy in
      preview and commit, naming the point and handler
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#falls back to the default in
      quote mode, recorded
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#falls back to the default under a
      binding’s open override
  - provenance: test
    source: 'macroservice-libraries:packages/extensions/src/extensions.spec.ts#records a timeout as timed_out'
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#answers within the deadline for a
      slow handler
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#records an answer outside the
      contract as invalid_output and never applies it
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses an acknowledgement, which
      is for actions only
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#treats a tie as a configuration
      error under the point’s policy, calling nothing
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#applies the policy with no call
      while the breaker is open, recorded circuit_open
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#opens the breaker after five
      failures
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#applies the policy with no call
      when the tenant has no permit, and releases a permit it took
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#calls a binding on an older
      version through the converters
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#validates an older binding’s
      answer against its own version
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#invokes shadow bindings in
      preview with purpose shadow, records them and never applies them
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#answers the default when only a
      shadow binding matches, still invoking it
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#answers what the handler said
      even when the recorder fails
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#answers not_available for a
      handler kind without a transport, under the point’s policy
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#unions every handler’s problems,
      naming each handler
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#approves with no problems when no
      binding matches
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#answers extension_unavailable
      naming the handler that could not answer under a closed policy
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#turns the unavailability into a
      warning in quote mode
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#skips the handler under an open
      override, recorded skipped
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#applies each handler’s delta in
      order, each seeing the previous result
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses a delta touching a field
      outside the writable set: skipped under open, the value unchanged
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses a delta that leaves the
      value outside the contract
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#throws ExtensionUnavailableError
      under a closed override in commit mode
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#writes the pending invocation and
      the queue row in the caller’s transaction and calls nothing
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#takes the deadline the caller
      states
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#answers the default and writes
      nothing when no binding matches
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses to run outside a
      transaction
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses an input outside the
      contract and missing completion functions
  - provenance: test
    source: >-
      macroservice-libraries:packages/extensions/src/extensions.spec.ts#refuses a tie, writing no queue
      row
evidence:
  - 'macroservice-libraries:packages/extensions/src/extensions.spec.ts'
---
# Extension runtime execution

## Verification Boundary

This unit suite exercises extension runtime execution within the shared package. It records engineering coverage at the pinned revision without claiming a deployed run.

## What This Suite Proves

The source assertions cover the package behavior under controlled inputs. No detailed capability or feature scenario binding is verified in this registration.

## What It Does Not Prove

The suite does not establish deployed authorization, database behavior, provider effects or a complete customer workflow.

## Real Dependencies and Test Doubles

Imported package functions execute against the source-defined fixtures. Runtime ports, clocks and external transport responses remain controlled wherever the suite replaces them.

## Must Not Be Doubled

The shared function under test and its result assertions must execute. Returning an expected answer from a substitute does not prove the package behavior.