feat: add ACTOR_PERMISSION_LEVEL to env var interface (#516)

This adds the `ACTOR_PERMISSION_LEVEL` environmental variable as
`actorPermissionLevel` to the `ApifyEnv` interface.

Author: stepskop

package-lock.json

@@ -54,7 +54,7 @@
         "access": "public"
     },
     "dependencies": {
-        "@apify/consts": "^2.23.0",
+        "@apify/consts": "^2.47.1",
         "@apify/input_secrets": "^1.2.0",
         "@apify/log": "^2.4.3",
         "@apify/timeout": "^0.3.0",

packages/apify/package.json

@@ -37,6 +37,7 @@ import ow from 'ow';
 
 import {
     ACTOR_ENV_VARS,
+    type ACTOR_PERMISSION_LEVEL,
     APIFY_ENV_VARS,
     INTEGER_ENV_VARS,
 } from '@apify/consts';
@@ -106,6 +107,11 @@ export interface ApifyEnv {
      */
     actorBuildId: string | null;
 
+    /**
+     * [Permission level](https://docs.apify.com/platform/actors/development/permissions) the Actor is run under. (ACTOR_PERMISSION_LEVEL)
+     */
+    actorPermissionLevel: ACTOR_PERMISSION_LEVEL | null;
+
     /**
      * ID of the user who started the Actor - note that it might be
      * different than the owner of the Actor (APIFY_USER_ID)

packages/apify/src/actor.ts

@@ -95,6 +95,7 @@ export interface ConfigurationOptions extends CoreConfigurationOptions {
  * ---|---|---
  * `actorEventsWsUrl` | `ACTOR_EVENTS_WEBSOCKET_URL` | -
  * `actorId` | `ACTOR_ID` | -
+ * `actorPermissionLevel` | `ACTOR_PERMISSION_LEVEL` | -
  * `actorRunId` | `ACTOR_RUN_ID` | -
  * `actorTaskId` | `ACTOR_TASK_ID` | -
  * `apiBaseUrl` | `APIFY_API_BASE_URL` | `'https://api.apify.com'`
@@ -172,6 +173,7 @@ export class Configuration extends CoreConfiguration {
         ACTOR_ID: 'actorId',
         ACTOR_INPUT_KEY: 'inputKey',
         ACTOR_MEMORY_MBYTES: 'memoryMbytes',
+        ACTOR_PERMISSION_LEVEL: 'actorPermissionLevel',
         ACTOR_RUN_ID: 'actorRunId',
         ACTOR_STANDBY_PORT: 'standbyPort',
         ACTOR_STANDBY_URL: 'standbyUrl',