feat(appsscript/admin/isAdmin): Add isAdmin utility function

Author: MaksymStoianov

README.md

@@ -46,7 +46,7 @@ Functions specifically designed for Google Apps Script environments, including u
 <details open><summary>Functions</summary>
 
 | Function                                                         | Description                                                                                                       |
-|:-----------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------------|
+| :--------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------- |
 | [`checkMultipleAccount`](src/appsscript/checkMultipleAccount.ts) | Checks if multiple Google accounts are in use.                                                                    |
 | [`getByteSize`](src/appsscript/getByteSize.ts)                   | Returns the size of a string in bytes.                                                                            |
 | [`isHtmlOutput`](src/appsscript/isHtmlOutput.ts)                 | Checks if an object is an [`HtmlOutput`](https://developers.google.com/apps-script/reference/html/html-output).   |
@@ -62,7 +62,7 @@ A collection of functions to simplify working with Google Sheets.
 <details open><summary>Functions</summary>
 
 | Function                                                                          | Description                                                                                                                      |
-|:----------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------|
+| :-------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |
 | [`appendColumn`](src/appsscript/sheets/appendColumn.ts)                           | Appends a single column of data to the sheet.                                                                                    |
 | [`appendColumns`](src/appsscript/sheets/appendColumns.ts)                         | Appends multiple columns of data to the sheet.                                                                                   |
 | [`appendRow`](src/appsscript/sheets/appendRow.ts)                                 | Appends a single row of data to the sheet.                                                                                       |
@@ -102,7 +102,7 @@ General utility functions that can be useful in any JavaScript/TypeScript projec
 <details open><summary>Functions</summary>
 
 | Function                                                     | Description                                                                                    |
-|:-------------------------------------------------------------|:-----------------------------------------------------------------------------------------------|
+| :----------------------------------------------------------- | :--------------------------------------------------------------------------------------------- |
 | [`chunk`](src/base/chunk.ts)                                 | Splits an array into chunks of a specified size.                                               |
 | [`decodeHtml`](src/base/decodeHtml.ts)                       | Decodes HTML entities.                                                                         |
 | [`encodeHtml`](src/base/encodeHtml.ts)                       | Encodes a string for safe use in HTML.                                                         |
@@ -139,6 +139,7 @@ General utility functions that can be useful in any JavaScript/TypeScript projec
 | [`nonArray`](src/base/nonArray.ts) 🆕                        | Returns `true` if not `Array`.                                                                 |
 | [`nonBoolean`](src/base/nonBoolean.ts) 🆕                    | Returns `true` if not `boolean`.                                                               |
 | [`nonEmpty`](src/base/nonEmpty.ts) 🆕                        | Returns `true` if not "empty".                                                                 |
+| [`nonFunction`](src/base/nonFunction.ts) 🆕                  | Returns `true` if not `Function`.                                                              |
 | [`nonNil`](src/base/nonNil.ts)                               | Returns `true` if not `null` or `undefined`.                                                   |
 | [`nonNull`](src/base/nonNull.ts)                             | Returns `true` if not `null`.                                                                  |
 | [`nonNumber`](src/base/nonNumber.ts)                         | Returns `true` if not a `number`.                                                              |
@@ -172,7 +173,7 @@ A set of custom exception classes for more specific error handling.
 <details open><summary>Functions</summary>
 
 | Exception                                                                      | Description                         |
-|:-------------------------------------------------------------------------------|:------------------------------------|
+| :----------------------------------------------------------------------------- | :---------------------------------- |
 | [`Exception`](src/exceptions/Exception.ts)                                     | Base exception class.               |
 | [`RuntimeException`](src/exceptions/RuntimeException.ts)                       | Exception for runtime errors.       |
 | [`EmptyStringException`](src/exceptions/EmptyStringException.ts)               | Exception for empty strings.        |
@@ -189,7 +190,7 @@ Functions for working with file paths and URLs.
 <details open><summary>Functions</summary>
 
 | Function                                     | Description                                                     |
-|:---------------------------------------------|:----------------------------------------------------------------|
+| :------------------------------------------- | :-------------------------------------------------------------- |
 | [`isAbsolute`](src/path/isAbsolute.ts)       | Checks if a path is absolute.                                   |
 | [`isRelative`](src/path/isRelative.ts)       | Checks if a path is relative.                                   |
 | [`isValidDomain`](src/path/isValidDomain.ts) | Checks if a string is a valid domain name.                      |
@@ -204,15 +205,15 @@ Functions for working with file paths and URLs.
 <details open><summary>Functions</summary>
 
 | Abstract                         | Description |
-|:---------------------------------|:------------|
+| :------------------------------- | :---------- |
 | [`Class`](src/abstract/Class.ts) |             |
 
 </details>
 
 <details open><summary>Functions</summary>
 
 | Interface                                | Description              |
-|:-----------------------------------------|:-------------------------|
+| :--------------------------------------- | :----------------------- |
 | [`Iterator`](src/interfaces/Iterator.ts) | Interface for iterators. |
 
 </details>

src/appsscript/admin/index.ts

@@ -0,0 +1 @@
+export { isAdmin } from "./isAdmin";

src/appsscript/admin/isAdmin.ts

@@ -0,0 +1,27 @@
+import { nonFunction } from "../../base";
+
+/**
+ * ## isAdmin
+ *
+ * Checks if the current user is an administrator of the Google Workspace domain.
+ * 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;
+  }
+}

src/appsscript/docs/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";