feat(globals): add String.athenna for includesSome and includesEvery

Author: RobsonTrasel

src/globals/String.ts

@@ -0,0 +1,58 @@
+/**
+ * @athenna/common
+ *
+ * (c) Robson Trasel <robson@athenna.io>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { String } from '#src/helpers/String'
+
+export class AthennaString {
+  public constructor(private value: string) {}
+
+  /**
+   * Check if at least one of the provided search strings
+   * is included in the given string value.
+   *
+   * @example
+   * ```ts
+   * 'Hello model.id'.athenna.includesSome('models.id', 'models.provider') // false
+   * 'Hello models.id'.athenna.includesSome(['models.id', 'provider']) // true
+   * ```
+   */
+  public includesSome(...searches: (string | string[])[]): boolean {
+    return String.includesSome(this.value, ...searches)
+  }
+
+  /**
+   * Check if every provided search string is included
+   * in the given string value.
+   *
+   * @example
+   * ```ts
+   * 'Hello model.id'.athenna.includesEvery('models.id', 'models.provider') // false
+   * 'Hello model.id'.athenna.includesEvery(['model.id', 'Hello']) // true
+   * ```
+   */
+  public includesEvery(...searches: (string | string[])[]): boolean {
+    return String.includesEvery(this.value, ...searches)
+  }
+}
+
+declare global {
+  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
+  interface String {
+    athenna: AthennaString
+  }
+}
+
+if (!String.prototype.athenna) {
+  // eslint-disable-next-line no-extend-native
+  Object.defineProperty(String.prototype, 'athenna', {
+    get: function () {
+      return new AthennaString(this)
+    }
+  })
+}

src/index.ts

@@ -14,6 +14,7 @@ export * from '#src/constants/alphabet'
 export * from '#src/globals/Enum'
 export * from '#src/globals/Error'
 export * from '#src/globals/Array'
+export * from '#src/globals/String'
 
 export * from '#src/helpers/Exception'
 export * from '#src/helpers/Clean'

tests/unit/globals/StringTest.ts

@@ -0,0 +1,62 @@
+/**
+ * @athenna/common
+ *
+ * (c) Robson Trasel <robson@athenna.io>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { Test, type Context } from '@athenna/test'
+
+export default class GlobalStringTest {
+  @Test()
+  public async shouldReturnTrueIfAtLeastOneTermMatchesUsingMultipleParams({ assert }: Context) {
+    const value = 'Hello model.id and some other text'
+
+    assert.isTrue(value.athenna.includesSome('model.id', 'nope'))
+    assert.isTrue(value.athenna.includesSome('some', 'anything'))
+    assert.isFalse(value.athenna.includesSome('not-found', 'nope'))
+  }
+
+  @Test()
+  public async shouldReturnTrueIfAtLeastOneTermMatchesUsingAnArray({ assert }: Context) {
+    const value = 'Hello model.id and some other text'
+
+    assert.isTrue(value.athenna.includesSome(['model.id', 'random']))
+    assert.isFalse(value.athenna.includesSome(['aaa', 'bbb']))
+  }
+
+  @Test()
+  public async shouldReturnFalseForIncludesSomeWithEmptyTerms({ assert }: Context) {
+    const value = 'anything'
+
+    assert.isFalse(value.athenna.includesSome())
+    assert.isFalse(value.athenna.includesSome([]))
+  }
+
+  @Test()
+  public async shouldReturnTrueOnlyIfAllTermsMatchUsingMultipleParams({ assert }: Context) {
+    const value = 'Hello model.id and some text'
+
+    assert.isFalse(value.athenna.includesEvery('Hello', 'somethingElse'))
+    assert.isTrue(value.athenna.includesEvery('Hello', 'model.id'))
+    assert.isFalse(value.athenna.includesEvery('model.id', 'not-found'))
+  }
+
+  @Test()
+  public async shouldReturnTrueOnlyIfAllTermsMatchUsingAnArray({ assert }: Context) {
+    const value = 'Hello model.id and some text'
+
+    assert.isTrue(value.athenna.includesEvery(['Hello', 'model.id']))
+    assert.isFalse(value.athenna.includesEvery(['Hello', 'random']))
+  }
+
+  @Test()
+  public async shouldReturnTrueForIncludesEveryWithEmptyTerms({ assert }: Context) {
+    const value = 'anything'
+
+    assert.isTrue(value.athenna.includesEvery())
+    assert.isTrue(value.athenna.includesEvery([]))
+  }
+}