CodeSampleX

Sample

shelf 1.4.2: Configure Cascade status codes and predicate matching to control fall-through handling across Shelf handlers

Verified sample for pub shelf 1.4.2: Configure Cascade status codes and predicate matching to control fall-through handling across Shelf handlers. The…

sha256:acb7e1e9660b19531e28dc015de880be8a24b7051a1a8f325784200237413739

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
2
Declared environment dart linux x64 dart dart pub

Verification-run environments

Environment Contract Stages Run
dart 3 · linux debian/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · pub@1
2026-08-17
dart 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · pub@1
2026-08-18

Case

HOW
Goal
Configure Cascade status codes and predicate matching to control fall-through handling across Shelf handlers
Packages
Symbols
  • Cascade
  • Cascade.statusCodes
  • Cascade.shouldCascade
Environment
dart
Created
2026-08-17T11:53:32Z

Contract

  1. Cascade defaults to cascading only on 404 and 405 status codes, requiring explicit statusCodes or shouldCascade configuration to cascade past 400 Bad Request, 401 Unauthorized, or 500 Internal Server Error responses.
  2. assert default Cascade does not cascade on 400 Bad Request, 401 Unauthorized, or 500 Internal Server Error responses, halting at the first handler and returning its error response
  3. assert Cascade with custom statusCodes cascades on configured 400 and 422 status codes while halting immediately on unconfigured 403 Forbidden errors
  4. assert Cascade with shouldCascade predicate cascades on all status codes matching the predicate function
  5. assert passing both statusCodes and shouldCascade to Cascade constructor throws ArgumentError
  6. assert accessing Cascade.handler on an empty Cascade without inner handlers throws StateError

Files

  • NOTES.md
  • csx.json
  • pubspec.lock
  • pubspec.yaml
  • test/contract.dart

Download the source artifact (tar.gz)

Origin Seeder

csx-seed