@actions/languageservice 0.2.0

package/dist/context-providers/default.js

@@ -0,0 +1,88 @@
+import { data, DescriptionDictionary } from "@actions/expressions";
+import { Kind } from "@actions/expressions/data/expressiondata";
+import { getDescription, RootContext } from "./descriptions";
+import { getEnvContext } from "./env";
+import { getGithubContext } from "./github";
+import { getInputsContext } from "./inputs";
+import { getJobContext } from "./job";
+import { getJobsContext } from "./jobs";
+import { getMatrixContext } from "./matrix";
+import { getNeedsContext } from "./needs";
+import { getSecretsContext } from "./secrets";
+import { getStepsContext } from "./steps";
+import { getStrategyContext } from "./strategy";
+export var Mode;
+(function (Mode) {
+    Mode[Mode["Completion"] = 0] = "Completion";
+    Mode[Mode["Validation"] = 1] = "Validation";
+    Mode[Mode["Hover"] = 2] = "Hover";
+})(Mode || (Mode = {}));
+export async function getContext(names, config, workflowContext, mode) {
+    const context = new DescriptionDictionary();
+    const filteredNames = filterContextNames(names, workflowContext);
+    for (const contextName of filteredNames) {
+        let value = getDefaultContext(contextName, workflowContext, mode) || new DescriptionDictionary();
+        if (value.kind === Kind.Null) {
+            context.add(contextName, value);
+            continue;
+        }
+        value = (await config?.getContext(contextName, value, workflowContext, mode)) || value;
+        context.add(contextName, value, getDescription(RootContext, contextName));
+    }
+    return context;
+}
+function getDefaultContext(name, workflowContext, mode) {
+    switch (name) {
+        case "env":
+            return getEnvContext(workflowContext);
+        case "github":
+            return getGithubContext(workflowContext, mode);
+        case "inputs":
+            return getInputsContext(workflowContext);
+        case "reusableWorkflowJob":
+        case "job":
+            return getJobContext(workflowContext);
+        case "jobs":
+            return getJobsContext(workflowContext);
+        case "matrix":
+            return getMatrixContext(workflowContext, mode);
+        case "needs":
+            return getNeedsContext(workflowContext);
+        case "runner":
+            return objectToDictionary({
+                os: "Linux",
+                arch: "X64",
+                name: "GitHub Actions 2",
+                tool_cache: "/opt/hostedtoolcache",
+                temp: "/home/runner/work/_temp"
+            });
+        case "secrets":
+            return getSecretsContext(workflowContext, mode);
+        case "steps":
+            return getStepsContext(workflowContext);
+        case "strategy":
+            return getStrategyContext(workflowContext);
+    }
+    return undefined;
+}
+function objectToDictionary(object) {
+    const dictionary = new DescriptionDictionary();
+    for (const key in object) {
+        dictionary.add(key, new data.StringData(object[key]));
+    }
+    return dictionary;
+}
+function filterContextNames(contextNames, workflowContext) {
+    return contextNames.filter(name => {
+        switch (name) {
+            case "matrix":
+            case "strategy":
+                return hasStrategy(workflowContext);
+        }
+        return true;
+    });
+}
+function hasStrategy(workflowContext) {
+    return workflowContext.job?.strategy !== undefined || workflowContext.reusableWorkflowJob?.strategy !== undefined;
+}
+//# sourceMappingURL=default.js.map

package/dist/context-providers/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../src/context-providers/default.ts"],"names":[],"mappings":"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"}

package/dist/context-providers/descriptions.d.ts

@@ -0,0 +1,15 @@
+export declare const RootContext = "root";
+/**
+ * Get a description for a built-in context
+ * @param context Name of the context, for example `github`
+ * @param key Key of the context, for example `actor`
+ * @returns Description if one is found, otherwise undefined
+ */
+export declare function getDescription(context: string, key: string): string | undefined;
+/**
+ * Get a description for a context function
+ * This will not include functions defined by the expressions library (e.g. `contains`, `fromJSON`, etc.)
+ * @param name Name of the function, for example `hashFiles`
+ */
+export declare function getFunctionDescription(name: string): string | undefined;
+//# sourceMappingURL=descriptions.d.ts.map

package/dist/context-providers/descriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptions.d.ts","sourceRoot":"","sources":["../../src/context-providers/descriptions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,SAAS,CAAC;AAGlC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE"}

package/dist/context-providers/descriptions.js

@@ -0,0 +1,23 @@
+import descriptions from "./descriptions.json" assert { type: "json" };
+export const RootContext = "root";
+const FunctionContext = "functions";
+/**
+ * Get a description for a built-in context
+ * @param context Name of the context, for example `github`
+ * @param key Key of the context, for example `actor`
+ * @returns Description if one is found, otherwise undefined
+ */
+export function getDescription(context, key) {
+    // The inferred type doesn't quite match the actual type, use any to work around that
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
+    return descriptions[context]?.[key]?.description;
+}
+/**
+ * Get a description for a context function
+ * This will not include functions defined by the expressions library (e.g. `contains`, `fromJSON`, etc.)
+ * @param name Name of the function, for example `hashFiles`
+ */
+export function getFunctionDescription(name) {
+    return getDescription(FunctionContext, name);
+}
+//# sourceMappingURL=descriptions.js.map

package/dist/context-providers/descriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptions.js","sourceRoot":"","sources":["../../src/context-providers/descriptions.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,qBAAqB,CAAC,SAAQ,IAAI,EAAE,MAAM,EAAC,CAAC;AAErE,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAClC,MAAM,eAAe,GAAG,WAAW,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,GAAW;IACzD,qFAAqF;IACrF,+IAA+I;IAC/I,OAAQ,YAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,cAAc,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/context-providers/descriptions.json

@@ -0,0 +1,241 @@
+{
+    "$schema": "./descriptionsSchema.json",
+    "root": {
+        "github": {
+            "description": "Information about the workflow run. For more information, see [`github` context](https://docs.github.com/actions/learn-github-actions/contexts#github-context)."
+        },
+        "env": {
+            "description": "Contains variables set in a workflow, job, or step. For more information, see [`env` context](https://docs.github.com/actions/learn-github-actions/contexts#env-context)."
+        },
+        "vars": {
+            "description": "Contains variables set at the repository, organization, or environment levels. For more information, see [`vars` context](https://docs.github.com/actions/learn-github-actions/contexts#vars-context)."
+        },
+        "job": {
+            "description": "Information about the currently running job. For more information, see [`job` context](https://docs.github.com/actions/learn-github-actions/contexts#job-context)."
+        },
+        "jobs": {
+            "description": "For reusable workflows only, contains outputs of jobs from the reusable workflow. For more information, see [`jobs` context](https://docs.github.com/actions/learn-github-actions/contexts#jobs-context)."
+        },
+        "steps": {
+            "description": "Information about the steps that have been run in the current job. For more information, see [`steps` context](https://docs.github.com/actions/learn-github-actions/contexts#steps-context)."
+        },
+        "runner": {
+            "description": "Information about the runner that is running the current job. For more information, see [`runner` context](https://docs.github.com/actions/learn-github-actions/contexts#runner-context)."
+        },
+        "secrets": {
+            "description": "Contains the names and values of secrets that are available to a workflow run. For more information, see [`secrets` context](https://docs.github.com/actions/learn-github-actions/contexts#secrets-context)."
+        },
+        "strategy": {
+            "description": "Information about the matrix execution strategy for the current job. For more information, see [`strategy` context](https://docs.github.com/actions/learn-github-actions/contexts#strategy-context)."
+        },
+        "matrix": {
+            "description": "Contains the matrix properties defined in the workflow that apply to the current job. For more information, see [`matrix` context](https://docs.github.com/actions/learn-github-actions/contexts#matrix-context)."
+        },
+        "needs": {
+            "description": "Contains the outputs of all jobs that are defined as a dependency of the current job. For more information, see [`needs` context](https://docs.github.com/actions/learn-github-actions/contexts#needs-context)."
+        },
+        "inputs": {
+            "description": "Contains the inputs of a reusable or manually triggered workflow. For more information, see [`inputs` context](https://docs.github.com/actions/learn-github-actions/contexts#inputs-context)."
+        }
+    },
+    "functions": {
+        "always": {
+            "description": "Causes the step to always execute, and returns `true`, even when canceled. The `always` expression is best used at the step level or on tasks that you expect to run even when a job is canceled. For example, you can use `always` to send logs even when a job is canceled."
+        },
+        "cancelled": {
+            "description": "Returns `true` if the workflow was canceled."
+        },
+        "failure": {
+            "description": "Returns `true` when any previous step of a job fails. If you have a chain of dependent jobs, `failure()` returns `true` if any ancestor job fails."
+        },
+        "hashFiles": {
+            "description": "Returns a single hash for the set of files that matches the `path` pattern. You can provide a single `path` pattern or multiple `path` patterns separated by commas. The `path` is relative to the `GITHUB_WORKSPACE` directory and can only include files inside of the `GITHUB_WORKSPACE`."
+        }
+    },
+    "github": {
+        "action": {
+            "description": "The name of the action currently running, or the [`id`](https://docs.github.com/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsid) of a step. GitHub Actions removes special characters, and uses the name `__run` when the current step runs a script without an `id`. If you use the same action more than once in the same job, the name will include a suffix with the sequence number with underscore before it. For example, the first script you run will have the name `__run`, and the second script will be named `__run_2`. Similarly, the second invocation of `actions/checkout` will be `actionscheckout2`."
+        },
+        "action_path": {
+            "description": "The path where an action is located. This property is only supported in composite actions. You can use this path to access files located in the same repository as the action."
+        },
+        "action_ref": {
+            "description": "For a step executing an action, this is the ref of the action being executed. For example, `v2`."
+        },
+        "action_repository": {
+            "description": "For a step executing an action, this is the owner and repository name of the action. For example, `actions/checkout`."
+        },
+        "action_status": {
+            "description": "For a composite action, the current result of the composite action."
+        },
+        "actor": {
+            "description": "The username of the user that triggered the initial workflow run. If the workflow run is a re-run, this value may differ from `github.triggering_actor`. Any workflow re-runs will use the privileges of `github.actor`, even if the actor initiating the re-run (`github.triggering_actor`) has different privileges."
+        },
+        "api_url": {
+            "description": "The URL of the GitHub Actions REST API."
+        },
+        "base_ref": {
+            "description": "The `base_ref` or target branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is either `pull_request` or `pull_request_target`."
+        },
+        "env": {
+            "description": "Path on the runner to the file that sets environment variables from workflow commands. This file is unique to the current step and is a different file for each step in a job. For more information, see [Workflow commands](https://docs.github.com/actions/learn-github-actions/workflow-commands-for-github-actions#setting-an-environment-variable)."
+        },
+        "event": {
+            "description": "The full event webhook payload. You can access individual properties of the event using this context. This object is identical to the webhook payload of the event that triggered the workflow run, and is different for each event. The webhooks for each GitHub Actions event is linked in [Event that trigger workflows](/articles/events-that-trigger-workflows/). For example, for a workflow run triggered by the [`push` event](https://docs.github.com/actions/using-workflows/events-that-trigger-workflows#push), this object contains the contents of the [push webhook payload](https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#push)."
+        },
+        "event_name": {
+            "description": "The name of the event that triggered the workflow run."
+        },
+        "event_path": {
+            "description": "The path to the file on the runner that contains the full event webhook payload."
+        },
+        "graphql_url": {
+            "description": "The URL of the GitHub Actions GraphQL API."
+        },
+        "head_ref": {
+            "description": "The `head_ref` or source branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is either `pull_request` or `pull_request_target`."
+        },
+        "job": {
+            "description": "The [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) of the current job. <br /> Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`."
+        },
+        "ref": {
+            "description": "The fully-formed ref of the branch or tag that triggered the workflow run. For workflows triggered by `push`, this is the branch or tag ref that was pushed. For workflows triggered by `pull_request`, this is the pull request merge branch. For workflows triggered by `release`, this is the release tag created. For other triggers, this is the branch or tag ref that triggered the workflow run. This is only set if a branch or tag is available for the event type. The ref given is fully-formed, meaning that for branches the format is `refs/heads/<branch_name>`, for pull requests it is `refs/pull/<pr_number>/merge`, and for tags it is `refs/tags/<tag_name>`. For example, `refs/heads/feature-branch-1`.",
+            "versions": {
+                "ghes": "3.3",
+                "ghae": "3.3"
+            }
+        },
+        "ref_name": {
+            "description": "The short ref name of the branch or tag that triggered the workflow run. This value matches the branch or tag name shown on GitHub. For example, `feature-branch-1`.",
+            "versions": {
+                "ghes": "3.3",
+                "ghae": "3.3"
+            }
+        },
+        "ref_protected": {
+            "description": "`true` if branch protections are configured for the ref that triggered the workflow run.",
+            "versions": {
+                "ghes": "3.3",
+                "ghae": "3.3"
+            }
+        },
+        "ref_type": {
+            "description": "The type of ref that triggered the workflow run. Valid values are `branch` or `tag`.",
+            "versions": {
+                "ghes": "3.3",
+                "ghae": "3.3"
+            }
+        },
+        "path": {
+            "description": "Path on the runner to the file that sets system `PATH` variables from workflow commands. This file is unique to the current step and is a different file for each step in a job. For more information, see [Workflow commands](https://docs.github.com/actions/learn-github-actions/workflow-commands-for-github-actions#adding-a-system-path)."
+        },
+        "repository": {
+            "description": "The owner and repository name. For example, `Codertocat/Hello-World`."
+        },
+        "repository_owner": {
+            "description": "The repository owner's name. For example, `Codertocat`."
+        },
+        "repositoryUrl": {
+            "description": "The Git URL to the repository. For example, `git://github.com/codertocat/hello-world.git`."
+        },
+        "retention_days": {
+            "description": "The number of days that workflow run logs and artifacts are kept."
+        },
+        "run_id": {
+            "description": "A unique number for each workflow run within a repository. This number does not change if you re-run the workflow run."
+        },
+        "run_number": {
+            "description": "A unique number for each run of a particular workflow in a repository. This number begins at 1 for the workflow's first run, and increments with each new run. This number does not change if you re-run the workflow run."
+        },
+        "run_attempt": {
+            "description": "A unique number for each attempt of a particular workflow run in a repository. This number begins at 1 for the workflow run's first attempt, and increments with each re-run.",
+            "versions": {
+                "ghes": "3.5",
+                "ghae": "3.4"
+            }
+        },
+        "secret_source": {
+            "description": "The source of a secret used in a workflow. Possible values are `None`, `Actions`, `Dependabot`, or `Codespaces`.",
+            "versions": {
+                "ghes": "3.3",
+                "ghae": "3.3"
+            }
+        },
+        "server_url": {
+            "description": "The URL of the GitHub server. For example: `https://github.com`."
+        },
+        "sha": {
+            "description": "The commit SHA that triggered the workflow. The value of this commit SHA depends on the event that triggered the workflow. For more information, see [Events that trigger workflows.](https://docs.github.com/actions/using-workflows/events-that-trigger-workflows) For example, `ffac537e6cbbf934b08745a378932722df287a53`."
+        },
+        "token": {
+            "description": "A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see [Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication).\nNote: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`."
+        },
+        "triggering_actor": {
+            "description": "The username of the user that initiated the workflow run. If the workflow run is a re-run, this value may differ from `github.actor`. Any workflow re-runs will use the privileges of `github.actor`, even if the actor initiating the re-run (`github.triggering_actor`) has different privileges."
+        },
+        "workflow": {
+            "description": "The name of the workflow. If the workflow file doesn't specify a `name`, the value of this property is the full path of the workflow file in the repository."
+        },
+        "workspace": {
+            "description": "The default working directory on the runner for steps, and the default location of your repository when using the [`checkout`](https://github.com/actions/checkout) action."
+        }
+    },
+    "secrets": {
+        "GITHUB_TOKEN": {
+            "description": "`GITHUB_TOKEN` is a secret that is automatically created for every workflow run, and is always included in the secrets context. For more information, see [Automatic token authentication](https://docs.github.com/actions/security-guides/automatic-token-authentication)."
+        }
+    },
+    "jobs": {
+        "outputs": {
+            "description": "The set of outputs of a job in a reusable workflow."
+        },
+        "result": {
+            "description": "The result of a job in the reusable workflow. Possible values are `success`, `failure`, `cancelled`, or `skipped`."
+        }
+    },
+    "steps": {
+        "outputs": {
+            "description": "The set of outputs defined for the step."
+        },
+        "conclusion": {
+            "description": "The result of a completed step after `continue-on-error` is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final conclusion is `success`."
+        },
+        "outcome": {
+            "description": "The result of a completed step before `continue-on-error` is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final conclusion is `success`."
+        }
+    },
+    "runner": {
+        "name": {
+            "description": "The name of the runner executing the job."
+        },
+        "os": {
+            "description": "The operating system of the runner executing the job. Possible values are `Linux`, `Windows`, or `macOS`."
+        },
+        "arch": {
+            "description": "The architecture of the runner executing the job. Possible values are `X86`, `X64`, `ARM`, or `ARM64`."
+        },
+        "temp": {
+            "description": "The path to a temporary directory on the runner. This directory is emptied at the beginning and end of each job. Note that files will not be removed if the runner's user account does not have permission to delete them."
+        },
+        "tool_cache": {
+            "description": "The path to the directory containing preinstalled tools for GitHub-hosted runners. For more information, see \"[About GitHub-hosted runners](https://docs.github.com/actions/reference/specifications-for-github-hosted-runners/#supported-software)\"."
+        },
+        "debug": {
+            "description": "This is set only if [debug logging](https://docs.github.com/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging) is enabled, and always has the value of 1. It can be useful as an indicator to enable additional debugging or verbose logging in your own job steps."
+        }
+    },
+    "strategy": {
+        "fail-fast": {
+            "description": "The `fail-fast` setting for the job. Possible values are `true` or `false`. For more information, see [Workflow syntax for GitHub Actions: `jobs.<job_id>.strategy.fail-fast`](https://docs.github.com/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)."
+        },
+        "max-parallel": {
+            "description": "The `max-parallel` setting for the job. For more information, see [Workflow syntax for GitHub Actions: `jobs.<job_id>.strategy.max-parallel`](https://docs.github.com/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel)."
+        },
+        "job-index": {
+            "description": "The index of the current job in the matrix. **Note:** This number is a zero-based number. The first job's index in the matrix is `0`."
+        },
+        "job-total": {
+            "description": "The total number of jobs in the matrix. **Note:** This number **is not** a zero-based number. For example, for a matrix with four jobs, the value of `job-total` is `4`."
+        }
+    }
+}

package/dist/context-providers/env.d.ts

@@ -0,0 +1,4 @@
+import { DescriptionDictionary } from "@actions/expressions";
+import { WorkflowContext } from "../context/workflow-context";
+export declare function getEnvContext(workflowContext: WorkflowContext): DescriptionDictionary;
+//# sourceMappingURL=env.d.ts.map

package/dist/context-providers/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/context-providers/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAGjE,OAAO,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAC;AAE5D,wBAAgB,aAAa,CAAC,eAAe,EAAE,eAAe,GAAG,qBAAqB,CAoBrF"}

package/dist/context-providers/env.js

@@ -0,0 +1,29 @@
+import { data, DescriptionDictionary } from "@actions/expressions";
+import { isScalar, isString } from "@actions/workflow-parser";
+export function getEnvContext(workflowContext) {
+    const d = new DescriptionDictionary();
+    //step env
+    if (workflowContext.step?.env) {
+        envContext(workflowContext.step.env, d);
+    }
+    //job env
+    if (workflowContext.job && workflowContext.job.env) {
+        envContext(workflowContext.job.env, d);
+    }
+    //workflow env
+    if (workflowContext.template && workflowContext.template.env) {
+        const wfEnv = workflowContext.template.env.assertMapping("workflow env");
+        envContext(wfEnv, d);
+    }
+    return d;
+}
+function envContext(envMap, d) {
+    for (const env of envMap) {
+        if (!isString(env.key)) {
+            continue;
+        }
+        const value = isScalar(env.value) ? new data.StringData(env.value.toDisplayString()) : new data.Null();
+        d.add(env.key.value, value);
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/context-providers/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/context-providers/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAC,QAAQ,EAAE,QAAQ,EAAC,MAAM,0BAA0B,CAAC;AAI5D,MAAM,UAAU,aAAa,CAAC,eAAgC;IAC5D,MAAM,CAAC,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAEtC,UAAU;IACV,IAAI,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE;QAC7B,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;KACzC;IAED,SAAS;IACT,IAAI,eAAe,CAAC,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE;QAClD,UAAU,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;KACxC;IAED,cAAc;IACd,IAAI,eAAe,CAAC,QAAQ,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACzE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;KACtB;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,UAAU,CAAC,MAAoB,EAAE,CAAkB;IAC1D,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACtB,SAAS;SACV;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACvG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;KAC7B;AACH,CAAC"}

package/dist/context-providers/events/eventPayloads.d.ts

@@ -0,0 +1,4 @@
+import { DescriptionDictionary } from "@actions/expressions";
+export declare function getSupportedEventTypes(event: string): string[];
+export declare function getEventPayload(event: string, action: string): DescriptionDictionary | undefined;
+//# sourceMappingURL=eventPayloads.d.ts.map

package/dist/context-providers/events/eventPayloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventPayloads.d.ts","sourceRoot":"","sources":["../../../src/context-providers/events/eventPayloads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AA8FjE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAehG"}

package/dist/context-providers/events/eventPayloads.js

@@ -0,0 +1,111 @@
+import { data, DescriptionDictionary } from "@actions/expressions";
+import webhookObjects from "./objects.json";
+import webhooks from "./webhooks.json";
+import schedule from "./schedule.json" assert { type: "json" };
+import workflow_call from "./workflow_call.json" assert { type: "json" };
+const customEventPayloads = {
+    schedule,
+    workflow_call
+};
+/* eslint-disable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-explicit-any */
+const dedupedWebhookPayloads = webhooks;
+const objects = webhookObjects;
+/* eslint-enable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-explicit-any */
+// Hydrated webhook payloads
+const webhookPayloads = {};
+// Hydrate the workflow dispatch payload if it exists
+getWebhookPayload("workflow_dispatch", "default");
+//
+// Manual work-arounds for webhook issues
+//
+const inputs = webhookPayloads?.["workflow_dispatch"]?.["default"].bodyParameters.find(p => p.name === "inputs");
+if (inputs) {
+    delete inputs.childParamsGroups;
+}
+export function getSupportedEventTypes(event) {
+    const payloads = dedupedWebhookPayloads?.[event];
+    if (!payloads) {
+        if (customEventPayloads[event]) {
+            return ["default"];
+        }
+    }
+    return Object.keys(payloads || {});
+}
+export function getEventPayload(event, action) {
+    const payload = getWebhookPayload(event, action);
+    if (!payload) {
+        // Not all events are real webhooks. Check if there is a custom payload for this event
+        const customPayload = customEventPayloads[event];
+        if (customPayload) {
+            return mergeObject(new DescriptionDictionary(), customPayload);
+        }
+        return undefined;
+    }
+    const d = new DescriptionDictionary();
+    payload.bodyParameters.forEach(p => mergeParam(d, p));
+    return d;
+}
+function mergeParam(target, param) {
+    if (param.childParamsGroups?.length || 0 > 0) {
+        // If there are any child params, add this param as an object
+        const d = new DescriptionDictionary();
+        param.childParamsGroups?.forEach(p => mergeParam(d, p));
+        target.add(param.name, d, param.description);
+    }
+    else {
+        // Otherwise add as a null value. We do not care about the actual content for validation
+        // auto-completion. Possible existence and the description are enough.
+        //
+        // As a special case, if the param is already set, do not overwrite it.
+        if (target.get(param.name)) {
+            return;
+        }
+        target.add(param.name, new data.Null(), param.description);
+    }
+}
+function mergeObject(d, toAdd) {
+    for (const [key, value] of Object.entries(toAdd)) {
+        if (value && typeof value === "object" && !d.get(key)) {
+            if (!Array.isArray(value) && Object.entries(value).length === 0) {
+                // Allow an empty object to be any value
+                d.add(key, new data.Null());
+                continue;
+            }
+            d.add(key, mergeObject(new DescriptionDictionary(), value));
+        }
+        else {
+            d.add(key, new data.Null());
+        }
+    }
+    return d;
+}
+function getWebhookPayload(event, action) {
+    // Is the payload already hydrated?
+    const existingPayload = webhookPayloads?.[event]?.[action];
+    if (existingPayload) {
+        return existingPayload;
+    }
+    const deduplicatedPayload = dedupedWebhookPayloads?.[event]?.[action];
+    if (!deduplicatedPayload) {
+        return undefined;
+    }
+    // Recreate the full payload and store it for reuse
+    const params = deduplicatedPayload.bodyParameters.map(p => fullParam(p));
+    const payload = {
+        ...deduplicatedPayload,
+        bodyParameters: params
+    };
+    webhookPayloads[event] || (webhookPayloads[event] = {});
+    webhookPayloads[event][action] = payload;
+    return payload;
+}
+function fullParam(dedupedParam) {
+    if (typeof dedupedParam === "number") {
+        if (dedupedParam >= objects.length) {
+            throw new Error(`Unknown object ${dedupedParam}`);
+        }
+        return objects[dedupedParam];
+    }
+    return dedupedParam;
+}
+//# sourceMappingURL=eventPayloads.js.map

package/dist/context-providers/events/eventPayloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventPayloads.js","sourceRoot":"","sources":["../../../src/context-providers/events/eventPayloads.ts"],"names":[],"mappings":"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"}