convenient_service 0.15.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86314358470fd8502e3b00853f6f0aed31fe7837fe879b8a6fe9b02b23a37055
-  data.tar.gz: 8c7ddbfa504ef02c2774bbc4c616297345b684320ed0e4b4b10134f2a8851c24
+  metadata.gz: f24d02cddcb69e9108cf7d810c85f4ccf338201b8a31bbc7da0be1ef92bd91a9
+  data.tar.gz: 89c019fa64f6fe8194c9b74a676d367e390cc5cb33efef361a4fcb448cd72d17
 SHA512:
-  metadata.gz: 59dc4c6936c9764718dd105ef24255e89a21397b56770460850fa38365c37d0a4ba7d97bba924c72906f2ba27fc6b66b3981e9f1682a43c22f245e6daa811627
-  data.tar.gz: bc6942d0091fe8805164bfb01b00ed09c2be71ae0ea2838d2958331844053984309600f15151cb33fe261bc76913eed1f5299898b2e95df696020ab5a92e4d9d
+  metadata.gz: a53a4a7fee700e8128eeea830ac57cee73e6a6034d36e61dd224584e06f08ef4d944cdc513bfbac17187866b09969a4f63f31e316745546de032a24965bad6dd
+  data.tar.gz: 47a180d8079468f98eadcfbddc2654323fabeae0d7f8b47febc7c13f80d43d30a30583d7104d60d486b02f6e024155487fe3ce5c20bd1eea39f214ee326dc9ff

data/.github/contributing.md

@@ -0,0 +1,15 @@
+# Contributing
+
+## Legal
+
+By submitting a Pull Request, you disavow any rights or claims to any changes
+submitted to the Convenient Service project and assign the copyright of
+those changes to Convenient Service Organization.
+
+If you cannot or do not want to reassign those rights (your employment
+contract for your employer may not allow this), you should not submit a PR.
+Open an issue and someone else can do the work.
+
+This is a legal way of saying "If you submit a PR to us, that code becomes ours".
+99.9% of the time that's what you intend anyways; we hope it doesn't scare you
+away from contributing.

data/.github/workflows/cd.yml

@@ -30,7 +30,7 @@ jobs:
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.1
+          ruby-version: 3.2
           ##
           # NOTE: Installs the latest compatible Bundler version, runs `bundle install` and caches installed gems.
           # - https://github.com/ruby/setup-ruby#usage
@@ -39,8 +39,8 @@ jobs:
           bundler-cache: true
       ##
       # NOTE: Installs Task (task runner).
-      # https://taskfile.dev/installation/#github-actions
-      # https://github.com/go-task/task
+      # - https://taskfile.dev/installation/#github-actions
+      # - https://github.com/go-task/task
       #
       - name: Install Task (task runner)
         uses: arduino/setup-task@v1
@@ -51,7 +51,8 @@ jobs:
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs
+          publish_dir: ./docs/api
+          cname: apidocs.convenientservice.org
 
   create_github_release:
     runs-on: ubuntu-20.04

data/.github/workflows/ci.yml

@@ -139,8 +139,8 @@ jobs:
           bundler-cache: true
       ##
       # NOTE: Installs Task (task runner).
-      # https://taskfile.dev/installation/#github-actions
-      # https://github.com/go-task/task
+      # - https://taskfile.dev/installation/#github-actions
+      # - https://github.com/go-task/task
       #
       - name: Install Task (task runner)
         uses: arduino/setup-task@v1
@@ -169,10 +169,10 @@ jobs:
           node-version: 16.x
       ##
       # NOTE: `lcov-result-merger` docs.
-      # https://github.com/mweibel/lcov-result-merger
+      # - https://github.com/mweibel/lcov-result-merger
       #
       # NOTE: `npx --yes` option.
-      # https://stackoverflow.com/questions/70742968/automatically-accept-installing-npx-package
+      # - https://stackoverflow.com/questions/70742968/automatically-accept-installing-npx-package
       #
       # NOTE: `lcov-result-merger` uses `vinyl-fs` for globs which in turn uses `node-glob`.
       # - https://github.com/mweibel/lcov-result-merger/blob/v3.3.0/bin/lcov-result-merger.js#L38
@@ -200,7 +200,7 @@ jobs:
     # NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
     # In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
     # That is why the well-known Ubuntu is used.
-    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#choosing-github-hosted-runners
+    # - https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#choosing-github-hosted-runners
     #
     runs-on: ubuntu-20.04
     name: Gather coverage

data/.gitignore

@@ -42,8 +42,17 @@
 #
 .DS_Store
 
-# Ignore docs
+##
+# NOTE: Ignores `docs` content, but NOT the folder.
+#
 /docs/*
+!/docs/.gitkeep
+
+##
+# NOTE: Ignores `docs/api` content, but NOT the folder.
+#
+/docs/api/*
+!/docs/api/.gitkeep
 
 ##
 # NOTE: Ignores `flowchart.html`, that can be generated by `Service.mermaid_flowchart.save`.

data/.ruby-version

@@ -1 +1 @@
-3.1.0
+3.2.0

data/.tool-versions

@@ -1 +1 @@
-ruby 3.1.0
+ruby 3.2.0

data/.yardopts

@@ -9,7 +9,7 @@
 #
 --markup markdown
 --markup-provider commonmarker
---output-dir docs
+--output-dir docs/api
 --tag internal --hide-tag internal
 --plugin convenient_service_concern
 'lib/**/*.rb' -

data/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## [0.17.0](https://github.com/marian13/convenient_service/compare/v0.16.0...v0.17.0) (2024-01-14)
+
+
+### Features
+
+* **backtrace_cleaner:** introduce add_convenient_service_silencer ([07ce10f](https://github.com/marian13/convenient_service/commit/07ce10fbd96c7e6b3074922d0ca8af6547416725))
+* **backtrace_cleaner:** upgrade to Rails 7.1.2 Backtrace Cleaner ([6416691](https://github.com/marian13/convenient_service/commit/6416691d99d3b22544b78ea81aed5a3a4aa513fe))
+* **core:** clean backtrace in method_missing ([0642198](https://github.com/marian13/convenient_service/commit/06421981ccf39d2d0b07f2bce30284c604bba950))
+* **core:** clean backtrace in method_missing ([81d0531](https://github.com/marian13/convenient_service/commit/81d05317d842d9afa2ef7034b34b850034a8f1dd))
+* **core:** clean backtrace in method_missing ([f07c354](https://github.com/marian13/convenient_service/commit/f07c354e8fc14f1062df68f938b9d4b9fa8484c5))
+* **entry:** allow to define multiple entries at once ([a9bca88](https://github.com/marian13/convenient_service/commit/a9bca880da4849866f6afc30b3f099be88834f64))
+* **exception:** allow to pass message or kwargs or no arguments ([a92a040](https://github.com/marian13/convenient_service/commit/a92a04002687c878618479804d0176e69b3d4fa4))
+* **exceptions:** use backtrace_cleaner ([7bc566e](https://github.com/marian13/convenient_service/commit/7bc566e78cfa3fcc28b6b2318ca955ff4d797ce8))
+* **exceptions:** use backtrace_cleaner ([b8d87a5](https://github.com/marian13/convenient_service/commit/b8d87a56cb4afda043ba0de6c1ba3cd967d2aa7c))
+* **feature:** allow to use middlewares for all entries at once ([a2025dc](https://github.com/marian13/convenient_service/commit/a2025dccbf660cdc313f9db7df155ccd7a4cd3b8))
+* **has_instance_proxy:** delegate to target missing proxy methods ([6be8d3b](https://github.com/marian13/convenient_service/commit/6be8d3b6bf556bc2af9ff29a7b0782b352a8effb))
+* **has_instance_proxy:** introduce #inspect ([078d219](https://github.com/marian13/convenient_service/commit/078d21927b1b523b266e85d945f87aa3030de0f4))
+* **has_j_send_result:** expose result? ([f4d5f7f](https://github.com/marian13/convenient_service/commit/f4d5f7fb9afde955295602db022d12f084f60d9e))
+* **has_j_send_status_and_attributes:** introduce #to_bool ([ec5ee1e](https://github.com/marian13/convenient_service/commit/ec5ee1ec0f4a540a109f80e3ffafa1b937d1af60))
+* **root:** introduce ConvenientService.raise and ConvenientService.reraise ([65f0148](https://github.com/marian13/convenient_service/commit/65f0148d052c31c3e305470b2b9daee5c746794e))
+* **root:** introduce ConvenientService.root ([dc5af36](https://github.com/marian13/convenient_service/commit/dc5af365374a76d615fa09613b59bb9cd080bc1b))
+* **support:** add initial backtrace cleaner ([14733f3](https://github.com/marian13/convenient_service/commit/14733f3d5b622c08aec1fe0b80a2b7c5699b4d4f))
+
+
+### Bug Fixes
+
+* **backtrace_cleaner:** resolve JRuby incompatibilites ([3ff9055](https://github.com/marian13/convenient_service/commit/3ff90555a0f78f1ba51fa7c538cc84c7c4e69bdb))
+* **rescues_result_unhandled_exceptions:** fix false-positive test ([e792c01](https://github.com/marian13/convenient_service/commit/e792c01613a74da529f2f7833248527c40f1ac7b))
+* **specs:** remove did_you_mean flakiness ([709faf6](https://github.com/marian13/convenient_service/commit/709faf6c8ac9eb28451f3ea734d5588159481648))
+
+## [0.16.0](https://github.com/marian13/convenient_service/compare/v0.15.0...v0.16.0) (2023-12-05)
+
+
+### Features
+
+* **entry:** allow to use instance method, just like field in graphql-ruby ([ad445fa](https://github.com/marian13/convenient_service/commit/ad445fae5ace9671745b2cacd2f6fae7b5a0e26e))
+
 ## [0.15.0](https://github.com/marian13/convenient_service/compare/v0.14.0...v0.15.0) (2023-11-10)
 
 

data/COMM-LICENSE.txt

@@ -0,0 +1,99 @@
+END-USER LICENSE AGREEMENT
+
+------------------------------------------------------------------------------
+
+IMPORTANT: THIS SOFTWARE END-USER LICENSE AGREEMENT ("EULA") IS A LEGAL AGREEMENT (“Agreement”) BETWEEN YOU (THE CUSTOMER, EITHER AS AN INDIVIDUAL OR, IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY, AS AN ENTITY) AND CONVENIENT SERVICE ORGANIZATION. READ IT CAREFULLY BEFORE COMPLETING THE INSTALLATION PROCESS AND USING CONVENIENT SERVICE PRO AND RELATED SOFTWARE COMPONENTS (“SOFTWARE”). IT PROVIDES A LICENSE TO USE THE SOFTWARE AND CONTAINS WARRANTY INFORMATION AND LIABILITY DISCLAIMERS. BY INSTALLING AND USING THE SOFTWARE, YOU ARE CONFIRMING YOUR ACCEPTANCE OF THE SOFTWARE AND AGREEING TO BECOME BOUND BY THE TERMS OF THIS AGREEMENT.
+
+------------------------------------------------------------------------------
+
+In order to use the Software under this Agreement, you must receive a “Source URL” at the time of purchase, in accordance with the scope of use and other terms specified for each type of Software and as set forth in this Section 1 of this Agreement.
+
+
+1. License Grant.
+
+1.1 General Use. This Agreement grants you a non-exclusive, non-transferable, limited license to the use rights for the Software, without the right to grant sublicenses, subject to the terms and conditions in this Agreement. The Software is licensed, not sold.
+
+1.2 Unlimited Organization License. If you purchased an Organization License (included with the Convenient Service Pro Software), you may install the Software on an unlimited number of Hosts. “Host” means any physical or virtual machine which is controlled by you. You may concurrently run the software on an unlimited number of Hosts.
+
+1.3 Archive Copies. You are entitled to make a reasonable amount of copies of the Software for archival purposes. Each copy must reproduce all copyright and other proprietary rights notices on or in the Software Product.
+
+1.4 Electronic Delivery. All Software and license documentation shall be delivered by electronic means unless otherwise specified on the applicable invoice or at the time of purchase. Software shall be deemed delivered when it is made available for download by you (“Delivery”).
+
+
+2. Modifications. Convenient Service Organization shall provide you with source code so that you can create Modifications of the original software. “Modification” means: (a) any addition to or deletion from the contents of a file included in the original Software or previous Modifications created by You, or (b) any new file that contains any part of the original Software or previous Modifications. While you retain all rights to any original work authored by you as part of the Modifications, We continue to own all copyright and other intellectual property rights in the Software.
+
+
+3. Restricted Uses.
+
+3.1 You shall not (and shall not allow any third party to): (a) decompile, disassemble, or otherwise reverse engineer the Software or attempt to reconstruct or discover any source code, underlying ideas, algorithms, file formats or programming interfaces of the Software by any means whatsoever (except and only to the extent that applicable law prohibits or restricts reverse engineering restrictions); (b) distribute, sell, sublicense, rent, lease or use the Software for time sharing, hosting, service provider or like purposes, except as expressly permitted under this Agreement; (c) redistribute the Software or Modifications other than by including the Software or a portion thereof within your own product, which must have substantially different functionality than the Software or Modifications and must not allow any third party to use the Software or Modifications, or any portions thereof, for software development or application development purposes; (d) redistribute the Software as part of a product, "appliance" or "virtual server"; (e) redistribute the Software on any server which is not directly under your control; (f) remove any product identification, proprietary, copyright or other notices contained in the Software; (g) modify any part of the Software, create a derivative work of any part of the Software (except as permitted in Section 4), or incorporate the Software, except to the extent expressly authorized in writing by Convenient Service Organization; (h) publicly disseminate performance information or analysis (including, without limitation, benchmarks) from any source relating to the Software; (i) utilize any equipment, device, software, or other means designed to circumvent or remove any form of Source URL or copy protection used by Convenient Service Organization in connection with the Software, or use the Software together with any authorization code, Source URL, serial number, or other copy protection device not supplied by Convenient Service Organization; (j) use the Software to develop a product which is competitive with any Convenient Service Organization product offerings; or (k) use unauthorized Source URLS or keycode(s) or distribute or publish Source URLs or keycode(s), except as may be expressly permitted by Convenient Service Organization in writing. If your unique Source URL is ever published, Convenient Service Organization reserves the right to terminate your access without notice.
+
+3.2 UNDER NO CIRCUMSTANCES MAY YOU USE THE SOFTWARE AS PART OF A PRODUCT OR SERVICE THAT PROVIDES SIMILAR FUNCTIONALITY TO THE SOFTWARE ITSELF.
+
+The Open Source version of the Software (“LGPL Version”) is licensed
+under the terms of the GNU Lesser General Public License version 3.0
+(“LGPL”) and not under this EULA.
+
+
+4. Ownership. Notwithstanding anything to the contrary contained herein, except for the limited license rights expressly provided herein, Convenient Service Organization and its suppliers have and will retain all rights, title and interest (including, without limitation, all patent, copyright, trademark, trade secret and other intellectual property rights) in and to the Software and all copies, modifications and derivative works thereof (including any changes which incorporate any of your ideas, feedback or suggestions). You acknowledge that you are obtaining only a limited license right to the Software, and that irrespective of any use of the words “purchase”, “sale” or like terms hereunder no ownership rights are being conveyed to you under this Agreement or otherwise.
+
+
+5. Fees and Payment. The Software license fees will be due and payable in full as set forth in the applicable invoice or at the time of purchase. If the Software does not function properly within two weeks of purchase, please contact us within those two weeks for a refund. You shall be responsible for all taxes, withholdings, duties and levies arising from the order (excluding taxes based on the net income of Convenient Service Organization).
+
+
+6. Support, Maintenance and Services. Subject to the terms and conditions of this Agreement, as set forth in your invoice, and as set forth on the Convenient Service Pro support page, support and maintenance services may be included with the purchase of your license subscription.
+
+
+7. Term of Agreement.
+
+7.1 Term. This Agreement is effective as of the Delivery of the Software and expires at such time as all license and service subscriptions hereunder have expired in accordance with their own terms (the “Term”). For clarification, the term of your license under this Agreement may be perpetual, limited for Evaluation Version, or designated as a fixed-term license in the Invoice, and shall be specified at your time of purchase. Either party may terminate this Agreement (including all related Invoices) if the other party: (a) fails to cure any material breach of this Agreement within thirty (30) days after written notice of such breach, provided that Convenient Service Organization may terminate this Agreement immediately upon any breach of Section 3 or if you exceed any other restrictions contained in Section 1, unless otherwise specified in this agreement; (b) ceases operation without a successor; or (c) seeks protection under any bankruptcy, receivership, trust deed, creditors arrangement, composition or comparable proceeding, or if any such proceeding is instituted against such party (and not dismissed within sixty (60) days). Termination is not an exclusive remedy and the exercise by either party of any remedy under this Agreement will be without prejudice to any other remedies it may have under this Agreement, by law, or otherwise.
+
+7.2 Termination. Upon any termination of this Agreement, you shall cease any and all use of any Software and destroy all copies thereof.
+
+7.3 Expiration of License. Upon the expiration of any term under this Agreement, (a) all Software updates and services pursuant to the license shall cease, (b) you may only continue to run existing installations of the Software, (c) you may not install the Software on any additional Hosts, and (d) any new installation of the Software shall require the purchase of a new license subscription from Convenient Service Organization.
+
+
+8. Disclaimer of Warranties. The Software is provided "as is," with all faults, defects and errors, and without warranty of any kind. Convenient Service Organization does not warrant that the Software will be free of bugs, errors, viruses or other defects, and Convenient Service Organization shall have no liability of any kind for the use of or inability to use the Software, the Software content or any associated service, and you acknowledge that it is not technically practicable for Convenient Service Organization to do so.
+To the maximum extent permitted by applicable law, Convenient Service Organization disclaims all warranties, express, implied, arising by law or otherwise, regarding the Software, the Software content and their respective performance or suitability for your intended use, including without limitation any implied warranty of merchantability, fitness for a particular purpose.
+
+
+9. Limitation of Liability.
+
+In no event will Convenient Service Organization be liable for any direct, indirect, consequential, incidental, special, exemplary, or punitive damages or liabilities whatsoever arising from or relating to the Software, the Software content or this Agreement, whether based on contract, tort (including negligence), strict liability or other theory, even if Convenient Service Organization has been advised of the possibility of such damages.
+
+In no event will Convenient Service Organization' liability exceed the Software license price as indicated in the invoice. The existence of more than one claim will not enlarge or extend this limit.
+
+
+10. Remedies. Your exclusive remedy and Convenient Service Organization' entire liability for breach of this Agreement shall be limited, at Convenient Service Organization' sole and exclusive discretion, to (a) replacement of any defective software or documentation; or (b) refund of the license fee paid to Convenient Service Organization, payable in accordance with Convenient Service Organization' refund policy.
+
+
+11. Acknowledgements.
+
+11.1 Consent to the Use of Data. You agree that Convenient Service Organization and its affiliates may collect and use technical information gathered as part of the product support services. Convenient Service Organization may use this information solely to improve products and services and will not disclose this information in a form that personally identifies you.
+
+11.2 Verification. We or a certified auditor acting on our behalf, may, upon its reasonable request and at its expense, audit you with respect to the use of the Software. Such audit may be conducted by mail, electronic means or through an in-person visit to your place of business. Any such in-person audit shall be conducted during regular business hours at your facilities and shall not unreasonably interfere with your business activities. We shall not remove, copy, or redistribute any electronic material during the course of an audit. If an audit reveals that you are using the Software in a way that is in material violation of the terms of the EULA, then you shall pay our reasonable costs of conducting the audit. In the case of a material violation, you agree to pay Us any amounts owing that are attributable to the unauthorized use. In the alternative, We reserve the right, at our sole option, to terminate the licenses for the Software.
+
+
+12. Third Party Software. Examples included in Software may provide links to third party libraries or code (collectively “Third Party Software”) to implement various functions. Third Party Software does not comprise part of the Software. In some cases, access to Third Party Software may be included along with the Software delivery as a convenience for demonstration purposes. Such source code and libraries may be included in the “…/examples” source tree delivered with the Software and do not comprise the Software. Licensee acknowledges (1) that some part of Third Party Software may require additional licensing of copyright and patents from the owners of such, and (2) that distribution of any of the Software referencing or including any portion of a Third Party Software may require appropriate licensing from such third parties.
+
+
+13. Miscellaneous
+
+13.1 Entire Agreement. This Agreement sets forth our entire agreement with respect to the Software and the subject matter hereof and supersedes all prior and contemporaneous understandings and agreements whether written or oral.
+
+13.2 Amendment. Convenient Service Organization reserves the right, in its sole discretion, to amend this Agreement from time. Amendments to this Agreement can be located at: https://github.com/marian13/convenient_service/blob/main/COMM-LICENSE.txt.
+
+13.3 Assignment. You may not assign this Agreement or any of its rights under this Agreement without the prior written consent of Convenient Service Organization and any attempted assignment without such consent shall be void.
+
+13.4 Export Compliance. You agree to comply with all applicable laws and regulations, including laws, regulations, orders or other restrictions on export, re-export or redistribution of software.
+
+13.5 Indemnification. You agree to defend, indemnify, and hold harmless Convenient Service Organization from and against any lawsuits, claims, losses, damages, fines and expenses (including attorneys' fees and costs) arising out of your use of the Software or breach of this Agreement.
+
+13.6 Attorneys' Fees and Costs. The prevailing party in any action to enforce this Agreement will be entitled to recover its attorneys' fees and costs in connection with such action.
+
+13.7 Severability. If any provision of this Agreement is held by a court of competent jurisdiction to be invalid, illegal, or unenforceable, the remainder of this Agreement will remain in full force and effect.
+
+13.8 Waiver. Failure or neglect by either party to enforce at any time any of the provisions of this licence Agreement shall not be construed or deemed to be a waiver of that party's rights under this Agreement.
+
+13.9 Headings. The headings of sections and paragraphs of this Agreement are for convenience of reference only and are not intended to restrict, affect or be of any weight in the interpretation or construction of the provisions of such sections or paragraphs.
+
+14. Contact Information. If you have any questions about this EULA, or if you want to contact Convenient Service Organization for any reason, please direct correspondence to info@convenientservice.org.

data/LICENSE.txt

@@ -1,21 +1,9 @@
-The MIT License (MIT)
+Copyright (c) Convenient Service Organization
 
-Copyright (c) 2022-2023 Marian Kostyk
+Convenient Service is an Open Source project licensed under the terms of
+the LGPLv3 license. Please see <http://www.gnu.org/licenses/lgpl-3.0.html>
+for license text.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+Convenient Service Pro has a commercial-friendly license.
+You can find the commercial license in COMM-LICENSE.txt.
+Please see https://convenientservice.org for purchasing options.

data/README.md

@@ -49,7 +49,7 @@ This library is under heavy development. Public API may be subject to change. Th
 
 - Visit the [All-in-One Presentation](https://marian13.github.io/static_content/convenient_service/presentations/all_in_one) to get a quick overview.
 
-- Check out [Convenient Service Official User Docs](https://marian13.github.io/convenient_service_docs) for installation, requirements, and usage guides.
+- Check out [Convenient Service Official User Docs](https://userdocs.convenientservice.org/) for installation, requirements, and usage guides.
 
 - Read [the API docs](https://marian13.github.io/convenient_service) to get familiar with the newest functionality that is not documented yet.
 

data/ROADMAP.md

@@ -10,13 +10,13 @@
 | Medium | 🚧 | [Rails Current Attributes integration](https://api.rubyonrails.org/classes/ActiveSupport/CurrentAttributes.html) to cache repeated results | |
 | Low | 🚧 | [Capybara](https://github.com/teamcapybara/capybara) examples | |
 | Medium | 🚧 | Inline step sequence | |
-| High | 🚧 | Move callbacks to internals | |
+| High | 🚧 | Move callbacks to internals | In order to NOT pollute the public interface of users services |
 | Low | 🚧 | Create an example of `id_or_record` [attribute](https://api.rubyonrails.org/classes/ActiveRecord/Attributes/ClassMethods.html) |
 | Low | 🚧 | GitHub Wiki/Gists for Support | |
 | Low | 🚧 | Contribute to Shoulda Matchers | |
 | High | ✅ | `respond_to_missing?` | [ConvenientService::Core::ClassMethods#respond_to_missing?](https://github.com/marian13/convenient_service/blob/main/lib/convenient_service/core/class_methods.rb#L105), [ConvenientService::Core::InstanceMethods#respond_to_missing?](https://github.com/marian13/convenient_service/blob/main/lib/convenient_service/core/instance_methods.rb#L30) |
 | High | ⏳ | Custom matcher to track `ConvenientService::Logger` messages | |
-| Medium | 🚧 | Remove `respond_to?` from `Copyable` | Investigate before making any decision |
+| Medium | ✅ | Remove `respond_to?` from `Copyable` | [7d2a676c171d201301f1c35d498c3b1caf8579b1](https://github.com/marian13/convenient_service/commit/7d2a676c171d201301f1c35d498c3b1caf8579b1) |
 | High | 🚧 | Unified `inspect` | Remove `internals` from inspect, ivars wrapperd by double underscore |
 | High | ✅ | Remove race condition for `method_missing` | https://github.com/marian13/convenient_service/pull/5 |
 | High | ✅ | Remove incompatiility of [Module#include](https://gist.github.com/marian13/9c25041f835564e945d978839097d419) | https://github.com/marian13/convenient_service/pull/3 |
@@ -27,12 +27,12 @@
 | Medium | ✅ | A way to check if block has one required positional argument | [#proc_has_one_positional_argument?](https://github.com/marian13/convenient_service/blob/main/lib/convenient_service/utils/proc/exec_config.rb#L96) |
 | Low | 🚧 | Define method middleware caller with visibility | |
 | Low | 🚧 | Dependency containers to remove high coupling | |
-| Low | 🚧 | Measure performance | |
-| Low | 🚧 | Rewrite middleware backend to count [convenient_service](https://github.com/marian13/convenient_service) specifics | |
+| Low | 🚧 | Measure performance | See [benchmark](https://github.com/marian13/convenient_service/tree/main/benchmark) |
+| Low | 🚧 | Write [Convenient Service](https://github.com/marian13/convenient_service) specific middleware backend | |
 | High | 🚧 | Optimize `stack.dup` in `MethodMiddlewares#call` | Core v3 |
 | Medium | 🚧 | Make a decision of what to do with `printable_block` in custom RSpec matchers | |
 | Medium | 🚧 | User-friendly exception messages | |
-| High | 🚧 | Factory for POROs in specs ❗❗❗ | Start with `result_class`, `class self::Result`, `service_class`, `step_class`, `organizer_class` |
+| High | ❌ | Factory for POROs in specs ❗❗❗ | Proxy config antipattern |
 | High | 🚧 | Resolve warning during specs | |
 | Medium | 🚧 | Consider to change/rewrite `delegate` backend to minify its interface | |
 | Medium | 🚧 | Same order of attr macros, delegators, initialize, class methods, attr methods, queries, actions, `to_*`, comparison, inspect | |
@@ -78,8 +78,15 @@
 | High | 🚧 | Add specs for `WrappedMethod#call` | |
 | High | 🚧 | Check whether ignoring the error was used properly | |
 | High | 🚧 | Steps are great for `and` logic, but what to do with `or` logic? | Create the third service | |
-| High | 🚧 | Steps are great for `and` logic, but what to do with `case when` logic? | Create the third service | | 
+| High | 🚧 | Steps are great for `and` logic, but what to do with `case when` logic? | Create the third service | |
 | High | 🚧 | Cacing of services | It is relatively simple to add caching for steps, but not for all services, since steps are managed by framework | |
 | High | 🚧 | Fallback should return result with already checked status |  |
+| Medium | 🚧 | Licence: Commercial Support docs | See [Sidekiq Commercial Support](https://github.com/sidekiq/sidekiq/wiki/Commercial-Support) |
+| Meduim | 🚧 | Licence: Acknowledgements - Government End Users | See [GraphQL Ruby Commercial Licence](https://graphql.pro/COMM-LICENSE.html) |
+| Medium | 🚧 | Licence: Applicable Law and Jurisdiction (Miscellaneous - Governing Law) | See [Kiba Applicable Law and Jurisdiction](https://github.com/thbar/kiba/blob/master/COMM-LICENSE.md) |
+| Medium | 🚧 | Licence: Contact email `info@convenientservice.org` | |
+| Medium | 🚧 | Contributing Guide | See [Sidekiq Contributing](https://github.com/sidekiq/sidekiq/blob/main/.github/contributing.md) |
+| High | 🚧 | `comparing_by` for `delegate_to` | |
+| High | 🚧 | Remove extra files from bundled gem version | |
 
-Search for `TODO`s in the codebase for more tasks.
+Search for `TODO`s in the codebase or check [discussions](https://github.com/marian13/convenient_service/discussions) for more tasks.

data/convenient_service.gemspec

@@ -72,10 +72,15 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "byebug", "~> 10.0" unless ConvenientService::Support::Ruby.jruby?
 
   ##
+  # Used for parsing Markdown in YARD docs.
+  # - https://github.com/gjtorikian/commonmarker
+  #
   # NOTE: `commonmarker` has C extensions, that is why it is NOT supported in JRuby.
   # - https://github.com/gjtorikian/commonmarker/tree/main/ext/commonmarker
   #
-  spec.add_development_dependency "commonmarker" unless ConvenientService::Support::Ruby.jruby?
+  # TODO: `commonmarker` v1 does NOT work with `yard-junk`.
+  #
+  spec.add_development_dependency "commonmarker", "~> 0.23.10" unless ConvenientService::Support::Ruby.jruby?
 
   ##
   # Used for debugging CRuby code.
@@ -122,8 +127,13 @@ Gem::Specification.new do |spec|
   # - https://github.com/mbj/mutant/blob/main/docs/mutant-rspec.md
   # - https://github.com/mbj/mutant/blob/main/docs/incremental.md
   #
-  spec.add_development_dependency "mutant", "~> 0.11.21"
-  spec.add_development_dependency "mutant-rspec", "~> 0.11.21"
+  # NOTE: How to get a licence key?
+  # - https://github.com/mbj/mutant/issues/1396
+  #
+  if ::ENV["CONVENIENT_SERVICE_MUTANT_LICENCE_KEY"]
+    spec.add_development_dependency "mutant", "~> 0.11.21"
+    spec.add_development_dependency "mutant-rspec", "~> 0.11.21"
+  end
 
   ##
   # Used for coloring logs.
@@ -190,9 +200,18 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "webrick"
 
-  spec.add_development_dependency "yard", "~> 0.9.28"
+  ##
+  # Used for generation of API docs for Ruby code.
+  # - https://github.com/lsegal/yard
+  # - https://yardoc.org
+  #
+  spec.add_development_dependency "yard", "~> 0.9.34"
 
-  spec.add_development_dependency "yard-junk"
+  ##
+  # Used for linting YARD docs.
+  # - https://github.com/zverok/yard-junk
+  #
+  spec.add_development_dependency "yard-junk", "~> 0.0.9"
 
   ##
   # The following gems are Convenient Service alternatives.

data/lib/convenient_service/common/plugins/can_have_user_provided_entity/commands/find_or_create_entity.rb

@@ -32,8 +32,8 @@ module ConvenientService
             # @return [void]
             #
             def call
-              raise Exceptions::ProtoEntityHasNoName.new(proto_entity: proto_entity) unless proto_entity_name
-              raise Exceptions::ProtoEntityHasNoConcern.new(proto_entity: proto_entity) unless proto_entity_concern
+              ::ConvenientService.raise Exceptions::ProtoEntityHasNoName.new(proto_entity: proto_entity) unless proto_entity_name
+              ::ConvenientService.raise Exceptions::ProtoEntityHasNoConcern.new(proto_entity: proto_entity) unless proto_entity_concern
 
               entity.include Core
 
@@ -71,6 +71,11 @@ module ConvenientService
               #
               entity.class_exec(proto_entity) do |proto_entity|
                 define_singleton_method(:proto_entity) { proto_entity }
+
+                ##
+                # @internal
+                #   TODO: Try `self.proto_entity == other.proto_entity if self < proto_entity_concern`.
+                #
                 define_singleton_method(:==) { |other| self.proto_entity == other.proto_entity if other.respond_to?(:proto_entity) }
 
                 ##

data/lib/convenient_service/common/plugins/can_have_user_provided_entity/exceptions.rb

@@ -6,7 +6,7 @@ module ConvenientService
       module CanHaveUserProvidedEntity
         module Exceptions
           class ProtoEntityHasNoName < ::ConvenientService::Exception
-            def initialize(proto_entity:)
+            def initialize_with_kwargs(proto_entity:)
               message = <<~TEXT
                 Proto entity `#{proto_entity}` has no name.
 
@@ -18,12 +18,12 @@ module ConvenientService
                 NOTE: Anonymous classes do NOT have names. Are you passing an anonymous class?
               TEXT
 
-              super(message)
+              initialize(message)
             end
           end
 
           class ProtoEntityHasNoConcern < ::ConvenientService::Exception
-            def initialize(proto_entity:)
+            def initialize_with_kwargs(proto_entity:)
               message = <<~TEXT
                 Proto entity `#{proto_entity}` has no concern.
 
@@ -32,7 +32,7 @@ module ConvenientService
                 It is an example of a valid proto entity.
               TEXT
 
-              super(message)
+              initialize(message)
             end
           end
         end

data/lib/convenient_service/common/plugins/has_around_callbacks/exceptions.rb

@@ -6,7 +6,7 @@ module ConvenientService
       module HasAroundCallbacks
         module Exceptions
           class AroundCallbackChainIsNotContinued < ::ConvenientService::Exception
-            def initialize(callback:)
+            def initialize_with_kwargs(callback:)
               message = <<~TEXT
                 Around callback chain is NOT continued from `#{callback.block.source_location}`.
 
@@ -19,7 +19,7 @@ module ConvenientService
                 end
               TEXT
 
-              super(message)
+              initialize(message)
             end
           end
         end

data/lib/convenient_service/common/plugins/has_around_callbacks/middleware.rb

@@ -123,12 +123,12 @@ module ConvenientService
             ##
             #
             #
-            raise Exceptions::AroundCallbackChainIsNotContinued.new(callback: Utils::Array.find_last(around_callbacks, &:called?)) if around_callbacks.any?(&:not_called?)
+            ::ConvenientService.raise Exceptions::AroundCallbackChainIsNotContinued.new(callback: Utils::Array.find_last(around_callbacks, &:called?)) if around_callbacks.any?(&:not_called?)
 
             ##
             #
             #
-            raise Exceptions::AroundCallbackChainIsNotContinued.new(callback: around_callbacks.last) if initial_around_callback.not_called?
+            ::ConvenientService.raise Exceptions::AroundCallbackChainIsNotContinued.new(callback: around_callbacks.last) if initial_around_callback.not_called?
 
             original_value
           end

data/lib/convenient_service/common/plugins/has_instance_proxy/commands/create_instance_proxy_class.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Common
+    module Plugins
+      module HasInstanceProxy
+        module Commands
+          class CreateInstanceProxyClass < Support::Command
+            ##
+            # @!attribute [r] target_class
+            #   @return [Class]
+            #
+            attr_reader :target_class
+
+            ##
+            # @param target_class [Class]
+            # @return [void]
+            #
+            def initialize(target_class:)
+              @target_class = target_class
+            end
+
+            ##
+            # @return [void]
+            #
+            def call
+              klass = ::Class.new(Entities::InstanceProxy)
+
+              ##
+              # @example Result for feature.
+              #
+              #   klass = ConvenientService::Common::Plugins::HasInstanceProxy::Commands::CreateInstanceProxyClass.call(
+              #     target_class: SomeFeature
+              #   )
+              #
+              #   ##
+              #   # `klass` is something like:
+              #   #
+              #   # class InstanceProxy < ConvenientService::Service::Plugins::HasInstanceProxy::Entities::InstanceProxy
+              #   #   class << self
+              #   #     def target_class
+              #   #       ##
+              #   #       # NOTE: Returns `target_class` passed to `CreateInstanceProxyClass`.
+              #   #       #
+              #   #       target_class
+              #   #     end
+              #   #
+              #   #     def ==(other)
+              #   #       return unless other.respond_to?(:target_class)
+              #   #
+              #   #       self.target_class == other.target_class
+              #   #     end
+              #   #   end
+              #   # end
+              #
+              klass.class_exec(target_class) do |target_class|
+                ##
+                # @return [Class]
+                #
+                define_singleton_method(:target_class) { target_class }
+
+                ##
+                # @return [Boolean, nil]
+                #
+                # @internal
+                #   TODO: Try `self.target_class == other.target_class if self < ::ConvenientService::Common::Plugins::HasInstanceProxy::Entities::InstanceProxy`.
+                #
+                define_singleton_method(:==) { |other| self.target_class == other.target_class if other.respond_to?(:target_class) }
+
+                ##
+                # @return [String]
+                #
+                define_singleton_method(:inspect) { "#{target_class}::InstanceProxy" }
+              end
+
+              klass
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/common/plugins/has_instance_proxy/commands.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "commands/create_instance_proxy_class"