feat(kinesis): resolve stream name from StreamARN parameter

[hampsterx]

Summary

Most Kinesis actions now accept StreamARN as an alternative to StreamName, matching real AWS SDK behavior. When a client sends a full ARN (e.g. arn:aws:kinesis:us-east-1:123456789012:stream/my-stream), Floci extracts the stream name and resolves it normally.

• Add shared resolveStreamName helper to KinesisJsonHandler that checks StreamName first, falls back to parsing StreamARN
• Apply to 13 handler methods (all except CreateStream which only accepts StreamName per AWS API)
• Refactor handleListShards from inline ARN logic to the shared helper
• Guard against malformed ARNs (missing :stream/ segment, trailing slash, consumer ARNs)
• Throw InvalidArgumentException when neither field is valid

Motivation

AWS SDKs send StreamARN when the user passes an ARN-format identifier. Libraries like async-kinesis detect the arn: prefix and use StreamARN automatically. Without this, Floci treats the entire ARN as a literal stream name and returns "Stream does not exist".

Test plan

• 12 new unit tests (KinesisJsonHandlerTest) covering: StreamName resolution, StreamARN resolution, empty/whitespace name fallback, missing fields, malformed ARN, ARN ending in slash, consumer ARN extraction, StreamName precedence
• 4 new integration tests (KinesisIntegrationTest): DescribeStream by ARN, PutRecord+GetShardIterator+GetRecords by ARN, missing field returns 400, malformed ARN returns 400
• All existing tests unaffected (ListShards by ARN test continues to pass with refactored helper)
• CI (requires Java 25)

Changes

 docs/services/kinesis.md                          |  12 ++
 .../services/kinesis/KinesisJsonHandler.java      |  65 ++++----
 .../services/kinesis/KinesisIntegrationTest.java  | 104 +++++++++++++
 .../services/kinesis/KinesisJsonHandlerTest.java  | 170 +++++++++++++++++++++
 4 files changed, 323 insertions(+), 28 deletions(-)

[hectorvent]

Thank you @hampsterx

[hectorvent]

Hi @hampsterx,

Please check internal test failure:

[INFO] Results:
[INFO] 
Error:  Failures: 
Error:    KinesisIntegrationTest.putAndGetRecordsByArn:160 1 expectation failed.
JSON path Records.size() doesn't match.
Expected: a value equal to or greater than <1>
  Actual: <0>

[hampsterx]

fixed, tests failing due to #317 i think