Merge pull request #15 from MaksymStoianov/max/next

MaksymStoianov · web-flow · commit 81887f709434 · 2025-09-03T16:02:55.000+02:00
Max/next
diff --git a/README.md b/README.md
diff --git a/src/appsscript/admin/index.ts b/src/appsscript/admin/index.ts
@@ -0,0 +1 @@
+export { isAdmin } from "./isAdmin";
diff --git a/src/appsscript/admin/isAdmin.ts b/src/appsscript/admin/isAdmin.ts
@@ -0,0 +1,28 @@
+import { nonFunction } from "../../base";
+
+/**
+ * ## isAdmin
+ *
+ * Checks if the current user is an administrator of the Google Workspace domain.
+ *
+ * **Note:** Requires the `Admin SDK Directory Service` to be enabled.
+ *
+ * @returns `true` if the user is an administrator; otherwise, `false`.
+ */
+export function isAdmin(): boolean {
+  try {
+    if (nonFunction(AdminDirectory?.Users?.get)) {
+      throw new Error(
+        "Admin SDK Directory Service is not available or not enabled."
+      );
+    }
+
+    const email = Session.getActiveUser().getEmail();
+    const user = AdminDirectory.Users.get(email);
+
+    return !!user.isAdmin;
+  } catch (err: unknown) {
+    console.warn(`[Error]: ${err}`);
+    return false;
+  }
+}
diff --git a/src/appsscript/docs/index.ts b/src/appsscript/docs/index.ts
diff --git a/src/appsscript/drive/index.ts b/src/appsscript/drive/index.ts
diff --git a/src/appsscript/forms/index.ts b/src/appsscript/forms/index.ts
diff --git a/src/appsscript/index.ts b/src/appsscript/index.ts
@@ -1,4 +1,9 @@
+export * from "./admin";
+export * from "./docs";
+export * from "./drive";
+export * from "./forms";
 export * from "./sheets";
+export * from "./slides";
 
 export { checkMultipleAccount } from "./checkMultipleAccount";
 export { getByteSize } from "./getByteSize";
diff --git a/src/appsscript/sheets/index.ts b/src/appsscript/sheets/index.ts
@@ -12,6 +12,7 @@ export { getColumnIndexByLetter } from "./getColumnIndexByLetter";
 export { getColumnLetterByIndex } from "./getColumnLetterByIndex";
 export { getSheetById } from "./getSheetById";
 export { highlightHtml } from "./highlightHtml";
+export { sortSheets } from "./sortSheets";
 
 export { isCellGridRange } from "./isCellGridRange";
 export { isGridRangeContainedIn } from "./isGridRangeContainedIn";
diff --git a/src/appsscript/sheets/sortSheets.ts b/src/appsscript/sheets/sortSheets.ts
@@ -0,0 +1,38 @@
+import { isSpreadsheet } from "./isSpreadsheet";
+
+/**
+ * Sorts all sheets in a spreadsheet alphabetically by name.
+ *
+ * @param spreadsheet - The spreadsheet object.
+ * @param [callback] - An optional callback function for custom sorting.
+ */
+export function sortSheets(
+  spreadsheet: GoogleAppsScript.Spreadsheet.Spreadsheet,
+  callback?: (a: string, b: string) => number
+): void {
+  if (!isSpreadsheet(spreadsheet)) {
+    throw new Error("Spreadsheet object is not valid.");
+  }
+
+  try {
+    const sheets = spreadsheet.getSheets();
+
+    if (sheets.length < 2) {
+      return;
+    }
+
+    const sheetNames = sheets.map(sheet => sheet.getName());
+    sheetNames.sort(callback);
+
+    sheetNames.forEach(function (name, i) {
+      const sheet = spreadsheet.getSheetByName(name);
+
+      if (sheet && sheet.getIndex() !== i + 1) {
+        spreadsheet.setActiveSheet(sheet);
+        spreadsheet.moveActiveSheet(i + 1);
+      }
+    });
+  } catch (err: unknown) {
+    console.error(`Failed to sort sheets: ${err}`);
+  }
+}
diff --git a/src/appsscript/slides/index.ts b/src/appsscript/slides/index.ts
diff --git a/src/base/index.ts b/src/base/index.ts
@@ -9,6 +9,7 @@ export { escapeRegExp } from "./escapeRegExp";
 export { escapeXml } from "./escapeXml";
 
 export { is2DArray } from "./is2DArray";
+export { isArray } from "./isArray";
 export { isBoolean } from "./isBoolean";
 export { isConsistent2DArray } from "./isConsistent2DArray";
 export { isEmail } from "./isEmail";
@@ -34,12 +35,17 @@ export { isValidSlug } from "./isValidSlug";
 export { isValidVersion } from "./isValidVersion";
 export { isVersionCompatible } from "./isVersionCompatible";
 
+export { nonArray } from "./nonArray";
 export { nonBoolean } from "./nonBoolean";
 export { nonEmpty } from "./nonEmpty";
+export { nonFunction } from "./nonFunction";
 export { nonNil } from "./nonNil";
 export { nonNull } from "./nonNull";
 export { nonNumber } from "./nonNumber";
+export { nonScalar } from "./nonScalar";
 export { nonString } from "./nonString";
+export { nonSymbol } from "./nonSymbol";
+export { nonUndefined } from "./nonUndefined";
 
 export { requireNonEmptyString } from "./requireNonEmptyString";
 export { requireNonNull } from "./requireNonNull";
diff --git a/src/base/isArray.ts b/src/base/isArray.ts
@@ -0,0 +1,15 @@
+/**
+ * ## isArray
+ *
+ * Checks if the provided value is an `Array`.
+ *
+ * @template T - The type of elements within the array.
+ * @param   value - The value to check.
+ * @returns `true` if the value is an `Array`; otherwise, `false`.
+ * @see     nonArray
+ * @since   1.4.0
+ * @version 1.0.0
+ */
+export function isArray<T>(value: unknown): value is T[] {
+  return Array.isArray(value);
+}
diff --git a/src/base/isFunction.ts b/src/base/isFunction.ts
@@ -9,6 +9,7 @@ import { ObjectTag } from "./types";
  *
  * @param   value - The value to check.
  * @returns `true` if the value is a function; otherwise, `false`.
+ * @see     nonFunction
  * @see     isFunctionLike
  * @since   1.0.0
  * @version 1.0.0
diff --git a/src/base/isScalar.ts b/src/base/isScalar.ts
@@ -5,9 +5,12 @@
  *
  * @param   value - The value to check.
  * @returns `true` if the value is a scalar type; otherwise, `false`.
+ * @see     nonScalar
  * @since   1.0.0
  * @version 1.0.0
  */
-export function isScalar(value: unknown): boolean {
+export function isScalar(
+  value: unknown
+): value is string | number | boolean | symbol | bigint {
   return /string|number|boolean|symbol|bigint/.test(typeof value);
 }
diff --git a/src/base/isSymbol.ts b/src/base/isSymbol.ts
@@ -5,6 +5,7 @@
  *
  * @param   value - The value to check.
  * @returns `true` if the value is a `Symbol`; otherwise, `false`.
+ * @see     nonSymbol
  * @since   1.0.0
  * @version 1.0.0
  */
diff --git a/src/base/isUndefined.ts b/src/base/isUndefined.ts
@@ -5,6 +5,7 @@
  *
  * @param   value - The value to check.
  * @returns `true` if the value is `undefined`; otherwise, `false`.
+ * @see     nonUndefined
  * @since   1.0.0
  * @version 1.0.0
  */
diff --git a/src/base/nonArray.ts b/src/base/nonArray.ts
@@ -0,0 +1,18 @@
+import { isArray } from "./isArray";
+
+/**
+ * ## nonArray
+ *
+ * Checks if the provided value is NOT `Array`.
+ *
+ * @param   value - The value to check.
+ * @returns `true` if the value is not `Array`; otherwise, `false`.
+ * @see     isArray
+ * @since   1.4.0
+ * @version 1.0.0
+ */
+export function nonArray<T>(
+  value: T | unknown
+): value is Exclude<T | unknown, unknown[] | Array<unknown>> {
+  return !isArray(value);
+}
diff --git a/src/base/nonBoolean.ts b/src/base/nonBoolean.ts
@@ -3,10 +3,10 @@ import { isBoolean } from "./isBoolean";
 /**
  * ## nonBoolean
  *
- * Checks if the provided value is not a boolean.
+ * Checks if the provided value is NOT `boolean`.
  *
  * @param   value - The value to check.
- * @returns `true` if the value is not boolean; otherwise, `false`.
+ * @returns `true` if the value is not `boolean`; otherwise, `false`.
  * @since   1.1.0
  * @version 1.0.0
  */
diff --git a/src/base/nonEmpty.ts b/src/base/nonEmpty.ts
@@ -6,7 +6,7 @@ import { isEmpty } from "./isEmpty";
  * Checks if a value is not considered "empty".
  *
  * @param   value - The value to check.
- * @returns `true` if the value is not empty; otherwise, `false`.
+ * @returns `true` if the value is not "empty"; otherwise, `false`.
  * @see     isEmpty
  * @since   1.1.0
  * @version 1.0.0
diff --git a/src/base/nonFunction.ts b/src/base/nonFunction.ts
@@ -0,0 +1,15 @@
+/**
+ * ## nonFunction
+ *
+ * Checks if the provided value is NOT `function`.
+ *
+ * @param   value - The value to check.
+ * @returns `true` if the value is not `function`; otherwise, `false`.
+ * @see     isFunction
+ * @since   1.4.0
+ * @version 1.0.0
+ */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+export function nonFunction<T>(value: T): value is Exclude<T, Function> {
+  return typeof value !== "function";
+}
diff --git a/src/base/nonNull.ts b/src/base/nonNull.ts
@@ -3,7 +3,7 @@ import { isNull } from "./isNull";
 /**
  * ## nonNull
  *
- * Checks if the provided value is not `null`.
+ * Checks if the provided value is NOT `null`.
  *
  * @param   value - The value to check.
  * @returns `true` if the value is not `null`; otherwise, `false`.
diff --git a/src/base/nonNumber.ts b/src/base/nonNumber.ts
@@ -3,10 +3,10 @@ import { isNumber } from "./isNumber";
 /**
  * ## nonNumber
  *
- * Checks if the provided value is NOT a number.
+ * Checks if the provided value is NOT `number`.
  *
  * @param   value - The value to check.
- * @returns `true` if the value is not a number; otherwise, `false`.
+ * @returns `true` if the value is not `number`; otherwise, `false`.
  * @see     isNumber
  * @since   1.0.0
  * @version 1.1.0
diff --git a/src/base/nonScalar.ts b/src/base/nonScalar.ts
@@ -0,0 +1,18 @@
+import { isScalar } from "./isScalar";
+
+/**
+ * ## nonScalar
+ *
+ * Checks if the provided value is NOT `Scalar`.
+ *
+ * @param   value - The value to check.
+ * @returns `true` if the value is not `Scalar`; otherwise, `false`.
+ * @see     isScalar
+ * @since   1.4.0
+ * @version 1.0.0
+ */
+export function nonScalar<T>(
+  value: T | string | number | boolean | symbol | bigint
+): value is T {
+  return !isScalar(value);
+}
diff --git a/src/base/nonString.ts b/src/base/nonString.ts
@@ -3,11 +3,11 @@ import { isString } from "./isString";
 /**
  * ## nonString
  *
- * Checks if the provided value is NOT a string.
+ * Checks if the provided value is NOT `string`.
  *
  * @param   value - The value to check.
- * @returns `true` if the value is not a string; otherwise, `false`.
- * @see     nonString
+ * @returns `true` if the value is not `string`; otherwise, `false`.
+ * @see     isString
  * @see     requireString
  * @since   1.0.0
  * @version 1.1.0
diff --git a/src/base/nonSymbol.ts b/src/base/nonSymbol.ts
@@ -0,0 +1,16 @@
+import { isSymbol } from "./isSymbol";
+
+/**
+ * ## nonSymbol
+ *
+ * Checks if the provided value is NOT `Symbol`.
+ *
+ * @param   value - The value to check.
+ * @returns `true` if the value is not `Symbol`; otherwise, `false`.
+ * @see     isSymbol
+ * @since   1.4.0
+ * @version 1.0.0
+ */
+export function nonSymbol<T>(value: T | symbol): value is T {
+  return !isSymbol(value);
+}
diff --git a/src/base/nonUndefined.ts b/src/base/nonUndefined.ts
@@ -0,0 +1,16 @@
+import { isUndefined } from "./isUndefined";
+
+/**
+ * ## nonUndefined
+ *
+ * Checks if the provided value is NOT `undefined`.
+ *
+ * @param   value - The value to check.
+ * @returns `true` if the value is not `undefined`; otherwise, `false`.
+ * @see     isUndefined
+ * @since   1.4.0
+ * @version 1.0.0
+ */
+export function nonUndefined<T>(value: T | undefined): value is T {
+  return !isUndefined(value);
+}
