feat: withdeletiontimestamp filter

[cmwylie19]

Description

Adds a new filter .WithDeletionTimestamp to aid Operator developers as they use ownerRefs. Decide if .HasDeletionTimestamp needs to be done.

Needs:

• e2e test (chore: e2e withdeletiontimestamp pepr-excellent-examples#61)
• docs

Related Issue

Fixes #1018
Fixes: #1027

Relates to #

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Other (security config, docs update, etc)

Checklist before merging

• Test, docs, adr added or updated as needed
• Contributor Guide Steps followed

[codecov]

Codecov Report

Attention: Patch coverage is 54.54545% with 5 lines in your changes missing coverage. Please review.

Project coverage is 85.65%. Comparing base (8cd1cb1) to head (c104c81).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/lib/capability.ts	0.00%	5 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1026      +/-   ##
==========================================
- Coverage   85.90%   85.65%   -0.26%     
==========================================
  Files          26       26              
  Lines        1022     1032      +10     
  Branches      219      222       +3     
==========================================
+ Hits          878      884       +6     
- Misses        133      137       +4     
  Partials       11       11              

Files with missing lines	Coverage Δ
src/lib/filter.ts	81.03% <100.00%> (+1.40%)	⬆️
src/lib/helpers.ts	97.00% <100.00%> (+0.03%)	⬆️
src/lib/types.ts	100.00% <ø> (ø)
src/lib/capability.ts	34.82% <0.00%> (-1.29%)	⬇️

[cmwylie19]

Codecov Report

Attention: Patch coverage is 64.28571% with 5 lines in your changes missing coverage. Please review.

Project coverage is 85.55%. Comparing base (5c0b2d9) to head (073ea49).

Files Patch % Lines
src/lib/capability.ts 0.00% 5 Missing ⚠️
Additional details and impacted files

false positive, this is tested in other ways and does not drop the overall coverage.

[samayer12]

Aside from a stylistic choice on multiple && statements vs. Optional Chaining with? things look good. I'll still have to get more familiar with our tests

[btlghrants]

Seems legit -- glad we chatted it through.

[cmwylie19]

CodeCov is false positive, the coverage remains at 85.