├── .commitlintrc.json ├── .editorconfig ├── .gitattributes ├── .github ├── CODEOWNERS ├── CODE_OF_CONDUCT.md ├── COMMIT_CONVENTION.md ├── FUNDING.yml ├── ISSUE_TEMPLATE │ ├── bug_report.yml │ ├── config.yml │ ├── feature_request.yml │ └── question.yml ├── PULL_REQUEST_TEMPLATE.md ├── SECURITY.md ├── dependabot.yml ├── labels.yml └── workflows │ ├── auto-deprecate.yml │ ├── codeql.yml │ ├── continuous-integration.yml │ ├── dependabot-approve-and-auto-merge.yml │ ├── label-sync.yml │ ├── lock.yml │ └── publish-dev.yml ├── .gitignore ├── .husky ├── .gitignore ├── commit-msg └── pre-commit ├── .npmignore ├── .prettierrc ├── .release-it.json ├── LICENSE ├── README.md ├── eslint.config.mjs ├── jest.config.json ├── package.json ├── src ├── commands │ ├── base.command.ts │ ├── index.ts │ ├── resilience-observable.command.ts │ └── resilience.command.ts ├── decorators │ ├── base-resilience.decorator.ts │ ├── index.ts │ ├── use-resilience-observable.decorator.ts │ └── use-resilience.decorator.ts ├── enum │ ├── circuit-breaker-state.enum.ts │ ├── index.ts │ └── resilience-event-type.enum.ts ├── exceptions │ ├── bulkhead-rejected.exception.ts │ ├── circuit-opened.exception.ts │ ├── health-check-failed.exception.ts │ ├── index.ts │ ├── resilience-runtime.exception.ts │ ├── throttler.exception.ts │ └── timeout.exception.ts ├── helpers │ ├── base.backoff.ts │ ├── decorrelated-jitter.backoff.ts │ ├── equal-jitter.backoff.ts │ ├── exponential.backoff.ts │ ├── fibonacci.backoff.ts │ ├── fixed.backoff.ts │ ├── index.ts │ ├── jitter.backoff.ts │ └── linear.backoff.ts ├── index.ts ├── interfaces │ ├── bulkhead-options.interface.ts │ ├── cache-options.interface.ts │ ├── circuit-breaker-options.interface.ts │ ├── dedupe-options.interface.ts │ ├── fallback-options.interface.ts │ ├── health-check-options.interface.ts │ ├── index.ts │ ├── resilience-events.interface.ts │ ├── resilience-module-options.interface.ts │ ├── retry-options.interface.ts │ ├── throttle-options.interface.ts │ └── timeout-options.interface.ts ├── resilience.event-bus.ts ├── resilience.factory.ts ├── resilience.interceptor.ts ├── resilience.module-definition.ts ├── resilience.module.ts ├── resilience.service.ts ├── resilience.states-manager.ts ├── strategies │ ├── base.strategy.ts │ ├── bulkhead.strategy.ts │ ├── cache.strategy.ts │ ├── circuit-breaker.strategy.ts │ ├── dedupe.strategy.ts │ ├── fallback.strategy.ts │ ├── health-check.strategy.ts │ ├── index.ts │ ├── retry.strategy.ts │ ├── throttle.strategy.ts │ └── timeout.strategy.ts └── utils │ ├── index.ts │ ├── random.util.ts │ └── sleep.util.ts ├── test ├── commands │ ├── fixtures │ │ └── strategy.fixture.ts │ ├── resilience-observable.command.spec.ts │ └── resilience.command.spec.ts ├── decorators │ ├── use-resilience-observable.decorator.spec.ts │ └── use-resilience.decorator.spec.ts ├── resilience.event-bus.spec.ts ├── resilience.factory.spec.ts ├── resilience.service.spec.ts └── strategies │ ├── bulkhead.strategy.spec.ts │ ├── cache.strategy.spec.ts │ ├── circuit-breaker.strategy.spec.ts │ ├── dedupe.strategy.spec.ts │ ├── fallback.strategy.spec.ts │ ├── health-check.strategy.spec.ts │ ├── retry.strategy.spec.ts │ ├── throttler.strategy.spec.ts │ └── timeout.strategy.spec.ts ├── tsconfig.build.json ├── tsconfig.json └── yarn.lock /.commitlintrc.json: -------------------------------------------------------------------------------- 1 | { 2 | "extends": [ 3 | "@commitlint/config-angular" 4 | ], 5 | "rules": { 6 | "subject-case": [ 7 | 2, 8 | "always", 9 | [ 10 | "sentence-case", 11 | "start-case", 12 | "pascal-case", 13 | "upper-case", 14 | "lower-case" 15 | ] 16 | ], 17 | "type-enum": [ 18 | 2, 19 | "always", 20 | [ 21 | "build", 22 | "chore", 23 | "ci", 24 | "docs", 25 | "feat", 26 | "fix", 27 | "perf", 28 | "refactor", 29 | "revert", 30 | "style", 31 | "test", 32 | "sample" 33 | ] 34 | ] 35 | } 36 | } 37 | -------------------------------------------------------------------------------- /.editorconfig: -------------------------------------------------------------------------------- 1 | # editorconfig.org 2 | root = true 3 | 4 | [*] 5 | end_of_line = lf 6 | indent_style = tab 7 | charset = utf-8 8 | trim_trailing_whitespace = true 9 | insert_final_newline = true 10 | indent_size = 4 11 | max_line_length = 140 12 | 13 | [*.{yaml,yml}] 14 | indent_style = space 15 | indent_size = 2 16 | 17 | [*.md] 18 | indent_style = space 19 | trim_trailing_whitespace = false 20 | -------------------------------------------------------------------------------- /.gitattributes: -------------------------------------------------------------------------------- 1 | yarn.lock -diff -merge 2 | yarn.lock linguist-generated=true 3 | * text eol=lf 4 | -------------------------------------------------------------------------------- /.github/CODEOWNERS: -------------------------------------------------------------------------------- 1 | * @SocketSomeone 2 | -------------------------------------------------------------------------------- /.github/CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Contributor Covenant Code of Conduct 2 | 3 | ## Our Pledge 4 | 5 | In the interest of fostering an open and welcoming environment, we as 6 | contributors and maintainers pledge to making participation in our project and 7 | our community a harassment-free experience for everyone, regardless of age, body 8 | size, disability, ethnicity, gender identity and expression, level of experience, 9 | nationality, personal appearance, race, religion, or sexual identity and 10 | orientation. 11 | 12 | ## Our Standards 13 | 14 | Examples of behavior that contributes to creating a positive environment 15 | include: 16 | 17 | * Using welcoming and inclusive language 18 | * Being respectful of differing viewpoints and experiences 19 | * Gracefully accepting constructive criticism 20 | * Focusing on what is best for the community 21 | * Showing empathy towards other community members 22 | 23 | Examples of unacceptable behavior by participants include: 24 | 25 | * The use of sexualized language or imagery and unwelcome sexual attention or 26 | advances 27 | * Trolling, insulting/derogatory comments, and personal or political attacks 28 | * Public or private harassment 29 | * Publishing others' private information, such as a physical or electronic 30 | address, without explicit permission 31 | * Other conduct which could reasonably be considered inappropriate in a 32 | professional setting 33 | 34 | ## Our Responsibilities 35 | 36 | Project maintainers are responsible for clarifying the standards of acceptable 37 | behavior and are expected to take appropriate and fair corrective action in 38 | response to any instances of unacceptable behavior. 39 | 40 | Project maintainers have the right and responsibility to remove, edit, or 41 | reject comments, commits, code, wiki edits, issues, and other contributions 42 | that are not aligned to this Code of Conduct, or to ban temporarily or 43 | permanently any contributor for other behaviors that they deem inappropriate, 44 | threatening, offensive, or harmful. 45 | 46 | ## Scope 47 | 48 | This Code of Conduct applies both within project spaces and in public spaces 49 | when an individual is representing the project or its community. Examples of 50 | representing a project or community include using an official project e-mail 51 | address, posting via an official social media account, or acting as an appointed 52 | representative at an online or offline event. Representation of a project may be 53 | further defined and clarified by project maintainers. 54 | 55 | ## Enforcement 56 | 57 | Instances of abusive, harassing, or otherwise unacceptable behavior may be 58 | reported by contacting the project team at socket.someone@gmail.com. All 59 | complaints will be reviewed and investigated and will result in a response that 60 | is deemed necessary and appropriate to the circumstances. The project team is 61 | obligated to maintain confidentiality with regard to the reporter of an incident. 62 | Further details of specific enforcement policies may be posted separately. 63 | 64 | Project maintainers who do not follow or enforce the Code of Conduct in good 65 | faith may face temporary or permanent repercussions as determined by other 66 | members of the project's leadership. 67 | 68 | ## Attribution 69 | 70 | This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, 71 | available at [http://contributor-covenant.org/version/1/4][version] 72 | 73 | [homepage]: http://contributor-covenant.org 74 | [version]: http://contributor-covenant.org/version/1/4/ 75 | -------------------------------------------------------------------------------- /.github/COMMIT_CONVENTION.md: -------------------------------------------------------------------------------- 1 | ## Git Commit Message Convention 2 | 3 | > This is adapted from [Angular's commit convention](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular). 4 | 5 | #### TL;DR: 6 | 7 | Messages must be matched by the following regex: 8 | 9 | ```js 10 | /^(revert: )?(feat|fix|docs|style|refactor|perf|test|workflow|build|ci|chore|types|wip)(\(.+\))?: .{1,72}/; 11 | ``` 12 | 13 | ### Full Message Format 14 | 15 | A commit message consists of a **header**, **body** and **footer**. The header has a **type**, **scope** and **subject**: 16 | 17 | ``` 18 | (): 19 | 20 | 21 | 22 |