From 18b36964592bd6f6957560dbbb33d15bd2cb0122 Mon Sep 17 00:00:00 2001 From: stuartc Date: Thu, 14 Nov 2024 13:14:01 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20OpenFn/l?= =?UTF-8?q?ightning@4ca0f863401b2d45b6aeb82aa7a1422da546ed66=20?= =?UTF-8?q?=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .build | 2 +- Lightning.Accounts.html | 142 ++++++++-------- Lightning.AdaptorRegistry.Npm.html | 10 +- Lightning.AdaptorRegistry.html | 12 +- Lightning.AiAssistant.html | 4 +- Lightning.AuthProviders.OauthHTTPClient.html | 154 +++++++++--------- Lightning.AuthProviders.WellKnown.html | 10 +- Lightning.BuildMacros.html | 12 +- Lightning.CLI.Result.html | 2 +- Lightning.Collections.html | 24 +-- Lightning.Config.Bootstrap.html | 4 +- Lightning.Credentials.html | 60 +++---- Lightning.Helpers.html | 10 +- Lightning.Invocation.html | 64 ++++---- Lightning.Jobs.html | 26 +-- Lightning.KafkaTriggers.MessageRecovery.html | 2 +- Lightning.OauthClients.html | 32 ++-- Lightning.Policies.Permissions.html | 18 +- Lightning.Projects.html | 74 ++++----- Lightning.PromEx.html | 14 +- Lightning.Repo.html | 14 +- Lightning.Runs.Query.html | 2 +- Lightning.Runs.html | 2 +- Lightning.Runtime.LogAgent.html | 6 +- Lightning.Runtime.RuntimeManager.html | 4 +- Lightning.Scrubber.html | 8 +- Lightning.Storage.GCS.html | 4 +- Lightning.Storage.Local.html | 6 +- Lightning.Storage.ProjectFileDefinition.html | 6 +- Lightning.TaskWorker.html | 2 +- Lightning.Validators.html | 6 +- Lightning.VersionControl.GithubClient.html | 154 +++++++++--------- Lightning.WebhookAuthMethods.html | 76 ++++----- Lightning.WorkOrders.ExportWorker.html | 2 +- Lightning.WorkOrders.html | 4 +- Lightning.Workflows.Job.html | 18 +- Lightning.Workflows.Presence.html | 54 +++--- Lightning.Workflows.html | 30 ++-- Lightning.epub | Bin 693268 -> 693434 bytes LightningWeb.AccountConfirmationModal.html | 4 +- LightningWeb.Components.NewInputs.html | 4 +- LightningWeb.Components.Viewers.html | 4 +- LightningWeb.Gettext.html | 8 +- LightningWeb.OauthCredentialHelper.html | 8 +- LightningWeb.Pagination.html | 10 +- LightningWeb.Plugs.Redirect.html | 12 +- LightningWeb.Plugs.WebhookAuth.html | 8 +- LightningWeb.Telemetry.html | 8 +- Mix.Tasks.Lightning.InstallAdaptorIcons.html | 102 ++++++------ Mix.Tasks.Lightning.InstallSchemas.html | 10 +- benchmarking.md.html | 40 ++--- changelog.html | 25 +-- deployment.html | 6 +- ...ta-DB06326C.js => search_data-2B3E2370.js} | 2 +- readme.html | 10 +- search.html | 2 +- 56 files changed, 669 insertions(+), 668 deletions(-) rename dist/{search_data-DB06326C.js => search_data-2B3E2370.js} (82%) diff --git a/.build b/.build index 8723ca97b7..ce146136e5 100644 --- a/.build +++ b/.build @@ -345,7 +345,7 @@ dist/lato-latin-ext-300-normal-VPGGJKJL.woff2 dist/lato-latin-ext-400-normal-N27NCBWW.woff2 dist/lato-latin-ext-700-normal-Q2L5DVMW.woff2 dist/remixicon-NKANDIL5.woff2 -dist/search_data-DB06326C.js +dist/search_data-2B3E2370.js dist/sidebar_items-757CF219.js index.html provisioning.html diff --git a/Lightning.Accounts.html b/Lightning.Accounts.html index 449143b820..7eb72579d1 100644 --- a/Lightning.Accounts.html +++ b/Lightning.Accounts.html @@ -827,10 +827,10 @@

apply_user_email(user, password, attrs)

Examples -
iex> apply_user_email(user, "valid password", %{email: ...})
-{:ok, %User{}}role: :superuser
-iex> apply_user_email(user, "invalid password", %{email: ...})
-{:error, %Ecto.Changeset{}}
+
iex> apply_user_email(user, "valid password", %{email: ...})
+{:ok, %User{}}role: :superuser
+iex> apply_user_email(user, "invalid password", %{email: ...})
+{:error, %Ecto.Changeset{}}
@@ -882,8 +882,8 @@

change_scheduled_deletion(user, attrs \\ %{ Examples

-
iex> change_scheduled_deletion(user)
-%Ecto.Changeset{data: %User{}}
+
iex> change_scheduled_deletion(user)
+%Ecto.Changeset{data: %User{}}
@@ -919,8 +919,8 @@

change_superuser_registration(attrs \\ %{}) Examples

-
iex> change_superuser_registration(user)
-%Ecto.Changeset{data: %User{}}
+
iex> change_superuser_registration(user)
+%Ecto.Changeset{data: %User{}}
@@ -972,8 +972,8 @@

change_user_email(user, attrs \\ %{})

Examples -
iex> change_user_email(user)
-%Ecto.Changeset{data: %User{}}
+
iex> change_user_email(user)
+%Ecto.Changeset{data: %User{}}
@@ -1027,8 +1027,8 @@

change_user_password(user, attrs \\ %{}) Examples

-
iex> change_user_password(user)
-%Ecto.Changeset{data: %User{}}
+
iex> change_user_password(user)
+%Ecto.Changeset{data: %User{}}
@@ -1058,8 +1058,8 @@

change_user_registration(attrs \\ %{})

Examples -
iex> change_user_registration(user)
-%Ecto.Changeset{data: %User{}}
+
iex> change_user_registration(user)
+%Ecto.Changeset{data: %User{}}
@@ -1220,11 +1220,11 @@

delete_token(token)

Examples -
iex> delete_token(token)
-{:ok, %UserToken{}}
+
iex> delete_token(token)
+{:ok, %UserToken{}}
 
-iex> delete_token(token)
-{:error, %Ecto.Changeset{}}

+iex> delete_token(token)
+{:error, %Ecto.Changeset{}}
@@ -1252,11 +1252,11 @@

delete_user(user)

Examples -
iex> delete_user(user)
-{:ok, %User{}}
+
iex> delete_user(user)
+{:ok, %User{}}
 
-iex> delete_user(user)
-{:error, %Ecto.Changeset{}}

+iex> delete_user(user)
+{:error, %Ecto.Changeset{}}
@@ -1313,11 +1313,11 @@

deliver_user_confirmation_instructions(user Examples

-
iex> deliver_user_confirmation_instructions(user)
-{:ok, %{to: ..., body: ...}}
+
iex> deliver_user_confirmation_instructions(user)
+{:ok, %{to: ..., body: ...}}
 
-iex> deliver_user_confirmation_instructions(confirmed_user)
-{:error, :already_confirmed}

+iex> deliver_user_confirmation_instructions(confirmed_user)
+{:error, :already_confirmed}
@@ -1367,8 +1367,8 @@

deliver_user_reset_password_instructions(us Examples

-
iex> deliver_user_reset_password_instructions(user, &Routes.user_reset_password_url(conn, :edit, &1))
-{:ok, %{to: ..., body: ...}}
+
iex> deliver_user_reset_password_instructions(user, &Routes.user_reset_password_url(conn, :edit, &1))
+{:ok, %{to: ..., body: ...}}
@@ -1513,10 +1513,10 @@

get_preference(user, key)

Examples -
iex> get_preference(user, "editor.orientation")
+
iex> get_preference(user, "editor.orientation")
 "vertical"
 
-iex> get_preference(user, "notifications.enabled")
+iex> get_preference(user, "notifications.enabled")
 true
@@ -1545,10 +1545,10 @@

get_token!(id)

Examples -
iex> get_token!(123)
-%UserToken{}
+
iex> get_token!(123)
+%UserToken{}
 
-iex> get_token!(456)
+iex> get_token!(456)
 ** (Ecto.NoResultsError)

   
 
@@ -1577,10 +1577,10 @@ 
get_user(id)

   
   Examples
 
-
iex> get_user(123)
-%User{}
+
iex> get_user(123)
+%User{}
 
-iex> get_user!(456)
+iex> get_user!(456)
 nil

   
 
@@ -1675,10 +1675,10 @@ 
get_user_by_email(email)

   
   Examples
 
-
iex> get_user_by_email("foo@example.com")
-%User{}
+
iex> get_user_by_email("foo@example.com")
+%User{}
 
-iex> get_user_by_email("unknown@example.com")
+iex> get_user_by_email("unknown@example.com")
 nil

   
 
@@ -1707,10 +1707,10 @@ 
get_user_by_email_and_password(email, passw
   
   Examples
 

-
iex> get_user_by_email_and_password("foo@example.com", "correct_password")
-%User{}
+
iex> get_user_by_email_and_password("foo@example.com", "correct_password")
+%User{}
 
-iex> get_user_by_email_and_password("foo@example.com", "invalid_password")
+iex> get_user_by_email_and_password("foo@example.com", "invalid_password")
 nil

   
 
@@ -1739,10 +1739,10 @@ 
get_user_by_reset_password_token(token)

   Examples
 
-
iex> get_user_by_reset_password_token("validtoken")
-%User{}
+
iex> get_user_by_reset_password_token("validtoken")
+%User{}
 
-iex> get_user_by_reset_password_token("invalidtoken")
+iex> get_user_by_reset_password_token("invalidtoken")
 nil

   
 
@@ -1939,8 +1939,8 @@ 
list_users()

   
   Examples
 
-
iex> list_users()
-[%User{}, ...]

+
iex> list_users()
+[%User{}, ...]

   
 
 

@@ -2069,11 +2069,11 @@ 
register_superuser(attrs)

   
   Examples
 
-
iex> register_superuser(%{field: value})
-{:ok, %User{}}
+
iex> register_superuser(%{field: value})
+{:ok, %User{}}
 
-iex> register_superuser(%{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> register_superuser(%{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -2111,11 +2111,11 @@ 
register_user(attrs)

   
   Examples
 
-
iex> register_user(%{field: value})
-{:ok, %User{}}
+
iex> register_user(%{field: value})
+{:ok, %User{}}
 
-iex> register_user(%{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> register_user(%{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -2165,7 +2165,7 @@ 
request_email_update(user, new_email)

   
   Examples
 
-
iex> request_email_update(user, new_email)
+
iex> request_email_update(user, new_email)
 :ok

   

 
@@ -2194,11 +2194,11 @@ 
reset_user_password(user, attrs)

   
   Examples
 
-
iex> reset_user_password(user, %{password: "new long password", password_confirmation: "new long password"})
-{:ok, %User{}}
+
iex> reset_user_password(user, %{password: "new long password", password_confirmation: "new long password"})
+{:ok, %User{}}
 
-iex> reset_user_password(user, %{password: "valid", password_confirmation: "not the same"})
-{:error, %Ecto.Changeset{}}

+iex> reset_user_password(user, %{password: "valid", password_confirmation: "not the same"})
+{:error, %Ecto.Changeset{}}

   
 
 

@@ -2364,11 +2364,11 @@ 
update_user_password(user, password, attrs)
   
   Examples
 

-
iex> update_user_password(user, "valid password", %{password: ...})
-{:ok, %User{}}
+
iex> update_user_password(user, "valid password", %{password: ...})
+{:ok, %User{}}
 
-iex> update_user_password(user, "invalid password", %{password: ...})
-{:error, %Ecto.Changeset{}}

+iex> update_user_password(user, "invalid password", %{password: ...})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -2403,11 +2403,11 @@ 
update_user_preference(user, key, value)
   Examples
 

-
iex> update_user_preference(user, "editor.orientation", "vertical")
-{:ok, %User{}}
+
iex> update_user_preference(user, "editor.orientation", "vertical")
+{:ok, %User{}}
 
-iex> update_user_preference(user, "notifications.enabled", true)
-{:ok, %User{}}

+iex> update_user_preference(user, "notifications.enabled", true)
+{:ok, %User{}}

   

 
 

@@ -2442,7 +2442,7 @@ 
update_user_preferences(user, preferences)<
   
   Examples
 

-
iex> update_user_preferences(%User{}, %{"editor.orientaion" => "vertical"})

+
iex> update_user_preferences(%User{}, %{"editor.orientaion" => "vertical"})

   

 
 

@@ -2569,8 +2569,8 @@ 
validate_change_user_email(user, params \\
   
   Examples
 

-
iex> validate_change_user_email(user, %{"email" => "new@example.com", "current_password" => "secret"})
-%Ecto.Changeset{...}

+
iex> validate_change_user_email(user, %{"email" => "new@example.com", "current_password" => "secret"})
+%Ecto.Changeset{...}

   

 
 
diff --git a/Lightning.AdaptorRegistry.Npm.html b/Lightning.AdaptorRegistry.Npm.html
index 0e3a5d3b40..965e34e30d 100644
--- a/Lightning.AdaptorRegistry.Npm.html
+++ b/Lightning.AdaptorRegistry.Npm.html
@@ -1692,14 +1692,14 @@ 
request(request)

   
   Examples
 
-
request = %HTTPoison.Request{
+
request = %HTTPoison.Request{
   method: :post,
   url: "https://my.website.com",
   body: "{\"foo\": 3}",
-  headers: [{"Accept", "application/json"}]
-}
+  headers: [{"Accept", "application/json"}]
+}
 
-request(request)

+request(request)

   
 
 

@@ -1757,7 +1757,7 @@ 
request(method, url, body \\ "",
   
   Examples
 

-
request(:post, "https://my.website.com", "{\"foo\": 3}", [{"Accept", "application/json"}])

+
request(:post, "https://my.website.com", "{\"foo\": 3}", [{"Accept", "application/json"}])

   

 
 

diff --git a/Lightning.AdaptorRegistry.html b/Lightning.AdaptorRegistry.html
index af3092a45d..2ae3313366 100644
--- a/Lightning.AdaptorRegistry.html
+++ b/Lightning.AdaptorRegistry.html
@@ -141,9 +141,9 @@ 

 
Registry process to query and maintain a list of adaptors available for
 writing jobs.
Currently it queries NPM for all modules in the @openfn organization and
 filters out modules that are known not to be adaptors.
Usage
# Starting the process
-AdaptorRegistry.start_link()
+AdaptorRegistry.start_link()
 # Getting a list of all adaptors
-Lightning.AdaptorRegistry.AdaptorRegistry.all()
Caching
By default the results are cached to disk, and will be reused every start.
In order to disable or configure caching pass see: start_link/1.
The process uses :continue to return before the adaptors have been queried.
+Lightning.AdaptorRegistry.AdaptorRegistry.all()
Caching
By default the results are cached to disk, and will be reused every start.
In order to disable or configure caching pass see: start_link/1.
The process uses :continue to return before the adaptors have been queried.
 This does mean that the first call to the process will be delayed until
 the handle_continue/2 has finished.
Timeouts
There is a 'general' timeout of 30s, this is used for GenServer calls like
 all/1 and also internally when the modules are being queried. NPM can
@@ -434,10 +434,10 @@ 
resolve_package_name(package_name)

 
       
 
-
Destructures an NPM style package name into module name and version.
Example
iex> resolve_package_name("@openfn/language-salesforce@1.2.3")
-{ "@openfn/language-salesforce", "1.2.3" }
-iex> resolve_package_name("@openfn/language-salesforce")
-{ "@openfn/language-salesforce", nil }

+
Destructures an NPM style package name into module name and version.
Example
iex> resolve_package_name("@openfn/language-salesforce@1.2.3")
+{ "@openfn/language-salesforce", "1.2.3" }
+iex> resolve_package_name("@openfn/language-salesforce")
+{ "@openfn/language-salesforce", nil }

   
 
 

diff --git a/Lightning.AiAssistant.html b/Lightning.AiAssistant.html
index 0683b02972..27a2db5647 100644
--- a/Lightning.AiAssistant.html
+++ b/Lightning.AiAssistant.html
@@ -510,8 +510,8 @@ 
query(session, content)

 
       
 
-
Queries the AI assistant with the given content.
Returns {:ok, session} if the query was successful, otherwise :error.
Example
iex> AiAssistant.query(session, "fn()")
-{:ok, session}

+
Queries the AI assistant with the given content.
Returns {:ok, session} if the query was successful, otherwise :error.
Example
iex> AiAssistant.query(session, "fn()")
+{:ok, session}

   

 
 

diff --git a/Lightning.AuthProviders.OauthHTTPClient.html b/Lightning.AuthProviders.OauthHTTPClient.html
index 8eb1b478cf..c8ffc22166 100644
--- a/Lightning.AuthProviders.OauthHTTPClient.html
+++ b/Lightning.AuthProviders.OauthHTTPClient.html
@@ -497,11 +497,11 @@ 
delete(client, url, opts)

 
       
 
-
Perform a DELETE request.
See request/1 or request/2 for options definition.
delete("/users")
-delete("/users", query: [scope: "admin"])
-delete(client, "/users")
-delete(client, "/users", query: [scope: "admin"])
-delete(client, "/users", body: %{name: "Jon"})

+
Perform a DELETE request.
See request/1 or request/2 for options definition.
delete("/users")
+delete("/users", query: [scope: "admin"])
+delete(client, "/users")
+delete(client, "/users", query: [scope: "admin"])
+delete(client, "/users", body: %{name: "Jon"})

   

 
 

@@ -530,11 +530,11 @@ 
delete!(client, url, opts)

 
       
 
-
Perform a DELETE request.
See request!/1 or request!/2 for options definition.
delete!("/users")
-delete!("/users", query: [scope: "admin"])
-delete!(client, "/users")
-delete!(client, "/users", query: [scope: "admin"])
-delete!(client, "/users", body: %{name: "Jon"})

+
Perform a DELETE request.
See request!/1 or request!/2 for options definition.
delete!("/users")
+delete!("/users", query: [scope: "admin"])
+delete!(client, "/users")
+delete!(client, "/users", query: [scope: "admin"])
+delete!(client, "/users", body: %{name: "Jon"})

   

 
 

@@ -664,11 +664,11 @@ 
get(client, url, opts)

 
       
 
-
Perform a GET request.
See request/1 or request/2 for options definition.
get("/users")
-get("/users", query: [scope: "admin"])
-get(client, "/users")
-get(client, "/users", query: [scope: "admin"])
-get(client, "/users", body: %{name: "Jon"})

+
Perform a GET request.
See request/1 or request/2 for options definition.
get("/users")
+get("/users", query: [scope: "admin"])
+get(client, "/users")
+get(client, "/users", query: [scope: "admin"])
+get(client, "/users", body: %{name: "Jon"})

   

 
 

@@ -697,11 +697,11 @@ 
get!(client, url, opts)

 
       
 
-
Perform a GET request.
See request!/1 or request!/2 for options definition.
get!("/users")
-get!("/users", query: [scope: "admin"])
-get!(client, "/users")
-get!(client, "/users", query: [scope: "admin"])
-get!(client, "/users", body: %{name: "Jon"})

+
Perform a GET request.
See request!/1 or request!/2 for options definition.
get!("/users")
+get!("/users", query: [scope: "admin"])
+get!(client, "/users")
+get!(client, "/users", query: [scope: "admin"])
+get!(client, "/users", body: %{name: "Jon"})

   

 
 

@@ -729,11 +729,11 @@ 
head(client, url, opts)

 
       
 
-
Perform a HEAD request.
See request/1 or request/2 for options definition.
head("/users")
-head("/users", query: [scope: "admin"])
-head(client, "/users")
-head(client, "/users", query: [scope: "admin"])
-head(client, "/users", body: %{name: "Jon"})

+
Perform a HEAD request.
See request/1 or request/2 for options definition.
head("/users")
+head("/users", query: [scope: "admin"])
+head(client, "/users")
+head(client, "/users", query: [scope: "admin"])
+head(client, "/users", body: %{name: "Jon"})

   

 
 

@@ -762,11 +762,11 @@ 
head!(client, url, opts)

 
       
 
-
Perform a HEAD request.
See request!/1 or request!/2 for options definition.
head!("/users")
-head!("/users", query: [scope: "admin"])
-head!(client, "/users")
-head!(client, "/users", query: [scope: "admin"])
-head!(client, "/users", body: %{name: "Jon"})

+
Perform a HEAD request.
See request!/1 or request!/2 for options definition.
head!("/users")
+head!("/users", query: [scope: "admin"])
+head!(client, "/users")
+head!(client, "/users", query: [scope: "admin"])
+head!(client, "/users", body: %{name: "Jon"})

   

 
 

@@ -794,11 +794,11 @@ 
options(client, url, opts)

 
       
 
-
Perform a OPTIONS request.
See request/1 or request/2 for options definition.
options("/users")
-options("/users", query: [scope: "admin"])
-options(client, "/users")
-options(client, "/users", query: [scope: "admin"])
-options(client, "/users", body: %{name: "Jon"})

+
Perform a OPTIONS request.
See request/1 or request/2 for options definition.
options("/users")
+options("/users", query: [scope: "admin"])
+options(client, "/users")
+options(client, "/users", query: [scope: "admin"])
+options(client, "/users", body: %{name: "Jon"})

   

 
 

@@ -827,11 +827,11 @@ 
options!(client, url, opts)

 
       
 
-
Perform a OPTIONS request.
See request!/1 or request!/2 for options definition.
options!("/users")
-options!("/users", query: [scope: "admin"])
-options!(client, "/users")
-options!(client, "/users", query: [scope: "admin"])
-options!(client, "/users", body: %{name: "Jon"})

+
Perform a OPTIONS request.
See request!/1 or request!/2 for options definition.
options!("/users")
+options!("/users", query: [scope: "admin"])
+options!(client, "/users")
+options!(client, "/users", query: [scope: "admin"])
+options!(client, "/users", body: %{name: "Jon"})

   

 
 

@@ -860,10 +860,10 @@ 
patch(client, url, body, opts)

 
       
 
-
Perform a PATCH request.
See request/1 or request/2 for options definition.
patch("/users", %{name: "Jon"})
-patch("/users", %{name: "Jon"}, query: [scope: "admin"])
-patch(client, "/users", %{name: "Jon"})
-patch(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

+
Perform a PATCH request.
See request/1 or request/2 for options definition.
patch("/users", %{name: "Jon"})
+patch("/users", %{name: "Jon"}, query: [scope: "admin"])
+patch(client, "/users", %{name: "Jon"})
+patch(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

   

 
 

@@ -892,10 +892,10 @@ 
patch!(client, url, body, opts)

 
       
 
-
Perform a PATCH request.
See request!/1 or request!/2 for options definition.
patch!("/users", %{name: "Jon"})
-patch!("/users", %{name: "Jon"}, query: [scope: "admin"])
-patch!(client, "/users", %{name: "Jon"})
-patch!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

+
Perform a PATCH request.
See request!/1 or request!/2 for options definition.
patch!("/users", %{name: "Jon"})
+patch!("/users", %{name: "Jon"}, query: [scope: "admin"])
+patch!(client, "/users", %{name: "Jon"})
+patch!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

   

 
 

@@ -924,10 +924,10 @@ 
post(client, url, body, opts)

 
       
 
-
Perform a POST request.
See request/1 or request/2 for options definition.
post("/users", %{name: "Jon"})
-post("/users", %{name: "Jon"}, query: [scope: "admin"])
-post(client, "/users", %{name: "Jon"})
-post(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

+
Perform a POST request.
See request/1 or request/2 for options definition.
post("/users", %{name: "Jon"})
+post("/users", %{name: "Jon"}, query: [scope: "admin"])
+post(client, "/users", %{name: "Jon"})
+post(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

   

 
 

@@ -956,10 +956,10 @@ 
post!(client, url, body, opts)

 
       
 
-
Perform a POST request.
See request!/1 or request!/2 for options definition.
post!("/users", %{name: "Jon"})
-post!("/users", %{name: "Jon"}, query: [scope: "admin"])
-post!(client, "/users", %{name: "Jon"})
-post!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

+
Perform a POST request.
See request!/1 or request!/2 for options definition.
post!("/users", %{name: "Jon"})
+post!("/users", %{name: "Jon"}, query: [scope: "admin"])
+post!(client, "/users", %{name: "Jon"})
+post!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

   

 
 

@@ -988,10 +988,10 @@ 
put(client, url, body, opts)

 
       
 
-
Perform a PUT request.
See request/1 or request/2 for options definition.
put("/users", %{name: "Jon"})
-put("/users", %{name: "Jon"}, query: [scope: "admin"])
-put(client, "/users", %{name: "Jon"})
-put(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

+
Perform a PUT request.
See request/1 or request/2 for options definition.
put("/users", %{name: "Jon"})
+put("/users", %{name: "Jon"}, query: [scope: "admin"])
+put(client, "/users", %{name: "Jon"})
+put(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

   

 
 

@@ -1020,10 +1020,10 @@ 
put!(client, url, body, opts)

 
       
 
-
Perform a PUT request.
See request!/1 or request!/2 for options definition.
put!("/users", %{name: "Jon"})
-put!("/users", %{name: "Jon"}, query: [scope: "admin"])
-put!(client, "/users", %{name: "Jon"})
-put!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

+
Perform a PUT request.
See request!/1 or request!/2 for options definition.
put!("/users", %{name: "Jon"})
+put!("/users", %{name: "Jon"}, query: [scope: "admin"])
+put!(client, "/users", %{name: "Jon"})
+put!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])

   

 
 

@@ -1099,11 +1099,11 @@ 
request(client \\ %Tesla.Client{}, options)
   
   Examples
 

-
ExampleApi.request(method: :get, url: "/users/path")
+
ExampleApi.request(method: :get, url: "/users/path")
 
 # use shortcut methods
-ExampleApi.get("/users/1")
-ExampleApi.post(client, "/users", %{name: "Jon"})

+ExampleApi.get("/users/1")
+ExampleApi.post(client, "/users", %{name: "Jon"})

   

 
 

@@ -1239,11 +1239,11 @@ 
trace(client, url, opts)

 
       
 
-
Perform a TRACE request.
See request/1 or request/2 for options definition.
trace("/users")
-trace("/users", query: [scope: "admin"])
-trace(client, "/users")
-trace(client, "/users", query: [scope: "admin"])
-trace(client, "/users", body: %{name: "Jon"})

+
Perform a TRACE request.
See request/1 or request/2 for options definition.
trace("/users")
+trace("/users", query: [scope: "admin"])
+trace(client, "/users")
+trace(client, "/users", query: [scope: "admin"])
+trace(client, "/users", body: %{name: "Jon"})

   

 
 

@@ -1272,11 +1272,11 @@ 
trace!(client, url, opts)

 
       
 
-
Perform a TRACE request.
See request!/1 or request!/2 for options definition.
trace!("/users")
-trace!("/users", query: [scope: "admin"])
-trace!(client, "/users")
-trace!(client, "/users", query: [scope: "admin"])
-trace!(client, "/users", body: %{name: "Jon"})

+
Perform a TRACE request.
See request!/1 or request!/2 for options definition.
trace!("/users")
+trace!("/users", query: [scope: "admin"])
+trace!(client, "/users")
+trace!(client, "/users", query: [scope: "admin"])
+trace!(client, "/users", body: %{name: "Jon"})

   

 
 
diff --git a/Lightning.AuthProviders.WellKnown.html b/Lightning.AuthProviders.WellKnown.html
index 798b28227d..ea0a4e0c80 100644
--- a/Lightning.AuthProviders.WellKnown.html
+++ b/Lightning.AuthProviders.WellKnown.html
@@ -1868,14 +1868,14 @@ 
request(request)

   
   Examples
 
-
request = %HTTPoison.Request{
+
request = %HTTPoison.Request{
   method: :post,
   url: "https://my.website.com",
   body: "{\"foo\": 3}",
-  headers: [{"Accept", "application/json"}]
-}
+  headers: [{"Accept", "application/json"}]
+}
 
-request(request)

+request(request)

   
 
 

@@ -1933,7 +1933,7 @@ 
request(method, url, body \\ "",
   
   Examples
 

-
request(:post, "https://my.website.com", "{\"foo\": 3}", [{"Accept", "application/json"}])

+
request(:post, "https://my.website.com", "{\"foo\": 3}", [{"Accept", "application/json"}])

   

 
 

diff --git a/Lightning.BuildMacros.html b/Lightning.BuildMacros.html
index 947813deb8..a99d7c7d9d 100644
--- a/Lightning.BuildMacros.html
+++ b/Lightning.BuildMacros.html
@@ -213,13 +213,13 @@ 
do_in(envs, list)

   
   Examples
 
-
do_in(:dev) do
-  IO.puts("This will only be printed in the dev environment")
-end
+
do_in(:dev) do
+  IO.puts("This will only be printed in the dev environment")
+end
 
-do_in([:dev, :test]) do
-  IO.puts("This will only be printed in the dev and test environments")
-end

+do_in([:dev, :test]) do
+  IO.puts("This will only be printed in the dev and test environments")
+end

   

 
 
diff --git a/Lightning.CLI.Result.html b/Lightning.CLI.Result.html
index 37d390935a..b7ab65038b 100644
--- a/Lightning.CLI.Result.html
+++ b/Lightning.CLI.Result.html
@@ -145,7 +145,7 @@ 

   Logs
 

 
The OpenFn CLI returns JSON formatted log lines, which are decoded and added
-to a Result struct.
There are two kinds of output:
{"level":"<<level>>","name":"<<module>>","message":"..."],"time":<<timestamp>>}
These are usually for general logging, and debugging.
{"message":["<<message|filepath|output>>"]}
The above is the equivalent of the output of a command

+to a Result struct.
There are two kinds of output:
{"level":"<<level>>","name":"<<module>>","message":"..."],"time":<<timestamp>>}
These are usually for general logging, and debugging.
{"message":["<<message|filepath|output>>"]}
The above is the equivalent of the output of a command

     
 
 
diff --git a/Lightning.Collections.html b/Lightning.Collections.html
index d6548d24c9..749d1b108f 100644
--- a/Lightning.Collections.html
+++ b/Lightning.Collections.html
@@ -308,11 +308,11 @@ 
create_collection(attrs)

   
   Examples
 
-
iex> create_collection(%{name: "New Collection", description: "Description here"})
-{:ok, %Collection{}}
+
iex> create_collection(%{name: "New Collection", description: "Description here"})
+{:ok, %Collection{}}
 
-iex> create_collection(%{name: nil})
-{:error, %Ecto.Changeset{}}

+iex> create_collection(%{name: nil})
+{:error, %Ecto.Changeset{}}

   
     
   
@@ -569,11 +569,11 @@ 
list_collections(opts \\ [])

   
   Examples
 
-
iex> list_collections()
-[%Collection{}, ...]
+
iex> list_collections()
+[%Collection{}, ...]
 
-iex> list_collections(order_by: [asc: :inserted_at], preload: [:project, :user])
-[%Collection{}, ...]

+iex> list_collections(order_by: [asc: :inserted_at], preload: [:project, :user])
+[%Collection{}, ...]

   
     
   
@@ -678,11 +678,11 @@ 
update_collection(collection, attrs)

   
   Examples
 
-
iex> update_collection(collection, %{name: "Updated Name"})
-{:ok, %Collection{}}
+
iex> update_collection(collection, %{name: "Updated Name"})
+{:ok, %Collection{}}
 
-iex> update_collection(collection, %{name: nil})
-{:error, %Ecto.Changeset{}}

+iex> update_collection(collection, %{name: nil})
+{:error, %Ecto.Changeset{}}

   
     
   
diff --git a/Lightning.Config.Bootstrap.html b/Lightning.Config.Bootstrap.html
index 9343042315..dc6e116474 100644
--- a/Lightning.Config.Bootstrap.html
+++ b/Lightning.Config.Bootstrap.html
@@ -144,8 +144,8 @@ 

 called from other places (aside from config/runtime.exs) file.
Sourcing envs
Internally this module uses Dotenvy.source/1 to source environment variables
 from the .env, .env.<config_env>, and .env.<config_env>.override files.
 It also sources the system environment variables.
Calling configure/0 without calling source_envs/0 or Dotenvy.source/2
-first will result in no environment variables being loaded.
Usage:
Lightning.Config.Bootstrap.source_envs()
-Lightning.Config.Bootstrap.configure()

+first will result in no environment variables being loaded.
Usage:
Lightning.Config.Bootstrap.source_envs()
+Lightning.Config.Bootstrap.configure()

     
 
 
diff --git a/Lightning.Credentials.html b/Lightning.Credentials.html
index 5f16247ad6..b4091dfa36 100644
--- a/Lightning.Credentials.html
+++ b/Lightning.Credentials.html
@@ -408,8 +408,8 @@ 
change_credential(credential, attrs \\ %{})
   
   Examples
 

-
iex> change_credential(credential)
-%Ecto.Changeset{data: %Credential{}}

+
iex> change_credential(credential)
+%Ecto.Changeset{data: %Credential{}}

   
 
 

@@ -439,11 +439,11 @@ 
create_credential(attrs \\ %{})

   
   Examples
 
-
iex> create_credential(%{field: value})
-{:ok, %Credential{}}
+
iex> create_credential(%{field: value})
+{:ok, %Credential{}}
 
-iex> create_credential(%{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> create_credential(%{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -471,11 +471,11 @@ 
delete_credential(credential)

   
   Examples
 
-
iex> delete_credential(credential)
-{:ok, %Credential{}}
+
iex> delete_credential(credential)
+{:ok, %Credential{}}
 
-iex> delete_credential(credential)
-{:error, %Ecto.Changeset{}}

+iex> delete_credential(credential)
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -503,10 +503,10 @@ 
get_credential!(id)

   
   Examples
 
-
iex> get_credential!(123)
-%Credential{}
+
iex> get_credential!(123)
+%Credential{}
 
-iex> get_credential!(456)
+iex> get_credential!(456)
 ** (Ecto.NoResultsError)

   

 
@@ -619,10 +619,10 @@ 
has_activity_in_projects?(credential)

   
   Examples
 
-
iex> has_activity_in_projects?(%Credential{id: some_id})
+
iex> has_activity_in_projects?(%Credential{id: some_id})
 true
 
-iex> has_activity_in_projects?(%Credential{id: another_id})
+iex> has_activity_in_projects?(%Credential{id: another_id})
 false

   
     
@@ -661,11 +661,11 @@ 
invalid_projects_for_user(credential_id, us
   
   Examples
 

-
iex> can_credential_be_shared_to_user(credential_id, user_id)
-[]
+
iex> can_credential_be_shared_to_user(credential_id, user_id)
+[]
 
-iex> can_credential_be_shared_to_user(credential_id, user_id)
-["52ea8758-6ce5-43d7-912f-6a1e1f11dc55"]

+iex> can_credential_be_shared_to_user(credential_id, user_id)
+["52ea8758-6ce5-43d7-912f-6a1e1f11dc55"]

   
 
 

@@ -705,9 +705,9 @@ 
list_credentials(project)

   
   Examples
 

-
  When given a Project:
iex> list_credentials(%Project{id: 1})
-[%Credential{project_id: 1}, %Credential{project_id: 1}]
  When given a User:
iex> list_credentials(%User{id: 123})
-[%Credential{user_id: 123}, %Credential{user_id: 123}]

+
  When given a Project:
iex> list_credentials(%Project{id: 1})
+[%Credential{project_id: 1}, %Credential{project_id: 1}]
  When given a User:
iex> list_credentials(%User{id: 123})
+[%Credential{user_id: 123}, %Credential{user_id: 123}]

   
 
 

@@ -818,11 +818,11 @@ 
schedule_credential_deletion(credential)
   Examples
 

-
iex> schedule_credential_deletion(%Credential{id: some_id})
-{:ok, %Credential{}}
+
iex> schedule_credential_deletion(%Credential{id: some_id})
+{:ok, %Credential{}}
 
-iex> schedule_credential_deletion(%Credential{})
-{:error, %Ecto.Changeset{}}

+iex> schedule_credential_deletion(%Credential{})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -879,11 +879,11 @@ 
update_credential(credential, attrs)

   
   Examples
 
-
iex> update_credential(credential, %{field: new_value})
-{:ok, %Credential{}}
+
iex> update_credential(credential, %{field: new_value})
+{:ok, %Credential{}}
 
-iex> update_credential(credential, %{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> update_credential(credential, %{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 
diff --git a/Lightning.Helpers.html b/Lightning.Helpers.html
index bef18e01ed..a1b39401ca 100644
--- a/Lightning.Helpers.html
+++ b/Lightning.Helpers.html
@@ -327,10 +327,10 @@ 
copy_error(changeset, original_key, new_key
   
   Example
 

-
iex> changeset = %Ecto.Changeset{errors: [name: {"has already been taken", []}]}
-iex> updated_changeset = Lightning.Helpers.copy_error(changeset, :name, :raw_name)
+
iex> changeset = %Ecto.Changeset{errors: [name: {"has already been taken", []}]}
+iex> updated_changeset = Lightning.Helpers.copy_error(changeset, :name, :raw_name)
 iex> updated_changeset.errors
-[name: {"has already been taken", []}, raw_name: {"has already been taken", []}]
If the original_key doesn't exist in the errors, or if the new_key already exists and overwrite is set to false, the changeset is returned unchanged.

+[name: {"has already been taken", []}, raw_name: {"has already been taken", []}]
If the original_key doesn't exist in the errors, or if the new_key already exists and overwrite is set to false, the changeset is returned unchanged.

   
 
 

@@ -449,10 +449,10 @@ 
url_safe_name(name)

   
   Examples
 
-
iex> url_safe_name("My Project!!")
+
iex> url_safe_name("My Project!!")
 "my-project"
 
-iex> url_safe_name(nil)
+iex> url_safe_name(nil)
 ""

   

 
diff --git a/Lightning.Invocation.html b/Lightning.Invocation.html
index bf59805c3a..1fb665324b 100644
--- a/Lightning.Invocation.html
+++ b/Lightning.Invocation.html
@@ -531,8 +531,8 @@ 
change_dataclip(dataclip, attrs \\ %{})

   Examples
 
-
iex> change_dataclip(dataclip)
-%Ecto.Changeset{data: %Dataclip{}}

+
iex> change_dataclip(dataclip)
+%Ecto.Changeset{data: %Dataclip{}}

   
 
 

@@ -562,8 +562,8 @@ 
change_step(step, attrs \\ %{})

   
   Examples
 
-
iex> change_step(step)
-%Ecto.Changeset{data: %Step{}}

+
iex> change_step(step)
+%Ecto.Changeset{data: %Step{}}

   

 
 

@@ -623,11 +623,11 @@ 
create_dataclip(attrs \\ %{})

   
   Examples
 
-
iex> create_dataclip(%{field: value})
-{:ok, %Dataclip{}}
+
iex> create_dataclip(%{field: value})
+{:ok, %Dataclip{}}
 
-iex> create_dataclip(%{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> create_dataclip(%{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -655,11 +655,11 @@ 
delete_dataclip(dataclip)

   
   Examples
 
-
iex> delete_dataclip(dataclip)
-{:ok, %Dataclip{}}
+
iex> delete_dataclip(dataclip)
+{:ok, %Dataclip{}}
 
-iex> delete_dataclip(dataclip)
-{:error, %Ecto.Changeset{}}

+iex> delete_dataclip(dataclip)
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -729,14 +729,14 @@ 
get_dataclip(step)

   
   Examples
 
-
iex> get_dataclip("27b73932-16c7-4a72-86a3-85d805ccff98")
-%Dataclip{}
+
iex> get_dataclip("27b73932-16c7-4a72-86a3-85d805ccff98")
+%Dataclip{}
 
-iex> get_dataclip("27b73932-16c7-4a72-86a3-85d805ccff98")
+iex> get_dataclip("27b73932-16c7-4a72-86a3-85d805ccff98")
 nil
 
-iex> get_dataclip(%Step{id: "a uuid"})
-%Dataclip{}

+iex> get_dataclip(%Step{id: "a uuid"})
+%Dataclip{}

   

 
 

@@ -770,10 +770,10 @@ 
get_dataclip!(id)

   
   Examples
 
-
iex> get_dataclip!(123)
-%Dataclip{}
+
iex> get_dataclip!(123)
+%Dataclip{}
 
-iex> get_dataclip!(456)
+iex> get_dataclip!(456)
 ** (Ecto.NoResultsError)

   

 
@@ -971,10 +971,10 @@ 
get_step!(id)

   
   Examples
 
-
iex> get_step!(123)
-%Step{}
+
iex> get_step!(123)
+%Step{}
 
-iex> get_step!(456)
+iex> get_step!(456)
 ** (Ecto.NoResultsError)

   
 
@@ -1103,8 +1103,8 @@ 
list_dataclips()

   
   Examples
 
-
iex> list_dataclips()
-[%Dataclip{}, ...]

+
iex> list_dataclips()
+[%Dataclip{}, ...]

   
 
 

@@ -1213,8 +1213,8 @@ 
list_steps()

   
   Examples
 
-
iex> list_steps()
-[%Step{}, ...]

+
iex> list_steps()
+[%Step{}, ...]

   

 
 

@@ -1341,7 +1341,7 @@ 
search_workorders(project)

   
   Example:
 
-
search_workorders(%Project{id: 1}, %SearchParams{status: ["completed"]})

+
search_workorders(%Project{id: 1}, %SearchParams{status: ["completed"]})

   

 
 

@@ -1447,11 +1447,11 @@ 
update_dataclip(dataclip, attrs)

   
   Examples
 
-
iex> update_dataclip(dataclip, %{field: new_value})
-{:ok, %Dataclip{}}
+
iex> update_dataclip(dataclip, %{field: new_value})
+{:ok, %Dataclip{}}
 
-iex> update_dataclip(dataclip, %{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> update_dataclip(dataclip, %{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 

diff --git a/Lightning.Jobs.html b/Lightning.Jobs.html
index 6f9c578fcb..fd8a7dfc15 100644
--- a/Lightning.Jobs.html
+++ b/Lightning.Jobs.html
@@ -308,8 +308,8 @@ 
change_job(job, attrs \\ %{})

   
   Examples
 
-
iex> change_job(job)
-%Ecto.Changeset{data: %Job{}}

+
iex> change_job(job)
+%Ecto.Changeset{data: %Job{}}

   

 
 

@@ -339,11 +339,11 @@ 
create_job(attrs \\ %{})

   
   Examples
 
-
iex> create_job(%{field: value})
-{:ok, %Job{}}
+
iex> create_job(%{field: value})
+{:ok, %Job{}}
 
-iex> create_job(%{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> create_job(%{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -407,10 +407,10 @@ 
get_job!(id)

   
   Examples
 
-
iex> get_job!(123)
-%Job{}
+
iex> get_job!(123)
+%Job{}
 
-iex> get_job!(456)
+iex> get_job!(456)
 ** (Ecto.NoResultsError)

   

 
@@ -622,11 +622,11 @@ 
update_job(job, attrs)

   
   Examples
 
-
iex> update_job(job, %{field: new_value})
-{:ok, %Job{}}
+
iex> update_job(job, %{field: new_value})
+{:ok, %Job{}}
 
-iex> update_job(job, %{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> update_job(job, %{field: bad_value})
+{:error, %Ecto.Changeset{}}

   
 
 
diff --git a/Lightning.KafkaTriggers.MessageRecovery.html b/Lightning.KafkaTriggers.MessageRecovery.html
index 2937637391..5059332988 100644
--- a/Lightning.KafkaTriggers.MessageRecovery.html
+++ b/Lightning.KafkaTriggers.MessageRecovery.html
@@ -153,7 +153,7 @@ 

 an error during reprocessing. These files can be reprocessed if you think the
 error was transient. 
Usage: 
  alias Lightning.KafkaTriggers.MessageRecovery
   case MessageRecovery.recover_messages(Lightning.Config.kafka_alternate_storage_file_path) do
:ok -> # Success code
-{:error, error_count} -> # Failure code
  end

+{:error, error_count} -> # Failure code
  end

     
 
 
diff --git a/Lightning.OauthClients.html b/Lightning.OauthClients.html
index b1a1e87468..4d1d4f8745 100644
--- a/Lightning.OauthClients.html
+++ b/Lightning.OauthClients.html
@@ -269,8 +269,8 @@ 
change_client(client, attrs \\ %{})

   
   Examples
 
-
iex> change_client(%OauthClient{}, %{name: "New Client"})
-%Ecto.Changeset{...}

+
iex> change_client(%OauthClient{}, %{name: "New Client"})
+%Ecto.Changeset{...}

   
 
 

@@ -355,11 +355,11 @@ 
delete_client(client)

   
   Examples
 
-
iex> delete_client(client)
-{:ok, %OauthClient{}}
+
iex> delete_client(client)
+{:ok, %OauthClient{}}
 
-iex> delete_client(client)
-{:error, %Ecto.Changeset{}}

+iex> delete_client(client)
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -405,10 +405,10 @@ 
get_client!(id)

   
   Examples
 
-
iex> get_client!(123)
-%OauthClient{}
+
iex> get_client!(123)
+%OauthClient{}
 
-iex> get_client!(456)
+iex> get_client!(456)
 ** (Ecto.NoResultsError)

   

 
@@ -449,9 +449,9 @@ 
list_clients(project)

   
   Examples
 
-
  When given a Project:
iex> list_clients(%Project{id: 1})
-[%OauthClient{project_id: 1}, %OauthClient{project_id: 1}]
  When given a User:
iex> list_clients(%User{id: 123})
-[%OauthClient{user_id: 123}, %OauthClient{user_id: 123}]

+
  When given a Project:
iex> list_clients(%Project{id: 1})
+[%OauthClient{project_id: 1}, %OauthClient{project_id: 1}]
  When given a User:
iex> list_clients(%User{id: 123})
+[%OauthClient{user_id: 123}, %OauthClient{user_id: 123}]

   
 
 

@@ -491,11 +491,11 @@ 
update_client(client, attrs)

   
   Examples
 
-
iex> update_client(client, %{field: new_value})
-{:ok, %OauthClient{}}
+
iex> update_client(client, %{field: new_value})
+{:ok, %OauthClient{}}
 
-iex> update_client(client, %{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> update_client(client, %{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 
diff --git a/Lightning.Policies.Permissions.html b/Lightning.Policies.Permissions.html
index cf486b994d..2845ac3cc6 100644
--- a/Lightning.Policies.Permissions.html
+++ b/Lightning.Policies.Permissions.html
@@ -139,13 +139,13 @@ 

 
     

 
This module defines a unique interface managing authorizations in Lightning.
Users in Lightning have instance-wide and project-wide roles which determine their level of access to resources in the application. Fo rmore details see the documentation.
These authorizations policies are all implemented under the lib/lightning/policies folder. In that folder you can find 3 files:
  • The users.ex file has all the policies for the instances wide access levels
  • The project_users.ex file has all the policies for the project wide access levels
  • The permissions.ex file defines the Lightning.Policies.Permissions.can/4 interface. Which is a wrapper around the Bodyguard.permit/4 function.
-We use that interface to be able to harmonize the use of policies accross the entire app.
All the policies are tested in the test/lightning/policies folder. And the test are written in a way that allows the reader to quickly who can do what in the app.
We have two variants of the Lightning.Policies.Permissions.can/4 interface:
  • Lightning.Policies.Permissions.can(policy, action, actor, resource) returns :ok if the actor can perform the action on the resource and {:error, :unauthorized} otherwise.
  • Lightning.Policies.Permissions.can?(policy, action, actor, resource) returns true if the actor can perform the action on the resource and false otherwise.
Here is an example of how we the Lightning.Policies.Permissions.can/4 interface to check if the a user can edit a job or not
can_edit_workflow = Lightning.Policies.ProjectUsers |> Lightning.Policies.Permissions.can?(:edit_workflow, socket.assigns.current_user, socket.assigns.project)
+We use that interface to be able to harmonize the use of policies accross the entire app.
All the policies are tested in the test/lightning/policies folder. And the test are written in a way that allows the reader to quickly who can do what in the app.
We have two variants of the Lightning.Policies.Permissions.can/4 interface:
  • Lightning.Policies.Permissions.can(policy, action, actor, resource) returns :ok if the actor can perform the action on the resource and {:error, :unauthorized} otherwise.
  • Lightning.Policies.Permissions.can?(policy, action, actor, resource) returns true if the actor can perform the action on the resource and false otherwise.
Here is an example of how we the Lightning.Policies.Permissions.can/4 interface to check if the a user can edit a job or not
can_edit_workflow = Lightning.Policies.ProjectUsers |> Lightning.Policies.Permissions.can?(:edit_workflow, socket.assigns.current_user, socket.assigns.project)
 
-if can_edit_workflow do
+if can_edit_workflow do
   # allow user to edit the workflow
-else
+else
   # quick user out
-end

+end

     

 
 
@@ -222,11 +222,11 @@ 
can(policy, action, user, params \\ [])

   Examples
 
-
iex> can(Lightning.Policies.Users, :create_workflow, user, project)
+
iex> can(Lightning.Policies.Users, :create_workflow, user, project)
 :ok
 
-iex> can(Lightning.Policies.Users, :create_project, user, %{})
-{:error, :unauthorized}

+iex> can(Lightning.Policies.Users, :create_project, user, %{})
+{:error, :unauthorized}

   
 
 

@@ -256,10 +256,10 @@ 
can?(policy, action, user, params \\ [])
   Examples
 

-
iex> can(Lightning.Policies.Users, :create_workflow, user, project)
+
iex> can(Lightning.Policies.Users, :create_workflow, user, project)
 true
 
-iex> can(Lightning.Policies.Users, :create_project, user, %{})
+iex> can(Lightning.Policies.Users, :create_project, user, %{})
 false

   

 
diff --git a/Lightning.Projects.html b/Lightning.Projects.html
index d929031cf8..35dc44054a 100644
--- a/Lightning.Projects.html
+++ b/Lightning.Projects.html
@@ -692,8 +692,8 @@ 
change_project(project, attrs \\ %{})

   
   Examples
 
-
iex> change_project(project)
-%Ecto.Changeset{data: %Project{}}

+
iex> change_project(project)
+%Ecto.Changeset{data: %Project{}}

   
 
 

@@ -725,11 +725,11 @@ 
create_project(attrs \\ %{}, schedule_email
   
   Examples
 

-
iex> create_project(%{field: value})
-{:ok, %Project{}}
+
iex> create_project(%{field: value})
+{:ok, %Project{}}
 
-iex> create_project(%{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> create_project(%{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -758,11 +758,11 @@ 
delete_project(project)

   
   Examples
 
-
iex> delete_project(project)
-{:ok, %Project{}}
+
iex> delete_project(project)
+{:ok, %Project{}}
 
-iex> delete_project(project)
-{:error, %Ecto.Changeset{}}

+iex> delete_project(project)
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -917,8 +917,8 @@ 
export_project(atom, project_id, snapshot_i
   
   Examples
 

-
iex> export_project(:yaml, project_id)
-{:ok, string}

+
iex> export_project(:yaml, project_id)
+{:ok, string}

   

 
 

@@ -990,10 +990,10 @@ 
get_project!(id)

   
   Examples
 
-
iex> get_project!(123)
-%Project{}
+
iex> get_project!(123)
+%Project{}
 
-iex> get_project!(456)
+iex> get_project!(456)
 ** (Ecto.NoResultsError)

   

 
@@ -1088,10 +1088,10 @@ 
get_project_user!(id)

   
   Examples
 
-
iex> get_project_user!(123)
-%ProjectUser{}
+
iex> get_project_user!(123)
+%ProjectUser{}
 
-iex> get_project_user!(456)
+iex> get_project_user!(456)
 ** (Ecto.NoResultsError)

   
 
@@ -1121,16 +1121,16 @@ 
get_project_user_role(user, project)

   
   Examples
 
-
iex> get_project_user_role(user, project)
+
iex> get_project_user_role(user, project)
 :admin
 
-iex> get_project_user_role(user, project)
+iex> get_project_user_role(user, project)
 :viewer
 
-iex> get_project_user_role(user, project)
+iex> get_project_user_role(user, project)
 :editor
 
-iex> get_project_user_role(user, project)
+iex> get_project_user_role(user, project)
 :owner

   
 
@@ -1181,10 +1181,10 @@ 
get_project_with_users!(id)

   
   Examples
 
-
iex> get_project!(123)
-%Project{}
+
iex> get_project!(123)
+%Project{}
 
-iex> get_project!(456)
+iex> get_project!(456)
 ** (Ecto.NoResultsError)

   
 
@@ -1386,8 +1386,8 @@ 
list_projects()

   
   Examples
 
-
iex> list_projects()
-[%Project{}, ...]

+
iex> list_projects()
+[%Project{}, ...]

   
 
 

@@ -1869,11 +1869,11 @@ 
update_project(project, attrs, user \\ nil)
   
   Examples
 

-
iex> update_project(project, %{field: new_value})
-{:ok, %Project{}}
+
iex> update_project(project, %{field: new_value})
+{:ok, %Project{}}
 
-iex> update_project(project, %{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> update_project(project, %{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -1901,11 +1901,11 @@ 
update_project_user(project_user, attrs)
   Examples
 

-
iex> update_project_user(project_user, %{field: new_value})
-{:ok, %ProjectUser{}}
+
iex> update_project_user(project_user, %{field: new_value})
+{:ok, %ProjectUser{}}
 
-iex> update_project_user(projectUser, %{field: bad_value})
-{:error, %Ecto.Changeset{}}

+iex> update_project_user(projectUser, %{field: bad_value})
+{:error, %Ecto.Changeset{}}

   

 
 

@@ -1964,8 +1964,8 @@ 
validate_for_deletion(project, attrs)

   
   Examples
 
-
iex> validate_for_deletion(project)
-%Ecto.Changeset{data: %Project{}}

+
iex> validate_for_deletion(project)
+%Ecto.Changeset{data: %Project{}}

   

 
 
diff --git a/Lightning.PromEx.html b/Lightning.PromEx.html
index a5afacbce3..7ddc704640 100644
--- a/Lightning.PromEx.html
+++ b/Lightning.PromEx.html
@@ -143,24 +143,24 @@ 

 more details regarding configuring PromEx:
config :lightning, Lightning.PromEx,
   disabled: false,
   manual_metrics_start_delay: :no_delay,
-  drop_metrics_groups: [],
+  drop_metrics_groups: [],
   grafana: :disabled,
   metrics_server: :disabled
  • Add this module to your application supervision tree. It should be one of the first
 things that is started so that no Telemetry events are missed. For example, if PromEx
 is started after your Repo module, you will miss Ecto's init events and the dashboards
-will be missing some data points:
    def start(_type, _args) do
-  children = [
+will be missing some data points:
    def start(_type, _args) do
+  children = [
     Lightning.PromEx,
 
     ...
-  ]
+  ]
 
   ...
-end
  • Update your endpoint.ex file to expose your metrics (or configure a standalone
+end
  • Update your endpoint.ex file to expose your metrics (or configure a standalone
 server using the :metrics_server config options). Be sure to put this plug before
 your Plug.Telemetry entry so that you can avoid having calls to your /metrics
 endpoint create their own metrics and logs which can pollute your logs/metrics given
-that Prometheus will scrape at a regular interval and that can get noisy:
    defmodule LightningWeb.Endpoint do
+that Prometheus will scrape at a regular interval and that can get noisy:
    defmodule LightningWeb.Endpoint do
   use Phoenix.Endpoint, otp_app: :lightning
 
   ...
@@ -168,7 +168,7 @@ 
    
   plug PromEx.Plug, prom_ex_module: Lightning.PromEx
 
   ...
-end
  • Update the list of plugins in the plugins/0 function return list to reflect your
+end
  • Update the list of plugins in the plugins/0 function return list to reflect your
 application's dependencies. Also update the list of dashboards that are to be uploaded
 to Grafana in the dashboards/0 function.
    • 
     
diff --git a/Lightning.Repo.html b/Lightning.Repo.html
index 87397a341d..5559dc2604 100644
--- a/Lightning.Repo.html
+++ b/Lightning.Repo.html
@@ -1740,13 +1740,13 @@ 
    transact(fun, opts \\ [])
    
 
 
    A small wrapper around Repo.transaction/2.
    Commits the transaction if the lambda returns :ok or {:ok, result},
 rolling it back if the lambda returns :error or {:error, reason}. In both
-cases, the function returns the result of the lambda.
    Example:
    Repo.transact(fn ->
-  with {:ok, user} <- Accounts.create_user(params),
-      {:ok, _log} <- Logs.log_action(:user_registered, user),
-      {:ok, _job} <- Mailer.enqueue_email_confirmation(user) do
-    {:ok, user}
-  end
-end)
    From blog post found here
    
+cases, the function returns the result of the lambda.
    Example:
    Repo.transact(fn ->
+  with {:ok, user} <- Accounts.create_user(params),
+      {:ok, _log} <- Logs.log_action(:user_registered, user),
+      {:ok, _job} <- Mailer.enqueue_email_confirmation(user) do
+    {:ok, user}
+  end
+end)
    From blog post found here
    
   
 
 
    
diff --git a/Lightning.Runs.Query.html b/Lightning.Runs.Query.html
index 611f00aa72..36dbdda826 100644
--- a/Lightning.Runs.Query.html
+++ b/Lightning.Runs.Query.html
@@ -243,7 +243,7 @@ 
    eligible_for_claim()
    
 
 
    This query does not currently take into account the priority of the run.
 To allow for prioritization, the query should be updated to order by
-priority.
    eligible_for_claim() |> prepend_order_by([:priority])
    
+priority.
    eligible_for_claim() |> prepend_order_by([:priority])
    
   
    
 
 
    
diff --git a/Lightning.Runs.html b/Lightning.Runs.html
index 8abccd5c76..ed0d5ba816 100644
--- a/Lightning.Runs.html
+++ b/Lightning.Runs.html
@@ -479,7 +479,7 @@ 
    get(id, opts \\ [])
    
 
       
 
-
    Get a run by id.
    Optionally preload associations by passing a list of atoms to :include.
    Lightning.Runs.get(id, include: [:workflow])
    
+
    Get a run by id.
    Optionally preload associations by passing a list of atoms to :include.
    Lightning.Runs.get(id, include: [:workflow])
    
   
    
 
 
    
diff --git a/Lightning.Runtime.LogAgent.html b/Lightning.Runtime.LogAgent.html
index a3e19d9abb..4d16da13f1 100644
--- a/Lightning.Runtime.LogAgent.html
+++ b/Lightning.Runtime.LogAgent.html
@@ -139,9 +139,9 @@ 
    
 
     
    
 
    Agent facility to consume STDOUT/STDERR byte by byte.
    Since it works on a byte by byte basis, you will need to perform line-splitting
-yourself.
    Usage:
    {:ok, log} = LogAgent.start_link()
-"foo" = LogAgent.process_chunk(log, {:stdout, "foo"})
-"foobar" = LogAgent.process_chunk(log, {:stdout, "bar"})
    
+yourself.
    Usage:
    {:ok, log} = LogAgent.start_link()
+"foo" = LogAgent.process_chunk(log, {:stdout, "foo"})
+"foobar" = LogAgent.process_chunk(log, {:stdout, "bar"})
    
     
    
 
 
diff --git a/Lightning.Runtime.RuntimeManager.html b/Lightning.Runtime.RuntimeManager.html
index f785cafc98..6b347edbaa 100644
--- a/Lightning.Runtime.RuntimeManager.html
+++ b/Lightning.Runtime.RuntimeManager.html
@@ -147,8 +147,8 @@ 
    
 
    Sample:
      config :lightining, Elixir.Lightning.Runtime.RuntimeManager,
    version: "0.1.0",
 start: true,
 args: ~w(js/app.js --bundle --target=es2016 --outdir=../priv/static/assets),
-cd: Path.expand("../assets", __DIR__),
-env: %{}
    Options:
    • :version - the expected runtime version
    • :start - flag to start the runtime manager. If false the GenServer
+cd: Path.expand("../assets", __DIR__),
+env: %{}
    Options:
    • :version - the expected runtime version
    • :start - flag to start the runtime manager. If false the GenServer
  won't be started
    • :path - the path to find the runtime executable at. By
 default, it is automatically downloaded and placed inside
 the _build directory of your current app
    Overriding the :path is not recommended, as we will automatically
diff --git a/Lightning.Scrubber.html b/Lightning.Scrubber.html
index d9bd011884..81009a6d81 100644
--- a/Lightning.Scrubber.html
+++ b/Lightning.Scrubber.html
@@ -138,11 +138,11 @@ 
    
 
 
     
    
-
    Process used to scrub strings of sensitive information.
    Can be started via start_link/1.
    {:ok, scrubber} =
-  Lightning.Scrubber.start_link(
+
    Process used to scrub strings of sensitive information.
    Can be started via start_link/1.
    {:ok, scrubber} =
+  Lightning.Scrubber.start_link(
     samples:
-      Lightning.Credentials.sensitive_values_for(credential)
-  )
    Takes an optional :name key, in case you need to name the process.
    
+          Lightning.Credentials.sensitive_values_for(credential)
+  )
    Takes an optional :name key, in case you need to name the process.
    
     
    
 
 
diff --git a/Lightning.Storage.GCS.html b/Lightning.Storage.GCS.html
index b310676f8e..ae9db8da02 100644
--- a/Lightning.Storage.GCS.html
+++ b/Lightning.Storage.GCS.html
@@ -151,10 +151,10 @@ 
    
   Example Usage
 
    
 
    # Store a file in GCS
-Lightning.Storage.GCS.store("/path/to/source", "destination/path")
+Lightning.Storage.GCS.store("/path/to/source", "destination/path")
 
 # Get a signed URL for the stored file
-{:ok, url} = Lightning.Storage.GCS.get_url("destination/path")
    
+    {:ok, url} = Lightning.Storage.GCS.get_url("destination/path")
    
     
 
 
diff --git a/Lightning.Storage.Local.html b/Lightning.Storage.Local.html
index 01cbfbed49..efa80438c4 100644
--- a/Lightning.Storage.Local.html
+++ b/Lightning.Storage.Local.html
@@ -157,11 +157,11 @@ 
    
   Example Usage
 
    
 
    # Store a file
-{:ok, filename} =
-  Lightning.Storage.Local.store("/path/to/source", "destination/path")
+{:ok, filename} =
+  Lightning.Storage.Local.store("/path/to/source", "destination/path")
 
 # Get the URL for the stored file
-{:ok, url} = Lightning.Storage.Local.get_url("destination/path")
    
+    {:ok, url} = Lightning.Storage.Local.get_url("destination/path")
    
     
 
 
diff --git a/Lightning.Storage.ProjectFileDefinition.html b/Lightning.Storage.ProjectFileDefinition.html
index 8b4e390b7d..bdbcf4664b 100644
--- a/Lightning.Storage.ProjectFileDefinition.html
+++ b/Lightning.Storage.ProjectFileDefinition.html
@@ -139,13 +139,13 @@ 
    
 
     
    
 
      This module provides functionality for managing the storage and retrieval of project files.
      It handles operations related to storing project files, generating URLs for accessing these files, and constructing storage paths for exported files. It serves as an abstraction layer over the underlying storage mechanism provided by the Lightning.Storage module.
      ## Functions
    • store/2: Stores a file from a given source path into the storage system based on the file's path.
    • get_url/1: Retrieves the URL for accessing a stored file.
    • storage_path_for_exports/2: Constructs a storage path for exported files, defaulting to a .zip extension.
      ## Example Usage
      # Store a file
-  Lightning.Storage.ProjectFileDefinition.store("/path/to/source", project_file)
+  Lightning.Storage.ProjectFileDefinition.store("/path/to/source", project_file)
 
   # Get a URL for the stored file
-  url = Lightning.Storage.ProjectFileDefinition.get_url(project_file)
+  url = Lightning.Storage.ProjectFileDefinition.get_url(project_file)
 
   # Get the storage path for an exported file
-  path = Lightning.Storage.ProjectFileDefinition.storage_path_for_exports(project_file)
    
+  path = Lightning.Storage.ProjectFileDefinition.storage_path_for_exports(project_file)
    
     
 
 
diff --git a/Lightning.TaskWorker.html b/Lightning.TaskWorker.html
index d5ee033666..d7a3adbd2a 100644
--- a/Lightning.TaskWorker.html
+++ b/Lightning.TaskWorker.html
@@ -141,7 +141,7 @@ 
    
 
    A TaskWorker with concurrency limits.
    A simple concurrency limiter that wraps Task.Supervisor, which already does
 have the ability to specify max_children; it throws an error when
 that limit is exceeded.
    To use it, start it like any other process; ideally in your supervision tree.
      ...,
-  {Lightning.TaskWorker, name: :cli_task_worker, max_tasks: 4}
    Options
    • :max_tasks Defaults to the number of system schedulers available to the vm.
    
+  {Lightning.TaskWorker, name: :cli_task_worker, max_tasks: 4}
    Options
    • :max_tasks Defaults to the number of system schedulers available to the vm.
    
     
 
 
diff --git a/Lightning.Validators.html b/Lightning.Validators.html
index c32f6325a8..3ff3625e88 100644
--- a/Lightning.Validators.html
+++ b/Lightning.Validators.html
@@ -235,10 +235,10 @@ 
    validate_exclusive(changeset, fields, messa
       
 
 
    Validate that only one of the fields is set at a time.
    Example:
    changeset
-|> validate_exclusive(
-  [:source_job_id, :source_trigger_id],
+|> validate_exclusive(
+  [:source_job_id, :source_trigger_id],
   "source_job_id and source_trigger_id are mutually exclusive"
-)
    
+)
    diff --git a/Lightning.VersionControl.GithubClient.html b/Lightning.VersionControl.GithubClient.html index f5e8de584c..e1a0ccde66 100644 --- a/Lightning.VersionControl.GithubClient.html +++ b/Lightning.VersionControl.GithubClient.html @@ -870,11 +870,11 @@

    delete(client, url, opts)

    -

    Perform a DELETE request.

    See request/1 or request/2 for options definition.

    delete("/users")
-delete("/users", query: [scope: "admin"])
-delete(client, "/users")
-delete(client, "/users", query: [scope: "admin"])
-delete(client, "/users", body: %{name: "Jon"})
    +

    Perform a DELETE request.

    See request/1 or request/2 for options definition.

    delete("/users")
+delete("/users", query: [scope: "admin"])
+delete(client, "/users")
+delete(client, "/users", query: [scope: "admin"])
+delete(client, "/users", body: %{name: "Jon"})
    @@ -903,11 +903,11 @@

    delete!(client, url, opts)

    -

    Perform a DELETE request.

    See request!/1 or request!/2 for options definition.

    delete!("/users")
-delete!("/users", query: [scope: "admin"])
-delete!(client, "/users")
-delete!(client, "/users", query: [scope: "admin"])
-delete!(client, "/users", body: %{name: "Jon"})
    +

    Perform a DELETE request.

    See request!/1 or request!/2 for options definition.

    delete!("/users")
+delete!("/users", query: [scope: "admin"])
+delete!(client, "/users")
+delete!(client, "/users", query: [scope: "admin"])
+delete!(client, "/users", body: %{name: "Jon"})
    @@ -1023,11 +1023,11 @@

    get(client, url, opts)

    -

    Perform a GET request.

    See request/1 or request/2 for options definition.

    get("/users")
-get("/users", query: [scope: "admin"])
-get(client, "/users")
-get(client, "/users", query: [scope: "admin"])
-get(client, "/users", body: %{name: "Jon"})
    +

    Perform a GET request.

    See request/1 or request/2 for options definition.

    get("/users")
+get("/users", query: [scope: "admin"])
+get(client, "/users")
+get(client, "/users", query: [scope: "admin"])
+get(client, "/users", body: %{name: "Jon"})
    @@ -1056,11 +1056,11 @@

    get!(client, url, opts)

    -

    Perform a GET request.

    See request!/1 or request!/2 for options definition.

    get!("/users")
-get!("/users", query: [scope: "admin"])
-get!(client, "/users")
-get!(client, "/users", query: [scope: "admin"])
-get!(client, "/users", body: %{name: "Jon"})
    +

    Perform a GET request.

    See request!/1 or request!/2 for options definition.

    get!("/users")
+get!("/users", query: [scope: "admin"])
+get!(client, "/users")
+get!(client, "/users", query: [scope: "admin"])
+get!(client, "/users", body: %{name: "Jon"})
    @@ -1264,11 +1264,11 @@

    head(client, url, opts)

    -

    Perform a HEAD request.

    See request/1 or request/2 for options definition.

    head("/users")
-head("/users", query: [scope: "admin"])
-head(client, "/users")
-head(client, "/users", query: [scope: "admin"])
-head(client, "/users", body: %{name: "Jon"})
    +

    Perform a HEAD request.

    See request/1 or request/2 for options definition.

    head("/users")
+head("/users", query: [scope: "admin"])
+head(client, "/users")
+head(client, "/users", query: [scope: "admin"])
+head(client, "/users", body: %{name: "Jon"})
    @@ -1297,11 +1297,11 @@

    head!(client, url, opts)

    -

    Perform a HEAD request.

    See request!/1 or request!/2 for options definition.

    head!("/users")
-head!("/users", query: [scope: "admin"])
-head!(client, "/users")
-head!(client, "/users", query: [scope: "admin"])
-head!(client, "/users", body: %{name: "Jon"})
    +

    Perform a HEAD request.

    See request!/1 or request!/2 for options definition.

    head!("/users")
+head!("/users", query: [scope: "admin"])
+head!(client, "/users")
+head!(client, "/users", query: [scope: "admin"])
+head!(client, "/users", body: %{name: "Jon"})
    @@ -1329,11 +1329,11 @@

    options(client, url, opts)

    -

    Perform a OPTIONS request.

    See request/1 or request/2 for options definition.

    options("/users")
-options("/users", query: [scope: "admin"])
-options(client, "/users")
-options(client, "/users", query: [scope: "admin"])
-options(client, "/users", body: %{name: "Jon"})
    +

    Perform a OPTIONS request.

    See request/1 or request/2 for options definition.

    options("/users")
+options("/users", query: [scope: "admin"])
+options(client, "/users")
+options(client, "/users", query: [scope: "admin"])
+options(client, "/users", body: %{name: "Jon"})
    @@ -1362,11 +1362,11 @@

    options!(client, url, opts)

    -

    Perform a OPTIONS request.

    See request!/1 or request!/2 for options definition.

    options!("/users")
-options!("/users", query: [scope: "admin"])
-options!(client, "/users")
-options!(client, "/users", query: [scope: "admin"])
-options!(client, "/users", body: %{name: "Jon"})
    +

    Perform a OPTIONS request.

    See request!/1 or request!/2 for options definition.

    options!("/users")
+options!("/users", query: [scope: "admin"])
+options!(client, "/users")
+options!(client, "/users", query: [scope: "admin"])
+options!(client, "/users", body: %{name: "Jon"})
    @@ -1395,10 +1395,10 @@

    patch(client, url, body, opts)

    -

    Perform a PATCH request.

    See request/1 or request/2 for options definition.

    patch("/users", %{name: "Jon"})
-patch("/users", %{name: "Jon"}, query: [scope: "admin"])
-patch(client, "/users", %{name: "Jon"})
-patch(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    +

    Perform a PATCH request.

    See request/1 or request/2 for options definition.

    patch("/users", %{name: "Jon"})
+patch("/users", %{name: "Jon"}, query: [scope: "admin"])
+patch(client, "/users", %{name: "Jon"})
+patch(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    @@ -1427,10 +1427,10 @@

    patch!(client, url, body, opts)

    -

    Perform a PATCH request.

    See request!/1 or request!/2 for options definition.

    patch!("/users", %{name: "Jon"})
-patch!("/users", %{name: "Jon"}, query: [scope: "admin"])
-patch!(client, "/users", %{name: "Jon"})
-patch!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    +

    Perform a PATCH request.

    See request!/1 or request!/2 for options definition.

    patch!("/users", %{name: "Jon"})
+patch!("/users", %{name: "Jon"}, query: [scope: "admin"])
+patch!(client, "/users", %{name: "Jon"})
+patch!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    @@ -1459,10 +1459,10 @@

    post(client, url, body, opts)

    -

    Perform a POST request.

    See request/1 or request/2 for options definition.

    post("/users", %{name: "Jon"})
-post("/users", %{name: "Jon"}, query: [scope: "admin"])
-post(client, "/users", %{name: "Jon"})
-post(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    +

    Perform a POST request.

    See request/1 or request/2 for options definition.

    post("/users", %{name: "Jon"})
+post("/users", %{name: "Jon"}, query: [scope: "admin"])
+post(client, "/users", %{name: "Jon"})
+post(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    @@ -1491,10 +1491,10 @@

    post!(client, url, body, opts)

    -

    Perform a POST request.

    See request!/1 or request!/2 for options definition.

    post!("/users", %{name: "Jon"})
-post!("/users", %{name: "Jon"}, query: [scope: "admin"])
-post!(client, "/users", %{name: "Jon"})
-post!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    +

    Perform a POST request.

    See request!/1 or request!/2 for options definition.

    post!("/users", %{name: "Jon"})
+post!("/users", %{name: "Jon"}, query: [scope: "admin"])
+post!(client, "/users", %{name: "Jon"})
+post!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    @@ -1523,10 +1523,10 @@

    put(client, url, body, opts)

    -

    Perform a PUT request.

    See request/1 or request/2 for options definition.

    put("/users", %{name: "Jon"})
-put("/users", %{name: "Jon"}, query: [scope: "admin"])
-put(client, "/users", %{name: "Jon"})
-put(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    +

    Perform a PUT request.

    See request/1 or request/2 for options definition.

    put("/users", %{name: "Jon"})
+put("/users", %{name: "Jon"}, query: [scope: "admin"])
+put(client, "/users", %{name: "Jon"})
+put(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    @@ -1555,10 +1555,10 @@

    put!(client, url, body, opts)

    -

    Perform a PUT request.

    See request!/1 or request!/2 for options definition.

    put!("/users", %{name: "Jon"})
-put!("/users", %{name: "Jon"}, query: [scope: "admin"])
-put!(client, "/users", %{name: "Jon"})
-put!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    +

    Perform a PUT request.

    See request!/1 or request!/2 for options definition.

    put!("/users", %{name: "Jon"})
+put!("/users", %{name: "Jon"}, query: [scope: "admin"])
+put!(client, "/users", %{name: "Jon"})
+put!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
    @@ -1600,11 +1600,11 @@

    request(client \\ %Tesla.Client{}, options) Examples

    -
    ExampleApi.request(method: :get, url: "/users/path")
+
    ExampleApi.request(method: :get, url: "/users/path")
 
 # use shortcut methods
-ExampleApi.get("/users/1")
-ExampleApi.post(client, "/users", %{name: "Jon"})
    
+    ExampleApi.get("/users/1")
+ExampleApi.post(client, "/users", %{name: "Jon"})
    @@ -1662,11 +1662,11 @@

    trace(client, url, opts)

    -

    Perform a TRACE request.

    See request/1 or request/2 for options definition.

    trace("/users")
-trace("/users", query: [scope: "admin"])
-trace(client, "/users")
-trace(client, "/users", query: [scope: "admin"])
-trace(client, "/users", body: %{name: "Jon"})
    +

    Perform a TRACE request.

    See request/1 or request/2 for options definition.

    trace("/users")
+trace("/users", query: [scope: "admin"])
+trace(client, "/users")
+trace(client, "/users", query: [scope: "admin"])
+trace(client, "/users", body: %{name: "Jon"})
    @@ -1695,11 +1695,11 @@

    trace!(client, url, opts)

    -

    Perform a TRACE request.

    See request!/1 or request!/2 for options definition.

    trace!("/users")
-trace!("/users", query: [scope: "admin"])
-trace!(client, "/users")
-trace!(client, "/users", query: [scope: "admin"])
-trace!(client, "/users", body: %{name: "Jon"})
    +

    Perform a TRACE request.

    See request!/1 or request!/2 for options definition.

    trace!("/users")
+trace!("/users", query: [scope: "admin"])
+trace!(client, "/users")
+trace!(client, "/users", query: [scope: "admin"])
+trace!(client, "/users", body: %{name: "Jon"})
    diff --git a/Lightning.WebhookAuthMethods.html b/Lightning.WebhookAuthMethods.html index 23c5845796..53c102d651 100644 --- a/Lightning.WebhookAuthMethods.html +++ b/Lightning.WebhookAuthMethods.html @@ -349,15 +349,15 @@

    create_auth_method(attrs, list)

    Examples -

    • Creating a WebhookAuthMethod without an associated trigger:

      iex> create_auth_method(%{valid_attributes}, actor: %User{})
-{:ok, %WebhookAuthMethod{}}
+
      • Creating a WebhookAuthMethod without an associated trigger:
        iex> create_auth_method(%{valid_attributes}, actor: %User{})
+{:ok, %WebhookAuthMethod{}}
 
-iex> create_auth_method(%{invalid_attributes}, actor: %User{})
-{:error, %Ecto.Changeset{}}
      • Creating a WebhookAuthMethod with an associated trigger:
        iex> create_auth_method(%Trigger{}, %{valid_attributes}, actor: %User{})
-{:ok, %WebhookAuthMethod{}}
+iex> create_auth_method(%{invalid_attributes}, actor: %User{})
+{:error, %Ecto.Changeset{}}
      • Creating a WebhookAuthMethod with an associated trigger:
        iex> create_auth_method(%Trigger{}, %{valid_attributes}, actor: %User{})
+{:ok, %WebhookAuthMethod{}}
 
-iex> create_auth_method(%Trigger{}, %{invalid_attributes}, actor: %User{})
-{:error, %Ecto.Changeset{}}
      
+iex> create_auth_method(%Trigger{}, %{invalid_attributes}, actor: %User{})
+{:error, %Ecto.Changeset{}}

    @@ -442,9 +442,9 @@

    create_changeset(webhook_auth_method, param Examples

    -

    • Creating a changeset for an API type auth method:

      iex> Lightning.Workflows.create_changeset(%WebhookAuthMethod{auth_type: :api}, %{})
-%WebhookAuthMethod{api_key: some_new_api_key}

    • Creating a changeset for a non-API type auth method:

      iex> Lightning.Workflows.create_changeset(%WebhookAuthMethod{auth_type: :other}, %{})
-%WebhookAuthMethod{}
    +

    • Creating a changeset for an API type auth method:

      iex> Lightning.Workflows.create_changeset(%WebhookAuthMethod{auth_type: :api}, %{})
+%WebhookAuthMethod{api_key: some_new_api_key}

    • Creating a changeset for a non-API type auth method:

      iex> Lightning.Workflows.create_changeset(%WebhookAuthMethod{auth_type: :other}, %{})
+%WebhookAuthMethod{}
    @@ -492,9 +492,9 @@

    delete_auth_method(auth_method)

    Examples -

    • Successful deletion:

      iex> delete_auth_method(%WebhookAuthMethod{id: "some_id"})
-{:ok, %WebhookAuthMethod{}}

    • Deletion fails due to the item not existing or other conflict:

      iex> delete_auth_method(%WebhookAuthMethod{id: "non_existing_id"})
-{:error, reason}

    +

    • Successful deletion:

      iex> delete_auth_method(%WebhookAuthMethod{id: "some_id"})
+{:ok, %WebhookAuthMethod{}}

    • Deletion fails due to the item not existing or other conflict:

      iex> delete_auth_method(%WebhookAuthMethod{id: "non_existing_id"})
+{:error, reason}

    @@ -547,8 +547,8 @@

    find_by_api_key(api_key, project)

    Examples -

    • When a matching WebhookAuthMethod is found:

      iex> Lightning.Workflows.find_by_api_key("existing_api_key", %Project{id: "existing_project_id"})
-%WebhookAuthMethod{}

    • When there is no matching WebhookAuthMethod:

      iex> Lightning.Workflows.find_by_api_key("non_existing_api_key", %Project{id: "existing_project_id"})
+
      • When a matching WebhookAuthMethod is found:
        iex> Lightning.Workflows.find_by_api_key("existing_api_key", %Project{id: "existing_project_id"})
+%WebhookAuthMethod{}
      • When there is no matching WebhookAuthMethod:
        iex> Lightning.Workflows.find_by_api_key("non_existing_api_key", %Project{id: "existing_project_id"})
 nil
    @@ -601,8 +601,8 @@

    find_by_id!(id)

    Examples -

    • When a WebhookAuthMethod with the given ID exists:

      iex> Lightning.Workflows.find_by_id!("existing_id")
-%WebhookAuthMethod{}

    • When there is no WebhookAuthMethod with the given ID:

      iex> Lightning.Workflows.find_by_id!("non_existing_id")
+
      • When a WebhookAuthMethod with the given ID exists:
        iex> Lightning.Workflows.find_by_id!("existing_id")
+%WebhookAuthMethod{}
      • When there is no WebhookAuthMethod with the given ID:
        iex> Lightning.Workflows.find_by_id!("non_existing_id")
 ** (Ecto.NoResultsError)
      
   
 
@@ -654,8 +654,8 @@ 
      find_by_username_and_password(username, pas
   
   Examples
 
      
-
      • When a matching WebhookAuthMethod is found and the password is valid:
        iex> Lightning.Workflows.find_by_username_and_password("existing_username", "valid_password", %Project{id: "existing_project_id"})
-%WebhookAuthMethod{}
      • When the username is found but the password is invalid or no matching record is found:
        iex> Lightning.Workflows.find_by_username_and_password("existing_username", "invalid_password", %Project{id: "existing_project_id"})
+
        • When a matching WebhookAuthMethod is found and the password is valid:
          iex> Lightning.Workflows.find_by_username_and_password("existing_username", "valid_password", %Project{id: "existing_project_id"})
+%WebhookAuthMethod{}
        • When the username is found but the password is invalid or no matching record is found:
          iex> Lightning.Workflows.find_by_username_and_password("existing_username", "invalid_password", %Project{id: "existing_project_id"})
 nil
        
   
 
@@ -704,9 +704,9 @@ 
        list_for_project(project)
        
   
   Examples
 
-
        • When the project exists and has associated auth methods:
          iex> list_for_project(%Project{id: "existing_project_id"})
-[%WebhookAuthMethod{}, ...]
        • When the project does not exist or has no associated auth methods:
          iex> list_for_project(%Project{id: "non_existing_project_id"})
-[]
        
+
        • When the project exists and has associated auth methods:
          iex> list_for_project(%Project{id: "existing_project_id"})
+[%WebhookAuthMethod{}, ...]
        • When the project does not exist or has no associated auth methods:
          iex> list_for_project(%Project{id: "non_existing_project_id"})
+[]
        
   
 
 
        
@@ -754,9 +754,9 @@ 
        list_for_trigger(trigger)
        
   
   Examples
 
-
        • When the Trigger has associated WebhookAuthMethods not scheduled for deletion:
          iex> Lightning.Workflows.list_for_trigger(%Trigger{id: "existing_trigger_id"})
-[%WebhookAuthMethod{}, ...]
        • When the Trigger has no associated WebhookAuthMethods or they are all scheduled for deletion:
          iex> Lightning.Workflows.list_for_trigger(%Trigger{id: "trigger_without_methods"})
-[]
        
+
        • When the Trigger has associated WebhookAuthMethods not scheduled for deletion:
          iex> Lightning.Workflows.list_for_trigger(%Trigger{id: "existing_trigger_id"})
+[%WebhookAuthMethod{}, ...]
        • When the Trigger has no associated WebhookAuthMethods or they are all scheduled for deletion:
          iex> Lightning.Workflows.list_for_trigger(%Trigger{id: "trigger_without_methods"})
+[]
        
   
        
 
 
        
@@ -809,10 +809,10 @@ 
        perform(job)
        
   
   Example
 
-
        %Oban.Job{
-args: %{"type" => "purge_deleted"}
-}
-|> MyModule.perform()
+
        %Oban.Job{
+args: %{"type" => "purge_deleted"}
+}
+|> MyModule.perform()
 # => {:ok, %{disassociated_count: 2, deleted_count: 2}}
        
   
        
 
@@ -866,9 +866,9 @@ 
        schedule_for_deletion(webhook_auth_method,
   
   Examples
 
        
-
        • When a webhook auth method is successfully scheduled for deletion:
          iex> Lightning.Workflows.schedule_for_deletion(%WebhookAuthMethod{id: some_id})
-{:ok, %WebhookAuthMethod{scheduled_deletion: deletion_date}}
        • When scheduling for deletion fails due to validation errors:
          iex> Lightning.Workflows.schedule_for_deletion(%WebhookAuthMethod{})
-{:error, %Ecto.Changeset{}}
        
+
        • When a webhook auth method is successfully scheduled for deletion:
          iex> Lightning.Workflows.schedule_for_deletion(%WebhookAuthMethod{id: some_id})
+{:ok, %WebhookAuthMethod{scheduled_deletion: deletion_date}}
        • When scheduling for deletion fails due to validation errors:
          iex> Lightning.Workflows.schedule_for_deletion(%WebhookAuthMethod{})
+{:error, %Ecto.Changeset{}}
        
   
 
 
        
@@ -918,9 +918,9 @@ 
        update_auth_method(webhook_auth_method, att
   
   Examples
 
        
-
        • Successful update:
          iex> update_auth_method(webhook_auth_method, %{field: new_value}, actor: %User{})
-{:ok, %WebhookAuthMethod{}}
        • Update fails due to invalid data:
          iex> update_auth_method(webhook_auth_method, %{field: bad_value}, actor: %User{})
-{:error, %Ecto.Changeset{}}
        
+
        • Successful update:
          iex> update_auth_method(webhook_auth_method, %{field: new_value}, actor: %User{})
+{:ok, %WebhookAuthMethod{}}
        • Update fails due to invalid data:
          iex> update_auth_method(webhook_auth_method, %{field: bad_value}, actor: %User{})
+{:error, %Ecto.Changeset{}}
        
   
     
   
@@ -976,9 +976,9 @@ 
        update_trigger_auth_methods(trigger, auth_m
   
   Examples
 
        
-
        • Successful association update:
          iex> update_trigger_auth_methods(trigger, [webhook_auth_method], actor: %User{})
-{:ok, %Trigger{}}
        • Update fails due to an invalid changeset:
          iex> update_trigger_auth_methods(trigger, [invalid_webhook_auth_method], actor: %User{})
-{:error, %Ecto.Changeset{}}
        
+
        • Successful association update:
          iex> update_trigger_auth_methods(trigger, [webhook_auth_method], actor: %User{})
+{:ok, %Trigger{}}
        • Update fails due to an invalid changeset:
          iex> update_trigger_auth_methods(trigger, [invalid_webhook_auth_method], actor: %User{})
+{:error, %Ecto.Changeset{}}
        
   
     
   
diff --git a/Lightning.WorkOrders.ExportWorker.html b/Lightning.WorkOrders.ExportWorker.html
index e4cd54a38d..a2efe06a99 100644
--- a/Lightning.WorkOrders.ExportWorker.html
+++ b/Lightning.WorkOrders.ExportWorker.html
@@ -139,7 +139,7 @@ 
        
 
     
        
 
          This module handles the export of work orders for a given project. The export process is performed asynchronously using the Oban background job system.
          ## Responsibilities
        • Enqueueing Export Jobs: The enqueue_export/2 function creates and enqueues an Oban job for exporting work orders based on the given project and search parameters.
        • Processing Exports: The perform/1 function is the main entry point for executing the export job. It retrieves the project, processes work orders, and handles the export process.
        • Export Logic: The export logic involves querying work orders, extracting relevant entities, processing logs and dataclips asynchronously, and writing the final export data to files.
        • Error Handling: The module includes comprehensive error handling and logging to ensure that issues during the export process are recorded and can be diagnosed.
        • Zip File Creation: After processing, the exported files are compressed into a zip file for easy download or further use.
          ## Usage
        • To enqueue an export job, call enqueue_export/2 with the project and search parameters.
        • The export process is triggered by Oban and runs in the history_exports queue, limited to a single attempt per job.
          ## Example
          # Enqueue an export job
-  Lightning.WorkOrders.ExportWorker.enqueue_export(project, search_params)
+  Lightning.WorkOrders.ExportWorker.enqueue_export(project, search_params)
 
   # The job will run in the background and log the status of the export process.
          This module is designed to handle potentially large datasets efficiently by using streaming, async processing, and error recovery mechanisms.
        
     
        
diff --git a/Lightning.WorkOrders.html b/Lightning.WorkOrders.html
index 92d910b19b..befccb3c62 100644
--- a/Lightning.WorkOrders.html
+++ b/Lightning.WorkOrders.html
@@ -453,7 +453,7 @@ 
        create_for(target, multi \\ Multi.new(), op
 
       
 
-
        Create a new Work Order.
        For a webhook
        create_for(trigger, workflow: workflow, dataclip: dataclip)
        For a user
        create_for(job, workflow: workflow, dataclip: dataclip, user: user)
        
+
        Create a new Work Order.
        For a webhook
        create_for(trigger, workflow: workflow, dataclip: dataclip)
        For a user
        create_for(job, workflow: workflow, dataclip: dataclip, user: user)
        
   
        
 
 
        
@@ -505,7 +505,7 @@ 
        get(id, opts \\ [])
        
 
       
 
-
        Get a Work Order by id.
        Optionally preload associations by passing a list of atoms to :include.
        Lightning.WorkOrders.get(id, include: [:runs])
        
+
        Get a Work Order by id.
        Optionally preload associations by passing a list of atoms to :include.
        Lightning.WorkOrders.get(id, include: [:runs])
        
   
        
 
 
        
diff --git a/Lightning.Workflows.Job.html b/Lightning.Workflows.Job.html
index 12eeaa46d9..f9482e118f 100644
--- a/Lightning.Workflows.Job.html
+++ b/Lightning.Workflows.Job.html
@@ -358,17 +358,17 @@ 
        put_workflow(changeset, workflow)
        
 
 
        Attaches a workflow to a job, this is useful when you have an unpersisted
 Workflow changeset - and want it to be created at the same time as a Job.
        Example:
        workflow =
-  Ecto.Changeset.cast(
-    %Lightning.Workflows.Workflow{},
-    %{ "project_id" => attrs[:project_id], "id" => Ecto.UUID.generate() },
-    [:project_id, :id]
-  )
+  Ecto.Changeset.cast(
+    %Lightning.Workflows.Workflow{},
+    %{ "project_id" => attrs[:project_id], "id" => Ecto.UUID.generate() },
+    [:project_id, :id]
+  )
 
 job =
-  %Job{}
-  |> Ecto.Changeset.change()
-  |> Job.put_workflow(workflow)
-  |> Job.changeset(attrs)
        
+  %Job{}
+  |> Ecto.Changeset.change()
+  |> Job.put_workflow(workflow)
+  |> Job.changeset(attrs)
        
   
 
 
        
diff --git a/Lightning.Workflows.Presence.html b/Lightning.Workflows.Presence.html
index 48bc2ff5fe..0b2adf9dce 100644
--- a/Lightning.Workflows.Presence.html
+++ b/Lightning.Workflows.Presence.html
@@ -354,27 +354,27 @@ 
        build_presences_summary(presences, params)<
   
   Examples
 
        
-
        iex> presences = [
-...>   %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},
-...>   %{user: %{id: 2}, joined_at: ~N[2024-07-03 12:05:00], active_sessions: 1},
-...>   %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1}
-...> ]
-iex> params = %{
-...>   current_user_presence: %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},
-...>   current_user: %{id: 1},
-...>   view_only_users_ids: [2]
-...> }
-iex> build_presences_summary(presences, params)
-%{
-  presences: [
-    %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},
-    %{user: %{id: 2}, joined_at: ~N[2024-07-03 12:05:00], active_sessions: 1},
-    %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1}
-  ],
-  prior_user_presence: %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1},
-  current_user_presence: %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},
+
        iex> presences = [
+...>   %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},
+...>   %{user: %{id: 2}, joined_at: ~N[2024-07-03 12:05:00], active_sessions: 1},
+...>   %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1}
+...> ]
+iex> params = %{
+...>   current_user_presence: %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},
+...>   current_user: %{id: 1},
+...>   view_only_users_ids: [2]
+...> }
+iex> build_presences_summary(presences, params)
+%{
+  presences: [
+    %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},
+    %{user: %{id: 2}, joined_at: ~N[2024-07-03 12:05:00], active_sessions: 1},
+    %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1}
+  ],
+  prior_user_presence: %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1},
+  current_user_presence: %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},
   has_presence_edit_priority: true
-}
        
+        }
        
   
        
 
 
        
@@ -518,8 +518,8 @@ 
        list_presences(topic)
        
   
   Examples
 
-
        iex> Lightning.Workflows.Presence.list_presences("workflow:canvas")
-[%Lightning.Workflows.Presence{user: %User{id: 1}, ...}, ...]
        
+
        iex> Lightning.Workflows.Presence.list_presences("workflow:canvas")
+[%Lightning.Workflows.Presence{user: %User{id: 1}, ...}, ...]
        
   
        
 
 
        
@@ -555,12 +555,12 @@ 
        new_user_presence(user, joined_at, active_s
   
   Examples
 
        
-
        iex> Lightning.Workflows.Presence.new_user_presence(%User{id: 1}, 1625597762000000)
-%Lightning.Workflows.Presence{
-  user: %User{id: 1},
+
        iex> Lightning.Workflows.Presence.new_user_presence(%User{id: 1}, 1625597762000000)
+%Lightning.Workflows.Presence{
+  user: %User{id: 1},
   joined_at: 1625597762000000,
   active_sessions: 0
-}
        
+        }
        
   
        
 
 
        
@@ -638,7 +638,7 @@ 
        track_user_presence(user, topic, pid)
        
   
   Examples
 
-
        iex> Lightning.Workflows.Presence.track_user_presence(%User{id: 1}, "room:lobby", self())
+
        iex> Lightning.Workflows.Presence.track_user_presence(%User{id: 1}, "room:lobby", self())
 :ok
        
   
        
 
diff --git a/Lightning.Workflows.html b/Lightning.Workflows.html
index b5c991b494..3198e6fea6 100644
--- a/Lightning.Workflows.html
+++ b/Lightning.Workflows.html
@@ -446,8 +446,8 @@ 
        change_workflow(workflow, attrs \\ %{})
        
   Examples
 
-
        iex> change_workflow(workflow)
-%Ecto.Changeset{data: %Workflow{}}
        
+
        iex> change_workflow(workflow)
+%Ecto.Changeset{data: %Workflow{}}
        
   
 
 
        
@@ -509,12 +509,12 @@ 
        get_edge_by_trigger(trigger)
        
   
   Examples
 
-
        trigger = %Trigger{id: 1, ...}
-Lightning.Workflows.get_edge_by_trigger(trigger)
+
        trigger = %Trigger{id: 1, ...}
+Lightning.Workflows.get_edge_by_trigger(trigger)
 # => %Edge{source_trigger: %Trigger{}, target_job: %Job{}, ...}
 
-non_existent_trigger = %Trigger{id: 999, ...}
-Lightning.Workflows.get_edge_by_trigger(non_existent_trigger)
+non_existent_trigger = %Trigger{id: 999, ...}
+Lightning.Workflows.get_edge_by_trigger(non_existent_trigger)
 # => nil
        
   
        
 
@@ -584,10 +584,10 @@ 
        get_trigger_by_webhook(path)
        
   
   Examples
 
-
        Lightning.Workflows.get_trigger_by_webhook("some_path_or_id")
+
        Lightning.Workflows.get_trigger_by_webhook("some_path_or_id")
 # => %Trigger{id: 1, custom_path: "some_path_or_id", ...}
 
-Lightning.Workflows.get_trigger_by_webhook("non_existent_path_or_id")
+Lightning.Workflows.get_trigger_by_webhook("non_existent_path_or_id")
 # => nil
        
   
 
@@ -662,10 +662,10 @@ 
        get_workflow!(id)
        
   
   Examples
 
-
        iex> get_workflow!(123)
-%Workflow{}
+
        iex> get_workflow!(123)
+%Workflow{}
 
-iex> get_workflow!(456)
+iex> get_workflow!(456)
 ** (Ecto.NoResultsError)
        
   
 
@@ -769,8 +769,8 @@ 
        list_workflows()
        
   
   Examples
 
-
        iex> list_workflows()
-[%Workflow{}, ...]
        
+
        iex> list_workflows()
+[%Workflow{}, ...]
        
   
 
 
        
@@ -800,8 +800,8 @@ 
        mark_for_deletion(workflow, attrs \\ %{})
   Examples
 
        
-
        iex> change_request_deletion(workflow)
-%Ecto.Changeset{data: %Workflow{}}
        
+
        iex> change_request_deletion(workflow)
+%Ecto.Changeset{data: %Workflow{}}
        
   
        
 
 
        
diff --git a/Lightning.epub b/Lightning.epub
index aff68d1d18b6a2b810714e8a0a3921fd6e8cd704..ce6a30d57164704b8c918dff9c3183264e45da1e 100644
GIT binary patch
delta 235302
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
        hOI;Lf;zlh@9aN&4#+wwn9G}BhHY!1H-^mRJ@
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�BR!A>@MyTx*FO#Rcvnoo&1nT#*rx6-=kR|U7@6~q_fh(^eEx%bv
zlUb6U6+rz^O#KINd0#;Nibjr=hI8MMQBlIa{EYauaZxpBDQ%xO3gy6VZY4r498LK!
z%SsV4+dHSrebfpGen+5um$+n!+sv)O%34w_Pz%bY_IuP9Xa7#<>u&+z55W7V(8GN_
zs$?<}e4s)1rrlP&C1*pk8DwB%=cyWhBvwN+;gWe{y8{#O;r;!323|ndY6f5O@+C7;
z_oi9eHlpeF4DGb>r2j|hG6aR`8?K0WJ#BFLwQNVO6uU#rvH$NguZOK2DERZB&xvr;
z9uyhtBY21SYyODS$L8M6!<~29-C@;+RrhE;(jrVKNeNj@Ng+O$lr;rJyZDU9jxl_U
zB(x|J=pv`dt`QZaDh@4qeyE)IEgq#6*
z|Ajlpx6eVG+N1?P`dShG-p+Iu+!;5yZkG!^h~I~;v(0CCyQUi~bD}Gzfyy~^Q7=hv
zh?`rFWAmD~ue5v@rv7Kxl;%E#WfxyM$3?C{K=lOR|9j`DZ@jCRbjjRu`UG*71yk|1N=)hY4{j7_eHGK*T3#jY=Rf|#P=#iFhR$V#<&+iQXbrlBHvYFNugatny^sp!-WP)8IZ27ZOMYQ
zLan~kFAZ~HE?xP#e3MEY5G?Jg0)^Jv393&))czaZT|gG^v!=*xq#m0L;!HUo1(RQ{
zB5EmAVjH9gEgM_Si%@c4M$|M=D$gk49Q2tkt?baMnK8^)5Q0x*1v8t|pPOu7GEz>+fUDI*wGBIz9azF$Fdp2_=);zxB8qlv2#_(1zhWSC2R
znyWdbM+*1w;V}lq)>Zhiej^?L;a6xSBOaZRm;W%B4D_Ahv#VtZJM1>Ci{w3Q>eP;!
z+j|@I!u62su453$cmAXOin`{*E`9V?LDN@rm?3
zZEqX2+4=CXI*4FxKJezIljEI8={^mPkl1uL8>sbb{^y2|3g?|$3sn_K?$<<^hmR|}
zHkEhkMBDC0P^+7}dxIw+6Y*#426#YC6Cr{TGyAWOQ%FmznDv_Dj?$AZKesP7uXLO^
z?JaAw@}wTSxWtIG%meA_-oIB;Afr=T{i34+9jjY`_GzgH-PyUxNm$MESw->gPv)d;
zrwkp!Z(Da)nxz}3UNVysXR@_fv8uscKK#mtT1NcJ$L-5{TBa=kjA`*RS?%2D#jW_Zj`tdy|=^0dIB?21Z>B-?YPyw}tOQ|EwB8{DR(CzL34gr8Ya31$@
z2aKXNXZ*B;69~lIe(6je*FE7wTEb@M-oe_8MFH-3);k~U_2@nbMvyS!b5n#Ut)sL;UnVrX9{&$C+u|?Dp8a452uLudu37{)ltANx9k#$8phD634VhzyIiJ1=
zCBNf5Oq}od7dBB^J~EaSW}8dR4jJ>0^k6HO%)hk5{UFbIWGMw$F+7fl>Zl!1(Z>A@
zc!dDvz2E=^8WcLmX)W
z9}|X=Z=@&lAFEB$VM)H54<7?pGP?QrN9kin8I;G@d`W!n27oAj*dF}5N<@llWvXBrspcrM4e1QFB
zWSpXJd&O8Ab@`)Tj*>5kNT;O{`Nb@36u_!!fqin7H8v)8&Y+I>5Gs8gm5=Kdst}-3
z;d4hRm6DR$7ppuTCDWG42ce{-3k1$@!fjlf#~8QE0D3TrWJWsyB_t0?l8M%jedPp+
zWj1K91;*M(E&U5Ycnb>bT*qDyDueK`2b!w%3cYmZ`))sLFY8Z
zAc-YPTq6-Pz)*;-pI7`vlrS7E2N3`=z}tZtShP`M@6O&>P#;E_=z%|q9l{Ynx|dU?
za~=}MzF4HZkDyjkuqaG2`P~&Lsddq}{_K
zGKMLcMB)Jg|462gd0?-m2dwZ7>@o5_aJf3*U9CXk@7#C9igc>%ttj(fSSNHOy_hTl
zX9byqUizO4OQ75Fss%nhIu#88;7LxD_GKMF2qb6wCiQDk$&$s^V;4I2Zv;E@=dE>p
zc(yi+uKn(E;=EeMuDbO7Q+NPBTjqHOi#$gb9Zn0c&z<11)0bdwL-Wkm?j{d`wZS)O
zimvKa@JgTaR(k1$BRy@Z74R5fy12}_ZsuSXiuVR4Pzs+fGPEO-EF1$lA-TqFk
zZJ1^H-O|KGE9*E%_+D^Frmp!=TUs~Q%Yaqa<5mw2u~
zp}T%hSAW2hO)Nqu!y8&BZ|NOH@Y+widb!iTC70G7mO8f&Uh}YT5YHb;FAqmD&NyBh
zH{=xB0H^JEiBy9q2n>L`0;iJS3eQvfr`*d%$FT99T9)9cjz=;|UBpgPl6rLHk@$e!
zxYM!&kqT83mY-C(S0mYTdQ%J39US^T8Mao%9Zk~y9iN@_l>=U{`^go$Ak?FJa_-^R
zwp91mE?{hhG*=oC4@>J%ENXnpv>UeWYhG{krL2=n=<)p#nj3KC_V`SSH+s_&W$>mS
zpRleaV=Lus%5zbEIZOf6=^-L_U6;?ELV1|MD2W}52`V&p|FP<0bD?uX1}sob<>2VH
z&T|cLcbv1o>;k^GnmlGtJu<4R?p)@dp(C@Q*kT*~-gfQsnNh8g4^pt}P!|IJ=`EX7
zb-!a1sJ_R5pBgpnuJcimT6v5&6Z|>U4~Fx4@hJL6mBZ6E5D_IGPh0^-iXp@W-;D*E
zT<2@Pr_HEQpaun&vlnXfhQHy;Q(d|HaAsZ2AGjoaAQb5hV)998`(s;EmmaKHvf>Bm
z4Fa}=*G!q~rEdI>FQPs!j_*8^{EY#!Uf>UO_$69^LtWx#bszZqmdNJnyx&UI+2c;C
zm^Ou_q&V!9zn%sD}_6&QTWaox2Nx#pi%1@LE;#hQd)xQi~92
zq+2zr+UWCSB2qa3&p9gGe%8``T<4$OxmP@JR-(QNL6?B!O_LoWmvHZw)<5p2tIt59
zDl~+EZYPMUQ0b;US!(NwKWq~p6=oQSt@D`4oj7O*{X>=|K~C!=A&Tewk)l5^b{wz>
zbDT->Xpf)I5MQD5lRei{4QQd3&+?p5Rc9GT5N;8{A_G0ne2o6Te2D~_Bh_K0Yr
zT2-~KKClN%N#!VQR;3$=0{6pB#RNxWguP#)ThO3JwcuEAW$)O>f}fAAsyP`&N|
zE%#X6i7Qr*S&7+JQgWToi7n!n#GC`N_YS<86pS1CWV%U)RxwBdwPiXe`|-pvHQ7&z
zxmzjLb~B1rABl?!P}+$UcKK+iFta^cMmMswF|3B@en6X9Lj&Rd@Nk*yD5$;@-lvD-
z=e<5fsRBvp1|oa;Q8Af#scw?_Ht*}v#)`l@<_EZ0`XD~#X@0=ouyA7exH>7?qJNOp
ziwM0?aj#GTQ)saHC6SH&`UJ@E3!;P73&pSE6q-{9m}Ip;Q))PD^*VNS5V$-Jszmb&
zN+36NDL|;nsH~-t^O0P8V`8f;cE6*XCj^5E+P5~$T7HL`UY4?#UPxrHQcYxWm1uoX
z%4Ju|BZM5Q$BO7f$b-&&U@CO0>=B}R>nRTmHUVSG33*}g&0sOj0|urVy}EH@8ZKAH
zie{>vyUEAWiiVn=g&gy5=VY1bt)t+M09-M2HQ*a|o}eLDjO5^fE{R6EG5hK)r{V_X
zcSMa7r#ir|{p}VDBL6zX_`7tS{98Xa4(WyG^K}NeoV3M*clu-;m%CaUBTzW{YU?3;
zgGfy_=%xn?(Q7z;bZ<_N#AfHdylEXa>}|DtR37*z@)`07YB1+aehrfdW%?Zrxs;I1
zKHxMVT^;O#M0-yqNCOP#yQKNaMPe|SBwbFM-rm@1w9f1Rc>yC{>rZ(UIqx$~hISAU
z5n;H#Sz14_M7E%H`h0+{Zs-42&H>#Jr2anPZo@{HK=&@3ylg=EQ6+dDa+DGspf}|A
zA!=WiP{=~+80djPIR?q-It*cbEQ>;)4Y2K+(6TIiYob>j4AjaUdkbm>*%}c5*>k5Y
zTPV2zCWFxQQ5=L2K(ZR^o4D;ezwHYVc#mXWF3!$pK}UF^Uh6N2xL+{Z^-fV=_YWP4
zV6+tMY@#K@wc>N=uPaMLNZr=!e0j=i@h3D4h7Je-vAEe~!8E3EhM>p$h@WvN0xU7G
zF|>l=KfLVnji?&ZSGP}A299f|b%1O!wEDv&2T=XqYWhf#I;pahOeH;aZhbnIC3q!1
zNlT~-6o;YD2G;4YlrJma_ke8u{d*E1gmk*}b6(`P5vt4+RlsBaQJt6M4L5e&T--rL
zf5UE>c<93|R5@9hr5gC=YGx6&F(4XUN0%fm)PSi?zCcz4&s1W
zwhT;XWU)?2p+R{THI}+950N0<`Xb-558tKFR{q<}C-Mld^9Q)LK+s_q2hf3efAE9D
zsxI44fgS~#F1)u&LS(xuC5QnNPnUIv@eHd
zLJUR21$iZ{JBXD2*nDMuNO#-Sx1CIn7qHB(8vGxRhv%4PMMrU?9d%ed$J-zmReG4wHPR91`
zQkv&dwKuL#rpO6w44?@zjP`+DGbBu3s?%Zx7u`rAFpudq>b`-2WT
zQZ$WazfyS1MVXO!*SM>j$;-@VnLHzB&Zp=zY80_@t9wNyztefycCEGX!f$V(h>acY
z@>-TtMMD(HWKpzc2$$TRj|psyZ6fs{$Qf$IJ5(kX%?dV>BPmxZMeT~*B%G2+Yy&n!
zebmGlYMRtpYAq_3PHp6DKyw}$`}>GwDrJtak(HB*q*Wh;tuW$@c9CcIts$>XHJiHF
zsuqy_%TWhhnSeQI|1?2Q8amkG^A+$$>8QDSy1#1)=*0#ED32UU0{WA=-trtj@EK0n
z9$;Q$)W~jE-o=4)F$w4Wr)AQzU}X);i&bWcc5PmkHvOV8==`feCYnIkdG$fZ)OiiO
z9*J&DeNCsED#j6Y9}edB7YYj(LQ4@u(#8>*p;NE=xB&{)5jkB7pT0g{o4-u*w4LG&
zniFM*-AlM()da4QfeFg^JAg(yY!FHP;AhG$8(hYBrt1+S=5sIO>>SMJvo9ED_>1%f
zhT*?_5$69Fbh-S$F2n!q=nls~DQZ073$5Xd2HNrPr&_FA{)Twp{by|(N@bGrRXxDU
zS2qb+o0CzSbB2LP9Rsu6-#@W4*_411lbjb?{)d>@9JpM5JbZYBj{uBMKV*vxv)ypt
zgfNwAg|0~wCbq?G$;GFBh0L%cz14MAfeA@^R);XyY=;|R@JI@lyDXb^+D^t9MfSmc
z%6ubmY}uf?==*sX1@|=uVg_FGhCu)%xmg#>4i@EBZ|h2)18Kt{W>SKcxjw#^VQKg|
z`yC6z#g$RXvK}WgYY2~V$%)VAq(jG;_m|hJO?U~+!7!@DyhCN12*Z2zSh)5N=5;bc
zZ8Xlm{joS`H~kcVgLz(sGV&yvyxRm>AW)`zWYKyzjMLw09p-RXFUWIOb*_L#Anlg1
z&&x4DXdlm~0z~cCJ^NgPYDegGE0fO#!nU+B;uz))h060}f2xWRG9iUq^WG4s`41#<
zYIftmzqe$xGTg{AvwJuq27Qf0vYcl>Xxc@o`JLCx_R(b(Z)Ea-*Z@K94Ym>f+ekcZrOtuR@wQvc`SmShJ8WbeU1A??@szX
zY&dKmO>jNQZOJjXi7>-o1Lf{9k;_u#LY1W!)lCHlvB(-jGE5^Q3VeY7UW@eaVGfp?
ztHP^WHWNGkQj<`4QNAg*#bFOCmvuD(rh||Ih)tOV8sYYm{MXmW2sMQ`SDN}0prw2{=fpO+1OsSm|gEeNu(;)sNLG6oL03m4=o?=4mW$^$3maJ0xyQ-c1tK@v`EqX~Oy3)JAejSdXl!2kzsi`GU7F`=XW#v@dSIOn`FCu@fLD4JWPFCJv*GwIWO|s
zPOV7(ik^C6sbqaa$=og2I=e{5yT2r&|GBBg^Ayp_Gpb7gcxG%da~$En!rFO-nE8}w
z-5}cZ0#sc=CV=j{|8meDX4G=ydq%%@I6rPV?ml;h1|>{1UE*$&s|nb1f~PLPZl?po
zDvj42AIc*BG5pAdE|sDgIHkGLq((_2cj*>$yk$n*p6$q^Walgy1l?Vk
zOTH03*4E4&hz#FMSqpWR;MtF;e+)Tl5~!Mr1Mxuem%dzUS8IQhgrO7;gF9;F%7j@bsMVUKxYfA+
z62Kb3$}*8a^}1exq~VLr3lEcFhHH0zjdSpHd`Td!wBmDlwRAQueM)wKMKyg1H~H1h
z^V$CJb)oLy;n66-yH0@HfuMmS&|XEarcXD9Lne^N9*b|=A-zR!Tw04uvvxW^1HCqt
zaD1hEL*Je3lS}|1M^J0xDeQLa&XZg1OZPJ`vxNP-;~4ygzUdT^2;~y5
z0dm5Sr%HNWUEZ2o(%%|BbuF$P(8`!-n*}qq2Y`Tx-!2eUToDBs0@9C}sN=gypIkyT
zqDR|wLUf&gi{lN-*7o*sdg8yh2S1TRBOJhmBZ@kMkPwQIgQxQSE-3m))XNQ!3Bljv
zBs>~o7^N|P^&N*Q-v058TE&&A(%bgo0cfN9V_^tFq4Hbm6QXkV%OZ&iwQ8;3U6S7H
z0~5~S>1@5#Ynvj_c8W#@8$od(t>82nMHMW4-d`bwf#q!VDMafGzGK12*uO*7Al{B0
z#S^~xS_1e++a`og+)OYo#M!~3=}}|yR*Bf|JYIU_eW3(^06?0-
zy!tJFFp|j-8-ODwqEh)lV67MyJ^t3@RuCK~E#bChE%rhIWdLMX3f$BGHa#)|4?_N-
zc8&~5TolKK!7En<`!?snoYA_EGt>0S*jnT4m$b575v6AUt|DU&qU)Hf4ZB^>Jkcn#
zxk61sWf-Ta#sh0-ja*qTB9<2;5sCXj#9e5=H{5@XB6w)^Z4Z54i8$(_%QL47)I$CwI|-3)Us
zXXQOs3+l0IJSb&BncX|XE0H2@S(+rHjAqUXxAZwwlZ=x}UjJUyXRwfI8i1ImDm1e@
z>`mL6*<2C@h(5YPd3i;Wim31Ddgtyu)9$&oXSmZ}txA>H-qu@QHA~)`NPkryW%ARA
zo$OA7iEsIm>QKcyK+?@#tF=NQO(k1noMD&w%-S}sFQM~B_=ie%Qt
z1+J_6nA6yPXEEVOs4!~S>cvEyF7-Yv
z(!BhvXl+Q;%IWRyncY5dUa}{LaLF@y?qsyD0=+KDp;w$|ORrq1qth)(XX@M4@eUNu
zjk~4ODEh$?`s6QKUDn==+!P-fnNmgungK^Lf)@o*I2L`L{kJRT^g&XYnv>_=@6g7p
z7O`jO9BrYZ`VUJr4&ZmZ
zimBonsK2Md3%HfSa-Z{h?8$gK-4^Q;FBzf)x9qh7?H1+t9O~)v39s-&WNk^Hv0;+c
zMbfLo9_ejoWH8zgJCAiM1oyZ+_Q!x{k`yYnzeJgQT^e+humEa-c{SQ?b_{5s^wae|
z0|`^YJuj9h8vj&LYLSIxt%B+T>z$o~hfTdtxSnJWlo>p^;j32lDLP2l*C0a-z=&V&
z2AB1n?{uBjNBVf3-D~m3yrEIrxkd^cK*S^$Bd>qee5VG0g?=Y%;0=kWfmz^Dg9%{^eR$gl
zD5SebUYeBb{n52fi8^e@9Z2$sC`ZnQkCQ~9OH!vJ>5A#0_GNt>BqiZoLtLVhHtT{h
z%{XWr|T1np86NvN1S3!PMegVIgHV^GwuW5F|qtWZd~`l8sKq
zJ5PX^?Fw+?aAz0_KCSmK@FgpDly6l!?mty}5IW51^9E=^3pcA7kuWaY?>Y`)9IV6>
z=b20+_g+fvrO!BxX{ZLSnE_UB0#GyyN)BG!3v41GH9(JEUwDuht#ijNyxn0PO(s
zz_zBM+(G>BAj^2iSk;*X`4Pip+buk94<_?+^`D8U`T1@M%YdS*jz*i=2fbVcej$9mMAVNkRRmo`7Rv;n9^7y!EeEKPaaxEtj
z(qO2fqk=;QEM`A?b8RP6T#~gkZ^M0i*e`+!Opbi$7AO$upM~08
zWxU?dR&Eo&0_Wk9U?*?0UYv`oL?PR_2WOJrFtT2%>nk4I#YU&c+&6v%0_sWvP7_-s
zkz|D}^hf%gK9hhEppL96kUFHgOD45NN3l;ety_AffRE}tAmdWV`0$0Vo#gO#>H{ZE
z4Eqf_QGKE{4Im*Z;Np$sW^uUcMpJpJ6f_q*Nc93Hxp7K0TB%8j*=}PjPar8KEwdav
zAbEd^^5N(G45=U!wKboG1gOah2xi1}+H0=4XK;u^NriyN{F#MnIR&|^H9NwYck3c$
zx6!h_OEenEp-LyO88Y$U<>cbQ!^6#PU8TF{X29nDOs!4k@9n{a|H5j3cQ;(N08p4k^M`8|mKva=
zX~u7c=oIRXE1Tz4~%?r*v3~MtWb-gCb8_^RLU!kJm-2J#uSFx
zAxx~agL<3SEa=$00r{dGOc}v4*k=8xpvobu!7#l1Lx?i2JqkC1@~i`Jm;CxwEPN*n
zDs6g*z!!e2)u>HV-jMsUzSW;J3={2J+?)jeBKv{9#JT8hJjoa2xW2_0+IQ*%J5C4G$7>2UZ(PoRn}?Q`7B&p@t<(QG
ztN0npHZ|!t!ev%M$<&dyR!+4>3Hubg?WTGE#{O~F^FN_-`u2ax%aQH7pNQ02CW5MR
zDW*K-BnFtxr9WU&X|W)w03<}E(z@DrQ3vHe;PXpV;MIF~cBgcDNQ@=sNMVMLuKyk`
zLJMce3qv6lWhn8d_lpjpUQ=kvI)OPQYJOw?tgL2=M_Dq(R+fvsPou>@WM-Q9XgKX7
zA2373GVvfVGIO@Ig|y$~aJ0K@?T_5)@~63Z&b9jpGNY2vI$vlo0I%8GAl%rmB;JUD
z_D@|F7W(a7>3n(gtt>0i!rKhnn-q_^G9(nJNIN~U!VcoF%t^o~mhtmvzuUF`tI-V8
z8NEA|xX8heJ0gYNqSkjDy}7}%{;*8veC8pm4_<3}unG!g6Pcdhpw3tQPAAuBinA`@
z)>J<|lgtI4q){;gCKd{c)evC^Qo2cL-dDrL%1jnxG=q_9>FAsn-&YN3P?G1=Dx}wm
z4`FClF~PBRJJf{XtLcs0O{b2imfAogzk5qV<-_Qu{m{#a{4+(*QAtXM_1Zu-f)P#A
zi^=y}2Rc&tiogK9QtJ|cfD8g`Ym6a-MoExF$
z&m*I-wd0ugLG<#pf{0Nb7p3r~D}x~k$>4#cH}D7&5HH>2F+dV(#04j0{w4@x5SC}Y!q36aa0<}
zES9z5e@=Na9?_Pi>BQ?JslbH>2qC)0v~VJt47CM#ki#;#FuO&yxLH|bPuv5UoWtwI
ztb{Vpn`sCjF0d1u!NFS43I7V>BYvW+%Gj~u{f3@+7`K;w=uz201m5_AWeosB=6ZN=
z{Sr{iUnVpICh8eUb4!1>y4OWBp7u!`F6pQBCA&xe8wF&JAj?lx9*tnIA~nUGv&CN_
zGIRZMWiflbW;a1lLBePlw7jH?3M%Lyma;cwFLS+|T-_TV}aE+}<_V9|6eDujrts
zCoB=Y39TJVOLqMdfQ+siUoFQy_&{Hoh;9v*YuSWcr2vZK>7;O>oN56%ggSB3xo@W`Lt$NVqjs#Hu?O;oQW?`va9dZ3iT(z
zk%Md!#>pPtnds1`jq2r9#?!9|QdqzQVjL
zodNm}2$0<_MbA*J5R}ChE3XZ}iWG59xDAhYtQ2AmI6;Fq(
z8sZt|%GZ%e2o%;41_cG=v8mA%XhMP(K>i3?ZXhIARj7)OdQ+KxpNSjQCP#0rG3~X9
z${0P-b2!1|IQHKzGMuB9IN&+R25RcUi=|{S##oW4ARulzJVY8a?(df=U1!}$OHLB7uIs`?&(RifTbNxRFKnC5l`^U{?+;WRVBaIM7k3Z;VHTcA1W6{0T1(;
zIi4f5DdDr7ydZUq0FoG>v{B`WBB5FRGGLp$sh5tGYD-*@Wm`Eq(yj9_@$I!`!prz}uk
z^UalhDe%zlLxW#!S%i^NK1(>-e|EA?J8erjCm<*P=0V)^uAnJyi=9b5*uSD^Ks=;T
zyA7hbqL4G~f3PFu0oak)FSPDSwN^av%JOQLMa^OjfTV7L#i4ZH&zSAAk_1|Gbx2&F
zFbQi`ZO900q~-(ZjlL(%Fg&za8+aVgh-j&Y!8>$H{Dv3CxbP=$=)FS0_|~v!LC@o<
zwk&Tb)0g$m=I*x7d&Cs)pQVLzepv7`^mNSPs1Em_xYlK|m)o#cqq)o~z*Q*glNNen
zHEy>C0B*PH6JOFcp5NMcsxy}Hs@lr<%c@E`Pm#*tWq)A;v=6J*0o);i_Ihh88uuH2
z>(SBKEF5yMU_Xv=^?!+KNo^2Q{W8U0V3gyHQuP`cnDg-1TeIGKeO;&>SS9tDk&SX!
z)x&pNIxyc7ApEkm=&6vz?XHb)^~9$?FTvmH0^AZ}3J@kj9UbIC474b3uvDVjU`LJ~
ztA68uB4ZSWD(YVCJyTUtlYAc9wIig;9(Nyybs19FQMSLTf4iQ2OzjhmO=$J>!Le`)
zeEHd@S)S={(C)8pza!|i=PYVR)Si2MlA>%s$aW_Ol%8f6-ahZ0+;5$DJQ31od;$5u
z0dzGZiE}U9tv14d0p(KKy}Gx$XDE9pOC~HGGmBqr#@i;#H80nU)*MQ@5>4c<;r%^O
zXYxyxGwU*SQ
z8QU^@c<@ma===KrpN-mSTG=G92z>{13~*9`JHgRYT%`Y{eNasyslepE`Nqzv!rwzc4Zoh>>t(97
zYDR>4;o_%AW&{jhq_pvwbJWVY>u-LkBCWmsh6a|-de(R{?qg9}b0jpRGkKDO&#W+K
zEsi@ruBx(ca0yqjD|9Ub%S$1S*{I6G(cOI-_yeVL&xAPcpvxADt5`r&KW1q+oQb}O*2So
zU_eIHZ8AXGhJ|ZZ9bsrB?oz}LbX{=SE8Zx92xzwFk4!Y0Qj{R~X}rjBpFer;qO|u5
zquAfT%ohB~?cLj<`OeEULg5)B*@FmbFvoNA7PnYeih)tyv)$SPy$Ot_PdDuy4
zV6r4D<)r}CgE^7~7;e7VD`)>;lasDh5TCGu7)2r2@YHWyt&R8d+UaTK*xGr+7%*o`
zfdym_@V{g5#H{djK_nm`Y4g-R2nh7lHvl9oz~ev4>9>1CWs@D%@Azk#SwaAoO#=*+
zi7_u(FmIz}qGg5|w_NDlx=}TuObqEYed6D3Z&Ll#hyE+%JeET+FaRqHToG1-wAdKjemqsc
zcNX!@SPWJ&1;PAamXoI?;kBa!qI)z6<%dWdB5r63i)8pPrF5ODC;?X+zdHinK`H^;
zQdF@0Ddk+&-*|UoOp^GLK$?SsS3c~gu0J&^Fz9bk1J&H
zQq}fc{w(~j&ad~?hR$RIG^q^BB9lckE>G8+vr>J2zrWo;tO5FnAvoZqJ;GF&5zokC
zur!d$mOV0Dtp^&?AQlL7t)Gy!9ZWP~A4L#8#Rvh^{92!?gIpx_VOi36yfkzGA^1_)
z-#45QVak#)z4b^m(@N8)D_MCkPNy+UL8Y)N<#B<%37ET*&;~NjC6>dG8IYci(}SX(
z0l6W`WPX<8KlW8~N;LG?ON4x=ROmq%v!x{i#H5s*I>06Wx%4zyI%sA`4
zs#?{
z?YVXveHZVQ<&2tgG)e-bNfq*WtTuor^%0~I5g8kaqXm0LF{iBs^F0zgZ;m;2iN5|&
z)3xRqjggH-wXZW76W3Kvaf_Xi6~!Mr;f?&szj^GTRqYAk8ybI7s0KuWBw+%*nx@*h
zV8CkKXM5+!lJLh+*bc72O#JF^*Rsl3b#eI>2b7iY<~8PNfu?Prw^EO^3;SH4_CFjWZy^(=w}2U
z8M9;L17~35*#_8OVOJsLw3)Br8i|ptbh`+jG!6p>sxNI>G5tff!S{?x!@Z6Z
zw!I!NmZnPZEdVR0-Qt!i=fW#!uMnt6R3V$`Gj+`%@#vp9E9c&CpH#fw6i`Pb1!0ft
zUbVgzje-k_CN*n+3>#!$Be`R&k44fZOc!vDxwnVu_)29YiHAkew@PU*m)fOVjc4WQ
zozD+~udM;5YTXzs&_dJw{&S3s$!e)oEyZZ-@JP=`Dx88NknS&D2@QkoRo?hB8z!D@NQK7I9?GkzG=2S!GNR)m!xlFm(gaQ
z2)MW+voH5N!_+RUNyA`gVWj(<>ERq(0`ZJakT2kR=cQrb)33JWy5F&_iCJYED%a17l&gAy5AosNn*M%5KVLSJUAa>`&%m4vZ2V$jDEUPAWV!Lhl>~!K
zG$FI98|$RfRk*#Y_ar(wKe2(c#Ib2|J3JY4*T6tTjc1v(c}9CNol0VpDmMiE1s7-Qme4kvGTUt{%WsSI<|^
z<{Qr^Skog~Zx2ull_R7b2*6h5yCU?B6`W1m1vfLwBt=xty}dv3`fyor^Rn$>lohWR
zt16JJArrwI2V6`0g(q?br1dhb?1MmVycL+Q#JV@x$(qGO7AMN;_Mb$R)U?Zl$wKNx
zE+t*YvWzFmwb|Ba_p!BgpjjStaB}i;3+IH=`$X*}>11o?o|39(0se;HDKUx*i-Dy!
zHLN_2as~|S_
z1nCBP(A3N->Nnb^lkN{&1~cya`0vviJ1p4G`C*b&!dz)Ts{N69Ypy}@U;QH}f0i8)
zN}CtL&k*urZ=*%b8is$whkp8F>MHdUvv!NLFu@rYiQ=Q60D6)}qo_{va!1jAp%oyr
zX|?q--^Yy@#-@f4LFPYNR_lw^Wp2JI+9HXHN;>9n?Pw9*gN6$BJmUm*9mG`DXVfm6
zW2Wy~_K&jswH6zgFkLC_UsSd`Nx2XtkYJ?(_}+1wi1flUCh@}+1{_Cs$Zs+xpX2V5h_`(eV%dwq0oH3bf^
z3rolex1@j@%9!#=W>$y1syoa=N}=J<&F-d})va^@Nb>;SR|NcuTP~^*J#@Ctxy2Y#gi<
z=E2bNS|-dq2Eu4Y4y4K;6hk9vN7!F!4_0GZton(?@rmly5)+J69x7DQymKMX;Q(hg
z-g;1tO^@!_l2C#YLlkIIOdjluFYh=%HzfhFWsrhInAOU2{VpwORE&Jub_M#{VRI2|
zboQBn_{kCqI6>tr<}ow6kY`$28E!gnYIGg7`Eq`0)Hak6k@U>k)dbS
z1Q>xMfEi1vW>mBVxuYb97C3>h$;#0i*-H8La$#<~2H|)De!e!?2hNR~|8rXYa@CT}
z-#%YsT@?K0P@B><1@p+X)9*QBDJd5ekijT*@`9M&N1?9}cEmJcF6kx6l+O`dNWJQ0
zXtyY+w1E(lQ+5z77t_DKE6pS@-;e`6VT#kLxmvQ4zDK83T2=
zDr?|QvF!JoXq!w_^;rl?M+41qb8+=z$Ap!K7%;TIH2KAFw00M}%-gW>}?&c9FYObDugHK^(zZE<#yOH-j!M`kDqsp4>9s{EH5j72oYJ~_O
zMA=+Z@D!tgzlPse`dh!z=DIJHtnwGI6-uNXD9n!3!4Z1l6m>Kap>!B!r={vjQi|$k
zEBYnxsz`pQB?R`iLUiAz(Q3A4{#}YK?j$$XFdd7B}`UUf@kM@I6j-sU5F;v@>(p^udLn5
z$~`C$6J4ktOCN6!I>W|&rfl0wci|*63TMyhU;??G)x=H5I%)DbZuCmhxb6j5{?bFf
zZHQy-`LpmH85I*3Kh)*Q7f;fk8z3G^{3d2NRV#(bxpTzFW_7L2!)s6PRvfPNhab1ZWp-#er;=I)M~vBYfX|9do~awl?{7
z$y}|02E%b!_BDD54(U~YU<8WrpMmG(SgsLD~shx5golIVtkvE0{Bl3c@4gk@YzQzC(7+6Xb=Q;I7jZ_9EL-Vbxu(Tacs8X%mVIEgQ0sMwKxB!GCT(a{cYrs>J&|lNf
z$wEyiI6)?hil_%{#+2nWR6va;JaLpTS&EL;Q38PRBQB0wbAJSnIii6ybyuWcVG>jz
zS3FHEk5i0sb^u38VLuCMVMpTV`uX|z{(j_a_xguE$ZmN0HsmHi5Ax$j@lrzjxGE>&
zdHccJy7zh%$_1{X^cI#J=B&9M`EIYIHr;o;@&CSstPOj{!M;GCU
zpDF+;Eci%6jw_325j0}ks71__ogV!B
z6nL1o>h6FBe!dIbtPCEWOK0}tk0Df`iq|#21%|c$owG*MGiBF9{wU01&e_plzrfe_
zA3g4<=Nx#Itw6#@5TCIb)jp5k{B=;^U6ufd%Zh@5J|r?kBjj}|qi|!dHF?nGAg&`T
z9pJ(Q{Vo1fIV@EPEot3lo7!AxRSO7)t~yd}VACud&?-sVQj65oaylgyi12!8)nz@)
z(7XGZ3zCebyw+N3))|5;i48BfPM+R)&SNFUee**0leY(6OK%7j%&ckp#g3&Nblre8
z9!#{Yp{&QUqXNP^>d2W>?uM1qinjpvKxvaKzkgPO?HvvWO4f45I91*O
zzmI#KgJ08^yIsXw%_mvd+xcCkEvN;rOKk2Bp<8A&gJ%myM-~~Pi7vV}<&GA1?Id}%
zuDh%!a!@C`NoOUdwxgJPZZ%MgdEXxc#5S@NCO^XzFm@ZXxBBDCXaFZ&oBrZ-l}k~g
zl4u8&it}r(pU-LDH%MxZ%)XVBMJ|kD=B?U6><;N@$CWdhSFh!XToN2
z6XXmeg_0zmx4sN*c}(sAw~y1K`a8AU`bs|)VvAhAIEl6WQ%Cn?xI{=Ycyof81`U?#
zcFwzWg+=ycfka4sl$%g1zS4JU@M-9w{oHK<%EFNvu&+z3ehoV%ic8K`usI6iP@D}n@NVJW#jt`eoYZFVV0!rI@>
z3_3`+9Uw-lD}^ffRfE6N>A60oB3X5}^kD^wa$4j%q^v%c>*Qf@%`;#s#S_iuFoSlE
zQ962;Blm~4)BrZTm1bf#KX%#BK%%vnthFIeDpt)O5~l+GxF9r?@Jwk%fjAd&WVQZ6
zI4COHha!^T{><|TYkbnG6GK!!TR+la+0j1GR89jAppB_p4~mH}i{$mbC?AdA+YVx!3Gp^D^{
zy6fAFNR&{@`mzN~QdBRk!R<9y#eHfXRd9QXAAG0*SQ;x7eZ;?fE{V8VGmmCAG2x5UXG!hp
z4XlIgYynUlJRU#*8;t%g{o(D;X$PvPZt&Sjy6B=|>`VdvNui6}Pah7Dy&D)HtcQ4G
zsjM&Vok?(;Lg*3bqd%=JJ(<`mXYyq>_0lvU_hBlbeRm=y_$3!<_3Sj5dTLdtV^7RW
z=+?L^MHOyG&#?($*BZ-l+2U9UMfp^mOfiQShX73l%1iCAI!GFo{GF9+XO^}W4w%;>
zg!YID89Mx8<64Amh2+>)cHgR}=7ks(|ji<
zbf^077sHCjS6eGY^#u{Y)Cu~M0tVmFE)8YY`p-5?_06k4qjVyk9t|?CoiVh3Zf-WZ
zH5ml-Ok;aP?7bafSbM!^q&cgLmEQBs@}Bqik2g-de6^Yc(a$lZ6!(~#8KIxA@bo8J
zXWc~}3aXCpS#sHGf30nSroDw_r)TP+5gT_SwF~a}3_e5re;sds3M4rs!aw`%ACO%~
z6Ldg8{UX50`stu($vu(K@Xa{6kY6lTC7)q5915}yPu`vhwo%-V^{~8RMu@e@hh&l_FsTYnkgR-qit1Ey*X-hcf=KdtUC)G64DmjV9;k!N
zJjEPpln<)Gwe&Ckg8MNJ3sOKR9SA7`5Szk0!cc9x)B_>J0#H-^CVv|y
zc=E-`K4{P=DX^lif|pE*5{ke1{gFT>`A>Au_(?1`eGF>}&N)GJJ9&GAuF>4bZ;3RA+64gBbZjcx!EPnh
zDI{!oZnzaqlp;L`D$elNPM<5%*O&MA#Fq_ExOTt$pVZLUNttvrcTZVqS)*W5m-5Y$
zPJqnroxzk2a!RzA5?U@bi;O7+(9l+C!{nQM;!n}BIPt*Qa{j4YY5pFBKd8T`NX#Xx
zA%zP^+Qs#$a^Vq4nOXs|A-$L)MCG-lA#z+O(szn6_{X7*3!zBc2ZgxG3{^4YXKiF>
zs3K%M<%$e(9+&Ka3&>MYzfm)VC@thm5QDIkLy|%B#jA%s#?AY{(i}>L5-4UQ6&Wx#
zCu`U?%$W+WsQ4}y2$l?b#32!7fKw{!jt3UK@!)AR%&q$TR)+v=z7CQ2Yz|mCsMNSj
z_*7F)qA&>Y^ais*Ki*j=QwNoz-KpJ64+87k1?sR!aQ-gL&iNMp9+9Q8CuUbki;87>F<^aZu~_2vt(YMYphf$SZ8
zoLaB?Xf?H+wOj&pG;zPd2&XlkLKa?;KTS6zRn-V;+ri7rkv)$+q~CF!w%U>^Ftx9R)J}zl%b*|2X|(Mfo(3Zo1nz{q4
zLq^PWZm7djz>C_IgB8n~RN(bYs`Ix9G+m
zx$a@Nc?LbpRPGJ9c~u5wb6fVI0S*(t8R%=$MrDQJuE)6ah;*+dDR-q#r^o&3<$k1N
zn+z0O8j5#l!homz*A)qK3z*6XYZe-32AvyNJlqgKE|_RKv&`k#7rwdf46BRO#P596
z)d&(_B4$@YgB3ME-o3kx3&C*V9={;tLP)R0X+Zh94zh6%LJs_cAR6#owS}-VaN80Z
zO6F$I>O8lhvej_jkKf0pN-EvJww0DR*st@RSIDVsfx5V{!J)*4ps#@lxXax?EhPY$
zhHnBgBFI!k2tv+R`!#qEPj&?-ZDGp;i9MHWxftX)wxS(Ez?%^+5>AoNK7Cd+!9ECm
z+L`Bb3Z2U!d8F=LCUp5$@HMqjIay@jre^izKh~73w|Xx4syw#PN4#f>zhihR6johp
zHp|W=5DEA?Mo6ajqZtlsT(Zx~l>i3%YkC0h(rWGk8!uYa0B*{x3i)#%3D;LJowyaY
zrN*ZU?3{;U94+g|t0g&}?3064KkU`*vvf56i}R0z!@CdU`-iCO@D7p+_^e0n1a6-y
zK)PkuK){h=(jj?K!r@x<2G=`2y(K5?k;?p38hpKJrK^?tw6}K(gHBcGEM1dBk`@4S
z+=VX>xw+fSkSh4Fbz)CJRL#b$Ts{U-Nw^}k8WsI>ZXfkyX3dM00#u-nDv`rsNlb%JY
zKoLO8r=`sLc7PB{5&2CJqLhEQ!desljqFg)S1}BfMn<=C1c3GuFZ->hm)r573IV>1
zaD}Tb+_IOqSf-iLl_o(Ewy1kAjvv~`PJo|9Y*BHLKH<;Mf|UJ51~L{vhJ@6OXIY|s
zgb2w+h!8z8f21nLNv33blrFZW1sXsnhlZ%c&s~K|{&C5N8C7wUtR~;>h$f~QzTWZpnyT$n
zuKexQRO#>1`O8XTiCLgBP$Hyp{_r4f0qUHH3=+6m7$gg+
znzW#NUkp5ylx*jiBgbQ=9e*K@pc2fqhN?XAK{}qn5Fj6aW&di_hNfT_q##=OsF10Q
znVn37^OBxdh%Db{EDrR!wAjQiJT<7|K4_G=TRBRrR&l|;wDZ{HAf6+8eg;ys(;@}_
z=G)+9QpntG1b!?%99APQXiG52o_-nZy2}KVJu=XDKnP~va(#wzvW~SD9WwnXqCRY1
zrY+{U0kFK|+JDSlo!2Zyy+O?k3bBo@L9Kw8}znN?Q`>y
z4TY%Ur+=Mq;4c2^y@l+Y!R3A!aP*Y4o%SHP+2Dhv7#<+K}vQ7f^cR^2FVZRI5ngbIqix)34JM!BJ0MCVzQpGNj
zE*zlHZRK?!S}>o2v4Rp})jjS~cA7DG-?4E4n|LI&F6SU5wiMkQ
z(TRn#J9{-HNwU7}32c=`Ou&k=@oV;tX8V;-zO#Kgio;d%lEIA4thJPykFnkLPQ#n?
z42qE7R5w1Y3wqXaT3viuRBNjFCt#R~y%jKOz9~;3F-qqPqX!dfk%Tho9JGFo`xDNu
zsZGG-eTr1Ij0H$FHb9G3F?2JC|Y6opxlI(>VhhA;ns2pi(%cDthkXw(@D5rKPkaAGy*=H$0l?=
zpFQeJu5)%X=Jk-QUayNguGy~qiSOz4NEgXrce1_9v$!7Mb5fdZD<{g-yuu!Fx%mL+
z{q$5<+sPet2-OfV%@(B5%LKS!zD(ZJH6|D!(2u4<=Qc{P)9O1e?_=3ny4q@fRO97u
zUQNS!b7Xloj{<*Cl6?s~!FQGevj?dQ1dXiA~cR`;ye>hy&^iRv3iES6)CqzJ-hEFYJ12m(+Tx
zr@RI>TDU0CuwY;!m9NBP{5hq)mwNqU1e#i49J1%KaT8;7xrP3;loBRs~=?~OG
zky0hOS#jpxkHEN;8!P&bmhn<(dnR-1=oOhpz4QY~J^8FEbR(-NVVa;wfKhBZs}~TC
z+p6R`pH=+WT(xhG$XvP7mCD}!gkQo9J$_gyIUhzBI`LncUuh=^Ssq6<|AgfkKx46=
z`TkHniJdsTW=8m?ptHXzXxxm%??6O`^5~L`1p~?xn5@m;JG>~sY;R*g43zxXD<(@B
z$3lt-77{Izq2O|@*FqS8-OH?TXOqS;!916$Axu5yOw@QEQl@vl;&<9%%63_n;Pk$D
zWodh{lvo*TN5$iPrsUlqK}R(7$7Th0tilM#jpF9&DY?^yI!N2>Wvly`0!qwci%S)a
zkC9{cdqGsDw8Q$$8S#MyHNJr&;|U{@lN)HB5X;SyO962_x6FX*rx>(O9a#l!YgHJ{C%>w{;)sU;{9F`h#kbuQ
z)bGLDW6H_$nL|w!yJyINqJ$=KxPBavom)9u$CAq_&0h@29C*?DNZF8IYP29s+_Nl#
zsaTlYRFy<`YgnBUZqt-jDx>u2w3I8KcDXc9OvkyjOiaDZocz;vmNv;(*I)wl(f*e=
zK-FwYt+J|Pf`F5decBAubwS87eGeJYaYj9e@`;gLGdOfU5#nh6u^N&RFzZ|;gu^I
zWj?#?HO+N?HUFsIcka8iX$S9FD5I3VlUA{K%Q
z`NiM3@=!4IC$d?DTZirSy;E}f8nT!e3!|pPjt{z7LX_$hW!J(B&+LxSa!^
z6Em0dBDC>*?J2f@J8S}rE9Q%B(%Dc|&FU2gy#9Beysx42y%mS*eO0}!ZY>Tp9)`zm
z!ShR8v58b9IIqy6Cc$HWvo=SpqH0<+9=X5-Yq%d}#&f?8*yuh7*inrqz(GL^(>g{KElJ;S8yU1(pUEWWYWxLROh542OK~NBy_r;aJ
zjBt;d(n0L7NThekv*}>AXP=eaS}c(o!F&5&xg=m
zo#UzBqop)RW2Qe;0KHAn%mf+i_}w@_S|K@OE+^q28X(3V0=ucTzgxdcj1N#Qe-UCz
zx6B!^B#+cbCrJte$9cItSgZV{4P1kJL)c#xBxh}7IMmg>%_eL1Ay50k4mE-?hv9{!
zHG0sO4aItw9MN98GQ=Te!z0t6=>WR2GS5ho9~0KNPU-{G;9gRweZ12?6IY4Xr)(w~DE*_ESwEj_E*B
zx{hiqISm#*3IN6FP=W%{u6y`VT)2m-**^jZgThBjvT5uPfm5t2y84dctN%lwCqMRX
zTaJx2$BOVmB2XUCAv9knH0fCDcS{%M(0?2J6Ps?iH2iVLVhDs(AIw0L54wltZ(h4=
z!|KZmYXRqjq*NWg;iZgpP=2DdwGD?J+-)Br=-fER{2lxq
zaC2AwUKIUi%+nR%2}h2mReE65`my_URmUSrt5CS*@7f8KJ~Mt~Hqs+UiJ1Sm0+~59l_Cx#3GpnFViQ8-Y
zXKACjooAe8`TCb&%tkAr`;J7=yWrBJv+1vd
z6<7l*^=;P9{ZDTOB4iApKf`eJ)^5hYfjKtIpP!***
zLz7Bx-8uR)!|y&ti{5&$QB#qpqz0V&J|$p9Cs^K3e+uQ2b1iVgj*
zC;HL`K+FPz&F#@IVDNo<%K0bio*rCpYt9?+1PR*
zI2jfC9yNXVC{2AhR=Q4~U+z>k18JG38y@x!cZ)UB0&eUF-Lc;q!BL79xN
z3t8?EV)92p#sP&R(rSF@a!U6x8e>KgxO6GkG0wdOwyq;~AD)W)rmE0Enmvc_a}NbJYtXju6mm^m+~Qg^V!QVe-%O7y!1
zBLk3HnM|;Ww~k>74K$REatEt9l8pKwKSjbE}Y?8y30_6LVhPwoUhJ2wF+lE3zwYc$t
zj!SG=R>h@}Rf$Q>xc6)#rrmhkE}xI+?c5%`6lh1^dzq80B58xyj_3ha(6#*bk7%9o
zrSR&M4geLSBb;e>`LfWAZR_}T>iaCu`Hr#HiPTca7OLi@JUA2milE&a=`l_S>_HIb
zv$3|`!*FWlTv1w}C?%MMFXuZLNeZnYh%?k$?%~`*WJ4^0IM?zGo6Oj!%U@@b>rKSz
z1HW8T=z%%=KP#*}))l{=_wREdER6z6%X(%QL;)WhYYwiELqBfTm)|J~?oUABf+3`&
z)zf=~bVMbNzZzp`4&Ag-Jge24WI2~P4r(7-uIpSmEDjn?YpS8E1{qm(&iXKu#{lE^
zkqc0H$6Mu3`erS$m}~w!eBVh})|dN~TnG|4Nt>xH>qx{-wfs2p_)!bL6zThqt^1BA
zi~vBQ2~u|QBepHum#sNae^hdiUsDUefr6JqHAx!`{_F$c9{fY_E6;6_`)QT>5(MtE
zYboE(A=g4z^k}$zxt#h++hXIR>sB>&vEx=%&Gsk!$;C>h8}Hvt@mpN3vy+CS-1@PG
z7x;BLXSU`wr_&0udEMeEs_C@S`cuDQDL^KjDw|y9U`25@mrm|<>0Pp1<_Z(v#=^^w
z>ZOT-8zGC|S{DV+x2M(JR-%J45)MxC>j@}s=qQ=Fr+Di}nSxgpYZp)4{3PV6v+25m
zO=Y{Kg9EK|k38i6d{Du^AGGq6qF&gBB9Uce$ea1^KWtlmS_1=>=Z_5l!(F%k(Te|d
zLr>NESpS}WykUt>^=042j`7`4Fp(Kw#9kR_lXs$KO@>qmrlo_
zZF$%JL#Lvjh@50L;z+%W*c~8ij8+H5e$16DDh)tm(!YaBIs}uAF%)4f7VO(g86|4s
zGQ)H{n5QJqpD&1jPe66!(0<0&|1qShfvCw#nt5W)m$Y!0W?;;kC?*esB=x7Cc>Y7&
zp8SGntdT>6svevw#u<8!#}L_ynVHad!X_?yHCA#|bZB2o0+itAx7jl}Nv;@a;d*1F
z<+o8<^QcPEUpR;%IE6tw2zQmP&Pm&+%}g1}qu4lLS_zRfC^aeIzS8B-@cQaw#RD!w
zr6}*XOlJ@jfhux`h85PQ!-(+PY>TsibSc$A~X%V8Piz?0m
zb4OD9fBreLjxf1j=Z9)Uxph%b(1|r#7yuD&sZbMN39gGNhqn+fd;V3seHrfB(&hSq
z@7e`rtQAz@V_=b%=bu8)#PhxNSEHn}bzVMYC#DkqOhG+~a}SV)m|d282<(
zUQE(=`{#7;Pb{-VAml#9)vjJDxpWcZQFO)MILnL(4ewa@I0qLHDS9A@xnYSlM*%bD
z#d!u8x=xb0O{=8Dq(UUlP18)vODuF|4zAspG|sbd!?jh*ad$5L?2Ok1LOtjA;EG-E
zajhEzKFBBFu_tdrZ>-J~ds>@^1R$t!bpm5SS6s0E88q|A9^M
z<|%ni_Dzm|D(G{5sps(B%q3ZK!*7b54}hR~@VYCM-2s!SeEae`W9Qy!3LwXDDowPB
z?A#lCL+I9f|GhH8N9PnhKDozq)xvtF-plr`W>~y*M)1&XmU(4>?|rXgM|MVjyMAs&
z+lbd3?Nb0(UFCDoL>8yR9^+H8W_U0t#I|QKOj|&3a(ZSD2h&=$t1E3xlIFT9^6J3$
z5prUozenyEd6m+b`h|nj3e26{dku*R7(MOs*I?h
zK`U`7`!LSwcrB#QBfLIS
ze`->5rQqqvoTUy&JGDnr`?vUUwHlGeNOmjnA(^Q~6;q8xpYWdjPQk}A+N~gCd`ZSx
ziU2&u%hVua)P`0Oeqk7*D0}l$_vX6~MBQf!gNDNv7ydb>h`vEJmAhNulil}DhCoNrxyeY9Jspe>Ci
zs_OE?8Ro}<0mlX(>q07J>Hz%HPj`lM_~4In+2XSvx{OLKP^jleBjQOn(pl+~3LUTy
zuZ=u8d!D5SfCOnKJs^6(#+ERA5#$F`fkvk_5Kbr9`QMqgW$)%tzenSV$6oy|xrOMK
zk`#OW*DlFJ_@cN?@I)X}2g)l!EKg3J&L6f?Un5Ni>TdH2KkG51;7?!jYC<;xoDz9(L_yH=L9j%sNDY-lYBfCQj
z?!YG|iC=Z!B12B#d_JYtN)1$}!Mem1`4R7tQkWA=O5y&!K60IYLMG%?U#t6+kO?`o
zsN(%(nkba-rH3=#xz%Bs_QD04!pIz6y-72Fp^XVXYV3LO>AL>EBKl})Ba$r^;fip-
zAy>m+JsQ2T9RMh#^GQER98s8W>IsRm!Nh!FNap2bB}7^;(&--N2S5>O$|0-0fkJqfgc?oovr^xmt%8b9dx|TNcuYWy{%i_DF
zi*9_&0o`Za!eC&yV!RpG5!ZjY_Ji^MO??(C4cT;&S=
zTBu<}NA|3eEfMe$X~Z|OjM$A|U^xFMLOE<7i1MJw9YWChNhg|X*ldK09e<2OMC1us
zP|YnN4f{iW?(BYwTgTDn%Ng*A=$1J%Fk6fDf@IbgL-&X-{5xB!#LaP4?4ec(O~o&F
zZ&=|clY2$qY8KYzFeig_V(5kX5EL{gD&l{-_@G9KKYP#^qoL}#
zOPp#X#z?-8r18fx%B>h&o
zX0qzM4U7;}jj0vGNe8Y~0AX-2?mO8R79IiA_BQ$2GcVoKqvR8X1>GYEQ-sI$ca&DbQw0Wh~v}@9~KAyu4y%Ni#2lfC-44pl8
z74aEz?S1plLKoLC6c$`cpKj6zJ=4u@Y2j#0Ab>99pHoZHk7C>sO6cta6EGrfEL1gX
zL&YQp#vpKq1xVV(ib63GK`WLW3GfYNWTW~6yG7>pDc;KQcPy6JV_iI%Q?zX)sGRM`LMC+u{hBwy$rEfEjL9?p8Xg%(ljN}Ik>yAv`J|4th*4PyQ48T3!>9{6%uQ}Oiqm}-TuoGGC
zd)W2?jsG$w=~vGRZ(CgH?TYqs*&Le(?nRHk%ds)*0{HAwiLQr|#+mjxO+#4SEC>x4
z$wHA>@9vGzm?EyJ%c&s+PLTdr7sJ|6X-)b|w_L4Swh&{cm{i_@_gXv5RaI3p69(IF
znD5;$8NgKEX9O7J-wQt20Kq4(Wr8dn*mQmBgk_dh)sowFCWtD@PA7P6GbtQ>s()T8
zm)!CM7BmjD>=X$lo+MFPu|_;OYU`#I%4=%o)Bd5F-l(4EN)pO^cDD!;vapC`LoMS$
zIJdQJ%dHV{d0Kl}f%~J%`z!Y$yB1Y5@&WY|@O`E8^>wcPUqb8m41nqUPes6^ch%Nf
z9)Dy&HTP@qqzv;-!VE7FsUuA!SAW~`Ofc4Ryx>>_k%LeBdFamL?beZh#W(STk_TIz
z4ooap&(3
zRVT*b6<1ei=j3d88iw*pYb}eQiXsqwEqf(#U-ckSTFi_>^qjAqDU6tyxS^~J8HzBL
z_CM+x(|<7Y~d~y5CoyC-0P(T(L5{O5E^N1RF68~eWg0&#-3Ty>$SPiMF%Z5*)%moxU9@L6c(bc_Pt3jjeK6*bnkUo&(eCV*fn&9{%9n`W@
z7&mL%H`D3+o1rN|eM~6+xfR&S9`_@+%%!TyHsMPE7BBa_Ru5cIw5u{HgmMLs69`!EWof4mDZ{~I^h!bjGwt;(!e&p6L{x^J(
zNmU=TgGN5QQFor1^4WI1E32f{-o+S^ZS%dc>nHl(DQFn5N9YM%KJM_{_@eLJkNmd6
z`XHrQ>~$>C?ib8;?o&kPTat%bTh+q=bISaZ7o%C4PQRKQlvRDj3t5>Twpb
zxbLTJsdb4r?Px`C-_V6
z(j4ni4|LE66m0!~-eWiCKG2jra>+kwJWH0!%N@HIP!q1WJV|j*j0!*evp{P#?IAlb
zeB8&40aM2{SVkX3(j0q|T-kxI_N6k&THjAZXtb8lN-1`&j4PcRUGRO4I<8L3ZZD=I{u}>
zzF9vJgGZJcIBOAOp;MxZ8kssZX26XUe{2H$&W?XzonbNc%z=Gqh$-{!gVo>apm}O7
zFYYj^7(<2p*lfUI&(yH
zh`-lp)U0Dbq70-G`J;k<7(oK0%!F-9BjcA1u9?)*Kv28l7+@Tk4huG2EXdP5&$9?`
z9U#vyxl%Y-R^0=weIqWK*C28bfR!MwWv3vJXR74d7E@zg3|3nr7Sykpf6Slypi62P
z`4XGS)WXKp5H3*wtRc4H`c$$32;EE}xX^ns;hv9w&%NYC5y>RXl4)hkKl~ItGa_hV
zwsWo&9pbn?(T=R9t79cW+j3(yA{7l5%f~c)ItZCU5U*}t+Fo}0fpJ9yXX_>!+1w@W&c6!1LjD&A1HqdIK9AujYlA(
z*buwL{5cI|n#Xe=kB~>#mH-vSHP;dug~jNG`;7!?8ZFXP*TTCXRa_R={AG
zk!nXzPSw<7DMX(`6ViW@U+`DWSy8!Qos2O87*{)^PdZjnroR@|1gY+xagH!4+7|nJauWDiBjmryhP+V5
zi{X{2dv?&V0d^XI=6J~(d1X154@i_C*g}ct)3unp=wYxl*d9MQnz5=Jkn?}upn_5+
z4x0|Ak@;z@X00%Hr?dWC9ymUaw&VX^X7t7EKFA*0x#x-OIow_Vm@n2F<(KW!`*L@c
zd*55>9G~2n>XeugTezsd8`Zv7IjE$akde9cda^hJdvi`7~eiGg|lsfg3F3|E#RD=gL?C~Y3YvbnaDZN?Sl5H{Vx$8U%MkO@7
zc;>{9cz!$HEYMgblQ>_+vq<~-AC!Ms)=QARd_EwRn2VaQX1KF(AL9zSn5jSyizo1+
z)qKX43JpK>0331^RiC6pS6lJFE}5<{xb2r|)k@AzXm
zDWuXv?F?Od(RSFAX`8ta?B_mRaUb2OoONlF15R95iQ}KHC#FO+O*UqhC{&$y4;gAW
z5gCPW*c=&7-yUe^q?y1w{fPhIh6lrm9Iua(V=D;O0FufOE#pN*TVwrCN$*&W&g5FN
zya!7ez@_~N87Yrie@l|i;5Ua}O&)F#bP`n60>*laq{zq-cZyc>g?T0xk(9l&JY%2B
zMYLYq1IUp3#Jbovm@a*O4NvTZNt%C2qje;`ZQ3)YFe-%6FhS#aWszH{x_`An7GOcsm%UFbR
z&hZ(w#wIn#LmicjSp2Qq+En0sDpP|>2Enf>WolF|B_xYq1?r@tge^Xd3^j}+g)O(0
zrVth=42n<+Xx^%LL@uAdt4{_XZnuPEr7`MkoAxmJrO;Y1PX8%t=)nh;>d!+|q^>vi
z`I|b#WG__3AW)N)jm;w?lqW2m>IC-WfjANG#sB(0M{t{e@ZvK|ub1*T2`Cngn{wuN
zRE^;oA1s*Ww;r`3K=50S8X{6gdccv4^#h6mK#xWt1D#aFsVxsBA}*w)X&EDukOoyH
zrZBaupnPycfrFTo1=gs}0%;%^&IExLLs~4E2?mW!f@=Eh^lB#9@oOX`PP*@&W_gP+
zC6v>a!t8y0EC=;YDQ@Ma1`;wcA_(ge{aGW&1Pu5xLW2aUk)W(#9mZ1qn9xTl9b42C
zK(~n_x&ri-jJ&JhpY!||j5oN9G^QRb9{3-%pc0%JFowBUE_!#u&&bs!GU37JWgS1{
zPL(~L5GzF0$s}Nj(xM&durgS>#Zub32#vlzG|+=}pIGKx3uU5;hnz5E~YVR%f3#&94d^rKkU!%(+$
z8RpVpv(E-&jkI?z!L^KlMV>`D
zT~Fxm5@ya`ewF7pYPY6g9eq6UAVc7A(Tgdu(osJ4$Q;wfO3TiY?N7rN4?c{w}Cs_E)(Q`lq}dW7r|eQ<|KncQ0GH3X_|2=
z*;k2vjNrK)7wq*Zt?LD%J@W<_gxA&~_&w!&IsVGJPTRp$Da9I*hc&OkdP0^LvYFTe
z*b`?oO+6gJ%#)xaR}f6aN^cmlD6Ds&9Ly*zvV?lupulavxYw`!dQ{m1Pa=fLg;ysg
z`n4BhwD1@IIiMHpg@P(oAixvD9p!r=_QsuxS=YDSt7Zs_R?6lW?~x6#N({@6;WlnS
zgIrjcuYftn?80nP%qU~aoV?gnBK9XqGUnWji~rNFQi9t+`uLsf+_$v0Hts)0^olfDtvatfaPfbrI;Y^u!mV9*
zY;=r{ZQHhOvtxERsMTPJ((|K{Azs=4aBST$;VV~+QEG^>twe+=P#
zIvUh9Qw`%Ce+o-=aXIKE$ArB{FSPGllsI0Q?{ZFUab^3>`Pb2RU{A%~D9
zNe*A}`+UmW=-nu|Yxr(q>9o;htaW=J)Ryx<5!*-f$9j)Vz>Xs`ek-<7mpUOt|8YAL
zq|7H^URD)-&k+OxX9G-k+G|=&^v%_oNyy5}`Ei~pI|(L$CprDtfhV>4_ivWF
zZI$jrS=W)gVpHVNA8*gx`_`i6m*3?6ir;=X$A{F|EOWF3z~o7x+{6uHC3q
z)@c^l+hn0qW@geD}T6C80RAt&7f
zmz92wgK0${{Q-{qaRwFBcLw}>;RRDcFt-LoO#_~dA`;wR2t0PDk|z#v@wPWVl*k$OYs+4D|DxZO3m_5kJO0C}9OrU&
z`lB6EPKYTd^ssy5*7b6Gn)>Ldw*})1$y&x^mBP}2kFIsxKE&Fs~%2J^Y{X-u*Vzsck^!J9tl?2VU+Q`B4s5_dDIFrg~cO`Rvjlccm$oynq
z+IxFStl@B9j#64wvjNzA)>DfAH(5N_n6*RYLi3r{;H(y`TKJvOfIuW$rAPE&6b!CC
z(*+Q!al9^^;7?8r_#
zm6tmQif($M5Sm+E_QB^pN;BbL3PL4_M&V1c5UKfzeh;#F!?C<1XVBOx4}4Xa5ASDK
z><_M^rF%oL;47Xfr4dEruR_mX8c-Nx1z;Vg7DzJxWT;hCri`}2L;8)R0%dIe~|Y
zLK34hQ!BHbGYr><++gUe7VCiF9B4&^d9+)#>2AR#*{q;;BMl}0^H?+_(*Z?w`6o1S
zNt{fOm_{r0pYmJ~-HF;rN{0Y65_51kl<&j3&!)~Z!9?HhF*54fXn%rM?E`ehGBN(X
zJ*(yLitz`8$II=5s!S=kz6un{Mfk~=r&tH#_+Bv9J1FrVx)Rgc37jc^nTS+&;=Si0
zT%EA^(B=oI@`_D~?}G|upIS%zc*pge(y)E#a*vY#?Y2X8&?;PBX9O-6v>g%8
zQ5%|J3RTH)X3A{KFJ1r;pFqIo@w#Y-om2gIHlII2u4V>!@QMEX6*`^)r&ZmwSpl4}
z8ht<5I#EG%C5s|&cC(XzF#BFyR%ke5?0Z+Tfn)^Nx6FM+<@W!{zI*bF
z!yfp>f?870$0xn1RaIE~w`Gr+
z3p+VW_xjJES;G|qglP$iX@dS>_F0|LjPui{MVo)ZR$g`@8EJNu{uvz2B++N>NVdgo
z1;uad`5E_C(@~Zz^E~GUMmi*Id^^58vr(%J%km9rMIpo|I@Eu_ts`hK>i_jH6XL`C`!Bc!mKX-+zfaI<{_n{rJ&e--
z;I4ZAgvBSn>{g6$DMZ}=TN}r3j%R`SpCIce2aMEzf1-&SCg{J!SY9ER`TxBMC2h7b
z_$7f(<@_HI6gCF-d$XuGOb`Ts)_$Jc@~6r0)DICPgzn!%9wodqw~URYGEv!zc=~78
ze1^fn08^y*2nwN}=neiRpZjAh^Ot&XGOeXaQWT*vxZyv>m&7mQ3w)JKCaE||0;Ake
z8Z<&e-;GY;(=8SZ*P^E-mHPGyYJ}ooX;v*IC{sh^SkDb#3Z1Nrv>0Gpltc%SqvN~B
zo}E!chrpMjjwEGoG-)g(SKLGVAEhAMzq;7u=`?l{1Z|RV{HP)vp9CS?PoC_IyEpZ7
zII`aX*E75v7k?CCGk|39FC9!XM7B2D{3l~-JWW~|GR9jq>W?vK8(Wi1?$N&?!!4Ua
z4`cEbXemFA)_>Uz*uf?9A_VudiIa-hqJ`MfNewhc&?!UTJC&!(quUf)Oww5+GmgNw
zeaP4uw2G!Xw@Cgq%ldX?P*y#xE8ln<3ZJQEO#U_iAL*5zq6XX&CxotExQrP3Rr_ku
zw;N(c+`XqOI;&k=rn;5L{1|?g?n+=V;KK~mMp3L&L)N%HXjUiSkP7O!r0vVkOQL>8
zu#kXRB%wZZ?Gb42j2}{Sli}e3!SOG*HtiiA1(U@6#!$QC4zX2Dp?P;!1uS{lzV~Yb
z7VOP`l6z<$#{nq{dK}5es`*o%%k`M2Gw+YLV-5>7gyaI6_ijCyiqy=>RHsSaVB#(m
z`VlM+c2qYeyJrwLWJM)od=*?~mH_NN^jQ+r*)VZdHsx0PoJvF_qpxirBa5f=@|HGJ
zt}U{~{raEcmuG4$hzpS$*y2y`@=xj_(anq77r54e@kUz1V{rF*W=d?KH4(743QImJ+`0UR5
zt*Fp*;P+$&lJIXV*3|RYX{YiVcn<6tRVR9hwA|*EKdjphTa^_0C!fI!OfxGog7o}x
zVp8!`7{D(koO&H(R}D_+{er(+epRHb*EhmCs#TQKlMGg6IIzuA%TGa3a4p0drqXP)
zT3Ea3jzjIDyNT({2$NxCw&=>|fuRRvVrM|+tkl@;3+>jp6}&rwwQvoQj8xhV9l{l>
z@q)}=qNy<0u;~827JuO1j1}*ZLClmY28_Ie8eqTE3TBrlsyOL^b+RaFWJub)EbH{w
z=lk=q*5_NtXF-%f!a1HF`srk>Z?l!R^>b95k$YF`XyG#>#<~2nOIXR*GI&!qe2B%0
zUO~Y>s^oPhW8cW$(9ZUns4?NH^ov*#op~KBxfxWP{`u((gwqrts0OlwceKLaLSS^O
zTkS*o*S1hs@-W}@Ex`rax~Z(t-4zn-B*CX@eeK6hiLpMxWxw)eOprU!2gh>(
z!9(^lZqM56{g19Q86TCm>5+rIiyWg&Ia`fvbFg(^XW(eGL
z_UCjV(;5#r!;{Ak3_bW2J-=t^>FSC$lcL7Xa2`21V*9~szLpIG>jDxaJq+r=Y^3KYB2ehLt?1l`1V^jT?pcsn`Rkd6L_JhRr$|Hl@9%C{U
zchj}VLnr8PTCdR?k&qVsy?;q>r14JUF&(gJ1p^LC@oGh-;80S$d|su=&dfPEKg}7n
z88YBJCeO-6>EN1$*`*_4QbXRD8QqcsN59#i{wg-|#V-7(AUYcw8=;feZ&0l-@VU&f
z#ZSPwF;pwnKuO2KeO%t*eSJ14u;ue+c7>ZlZVICa_||+Qa7gJ0z#epx+=t72hEzytZ2XnjiCWCMtA_CDJQf}Hs3u?}mLVkoHBSSsWv?KPn
z_?|Y5pq^&Du|LSTVrP&|(N4uvDsAOjmt3eL=~B22*2bK=;co3W(#SYEj&>icz76lcm%5x%|RS8
zx#J>?<|cf}ANDLX)=fE;$u`B>QSTjMP^S&%s&P7%mJjTW8DbL-z=>7HB-GK%X*<-1
z4e}6oO6qlY5YfAoF1CsxAbrq*ZCi4ljIN3pV8x6mXO}6XVWKtvHe}QHlh~(&z6*LD
z=%{aQC$_ERwM+i2y}%8jPu~D%BF{$q6A(f?qlM5khY~1K3<4!Cql4WI;tlf0ywGLl
zH5R5{IT#MDr^o_nE)6c~K2?z|e^MT^d8R1#7Ts7Q56Z)yA=C`o9dUkW)^edG-7&C2
z(jQl;ZBmLr6hzY6oM$`?b|?tn`C-5w2!2L2?_^|~exAw9ucsvZVN+JHb}6LqKZMr)
z3%+TU?QUtb&%&#If75ktFFf=}oXDQ!UfR3ccpRShH^&cIH4ZT9XvnWCI!p>5I3kA$
z0z~d^Chn<<>OsJ7MFJT&CUTW9|GUM5`Egp3@|b9gagO
zYCCPIPvT6CxiZ7$g^FiKYt?B?TVw5BLf?7sLei%+*R8A
z=hcONrN>h@NFS&tuC?P!-$yZ200w~B{BiqZ4S$ypUsg6JrcQ_B{lgl*g*u9bw2+Ak
z_Fl-gHR1Kwq*iN%b@KsDnWN@ZX*p3Qx_$^gHfipiWso9KDc82VsVO|;{)b4KzFIbO
zx%&^Mr*f)RGjgYY$Po90zZX6XM;|=SgPn0R^!V%ehWVUpt4lQu6}G?ZZj9jfB{jnY*?A#)XlYT?99Oz1XFv}#hjxBhYh_EXwRNQD$7Xzkr9SOwp
zr=$wUijNLmg6r#^@R-c1fZ|1DFUBrp`(%yF{%S9R+yMt;RoMytWK+>>&F2Ng5$DIU
z>%SWpL1eu~-^cNOr*~NA%8H;4ag;c_Vh4+7H{)D3OJ*g6h!&`U0avRxG1r;F?O6-Z
z=YMd-9tVa@?iSvUsx3M#Jmh`0phfpL#^
zS@xgU^^b`8hlR-ulf>$607*7BgYU;Z;N-$bPV2gs>UHC*@g_N8aG5$e7V7YM81IgU
zur&V!h6t6#l^qS$9$>p{b=IVBLyOBFj;9{S!5jfwQ2X1?44z#WyFG6ViuVVA!v;RMRCy
z2;o*`Hkdu1iZ)9}_JQpEl1rx;N)voODH7=lA8o$!?~E<4p`&-#ff4Wf>XI1wfv*K$Fj;)wqvc
zjv=cDI`UwccoTx73oreCAq{0EwT*aMzMHwtv*aY29XWYmZf%d)2gnERoyOB!HeD+7
z*f~Z(Ue_vU^cEVl4{(>^#t6tMK{oGCE?1
zZaM2Qebz@?zMX{+Mb(TB9bhd;?YdRy8`I70CD)A$4}32c_gc=Ej)oD9%VY*V?v0rI
z!`P_em}_|V6yH*ItYOfA@~q86Zeggq0FYyD+7S)Z;yEK@pL>7
z>)dwSg_AO-;k?T+TU=-e3B-i3PfD?13}D8oI}T`XliQh@BhqBZ19-ci;*q48);?&I
z805^silI1AH?b@rAbH`lj22d~yOfOOeMJRflPRb1;o<@6d1!9{bC^!LcwCm!G=UiF
zg$wrsk(ouE*IX?34;HU1B0?lWLdH>PqxdV5;ddPHk6C1kW=A)5#}Oo2U0&0s
zZ`&HWT6G?>pg-Shg9fLu@m2bUt_l8)y!nQdXnDk=^@e_0y39V@vm&GY#5uTjZ_gG@VbSTrdL=3#Iu^y!Li$Ox)mert~MXM
zY(}9)vvw4Mv)s0=M9hb|Q89BzG?$7IJOXtx%t`cNSE^>$FSM5uvQppV8
z9(2G6jZIie+4TApPCIekc=7Y0M(KUzB8)r&f-kt7bh7|Al5vi*AT2$q5CwJ`-g6z;Hu`#>r8fgE#q2XVVUJLnErPDone_Hc<&t2&6
z4xM5XSr?-F@0#JypWa&JjwKm*LMM)J%5h}%Er*MG_mN)hRydEoE7gvd?F~_(?_S=7
zZLdv^ml>|M?H7M9+H`mvt5P<-&2`TjQyl6<+kFCecpy3IZ+-6!Te
zUOM;mJAY+Y|Ki=XVVgvC3#(UW8Kt`@{XTGl_}Fp&WRAw^bf;#E}MJM(Kf
z1?%>ifvwrZ;+RBKV(2U+zszl2DtAT$b$<5+jVDcku_M=UwxL}b>L-{~4>G2@dTr#Y
z{$oUX=3Hh9s!gzhEK9TL*xZyGRj*q3{X;dWc0wY23EF*vz-GB5$Jyj0oOd7)RJ`HzFpFTq#(~gW28(Qe-Q%uonVOYaLdolZT}O+
z<*w8WMYn27X@a)=-PAHxD6Q<8@)-j|PnhlXTRH6qgphEx3I3=)JCdYyO&Rn8GfBGK
z0}7i0fozIgEDSyX#wHCN{X4dogrVVoWG_tJ0r3nRD!RccDv~4cC~>?XJMlLk%#UX2
zMVU^nhmchvhYeAIyt1*i1u^9&*aLSY9Z~gH!HHaP
z&;=TRF0l}QPlRwdNfI(^0RfCitE5*Ce%~QnzEdwLjs!0`rF325Q3`n+3^#~MicuU4
z6EMwJN+Qu~GVSSI88L3%i3FMMsUm~lkPwP~gGH>x*28ho1Bc*zjQ?|P$lPJl3u#c(
zD96#jF`GJ_NK8$7sxw89b@ZE2#$hFAH9CBLSpu0Q(Qu9zG+g+5&=8Z+Q8o(K?9yC(
z5oh>8eBTkRo~Kb2j=Ok5%?dy1dwj+e77*e>imwdHl4cBn!EzD&k~fMy|Dd5VATcME>@>flHPAzUez>A`IUX#nFN
z+q9Ud^t6UvO~T(4{$GORzHuk+qIpE{Khu}8>^lth)9G-vd&Eyf%9KInPpiC}lT#rY
zsw5$>PiD=xsm+ZbKq*?wh5i-TBX=Us8o;J~A{c(`ws;HVf{*m6_VEeEj_h+2i`jxm
z3VlxozqYb~6~hcq7OBNlbBW|CH3W2tI;(z44N>86iTQVv+6{IWw12z$7eSaSvewm1
zB435|`Kf3&?P>D~h~#{7zqI(B>o~(*48{K}-GZ#Gar|Z?S)VK!%Y)Vm6tm^_E*-im
z`n@Iw*3eGrR%`G?2=mDKM+IhYM!L%D+SY%gZ*-V+RrDVhZOr_R#9@~o8b@9
zlWMixvynx)+YX
z&n%R0J}$HV=2E_tDY>CvL5??Xl3{R9)^^+%s*IeT)XuTTVeMC{--M5&ge9y(XNjJP
zPIhti7pm-eK^+VK%P5|)c4ICw4Te{A5d%BS#yTEy4!i0(T%vP8HVqIl8irq5Pk^re
zx&P;549TI2?i6*T1*>xK&zhUh=j8fQARcR9<
zL|Lg(2FD=kdP;cUo${WRMPMFqlvabc^|^C=bv8QxB@H7WPYQLFrELqWfRu9A@R@f&
zWbw9DB6VpX-#SSOE&%?+D*IcmOjFt3?l{=U|$)@`6|-`fMXbvD6j)52{Ao-Ovm^2I5$
zLZX}cgC?kgd9=;Y@@`ALisaB9Q?bbg;goZt^3xwfou;Z&lfC)G^DKBc6w_ljbsbs-
zUgz=I##W6-)DgkAlO@<++;E5mcBKil#=zb^DQT`g`*_MK>9S2;?@!_v;;?M&y?43)DCo<^f*q-<77t0wIQ|?P;}YLv68&(SsPTLO
zca!>Gp*I3n2*A6ub3UznAGZQ@GNqK~7i#q=7sEgJ6&Gb%jc4(FT+<~KU!e5mMs-kB
zKs4ILtg?y~J(p*t?T1C7>D_X)+8+Ro^j5Ko4d+#I5Ys8{@$ke<(;a(dVPnD(!pV~x
za5|7bvC`1#^FRAy<&X=1nbBcd5e$S7?(^oMOgfp@<90cx?Xl|hev*nOYAx?Px~R4G
zJLd;{->(tRM_Ees&!0Jy1MNh&#w>Ri*i(j>*1!s3MI$$C
zE5a3%9*l1|NxM{L$<%58fZqo6Wl4hD3I#5kMK9jZA9I|leZ8^8NL3!%L(e`r$CYu6
zeBJ|NVtw51FGTWO6rO$+W7A+@DB1)BJ;5h|YYXRI8e)9F`(u&7_|LfR8vbHeVnd#b
z$J7}}`aw0f7sYmoTUU%I9#E>w_}9CzxCP{Q6_k5B%P@+Go)CSr*0%namq_~`$~RpM
zXgrP3DfsNRb_BQaA9g8;^}M!?`K4F^hR}hi!JN=2GO%isK}6WZI3hU~WKbnt^XC+)
zgJl=3W9;MXW?fUzYY}SU@3TInq;Kia8zTDXo#s`u3#T8(8tzuwgHa#KakvM;)z-u%
z^NpzqgxDd)zJHNd;jR3E4r~Pwvazf7SfLgng}p>Y24;ygxsf=
zW)Q`vd!V_2`7KDZI`$Ii^B|$SyWA_|_g_MxB-jdF{gbM2nyA8pgx(7oK5p!4TbpXA
zf&@&6-!zY66PMT_+H#=$=1B1PNRMs`WST_K6rzQ0^mtzMq?_LXzuBhi8KpIENBRal
z1?NJ#!q}F(VieScp9opAF5Fur+
zn{nFv?!7j*F;s~-e#I4CNqbPH+Aw{1VcnD~Hp1Y|AT4+3Z_~tEjC93zoNJIvIu^=G
zbWjR-c6PzlTw&1wXVVbVECx_EF5Fnzk@5;53~&CJZW*bCv?@hX#w$Oy4Lpgg(GG)~
zz#I?U>rNO(RliClTHgg#B{|nk^=$%g
z(!j3{2OEu1sA*<`YmJV7`&)dkCvWZFP5}hQ?j(@I`imohs`McTw`TsAS7p@h8m6n)
z-P^8E#O-b1QNu&@luHiL+WU
zNx6msLrcm24h!2XlM5pc1N?8P@4`T+)G`G$j_s((N=2eyy|Bj*6tA`^2NtWrr3rez
zP+a+URQ{)r#L1u&F<0CXr%*CdwCwd}w%3JAqCY&96q+o3hk{KyR_{Q=rx)6&EY?PM
z2k5JPTq+lkS6>&6hAVPafr&_h4fdOJ@uklsfCWT2x|vHq!f
zdxV6EZ2@zRL)occ*%%EyT?Gs?J63;%+AG#dF?4{gvq|V)`qR3u;iVmoc~O=m+vC-fRZ#0HWR>KBri*34igRy0{lTlPpUJ80t!`8yu1!bouT}(^5yG1-0TlS91ir
zR1({hsS%@j#FWF)XA=!B!+*BFrK}P#{iUM!2mLOjkqc1wf|g^`BH3<@8FEm5`6|O!
zg2dF>jPm==G3C^k?i0S%{H&;yN|x2BI!iZ;2}57y@E8zJztbnIiukb-lci3;Z}o|`
z6jqITGJeDWoMZlY4Et)X<}H(pNO-t6EOf2nXv0ivK5><|Dt$v2S6gmE>ksZUNXD{Z
z)FRez@&OV}`TablKcb%Akv0XtQK*aYN^;zGPW(&%y-n3sllWnDuIIWX)Sf1~QRbU@
z944SdnFOnN(&V1f!-FBj^~T|Aj1?IN*FN=SnD+V1>K~gk^}J+SsSLAYtNQQX_=2*E
zLv>!6l$m0Y2G%k?jmeia-xyC;9%bfRjiuaY;sIXtxov&k-M1jBJ4e)?2sn1oyB>B+
zJ>ce?D}ni`JJ8`=LLbT1HUCDW^}@OMKGsQ8nNBEZqlI*TiJOg#8}(3s&zhrFt@5UN
zn#(4~oiH47u>T%gv?O;&v%9r_KAEdC%#l$zSBLUvAXPO7sy8u>6!(#Y3yHskkU!in
z#RAwgoH*bVoOH9*)hRj9!opzS&&ouguG9+pf{1yFf=ICRsMG{K;|Bh`X`WD3t=MIA
zu|>LWj1f8+aF@8^@v{?ZGcSv_N31PSS7U1qqav|Q+~dN~z|o&#(MO|YtG2#v>oCv6
zgos=wk4q!M@)YMXI6N&a7?$N4&^n1K3jsP}6ACa6Uu$!36Z^{r?UM}bS#IrrO75eV
zc7Vcqx|+BMjkA>^(AHKmz^Rapj5LzG4IKY`_ZiEa`bJRD^EaSOM-<=sOI?;#Oxmv$
zY_i}oF$)73p`miS*~Gry)TOmv9Z+m*rSz;qR=?2PgCsA%*~x?dBM0%TgyT2-YXY=0
z?t??+PM@HEx}bV}RshUao9z;EYI)DA^zb(DS0iu+AC@j~@2h@VzcvRUf-1Hy?f2HF
zZIvI|2AlOQ%${nk#Ex{Q@Ok+tQnSSc3wR2zXvU!?-HUIYz_|s!1WX6K0La
zO(`qd7Ojf^?rct*=WD_y$1j@g@Bqf54ky`v@NbwEaIGy^3R1PAqS(0XoU3<27SWTC
zyb|2(!KT`txm|MGH;=Ap$(6q84Mmf5Hr6Y>JN5UH<`aYR&nbaA4iVuGt}vb*8qVAY
z{gGO{6)0~I2V%RWV+h_7on9gpsMZ{LfWNbXBP2E6gWDaO9Ug{YlRlT~NC57{C(=nC
z-OJ(DcY-EX`KfFbt2em+gyi-$b$;$~qWNCdAXC>jFh=7Z&9P>r2Ae%t85*TzmH6kb
zl+=}y;7Vl|Cw@G}nesH^P&j5zV5FxEXmU4SuJcFslOo5fH1&K84wBw~f}}Z;BO6(w
zkP_t*k_*c+nK7C9y(<`i0%*|h2tY6?z0Jrh8zhRcZ_fTE7_Y5=Q(
zs*&@IiOO-aU_aK|e5D%?l~P&*LketR+_)bEcbOZQuWW^jZoH!v#7gec{)#V(o*JFG
zwRH2BbD0&;O{$!G@u}Ja)>eF~QBgo&wafMM1U6BA
z*5mP|*L
zx7*Y$eqgA|aT|*ZYbfx{KNbf*!ma;XnNN1Y>RQesK;OPMz{p|*A2i^5=ua|+Yk
z9U=WqCKp%8tRA>i!7a+H)Sm?FlEZ}RWpup_^MK>6)wM3A`4;r9&0=;XPD|i>LUdAH
zbR6)#k;~8|@mzE}TyhlR;}spor+V7K&ZUXTtYo+ONOU<`hsoExsRTj`hR
zCpk8fAwq3bZMA{~C$-{tE_1dE5HGk@bQ!fs=UBO_*7B8`axa~W#YI4Gr4+4Lk_fp*
z;!v}3{;<5PrD$I0C{4BcGw%Q{W#)p^u8=w)$*nqpe#5)B^@a*!Pmv;i{K-ik9O1_;
z%4-ncv1Ltl&Frs^w8wI0w$=^(l2g~0YQ90|MkiX=k}j_J)(7L%L`n2od>Ick$lkzW
z-k&zGwW4&hf0?0H^5br<#Z-=xI~NUO2pT
zg;-d!+XGTKoNO)cY10}~IE-N}>1kuAAn)mt)`o8;hp*1pt
z>#K|5WV1LW*o&Fcs3S5>lhQV<4Hx#NUbew~L%JrS=5*|v-we)j7;@O5A3fuBvbo5
z4S}DNL%jm|nSst{lJ9?mAAK4x59{+68FG41Sh%^7U*
zh&^jWW^2F!iT>RpxbS?JdriH^$L48eRgt%iAu&W*?G2d-m$X8b;*b{|AEg3q?RW_C
zB78J2zM%h&*lKP4CoSPS{nc1W#(}8p6F3q#H$BW$3HpPAvD+v>fNFEg1eqz5lnsc*
zes)SoyA^3h+ZH*3cri2yo?iUg@^L4ibIsaL0pd#j@xqB8CInHbS)Z-*^lHs}9>#`Q
zpA0GQr;X>=v7G5WYkXV{5w!48aN0BP?qF012-DFEkR}f23O4_KoiQy;M8&Ew5AAJ7
z_?^(nF=L;^sr_Cc*z|iT^@6=%n7yYuvO`hS&mb*mI}$6Ba6#5#JYmtyqwx;kznIoF
z47kQ!ec3!ry{QUHrJ^fqT|OmVo*{Wr#XgwcT61)OJ7oXK9KNE*mzeP_N|0M9SRY>JE%JYkQz2*-UQ
z7}ZAlBfy#t{rM(1Q-F6DOR~+3hsBu~_E<8M_Xnw5Lwna4-bBC9E}seXGhE+#sa;&tO-D
z-z{KT4WgsX@09vC4UkZ
zHEmh?pTBS`@bbtE%~qv_CV?mL(pSE%UHgR!IH60RZRwvj{FP4n>Hd=Z{ri`GX!ohC
zJ^9{9o|)srF~`)mxt7{%jB$GprjXNSox~|g1fkgO1GHJ-SK_@&ZsP1@isNTlN1r#T|GBk{zE&CYf-c7Pyn&Bq;Qr>nb*lgRexxr``NQ{X_4O-Wud!zLWe4`zsv$&c
zkn@uaKX_7J#z=u}hQR^ic4bTl<^607OhtAxiIApaEilRi)Li1?3G<{UD;J1~78jxm
zN0c*yS$_Uv!jJ6SbXafpN(R_nC$G$BIuC%AJ70=ai)RB42r9E@RL6GgX@RZyoU^QM
z`)2_g*xg0OLpDT%l#Z@M$h^!s-3%sh>b75Ry#x@NoTft@XYJLo{j=)FLE$z=5h7%+P68WG_*(OtMz5enUN5G}4hsUG7YyL0f_@L}<$KmKW%dgn
zB99TLYWm~IMa^E==bUJ_(~w*?wI4pFD?krxSyWikhw49vl9EPHRQAbqr1D)FJ_B)V
zC1+@}jUKSo%wI)SM8}12pr1hBRM)G98s0_Rm(CeHyew%JW<~I1rDe+|5-X3#S_lnQ
zP{~s12e>?i?1^MxNNq;<({zVN97234xw(WLa*_HWs{yr`{
z*y_JyE$DK|tM1&gf^6)NPw(go-#RYL#d9m6*#vgbp4IJ2*n|1j$
zREGtL-Jp0M%LJ&5$*tC{mqnoK_N~1XS2$$pOR>EtIjKp!W$Xx@_Me8RF&nkPMNL&G#4)%g2a<#~f@#rvh#87VShZSWj_BL9q`x82rrbd1R>
zbwTD=+i)_aG>6XX;}!rl1PqJ9<)ao$X5K2Y^!iLsAVfodJmb?5#6QTUM{zE;f`?j4
zwMv(T@Pxuqgb|v>5JI)~A;G}j5sJi75EX#zNsq7ND3+M_acQN;jl1~qXFluCAx2lK
zHONR26LmSGRIw~Rc6^_g;M9Pb6vuoD&vzU5X8W%oxX!5
zwNUMa!Tevd;Eos)ncp>hxEuAmRI9w-VB5a-sxypFTh$w4X-8UuR9Fe5Fq#4E)?tYk95GHAV;U$8V40PM#jkN!X%$PZDA}*poL)TuXmZ0^Aiu2
zXoSb_7I!9AoFn9=XQ_*YWVw)MH!?u+0P#UkIS0>?Rzbgz>_+r8M*-a`Y)#gIYSxY$H=0m0tLv<6*iPZ5GKO+8b7y@b-@&^#+0$XNw%bS8SUscTs}QE>!2HMi
zm#*EHhGUYZAHR1i%g=;{9s5x3Rf^Vk%9L8PUlk}pzw@kWYc0ckXhp~ov*u5BjftTJ%w~Sh_{}1SD;>Xm8?nkgU;PNX8atM
z^?`7>2`4oK=70oiMwbGNZm6fTNyUZB#yx_#sm!l3`BO{7O8pP%Ph5%b7?{=nLFrel
zdhgL&E?qU-u%3FoWpn5tIOa?dYiavTY|HAAta77FS
zE^ikBBw7s*Qb@A`54JVjBs}C(jXi+i;p^Y@UU>W5Wn^&IhEsd=?X}!r+zd(;tm3*`
z20@o#D%t{gTL$wkixvV!>OHklcqV%mG4$ZuzX>pcpSGX8co;l@Dt5Oj5a&%2Dm@hV
zoAdo~aqlW!N422OsCxE(E7JQIMQaTBOUs3XzEJfFdm=EI(a$=YaHsj$=x+2h&nuOI
zr7%6E;hfd80KPm%uJ0Ij`CjYabYeZ8r#y~*{AiFbDPUn3N9D3Z!w;v&^A9{x0CQ|C
z@DJ<)GgwQ2Hxw&u%ph!lw&sK|GgJug9Bb$ey7lwikn~YJ<}%-)?DsW>BI+Ix@(BdQT-parXa?JAXalBy!^*ha2J~mZT47!U;w>cD#5%e9c(6QaTH%=
zhD0om-XOYvJW;iz;B#N&!cBV9`N90>IPj0Ac<{==?QHG*p_+beV{`J}OP91Pocxek
zY$UlSeLFopQ9bkT=5duBhdDlgMgJ$Z`1G9r@8Q-}KhKd_Kg6=J{>OjYrhP4?m<&$j
zuYt>zl3tQJSx~GT`#I!>%vwr$(&}kv^^a7)#-T%-`V2MK&vzR_GO|jhBwSlbKOoeT_6q}rj|H!l!&pT
z5E&z8bzd1SSks6Hg;&NFg`Rdg!$4Noo{n3FH7RcjDpqv(a4_}q+%XrY@-
zP(pezl7)Ka^b@2-i(8x&U^7@e?Vqd6S?OOk=Fp*1IO=qy62gpGd<{rZkDOu8_?#(!8xKN90GVV5G8DZ7m2^K(IiY_I
zB^EEdJWIG=sKv(nvEX775`m~@fRtOQ^yY_V?)j?1s5zf_y~P)9L-X
zq>zCOxxCoZ&VPv#wdBg^UXjB(ttS226r>PZVpZUT3fX;^dadQSFWeus$xy_r^;`EBP!06P=_<=EM=;b?+yuY&Iekt+2R}9{
zsP67I#zozx57pLIrP4K2wt7QF#Q%-Hstyc+;PKg+x5Y5=-fGffCEHbFLCg*enbAS-zY0Lv*!$7PtN9C$;xLJ
z30;{REk)f%p-3i_1i6QM$JYA=AR=!8BTKmlgYJ=E%H*zmH0y{=@B^87>@VFYXSF^A
zmnJVpvY_)!i`b*5du~2V7wlJtwdMztHN`2Pmm=0IC8Jswdho
zp2HI9{1l}jc?n`7*8=%33E%t
zS#DcGw!q@Fe408)bd5?|05bs{kxt~!&~jl@>2pGeF(6%#*AOxhoYVdfK@qWz&L`Mc
zn06i{EGBGi$EjS(*A}%Qio4$^jw64$z<_Rot`mq+<0lOV9cc8L+`$`3Q-lXvF;z@@
zbxl{<2|ud&6m>xGmH14SOIqx~=J@5N{zN_w%Rmrx}y^ql?V0LXfVWj<+>d^9%d)cF-
zieI$DSY(6r_MARwl%mSB?00>JqGVe4a#Y@ZuA=5Y9*=T+(pd#&!*hfLKGabfs_#6(
zEnQR*9F&-{U9ZSN1ZS1rz2))pk;kc$Y3wabQKN-ylV0>%_kK}(@!tLAb>mw7FRup4
zd%wI&fZww28OjW`-;Ml>k4|ma$*Q?C2>fE!UTLXVKiXnG_RwNLTUT@RYIW4vW2-^b
zP1L&&*t^$$TgXKmoa-pp{l02ndGPK2bWzdz*^1QVTbDnwt;!)=aZi3seZDpDkX22>
z{uQl7{%)agiTiDF;yI`9y>Oh}8M}uc>_s44&f4vMk
zFt@8~PdZ&!xccGki_f_}B}@t@X_s4_`_ms`Yn!dX6qJ8S+(M;SMNr);>#TkApE<|R
z>!~WK@Atoxy*E|ImYHW3j|*pB;o=W4m|^Gt)%L-wKC0VoFeC96XstU(J;qI)zuNM#
z{%c+Mk0VzS{A^N@zL)>J)!n(eW>zYD;KR~!RWosm(Ym#xESW@I_uSeNoZ?R-bFnF%{7-XJaQRQZD2}~>3t?y6_2Y_!h6B$$US+`jZV}zNnSb=dQCgnjj7_Dr%&|#
z@UHOUq>m5BH53BOMiOWmae~92xA5?Fk0^Jijgs@6KK@Ai)aAJId)mUrho&tG$t{Ok
zpYt*e2Wg4@WB<8@^>j&E)5T=ovrpbw?>8ARdBJF&?2%|NzOx-XF*(Fi{vu35{kOH{lm3qTuFvfk|A1+y;qw3LXJZ<+wUPcQlcVW(kq)E8a?>>w7lp0x!ExveJ!()jvt_eraSD-!EJ#
ztT{SIuEPIVHu{s{~
zNU`^6v(QsE->Y;VFFLB2#`{lP^QbOk+qyiPVWm119YUM>Yj2TorH^81uVwC5|0lT@
z6BK6Nu;xnC6pVI!pQC-jslOq7VDX++J@{O9j)yu7$tr4o>2?h%lJM-3#~rnvR8*c>
z>vm`fO}_bjSjBjn{hu)f_J26X4nILcC`#SX=!{G%cRtHGCtMvG!xsz~uyQID>4H!9o3c
zwNdtAW0!aAnJ?VPnK`I|{LMW$*XfJ>MdHUZLpkn$dUPh;Zfj(Uxvz-ik&*~@bxtqV
z2>OZ%AJe!W8v9v}Y?Y*BeSgLc?lbjGa<=}dW9J{-W8c*Nou=kw{2e+wdV6}6qc`rQ
z+n%RmB1n)1PiL`Z`?@g|~g{6fYMQg<1_C5p2Y@Z+GQ!
zwmh>nmu_@t1gEo=Q#+l)0LQH6WK)^@o^F#N*LP2b4OmOsKk83TB3~Rna&AkJsBzt=
z-}2GJv1rFFEoGX=zsTK{-`{Eo>hc>Z3-RPQS-CR2((qbmtTQCxop9*tQqt%tA?kPM
zf-I%4``viK-K~2d#y46-kEU02NE83v0ILH3%=djCGbnK!%?i?;X
zbNjr!KDsY`W_w&OV09?`3r~h`FZY;f!6=R=cXlwj{JYp(ZdLrbjc0S=_3P^1@s$!e
z7A2PoUABw9Yy8#$J`K+9oD!i@;Ef8~s~Za6qKBKkSf$i`lP>Jy7hU|z8{y6ApsU!~
z(1EbGX5uPhodK+OU%M6=Ir};^-FhD1=YC=EX27t$^0)B;nn!y2&c(h*F0_>5o=-*V
zz+K+AAOCc`%k|`M3i+1$JISP>)%MVGx<1>RfM6(1?b#$m**HIy@?a79!tP`gcMvJO>@YiRKqu*LSVl4V
zLX0LW)Z;xz6R0|8r0KqBYh%uGa3a&brU1U^&gfn@We@HU`2zP2|4*7%E|%5G3VgdJA4!(dLo0gPB?p&%
zL#!#N!u~PU_mZ{S>=bl*?jcEIl2UBP>RYFqrnDTGy_Q$^an-X;XI)XUwKuG3z5HFm
zmhVQUStzJ^)Bc+(hGz5-UBN$&erZX?PY_=wG8cDomeK7~YVsDI7AfXt9>E;i9`!%D
zI@4p-AD**ZI$PuB*vBp^!yK2za^^)6PHJB1ec7MGfzhTpEVctygI39vnXEGG9r*#b
zt|QrA-P3-*y151gU!~8;*r(mT(44mN+LiTae{NaWKfiW)nEiAQ`QxkDBAryGbA;o?
zb$tqv7=}HX2aoUFDEX4~=bz*+CGNM)%1pV;o!5+Zs62RNep8^hF4Q*vRa&P?vi~JR
zoRjAKl;Cn1%UZ#TmTy^Fw$jSdFNemeZ&B(@?DZCWGdpaCf4HT^EU;7tpL
zS^Fy6xbo=md#>c|M~be+m_>h#*zc1S6Bka&{pi{KvD5*zJ)s5(RYiwPM&}cb@?TO&
zE^WE6{SXMINlfdg^t0#tW@d3^Mf35Su@kL0GoMnqm-mjDzf3y$k}MOZ);mv~TPVz;*?wETqw{W?m-MOy
zZbW_CDrM5m?vIwG2ghF)T8Zbg`{(=-_-GtZX|B#~yurgVRi0EIbnAt-n9|GZ@BH?+
z=hqeBGMuh{D%HLCjv+Bd`Ib809W$e@sB=#8MmH;>76rATasB)D
zRR#2*;^5;OFbH)_79|g8vfG7p+U{6;cr>>nb^h>=$WB{|Up570AN1)vZR=*QI91Tj
zS5`K7-#8y_(RsUE?#mMQP#^18es;e@u8UXPizsowXd|a4))g$TMfwFR=WAY*4b&`O
zen@BXF}{5J(s{>gyn}mxJ*YNZrKM}eeO1Z6#eBNmf3+%mt$*iaY5)1p>Q!n2Y5&*?
z7pEP{VM&$h@Vu**>tsz{^}Xrl-h#JYK2Zt%3?H8)4C~N!w)8&!)XKfQ<#F#!v1{MT
zS>yh2yG&f7%+Z=uTvd4szhUT^T7z!KPu~}wMt;jmEjD+lrd*{x7_m4OVHXQcbg6r3>U2*}|Fz1T^ikh^(q>kculr0dfVo~eE}W}-t+sMeP)mL-NC%N(<%w$s
zaG5$1-0mmHr#_~VQD`jx@Kb^U?jlV=df%5fvFDTQsT+p^g!UQv=AF0j
znPB1`o}NfxD8H3B6(C;vh@Ra?v6;bUrmCx#y>Qp}N6q51cgnu#xPKY3a*dG4xwGL`
zmz9`DMZ5P=VnTT{-Pvt|w|n@iWK@cCqN5x6gY5mRD{#ErPB>t#bl0>#dGtqR*H;N<
ztpZj=gqt$940*&;>*L|O`)K1}r$Fj8+bD*_9Sh8r`;F4M-*!|#Gz@&p-
z>e*7IY;ObfRX3veSKZt{EZhu#9Yp(=-{n@W=4VvqJX?FH;ZFwH#;{Nsc%Q%NmhnMj
z<>ILoA&RcVWM&J7(>h?CENrm$&pVBCBKdSzKP$%Ig2w^{JCAugmP8kb8l&AJ->SXd
z?+cSRrfj`sPI1?yK6f@+9X8$)cE}^~m!9jXrHf?|{vpTs8z?;Y@4eGRbsi!`!KUWr
z(Qga;mT@tQbC35en=h^pxdEytXQZW{2{Gh5a@F_^ytqcrd_Gj6g{9oj=bGaD_h*X5
z+{S$-HL2aW^Rc-DVFld2^}HWlOY?aslC77=Z(9X&P48)?vbXfQviIk9v5FmZs(X&a
zFpeuXk#9e1F%umus6DZRr(_%Djf;CNGj}OnQTui`9rwgs{U*JSn(a+^l3Zurc5z1e
z`JdM#&Fx)F-ci@Gf3r+*-2KLKYR!pmH>V$2tR<`R6g?lkRh7E3&zTU(1JxdT!~1o8
z9mhrX9UAH@R_$6&Heuw08mhP7{Cu+H?%5ue&sJ91k*g}Vy`j>t%)0Kys8td2
zF!gT9vx%XJ5%r~|_U`tsqW;3iqn$-ncCDA}1{RThGDVyvmj^~~;`ehuaQw91#G{D&9x-v~giRBB&9Z2eeEfaa
zrboU1P;3d_rm%Bi>Wr+^z;TJi>u2bd%jV|WYn1$BO$v{&vQjo2tU+#K%)bsv#?jtL47x$FDqmtYO2_Tm
zm{QHM@jCjv(6hdV3yxx?1;ggjub+5NzAH%YZvOOiCOXt3LvEvHZ<0%k&4F9py46|_
z??l_4sFvG!KYpXSIeQ3Qa>b3b>MjAp9@GVL&}=zP6HSb9H`
zLGdRMnvNqif9}7zT<}uf@)2Nd{Uksa_f@?l?i21JMR`oc=TH+w!|y6trY(c*ma6R+
zmk*KWtnv9w{^qc0p`vcg7#&@mcwqIc%S=B|NWWDunQDVl$;SiNr`&euUBE+*akXKC
zo}8x~N|Cb73X?oyU&!9oPIA2AyggEp!%xn*+xZ!f&NVUpl7_IJ>(f~$U#(a&^Kste
z5b2i_F8IVX)z7XY=FG&eWLRxi6mc+5|FHj6^V=2~&9~v>M8nMV1`{FX9c)7juf1HD
zFZ2Wqnhl?7U(R*&qrrWBbRxCpfOB-Rk&ExW5BAqsLa3$r%jOxMpE4;?+*j(ZxrGwUxZ~ZJbxD6%gRp?Tn!EV=c|T
zc_3-1z;xN1qsGp`g%3A>#c*6Qvn^ZJ+4?Dkme$?qmy02m#-3^hb1mlk*O7OIFT>iqo`*;TUWk>Y-4%Ja*0yG>TqQ-b(cY{)gMkpS`s}`W%icN0s^I<12Z`
zwG(HUVxL>?ah07Ot}(LBP%DCev9eu#ucx=H=JL^7men`-6|E6Hy-ANZ*U)S{K
z6+U`X-jMZS*Kd{l1{J>B5mAOgLY5}3#a2?G_rHeG8`S&#_z=B|`*NgY-<{^b8m1lc
zrJ`b#)i+GP9uu8=T)<#^Cl2>4pkn0f$w_xd+o|TKfsVIz7j)Pi${H6F_cf&7ao>0S
zy`1CIu#6^;jj4jU+J^f*iQn$rd(@j$sIlb$Gou^#@wwA&#~8!bo-wM
zqXUyN)wh}tNDuIOH|lf|3-w|9s^143WIuYp
z%1yH_CoPS4;nBGA8koB+uC6
z96QFfo@hSSkdl@)_xJ1Qqs_RDdANOqKZzW>44+UcHHS|q^?AA+bn?>-ZH*(7@4t(G
zI`Ll8b1`GvM1pzd=xl%O6AeE#CK9x
zu|j`9%v&mI0C(r2WkgS+)CU1`>L*e!YyD3L9FG_80)~t_r9x~b7wJXQ-kD2D
zvoZW?Uhul%+=EqKM$l
z+o>)53$yszt#8xW)iz{JIHw-?PX1Poeza4F-_FT+Sh88*XUqsI2-$u4cE8q=VB(gt
zGsD*5-g|!Um=!Q=|El#M{g0fKU_1?L=d}ZoAMS`L>8qWtpVSxWv)X|(rd4H5`Q0h6
zQIJQGWH`fV>0dTep!rATuBp~H&~bpmz=@kFclore^X&)EBK7Wcn7KOM-e4Ad>sc`E
zIM2bM7h>I6ZgIBuj%Lq!-Gy#1y&7Sj
z*^|%Jz9|0X;mHG$4$n^8GW?_D^>fU9LFb2m!i%n<-dpXu9~V51*CP)s&5kRu51GyD
zG^TUrTxsy~HZz|4Zj+IC_f3thlFmr^MemxDz7*yrioIivH2k7;JI3n-v~daHgUe6e
z?|E#zQu5}J>bktwKOe4H>~fVj`liJ=rp7o~a^Dt<;H-wzd$l$75_4T8cL}RGo{&#I
z>gunsy%Jg3?O9&8Zgfm+U+B#jK*4kQ=R(7U=?_sl#d2~vqveqwl0=FIWus0S8|bgc
zkH+iy6v_4s%X86aTsFQ$Hjs3K5ocuC?PTv&ki*a!Cl+Y1uGqkvQJJd>u_{j|sDRG5e6<@4{0XK&Y`#x$94}aQgv=14Dzjj}C?EriT`2>&M
z)fl&A-&BVrS?jt%mBI&?PO2a^t=^QZtfhkGFLq@Imt=f7@wl)*YxsDf($D8+-t)tp
zZ|5&vR)5{{l3^jhfX#e9!ZDzSySj?m?_<8Vjv<3Mv%!u+u9h3c*+`u;8#k2Y+hqIf{^a3srd0E^^3G}|L&Htca@hu*|)KaZTlk#s9n`!0{RL~2R$Ts_&BCB{BreP|=p`VcdN
zgo4pjopxBs&=n=O<)c9%nVoIkrF+B;=sPA~e0@>*c>m~lldwSbPY2H%Z%gD|BXK?9
z8=59A^sa@18K;`+16)rA;=Trnzw#T{AJcHK|8CHc`{%kIv{daGxjZD5KZ
zB`Da@|CHMbT(aQ5%kj?Boy5N{@WNNROnUUysFLe+I6UM!InuWcg~Tu;!T7hPe&IrJ
z_&1#f^C9Ep5Cv=nkO}ltMG$#}ey#{2D(L5SAw(Db3=%@L(a&ljWDi}FZ=lnH(AdpU
z@Jk3$7ev4E-Ho_K1K*E&S%8d;3-+P^UZvzrz(yF6M0q2H5k7JY0N|^ngixM4i}7@C
zw~~<^+(||z`Y!|gEG0kZo_)<-9IOc=3@9V52*O8kH7L6|h+o#)oScG_sZT@GO}_ZN-}m5o+!b}x#IjF*IH7O03KGU&kEMWIDyAV!qHqwT0kH&-0Gk#Y=$@c~V7L=ZK>1qIHHW59Fc
z@iplBZsv9a2`l$
z0nn91cA?{nk%Z%VzfREA48Nh!5%iOu0(eLv+~AJ{d{ri|6e58as#nYL^9%fEh@J4~
zBg9Dt@Cvv~Au4#^HoS@oc7bN8L9--Ch&Jd@p}e3QN=7x!NSk4cq6Ato@QNyBP@7o(4rK}7MU7crC99EYTpFuYZW+R%t;
z2dy%Q0bXAE<$QH9NK}Vx4y#mAR30zTkwql%q<(+KsjouPJQ${uB=X24G1XRb2sL=7
zfN-KlG|56EW@P@tq{>jRf)-UQ?zrS2`rdXTniu8qM}b8fxFe#7h##61Xyz=jZg*X*H3@bw-D$5q7;s=Vh6x%@HcFd;e?QlFd_hT6I{S*k8
z)5S2|C`Ql)!?ZX?Rm>3XanlPPHh>IIE7Jq+B3M5#h#@O7GlaNLYt_tYM#J^W5`RPzpGY8-erQns@T+fp_
zAw*s`xJt{46CmISFc&5FK>RzbZjn4@RQjxj@`03Ob;;1K~k27CRv3dF)@9
z)Ex*vim5;`Q>QS@#12FO1u`o`;QK@(xd13kq~Hdz%Gea7q3BylL^M6&`#6Hfb(F`?RRHEjUS&;tiy
z-9T@r{d<*?_klJQWG{Z)s&HT_fGC3sn5!Z}C?){Kv=?9)^DEFbH&yY~AG|^_mx}(v
z=oS5yc5-SEU3-OyW(BVQmX>TT@^CMhHH1P40y7)liJ*?84uu79w
z0gh^viWjh{W0Rz)4pr&g#ek!CD40NmI-!c)8+mcG8XEr&8c(Xq;2uWbs*cU)I4Wf4
zeGJH@K?vg3_N@nfVCY1_6h{{Ir|$}*IbP^XGK#p>HrSV
zpn>q>NvqFP*t^3iWM&~F6DASZ^Bf~Zb`o^=HkqXsL*3{9uM7rtqU!=XaNLOq(W1*G
zgL=w+5VsQ+EBjsyr8h)D1MciZgz;L_X-3e&+y+43td&SE*v1Rk?Cd4@HoX36ac^4HKsJ(>6**
zkR*lGl0{UYs33-E6o3OlGagm7TL+yEAq8Y*OL7ZJkLGjZVHI}Cxycn0*+C*r5{Km&VnSmK
zD7S*0hLqgkr8VXO+-|7T%=j;K>uy8>_1X-Ip)~yqBdw2c;uYo0oHkN`6HE(hGihjD
zG5d?&*o=}1AHS%$5`8F6XfN+_g8xLCKqWf$f!
z@hT)VuxI5pfT1nY8XR|Y~Ej(SAY@$afB2~N6{Y(|3(`Vs&b9Z!j=jc49DTN
zl(cRL7o+sDK+yzY#>Y*sB)1kC#g;HY)rt0_iw9>ZN@|FX@wy3A)m{dKO%XBRUq+Y@
zJpY^TVduX>-XK^8Ntb)?Ybd=QK357CC|pr3|G&Op197I<`rcy-mAKtRm2!Zem6TX}
zfLBt!Km39hj1(E@ThcAbwObgy&Mit7{N@QAZiE?>WPO*2p#_U~pyM9Gy%mb?MA5nR
z_^ik^$6`d<9KxKNuuS>VNXh%(Cc{&;_0I)3_PfwZ((Wv`1&~`Hl0c{BZ;zY@(r%8B
z7Cp1jAn|BKD@t#Kj=|Id>XUqoe&+-aA3s>5~`~1$jgNZ;@bZN9j30=`%`x
z@WleN<_{`qpaa7MbWjQs>!q6|#PD@vm~2Z#7FFDe0&n+WK$AX79wIs4UWgGKz%bT(
z5fS`ohRFA!BinDLwCYcX$P{h*+5sC832utA{B
zw89F{O)EHZCtAR42RHd&=&6{&vK5v>Ox6%%$3VnzZYAx#K@dt1z>X0F*&tg$jWt$l
z2T@Et?_U@fUaGBt(Sl7q1;kU^tHc*niBnspQPi?SrHGu+u
z?!bV&wumq~IXbowcu@rdYN|j(Qfv_heE0Nl*2of6!_=VAQp4~=s#Gjs*q+cqkA1(j
z9sQ>rKSnqtqSw(p9tKQy2)-7ZLH|$)?n2r5zymERdXQm9u!e>e-1`Vmm>#BY_I9Bj
zMz5gSX;?f1O!kN}K6YC7awJT^>M95KLeNXZtCT!rKPD7s
zkFeuOk!}&?XRy;z5!x)T#seemvB$Q#GxpGk`$vGyKDav*+D9m3eWvr=>yW=hc(eI#
z0Vt_D>fV%nko9T^#;O|v?djP^u>aRV?bd5>9olQRxv^P@K=pF~cLx|8+z!}@kemaQ
z)R#iUV5eLea?`=N&?yh0Q%Gy6aVC*;3z*8F;saw2So+SPl6IWO&_esMZHwN12!yAG
z|0#~zk8t4~rLMWKP)kEbHp#hpiJ2_?i@t{-3I1+5AI0dEzc6uyR5U=z5z7xVM~K$E
zMnqGCK2d}PugEKM^sAH>8QE8H@=f{2eG{c;1=W>QoM7A$vtu4gqC7iI1ty&lAt2|3
z`AOFaLi5)M&{!u#5-)qnf&R)qnA=`3Qb|kdEiw@A3`^>q6QQp;+BToq0PT%|HGq`V
zmJTB|b0&~pN)B{80@onvc=AmxkP{P1iXA-t4vFZugo)w-3mWN?zs&%p5(d@!)C~AM
zM`MQ91$wB=2*t1h3m1d~Z$Loo`3W1C{4pY%!zI%UBfa24*i0SCOVVD0`cA;agw({V
zlw8mj1RsD>Yiy{Q|F6?7LoE4Kq21ZgZqnRwazNRHfZhRw8Nayp+CEe`0yTVrtsiNR
z*$s{zKul3HnhroS(%tc#xt`QiK+&C=5mX((CXeeN#2)he7yH+~q2uGJsMAn3Icxz*
zI|)M{(B=xgb@w2GKdtITWw809Kv7WVN6r4)QBPw?}i=nx4OaMvqb#MjX!zha)&U_Xw2OX?pUXQLxF;E7_iwLOW08q
z*l`*I@_Jw%(eQx4vIGnm?t#eQE&S8_B32&`Mhsd=y4x2?#z-eT5H57i)=>VNX(*5t
zXs1y#gI$NP`7%2M)9Q6LHL%I1=ErxE_$Bklyns46jG5iso1^k<9yOrJqZa;ePTr6g
z#@0d?PD2;M!!P0m&tHo`mN(SM4q29
zwD5XE{_GA6DBA&NH!7Ck0a-N`tJ}~6OK=`ZLnN>hrN=Mk9VoxgYdnAMYiignixSx1
zYlPVW$nN@o?2q1J>RgW?{P&iA@5d+KswOqiwNNR
zPD_hXctA4gi?CC4ZJ-3~z;%Oq%YXa0KklrTe4r@{aK9l=GDu!#_yZ=eWv^zUVFCyK
zJqOygMQ~Ra%;{^e*?|KiUND)Uo}+M7RYwsvy#4N@We3pp`wetADd}r4ag=aE>j#J4
zCWL7+@*{-S+{>eLi7>QsVQ7&ila4q>+9O7@6~9fz&+V1(En4+(PzT|lNbev~OA_hn
zK(PePHZT}Ph#iOdoJ2#&^bVdAkxtJR*}s^q{V^x|`@@muZvP9@sYF8yZu?`s+DjC@
zV+Sdk8LR~mwC&+rKK2A^3xP#NnCLaMK0H&!m<|LGlJkV-7T*RqB|R{1NbA*$ohT_g
zxDkLUZ3}=(n{_bY_W*C7c6=g|(t~dy
zgyzrU`8g>em`e4Mn=5(sB9WdBn1w=RFcf{zPmVPrh89$<(lCPRP;5*OP;~R3ztBHI
z35wpWQYlr#^tcX-FX@tDM+p?euqESY800sl1xaCu0=^JFE4}>m2WSn0iI74M2Eq_U
zbQE;qu)BE3y9H?RZsFa$VYY!t@}D3uoN&ua`aZRstcpQ>m
zgQTPhr(y%hBMI9T<#^N3ewfYZtw(*5ggCSh6BrkXDB^XCm6&defyqE-M@9ydn0S?v
z=j{hQk%$yJxoeTo!HC4&D0pNM7e(j+tA|?V(M|Sy
zSb#}04(@LuDYolx88>>a2iKf)uqu#d``KJfpiu4>dLS2#1+`{091wjmh6#(tx{XW}
zI8ufIJE95B4c>EV7=Z>FYHwZxq^baQ48b7#e*(1HVML;j<&d^<0ZqU<29ZYH5ETOz
z1hj(u7(^ZKJYnTY0dW`)lyC<{8e{vOf-f=H0~gz4A=k4W^t&VoXs4#d_iU)VWE6Ah
zHHzT}PhzpkK7j(`1~4Em4%;ed;ULiB9TCU~7Dl!(f=nFdjv^E-GC@Ssf!6UY|LIvl
z(cdO9bY>hv4|L)P%h00DV_LNTqJwi!8r7LoM0)&f;ahP~$hprLa5j!`Xe>6R##ja;
ztplzbr2T^TB1WngkD1^e5BVLwV!*<9>?Uk83LO7|0@=V~Jhla5I0b?7Ye41{B86YU
znE7&o-C-!t!rebQ-~_+%j=MdGM$_jyrQBN0@J6k(y)d??V!scR2j^j!rbM2
z8bbF%2jOY+Pa{J3ozRW9bMu#=9||sQZY&h&Xn}_|Ek9U3jmbsMKne6>1gOy&>?F*
z(BR^w&FzY_5m-!wPtLR?V)phX!YR@9K!I4#LvO2Zsl(40*x
z0t%9``MjPC$9o{37AOhO34*C)gc-k%uG6+mzsgO4=h$aT2sqvn+HK&u20^{{#K{Q{
z=;I}*9-es-uTt{D9s`1<8bx|26
zFuWR~Wyd#ZXrTF|!nr=n2;jdc2mu~OIyTUliW%}8#dxt}m=!iUczX+OA5k9RG>B;y
zz%bSVbPT{R4Z}pBm}?>^Mi?-iLuf!t8X=}o%xzgB23z1_$dOd^_F)_BN#F@E@hT<1
zsDP5hJinjMg!_0
z1|OdP{V4V3bVFO;7go6IpZ$xa`S2V#Rmn_%|
z*JWbzg
z*0yzwmF_&DjSsm>R+~=PzMhBUaX*ix^-0J=!O21dQiCdHWE;pkM%ee2
zT2CwLzyh%i4urIkNa04AutuVHvAMVcE=av_K_bm>dVZ9O73|MO*wFC?WW&~S4y0rw
V;^@~}^lKOB%0~2PGST*%?0?K)H*Ej_

delta 234736
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�B{Q24|m|U{+PG;lyaMgkFQ!?SXSB
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¦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
   Examples
 
 
        <.live_component
-  module={LightningWeb.AccountConfirmationModal}
+  module={LightningWeb.AccountConfirmationModal}
   id="account-confirmation-modal"
-  current_user={@current_user}
+  current_user={@current_user}
 />
        The component uses assigns to manage its state, including:
        
     
        
 
diff --git a/LightningWeb.Components.NewInputs.html b/LightningWeb.Components.NewInputs.html
index 66d9538c85..2389239732 100644
--- a/LightningWeb.Components.NewInputs.html
+++ b/LightningWeb.Components.NewInputs.html
@@ -439,8 +439,8 @@ 
        input(assigns)
        
           
   Examples
 
-
        <.input field={@form[:email]} type="email" />
-<.input name="my-input" errors={["oh no!"]} />
        
+
        <.input field={@form[:email]} type="email" />
+<.input name="my-input" errors={["oh no!"]} />
        
   
     
   
diff --git a/LightningWeb.Components.Viewers.html b/LightningWeb.Components.Viewers.html
index 71659dcea1..90fbaf11d9 100644
--- a/LightningWeb.Components.Viewers.html
+++ b/LightningWeb.Components.Viewers.html
@@ -267,8 +267,8 @@ 
        log_viewer(assigns)
        
 
 
        <Viewers.log_viewer
   id="log-viewer-data"
-  stream={@log_lines}
-  highlight_id={@selected_step_id}
+  stream={@log_lines}
+  highlight_id={@selected_step_id}
 />
        
   
     
diff --git a/LightningWeb.Gettext.html b/LightningWeb.Gettext.html
index e0647907c2..7fda507f50 100644
--- a/LightningWeb.Gettext.html
+++ b/LightningWeb.Gettext.html
@@ -142,15 +142,15 @@ 
        
 your module gains a set of macros for translations, for example:
        import LightningWeb.Gettext
 
 # Simple translation
-gettext("Here is the string to translate")
+gettext("Here is the string to translate")
 
 # Plural translation
-ngettext("Here is the string to translate",
+ngettext("Here is the string to translate",
          "Here are the strings to translate",
-         3)
+         3)
 
 # Domain-based translation
-dgettext("errors", "Here is the error message to translate")
        See the Gettext Docs for detailed usage.
        
+dgettext("errors", "Here is the error message to translate")
        See the Gettext Docs for detailed usage.
        
     
 
 
diff --git a/LightningWeb.OauthCredentialHelper.html b/LightningWeb.OauthCredentialHelper.html
index e053df3364..3c2c5be29a 100644
--- a/LightningWeb.OauthCredentialHelper.html
+++ b/LightningWeb.OauthCredentialHelper.html
@@ -263,10 +263,10 @@ 
        broadcast_forward(subscription_id, mod, opt
 
        Broadcast a message specifically for forwarding a message to a component.
 It expects a subscription_id, the module of the component and opts
 being a keyword list containing an :id key of the specific component.
        See: Phoenix.LiveView.send_update/3 for more info.
        A corresponding LiveView (that is subscribed) is expected to have a matching
-handle_info/2 that looks like this:
        def handle_info({:forward, mod, opts}, socket) do
-  send_update(mod, opts)
-  {:noreply, socket}
-end
        
+handle_info/2 that looks like this:
        def handle_info({:forward, mod, opts}, socket) do
+  send_update(mod, opts)
+  {:noreply, socket}
+end
        
   
 
 
        
diff --git a/LightningWeb.Pagination.html b/LightningWeb.Pagination.html
index 6eeb5c7e57..6f17225995 100644
--- a/LightningWeb.Pagination.html
+++ b/LightningWeb.Pagination.html
@@ -280,13 +280,13 @@ 
        raw_pagination_links(paginator, options \\
 
        Returns the raw data in order to generate the proper HTML for pagination links. Data
 is returned in a {text, page_number} format where text is intended to be the text
 of the link and page_number is the page it should go to. Defaults are already supplied
-and they are as follows:
        [distance: 5, next: :next, previous: :previous, first: true, last: true, ellipsis: :ellipsis]
        distance must be a positive non-zero integer or an exception is raised. next and previous should be
+and they are as follows:
        [distance: 5, next: :next, previous: :previous, first: true, last: true, ellipsis: :ellipsis]
        distance must be a positive non-zero integer or an exception is raised. next and previous should be
 strings but can be anything you want as long as it is truthy, falsey values will remove
 them from the output. first and last are only booleans, and they just include/remove
-their respective link from output. An example of the data returned:
        iex> Scrivener.HTML.raw_pagination_links(%{total_pages: 10, page_number: 5})
-[{"<<", 4}, {1, 1}, {2, 2}, {3, 3}, {4, 4}, {5, 5}, {6, 6}, {7, 7}, {8, 8}, {9, 9}, {10, 10}, {">>", 6}]
-iex> Scrivener.HTML.raw_pagination_links(%{total_pages: 20, page_number: 10}, first: ["←"], last: ["→"])
-[{"<<", 9}, {["←"], 1}, {:ellipsis, {:safe, "&hellip;"}}, {5, 5}, {6, 6},{7, 7}, {8, 8}, {9, 9}, {10, 10}, {11, 11}, {12, 12}, {13, 13}, {14, 14},{15, 15}, {:ellipsis, {:safe, "&hellip;"}}, {["→"], 20}, {">>", 11}]
        Simply loop and pattern match over each item and transform it to your custom HTML.
        
+their respective link from output. An example of the data returned:
        iex> Scrivener.HTML.raw_pagination_links(%{total_pages: 10, page_number: 5})
+[{"<<", 4}, {1, 1}, {2, 2}, {3, 3}, {4, 4}, {5, 5}, {6, 6}, {7, 7}, {8, 8}, {9, 9}, {10, 10}, {">>", 6}]
+iex> Scrivener.HTML.raw_pagination_links(%{total_pages: 20, page_number: 10}, first: ["←"], last: ["→"])
+[{"<<", 9}, {["←"], 1}, {:ellipsis, {:safe, "&hellip;"}}, {5, 5}, {6, 6},{7, 7}, {8, 8}, {9, 9}, {10, 10}, {11, 11}, {12, 12}, {13, 13}, {14, 14},{15, 15}, {:ellipsis, {:safe, "&hellip;"}}, {["→"], 20}, {">>", 11}]
        Simply loop and pattern match over each item and transform it to your custom HTML.
        
   
        
 
 
diff --git a/LightningWeb.Plugs.Redirect.html b/LightningWeb.Plugs.Redirect.html
index 14d89b8cb8..1c6303d1d9 100644
--- a/LightningWeb.Plugs.Redirect.html
+++ b/LightningWeb.Plugs.Redirect.html
@@ -219,10 +219,10 @@ 
        call(conn, action)
        
   
   Examples
 
-
        iex> conn = %Plug.Conn{}
-iex> opts = [to: "/new_path"]
-iex> LightningWeb.Plugs.Redirect.call(conn, opts)
-%Plug.Conn{...}
        
+
        iex> conn = %Plug.Conn{}
+iex> opts = [to: "/new_path"]
+iex> LightningWeb.Plugs.Redirect.call(conn, opts)
+%Plug.Conn{...}
        
   
     
   
@@ -268,8 +268,8 @@ 
        init(opts)
        
   
   Examples
 
-
        iex> LightningWeb.Plugs.Redirect.init(to: "/new_path")
-[to: "/new_path"]
        
+
        iex> LightningWeb.Plugs.Redirect.init(to: "/new_path")
+[to: "/new_path"]
        
   
 
 
diff --git a/LightningWeb.Plugs.WebhookAuth.html b/LightningWeb.Plugs.WebhookAuth.html
index b476db792e..3bde2c5d45 100644
--- a/LightningWeb.Plugs.WebhookAuth.html
+++ b/LightningWeb.Plugs.WebhookAuth.html
@@ -249,11 +249,11 @@ 
        call(conn, action)
        
   
   Webhook Found and Authenticated
 
-
        iex> LightningWeb.Plugs.WebhookAuth.call(conn, [])
-%Plug.Conn{status: 200, ...}
+
        iex> LightningWeb.Plugs.WebhookAuth.call(conn, [])
+%Plug.Conn{status: 200, ...}
 
-iex> LightningWeb.Plugs.WebhookAuth.call(conn, [])
-%Plug.Conn{status: 404, ...}
        
+        iex> LightningWeb.Plugs.WebhookAuth.call(conn, [])
+%Plug.Conn{status: 404, ...}
        
   
 
 
        
diff --git a/LightningWeb.Telemetry.html b/LightningWeb.Telemetry.html
index 23d7f412b6..15ab426293 100644
--- a/LightningWeb.Telemetry.html
+++ b/LightningWeb.Telemetry.html
@@ -303,10 +303,10 @@ 
        with_span(prefix, metadata, func)
        
 
        Convenience function that wraps :telemetry.span/3.
        Given a function with an arity of zero, it passes the metadata argument
 out with the result of the function.
        If you need to control the metadata, pass in a function with an arity of
 one. It will be called with the metadata provided and expects the result and
-the updated metadata to be returned in a tuple.
        Example:
        with_span([:my, span], %{project_id: 123}, fn -> get_project(456) end)
        Or when you want to extend the metadata:
        with_span([:my, :span], %{user_id: 123}, fn _metadata ->
-  project = get_project(456)
-  {project, %{project_id: project.id}}
-end)
        
+the updated metadata to be returned in a tuple.
        Example:
        with_span([:my, span], %{project_id: 123}, fn -> get_project(456) end)
        Or when you want to extend the metadata:
        with_span([:my, :span], %{user_id: 123}, fn _metadata ->
+  project = get_project(456)
+  {project, %{project_id: project.id}}
+end)
        
   
        
 
 
diff --git a/Mix.Tasks.Lightning.InstallAdaptorIcons.html b/Mix.Tasks.Lightning.InstallAdaptorIcons.html
index d152c4a326..9419cac0fd 100644
--- a/Mix.Tasks.Lightning.InstallAdaptorIcons.html
+++ b/Mix.Tasks.Lightning.InstallAdaptorIcons.html
@@ -375,11 +375,11 @@ 
        get(client, url, opts)
        
 
       
 
-
        Perform a GET request.
        See request/1 or request/2 for options definition.
        get("/users")
-get("/users", query: [scope: "admin"])
-get(client, "/users")
-get(client, "/users", query: [scope: "admin"])
-get(client, "/users", body: %{name: "Jon"})
        
+
        Perform a GET request.
        See request/1 or request/2 for options definition.
        get("/users")
+get("/users", query: [scope: "admin"])
+get(client, "/users")
+get(client, "/users", query: [scope: "admin"])
+get(client, "/users", body: %{name: "Jon"})
        
   
 
 
        
@@ -408,11 +408,11 @@ 
        get!(client, url, opts)
        
 
       
 
-
        Perform a GET request.
        See request!/1 or request!/2 for options definition.
        get!("/users")
-get!("/users", query: [scope: "admin"])
-get!(client, "/users")
-get!(client, "/users", query: [scope: "admin"])
-get!(client, "/users", body: %{name: "Jon"})
        
+
        Perform a GET request.
        See request!/1 or request!/2 for options definition.
        get!("/users")
+get!("/users", query: [scope: "admin"])
+get!(client, "/users")
+get!(client, "/users", query: [scope: "admin"])
+get!(client, "/users", body: %{name: "Jon"})
        
   
        
 
 
        
@@ -440,11 +440,11 @@ 
        head(client, url, opts)
        
 
       
 
-
        Perform a HEAD request.
        See request/1 or request/2 for options definition.
        head("/users")
-head("/users", query: [scope: "admin"])
-head(client, "/users")
-head(client, "/users", query: [scope: "admin"])
-head(client, "/users", body: %{name: "Jon"})
        
+
        Perform a HEAD request.
        See request/1 or request/2 for options definition.
        head("/users")
+head("/users", query: [scope: "admin"])
+head(client, "/users")
+head(client, "/users", query: [scope: "admin"])
+head(client, "/users", body: %{name: "Jon"})
        
   
        
 
 
        
@@ -473,11 +473,11 @@ 
        head!(client, url, opts)
        
 
       
 
-
        Perform a HEAD request.
        See request!/1 or request!/2 for options definition.
        head!("/users")
-head!("/users", query: [scope: "admin"])
-head!(client, "/users")
-head!(client, "/users", query: [scope: "admin"])
-head!(client, "/users", body: %{name: "Jon"})
        
+
        Perform a HEAD request.
        See request!/1 or request!/2 for options definition.
        head!("/users")
+head!("/users", query: [scope: "admin"])
+head!(client, "/users")
+head!(client, "/users", query: [scope: "admin"])
+head!(client, "/users", body: %{name: "Jon"})
        
   
        
 
 
        
@@ -505,11 +505,11 @@ 
        options(client, url, opts)
        
 
       
 
-
        Perform a OPTIONS request.
        See request/1 or request/2 for options definition.
        options("/users")
-options("/users", query: [scope: "admin"])
-options(client, "/users")
-options(client, "/users", query: [scope: "admin"])
-options(client, "/users", body: %{name: "Jon"})
        
+
        Perform a OPTIONS request.
        See request/1 or request/2 for options definition.
        options("/users")
+options("/users", query: [scope: "admin"])
+options(client, "/users")
+options(client, "/users", query: [scope: "admin"])
+options(client, "/users", body: %{name: "Jon"})
        
   
        
 
 
        
@@ -538,11 +538,11 @@ 
        options!(client, url, opts)
        
 
       
 
-
        Perform a OPTIONS request.
        See request!/1 or request!/2 for options definition.
        options!("/users")
-options!("/users", query: [scope: "admin"])
-options!(client, "/users")
-options!(client, "/users", query: [scope: "admin"])
-options!(client, "/users", body: %{name: "Jon"})
        
+
        Perform a OPTIONS request.
        See request!/1 or request!/2 for options definition.
        options!("/users")
+options!("/users", query: [scope: "admin"])
+options!(client, "/users")
+options!(client, "/users", query: [scope: "admin"])
+options!(client, "/users", body: %{name: "Jon"})
        
   
        
 
 
        
@@ -571,10 +571,10 @@ 
        patch(client, url, body, opts)
        
 
       
 
-
        Perform a PATCH request.
        See request/1 or request/2 for options definition.
        patch("/users", %{name: "Jon"})
-patch("/users", %{name: "Jon"}, query: [scope: "admin"])
-patch(client, "/users", %{name: "Jon"})
-patch(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
        
+
        Perform a PATCH request.
        See request/1 or request/2 for options definition.
        patch("/users", %{name: "Jon"})
+patch("/users", %{name: "Jon"}, query: [scope: "admin"])
+patch(client, "/users", %{name: "Jon"})
+patch(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
        
   
        
 
 
        
@@ -603,10 +603,10 @@ 
        patch!(client, url, body, opts)
        
 
       
 
-
        Perform a PATCH request.
        See request!/1 or request!/2 for options definition.
        patch!("/users", %{name: "Jon"})
-patch!("/users", %{name: "Jon"}, query: [scope: "admin"])
-patch!(client, "/users", %{name: "Jon"})
-patch!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
        
+
        Perform a PATCH request.
        See request!/1 or request!/2 for options definition.
        patch!("/users", %{name: "Jon"})
+patch!("/users", %{name: "Jon"}, query: [scope: "admin"])
+patch!(client, "/users", %{name: "Jon"})
+patch!(client, "/users", %{name: "Jon"}, query: [scope: "admin"])
        
   
        
 
 
        
@@ -648,11 +648,11 @@ 
        request(client \\ %Tesla.Client{}, options)
   
   Examples
 
        
-
        ExampleApi.request(method: :get, url: "/users/path")
+
        ExampleApi.request(method: :get, url: "/users/path")
 
 # use shortcut methods
-ExampleApi.get("/users/1")
-ExampleApi.post(client, "/users", %{name: "Jon"})
        
+        ExampleApi.get("/users/1")
+ExampleApi.post(client, "/users", %{name: "Jon"})
        
   
        
 
 
        
@@ -710,11 +710,11 @@ 
        trace(client, url, opts)
        
 
       
 
-
        Perform a TRACE request.
        See request/1 or request/2 for options definition.
        trace("/users")
-trace("/users", query: [scope: "admin"])
-trace(client, "/users")
-trace(client, "/users", query: [scope: "admin"])
-trace(client, "/users", body: %{name: "Jon"})
        
+
        Perform a TRACE request.
        See request/1 or request/2 for options definition.
        trace("/users")
+trace("/users", query: [scope: "admin"])
+trace(client, "/users")
+trace(client, "/users", query: [scope: "admin"])
+trace(client, "/users", body: %{name: "Jon"})
        
   
        
 
 
        
@@ -743,11 +743,11 @@ 
        trace!(client, url, opts)
        
 
       
 
-
        Perform a TRACE request.
        See request!/1 or request!/2 for options definition.
        trace!("/users")
-trace!("/users", query: [scope: "admin"])
-trace!(client, "/users")
-trace!(client, "/users", query: [scope: "admin"])
-trace!(client, "/users", body: %{name: "Jon"})
        
+
        Perform a TRACE request.
        See request!/1 or request!/2 for options definition.
        trace!("/users")
+trace!("/users", query: [scope: "admin"])
+trace!(client, "/users")
+trace!(client, "/users", query: [scope: "admin"])
+trace!(client, "/users", body: %{name: "Jon"})
        
   
        
 
 
diff --git a/Mix.Tasks.Lightning.InstallSchemas.html b/Mix.Tasks.Lightning.InstallSchemas.html
index 0343f8a2ae..88e2b4aca1 100644
--- a/Mix.Tasks.Lightning.InstallSchemas.html
+++ b/Mix.Tasks.Lightning.InstallSchemas.html
@@ -1830,14 +1830,14 @@ 
        request(request)
        
   
   Examples
 
-
        request = %HTTPoison.Request{
+
        request = %HTTPoison.Request{
   method: :post,
   url: "https://my.website.com",
   body: "{\"foo\": 3}",
-  headers: [{"Accept", "application/json"}]
-}
+  headers: [{"Accept", "application/json"}]
+}
 
-request(request)
        
+        request(request)
        
   
 
 
        
@@ -1895,7 +1895,7 @@ 
        request(method, url, body \\ "",
   
   Examples
 
        
-
        request(:post, "https://my.website.com", "{\"foo\": 3}", [{"Accept", "application/json"}])
        
+
        request(:post, "https://my.website.com", "{\"foo\": 3}", [{"Accept", "application/json"}])
        
   
        
 
 
        
diff --git a/benchmarking.md.html b/benchmarking.md.html
index ab168a10f9..2b87352769 100644
--- a/benchmarking.md.html
+++ b/benchmarking.md.html
@@ -146,12 +146,12 @@ 
      • Start up a local Lightning instance with an attached iex session. Note that
 to simulate a production environment, set RTM=false. In prod, you'll have
 your ws-worker running on a separate machine:
        RMT=false iex -S mix phx.server
      • In the attached iex session, run the following, to have Lightning log
-internal telemetry data:
          filepath = Path.join("benchmarking", "load_test_data.csv")
-  output_file = File.open!(filepath, [:append])
+internal telemetry data:
          filepath = Path.join("benchmarking", "load_test_data.csv")
+  output_file = File.open!(filepath, [:append])
 
   c "benchmarking/load_test_production_spans.exs"
 
-  LoadTestingPrep.init(output_file)
      • Run the demo setup script: mix run --no-start priv/repo/demo.exs The
+  LoadTestingPrep.init(output_file)

    • Run the demo setup script: mix run --no-start priv/repo/demo.exs The webhookURL is already set to default to the webhook created in the demo data

      If you would like to point at a different instance or webhook url you can provide it via WEBHOOK_URL.

    • In another terminal (do not stop the Lightning server) run the @@ -163,7 +163,7 @@ 

      k6 run -e PAYLOAD_SIZE_KB=2 benchmarking/script.js

      To collect the benchmarking data in a CSV file, run the previous command with the --out filename option.

      k6 run --out csv=test_results.csv benchmarking/script.js
-

    • In the iex session, close the output file:

      LoadTestingPrep.fin(output_file)

      • See results output for other +

    • In the iex session, close the output file:

      LoadTestingPrep.fin(output_file)

      • See results output for other available output formats.

      @@ -174,21 +174,21 @@

      System specs on a 2020 MacBook Pro

      Model Identifier: MacBookPro17,1
 Model Number: Z11B000E3LL/A
 Chip: Apple M1
-Total Number of Cores: 8 (4 performance and 4 efficiency)
+Total Number of Cores: 8 (4 performance and 4 efficiency)
 Memory: 16 GB

      Results with 50kb payloads

      k6 run -e PAYLOAD_SIZE=10 benchmarking/script.js                         Node 18.17.1 k6 0.43.1 07:40:29
 
           /\      |‾‾| /‾‾/   /‾‾/
      /\  /  \     |  |/  /   /  /
-    /  \/    \    |     (   /   ‾‾\
-   /          \   |  |\  \ |  (‾)  |
+    /  \/    \    |     (   /   ‾‾\
+   /          \   |  |\  \ |  (‾)  |
   / __________ \  |__| \__\ \_____/ .io
 
   execution: local
      script: benchmarking/script.js
      output: -
 
-  scenarios: (100.00%) 1 scenario, 50 max VUs, 2m50s max duration (incl. graceful stop):
-           * webhookRequests: Up to 50.00 iterations/s for 2m20s over 3 stages (maxVUs: 50, gracefulStop: 30s)
+  scenarios: (100.00%) 1 scenario, 50 max VUs, 2m50s max duration (incl. graceful stop):
+           * webhookRequests: Up to 50.00 iterations/s for 2m20s over 3 stages (maxVUs: 50, gracefulStop: 30s)
 
 
      ✓ status was 200
@@ -198,24 +198,24 @@ 
      System specs on a 2020 MacBook Pro
      checks.........................: 100.00% ✓ 5765     ✗ 0
      data_received..................: 1.6 MB  12 kB/s
      data_sent......................: 59 MB   421 kB/s
-     http_req_blocked...............: avg=16.01µs min=2µs     med=9µs     max=6.84ms   p(90)=12µs    p(95)=13µs
-     http_req_connecting............: avg=4.35µs  min=0s      med=0s      max=2.22ms   p(90)=0s      p(95)=0s
-   ✓ http_req_duration..............: avg=53.62ms min=26.86ms med=49.03ms max=501.62ms p(90)=66.62ms p(95)=84.33ms
-       { expected_response:true }...: avg=53.62ms min=26.86ms med=49.03ms max=501.62ms p(90)=66.62ms p(95)=84.33ms
+     http_req_blocked...............: avg=16.01µs min=2µs     med=9µs     max=6.84ms   p(90)=12µs    p(95)=13µs
+     http_req_connecting............: avg=4.35µs  min=0s      med=0s      max=2.22ms   p(90)=0s      p(95)=0s
+   ✓ http_req_duration..............: avg=53.62ms min=26.86ms med=49.03ms max=501.62ms p(90)=66.62ms p(95)=84.33ms
+       { expected_response:true }...: avg=53.62ms min=26.86ms med=49.03ms max=501.62ms p(90)=66.62ms p(95)=84.33ms
    ✓ http_req_failed................: 0.00%   ✓ 0        ✗ 5765
-     http_req_receiving.............: avg=88.57µs min=13µs    med=90µs    max=2.99ms   p(90)=108µs   p(95)=124.8µs
-     http_req_sending...............: avg=97.47µs min=29µs    med=83µs    max=6.86ms   p(90)=139µs   p(95)=162µs
-     http_req_tls_handshaking.......: avg=0s      min=0s      med=0s      max=0s       p(90)=0s      p(95)=0s
-     http_req_waiting...............: avg=53.44ms min=26.68ms med=48.84ms max=501.43ms p(90)=66.43ms p(95)=84.05ms
+     http_req_receiving.............: avg=88.57µs min=13µs    med=90µs    max=2.99ms   p(90)=108µs   p(95)=124.8µs
+     http_req_sending...............: avg=97.47µs min=29µs    med=83µs    max=6.86ms   p(90)=139µs   p(95)=162µs
+     http_req_tls_handshaking.......: avg=0s      min=0s      med=0s      max=0s       p(90)=0s      p(95)=0s
+     http_req_waiting...............: avg=53.44ms min=26.68ms med=48.84ms max=501.43ms p(90)=66.43ms p(95)=84.05ms
      http_reqs......................: 5765    41.15402/s
-     iteration_duration.............: avg=54.34ms min=20.75µs med=49.75ms max=502.26ms p(90)=67.39ms p(95)=84.91ms
+     iteration_duration.............: avg=54.34ms min=20.75µs med=49.75ms max=502.26ms p(90)=67.39ms p(95)=84.91ms
      iterations.....................: 5765    41.15402/s
      vus............................: 50      min=50     max=50
      vus_max........................: 50      min=50     max=50
 
 
-running (2m20.1s), 00/50 VUs, 5765 complete and 0 interrupted iterations
-webhookRequests ✓ [======================================] 00/50 VUs  2m20s  01.12 iters/s
      
+running (2m20.1s), 00/50 VUs, 5765 complete and 0 interrupted iterations
+webhookRequests ✓ [======================================] 00/50 VUs  2m20s  01.12 iters/s

      diff --git a/changelog.html b/changelog.html index 7a03292f4c..391e101611 100644 --- a/changelog.html +++ b/changelog.html @@ -157,7 +157,8 @@

      Changed

      • Ignore Plug.Conn.InvalidQueryError in Sentry -#2672

      +#2672
    • Add Index to dataclip_id on runs and work_orders tables to fasten deletion +PR#2677

    @@ -613,20 +614,20 @@

    In order to fix this, you will need to manually create new snapshots for each of your workflows. This can be done either by modifying the workflow in the UI and saving it. Or running a command on the running instance:

    alias Lightning.Repo
-alias Lightning.Workflows.{Workflow, Snapshot}
+alias Lightning.Workflows.{Workflow, Snapshot}
 
-Repo.transaction(fn ->
+Repo.transaction(fn ->
   snapshots =
-    Repo.all(Workflow)
-    |> Enum.map(&Workflow.touch/1)
-    |> Enum.map(&Repo.update!/1)
-    |> Enum.map(fn workflow ->
-      {:ok, snapshot} = Snapshot.create(workflow)
+    Repo.all(Workflow)
+    |> Enum.map(&Workflow.touch/1)
+    |> Enum.map(&Repo.update!/1)
+    |> Enum.map(fn workflow ->
+      {:ok, snapshot} = Snapshot.create(workflow)
       snapshot
-    end)
+    end)
 
- {:ok, snapshots}
-end)

    + {:ok, snapshots} +end)

    @@ -2659,7 +2660,7 @@

    will be less than v0.10.0 and the final states are not guaranteed to be accurate for workflows with multiple branches and leaf nodes with varying exit reasons.

    The migration scripts can be run with a single function call in SetupUtils from -a connect iex session:

    Lightning.SetupUtils.approximate_state_for_attempts_and_workorders()

    Note that (like lots of other functionality in SetupUtils, calling this +a connect iex session:

    Lightning.SetupUtils.approximate_state_for_attempts_and_workorders()

    Note that (like lots of other functionality in SetupUtils, calling this function is a destructive action and you should only do it if you've backed up your data and you know what you're doing.)

    As always, we recommend backing up your data before migrating. (And thanks for bearing with us as we move towards our first stable Lightning release.)

    diff --git a/deployment.html b/deployment.html index 7bd32f5bfa..7e29e73ae1 100644 --- a/deployment.html +++ b/deployment.html @@ -264,9 +264,9 @@

    within the subdirectory. The file will be named based on the pattern <trigger_id>_<message_topic>_<message_partition>_<message_offset>.json.

    To recover the persisted messages, it is suggested that the affected triggers be disabled before commencing. Once this is done, the following code needs to -be run from an IEx console on each node that is running Lightning:

    Lightning.KafkaTriggers.MessageRecovery.recover_messages(
-  Lightning.Config.kafka_alternate_storage_file_path()
-)

    Further details regarding the behaviour of MessageRecovery.recover_messages/1 +be run from an IEx console on each node that is running Lightning:

    Lightning.KafkaTriggers.MessageRecovery.recover_messages(
+  Lightning.Config.kafka_alternate_storage_file_path()
+)

    Further details regarding the behaviour of MessageRecovery.recover_messages/1 can be found in the module documentation of MessageRecovery. Recovered messages will have the .json extension modified to .json.recovered but they will be left in place. Future recovery runs will not process files that have diff --git a/dist/search_data-DB06326C.js b/dist/search_data-2B3E2370.js similarity index 82% rename from dist/search_data-DB06326C.js rename to dist/search_data-2B3E2370.js index 9e9576f980..633cec3710 100644 --- a/dist/search_data-DB06326C.js +++ b/dist/search_data-2B3E2370.js @@ -1 +1 @@ -searchData={"items":[{"type":"behaviour","title":"Lightning","doc":"Lightning keeps the contexts that define your domain\nand business logic.\n\nContexts are also responsible for managing your data, regardless\nif it comes from the database, an external API or others.","ref":"Lightning.html"},{"type":"function","title":"Lightning.broadcast/2","doc":"","ref":"Lightning.html#broadcast/2"},{"type":"callback","title":"Lightning.broadcast/2","doc":"","ref":"Lightning.html#c:broadcast/2"},{"type":"function","title":"Lightning.current_time/0","doc":"Returns the current time at UTC.","ref":"Lightning.html#current_time/0"},{"type":"callback","title":"Lightning.current_time/0","doc":"","ref":"Lightning.html#c:current_time/0"},{"type":"function","title":"Lightning.local_broadcast/2","doc":"","ref":"Lightning.html#local_broadcast/2"},{"type":"callback","title":"Lightning.local_broadcast/2","doc":"","ref":"Lightning.html#c:local_broadcast/2"},{"type":"function","title":"Lightning.release/0","doc":"","ref":"Lightning.html#release/0"},{"type":"callback","title":"Lightning.release/0","doc":"","ref":"Lightning.html#c:release/0"},{"type":"function","title":"Lightning.subscribe/1","doc":"","ref":"Lightning.html#subscribe/1"},{"type":"callback","title":"Lightning.subscribe/1","doc":"","ref":"Lightning.html#c:subscribe/1"},{"type":"type","title":"Lightning.release_info/0","doc":"","ref":"Lightning.html#t:release_info/0"},{"type":"module","title":"ObanPruner","doc":"The Oban Pruner removes completed Oban jobs. It leaves everything else for manual inspection.","ref":"ObanPruner.html"},{"type":"function","title":"ObanPruner.perform/1","doc":"Deletes completed Oban jobs, leaving discarded for manual inspection.","ref":"ObanPruner.html#perform/1"},{"type":"module","title":"Lightning.Accounts","doc":"The Accounts context.","ref":"Lightning.Accounts.html"},{"type":"function","title":"Lightning.Accounts.apply_user_email/3","doc":"Emulates that the email will change without actually changing\nit in the database.","ref":"Lightning.Accounts.html#apply_user_email/3"},{"type":"function","title":"Examples - Lightning.Accounts.apply_user_email/3","doc":"iex> apply_user_email(user, \"valid password\", %{email: ...})\n {:ok, %User{}}role: :superuser\n iex> apply_user_email(user, \"invalid password\", %{email: ...})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#apply_user_email/3-examples"},{"type":"function","title":"Lightning.Accounts.cancel_scheduled_deletion/1","doc":"","ref":"Lightning.Accounts.html#cancel_scheduled_deletion/1"},{"type":"function","title":"Lightning.Accounts.change_scheduled_deletion/2","doc":"Returns an `%Ecto.Changeset{}` for changing the user scheduled_deletion.","ref":"Lightning.Accounts.html#change_scheduled_deletion/2"},{"type":"function","title":"Examples - Lightning.Accounts.change_scheduled_deletion/2","doc":"iex> change_scheduled_deletion(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_scheduled_deletion/2-examples"},{"type":"function","title":"Lightning.Accounts.change_superuser_registration/1","doc":"Returns an `%Ecto.Changeset{}` for tracking superuser changes.","ref":"Lightning.Accounts.html#change_superuser_registration/1"},{"type":"function","title":"Examples - Lightning.Accounts.change_superuser_registration/1","doc":"iex> change_superuser_registration(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_superuser_registration/1-examples"},{"type":"function","title":"Lightning.Accounts.change_user/2","doc":"","ref":"Lightning.Accounts.html#change_user/2"},{"type":"function","title":"Lightning.Accounts.change_user_email/2","doc":"Returns an `%Ecto.Changeset{}` for changing the user email.","ref":"Lightning.Accounts.html#change_user_email/2"},{"type":"function","title":"Examples - Lightning.Accounts.change_user_email/2","doc":"iex> change_user_email(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_user_email/2-examples"},{"type":"function","title":"Lightning.Accounts.change_user_info/2","doc":"","ref":"Lightning.Accounts.html#change_user_info/2"},{"type":"function","title":"Lightning.Accounts.change_user_password/2","doc":"Returns an `%Ecto.Changeset{}` for changing the user password.","ref":"Lightning.Accounts.html#change_user_password/2"},{"type":"function","title":"Examples - Lightning.Accounts.change_user_password/2","doc":"iex> change_user_password(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_user_password/2-examples"},{"type":"function","title":"Lightning.Accounts.change_user_registration/1","doc":"Returns an `%Ecto.Changeset{}` for tracking user changes.","ref":"Lightning.Accounts.html#change_user_registration/1"},{"type":"function","title":"Examples - Lightning.Accounts.change_user_registration/1","doc":"iex> change_user_registration(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_user_registration/1-examples"},{"type":"function","title":"Lightning.Accounts.confirm_user/1","doc":"Confirms a user by the given token.\n\nIf the token matches, the user account is marked as confirmed\nand the token is deleted.","ref":"Lightning.Accounts.html#confirm_user/1"},{"type":"function","title":"Lightning.Accounts.confirmation_required?/1","doc":"","ref":"Lightning.Accounts.html#confirmation_required?/1"},{"type":"function","title":"Lightning.Accounts.create_user/1","doc":"","ref":"Lightning.Accounts.html#create_user/1"},{"type":"function","title":"Lightning.Accounts.delete_auth_token/1","doc":"Deletes the signed token with the given context.","ref":"Lightning.Accounts.html#delete_auth_token/1"},{"type":"function","title":"Lightning.Accounts.delete_session_token/1","doc":"Deletes the signed token with the given context.","ref":"Lightning.Accounts.html#delete_session_token/1"},{"type":"function","title":"Lightning.Accounts.delete_sudo_session_token/1","doc":"Deletes the signed token with the given context.","ref":"Lightning.Accounts.html#delete_sudo_session_token/1"},{"type":"function","title":"Lightning.Accounts.delete_token/1","doc":"Deletes a token.","ref":"Lightning.Accounts.html#delete_token/1"},{"type":"function","title":"Examples - Lightning.Accounts.delete_token/1","doc":"iex> delete_token(token)\n {:ok, %UserToken{}}\n\n iex> delete_token(token)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#delete_token/1-examples"},{"type":"function","title":"Lightning.Accounts.delete_user/1","doc":"Deletes a user.","ref":"Lightning.Accounts.html#delete_user/1"},{"type":"function","title":"Examples - Lightning.Accounts.delete_user/1","doc":"iex> delete_user(user)\n {:ok, %User{}}\n\n iex> delete_user(user)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#delete_user/1-examples"},{"type":"function","title":"Lightning.Accounts.delete_user_totp/1","doc":"Deletes the given user's TOTP","ref":"Lightning.Accounts.html#delete_user_totp/1"},{"type":"function","title":"Lightning.Accounts.deliver_user_confirmation_instructions/1","doc":"Delivers the confirmation email instructions to the given user.","ref":"Lightning.Accounts.html#deliver_user_confirmation_instructions/1"},{"type":"function","title":"Examples - Lightning.Accounts.deliver_user_confirmation_instructions/1","doc":"iex> deliver_user_confirmation_instructions(user)\n {:ok, %{to: ..., body: ...}}\n\n iex> deliver_user_confirmation_instructions(confirmed_user)\n {:error, :already_confirmed}","ref":"Lightning.Accounts.html#deliver_user_confirmation_instructions/1-examples"},{"type":"function","title":"Lightning.Accounts.deliver_user_confirmation_instructions/2","doc":"","ref":"Lightning.Accounts.html#deliver_user_confirmation_instructions/2"},{"type":"function","title":"Lightning.Accounts.deliver_user_reset_password_instructions/2","doc":"Delivers the reset password email to the given user.","ref":"Lightning.Accounts.html#deliver_user_reset_password_instructions/2"},{"type":"function","title":"Examples - Lightning.Accounts.deliver_user_reset_password_instructions/2","doc":"iex> deliver_user_reset_password_instructions(user, &Routes.user_reset_password_url(conn, :edit, &1))\n {:ok, %{to: ..., body: ...}}","ref":"Lightning.Accounts.html#deliver_user_reset_password_instructions/2-examples"},{"type":"function","title":"Lightning.Accounts.exchange_auth_token/1","doc":"Exchanges an auth token for a session token.\n\nThe auth token is removed from the database if successful.","ref":"Lightning.Accounts.html#exchange_auth_token/1"},{"type":"function","title":"Lightning.Accounts.generate_api_token/1","doc":"Generates an API token for a user.","ref":"Lightning.Accounts.html#generate_api_token/1"},{"type":"function","title":"Lightning.Accounts.generate_auth_token/1","doc":"Generates an auth token.","ref":"Lightning.Accounts.html#generate_auth_token/1"},{"type":"function","title":"Lightning.Accounts.generate_sudo_session_token/1","doc":"Generates a 2FA session token.","ref":"Lightning.Accounts.html#generate_sudo_session_token/1"},{"type":"function","title":"Lightning.Accounts.generate_user_session_token/1","doc":"Generates a session token.","ref":"Lightning.Accounts.html#generate_user_session_token/1"},{"type":"function","title":"Lightning.Accounts.get_preference/2","doc":"Retrieves a specific preference value for a given user.\n\nReturns the value of the specified key from the user's preferences.\nIf the value is the string `\"true\"` or `\"false\"`, it is converted to a boolean.","ref":"Lightning.Accounts.html#get_preference/2"},{"type":"function","title":"Examples - Lightning.Accounts.get_preference/2","doc":"iex> get_preference(user, \"editor.orientation\")\n \"vertical\"\n\n iex> get_preference(user, \"notifications.enabled\")\n true","ref":"Lightning.Accounts.html#get_preference/2-examples"},{"type":"function","title":"Lightning.Accounts.get_token!/1","doc":"Gets a single token.\n\nRaises `Ecto.NoResultsError` if the UserToken does not exist.","ref":"Lightning.Accounts.html#get_token!/1"},{"type":"function","title":"Examples - Lightning.Accounts.get_token!/1","doc":"iex> get_token!(123)\n %UserToken{}\n\n iex> get_token!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Accounts.html#get_token!/1-examples"},{"type":"function","title":"Lightning.Accounts.get_user/1","doc":"Gets a single user.","ref":"Lightning.Accounts.html#get_user/1"},{"type":"function","title":"Examples - Lightning.Accounts.get_user/1","doc":"iex> get_user(123)\n %User{}\n\n iex> get_user!(456)\n nil","ref":"Lightning.Accounts.html#get_user/1-examples"},{"type":"function","title":"Lightning.Accounts.get_user!/1","doc":"Gets a single user.\n\nRaises `Ecto.NoResultsError` if the User does not exist.\n\nSee `get_user/1`.","ref":"Lightning.Accounts.html#get_user!/1"},{"type":"function","title":"Lightning.Accounts.get_user_by_api_token/1","doc":"Gets the user with the given signed token.","ref":"Lightning.Accounts.html#get_user_by_api_token/1"},{"type":"function","title":"Lightning.Accounts.get_user_by_auth_token/1","doc":"Gets the user with the given signed token.","ref":"Lightning.Accounts.html#get_user_by_auth_token/1"},{"type":"function","title":"Lightning.Accounts.get_user_by_email/1","doc":"Gets a user by email.","ref":"Lightning.Accounts.html#get_user_by_email/1"},{"type":"function","title":"Examples - Lightning.Accounts.get_user_by_email/1","doc":"iex> get_user_by_email(\"foo@example.com\")\n %User{}\n\n iex> get_user_by_email(\"unknown@example.com\")\n nil","ref":"Lightning.Accounts.html#get_user_by_email/1-examples"},{"type":"function","title":"Lightning.Accounts.get_user_by_email_and_password/2","doc":"Gets a user by email and password.","ref":"Lightning.Accounts.html#get_user_by_email_and_password/2"},{"type":"function","title":"Examples - Lightning.Accounts.get_user_by_email_and_password/2","doc":"iex> get_user_by_email_and_password(\"foo@example.com\", \"correct_password\")\n %User{}\n\n iex> get_user_by_email_and_password(\"foo@example.com\", \"invalid_password\")\n nil","ref":"Lightning.Accounts.html#get_user_by_email_and_password/2-examples"},{"type":"function","title":"Lightning.Accounts.get_user_by_reset_password_token/1","doc":"Gets the user by reset password token.","ref":"Lightning.Accounts.html#get_user_by_reset_password_token/1"},{"type":"function","title":"Examples - Lightning.Accounts.get_user_by_reset_password_token/1","doc":"iex> get_user_by_reset_password_token(\"validtoken\")\n %User{}\n\n iex> get_user_by_reset_password_token(\"invalidtoken\")\n nil","ref":"Lightning.Accounts.html#get_user_by_reset_password_token/1-examples"},{"type":"function","title":"Lightning.Accounts.get_user_by_session_token/1","doc":"Gets the user with the given signed token.","ref":"Lightning.Accounts.html#get_user_by_session_token/1"},{"type":"function","title":"Lightning.Accounts.get_user_totp/1","doc":"Gets a single UserTOTP if any exists.","ref":"Lightning.Accounts.html#get_user_totp/1"},{"type":"function","title":"Lightning.Accounts.get_users_to_alert_for_project/1","doc":"Gets all users to alert of workflow failure for a project","ref":"Lightning.Accounts.html#get_users_to_alert_for_project/1"},{"type":"function","title":"Lightning.Accounts.has_activity_in_projects?/1","doc":"","ref":"Lightning.Accounts.html#has_activity_in_projects?/1"},{"type":"function","title":"Lightning.Accounts.has_one_superuser?/0","doc":"Used to determine if there is at least one Superuser in the system.\nThis triggers the setup page on fresh installs.","ref":"Lightning.Accounts.html#has_one_superuser?/0"},{"type":"function","title":"Lightning.Accounts.list_api_tokens/1","doc":"Lists all user tokens","ref":"Lightning.Accounts.html#list_api_tokens/1"},{"type":"function","title":"Lightning.Accounts.list_user_backup_codes/1","doc":"Lists the user backup codes","ref":"Lightning.Accounts.html#list_user_backup_codes/1"},{"type":"function","title":"Lightning.Accounts.list_users/0","doc":"Returns the list of users.","ref":"Lightning.Accounts.html#list_users/0"},{"type":"function","title":"Examples - Lightning.Accounts.list_users/0","doc":"iex> list_users()\n [%User{}, ...]","ref":"Lightning.Accounts.html#list_users/0-examples"},{"type":"function","title":"Lightning.Accounts.list_users_by_emails/1","doc":"Returns the list of users with the given emails","ref":"Lightning.Accounts.html#list_users_by_emails/1"},{"type":"function","title":"Lightning.Accounts.perform/1","doc":"Perform, when called with %{\"type\" => \"purge_deleted\"} will find users that are ready for permanent deletion and purge them.","ref":"Lightning.Accounts.html#perform/1"},{"type":"function","title":"Lightning.Accounts.purge_user/1","doc":"","ref":"Lightning.Accounts.html#purge_user/1"},{"type":"function","title":"Lightning.Accounts.regenerate_user_backup_codes/1","doc":"Regenerates the user backup codes","ref":"Lightning.Accounts.html#regenerate_user_backup_codes/1"},{"type":"function","title":"Lightning.Accounts.register_superuser/1","doc":"Registers a superuser.","ref":"Lightning.Accounts.html#register_superuser/1"},{"type":"function","title":"Examples - Lightning.Accounts.register_superuser/1","doc":"iex> register_superuser(%{field: value})\n {:ok, %User{}}\n\n iex> register_superuser(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#register_superuser/1-examples"},{"type":"function","title":"Lightning.Accounts.register_user/1","doc":"Registers a user.","ref":"Lightning.Accounts.html#register_user/1"},{"type":"function","title":"Examples - Lightning.Accounts.register_user/1","doc":"iex> register_user(%{field: value})\n {:ok, %User{}}\n\n iex> register_user(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#register_user/1-examples"},{"type":"function","title":"Lightning.Accounts.remind_account_confirmation/1","doc":"","ref":"Lightning.Accounts.html#remind_account_confirmation/1"},{"type":"function","title":"Lightning.Accounts.request_email_update/2","doc":"Delivers the update email instructions to the given user.","ref":"Lightning.Accounts.html#request_email_update/2"},{"type":"function","title":"Examples - Lightning.Accounts.request_email_update/2","doc":"iex> request_email_update(user, new_email)\n :ok","ref":"Lightning.Accounts.html#request_email_update/2-examples"},{"type":"function","title":"Lightning.Accounts.reset_user_password/2","doc":"Resets the user password.","ref":"Lightning.Accounts.html#reset_user_password/2"},{"type":"function","title":"Examples - Lightning.Accounts.reset_user_password/2","doc":"iex> reset_user_password(user, %{password: \"new long password\", password_confirmation: \"new long password\"})\n {:ok, %User{}}\n\n iex> reset_user_password(user, %{password: \"valid\", password_confirmation: \"not the same\"})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#reset_user_password/2-examples"},{"type":"function","title":"Lightning.Accounts.schedule_user_deletion/2","doc":"Given a user and a confirmation email, this function sets a scheduled deletion\ndate based on the PURGE_DELETED_AFTER_DAYS environment variable. If no ENV is\nset, this date defaults to NOW but the automatic user purge cronjob will never\nrun. (Note that subsequent logins will be blocked for users pending deletion.)","ref":"Lightning.Accounts.html#schedule_user_deletion/2"},{"type":"function","title":"Lightning.Accounts.subscribe/0","doc":"","ref":"Lightning.Accounts.html#subscribe/0"},{"type":"function","title":"Lightning.Accounts.sudo_session_token_valid?/2","doc":"Checks if the given sudo token for the user is valid","ref":"Lightning.Accounts.html#sudo_session_token_valid?/2"},{"type":"function","title":"Lightning.Accounts.update_user_details/2","doc":"","ref":"Lightning.Accounts.html#update_user_details/2"},{"type":"function","title":"Lightning.Accounts.update_user_email/2","doc":"Updates the user email using the given token.\n\nIf the token matches, the user email is updated and the token is deleted.\nThe confirmed_at date is also updated to the current time.","ref":"Lightning.Accounts.html#update_user_email/2"},{"type":"function","title":"Lightning.Accounts.update_user_info/2","doc":"","ref":"Lightning.Accounts.html#update_user_info/2"},{"type":"function","title":"Lightning.Accounts.update_user_password/3","doc":"Updates the user password.","ref":"Lightning.Accounts.html#update_user_password/3"},{"type":"function","title":"Examples - Lightning.Accounts.update_user_password/3","doc":"iex> update_user_password(user, \"valid password\", %{password: ...})\n {:ok, %User{}}\n\n iex> update_user_password(user, \"invalid password\", %{password: ...})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#update_user_password/3-examples"},{"type":"function","title":"Lightning.Accounts.update_user_preference/3","doc":"Updates a specific key in the user's preferences.\n\nMerges the new key-value pair into the user's existing preferences and updates the database.","ref":"Lightning.Accounts.html#update_user_preference/3"},{"type":"function","title":"Examples - Lightning.Accounts.update_user_preference/3","doc":"iex> update_user_preference(user, \"editor.orientation\", \"vertical\")\n {:ok, %User{}}\n\n iex> update_user_preference(user, \"notifications.enabled\", true)\n {:ok, %User{}}","ref":"Lightning.Accounts.html#update_user_preference/3-examples"},{"type":"function","title":"Lightning.Accounts.update_user_preferences/2","doc":"Updates the user preferences.","ref":"Lightning.Accounts.html#update_user_preferences/2"},{"type":"function","title":"Examples - Lightning.Accounts.update_user_preferences/2","doc":"iex> update_user_preferences(%User{}, %{\"editor.orientaion\" => \"vertical\"})","ref":"Lightning.Accounts.html#update_user_preferences/2-examples"},{"type":"function","title":"Lightning.Accounts.upsert_user_totp/2","doc":"Updates or Inserts the user's TOTP","ref":"Lightning.Accounts.html#upsert_user_totp/2"},{"type":"function","title":"Lightning.Accounts.valid_user_backup_code?/2","doc":"Validates if the given Backup code is valid.","ref":"Lightning.Accounts.html#valid_user_backup_code?/2"},{"type":"function","title":"Lightning.Accounts.valid_user_totp?/2","doc":"Validates if the given TOTP code is valid.","ref":"Lightning.Accounts.html#valid_user_totp?/2"},{"type":"function","title":"Lightning.Accounts.validate_change_user_email/2","doc":"Validates the changes for updating a user's email address.\n\nThis function ensures that:\n- The `email` and `current_password` fields are present.\n- The new email is in a valid format.\n- The new email is different from the current one.\n- The provided `current_password` matches the user's password.","ref":"Lightning.Accounts.html#validate_change_user_email/2"},{"type":"function","title":"Parameters - Lightning.Accounts.validate_change_user_email/2","doc":"- `user`: The `%User{}` struct representing the current user.\n- `params`: A map of parameters containing the new email and current password.","ref":"Lightning.Accounts.html#validate_change_user_email/2-parameters"},{"type":"function","title":"Returns - Lightning.Accounts.validate_change_user_email/2","doc":"An `Ecto.Changeset` containing any validation errors.","ref":"Lightning.Accounts.html#validate_change_user_email/2-returns"},{"type":"function","title":"Examples - Lightning.Accounts.validate_change_user_email/2","doc":"iex> validate_change_user_email(user, %{\"email\" => \"new@example.com\", \"current_password\" => \"secret\"})\n %Ecto.Changeset{...}","ref":"Lightning.Accounts.html#validate_change_user_email/2-examples"},{"type":"module","title":"Lightning.Accounts.Events","doc":"Publishes and subscribe to events related to user accounts.","ref":"Lightning.Accounts.Events.html"},{"type":"function","title":"Lightning.Accounts.Events.subscribe/0","doc":"","ref":"Lightning.Accounts.Events.html#subscribe/0"},{"type":"function","title":"Lightning.Accounts.Events.user_registered/1","doc":"","ref":"Lightning.Accounts.Events.html#user_registered/1"},{"type":"module","title":"Lightning.Accounts.User","doc":"The User model.","ref":"Lightning.Accounts.User.html"},{"type":"function","title":"Lightning.Accounts.User.changeset/2","doc":"","ref":"Lightning.Accounts.User.html#changeset/2"},{"type":"function","title":"Lightning.Accounts.User.confirm_changeset/1","doc":"Confirms the account by setting `confirmed_at`.","ref":"Lightning.Accounts.User.html#confirm_changeset/1"},{"type":"function","title":"Lightning.Accounts.User.details_changeset/2","doc":"A user changeset for user details:\n\n- email\n- first_name\n- last_name\n- role","ref":"Lightning.Accounts.User.html#details_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.email_changeset/2","doc":"A user changeset for changing the email.\n\nIt requires the email to change otherwise an error is added.","ref":"Lightning.Accounts.User.html#email_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.github_token_changeset/2","doc":"","ref":"Lightning.Accounts.User.html#github_token_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.info_changeset/2","doc":"A user changeset for basic information:\n\n- first_name\n- last_name\n- contact_preference","ref":"Lightning.Accounts.User.html#info_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.password_changeset/3","doc":"A user changeset for changing the password.","ref":"Lightning.Accounts.User.html#password_changeset/3"},{"type":"function","title":"Options - Lightning.Accounts.User.password_changeset/3","doc":"* `:hash_password` - Hashes the password so it can be stored securely\n in the database and ensures the password field is cleared to prevent\n leaks in the logs. If password hashing is not needed and clearing the\n password field is not desired (like when using this changeset for\n validations on a LiveView form), this option can be set to `false`.\n Defaults to `true`.","ref":"Lightning.Accounts.User.html#password_changeset/3-options"},{"type":"function","title":"Lightning.Accounts.User.preferences_changeset/2","doc":"","ref":"Lightning.Accounts.User.html#preferences_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.remove_github_token_changeset/1","doc":"","ref":"Lightning.Accounts.User.html#remove_github_token_changeset/1"},{"type":"function","title":"Lightning.Accounts.User.scheduled_deletion_changeset/2","doc":"A user changeset for changing the scheduled_deletion property.","ref":"Lightning.Accounts.User.html#scheduled_deletion_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.superuser_registration_changeset/2","doc":"A superuser changeset for registration.\n\nIt is important to validate the length of both email and password.\nOtherwise databases may truncate the email without warnings, which\ncould lead to unpredictable or insecure behaviour. Long passwords may\nalso be very expensive to hash for certain algorithms.","ref":"Lightning.Accounts.User.html#superuser_registration_changeset/2"},{"type":"function","title":"Options - Lightning.Accounts.User.superuser_registration_changeset/2","doc":"* `:hash_password` - Hashes the password so it can be stored securely\n in the database and ensures the password field is cleared to prevent\n leaks in the logs. If password hashing is not needed and clearing the\n password field is not desired (like when using this changeset for\n validations on a LiveView form), this option can be set to `false`.\n Defaults to `true`.","ref":"Lightning.Accounts.User.html#superuser_registration_changeset/2-options"},{"type":"function","title":"Lightning.Accounts.User.user_registration_changeset/2","doc":"A user changeset for registration.\n\nIt is important to validate the length of both email and password.\nOtherwise databases may truncate the email without warnings, which\ncould lead to unpredictable or insecure behaviour. Long passwords may\nalso be very expensive to hash for certain algorithms.","ref":"Lightning.Accounts.User.html#user_registration_changeset/2"},{"type":"function","title":"Options - Lightning.Accounts.User.user_registration_changeset/2","doc":"* `:hash_password` - Hashes the password so it can be stored securely\n in the database and ensures the password field is cleared to prevent\n leaks in the logs. If password hashing is not needed and clearing the\n password field is not desired (like when using this changeset for\n validations on a LiveView form), this option can be set to `false`.\n Defaults to `true`.","ref":"Lightning.Accounts.User.html#user_registration_changeset/2-options"},{"type":"function","title":"Lightning.Accounts.User.valid_password?/2","doc":"Verifies the password.\n\nIf there is no user or the user doesn't have a password, we call\n`Bcrypt.no_user_verify/0` to avoid timing attacks.","ref":"Lightning.Accounts.User.html#valid_password?/2"},{"type":"function","title":"Lightning.Accounts.User.validate_current_password/2","doc":"Validates the current password otherwise adds an error to the changeset.","ref":"Lightning.Accounts.User.html#validate_current_password/2"},{"type":"function","title":"Lightning.Accounts.User.validate_email/1","doc":"","ref":"Lightning.Accounts.User.html#validate_email/1"},{"type":"type","title":"Lightning.Accounts.User.t/0","doc":"","ref":"Lightning.Accounts.User.html#t:t/0"},{"type":"module","title":"Lightning.Accounts.User.RolesEnum","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.cast/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#cast/1"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.create_type/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#create_type/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.drop_type/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#drop_type/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.dump/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#dump/1"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.embed_as/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#embed_as/1"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.equal?/2","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#equal?/2"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.load/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#load/1"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.schema/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#schema/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.schemaless_type/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#schemaless_type/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.type/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#type/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.valid_value?/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#valid_value?/1"},{"type":"type","title":"Lightning.Accounts.User.RolesEnum.t/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#t:t/0"},{"type":"module","title":"Lightning.Accounts.UserBackupCode","doc":"User backup codes schema","ref":"Lightning.Accounts.UserBackupCode.html"},{"type":"function","title":"Lightning.Accounts.UserBackupCode.changeset/2","doc":"","ref":"Lightning.Accounts.UserBackupCode.html#changeset/2"},{"type":"function","title":"Lightning.Accounts.UserBackupCode.generate_backup_code/0","doc":"","ref":"Lightning.Accounts.UserBackupCode.html#generate_backup_code/0"},{"type":"type","title":"Lightning.Accounts.UserBackupCode.t/0","doc":"","ref":"Lightning.Accounts.UserBackupCode.html#t:t/0"},{"type":"module","title":"Lightning.Accounts.UserNotifier","doc":"The UserNotifier module.","ref":"Lightning.Accounts.UserNotifier.html"},{"type":"function","title":"Lightning.Accounts.UserNotifier.build_digest_url/3","doc":"","ref":"Lightning.Accounts.UserNotifier.html#build_digest_url/3"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_confirmation_instructions/2","doc":"Deliver instructions to confirm account.","ref":"Lightning.Accounts.UserNotifier.html#deliver_confirmation_instructions/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_confirmation_instructions/3","doc":"Deliver instructions to confirm account.","ref":"Lightning.Accounts.UserNotifier.html#deliver_confirmation_instructions/3"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_project_addition_notification/2","doc":"Deliver email to notify user of his addition of a project.","ref":"Lightning.Accounts.UserNotifier.html#deliver_project_addition_notification/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_project_digest/2","doc":"Deliver a project digest of daily/weekly or monthly activity to a user.","ref":"Lightning.Accounts.UserNotifier.html#deliver_project_digest/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_project_invitation_email/5","doc":"","ref":"Lightning.Accounts.UserNotifier.html#deliver_project_invitation_email/5"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_reset_password_instructions/2","doc":"Deliver instructions to reset a user password.","ref":"Lightning.Accounts.UserNotifier.html#deliver_reset_password_instructions/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_update_email_instructions/2","doc":"Deliver instructions to update a user.","ref":"Lightning.Accounts.UserNotifier.html#deliver_update_email_instructions/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_update_email_warning/2","doc":"Deliver warning to update a user.","ref":"Lightning.Accounts.UserNotifier.html#deliver_update_email_warning/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.notify_history_export_completion/2","doc":"","ref":"Lightning.Accounts.UserNotifier.html#notify_history_export_completion/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.notify_project_deletion/2","doc":"","ref":"Lightning.Accounts.UserNotifier.html#notify_project_deletion/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.remind_account_confirmation/2","doc":"","ref":"Lightning.Accounts.UserNotifier.html#remind_account_confirmation/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.send_credential_deletion_notification_email/2","doc":"","ref":"Lightning.Accounts.UserNotifier.html#send_credential_deletion_notification_email/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.send_data_retention_change_email/2","doc":"Deliver an email to notify the user about a data retention setting change made in their project","ref":"Lightning.Accounts.UserNotifier.html#send_data_retention_change_email/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.send_deletion_notification_email/1","doc":"Deliver an email to notify the user about their account being deleted","ref":"Lightning.Accounts.UserNotifier.html#send_deletion_notification_email/1"},{"type":"function","title":"Lightning.Accounts.UserNotifier.send_trigger_failure_mail/3","doc":"","ref":"Lightning.Accounts.UserNotifier.html#send_trigger_failure_mail/3"},{"type":"module","title":"Lightning.Accounts.UserTOTP","doc":"User Time based OTPs schema","ref":"Lightning.Accounts.UserTOTP.html"},{"type":"function","title":"Lightning.Accounts.UserTOTP.changeset/2","doc":"","ref":"Lightning.Accounts.UserTOTP.html#changeset/2"},{"type":"function","title":"Lightning.Accounts.UserTOTP.valid_totp?/2","doc":"","ref":"Lightning.Accounts.UserTOTP.html#valid_totp?/2"},{"type":"type","title":"Lightning.Accounts.UserTOTP.t/0","doc":"","ref":"Lightning.Accounts.UserTOTP.html#t:t/0"},{"type":"module","title":"Lightning.Accounts.UserToken","doc":"The UserToken model.\n\nThe reason why we store session tokens in the database, even\nthough Phoenix already provides a session cookie, is because\nPhoenix' default session cookies are not persisted, they are\nsimply signed and potentially encrypted. This means they are\nvalid indefinitely, unless you change the signing/encryption\nsalt.\n\nTherefore, storing them allows individual user\nsessions to be expired. The token system can also be extended\nto store additional data, such as the device used for logging in.\nYou could then use this information to display all valid sessions\nand devices in the UI and allow users to explicitly expire any\nsession they deem invalid.","ref":"Lightning.Accounts.UserToken.html"},{"type":"function","title":"Lightning.Accounts.UserToken.build_email_token/3","doc":"Builds a token and its hash to be delivered to the user's email.\n\nThe non-hashed token is sent to the user email while the\nhashed part is stored in the database. The original token cannot be reconstructed,\nwhich means anyone with read-only access to the database cannot directly use\nthe token in the application to gain access. Furthermore, if the user changes\ntheir email in the system, the tokens sent to the previous email are no longer\nvalid.\n\nUsers can easily adapt the existing code to provide other types of delivery methods,\nfor example, by phone numbers.","ref":"Lightning.Accounts.UserToken.html#build_email_token/3"},{"type":"function","title":"Lightning.Accounts.UserToken.build_token/2","doc":"Generates a token that will be stored in a signed place,\nsuch as session or cookie. As they are signed, those\ntokens do not need to be hashed.","ref":"Lightning.Accounts.UserToken.html#build_token/2"},{"type":"function","title":"Lightning.Accounts.UserToken.changeset/2","doc":"","ref":"Lightning.Accounts.UserToken.html#changeset/2"},{"type":"function","title":"Lightning.Accounts.UserToken.last_used_changeset/1","doc":"Update when the api token was last used by setting`last_used_at`.","ref":"Lightning.Accounts.UserToken.html#last_used_changeset/1"},{"type":"function","title":"Lightning.Accounts.UserToken.token_and_context_query/2","doc":"Returns the token struct for the given token value and context.","ref":"Lightning.Accounts.UserToken.html#token_and_context_query/2"},{"type":"function","title":"Lightning.Accounts.UserToken.user_and_contexts_query/2","doc":"Gets all tokens for the given user for the given contexts.","ref":"Lightning.Accounts.UserToken.html#user_and_contexts_query/2"},{"type":"function","title":"Lightning.Accounts.UserToken.verify_change_email_token_query/2","doc":"Checks if the token is valid and returns its underlying lookup query.\n\nThe query returns the user found by the token, if any.\n\nThis is used to validate requests to change the user\nemail. It is different from `verify_email_token_query/2` precisely because\n`verify_email_token_query/2` validates the email has not changed, which is\nthe starting point by this function.\n\nThe given token is valid if it matches its hashed counterpart in the\ndatabase and if it has not expired (after @change_email_validity_in_days).\nThe context must always start with \"change:\".","ref":"Lightning.Accounts.UserToken.html#verify_change_email_token_query/2"},{"type":"function","title":"Lightning.Accounts.UserToken.verify_email_token_query/2","doc":"Checks if the token is valid and returns its underlying lookup query.\n\nThe query returns the user found by the token, if any.\n\nThe given token is valid if it matches its hashed counterpart in the\ndatabase and the user email has not changed. This function also checks\nif the token is being used within a certain period, depending on the\ncontext. The default contexts supported by this function are either\n\"confirm\", for account confirmation emails, and \"reset_password\",\nfor resetting the password. For verifying requests to change the email,\nsee `verify_change_email_token_query/2`.","ref":"Lightning.Accounts.UserToken.html#verify_email_token_query/2"},{"type":"function","title":"Lightning.Accounts.UserToken.verify_token_query/2","doc":"Checks if the token is valid and returns its underlying lookup query.\n\nThe query returns the user found by the token, if any.\n\nThe token is valid if it matches the value in the database and it has\nnot expired (after @auth_validity_in_seconds or @session_validity_in_days).","ref":"Lightning.Accounts.UserToken.html#verify_token_query/2"},{"type":"behaviour","title":"Lightning.Config","doc":"Centralised runtime configuration for Lightning.","ref":"Lightning.Config.html"},{"type":"function","title":"Lightning.Config.apollo/1","doc":"Returns the Apollo server configuration.","ref":"Lightning.Config.html#apollo/1"},{"type":"callback","title":"Lightning.Config.apollo/1","doc":"","ref":"Lightning.Config.html#c:apollo/1"},{"type":"function","title":"Lightning.Config.check_flag?/1","doc":"","ref":"Lightning.Config.html#check_flag?/1"},{"type":"callback","title":"Lightning.Config.check_flag?/1","doc":"","ref":"Lightning.Config.html#c:check_flag?/1"},{"type":"function","title":"Lightning.Config.cors_origin/0","doc":"","ref":"Lightning.Config.html#cors_origin/0"},{"type":"callback","title":"Lightning.Config.cors_origin/0","doc":"","ref":"Lightning.Config.html#c:cors_origin/0"},{"type":"function","title":"Lightning.Config.default_max_run_duration/0","doc":"Returns the default maximum run duration in seconds.","ref":"Lightning.Config.html#default_max_run_duration/0"},{"type":"callback","title":"Lightning.Config.default_max_run_duration/0","doc":"","ref":"Lightning.Config.html#c:default_max_run_duration/0"},{"type":"function","title":"Lightning.Config.email_sender_name/0","doc":"","ref":"Lightning.Config.html#email_sender_name/0"},{"type":"callback","title":"Lightning.Config.email_sender_name/0","doc":"","ref":"Lightning.Config.html#c:email_sender_name/0"},{"type":"function","title":"Lightning.Config.get_extension_mod/1","doc":"","ref":"Lightning.Config.html#get_extension_mod/1"},{"type":"callback","title":"Lightning.Config.get_extension_mod/1","doc":"","ref":"Lightning.Config.html#c:get_extension_mod/1"},{"type":"function","title":"Lightning.Config.google/1","doc":"","ref":"Lightning.Config.html#google/1"},{"type":"callback","title":"Lightning.Config.google/1","doc":"","ref":"Lightning.Config.html#c:google/1"},{"type":"function","title":"Lightning.Config.grace_period/0","doc":"The grace period is configurable and is used to wait for an additional\namount of time after a given run was meant to be finished.\n\nThe returned value is in seconds.","ref":"Lightning.Config.html#grace_period/0"},{"type":"callback","title":"Lightning.Config.grace_period/0","doc":"","ref":"Lightning.Config.html#c:grace_period/0"},{"type":"function","title":"Lightning.Config.instance_admin_email/0","doc":"","ref":"Lightning.Config.html#instance_admin_email/0"},{"type":"callback","title":"Lightning.Config.instance_admin_email/0","doc":"","ref":"Lightning.Config.html#c:instance_admin_email/0"},{"type":"function","title":"Lightning.Config.kafka_alternate_storage_enabled?/0","doc":"","ref":"Lightning.Config.html#kafka_alternate_storage_enabled?/0"},{"type":"callback","title":"Lightning.Config.kafka_alternate_storage_enabled?/0","doc":"","ref":"Lightning.Config.html#c:kafka_alternate_storage_enabled?/0"},{"type":"function","title":"Lightning.Config.kafka_alternate_storage_file_path/0","doc":"","ref":"Lightning.Config.html#kafka_alternate_storage_file_path/0"},{"type":"callback","title":"Lightning.Config.kafka_alternate_storage_file_path/0","doc":"","ref":"Lightning.Config.html#c:kafka_alternate_storage_file_path/0"},{"type":"function","title":"Lightning.Config.kafka_duplicate_tracking_retention_seconds/0","doc":"","ref":"Lightning.Config.html#kafka_duplicate_tracking_retention_seconds/0"},{"type":"callback","title":"Lightning.Config.kafka_duplicate_tracking_retention_seconds/0","doc":"","ref":"Lightning.Config.html#c:kafka_duplicate_tracking_retention_seconds/0"},{"type":"function","title":"Lightning.Config.kafka_notification_embargo_seconds/0","doc":"","ref":"Lightning.Config.html#kafka_notification_embargo_seconds/0"},{"type":"callback","title":"Lightning.Config.kafka_notification_embargo_seconds/0","doc":"","ref":"Lightning.Config.html#c:kafka_notification_embargo_seconds/0"},{"type":"function","title":"Lightning.Config.kafka_number_of_consumers/0","doc":"","ref":"Lightning.Config.html#kafka_number_of_consumers/0"},{"type":"callback","title":"Lightning.Config.kafka_number_of_consumers/0","doc":"","ref":"Lightning.Config.html#c:kafka_number_of_consumers/0"},{"type":"function","title":"Lightning.Config.kafka_number_of_messages_per_second/0","doc":"","ref":"Lightning.Config.html#kafka_number_of_messages_per_second/0"},{"type":"callback","title":"Lightning.Config.kafka_number_of_messages_per_second/0","doc":"","ref":"Lightning.Config.html#c:kafka_number_of_messages_per_second/0"},{"type":"function","title":"Lightning.Config.kafka_number_of_processors/0","doc":"","ref":"Lightning.Config.html#kafka_number_of_processors/0"},{"type":"callback","title":"Lightning.Config.kafka_number_of_processors/0","doc":"","ref":"Lightning.Config.html#c:kafka_number_of_processors/0"},{"type":"function","title":"Lightning.Config.kafka_triggers_enabled?/0","doc":"","ref":"Lightning.Config.html#kafka_triggers_enabled?/0"},{"type":"callback","title":"Lightning.Config.kafka_triggers_enabled?/0","doc":"","ref":"Lightning.Config.html#c:kafka_triggers_enabled?/0"},{"type":"function","title":"Lightning.Config.oauth_provider/1","doc":"","ref":"Lightning.Config.html#oauth_provider/1"},{"type":"callback","title":"Lightning.Config.oauth_provider/1","doc":"","ref":"Lightning.Config.html#c:oauth_provider/1"},{"type":"function","title":"Lightning.Config.purge_deleted_after_days/0","doc":"","ref":"Lightning.Config.html#purge_deleted_after_days/0"},{"type":"callback","title":"Lightning.Config.purge_deleted_after_days/0","doc":"","ref":"Lightning.Config.html#c:purge_deleted_after_days/0"},{"type":"function","title":"Lightning.Config.repo_connection_token_signer/0","doc":"","ref":"Lightning.Config.html#repo_connection_token_signer/0"},{"type":"callback","title":"Lightning.Config.repo_connection_token_signer/0","doc":"","ref":"Lightning.Config.html#c:repo_connection_token_signer/0"},{"type":"function","title":"Lightning.Config.reset_password_token_validity_in_days/0","doc":"","ref":"Lightning.Config.html#reset_password_token_validity_in_days/0"},{"type":"callback","title":"Lightning.Config.reset_password_token_validity_in_days/0","doc":"","ref":"Lightning.Config.html#c:reset_password_token_validity_in_days/0"},{"type":"function","title":"Lightning.Config.run_token_signer/0","doc":"Returns the Token signer used to sign and verify run tokens.","ref":"Lightning.Config.html#run_token_signer/0"},{"type":"callback","title":"Lightning.Config.run_token_signer/0","doc":"","ref":"Lightning.Config.html#c:run_token_signer/0"},{"type":"function","title":"Lightning.Config.storage/0","doc":"","ref":"Lightning.Config.html#storage/0"},{"type":"callback","title":"Lightning.Config.storage/0","doc":"","ref":"Lightning.Config.html#c:storage/0"},{"type":"function","title":"Lightning.Config.storage/1","doc":"","ref":"Lightning.Config.html#storage/1"},{"type":"callback","title":"Lightning.Config.storage/1","doc":"","ref":"Lightning.Config.html#c:storage/1"},{"type":"function","title":"Lightning.Config.token_signer/0","doc":"","ref":"Lightning.Config.html#token_signer/0"},{"type":"callback","title":"Lightning.Config.token_signer/0","doc":"","ref":"Lightning.Config.html#c:token_signer/0"},{"type":"function","title":"Lightning.Config.usage_tracking/0","doc":"","ref":"Lightning.Config.html#usage_tracking/0"},{"type":"callback","title":"Lightning.Config.usage_tracking/0","doc":"","ref":"Lightning.Config.html#c:usage_tracking/0"},{"type":"function","title":"Lightning.Config.usage_tracking_cron_opts/0","doc":"","ref":"Lightning.Config.html#usage_tracking_cron_opts/0"},{"type":"callback","title":"Lightning.Config.usage_tracking_cron_opts/0","doc":"","ref":"Lightning.Config.html#c:usage_tracking_cron_opts/0"},{"type":"function","title":"Lightning.Config.worker_secret/0","doc":"","ref":"Lightning.Config.html#worker_secret/0"},{"type":"callback","title":"Lightning.Config.worker_secret/0","doc":"","ref":"Lightning.Config.html#c:worker_secret/0"},{"type":"function","title":"Lightning.Config.worker_token_signer/0","doc":"Returns the Token signer used to verify worker tokens.","ref":"Lightning.Config.html#worker_token_signer/0"},{"type":"callback","title":"Lightning.Config.worker_token_signer/0","doc":"","ref":"Lightning.Config.html#c:worker_token_signer/0"},{"type":"module","title":"Lightning.Config.Bootstrap","doc":"Bootstrap the application environment.\n\nThis module is responsible for setting up the application environment based on\nthe configuration provided by the user.\n\nUsually, config calls are made in the `config/runtime.exs` file. This module\nabstracts the runtime configuration into a module that can be tested and\ncalled from other places (aside from `config/runtime.exs`) file.\n\n> #### Sourcing envs {: .info}\n>\n> Internally this module uses `Dotenvy.source/1` to source environment variables\n> from the `.env`, `.env. `, and `.env. .override` files.\n> It also sources the system environment variables.\n>\n> Calling `configure/0` without calling `source_envs/0` or `Dotenvy.source/2`\n> first will result in no environment variables being loaded.\n\nUsage:\n\n```elixir\nLightning.Config.Bootstrap.source_envs()\nLightning.Config.Bootstrap.configure()\n```","ref":"Lightning.Config.Bootstrap.html"},{"type":"function","title":"Lightning.Config.Bootstrap.configure/0","doc":"","ref":"Lightning.Config.Bootstrap.html#configure/0"},{"type":"function","title":"Lightning.Config.Bootstrap.source_envs/0","doc":"","ref":"Lightning.Config.Bootstrap.html#source_envs/0"},{"type":"module","title":"Lightning.Config.Utils","doc":"Utility functions for working with the application environment.","ref":"Lightning.Config.Utils.html"},{"type":"function","title":"Lightning.Config.Utils.ensure_boolean/1","doc":"","ref":"Lightning.Config.Utils.html#ensure_boolean/1"},{"type":"function","title":"Lightning.Config.Utils.get_env/2","doc":"Retrieve a value nested in the application environment.","ref":"Lightning.Config.Utils.html#get_env/2"},{"type":"module","title":"Lightning.Runs","doc":"Gathers operations to create, update and delete Runs.","ref":"Lightning.Runs.html"},{"type":"function","title":"Lightning.Runs.append_run_log/3","doc":"","ref":"Lightning.Runs.html#append_run_log/3"},{"type":"function","title":"Lightning.Runs.complete_run/2","doc":"","ref":"Lightning.Runs.html#complete_run/2"},{"type":"function","title":"Lightning.Runs.complete_step/2","doc":"","ref":"Lightning.Runs.html#complete_step/2"},{"type":"function","title":"Lightning.Runs.enqueue/1","doc":"Enqueue a run to be processed.","ref":"Lightning.Runs.html#enqueue/1"},{"type":"function","title":"Lightning.Runs.get/2","doc":"Get a run by id.\n\nOptionally preload associations by passing a list of atoms to `:include`.\n\n Lightning.Runs.get(id, include: [:workflow])","ref":"Lightning.Runs.html#get/2"},{"type":"function","title":"Lightning.Runs.get_credential/2","doc":"","ref":"Lightning.Runs.html#get_credential/2"},{"type":"function","title":"Lightning.Runs.get_dataclip_body/1","doc":"Returns only the dataclip body as a string","ref":"Lightning.Runs.html#get_dataclip_body/1"},{"type":"function","title":"Lightning.Runs.get_dataclip_request/1","doc":"Returns only the dataclip request as a string","ref":"Lightning.Runs.html#get_dataclip_request/1"},{"type":"function","title":"Lightning.Runs.get_for_worker/1","doc":"Get a run by id, preloading the snapshot and its credential.","ref":"Lightning.Runs.html#get_for_worker/1"},{"type":"function","title":"Lightning.Runs.get_input/1","doc":"Returns a run's dataclip formatted for use as state.\n\nOnly `http_request` and kafka dataclips are changed,\ntheir `body` is nested inside a `\"data\"` key and `request` data\nis added as a `\"request\"` key.\n\nSee LightingWeb.RunChannel.handle_in(\"fetch:dataclip\", _, _)\nfor more details.","ref":"Lightning.Runs.html#get_input/1"},{"type":"function","title":"Lightning.Runs.get_log_lines/2","doc":"","ref":"Lightning.Runs.html#get_log_lines/2"},{"type":"function","title":"Lightning.Runs.get_project_id_for_run/1","doc":"","ref":"Lightning.Runs.html#get_project_id_for_run/1"},{"type":"function","title":"Lightning.Runs.mark_run_lost/1","doc":"","ref":"Lightning.Runs.html#mark_run_lost/1"},{"type":"function","title":"Lightning.Runs.mark_steps_lost/1","doc":"","ref":"Lightning.Runs.html#mark_steps_lost/1"},{"type":"function","title":"Lightning.Runs.start_run/2","doc":"","ref":"Lightning.Runs.html#start_run/2"},{"type":"function","title":"Lightning.Runs.start_step/2","doc":"Creates a Step for a given run and job.\n\nThe Step is created and marked as started at the current time.","ref":"Lightning.Runs.html#start_step/2"},{"type":"function","title":"Lightning.Runs.subscribe/1","doc":"","ref":"Lightning.Runs.html#subscribe/1"},{"type":"function","title":"Lightning.Runs.update_run/1","doc":"","ref":"Lightning.Runs.html#update_run/1"},{"type":"function","title":"Lightning.Runs.update_runs/2","doc":"","ref":"Lightning.Runs.html#update_runs/2"},{"type":"function","title":"Lightning.Runs.wipe_dataclips/1","doc":"Clears the body and request fields of the dataclip associated with the given run.","ref":"Lightning.Runs.html#wipe_dataclips/1"},{"type":"module","title":"Lightning.Runs.Events","doc":"","ref":"Lightning.Runs.Events.html"},{"type":"function","title":"Lightning.Runs.Events.dataclip_updated/2","doc":"","ref":"Lightning.Runs.Events.html#dataclip_updated/2"},{"type":"function","title":"Lightning.Runs.Events.log_appended/1","doc":"","ref":"Lightning.Runs.Events.html#log_appended/1"},{"type":"function","title":"Lightning.Runs.Events.run_updated/1","doc":"","ref":"Lightning.Runs.Events.html#run_updated/1"},{"type":"function","title":"Lightning.Runs.Events.step_completed/2","doc":"","ref":"Lightning.Runs.Events.html#step_completed/2"},{"type":"function","title":"Lightning.Runs.Events.step_started/2","doc":"","ref":"Lightning.Runs.Events.html#step_started/2"},{"type":"function","title":"Lightning.Runs.Events.subscribe/1","doc":"","ref":"Lightning.Runs.Events.html#subscribe/1"},{"type":"module","title":"Lightning.Runs.Handlers","doc":"Handler modules for working with runs.","ref":"Lightning.Runs.Handlers.html"},{"type":"module","title":"Lightning.Runs.Handlers.CompleteRun","doc":"Schema to validate the input attributes of a completed run.","ref":"Lightning.Runs.Handlers.CompleteRun.html"},{"type":"function","title":"Lightning.Runs.Handlers.CompleteRun.call/2","doc":"","ref":"Lightning.Runs.Handlers.CompleteRun.html#call/2"},{"type":"function","title":"Lightning.Runs.Handlers.CompleteRun.new/1","doc":"","ref":"Lightning.Runs.Handlers.CompleteRun.html#new/1"},{"type":"module","title":"Lightning.Runs.Handlers.CompleteStep","doc":"Schema to validate the input attributes of a completed step.","ref":"Lightning.Runs.Handlers.CompleteStep.html"},{"type":"function","title":"Lightning.Runs.Handlers.CompleteStep.call/2","doc":"","ref":"Lightning.Runs.Handlers.CompleteStep.html#call/2"},{"type":"function","title":"Lightning.Runs.Handlers.CompleteStep.new/2","doc":"","ref":"Lightning.Runs.Handlers.CompleteStep.html#new/2"},{"type":"module","title":"Lightning.Runs.Handlers.StartRun","doc":"Schema to validate the input attributes of a started run.","ref":"Lightning.Runs.Handlers.StartRun.html"},{"type":"function","title":"Lightning.Runs.Handlers.StartRun.call/2","doc":"","ref":"Lightning.Runs.Handlers.StartRun.html#call/2"},{"type":"function","title":"Lightning.Runs.Handlers.StartRun.new/1","doc":"","ref":"Lightning.Runs.Handlers.StartRun.html#new/1"},{"type":"module","title":"Lightning.Runs.Handlers.StartStep","doc":"Schema to validate the input attributes of a started step.","ref":"Lightning.Runs.Handlers.StartStep.html"},{"type":"function","title":"Lightning.Runs.Handlers.StartStep.call/2","doc":"","ref":"Lightning.Runs.Handlers.StartStep.html#call/2"},{"type":"module","title":"Lightning.Runs.PromExPlugin","doc":"Metrics callbacks implementation for the PromEx plugin.\n\nEvent metrics are used to publish the dispatched events in the system.\nPolling metrics are used to publish metrics that are calculated by polling data periodically.","ref":"Lightning.Runs.PromExPlugin.html"},{"type":"function","title":"Lightning.Runs.PromExPlugin.calculate_average_claim_duration/2","doc":"","ref":"Lightning.Runs.PromExPlugin.html#calculate_average_claim_duration/2"},{"type":"function","title":"Lightning.Runs.PromExPlugin.count_finalised_runs/1","doc":"","ref":"Lightning.Runs.PromExPlugin.html#count_finalised_runs/1"},{"type":"function","title":"Lightning.Runs.PromExPlugin.run_queue_metrics/2","doc":"","ref":"Lightning.Runs.PromExPlugin.html#run_queue_metrics/2"},{"type":"function","title":"Lightning.Runs.PromExPlugin.stalled_run_count/1","doc":"","ref":"Lightning.Runs.PromExPlugin.html#stalled_run_count/1"},{"type":"module","title":"Lightning.Runs.Query","doc":"Query functions for working with Runs","ref":"Lightning.Runs.Query.html"},{"type":"function","title":"Lightning.Runs.Query.eligible_for_claim/0","doc":"Query to return runs that are eligible for claiming.\n\nUses `in_progress_window/0` and filters for runs that are either in the\navailable state and have not reached the concurrency limit for their workflow.\n\n>","ref":"Lightning.Runs.Query.html#eligible_for_claim/0"},{"type":"function","title":"Note {: .info} - Lightning.Runs.Query.eligible_for_claim/0","doc":"> This query does not currently take into account the priority of the run.\n> To allow for prioritization, the query should be updated to order by\n> priority.\n>\n> ```elixir\n> eligible_for_claim() |> prepend_order_by([:priority])\n> ```","ref":"Lightning.Runs.Query.html#eligible_for_claim/0-note-info"},{"type":"function","title":"Lightning.Runs.Query.in_progress_window/0","doc":"Query to return a list of runs that are either in progress (started or claimed)\nor available.\n\nThe select clause includes:\n- `id`, the id of the run\n- `state`, the state of the run\n- `row_number`, the number of the row in the window, per workflow\n- `limit`, the maximum number of runs that can be claimed for the workflow","ref":"Lightning.Runs.Query.html#in_progress_window/0"},{"type":"function","title":"Lightning.Runs.Query.lost/0","doc":"Return all runs that have been claimed by a worker before the earliest\nacceptable start time (determined by the run options and grace period) but are\nstill incomplete.\n\nThis indicates that we may have lost contact with the worker\nthat was responsible for executing the run.","ref":"Lightning.Runs.Query.html#lost/0"},{"type":"function","title":"Lightning.Runs.Query.lost_steps/0","doc":"","ref":"Lightning.Runs.Query.html#lost_steps/0"},{"type":"module","title":"Lightning.Runs.Queue","doc":"Allows adding, removing or claiming work to be executed by the Runtime.","ref":"Lightning.Runs.Queue.html"},{"type":"function","title":"Lightning.Runs.Queue.claim/2","doc":"","ref":"Lightning.Runs.Queue.html#claim/2"},{"type":"module","title":"Lightning.Runs.RunOptions","doc":"Options that are passed to the worker to control configurable limits and\nbehaviors during run execution and reporting.","ref":"Lightning.Runs.RunOptions.html"},{"type":"function","title":"Lightning.Runs.RunOptions.new/1","doc":"","ref":"Lightning.Runs.RunOptions.html#new/1"},{"type":"type","title":"Lightning.Runs.RunOptions.keyword_list/0","doc":"","ref":"Lightning.Runs.RunOptions.html#t:keyword_list/0"},{"type":"type","title":"Lightning.Runs.RunOptions.t/0","doc":"","ref":"Lightning.Runs.RunOptions.html#t:t/0"},{"type":"module","title":"Lightning.WorkOrders","doc":"Context for creating WorkOrders.","ref":"Lightning.WorkOrders.html"},{"type":"module","title":"Work Orders - Lightning.WorkOrders","doc":"Work Orders represent the entrypoint for a unit of work in Lightning.\nThey allow you to track the status of a webhook or cron trigger.\n\nFor example if a user makes a request to a webhook endpoint, a Work Order\nis created with it's associated Workflow and Dataclip.\n\nEvery Work Order has at least one Run, which represents a single\ninvocation of the Workflow. If the workflow fails, and the run is retried,\na new Run is created on the Work Order.\n\nThis allows you group all the runs for a single webhook, and track\nthe success or failure of a given dataclip.","ref":"Lightning.WorkOrders.html#module-work-orders"},{"type":"module","title":"Creating Work Orders - Lightning.WorkOrders","doc":"Work Orders can be created in three ways:\n\n1. Via a webhook trigger\n2. Via a cron trigger\n3. Manually by a user (via the UI or API)\n\nRetries do not create new Work Orders, but rather new Runs on the existing\nWork Order.","ref":"Lightning.WorkOrders.html#module-creating-work-orders"},{"type":"function","title":"Lightning.WorkOrders.build/1","doc":"","ref":"Lightning.WorkOrders.html#build/1"},{"type":"function","title":"Lightning.WorkOrders.build_for/2","doc":"","ref":"Lightning.WorkOrders.html#build_for/2"},{"type":"function","title":"Lightning.WorkOrders.create_for/1","doc":"","ref":"Lightning.WorkOrders.html#create_for/1"},{"type":"function","title":"Lightning.WorkOrders.create_for/3","doc":"Create a new Work Order.\n\n**For a webhook**\n create_for(trigger, workflow: workflow, dataclip: dataclip)\n\n**For a user**\n create_for(job, workflow: workflow, dataclip: dataclip, user: user)","ref":"Lightning.WorkOrders.html#create_for/3"},{"type":"function","title":"Lightning.WorkOrders.enqueue_many_for_retry/2","doc":"Enqueue multiple runs for retry in the same transaction.","ref":"Lightning.WorkOrders.html#enqueue_many_for_retry/2"},{"type":"function","title":"Lightning.WorkOrders.get/2","doc":"Get a Work Order by id.\n\nOptionally preload associations by passing a list of atoms to `:include`.\n\n Lightning.WorkOrders.get(id, include: [:runs])","ref":"Lightning.WorkOrders.html#get/2"},{"type":"function","title":"Lightning.WorkOrders.retry/3","doc":"Retry a run from a given step.\n\nThis will create a new Run on the Work Order, and enqueue it for\nprocessing.\n\nWhen creating a new Run, a graph of the workflow is created steps that are\nindependent from the selected step and its downstream flow are associated with\nthis new run, but not executed again.","ref":"Lightning.WorkOrders.html#retry/3"},{"type":"function","title":"Lightning.WorkOrders.retry_many/2","doc":"","ref":"Lightning.WorkOrders.html#retry_many/2"},{"type":"function","title":"Lightning.WorkOrders.retry_many/3","doc":"","ref":"Lightning.WorkOrders.html#retry_many/3"},{"type":"function","title":"Lightning.WorkOrders.subscribe/1","doc":"","ref":"Lightning.WorkOrders.html#subscribe/1"},{"type":"function","title":"Lightning.WorkOrders.update_state/1","doc":"Updates the state of a WorkOrder based on the state of a run.\n\nThis considers the state of all runs on the WorkOrder, with the\nRun passed in as the latest run.\n\nSee `Lightning.WorkOrders.Query.state_for/1` for more details.","ref":"Lightning.WorkOrders.html#update_state/1"},{"type":"type","title":"Lightning.WorkOrders.work_order_option/0","doc":"","ref":"Lightning.WorkOrders.html#t:work_order_option/0"},{"type":"module","title":"Lightning.WorkOrders.ExportAudit","doc":"Module to log history export actions as audit events.","ref":"Lightning.WorkOrders.ExportAudit.html"},{"type":"function","title":"Lightning.WorkOrders.ExportAudit.base_query/0","doc":"","ref":"Lightning.WorkOrders.ExportAudit.html#base_query/0"},{"type":"function","title":"Lightning.WorkOrders.ExportAudit.event/5","doc":"","ref":"Lightning.WorkOrders.ExportAudit.html#event/5"},{"type":"function","title":"Lightning.WorkOrders.ExportAudit.save/1","doc":"","ref":"Lightning.WorkOrders.ExportAudit.html#save/1"},{"type":"function","title":"Lightning.WorkOrders.ExportAudit.update_changes/1","doc":"","ref":"Lightning.WorkOrders.ExportAudit.html#update_changes/1"},{"type":"module","title":"Lightning.WorkOrders.ExportWorker","doc":"This module handles the export of work orders for a given project. The export process is performed asynchronously using the Oban background job system.","ref":"Lightning.WorkOrders.ExportWorker.html"},{"type":"module","title":"Responsibilities - Lightning.WorkOrders.ExportWorker","doc":"- **Enqueueing Export Jobs**: The `enqueue_export/2` function creates and enqueues an Oban job for exporting work orders based on the given project and search parameters.\n - **Processing Exports**: The `perform/1` function is the main entry point for executing the export job. It retrieves the project, processes work orders, and handles the export process.\n - **Export Logic**: The export logic involves querying work orders, extracting relevant entities, processing logs and dataclips asynchronously, and writing the final export data to files.\n - **Error Handling**: The module includes comprehensive error handling and logging to ensure that issues during the export process are recorded and can be diagnosed.\n - **Zip File Creation**: After processing, the exported files are compressed into a zip file for easy download or further use.","ref":"Lightning.WorkOrders.ExportWorker.html#module-responsibilities"},{"type":"module","title":"Usage - Lightning.WorkOrders.ExportWorker","doc":"- To enqueue an export job, call `enqueue_export/2` with the project and search parameters.\n - The export process is triggered by Oban and runs in the `history_exports` queue, limited to a single attempt per job.","ref":"Lightning.WorkOrders.ExportWorker.html#module-usage"},{"type":"module","title":"Example - Lightning.WorkOrders.ExportWorker","doc":"```elixir\n # Enqueue an export job\n Lightning.WorkOrders.ExportWorker.enqueue_export(project, search_params)\n\n # The job will run in the background and log the status of the export process.\n ```\n\n This module is designed to handle potentially large datasets efficiently by using streaming, async processing, and error recovery mechanisms.","ref":"Lightning.WorkOrders.ExportWorker.html#module-example"},{"type":"function","title":"Lightning.WorkOrders.ExportWorker.enqueue_export/3","doc":"","ref":"Lightning.WorkOrders.ExportWorker.html#enqueue_export/3"},{"type":"function","title":"Lightning.WorkOrders.ExportWorker.extract_entities/1","doc":"","ref":"Lightning.WorkOrders.ExportWorker.html#extract_entities/1"},{"type":"function","title":"Lightning.WorkOrders.ExportWorker.fetch_dataclips/1","doc":"","ref":"Lightning.WorkOrders.ExportWorker.html#fetch_dataclips/1"},{"type":"module","title":"Lightning.WorkOrders.Manual","doc":"A model is used to build WorkOrders with custom input data.","ref":"Lightning.WorkOrders.Manual.html"},{"type":"function","title":"Lightning.WorkOrders.Manual.new/2","doc":"","ref":"Lightning.WorkOrders.Manual.html#new/2"},{"type":"type","title":"Lightning.WorkOrders.Manual.t/0","doc":"","ref":"Lightning.WorkOrders.Manual.html#t:t/0"},{"type":"module","title":"Lightning.WorkOrders.Query","doc":"Query functions for the Lightning.WorkOrders module.","ref":"Lightning.WorkOrders.Query.html"},{"type":"function","title":"Lightning.WorkOrders.Query.state_for/1","doc":"Query to calculate the current state of a workorder.\n\nIt takes a run, as the state is updated after each run is changed.\n\nThe logic is as follows:\n\n- All _other_ Runs that are not in a finished state are considered first.\n- The current Run is unioned onto the unfinished runs with a null\n ordinality.\n- The runs are ordered by state in the following order\n `started > available > claimed > null`\n- The run states are then mapped to the workorder state enum, so `available`\n and `claimed` are both mapped to `pending` and `started` is mapped to `running`\n\n> The `null` ordinality ensures that the current run is always last in the\n> ordering.","ref":"Lightning.WorkOrders.Query.html#state_for/1"},{"type":"module","title":"Lightning.WorkOrders.RetryManyWorkOrdersJob","doc":"Enqueue multiple work orders for retry.","ref":"Lightning.WorkOrders.RetryManyWorkOrdersJob.html"},{"type":"module","title":"Lightning.WorkOrders.SearchParams","doc":"This module is used to parse search parameters for work orders and provide\na query to the database.","ref":"Lightning.WorkOrders.SearchParams.html"},{"type":"function","title":"Lightning.WorkOrders.SearchParams.all_statuses_set?/1","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#all_statuses_set?/1"},{"type":"function","title":"Lightning.WorkOrders.SearchParams.from_map/1","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#from_map/1"},{"type":"function","title":"Lightning.WorkOrders.SearchParams.new/1","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#new/1"},{"type":"macro","title":"Lightning.WorkOrders.SearchParams.status_list/0","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#status_list/0"},{"type":"function","title":"Lightning.WorkOrders.SearchParams.to_uri_params/1","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#to_uri_params/1"},{"type":"type","title":"Lightning.WorkOrders.SearchParams.t/0","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#t:t/0"},{"type":"module","title":"Lightning.Credentials","doc":"The Credentials context.","ref":"Lightning.Credentials.html"},{"type":"function","title":"Lightning.Credentials.basic_auth_for/1","doc":"","ref":"Lightning.Credentials.html#basic_auth_for/1"},{"type":"function","title":"Lightning.Credentials.cancel_scheduled_deletion/1","doc":"","ref":"Lightning.Credentials.html#cancel_scheduled_deletion/1"},{"type":"function","title":"Lightning.Credentials.change_credential/2","doc":"Returns an `%Ecto.Changeset{}` for tracking credential changes.","ref":"Lightning.Credentials.html#change_credential/2"},{"type":"function","title":"Examples - Lightning.Credentials.change_credential/2","doc":"iex> change_credential(credential)\n %Ecto.Changeset{data: %Credential{}}","ref":"Lightning.Credentials.html#change_credential/2-examples"},{"type":"function","title":"Lightning.Credentials.create_credential/1","doc":"Creates a credential.","ref":"Lightning.Credentials.html#create_credential/1"},{"type":"function","title":"Examples - Lightning.Credentials.create_credential/1","doc":"iex> create_credential(%{field: value})\n {:ok, %Credential{}}\n\n iex> create_credential(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Credentials.html#create_credential/1-examples"},{"type":"function","title":"Lightning.Credentials.delete_credential/1","doc":"Deletes a credential.","ref":"Lightning.Credentials.html#delete_credential/1"},{"type":"function","title":"Examples - Lightning.Credentials.delete_credential/1","doc":"iex> delete_credential(credential)\n {:ok, %Credential{}}\n\n iex> delete_credential(credential)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Credentials.html#delete_credential/1-examples"},{"type":"function","title":"Lightning.Credentials.get_credential!/1","doc":"Gets a single credential.\n\nRaises `Ecto.NoResultsError` if the Credential does not exist.","ref":"Lightning.Credentials.html#get_credential!/1"},{"type":"function","title":"Examples - Lightning.Credentials.get_credential!/1","doc":"iex> get_credential!(123)\n %Credential{}\n\n iex> get_credential!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Credentials.html#get_credential!/1-examples"},{"type":"function","title":"Lightning.Credentials.get_credential_by_project_credential/1","doc":"","ref":"Lightning.Credentials.html#get_credential_by_project_credential/1"},{"type":"function","title":"Lightning.Credentials.get_credential_for_update!/1","doc":"","ref":"Lightning.Credentials.html#get_credential_for_update!/1"},{"type":"function","title":"Lightning.Credentials.get_schema/1","doc":"Creates a credential schema from credential json schema.","ref":"Lightning.Credentials.html#get_schema/1"},{"type":"function","title":"Lightning.Credentials.has_activity_in_projects?/1","doc":"Checks if a given `Credential` has any associated `Step` activity.","ref":"Lightning.Credentials.html#has_activity_in_projects?/1"},{"type":"function","title":"Parameters - Lightning.Credentials.has_activity_in_projects?/1","doc":"- `_credential`: A `Credential` struct. Only the `id` field is used by the function.","ref":"Lightning.Credentials.html#has_activity_in_projects?/1-parameters"},{"type":"function","title":"Returns - Lightning.Credentials.has_activity_in_projects?/1","doc":"- `true` if there's at least one `Step` associated with the given `Credential`.\n - `false` otherwise.","ref":"Lightning.Credentials.html#has_activity_in_projects?/1-returns"},{"type":"function","title":"Examples - Lightning.Credentials.has_activity_in_projects?/1","doc":"iex> has_activity_in_projects?(%Credential{id: some_id})\n true\n\n iex> has_activity_in_projects?(%Credential{id: another_id})\n false","ref":"Lightning.Credentials.html#has_activity_in_projects?/1-examples"},{"type":"function","title":"Notes - Lightning.Credentials.has_activity_in_projects?/1","doc":"This function leverages the association between `Step` and `Credential` to\ndetermine if any steps exist for a given credential. It's a fast check that\ndoes not load any records into memory, but simply checks for their existence.","ref":"Lightning.Credentials.html#has_activity_in_projects?/1-notes"},{"type":"function","title":"Lightning.Credentials.invalid_projects_for_user/2","doc":"Given a credential and a user, returns a list of invalid projects—i.e., those\nthat the credential is shared with but that the user does not have access to.\n\nThis is used to generate a validation error when a credential cannot be\ntransferred.","ref":"Lightning.Credentials.html#invalid_projects_for_user/2"},{"type":"function","title":"Examples - Lightning.Credentials.invalid_projects_for_user/2","doc":"iex> can_credential_be_shared_to_user(credential_id, user_id)\n []\n\n iex> can_credential_be_shared_to_user(credential_id, user_id)\n [\"52ea8758-6ce5-43d7-912f-6a1e1f11dc55\"]","ref":"Lightning.Credentials.html#invalid_projects_for_user/2-examples"},{"type":"function","title":"Lightning.Credentials.list_credentials/1","doc":"Retrieves all credentials based on the given context, either a Project or a User.","ref":"Lightning.Credentials.html#list_credentials/1"},{"type":"function","title":"Parameters - Lightning.Credentials.list_credentials/1","doc":"- context: The Project or User struct to retrieve credentials for.","ref":"Lightning.Credentials.html#list_credentials/1-parameters"},{"type":"function","title":"Returns - Lightning.Credentials.list_credentials/1","doc":"- A list of credentials associated with the given Project or created by the given User.","ref":"Lightning.Credentials.html#list_credentials/1-returns"},{"type":"function","title":"Examples - Lightning.Credentials.list_credentials/1","doc":"When given a Project:\n iex> list_credentials(%Project{id: 1})\n [%Credential{project_id: 1}, %Credential{project_id: 1}]\n\n When given a User:\n iex> list_credentials(%User{id: 123})\n [%Credential{user_id: 123}, %Credential{user_id: 123}]","ref":"Lightning.Credentials.html#list_credentials/1-examples"},{"type":"function","title":"Lightning.Credentials.lookup_adapter/1","doc":"","ref":"Lightning.Credentials.html#lookup_adapter/1"},{"type":"function","title":"Lightning.Credentials.maybe_refresh_token/1","doc":"","ref":"Lightning.Credentials.html#maybe_refresh_token/1"},{"type":"function","title":"Lightning.Credentials.perform/1","doc":"Perform, when called with %{\"type\" => \"purge_deleted\"}\nwill find credentials that are ready for permanent deletion, set their bodies\nto null, and try to purge them.","ref":"Lightning.Credentials.html#perform/1"},{"type":"function","title":"Lightning.Credentials.schedule_credential_deletion/1","doc":"Schedules a given credential for deletion.\n\nThe deletion date is determined based on the `:purge_deleted_after_days` configuration\nin the application environment. If this configuration is absent, the credential is scheduled\nfor immediate deletion.\n\nThe function will also perform necessary side effects such as:\n - Removing associations of the credential.\n - Notifying the owner of the credential about the scheduled deletion.","ref":"Lightning.Credentials.html#schedule_credential_deletion/1"},{"type":"function","title":"Parameters - Lightning.Credentials.schedule_credential_deletion/1","doc":"- `credential`: A `Credential` struct that is to be scheduled for deletion.","ref":"Lightning.Credentials.html#schedule_credential_deletion/1-parameters"},{"type":"function","title":"Returns - Lightning.Credentials.schedule_credential_deletion/1","doc":"- `{:ok, credential}`: Returns an `:ok` tuple with the updated credential struct if the\n update was successful.\n - `{:error, changeset}`: Returns an `:error` tuple with the changeset if the update failed.","ref":"Lightning.Credentials.html#schedule_credential_deletion/1-returns"},{"type":"function","title":"Examples - Lightning.Credentials.schedule_credential_deletion/1","doc":"iex> schedule_credential_deletion(%Credential{id: some_id})\n {:ok, %Credential{}}\n\n iex> schedule_credential_deletion(%Credential{})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Credentials.html#schedule_credential_deletion/1-examples"},{"type":"function","title":"Lightning.Credentials.sensitive_values_for/1","doc":"","ref":"Lightning.Credentials.html#sensitive_values_for/1"},{"type":"function","title":"Lightning.Credentials.update_credential/2","doc":"Updates a credential.","ref":"Lightning.Credentials.html#update_credential/2"},{"type":"function","title":"Examples - Lightning.Credentials.update_credential/2","doc":"iex> update_credential(credential, %{field: new_value})\n {:ok, %Credential{}}\n\n iex> update_credential(credential, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Credentials.html#update_credential/2-examples"},{"type":"module","title":"Lightning.Credentials.Audit","doc":"Model for storing changes to Credentials","ref":"Lightning.Credentials.Audit.html"},{"type":"function","title":"Lightning.Credentials.Audit.base_query/0","doc":"","ref":"Lightning.Credentials.Audit.html#base_query/0"},{"type":"function","title":"Lightning.Credentials.Audit.event/5","doc":"","ref":"Lightning.Credentials.Audit.html#event/5"},{"type":"function","title":"Lightning.Credentials.Audit.save/1","doc":"","ref":"Lightning.Credentials.Audit.html#save/1"},{"type":"function","title":"Lightning.Credentials.Audit.update_changes/1","doc":"","ref":"Lightning.Credentials.Audit.html#update_changes/1"},{"type":"module","title":"Lightning.Credentials.Credential","doc":"The Credential model.","ref":"Lightning.Credentials.Credential.html"},{"type":"type","title":"Lightning.Credentials.Credential.t/0","doc":"","ref":"Lightning.Credentials.Credential.html#t:t/0"},{"type":"module","title":"Lightning.Credentials.OauthClient","doc":"Defines the Ecto schema for an OAuth client. This schema is responsible for representing\nOAuth client data in the database, including details such as client ID, client secret,\nand endpoints necessary for OAuth operations. It also links to associated users and\nprojects through relational fields.","ref":"Lightning.Credentials.OauthClient.html"},{"type":"function","title":"Lightning.Credentials.OauthClient.changeset/2","doc":"Builds a changeset for an OAuth client based on the provided attributes.","ref":"Lightning.Credentials.OauthClient.html#changeset/2"},{"type":"function","title":"Parameters - Lightning.Credentials.OauthClient.changeset/2","doc":"- oauth_client: The existing `%OauthClient{}` struct (or a new struct for creation).\n- attrs: A map of attributes to set on the OAuth client.","ref":"Lightning.Credentials.OauthClient.html#changeset/2-parameters"},{"type":"function","title":"Returns - Lightning.Credentials.OauthClient.changeset/2","doc":"- An `%Ecto.Changeset{}` that can be used to create or update an OAuth client.\n\nThis function validates the presence of essential fields, ensures that URLs are valid,\nand handles associations with projects through nested changesets.","ref":"Lightning.Credentials.OauthClient.html#changeset/2-returns"},{"type":"type","title":"Lightning.Credentials.OauthClient.t/0","doc":"","ref":"Lightning.Credentials.OauthClient.html#t:t/0"},{"type":"module","title":"Lightning.Credentials.OauthClientAudit","doc":"Model for storing changes to Oauth clients","ref":"Lightning.Credentials.OauthClientAudit.html"},{"type":"function","title":"Lightning.Credentials.OauthClientAudit.base_query/0","doc":"","ref":"Lightning.Credentials.OauthClientAudit.html#base_query/0"},{"type":"function","title":"Lightning.Credentials.OauthClientAudit.event/5","doc":"","ref":"Lightning.Credentials.OauthClientAudit.html#event/5"},{"type":"function","title":"Lightning.Credentials.OauthClientAudit.save/1","doc":"","ref":"Lightning.Credentials.OauthClientAudit.html#save/1"},{"type":"function","title":"Lightning.Credentials.OauthClientAudit.update_changes/1","doc":"","ref":"Lightning.Credentials.OauthClientAudit.html#update_changes/1"},{"type":"module","title":"Lightning.Credentials.Schema","doc":"Structure that can parse JsonSchemas (using `ExJsonSchema`) and validate\nchangesets for a given schema.","ref":"Lightning.Credentials.Schema.html"},{"type":"function","title":"Lightning.Credentials.Schema.new/2","doc":"","ref":"Lightning.Credentials.Schema.html#new/2"},{"type":"function","title":"Lightning.Credentials.Schema.properties/2","doc":"","ref":"Lightning.Credentials.Schema.html#properties/2"},{"type":"function","title":"Lightning.Credentials.Schema.required?/2","doc":"","ref":"Lightning.Credentials.Schema.html#required?/2"},{"type":"function","title":"Lightning.Credentials.Schema.validate/2","doc":"","ref":"Lightning.Credentials.Schema.html#validate/2"},{"type":"type","title":"Lightning.Credentials.Schema.t/0","doc":"","ref":"Lightning.Credentials.Schema.html#t:t/0"},{"type":"module","title":"Lightning.Credentials.SchemaDocument","doc":"Provides facilities to dynamically create and validate a changeset for a given\n[Schema](`Lightning.Credentials.Schema`)","ref":"Lightning.Credentials.SchemaDocument.html"},{"type":"function","title":"Lightning.Credentials.SchemaDocument.changeset/3","doc":"","ref":"Lightning.Credentials.SchemaDocument.html#changeset/3"},{"type":"module","title":"Lightning.Credentials.SensitiveValues","doc":"Functions to pull out sensitive values inside a credential.\n\nThese values are used to scrub logs for leaked secrets.","ref":"Lightning.Credentials.SensitiveValues.html"},{"type":"function","title":"Lightning.Credentials.SensitiveValues.flatten_map/1","doc":"Keys that are _not_ considered sensitive","ref":"Lightning.Credentials.SensitiveValues.html#flatten_map/1"},{"type":"function","title":"Lightning.Credentials.SensitiveValues.secret_values/1","doc":"Given a map, find all values allowed (via `@safe_keys`) and return them as\na list.","ref":"Lightning.Credentials.SensitiveValues.html#secret_values/1"},{"type":"type","title":"Lightning.Credentials.SensitiveValues.pairs/0","doc":"","ref":"Lightning.Credentials.SensitiveValues.html#t:pairs/0"},{"type":"type","title":"Lightning.Credentials.SensitiveValues.raw_pairs/0","doc":"","ref":"Lightning.Credentials.SensitiveValues.html#t:raw_pairs/0"},{"type":"module","title":"Lightning.Invocation","doc":"The Invocation context.","ref":"Lightning.Invocation.html"},{"type":"function","title":"Lightning.Invocation.assemble_logs_for_step/1","doc":"Return all logs for a step as a string of text, separated by new line \n breaks","ref":"Lightning.Invocation.html#assemble_logs_for_step/1"},{"type":"function","title":"Lightning.Invocation.change_dataclip/2","doc":"Returns an `%Ecto.Changeset{}` for tracking dataclip changes.","ref":"Lightning.Invocation.html#change_dataclip/2"},{"type":"function","title":"Examples - Lightning.Invocation.change_dataclip/2","doc":"iex> change_dataclip(dataclip)\n %Ecto.Changeset{data: %Dataclip{}}","ref":"Lightning.Invocation.html#change_dataclip/2-examples"},{"type":"function","title":"Lightning.Invocation.change_step/2","doc":"Returns an `%Ecto.Changeset{}` for tracking step changes.","ref":"Lightning.Invocation.html#change_step/2"},{"type":"function","title":"Examples - Lightning.Invocation.change_step/2","doc":"iex> change_step(step)\n %Ecto.Changeset{data: %Step{}}","ref":"Lightning.Invocation.html#change_step/2-examples"},{"type":"function","title":"Lightning.Invocation.count_workorders/2","doc":"","ref":"Lightning.Invocation.html#count_workorders/2"},{"type":"function","title":"Lightning.Invocation.create_dataclip/1","doc":"Creates a dataclip.","ref":"Lightning.Invocation.html#create_dataclip/1"},{"type":"function","title":"Examples - Lightning.Invocation.create_dataclip/1","doc":"iex> create_dataclip(%{field: value})\n {:ok, %Dataclip{}}\n\n iex> create_dataclip(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Invocation.html#create_dataclip/1-examples"},{"type":"function","title":"Lightning.Invocation.delete_dataclip/1","doc":"Deletes a dataclip.","ref":"Lightning.Invocation.html#delete_dataclip/1"},{"type":"function","title":"Examples - Lightning.Invocation.delete_dataclip/1","doc":"iex> delete_dataclip(dataclip)\n {:ok, %Dataclip{}}\n\n iex> delete_dataclip(dataclip)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Invocation.html#delete_dataclip/1-examples"},{"type":"function","title":"Lightning.Invocation.export_workorders/3","doc":"Exports work orders by performing a series of database operations wrapped in a transaction.\n\nThis function creates an audit log, a project file record, and enqueues an export job using a transaction.\nEach step is executed as part of an `Ecto.Multi` operation, ensuring atomicity.","ref":"Lightning.Invocation.html#export_workorders/3"},{"type":"function","title":"Parameters - Lightning.Invocation.export_workorders/3","doc":"- `project` - The project for which work orders are being exported. Expected to be a map or struct with an `id` field.\n - `user` - The user initiating the export operation. Expected to be a map or struct with an `id` field.\n - `search_params` - A map of search parameters used to filter work orders to export.","ref":"Lightning.Invocation.html#export_workorders/3-parameters"},{"type":"function","title":"Returns - Lightning.Invocation.export_workorders/3","doc":"- `{:ok, %{audit: audit, project_file: project_file, export_job: job}}` on success:\n - `audit`: The audit log entry created for the export operation.\n - `project_file`: The project file record created for the export operation.\n - `export_job`: The result of the export job enqueuing step.\n\n - `{:error, step, reason, changes}` if any step in the transaction fails:\n - `step`: The step where the error occurred, e.g., `:audit`, `:project_file`, or `:export_job`.\n - `reason`: The reason for the failure, typically an error atom.\n - `changes`: A map of changes up to the point of failure.","ref":"Lightning.Invocation.html#export_workorders/3-returns"},{"type":"function","title":"Lightning.Invocation.get_dataclip/1","doc":"Gets a single dataclip given one of:\n\n- a Dataclip uuid\n- a Step model\n\nReturns `nil` if the Dataclip does not exist.","ref":"Lightning.Invocation.html#get_dataclip/1"},{"type":"function","title":"Examples - Lightning.Invocation.get_dataclip/1","doc":"iex> get_dataclip(\"27b73932-16c7-4a72-86a3-85d805ccff98\")\n %Dataclip{}\n\n iex> get_dataclip(\"27b73932-16c7-4a72-86a3-85d805ccff98\")\n nil\n\n iex> get_dataclip(%Step{id: \"a uuid\"})\n %Dataclip{}","ref":"Lightning.Invocation.html#get_dataclip/1-examples"},{"type":"function","title":"Lightning.Invocation.get_dataclip!/1","doc":"Gets a single dataclip.\n\nRaises `Ecto.NoResultsError` if the Dataclip does not exist.","ref":"Lightning.Invocation.html#get_dataclip!/1"},{"type":"function","title":"Examples - Lightning.Invocation.get_dataclip!/1","doc":"iex> get_dataclip!(123)\n %Dataclip{}\n\n iex> get_dataclip!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Invocation.html#get_dataclip!/1-examples"},{"type":"function","title":"Lightning.Invocation.get_dataclip_details!/1","doc":"","ref":"Lightning.Invocation.html#get_dataclip_details!/1"},{"type":"function","title":"Lightning.Invocation.get_dataclip_for_run/1","doc":"","ref":"Lightning.Invocation.html#get_dataclip_for_run/1"},{"type":"function","title":"Lightning.Invocation.get_dataclip_query/1","doc":"Query for retrieving the dataclip that was step's starting dataclip.","ref":"Lightning.Invocation.html#get_dataclip_query/1"},{"type":"function","title":"Lightning.Invocation.get_first_dataclip_for_run_and_job/2","doc":"","ref":"Lightning.Invocation.html#get_first_dataclip_for_run_and_job/2"},{"type":"function","title":"Lightning.Invocation.get_first_step_for_run_and_job/2","doc":"","ref":"Lightning.Invocation.html#get_first_step_for_run_and_job/2"},{"type":"function","title":"Lightning.Invocation.get_output_dataclip_query/1","doc":"Query for retrieving the dataclip that was the result of a successful step.","ref":"Lightning.Invocation.html#get_output_dataclip_query/1"},{"type":"function","title":"Lightning.Invocation.get_step!/1","doc":"Gets a single step.\n\nRaises `Ecto.NoResultsError` if the Step does not exist.","ref":"Lightning.Invocation.html#get_step!/1"},{"type":"function","title":"Examples - Lightning.Invocation.get_step!/1","doc":"iex> get_step!(123)\n %Step{}\n\n iex> get_step!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Invocation.html#get_step!/1-examples"},{"type":"function","title":"Lightning.Invocation.get_step_count_for_run/1","doc":"","ref":"Lightning.Invocation.html#get_step_count_for_run/1"},{"type":"function","title":"Lightning.Invocation.get_step_with_job!/1","doc":"Fetches a step and preloads the job via the step's event.","ref":"Lightning.Invocation.html#get_step_with_job!/1"},{"type":"function","title":"Lightning.Invocation.get_workorders_by_ids/1","doc":"","ref":"Lightning.Invocation.html#get_workorders_by_ids/1"},{"type":"function","title":"Lightning.Invocation.get_workorders_count_limit/0","doc":"","ref":"Lightning.Invocation.html#get_workorders_count_limit/0"},{"type":"function","title":"Lightning.Invocation.list_dataclips/0","doc":"Returns the list of dataclips.","ref":"Lightning.Invocation.html#list_dataclips/0"},{"type":"function","title":"Examples - Lightning.Invocation.list_dataclips/0","doc":"iex> list_dataclips()\n [%Dataclip{}, ...]","ref":"Lightning.Invocation.html#list_dataclips/0-examples"},{"type":"function","title":"Lightning.Invocation.list_dataclips/1","doc":"","ref":"Lightning.Invocation.html#list_dataclips/1"},{"type":"function","title":"Lightning.Invocation.list_dataclips_for_job/1","doc":"","ref":"Lightning.Invocation.html#list_dataclips_for_job/1"},{"type":"function","title":"Lightning.Invocation.list_dataclips_query/1","doc":"","ref":"Lightning.Invocation.html#list_dataclips_query/1"},{"type":"function","title":"Lightning.Invocation.list_steps/0","doc":"Returns the list of steps.","ref":"Lightning.Invocation.html#list_steps/0"},{"type":"function","title":"Examples - Lightning.Invocation.list_steps/0","doc":"iex> list_steps()\n [%Step{}, ...]","ref":"Lightning.Invocation.html#list_steps/0-examples"},{"type":"function","title":"Lightning.Invocation.list_steps_for_project/2","doc":"","ref":"Lightning.Invocation.html#list_steps_for_project/2"},{"type":"function","title":"Lightning.Invocation.list_steps_for_project_query/1","doc":"","ref":"Lightning.Invocation.html#list_steps_for_project_query/1"},{"type":"function","title":"Lightning.Invocation.logs_for_step/1","doc":"Return all logs for a step as a list","ref":"Lightning.Invocation.html#logs_for_step/1"},{"type":"function","title":"Lightning.Invocation.search_workorders/1","doc":"Searches for work orders based on project and search parameters.","ref":"Lightning.Invocation.html#search_workorders/1"},{"type":"function","title":"Parameters: - Lightning.Invocation.search_workorders/1","doc":"- `project`: The project to filter the work orders by.\n- `search_params`: The parameters to guide the search.","ref":"Lightning.Invocation.html#search_workorders/1-parameters"},{"type":"function","title":"Returns: - Lightning.Invocation.search_workorders/1","doc":"A paginated list of work orders that match the criteria.","ref":"Lightning.Invocation.html#search_workorders/1-returns"},{"type":"function","title":"Example: - Lightning.Invocation.search_workorders/1","doc":"search_workorders(%Project{id: 1}, %SearchParams{status: [\"completed\"]})","ref":"Lightning.Invocation.html#search_workorders/1-example"},{"type":"function","title":"Lightning.Invocation.search_workorders/3","doc":"","ref":"Lightning.Invocation.html#search_workorders/3"},{"type":"function","title":"Lightning.Invocation.search_workorders_for_export_query/2","doc":"","ref":"Lightning.Invocation.html#search_workorders_for_export_query/2"},{"type":"function","title":"Lightning.Invocation.search_workorders_for_retry/2","doc":"","ref":"Lightning.Invocation.html#search_workorders_for_retry/2"},{"type":"function","title":"Lightning.Invocation.update_dataclip/2","doc":"Updates a dataclip.","ref":"Lightning.Invocation.html#update_dataclip/2"},{"type":"function","title":"Examples - Lightning.Invocation.update_dataclip/2","doc":"iex> update_dataclip(dataclip, %{field: new_value})\n {:ok, %Dataclip{}}\n\n iex> update_dataclip(dataclip, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Invocation.html#update_dataclip/2-examples"},{"type":"function","title":"Lightning.Invocation.with_runs/1","doc":"","ref":"Lightning.Invocation.html#with_runs/1"},{"type":"module","title":"Lightning.Invocation.Dataclip","doc":"Ecto model for Dataclips.\n\nDataclips represent some data that arrived in the system, and records both\nthe data and the source of the data.","ref":"Lightning.Invocation.Dataclip.html"},{"type":"module","title":"Types - Lightning.Invocation.Dataclip","doc":"* `:http_request`\n The data arrived via a webhook.\n* `:global`\n Was created manually, and is intended to be used multiple times.\n When repetitive static data is needed to be maintained, instead of hard-coding\n into a Job - a more convenient solution is to create a `:global` Dataclip\n and access it inside the Job.\n* `:step_result`\n The final state of a step.\n* `:saved_input`\n An arbitrary input, created by a user. (Only configuration will be overwritten.)","ref":"Lightning.Invocation.Dataclip.html#module-types"},{"type":"function","title":"Lightning.Invocation.Dataclip.new/1","doc":"","ref":"Lightning.Invocation.Dataclip.html#new/1"},{"type":"function","title":"Lightning.Invocation.Dataclip.source_types/0","doc":"","ref":"Lightning.Invocation.Dataclip.html#source_types/0"},{"type":"function","title":"Lightning.Invocation.Dataclip.validate_by_type/1","doc":"Append validations based on the type of the Dataclip.\n\n- `:step_result` must have an associated Step model.","ref":"Lightning.Invocation.Dataclip.html#validate_by_type/1"},{"type":"type","title":"Lightning.Invocation.Dataclip.source_type/0","doc":"","ref":"Lightning.Invocation.Dataclip.html#t:source_type/0"},{"type":"type","title":"Lightning.Invocation.Dataclip.t/0","doc":"","ref":"Lightning.Invocation.Dataclip.html#t:t/0"},{"type":"module","title":"Lightning.Invocation.LogLine","doc":"Ecto model for run logs.\n\nEvery log line from a worker is stored using this model.\n\nCurrently the `:message` field is a text field, however the worker sends\nmessages in a JSON format. We will at some point consider changing this to\na JSON field; but for now we coerce it into a string.\n\nSee [`LogMessage`](`Lightning.LogMessage`) for more information.","ref":"Lightning.Invocation.LogLine.html"},{"type":"function","title":"Lightning.Invocation.LogLine.new/3","doc":"","ref":"Lightning.Invocation.LogLine.html#new/3"},{"type":"function","title":"Lightning.Invocation.LogLine.validate/2","doc":"","ref":"Lightning.Invocation.LogLine.html#validate/2"},{"type":"type","title":"Lightning.Invocation.LogLine.t/0","doc":"","ref":"Lightning.Invocation.LogLine.html#t:t/0"},{"type":"module","title":"Lightning.Invocation.Query","doc":"Query functions for working with Steps and Dataclips","ref":"Lightning.Invocation.Query.html"},{"type":"function","title":"Lightning.Invocation.Query.any_step/0","doc":"To be used in preloads for `workflow > job > step` when the presence of any\nstep is all the information we need. As in, \"Does this job have any steps?\"","ref":"Lightning.Invocation.Query.html#any_step/0"},{"type":"function","title":"Lightning.Invocation.Query.dataclip_with_body/0","doc":"By default, the dataclip body is not returned via a query. This query selects\nthe body specifically.","ref":"Lightning.Invocation.Query.html#dataclip_with_body/0"},{"type":"function","title":"Lightning.Invocation.Query.last_n_for_job/2","doc":"","ref":"Lightning.Invocation.Query.html#last_n_for_job/2"},{"type":"function","title":"Lightning.Invocation.Query.last_step_for_job/1","doc":"The last step for a job","ref":"Lightning.Invocation.Query.html#last_step_for_job/1"},{"type":"function","title":"Lightning.Invocation.Query.last_successful_step_for_job/1","doc":"The last successful step for a job, used in scheduler to enable downstream runs\nto access a previous run's state","ref":"Lightning.Invocation.Query.html#last_successful_step_for_job/1"},{"type":"function","title":"Lightning.Invocation.Query.select_as_input/1","doc":"Returns a dataclip formatted for use as an input state.\n\nOnly `http_request` dataclips are changed, their `body` is nested inside a\n`\"data\"` key and `request` data is added as a `\"request\"` key.","ref":"Lightning.Invocation.Query.html#select_as_input/1"},{"type":"function","title":"Lightning.Invocation.Query.steps_for/1","doc":"Steps for a specific user","ref":"Lightning.Invocation.Query.html#steps_for/1"},{"type":"function","title":"Lightning.Invocation.Query.steps_with_reason/2","doc":"The last step for a job for a particular exit reason, used in scheduler","ref":"Lightning.Invocation.Query.html#steps_with_reason/2"},{"type":"function","title":"Lightning.Invocation.Query.wipe_dataclips/1","doc":"","ref":"Lightning.Invocation.Query.html#wipe_dataclips/1"},{"type":"module","title":"Lightning.Invocation.Step","doc":"Ecto model for Steps.\n\nA step is part of a run and represents the work initiated for a single\nJob with a single `input_dataclip`.\n\nOnce completed (successfully) it will have an `output_dataclip` associated\nwith it as well.\n\nWhen a step finishes, it's `:exit_reason` is set to one of following strings:\n\n- `\"success\"`\n- `\"fail\"`\n- `\"crash\"`\n- `\"cancel\"`\n- `\"kill\"`\n- `\"exception\"`\n- `\"lost\"`","ref":"Lightning.Invocation.Step.html"},{"type":"function","title":"Lightning.Invocation.Step.finished/2","doc":"","ref":"Lightning.Invocation.Step.html#finished/2"},{"type":"function","title":"Lightning.Invocation.Step.new/1","doc":"","ref":"Lightning.Invocation.Step.html#new/1"},{"type":"function","title":"Lightning.Invocation.Step.validate/1","doc":"","ref":"Lightning.Invocation.Step.html#validate/1"},{"type":"type","title":"Lightning.Invocation.Step.t/0","doc":"","ref":"Lightning.Invocation.Step.html#t:t/0"},{"type":"module","title":"Lightning.Jobs","doc":"The Jobs context.","ref":"Lightning.Jobs.html"},{"type":"function","title":"Lightning.Jobs.change_job/2","doc":"Returns an `%Ecto.Changeset{}` for tracking job changes.","ref":"Lightning.Jobs.html#change_job/2"},{"type":"function","title":"Examples - Lightning.Jobs.change_job/2","doc":"iex> change_job(job)\n %Ecto.Changeset{data: %Job{}}","ref":"Lightning.Jobs.html#change_job/2-examples"},{"type":"function","title":"Lightning.Jobs.create_job/1","doc":"Creates a job.","ref":"Lightning.Jobs.html#create_job/1"},{"type":"function","title":"Examples - Lightning.Jobs.create_job/1","doc":"iex> create_job(%{field: value})\n {:ok, %Job{}}\n\n iex> create_job(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Jobs.html#create_job/1-examples"},{"type":"function","title":"Lightning.Jobs.get_downstream_jobs_for/2","doc":"Returns the list of downstream jobs for a given job, optionally matching a\nspecific trigger type.\nWhen downstream_jobs_for is called without a trigger that means its between jobs\nwhen it called with a trigger that means we are starting from outside the pipeline","ref":"Lightning.Jobs.html#get_downstream_jobs_for/2"},{"type":"function","title":"Lightning.Jobs.get_job!/1","doc":"Gets a single job.\n\nRaises `Ecto.NoResultsError` if the Job does not exist.","ref":"Lightning.Jobs.html#get_job!/1"},{"type":"function","title":"Examples - Lightning.Jobs.get_job!/1","doc":"iex> get_job!(123)\n %Job{}\n\n iex> get_job!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Jobs.html#get_job!/1-examples"},{"type":"function","title":"Lightning.Jobs.get_job_with_credential/1","doc":"","ref":"Lightning.Jobs.html#get_job_with_credential/1"},{"type":"function","title":"Lightning.Jobs.get_upstream_jobs_for/1","doc":"Returns the list of jobs excluding the one given.","ref":"Lightning.Jobs.html#get_upstream_jobs_for/1"},{"type":"function","title":"Lightning.Jobs.jobs_for_project/1","doc":"","ref":"Lightning.Jobs.html#jobs_for_project/1"},{"type":"function","title":"Lightning.Jobs.jobs_for_project_query/1","doc":"","ref":"Lightning.Jobs.html#jobs_for_project_query/1"},{"type":"function","title":"Lightning.Jobs.list_active_cron_jobs/0","doc":"","ref":"Lightning.Jobs.html#list_active_cron_jobs/0"},{"type":"function","title":"Lightning.Jobs.list_jobs/0","doc":"Returns the list of jobs.","ref":"Lightning.Jobs.html#list_jobs/0"},{"type":"function","title":"Lightning.Jobs.list_jobs_for_workflow/1","doc":"","ref":"Lightning.Jobs.html#list_jobs_for_workflow/1"},{"type":"function","title":"Lightning.Jobs.update_job/2","doc":"Updates a job.","ref":"Lightning.Jobs.html#update_job/2"},{"type":"function","title":"Examples - Lightning.Jobs.update_job/2","doc":"iex> update_job(job, %{field: new_value})\n {:ok, %Job{}}\n\n iex> update_job(job, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Jobs.html#update_job/2-examples"},{"type":"module","title":"Lightning.Projects","doc":"The Projects context.","ref":"Lightning.Projects.html"},{"type":"function","title":"Lightning.Projects.add_project_users/3","doc":"","ref":"Lightning.Projects.html#add_project_users/3"},{"type":"function","title":"Lightning.Projects.cancel_scheduled_deletion/1","doc":"","ref":"Lightning.Projects.html#cancel_scheduled_deletion/1"},{"type":"function","title":"Lightning.Projects.change_project/2","doc":"Returns an `%Ecto.Changeset{}` for tracking project changes.","ref":"Lightning.Projects.html#change_project/2"},{"type":"function","title":"Examples - Lightning.Projects.change_project/2","doc":"iex> change_project(project)\n %Ecto.Changeset{data: %Project{}}","ref":"Lightning.Projects.html#change_project/2-examples"},{"type":"function","title":"Lightning.Projects.create_project/2","doc":"Creates a project.","ref":"Lightning.Projects.html#create_project/2"},{"type":"function","title":"Examples - Lightning.Projects.create_project/2","doc":"iex> create_project(%{field: value})\n {:ok, %Project{}}\n\n iex> create_project(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Projects.html#create_project/2-examples"},{"type":"function","title":"Lightning.Projects.delete_project/1","doc":"Deletes a project and its related data, including workflows, work orders,\nsteps, jobs, runs, triggers, project users, project credentials, and dataclips","ref":"Lightning.Projects.html#delete_project/1"},{"type":"function","title":"Examples - Lightning.Projects.delete_project/1","doc":"iex> delete_project(project)\n {:ok, %Project{}}\n\n iex> delete_project(project)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Projects.html#delete_project/1-examples"},{"type":"function","title":"Lightning.Projects.delete_project_async/1","doc":"","ref":"Lightning.Projects.html#delete_project_async/1"},{"type":"function","title":"Lightning.Projects.delete_project_dataclips/2","doc":"Deletes project dataclips in batches","ref":"Lightning.Projects.html#delete_project_dataclips/2"},{"type":"function","title":"Lightning.Projects.delete_project_user!/1","doc":"","ref":"Lightning.Projects.html#delete_project_user!/1"},{"type":"function","title":"Lightning.Projects.delete_project_workorders/2","doc":"Deletes project work orders in batches","ref":"Lightning.Projects.html#delete_project_workorders/2"},{"type":"function","title":"Lightning.Projects.export_project/3","doc":"Exports a project as yaml.","ref":"Lightning.Projects.html#export_project/3"},{"type":"function","title":"Examples - Lightning.Projects.export_project/3","doc":"iex> export_project(:yaml, project_id)\n {:ok, string}","ref":"Lightning.Projects.html#export_project/3-examples"},{"type":"function","title":"Lightning.Projects.find_users_to_notify_of_trigger_failure/1","doc":"","ref":"Lightning.Projects.html#find_users_to_notify_of_trigger_failure/1"},{"type":"function","title":"Lightning.Projects.get_project/1","doc":"","ref":"Lightning.Projects.html#get_project/1"},{"type":"function","title":"Lightning.Projects.get_project!/1","doc":"Gets a single project.\n\nRaises `Ecto.NoResultsError` if the Project does not exist.","ref":"Lightning.Projects.html#get_project!/1"},{"type":"function","title":"Examples - Lightning.Projects.get_project!/1","doc":"iex> get_project!(123)\n %Project{}\n\n iex> get_project!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Projects.html#get_project!/1-examples"},{"type":"function","title":"Lightning.Projects.get_project_credential/2","doc":"","ref":"Lightning.Projects.html#get_project_credential/2"},{"type":"function","title":"Lightning.Projects.get_project_user/1","doc":"","ref":"Lightning.Projects.html#get_project_user/1"},{"type":"function","title":"Lightning.Projects.get_project_user/2","doc":"","ref":"Lightning.Projects.html#get_project_user/2"},{"type":"function","title":"Lightning.Projects.get_project_user!/1","doc":"Gets a single project_user.\n\nRaises `Ecto.NoResultsError` if the ProjectUser does not exist.","ref":"Lightning.Projects.html#get_project_user!/1"},{"type":"function","title":"Examples - Lightning.Projects.get_project_user!/1","doc":"iex> get_project_user!(123)\n %ProjectUser{}\n\n iex> get_project_user!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Projects.html#get_project_user!/1-examples"},{"type":"function","title":"Lightning.Projects.get_project_user_role/2","doc":"Returns the role of a user in a project.\nPossible roles are :admin, :viewer, :editor, and :owner","ref":"Lightning.Projects.html#get_project_user_role/2"},{"type":"function","title":"Examples - Lightning.Projects.get_project_user_role/2","doc":"iex> get_project_user_role(user, project)\n :admin\n\n iex> get_project_user_role(user, project)\n :viewer\n\n iex> get_project_user_role(user, project)\n :editor\n\n iex> get_project_user_role(user, project)\n :owner","ref":"Lightning.Projects.html#get_project_user_role/2-examples"},{"type":"function","title":"Lightning.Projects.get_project_users!/1","doc":"Get all project users for a given project","ref":"Lightning.Projects.html#get_project_users!/1"},{"type":"function","title":"Lightning.Projects.get_project_with_users!/1","doc":"Gets a single project with it's members via `project_users`.\n\nRaises `Ecto.NoResultsError` if the Project does not exist.","ref":"Lightning.Projects.html#get_project_with_users!/1"},{"type":"function","title":"Examples - Lightning.Projects.get_project_with_users!/1","doc":"iex> get_project!(123)\n %Project{}\n\n iex> get_project!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Projects.html#get_project_with_users!/1-examples"},{"type":"function","title":"Lightning.Projects.get_projects_for_user/2","doc":"Fetches projects for a given user from the database.","ref":"Lightning.Projects.html#get_projects_for_user/2"},{"type":"function","title":"Parameters - Lightning.Projects.get_projects_for_user/2","doc":"- user: The user struct for which projects are being queried.\n- opts: Keyword list of options including :include for associations to preload and :order_by for sorting.","ref":"Lightning.Projects.html#get_projects_for_user/2-parameters"},{"type":"function","title":"Returns - Lightning.Projects.get_projects_for_user/2","doc":"- A list of projects associated with the user.","ref":"Lightning.Projects.html#get_projects_for_user/2-returns"},{"type":"function","title":"Lightning.Projects.get_projects_overview/2","doc":"","ref":"Lightning.Projects.html#get_projects_overview/2"},{"type":"function","title":"Lightning.Projects.invite_collaborators/3","doc":"","ref":"Lightning.Projects.html#invite_collaborators/3"},{"type":"function","title":"Lightning.Projects.list_project_admin_emails/1","doc":"Lists emails of users with `:owner` or `:admin` roles in the project","ref":"Lightning.Projects.html#list_project_admin_emails/1"},{"type":"function","title":"Lightning.Projects.list_project_credentials/1","doc":"","ref":"Lightning.Projects.html#list_project_credentials/1"},{"type":"function","title":"Lightning.Projects.list_project_files/2","doc":"","ref":"Lightning.Projects.html#list_project_files/2"},{"type":"function","title":"Lightning.Projects.list_projects/0","doc":"Returns the list of projects.","ref":"Lightning.Projects.html#list_projects/0"},{"type":"function","title":"Examples - Lightning.Projects.list_projects/0","doc":"iex> list_projects()\n [%Project{}, ...]","ref":"Lightning.Projects.html#list_projects/0-examples"},{"type":"function","title":"Lightning.Projects.list_projects_having_history_retention/0","doc":"Lists all projects that have history retention","ref":"Lightning.Projects.html#list_projects_having_history_retention/0"},{"type":"function","title":"Lightning.Projects.member_of?/2","doc":"","ref":"Lightning.Projects.html#member_of?/2"},{"type":"function","title":"Lightning.Projects.perform/1","doc":"Perform, when called with %{\"type\" => \"purge_deleted\"}\nwill find projects that are ready for permanent deletion and purge them.","ref":"Lightning.Projects.html#perform/1"},{"type":"function","title":"Lightning.Projects.project_credentials_query/1","doc":"","ref":"Lightning.Projects.html#project_credentials_query/1"},{"type":"function","title":"Lightning.Projects.project_dataclips_query/1","doc":"","ref":"Lightning.Projects.html#project_dataclips_query/1"},{"type":"function","title":"Lightning.Projects.project_jobs_query/1","doc":"","ref":"Lightning.Projects.html#project_jobs_query/1"},{"type":"function","title":"Lightning.Projects.project_run_step_query/1","doc":"","ref":"Lightning.Projects.html#project_run_step_query/1"},{"type":"function","title":"Lightning.Projects.project_runs_query/1","doc":"","ref":"Lightning.Projects.html#project_runs_query/1"},{"type":"function","title":"Lightning.Projects.project_steps_query/1","doc":"","ref":"Lightning.Projects.html#project_steps_query/1"},{"type":"function","title":"Lightning.Projects.project_triggers_query/1","doc":"","ref":"Lightning.Projects.html#project_triggers_query/1"},{"type":"function","title":"Lightning.Projects.project_user_role_query/2","doc":"","ref":"Lightning.Projects.html#project_user_role_query/2"},{"type":"function","title":"Lightning.Projects.project_users_query/1","doc":"","ref":"Lightning.Projects.html#project_users_query/1"},{"type":"function","title":"Lightning.Projects.project_workflows_query/1","doc":"","ref":"Lightning.Projects.html#project_workflows_query/1"},{"type":"function","title":"Lightning.Projects.project_workorders_query/1","doc":"","ref":"Lightning.Projects.html#project_workorders_query/1"},{"type":"function","title":"Lightning.Projects.projects_for_user_query/2","doc":"Builds a query to retrieve projects associated with a user.","ref":"Lightning.Projects.html#projects_for_user_query/2"},{"type":"function","title":"Parameters - Lightning.Projects.projects_for_user_query/2","doc":"- user: The user struct for which projects are being queried.\n - opts: Keyword list of options including :include for associations to preload and :order_by for sorting.","ref":"Lightning.Projects.html#projects_for_user_query/2-parameters"},{"type":"function","title":"Returns - Lightning.Projects.projects_for_user_query/2","doc":"- An Ecto queryable struct to fetch projects.","ref":"Lightning.Projects.html#projects_for_user_query/2-returns"},{"type":"function","title":"Lightning.Projects.save_dataclips?/1","doc":"Should input or output dataclips be saved for runs in this project?","ref":"Lightning.Projects.html#save_dataclips?/1"},{"type":"function","title":"Lightning.Projects.schedule_project_deletion/1","doc":"Given a project, this function sets a scheduled deletion\ndate based on the PURGE_DELETED_AFTER_DAYS environment variable. If no ENV is\nset, this date defaults to NOW but the automatic project purge cronjob will\nnever run. (Note that subsequent logins will be blocked for projects pending\ndeletion.)","ref":"Lightning.Projects.html#schedule_project_deletion/1"},{"type":"function","title":"Lightning.Projects.select_first_project_for_user/1","doc":"","ref":"Lightning.Projects.html#select_first_project_for_user/1"},{"type":"function","title":"Lightning.Projects.update_project/3","doc":"Updates a project.","ref":"Lightning.Projects.html#update_project/3"},{"type":"function","title":"Examples - Lightning.Projects.update_project/3","doc":"iex> update_project(project, %{field: new_value})\n {:ok, %Project{}}\n\n iex> update_project(project, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Projects.html#update_project/3-examples"},{"type":"function","title":"Lightning.Projects.update_project_user/2","doc":"Updates a project user.","ref":"Lightning.Projects.html#update_project_user/2"},{"type":"function","title":"Examples - Lightning.Projects.update_project_user/2","doc":"iex> update_project_user(project_user, %{field: new_value})\n {:ok, %ProjectUser{}}\n\n iex> update_project_user(projectUser, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Projects.html#update_project_user/2-examples"},{"type":"function","title":"Lightning.Projects.update_project_with_users/3","doc":"","ref":"Lightning.Projects.html#update_project_with_users/3"},{"type":"function","title":"Lightning.Projects.validate_for_deletion/2","doc":"Returns an `%Ecto.Changeset{}` for changing the project scheduled_deletion.","ref":"Lightning.Projects.html#validate_for_deletion/2"},{"type":"function","title":"Examples - Lightning.Projects.validate_for_deletion/2","doc":"iex> validate_for_deletion(project)\n %Ecto.Changeset{data: %Project{}}","ref":"Lightning.Projects.html#validate_for_deletion/2-examples"},{"type":"module","title":"Lightning.Projects.Audit","doc":"Generate Audit changesets for selected changes to project settings.","ref":"Lightning.Projects.Audit.html"},{"type":"function","title":"Lightning.Projects.Audit.base_query/0","doc":"","ref":"Lightning.Projects.Audit.html#base_query/0"},{"type":"function","title":"Lightning.Projects.Audit.derive_events/3","doc":"","ref":"Lightning.Projects.Audit.html#derive_events/3"},{"type":"function","title":"Lightning.Projects.Audit.event/5","doc":"","ref":"Lightning.Projects.Audit.html#event/5"},{"type":"function","title":"Lightning.Projects.Audit.save/1","doc":"","ref":"Lightning.Projects.Audit.html#save/1"},{"type":"function","title":"Lightning.Projects.Audit.update_changes/1","doc":"","ref":"Lightning.Projects.Audit.html#update_changes/1"},{"type":"module","title":"Lightning.Projects.Events","doc":"Events for Projects changes.","ref":"Lightning.Projects.Events.html"},{"type":"function","title":"Lightning.Projects.Events.project_created/1","doc":"","ref":"Lightning.Projects.Events.html#project_created/1"},{"type":"function","title":"Lightning.Projects.Events.project_deleted/1","doc":"","ref":"Lightning.Projects.Events.html#project_deleted/1"},{"type":"function","title":"Lightning.Projects.Events.subscribe/0","doc":"","ref":"Lightning.Projects.Events.html#subscribe/0"},{"type":"module","title":"Lightning.Projects.File","doc":"The project files module","ref":"Lightning.Projects.File.html"},{"type":"function","title":"Lightning.Projects.File.mark_failed/1","doc":"","ref":"Lightning.Projects.File.html#mark_failed/1"},{"type":"function","title":"Lightning.Projects.File.new/1","doc":"Creates a new file changeset.\n\nUnlike regular changeset functions, this expects atom keys and the project\nand user to be passed in as models.","ref":"Lightning.Projects.File.html#new/1"},{"type":"type","title":"Lightning.Projects.File.t/0","doc":"","ref":"Lightning.Projects.File.html#t:t/0"},{"type":"module","title":"Lightning.Projects.Project","doc":"Project model","ref":"Lightning.Projects.Project.html"},{"type":"function","title":"Lightning.Projects.Project.data_retention_options/0","doc":"","ref":"Lightning.Projects.Project.html#data_retention_options/0"},{"type":"function","title":"Lightning.Projects.Project.deletion_changeset/2","doc":"Changeset to validate a project deletion request, the user must enter the\nprojects name to confirm.","ref":"Lightning.Projects.Project.html#deletion_changeset/2"},{"type":"function","title":"Lightning.Projects.Project.project_with_users_changeset/2","doc":"","ref":"Lightning.Projects.Project.html#project_with_users_changeset/2"},{"type":"function","title":"Lightning.Projects.Project.validate/1","doc":"","ref":"Lightning.Projects.Project.html#validate/1"},{"type":"type","title":"Lightning.Projects.Project.retention_policy_type/0","doc":"","ref":"Lightning.Projects.Project.html#t:retention_policy_type/0"},{"type":"type","title":"Lightning.Projects.Project.t/0","doc":"","ref":"Lightning.Projects.Project.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectCredential","doc":"Join table to assign credentials to a project","ref":"Lightning.Projects.ProjectCredential.html"},{"type":"type","title":"Lightning.Projects.ProjectCredential.t/0","doc":"","ref":"Lightning.Projects.ProjectCredential.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectOauthClient","doc":"Manages the relationship between OAuth clients and projects, acting as a join table.\nThis module defines the schema and validations needed for creating and managing\nassociations between `OauthClient` and `Project`. It ensures that an OAuth client\ncan be associated with a project, facilitating the management of access permissions\nand settings specific to a project.","ref":"Lightning.Projects.ProjectOauthClient.html"},{"type":"module","title":"Schema Information - Lightning.Projects.ProjectOauthClient","doc":"The schema represents the bridge between projects and OAuth clients with the following fields:\n\n- `:id`: The unique identifier for the association, automatically generated.\n- `:oauth_client_id`: Foreign key to link with the OAuth client.\n- `:project_id`: Foreign key to link with the project.\n\nThis module also includes a virtual field `:delete` to mark an association for deletion,\naiding in operations that require soft deletion patterns or special handling before\nactually removing an association.","ref":"Lightning.Projects.ProjectOauthClient.html#module-schema-information"},{"type":"module","title":"Usage - Lightning.Projects.ProjectOauthClient","doc":"The primary function of this module is to create and manage changesets for adding or\nremoving OAuth clients from projects, ensuring data integrity and enforcing business\nrules such as uniqueness of the association.","ref":"Lightning.Projects.ProjectOauthClient.html#module-usage"},{"type":"function","title":"Lightning.Projects.ProjectOauthClient.changeset/2","doc":"Creates or updates changesets for a `ProjectOauthClient` entity based on the given attributes.\nValidates required fields and applies a unique constraint to ensure an OAuth client\ncan be associated with a project only once.\n\nThis changeset is used for adding new or updating existing associations between an OAuth client and a project.","ref":"Lightning.Projects.ProjectOauthClient.html#changeset/2"},{"type":"type","title":"Lightning.Projects.ProjectOauthClient.t/0","doc":"","ref":"Lightning.Projects.ProjectOauthClient.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectOverviewRow","doc":"Represents a summarized view of a project for a user, used in the project overview table.","ref":"Lightning.Projects.ProjectOverviewRow.html"},{"type":"module","title":"Lightning.Projects.ProjectUser","doc":"Join table to assign users to a project","ref":"Lightning.Projects.ProjectUser.html"},{"type":"type","title":"Lightning.Projects.ProjectUser.t/0","doc":"","ref":"Lightning.Projects.ProjectUser.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectUser.DigestEnum","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.cast/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#cast/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.create_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#create_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.drop_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#drop_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.dump/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#dump/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.embed_as/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#embed_as/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.equal?/2","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#equal?/2"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.load/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#load/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.schema/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#schema/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.schemaless_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#schemaless_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.type/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.valid_value?/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#valid_value?/1"},{"type":"type","title":"Lightning.Projects.ProjectUser.DigestEnum.t/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectUser.RolesEnum","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.cast/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#cast/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.create_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#create_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.drop_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#drop_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.dump/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#dump/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.embed_as/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#embed_as/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.equal?/2","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#equal?/2"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.load/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#load/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.schema/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#schema/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.schemaless_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#schemaless_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.type/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.valid_value?/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#valid_value?/1"},{"type":"type","title":"Lightning.Projects.ProjectUser.RolesEnum.t/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#t:t/0"},{"type":"module","title":"Lightning.Projects.Provisioner","doc":"Provides functions for importing projects. This module is used by the\nprovisioning HTTP API.\n\nWhen providing a project to import, all records must have an `id` field.\nIt's up to the caller to ensure that the `id` is unique and generated\nahead of time in the case of new records.","ref":"Lightning.Projects.Provisioner.html"},{"type":"function","title":"Lightning.Projects.Provisioner.import_document/3","doc":"Import a project.","ref":"Lightning.Projects.Provisioner.html#import_document/3"},{"type":"function","title":"Lightning.Projects.Provisioner.parse_document/2","doc":"","ref":"Lightning.Projects.Provisioner.html#parse_document/2"},{"type":"function","title":"Lightning.Projects.Provisioner.preload_dependencies/2","doc":"Preload all dependencies for a project.\n\nExclude deleted workflows.","ref":"Lightning.Projects.Provisioner.html#preload_dependencies/2"},{"type":"function","title":"Lightning.Projects.Provisioner.validate_extraneous_params/1","doc":"Validate that there are no extraneous parameters in the changeset.\n\nFor all params in the changeset, ensure that the param is in the list of\nknown fields in the schema.","ref":"Lightning.Projects.Provisioner.html#validate_extraneous_params/1"},{"type":"module","title":"Lightning.Runtime.LogAgent","doc":"Agent facility to consume STDOUT/STDERR byte by byte.\n\nSince it works on a byte by byte basis, you will need to perform line-splitting\nyourself.\n\nUsage:\n\n```\n{:ok, log} = LogAgent.start_link()\n\"foo\" = LogAgent.process_chunk(log, {:stdout, \"foo\"})\n\"foobar\" = LogAgent.process_chunk(log, {:stdout, \"bar\"})\n```","ref":"Lightning.Runtime.LogAgent.html"},{"type":"function","title":"Lightning.Runtime.LogAgent.buffer/1","doc":"","ref":"Lightning.Runtime.LogAgent.html#buffer/1"},{"type":"function","title":"Lightning.Runtime.LogAgent.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.Runtime.LogAgent.html#child_spec/1"},{"type":"function","title":"Lightning.Runtime.LogAgent.process_chunk/2","doc":"","ref":"Lightning.Runtime.LogAgent.html#process_chunk/2"},{"type":"function","title":"Lightning.Runtime.LogAgent.start_link/1","doc":"","ref":"Lightning.Runtime.LogAgent.html#start_link/1"},{"type":"type","title":"Lightning.Runtime.LogAgent.logline/0","doc":"","ref":"Lightning.Runtime.LogAgent.html#t:logline/0"},{"type":"module","title":"Lightning.Runtime.LogAgent.StringBuffer","doc":"Internal datastructure to hold and process new bytes for a list of\ncharacters.\n\nBy checking the if the buffer is a complete grapheme, emitting the buffer\nonce valid and returning `nil` otherwise.\n\nIn the case of emojis and other language character sets, a character\n(in UTF-8) can be between 1-4 bytes - when streaming logs for example\nit's quite easy to receive less than the whole character which can\nresult in crashes or corrupt text.","ref":"Lightning.Runtime.LogAgent.StringBuffer.html"},{"type":"function","title":"Lightning.Runtime.LogAgent.StringBuffer.buffer/1","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#buffer/1"},{"type":"function","title":"Lightning.Runtime.LogAgent.StringBuffer.new/0","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#new/0"},{"type":"function","title":"Lightning.Runtime.LogAgent.StringBuffer.process_chunk/2","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#process_chunk/2"},{"type":"function","title":"Lightning.Runtime.LogAgent.StringBuffer.reduce_chunk/2","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#reduce_chunk/2"},{"type":"type","title":"Lightning.Runtime.LogAgent.StringBuffer.t/0","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#t:t/0"},{"type":"module","title":"Lightning.Runtime.RuntimeManager","doc":"Locates and runs the Runtime server. Added in order to ease development and default installations of Lightning\n\n# https://registry.npmjs.org/lightning-runtime/latest","ref":"Lightning.Runtime.RuntimeManager.html"},{"type":"module","title":"Runtime configuration - Lightning.Runtime.RuntimeManager","doc":"Sample:\n\n config :lightining, Elixir.Lightning.Runtime.RuntimeManager,\n version: \"0.1.0\",\n start: true,\n args: ~w(js/app.js --bundle --target=es2016 --outdir=../priv/static/assets),\n cd: Path.expand(\"../assets\", __DIR__),\n env: %{}\n\nOptions:\n\n * `:version` - the expected runtime version\n\n * `:start` - flag to start the runtime manager. If `false` the GenServer\n won't be started\n\n * `:path` - the path to find the runtime executable at. By\n default, it is automatically downloaded and placed inside\n the `_build` directory of your current app\n\nOverriding the `:path` is not recommended, as we will automatically\ndownload and manage the `runtime` for you.","ref":"Lightning.Runtime.RuntimeManager.html#module-runtime-configuration"},{"type":"function","title":"Lightning.Runtime.RuntimeManager.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.Runtime.RuntimeManager.html#child_spec/1"},{"type":"function","title":"Lightning.Runtime.RuntimeManager.start_link/1","doc":"","ref":"Lightning.Runtime.RuntimeManager.html#start_link/1"},{"type":"behaviour","title":"Lightning.Runtime.RuntimeManager.RuntimeClient","doc":"Behaviour for runtime clients to improve testability.","ref":"Lightning.Runtime.RuntimeManager.RuntimeClient.html"},{"type":"callback","title":"Lightning.Runtime.RuntimeManager.RuntimeClient.start_runtime/1","doc":"","ref":"Lightning.Runtime.RuntimeManager.RuntimeClient.html#c:start_runtime/1"},{"type":"callback","title":"Lightning.Runtime.RuntimeManager.RuntimeClient.stop_runtime/1","doc":"","ref":"Lightning.Runtime.RuntimeManager.RuntimeClient.html#c:stop_runtime/1"},{"type":"module","title":"Lightning.Workflows","doc":"The Workflows context.","ref":"Lightning.Workflows.html"},{"type":"function","title":"Lightning.Workflows.build_trigger/1","doc":"Builds a Trigger","ref":"Lightning.Workflows.html#build_trigger/1"},{"type":"function","title":"Lightning.Workflows.capture_snapshot/1","doc":"Creates a snapshot from a multi.\n\nWhen the multi already has a `:workflow` change, it is assumed to be changed\nor inserted and will attempt to build and insert a new snapshot.\n\nWhen there isn't a `:workflow` change, it tries to find a dependant model\nlike a Job, Trigger or Edge and uses the workflow associated with that\nmodel.\n\nIn this case we assume that the workflow wasn't actually updated,\n`Workflow.touch()` is called to bump the `updated_at` and the `lock_version`\nof the workflow before a snapshot is captured.","ref":"Lightning.Workflows.html#capture_snapshot/1"},{"type":"function","title":"Lightning.Workflows.change_workflow/2","doc":"Returns an `%Ecto.Changeset{}` for tracking workflow changes.","ref":"Lightning.Workflows.html#change_workflow/2"},{"type":"function","title":"Examples - Lightning.Workflows.change_workflow/2","doc":"iex> change_workflow(workflow)\n %Ecto.Changeset{data: %Workflow{}}","ref":"Lightning.Workflows.html#change_workflow/2-examples"},{"type":"function","title":"Lightning.Workflows.create_edge/1","doc":"Creates an edge","ref":"Lightning.Workflows.html#create_edge/1"},{"type":"function","title":"Lightning.Workflows.get_edge_by_trigger/1","doc":"Gets an `Edge` by its associated `Trigger`.","ref":"Lightning.Workflows.html#get_edge_by_trigger/1"},{"type":"function","title":"Parameters - Lightning.Workflows.get_edge_by_trigger/1","doc":"- `%Trigger{id: trigger_id}`: A `Trigger` struct from which the associated `Edge` is to be found.","ref":"Lightning.Workflows.html#get_edge_by_trigger/1-parameters"},{"type":"function","title":"Returns - Lightning.Workflows.get_edge_by_trigger/1","doc":"- Returns an `Edge` struct preloaded with its `source_trigger` and `target_job` if found.\n- Returns `nil` if no `Edge` is associated with the given `Trigger`.","ref":"Lightning.Workflows.html#get_edge_by_trigger/1-returns"},{"type":"function","title":"Examples - Lightning.Workflows.get_edge_by_trigger/1","doc":"```\ntrigger = %Trigger{id: 1, ...}\nLightning.Workflows.get_edge_by_trigger(trigger)\n# => %Edge{source_trigger: %Trigger{}, target_job: %Job{}, ...}\n\nnon_existent_trigger = %Trigger{id: 999, ...}\nLightning.Workflows.get_edge_by_trigger(non_existent_trigger)\n# => nil\n```","ref":"Lightning.Workflows.html#get_edge_by_trigger/1-examples"},{"type":"function","title":"Lightning.Workflows.get_edges_for_cron_execution/1","doc":"Returns a list of edges with jobs to execute, given a current timestamp in Unix. This is\nused by the scheduler, which calls this function once every minute.","ref":"Lightning.Workflows.html#get_edges_for_cron_execution/1"},{"type":"function","title":"Lightning.Workflows.get_trigger_by_webhook/1","doc":"Gets a single `Trigger` by its `custom_path` or `id`.","ref":"Lightning.Workflows.html#get_trigger_by_webhook/1"},{"type":"function","title":"Parameters - Lightning.Workflows.get_trigger_by_webhook/1","doc":"- `path`: A binary string representing the `custom_path` or `id` of the trigger.","ref":"Lightning.Workflows.html#get_trigger_by_webhook/1-parameters"},{"type":"function","title":"Returns - Lightning.Workflows.get_trigger_by_webhook/1","doc":"- Returns a `Trigger` struct if a trigger is found.\n- Returns `nil` if no trigger is found for the given `path`.","ref":"Lightning.Workflows.html#get_trigger_by_webhook/1-returns"},{"type":"function","title":"Examples - Lightning.Workflows.get_trigger_by_webhook/1","doc":"```\nLightning.Workflows.get_trigger_by_webhook(\"some_path_or_id\")\n# => %Trigger{id: 1, custom_path: \"some_path_or_id\", ...}\n\nLightning.Workflows.get_trigger_by_webhook(\"non_existent_path_or_id\")\n# => nil\n```","ref":"Lightning.Workflows.html#get_trigger_by_webhook/1-examples"},{"type":"function","title":"Lightning.Workflows.get_webhook_trigger/2","doc":"Gets a Single Edge by it's webhook trigger.","ref":"Lightning.Workflows.html#get_webhook_trigger/2"},{"type":"function","title":"Lightning.Workflows.get_workflow/1","doc":"","ref":"Lightning.Workflows.html#get_workflow/1"},{"type":"function","title":"Lightning.Workflows.get_workflow!/1","doc":"Gets a single workflow.\n\nRaises `Ecto.NoResultsError` if the Workflow does not exist.","ref":"Lightning.Workflows.html#get_workflow!/1"},{"type":"function","title":"Examples - Lightning.Workflows.get_workflow!/1","doc":"iex> get_workflow!(123)\n %Workflow{}\n\n iex> get_workflow!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Workflows.html#get_workflow!/1-examples"},{"type":"function","title":"Lightning.Workflows.get_workflows_for/1","doc":"Retrieves a list of active Workflows with their jobs and triggers preloaded.","ref":"Lightning.Workflows.html#get_workflows_for/1"},{"type":"function","title":"Lightning.Workflows.has_newer_version?/1","doc":"","ref":"Lightning.Workflows.html#has_newer_version?/1"},{"type":"function","title":"Lightning.Workflows.jobs_ordered_subquery/0","doc":"A way to ensure the consistency of nodes.\nThis query orders jobs based on their `inserted_at` timestamps in ascending order","ref":"Lightning.Workflows.html#jobs_ordered_subquery/0"},{"type":"function","title":"Lightning.Workflows.list_workflows/0","doc":"Returns the list of workflows.","ref":"Lightning.Workflows.html#list_workflows/0"},{"type":"function","title":"Examples - Lightning.Workflows.list_workflows/0","doc":"iex> list_workflows()\n [%Workflow{}, ...]","ref":"Lightning.Workflows.html#list_workflows/0-examples"},{"type":"function","title":"Lightning.Workflows.mark_for_deletion/2","doc":"Returns an `%Ecto.Changeset{}` for changing the workflow request_deletion.","ref":"Lightning.Workflows.html#mark_for_deletion/2"},{"type":"function","title":"Examples - Lightning.Workflows.mark_for_deletion/2","doc":"iex> change_request_deletion(workflow)\n %Ecto.Changeset{data: %Workflow{}}","ref":"Lightning.Workflows.html#mark_for_deletion/2-examples"},{"type":"function","title":"Lightning.Workflows.publish_kafka_trigger_events/1","doc":"","ref":"Lightning.Workflows.html#publish_kafka_trigger_events/1"},{"type":"function","title":"Lightning.Workflows.save_workflow/1","doc":"","ref":"Lightning.Workflows.html#save_workflow/1"},{"type":"function","title":"Lightning.Workflows.subscribe/1","doc":"","ref":"Lightning.Workflows.html#subscribe/1"},{"type":"function","title":"Lightning.Workflows.to_project_space/1","doc":"","ref":"Lightning.Workflows.html#to_project_space/1"},{"type":"function","title":"Lightning.Workflows.update_trigger/2","doc":"Updates a trigger","ref":"Lightning.Workflows.html#update_trigger/2"},{"type":"function","title":"Lightning.Workflows.workflow_exists?/2","doc":"Check if workflow exist","ref":"Lightning.Workflows.html#workflow_exists?/2"},{"type":"module","title":"Lightning.Workflows.Edge","doc":"Ecto model for Workflow Edges.\n\nA Workflow Edge represents a connection between two jobs\n(or a trigger and a job) in a workflow.\n\nThe source of the edge is either a job or a trigger.\nThe target of the edge is always a job.","ref":"Lightning.Workflows.Edge.html"},{"type":"function","title":"Lightning.Workflows.Edge.changeset/2","doc":"","ref":"Lightning.Workflows.Edge.html#changeset/2"},{"type":"function","title":"Lightning.Workflows.Edge.new/1","doc":"","ref":"Lightning.Workflows.Edge.html#new/1"},{"type":"function","title":"Lightning.Workflows.Edge.validate/1","doc":"","ref":"Lightning.Workflows.Edge.html#validate/1"},{"type":"type","title":"Lightning.Workflows.Edge.edge_condition/0","doc":"","ref":"Lightning.Workflows.Edge.html#t:edge_condition/0"},{"type":"type","title":"Lightning.Workflows.Edge.t/0","doc":"","ref":"Lightning.Workflows.Edge.html#t:t/0"},{"type":"module","title":"Lightning.Workflows.Job","doc":"Ecto model for Jobs.\n\nA Job contains the fields for defining a job.\n\n* `body`\n The expression/javascript code\n* `name`\n A plain text identifier\n* `adaptor`\n An NPM style string that contains both the module name and it's version.\n E.g. `@openfn/language-http@v1.2.3` or `@openfn/language-foo@latest`.\n While the version suffix isn't enforced here as it's not strictly necessary\n in this context, the front end will ensure a version is stated (`@latest`\n being the default).","ref":"Lightning.Workflows.Job.html"},{"type":"function","title":"Lightning.Workflows.Job.new/1","doc":"","ref":"Lightning.Workflows.Job.html#new/1"},{"type":"function","title":"Lightning.Workflows.Job.put_project_credential/2","doc":"","ref":"Lightning.Workflows.Job.html#put_project_credential/2"},{"type":"function","title":"Lightning.Workflows.Job.put_workflow/2","doc":"Attaches a workflow to a job, this is useful when you have an unpersisted\nWorkflow changeset - and want it to be created at the same time as a Job.\n\n\nExample:\n\n workflow =\n Ecto.Changeset.cast(\n %Lightning.Workflows.Workflow{},\n %{ \"project_id\" => attrs[:project_id], \"id\" => Ecto.UUID.generate() },\n [:project_id, :id]\n )\n\n job =\n %Job{}\n |> Ecto.Changeset.change()\n |> Job.put_workflow(workflow)\n |> Job.changeset(attrs)","ref":"Lightning.Workflows.Job.html#put_workflow/2"},{"type":"function","title":"Lightning.Workflows.Job.validate/1","doc":"","ref":"Lightning.Workflows.Job.html#validate/1"},{"type":"type","title":"Lightning.Workflows.Job.t/0","doc":"","ref":"Lightning.Workflows.Job.html#t:t/0"},{"type":"module","title":"Lightning.Workflows.Node","doc":"Represents a node in a workflow graph.","ref":"Lightning.Workflows.Node.html"},{"type":"module","title":"Lightning.Workflows.Presence","doc":"Handles user presence tracking within the Workflow canvas page.\n\nThis module leverages Phoenix.Presence to track user sessions, manage user priorities,\nand list active presences on specified topics.","ref":"Lightning.Workflows.Presence.html"},{"type":"function","title":"Lightning.Workflows.Presence.build_presences_summary/2","doc":"Builds a summary of presences with details about the current user's presence, promotable presences,\nand edit priority.","ref":"Lightning.Workflows.Presence.html#build_presences_summary/2"},{"type":"function","title":"Parameters - Lightning.Workflows.Presence.build_presences_summary/2","doc":"- `presences` (list): A list of presence records, each containing user information and a joined_at timestamp.\n - `params` (map): A map containing the following keys:\n - `:current_user_presence` - The presence record for the current user.\n - `:current_user` - The current user record.\n - `:view_only_users_ids` - A list of user IDs who have view-only permissions.","ref":"Lightning.Workflows.Presence.html#build_presences_summary/2-parameters"},{"type":"function","title":"Returns - Lightning.Workflows.Presence.build_presences_summary/2","doc":"- `map`: A map containing the following keys:\n - `:presences` - The sorted list of all presences.\n - `:prior_user_presence` - The presence record with edit priority.\n - `:current_user_presence` - The presence record for the current user.\n - `:has_presence_edit_priority` - A boolean indicating if the current user has edit priority.","ref":"Lightning.Workflows.Presence.html#build_presences_summary/2-returns"},{"type":"function","title":"Examples - Lightning.Workflows.Presence.build_presences_summary/2","doc":"iex> presences = [\n ...> %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},\n ...> %{user: %{id: 2}, joined_at: ~N[2024-07-03 12:05:00], active_sessions: 1},\n ...> %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1}\n ...> ]\n iex> params = %{\n ...> current_user_presence: %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},\n ...> current_user: %{id: 1},\n ...> view_only_users_ids: [2]\n ...> }\n iex> build_presences_summary(presences, params)\n %{\n presences: [\n %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},\n %{user: %{id: 2}, joined_at: ~N[2024-07-03 12:05:00], active_sessions: 1},\n %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1}\n ],\n prior_user_presence: %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1},\n current_user_presence: %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},\n has_presence_edit_priority: true\n }","ref":"Lightning.Workflows.Presence.html#build_presences_summary/2-examples"},{"type":"function","title":"Lightning.Workflows.Presence.child_spec/1","doc":"","ref":"Lightning.Workflows.Presence.html#child_spec/1"},{"type":"function","title":"Lightning.Workflows.Presence.fetch/2","doc":"","ref":"Lightning.Workflows.Presence.html#fetch/2"},{"type":"function","title":"Lightning.Workflows.Presence.fetchers_pids/0","doc":"","ref":"Lightning.Workflows.Presence.html#fetchers_pids/0"},{"type":"function","title":"Lightning.Workflows.Presence.get_by_key/2","doc":"","ref":"Lightning.Workflows.Presence.html#get_by_key/2"},{"type":"function","title":"Lightning.Workflows.Presence.list/1","doc":"","ref":"Lightning.Workflows.Presence.html#list/1"},{"type":"function","title":"Lightning.Workflows.Presence.list_presences/1","doc":"Lists all presences for a given topic.","ref":"Lightning.Workflows.Presence.html#list_presences/1"},{"type":"function","title":"Parameters - Lightning.Workflows.Presence.list_presences/1","doc":"- `topic`: The topic to list the presences for.","ref":"Lightning.Workflows.Presence.html#list_presences/1-parameters"},{"type":"function","title":"Examples - Lightning.Workflows.Presence.list_presences/1","doc":"iex> Lightning.Workflows.Presence.list_presences(\"workflow:canvas\")\n [%Lightning.Workflows.Presence{user: %User{id: 1}, ...}, ...]","ref":"Lightning.Workflows.Presence.html#list_presences/1-examples"},{"type":"function","title":"Lightning.Workflows.Presence.new_user_presence/3","doc":"Creates a new `UserPresence` struct.","ref":"Lightning.Workflows.Presence.html#new_user_presence/3"},{"type":"function","title":"Parameters - Lightning.Workflows.Presence.new_user_presence/3","doc":"- `user`: The user data to be included in the presence.\n - `joined_at`: The timestamp when the user joined, in microseconds.\n - `active_sessions`: The number of active sessions for the user (default is 0).","ref":"Lightning.Workflows.Presence.html#new_user_presence/3-parameters"},{"type":"function","title":"Examples - Lightning.Workflows.Presence.new_user_presence/3","doc":"iex> Lightning.Workflows.Presence.new_user_presence(%User{id: 1}, 1625597762000000)\n %Lightning.Workflows.Presence{\n user: %User{id: 1},\n joined_at: 1625597762000000,\n active_sessions: 0\n }","ref":"Lightning.Workflows.Presence.html#new_user_presence/3-examples"},{"type":"function","title":"Lightning.Workflows.Presence.track/3","doc":"","ref":"Lightning.Workflows.Presence.html#track/3"},{"type":"function","title":"Lightning.Workflows.Presence.track/4","doc":"","ref":"Lightning.Workflows.Presence.html#track/4"},{"type":"function","title":"Lightning.Workflows.Presence.track_user_presence/3","doc":"Tracks the presence of a user on a given topic.","ref":"Lightning.Workflows.Presence.html#track_user_presence/3"},{"type":"function","title":"Parameters - Lightning.Workflows.Presence.track_user_presence/3","doc":"- `user`: The user to be tracked.\n - `topic`: The topic to track the user on.\n - `pid`: The process identifier for the user's session.","ref":"Lightning.Workflows.Presence.html#track_user_presence/3-parameters"},{"type":"function","title":"Examples - Lightning.Workflows.Presence.track_user_presence/3","doc":"iex> Lightning.Workflows.Presence.track_user_presence(%User{id: 1}, \"room:lobby\", self())\n :ok","ref":"Lightning.Workflows.Presence.html#track_user_presence/3-examples"},{"type":"function","title":"Lightning.Workflows.Presence.untrack/2","doc":"","ref":"Lightning.Workflows.Presence.html#untrack/2"},{"type":"function","title":"Lightning.Workflows.Presence.untrack/3","doc":"","ref":"Lightning.Workflows.Presence.html#untrack/3"},{"type":"function","title":"Lightning.Workflows.Presence.update/3","doc":"","ref":"Lightning.Workflows.Presence.html#update/3"},{"type":"function","title":"Lightning.Workflows.Presence.update/4","doc":"","ref":"Lightning.Workflows.Presence.html#update/4"},{"type":"module","title":"Lightning.Workflows.Query","doc":"Query module for finding Jobs.","ref":"Lightning.Workflows.Query.html"},{"type":"function","title":"Lightning.Workflows.Query.enabled_cron_jobs_by_edge/0","doc":"Returns active jobs with their cron triggers for use in the cron scheduling\nservice.","ref":"Lightning.Workflows.Query.html#enabled_cron_jobs_by_edge/0"},{"type":"function","title":"Lightning.Workflows.Query.jobs_for/1","doc":"Returns all jobs accessible to a user, via their projects\nor all jobs in a given project.","ref":"Lightning.Workflows.Query.html#jobs_for/1"},{"type":"module","title":"Lightning.Workflows.Scheduler","doc":"The Scheduler is responsible for finding jobs that are ready to run based on\ntheir cron schedule, and then running them.","ref":"Lightning.Workflows.Scheduler.html"},{"type":"function","title":"Lightning.Workflows.Scheduler.enqueue_cronjobs/0","doc":"Find and start any cronjobs that are scheduled to run for a given time\n(defaults to the current time).","ref":"Lightning.Workflows.Scheduler.html#enqueue_cronjobs/0"},{"type":"function","title":"Lightning.Workflows.Scheduler.enqueue_cronjobs/1","doc":"","ref":"Lightning.Workflows.Scheduler.html#enqueue_cronjobs/1"},{"type":"module","title":"Lightning.Workflows.Snapshot","doc":"Ecto model for Workflow Snapshots.\n\nSnapshots are a way to store the state of a workflow at a given point in time.","ref":"Lightning.Workflows.Snapshot.html"},{"type":"function","title":"Lightning.Workflows.Snapshot.build/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#build/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.create/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#create/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_all_by_ids/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#get_all_by_ids/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_all_for/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#get_all_for/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_by_version/2","doc":"","ref":"Lightning.Workflows.Snapshot.html#get_by_version/2"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_current_for/1","doc":"Get the latest snapshot for a workflow, based on the lock_version.\n\nIt returns the latest snapshot regardless of the lock_version of the\nworkflow passed in. This is intentional to ensure that\n`get_or_create_latest_for/1` doesn't attempt to create a new snapshot if the\nworkflow has been updated elsewhere.","ref":"Lightning.Workflows.Snapshot.html#get_current_for/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_or_create_latest_for/1","doc":"Get the latest snapshot for a workflow, or create one if it doesn't exist.","ref":"Lightning.Workflows.Snapshot.html#get_or_create_latest_for/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_or_create_latest_for/3","doc":"","ref":"Lightning.Workflows.Snapshot.html#get_or_create_latest_for/3"},{"type":"function","title":"Lightning.Workflows.Snapshot.new/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#new/1"},{"type":"type","title":"Lightning.Workflows.Snapshot.t/0","doc":"","ref":"Lightning.Workflows.Snapshot.html#t:t/0"},{"type":"module","title":"Lightning.Workflows.Snapshot.Edge","doc":"","ref":"Lightning.Workflows.Snapshot.Edge.html"},{"type":"module","title":"Lightning.Workflows.Snapshot.Job","doc":"","ref":"Lightning.Workflows.Snapshot.Job.html"},{"type":"module","title":"Lightning.Workflows.Snapshot.Trigger","doc":"","ref":"Lightning.Workflows.Snapshot.Trigger.html"},{"type":"module","title":"Lightning.Workflows.Trigger","doc":"Ecto model for Triggers.\n\nTriggers represent the criteria in which a Job might be invoked.","ref":"Lightning.Workflows.Trigger.html"},{"type":"module","title":"Types - Lightning.Workflows.Trigger","doc":"","ref":"Lightning.Workflows.Trigger.html#module-types"},{"type":"module","title":"Webhook (default) - Lightning.Workflows.Trigger","doc":"A webhook trigger allows a Job to invoked (via `Lightning.Invocation`) when it's\nendpoint is called.","ref":"Lightning.Workflows.Trigger.html#module-webhook-default"},{"type":"function","title":"Lightning.Workflows.Trigger.cast_changeset/2","doc":"","ref":"Lightning.Workflows.Trigger.html#cast_changeset/2"},{"type":"function","title":"Lightning.Workflows.Trigger.new/1","doc":"","ref":"Lightning.Workflows.Trigger.html#new/1"},{"type":"function","title":"Lightning.Workflows.Trigger.validate/1","doc":"","ref":"Lightning.Workflows.Trigger.html#validate/1"},{"type":"function","title":"Lightning.Workflows.Trigger.with_auth_methods_query/0","doc":"","ref":"Lightning.Workflows.Trigger.html#with_auth_methods_query/0"},{"type":"type","title":"Lightning.Workflows.Trigger.t/0","doc":"","ref":"Lightning.Workflows.Trigger.html#t:t/0"},{"type":"type","title":"Lightning.Workflows.Trigger.trigger_type/0","doc":"","ref":"Lightning.Workflows.Trigger.html#t:trigger_type/0"},{"type":"module","title":"Lightning.Workflows.Triggers.Events","doc":"Responsible for the publishing of and subscription to trigger-related events.","ref":"Lightning.Workflows.Triggers.Events.html"},{"type":"function","title":"Lightning.Workflows.Triggers.Events.kafka_trigger_notification_sent/2","doc":"","ref":"Lightning.Workflows.Triggers.Events.html#kafka_trigger_notification_sent/2"},{"type":"function","title":"Lightning.Workflows.Triggers.Events.kafka_trigger_updated/1","doc":"","ref":"Lightning.Workflows.Triggers.Events.html#kafka_trigger_updated/1"},{"type":"function","title":"Lightning.Workflows.Triggers.Events.kafka_trigger_updated_topic/0","doc":"","ref":"Lightning.Workflows.Triggers.Events.html#kafka_trigger_updated_topic/0"},{"type":"function","title":"Lightning.Workflows.Triggers.Events.subscribe_to_kafka_trigger_updated/0","doc":"","ref":"Lightning.Workflows.Triggers.Events.html#subscribe_to_kafka_trigger_updated/0"},{"type":"module","title":"Lightning.Workflows.Triggers.KafkaConfiguration","doc":"Configuration of Kafka Triggers.","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.apply_hosts_string/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#apply_hosts_string/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.apply_topics_string/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#apply_topics_string/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.changeset/2","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#changeset/2"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.generate_hosts_string/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#generate_hosts_string/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.generate_topics_string/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#generate_topics_string/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.sasl_types/0","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#sasl_types/0"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.set_group_id_if_required/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#set_group_id_if_required/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.validate_initial_offset_reset_policy/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#validate_initial_offset_reset_policy/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.validate_sasl_credentials/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#validate_sasl_credentials/1"},{"type":"module","title":"Lightning.Workflows.WebhookAuthMethod","doc":"The `Lightning.Workflows.WebhookAuthMethod` module defines the schema for webhook authentication methods and provides functionalities to handle them.","ref":"Lightning.Workflows.WebhookAuthMethod.html"},{"type":"module","title":"Schema - Lightning.Workflows.WebhookAuthMethod","doc":"The schema represents a webhook authentication method that can be of two types - `:basic` and `:api`. The basic type requires a username and password, while the api type requires an api_key.\n\nThe schema fields include:\n - `name`: the name of the authentication method\n - `auth_type`: the type of authentication, can be `:basic` or `:api`\n - `username`: the username required for basic authentication\n - `password`: the password required for basic authentication (virtual field)\n - `hashed_password`: the hashed version of the password\n - `api_key`: the API key required for API authentication","ref":"Lightning.Workflows.WebhookAuthMethod.html#module-schema"},{"type":"module","title":"Associations - Lightning.Workflows.WebhookAuthMethod","doc":"Each `WebhookAuthMethod` belongs to a `project`.\nIt is also associated with multiple `triggers` through a many_to_many relationship.","ref":"Lightning.Workflows.WebhookAuthMethod.html#module-associations"},{"type":"module","title":"Validations and Constraints - Lightning.Workflows.WebhookAuthMethod","doc":"This module provides changeset functions for casting and validating the schema fields and applying unique constraints on `name`, `username`, and `api_key` within the project scope.","ref":"Lightning.Workflows.WebhookAuthMethod.html#module-validations-and-constraints"},{"type":"module","title":"Password Verification - Lightning.Workflows.WebhookAuthMethod","doc":"The `valid_password?/2` function is provided to verify passwords and it avoids timing attacks by using `Bcrypt.no_user_verify/0` when there is no webhook_auth_method or the webhook_auth_method doesn't have a password.","ref":"Lightning.Workflows.WebhookAuthMethod.html#module-password-verification"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethod.changeset/2","doc":"","ref":"Lightning.Workflows.WebhookAuthMethod.html#changeset/2"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethod.generate_api_key/1","doc":"","ref":"Lightning.Workflows.WebhookAuthMethod.html#generate_api_key/1"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethod.update_changeset/2","doc":"","ref":"Lightning.Workflows.WebhookAuthMethod.html#update_changeset/2"},{"type":"type","title":"Lightning.Workflows.WebhookAuthMethod.t/0","doc":"","ref":"Lightning.Workflows.WebhookAuthMethod.html#t:t/0"},{"type":"module","title":"Lightning.Workflows.WebhookAuthMethodAudit","doc":"Model for storing changes to WebhookAuthMethod","ref":"Lightning.Workflows.WebhookAuthMethodAudit.html"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethodAudit.base_query/0","doc":"","ref":"Lightning.Workflows.WebhookAuthMethodAudit.html#base_query/0"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethodAudit.event/5","doc":"","ref":"Lightning.Workflows.WebhookAuthMethodAudit.html#event/5"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethodAudit.save/1","doc":"","ref":"Lightning.Workflows.WebhookAuthMethodAudit.html#save/1"},{"type":"module","title":"Lightning.Workflows.Workflow","doc":"Ecto model for Workflows.\n\nA Workflow contains the fields for defining a workflow.\n\n* `name`\n A plain text identifier","ref":"Lightning.Workflows.Workflow.html"},{"type":"function","title":"Lightning.Workflows.Workflow.request_deletion_changeset/2","doc":"","ref":"Lightning.Workflows.Workflow.html#request_deletion_changeset/2"},{"type":"function","title":"Lightning.Workflows.Workflow.touch/1","doc":"Forces an update to the workflows `updated_at` timestamp and the\n`lock_version`. This is useful when updating a child record like jobs or\ntriggers and a snapshot needs to made; but the Workflow itself didn't change.","ref":"Lightning.Workflows.Workflow.html#touch/1"},{"type":"function","title":"Lightning.Workflows.Workflow.validate/1","doc":"","ref":"Lightning.Workflows.Workflow.html#validate/1"},{"type":"function","title":"Lightning.Workflows.Workflow.workflow_activated?/1","doc":"Returns true if the workflow has any triggers that are _going to be_ activated.\n\nNew triggers are enabled by default, but existing triggers are only considered\nactivated if their `enabled` field is _changed_ to `true`.","ref":"Lightning.Workflows.Workflow.html#workflow_activated?/1"},{"type":"type","title":"Lightning.Workflows.Workflow.t/0","doc":"","ref":"Lightning.Workflows.Workflow.html#t:t/0"},{"type":"module","title":"Lightning.LogMessage","doc":"A custom type to handle JSON log messages.\n\nCurrently the underlying database type is a string, and workers may send\neither a string, or a JSON object. This type will encode JSON objects to\nstring.\n\n> #### Messages are always strings {: .info}\n>\n> While this type allows JSON objects to be sent, the model will always return\n> strings. This type is a stand-in until we want to add a JSONB column to the\n> underlying table.\n\nIn the case of JSON objects we serialize them to a string, and in the case of\narrays we serialize them individually and join them with a space.","ref":"Lightning.LogMessage.html"},{"type":"function","title":"Lightning.LogMessage.cast/1","doc":"","ref":"Lightning.LogMessage.html#cast/1"},{"type":"function","title":"Lightning.LogMessage.dump/1","doc":"","ref":"Lightning.LogMessage.html#dump/1"},{"type":"function","title":"Lightning.LogMessage.embed_as/1","doc":"","ref":"Lightning.LogMessage.html#embed_as/1"},{"type":"function","title":"Lightning.LogMessage.equal?/2","doc":"","ref":"Lightning.LogMessage.html#equal?/2"},{"type":"function","title":"Lightning.LogMessage.load/1","doc":"","ref":"Lightning.LogMessage.html#load/1"},{"type":"function","title":"Lightning.LogMessage.type/0","doc":"","ref":"Lightning.LogMessage.html#type/0"},{"type":"module","title":"Lightning.UnixDateTime","doc":"A custom DateTime type for Ecto that uses millisecond Unix timestamps.\n\nNodeJS uses millisecond Unix timestamps, and Ecto has a choice of either\nsecond or microsecond precision. This module allows millisecond precision\nintegers to be used as DateTime values without losing precision.\n\nMicrosecond timestamps can also be parsed, but currently they are expected\nto be provided as strings. This is because Javascript can't represent\nmicrosecond timestamps as an integer and BigInt can't be represented\nas a JSON value.\n\nAll functions fallback on the default Ecto types conversion functions.","ref":"Lightning.UnixDateTime.html"},{"type":"function","title":"Lightning.UnixDateTime.cast/1","doc":"Cast a Unix timestamp to a DateTime.\n\nAccepts integers and strings, and will try to parse the string as an integer.\nIf the integer is 13 digits long, it will be parsed as a millisecond\ntimestamp, and as a microsecond timestamp if it is 16 digits long.","ref":"Lightning.UnixDateTime.html#cast/1"},{"type":"function","title":"Lightning.UnixDateTime.dump/1","doc":"","ref":"Lightning.UnixDateTime.html#dump/1"},{"type":"function","title":"Lightning.UnixDateTime.embed_as/1","doc":"","ref":"Lightning.UnixDateTime.html#embed_as/1"},{"type":"function","title":"Lightning.UnixDateTime.equal?/2","doc":"","ref":"Lightning.UnixDateTime.html#equal?/2"},{"type":"function","title":"Lightning.UnixDateTime.load/1","doc":"","ref":"Lightning.UnixDateTime.html#load/1"},{"type":"function","title":"Lightning.UnixDateTime.type/0","doc":"","ref":"Lightning.UnixDateTime.html#type/0"},{"type":"module","title":"LightningWeb","doc":"The entrypoint for defining your web interface, such\nas controllers, views, channels and so on.\n\nThis can be used in your application as:\n\n use LightningWeb, :controller\n use LightningWeb, :view\n\nThe definitions below will be executed for every view,\ncontroller, etc, so keep them short and clean, focused\non imports, uses and aliases.\n\nDo NOT define functions inside the quoted expressions\nbelow. Instead, define any helper function in modules\nand import those modules here.","ref":"LightningWeb.html"},{"type":"macro","title":"LightningWeb.__using__/1","doc":"When used, dispatch to the appropriate controller/view/etc.","ref":"LightningWeb.html#__using__/1"},{"type":"function","title":"LightningWeb.channel/0","doc":"","ref":"LightningWeb.html#channel/0"},{"type":"function","title":"LightningWeb.component/0","doc":"","ref":"LightningWeb.html#component/0"},{"type":"function","title":"LightningWeb.controller/0","doc":"","ref":"LightningWeb.html#controller/0"},{"type":"function","title":"LightningWeb.html/0","doc":"","ref":"LightningWeb.html#html/0"},{"type":"function","title":"LightningWeb.live_component/0","doc":"","ref":"LightningWeb.html#live_component/0"},{"type":"function","title":"LightningWeb.live_view/1","doc":"","ref":"LightningWeb.html#live_view/1"},{"type":"function","title":"LightningWeb.router/0","doc":"","ref":"LightningWeb.html#router/0"},{"type":"function","title":"LightningWeb.static_paths/0","doc":"","ref":"LightningWeb.html#static_paths/0"},{"type":"function","title":"LightningWeb.verified_routes/0","doc":"","ref":"LightningWeb.html#verified_routes/0"},{"type":"function","title":"LightningWeb.view/0","doc":"","ref":"LightningWeb.html#view/0"},{"type":"module","title":"LightningWeb.API.Helpers","doc":"Helpers for the API views","ref":"LightningWeb.API.Helpers.html"},{"type":"function","title":"LightningWeb.API.Helpers.pagination_link/3","doc":"","ref":"LightningWeb.API.Helpers.html#pagination_link/3"},{"type":"function","title":"LightningWeb.API.Helpers.pagination_links/2","doc":"","ref":"LightningWeb.API.Helpers.html#pagination_links/2"},{"type":"function","title":"LightningWeb.API.Helpers.url_for/2","doc":"","ref":"LightningWeb.API.Helpers.html#url_for/2"},{"type":"module","title":"LightningWeb.API.JobController","doc":"","ref":"LightningWeb.API.JobController.html"},{"type":"function","title":"LightningWeb.API.JobController.index/2","doc":"","ref":"LightningWeb.API.JobController.html#index/2"},{"type":"function","title":"LightningWeb.API.JobController.show/2","doc":"","ref":"LightningWeb.API.JobController.html#show/2"},{"type":"module","title":"LightningWeb.API.ProjectController","doc":"","ref":"LightningWeb.API.ProjectController.html"},{"type":"function","title":"LightningWeb.API.ProjectController.index/2","doc":"","ref":"LightningWeb.API.ProjectController.html#index/2"},{"type":"function","title":"LightningWeb.API.ProjectController.show/2","doc":"","ref":"LightningWeb.API.ProjectController.html#show/2"},{"type":"module","title":"LightningWeb.API.ProvisioningController","doc":"","ref":"LightningWeb.API.ProvisioningController.html"},{"type":"function","title":"LightningWeb.API.ProvisioningController.create/2","doc":"Creates or updates a project based on a JSON payload that may or may not\ncontain UUIDs for existing resources.","ref":"LightningWeb.API.ProvisioningController.html#create/2"},{"type":"function","title":"LightningWeb.API.ProvisioningController.show/2","doc":"Returns a project \"state.json\", complete with UUIDs to enable idempotent\nproject deployments and updates to existing projects via the CLI.","ref":"LightningWeb.API.ProvisioningController.html#show/2"},{"type":"function","title":"LightningWeb.API.ProvisioningController.show_yaml/2","doc":"Returns a description of the project as yaml. Same as the export project to\nyaml button (see Downloads Controller) but made for the API.","ref":"LightningWeb.API.ProvisioningController.html#show_yaml/2"},{"type":"module","title":"LightningWeb.API.RegistrationController","doc":"","ref":"LightningWeb.API.RegistrationController.html"},{"type":"function","title":"LightningWeb.API.RegistrationController.create/2","doc":"","ref":"LightningWeb.API.RegistrationController.html#create/2"},{"type":"module","title":"LightningWeb.AccountConfirmationModal","doc":"A LiveView component for displaying an account confirmation modal.\n\nThis component is responsible for informing users that access to their\naccounts, projects, and workflows is restricted until they confirm\ntheir account. It provides functionality to resend the confirmation\nemail and allows users to update their email address if needed.","ref":"LightningWeb.AccountConfirmationModal.html"},{"type":"module","title":"Features - LightningWeb.AccountConfirmationModal","doc":"- Displays a modal with instructions for account confirmation.\n- Allows users to resend the confirmation email.\n- Provides feedback when the confirmation email is successfully sent.\n- Allows users to navigate to the profile page to update their email address.","ref":"LightningWeb.AccountConfirmationModal.html#module-features"},{"type":"module","title":"Usage - LightningWeb.AccountConfirmationModal","doc":"Include this component in your LiveView template where you need to prompt\nusers to confirm their account. The component determines whether the modal\nshould be shown based on the current view context.","ref":"LightningWeb.AccountConfirmationModal.html#module-usage"},{"type":"module","title":"Examples - LightningWeb.AccountConfirmationModal","doc":"<.live_component\n module={LightningWeb.AccountConfirmationModal}\n id=\"account-confirmation-modal\"\n current_user={@current_user}\n />\n\nThe component uses assigns to manage its state, including:\n\n- `:show_modal` - Determines if the modal should be visible.\n- `:email_sent` - Indicates if the confirmation email was successfully sent.","ref":"LightningWeb.AccountConfirmationModal.html#module-examples"},{"type":"module","title":"LightningWeb.AuditLive.Index","doc":"LiveView for listing Audit events","ref":"LightningWeb.AuditLive.Index.html"},{"type":"function","title":"LightningWeb.AuditLive.Index.diff/1","doc":"","ref":"LightningWeb.AuditLive.Index.html#diff/1"},{"type":"function","title":"LightningWeb.AuditLive.Index.render/1","doc":"","ref":"LightningWeb.AuditLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.AuthProvidersLive.FormComponent","doc":"Form Component for working with a single Job\n\nA Job's `adaptor` field is a combination of the module name and the version.\nIt's formatted as an NPM style string.\n\nThe form allows the user to select a module by name and then it's version,\nwhile the version dropdown itself references `adaptor` directly.\n\nMeaning the `adaptor_name` dropdown and assigns value is not persisted.","ref":"LightningWeb.AuthProvidersLive.FormComponent.html"},{"type":"module","title":"LightningWeb.AuthProvidersLive.Index","doc":"LiveView for listing and managing Projects","ref":"LightningWeb.AuthProvidersLive.Index.html"},{"type":"module","title":"LightningWeb.BackupCodesController","doc":"","ref":"LightningWeb.BackupCodesController.html"},{"type":"function","title":"LightningWeb.BackupCodesController.print/2","doc":"","ref":"LightningWeb.BackupCodesController.html#print/2"},{"type":"module","title":"LightningWeb.BackupCodesLive.Index","doc":"LiveView for user backup codes.","ref":"LightningWeb.BackupCodesLive.Index.html"},{"type":"function","title":"LightningWeb.BackupCodesLive.Index.render/1","doc":"","ref":"LightningWeb.BackupCodesLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.ChangesetJSON","doc":"Renders changesets as JSON.","ref":"LightningWeb.ChangesetJSON.html"},{"type":"function","title":"LightningWeb.ChangesetJSON.error/1","doc":"","ref":"LightningWeb.ChangesetJSON.html#error/1"},{"type":"module","title":"LightningWeb.ChangesetView","doc":"","ref":"LightningWeb.ChangesetView.html"},{"type":"function","title":"LightningWeb.ChangesetView.__resource__/0","doc":"The resource name, as an atom, for this view","ref":"LightningWeb.ChangesetView.html#__resource__/0"},{"type":"function","title":"LightningWeb.ChangesetView.render/2","doc":"Renders the given template locally.","ref":"LightningWeb.ChangesetView.html#render/2"},{"type":"function","title":"LightningWeb.ChangesetView.template_not_found/2","doc":"Callback invoked when no template is found.\nBy default it raises but can be customized\nto render a particular template.","ref":"LightningWeb.ChangesetView.html#template_not_found/2"},{"type":"module","title":"LightningWeb.ChannelHelpers","doc":"Helper functions for channels","ref":"LightningWeb.ChannelHelpers.html"},{"type":"function","title":"LightningWeb.ChannelHelpers.reply_with/2","doc":"","ref":"LightningWeb.ChannelHelpers.html#reply_with/2"},{"type":"module","title":"LightningWeb.CollectionLive.CollectionCreationModal","doc":"","ref":"LightningWeb.CollectionLive.CollectionCreationModal.html"},{"type":"module","title":"LightningWeb.CollectionLive.Components","doc":"","ref":"LightningWeb.CollectionLive.Components.html"},{"type":"function","title":"LightningWeb.CollectionLive.Components.collections_table/1","doc":"","ref":"LightningWeb.CollectionLive.Components.html#collections_table/1"},{"type":"module","title":"LightningWeb.CollectionLive.Index","doc":"","ref":"LightningWeb.CollectionLive.Index.html"},{"type":"module","title":"LightningWeb.CollectionsController","doc":"","ref":"LightningWeb.CollectionsController.html"},{"type":"function","title":"LightningWeb.CollectionsController.delete/2","doc":"","ref":"LightningWeb.CollectionsController.html#delete/2"},{"type":"function","title":"LightningWeb.CollectionsController.delete_all/2","doc":"","ref":"LightningWeb.CollectionsController.html#delete_all/2"},{"type":"function","title":"LightningWeb.CollectionsController.get/2","doc":"","ref":"LightningWeb.CollectionsController.html#get/2"},{"type":"function","title":"LightningWeb.CollectionsController.put/2","doc":"","ref":"LightningWeb.CollectionsController.html#put/2"},{"type":"function","title":"LightningWeb.CollectionsController.put_all/2","doc":"","ref":"LightningWeb.CollectionsController.html#put_all/2"},{"type":"function","title":"LightningWeb.CollectionsController.stream/2","doc":"","ref":"LightningWeb.CollectionsController.html#stream/2"},{"type":"module","title":"LightningWeb.CollectionsController.ChunkAcc","doc":"","ref":"LightningWeb.CollectionsController.ChunkAcc.html"},{"type":"module","title":"LightningWeb.Components.Loaders","doc":"UI component to render a pill to create tags.","ref":"LightningWeb.Components.Loaders.html"},{"type":"function","title":"LightningWeb.Components.Loaders.button_loader/1","doc":"","ref":"LightningWeb.Components.Loaders.html#button_loader/1"},{"type":"function","title":"Slots - LightningWeb.Components.Loaders.button_loader/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.Loaders.html#button_loader/1-slots"},{"type":"function","title":"LightningWeb.Components.Loaders.offline_indicator/1","doc":"","ref":"LightningWeb.Components.Loaders.html#offline_indicator/1"},{"type":"function","title":"LightningWeb.Components.Loaders.text_ping_loader/1","doc":"","ref":"LightningWeb.Components.Loaders.html#text_ping_loader/1"},{"type":"function","title":"Slots - LightningWeb.Components.Loaders.text_ping_loader/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.Loaders.html#text_ping_loader/1-slots"},{"type":"module","title":"LightningWeb.Components.Menu","doc":"Menu components to render menu items for project and user/profile pages.","ref":"LightningWeb.Components.Menu.html"},{"type":"function","title":"LightningWeb.Components.Menu.menu_item/1","doc":"","ref":"LightningWeb.Components.Menu.html#menu_item/1"},{"type":"function","title":"LightningWeb.Components.Menu.profile_items/1","doc":"","ref":"LightningWeb.Components.Menu.html#profile_items/1"},{"type":"function","title":"LightningWeb.Components.Menu.project_items/1","doc":"","ref":"LightningWeb.Components.Menu.html#project_items/1"},{"type":"module","title":"LightningWeb.Components.Modal","doc":"A modal component that can be used to display a modal on the page.\n\nThis currently isn't used anywhere but should be used in the future to\nreplace the existing modal implementations.","ref":"LightningWeb.Components.Modal.html"},{"type":"function","title":"LightningWeb.Components.Modal.hide_modal/2","doc":"","ref":"LightningWeb.Components.Modal.html#hide_modal/2"},{"type":"function","title":"LightningWeb.Components.Modal.modal/1","doc":"","ref":"LightningWeb.Components.Modal.html#modal/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Modal.modal/1","doc":"* `id` (`:string`) (required)\n* `show` (`:boolean`) - Defaults to `false`.\n* `with_frame` (`:boolean`) - Defaults to `true`.\n* `target` (`:any`) - Defaults to `nil`.\n* `position` (`:string`) - Defaults to `\"fixed inset-0\"`.\n* `width` (`:string`) - Defaults to `\"max-w-3xl\"`.\n* `close_on_click_away` (`:boolean`) - Defaults to `true`.\n* `close_on_keydown` (`:boolean`) - Defaults to `true`.\n* `on_close` (`Phoenix.LiveView.JS`) - Defaults to `%Phoenix.LiveView.JS{ops: []}`.\n* `on_open` (`Phoenix.LiveView.JS`) - Defaults to `%Phoenix.LiveView.JS{ops: []}`.\n* Global attributes are accepted.","ref":"LightningWeb.Components.Modal.html#modal/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.Modal.modal/1","doc":"* `inner_block` (required)\n* `title`\n* `subtitle`\n* `footer` - Accepts attributes:\n\n * `class` (`:string`)","ref":"LightningWeb.Components.Modal.html#modal/1-slots"},{"type":"function","title":"LightningWeb.Components.Modal.modal_footer/1","doc":"","ref":"LightningWeb.Components.Modal.html#modal_footer/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Modal.modal_footer/1","doc":"* `class` (`:any`) - Defaults to `\"\"`.","ref":"LightningWeb.Components.Modal.html#modal_footer/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.Modal.modal_footer/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.Modal.html#modal_footer/1-slots"},{"type":"function","title":"LightningWeb.Components.Modal.show_modal/2","doc":"","ref":"LightningWeb.Components.Modal.html#show_modal/2"},{"type":"module","title":"LightningWeb.Components.NewInputs","doc":"A temporary module that will serve as a place to put new inputs that conform\nwith the newer CoreComponents conventions introduced in Phoenix 1.7.","ref":"LightningWeb.Components.NewInputs.html"},{"type":"function","title":"LightningWeb.Components.NewInputs.button/1","doc":"Renders a button.","ref":"LightningWeb.Components.NewInputs.html#button/1"},{"type":"function","title":"Examples - LightningWeb.Components.NewInputs.button/1","doc":"<.button>Send!\n <.button phx-click=\"go\" class=\"ml-2\">Send!","ref":"LightningWeb.Components.NewInputs.html#button/1-examples"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.button/1","doc":"* `id` (`:string`) - Defaults to `\"\"`.\n* `type` (`:string`) - Defaults to `\"button\"`.\n* `class` (`:any`) - Defaults to `\"\"`.\n* `color_class` (`:any`) - Defaults to `\"bg-primary-600 hover:bg-primary-700 text-white focus:ring-primary-500 disabled:bg-primary-300\"`.\n* `tooltip` (`:any`) - Defaults to `nil`.\n* Global attributes are accepted. Supports all globals plus: `[\"disabled\", \"form\", \"name\", \"value\"]`.","ref":"LightningWeb.Components.NewInputs.html#button/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.NewInputs.button/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.NewInputs.html#button/1-slots"},{"type":"function","title":"LightningWeb.Components.NewInputs.checkbox_element/1","doc":"Renders a checkbox input element.\n\nThis function is used internally by `input/1` and generally should not\nbe used directly.\n\nLook at `input type=\"checkbox\"` to see how these values `attr` get populated","ref":"LightningWeb.Components.NewInputs.html#checkbox_element/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.checkbox_element/1","doc":"* `id` (`:string`) - Defaults to `nil`.\n* `name` (`:string`) (required)\n* `value` (`:any`) (required)\n* `class` (`:string`)\n* `checked` (`:boolean`) - the checked flag for checkbox inputs.\n* `checked_value` (`:any`) - Defaults to `\"true\"`.\n* `unchecked_value` (`:any`) - Defaults to `\"false\"`.\n* `hidden_input` (`:boolean`) - Defaults to `true`.\n* Global attributes are accepted. Supports all globals plus: `[\"disabled\", \"form\", \"readonly\", \"required\"]`.","ref":"LightningWeb.Components.NewInputs.html#checkbox_element/1-attributes"},{"type":"function","title":"LightningWeb.Components.NewInputs.error/1","doc":"Generates a generic error message.","ref":"LightningWeb.Components.NewInputs.html#error/1"},{"type":"function","title":"Slots - LightningWeb.Components.NewInputs.error/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.NewInputs.html#error/1-slots"},{"type":"function","title":"LightningWeb.Components.NewInputs.errors/1","doc":"Generic wrapper for rendering error messages in custom input components.","ref":"LightningWeb.Components.NewInputs.html#errors/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.errors/1","doc":"* `field` (`Phoenix.HTML.FormField`) (required)","ref":"LightningWeb.Components.NewInputs.html#errors/1-attributes"},{"type":"function","title":"LightningWeb.Components.NewInputs.form_hidden_inputs/1","doc":"Generates hidden inputs for a form.\nAdapted from [PhoenixHTMLHelpers.Form.html#hidden_inputs_for/1](https://github.com/phoenixframework/phoenix_html_helpers/blob/v1.0.1/lib/phoenix_html_helpers/form.ex#L406)","ref":"LightningWeb.Components.NewInputs.html#form_hidden_inputs/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.form_hidden_inputs/1","doc":"* `form` (`Phoenix.HTML.Form`) (required)","ref":"LightningWeb.Components.NewInputs.html#form_hidden_inputs/1-attributes"},{"type":"function","title":"LightningWeb.Components.NewInputs.input/1","doc":"Renders an input with label and error messages.\n\nA `Phoenix.HTML.FormField` may be passed as argument,\nwhich is used to retrieve the input name, id, and values.\nOtherwise all attributes may be passed explicitly.","ref":"LightningWeb.Components.NewInputs.html#input/1"},{"type":"function","title":"Types - LightningWeb.Components.NewInputs.input/1","doc":"This function accepts all HTML input types, considering that:\n\n * You may also set `type=\"select\"` to render a ` ` tag\n\n * `type=\"checkbox\"` is used exclusively to render boolean values\n\n * For live file uploads, see `Phoenix.Component.live_file_input/1`\n\nSee https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input\nfor more information.","ref":"LightningWeb.Components.NewInputs.html#input/1-types"},{"type":"function","title":"Examples - LightningWeb.Components.NewInputs.input/1","doc":"<.input field={@form[:email]} type=\"email\" />\n <.input name=\"my-input\" errors={[\"oh no!\"]} />","ref":"LightningWeb.Components.NewInputs.html#input/1-examples"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.input/1","doc":"* `id` (`:any`) - Defaults to `nil`.\n* `name` (`:any`)\n* `label` (`:string`) - Defaults to `nil`.\n* `value` (`:any`)\n* `type` (`:string`) - Defaults to `\"text\"`.\n* `field` (`Phoenix.HTML.FormField`) - a form field struct retrieved from the form, for example: @form[:email].\n* `errors` (`:list`) - Defaults to `[]`.\n* `checked` (`:boolean`) - the checked flag for checkbox/radio inputs.\n* `checked_value` (`:any`) - the value to be sent when the checkbox is checked. Defaults to 'true'. Defaults to `\"true\"`.\n* `unchecked_value` (`:any`) - the value to be sent when the checkbox is unchecked, Defaults to 'false'. Defaults to `\"false\"`.\n* `hidden_input` (`:boolean`) - controls if this function will generate a hidden input to submit the unchecked value or not. Defaults to 'true'. Defaults to `true`.\n* `prompt` (`:string`) - the prompt for select inputs. Defaults to `nil`.\n* `options` (`:list`) - the options to pass to Phoenix.HTML.Form.options_for_select/2.\n* `multiple` (`:boolean`) - the multiple flag for select inputs. Defaults to `false`.\n* `button_placement` (`:string`) - Defaults to `nil`.\n* `class` (`:string`) - Defaults to `\"\"`.\n* `stretch` (`:boolean`) - control the wrapping div classes of some components like the textarea. Defaults to `false`.\n* `display_errors` (`:boolean`) - Defaults to `true`.\n* `tooltip` (`:any`) - Defaults to `nil`.\n* Global attributes are accepted. Supports all globals plus: `[\"accept\", \"autocomplete\", \"capture\", \"cols\", \"disabled\", \"form\", \"list\", \"max\", \"maxlength\", \"min\", \"minlength\", \"multiple\", \"pattern\", \"placeholder\", \"readonly\", \"required\", \"rows\", \"size\", \"step\"]`.","ref":"LightningWeb.Components.NewInputs.html#input/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.NewInputs.input/1","doc":"* `inner_block`","ref":"LightningWeb.Components.NewInputs.html#input/1-slots"},{"type":"function","title":"LightningWeb.Components.NewInputs.input_element/1","doc":"Renders an input element.\n\nThis function is used internally by `input/1` and generally should not\nbe used directly.\n\nIn the case of inputs that are different enough to warrant a new function,\nthis component can be used to maintain style consistency.","ref":"LightningWeb.Components.NewInputs.html#input_element/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.input_element/1","doc":"* `id` (`:string`) - Defaults to `nil`.\n* `name` (`:string`) (required)\n* `type` (`:string`) (required)\n* `value` (`:any`)\n* `errors` (`:list`) - Defaults to `[]`.\n* `class` (`:string`) - Defaults to `\"\"`.\n* Global attributes are accepted. Supports all globals plus: `[\"accept\", \"autocomplete\", \"capture\", \"cols\", \"disabled\", \"form\", \"list\", \"max\", \"maxlength\", \"min\", \"minlength\", \"multiple\", \"pattern\", \"placeholder\", \"readonly\", \"required\", \"rows\", \"size\", \"step\"]`.","ref":"LightningWeb.Components.NewInputs.html#input_element/1-attributes"},{"type":"function","title":"LightningWeb.Components.NewInputs.label/1","doc":"Renders a label.","ref":"LightningWeb.Components.NewInputs.html#label/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.label/1","doc":"* `for` (`:any`) - Defaults to `nil`.\n* `class` (`:any`) - Defaults to `\"\"`.\n* Global attributes are accepted.","ref":"LightningWeb.Components.NewInputs.html#label/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.NewInputs.label/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.NewInputs.html#label/1-slots"},{"type":"module","title":"LightningWeb.Components.Pills","doc":"UI component to render a pill to create tags.","ref":"LightningWeb.Components.Pills.html"},{"type":"function","title":"LightningWeb.Components.Pills.pill/1","doc":"","ref":"LightningWeb.Components.Pills.html#pill/1"},{"type":"function","title":"Slots - LightningWeb.Components.Pills.pill/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.Pills.html#pill/1-slots"},{"type":"module","title":"LightningWeb.Components.Viewers","doc":"Components for rendering Logs and Dataclips.\n\n> #### Scrolling can be tricky {: .info}\n>\n> We seldom know how long a log or a dataclip will be, and we want to\n> be able to contain the element in a fixed height container.\n> In some situations wrapping the component in a `div` with `inline-flex`\n> class will help with scrolling.","ref":"LightningWeb.Components.Viewers.html"},{"type":"function","title":"LightningWeb.Components.Viewers.dataclip_viewer/1","doc":"","ref":"LightningWeb.Components.Viewers.html#dataclip_viewer/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Viewers.dataclip_viewer/1","doc":"* `id` (`:string`) (required)\n* `dataclip` (`:map`) (required)","ref":"LightningWeb.Components.Viewers.html#dataclip_viewer/1-attributes"},{"type":"function","title":"LightningWeb.Components.Viewers.log_viewer/1","doc":"Renders out a log line stream\n\nInternally it uses the `LogLineHighlight` hook to highlight the log line\nwith the `highlight_id` attribute.","ref":"LightningWeb.Components.Viewers.html#log_viewer/1"},{"type":"function","title":"Example - LightningWeb.Components.Viewers.log_viewer/1","doc":"","ref":"LightningWeb.Components.Viewers.html#log_viewer/1-example"},{"type":"function","title":"Attributes - LightningWeb.Components.Viewers.log_viewer/1","doc":"* `id` (`:string`) (required)\n* `run_id` (`:string`) (required)\n* `run_state` (`:any`) (required)\n* `logs_empty?` (`:boolean`) (required)\n* `selected_step_id` (`:string`)\n* `class` (`:string`) - Additional classes to add to the log viewer container. Defaults to `nil`.","ref":"LightningWeb.Components.Viewers.html#log_viewer/1-attributes"},{"type":"function","title":"LightningWeb.Components.Viewers.step_dataclip_viewer/1","doc":"","ref":"LightningWeb.Components.Viewers.html#step_dataclip_viewer/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Viewers.step_dataclip_viewer/1","doc":"* `id` (`:string`) (required)\n* `run_state` (`:any`) (required)\n* `class` (`:string`) - Additional classes to add to the log viewer container. Defaults to `nil`.\n* `step` (`:map`)\n* `dataclip` (`Lightning.Invocation.Dataclip`)\n* `input_or_output` (`:atom`) (required) - Must be one of `:input`, or `:output`.\n* `project_id` (`:string`) (required)\n* `admin_contacts` (`:list`) (required) - list of project admin emails.\n* `can_edit_data_retention` (`:boolean`) (required)","ref":"LightningWeb.Components.Viewers.html#step_dataclip_viewer/1-attributes"},{"type":"function","title":"LightningWeb.Components.Viewers.wiped_dataclip_viewer/1","doc":"","ref":"LightningWeb.Components.Viewers.html#wiped_dataclip_viewer/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Viewers.wiped_dataclip_viewer/1","doc":"* `id` (`:string`) - Defaults to `nil`.\n* `input_or_output` (`:atom`) (required) - Must be one of `:input`, or `:output`.\n* `project_id` (`:string`) (required)\n* `admin_contacts` (`:list`) (required) - list of project admin emails.\n* `can_edit_data_retention` (`:boolean`) (required)","ref":"LightningWeb.Components.Viewers.html#wiped_dataclip_viewer/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.Viewers.wiped_dataclip_viewer/1","doc":"* `footer`","ref":"LightningWeb.Components.Viewers.html#wiped_dataclip_viewer/1-slots"},{"type":"module","title":"LightningWeb.CredentialLive.CredentialFormComponent","doc":"Form Component for working with a single Credential","ref":"LightningWeb.CredentialLive.CredentialFormComponent.html"},{"type":"module","title":"LightningWeb.CredentialLive.GenericOauthComponent","doc":"","ref":"LightningWeb.CredentialLive.GenericOauthComponent.html"},{"type":"module","title":"LightningWeb.CredentialLive.Helpers","doc":"This module provides helper functions for managing project associations\nwithin credential live views, allowing dynamic assignment and update\nof projects associations to credentials and / or oauth clients.","ref":"LightningWeb.CredentialLive.Helpers.html"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.filter_available_projects/2","doc":"Filters available projects to exclude any that are already selected.","ref":"LightningWeb.CredentialLive.Helpers.html#filter_available_projects/2"},{"type":"function","title":"Parameters - LightningWeb.CredentialLive.Helpers.filter_available_projects/2","doc":"- `all_projects`: A list of all projects.\n- `selected_projects`: A list of currently selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#filter_available_projects/2-parameters"},{"type":"function","title":"Returns - LightningWeb.CredentialLive.Helpers.filter_available_projects/2","doc":"- A list of projects that are not selected.","ref":"LightningWeb.CredentialLive.Helpers.html#filter_available_projects/2-returns"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.handle_save_response/2","doc":"","ref":"LightningWeb.CredentialLive.Helpers.html#handle_save_response/2"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.prepare_projects_associations/3","doc":"Prepares a list of projects to be associated, updated, or removed based on the selected input.","ref":"LightningWeb.CredentialLive.Helpers.html#prepare_projects_associations/3"},{"type":"function","title":"Parameters - LightningWeb.CredentialLive.Helpers.prepare_projects_associations/3","doc":"- `changeset`: The changeset from which projects are fetched.\n- `selected_projects`: A list of currently selected projects.\n- `assoc_key`: The key in the changeset data containing project associations.","ref":"LightningWeb.CredentialLive.Helpers.html#prepare_projects_associations/3-parameters"},{"type":"function","title":"Returns - LightningWeb.CredentialLive.Helpers.prepare_projects_associations/3","doc":"- A list of maps representing the projects to be deleted, added, or kept.","ref":"LightningWeb.CredentialLive.Helpers.html#prepare_projects_associations/3-returns"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.select_project/4","doc":"Selects a project to be added to the list of selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#select_project/4"},{"type":"function","title":"Parameters - LightningWeb.CredentialLive.Helpers.select_project/4","doc":"- `project_id`: The ID of the project to select.\n- `projects`: All available projects.\n- `available_projects`: Projects that are available for selection.\n- `selected_projects`: Currently selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#select_project/4-parameters"},{"type":"function","title":"Returns - LightningWeb.CredentialLive.Helpers.select_project/4","doc":"- A map with the updated lists of selected and available projects.","ref":"LightningWeb.CredentialLive.Helpers.html#select_project/4-returns"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.unselect_project/3","doc":"Unselects a project from the list of selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#unselect_project/3"},{"type":"function","title":"Parameters - LightningWeb.CredentialLive.Helpers.unselect_project/3","doc":"- `project_id`: The ID of the project to unselect.\n- `projects`: All projects available.\n- `selected_projects`: Currently selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#unselect_project/3-parameters"},{"type":"function","title":"Returns - LightningWeb.CredentialLive.Helpers.unselect_project/3","doc":"- A map with the updated lists of selected and available projects.","ref":"LightningWeb.CredentialLive.Helpers.html#unselect_project/3-returns"},{"type":"module","title":"LightningWeb.CredentialLive.Index","doc":"LiveView for listing and managing credentials","ref":"LightningWeb.CredentialLive.Index.html"},{"type":"function","title":"LightningWeb.CredentialLive.Index.delete_action/1","doc":"","ref":"LightningWeb.CredentialLive.Index.html#delete_action/1"},{"type":"function","title":"LightningWeb.CredentialLive.Index.handle_info/2","doc":"A generic handler for forwarding updates from PubSub","ref":"LightningWeb.CredentialLive.Index.html#handle_info/2"},{"type":"function","title":"LightningWeb.CredentialLive.Index.render/1","doc":"","ref":"LightningWeb.CredentialLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.CredentialLive.JsonSchemaBodyComponent","doc":"","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html"},{"type":"function","title":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.fieldset/1","doc":"","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#fieldset/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.JsonSchemaBodyComponent.fieldset/1","doc":"* `form` (`:map`) (required)","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#fieldset/1-attributes"},{"type":"function","title":"Slots - LightningWeb.CredentialLive.JsonSchemaBodyComponent.fieldset/1","doc":"* `inner_block`","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#fieldset/1-slots"},{"type":"function","title":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.schema_input/1","doc":"","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#schema_input/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.JsonSchemaBodyComponent.schema_input/1","doc":"* `form` (`:map`) (required)\n* `schema` (`:map`) (required)\n* `field` (`:any`) (required)","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#schema_input/1-attributes"},{"type":"module","title":"LightningWeb.CredentialLive.OauthClientFormComponent","doc":"Form Component for working with a single Credential","ref":"LightningWeb.CredentialLive.OauthClientFormComponent.html"},{"type":"function","title":"LightningWeb.CredentialLive.OauthClientFormComponent.global_client_checkbox/1","doc":"","ref":"LightningWeb.CredentialLive.OauthClientFormComponent.html#global_client_checkbox/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.OauthClientFormComponent.global_client_checkbox/1","doc":"* `form` (`:any`) (required)","ref":"LightningWeb.CredentialLive.OauthClientFormComponent.html#global_client_checkbox/1-attributes"},{"type":"module","title":"LightningWeb.CredentialLive.OauthComponent","doc":"","ref":"LightningWeb.CredentialLive.OauthComponent.html"},{"type":"function","title":"LightningWeb.CredentialLive.OauthComponent.fieldset/1","doc":"","ref":"LightningWeb.CredentialLive.OauthComponent.html#fieldset/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.OauthComponent.fieldset/1","doc":"* `form` (`:map`) (required)\n* `id` (`:string`) (required)\n* `update_body` (`:any`) (required)\n* `action` (`:any`) (required)\n* `scopes_changed` (`:boolean`) - Defaults to `false`.\n* `sandbox_changed` (`:boolean`) - Defaults to `false`.\n* `schema` (`:string`) (required)","ref":"LightningWeb.CredentialLive.OauthComponent.html#fieldset/1-attributes"},{"type":"function","title":"Slots - LightningWeb.CredentialLive.OauthComponent.fieldset/1","doc":"* `inner_block`","ref":"LightningWeb.CredentialLive.OauthComponent.html#fieldset/1-slots"},{"type":"module","title":"LightningWeb.CredentialLive.RawBodyComponent","doc":"","ref":"LightningWeb.CredentialLive.RawBodyComponent.html"},{"type":"function","title":"LightningWeb.CredentialLive.RawBodyComponent.fieldset/1","doc":"","ref":"LightningWeb.CredentialLive.RawBodyComponent.html#fieldset/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.RawBodyComponent.fieldset/1","doc":"* `form` (`:map`) (required)","ref":"LightningWeb.CredentialLive.RawBodyComponent.html#fieldset/1-attributes"},{"type":"function","title":"Slots - LightningWeb.CredentialLive.RawBodyComponent.fieldset/1","doc":"* `inner_block`","ref":"LightningWeb.CredentialLive.RawBodyComponent.html#fieldset/1-slots"},{"type":"module","title":"LightningWeb.DashboardLive.Components","doc":"","ref":"LightningWeb.DashboardLive.Components.html"},{"type":"function","title":"LightningWeb.DashboardLive.Components.user_projects_table/1","doc":"","ref":"LightningWeb.DashboardLive.Components.html#user_projects_table/1"},{"type":"function","title":"LightningWeb.DashboardLive.Components.welcome_banner/1","doc":"","ref":"LightningWeb.DashboardLive.Components.html#welcome_banner/1"},{"type":"module","title":"LightningWeb.DashboardLive.Index","doc":"","ref":"LightningWeb.DashboardLive.Index.html"},{"type":"module","title":"LightningWeb.DashboardLive.ProjectCreationModal","doc":"","ref":"LightningWeb.DashboardLive.ProjectCreationModal.html"},{"type":"module","title":"LightningWeb.DashboardLive.UserProjectsSection","doc":"","ref":"LightningWeb.DashboardLive.UserProjectsSection.html"},{"type":"module","title":"LightningWeb.DashboardLive.WelcomeSection","doc":"","ref":"LightningWeb.DashboardLive.WelcomeSection.html"},{"type":"module","title":"LightningWeb.DataclipController","doc":"","ref":"LightningWeb.DataclipController.html"},{"type":"function","title":"LightningWeb.DataclipController.show/2","doc":"","ref":"LightningWeb.DataclipController.html#show/2"},{"type":"module","title":"LightningWeb.DataclipLive.FormComponent","doc":"Form Component for working with a single dataclip","ref":"LightningWeb.DataclipLive.FormComponent.html"},{"type":"function","title":"LightningWeb.DataclipLive.FormComponent.render/1","doc":"","ref":"LightningWeb.DataclipLive.FormComponent.html#render/1"},{"type":"module","title":"LightningWeb.DataclipLive.Show","doc":"LiveView for showing a single dataclip.","ref":"LightningWeb.DataclipLive.Show.html"},{"type":"module","title":"LightningWeb.DownloadsController","doc":"","ref":"LightningWeb.DownloadsController.html"},{"type":"function","title":"LightningWeb.DownloadsController.download_project_yaml/2","doc":"","ref":"LightningWeb.DownloadsController.html#download_project_yaml/2"},{"type":"module","title":"LightningWeb.Endpoint","doc":"","ref":"LightningWeb.Endpoint.html"},{"type":"function","title":"LightningWeb.Endpoint.broadcast/3","doc":"","ref":"LightningWeb.Endpoint.html#broadcast/3"},{"type":"function","title":"LightningWeb.Endpoint.broadcast!/3","doc":"","ref":"LightningWeb.Endpoint.html#broadcast!/3"},{"type":"function","title":"LightningWeb.Endpoint.broadcast_from/4","doc":"","ref":"LightningWeb.Endpoint.html#broadcast_from/4"},{"type":"function","title":"LightningWeb.Endpoint.broadcast_from!/4","doc":"","ref":"LightningWeb.Endpoint.html#broadcast_from!/4"},{"type":"function","title":"LightningWeb.Endpoint.call/2","doc":"","ref":"LightningWeb.Endpoint.html#call/2"},{"type":"function","title":"LightningWeb.Endpoint.child_spec/1","doc":"Returns the child specification to start the endpoint\nunder a supervision tree.","ref":"LightningWeb.Endpoint.html#child_spec/1"},{"type":"function","title":"LightningWeb.Endpoint.config/2","doc":"Returns the endpoint configuration for `key`\n\nReturns `default` if the key does not exist.","ref":"LightningWeb.Endpoint.html#config/2"},{"type":"function","title":"LightningWeb.Endpoint.config_change/2","doc":"Reloads the configuration given the application environment changes.","ref":"LightningWeb.Endpoint.html#config_change/2"},{"type":"function","title":"LightningWeb.Endpoint.host/0","doc":"Returns the host for the given endpoint.","ref":"LightningWeb.Endpoint.html#host/0"},{"type":"function","title":"LightningWeb.Endpoint.init/1","doc":"","ref":"LightningWeb.Endpoint.html#init/1"},{"type":"function","title":"LightningWeb.Endpoint.local_broadcast/3","doc":"","ref":"LightningWeb.Endpoint.html#local_broadcast/3"},{"type":"function","title":"LightningWeb.Endpoint.local_broadcast_from/4","doc":"","ref":"LightningWeb.Endpoint.html#local_broadcast_from/4"},{"type":"function","title":"LightningWeb.Endpoint.path/1","doc":"Generates the path information when routing to this endpoint.","ref":"LightningWeb.Endpoint.html#path/1"},{"type":"function","title":"LightningWeb.Endpoint.script_name/0","doc":"Generates the script name.","ref":"LightningWeb.Endpoint.html#script_name/0"},{"type":"function","title":"LightningWeb.Endpoint.server_info/1","doc":"Returns the address and port that the server is running on","ref":"LightningWeb.Endpoint.html#server_info/1"},{"type":"function","title":"LightningWeb.Endpoint.start_link/1","doc":"Starts the endpoint supervision tree.\n\nAll other options are merged into the endpoint configuration.","ref":"LightningWeb.Endpoint.html#start_link/1"},{"type":"function","title":"LightningWeb.Endpoint.static_integrity/1","doc":"Generates a base64-encoded cryptographic hash (sha512) to a static file\nin `priv/static`. Meant to be used for Subresource Integrity with CDNs.","ref":"LightningWeb.Endpoint.html#static_integrity/1"},{"type":"function","title":"LightningWeb.Endpoint.static_lookup/1","doc":"Returns a two item tuple with the first item being the `static_path`\nand the second item being the `static_integrity`.","ref":"LightningWeb.Endpoint.html#static_lookup/1"},{"type":"function","title":"LightningWeb.Endpoint.static_path/1","doc":"Generates a route to a static file in `priv/static`.","ref":"LightningWeb.Endpoint.html#static_path/1"},{"type":"function","title":"LightningWeb.Endpoint.static_url/0","doc":"Generates the static URL without any path information.\n\nIt uses the configuration under `:static_url` to generate\nsuch. It falls back to `:url` if `:static_url` is not set.","ref":"LightningWeb.Endpoint.html#static_url/0"},{"type":"function","title":"LightningWeb.Endpoint.struct_url/0","doc":"Generates the endpoint base URL but as a `URI` struct.\n\nIt uses the configuration under `:url` to generate such.\nUseful for manipulating the URL data and passing it to\nURL helpers.","ref":"LightningWeb.Endpoint.html#struct_url/0"},{"type":"function","title":"LightningWeb.Endpoint.subscribe/2","doc":"","ref":"LightningWeb.Endpoint.html#subscribe/2"},{"type":"function","title":"LightningWeb.Endpoint.unsubscribe/1","doc":"","ref":"LightningWeb.Endpoint.html#unsubscribe/1"},{"type":"function","title":"LightningWeb.Endpoint.url/0","doc":"Generates the endpoint base URL without any path information.\n\nIt uses the configuration under `:url` to generate such.","ref":"LightningWeb.Endpoint.html#url/0"},{"type":"module","title":"LightningWeb.FallbackController","doc":"Translates controller action results into valid `Plug.Conn` responses.\n\nSee `Phoenix.Controller.action_fallback/1` for more details.","ref":"LightningWeb.FallbackController.html"},{"type":"module","title":"LightningWeb.FirstSetupLive.Superuser","doc":"Superuser setup liveview\n\nAllows the creation on the first user in the system.\n\nIt has only one action: `:show`","ref":"LightningWeb.FirstSetupLive.Superuser.html"},{"type":"function","title":"LightningWeb.FirstSetupLive.Superuser.render/1","doc":"","ref":"LightningWeb.FirstSetupLive.Superuser.html#render/1"},{"type":"module","title":"LightningWeb.FormHelpers","doc":"Conveniences for building forms.","ref":"LightningWeb.FormHelpers.html"},{"type":"module","title":"LightningWeb.Gettext","doc":"A module providing Internationalization with a gettext-based API.\n\nBy using [Gettext](https://hexdocs.pm/gettext),\nyour module gains a set of macros for translations, for example:\n\n import LightningWeb.Gettext\n\n # Simple translation\n gettext(\"Here is the string to translate\")\n\n # Plural translation\n ngettext(\"Here is the string to translate\",\n \"Here are the strings to translate\",\n 3)\n\n # Domain-based translation\n dgettext(\"errors\", \"Here is the error message to translate\")\n\nSee the [Gettext Docs](https://hexdocs.pm/gettext) for detailed usage.","ref":"LightningWeb.Gettext.html"},{"type":"macro","title":"LightningWeb.Gettext.dgettext/3","doc":"","ref":"LightningWeb.Gettext.html#dgettext/3"},{"type":"macro","title":"LightningWeb.Gettext.dgettext_noop/2","doc":"","ref":"LightningWeb.Gettext.html#dgettext_noop/2"},{"type":"macro","title":"LightningWeb.Gettext.dngettext/5","doc":"","ref":"LightningWeb.Gettext.html#dngettext/5"},{"type":"macro","title":"LightningWeb.Gettext.dngettext_noop/3","doc":"","ref":"LightningWeb.Gettext.html#dngettext_noop/3"},{"type":"macro","title":"LightningWeb.Gettext.dpgettext/4","doc":"","ref":"LightningWeb.Gettext.html#dpgettext/4"},{"type":"macro","title":"LightningWeb.Gettext.dpgettext_noop/3","doc":"","ref":"LightningWeb.Gettext.html#dpgettext_noop/3"},{"type":"macro","title":"LightningWeb.Gettext.dpngettext/6","doc":"","ref":"LightningWeb.Gettext.html#dpngettext/6"},{"type":"macro","title":"LightningWeb.Gettext.dpngettext_noop/4","doc":"","ref":"LightningWeb.Gettext.html#dpngettext_noop/4"},{"type":"macro","title":"LightningWeb.Gettext.gettext/2","doc":"","ref":"LightningWeb.Gettext.html#gettext/2"},{"type":"macro","title":"LightningWeb.Gettext.gettext_comment/1","doc":"","ref":"LightningWeb.Gettext.html#gettext_comment/1"},{"type":"macro","title":"LightningWeb.Gettext.gettext_noop/1","doc":"","ref":"LightningWeb.Gettext.html#gettext_noop/1"},{"type":"function","title":"LightningWeb.Gettext.handle_missing_bindings/2","doc":"","ref":"LightningWeb.Gettext.html#handle_missing_bindings/2"},{"type":"function","title":"LightningWeb.Gettext.handle_missing_plural_translation/7","doc":"","ref":"LightningWeb.Gettext.html#handle_missing_plural_translation/7"},{"type":"function","title":"LightningWeb.Gettext.handle_missing_translation/5","doc":"","ref":"LightningWeb.Gettext.html#handle_missing_translation/5"},{"type":"function","title":"LightningWeb.Gettext.lgettext/5","doc":"","ref":"LightningWeb.Gettext.html#lgettext/5"},{"type":"function","title":"LightningWeb.Gettext.lngettext/7","doc":"","ref":"LightningWeb.Gettext.html#lngettext/7"},{"type":"macro","title":"LightningWeb.Gettext.ngettext/4","doc":"","ref":"LightningWeb.Gettext.html#ngettext/4"},{"type":"macro","title":"LightningWeb.Gettext.ngettext_noop/2","doc":"","ref":"LightningWeb.Gettext.html#ngettext_noop/2"},{"type":"macro","title":"LightningWeb.Gettext.pgettext/3","doc":"","ref":"LightningWeb.Gettext.html#pgettext/3"},{"type":"macro","title":"LightningWeb.Gettext.pgettext_noop/2","doc":"","ref":"LightningWeb.Gettext.html#pgettext_noop/2"},{"type":"macro","title":"LightningWeb.Gettext.pngettext/5","doc":"","ref":"LightningWeb.Gettext.html#pngettext/5"},{"type":"macro","title":"LightningWeb.Gettext.pngettext_noop/3","doc":"","ref":"LightningWeb.Gettext.html#pngettext_noop/3"},{"type":"module","title":"LightningWeb.HealthCheck","doc":"","ref":"LightningWeb.HealthCheck.html"},{"type":"function","title":"LightningWeb.HealthCheck.call/2","doc":"","ref":"LightningWeb.HealthCheck.html#call/2"},{"type":"function","title":"LightningWeb.HealthCheck.init/1","doc":"","ref":"LightningWeb.HealthCheck.html#init/1"},{"type":"module","title":"LightningWeb.Hooks","doc":"LiveView Hooks","ref":"LightningWeb.Hooks.html"},{"type":"function","title":"LightningWeb.Hooks.on_mount/4","doc":"Finds and assigns a project to the socket, if a user doesn't have access\nthey are redirected and shown a 'No Access' screen via a `:nav` flash message.\n\nThere is a fallthru function, when there is no `project_id` in the params -\nthis is for liveviews that may or may not have a `project_id` depending on\nusage - like `DashboardLive`.","ref":"LightningWeb.Hooks.html#on_mount/4"},{"type":"module","title":"LightningWeb.InitAssigns","doc":"Ensures common `assigns` are applied to all LiveViews attaching this hook.","ref":"LightningWeb.InitAssigns.html"},{"type":"function","title":"LightningWeb.InitAssigns.on_mount/4","doc":"","ref":"LightningWeb.InitAssigns.html#on_mount/4"},{"type":"module","title":"LightningWeb.JobLive.AdaptorPicker","doc":"Component allowing selecting an adaptor and it's version","ref":"LightningWeb.JobLive.AdaptorPicker.html"},{"type":"function","title":"LightningWeb.JobLive.AdaptorPicker.display_name_for_adaptor/1","doc":"Converts standard adaptor names into \"label\",\"value\" lists and returns\nnon-standard names as merely \"value\"; both can be passed directly into a\nselect option list.","ref":"LightningWeb.JobLive.AdaptorPicker.html#display_name_for_adaptor/1"},{"type":"function","title":"LightningWeb.JobLive.AdaptorPicker.get_adaptor_version_options/1","doc":"","ref":"LightningWeb.JobLive.AdaptorPicker.html#get_adaptor_version_options/1"},{"type":"function","title":"LightningWeb.JobLive.AdaptorPicker.render/1","doc":"","ref":"LightningWeb.JobLive.AdaptorPicker.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.AdaptorPicker.render/1","doc":"* `form` (`:map`) (required)\n* `on_change` (`:any`) - Defaults to `nil`.\n* `disabled` (`:boolean`) - Defaults to `false`.","ref":"LightningWeb.JobLive.AdaptorPicker.html#render/1-attributes"},{"type":"module","title":"LightningWeb.JobLive.CredentialPicker","doc":"Component allowing selecting a credential or creating a new one via a\nmodal.","ref":"LightningWeb.JobLive.CredentialPicker.html"},{"type":"function","title":"LightningWeb.JobLive.CredentialPicker.render/1","doc":"","ref":"LightningWeb.JobLive.CredentialPicker.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.CredentialPicker.render/1","doc":"* `form` (`:map`) (required)\n* `disabled` (`:boolean`) - Defaults to `false`.\n* `credentials` (`:list`) (required)\n* `on_change` (`:any`) - Defaults to `nil`.","ref":"LightningWeb.JobLive.CredentialPicker.html#render/1-attributes"},{"type":"module","title":"LightningWeb.JobLive.CronSetupComponent","doc":"A live component for managing cron setup in a form.\n\nThe `CronSetupComponent` provides an interactive form for configuring cron settings. It includes fields for specifying the frequency, minute, hour, weekday, monthday, and cron expression.","ref":"LightningWeb.JobLive.CronSetupComponent.html"},{"type":"module","title":"Usage - LightningWeb.JobLive.CronSetupComponent","doc":"1. Include the `CronSetupComponent` in your live view or template.\n2. Pass the necessary assigns to the component, such as `form`, `on_change`, and `disabled`.\n3. Handle the `cron_expression_change` event to capture changes in the form inputs.\n4. Use the updated `cron_expression` in your application logic.","ref":"LightningWeb.JobLive.CronSetupComponent.html#module-usage"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.build_cron_expression/2","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#build_cron_expression/2"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.frequency_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#frequency_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.get_cron_data/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#get_cron_data/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.hour_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#hour_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.minute_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#minute_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.monthday_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#monthday_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.render/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.CronSetupComponent.render/1","doc":"* `id` (`:string`) (required)\n* `form` (`:map`) (required)\n* `on_change` (`:any`) (required)\n* `disabled` (`:boolean`) (required)","ref":"LightningWeb.JobLive.CronSetupComponent.html#render/1-attributes"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.time_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#time_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.weekday_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#weekday_field/1"},{"type":"module","title":"LightningWeb.JobLive.JobBuilderComponents","doc":"","ref":"LightningWeb.JobLive.JobBuilderComponents.html"},{"type":"function","title":"LightningWeb.JobLive.JobBuilderComponents.job_editor_component/1","doc":"","ref":"LightningWeb.JobLive.JobBuilderComponents.html#job_editor_component/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.JobBuilderComponents.job_editor_component/1","doc":"* `adaptor` (`:string`) (required)\n* `change_event` (`:string`) - Defaults to `\"job_body_changed\"`.\n* `disabled` (`:boolean`) - Defaults to `false`.\n* `disabled_message` (`:string`) (required)\n* `job_id` (`:string`) (required)\n* `source` (`:string`) (required)\n* Global attributes are accepted.","ref":"LightningWeb.JobLive.JobBuilderComponents.html#job_editor_component/1-attributes"},{"type":"module","title":"LightningWeb.JobLive.KafkaSetupComponent","doc":"","ref":"LightningWeb.JobLive.KafkaSetupComponent.html"},{"type":"function","title":"LightningWeb.JobLive.KafkaSetupComponent.render/1","doc":"","ref":"LightningWeb.JobLive.KafkaSetupComponent.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.KafkaSetupComponent.render/1","doc":"* `id` (`:string`) (required)\n* `form` (`:map`) (required)\n* `disabled` (`:boolean`) (required)","ref":"LightningWeb.JobLive.KafkaSetupComponent.html#render/1-attributes"},{"type":"module","title":"LightningWeb.LiveHelpers","doc":"General purpose LiveView helper functions","ref":"LightningWeb.LiveHelpers.html"},{"type":"function","title":"LightningWeb.LiveHelpers.check_limits/2","doc":"","ref":"LightningWeb.LiveHelpers.html#check_limits/2"},{"type":"function","title":"LightningWeb.LiveHelpers.display_short_uuid/1","doc":"","ref":"LightningWeb.LiveHelpers.html#display_short_uuid/1"},{"type":"function","title":"LightningWeb.LiveHelpers.fade_in/1","doc":"","ref":"LightningWeb.LiveHelpers.html#fade_in/1"},{"type":"function","title":"LightningWeb.LiveHelpers.fade_out/1","doc":"","ref":"LightningWeb.LiveHelpers.html#fade_out/1"},{"type":"function","title":"LightningWeb.LiveHelpers.live_error_block/1","doc":"","ref":"LightningWeb.LiveHelpers.html#live_error_block/1"},{"type":"function","title":"Attributes - LightningWeb.LiveHelpers.live_error_block/1","doc":"* `flash` (`:map`) (required)\n* `myself` (`:string`) - Defaults to `nil`.","ref":"LightningWeb.LiveHelpers.html#live_error_block/1-attributes"},{"type":"function","title":"LightningWeb.LiveHelpers.live_info_block/1","doc":"","ref":"LightningWeb.LiveHelpers.html#live_info_block/1"},{"type":"function","title":"Attributes - LightningWeb.LiveHelpers.live_info_block/1","doc":"* `flash` (`:map`) (required)\n* `myself` (`:string`) - Defaults to `nil`.","ref":"LightningWeb.LiveHelpers.html#live_info_block/1-attributes"},{"type":"function","title":"LightningWeb.LiveHelpers.live_nav_block/1","doc":"","ref":"LightningWeb.LiveHelpers.html#live_nav_block/1"},{"type":"function","title":"Attributes - LightningWeb.LiveHelpers.live_nav_block/1","doc":"* `flash` (`:map`) (required)","ref":"LightningWeb.LiveHelpers.html#live_nav_block/1-attributes"},{"type":"function","title":"Slots - LightningWeb.LiveHelpers.live_nav_block/1","doc":"* `inner_block`","ref":"LightningWeb.LiveHelpers.html#live_nav_block/1-slots"},{"type":"function","title":"LightningWeb.LiveHelpers.upcase_first/1","doc":"","ref":"LightningWeb.LiveHelpers.html#upcase_first/1"},{"type":"module","title":"LightningWeb.ModalPortal","doc":"Component for rendering content inside layout without full DOM patch.","ref":"LightningWeb.ModalPortal.html"},{"type":"function","title":"LightningWeb.ModalPortal.close_modal/0","doc":"","ref":"LightningWeb.ModalPortal.html#close_modal/0"},{"type":"function","title":"LightningWeb.ModalPortal.handle_event/3","doc":"","ref":"LightningWeb.ModalPortal.html#handle_event/3"},{"type":"function","title":"LightningWeb.ModalPortal.on_hide/2","doc":"","ref":"LightningWeb.ModalPortal.html#on_hide/2"},{"type":"function","title":"LightningWeb.ModalPortal.on_show/2","doc":"","ref":"LightningWeb.ModalPortal.html#on_show/2"},{"type":"function","title":"LightningWeb.ModalPortal.open_modal/2","doc":"","ref":"LightningWeb.ModalPortal.html#open_modal/2"},{"type":"function","title":"LightningWeb.ModalPortal.render/1","doc":"","ref":"LightningWeb.ModalPortal.html#render/1"},{"type":"function","title":"LightningWeb.ModalPortal.update/2","doc":"","ref":"LightningWeb.ModalPortal.html#update/2"},{"type":"module","title":"LightningWeb.OauthController","doc":"","ref":"LightningWeb.OauthController.html"},{"type":"function","title":"LightningWeb.OauthController.new/2","doc":"","ref":"LightningWeb.OauthController.html#new/2"},{"type":"module","title":"LightningWeb.OauthCredentialHelper","doc":"A set of helper functions to encodes state and coordinate OAuth callbacks\nback to a LiveView component.","ref":"LightningWeb.OauthCredentialHelper.html"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.broadcast/2","doc":"","ref":"LightningWeb.OauthCredentialHelper.html#broadcast/2"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.broadcast_forward/3","doc":"Broadcast a message specifically for forwarding a message to a component.\nIt expects a `subscription_id`, the module of the component and `opts`\nbeing a keyword list containing an `:id` key of the specific component.\n\nSee: `Phoenix.LiveView.send_update/3` for more info.\n\nA corresponding LiveView (that is subscribed) is expected to have a matching\n`handle_info/2` that looks like this:\n\n```\ndef handle_info({:forward, mod, opts}, socket) do\n send_update(mod, opts)\n {:noreply, socket}\nend\n```","ref":"LightningWeb.OauthCredentialHelper.html#broadcast_forward/3"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.build_state/3","doc":"Encode and encrypt the callback data which will be sent so a provider\nas the `state` key in the request.\n\nThe values are:\n\n- `subscription_id`\n The same ID used to subscribe.\n- The component module\n The LiveView component that is going to receive update\n- The component id\n The ID of the component","ref":"LightningWeb.OauthCredentialHelper.html#build_state/3"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.decode_state/1","doc":"","ref":"LightningWeb.OauthCredentialHelper.html#decode_state/1"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.subscribe/1","doc":"Subscribe to the `oauth_credential` topic.\nIt expects the a unique ID for the topic, usually the LiveView's `socket.id`.","ref":"LightningWeb.OauthCredentialHelper.html#subscribe/1"},{"type":"module","title":"LightningWeb.OidcController","doc":"","ref":"LightningWeb.OidcController.html"},{"type":"function","title":"LightningWeb.OidcController.new/2","doc":"Once the user has completed the authorization flow from above, they are\nreturned here, and the authorization code is used to log them in.","ref":"LightningWeb.OidcController.html#new/2"},{"type":"function","title":"LightningWeb.OidcController.show/2","doc":"Given a known provider, redirect them to the authorize url on the provider","ref":"LightningWeb.OidcController.html#show/2"},{"type":"module","title":"LightningWeb.PageView","doc":"","ref":"LightningWeb.PageView.html"},{"type":"function","title":"LightningWeb.PageView.__resource__/0","doc":"The resource name, as an atom, for this view","ref":"LightningWeb.PageView.html#__resource__/0"},{"type":"function","title":"LightningWeb.PageView.render/2","doc":"Renders the given template locally.","ref":"LightningWeb.PageView.html#render/2"},{"type":"function","title":"LightningWeb.PageView.template_not_found/2","doc":"Callback invoked when no template is found.\nBy default it raises but can be customized\nto render a particular template.","ref":"LightningWeb.PageView.html#template_not_found/2"},{"type":"module","title":"LightningWeb.Pagination","doc":"Pagination Components\n\nThis has been extracted and adapted from `scrivener_html`.\nSee: https://github.com/mgwidmann/scrivener_html","ref":"LightningWeb.Pagination.html"},{"type":"function","title":"LightningWeb.Pagination.page_link/1","doc":"","ref":"LightningWeb.Pagination.html#page_link/1"},{"type":"function","title":"LightningWeb.Pagination.pagination_bar/1","doc":"","ref":"LightningWeb.Pagination.html#pagination_bar/1"},{"type":"function","title":"Attributes - LightningWeb.Pagination.pagination_bar/1","doc":"* `async_page` (`Phoenix.LiveView.AsyncResult`) - Defaults to `nil`.\n* `page` (`:map`) (required)\n* `url` (`:any`) (required)\n* `help_text` (`:string`) - Defaults to `nil`.","ref":"LightningWeb.Pagination.html#pagination_bar/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Pagination.pagination_bar/1","doc":"* `action`","ref":"LightningWeb.Pagination.html#pagination_bar/1-slots"},{"type":"function","title":"LightningWeb.Pagination.raw_pagination_links/2","doc":"Returns the raw data in order to generate the proper HTML for pagination links. Data\nis returned in a `{text, page_number}` format where `text` is intended to be the text\nof the link and `page_number` is the page it should go to. Defaults are already supplied\nand they are as follows:\n [distance: 5, next: :next, previous: :previous, first: true, last: true, ellipsis: :ellipsis]\n`distance` must be a positive non-zero integer or an exception is raised. `next` and `previous` should be\nstrings but can be anything you want as long as it is truthy, falsey values will remove\nthem from the output. `first` and `last` are only booleans, and they just include/remove\ntheir respective link from output. An example of the data returned:\n iex> Scrivener.HTML.raw_pagination_links(%{total_pages: 10, page_number: 5})\n [{\"<<\", 4}, {1, 1}, {2, 2}, {3, 3}, {4, 4}, {5, 5}, {6, 6}, {7, 7}, {8, 8}, {9, 9}, {10, 10}, {\">>\", 6}]\n iex> Scrivener.HTML.raw_pagination_links(%{total_pages: 20, page_number: 10}, first: [\"←\"], last: [\"→\"])\n [{\"<<\", 9}, {[\"←\"], 1}, {:ellipsis, {:safe, \"…\"}}, {5, 5}, {6, 6},{7, 7}, {8, 8}, {9, 9}, {10, 10}, {11, 11}, {12, 12}, {13, 13}, {14, 14},{15, 15}, {:ellipsis, {:safe, \"…\"}}, {[\"→\"], 20}, {\">>\", 11}]\nSimply loop and pattern match over each item and transform it to your custom HTML.","ref":"LightningWeb.Pagination.html#raw_pagination_links/2"},{"type":"module","title":"LightningWeb.PlugConfigs","doc":"Dynamically initialize Plugs that don't accept dynamic configs in :prod ENV.","ref":"LightningWeb.PlugConfigs.html"},{"type":"function","title":"LightningWeb.PlugConfigs.plug_parsers/0","doc":"","ref":"LightningWeb.PlugConfigs.html#plug_parsers/0"},{"type":"module","title":"LightningWeb.Plugs.ApiAuth","doc":"Authenticates api calls based on JWT bearer token.","ref":"LightningWeb.Plugs.ApiAuth.html"},{"type":"module","title":"LightningWeb.Plugs.BlockRoutes","doc":"Plug to conditionally block specified routes based on configuration flags and custom messages.","ref":"LightningWeb.Plugs.BlockRoutes.html"},{"type":"module","title":"LightningWeb.Plugs.FirstSetup","doc":"Plug to redirect HTTP requests to `/first_setup` if there are no\nsuperusers in the system yet.","ref":"LightningWeb.Plugs.FirstSetup.html"},{"type":"module","title":"LightningWeb.Plugs.Redirect","doc":"A plug for redirecting requests to a specified URL.\n\nThis plug takes an option `:to` which specifies the target URL for the redirection.","ref":"LightningWeb.Plugs.Redirect.html"},{"type":"function","title":"LightningWeb.Plugs.Redirect.call/2","doc":"Redirects the connection to the specified URL.","ref":"LightningWeb.Plugs.Redirect.html#call/2"},{"type":"function","title":"Parameters - LightningWeb.Plugs.Redirect.call/2","doc":"- conn: The connection struct.\n - opts: A keyword list of options. Must include `:to` key specifying the target URL.","ref":"LightningWeb.Plugs.Redirect.html#call/2-parameters"},{"type":"function","title":"Examples - LightningWeb.Plugs.Redirect.call/2","doc":"iex> conn = %Plug.Conn{}\n iex> opts = [to: \"/new_path\"]\n iex> LightningWeb.Plugs.Redirect.call(conn, opts)\n %Plug.Conn{...}","ref":"LightningWeb.Plugs.Redirect.html#call/2-examples"},{"type":"function","title":"Raises - LightningWeb.Plugs.Redirect.call/2","doc":"`KeyError` if the `:to` key is not present in options.","ref":"LightningWeb.Plugs.Redirect.html#call/2-raises"},{"type":"function","title":"LightningWeb.Plugs.Redirect.init/1","doc":"Initializes the plug options.","ref":"LightningWeb.Plugs.Redirect.html#init/1"},{"type":"function","title":"Parameters - LightningWeb.Plugs.Redirect.init/1","doc":"- opts: A keyword list of options.","ref":"LightningWeb.Plugs.Redirect.html#init/1-parameters"},{"type":"function","title":"Returns - LightningWeb.Plugs.Redirect.init/1","doc":"The provided options are returned as they are.","ref":"LightningWeb.Plugs.Redirect.html#init/1-returns"},{"type":"function","title":"Examples - LightningWeb.Plugs.Redirect.init/1","doc":"iex> LightningWeb.Plugs.Redirect.init(to: \"/new_path\")\n [to: \"/new_path\"]","ref":"LightningWeb.Plugs.Redirect.html#init/1-examples"},{"type":"module","title":"LightningWeb.Plugs.WebhookAuth","doc":"A Plug to authenticate and authorize requests based on paths starting with '/i/'.\nIt verifies the presence of correct API keys or Basic Authentication credentials.","ref":"LightningWeb.Plugs.WebhookAuth.html"},{"type":"function","title":"LightningWeb.Plugs.WebhookAuth.call/2","doc":"Handles the incoming HTTP request and performs authentication and authorization checks\nbased on paths starting with `/i/`.","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2"},{"type":"function","title":"Details - LightningWeb.Plugs.WebhookAuth.call/2","doc":"This function is the entry point for the `WebhookAuth` plug. It first checks if\nthe request path starts with `/i/` to determine whether the request should be processed\nby this plug.\n\nIf the path matches, it then extracts the `webhook` part from the request path and\nruns to fetch the corresponding `trigger` using the `fetch_trigger` function.\n\nIf a valid `trigger` is found, the function proceeds to validate the authentication\nof the request using the `validate_auth` function.\n\nIn case the `trigger` is not found, or the path does not start with `/i/`, the function\nreturns a 404 Not Found response with a JSON error message indicating that the webhook\nis not found.","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-details"},{"type":"function","title":"Parameters - LightningWeb.Plugs.WebhookAuth.call/2","doc":"- `conn`: The connection struct representing the incoming HTTP request.\n- `_opts`: A set of options, not used in this function but is a mandatory parameter as per\n Plug specification.","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-parameters"},{"type":"function","title":"Returns - LightningWeb.Plugs.WebhookAuth.call/2","doc":"- A connection struct representing the outgoing response, which can be a successful\n response, an unauthorized response, or a not found response, based on the evaluation\n of the above-mentioned conditions.","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-returns"},{"type":"function","title":"Examples - LightningWeb.Plugs.WebhookAuth.call/2","doc":"Assuming a request with the path `/i/some_webhook`:","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-examples"},{"type":"function","title":"Webhook Found and Authenticated - LightningWeb.Plugs.WebhookAuth.call/2","doc":"iex> LightningWeb.Plugs.WebhookAuth.call(conn, [])\n %Plug.Conn{status: 200, ...}\n\n iex> LightningWeb.Plugs.WebhookAuth.call(conn, [])\n %Plug.Conn{status: 404, ...}","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-webhook-found-and-authenticated"},{"type":"function","title":"LightningWeb.Plugs.WebhookAuth.init/1","doc":"Initializes the options.","ref":"LightningWeb.Plugs.WebhookAuth.html#init/1"},{"type":"module","title":"LightningWeb.ProfileLive.Edit","doc":"LiveView for user profile page.","ref":"LightningWeb.ProfileLive.Edit.html"},{"type":"function","title":"LightningWeb.ProfileLive.Edit.render/1","doc":"","ref":"LightningWeb.ProfileLive.Edit.html#render/1"},{"type":"module","title":"LightningWeb.ProfileLive.FormComponent","doc":"Form component update profile email and password","ref":"LightningWeb.ProfileLive.FormComponent.html"},{"type":"function","title":"LightningWeb.ProfileLive.FormComponent.enum_options/2","doc":"","ref":"LightningWeb.ProfileLive.FormComponent.html#enum_options/2"},{"type":"function","title":"LightningWeb.ProfileLive.FormComponent.render/1","doc":"","ref":"LightningWeb.ProfileLive.FormComponent.html#render/1"},{"type":"module","title":"LightningWeb.ProfileLive.MfaComponent","doc":"Component to enable MFA on a User's account","ref":"LightningWeb.ProfileLive.MfaComponent.html"},{"type":"function","title":"LightningWeb.ProfileLive.MfaComponent.render/1","doc":"","ref":"LightningWeb.ProfileLive.MfaComponent.html#render/1"},{"type":"module","title":"LightningWeb.ProjectFileController","doc":"","ref":"LightningWeb.ProjectFileController.html"},{"type":"function","title":"LightningWeb.ProjectFileController.download/2","doc":"","ref":"LightningWeb.ProjectFileController.html#download/2"},{"type":"module","title":"LightningWeb.ProjectLive.Collaborators","doc":"This schema is used for building the changeset for adding new collaborators to a project.\nIt is mirroring the `Project -> ProjectUser` relationship.","ref":"LightningWeb.ProjectLive.Collaborators.html"},{"type":"function","title":"LightningWeb.ProjectLive.Collaborators.changeset/2","doc":"","ref":"LightningWeb.ProjectLive.Collaborators.html#changeset/2"},{"type":"function","title":"LightningWeb.ProjectLive.Collaborators.prepare_for_insertion/3","doc":"","ref":"LightningWeb.ProjectLive.Collaborators.html#prepare_for_insertion/3"},{"type":"module","title":"LightningWeb.ProjectLive.Collaborators.Collaborator","doc":"","ref":"LightningWeb.ProjectLive.Collaborators.Collaborator.html"},{"type":"module","title":"LightningWeb.ProjectLive.FormComponent","doc":"Form Component for working with a single Job\n\nA Job's `adaptor` field is a combination of the module name and the version.\nIt's formatted as an NPM style string.\n\nThe form allows the user to select a module by name and then it's version,\nwhile the version dropdown itself references `adaptor` directly.\n\nMeaning the `adaptor_name` dropdown and assigns value is not persisted.","ref":"LightningWeb.ProjectLive.FormComponent.html"},{"type":"function","title":"LightningWeb.ProjectLive.FormComponent.render/1","doc":"","ref":"LightningWeb.ProjectLive.FormComponent.html#render/1"},{"type":"module","title":"LightningWeb.ProjectLive.Index","doc":"LiveView for listing and managing Projects","ref":"LightningWeb.ProjectLive.Index.html"},{"type":"function","title":"LightningWeb.ProjectLive.Index.delete_action/1","doc":"","ref":"LightningWeb.ProjectLive.Index.html#delete_action/1"},{"type":"function","title":"LightningWeb.ProjectLive.Index.render/1","doc":"","ref":"LightningWeb.ProjectLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.ProjectLive.InvitedCollaborators","doc":"This schema is used for building the changeset for adding new collaborators to a project.\nIt is mirroring the `Project -> ProjectUser` relationship.","ref":"LightningWeb.ProjectLive.InvitedCollaborators.html"},{"type":"function","title":"LightningWeb.ProjectLive.InvitedCollaborators.changeset/2","doc":"","ref":"LightningWeb.ProjectLive.InvitedCollaborators.html#changeset/2"},{"type":"function","title":"LightningWeb.ProjectLive.InvitedCollaborators.validate_collaborators/2","doc":"","ref":"LightningWeb.ProjectLive.InvitedCollaborators.html#validate_collaborators/2"},{"type":"module","title":"LightningWeb.ProjectLive.InvitedCollaborators.InvitedCollaborator","doc":"","ref":"LightningWeb.ProjectLive.InvitedCollaborators.InvitedCollaborator.html"},{"type":"module","title":"LightningWeb.ProjectLive.MFARequired","doc":"Liveview for project access denied error messages","ref":"LightningWeb.ProjectLive.MFARequired.html"},{"type":"function","title":"LightningWeb.ProjectLive.MFARequired.on_mount/4","doc":"","ref":"LightningWeb.ProjectLive.MFARequired.html#on_mount/4"},{"type":"function","title":"LightningWeb.ProjectLive.MFARequired.render/1","doc":"","ref":"LightningWeb.ProjectLive.MFARequired.html#render/1"},{"type":"module","title":"LightningWeb.ProjectLive.Settings","doc":"Index Liveview for project settings","ref":"LightningWeb.ProjectLive.Settings.html"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.digest/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#digest/1"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.permissions_message/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#permissions_message/1"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.render/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#render/1"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.role/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#role/1"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.user/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#user/1"},{"type":"module","title":"LightningWeb.PromExPlugAuthorization","doc":"Implement custom authorization for PromEx metrics endpoint as per\nhttps://hexdocs.pm/prom_ex/1.1.1/PromEx.Plug.html","ref":"LightningWeb.PromExPlugAuthorization.html"},{"type":"module","title":"LightningWeb.ReAuthenticateLive.New","doc":"LiveView for re-authentication page.","ref":"LightningWeb.ReAuthenticateLive.New.html"},{"type":"function","title":"LightningWeb.ReAuthenticateLive.New.render/1","doc":"","ref":"LightningWeb.ReAuthenticateLive.New.html#render/1"},{"type":"module","title":"LightningWeb.RouteHelpers","doc":"Convenience functions for generating paths.","ref":"LightningWeb.RouteHelpers.html"},{"type":"function","title":"LightningWeb.RouteHelpers.oidc_callback_url/0","doc":"","ref":"LightningWeb.RouteHelpers.html#oidc_callback_url/0"},{"type":"function","title":"LightningWeb.RouteHelpers.project_dashboard_url/1","doc":"","ref":"LightningWeb.RouteHelpers.html#project_dashboard_url/1"},{"type":"module","title":"LightningWeb.Router","doc":"The router for Lightning.","ref":"LightningWeb.Router.html"},{"type":"function","title":"LightningWeb.Router.api/2","doc":"","ref":"LightningWeb.Router.html#api/2"},{"type":"function","title":"LightningWeb.Router.authenticated_api/2","doc":"","ref":"LightningWeb.Router.html#authenticated_api/2"},{"type":"function","title":"LightningWeb.Router.browser/2","doc":"","ref":"LightningWeb.Router.html#browser/2"},{"type":"function","title":"LightningWeb.Router.call/2","doc":"Callback invoked by Plug on every request.","ref":"LightningWeb.Router.html#call/2"},{"type":"function","title":"LightningWeb.Router.init/1","doc":"Callback required by Plug that initializes the router\nfor serving web requests.","ref":"LightningWeb.Router.html#init/1"},{"type":"function","title":"LightningWeb.Router.storybook_assets/2","doc":"","ref":"LightningWeb.Router.html#storybook_assets/2"},{"type":"function","title":"LightningWeb.Router.storybook_browser/2","doc":"","ref":"LightningWeb.Router.html#storybook_browser/2"},{"type":"module","title":"LightningWeb.RunChannel","doc":"Phoenix channel to interact with Runs.","ref":"LightningWeb.RunChannel.html"},{"type":"function","title":"LightningWeb.RunChannel.child_spec/1","doc":"","ref":"LightningWeb.RunChannel.html#child_spec/1"},{"type":"function","title":"LightningWeb.RunChannel.handle_in/3","doc":"For the time being, calls to `fetch:dataclip` will return dataclips that are\npreformatted for use as \"initial state\" in a run.\n\nThis means that the body of http requests will be nested inside a \"data\" key.\n\nThere is an open discussion on the community that may impact how we\nstore HTTP requests in the database as dataclips and how we send the body\nof those HTTP requests to the worker to use as initial state.","ref":"LightningWeb.RunChannel.html#handle_in/3"},{"type":"function","title":"LightningWeb.RunChannel.start_link/1","doc":"","ref":"LightningWeb.RunChannel.html#start_link/1"},{"type":"module","title":"LightningWeb.RunLive.ExportConfirmationModal","doc":"","ref":"LightningWeb.RunLive.ExportConfirmationModal.html"},{"type":"module","title":"LightningWeb.RunLive.Index","doc":"Index Liveview for Runs","ref":"LightningWeb.RunLive.Index.html"},{"type":"function","title":"LightningWeb.RunLive.Index.checked?/2","doc":"Takes a changeset used for querying workorders and checks to see if the given\nfilter is present in that changeset. Returns true or false.","ref":"LightningWeb.RunLive.Index.html#checked?/2"},{"type":"function","title":"LightningWeb.RunLive.Index.filters_changeset/1","doc":"Creates a changeset based on given parameters and the fixed workorder filter types.","ref":"LightningWeb.RunLive.Index.html#filters_changeset/1"},{"type":"function","title":"LightningWeb.RunLive.Index.handle_info/2","doc":"When a WorkOrderCreated event is detected, we first check to see if the new\nwork order is admissible on the page, given the current filters. If it is, we\nadd it to the top of the page. If not, nothing happens.","ref":"LightningWeb.RunLive.Index.html#handle_info/2"},{"type":"function","title":"LightningWeb.RunLive.Index.render/1","doc":"","ref":"LightningWeb.RunLive.Index.html#render/1"},{"type":"function","title":"LightningWeb.RunLive.Index.validate_bulk_rerun/2","doc":"","ref":"LightningWeb.RunLive.Index.html#validate_bulk_rerun/2"},{"type":"module","title":"LightningWeb.RunLive.RerunJobComponent","doc":"Rerun job component","ref":"LightningWeb.RunLive.RerunJobComponent.html"},{"type":"module","title":"LightningWeb.RunLive.RunViewerLive","doc":"","ref":"LightningWeb.RunLive.RunViewerLive.html"},{"type":"function","title":"LightningWeb.RunLive.RunViewerLive.apply_selected_step_id/2","doc":"","ref":"LightningWeb.RunLive.RunViewerLive.html#apply_selected_step_id/2"},{"type":"function","title":"LightningWeb.RunLive.RunViewerLive.handle_steps_change/1","doc":"","ref":"LightningWeb.RunLive.RunViewerLive.html#handle_steps_change/1"},{"type":"module","title":"LightningWeb.RunLive.Show","doc":"","ref":"LightningWeb.RunLive.Show.html"},{"type":"function","title":"LightningWeb.RunLive.Show.apply_selected_step_id/2","doc":"","ref":"LightningWeb.RunLive.Show.html#apply_selected_step_id/2"},{"type":"function","title":"LightningWeb.RunLive.Show.handle_steps_change/1","doc":"","ref":"LightningWeb.RunLive.Show.html#handle_steps_change/1"},{"type":"module","title":"LightningWeb.RunLive.Streaming","doc":"","ref":"LightningWeb.RunLive.Streaming.html"},{"type":"function","title":"LightningWeb.RunLive.Streaming.add_or_update_step/2","doc":"","ref":"LightningWeb.RunLive.Streaming.html#add_or_update_step/2"},{"type":"function","title":"LightningWeb.RunLive.Streaming.get_dataclip/2","doc":"","ref":"LightningWeb.RunLive.Streaming.html#get_dataclip/2"},{"type":"function","title":"LightningWeb.RunLive.Streaming.get_run_async/2","doc":"Starts an async process that will fetch the run with the given ID.","ref":"LightningWeb.RunLive.Streaming.html#get_run_async/2"},{"type":"function","title":"LightningWeb.RunLive.Streaming.maybe_load_input_dataclip/1","doc":"","ref":"LightningWeb.RunLive.Streaming.html#maybe_load_input_dataclip/1"},{"type":"function","title":"LightningWeb.RunLive.Streaming.maybe_load_output_dataclip/1","doc":"","ref":"LightningWeb.RunLive.Streaming.html#maybe_load_output_dataclip/1"},{"type":"function","title":"LightningWeb.RunLive.Streaming.sort_steps/1","doc":"","ref":"LightningWeb.RunLive.Streaming.html#sort_steps/1"},{"type":"function","title":"LightningWeb.RunLive.Streaming.unselect_step/1","doc":"","ref":"LightningWeb.RunLive.Streaming.html#unselect_step/1"},{"type":"module","title":"LightningWeb.RunLive.WorkOrderComponent","doc":"Work Order component","ref":"LightningWeb.RunLive.WorkOrderComponent.html"},{"type":"function","title":"LightningWeb.RunLive.WorkOrderComponent.render/1","doc":"","ref":"LightningWeb.RunLive.WorkOrderComponent.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.RunLive.WorkOrderComponent.render/1","doc":"* `show_details` (`:boolean`) - Defaults to `false`.\n* `show_prev_runs` (`:boolean`) - Defaults to `false`.\n* `entry_selected` (`:boolean`) - Defaults to `false`.","ref":"LightningWeb.RunLive.WorkOrderComponent.html#render/1-attributes"},{"type":"module","title":"LightningWeb.Telemetry","doc":"Assorted metrics to collect during runtime.\n\nSee https://hexdocs.pm/phoenix/telemetry.html","ref":"LightningWeb.Telemetry.html"},{"type":"function","title":"LightningWeb.Telemetry.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"LightningWeb.Telemetry.html#child_spec/1"},{"type":"function","title":"LightningWeb.Telemetry.metrics/0","doc":"","ref":"LightningWeb.Telemetry.html#metrics/0"},{"type":"function","title":"LightningWeb.Telemetry.start_link/1","doc":"","ref":"LightningWeb.Telemetry.html#start_link/1"},{"type":"function","title":"LightningWeb.Telemetry.with_span/3","doc":"Convenience function that wraps `:telemetry.span/3`.\n\nGiven a function with an arity of zero, it passes the `metadata` argument\nout with the result of the function.\n\nIf you need to control the `metadata`, pass in a function with an arity of\none. It will be called with the metadata provided and expects the result and\nthe updated metadata to be returned in a tuple.\n\nExample:\n\n with_span([:my, span], %{project_id: 123}, fn -> get_project(456) end)\n\nOr when you want to extend the metadata:\n\n with_span([:my, :span], %{user_id: 123}, fn _metadata ->\n project = get_project(456)\n {project, %{project_id: project.id}}\n end)","ref":"LightningWeb.Telemetry.html#with_span/3"},{"type":"module","title":"LightningWeb.TokensLive.Index","doc":"LiveView for listing and managing tokens","ref":"LightningWeb.TokensLive.Index.html"},{"type":"function","title":"LightningWeb.TokensLive.Index.render/1","doc":"","ref":"LightningWeb.TokensLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.UserAuth","doc":"The UserAuth controller.","ref":"LightningWeb.UserAuth.html"},{"type":"function","title":"LightningWeb.UserAuth.authenticate_bearer/2","doc":"","ref":"LightningWeb.UserAuth.html#authenticate_bearer/2"},{"type":"function","title":"LightningWeb.UserAuth.fetch_current_user/2","doc":"Authenticates the user by looking into the session\nand remember me token.","ref":"LightningWeb.UserAuth.html#fetch_current_user/2"},{"type":"function","title":"LightningWeb.UserAuth.get_bearer/1","doc":"","ref":"LightningWeb.UserAuth.html#get_bearer/1"},{"type":"function","title":"LightningWeb.UserAuth.log_in_user/2","doc":"Logs the user in by creating a new session token.","ref":"LightningWeb.UserAuth.html#log_in_user/2"},{"type":"function","title":"LightningWeb.UserAuth.log_out_user/1","doc":"Logs the user out.\n\nIt clears all session data for safety. See renew_session.","ref":"LightningWeb.UserAuth.html#log_out_user/1"},{"type":"function","title":"LightningWeb.UserAuth.mark_totp_pending/1","doc":"","ref":"LightningWeb.UserAuth.html#mark_totp_pending/1"},{"type":"function","title":"LightningWeb.UserAuth.new_session/2","doc":"Assigns the token to a new session.\n\nIt renews the session ID and clears the whole session\nto avoid fixation attacks. See the renew_session\nfunction to customize this behaviour.\n\nIt also sets a `:live_socket_id` key in the session,\nso LiveView sessions are identified and automatically\ndisconnected on log out. The line can be safely removed\nif you are not using LiveView.","ref":"LightningWeb.UserAuth.html#new_session/2"},{"type":"function","title":"LightningWeb.UserAuth.on_mount/4","doc":"Used for LiveView routes that require the user to be reauthenticated.","ref":"LightningWeb.UserAuth.html#on_mount/4"},{"type":"function","title":"LightningWeb.UserAuth.reauth_sudo_mode/2","doc":"Reauthenticate the user by using the sudo token","ref":"LightningWeb.UserAuth.html#reauth_sudo_mode/2"},{"type":"function","title":"LightningWeb.UserAuth.redirect_if_user_is_authenticated/2","doc":"Used for routes that require the user to not be authenticated.","ref":"LightningWeb.UserAuth.html#redirect_if_user_is_authenticated/2"},{"type":"function","title":"LightningWeb.UserAuth.redirect_with_return_to/2","doc":"Returns to or redirects to the dashboard and potentially set remember_me token.","ref":"LightningWeb.UserAuth.html#redirect_with_return_to/2"},{"type":"function","title":"LightningWeb.UserAuth.require_authenticated_api_resource/2","doc":"Used for API routes that require the resource to be authenticated.\nA resource can be a `User` or a `ProjectRepoConnection`","ref":"LightningWeb.UserAuth.html#require_authenticated_api_resource/2"},{"type":"function","title":"LightningWeb.UserAuth.require_authenticated_user/2","doc":"Used for routes that require the user to be authenticated.\n\nIf you want to enforce the user email is confirmed before\nthey use the application at all, here would be a good place.","ref":"LightningWeb.UserAuth.html#require_authenticated_user/2"},{"type":"function","title":"LightningWeb.UserAuth.require_sudo_user/2","doc":"Used for routes that require the user to be reauthenticated.","ref":"LightningWeb.UserAuth.html#require_sudo_user/2"},{"type":"function","title":"LightningWeb.UserAuth.require_superuser/2","doc":"Require that the user has the `superuser` role","ref":"LightningWeb.UserAuth.html#require_superuser/2"},{"type":"function","title":"LightningWeb.UserAuth.totp_pending?/1","doc":"","ref":"LightningWeb.UserAuth.html#totp_pending?/1"},{"type":"function","title":"LightningWeb.UserAuth.totp_validated/1","doc":"","ref":"LightningWeb.UserAuth.html#totp_validated/1"},{"type":"module","title":"LightningWeb.UserConfirmationController","doc":"","ref":"LightningWeb.UserConfirmationController.html"},{"type":"function","title":"LightningWeb.UserConfirmationController.confirm_email/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#confirm_email/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.create/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#create/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.edit/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#edit/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.new/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#new/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.send_email/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#send_email/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.update/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#update/2"},{"type":"module","title":"LightningWeb.UserLive.Edit","doc":"LiveView for editing a single job, which inturn uses `LightningWeb.JobLive.BigFormComponent`\nfor common functionality.","ref":"LightningWeb.UserLive.Edit.html"},{"type":"function","title":"LightningWeb.UserLive.Edit.render/1","doc":"","ref":"LightningWeb.UserLive.Edit.html#render/1"},{"type":"module","title":"LightningWeb.UserLive.FormComponent","doc":"Form component for creating and editing users","ref":"LightningWeb.UserLive.FormComponent.html"},{"type":"function","title":"LightningWeb.UserLive.FormComponent.render/1","doc":"","ref":"LightningWeb.UserLive.FormComponent.html#render/1"},{"type":"module","title":"LightningWeb.UserLive.Index","doc":"Index page for listing users","ref":"LightningWeb.UserLive.Index.html"},{"type":"function","title":"LightningWeb.UserLive.Index.delete_action/1","doc":"","ref":"LightningWeb.UserLive.Index.html#delete_action/1"},{"type":"function","title":"LightningWeb.UserLive.Index.render/1","doc":"","ref":"LightningWeb.UserLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.UserRegistrationController","doc":"","ref":"LightningWeb.UserRegistrationController.html"},{"type":"function","title":"LightningWeb.UserRegistrationController.create/2","doc":"","ref":"LightningWeb.UserRegistrationController.html#create/2"},{"type":"function","title":"LightningWeb.UserRegistrationController.new/2","doc":"","ref":"LightningWeb.UserRegistrationController.html#new/2"},{"type":"module","title":"LightningWeb.UserResetPasswordController","doc":"","ref":"LightningWeb.UserResetPasswordController.html"},{"type":"function","title":"LightningWeb.UserResetPasswordController.create/2","doc":"","ref":"LightningWeb.UserResetPasswordController.html#create/2"},{"type":"function","title":"LightningWeb.UserResetPasswordController.edit/2","doc":"","ref":"LightningWeb.UserResetPasswordController.html#edit/2"},{"type":"function","title":"LightningWeb.UserResetPasswordController.new/2","doc":"","ref":"LightningWeb.UserResetPasswordController.html#new/2"},{"type":"function","title":"LightningWeb.UserResetPasswordController.update/2","doc":"","ref":"LightningWeb.UserResetPasswordController.html#update/2"},{"type":"module","title":"LightningWeb.UserSessionController","doc":"","ref":"LightningWeb.UserSessionController.html"},{"type":"function","title":"LightningWeb.UserSessionController.auth_handler_url/0","doc":"","ref":"LightningWeb.UserSessionController.html#auth_handler_url/0"},{"type":"function","title":"LightningWeb.UserSessionController.create/2","doc":"","ref":"LightningWeb.UserSessionController.html#create/2"},{"type":"function","title":"LightningWeb.UserSessionController.delete/2","doc":"","ref":"LightningWeb.UserSessionController.html#delete/2"},{"type":"function","title":"LightningWeb.UserSessionController.exchange_token/2","doc":"","ref":"LightningWeb.UserSessionController.html#exchange_token/2"},{"type":"function","title":"LightningWeb.UserSessionController.new/2","doc":"","ref":"LightningWeb.UserSessionController.html#new/2"},{"type":"module","title":"LightningWeb.UserTOTPController","doc":"","ref":"LightningWeb.UserTOTPController.html"},{"type":"function","title":"LightningWeb.UserTOTPController.create/2","doc":"","ref":"LightningWeb.UserTOTPController.html#create/2"},{"type":"function","title":"LightningWeb.UserTOTPController.new/2","doc":"","ref":"LightningWeb.UserTOTPController.html#new/2"},{"type":"module","title":"LightningWeb.Utils","doc":"Helper functions to deal with forms and query params.","ref":"LightningWeb.Utils.html"},{"type":"function","title":"LightningWeb.Utils.build_params_for_field/3","doc":"","ref":"LightningWeb.Utils.html#build_params_for_field/3"},{"type":"function","title":"LightningWeb.Utils.decode_one/2","doc":"","ref":"LightningWeb.Utils.html#decode_one/2"},{"type":"module","title":"LightningWeb.VersionControlController","doc":"","ref":"LightningWeb.VersionControlController.html"},{"type":"function","title":"LightningWeb.VersionControlController.index/2","doc":"","ref":"LightningWeb.VersionControlController.html#index/2"},{"type":"module","title":"LightningWeb.WebhooksController","doc":"","ref":"LightningWeb.WebhooksController.html"},{"type":"function","title":"LightningWeb.WebhooksController.check/2","doc":"","ref":"LightningWeb.WebhooksController.html#check/2"},{"type":"function","title":"LightningWeb.WebhooksController.create/2","doc":"","ref":"LightningWeb.WebhooksController.html#create/2"},{"type":"module","title":"LightningWeb.WorkerChannel","doc":"Websocket channel to handle when workers join or claim something to run.","ref":"LightningWeb.WorkerChannel.html"},{"type":"function","title":"LightningWeb.WorkerChannel.child_spec/1","doc":"","ref":"LightningWeb.WorkerChannel.html#child_spec/1"},{"type":"function","title":"LightningWeb.WorkerChannel.start_link/1","doc":"","ref":"LightningWeb.WorkerChannel.html#start_link/1"},{"type":"module","title":"LightningWeb.WorkerSocket","doc":"","ref":"LightningWeb.WorkerSocket.html"},{"type":"function","title":"LightningWeb.WorkerSocket.handle_error/2","doc":"","ref":"LightningWeb.WorkerSocket.html#handle_error/2"},{"type":"module","title":"LightningWeb.WorkflowLive.AiAssistantComponent","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.handle_async/3","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#handle_async/3"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.handle_event/3","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#handle_event/3"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.mount/1","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#mount/1"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.render/1","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#render/1"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.update/2","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#update/2"},{"type":"module","title":"LightningWeb.WorkflowLive.EditorPane","doc":"","ref":"LightningWeb.WorkflowLive.EditorPane.html"},{"type":"function","title":"LightningWeb.WorkflowLive.EditorPane.render/1","doc":"","ref":"LightningWeb.WorkflowLive.EditorPane.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.WorkflowLive.EditorPane.render/1","doc":"* `id` (`:string`) (required)\n* `disabled` (`:boolean`) - Defaults to `false`.\n* `disabled_message` (`:string`) (required)\n* `class` (`:string`) - Defaults to `\"\"`.\n* `on_change` (`:any`) (required)\n* `adaptor` (`:string`) (required)\n* `source` (`:string`) (required)\n* `job_id` (`:string`) (required)","ref":"LightningWeb.WorkflowLive.EditorPane.html#render/1-attributes"},{"type":"module","title":"LightningWeb.WorkflowLive.Helpers","doc":"Helper functions for the Workflow LiveViews.","ref":"LightningWeb.WorkflowLive.Helpers.html"},{"type":"function","title":"LightningWeb.WorkflowLive.Helpers.broadcast_updated_params/2","doc":"","ref":"LightningWeb.WorkflowLive.Helpers.html#broadcast_updated_params/2"},{"type":"function","title":"LightningWeb.WorkflowLive.Helpers.run_workflow/3","doc":"","ref":"LightningWeb.WorkflowLive.Helpers.html#run_workflow/3"},{"type":"function","title":"LightningWeb.WorkflowLive.Helpers.save_workflow/1","doc":"","ref":"LightningWeb.WorkflowLive.Helpers.html#save_workflow/1"},{"type":"function","title":"LightningWeb.WorkflowLive.Helpers.subscribe_to_params_update/1","doc":"","ref":"LightningWeb.WorkflowLive.Helpers.html#subscribe_to_params_update/1"},{"type":"module","title":"LightningWeb.WorkflowLive.JobView","doc":"","ref":"LightningWeb.WorkflowLive.JobView.html"},{"type":"function","title":"LightningWeb.WorkflowLive.JobView.container/1","doc":"","ref":"LightningWeb.WorkflowLive.JobView.html#container/1"},{"type":"function","title":"Attributes - LightningWeb.WorkflowLive.JobView.container/1","doc":"* `id` (`:string`) (required)","ref":"LightningWeb.WorkflowLive.JobView.html#container/1-attributes"},{"type":"function","title":"Slots - LightningWeb.WorkflowLive.JobView.container/1","doc":"* `top`\n* `inner_block`\n* `bottom`\n* `column` - Accepts attributes:\n\n * `class` (`:string`) - Extra CSS classes for the column.","ref":"LightningWeb.WorkflowLive.JobView.html#container/1-slots"},{"type":"function","title":"LightningWeb.WorkflowLive.JobView.job_edit_view/1","doc":"","ref":"LightningWeb.WorkflowLive.JobView.html#job_edit_view/1"},{"type":"function","title":"Attributes - LightningWeb.WorkflowLive.JobView.job_edit_view/1","doc":"* `job` (`:map`) (required)\n* `form` (`:map`) (required) - A form built from a job.\n* `current_user` (`:map`) (required)\n* `project` (`:map`) (required)\n* `close_url` (`:any`) (required)\n* `socket` (`:any`) (required)\n* `follow_run_id` (`:any`) - Defaults to `nil`.\n* `snapshot` (`:any`) (required)\n* `snapshot_version` (`:any`) (required)\n* `display_banner` (`:boolean`) - Defaults to `false`.\n* `banner_message` (`:string`) - Defaults to `\"\"`.\n* `presences` (`:list`) (required)\n* `prior_user_presence` (`:any`) (required)","ref":"LightningWeb.WorkflowLive.JobView.html#job_edit_view/1-attributes"},{"type":"function","title":"Slots - LightningWeb.WorkflowLive.JobView.job_edit_view/1","doc":"* `footer`\n* `collapsible_panel` - Accepts attributes:\n\n * `id` (`:string`) (required)\n * `panel_title` (`:string`) (required)\n * `class` (`:string`) - Extra CSS classes for the column.","ref":"LightningWeb.WorkflowLive.JobView.html#job_edit_view/1-slots"},{"type":"module","title":"LightningWeb.WorkflowLive.NewWorkflowForm","doc":"","ref":"LightningWeb.WorkflowLive.NewWorkflowForm.html"},{"type":"function","title":"LightningWeb.WorkflowLive.NewWorkflowForm.validate/2","doc":"","ref":"LightningWeb.WorkflowLive.NewWorkflowForm.html#validate/2"},{"type":"function","title":"LightningWeb.WorkflowLive.NewWorkflowForm.validate_for_save/1","doc":"","ref":"LightningWeb.WorkflowLive.NewWorkflowForm.html#validate_for_save/1"},{"type":"module","title":"LightningWeb.WorkflowNewLive.WorkflowParams","doc":"Various function for reconciling changes to a workflow params map.\n\nThe front end editor uses JSON patches to represent changes to the workflow.","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html"},{"type":"function","title":"LightningWeb.WorkflowNewLive.WorkflowParams.apply_form_params/2","doc":"Produce a new set of params by applying the given form params to the current\nparams.","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html#apply_form_params/2"},{"type":"function","title":"LightningWeb.WorkflowNewLive.WorkflowParams.apply_patches/2","doc":"Produce a new set of params by applying the given patches to the current parms","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html#apply_patches/2"},{"type":"function","title":"LightningWeb.WorkflowNewLive.WorkflowParams.to_map/1","doc":"Convert a changeset to a serializable map of workflow params, suitable for\nsending to the front end editor.\n\nIt uses `Lightning.Helpers.json_safe/1` to ensure that the map is safe to\nserialize to JSON. This is necessary because the underlying model may\ncontain atom values.","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html#to_map/1"},{"type":"function","title":"LightningWeb.WorkflowNewLive.WorkflowParams.to_patches/2","doc":"Produce a set of patches that represent the difference between the initial\nparams and the target params.\n\nThis usually is used to produce a set of patches that represent the changes\nintroduced by a changeset.","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html#to_patches/2"},{"type":"module","title":"Lightning.API","doc":"Behaviour for implementing the Lightning interface.\n\nThis behaviour is used to mock specific functions in tests.","ref":"Lightning.API.html"},{"type":"module","title":"Lightning.AdaptorRegistry","doc":"Registry process to query and maintain a list of adaptors available for\nwriting jobs.\n\nCurrently it queries NPM for all modules in the `@openfn` organization and\nfilters out modules that are known not to be adaptors.\n\n**Usage**\n\n```\n# Starting the process\nAdaptorRegistry.start_link()\n# Getting a list of all adaptors\nLightning.AdaptorRegistry.AdaptorRegistry.all()\n```\n\n**Caching**\n\nBy default the results are cached to disk, and will be reused every start.\n\nIn order to disable or configure caching pass see: `start_link/1`.\n\nThe process uses `:continue` to return before the adaptors have been queried.\nThis does mean that the first call to the process will be delayed until\nthe `handle_continue/2` has finished.\n\n**Timeouts**\n\nThere is a 'general' timeout of 30s, this is used for GenServer calls like\n`all/1` and also internally when the modules are being queried. NPM can\nbe extremely fast to respond if the package is cached on their side, but\ncan take a couple of seconds if not cached.","ref":"Lightning.AdaptorRegistry.html"},{"type":"function","title":"Lightning.AdaptorRegistry.all/1","doc":"Get the current in-process list of adaptors.\nThis call will wait behind the `:continue` message when the process starts\nup, so it may take a while the first time it is called (and the list hasn't\nbeen fetched yet).","ref":"Lightning.AdaptorRegistry.html#all/1"},{"type":"function","title":"Lightning.AdaptorRegistry.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.AdaptorRegistry.html#child_spec/1"},{"type":"function","title":"Lightning.AdaptorRegistry.fetch/0","doc":"Fetch a list of packages for the @openfn organisation","ref":"Lightning.AdaptorRegistry.html#fetch/0"},{"type":"function","title":"Lightning.AdaptorRegistry.latest_for/2","doc":"Get a latest version for a given module.","ref":"Lightning.AdaptorRegistry.html#latest_for/2"},{"type":"function","title":"Lightning.AdaptorRegistry.resolve_adaptor/1","doc":"","ref":"Lightning.AdaptorRegistry.html#resolve_adaptor/1"},{"type":"function","title":"Lightning.AdaptorRegistry.resolve_package_name/1","doc":"Destructures an NPM style package name into module name and version.\n\n**Example**\n\n iex> resolve_package_name(\"@openfn/language-salesforce@1.2.3\")\n { \"@openfn/language-salesforce\", \"1.2.3\" }\n iex> resolve_package_name(\"@openfn/language-salesforce\")\n { \"@openfn/language-salesforce\", nil }","ref":"Lightning.AdaptorRegistry.html#resolve_package_name/1"},{"type":"function","title":"Lightning.AdaptorRegistry.resolve_package_name!/1","doc":"Same as `resolve_package_name/1` except will throw an exception if a package\nname cannot be matched.","ref":"Lightning.AdaptorRegistry.html#resolve_package_name!/1"},{"type":"function","title":"Lightning.AdaptorRegistry.start_link/1","doc":"Starts the AdaptorRegistry\n\n**Options**\n\n- `:use_cache` (defaults to false) - stores the last set of results on disk\n and uses the cached file for every subsequent start.\n It can either be a boolean, or a string - the latter being a file path\n to set where the cache file is located.\n- `:name` (defaults to AdaptorRegistry) - the name of the process, useful\n for testing and/or running multiple versions of the registry","ref":"Lightning.AdaptorRegistry.html#start_link/1"},{"type":"function","title":"Lightning.AdaptorRegistry.versions_for/2","doc":"Get a list of versions for a given module.","ref":"Lightning.AdaptorRegistry.html#versions_for/2"},{"type":"module","title":"Lightning.AdaptorRegistry.Npm","doc":"NPM API functions","ref":"Lightning.AdaptorRegistry.Npm.html"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.delete/3","doc":"Issues a DELETE request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#delete/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.delete!/3","doc":"Issues a DELETE request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#delete!/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.get/3","doc":"Issues a GET request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#get/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.get!/3","doc":"Issues a GET request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#get!/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.head/3","doc":"Issues a HEAD request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#head/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.head!/3","doc":"Issues a HEAD request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#head!/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.options/3","doc":"Issues an OPTIONS request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#options/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.options!/3","doc":"Issues a OPTIONS request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#options!/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.package_detail/1","doc":"Retrieve all details for an NPM package","ref":"Lightning.AdaptorRegistry.Npm.html#package_detail/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.patch/4","doc":"Issues a PATCH request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#patch/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.patch!/4","doc":"Issues a PATCH request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#patch!/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.post/4","doc":"Issues a POST request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#post/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.post!/4","doc":"Issues a POST request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#post!/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_headers/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_headers/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_request_body/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_request_body/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_request_headers/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_request_headers/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_request_options/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_request_options/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_request_params/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_request_params/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_response/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_response/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_response_chunk/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_response_chunk/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_response_headers/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_response_headers/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_response_status_code/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_response_status_code/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_status_code/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_status_code/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_url/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_url/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.put/4","doc":"Issues a PUT request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#put/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.put!/4","doc":"Issues a PUT request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#put!/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.request/1","doc":"Issues an HTTP request using an `HTTPoison.Request` struct.\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Lightning.AdaptorRegistry.Npm.html#request/1"},{"type":"function","title":"Redirect handling - Lightning.AdaptorRegistry.Npm.request/1","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Lightning.AdaptorRegistry.Npm.html#request/1-redirect-handling"},{"type":"function","title":"Examples - Lightning.AdaptorRegistry.Npm.request/1","doc":"request = %HTTPoison.Request{\n method: :post,\n url: \"https://my.website.com\",\n body: \"{\\\"foo\\\": 3}\",\n headers: [{\"Accept\", \"application/json\"}]\n }\n\n request(request)","ref":"Lightning.AdaptorRegistry.Npm.html#request/1-examples"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.request/5","doc":"Issues an HTTP request with the given method to the given url.\n\nThis function is usually used indirectly by `get/3`, `post/4`, `put/4`, etc\n\nArgs:\n * `method` - HTTP method as an atom (`:get`, `:head`, `:post`, `:put`,\n `:delete`, etc.)\n * `url` - target url as a binary string or char list\n * `body` - request body. See more below\n * `headers` - HTTP headers as an orddict (e.g., `[{\"Accept\", \"application/json\"}]`)\n * `options` - Keyword list of options\n\nBody: see type `HTTPoison.Request`\n\nOptions: see type `HTTPoison.Request`\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Lightning.AdaptorRegistry.Npm.html#request/5"},{"type":"function","title":"Redirect handling - Lightning.AdaptorRegistry.Npm.request/5","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Lightning.AdaptorRegistry.Npm.html#request/5-redirect-handling"},{"type":"function","title":"Examples - Lightning.AdaptorRegistry.Npm.request/5","doc":"request(:post, \"https://my.website.com\", \"{\\\"foo\\\": 3}\", [{\"Accept\", \"application/json\"}])","ref":"Lightning.AdaptorRegistry.Npm.html#request/5-examples"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.request!/1","doc":"Issues an HTTP request an `HTTPoison.Request` struct.\nexception in case of failure.\n\n`request!/1` works exactly like `request/1` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Lightning.AdaptorRegistry.Npm.html#request!/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.request!/5","doc":"Issues an HTTP request with the given method to the given url, raising an\nexception in case of failure.\n\n`request!/5` works exactly like `request/5` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Lightning.AdaptorRegistry.Npm.html#request!/5"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.start/0","doc":"Starts HTTPoison and its dependencies.","ref":"Lightning.AdaptorRegistry.Npm.html#start/0"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.stream_next/1","doc":"Requests the next message to be streamed for a given `HTTPoison.AsyncResponse`.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#stream_next/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.user_packages/1","doc":"Retrieve all packages for a given user or organization. Return empty list if\napplication cannot connect to NPM. (E.g., because it's started offline.)","ref":"Lightning.AdaptorRegistry.Npm.html#user_packages/1"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.body/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:body/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.headers/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:headers/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.method/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:method/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.options/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:options/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.params/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:params/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.request/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:request/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.url/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:url/0"},{"type":"module","title":"Lightning.AdaptorService","doc":"The Adaptor Service is use to query and install adaptors in order to run jobs.\n\nOn startup, it queries the filesystem for `package.json` files and builds up\na list of available adaptors.","ref":"Lightning.AdaptorService.html"},{"type":"module","title":"Configuration - Lightning.AdaptorService","doc":"The service requires at least `:adaptors_path`, which is used to both query\nwhich adaptors are installed and when to install new adaptors.\n\nAnother optional setting is: `:repo`, which must point at a module that will be\nused to do the querying and installing.","ref":"Lightning.AdaptorService.html#module-configuration"},{"type":"module","title":"Installing Adaptors - Lightning.AdaptorService","doc":"Using the `install/2` function an adaptor can be installed, which will also\nadd it to the list of available adaptors.\n\nThe adaptor is marked as `:installing`, to allow for conditional behaviour\nelsewhere such as delaying or rejecting processing until the adaptor becomes\navailable.","ref":"Lightning.AdaptorService.html#module-installing-adaptors"},{"type":"module","title":"Looking up adaptors - Lightning.AdaptorService","doc":"The module leans on Elixir's built-in `Version` module to provide version\nlookups.\n\nWhen looking up an adaptor, either a string or a tuple can be used.\nIn the case of requesting the latest version, any one of these will return\nthe latest version the service is aware of.\n\n- `@openfn/language-http`\n- `@openfn/language-http@latest`\n- `{\"@openfn/language-http\", nil}`\n- `{\"@openfn/language-http\", \"latest\"}`\n- `{~r/language-http/, \"latest\"}`\n\nYou can also request a specific version, or use a range specification:\n\n- `@openfn/language-http@1.2.3`\n- `{\"@openfn/language-http\", \"~> 1.2.0\"}`\n- `{\"@openfn/language-http\", \"< 2.0.0\"}`\n\n> **NOTE**\n> More complex npm style install strings like: `\">=0.1.0 <0.2.0\"`\n> are not supported.\n> Generally the tuple style is preferred when using range specifications as\n> the npm style strings have a simplistic regex splitter.\n\nSee [Version](https://hexdocs.pm/elixir/Version.html) for more details on\nmatching versions.","ref":"Lightning.AdaptorService.html#module-looking-up-adaptors"},{"type":"function","title":"Lightning.AdaptorService.build_aliased_name/1","doc":"Turns a package name and version into a string for NPM.\n\nSince multiple versions of the same package can be installed, it's important\nto rely on npms built-in package aliasing.\n\nE.g. `@openfn/language-http@1.2.8` turns into:\n `@openfn/language-http-1.2.8@npm:@openfn/language-http@1.2.8`\n\nWhich is pretty long winded but necessary for the reason above.\n\nIf using this module as a base, it's likely you would need to adaptor this\nto suit your particular naming strategy.","ref":"Lightning.AdaptorService.html#build_aliased_name/1"},{"type":"function","title":"Lightning.AdaptorService.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.AdaptorService.html#child_spec/1"},{"type":"function","title":"Lightning.AdaptorService.find_adaptor/2","doc":"","ref":"Lightning.AdaptorService.html#find_adaptor/2"},{"type":"function","title":"Lightning.AdaptorService.get_adaptors/1","doc":"","ref":"Lightning.AdaptorService.html#get_adaptors/1"},{"type":"function","title":"Lightning.AdaptorService.install/2","doc":"","ref":"Lightning.AdaptorService.html#install/2"},{"type":"function","title":"Lightning.AdaptorService.install!/2","doc":"","ref":"Lightning.AdaptorService.html#install!/2"},{"type":"function","title":"Lightning.AdaptorService.installed?/2","doc":"","ref":"Lightning.AdaptorService.html#installed?/2"},{"type":"function","title":"Lightning.AdaptorService.resolve_package_name/1","doc":"","ref":"Lightning.AdaptorService.html#resolve_package_name/1"},{"type":"function","title":"Lightning.AdaptorService.start_link/1","doc":"","ref":"Lightning.AdaptorService.html#start_link/1"},{"type":"type","title":"Lightning.AdaptorService.package_spec/0","doc":"","ref":"Lightning.AdaptorService.html#t:package_spec/0"},{"type":"module","title":"Lightning.AiAssistant","doc":"The AI assistant module.","ref":"Lightning.AiAssistant.html"},{"type":"function","title":"Lightning.AiAssistant.available?/1","doc":"","ref":"Lightning.AiAssistant.html#available?/1"},{"type":"function","title":"Lightning.AiAssistant.create_session/3","doc":"","ref":"Lightning.AiAssistant.html#create_session/3"},{"type":"function","title":"Lightning.AiAssistant.enabled?/0","doc":"Checks if the AI assistant is enabled.","ref":"Lightning.AiAssistant.html#enabled?/0"},{"type":"function","title":"Lightning.AiAssistant.endpoint_available?/0","doc":"Checks if the Apollo endpoint is available.","ref":"Lightning.AiAssistant.html#endpoint_available?/0"},{"type":"function","title":"Lightning.AiAssistant.get_session!/1","doc":"","ref":"Lightning.AiAssistant.html#get_session!/1"},{"type":"function","title":"Lightning.AiAssistant.list_sessions_for_job/1","doc":"","ref":"Lightning.AiAssistant.html#list_sessions_for_job/1"},{"type":"function","title":"Lightning.AiAssistant.project_has_any_session?/1","doc":"","ref":"Lightning.AiAssistant.html#project_has_any_session?/1"},{"type":"function","title":"Lightning.AiAssistant.put_expression_and_adaptor/3","doc":"","ref":"Lightning.AiAssistant.html#put_expression_and_adaptor/3"},{"type":"function","title":"Lightning.AiAssistant.query/2","doc":"Queries the AI assistant with the given content.\n\nReturns `{:ok, session}` if the query was successful, otherwise `:error`.\n\n**Example**\n\n iex> AiAssistant.query(session, \"fn()\")\n {:ok, session}","ref":"Lightning.AiAssistant.html#query/2"},{"type":"function","title":"Lightning.AiAssistant.save_message/2","doc":"","ref":"Lightning.AiAssistant.html#save_message/2"},{"type":"module","title":"Lightning.AiAssistant.Limiter","doc":"The AI assistant limiter to check for AI query quota.","ref":"Lightning.AiAssistant.Limiter.html"},{"type":"function","title":"Lightning.AiAssistant.Limiter.validate_quota/1","doc":"Checks if has not reached the limit of the project ai queries quota.","ref":"Lightning.AiAssistant.Limiter.html#validate_quota/1"},{"type":"module","title":"Lightning.ApolloClient","doc":"Client for communicating with the Apollo service.","ref":"Lightning.ApolloClient.html"},{"type":"function","title":"Lightning.ApolloClient.query/3","doc":"","ref":"Lightning.ApolloClient.html#query/3"},{"type":"function","title":"Lightning.ApolloClient.test/0","doc":"Checks if the Apollo endpoint is available.","ref":"Lightning.ApolloClient.html#test/0"},{"type":"type","title":"Lightning.ApolloClient.context/0","doc":"","ref":"Lightning.ApolloClient.html#t:context/0"},{"type":"module","title":"Lightning.Auditing","doc":"Context for working with Audit records.","ref":"Lightning.Auditing.html"},{"type":"function","title":"Lightning.Auditing.list_all/1","doc":"","ref":"Lightning.Auditing.html#list_all/1"},{"type":"behaviour","title":"Lightning.Auditing.Audit","doc":"Macro module to add common model behaviour to a given Ecto model","ref":"Lightning.Auditing.Audit.html"},{"type":"function","title":"Lightning.Auditing.Audit.event/7","doc":"Creates a `changeset` for the `event` identified by `item_id` and caused\nby `actor_id`.\n\nThe given `changes` can be either `nil`, `Ecto.Changeset`, struct or map.\n\nIt returns `:no_changes` in case of an `Ecto.Changeset` changes that changed nothing\nor an `Ecto.Changeset` with the event ready to be inserted.","ref":"Lightning.Auditing.Audit.html#event/7"},{"type":"function","title":"Lightning.Auditing.Audit.save/2","doc":"Saves the event to the `Repo`.\n\nIn case of nothing changes, do nothing.\n\nIt returns `{:ok, :no_changes}` if nothing changed, `{:ok, struct}` if the log\nhas been successfully saved or `{:error, changeset}` in case of error.","ref":"Lightning.Auditing.Audit.html#save/2"},{"type":"callback","title":"Lightning.Auditing.Audit.update_changes/1","doc":"Callback to update changes before saving to the database.","ref":"Lightning.Auditing.Audit.html#c:update_changes/1"},{"type":"module","title":"Lightning.AuthProviders","doc":"Context module for dealing with external Auth Providers.","ref":"Lightning.AuthProviders.html"},{"type":"function","title":"Lightning.AuthProviders.build_handler/2","doc":"","ref":"Lightning.AuthProviders.html#build_handler/2"},{"type":"function","title":"Lightning.AuthProviders.create/1","doc":"","ref":"Lightning.AuthProviders.html#create/1"},{"type":"function","title":"Lightning.AuthProviders.create_handler/1","doc":"","ref":"Lightning.AuthProviders.html#create_handler/1"},{"type":"function","title":"Lightning.AuthProviders.delete!/1","doc":"","ref":"Lightning.AuthProviders.html#delete!/1"},{"type":"function","title":"Lightning.AuthProviders.get_authorize_url/1","doc":"Retrieve the authorization url for a given handler or handler name.","ref":"Lightning.AuthProviders.html#get_authorize_url/1"},{"type":"function","title":"Lightning.AuthProviders.get_existing/0","doc":"","ref":"Lightning.AuthProviders.html#get_existing/0"},{"type":"function","title":"Lightning.AuthProviders.get_existing/1","doc":"","ref":"Lightning.AuthProviders.html#get_existing/1"},{"type":"function","title":"Lightning.AuthProviders.get_handler/1","doc":"","ref":"Lightning.AuthProviders.html#get_handler/1"},{"type":"function","title":"Lightning.AuthProviders.get_handlers/0","doc":"","ref":"Lightning.AuthProviders.html#get_handlers/0"},{"type":"function","title":"Lightning.AuthProviders.new/0","doc":"","ref":"Lightning.AuthProviders.html#new/0"},{"type":"function","title":"Lightning.AuthProviders.remove_handler/1","doc":"","ref":"Lightning.AuthProviders.html#remove_handler/1"},{"type":"function","title":"Lightning.AuthProviders.update/2","doc":"","ref":"Lightning.AuthProviders.html#update/2"},{"type":"module","title":"Lightning.AuthProviders.AuthConfig","doc":"AuthProvider model","ref":"Lightning.AuthProviders.AuthConfig.html"},{"type":"type","title":"Lightning.AuthProviders.AuthConfig.t/0","doc":"","ref":"Lightning.AuthProviders.AuthConfig.html#t:t/0"},{"type":"module","title":"Lightning.AuthProviders.CacheWarmer","doc":"Dummy warmer which caches database rows every 30s.","ref":"Lightning.AuthProviders.CacheWarmer.html"},{"type":"function","title":"Lightning.AuthProviders.CacheWarmer.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.AuthProviders.CacheWarmer.html#child_spec/1"},{"type":"function","title":"Lightning.AuthProviders.CacheWarmer.execute/1","doc":"Executes this cache warmer with a connection.","ref":"Lightning.AuthProviders.CacheWarmer.html#execute/1"},{"type":"function","title":"Lightning.AuthProviders.CacheWarmer.interval/0","doc":"Returns the interval for this warmer.","ref":"Lightning.AuthProviders.CacheWarmer.html#interval/0"},{"type":"module","title":"Lightning.AuthProviders.Common","doc":"Provides common functionality for handling OAuth authentication across different providers.","ref":"Lightning.AuthProviders.Common.html"},{"type":"function","title":"Lightning.AuthProviders.Common.authorize_url/4","doc":"Constructs the authorization URL with the given client, state, scopes, and options.","ref":"Lightning.AuthProviders.Common.html#authorize_url/4"},{"type":"function","title":"Lightning.AuthProviders.Common.build_client/3","doc":"Builds a new OAuth client with the specified configuration, authorization URL, token URL, and options.","ref":"Lightning.AuthProviders.Common.html#build_client/3"},{"type":"function","title":"Lightning.AuthProviders.Common.get_token/2","doc":"Requests an authentication token from the OAuth provider.","ref":"Lightning.AuthProviders.Common.html#get_token/2"},{"type":"function","title":"Lightning.AuthProviders.Common.get_userinfo/3","doc":"Retrieves user information from the OAuth provider.","ref":"Lightning.AuthProviders.Common.html#get_userinfo/3"},{"type":"function","title":"Lightning.AuthProviders.Common.get_wellknown/1","doc":"Fetches the well-known configuration from the OAuth provider.","ref":"Lightning.AuthProviders.Common.html#get_wellknown/1"},{"type":"function","title":"Lightning.AuthProviders.Common.get_wellknown!/1","doc":"Fetches the well-known configuration from the OAuth provider and raises an error if not successful.","ref":"Lightning.AuthProviders.Common.html#get_wellknown!/1"},{"type":"function","title":"Lightning.AuthProviders.Common.introspect/3","doc":"","ref":"Lightning.AuthProviders.Common.html#introspect/3"},{"type":"function","title":"Lightning.AuthProviders.Common.refresh_token/2","doc":"Refreshes the authentication token using the OAuth provider.","ref":"Lightning.AuthProviders.Common.html#refresh_token/2"},{"type":"function","title":"Lightning.AuthProviders.Common.still_fresh/3","doc":"Checks if a token is still valid or must be refreshed. If expires_at is nil,\nit will return `false`, forcing a refresh. If the token has already expired or\nwill expire before the default buffer (in the next 5 minutes) we return\n`false`, forcing a refresh.","ref":"Lightning.AuthProviders.Common.html#still_fresh/3"},{"type":"module","title":"Lightning.AuthProviders.Common.TokenBody","doc":"Defines a schema for OAuth token information.","ref":"Lightning.AuthProviders.Common.TokenBody.html"},{"type":"function","title":"Lightning.AuthProviders.Common.TokenBody.from_oauth2_token/1","doc":"Converts an OAuth2 token to a TokenBody struct.","ref":"Lightning.AuthProviders.Common.TokenBody.html#from_oauth2_token/1"},{"type":"function","title":"Lightning.AuthProviders.Common.TokenBody.new/1","doc":"Creates a new TokenBody struct with the given attributes.","ref":"Lightning.AuthProviders.Common.TokenBody.html#new/1"},{"type":"module","title":"Lightning.AuthProviders.Google","doc":"Handles the specifics of the Google OAuth authentication process.","ref":"Lightning.AuthProviders.Google.html"},{"type":"function","title":"Lightning.AuthProviders.Google.provider_name/0","doc":"","ref":"Lightning.AuthProviders.Google.html#provider_name/0"},{"type":"function","title":"Lightning.AuthProviders.Google.scopes/0","doc":"","ref":"Lightning.AuthProviders.Google.html#scopes/0"},{"type":"function","title":"Lightning.AuthProviders.Google.scopes_doc_url/0","doc":"","ref":"Lightning.AuthProviders.Google.html#scopes_doc_url/0"},{"type":"function","title":"Lightning.AuthProviders.Google.wellknown_url/1","doc":"","ref":"Lightning.AuthProviders.Google.html#wellknown_url/1"},{"type":"module","title":"Lightning.AuthProviders.Handler","doc":"Module which wraps Oauth configuration and a WellKnown document\ninto a convenient struct that can be used to authenticate users against\nany OIDC compliant provider.","ref":"Lightning.AuthProviders.Handler.html"},{"type":"function","title":"Lightning.AuthProviders.Handler.authorize_url/1","doc":"","ref":"Lightning.AuthProviders.Handler.html#authorize_url/1"},{"type":"function","title":"Lightning.AuthProviders.Handler.from_model/1","doc":"Returns a Handler from a given AuthConfig","ref":"Lightning.AuthProviders.Handler.html#from_model/1"},{"type":"function","title":"Lightning.AuthProviders.Handler.get_token/2","doc":"","ref":"Lightning.AuthProviders.Handler.html#get_token/2"},{"type":"function","title":"Lightning.AuthProviders.Handler.get_userinfo/2","doc":"","ref":"Lightning.AuthProviders.Handler.html#get_userinfo/2"},{"type":"function","title":"Lightning.AuthProviders.Handler.new/2","doc":"Create a new Provider struct, expects a name and opts:\n\n- `:client_id` - The providers issued id\n- `:client_secret` - Secret for the client\n- `:redirect_uri` - The URI for redirecting after authentication,\n usually the callback url in the router.\n- `:wellknown` - A AuthProviders.WellKnown struct with the providers\n `.well-known/openid-configuration`.","ref":"Lightning.AuthProviders.Handler.html#new/2"},{"type":"type","title":"Lightning.AuthProviders.Handler.opts/0","doc":"","ref":"Lightning.AuthProviders.Handler.html#t:opts/0"},{"type":"type","title":"Lightning.AuthProviders.Handler.t/0","doc":"","ref":"Lightning.AuthProviders.Handler.html#t:t/0"},{"type":"behaviour","title":"Lightning.AuthProviders.OAuthBehaviour","doc":"Defines a behaviour for OAuth providers within the Lightning application,\nspecifying a common interface for OAuth operations.\nThis interface ensures consistency and interoperability among different\nauthentication providers (e.g., Google, Salesforce)\nby defining a set of required functions that each provider must implement.","ref":"Lightning.AuthProviders.OAuthBehaviour.html"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.authorize_url/4","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:authorize_url/4"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.build_client/1","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:build_client/1"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.get_token/3","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:get_token/3"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.get_userinfo/3","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:get_userinfo/3"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.refresh_token/2","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:refresh_token/2"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.refresh_token/3","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:refresh_token/3"},{"type":"module","title":"Lightning.AuthProviders.OauthHTTPClient","doc":"Handles OAuth interactions for generic providers, including token fetching,\nrefreshing, and user information retrieval. This module uses Tesla to make HTTP\nrequests configured with middleware appropriate for OAuth specific tasks.","ref":"Lightning.AuthProviders.OauthHTTPClient.html"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.delete/3","doc":"Perform a DELETE request.\n\nSee `request/1` or `request/2` for options definition.\n\n delete(\"/users\")\n delete(\"/users\", query: [scope: \"admin\"])\n delete(client, \"/users\")\n delete(client, \"/users\", query: [scope: \"admin\"])\n delete(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#delete/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.delete!/3","doc":"Perform a DELETE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n delete!(\"/users\")\n delete!(\"/users\", query: [scope: \"admin\"])\n delete!(client, \"/users\")\n delete!(client, \"/users\", query: [scope: \"admin\"])\n delete!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#delete!/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.fetch_token/2","doc":"Fetches a new token using the authorization code provided by the OAuth provider.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_token/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.fetch_token/2","doc":"- `client`: The client configuration containing client_id, client_secret, and token_endpoint.\n- `code`: The authorization code received from the OAuth provider.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_token/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.fetch_token/2","doc":"- `{:ok, token_data}` on success\n- `{:error, reason}` on failure","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_token/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.fetch_userinfo/2","doc":"Fetches user information from the OAuth provider using a valid access token.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_userinfo/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.fetch_userinfo/2","doc":"- `client`: The client configuration containing userinfo_endpoint.\n- `token`: The token configuration containing access_token.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_userinfo/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.fetch_userinfo/2","doc":"- `{:ok, user_info}` on success\n- `{:error, reason}` on failure","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_userinfo/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.generate_authorize_url/2","doc":"Generates an authorization URL with specified parameters.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#generate_authorize_url/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.generate_authorize_url/2","doc":"- `client`: The client configuration containing client_id, and authorization_endpoint.\n- `params`: Additional parameters to include in the authorization URL.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#generate_authorize_url/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.generate_authorize_url/2","doc":"- The fully formed authorization URL as a string.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#generate_authorize_url/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.get/3","doc":"Perform a GET request.\n\nSee `request/1` or `request/2` for options definition.\n\n get(\"/users\")\n get(\"/users\", query: [scope: \"admin\"])\n get(client, \"/users\")\n get(client, \"/users\", query: [scope: \"admin\"])\n get(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#get/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.get!/3","doc":"Perform a GET request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n get!(\"/users\")\n get!(\"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\")\n get!(client, \"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#get!/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.head/3","doc":"Perform a HEAD request.\n\nSee `request/1` or `request/2` for options definition.\n\n head(\"/users\")\n head(\"/users\", query: [scope: \"admin\"])\n head(client, \"/users\")\n head(client, \"/users\", query: [scope: \"admin\"])\n head(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#head/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.head!/3","doc":"Perform a HEAD request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n head!(\"/users\")\n head!(\"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\")\n head!(client, \"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#head!/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.options/3","doc":"Perform a OPTIONS request.\n\nSee `request/1` or `request/2` for options definition.\n\n options(\"/users\")\n options(\"/users\", query: [scope: \"admin\"])\n options(client, \"/users\")\n options(client, \"/users\", query: [scope: \"admin\"])\n options(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#options/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.options!/3","doc":"Perform a OPTIONS request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n options!(\"/users\")\n options!(\"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\")\n options!(client, \"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#options!/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.patch/4","doc":"Perform a PATCH request.\n\nSee `request/1` or `request/2` for options definition.\n\n patch(\"/users\", %{name: \"Jon\"})\n patch(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch(client, \"/users\", %{name: \"Jon\"})\n patch(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#patch/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.patch!/4","doc":"Perform a PATCH request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n patch!(\"/users\", %{name: \"Jon\"})\n patch!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch!(client, \"/users\", %{name: \"Jon\"})\n patch!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#patch!/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.post/4","doc":"Perform a POST request.\n\nSee `request/1` or `request/2` for options definition.\n\n post(\"/users\", %{name: \"Jon\"})\n post(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n post(client, \"/users\", %{name: \"Jon\"})\n post(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#post/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.post!/4","doc":"Perform a POST request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n post!(\"/users\", %{name: \"Jon\"})\n post!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n post!(client, \"/users\", %{name: \"Jon\"})\n post!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#post!/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.put/4","doc":"Perform a PUT request.\n\nSee `request/1` or `request/2` for options definition.\n\n put(\"/users\", %{name: \"Jon\"})\n put(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n put(client, \"/users\", %{name: \"Jon\"})\n put(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#put/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.put!/4","doc":"Perform a PUT request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n put!(\"/users\", %{name: \"Jon\"})\n put!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n put!(client, \"/users\", %{name: \"Jon\"})\n put!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#put!/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.refresh_token/2","doc":"Refreshes an existing token using the refresh token.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#refresh_token/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.refresh_token/2","doc":"- `client`: The client configuration containing client_id, client_secret, and token_endpoint.\n- `token`: The token configuration containing refresh_token","ref":"Lightning.AuthProviders.OauthHTTPClient.html#refresh_token/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.refresh_token/2","doc":"- `{:ok, refreshed_token_data}` on success\n- `{:error, reason}` on failure","ref":"Lightning.AuthProviders.OauthHTTPClient.html#refresh_token/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.request/2","doc":"Perform a request.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#request/2"},{"type":"function","title":"Options - Lightning.AuthProviders.OauthHTTPClient.request/2","doc":"- `:method` - the request method, one of [`:head`, `:get`, `:delete`, `:trace`, `:options`, `:post`, `:put`, `:patch`]\n- `:url` - either full url e.g. \"http://example.com/some/path\" or just \"/some/path\" if using `Tesla.Middleware.BaseUrl`\n- `:query` - a keyword list of query params, e.g. `[page: 1, per_page: 100]`\n- `:headers` - a keyword list of headers, e.g. `[{\"content-type\", \"text/plain\"}]`\n- `:body` - depends on used middleware:\n - by default it can be a binary\n - if using e.g. JSON encoding middleware it can be a nested map\n - if adapter supports it it can be a Stream with any of the above\n- `:opts` - custom, per-request middleware or adapter options","ref":"Lightning.AuthProviders.OauthHTTPClient.html#request/2-options"},{"type":"function","title":"Examples - Lightning.AuthProviders.OauthHTTPClient.request/2","doc":"ExampleApi.request(method: :get, url: \"/users/path\")\n\n # use shortcut methods\n ExampleApi.get(\"/users/1\")\n ExampleApi.post(client, \"/users\", %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#request/2-examples"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.request!/2","doc":"Perform request and raise in case of error.\n\nThis is similar to `request/2` behaviour from Tesla 0.x\n\nSee `request/2` for list of available options.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#request!/2"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.revoke_token/2","doc":"Revokes an OAuth token.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#revoke_token/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.revoke_token/2","doc":"- `client`: The client configuration containing client_id and client_secret.\n- `token`: The token to be revoked (access_token or refresh_token).","ref":"Lightning.AuthProviders.OauthHTTPClient.html#revoke_token/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.revoke_token/2","doc":"- `{:ok, response}` on success\n- `{:error, reason}` on failure","ref":"Lightning.AuthProviders.OauthHTTPClient.html#revoke_token/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.still_fresh/3","doc":"Determines if the token data is still considered fresh.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#still_fresh/3"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.still_fresh/3","doc":"- `token`: a map containing token data with `expires_at` or `expires_in` keys.\n- `threshold`: the number of time units before expiration to consider the token still fresh.\n- `time_unit`: the unit of time to consider for the threshold comparison.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#still_fresh/3-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.still_fresh/3","doc":"- `true` if the token is fresh.\n- `{:error, reason}` if the token's expiration data is missing or invalid.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#still_fresh/3-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.trace/3","doc":"Perform a TRACE request.\n\nSee `request/1` or `request/2` for options definition.\n\n trace(\"/users\")\n trace(\"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\")\n trace(client, \"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#trace/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.trace!/3","doc":"Perform a TRACE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n trace!(\"/users\")\n trace!(\"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\")\n trace!(client, \"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#trace!/3"},{"type":"type","title":"Lightning.AuthProviders.OauthHTTPClient.option/0","doc":"Options that may be passed to a request function. See `request/2` for detailed descriptions.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#t:option/0"},{"type":"module","title":"Lightning.AuthProviders.Salesforce","doc":"Handles the specifics of the Salesforce OAuth authentication process.","ref":"Lightning.AuthProviders.Salesforce.html"},{"type":"function","title":"Lightning.AuthProviders.Salesforce.provider_name/0","doc":"","ref":"Lightning.AuthProviders.Salesforce.html#provider_name/0"},{"type":"function","title":"Lightning.AuthProviders.Salesforce.scopes/0","doc":"","ref":"Lightning.AuthProviders.Salesforce.html#scopes/0"},{"type":"function","title":"Lightning.AuthProviders.Salesforce.scopes_doc_url/0","doc":"","ref":"Lightning.AuthProviders.Salesforce.html#scopes_doc_url/0"},{"type":"function","title":"Lightning.AuthProviders.Salesforce.wellknown_url/1","doc":"","ref":"Lightning.AuthProviders.Salesforce.html#wellknown_url/1"},{"type":"module","title":"Lightning.AuthProviders.Store","doc":"Store module for caching Handlers.\n\nSince Handlers often have to fetch their `.well-known` files when being\ninitialized we cache these in order to avoid repeatedly making HTTP requests\nto a providers API.","ref":"Lightning.AuthProviders.Store.html"},{"type":"function","title":"Lightning.AuthProviders.Store.get_handler/2","doc":"","ref":"Lightning.AuthProviders.Store.html#get_handler/2"},{"type":"function","title":"Lightning.AuthProviders.Store.get_handlers/0","doc":"","ref":"Lightning.AuthProviders.Store.html#get_handlers/0"},{"type":"function","title":"Lightning.AuthProviders.Store.put_handler/2","doc":"","ref":"Lightning.AuthProviders.Store.html#put_handler/2"},{"type":"function","title":"Lightning.AuthProviders.Store.remove_handler/1","doc":"","ref":"Lightning.AuthProviders.Store.html#remove_handler/1"},{"type":"type","title":"Lightning.AuthProviders.Store.finder/0","doc":"","ref":"Lightning.AuthProviders.Store.html#t:finder/0"},{"type":"module","title":"Lightning.AuthProviders.WellKnown","doc":"A datastructure to fetch and hold information about a given OIDC/OAuth provider","ref":"Lightning.AuthProviders.WellKnown.html"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.delete/3","doc":"Issues a DELETE request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#delete/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.delete!/3","doc":"Issues a DELETE request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#delete!/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.fetch/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#fetch/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.fetch!/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#fetch!/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.get/3","doc":"Issues a GET request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#get/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.get!/3","doc":"Issues a GET request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#get!/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.head/3","doc":"Issues a HEAD request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#head/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.head!/3","doc":"Issues a HEAD request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#head!/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.new/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#new/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.options/3","doc":"Issues an OPTIONS request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#options/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.options!/3","doc":"Issues a OPTIONS request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#options!/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.patch/4","doc":"Issues a PATCH request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#patch/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.patch!/4","doc":"Issues a PATCH request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#patch!/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.post/4","doc":"Issues a POST request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#post/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.post!/4","doc":"Issues a POST request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#post!/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_headers/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_headers/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_body/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_body/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_headers/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_headers/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_options/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_options/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_params/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_params/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_url/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_url/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response_body/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response_body/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response_chunk/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response_chunk/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response_headers/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response_headers/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response_status_code/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response_status_code/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_status_code/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_status_code/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_url/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_url/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.put/4","doc":"Issues a PUT request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#put/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.put!/4","doc":"Issues a PUT request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#put!/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.request/1","doc":"Issues an HTTP request using an `HTTPoison.Request` struct.\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Lightning.AuthProviders.WellKnown.html#request/1"},{"type":"function","title":"Redirect handling - Lightning.AuthProviders.WellKnown.request/1","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Lightning.AuthProviders.WellKnown.html#request/1-redirect-handling"},{"type":"function","title":"Examples - Lightning.AuthProviders.WellKnown.request/1","doc":"request = %HTTPoison.Request{\n method: :post,\n url: \"https://my.website.com\",\n body: \"{\\\"foo\\\": 3}\",\n headers: [{\"Accept\", \"application/json\"}]\n }\n\n request(request)","ref":"Lightning.AuthProviders.WellKnown.html#request/1-examples"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.request/5","doc":"Issues an HTTP request with the given method to the given url.\n\nThis function is usually used indirectly by `get/3`, `post/4`, `put/4`, etc\n\nArgs:\n * `method` - HTTP method as an atom (`:get`, `:head`, `:post`, `:put`,\n `:delete`, etc.)\n * `url` - target url as a binary string or char list\n * `body` - request body. See more below\n * `headers` - HTTP headers as an orddict (e.g., `[{\"Accept\", \"application/json\"}]`)\n * `options` - Keyword list of options\n\nBody: see type `HTTPoison.Request`\n\nOptions: see type `HTTPoison.Request`\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Lightning.AuthProviders.WellKnown.html#request/5"},{"type":"function","title":"Redirect handling - Lightning.AuthProviders.WellKnown.request/5","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Lightning.AuthProviders.WellKnown.html#request/5-redirect-handling"},{"type":"function","title":"Examples - Lightning.AuthProviders.WellKnown.request/5","doc":"request(:post, \"https://my.website.com\", \"{\\\"foo\\\": 3}\", [{\"Accept\", \"application/json\"}])","ref":"Lightning.AuthProviders.WellKnown.html#request/5-examples"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.request!/1","doc":"Issues an HTTP request an `HTTPoison.Request` struct.\nexception in case of failure.\n\n`request!/1` works exactly like `request/1` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Lightning.AuthProviders.WellKnown.html#request!/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.request!/5","doc":"Issues an HTTP request with the given method to the given url, raising an\nexception in case of failure.\n\n`request!/5` works exactly like `request/5` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Lightning.AuthProviders.WellKnown.html#request!/5"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.start/0","doc":"Starts HTTPoison and its dependencies.","ref":"Lightning.AuthProviders.WellKnown.html#start/0"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.stream_next/1","doc":"Requests the next message to be streamed for a given `HTTPoison.AsyncResponse`.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#stream_next/1"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.body/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:body/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.headers/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:headers/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.method/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:method/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.options/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:options/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.params/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:params/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.request/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:request/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.t/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:t/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.url/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:url/0"},{"type":"module","title":"Lightning.BuildMacros","doc":"Macros for building Lightning.","ref":"Lightning.BuildMacros.html"},{"type":"macro","title":"Lightning.BuildMacros.do_in/2","doc":"Conditionally evaluates the block if the current environment is in the\ngiven list of environments.","ref":"Lightning.BuildMacros.html#do_in/2"},{"type":"macro","title":"Examples - Lightning.BuildMacros.do_in/2","doc":"do_in(:dev) do\n IO.puts(\"This will only be printed in the dev environment\")\n end\n\n do_in([:dev, :test]) do\n IO.puts(\"This will only be printed in the dev and test environments\")\n end","ref":"Lightning.BuildMacros.html#do_in/2-examples"},{"type":"module","title":"Lightning.CLI","doc":"Module providing facilities to make calls to the OpenFn CLI.\n\nSee [@openfn/cli](https://github.com/OpenFn/kit/tree/main/packages/cli#openfncli)","ref":"Lightning.CLI.html"},{"type":"function","title":"Lightning.CLI.execute/1","doc":"Execute a command in a child process and parse the results.","ref":"Lightning.CLI.html#execute/1"},{"type":"function","title":"Lightning.CLI.metadata/2","doc":"Retrieve metadata for a given adaptor and configuration.","ref":"Lightning.CLI.html#metadata/2"},{"type":"module","title":"Lightning.CLI.Result","doc":"Struct that wraps the output of an OpenFn CLI call.\n\nContaining the keys:\n\n- `start_time`\n- `end_time`\n- `status`\n- `logs`","ref":"Lightning.CLI.Result.html"},{"type":"module","title":"Logs - Lightning.CLI.Result","doc":"The OpenFn CLI returns JSON formatted log lines, which are decoded and added\nto a `Result` struct.\n\nThere are two kinds of output:\n\n```\n{\"level\":\"< >\",\"name\":\"< >\",\"message\":\"...\"],\"time\":< >}\n```\n\nThese are usually for general logging, and debugging.\n\n```\n{\"message\":[\"< >\"]}\n```\n\nThe above is the equivalent of the output of a command","ref":"Lightning.CLI.Result.html#module-logs"},{"type":"function","title":"Lightning.CLI.Result.get_messages/1","doc":"Returns `message` type log lines from a `Result`.","ref":"Lightning.CLI.Result.html#get_messages/1"},{"type":"function","title":"Lightning.CLI.Result.new/1","doc":"","ref":"Lightning.CLI.Result.html#new/1"},{"type":"function","title":"Lightning.CLI.Result.parse/2","doc":"","ref":"Lightning.CLI.Result.html#parse/2"},{"type":"type","title":"Lightning.CLI.Result.t/0","doc":"","ref":"Lightning.CLI.Result.html#t:t/0"},{"type":"module","title":"Lightning.ChangesetUtils","doc":"Extra functions for Ecto.Changeset.","ref":"Lightning.ChangesetUtils.html"},{"type":"function","title":"Lightning.ChangesetUtils.put_if_provided/3","doc":"Puts a new change in the changeset if the params have the field.\n\nUseful when params don't have a given key and you don't want to set the\nfield to `nil`.","ref":"Lightning.ChangesetUtils.html#put_if_provided/3"},{"type":"function","title":"Lightning.ChangesetUtils.put_new_change/3","doc":"Puts a new change in the changeset if the field is not already set.\n\nNOTE: This function considers a field with a `nil` value as not set.","ref":"Lightning.ChangesetUtils.html#put_new_change/3"},{"type":"module","title":"Lightning.Collections","doc":"Access to collections of unique key-value pairs shared across multiple workflows.","ref":"Lightning.Collections.html"},{"type":"function","title":"Lightning.Collections.create_collection/1","doc":"Creates a new collection with the given attributes.","ref":"Lightning.Collections.html#create_collection/1"},{"type":"function","title":"Parameters - Lightning.Collections.create_collection/1","doc":"- `attrs`: A map of attributes to create the collection.","ref":"Lightning.Collections.html#create_collection/1-parameters"},{"type":"function","title":"Examples - Lightning.Collections.create_collection/1","doc":"iex> create_collection(%{name: \"New Collection\", description: \"Description here\"})\n {:ok, %Collection{}}\n\n iex> create_collection(%{name: nil})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Collections.html#create_collection/1-examples"},{"type":"function","title":"Returns - Lightning.Collections.create_collection/1","doc":"- `{:ok, %Collection{}}` on success.\n - `{:error, %Ecto.Changeset{}}` on failure due to validation errors.","ref":"Lightning.Collections.html#create_collection/1-returns"},{"type":"function","title":"Lightning.Collections.create_collection/2","doc":"","ref":"Lightning.Collections.html#create_collection/2"},{"type":"function","title":"Lightning.Collections.delete/2","doc":"","ref":"Lightning.Collections.html#delete/2"},{"type":"function","title":"Lightning.Collections.delete_all/2","doc":"","ref":"Lightning.Collections.html#delete_all/2"},{"type":"function","title":"Lightning.Collections.delete_collection/1","doc":"","ref":"Lightning.Collections.html#delete_collection/1"},{"type":"function","title":"Lightning.Collections.get/2","doc":"","ref":"Lightning.Collections.html#get/2"},{"type":"function","title":"Lightning.Collections.get_all/3","doc":"","ref":"Lightning.Collections.html#get_all/3"},{"type":"function","title":"Lightning.Collections.get_collection/1","doc":"","ref":"Lightning.Collections.html#get_collection/1"},{"type":"function","title":"Lightning.Collections.list_collections/1","doc":"Returns the list of collections with optional ordering and preloading.","ref":"Lightning.Collections.html#list_collections/1"},{"type":"function","title":"Parameters - Lightning.Collections.list_collections/1","doc":"- `opts`: A keyword list of options.\n - `:order_by` (optional): The field by which to order the results. Default is `[asc: :name]`.\n - `:preload` (optional): A list of associations to preload. Default is `[:project]`.","ref":"Lightning.Collections.html#list_collections/1-parameters"},{"type":"function","title":"Examples - Lightning.Collections.list_collections/1","doc":"iex> list_collections()\n [%Collection{}, ...]\n\n iex> list_collections(order_by: [asc: :inserted_at], preload: [:project, :user])\n [%Collection{}, ...]","ref":"Lightning.Collections.html#list_collections/1-examples"},{"type":"function","title":"Returns - Lightning.Collections.list_collections/1","doc":"- A list of `%Collection{}` structs, preloaded and ordered as specified.","ref":"Lightning.Collections.html#list_collections/1-returns"},{"type":"function","title":"Lightning.Collections.put/3","doc":"","ref":"Lightning.Collections.html#put/3"},{"type":"function","title":"Lightning.Collections.put_all/2","doc":"","ref":"Lightning.Collections.html#put_all/2"},{"type":"function","title":"Lightning.Collections.update_collection/2","doc":"Updates an existing collection with the given attributes.","ref":"Lightning.Collections.html#update_collection/2"},{"type":"function","title":"Parameters - Lightning.Collections.update_collection/2","doc":"- `collection`: The existing `%Collection{}` struct to update.\n - `attrs`: A map of attributes to update the collection.","ref":"Lightning.Collections.html#update_collection/2-parameters"},{"type":"function","title":"Examples - Lightning.Collections.update_collection/2","doc":"iex> update_collection(collection, %{name: \"Updated Name\"})\n {:ok, %Collection{}}\n\n iex> update_collection(collection, %{name: nil})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Collections.html#update_collection/2-examples"},{"type":"function","title":"Returns - Lightning.Collections.update_collection/2","doc":"- `{:ok, %Collection{}}` on success.\n - `{:error, %Ecto.Changeset{}}` on failure due to validation errors.","ref":"Lightning.Collections.html#update_collection/2-returns"},{"type":"module","title":"Lightning.Collections.Collection","doc":"Collection referenced by name associated to a project.","ref":"Lightning.Collections.Collection.html"},{"type":"type","title":"Lightning.Collections.Collection.t/0","doc":"","ref":"Lightning.Collections.Collection.html#t:t/0"},{"type":"module","title":"Lightning.Collections.Item","doc":"A key value entry of a collection bound to a project.","ref":"Lightning.Collections.Item.html"},{"type":"type","title":"Lightning.Collections.Item.t/0","doc":"","ref":"Lightning.Collections.Item.html#t:t/0"},{"type":"module","title":"Lightning.DashboardStats","doc":"Dashboard stats for a project and its workflows.","ref":"Lightning.DashboardStats.html"},{"type":"function","title":"Lightning.DashboardStats.aggregate_project_metrics/1","doc":"","ref":"Lightning.DashboardStats.html#aggregate_project_metrics/1"},{"type":"function","title":"Lightning.DashboardStats.filter_days_ago/2","doc":"","ref":"Lightning.DashboardStats.html#filter_days_ago/2"},{"type":"function","title":"Lightning.DashboardStats.get_workflow_stats/1","doc":"","ref":"Lightning.DashboardStats.html#get_workflow_stats/1"},{"type":"module","title":"Lightning.DashboardStats.ProjectMetrics","doc":"Aggregated metrics for a project.","ref":"Lightning.DashboardStats.ProjectMetrics.html"},{"type":"module","title":"Lightning.DashboardStats.WorkflowStats","doc":"Stats for each workflow.\n\nRuns and WorkOrders counting are grouped by state.","ref":"Lightning.DashboardStats.WorkflowStats.html"},{"type":"module","title":"Lightning.DataclipScrubber","doc":"Handles scrubbing of dataclips","ref":"Lightning.DataclipScrubber.html"},{"type":"function","title":"Lightning.DataclipScrubber.scrub_dataclip_body!/1","doc":"","ref":"Lightning.DataclipScrubber.html#scrub_dataclip_body!/1"},{"type":"module","title":"Lightning.Demo","doc":"Demo encapsulates logic for setting up a demonstration site.","ref":"Lightning.Demo.html"},{"type":"function","title":"Lightning.Demo.reset_demo/0","doc":"Deletes everything in the database including the superuser and creates a set\nof publicly available users for a demo site via a command that can be run on\nKubernetes-deployed systems.","ref":"Lightning.Demo.html#reset_demo/0"},{"type":"module","title":"Lightning.ExportUtils","doc":"Module that expose a function generating a complete and valid yaml string\nfrom a project and its workflows.","ref":"Lightning.ExportUtils.html"},{"type":"function","title":"Lightning.ExportUtils.build_yaml_tree/2","doc":"","ref":"Lightning.ExportUtils.html#build_yaml_tree/2"},{"type":"function","title":"Lightning.ExportUtils.generate_new_yaml/2","doc":"","ref":"Lightning.ExportUtils.html#generate_new_yaml/2"},{"type":"behaviour","title":"Lightning.Extensions.AccountHooking","doc":"Allows handling user creation or registration atomically without relying on async events.","ref":"Lightning.Extensions.AccountHooking.html"},{"type":"callback","title":"Lightning.Extensions.AccountHooking.handle_create_user/1","doc":"","ref":"Lightning.Extensions.AccountHooking.html#c:handle_create_user/1"},{"type":"callback","title":"Lightning.Extensions.AccountHooking.handle_register_superuser/1","doc":"","ref":"Lightning.Extensions.AccountHooking.html#c:handle_register_superuser/1"},{"type":"callback","title":"Lightning.Extensions.AccountHooking.handle_register_user/1","doc":"","ref":"Lightning.Extensions.AccountHooking.html#c:handle_register_user/1"},{"type":"module","title":"Lightning.Extensions.FifoRunQueue","doc":"Allows adding, removing or claiming work to be executed by the Runtime.","ref":"Lightning.Extensions.FifoRunQueue.html"},{"type":"module","title":"Lightning.Extensions.Message","doc":"Message for the limiters to communicate with the client.","ref":"Lightning.Extensions.Message.html"},{"type":"type","title":"Lightning.Extensions.Message.t/0","doc":"","ref":"Lightning.Extensions.Message.html#t:t/0"},{"type":"module","title":"Lightning.Extensions.ProjectHook","doc":"Allows handling user creation or registration atomically without relying on async events.","ref":"Lightning.Extensions.ProjectHook.html"},{"type":"function","title":"Lightning.Extensions.ProjectHook.handle_create_project/1","doc":"","ref":"Lightning.Extensions.ProjectHook.html#handle_create_project/1"},{"type":"function","title":"Lightning.Extensions.ProjectHook.handle_delete_project/1","doc":"","ref":"Lightning.Extensions.ProjectHook.html#handle_delete_project/1"},{"type":"function","title":"Lightning.Extensions.ProjectHook.handle_project_validation/1","doc":"","ref":"Lightning.Extensions.ProjectHook.html#handle_project_validation/1"},{"type":"behaviour","title":"Lightning.Extensions.ProjectHooking","doc":"Allows handling project creation atomically without relying on async events.","ref":"Lightning.Extensions.ProjectHooking.html"},{"type":"callback","title":"Lightning.Extensions.ProjectHooking.handle_create_project/1","doc":"","ref":"Lightning.Extensions.ProjectHooking.html#c:handle_create_project/1"},{"type":"callback","title":"Lightning.Extensions.ProjectHooking.handle_delete_project/1","doc":"","ref":"Lightning.Extensions.ProjectHooking.html#c:handle_delete_project/1"},{"type":"callback","title":"Lightning.Extensions.ProjectHooking.handle_project_validation/1","doc":"","ref":"Lightning.Extensions.ProjectHooking.html#c:handle_project_validation/1"},{"type":"module","title":"Lightning.Extensions.RateLimiter","doc":"Rate limiting stub for Lightning.","ref":"Lightning.Extensions.RateLimiter.html"},{"type":"behaviour","title":"Lightning.Extensions.RateLimiting","doc":"Rate limiting for Lightning API endpoints.","ref":"Lightning.Extensions.RateLimiting.html"},{"type":"callback","title":"Lightning.Extensions.RateLimiting.limit_request/3","doc":"","ref":"Lightning.Extensions.RateLimiting.html#c:limit_request/3"},{"type":"type","title":"Lightning.Extensions.RateLimiting.message/0","doc":"","ref":"Lightning.Extensions.RateLimiting.html#t:message/0"},{"type":"type","title":"Lightning.Extensions.RateLimiting.request_error/0","doc":"","ref":"Lightning.Extensions.RateLimiting.html#t:request_error/0"},{"type":"module","title":"Lightning.Extensions.RateLimiting.Context","doc":"Which user is making the request for a certain project.","ref":"Lightning.Extensions.RateLimiting.Context.html"},{"type":"type","title":"Lightning.Extensions.RateLimiting.Context.t/0","doc":"","ref":"Lightning.Extensions.RateLimiting.Context.html#t:t/0"},{"type":"behaviour","title":"Lightning.Extensions.RunQueue","doc":"Extension to customize the scheduling of workloads on Lightning Runtime.","ref":"Lightning.Extensions.RunQueue.html"},{"type":"callback","title":"Lightning.Extensions.RunQueue.claim/1","doc":"","ref":"Lightning.Extensions.RunQueue.html#c:claim/1"},{"type":"callback","title":"Lightning.Extensions.RunQueue.dequeue/1","doc":"","ref":"Lightning.Extensions.RunQueue.html#c:dequeue/1"},{"type":"callback","title":"Lightning.Extensions.RunQueue.enqueue/1","doc":"","ref":"Lightning.Extensions.RunQueue.html#c:enqueue/1"},{"type":"callback","title":"Lightning.Extensions.RunQueue.enqueue_many/1","doc":"","ref":"Lightning.Extensions.RunQueue.html#c:enqueue_many/1"},{"type":"module","title":"Lightning.Extensions.UsageLimiter","doc":"Runtime limiting stub for Lightning.","ref":"Lightning.Extensions.UsageLimiter.html"},{"type":"behaviour","title":"Lightning.Extensions.UsageLimiting","doc":"Rate limiting for Lightning workloads that depends on Runtime.","ref":"Lightning.Extensions.UsageLimiting.html"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.check_limits/1","doc":"Checks the usage limits for a given project and user context, returning an error\nmessage if the limits are exceeded.\n\nRequires a `Context` struct containing the `project_id` and `user_id`.","ref":"Lightning.Extensions.UsageLimiting.html#c:check_limits/1"},{"type":"callback","title":"Returns - Lightning.Extensions.UsageLimiting.check_limits/1","doc":"- `{:ok}` if the limits are within bounds.\n - `{:error, reason, message}` if the limits are exceeded.","ref":"Lightning.Extensions.UsageLimiting.html#c:check_limits/1-returns"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.get_data_retention_message/1","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#c:get_data_retention_message/1"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.get_data_retention_periods/1","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#c:get_data_retention_periods/1"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.get_run_options/1","doc":"Returns run options based on the given project context. The run options include\na timeout value and a flag for saving dataclips.\n\nRequires a `Context` struct containing the `project_id`.","ref":"Lightning.Extensions.UsageLimiting.html#c:get_run_options/1"},{"type":"callback","title":"Returns - Lightning.Extensions.UsageLimiting.get_run_options/1","doc":"- A keyword list of run options including:\n - `:run_timeout_ms`: The run timeout in milliseconds.\n - `:save_dataclips`: A boolean indicating whether to save dataclips.","ref":"Lightning.Extensions.UsageLimiting.html#c:get_run_options/1-returns"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.increment_ai_queries/1","doc":"Increments the AI query count for a given chat session.\n\nRequires a `Lightning.AiAssistant.ChatSession` struct.","ref":"Lightning.Extensions.UsageLimiting.html#c:increment_ai_queries/1"},{"type":"callback","title":"Returns - Lightning.Extensions.UsageLimiting.increment_ai_queries/1","doc":"- An Ecto.Multi struct representing the transaction to increment AI queries.","ref":"Lightning.Extensions.UsageLimiting.html#c:increment_ai_queries/1-returns"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.limit_action/2","doc":"Limits specific actions based on an `Action` and `Context`.","ref":"Lightning.Extensions.UsageLimiting.html#c:limit_action/2"},{"type":"callback","title":"Returns - Lightning.Extensions.UsageLimiting.limit_action/2","doc":"- `:ok` if the action is allowed.\n - `{:error, reason, message}` if the action is not allowed.","ref":"Lightning.Extensions.UsageLimiting.html#c:limit_action/2-returns"},{"type":"type","title":"Lightning.Extensions.UsageLimiting.error/0","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#t:error/0"},{"type":"type","title":"Lightning.Extensions.UsageLimiting.error_reason/0","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#t:error_reason/0"},{"type":"type","title":"Lightning.Extensions.UsageLimiting.message/0","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#t:message/0"},{"type":"module","title":"Lightning.FailureNotifierView","doc":"","ref":"Lightning.FailureNotifierView.html"},{"type":"function","title":"Lightning.FailureNotifierView.__resource__/0","doc":"The resource name, as an atom, for this view","ref":"Lightning.FailureNotifierView.html#__resource__/0"},{"type":"function","title":"Lightning.FailureNotifierView.failure_alert.html/1","doc":"","ref":"Lightning.FailureNotifierView.html#failure_alert.html/1"},{"type":"function","title":"Lightning.FailureNotifierView.render/2","doc":"Renders the given template locally.","ref":"Lightning.FailureNotifierView.html#render/2"},{"type":"function","title":"Lightning.FailureNotifierView.template_not_found/2","doc":"Callback invoked when no template is found.\nBy default it raises but can be customized\nto render a particular template.","ref":"Lightning.FailureNotifierView.html#template_not_found/2"},{"type":"module","title":"Lightning.Graph","doc":"A graph model for workflows transversal.","ref":"Lightning.Graph.html"},{"type":"function","title":"Lightning.Graph.add_edge/3","doc":"","ref":"Lightning.Graph.html#add_edge/3"},{"type":"function","title":"Lightning.Graph.new/0","doc":"","ref":"Lightning.Graph.html#new/0"},{"type":"function","title":"Lightning.Graph.nodes/2","doc":"","ref":"Lightning.Graph.html#nodes/2"},{"type":"function","title":"Lightning.Graph.prune/2","doc":"","ref":"Lightning.Graph.html#prune/2"},{"type":"function","title":"Lightning.Graph.remove_edges/2","doc":"","ref":"Lightning.Graph.html#remove_edges/2"},{"type":"type","title":"Lightning.Graph.t/0","doc":"","ref":"Lightning.Graph.html#t:t/0"},{"type":"module","title":"Lightning.Helpers","doc":"Common functions for the context","ref":"Lightning.Helpers.html"},{"type":"function","title":"Lightning.Helpers.actual_deletion_date/3","doc":"","ref":"Lightning.Helpers.html#actual_deletion_date/3"},{"type":"function","title":"Lightning.Helpers.coerce_json_field/2","doc":"Changes a given maps field from a json string to a map.\nIf it cannot be converted, it leaves the original value","ref":"Lightning.Helpers.html#coerce_json_field/2"},{"type":"function","title":"Lightning.Helpers.copy_error/4","doc":"Copies an error from one key to another in the given changeset.","ref":"Lightning.Helpers.html#copy_error/4"},{"type":"function","title":"Parameters - Lightning.Helpers.copy_error/4","doc":"- `changeset`: The changeset to modify.\n - `original_key`: The key where the error currently exists.\n - `new_key`: The key where the error should be duplicated.\n - `opts`: A keyword list of options. Supports `overwrite`, which is a boolean indicating whether to overwrite the `new_key` error if it already exists. Defaults to `true`.","ref":"Lightning.Helpers.html#copy_error/4-parameters"},{"type":"function","title":"Example - Lightning.Helpers.copy_error/4","doc":"iex> changeset = %Ecto.Changeset{errors: [name: {\"has already been taken\", []}]}\n iex> updated_changeset = Lightning.Helpers.copy_error(changeset, :name, :raw_name)\n iex> updated_changeset.errors\n [name: {\"has already been taken\", []}, raw_name: {\"has already been taken\", []}]\n\nIf the `original_key` doesn't exist in the errors, or if the `new_key` already exists and `overwrite` is set to `false`, the changeset is returned unchanged.","ref":"Lightning.Helpers.html#copy_error/4-example"},{"type":"function","title":"Lightning.Helpers.format_date/2","doc":"","ref":"Lightning.Helpers.html#format_date/2"},{"type":"function","title":"Lightning.Helpers.json_safe/1","doc":"Recursively ensures a given map is safe to convert to JSON,\nwhere all keys are strings and all values are json safe (primitive values).","ref":"Lightning.Helpers.html#json_safe/1"},{"type":"function","title":"Lightning.Helpers.ms_to_human/1","doc":"Converts milliseconds (integer) to a human duration, such as \"1 minute\" or\n\"45 years, 6 months, 5 days, 21 hours, 12 minutes, 34 seconds\" using\n`Timex.Format.Duration.Formatters.Humanized.format()`.","ref":"Lightning.Helpers.html#ms_to_human/1"},{"type":"function","title":"Lightning.Helpers.url_safe_name/1","doc":"Converts a string into a URL-safe format by converting it to lowercase,\nreplacing unwanted characters with hyphens, and trimming leading/trailing hyphens.\n\nThis function allows international characters, which will be automatically\npercent-encoded in URLs by browsers.","ref":"Lightning.Helpers.html#url_safe_name/1"},{"type":"function","title":"Parameters - Lightning.Helpers.url_safe_name/1","doc":"- `name`: The string to convert. If `nil` is passed, it returns an empty string.","ref":"Lightning.Helpers.html#url_safe_name/1-parameters"},{"type":"function","title":"Examples - Lightning.Helpers.url_safe_name/1","doc":"iex> url_safe_name(\"My Project!!\")\n \"my-project\"\n\n iex> url_safe_name(nil)\n \"\"","ref":"Lightning.Helpers.html#url_safe_name/1-examples"},{"type":"module","title":"Lightning.Janitor","doc":"The Janitor is responsible for detecting runs that have been \"lost\" due to\ncommunication issues with the worker.\n\nEvery X minutes the Janitor will check to ensure that no runs have been\nrunning for more than Y seconds.\n\nConfigure your maximum run runtime with a WORKER_MAX_RUN_DURATION_SECONDS environment\nvariable; the grace period will be an additional 20%.","ref":"Lightning.Janitor.html"},{"type":"function","title":"Lightning.Janitor.find_and_update_lost/0","doc":"The find_and_update_lost function determines the current time, finds all\nruns that were claimed before the earliest allowable claim time for\nunfinished runs, and marks them as lost.","ref":"Lightning.Janitor.html#find_and_update_lost/0"},{"type":"function","title":"Lightning.Janitor.perform/1","doc":"The perform function takes an `%Oban.Job`, allowing this module to be invoked\nby the Oban cron plugin.","ref":"Lightning.Janitor.html#perform/1"},{"type":"module","title":"Lightning.KafkaTriggers","doc":"Contains the logic to manage kafka trigger and their associated pipelines.","ref":"Lightning.KafkaTriggers.html"},{"type":"function","title":"Lightning.KafkaTriggers.alternate_storage_file_name/2","doc":"","ref":"Lightning.KafkaTriggers.html#alternate_storage_file_name/2"},{"type":"function","title":"Lightning.KafkaTriggers.build_topic_partition_offset/1","doc":"Generate the key that is used to identify duplicate messages when used in\nassociation with the trigger id.","ref":"Lightning.KafkaTriggers.html#build_topic_partition_offset/1"},{"type":"function","title":"Lightning.KafkaTriggers.convert_rate_limit/0","doc":"","ref":"Lightning.KafkaTriggers.html#convert_rate_limit/0"},{"type":"function","title":"Lightning.KafkaTriggers.enable_disable_triggers/1","doc":"","ref":"Lightning.KafkaTriggers.html#enable_disable_triggers/1"},{"type":"function","title":"Lightning.KafkaTriggers.failure_notification_tracking_key/1","doc":"","ref":"Lightning.KafkaTriggers.html#failure_notification_tracking_key/1"},{"type":"function","title":"Lightning.KafkaTriggers.find_enabled_triggers/0","doc":"","ref":"Lightning.KafkaTriggers.html#find_enabled_triggers/0"},{"type":"function","title":"Lightning.KafkaTriggers.generate_pipeline_child_spec/1","doc":"Generate the child spec needed to start a `Pipeline` child process.","ref":"Lightning.KafkaTriggers.html#generate_pipeline_child_spec/1"},{"type":"function","title":"Lightning.KafkaTriggers.get_kafka_triggers_being_updated/1","doc":"","ref":"Lightning.KafkaTriggers.html#get_kafka_triggers_being_updated/1"},{"type":"function","title":"Lightning.KafkaTriggers.initial_policy/1","doc":"","ref":"Lightning.KafkaTriggers.html#initial_policy/1"},{"type":"function","title":"Lightning.KafkaTriggers.maybe_write_to_alternate_storage/2","doc":"","ref":"Lightning.KafkaTriggers.html#maybe_write_to_alternate_storage/2"},{"type":"function","title":"Lightning.KafkaTriggers.notify_users_of_trigger_failure/1","doc":"","ref":"Lightning.KafkaTriggers.html#notify_users_of_trigger_failure/1"},{"type":"function","title":"Lightning.KafkaTriggers.send_notification?/2","doc":"","ref":"Lightning.KafkaTriggers.html#send_notification?/2"},{"type":"function","title":"Lightning.KafkaTriggers.start_triggers/0","doc":"","ref":"Lightning.KafkaTriggers.html#start_triggers/0"},{"type":"function","title":"Lightning.KafkaTriggers.update_pipeline/2","doc":"","ref":"Lightning.KafkaTriggers.html#update_pipeline/2"},{"type":"module","title":"Lightning.KafkaTriggers.DuplicateTrackingCleanupWorker","doc":"Responsible for cleaning up stale TriggerKafkaMessageRecords entries.\nTriggerKafkaMessageRecords are used to deduplicate incoming messages from\na Kafka cluster.","ref":"Lightning.KafkaTriggers.DuplicateTrackingCleanupWorker.html"},{"type":"module","title":"Lightning.KafkaTriggers.EventListener","doc":"Listens for events related to Kafka triggers and updates the affected pipeline\nprocess by enabling, reloading or disabling it.","ref":"Lightning.KafkaTriggers.EventListener.html"},{"type":"function","title":"Lightning.KafkaTriggers.EventListener.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.KafkaTriggers.EventListener.html#child_spec/1"},{"type":"function","title":"Lightning.KafkaTriggers.EventListener.start_link/1","doc":"","ref":"Lightning.KafkaTriggers.EventListener.html#start_link/1"},{"type":"module","title":"Lightning.KafkaTriggers.MessageHandling","doc":"Contains the logic to persist a Kafka messages as a WorkOrder, Run and\nDataclip.","ref":"Lightning.KafkaTriggers.MessageHandling.html"},{"type":"function","title":"Lightning.KafkaTriggers.MessageHandling.convert_headers_for_serialisation/1","doc":"","ref":"Lightning.KafkaTriggers.MessageHandling.html#convert_headers_for_serialisation/1"},{"type":"function","title":"Lightning.KafkaTriggers.MessageHandling.persist_message/3","doc":"","ref":"Lightning.KafkaTriggers.MessageHandling.html#persist_message/3"},{"type":"module","title":"Lightning.KafkaTriggers.MessageRecovery","doc":"This module contains functionality to recover Kafka messages that have been\npersisted to the file system. It should only be used to process files that\noriginate from a trusted source (i.e. Lightning's Kafka pipeline.)\n\nIt expects to be pointed at a directory structure that looks as follows:\n\nbase_path\n|_ \n |_ _ _ _ .json\n |_ _ _ _ .json\n|_ \n\nThis is the structure that the Kafka pipeline will use when writing the\nmessages to the file system. After each message is successfully processed,\nthe file extension will be changed from `.json` to `json.recovered`. Recovered\nfiles will not be processed again. They are retained for the purposes of \ndouble-checking the recovery process and can be deleted once this has been\ndone.\n\nIf a file has not had the extension changed, this means that it experienced\nan error during reprocessing. These files can be reprocessed if you think the\nerror was transient. \n\nUsage: \n\n alias Lightning.KafkaTriggers.MessageRecovery\n case MessageRecovery.recover_messages(Lightning.Config.kafka_alternate_storage_file_path) do\n :ok -> # Success code\n {:error, error_count} -> # Failure code\n end","ref":"Lightning.KafkaTriggers.MessageRecovery.html"},{"type":"function","title":"Lightning.KafkaTriggers.MessageRecovery.build_broadway_message/2","doc":"","ref":"Lightning.KafkaTriggers.MessageRecovery.html#build_broadway_message/2"},{"type":"function","title":"Lightning.KafkaTriggers.MessageRecovery.extract_trigger_id/1","doc":"","ref":"Lightning.KafkaTriggers.MessageRecovery.html#extract_trigger_id/1"},{"type":"function","title":"Lightning.KafkaTriggers.MessageRecovery.recover_messages/1","doc":"","ref":"Lightning.KafkaTriggers.MessageRecovery.html#recover_messages/1"},{"type":"module","title":"Lightning.KafkaTriggers.Pipeline","doc":"Broadway pipeline that processes messages from Kafka clusters and persists\nthe received messages if they are not duplicating a previous message.","ref":"Lightning.KafkaTriggers.Pipeline.html"},{"type":"function","title":"Lightning.KafkaTriggers.Pipeline.maybe_notify_users/2","doc":"","ref":"Lightning.KafkaTriggers.Pipeline.html#maybe_notify_users/2"},{"type":"function","title":"Lightning.KafkaTriggers.Pipeline.start_link/1","doc":"","ref":"Lightning.KafkaTriggers.Pipeline.html#start_link/1"},{"type":"module","title":"Lightning.KafkaTriggers.PipelineSupervisor","doc":"Supervisor of the BroadwayKafka pipelines that are created for each enabled\nKafka trigger.","ref":"Lightning.KafkaTriggers.PipelineSupervisor.html"},{"type":"function","title":"Lightning.KafkaTriggers.PipelineSupervisor.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.KafkaTriggers.PipelineSupervisor.html#child_spec/1"},{"type":"function","title":"Lightning.KafkaTriggers.PipelineSupervisor.start_link/1","doc":"","ref":"Lightning.KafkaTriggers.PipelineSupervisor.html#start_link/1"},{"type":"module","title":"Lightning.KafkaTriggers.Supervisor","doc":"Starts all the processes needed to pull data from Kafka clusters and then\ngenerate work orders based on the messages received.","ref":"Lightning.KafkaTriggers.Supervisor.html"},{"type":"function","title":"Lightning.KafkaTriggers.Supervisor.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.KafkaTriggers.Supervisor.html#child_spec/1"},{"type":"function","title":"Lightning.KafkaTriggers.Supervisor.start_link/1","doc":"","ref":"Lightning.KafkaTriggers.Supervisor.html#start_link/1"},{"type":"module","title":"Lightning.KafkaTriggers.TriggerKafkaMessageRecord","doc":"Persists a lightweight represenattion of a message that has been recevied from\na Kafka cluster, for the purpose of deduplication.","ref":"Lightning.KafkaTriggers.TriggerKafkaMessageRecord.html"},{"type":"function","title":"Lightning.KafkaTriggers.TriggerKafkaMessageRecord.changeset/2","doc":"","ref":"Lightning.KafkaTriggers.TriggerKafkaMessageRecord.html#changeset/2"},{"type":"module","title":"Lightning.MetadataService","doc":"Retrieves metadata for a given credential and adaptor using the OpenFn CLI.","ref":"Lightning.MetadataService.html"},{"type":"function","title":"Lightning.MetadataService.fetch/2","doc":"Retrieve metadata for a given adaptor and credential.\n\nThe adaptor must be an npm specification.","ref":"Lightning.MetadataService.html#fetch/2"},{"type":"exception","title":"Lightning.MetadataService.Error","doc":"","ref":"Lightning.MetadataService.Error.html"},{"type":"function","title":"Lightning.MetadataService.Error.message/1","doc":"","ref":"Lightning.MetadataService.Error.html#message/1"},{"type":"function","title":"Lightning.MetadataService.Error.new/1","doc":"","ref":"Lightning.MetadataService.Error.html#new/1"},{"type":"type","title":"Lightning.MetadataService.Error.t/0","doc":"","ref":"Lightning.MetadataService.Error.html#t:t/0"},{"type":"module","title":"Lightning.Name","doc":"Generates a random names.","ref":"Lightning.Name.html"},{"type":"function","title":"Lightning.Name.generate/1","doc":"","ref":"Lightning.Name.html#generate/1"},{"type":"module","title":"Lightning.OauthClients","doc":"Manages operations for OAuth clients within the Lightning application, providing\nfunctions to create, retrieve, update, and delete OAuth clients, as well as managing\ntheir associations with projects and handling audit trails for changes.","ref":"Lightning.OauthClients.html"},{"type":"function","title":"Lightning.OauthClients.change_client/2","doc":"Prepares a changeset for creating or updating an OAuth client.","ref":"Lightning.OauthClients.html#change_client/2"},{"type":"function","title":"Parameters - Lightning.OauthClients.change_client/2","doc":"- client: The OAuth client struct.\n - attrs: Attributes to update in the client.","ref":"Lightning.OauthClients.html#change_client/2-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.change_client/2","doc":"- An Ecto.Changeset struct for the OAuth client.","ref":"Lightning.OauthClients.html#change_client/2-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.change_client/2","doc":"iex> change_client(%OauthClient{}, %{name: \"New Client\"})\n %Ecto.Changeset{...}","ref":"Lightning.OauthClients.html#change_client/2-examples"},{"type":"function","title":"Lightning.OauthClients.create_client/1","doc":"Creates a new OAuth client with the specified attributes.","ref":"Lightning.OauthClients.html#create_client/1"},{"type":"function","title":"Parameters - Lightning.OauthClients.create_client/1","doc":"- attrs: Map containing attributes for the new OAuth client.\n Required fields: `name`, `authorization_endpoint`, `token_endpoint`, `revocation_endpoint`, `client_id`, `client_secret`.","ref":"Lightning.OauthClients.html#create_client/1-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.create_client/1","doc":"- `{:ok, oauth_client}` if the client is created successfully.\n - `{:error, changeset}` if there is an error during creation due to validation failures or database issues.","ref":"Lightning.OauthClients.html#create_client/1-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.create_client/1","doc":"iex> create_client(%{name: \"New Client\"})\n {:ok, %OauthClient{}}\n\n iex> create_client(%{name: nil})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.OauthClients.html#create_client/1-examples"},{"type":"function","title":"Lightning.OauthClients.delete_client/1","doc":"Deletes an OAuth client and all associated data.","ref":"Lightning.OauthClients.html#delete_client/1"},{"type":"function","title":"Parameters - Lightning.OauthClients.delete_client/1","doc":"- client: The OauthClient to delete.","ref":"Lightning.OauthClients.html#delete_client/1-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.delete_client/1","doc":"- A tuple {:ok, oauth_client} if deletion is successful.\n- A tuple {:error, changeset} if deletion fails.","ref":"Lightning.OauthClients.html#delete_client/1-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.delete_client/1","doc":"iex> delete_client(client)\n {:ok, %OauthClient{}}\n\n iex> delete_client(client)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.OauthClients.html#delete_client/1-examples"},{"type":"function","title":"Lightning.OauthClients.get_client!/1","doc":"Retrieves a single OAuth client by its ID, raising an error if not found.","ref":"Lightning.OauthClients.html#get_client!/1"},{"type":"function","title":"Parameters - Lightning.OauthClients.get_client!/1","doc":"- id: The ID of the OAuth client to retrieve.","ref":"Lightning.OauthClients.html#get_client!/1-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.get_client!/1","doc":"- The OAuth client struct.","ref":"Lightning.OauthClients.html#get_client!/1-returns"},{"type":"function","title":"Raises - Lightning.OauthClients.get_client!/1","doc":"- Ecto.NoResultsError if the OAuth client does not exist.","ref":"Lightning.OauthClients.html#get_client!/1-raises"},{"type":"function","title":"Examples - Lightning.OauthClients.get_client!/1","doc":"iex> get_client!(123)\n %OauthClient{}\n\n iex> get_client!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.OauthClients.html#get_client!/1-examples"},{"type":"function","title":"Lightning.OauthClients.list_clients/1","doc":"Retrieves all OAuth clients based on the given context, either a Project or a User.","ref":"Lightning.OauthClients.html#list_clients/1"},{"type":"function","title":"Parameters - Lightning.OauthClients.list_clients/1","doc":"- context: The Project or User struct to retrieve OAuth clients for.","ref":"Lightning.OauthClients.html#list_clients/1-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.list_clients/1","doc":"- A list of OAuth clients associated with the given Project or created by the given User.","ref":"Lightning.OauthClients.html#list_clients/1-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.list_clients/1","doc":"When given a Project:\n iex> list_clients(%Project{id: 1})\n [%OauthClient{project_id: 1}, %OauthClient{project_id: 1}]\n\n When given a User:\n iex> list_clients(%User{id: 123})\n [%OauthClient{user_id: 123}, %OauthClient{user_id: 123}]","ref":"Lightning.OauthClients.html#list_clients/1-examples"},{"type":"function","title":"Lightning.OauthClients.update_client/2","doc":"Updates an existing OAuth client with the specified attributes.","ref":"Lightning.OauthClients.html#update_client/2"},{"type":"function","title":"Parameters - Lightning.OauthClients.update_client/2","doc":"- client: The existing OauthClient to update.\n- attrs: A map of attributes to update.","ref":"Lightning.OauthClients.html#update_client/2-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.update_client/2","doc":"- A tuple {:ok, oauth_client} if update is successful.\n- A tuple {:error, changeset} if update fails.","ref":"Lightning.OauthClients.html#update_client/2-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.update_client/2","doc":"iex> update_client(client, %{field: new_value})\n {:ok, %OauthClient{}}\n\n iex> update_client(client, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.OauthClients.html#update_client/2-examples"},{"type":"module","title":"Lightning.ObanManager","doc":"The Oban Manager","ref":"Lightning.ObanManager.html"},{"type":"function","title":"Lightning.ObanManager.handle_event/4","doc":"","ref":"Lightning.ObanManager.html#handle_event/4"},{"type":"module","title":"Lightning.Policies.Collections","doc":"The Bodyguard Policy module for Collections.\n\nAccess to collections is controlled by the project the collection belongs to.\n\nThe `access_collection` action is allowed if the user has access to the\nproject, or if a run belongs to the project (via it's workflow).","ref":"Lightning.Policies.Collections.html"},{"type":"function","title":"Lightning.Policies.Collections.authorize/3","doc":"","ref":"Lightning.Policies.Collections.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Collections.actions/0","doc":"","ref":"Lightning.Policies.Collections.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Dataclips","doc":"The Bodyguard Policy module for dataclips actions","ref":"Lightning.Policies.Dataclips.html"},{"type":"function","title":"Lightning.Policies.Dataclips.authorize/3","doc":"","ref":"Lightning.Policies.Dataclips.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Dataclips.actions/0","doc":"","ref":"Lightning.Policies.Dataclips.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Exports","doc":"The Bodyguard Policy module for Exports","ref":"Lightning.Policies.Exports.html"},{"type":"function","title":"Lightning.Policies.Exports.authorize/3","doc":"","ref":"Lightning.Policies.Exports.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Exports.actions/0","doc":"","ref":"Lightning.Policies.Exports.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Permissions","doc":"This module defines a unique interface managing authorizations in Lightning.\n\nUsers in Lightning have instance-wide and project-wide roles which determine their level of access to resources in the application. Fo rmore details see the [documentation](https://docs.openfn.org/documentation/about-lightning#roles-and-permissions).\n\nThese authorizations policies are all implemented under the `lib/lightning/policies` folder. In that folder you can find 3 files:\n- The `users.ex` file has all the policies for the instances wide access levels\n- The `project_users.ex` file has all the policies for the project wide access levels\n- The `permissions.ex` file defines the `Lightning.Policies.Permissions.can/4` interface. Which is a wrapper around the `Bodyguard.permit/4` function.\nWe use that interface to be able to harmonize the use of policies accross the entire app.\n\nAll the policies are tested in the `test/lightning/policies` folder. And the test are written in a way that allows the reader to quickly who can do what in the app.\n\nWe have two variants of the `Lightning.Policies.Permissions.can/4` interface:\n- `Lightning.Policies.Permissions.can(policy, action, actor, resource)` returns `:ok` if the actor can perform the action on the resource and `{:error, :unauthorized}` otherwise.\n- `Lightning.Policies.Permissions.can?(policy, action, actor, resource)` returns `true` if the actor can perform the action on the resource and `false` otherwise.\n\nHere is an example of how we the `Lightning.Policies.Permissions.can/4` interface to check if the a user can edit a job or not\n```elixir\ncan_edit_workflow = Lightning.Policies.ProjectUsers |> Lightning.Policies.Permissions.can?(:edit_workflow, socket.assigns.current_user, socket.assigns.project)\n\nif can_edit_workflow do\n # allow user to edit the workflow\nelse\n # quick user out\nend\n```","ref":"Lightning.Policies.Permissions.html"},{"type":"function","title":"Lightning.Policies.Permissions.can/4","doc":"checks if user has the permissions to apply action using some policy module\n\nReturns `:ok` if user can apply action and `{:error, :unauthorized}` otherwise","ref":"Lightning.Policies.Permissions.html#can/4"},{"type":"function","title":"Examples - Lightning.Policies.Permissions.can/4","doc":"iex> can(Lightning.Policies.Users, :create_workflow, user, project)\n :ok\n\n iex> can(Lightning.Policies.Users, :create_project, user, %{})\n {:error, :unauthorized}","ref":"Lightning.Policies.Permissions.html#can/4-examples"},{"type":"function","title":"Lightning.Policies.Permissions.can?/4","doc":"same as can/4 but returns `true` if user can apply action and `false` otherwise","ref":"Lightning.Policies.Permissions.html#can?/4"},{"type":"function","title":"Examples - Lightning.Policies.Permissions.can?/4","doc":"iex> can(Lightning.Policies.Users, :create_workflow, user, project)\n true\n\n iex> can(Lightning.Policies.Users, :create_project, user, %{})\n false","ref":"Lightning.Policies.Permissions.html#can?/4-examples"},{"type":"module","title":"Lightning.Policies.ProjectUsers","doc":"The Bodyguard Policy module for projects members roles.","ref":"Lightning.Policies.ProjectUsers.html"},{"type":"function","title":"Lightning.Policies.ProjectUsers.authorize/3","doc":"authorize/3 takes an action, a user, and a project. It checks the user's role\nfor this project and returns `true` if the user can perform the action in\nthat project and `false` if they cannot.\n\nNote that permissions are grouped by action, rather than by user role.\n\nWe deny by default, so if a user's role is not added to the allow roles list\nfor a particular action they are denied.","ref":"Lightning.Policies.ProjectUsers.html#authorize/3"},{"type":"type","title":"Lightning.Policies.ProjectUsers.actions/0","doc":"","ref":"Lightning.Policies.ProjectUsers.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Provisioning","doc":"The Bodyguard Policy module for users roles.","ref":"Lightning.Policies.Provisioning.html"},{"type":"function","title":"Lightning.Policies.Provisioning.authorize/3","doc":"authorize/3 takes an action, a user or a project repo connection, and a project. It checks the user's role\nfor this project and returns `true` if the user can perform the action and\nfalse if they cannot.\n\nNote that permissions are grouped by action.\n\nWe deny by default, so if a user's role is not added to the allow roles list\nfor a particular action they are denied.\n\nOnly a superuser can provision a new project.\n\nOwners and admins can update existing projects.","ref":"Lightning.Policies.Provisioning.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Provisioning.actions/0","doc":"","ref":"Lightning.Policies.Provisioning.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Users","doc":"The Bodyguard Policy module for users roles.","ref":"Lightning.Policies.Users.html"},{"type":"function","title":"Lightning.Policies.Users.authorize/3","doc":"authorize/3 takes an action, a user, and a project. It checks the user's role\nfor this project and returns `true` if the user can perform the action and\nfalse if they cannot.\n\nNote that permissions are grouped by action.\n\nWe deny by default, so if a user's role is not added to the allow roles list\nfor a particular action they are denied.","ref":"Lightning.Policies.Users.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Users.actions/0","doc":"","ref":"Lightning.Policies.Users.html#t:actions/0"},{"type":"module","title":"Lightning.PromEx","doc":"Be sure to add the following to finish setting up PromEx:\n\n1. Update your configuration (config.exs, dev.exs, prod.exs, releases.exs, etc) to\n configure the necessary bit of PromEx. Be sure to check out `PromEx.Config` for\n more details regarding configuring PromEx:\n ```\n config :lightning, Lightning.PromEx,\n disabled: false,\n manual_metrics_start_delay: :no_delay,\n drop_metrics_groups: [],\n grafana: :disabled,\n metrics_server: :disabled\n ```\n\n2. Add this module to your application supervision tree. It should be one of the first\n things that is started so that no Telemetry events are missed. For example, if PromEx\n is started after your Repo module, you will miss Ecto's init events and the dashboards\n will be missing some data points:\n ```\n def start(_type, _args) do\n children = [\n Lightning.PromEx,\n\n ...\n ]\n\n ...\n end\n ```\n\n3. Update your `endpoint.ex` file to expose your metrics (or configure a standalone\n server using the `:metrics_server` config options). Be sure to put this plug before\n your `Plug.Telemetry` entry so that you can avoid having calls to your `/metrics`\n endpoint create their own metrics and logs which can pollute your logs/metrics given\n that Prometheus will scrape at a regular interval and that can get noisy:\n ```\n defmodule LightningWeb.Endpoint do\n use Phoenix.Endpoint, otp_app: :lightning\n\n ...\n\n plug PromEx.Plug, prom_ex_module: Lightning.PromEx\n\n ...\n end\n ```\n\n4. Update the list of plugins in the `plugins/0` function return list to reflect your\n application's dependencies. Also update the list of dashboards that are to be uploaded\n to Grafana in the `dashboards/0` function.","ref":"Lightning.PromEx.html"},{"type":"function","title":"Lightning.PromEx.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.PromEx.html#child_spec/1"},{"type":"module","title":"Lightning.Release","doc":"Used for executing DB release tasks when run in production without Mix\ninstalled.","ref":"Lightning.Release.html"},{"type":"function","title":"Lightning.Release.create_db/0","doc":"","ref":"Lightning.Release.html#create_db/0"},{"type":"function","title":"Lightning.Release.load_app/0","doc":"","ref":"Lightning.Release.html#load_app/0"},{"type":"function","title":"Lightning.Release.migrate/0","doc":"","ref":"Lightning.Release.html#migrate/0"},{"type":"function","title":"Lightning.Release.rollback/2","doc":"","ref":"Lightning.Release.html#rollback/2"},{"type":"module","title":"Lightning.Repo","doc":"","ref":"Lightning.Repo.html"},{"type":"function","title":"Lightning.Repo.aggregate/3","doc":"","ref":"Lightning.Repo.html#aggregate/3"},{"type":"function","title":"Lightning.Repo.aggregate/4","doc":"","ref":"Lightning.Repo.html#aggregate/4"},{"type":"function","title":"Lightning.Repo.all/2","doc":"","ref":"Lightning.Repo.html#all/2"},{"type":"function","title":"Lightning.Repo.checked_out?/0","doc":"","ref":"Lightning.Repo.html#checked_out?/0"},{"type":"function","title":"Lightning.Repo.checkout/2","doc":"","ref":"Lightning.Repo.html#checkout/2"},{"type":"function","title":"Lightning.Repo.child_spec/1","doc":"","ref":"Lightning.Repo.html#child_spec/1"},{"type":"function","title":"Lightning.Repo.config/0","doc":"","ref":"Lightning.Repo.html#config/0"},{"type":"function","title":"Lightning.Repo.default_options/1","doc":"","ref":"Lightning.Repo.html#default_options/1"},{"type":"function","title":"Lightning.Repo.delete/2","doc":"","ref":"Lightning.Repo.html#delete/2"},{"type":"function","title":"Lightning.Repo.delete!/2","doc":"","ref":"Lightning.Repo.html#delete!/2"},{"type":"function","title":"Lightning.Repo.delete_all/2","doc":"","ref":"Lightning.Repo.html#delete_all/2"},{"type":"function","title":"Lightning.Repo.disconnect_all/2","doc":"A convenience function for SQL-based repositories that forces all connections in the\npool to disconnect within the given interval.\n\nSee `Ecto.Adapters.SQL.disconnect_all/3` for more information.","ref":"Lightning.Repo.html#disconnect_all/2"},{"type":"function","title":"Lightning.Repo.exists?/2","doc":"","ref":"Lightning.Repo.html#exists?/2"},{"type":"function","title":"Lightning.Repo.explain/3","doc":"A convenience function for SQL-based repositories that executes an EXPLAIN statement or similar\ndepending on the adapter to obtain statistics for the given query.\n\nSee `Ecto.Adapters.SQL.explain/4` for more information.","ref":"Lightning.Repo.html#explain/3"},{"type":"function","title":"Lightning.Repo.get/3","doc":"","ref":"Lightning.Repo.html#get/3"},{"type":"function","title":"Lightning.Repo.get!/3","doc":"","ref":"Lightning.Repo.html#get!/3"},{"type":"function","title":"Lightning.Repo.get_by/3","doc":"","ref":"Lightning.Repo.html#get_by/3"},{"type":"function","title":"Lightning.Repo.get_by!/3","doc":"","ref":"Lightning.Repo.html#get_by!/3"},{"type":"function","title":"Lightning.Repo.get_dynamic_repo/0","doc":"","ref":"Lightning.Repo.html#get_dynamic_repo/0"},{"type":"function","title":"Lightning.Repo.in_transaction?/0","doc":"","ref":"Lightning.Repo.html#in_transaction?/0"},{"type":"function","title":"Lightning.Repo.insert/2","doc":"","ref":"Lightning.Repo.html#insert/2"},{"type":"function","title":"Lightning.Repo.insert!/2","doc":"","ref":"Lightning.Repo.html#insert!/2"},{"type":"function","title":"Lightning.Repo.insert_all/3","doc":"","ref":"Lightning.Repo.html#insert_all/3"},{"type":"function","title":"Lightning.Repo.insert_or_update/2","doc":"","ref":"Lightning.Repo.html#insert_or_update/2"},{"type":"function","title":"Lightning.Repo.insert_or_update!/2","doc":"","ref":"Lightning.Repo.html#insert_or_update!/2"},{"type":"function","title":"Lightning.Repo.load/2","doc":"","ref":"Lightning.Repo.html#load/2"},{"type":"function","title":"Lightning.Repo.one/2","doc":"","ref":"Lightning.Repo.html#one/2"},{"type":"function","title":"Lightning.Repo.one!/2","doc":"","ref":"Lightning.Repo.html#one!/2"},{"type":"function","title":"Lightning.Repo.paginate/2","doc":"","ref":"Lightning.Repo.html#paginate/2"},{"type":"function","title":"Lightning.Repo.preload/3","doc":"","ref":"Lightning.Repo.html#preload/3"},{"type":"function","title":"Lightning.Repo.prepare_query/3","doc":"","ref":"Lightning.Repo.html#prepare_query/3"},{"type":"function","title":"Lightning.Repo.put_dynamic_repo/1","doc":"","ref":"Lightning.Repo.html#put_dynamic_repo/1"},{"type":"function","title":"Lightning.Repo.query/3","doc":"A convenience function for SQL-based repositories that executes the given query.\n\nSee `Ecto.Adapters.SQL.query/4` for more information.","ref":"Lightning.Repo.html#query/3"},{"type":"function","title":"Lightning.Repo.query!/3","doc":"A convenience function for SQL-based repositories that executes the given query.\n\nSee `Ecto.Adapters.SQL.query!/4` for more information.","ref":"Lightning.Repo.html#query!/3"},{"type":"function","title":"Lightning.Repo.query_many/3","doc":"A convenience function for SQL-based repositories that executes the given multi-result query.\n\nSee `Ecto.Adapters.SQL.query_many/4` for more information.","ref":"Lightning.Repo.html#query_many/3"},{"type":"function","title":"Lightning.Repo.query_many!/3","doc":"A convenience function for SQL-based repositories that executes the given multi-result query.\n\nSee `Ecto.Adapters.SQL.query_many!/4` for more information.","ref":"Lightning.Repo.html#query_many!/3"},{"type":"function","title":"Lightning.Repo.reload/2","doc":"","ref":"Lightning.Repo.html#reload/2"},{"type":"function","title":"Lightning.Repo.reload!/2","doc":"","ref":"Lightning.Repo.html#reload!/2"},{"type":"function","title":"Lightning.Repo.rollback/1","doc":"","ref":"Lightning.Repo.html#rollback/1"},{"type":"function","title":"Lightning.Repo.scrivener_defaults/0","doc":"","ref":"Lightning.Repo.html#scrivener_defaults/0"},{"type":"function","title":"Lightning.Repo.start_link/1","doc":"","ref":"Lightning.Repo.html#start_link/1"},{"type":"function","title":"Lightning.Repo.stop/1","doc":"","ref":"Lightning.Repo.html#stop/1"},{"type":"function","title":"Lightning.Repo.stream/2","doc":"","ref":"Lightning.Repo.html#stream/2"},{"type":"function","title":"Lightning.Repo.to_sql/2","doc":"A convenience function for SQL-based repositories that translates the given query to SQL.\n\nSee `Ecto.Adapters.SQL.to_sql/3` for more information.","ref":"Lightning.Repo.html#to_sql/2"},{"type":"function","title":"Lightning.Repo.transact/2","doc":"A small wrapper around `Repo.transaction/2`.\n\nCommits the transaction if the lambda returns `:ok` or `{:ok, result}`,\nrolling it back if the lambda returns `:error` or `{:error, reason}`. In both\ncases, the function returns the result of the lambda.\n\nExample:\n\n Repo.transact(fn ->\n with {:ok, user} <- Accounts.create_user(params),\n {:ok, _log} <- Logs.log_action(:user_registered, user),\n {:ok, _job} <- Mailer.enqueue_email_confirmation(user) do\n {:ok, user}\n end\n end)\n\nFrom blog post found [here](https://tomkonidas.com/repo-transact/)","ref":"Lightning.Repo.html#transact/2"},{"type":"function","title":"Lightning.Repo.transaction/2","doc":"","ref":"Lightning.Repo.html#transaction/2"},{"type":"function","title":"Lightning.Repo.update/2","doc":"","ref":"Lightning.Repo.html#update/2"},{"type":"function","title":"Lightning.Repo.update!/2","doc":"","ref":"Lightning.Repo.html#update!/2"},{"type":"function","title":"Lightning.Repo.update_all/3","doc":"","ref":"Lightning.Repo.html#update_all/3"},{"type":"module","title":"Lightning.Run","doc":"Ecto model for Runs.","ref":"Lightning.Run.html"},{"type":"function","title":"Lightning.Run.add_options/2","doc":"Adds options (project-level logging options, resource limits such as timeout\nand memory usage, etc.) to the run before storing in the DB.","ref":"Lightning.Run.html#add_options/2"},{"type":"function","title":"Lightning.Run.complete/2","doc":"","ref":"Lightning.Run.html#complete/2"},{"type":"macro","title":"Lightning.Run.final_states/0","doc":"Returns the list of final states for a run.","ref":"Lightning.Run.html#final_states/0"},{"type":"function","title":"Lightning.Run.for/2","doc":"","ref":"Lightning.Run.html#for/2"},{"type":"function","title":"Lightning.Run.new/1","doc":"","ref":"Lightning.Run.html#new/1"},{"type":"function","title":"Lightning.Run.start/2","doc":"","ref":"Lightning.Run.html#start/2"},{"type":"type","title":"Lightning.Run.t/0","doc":"","ref":"Lightning.Run.html#t:t/0"},{"type":"module","title":"Lightning.RunStep","doc":"Ecto model for an the Steps in a Run.","ref":"Lightning.RunStep.html"},{"type":"function","title":"Lightning.RunStep.new/1","doc":"","ref":"Lightning.RunStep.html#new/1"},{"type":"function","title":"Lightning.RunStep.new/2","doc":"","ref":"Lightning.RunStep.html#new/2"},{"type":"type","title":"Lightning.RunStep.t/0","doc":"","ref":"Lightning.RunStep.html#t:t/0"},{"type":"module","title":"Lightning.SafetyString","doc":"Utilities for securely encoding serializable structs, lists and strings into\nURL-safe strings.\n\nIn order to pass the state around in a URL, in a manner that protects\nsecrets from leaking - and allows us to avoid persistance\nwe take a set of parameters and:\n\n- Encode into a URI query string\n- gzip it to save characters\n- encrypt the string\n- base64 encode it for URI encoding safety","ref":"Lightning.SafetyString.html"},{"type":"function","title":"Lightning.SafetyString.decode/1","doc":"","ref":"Lightning.SafetyString.html#decode/1"},{"type":"function","title":"Lightning.SafetyString.encode/1","doc":"","ref":"Lightning.SafetyString.html#encode/1"},{"type":"module","title":"Lightning.Schema","doc":"Defines the database schema and primary key type for Thunderbolt schemas.","ref":"Lightning.Schema.html"},{"type":"module","title":"Lightning.Scrubber","doc":"Process used to scrub strings of sensitive information.\n\nCan be started via `start_link/1`.\n\n```\n{:ok, scrubber} =\n Lightning.Scrubber.start_link(\n samples:\n Lightning.Credentials.sensitive_values_for(credential)\n )\n```\n\nTakes an optional `:name` key, in case you need to name the process.","ref":"Lightning.Scrubber.html"},{"type":"function","title":"Lightning.Scrubber.add_samples/3","doc":"","ref":"Lightning.Scrubber.html#add_samples/3"},{"type":"function","title":"Lightning.Scrubber.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.Scrubber.html#child_spec/1"},{"type":"function","title":"Lightning.Scrubber.encode_samples/2","doc":"Prepare a list of sensitive samples (strings) into a potentially bigger list\ncomposed of variations a sample may appear.","ref":"Lightning.Scrubber.html#encode_samples/2"},{"type":"function","title":"Lightning.Scrubber.samples/1","doc":"","ref":"Lightning.Scrubber.html#samples/1"},{"type":"function","title":"Lightning.Scrubber.scrub/2","doc":"","ref":"Lightning.Scrubber.html#scrub/2"},{"type":"function","title":"Lightning.Scrubber.start_link/1","doc":"","ref":"Lightning.Scrubber.html#start_link/1"},{"type":"module","title":"Lightning.Services.AccountHook","doc":"Allows handling user creation or registration atomically without relying on async events.","ref":"Lightning.Services.AccountHook.html"},{"type":"function","title":"Lightning.Services.AccountHook.handle_create_user/1","doc":"","ref":"Lightning.Services.AccountHook.html#handle_create_user/1"},{"type":"function","title":"Lightning.Services.AccountHook.handle_register_superuser/1","doc":"","ref":"Lightning.Services.AccountHook.html#handle_register_superuser/1"},{"type":"function","title":"Lightning.Services.AccountHook.handle_register_user/1","doc":"","ref":"Lightning.Services.AccountHook.html#handle_register_user/1"},{"type":"module","title":"Lightning.Services.AdapterHelper","doc":"Maps the module to be used for the extension service.","ref":"Lightning.Services.AdapterHelper.html"},{"type":"function","title":"Lightning.Services.AdapterHelper.adapter/1","doc":"","ref":"Lightning.Services.AdapterHelper.html#adapter/1"},{"type":"module","title":"Lightning.Services.ProjectHook","doc":"Allows handling project creation atomically without relying on async events.","ref":"Lightning.Services.ProjectHook.html"},{"type":"function","title":"Lightning.Services.ProjectHook.handle_create_project/1","doc":"","ref":"Lightning.Services.ProjectHook.html#handle_create_project/1"},{"type":"function","title":"Lightning.Services.ProjectHook.handle_delete_project/1","doc":"","ref":"Lightning.Services.ProjectHook.html#handle_delete_project/1"},{"type":"function","title":"Lightning.Services.ProjectHook.handle_project_validation/1","doc":"","ref":"Lightning.Services.ProjectHook.html#handle_project_validation/1"},{"type":"module","title":"Lightning.Services.RateLimiter","doc":"Adapter to call the extension for rate limiting.","ref":"Lightning.Services.RateLimiter.html"},{"type":"module","title":"Lightning.Services.RunQueue","doc":"Adapter to call the extension for selecting Runtime workloads.","ref":"Lightning.Services.RunQueue.html"},{"type":"module","title":"Lightning.Services.UsageLimiter","doc":"Adapter to call the extension for limiting Runtime workloads.","ref":"Lightning.Services.UsageLimiter.html"},{"type":"module","title":"Lightning.Setup","doc":"Demo encapsulates logic for setting up a demonstration site.","ref":"Lightning.Setup.html"},{"type":"function","title":"Lightning.Setup.ensure_minimum_setup/0","doc":"Set up the bare minimum so that commands can be executed against the repo.","ref":"Lightning.Setup.html#ensure_minimum_setup/0"},{"type":"function","title":"Lightning.Setup.setup_user/3","doc":"This makes it possible to run setup_user as an external command\n\nSee: Lightning.SetupUtils.setup_user() for more docs.","ref":"Lightning.Setup.html#setup_user/3"},{"type":"function","title":"Examples - Lightning.Setup.setup_user/3","doc":"iex> kubectl exec -it deploy/demo-web -- /app/bin/lightning eval Lightning.Setup.setup_user(%{email: \"td@openfn.org\", first_name: \"taylor\", last_name: \"downs\", password: \"shh12345!\"})\n :ok","ref":"Lightning.Setup.html#setup_user/3-examples"},{"type":"module","title":"Lightning.SetupUtils","doc":"SetupUtils encapsulates logic for setting up initial data for various sites.","ref":"Lightning.SetupUtils.html"},{"type":"function","title":"Lightning.SetupUtils.confirm_users/1","doc":"","ref":"Lightning.SetupUtils.html#confirm_users/1"},{"type":"function","title":"Lightning.SetupUtils.create_dhis2_project/1","doc":"","ref":"Lightning.SetupUtils.html#create_dhis2_project/1"},{"type":"function","title":"Lightning.SetupUtils.create_openhie_project/1","doc":"","ref":"Lightning.SetupUtils.html#create_openhie_project/1"},{"type":"function","title":"Lightning.SetupUtils.create_starter_project/2","doc":"","ref":"Lightning.SetupUtils.html#create_starter_project/2"},{"type":"function","title":"Lightning.SetupUtils.create_users/1","doc":"","ref":"Lightning.SetupUtils.html#create_users/1"},{"type":"function","title":"Lightning.SetupUtils.setup_demo/1","doc":"Creates initial data and returns the created records.","ref":"Lightning.SetupUtils.html#setup_demo/1"},{"type":"function","title":"Lightning.SetupUtils.setup_user/3","doc":"In some (mostly remote-controlled) deployments, it's necessary to create a\nuser, and apiToken, and multiple credentials (owned by the user) so that later\n`openfn deploy` calls can make use of these artifacts.\n\nWhen run _before_ `openfn deploy`, this function makes it possible to set up\nan entire lightning instance with a working project (including secrets)\nwithout using the web UI.","ref":"Lightning.SetupUtils.html#setup_user/3"},{"type":"function","title":"Examples - Lightning.SetupUtils.setup_user/3","doc":"iex> setup_user(%{email: \"td@openfn.org\", first_name: \"taylor\", last_name: \"downs\", password: \"shh12345!\"}, \"secretToken\", [%{name: \"openmrs\", schema: \"raw\", body: %{\"a\" => \"secret\"}}, %{ name: \"dhis2\", schema: \"raw\", body: %{\"b\" => \"safe\"}}])\n :ok","ref":"Lightning.SetupUtils.html#setup_user/3-examples"},{"type":"function","title":"Lightning.SetupUtils.tear_down/1","doc":"","ref":"Lightning.SetupUtils.html#tear_down/1"},{"type":"module","title":"Lightning.SetupUtils.Ticker","doc":"Time ticker to assure time progress/sequence specially for multiple logs.","ref":"Lightning.SetupUtils.Ticker.html"},{"type":"function","title":"Lightning.SetupUtils.Ticker.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.SetupUtils.Ticker.html#child_spec/1"},{"type":"function","title":"Lightning.SetupUtils.Ticker.next/1","doc":"","ref":"Lightning.SetupUtils.Ticker.html#next/1"},{"type":"function","title":"Lightning.SetupUtils.Ticker.start_link/1","doc":"","ref":"Lightning.SetupUtils.Ticker.html#start_link/1"},{"type":"function","title":"Lightning.SetupUtils.Ticker.stop/1","doc":"","ref":"Lightning.SetupUtils.Ticker.html#stop/1"},{"type":"module","title":"Lightning.Storage","doc":"The external storage module.\n\nThis module is responsible for storing and retrieving files from the\nconfigured storage backend.","ref":"Lightning.Storage.html"},{"type":"behaviour","title":"Lightning.Storage.Backend","doc":"The behaviour for storage backends.","ref":"Lightning.Storage.Backend.html"},{"type":"callback","title":"Lightning.Storage.Backend.get_url/1","doc":"","ref":"Lightning.Storage.Backend.html#c:get_url/1"},{"type":"callback","title":"Lightning.Storage.Backend.store/2","doc":"","ref":"Lightning.Storage.Backend.html#c:store/2"},{"type":"module","title":"Lightning.Storage.GCS","doc":"A storage backend module for handling file storage in Google Cloud Storage (GCS).\n\nIt implements the `Lightning.Storage.Backend` behaviour to manage file storage operations in Google Cloud Storage. This includes storing files to GCS buckets and generating signed URLs for secure access to the stored files.","ref":"Lightning.Storage.GCS.html"},{"type":"module","title":"Responsibilities - Lightning.Storage.GCS","doc":"- **Storing Files**: The `store/2` function uploads files from a local source path to a specified destination path within a GCS bucket.\n- **Generating Signed URLs**: The `get_url/1` function generates a signed URL for accessing a file stored in GCS. This signed URL is valid for a limited time (default 1 hour).\n- **Configuration**: The module relies on application configuration to determine the GCS bucket and Google API connection settings.","ref":"Lightning.Storage.GCS.html#module-responsibilities"},{"type":"module","title":"Example Usage - Lightning.Storage.GCS","doc":"```elixir\n# Store a file in GCS\nLightning.Storage.GCS.store(\"/path/to/source\", \"destination/path\")\n\n# Get a signed URL for the stored file\n{:ok, url} = Lightning.Storage.GCS.get_url(\"destination/path\")\n```","ref":"Lightning.Storage.GCS.html#module-example-usage"},{"type":"module","title":"Lightning.Storage.Local","doc":"A storage backend module for handling local file storage.\n\nIt implements the `Lightning.Storage.Backend` behaviour to manage file storage\noperations on the local file system. This includes storing files from a source\npath to a destination path and generating URLs for accessing stored files.","ref":"Lightning.Storage.Local.html"},{"type":"module","title":"Responsibilities - Lightning.Storage.Local","doc":"- **Storing Files**: The `store/2` function is responsible for copying files\n from a given source path to a specified destination path on the local file\n system.\n- **Generating URLs**: The `get_url/1` function generates a `file://` URL for\n accessing a stored file locally.\n- **Configuration**: The module relies on application configuration to\n determine the root directory for storage operations.","ref":"Lightning.Storage.Local.html#module-responsibilities"},{"type":"module","title":"Example Usage - Lightning.Storage.Local","doc":"```elixir\n# Store a file\n{:ok, filename} =\n Lightning.Storage.Local.store(\"/path/to/source\", \"destination/path\")\n\n# Get the URL for the stored file\n{:ok, url} = Lightning.Storage.Local.get_url(\"destination/path\")\n```","ref":"Lightning.Storage.Local.html#module-example-usage"},{"type":"module","title":"Lightning.Storage.ProjectFileDefinition","doc":"This module provides functionality for managing the storage and retrieval of project files.\n\n It handles operations related to storing project files, generating URLs for accessing these files, and constructing storage paths for exported files. It serves as an abstraction layer over the underlying storage mechanism provided by the `Lightning.Storage` module.","ref":"Lightning.Storage.ProjectFileDefinition.html"},{"type":"module","title":"Functions - Lightning.Storage.ProjectFileDefinition","doc":"- `store/2`: Stores a file from a given source path into the storage system based on the file's path.\n - `get_url/1`: Retrieves the URL for accessing a stored file.\n - `storage_path_for_exports/2`: Constructs a storage path for exported files, defaulting to a `.zip` extension.","ref":"Lightning.Storage.ProjectFileDefinition.html#module-functions"},{"type":"module","title":"Example Usage - Lightning.Storage.ProjectFileDefinition","doc":"```elixir\n # Store a file\n Lightning.Storage.ProjectFileDefinition.store(\"/path/to/source\", project_file)\n\n # Get a URL for the stored file\n url = Lightning.Storage.ProjectFileDefinition.get_url(project_file)\n\n # Get the storage path for an exported file\n path = Lightning.Storage.ProjectFileDefinition.storage_path_for_exports(project_file)\n ```","ref":"Lightning.Storage.ProjectFileDefinition.html#module-example-usage"},{"type":"function","title":"Lightning.Storage.ProjectFileDefinition.get_url/1","doc":"","ref":"Lightning.Storage.ProjectFileDefinition.html#get_url/1"},{"type":"function","title":"Lightning.Storage.ProjectFileDefinition.storage_path_for_exports/2","doc":"","ref":"Lightning.Storage.ProjectFileDefinition.html#storage_path_for_exports/2"},{"type":"function","title":"Lightning.Storage.ProjectFileDefinition.store/2","doc":"","ref":"Lightning.Storage.ProjectFileDefinition.html#store/2"},{"type":"module","title":"Lightning.TaskWorker","doc":"A TaskWorker with concurrency limits.\n\nA simple concurrency limiter that wraps `Task.Supervisor`, which already does\nhave the ability to specify `max_children`; it throws an error when\nthat limit is exceeded.\n\nTo use it, start it like any other process; ideally in your supervision tree.\n\n```\n ...,\n {Lightning.TaskWorker, name: :cli_task_worker, max_tasks: 4}\n```\n\n**Options**\n\n- `:max_tasks` Defaults to the number of system schedulers available to the vm.","ref":"Lightning.TaskWorker.html"},{"type":"function","title":"Lightning.TaskWorker.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.TaskWorker.html#child_spec/1"},{"type":"function","title":"Lightning.TaskWorker.get_status/1","doc":"","ref":"Lightning.TaskWorker.html#get_status/1"},{"type":"function","title":"Lightning.TaskWorker.start_link/1","doc":"","ref":"Lightning.TaskWorker.html#start_link/1"},{"type":"function","title":"Lightning.TaskWorker.start_task/2","doc":"","ref":"Lightning.TaskWorker.html#start_task/2"},{"type":"module","title":"Lightning.Tokens","doc":"Token generation, verification and validation.","ref":"Lightning.Tokens.html"},{"type":"function","title":"Lightning.Tokens.get_subject/1","doc":"Get the subject of a token.\nCurrently support RunTokens and PersonalAccessTokens,\nwhich return `Lightning.Run`s and `Lightning.Accounts.User`s respectively.","ref":"Lightning.Tokens.html#get_subject/1"},{"type":"function","title":"Lightning.Tokens.verify/1","doc":"Verify a token and return the claims if successful.\n\nThis serves as a central point to verify and validate different types\nof tokens.","ref":"Lightning.Tokens.html#verify/1"},{"type":"module","title":"Lightning.UsageTracking","doc":"The UsageTracking context.","ref":"Lightning.UsageTracking.html"},{"type":"function","title":"Lightning.UsageTracking.disable_daily_report/0","doc":"","ref":"Lightning.UsageTracking.html#disable_daily_report/0"},{"type":"function","title":"Lightning.UsageTracking.enable_daily_report/1","doc":"","ref":"Lightning.UsageTracking.html#enable_daily_report/1"},{"type":"function","title":"Lightning.UsageTracking.enqueue_reports/3","doc":"","ref":"Lightning.UsageTracking.html#enqueue_reports/3"},{"type":"function","title":"Lightning.UsageTracking.find_enabled_daily_report_config/0","doc":"","ref":"Lightning.UsageTracking.html#find_enabled_daily_report_config/0"},{"type":"function","title":"Lightning.UsageTracking.insert_report/3","doc":"","ref":"Lightning.UsageTracking.html#insert_report/3"},{"type":"function","title":"Lightning.UsageTracking.lightning_version/0","doc":"","ref":"Lightning.UsageTracking.html#lightning_version/0"},{"type":"function","title":"Lightning.UsageTracking.reportable_dates/3","doc":"","ref":"Lightning.UsageTracking.html#reportable_dates/3"},{"type":"function","title":"Lightning.UsageTracking.start_reporting_after/1","doc":"","ref":"Lightning.UsageTracking.html#start_reporting_after/1"},{"type":"function","title":"Lightning.UsageTracking.submit_report/2","doc":"","ref":"Lightning.UsageTracking.html#submit_report/2"},{"type":"function","title":"Lightning.UsageTracking.update_report_submission!/2","doc":"","ref":"Lightning.UsageTracking.html#update_report_submission!/2"},{"type":"module","title":"Lightning.UsageTracking.Client","doc":"Client for Usage Tracker service","ref":"Lightning.UsageTracking.Client.html"},{"type":"function","title":"Lightning.UsageTracking.Client.reachable?/1","doc":"","ref":"Lightning.UsageTracking.Client.html#reachable?/1"},{"type":"function","title":"Lightning.UsageTracking.Client.submit_metrics/2","doc":"","ref":"Lightning.UsageTracking.Client.html#submit_metrics/2"},{"type":"module","title":"Lightning.UsageTracking.DailyReportConfiguration","doc":"Configuration for the creation of daily reports","ref":"Lightning.UsageTracking.DailyReportConfiguration.html"},{"type":"function","title":"Lightning.UsageTracking.DailyReportConfiguration.changeset/2","doc":"","ref":"Lightning.UsageTracking.DailyReportConfiguration.html#changeset/2"},{"type":"module","title":"Lightning.UsageTracking.DayWorker","doc":"Worker to manage per-day report generation","ref":"Lightning.UsageTracking.DayWorker.html"},{"type":"module","title":"Lightning.UsageTracking.GithubClient","doc":"A github client to make unauthenticated HTTP requests to Github.","ref":"Lightning.UsageTracking.GithubClient.html"},{"type":"function","title":"Lightning.UsageTracking.GithubClient.build_client/1","doc":"","ref":"Lightning.UsageTracking.GithubClient.html#build_client/1"},{"type":"function","title":"Lightning.UsageTracking.GithubClient.open_fn_commit?/1","doc":"","ref":"Lightning.UsageTracking.GithubClient.html#open_fn_commit?/1"},{"type":"module","title":"Lightning.UsageTracking.ProjectMetricsService","doc":"Builds project-related metrics.","ref":"Lightning.UsageTracking.ProjectMetricsService.html"},{"type":"function","title":"Lightning.UsageTracking.ProjectMetricsService.find_eligible_projects/1","doc":"","ref":"Lightning.UsageTracking.ProjectMetricsService.html#find_eligible_projects/1"},{"type":"function","title":"Lightning.UsageTracking.ProjectMetricsService.generate_metrics/3","doc":"","ref":"Lightning.UsageTracking.ProjectMetricsService.html#generate_metrics/3"},{"type":"module","title":"Lightning.UsageTracking.Report","doc":"Report submitted to Usage Tracker","ref":"Lightning.UsageTracking.Report.html"},{"type":"function","title":"Lightning.UsageTracking.Report.changeset/2","doc":"","ref":"Lightning.UsageTracking.Report.html#changeset/2"},{"type":"module","title":"Lightning.UsageTracking.ReportData","doc":"Builds data set for submission to Usage Tracker","ref":"Lightning.UsageTracking.ReportData.html"},{"type":"function","title":"Lightning.UsageTracking.ReportData.generate/3","doc":"","ref":"Lightning.UsageTracking.ReportData.html#generate/3"},{"type":"module","title":"Lightning.UsageTracking.ReportWorker","doc":"Worker to generate report for given day","ref":"Lightning.UsageTracking.ReportWorker.html"},{"type":"module","title":"Lightning.UsageTracking.ResponseProcessor","doc":"Utility module to abstract dealing with some of the Tesla plumbing","ref":"Lightning.UsageTracking.ResponseProcessor.html"},{"type":"function","title":"Lightning.UsageTracking.ResponseProcessor.successful?/1","doc":"","ref":"Lightning.UsageTracking.ResponseProcessor.html#successful?/1"},{"type":"function","title":"Lightning.UsageTracking.ResponseProcessor.successful_200?/1","doc":"","ref":"Lightning.UsageTracking.ResponseProcessor.html#successful_200?/1"},{"type":"module","title":"Lightning.UsageTracking.ResubmissionCandidatesWorker","doc":"Worker to find reports that have failed submissions and enqueue jobs to\nreprocess them.","ref":"Lightning.UsageTracking.ResubmissionCandidatesWorker.html"},{"type":"module","title":"Lightning.UsageTracking.ResubmissionWorker","doc":"Worker to resubmit report that has failed submission.","ref":"Lightning.UsageTracking.ResubmissionWorker.html"},{"type":"module","title":"Lightning.UsageTracking.RunService","doc":"Supports the generation of metrics related to runs and steps.","ref":"Lightning.UsageTracking.RunService.html"},{"type":"function","title":"Lightning.UsageTracking.RunService.finished_runs/2","doc":"","ref":"Lightning.UsageTracking.RunService.html#finished_runs/2"},{"type":"function","title":"Lightning.UsageTracking.RunService.finished_steps/2","doc":"","ref":"Lightning.UsageTracking.RunService.html#finished_steps/2"},{"type":"function","title":"Lightning.UsageTracking.RunService.unique_job_ids/2","doc":"","ref":"Lightning.UsageTracking.RunService.html#unique_job_ids/2"},{"type":"module","title":"Lightning.UsageTracking.UserQueries","doc":"Contains queries used to determine user-related metrics.","ref":"Lightning.UsageTracking.UserQueries.html"},{"type":"function","title":"Lightning.UsageTracking.UserQueries.active_users/1","doc":"","ref":"Lightning.UsageTracking.UserQueries.html#active_users/1"},{"type":"function","title":"Lightning.UsageTracking.UserQueries.active_users/2","doc":"","ref":"Lightning.UsageTracking.UserQueries.html#active_users/2"},{"type":"function","title":"Lightning.UsageTracking.UserQueries.existing_users/1","doc":"","ref":"Lightning.UsageTracking.UserQueries.html#existing_users/1"},{"type":"function","title":"Lightning.UsageTracking.UserQueries.existing_users/2","doc":"","ref":"Lightning.UsageTracking.UserQueries.html#existing_users/2"},{"type":"module","title":"Lightning.UsageTracking.UserService","doc":"Returns counts for the various user-related metrics.","ref":"Lightning.UsageTracking.UserService.html"},{"type":"function","title":"Lightning.UsageTracking.UserService.no_of_active_users/1","doc":"","ref":"Lightning.UsageTracking.UserService.html#no_of_active_users/1"},{"type":"function","title":"Lightning.UsageTracking.UserService.no_of_active_users/2","doc":"","ref":"Lightning.UsageTracking.UserService.html#no_of_active_users/2"},{"type":"function","title":"Lightning.UsageTracking.UserService.no_of_users/1","doc":"","ref":"Lightning.UsageTracking.UserService.html#no_of_users/1"},{"type":"function","title":"Lightning.UsageTracking.UserService.no_of_users/2","doc":"","ref":"Lightning.UsageTracking.UserService.html#no_of_users/2"},{"type":"module","title":"Lightning.UsageTracking.WorkflowMetricsService","doc":"Builds workflow-related metrics.","ref":"Lightning.UsageTracking.WorkflowMetricsService.html"},{"type":"function","title":"Lightning.UsageTracking.WorkflowMetricsService.find_eligible_workflows/2","doc":"","ref":"Lightning.UsageTracking.WorkflowMetricsService.html#find_eligible_workflows/2"},{"type":"function","title":"Lightning.UsageTracking.WorkflowMetricsService.generate_metrics/3","doc":"","ref":"Lightning.UsageTracking.WorkflowMetricsService.html#generate_metrics/3"},{"type":"module","title":"Lightning.Utils.Crypto","doc":"Utility functions for cryptographic operations.","ref":"Lightning.Utils.Crypto.html"},{"type":"function","title":"Lightning.Utils.Crypto.generate_hs256_key/0","doc":"Generates a new HS256 key.","ref":"Lightning.Utils.Crypto.html#generate_hs256_key/0"},{"type":"function","title":"Lightning.Utils.Crypto.generate_rsa_key_pair/0","doc":"Generates a new RSA key pair with 2048 bits and a public exponent of 65537.\n\nThis is preferable to using `create_private_key` and `abstract_public_key` as\nit generates a key pair in one step, and also doesn't require shelling out to\n`openssl`.","ref":"Lightning.Utils.Crypto.html#generate_rsa_key_pair/0"},{"type":"module","title":"Lightning.Validators","doc":"Extra validators for Ecto.Changeset.","ref":"Lightning.Validators.html"},{"type":"function","title":"Lightning.Validators.validate_exclusive/3","doc":"Validate that only one of the fields is set at a time.\n\nExample:\n\n```\nchangeset\n|> validate_exclusive(\n [:source_job_id, :source_trigger_id],\n \"source_job_id and source_trigger_id are mutually exclusive\"\n)\n```","ref":"Lightning.Validators.html#validate_exclusive/3"},{"type":"function","title":"Lightning.Validators.validate_one_required/3","doc":"Validate that at least one of the fields is set.","ref":"Lightning.Validators.html#validate_one_required/3"},{"type":"function","title":"Lightning.Validators.validate_required_assoc/3","doc":"Validate that an association is present\n\n> **NOTE**\n> This should only be used when using `put_assoc`, not `cast_assoc`.\n> `cast_assoc` provides a `required: true` option.\n> Unlike `validate_required`, this does not add the field to the `required`\n> list in the schema.","ref":"Lightning.Validators.html#validate_required_assoc/3"},{"type":"function","title":"Lightning.Validators.validate_url/2","doc":"Validates a URL in a changeset field.\n\nEnsures that the URL:\n- Has a valid `http` or `https` scheme.\n- Has a valid host (domain name, IPv4, or IPv6).\n- The host is not blank and does not exceed 255 characters.\n\nReturns a changeset error for invalid URLs.","ref":"Lightning.Validators.html#validate_url/2"},{"type":"module","title":"Lightning.Vault","doc":"Module for handling the encryption and decryption of database fields.","ref":"Lightning.Vault.html"},{"type":"function","title":"Lightning.Vault.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.Vault.html#child_spec/1"},{"type":"function","title":"Lightning.Vault.start_link/1","doc":"","ref":"Lightning.Vault.html#start_link/1"},{"type":"module","title":"Lightning.VersionControl","doc":"Boundary module for handling Version control activities for project, jobs\nworkflows etc\nUse this module to create, modify and delete connections as well\nas running any associated sync jobs","ref":"Lightning.VersionControl.html"},{"type":"function","title":"Lightning.VersionControl.create_github_connection/2","doc":"Creates a connection between a project and a github repo","ref":"Lightning.VersionControl.html#create_github_connection/2"},{"type":"function","title":"Lightning.VersionControl.delete_github_oauth_grant/1","doc":"Deletes the authorization for the github app and updates the user details accordingly","ref":"Lightning.VersionControl.html#delete_github_oauth_grant/1"},{"type":"function","title":"Lightning.VersionControl.exchange_code_for_oauth_token/1","doc":"Fetches the oauth access token using the code received from the callback url\nFor more info: https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app","ref":"Lightning.VersionControl.html#exchange_code_for_oauth_token/1"},{"type":"function","title":"Lightning.VersionControl.fetch_installation_repos/1","doc":"","ref":"Lightning.VersionControl.html#fetch_installation_repos/1"},{"type":"function","title":"Lightning.VersionControl.fetch_repo_branches/2","doc":"","ref":"Lightning.VersionControl.html#fetch_repo_branches/2"},{"type":"function","title":"Lightning.VersionControl.fetch_user_access_token/1","doc":"Fecthes the access token for the given `User`.\nIf the access token has expired, it `refreshes` the token and updates the `User` column accordingly","ref":"Lightning.VersionControl.html#fetch_user_access_token/1"},{"type":"function","title":"Lightning.VersionControl.fetch_user_installations/1","doc":"","ref":"Lightning.VersionControl.html#fetch_user_installations/1"},{"type":"function","title":"Lightning.VersionControl.get_repo_connection_for_project/1","doc":"","ref":"Lightning.VersionControl.html#get_repo_connection_for_project/1"},{"type":"function","title":"Lightning.VersionControl.get_repo_connection_for_token/1","doc":"","ref":"Lightning.VersionControl.html#get_repo_connection_for_token/1"},{"type":"function","title":"Lightning.VersionControl.github_enabled?/0","doc":"","ref":"Lightning.VersionControl.html#github_enabled?/0"},{"type":"function","title":"Lightning.VersionControl.initiate_sync/2","doc":"","ref":"Lightning.VersionControl.html#initiate_sync/2"},{"type":"function","title":"Lightning.VersionControl.oauth_token_valid?/1","doc":"Checks if the given token has expired.\nGithub supports access tokens that expire and those that don't.\nIf the `access token` expires, then a `refresh token` is also availed.\nThis function simply checks if the token has a `refresh_token`, if yes, it proceeds to check the expiry date","ref":"Lightning.VersionControl.html#oauth_token_valid?/1"},{"type":"function","title":"Lightning.VersionControl.reconfigure_github_connection/3","doc":"","ref":"Lightning.VersionControl.html#reconfigure_github_connection/3"},{"type":"function","title":"Lightning.VersionControl.refresh_oauth_token/1","doc":"Fetches a new access token using the given refresh token\nFor more info: https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens","ref":"Lightning.VersionControl.html#refresh_oauth_token/1"},{"type":"function","title":"Lightning.VersionControl.remove_github_connection/2","doc":"Deletes a github connection","ref":"Lightning.VersionControl.html#remove_github_connection/2"},{"type":"function","title":"Lightning.VersionControl.save_oauth_token/3","doc":"","ref":"Lightning.VersionControl.html#save_oauth_token/3"},{"type":"function","title":"Lightning.VersionControl.subscribe/1","doc":"","ref":"Lightning.VersionControl.html#subscribe/1"},{"type":"function","title":"Lightning.VersionControl.verify_github_connection/1","doc":"","ref":"Lightning.VersionControl.html#verify_github_connection/1"},{"type":"module","title":"Lightning.VersionControl.Events","doc":"","ref":"Lightning.VersionControl.Events.html"},{"type":"function","title":"Lightning.VersionControl.Events.oauth_token_added/1","doc":"","ref":"Lightning.VersionControl.Events.html#oauth_token_added/1"},{"type":"function","title":"Lightning.VersionControl.Events.oauth_token_failed/2","doc":"","ref":"Lightning.VersionControl.Events.html#oauth_token_failed/2"},{"type":"function","title":"Lightning.VersionControl.Events.subscribe/1","doc":"","ref":"Lightning.VersionControl.Events.html#subscribe/1"},{"type":"module","title":"Lightning.VersionControl.GithubClient","doc":"Tesla github http client we use this to make any network requests\nto github from Lightning","ref":"Lightning.VersionControl.GithubClient.html"},{"type":"function","title":"Lightning.VersionControl.GithubClient.build_basic_auth_client/2","doc":"","ref":"Lightning.VersionControl.GithubClient.html#build_basic_auth_client/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.build_bearer_client/1","doc":"","ref":"Lightning.VersionControl.GithubClient.html#build_bearer_client/1"},{"type":"function","title":"Lightning.VersionControl.GithubClient.build_installation_client/1","doc":"","ref":"Lightning.VersionControl.GithubClient.html#build_installation_client/1"},{"type":"function","title":"Lightning.VersionControl.GithubClient.build_oauth_client/0","doc":"","ref":"Lightning.VersionControl.GithubClient.html#build_oauth_client/0"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_blob/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_blob/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_commit/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_commit/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_ref/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_ref/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_repo_dispatch_event/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_repo_dispatch_event/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_repo_secret/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_repo_secret/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_tree/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_tree/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_workflow_dispatch_event/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_workflow_dispatch_event/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete/3","doc":"Perform a DELETE request.\n\nSee `request/1` or `request/2` for options definition.\n\n delete(\"/users\")\n delete(\"/users\", query: [scope: \"admin\"])\n delete(client, \"/users\")\n delete(client, \"/users\", query: [scope: \"admin\"])\n delete(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#delete/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete!/3","doc":"Perform a DELETE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n delete!(\"/users\")\n delete!(\"/users\", query: [scope: \"admin\"])\n delete!(client, \"/users\")\n delete!(client, \"/users\", query: [scope: \"admin\"])\n delete!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#delete!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete_app_grant/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#delete_app_grant/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete_ref/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#delete_ref/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete_repo_content/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#delete_repo_content/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete_repo_secret/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#delete_repo_secret/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get/3","doc":"Perform a GET request.\n\nSee `request/1` or `request/2` for options definition.\n\n get(\"/users\")\n get(\"/users\", query: [scope: \"admin\"])\n get(client, \"/users\")\n get(client, \"/users\", query: [scope: \"admin\"])\n get(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#get/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get!/3","doc":"Perform a GET request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n get!(\"/users\")\n get!(\"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\")\n get!(client, \"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#get!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_commit/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_commit/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_installation_repos/1","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_installation_repos/1"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_installations/1","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_installations/1"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo/2","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo_branches/2","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo_branches/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo_content/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo_content/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo_public_key/2","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo_public_key/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo_secret/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo_secret/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.head/3","doc":"Perform a HEAD request.\n\nSee `request/1` or `request/2` for options definition.\n\n head(\"/users\")\n head(\"/users\", query: [scope: \"admin\"])\n head(client, \"/users\")\n head(client, \"/users\", query: [scope: \"admin\"])\n head(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#head/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.head!/3","doc":"Perform a HEAD request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n head!(\"/users\")\n head!(\"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\")\n head!(client, \"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#head!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.options/3","doc":"Perform a OPTIONS request.\n\nSee `request/1` or `request/2` for options definition.\n\n options(\"/users\")\n options(\"/users\", query: [scope: \"admin\"])\n options(client, \"/users\")\n options(client, \"/users\", query: [scope: \"admin\"])\n options(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#options/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.options!/3","doc":"Perform a OPTIONS request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n options!(\"/users\")\n options!(\"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\")\n options!(client, \"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#options!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.patch/4","doc":"Perform a PATCH request.\n\nSee `request/1` or `request/2` for options definition.\n\n patch(\"/users\", %{name: \"Jon\"})\n patch(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch(client, \"/users\", %{name: \"Jon\"})\n patch(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#patch/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.patch!/4","doc":"Perform a PATCH request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n patch!(\"/users\", %{name: \"Jon\"})\n patch!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch!(client, \"/users\", %{name: \"Jon\"})\n patch!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#patch!/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.post/4","doc":"Perform a POST request.\n\nSee `request/1` or `request/2` for options definition.\n\n post(\"/users\", %{name: \"Jon\"})\n post(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n post(client, \"/users\", %{name: \"Jon\"})\n post(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#post/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.post!/4","doc":"Perform a POST request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n post!(\"/users\", %{name: \"Jon\"})\n post!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n post!(client, \"/users\", %{name: \"Jon\"})\n post!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#post!/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.put/4","doc":"Perform a PUT request.\n\nSee `request/1` or `request/2` for options definition.\n\n put(\"/users\", %{name: \"Jon\"})\n put(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n put(client, \"/users\", %{name: \"Jon\"})\n put(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#put/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.put!/4","doc":"Perform a PUT request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n put!(\"/users\", %{name: \"Jon\"})\n put!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n put!(client, \"/users\", %{name: \"Jon\"})\n put!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#put!/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.request/2","doc":"Perform a request.","ref":"Lightning.VersionControl.GithubClient.html#request/2"},{"type":"function","title":"Options - Lightning.VersionControl.GithubClient.request/2","doc":"- `:method` - the request method, one of [`:head`, `:get`, `:delete`, `:trace`, `:options`, `:post`, `:put`, `:patch`]\n- `:url` - either full url e.g. \"http://example.com/some/path\" or just \"/some/path\" if using `Tesla.Middleware.BaseUrl`\n- `:query` - a keyword list of query params, e.g. `[page: 1, per_page: 100]`\n- `:headers` - a keyword list of headers, e.g. `[{\"content-type\", \"text/plain\"}]`\n- `:body` - depends on used middleware:\n - by default it can be a binary\n - if using e.g. JSON encoding middleware it can be a nested map\n - if adapter supports it it can be a Stream with any of the above\n- `:opts` - custom, per-request middleware or adapter options","ref":"Lightning.VersionControl.GithubClient.html#request/2-options"},{"type":"function","title":"Examples - Lightning.VersionControl.GithubClient.request/2","doc":"ExampleApi.request(method: :get, url: \"/users/path\")\n\n # use shortcut methods\n ExampleApi.get(\"/users/1\")\n ExampleApi.post(client, \"/users\", %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#request/2-examples"},{"type":"function","title":"Lightning.VersionControl.GithubClient.request!/2","doc":"Perform request and raise in case of error.\n\nThis is similar to `request/2` behaviour from Tesla 0.x\n\nSee `request/2` for list of available options.","ref":"Lightning.VersionControl.GithubClient.html#request!/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.trace/3","doc":"Perform a TRACE request.\n\nSee `request/1` or `request/2` for options definition.\n\n trace(\"/users\")\n trace(\"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\")\n trace(client, \"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#trace/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.trace!/3","doc":"Perform a TRACE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n trace!(\"/users\")\n trace!(\"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\")\n trace!(client, \"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#trace!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.update_ref/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#update_ref/4"},{"type":"type","title":"Lightning.VersionControl.GithubClient.option/0","doc":"Options that may be passed to a request function. See `request/2` for detailed descriptions.","ref":"Lightning.VersionControl.GithubClient.html#t:option/0"},{"type":"exception","title":"Lightning.VersionControl.GithubError","doc":"GitHub Error exception","ref":"Lightning.VersionControl.GithubError.html"},{"type":"function","title":"Lightning.VersionControl.GithubError.api_error/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#api_error/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.file_not_found/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#file_not_found/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.installation_not_found/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#installation_not_found/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.invalid_certificate/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#invalid_certificate/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.invalid_oauth_token/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#invalid_oauth_token/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.misconfigured/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#misconfigured/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.new/3","doc":"","ref":"Lightning.VersionControl.GithubError.html#new/3"},{"type":"function","title":"Lightning.VersionControl.GithubError.repo_secret_not_found/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#repo_secret_not_found/2"},{"type":"type","title":"Lightning.VersionControl.GithubError.t/0","doc":"","ref":"Lightning.VersionControl.GithubError.html#t:t/0"},{"type":"module","title":"Lightning.VersionControl.GithubToken","doc":"A module that `uses` Joken to handle building and signing application\ntokens for communicating with github\n\nSee: https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-json-web-token-jwt-for-a-github-app#about-json-web-tokens-jwts","ref":"Lightning.VersionControl.GithubToken.html"},{"type":"function","title":"Lightning.VersionControl.GithubToken.build/2","doc":"","ref":"Lightning.VersionControl.GithubToken.html#build/2"},{"type":"function","title":"Lightning.VersionControl.GithubToken.generate_and_sign/2","doc":"Combines `generate_claims/1` and `encode_and_sign/2`","ref":"Lightning.VersionControl.GithubToken.html#generate_and_sign/2"},{"type":"function","title":"Lightning.VersionControl.GithubToken.generate_and_sign!/2","doc":"Same as `generate_and_sign/2` but raises if error","ref":"Lightning.VersionControl.GithubToken.html#generate_and_sign!/2"},{"type":"function","title":"Lightning.VersionControl.GithubToken.verify_and_validate/3","doc":"Combines `verify/2` and `validate/2`","ref":"Lightning.VersionControl.GithubToken.html#verify_and_validate/3"},{"type":"function","title":"Lightning.VersionControl.GithubToken.verify_and_validate!/3","doc":"Same as `verify_and_validate/2` but raises if error","ref":"Lightning.VersionControl.GithubToken.html#verify_and_validate!/3"},{"type":"module","title":"Lightning.VersionControl.ProjectRepoConnection","doc":"Ecto model for project repo connections","ref":"Lightning.VersionControl.ProjectRepoConnection.html"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.changeset/2","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#changeset/2"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.config_path/1","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#config_path/1"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.configure_changeset/2","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#configure_changeset/2"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.create_changeset/2","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#create_changeset/2"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.reconfigure_changeset/2","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#reconfigure_changeset/2"},{"type":"type","title":"Lightning.VersionControl.ProjectRepoConnection.t/0","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#t:t/0"},{"type":"module","title":"Lightning.WebhookAuthMethods","doc":"Provides functionality for managing webhook authentication methods.\n\nThis module contains functions to create, update, list, and delete authentication methods\nfor webhooks. It supports operations such as scheduling authentication methods for deletion,\npurging them, associating them with triggers, and handling their life cycle within the system.\n\nThe main responsibilities of this module include:\n\n- Creating new webhook authentication methods with `create_auth_method/2`.\n- Associating and disassociating authentication methods with triggers.\n- Updating existing webhook authentication methods with `update_auth_method/3`.\n- Listing webhook authentication methods for a given project or trigger.\n- Finding a webhook authentication method by various identifiers, like API key or username and password.\n- Scheduling webhook authentication methods for deletion and purging them accordingly.","ref":"Lightning.WebhookAuthMethods.html"},{"type":"function","title":"Lightning.WebhookAuthMethods.create_auth_method/2","doc":"Creates a new `WebhookAuthMethod` and associated audit records.\n\nThis function supports creating a `WebhookAuthMethod` either standalone or associated with a `Trigger`. It performs a database transaction that includes creating the auth method and its audit trail.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- `attrs`: A map of attributes used to create the `WebhookAuthMethod`.\n - `actor`: The user performing the action, provided as a `%User{}` struct.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-parameters"},{"type":"function","title":"Overloads - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- When called with a map of attributes, it creates a `WebhookAuthMethod` without associating it to a trigger.\n - When called with a `Trigger` struct and a map of attributes, it creates a `WebhookAuthMethod` and associates it with the provided trigger.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-overloads"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- `{:ok, %WebhookAuthMethod{}}`: A tuple containing `:ok` and the newly created `WebhookAuthMethod` struct if the creation was successful.\n - `{:error, %Ecto.Changeset{}}`: A tuple containing `:error` and the changeset with errors if the creation failed.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- Creating a `WebhookAuthMethod` without an associated trigger:\n\n ```elixir\n iex> create_auth_method(%{valid_attributes}, actor: %User{})\n {:ok, %WebhookAuthMethod{}}\n\n iex> create_auth_method(%{invalid_attributes}, actor: %User{})\n {:error, %Ecto.Changeset{}}\n ```\n\n - Creating a `WebhookAuthMethod` with an associated trigger:\n\n ```elixir\n iex> create_auth_method(%Trigger{}, %{valid_attributes}, actor: %User{})\n {:ok, %WebhookAuthMethod{}}\n\n iex> create_auth_method(%Trigger{}, %{invalid_attributes}, actor: %User{})\n {:error, %Ecto.Changeset{}}\n ```","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-examples"},{"type":"function","title":"Notes - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- This function starts a `Repo.transaction` to ensure that all database operations are atomic. If any part of the transaction fails, all changes will be rolled back.\n - Audit events are created for both the creation of the `WebhookAuthMethod` and its association with a trigger, if applicable.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-notes"},{"type":"function","title":"Lightning.WebhookAuthMethods.create_auth_method/3","doc":"","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/3"},{"type":"function","title":"Lightning.WebhookAuthMethods.create_changeset/2","doc":"Creates a changeset for a `WebhookAuthMethod` struct, which can include special handling based on the authentication type.\n\nThis function prepares a changeset for the creation or update of a `WebhookAuthMethod`. If the `auth_type` is `:api`, it generates a new API key and includes it in the returned structure.","ref":"Lightning.WebhookAuthMethods.html#create_changeset/2"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.create_changeset/2","doc":"- `webhook_auth_method`: The `WebhookAuthMethod` struct to be updated.\n - `params`: A map containing the parameters with which to update the `webhook_auth_method`.","ref":"Lightning.WebhookAuthMethods.html#create_changeset/2-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.create_changeset/2","doc":"- Returns the updated `WebhookAuthMethod` struct with changes applied. If `auth_type` is `:api`, an API key is generated and included.","ref":"Lightning.WebhookAuthMethods.html#create_changeset/2-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.create_changeset/2","doc":"- Creating a changeset for an API type auth method:\n\n ```elixir\n iex> Lightning.Workflows.create_changeset(%WebhookAuthMethod{auth_type: :api}, %{})\n %WebhookAuthMethod{api_key: some_new_api_key}\n ```\n\n - Creating a changeset for a non-API type auth method:\n\n ```elixir\n iex> Lightning.Workflows.create_changeset(%WebhookAuthMethod{auth_type: :other}, %{})\n %WebhookAuthMethod{}\n ```","ref":"Lightning.WebhookAuthMethods.html#create_changeset/2-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"Deletes a given `WebhookAuthMethod` from the database.\n\nThe function takes a `WebhookAuthMethod` struct and runs to delete it. If the deletion is successful, it returns an `:ok` tuple with the deleted `WebhookAuthMethod` struct. If the deletion fails due to a constraint, such as a foreign key reference, it returns an error tuple.","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"- `auth_method`: The `WebhookAuthMethod` struct to delete.","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"- `{:ok, struct}`: A tuple containing `:ok` and the deleted `WebhookAuthMethod` struct if the deletion succeeds.\n - `{:error, reason}`: A tuple containing `:error` and the reason for failure if the deletion fails.","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"- Successful deletion:\n\n ```elixir\n iex> delete_auth_method(%WebhookAuthMethod{id: \"some_id\"})\n {:ok, %WebhookAuthMethod{}}\n ```\n\n - Deletion fails due to the item not existing or other conflict:\n\n ```elixir\n iex> delete_auth_method(%WebhookAuthMethod{id: \"non_existing_id\"})\n {:error, reason}\n ```","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1-examples"},{"type":"function","title":"Notes - Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"- It is important to ensure that the `WebhookAuthMethod` is not being referenced by other entities before trying deletion to avoid conflicts.\n - This function will return an error tuple if the `WebhookAuthMethod` struct passed to it does not exist in the database.","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1-notes"},{"type":"function","title":"Lightning.WebhookAuthMethods.find_by_api_key/2","doc":"Retrieves a `WebhookAuthMethod` that matches the given API key for a specified project.\n\nIt uses a secure comparison to match the API key, ensuring that timing attacks are mitigated.","ref":"Lightning.WebhookAuthMethods.html#find_by_api_key/2"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.find_by_api_key/2","doc":"- `api_key`: The API key as a binary string to match against existing `WebhookAuthMethod` records.\n - `project`: The `Project` struct to scope the search within its associated `WebhookAuthMethod`s.","ref":"Lightning.WebhookAuthMethods.html#find_by_api_key/2-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.find_by_api_key/2","doc":"- A `WebhookAuthMethod` struct if a matching API key is found within the given project's scope.\n - `nil` if there is no `WebhookAuthMethod` with the given API key for the project.","ref":"Lightning.WebhookAuthMethods.html#find_by_api_key/2-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.find_by_api_key/2","doc":"- When a matching `WebhookAuthMethod` is found:\n\n ```elixir\n iex> Lightning.Workflows.find_by_api_key(\"existing_api_key\", %Project{id: \"existing_project_id\"})\n %WebhookAuthMethod{}\n ```\n\n - When there is no matching `WebhookAuthMethod`:\n\n ```elixir\n iex> Lightning.Workflows.find_by_api_key(\"non_existing_api_key\", %Project{id: \"existing_project_id\"})\n nil\n ```","ref":"Lightning.WebhookAuthMethods.html#find_by_api_key/2-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.find_by_id!/1","doc":"Retrieves a `WebhookAuthMethod` by its ID, raising an exception if not found.\n\nThis function is intended for situations where the `WebhookAuthMethod` is expected to exist, and not finding one is an exceptional case that should halt normal flow with an error.","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1"},{"type":"function","title":"Parameter - Lightning.WebhookAuthMethods.find_by_id!/1","doc":"- `id`: The ID of the `WebhookAuthMethod` to retrieve.","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1-parameter"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.find_by_id!/1","doc":"- Returns the `WebhookAuthMethod` struct if found.","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1-returns"},{"type":"function","title":"Errors - Lightning.WebhookAuthMethods.find_by_id!/1","doc":"- Raises `Ecto.NoResultsError` if there is no `WebhookAuthMethod` with the given ID.","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1-errors"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.find_by_id!/1","doc":"- When a `WebhookAuthMethod` with the given ID exists:\n\n ```elixir\n iex> Lightning.Workflows.find_by_id!(\"existing_id\")\n %WebhookAuthMethod{}\n ```\n\n - When there is no `WebhookAuthMethod` with the given ID:\n\n ```elixir\n iex> Lightning.Workflows.find_by_id!(\"non_existing_id\")\n ** (Ecto.NoResultsError)\n ```","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.find_by_username_and_password/3","doc":"Retrieves a `WebhookAuthMethod` that matches the given username and password within the scope of a specified project.\n\nThe function checks if the provided password is correct for the given username and project. If the password is valid, the corresponding `WebhookAuthMethod` is returned. It is important to handle password comparison securely to prevent timing attacks.","ref":"Lightning.WebhookAuthMethods.html#find_by_username_and_password/3"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.find_by_username_and_password/3","doc":"- `username`: The username as a string to match against the `WebhookAuthMethod` records.\n - `password`: The plaintext password as a string which will be securely compared to the stored password.\n - `project`: The `Project` struct to scope the search for the `WebhookAuthMethod`.","ref":"Lightning.WebhookAuthMethods.html#find_by_username_and_password/3-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.find_by_username_and_password/3","doc":"- Returns the matching `WebhookAuthMethod` struct if the username and password are correct within the given project's scope.\n - Returns `nil` if no matching record is found or if the password is invalid.","ref":"Lightning.WebhookAuthMethods.html#find_by_username_and_password/3-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.find_by_username_and_password/3","doc":"- When a matching `WebhookAuthMethod` is found and the password is valid:\n\n ```elixir\n iex> Lightning.Workflows.find_by_username_and_password(\"existing_username\", \"valid_password\", %Project{id: \"existing_project_id\"})\n %WebhookAuthMethod{}\n ```\n\n - When the username is found but the password is invalid or no matching record is found:\n\n ```elixir\n iex> Lightning.Workflows.find_by_username_and_password(\"existing_username\", \"invalid_password\", %Project{id: \"existing_project_id\"})\n nil\n ```","ref":"Lightning.WebhookAuthMethods.html#find_by_username_and_password/3-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.list_for_project/1","doc":"Retrieves a list of `WebhookAuthMethod`s associated with a specific `Project`.\n\nThe function filters `WebhookAuthMethod`s by the provided `Project`'s ID and excludes any methods that are scheduled for deletion.","ref":"Lightning.WebhookAuthMethods.html#list_for_project/1"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.list_for_project/1","doc":"- `project`: The `Project` struct containing the ID of the project for which to list the authentication methods.","ref":"Lightning.WebhookAuthMethods.html#list_for_project/1-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.list_for_project/1","doc":"- A list of `WebhookAuthMethod` structs. This can be an empty list if no methods are associated with the project or if the project does not exist.","ref":"Lightning.WebhookAuthMethods.html#list_for_project/1-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.list_for_project/1","doc":"- When the project exists and has associated auth methods:\n\n ```elixir\n iex> list_for_project(%Project{id: \"existing_project_id\"})\n [%WebhookAuthMethod{}, ...]\n ```\n\n - When the project does not exist or has no associated auth methods:\n\n ```elixir\n iex> list_for_project(%Project{id: \"non_existing_project_id\"})\n []\n ```","ref":"Lightning.WebhookAuthMethods.html#list_for_project/1-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.list_for_trigger/1","doc":"Retrieves a list of `WebhookAuthMethod`s associated with the specified `Trigger`.\n\nThis function filters out `WebhookAuthMethod`s that are scheduled for deletion, ensuring that only active methods are returned.","ref":"Lightning.WebhookAuthMethods.html#list_for_trigger/1"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.list_for_trigger/1","doc":"- `trigger`: A `Trigger` struct whose associated `WebhookAuthMethod`s are to be retrieved.","ref":"Lightning.WebhookAuthMethods.html#list_for_trigger/1-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.list_for_trigger/1","doc":"- A list of `WebhookAuthMethod` structs associated with the `Trigger`. If the `Trigger` has no associated methods or if they are all scheduled for deletion, the list will be empty.","ref":"Lightning.WebhookAuthMethods.html#list_for_trigger/1-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.list_for_trigger/1","doc":"- When the `Trigger` has associated `WebhookAuthMethod`s not scheduled for deletion:\n\n ```elixir\n iex> Lightning.Workflows.list_for_trigger(%Trigger{id: \"existing_trigger_id\"})\n [%WebhookAuthMethod{}, ...]\n ```\n\n - When the `Trigger` has no associated `WebhookAuthMethod`s or they are all scheduled for deletion:\n\n ```elixir\n iex> Lightning.Workflows.list_for_trigger(%Trigger{id: \"trigger_without_methods\"})\n []\n ```","ref":"Lightning.WebhookAuthMethods.html#list_for_trigger/1-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.perform/1","doc":"Performs cleanup of `WebhookAuthMethod` records that are marked for permanent deletion.","ref":"Lightning.WebhookAuthMethods.html#perform/1"},{"type":"function","title":"Details - Lightning.WebhookAuthMethods.perform/1","doc":"This function, when invoked with a job argument containing `%{\"type\" => \"purge_deleted\"}`, performs the following operations:\n\n1. It queries all `WebhookAuthMethod` records that are scheduled for deletion (i.e., their `scheduled_deletion` timestamp is in the past).\n2. It then disassociates each of these records from any associated triggers.\n3. Finally, it deletes the `WebhookAuthMethod` records from the database.\n\nThe function operates within the context of an Oban job, utilizing the `perform/1` callback expected by the Oban.Worker behaviour.","ref":"Lightning.WebhookAuthMethods.html#perform/1-details"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.perform/1","doc":"- A `%Oban.Job{args: %{\"type\" => \"purge_deleted\"}}` struct, indicating the job should perform a purge operation.","ref":"Lightning.WebhookAuthMethods.html#perform/1-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.perform/1","doc":"A tuple `{:ok, %{disassociated_count: integer(), deleted_count: integer()}}` where:\n- `:ok` indicates the operation was successful.\n- `disassociated_count` is the number of `WebhookAuthMethod` records successfully disassociated from triggers.\n- `deleted_count` is the number of `WebhookAuthMethod` records successfully deleted.","ref":"Lightning.WebhookAuthMethods.html#perform/1-returns"},{"type":"function","title":"Example - Lightning.WebhookAuthMethods.perform/1","doc":"```elixir\n%Oban.Job{\nargs: %{\"type\" => \"purge_deleted\"}\n}\n|> MyModule.perform()\n# => {:ok, %{disassociated_count: 2, deleted_count: 2}}\n```","ref":"Lightning.WebhookAuthMethods.html#perform/1-example"},{"type":"function","title":"Lightning.WebhookAuthMethods.schedule_for_deletion/2","doc":"Schedules a `WebhookAuthMethod` for deletion by setting its `scheduled_deletion` date.\n\nThis function does not delete the record immediately. Instead, it sets the `scheduled_deletion` field to a date in the future as defined by the application's environment settings.\nThe default behavior, in the absence of environment configuration, is to schedule the deletion for the current date and time, effectively marking it for immediate deletion.\n\nThe scheduled deletion date is determined by the `:purge_deleted_after_days` configuration in the application environment.\nIf this configuration is not present, the function defaults to 0 days, which schedules the deletion for the current date and time.","ref":"Lightning.WebhookAuthMethods.html#schedule_for_deletion/2"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.schedule_for_deletion/2","doc":"- `webhook_auth_method`: A `WebhookAuthMethod` struct that is to be scheduled for deletion.","ref":"Lightning.WebhookAuthMethods.html#schedule_for_deletion/2-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.schedule_for_deletion/2","doc":"- `{:ok, webhook_auth_method}`: Returns an `:ok` tuple with the updated webhook auth method struct if the\n update was successful.\n - `{:error, changeset}`: Returns an `:error` tuple with the changeset if the update failed.","ref":"Lightning.WebhookAuthMethods.html#schedule_for_deletion/2-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.schedule_for_deletion/2","doc":"- When a webhook auth method is successfully scheduled for deletion:\n\n ```elixir\n iex> Lightning.Workflows.schedule_for_deletion(%WebhookAuthMethod{id: some_id})\n {:ok, %WebhookAuthMethod{scheduled_deletion: deletion_date}}\n ```\n\n - When scheduling for deletion fails due to validation errors:\n\n ```elixir\n iex> Lightning.Workflows.schedule_for_deletion(%WebhookAuthMethod{})\n {:error, %Ecto.Changeset{}}\n ```","ref":"Lightning.WebhookAuthMethods.html#schedule_for_deletion/2-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.update_auth_method/3","doc":"Updates an existing `WebhookAuthMethod` with the provided attributes and creates an audit event.\n\nThis function applies the given changes to the specified `WebhookAuthMethod` and records the update action in the audit log. It wraps the operations within a database transaction to ensure data integrity.","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.update_auth_method/3","doc":"- `webhook_auth_method`: The `WebhookAuthMethod` struct to be updated.\n - `attrs`: A map containing the updated values for the fields of the `WebhookAuthMethod`.\n - `actor`: The user performing the update, represented by a `%User{}` struct.","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.update_auth_method/3","doc":"- `{:ok, %WebhookAuthMethod{}}`: A tuple containing `:ok` and the updated `WebhookAuthMethod` struct if the update is successful.\n - `{:error, %Ecto.Changeset{}}`: A tuple containing `:error` and the changeset with errors if the update fails.","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.update_auth_method/3","doc":"- Successful update:\n\n ```elixir\n iex> update_auth_method(webhook_auth_method, %{field: new_value}, actor: %User{})\n {:ok, %WebhookAuthMethod{}}\n ```\n\n - Update fails due to invalid data:\n\n ```elixir\n iex> update_auth_method(webhook_auth_method, %{field: bad_value}, actor: %User{})\n {:error, %Ecto.Changeset{}}\n ```","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3-examples"},{"type":"function","title":"Notes - Lightning.WebhookAuthMethods.update_auth_method/3","doc":"- The function uses `Ecto.Multi` to perform a transaction, ensuring that either all changes apply successfully, or none do if there's an error.\n - An audit event is recorded with the `Lightning.WebhookAuthMethodAudit.event/4` function, capturing the details of the update and the acting user.","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3-notes"},{"type":"function","title":"Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"Updates the association of `WebhookAuthMethod`s for a given `Trigger` and logs the changes as audit events.\n\nThis function replaces the current `WebhookAuthMethod` associations of a `Trigger` with the provided list of `WebhookAuthMethod`s. It creates audit events for each added and removed `WebhookAuthMethod`, ensuring full traceability of changes.","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"- `trigger`: The `Trigger` struct whose associated `WebhookAuthMethod`s are to be updated.\n - `auth_methods`: A list of `WebhookAuthMethod` structs to be associated with the `Trigger`.\n - `actor`: The user performing the update, represented by a `%User{}` struct.","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"- `{:ok, %Trigger{}}`: A tuple containing `:ok` and the updated `Trigger` struct if the associations are updated successfully.\n - `{:error, %Ecto.Changeset{}}`: A tuple containing `:error` and the changeset with errors if the update fails.","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"- Successful association update:\n\n ```elixir\n iex> update_trigger_auth_methods(trigger, [webhook_auth_method], actor: %User{})\n {:ok, %Trigger{}}\n ```\n\n - Update fails due to an invalid changeset:\n\n ```elixir\n iex> update_trigger_auth_methods(trigger, [invalid_webhook_auth_method], actor: %User{})\n {:error, %Ecto.Changeset{}}\n ```","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3-examples"},{"type":"function","title":"Notes - Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"- The function uses `Ecto.Multi` to perform a transaction, which ensures either all changes are applied or none at all if an error occurs.\n - Audit events for the additions and removals of `WebhookAuthMethod`s are recorded using `WebhookAuthMethodAudit.event/4`.\n - The function preloads the existing `webhook_auth_methods` of the `Trigger` before performing updates.","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3-notes"},{"type":"module","title":"Lightning.WorkOrder","doc":"Ecto model for WorkOrders.","ref":"Lightning.WorkOrder.html"},{"type":"function","title":"Lightning.WorkOrder.validate/1","doc":"","ref":"Lightning.WorkOrder.html#validate/1"},{"type":"type","title":"Lightning.WorkOrder.t/0","doc":"","ref":"Lightning.WorkOrder.html#t:t/0"},{"type":"module","title":"Lightning.Workers","doc":"Lightning uses external worker processes to execute workflow jobs.\n\nThis module deals with the security tokens and the formatting used on\nthe communication with the workers.","ref":"Lightning.Workers.html"},{"type":"function","title":"Lightning.Workers.generate_run_token/2","doc":"","ref":"Lightning.Workers.html#generate_run_token/2"},{"type":"function","title":"Lightning.Workers.verify_run_token/2","doc":"Verifies and validates a run token.\n\nIt requires a context map with the following keys:\n\n- `:id` - the run id that the token was issued with.\n\nOptionally takes a context map that will be passed to the validation:\n\n- `:current_time` - the current time as a `DateTime` struct.","ref":"Lightning.Workers.html#verify_run_token/2"},{"type":"function","title":"Lightning.Workers.verify_worker_token/2","doc":"Verifies and validates a worker token.\n\nOptionally takes a context map that will be passed to the validation:\n\n- `:current_time` - the current time as a `DateTime` struct.","ref":"Lightning.Workers.html#verify_worker_token/2"},{"type":"module","title":"Lightning.Workers.RunToken","doc":"JWT token configuration to verify if workers work is legit.","ref":"Lightning.Workers.RunToken.html"},{"type":"function","title":"Lightning.Workers.RunToken.generate_and_sign/2","doc":"Combines `generate_claims/1` and `encode_and_sign/2`","ref":"Lightning.Workers.RunToken.html#generate_and_sign/2"},{"type":"function","title":"Lightning.Workers.RunToken.generate_and_sign!/2","doc":"Same as `generate_and_sign/2` but raises if error","ref":"Lightning.Workers.RunToken.html#generate_and_sign!/2"},{"type":"function","title":"Lightning.Workers.RunToken.verify_and_validate/3","doc":"Combines `verify/2` and `validate/2`","ref":"Lightning.Workers.RunToken.html#verify_and_validate/3"},{"type":"function","title":"Lightning.Workers.RunToken.verify_and_validate!/3","doc":"Same as `verify_and_validate/2` but raises if error","ref":"Lightning.Workers.RunToken.html#verify_and_validate!/3"},{"type":"module","title":"Lightning.Workers.WorkerToken","doc":"JWT token configuration to authenticate workers.","ref":"Lightning.Workers.WorkerToken.html"},{"type":"function","title":"Lightning.Workers.WorkerToken.generate_and_sign/2","doc":"Combines `generate_claims/1` and `encode_and_sign/2`","ref":"Lightning.Workers.WorkerToken.html#generate_and_sign/2"},{"type":"function","title":"Lightning.Workers.WorkerToken.generate_and_sign!/2","doc":"Same as `generate_and_sign/2` but raises if error","ref":"Lightning.Workers.WorkerToken.html#generate_and_sign!/2"},{"type":"function","title":"Lightning.Workers.WorkerToken.verify_and_validate/3","doc":"Combines `verify/2` and `validate/2`","ref":"Lightning.Workers.WorkerToken.html#verify_and_validate/3"},{"type":"function","title":"Lightning.Workers.WorkerToken.verify_and_validate!/3","doc":"Same as `verify_and_validate/2` but raises if error","ref":"Lightning.Workers.WorkerToken.html#verify_and_validate!/3"},{"type":"task","title":"mix lightning.gen_encryption_key","doc":"Helper to generate a unique encryption key for Vault","ref":"Mix.Tasks.Lightning.GenEncryptionKey.html"},{"type":"task","title":"mix lightning.gen_worker_keys","doc":"Helper to generate the private and public keys for worker authentication","ref":"Mix.Tasks.Lightning.GenWorkerKeys.html"},{"type":"task","title":"mix lightning.install_adaptor_icons","doc":"Installs the adaptor icons","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.get/3","doc":"Perform a GET request.\n\nSee `request/1` or `request/2` for options definition.\n\n get(\"/users\")\n get(\"/users\", query: [scope: \"admin\"])\n get(client, \"/users\")\n get(client, \"/users\", query: [scope: \"admin\"])\n get(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#get/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.get!/3","doc":"Perform a GET request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n get!(\"/users\")\n get!(\"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\")\n get!(client, \"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#get!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.head/3","doc":"Perform a HEAD request.\n\nSee `request/1` or `request/2` for options definition.\n\n head(\"/users\")\n head(\"/users\", query: [scope: \"admin\"])\n head(client, \"/users\")\n head(client, \"/users\", query: [scope: \"admin\"])\n head(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#head/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.head!/3","doc":"Perform a HEAD request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n head!(\"/users\")\n head!(\"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\")\n head!(client, \"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#head!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.options/3","doc":"Perform a OPTIONS request.\n\nSee `request/1` or `request/2` for options definition.\n\n options(\"/users\")\n options(\"/users\", query: [scope: \"admin\"])\n options(client, \"/users\")\n options(client, \"/users\", query: [scope: \"admin\"])\n options(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#options/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.options!/3","doc":"Perform a OPTIONS request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n options!(\"/users\")\n options!(\"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\")\n options!(client, \"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#options!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.patch/4","doc":"Perform a PATCH request.\n\nSee `request/1` or `request/2` for options definition.\n\n patch(\"/users\", %{name: \"Jon\"})\n patch(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch(client, \"/users\", %{name: \"Jon\"})\n patch(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#patch/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.patch!/4","doc":"Perform a PATCH request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n patch!(\"/users\", %{name: \"Jon\"})\n patch!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch!(client, \"/users\", %{name: \"Jon\"})\n patch!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#patch!/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.request/2","doc":"Perform a request.","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#request/2"},{"type":"function","title":"Options - Mix.Tasks.Lightning.InstallAdaptorIcons.request/2","doc":"- `:method` - the request method, one of [`:head`, `:get`, `:delete`, `:trace`, `:options`, `:post`, `:put`, `:patch`]\n- `:url` - either full url e.g. \"http://example.com/some/path\" or just \"/some/path\" if using `Tesla.Middleware.BaseUrl`\n- `:query` - a keyword list of query params, e.g. `[page: 1, per_page: 100]`\n- `:headers` - a keyword list of headers, e.g. `[{\"content-type\", \"text/plain\"}]`\n- `:body` - depends on used middleware:\n - by default it can be a binary\n - if using e.g. JSON encoding middleware it can be a nested map\n - if adapter supports it it can be a Stream with any of the above\n- `:opts` - custom, per-request middleware or adapter options","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#request/2-options"},{"type":"function","title":"Examples - Mix.Tasks.Lightning.InstallAdaptorIcons.request/2","doc":"ExampleApi.request(method: :get, url: \"/users/path\")\n\n # use shortcut methods\n ExampleApi.get(\"/users/1\")\n ExampleApi.post(client, \"/users\", %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#request/2-examples"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.request!/2","doc":"Perform request and raise in case of error.\n\nThis is similar to `request/2` behaviour from Tesla 0.x\n\nSee `request/2` for list of available options.","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#request!/2"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.trace/3","doc":"Perform a TRACE request.\n\nSee `request/1` or `request/2` for options definition.\n\n trace(\"/users\")\n trace(\"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\")\n trace(client, \"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#trace/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.trace!/3","doc":"Perform a TRACE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n trace!(\"/users\")\n trace!(\"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\")\n trace!(client, \"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#trace!/3"},{"type":"type","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.option/0","doc":"Options that may be passed to a request function. See `request/2` for detailed descriptions.","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#t:option/0"},{"type":"task","title":"mix lightning.install_runtime","doc":"Installs the following NodeJS packages:\n\n- core\n- language-common","ref":"Mix.Tasks.Lightning.InstallRuntime.html"},{"type":"function","title":"Mix.Tasks.Lightning.InstallRuntime.packages/0","doc":"","ref":"Mix.Tasks.Lightning.InstallRuntime.html#packages/0"},{"type":"function","title":"Mix.Tasks.Lightning.InstallRuntime.run/1","doc":"","ref":"Mix.Tasks.Lightning.InstallRuntime.html#run/1"},{"type":"task","title":"mix lightning.install_schemas","doc":"Install the credential json schemas\nUse --exclude language-package1, language-package2 to exclude specific packages","ref":"Mix.Tasks.Lightning.InstallSchemas.html"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.delete/3","doc":"Issues a DELETE request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#delete/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.delete!/3","doc":"Issues a DELETE request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#delete!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.fetch_schemas/2","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#fetch_schemas/2"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.get/3","doc":"Issues a GET request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#get/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.get!/3","doc":"Issues a GET request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#get!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.head/3","doc":"Issues a HEAD request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#head/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.head!/3","doc":"Issues a HEAD request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#head!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.options/3","doc":"Issues an OPTIONS request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#options/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.options!/3","doc":"Issues a OPTIONS request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#options!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.parse_excluded/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#parse_excluded/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.patch/4","doc":"Issues a PATCH request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#patch/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.patch!/4","doc":"Issues a PATCH request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#patch!/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.persist_schema/2","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#persist_schema/2"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.post/4","doc":"Issues a POST request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#post/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.post!/4","doc":"Issues a POST request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#post!/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_headers/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_headers/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_body/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_body/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_headers/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_headers/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_options/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_options/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_params/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_params/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_url/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_url/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response_body/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response_body/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response_chunk/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response_chunk/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response_headers/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response_headers/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response_status_code/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response_status_code/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_status_code/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_status_code/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_url/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_url/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.put/4","doc":"Issues a PUT request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#put/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.put!/4","doc":"Issues a PUT request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#put!/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.request/1","doc":"Issues an HTTP request using an `HTTPoison.Request` struct.\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/1"},{"type":"function","title":"Redirect handling - Mix.Tasks.Lightning.InstallSchemas.request/1","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/1-redirect-handling"},{"type":"function","title":"Examples - Mix.Tasks.Lightning.InstallSchemas.request/1","doc":"request = %HTTPoison.Request{\n method: :post,\n url: \"https://my.website.com\",\n body: \"{\\\"foo\\\": 3}\",\n headers: [{\"Accept\", \"application/json\"}]\n }\n\n request(request)","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/1-examples"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.request/5","doc":"Issues an HTTP request with the given method to the given url.\n\nThis function is usually used indirectly by `get/3`, `post/4`, `put/4`, etc\n\nArgs:\n * `method` - HTTP method as an atom (`:get`, `:head`, `:post`, `:put`,\n `:delete`, etc.)\n * `url` - target url as a binary string or char list\n * `body` - request body. See more below\n * `headers` - HTTP headers as an orddict (e.g., `[{\"Accept\", \"application/json\"}]`)\n * `options` - Keyword list of options\n\nBody: see type `HTTPoison.Request`\n\nOptions: see type `HTTPoison.Request`\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/5"},{"type":"function","title":"Redirect handling - Mix.Tasks.Lightning.InstallSchemas.request/5","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/5-redirect-handling"},{"type":"function","title":"Examples - Mix.Tasks.Lightning.InstallSchemas.request/5","doc":"request(:post, \"https://my.website.com\", \"{\\\"foo\\\": 3}\", [{\"Accept\", \"application/json\"}])","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/5-examples"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.request!/1","doc":"Issues an HTTP request an `HTTPoison.Request` struct.\nexception in case of failure.\n\n`request!/1` works exactly like `request/1` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request!/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.request!/5","doc":"Issues an HTTP request with the given method to the given url, raising an\nexception in case of failure.\n\n`request!/5` works exactly like `request/5` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request!/5"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.run/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#run/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.start/0","doc":"Starts HTTPoison and its dependencies.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#start/0"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.stream_next/1","doc":"Requests the next message to be streamed for a given `HTTPoison.AsyncResponse`.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#stream_next/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.write_schema/3","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#write_schema/3"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.body/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:body/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.headers/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:headers/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.method/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:method/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.options/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:options/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.params/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:params/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.request/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:request/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.url/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:url/0"},{"type":"extras","title":"Lightning","doc":"# OpenFn/Lightning [![CircleCI](https://dl.circleci.com/status-badge/img/gh/OpenFn/lightning/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/OpenFn/lightning/tree/main) [![codecov](https://codecov.io/gh/OpenFn/lightning/branch/main/graph/badge.svg?token=FfDMxdGL3a)](https://codecov.io/gh/OpenFn/lightning) ![Docker Pulls](https://img.shields.io/docker/pulls/openfn/lightning)\n\nLightning ⚡ (aka \"OpenFn v2\") is a workflow automation platform that's used to\nautomate critical business processes and integrate information systems. From\nlast-mile services to national-level reporting, it boosts efficiency &\neffectiveness while enabling secure, stable, scalable interoperability and data\nintegration at all levels.\n\n**Use it online at [app.openfn.org](https://app.openfn.org)**\n\n**Explore in a sandbox on [demo.openfn.org](#demo-sandbox)**\n\n**Or learn more at\n[docs.openfn.org](https://docs.openfn.org/documentation/about-lightning)**\n\n> OpenFn **Lightning** is:\n>\n> - the **latest version** of OpenFn: first launched in 2014, it's been tried\n> and tested by NGOs and governments in 40+ countries\n> - fully **open source**: there's no \"community edition\" and \"premium edition\",\n> you get the same product whether you are self-hosting or using the\n> OpenFn.org software-as-a-service\n> - the leading [DPGA](https://digitalpublicgoods.net/) certified **Digital\n> Public Good** for workflow automation\n> - a [Digital Square](https://digitalsquare.org/digital-health-global-goods)\n> certified **Global Good for Health**","ref":"readme.html"},{"type":"extras","title":"Contents - Lightning","doc":"- [Demo](#demo)\n- [Features](#features)\n - [Build](#build)\n - [Monitor](#monitor)\n - [Manage](#manage)\n - [Roles and permissions](#roles-and-permissions)\n - [Roadmap](#roadmap)\n- [Getting Started](#getting-started)\n - [**Run** via Docker](#run-via-docker)\n - [**Deploy** on external infrastructure](#deploy-on-external-infrastructure)\n - [**Dev** on Lightning locally](#dev-on-lightning-locally)\n- [Security and Standards](#security-and-standards)\n- [**Contribute** to this project](#contribute-to-this-project)\n - [Pick up an issue](#pick-up-an-issue)\n - [Open a pull request](#open-a-pull-request)\n - [Generate the docs pages](#generate-the-docs-pages)\n- [Server Specs for Self-Hosting](#server-specs-for-self-hosting)\n- [Benchmarking](#benchmarking)\n- [Troubleshooting](#troubleshooting)\n - [Problems with environment variables](#problems-with-environment-variables)\n - [Problems with Postgres](#problems-with-postgres)\n - [Problems with Debian](#problems-with-debian)\n - [Problems with Docker](#problems-with-docker)\n - [Problems with Rambo](#problems-with-rambo)\n- [Support](#support)","ref":"readme.html#contents"},{"type":"extras","title":"Demo - Lightning","doc":"Watch a short [demo video](https://www.youtube.com/watch?v=BNaxlHAWb5I) or\nexplore a **[public sandbox](https://demo.openfn.org/)** with the login details\nbelow, but please note that this deployment is reset every night at 12:00:00 UTC\nand is 100% publicly accessible. **_Don't build anything you want to keep, or\nkeep private!_**\n\n```\nusername: demo@openfn.org\npassword: welcome12345\n```","ref":"readme.html#demo"},{"type":"extras","title":"Features - Lightning","doc":"","ref":"readme.html#features"},{"type":"extras","title":"Build - Lightning","doc":"Plan and build workflows using Lightning's visual interface to quickly define\nwhen, where and what you want your automation to do.\n\n \n \n \n\nUse our\n[CLI](https://github.com/OpenFn/kit/blob/main/packages/cli/README.md#openfncli)\nto quickly build, edit and deploy projects from the comfort of your own code\neditor.","ref":"readme.html#build"},{"type":"extras","title":"Monitor - Lightning","doc":"Monitor all workflow activity in one place.\n\n \n \n \n\n- Filter and search runs to identify issues that need addressing and follow how\n a specific request has been processed\n- Configure alerts to be notified on run failures\n- Receive a project digest for a daily/weekly/monthly summary of your project\n activity","ref":"readme.html#monitor"},{"type":"extras","title":"Manage - Lightning","doc":"Manage users and access by project.","ref":"readme.html#manage"},{"type":"extras","title":"Roles and permissions - Lightning","doc":"Authorization is a central part of Lightning. As such, users are given different\nroles which determine what level of access they have for resources in the\napplication. For more details about roles and permissions in Lightning, please\nrefer to our\n[documentation](https://docs.openfn.org/documentation/about-lightning#roles-and-permissions).","ref":"readme.html#roles-and-permissions"},{"type":"extras","title":"Roadmap - Lightning","doc":"View our\n[public GitHub project](https://github.com/orgs/OpenFn/projects/3/views/1) to\nsee what we're working on now and what's coming next.","ref":"readme.html#roadmap"},{"type":"extras","title":"Getting Started - Lightning","doc":"- If you only want to [_**RUN**_](#run-via-docker) Lightning on your own server,\n we recommend using Docker.\n- If you want to [_**DEPLOY**_](#deploy-on-external-infrastructure) Lightning,\n we recommend Docker builds and Kubernetes.\n- If you want to [_**CONTRIBUTE**_](#contribute-to-this-project) to the project,\n we recommend\n [running Lightning on your local machine](#run-lightning-locally).\n\n### **Run** via Docker\n\n1. Install the latest version of\n [Docker](https://docs.docker.com/engine/install/)\n2. Clone [this repo](https://github.com/OpenFn/Lightning) using git\n3. Setup PostgreSQL database with:\n `docker compose build && docker compose run --rm web mix ecto.migrate`\n4. Run Lightning and PostgresSQL with: `docker compose up`\n\nBy default the application will be running at\n[localhost:4000](http://localhost:4000/).\n\nSee [\"Problems with Docker\"](#problems-with-docker) for additional\ntroubleshooting help. Note that you can also create your own\n`docker-compose.yml` file, configuring a postgres database and using a\n[pre-built image](https://hub.docker.com/repository/docker/openfn/lightning)\nfrom Dockerhub.\n\n### **Deploy** on external infrastructure\n\nHead to the [Deploy](https://docs.openfn.org/documentation/deploy/options)\nsection of our docs site to get started.\n\nFor technical guidelines, see [deployment considerations](DEPLOYMENT.md) for\nmore detailed information.\n\n### **Dev** on Lightning locally\n\n#### Clone the repo and optionally set ENVs\n\n```sh\ngit clone git@github.com:OpenFn/Lightning.git # or from YOUR fork!\ncd Lightning\ncp .env.example .env # and adjust as necessary!\n```\n\nTake note of database names and ports in particular—they've got to match across\nyour Postgres setup and your ENVs. You can run lightning without any ENVs\nassuming a vanilla postgres setup (see below), but you may want to make\nadjustments.\n\n#### Database Setup\n\nIf you're already using Postgres locally, create a new database called\n`lightning_dev`, for example.\n\nIf you'd rather use Docker to set up a Postgres DB, create a new volume and\nimage:\n\n```sh\ndocker volume create lightning-postgres-data\n\ndocker create \\\n --name lightning-postgres \\\n --mount source=lightning-postgres-data,target=/var/lib/postgresql/data \\\n --publish 5432:5432 \\\n -e POSTGRES_PASSWORD=postgres \\\n postgres:15.3-alpine\n\ndocker start lightning-postgres\n```\n\n#### Elixir & Ecto Setup\n\nWe use [asdf](https://github.com/asdf-vm/asdf) to configure our local\nenvironments. Included in the repo is a `.tool-versions` file that is read by\nasdf in order to dynamically make the specified versions of Elixir and Erlang\navailable. You'll need asdf plugins for\n[Erlang](https://github.com/asdf-vm/asdf-erlang),\n[NodeJs](https://github.com/asdf-vm/asdf-nodejs)\n[Elixir](https://github.com/asdf-vm/asdf-elixir) and\n[k6](https://github.com/grimoh/asdf-k6).\n\nWe use [libsodium](https://doc.libsodium.org/) for encoding values as required\nby the\n[Github API](https://docs.github.com/en/rest/guides/encrypting-secrets-for-the-rest-api).\nYou'll need to install `libsodium` in order for the application to compile.\n\nFor Mac Users:\n\n```sh\nbrew install libsodium\n```\n\nFor Debian Users:\n\n```sh\nsudo apt-get install libsodium-dev\n```\n\nYou can find more on\n[how to install libsodium here](https://doc.libsodium.org/installation)\n\n```sh\nasdf install # Install language versions\n./bin/bootstrap\n```\n\n#### Run the app\n\nLightning is a web app. To run it in interactive Elixir mode, start the\ndevelopment server by running with your environment variables by running:\n\n```sh\niex -S mix phx.server\n```\n\nor if you have set up custom environment variables, run:\n\n```sh\nenv $(cat .env | grep -v \"#\" | xargs ) iex -S mix phx.server\n```\n\nOnce the server has started, head to [`localhost:4000`](http://localhost:4000)\nin your browser.\n\n#### Run the tests\n\nBefore the first time running the tests, you need a test database setup.\n\n```sh\nMIX_ENV=test mix ecto.create\n```\n\nAnd then after that run the tests using:\n\n```sh\nMIX_ENV=test mix test\n```\n\nWe also have `test.watch` installed which can be used to rerun the tests on file\nchanges.","ref":"readme.html#getting-started"},{"type":"extras","title":"Security and Standards - Lightning","doc":"We use a host of common Elixir static analysis tools to help us avoid common\npitfalls and make sure we keep everything clean and consistent.\n\nIn addition to our test suite, you can run the following commands:\n\n- `mix format --check-formatted` Code formatting checker, run again without the\n `--check-formatted` flag to have your code automatically changed.\n- `mix dialyzer` Static analysis for type mismatches and other common warnings.\n See [dialyxir](https://github.com/jeremyjh/dialyxir).\n- `mix credo --strict --all` Static analysis for consistency, and coding\n standards. See [Credo](https://github.com/rrrene/credo).\n- `mix sobelow` Check for commonly known security exploits. See\n [Sobelow](https://sobelow.io/).\n- `MIX_ENV=test mix coveralls` Test coverage reporter. This command also runs\n the test suite, and can be used in place of `mix test` when checking\n everything before pushing your code. See\n [excoveralls](https://github.com/parroty/excoveralls).\n\n> For convenience there is a `verify` mix task that runs all of the above and\n> defaults the `MIX_ENV` to `test`.\n\nFor more guidance on security best practices for workflow automation\nimplementations, check out OpenFn Docs:\n[docs.openfn.org/documentation/getting-started/security](https://docs.openfn.org/documentation/getting-started/security)\n\n## **Contribute** to this project\n\nFirst, thanks for being here! You're contributing to a digital public good that\nwill always be free and open source and aimed at serving innovative NGOs,\ngovernments, and social impact organizations the world over! You rock. ❤️\n\nFYI, Lightning is built in [Elixir](https://elixir-lang.org/), harnessing the\n[Phoenix Framework](https://www.phoenixframework.org/). Currently, the only\nunbundled dependency is a [PostgreSQL](https://www.postgresql.org/) database.\n\nIf you'd like to contribute to this projects, follow the steps below:","ref":"readme.html#security-and-standards"},{"type":"extras","title":"Pick up an issue - Lightning","doc":"Read through the existing [issues](https://github.com/OpenFn/Lightning/issues),\nassign yourself to the issue you have chosen. Leave a comment on the issue to\nlet us know you'll be working on it, and if you have any questions of\nclarifications that would help you get started ask them there - we will get back\nto you as soon as possible.\n\nIf there isn't already an issue for the feature you would like to contribute,\nplease start a discussion in our\n[community forum](https://community.openfn.org/c/feature-requests/12).","ref":"readme.html#pick-up-an-issue"},{"type":"extras","title":"Open a pull request - Lightning","doc":"1. Clone the Lightning repository, then\n [fork it](https://docs.github.com/en/get-started/quickstart/fork-a-repo).\n\n2. Run through [setting up your environment](#set-up-your-environment) and make\n your changes.\n\n3. Make sure you have written your tests and updated /CHANGELOG.md (in the\n 'Unreleased' section, add a short description of the changes you are making,\n along with a link to your issue).\n\n4. Open a draft pull request by clicking \"Contribute > Open Pull Request\" from\n your forked repository. Fill out the pull request template (this will **be**\n added automatically for you), then make sure to self-review your code and go\n through the 'Review checklist'. Don't worry about the QA checkbox, our\n product manager Amber will tick that once she has reviewed your PR. You can\n leave any notes for the reviewer in a comment.\n\n5. Once you're ready to submit a pull request, you can mark your draft PR as\n 'Ready for review' and assign @stuartc or @taylordowns2000.","ref":"readme.html#open-a-pull-request"},{"type":"extras","title":"Generate the docs pages - Lightning","doc":"You can generate the HTML and EPUB documentation locally using:\n\n`mix docs` and opening `doc/index.html` in your browser.","ref":"readme.html#generate-the-docs-pages"},{"type":"extras","title":"Server Specs for Self-Hosting - Lightning","doc":"For recommend server specifications for self-hosting of Lightning, head to the\n[deployment planning](https://docs.openfn.org/documentation/deploy/options)\nsection of the documentation or check out this\n[self-hosting thread](https://community.openfn.org/t/specs-for-self-hosting-lightning/292)\non our community forum.","ref":"readme.html#server-specs-for-self-hosting"},{"type":"extras","title":"Benchmarking - Lightning","doc":"We are using [k6](https://k6.io/) to benchmark Lightning. Under `benchmarking`\nfolder you can find a script for benchmarking Webhook Workflows.\n\nSee [Benchmarking](benchmarking/README.md) for more detailed information.","ref":"readme.html#benchmarking"},{"type":"extras","title":"Troubleshooting - Lightning","doc":"","ref":"readme.html#troubleshooting"},{"type":"extras","title":"Problems with environment variables - Lightning","doc":"For troubleshooting custom environment variable configuration it's important to\nknow how an Elixir app loads and modifies configuration. The order is as\nfollows:\n\n1. Stuff in `config.exs` is loaded.\n2. _That_ is then modified (think: _overwritten_) by stuff your ENV-specific\n config: `dev.exs`, `prod.exs` or `test.exs`.\n3. _That_ is then modified by `runtime.exs` which is where you are allowed to\n use `System.env()`\n4. _Finally_ `init/2` (if present in a child application) gets called (which\n takes the config which has been set in steps 1-3) when that child application\n is started during the parent app startup defined in `application.ex`.","ref":"readme.html#problems-with-environment-variables"},{"type":"extras","title":"Problems with Postgres - Lightning","doc":"If you're having connecting issues with Postgres, check the database section of\nyour `.env` to ensure the DB url is correctly set for your environment — note\nthat composing a DB url out of other, earlier declared variables, does not work\nwhile using `xargs`.","ref":"readme.html#problems-with-postgres"},{"type":"extras","title":"Problems with Debian - Lightning","doc":"If you're getting this error on debian\n\n```\n==> earmark_parser\nCompiling 1 file (.yrl)\n/usr/lib/erlang/lib/parsetools-2.3.1/include/yeccpre.hrl: no such file or directory\ncould not compile dependency :earmark_parser, \"mix compile\" failed. You can recompile this dependency with \"mix deps.compile earmark_parser\", update it with \"mix deps.update earmark_parser\" or clean it with \"mix deps.clean earmark_parser\"\n```\n\nYou need to install erlang development environment `sudo apt install erlang-dev`\n[refer to this issue](https://github.com/elixir-lang/ex_doc/issues/1441)","ref":"readme.html#problems-with-debian"},{"type":"extras","title":"Problems with Docker - Lightning","doc":"#### Versions\n\nThe build may not work on old versions of Docker and Docker compose. It has been\ntested against:\n\n```\nDocker version 20.10.17, build 100c701\nDocker Compose version v2.6.0\n```\n\n#### Starting from scratch\n\nIf you're actively working with docker, you start experiencing issues, and you\nwould like to start from scratch you can clean up everything and start over like\nthis:\n\n```sh\n# To remove any ignored files and reset your .env to it's example\ngit clean -fdx && cp .env.example .env\n# You can skip the line below if you want to keep your database\ndocker compose down --rmi all --volumes\n\ndocker compose build --no-cache web && \\\n docker compose create --force-recreate\n\ndocker compose run --rm web mix ecto.migrate\ndocker compose up\n```\n\n#### Apple Silicon\n\nWhen running `docker compose up` on Apple Silicon (M1, M2, M3), you might encounter the following error:\n\n```\n> [web 20/20] RUN npm install --prefix assets:\n0.091 rosetta error: failed to open elf at /lib64/ld-linux-x86-64.so.2\n0.091 Trace/breakpoint trap\n------\nfailed to solve: process \"/bin/sh -c npm install --prefix assets\" did not complete successfully: exit code: 133\n```\n\nYou can solve this by setting the default docker platform to `linux/amd64`, i.e. `DOCKER_DEFAULT_PLATFORM=linux/amd64`.\nYou can read more on this here: https://stackoverflow.com/questions/71040681/qemu-x86-64-could-not-open-lib64-ld-linux-x86-64-so-2-no-such-file-or-direc\n\nYou might also run into:\n\n```\n[notice] Application ssl exited: exited in: :ssl_app.start(:normal, [])\n ** (EXIT) an exception was raised:\n ** (ArgumentError) could not call Module.put_attribute/3 because the module Lightning.MixProject is already compiled\n (elixir 1.16.2) lib/module.ex:2360: Module.assert_not_readonly!/2\n (elixir 1.16.2) lib/module.ex:2041: Module.__put_attribute__/5\n (ssl 11.1.4) ssl_app.erl:35: :ssl_app.stop/1\n (kernel 9.2.4) application_master.erl:293: :application_master.start_it_old/4\n\n** (MatchError) no match of right hand side value: {:error, {:ssl, {:bad_return, {{:ssl_app, :start, [:normal, []]}, {:EXIT, {%ArgumentError{message: \"could not call Module.put_attribute/3 because the module Lightning.MixProject is already compiled\"}, [{Module, :assert_not_readonly!, 2, [file: ~c\"lib/module.ex\", line: 2360]}, {Module, :__put_attribute__, 5, [file: ~c\"lib/module.ex\", line: 2041]}, {:ssl_app, :stop, 1, [file: ~c\"ssl_app.erl\", line: 35]}, {:application_master, :start_it_old, 4, [file: ~c\"application_master.erl\", line: 293]}]}}}}}}\n```\n\nYou can resolve this by setting `ERL_FLAGS=\"+JPperf true\"` env to the failing stage.\nYou can follow this thread on our community forum for more info: https://community.openfn.org/t/lightning-prebuilt-images-throw-no-matching-manifest-for-linux-arm64-v8-in-the-manifest-list-entries/465/15","ref":"readme.html#problems-with-docker"},{"type":"extras","title":"Problems with Rambo - Lightning","doc":"When running `mix compile.rambo` on Apple Silicon (an Apple M1/M2, `macarm`,\n`aarch64-apple-darwin`) and encountering the following error:\n\n```\n** (RuntimeError) Rambo does not ship with binaries for your environment.\n\n aarch64-apple-darwin22.3.0 detected\n\nInstall the Rust compiler so a binary can be prepared for you.\n\n lib/mix/tasks/compile.rambo.ex:89: Mix.Tasks.Compile.Rambo.compile!/0\n lib/mix/tasks/compile.rambo.ex:51: Mix.Tasks.Compile.Rambo.run/1\n (mix 1.14.2) lib/mix/task.ex:421: anonymous fn/3 in Mix.Task.run_task/4\n (mix 1.14.2) lib/mix/cli.ex:84: Mix.CLI.run_task/2\n```\n\nYou can resolve this error by installing the Rust compiler using Homebrew. Run\nthe following command in your terminal: `brew install rust`\n\nIf you have already compiled Rambo explicitly via `mix compile.rambo`, and you\nare still seeing the following error:\n\n```\nsh: /path_to_directory/Lightning/_build/dev/lib/rambo/priv/rambo: No such file or directory\nsh: line 0: exec: /path_to_directory/Lightning/_build/dev/lib/rambo/priv/rambo: cannot execute: No such file or directory\n```\n\nYou can try renaming `deps/rambo/priv/rambo-mac` to `deps/rambo/priv/rambo`.\n\nIf neither of the approaches above work, please raise an issue.","ref":"readme.html#problems-with-rambo"},{"type":"extras","title":"Support - Lightning","doc":"If you have any questions, feedback, or issues, please:\n\n- Post on the OpenFn Community at\n [community.openfn.org](https://community.openfn.org)\n- Open an issue directly on this GitHub Repo:\n [github.com/OpenFn/Lightning/issues](https://github.com/OpenFn/Lightning/issues)","ref":"readme.html#support"},{"type":"extras","title":"Running Locally","doc":"# Running Lightning Locally\n\nThis guide provides instructions for running Lightning locally, either by\ninstalling dependencies on your machine or using Docker.","ref":"runninglocal.html"},{"type":"extras","title":"By Installing Dependencies - Running Locally","doc":"","ref":"runninglocal.html#by-installing-dependencies"},{"type":"extras","title":"Setup - Running Locally","doc":"#### Postgres\nRequires `postgres 15`.\nWhen running in `dev` mode, the app will use the following credentials to authenticate:\n- `PORT`: `5432`\n- `USER`: `postgres`\n- `PASSWORD`: `postgres`\n- `DATABASE`: `lightning_dev`\n\nThis can however be overriden by specifying a `DATABASE_URL` env var.\ne.g. `DATABASE_URL=postgresql://postgres:postgres@localhost:5432/lightning_dev`\n\nWe recommend that you use docker for running postgres as you'll get an exact version that we use:\n\n```sh\ndocker volume create lightning-postgres-data\n\ndocker create \\\n --name lightning-postgres \\\n --mount source=lightning-postgres-data,target=/var/lib/postgresql/data \\\n --publish 5432:5432 \\\n -e POSTGRES_PASSWORD=postgres \\\n postgres:15.3-alpine\n\ndocker start lightning-postgres\n```\n\n#### Elixir, NodeJS\nWe use [asdf](https://github.com/asdf-vm/asdf) to configure our local\nenvironments. Included in the repo is a `.tool-versions` file that is read by\nasdf in order to dynamically make the specified versions of Elixir, Erlang and NodeJs\navailable. You'll need asdf plugins for\n[Erlang](https://github.com/asdf-vm/asdf-erlang),\n[NodeJs](https://github.com/asdf-vm/asdf-nodejs)\n[Elixir](https://github.com/asdf-vm/asdf-elixir) and\n[k6](https://github.com/grimoh/asdf-k6).\n\n#### Libsodium\nWe use [libsodium](https://doc.libsodium.org/) for encoding values as required\nby the\n[Github API](https://docs.github.com/en/rest/guides/encrypting-secrets-for-the-rest-api).\nYou'll need to install `libsodium` in order for the application to compile.\n\nFor Mac Users:\n\n```sh\nbrew install libsodium\n```\n\nFor Debian Users:\n\n```sh\nsudo apt-get install libsodium-dev\n```\n\nYou can find more on\n[how to install libsodium here](https://doc.libsodium.org/installation)\n\n#### Compilation and Assets\n\n```sh\nasdf install # Install language versions\nmix local.hex\nmix deps.get\nmix local.rebar --force\n[[ $(uname -m) == 'arm64' ]] && CPATH=/opt/homebrew/include LIBRARY_PATH=/opt/homebrew/lib mix deps.compile enacl # Force compile enacl if on M1\n[[ $(uname -m) == 'arm64' ]] && mix compile.rambo # Force compile rambo if on M1\nmix lightning.install_runtime\nmix lightning.install_schemas\nmix lightning.install_adaptor_icons\nmix ecto.create\nmix ecto.migrate\nnpm install --prefix assets\n```\n\nIn case you encounter errors running any of these commands, see the [troubleshooting guide](README.md#troubleshooting) for\nknown errors.","ref":"runninglocal.html#setup"},{"type":"extras","title":"Running the App - Running Locally","doc":"To start the lightning server:\n\n```sh\nmix phx.server\n```\n\nOnce the server has started, head to [`localhost:4000`](http://localhost:4000)\nin your browser.\n\nBy default, the `worker` is started when run `mix phx.server` in `dev` mode. In case you\ndon't want to have your worker started in `dev`, set `RTM=false`:\n\n```sh\nRTM=false mix phx.server\n```","ref":"runninglocal.html#running-the-app"},{"type":"extras","title":"Using Docker - Running Locally","doc":"There is an existing `docker-compose.yaml` file in the project's root which has all the\nservices required. To start your services:\n\n```sh\ndocker compose up\n```\n\nThere 2 docker files in the root, `Dockerfile` builds the app in `prod` mode while `Dockerfile-dev`\nruns it in `dev` mode. It is important to note that `mix commands` do not work in the `prod` images.\n\nFor exmaple, to run migrations in `dev` mode you run:\n\n```sh\ndocker compose run --rm web mix ecto.migrate\n```\n\nWhile in `prod` mode:\n\n```sh\ndocker compose run --rm web /app/bin/lightning eval \"Lightning.Release.migrate()\"\n```","ref":"runninglocal.html#using-docker"},{"type":"extras","title":"Configuring the Worker - Running Locally","doc":"By default, lightning starts the `worker` when running in `dev`. This can also be configured using\n`RTM` env var. In case you don't want the hassle of configuring the worker in `dev`, you can just\nremove/comment out the `worker` service from the `docker-compose.yaml` file because lightning will\nstart it for you.\n\n[Learn more about configuring workers](WORKERS.md)","ref":"runninglocal.html#configuring-the-worker"},{"type":"extras","title":"Problems with Apple Silicon - Running Locally","doc":"You might run into some errors when running the docker containers on Apple Silicon.\n[We have documented the known ones here](README.md#problems-with-docker)","ref":"runninglocal.html#problems-with-apple-silicon"},{"type":"extras","title":"Deployment","doc":"# Deployment\n\nHead to the [Deploy](https://docs.openfn.org/documentation/deploy/options)\nsection of our docs site to get started.\n\nSee below for technical considerations and instructions.","ref":"deployment.html"},{"type":"extras","title":"Encryption - Deployment","doc":"Lightning enforces encryption at rest for credentials, TOTP backup codes, and\nwebhook trigger authentication methods, for which an encryption key must be\nprovided when running in production.\n\nThe key is expected to be a randomized set of bytes, 32 long; and Base64 encoded\nwhen setting the environment variable.\n\nThere is a mix task that can generate keys in the correct shape for use as an\nenvironment variable:\n\n```sh\nmix lightning.gen_encryption_key\n0bJ9w+hn4ebQrsCaWXuA9JY49fP9kbHmywGd5K7k+/s=\n```\n\nCopy your key _(NOT THIS ONE)_ and set it as `PRIMARY_ENCRYPTION_KEY` in your\nenvironment.","ref":"deployment.html#encryption"},{"type":"extras","title":"Workers - Deployment","doc":"Lightning uses external worker processes for executing Runs. There are three\nsettings required to configure worker authentication.\n\n- `WORKER_RUNS_PRIVATE_KEY`\n- `WORKER_LIGHTNING_PUBLIC_KEY`\n- `WORKER_SECRET`\n\nYou can use the `mix lightning.gen_worker_keys` task to generate these for\nconvenience.\n\nFor more information see the [Workers](WORKERS.md) documentation.","ref":"deployment.html#workers"},{"type":"extras","title":"Environment Variables - Deployment","doc":"Note that for secure deployments, it's recommended to use a combination of\n`secrets` and `configMaps` to generate secure environment variables.","ref":"deployment.html#environment-variables"},{"type":"extras","title":"Limits - Deployment","doc":"- `WORKER_MAX_RUN_MEMORY_MB` - how much memory (in MB) can a single run use?\n- `RUN_GRACE_PERIOD_SECONDS` - how long _after_ the `MAX_RUN_DURATION_SECONDS`\n should the server wait for the worker to send back data on a run.\n- `WORKER_MAX_RUN_DURATION_SECONDS` - the maximum duration (in seconds) that\n workflows are allowed to run (keep this plus `RUN_GRACE_PERIOD_SECONDS` below\n your termination_grace_period if using kubernetes)\n- `WORKER_CAPACITY` - the number of runs a ws-worker instance will take on\n concurrently.\n- `MAX_DATACLIP_SIZE_MB` - the maximum size (in MB) of a dataclip created via\n the webhook trigger URL for a job. This limits the max request size via the\n JSON plug and may (in future) limit the size of dataclips that can be stored\n as run_results via the websocket connection from a worker.","ref":"deployment.html#limits"},{"type":"extras","title":"Github - Deployment","doc":"Lightning enables connection to github via Github Apps. The following github\npermissions are needed for the github app:\n\n| **Resource** | **Access** |\n| ------------ | -------------- |\n| Actions | Read and Write |\n| Contents | Read and Write |\n| Metadata | Read only |\n| Secrets | Read and Write |\n| Workflows | Read and Write |\n\nEnsure you set the following URLs:\n* **Homepage URL:** ` `\n* **Callback URL for authorizing users:** ` /oauth/github/callback` (Do NOT check the two checkboxes in this section requesting Device Flow and OAuth.)\n* **Setup URL for Post installation:** ` /setup_vcs` (Check the box for **Redirect on update**)\n\nThese envrionment variables will need to be set in order to configure the github\napp:\n\n| **Variable** | **Description** |\n| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |\n| `GITHUB_APP_ID` | the github app ID. |\n| `GITHUB_APP_NAME` | the github app name. This is the name used in the public link. It is the downcased name with spaces replaced with hyphens |\n| `GITHUB_APP_CLIENT_ID` | the github app Client ID |\n| `GITHUB_APP_CLIENT_SECRET` | the github app Client Secret |\n| `GITHUB_CERT` | the github app private key (Base 64 encoded) |\n\nYou can access these from your github app settings menu. Also needed for the\nconfiguration is:\n\n- `REPO_CONNECTION_SIGNING_SECRET` - secret used to sign access tokens. This\n access token is used to authenticate requests made from the github actions.\n You can generate this using `mix lightning.gen_encryption_key`","ref":"deployment.html#github"},{"type":"extras","title":"Storage - Deployment","doc":"Lightning can use a storage backend to store exports.\n\n| **Variable** | Description |\n| ----------------- | ------------------------------------------------ |\n| `STORAGE_BACKEND` | the storage backend to use. (default is `local`) |\n| `STORAGE_PATH` | the path to store files in. (default is `.`) |\n\n#### Supported backends:\n\n- `local` - local file storage\n- `gcs` - Google Cloud Storage\n\n#### Google Cloud Storage\n\nFor Google Cloud Storage, the following environment variables are required:\n\n| **Variable** | Description |\n| ------------------------------------- | -------------------------------------------------------------------------------- |\n| `GCS_BUCKET` | the name of the bucket to store files in |\n| `GOOGLE_APPLICATION_CREDENTIALS_JSON` | A base64 encoded JSON keyfile for the service account with access to the bucket. |\n\n> ℹ️ Note: The `GOOGLE_APPLICATION_CREDENTIALS_JSON` should be base64 encoded,\n> currently Workload Identity is not supported.","ref":"deployment.html#storage"},{"type":"extras","title":"Other config - Deployment","doc":"| **Variable** | Description |\n| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `ADAPTORS_PATH` | Where you store your locally installed adaptors |\n| `ALLOW_SIGNUP` | Set to `true` to enable user access to the registration page. Set to `false` to disable new user registrations and block access to the registration page. Default is `true`. |\n| `CORS_ORIGIN` | A list of acceptable hosts for browser/cors requests (',' separated) |\n| `DISABLE_DB_SSL` | In production, the use of an SSL connection to Postgres is required by default. Setting this to `\"true\"` allows unencrypted connections to the database. This is strongly discouraged in a real production environment. |\n| `EMAIL_ADMIN` | This is used as the sender email address for system emails. It is also displayed in the menu as the support email. |\n| `EMAIL_SENDER_NAME` | This is displayed in the email client as the sender name for emails sent by the application. |\n| `IDLE_TIMEOUT` | The number of seconds that must pass without data being received before the Lightning web server kills the connection. |\n| `IS_RESETTABLE_DEMO` | If set to `yes`, it allows this instance to be reset to the initial \"Lightning Demo\" state. Note that this will destroy _most_ of what you have in your database! |\n| `K8S_HEADLESS_SERVICE` | This environment variable is automatically set if you're running on GKE and it is used to establish an Erlang node cluster. Note that if you're _not_ using Kubernetes, the \"gossip\" strategy is used to establish clusters. |\n| `LISTEN_ADDRESS` | The address the web server should bind to. Defaults to `127.0.0.1` to block access from other machines. |\n| `LOG_LEVEL` | How noisy you want the logs to be (e.g., `debug`, `info`) |\n| `MIX_ENV` | Your mix env, likely `prod` for deployment |\n| `NODE_ENV` | Node env, likely `production` for deployment |\n| `ORIGINS` | The allowed origins for web traffic to the backend |\n| `PORT` | The port your Phoenix app runs on |\n| `PRIMARY_ENCRYPTION_KEY` | A base64 encoded 32 character long string. See [Encryption](#encryption). |\n| `QUEUE_RESULT_RETENTION_PERIOD_SECONDS` | The number of seconds to keep completed (successful) `ObanJobs` in the queue (not to be confused with runs and/or history) |\n| `SCHEMAS_PATH` | Path to the credential schemas that provide forms for different adaptors |\n| `SECRET_KEY_BASE` | A secret key used as a base to generate secrets for encrypting and signing data. |\n| `SENTRY_DSN` | If using Sentry for error monitoring, your DSN |\n| `URL_HOST` | The host used for writing URLs (e.g., `demo.openfn.org`) |\n| `URL_PORT` | The port, usually `443` for production |\n| `URL_SCHEME` | The scheme for writing URLs (e.g., `https`) |\n| `USAGE_TRACKER_HOST` | The host that receives usage tracking submissions (defaults to https://impact.openfn.org) |\n| `USAGE_TRACKING_DAILY_BATCH_SIZE` | The number of days that will be reported on with each run of `UsageTracking.DayWorker`. This will only have a noticeable effect in cases where there is a backlog or where reports are being generated retroactively (defaults to 10). |\n| `USAGE_TRACKING_ENABLED` | Enables the submission of anonymized usage data to OpenFn (defaults to `true`) |\n| `USAGE_TRACKING_RESUBMISSION_BATCH_SIZE` | The number of failed reports that will be submitted on each resubmission run (defaults to 10) |\n| `USAGE_TRACKING_UUIDS` | Indicates whether submissions should include cleartext UUIDs or not. Options are `cleartext` or `hashed_only`, with the default being `hashed_only`. |","ref":"deployment.html#other-config"},{"type":"extras","title":"AI Chat - Deployment","doc":"🧪 **Experimental**\n\nLightning can be configured to use an AI chatbot for user interactions.\n\nSee [openfn/apollo](https://github.com/OpenFn/apollo) for more information on\nthe Apollo AI service.\n\nThe following environment variables are required:\n\n- `OPENAI_API_KEY` - your OpenAI API key.\n- `APOLLO_ENDPOINT` - the endpoint for the OpenFn Apollo AI service.","ref":"deployment.html#ai-chat"},{"type":"extras","title":"Kafka Triggers - Deployment","doc":"🧪 **Experimental**\n\nLightning workflows can be configured with a trigger that will consume messages\nfrom a Kafka Cluster. By default this is disabled and you will not see the\noption to create a Kafka trigger in the UI, nor will the Kafka consumer groups\nbe running.\n\nTo enable this feature set the `KAFKA_TRIGGERS_ENABLED` environment variable to\n`yes` and restart Lightning. Please note that, if you enable this feature and\nthen create some Kafka triggers and then disable the feature, you will not be\nable to edit any triggers created before the feature was disabled.\n\n#### Performance Tuning\n\nThe number of Kafka consumers in the consumer group can be modified by setting\nthe `KAFKA_NUMBER_OF_CONSUMERS` environment variable. The default value is\ncurrently 1. The optimal setting is one consumer per topic partition. NOTE: This\nsetting will move to KafkaConfiguration as it will be trigger-specific.\n\nThe number of messages that the Kafka consumer will forward is rate-limited by\nthe `KAFKA_NUMBER_OF_MESSAGES_PER_SECOND` environment variable. This can be set\nto a value of less than 1 (minimum 0.1) and will converted (and rounded-down) to\nan integer value of messages over a 10-second interval (e.g. 0.15 becomes 1\nmessage every 10 seconds). The default value is 1.\n\nProcessing concurrency within the Kafka Broadway pipeline is controlled by the\n`KAFKA_NUMBER_OF_PROCESSORS` environment variable. Modifying this, modifies the\nnumber of processors that are downstream of the Kafka consumer, so an increase\nin this value should increase throughput (when factoring in the rate limit set\nby `KAFKA_NUMBER_OF_MESSAGES_PER_SECOND`). The default value is 1.\n\n#### Deduplication\n\nEach Kafka trigger maintains record of the topic, parition and offset for each\nmessage received. This to protect against the ingestion of duplicate messages\nfrom the cluster. These records are periodically cleaned out. The duration for\nwhich they are retained is controlled by\n`KAFKA_DUPLICATE_TRACKING_RETENTION_SECONDS`. The default value is 3600.\n\n#### Disabling Kafka Triggers\n\nAfter a Kafka consumer group connects to a Kafka cluster, the cluster will track\nthe last committed offset for a given consumer group ,to ensure that the consumer\ngroup receives the correct messages.\n\nThis data is retained for a finite period. If an enabled Kafka trigger is\ndisabled for longer than the offset retention period the consumer group offset\ndata will be cleared.\n\nIf the Kafka trigger is re-enabled after the offset data has been cleared, this\nwill result in the consumer group reverting to what has been configured as the\n'Initial offset reset policy' for the trigger. This may result in the\nduplication of messages or even data loss.\n\nIt is recommended that you check the value of the `offsets.retention.minutes` for\nthe Kafka cluster to determine what the cluster's retention period is, and\nconsider this when disabling a Kafka trigger for an extended period.\n\n#### Failure notifications\n\nUnder certain failure conditions, a Kafka trigger will send an email to certain\nuser that are associated with a project. After each email an embargo is applied\nto ensure that Lightning does not flood the recipients with email. The length\nof the embargo is controlled by the `KAFKA_NOTIFICATION_EMBARGO_SECONDS` ENV\nvariable.\n\n#### Persisting Failed Messages\n\n**PLEASE NOTE: If alternate file storage is not enabled, messages that fail\nto be persisted will not be retained by Lightning ans this can result in data\nloss, if the Kafka cluster can not make these messages available again.**\n\nIf a Kafka message files to be persisted as a WorkOrder, Run and Dataclip, the \noption exists to write the failed message to a location on the local file system.\nIf this option is enabled by setting `KAFKA_ALTERNATE_STORAGE_ENABLED`, then the\n`KAFKA_ALTERNATE_STORAGE_PATH` ENV variable must be set to the path that exists\nand is writable by Lightning. The location shoudl also be suitably protected to\nprevent data exposure as Lightning **will not encrypt** the message contents when\nwriting it.\n\nIf the option is enabled and a message fails to be persisted, Lightning will\ncreate a subdirectory named with the id if the affected trigger's workflow \nin the location specified by `KAFKA_ALTERNATE_STORAGE_PATH` (assuming such a\nsubdirectory does not already exist). Lightning will serialise the message\nheaders and data as received by the Kafka pipeline and write this to a file\nwithin the subdirectory. The file will be named based on the pattern \n` _ _ _ .json`.\n\nTo recover the persisted messages, it is suggested that the affected triggers\nbe disabled before commencing. Once this is done, the following code needs to\nbe run from an IEx console on each node that is running Lightning:\n\n```elixir\nLightning.KafkaTriggers.MessageRecovery.recover_messages(\n Lightning.Config.kafka_alternate_storage_file_path()\n)\n```\n\nFurther details regarding the behaviour of `MessageRecovery.recover_messages/1` \ncan be found in the module documentation of `MessageRecovery`. Recovered\nmessages will have the `.json` extension modified to `.json.recovered` but they\nwill be left in place. Future recovery runs will not process files that have\nbeen marked as recovered.\n\nOnce all files have either been recovered or discarded, the triggers can be\nenabled once more.","ref":"deployment.html#kafka-triggers"},{"type":"extras","title":"Google Oauth2 - Deployment","doc":"Using your Google Cloud account, provision a new OAuth 2.0 Client with the 'Web\napplication' type.\n\nSet the callback url to: `https:// /authenticate/callback`.\nReplacing `ENDPOINT DOMAIN` with the host name of your instance.\n\nOnce the client has been created, get/download the OAuth client JSON and set the\nfollowing environment variables:\n\n| **Variable** | Description |\n| ---------------------- | --------------------------------------------- |\n| `GOOGLE_CLIENT_ID` | Which is `client_id` from the client details. |\n| `GOOGLE_CLIENT_SECRET` | `client_secret` from the client details. |","ref":"deployment.html#google-oauth2"},{"type":"extras","title":"Salesforce Oauth2 - Deployment","doc":"Using your Salesforce developer account, create a new Oauth 2.0 connected\napplication.\n\nSet the callback url to: `https:// /authenticate/callback`.\nReplacing `ENDPOINT DOMAIN` with the host name of your instance.\n\nGrant permissions as desired.\n\nOnce the client has been created set the following environment variables:\n\n| **Variable** | Description |\n| -------------------------- | --------------------------------------------------------------------- |\n| `SALESFORCE_CLIENT_ID` | Which is `Consumer Key` from the \"Manage Consumer Details\" screen. |\n| `SALESFORCE_CLIENT_SECRET` | Which is `Consumer Secret` from the \"Manage Consumer Details\" screen. |","ref":"deployment.html#salesforce-oauth2"},{"type":"extras","title":"Benchmarking","doc":"# Benchmarking","ref":"benchmarking.md.html"},{"type":"extras","title":"Run benchmarking tests against the demo webhook - Benchmarking","doc":"Execute the following steps to run a benchmark on Lightning:\n\n1. Make sure you have [k6](https://k6.io/docs/get-started/installation/)\n installed locally. If you're using `asdf` you can run `asdf install` in the\n project root.\n\n2. Start up a local Lightning instance with an attached iex session. Note that\n to simulate a production environment, set `RTM=false`. In prod, you'll have\n your `ws-worker` running on a separate machine:\n\n `RMT=false iex -S mix phx.server`\n\n3. In the attached iex session, run the following, to have Lightning log\n internal telemetry data:\n\n ```elixir\n filepath = Path.join(\"benchmarking\", \"load_test_data.csv\")\n output_file = File.open!(filepath, [:append])\n\n c \"benchmarking/load_test_production_spans.exs\"\n\n LoadTestingPrep.init(output_file)\n ```\n\n4. Run the demo setup script: `mix run --no-start priv/repo/demo.exs` The\n `webhookURL` is already set to default to the webhook created in the demo\n data\n\n If you would like to point at a different instance or webhook url you\n can provide it via `WEBHOOK_URL`.\n\n5. In another terminal (do not stop the Lightning server) run the\n `benchmarking/script.js` file using the following command\n\n ```bash\n k6 run benchmarking/script.js\n ```\n\n If the script exits successfully, this means the app met the defined\n performance thresholds.\n\n By default, the test payload is just 2 kb. Should you wish to test it with\n larger payloads, you can pass in the `PAYLOAD_SIZE_KB` ENV variable. This\n variable allows you to specify the payload size in KB (for now, integer\n values only), (e.g. 2 KB):\n\n ```bash\n k6 run -e PAYLOAD_SIZE_KB=2 benchmarking/script.js\n ```\n\n To collect the benchmarking data in a CSV file, run the previous command with\n the `--out filename` option.\n\n ```bash\n k6 run --out csv=test_results.csv benchmarking/script.js\n ```\n\n6. In the iex session, close the output file:\n\n ```elixir\n LoadTestingPrep.fin(output_file)\n ```\n\nSee [results output](https://k6.io/docs/get-started/results-output/) for other\navailable output formats.","ref":"benchmarking.md.html#run-benchmarking-tests-against-the-demo-webhook"},{"type":"extras","title":"Sample benchmarks - Benchmarking","doc":"#### System specs on a 2020 MacBook Pro\n\n```\nModel Name: MacBook Pro\nModel Identifier: MacBookPro17,1\nModel Number: Z11B000E3LL/A\nChip: Apple M1\nTotal Number of Cores: 8 (4 performance and 4 efficiency)\nMemory: 16 GB\n```\n\n#### Results with 50kb payloads\n\n```\nk6 run -e PAYLOAD_SIZE=10 benchmarking/script.js Node 18.17.1 k6 0.43.1 07:40:29\n\n /\\ |‾‾| /‾‾/ /‾‾/\n /\\ / \\ | |/ / / /\n / \\/ \\ | ( / ‾‾\\\n / \\ | |\\ \\ | (‾) |\n / __________ \\ |__| \\__\\ \\_____/ .io\n\n execution: local\n script: benchmarking/script.js\n output: -\n\n scenarios: (100.00%) 1 scenario, 50 max VUs, 2m50s max duration (incl. graceful stop):\n * webhookRequests: Up to 50.00 iterations/s for 2m20s over 3 stages (maxVUs: 50, gracefulStop: 30s)\n\n\n ✓ status was 200\n\n █ setup\n\n checks.........................: 100.00% ✓ 5765 ✗ 0\n data_received..................: 1.6 MB 12 kB/s\n data_sent......................: 59 MB 421 kB/s\n http_req_blocked...............: avg=16.01µs min=2µs med=9µs max=6.84ms p(90)=12µs p(95)=13µs\n http_req_connecting............: avg=4.35µs min=0s med=0s max=2.22ms p(90)=0s p(95)=0s\n ✓ http_req_duration..............: avg=53.62ms min=26.86ms med=49.03ms max=501.62ms p(90)=66.62ms p(95)=84.33ms\n { expected_response:true }...: avg=53.62ms min=26.86ms med=49.03ms max=501.62ms p(90)=66.62ms p(95)=84.33ms\n ✓ http_req_failed................: 0.00% ✓ 0 ✗ 5765\n http_req_receiving.............: avg=88.57µs min=13µs med=90µs max=2.99ms p(90)=108µs p(95)=124.8µs\n http_req_sending...............: avg=97.47µs min=29µs med=83µs max=6.86ms p(90)=139µs p(95)=162µs\n http_req_tls_handshaking.......: avg=0s min=0s med=0s max=0s p(90)=0s p(95)=0s\n http_req_waiting...............: avg=53.44ms min=26.68ms med=48.84ms max=501.43ms p(90)=66.43ms p(95)=84.05ms\n http_reqs......................: 5765 41.15402/s\n iteration_duration.............: avg=54.34ms min=20.75µs med=49.75ms max=502.26ms p(90)=67.39ms p(95)=84.91ms\n iterations.....................: 5765 41.15402/s\n vus............................: 50 min=50 max=50\n vus_max........................: 50 min=50 max=50\n\n\nrunning (2m20.1s), 00/50 VUs, 5765 complete and 0 interrupted iterations\nwebhookRequests ✓ [======================================] 00/50 VUs 2m20s 01.12 iters/s\n```","ref":"benchmarking.md.html#sample-benchmarks"},{"type":"extras","title":"Run load tests for a hypothetical cold chain system - Benchmarking","doc":"`benchmarking/sample_cold_chain_monitoring_script.js` contains a k6 script that\ncan be used to simulate data from a hypothetical cold chain system. It requires a\ncustom job to be created (an example of which can be found at the top of the\nscript file).\n\nThe test can be excuted as follows (`WEBHOOK_URL` is not optional):\n\n```bash\n WEBHOOK_URL=... k6 run benchmarking/sample_cold_chain_monitoring_script.js\n```","ref":"benchmarking.md.html#run-load-tests-for-a-hypothetical-cold-chain-system"},{"type":"extras","title":"Workers","doc":"# Workers\n\nThe OpenFn Runtime used by Lightning is a [Node.js](https://nodejs.org/en/)\napplication that runs on a server. It is responsible for executing the code that\nyou write in your OpenFn jobs.\n\nA Runtime Manager is a module or application that processes Runs, which\ncontains reference to the Workflow, the starting point and the initial data.\n\nRuns are enqueued, and Runtime Managers request work to be performed when\nthey are ready.","ref":"workers.html"},{"type":"extras","title":"History - Workers","doc":"In previous versions of OpenFn products, the server would invoke a NodeJS child\nprocess for each Run that needs to be executed. Deciding which Job to run in a\nworkflow is decided after each run is completed.\n\nThe current approach to executing Runs, is that a worker checks out the\nentire run and executes it and all the jobs required.\n\nThe advantage of this approach is a significant reduction in latency of\nlaunching new workers for every Run to be processed.","ref":"workers.html#history"},{"type":"extras","title":"Connecting Workers to Lightning - Workers","doc":"Our standard Runtime Manager uses WebSockets to communicate with Lightning.\n\nHowever, since the workers are treated no differently from any other incoming\ntraffic; there are two layers of security applied to anything that can access\nyour data or process work.\n\nWe use two different JWTs to facilitate the follow:","ref":"workers.html#connecting-workers-to-lightning"},{"type":"extras","title":"Worker Token - Workers","doc":"This token is created by the worker and signed with a shared HS256 secret that\nLightning uses to verify.","ref":"workers.html#worker-token"},{"type":"extras","title":"Run Token - Workers","doc":"This token is created by Lightning for every Run that a worker receives. The\ntoken is signed with a private key, and therefore cannot be generated by 3rd\nparties.\n\nThe token is scoped for a single Run and cannot be used to access anything\noutside of the scope of that Run.","ref":"workers.html#run-token"},{"type":"extras","title":"Generating Keys - Workers","doc":"Lightning comes with a mix task to help generate keys:\n\n```\nmix lightning.gen_worker_keys\n```","ref":"workers.html#generating-keys"},{"type":"extras","title":"Configuring Lightning and Workers - Workers","doc":"There are three environment variables required to make everything work.\n\n**`WORKER_RUNS_PRIVATE_KEY`**\n\n_Lightning only_\n\nA Base64 encoded private key in PEM format, used to generate JWTs granting\nworkers permission to access a specific Run, the related Workflow and\ncredentials.\n\n> [!IMPORTANT] This key should never be shared. If you suspect it has been\n> compromised, generate a new one and reconfigure both Lightning and your\n> workers.\n\n**`WORKER_SECRET`**\n\n_Lightning and Workers_\n\nA 256bit long shared secret used by the worker to sign JWTs for authentication\nwith the Lightning API.\n\n**`WORKER_LIGHTNING_PUBLIC_KEY`**\n\n_Workers only_\n\nA Base64 encoded public key in PEM format derived from the private key. This is\nused by workers to verify Run Tokens coming from Lightning.","ref":"workers.html#configuring-lightning-and-workers"},{"type":"extras","title":"Troubleshooting - Workers","doc":"","ref":"workers.html#troubleshooting"},{"type":"extras","title":"Problems with NodeJS DNS name resolution - Workers","doc":"NodeJS v17 [changed](https://github.com/nodejs/node/pull/39987) how DNS name\nresolution is handled. In earlier versions, Node would reorder DNS lookup\nresults so IPv4 addresses came before IPv6 addresses. In v17, Node started\nreturning addresses in the same order provided by the resolver. The net effect\nis that your workers might fail to connect to Lightning if the native DNS\nresolver on your system is returning the loopback IPv6 address (`::1`) before\nthe IPv4 address (`127.0.0.1`). In these cases, your worker might report an\nerror similar to the following:\n\n```\nCRITICAL ERROR: could not connect to lightning at ws://localhost:4000/worker\n```\n\nIf you experience this, it can be helpful to set the `NODE_OPTIONS` environment\nvariable as shown below. This will force pre-v17 behavior of returning IPv4\naddresses first.\n\n```\nNODE_OPTIONS=--dns-result-order=ipv4first\n```\n\nYou can directly inspect what IP address Node returns for `localhost` by running\nthe following command:\n\n```\nnode -e 'dns.lookup(\"localhost\", console.log)'\n```","ref":"workers.html#problems-with-nodejs-dns-name-resolution"},{"type":"extras","title":"Provisioning","doc":"# Provisioning\n\nLightning offers the ability to configure projects via the HTTP API.\n\nBy providing a JSON document with the desired configuration, the project can be\nconfigured to your liking.","ref":"provisioning.html"},{"type":"extras","title":"Using the API - Provisioning","doc":"The API is available at `/api/provision`, and expects an `application/json`\nContent-Type.","ref":"provisioning.html#using-the-api"},{"type":"extras","title":"Authentication - Provisioning","doc":"The API requires a valid auth token to be provided in the `Authorization`\nheader.","ref":"provisioning.html#authentication"},{"type":"extras","title":"Example Request - Provisioning","doc":"```bash\n curl -X POST \\\n -d @project.json \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n $ENDPOINT/api/provision\n```","ref":"provisioning.html#example-request"},{"type":"extras","title":"Document Structure - Provisioning","doc":"The provisioning document is a JSON document with the project at the root.\n\n> All entities **must have** an `id` field, which is a UUIDv4 string. In the\n> case of new entities, this must be generated by the client.\n\nThe API is idempotent, and the distinction between creating and updating is\ndetermined by the presence of the `id` field.\n\n```jsonc\n{\n \"id\": \"< >\",\n \"name\": \"< >\",\n \"workflows\": [\n {\n \"id\": \"< >\",\n \"name\": \"< >\",\n \"jobs\": [\n {\n \"id\": \"< >\",\n \"name\": \"< >\",\n \"body\": \"< >\",\n \"adaptor\": \"< >\",\n \"enabled\": true\n }\n // ... more jobs\n ],\n \"triggers\": [\n {\n \"id\": \"< >\",\n \"name\": \"< >\",\n \"type\": \"webhook\"\n }\n // ... more triggers\n ],\n \"edges\": [\n {\n \"id\": \"< >\",\n \"source_trigger_id\": \"< >\",\n \"target_job_id\": \"< >\"\n }\n // ... more edges\n ]\n }\n // ... more workflows\n ]\n}\n```","ref":"provisioning.html#document-structure"},{"type":"extras","title":"API Behaviour - Provisioning","doc":"The API expects **all** existing entities to be provided in the provisioning\ndocument.\n\nIf the document provided is out of date (e.g. a new job was added on the\nserver), a new reference document should be fetched and the changes applied to\nit.","ref":"provisioning.html#api-behaviour"},{"type":"extras","title":"Deleting Entities - Provisioning","doc":"Entities can be deleted by setting the `disabled` key to `true`.\n\nExample:\n\n```jsonc\n{\n \"id\": \"< >\",\n \"workflows\": [\n {\n \"id\": \"< >\",\n \"jobs\": [\n {\n \"id\": \"< >\",\n \"delete\": true // <== delete this job\n }\n ]\n }\n ]\n}\n```","ref":"provisioning.html#deleting-entities"},{"type":"extras","title":"Relationship with Projects as Code - Provisioning","doc":"The Projects as Code spec is a superset of the provisioning API.\n\nProjects as Code allows for the user to specify a key for each entity, which\nmakes it easier to manage the project in the future.\n\nFor example:\n\n```yaml\nname: my-project\nworkflows:\n workflow-one:\n jobs:\n job-one:\n body: |\n console.log(\"Hello World\");\n adaptor: '@openfn/language-common'\n enabled: true\n triggers:\n trigger-one:\n type: webhook\n edges:\n - source_trigger: trigger-one\n target_job: job-one\n```\n\nThe above YAML document illustrates the use of keys being used to identify\nentities. Allowing the user to provision the same project to multiple\nenvironments.\n\nThe API is unaware of 'keys', and expects IDs to be provided by the client.\n\nIn order to convert the above YAML document to a provisioning document, the CLI\nuses a local state file (if available) to map the keys to UUIDs.\n\nUsing the example above a state file might look like this:\n\n```jsonc\n{\n \"id\": \"f6ba9a8c-b687-473a-908e-e250686f1eed\",\n \"workflows\": {\n \"workflow-one\": {\n \"id\": \"f206aa85-4fce-492e-94eb-ffd32c75d178\",\n \"jobs\": {},\n \"triggers\": {}\n }\n }\n}\n```\n\nThe state file shows that the project and workflow already exist, but the job,\ntrigger and edge do not. In order to create these new entities, IDs will be\napplied them.\n\nOn a successful application of the provisioning document, the state file will be\nupdated to reflect the new IDs and entities.\n\n```json\n{\n \"id\": \"f6ba9a8c-b687-473a-908e-e250686f1eed\",\n \"workflows\": {\n \"workflow-one\": {\n \"id\": \"f206aa85-4fce-492e-94eb-ffd32c75d178\",\n \"jobs\": {\n \"job-one\": { \"id\": \"18ed71de-caf8-4822-aefc-5b19351f4016\" }\n },\n \"triggers\": {\n \"trigger-one\": { \"id\": \"e0b9f357-9cf9-4206-9924-4d5674aad830\" }\n },\n \"edges\": [\n {\n \"id\": \"c239d994-6662-4637-90f8-0293c924b461\",\n \"source_trigger_id\": \"e0b9f357-9cf9-4206-9924-4d5674aad830\",\n \"target_job_id\": \"18ed71de-caf8-4822-aefc-5b19351f4016\"\n }\n ]\n }\n }\n}\n```","ref":"provisioning.html#relationship-with-projects-as-code"},{"type":"extras","title":"Changelog","doc":"# Changelog\n\nAll notable changes to this project will be documented in this file.\n\n- `Added` for new features.\n- `Changed` for changes in existing functionality.\n- `Deprecated` for soon-to-be removed features.\n- `Removed` for now removed features.\n- `Fixed` for any bug fixes.\n- `Security` in case of vulnerabilities.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to\n[Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [Unreleased]","ref":"changelog.html"},{"type":"extras","title":"Added - Changelog","doc":"- Audit history exports events\n [#2367](https://github.com/OpenFn/lightning/issues/2367)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Ignore Plug.Conn.InvalidQueryError in Sentry\n [#2672](https://github.com/OpenFn/lightning/issues/2672)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Error when the logger receives a boolean\n [#2666](https://github.com/OpenFn/lightning/issues/2666)\n\n## [v2.10.1] - 2024-11-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix metadata loading as code-assist in the editor\n [#2669](https://github.com/OpenFn/lightning/pull/2669)\n- Fix Broken Input Dataclip UI\n [#2670](https://github.com/OpenFn/lightning/pull/2670)\n\n## [v2.10.0] - 2024-11-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Increase collection items value limit to 1M characters\n [#2661](https://github.com/OpenFn/lightning/pull/2661)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix issues loading suggestions for code-assist\n [#2662](https://github.com/OpenFn/lightning/pull/2662)\n\n## [v2.10.0-rc.2] - 2024-11-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Bootstrap script to help install and configure the Lightning app for\n development [#2654](https://github.com/OpenFn/lightning/pull/2654)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Upgrade dependencies [#2624](https://github.com/OpenFn/lightning/pull/2624)\n- Hide the collections and fhir-jembi adaptors from the available adaptors list\n [#2648](https://github.com/OpenFn/lightning/issues/2648)\n- Change column name for \"Last Activity\" to \"Last Modified\" on Projects list\n [#2593](https://github.com/OpenFn/lightning/issues/2593)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix LiveView crash when pressing \"esc\" on inspector\n [#2622](https://github.com/OpenFn/lightning/issues/2622)\n- Delete project data in batches to avoid timeouts in the db connection\n [#2632](https://github.com/OpenFn/lightning/issues/2632)\n- Fix MetadataService crashing when errors are encountered\n [#2659](https://github.com/OpenFn/lightning/issues/2659)\n\n## [v2.10.0-rc.1] - 2024-11-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Reduce transaction time when fetching collection items by fetching upfront\n [#2645](https://github.com/OpenFn/lightning/issues/2645)\n\n## [v2.10.0-rc.0] - 2024-11-07","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Adds a UI for managing collections\n [#2567](https://github.com/OpenFn/lightning/issues/2567)\n- Introduces collections, a programatic workflow data sharing resource.\n [#2551](https://github.com/OpenFn/lightning/issues/2551)\n\n## [v2.9.15] - 2024-11-06","ref":"changelog.html#added"},{"type":"extras","title":"Added - Changelog","doc":"- Added some basic editor usage tips to the docs panel\n [#2629](https://github.com/OpenFn/lightning/pull/2629)\n- Create audit events when the retention periods for a project's dataclips and\n history are modified. [#2589](https://github.com/OpenFn/lightning/issues/2589)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- The Docs panel in the inspector will now be closed by default\n [#2629](https://github.com/OpenFn/lightning/pull/2629)\n- JSDoc annotations are removed from code assist descriptions\n [#2629](https://github.com/OpenFn/lightning/pull/2629)\n- Show project name during delete confirmation\n [#2634](https://github.com/OpenFn/lightning/pull/2634)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix misaligned margins on collapsed panels in the inspector\n [#2571](https://github.com/OpenFn/lightning/issues/2571)\n- Fix sorting directions icons in projects table in the project dashboard page\n [#2631](https://github.com/OpenFn/lightning/pull/2631)\n- Fixed an issue where code-completion prompts don't load properly in the\n inspector [#2629](https://github.com/OpenFn/lightning/pull/2629)\n- Fixed an issue where namespaces (like http.) don't appear in code assist\n prompts [#2629](https://github.com/OpenFn/lightning/pull/2629)\n\n## [v2.9.14] - 2024-10-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Additional documentation and notification text relating to the importance of\n alternate storage for Kafka triggers.\n [#2614](https://github.com/OpenFn/lightning/issues/2614)\n- Add support for run memory limit option\n [#2623](https://github.com/OpenFn/lightning/pull/2623)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Enforcing MFA for a project can be enforced by the usage limiter\n [#2607](https://github.com/OpenFn/lightning/pull/2607)\n- Add extensions for limiting retention period\n [#2618](https://github.com/OpenFn/lightning/pull/2618)\n\n## [v2.9.13] - 2024-10-28","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Add responsible ai disclaimer to arcade video\n [#2610](https://github.com/OpenFn/lightning/pull/2610)\n\n## [v2.9.12] - 2024-10-25","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix editor panel buttons gets out of shape on smaller screens\n [#2278](https://github.com/OpenFn/lightning/issues/2278)\n- Do not send empty strings in credential body to the worker\n [#2585](https://github.com/OpenFn/lightning/issues/2585)\n- Refactor projects dashboard page and fix bug on last activity column\n [#2593](https://github.com/OpenFn/lightning/issues/2593)\n\n## [v2.9.11] - 2024-10-23","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Optionally write Kafka messages that can not be persisted to the file system.\n [#2386](https://github.com/OpenFn/lightning/issues/2386)\n- Add `MessageRecovery` utility code to restore Kafka messages that were\n pesisted to the file system.\n [#2386](https://github.com/OpenFn/lightning/issues/2386)\n- Projects page welcome section: allow users to learn how to use the app thru\n Arcade videos [#2563](https://github.com/OpenFn/lightning/issues/2563)\n- Store user preferences in database\n [#2564](https://github.com/OpenFn/lightning/issues/2564)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Allow users to to preview password fields in credential forms\n [#2584](https://github.com/OpenFn/lightning/issues/2584)\n- Remove superuser flag for oauth clients creation\n [#2417](https://github.com/OpenFn/lightning/issues/2417)\n- Make URL validator more flexible to support URLs with dashes and other cases\n [#2417](https://github.com/OpenFn/lightning/issues/2417)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix retry many workorders when built for job\n [#2597](https://github.com/OpenFn/lightning/issues/2597)\n- Do not count deleted workflows in the projects table\n [#2540](https://github.com/OpenFn/lightning/issues/2540)\n\n## [v2.9.10] - 2024-10-16","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Notify users when a Kafka trigger can not persist a message to the database.\n [#2386](https://github.com/OpenFn/lightning/issues/2386)\n- Support `kafka` trigger type in the provisioner\n [#2506](https://github.com/OpenFn/lightning/issues/2506)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix work order retry sorting and avoids loading dataclips\n [#2581](https://github.com/OpenFn/lightning/issues/2581)\n- Fix editor panel overlays output panel when scrolled\n [#2291](https://github.com/OpenFn/lightning/issues/2291)\n\n## [v2.9.9] - 2024-10-09","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Make project description multiline in project.yaml\n [#2534](https://github.com/OpenFn/lightning/issues/2534)\n- Do not track partition timestamps when ingesting Kafka messages.\n [#2531](https://github.com/OpenFn/lightning/issues/2531)\n- Always use the `initial_offset_reset_policy` when enabling a Kafka pipeline.\n [#2531](https://github.com/OpenFn/lightning/issues/2531)\n- Add plumbing to simulate a persistence failure in a Kafka trigger pipeline.\n [#2386](https://github.com/OpenFn/lightning/issues/2386)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix Oban errors not getting logged in Sentry\n [#2542](https://github.com/OpenFn/lightning/issues/2542)\n- Perform data retention purging in batches to avoid timeouts\n [#2528](https://github.com/OpenFn/lightning/issues/2528)\n- Fix editor panel title gets pushed away when collapsed\n [#2545](https://github.com/OpenFn/lightning/issues/2545)\n- Mark unfinished steps having finished runs as `lost`\n [#2416](https://github.com/OpenFn/lightning/issues/2416)\n\n## [v2.9.8] - 2024-10-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Ability for users to to retry Runs and create manual Work Orders from the job\n inspector #2496 [#2496](https://github.com/OpenFn/lightning/issues/2496)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix panel icons overlays on top title when collapsed\n [#2537](https://github.com/OpenFn/lightning/issues/2537)\n\n## [v2.9.7] - 2024-10-02","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Enqueues many work orders retries in the same transaction per Oban job.\n [#2363](https://github.com/OpenFn/lightning/issues/2363)\n- Added the ability to retry rejected work orders.\n [#2391](https://github.com/OpenFn/lightning/issues/2391)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Notify other present users when the promoted user saves the workflow\n [#2282](https://github.com/OpenFn/lightning/issues/2282)\n- User email change: Add debounce on blur to input forms to avoid validation\n after every keystroke [#2365](https://github.com/OpenFn/lightning/issues/2365)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Use timestamps sent from worker when starting and completing runs\n [#2434](https://github.com/OpenFn/lightning/issues/2434)\n- User email change: Add debounce on blur to input forms to avoid validation\n after every keystroke [#2365](https://github.com/OpenFn/lightning/issues/2365)","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- User email change: Send notification of change to the old email address and\n confirmation to the new email address\n [#2365](https://github.com/OpenFn/lightning/issues/2365)\n- Fixes filters to properly handle the \"rejected\" status for work orders.\n [#2391](https://github.com/OpenFn/lightning/issues/2391)\n- Fix item selection (project / billing account) in the context switcher\n [#2518](https://github.com/OpenFn/lightning/issues/2518)\n- Export edge condition expressions as multiline in project spec\n [#2521](https://github.com/OpenFn/lightning/issues/2521)\n- Fix line spacing on AI Assistant\n [#2498](https://github.com/OpenFn/lightning/issues/2498)\n\n## [v2.9.6] - 2024-09-23","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Increase minimum password length to 12 in accordance with ASVS 4.0.3\n recommendation V2.1.2 [#2507](https://github.com/OpenFn/lightning/pull/2507)\n- Changed the public sandbox (https://demo.openfn.org) setup script to use\n `welcome12345` passwords to comply with a 12-character minimum","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Dataclip selector always shows that the dataclip is wiped even when the job\n wasn't run [#2303](https://github.com/OpenFn/lightning/issues/2303)\n- Send run channel errors to sentry\n [#2515](https://github.com/OpenFn/lightning/issues/2515)\n\n## [v2.9.5] - 2024-09-18","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Hide export history button when no workorder is rendered in the table\n [#2440](https://github.com/OpenFn/lightning/issues/2440)\n- Improve docs for running lightning locally #2499\n [#2499](https://github.com/OpenFn/lightning/pull/2499)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix empty webhook URL when switching workflow trigger type\n [#2050](https://github.com/OpenFn/lightning/issues/2050)\n- Add quotes when special YAML characters are present in the exported project\n [#2446](https://github.com/OpenFn/lightning/issues/2446)\n- In the AI Assistant, don't open the help page when clicking the Responsible AI\n Link [#2511](https://github.com/OpenFn/lightning/issues/2511)\n\n## [v2.9.4] - 2024-09-16","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Responsible AI review of AI Assistant\n [#2478](https://github.com/OpenFn/lightning/pull/2478)\n- Improve history export page UI\n [#2442](https://github.com/OpenFn/lightning/issues/2442)\n- When selecting a node in the workflow diagram, connected edges will also be\n highlighted [#2396](https://github.com/OpenFn/lightning/issues/2358)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix AI Assitant crashes on a job that is not saved yet\n [#2479](https://github.com/OpenFn/lightning/issues/2479)\n- Fix jumpy combobox for scope switcher\n [#2469](https://github.com/OpenFn/lightning/issues/2469)\n- Fix console errors when rending edge labels in the workflow diagram\n- Fix tooltip on export workorder button\n [#2430](https://github.com/OpenFn/lightning/issues/2430)\n\n## [v2.9.3] - 2024-09-11","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add utility module to seed a DB to support query performance analysis.\n [#2441](https://github.com/OpenFn/lightning/issues/2441)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Enhance user profile page to add a section for updating basic information\n [#2470](https://github.com/OpenFn/lightning/pull/2470)\n- Upgraded Heroicons to v2.1.5, from v2.0.18\n [#2483](https://github.com/OpenFn/lightning/pull/2483)\n- Standardize `link-uuid` style for uuid chips\n- Updated PromEx configuration to align with custom Oban naming.\n [#2488](https://github.com/OpenFn/lightning/issues/2488)\n\n## [v2.9.2] - 2024-09-09","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Temporarily limit AI to @openfn emails while testing\n [#2482](https://github.com/OpenFn/lightning/pull/2482)\n\n## [v2.9.1] - 2024-09-09","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Provisioner creates invalid snapshots when doing CLI deploy\n [#2461](https://github.com/OpenFn/lightning/issues/2461)\n [#2460](https://github.com/OpenFn/lightning/issues/2460)\n\n > This is a fix for future Workflow updates that are deployed by the CLI and\n > Github integrations. Unfortunately, there is a high likelihood that your\n > existing snapshots could be incorrect (e.g. missing steps, missing edges).\n > In order to fix this, you will need to manually create new snapshots for\n > each of your workflows. This can be done either by modifying the workflow in\n > the UI and saving it. Or running a command on the running instance:\n >\n > ```elixir\n > alias Lightning.Repo\n > alias Lightning.Workflows.{Workflow, Snapshot}\n >\n > Repo.transaction(fn ->\n > snapshots =\n > Repo.all(Workflow)\n > |> Enum.map(&Workflow.touch/1)\n > |> Enum.map(&Repo.update!/1)\n > |> Enum.map(fn workflow ->\n > {:ok, snapshot} = Snapshot.create(workflow)\n > snapshot\n > end)\n >\n > {:ok, snapshots}\n > end)\n > ```\n\n## [v2.9.0] - 2024-09-06","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Limit AI queries and hook the increment of AI queries to allow usage limiting.\n [#2438](https://github.com/OpenFn/lightning/pull/2438)\n- Persist AI Assistant conversations and enable it for all users\n [#2296](https://github.com/OpenFn/lightning/issues/2296)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Rename `new_table` component to `table`.\n [#2448](https://github.com/OpenFn/lightning/pull/2448)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix `workflow_id` presence in state.json during Github sync\n [#2445](https://github.com/OpenFn/lightning/issues/2445)\n\n## [v2.8.2] - 2024-09-04","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Change navbar colors depending on scope.\n [#2449](https://github.com/OpenFn/lightning/pull/2449)\n- Add support for configurable idle connection timeouts via the `IDLE_TIMEOUT`\n environment variable. [#2443](https://github.com/OpenFn/lightning/issues/2443)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Allow setup_user command to be execute from outside the container with\n `/app/bin/lightning eval Lightning.Setup.setup_user/3`\n- Implement a combo-box to make navigating between projects easier\n [#241](https://github.com/OpenFn/lightning/pull/2424)\n- Updated vulnerable version of micromatch.\n [#2454](https://github.com/OpenFn/lightning/issues/2454)\n\n## [v2.8.1] - 2024-08-28","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Improve run claim query by removing extraneous sorts\n [#2431](https://github.com/OpenFn/lightning/issues/2431)\n\n## [v2.8.0] - 2024-08-27","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Users are now able to export work orders, runs, steps, logs, and dataclips\n from the History page.\n [#1698](https://github.com/OpenFn/lightning/issues/1698)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Add index over `run_id` and `step_id` in run_steps to improve worker claim\n speed. [#2428](https://github.com/OpenFn/lightning/issues/2428)\n- Show Github Error messages as they are to help troubleshooting\n [#2156](https://github.com/OpenFn/lightning/issues/2156)\n- Allow `Setup_utils.setup_user` to be used for the initial superuser creation.\n- Update to code assist in the Job Editor to import namespaces from adaptors.\n [#2432](https://github.com/OpenFn/lightning/issues/2432)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Unable to remove/reconnect github app in lightning after uninstalling directly\n from Github [#2168](https://github.com/OpenFn/lightning/issues/2168)\n- Github sync buttons available even when usage limiter returns error\n [PR#2390](https://github.com/OpenFn/lightning/pull/2390)\n- Fix issue with the persisting of a Kafka message with headers.\n [#2402](https://github.com/OpenFn/lightning/issues/2402)\n- Protect against race conditions when updating partition timestamps for a Kafka\n trigger. [#2378](https://github.com/OpenFn/lightning/issues/2378)\n\n## [v2.7.19] - 2024-08-19","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Pass the user_id param on check usage limits.\n [#2387](https://github.com/OpenFn/lightning/issues/2387)\n\n## [v2.7.18] - 2024-08-17","ref":"changelog.html#added"},{"type":"extras","title":"Added - Changelog","doc":"- Ensure that all users in an instance have a confirmed email address within 48\n hours [#2389](https://github.com/OpenFn/lightning/issues/2389)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Ensure that all the demo accounts are confirmed by default\n [#2395](https://github.com/OpenFn/lightning/issues/2395)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Removed all Kafka trigger code that ensured that message sequence is honoured\n for messages with keys. Functionality to ensure that message sequence is\n honoured will be added in the future, but in an abstraction that is a better\n fit for the current Lightning design.\n [#2362](https://github.com/OpenFn/lightning/issues/2362)\n- Dropped the `trigger_kafka_messages` table that formed part of the Kafka\n trigger implementation, but which is now obsolete given the removal of the\n code related to message sequence preservation.\n [#2362](https://github.com/OpenFn/lightning/issues/2362)\n\n## [v2.7.17] - 2024-08-14","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added an `iex` command to setup a user, an apiToken, and credentials so that\n it's possible to get a fully running lightning instance via external shell\n script. (This is a tricky requirement for a distributed set of local\n deployments) [#2369](https://github.com/OpenFn/lightning/issues/2369) and\n [#2373](https://github.com/OpenFn/lightning/pull/2373)\n- Added support for _very basic_ project-credential management (add, associate\n with job) via provisioning API.\n [#2367](https://github.com/OpenFn/lightning/issues/2367)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Enforced uniqueness on credential names _by user_.\n [#2371](https://github.com/OpenFn/lightning/pull/2371)\n- Use Swoosh to format User models into recipients\n [#2374](https://github.com/OpenFn/lightning/pull/2374)\n- Bump default CLI to `@openfn/cli@1.8.1`","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- When a Workflow is deleted, any associated Kafka trigger pipelines will be\n stopped and deleted. [#2379](https://github.com/OpenFn/lightning/issues/2379)\n\n## [v2.7.16] - 2024-08-07","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- @ibrahimwickama fixed issue that prevented users from creating new workflows\n if they are running in an `http` environment (rather than `localhost` or\n `https`). [#2365](https://github.com/OpenFn/lightning/pull/2356)\n\n## [v2.7.15] - 2024-08-07","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Kafka messages without keys are synchronously converted into a Workorder,\n Dataclip and Run. Messages with keys are stored as TriggerKafkaMessage\n records, however the code needed to process them has been disabled, pending\n removal. [#2351](https://github.com/OpenFn/lightning/issues/2351)\n\n## [v2.7.14] - 2024-08-05","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Use standard styles for link, fix home button in breadcrumbs\n [#2354](https://github.com/OpenFn/lightning/pull/2354)\n\n## [v2.7.13] - 2024-08-05","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Don't log 406 Not Acceptable errors to Sentry\n [#2350](https://github.com/OpenFn/lightning/issues/2350)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Correctly handle floats in LogMessage\n [#2348](https://github.com/OpenFn/lightning/issues/2348)\n\n## [v2.7.12] - 2024-07-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Make root layout configurable\n [#2310](https://github.com/OpenFn/lightning/pull/2310)\n- Use snapshots when initiating Github Sync\n [#1827](https://github.com/OpenFn/lightning/issues/1827)\n- Move runtime logic into module\n [#2338](https://github.com/OpenFn/lightning/pull/2338)\n- Use `AccountHook Extension` to register new users invited in a project\n [#2341](https://github.com/OpenFn/lightning/pull/2341)\n- Standardized top bars across the UI with a navigable breadcrumbs interface\n [#2299](https://github.com/OpenFn/lightning/pull/2299)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Limit frame size of worker socket connections\n [#2339](https://github.com/OpenFn/lightning/issues/2339)\n- Limit number of days to 31 in cron trigger dropdown\n [#2331](https://github.com/OpenFn/lightning/issues/2331)\n\n## [v2.7.11] - 2024-07-26","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Expose more Kafka configuration at instance-level.\n [#2329](https://github.com/OpenFn/lightning/issues/2329)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Table action css tweaks\n [#2333](https://github.com/OpenFn/lightning/issues/2333)\n\n## [v2.7.10]","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- A rudimentary optimisation for Kafka messages that do not have a key as the\n sequence of these messages can not be guaranteed.\n [#2323](https://github.com/OpenFn/lightning/issues/2323)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix an intermittent bug when trying to intern Kafka offset reset policy.\n [#2327](https://github.com/OpenFn/lightning/issues/2327)\n\n## [v2.7.9] - 2024-07-24","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- CSS - standardized some more tailwind components\n [PR#2324](https://github.com/OpenFn/lightning/pull/2324)\n\n## [v2.7.8] - 2024-07-24","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Enable End to End Integration tests\n [#2187](https://github.com/OpenFn/lightning/issues/2187)\n- Make selected Kafka trigger parameters configurable via ENV vars.\n [#2315](https://github.com/OpenFn/lightning/issues/2315)\n- Use the Oauth2 `revocation_endpoint` to revoke token access (1) before\n attempting to reauthorize and (2) when users schedule a credential for\n deletion [#2314](https://github.com/OpenFn/lightning/issues/2314)\n- Standardized tailwind alerts\n [#2314](https://github.com/OpenFn/lightning/issues/2314)\n- Standardized `link` tailwind style (and provided `link-plain`, `link-info`,\n `link-error`, and `link-warning`)\n [#2314](https://github.com/OpenFn/lightning/issues/2314)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix work order URL in failure alerts\n [#2305](https://github.com/OpenFn/lightning/pull/2305)\n- Fix error when handling existing encrypted credentials\n [#2316](https://github.com/OpenFn/lightning/issues/2316)\n- Fix job editor switches to the snapshot version when body is changed\n [#2306](https://github.com/OpenFn/lightning/issues/2306)\n- Fix misaligned \"Retry from here\" button on inspector page\n [#2308](https://github.com/OpenFn/lightning/issues/2308)\n\n## [v2.7.7] - 2024-07-18","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add experimental support for triggers that consume message from a Kafka\n cluster [#1801](https://github.com/OpenFn/lightning/issues/1801)\n- Workflows can now specify concurrency, allowing runs to be executed\n syncronously or to a maximum concurrency level. Note that this applies to the\n default FifoRunQueue only.\n [#2022](https://github.com/OpenFn/lightning/issues/2022)\n- Invite Non-Registered Users to a Project\n [#2288](https://github.com/OpenFn/lightning/pull/2288)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Make modal close events configurable\n [#2298](https://github.com/OpenFn/lightning/issues/2298)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Prevent Oauth credentials from being created if they don't have a\n `refresh_token` [#2289](https://github.com/OpenFn/lightning/pull/2289) and\n send more helpful error data back to the worker during token refresh failure\n [#2135](https://github.com/OpenFn/lightning/issues/2135)\n- Fix CLI deploy not creating snapshots for workflows\n [#2271](https://github.com/OpenFn/lightning/issues/2271)\n\n## [v2.7.6] - 2024-07-11","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- UsageTracking crons are enabled again (if config is enabled)\n [#2276](https://github.com/OpenFn/lightning/issues/2276)\n- UsageTracking metrics absorb the fact that a step's job_id may not currently\n exist when counting unique jobs\n [#2279](https://github.com/OpenFn/lightning/issues/2279)\n- Adjusted layout and text displayed when preventing simultaneous edits to\n accommodate more screen sizes\n [#2277](https://github.com/OpenFn/lightning/issues/2277)\n\n## [v2.7.5] - 2024-07-10","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Prevent two editors from making changes to the same workflow at the same time\n [#1949](https://github.com/OpenFn/lightning/issues/1949)\n- Moved the Edge Condition Label field to the top of the form, so it's always\n visible [#2236](https://github.com/OpenFn/lightning/pull/2236)\n- Update edge condition labels in the Workflow Diagram to always show the\n condition type icon and the label\n [#2236](https://github.com/OpenFn/lightning/pull/2236)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Do Not Require Lock Version In URL Parameters\n [#2267](https://github.com/OpenFn/lightning/pull/2267)\n- Trim erroneous spaces on user first and last names\n [#2269](https://github.com/OpenFn/lightning/pull/2269)\n\n## [v2.7.4] - 2024-07-06","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- When the entire log string is a valid JSON object, pretty print it with a\n standard `JSON.stringify(str, null, 2)` but if it's something else then let\n the user do whatever they want (e.g., if you write\n `console.log('some', 'cool', state.data)` we won't mess with it.)\n [#2260](https://github.com/OpenFn/lightning/pull/2260)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed sticky toggle button for switching between latest version and a snapshot\n of a workflow [#2264](https://github.com/OpenFn/lightning/pull/2264)\n\n## [v2.7.3] - 2024-07-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped the ws-worker to v1.3","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix issue when selecting different steps in RunViewer and the parent liveview\n not being informed [#2253](https://github.com/OpenFn/lightning/issues/2253)\n- Stopped inspector from crashing when looking for a step by a run/job\n combination [#2201](https://github.com/OpenFn/lightning/issues/2201)\n- Workflow activation only considers new and changed workflows\n [#2237](https://github.com/OpenFn/lightning/pull/2237)\n\n## [v2.7.2] - 2024-07-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Allow endpoint plugs to be injected at compile time.\n [#2248](https://github.com/OpenFn/lightning/pull/2248)\n- All models to use the `public` schema.\n [#2249](https://github.com/OpenFn/lightning/pull/2249)\n- In the workflow diagram, smartly update the view when adding new nodes\n [#2174](https://github.com/OpenFn/lightning/issues/2174)\n- In the workflow diagram, remove the \"autofit\" toggle in the control bar","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Remove prompt parameter from the authorization URL parameters for the Generic\n Oauth Clients [#2250](https://github.com/OpenFn/lightning/issues/2250)\n- Fixed react key error [#2233](https://github.com/OpenFn/lightning/issues/2233)\n- Show common functions in the Docs panel\n [#1733](https://github.com/OpenFn/lightning/issues/1733)\n\n## [v2.7.1] - 2024-07-01","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Update email copies [#2213](https://github.com/OpenFn/lightning/issues/2213)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix jumpy cursor in the Job editor.\n [#2229](https://github.com/OpenFn/lightning/issues/2229)\n- Rework syncing behaviour to prevent changes getting thrown out on a socket\n reconnect. [#2007](https://github.com/OpenFn/lightning/issues/2007)\n\n## [v2.7.0] - 2024-06-26","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Use of snapshots for displaying runs and their associated steps in the History\n page. [#1825](https://github.com/OpenFn/lightning/issues/1825)\n- Added view-only mode for rendering workflows and runs in the Workflow Canvas\n and the Inspector page using snapshots, with the option to switch between a\n specific snapshot version and the latest version. Edit mode is available when\n displaying the latest version.\n [#1843](https://github.com/OpenFn/lightning/issues/1843)\n- Allow users to delete steps sssociated with runs in the Workflow Canvas\n [#2027](https://github.com/OpenFn/lightning/issues/2027)\n- Link to adaptor `/src` from inspector.\n- Prototype AI Assistant for working with job code.\n [#2193](https://github.com/OpenFn/lightning/issues/2193)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Reverted behaviour on \"Rerun from here\" to select the Log tab.\n [#2202](https://github.com/OpenFn/lightning/issues/2202)\n- Don't allow connections between an orphaned node and a\n Trigger[#2188](https://github.com/OpenFn/lightning/issues/2188)\n- Reduce the minimum zoom in the workflow diagram\n [#2214](https://github.com/OpenFn/lightning/issues/2214)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix some adaptor docs not displaying\n [#2019](https://github.com/OpenFn/lightning/issues/2019)\n- Fix broken `mix lightning.install_adaptor_icons` task due to addition of Finch\n http client change.\n\n## [v2.6.3] - 2024-06-19","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Added a notice on application start about anonymous public impact reporting\n and its importance for the sustainability of\n [Digital Public Goods](https://digitalpublicgoods.net/) and\n [Digital Public Infrastructure](https://www.codevelop.fund/insights-1/what-is-digital-public-infrastructure).\n- Increase default `WORKER_MAX_RUN_DURATION_SECONDS` to 300 to match the\n [ws-worker default](https://github.com/OpenFn/kit/blob/main/packages/ws-worker/src/util/cli.ts#L149-L153)\n so if people don't set their timeout via ENV, at least the two match up.\n\n## [v2.6.2] - 2024-06-13","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix vanishing Docs panel when Editor panel is collapsed and opened again\n [#2195](https://github.com/OpenFn/lightning/issues/2195)\n- Maintain tab when RunViewer remounts/push state drops tab hash\n [#2199](https://github.com/OpenFn/lightning/issues/2199)\n\n## [v2.6.1] - 2024-06-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Erlang to 26.2.5\n- Update debian bookworm from 20240130 to 20240513.\n- Return 403s when Provisioning API fails because of usage limits\n [#2182](https://github.com/OpenFn/lightning/pull/2182)\n- Update email notification for changing retention period\n [#2066](https://github.com/OpenFn/lightning/issues/2066)\n- Return 415s when Webhooks are sent Content-Types what are not supported.\n [#2180](https://github.com/OpenFn/lightning/issues/2180)\n- Updated the default step text","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Rewrite TabSelector (now Tabbed) components fixing a number of navigation\n issues [#2051](https://github.com/OpenFn/lightning/issues/2051)\n\n## [v2.6.0] - 2024-06-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Support multiple edges leading to the same step (a.k.a., \"drag & drop\")\n [#2008](https://github.com/OpenFn/lightning/issues/2008)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"## [v2.5.5] - 2024-06-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Replace LiveView Log Viewer component with React Monaco\n [#1863](https://github.com/OpenFn/lightning/issues/1863)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Bump default CLI to `@openfn/cli@1.3.2`\n- Don't show deprecated adaptor versions in the adaptor version picklist (to be\n followed by some graceful deprecation handling/warning in\n [later work](https://github.com/OpenFn/lightning/issues/2172))\n [#2169](https://github.com/OpenFn/lightning/issues/2169)\n- Refactor count workorders to reuse search code\n [#2121](https://github.com/OpenFn/lightning/issues/2121)\n- Updated provisioning error message to include workflow and job names\n [#2140](https://github.com/OpenFn/lightning/issues/2140)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Don't let two deploy workflows run at the same time to prevent git collisions\n [#2044](https://github.com/OpenFn/lightning/issues/2044)\n- Stopped sending emails when creating a starter project\n [#2161](https://github.com/OpenFn/lightning/issues/2161)\n\n## [v2.5.4] - 2024-05-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- CORS support [#2157](https://github.com/OpenFn/lightning/issues/2157)\n- Track users emails preferences\n [#2163](https://github.com/OpenFn/lightning/issues/2163)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Change Default Text For New Job Nodes\n [#2014](https://github.com/OpenFn/lightning/pull/2014)\n- Persisted run options when runs are _created_, not when they are _claimed_.\n This has the benefit of \"locking in\" the behavior desired by the user at the\n time they demand a run, not whenever the worker picks it up.\n [#2085](https://github.com/OpenFn/lightning/pull/2085)\n- Made `RUN_GRACE_PERIOD_SECONDS` a configurable ENV instead of 20% of the\n `WORKER_MAX_RUN_DURATION`\n [#2085](https://github.com/OpenFn/lightning/pull/2085)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Stopped Janitor from calling runs lost if they have special runtime options\n [#2079](https://github.com/OpenFn/lightning/issues/2079)\n- Dataclip Viewer now responds to page resize and internal page layout\n [#2120](https://github.com/OpenFn/lightning/issues/2120)\n\n## [v2.5.3] - 2024-05-27","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Stop users from creating deprecated Salesforce and GoogleSheets credentials.\n [#2142](https://github.com/OpenFn/lightning/issues/2142)\n- Delegate menu customization and create menu components for reuse.\n [#1988](https://github.com/OpenFn/lightning/issues/1988)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Disable Credential Save Button Until All Form Fields Are Validated\n [#2099](https://github.com/OpenFn/lightning/issues/2099)\n- Fix Credential Modal Closure Error When Workflow Is Unsaved\n [#2101](https://github.com/OpenFn/lightning/pull/2101)\n- Fix error when socket reconnects and user is viewing a run via the inspector\n [#2148](https://github.com/OpenFn/lightning/issues/2148)\n\n## [v2.5.2] - 2024-05-23","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Preserve custom values (like `apiVersion`) during token refresh for OAuth2\n credentials [#2131](https://github.com/OpenFn/lightning/issues/2131)\n\n## [v2.5.1] - 2024-05-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Don't compile Phoenix Storybook in production and test environments\n [#2119](https://github.com/OpenFn/lightning/pull/2119)\n- Improve performance and memory consumption on queries and logic for digest\n mailer [#2121](https://github.com/OpenFn/lightning/issues/2121)\n\n## [v2.5.0] - 2024-05-20","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- When a refresh token is updated, save it!\n [#2124](https://github.com/OpenFn/lightning/pull/2124)\n\n## [v2.5.0-pre4] - 2024-05-20","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix duplicate credential type bug\n [#2100](https://github.com/OpenFn/lightning/issues/2100)\n- Ensure Global OAuth Clients Accessibility for All Users\n [#2114](https://github.com/OpenFn/lightning/issues/2114)\n\n## [v2.5.0-pre3] - 2024-05-20","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix credential not added automatically after being created from the canvas.\n [#2105](https://github.com/OpenFn/lightning/issues/2105)\n- Replace the \"not working?\" prompt by \"All good, but if your credential stops\n working, you may need to re-authorize here.\".\n [#2102](https://github.com/OpenFn/lightning/issues/1872)\n- Fix Generic Oauth credentials don't get included in the refresh flow\n [#2106](https://github.com/OpenFn/lightning/pull/2106)\n\n## [v2.5.0-pre2] - 2024-05-17","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Replace LiveView Dataclip component with React Monaco bringing large\n performance improvements when viewing large dataclips.\n [#1872](https://github.com/OpenFn/lightning/issues/1872)\n\n## [v2.5.0-pre] - 2024-05-17","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow users to build Oauth clients and associated credentials via the user\n interface. [#1919](https://github.com/OpenFn/lightning/issues/1919)\n\n## [v2.4.14] - 2024-05-16","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Refactored image and version info\n [#2097](https://github.com/OpenFn/lightning/pull/2097)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed issue where updating adaptor name and version of job node in the\n workflow canvas crashes the app when no credential is selected\n [#99](https://github.com/OpenFn/lightning/issues/99)\n- Removes stacked viewer after switching tabs and steps.\n [#2064](https://github.com/OpenFn/lightning/issues/2064)\n\n## [v2.4.13] - 2024-05-16","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed issue where updating an existing Salesforce credential to use a\n `sandbox` endpoint would not properly re-authenticate.\n [#1842](https://github.com/OpenFn/lightning/issues/1842)\n- Navigate directly to settings from url hash and renders default panel when\n there is no hash. [#1971](https://github.com/OpenFn/lightning/issues/1971)\n\n## [v2.4.12] - 2024-05-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix render settings default panel on first load\n [#1971](https://github.com/OpenFn/lightning/issues/1971)\n\n## [v2.4.11] - 2024-05-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Upgraded Sentry to v10 for better error reporting.\n\n## [v2.4.10] - 2024-05-14","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix the \"reset demo\" script by disabling the emailing that was introduced to\n the `create_project` function.\n [#2063](https://github.com/OpenFn/lightning/pull/2063)\n\n## [v2.4.9] - 2024-05-14","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped @openfn/ws-worker to 1.1.8","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Correctly pass max allowed run time into the Run token, ensuring it's valid\n for the entirety of the Runs execution time\n [#2072](https://github.com/OpenFn/lightning/issues/2072)\n\n## [v2.4.8] - 2024-05-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add Github sync to usage limiter\n [#2031](https://github.com/OpenFn/lightning/pull/2031)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Remove illogical cancel buttons on user/pass change screen\n [#2067](https://github.com/OpenFn/lightning/issues/2067)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Stop users from configuring failure alerts when the limiter returns error\n [#2076](https://github.com/OpenFn/lightning/pull/2076)\n\n## [v2.4.7] - 2024-05-11","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed early worker token expiry bug\n [#2070](https://github.com/OpenFn/lightning/issues/2070)\n\n## [v2.4.6] - 2024-05-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow for automatic resubmission of failed usage tracking report submissions.\n [1789](https://github.com/OpenFn/lightning/issues/1789)\n- Make signup feature configurable\n [#2049](https://github.com/OpenFn/lightning/issues/2049)\n- Apply runtime limits to worker execution\n [#2015](https://github.com/OpenFn/lightning/pull/2015)\n- Limit usage for failure alerts\n [#2011](https://github.com/OpenFn/lightning/pull/2011)\n\n## [v2.4.5] - 2024-05-07","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix provioning API calls workflow limiter without the project ID\n [#2057](https://github.com/OpenFn/lightning/issues/2057)\n\n## [v2.4.4] - 2024-05-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Benchmarking script that simulates data from a cold chain.\n [#1993](https://github.com/OpenFn/lightning/issues/1993)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Changed Snapshot `get_or_create_latest_for` to accept multis allow controlling\n of which repo it uses.\n- Require exactly one owner for each project\n [#1991](https://github.com/OpenFn/lightning/issues/1991)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed issue preventing credential updates\n [#1861](https://github.com/OpenFn/lightning/issues/1861)\n\n## [v2.4.3] - 2024-05-01","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow menu items customization\n [#1988](https://github.com/OpenFn/lightning/issues/1988)\n- Workflow Snapshot support\n [#1822](https://github.com/OpenFn/lightning/issues/1822)\n- Fix sample workflow from init_project_for_new_user\n [#2016](https://github.com/OpenFn/lightning/issues/2016)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped @openfn/ws-worker to 1.1.6","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Assure workflow is always passed to Run.enqueue\n [#2032](https://github.com/OpenFn/lightning/issues/2032)\n- Fix regression on History page where snapshots were not preloaded correctly\n [#2026](https://github.com/OpenFn/lightning/issues/2026)\n\n## [v2.4.2] - 2024-04-24","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix missing credential types when running Lightning using Docker\n [#2010](https://github.com/OpenFn/lightning/issues/2010)\n- Fix provisioning API includes deleted workflows in project state\n [#2001](https://github.com/OpenFn/lightning/issues/2001)\n\n## [v2.4.1] - 2024-04-19","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix github cli deploy action failing to auto-commit\n [#1995](https://github.com/OpenFn/lightning/issues/1995)\n\n## [v2.4.1-pre] - 2024-04-18","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add custom metric to track the number of finalised runs.\n [#1790](https://github.com/OpenFn/lightning/issues/1790)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Set better defaults for the GitHub connection creation screen\n [#1994](https://github.com/OpenFn/lightning/issues/1994)\n- Update `submission_status` for any Usagetracking.Report that does not have it\n set. [#1789](https://github.com/OpenFn/lightning/issues/1789)\n\n## [v2.4.0] - 2024-04-12","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow description below the page title\n [#1975](https://github.com/OpenFn/lightning/issues/1975)\n- Enable users to connect projects to their Github repos and branches that they\n have access to [#1895](https://github.com/OpenFn/lightning/issues/1895)\n- Enable users to connect multiple projects to a single Github repo\n [#1811](https://github.com/OpenFn/lightning/issues/1811)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Change all System.get_env calls in runtime.exs to use dotenvy\n [#1968](https://github.com/OpenFn/lightning/issues/1968)\n- Track usage tracking submission status in new field\n [#1789](https://github.com/OpenFn/lightning/issues/1789)\n- Send richer version info as part of usage tracking submission.\n [#1819](https://github.com/OpenFn/lightning/issues/1819)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix sync to branch only targetting main branch\n [#1892](https://github.com/OpenFn/lightning/issues/1892)\n- Fix enqueue run without the workflow info\n [#1981](https://github.com/OpenFn/lightning/issues/1981)\n\n## [v2.3.1] - 2024-04-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Run the usage tracking submission job more frequently to reduce the risk of\n Oban unavailability at a particular time.\n [#1778](https://github.com/OpenFn/lightning/issues/1778)\n- Remove code supporting V1 usage tracking submissions.\n [#1853](https://github.com/OpenFn/lightning/issues/1853)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix scrolling behaviour on inspector for small screens\n [#1962](https://github.com/OpenFn/lightning/issues/1962)\n- Fix project picker for users with many projects\n [#1952](https://github.com/OpenFn/lightning/issues/1952)\n\n## [v2.3.0] - 2024-04-02","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Support for additional paths on a webhook URL such as `/i/ /Patient`\n [#1954](https://github.com/OpenFn/lightning/issues/1954)\n- Support for a GET endpoint to \"check\" webhook URL availability\n [#1063](https://github.com/OpenFn/lightning/issues/1063)\n- Allow external apps to control the run enqueue db transaction\n [#1958](https://github.com/OpenFn/lightning/issues/1958)\n\n## [v2.2.2] - 2024-04-01","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Changed dataclip search from string `LIKE` to tsvector on keys and values.\n While this will limit partial string matching to the beginning of words (not\n the middle or end) it will make searching way more performant\n [#1939](https://github.com/OpenFn/lightning/issues/1939)\n- Translate job error messages using errors.po file\n [#1935](https://github.com/OpenFn/lightning/issues/1935)\n- Improve the UI/UX of the run panel on the inspector for small screens\n [#1909](https://github.com/OpenFn/lightning/issues/1909)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Regular database timeouts when searching across dataclip bodies\n [#1794](https://github.com/OpenFn/lightning/issues/1794)\n\n## [v2.2.1] - 2024-03-27","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Enable users to connect to their Github accounts in preparation for\n streamlined GitHub project sync setup\n [#1894](https://github.com/OpenFn/lightning/issues/1894)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Apply usage limit to bulk-reruns\n [#1931](https://github.com/OpenFn/lightning/issues/1931)\n- Fix edge case that could result in duplicate usage tracking submissions.\n [#1853](https://github.com/OpenFn/lightning/issues/1853)\n- Fix query timeout issue on history retention deletion\n [#1937](https://github.com/OpenFn/lightning/issues/1937)\n\n## [v2.2.0] - 2024-03-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow admins to set project retention periods\n [#1760](https://github.com/OpenFn/lightning/issues/1760)\n- Automatically wipe input/output data after their retention period\n [#1762](https://github.com/OpenFn/lightning/issues/1762)\n- Automatically delete work order history after their retention period\n [#1761](https://github.com/OpenFn/lightning/issues/1761)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- When automatically creating a project for a newly registered user (via the\n `INIT_PROJECT_FOR_NEW_USER=true` environment variable) that user should be the\n `owner` of the project.\n [#1927](https://github.com/OpenFn/lightning/issues/1927)\n- Give priority to manual runs (over webhook requests and cron) so that active\n users on the inspector don't have to wait ages for thier work during high load\n periods [#1918](https://github.com/OpenFn/lightning/issues/1918)\n\n## [v2.1.0] - 2024-03-20","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- TSVector index to log_lines, and gin index to dataclips\n [#1898](https://github.com/OpenFn/lightning/issues/1898)\n- Add API Version field to Salesforce OAuth credentials\n [#1838](https://github.com/OpenFn/lightning/issues/1838)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Replace v1 usage tracking with v2 usage tracking.\n [#1853](https://github.com/OpenFn/lightning/issues/1853)\n\n## [v2.0.10]","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Updated anonymous usage tracker submissions\n [#1853](https://github.com/OpenFn/lightning/issues/1853)\n\n## [v2.0.9] - 2024-03-19","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Support for smaller screens on history and inspector.\n [#1908](https://github.com/OpenFn/lightning/issues/1908)\n- Polling metric to track number of available runs.\n [#1790](https://github.com/OpenFn/lightning/issues/1790)\n- Allows limiting creation of new runs and retries.\n [#1754](https://github.com/OpenFn/Lightning/issues/1754)\n- Add specific messages for log, input, and output tabs when a run is lost\n [#1757](https://github.com/OpenFn/lightning/issues/1757)\n- Soft and hard limits for runs created by webhook trigger.\n [#1859](https://github.com/OpenFn/Lightning/issues/1859)\n- Publish an event when a new user is registered\n [#1873](https://github.com/OpenFn/lightning/issues/1873)\n- Adds ability to add project collaborators from existing users\n [#1836](https://github.com/OpenFn/lightning/issues/1836)\n- Added ability to remove project collaborators\n [#1837](https://github.com/OpenFn/lightning/issues/1837)\n- Added new usage tracking submission code.\n [#1853](https://github.com/OpenFn/lightning/issues/1853)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Upgrade Elixir to 1.16.2\n- Remove all values from `.env.example`.\n [#1904](https://github.com/OpenFn/lightning/issues/1904)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Verify only stale project credentials\n [#1861](https://github.com/OpenFn/lightning/issues/1861)\n\n## [v2.0.8] - 2024-02-29","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Show flash error when editing stale project credentials\n [#1795](https://github.com/OpenFn/lightning/issues/1795)\n- Fixed bug with Github sync installation on docker-based deployments\n [#1845](https://github.com/OpenFn/lightning/issues/1845)\n\n## [v2.0.6] - 2024-02-29","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Automatically create Github workflows in a target repository/branch when users\n set up a Github repo::OpenFn project sync\n [#1046](https://github.com/OpenFn/lightning/issues/1046)\n- Allows limiting creation of new runs and retries.\n [#1754](https://github.com/OpenFn/Lightning/issues/1754)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Change bucket size used by the run queue delay custom metric.\n [#1790](https://github.com/OpenFn/lightning/issues/1790)\n- Require setting `IS_RESETTABLE_DEMO` to \"yes\" via ENV before allowing the\n destructive `Demo.reset_demo/0` function from being called.\n [#1720](https://github.com/OpenFn/lightning/issues/1720)\n- Remove version display condition that was redundant due to shadowing\n [#1819](https://github.com/OpenFn/lightning/issues/1819)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix series of sentry issues related to OAuth credentials\n [#1799](https://github.com/OpenFn/lightning/issues/1799)\n\n## [v2.0.5] - 2024-02-25","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed error in Credentials without `sanbox` field set; only display `sandbox`\n field for Salesforce oauth credentials.\n [#1798](https://github.com/OpenFn/lightning/issues/1798)\n\n## [v2.0.4] - 2024-02-24","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Display and edit OAuth credentials\n scopes[#1706](https://github.com/OpenFn/Lightning/issues/1706)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Stop sending `operating_system_detail` to the usage tracker\n [#1785](https://github.com/OpenFn/lightning/issues/1785)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Make handling of usage tracking errors more robust.\n [#1787](https://github.com/OpenFn/lightning/issues/1787)\n- Fix inspector shows selected dataclip as wiped after retying workorder from a\n non-first step [#1780](https://github.com/OpenFn/lightning/issues/1780)\n\n## [v2.0.3] - 2024-02-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Actual metrics will now be submitted by Lightning to the Usage Tracker.\n [#1742](https://github.com/OpenFn/lightning/issues/1742)\n- Added a support link to the menu that goes to the instance admin contact\n [#1783](https://github.com/OpenFn/lightning/issues/1783)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Usage Tracking submissions are now opt-out, rather than opt-in. Hashed UUIDs\n to ensure anonymity are default.\n [#1742](https://github.com/OpenFn/lightning/issues/1742)\n- Usage Tracking submissions will now run daily rather than hourly.\n [#1742](https://github.com/OpenFn/lightning/issues/1742)\n\n- Bumped @openfn/ws-worker to `v1.0` (this is used in dev mode when starting the\n worker from your mix app: `RTM=true iex -S mix phx.server`)\n- Bumped @openfn/cli to `v1.0` (this is used for adaptor docs and magic)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Non-responsive workflow canvas after web socket disconnection\n [#1750](https://github.com/OpenFn/lightning/issues/1750)\n\n## [v2.0.2] - 2024-02-14","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed a bug with the OAuth2 credential refresh flow that prevented\n GoogleSheets jobs from running after token expiration\n [#1735](https://github.com/OpenFn/Lightning/issues/1735)\n\n## [v2.0.1] - 2024-02-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Renamed ImpactTracking to UsageTracking\n [#1729](https://github.com/OpenFn/lightning/issues/1729)\n- Block github installation if there's a pending installation in another project\n [#1731](https://github.com/OpenFn/Lightning/issues/1731)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Expand work order button balloons randomly\n [#1737](https://github.com/OpenFn/Lightning/issues/1737)\n- Editing credentials doesn't work from project scope\n [#1743](https://github.com/OpenFn/Lightning/issues/1743)\n\n## [v2.0.0] - 2024-02-10\n\n> At the time of writing there are no more big changes planned and testing has\n> gone well. Thanks to everyone who's helped to kick the tyres during the \"rc\"\n> phase. There are still a _lot of **new features** coming_, so please:\n>\n> - watch our [**Public Roadmap**](https://github.com/orgs/OpenFn/projects/3) to\n> stay abreast of our core team's backlog,\n> - request a feature in the\n> [**Community Forum**](https://community.openfn.org),\n> - raise a\n> [**new issue**](https://github.com/OpenFn/lightning/issues/new/choose) if\n> you spot a bug,\n> - and head over to the\n> [**Contributing**](https://github.com/OpenFn/lightning/?tab=readme-ov-file#contribute-to-this-project)\n> section to lend a hand.\n>\n> Head to [**docs.openfn.org**](https://docs.openfn.org) for product\n> documentation and help with v1 to v2 migration.","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Bump `@openfn/worker` to `v0.8.1`\n- Only show GoogleSheets and Salesforce credential options if Oauth clients are\n registered with the instance via ENV\n [#1734](https://github.com/OpenFn/Lightning/issues/1734)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Use standard table type for webhook auth methods\n [#1514](https://github.com/OpenFn/Lightning/issues/1514)\n- Make disabled button for \"Connect to GitHub\" clear, add tooltip\n [#1732](https://github.com/OpenFn/Lightning/issues/1715)\n\n## [v2.0.0-rc12] - 2024-02-09","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add RunQueue extension to allow claim customization.\n [#1715](https://github.com/OpenFn/Lightning/issues/1715)\n- Add support for Salesforce OAuth2 credentials\n [#1633](https://github.com/OpenFn/Lightning/issues/1633)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Use `PAYLOAD_SIZE_KB` in k6 load testing script, set thresholds on wait time,\n set default payload size to `2kb`","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Adds more detail to work order states on dashboard\n [#1677](https://github.com/OpenFn/lightning/issues/1677)\n- Fix Output & Logs in inspector fails to show sometimes\n [#1702](https://github.com/OpenFn/lightning/issues/1702)\n\n## [v2.0.0-rc11] - 2024-02-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Bumped Phoenix LiveView from `0.20.4` to `0.20.5` to fix canvas selection\n issue [#1724](https://github.com/OpenFn/lightning/issues/1724)\n\n## [v2.0.0-rc10] - 2024-02-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Implemented safeguards to prevent deletion of jobs with associated run history\n [#1570](https://github.com/OpenFn/Lightning/issues/1570)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed inspector dataclip body not getting updated after dataclip is wiped\n [#1718](https://github.com/OpenFn/Lightning/issues/1718)\n- Fixed work orders getting retried despite having wiped dataclips\n [#1721](https://github.com/OpenFn/Lightning/issues/1721)\n\n## [v2.0.0-rc9] 2024-02-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Persist impact tracking configuration and reports\n [#1684](https://github.com/OpenFn/Lightning/issues/1684)\n- Add zero-persistence project setting\n [#1209](https://github.com/OpenFn/Lightning/issues/1209)\n- Wipe dataclip after use when zero-persistence is enabled\n [#1212](https://github.com/OpenFn/Lightning/issues/1212)\n- Show appropriate message when a wiped dataclip is viewed\n [#1211](https://github.com/OpenFn/Lightning/issues/1211)\n- Disable selecting work orders having wiped dataclips in the history page\n [#1210](https://github.com/OpenFn/Lightning/issues/1210)\n- Hide rerun button in inspector when the selected step has a wiped dataclip\n [#1639](https://github.com/OpenFn/Lightning/issues/1639)\n- Add rate limiter to webhook endpoints and runtime limiter for runs.\n [#639](https://github.com/OpenFn/Lightning/issues/639)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Prevented secret scrubber from over-eagerly adding \\*\\*\\* between all\n characters if an empty string secret was provided as a credential field value\n (e.g., {\"username\": \"come-on-in\", \"password\": \"\"})\n [#1585](https://github.com/OpenFn/Lightning/issues/1585)\n- Fixed permissions issue that allowed viewer/editor to modify webhook auth\n methods. These permissions only belong to project owners and admins\n [#1692](https://github.com/OpenFn/Lightning/issues/1692)\n- Fixed bug that was duplicating inbound http_requests, resulting in unnecessary\n data storage [#1695](https://github.com/OpenFn/Lightning/issues/1695)\n- Fixed permissions issue that allowed editors to set up new Github connections\n [#1703](https://github.com/OpenFn/Lightning/issues/1703)\n- Fixed permissions issue that allowed viewers to initiate syncs to github\n [#1704](https://github.com/OpenFn/Lightning/issues/1704)\n- Fixed inspector view stuck at processing when following a crashed run\n [#1711](https://github.com/OpenFn/Lightning/issues/1711)\n- Fixed inspector dataclip selector not getting updated after running manual run\n [#1714](https://github.com/OpenFn/Lightning/issues/1714)\n\n## [v2.0.0-rc8] - 2024-01-30","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Shim code to interact with the Impact Tracking service\n [#1671](https://github.com/OpenFn/Lightning/issues/1671)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Standardized naming of \"attempts\" to \"runs\". This had already been done in the\n front-end, but this change cleans up the backend, the database, and the\n interface with the worker. Make sure to **run migrations** and update your\n ENV/secrets to use `WORKER_RUNS_PRIVATE_KEY` rather than\n `WORKER_ATTEMPTS_PRIVATE_KEY`\n [#1657](https://github.com/OpenFn/Lightning/issues/1657)\n- Required `@openfn/ws-worker@0.8.0` or above.\n\n## [v2.0.0-rc7] - 2024-01-26","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Store webhook request headers in Dataclips for use in jobs.\n [#1638](https://github.com/OpenFn/Lightning/issues/1638)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Display `http_request` dataclips to the user as they will be provided to the\n worker as \"input\" state to avoid confusion while writing jobs.\n [1664](https://github.com/OpenFn/Lightning/issues/1664)\n- Named-spaced all worker environment variables with `WORKER_` and added\n documentation for how to configure them.\n [#1672](https://github.com/OpenFn/Lightning/pull/1672)\n- Bumped to `@openfn/ws-worker@0.6.0`\n- Bumped to `@openfn/cli@0.4.15`","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix Run via Docker [#1653](https://github.com/OpenFn/Lightning/issues/1653)\n- Fix remaining warnings, enable \"warnings as errors\"\n [#1642](https://github.com/OpenFn/Lightning/issues/1642)\n- Fix workflow dashboard bug when viewed for newly created workflows with only\n unfinished run steps. [#1674](https://github.com/OpenFn/Lightning/issues/1674)\n\n## [v2.0.0-rc5] - 2024-01-22","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Made two significant backend changes that don't impact UI/UX but **require\n migrations** and should make Lightning developer lives easier by updating\n parts of the backend to match terms now used in the frontend:\n - Renamed the `Runs` model and table to `Steps`\n [#1571](https://github.com/OpenFn/Lightning/issues/1571)\n - Renamed the `AttemptRuns` model and table to `AttemptSteps`\n [#1571](https://github.com/OpenFn/Lightning/issues/1571)\n\n## [v2.0.0-rc4] - 2024-01-19","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Scrub output dataclips in the UI to avoid unintentional secret exposure\n [#1606](https://github.com/OpenFn/Lightning/issues/1606)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Bump to `@openfn/cli@0.4.14`\n- Do not persist the active tab setting on the job editor\n [#1504](https://github.com/OpenFn/Lightning/issues/1504)\n- Make condition label optional\n [#1648](https://github.com/OpenFn/Lightning/issues/1648)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix credential body getting leaked to sentry incase of errors\n [#1600](https://github.com/OpenFn/Lightning/issues/1600)\n- Fixed validation on Javascript edge conditions\n [#1602](https://github.com/OpenFn/Lightning/issues/1602)\n- Removed unused code from `run_live` directory\n [#1625](https://github.com/OpenFn/Lightning/issues/1625)\n- Edge condition expressions not correctly being handled during provisioning\n [#openfn/kit#560](https://github.com/OpenFn/kit/pull/560)\n\n## [v2.0.0-rc3] 2024-01-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Custom metric to track stalled attempts\n [#1559](https://github.com/OpenFn/Lightning/issues/1559)\n- Dashboard with project and workflow stats\n [#755](https://github.com/OpenFn/Lightning/issues/755)\n- Add search by ID on the history page\n [#1468](https://github.com/OpenFn/Lightning/issues/1468)\n- Custom metric to support autoscaling\n [#1607](https://github.com/OpenFn/Lightning/issues/1607)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped CLI version to `0.4.13`\n- Bumped worker version to `0.5.0`\n- Give project editors and viewers read only access to project settings instead\n [#1477](https://github.com/OpenFn/Lightning/issues/1477)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Throw an error when Lightning.MetadataService.get_adaptor_path/1 returns an\n adaptor path that is nil\n [#1601](https://github.com/OpenFn/Lightning/issues/1601)\n- Fix failure due to creating work order from a newly created job\n [#1572](https://github.com/OpenFn/Lightning/issues/1572)\n- Fixes on the dashboard and links\n [#1610](https://github.com/OpenFn/Lightning/issues/1610) and\n [#1608](https://github.com/OpenFn/Lightning/issues/1608)\n\n## [2.0.0-rc2] - 2024-01-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Restored left-alignment for step list items on run detail and inspector\n [a6e4ada](https://github.com/OpenFn/Lightning/commit/a6e4adafd558269cfd690e7c4fdd8f9fe66c5f62)\n- Inspector: fixed attempt/run language for \"skipped\" tooltip\n [fd7dd0c](https://github.com/OpenFn/Lightning/commit/fd7dd0ca8128dfba2902e5aa6a2259e2073f0f10)\n- Inspector: fixed failure to save during \"save & run\" from inspector\n [#1596](https://github.com/OpenFn/Lightning/issues/1596)\n- Inspector: fixed key bindings for save & run (retry vs. new work order)\n getting overridden when user focuses on the Monaco editor\n [#1596](https://github.com/OpenFn/Lightning/issues/1596)\n\n## [2.0.0-rc1] - 2024-01-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Why does this repo go from `v0` to `v2.0`? - Changelog","doc":"Lightning is the _2nd version_ of the OpenFn platform. While much of the core\ntechnology is the same, there are breaking changes between `v1.105` (pre-2024)\nand `v2` (\"OpenFn Lightning\").\n\nFor customers using OpenFn `v1`, a migration guide will be provided at\n[docs.openfn.org](https://docs.openfn.org)","ref":"changelog.html#why-does-this-repo-go-from-v0-to-v2-0"},{"type":"extras","title":"Added - Changelog","doc":"- Link to the job inspctor for a selected run from the history interface\n [#1524](https://github.com/OpenFn/Lightning/issues/1524)\n- Reprocess an existing work order from the job inspector by default (instead of\n always creating a new work order)\n [#1524](https://github.com/OpenFn/Lightning/issues/1524)\n- Bumped worker to support edge conditions between trigger and first job\n `\"@openfn/ws-worker\": \"^0.4.0\"`","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Updated naming to prepare for v2 release\n [#1248](https://github.com/OpenFn/Lightning/issues/1248); the major change is\n that each time a work order (the typical unit of business value for an\n organization, e.g. \"execute workflow ABC for patient 123\") is executed, it is\n called a \"run\". Previously, it was called an \"attempt\". The hierarchy is now:\n\n ```\n Build-Time: Projects > Workflows > Steps\n Run-Time: Work Orders > Runs > Steps\n ```\n\n Note the name changes here are reflected in the UI, but not all tables/models\n will be changed until [1571](https://github.com/OpenFn/Lightning/issues/1571)\n is delivered.\n\n## [v0.12.2] - 2023-12-24","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped worker to address occasional git install issue\n `\"@openfn/ws-worker\": \"^0.3.2\"`","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix RuntimeError: found duplicate ID \"google-sheets-inner-form\" for\n GoogleSheetsComponent [#1578](https://github.com/OpenFn/Lightning/issues/1578)\n- Extend export script to include new JS expression edge type\n [#1540](https://github.com/OpenFn/Lightning/issues/1540)\n- Fix regression for attempt viewer log line highlighting\n [#1589](https://github.com/OpenFn/Lightning/issues/1589)\n\n## [v0.12.1] - 2023-12-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Hide project security setting tab from non-authorized users\n [#1477](https://github.com/OpenFn/Lightning/issues/1477)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- History page crashes if job is removed from workflow after it's been run\n [#1568](https://github.com/OpenFn/Lightning/issues/1568)\n\n## [v0.12.0] - 2023-12-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add ellipsis for long job names on the canvas\n [#1217](https://github.com/OpenFn/Lightning/issues/1217)\n- Fix Credential Creation Page UI\n [#1064](https://github.com/OpenFn/Lightning/issues/1064)\n- Custom metric to track Attempt queue delay\n [#1556](https://github.com/OpenFn/Lightning/issues/1556)\n- Expand work order row when a `workorder_id` is specified in the filter\n [#1515](https://github.com/OpenFn/Lightning/issues/1515)\n- Allow Javascript expressions as conditions for edges\n [#1498](https://github.com/OpenFn/Lightning/issues/1498)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Derive dataclip in inspector from the attempt & step\n [#1551](https://github.com/OpenFn/Lightning/issues/1551)\n- Updated CLI to 0.4.10 (fixes logging)\n- Changed UserBackupToken model to use UTC timestamps (6563cb77)\n- Restore FK relationship between `work_orders` and `attempts` pending a\n decision re: further partitioning.\n [#1254](https://github.com/OpenFn/Lightning/issues/1254)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- New credential doesn't appear in inspector until refresh\n [#1531](https://github.com/OpenFn/Lightning/issues/1531)\n- Metadata not refreshing when credential is updated\n [#791](https://github.com/OpenFn/Lightning/issues/791)\n- Adjusted z-index for Monaco Editor's sibling element to resolve layout\n conflict [#1329](https://github.com/OpenFn/Lightning/issues/1329)\n- Demo script sets up example Runs with their log lines in a consistant order.\n [#1487](https://github.com/OpenFn/Lightning/issues/1487)\n- Initial credential creation `changes` show `after` as `null` rather a value\n [#1118](https://github.com/OpenFn/Lightning/issues/1118)\n- AttemptViewer flashing/rerendering when Jobs are running\n [#1550](https://github.com/OpenFn/Lightning/issues/1550)\n- Not able to create a new Job when clicking the Check icon on the placeholder\n [#1537](https://github.com/OpenFn/Lightning/issues/1537)\n- Improve selection logic on WorkflowDiagram\n [#1220](https://github.com/OpenFn/Lightning/issues/1220)\n\n## [v0.11.0] - 2023-12-06","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Improved UI when manually creating Attempts via the Job Editor\n [#1474](https://github.com/OpenFn/Lightning/issues/1474)\n- Increased the maximum inbound webhook request size to 10MB and added\n protection against _very large_ payloads with a 100MB \"max_skip_body_length\"\n [#1247](https://github.com/OpenFn/Lightning/issues/1247)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Use the internal port of the web container for the worker configuration in\n docker-compose setup. [#1485](https://github.com/OpenFn/Lightning/pull/1485)\n\n## [v0.10.6] - 2023-12-05","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Limit entries count on term work orders search\n [#1461](https://github.com/OpenFn/Lightning/issues/1461)\n- Scrub log lines using multiple credentials samples\n [#1519](https://github.com/OpenFn/Lightning/issues/1519)\n- Remove custom telemetry plumbing.\n [1259](https://github.com/OpenFn/Lightning/issues/1259)\n- Enhance UX to prevent modal closure when Monaco/Dataclip editor is focused\n [#1510](https://github.com/OpenFn/Lightning/pull/1510)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Use checkbox on boolean credential fields rather than a text input field\n [#1430](https://github.com/OpenFn/Lightning/issues/1430)\n- Allow users to retry work orders that failed before their first run was\n created [#1417](https://github.com/OpenFn/Lightning/issues/1417)\n- Fix to ensure webhook auth modal is closed when cancel or close are selected.\n [#1508](https://github.com/OpenFn/Lightning/issues/1508)\n- Enable user to reauthorize and obtain a new refresh token.\n [#1495](https://github.com/OpenFn/Lightning/issues/1495)\n- Save credential body with types declared on schema\n [#1518](https://github.com/OpenFn/Lightning/issues/1518)\n\n## [v0.10.5] - 2023-12-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Only add history page filters when needed for simpler multi-select status\n interface and shorter page URLs\n [#1331](https://github.com/OpenFn/Lightning/issues/1331)\n- Use dynamic Endpoint config only on prod\n [#1435](https://github.com/OpenFn/Lightning/issues/1435)\n- Validate schema field with any of expected values\n [#1502](https://github.com/OpenFn/Lightning/issues/1502)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix for liveview crash when token expires or gets deleted after mount\n [#1318](https://github.com/OpenFn/Lightning/issues/1318)\n- Remove two obsolete methods related to Run: `Lightning.Invocation.delete_run`\n and `Lightning.Invocation.Run.new_from`.\n [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Remove obsolete field `previous_id` from `runs` table.\n [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Fix for missing data in 'created' audit trail events for webhook auth methods\n [#1500](https://github.com/OpenFn/Lightning/issues/1500)\n\n## [v0.10.4] - 2023-11-30","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Increased History search timeout to 30s\n [#1461](https://github.com/OpenFn/Lightning/issues/1461)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Tooltip text clears later than the background\n [#1094](https://github.com/OpenFn/Lightning/issues/1094)\n- Temporary fix to superuser UI for managing project users\n [#1145](https://github.com/OpenFn/Lightning/issues/1145)\n- Fix for adding ellipses on credential info on job editor heading\n [#1428](https://github.com/OpenFn/Lightning/issues/1428)\n\n## [v0.10.3] - 2023-11-28","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Dimmed/greyed out triggers and edges on the canvas when they are disabled\n [#1464](https://github.com/OpenFn/Lightning/issues/1464)\n- Async loading on the history page to improve UX on long DB queries\n [#1279](https://github.com/OpenFn/Lightning/issues/1279)\n- Audit trail events for webhook auth (deletion method) change\n [#1165](https://github.com/OpenFn/Lightning/issues/1165)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Sort project collaborators by first name\n [#1326](https://github.com/OpenFn/Lightning/issues/1326)\n- Work orders will now be set in a \"pending\" state when retries are enqueued.\n [#1340](https://github.com/OpenFn/Lightning/issues/1340)\n- Avoid printing 2FA codes by default\n [#1322](https://github.com/OpenFn/Lightning/issues/1322)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Create new workflow button sizing regression\n [#1405](https://github.com/OpenFn/Lightning/issues/1405)\n- Google credential creation and automatic closing of oAuth tab\n [#1109](https://github.com/OpenFn/Lightning/issues/1109)\n- Exporting project breaks the navigation of the page\n [#1440](https://github.com/OpenFn/Lightning/issues/1440)\n\n## [v0.10.2] - 2023-11-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Added `max_frame_size` to the Cowboy websockets protocol options in an attempt\n to address [#1421](https://github.com/OpenFn/Lightning/issues/1421)\n\n## [v0.10.1] - 2023-11-21","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Work Order ID was not displayed properly in history page\n [#1423](https://github.com/OpenFn/Lightning/issues/1423)\n\n## [v0.10.0] - 2023-11-21","ref":"changelog.html#fixed"},{"type":"extras","title":"🚨 Breaking change warning! 🚨 - Changelog","doc":"This release will contain breaking changes as we've significantly improved both\nthe workflow building and execution systems.\n\n#### Nodes and edges\n\nBefore, workflows were represented as a list of jobs and triggers. For greater\nflexibility and control of complex workflows, we've moved towards a more robust\n\"nodes and edges\" approach. Where jobs in a workflow (a node) can be connected\nby edges.\n\nTriggers still exist, but live \"outside\" the directed acyclic graph (DAG) and\nare used to automatically create work orders and attempts.\n\nWe've provided migrations that bring `v0.9.3` workflows in line with the\n`v0.10.0` requirements.\n\n#### Scalable workers\n\nBefore, Lightning spawned child processes to execute attempts in sand-boxed\nNodeVMs on the same server. This created inefficiencies and security\nvulnerabilities. Now, the Lightning web server adds attempts to a queue and\nmultiple worker applications can pull from that queue to process work.\n\nIn dev mode, this all happens automatically and on one machine, but in most\nhigh-availability production environments the workers will be on another server.\n\nAttempts are now handled entirely by the workers, and they report back to\nLightning. Exit reasons, final attempt states, error types and error messages\nare either entirely new or handled differently now, but we have provided\nmigration scripts that will work to bring _most_ `v0.9.3` runs, attempts, and\nwork orders up to `v0.10.0`, though the granularity of `v0.9.3` states and exits\nwill be less than `v0.10.0` and the final states are not guaranteed to be\naccurate for workflows with multiple branches and leaf nodes with varying exit\nreasons.\n\nThe migration scripts can be run with a single function call in SetupUtils from\na connect `iex` session:\n\n```\nLightning.SetupUtils.approximate_state_for_attempts_and_workorders()\n```\n\nNote that (like lots of _other_ functionality in `SetupUtils`, calling this\nfunction is a destructive action and you should only do it if you've backed up\nyour data and you know what you're doing.)\n\nAs always, we recommend backing up your data before migrating. (And thanks for\nbearing with us as we move towards our first stable Lightning release.)","ref":"changelog.html#breaking-change-warning"},{"type":"extras","title":"Added - Changelog","doc":"- Fix flaky job name input behavior on error\n [#1218](https://github.com/OpenFn/Lightning/issues/1218)\n- Added a hover effect on copy and add button for adaptors examples\n [#1297](https://github.com/OpenFn/Lightning/issues/1297)\n- Migration helper code to move from `v0.9.3` to `v0.10.0` added to SetupUtils\n [#1363](https://github.com/OpenFn/Lightning/issues/1363)\n- Option to start with `RTM=false iex -S mix phx.server` for opting out of the\n dev-mode automatic runtime manager.\n- Webhook Authentication Methods database and CRUD operations\n [#1152](https://github.com/OpenFn/Lightning/issues/1152)\n- Creation and Edit of webhook webhook authentication methods UI\n [#1149](https://github.com/OpenFn/Lightning/issues/1149)\n- Add webhook authentication methods overview methods in the canvas\n [#1153](https://github.com/OpenFn/Lightning/issues/1153)\n- Add icon on the canvas for triggers that have authentication enabled\n [#1157](https://github.com/OpenFn/Lightning/issues/1157)\n- Require password/2FA code before showing password and API Key for webhook auth\n methods [#1200](https://github.com/OpenFn/Lightning/issues/1200)\n- Restrict live dashboard access to only superusers, enable DB information and\n OS information [#1170](https://github.com/OpenFn/Lightning/issues/1170) OS\n information [#1170](https://github.com/OpenFn/Lightning/issues/1170)\n- Expose additional metrics to LiveDashboard\n [#1171](https://github.com/OpenFn/Lightning/issues/1171)\n- Add plumbing to dump Lightning metrics during load testing\n [#1178](https://github.com/OpenFn/Lightning/issues/1178)\n- Allow for heavier payloads during load testing\n [#1179](https://github.com/OpenFn/Lightning/issues/1179)\n- Add dynamic delay to help mitigate flickering test\n [#1195](https://github.com/OpenFn/Lightning/issues/1195)\n- Add a OpenTelemetry trace example\n [#1189](https://github.com/OpenFn/Lightning/issues/1189)\n- Add plumbing to support the use of PromEx\n [#1199](https://github.com/OpenFn/Lightning/issues/1199)\n- Add warning text to PromEx config\n [#1222](https://github.com/OpenFn/Lightning/issues/1222)\n- Track and filter on webhook controller state in :telemetry metrics\n [#1192](https://github.com/OpenFn/Lightning/issues/1192)\n- Secure PromEx metrics endpoint by default\n [#1223](https://github.com/OpenFn/Lightning/issues/1223)\n- Partition `log_lines` table based on `attempt_id`\n [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Remove foreign key from `attempts` in preparation for partitioning\n `work_orders` [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Remove `Workflows.delete_workflow`. It is no longer in use and would require\n modification to not leave orphaned attempts given the removal of the foreign\n key from `attempts`. [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Show tooltip for cloned runs in history page\n [#1327](https://github.com/OpenFn/Lightning/issues/1327)\n- Have user create workflow name before moving to the canvas\n [#1103](https://github.com/OpenFn/Lightning/issues/1103)\n- Allow PromEx authorization to be disabled\n [#1483](https://github.com/OpenFn/Lightning/issues/1483)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Updated vulnerable JS libraries, `postcss` and `semver`\n [#1176](https://github.com/OpenFn/Lightning/issues/1176)\n- Update \"Delete\" to \"Delete Job\" on Job panel and include javascript deletion\n confirmation [#1105](https://github.com/OpenFn/Lightning/issues/1105)\n- Move \"Enabled\" property from \"Jobs\" to \"Edges\"\n [#895](https://github.com/OpenFn/Lightning/issues/895)\n- Incorrect wording on the \"Delete\" tooltip\n [#1313](https://github.com/OpenFn/Lightning/issues/1313)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed janitor lost query calculation\n [#1400](https://github.com/OpenFn/Lightning/issues/1400)\n- Adaptor icons load gracefully\n [#1140](https://github.com/OpenFn/Lightning/issues/1140)\n- Selected dataclip gets lost when starting a manual work order from the\n inspector interface [#1283](https://github.com/OpenFn/Lightning/issues/1283)\n- Ensure that the whole edge when selected is highlighted\n [#1160](https://github.com/OpenFn/Lightning/issues/1160)\n- Fix \"Reconfigure Github\" button in Project Settings\n [#1386](https://github.com/OpenFn/Lightning/issues/1386)\n- Make janitor also clean up runs inside an attempt\n [#1348](https://github.com/OpenFn/Lightning/issues/1348)\n- Modify CompleteRun to return error changeset when run not found\n [#1393](https://github.com/OpenFn/Lightning/issues/1393)\n- Drop invocation reasons from DB\n [#1412](https://github.com/OpenFn/Lightning/issues/1412)\n- Fix inconsistency in ordering of child nodes in the workflow diagram\n [#1406](https://github.com/OpenFn/Lightning/issues/1406)\n\n## [v0.9.3] - 2023-09-27","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add ellipsis when adaptor name is longer than the container allows\n [#1095](https://github.com/OpenFn/Lightning/issues/1095)\n- Webhook Authentication Methods database and CRUD operations\n [#1152](https://github.com/OpenFn/Lightning/issues/1152)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Prevent deletion of first job of a workflow\n [#1097](https://github.com/OpenFn/Lightning/issues/1097)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix long name on workflow cards\n [#1102](https://github.com/OpenFn/Lightning/issues/1102)\n- Fix highlighted Edge can get out of sync with selected Edge\n [#1099](https://github.com/OpenFn/Lightning/issues/1099)\n- Creating a new user without a password fails and there is no user feedback\n [#731](https://github.com/OpenFn/Lightning/issues/731)\n- Crash when setting up version control\n [#1112](https://github.com/OpenFn/Lightning/issues/1112)\n\n## [v0.9.2] - 2023-09-20","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add \"esc\" key binding to close job inspector modal\n [#1069](https://github.com/OpenFn/Lightning/issues/1069)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Save icons from the `adaptors` repo locally and load them in the job editor\n [#943](https://github.com/OpenFn/Lightning/issues/943)\n\n## [v0.9.1] - 2023-09-19","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Modified audit trail to handle lots of different kind of audit events\n [#271](https://github.com/OpenFn/Lightning/issues/271)/[#44](https://github.com/OpenFn/Lightning/issues/44)\n- Fix randomly unresponsive job panel after job deletion\n [#1113](https://github.com/OpenFn/Lightning/issues/1113)\n\n## [v0.9.0] - 2023-09-15","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Add favicons [#1079](https://github.com/OpenFn/Lightning/issues/1079)\n- Validate job name in placeholder job node\n [#1021](https://github.com/OpenFn/Lightning/issues/1021)\n- Bring credential delete in line with new GDPR interpretation\n [#802](https://github.com/OpenFn/Lightning/issues/802)\n- Make job names unique per workflow\n [#1053](https://github.com/OpenFn/Lightning/issues/1053)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Enhanced the job editor/inspector interface\n [#1025](https://github.com/OpenFn/Lightning/issues/1025)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Finished run never appears in inspector when it fails\n [#1084](https://github.com/OpenFn/Lightning/issues/1084)\n- Cannot delete some credentials via web UI\n [#1072](https://github.com/OpenFn/Lightning/issues/1072)\n- Stopped the History table from jumping when re-running a job\n [#1100](https://github.com/OpenFn/Lightning/issues/1100)\n- Fixed the \"+\" button when adding a job to a workflow\n [#1093](https://github.com/OpenFn/Lightning/issues/1093)\n\n## [v0.8.3] - 2023-09-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Render error when workflow diagram node is invalid\n [#956](https://github.com/OpenFn/Lightning/issues/956)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Restyle history table [#1029](https://github.com/OpenFn/Lightning/issues/1029)\n- Moved Filter and Search controls to the top of the history page\n [#1027](https://github.com/OpenFn/Lightning/issues/1027)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Output incorrectly shows \"this run failed\" when the run hasn't yet finished\n [#1048](https://github.com/OpenFn/Lightning/issues/1048)\n- Wrong label for workflow card timestamp\n [#1022](https://github.com/OpenFn/Lightning/issues/1022)\n\n## [v0.8.2] - 2023-08-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Lack of differentiation between top of job editor modal and top menu was\n disorienting. Added shadow.\n\n## [v0.8.1] - 2023-08-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Moved Save and Run button to bottom of the Job edit modal\n [#1026](https://github.com/OpenFn/Lightning/issues/1026)\n- Allow a manual work order to save the workflow before creating the work order\n [#959](https://github.com/OpenFn/Lightning/issues/959)\n\n## [v0.8.0] - 2023-08-31","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Introduces Github sync feature, users can now setup our github app on their\n instance and sync projects using our latest portability spec\n [#970](https://github.com/OpenFn/Lightning/issues/970)\n- Support Backup Codes for Multi-Factor Authentication\n [937](https://github.com/OpenFn/Lightning/issues/937)\n- Log a warning in the console when the Editor/docs component is given latest\n [#958](https://github.com/OpenFn/Lightning/issues/958)\n- Improve feedback when a Workflow name is invalid\n [#961](https://github.com/OpenFn/Lightning/issues/961)\n- Show that the jobs' body is invalid\n [#957](https://github.com/OpenFn/Lightning/issues/957)\n- Reimplement skipped CredentialLive tests\n [#962](https://github.com/OpenFn/Lightning/issues/962)\n- Reimplement skipped WorkflowLive.IndexTest test\n [#964](https://github.com/OpenFn/Lightning/issues/964)\n- Show GitHub installation ID and repo link to help setup/debugging for version\n control [1059](https://github.com/OpenFn/Lightning/issues/1059)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed issue where job names were being incorrectly hyphenated during\n project.yaml export [#1050](https://github.com/OpenFn/Lightning/issues/1050)\n- Allows the demo script to set a project id during creation to help with cli\n deploy/pull/Github integration testing.\n- Fixed demo project_repo_connection failing after nightly demo resets\n [1058](https://github.com/OpenFn/Lightning/issues/1058)\n- Fixed an issue where the monaco suggestion tooltip was offset from the main\n editor [1030](https://github.com/OpenFn/Lightning/issues/1030)\n\n## [v0.7.3] - 2023-08-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Version control in project settings is now named Export your project\n [#1015](https://github.com/OpenFn/Lightning/issues/1015)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Tooltip for credential select in Job Edit form is cut off\n [#972](https://github.com/OpenFn/Lightning/issues/972)\n- Dataclip type and state assembly notice for creating new dataclip dropped\n during refactor [#975](https://github.com/OpenFn/Lightning/issues/975)\n\n## [v0.7.2] - 2023-08-10","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- NodeJs security patch [1009](https://github.com/OpenFn/Lightning/pull/1009)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"## [v0.7.1] - 2023-08-04","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed flickery icons on new workflow job creation.\n\n## [v0.7.0] - 2023-08-04","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Project owners can require MFA for their users\n [892](https://github.com/OpenFn/Lightning/issues/892)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Moved to Elixir 1.15 and Erlang 26.0.2 to sort our an annoying ElixirLS issue\n that was slowing down our engineers.\n- Update Debian base to use bookworm (Debian 12) for our Docker images\n- Change new credential modal to take up less space on the screen\n [#931](https://github.com/OpenFn/Lightning/issues/931)\n- Placeholder nodes are now purely handled client-side","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix issue creating a new credential from the Job editor where the new\n credential was not being set on the job.\n [#951](https://github.com/OpenFn/Lightning/issues/951)\n- Fix issue where checking a credential type radio button shows as unchecked on\n first click. [#976](https://github.com/OpenFn/Lightning/issues/976)\n- Return the pre-filled workflow names\n [#971](https://github.com/OpenFn/Lightning/issues/971)\n- Fix version reporting and external reset_demo() call via\n Application.spec()[#1010](https://github.com/OpenFn/Lightning/issues/1010)\n- Fixed issue where entering a placeholder name through the form would result an\n in unsaveable workflow\n [#1001](https://github.com/OpenFn/Lightning/issues/1001)\n- Ensure the DownloadController checks for authentication and authorisation.\n\n## [v0.7.0-pre5] - 2023-07-28","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Unless otherwise specified, only show work orders with activity in last 14\n days [#968](https://github.com/OpenFn/Lightning/issues/968)\n\n## [v0.7.0-pre4] - 2023-07-27","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Don't add cast fragments if the search_term is nil\n [#968](https://github.com/OpenFn/Lightning/issues/968)\n\n## [v0.7.0-pre3] - 2023-07-26","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed an issue with newly created edges that prevented downstream jobs\n [977](https://github.com/OpenFn/Lightning/issues/977)\n\n## [v0.7.0-pre2] - 2023-07-26\n\nNote that this is a pre-release with a couple of known bugs that are tracked in\nthe Nodes and Edges [epic](https://github.com/OpenFn/Lightning/issues/793).","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added ability for a user to enable MFA on their account; using 2FA apps like\n Authy, Google Authenticator etc\n [#890](https://github.com/OpenFn/Lightning/issues/890)\n- Write/run sql script to convert triggers\n [#875](https://github.com/OpenFn/Lightning/issues/875)\n- Export projects as `.yaml` via UI\n [#249](https://github.com/OpenFn/Lightning/issues/249)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- In `v0.7.0` we change the underlying workflow building and execution\n infrastructure to align with a standard \"nodes and edges\" design for directed\n acyclic graphs (DAGs). Make sure to run the migrations!\n [793](https://github.com/OpenFn/Lightning/issues/793)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Propagate url pushState/changes to Workflow Diagram selection\n [#944](https://github.com/OpenFn/Lightning/issues/944)\n- Fix issue when deleting nodes from the workflow editor\n [#830](https://github.com/OpenFn/Lightning/issues/830)\n- Fix issue when clicking a trigger on a new/unsaved workflow\n [#954](https://github.com/OpenFn/Lightning/issues/954)\n\n## [0.6.7] - 2023-07-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add feature to bulk rerun work orders from a specific step in their workflow;\n e.g., \"rerun these 50 work orders, starting each at step 4.\"\n [#906](https://github.com/OpenFn/Lightning/pull/906)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Oban exception: \"value too long\" when log lines are longer than 255 chars\n [#929](https://github.com/OpenFn/Lightning/issues/929)\n\n## [0.6.6] - 2023-06-30","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add public API token to the demo site setup script\n- Check and renew OAuth credentials when running a job\n [#646](https://github.com/OpenFn/Lightning/issues/646)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Remove google sheets from adaptors list until supporting oauth flow\n [#792](https://github.com/OpenFn/Lightning/issues/792)\n- Remove duplicate google sheets adaptor display on credential type picklist\n [#663](https://github.com/OpenFn/Lightning/issues/663)\n- Fix demo setup script for calling from outside the app on Kubernetes\n deployments [#917](https://github.com/OpenFn/Lightning/issues/917)\n\n## [0.6.5] - 2023-06-22","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Ability to rerun work orders from start by selecting one of more of them from\n the History page and clicking the \"Rerun\" button.\n [#659](https://github.com/OpenFn/Lightning/issues/659)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Example runs for demo incorrect\n [#856](https://github.com/OpenFn/Lightning/issues/856)\n\n## [0.6.3] - 2023-06-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Prevent saving null log lines to the database, fix issue with run display\n [#866](https://github.com/OpenFn/Lightning/issues/866)\n\n## [0.6.2] - 2023-06-09","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed viewer permissions for delete workflow\n\n- Fixed bug with workflow cards\n [#859](https://github.com/OpenFn/Lightning/issues/859)\n\n## [0.6.1] - 2023-06-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed bug with run logs [#864](https://github.com/OpenFn/Lightning/issues/864)\n\n- Correctly stagger demo runs to maintain order\n [#856](https://github.com/OpenFn/Lightning/issues/856)\n- Remove `Timex` use from `SetupUtils` in favor of `DateTime` to fix issue when\n calling it in escript.\n\n## [0.6.0]- 2023-04-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Create sample runs when generating sample workflow\n [#821](https://github.com/OpenFn/Lightning/issues/821)\n- Added a provisioning api for creating and updating projects and their\n workflows See: [PROVISIONING.md](./PROVISIONING.md)\n [#641](https://github.com/OpenFn/Lightning/issues/641)\n- Add ability for a `superuser` to schedule deletion, cancel deletion, and\n delete projects [#757](https://github.com/OpenFn/Lightning/issues/757)\n- Add ability for a `project owner` to schedule deletion, cancel deletion, and\n delete projects [#746](https://github.com/OpenFn/Lightning/issues/746)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Ability to store run log lines as rows in a separate table\n [#514](https://github.com/OpenFn/Lightning/issues/514)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Incorrect project digest queries\n [#768](https://github.com/OpenFn/Lightning/issues/768)]\n- Fix issue when purging deleted users\n [#747](https://github.com/OpenFn/Lightning/issues/747)\n- Generate a random name for Workflows when creating one via the UI.\n [#828](https://github.com/OpenFn/Lightning/issues/828)\n- Handle error when deleting a job with runs.\n [#814](https://github.com/OpenFn/Lightning/issues/814)\n\n## [0.5.2]","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add `workflow_edges` table in preparation for new workflow editor\n implementation [#794](https://github.com/OpenFn/Lightning/issues/794)\n- Stamped `credential_id` on run directly for easier auditing of the history\n interface. Admins can now see which credential was used to run a run.\n [#800](https://github.com/OpenFn/Lightning/issues/800)\n- Better errors when using magic functions: \"no magic yet\" and \"check\n credential\" [#812](https://github.com/OpenFn/Lightning/issues/812)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- The `delete-project` function now delete all associated activities\n [#759](https://github.com/OpenFn/Lightning/issues/759)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"## [0.5.1] - 2023-04-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added ability to create and revoke personal API tokens\n [#147](https://github.com/OpenFn/Lightning/issues/147)\n- Add `last-used at` to API tokens\n [#722](https://github.com/OpenFn/Lightning/issues/722)\n- Improved \"save\" for job builder; users can now press `Ctrl + S` or `⌘ + S` to\n save new or updated jobs job panel will _not_ close. (Click elsewhere in the\n canvas or click the \"Close\" button to close.)\n [#568](https://github.com/OpenFn/Lightning/issues/568)\n- Add filtered search params to the history page URL\n [#660](https://github.com/OpenFn/Lightning/issues/660)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- The secret scrubber now ignores booleans\n [690](https://github.com/OpenFn/Lightning/issues/690)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- The secret scrubber now properly handles integer secrets from credentials\n [690](https://github.com/OpenFn/Lightning/issues/690)\n- Updated describe-package dependency, fixing sparkles in adaptor-docs\n [657](https://github.com/OpenFn/Lightning/issues/657)\n- Clicks on the workflow canvas were not lining up with the nodes users clicked\n on; they are now [733](https://github.com/OpenFn/Lightning/issues/733)\n- Job panel behaves better when collapsed\n [774](https://github.com/OpenFn/Lightning/issues/774)\n\n## [0.5.0] - 2023-04-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Magic functions that fetch real metadata from connected systems via\n `credentials` and suggest completions in the job builder (e.g., pressing\n `control-space` when setting the `orgUnit` attribute for a DHIS2 create\n operation will pull the _actual_ list of orgUnits with human readable labels\n and fill in their orgUnit codes upon\n enter.)[670](https://github.com/OpenFn/Lightning/issues/670)\n- A \"metadata explorer\" to browse actual system metadata for connected\n instances. [658](https://github.com/OpenFn/Lightning/issues/658)\n- Resizable job builder panel for the main canvas/workflow view.\n [681](https://github.com/OpenFn/Lightning/issues/681)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Display timezone for cron schedule—it is always UTC.\n [#716](https://github.com/OpenFn/Lightning/issues/716)\n- Instance administrators can now configure the interval between when a project\n owner or user requests deletion and when these records are purged from the\n database. It defaults to 7, but by providing a `PURGE_DELETED_AFTER_DAYS`\n environment variable the grace period can be altered. Note that setting this\n variable to `0` will make automatic purging _never_ occur but will still make\n \"deleted\" projects and users unavailable. This has been requested by certain\n organizations that must retain audit logs in a Lightning instance.\n [758](https://github.com/OpenFn/Lightning/issues/758)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Locked CLI version to `@openfn/cli@0.0.35`.\n [#761](https://github.com/OpenFn/Lightning/issues/761)\n\n## [0.4.8] - 2023-03-29","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added a test harness for monitoring critical parts of the app using Telemetry\n [#654](https://github.com/OpenFn/Lightning/issues/654)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Set log level to `info` for runs. Most of the `debug` logging is useful for\n the CLI, but not for Lightning. In the future the log level will be\n configurable at instance > project > job level by the `superuser` and any\n project `admin`.\n- Renamed license file so that automagic github icon is less confusing","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Broken links in failure alert email\n [#732](https://github.com/OpenFn/Lightning/issues/732)\n- Registration Submission on app.openfn.org shows internal server error in\n browser [#686](https://github.com/OpenFn/Lightning/issues/686)\n- Run the correct runtime install mix task in `Dockerfile-dev`\n [#541](https://github.com/OpenFn/Lightning/issues/541)\n- Users not disabled when scheduled for deletion\n [#719](https://github.com/OpenFn/Lightning/issues/719)\n\n## [0.4.6] - 2023-03-23","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Implement roles and permissions across entire app\n [#645](https://github.com/OpenFn/Lightning/issues/645)\n- Fix webhook URL\n (`https://< >/i/cae544ab-03dc-4ccc-a09c-fb4edb255d7a`) for the\n OpenHIE demo workflow [448](https://github.com/OpenFn/Lightning/issues/448)\n- Phoenix Storybook for improved component development\n- Load test for webhook endpoint performance\n [#645](https://github.com/OpenFn/Lightning/issues/634)\n- Notify user via email when they're added to a project\n [#306](https://github.com/OpenFn/Lightning/issues/306)\n- Added notify user via email when their account is created\n [#307](https://github.com/OpenFn/Lightning/issues/307)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Improved errors when decoding encryption keys for use with Cloak.\n [#684](https://github.com/OpenFn/Lightning/issues/684)\n- Allow users to run ANY job with a custom input.\n [#629](https://github.com/OpenFn/Lightning/issues/629)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Ensure JSON schema form inputs are in the same order as they are written in\n the schema [#685](https://github.com/OpenFn/Lightning/issues/685)\n\n## [0.4.4] - 2023-03-10","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Users can receive a digest email reporting on a specified project.\n [#638](https://github.com/OpenFn/Lightning/issues/638)\n [#585](https://github.com/OpenFn/Lightning/issues/585)\n\n## [0.4.3] - 2023-03-06","ref":"changelog.html#added"},{"type":"extras","title":"Added - Changelog","doc":"- Tooltips on Job Builder panel\n [#650](https://github.com/OpenFn/Lightning/issues/650)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Upgraded to Phoenix 1.7 (3945856)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Issue with FailureAlerter configuration missing in `prod` mode.\n\n## [0.4.2] - 2023-02-24","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- A user can change their own email\n [#247](https://github.com/OpenFn/Lightning/issues/247)\n- Added a `SCHEMAS_PATH` environment variable to override the default folder\n location for credential schemas\n [#604](https://github.com/OpenFn/Lightning/issues/604)\n- Added the ability to configure Google Sheets credentials\n [#536](https://github.com/OpenFn/Lightning/issues/536)\n- Function to import a project\n [#574](https://github.com/OpenFn/Lightning/issues/574)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Users cannot register if they have not selected the terms and conditions\n [#531](https://github.com/OpenFn/Lightning/issues/531)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Jobs panel slow for first open after restart\n [#567](https://github.com/OpenFn/Lightning/issues/567)\n\n## [0.4.0] - 2023-02-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added a Delete job button in Inspector\n- Filter workflow runs by text/value in run logs or input body\n- Drop \"configuration\" key from Run output dataclips after completion\n- Ability to 'rerun' a run from the Run list\n- Attempts and Runs update themselves in the Runs list\n- Configure a project and workflow for a new registering user\n- Run a job with a custom input\n- Added plausible analytics\n- Allow user to click on Webhook Trigger Node to copy webhook URL on workflow\n diagram\n- Allow any user to delete a credential that they own\n- Create any credential through a form except for OAuth\n- Refit all diagram nodes on browser and container resize\n- Enable distributed Erlang, allowing any number of redundant Lightning nodes to\n communicate with each other.\n- Users can set up realtime alerts for a project","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Better code-assist and intelliense in the Job Editor\n- Updated @openfn/workflow-diagram to 0.4.0\n- Make plus button part of job nodes in Workflow Diagram\n- Updated @openfn/adaptor-docs to 0.0.5\n- Updated @openfn/describe-package to 0.0.10\n- Create an follow a manual Run from the Job Inspector\n- View all workflows in a project on the workflows index page\n- Move @openfn/workflow-diagram into the application, the NPM module is now\n deprecated.\n- Remove workflow name from first node\n- Move the used parts of `@openfn/engine` into the application.\n- [BREAKING CHANGE] Ported `mix openfn.install.runtime` into application, use\n `mix lightning.install_runtime`.\n- [BREAKING CHANGE] Introduced `@openfn/cli` as the new runtime for Jobs\n- Rename a workflow through the page heading\n- Hide the dataclips tab for beta\n- Make adaptor default to common@latest\n- Remove jobs list page\n- Better error handling in the docs panel\n- Disable credential ownership transfer in dev and prod environments\n- Add project settings page\n- Change Work Order filters to apply to the aggregate state of the work order\n and not the run directly\n- Enable jobs by default\n- Set log level to info\n- Add Beta checkbox to register page\n- User roles and permissions","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Don't consider disabled jobs when calculating subsequent runs\n- Fixed overflow on Job Editor Tooltips\n- Fixed auto-scroll when adding a new snippet in the Job Editor\n- Fixed common operation typings in Job Editor\n\n## [0.3.1] - 2022-11-22","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed bug that tried to execute HTML scripts in dataclips\n- Fixed bug that prevented work orders from displaying in the order of their\n last run, descending.\n- Remove alerts after set timeout or close\n\n## [0.3.0] - 2022-11-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add seed data for demo site\n- Create adaptor credentials through a form\n- Configure cron expressions through a form\n- View runs grouped by work orders and attempts\n- Run an existing Job with any dataclip uuid from the Job form","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Redirect users to projects list page when they click on Admin Settings menu\n- Move job, project, input and output Dataclips to Run table\n- Reverse the relationship between Jobs and Triggers. Triggers now can exist on\n their own; setting the stage for branching and merging workflows\n- Updated Elixir and frontend dependencies\n- [BREAKING CHANGE] Pipeline now uses Work Orders, previous data is not\n compatible.\n- Runs, Dataclips and Attempts now all correctly use `usec` resolution\n timestamps.\n- Upgraded LiveView to 0.18.0\n- Upgraded Elixir to 1.14.1 and OTP 25\n- Workflow Job editor now behaves like a panel\n- Split JobLive.InspectorFormComponent into different plug-able subcomponents\n- Ensure new jobs with cron triggers receive a default frequency\n- Webhooks are now referenced by the trigger id instead of job id.\n- Filter runs by status\n- Filter runs by workflow\n- Filter runs by date\n- View a job run from the runs history\n- View latest matching inputs to run a job with\n\n## [0.2.0] - 2022-09-12","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- [BREAKING CHANGE] Add `Workflow` model, Jobs now belong to a Workflow This is\n a breaking change to the schema.\n- Use Node.js 18, soon to be in LTS.\n- Visualize success/fail triggers in workflow diagram.\n- Move WorkflowDiagram related actions from DashboardLive into WorkflowLive\n- Move WorkflowDiagram component into liveview, so that we can subscribe to\n channels (i.e. updating of the diagram when someone changes something).\n- Integrate `@openfn/workflow-diagram@0.0.8` and use the new Store interface for\n updating it.\n- Remove `component_mounted` event from WorkflowDiagram hook, using a\n MutationObserver and a Base64 encoded JSON payload.\n- Fixed an issue where the compiler component would try and load a 'nothing\n adaptor', added a condition to check an adaptor is actually selected.\n- Removed previous Workflow CTE queries, replaced by the introduction of the\n Workflow model, see\n (https://github.com/OpenFn/Lightning/blob/53da6883483e7d8d078783f348da327d1dd72d20/lib/lightning/workflows.ex#L111-L119).\n\n## [0.1.13] - 2022-08-29","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow administrators to configure OIDC providers for authentication (note that\n this is just for authenticating, not yet for creating new accounts via OIDC)\n- Add Monaco editor to the step/job panel\n- Allow users to delete their own accounts. Schedule their user and credentials\n data for deletion when they do.\n- Allow superusers to delete a user account. Schedule the user's credentials and\n user data for deletion when they do.\n- If a user is scheduled for deletion, disable their account and prevent them\n from logging in.\n- The 'User profile' and 'Credentials' page now have a sidebar menu","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Project users now have one of the following roles: viewer, editor, admin,\n owner\n- Users only have the following roles: user, superuser\n\n## [0.1.12] - 2022-08-15","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Transfer credential ownership to another user.\n- Create credentials via a form interface\\*\n- Show \"projects with access\" in credentials list view.\n- Show job in runs list and run view.\n- Added roles and permissions to workflows and history page\n [#645](https://github.com/OpenFn/Lightning/issues/645)\n\n\\*The form is defined by a JSON schema provided by an adaptor, in most cases:\ne.g., `language-dhis2` provides a single schema which defines the required\nattributes for `state.configuration`, while `language-common` provides multiple\ncredential schemas like \"oauth\" or \"basic auth\" which define attributes for\n`state.configuration` and which might be used by lots of different jobs.)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- User menu (top right) appears on top of all other components.\n- User profile screen integrated with the rest of the liveview app.\n\n## [0.1.11] - 2022-08-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed logging in Runner when `:debug` log level used; note that this caused\n crashes in Oban\n\n## [0.1.10] - 2022-08-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Credential auditing\n- Build/version information display for easier debugging","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed a bug that enqueued cron-triggered jobs even when they were disabled\n\n## [0.1.9] - 2022-07-27","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Navigate to user profile or credentials page and log out through the user icon\n dropdown\n- Create and edit dataclips\n- Add a production tag to credentials\n- View a dropdown of operations and their description for the language-common\n `v2.0.0-rc2` adaptor (this pattern to be rolled out across adaptors)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Navigate between projects through a project picker on the navbar","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Run Lightning with docker","ref":"changelog.html#fixed"},{"type":"extras","title":"Security - Changelog","doc":"- Sensitive credential values are scrubbed from run logs\n- All credentials are encrypted at REST\n\n## [0.1.7] - 2022-06-24","ref":"changelog.html#security"},{"type":"extras","title":"Added - Changelog","doc":"- Run a job with a cron trigger\n- Queue jobs via Oban/Postgres\n- Edit jobs via the workflow canvas\n\n## [0.1.6] - 2022-06-07","ref":"changelog.html#added"},{"type":"extras","title":"Added - Changelog","doc":"- Register, log in and log out of an account\n- Allow superusers and admin users to create projects\n- Allow admin users to create or disable a user’s account\n- Allow superusers for local deployments to create users and give them access to\n project spaces\n\n- Create and edit a job with a webhook, flow/fail or cron trigger\n- Create and edit credentials for a job\n- Copy a job's webhook URL\n- View all workflows in a project visually\n- Deploy lightning locally with Docker\n\n- Enable a job to automatically process incoming requests\n- Run a job with a webhook or flow/fail trigger\n- View job runs along with their logs, exit code, start and end time\n- View data clips that have initiated job runs (http requests for webhooks, run\n results)","ref":"changelog.html#added"}],"producer":{"name":"ex_doc","version":[48,46,51,52,46,50]},"content_type":"text/markdown"} \ No newline at end of file +searchData={"items":[{"type":"behaviour","title":"Lightning","doc":"Lightning keeps the contexts that define your domain\nand business logic.\n\nContexts are also responsible for managing your data, regardless\nif it comes from the database, an external API or others.","ref":"Lightning.html"},{"type":"function","title":"Lightning.broadcast/2","doc":"","ref":"Lightning.html#broadcast/2"},{"type":"callback","title":"Lightning.broadcast/2","doc":"","ref":"Lightning.html#c:broadcast/2"},{"type":"function","title":"Lightning.current_time/0","doc":"Returns the current time at UTC.","ref":"Lightning.html#current_time/0"},{"type":"callback","title":"Lightning.current_time/0","doc":"","ref":"Lightning.html#c:current_time/0"},{"type":"function","title":"Lightning.local_broadcast/2","doc":"","ref":"Lightning.html#local_broadcast/2"},{"type":"callback","title":"Lightning.local_broadcast/2","doc":"","ref":"Lightning.html#c:local_broadcast/2"},{"type":"function","title":"Lightning.release/0","doc":"","ref":"Lightning.html#release/0"},{"type":"callback","title":"Lightning.release/0","doc":"","ref":"Lightning.html#c:release/0"},{"type":"function","title":"Lightning.subscribe/1","doc":"","ref":"Lightning.html#subscribe/1"},{"type":"callback","title":"Lightning.subscribe/1","doc":"","ref":"Lightning.html#c:subscribe/1"},{"type":"type","title":"Lightning.release_info/0","doc":"","ref":"Lightning.html#t:release_info/0"},{"type":"module","title":"ObanPruner","doc":"The Oban Pruner removes completed Oban jobs. It leaves everything else for manual inspection.","ref":"ObanPruner.html"},{"type":"function","title":"ObanPruner.perform/1","doc":"Deletes completed Oban jobs, leaving discarded for manual inspection.","ref":"ObanPruner.html#perform/1"},{"type":"module","title":"Lightning.Accounts","doc":"The Accounts context.","ref":"Lightning.Accounts.html"},{"type":"function","title":"Lightning.Accounts.apply_user_email/3","doc":"Emulates that the email will change without actually changing\nit in the database.","ref":"Lightning.Accounts.html#apply_user_email/3"},{"type":"function","title":"Examples - Lightning.Accounts.apply_user_email/3","doc":"iex> apply_user_email(user, \"valid password\", %{email: ...})\n {:ok, %User{}}role: :superuser\n iex> apply_user_email(user, \"invalid password\", %{email: ...})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#apply_user_email/3-examples"},{"type":"function","title":"Lightning.Accounts.cancel_scheduled_deletion/1","doc":"","ref":"Lightning.Accounts.html#cancel_scheduled_deletion/1"},{"type":"function","title":"Lightning.Accounts.change_scheduled_deletion/2","doc":"Returns an `%Ecto.Changeset{}` for changing the user scheduled_deletion.","ref":"Lightning.Accounts.html#change_scheduled_deletion/2"},{"type":"function","title":"Examples - Lightning.Accounts.change_scheduled_deletion/2","doc":"iex> change_scheduled_deletion(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_scheduled_deletion/2-examples"},{"type":"function","title":"Lightning.Accounts.change_superuser_registration/1","doc":"Returns an `%Ecto.Changeset{}` for tracking superuser changes.","ref":"Lightning.Accounts.html#change_superuser_registration/1"},{"type":"function","title":"Examples - Lightning.Accounts.change_superuser_registration/1","doc":"iex> change_superuser_registration(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_superuser_registration/1-examples"},{"type":"function","title":"Lightning.Accounts.change_user/2","doc":"","ref":"Lightning.Accounts.html#change_user/2"},{"type":"function","title":"Lightning.Accounts.change_user_email/2","doc":"Returns an `%Ecto.Changeset{}` for changing the user email.","ref":"Lightning.Accounts.html#change_user_email/2"},{"type":"function","title":"Examples - Lightning.Accounts.change_user_email/2","doc":"iex> change_user_email(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_user_email/2-examples"},{"type":"function","title":"Lightning.Accounts.change_user_info/2","doc":"","ref":"Lightning.Accounts.html#change_user_info/2"},{"type":"function","title":"Lightning.Accounts.change_user_password/2","doc":"Returns an `%Ecto.Changeset{}` for changing the user password.","ref":"Lightning.Accounts.html#change_user_password/2"},{"type":"function","title":"Examples - Lightning.Accounts.change_user_password/2","doc":"iex> change_user_password(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_user_password/2-examples"},{"type":"function","title":"Lightning.Accounts.change_user_registration/1","doc":"Returns an `%Ecto.Changeset{}` for tracking user changes.","ref":"Lightning.Accounts.html#change_user_registration/1"},{"type":"function","title":"Examples - Lightning.Accounts.change_user_registration/1","doc":"iex> change_user_registration(user)\n %Ecto.Changeset{data: %User{}}","ref":"Lightning.Accounts.html#change_user_registration/1-examples"},{"type":"function","title":"Lightning.Accounts.confirm_user/1","doc":"Confirms a user by the given token.\n\nIf the token matches, the user account is marked as confirmed\nand the token is deleted.","ref":"Lightning.Accounts.html#confirm_user/1"},{"type":"function","title":"Lightning.Accounts.confirmation_required?/1","doc":"","ref":"Lightning.Accounts.html#confirmation_required?/1"},{"type":"function","title":"Lightning.Accounts.create_user/1","doc":"","ref":"Lightning.Accounts.html#create_user/1"},{"type":"function","title":"Lightning.Accounts.delete_auth_token/1","doc":"Deletes the signed token with the given context.","ref":"Lightning.Accounts.html#delete_auth_token/1"},{"type":"function","title":"Lightning.Accounts.delete_session_token/1","doc":"Deletes the signed token with the given context.","ref":"Lightning.Accounts.html#delete_session_token/1"},{"type":"function","title":"Lightning.Accounts.delete_sudo_session_token/1","doc":"Deletes the signed token with the given context.","ref":"Lightning.Accounts.html#delete_sudo_session_token/1"},{"type":"function","title":"Lightning.Accounts.delete_token/1","doc":"Deletes a token.","ref":"Lightning.Accounts.html#delete_token/1"},{"type":"function","title":"Examples - Lightning.Accounts.delete_token/1","doc":"iex> delete_token(token)\n {:ok, %UserToken{}}\n\n iex> delete_token(token)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#delete_token/1-examples"},{"type":"function","title":"Lightning.Accounts.delete_user/1","doc":"Deletes a user.","ref":"Lightning.Accounts.html#delete_user/1"},{"type":"function","title":"Examples - Lightning.Accounts.delete_user/1","doc":"iex> delete_user(user)\n {:ok, %User{}}\n\n iex> delete_user(user)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#delete_user/1-examples"},{"type":"function","title":"Lightning.Accounts.delete_user_totp/1","doc":"Deletes the given user's TOTP","ref":"Lightning.Accounts.html#delete_user_totp/1"},{"type":"function","title":"Lightning.Accounts.deliver_user_confirmation_instructions/1","doc":"Delivers the confirmation email instructions to the given user.","ref":"Lightning.Accounts.html#deliver_user_confirmation_instructions/1"},{"type":"function","title":"Examples - Lightning.Accounts.deliver_user_confirmation_instructions/1","doc":"iex> deliver_user_confirmation_instructions(user)\n {:ok, %{to: ..., body: ...}}\n\n iex> deliver_user_confirmation_instructions(confirmed_user)\n {:error, :already_confirmed}","ref":"Lightning.Accounts.html#deliver_user_confirmation_instructions/1-examples"},{"type":"function","title":"Lightning.Accounts.deliver_user_confirmation_instructions/2","doc":"","ref":"Lightning.Accounts.html#deliver_user_confirmation_instructions/2"},{"type":"function","title":"Lightning.Accounts.deliver_user_reset_password_instructions/2","doc":"Delivers the reset password email to the given user.","ref":"Lightning.Accounts.html#deliver_user_reset_password_instructions/2"},{"type":"function","title":"Examples - Lightning.Accounts.deliver_user_reset_password_instructions/2","doc":"iex> deliver_user_reset_password_instructions(user, &Routes.user_reset_password_url(conn, :edit, &1))\n {:ok, %{to: ..., body: ...}}","ref":"Lightning.Accounts.html#deliver_user_reset_password_instructions/2-examples"},{"type":"function","title":"Lightning.Accounts.exchange_auth_token/1","doc":"Exchanges an auth token for a session token.\n\nThe auth token is removed from the database if successful.","ref":"Lightning.Accounts.html#exchange_auth_token/1"},{"type":"function","title":"Lightning.Accounts.generate_api_token/1","doc":"Generates an API token for a user.","ref":"Lightning.Accounts.html#generate_api_token/1"},{"type":"function","title":"Lightning.Accounts.generate_auth_token/1","doc":"Generates an auth token.","ref":"Lightning.Accounts.html#generate_auth_token/1"},{"type":"function","title":"Lightning.Accounts.generate_sudo_session_token/1","doc":"Generates a 2FA session token.","ref":"Lightning.Accounts.html#generate_sudo_session_token/1"},{"type":"function","title":"Lightning.Accounts.generate_user_session_token/1","doc":"Generates a session token.","ref":"Lightning.Accounts.html#generate_user_session_token/1"},{"type":"function","title":"Lightning.Accounts.get_preference/2","doc":"Retrieves a specific preference value for a given user.\n\nReturns the value of the specified key from the user's preferences.\nIf the value is the string `\"true\"` or `\"false\"`, it is converted to a boolean.","ref":"Lightning.Accounts.html#get_preference/2"},{"type":"function","title":"Examples - Lightning.Accounts.get_preference/2","doc":"iex> get_preference(user, \"editor.orientation\")\n \"vertical\"\n\n iex> get_preference(user, \"notifications.enabled\")\n true","ref":"Lightning.Accounts.html#get_preference/2-examples"},{"type":"function","title":"Lightning.Accounts.get_token!/1","doc":"Gets a single token.\n\nRaises `Ecto.NoResultsError` if the UserToken does not exist.","ref":"Lightning.Accounts.html#get_token!/1"},{"type":"function","title":"Examples - Lightning.Accounts.get_token!/1","doc":"iex> get_token!(123)\n %UserToken{}\n\n iex> get_token!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Accounts.html#get_token!/1-examples"},{"type":"function","title":"Lightning.Accounts.get_user/1","doc":"Gets a single user.","ref":"Lightning.Accounts.html#get_user/1"},{"type":"function","title":"Examples - Lightning.Accounts.get_user/1","doc":"iex> get_user(123)\n %User{}\n\n iex> get_user!(456)\n nil","ref":"Lightning.Accounts.html#get_user/1-examples"},{"type":"function","title":"Lightning.Accounts.get_user!/1","doc":"Gets a single user.\n\nRaises `Ecto.NoResultsError` if the User does not exist.\n\nSee `get_user/1`.","ref":"Lightning.Accounts.html#get_user!/1"},{"type":"function","title":"Lightning.Accounts.get_user_by_api_token/1","doc":"Gets the user with the given signed token.","ref":"Lightning.Accounts.html#get_user_by_api_token/1"},{"type":"function","title":"Lightning.Accounts.get_user_by_auth_token/1","doc":"Gets the user with the given signed token.","ref":"Lightning.Accounts.html#get_user_by_auth_token/1"},{"type":"function","title":"Lightning.Accounts.get_user_by_email/1","doc":"Gets a user by email.","ref":"Lightning.Accounts.html#get_user_by_email/1"},{"type":"function","title":"Examples - Lightning.Accounts.get_user_by_email/1","doc":"iex> get_user_by_email(\"foo@example.com\")\n %User{}\n\n iex> get_user_by_email(\"unknown@example.com\")\n nil","ref":"Lightning.Accounts.html#get_user_by_email/1-examples"},{"type":"function","title":"Lightning.Accounts.get_user_by_email_and_password/2","doc":"Gets a user by email and password.","ref":"Lightning.Accounts.html#get_user_by_email_and_password/2"},{"type":"function","title":"Examples - Lightning.Accounts.get_user_by_email_and_password/2","doc":"iex> get_user_by_email_and_password(\"foo@example.com\", \"correct_password\")\n %User{}\n\n iex> get_user_by_email_and_password(\"foo@example.com\", \"invalid_password\")\n nil","ref":"Lightning.Accounts.html#get_user_by_email_and_password/2-examples"},{"type":"function","title":"Lightning.Accounts.get_user_by_reset_password_token/1","doc":"Gets the user by reset password token.","ref":"Lightning.Accounts.html#get_user_by_reset_password_token/1"},{"type":"function","title":"Examples - Lightning.Accounts.get_user_by_reset_password_token/1","doc":"iex> get_user_by_reset_password_token(\"validtoken\")\n %User{}\n\n iex> get_user_by_reset_password_token(\"invalidtoken\")\n nil","ref":"Lightning.Accounts.html#get_user_by_reset_password_token/1-examples"},{"type":"function","title":"Lightning.Accounts.get_user_by_session_token/1","doc":"Gets the user with the given signed token.","ref":"Lightning.Accounts.html#get_user_by_session_token/1"},{"type":"function","title":"Lightning.Accounts.get_user_totp/1","doc":"Gets a single UserTOTP if any exists.","ref":"Lightning.Accounts.html#get_user_totp/1"},{"type":"function","title":"Lightning.Accounts.get_users_to_alert_for_project/1","doc":"Gets all users to alert of workflow failure for a project","ref":"Lightning.Accounts.html#get_users_to_alert_for_project/1"},{"type":"function","title":"Lightning.Accounts.has_activity_in_projects?/1","doc":"","ref":"Lightning.Accounts.html#has_activity_in_projects?/1"},{"type":"function","title":"Lightning.Accounts.has_one_superuser?/0","doc":"Used to determine if there is at least one Superuser in the system.\nThis triggers the setup page on fresh installs.","ref":"Lightning.Accounts.html#has_one_superuser?/0"},{"type":"function","title":"Lightning.Accounts.list_api_tokens/1","doc":"Lists all user tokens","ref":"Lightning.Accounts.html#list_api_tokens/1"},{"type":"function","title":"Lightning.Accounts.list_user_backup_codes/1","doc":"Lists the user backup codes","ref":"Lightning.Accounts.html#list_user_backup_codes/1"},{"type":"function","title":"Lightning.Accounts.list_users/0","doc":"Returns the list of users.","ref":"Lightning.Accounts.html#list_users/0"},{"type":"function","title":"Examples - Lightning.Accounts.list_users/0","doc":"iex> list_users()\n [%User{}, ...]","ref":"Lightning.Accounts.html#list_users/0-examples"},{"type":"function","title":"Lightning.Accounts.list_users_by_emails/1","doc":"Returns the list of users with the given emails","ref":"Lightning.Accounts.html#list_users_by_emails/1"},{"type":"function","title":"Lightning.Accounts.perform/1","doc":"Perform, when called with %{\"type\" => \"purge_deleted\"} will find users that are ready for permanent deletion and purge them.","ref":"Lightning.Accounts.html#perform/1"},{"type":"function","title":"Lightning.Accounts.purge_user/1","doc":"","ref":"Lightning.Accounts.html#purge_user/1"},{"type":"function","title":"Lightning.Accounts.regenerate_user_backup_codes/1","doc":"Regenerates the user backup codes","ref":"Lightning.Accounts.html#regenerate_user_backup_codes/1"},{"type":"function","title":"Lightning.Accounts.register_superuser/1","doc":"Registers a superuser.","ref":"Lightning.Accounts.html#register_superuser/1"},{"type":"function","title":"Examples - Lightning.Accounts.register_superuser/1","doc":"iex> register_superuser(%{field: value})\n {:ok, %User{}}\n\n iex> register_superuser(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#register_superuser/1-examples"},{"type":"function","title":"Lightning.Accounts.register_user/1","doc":"Registers a user.","ref":"Lightning.Accounts.html#register_user/1"},{"type":"function","title":"Examples - Lightning.Accounts.register_user/1","doc":"iex> register_user(%{field: value})\n {:ok, %User{}}\n\n iex> register_user(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#register_user/1-examples"},{"type":"function","title":"Lightning.Accounts.remind_account_confirmation/1","doc":"","ref":"Lightning.Accounts.html#remind_account_confirmation/1"},{"type":"function","title":"Lightning.Accounts.request_email_update/2","doc":"Delivers the update email instructions to the given user.","ref":"Lightning.Accounts.html#request_email_update/2"},{"type":"function","title":"Examples - Lightning.Accounts.request_email_update/2","doc":"iex> request_email_update(user, new_email)\n :ok","ref":"Lightning.Accounts.html#request_email_update/2-examples"},{"type":"function","title":"Lightning.Accounts.reset_user_password/2","doc":"Resets the user password.","ref":"Lightning.Accounts.html#reset_user_password/2"},{"type":"function","title":"Examples - Lightning.Accounts.reset_user_password/2","doc":"iex> reset_user_password(user, %{password: \"new long password\", password_confirmation: \"new long password\"})\n {:ok, %User{}}\n\n iex> reset_user_password(user, %{password: \"valid\", password_confirmation: \"not the same\"})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#reset_user_password/2-examples"},{"type":"function","title":"Lightning.Accounts.schedule_user_deletion/2","doc":"Given a user and a confirmation email, this function sets a scheduled deletion\ndate based on the PURGE_DELETED_AFTER_DAYS environment variable. If no ENV is\nset, this date defaults to NOW but the automatic user purge cronjob will never\nrun. (Note that subsequent logins will be blocked for users pending deletion.)","ref":"Lightning.Accounts.html#schedule_user_deletion/2"},{"type":"function","title":"Lightning.Accounts.subscribe/0","doc":"","ref":"Lightning.Accounts.html#subscribe/0"},{"type":"function","title":"Lightning.Accounts.sudo_session_token_valid?/2","doc":"Checks if the given sudo token for the user is valid","ref":"Lightning.Accounts.html#sudo_session_token_valid?/2"},{"type":"function","title":"Lightning.Accounts.update_user_details/2","doc":"","ref":"Lightning.Accounts.html#update_user_details/2"},{"type":"function","title":"Lightning.Accounts.update_user_email/2","doc":"Updates the user email using the given token.\n\nIf the token matches, the user email is updated and the token is deleted.\nThe confirmed_at date is also updated to the current time.","ref":"Lightning.Accounts.html#update_user_email/2"},{"type":"function","title":"Lightning.Accounts.update_user_info/2","doc":"","ref":"Lightning.Accounts.html#update_user_info/2"},{"type":"function","title":"Lightning.Accounts.update_user_password/3","doc":"Updates the user password.","ref":"Lightning.Accounts.html#update_user_password/3"},{"type":"function","title":"Examples - Lightning.Accounts.update_user_password/3","doc":"iex> update_user_password(user, \"valid password\", %{password: ...})\n {:ok, %User{}}\n\n iex> update_user_password(user, \"invalid password\", %{password: ...})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Accounts.html#update_user_password/3-examples"},{"type":"function","title":"Lightning.Accounts.update_user_preference/3","doc":"Updates a specific key in the user's preferences.\n\nMerges the new key-value pair into the user's existing preferences and updates the database.","ref":"Lightning.Accounts.html#update_user_preference/3"},{"type":"function","title":"Examples - Lightning.Accounts.update_user_preference/3","doc":"iex> update_user_preference(user, \"editor.orientation\", \"vertical\")\n {:ok, %User{}}\n\n iex> update_user_preference(user, \"notifications.enabled\", true)\n {:ok, %User{}}","ref":"Lightning.Accounts.html#update_user_preference/3-examples"},{"type":"function","title":"Lightning.Accounts.update_user_preferences/2","doc":"Updates the user preferences.","ref":"Lightning.Accounts.html#update_user_preferences/2"},{"type":"function","title":"Examples - Lightning.Accounts.update_user_preferences/2","doc":"iex> update_user_preferences(%User{}, %{\"editor.orientaion\" => \"vertical\"})","ref":"Lightning.Accounts.html#update_user_preferences/2-examples"},{"type":"function","title":"Lightning.Accounts.upsert_user_totp/2","doc":"Updates or Inserts the user's TOTP","ref":"Lightning.Accounts.html#upsert_user_totp/2"},{"type":"function","title":"Lightning.Accounts.valid_user_backup_code?/2","doc":"Validates if the given Backup code is valid.","ref":"Lightning.Accounts.html#valid_user_backup_code?/2"},{"type":"function","title":"Lightning.Accounts.valid_user_totp?/2","doc":"Validates if the given TOTP code is valid.","ref":"Lightning.Accounts.html#valid_user_totp?/2"},{"type":"function","title":"Lightning.Accounts.validate_change_user_email/2","doc":"Validates the changes for updating a user's email address.\n\nThis function ensures that:\n- The `email` and `current_password` fields are present.\n- The new email is in a valid format.\n- The new email is different from the current one.\n- The provided `current_password` matches the user's password.","ref":"Lightning.Accounts.html#validate_change_user_email/2"},{"type":"function","title":"Parameters - Lightning.Accounts.validate_change_user_email/2","doc":"- `user`: The `%User{}` struct representing the current user.\n- `params`: A map of parameters containing the new email and current password.","ref":"Lightning.Accounts.html#validate_change_user_email/2-parameters"},{"type":"function","title":"Returns - Lightning.Accounts.validate_change_user_email/2","doc":"An `Ecto.Changeset` containing any validation errors.","ref":"Lightning.Accounts.html#validate_change_user_email/2-returns"},{"type":"function","title":"Examples - Lightning.Accounts.validate_change_user_email/2","doc":"iex> validate_change_user_email(user, %{\"email\" => \"new@example.com\", \"current_password\" => \"secret\"})\n %Ecto.Changeset{...}","ref":"Lightning.Accounts.html#validate_change_user_email/2-examples"},{"type":"module","title":"Lightning.Accounts.Events","doc":"Publishes and subscribe to events related to user accounts.","ref":"Lightning.Accounts.Events.html"},{"type":"function","title":"Lightning.Accounts.Events.subscribe/0","doc":"","ref":"Lightning.Accounts.Events.html#subscribe/0"},{"type":"function","title":"Lightning.Accounts.Events.user_registered/1","doc":"","ref":"Lightning.Accounts.Events.html#user_registered/1"},{"type":"module","title":"Lightning.Accounts.User","doc":"The User model.","ref":"Lightning.Accounts.User.html"},{"type":"function","title":"Lightning.Accounts.User.changeset/2","doc":"","ref":"Lightning.Accounts.User.html#changeset/2"},{"type":"function","title":"Lightning.Accounts.User.confirm_changeset/1","doc":"Confirms the account by setting `confirmed_at`.","ref":"Lightning.Accounts.User.html#confirm_changeset/1"},{"type":"function","title":"Lightning.Accounts.User.details_changeset/2","doc":"A user changeset for user details:\n\n- email\n- first_name\n- last_name\n- role","ref":"Lightning.Accounts.User.html#details_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.email_changeset/2","doc":"A user changeset for changing the email.\n\nIt requires the email to change otherwise an error is added.","ref":"Lightning.Accounts.User.html#email_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.github_token_changeset/2","doc":"","ref":"Lightning.Accounts.User.html#github_token_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.info_changeset/2","doc":"A user changeset for basic information:\n\n- first_name\n- last_name\n- contact_preference","ref":"Lightning.Accounts.User.html#info_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.password_changeset/3","doc":"A user changeset for changing the password.","ref":"Lightning.Accounts.User.html#password_changeset/3"},{"type":"function","title":"Options - Lightning.Accounts.User.password_changeset/3","doc":"* `:hash_password` - Hashes the password so it can be stored securely\n in the database and ensures the password field is cleared to prevent\n leaks in the logs. If password hashing is not needed and clearing the\n password field is not desired (like when using this changeset for\n validations on a LiveView form), this option can be set to `false`.\n Defaults to `true`.","ref":"Lightning.Accounts.User.html#password_changeset/3-options"},{"type":"function","title":"Lightning.Accounts.User.preferences_changeset/2","doc":"","ref":"Lightning.Accounts.User.html#preferences_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.remove_github_token_changeset/1","doc":"","ref":"Lightning.Accounts.User.html#remove_github_token_changeset/1"},{"type":"function","title":"Lightning.Accounts.User.scheduled_deletion_changeset/2","doc":"A user changeset for changing the scheduled_deletion property.","ref":"Lightning.Accounts.User.html#scheduled_deletion_changeset/2"},{"type":"function","title":"Lightning.Accounts.User.superuser_registration_changeset/2","doc":"A superuser changeset for registration.\n\nIt is important to validate the length of both email and password.\nOtherwise databases may truncate the email without warnings, which\ncould lead to unpredictable or insecure behaviour. Long passwords may\nalso be very expensive to hash for certain algorithms.","ref":"Lightning.Accounts.User.html#superuser_registration_changeset/2"},{"type":"function","title":"Options - Lightning.Accounts.User.superuser_registration_changeset/2","doc":"* `:hash_password` - Hashes the password so it can be stored securely\n in the database and ensures the password field is cleared to prevent\n leaks in the logs. If password hashing is not needed and clearing the\n password field is not desired (like when using this changeset for\n validations on a LiveView form), this option can be set to `false`.\n Defaults to `true`.","ref":"Lightning.Accounts.User.html#superuser_registration_changeset/2-options"},{"type":"function","title":"Lightning.Accounts.User.user_registration_changeset/2","doc":"A user changeset for registration.\n\nIt is important to validate the length of both email and password.\nOtherwise databases may truncate the email without warnings, which\ncould lead to unpredictable or insecure behaviour. Long passwords may\nalso be very expensive to hash for certain algorithms.","ref":"Lightning.Accounts.User.html#user_registration_changeset/2"},{"type":"function","title":"Options - Lightning.Accounts.User.user_registration_changeset/2","doc":"* `:hash_password` - Hashes the password so it can be stored securely\n in the database and ensures the password field is cleared to prevent\n leaks in the logs. If password hashing is not needed and clearing the\n password field is not desired (like when using this changeset for\n validations on a LiveView form), this option can be set to `false`.\n Defaults to `true`.","ref":"Lightning.Accounts.User.html#user_registration_changeset/2-options"},{"type":"function","title":"Lightning.Accounts.User.valid_password?/2","doc":"Verifies the password.\n\nIf there is no user or the user doesn't have a password, we call\n`Bcrypt.no_user_verify/0` to avoid timing attacks.","ref":"Lightning.Accounts.User.html#valid_password?/2"},{"type":"function","title":"Lightning.Accounts.User.validate_current_password/2","doc":"Validates the current password otherwise adds an error to the changeset.","ref":"Lightning.Accounts.User.html#validate_current_password/2"},{"type":"function","title":"Lightning.Accounts.User.validate_email/1","doc":"","ref":"Lightning.Accounts.User.html#validate_email/1"},{"type":"type","title":"Lightning.Accounts.User.t/0","doc":"","ref":"Lightning.Accounts.User.html#t:t/0"},{"type":"module","title":"Lightning.Accounts.User.RolesEnum","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.cast/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#cast/1"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.create_type/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#create_type/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.drop_type/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#drop_type/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.dump/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#dump/1"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.embed_as/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#embed_as/1"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.equal?/2","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#equal?/2"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.load/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#load/1"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.schema/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#schema/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.schemaless_type/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#schemaless_type/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.type/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#type/0"},{"type":"function","title":"Lightning.Accounts.User.RolesEnum.valid_value?/1","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#valid_value?/1"},{"type":"type","title":"Lightning.Accounts.User.RolesEnum.t/0","doc":"","ref":"Lightning.Accounts.User.RolesEnum.html#t:t/0"},{"type":"module","title":"Lightning.Accounts.UserBackupCode","doc":"User backup codes schema","ref":"Lightning.Accounts.UserBackupCode.html"},{"type":"function","title":"Lightning.Accounts.UserBackupCode.changeset/2","doc":"","ref":"Lightning.Accounts.UserBackupCode.html#changeset/2"},{"type":"function","title":"Lightning.Accounts.UserBackupCode.generate_backup_code/0","doc":"","ref":"Lightning.Accounts.UserBackupCode.html#generate_backup_code/0"},{"type":"type","title":"Lightning.Accounts.UserBackupCode.t/0","doc":"","ref":"Lightning.Accounts.UserBackupCode.html#t:t/0"},{"type":"module","title":"Lightning.Accounts.UserNotifier","doc":"The UserNotifier module.","ref":"Lightning.Accounts.UserNotifier.html"},{"type":"function","title":"Lightning.Accounts.UserNotifier.build_digest_url/3","doc":"","ref":"Lightning.Accounts.UserNotifier.html#build_digest_url/3"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_confirmation_instructions/2","doc":"Deliver instructions to confirm account.","ref":"Lightning.Accounts.UserNotifier.html#deliver_confirmation_instructions/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_confirmation_instructions/3","doc":"Deliver instructions to confirm account.","ref":"Lightning.Accounts.UserNotifier.html#deliver_confirmation_instructions/3"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_project_addition_notification/2","doc":"Deliver email to notify user of his addition of a project.","ref":"Lightning.Accounts.UserNotifier.html#deliver_project_addition_notification/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_project_digest/2","doc":"Deliver a project digest of daily/weekly or monthly activity to a user.","ref":"Lightning.Accounts.UserNotifier.html#deliver_project_digest/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_project_invitation_email/5","doc":"","ref":"Lightning.Accounts.UserNotifier.html#deliver_project_invitation_email/5"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_reset_password_instructions/2","doc":"Deliver instructions to reset a user password.","ref":"Lightning.Accounts.UserNotifier.html#deliver_reset_password_instructions/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_update_email_instructions/2","doc":"Deliver instructions to update a user.","ref":"Lightning.Accounts.UserNotifier.html#deliver_update_email_instructions/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.deliver_update_email_warning/2","doc":"Deliver warning to update a user.","ref":"Lightning.Accounts.UserNotifier.html#deliver_update_email_warning/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.notify_history_export_completion/2","doc":"","ref":"Lightning.Accounts.UserNotifier.html#notify_history_export_completion/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.notify_project_deletion/2","doc":"","ref":"Lightning.Accounts.UserNotifier.html#notify_project_deletion/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.remind_account_confirmation/2","doc":"","ref":"Lightning.Accounts.UserNotifier.html#remind_account_confirmation/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.send_credential_deletion_notification_email/2","doc":"","ref":"Lightning.Accounts.UserNotifier.html#send_credential_deletion_notification_email/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.send_data_retention_change_email/2","doc":"Deliver an email to notify the user about a data retention setting change made in their project","ref":"Lightning.Accounts.UserNotifier.html#send_data_retention_change_email/2"},{"type":"function","title":"Lightning.Accounts.UserNotifier.send_deletion_notification_email/1","doc":"Deliver an email to notify the user about their account being deleted","ref":"Lightning.Accounts.UserNotifier.html#send_deletion_notification_email/1"},{"type":"function","title":"Lightning.Accounts.UserNotifier.send_trigger_failure_mail/3","doc":"","ref":"Lightning.Accounts.UserNotifier.html#send_trigger_failure_mail/3"},{"type":"module","title":"Lightning.Accounts.UserTOTP","doc":"User Time based OTPs schema","ref":"Lightning.Accounts.UserTOTP.html"},{"type":"function","title":"Lightning.Accounts.UserTOTP.changeset/2","doc":"","ref":"Lightning.Accounts.UserTOTP.html#changeset/2"},{"type":"function","title":"Lightning.Accounts.UserTOTP.valid_totp?/2","doc":"","ref":"Lightning.Accounts.UserTOTP.html#valid_totp?/2"},{"type":"type","title":"Lightning.Accounts.UserTOTP.t/0","doc":"","ref":"Lightning.Accounts.UserTOTP.html#t:t/0"},{"type":"module","title":"Lightning.Accounts.UserToken","doc":"The UserToken model.\n\nThe reason why we store session tokens in the database, even\nthough Phoenix already provides a session cookie, is because\nPhoenix' default session cookies are not persisted, they are\nsimply signed and potentially encrypted. This means they are\nvalid indefinitely, unless you change the signing/encryption\nsalt.\n\nTherefore, storing them allows individual user\nsessions to be expired. The token system can also be extended\nto store additional data, such as the device used for logging in.\nYou could then use this information to display all valid sessions\nand devices in the UI and allow users to explicitly expire any\nsession they deem invalid.","ref":"Lightning.Accounts.UserToken.html"},{"type":"function","title":"Lightning.Accounts.UserToken.build_email_token/3","doc":"Builds a token and its hash to be delivered to the user's email.\n\nThe non-hashed token is sent to the user email while the\nhashed part is stored in the database. The original token cannot be reconstructed,\nwhich means anyone with read-only access to the database cannot directly use\nthe token in the application to gain access. Furthermore, if the user changes\ntheir email in the system, the tokens sent to the previous email are no longer\nvalid.\n\nUsers can easily adapt the existing code to provide other types of delivery methods,\nfor example, by phone numbers.","ref":"Lightning.Accounts.UserToken.html#build_email_token/3"},{"type":"function","title":"Lightning.Accounts.UserToken.build_token/2","doc":"Generates a token that will be stored in a signed place,\nsuch as session or cookie. As they are signed, those\ntokens do not need to be hashed.","ref":"Lightning.Accounts.UserToken.html#build_token/2"},{"type":"function","title":"Lightning.Accounts.UserToken.changeset/2","doc":"","ref":"Lightning.Accounts.UserToken.html#changeset/2"},{"type":"function","title":"Lightning.Accounts.UserToken.last_used_changeset/1","doc":"Update when the api token was last used by setting`last_used_at`.","ref":"Lightning.Accounts.UserToken.html#last_used_changeset/1"},{"type":"function","title":"Lightning.Accounts.UserToken.token_and_context_query/2","doc":"Returns the token struct for the given token value and context.","ref":"Lightning.Accounts.UserToken.html#token_and_context_query/2"},{"type":"function","title":"Lightning.Accounts.UserToken.user_and_contexts_query/2","doc":"Gets all tokens for the given user for the given contexts.","ref":"Lightning.Accounts.UserToken.html#user_and_contexts_query/2"},{"type":"function","title":"Lightning.Accounts.UserToken.verify_change_email_token_query/2","doc":"Checks if the token is valid and returns its underlying lookup query.\n\nThe query returns the user found by the token, if any.\n\nThis is used to validate requests to change the user\nemail. It is different from `verify_email_token_query/2` precisely because\n`verify_email_token_query/2` validates the email has not changed, which is\nthe starting point by this function.\n\nThe given token is valid if it matches its hashed counterpart in the\ndatabase and if it has not expired (after @change_email_validity_in_days).\nThe context must always start with \"change:\".","ref":"Lightning.Accounts.UserToken.html#verify_change_email_token_query/2"},{"type":"function","title":"Lightning.Accounts.UserToken.verify_email_token_query/2","doc":"Checks if the token is valid and returns its underlying lookup query.\n\nThe query returns the user found by the token, if any.\n\nThe given token is valid if it matches its hashed counterpart in the\ndatabase and the user email has not changed. This function also checks\nif the token is being used within a certain period, depending on the\ncontext. The default contexts supported by this function are either\n\"confirm\", for account confirmation emails, and \"reset_password\",\nfor resetting the password. For verifying requests to change the email,\nsee `verify_change_email_token_query/2`.","ref":"Lightning.Accounts.UserToken.html#verify_email_token_query/2"},{"type":"function","title":"Lightning.Accounts.UserToken.verify_token_query/2","doc":"Checks if the token is valid and returns its underlying lookup query.\n\nThe query returns the user found by the token, if any.\n\nThe token is valid if it matches the value in the database and it has\nnot expired (after @auth_validity_in_seconds or @session_validity_in_days).","ref":"Lightning.Accounts.UserToken.html#verify_token_query/2"},{"type":"behaviour","title":"Lightning.Config","doc":"Centralised runtime configuration for Lightning.","ref":"Lightning.Config.html"},{"type":"function","title":"Lightning.Config.apollo/1","doc":"Returns the Apollo server configuration.","ref":"Lightning.Config.html#apollo/1"},{"type":"callback","title":"Lightning.Config.apollo/1","doc":"","ref":"Lightning.Config.html#c:apollo/1"},{"type":"function","title":"Lightning.Config.check_flag?/1","doc":"","ref":"Lightning.Config.html#check_flag?/1"},{"type":"callback","title":"Lightning.Config.check_flag?/1","doc":"","ref":"Lightning.Config.html#c:check_flag?/1"},{"type":"function","title":"Lightning.Config.cors_origin/0","doc":"","ref":"Lightning.Config.html#cors_origin/0"},{"type":"callback","title":"Lightning.Config.cors_origin/0","doc":"","ref":"Lightning.Config.html#c:cors_origin/0"},{"type":"function","title":"Lightning.Config.default_max_run_duration/0","doc":"Returns the default maximum run duration in seconds.","ref":"Lightning.Config.html#default_max_run_duration/0"},{"type":"callback","title":"Lightning.Config.default_max_run_duration/0","doc":"","ref":"Lightning.Config.html#c:default_max_run_duration/0"},{"type":"function","title":"Lightning.Config.email_sender_name/0","doc":"","ref":"Lightning.Config.html#email_sender_name/0"},{"type":"callback","title":"Lightning.Config.email_sender_name/0","doc":"","ref":"Lightning.Config.html#c:email_sender_name/0"},{"type":"function","title":"Lightning.Config.get_extension_mod/1","doc":"","ref":"Lightning.Config.html#get_extension_mod/1"},{"type":"callback","title":"Lightning.Config.get_extension_mod/1","doc":"","ref":"Lightning.Config.html#c:get_extension_mod/1"},{"type":"function","title":"Lightning.Config.google/1","doc":"","ref":"Lightning.Config.html#google/1"},{"type":"callback","title":"Lightning.Config.google/1","doc":"","ref":"Lightning.Config.html#c:google/1"},{"type":"function","title":"Lightning.Config.grace_period/0","doc":"The grace period is configurable and is used to wait for an additional\namount of time after a given run was meant to be finished.\n\nThe returned value is in seconds.","ref":"Lightning.Config.html#grace_period/0"},{"type":"callback","title":"Lightning.Config.grace_period/0","doc":"","ref":"Lightning.Config.html#c:grace_period/0"},{"type":"function","title":"Lightning.Config.instance_admin_email/0","doc":"","ref":"Lightning.Config.html#instance_admin_email/0"},{"type":"callback","title":"Lightning.Config.instance_admin_email/0","doc":"","ref":"Lightning.Config.html#c:instance_admin_email/0"},{"type":"function","title":"Lightning.Config.kafka_alternate_storage_enabled?/0","doc":"","ref":"Lightning.Config.html#kafka_alternate_storage_enabled?/0"},{"type":"callback","title":"Lightning.Config.kafka_alternate_storage_enabled?/0","doc":"","ref":"Lightning.Config.html#c:kafka_alternate_storage_enabled?/0"},{"type":"function","title":"Lightning.Config.kafka_alternate_storage_file_path/0","doc":"","ref":"Lightning.Config.html#kafka_alternate_storage_file_path/0"},{"type":"callback","title":"Lightning.Config.kafka_alternate_storage_file_path/0","doc":"","ref":"Lightning.Config.html#c:kafka_alternate_storage_file_path/0"},{"type":"function","title":"Lightning.Config.kafka_duplicate_tracking_retention_seconds/0","doc":"","ref":"Lightning.Config.html#kafka_duplicate_tracking_retention_seconds/0"},{"type":"callback","title":"Lightning.Config.kafka_duplicate_tracking_retention_seconds/0","doc":"","ref":"Lightning.Config.html#c:kafka_duplicate_tracking_retention_seconds/0"},{"type":"function","title":"Lightning.Config.kafka_notification_embargo_seconds/0","doc":"","ref":"Lightning.Config.html#kafka_notification_embargo_seconds/0"},{"type":"callback","title":"Lightning.Config.kafka_notification_embargo_seconds/0","doc":"","ref":"Lightning.Config.html#c:kafka_notification_embargo_seconds/0"},{"type":"function","title":"Lightning.Config.kafka_number_of_consumers/0","doc":"","ref":"Lightning.Config.html#kafka_number_of_consumers/0"},{"type":"callback","title":"Lightning.Config.kafka_number_of_consumers/0","doc":"","ref":"Lightning.Config.html#c:kafka_number_of_consumers/0"},{"type":"function","title":"Lightning.Config.kafka_number_of_messages_per_second/0","doc":"","ref":"Lightning.Config.html#kafka_number_of_messages_per_second/0"},{"type":"callback","title":"Lightning.Config.kafka_number_of_messages_per_second/0","doc":"","ref":"Lightning.Config.html#c:kafka_number_of_messages_per_second/0"},{"type":"function","title":"Lightning.Config.kafka_number_of_processors/0","doc":"","ref":"Lightning.Config.html#kafka_number_of_processors/0"},{"type":"callback","title":"Lightning.Config.kafka_number_of_processors/0","doc":"","ref":"Lightning.Config.html#c:kafka_number_of_processors/0"},{"type":"function","title":"Lightning.Config.kafka_triggers_enabled?/0","doc":"","ref":"Lightning.Config.html#kafka_triggers_enabled?/0"},{"type":"callback","title":"Lightning.Config.kafka_triggers_enabled?/0","doc":"","ref":"Lightning.Config.html#c:kafka_triggers_enabled?/0"},{"type":"function","title":"Lightning.Config.oauth_provider/1","doc":"","ref":"Lightning.Config.html#oauth_provider/1"},{"type":"callback","title":"Lightning.Config.oauth_provider/1","doc":"","ref":"Lightning.Config.html#c:oauth_provider/1"},{"type":"function","title":"Lightning.Config.purge_deleted_after_days/0","doc":"","ref":"Lightning.Config.html#purge_deleted_after_days/0"},{"type":"callback","title":"Lightning.Config.purge_deleted_after_days/0","doc":"","ref":"Lightning.Config.html#c:purge_deleted_after_days/0"},{"type":"function","title":"Lightning.Config.repo_connection_token_signer/0","doc":"","ref":"Lightning.Config.html#repo_connection_token_signer/0"},{"type":"callback","title":"Lightning.Config.repo_connection_token_signer/0","doc":"","ref":"Lightning.Config.html#c:repo_connection_token_signer/0"},{"type":"function","title":"Lightning.Config.reset_password_token_validity_in_days/0","doc":"","ref":"Lightning.Config.html#reset_password_token_validity_in_days/0"},{"type":"callback","title":"Lightning.Config.reset_password_token_validity_in_days/0","doc":"","ref":"Lightning.Config.html#c:reset_password_token_validity_in_days/0"},{"type":"function","title":"Lightning.Config.run_token_signer/0","doc":"Returns the Token signer used to sign and verify run tokens.","ref":"Lightning.Config.html#run_token_signer/0"},{"type":"callback","title":"Lightning.Config.run_token_signer/0","doc":"","ref":"Lightning.Config.html#c:run_token_signer/0"},{"type":"function","title":"Lightning.Config.storage/0","doc":"","ref":"Lightning.Config.html#storage/0"},{"type":"callback","title":"Lightning.Config.storage/0","doc":"","ref":"Lightning.Config.html#c:storage/0"},{"type":"function","title":"Lightning.Config.storage/1","doc":"","ref":"Lightning.Config.html#storage/1"},{"type":"callback","title":"Lightning.Config.storage/1","doc":"","ref":"Lightning.Config.html#c:storage/1"},{"type":"function","title":"Lightning.Config.token_signer/0","doc":"","ref":"Lightning.Config.html#token_signer/0"},{"type":"callback","title":"Lightning.Config.token_signer/0","doc":"","ref":"Lightning.Config.html#c:token_signer/0"},{"type":"function","title":"Lightning.Config.usage_tracking/0","doc":"","ref":"Lightning.Config.html#usage_tracking/0"},{"type":"callback","title":"Lightning.Config.usage_tracking/0","doc":"","ref":"Lightning.Config.html#c:usage_tracking/0"},{"type":"function","title":"Lightning.Config.usage_tracking_cron_opts/0","doc":"","ref":"Lightning.Config.html#usage_tracking_cron_opts/0"},{"type":"callback","title":"Lightning.Config.usage_tracking_cron_opts/0","doc":"","ref":"Lightning.Config.html#c:usage_tracking_cron_opts/0"},{"type":"function","title":"Lightning.Config.worker_secret/0","doc":"","ref":"Lightning.Config.html#worker_secret/0"},{"type":"callback","title":"Lightning.Config.worker_secret/0","doc":"","ref":"Lightning.Config.html#c:worker_secret/0"},{"type":"function","title":"Lightning.Config.worker_token_signer/0","doc":"Returns the Token signer used to verify worker tokens.","ref":"Lightning.Config.html#worker_token_signer/0"},{"type":"callback","title":"Lightning.Config.worker_token_signer/0","doc":"","ref":"Lightning.Config.html#c:worker_token_signer/0"},{"type":"module","title":"Lightning.Config.Bootstrap","doc":"Bootstrap the application environment.\n\nThis module is responsible for setting up the application environment based on\nthe configuration provided by the user.\n\nUsually, config calls are made in the `config/runtime.exs` file. This module\nabstracts the runtime configuration into a module that can be tested and\ncalled from other places (aside from `config/runtime.exs`) file.\n\n> #### Sourcing envs {: .info}\n>\n> Internally this module uses `Dotenvy.source/1` to source environment variables\n> from the `.env`, `.env. `, and `.env. .override` files.\n> It also sources the system environment variables.\n>\n> Calling `configure/0` without calling `source_envs/0` or `Dotenvy.source/2`\n> first will result in no environment variables being loaded.\n\nUsage:\n\n```elixir\nLightning.Config.Bootstrap.source_envs()\nLightning.Config.Bootstrap.configure()\n```","ref":"Lightning.Config.Bootstrap.html"},{"type":"function","title":"Lightning.Config.Bootstrap.configure/0","doc":"","ref":"Lightning.Config.Bootstrap.html#configure/0"},{"type":"function","title":"Lightning.Config.Bootstrap.source_envs/0","doc":"","ref":"Lightning.Config.Bootstrap.html#source_envs/0"},{"type":"module","title":"Lightning.Config.Utils","doc":"Utility functions for working with the application environment.","ref":"Lightning.Config.Utils.html"},{"type":"function","title":"Lightning.Config.Utils.ensure_boolean/1","doc":"","ref":"Lightning.Config.Utils.html#ensure_boolean/1"},{"type":"function","title":"Lightning.Config.Utils.get_env/2","doc":"Retrieve a value nested in the application environment.","ref":"Lightning.Config.Utils.html#get_env/2"},{"type":"module","title":"Lightning.Runs","doc":"Gathers operations to create, update and delete Runs.","ref":"Lightning.Runs.html"},{"type":"function","title":"Lightning.Runs.append_run_log/3","doc":"","ref":"Lightning.Runs.html#append_run_log/3"},{"type":"function","title":"Lightning.Runs.complete_run/2","doc":"","ref":"Lightning.Runs.html#complete_run/2"},{"type":"function","title":"Lightning.Runs.complete_step/2","doc":"","ref":"Lightning.Runs.html#complete_step/2"},{"type":"function","title":"Lightning.Runs.enqueue/1","doc":"Enqueue a run to be processed.","ref":"Lightning.Runs.html#enqueue/1"},{"type":"function","title":"Lightning.Runs.get/2","doc":"Get a run by id.\n\nOptionally preload associations by passing a list of atoms to `:include`.\n\n Lightning.Runs.get(id, include: [:workflow])","ref":"Lightning.Runs.html#get/2"},{"type":"function","title":"Lightning.Runs.get_credential/2","doc":"","ref":"Lightning.Runs.html#get_credential/2"},{"type":"function","title":"Lightning.Runs.get_dataclip_body/1","doc":"Returns only the dataclip body as a string","ref":"Lightning.Runs.html#get_dataclip_body/1"},{"type":"function","title":"Lightning.Runs.get_dataclip_request/1","doc":"Returns only the dataclip request as a string","ref":"Lightning.Runs.html#get_dataclip_request/1"},{"type":"function","title":"Lightning.Runs.get_for_worker/1","doc":"Get a run by id, preloading the snapshot and its credential.","ref":"Lightning.Runs.html#get_for_worker/1"},{"type":"function","title":"Lightning.Runs.get_input/1","doc":"Returns a run's dataclip formatted for use as state.\n\nOnly `http_request` and kafka dataclips are changed,\ntheir `body` is nested inside a `\"data\"` key and `request` data\nis added as a `\"request\"` key.\n\nSee LightingWeb.RunChannel.handle_in(\"fetch:dataclip\", _, _)\nfor more details.","ref":"Lightning.Runs.html#get_input/1"},{"type":"function","title":"Lightning.Runs.get_log_lines/2","doc":"","ref":"Lightning.Runs.html#get_log_lines/2"},{"type":"function","title":"Lightning.Runs.get_project_id_for_run/1","doc":"","ref":"Lightning.Runs.html#get_project_id_for_run/1"},{"type":"function","title":"Lightning.Runs.mark_run_lost/1","doc":"","ref":"Lightning.Runs.html#mark_run_lost/1"},{"type":"function","title":"Lightning.Runs.mark_steps_lost/1","doc":"","ref":"Lightning.Runs.html#mark_steps_lost/1"},{"type":"function","title":"Lightning.Runs.start_run/2","doc":"","ref":"Lightning.Runs.html#start_run/2"},{"type":"function","title":"Lightning.Runs.start_step/2","doc":"Creates a Step for a given run and job.\n\nThe Step is created and marked as started at the current time.","ref":"Lightning.Runs.html#start_step/2"},{"type":"function","title":"Lightning.Runs.subscribe/1","doc":"","ref":"Lightning.Runs.html#subscribe/1"},{"type":"function","title":"Lightning.Runs.update_run/1","doc":"","ref":"Lightning.Runs.html#update_run/1"},{"type":"function","title":"Lightning.Runs.update_runs/2","doc":"","ref":"Lightning.Runs.html#update_runs/2"},{"type":"function","title":"Lightning.Runs.wipe_dataclips/1","doc":"Clears the body and request fields of the dataclip associated with the given run.","ref":"Lightning.Runs.html#wipe_dataclips/1"},{"type":"module","title":"Lightning.Runs.Events","doc":"","ref":"Lightning.Runs.Events.html"},{"type":"function","title":"Lightning.Runs.Events.dataclip_updated/2","doc":"","ref":"Lightning.Runs.Events.html#dataclip_updated/2"},{"type":"function","title":"Lightning.Runs.Events.log_appended/1","doc":"","ref":"Lightning.Runs.Events.html#log_appended/1"},{"type":"function","title":"Lightning.Runs.Events.run_updated/1","doc":"","ref":"Lightning.Runs.Events.html#run_updated/1"},{"type":"function","title":"Lightning.Runs.Events.step_completed/2","doc":"","ref":"Lightning.Runs.Events.html#step_completed/2"},{"type":"function","title":"Lightning.Runs.Events.step_started/2","doc":"","ref":"Lightning.Runs.Events.html#step_started/2"},{"type":"function","title":"Lightning.Runs.Events.subscribe/1","doc":"","ref":"Lightning.Runs.Events.html#subscribe/1"},{"type":"module","title":"Lightning.Runs.Handlers","doc":"Handler modules for working with runs.","ref":"Lightning.Runs.Handlers.html"},{"type":"module","title":"Lightning.Runs.Handlers.CompleteRun","doc":"Schema to validate the input attributes of a completed run.","ref":"Lightning.Runs.Handlers.CompleteRun.html"},{"type":"function","title":"Lightning.Runs.Handlers.CompleteRun.call/2","doc":"","ref":"Lightning.Runs.Handlers.CompleteRun.html#call/2"},{"type":"function","title":"Lightning.Runs.Handlers.CompleteRun.new/1","doc":"","ref":"Lightning.Runs.Handlers.CompleteRun.html#new/1"},{"type":"module","title":"Lightning.Runs.Handlers.CompleteStep","doc":"Schema to validate the input attributes of a completed step.","ref":"Lightning.Runs.Handlers.CompleteStep.html"},{"type":"function","title":"Lightning.Runs.Handlers.CompleteStep.call/2","doc":"","ref":"Lightning.Runs.Handlers.CompleteStep.html#call/2"},{"type":"function","title":"Lightning.Runs.Handlers.CompleteStep.new/2","doc":"","ref":"Lightning.Runs.Handlers.CompleteStep.html#new/2"},{"type":"module","title":"Lightning.Runs.Handlers.StartRun","doc":"Schema to validate the input attributes of a started run.","ref":"Lightning.Runs.Handlers.StartRun.html"},{"type":"function","title":"Lightning.Runs.Handlers.StartRun.call/2","doc":"","ref":"Lightning.Runs.Handlers.StartRun.html#call/2"},{"type":"function","title":"Lightning.Runs.Handlers.StartRun.new/1","doc":"","ref":"Lightning.Runs.Handlers.StartRun.html#new/1"},{"type":"module","title":"Lightning.Runs.Handlers.StartStep","doc":"Schema to validate the input attributes of a started step.","ref":"Lightning.Runs.Handlers.StartStep.html"},{"type":"function","title":"Lightning.Runs.Handlers.StartStep.call/2","doc":"","ref":"Lightning.Runs.Handlers.StartStep.html#call/2"},{"type":"module","title":"Lightning.Runs.PromExPlugin","doc":"Metrics callbacks implementation for the PromEx plugin.\n\nEvent metrics are used to publish the dispatched events in the system.\nPolling metrics are used to publish metrics that are calculated by polling data periodically.","ref":"Lightning.Runs.PromExPlugin.html"},{"type":"function","title":"Lightning.Runs.PromExPlugin.calculate_average_claim_duration/2","doc":"","ref":"Lightning.Runs.PromExPlugin.html#calculate_average_claim_duration/2"},{"type":"function","title":"Lightning.Runs.PromExPlugin.count_finalised_runs/1","doc":"","ref":"Lightning.Runs.PromExPlugin.html#count_finalised_runs/1"},{"type":"function","title":"Lightning.Runs.PromExPlugin.run_queue_metrics/2","doc":"","ref":"Lightning.Runs.PromExPlugin.html#run_queue_metrics/2"},{"type":"function","title":"Lightning.Runs.PromExPlugin.stalled_run_count/1","doc":"","ref":"Lightning.Runs.PromExPlugin.html#stalled_run_count/1"},{"type":"module","title":"Lightning.Runs.Query","doc":"Query functions for working with Runs","ref":"Lightning.Runs.Query.html"},{"type":"function","title":"Lightning.Runs.Query.eligible_for_claim/0","doc":"Query to return runs that are eligible for claiming.\n\nUses `in_progress_window/0` and filters for runs that are either in the\navailable state and have not reached the concurrency limit for their workflow.\n\n>","ref":"Lightning.Runs.Query.html#eligible_for_claim/0"},{"type":"function","title":"Note {: .info} - Lightning.Runs.Query.eligible_for_claim/0","doc":"> This query does not currently take into account the priority of the run.\n> To allow for prioritization, the query should be updated to order by\n> priority.\n>\n> ```elixir\n> eligible_for_claim() |> prepend_order_by([:priority])\n> ```","ref":"Lightning.Runs.Query.html#eligible_for_claim/0-note-info"},{"type":"function","title":"Lightning.Runs.Query.in_progress_window/0","doc":"Query to return a list of runs that are either in progress (started or claimed)\nor available.\n\nThe select clause includes:\n- `id`, the id of the run\n- `state`, the state of the run\n- `row_number`, the number of the row in the window, per workflow\n- `limit`, the maximum number of runs that can be claimed for the workflow","ref":"Lightning.Runs.Query.html#in_progress_window/0"},{"type":"function","title":"Lightning.Runs.Query.lost/0","doc":"Return all runs that have been claimed by a worker before the earliest\nacceptable start time (determined by the run options and grace period) but are\nstill incomplete.\n\nThis indicates that we may have lost contact with the worker\nthat was responsible for executing the run.","ref":"Lightning.Runs.Query.html#lost/0"},{"type":"function","title":"Lightning.Runs.Query.lost_steps/0","doc":"","ref":"Lightning.Runs.Query.html#lost_steps/0"},{"type":"module","title":"Lightning.Runs.Queue","doc":"Allows adding, removing or claiming work to be executed by the Runtime.","ref":"Lightning.Runs.Queue.html"},{"type":"function","title":"Lightning.Runs.Queue.claim/2","doc":"","ref":"Lightning.Runs.Queue.html#claim/2"},{"type":"module","title":"Lightning.Runs.RunOptions","doc":"Options that are passed to the worker to control configurable limits and\nbehaviors during run execution and reporting.","ref":"Lightning.Runs.RunOptions.html"},{"type":"function","title":"Lightning.Runs.RunOptions.new/1","doc":"","ref":"Lightning.Runs.RunOptions.html#new/1"},{"type":"type","title":"Lightning.Runs.RunOptions.keyword_list/0","doc":"","ref":"Lightning.Runs.RunOptions.html#t:keyword_list/0"},{"type":"type","title":"Lightning.Runs.RunOptions.t/0","doc":"","ref":"Lightning.Runs.RunOptions.html#t:t/0"},{"type":"module","title":"Lightning.WorkOrders","doc":"Context for creating WorkOrders.","ref":"Lightning.WorkOrders.html"},{"type":"module","title":"Work Orders - Lightning.WorkOrders","doc":"Work Orders represent the entrypoint for a unit of work in Lightning.\nThey allow you to track the status of a webhook or cron trigger.\n\nFor example if a user makes a request to a webhook endpoint, a Work Order\nis created with it's associated Workflow and Dataclip.\n\nEvery Work Order has at least one Run, which represents a single\ninvocation of the Workflow. If the workflow fails, and the run is retried,\na new Run is created on the Work Order.\n\nThis allows you group all the runs for a single webhook, and track\nthe success or failure of a given dataclip.","ref":"Lightning.WorkOrders.html#module-work-orders"},{"type":"module","title":"Creating Work Orders - Lightning.WorkOrders","doc":"Work Orders can be created in three ways:\n\n1. Via a webhook trigger\n2. Via a cron trigger\n3. Manually by a user (via the UI or API)\n\nRetries do not create new Work Orders, but rather new Runs on the existing\nWork Order.","ref":"Lightning.WorkOrders.html#module-creating-work-orders"},{"type":"function","title":"Lightning.WorkOrders.build/1","doc":"","ref":"Lightning.WorkOrders.html#build/1"},{"type":"function","title":"Lightning.WorkOrders.build_for/2","doc":"","ref":"Lightning.WorkOrders.html#build_for/2"},{"type":"function","title":"Lightning.WorkOrders.create_for/1","doc":"","ref":"Lightning.WorkOrders.html#create_for/1"},{"type":"function","title":"Lightning.WorkOrders.create_for/3","doc":"Create a new Work Order.\n\n**For a webhook**\n create_for(trigger, workflow: workflow, dataclip: dataclip)\n\n**For a user**\n create_for(job, workflow: workflow, dataclip: dataclip, user: user)","ref":"Lightning.WorkOrders.html#create_for/3"},{"type":"function","title":"Lightning.WorkOrders.enqueue_many_for_retry/2","doc":"Enqueue multiple runs for retry in the same transaction.","ref":"Lightning.WorkOrders.html#enqueue_many_for_retry/2"},{"type":"function","title":"Lightning.WorkOrders.get/2","doc":"Get a Work Order by id.\n\nOptionally preload associations by passing a list of atoms to `:include`.\n\n Lightning.WorkOrders.get(id, include: [:runs])","ref":"Lightning.WorkOrders.html#get/2"},{"type":"function","title":"Lightning.WorkOrders.retry/3","doc":"Retry a run from a given step.\n\nThis will create a new Run on the Work Order, and enqueue it for\nprocessing.\n\nWhen creating a new Run, a graph of the workflow is created steps that are\nindependent from the selected step and its downstream flow are associated with\nthis new run, but not executed again.","ref":"Lightning.WorkOrders.html#retry/3"},{"type":"function","title":"Lightning.WorkOrders.retry_many/2","doc":"","ref":"Lightning.WorkOrders.html#retry_many/2"},{"type":"function","title":"Lightning.WorkOrders.retry_many/3","doc":"","ref":"Lightning.WorkOrders.html#retry_many/3"},{"type":"function","title":"Lightning.WorkOrders.subscribe/1","doc":"","ref":"Lightning.WorkOrders.html#subscribe/1"},{"type":"function","title":"Lightning.WorkOrders.update_state/1","doc":"Updates the state of a WorkOrder based on the state of a run.\n\nThis considers the state of all runs on the WorkOrder, with the\nRun passed in as the latest run.\n\nSee `Lightning.WorkOrders.Query.state_for/1` for more details.","ref":"Lightning.WorkOrders.html#update_state/1"},{"type":"type","title":"Lightning.WorkOrders.work_order_option/0","doc":"","ref":"Lightning.WorkOrders.html#t:work_order_option/0"},{"type":"module","title":"Lightning.WorkOrders.ExportAudit","doc":"Module to log history export actions as audit events.","ref":"Lightning.WorkOrders.ExportAudit.html"},{"type":"function","title":"Lightning.WorkOrders.ExportAudit.base_query/0","doc":"","ref":"Lightning.WorkOrders.ExportAudit.html#base_query/0"},{"type":"function","title":"Lightning.WorkOrders.ExportAudit.event/5","doc":"","ref":"Lightning.WorkOrders.ExportAudit.html#event/5"},{"type":"function","title":"Lightning.WorkOrders.ExportAudit.save/1","doc":"","ref":"Lightning.WorkOrders.ExportAudit.html#save/1"},{"type":"function","title":"Lightning.WorkOrders.ExportAudit.update_changes/1","doc":"","ref":"Lightning.WorkOrders.ExportAudit.html#update_changes/1"},{"type":"module","title":"Lightning.WorkOrders.ExportWorker","doc":"This module handles the export of work orders for a given project. The export process is performed asynchronously using the Oban background job system.","ref":"Lightning.WorkOrders.ExportWorker.html"},{"type":"module","title":"Responsibilities - Lightning.WorkOrders.ExportWorker","doc":"- **Enqueueing Export Jobs**: The `enqueue_export/2` function creates and enqueues an Oban job for exporting work orders based on the given project and search parameters.\n - **Processing Exports**: The `perform/1` function is the main entry point for executing the export job. It retrieves the project, processes work orders, and handles the export process.\n - **Export Logic**: The export logic involves querying work orders, extracting relevant entities, processing logs and dataclips asynchronously, and writing the final export data to files.\n - **Error Handling**: The module includes comprehensive error handling and logging to ensure that issues during the export process are recorded and can be diagnosed.\n - **Zip File Creation**: After processing, the exported files are compressed into a zip file for easy download or further use.","ref":"Lightning.WorkOrders.ExportWorker.html#module-responsibilities"},{"type":"module","title":"Usage - Lightning.WorkOrders.ExportWorker","doc":"- To enqueue an export job, call `enqueue_export/2` with the project and search parameters.\n - The export process is triggered by Oban and runs in the `history_exports` queue, limited to a single attempt per job.","ref":"Lightning.WorkOrders.ExportWorker.html#module-usage"},{"type":"module","title":"Example - Lightning.WorkOrders.ExportWorker","doc":"```elixir\n # Enqueue an export job\n Lightning.WorkOrders.ExportWorker.enqueue_export(project, search_params)\n\n # The job will run in the background and log the status of the export process.\n ```\n\n This module is designed to handle potentially large datasets efficiently by using streaming, async processing, and error recovery mechanisms.","ref":"Lightning.WorkOrders.ExportWorker.html#module-example"},{"type":"function","title":"Lightning.WorkOrders.ExportWorker.enqueue_export/3","doc":"","ref":"Lightning.WorkOrders.ExportWorker.html#enqueue_export/3"},{"type":"function","title":"Lightning.WorkOrders.ExportWorker.extract_entities/1","doc":"","ref":"Lightning.WorkOrders.ExportWorker.html#extract_entities/1"},{"type":"function","title":"Lightning.WorkOrders.ExportWorker.fetch_dataclips/1","doc":"","ref":"Lightning.WorkOrders.ExportWorker.html#fetch_dataclips/1"},{"type":"module","title":"Lightning.WorkOrders.Manual","doc":"A model is used to build WorkOrders with custom input data.","ref":"Lightning.WorkOrders.Manual.html"},{"type":"function","title":"Lightning.WorkOrders.Manual.new/2","doc":"","ref":"Lightning.WorkOrders.Manual.html#new/2"},{"type":"type","title":"Lightning.WorkOrders.Manual.t/0","doc":"","ref":"Lightning.WorkOrders.Manual.html#t:t/0"},{"type":"module","title":"Lightning.WorkOrders.Query","doc":"Query functions for the Lightning.WorkOrders module.","ref":"Lightning.WorkOrders.Query.html"},{"type":"function","title":"Lightning.WorkOrders.Query.state_for/1","doc":"Query to calculate the current state of a workorder.\n\nIt takes a run, as the state is updated after each run is changed.\n\nThe logic is as follows:\n\n- All _other_ Runs that are not in a finished state are considered first.\n- The current Run is unioned onto the unfinished runs with a null\n ordinality.\n- The runs are ordered by state in the following order\n `started > available > claimed > null`\n- The run states are then mapped to the workorder state enum, so `available`\n and `claimed` are both mapped to `pending` and `started` is mapped to `running`\n\n> The `null` ordinality ensures that the current run is always last in the\n> ordering.","ref":"Lightning.WorkOrders.Query.html#state_for/1"},{"type":"module","title":"Lightning.WorkOrders.RetryManyWorkOrdersJob","doc":"Enqueue multiple work orders for retry.","ref":"Lightning.WorkOrders.RetryManyWorkOrdersJob.html"},{"type":"module","title":"Lightning.WorkOrders.SearchParams","doc":"This module is used to parse search parameters for work orders and provide\na query to the database.","ref":"Lightning.WorkOrders.SearchParams.html"},{"type":"function","title":"Lightning.WorkOrders.SearchParams.all_statuses_set?/1","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#all_statuses_set?/1"},{"type":"function","title":"Lightning.WorkOrders.SearchParams.from_map/1","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#from_map/1"},{"type":"function","title":"Lightning.WorkOrders.SearchParams.new/1","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#new/1"},{"type":"macro","title":"Lightning.WorkOrders.SearchParams.status_list/0","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#status_list/0"},{"type":"function","title":"Lightning.WorkOrders.SearchParams.to_uri_params/1","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#to_uri_params/1"},{"type":"type","title":"Lightning.WorkOrders.SearchParams.t/0","doc":"","ref":"Lightning.WorkOrders.SearchParams.html#t:t/0"},{"type":"module","title":"Lightning.Credentials","doc":"The Credentials context.","ref":"Lightning.Credentials.html"},{"type":"function","title":"Lightning.Credentials.basic_auth_for/1","doc":"","ref":"Lightning.Credentials.html#basic_auth_for/1"},{"type":"function","title":"Lightning.Credentials.cancel_scheduled_deletion/1","doc":"","ref":"Lightning.Credentials.html#cancel_scheduled_deletion/1"},{"type":"function","title":"Lightning.Credentials.change_credential/2","doc":"Returns an `%Ecto.Changeset{}` for tracking credential changes.","ref":"Lightning.Credentials.html#change_credential/2"},{"type":"function","title":"Examples - Lightning.Credentials.change_credential/2","doc":"iex> change_credential(credential)\n %Ecto.Changeset{data: %Credential{}}","ref":"Lightning.Credentials.html#change_credential/2-examples"},{"type":"function","title":"Lightning.Credentials.create_credential/1","doc":"Creates a credential.","ref":"Lightning.Credentials.html#create_credential/1"},{"type":"function","title":"Examples - Lightning.Credentials.create_credential/1","doc":"iex> create_credential(%{field: value})\n {:ok, %Credential{}}\n\n iex> create_credential(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Credentials.html#create_credential/1-examples"},{"type":"function","title":"Lightning.Credentials.delete_credential/1","doc":"Deletes a credential.","ref":"Lightning.Credentials.html#delete_credential/1"},{"type":"function","title":"Examples - Lightning.Credentials.delete_credential/1","doc":"iex> delete_credential(credential)\n {:ok, %Credential{}}\n\n iex> delete_credential(credential)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Credentials.html#delete_credential/1-examples"},{"type":"function","title":"Lightning.Credentials.get_credential!/1","doc":"Gets a single credential.\n\nRaises `Ecto.NoResultsError` if the Credential does not exist.","ref":"Lightning.Credentials.html#get_credential!/1"},{"type":"function","title":"Examples - Lightning.Credentials.get_credential!/1","doc":"iex> get_credential!(123)\n %Credential{}\n\n iex> get_credential!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Credentials.html#get_credential!/1-examples"},{"type":"function","title":"Lightning.Credentials.get_credential_by_project_credential/1","doc":"","ref":"Lightning.Credentials.html#get_credential_by_project_credential/1"},{"type":"function","title":"Lightning.Credentials.get_credential_for_update!/1","doc":"","ref":"Lightning.Credentials.html#get_credential_for_update!/1"},{"type":"function","title":"Lightning.Credentials.get_schema/1","doc":"Creates a credential schema from credential json schema.","ref":"Lightning.Credentials.html#get_schema/1"},{"type":"function","title":"Lightning.Credentials.has_activity_in_projects?/1","doc":"Checks if a given `Credential` has any associated `Step` activity.","ref":"Lightning.Credentials.html#has_activity_in_projects?/1"},{"type":"function","title":"Parameters - Lightning.Credentials.has_activity_in_projects?/1","doc":"- `_credential`: A `Credential` struct. Only the `id` field is used by the function.","ref":"Lightning.Credentials.html#has_activity_in_projects?/1-parameters"},{"type":"function","title":"Returns - Lightning.Credentials.has_activity_in_projects?/1","doc":"- `true` if there's at least one `Step` associated with the given `Credential`.\n - `false` otherwise.","ref":"Lightning.Credentials.html#has_activity_in_projects?/1-returns"},{"type":"function","title":"Examples - Lightning.Credentials.has_activity_in_projects?/1","doc":"iex> has_activity_in_projects?(%Credential{id: some_id})\n true\n\n iex> has_activity_in_projects?(%Credential{id: another_id})\n false","ref":"Lightning.Credentials.html#has_activity_in_projects?/1-examples"},{"type":"function","title":"Notes - Lightning.Credentials.has_activity_in_projects?/1","doc":"This function leverages the association between `Step` and `Credential` to\ndetermine if any steps exist for a given credential. It's a fast check that\ndoes not load any records into memory, but simply checks for their existence.","ref":"Lightning.Credentials.html#has_activity_in_projects?/1-notes"},{"type":"function","title":"Lightning.Credentials.invalid_projects_for_user/2","doc":"Given a credential and a user, returns a list of invalid projects—i.e., those\nthat the credential is shared with but that the user does not have access to.\n\nThis is used to generate a validation error when a credential cannot be\ntransferred.","ref":"Lightning.Credentials.html#invalid_projects_for_user/2"},{"type":"function","title":"Examples - Lightning.Credentials.invalid_projects_for_user/2","doc":"iex> can_credential_be_shared_to_user(credential_id, user_id)\n []\n\n iex> can_credential_be_shared_to_user(credential_id, user_id)\n [\"52ea8758-6ce5-43d7-912f-6a1e1f11dc55\"]","ref":"Lightning.Credentials.html#invalid_projects_for_user/2-examples"},{"type":"function","title":"Lightning.Credentials.list_credentials/1","doc":"Retrieves all credentials based on the given context, either a Project or a User.","ref":"Lightning.Credentials.html#list_credentials/1"},{"type":"function","title":"Parameters - Lightning.Credentials.list_credentials/1","doc":"- context: The Project or User struct to retrieve credentials for.","ref":"Lightning.Credentials.html#list_credentials/1-parameters"},{"type":"function","title":"Returns - Lightning.Credentials.list_credentials/1","doc":"- A list of credentials associated with the given Project or created by the given User.","ref":"Lightning.Credentials.html#list_credentials/1-returns"},{"type":"function","title":"Examples - Lightning.Credentials.list_credentials/1","doc":"When given a Project:\n iex> list_credentials(%Project{id: 1})\n [%Credential{project_id: 1}, %Credential{project_id: 1}]\n\n When given a User:\n iex> list_credentials(%User{id: 123})\n [%Credential{user_id: 123}, %Credential{user_id: 123}]","ref":"Lightning.Credentials.html#list_credentials/1-examples"},{"type":"function","title":"Lightning.Credentials.lookup_adapter/1","doc":"","ref":"Lightning.Credentials.html#lookup_adapter/1"},{"type":"function","title":"Lightning.Credentials.maybe_refresh_token/1","doc":"","ref":"Lightning.Credentials.html#maybe_refresh_token/1"},{"type":"function","title":"Lightning.Credentials.perform/1","doc":"Perform, when called with %{\"type\" => \"purge_deleted\"}\nwill find credentials that are ready for permanent deletion, set their bodies\nto null, and try to purge them.","ref":"Lightning.Credentials.html#perform/1"},{"type":"function","title":"Lightning.Credentials.schedule_credential_deletion/1","doc":"Schedules a given credential for deletion.\n\nThe deletion date is determined based on the `:purge_deleted_after_days` configuration\nin the application environment. If this configuration is absent, the credential is scheduled\nfor immediate deletion.\n\nThe function will also perform necessary side effects such as:\n - Removing associations of the credential.\n - Notifying the owner of the credential about the scheduled deletion.","ref":"Lightning.Credentials.html#schedule_credential_deletion/1"},{"type":"function","title":"Parameters - Lightning.Credentials.schedule_credential_deletion/1","doc":"- `credential`: A `Credential` struct that is to be scheduled for deletion.","ref":"Lightning.Credentials.html#schedule_credential_deletion/1-parameters"},{"type":"function","title":"Returns - Lightning.Credentials.schedule_credential_deletion/1","doc":"- `{:ok, credential}`: Returns an `:ok` tuple with the updated credential struct if the\n update was successful.\n - `{:error, changeset}`: Returns an `:error` tuple with the changeset if the update failed.","ref":"Lightning.Credentials.html#schedule_credential_deletion/1-returns"},{"type":"function","title":"Examples - Lightning.Credentials.schedule_credential_deletion/1","doc":"iex> schedule_credential_deletion(%Credential{id: some_id})\n {:ok, %Credential{}}\n\n iex> schedule_credential_deletion(%Credential{})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Credentials.html#schedule_credential_deletion/1-examples"},{"type":"function","title":"Lightning.Credentials.sensitive_values_for/1","doc":"","ref":"Lightning.Credentials.html#sensitive_values_for/1"},{"type":"function","title":"Lightning.Credentials.update_credential/2","doc":"Updates a credential.","ref":"Lightning.Credentials.html#update_credential/2"},{"type":"function","title":"Examples - Lightning.Credentials.update_credential/2","doc":"iex> update_credential(credential, %{field: new_value})\n {:ok, %Credential{}}\n\n iex> update_credential(credential, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Credentials.html#update_credential/2-examples"},{"type":"module","title":"Lightning.Credentials.Audit","doc":"Model for storing changes to Credentials","ref":"Lightning.Credentials.Audit.html"},{"type":"function","title":"Lightning.Credentials.Audit.base_query/0","doc":"","ref":"Lightning.Credentials.Audit.html#base_query/0"},{"type":"function","title":"Lightning.Credentials.Audit.event/5","doc":"","ref":"Lightning.Credentials.Audit.html#event/5"},{"type":"function","title":"Lightning.Credentials.Audit.save/1","doc":"","ref":"Lightning.Credentials.Audit.html#save/1"},{"type":"function","title":"Lightning.Credentials.Audit.update_changes/1","doc":"","ref":"Lightning.Credentials.Audit.html#update_changes/1"},{"type":"module","title":"Lightning.Credentials.Credential","doc":"The Credential model.","ref":"Lightning.Credentials.Credential.html"},{"type":"type","title":"Lightning.Credentials.Credential.t/0","doc":"","ref":"Lightning.Credentials.Credential.html#t:t/0"},{"type":"module","title":"Lightning.Credentials.OauthClient","doc":"Defines the Ecto schema for an OAuth client. This schema is responsible for representing\nOAuth client data in the database, including details such as client ID, client secret,\nand endpoints necessary for OAuth operations. It also links to associated users and\nprojects through relational fields.","ref":"Lightning.Credentials.OauthClient.html"},{"type":"function","title":"Lightning.Credentials.OauthClient.changeset/2","doc":"Builds a changeset for an OAuth client based on the provided attributes.","ref":"Lightning.Credentials.OauthClient.html#changeset/2"},{"type":"function","title":"Parameters - Lightning.Credentials.OauthClient.changeset/2","doc":"- oauth_client: The existing `%OauthClient{}` struct (or a new struct for creation).\n- attrs: A map of attributes to set on the OAuth client.","ref":"Lightning.Credentials.OauthClient.html#changeset/2-parameters"},{"type":"function","title":"Returns - Lightning.Credentials.OauthClient.changeset/2","doc":"- An `%Ecto.Changeset{}` that can be used to create or update an OAuth client.\n\nThis function validates the presence of essential fields, ensures that URLs are valid,\nand handles associations with projects through nested changesets.","ref":"Lightning.Credentials.OauthClient.html#changeset/2-returns"},{"type":"type","title":"Lightning.Credentials.OauthClient.t/0","doc":"","ref":"Lightning.Credentials.OauthClient.html#t:t/0"},{"type":"module","title":"Lightning.Credentials.OauthClientAudit","doc":"Model for storing changes to Oauth clients","ref":"Lightning.Credentials.OauthClientAudit.html"},{"type":"function","title":"Lightning.Credentials.OauthClientAudit.base_query/0","doc":"","ref":"Lightning.Credentials.OauthClientAudit.html#base_query/0"},{"type":"function","title":"Lightning.Credentials.OauthClientAudit.event/5","doc":"","ref":"Lightning.Credentials.OauthClientAudit.html#event/5"},{"type":"function","title":"Lightning.Credentials.OauthClientAudit.save/1","doc":"","ref":"Lightning.Credentials.OauthClientAudit.html#save/1"},{"type":"function","title":"Lightning.Credentials.OauthClientAudit.update_changes/1","doc":"","ref":"Lightning.Credentials.OauthClientAudit.html#update_changes/1"},{"type":"module","title":"Lightning.Credentials.Schema","doc":"Structure that can parse JsonSchemas (using `ExJsonSchema`) and validate\nchangesets for a given schema.","ref":"Lightning.Credentials.Schema.html"},{"type":"function","title":"Lightning.Credentials.Schema.new/2","doc":"","ref":"Lightning.Credentials.Schema.html#new/2"},{"type":"function","title":"Lightning.Credentials.Schema.properties/2","doc":"","ref":"Lightning.Credentials.Schema.html#properties/2"},{"type":"function","title":"Lightning.Credentials.Schema.required?/2","doc":"","ref":"Lightning.Credentials.Schema.html#required?/2"},{"type":"function","title":"Lightning.Credentials.Schema.validate/2","doc":"","ref":"Lightning.Credentials.Schema.html#validate/2"},{"type":"type","title":"Lightning.Credentials.Schema.t/0","doc":"","ref":"Lightning.Credentials.Schema.html#t:t/0"},{"type":"module","title":"Lightning.Credentials.SchemaDocument","doc":"Provides facilities to dynamically create and validate a changeset for a given\n[Schema](`Lightning.Credentials.Schema`)","ref":"Lightning.Credentials.SchemaDocument.html"},{"type":"function","title":"Lightning.Credentials.SchemaDocument.changeset/3","doc":"","ref":"Lightning.Credentials.SchemaDocument.html#changeset/3"},{"type":"module","title":"Lightning.Credentials.SensitiveValues","doc":"Functions to pull out sensitive values inside a credential.\n\nThese values are used to scrub logs for leaked secrets.","ref":"Lightning.Credentials.SensitiveValues.html"},{"type":"function","title":"Lightning.Credentials.SensitiveValues.flatten_map/1","doc":"Keys that are _not_ considered sensitive","ref":"Lightning.Credentials.SensitiveValues.html#flatten_map/1"},{"type":"function","title":"Lightning.Credentials.SensitiveValues.secret_values/1","doc":"Given a map, find all values allowed (via `@safe_keys`) and return them as\na list.","ref":"Lightning.Credentials.SensitiveValues.html#secret_values/1"},{"type":"type","title":"Lightning.Credentials.SensitiveValues.pairs/0","doc":"","ref":"Lightning.Credentials.SensitiveValues.html#t:pairs/0"},{"type":"type","title":"Lightning.Credentials.SensitiveValues.raw_pairs/0","doc":"","ref":"Lightning.Credentials.SensitiveValues.html#t:raw_pairs/0"},{"type":"module","title":"Lightning.Invocation","doc":"The Invocation context.","ref":"Lightning.Invocation.html"},{"type":"function","title":"Lightning.Invocation.assemble_logs_for_step/1","doc":"Return all logs for a step as a string of text, separated by new line \n breaks","ref":"Lightning.Invocation.html#assemble_logs_for_step/1"},{"type":"function","title":"Lightning.Invocation.change_dataclip/2","doc":"Returns an `%Ecto.Changeset{}` for tracking dataclip changes.","ref":"Lightning.Invocation.html#change_dataclip/2"},{"type":"function","title":"Examples - Lightning.Invocation.change_dataclip/2","doc":"iex> change_dataclip(dataclip)\n %Ecto.Changeset{data: %Dataclip{}}","ref":"Lightning.Invocation.html#change_dataclip/2-examples"},{"type":"function","title":"Lightning.Invocation.change_step/2","doc":"Returns an `%Ecto.Changeset{}` for tracking step changes.","ref":"Lightning.Invocation.html#change_step/2"},{"type":"function","title":"Examples - Lightning.Invocation.change_step/2","doc":"iex> change_step(step)\n %Ecto.Changeset{data: %Step{}}","ref":"Lightning.Invocation.html#change_step/2-examples"},{"type":"function","title":"Lightning.Invocation.count_workorders/2","doc":"","ref":"Lightning.Invocation.html#count_workorders/2"},{"type":"function","title":"Lightning.Invocation.create_dataclip/1","doc":"Creates a dataclip.","ref":"Lightning.Invocation.html#create_dataclip/1"},{"type":"function","title":"Examples - Lightning.Invocation.create_dataclip/1","doc":"iex> create_dataclip(%{field: value})\n {:ok, %Dataclip{}}\n\n iex> create_dataclip(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Invocation.html#create_dataclip/1-examples"},{"type":"function","title":"Lightning.Invocation.delete_dataclip/1","doc":"Deletes a dataclip.","ref":"Lightning.Invocation.html#delete_dataclip/1"},{"type":"function","title":"Examples - Lightning.Invocation.delete_dataclip/1","doc":"iex> delete_dataclip(dataclip)\n {:ok, %Dataclip{}}\n\n iex> delete_dataclip(dataclip)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Invocation.html#delete_dataclip/1-examples"},{"type":"function","title":"Lightning.Invocation.export_workorders/3","doc":"Exports work orders by performing a series of database operations wrapped in a transaction.\n\nThis function creates an audit log, a project file record, and enqueues an export job using a transaction.\nEach step is executed as part of an `Ecto.Multi` operation, ensuring atomicity.","ref":"Lightning.Invocation.html#export_workorders/3"},{"type":"function","title":"Parameters - Lightning.Invocation.export_workorders/3","doc":"- `project` - The project for which work orders are being exported. Expected to be a map or struct with an `id` field.\n - `user` - The user initiating the export operation. Expected to be a map or struct with an `id` field.\n - `search_params` - A map of search parameters used to filter work orders to export.","ref":"Lightning.Invocation.html#export_workorders/3-parameters"},{"type":"function","title":"Returns - Lightning.Invocation.export_workorders/3","doc":"- `{:ok, %{audit: audit, project_file: project_file, export_job: job}}` on success:\n - `audit`: The audit log entry created for the export operation.\n - `project_file`: The project file record created for the export operation.\n - `export_job`: The result of the export job enqueuing step.\n\n - `{:error, step, reason, changes}` if any step in the transaction fails:\n - `step`: The step where the error occurred, e.g., `:audit`, `:project_file`, or `:export_job`.\n - `reason`: The reason for the failure, typically an error atom.\n - `changes`: A map of changes up to the point of failure.","ref":"Lightning.Invocation.html#export_workorders/3-returns"},{"type":"function","title":"Lightning.Invocation.get_dataclip/1","doc":"Gets a single dataclip given one of:\n\n- a Dataclip uuid\n- a Step model\n\nReturns `nil` if the Dataclip does not exist.","ref":"Lightning.Invocation.html#get_dataclip/1"},{"type":"function","title":"Examples - Lightning.Invocation.get_dataclip/1","doc":"iex> get_dataclip(\"27b73932-16c7-4a72-86a3-85d805ccff98\")\n %Dataclip{}\n\n iex> get_dataclip(\"27b73932-16c7-4a72-86a3-85d805ccff98\")\n nil\n\n iex> get_dataclip(%Step{id: \"a uuid\"})\n %Dataclip{}","ref":"Lightning.Invocation.html#get_dataclip/1-examples"},{"type":"function","title":"Lightning.Invocation.get_dataclip!/1","doc":"Gets a single dataclip.\n\nRaises `Ecto.NoResultsError` if the Dataclip does not exist.","ref":"Lightning.Invocation.html#get_dataclip!/1"},{"type":"function","title":"Examples - Lightning.Invocation.get_dataclip!/1","doc":"iex> get_dataclip!(123)\n %Dataclip{}\n\n iex> get_dataclip!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Invocation.html#get_dataclip!/1-examples"},{"type":"function","title":"Lightning.Invocation.get_dataclip_details!/1","doc":"","ref":"Lightning.Invocation.html#get_dataclip_details!/1"},{"type":"function","title":"Lightning.Invocation.get_dataclip_for_run/1","doc":"","ref":"Lightning.Invocation.html#get_dataclip_for_run/1"},{"type":"function","title":"Lightning.Invocation.get_dataclip_query/1","doc":"Query for retrieving the dataclip that was step's starting dataclip.","ref":"Lightning.Invocation.html#get_dataclip_query/1"},{"type":"function","title":"Lightning.Invocation.get_first_dataclip_for_run_and_job/2","doc":"","ref":"Lightning.Invocation.html#get_first_dataclip_for_run_and_job/2"},{"type":"function","title":"Lightning.Invocation.get_first_step_for_run_and_job/2","doc":"","ref":"Lightning.Invocation.html#get_first_step_for_run_and_job/2"},{"type":"function","title":"Lightning.Invocation.get_output_dataclip_query/1","doc":"Query for retrieving the dataclip that was the result of a successful step.","ref":"Lightning.Invocation.html#get_output_dataclip_query/1"},{"type":"function","title":"Lightning.Invocation.get_step!/1","doc":"Gets a single step.\n\nRaises `Ecto.NoResultsError` if the Step does not exist.","ref":"Lightning.Invocation.html#get_step!/1"},{"type":"function","title":"Examples - Lightning.Invocation.get_step!/1","doc":"iex> get_step!(123)\n %Step{}\n\n iex> get_step!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Invocation.html#get_step!/1-examples"},{"type":"function","title":"Lightning.Invocation.get_step_count_for_run/1","doc":"","ref":"Lightning.Invocation.html#get_step_count_for_run/1"},{"type":"function","title":"Lightning.Invocation.get_step_with_job!/1","doc":"Fetches a step and preloads the job via the step's event.","ref":"Lightning.Invocation.html#get_step_with_job!/1"},{"type":"function","title":"Lightning.Invocation.get_workorders_by_ids/1","doc":"","ref":"Lightning.Invocation.html#get_workorders_by_ids/1"},{"type":"function","title":"Lightning.Invocation.get_workorders_count_limit/0","doc":"","ref":"Lightning.Invocation.html#get_workorders_count_limit/0"},{"type":"function","title":"Lightning.Invocation.list_dataclips/0","doc":"Returns the list of dataclips.","ref":"Lightning.Invocation.html#list_dataclips/0"},{"type":"function","title":"Examples - Lightning.Invocation.list_dataclips/0","doc":"iex> list_dataclips()\n [%Dataclip{}, ...]","ref":"Lightning.Invocation.html#list_dataclips/0-examples"},{"type":"function","title":"Lightning.Invocation.list_dataclips/1","doc":"","ref":"Lightning.Invocation.html#list_dataclips/1"},{"type":"function","title":"Lightning.Invocation.list_dataclips_for_job/1","doc":"","ref":"Lightning.Invocation.html#list_dataclips_for_job/1"},{"type":"function","title":"Lightning.Invocation.list_dataclips_query/1","doc":"","ref":"Lightning.Invocation.html#list_dataclips_query/1"},{"type":"function","title":"Lightning.Invocation.list_steps/0","doc":"Returns the list of steps.","ref":"Lightning.Invocation.html#list_steps/0"},{"type":"function","title":"Examples - Lightning.Invocation.list_steps/0","doc":"iex> list_steps()\n [%Step{}, ...]","ref":"Lightning.Invocation.html#list_steps/0-examples"},{"type":"function","title":"Lightning.Invocation.list_steps_for_project/2","doc":"","ref":"Lightning.Invocation.html#list_steps_for_project/2"},{"type":"function","title":"Lightning.Invocation.list_steps_for_project_query/1","doc":"","ref":"Lightning.Invocation.html#list_steps_for_project_query/1"},{"type":"function","title":"Lightning.Invocation.logs_for_step/1","doc":"Return all logs for a step as a list","ref":"Lightning.Invocation.html#logs_for_step/1"},{"type":"function","title":"Lightning.Invocation.search_workorders/1","doc":"Searches for work orders based on project and search parameters.","ref":"Lightning.Invocation.html#search_workorders/1"},{"type":"function","title":"Parameters: - Lightning.Invocation.search_workorders/1","doc":"- `project`: The project to filter the work orders by.\n- `search_params`: The parameters to guide the search.","ref":"Lightning.Invocation.html#search_workorders/1-parameters"},{"type":"function","title":"Returns: - Lightning.Invocation.search_workorders/1","doc":"A paginated list of work orders that match the criteria.","ref":"Lightning.Invocation.html#search_workorders/1-returns"},{"type":"function","title":"Example: - Lightning.Invocation.search_workorders/1","doc":"search_workorders(%Project{id: 1}, %SearchParams{status: [\"completed\"]})","ref":"Lightning.Invocation.html#search_workorders/1-example"},{"type":"function","title":"Lightning.Invocation.search_workorders/3","doc":"","ref":"Lightning.Invocation.html#search_workorders/3"},{"type":"function","title":"Lightning.Invocation.search_workorders_for_export_query/2","doc":"","ref":"Lightning.Invocation.html#search_workorders_for_export_query/2"},{"type":"function","title":"Lightning.Invocation.search_workorders_for_retry/2","doc":"","ref":"Lightning.Invocation.html#search_workorders_for_retry/2"},{"type":"function","title":"Lightning.Invocation.update_dataclip/2","doc":"Updates a dataclip.","ref":"Lightning.Invocation.html#update_dataclip/2"},{"type":"function","title":"Examples - Lightning.Invocation.update_dataclip/2","doc":"iex> update_dataclip(dataclip, %{field: new_value})\n {:ok, %Dataclip{}}\n\n iex> update_dataclip(dataclip, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Invocation.html#update_dataclip/2-examples"},{"type":"function","title":"Lightning.Invocation.with_runs/1","doc":"","ref":"Lightning.Invocation.html#with_runs/1"},{"type":"module","title":"Lightning.Invocation.Dataclip","doc":"Ecto model for Dataclips.\n\nDataclips represent some data that arrived in the system, and records both\nthe data and the source of the data.","ref":"Lightning.Invocation.Dataclip.html"},{"type":"module","title":"Types - Lightning.Invocation.Dataclip","doc":"* `:http_request`\n The data arrived via a webhook.\n* `:global`\n Was created manually, and is intended to be used multiple times.\n When repetitive static data is needed to be maintained, instead of hard-coding\n into a Job - a more convenient solution is to create a `:global` Dataclip\n and access it inside the Job.\n* `:step_result`\n The final state of a step.\n* `:saved_input`\n An arbitrary input, created by a user. (Only configuration will be overwritten.)","ref":"Lightning.Invocation.Dataclip.html#module-types"},{"type":"function","title":"Lightning.Invocation.Dataclip.new/1","doc":"","ref":"Lightning.Invocation.Dataclip.html#new/1"},{"type":"function","title":"Lightning.Invocation.Dataclip.source_types/0","doc":"","ref":"Lightning.Invocation.Dataclip.html#source_types/0"},{"type":"function","title":"Lightning.Invocation.Dataclip.validate_by_type/1","doc":"Append validations based on the type of the Dataclip.\n\n- `:step_result` must have an associated Step model.","ref":"Lightning.Invocation.Dataclip.html#validate_by_type/1"},{"type":"type","title":"Lightning.Invocation.Dataclip.source_type/0","doc":"","ref":"Lightning.Invocation.Dataclip.html#t:source_type/0"},{"type":"type","title":"Lightning.Invocation.Dataclip.t/0","doc":"","ref":"Lightning.Invocation.Dataclip.html#t:t/0"},{"type":"module","title":"Lightning.Invocation.LogLine","doc":"Ecto model for run logs.\n\nEvery log line from a worker is stored using this model.\n\nCurrently the `:message` field is a text field, however the worker sends\nmessages in a JSON format. We will at some point consider changing this to\na JSON field; but for now we coerce it into a string.\n\nSee [`LogMessage`](`Lightning.LogMessage`) for more information.","ref":"Lightning.Invocation.LogLine.html"},{"type":"function","title":"Lightning.Invocation.LogLine.new/3","doc":"","ref":"Lightning.Invocation.LogLine.html#new/3"},{"type":"function","title":"Lightning.Invocation.LogLine.validate/2","doc":"","ref":"Lightning.Invocation.LogLine.html#validate/2"},{"type":"type","title":"Lightning.Invocation.LogLine.t/0","doc":"","ref":"Lightning.Invocation.LogLine.html#t:t/0"},{"type":"module","title":"Lightning.Invocation.Query","doc":"Query functions for working with Steps and Dataclips","ref":"Lightning.Invocation.Query.html"},{"type":"function","title":"Lightning.Invocation.Query.any_step/0","doc":"To be used in preloads for `workflow > job > step` when the presence of any\nstep is all the information we need. As in, \"Does this job have any steps?\"","ref":"Lightning.Invocation.Query.html#any_step/0"},{"type":"function","title":"Lightning.Invocation.Query.dataclip_with_body/0","doc":"By default, the dataclip body is not returned via a query. This query selects\nthe body specifically.","ref":"Lightning.Invocation.Query.html#dataclip_with_body/0"},{"type":"function","title":"Lightning.Invocation.Query.last_n_for_job/2","doc":"","ref":"Lightning.Invocation.Query.html#last_n_for_job/2"},{"type":"function","title":"Lightning.Invocation.Query.last_step_for_job/1","doc":"The last step for a job","ref":"Lightning.Invocation.Query.html#last_step_for_job/1"},{"type":"function","title":"Lightning.Invocation.Query.last_successful_step_for_job/1","doc":"The last successful step for a job, used in scheduler to enable downstream runs\nto access a previous run's state","ref":"Lightning.Invocation.Query.html#last_successful_step_for_job/1"},{"type":"function","title":"Lightning.Invocation.Query.select_as_input/1","doc":"Returns a dataclip formatted for use as an input state.\n\nOnly `http_request` dataclips are changed, their `body` is nested inside a\n`\"data\"` key and `request` data is added as a `\"request\"` key.","ref":"Lightning.Invocation.Query.html#select_as_input/1"},{"type":"function","title":"Lightning.Invocation.Query.steps_for/1","doc":"Steps for a specific user","ref":"Lightning.Invocation.Query.html#steps_for/1"},{"type":"function","title":"Lightning.Invocation.Query.steps_with_reason/2","doc":"The last step for a job for a particular exit reason, used in scheduler","ref":"Lightning.Invocation.Query.html#steps_with_reason/2"},{"type":"function","title":"Lightning.Invocation.Query.wipe_dataclips/1","doc":"","ref":"Lightning.Invocation.Query.html#wipe_dataclips/1"},{"type":"module","title":"Lightning.Invocation.Step","doc":"Ecto model for Steps.\n\nA step is part of a run and represents the work initiated for a single\nJob with a single `input_dataclip`.\n\nOnce completed (successfully) it will have an `output_dataclip` associated\nwith it as well.\n\nWhen a step finishes, it's `:exit_reason` is set to one of following strings:\n\n- `\"success\"`\n- `\"fail\"`\n- `\"crash\"`\n- `\"cancel\"`\n- `\"kill\"`\n- `\"exception\"`\n- `\"lost\"`","ref":"Lightning.Invocation.Step.html"},{"type":"function","title":"Lightning.Invocation.Step.finished/2","doc":"","ref":"Lightning.Invocation.Step.html#finished/2"},{"type":"function","title":"Lightning.Invocation.Step.new/1","doc":"","ref":"Lightning.Invocation.Step.html#new/1"},{"type":"function","title":"Lightning.Invocation.Step.validate/1","doc":"","ref":"Lightning.Invocation.Step.html#validate/1"},{"type":"type","title":"Lightning.Invocation.Step.t/0","doc":"","ref":"Lightning.Invocation.Step.html#t:t/0"},{"type":"module","title":"Lightning.Jobs","doc":"The Jobs context.","ref":"Lightning.Jobs.html"},{"type":"function","title":"Lightning.Jobs.change_job/2","doc":"Returns an `%Ecto.Changeset{}` for tracking job changes.","ref":"Lightning.Jobs.html#change_job/2"},{"type":"function","title":"Examples - Lightning.Jobs.change_job/2","doc":"iex> change_job(job)\n %Ecto.Changeset{data: %Job{}}","ref":"Lightning.Jobs.html#change_job/2-examples"},{"type":"function","title":"Lightning.Jobs.create_job/1","doc":"Creates a job.","ref":"Lightning.Jobs.html#create_job/1"},{"type":"function","title":"Examples - Lightning.Jobs.create_job/1","doc":"iex> create_job(%{field: value})\n {:ok, %Job{}}\n\n iex> create_job(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Jobs.html#create_job/1-examples"},{"type":"function","title":"Lightning.Jobs.get_downstream_jobs_for/2","doc":"Returns the list of downstream jobs for a given job, optionally matching a\nspecific trigger type.\nWhen downstream_jobs_for is called without a trigger that means its between jobs\nwhen it called with a trigger that means we are starting from outside the pipeline","ref":"Lightning.Jobs.html#get_downstream_jobs_for/2"},{"type":"function","title":"Lightning.Jobs.get_job!/1","doc":"Gets a single job.\n\nRaises `Ecto.NoResultsError` if the Job does not exist.","ref":"Lightning.Jobs.html#get_job!/1"},{"type":"function","title":"Examples - Lightning.Jobs.get_job!/1","doc":"iex> get_job!(123)\n %Job{}\n\n iex> get_job!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Jobs.html#get_job!/1-examples"},{"type":"function","title":"Lightning.Jobs.get_job_with_credential/1","doc":"","ref":"Lightning.Jobs.html#get_job_with_credential/1"},{"type":"function","title":"Lightning.Jobs.get_upstream_jobs_for/1","doc":"Returns the list of jobs excluding the one given.","ref":"Lightning.Jobs.html#get_upstream_jobs_for/1"},{"type":"function","title":"Lightning.Jobs.jobs_for_project/1","doc":"","ref":"Lightning.Jobs.html#jobs_for_project/1"},{"type":"function","title":"Lightning.Jobs.jobs_for_project_query/1","doc":"","ref":"Lightning.Jobs.html#jobs_for_project_query/1"},{"type":"function","title":"Lightning.Jobs.list_active_cron_jobs/0","doc":"","ref":"Lightning.Jobs.html#list_active_cron_jobs/0"},{"type":"function","title":"Lightning.Jobs.list_jobs/0","doc":"Returns the list of jobs.","ref":"Lightning.Jobs.html#list_jobs/0"},{"type":"function","title":"Lightning.Jobs.list_jobs_for_workflow/1","doc":"","ref":"Lightning.Jobs.html#list_jobs_for_workflow/1"},{"type":"function","title":"Lightning.Jobs.update_job/2","doc":"Updates a job.","ref":"Lightning.Jobs.html#update_job/2"},{"type":"function","title":"Examples - Lightning.Jobs.update_job/2","doc":"iex> update_job(job, %{field: new_value})\n {:ok, %Job{}}\n\n iex> update_job(job, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Jobs.html#update_job/2-examples"},{"type":"module","title":"Lightning.Projects","doc":"The Projects context.","ref":"Lightning.Projects.html"},{"type":"function","title":"Lightning.Projects.add_project_users/3","doc":"","ref":"Lightning.Projects.html#add_project_users/3"},{"type":"function","title":"Lightning.Projects.cancel_scheduled_deletion/1","doc":"","ref":"Lightning.Projects.html#cancel_scheduled_deletion/1"},{"type":"function","title":"Lightning.Projects.change_project/2","doc":"Returns an `%Ecto.Changeset{}` for tracking project changes.","ref":"Lightning.Projects.html#change_project/2"},{"type":"function","title":"Examples - Lightning.Projects.change_project/2","doc":"iex> change_project(project)\n %Ecto.Changeset{data: %Project{}}","ref":"Lightning.Projects.html#change_project/2-examples"},{"type":"function","title":"Lightning.Projects.create_project/2","doc":"Creates a project.","ref":"Lightning.Projects.html#create_project/2"},{"type":"function","title":"Examples - Lightning.Projects.create_project/2","doc":"iex> create_project(%{field: value})\n {:ok, %Project{}}\n\n iex> create_project(%{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Projects.html#create_project/2-examples"},{"type":"function","title":"Lightning.Projects.delete_project/1","doc":"Deletes a project and its related data, including workflows, work orders,\nsteps, jobs, runs, triggers, project users, project credentials, and dataclips","ref":"Lightning.Projects.html#delete_project/1"},{"type":"function","title":"Examples - Lightning.Projects.delete_project/1","doc":"iex> delete_project(project)\n {:ok, %Project{}}\n\n iex> delete_project(project)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Projects.html#delete_project/1-examples"},{"type":"function","title":"Lightning.Projects.delete_project_async/1","doc":"","ref":"Lightning.Projects.html#delete_project_async/1"},{"type":"function","title":"Lightning.Projects.delete_project_dataclips/2","doc":"Deletes project dataclips in batches","ref":"Lightning.Projects.html#delete_project_dataclips/2"},{"type":"function","title":"Lightning.Projects.delete_project_user!/1","doc":"","ref":"Lightning.Projects.html#delete_project_user!/1"},{"type":"function","title":"Lightning.Projects.delete_project_workorders/2","doc":"Deletes project work orders in batches","ref":"Lightning.Projects.html#delete_project_workorders/2"},{"type":"function","title":"Lightning.Projects.export_project/3","doc":"Exports a project as yaml.","ref":"Lightning.Projects.html#export_project/3"},{"type":"function","title":"Examples - Lightning.Projects.export_project/3","doc":"iex> export_project(:yaml, project_id)\n {:ok, string}","ref":"Lightning.Projects.html#export_project/3-examples"},{"type":"function","title":"Lightning.Projects.find_users_to_notify_of_trigger_failure/1","doc":"","ref":"Lightning.Projects.html#find_users_to_notify_of_trigger_failure/1"},{"type":"function","title":"Lightning.Projects.get_project/1","doc":"","ref":"Lightning.Projects.html#get_project/1"},{"type":"function","title":"Lightning.Projects.get_project!/1","doc":"Gets a single project.\n\nRaises `Ecto.NoResultsError` if the Project does not exist.","ref":"Lightning.Projects.html#get_project!/1"},{"type":"function","title":"Examples - Lightning.Projects.get_project!/1","doc":"iex> get_project!(123)\n %Project{}\n\n iex> get_project!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Projects.html#get_project!/1-examples"},{"type":"function","title":"Lightning.Projects.get_project_credential/2","doc":"","ref":"Lightning.Projects.html#get_project_credential/2"},{"type":"function","title":"Lightning.Projects.get_project_user/1","doc":"","ref":"Lightning.Projects.html#get_project_user/1"},{"type":"function","title":"Lightning.Projects.get_project_user/2","doc":"","ref":"Lightning.Projects.html#get_project_user/2"},{"type":"function","title":"Lightning.Projects.get_project_user!/1","doc":"Gets a single project_user.\n\nRaises `Ecto.NoResultsError` if the ProjectUser does not exist.","ref":"Lightning.Projects.html#get_project_user!/1"},{"type":"function","title":"Examples - Lightning.Projects.get_project_user!/1","doc":"iex> get_project_user!(123)\n %ProjectUser{}\n\n iex> get_project_user!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Projects.html#get_project_user!/1-examples"},{"type":"function","title":"Lightning.Projects.get_project_user_role/2","doc":"Returns the role of a user in a project.\nPossible roles are :admin, :viewer, :editor, and :owner","ref":"Lightning.Projects.html#get_project_user_role/2"},{"type":"function","title":"Examples - Lightning.Projects.get_project_user_role/2","doc":"iex> get_project_user_role(user, project)\n :admin\n\n iex> get_project_user_role(user, project)\n :viewer\n\n iex> get_project_user_role(user, project)\n :editor\n\n iex> get_project_user_role(user, project)\n :owner","ref":"Lightning.Projects.html#get_project_user_role/2-examples"},{"type":"function","title":"Lightning.Projects.get_project_users!/1","doc":"Get all project users for a given project","ref":"Lightning.Projects.html#get_project_users!/1"},{"type":"function","title":"Lightning.Projects.get_project_with_users!/1","doc":"Gets a single project with it's members via `project_users`.\n\nRaises `Ecto.NoResultsError` if the Project does not exist.","ref":"Lightning.Projects.html#get_project_with_users!/1"},{"type":"function","title":"Examples - Lightning.Projects.get_project_with_users!/1","doc":"iex> get_project!(123)\n %Project{}\n\n iex> get_project!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Projects.html#get_project_with_users!/1-examples"},{"type":"function","title":"Lightning.Projects.get_projects_for_user/2","doc":"Fetches projects for a given user from the database.","ref":"Lightning.Projects.html#get_projects_for_user/2"},{"type":"function","title":"Parameters - Lightning.Projects.get_projects_for_user/2","doc":"- user: The user struct for which projects are being queried.\n- opts: Keyword list of options including :include for associations to preload and :order_by for sorting.","ref":"Lightning.Projects.html#get_projects_for_user/2-parameters"},{"type":"function","title":"Returns - Lightning.Projects.get_projects_for_user/2","doc":"- A list of projects associated with the user.","ref":"Lightning.Projects.html#get_projects_for_user/2-returns"},{"type":"function","title":"Lightning.Projects.get_projects_overview/2","doc":"","ref":"Lightning.Projects.html#get_projects_overview/2"},{"type":"function","title":"Lightning.Projects.invite_collaborators/3","doc":"","ref":"Lightning.Projects.html#invite_collaborators/3"},{"type":"function","title":"Lightning.Projects.list_project_admin_emails/1","doc":"Lists emails of users with `:owner` or `:admin` roles in the project","ref":"Lightning.Projects.html#list_project_admin_emails/1"},{"type":"function","title":"Lightning.Projects.list_project_credentials/1","doc":"","ref":"Lightning.Projects.html#list_project_credentials/1"},{"type":"function","title":"Lightning.Projects.list_project_files/2","doc":"","ref":"Lightning.Projects.html#list_project_files/2"},{"type":"function","title":"Lightning.Projects.list_projects/0","doc":"Returns the list of projects.","ref":"Lightning.Projects.html#list_projects/0"},{"type":"function","title":"Examples - Lightning.Projects.list_projects/0","doc":"iex> list_projects()\n [%Project{}, ...]","ref":"Lightning.Projects.html#list_projects/0-examples"},{"type":"function","title":"Lightning.Projects.list_projects_having_history_retention/0","doc":"Lists all projects that have history retention","ref":"Lightning.Projects.html#list_projects_having_history_retention/0"},{"type":"function","title":"Lightning.Projects.member_of?/2","doc":"","ref":"Lightning.Projects.html#member_of?/2"},{"type":"function","title":"Lightning.Projects.perform/1","doc":"Perform, when called with %{\"type\" => \"purge_deleted\"}\nwill find projects that are ready for permanent deletion and purge them.","ref":"Lightning.Projects.html#perform/1"},{"type":"function","title":"Lightning.Projects.project_credentials_query/1","doc":"","ref":"Lightning.Projects.html#project_credentials_query/1"},{"type":"function","title":"Lightning.Projects.project_dataclips_query/1","doc":"","ref":"Lightning.Projects.html#project_dataclips_query/1"},{"type":"function","title":"Lightning.Projects.project_jobs_query/1","doc":"","ref":"Lightning.Projects.html#project_jobs_query/1"},{"type":"function","title":"Lightning.Projects.project_run_step_query/1","doc":"","ref":"Lightning.Projects.html#project_run_step_query/1"},{"type":"function","title":"Lightning.Projects.project_runs_query/1","doc":"","ref":"Lightning.Projects.html#project_runs_query/1"},{"type":"function","title":"Lightning.Projects.project_steps_query/1","doc":"","ref":"Lightning.Projects.html#project_steps_query/1"},{"type":"function","title":"Lightning.Projects.project_triggers_query/1","doc":"","ref":"Lightning.Projects.html#project_triggers_query/1"},{"type":"function","title":"Lightning.Projects.project_user_role_query/2","doc":"","ref":"Lightning.Projects.html#project_user_role_query/2"},{"type":"function","title":"Lightning.Projects.project_users_query/1","doc":"","ref":"Lightning.Projects.html#project_users_query/1"},{"type":"function","title":"Lightning.Projects.project_workflows_query/1","doc":"","ref":"Lightning.Projects.html#project_workflows_query/1"},{"type":"function","title":"Lightning.Projects.project_workorders_query/1","doc":"","ref":"Lightning.Projects.html#project_workorders_query/1"},{"type":"function","title":"Lightning.Projects.projects_for_user_query/2","doc":"Builds a query to retrieve projects associated with a user.","ref":"Lightning.Projects.html#projects_for_user_query/2"},{"type":"function","title":"Parameters - Lightning.Projects.projects_for_user_query/2","doc":"- user: The user struct for which projects are being queried.\n - opts: Keyword list of options including :include for associations to preload and :order_by for sorting.","ref":"Lightning.Projects.html#projects_for_user_query/2-parameters"},{"type":"function","title":"Returns - Lightning.Projects.projects_for_user_query/2","doc":"- An Ecto queryable struct to fetch projects.","ref":"Lightning.Projects.html#projects_for_user_query/2-returns"},{"type":"function","title":"Lightning.Projects.save_dataclips?/1","doc":"Should input or output dataclips be saved for runs in this project?","ref":"Lightning.Projects.html#save_dataclips?/1"},{"type":"function","title":"Lightning.Projects.schedule_project_deletion/1","doc":"Given a project, this function sets a scheduled deletion\ndate based on the PURGE_DELETED_AFTER_DAYS environment variable. If no ENV is\nset, this date defaults to NOW but the automatic project purge cronjob will\nnever run. (Note that subsequent logins will be blocked for projects pending\ndeletion.)","ref":"Lightning.Projects.html#schedule_project_deletion/1"},{"type":"function","title":"Lightning.Projects.select_first_project_for_user/1","doc":"","ref":"Lightning.Projects.html#select_first_project_for_user/1"},{"type":"function","title":"Lightning.Projects.update_project/3","doc":"Updates a project.","ref":"Lightning.Projects.html#update_project/3"},{"type":"function","title":"Examples - Lightning.Projects.update_project/3","doc":"iex> update_project(project, %{field: new_value})\n {:ok, %Project{}}\n\n iex> update_project(project, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Projects.html#update_project/3-examples"},{"type":"function","title":"Lightning.Projects.update_project_user/2","doc":"Updates a project user.","ref":"Lightning.Projects.html#update_project_user/2"},{"type":"function","title":"Examples - Lightning.Projects.update_project_user/2","doc":"iex> update_project_user(project_user, %{field: new_value})\n {:ok, %ProjectUser{}}\n\n iex> update_project_user(projectUser, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Projects.html#update_project_user/2-examples"},{"type":"function","title":"Lightning.Projects.update_project_with_users/3","doc":"","ref":"Lightning.Projects.html#update_project_with_users/3"},{"type":"function","title":"Lightning.Projects.validate_for_deletion/2","doc":"Returns an `%Ecto.Changeset{}` for changing the project scheduled_deletion.","ref":"Lightning.Projects.html#validate_for_deletion/2"},{"type":"function","title":"Examples - Lightning.Projects.validate_for_deletion/2","doc":"iex> validate_for_deletion(project)\n %Ecto.Changeset{data: %Project{}}","ref":"Lightning.Projects.html#validate_for_deletion/2-examples"},{"type":"module","title":"Lightning.Projects.Audit","doc":"Generate Audit changesets for selected changes to project settings.","ref":"Lightning.Projects.Audit.html"},{"type":"function","title":"Lightning.Projects.Audit.base_query/0","doc":"","ref":"Lightning.Projects.Audit.html#base_query/0"},{"type":"function","title":"Lightning.Projects.Audit.derive_events/3","doc":"","ref":"Lightning.Projects.Audit.html#derive_events/3"},{"type":"function","title":"Lightning.Projects.Audit.event/5","doc":"","ref":"Lightning.Projects.Audit.html#event/5"},{"type":"function","title":"Lightning.Projects.Audit.save/1","doc":"","ref":"Lightning.Projects.Audit.html#save/1"},{"type":"function","title":"Lightning.Projects.Audit.update_changes/1","doc":"","ref":"Lightning.Projects.Audit.html#update_changes/1"},{"type":"module","title":"Lightning.Projects.Events","doc":"Events for Projects changes.","ref":"Lightning.Projects.Events.html"},{"type":"function","title":"Lightning.Projects.Events.project_created/1","doc":"","ref":"Lightning.Projects.Events.html#project_created/1"},{"type":"function","title":"Lightning.Projects.Events.project_deleted/1","doc":"","ref":"Lightning.Projects.Events.html#project_deleted/1"},{"type":"function","title":"Lightning.Projects.Events.subscribe/0","doc":"","ref":"Lightning.Projects.Events.html#subscribe/0"},{"type":"module","title":"Lightning.Projects.File","doc":"The project files module","ref":"Lightning.Projects.File.html"},{"type":"function","title":"Lightning.Projects.File.mark_failed/1","doc":"","ref":"Lightning.Projects.File.html#mark_failed/1"},{"type":"function","title":"Lightning.Projects.File.new/1","doc":"Creates a new file changeset.\n\nUnlike regular changeset functions, this expects atom keys and the project\nand user to be passed in as models.","ref":"Lightning.Projects.File.html#new/1"},{"type":"type","title":"Lightning.Projects.File.t/0","doc":"","ref":"Lightning.Projects.File.html#t:t/0"},{"type":"module","title":"Lightning.Projects.Project","doc":"Project model","ref":"Lightning.Projects.Project.html"},{"type":"function","title":"Lightning.Projects.Project.data_retention_options/0","doc":"","ref":"Lightning.Projects.Project.html#data_retention_options/0"},{"type":"function","title":"Lightning.Projects.Project.deletion_changeset/2","doc":"Changeset to validate a project deletion request, the user must enter the\nprojects name to confirm.","ref":"Lightning.Projects.Project.html#deletion_changeset/2"},{"type":"function","title":"Lightning.Projects.Project.project_with_users_changeset/2","doc":"","ref":"Lightning.Projects.Project.html#project_with_users_changeset/2"},{"type":"function","title":"Lightning.Projects.Project.validate/1","doc":"","ref":"Lightning.Projects.Project.html#validate/1"},{"type":"type","title":"Lightning.Projects.Project.retention_policy_type/0","doc":"","ref":"Lightning.Projects.Project.html#t:retention_policy_type/0"},{"type":"type","title":"Lightning.Projects.Project.t/0","doc":"","ref":"Lightning.Projects.Project.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectCredential","doc":"Join table to assign credentials to a project","ref":"Lightning.Projects.ProjectCredential.html"},{"type":"type","title":"Lightning.Projects.ProjectCredential.t/0","doc":"","ref":"Lightning.Projects.ProjectCredential.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectOauthClient","doc":"Manages the relationship between OAuth clients and projects, acting as a join table.\nThis module defines the schema and validations needed for creating and managing\nassociations between `OauthClient` and `Project`. It ensures that an OAuth client\ncan be associated with a project, facilitating the management of access permissions\nand settings specific to a project.","ref":"Lightning.Projects.ProjectOauthClient.html"},{"type":"module","title":"Schema Information - Lightning.Projects.ProjectOauthClient","doc":"The schema represents the bridge between projects and OAuth clients with the following fields:\n\n- `:id`: The unique identifier for the association, automatically generated.\n- `:oauth_client_id`: Foreign key to link with the OAuth client.\n- `:project_id`: Foreign key to link with the project.\n\nThis module also includes a virtual field `:delete` to mark an association for deletion,\naiding in operations that require soft deletion patterns or special handling before\nactually removing an association.","ref":"Lightning.Projects.ProjectOauthClient.html#module-schema-information"},{"type":"module","title":"Usage - Lightning.Projects.ProjectOauthClient","doc":"The primary function of this module is to create and manage changesets for adding or\nremoving OAuth clients from projects, ensuring data integrity and enforcing business\nrules such as uniqueness of the association.","ref":"Lightning.Projects.ProjectOauthClient.html#module-usage"},{"type":"function","title":"Lightning.Projects.ProjectOauthClient.changeset/2","doc":"Creates or updates changesets for a `ProjectOauthClient` entity based on the given attributes.\nValidates required fields and applies a unique constraint to ensure an OAuth client\ncan be associated with a project only once.\n\nThis changeset is used for adding new or updating existing associations between an OAuth client and a project.","ref":"Lightning.Projects.ProjectOauthClient.html#changeset/2"},{"type":"type","title":"Lightning.Projects.ProjectOauthClient.t/0","doc":"","ref":"Lightning.Projects.ProjectOauthClient.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectOverviewRow","doc":"Represents a summarized view of a project for a user, used in the project overview table.","ref":"Lightning.Projects.ProjectOverviewRow.html"},{"type":"module","title":"Lightning.Projects.ProjectUser","doc":"Join table to assign users to a project","ref":"Lightning.Projects.ProjectUser.html"},{"type":"type","title":"Lightning.Projects.ProjectUser.t/0","doc":"","ref":"Lightning.Projects.ProjectUser.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectUser.DigestEnum","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.cast/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#cast/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.create_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#create_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.drop_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#drop_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.dump/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#dump/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.embed_as/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#embed_as/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.equal?/2","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#equal?/2"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.load/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#load/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.schema/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#schema/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.schemaless_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#schemaless_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.type/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.DigestEnum.valid_value?/1","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#valid_value?/1"},{"type":"type","title":"Lightning.Projects.ProjectUser.DigestEnum.t/0","doc":"","ref":"Lightning.Projects.ProjectUser.DigestEnum.html#t:t/0"},{"type":"module","title":"Lightning.Projects.ProjectUser.RolesEnum","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.cast/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#cast/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.create_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#create_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.drop_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#drop_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.dump/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#dump/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.embed_as/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#embed_as/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.equal?/2","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#equal?/2"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.load/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#load/1"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.schema/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#schema/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.schemaless_type/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#schemaless_type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.type/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#type/0"},{"type":"function","title":"Lightning.Projects.ProjectUser.RolesEnum.valid_value?/1","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#valid_value?/1"},{"type":"type","title":"Lightning.Projects.ProjectUser.RolesEnum.t/0","doc":"","ref":"Lightning.Projects.ProjectUser.RolesEnum.html#t:t/0"},{"type":"module","title":"Lightning.Projects.Provisioner","doc":"Provides functions for importing projects. This module is used by the\nprovisioning HTTP API.\n\nWhen providing a project to import, all records must have an `id` field.\nIt's up to the caller to ensure that the `id` is unique and generated\nahead of time in the case of new records.","ref":"Lightning.Projects.Provisioner.html"},{"type":"function","title":"Lightning.Projects.Provisioner.import_document/3","doc":"Import a project.","ref":"Lightning.Projects.Provisioner.html#import_document/3"},{"type":"function","title":"Lightning.Projects.Provisioner.parse_document/2","doc":"","ref":"Lightning.Projects.Provisioner.html#parse_document/2"},{"type":"function","title":"Lightning.Projects.Provisioner.preload_dependencies/2","doc":"Preload all dependencies for a project.\n\nExclude deleted workflows.","ref":"Lightning.Projects.Provisioner.html#preload_dependencies/2"},{"type":"function","title":"Lightning.Projects.Provisioner.validate_extraneous_params/1","doc":"Validate that there are no extraneous parameters in the changeset.\n\nFor all params in the changeset, ensure that the param is in the list of\nknown fields in the schema.","ref":"Lightning.Projects.Provisioner.html#validate_extraneous_params/1"},{"type":"module","title":"Lightning.Runtime.LogAgent","doc":"Agent facility to consume STDOUT/STDERR byte by byte.\n\nSince it works on a byte by byte basis, you will need to perform line-splitting\nyourself.\n\nUsage:\n\n```\n{:ok, log} = LogAgent.start_link()\n\"foo\" = LogAgent.process_chunk(log, {:stdout, \"foo\"})\n\"foobar\" = LogAgent.process_chunk(log, {:stdout, \"bar\"})\n```","ref":"Lightning.Runtime.LogAgent.html"},{"type":"function","title":"Lightning.Runtime.LogAgent.buffer/1","doc":"","ref":"Lightning.Runtime.LogAgent.html#buffer/1"},{"type":"function","title":"Lightning.Runtime.LogAgent.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.Runtime.LogAgent.html#child_spec/1"},{"type":"function","title":"Lightning.Runtime.LogAgent.process_chunk/2","doc":"","ref":"Lightning.Runtime.LogAgent.html#process_chunk/2"},{"type":"function","title":"Lightning.Runtime.LogAgent.start_link/1","doc":"","ref":"Lightning.Runtime.LogAgent.html#start_link/1"},{"type":"type","title":"Lightning.Runtime.LogAgent.logline/0","doc":"","ref":"Lightning.Runtime.LogAgent.html#t:logline/0"},{"type":"module","title":"Lightning.Runtime.LogAgent.StringBuffer","doc":"Internal datastructure to hold and process new bytes for a list of\ncharacters.\n\nBy checking the if the buffer is a complete grapheme, emitting the buffer\nonce valid and returning `nil` otherwise.\n\nIn the case of emojis and other language character sets, a character\n(in UTF-8) can be between 1-4 bytes - when streaming logs for example\nit's quite easy to receive less than the whole character which can\nresult in crashes or corrupt text.","ref":"Lightning.Runtime.LogAgent.StringBuffer.html"},{"type":"function","title":"Lightning.Runtime.LogAgent.StringBuffer.buffer/1","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#buffer/1"},{"type":"function","title":"Lightning.Runtime.LogAgent.StringBuffer.new/0","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#new/0"},{"type":"function","title":"Lightning.Runtime.LogAgent.StringBuffer.process_chunk/2","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#process_chunk/2"},{"type":"function","title":"Lightning.Runtime.LogAgent.StringBuffer.reduce_chunk/2","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#reduce_chunk/2"},{"type":"type","title":"Lightning.Runtime.LogAgent.StringBuffer.t/0","doc":"","ref":"Lightning.Runtime.LogAgent.StringBuffer.html#t:t/0"},{"type":"module","title":"Lightning.Runtime.RuntimeManager","doc":"Locates and runs the Runtime server. Added in order to ease development and default installations of Lightning\n\n# https://registry.npmjs.org/lightning-runtime/latest","ref":"Lightning.Runtime.RuntimeManager.html"},{"type":"module","title":"Runtime configuration - Lightning.Runtime.RuntimeManager","doc":"Sample:\n\n config :lightining, Elixir.Lightning.Runtime.RuntimeManager,\n version: \"0.1.0\",\n start: true,\n args: ~w(js/app.js --bundle --target=es2016 --outdir=../priv/static/assets),\n cd: Path.expand(\"../assets\", __DIR__),\n env: %{}\n\nOptions:\n\n * `:version` - the expected runtime version\n\n * `:start` - flag to start the runtime manager. If `false` the GenServer\n won't be started\n\n * `:path` - the path to find the runtime executable at. By\n default, it is automatically downloaded and placed inside\n the `_build` directory of your current app\n\nOverriding the `:path` is not recommended, as we will automatically\ndownload and manage the `runtime` for you.","ref":"Lightning.Runtime.RuntimeManager.html#module-runtime-configuration"},{"type":"function","title":"Lightning.Runtime.RuntimeManager.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.Runtime.RuntimeManager.html#child_spec/1"},{"type":"function","title":"Lightning.Runtime.RuntimeManager.start_link/1","doc":"","ref":"Lightning.Runtime.RuntimeManager.html#start_link/1"},{"type":"behaviour","title":"Lightning.Runtime.RuntimeManager.RuntimeClient","doc":"Behaviour for runtime clients to improve testability.","ref":"Lightning.Runtime.RuntimeManager.RuntimeClient.html"},{"type":"callback","title":"Lightning.Runtime.RuntimeManager.RuntimeClient.start_runtime/1","doc":"","ref":"Lightning.Runtime.RuntimeManager.RuntimeClient.html#c:start_runtime/1"},{"type":"callback","title":"Lightning.Runtime.RuntimeManager.RuntimeClient.stop_runtime/1","doc":"","ref":"Lightning.Runtime.RuntimeManager.RuntimeClient.html#c:stop_runtime/1"},{"type":"module","title":"Lightning.Workflows","doc":"The Workflows context.","ref":"Lightning.Workflows.html"},{"type":"function","title":"Lightning.Workflows.build_trigger/1","doc":"Builds a Trigger","ref":"Lightning.Workflows.html#build_trigger/1"},{"type":"function","title":"Lightning.Workflows.capture_snapshot/1","doc":"Creates a snapshot from a multi.\n\nWhen the multi already has a `:workflow` change, it is assumed to be changed\nor inserted and will attempt to build and insert a new snapshot.\n\nWhen there isn't a `:workflow` change, it tries to find a dependant model\nlike a Job, Trigger or Edge and uses the workflow associated with that\nmodel.\n\nIn this case we assume that the workflow wasn't actually updated,\n`Workflow.touch()` is called to bump the `updated_at` and the `lock_version`\nof the workflow before a snapshot is captured.","ref":"Lightning.Workflows.html#capture_snapshot/1"},{"type":"function","title":"Lightning.Workflows.change_workflow/2","doc":"Returns an `%Ecto.Changeset{}` for tracking workflow changes.","ref":"Lightning.Workflows.html#change_workflow/2"},{"type":"function","title":"Examples - Lightning.Workflows.change_workflow/2","doc":"iex> change_workflow(workflow)\n %Ecto.Changeset{data: %Workflow{}}","ref":"Lightning.Workflows.html#change_workflow/2-examples"},{"type":"function","title":"Lightning.Workflows.create_edge/1","doc":"Creates an edge","ref":"Lightning.Workflows.html#create_edge/1"},{"type":"function","title":"Lightning.Workflows.get_edge_by_trigger/1","doc":"Gets an `Edge` by its associated `Trigger`.","ref":"Lightning.Workflows.html#get_edge_by_trigger/1"},{"type":"function","title":"Parameters - Lightning.Workflows.get_edge_by_trigger/1","doc":"- `%Trigger{id: trigger_id}`: A `Trigger` struct from which the associated `Edge` is to be found.","ref":"Lightning.Workflows.html#get_edge_by_trigger/1-parameters"},{"type":"function","title":"Returns - Lightning.Workflows.get_edge_by_trigger/1","doc":"- Returns an `Edge` struct preloaded with its `source_trigger` and `target_job` if found.\n- Returns `nil` if no `Edge` is associated with the given `Trigger`.","ref":"Lightning.Workflows.html#get_edge_by_trigger/1-returns"},{"type":"function","title":"Examples - Lightning.Workflows.get_edge_by_trigger/1","doc":"```\ntrigger = %Trigger{id: 1, ...}\nLightning.Workflows.get_edge_by_trigger(trigger)\n# => %Edge{source_trigger: %Trigger{}, target_job: %Job{}, ...}\n\nnon_existent_trigger = %Trigger{id: 999, ...}\nLightning.Workflows.get_edge_by_trigger(non_existent_trigger)\n# => nil\n```","ref":"Lightning.Workflows.html#get_edge_by_trigger/1-examples"},{"type":"function","title":"Lightning.Workflows.get_edges_for_cron_execution/1","doc":"Returns a list of edges with jobs to execute, given a current timestamp in Unix. This is\nused by the scheduler, which calls this function once every minute.","ref":"Lightning.Workflows.html#get_edges_for_cron_execution/1"},{"type":"function","title":"Lightning.Workflows.get_trigger_by_webhook/1","doc":"Gets a single `Trigger` by its `custom_path` or `id`.","ref":"Lightning.Workflows.html#get_trigger_by_webhook/1"},{"type":"function","title":"Parameters - Lightning.Workflows.get_trigger_by_webhook/1","doc":"- `path`: A binary string representing the `custom_path` or `id` of the trigger.","ref":"Lightning.Workflows.html#get_trigger_by_webhook/1-parameters"},{"type":"function","title":"Returns - Lightning.Workflows.get_trigger_by_webhook/1","doc":"- Returns a `Trigger` struct if a trigger is found.\n- Returns `nil` if no trigger is found for the given `path`.","ref":"Lightning.Workflows.html#get_trigger_by_webhook/1-returns"},{"type":"function","title":"Examples - Lightning.Workflows.get_trigger_by_webhook/1","doc":"```\nLightning.Workflows.get_trigger_by_webhook(\"some_path_or_id\")\n# => %Trigger{id: 1, custom_path: \"some_path_or_id\", ...}\n\nLightning.Workflows.get_trigger_by_webhook(\"non_existent_path_or_id\")\n# => nil\n```","ref":"Lightning.Workflows.html#get_trigger_by_webhook/1-examples"},{"type":"function","title":"Lightning.Workflows.get_webhook_trigger/2","doc":"Gets a Single Edge by it's webhook trigger.","ref":"Lightning.Workflows.html#get_webhook_trigger/2"},{"type":"function","title":"Lightning.Workflows.get_workflow/1","doc":"","ref":"Lightning.Workflows.html#get_workflow/1"},{"type":"function","title":"Lightning.Workflows.get_workflow!/1","doc":"Gets a single workflow.\n\nRaises `Ecto.NoResultsError` if the Workflow does not exist.","ref":"Lightning.Workflows.html#get_workflow!/1"},{"type":"function","title":"Examples - Lightning.Workflows.get_workflow!/1","doc":"iex> get_workflow!(123)\n %Workflow{}\n\n iex> get_workflow!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.Workflows.html#get_workflow!/1-examples"},{"type":"function","title":"Lightning.Workflows.get_workflows_for/1","doc":"Retrieves a list of active Workflows with their jobs and triggers preloaded.","ref":"Lightning.Workflows.html#get_workflows_for/1"},{"type":"function","title":"Lightning.Workflows.has_newer_version?/1","doc":"","ref":"Lightning.Workflows.html#has_newer_version?/1"},{"type":"function","title":"Lightning.Workflows.jobs_ordered_subquery/0","doc":"A way to ensure the consistency of nodes.\nThis query orders jobs based on their `inserted_at` timestamps in ascending order","ref":"Lightning.Workflows.html#jobs_ordered_subquery/0"},{"type":"function","title":"Lightning.Workflows.list_workflows/0","doc":"Returns the list of workflows.","ref":"Lightning.Workflows.html#list_workflows/0"},{"type":"function","title":"Examples - Lightning.Workflows.list_workflows/0","doc":"iex> list_workflows()\n [%Workflow{}, ...]","ref":"Lightning.Workflows.html#list_workflows/0-examples"},{"type":"function","title":"Lightning.Workflows.mark_for_deletion/2","doc":"Returns an `%Ecto.Changeset{}` for changing the workflow request_deletion.","ref":"Lightning.Workflows.html#mark_for_deletion/2"},{"type":"function","title":"Examples - Lightning.Workflows.mark_for_deletion/2","doc":"iex> change_request_deletion(workflow)\n %Ecto.Changeset{data: %Workflow{}}","ref":"Lightning.Workflows.html#mark_for_deletion/2-examples"},{"type":"function","title":"Lightning.Workflows.publish_kafka_trigger_events/1","doc":"","ref":"Lightning.Workflows.html#publish_kafka_trigger_events/1"},{"type":"function","title":"Lightning.Workflows.save_workflow/1","doc":"","ref":"Lightning.Workflows.html#save_workflow/1"},{"type":"function","title":"Lightning.Workflows.subscribe/1","doc":"","ref":"Lightning.Workflows.html#subscribe/1"},{"type":"function","title":"Lightning.Workflows.to_project_space/1","doc":"","ref":"Lightning.Workflows.html#to_project_space/1"},{"type":"function","title":"Lightning.Workflows.update_trigger/2","doc":"Updates a trigger","ref":"Lightning.Workflows.html#update_trigger/2"},{"type":"function","title":"Lightning.Workflows.workflow_exists?/2","doc":"Check if workflow exist","ref":"Lightning.Workflows.html#workflow_exists?/2"},{"type":"module","title":"Lightning.Workflows.Edge","doc":"Ecto model for Workflow Edges.\n\nA Workflow Edge represents a connection between two jobs\n(or a trigger and a job) in a workflow.\n\nThe source of the edge is either a job or a trigger.\nThe target of the edge is always a job.","ref":"Lightning.Workflows.Edge.html"},{"type":"function","title":"Lightning.Workflows.Edge.changeset/2","doc":"","ref":"Lightning.Workflows.Edge.html#changeset/2"},{"type":"function","title":"Lightning.Workflows.Edge.new/1","doc":"","ref":"Lightning.Workflows.Edge.html#new/1"},{"type":"function","title":"Lightning.Workflows.Edge.validate/1","doc":"","ref":"Lightning.Workflows.Edge.html#validate/1"},{"type":"type","title":"Lightning.Workflows.Edge.edge_condition/0","doc":"","ref":"Lightning.Workflows.Edge.html#t:edge_condition/0"},{"type":"type","title":"Lightning.Workflows.Edge.t/0","doc":"","ref":"Lightning.Workflows.Edge.html#t:t/0"},{"type":"module","title":"Lightning.Workflows.Job","doc":"Ecto model for Jobs.\n\nA Job contains the fields for defining a job.\n\n* `body`\n The expression/javascript code\n* `name`\n A plain text identifier\n* `adaptor`\n An NPM style string that contains both the module name and it's version.\n E.g. `@openfn/language-http@v1.2.3` or `@openfn/language-foo@latest`.\n While the version suffix isn't enforced here as it's not strictly necessary\n in this context, the front end will ensure a version is stated (`@latest`\n being the default).","ref":"Lightning.Workflows.Job.html"},{"type":"function","title":"Lightning.Workflows.Job.new/1","doc":"","ref":"Lightning.Workflows.Job.html#new/1"},{"type":"function","title":"Lightning.Workflows.Job.put_project_credential/2","doc":"","ref":"Lightning.Workflows.Job.html#put_project_credential/2"},{"type":"function","title":"Lightning.Workflows.Job.put_workflow/2","doc":"Attaches a workflow to a job, this is useful when you have an unpersisted\nWorkflow changeset - and want it to be created at the same time as a Job.\n\n\nExample:\n\n workflow =\n Ecto.Changeset.cast(\n %Lightning.Workflows.Workflow{},\n %{ \"project_id\" => attrs[:project_id], \"id\" => Ecto.UUID.generate() },\n [:project_id, :id]\n )\n\n job =\n %Job{}\n |> Ecto.Changeset.change()\n |> Job.put_workflow(workflow)\n |> Job.changeset(attrs)","ref":"Lightning.Workflows.Job.html#put_workflow/2"},{"type":"function","title":"Lightning.Workflows.Job.validate/1","doc":"","ref":"Lightning.Workflows.Job.html#validate/1"},{"type":"type","title":"Lightning.Workflows.Job.t/0","doc":"","ref":"Lightning.Workflows.Job.html#t:t/0"},{"type":"module","title":"Lightning.Workflows.Node","doc":"Represents a node in a workflow graph.","ref":"Lightning.Workflows.Node.html"},{"type":"module","title":"Lightning.Workflows.Presence","doc":"Handles user presence tracking within the Workflow canvas page.\n\nThis module leverages Phoenix.Presence to track user sessions, manage user priorities,\nand list active presences on specified topics.","ref":"Lightning.Workflows.Presence.html"},{"type":"function","title":"Lightning.Workflows.Presence.build_presences_summary/2","doc":"Builds a summary of presences with details about the current user's presence, promotable presences,\nand edit priority.","ref":"Lightning.Workflows.Presence.html#build_presences_summary/2"},{"type":"function","title":"Parameters - Lightning.Workflows.Presence.build_presences_summary/2","doc":"- `presences` (list): A list of presence records, each containing user information and a joined_at timestamp.\n - `params` (map): A map containing the following keys:\n - `:current_user_presence` - The presence record for the current user.\n - `:current_user` - The current user record.\n - `:view_only_users_ids` - A list of user IDs who have view-only permissions.","ref":"Lightning.Workflows.Presence.html#build_presences_summary/2-parameters"},{"type":"function","title":"Returns - Lightning.Workflows.Presence.build_presences_summary/2","doc":"- `map`: A map containing the following keys:\n - `:presences` - The sorted list of all presences.\n - `:prior_user_presence` - The presence record with edit priority.\n - `:current_user_presence` - The presence record for the current user.\n - `:has_presence_edit_priority` - A boolean indicating if the current user has edit priority.","ref":"Lightning.Workflows.Presence.html#build_presences_summary/2-returns"},{"type":"function","title":"Examples - Lightning.Workflows.Presence.build_presences_summary/2","doc":"iex> presences = [\n ...> %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},\n ...> %{user: %{id: 2}, joined_at: ~N[2024-07-03 12:05:00], active_sessions: 1},\n ...> %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1}\n ...> ]\n iex> params = %{\n ...> current_user_presence: %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},\n ...> current_user: %{id: 1},\n ...> view_only_users_ids: [2]\n ...> }\n iex> build_presences_summary(presences, params)\n %{\n presences: [\n %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},\n %{user: %{id: 2}, joined_at: ~N[2024-07-03 12:05:00], active_sessions: 1},\n %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1}\n ],\n prior_user_presence: %{user: %{id: 3}, joined_at: ~N[2024-07-03 12:10:00], active_sessions: 1},\n current_user_presence: %{user: %{id: 1}, joined_at: ~N[2024-07-03 12:00:00], active_sessions: 1},\n has_presence_edit_priority: true\n }","ref":"Lightning.Workflows.Presence.html#build_presences_summary/2-examples"},{"type":"function","title":"Lightning.Workflows.Presence.child_spec/1","doc":"","ref":"Lightning.Workflows.Presence.html#child_spec/1"},{"type":"function","title":"Lightning.Workflows.Presence.fetch/2","doc":"","ref":"Lightning.Workflows.Presence.html#fetch/2"},{"type":"function","title":"Lightning.Workflows.Presence.fetchers_pids/0","doc":"","ref":"Lightning.Workflows.Presence.html#fetchers_pids/0"},{"type":"function","title":"Lightning.Workflows.Presence.get_by_key/2","doc":"","ref":"Lightning.Workflows.Presence.html#get_by_key/2"},{"type":"function","title":"Lightning.Workflows.Presence.list/1","doc":"","ref":"Lightning.Workflows.Presence.html#list/1"},{"type":"function","title":"Lightning.Workflows.Presence.list_presences/1","doc":"Lists all presences for a given topic.","ref":"Lightning.Workflows.Presence.html#list_presences/1"},{"type":"function","title":"Parameters - Lightning.Workflows.Presence.list_presences/1","doc":"- `topic`: The topic to list the presences for.","ref":"Lightning.Workflows.Presence.html#list_presences/1-parameters"},{"type":"function","title":"Examples - Lightning.Workflows.Presence.list_presences/1","doc":"iex> Lightning.Workflows.Presence.list_presences(\"workflow:canvas\")\n [%Lightning.Workflows.Presence{user: %User{id: 1}, ...}, ...]","ref":"Lightning.Workflows.Presence.html#list_presences/1-examples"},{"type":"function","title":"Lightning.Workflows.Presence.new_user_presence/3","doc":"Creates a new `UserPresence` struct.","ref":"Lightning.Workflows.Presence.html#new_user_presence/3"},{"type":"function","title":"Parameters - Lightning.Workflows.Presence.new_user_presence/3","doc":"- `user`: The user data to be included in the presence.\n - `joined_at`: The timestamp when the user joined, in microseconds.\n - `active_sessions`: The number of active sessions for the user (default is 0).","ref":"Lightning.Workflows.Presence.html#new_user_presence/3-parameters"},{"type":"function","title":"Examples - Lightning.Workflows.Presence.new_user_presence/3","doc":"iex> Lightning.Workflows.Presence.new_user_presence(%User{id: 1}, 1625597762000000)\n %Lightning.Workflows.Presence{\n user: %User{id: 1},\n joined_at: 1625597762000000,\n active_sessions: 0\n }","ref":"Lightning.Workflows.Presence.html#new_user_presence/3-examples"},{"type":"function","title":"Lightning.Workflows.Presence.track/3","doc":"","ref":"Lightning.Workflows.Presence.html#track/3"},{"type":"function","title":"Lightning.Workflows.Presence.track/4","doc":"","ref":"Lightning.Workflows.Presence.html#track/4"},{"type":"function","title":"Lightning.Workflows.Presence.track_user_presence/3","doc":"Tracks the presence of a user on a given topic.","ref":"Lightning.Workflows.Presence.html#track_user_presence/3"},{"type":"function","title":"Parameters - Lightning.Workflows.Presence.track_user_presence/3","doc":"- `user`: The user to be tracked.\n - `topic`: The topic to track the user on.\n - `pid`: The process identifier for the user's session.","ref":"Lightning.Workflows.Presence.html#track_user_presence/3-parameters"},{"type":"function","title":"Examples - Lightning.Workflows.Presence.track_user_presence/3","doc":"iex> Lightning.Workflows.Presence.track_user_presence(%User{id: 1}, \"room:lobby\", self())\n :ok","ref":"Lightning.Workflows.Presence.html#track_user_presence/3-examples"},{"type":"function","title":"Lightning.Workflows.Presence.untrack/2","doc":"","ref":"Lightning.Workflows.Presence.html#untrack/2"},{"type":"function","title":"Lightning.Workflows.Presence.untrack/3","doc":"","ref":"Lightning.Workflows.Presence.html#untrack/3"},{"type":"function","title":"Lightning.Workflows.Presence.update/3","doc":"","ref":"Lightning.Workflows.Presence.html#update/3"},{"type":"function","title":"Lightning.Workflows.Presence.update/4","doc":"","ref":"Lightning.Workflows.Presence.html#update/4"},{"type":"module","title":"Lightning.Workflows.Query","doc":"Query module for finding Jobs.","ref":"Lightning.Workflows.Query.html"},{"type":"function","title":"Lightning.Workflows.Query.enabled_cron_jobs_by_edge/0","doc":"Returns active jobs with their cron triggers for use in the cron scheduling\nservice.","ref":"Lightning.Workflows.Query.html#enabled_cron_jobs_by_edge/0"},{"type":"function","title":"Lightning.Workflows.Query.jobs_for/1","doc":"Returns all jobs accessible to a user, via their projects\nor all jobs in a given project.","ref":"Lightning.Workflows.Query.html#jobs_for/1"},{"type":"module","title":"Lightning.Workflows.Scheduler","doc":"The Scheduler is responsible for finding jobs that are ready to run based on\ntheir cron schedule, and then running them.","ref":"Lightning.Workflows.Scheduler.html"},{"type":"function","title":"Lightning.Workflows.Scheduler.enqueue_cronjobs/0","doc":"Find and start any cronjobs that are scheduled to run for a given time\n(defaults to the current time).","ref":"Lightning.Workflows.Scheduler.html#enqueue_cronjobs/0"},{"type":"function","title":"Lightning.Workflows.Scheduler.enqueue_cronjobs/1","doc":"","ref":"Lightning.Workflows.Scheduler.html#enqueue_cronjobs/1"},{"type":"module","title":"Lightning.Workflows.Snapshot","doc":"Ecto model for Workflow Snapshots.\n\nSnapshots are a way to store the state of a workflow at a given point in time.","ref":"Lightning.Workflows.Snapshot.html"},{"type":"function","title":"Lightning.Workflows.Snapshot.build/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#build/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.create/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#create/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_all_by_ids/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#get_all_by_ids/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_all_for/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#get_all_for/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_by_version/2","doc":"","ref":"Lightning.Workflows.Snapshot.html#get_by_version/2"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_current_for/1","doc":"Get the latest snapshot for a workflow, based on the lock_version.\n\nIt returns the latest snapshot regardless of the lock_version of the\nworkflow passed in. This is intentional to ensure that\n`get_or_create_latest_for/1` doesn't attempt to create a new snapshot if the\nworkflow has been updated elsewhere.","ref":"Lightning.Workflows.Snapshot.html#get_current_for/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_or_create_latest_for/1","doc":"Get the latest snapshot for a workflow, or create one if it doesn't exist.","ref":"Lightning.Workflows.Snapshot.html#get_or_create_latest_for/1"},{"type":"function","title":"Lightning.Workflows.Snapshot.get_or_create_latest_for/3","doc":"","ref":"Lightning.Workflows.Snapshot.html#get_or_create_latest_for/3"},{"type":"function","title":"Lightning.Workflows.Snapshot.new/1","doc":"","ref":"Lightning.Workflows.Snapshot.html#new/1"},{"type":"type","title":"Lightning.Workflows.Snapshot.t/0","doc":"","ref":"Lightning.Workflows.Snapshot.html#t:t/0"},{"type":"module","title":"Lightning.Workflows.Snapshot.Edge","doc":"","ref":"Lightning.Workflows.Snapshot.Edge.html"},{"type":"module","title":"Lightning.Workflows.Snapshot.Job","doc":"","ref":"Lightning.Workflows.Snapshot.Job.html"},{"type":"module","title":"Lightning.Workflows.Snapshot.Trigger","doc":"","ref":"Lightning.Workflows.Snapshot.Trigger.html"},{"type":"module","title":"Lightning.Workflows.Trigger","doc":"Ecto model for Triggers.\n\nTriggers represent the criteria in which a Job might be invoked.","ref":"Lightning.Workflows.Trigger.html"},{"type":"module","title":"Types - Lightning.Workflows.Trigger","doc":"","ref":"Lightning.Workflows.Trigger.html#module-types"},{"type":"module","title":"Webhook (default) - Lightning.Workflows.Trigger","doc":"A webhook trigger allows a Job to invoked (via `Lightning.Invocation`) when it's\nendpoint is called.","ref":"Lightning.Workflows.Trigger.html#module-webhook-default"},{"type":"function","title":"Lightning.Workflows.Trigger.cast_changeset/2","doc":"","ref":"Lightning.Workflows.Trigger.html#cast_changeset/2"},{"type":"function","title":"Lightning.Workflows.Trigger.new/1","doc":"","ref":"Lightning.Workflows.Trigger.html#new/1"},{"type":"function","title":"Lightning.Workflows.Trigger.validate/1","doc":"","ref":"Lightning.Workflows.Trigger.html#validate/1"},{"type":"function","title":"Lightning.Workflows.Trigger.with_auth_methods_query/0","doc":"","ref":"Lightning.Workflows.Trigger.html#with_auth_methods_query/0"},{"type":"type","title":"Lightning.Workflows.Trigger.t/0","doc":"","ref":"Lightning.Workflows.Trigger.html#t:t/0"},{"type":"type","title":"Lightning.Workflows.Trigger.trigger_type/0","doc":"","ref":"Lightning.Workflows.Trigger.html#t:trigger_type/0"},{"type":"module","title":"Lightning.Workflows.Triggers.Events","doc":"Responsible for the publishing of and subscription to trigger-related events.","ref":"Lightning.Workflows.Triggers.Events.html"},{"type":"function","title":"Lightning.Workflows.Triggers.Events.kafka_trigger_notification_sent/2","doc":"","ref":"Lightning.Workflows.Triggers.Events.html#kafka_trigger_notification_sent/2"},{"type":"function","title":"Lightning.Workflows.Triggers.Events.kafka_trigger_updated/1","doc":"","ref":"Lightning.Workflows.Triggers.Events.html#kafka_trigger_updated/1"},{"type":"function","title":"Lightning.Workflows.Triggers.Events.kafka_trigger_updated_topic/0","doc":"","ref":"Lightning.Workflows.Triggers.Events.html#kafka_trigger_updated_topic/0"},{"type":"function","title":"Lightning.Workflows.Triggers.Events.subscribe_to_kafka_trigger_updated/0","doc":"","ref":"Lightning.Workflows.Triggers.Events.html#subscribe_to_kafka_trigger_updated/0"},{"type":"module","title":"Lightning.Workflows.Triggers.KafkaConfiguration","doc":"Configuration of Kafka Triggers.","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.apply_hosts_string/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#apply_hosts_string/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.apply_topics_string/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#apply_topics_string/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.changeset/2","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#changeset/2"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.generate_hosts_string/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#generate_hosts_string/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.generate_topics_string/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#generate_topics_string/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.sasl_types/0","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#sasl_types/0"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.set_group_id_if_required/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#set_group_id_if_required/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.validate_initial_offset_reset_policy/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#validate_initial_offset_reset_policy/1"},{"type":"function","title":"Lightning.Workflows.Triggers.KafkaConfiguration.validate_sasl_credentials/1","doc":"","ref":"Lightning.Workflows.Triggers.KafkaConfiguration.html#validate_sasl_credentials/1"},{"type":"module","title":"Lightning.Workflows.WebhookAuthMethod","doc":"The `Lightning.Workflows.WebhookAuthMethod` module defines the schema for webhook authentication methods and provides functionalities to handle them.","ref":"Lightning.Workflows.WebhookAuthMethod.html"},{"type":"module","title":"Schema - Lightning.Workflows.WebhookAuthMethod","doc":"The schema represents a webhook authentication method that can be of two types - `:basic` and `:api`. The basic type requires a username and password, while the api type requires an api_key.\n\nThe schema fields include:\n - `name`: the name of the authentication method\n - `auth_type`: the type of authentication, can be `:basic` or `:api`\n - `username`: the username required for basic authentication\n - `password`: the password required for basic authentication (virtual field)\n - `hashed_password`: the hashed version of the password\n - `api_key`: the API key required for API authentication","ref":"Lightning.Workflows.WebhookAuthMethod.html#module-schema"},{"type":"module","title":"Associations - Lightning.Workflows.WebhookAuthMethod","doc":"Each `WebhookAuthMethod` belongs to a `project`.\nIt is also associated with multiple `triggers` through a many_to_many relationship.","ref":"Lightning.Workflows.WebhookAuthMethod.html#module-associations"},{"type":"module","title":"Validations and Constraints - Lightning.Workflows.WebhookAuthMethod","doc":"This module provides changeset functions for casting and validating the schema fields and applying unique constraints on `name`, `username`, and `api_key` within the project scope.","ref":"Lightning.Workflows.WebhookAuthMethod.html#module-validations-and-constraints"},{"type":"module","title":"Password Verification - Lightning.Workflows.WebhookAuthMethod","doc":"The `valid_password?/2` function is provided to verify passwords and it avoids timing attacks by using `Bcrypt.no_user_verify/0` when there is no webhook_auth_method or the webhook_auth_method doesn't have a password.","ref":"Lightning.Workflows.WebhookAuthMethod.html#module-password-verification"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethod.changeset/2","doc":"","ref":"Lightning.Workflows.WebhookAuthMethod.html#changeset/2"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethod.generate_api_key/1","doc":"","ref":"Lightning.Workflows.WebhookAuthMethod.html#generate_api_key/1"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethod.update_changeset/2","doc":"","ref":"Lightning.Workflows.WebhookAuthMethod.html#update_changeset/2"},{"type":"type","title":"Lightning.Workflows.WebhookAuthMethod.t/0","doc":"","ref":"Lightning.Workflows.WebhookAuthMethod.html#t:t/0"},{"type":"module","title":"Lightning.Workflows.WebhookAuthMethodAudit","doc":"Model for storing changes to WebhookAuthMethod","ref":"Lightning.Workflows.WebhookAuthMethodAudit.html"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethodAudit.base_query/0","doc":"","ref":"Lightning.Workflows.WebhookAuthMethodAudit.html#base_query/0"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethodAudit.event/5","doc":"","ref":"Lightning.Workflows.WebhookAuthMethodAudit.html#event/5"},{"type":"function","title":"Lightning.Workflows.WebhookAuthMethodAudit.save/1","doc":"","ref":"Lightning.Workflows.WebhookAuthMethodAudit.html#save/1"},{"type":"module","title":"Lightning.Workflows.Workflow","doc":"Ecto model for Workflows.\n\nA Workflow contains the fields for defining a workflow.\n\n* `name`\n A plain text identifier","ref":"Lightning.Workflows.Workflow.html"},{"type":"function","title":"Lightning.Workflows.Workflow.request_deletion_changeset/2","doc":"","ref":"Lightning.Workflows.Workflow.html#request_deletion_changeset/2"},{"type":"function","title":"Lightning.Workflows.Workflow.touch/1","doc":"Forces an update to the workflows `updated_at` timestamp and the\n`lock_version`. This is useful when updating a child record like jobs or\ntriggers and a snapshot needs to made; but the Workflow itself didn't change.","ref":"Lightning.Workflows.Workflow.html#touch/1"},{"type":"function","title":"Lightning.Workflows.Workflow.validate/1","doc":"","ref":"Lightning.Workflows.Workflow.html#validate/1"},{"type":"function","title":"Lightning.Workflows.Workflow.workflow_activated?/1","doc":"Returns true if the workflow has any triggers that are _going to be_ activated.\n\nNew triggers are enabled by default, but existing triggers are only considered\nactivated if their `enabled` field is _changed_ to `true`.","ref":"Lightning.Workflows.Workflow.html#workflow_activated?/1"},{"type":"type","title":"Lightning.Workflows.Workflow.t/0","doc":"","ref":"Lightning.Workflows.Workflow.html#t:t/0"},{"type":"module","title":"Lightning.LogMessage","doc":"A custom type to handle JSON log messages.\n\nCurrently the underlying database type is a string, and workers may send\neither a string, or a JSON object. This type will encode JSON objects to\nstring.\n\n> #### Messages are always strings {: .info}\n>\n> While this type allows JSON objects to be sent, the model will always return\n> strings. This type is a stand-in until we want to add a JSONB column to the\n> underlying table.\n\nIn the case of JSON objects we serialize them to a string, and in the case of\narrays we serialize them individually and join them with a space.","ref":"Lightning.LogMessage.html"},{"type":"function","title":"Lightning.LogMessage.cast/1","doc":"","ref":"Lightning.LogMessage.html#cast/1"},{"type":"function","title":"Lightning.LogMessage.dump/1","doc":"","ref":"Lightning.LogMessage.html#dump/1"},{"type":"function","title":"Lightning.LogMessage.embed_as/1","doc":"","ref":"Lightning.LogMessage.html#embed_as/1"},{"type":"function","title":"Lightning.LogMessage.equal?/2","doc":"","ref":"Lightning.LogMessage.html#equal?/2"},{"type":"function","title":"Lightning.LogMessage.load/1","doc":"","ref":"Lightning.LogMessage.html#load/1"},{"type":"function","title":"Lightning.LogMessage.type/0","doc":"","ref":"Lightning.LogMessage.html#type/0"},{"type":"module","title":"Lightning.UnixDateTime","doc":"A custom DateTime type for Ecto that uses millisecond Unix timestamps.\n\nNodeJS uses millisecond Unix timestamps, and Ecto has a choice of either\nsecond or microsecond precision. This module allows millisecond precision\nintegers to be used as DateTime values without losing precision.\n\nMicrosecond timestamps can also be parsed, but currently they are expected\nto be provided as strings. This is because Javascript can't represent\nmicrosecond timestamps as an integer and BigInt can't be represented\nas a JSON value.\n\nAll functions fallback on the default Ecto types conversion functions.","ref":"Lightning.UnixDateTime.html"},{"type":"function","title":"Lightning.UnixDateTime.cast/1","doc":"Cast a Unix timestamp to a DateTime.\n\nAccepts integers and strings, and will try to parse the string as an integer.\nIf the integer is 13 digits long, it will be parsed as a millisecond\ntimestamp, and as a microsecond timestamp if it is 16 digits long.","ref":"Lightning.UnixDateTime.html#cast/1"},{"type":"function","title":"Lightning.UnixDateTime.dump/1","doc":"","ref":"Lightning.UnixDateTime.html#dump/1"},{"type":"function","title":"Lightning.UnixDateTime.embed_as/1","doc":"","ref":"Lightning.UnixDateTime.html#embed_as/1"},{"type":"function","title":"Lightning.UnixDateTime.equal?/2","doc":"","ref":"Lightning.UnixDateTime.html#equal?/2"},{"type":"function","title":"Lightning.UnixDateTime.load/1","doc":"","ref":"Lightning.UnixDateTime.html#load/1"},{"type":"function","title":"Lightning.UnixDateTime.type/0","doc":"","ref":"Lightning.UnixDateTime.html#type/0"},{"type":"module","title":"LightningWeb","doc":"The entrypoint for defining your web interface, such\nas controllers, views, channels and so on.\n\nThis can be used in your application as:\n\n use LightningWeb, :controller\n use LightningWeb, :view\n\nThe definitions below will be executed for every view,\ncontroller, etc, so keep them short and clean, focused\non imports, uses and aliases.\n\nDo NOT define functions inside the quoted expressions\nbelow. Instead, define any helper function in modules\nand import those modules here.","ref":"LightningWeb.html"},{"type":"macro","title":"LightningWeb.__using__/1","doc":"When used, dispatch to the appropriate controller/view/etc.","ref":"LightningWeb.html#__using__/1"},{"type":"function","title":"LightningWeb.channel/0","doc":"","ref":"LightningWeb.html#channel/0"},{"type":"function","title":"LightningWeb.component/0","doc":"","ref":"LightningWeb.html#component/0"},{"type":"function","title":"LightningWeb.controller/0","doc":"","ref":"LightningWeb.html#controller/0"},{"type":"function","title":"LightningWeb.html/0","doc":"","ref":"LightningWeb.html#html/0"},{"type":"function","title":"LightningWeb.live_component/0","doc":"","ref":"LightningWeb.html#live_component/0"},{"type":"function","title":"LightningWeb.live_view/1","doc":"","ref":"LightningWeb.html#live_view/1"},{"type":"function","title":"LightningWeb.router/0","doc":"","ref":"LightningWeb.html#router/0"},{"type":"function","title":"LightningWeb.static_paths/0","doc":"","ref":"LightningWeb.html#static_paths/0"},{"type":"function","title":"LightningWeb.verified_routes/0","doc":"","ref":"LightningWeb.html#verified_routes/0"},{"type":"function","title":"LightningWeb.view/0","doc":"","ref":"LightningWeb.html#view/0"},{"type":"module","title":"LightningWeb.API.Helpers","doc":"Helpers for the API views","ref":"LightningWeb.API.Helpers.html"},{"type":"function","title":"LightningWeb.API.Helpers.pagination_link/3","doc":"","ref":"LightningWeb.API.Helpers.html#pagination_link/3"},{"type":"function","title":"LightningWeb.API.Helpers.pagination_links/2","doc":"","ref":"LightningWeb.API.Helpers.html#pagination_links/2"},{"type":"function","title":"LightningWeb.API.Helpers.url_for/2","doc":"","ref":"LightningWeb.API.Helpers.html#url_for/2"},{"type":"module","title":"LightningWeb.API.JobController","doc":"","ref":"LightningWeb.API.JobController.html"},{"type":"function","title":"LightningWeb.API.JobController.index/2","doc":"","ref":"LightningWeb.API.JobController.html#index/2"},{"type":"function","title":"LightningWeb.API.JobController.show/2","doc":"","ref":"LightningWeb.API.JobController.html#show/2"},{"type":"module","title":"LightningWeb.API.ProjectController","doc":"","ref":"LightningWeb.API.ProjectController.html"},{"type":"function","title":"LightningWeb.API.ProjectController.index/2","doc":"","ref":"LightningWeb.API.ProjectController.html#index/2"},{"type":"function","title":"LightningWeb.API.ProjectController.show/2","doc":"","ref":"LightningWeb.API.ProjectController.html#show/2"},{"type":"module","title":"LightningWeb.API.ProvisioningController","doc":"","ref":"LightningWeb.API.ProvisioningController.html"},{"type":"function","title":"LightningWeb.API.ProvisioningController.create/2","doc":"Creates or updates a project based on a JSON payload that may or may not\ncontain UUIDs for existing resources.","ref":"LightningWeb.API.ProvisioningController.html#create/2"},{"type":"function","title":"LightningWeb.API.ProvisioningController.show/2","doc":"Returns a project \"state.json\", complete with UUIDs to enable idempotent\nproject deployments and updates to existing projects via the CLI.","ref":"LightningWeb.API.ProvisioningController.html#show/2"},{"type":"function","title":"LightningWeb.API.ProvisioningController.show_yaml/2","doc":"Returns a description of the project as yaml. Same as the export project to\nyaml button (see Downloads Controller) but made for the API.","ref":"LightningWeb.API.ProvisioningController.html#show_yaml/2"},{"type":"module","title":"LightningWeb.API.RegistrationController","doc":"","ref":"LightningWeb.API.RegistrationController.html"},{"type":"function","title":"LightningWeb.API.RegistrationController.create/2","doc":"","ref":"LightningWeb.API.RegistrationController.html#create/2"},{"type":"module","title":"LightningWeb.AccountConfirmationModal","doc":"A LiveView component for displaying an account confirmation modal.\n\nThis component is responsible for informing users that access to their\naccounts, projects, and workflows is restricted until they confirm\ntheir account. It provides functionality to resend the confirmation\nemail and allows users to update their email address if needed.","ref":"LightningWeb.AccountConfirmationModal.html"},{"type":"module","title":"Features - LightningWeb.AccountConfirmationModal","doc":"- Displays a modal with instructions for account confirmation.\n- Allows users to resend the confirmation email.\n- Provides feedback when the confirmation email is successfully sent.\n- Allows users to navigate to the profile page to update their email address.","ref":"LightningWeb.AccountConfirmationModal.html#module-features"},{"type":"module","title":"Usage - LightningWeb.AccountConfirmationModal","doc":"Include this component in your LiveView template where you need to prompt\nusers to confirm their account. The component determines whether the modal\nshould be shown based on the current view context.","ref":"LightningWeb.AccountConfirmationModal.html#module-usage"},{"type":"module","title":"Examples - LightningWeb.AccountConfirmationModal","doc":"<.live_component\n module={LightningWeb.AccountConfirmationModal}\n id=\"account-confirmation-modal\"\n current_user={@current_user}\n />\n\nThe component uses assigns to manage its state, including:\n\n- `:show_modal` - Determines if the modal should be visible.\n- `:email_sent` - Indicates if the confirmation email was successfully sent.","ref":"LightningWeb.AccountConfirmationModal.html#module-examples"},{"type":"module","title":"LightningWeb.AuditLive.Index","doc":"LiveView for listing Audit events","ref":"LightningWeb.AuditLive.Index.html"},{"type":"function","title":"LightningWeb.AuditLive.Index.diff/1","doc":"","ref":"LightningWeb.AuditLive.Index.html#diff/1"},{"type":"function","title":"LightningWeb.AuditLive.Index.render/1","doc":"","ref":"LightningWeb.AuditLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.AuthProvidersLive.FormComponent","doc":"Form Component for working with a single Job\n\nA Job's `adaptor` field is a combination of the module name and the version.\nIt's formatted as an NPM style string.\n\nThe form allows the user to select a module by name and then it's version,\nwhile the version dropdown itself references `adaptor` directly.\n\nMeaning the `adaptor_name` dropdown and assigns value is not persisted.","ref":"LightningWeb.AuthProvidersLive.FormComponent.html"},{"type":"module","title":"LightningWeb.AuthProvidersLive.Index","doc":"LiveView for listing and managing Projects","ref":"LightningWeb.AuthProvidersLive.Index.html"},{"type":"module","title":"LightningWeb.BackupCodesController","doc":"","ref":"LightningWeb.BackupCodesController.html"},{"type":"function","title":"LightningWeb.BackupCodesController.print/2","doc":"","ref":"LightningWeb.BackupCodesController.html#print/2"},{"type":"module","title":"LightningWeb.BackupCodesLive.Index","doc":"LiveView for user backup codes.","ref":"LightningWeb.BackupCodesLive.Index.html"},{"type":"function","title":"LightningWeb.BackupCodesLive.Index.render/1","doc":"","ref":"LightningWeb.BackupCodesLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.ChangesetJSON","doc":"Renders changesets as JSON.","ref":"LightningWeb.ChangesetJSON.html"},{"type":"function","title":"LightningWeb.ChangesetJSON.error/1","doc":"","ref":"LightningWeb.ChangesetJSON.html#error/1"},{"type":"module","title":"LightningWeb.ChangesetView","doc":"","ref":"LightningWeb.ChangesetView.html"},{"type":"function","title":"LightningWeb.ChangesetView.__resource__/0","doc":"The resource name, as an atom, for this view","ref":"LightningWeb.ChangesetView.html#__resource__/0"},{"type":"function","title":"LightningWeb.ChangesetView.render/2","doc":"Renders the given template locally.","ref":"LightningWeb.ChangesetView.html#render/2"},{"type":"function","title":"LightningWeb.ChangesetView.template_not_found/2","doc":"Callback invoked when no template is found.\nBy default it raises but can be customized\nto render a particular template.","ref":"LightningWeb.ChangesetView.html#template_not_found/2"},{"type":"module","title":"LightningWeb.ChannelHelpers","doc":"Helper functions for channels","ref":"LightningWeb.ChannelHelpers.html"},{"type":"function","title":"LightningWeb.ChannelHelpers.reply_with/2","doc":"","ref":"LightningWeb.ChannelHelpers.html#reply_with/2"},{"type":"module","title":"LightningWeb.CollectionLive.CollectionCreationModal","doc":"","ref":"LightningWeb.CollectionLive.CollectionCreationModal.html"},{"type":"module","title":"LightningWeb.CollectionLive.Components","doc":"","ref":"LightningWeb.CollectionLive.Components.html"},{"type":"function","title":"LightningWeb.CollectionLive.Components.collections_table/1","doc":"","ref":"LightningWeb.CollectionLive.Components.html#collections_table/1"},{"type":"module","title":"LightningWeb.CollectionLive.Index","doc":"","ref":"LightningWeb.CollectionLive.Index.html"},{"type":"module","title":"LightningWeb.CollectionsController","doc":"","ref":"LightningWeb.CollectionsController.html"},{"type":"function","title":"LightningWeb.CollectionsController.delete/2","doc":"","ref":"LightningWeb.CollectionsController.html#delete/2"},{"type":"function","title":"LightningWeb.CollectionsController.delete_all/2","doc":"","ref":"LightningWeb.CollectionsController.html#delete_all/2"},{"type":"function","title":"LightningWeb.CollectionsController.get/2","doc":"","ref":"LightningWeb.CollectionsController.html#get/2"},{"type":"function","title":"LightningWeb.CollectionsController.put/2","doc":"","ref":"LightningWeb.CollectionsController.html#put/2"},{"type":"function","title":"LightningWeb.CollectionsController.put_all/2","doc":"","ref":"LightningWeb.CollectionsController.html#put_all/2"},{"type":"function","title":"LightningWeb.CollectionsController.stream/2","doc":"","ref":"LightningWeb.CollectionsController.html#stream/2"},{"type":"module","title":"LightningWeb.CollectionsController.ChunkAcc","doc":"","ref":"LightningWeb.CollectionsController.ChunkAcc.html"},{"type":"module","title":"LightningWeb.Components.Loaders","doc":"UI component to render a pill to create tags.","ref":"LightningWeb.Components.Loaders.html"},{"type":"function","title":"LightningWeb.Components.Loaders.button_loader/1","doc":"","ref":"LightningWeb.Components.Loaders.html#button_loader/1"},{"type":"function","title":"Slots - LightningWeb.Components.Loaders.button_loader/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.Loaders.html#button_loader/1-slots"},{"type":"function","title":"LightningWeb.Components.Loaders.offline_indicator/1","doc":"","ref":"LightningWeb.Components.Loaders.html#offline_indicator/1"},{"type":"function","title":"LightningWeb.Components.Loaders.text_ping_loader/1","doc":"","ref":"LightningWeb.Components.Loaders.html#text_ping_loader/1"},{"type":"function","title":"Slots - LightningWeb.Components.Loaders.text_ping_loader/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.Loaders.html#text_ping_loader/1-slots"},{"type":"module","title":"LightningWeb.Components.Menu","doc":"Menu components to render menu items for project and user/profile pages.","ref":"LightningWeb.Components.Menu.html"},{"type":"function","title":"LightningWeb.Components.Menu.menu_item/1","doc":"","ref":"LightningWeb.Components.Menu.html#menu_item/1"},{"type":"function","title":"LightningWeb.Components.Menu.profile_items/1","doc":"","ref":"LightningWeb.Components.Menu.html#profile_items/1"},{"type":"function","title":"LightningWeb.Components.Menu.project_items/1","doc":"","ref":"LightningWeb.Components.Menu.html#project_items/1"},{"type":"module","title":"LightningWeb.Components.Modal","doc":"A modal component that can be used to display a modal on the page.\n\nThis currently isn't used anywhere but should be used in the future to\nreplace the existing modal implementations.","ref":"LightningWeb.Components.Modal.html"},{"type":"function","title":"LightningWeb.Components.Modal.hide_modal/2","doc":"","ref":"LightningWeb.Components.Modal.html#hide_modal/2"},{"type":"function","title":"LightningWeb.Components.Modal.modal/1","doc":"","ref":"LightningWeb.Components.Modal.html#modal/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Modal.modal/1","doc":"* `id` (`:string`) (required)\n* `show` (`:boolean`) - Defaults to `false`.\n* `with_frame` (`:boolean`) - Defaults to `true`.\n* `target` (`:any`) - Defaults to `nil`.\n* `position` (`:string`) - Defaults to `\"fixed inset-0\"`.\n* `width` (`:string`) - Defaults to `\"max-w-3xl\"`.\n* `close_on_click_away` (`:boolean`) - Defaults to `true`.\n* `close_on_keydown` (`:boolean`) - Defaults to `true`.\n* `on_close` (`Phoenix.LiveView.JS`) - Defaults to `%Phoenix.LiveView.JS{ops: []}`.\n* `on_open` (`Phoenix.LiveView.JS`) - Defaults to `%Phoenix.LiveView.JS{ops: []}`.\n* Global attributes are accepted.","ref":"LightningWeb.Components.Modal.html#modal/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.Modal.modal/1","doc":"* `inner_block` (required)\n* `title`\n* `subtitle`\n* `footer` - Accepts attributes:\n\n * `class` (`:string`)","ref":"LightningWeb.Components.Modal.html#modal/1-slots"},{"type":"function","title":"LightningWeb.Components.Modal.modal_footer/1","doc":"","ref":"LightningWeb.Components.Modal.html#modal_footer/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Modal.modal_footer/1","doc":"* `class` (`:any`) - Defaults to `\"\"`.","ref":"LightningWeb.Components.Modal.html#modal_footer/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.Modal.modal_footer/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.Modal.html#modal_footer/1-slots"},{"type":"function","title":"LightningWeb.Components.Modal.show_modal/2","doc":"","ref":"LightningWeb.Components.Modal.html#show_modal/2"},{"type":"module","title":"LightningWeb.Components.NewInputs","doc":"A temporary module that will serve as a place to put new inputs that conform\nwith the newer CoreComponents conventions introduced in Phoenix 1.7.","ref":"LightningWeb.Components.NewInputs.html"},{"type":"function","title":"LightningWeb.Components.NewInputs.button/1","doc":"Renders a button.","ref":"LightningWeb.Components.NewInputs.html#button/1"},{"type":"function","title":"Examples - LightningWeb.Components.NewInputs.button/1","doc":"<.button>Send!\n <.button phx-click=\"go\" class=\"ml-2\">Send!","ref":"LightningWeb.Components.NewInputs.html#button/1-examples"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.button/1","doc":"* `id` (`:string`) - Defaults to `\"\"`.\n* `type` (`:string`) - Defaults to `\"button\"`.\n* `class` (`:any`) - Defaults to `\"\"`.\n* `color_class` (`:any`) - Defaults to `\"bg-primary-600 hover:bg-primary-700 text-white focus:ring-primary-500 disabled:bg-primary-300\"`.\n* `tooltip` (`:any`) - Defaults to `nil`.\n* Global attributes are accepted. Supports all globals plus: `[\"disabled\", \"form\", \"name\", \"value\"]`.","ref":"LightningWeb.Components.NewInputs.html#button/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.NewInputs.button/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.NewInputs.html#button/1-slots"},{"type":"function","title":"LightningWeb.Components.NewInputs.checkbox_element/1","doc":"Renders a checkbox input element.\n\nThis function is used internally by `input/1` and generally should not\nbe used directly.\n\nLook at `input type=\"checkbox\"` to see how these values `attr` get populated","ref":"LightningWeb.Components.NewInputs.html#checkbox_element/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.checkbox_element/1","doc":"* `id` (`:string`) - Defaults to `nil`.\n* `name` (`:string`) (required)\n* `value` (`:any`) (required)\n* `class` (`:string`)\n* `checked` (`:boolean`) - the checked flag for checkbox inputs.\n* `checked_value` (`:any`) - Defaults to `\"true\"`.\n* `unchecked_value` (`:any`) - Defaults to `\"false\"`.\n* `hidden_input` (`:boolean`) - Defaults to `true`.\n* Global attributes are accepted. Supports all globals plus: `[\"disabled\", \"form\", \"readonly\", \"required\"]`.","ref":"LightningWeb.Components.NewInputs.html#checkbox_element/1-attributes"},{"type":"function","title":"LightningWeb.Components.NewInputs.error/1","doc":"Generates a generic error message.","ref":"LightningWeb.Components.NewInputs.html#error/1"},{"type":"function","title":"Slots - LightningWeb.Components.NewInputs.error/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.NewInputs.html#error/1-slots"},{"type":"function","title":"LightningWeb.Components.NewInputs.errors/1","doc":"Generic wrapper for rendering error messages in custom input components.","ref":"LightningWeb.Components.NewInputs.html#errors/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.errors/1","doc":"* `field` (`Phoenix.HTML.FormField`) (required)","ref":"LightningWeb.Components.NewInputs.html#errors/1-attributes"},{"type":"function","title":"LightningWeb.Components.NewInputs.form_hidden_inputs/1","doc":"Generates hidden inputs for a form.\nAdapted from [PhoenixHTMLHelpers.Form.html#hidden_inputs_for/1](https://github.com/phoenixframework/phoenix_html_helpers/blob/v1.0.1/lib/phoenix_html_helpers/form.ex#L406)","ref":"LightningWeb.Components.NewInputs.html#form_hidden_inputs/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.form_hidden_inputs/1","doc":"* `form` (`Phoenix.HTML.Form`) (required)","ref":"LightningWeb.Components.NewInputs.html#form_hidden_inputs/1-attributes"},{"type":"function","title":"LightningWeb.Components.NewInputs.input/1","doc":"Renders an input with label and error messages.\n\nA `Phoenix.HTML.FormField` may be passed as argument,\nwhich is used to retrieve the input name, id, and values.\nOtherwise all attributes may be passed explicitly.","ref":"LightningWeb.Components.NewInputs.html#input/1"},{"type":"function","title":"Types - LightningWeb.Components.NewInputs.input/1","doc":"This function accepts all HTML input types, considering that:\n\n * You may also set `type=\"select\"` to render a ` ` tag\n\n * `type=\"checkbox\"` is used exclusively to render boolean values\n\n * For live file uploads, see `Phoenix.Component.live_file_input/1`\n\nSee https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input\nfor more information.","ref":"LightningWeb.Components.NewInputs.html#input/1-types"},{"type":"function","title":"Examples - LightningWeb.Components.NewInputs.input/1","doc":"<.input field={@form[:email]} type=\"email\" />\n <.input name=\"my-input\" errors={[\"oh no!\"]} />","ref":"LightningWeb.Components.NewInputs.html#input/1-examples"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.input/1","doc":"* `id` (`:any`) - Defaults to `nil`.\n* `name` (`:any`)\n* `label` (`:string`) - Defaults to `nil`.\n* `value` (`:any`)\n* `type` (`:string`) - Defaults to `\"text\"`.\n* `field` (`Phoenix.HTML.FormField`) - a form field struct retrieved from the form, for example: @form[:email].\n* `errors` (`:list`) - Defaults to `[]`.\n* `checked` (`:boolean`) - the checked flag for checkbox/radio inputs.\n* `checked_value` (`:any`) - the value to be sent when the checkbox is checked. Defaults to 'true'. Defaults to `\"true\"`.\n* `unchecked_value` (`:any`) - the value to be sent when the checkbox is unchecked, Defaults to 'false'. Defaults to `\"false\"`.\n* `hidden_input` (`:boolean`) - controls if this function will generate a hidden input to submit the unchecked value or not. Defaults to 'true'. Defaults to `true`.\n* `prompt` (`:string`) - the prompt for select inputs. Defaults to `nil`.\n* `options` (`:list`) - the options to pass to Phoenix.HTML.Form.options_for_select/2.\n* `multiple` (`:boolean`) - the multiple flag for select inputs. Defaults to `false`.\n* `button_placement` (`:string`) - Defaults to `nil`.\n* `class` (`:string`) - Defaults to `\"\"`.\n* `stretch` (`:boolean`) - control the wrapping div classes of some components like the textarea. Defaults to `false`.\n* `display_errors` (`:boolean`) - Defaults to `true`.\n* `tooltip` (`:any`) - Defaults to `nil`.\n* Global attributes are accepted. Supports all globals plus: `[\"accept\", \"autocomplete\", \"capture\", \"cols\", \"disabled\", \"form\", \"list\", \"max\", \"maxlength\", \"min\", \"minlength\", \"multiple\", \"pattern\", \"placeholder\", \"readonly\", \"required\", \"rows\", \"size\", \"step\"]`.","ref":"LightningWeb.Components.NewInputs.html#input/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.NewInputs.input/1","doc":"* `inner_block`","ref":"LightningWeb.Components.NewInputs.html#input/1-slots"},{"type":"function","title":"LightningWeb.Components.NewInputs.input_element/1","doc":"Renders an input element.\n\nThis function is used internally by `input/1` and generally should not\nbe used directly.\n\nIn the case of inputs that are different enough to warrant a new function,\nthis component can be used to maintain style consistency.","ref":"LightningWeb.Components.NewInputs.html#input_element/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.input_element/1","doc":"* `id` (`:string`) - Defaults to `nil`.\n* `name` (`:string`) (required)\n* `type` (`:string`) (required)\n* `value` (`:any`)\n* `errors` (`:list`) - Defaults to `[]`.\n* `class` (`:string`) - Defaults to `\"\"`.\n* Global attributes are accepted. Supports all globals plus: `[\"accept\", \"autocomplete\", \"capture\", \"cols\", \"disabled\", \"form\", \"list\", \"max\", \"maxlength\", \"min\", \"minlength\", \"multiple\", \"pattern\", \"placeholder\", \"readonly\", \"required\", \"rows\", \"size\", \"step\"]`.","ref":"LightningWeb.Components.NewInputs.html#input_element/1-attributes"},{"type":"function","title":"LightningWeb.Components.NewInputs.label/1","doc":"Renders a label.","ref":"LightningWeb.Components.NewInputs.html#label/1"},{"type":"function","title":"Attributes - LightningWeb.Components.NewInputs.label/1","doc":"* `for` (`:any`) - Defaults to `nil`.\n* `class` (`:any`) - Defaults to `\"\"`.\n* Global attributes are accepted.","ref":"LightningWeb.Components.NewInputs.html#label/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.NewInputs.label/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.NewInputs.html#label/1-slots"},{"type":"module","title":"LightningWeb.Components.Pills","doc":"UI component to render a pill to create tags.","ref":"LightningWeb.Components.Pills.html"},{"type":"function","title":"LightningWeb.Components.Pills.pill/1","doc":"","ref":"LightningWeb.Components.Pills.html#pill/1"},{"type":"function","title":"Slots - LightningWeb.Components.Pills.pill/1","doc":"* `inner_block` (required)","ref":"LightningWeb.Components.Pills.html#pill/1-slots"},{"type":"module","title":"LightningWeb.Components.Viewers","doc":"Components for rendering Logs and Dataclips.\n\n> #### Scrolling can be tricky {: .info}\n>\n> We seldom know how long a log or a dataclip will be, and we want to\n> be able to contain the element in a fixed height container.\n> In some situations wrapping the component in a `div` with `inline-flex`\n> class will help with scrolling.","ref":"LightningWeb.Components.Viewers.html"},{"type":"function","title":"LightningWeb.Components.Viewers.dataclip_viewer/1","doc":"","ref":"LightningWeb.Components.Viewers.html#dataclip_viewer/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Viewers.dataclip_viewer/1","doc":"* `id` (`:string`) (required)\n* `dataclip` (`:map`) (required)","ref":"LightningWeb.Components.Viewers.html#dataclip_viewer/1-attributes"},{"type":"function","title":"LightningWeb.Components.Viewers.log_viewer/1","doc":"Renders out a log line stream\n\nInternally it uses the `LogLineHighlight` hook to highlight the log line\nwith the `highlight_id` attribute.","ref":"LightningWeb.Components.Viewers.html#log_viewer/1"},{"type":"function","title":"Example - LightningWeb.Components.Viewers.log_viewer/1","doc":"","ref":"LightningWeb.Components.Viewers.html#log_viewer/1-example"},{"type":"function","title":"Attributes - LightningWeb.Components.Viewers.log_viewer/1","doc":"* `id` (`:string`) (required)\n* `run_id` (`:string`) (required)\n* `run_state` (`:any`) (required)\n* `logs_empty?` (`:boolean`) (required)\n* `selected_step_id` (`:string`)\n* `class` (`:string`) - Additional classes to add to the log viewer container. Defaults to `nil`.","ref":"LightningWeb.Components.Viewers.html#log_viewer/1-attributes"},{"type":"function","title":"LightningWeb.Components.Viewers.step_dataclip_viewer/1","doc":"","ref":"LightningWeb.Components.Viewers.html#step_dataclip_viewer/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Viewers.step_dataclip_viewer/1","doc":"* `id` (`:string`) (required)\n* `run_state` (`:any`) (required)\n* `class` (`:string`) - Additional classes to add to the log viewer container. Defaults to `nil`.\n* `step` (`:map`)\n* `dataclip` (`Lightning.Invocation.Dataclip`)\n* `input_or_output` (`:atom`) (required) - Must be one of `:input`, or `:output`.\n* `project_id` (`:string`) (required)\n* `admin_contacts` (`:list`) (required) - list of project admin emails.\n* `can_edit_data_retention` (`:boolean`) (required)","ref":"LightningWeb.Components.Viewers.html#step_dataclip_viewer/1-attributes"},{"type":"function","title":"LightningWeb.Components.Viewers.wiped_dataclip_viewer/1","doc":"","ref":"LightningWeb.Components.Viewers.html#wiped_dataclip_viewer/1"},{"type":"function","title":"Attributes - LightningWeb.Components.Viewers.wiped_dataclip_viewer/1","doc":"* `id` (`:string`) - Defaults to `nil`.\n* `input_or_output` (`:atom`) (required) - Must be one of `:input`, or `:output`.\n* `project_id` (`:string`) (required)\n* `admin_contacts` (`:list`) (required) - list of project admin emails.\n* `can_edit_data_retention` (`:boolean`) (required)","ref":"LightningWeb.Components.Viewers.html#wiped_dataclip_viewer/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Components.Viewers.wiped_dataclip_viewer/1","doc":"* `footer`","ref":"LightningWeb.Components.Viewers.html#wiped_dataclip_viewer/1-slots"},{"type":"module","title":"LightningWeb.CredentialLive.CredentialFormComponent","doc":"Form Component for working with a single Credential","ref":"LightningWeb.CredentialLive.CredentialFormComponent.html"},{"type":"module","title":"LightningWeb.CredentialLive.GenericOauthComponent","doc":"","ref":"LightningWeb.CredentialLive.GenericOauthComponent.html"},{"type":"module","title":"LightningWeb.CredentialLive.Helpers","doc":"This module provides helper functions for managing project associations\nwithin credential live views, allowing dynamic assignment and update\nof projects associations to credentials and / or oauth clients.","ref":"LightningWeb.CredentialLive.Helpers.html"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.filter_available_projects/2","doc":"Filters available projects to exclude any that are already selected.","ref":"LightningWeb.CredentialLive.Helpers.html#filter_available_projects/2"},{"type":"function","title":"Parameters - LightningWeb.CredentialLive.Helpers.filter_available_projects/2","doc":"- `all_projects`: A list of all projects.\n- `selected_projects`: A list of currently selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#filter_available_projects/2-parameters"},{"type":"function","title":"Returns - LightningWeb.CredentialLive.Helpers.filter_available_projects/2","doc":"- A list of projects that are not selected.","ref":"LightningWeb.CredentialLive.Helpers.html#filter_available_projects/2-returns"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.handle_save_response/2","doc":"","ref":"LightningWeb.CredentialLive.Helpers.html#handle_save_response/2"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.prepare_projects_associations/3","doc":"Prepares a list of projects to be associated, updated, or removed based on the selected input.","ref":"LightningWeb.CredentialLive.Helpers.html#prepare_projects_associations/3"},{"type":"function","title":"Parameters - LightningWeb.CredentialLive.Helpers.prepare_projects_associations/3","doc":"- `changeset`: The changeset from which projects are fetched.\n- `selected_projects`: A list of currently selected projects.\n- `assoc_key`: The key in the changeset data containing project associations.","ref":"LightningWeb.CredentialLive.Helpers.html#prepare_projects_associations/3-parameters"},{"type":"function","title":"Returns - LightningWeb.CredentialLive.Helpers.prepare_projects_associations/3","doc":"- A list of maps representing the projects to be deleted, added, or kept.","ref":"LightningWeb.CredentialLive.Helpers.html#prepare_projects_associations/3-returns"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.select_project/4","doc":"Selects a project to be added to the list of selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#select_project/4"},{"type":"function","title":"Parameters - LightningWeb.CredentialLive.Helpers.select_project/4","doc":"- `project_id`: The ID of the project to select.\n- `projects`: All available projects.\n- `available_projects`: Projects that are available for selection.\n- `selected_projects`: Currently selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#select_project/4-parameters"},{"type":"function","title":"Returns - LightningWeb.CredentialLive.Helpers.select_project/4","doc":"- A map with the updated lists of selected and available projects.","ref":"LightningWeb.CredentialLive.Helpers.html#select_project/4-returns"},{"type":"function","title":"LightningWeb.CredentialLive.Helpers.unselect_project/3","doc":"Unselects a project from the list of selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#unselect_project/3"},{"type":"function","title":"Parameters - LightningWeb.CredentialLive.Helpers.unselect_project/3","doc":"- `project_id`: The ID of the project to unselect.\n- `projects`: All projects available.\n- `selected_projects`: Currently selected projects.","ref":"LightningWeb.CredentialLive.Helpers.html#unselect_project/3-parameters"},{"type":"function","title":"Returns - LightningWeb.CredentialLive.Helpers.unselect_project/3","doc":"- A map with the updated lists of selected and available projects.","ref":"LightningWeb.CredentialLive.Helpers.html#unselect_project/3-returns"},{"type":"module","title":"LightningWeb.CredentialLive.Index","doc":"LiveView for listing and managing credentials","ref":"LightningWeb.CredentialLive.Index.html"},{"type":"function","title":"LightningWeb.CredentialLive.Index.delete_action/1","doc":"","ref":"LightningWeb.CredentialLive.Index.html#delete_action/1"},{"type":"function","title":"LightningWeb.CredentialLive.Index.handle_info/2","doc":"A generic handler for forwarding updates from PubSub","ref":"LightningWeb.CredentialLive.Index.html#handle_info/2"},{"type":"function","title":"LightningWeb.CredentialLive.Index.render/1","doc":"","ref":"LightningWeb.CredentialLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.CredentialLive.JsonSchemaBodyComponent","doc":"","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html"},{"type":"function","title":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.fieldset/1","doc":"","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#fieldset/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.JsonSchemaBodyComponent.fieldset/1","doc":"* `form` (`:map`) (required)","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#fieldset/1-attributes"},{"type":"function","title":"Slots - LightningWeb.CredentialLive.JsonSchemaBodyComponent.fieldset/1","doc":"* `inner_block`","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#fieldset/1-slots"},{"type":"function","title":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.schema_input/1","doc":"","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#schema_input/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.JsonSchemaBodyComponent.schema_input/1","doc":"* `form` (`:map`) (required)\n* `schema` (`:map`) (required)\n* `field` (`:any`) (required)","ref":"LightningWeb.CredentialLive.JsonSchemaBodyComponent.html#schema_input/1-attributes"},{"type":"module","title":"LightningWeb.CredentialLive.OauthClientFormComponent","doc":"Form Component for working with a single Credential","ref":"LightningWeb.CredentialLive.OauthClientFormComponent.html"},{"type":"function","title":"LightningWeb.CredentialLive.OauthClientFormComponent.global_client_checkbox/1","doc":"","ref":"LightningWeb.CredentialLive.OauthClientFormComponent.html#global_client_checkbox/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.OauthClientFormComponent.global_client_checkbox/1","doc":"* `form` (`:any`) (required)","ref":"LightningWeb.CredentialLive.OauthClientFormComponent.html#global_client_checkbox/1-attributes"},{"type":"module","title":"LightningWeb.CredentialLive.OauthComponent","doc":"","ref":"LightningWeb.CredentialLive.OauthComponent.html"},{"type":"function","title":"LightningWeb.CredentialLive.OauthComponent.fieldset/1","doc":"","ref":"LightningWeb.CredentialLive.OauthComponent.html#fieldset/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.OauthComponent.fieldset/1","doc":"* `form` (`:map`) (required)\n* `id` (`:string`) (required)\n* `update_body` (`:any`) (required)\n* `action` (`:any`) (required)\n* `scopes_changed` (`:boolean`) - Defaults to `false`.\n* `sandbox_changed` (`:boolean`) - Defaults to `false`.\n* `schema` (`:string`) (required)","ref":"LightningWeb.CredentialLive.OauthComponent.html#fieldset/1-attributes"},{"type":"function","title":"Slots - LightningWeb.CredentialLive.OauthComponent.fieldset/1","doc":"* `inner_block`","ref":"LightningWeb.CredentialLive.OauthComponent.html#fieldset/1-slots"},{"type":"module","title":"LightningWeb.CredentialLive.RawBodyComponent","doc":"","ref":"LightningWeb.CredentialLive.RawBodyComponent.html"},{"type":"function","title":"LightningWeb.CredentialLive.RawBodyComponent.fieldset/1","doc":"","ref":"LightningWeb.CredentialLive.RawBodyComponent.html#fieldset/1"},{"type":"function","title":"Attributes - LightningWeb.CredentialLive.RawBodyComponent.fieldset/1","doc":"* `form` (`:map`) (required)","ref":"LightningWeb.CredentialLive.RawBodyComponent.html#fieldset/1-attributes"},{"type":"function","title":"Slots - LightningWeb.CredentialLive.RawBodyComponent.fieldset/1","doc":"* `inner_block`","ref":"LightningWeb.CredentialLive.RawBodyComponent.html#fieldset/1-slots"},{"type":"module","title":"LightningWeb.DashboardLive.Components","doc":"","ref":"LightningWeb.DashboardLive.Components.html"},{"type":"function","title":"LightningWeb.DashboardLive.Components.user_projects_table/1","doc":"","ref":"LightningWeb.DashboardLive.Components.html#user_projects_table/1"},{"type":"function","title":"LightningWeb.DashboardLive.Components.welcome_banner/1","doc":"","ref":"LightningWeb.DashboardLive.Components.html#welcome_banner/1"},{"type":"module","title":"LightningWeb.DashboardLive.Index","doc":"","ref":"LightningWeb.DashboardLive.Index.html"},{"type":"module","title":"LightningWeb.DashboardLive.ProjectCreationModal","doc":"","ref":"LightningWeb.DashboardLive.ProjectCreationModal.html"},{"type":"module","title":"LightningWeb.DashboardLive.UserProjectsSection","doc":"","ref":"LightningWeb.DashboardLive.UserProjectsSection.html"},{"type":"module","title":"LightningWeb.DashboardLive.WelcomeSection","doc":"","ref":"LightningWeb.DashboardLive.WelcomeSection.html"},{"type":"module","title":"LightningWeb.DataclipController","doc":"","ref":"LightningWeb.DataclipController.html"},{"type":"function","title":"LightningWeb.DataclipController.show/2","doc":"","ref":"LightningWeb.DataclipController.html#show/2"},{"type":"module","title":"LightningWeb.DataclipLive.FormComponent","doc":"Form Component for working with a single dataclip","ref":"LightningWeb.DataclipLive.FormComponent.html"},{"type":"function","title":"LightningWeb.DataclipLive.FormComponent.render/1","doc":"","ref":"LightningWeb.DataclipLive.FormComponent.html#render/1"},{"type":"module","title":"LightningWeb.DataclipLive.Show","doc":"LiveView for showing a single dataclip.","ref":"LightningWeb.DataclipLive.Show.html"},{"type":"module","title":"LightningWeb.DownloadsController","doc":"","ref":"LightningWeb.DownloadsController.html"},{"type":"function","title":"LightningWeb.DownloadsController.download_project_yaml/2","doc":"","ref":"LightningWeb.DownloadsController.html#download_project_yaml/2"},{"type":"module","title":"LightningWeb.Endpoint","doc":"","ref":"LightningWeb.Endpoint.html"},{"type":"function","title":"LightningWeb.Endpoint.broadcast/3","doc":"","ref":"LightningWeb.Endpoint.html#broadcast/3"},{"type":"function","title":"LightningWeb.Endpoint.broadcast!/3","doc":"","ref":"LightningWeb.Endpoint.html#broadcast!/3"},{"type":"function","title":"LightningWeb.Endpoint.broadcast_from/4","doc":"","ref":"LightningWeb.Endpoint.html#broadcast_from/4"},{"type":"function","title":"LightningWeb.Endpoint.broadcast_from!/4","doc":"","ref":"LightningWeb.Endpoint.html#broadcast_from!/4"},{"type":"function","title":"LightningWeb.Endpoint.call/2","doc":"","ref":"LightningWeb.Endpoint.html#call/2"},{"type":"function","title":"LightningWeb.Endpoint.child_spec/1","doc":"Returns the child specification to start the endpoint\nunder a supervision tree.","ref":"LightningWeb.Endpoint.html#child_spec/1"},{"type":"function","title":"LightningWeb.Endpoint.config/2","doc":"Returns the endpoint configuration for `key`\n\nReturns `default` if the key does not exist.","ref":"LightningWeb.Endpoint.html#config/2"},{"type":"function","title":"LightningWeb.Endpoint.config_change/2","doc":"Reloads the configuration given the application environment changes.","ref":"LightningWeb.Endpoint.html#config_change/2"},{"type":"function","title":"LightningWeb.Endpoint.host/0","doc":"Returns the host for the given endpoint.","ref":"LightningWeb.Endpoint.html#host/0"},{"type":"function","title":"LightningWeb.Endpoint.init/1","doc":"","ref":"LightningWeb.Endpoint.html#init/1"},{"type":"function","title":"LightningWeb.Endpoint.local_broadcast/3","doc":"","ref":"LightningWeb.Endpoint.html#local_broadcast/3"},{"type":"function","title":"LightningWeb.Endpoint.local_broadcast_from/4","doc":"","ref":"LightningWeb.Endpoint.html#local_broadcast_from/4"},{"type":"function","title":"LightningWeb.Endpoint.path/1","doc":"Generates the path information when routing to this endpoint.","ref":"LightningWeb.Endpoint.html#path/1"},{"type":"function","title":"LightningWeb.Endpoint.script_name/0","doc":"Generates the script name.","ref":"LightningWeb.Endpoint.html#script_name/0"},{"type":"function","title":"LightningWeb.Endpoint.server_info/1","doc":"Returns the address and port that the server is running on","ref":"LightningWeb.Endpoint.html#server_info/1"},{"type":"function","title":"LightningWeb.Endpoint.start_link/1","doc":"Starts the endpoint supervision tree.\n\nAll other options are merged into the endpoint configuration.","ref":"LightningWeb.Endpoint.html#start_link/1"},{"type":"function","title":"LightningWeb.Endpoint.static_integrity/1","doc":"Generates a base64-encoded cryptographic hash (sha512) to a static file\nin `priv/static`. Meant to be used for Subresource Integrity with CDNs.","ref":"LightningWeb.Endpoint.html#static_integrity/1"},{"type":"function","title":"LightningWeb.Endpoint.static_lookup/1","doc":"Returns a two item tuple with the first item being the `static_path`\nand the second item being the `static_integrity`.","ref":"LightningWeb.Endpoint.html#static_lookup/1"},{"type":"function","title":"LightningWeb.Endpoint.static_path/1","doc":"Generates a route to a static file in `priv/static`.","ref":"LightningWeb.Endpoint.html#static_path/1"},{"type":"function","title":"LightningWeb.Endpoint.static_url/0","doc":"Generates the static URL without any path information.\n\nIt uses the configuration under `:static_url` to generate\nsuch. It falls back to `:url` if `:static_url` is not set.","ref":"LightningWeb.Endpoint.html#static_url/0"},{"type":"function","title":"LightningWeb.Endpoint.struct_url/0","doc":"Generates the endpoint base URL but as a `URI` struct.\n\nIt uses the configuration under `:url` to generate such.\nUseful for manipulating the URL data and passing it to\nURL helpers.","ref":"LightningWeb.Endpoint.html#struct_url/0"},{"type":"function","title":"LightningWeb.Endpoint.subscribe/2","doc":"","ref":"LightningWeb.Endpoint.html#subscribe/2"},{"type":"function","title":"LightningWeb.Endpoint.unsubscribe/1","doc":"","ref":"LightningWeb.Endpoint.html#unsubscribe/1"},{"type":"function","title":"LightningWeb.Endpoint.url/0","doc":"Generates the endpoint base URL without any path information.\n\nIt uses the configuration under `:url` to generate such.","ref":"LightningWeb.Endpoint.html#url/0"},{"type":"module","title":"LightningWeb.FallbackController","doc":"Translates controller action results into valid `Plug.Conn` responses.\n\nSee `Phoenix.Controller.action_fallback/1` for more details.","ref":"LightningWeb.FallbackController.html"},{"type":"module","title":"LightningWeb.FirstSetupLive.Superuser","doc":"Superuser setup liveview\n\nAllows the creation on the first user in the system.\n\nIt has only one action: `:show`","ref":"LightningWeb.FirstSetupLive.Superuser.html"},{"type":"function","title":"LightningWeb.FirstSetupLive.Superuser.render/1","doc":"","ref":"LightningWeb.FirstSetupLive.Superuser.html#render/1"},{"type":"module","title":"LightningWeb.FormHelpers","doc":"Conveniences for building forms.","ref":"LightningWeb.FormHelpers.html"},{"type":"module","title":"LightningWeb.Gettext","doc":"A module providing Internationalization with a gettext-based API.\n\nBy using [Gettext](https://hexdocs.pm/gettext),\nyour module gains a set of macros for translations, for example:\n\n import LightningWeb.Gettext\n\n # Simple translation\n gettext(\"Here is the string to translate\")\n\n # Plural translation\n ngettext(\"Here is the string to translate\",\n \"Here are the strings to translate\",\n 3)\n\n # Domain-based translation\n dgettext(\"errors\", \"Here is the error message to translate\")\n\nSee the [Gettext Docs](https://hexdocs.pm/gettext) for detailed usage.","ref":"LightningWeb.Gettext.html"},{"type":"macro","title":"LightningWeb.Gettext.dgettext/3","doc":"","ref":"LightningWeb.Gettext.html#dgettext/3"},{"type":"macro","title":"LightningWeb.Gettext.dgettext_noop/2","doc":"","ref":"LightningWeb.Gettext.html#dgettext_noop/2"},{"type":"macro","title":"LightningWeb.Gettext.dngettext/5","doc":"","ref":"LightningWeb.Gettext.html#dngettext/5"},{"type":"macro","title":"LightningWeb.Gettext.dngettext_noop/3","doc":"","ref":"LightningWeb.Gettext.html#dngettext_noop/3"},{"type":"macro","title":"LightningWeb.Gettext.dpgettext/4","doc":"","ref":"LightningWeb.Gettext.html#dpgettext/4"},{"type":"macro","title":"LightningWeb.Gettext.dpgettext_noop/3","doc":"","ref":"LightningWeb.Gettext.html#dpgettext_noop/3"},{"type":"macro","title":"LightningWeb.Gettext.dpngettext/6","doc":"","ref":"LightningWeb.Gettext.html#dpngettext/6"},{"type":"macro","title":"LightningWeb.Gettext.dpngettext_noop/4","doc":"","ref":"LightningWeb.Gettext.html#dpngettext_noop/4"},{"type":"macro","title":"LightningWeb.Gettext.gettext/2","doc":"","ref":"LightningWeb.Gettext.html#gettext/2"},{"type":"macro","title":"LightningWeb.Gettext.gettext_comment/1","doc":"","ref":"LightningWeb.Gettext.html#gettext_comment/1"},{"type":"macro","title":"LightningWeb.Gettext.gettext_noop/1","doc":"","ref":"LightningWeb.Gettext.html#gettext_noop/1"},{"type":"function","title":"LightningWeb.Gettext.handle_missing_bindings/2","doc":"","ref":"LightningWeb.Gettext.html#handle_missing_bindings/2"},{"type":"function","title":"LightningWeb.Gettext.handle_missing_plural_translation/7","doc":"","ref":"LightningWeb.Gettext.html#handle_missing_plural_translation/7"},{"type":"function","title":"LightningWeb.Gettext.handle_missing_translation/5","doc":"","ref":"LightningWeb.Gettext.html#handle_missing_translation/5"},{"type":"function","title":"LightningWeb.Gettext.lgettext/5","doc":"","ref":"LightningWeb.Gettext.html#lgettext/5"},{"type":"function","title":"LightningWeb.Gettext.lngettext/7","doc":"","ref":"LightningWeb.Gettext.html#lngettext/7"},{"type":"macro","title":"LightningWeb.Gettext.ngettext/4","doc":"","ref":"LightningWeb.Gettext.html#ngettext/4"},{"type":"macro","title":"LightningWeb.Gettext.ngettext_noop/2","doc":"","ref":"LightningWeb.Gettext.html#ngettext_noop/2"},{"type":"macro","title":"LightningWeb.Gettext.pgettext/3","doc":"","ref":"LightningWeb.Gettext.html#pgettext/3"},{"type":"macro","title":"LightningWeb.Gettext.pgettext_noop/2","doc":"","ref":"LightningWeb.Gettext.html#pgettext_noop/2"},{"type":"macro","title":"LightningWeb.Gettext.pngettext/5","doc":"","ref":"LightningWeb.Gettext.html#pngettext/5"},{"type":"macro","title":"LightningWeb.Gettext.pngettext_noop/3","doc":"","ref":"LightningWeb.Gettext.html#pngettext_noop/3"},{"type":"module","title":"LightningWeb.HealthCheck","doc":"","ref":"LightningWeb.HealthCheck.html"},{"type":"function","title":"LightningWeb.HealthCheck.call/2","doc":"","ref":"LightningWeb.HealthCheck.html#call/2"},{"type":"function","title":"LightningWeb.HealthCheck.init/1","doc":"","ref":"LightningWeb.HealthCheck.html#init/1"},{"type":"module","title":"LightningWeb.Hooks","doc":"LiveView Hooks","ref":"LightningWeb.Hooks.html"},{"type":"function","title":"LightningWeb.Hooks.on_mount/4","doc":"Finds and assigns a project to the socket, if a user doesn't have access\nthey are redirected and shown a 'No Access' screen via a `:nav` flash message.\n\nThere is a fallthru function, when there is no `project_id` in the params -\nthis is for liveviews that may or may not have a `project_id` depending on\nusage - like `DashboardLive`.","ref":"LightningWeb.Hooks.html#on_mount/4"},{"type":"module","title":"LightningWeb.InitAssigns","doc":"Ensures common `assigns` are applied to all LiveViews attaching this hook.","ref":"LightningWeb.InitAssigns.html"},{"type":"function","title":"LightningWeb.InitAssigns.on_mount/4","doc":"","ref":"LightningWeb.InitAssigns.html#on_mount/4"},{"type":"module","title":"LightningWeb.JobLive.AdaptorPicker","doc":"Component allowing selecting an adaptor and it's version","ref":"LightningWeb.JobLive.AdaptorPicker.html"},{"type":"function","title":"LightningWeb.JobLive.AdaptorPicker.display_name_for_adaptor/1","doc":"Converts standard adaptor names into \"label\",\"value\" lists and returns\nnon-standard names as merely \"value\"; both can be passed directly into a\nselect option list.","ref":"LightningWeb.JobLive.AdaptorPicker.html#display_name_for_adaptor/1"},{"type":"function","title":"LightningWeb.JobLive.AdaptorPicker.get_adaptor_version_options/1","doc":"","ref":"LightningWeb.JobLive.AdaptorPicker.html#get_adaptor_version_options/1"},{"type":"function","title":"LightningWeb.JobLive.AdaptorPicker.render/1","doc":"","ref":"LightningWeb.JobLive.AdaptorPicker.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.AdaptorPicker.render/1","doc":"* `form` (`:map`) (required)\n* `on_change` (`:any`) - Defaults to `nil`.\n* `disabled` (`:boolean`) - Defaults to `false`.","ref":"LightningWeb.JobLive.AdaptorPicker.html#render/1-attributes"},{"type":"module","title":"LightningWeb.JobLive.CredentialPicker","doc":"Component allowing selecting a credential or creating a new one via a\nmodal.","ref":"LightningWeb.JobLive.CredentialPicker.html"},{"type":"function","title":"LightningWeb.JobLive.CredentialPicker.render/1","doc":"","ref":"LightningWeb.JobLive.CredentialPicker.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.CredentialPicker.render/1","doc":"* `form` (`:map`) (required)\n* `disabled` (`:boolean`) - Defaults to `false`.\n* `credentials` (`:list`) (required)\n* `on_change` (`:any`) - Defaults to `nil`.","ref":"LightningWeb.JobLive.CredentialPicker.html#render/1-attributes"},{"type":"module","title":"LightningWeb.JobLive.CronSetupComponent","doc":"A live component for managing cron setup in a form.\n\nThe `CronSetupComponent` provides an interactive form for configuring cron settings. It includes fields for specifying the frequency, minute, hour, weekday, monthday, and cron expression.","ref":"LightningWeb.JobLive.CronSetupComponent.html"},{"type":"module","title":"Usage - LightningWeb.JobLive.CronSetupComponent","doc":"1. Include the `CronSetupComponent` in your live view or template.\n2. Pass the necessary assigns to the component, such as `form`, `on_change`, and `disabled`.\n3. Handle the `cron_expression_change` event to capture changes in the form inputs.\n4. Use the updated `cron_expression` in your application logic.","ref":"LightningWeb.JobLive.CronSetupComponent.html#module-usage"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.build_cron_expression/2","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#build_cron_expression/2"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.frequency_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#frequency_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.get_cron_data/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#get_cron_data/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.hour_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#hour_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.minute_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#minute_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.monthday_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#monthday_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.render/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.CronSetupComponent.render/1","doc":"* `id` (`:string`) (required)\n* `form` (`:map`) (required)\n* `on_change` (`:any`) (required)\n* `disabled` (`:boolean`) (required)","ref":"LightningWeb.JobLive.CronSetupComponent.html#render/1-attributes"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.time_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#time_field/1"},{"type":"function","title":"LightningWeb.JobLive.CronSetupComponent.weekday_field/1","doc":"","ref":"LightningWeb.JobLive.CronSetupComponent.html#weekday_field/1"},{"type":"module","title":"LightningWeb.JobLive.JobBuilderComponents","doc":"","ref":"LightningWeb.JobLive.JobBuilderComponents.html"},{"type":"function","title":"LightningWeb.JobLive.JobBuilderComponents.job_editor_component/1","doc":"","ref":"LightningWeb.JobLive.JobBuilderComponents.html#job_editor_component/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.JobBuilderComponents.job_editor_component/1","doc":"* `adaptor` (`:string`) (required)\n* `change_event` (`:string`) - Defaults to `\"job_body_changed\"`.\n* `disabled` (`:boolean`) - Defaults to `false`.\n* `disabled_message` (`:string`) (required)\n* `job_id` (`:string`) (required)\n* `source` (`:string`) (required)\n* Global attributes are accepted.","ref":"LightningWeb.JobLive.JobBuilderComponents.html#job_editor_component/1-attributes"},{"type":"module","title":"LightningWeb.JobLive.KafkaSetupComponent","doc":"","ref":"LightningWeb.JobLive.KafkaSetupComponent.html"},{"type":"function","title":"LightningWeb.JobLive.KafkaSetupComponent.render/1","doc":"","ref":"LightningWeb.JobLive.KafkaSetupComponent.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.JobLive.KafkaSetupComponent.render/1","doc":"* `id` (`:string`) (required)\n* `form` (`:map`) (required)\n* `disabled` (`:boolean`) (required)","ref":"LightningWeb.JobLive.KafkaSetupComponent.html#render/1-attributes"},{"type":"module","title":"LightningWeb.LiveHelpers","doc":"General purpose LiveView helper functions","ref":"LightningWeb.LiveHelpers.html"},{"type":"function","title":"LightningWeb.LiveHelpers.check_limits/2","doc":"","ref":"LightningWeb.LiveHelpers.html#check_limits/2"},{"type":"function","title":"LightningWeb.LiveHelpers.display_short_uuid/1","doc":"","ref":"LightningWeb.LiveHelpers.html#display_short_uuid/1"},{"type":"function","title":"LightningWeb.LiveHelpers.fade_in/1","doc":"","ref":"LightningWeb.LiveHelpers.html#fade_in/1"},{"type":"function","title":"LightningWeb.LiveHelpers.fade_out/1","doc":"","ref":"LightningWeb.LiveHelpers.html#fade_out/1"},{"type":"function","title":"LightningWeb.LiveHelpers.live_error_block/1","doc":"","ref":"LightningWeb.LiveHelpers.html#live_error_block/1"},{"type":"function","title":"Attributes - LightningWeb.LiveHelpers.live_error_block/1","doc":"* `flash` (`:map`) (required)\n* `myself` (`:string`) - Defaults to `nil`.","ref":"LightningWeb.LiveHelpers.html#live_error_block/1-attributes"},{"type":"function","title":"LightningWeb.LiveHelpers.live_info_block/1","doc":"","ref":"LightningWeb.LiveHelpers.html#live_info_block/1"},{"type":"function","title":"Attributes - LightningWeb.LiveHelpers.live_info_block/1","doc":"* `flash` (`:map`) (required)\n* `myself` (`:string`) - Defaults to `nil`.","ref":"LightningWeb.LiveHelpers.html#live_info_block/1-attributes"},{"type":"function","title":"LightningWeb.LiveHelpers.live_nav_block/1","doc":"","ref":"LightningWeb.LiveHelpers.html#live_nav_block/1"},{"type":"function","title":"Attributes - LightningWeb.LiveHelpers.live_nav_block/1","doc":"* `flash` (`:map`) (required)","ref":"LightningWeb.LiveHelpers.html#live_nav_block/1-attributes"},{"type":"function","title":"Slots - LightningWeb.LiveHelpers.live_nav_block/1","doc":"* `inner_block`","ref":"LightningWeb.LiveHelpers.html#live_nav_block/1-slots"},{"type":"function","title":"LightningWeb.LiveHelpers.upcase_first/1","doc":"","ref":"LightningWeb.LiveHelpers.html#upcase_first/1"},{"type":"module","title":"LightningWeb.ModalPortal","doc":"Component for rendering content inside layout without full DOM patch.","ref":"LightningWeb.ModalPortal.html"},{"type":"function","title":"LightningWeb.ModalPortal.close_modal/0","doc":"","ref":"LightningWeb.ModalPortal.html#close_modal/0"},{"type":"function","title":"LightningWeb.ModalPortal.handle_event/3","doc":"","ref":"LightningWeb.ModalPortal.html#handle_event/3"},{"type":"function","title":"LightningWeb.ModalPortal.on_hide/2","doc":"","ref":"LightningWeb.ModalPortal.html#on_hide/2"},{"type":"function","title":"LightningWeb.ModalPortal.on_show/2","doc":"","ref":"LightningWeb.ModalPortal.html#on_show/2"},{"type":"function","title":"LightningWeb.ModalPortal.open_modal/2","doc":"","ref":"LightningWeb.ModalPortal.html#open_modal/2"},{"type":"function","title":"LightningWeb.ModalPortal.render/1","doc":"","ref":"LightningWeb.ModalPortal.html#render/1"},{"type":"function","title":"LightningWeb.ModalPortal.update/2","doc":"","ref":"LightningWeb.ModalPortal.html#update/2"},{"type":"module","title":"LightningWeb.OauthController","doc":"","ref":"LightningWeb.OauthController.html"},{"type":"function","title":"LightningWeb.OauthController.new/2","doc":"","ref":"LightningWeb.OauthController.html#new/2"},{"type":"module","title":"LightningWeb.OauthCredentialHelper","doc":"A set of helper functions to encodes state and coordinate OAuth callbacks\nback to a LiveView component.","ref":"LightningWeb.OauthCredentialHelper.html"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.broadcast/2","doc":"","ref":"LightningWeb.OauthCredentialHelper.html#broadcast/2"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.broadcast_forward/3","doc":"Broadcast a message specifically for forwarding a message to a component.\nIt expects a `subscription_id`, the module of the component and `opts`\nbeing a keyword list containing an `:id` key of the specific component.\n\nSee: `Phoenix.LiveView.send_update/3` for more info.\n\nA corresponding LiveView (that is subscribed) is expected to have a matching\n`handle_info/2` that looks like this:\n\n```\ndef handle_info({:forward, mod, opts}, socket) do\n send_update(mod, opts)\n {:noreply, socket}\nend\n```","ref":"LightningWeb.OauthCredentialHelper.html#broadcast_forward/3"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.build_state/3","doc":"Encode and encrypt the callback data which will be sent so a provider\nas the `state` key in the request.\n\nThe values are:\n\n- `subscription_id`\n The same ID used to subscribe.\n- The component module\n The LiveView component that is going to receive update\n- The component id\n The ID of the component","ref":"LightningWeb.OauthCredentialHelper.html#build_state/3"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.decode_state/1","doc":"","ref":"LightningWeb.OauthCredentialHelper.html#decode_state/1"},{"type":"function","title":"LightningWeb.OauthCredentialHelper.subscribe/1","doc":"Subscribe to the `oauth_credential` topic.\nIt expects the a unique ID for the topic, usually the LiveView's `socket.id`.","ref":"LightningWeb.OauthCredentialHelper.html#subscribe/1"},{"type":"module","title":"LightningWeb.OidcController","doc":"","ref":"LightningWeb.OidcController.html"},{"type":"function","title":"LightningWeb.OidcController.new/2","doc":"Once the user has completed the authorization flow from above, they are\nreturned here, and the authorization code is used to log them in.","ref":"LightningWeb.OidcController.html#new/2"},{"type":"function","title":"LightningWeb.OidcController.show/2","doc":"Given a known provider, redirect them to the authorize url on the provider","ref":"LightningWeb.OidcController.html#show/2"},{"type":"module","title":"LightningWeb.PageView","doc":"","ref":"LightningWeb.PageView.html"},{"type":"function","title":"LightningWeb.PageView.__resource__/0","doc":"The resource name, as an atom, for this view","ref":"LightningWeb.PageView.html#__resource__/0"},{"type":"function","title":"LightningWeb.PageView.render/2","doc":"Renders the given template locally.","ref":"LightningWeb.PageView.html#render/2"},{"type":"function","title":"LightningWeb.PageView.template_not_found/2","doc":"Callback invoked when no template is found.\nBy default it raises but can be customized\nto render a particular template.","ref":"LightningWeb.PageView.html#template_not_found/2"},{"type":"module","title":"LightningWeb.Pagination","doc":"Pagination Components\n\nThis has been extracted and adapted from `scrivener_html`.\nSee: https://github.com/mgwidmann/scrivener_html","ref":"LightningWeb.Pagination.html"},{"type":"function","title":"LightningWeb.Pagination.page_link/1","doc":"","ref":"LightningWeb.Pagination.html#page_link/1"},{"type":"function","title":"LightningWeb.Pagination.pagination_bar/1","doc":"","ref":"LightningWeb.Pagination.html#pagination_bar/1"},{"type":"function","title":"Attributes - LightningWeb.Pagination.pagination_bar/1","doc":"* `async_page` (`Phoenix.LiveView.AsyncResult`) - Defaults to `nil`.\n* `page` (`:map`) (required)\n* `url` (`:any`) (required)\n* `help_text` (`:string`) - Defaults to `nil`.","ref":"LightningWeb.Pagination.html#pagination_bar/1-attributes"},{"type":"function","title":"Slots - LightningWeb.Pagination.pagination_bar/1","doc":"* `action`","ref":"LightningWeb.Pagination.html#pagination_bar/1-slots"},{"type":"function","title":"LightningWeb.Pagination.raw_pagination_links/2","doc":"Returns the raw data in order to generate the proper HTML for pagination links. Data\nis returned in a `{text, page_number}` format where `text` is intended to be the text\nof the link and `page_number` is the page it should go to. Defaults are already supplied\nand they are as follows:\n [distance: 5, next: :next, previous: :previous, first: true, last: true, ellipsis: :ellipsis]\n`distance` must be a positive non-zero integer or an exception is raised. `next` and `previous` should be\nstrings but can be anything you want as long as it is truthy, falsey values will remove\nthem from the output. `first` and `last` are only booleans, and they just include/remove\ntheir respective link from output. An example of the data returned:\n iex> Scrivener.HTML.raw_pagination_links(%{total_pages: 10, page_number: 5})\n [{\"<<\", 4}, {1, 1}, {2, 2}, {3, 3}, {4, 4}, {5, 5}, {6, 6}, {7, 7}, {8, 8}, {9, 9}, {10, 10}, {\">>\", 6}]\n iex> Scrivener.HTML.raw_pagination_links(%{total_pages: 20, page_number: 10}, first: [\"←\"], last: [\"→\"])\n [{\"<<\", 9}, {[\"←\"], 1}, {:ellipsis, {:safe, \"…\"}}, {5, 5}, {6, 6},{7, 7}, {8, 8}, {9, 9}, {10, 10}, {11, 11}, {12, 12}, {13, 13}, {14, 14},{15, 15}, {:ellipsis, {:safe, \"…\"}}, {[\"→\"], 20}, {\">>\", 11}]\nSimply loop and pattern match over each item and transform it to your custom HTML.","ref":"LightningWeb.Pagination.html#raw_pagination_links/2"},{"type":"module","title":"LightningWeb.PlugConfigs","doc":"Dynamically initialize Plugs that don't accept dynamic configs in :prod ENV.","ref":"LightningWeb.PlugConfigs.html"},{"type":"function","title":"LightningWeb.PlugConfigs.plug_parsers/0","doc":"","ref":"LightningWeb.PlugConfigs.html#plug_parsers/0"},{"type":"module","title":"LightningWeb.Plugs.ApiAuth","doc":"Authenticates api calls based on JWT bearer token.","ref":"LightningWeb.Plugs.ApiAuth.html"},{"type":"module","title":"LightningWeb.Plugs.BlockRoutes","doc":"Plug to conditionally block specified routes based on configuration flags and custom messages.","ref":"LightningWeb.Plugs.BlockRoutes.html"},{"type":"module","title":"LightningWeb.Plugs.FirstSetup","doc":"Plug to redirect HTTP requests to `/first_setup` if there are no\nsuperusers in the system yet.","ref":"LightningWeb.Plugs.FirstSetup.html"},{"type":"module","title":"LightningWeb.Plugs.Redirect","doc":"A plug for redirecting requests to a specified URL.\n\nThis plug takes an option `:to` which specifies the target URL for the redirection.","ref":"LightningWeb.Plugs.Redirect.html"},{"type":"function","title":"LightningWeb.Plugs.Redirect.call/2","doc":"Redirects the connection to the specified URL.","ref":"LightningWeb.Plugs.Redirect.html#call/2"},{"type":"function","title":"Parameters - LightningWeb.Plugs.Redirect.call/2","doc":"- conn: The connection struct.\n - opts: A keyword list of options. Must include `:to` key specifying the target URL.","ref":"LightningWeb.Plugs.Redirect.html#call/2-parameters"},{"type":"function","title":"Examples - LightningWeb.Plugs.Redirect.call/2","doc":"iex> conn = %Plug.Conn{}\n iex> opts = [to: \"/new_path\"]\n iex> LightningWeb.Plugs.Redirect.call(conn, opts)\n %Plug.Conn{...}","ref":"LightningWeb.Plugs.Redirect.html#call/2-examples"},{"type":"function","title":"Raises - LightningWeb.Plugs.Redirect.call/2","doc":"`KeyError` if the `:to` key is not present in options.","ref":"LightningWeb.Plugs.Redirect.html#call/2-raises"},{"type":"function","title":"LightningWeb.Plugs.Redirect.init/1","doc":"Initializes the plug options.","ref":"LightningWeb.Plugs.Redirect.html#init/1"},{"type":"function","title":"Parameters - LightningWeb.Plugs.Redirect.init/1","doc":"- opts: A keyword list of options.","ref":"LightningWeb.Plugs.Redirect.html#init/1-parameters"},{"type":"function","title":"Returns - LightningWeb.Plugs.Redirect.init/1","doc":"The provided options are returned as they are.","ref":"LightningWeb.Plugs.Redirect.html#init/1-returns"},{"type":"function","title":"Examples - LightningWeb.Plugs.Redirect.init/1","doc":"iex> LightningWeb.Plugs.Redirect.init(to: \"/new_path\")\n [to: \"/new_path\"]","ref":"LightningWeb.Plugs.Redirect.html#init/1-examples"},{"type":"module","title":"LightningWeb.Plugs.WebhookAuth","doc":"A Plug to authenticate and authorize requests based on paths starting with '/i/'.\nIt verifies the presence of correct API keys or Basic Authentication credentials.","ref":"LightningWeb.Plugs.WebhookAuth.html"},{"type":"function","title":"LightningWeb.Plugs.WebhookAuth.call/2","doc":"Handles the incoming HTTP request and performs authentication and authorization checks\nbased on paths starting with `/i/`.","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2"},{"type":"function","title":"Details - LightningWeb.Plugs.WebhookAuth.call/2","doc":"This function is the entry point for the `WebhookAuth` plug. It first checks if\nthe request path starts with `/i/` to determine whether the request should be processed\nby this plug.\n\nIf the path matches, it then extracts the `webhook` part from the request path and\nruns to fetch the corresponding `trigger` using the `fetch_trigger` function.\n\nIf a valid `trigger` is found, the function proceeds to validate the authentication\nof the request using the `validate_auth` function.\n\nIn case the `trigger` is not found, or the path does not start with `/i/`, the function\nreturns a 404 Not Found response with a JSON error message indicating that the webhook\nis not found.","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-details"},{"type":"function","title":"Parameters - LightningWeb.Plugs.WebhookAuth.call/2","doc":"- `conn`: The connection struct representing the incoming HTTP request.\n- `_opts`: A set of options, not used in this function but is a mandatory parameter as per\n Plug specification.","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-parameters"},{"type":"function","title":"Returns - LightningWeb.Plugs.WebhookAuth.call/2","doc":"- A connection struct representing the outgoing response, which can be a successful\n response, an unauthorized response, or a not found response, based on the evaluation\n of the above-mentioned conditions.","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-returns"},{"type":"function","title":"Examples - LightningWeb.Plugs.WebhookAuth.call/2","doc":"Assuming a request with the path `/i/some_webhook`:","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-examples"},{"type":"function","title":"Webhook Found and Authenticated - LightningWeb.Plugs.WebhookAuth.call/2","doc":"iex> LightningWeb.Plugs.WebhookAuth.call(conn, [])\n %Plug.Conn{status: 200, ...}\n\n iex> LightningWeb.Plugs.WebhookAuth.call(conn, [])\n %Plug.Conn{status: 404, ...}","ref":"LightningWeb.Plugs.WebhookAuth.html#call/2-webhook-found-and-authenticated"},{"type":"function","title":"LightningWeb.Plugs.WebhookAuth.init/1","doc":"Initializes the options.","ref":"LightningWeb.Plugs.WebhookAuth.html#init/1"},{"type":"module","title":"LightningWeb.ProfileLive.Edit","doc":"LiveView for user profile page.","ref":"LightningWeb.ProfileLive.Edit.html"},{"type":"function","title":"LightningWeb.ProfileLive.Edit.render/1","doc":"","ref":"LightningWeb.ProfileLive.Edit.html#render/1"},{"type":"module","title":"LightningWeb.ProfileLive.FormComponent","doc":"Form component update profile email and password","ref":"LightningWeb.ProfileLive.FormComponent.html"},{"type":"function","title":"LightningWeb.ProfileLive.FormComponent.enum_options/2","doc":"","ref":"LightningWeb.ProfileLive.FormComponent.html#enum_options/2"},{"type":"function","title":"LightningWeb.ProfileLive.FormComponent.render/1","doc":"","ref":"LightningWeb.ProfileLive.FormComponent.html#render/1"},{"type":"module","title":"LightningWeb.ProfileLive.MfaComponent","doc":"Component to enable MFA on a User's account","ref":"LightningWeb.ProfileLive.MfaComponent.html"},{"type":"function","title":"LightningWeb.ProfileLive.MfaComponent.render/1","doc":"","ref":"LightningWeb.ProfileLive.MfaComponent.html#render/1"},{"type":"module","title":"LightningWeb.ProjectFileController","doc":"","ref":"LightningWeb.ProjectFileController.html"},{"type":"function","title":"LightningWeb.ProjectFileController.download/2","doc":"","ref":"LightningWeb.ProjectFileController.html#download/2"},{"type":"module","title":"LightningWeb.ProjectLive.Collaborators","doc":"This schema is used for building the changeset for adding new collaborators to a project.\nIt is mirroring the `Project -> ProjectUser` relationship.","ref":"LightningWeb.ProjectLive.Collaborators.html"},{"type":"function","title":"LightningWeb.ProjectLive.Collaborators.changeset/2","doc":"","ref":"LightningWeb.ProjectLive.Collaborators.html#changeset/2"},{"type":"function","title":"LightningWeb.ProjectLive.Collaborators.prepare_for_insertion/3","doc":"","ref":"LightningWeb.ProjectLive.Collaborators.html#prepare_for_insertion/3"},{"type":"module","title":"LightningWeb.ProjectLive.Collaborators.Collaborator","doc":"","ref":"LightningWeb.ProjectLive.Collaborators.Collaborator.html"},{"type":"module","title":"LightningWeb.ProjectLive.FormComponent","doc":"Form Component for working with a single Job\n\nA Job's `adaptor` field is a combination of the module name and the version.\nIt's formatted as an NPM style string.\n\nThe form allows the user to select a module by name and then it's version,\nwhile the version dropdown itself references `adaptor` directly.\n\nMeaning the `adaptor_name` dropdown and assigns value is not persisted.","ref":"LightningWeb.ProjectLive.FormComponent.html"},{"type":"function","title":"LightningWeb.ProjectLive.FormComponent.render/1","doc":"","ref":"LightningWeb.ProjectLive.FormComponent.html#render/1"},{"type":"module","title":"LightningWeb.ProjectLive.Index","doc":"LiveView for listing and managing Projects","ref":"LightningWeb.ProjectLive.Index.html"},{"type":"function","title":"LightningWeb.ProjectLive.Index.delete_action/1","doc":"","ref":"LightningWeb.ProjectLive.Index.html#delete_action/1"},{"type":"function","title":"LightningWeb.ProjectLive.Index.render/1","doc":"","ref":"LightningWeb.ProjectLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.ProjectLive.InvitedCollaborators","doc":"This schema is used for building the changeset for adding new collaborators to a project.\nIt is mirroring the `Project -> ProjectUser` relationship.","ref":"LightningWeb.ProjectLive.InvitedCollaborators.html"},{"type":"function","title":"LightningWeb.ProjectLive.InvitedCollaborators.changeset/2","doc":"","ref":"LightningWeb.ProjectLive.InvitedCollaborators.html#changeset/2"},{"type":"function","title":"LightningWeb.ProjectLive.InvitedCollaborators.validate_collaborators/2","doc":"","ref":"LightningWeb.ProjectLive.InvitedCollaborators.html#validate_collaborators/2"},{"type":"module","title":"LightningWeb.ProjectLive.InvitedCollaborators.InvitedCollaborator","doc":"","ref":"LightningWeb.ProjectLive.InvitedCollaborators.InvitedCollaborator.html"},{"type":"module","title":"LightningWeb.ProjectLive.MFARequired","doc":"Liveview for project access denied error messages","ref":"LightningWeb.ProjectLive.MFARequired.html"},{"type":"function","title":"LightningWeb.ProjectLive.MFARequired.on_mount/4","doc":"","ref":"LightningWeb.ProjectLive.MFARequired.html#on_mount/4"},{"type":"function","title":"LightningWeb.ProjectLive.MFARequired.render/1","doc":"","ref":"LightningWeb.ProjectLive.MFARequired.html#render/1"},{"type":"module","title":"LightningWeb.ProjectLive.Settings","doc":"Index Liveview for project settings","ref":"LightningWeb.ProjectLive.Settings.html"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.digest/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#digest/1"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.permissions_message/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#permissions_message/1"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.render/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#render/1"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.role/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#role/1"},{"type":"function","title":"LightningWeb.ProjectLive.Settings.user/1","doc":"","ref":"LightningWeb.ProjectLive.Settings.html#user/1"},{"type":"module","title":"LightningWeb.PromExPlugAuthorization","doc":"Implement custom authorization for PromEx metrics endpoint as per\nhttps://hexdocs.pm/prom_ex/1.1.1/PromEx.Plug.html","ref":"LightningWeb.PromExPlugAuthorization.html"},{"type":"module","title":"LightningWeb.ReAuthenticateLive.New","doc":"LiveView for re-authentication page.","ref":"LightningWeb.ReAuthenticateLive.New.html"},{"type":"function","title":"LightningWeb.ReAuthenticateLive.New.render/1","doc":"","ref":"LightningWeb.ReAuthenticateLive.New.html#render/1"},{"type":"module","title":"LightningWeb.RouteHelpers","doc":"Convenience functions for generating paths.","ref":"LightningWeb.RouteHelpers.html"},{"type":"function","title":"LightningWeb.RouteHelpers.oidc_callback_url/0","doc":"","ref":"LightningWeb.RouteHelpers.html#oidc_callback_url/0"},{"type":"function","title":"LightningWeb.RouteHelpers.project_dashboard_url/1","doc":"","ref":"LightningWeb.RouteHelpers.html#project_dashboard_url/1"},{"type":"module","title":"LightningWeb.Router","doc":"The router for Lightning.","ref":"LightningWeb.Router.html"},{"type":"function","title":"LightningWeb.Router.api/2","doc":"","ref":"LightningWeb.Router.html#api/2"},{"type":"function","title":"LightningWeb.Router.authenticated_api/2","doc":"","ref":"LightningWeb.Router.html#authenticated_api/2"},{"type":"function","title":"LightningWeb.Router.browser/2","doc":"","ref":"LightningWeb.Router.html#browser/2"},{"type":"function","title":"LightningWeb.Router.call/2","doc":"Callback invoked by Plug on every request.","ref":"LightningWeb.Router.html#call/2"},{"type":"function","title":"LightningWeb.Router.init/1","doc":"Callback required by Plug that initializes the router\nfor serving web requests.","ref":"LightningWeb.Router.html#init/1"},{"type":"function","title":"LightningWeb.Router.storybook_assets/2","doc":"","ref":"LightningWeb.Router.html#storybook_assets/2"},{"type":"function","title":"LightningWeb.Router.storybook_browser/2","doc":"","ref":"LightningWeb.Router.html#storybook_browser/2"},{"type":"module","title":"LightningWeb.RunChannel","doc":"Phoenix channel to interact with Runs.","ref":"LightningWeb.RunChannel.html"},{"type":"function","title":"LightningWeb.RunChannel.child_spec/1","doc":"","ref":"LightningWeb.RunChannel.html#child_spec/1"},{"type":"function","title":"LightningWeb.RunChannel.handle_in/3","doc":"For the time being, calls to `fetch:dataclip` will return dataclips that are\npreformatted for use as \"initial state\" in a run.\n\nThis means that the body of http requests will be nested inside a \"data\" key.\n\nThere is an open discussion on the community that may impact how we\nstore HTTP requests in the database as dataclips and how we send the body\nof those HTTP requests to the worker to use as initial state.","ref":"LightningWeb.RunChannel.html#handle_in/3"},{"type":"function","title":"LightningWeb.RunChannel.start_link/1","doc":"","ref":"LightningWeb.RunChannel.html#start_link/1"},{"type":"module","title":"LightningWeb.RunLive.ExportConfirmationModal","doc":"","ref":"LightningWeb.RunLive.ExportConfirmationModal.html"},{"type":"module","title":"LightningWeb.RunLive.Index","doc":"Index Liveview for Runs","ref":"LightningWeb.RunLive.Index.html"},{"type":"function","title":"LightningWeb.RunLive.Index.checked?/2","doc":"Takes a changeset used for querying workorders and checks to see if the given\nfilter is present in that changeset. Returns true or false.","ref":"LightningWeb.RunLive.Index.html#checked?/2"},{"type":"function","title":"LightningWeb.RunLive.Index.filters_changeset/1","doc":"Creates a changeset based on given parameters and the fixed workorder filter types.","ref":"LightningWeb.RunLive.Index.html#filters_changeset/1"},{"type":"function","title":"LightningWeb.RunLive.Index.handle_info/2","doc":"When a WorkOrderCreated event is detected, we first check to see if the new\nwork order is admissible on the page, given the current filters. If it is, we\nadd it to the top of the page. If not, nothing happens.","ref":"LightningWeb.RunLive.Index.html#handle_info/2"},{"type":"function","title":"LightningWeb.RunLive.Index.render/1","doc":"","ref":"LightningWeb.RunLive.Index.html#render/1"},{"type":"function","title":"LightningWeb.RunLive.Index.validate_bulk_rerun/2","doc":"","ref":"LightningWeb.RunLive.Index.html#validate_bulk_rerun/2"},{"type":"module","title":"LightningWeb.RunLive.RerunJobComponent","doc":"Rerun job component","ref":"LightningWeb.RunLive.RerunJobComponent.html"},{"type":"module","title":"LightningWeb.RunLive.RunViewerLive","doc":"","ref":"LightningWeb.RunLive.RunViewerLive.html"},{"type":"function","title":"LightningWeb.RunLive.RunViewerLive.apply_selected_step_id/2","doc":"","ref":"LightningWeb.RunLive.RunViewerLive.html#apply_selected_step_id/2"},{"type":"function","title":"LightningWeb.RunLive.RunViewerLive.handle_steps_change/1","doc":"","ref":"LightningWeb.RunLive.RunViewerLive.html#handle_steps_change/1"},{"type":"module","title":"LightningWeb.RunLive.Show","doc":"","ref":"LightningWeb.RunLive.Show.html"},{"type":"function","title":"LightningWeb.RunLive.Show.apply_selected_step_id/2","doc":"","ref":"LightningWeb.RunLive.Show.html#apply_selected_step_id/2"},{"type":"function","title":"LightningWeb.RunLive.Show.handle_steps_change/1","doc":"","ref":"LightningWeb.RunLive.Show.html#handle_steps_change/1"},{"type":"module","title":"LightningWeb.RunLive.Streaming","doc":"","ref":"LightningWeb.RunLive.Streaming.html"},{"type":"function","title":"LightningWeb.RunLive.Streaming.add_or_update_step/2","doc":"","ref":"LightningWeb.RunLive.Streaming.html#add_or_update_step/2"},{"type":"function","title":"LightningWeb.RunLive.Streaming.get_dataclip/2","doc":"","ref":"LightningWeb.RunLive.Streaming.html#get_dataclip/2"},{"type":"function","title":"LightningWeb.RunLive.Streaming.get_run_async/2","doc":"Starts an async process that will fetch the run with the given ID.","ref":"LightningWeb.RunLive.Streaming.html#get_run_async/2"},{"type":"function","title":"LightningWeb.RunLive.Streaming.maybe_load_input_dataclip/1","doc":"","ref":"LightningWeb.RunLive.Streaming.html#maybe_load_input_dataclip/1"},{"type":"function","title":"LightningWeb.RunLive.Streaming.maybe_load_output_dataclip/1","doc":"","ref":"LightningWeb.RunLive.Streaming.html#maybe_load_output_dataclip/1"},{"type":"function","title":"LightningWeb.RunLive.Streaming.sort_steps/1","doc":"","ref":"LightningWeb.RunLive.Streaming.html#sort_steps/1"},{"type":"function","title":"LightningWeb.RunLive.Streaming.unselect_step/1","doc":"","ref":"LightningWeb.RunLive.Streaming.html#unselect_step/1"},{"type":"module","title":"LightningWeb.RunLive.WorkOrderComponent","doc":"Work Order component","ref":"LightningWeb.RunLive.WorkOrderComponent.html"},{"type":"function","title":"LightningWeb.RunLive.WorkOrderComponent.render/1","doc":"","ref":"LightningWeb.RunLive.WorkOrderComponent.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.RunLive.WorkOrderComponent.render/1","doc":"* `show_details` (`:boolean`) - Defaults to `false`.\n* `show_prev_runs` (`:boolean`) - Defaults to `false`.\n* `entry_selected` (`:boolean`) - Defaults to `false`.","ref":"LightningWeb.RunLive.WorkOrderComponent.html#render/1-attributes"},{"type":"module","title":"LightningWeb.Telemetry","doc":"Assorted metrics to collect during runtime.\n\nSee https://hexdocs.pm/phoenix/telemetry.html","ref":"LightningWeb.Telemetry.html"},{"type":"function","title":"LightningWeb.Telemetry.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"LightningWeb.Telemetry.html#child_spec/1"},{"type":"function","title":"LightningWeb.Telemetry.metrics/0","doc":"","ref":"LightningWeb.Telemetry.html#metrics/0"},{"type":"function","title":"LightningWeb.Telemetry.start_link/1","doc":"","ref":"LightningWeb.Telemetry.html#start_link/1"},{"type":"function","title":"LightningWeb.Telemetry.with_span/3","doc":"Convenience function that wraps `:telemetry.span/3`.\n\nGiven a function with an arity of zero, it passes the `metadata` argument\nout with the result of the function.\n\nIf you need to control the `metadata`, pass in a function with an arity of\none. It will be called with the metadata provided and expects the result and\nthe updated metadata to be returned in a tuple.\n\nExample:\n\n with_span([:my, span], %{project_id: 123}, fn -> get_project(456) end)\n\nOr when you want to extend the metadata:\n\n with_span([:my, :span], %{user_id: 123}, fn _metadata ->\n project = get_project(456)\n {project, %{project_id: project.id}}\n end)","ref":"LightningWeb.Telemetry.html#with_span/3"},{"type":"module","title":"LightningWeb.TokensLive.Index","doc":"LiveView for listing and managing tokens","ref":"LightningWeb.TokensLive.Index.html"},{"type":"function","title":"LightningWeb.TokensLive.Index.render/1","doc":"","ref":"LightningWeb.TokensLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.UserAuth","doc":"The UserAuth controller.","ref":"LightningWeb.UserAuth.html"},{"type":"function","title":"LightningWeb.UserAuth.authenticate_bearer/2","doc":"","ref":"LightningWeb.UserAuth.html#authenticate_bearer/2"},{"type":"function","title":"LightningWeb.UserAuth.fetch_current_user/2","doc":"Authenticates the user by looking into the session\nand remember me token.","ref":"LightningWeb.UserAuth.html#fetch_current_user/2"},{"type":"function","title":"LightningWeb.UserAuth.get_bearer/1","doc":"","ref":"LightningWeb.UserAuth.html#get_bearer/1"},{"type":"function","title":"LightningWeb.UserAuth.log_in_user/2","doc":"Logs the user in by creating a new session token.","ref":"LightningWeb.UserAuth.html#log_in_user/2"},{"type":"function","title":"LightningWeb.UserAuth.log_out_user/1","doc":"Logs the user out.\n\nIt clears all session data for safety. See renew_session.","ref":"LightningWeb.UserAuth.html#log_out_user/1"},{"type":"function","title":"LightningWeb.UserAuth.mark_totp_pending/1","doc":"","ref":"LightningWeb.UserAuth.html#mark_totp_pending/1"},{"type":"function","title":"LightningWeb.UserAuth.new_session/2","doc":"Assigns the token to a new session.\n\nIt renews the session ID and clears the whole session\nto avoid fixation attacks. See the renew_session\nfunction to customize this behaviour.\n\nIt also sets a `:live_socket_id` key in the session,\nso LiveView sessions are identified and automatically\ndisconnected on log out. The line can be safely removed\nif you are not using LiveView.","ref":"LightningWeb.UserAuth.html#new_session/2"},{"type":"function","title":"LightningWeb.UserAuth.on_mount/4","doc":"Used for LiveView routes that require the user to be reauthenticated.","ref":"LightningWeb.UserAuth.html#on_mount/4"},{"type":"function","title":"LightningWeb.UserAuth.reauth_sudo_mode/2","doc":"Reauthenticate the user by using the sudo token","ref":"LightningWeb.UserAuth.html#reauth_sudo_mode/2"},{"type":"function","title":"LightningWeb.UserAuth.redirect_if_user_is_authenticated/2","doc":"Used for routes that require the user to not be authenticated.","ref":"LightningWeb.UserAuth.html#redirect_if_user_is_authenticated/2"},{"type":"function","title":"LightningWeb.UserAuth.redirect_with_return_to/2","doc":"Returns to or redirects to the dashboard and potentially set remember_me token.","ref":"LightningWeb.UserAuth.html#redirect_with_return_to/2"},{"type":"function","title":"LightningWeb.UserAuth.require_authenticated_api_resource/2","doc":"Used for API routes that require the resource to be authenticated.\nA resource can be a `User` or a `ProjectRepoConnection`","ref":"LightningWeb.UserAuth.html#require_authenticated_api_resource/2"},{"type":"function","title":"LightningWeb.UserAuth.require_authenticated_user/2","doc":"Used for routes that require the user to be authenticated.\n\nIf you want to enforce the user email is confirmed before\nthey use the application at all, here would be a good place.","ref":"LightningWeb.UserAuth.html#require_authenticated_user/2"},{"type":"function","title":"LightningWeb.UserAuth.require_sudo_user/2","doc":"Used for routes that require the user to be reauthenticated.","ref":"LightningWeb.UserAuth.html#require_sudo_user/2"},{"type":"function","title":"LightningWeb.UserAuth.require_superuser/2","doc":"Require that the user has the `superuser` role","ref":"LightningWeb.UserAuth.html#require_superuser/2"},{"type":"function","title":"LightningWeb.UserAuth.totp_pending?/1","doc":"","ref":"LightningWeb.UserAuth.html#totp_pending?/1"},{"type":"function","title":"LightningWeb.UserAuth.totp_validated/1","doc":"","ref":"LightningWeb.UserAuth.html#totp_validated/1"},{"type":"module","title":"LightningWeb.UserConfirmationController","doc":"","ref":"LightningWeb.UserConfirmationController.html"},{"type":"function","title":"LightningWeb.UserConfirmationController.confirm_email/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#confirm_email/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.create/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#create/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.edit/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#edit/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.new/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#new/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.send_email/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#send_email/2"},{"type":"function","title":"LightningWeb.UserConfirmationController.update/2","doc":"","ref":"LightningWeb.UserConfirmationController.html#update/2"},{"type":"module","title":"LightningWeb.UserLive.Edit","doc":"LiveView for editing a single job, which inturn uses `LightningWeb.JobLive.BigFormComponent`\nfor common functionality.","ref":"LightningWeb.UserLive.Edit.html"},{"type":"function","title":"LightningWeb.UserLive.Edit.render/1","doc":"","ref":"LightningWeb.UserLive.Edit.html#render/1"},{"type":"module","title":"LightningWeb.UserLive.FormComponent","doc":"Form component for creating and editing users","ref":"LightningWeb.UserLive.FormComponent.html"},{"type":"function","title":"LightningWeb.UserLive.FormComponent.render/1","doc":"","ref":"LightningWeb.UserLive.FormComponent.html#render/1"},{"type":"module","title":"LightningWeb.UserLive.Index","doc":"Index page for listing users","ref":"LightningWeb.UserLive.Index.html"},{"type":"function","title":"LightningWeb.UserLive.Index.delete_action/1","doc":"","ref":"LightningWeb.UserLive.Index.html#delete_action/1"},{"type":"function","title":"LightningWeb.UserLive.Index.render/1","doc":"","ref":"LightningWeb.UserLive.Index.html#render/1"},{"type":"module","title":"LightningWeb.UserRegistrationController","doc":"","ref":"LightningWeb.UserRegistrationController.html"},{"type":"function","title":"LightningWeb.UserRegistrationController.create/2","doc":"","ref":"LightningWeb.UserRegistrationController.html#create/2"},{"type":"function","title":"LightningWeb.UserRegistrationController.new/2","doc":"","ref":"LightningWeb.UserRegistrationController.html#new/2"},{"type":"module","title":"LightningWeb.UserResetPasswordController","doc":"","ref":"LightningWeb.UserResetPasswordController.html"},{"type":"function","title":"LightningWeb.UserResetPasswordController.create/2","doc":"","ref":"LightningWeb.UserResetPasswordController.html#create/2"},{"type":"function","title":"LightningWeb.UserResetPasswordController.edit/2","doc":"","ref":"LightningWeb.UserResetPasswordController.html#edit/2"},{"type":"function","title":"LightningWeb.UserResetPasswordController.new/2","doc":"","ref":"LightningWeb.UserResetPasswordController.html#new/2"},{"type":"function","title":"LightningWeb.UserResetPasswordController.update/2","doc":"","ref":"LightningWeb.UserResetPasswordController.html#update/2"},{"type":"module","title":"LightningWeb.UserSessionController","doc":"","ref":"LightningWeb.UserSessionController.html"},{"type":"function","title":"LightningWeb.UserSessionController.auth_handler_url/0","doc":"","ref":"LightningWeb.UserSessionController.html#auth_handler_url/0"},{"type":"function","title":"LightningWeb.UserSessionController.create/2","doc":"","ref":"LightningWeb.UserSessionController.html#create/2"},{"type":"function","title":"LightningWeb.UserSessionController.delete/2","doc":"","ref":"LightningWeb.UserSessionController.html#delete/2"},{"type":"function","title":"LightningWeb.UserSessionController.exchange_token/2","doc":"","ref":"LightningWeb.UserSessionController.html#exchange_token/2"},{"type":"function","title":"LightningWeb.UserSessionController.new/2","doc":"","ref":"LightningWeb.UserSessionController.html#new/2"},{"type":"module","title":"LightningWeb.UserTOTPController","doc":"","ref":"LightningWeb.UserTOTPController.html"},{"type":"function","title":"LightningWeb.UserTOTPController.create/2","doc":"","ref":"LightningWeb.UserTOTPController.html#create/2"},{"type":"function","title":"LightningWeb.UserTOTPController.new/2","doc":"","ref":"LightningWeb.UserTOTPController.html#new/2"},{"type":"module","title":"LightningWeb.Utils","doc":"Helper functions to deal with forms and query params.","ref":"LightningWeb.Utils.html"},{"type":"function","title":"LightningWeb.Utils.build_params_for_field/3","doc":"","ref":"LightningWeb.Utils.html#build_params_for_field/3"},{"type":"function","title":"LightningWeb.Utils.decode_one/2","doc":"","ref":"LightningWeb.Utils.html#decode_one/2"},{"type":"module","title":"LightningWeb.VersionControlController","doc":"","ref":"LightningWeb.VersionControlController.html"},{"type":"function","title":"LightningWeb.VersionControlController.index/2","doc":"","ref":"LightningWeb.VersionControlController.html#index/2"},{"type":"module","title":"LightningWeb.WebhooksController","doc":"","ref":"LightningWeb.WebhooksController.html"},{"type":"function","title":"LightningWeb.WebhooksController.check/2","doc":"","ref":"LightningWeb.WebhooksController.html#check/2"},{"type":"function","title":"LightningWeb.WebhooksController.create/2","doc":"","ref":"LightningWeb.WebhooksController.html#create/2"},{"type":"module","title":"LightningWeb.WorkerChannel","doc":"Websocket channel to handle when workers join or claim something to run.","ref":"LightningWeb.WorkerChannel.html"},{"type":"function","title":"LightningWeb.WorkerChannel.child_spec/1","doc":"","ref":"LightningWeb.WorkerChannel.html#child_spec/1"},{"type":"function","title":"LightningWeb.WorkerChannel.start_link/1","doc":"","ref":"LightningWeb.WorkerChannel.html#start_link/1"},{"type":"module","title":"LightningWeb.WorkerSocket","doc":"","ref":"LightningWeb.WorkerSocket.html"},{"type":"function","title":"LightningWeb.WorkerSocket.handle_error/2","doc":"","ref":"LightningWeb.WorkerSocket.html#handle_error/2"},{"type":"module","title":"LightningWeb.WorkflowLive.AiAssistantComponent","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.handle_async/3","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#handle_async/3"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.handle_event/3","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#handle_event/3"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.mount/1","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#mount/1"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.render/1","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#render/1"},{"type":"function","title":"LightningWeb.WorkflowLive.AiAssistantComponent.update/2","doc":"","ref":"LightningWeb.WorkflowLive.AiAssistantComponent.html#update/2"},{"type":"module","title":"LightningWeb.WorkflowLive.EditorPane","doc":"","ref":"LightningWeb.WorkflowLive.EditorPane.html"},{"type":"function","title":"LightningWeb.WorkflowLive.EditorPane.render/1","doc":"","ref":"LightningWeb.WorkflowLive.EditorPane.html#render/1"},{"type":"function","title":"Attributes - LightningWeb.WorkflowLive.EditorPane.render/1","doc":"* `id` (`:string`) (required)\n* `disabled` (`:boolean`) - Defaults to `false`.\n* `disabled_message` (`:string`) (required)\n* `class` (`:string`) - Defaults to `\"\"`.\n* `on_change` (`:any`) (required)\n* `adaptor` (`:string`) (required)\n* `source` (`:string`) (required)\n* `job_id` (`:string`) (required)","ref":"LightningWeb.WorkflowLive.EditorPane.html#render/1-attributes"},{"type":"module","title":"LightningWeb.WorkflowLive.Helpers","doc":"Helper functions for the Workflow LiveViews.","ref":"LightningWeb.WorkflowLive.Helpers.html"},{"type":"function","title":"LightningWeb.WorkflowLive.Helpers.broadcast_updated_params/2","doc":"","ref":"LightningWeb.WorkflowLive.Helpers.html#broadcast_updated_params/2"},{"type":"function","title":"LightningWeb.WorkflowLive.Helpers.run_workflow/3","doc":"","ref":"LightningWeb.WorkflowLive.Helpers.html#run_workflow/3"},{"type":"function","title":"LightningWeb.WorkflowLive.Helpers.save_workflow/1","doc":"","ref":"LightningWeb.WorkflowLive.Helpers.html#save_workflow/1"},{"type":"function","title":"LightningWeb.WorkflowLive.Helpers.subscribe_to_params_update/1","doc":"","ref":"LightningWeb.WorkflowLive.Helpers.html#subscribe_to_params_update/1"},{"type":"module","title":"LightningWeb.WorkflowLive.JobView","doc":"","ref":"LightningWeb.WorkflowLive.JobView.html"},{"type":"function","title":"LightningWeb.WorkflowLive.JobView.container/1","doc":"","ref":"LightningWeb.WorkflowLive.JobView.html#container/1"},{"type":"function","title":"Attributes - LightningWeb.WorkflowLive.JobView.container/1","doc":"* `id` (`:string`) (required)","ref":"LightningWeb.WorkflowLive.JobView.html#container/1-attributes"},{"type":"function","title":"Slots - LightningWeb.WorkflowLive.JobView.container/1","doc":"* `top`\n* `inner_block`\n* `bottom`\n* `column` - Accepts attributes:\n\n * `class` (`:string`) - Extra CSS classes for the column.","ref":"LightningWeb.WorkflowLive.JobView.html#container/1-slots"},{"type":"function","title":"LightningWeb.WorkflowLive.JobView.job_edit_view/1","doc":"","ref":"LightningWeb.WorkflowLive.JobView.html#job_edit_view/1"},{"type":"function","title":"Attributes - LightningWeb.WorkflowLive.JobView.job_edit_view/1","doc":"* `job` (`:map`) (required)\n* `form` (`:map`) (required) - A form built from a job.\n* `current_user` (`:map`) (required)\n* `project` (`:map`) (required)\n* `close_url` (`:any`) (required)\n* `socket` (`:any`) (required)\n* `follow_run_id` (`:any`) - Defaults to `nil`.\n* `snapshot` (`:any`) (required)\n* `snapshot_version` (`:any`) (required)\n* `display_banner` (`:boolean`) - Defaults to `false`.\n* `banner_message` (`:string`) - Defaults to `\"\"`.\n* `presences` (`:list`) (required)\n* `prior_user_presence` (`:any`) (required)","ref":"LightningWeb.WorkflowLive.JobView.html#job_edit_view/1-attributes"},{"type":"function","title":"Slots - LightningWeb.WorkflowLive.JobView.job_edit_view/1","doc":"* `footer`\n* `collapsible_panel` - Accepts attributes:\n\n * `id` (`:string`) (required)\n * `panel_title` (`:string`) (required)\n * `class` (`:string`) - Extra CSS classes for the column.","ref":"LightningWeb.WorkflowLive.JobView.html#job_edit_view/1-slots"},{"type":"module","title":"LightningWeb.WorkflowLive.NewWorkflowForm","doc":"","ref":"LightningWeb.WorkflowLive.NewWorkflowForm.html"},{"type":"function","title":"LightningWeb.WorkflowLive.NewWorkflowForm.validate/2","doc":"","ref":"LightningWeb.WorkflowLive.NewWorkflowForm.html#validate/2"},{"type":"function","title":"LightningWeb.WorkflowLive.NewWorkflowForm.validate_for_save/1","doc":"","ref":"LightningWeb.WorkflowLive.NewWorkflowForm.html#validate_for_save/1"},{"type":"module","title":"LightningWeb.WorkflowNewLive.WorkflowParams","doc":"Various function for reconciling changes to a workflow params map.\n\nThe front end editor uses JSON patches to represent changes to the workflow.","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html"},{"type":"function","title":"LightningWeb.WorkflowNewLive.WorkflowParams.apply_form_params/2","doc":"Produce a new set of params by applying the given form params to the current\nparams.","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html#apply_form_params/2"},{"type":"function","title":"LightningWeb.WorkflowNewLive.WorkflowParams.apply_patches/2","doc":"Produce a new set of params by applying the given patches to the current parms","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html#apply_patches/2"},{"type":"function","title":"LightningWeb.WorkflowNewLive.WorkflowParams.to_map/1","doc":"Convert a changeset to a serializable map of workflow params, suitable for\nsending to the front end editor.\n\nIt uses `Lightning.Helpers.json_safe/1` to ensure that the map is safe to\nserialize to JSON. This is necessary because the underlying model may\ncontain atom values.","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html#to_map/1"},{"type":"function","title":"LightningWeb.WorkflowNewLive.WorkflowParams.to_patches/2","doc":"Produce a set of patches that represent the difference between the initial\nparams and the target params.\n\nThis usually is used to produce a set of patches that represent the changes\nintroduced by a changeset.","ref":"LightningWeb.WorkflowNewLive.WorkflowParams.html#to_patches/2"},{"type":"module","title":"Lightning.API","doc":"Behaviour for implementing the Lightning interface.\n\nThis behaviour is used to mock specific functions in tests.","ref":"Lightning.API.html"},{"type":"module","title":"Lightning.AdaptorRegistry","doc":"Registry process to query and maintain a list of adaptors available for\nwriting jobs.\n\nCurrently it queries NPM for all modules in the `@openfn` organization and\nfilters out modules that are known not to be adaptors.\n\n**Usage**\n\n```\n# Starting the process\nAdaptorRegistry.start_link()\n# Getting a list of all adaptors\nLightning.AdaptorRegistry.AdaptorRegistry.all()\n```\n\n**Caching**\n\nBy default the results are cached to disk, and will be reused every start.\n\nIn order to disable or configure caching pass see: `start_link/1`.\n\nThe process uses `:continue` to return before the adaptors have been queried.\nThis does mean that the first call to the process will be delayed until\nthe `handle_continue/2` has finished.\n\n**Timeouts**\n\nThere is a 'general' timeout of 30s, this is used for GenServer calls like\n`all/1` and also internally when the modules are being queried. NPM can\nbe extremely fast to respond if the package is cached on their side, but\ncan take a couple of seconds if not cached.","ref":"Lightning.AdaptorRegistry.html"},{"type":"function","title":"Lightning.AdaptorRegistry.all/1","doc":"Get the current in-process list of adaptors.\nThis call will wait behind the `:continue` message when the process starts\nup, so it may take a while the first time it is called (and the list hasn't\nbeen fetched yet).","ref":"Lightning.AdaptorRegistry.html#all/1"},{"type":"function","title":"Lightning.AdaptorRegistry.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.AdaptorRegistry.html#child_spec/1"},{"type":"function","title":"Lightning.AdaptorRegistry.fetch/0","doc":"Fetch a list of packages for the @openfn organisation","ref":"Lightning.AdaptorRegistry.html#fetch/0"},{"type":"function","title":"Lightning.AdaptorRegistry.latest_for/2","doc":"Get a latest version for a given module.","ref":"Lightning.AdaptorRegistry.html#latest_for/2"},{"type":"function","title":"Lightning.AdaptorRegistry.resolve_adaptor/1","doc":"","ref":"Lightning.AdaptorRegistry.html#resolve_adaptor/1"},{"type":"function","title":"Lightning.AdaptorRegistry.resolve_package_name/1","doc":"Destructures an NPM style package name into module name and version.\n\n**Example**\n\n iex> resolve_package_name(\"@openfn/language-salesforce@1.2.3\")\n { \"@openfn/language-salesforce\", \"1.2.3\" }\n iex> resolve_package_name(\"@openfn/language-salesforce\")\n { \"@openfn/language-salesforce\", nil }","ref":"Lightning.AdaptorRegistry.html#resolve_package_name/1"},{"type":"function","title":"Lightning.AdaptorRegistry.resolve_package_name!/1","doc":"Same as `resolve_package_name/1` except will throw an exception if a package\nname cannot be matched.","ref":"Lightning.AdaptorRegistry.html#resolve_package_name!/1"},{"type":"function","title":"Lightning.AdaptorRegistry.start_link/1","doc":"Starts the AdaptorRegistry\n\n**Options**\n\n- `:use_cache` (defaults to false) - stores the last set of results on disk\n and uses the cached file for every subsequent start.\n It can either be a boolean, or a string - the latter being a file path\n to set where the cache file is located.\n- `:name` (defaults to AdaptorRegistry) - the name of the process, useful\n for testing and/or running multiple versions of the registry","ref":"Lightning.AdaptorRegistry.html#start_link/1"},{"type":"function","title":"Lightning.AdaptorRegistry.versions_for/2","doc":"Get a list of versions for a given module.","ref":"Lightning.AdaptorRegistry.html#versions_for/2"},{"type":"module","title":"Lightning.AdaptorRegistry.Npm","doc":"NPM API functions","ref":"Lightning.AdaptorRegistry.Npm.html"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.delete/3","doc":"Issues a DELETE request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#delete/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.delete!/3","doc":"Issues a DELETE request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#delete!/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.get/3","doc":"Issues a GET request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#get/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.get!/3","doc":"Issues a GET request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#get!/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.head/3","doc":"Issues a HEAD request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#head/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.head!/3","doc":"Issues a HEAD request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#head!/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.options/3","doc":"Issues an OPTIONS request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#options/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.options!/3","doc":"Issues a OPTIONS request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#options!/3"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.package_detail/1","doc":"Retrieve all details for an NPM package","ref":"Lightning.AdaptorRegistry.Npm.html#package_detail/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.patch/4","doc":"Issues a PATCH request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#patch/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.patch!/4","doc":"Issues a PATCH request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#patch!/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.post/4","doc":"Issues a POST request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#post/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.post!/4","doc":"Issues a POST request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#post!/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_headers/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_headers/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_request_body/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_request_body/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_request_headers/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_request_headers/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_request_options/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_request_options/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_request_params/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_request_params/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_response/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_response/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_response_chunk/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_response_chunk/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_response_headers/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_response_headers/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_response_status_code/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_response_status_code/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_status_code/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_status_code/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.process_url/1","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#process_url/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.put/4","doc":"Issues a PUT request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#put/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.put!/4","doc":"Issues a PUT request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#put!/4"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.request/1","doc":"Issues an HTTP request using an `HTTPoison.Request` struct.\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Lightning.AdaptorRegistry.Npm.html#request/1"},{"type":"function","title":"Redirect handling - Lightning.AdaptorRegistry.Npm.request/1","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Lightning.AdaptorRegistry.Npm.html#request/1-redirect-handling"},{"type":"function","title":"Examples - Lightning.AdaptorRegistry.Npm.request/1","doc":"request = %HTTPoison.Request{\n method: :post,\n url: \"https://my.website.com\",\n body: \"{\\\"foo\\\": 3}\",\n headers: [{\"Accept\", \"application/json\"}]\n }\n\n request(request)","ref":"Lightning.AdaptorRegistry.Npm.html#request/1-examples"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.request/5","doc":"Issues an HTTP request with the given method to the given url.\n\nThis function is usually used indirectly by `get/3`, `post/4`, `put/4`, etc\n\nArgs:\n * `method` - HTTP method as an atom (`:get`, `:head`, `:post`, `:put`,\n `:delete`, etc.)\n * `url` - target url as a binary string or char list\n * `body` - request body. See more below\n * `headers` - HTTP headers as an orddict (e.g., `[{\"Accept\", \"application/json\"}]`)\n * `options` - Keyword list of options\n\nBody: see type `HTTPoison.Request`\n\nOptions: see type `HTTPoison.Request`\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Lightning.AdaptorRegistry.Npm.html#request/5"},{"type":"function","title":"Redirect handling - Lightning.AdaptorRegistry.Npm.request/5","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Lightning.AdaptorRegistry.Npm.html#request/5-redirect-handling"},{"type":"function","title":"Examples - Lightning.AdaptorRegistry.Npm.request/5","doc":"request(:post, \"https://my.website.com\", \"{\\\"foo\\\": 3}\", [{\"Accept\", \"application/json\"}])","ref":"Lightning.AdaptorRegistry.Npm.html#request/5-examples"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.request!/1","doc":"Issues an HTTP request an `HTTPoison.Request` struct.\nexception in case of failure.\n\n`request!/1` works exactly like `request/1` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Lightning.AdaptorRegistry.Npm.html#request!/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.request!/5","doc":"Issues an HTTP request with the given method to the given url, raising an\nexception in case of failure.\n\n`request!/5` works exactly like `request/5` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Lightning.AdaptorRegistry.Npm.html#request!/5"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.start/0","doc":"Starts HTTPoison and its dependencies.","ref":"Lightning.AdaptorRegistry.Npm.html#start/0"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.stream_next/1","doc":"Requests the next message to be streamed for a given `HTTPoison.AsyncResponse`.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AdaptorRegistry.Npm.html#stream_next/1"},{"type":"function","title":"Lightning.AdaptorRegistry.Npm.user_packages/1","doc":"Retrieve all packages for a given user or organization. Return empty list if\napplication cannot connect to NPM. (E.g., because it's started offline.)","ref":"Lightning.AdaptorRegistry.Npm.html#user_packages/1"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.body/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:body/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.headers/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:headers/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.method/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:method/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.options/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:options/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.params/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:params/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.request/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:request/0"},{"type":"type","title":"Lightning.AdaptorRegistry.Npm.url/0","doc":"","ref":"Lightning.AdaptorRegistry.Npm.html#t:url/0"},{"type":"module","title":"Lightning.AdaptorService","doc":"The Adaptor Service is use to query and install adaptors in order to run jobs.\n\nOn startup, it queries the filesystem for `package.json` files and builds up\na list of available adaptors.","ref":"Lightning.AdaptorService.html"},{"type":"module","title":"Configuration - Lightning.AdaptorService","doc":"The service requires at least `:adaptors_path`, which is used to both query\nwhich adaptors are installed and when to install new adaptors.\n\nAnother optional setting is: `:repo`, which must point at a module that will be\nused to do the querying and installing.","ref":"Lightning.AdaptorService.html#module-configuration"},{"type":"module","title":"Installing Adaptors - Lightning.AdaptorService","doc":"Using the `install/2` function an adaptor can be installed, which will also\nadd it to the list of available adaptors.\n\nThe adaptor is marked as `:installing`, to allow for conditional behaviour\nelsewhere such as delaying or rejecting processing until the adaptor becomes\navailable.","ref":"Lightning.AdaptorService.html#module-installing-adaptors"},{"type":"module","title":"Looking up adaptors - Lightning.AdaptorService","doc":"The module leans on Elixir's built-in `Version` module to provide version\nlookups.\n\nWhen looking up an adaptor, either a string or a tuple can be used.\nIn the case of requesting the latest version, any one of these will return\nthe latest version the service is aware of.\n\n- `@openfn/language-http`\n- `@openfn/language-http@latest`\n- `{\"@openfn/language-http\", nil}`\n- `{\"@openfn/language-http\", \"latest\"}`\n- `{~r/language-http/, \"latest\"}`\n\nYou can also request a specific version, or use a range specification:\n\n- `@openfn/language-http@1.2.3`\n- `{\"@openfn/language-http\", \"~> 1.2.0\"}`\n- `{\"@openfn/language-http\", \"< 2.0.0\"}`\n\n> **NOTE**\n> More complex npm style install strings like: `\">=0.1.0 <0.2.0\"`\n> are not supported.\n> Generally the tuple style is preferred when using range specifications as\n> the npm style strings have a simplistic regex splitter.\n\nSee [Version](https://hexdocs.pm/elixir/Version.html) for more details on\nmatching versions.","ref":"Lightning.AdaptorService.html#module-looking-up-adaptors"},{"type":"function","title":"Lightning.AdaptorService.build_aliased_name/1","doc":"Turns a package name and version into a string for NPM.\n\nSince multiple versions of the same package can be installed, it's important\nto rely on npms built-in package aliasing.\n\nE.g. `@openfn/language-http@1.2.8` turns into:\n `@openfn/language-http-1.2.8@npm:@openfn/language-http@1.2.8`\n\nWhich is pretty long winded but necessary for the reason above.\n\nIf using this module as a base, it's likely you would need to adaptor this\nto suit your particular naming strategy.","ref":"Lightning.AdaptorService.html#build_aliased_name/1"},{"type":"function","title":"Lightning.AdaptorService.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.AdaptorService.html#child_spec/1"},{"type":"function","title":"Lightning.AdaptorService.find_adaptor/2","doc":"","ref":"Lightning.AdaptorService.html#find_adaptor/2"},{"type":"function","title":"Lightning.AdaptorService.get_adaptors/1","doc":"","ref":"Lightning.AdaptorService.html#get_adaptors/1"},{"type":"function","title":"Lightning.AdaptorService.install/2","doc":"","ref":"Lightning.AdaptorService.html#install/2"},{"type":"function","title":"Lightning.AdaptorService.install!/2","doc":"","ref":"Lightning.AdaptorService.html#install!/2"},{"type":"function","title":"Lightning.AdaptorService.installed?/2","doc":"","ref":"Lightning.AdaptorService.html#installed?/2"},{"type":"function","title":"Lightning.AdaptorService.resolve_package_name/1","doc":"","ref":"Lightning.AdaptorService.html#resolve_package_name/1"},{"type":"function","title":"Lightning.AdaptorService.start_link/1","doc":"","ref":"Lightning.AdaptorService.html#start_link/1"},{"type":"type","title":"Lightning.AdaptorService.package_spec/0","doc":"","ref":"Lightning.AdaptorService.html#t:package_spec/0"},{"type":"module","title":"Lightning.AiAssistant","doc":"The AI assistant module.","ref":"Lightning.AiAssistant.html"},{"type":"function","title":"Lightning.AiAssistant.available?/1","doc":"","ref":"Lightning.AiAssistant.html#available?/1"},{"type":"function","title":"Lightning.AiAssistant.create_session/3","doc":"","ref":"Lightning.AiAssistant.html#create_session/3"},{"type":"function","title":"Lightning.AiAssistant.enabled?/0","doc":"Checks if the AI assistant is enabled.","ref":"Lightning.AiAssistant.html#enabled?/0"},{"type":"function","title":"Lightning.AiAssistant.endpoint_available?/0","doc":"Checks if the Apollo endpoint is available.","ref":"Lightning.AiAssistant.html#endpoint_available?/0"},{"type":"function","title":"Lightning.AiAssistant.get_session!/1","doc":"","ref":"Lightning.AiAssistant.html#get_session!/1"},{"type":"function","title":"Lightning.AiAssistant.list_sessions_for_job/1","doc":"","ref":"Lightning.AiAssistant.html#list_sessions_for_job/1"},{"type":"function","title":"Lightning.AiAssistant.project_has_any_session?/1","doc":"","ref":"Lightning.AiAssistant.html#project_has_any_session?/1"},{"type":"function","title":"Lightning.AiAssistant.put_expression_and_adaptor/3","doc":"","ref":"Lightning.AiAssistant.html#put_expression_and_adaptor/3"},{"type":"function","title":"Lightning.AiAssistant.query/2","doc":"Queries the AI assistant with the given content.\n\nReturns `{:ok, session}` if the query was successful, otherwise `:error`.\n\n**Example**\n\n iex> AiAssistant.query(session, \"fn()\")\n {:ok, session}","ref":"Lightning.AiAssistant.html#query/2"},{"type":"function","title":"Lightning.AiAssistant.save_message/2","doc":"","ref":"Lightning.AiAssistant.html#save_message/2"},{"type":"module","title":"Lightning.AiAssistant.Limiter","doc":"The AI assistant limiter to check for AI query quota.","ref":"Lightning.AiAssistant.Limiter.html"},{"type":"function","title":"Lightning.AiAssistant.Limiter.validate_quota/1","doc":"Checks if has not reached the limit of the project ai queries quota.","ref":"Lightning.AiAssistant.Limiter.html#validate_quota/1"},{"type":"module","title":"Lightning.ApolloClient","doc":"Client for communicating with the Apollo service.","ref":"Lightning.ApolloClient.html"},{"type":"function","title":"Lightning.ApolloClient.query/3","doc":"","ref":"Lightning.ApolloClient.html#query/3"},{"type":"function","title":"Lightning.ApolloClient.test/0","doc":"Checks if the Apollo endpoint is available.","ref":"Lightning.ApolloClient.html#test/0"},{"type":"type","title":"Lightning.ApolloClient.context/0","doc":"","ref":"Lightning.ApolloClient.html#t:context/0"},{"type":"module","title":"Lightning.Auditing","doc":"Context for working with Audit records.","ref":"Lightning.Auditing.html"},{"type":"function","title":"Lightning.Auditing.list_all/1","doc":"","ref":"Lightning.Auditing.html#list_all/1"},{"type":"behaviour","title":"Lightning.Auditing.Audit","doc":"Macro module to add common model behaviour to a given Ecto model","ref":"Lightning.Auditing.Audit.html"},{"type":"function","title":"Lightning.Auditing.Audit.event/7","doc":"Creates a `changeset` for the `event` identified by `item_id` and caused\nby `actor_id`.\n\nThe given `changes` can be either `nil`, `Ecto.Changeset`, struct or map.\n\nIt returns `:no_changes` in case of an `Ecto.Changeset` changes that changed nothing\nor an `Ecto.Changeset` with the event ready to be inserted.","ref":"Lightning.Auditing.Audit.html#event/7"},{"type":"function","title":"Lightning.Auditing.Audit.save/2","doc":"Saves the event to the `Repo`.\n\nIn case of nothing changes, do nothing.\n\nIt returns `{:ok, :no_changes}` if nothing changed, `{:ok, struct}` if the log\nhas been successfully saved or `{:error, changeset}` in case of error.","ref":"Lightning.Auditing.Audit.html#save/2"},{"type":"callback","title":"Lightning.Auditing.Audit.update_changes/1","doc":"Callback to update changes before saving to the database.","ref":"Lightning.Auditing.Audit.html#c:update_changes/1"},{"type":"module","title":"Lightning.AuthProviders","doc":"Context module for dealing with external Auth Providers.","ref":"Lightning.AuthProviders.html"},{"type":"function","title":"Lightning.AuthProviders.build_handler/2","doc":"","ref":"Lightning.AuthProviders.html#build_handler/2"},{"type":"function","title":"Lightning.AuthProviders.create/1","doc":"","ref":"Lightning.AuthProviders.html#create/1"},{"type":"function","title":"Lightning.AuthProviders.create_handler/1","doc":"","ref":"Lightning.AuthProviders.html#create_handler/1"},{"type":"function","title":"Lightning.AuthProviders.delete!/1","doc":"","ref":"Lightning.AuthProviders.html#delete!/1"},{"type":"function","title":"Lightning.AuthProviders.get_authorize_url/1","doc":"Retrieve the authorization url for a given handler or handler name.","ref":"Lightning.AuthProviders.html#get_authorize_url/1"},{"type":"function","title":"Lightning.AuthProviders.get_existing/0","doc":"","ref":"Lightning.AuthProviders.html#get_existing/0"},{"type":"function","title":"Lightning.AuthProviders.get_existing/1","doc":"","ref":"Lightning.AuthProviders.html#get_existing/1"},{"type":"function","title":"Lightning.AuthProviders.get_handler/1","doc":"","ref":"Lightning.AuthProviders.html#get_handler/1"},{"type":"function","title":"Lightning.AuthProviders.get_handlers/0","doc":"","ref":"Lightning.AuthProviders.html#get_handlers/0"},{"type":"function","title":"Lightning.AuthProviders.new/0","doc":"","ref":"Lightning.AuthProviders.html#new/0"},{"type":"function","title":"Lightning.AuthProviders.remove_handler/1","doc":"","ref":"Lightning.AuthProviders.html#remove_handler/1"},{"type":"function","title":"Lightning.AuthProviders.update/2","doc":"","ref":"Lightning.AuthProviders.html#update/2"},{"type":"module","title":"Lightning.AuthProviders.AuthConfig","doc":"AuthProvider model","ref":"Lightning.AuthProviders.AuthConfig.html"},{"type":"type","title":"Lightning.AuthProviders.AuthConfig.t/0","doc":"","ref":"Lightning.AuthProviders.AuthConfig.html#t:t/0"},{"type":"module","title":"Lightning.AuthProviders.CacheWarmer","doc":"Dummy warmer which caches database rows every 30s.","ref":"Lightning.AuthProviders.CacheWarmer.html"},{"type":"function","title":"Lightning.AuthProviders.CacheWarmer.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.AuthProviders.CacheWarmer.html#child_spec/1"},{"type":"function","title":"Lightning.AuthProviders.CacheWarmer.execute/1","doc":"Executes this cache warmer with a connection.","ref":"Lightning.AuthProviders.CacheWarmer.html#execute/1"},{"type":"function","title":"Lightning.AuthProviders.CacheWarmer.interval/0","doc":"Returns the interval for this warmer.","ref":"Lightning.AuthProviders.CacheWarmer.html#interval/0"},{"type":"module","title":"Lightning.AuthProviders.Common","doc":"Provides common functionality for handling OAuth authentication across different providers.","ref":"Lightning.AuthProviders.Common.html"},{"type":"function","title":"Lightning.AuthProviders.Common.authorize_url/4","doc":"Constructs the authorization URL with the given client, state, scopes, and options.","ref":"Lightning.AuthProviders.Common.html#authorize_url/4"},{"type":"function","title":"Lightning.AuthProviders.Common.build_client/3","doc":"Builds a new OAuth client with the specified configuration, authorization URL, token URL, and options.","ref":"Lightning.AuthProviders.Common.html#build_client/3"},{"type":"function","title":"Lightning.AuthProviders.Common.get_token/2","doc":"Requests an authentication token from the OAuth provider.","ref":"Lightning.AuthProviders.Common.html#get_token/2"},{"type":"function","title":"Lightning.AuthProviders.Common.get_userinfo/3","doc":"Retrieves user information from the OAuth provider.","ref":"Lightning.AuthProviders.Common.html#get_userinfo/3"},{"type":"function","title":"Lightning.AuthProviders.Common.get_wellknown/1","doc":"Fetches the well-known configuration from the OAuth provider.","ref":"Lightning.AuthProviders.Common.html#get_wellknown/1"},{"type":"function","title":"Lightning.AuthProviders.Common.get_wellknown!/1","doc":"Fetches the well-known configuration from the OAuth provider and raises an error if not successful.","ref":"Lightning.AuthProviders.Common.html#get_wellknown!/1"},{"type":"function","title":"Lightning.AuthProviders.Common.introspect/3","doc":"","ref":"Lightning.AuthProviders.Common.html#introspect/3"},{"type":"function","title":"Lightning.AuthProviders.Common.refresh_token/2","doc":"Refreshes the authentication token using the OAuth provider.","ref":"Lightning.AuthProviders.Common.html#refresh_token/2"},{"type":"function","title":"Lightning.AuthProviders.Common.still_fresh/3","doc":"Checks if a token is still valid or must be refreshed. If expires_at is nil,\nit will return `false`, forcing a refresh. If the token has already expired or\nwill expire before the default buffer (in the next 5 minutes) we return\n`false`, forcing a refresh.","ref":"Lightning.AuthProviders.Common.html#still_fresh/3"},{"type":"module","title":"Lightning.AuthProviders.Common.TokenBody","doc":"Defines a schema for OAuth token information.","ref":"Lightning.AuthProviders.Common.TokenBody.html"},{"type":"function","title":"Lightning.AuthProviders.Common.TokenBody.from_oauth2_token/1","doc":"Converts an OAuth2 token to a TokenBody struct.","ref":"Lightning.AuthProviders.Common.TokenBody.html#from_oauth2_token/1"},{"type":"function","title":"Lightning.AuthProviders.Common.TokenBody.new/1","doc":"Creates a new TokenBody struct with the given attributes.","ref":"Lightning.AuthProviders.Common.TokenBody.html#new/1"},{"type":"module","title":"Lightning.AuthProviders.Google","doc":"Handles the specifics of the Google OAuth authentication process.","ref":"Lightning.AuthProviders.Google.html"},{"type":"function","title":"Lightning.AuthProviders.Google.provider_name/0","doc":"","ref":"Lightning.AuthProviders.Google.html#provider_name/0"},{"type":"function","title":"Lightning.AuthProviders.Google.scopes/0","doc":"","ref":"Lightning.AuthProviders.Google.html#scopes/0"},{"type":"function","title":"Lightning.AuthProviders.Google.scopes_doc_url/0","doc":"","ref":"Lightning.AuthProviders.Google.html#scopes_doc_url/0"},{"type":"function","title":"Lightning.AuthProviders.Google.wellknown_url/1","doc":"","ref":"Lightning.AuthProviders.Google.html#wellknown_url/1"},{"type":"module","title":"Lightning.AuthProviders.Handler","doc":"Module which wraps Oauth configuration and a WellKnown document\ninto a convenient struct that can be used to authenticate users against\nany OIDC compliant provider.","ref":"Lightning.AuthProviders.Handler.html"},{"type":"function","title":"Lightning.AuthProviders.Handler.authorize_url/1","doc":"","ref":"Lightning.AuthProviders.Handler.html#authorize_url/1"},{"type":"function","title":"Lightning.AuthProviders.Handler.from_model/1","doc":"Returns a Handler from a given AuthConfig","ref":"Lightning.AuthProviders.Handler.html#from_model/1"},{"type":"function","title":"Lightning.AuthProviders.Handler.get_token/2","doc":"","ref":"Lightning.AuthProviders.Handler.html#get_token/2"},{"type":"function","title":"Lightning.AuthProviders.Handler.get_userinfo/2","doc":"","ref":"Lightning.AuthProviders.Handler.html#get_userinfo/2"},{"type":"function","title":"Lightning.AuthProviders.Handler.new/2","doc":"Create a new Provider struct, expects a name and opts:\n\n- `:client_id` - The providers issued id\n- `:client_secret` - Secret for the client\n- `:redirect_uri` - The URI for redirecting after authentication,\n usually the callback url in the router.\n- `:wellknown` - A AuthProviders.WellKnown struct with the providers\n `.well-known/openid-configuration`.","ref":"Lightning.AuthProviders.Handler.html#new/2"},{"type":"type","title":"Lightning.AuthProviders.Handler.opts/0","doc":"","ref":"Lightning.AuthProviders.Handler.html#t:opts/0"},{"type":"type","title":"Lightning.AuthProviders.Handler.t/0","doc":"","ref":"Lightning.AuthProviders.Handler.html#t:t/0"},{"type":"behaviour","title":"Lightning.AuthProviders.OAuthBehaviour","doc":"Defines a behaviour for OAuth providers within the Lightning application,\nspecifying a common interface for OAuth operations.\nThis interface ensures consistency and interoperability among different\nauthentication providers (e.g., Google, Salesforce)\nby defining a set of required functions that each provider must implement.","ref":"Lightning.AuthProviders.OAuthBehaviour.html"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.authorize_url/4","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:authorize_url/4"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.build_client/1","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:build_client/1"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.get_token/3","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:get_token/3"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.get_userinfo/3","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:get_userinfo/3"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.refresh_token/2","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:refresh_token/2"},{"type":"callback","title":"Lightning.AuthProviders.OAuthBehaviour.refresh_token/3","doc":"","ref":"Lightning.AuthProviders.OAuthBehaviour.html#c:refresh_token/3"},{"type":"module","title":"Lightning.AuthProviders.OauthHTTPClient","doc":"Handles OAuth interactions for generic providers, including token fetching,\nrefreshing, and user information retrieval. This module uses Tesla to make HTTP\nrequests configured with middleware appropriate for OAuth specific tasks.","ref":"Lightning.AuthProviders.OauthHTTPClient.html"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.delete/3","doc":"Perform a DELETE request.\n\nSee `request/1` or `request/2` for options definition.\n\n delete(\"/users\")\n delete(\"/users\", query: [scope: \"admin\"])\n delete(client, \"/users\")\n delete(client, \"/users\", query: [scope: \"admin\"])\n delete(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#delete/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.delete!/3","doc":"Perform a DELETE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n delete!(\"/users\")\n delete!(\"/users\", query: [scope: \"admin\"])\n delete!(client, \"/users\")\n delete!(client, \"/users\", query: [scope: \"admin\"])\n delete!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#delete!/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.fetch_token/2","doc":"Fetches a new token using the authorization code provided by the OAuth provider.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_token/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.fetch_token/2","doc":"- `client`: The client configuration containing client_id, client_secret, and token_endpoint.\n- `code`: The authorization code received from the OAuth provider.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_token/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.fetch_token/2","doc":"- `{:ok, token_data}` on success\n- `{:error, reason}` on failure","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_token/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.fetch_userinfo/2","doc":"Fetches user information from the OAuth provider using a valid access token.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_userinfo/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.fetch_userinfo/2","doc":"- `client`: The client configuration containing userinfo_endpoint.\n- `token`: The token configuration containing access_token.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_userinfo/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.fetch_userinfo/2","doc":"- `{:ok, user_info}` on success\n- `{:error, reason}` on failure","ref":"Lightning.AuthProviders.OauthHTTPClient.html#fetch_userinfo/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.generate_authorize_url/2","doc":"Generates an authorization URL with specified parameters.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#generate_authorize_url/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.generate_authorize_url/2","doc":"- `client`: The client configuration containing client_id, and authorization_endpoint.\n- `params`: Additional parameters to include in the authorization URL.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#generate_authorize_url/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.generate_authorize_url/2","doc":"- The fully formed authorization URL as a string.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#generate_authorize_url/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.get/3","doc":"Perform a GET request.\n\nSee `request/1` or `request/2` for options definition.\n\n get(\"/users\")\n get(\"/users\", query: [scope: \"admin\"])\n get(client, \"/users\")\n get(client, \"/users\", query: [scope: \"admin\"])\n get(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#get/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.get!/3","doc":"Perform a GET request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n get!(\"/users\")\n get!(\"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\")\n get!(client, \"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#get!/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.head/3","doc":"Perform a HEAD request.\n\nSee `request/1` or `request/2` for options definition.\n\n head(\"/users\")\n head(\"/users\", query: [scope: \"admin\"])\n head(client, \"/users\")\n head(client, \"/users\", query: [scope: \"admin\"])\n head(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#head/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.head!/3","doc":"Perform a HEAD request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n head!(\"/users\")\n head!(\"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\")\n head!(client, \"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#head!/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.options/3","doc":"Perform a OPTIONS request.\n\nSee `request/1` or `request/2` for options definition.\n\n options(\"/users\")\n options(\"/users\", query: [scope: \"admin\"])\n options(client, \"/users\")\n options(client, \"/users\", query: [scope: \"admin\"])\n options(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#options/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.options!/3","doc":"Perform a OPTIONS request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n options!(\"/users\")\n options!(\"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\")\n options!(client, \"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#options!/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.patch/4","doc":"Perform a PATCH request.\n\nSee `request/1` or `request/2` for options definition.\n\n patch(\"/users\", %{name: \"Jon\"})\n patch(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch(client, \"/users\", %{name: \"Jon\"})\n patch(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#patch/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.patch!/4","doc":"Perform a PATCH request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n patch!(\"/users\", %{name: \"Jon\"})\n patch!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch!(client, \"/users\", %{name: \"Jon\"})\n patch!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#patch!/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.post/4","doc":"Perform a POST request.\n\nSee `request/1` or `request/2` for options definition.\n\n post(\"/users\", %{name: \"Jon\"})\n post(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n post(client, \"/users\", %{name: \"Jon\"})\n post(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#post/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.post!/4","doc":"Perform a POST request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n post!(\"/users\", %{name: \"Jon\"})\n post!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n post!(client, \"/users\", %{name: \"Jon\"})\n post!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#post!/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.put/4","doc":"Perform a PUT request.\n\nSee `request/1` or `request/2` for options definition.\n\n put(\"/users\", %{name: \"Jon\"})\n put(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n put(client, \"/users\", %{name: \"Jon\"})\n put(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#put/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.put!/4","doc":"Perform a PUT request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n put!(\"/users\", %{name: \"Jon\"})\n put!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n put!(client, \"/users\", %{name: \"Jon\"})\n put!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.AuthProviders.OauthHTTPClient.html#put!/4"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.refresh_token/2","doc":"Refreshes an existing token using the refresh token.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#refresh_token/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.refresh_token/2","doc":"- `client`: The client configuration containing client_id, client_secret, and token_endpoint.\n- `token`: The token configuration containing refresh_token","ref":"Lightning.AuthProviders.OauthHTTPClient.html#refresh_token/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.refresh_token/2","doc":"- `{:ok, refreshed_token_data}` on success\n- `{:error, reason}` on failure","ref":"Lightning.AuthProviders.OauthHTTPClient.html#refresh_token/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.request/2","doc":"Perform a request.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#request/2"},{"type":"function","title":"Options - Lightning.AuthProviders.OauthHTTPClient.request/2","doc":"- `:method` - the request method, one of [`:head`, `:get`, `:delete`, `:trace`, `:options`, `:post`, `:put`, `:patch`]\n- `:url` - either full url e.g. \"http://example.com/some/path\" or just \"/some/path\" if using `Tesla.Middleware.BaseUrl`\n- `:query` - a keyword list of query params, e.g. `[page: 1, per_page: 100]`\n- `:headers` - a keyword list of headers, e.g. `[{\"content-type\", \"text/plain\"}]`\n- `:body` - depends on used middleware:\n - by default it can be a binary\n - if using e.g. JSON encoding middleware it can be a nested map\n - if adapter supports it it can be a Stream with any of the above\n- `:opts` - custom, per-request middleware or adapter options","ref":"Lightning.AuthProviders.OauthHTTPClient.html#request/2-options"},{"type":"function","title":"Examples - Lightning.AuthProviders.OauthHTTPClient.request/2","doc":"ExampleApi.request(method: :get, url: \"/users/path\")\n\n # use shortcut methods\n ExampleApi.get(\"/users/1\")\n ExampleApi.post(client, \"/users\", %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#request/2-examples"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.request!/2","doc":"Perform request and raise in case of error.\n\nThis is similar to `request/2` behaviour from Tesla 0.x\n\nSee `request/2` for list of available options.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#request!/2"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.revoke_token/2","doc":"Revokes an OAuth token.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#revoke_token/2"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.revoke_token/2","doc":"- `client`: The client configuration containing client_id and client_secret.\n- `token`: The token to be revoked (access_token or refresh_token).","ref":"Lightning.AuthProviders.OauthHTTPClient.html#revoke_token/2-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.revoke_token/2","doc":"- `{:ok, response}` on success\n- `{:error, reason}` on failure","ref":"Lightning.AuthProviders.OauthHTTPClient.html#revoke_token/2-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.still_fresh/3","doc":"Determines if the token data is still considered fresh.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#still_fresh/3"},{"type":"function","title":"Parameters - Lightning.AuthProviders.OauthHTTPClient.still_fresh/3","doc":"- `token`: a map containing token data with `expires_at` or `expires_in` keys.\n- `threshold`: the number of time units before expiration to consider the token still fresh.\n- `time_unit`: the unit of time to consider for the threshold comparison.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#still_fresh/3-parameters"},{"type":"function","title":"Returns - Lightning.AuthProviders.OauthHTTPClient.still_fresh/3","doc":"- `true` if the token is fresh.\n- `{:error, reason}` if the token's expiration data is missing or invalid.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#still_fresh/3-returns"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.trace/3","doc":"Perform a TRACE request.\n\nSee `request/1` or `request/2` for options definition.\n\n trace(\"/users\")\n trace(\"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\")\n trace(client, \"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#trace/3"},{"type":"function","title":"Lightning.AuthProviders.OauthHTTPClient.trace!/3","doc":"Perform a TRACE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n trace!(\"/users\")\n trace!(\"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\")\n trace!(client, \"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.AuthProviders.OauthHTTPClient.html#trace!/3"},{"type":"type","title":"Lightning.AuthProviders.OauthHTTPClient.option/0","doc":"Options that may be passed to a request function. See `request/2` for detailed descriptions.","ref":"Lightning.AuthProviders.OauthHTTPClient.html#t:option/0"},{"type":"module","title":"Lightning.AuthProviders.Salesforce","doc":"Handles the specifics of the Salesforce OAuth authentication process.","ref":"Lightning.AuthProviders.Salesforce.html"},{"type":"function","title":"Lightning.AuthProviders.Salesforce.provider_name/0","doc":"","ref":"Lightning.AuthProviders.Salesforce.html#provider_name/0"},{"type":"function","title":"Lightning.AuthProviders.Salesforce.scopes/0","doc":"","ref":"Lightning.AuthProviders.Salesforce.html#scopes/0"},{"type":"function","title":"Lightning.AuthProviders.Salesforce.scopes_doc_url/0","doc":"","ref":"Lightning.AuthProviders.Salesforce.html#scopes_doc_url/0"},{"type":"function","title":"Lightning.AuthProviders.Salesforce.wellknown_url/1","doc":"","ref":"Lightning.AuthProviders.Salesforce.html#wellknown_url/1"},{"type":"module","title":"Lightning.AuthProviders.Store","doc":"Store module for caching Handlers.\n\nSince Handlers often have to fetch their `.well-known` files when being\ninitialized we cache these in order to avoid repeatedly making HTTP requests\nto a providers API.","ref":"Lightning.AuthProviders.Store.html"},{"type":"function","title":"Lightning.AuthProviders.Store.get_handler/2","doc":"","ref":"Lightning.AuthProviders.Store.html#get_handler/2"},{"type":"function","title":"Lightning.AuthProviders.Store.get_handlers/0","doc":"","ref":"Lightning.AuthProviders.Store.html#get_handlers/0"},{"type":"function","title":"Lightning.AuthProviders.Store.put_handler/2","doc":"","ref":"Lightning.AuthProviders.Store.html#put_handler/2"},{"type":"function","title":"Lightning.AuthProviders.Store.remove_handler/1","doc":"","ref":"Lightning.AuthProviders.Store.html#remove_handler/1"},{"type":"type","title":"Lightning.AuthProviders.Store.finder/0","doc":"","ref":"Lightning.AuthProviders.Store.html#t:finder/0"},{"type":"module","title":"Lightning.AuthProviders.WellKnown","doc":"A datastructure to fetch and hold information about a given OIDC/OAuth provider","ref":"Lightning.AuthProviders.WellKnown.html"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.delete/3","doc":"Issues a DELETE request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#delete/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.delete!/3","doc":"Issues a DELETE request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#delete!/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.fetch/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#fetch/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.fetch!/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#fetch!/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.get/3","doc":"Issues a GET request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#get/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.get!/3","doc":"Issues a GET request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#get!/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.head/3","doc":"Issues a HEAD request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#head/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.head!/3","doc":"Issues a HEAD request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#head!/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.new/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#new/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.options/3","doc":"Issues an OPTIONS request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#options/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.options!/3","doc":"Issues a OPTIONS request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#options!/3"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.patch/4","doc":"Issues a PATCH request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#patch/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.patch!/4","doc":"Issues a PATCH request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#patch!/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.post/4","doc":"Issues a POST request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#post/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.post!/4","doc":"Issues a POST request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#post!/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_headers/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_headers/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_body/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_body/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_headers/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_headers/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_options/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_options/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_params/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_params/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_request_url/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_request_url/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response_body/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response_body/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response_chunk/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response_chunk/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response_headers/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response_headers/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_response_status_code/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_response_status_code/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_status_code/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_status_code/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.process_url/1","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#process_url/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.put/4","doc":"Issues a PUT request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#put/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.put!/4","doc":"Issues a PUT request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#put!/4"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.request/1","doc":"Issues an HTTP request using an `HTTPoison.Request` struct.\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Lightning.AuthProviders.WellKnown.html#request/1"},{"type":"function","title":"Redirect handling - Lightning.AuthProviders.WellKnown.request/1","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Lightning.AuthProviders.WellKnown.html#request/1-redirect-handling"},{"type":"function","title":"Examples - Lightning.AuthProviders.WellKnown.request/1","doc":"request = %HTTPoison.Request{\n method: :post,\n url: \"https://my.website.com\",\n body: \"{\\\"foo\\\": 3}\",\n headers: [{\"Accept\", \"application/json\"}]\n }\n\n request(request)","ref":"Lightning.AuthProviders.WellKnown.html#request/1-examples"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.request/5","doc":"Issues an HTTP request with the given method to the given url.\n\nThis function is usually used indirectly by `get/3`, `post/4`, `put/4`, etc\n\nArgs:\n * `method` - HTTP method as an atom (`:get`, `:head`, `:post`, `:put`,\n `:delete`, etc.)\n * `url` - target url as a binary string or char list\n * `body` - request body. See more below\n * `headers` - HTTP headers as an orddict (e.g., `[{\"Accept\", \"application/json\"}]`)\n * `options` - Keyword list of options\n\nBody: see type `HTTPoison.Request`\n\nOptions: see type `HTTPoison.Request`\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Lightning.AuthProviders.WellKnown.html#request/5"},{"type":"function","title":"Redirect handling - Lightning.AuthProviders.WellKnown.request/5","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Lightning.AuthProviders.WellKnown.html#request/5-redirect-handling"},{"type":"function","title":"Examples - Lightning.AuthProviders.WellKnown.request/5","doc":"request(:post, \"https://my.website.com\", \"{\\\"foo\\\": 3}\", [{\"Accept\", \"application/json\"}])","ref":"Lightning.AuthProviders.WellKnown.html#request/5-examples"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.request!/1","doc":"Issues an HTTP request an `HTTPoison.Request` struct.\nexception in case of failure.\n\n`request!/1` works exactly like `request/1` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Lightning.AuthProviders.WellKnown.html#request!/1"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.request!/5","doc":"Issues an HTTP request with the given method to the given url, raising an\nexception in case of failure.\n\n`request!/5` works exactly like `request/5` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Lightning.AuthProviders.WellKnown.html#request!/5"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.start/0","doc":"Starts HTTPoison and its dependencies.","ref":"Lightning.AuthProviders.WellKnown.html#start/0"},{"type":"function","title":"Lightning.AuthProviders.WellKnown.stream_next/1","doc":"Requests the next message to be streamed for a given `HTTPoison.AsyncResponse`.\n\nSee `request!/5` for more detailed information.","ref":"Lightning.AuthProviders.WellKnown.html#stream_next/1"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.body/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:body/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.headers/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:headers/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.method/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:method/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.options/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:options/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.params/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:params/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.request/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:request/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.t/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:t/0"},{"type":"type","title":"Lightning.AuthProviders.WellKnown.url/0","doc":"","ref":"Lightning.AuthProviders.WellKnown.html#t:url/0"},{"type":"module","title":"Lightning.BuildMacros","doc":"Macros for building Lightning.","ref":"Lightning.BuildMacros.html"},{"type":"macro","title":"Lightning.BuildMacros.do_in/2","doc":"Conditionally evaluates the block if the current environment is in the\ngiven list of environments.","ref":"Lightning.BuildMacros.html#do_in/2"},{"type":"macro","title":"Examples - Lightning.BuildMacros.do_in/2","doc":"do_in(:dev) do\n IO.puts(\"This will only be printed in the dev environment\")\n end\n\n do_in([:dev, :test]) do\n IO.puts(\"This will only be printed in the dev and test environments\")\n end","ref":"Lightning.BuildMacros.html#do_in/2-examples"},{"type":"module","title":"Lightning.CLI","doc":"Module providing facilities to make calls to the OpenFn CLI.\n\nSee [@openfn/cli](https://github.com/OpenFn/kit/tree/main/packages/cli#openfncli)","ref":"Lightning.CLI.html"},{"type":"function","title":"Lightning.CLI.execute/1","doc":"Execute a command in a child process and parse the results.","ref":"Lightning.CLI.html#execute/1"},{"type":"function","title":"Lightning.CLI.metadata/2","doc":"Retrieve metadata for a given adaptor and configuration.","ref":"Lightning.CLI.html#metadata/2"},{"type":"module","title":"Lightning.CLI.Result","doc":"Struct that wraps the output of an OpenFn CLI call.\n\nContaining the keys:\n\n- `start_time`\n- `end_time`\n- `status`\n- `logs`","ref":"Lightning.CLI.Result.html"},{"type":"module","title":"Logs - Lightning.CLI.Result","doc":"The OpenFn CLI returns JSON formatted log lines, which are decoded and added\nto a `Result` struct.\n\nThere are two kinds of output:\n\n```\n{\"level\":\"< >\",\"name\":\"< >\",\"message\":\"...\"],\"time\":< >}\n```\n\nThese are usually for general logging, and debugging.\n\n```\n{\"message\":[\"< >\"]}\n```\n\nThe above is the equivalent of the output of a command","ref":"Lightning.CLI.Result.html#module-logs"},{"type":"function","title":"Lightning.CLI.Result.get_messages/1","doc":"Returns `message` type log lines from a `Result`.","ref":"Lightning.CLI.Result.html#get_messages/1"},{"type":"function","title":"Lightning.CLI.Result.new/1","doc":"","ref":"Lightning.CLI.Result.html#new/1"},{"type":"function","title":"Lightning.CLI.Result.parse/2","doc":"","ref":"Lightning.CLI.Result.html#parse/2"},{"type":"type","title":"Lightning.CLI.Result.t/0","doc":"","ref":"Lightning.CLI.Result.html#t:t/0"},{"type":"module","title":"Lightning.ChangesetUtils","doc":"Extra functions for Ecto.Changeset.","ref":"Lightning.ChangesetUtils.html"},{"type":"function","title":"Lightning.ChangesetUtils.put_if_provided/3","doc":"Puts a new change in the changeset if the params have the field.\n\nUseful when params don't have a given key and you don't want to set the\nfield to `nil`.","ref":"Lightning.ChangesetUtils.html#put_if_provided/3"},{"type":"function","title":"Lightning.ChangesetUtils.put_new_change/3","doc":"Puts a new change in the changeset if the field is not already set.\n\nNOTE: This function considers a field with a `nil` value as not set.","ref":"Lightning.ChangesetUtils.html#put_new_change/3"},{"type":"module","title":"Lightning.Collections","doc":"Access to collections of unique key-value pairs shared across multiple workflows.","ref":"Lightning.Collections.html"},{"type":"function","title":"Lightning.Collections.create_collection/1","doc":"Creates a new collection with the given attributes.","ref":"Lightning.Collections.html#create_collection/1"},{"type":"function","title":"Parameters - Lightning.Collections.create_collection/1","doc":"- `attrs`: A map of attributes to create the collection.","ref":"Lightning.Collections.html#create_collection/1-parameters"},{"type":"function","title":"Examples - Lightning.Collections.create_collection/1","doc":"iex> create_collection(%{name: \"New Collection\", description: \"Description here\"})\n {:ok, %Collection{}}\n\n iex> create_collection(%{name: nil})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Collections.html#create_collection/1-examples"},{"type":"function","title":"Returns - Lightning.Collections.create_collection/1","doc":"- `{:ok, %Collection{}}` on success.\n - `{:error, %Ecto.Changeset{}}` on failure due to validation errors.","ref":"Lightning.Collections.html#create_collection/1-returns"},{"type":"function","title":"Lightning.Collections.create_collection/2","doc":"","ref":"Lightning.Collections.html#create_collection/2"},{"type":"function","title":"Lightning.Collections.delete/2","doc":"","ref":"Lightning.Collections.html#delete/2"},{"type":"function","title":"Lightning.Collections.delete_all/2","doc":"","ref":"Lightning.Collections.html#delete_all/2"},{"type":"function","title":"Lightning.Collections.delete_collection/1","doc":"","ref":"Lightning.Collections.html#delete_collection/1"},{"type":"function","title":"Lightning.Collections.get/2","doc":"","ref":"Lightning.Collections.html#get/2"},{"type":"function","title":"Lightning.Collections.get_all/3","doc":"","ref":"Lightning.Collections.html#get_all/3"},{"type":"function","title":"Lightning.Collections.get_collection/1","doc":"","ref":"Lightning.Collections.html#get_collection/1"},{"type":"function","title":"Lightning.Collections.list_collections/1","doc":"Returns the list of collections with optional ordering and preloading.","ref":"Lightning.Collections.html#list_collections/1"},{"type":"function","title":"Parameters - Lightning.Collections.list_collections/1","doc":"- `opts`: A keyword list of options.\n - `:order_by` (optional): The field by which to order the results. Default is `[asc: :name]`.\n - `:preload` (optional): A list of associations to preload. Default is `[:project]`.","ref":"Lightning.Collections.html#list_collections/1-parameters"},{"type":"function","title":"Examples - Lightning.Collections.list_collections/1","doc":"iex> list_collections()\n [%Collection{}, ...]\n\n iex> list_collections(order_by: [asc: :inserted_at], preload: [:project, :user])\n [%Collection{}, ...]","ref":"Lightning.Collections.html#list_collections/1-examples"},{"type":"function","title":"Returns - Lightning.Collections.list_collections/1","doc":"- A list of `%Collection{}` structs, preloaded and ordered as specified.","ref":"Lightning.Collections.html#list_collections/1-returns"},{"type":"function","title":"Lightning.Collections.put/3","doc":"","ref":"Lightning.Collections.html#put/3"},{"type":"function","title":"Lightning.Collections.put_all/2","doc":"","ref":"Lightning.Collections.html#put_all/2"},{"type":"function","title":"Lightning.Collections.update_collection/2","doc":"Updates an existing collection with the given attributes.","ref":"Lightning.Collections.html#update_collection/2"},{"type":"function","title":"Parameters - Lightning.Collections.update_collection/2","doc":"- `collection`: The existing `%Collection{}` struct to update.\n - `attrs`: A map of attributes to update the collection.","ref":"Lightning.Collections.html#update_collection/2-parameters"},{"type":"function","title":"Examples - Lightning.Collections.update_collection/2","doc":"iex> update_collection(collection, %{name: \"Updated Name\"})\n {:ok, %Collection{}}\n\n iex> update_collection(collection, %{name: nil})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.Collections.html#update_collection/2-examples"},{"type":"function","title":"Returns - Lightning.Collections.update_collection/2","doc":"- `{:ok, %Collection{}}` on success.\n - `{:error, %Ecto.Changeset{}}` on failure due to validation errors.","ref":"Lightning.Collections.html#update_collection/2-returns"},{"type":"module","title":"Lightning.Collections.Collection","doc":"Collection referenced by name associated to a project.","ref":"Lightning.Collections.Collection.html"},{"type":"type","title":"Lightning.Collections.Collection.t/0","doc":"","ref":"Lightning.Collections.Collection.html#t:t/0"},{"type":"module","title":"Lightning.Collections.Item","doc":"A key value entry of a collection bound to a project.","ref":"Lightning.Collections.Item.html"},{"type":"type","title":"Lightning.Collections.Item.t/0","doc":"","ref":"Lightning.Collections.Item.html#t:t/0"},{"type":"module","title":"Lightning.DashboardStats","doc":"Dashboard stats for a project and its workflows.","ref":"Lightning.DashboardStats.html"},{"type":"function","title":"Lightning.DashboardStats.aggregate_project_metrics/1","doc":"","ref":"Lightning.DashboardStats.html#aggregate_project_metrics/1"},{"type":"function","title":"Lightning.DashboardStats.filter_days_ago/2","doc":"","ref":"Lightning.DashboardStats.html#filter_days_ago/2"},{"type":"function","title":"Lightning.DashboardStats.get_workflow_stats/1","doc":"","ref":"Lightning.DashboardStats.html#get_workflow_stats/1"},{"type":"module","title":"Lightning.DashboardStats.ProjectMetrics","doc":"Aggregated metrics for a project.","ref":"Lightning.DashboardStats.ProjectMetrics.html"},{"type":"module","title":"Lightning.DashboardStats.WorkflowStats","doc":"Stats for each workflow.\n\nRuns and WorkOrders counting are grouped by state.","ref":"Lightning.DashboardStats.WorkflowStats.html"},{"type":"module","title":"Lightning.DataclipScrubber","doc":"Handles scrubbing of dataclips","ref":"Lightning.DataclipScrubber.html"},{"type":"function","title":"Lightning.DataclipScrubber.scrub_dataclip_body!/1","doc":"","ref":"Lightning.DataclipScrubber.html#scrub_dataclip_body!/1"},{"type":"module","title":"Lightning.Demo","doc":"Demo encapsulates logic for setting up a demonstration site.","ref":"Lightning.Demo.html"},{"type":"function","title":"Lightning.Demo.reset_demo/0","doc":"Deletes everything in the database including the superuser and creates a set\nof publicly available users for a demo site via a command that can be run on\nKubernetes-deployed systems.","ref":"Lightning.Demo.html#reset_demo/0"},{"type":"module","title":"Lightning.ExportUtils","doc":"Module that expose a function generating a complete and valid yaml string\nfrom a project and its workflows.","ref":"Lightning.ExportUtils.html"},{"type":"function","title":"Lightning.ExportUtils.build_yaml_tree/2","doc":"","ref":"Lightning.ExportUtils.html#build_yaml_tree/2"},{"type":"function","title":"Lightning.ExportUtils.generate_new_yaml/2","doc":"","ref":"Lightning.ExportUtils.html#generate_new_yaml/2"},{"type":"behaviour","title":"Lightning.Extensions.AccountHooking","doc":"Allows handling user creation or registration atomically without relying on async events.","ref":"Lightning.Extensions.AccountHooking.html"},{"type":"callback","title":"Lightning.Extensions.AccountHooking.handle_create_user/1","doc":"","ref":"Lightning.Extensions.AccountHooking.html#c:handle_create_user/1"},{"type":"callback","title":"Lightning.Extensions.AccountHooking.handle_register_superuser/1","doc":"","ref":"Lightning.Extensions.AccountHooking.html#c:handle_register_superuser/1"},{"type":"callback","title":"Lightning.Extensions.AccountHooking.handle_register_user/1","doc":"","ref":"Lightning.Extensions.AccountHooking.html#c:handle_register_user/1"},{"type":"module","title":"Lightning.Extensions.FifoRunQueue","doc":"Allows adding, removing or claiming work to be executed by the Runtime.","ref":"Lightning.Extensions.FifoRunQueue.html"},{"type":"module","title":"Lightning.Extensions.Message","doc":"Message for the limiters to communicate with the client.","ref":"Lightning.Extensions.Message.html"},{"type":"type","title":"Lightning.Extensions.Message.t/0","doc":"","ref":"Lightning.Extensions.Message.html#t:t/0"},{"type":"module","title":"Lightning.Extensions.ProjectHook","doc":"Allows handling user creation or registration atomically without relying on async events.","ref":"Lightning.Extensions.ProjectHook.html"},{"type":"function","title":"Lightning.Extensions.ProjectHook.handle_create_project/1","doc":"","ref":"Lightning.Extensions.ProjectHook.html#handle_create_project/1"},{"type":"function","title":"Lightning.Extensions.ProjectHook.handle_delete_project/1","doc":"","ref":"Lightning.Extensions.ProjectHook.html#handle_delete_project/1"},{"type":"function","title":"Lightning.Extensions.ProjectHook.handle_project_validation/1","doc":"","ref":"Lightning.Extensions.ProjectHook.html#handle_project_validation/1"},{"type":"behaviour","title":"Lightning.Extensions.ProjectHooking","doc":"Allows handling project creation atomically without relying on async events.","ref":"Lightning.Extensions.ProjectHooking.html"},{"type":"callback","title":"Lightning.Extensions.ProjectHooking.handle_create_project/1","doc":"","ref":"Lightning.Extensions.ProjectHooking.html#c:handle_create_project/1"},{"type":"callback","title":"Lightning.Extensions.ProjectHooking.handle_delete_project/1","doc":"","ref":"Lightning.Extensions.ProjectHooking.html#c:handle_delete_project/1"},{"type":"callback","title":"Lightning.Extensions.ProjectHooking.handle_project_validation/1","doc":"","ref":"Lightning.Extensions.ProjectHooking.html#c:handle_project_validation/1"},{"type":"module","title":"Lightning.Extensions.RateLimiter","doc":"Rate limiting stub for Lightning.","ref":"Lightning.Extensions.RateLimiter.html"},{"type":"behaviour","title":"Lightning.Extensions.RateLimiting","doc":"Rate limiting for Lightning API endpoints.","ref":"Lightning.Extensions.RateLimiting.html"},{"type":"callback","title":"Lightning.Extensions.RateLimiting.limit_request/3","doc":"","ref":"Lightning.Extensions.RateLimiting.html#c:limit_request/3"},{"type":"type","title":"Lightning.Extensions.RateLimiting.message/0","doc":"","ref":"Lightning.Extensions.RateLimiting.html#t:message/0"},{"type":"type","title":"Lightning.Extensions.RateLimiting.request_error/0","doc":"","ref":"Lightning.Extensions.RateLimiting.html#t:request_error/0"},{"type":"module","title":"Lightning.Extensions.RateLimiting.Context","doc":"Which user is making the request for a certain project.","ref":"Lightning.Extensions.RateLimiting.Context.html"},{"type":"type","title":"Lightning.Extensions.RateLimiting.Context.t/0","doc":"","ref":"Lightning.Extensions.RateLimiting.Context.html#t:t/0"},{"type":"behaviour","title":"Lightning.Extensions.RunQueue","doc":"Extension to customize the scheduling of workloads on Lightning Runtime.","ref":"Lightning.Extensions.RunQueue.html"},{"type":"callback","title":"Lightning.Extensions.RunQueue.claim/1","doc":"","ref":"Lightning.Extensions.RunQueue.html#c:claim/1"},{"type":"callback","title":"Lightning.Extensions.RunQueue.dequeue/1","doc":"","ref":"Lightning.Extensions.RunQueue.html#c:dequeue/1"},{"type":"callback","title":"Lightning.Extensions.RunQueue.enqueue/1","doc":"","ref":"Lightning.Extensions.RunQueue.html#c:enqueue/1"},{"type":"callback","title":"Lightning.Extensions.RunQueue.enqueue_many/1","doc":"","ref":"Lightning.Extensions.RunQueue.html#c:enqueue_many/1"},{"type":"module","title":"Lightning.Extensions.UsageLimiter","doc":"Runtime limiting stub for Lightning.","ref":"Lightning.Extensions.UsageLimiter.html"},{"type":"behaviour","title":"Lightning.Extensions.UsageLimiting","doc":"Rate limiting for Lightning workloads that depends on Runtime.","ref":"Lightning.Extensions.UsageLimiting.html"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.check_limits/1","doc":"Checks the usage limits for a given project and user context, returning an error\nmessage if the limits are exceeded.\n\nRequires a `Context` struct containing the `project_id` and `user_id`.","ref":"Lightning.Extensions.UsageLimiting.html#c:check_limits/1"},{"type":"callback","title":"Returns - Lightning.Extensions.UsageLimiting.check_limits/1","doc":"- `{:ok}` if the limits are within bounds.\n - `{:error, reason, message}` if the limits are exceeded.","ref":"Lightning.Extensions.UsageLimiting.html#c:check_limits/1-returns"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.get_data_retention_message/1","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#c:get_data_retention_message/1"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.get_data_retention_periods/1","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#c:get_data_retention_periods/1"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.get_run_options/1","doc":"Returns run options based on the given project context. The run options include\na timeout value and a flag for saving dataclips.\n\nRequires a `Context` struct containing the `project_id`.","ref":"Lightning.Extensions.UsageLimiting.html#c:get_run_options/1"},{"type":"callback","title":"Returns - Lightning.Extensions.UsageLimiting.get_run_options/1","doc":"- A keyword list of run options including:\n - `:run_timeout_ms`: The run timeout in milliseconds.\n - `:save_dataclips`: A boolean indicating whether to save dataclips.","ref":"Lightning.Extensions.UsageLimiting.html#c:get_run_options/1-returns"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.increment_ai_queries/1","doc":"Increments the AI query count for a given chat session.\n\nRequires a `Lightning.AiAssistant.ChatSession` struct.","ref":"Lightning.Extensions.UsageLimiting.html#c:increment_ai_queries/1"},{"type":"callback","title":"Returns - Lightning.Extensions.UsageLimiting.increment_ai_queries/1","doc":"- An Ecto.Multi struct representing the transaction to increment AI queries.","ref":"Lightning.Extensions.UsageLimiting.html#c:increment_ai_queries/1-returns"},{"type":"callback","title":"Lightning.Extensions.UsageLimiting.limit_action/2","doc":"Limits specific actions based on an `Action` and `Context`.","ref":"Lightning.Extensions.UsageLimiting.html#c:limit_action/2"},{"type":"callback","title":"Returns - Lightning.Extensions.UsageLimiting.limit_action/2","doc":"- `:ok` if the action is allowed.\n - `{:error, reason, message}` if the action is not allowed.","ref":"Lightning.Extensions.UsageLimiting.html#c:limit_action/2-returns"},{"type":"type","title":"Lightning.Extensions.UsageLimiting.error/0","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#t:error/0"},{"type":"type","title":"Lightning.Extensions.UsageLimiting.error_reason/0","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#t:error_reason/0"},{"type":"type","title":"Lightning.Extensions.UsageLimiting.message/0","doc":"","ref":"Lightning.Extensions.UsageLimiting.html#t:message/0"},{"type":"module","title":"Lightning.FailureNotifierView","doc":"","ref":"Lightning.FailureNotifierView.html"},{"type":"function","title":"Lightning.FailureNotifierView.__resource__/0","doc":"The resource name, as an atom, for this view","ref":"Lightning.FailureNotifierView.html#__resource__/0"},{"type":"function","title":"Lightning.FailureNotifierView.failure_alert.html/1","doc":"","ref":"Lightning.FailureNotifierView.html#failure_alert.html/1"},{"type":"function","title":"Lightning.FailureNotifierView.render/2","doc":"Renders the given template locally.","ref":"Lightning.FailureNotifierView.html#render/2"},{"type":"function","title":"Lightning.FailureNotifierView.template_not_found/2","doc":"Callback invoked when no template is found.\nBy default it raises but can be customized\nto render a particular template.","ref":"Lightning.FailureNotifierView.html#template_not_found/2"},{"type":"module","title":"Lightning.Graph","doc":"A graph model for workflows transversal.","ref":"Lightning.Graph.html"},{"type":"function","title":"Lightning.Graph.add_edge/3","doc":"","ref":"Lightning.Graph.html#add_edge/3"},{"type":"function","title":"Lightning.Graph.new/0","doc":"","ref":"Lightning.Graph.html#new/0"},{"type":"function","title":"Lightning.Graph.nodes/2","doc":"","ref":"Lightning.Graph.html#nodes/2"},{"type":"function","title":"Lightning.Graph.prune/2","doc":"","ref":"Lightning.Graph.html#prune/2"},{"type":"function","title":"Lightning.Graph.remove_edges/2","doc":"","ref":"Lightning.Graph.html#remove_edges/2"},{"type":"type","title":"Lightning.Graph.t/0","doc":"","ref":"Lightning.Graph.html#t:t/0"},{"type":"module","title":"Lightning.Helpers","doc":"Common functions for the context","ref":"Lightning.Helpers.html"},{"type":"function","title":"Lightning.Helpers.actual_deletion_date/3","doc":"","ref":"Lightning.Helpers.html#actual_deletion_date/3"},{"type":"function","title":"Lightning.Helpers.coerce_json_field/2","doc":"Changes a given maps field from a json string to a map.\nIf it cannot be converted, it leaves the original value","ref":"Lightning.Helpers.html#coerce_json_field/2"},{"type":"function","title":"Lightning.Helpers.copy_error/4","doc":"Copies an error from one key to another in the given changeset.","ref":"Lightning.Helpers.html#copy_error/4"},{"type":"function","title":"Parameters - Lightning.Helpers.copy_error/4","doc":"- `changeset`: The changeset to modify.\n - `original_key`: The key where the error currently exists.\n - `new_key`: The key where the error should be duplicated.\n - `opts`: A keyword list of options. Supports `overwrite`, which is a boolean indicating whether to overwrite the `new_key` error if it already exists. Defaults to `true`.","ref":"Lightning.Helpers.html#copy_error/4-parameters"},{"type":"function","title":"Example - Lightning.Helpers.copy_error/4","doc":"iex> changeset = %Ecto.Changeset{errors: [name: {\"has already been taken\", []}]}\n iex> updated_changeset = Lightning.Helpers.copy_error(changeset, :name, :raw_name)\n iex> updated_changeset.errors\n [name: {\"has already been taken\", []}, raw_name: {\"has already been taken\", []}]\n\nIf the `original_key` doesn't exist in the errors, or if the `new_key` already exists and `overwrite` is set to `false`, the changeset is returned unchanged.","ref":"Lightning.Helpers.html#copy_error/4-example"},{"type":"function","title":"Lightning.Helpers.format_date/2","doc":"","ref":"Lightning.Helpers.html#format_date/2"},{"type":"function","title":"Lightning.Helpers.json_safe/1","doc":"Recursively ensures a given map is safe to convert to JSON,\nwhere all keys are strings and all values are json safe (primitive values).","ref":"Lightning.Helpers.html#json_safe/1"},{"type":"function","title":"Lightning.Helpers.ms_to_human/1","doc":"Converts milliseconds (integer) to a human duration, such as \"1 minute\" or\n\"45 years, 6 months, 5 days, 21 hours, 12 minutes, 34 seconds\" using\n`Timex.Format.Duration.Formatters.Humanized.format()`.","ref":"Lightning.Helpers.html#ms_to_human/1"},{"type":"function","title":"Lightning.Helpers.url_safe_name/1","doc":"Converts a string into a URL-safe format by converting it to lowercase,\nreplacing unwanted characters with hyphens, and trimming leading/trailing hyphens.\n\nThis function allows international characters, which will be automatically\npercent-encoded in URLs by browsers.","ref":"Lightning.Helpers.html#url_safe_name/1"},{"type":"function","title":"Parameters - Lightning.Helpers.url_safe_name/1","doc":"- `name`: The string to convert. If `nil` is passed, it returns an empty string.","ref":"Lightning.Helpers.html#url_safe_name/1-parameters"},{"type":"function","title":"Examples - Lightning.Helpers.url_safe_name/1","doc":"iex> url_safe_name(\"My Project!!\")\n \"my-project\"\n\n iex> url_safe_name(nil)\n \"\"","ref":"Lightning.Helpers.html#url_safe_name/1-examples"},{"type":"module","title":"Lightning.Janitor","doc":"The Janitor is responsible for detecting runs that have been \"lost\" due to\ncommunication issues with the worker.\n\nEvery X minutes the Janitor will check to ensure that no runs have been\nrunning for more than Y seconds.\n\nConfigure your maximum run runtime with a WORKER_MAX_RUN_DURATION_SECONDS environment\nvariable; the grace period will be an additional 20%.","ref":"Lightning.Janitor.html"},{"type":"function","title":"Lightning.Janitor.find_and_update_lost/0","doc":"The find_and_update_lost function determines the current time, finds all\nruns that were claimed before the earliest allowable claim time for\nunfinished runs, and marks them as lost.","ref":"Lightning.Janitor.html#find_and_update_lost/0"},{"type":"function","title":"Lightning.Janitor.perform/1","doc":"The perform function takes an `%Oban.Job`, allowing this module to be invoked\nby the Oban cron plugin.","ref":"Lightning.Janitor.html#perform/1"},{"type":"module","title":"Lightning.KafkaTriggers","doc":"Contains the logic to manage kafka trigger and their associated pipelines.","ref":"Lightning.KafkaTriggers.html"},{"type":"function","title":"Lightning.KafkaTriggers.alternate_storage_file_name/2","doc":"","ref":"Lightning.KafkaTriggers.html#alternate_storage_file_name/2"},{"type":"function","title":"Lightning.KafkaTriggers.build_topic_partition_offset/1","doc":"Generate the key that is used to identify duplicate messages when used in\nassociation with the trigger id.","ref":"Lightning.KafkaTriggers.html#build_topic_partition_offset/1"},{"type":"function","title":"Lightning.KafkaTriggers.convert_rate_limit/0","doc":"","ref":"Lightning.KafkaTriggers.html#convert_rate_limit/0"},{"type":"function","title":"Lightning.KafkaTriggers.enable_disable_triggers/1","doc":"","ref":"Lightning.KafkaTriggers.html#enable_disable_triggers/1"},{"type":"function","title":"Lightning.KafkaTriggers.failure_notification_tracking_key/1","doc":"","ref":"Lightning.KafkaTriggers.html#failure_notification_tracking_key/1"},{"type":"function","title":"Lightning.KafkaTriggers.find_enabled_triggers/0","doc":"","ref":"Lightning.KafkaTriggers.html#find_enabled_triggers/0"},{"type":"function","title":"Lightning.KafkaTriggers.generate_pipeline_child_spec/1","doc":"Generate the child spec needed to start a `Pipeline` child process.","ref":"Lightning.KafkaTriggers.html#generate_pipeline_child_spec/1"},{"type":"function","title":"Lightning.KafkaTriggers.get_kafka_triggers_being_updated/1","doc":"","ref":"Lightning.KafkaTriggers.html#get_kafka_triggers_being_updated/1"},{"type":"function","title":"Lightning.KafkaTriggers.initial_policy/1","doc":"","ref":"Lightning.KafkaTriggers.html#initial_policy/1"},{"type":"function","title":"Lightning.KafkaTriggers.maybe_write_to_alternate_storage/2","doc":"","ref":"Lightning.KafkaTriggers.html#maybe_write_to_alternate_storage/2"},{"type":"function","title":"Lightning.KafkaTriggers.notify_users_of_trigger_failure/1","doc":"","ref":"Lightning.KafkaTriggers.html#notify_users_of_trigger_failure/1"},{"type":"function","title":"Lightning.KafkaTriggers.send_notification?/2","doc":"","ref":"Lightning.KafkaTriggers.html#send_notification?/2"},{"type":"function","title":"Lightning.KafkaTriggers.start_triggers/0","doc":"","ref":"Lightning.KafkaTriggers.html#start_triggers/0"},{"type":"function","title":"Lightning.KafkaTriggers.update_pipeline/2","doc":"","ref":"Lightning.KafkaTriggers.html#update_pipeline/2"},{"type":"module","title":"Lightning.KafkaTriggers.DuplicateTrackingCleanupWorker","doc":"Responsible for cleaning up stale TriggerKafkaMessageRecords entries.\nTriggerKafkaMessageRecords are used to deduplicate incoming messages from\na Kafka cluster.","ref":"Lightning.KafkaTriggers.DuplicateTrackingCleanupWorker.html"},{"type":"module","title":"Lightning.KafkaTriggers.EventListener","doc":"Listens for events related to Kafka triggers and updates the affected pipeline\nprocess by enabling, reloading or disabling it.","ref":"Lightning.KafkaTriggers.EventListener.html"},{"type":"function","title":"Lightning.KafkaTriggers.EventListener.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.KafkaTriggers.EventListener.html#child_spec/1"},{"type":"function","title":"Lightning.KafkaTriggers.EventListener.start_link/1","doc":"","ref":"Lightning.KafkaTriggers.EventListener.html#start_link/1"},{"type":"module","title":"Lightning.KafkaTriggers.MessageHandling","doc":"Contains the logic to persist a Kafka messages as a WorkOrder, Run and\nDataclip.","ref":"Lightning.KafkaTriggers.MessageHandling.html"},{"type":"function","title":"Lightning.KafkaTriggers.MessageHandling.convert_headers_for_serialisation/1","doc":"","ref":"Lightning.KafkaTriggers.MessageHandling.html#convert_headers_for_serialisation/1"},{"type":"function","title":"Lightning.KafkaTriggers.MessageHandling.persist_message/3","doc":"","ref":"Lightning.KafkaTriggers.MessageHandling.html#persist_message/3"},{"type":"module","title":"Lightning.KafkaTriggers.MessageRecovery","doc":"This module contains functionality to recover Kafka messages that have been\npersisted to the file system. It should only be used to process files that\noriginate from a trusted source (i.e. Lightning's Kafka pipeline.)\n\nIt expects to be pointed at a directory structure that looks as follows:\n\nbase_path\n|_ \n |_ _ _ _ .json\n |_ _ _ _ .json\n|_ \n\nThis is the structure that the Kafka pipeline will use when writing the\nmessages to the file system. After each message is successfully processed,\nthe file extension will be changed from `.json` to `json.recovered`. Recovered\nfiles will not be processed again. They are retained for the purposes of \ndouble-checking the recovery process and can be deleted once this has been\ndone.\n\nIf a file has not had the extension changed, this means that it experienced\nan error during reprocessing. These files can be reprocessed if you think the\nerror was transient. \n\nUsage: \n\n alias Lightning.KafkaTriggers.MessageRecovery\n case MessageRecovery.recover_messages(Lightning.Config.kafka_alternate_storage_file_path) do\n :ok -> # Success code\n {:error, error_count} -> # Failure code\n end","ref":"Lightning.KafkaTriggers.MessageRecovery.html"},{"type":"function","title":"Lightning.KafkaTriggers.MessageRecovery.build_broadway_message/2","doc":"","ref":"Lightning.KafkaTriggers.MessageRecovery.html#build_broadway_message/2"},{"type":"function","title":"Lightning.KafkaTriggers.MessageRecovery.extract_trigger_id/1","doc":"","ref":"Lightning.KafkaTriggers.MessageRecovery.html#extract_trigger_id/1"},{"type":"function","title":"Lightning.KafkaTriggers.MessageRecovery.recover_messages/1","doc":"","ref":"Lightning.KafkaTriggers.MessageRecovery.html#recover_messages/1"},{"type":"module","title":"Lightning.KafkaTriggers.Pipeline","doc":"Broadway pipeline that processes messages from Kafka clusters and persists\nthe received messages if they are not duplicating a previous message.","ref":"Lightning.KafkaTriggers.Pipeline.html"},{"type":"function","title":"Lightning.KafkaTriggers.Pipeline.maybe_notify_users/2","doc":"","ref":"Lightning.KafkaTriggers.Pipeline.html#maybe_notify_users/2"},{"type":"function","title":"Lightning.KafkaTriggers.Pipeline.start_link/1","doc":"","ref":"Lightning.KafkaTriggers.Pipeline.html#start_link/1"},{"type":"module","title":"Lightning.KafkaTriggers.PipelineSupervisor","doc":"Supervisor of the BroadwayKafka pipelines that are created for each enabled\nKafka trigger.","ref":"Lightning.KafkaTriggers.PipelineSupervisor.html"},{"type":"function","title":"Lightning.KafkaTriggers.PipelineSupervisor.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.KafkaTriggers.PipelineSupervisor.html#child_spec/1"},{"type":"function","title":"Lightning.KafkaTriggers.PipelineSupervisor.start_link/1","doc":"","ref":"Lightning.KafkaTriggers.PipelineSupervisor.html#start_link/1"},{"type":"module","title":"Lightning.KafkaTriggers.Supervisor","doc":"Starts all the processes needed to pull data from Kafka clusters and then\ngenerate work orders based on the messages received.","ref":"Lightning.KafkaTriggers.Supervisor.html"},{"type":"function","title":"Lightning.KafkaTriggers.Supervisor.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.KafkaTriggers.Supervisor.html#child_spec/1"},{"type":"function","title":"Lightning.KafkaTriggers.Supervisor.start_link/1","doc":"","ref":"Lightning.KafkaTriggers.Supervisor.html#start_link/1"},{"type":"module","title":"Lightning.KafkaTriggers.TriggerKafkaMessageRecord","doc":"Persists a lightweight represenattion of a message that has been recevied from\na Kafka cluster, for the purpose of deduplication.","ref":"Lightning.KafkaTriggers.TriggerKafkaMessageRecord.html"},{"type":"function","title":"Lightning.KafkaTriggers.TriggerKafkaMessageRecord.changeset/2","doc":"","ref":"Lightning.KafkaTriggers.TriggerKafkaMessageRecord.html#changeset/2"},{"type":"module","title":"Lightning.MetadataService","doc":"Retrieves metadata for a given credential and adaptor using the OpenFn CLI.","ref":"Lightning.MetadataService.html"},{"type":"function","title":"Lightning.MetadataService.fetch/2","doc":"Retrieve metadata for a given adaptor and credential.\n\nThe adaptor must be an npm specification.","ref":"Lightning.MetadataService.html#fetch/2"},{"type":"exception","title":"Lightning.MetadataService.Error","doc":"","ref":"Lightning.MetadataService.Error.html"},{"type":"function","title":"Lightning.MetadataService.Error.message/1","doc":"","ref":"Lightning.MetadataService.Error.html#message/1"},{"type":"function","title":"Lightning.MetadataService.Error.new/1","doc":"","ref":"Lightning.MetadataService.Error.html#new/1"},{"type":"type","title":"Lightning.MetadataService.Error.t/0","doc":"","ref":"Lightning.MetadataService.Error.html#t:t/0"},{"type":"module","title":"Lightning.Name","doc":"Generates a random names.","ref":"Lightning.Name.html"},{"type":"function","title":"Lightning.Name.generate/1","doc":"","ref":"Lightning.Name.html#generate/1"},{"type":"module","title":"Lightning.OauthClients","doc":"Manages operations for OAuth clients within the Lightning application, providing\nfunctions to create, retrieve, update, and delete OAuth clients, as well as managing\ntheir associations with projects and handling audit trails for changes.","ref":"Lightning.OauthClients.html"},{"type":"function","title":"Lightning.OauthClients.change_client/2","doc":"Prepares a changeset for creating or updating an OAuth client.","ref":"Lightning.OauthClients.html#change_client/2"},{"type":"function","title":"Parameters - Lightning.OauthClients.change_client/2","doc":"- client: The OAuth client struct.\n - attrs: Attributes to update in the client.","ref":"Lightning.OauthClients.html#change_client/2-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.change_client/2","doc":"- An Ecto.Changeset struct for the OAuth client.","ref":"Lightning.OauthClients.html#change_client/2-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.change_client/2","doc":"iex> change_client(%OauthClient{}, %{name: \"New Client\"})\n %Ecto.Changeset{...}","ref":"Lightning.OauthClients.html#change_client/2-examples"},{"type":"function","title":"Lightning.OauthClients.create_client/1","doc":"Creates a new OAuth client with the specified attributes.","ref":"Lightning.OauthClients.html#create_client/1"},{"type":"function","title":"Parameters - Lightning.OauthClients.create_client/1","doc":"- attrs: Map containing attributes for the new OAuth client.\n Required fields: `name`, `authorization_endpoint`, `token_endpoint`, `revocation_endpoint`, `client_id`, `client_secret`.","ref":"Lightning.OauthClients.html#create_client/1-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.create_client/1","doc":"- `{:ok, oauth_client}` if the client is created successfully.\n - `{:error, changeset}` if there is an error during creation due to validation failures or database issues.","ref":"Lightning.OauthClients.html#create_client/1-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.create_client/1","doc":"iex> create_client(%{name: \"New Client\"})\n {:ok, %OauthClient{}}\n\n iex> create_client(%{name: nil})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.OauthClients.html#create_client/1-examples"},{"type":"function","title":"Lightning.OauthClients.delete_client/1","doc":"Deletes an OAuth client and all associated data.","ref":"Lightning.OauthClients.html#delete_client/1"},{"type":"function","title":"Parameters - Lightning.OauthClients.delete_client/1","doc":"- client: The OauthClient to delete.","ref":"Lightning.OauthClients.html#delete_client/1-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.delete_client/1","doc":"- A tuple {:ok, oauth_client} if deletion is successful.\n- A tuple {:error, changeset} if deletion fails.","ref":"Lightning.OauthClients.html#delete_client/1-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.delete_client/1","doc":"iex> delete_client(client)\n {:ok, %OauthClient{}}\n\n iex> delete_client(client)\n {:error, %Ecto.Changeset{}}","ref":"Lightning.OauthClients.html#delete_client/1-examples"},{"type":"function","title":"Lightning.OauthClients.get_client!/1","doc":"Retrieves a single OAuth client by its ID, raising an error if not found.","ref":"Lightning.OauthClients.html#get_client!/1"},{"type":"function","title":"Parameters - Lightning.OauthClients.get_client!/1","doc":"- id: The ID of the OAuth client to retrieve.","ref":"Lightning.OauthClients.html#get_client!/1-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.get_client!/1","doc":"- The OAuth client struct.","ref":"Lightning.OauthClients.html#get_client!/1-returns"},{"type":"function","title":"Raises - Lightning.OauthClients.get_client!/1","doc":"- Ecto.NoResultsError if the OAuth client does not exist.","ref":"Lightning.OauthClients.html#get_client!/1-raises"},{"type":"function","title":"Examples - Lightning.OauthClients.get_client!/1","doc":"iex> get_client!(123)\n %OauthClient{}\n\n iex> get_client!(456)\n ** (Ecto.NoResultsError)","ref":"Lightning.OauthClients.html#get_client!/1-examples"},{"type":"function","title":"Lightning.OauthClients.list_clients/1","doc":"Retrieves all OAuth clients based on the given context, either a Project or a User.","ref":"Lightning.OauthClients.html#list_clients/1"},{"type":"function","title":"Parameters - Lightning.OauthClients.list_clients/1","doc":"- context: The Project or User struct to retrieve OAuth clients for.","ref":"Lightning.OauthClients.html#list_clients/1-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.list_clients/1","doc":"- A list of OAuth clients associated with the given Project or created by the given User.","ref":"Lightning.OauthClients.html#list_clients/1-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.list_clients/1","doc":"When given a Project:\n iex> list_clients(%Project{id: 1})\n [%OauthClient{project_id: 1}, %OauthClient{project_id: 1}]\n\n When given a User:\n iex> list_clients(%User{id: 123})\n [%OauthClient{user_id: 123}, %OauthClient{user_id: 123}]","ref":"Lightning.OauthClients.html#list_clients/1-examples"},{"type":"function","title":"Lightning.OauthClients.update_client/2","doc":"Updates an existing OAuth client with the specified attributes.","ref":"Lightning.OauthClients.html#update_client/2"},{"type":"function","title":"Parameters - Lightning.OauthClients.update_client/2","doc":"- client: The existing OauthClient to update.\n- attrs: A map of attributes to update.","ref":"Lightning.OauthClients.html#update_client/2-parameters"},{"type":"function","title":"Returns - Lightning.OauthClients.update_client/2","doc":"- A tuple {:ok, oauth_client} if update is successful.\n- A tuple {:error, changeset} if update fails.","ref":"Lightning.OauthClients.html#update_client/2-returns"},{"type":"function","title":"Examples - Lightning.OauthClients.update_client/2","doc":"iex> update_client(client, %{field: new_value})\n {:ok, %OauthClient{}}\n\n iex> update_client(client, %{field: bad_value})\n {:error, %Ecto.Changeset{}}","ref":"Lightning.OauthClients.html#update_client/2-examples"},{"type":"module","title":"Lightning.ObanManager","doc":"The Oban Manager","ref":"Lightning.ObanManager.html"},{"type":"function","title":"Lightning.ObanManager.handle_event/4","doc":"","ref":"Lightning.ObanManager.html#handle_event/4"},{"type":"module","title":"Lightning.Policies.Collections","doc":"The Bodyguard Policy module for Collections.\n\nAccess to collections is controlled by the project the collection belongs to.\n\nThe `access_collection` action is allowed if the user has access to the\nproject, or if a run belongs to the project (via it's workflow).","ref":"Lightning.Policies.Collections.html"},{"type":"function","title":"Lightning.Policies.Collections.authorize/3","doc":"","ref":"Lightning.Policies.Collections.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Collections.actions/0","doc":"","ref":"Lightning.Policies.Collections.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Dataclips","doc":"The Bodyguard Policy module for dataclips actions","ref":"Lightning.Policies.Dataclips.html"},{"type":"function","title":"Lightning.Policies.Dataclips.authorize/3","doc":"","ref":"Lightning.Policies.Dataclips.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Dataclips.actions/0","doc":"","ref":"Lightning.Policies.Dataclips.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Exports","doc":"The Bodyguard Policy module for Exports","ref":"Lightning.Policies.Exports.html"},{"type":"function","title":"Lightning.Policies.Exports.authorize/3","doc":"","ref":"Lightning.Policies.Exports.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Exports.actions/0","doc":"","ref":"Lightning.Policies.Exports.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Permissions","doc":"This module defines a unique interface managing authorizations in Lightning.\n\nUsers in Lightning have instance-wide and project-wide roles which determine their level of access to resources in the application. Fo rmore details see the [documentation](https://docs.openfn.org/documentation/about-lightning#roles-and-permissions).\n\nThese authorizations policies are all implemented under the `lib/lightning/policies` folder. In that folder you can find 3 files:\n- The `users.ex` file has all the policies for the instances wide access levels\n- The `project_users.ex` file has all the policies for the project wide access levels\n- The `permissions.ex` file defines the `Lightning.Policies.Permissions.can/4` interface. Which is a wrapper around the `Bodyguard.permit/4` function.\nWe use that interface to be able to harmonize the use of policies accross the entire app.\n\nAll the policies are tested in the `test/lightning/policies` folder. And the test are written in a way that allows the reader to quickly who can do what in the app.\n\nWe have two variants of the `Lightning.Policies.Permissions.can/4` interface:\n- `Lightning.Policies.Permissions.can(policy, action, actor, resource)` returns `:ok` if the actor can perform the action on the resource and `{:error, :unauthorized}` otherwise.\n- `Lightning.Policies.Permissions.can?(policy, action, actor, resource)` returns `true` if the actor can perform the action on the resource and `false` otherwise.\n\nHere is an example of how we the `Lightning.Policies.Permissions.can/4` interface to check if the a user can edit a job or not\n```elixir\ncan_edit_workflow = Lightning.Policies.ProjectUsers |> Lightning.Policies.Permissions.can?(:edit_workflow, socket.assigns.current_user, socket.assigns.project)\n\nif can_edit_workflow do\n # allow user to edit the workflow\nelse\n # quick user out\nend\n```","ref":"Lightning.Policies.Permissions.html"},{"type":"function","title":"Lightning.Policies.Permissions.can/4","doc":"checks if user has the permissions to apply action using some policy module\n\nReturns `:ok` if user can apply action and `{:error, :unauthorized}` otherwise","ref":"Lightning.Policies.Permissions.html#can/4"},{"type":"function","title":"Examples - Lightning.Policies.Permissions.can/4","doc":"iex> can(Lightning.Policies.Users, :create_workflow, user, project)\n :ok\n\n iex> can(Lightning.Policies.Users, :create_project, user, %{})\n {:error, :unauthorized}","ref":"Lightning.Policies.Permissions.html#can/4-examples"},{"type":"function","title":"Lightning.Policies.Permissions.can?/4","doc":"same as can/4 but returns `true` if user can apply action and `false` otherwise","ref":"Lightning.Policies.Permissions.html#can?/4"},{"type":"function","title":"Examples - Lightning.Policies.Permissions.can?/4","doc":"iex> can(Lightning.Policies.Users, :create_workflow, user, project)\n true\n\n iex> can(Lightning.Policies.Users, :create_project, user, %{})\n false","ref":"Lightning.Policies.Permissions.html#can?/4-examples"},{"type":"module","title":"Lightning.Policies.ProjectUsers","doc":"The Bodyguard Policy module for projects members roles.","ref":"Lightning.Policies.ProjectUsers.html"},{"type":"function","title":"Lightning.Policies.ProjectUsers.authorize/3","doc":"authorize/3 takes an action, a user, and a project. It checks the user's role\nfor this project and returns `true` if the user can perform the action in\nthat project and `false` if they cannot.\n\nNote that permissions are grouped by action, rather than by user role.\n\nWe deny by default, so if a user's role is not added to the allow roles list\nfor a particular action they are denied.","ref":"Lightning.Policies.ProjectUsers.html#authorize/3"},{"type":"type","title":"Lightning.Policies.ProjectUsers.actions/0","doc":"","ref":"Lightning.Policies.ProjectUsers.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Provisioning","doc":"The Bodyguard Policy module for users roles.","ref":"Lightning.Policies.Provisioning.html"},{"type":"function","title":"Lightning.Policies.Provisioning.authorize/3","doc":"authorize/3 takes an action, a user or a project repo connection, and a project. It checks the user's role\nfor this project and returns `true` if the user can perform the action and\nfalse if they cannot.\n\nNote that permissions are grouped by action.\n\nWe deny by default, so if a user's role is not added to the allow roles list\nfor a particular action they are denied.\n\nOnly a superuser can provision a new project.\n\nOwners and admins can update existing projects.","ref":"Lightning.Policies.Provisioning.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Provisioning.actions/0","doc":"","ref":"Lightning.Policies.Provisioning.html#t:actions/0"},{"type":"module","title":"Lightning.Policies.Users","doc":"The Bodyguard Policy module for users roles.","ref":"Lightning.Policies.Users.html"},{"type":"function","title":"Lightning.Policies.Users.authorize/3","doc":"authorize/3 takes an action, a user, and a project. It checks the user's role\nfor this project and returns `true` if the user can perform the action and\nfalse if they cannot.\n\nNote that permissions are grouped by action.\n\nWe deny by default, so if a user's role is not added to the allow roles list\nfor a particular action they are denied.","ref":"Lightning.Policies.Users.html#authorize/3"},{"type":"type","title":"Lightning.Policies.Users.actions/0","doc":"","ref":"Lightning.Policies.Users.html#t:actions/0"},{"type":"module","title":"Lightning.PromEx","doc":"Be sure to add the following to finish setting up PromEx:\n\n1. Update your configuration (config.exs, dev.exs, prod.exs, releases.exs, etc) to\n configure the necessary bit of PromEx. Be sure to check out `PromEx.Config` for\n more details regarding configuring PromEx:\n ```\n config :lightning, Lightning.PromEx,\n disabled: false,\n manual_metrics_start_delay: :no_delay,\n drop_metrics_groups: [],\n grafana: :disabled,\n metrics_server: :disabled\n ```\n\n2. Add this module to your application supervision tree. It should be one of the first\n things that is started so that no Telemetry events are missed. For example, if PromEx\n is started after your Repo module, you will miss Ecto's init events and the dashboards\n will be missing some data points:\n ```\n def start(_type, _args) do\n children = [\n Lightning.PromEx,\n\n ...\n ]\n\n ...\n end\n ```\n\n3. Update your `endpoint.ex` file to expose your metrics (or configure a standalone\n server using the `:metrics_server` config options). Be sure to put this plug before\n your `Plug.Telemetry` entry so that you can avoid having calls to your `/metrics`\n endpoint create their own metrics and logs which can pollute your logs/metrics given\n that Prometheus will scrape at a regular interval and that can get noisy:\n ```\n defmodule LightningWeb.Endpoint do\n use Phoenix.Endpoint, otp_app: :lightning\n\n ...\n\n plug PromEx.Plug, prom_ex_module: Lightning.PromEx\n\n ...\n end\n ```\n\n4. Update the list of plugins in the `plugins/0` function return list to reflect your\n application's dependencies. Also update the list of dashboards that are to be uploaded\n to Grafana in the `dashboards/0` function.","ref":"Lightning.PromEx.html"},{"type":"function","title":"Lightning.PromEx.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.PromEx.html#child_spec/1"},{"type":"module","title":"Lightning.Release","doc":"Used for executing DB release tasks when run in production without Mix\ninstalled.","ref":"Lightning.Release.html"},{"type":"function","title":"Lightning.Release.create_db/0","doc":"","ref":"Lightning.Release.html#create_db/0"},{"type":"function","title":"Lightning.Release.load_app/0","doc":"","ref":"Lightning.Release.html#load_app/0"},{"type":"function","title":"Lightning.Release.migrate/0","doc":"","ref":"Lightning.Release.html#migrate/0"},{"type":"function","title":"Lightning.Release.rollback/2","doc":"","ref":"Lightning.Release.html#rollback/2"},{"type":"module","title":"Lightning.Repo","doc":"","ref":"Lightning.Repo.html"},{"type":"function","title":"Lightning.Repo.aggregate/3","doc":"","ref":"Lightning.Repo.html#aggregate/3"},{"type":"function","title":"Lightning.Repo.aggregate/4","doc":"","ref":"Lightning.Repo.html#aggregate/4"},{"type":"function","title":"Lightning.Repo.all/2","doc":"","ref":"Lightning.Repo.html#all/2"},{"type":"function","title":"Lightning.Repo.checked_out?/0","doc":"","ref":"Lightning.Repo.html#checked_out?/0"},{"type":"function","title":"Lightning.Repo.checkout/2","doc":"","ref":"Lightning.Repo.html#checkout/2"},{"type":"function","title":"Lightning.Repo.child_spec/1","doc":"","ref":"Lightning.Repo.html#child_spec/1"},{"type":"function","title":"Lightning.Repo.config/0","doc":"","ref":"Lightning.Repo.html#config/0"},{"type":"function","title":"Lightning.Repo.default_options/1","doc":"","ref":"Lightning.Repo.html#default_options/1"},{"type":"function","title":"Lightning.Repo.delete/2","doc":"","ref":"Lightning.Repo.html#delete/2"},{"type":"function","title":"Lightning.Repo.delete!/2","doc":"","ref":"Lightning.Repo.html#delete!/2"},{"type":"function","title":"Lightning.Repo.delete_all/2","doc":"","ref":"Lightning.Repo.html#delete_all/2"},{"type":"function","title":"Lightning.Repo.disconnect_all/2","doc":"A convenience function for SQL-based repositories that forces all connections in the\npool to disconnect within the given interval.\n\nSee `Ecto.Adapters.SQL.disconnect_all/3` for more information.","ref":"Lightning.Repo.html#disconnect_all/2"},{"type":"function","title":"Lightning.Repo.exists?/2","doc":"","ref":"Lightning.Repo.html#exists?/2"},{"type":"function","title":"Lightning.Repo.explain/3","doc":"A convenience function for SQL-based repositories that executes an EXPLAIN statement or similar\ndepending on the adapter to obtain statistics for the given query.\n\nSee `Ecto.Adapters.SQL.explain/4` for more information.","ref":"Lightning.Repo.html#explain/3"},{"type":"function","title":"Lightning.Repo.get/3","doc":"","ref":"Lightning.Repo.html#get/3"},{"type":"function","title":"Lightning.Repo.get!/3","doc":"","ref":"Lightning.Repo.html#get!/3"},{"type":"function","title":"Lightning.Repo.get_by/3","doc":"","ref":"Lightning.Repo.html#get_by/3"},{"type":"function","title":"Lightning.Repo.get_by!/3","doc":"","ref":"Lightning.Repo.html#get_by!/3"},{"type":"function","title":"Lightning.Repo.get_dynamic_repo/0","doc":"","ref":"Lightning.Repo.html#get_dynamic_repo/0"},{"type":"function","title":"Lightning.Repo.in_transaction?/0","doc":"","ref":"Lightning.Repo.html#in_transaction?/0"},{"type":"function","title":"Lightning.Repo.insert/2","doc":"","ref":"Lightning.Repo.html#insert/2"},{"type":"function","title":"Lightning.Repo.insert!/2","doc":"","ref":"Lightning.Repo.html#insert!/2"},{"type":"function","title":"Lightning.Repo.insert_all/3","doc":"","ref":"Lightning.Repo.html#insert_all/3"},{"type":"function","title":"Lightning.Repo.insert_or_update/2","doc":"","ref":"Lightning.Repo.html#insert_or_update/2"},{"type":"function","title":"Lightning.Repo.insert_or_update!/2","doc":"","ref":"Lightning.Repo.html#insert_or_update!/2"},{"type":"function","title":"Lightning.Repo.load/2","doc":"","ref":"Lightning.Repo.html#load/2"},{"type":"function","title":"Lightning.Repo.one/2","doc":"","ref":"Lightning.Repo.html#one/2"},{"type":"function","title":"Lightning.Repo.one!/2","doc":"","ref":"Lightning.Repo.html#one!/2"},{"type":"function","title":"Lightning.Repo.paginate/2","doc":"","ref":"Lightning.Repo.html#paginate/2"},{"type":"function","title":"Lightning.Repo.preload/3","doc":"","ref":"Lightning.Repo.html#preload/3"},{"type":"function","title":"Lightning.Repo.prepare_query/3","doc":"","ref":"Lightning.Repo.html#prepare_query/3"},{"type":"function","title":"Lightning.Repo.put_dynamic_repo/1","doc":"","ref":"Lightning.Repo.html#put_dynamic_repo/1"},{"type":"function","title":"Lightning.Repo.query/3","doc":"A convenience function for SQL-based repositories that executes the given query.\n\nSee `Ecto.Adapters.SQL.query/4` for more information.","ref":"Lightning.Repo.html#query/3"},{"type":"function","title":"Lightning.Repo.query!/3","doc":"A convenience function for SQL-based repositories that executes the given query.\n\nSee `Ecto.Adapters.SQL.query!/4` for more information.","ref":"Lightning.Repo.html#query!/3"},{"type":"function","title":"Lightning.Repo.query_many/3","doc":"A convenience function for SQL-based repositories that executes the given multi-result query.\n\nSee `Ecto.Adapters.SQL.query_many/4` for more information.","ref":"Lightning.Repo.html#query_many/3"},{"type":"function","title":"Lightning.Repo.query_many!/3","doc":"A convenience function for SQL-based repositories that executes the given multi-result query.\n\nSee `Ecto.Adapters.SQL.query_many!/4` for more information.","ref":"Lightning.Repo.html#query_many!/3"},{"type":"function","title":"Lightning.Repo.reload/2","doc":"","ref":"Lightning.Repo.html#reload/2"},{"type":"function","title":"Lightning.Repo.reload!/2","doc":"","ref":"Lightning.Repo.html#reload!/2"},{"type":"function","title":"Lightning.Repo.rollback/1","doc":"","ref":"Lightning.Repo.html#rollback/1"},{"type":"function","title":"Lightning.Repo.scrivener_defaults/0","doc":"","ref":"Lightning.Repo.html#scrivener_defaults/0"},{"type":"function","title":"Lightning.Repo.start_link/1","doc":"","ref":"Lightning.Repo.html#start_link/1"},{"type":"function","title":"Lightning.Repo.stop/1","doc":"","ref":"Lightning.Repo.html#stop/1"},{"type":"function","title":"Lightning.Repo.stream/2","doc":"","ref":"Lightning.Repo.html#stream/2"},{"type":"function","title":"Lightning.Repo.to_sql/2","doc":"A convenience function for SQL-based repositories that translates the given query to SQL.\n\nSee `Ecto.Adapters.SQL.to_sql/3` for more information.","ref":"Lightning.Repo.html#to_sql/2"},{"type":"function","title":"Lightning.Repo.transact/2","doc":"A small wrapper around `Repo.transaction/2`.\n\nCommits the transaction if the lambda returns `:ok` or `{:ok, result}`,\nrolling it back if the lambda returns `:error` or `{:error, reason}`. In both\ncases, the function returns the result of the lambda.\n\nExample:\n\n Repo.transact(fn ->\n with {:ok, user} <- Accounts.create_user(params),\n {:ok, _log} <- Logs.log_action(:user_registered, user),\n {:ok, _job} <- Mailer.enqueue_email_confirmation(user) do\n {:ok, user}\n end\n end)\n\nFrom blog post found [here](https://tomkonidas.com/repo-transact/)","ref":"Lightning.Repo.html#transact/2"},{"type":"function","title":"Lightning.Repo.transaction/2","doc":"","ref":"Lightning.Repo.html#transaction/2"},{"type":"function","title":"Lightning.Repo.update/2","doc":"","ref":"Lightning.Repo.html#update/2"},{"type":"function","title":"Lightning.Repo.update!/2","doc":"","ref":"Lightning.Repo.html#update!/2"},{"type":"function","title":"Lightning.Repo.update_all/3","doc":"","ref":"Lightning.Repo.html#update_all/3"},{"type":"module","title":"Lightning.Run","doc":"Ecto model for Runs.","ref":"Lightning.Run.html"},{"type":"function","title":"Lightning.Run.add_options/2","doc":"Adds options (project-level logging options, resource limits such as timeout\nand memory usage, etc.) to the run before storing in the DB.","ref":"Lightning.Run.html#add_options/2"},{"type":"function","title":"Lightning.Run.complete/2","doc":"","ref":"Lightning.Run.html#complete/2"},{"type":"macro","title":"Lightning.Run.final_states/0","doc":"Returns the list of final states for a run.","ref":"Lightning.Run.html#final_states/0"},{"type":"function","title":"Lightning.Run.for/2","doc":"","ref":"Lightning.Run.html#for/2"},{"type":"function","title":"Lightning.Run.new/1","doc":"","ref":"Lightning.Run.html#new/1"},{"type":"function","title":"Lightning.Run.start/2","doc":"","ref":"Lightning.Run.html#start/2"},{"type":"type","title":"Lightning.Run.t/0","doc":"","ref":"Lightning.Run.html#t:t/0"},{"type":"module","title":"Lightning.RunStep","doc":"Ecto model for an the Steps in a Run.","ref":"Lightning.RunStep.html"},{"type":"function","title":"Lightning.RunStep.new/1","doc":"","ref":"Lightning.RunStep.html#new/1"},{"type":"function","title":"Lightning.RunStep.new/2","doc":"","ref":"Lightning.RunStep.html#new/2"},{"type":"type","title":"Lightning.RunStep.t/0","doc":"","ref":"Lightning.RunStep.html#t:t/0"},{"type":"module","title":"Lightning.SafetyString","doc":"Utilities for securely encoding serializable structs, lists and strings into\nURL-safe strings.\n\nIn order to pass the state around in a URL, in a manner that protects\nsecrets from leaking - and allows us to avoid persistance\nwe take a set of parameters and:\n\n- Encode into a URI query string\n- gzip it to save characters\n- encrypt the string\n- base64 encode it for URI encoding safety","ref":"Lightning.SafetyString.html"},{"type":"function","title":"Lightning.SafetyString.decode/1","doc":"","ref":"Lightning.SafetyString.html#decode/1"},{"type":"function","title":"Lightning.SafetyString.encode/1","doc":"","ref":"Lightning.SafetyString.html#encode/1"},{"type":"module","title":"Lightning.Schema","doc":"Defines the database schema and primary key type for Thunderbolt schemas.","ref":"Lightning.Schema.html"},{"type":"module","title":"Lightning.Scrubber","doc":"Process used to scrub strings of sensitive information.\n\nCan be started via `start_link/1`.\n\n```\n{:ok, scrubber} =\n Lightning.Scrubber.start_link(\n samples:\n Lightning.Credentials.sensitive_values_for(credential)\n )\n```\n\nTakes an optional `:name` key, in case you need to name the process.","ref":"Lightning.Scrubber.html"},{"type":"function","title":"Lightning.Scrubber.add_samples/3","doc":"","ref":"Lightning.Scrubber.html#add_samples/3"},{"type":"function","title":"Lightning.Scrubber.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.Scrubber.html#child_spec/1"},{"type":"function","title":"Lightning.Scrubber.encode_samples/2","doc":"Prepare a list of sensitive samples (strings) into a potentially bigger list\ncomposed of variations a sample may appear.","ref":"Lightning.Scrubber.html#encode_samples/2"},{"type":"function","title":"Lightning.Scrubber.samples/1","doc":"","ref":"Lightning.Scrubber.html#samples/1"},{"type":"function","title":"Lightning.Scrubber.scrub/2","doc":"","ref":"Lightning.Scrubber.html#scrub/2"},{"type":"function","title":"Lightning.Scrubber.start_link/1","doc":"","ref":"Lightning.Scrubber.html#start_link/1"},{"type":"module","title":"Lightning.Services.AccountHook","doc":"Allows handling user creation or registration atomically without relying on async events.","ref":"Lightning.Services.AccountHook.html"},{"type":"function","title":"Lightning.Services.AccountHook.handle_create_user/1","doc":"","ref":"Lightning.Services.AccountHook.html#handle_create_user/1"},{"type":"function","title":"Lightning.Services.AccountHook.handle_register_superuser/1","doc":"","ref":"Lightning.Services.AccountHook.html#handle_register_superuser/1"},{"type":"function","title":"Lightning.Services.AccountHook.handle_register_user/1","doc":"","ref":"Lightning.Services.AccountHook.html#handle_register_user/1"},{"type":"module","title":"Lightning.Services.AdapterHelper","doc":"Maps the module to be used for the extension service.","ref":"Lightning.Services.AdapterHelper.html"},{"type":"function","title":"Lightning.Services.AdapterHelper.adapter/1","doc":"","ref":"Lightning.Services.AdapterHelper.html#adapter/1"},{"type":"module","title":"Lightning.Services.ProjectHook","doc":"Allows handling project creation atomically without relying on async events.","ref":"Lightning.Services.ProjectHook.html"},{"type":"function","title":"Lightning.Services.ProjectHook.handle_create_project/1","doc":"","ref":"Lightning.Services.ProjectHook.html#handle_create_project/1"},{"type":"function","title":"Lightning.Services.ProjectHook.handle_delete_project/1","doc":"","ref":"Lightning.Services.ProjectHook.html#handle_delete_project/1"},{"type":"function","title":"Lightning.Services.ProjectHook.handle_project_validation/1","doc":"","ref":"Lightning.Services.ProjectHook.html#handle_project_validation/1"},{"type":"module","title":"Lightning.Services.RateLimiter","doc":"Adapter to call the extension for rate limiting.","ref":"Lightning.Services.RateLimiter.html"},{"type":"module","title":"Lightning.Services.RunQueue","doc":"Adapter to call the extension for selecting Runtime workloads.","ref":"Lightning.Services.RunQueue.html"},{"type":"module","title":"Lightning.Services.UsageLimiter","doc":"Adapter to call the extension for limiting Runtime workloads.","ref":"Lightning.Services.UsageLimiter.html"},{"type":"module","title":"Lightning.Setup","doc":"Demo encapsulates logic for setting up a demonstration site.","ref":"Lightning.Setup.html"},{"type":"function","title":"Lightning.Setup.ensure_minimum_setup/0","doc":"Set up the bare minimum so that commands can be executed against the repo.","ref":"Lightning.Setup.html#ensure_minimum_setup/0"},{"type":"function","title":"Lightning.Setup.setup_user/3","doc":"This makes it possible to run setup_user as an external command\n\nSee: Lightning.SetupUtils.setup_user() for more docs.","ref":"Lightning.Setup.html#setup_user/3"},{"type":"function","title":"Examples - Lightning.Setup.setup_user/3","doc":"iex> kubectl exec -it deploy/demo-web -- /app/bin/lightning eval Lightning.Setup.setup_user(%{email: \"td@openfn.org\", first_name: \"taylor\", last_name: \"downs\", password: \"shh12345!\"})\n :ok","ref":"Lightning.Setup.html#setup_user/3-examples"},{"type":"module","title":"Lightning.SetupUtils","doc":"SetupUtils encapsulates logic for setting up initial data for various sites.","ref":"Lightning.SetupUtils.html"},{"type":"function","title":"Lightning.SetupUtils.confirm_users/1","doc":"","ref":"Lightning.SetupUtils.html#confirm_users/1"},{"type":"function","title":"Lightning.SetupUtils.create_dhis2_project/1","doc":"","ref":"Lightning.SetupUtils.html#create_dhis2_project/1"},{"type":"function","title":"Lightning.SetupUtils.create_openhie_project/1","doc":"","ref":"Lightning.SetupUtils.html#create_openhie_project/1"},{"type":"function","title":"Lightning.SetupUtils.create_starter_project/2","doc":"","ref":"Lightning.SetupUtils.html#create_starter_project/2"},{"type":"function","title":"Lightning.SetupUtils.create_users/1","doc":"","ref":"Lightning.SetupUtils.html#create_users/1"},{"type":"function","title":"Lightning.SetupUtils.setup_demo/1","doc":"Creates initial data and returns the created records.","ref":"Lightning.SetupUtils.html#setup_demo/1"},{"type":"function","title":"Lightning.SetupUtils.setup_user/3","doc":"In some (mostly remote-controlled) deployments, it's necessary to create a\nuser, and apiToken, and multiple credentials (owned by the user) so that later\n`openfn deploy` calls can make use of these artifacts.\n\nWhen run _before_ `openfn deploy`, this function makes it possible to set up\nan entire lightning instance with a working project (including secrets)\nwithout using the web UI.","ref":"Lightning.SetupUtils.html#setup_user/3"},{"type":"function","title":"Examples - Lightning.SetupUtils.setup_user/3","doc":"iex> setup_user(%{email: \"td@openfn.org\", first_name: \"taylor\", last_name: \"downs\", password: \"shh12345!\"}, \"secretToken\", [%{name: \"openmrs\", schema: \"raw\", body: %{\"a\" => \"secret\"}}, %{ name: \"dhis2\", schema: \"raw\", body: %{\"b\" => \"safe\"}}])\n :ok","ref":"Lightning.SetupUtils.html#setup_user/3-examples"},{"type":"function","title":"Lightning.SetupUtils.tear_down/1","doc":"","ref":"Lightning.SetupUtils.html#tear_down/1"},{"type":"module","title":"Lightning.SetupUtils.Ticker","doc":"Time ticker to assure time progress/sequence specially for multiple logs.","ref":"Lightning.SetupUtils.Ticker.html"},{"type":"function","title":"Lightning.SetupUtils.Ticker.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.SetupUtils.Ticker.html#child_spec/1"},{"type":"function","title":"Lightning.SetupUtils.Ticker.next/1","doc":"","ref":"Lightning.SetupUtils.Ticker.html#next/1"},{"type":"function","title":"Lightning.SetupUtils.Ticker.start_link/1","doc":"","ref":"Lightning.SetupUtils.Ticker.html#start_link/1"},{"type":"function","title":"Lightning.SetupUtils.Ticker.stop/1","doc":"","ref":"Lightning.SetupUtils.Ticker.html#stop/1"},{"type":"module","title":"Lightning.Storage","doc":"The external storage module.\n\nThis module is responsible for storing and retrieving files from the\nconfigured storage backend.","ref":"Lightning.Storage.html"},{"type":"behaviour","title":"Lightning.Storage.Backend","doc":"The behaviour for storage backends.","ref":"Lightning.Storage.Backend.html"},{"type":"callback","title":"Lightning.Storage.Backend.get_url/1","doc":"","ref":"Lightning.Storage.Backend.html#c:get_url/1"},{"type":"callback","title":"Lightning.Storage.Backend.store/2","doc":"","ref":"Lightning.Storage.Backend.html#c:store/2"},{"type":"module","title":"Lightning.Storage.GCS","doc":"A storage backend module for handling file storage in Google Cloud Storage (GCS).\n\nIt implements the `Lightning.Storage.Backend` behaviour to manage file storage operations in Google Cloud Storage. This includes storing files to GCS buckets and generating signed URLs for secure access to the stored files.","ref":"Lightning.Storage.GCS.html"},{"type":"module","title":"Responsibilities - Lightning.Storage.GCS","doc":"- **Storing Files**: The `store/2` function uploads files from a local source path to a specified destination path within a GCS bucket.\n- **Generating Signed URLs**: The `get_url/1` function generates a signed URL for accessing a file stored in GCS. This signed URL is valid for a limited time (default 1 hour).\n- **Configuration**: The module relies on application configuration to determine the GCS bucket and Google API connection settings.","ref":"Lightning.Storage.GCS.html#module-responsibilities"},{"type":"module","title":"Example Usage - Lightning.Storage.GCS","doc":"```elixir\n# Store a file in GCS\nLightning.Storage.GCS.store(\"/path/to/source\", \"destination/path\")\n\n# Get a signed URL for the stored file\n{:ok, url} = Lightning.Storage.GCS.get_url(\"destination/path\")\n```","ref":"Lightning.Storage.GCS.html#module-example-usage"},{"type":"module","title":"Lightning.Storage.Local","doc":"A storage backend module for handling local file storage.\n\nIt implements the `Lightning.Storage.Backend` behaviour to manage file storage\noperations on the local file system. This includes storing files from a source\npath to a destination path and generating URLs for accessing stored files.","ref":"Lightning.Storage.Local.html"},{"type":"module","title":"Responsibilities - Lightning.Storage.Local","doc":"- **Storing Files**: The `store/2` function is responsible for copying files\n from a given source path to a specified destination path on the local file\n system.\n- **Generating URLs**: The `get_url/1` function generates a `file://` URL for\n accessing a stored file locally.\n- **Configuration**: The module relies on application configuration to\n determine the root directory for storage operations.","ref":"Lightning.Storage.Local.html#module-responsibilities"},{"type":"module","title":"Example Usage - Lightning.Storage.Local","doc":"```elixir\n# Store a file\n{:ok, filename} =\n Lightning.Storage.Local.store(\"/path/to/source\", \"destination/path\")\n\n# Get the URL for the stored file\n{:ok, url} = Lightning.Storage.Local.get_url(\"destination/path\")\n```","ref":"Lightning.Storage.Local.html#module-example-usage"},{"type":"module","title":"Lightning.Storage.ProjectFileDefinition","doc":"This module provides functionality for managing the storage and retrieval of project files.\n\n It handles operations related to storing project files, generating URLs for accessing these files, and constructing storage paths for exported files. It serves as an abstraction layer over the underlying storage mechanism provided by the `Lightning.Storage` module.","ref":"Lightning.Storage.ProjectFileDefinition.html"},{"type":"module","title":"Functions - Lightning.Storage.ProjectFileDefinition","doc":"- `store/2`: Stores a file from a given source path into the storage system based on the file's path.\n - `get_url/1`: Retrieves the URL for accessing a stored file.\n - `storage_path_for_exports/2`: Constructs a storage path for exported files, defaulting to a `.zip` extension.","ref":"Lightning.Storage.ProjectFileDefinition.html#module-functions"},{"type":"module","title":"Example Usage - Lightning.Storage.ProjectFileDefinition","doc":"```elixir\n # Store a file\n Lightning.Storage.ProjectFileDefinition.store(\"/path/to/source\", project_file)\n\n # Get a URL for the stored file\n url = Lightning.Storage.ProjectFileDefinition.get_url(project_file)\n\n # Get the storage path for an exported file\n path = Lightning.Storage.ProjectFileDefinition.storage_path_for_exports(project_file)\n ```","ref":"Lightning.Storage.ProjectFileDefinition.html#module-example-usage"},{"type":"function","title":"Lightning.Storage.ProjectFileDefinition.get_url/1","doc":"","ref":"Lightning.Storage.ProjectFileDefinition.html#get_url/1"},{"type":"function","title":"Lightning.Storage.ProjectFileDefinition.storage_path_for_exports/2","doc":"","ref":"Lightning.Storage.ProjectFileDefinition.html#storage_path_for_exports/2"},{"type":"function","title":"Lightning.Storage.ProjectFileDefinition.store/2","doc":"","ref":"Lightning.Storage.ProjectFileDefinition.html#store/2"},{"type":"module","title":"Lightning.TaskWorker","doc":"A TaskWorker with concurrency limits.\n\nA simple concurrency limiter that wraps `Task.Supervisor`, which already does\nhave the ability to specify `max_children`; it throws an error when\nthat limit is exceeded.\n\nTo use it, start it like any other process; ideally in your supervision tree.\n\n```\n ...,\n {Lightning.TaskWorker, name: :cli_task_worker, max_tasks: 4}\n```\n\n**Options**\n\n- `:max_tasks` Defaults to the number of system schedulers available to the vm.","ref":"Lightning.TaskWorker.html"},{"type":"function","title":"Lightning.TaskWorker.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.TaskWorker.html#child_spec/1"},{"type":"function","title":"Lightning.TaskWorker.get_status/1","doc":"","ref":"Lightning.TaskWorker.html#get_status/1"},{"type":"function","title":"Lightning.TaskWorker.start_link/1","doc":"","ref":"Lightning.TaskWorker.html#start_link/1"},{"type":"function","title":"Lightning.TaskWorker.start_task/2","doc":"","ref":"Lightning.TaskWorker.html#start_task/2"},{"type":"module","title":"Lightning.Tokens","doc":"Token generation, verification and validation.","ref":"Lightning.Tokens.html"},{"type":"function","title":"Lightning.Tokens.get_subject/1","doc":"Get the subject of a token.\nCurrently support RunTokens and PersonalAccessTokens,\nwhich return `Lightning.Run`s and `Lightning.Accounts.User`s respectively.","ref":"Lightning.Tokens.html#get_subject/1"},{"type":"function","title":"Lightning.Tokens.verify/1","doc":"Verify a token and return the claims if successful.\n\nThis serves as a central point to verify and validate different types\nof tokens.","ref":"Lightning.Tokens.html#verify/1"},{"type":"module","title":"Lightning.UsageTracking","doc":"The UsageTracking context.","ref":"Lightning.UsageTracking.html"},{"type":"function","title":"Lightning.UsageTracking.disable_daily_report/0","doc":"","ref":"Lightning.UsageTracking.html#disable_daily_report/0"},{"type":"function","title":"Lightning.UsageTracking.enable_daily_report/1","doc":"","ref":"Lightning.UsageTracking.html#enable_daily_report/1"},{"type":"function","title":"Lightning.UsageTracking.enqueue_reports/3","doc":"","ref":"Lightning.UsageTracking.html#enqueue_reports/3"},{"type":"function","title":"Lightning.UsageTracking.find_enabled_daily_report_config/0","doc":"","ref":"Lightning.UsageTracking.html#find_enabled_daily_report_config/0"},{"type":"function","title":"Lightning.UsageTracking.insert_report/3","doc":"","ref":"Lightning.UsageTracking.html#insert_report/3"},{"type":"function","title":"Lightning.UsageTracking.lightning_version/0","doc":"","ref":"Lightning.UsageTracking.html#lightning_version/0"},{"type":"function","title":"Lightning.UsageTracking.reportable_dates/3","doc":"","ref":"Lightning.UsageTracking.html#reportable_dates/3"},{"type":"function","title":"Lightning.UsageTracking.start_reporting_after/1","doc":"","ref":"Lightning.UsageTracking.html#start_reporting_after/1"},{"type":"function","title":"Lightning.UsageTracking.submit_report/2","doc":"","ref":"Lightning.UsageTracking.html#submit_report/2"},{"type":"function","title":"Lightning.UsageTracking.update_report_submission!/2","doc":"","ref":"Lightning.UsageTracking.html#update_report_submission!/2"},{"type":"module","title":"Lightning.UsageTracking.Client","doc":"Client for Usage Tracker service","ref":"Lightning.UsageTracking.Client.html"},{"type":"function","title":"Lightning.UsageTracking.Client.reachable?/1","doc":"","ref":"Lightning.UsageTracking.Client.html#reachable?/1"},{"type":"function","title":"Lightning.UsageTracking.Client.submit_metrics/2","doc":"","ref":"Lightning.UsageTracking.Client.html#submit_metrics/2"},{"type":"module","title":"Lightning.UsageTracking.DailyReportConfiguration","doc":"Configuration for the creation of daily reports","ref":"Lightning.UsageTracking.DailyReportConfiguration.html"},{"type":"function","title":"Lightning.UsageTracking.DailyReportConfiguration.changeset/2","doc":"","ref":"Lightning.UsageTracking.DailyReportConfiguration.html#changeset/2"},{"type":"module","title":"Lightning.UsageTracking.DayWorker","doc":"Worker to manage per-day report generation","ref":"Lightning.UsageTracking.DayWorker.html"},{"type":"module","title":"Lightning.UsageTracking.GithubClient","doc":"A github client to make unauthenticated HTTP requests to Github.","ref":"Lightning.UsageTracking.GithubClient.html"},{"type":"function","title":"Lightning.UsageTracking.GithubClient.build_client/1","doc":"","ref":"Lightning.UsageTracking.GithubClient.html#build_client/1"},{"type":"function","title":"Lightning.UsageTracking.GithubClient.open_fn_commit?/1","doc":"","ref":"Lightning.UsageTracking.GithubClient.html#open_fn_commit?/1"},{"type":"module","title":"Lightning.UsageTracking.ProjectMetricsService","doc":"Builds project-related metrics.","ref":"Lightning.UsageTracking.ProjectMetricsService.html"},{"type":"function","title":"Lightning.UsageTracking.ProjectMetricsService.find_eligible_projects/1","doc":"","ref":"Lightning.UsageTracking.ProjectMetricsService.html#find_eligible_projects/1"},{"type":"function","title":"Lightning.UsageTracking.ProjectMetricsService.generate_metrics/3","doc":"","ref":"Lightning.UsageTracking.ProjectMetricsService.html#generate_metrics/3"},{"type":"module","title":"Lightning.UsageTracking.Report","doc":"Report submitted to Usage Tracker","ref":"Lightning.UsageTracking.Report.html"},{"type":"function","title":"Lightning.UsageTracking.Report.changeset/2","doc":"","ref":"Lightning.UsageTracking.Report.html#changeset/2"},{"type":"module","title":"Lightning.UsageTracking.ReportData","doc":"Builds data set for submission to Usage Tracker","ref":"Lightning.UsageTracking.ReportData.html"},{"type":"function","title":"Lightning.UsageTracking.ReportData.generate/3","doc":"","ref":"Lightning.UsageTracking.ReportData.html#generate/3"},{"type":"module","title":"Lightning.UsageTracking.ReportWorker","doc":"Worker to generate report for given day","ref":"Lightning.UsageTracking.ReportWorker.html"},{"type":"module","title":"Lightning.UsageTracking.ResponseProcessor","doc":"Utility module to abstract dealing with some of the Tesla plumbing","ref":"Lightning.UsageTracking.ResponseProcessor.html"},{"type":"function","title":"Lightning.UsageTracking.ResponseProcessor.successful?/1","doc":"","ref":"Lightning.UsageTracking.ResponseProcessor.html#successful?/1"},{"type":"function","title":"Lightning.UsageTracking.ResponseProcessor.successful_200?/1","doc":"","ref":"Lightning.UsageTracking.ResponseProcessor.html#successful_200?/1"},{"type":"module","title":"Lightning.UsageTracking.ResubmissionCandidatesWorker","doc":"Worker to find reports that have failed submissions and enqueue jobs to\nreprocess them.","ref":"Lightning.UsageTracking.ResubmissionCandidatesWorker.html"},{"type":"module","title":"Lightning.UsageTracking.ResubmissionWorker","doc":"Worker to resubmit report that has failed submission.","ref":"Lightning.UsageTracking.ResubmissionWorker.html"},{"type":"module","title":"Lightning.UsageTracking.RunService","doc":"Supports the generation of metrics related to runs and steps.","ref":"Lightning.UsageTracking.RunService.html"},{"type":"function","title":"Lightning.UsageTracking.RunService.finished_runs/2","doc":"","ref":"Lightning.UsageTracking.RunService.html#finished_runs/2"},{"type":"function","title":"Lightning.UsageTracking.RunService.finished_steps/2","doc":"","ref":"Lightning.UsageTracking.RunService.html#finished_steps/2"},{"type":"function","title":"Lightning.UsageTracking.RunService.unique_job_ids/2","doc":"","ref":"Lightning.UsageTracking.RunService.html#unique_job_ids/2"},{"type":"module","title":"Lightning.UsageTracking.UserQueries","doc":"Contains queries used to determine user-related metrics.","ref":"Lightning.UsageTracking.UserQueries.html"},{"type":"function","title":"Lightning.UsageTracking.UserQueries.active_users/1","doc":"","ref":"Lightning.UsageTracking.UserQueries.html#active_users/1"},{"type":"function","title":"Lightning.UsageTracking.UserQueries.active_users/2","doc":"","ref":"Lightning.UsageTracking.UserQueries.html#active_users/2"},{"type":"function","title":"Lightning.UsageTracking.UserQueries.existing_users/1","doc":"","ref":"Lightning.UsageTracking.UserQueries.html#existing_users/1"},{"type":"function","title":"Lightning.UsageTracking.UserQueries.existing_users/2","doc":"","ref":"Lightning.UsageTracking.UserQueries.html#existing_users/2"},{"type":"module","title":"Lightning.UsageTracking.UserService","doc":"Returns counts for the various user-related metrics.","ref":"Lightning.UsageTracking.UserService.html"},{"type":"function","title":"Lightning.UsageTracking.UserService.no_of_active_users/1","doc":"","ref":"Lightning.UsageTracking.UserService.html#no_of_active_users/1"},{"type":"function","title":"Lightning.UsageTracking.UserService.no_of_active_users/2","doc":"","ref":"Lightning.UsageTracking.UserService.html#no_of_active_users/2"},{"type":"function","title":"Lightning.UsageTracking.UserService.no_of_users/1","doc":"","ref":"Lightning.UsageTracking.UserService.html#no_of_users/1"},{"type":"function","title":"Lightning.UsageTracking.UserService.no_of_users/2","doc":"","ref":"Lightning.UsageTracking.UserService.html#no_of_users/2"},{"type":"module","title":"Lightning.UsageTracking.WorkflowMetricsService","doc":"Builds workflow-related metrics.","ref":"Lightning.UsageTracking.WorkflowMetricsService.html"},{"type":"function","title":"Lightning.UsageTracking.WorkflowMetricsService.find_eligible_workflows/2","doc":"","ref":"Lightning.UsageTracking.WorkflowMetricsService.html#find_eligible_workflows/2"},{"type":"function","title":"Lightning.UsageTracking.WorkflowMetricsService.generate_metrics/3","doc":"","ref":"Lightning.UsageTracking.WorkflowMetricsService.html#generate_metrics/3"},{"type":"module","title":"Lightning.Utils.Crypto","doc":"Utility functions for cryptographic operations.","ref":"Lightning.Utils.Crypto.html"},{"type":"function","title":"Lightning.Utils.Crypto.generate_hs256_key/0","doc":"Generates a new HS256 key.","ref":"Lightning.Utils.Crypto.html#generate_hs256_key/0"},{"type":"function","title":"Lightning.Utils.Crypto.generate_rsa_key_pair/0","doc":"Generates a new RSA key pair with 2048 bits and a public exponent of 65537.\n\nThis is preferable to using `create_private_key` and `abstract_public_key` as\nit generates a key pair in one step, and also doesn't require shelling out to\n`openssl`.","ref":"Lightning.Utils.Crypto.html#generate_rsa_key_pair/0"},{"type":"module","title":"Lightning.Validators","doc":"Extra validators for Ecto.Changeset.","ref":"Lightning.Validators.html"},{"type":"function","title":"Lightning.Validators.validate_exclusive/3","doc":"Validate that only one of the fields is set at a time.\n\nExample:\n\n```\nchangeset\n|> validate_exclusive(\n [:source_job_id, :source_trigger_id],\n \"source_job_id and source_trigger_id are mutually exclusive\"\n)\n```","ref":"Lightning.Validators.html#validate_exclusive/3"},{"type":"function","title":"Lightning.Validators.validate_one_required/3","doc":"Validate that at least one of the fields is set.","ref":"Lightning.Validators.html#validate_one_required/3"},{"type":"function","title":"Lightning.Validators.validate_required_assoc/3","doc":"Validate that an association is present\n\n> **NOTE**\n> This should only be used when using `put_assoc`, not `cast_assoc`.\n> `cast_assoc` provides a `required: true` option.\n> Unlike `validate_required`, this does not add the field to the `required`\n> list in the schema.","ref":"Lightning.Validators.html#validate_required_assoc/3"},{"type":"function","title":"Lightning.Validators.validate_url/2","doc":"Validates a URL in a changeset field.\n\nEnsures that the URL:\n- Has a valid `http` or `https` scheme.\n- Has a valid host (domain name, IPv4, or IPv6).\n- The host is not blank and does not exceed 255 characters.\n\nReturns a changeset error for invalid URLs.","ref":"Lightning.Validators.html#validate_url/2"},{"type":"module","title":"Lightning.Vault","doc":"Module for handling the encryption and decryption of database fields.","ref":"Lightning.Vault.html"},{"type":"function","title":"Lightning.Vault.child_spec/1","doc":"Returns a specification to start this module under a supervisor.\n\nSee `Supervisor`.","ref":"Lightning.Vault.html#child_spec/1"},{"type":"function","title":"Lightning.Vault.start_link/1","doc":"","ref":"Lightning.Vault.html#start_link/1"},{"type":"module","title":"Lightning.VersionControl","doc":"Boundary module for handling Version control activities for project, jobs\nworkflows etc\nUse this module to create, modify and delete connections as well\nas running any associated sync jobs","ref":"Lightning.VersionControl.html"},{"type":"function","title":"Lightning.VersionControl.create_github_connection/2","doc":"Creates a connection between a project and a github repo","ref":"Lightning.VersionControl.html#create_github_connection/2"},{"type":"function","title":"Lightning.VersionControl.delete_github_oauth_grant/1","doc":"Deletes the authorization for the github app and updates the user details accordingly","ref":"Lightning.VersionControl.html#delete_github_oauth_grant/1"},{"type":"function","title":"Lightning.VersionControl.exchange_code_for_oauth_token/1","doc":"Fetches the oauth access token using the code received from the callback url\nFor more info: https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app","ref":"Lightning.VersionControl.html#exchange_code_for_oauth_token/1"},{"type":"function","title":"Lightning.VersionControl.fetch_installation_repos/1","doc":"","ref":"Lightning.VersionControl.html#fetch_installation_repos/1"},{"type":"function","title":"Lightning.VersionControl.fetch_repo_branches/2","doc":"","ref":"Lightning.VersionControl.html#fetch_repo_branches/2"},{"type":"function","title":"Lightning.VersionControl.fetch_user_access_token/1","doc":"Fecthes the access token for the given `User`.\nIf the access token has expired, it `refreshes` the token and updates the `User` column accordingly","ref":"Lightning.VersionControl.html#fetch_user_access_token/1"},{"type":"function","title":"Lightning.VersionControl.fetch_user_installations/1","doc":"","ref":"Lightning.VersionControl.html#fetch_user_installations/1"},{"type":"function","title":"Lightning.VersionControl.get_repo_connection_for_project/1","doc":"","ref":"Lightning.VersionControl.html#get_repo_connection_for_project/1"},{"type":"function","title":"Lightning.VersionControl.get_repo_connection_for_token/1","doc":"","ref":"Lightning.VersionControl.html#get_repo_connection_for_token/1"},{"type":"function","title":"Lightning.VersionControl.github_enabled?/0","doc":"","ref":"Lightning.VersionControl.html#github_enabled?/0"},{"type":"function","title":"Lightning.VersionControl.initiate_sync/2","doc":"","ref":"Lightning.VersionControl.html#initiate_sync/2"},{"type":"function","title":"Lightning.VersionControl.oauth_token_valid?/1","doc":"Checks if the given token has expired.\nGithub supports access tokens that expire and those that don't.\nIf the `access token` expires, then a `refresh token` is also availed.\nThis function simply checks if the token has a `refresh_token`, if yes, it proceeds to check the expiry date","ref":"Lightning.VersionControl.html#oauth_token_valid?/1"},{"type":"function","title":"Lightning.VersionControl.reconfigure_github_connection/3","doc":"","ref":"Lightning.VersionControl.html#reconfigure_github_connection/3"},{"type":"function","title":"Lightning.VersionControl.refresh_oauth_token/1","doc":"Fetches a new access token using the given refresh token\nFor more info: https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens","ref":"Lightning.VersionControl.html#refresh_oauth_token/1"},{"type":"function","title":"Lightning.VersionControl.remove_github_connection/2","doc":"Deletes a github connection","ref":"Lightning.VersionControl.html#remove_github_connection/2"},{"type":"function","title":"Lightning.VersionControl.save_oauth_token/3","doc":"","ref":"Lightning.VersionControl.html#save_oauth_token/3"},{"type":"function","title":"Lightning.VersionControl.subscribe/1","doc":"","ref":"Lightning.VersionControl.html#subscribe/1"},{"type":"function","title":"Lightning.VersionControl.verify_github_connection/1","doc":"","ref":"Lightning.VersionControl.html#verify_github_connection/1"},{"type":"module","title":"Lightning.VersionControl.Events","doc":"","ref":"Lightning.VersionControl.Events.html"},{"type":"function","title":"Lightning.VersionControl.Events.oauth_token_added/1","doc":"","ref":"Lightning.VersionControl.Events.html#oauth_token_added/1"},{"type":"function","title":"Lightning.VersionControl.Events.oauth_token_failed/2","doc":"","ref":"Lightning.VersionControl.Events.html#oauth_token_failed/2"},{"type":"function","title":"Lightning.VersionControl.Events.subscribe/1","doc":"","ref":"Lightning.VersionControl.Events.html#subscribe/1"},{"type":"module","title":"Lightning.VersionControl.GithubClient","doc":"Tesla github http client we use this to make any network requests\nto github from Lightning","ref":"Lightning.VersionControl.GithubClient.html"},{"type":"function","title":"Lightning.VersionControl.GithubClient.build_basic_auth_client/2","doc":"","ref":"Lightning.VersionControl.GithubClient.html#build_basic_auth_client/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.build_bearer_client/1","doc":"","ref":"Lightning.VersionControl.GithubClient.html#build_bearer_client/1"},{"type":"function","title":"Lightning.VersionControl.GithubClient.build_installation_client/1","doc":"","ref":"Lightning.VersionControl.GithubClient.html#build_installation_client/1"},{"type":"function","title":"Lightning.VersionControl.GithubClient.build_oauth_client/0","doc":"","ref":"Lightning.VersionControl.GithubClient.html#build_oauth_client/0"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_blob/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_blob/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_commit/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_commit/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_ref/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_ref/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_repo_dispatch_event/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_repo_dispatch_event/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_repo_secret/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_repo_secret/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_tree/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_tree/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.create_workflow_dispatch_event/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#create_workflow_dispatch_event/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete/3","doc":"Perform a DELETE request.\n\nSee `request/1` or `request/2` for options definition.\n\n delete(\"/users\")\n delete(\"/users\", query: [scope: \"admin\"])\n delete(client, \"/users\")\n delete(client, \"/users\", query: [scope: \"admin\"])\n delete(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#delete/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete!/3","doc":"Perform a DELETE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n delete!(\"/users\")\n delete!(\"/users\", query: [scope: \"admin\"])\n delete!(client, \"/users\")\n delete!(client, \"/users\", query: [scope: \"admin\"])\n delete!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#delete!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete_app_grant/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#delete_app_grant/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete_ref/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#delete_ref/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete_repo_content/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#delete_repo_content/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.delete_repo_secret/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#delete_repo_secret/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get/3","doc":"Perform a GET request.\n\nSee `request/1` or `request/2` for options definition.\n\n get(\"/users\")\n get(\"/users\", query: [scope: \"admin\"])\n get(client, \"/users\")\n get(client, \"/users\", query: [scope: \"admin\"])\n get(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#get/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get!/3","doc":"Perform a GET request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n get!(\"/users\")\n get!(\"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\")\n get!(client, \"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#get!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_commit/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_commit/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_installation_repos/1","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_installation_repos/1"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_installations/1","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_installations/1"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo/2","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo_branches/2","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo_branches/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo_content/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo_content/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo_public_key/2","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo_public_key/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.get_repo_secret/3","doc":"","ref":"Lightning.VersionControl.GithubClient.html#get_repo_secret/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.head/3","doc":"Perform a HEAD request.\n\nSee `request/1` or `request/2` for options definition.\n\n head(\"/users\")\n head(\"/users\", query: [scope: \"admin\"])\n head(client, \"/users\")\n head(client, \"/users\", query: [scope: \"admin\"])\n head(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#head/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.head!/3","doc":"Perform a HEAD request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n head!(\"/users\")\n head!(\"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\")\n head!(client, \"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#head!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.options/3","doc":"Perform a OPTIONS request.\n\nSee `request/1` or `request/2` for options definition.\n\n options(\"/users\")\n options(\"/users\", query: [scope: \"admin\"])\n options(client, \"/users\")\n options(client, \"/users\", query: [scope: \"admin\"])\n options(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#options/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.options!/3","doc":"Perform a OPTIONS request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n options!(\"/users\")\n options!(\"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\")\n options!(client, \"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#options!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.patch/4","doc":"Perform a PATCH request.\n\nSee `request/1` or `request/2` for options definition.\n\n patch(\"/users\", %{name: \"Jon\"})\n patch(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch(client, \"/users\", %{name: \"Jon\"})\n patch(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#patch/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.patch!/4","doc":"Perform a PATCH request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n patch!(\"/users\", %{name: \"Jon\"})\n patch!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch!(client, \"/users\", %{name: \"Jon\"})\n patch!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#patch!/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.post/4","doc":"Perform a POST request.\n\nSee `request/1` or `request/2` for options definition.\n\n post(\"/users\", %{name: \"Jon\"})\n post(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n post(client, \"/users\", %{name: \"Jon\"})\n post(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#post/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.post!/4","doc":"Perform a POST request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n post!(\"/users\", %{name: \"Jon\"})\n post!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n post!(client, \"/users\", %{name: \"Jon\"})\n post!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#post!/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.put/4","doc":"Perform a PUT request.\n\nSee `request/1` or `request/2` for options definition.\n\n put(\"/users\", %{name: \"Jon\"})\n put(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n put(client, \"/users\", %{name: \"Jon\"})\n put(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#put/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.put!/4","doc":"Perform a PUT request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n put!(\"/users\", %{name: \"Jon\"})\n put!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n put!(client, \"/users\", %{name: \"Jon\"})\n put!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Lightning.VersionControl.GithubClient.html#put!/4"},{"type":"function","title":"Lightning.VersionControl.GithubClient.request/2","doc":"Perform a request.","ref":"Lightning.VersionControl.GithubClient.html#request/2"},{"type":"function","title":"Options - Lightning.VersionControl.GithubClient.request/2","doc":"- `:method` - the request method, one of [`:head`, `:get`, `:delete`, `:trace`, `:options`, `:post`, `:put`, `:patch`]\n- `:url` - either full url e.g. \"http://example.com/some/path\" or just \"/some/path\" if using `Tesla.Middleware.BaseUrl`\n- `:query` - a keyword list of query params, e.g. `[page: 1, per_page: 100]`\n- `:headers` - a keyword list of headers, e.g. `[{\"content-type\", \"text/plain\"}]`\n- `:body` - depends on used middleware:\n - by default it can be a binary\n - if using e.g. JSON encoding middleware it can be a nested map\n - if adapter supports it it can be a Stream with any of the above\n- `:opts` - custom, per-request middleware or adapter options","ref":"Lightning.VersionControl.GithubClient.html#request/2-options"},{"type":"function","title":"Examples - Lightning.VersionControl.GithubClient.request/2","doc":"ExampleApi.request(method: :get, url: \"/users/path\")\n\n # use shortcut methods\n ExampleApi.get(\"/users/1\")\n ExampleApi.post(client, \"/users\", %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#request/2-examples"},{"type":"function","title":"Lightning.VersionControl.GithubClient.request!/2","doc":"Perform request and raise in case of error.\n\nThis is similar to `request/2` behaviour from Tesla 0.x\n\nSee `request/2` for list of available options.","ref":"Lightning.VersionControl.GithubClient.html#request!/2"},{"type":"function","title":"Lightning.VersionControl.GithubClient.trace/3","doc":"Perform a TRACE request.\n\nSee `request/1` or `request/2` for options definition.\n\n trace(\"/users\")\n trace(\"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\")\n trace(client, \"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#trace/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.trace!/3","doc":"Perform a TRACE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n trace!(\"/users\")\n trace!(\"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\")\n trace!(client, \"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Lightning.VersionControl.GithubClient.html#trace!/3"},{"type":"function","title":"Lightning.VersionControl.GithubClient.update_ref/4","doc":"","ref":"Lightning.VersionControl.GithubClient.html#update_ref/4"},{"type":"type","title":"Lightning.VersionControl.GithubClient.option/0","doc":"Options that may be passed to a request function. See `request/2` for detailed descriptions.","ref":"Lightning.VersionControl.GithubClient.html#t:option/0"},{"type":"exception","title":"Lightning.VersionControl.GithubError","doc":"GitHub Error exception","ref":"Lightning.VersionControl.GithubError.html"},{"type":"function","title":"Lightning.VersionControl.GithubError.api_error/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#api_error/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.file_not_found/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#file_not_found/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.installation_not_found/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#installation_not_found/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.invalid_certificate/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#invalid_certificate/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.invalid_oauth_token/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#invalid_oauth_token/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.misconfigured/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#misconfigured/2"},{"type":"function","title":"Lightning.VersionControl.GithubError.new/3","doc":"","ref":"Lightning.VersionControl.GithubError.html#new/3"},{"type":"function","title":"Lightning.VersionControl.GithubError.repo_secret_not_found/2","doc":"","ref":"Lightning.VersionControl.GithubError.html#repo_secret_not_found/2"},{"type":"type","title":"Lightning.VersionControl.GithubError.t/0","doc":"","ref":"Lightning.VersionControl.GithubError.html#t:t/0"},{"type":"module","title":"Lightning.VersionControl.GithubToken","doc":"A module that `uses` Joken to handle building and signing application\ntokens for communicating with github\n\nSee: https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-json-web-token-jwt-for-a-github-app#about-json-web-tokens-jwts","ref":"Lightning.VersionControl.GithubToken.html"},{"type":"function","title":"Lightning.VersionControl.GithubToken.build/2","doc":"","ref":"Lightning.VersionControl.GithubToken.html#build/2"},{"type":"function","title":"Lightning.VersionControl.GithubToken.generate_and_sign/2","doc":"Combines `generate_claims/1` and `encode_and_sign/2`","ref":"Lightning.VersionControl.GithubToken.html#generate_and_sign/2"},{"type":"function","title":"Lightning.VersionControl.GithubToken.generate_and_sign!/2","doc":"Same as `generate_and_sign/2` but raises if error","ref":"Lightning.VersionControl.GithubToken.html#generate_and_sign!/2"},{"type":"function","title":"Lightning.VersionControl.GithubToken.verify_and_validate/3","doc":"Combines `verify/2` and `validate/2`","ref":"Lightning.VersionControl.GithubToken.html#verify_and_validate/3"},{"type":"function","title":"Lightning.VersionControl.GithubToken.verify_and_validate!/3","doc":"Same as `verify_and_validate/2` but raises if error","ref":"Lightning.VersionControl.GithubToken.html#verify_and_validate!/3"},{"type":"module","title":"Lightning.VersionControl.ProjectRepoConnection","doc":"Ecto model for project repo connections","ref":"Lightning.VersionControl.ProjectRepoConnection.html"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.changeset/2","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#changeset/2"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.config_path/1","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#config_path/1"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.configure_changeset/2","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#configure_changeset/2"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.create_changeset/2","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#create_changeset/2"},{"type":"function","title":"Lightning.VersionControl.ProjectRepoConnection.reconfigure_changeset/2","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#reconfigure_changeset/2"},{"type":"type","title":"Lightning.VersionControl.ProjectRepoConnection.t/0","doc":"","ref":"Lightning.VersionControl.ProjectRepoConnection.html#t:t/0"},{"type":"module","title":"Lightning.WebhookAuthMethods","doc":"Provides functionality for managing webhook authentication methods.\n\nThis module contains functions to create, update, list, and delete authentication methods\nfor webhooks. It supports operations such as scheduling authentication methods for deletion,\npurging them, associating them with triggers, and handling their life cycle within the system.\n\nThe main responsibilities of this module include:\n\n- Creating new webhook authentication methods with `create_auth_method/2`.\n- Associating and disassociating authentication methods with triggers.\n- Updating existing webhook authentication methods with `update_auth_method/3`.\n- Listing webhook authentication methods for a given project or trigger.\n- Finding a webhook authentication method by various identifiers, like API key or username and password.\n- Scheduling webhook authentication methods for deletion and purging them accordingly.","ref":"Lightning.WebhookAuthMethods.html"},{"type":"function","title":"Lightning.WebhookAuthMethods.create_auth_method/2","doc":"Creates a new `WebhookAuthMethod` and associated audit records.\n\nThis function supports creating a `WebhookAuthMethod` either standalone or associated with a `Trigger`. It performs a database transaction that includes creating the auth method and its audit trail.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- `attrs`: A map of attributes used to create the `WebhookAuthMethod`.\n - `actor`: The user performing the action, provided as a `%User{}` struct.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-parameters"},{"type":"function","title":"Overloads - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- When called with a map of attributes, it creates a `WebhookAuthMethod` without associating it to a trigger.\n - When called with a `Trigger` struct and a map of attributes, it creates a `WebhookAuthMethod` and associates it with the provided trigger.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-overloads"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- `{:ok, %WebhookAuthMethod{}}`: A tuple containing `:ok` and the newly created `WebhookAuthMethod` struct if the creation was successful.\n - `{:error, %Ecto.Changeset{}}`: A tuple containing `:error` and the changeset with errors if the creation failed.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- Creating a `WebhookAuthMethod` without an associated trigger:\n\n ```elixir\n iex> create_auth_method(%{valid_attributes}, actor: %User{})\n {:ok, %WebhookAuthMethod{}}\n\n iex> create_auth_method(%{invalid_attributes}, actor: %User{})\n {:error, %Ecto.Changeset{}}\n ```\n\n - Creating a `WebhookAuthMethod` with an associated trigger:\n\n ```elixir\n iex> create_auth_method(%Trigger{}, %{valid_attributes}, actor: %User{})\n {:ok, %WebhookAuthMethod{}}\n\n iex> create_auth_method(%Trigger{}, %{invalid_attributes}, actor: %User{})\n {:error, %Ecto.Changeset{}}\n ```","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-examples"},{"type":"function","title":"Notes - Lightning.WebhookAuthMethods.create_auth_method/2","doc":"- This function starts a `Repo.transaction` to ensure that all database operations are atomic. If any part of the transaction fails, all changes will be rolled back.\n - Audit events are created for both the creation of the `WebhookAuthMethod` and its association with a trigger, if applicable.","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/2-notes"},{"type":"function","title":"Lightning.WebhookAuthMethods.create_auth_method/3","doc":"","ref":"Lightning.WebhookAuthMethods.html#create_auth_method/3"},{"type":"function","title":"Lightning.WebhookAuthMethods.create_changeset/2","doc":"Creates a changeset for a `WebhookAuthMethod` struct, which can include special handling based on the authentication type.\n\nThis function prepares a changeset for the creation or update of a `WebhookAuthMethod`. If the `auth_type` is `:api`, it generates a new API key and includes it in the returned structure.","ref":"Lightning.WebhookAuthMethods.html#create_changeset/2"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.create_changeset/2","doc":"- `webhook_auth_method`: The `WebhookAuthMethod` struct to be updated.\n - `params`: A map containing the parameters with which to update the `webhook_auth_method`.","ref":"Lightning.WebhookAuthMethods.html#create_changeset/2-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.create_changeset/2","doc":"- Returns the updated `WebhookAuthMethod` struct with changes applied. If `auth_type` is `:api`, an API key is generated and included.","ref":"Lightning.WebhookAuthMethods.html#create_changeset/2-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.create_changeset/2","doc":"- Creating a changeset for an API type auth method:\n\n ```elixir\n iex> Lightning.Workflows.create_changeset(%WebhookAuthMethod{auth_type: :api}, %{})\n %WebhookAuthMethod{api_key: some_new_api_key}\n ```\n\n - Creating a changeset for a non-API type auth method:\n\n ```elixir\n iex> Lightning.Workflows.create_changeset(%WebhookAuthMethod{auth_type: :other}, %{})\n %WebhookAuthMethod{}\n ```","ref":"Lightning.WebhookAuthMethods.html#create_changeset/2-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"Deletes a given `WebhookAuthMethod` from the database.\n\nThe function takes a `WebhookAuthMethod` struct and runs to delete it. If the deletion is successful, it returns an `:ok` tuple with the deleted `WebhookAuthMethod` struct. If the deletion fails due to a constraint, such as a foreign key reference, it returns an error tuple.","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"- `auth_method`: The `WebhookAuthMethod` struct to delete.","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"- `{:ok, struct}`: A tuple containing `:ok` and the deleted `WebhookAuthMethod` struct if the deletion succeeds.\n - `{:error, reason}`: A tuple containing `:error` and the reason for failure if the deletion fails.","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"- Successful deletion:\n\n ```elixir\n iex> delete_auth_method(%WebhookAuthMethod{id: \"some_id\"})\n {:ok, %WebhookAuthMethod{}}\n ```\n\n - Deletion fails due to the item not existing or other conflict:\n\n ```elixir\n iex> delete_auth_method(%WebhookAuthMethod{id: \"non_existing_id\"})\n {:error, reason}\n ```","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1-examples"},{"type":"function","title":"Notes - Lightning.WebhookAuthMethods.delete_auth_method/1","doc":"- It is important to ensure that the `WebhookAuthMethod` is not being referenced by other entities before trying deletion to avoid conflicts.\n - This function will return an error tuple if the `WebhookAuthMethod` struct passed to it does not exist in the database.","ref":"Lightning.WebhookAuthMethods.html#delete_auth_method/1-notes"},{"type":"function","title":"Lightning.WebhookAuthMethods.find_by_api_key/2","doc":"Retrieves a `WebhookAuthMethod` that matches the given API key for a specified project.\n\nIt uses a secure comparison to match the API key, ensuring that timing attacks are mitigated.","ref":"Lightning.WebhookAuthMethods.html#find_by_api_key/2"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.find_by_api_key/2","doc":"- `api_key`: The API key as a binary string to match against existing `WebhookAuthMethod` records.\n - `project`: The `Project` struct to scope the search within its associated `WebhookAuthMethod`s.","ref":"Lightning.WebhookAuthMethods.html#find_by_api_key/2-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.find_by_api_key/2","doc":"- A `WebhookAuthMethod` struct if a matching API key is found within the given project's scope.\n - `nil` if there is no `WebhookAuthMethod` with the given API key for the project.","ref":"Lightning.WebhookAuthMethods.html#find_by_api_key/2-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.find_by_api_key/2","doc":"- When a matching `WebhookAuthMethod` is found:\n\n ```elixir\n iex> Lightning.Workflows.find_by_api_key(\"existing_api_key\", %Project{id: \"existing_project_id\"})\n %WebhookAuthMethod{}\n ```\n\n - When there is no matching `WebhookAuthMethod`:\n\n ```elixir\n iex> Lightning.Workflows.find_by_api_key(\"non_existing_api_key\", %Project{id: \"existing_project_id\"})\n nil\n ```","ref":"Lightning.WebhookAuthMethods.html#find_by_api_key/2-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.find_by_id!/1","doc":"Retrieves a `WebhookAuthMethod` by its ID, raising an exception if not found.\n\nThis function is intended for situations where the `WebhookAuthMethod` is expected to exist, and not finding one is an exceptional case that should halt normal flow with an error.","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1"},{"type":"function","title":"Parameter - Lightning.WebhookAuthMethods.find_by_id!/1","doc":"- `id`: The ID of the `WebhookAuthMethod` to retrieve.","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1-parameter"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.find_by_id!/1","doc":"- Returns the `WebhookAuthMethod` struct if found.","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1-returns"},{"type":"function","title":"Errors - Lightning.WebhookAuthMethods.find_by_id!/1","doc":"- Raises `Ecto.NoResultsError` if there is no `WebhookAuthMethod` with the given ID.","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1-errors"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.find_by_id!/1","doc":"- When a `WebhookAuthMethod` with the given ID exists:\n\n ```elixir\n iex> Lightning.Workflows.find_by_id!(\"existing_id\")\n %WebhookAuthMethod{}\n ```\n\n - When there is no `WebhookAuthMethod` with the given ID:\n\n ```elixir\n iex> Lightning.Workflows.find_by_id!(\"non_existing_id\")\n ** (Ecto.NoResultsError)\n ```","ref":"Lightning.WebhookAuthMethods.html#find_by_id!/1-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.find_by_username_and_password/3","doc":"Retrieves a `WebhookAuthMethod` that matches the given username and password within the scope of a specified project.\n\nThe function checks if the provided password is correct for the given username and project. If the password is valid, the corresponding `WebhookAuthMethod` is returned. It is important to handle password comparison securely to prevent timing attacks.","ref":"Lightning.WebhookAuthMethods.html#find_by_username_and_password/3"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.find_by_username_and_password/3","doc":"- `username`: The username as a string to match against the `WebhookAuthMethod` records.\n - `password`: The plaintext password as a string which will be securely compared to the stored password.\n - `project`: The `Project` struct to scope the search for the `WebhookAuthMethod`.","ref":"Lightning.WebhookAuthMethods.html#find_by_username_and_password/3-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.find_by_username_and_password/3","doc":"- Returns the matching `WebhookAuthMethod` struct if the username and password are correct within the given project's scope.\n - Returns `nil` if no matching record is found or if the password is invalid.","ref":"Lightning.WebhookAuthMethods.html#find_by_username_and_password/3-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.find_by_username_and_password/3","doc":"- When a matching `WebhookAuthMethod` is found and the password is valid:\n\n ```elixir\n iex> Lightning.Workflows.find_by_username_and_password(\"existing_username\", \"valid_password\", %Project{id: \"existing_project_id\"})\n %WebhookAuthMethod{}\n ```\n\n - When the username is found but the password is invalid or no matching record is found:\n\n ```elixir\n iex> Lightning.Workflows.find_by_username_and_password(\"existing_username\", \"invalid_password\", %Project{id: \"existing_project_id\"})\n nil\n ```","ref":"Lightning.WebhookAuthMethods.html#find_by_username_and_password/3-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.list_for_project/1","doc":"Retrieves a list of `WebhookAuthMethod`s associated with a specific `Project`.\n\nThe function filters `WebhookAuthMethod`s by the provided `Project`'s ID and excludes any methods that are scheduled for deletion.","ref":"Lightning.WebhookAuthMethods.html#list_for_project/1"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.list_for_project/1","doc":"- `project`: The `Project` struct containing the ID of the project for which to list the authentication methods.","ref":"Lightning.WebhookAuthMethods.html#list_for_project/1-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.list_for_project/1","doc":"- A list of `WebhookAuthMethod` structs. This can be an empty list if no methods are associated with the project or if the project does not exist.","ref":"Lightning.WebhookAuthMethods.html#list_for_project/1-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.list_for_project/1","doc":"- When the project exists and has associated auth methods:\n\n ```elixir\n iex> list_for_project(%Project{id: \"existing_project_id\"})\n [%WebhookAuthMethod{}, ...]\n ```\n\n - When the project does not exist or has no associated auth methods:\n\n ```elixir\n iex> list_for_project(%Project{id: \"non_existing_project_id\"})\n []\n ```","ref":"Lightning.WebhookAuthMethods.html#list_for_project/1-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.list_for_trigger/1","doc":"Retrieves a list of `WebhookAuthMethod`s associated with the specified `Trigger`.\n\nThis function filters out `WebhookAuthMethod`s that are scheduled for deletion, ensuring that only active methods are returned.","ref":"Lightning.WebhookAuthMethods.html#list_for_trigger/1"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.list_for_trigger/1","doc":"- `trigger`: A `Trigger` struct whose associated `WebhookAuthMethod`s are to be retrieved.","ref":"Lightning.WebhookAuthMethods.html#list_for_trigger/1-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.list_for_trigger/1","doc":"- A list of `WebhookAuthMethod` structs associated with the `Trigger`. If the `Trigger` has no associated methods or if they are all scheduled for deletion, the list will be empty.","ref":"Lightning.WebhookAuthMethods.html#list_for_trigger/1-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.list_for_trigger/1","doc":"- When the `Trigger` has associated `WebhookAuthMethod`s not scheduled for deletion:\n\n ```elixir\n iex> Lightning.Workflows.list_for_trigger(%Trigger{id: \"existing_trigger_id\"})\n [%WebhookAuthMethod{}, ...]\n ```\n\n - When the `Trigger` has no associated `WebhookAuthMethod`s or they are all scheduled for deletion:\n\n ```elixir\n iex> Lightning.Workflows.list_for_trigger(%Trigger{id: \"trigger_without_methods\"})\n []\n ```","ref":"Lightning.WebhookAuthMethods.html#list_for_trigger/1-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.perform/1","doc":"Performs cleanup of `WebhookAuthMethod` records that are marked for permanent deletion.","ref":"Lightning.WebhookAuthMethods.html#perform/1"},{"type":"function","title":"Details - Lightning.WebhookAuthMethods.perform/1","doc":"This function, when invoked with a job argument containing `%{\"type\" => \"purge_deleted\"}`, performs the following operations:\n\n1. It queries all `WebhookAuthMethod` records that are scheduled for deletion (i.e., their `scheduled_deletion` timestamp is in the past).\n2. It then disassociates each of these records from any associated triggers.\n3. Finally, it deletes the `WebhookAuthMethod` records from the database.\n\nThe function operates within the context of an Oban job, utilizing the `perform/1` callback expected by the Oban.Worker behaviour.","ref":"Lightning.WebhookAuthMethods.html#perform/1-details"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.perform/1","doc":"- A `%Oban.Job{args: %{\"type\" => \"purge_deleted\"}}` struct, indicating the job should perform a purge operation.","ref":"Lightning.WebhookAuthMethods.html#perform/1-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.perform/1","doc":"A tuple `{:ok, %{disassociated_count: integer(), deleted_count: integer()}}` where:\n- `:ok` indicates the operation was successful.\n- `disassociated_count` is the number of `WebhookAuthMethod` records successfully disassociated from triggers.\n- `deleted_count` is the number of `WebhookAuthMethod` records successfully deleted.","ref":"Lightning.WebhookAuthMethods.html#perform/1-returns"},{"type":"function","title":"Example - Lightning.WebhookAuthMethods.perform/1","doc":"```elixir\n%Oban.Job{\nargs: %{\"type\" => \"purge_deleted\"}\n}\n|> MyModule.perform()\n# => {:ok, %{disassociated_count: 2, deleted_count: 2}}\n```","ref":"Lightning.WebhookAuthMethods.html#perform/1-example"},{"type":"function","title":"Lightning.WebhookAuthMethods.schedule_for_deletion/2","doc":"Schedules a `WebhookAuthMethod` for deletion by setting its `scheduled_deletion` date.\n\nThis function does not delete the record immediately. Instead, it sets the `scheduled_deletion` field to a date in the future as defined by the application's environment settings.\nThe default behavior, in the absence of environment configuration, is to schedule the deletion for the current date and time, effectively marking it for immediate deletion.\n\nThe scheduled deletion date is determined by the `:purge_deleted_after_days` configuration in the application environment.\nIf this configuration is not present, the function defaults to 0 days, which schedules the deletion for the current date and time.","ref":"Lightning.WebhookAuthMethods.html#schedule_for_deletion/2"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.schedule_for_deletion/2","doc":"- `webhook_auth_method`: A `WebhookAuthMethod` struct that is to be scheduled for deletion.","ref":"Lightning.WebhookAuthMethods.html#schedule_for_deletion/2-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.schedule_for_deletion/2","doc":"- `{:ok, webhook_auth_method}`: Returns an `:ok` tuple with the updated webhook auth method struct if the\n update was successful.\n - `{:error, changeset}`: Returns an `:error` tuple with the changeset if the update failed.","ref":"Lightning.WebhookAuthMethods.html#schedule_for_deletion/2-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.schedule_for_deletion/2","doc":"- When a webhook auth method is successfully scheduled for deletion:\n\n ```elixir\n iex> Lightning.Workflows.schedule_for_deletion(%WebhookAuthMethod{id: some_id})\n {:ok, %WebhookAuthMethod{scheduled_deletion: deletion_date}}\n ```\n\n - When scheduling for deletion fails due to validation errors:\n\n ```elixir\n iex> Lightning.Workflows.schedule_for_deletion(%WebhookAuthMethod{})\n {:error, %Ecto.Changeset{}}\n ```","ref":"Lightning.WebhookAuthMethods.html#schedule_for_deletion/2-examples"},{"type":"function","title":"Lightning.WebhookAuthMethods.update_auth_method/3","doc":"Updates an existing `WebhookAuthMethod` with the provided attributes and creates an audit event.\n\nThis function applies the given changes to the specified `WebhookAuthMethod` and records the update action in the audit log. It wraps the operations within a database transaction to ensure data integrity.","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.update_auth_method/3","doc":"- `webhook_auth_method`: The `WebhookAuthMethod` struct to be updated.\n - `attrs`: A map containing the updated values for the fields of the `WebhookAuthMethod`.\n - `actor`: The user performing the update, represented by a `%User{}` struct.","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.update_auth_method/3","doc":"- `{:ok, %WebhookAuthMethod{}}`: A tuple containing `:ok` and the updated `WebhookAuthMethod` struct if the update is successful.\n - `{:error, %Ecto.Changeset{}}`: A tuple containing `:error` and the changeset with errors if the update fails.","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.update_auth_method/3","doc":"- Successful update:\n\n ```elixir\n iex> update_auth_method(webhook_auth_method, %{field: new_value}, actor: %User{})\n {:ok, %WebhookAuthMethod{}}\n ```\n\n - Update fails due to invalid data:\n\n ```elixir\n iex> update_auth_method(webhook_auth_method, %{field: bad_value}, actor: %User{})\n {:error, %Ecto.Changeset{}}\n ```","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3-examples"},{"type":"function","title":"Notes - Lightning.WebhookAuthMethods.update_auth_method/3","doc":"- The function uses `Ecto.Multi` to perform a transaction, ensuring that either all changes apply successfully, or none do if there's an error.\n - An audit event is recorded with the `Lightning.WebhookAuthMethodAudit.event/4` function, capturing the details of the update and the acting user.","ref":"Lightning.WebhookAuthMethods.html#update_auth_method/3-notes"},{"type":"function","title":"Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"Updates the association of `WebhookAuthMethod`s for a given `Trigger` and logs the changes as audit events.\n\nThis function replaces the current `WebhookAuthMethod` associations of a `Trigger` with the provided list of `WebhookAuthMethod`s. It creates audit events for each added and removed `WebhookAuthMethod`, ensuring full traceability of changes.","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3"},{"type":"function","title":"Parameters - Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"- `trigger`: The `Trigger` struct whose associated `WebhookAuthMethod`s are to be updated.\n - `auth_methods`: A list of `WebhookAuthMethod` structs to be associated with the `Trigger`.\n - `actor`: The user performing the update, represented by a `%User{}` struct.","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3-parameters"},{"type":"function","title":"Returns - Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"- `{:ok, %Trigger{}}`: A tuple containing `:ok` and the updated `Trigger` struct if the associations are updated successfully.\n - `{:error, %Ecto.Changeset{}}`: A tuple containing `:error` and the changeset with errors if the update fails.","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3-returns"},{"type":"function","title":"Examples - Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"- Successful association update:\n\n ```elixir\n iex> update_trigger_auth_methods(trigger, [webhook_auth_method], actor: %User{})\n {:ok, %Trigger{}}\n ```\n\n - Update fails due to an invalid changeset:\n\n ```elixir\n iex> update_trigger_auth_methods(trigger, [invalid_webhook_auth_method], actor: %User{})\n {:error, %Ecto.Changeset{}}\n ```","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3-examples"},{"type":"function","title":"Notes - Lightning.WebhookAuthMethods.update_trigger_auth_methods/3","doc":"- The function uses `Ecto.Multi` to perform a transaction, which ensures either all changes are applied or none at all if an error occurs.\n - Audit events for the additions and removals of `WebhookAuthMethod`s are recorded using `WebhookAuthMethodAudit.event/4`.\n - The function preloads the existing `webhook_auth_methods` of the `Trigger` before performing updates.","ref":"Lightning.WebhookAuthMethods.html#update_trigger_auth_methods/3-notes"},{"type":"module","title":"Lightning.WorkOrder","doc":"Ecto model for WorkOrders.","ref":"Lightning.WorkOrder.html"},{"type":"function","title":"Lightning.WorkOrder.validate/1","doc":"","ref":"Lightning.WorkOrder.html#validate/1"},{"type":"type","title":"Lightning.WorkOrder.t/0","doc":"","ref":"Lightning.WorkOrder.html#t:t/0"},{"type":"module","title":"Lightning.Workers","doc":"Lightning uses external worker processes to execute workflow jobs.\n\nThis module deals with the security tokens and the formatting used on\nthe communication with the workers.","ref":"Lightning.Workers.html"},{"type":"function","title":"Lightning.Workers.generate_run_token/2","doc":"","ref":"Lightning.Workers.html#generate_run_token/2"},{"type":"function","title":"Lightning.Workers.verify_run_token/2","doc":"Verifies and validates a run token.\n\nIt requires a context map with the following keys:\n\n- `:id` - the run id that the token was issued with.\n\nOptionally takes a context map that will be passed to the validation:\n\n- `:current_time` - the current time as a `DateTime` struct.","ref":"Lightning.Workers.html#verify_run_token/2"},{"type":"function","title":"Lightning.Workers.verify_worker_token/2","doc":"Verifies and validates a worker token.\n\nOptionally takes a context map that will be passed to the validation:\n\n- `:current_time` - the current time as a `DateTime` struct.","ref":"Lightning.Workers.html#verify_worker_token/2"},{"type":"module","title":"Lightning.Workers.RunToken","doc":"JWT token configuration to verify if workers work is legit.","ref":"Lightning.Workers.RunToken.html"},{"type":"function","title":"Lightning.Workers.RunToken.generate_and_sign/2","doc":"Combines `generate_claims/1` and `encode_and_sign/2`","ref":"Lightning.Workers.RunToken.html#generate_and_sign/2"},{"type":"function","title":"Lightning.Workers.RunToken.generate_and_sign!/2","doc":"Same as `generate_and_sign/2` but raises if error","ref":"Lightning.Workers.RunToken.html#generate_and_sign!/2"},{"type":"function","title":"Lightning.Workers.RunToken.verify_and_validate/3","doc":"Combines `verify/2` and `validate/2`","ref":"Lightning.Workers.RunToken.html#verify_and_validate/3"},{"type":"function","title":"Lightning.Workers.RunToken.verify_and_validate!/3","doc":"Same as `verify_and_validate/2` but raises if error","ref":"Lightning.Workers.RunToken.html#verify_and_validate!/3"},{"type":"module","title":"Lightning.Workers.WorkerToken","doc":"JWT token configuration to authenticate workers.","ref":"Lightning.Workers.WorkerToken.html"},{"type":"function","title":"Lightning.Workers.WorkerToken.generate_and_sign/2","doc":"Combines `generate_claims/1` and `encode_and_sign/2`","ref":"Lightning.Workers.WorkerToken.html#generate_and_sign/2"},{"type":"function","title":"Lightning.Workers.WorkerToken.generate_and_sign!/2","doc":"Same as `generate_and_sign/2` but raises if error","ref":"Lightning.Workers.WorkerToken.html#generate_and_sign!/2"},{"type":"function","title":"Lightning.Workers.WorkerToken.verify_and_validate/3","doc":"Combines `verify/2` and `validate/2`","ref":"Lightning.Workers.WorkerToken.html#verify_and_validate/3"},{"type":"function","title":"Lightning.Workers.WorkerToken.verify_and_validate!/3","doc":"Same as `verify_and_validate/2` but raises if error","ref":"Lightning.Workers.WorkerToken.html#verify_and_validate!/3"},{"type":"task","title":"mix lightning.gen_encryption_key","doc":"Helper to generate a unique encryption key for Vault","ref":"Mix.Tasks.Lightning.GenEncryptionKey.html"},{"type":"task","title":"mix lightning.gen_worker_keys","doc":"Helper to generate the private and public keys for worker authentication","ref":"Mix.Tasks.Lightning.GenWorkerKeys.html"},{"type":"task","title":"mix lightning.install_adaptor_icons","doc":"Installs the adaptor icons","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.get/3","doc":"Perform a GET request.\n\nSee `request/1` or `request/2` for options definition.\n\n get(\"/users\")\n get(\"/users\", query: [scope: \"admin\"])\n get(client, \"/users\")\n get(client, \"/users\", query: [scope: \"admin\"])\n get(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#get/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.get!/3","doc":"Perform a GET request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n get!(\"/users\")\n get!(\"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\")\n get!(client, \"/users\", query: [scope: \"admin\"])\n get!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#get!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.head/3","doc":"Perform a HEAD request.\n\nSee `request/1` or `request/2` for options definition.\n\n head(\"/users\")\n head(\"/users\", query: [scope: \"admin\"])\n head(client, \"/users\")\n head(client, \"/users\", query: [scope: \"admin\"])\n head(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#head/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.head!/3","doc":"Perform a HEAD request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n head!(\"/users\")\n head!(\"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\")\n head!(client, \"/users\", query: [scope: \"admin\"])\n head!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#head!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.options/3","doc":"Perform a OPTIONS request.\n\nSee `request/1` or `request/2` for options definition.\n\n options(\"/users\")\n options(\"/users\", query: [scope: \"admin\"])\n options(client, \"/users\")\n options(client, \"/users\", query: [scope: \"admin\"])\n options(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#options/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.options!/3","doc":"Perform a OPTIONS request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n options!(\"/users\")\n options!(\"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\")\n options!(client, \"/users\", query: [scope: \"admin\"])\n options!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#options!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.patch/4","doc":"Perform a PATCH request.\n\nSee `request/1` or `request/2` for options definition.\n\n patch(\"/users\", %{name: \"Jon\"})\n patch(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch(client, \"/users\", %{name: \"Jon\"})\n patch(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#patch/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.patch!/4","doc":"Perform a PATCH request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n patch!(\"/users\", %{name: \"Jon\"})\n patch!(\"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])\n patch!(client, \"/users\", %{name: \"Jon\"})\n patch!(client, \"/users\", %{name: \"Jon\"}, query: [scope: \"admin\"])","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#patch!/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.request/2","doc":"Perform a request.","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#request/2"},{"type":"function","title":"Options - Mix.Tasks.Lightning.InstallAdaptorIcons.request/2","doc":"- `:method` - the request method, one of [`:head`, `:get`, `:delete`, `:trace`, `:options`, `:post`, `:put`, `:patch`]\n- `:url` - either full url e.g. \"http://example.com/some/path\" or just \"/some/path\" if using `Tesla.Middleware.BaseUrl`\n- `:query` - a keyword list of query params, e.g. `[page: 1, per_page: 100]`\n- `:headers` - a keyword list of headers, e.g. `[{\"content-type\", \"text/plain\"}]`\n- `:body` - depends on used middleware:\n - by default it can be a binary\n - if using e.g. JSON encoding middleware it can be a nested map\n - if adapter supports it it can be a Stream with any of the above\n- `:opts` - custom, per-request middleware or adapter options","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#request/2-options"},{"type":"function","title":"Examples - Mix.Tasks.Lightning.InstallAdaptorIcons.request/2","doc":"ExampleApi.request(method: :get, url: \"/users/path\")\n\n # use shortcut methods\n ExampleApi.get(\"/users/1\")\n ExampleApi.post(client, \"/users\", %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#request/2-examples"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.request!/2","doc":"Perform request and raise in case of error.\n\nThis is similar to `request/2` behaviour from Tesla 0.x\n\nSee `request/2` for list of available options.","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#request!/2"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.trace/3","doc":"Perform a TRACE request.\n\nSee `request/1` or `request/2` for options definition.\n\n trace(\"/users\")\n trace(\"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\")\n trace(client, \"/users\", query: [scope: \"admin\"])\n trace(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#trace/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.trace!/3","doc":"Perform a TRACE request.\n\nSee `request!/1` or `request!/2` for options definition.\n\n trace!(\"/users\")\n trace!(\"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\")\n trace!(client, \"/users\", query: [scope: \"admin\"])\n trace!(client, \"/users\", body: %{name: \"Jon\"})","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#trace!/3"},{"type":"type","title":"Mix.Tasks.Lightning.InstallAdaptorIcons.option/0","doc":"Options that may be passed to a request function. See `request/2` for detailed descriptions.","ref":"Mix.Tasks.Lightning.InstallAdaptorIcons.html#t:option/0"},{"type":"task","title":"mix lightning.install_runtime","doc":"Installs the following NodeJS packages:\n\n- core\n- language-common","ref":"Mix.Tasks.Lightning.InstallRuntime.html"},{"type":"function","title":"Mix.Tasks.Lightning.InstallRuntime.packages/0","doc":"","ref":"Mix.Tasks.Lightning.InstallRuntime.html#packages/0"},{"type":"function","title":"Mix.Tasks.Lightning.InstallRuntime.run/1","doc":"","ref":"Mix.Tasks.Lightning.InstallRuntime.html#run/1"},{"type":"task","title":"mix lightning.install_schemas","doc":"Install the credential json schemas\nUse --exclude language-package1, language-package2 to exclude specific packages","ref":"Mix.Tasks.Lightning.InstallSchemas.html"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.delete/3","doc":"Issues a DELETE request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#delete/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.delete!/3","doc":"Issues a DELETE request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#delete!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.fetch_schemas/2","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#fetch_schemas/2"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.get/3","doc":"Issues a GET request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#get/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.get!/3","doc":"Issues a GET request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#get!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.head/3","doc":"Issues a HEAD request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#head/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.head!/3","doc":"Issues a HEAD request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#head!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.options/3","doc":"Issues an OPTIONS request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#options/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.options!/3","doc":"Issues a OPTIONS request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#options!/3"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.parse_excluded/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#parse_excluded/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.patch/4","doc":"Issues a PATCH request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#patch/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.patch!/4","doc":"Issues a PATCH request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#patch!/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.persist_schema/2","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#persist_schema/2"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.post/4","doc":"Issues a POST request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#post/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.post!/4","doc":"Issues a POST request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#post!/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_headers/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_headers/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_body/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_body/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_headers/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_headers/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_options/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_options/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_params/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_params/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_request_url/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_request_url/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response_body/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response_body/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response_chunk/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response_chunk/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response_headers/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response_headers/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_response_status_code/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_response_status_code/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_status_code/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_status_code/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.process_url/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#process_url/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.put/4","doc":"Issues a PUT request to the given url.\n\nReturns `{:ok, response}` if the request is successful, `{:error, reason}`\notherwise.\n\nSee `request/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#put/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.put!/4","doc":"Issues a PUT request to the given url, raising an exception in case of\nfailure.\n\nIf the request does not fail, the response is returned.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#put!/4"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.request/1","doc":"Issues an HTTP request using an `HTTPoison.Request` struct.\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/1"},{"type":"function","title":"Redirect handling - Mix.Tasks.Lightning.InstallSchemas.request/1","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/1-redirect-handling"},{"type":"function","title":"Examples - Mix.Tasks.Lightning.InstallSchemas.request/1","doc":"request = %HTTPoison.Request{\n method: :post,\n url: \"https://my.website.com\",\n body: \"{\\\"foo\\\": 3}\",\n headers: [{\"Accept\", \"application/json\"}]\n }\n\n request(request)","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/1-examples"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.request/5","doc":"Issues an HTTP request with the given method to the given url.\n\nThis function is usually used indirectly by `get/3`, `post/4`, `put/4`, etc\n\nArgs:\n * `method` - HTTP method as an atom (`:get`, `:head`, `:post`, `:put`,\n `:delete`, etc.)\n * `url` - target url as a binary string or char list\n * `body` - request body. See more below\n * `headers` - HTTP headers as an orddict (e.g., `[{\"Accept\", \"application/json\"}]`)\n * `options` - Keyword list of options\n\nBody: see type `HTTPoison.Request`\n\nOptions: see type `HTTPoison.Request`\n\nThis function returns `{:ok, response}`, `{:ok, async_response}`, or `{:ok, maybe_redirect}`\nif the request is successful, `{:error, reason}` otherwise.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/5"},{"type":"function","title":"Redirect handling - Mix.Tasks.Lightning.InstallSchemas.request/5","doc":"If the option `:follow_redirect` is given, HTTP redirects are automatically follow if\nthe method is set to `:get` or `:head` and the response's `status_code` is `301`, `302` or\n`307`.\n\nIf the method is set to `:post`, then the only `status_code` that get's automatically\nfollowed is `303`.\n\nIf any other method or `status_code` is returned, then this function returns a\nreturns a `{:ok, %HTTPoison.MaybeRedirect{}}` containing the `redirect_url` for you to\nre-request with the method set to `:get`.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/5-redirect-handling"},{"type":"function","title":"Examples - Mix.Tasks.Lightning.InstallSchemas.request/5","doc":"request(:post, \"https://my.website.com\", \"{\\\"foo\\\": 3}\", [{\"Accept\", \"application/json\"}])","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request/5-examples"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.request!/1","doc":"Issues an HTTP request an `HTTPoison.Request` struct.\nexception in case of failure.\n\n`request!/1` works exactly like `request/1` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request!/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.request!/5","doc":"Issues an HTTP request with the given method to the given url, raising an\nexception in case of failure.\n\n`request!/5` works exactly like `request/5` but it returns just the\nresponse in case of a successful request, raising an exception in case the\nrequest fails.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#request!/5"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.run/1","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#run/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.start/0","doc":"Starts HTTPoison and its dependencies.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#start/0"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.stream_next/1","doc":"Requests the next message to be streamed for a given `HTTPoison.AsyncResponse`.\n\nSee `request!/5` for more detailed information.","ref":"Mix.Tasks.Lightning.InstallSchemas.html#stream_next/1"},{"type":"function","title":"Mix.Tasks.Lightning.InstallSchemas.write_schema/3","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#write_schema/3"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.body/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:body/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.headers/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:headers/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.method/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:method/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.options/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:options/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.params/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:params/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.request/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:request/0"},{"type":"type","title":"Mix.Tasks.Lightning.InstallSchemas.url/0","doc":"","ref":"Mix.Tasks.Lightning.InstallSchemas.html#t:url/0"},{"type":"extras","title":"Lightning","doc":"# OpenFn/Lightning [![CircleCI](https://dl.circleci.com/status-badge/img/gh/OpenFn/lightning/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/OpenFn/lightning/tree/main) [![codecov](https://codecov.io/gh/OpenFn/lightning/branch/main/graph/badge.svg?token=FfDMxdGL3a)](https://codecov.io/gh/OpenFn/lightning) ![Docker Pulls](https://img.shields.io/docker/pulls/openfn/lightning)\n\nLightning ⚡ (aka \"OpenFn v2\") is a workflow automation platform that's used to\nautomate critical business processes and integrate information systems. From\nlast-mile services to national-level reporting, it boosts efficiency &\neffectiveness while enabling secure, stable, scalable interoperability and data\nintegration at all levels.\n\n**Use it online at [app.openfn.org](https://app.openfn.org)**\n\n**Explore in a sandbox on [demo.openfn.org](#demo-sandbox)**\n\n**Or learn more at\n[docs.openfn.org](https://docs.openfn.org/documentation/about-lightning)**\n\n> OpenFn **Lightning** is:\n>\n> - the **latest version** of OpenFn: first launched in 2014, it's been tried\n> and tested by NGOs and governments in 40+ countries\n> - fully **open source**: there's no \"community edition\" and \"premium edition\",\n> you get the same product whether you are self-hosting or using the\n> OpenFn.org software-as-a-service\n> - the leading [DPGA](https://digitalpublicgoods.net/) certified **Digital\n> Public Good** for workflow automation\n> - a [Digital Square](https://digitalsquare.org/digital-health-global-goods)\n> certified **Global Good for Health**","ref":"readme.html"},{"type":"extras","title":"Contents - Lightning","doc":"- [Demo](#demo)\n- [Features](#features)\n - [Build](#build)\n - [Monitor](#monitor)\n - [Manage](#manage)\n - [Roles and permissions](#roles-and-permissions)\n - [Roadmap](#roadmap)\n- [Getting Started](#getting-started)\n - [**Run** via Docker](#run-via-docker)\n - [**Deploy** on external infrastructure](#deploy-on-external-infrastructure)\n - [**Dev** on Lightning locally](#dev-on-lightning-locally)\n- [Security and Standards](#security-and-standards)\n- [**Contribute** to this project](#contribute-to-this-project)\n - [Pick up an issue](#pick-up-an-issue)\n - [Open a pull request](#open-a-pull-request)\n - [Generate the docs pages](#generate-the-docs-pages)\n- [Server Specs for Self-Hosting](#server-specs-for-self-hosting)\n- [Benchmarking](#benchmarking)\n- [Troubleshooting](#troubleshooting)\n - [Problems with environment variables](#problems-with-environment-variables)\n - [Problems with Postgres](#problems-with-postgres)\n - [Problems with Debian](#problems-with-debian)\n - [Problems with Docker](#problems-with-docker)\n - [Problems with Rambo](#problems-with-rambo)\n- [Support](#support)","ref":"readme.html#contents"},{"type":"extras","title":"Demo - Lightning","doc":"Watch a short [demo video](https://www.youtube.com/watch?v=BNaxlHAWb5I) or\nexplore a **[public sandbox](https://demo.openfn.org/)** with the login details\nbelow, but please note that this deployment is reset every night at 12:00:00 UTC\nand is 100% publicly accessible. **_Don't build anything you want to keep, or\nkeep private!_**\n\n```\nusername: demo@openfn.org\npassword: welcome12345\n```","ref":"readme.html#demo"},{"type":"extras","title":"Features - Lightning","doc":"","ref":"readme.html#features"},{"type":"extras","title":"Build - Lightning","doc":"Plan and build workflows using Lightning's visual interface to quickly define\nwhen, where and what you want your automation to do.\n\n \n \n \n\nUse our\n[CLI](https://github.com/OpenFn/kit/blob/main/packages/cli/README.md#openfncli)\nto quickly build, edit and deploy projects from the comfort of your own code\neditor.","ref":"readme.html#build"},{"type":"extras","title":"Monitor - Lightning","doc":"Monitor all workflow activity in one place.\n\n \n \n \n\n- Filter and search runs to identify issues that need addressing and follow how\n a specific request has been processed\n- Configure alerts to be notified on run failures\n- Receive a project digest for a daily/weekly/monthly summary of your project\n activity","ref":"readme.html#monitor"},{"type":"extras","title":"Manage - Lightning","doc":"Manage users and access by project.","ref":"readme.html#manage"},{"type":"extras","title":"Roles and permissions - Lightning","doc":"Authorization is a central part of Lightning. As such, users are given different\nroles which determine what level of access they have for resources in the\napplication. For more details about roles and permissions in Lightning, please\nrefer to our\n[documentation](https://docs.openfn.org/documentation/about-lightning#roles-and-permissions).","ref":"readme.html#roles-and-permissions"},{"type":"extras","title":"Roadmap - Lightning","doc":"View our\n[public GitHub project](https://github.com/orgs/OpenFn/projects/3/views/1) to\nsee what we're working on now and what's coming next.","ref":"readme.html#roadmap"},{"type":"extras","title":"Getting Started - Lightning","doc":"- If you only want to [_**RUN**_](#run-via-docker) Lightning on your own server,\n we recommend using Docker.\n- If you want to [_**DEPLOY**_](#deploy-on-external-infrastructure) Lightning,\n we recommend Docker builds and Kubernetes.\n- If you want to [_**CONTRIBUTE**_](#contribute-to-this-project) to the project,\n we recommend\n [running Lightning on your local machine](#run-lightning-locally).\n\n### **Run** via Docker\n\n1. Install the latest version of\n [Docker](https://docs.docker.com/engine/install/)\n2. Clone [this repo](https://github.com/OpenFn/Lightning) using git\n3. Setup PostgreSQL database with:\n `docker compose build && docker compose run --rm web mix ecto.migrate`\n4. Run Lightning and PostgresSQL with: `docker compose up`\n\nBy default the application will be running at\n[localhost:4000](http://localhost:4000/).\n\nSee [\"Problems with Docker\"](#problems-with-docker) for additional\ntroubleshooting help. Note that you can also create your own\n`docker-compose.yml` file, configuring a postgres database and using a\n[pre-built image](https://hub.docker.com/repository/docker/openfn/lightning)\nfrom Dockerhub.\n\n### **Deploy** on external infrastructure\n\nHead to the [Deploy](https://docs.openfn.org/documentation/deploy/options)\nsection of our docs site to get started.\n\nFor technical guidelines, see [deployment considerations](DEPLOYMENT.md) for\nmore detailed information.\n\n### **Dev** on Lightning locally\n\n#### Clone the repo and optionally set ENVs\n\n```sh\ngit clone git@github.com:OpenFn/Lightning.git # or from YOUR fork!\ncd Lightning\ncp .env.example .env # and adjust as necessary!\n```\n\nTake note of database names and ports in particular—they've got to match across\nyour Postgres setup and your ENVs. You can run lightning without any ENVs\nassuming a vanilla postgres setup (see below), but you may want to make\nadjustments.\n\n#### Database Setup\n\nIf you're already using Postgres locally, create a new database called\n`lightning_dev`, for example.\n\nIf you'd rather use Docker to set up a Postgres DB, create a new volume and\nimage:\n\n```sh\ndocker volume create lightning-postgres-data\n\ndocker create \\\n --name lightning-postgres \\\n --mount source=lightning-postgres-data,target=/var/lib/postgresql/data \\\n --publish 5432:5432 \\\n -e POSTGRES_PASSWORD=postgres \\\n postgres:15.3-alpine\n\ndocker start lightning-postgres\n```\n\n#### Elixir & Ecto Setup\n\nWe use [asdf](https://github.com/asdf-vm/asdf) to configure our local\nenvironments. Included in the repo is a `.tool-versions` file that is read by\nasdf in order to dynamically make the specified versions of Elixir and Erlang\navailable. You'll need asdf plugins for\n[Erlang](https://github.com/asdf-vm/asdf-erlang),\n[NodeJs](https://github.com/asdf-vm/asdf-nodejs)\n[Elixir](https://github.com/asdf-vm/asdf-elixir) and\n[k6](https://github.com/grimoh/asdf-k6).\n\nWe use [libsodium](https://doc.libsodium.org/) for encoding values as required\nby the\n[Github API](https://docs.github.com/en/rest/guides/encrypting-secrets-for-the-rest-api).\nYou'll need to install `libsodium` in order for the application to compile.\n\nFor Mac Users:\n\n```sh\nbrew install libsodium\n```\n\nFor Debian Users:\n\n```sh\nsudo apt-get install libsodium-dev\n```\n\nYou can find more on\n[how to install libsodium here](https://doc.libsodium.org/installation)\n\n```sh\nasdf install # Install language versions\n./bin/bootstrap\n```\n\n#### Run the app\n\nLightning is a web app. To run it in interactive Elixir mode, start the\ndevelopment server by running with your environment variables by running:\n\n```sh\niex -S mix phx.server\n```\n\nor if you have set up custom environment variables, run:\n\n```sh\nenv $(cat .env | grep -v \"#\" | xargs ) iex -S mix phx.server\n```\n\nOnce the server has started, head to [`localhost:4000`](http://localhost:4000)\nin your browser.\n\n#### Run the tests\n\nBefore the first time running the tests, you need a test database setup.\n\n```sh\nMIX_ENV=test mix ecto.create\n```\n\nAnd then after that run the tests using:\n\n```sh\nMIX_ENV=test mix test\n```\n\nWe also have `test.watch` installed which can be used to rerun the tests on file\nchanges.","ref":"readme.html#getting-started"},{"type":"extras","title":"Security and Standards - Lightning","doc":"We use a host of common Elixir static analysis tools to help us avoid common\npitfalls and make sure we keep everything clean and consistent.\n\nIn addition to our test suite, you can run the following commands:\n\n- `mix format --check-formatted` Code formatting checker, run again without the\n `--check-formatted` flag to have your code automatically changed.\n- `mix dialyzer` Static analysis for type mismatches and other common warnings.\n See [dialyxir](https://github.com/jeremyjh/dialyxir).\n- `mix credo --strict --all` Static analysis for consistency, and coding\n standards. See [Credo](https://github.com/rrrene/credo).\n- `mix sobelow` Check for commonly known security exploits. See\n [Sobelow](https://sobelow.io/).\n- `MIX_ENV=test mix coveralls` Test coverage reporter. This command also runs\n the test suite, and can be used in place of `mix test` when checking\n everything before pushing your code. See\n [excoveralls](https://github.com/parroty/excoveralls).\n\n> For convenience there is a `verify` mix task that runs all of the above and\n> defaults the `MIX_ENV` to `test`.\n\nFor more guidance on security best practices for workflow automation\nimplementations, check out OpenFn Docs:\n[docs.openfn.org/documentation/getting-started/security](https://docs.openfn.org/documentation/getting-started/security)\n\n## **Contribute** to this project\n\nFirst, thanks for being here! You're contributing to a digital public good that\nwill always be free and open source and aimed at serving innovative NGOs,\ngovernments, and social impact organizations the world over! You rock. ❤️\n\nFYI, Lightning is built in [Elixir](https://elixir-lang.org/), harnessing the\n[Phoenix Framework](https://www.phoenixframework.org/). Currently, the only\nunbundled dependency is a [PostgreSQL](https://www.postgresql.org/) database.\n\nIf you'd like to contribute to this projects, follow the steps below:","ref":"readme.html#security-and-standards"},{"type":"extras","title":"Pick up an issue - Lightning","doc":"Read through the existing [issues](https://github.com/OpenFn/Lightning/issues),\nassign yourself to the issue you have chosen. Leave a comment on the issue to\nlet us know you'll be working on it, and if you have any questions of\nclarifications that would help you get started ask them there - we will get back\nto you as soon as possible.\n\nIf there isn't already an issue for the feature you would like to contribute,\nplease start a discussion in our\n[community forum](https://community.openfn.org/c/feature-requests/12).","ref":"readme.html#pick-up-an-issue"},{"type":"extras","title":"Open a pull request - Lightning","doc":"1. Clone the Lightning repository, then\n [fork it](https://docs.github.com/en/get-started/quickstart/fork-a-repo).\n\n2. Run through [setting up your environment](#set-up-your-environment) and make\n your changes.\n\n3. Make sure you have written your tests and updated /CHANGELOG.md (in the\n 'Unreleased' section, add a short description of the changes you are making,\n along with a link to your issue).\n\n4. Open a draft pull request by clicking \"Contribute > Open Pull Request\" from\n your forked repository. Fill out the pull request template (this will **be**\n added automatically for you), then make sure to self-review your code and go\n through the 'Review checklist'. Don't worry about the QA checkbox, our\n product manager Amber will tick that once she has reviewed your PR. You can\n leave any notes for the reviewer in a comment.\n\n5. Once you're ready to submit a pull request, you can mark your draft PR as\n 'Ready for review' and assign @stuartc or @taylordowns2000.","ref":"readme.html#open-a-pull-request"},{"type":"extras","title":"Generate the docs pages - Lightning","doc":"You can generate the HTML and EPUB documentation locally using:\n\n`mix docs` and opening `doc/index.html` in your browser.","ref":"readme.html#generate-the-docs-pages"},{"type":"extras","title":"Server Specs for Self-Hosting - Lightning","doc":"For recommend server specifications for self-hosting of Lightning, head to the\n[deployment planning](https://docs.openfn.org/documentation/deploy/options)\nsection of the documentation or check out this\n[self-hosting thread](https://community.openfn.org/t/specs-for-self-hosting-lightning/292)\non our community forum.","ref":"readme.html#server-specs-for-self-hosting"},{"type":"extras","title":"Benchmarking - Lightning","doc":"We are using [k6](https://k6.io/) to benchmark Lightning. Under `benchmarking`\nfolder you can find a script for benchmarking Webhook Workflows.\n\nSee [Benchmarking](benchmarking/README.md) for more detailed information.","ref":"readme.html#benchmarking"},{"type":"extras","title":"Troubleshooting - Lightning","doc":"","ref":"readme.html#troubleshooting"},{"type":"extras","title":"Problems with environment variables - Lightning","doc":"For troubleshooting custom environment variable configuration it's important to\nknow how an Elixir app loads and modifies configuration. The order is as\nfollows:\n\n1. Stuff in `config.exs` is loaded.\n2. _That_ is then modified (think: _overwritten_) by stuff your ENV-specific\n config: `dev.exs`, `prod.exs` or `test.exs`.\n3. _That_ is then modified by `runtime.exs` which is where you are allowed to\n use `System.env()`\n4. _Finally_ `init/2` (if present in a child application) gets called (which\n takes the config which has been set in steps 1-3) when that child application\n is started during the parent app startup defined in `application.ex`.","ref":"readme.html#problems-with-environment-variables"},{"type":"extras","title":"Problems with Postgres - Lightning","doc":"If you're having connecting issues with Postgres, check the database section of\nyour `.env` to ensure the DB url is correctly set for your environment — note\nthat composing a DB url out of other, earlier declared variables, does not work\nwhile using `xargs`.","ref":"readme.html#problems-with-postgres"},{"type":"extras","title":"Problems with Debian - Lightning","doc":"If you're getting this error on debian\n\n```\n==> earmark_parser\nCompiling 1 file (.yrl)\n/usr/lib/erlang/lib/parsetools-2.3.1/include/yeccpre.hrl: no such file or directory\ncould not compile dependency :earmark_parser, \"mix compile\" failed. You can recompile this dependency with \"mix deps.compile earmark_parser\", update it with \"mix deps.update earmark_parser\" or clean it with \"mix deps.clean earmark_parser\"\n```\n\nYou need to install erlang development environment `sudo apt install erlang-dev`\n[refer to this issue](https://github.com/elixir-lang/ex_doc/issues/1441)","ref":"readme.html#problems-with-debian"},{"type":"extras","title":"Problems with Docker - Lightning","doc":"#### Versions\n\nThe build may not work on old versions of Docker and Docker compose. It has been\ntested against:\n\n```\nDocker version 20.10.17, build 100c701\nDocker Compose version v2.6.0\n```\n\n#### Starting from scratch\n\nIf you're actively working with docker, you start experiencing issues, and you\nwould like to start from scratch you can clean up everything and start over like\nthis:\n\n```sh\n# To remove any ignored files and reset your .env to it's example\ngit clean -fdx && cp .env.example .env\n# You can skip the line below if you want to keep your database\ndocker compose down --rmi all --volumes\n\ndocker compose build --no-cache web && \\\n docker compose create --force-recreate\n\ndocker compose run --rm web mix ecto.migrate\ndocker compose up\n```\n\n#### Apple Silicon\n\nWhen running `docker compose up` on Apple Silicon (M1, M2, M3), you might encounter the following error:\n\n```\n> [web 20/20] RUN npm install --prefix assets:\n0.091 rosetta error: failed to open elf at /lib64/ld-linux-x86-64.so.2\n0.091 Trace/breakpoint trap\n------\nfailed to solve: process \"/bin/sh -c npm install --prefix assets\" did not complete successfully: exit code: 133\n```\n\nYou can solve this by setting the default docker platform to `linux/amd64`, i.e. `DOCKER_DEFAULT_PLATFORM=linux/amd64`.\nYou can read more on this here: https://stackoverflow.com/questions/71040681/qemu-x86-64-could-not-open-lib64-ld-linux-x86-64-so-2-no-such-file-or-direc\n\nYou might also run into:\n\n```\n[notice] Application ssl exited: exited in: :ssl_app.start(:normal, [])\n ** (EXIT) an exception was raised:\n ** (ArgumentError) could not call Module.put_attribute/3 because the module Lightning.MixProject is already compiled\n (elixir 1.16.2) lib/module.ex:2360: Module.assert_not_readonly!/2\n (elixir 1.16.2) lib/module.ex:2041: Module.__put_attribute__/5\n (ssl 11.1.4) ssl_app.erl:35: :ssl_app.stop/1\n (kernel 9.2.4) application_master.erl:293: :application_master.start_it_old/4\n\n** (MatchError) no match of right hand side value: {:error, {:ssl, {:bad_return, {{:ssl_app, :start, [:normal, []]}, {:EXIT, {%ArgumentError{message: \"could not call Module.put_attribute/3 because the module Lightning.MixProject is already compiled\"}, [{Module, :assert_not_readonly!, 2, [file: ~c\"lib/module.ex\", line: 2360]}, {Module, :__put_attribute__, 5, [file: ~c\"lib/module.ex\", line: 2041]}, {:ssl_app, :stop, 1, [file: ~c\"ssl_app.erl\", line: 35]}, {:application_master, :start_it_old, 4, [file: ~c\"application_master.erl\", line: 293]}]}}}}}}\n```\n\nYou can resolve this by setting `ERL_FLAGS=\"+JPperf true\"` env to the failing stage.\nYou can follow this thread on our community forum for more info: https://community.openfn.org/t/lightning-prebuilt-images-throw-no-matching-manifest-for-linux-arm64-v8-in-the-manifest-list-entries/465/15","ref":"readme.html#problems-with-docker"},{"type":"extras","title":"Problems with Rambo - Lightning","doc":"When running `mix compile.rambo` on Apple Silicon (an Apple M1/M2, `macarm`,\n`aarch64-apple-darwin`) and encountering the following error:\n\n```\n** (RuntimeError) Rambo does not ship with binaries for your environment.\n\n aarch64-apple-darwin22.3.0 detected\n\nInstall the Rust compiler so a binary can be prepared for you.\n\n lib/mix/tasks/compile.rambo.ex:89: Mix.Tasks.Compile.Rambo.compile!/0\n lib/mix/tasks/compile.rambo.ex:51: Mix.Tasks.Compile.Rambo.run/1\n (mix 1.14.2) lib/mix/task.ex:421: anonymous fn/3 in Mix.Task.run_task/4\n (mix 1.14.2) lib/mix/cli.ex:84: Mix.CLI.run_task/2\n```\n\nYou can resolve this error by installing the Rust compiler using Homebrew. Run\nthe following command in your terminal: `brew install rust`\n\nIf you have already compiled Rambo explicitly via `mix compile.rambo`, and you\nare still seeing the following error:\n\n```\nsh: /path_to_directory/Lightning/_build/dev/lib/rambo/priv/rambo: No such file or directory\nsh: line 0: exec: /path_to_directory/Lightning/_build/dev/lib/rambo/priv/rambo: cannot execute: No such file or directory\n```\n\nYou can try renaming `deps/rambo/priv/rambo-mac` to `deps/rambo/priv/rambo`.\n\nIf neither of the approaches above work, please raise an issue.","ref":"readme.html#problems-with-rambo"},{"type":"extras","title":"Support - Lightning","doc":"If you have any questions, feedback, or issues, please:\n\n- Post on the OpenFn Community at\n [community.openfn.org](https://community.openfn.org)\n- Open an issue directly on this GitHub Repo:\n [github.com/OpenFn/Lightning/issues](https://github.com/OpenFn/Lightning/issues)","ref":"readme.html#support"},{"type":"extras","title":"Running Locally","doc":"# Running Lightning Locally\n\nThis guide provides instructions for running Lightning locally, either by\ninstalling dependencies on your machine or using Docker.","ref":"runninglocal.html"},{"type":"extras","title":"By Installing Dependencies - Running Locally","doc":"","ref":"runninglocal.html#by-installing-dependencies"},{"type":"extras","title":"Setup - Running Locally","doc":"#### Postgres\nRequires `postgres 15`.\nWhen running in `dev` mode, the app will use the following credentials to authenticate:\n- `PORT`: `5432`\n- `USER`: `postgres`\n- `PASSWORD`: `postgres`\n- `DATABASE`: `lightning_dev`\n\nThis can however be overriden by specifying a `DATABASE_URL` env var.\ne.g. `DATABASE_URL=postgresql://postgres:postgres@localhost:5432/lightning_dev`\n\nWe recommend that you use docker for running postgres as you'll get an exact version that we use:\n\n```sh\ndocker volume create lightning-postgres-data\n\ndocker create \\\n --name lightning-postgres \\\n --mount source=lightning-postgres-data,target=/var/lib/postgresql/data \\\n --publish 5432:5432 \\\n -e POSTGRES_PASSWORD=postgres \\\n postgres:15.3-alpine\n\ndocker start lightning-postgres\n```\n\n#### Elixir, NodeJS\nWe use [asdf](https://github.com/asdf-vm/asdf) to configure our local\nenvironments. Included in the repo is a `.tool-versions` file that is read by\nasdf in order to dynamically make the specified versions of Elixir, Erlang and NodeJs\navailable. You'll need asdf plugins for\n[Erlang](https://github.com/asdf-vm/asdf-erlang),\n[NodeJs](https://github.com/asdf-vm/asdf-nodejs)\n[Elixir](https://github.com/asdf-vm/asdf-elixir) and\n[k6](https://github.com/grimoh/asdf-k6).\n\n#### Libsodium\nWe use [libsodium](https://doc.libsodium.org/) for encoding values as required\nby the\n[Github API](https://docs.github.com/en/rest/guides/encrypting-secrets-for-the-rest-api).\nYou'll need to install `libsodium` in order for the application to compile.\n\nFor Mac Users:\n\n```sh\nbrew install libsodium\n```\n\nFor Debian Users:\n\n```sh\nsudo apt-get install libsodium-dev\n```\n\nYou can find more on\n[how to install libsodium here](https://doc.libsodium.org/installation)\n\n#### Compilation and Assets\n\n```sh\nasdf install # Install language versions\nmix local.hex\nmix deps.get\nmix local.rebar --force\n[[ $(uname -m) == 'arm64' ]] && CPATH=/opt/homebrew/include LIBRARY_PATH=/opt/homebrew/lib mix deps.compile enacl # Force compile enacl if on M1\n[[ $(uname -m) == 'arm64' ]] && mix compile.rambo # Force compile rambo if on M1\nmix lightning.install_runtime\nmix lightning.install_schemas\nmix lightning.install_adaptor_icons\nmix ecto.create\nmix ecto.migrate\nnpm install --prefix assets\n```\n\nIn case you encounter errors running any of these commands, see the [troubleshooting guide](README.md#troubleshooting) for\nknown errors.","ref":"runninglocal.html#setup"},{"type":"extras","title":"Running the App - Running Locally","doc":"To start the lightning server:\n\n```sh\nmix phx.server\n```\n\nOnce the server has started, head to [`localhost:4000`](http://localhost:4000)\nin your browser.\n\nBy default, the `worker` is started when run `mix phx.server` in `dev` mode. In case you\ndon't want to have your worker started in `dev`, set `RTM=false`:\n\n```sh\nRTM=false mix phx.server\n```","ref":"runninglocal.html#running-the-app"},{"type":"extras","title":"Using Docker - Running Locally","doc":"There is an existing `docker-compose.yaml` file in the project's root which has all the\nservices required. To start your services:\n\n```sh\ndocker compose up\n```\n\nThere 2 docker files in the root, `Dockerfile` builds the app in `prod` mode while `Dockerfile-dev`\nruns it in `dev` mode. It is important to note that `mix commands` do not work in the `prod` images.\n\nFor exmaple, to run migrations in `dev` mode you run:\n\n```sh\ndocker compose run --rm web mix ecto.migrate\n```\n\nWhile in `prod` mode:\n\n```sh\ndocker compose run --rm web /app/bin/lightning eval \"Lightning.Release.migrate()\"\n```","ref":"runninglocal.html#using-docker"},{"type":"extras","title":"Configuring the Worker - Running Locally","doc":"By default, lightning starts the `worker` when running in `dev`. This can also be configured using\n`RTM` env var. In case you don't want the hassle of configuring the worker in `dev`, you can just\nremove/comment out the `worker` service from the `docker-compose.yaml` file because lightning will\nstart it for you.\n\n[Learn more about configuring workers](WORKERS.md)","ref":"runninglocal.html#configuring-the-worker"},{"type":"extras","title":"Problems with Apple Silicon - Running Locally","doc":"You might run into some errors when running the docker containers on Apple Silicon.\n[We have documented the known ones here](README.md#problems-with-docker)","ref":"runninglocal.html#problems-with-apple-silicon"},{"type":"extras","title":"Deployment","doc":"# Deployment\n\nHead to the [Deploy](https://docs.openfn.org/documentation/deploy/options)\nsection of our docs site to get started.\n\nSee below for technical considerations and instructions.","ref":"deployment.html"},{"type":"extras","title":"Encryption - Deployment","doc":"Lightning enforces encryption at rest for credentials, TOTP backup codes, and\nwebhook trigger authentication methods, for which an encryption key must be\nprovided when running in production.\n\nThe key is expected to be a randomized set of bytes, 32 long; and Base64 encoded\nwhen setting the environment variable.\n\nThere is a mix task that can generate keys in the correct shape for use as an\nenvironment variable:\n\n```sh\nmix lightning.gen_encryption_key\n0bJ9w+hn4ebQrsCaWXuA9JY49fP9kbHmywGd5K7k+/s=\n```\n\nCopy your key _(NOT THIS ONE)_ and set it as `PRIMARY_ENCRYPTION_KEY` in your\nenvironment.","ref":"deployment.html#encryption"},{"type":"extras","title":"Workers - Deployment","doc":"Lightning uses external worker processes for executing Runs. There are three\nsettings required to configure worker authentication.\n\n- `WORKER_RUNS_PRIVATE_KEY`\n- `WORKER_LIGHTNING_PUBLIC_KEY`\n- `WORKER_SECRET`\n\nYou can use the `mix lightning.gen_worker_keys` task to generate these for\nconvenience.\n\nFor more information see the [Workers](WORKERS.md) documentation.","ref":"deployment.html#workers"},{"type":"extras","title":"Environment Variables - Deployment","doc":"Note that for secure deployments, it's recommended to use a combination of\n`secrets` and `configMaps` to generate secure environment variables.","ref":"deployment.html#environment-variables"},{"type":"extras","title":"Limits - Deployment","doc":"- `WORKER_MAX_RUN_MEMORY_MB` - how much memory (in MB) can a single run use?\n- `RUN_GRACE_PERIOD_SECONDS` - how long _after_ the `MAX_RUN_DURATION_SECONDS`\n should the server wait for the worker to send back data on a run.\n- `WORKER_MAX_RUN_DURATION_SECONDS` - the maximum duration (in seconds) that\n workflows are allowed to run (keep this plus `RUN_GRACE_PERIOD_SECONDS` below\n your termination_grace_period if using kubernetes)\n- `WORKER_CAPACITY` - the number of runs a ws-worker instance will take on\n concurrently.\n- `MAX_DATACLIP_SIZE_MB` - the maximum size (in MB) of a dataclip created via\n the webhook trigger URL for a job. This limits the max request size via the\n JSON plug and may (in future) limit the size of dataclips that can be stored\n as run_results via the websocket connection from a worker.","ref":"deployment.html#limits"},{"type":"extras","title":"Github - Deployment","doc":"Lightning enables connection to github via Github Apps. The following github\npermissions are needed for the github app:\n\n| **Resource** | **Access** |\n| ------------ | -------------- |\n| Actions | Read and Write |\n| Contents | Read and Write |\n| Metadata | Read only |\n| Secrets | Read and Write |\n| Workflows | Read and Write |\n\nEnsure you set the following URLs:\n* **Homepage URL:** ` `\n* **Callback URL for authorizing users:** ` /oauth/github/callback` (Do NOT check the two checkboxes in this section requesting Device Flow and OAuth.)\n* **Setup URL for Post installation:** ` /setup_vcs` (Check the box for **Redirect on update**)\n\nThese envrionment variables will need to be set in order to configure the github\napp:\n\n| **Variable** | **Description** |\n| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |\n| `GITHUB_APP_ID` | the github app ID. |\n| `GITHUB_APP_NAME` | the github app name. This is the name used in the public link. It is the downcased name with spaces replaced with hyphens |\n| `GITHUB_APP_CLIENT_ID` | the github app Client ID |\n| `GITHUB_APP_CLIENT_SECRET` | the github app Client Secret |\n| `GITHUB_CERT` | the github app private key (Base 64 encoded) |\n\nYou can access these from your github app settings menu. Also needed for the\nconfiguration is:\n\n- `REPO_CONNECTION_SIGNING_SECRET` - secret used to sign access tokens. This\n access token is used to authenticate requests made from the github actions.\n You can generate this using `mix lightning.gen_encryption_key`","ref":"deployment.html#github"},{"type":"extras","title":"Storage - Deployment","doc":"Lightning can use a storage backend to store exports.\n\n| **Variable** | Description |\n| ----------------- | ------------------------------------------------ |\n| `STORAGE_BACKEND` | the storage backend to use. (default is `local`) |\n| `STORAGE_PATH` | the path to store files in. (default is `.`) |\n\n#### Supported backends:\n\n- `local` - local file storage\n- `gcs` - Google Cloud Storage\n\n#### Google Cloud Storage\n\nFor Google Cloud Storage, the following environment variables are required:\n\n| **Variable** | Description |\n| ------------------------------------- | -------------------------------------------------------------------------------- |\n| `GCS_BUCKET` | the name of the bucket to store files in |\n| `GOOGLE_APPLICATION_CREDENTIALS_JSON` | A base64 encoded JSON keyfile for the service account with access to the bucket. |\n\n> ℹ️ Note: The `GOOGLE_APPLICATION_CREDENTIALS_JSON` should be base64 encoded,\n> currently Workload Identity is not supported.","ref":"deployment.html#storage"},{"type":"extras","title":"Other config - Deployment","doc":"| **Variable** | Description |\n| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `ADAPTORS_PATH` | Where you store your locally installed adaptors |\n| `ALLOW_SIGNUP` | Set to `true` to enable user access to the registration page. Set to `false` to disable new user registrations and block access to the registration page. Default is `true`. |\n| `CORS_ORIGIN` | A list of acceptable hosts for browser/cors requests (',' separated) |\n| `DISABLE_DB_SSL` | In production, the use of an SSL connection to Postgres is required by default. Setting this to `\"true\"` allows unencrypted connections to the database. This is strongly discouraged in a real production environment. |\n| `EMAIL_ADMIN` | This is used as the sender email address for system emails. It is also displayed in the menu as the support email. |\n| `EMAIL_SENDER_NAME` | This is displayed in the email client as the sender name for emails sent by the application. |\n| `IDLE_TIMEOUT` | The number of seconds that must pass without data being received before the Lightning web server kills the connection. |\n| `IS_RESETTABLE_DEMO` | If set to `yes`, it allows this instance to be reset to the initial \"Lightning Demo\" state. Note that this will destroy _most_ of what you have in your database! |\n| `K8S_HEADLESS_SERVICE` | This environment variable is automatically set if you're running on GKE and it is used to establish an Erlang node cluster. Note that if you're _not_ using Kubernetes, the \"gossip\" strategy is used to establish clusters. |\n| `LISTEN_ADDRESS` | The address the web server should bind to. Defaults to `127.0.0.1` to block access from other machines. |\n| `LOG_LEVEL` | How noisy you want the logs to be (e.g., `debug`, `info`) |\n| `MIX_ENV` | Your mix env, likely `prod` for deployment |\n| `NODE_ENV` | Node env, likely `production` for deployment |\n| `ORIGINS` | The allowed origins for web traffic to the backend |\n| `PORT` | The port your Phoenix app runs on |\n| `PRIMARY_ENCRYPTION_KEY` | A base64 encoded 32 character long string. See [Encryption](#encryption). |\n| `QUEUE_RESULT_RETENTION_PERIOD_SECONDS` | The number of seconds to keep completed (successful) `ObanJobs` in the queue (not to be confused with runs and/or history) |\n| `SCHEMAS_PATH` | Path to the credential schemas that provide forms for different adaptors |\n| `SECRET_KEY_BASE` | A secret key used as a base to generate secrets for encrypting and signing data. |\n| `SENTRY_DSN` | If using Sentry for error monitoring, your DSN |\n| `URL_HOST` | The host used for writing URLs (e.g., `demo.openfn.org`) |\n| `URL_PORT` | The port, usually `443` for production |\n| `URL_SCHEME` | The scheme for writing URLs (e.g., `https`) |\n| `USAGE_TRACKER_HOST` | The host that receives usage tracking submissions (defaults to https://impact.openfn.org) |\n| `USAGE_TRACKING_DAILY_BATCH_SIZE` | The number of days that will be reported on with each run of `UsageTracking.DayWorker`. This will only have a noticeable effect in cases where there is a backlog or where reports are being generated retroactively (defaults to 10). |\n| `USAGE_TRACKING_ENABLED` | Enables the submission of anonymized usage data to OpenFn (defaults to `true`) |\n| `USAGE_TRACKING_RESUBMISSION_BATCH_SIZE` | The number of failed reports that will be submitted on each resubmission run (defaults to 10) |\n| `USAGE_TRACKING_UUIDS` | Indicates whether submissions should include cleartext UUIDs or not. Options are `cleartext` or `hashed_only`, with the default being `hashed_only`. |","ref":"deployment.html#other-config"},{"type":"extras","title":"AI Chat - Deployment","doc":"🧪 **Experimental**\n\nLightning can be configured to use an AI chatbot for user interactions.\n\nSee [openfn/apollo](https://github.com/OpenFn/apollo) for more information on\nthe Apollo AI service.\n\nThe following environment variables are required:\n\n- `OPENAI_API_KEY` - your OpenAI API key.\n- `APOLLO_ENDPOINT` - the endpoint for the OpenFn Apollo AI service.","ref":"deployment.html#ai-chat"},{"type":"extras","title":"Kafka Triggers - Deployment","doc":"🧪 **Experimental**\n\nLightning workflows can be configured with a trigger that will consume messages\nfrom a Kafka Cluster. By default this is disabled and you will not see the\noption to create a Kafka trigger in the UI, nor will the Kafka consumer groups\nbe running.\n\nTo enable this feature set the `KAFKA_TRIGGERS_ENABLED` environment variable to\n`yes` and restart Lightning. Please note that, if you enable this feature and\nthen create some Kafka triggers and then disable the feature, you will not be\nable to edit any triggers created before the feature was disabled.\n\n#### Performance Tuning\n\nThe number of Kafka consumers in the consumer group can be modified by setting\nthe `KAFKA_NUMBER_OF_CONSUMERS` environment variable. The default value is\ncurrently 1. The optimal setting is one consumer per topic partition. NOTE: This\nsetting will move to KafkaConfiguration as it will be trigger-specific.\n\nThe number of messages that the Kafka consumer will forward is rate-limited by\nthe `KAFKA_NUMBER_OF_MESSAGES_PER_SECOND` environment variable. This can be set\nto a value of less than 1 (minimum 0.1) and will converted (and rounded-down) to\nan integer value of messages over a 10-second interval (e.g. 0.15 becomes 1\nmessage every 10 seconds). The default value is 1.\n\nProcessing concurrency within the Kafka Broadway pipeline is controlled by the\n`KAFKA_NUMBER_OF_PROCESSORS` environment variable. Modifying this, modifies the\nnumber of processors that are downstream of the Kafka consumer, so an increase\nin this value should increase throughput (when factoring in the rate limit set\nby `KAFKA_NUMBER_OF_MESSAGES_PER_SECOND`). The default value is 1.\n\n#### Deduplication\n\nEach Kafka trigger maintains record of the topic, parition and offset for each\nmessage received. This to protect against the ingestion of duplicate messages\nfrom the cluster. These records are periodically cleaned out. The duration for\nwhich they are retained is controlled by\n`KAFKA_DUPLICATE_TRACKING_RETENTION_SECONDS`. The default value is 3600.\n\n#### Disabling Kafka Triggers\n\nAfter a Kafka consumer group connects to a Kafka cluster, the cluster will track\nthe last committed offset for a given consumer group ,to ensure that the consumer\ngroup receives the correct messages.\n\nThis data is retained for a finite period. If an enabled Kafka trigger is\ndisabled for longer than the offset retention period the consumer group offset\ndata will be cleared.\n\nIf the Kafka trigger is re-enabled after the offset data has been cleared, this\nwill result in the consumer group reverting to what has been configured as the\n'Initial offset reset policy' for the trigger. This may result in the\nduplication of messages or even data loss.\n\nIt is recommended that you check the value of the `offsets.retention.minutes` for\nthe Kafka cluster to determine what the cluster's retention period is, and\nconsider this when disabling a Kafka trigger for an extended period.\n\n#### Failure notifications\n\nUnder certain failure conditions, a Kafka trigger will send an email to certain\nuser that are associated with a project. After each email an embargo is applied\nto ensure that Lightning does not flood the recipients with email. The length\nof the embargo is controlled by the `KAFKA_NOTIFICATION_EMBARGO_SECONDS` ENV\nvariable.\n\n#### Persisting Failed Messages\n\n**PLEASE NOTE: If alternate file storage is not enabled, messages that fail\nto be persisted will not be retained by Lightning ans this can result in data\nloss, if the Kafka cluster can not make these messages available again.**\n\nIf a Kafka message files to be persisted as a WorkOrder, Run and Dataclip, the \noption exists to write the failed message to a location on the local file system.\nIf this option is enabled by setting `KAFKA_ALTERNATE_STORAGE_ENABLED`, then the\n`KAFKA_ALTERNATE_STORAGE_PATH` ENV variable must be set to the path that exists\nand is writable by Lightning. The location shoudl also be suitably protected to\nprevent data exposure as Lightning **will not encrypt** the message contents when\nwriting it.\n\nIf the option is enabled and a message fails to be persisted, Lightning will\ncreate a subdirectory named with the id if the affected trigger's workflow \nin the location specified by `KAFKA_ALTERNATE_STORAGE_PATH` (assuming such a\nsubdirectory does not already exist). Lightning will serialise the message\nheaders and data as received by the Kafka pipeline and write this to a file\nwithin the subdirectory. The file will be named based on the pattern \n` _ _ _ .json`.\n\nTo recover the persisted messages, it is suggested that the affected triggers\nbe disabled before commencing. Once this is done, the following code needs to\nbe run from an IEx console on each node that is running Lightning:\n\n```elixir\nLightning.KafkaTriggers.MessageRecovery.recover_messages(\n Lightning.Config.kafka_alternate_storage_file_path()\n)\n```\n\nFurther details regarding the behaviour of `MessageRecovery.recover_messages/1` \ncan be found in the module documentation of `MessageRecovery`. Recovered\nmessages will have the `.json` extension modified to `.json.recovered` but they\nwill be left in place. Future recovery runs will not process files that have\nbeen marked as recovered.\n\nOnce all files have either been recovered or discarded, the triggers can be\nenabled once more.","ref":"deployment.html#kafka-triggers"},{"type":"extras","title":"Google Oauth2 - Deployment","doc":"Using your Google Cloud account, provision a new OAuth 2.0 Client with the 'Web\napplication' type.\n\nSet the callback url to: `https:// /authenticate/callback`.\nReplacing `ENDPOINT DOMAIN` with the host name of your instance.\n\nOnce the client has been created, get/download the OAuth client JSON and set the\nfollowing environment variables:\n\n| **Variable** | Description |\n| ---------------------- | --------------------------------------------- |\n| `GOOGLE_CLIENT_ID` | Which is `client_id` from the client details. |\n| `GOOGLE_CLIENT_SECRET` | `client_secret` from the client details. |","ref":"deployment.html#google-oauth2"},{"type":"extras","title":"Salesforce Oauth2 - Deployment","doc":"Using your Salesforce developer account, create a new Oauth 2.0 connected\napplication.\n\nSet the callback url to: `https:// /authenticate/callback`.\nReplacing `ENDPOINT DOMAIN` with the host name of your instance.\n\nGrant permissions as desired.\n\nOnce the client has been created set the following environment variables:\n\n| **Variable** | Description |\n| -------------------------- | --------------------------------------------------------------------- |\n| `SALESFORCE_CLIENT_ID` | Which is `Consumer Key` from the \"Manage Consumer Details\" screen. |\n| `SALESFORCE_CLIENT_SECRET` | Which is `Consumer Secret` from the \"Manage Consumer Details\" screen. |","ref":"deployment.html#salesforce-oauth2"},{"type":"extras","title":"Benchmarking","doc":"# Benchmarking","ref":"benchmarking.md.html"},{"type":"extras","title":"Run benchmarking tests against the demo webhook - Benchmarking","doc":"Execute the following steps to run a benchmark on Lightning:\n\n1. Make sure you have [k6](https://k6.io/docs/get-started/installation/)\n installed locally. If you're using `asdf` you can run `asdf install` in the\n project root.\n\n2. Start up a local Lightning instance with an attached iex session. Note that\n to simulate a production environment, set `RTM=false`. In prod, you'll have\n your `ws-worker` running on a separate machine:\n\n `RMT=false iex -S mix phx.server`\n\n3. In the attached iex session, run the following, to have Lightning log\n internal telemetry data:\n\n ```elixir\n filepath = Path.join(\"benchmarking\", \"load_test_data.csv\")\n output_file = File.open!(filepath, [:append])\n\n c \"benchmarking/load_test_production_spans.exs\"\n\n LoadTestingPrep.init(output_file)\n ```\n\n4. Run the demo setup script: `mix run --no-start priv/repo/demo.exs` The\n `webhookURL` is already set to default to the webhook created in the demo\n data\n\n If you would like to point at a different instance or webhook url you\n can provide it via `WEBHOOK_URL`.\n\n5. In another terminal (do not stop the Lightning server) run the\n `benchmarking/script.js` file using the following command\n\n ```bash\n k6 run benchmarking/script.js\n ```\n\n If the script exits successfully, this means the app met the defined\n performance thresholds.\n\n By default, the test payload is just 2 kb. Should you wish to test it with\n larger payloads, you can pass in the `PAYLOAD_SIZE_KB` ENV variable. This\n variable allows you to specify the payload size in KB (for now, integer\n values only), (e.g. 2 KB):\n\n ```bash\n k6 run -e PAYLOAD_SIZE_KB=2 benchmarking/script.js\n ```\n\n To collect the benchmarking data in a CSV file, run the previous command with\n the `--out filename` option.\n\n ```bash\n k6 run --out csv=test_results.csv benchmarking/script.js\n ```\n\n6. In the iex session, close the output file:\n\n ```elixir\n LoadTestingPrep.fin(output_file)\n ```\n\nSee [results output](https://k6.io/docs/get-started/results-output/) for other\navailable output formats.","ref":"benchmarking.md.html#run-benchmarking-tests-against-the-demo-webhook"},{"type":"extras","title":"Sample benchmarks - Benchmarking","doc":"#### System specs on a 2020 MacBook Pro\n\n```\nModel Name: MacBook Pro\nModel Identifier: MacBookPro17,1\nModel Number: Z11B000E3LL/A\nChip: Apple M1\nTotal Number of Cores: 8 (4 performance and 4 efficiency)\nMemory: 16 GB\n```\n\n#### Results with 50kb payloads\n\n```\nk6 run -e PAYLOAD_SIZE=10 benchmarking/script.js Node 18.17.1 k6 0.43.1 07:40:29\n\n /\\ |‾‾| /‾‾/ /‾‾/\n /\\ / \\ | |/ / / /\n / \\/ \\ | ( / ‾‾\\\n / \\ | |\\ \\ | (‾) |\n / __________ \\ |__| \\__\\ \\_____/ .io\n\n execution: local\n script: benchmarking/script.js\n output: -\n\n scenarios: (100.00%) 1 scenario, 50 max VUs, 2m50s max duration (incl. graceful stop):\n * webhookRequests: Up to 50.00 iterations/s for 2m20s over 3 stages (maxVUs: 50, gracefulStop: 30s)\n\n\n ✓ status was 200\n\n █ setup\n\n checks.........................: 100.00% ✓ 5765 ✗ 0\n data_received..................: 1.6 MB 12 kB/s\n data_sent......................: 59 MB 421 kB/s\n http_req_blocked...............: avg=16.01µs min=2µs med=9µs max=6.84ms p(90)=12µs p(95)=13µs\n http_req_connecting............: avg=4.35µs min=0s med=0s max=2.22ms p(90)=0s p(95)=0s\n ✓ http_req_duration..............: avg=53.62ms min=26.86ms med=49.03ms max=501.62ms p(90)=66.62ms p(95)=84.33ms\n { expected_response:true }...: avg=53.62ms min=26.86ms med=49.03ms max=501.62ms p(90)=66.62ms p(95)=84.33ms\n ✓ http_req_failed................: 0.00% ✓ 0 ✗ 5765\n http_req_receiving.............: avg=88.57µs min=13µs med=90µs max=2.99ms p(90)=108µs p(95)=124.8µs\n http_req_sending...............: avg=97.47µs min=29µs med=83µs max=6.86ms p(90)=139µs p(95)=162µs\n http_req_tls_handshaking.......: avg=0s min=0s med=0s max=0s p(90)=0s p(95)=0s\n http_req_waiting...............: avg=53.44ms min=26.68ms med=48.84ms max=501.43ms p(90)=66.43ms p(95)=84.05ms\n http_reqs......................: 5765 41.15402/s\n iteration_duration.............: avg=54.34ms min=20.75µs med=49.75ms max=502.26ms p(90)=67.39ms p(95)=84.91ms\n iterations.....................: 5765 41.15402/s\n vus............................: 50 min=50 max=50\n vus_max........................: 50 min=50 max=50\n\n\nrunning (2m20.1s), 00/50 VUs, 5765 complete and 0 interrupted iterations\nwebhookRequests ✓ [======================================] 00/50 VUs 2m20s 01.12 iters/s\n```","ref":"benchmarking.md.html#sample-benchmarks"},{"type":"extras","title":"Run load tests for a hypothetical cold chain system - Benchmarking","doc":"`benchmarking/sample_cold_chain_monitoring_script.js` contains a k6 script that\ncan be used to simulate data from a hypothetical cold chain system. It requires a\ncustom job to be created (an example of which can be found at the top of the\nscript file).\n\nThe test can be excuted as follows (`WEBHOOK_URL` is not optional):\n\n```bash\n WEBHOOK_URL=... k6 run benchmarking/sample_cold_chain_monitoring_script.js\n```","ref":"benchmarking.md.html#run-load-tests-for-a-hypothetical-cold-chain-system"},{"type":"extras","title":"Workers","doc":"# Workers\n\nThe OpenFn Runtime used by Lightning is a [Node.js](https://nodejs.org/en/)\napplication that runs on a server. It is responsible for executing the code that\nyou write in your OpenFn jobs.\n\nA Runtime Manager is a module or application that processes Runs, which\ncontains reference to the Workflow, the starting point and the initial data.\n\nRuns are enqueued, and Runtime Managers request work to be performed when\nthey are ready.","ref":"workers.html"},{"type":"extras","title":"History - Workers","doc":"In previous versions of OpenFn products, the server would invoke a NodeJS child\nprocess for each Run that needs to be executed. Deciding which Job to run in a\nworkflow is decided after each run is completed.\n\nThe current approach to executing Runs, is that a worker checks out the\nentire run and executes it and all the jobs required.\n\nThe advantage of this approach is a significant reduction in latency of\nlaunching new workers for every Run to be processed.","ref":"workers.html#history"},{"type":"extras","title":"Connecting Workers to Lightning - Workers","doc":"Our standard Runtime Manager uses WebSockets to communicate with Lightning.\n\nHowever, since the workers are treated no differently from any other incoming\ntraffic; there are two layers of security applied to anything that can access\nyour data or process work.\n\nWe use two different JWTs to facilitate the follow:","ref":"workers.html#connecting-workers-to-lightning"},{"type":"extras","title":"Worker Token - Workers","doc":"This token is created by the worker and signed with a shared HS256 secret that\nLightning uses to verify.","ref":"workers.html#worker-token"},{"type":"extras","title":"Run Token - Workers","doc":"This token is created by Lightning for every Run that a worker receives. The\ntoken is signed with a private key, and therefore cannot be generated by 3rd\nparties.\n\nThe token is scoped for a single Run and cannot be used to access anything\noutside of the scope of that Run.","ref":"workers.html#run-token"},{"type":"extras","title":"Generating Keys - Workers","doc":"Lightning comes with a mix task to help generate keys:\n\n```\nmix lightning.gen_worker_keys\n```","ref":"workers.html#generating-keys"},{"type":"extras","title":"Configuring Lightning and Workers - Workers","doc":"There are three environment variables required to make everything work.\n\n**`WORKER_RUNS_PRIVATE_KEY`**\n\n_Lightning only_\n\nA Base64 encoded private key in PEM format, used to generate JWTs granting\nworkers permission to access a specific Run, the related Workflow and\ncredentials.\n\n> [!IMPORTANT] This key should never be shared. If you suspect it has been\n> compromised, generate a new one and reconfigure both Lightning and your\n> workers.\n\n**`WORKER_SECRET`**\n\n_Lightning and Workers_\n\nA 256bit long shared secret used by the worker to sign JWTs for authentication\nwith the Lightning API.\n\n**`WORKER_LIGHTNING_PUBLIC_KEY`**\n\n_Workers only_\n\nA Base64 encoded public key in PEM format derived from the private key. This is\nused by workers to verify Run Tokens coming from Lightning.","ref":"workers.html#configuring-lightning-and-workers"},{"type":"extras","title":"Troubleshooting - Workers","doc":"","ref":"workers.html#troubleshooting"},{"type":"extras","title":"Problems with NodeJS DNS name resolution - Workers","doc":"NodeJS v17 [changed](https://github.com/nodejs/node/pull/39987) how DNS name\nresolution is handled. In earlier versions, Node would reorder DNS lookup\nresults so IPv4 addresses came before IPv6 addresses. In v17, Node started\nreturning addresses in the same order provided by the resolver. The net effect\nis that your workers might fail to connect to Lightning if the native DNS\nresolver on your system is returning the loopback IPv6 address (`::1`) before\nthe IPv4 address (`127.0.0.1`). In these cases, your worker might report an\nerror similar to the following:\n\n```\nCRITICAL ERROR: could not connect to lightning at ws://localhost:4000/worker\n```\n\nIf you experience this, it can be helpful to set the `NODE_OPTIONS` environment\nvariable as shown below. This will force pre-v17 behavior of returning IPv4\naddresses first.\n\n```\nNODE_OPTIONS=--dns-result-order=ipv4first\n```\n\nYou can directly inspect what IP address Node returns for `localhost` by running\nthe following command:\n\n```\nnode -e 'dns.lookup(\"localhost\", console.log)'\n```","ref":"workers.html#problems-with-nodejs-dns-name-resolution"},{"type":"extras","title":"Provisioning","doc":"# Provisioning\n\nLightning offers the ability to configure projects via the HTTP API.\n\nBy providing a JSON document with the desired configuration, the project can be\nconfigured to your liking.","ref":"provisioning.html"},{"type":"extras","title":"Using the API - Provisioning","doc":"The API is available at `/api/provision`, and expects an `application/json`\nContent-Type.","ref":"provisioning.html#using-the-api"},{"type":"extras","title":"Authentication - Provisioning","doc":"The API requires a valid auth token to be provided in the `Authorization`\nheader.","ref":"provisioning.html#authentication"},{"type":"extras","title":"Example Request - Provisioning","doc":"```bash\n curl -X POST \\\n -d @project.json \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n $ENDPOINT/api/provision\n```","ref":"provisioning.html#example-request"},{"type":"extras","title":"Document Structure - Provisioning","doc":"The provisioning document is a JSON document with the project at the root.\n\n> All entities **must have** an `id` field, which is a UUIDv4 string. In the\n> case of new entities, this must be generated by the client.\n\nThe API is idempotent, and the distinction between creating and updating is\ndetermined by the presence of the `id` field.\n\n```jsonc\n{\n \"id\": \"< >\",\n \"name\": \"< >\",\n \"workflows\": [\n {\n \"id\": \"< >\",\n \"name\": \"< >\",\n \"jobs\": [\n {\n \"id\": \"< >\",\n \"name\": \"< >\",\n \"body\": \"< >\",\n \"adaptor\": \"< >\",\n \"enabled\": true\n }\n // ... more jobs\n ],\n \"triggers\": [\n {\n \"id\": \"< >\",\n \"name\": \"< >\",\n \"type\": \"webhook\"\n }\n // ... more triggers\n ],\n \"edges\": [\n {\n \"id\": \"< >\",\n \"source_trigger_id\": \"< >\",\n \"target_job_id\": \"< >\"\n }\n // ... more edges\n ]\n }\n // ... more workflows\n ]\n}\n```","ref":"provisioning.html#document-structure"},{"type":"extras","title":"API Behaviour - Provisioning","doc":"The API expects **all** existing entities to be provided in the provisioning\ndocument.\n\nIf the document provided is out of date (e.g. a new job was added on the\nserver), a new reference document should be fetched and the changes applied to\nit.","ref":"provisioning.html#api-behaviour"},{"type":"extras","title":"Deleting Entities - Provisioning","doc":"Entities can be deleted by setting the `disabled` key to `true`.\n\nExample:\n\n```jsonc\n{\n \"id\": \"< >\",\n \"workflows\": [\n {\n \"id\": \"< >\",\n \"jobs\": [\n {\n \"id\": \"< >\",\n \"delete\": true // <== delete this job\n }\n ]\n }\n ]\n}\n```","ref":"provisioning.html#deleting-entities"},{"type":"extras","title":"Relationship with Projects as Code - Provisioning","doc":"The Projects as Code spec is a superset of the provisioning API.\n\nProjects as Code allows for the user to specify a key for each entity, which\nmakes it easier to manage the project in the future.\n\nFor example:\n\n```yaml\nname: my-project\nworkflows:\n workflow-one:\n jobs:\n job-one:\n body: |\n console.log(\"Hello World\");\n adaptor: '@openfn/language-common'\n enabled: true\n triggers:\n trigger-one:\n type: webhook\n edges:\n - source_trigger: trigger-one\n target_job: job-one\n```\n\nThe above YAML document illustrates the use of keys being used to identify\nentities. Allowing the user to provision the same project to multiple\nenvironments.\n\nThe API is unaware of 'keys', and expects IDs to be provided by the client.\n\nIn order to convert the above YAML document to a provisioning document, the CLI\nuses a local state file (if available) to map the keys to UUIDs.\n\nUsing the example above a state file might look like this:\n\n```jsonc\n{\n \"id\": \"f6ba9a8c-b687-473a-908e-e250686f1eed\",\n \"workflows\": {\n \"workflow-one\": {\n \"id\": \"f206aa85-4fce-492e-94eb-ffd32c75d178\",\n \"jobs\": {},\n \"triggers\": {}\n }\n }\n}\n```\n\nThe state file shows that the project and workflow already exist, but the job,\ntrigger and edge do not. In order to create these new entities, IDs will be\napplied them.\n\nOn a successful application of the provisioning document, the state file will be\nupdated to reflect the new IDs and entities.\n\n```json\n{\n \"id\": \"f6ba9a8c-b687-473a-908e-e250686f1eed\",\n \"workflows\": {\n \"workflow-one\": {\n \"id\": \"f206aa85-4fce-492e-94eb-ffd32c75d178\",\n \"jobs\": {\n \"job-one\": { \"id\": \"18ed71de-caf8-4822-aefc-5b19351f4016\" }\n },\n \"triggers\": {\n \"trigger-one\": { \"id\": \"e0b9f357-9cf9-4206-9924-4d5674aad830\" }\n },\n \"edges\": [\n {\n \"id\": \"c239d994-6662-4637-90f8-0293c924b461\",\n \"source_trigger_id\": \"e0b9f357-9cf9-4206-9924-4d5674aad830\",\n \"target_job_id\": \"18ed71de-caf8-4822-aefc-5b19351f4016\"\n }\n ]\n }\n }\n}\n```","ref":"provisioning.html#relationship-with-projects-as-code"},{"type":"extras","title":"Changelog","doc":"# Changelog\n\nAll notable changes to this project will be documented in this file.\n\n- `Added` for new features.\n- `Changed` for changes in existing functionality.\n- `Deprecated` for soon-to-be removed features.\n- `Removed` for now removed features.\n- `Fixed` for any bug fixes.\n- `Security` in case of vulnerabilities.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to\n[Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [Unreleased]","ref":"changelog.html"},{"type":"extras","title":"Added - Changelog","doc":"- Audit history exports events\n [#2367](https://github.com/OpenFn/lightning/issues/2367)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Ignore Plug.Conn.InvalidQueryError in Sentry\n [#2672](https://github.com/OpenFn/lightning/issues/2672)\n- Add Index to `dataclip_id` on `runs` and `work_orders` tables to fasten deletion\n [PR#2677](https://github.com/OpenFn/lightning/pull/2677)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Error when the logger receives a boolean\n [#2666](https://github.com/OpenFn/lightning/issues/2666)\n\n## [v2.10.1] - 2024-11-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix metadata loading as code-assist in the editor\n [#2669](https://github.com/OpenFn/lightning/pull/2669)\n- Fix Broken Input Dataclip UI\n [#2670](https://github.com/OpenFn/lightning/pull/2670)\n\n## [v2.10.0] - 2024-11-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Increase collection items value limit to 1M characters\n [#2661](https://github.com/OpenFn/lightning/pull/2661)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix issues loading suggestions for code-assist\n [#2662](https://github.com/OpenFn/lightning/pull/2662)\n\n## [v2.10.0-rc.2] - 2024-11-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Bootstrap script to help install and configure the Lightning app for\n development [#2654](https://github.com/OpenFn/lightning/pull/2654)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Upgrade dependencies [#2624](https://github.com/OpenFn/lightning/pull/2624)\n- Hide the collections and fhir-jembi adaptors from the available adaptors list\n [#2648](https://github.com/OpenFn/lightning/issues/2648)\n- Change column name for \"Last Activity\" to \"Last Modified\" on Projects list\n [#2593](https://github.com/OpenFn/lightning/issues/2593)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix LiveView crash when pressing \"esc\" on inspector\n [#2622](https://github.com/OpenFn/lightning/issues/2622)\n- Delete project data in batches to avoid timeouts in the db connection\n [#2632](https://github.com/OpenFn/lightning/issues/2632)\n- Fix MetadataService crashing when errors are encountered\n [#2659](https://github.com/OpenFn/lightning/issues/2659)\n\n## [v2.10.0-rc.1] - 2024-11-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Reduce transaction time when fetching collection items by fetching upfront\n [#2645](https://github.com/OpenFn/lightning/issues/2645)\n\n## [v2.10.0-rc.0] - 2024-11-07","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Adds a UI for managing collections\n [#2567](https://github.com/OpenFn/lightning/issues/2567)\n- Introduces collections, a programatic workflow data sharing resource.\n [#2551](https://github.com/OpenFn/lightning/issues/2551)\n\n## [v2.9.15] - 2024-11-06","ref":"changelog.html#added"},{"type":"extras","title":"Added - Changelog","doc":"- Added some basic editor usage tips to the docs panel\n [#2629](https://github.com/OpenFn/lightning/pull/2629)\n- Create audit events when the retention periods for a project's dataclips and\n history are modified. [#2589](https://github.com/OpenFn/lightning/issues/2589)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- The Docs panel in the inspector will now be closed by default\n [#2629](https://github.com/OpenFn/lightning/pull/2629)\n- JSDoc annotations are removed from code assist descriptions\n [#2629](https://github.com/OpenFn/lightning/pull/2629)\n- Show project name during delete confirmation\n [#2634](https://github.com/OpenFn/lightning/pull/2634)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix misaligned margins on collapsed panels in the inspector\n [#2571](https://github.com/OpenFn/lightning/issues/2571)\n- Fix sorting directions icons in projects table in the project dashboard page\n [#2631](https://github.com/OpenFn/lightning/pull/2631)\n- Fixed an issue where code-completion prompts don't load properly in the\n inspector [#2629](https://github.com/OpenFn/lightning/pull/2629)\n- Fixed an issue where namespaces (like http.) don't appear in code assist\n prompts [#2629](https://github.com/OpenFn/lightning/pull/2629)\n\n## [v2.9.14] - 2024-10-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Additional documentation and notification text relating to the importance of\n alternate storage for Kafka triggers.\n [#2614](https://github.com/OpenFn/lightning/issues/2614)\n- Add support for run memory limit option\n [#2623](https://github.com/OpenFn/lightning/pull/2623)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Enforcing MFA for a project can be enforced by the usage limiter\n [#2607](https://github.com/OpenFn/lightning/pull/2607)\n- Add extensions for limiting retention period\n [#2618](https://github.com/OpenFn/lightning/pull/2618)\n\n## [v2.9.13] - 2024-10-28","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Add responsible ai disclaimer to arcade video\n [#2610](https://github.com/OpenFn/lightning/pull/2610)\n\n## [v2.9.12] - 2024-10-25","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix editor panel buttons gets out of shape on smaller screens\n [#2278](https://github.com/OpenFn/lightning/issues/2278)\n- Do not send empty strings in credential body to the worker\n [#2585](https://github.com/OpenFn/lightning/issues/2585)\n- Refactor projects dashboard page and fix bug on last activity column\n [#2593](https://github.com/OpenFn/lightning/issues/2593)\n\n## [v2.9.11] - 2024-10-23","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Optionally write Kafka messages that can not be persisted to the file system.\n [#2386](https://github.com/OpenFn/lightning/issues/2386)\n- Add `MessageRecovery` utility code to restore Kafka messages that were\n pesisted to the file system.\n [#2386](https://github.com/OpenFn/lightning/issues/2386)\n- Projects page welcome section: allow users to learn how to use the app thru\n Arcade videos [#2563](https://github.com/OpenFn/lightning/issues/2563)\n- Store user preferences in database\n [#2564](https://github.com/OpenFn/lightning/issues/2564)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Allow users to to preview password fields in credential forms\n [#2584](https://github.com/OpenFn/lightning/issues/2584)\n- Remove superuser flag for oauth clients creation\n [#2417](https://github.com/OpenFn/lightning/issues/2417)\n- Make URL validator more flexible to support URLs with dashes and other cases\n [#2417](https://github.com/OpenFn/lightning/issues/2417)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix retry many workorders when built for job\n [#2597](https://github.com/OpenFn/lightning/issues/2597)\n- Do not count deleted workflows in the projects table\n [#2540](https://github.com/OpenFn/lightning/issues/2540)\n\n## [v2.9.10] - 2024-10-16","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Notify users when a Kafka trigger can not persist a message to the database.\n [#2386](https://github.com/OpenFn/lightning/issues/2386)\n- Support `kafka` trigger type in the provisioner\n [#2506](https://github.com/OpenFn/lightning/issues/2506)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix work order retry sorting and avoids loading dataclips\n [#2581](https://github.com/OpenFn/lightning/issues/2581)\n- Fix editor panel overlays output panel when scrolled\n [#2291](https://github.com/OpenFn/lightning/issues/2291)\n\n## [v2.9.9] - 2024-10-09","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Make project description multiline in project.yaml\n [#2534](https://github.com/OpenFn/lightning/issues/2534)\n- Do not track partition timestamps when ingesting Kafka messages.\n [#2531](https://github.com/OpenFn/lightning/issues/2531)\n- Always use the `initial_offset_reset_policy` when enabling a Kafka pipeline.\n [#2531](https://github.com/OpenFn/lightning/issues/2531)\n- Add plumbing to simulate a persistence failure in a Kafka trigger pipeline.\n [#2386](https://github.com/OpenFn/lightning/issues/2386)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix Oban errors not getting logged in Sentry\n [#2542](https://github.com/OpenFn/lightning/issues/2542)\n- Perform data retention purging in batches to avoid timeouts\n [#2528](https://github.com/OpenFn/lightning/issues/2528)\n- Fix editor panel title gets pushed away when collapsed\n [#2545](https://github.com/OpenFn/lightning/issues/2545)\n- Mark unfinished steps having finished runs as `lost`\n [#2416](https://github.com/OpenFn/lightning/issues/2416)\n\n## [v2.9.8] - 2024-10-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Ability for users to to retry Runs and create manual Work Orders from the job\n inspector #2496 [#2496](https://github.com/OpenFn/lightning/issues/2496)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix panel icons overlays on top title when collapsed\n [#2537](https://github.com/OpenFn/lightning/issues/2537)\n\n## [v2.9.7] - 2024-10-02","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Enqueues many work orders retries in the same transaction per Oban job.\n [#2363](https://github.com/OpenFn/lightning/issues/2363)\n- Added the ability to retry rejected work orders.\n [#2391](https://github.com/OpenFn/lightning/issues/2391)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Notify other present users when the promoted user saves the workflow\n [#2282](https://github.com/OpenFn/lightning/issues/2282)\n- User email change: Add debounce on blur to input forms to avoid validation\n after every keystroke [#2365](https://github.com/OpenFn/lightning/issues/2365)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Use timestamps sent from worker when starting and completing runs\n [#2434](https://github.com/OpenFn/lightning/issues/2434)\n- User email change: Add debounce on blur to input forms to avoid validation\n after every keystroke [#2365](https://github.com/OpenFn/lightning/issues/2365)","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- User email change: Send notification of change to the old email address and\n confirmation to the new email address\n [#2365](https://github.com/OpenFn/lightning/issues/2365)\n- Fixes filters to properly handle the \"rejected\" status for work orders.\n [#2391](https://github.com/OpenFn/lightning/issues/2391)\n- Fix item selection (project / billing account) in the context switcher\n [#2518](https://github.com/OpenFn/lightning/issues/2518)\n- Export edge condition expressions as multiline in project spec\n [#2521](https://github.com/OpenFn/lightning/issues/2521)\n- Fix line spacing on AI Assistant\n [#2498](https://github.com/OpenFn/lightning/issues/2498)\n\n## [v2.9.6] - 2024-09-23","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Increase minimum password length to 12 in accordance with ASVS 4.0.3\n recommendation V2.1.2 [#2507](https://github.com/OpenFn/lightning/pull/2507)\n- Changed the public sandbox (https://demo.openfn.org) setup script to use\n `welcome12345` passwords to comply with a 12-character minimum","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Dataclip selector always shows that the dataclip is wiped even when the job\n wasn't run [#2303](https://github.com/OpenFn/lightning/issues/2303)\n- Send run channel errors to sentry\n [#2515](https://github.com/OpenFn/lightning/issues/2515)\n\n## [v2.9.5] - 2024-09-18","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Hide export history button when no workorder is rendered in the table\n [#2440](https://github.com/OpenFn/lightning/issues/2440)\n- Improve docs for running lightning locally #2499\n [#2499](https://github.com/OpenFn/lightning/pull/2499)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix empty webhook URL when switching workflow trigger type\n [#2050](https://github.com/OpenFn/lightning/issues/2050)\n- Add quotes when special YAML characters are present in the exported project\n [#2446](https://github.com/OpenFn/lightning/issues/2446)\n- In the AI Assistant, don't open the help page when clicking the Responsible AI\n Link [#2511](https://github.com/OpenFn/lightning/issues/2511)\n\n## [v2.9.4] - 2024-09-16","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Responsible AI review of AI Assistant\n [#2478](https://github.com/OpenFn/lightning/pull/2478)\n- Improve history export page UI\n [#2442](https://github.com/OpenFn/lightning/issues/2442)\n- When selecting a node in the workflow diagram, connected edges will also be\n highlighted [#2396](https://github.com/OpenFn/lightning/issues/2358)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix AI Assitant crashes on a job that is not saved yet\n [#2479](https://github.com/OpenFn/lightning/issues/2479)\n- Fix jumpy combobox for scope switcher\n [#2469](https://github.com/OpenFn/lightning/issues/2469)\n- Fix console errors when rending edge labels in the workflow diagram\n- Fix tooltip on export workorder button\n [#2430](https://github.com/OpenFn/lightning/issues/2430)\n\n## [v2.9.3] - 2024-09-11","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add utility module to seed a DB to support query performance analysis.\n [#2441](https://github.com/OpenFn/lightning/issues/2441)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Enhance user profile page to add a section for updating basic information\n [#2470](https://github.com/OpenFn/lightning/pull/2470)\n- Upgraded Heroicons to v2.1.5, from v2.0.18\n [#2483](https://github.com/OpenFn/lightning/pull/2483)\n- Standardize `link-uuid` style for uuid chips\n- Updated PromEx configuration to align with custom Oban naming.\n [#2488](https://github.com/OpenFn/lightning/issues/2488)\n\n## [v2.9.2] - 2024-09-09","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Temporarily limit AI to @openfn emails while testing\n [#2482](https://github.com/OpenFn/lightning/pull/2482)\n\n## [v2.9.1] - 2024-09-09","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Provisioner creates invalid snapshots when doing CLI deploy\n [#2461](https://github.com/OpenFn/lightning/issues/2461)\n [#2460](https://github.com/OpenFn/lightning/issues/2460)\n\n > This is a fix for future Workflow updates that are deployed by the CLI and\n > Github integrations. Unfortunately, there is a high likelihood that your\n > existing snapshots could be incorrect (e.g. missing steps, missing edges).\n > In order to fix this, you will need to manually create new snapshots for\n > each of your workflows. This can be done either by modifying the workflow in\n > the UI and saving it. Or running a command on the running instance:\n >\n > ```elixir\n > alias Lightning.Repo\n > alias Lightning.Workflows.{Workflow, Snapshot}\n >\n > Repo.transaction(fn ->\n > snapshots =\n > Repo.all(Workflow)\n > |> Enum.map(&Workflow.touch/1)\n > |> Enum.map(&Repo.update!/1)\n > |> Enum.map(fn workflow ->\n > {:ok, snapshot} = Snapshot.create(workflow)\n > snapshot\n > end)\n >\n > {:ok, snapshots}\n > end)\n > ```\n\n## [v2.9.0] - 2024-09-06","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Limit AI queries and hook the increment of AI queries to allow usage limiting.\n [#2438](https://github.com/OpenFn/lightning/pull/2438)\n- Persist AI Assistant conversations and enable it for all users\n [#2296](https://github.com/OpenFn/lightning/issues/2296)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Rename `new_table` component to `table`.\n [#2448](https://github.com/OpenFn/lightning/pull/2448)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix `workflow_id` presence in state.json during Github sync\n [#2445](https://github.com/OpenFn/lightning/issues/2445)\n\n## [v2.8.2] - 2024-09-04","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Change navbar colors depending on scope.\n [#2449](https://github.com/OpenFn/lightning/pull/2449)\n- Add support for configurable idle connection timeouts via the `IDLE_TIMEOUT`\n environment variable. [#2443](https://github.com/OpenFn/lightning/issues/2443)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Allow setup_user command to be execute from outside the container with\n `/app/bin/lightning eval Lightning.Setup.setup_user/3`\n- Implement a combo-box to make navigating between projects easier\n [#241](https://github.com/OpenFn/lightning/pull/2424)\n- Updated vulnerable version of micromatch.\n [#2454](https://github.com/OpenFn/lightning/issues/2454)\n\n## [v2.8.1] - 2024-08-28","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Improve run claim query by removing extraneous sorts\n [#2431](https://github.com/OpenFn/lightning/issues/2431)\n\n## [v2.8.0] - 2024-08-27","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Users are now able to export work orders, runs, steps, logs, and dataclips\n from the History page.\n [#1698](https://github.com/OpenFn/lightning/issues/1698)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Add index over `run_id` and `step_id` in run_steps to improve worker claim\n speed. [#2428](https://github.com/OpenFn/lightning/issues/2428)\n- Show Github Error messages as they are to help troubleshooting\n [#2156](https://github.com/OpenFn/lightning/issues/2156)\n- Allow `Setup_utils.setup_user` to be used for the initial superuser creation.\n- Update to code assist in the Job Editor to import namespaces from adaptors.\n [#2432](https://github.com/OpenFn/lightning/issues/2432)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Unable to remove/reconnect github app in lightning after uninstalling directly\n from Github [#2168](https://github.com/OpenFn/lightning/issues/2168)\n- Github sync buttons available even when usage limiter returns error\n [PR#2390](https://github.com/OpenFn/lightning/pull/2390)\n- Fix issue with the persisting of a Kafka message with headers.\n [#2402](https://github.com/OpenFn/lightning/issues/2402)\n- Protect against race conditions when updating partition timestamps for a Kafka\n trigger. [#2378](https://github.com/OpenFn/lightning/issues/2378)\n\n## [v2.7.19] - 2024-08-19","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Pass the user_id param on check usage limits.\n [#2387](https://github.com/OpenFn/lightning/issues/2387)\n\n## [v2.7.18] - 2024-08-17","ref":"changelog.html#added"},{"type":"extras","title":"Added - Changelog","doc":"- Ensure that all users in an instance have a confirmed email address within 48\n hours [#2389](https://github.com/OpenFn/lightning/issues/2389)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Ensure that all the demo accounts are confirmed by default\n [#2395](https://github.com/OpenFn/lightning/issues/2395)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Removed all Kafka trigger code that ensured that message sequence is honoured\n for messages with keys. Functionality to ensure that message sequence is\n honoured will be added in the future, but in an abstraction that is a better\n fit for the current Lightning design.\n [#2362](https://github.com/OpenFn/lightning/issues/2362)\n- Dropped the `trigger_kafka_messages` table that formed part of the Kafka\n trigger implementation, but which is now obsolete given the removal of the\n code related to message sequence preservation.\n [#2362](https://github.com/OpenFn/lightning/issues/2362)\n\n## [v2.7.17] - 2024-08-14","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added an `iex` command to setup a user, an apiToken, and credentials so that\n it's possible to get a fully running lightning instance via external shell\n script. (This is a tricky requirement for a distributed set of local\n deployments) [#2369](https://github.com/OpenFn/lightning/issues/2369) and\n [#2373](https://github.com/OpenFn/lightning/pull/2373)\n- Added support for _very basic_ project-credential management (add, associate\n with job) via provisioning API.\n [#2367](https://github.com/OpenFn/lightning/issues/2367)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Enforced uniqueness on credential names _by user_.\n [#2371](https://github.com/OpenFn/lightning/pull/2371)\n- Use Swoosh to format User models into recipients\n [#2374](https://github.com/OpenFn/lightning/pull/2374)\n- Bump default CLI to `@openfn/cli@1.8.1`","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- When a Workflow is deleted, any associated Kafka trigger pipelines will be\n stopped and deleted. [#2379](https://github.com/OpenFn/lightning/issues/2379)\n\n## [v2.7.16] - 2024-08-07","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- @ibrahimwickama fixed issue that prevented users from creating new workflows\n if they are running in an `http` environment (rather than `localhost` or\n `https`). [#2365](https://github.com/OpenFn/lightning/pull/2356)\n\n## [v2.7.15] - 2024-08-07","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Kafka messages without keys are synchronously converted into a Workorder,\n Dataclip and Run. Messages with keys are stored as TriggerKafkaMessage\n records, however the code needed to process them has been disabled, pending\n removal. [#2351](https://github.com/OpenFn/lightning/issues/2351)\n\n## [v2.7.14] - 2024-08-05","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Use standard styles for link, fix home button in breadcrumbs\n [#2354](https://github.com/OpenFn/lightning/pull/2354)\n\n## [v2.7.13] - 2024-08-05","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Don't log 406 Not Acceptable errors to Sentry\n [#2350](https://github.com/OpenFn/lightning/issues/2350)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Correctly handle floats in LogMessage\n [#2348](https://github.com/OpenFn/lightning/issues/2348)\n\n## [v2.7.12] - 2024-07-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Make root layout configurable\n [#2310](https://github.com/OpenFn/lightning/pull/2310)\n- Use snapshots when initiating Github Sync\n [#1827](https://github.com/OpenFn/lightning/issues/1827)\n- Move runtime logic into module\n [#2338](https://github.com/OpenFn/lightning/pull/2338)\n- Use `AccountHook Extension` to register new users invited in a project\n [#2341](https://github.com/OpenFn/lightning/pull/2341)\n- Standardized top bars across the UI with a navigable breadcrumbs interface\n [#2299](https://github.com/OpenFn/lightning/pull/2299)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Limit frame size of worker socket connections\n [#2339](https://github.com/OpenFn/lightning/issues/2339)\n- Limit number of days to 31 in cron trigger dropdown\n [#2331](https://github.com/OpenFn/lightning/issues/2331)\n\n## [v2.7.11] - 2024-07-26","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Expose more Kafka configuration at instance-level.\n [#2329](https://github.com/OpenFn/lightning/issues/2329)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Table action css tweaks\n [#2333](https://github.com/OpenFn/lightning/issues/2333)\n\n## [v2.7.10]","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- A rudimentary optimisation for Kafka messages that do not have a key as the\n sequence of these messages can not be guaranteed.\n [#2323](https://github.com/OpenFn/lightning/issues/2323)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix an intermittent bug when trying to intern Kafka offset reset policy.\n [#2327](https://github.com/OpenFn/lightning/issues/2327)\n\n## [v2.7.9] - 2024-07-24","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- CSS - standardized some more tailwind components\n [PR#2324](https://github.com/OpenFn/lightning/pull/2324)\n\n## [v2.7.8] - 2024-07-24","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Enable End to End Integration tests\n [#2187](https://github.com/OpenFn/lightning/issues/2187)\n- Make selected Kafka trigger parameters configurable via ENV vars.\n [#2315](https://github.com/OpenFn/lightning/issues/2315)\n- Use the Oauth2 `revocation_endpoint` to revoke token access (1) before\n attempting to reauthorize and (2) when users schedule a credential for\n deletion [#2314](https://github.com/OpenFn/lightning/issues/2314)\n- Standardized tailwind alerts\n [#2314](https://github.com/OpenFn/lightning/issues/2314)\n- Standardized `link` tailwind style (and provided `link-plain`, `link-info`,\n `link-error`, and `link-warning`)\n [#2314](https://github.com/OpenFn/lightning/issues/2314)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix work order URL in failure alerts\n [#2305](https://github.com/OpenFn/lightning/pull/2305)\n- Fix error when handling existing encrypted credentials\n [#2316](https://github.com/OpenFn/lightning/issues/2316)\n- Fix job editor switches to the snapshot version when body is changed\n [#2306](https://github.com/OpenFn/lightning/issues/2306)\n- Fix misaligned \"Retry from here\" button on inspector page\n [#2308](https://github.com/OpenFn/lightning/issues/2308)\n\n## [v2.7.7] - 2024-07-18","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add experimental support for triggers that consume message from a Kafka\n cluster [#1801](https://github.com/OpenFn/lightning/issues/1801)\n- Workflows can now specify concurrency, allowing runs to be executed\n syncronously or to a maximum concurrency level. Note that this applies to the\n default FifoRunQueue only.\n [#2022](https://github.com/OpenFn/lightning/issues/2022)\n- Invite Non-Registered Users to a Project\n [#2288](https://github.com/OpenFn/lightning/pull/2288)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Make modal close events configurable\n [#2298](https://github.com/OpenFn/lightning/issues/2298)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Prevent Oauth credentials from being created if they don't have a\n `refresh_token` [#2289](https://github.com/OpenFn/lightning/pull/2289) and\n send more helpful error data back to the worker during token refresh failure\n [#2135](https://github.com/OpenFn/lightning/issues/2135)\n- Fix CLI deploy not creating snapshots for workflows\n [#2271](https://github.com/OpenFn/lightning/issues/2271)\n\n## [v2.7.6] - 2024-07-11","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- UsageTracking crons are enabled again (if config is enabled)\n [#2276](https://github.com/OpenFn/lightning/issues/2276)\n- UsageTracking metrics absorb the fact that a step's job_id may not currently\n exist when counting unique jobs\n [#2279](https://github.com/OpenFn/lightning/issues/2279)\n- Adjusted layout and text displayed when preventing simultaneous edits to\n accommodate more screen sizes\n [#2277](https://github.com/OpenFn/lightning/issues/2277)\n\n## [v2.7.5] - 2024-07-10","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Prevent two editors from making changes to the same workflow at the same time\n [#1949](https://github.com/OpenFn/lightning/issues/1949)\n- Moved the Edge Condition Label field to the top of the form, so it's always\n visible [#2236](https://github.com/OpenFn/lightning/pull/2236)\n- Update edge condition labels in the Workflow Diagram to always show the\n condition type icon and the label\n [#2236](https://github.com/OpenFn/lightning/pull/2236)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Do Not Require Lock Version In URL Parameters\n [#2267](https://github.com/OpenFn/lightning/pull/2267)\n- Trim erroneous spaces on user first and last names\n [#2269](https://github.com/OpenFn/lightning/pull/2269)\n\n## [v2.7.4] - 2024-07-06","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- When the entire log string is a valid JSON object, pretty print it with a\n standard `JSON.stringify(str, null, 2)` but if it's something else then let\n the user do whatever they want (e.g., if you write\n `console.log('some', 'cool', state.data)` we won't mess with it.)\n [#2260](https://github.com/OpenFn/lightning/pull/2260)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed sticky toggle button for switching between latest version and a snapshot\n of a workflow [#2264](https://github.com/OpenFn/lightning/pull/2264)\n\n## [v2.7.3] - 2024-07-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped the ws-worker to v1.3","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix issue when selecting different steps in RunViewer and the parent liveview\n not being informed [#2253](https://github.com/OpenFn/lightning/issues/2253)\n- Stopped inspector from crashing when looking for a step by a run/job\n combination [#2201](https://github.com/OpenFn/lightning/issues/2201)\n- Workflow activation only considers new and changed workflows\n [#2237](https://github.com/OpenFn/lightning/pull/2237)\n\n## [v2.7.2] - 2024-07-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Allow endpoint plugs to be injected at compile time.\n [#2248](https://github.com/OpenFn/lightning/pull/2248)\n- All models to use the `public` schema.\n [#2249](https://github.com/OpenFn/lightning/pull/2249)\n- In the workflow diagram, smartly update the view when adding new nodes\n [#2174](https://github.com/OpenFn/lightning/issues/2174)\n- In the workflow diagram, remove the \"autofit\" toggle in the control bar","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Remove prompt parameter from the authorization URL parameters for the Generic\n Oauth Clients [#2250](https://github.com/OpenFn/lightning/issues/2250)\n- Fixed react key error [#2233](https://github.com/OpenFn/lightning/issues/2233)\n- Show common functions in the Docs panel\n [#1733](https://github.com/OpenFn/lightning/issues/1733)\n\n## [v2.7.1] - 2024-07-01","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Update email copies [#2213](https://github.com/OpenFn/lightning/issues/2213)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix jumpy cursor in the Job editor.\n [#2229](https://github.com/OpenFn/lightning/issues/2229)\n- Rework syncing behaviour to prevent changes getting thrown out on a socket\n reconnect. [#2007](https://github.com/OpenFn/lightning/issues/2007)\n\n## [v2.7.0] - 2024-06-26","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Use of snapshots for displaying runs and their associated steps in the History\n page. [#1825](https://github.com/OpenFn/lightning/issues/1825)\n- Added view-only mode for rendering workflows and runs in the Workflow Canvas\n and the Inspector page using snapshots, with the option to switch between a\n specific snapshot version and the latest version. Edit mode is available when\n displaying the latest version.\n [#1843](https://github.com/OpenFn/lightning/issues/1843)\n- Allow users to delete steps sssociated with runs in the Workflow Canvas\n [#2027](https://github.com/OpenFn/lightning/issues/2027)\n- Link to adaptor `/src` from inspector.\n- Prototype AI Assistant for working with job code.\n [#2193](https://github.com/OpenFn/lightning/issues/2193)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Reverted behaviour on \"Rerun from here\" to select the Log tab.\n [#2202](https://github.com/OpenFn/lightning/issues/2202)\n- Don't allow connections between an orphaned node and a\n Trigger[#2188](https://github.com/OpenFn/lightning/issues/2188)\n- Reduce the minimum zoom in the workflow diagram\n [#2214](https://github.com/OpenFn/lightning/issues/2214)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix some adaptor docs not displaying\n [#2019](https://github.com/OpenFn/lightning/issues/2019)\n- Fix broken `mix lightning.install_adaptor_icons` task due to addition of Finch\n http client change.\n\n## [v2.6.3] - 2024-06-19","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Added a notice on application start about anonymous public impact reporting\n and its importance for the sustainability of\n [Digital Public Goods](https://digitalpublicgoods.net/) and\n [Digital Public Infrastructure](https://www.codevelop.fund/insights-1/what-is-digital-public-infrastructure).\n- Increase default `WORKER_MAX_RUN_DURATION_SECONDS` to 300 to match the\n [ws-worker default](https://github.com/OpenFn/kit/blob/main/packages/ws-worker/src/util/cli.ts#L149-L153)\n so if people don't set their timeout via ENV, at least the two match up.\n\n## [v2.6.2] - 2024-06-13","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix vanishing Docs panel when Editor panel is collapsed and opened again\n [#2195](https://github.com/OpenFn/lightning/issues/2195)\n- Maintain tab when RunViewer remounts/push state drops tab hash\n [#2199](https://github.com/OpenFn/lightning/issues/2199)\n\n## [v2.6.1] - 2024-06-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Erlang to 26.2.5\n- Update debian bookworm from 20240130 to 20240513.\n- Return 403s when Provisioning API fails because of usage limits\n [#2182](https://github.com/OpenFn/lightning/pull/2182)\n- Update email notification for changing retention period\n [#2066](https://github.com/OpenFn/lightning/issues/2066)\n- Return 415s when Webhooks are sent Content-Types what are not supported.\n [#2180](https://github.com/OpenFn/lightning/issues/2180)\n- Updated the default step text","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Rewrite TabSelector (now Tabbed) components fixing a number of navigation\n issues [#2051](https://github.com/OpenFn/lightning/issues/2051)\n\n## [v2.6.0] - 2024-06-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Support multiple edges leading to the same step (a.k.a., \"drag & drop\")\n [#2008](https://github.com/OpenFn/lightning/issues/2008)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"## [v2.5.5] - 2024-06-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Replace LiveView Log Viewer component with React Monaco\n [#1863](https://github.com/OpenFn/lightning/issues/1863)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Bump default CLI to `@openfn/cli@1.3.2`\n- Don't show deprecated adaptor versions in the adaptor version picklist (to be\n followed by some graceful deprecation handling/warning in\n [later work](https://github.com/OpenFn/lightning/issues/2172))\n [#2169](https://github.com/OpenFn/lightning/issues/2169)\n- Refactor count workorders to reuse search code\n [#2121](https://github.com/OpenFn/lightning/issues/2121)\n- Updated provisioning error message to include workflow and job names\n [#2140](https://github.com/OpenFn/lightning/issues/2140)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Don't let two deploy workflows run at the same time to prevent git collisions\n [#2044](https://github.com/OpenFn/lightning/issues/2044)\n- Stopped sending emails when creating a starter project\n [#2161](https://github.com/OpenFn/lightning/issues/2161)\n\n## [v2.5.4] - 2024-05-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- CORS support [#2157](https://github.com/OpenFn/lightning/issues/2157)\n- Track users emails preferences\n [#2163](https://github.com/OpenFn/lightning/issues/2163)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Change Default Text For New Job Nodes\n [#2014](https://github.com/OpenFn/lightning/pull/2014)\n- Persisted run options when runs are _created_, not when they are _claimed_.\n This has the benefit of \"locking in\" the behavior desired by the user at the\n time they demand a run, not whenever the worker picks it up.\n [#2085](https://github.com/OpenFn/lightning/pull/2085)\n- Made `RUN_GRACE_PERIOD_SECONDS` a configurable ENV instead of 20% of the\n `WORKER_MAX_RUN_DURATION`\n [#2085](https://github.com/OpenFn/lightning/pull/2085)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Stopped Janitor from calling runs lost if they have special runtime options\n [#2079](https://github.com/OpenFn/lightning/issues/2079)\n- Dataclip Viewer now responds to page resize and internal page layout\n [#2120](https://github.com/OpenFn/lightning/issues/2120)\n\n## [v2.5.3] - 2024-05-27","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Stop users from creating deprecated Salesforce and GoogleSheets credentials.\n [#2142](https://github.com/OpenFn/lightning/issues/2142)\n- Delegate menu customization and create menu components for reuse.\n [#1988](https://github.com/OpenFn/lightning/issues/1988)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Disable Credential Save Button Until All Form Fields Are Validated\n [#2099](https://github.com/OpenFn/lightning/issues/2099)\n- Fix Credential Modal Closure Error When Workflow Is Unsaved\n [#2101](https://github.com/OpenFn/lightning/pull/2101)\n- Fix error when socket reconnects and user is viewing a run via the inspector\n [#2148](https://github.com/OpenFn/lightning/issues/2148)\n\n## [v2.5.2] - 2024-05-23","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Preserve custom values (like `apiVersion`) during token refresh for OAuth2\n credentials [#2131](https://github.com/OpenFn/lightning/issues/2131)\n\n## [v2.5.1] - 2024-05-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Don't compile Phoenix Storybook in production and test environments\n [#2119](https://github.com/OpenFn/lightning/pull/2119)\n- Improve performance and memory consumption on queries and logic for digest\n mailer [#2121](https://github.com/OpenFn/lightning/issues/2121)\n\n## [v2.5.0] - 2024-05-20","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- When a refresh token is updated, save it!\n [#2124](https://github.com/OpenFn/lightning/pull/2124)\n\n## [v2.5.0-pre4] - 2024-05-20","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix duplicate credential type bug\n [#2100](https://github.com/OpenFn/lightning/issues/2100)\n- Ensure Global OAuth Clients Accessibility for All Users\n [#2114](https://github.com/OpenFn/lightning/issues/2114)\n\n## [v2.5.0-pre3] - 2024-05-20","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix credential not added automatically after being created from the canvas.\n [#2105](https://github.com/OpenFn/lightning/issues/2105)\n- Replace the \"not working?\" prompt by \"All good, but if your credential stops\n working, you may need to re-authorize here.\".\n [#2102](https://github.com/OpenFn/lightning/issues/1872)\n- Fix Generic Oauth credentials don't get included in the refresh flow\n [#2106](https://github.com/OpenFn/lightning/pull/2106)\n\n## [v2.5.0-pre2] - 2024-05-17","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Replace LiveView Dataclip component with React Monaco bringing large\n performance improvements when viewing large dataclips.\n [#1872](https://github.com/OpenFn/lightning/issues/1872)\n\n## [v2.5.0-pre] - 2024-05-17","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow users to build Oauth clients and associated credentials via the user\n interface. [#1919](https://github.com/OpenFn/lightning/issues/1919)\n\n## [v2.4.14] - 2024-05-16","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Refactored image and version info\n [#2097](https://github.com/OpenFn/lightning/pull/2097)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed issue where updating adaptor name and version of job node in the\n workflow canvas crashes the app when no credential is selected\n [#99](https://github.com/OpenFn/lightning/issues/99)\n- Removes stacked viewer after switching tabs and steps.\n [#2064](https://github.com/OpenFn/lightning/issues/2064)\n\n## [v2.4.13] - 2024-05-16","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed issue where updating an existing Salesforce credential to use a\n `sandbox` endpoint would not properly re-authenticate.\n [#1842](https://github.com/OpenFn/lightning/issues/1842)\n- Navigate directly to settings from url hash and renders default panel when\n there is no hash. [#1971](https://github.com/OpenFn/lightning/issues/1971)\n\n## [v2.4.12] - 2024-05-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix render settings default panel on first load\n [#1971](https://github.com/OpenFn/lightning/issues/1971)\n\n## [v2.4.11] - 2024-05-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Upgraded Sentry to v10 for better error reporting.\n\n## [v2.4.10] - 2024-05-14","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix the \"reset demo\" script by disabling the emailing that was introduced to\n the `create_project` function.\n [#2063](https://github.com/OpenFn/lightning/pull/2063)\n\n## [v2.4.9] - 2024-05-14","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped @openfn/ws-worker to 1.1.8","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Correctly pass max allowed run time into the Run token, ensuring it's valid\n for the entirety of the Runs execution time\n [#2072](https://github.com/OpenFn/lightning/issues/2072)\n\n## [v2.4.8] - 2024-05-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add Github sync to usage limiter\n [#2031](https://github.com/OpenFn/lightning/pull/2031)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Remove illogical cancel buttons on user/pass change screen\n [#2067](https://github.com/OpenFn/lightning/issues/2067)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Stop users from configuring failure alerts when the limiter returns error\n [#2076](https://github.com/OpenFn/lightning/pull/2076)\n\n## [v2.4.7] - 2024-05-11","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed early worker token expiry bug\n [#2070](https://github.com/OpenFn/lightning/issues/2070)\n\n## [v2.4.6] - 2024-05-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow for automatic resubmission of failed usage tracking report submissions.\n [1789](https://github.com/OpenFn/lightning/issues/1789)\n- Make signup feature configurable\n [#2049](https://github.com/OpenFn/lightning/issues/2049)\n- Apply runtime limits to worker execution\n [#2015](https://github.com/OpenFn/lightning/pull/2015)\n- Limit usage for failure alerts\n [#2011](https://github.com/OpenFn/lightning/pull/2011)\n\n## [v2.4.5] - 2024-05-07","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix provioning API calls workflow limiter without the project ID\n [#2057](https://github.com/OpenFn/lightning/issues/2057)\n\n## [v2.4.4] - 2024-05-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Benchmarking script that simulates data from a cold chain.\n [#1993](https://github.com/OpenFn/lightning/issues/1993)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Changed Snapshot `get_or_create_latest_for` to accept multis allow controlling\n of which repo it uses.\n- Require exactly one owner for each project\n [#1991](https://github.com/OpenFn/lightning/issues/1991)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed issue preventing credential updates\n [#1861](https://github.com/OpenFn/lightning/issues/1861)\n\n## [v2.4.3] - 2024-05-01","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow menu items customization\n [#1988](https://github.com/OpenFn/lightning/issues/1988)\n- Workflow Snapshot support\n [#1822](https://github.com/OpenFn/lightning/issues/1822)\n- Fix sample workflow from init_project_for_new_user\n [#2016](https://github.com/OpenFn/lightning/issues/2016)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped @openfn/ws-worker to 1.1.6","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Assure workflow is always passed to Run.enqueue\n [#2032](https://github.com/OpenFn/lightning/issues/2032)\n- Fix regression on History page where snapshots were not preloaded correctly\n [#2026](https://github.com/OpenFn/lightning/issues/2026)\n\n## [v2.4.2] - 2024-04-24","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix missing credential types when running Lightning using Docker\n [#2010](https://github.com/OpenFn/lightning/issues/2010)\n- Fix provisioning API includes deleted workflows in project state\n [#2001](https://github.com/OpenFn/lightning/issues/2001)\n\n## [v2.4.1] - 2024-04-19","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix github cli deploy action failing to auto-commit\n [#1995](https://github.com/OpenFn/lightning/issues/1995)\n\n## [v2.4.1-pre] - 2024-04-18","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add custom metric to track the number of finalised runs.\n [#1790](https://github.com/OpenFn/lightning/issues/1790)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Set better defaults for the GitHub connection creation screen\n [#1994](https://github.com/OpenFn/lightning/issues/1994)\n- Update `submission_status` for any Usagetracking.Report that does not have it\n set. [#1789](https://github.com/OpenFn/lightning/issues/1789)\n\n## [v2.4.0] - 2024-04-12","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow description below the page title\n [#1975](https://github.com/OpenFn/lightning/issues/1975)\n- Enable users to connect projects to their Github repos and branches that they\n have access to [#1895](https://github.com/OpenFn/lightning/issues/1895)\n- Enable users to connect multiple projects to a single Github repo\n [#1811](https://github.com/OpenFn/lightning/issues/1811)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Change all System.get_env calls in runtime.exs to use dotenvy\n [#1968](https://github.com/OpenFn/lightning/issues/1968)\n- Track usage tracking submission status in new field\n [#1789](https://github.com/OpenFn/lightning/issues/1789)\n- Send richer version info as part of usage tracking submission.\n [#1819](https://github.com/OpenFn/lightning/issues/1819)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix sync to branch only targetting main branch\n [#1892](https://github.com/OpenFn/lightning/issues/1892)\n- Fix enqueue run without the workflow info\n [#1981](https://github.com/OpenFn/lightning/issues/1981)\n\n## [v2.3.1] - 2024-04-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Run the usage tracking submission job more frequently to reduce the risk of\n Oban unavailability at a particular time.\n [#1778](https://github.com/OpenFn/lightning/issues/1778)\n- Remove code supporting V1 usage tracking submissions.\n [#1853](https://github.com/OpenFn/lightning/issues/1853)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix scrolling behaviour on inspector for small screens\n [#1962](https://github.com/OpenFn/lightning/issues/1962)\n- Fix project picker for users with many projects\n [#1952](https://github.com/OpenFn/lightning/issues/1952)\n\n## [v2.3.0] - 2024-04-02","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Support for additional paths on a webhook URL such as `/i/ /Patient`\n [#1954](https://github.com/OpenFn/lightning/issues/1954)\n- Support for a GET endpoint to \"check\" webhook URL availability\n [#1063](https://github.com/OpenFn/lightning/issues/1063)\n- Allow external apps to control the run enqueue db transaction\n [#1958](https://github.com/OpenFn/lightning/issues/1958)\n\n## [v2.2.2] - 2024-04-01","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Changed dataclip search from string `LIKE` to tsvector on keys and values.\n While this will limit partial string matching to the beginning of words (not\n the middle or end) it will make searching way more performant\n [#1939](https://github.com/OpenFn/lightning/issues/1939)\n- Translate job error messages using errors.po file\n [#1935](https://github.com/OpenFn/lightning/issues/1935)\n- Improve the UI/UX of the run panel on the inspector for small screens\n [#1909](https://github.com/OpenFn/lightning/issues/1909)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Regular database timeouts when searching across dataclip bodies\n [#1794](https://github.com/OpenFn/lightning/issues/1794)\n\n## [v2.2.1] - 2024-03-27","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Enable users to connect to their Github accounts in preparation for\n streamlined GitHub project sync setup\n [#1894](https://github.com/OpenFn/lightning/issues/1894)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Apply usage limit to bulk-reruns\n [#1931](https://github.com/OpenFn/lightning/issues/1931)\n- Fix edge case that could result in duplicate usage tracking submissions.\n [#1853](https://github.com/OpenFn/lightning/issues/1853)\n- Fix query timeout issue on history retention deletion\n [#1937](https://github.com/OpenFn/lightning/issues/1937)\n\n## [v2.2.0] - 2024-03-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow admins to set project retention periods\n [#1760](https://github.com/OpenFn/lightning/issues/1760)\n- Automatically wipe input/output data after their retention period\n [#1762](https://github.com/OpenFn/lightning/issues/1762)\n- Automatically delete work order history after their retention period\n [#1761](https://github.com/OpenFn/lightning/issues/1761)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- When automatically creating a project for a newly registered user (via the\n `INIT_PROJECT_FOR_NEW_USER=true` environment variable) that user should be the\n `owner` of the project.\n [#1927](https://github.com/OpenFn/lightning/issues/1927)\n- Give priority to manual runs (over webhook requests and cron) so that active\n users on the inspector don't have to wait ages for thier work during high load\n periods [#1918](https://github.com/OpenFn/lightning/issues/1918)\n\n## [v2.1.0] - 2024-03-20","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- TSVector index to log_lines, and gin index to dataclips\n [#1898](https://github.com/OpenFn/lightning/issues/1898)\n- Add API Version field to Salesforce OAuth credentials\n [#1838](https://github.com/OpenFn/lightning/issues/1838)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Replace v1 usage tracking with v2 usage tracking.\n [#1853](https://github.com/OpenFn/lightning/issues/1853)\n\n## [v2.0.10]","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Updated anonymous usage tracker submissions\n [#1853](https://github.com/OpenFn/lightning/issues/1853)\n\n## [v2.0.9] - 2024-03-19","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Support for smaller screens on history and inspector.\n [#1908](https://github.com/OpenFn/lightning/issues/1908)\n- Polling metric to track number of available runs.\n [#1790](https://github.com/OpenFn/lightning/issues/1790)\n- Allows limiting creation of new runs and retries.\n [#1754](https://github.com/OpenFn/Lightning/issues/1754)\n- Add specific messages for log, input, and output tabs when a run is lost\n [#1757](https://github.com/OpenFn/lightning/issues/1757)\n- Soft and hard limits for runs created by webhook trigger.\n [#1859](https://github.com/OpenFn/Lightning/issues/1859)\n- Publish an event when a new user is registered\n [#1873](https://github.com/OpenFn/lightning/issues/1873)\n- Adds ability to add project collaborators from existing users\n [#1836](https://github.com/OpenFn/lightning/issues/1836)\n- Added ability to remove project collaborators\n [#1837](https://github.com/OpenFn/lightning/issues/1837)\n- Added new usage tracking submission code.\n [#1853](https://github.com/OpenFn/lightning/issues/1853)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Upgrade Elixir to 1.16.2\n- Remove all values from `.env.example`.\n [#1904](https://github.com/OpenFn/lightning/issues/1904)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Verify only stale project credentials\n [#1861](https://github.com/OpenFn/lightning/issues/1861)\n\n## [v2.0.8] - 2024-02-29","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Show flash error when editing stale project credentials\n [#1795](https://github.com/OpenFn/lightning/issues/1795)\n- Fixed bug with Github sync installation on docker-based deployments\n [#1845](https://github.com/OpenFn/lightning/issues/1845)\n\n## [v2.0.6] - 2024-02-29","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Automatically create Github workflows in a target repository/branch when users\n set up a Github repo::OpenFn project sync\n [#1046](https://github.com/OpenFn/lightning/issues/1046)\n- Allows limiting creation of new runs and retries.\n [#1754](https://github.com/OpenFn/Lightning/issues/1754)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Change bucket size used by the run queue delay custom metric.\n [#1790](https://github.com/OpenFn/lightning/issues/1790)\n- Require setting `IS_RESETTABLE_DEMO` to \"yes\" via ENV before allowing the\n destructive `Demo.reset_demo/0` function from being called.\n [#1720](https://github.com/OpenFn/lightning/issues/1720)\n- Remove version display condition that was redundant due to shadowing\n [#1819](https://github.com/OpenFn/lightning/issues/1819)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix series of sentry issues related to OAuth credentials\n [#1799](https://github.com/OpenFn/lightning/issues/1799)\n\n## [v2.0.5] - 2024-02-25","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed error in Credentials without `sanbox` field set; only display `sandbox`\n field for Salesforce oauth credentials.\n [#1798](https://github.com/OpenFn/lightning/issues/1798)\n\n## [v2.0.4] - 2024-02-24","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Display and edit OAuth credentials\n scopes[#1706](https://github.com/OpenFn/Lightning/issues/1706)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Stop sending `operating_system_detail` to the usage tracker\n [#1785](https://github.com/OpenFn/lightning/issues/1785)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Make handling of usage tracking errors more robust.\n [#1787](https://github.com/OpenFn/lightning/issues/1787)\n- Fix inspector shows selected dataclip as wiped after retying workorder from a\n non-first step [#1780](https://github.com/OpenFn/lightning/issues/1780)\n\n## [v2.0.3] - 2024-02-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Actual metrics will now be submitted by Lightning to the Usage Tracker.\n [#1742](https://github.com/OpenFn/lightning/issues/1742)\n- Added a support link to the menu that goes to the instance admin contact\n [#1783](https://github.com/OpenFn/lightning/issues/1783)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Usage Tracking submissions are now opt-out, rather than opt-in. Hashed UUIDs\n to ensure anonymity are default.\n [#1742](https://github.com/OpenFn/lightning/issues/1742)\n- Usage Tracking submissions will now run daily rather than hourly.\n [#1742](https://github.com/OpenFn/lightning/issues/1742)\n\n- Bumped @openfn/ws-worker to `v1.0` (this is used in dev mode when starting the\n worker from your mix app: `RTM=true iex -S mix phx.server`)\n- Bumped @openfn/cli to `v1.0` (this is used for adaptor docs and magic)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Non-responsive workflow canvas after web socket disconnection\n [#1750](https://github.com/OpenFn/lightning/issues/1750)\n\n## [v2.0.2] - 2024-02-14","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed a bug with the OAuth2 credential refresh flow that prevented\n GoogleSheets jobs from running after token expiration\n [#1735](https://github.com/OpenFn/Lightning/issues/1735)\n\n## [v2.0.1] - 2024-02-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Renamed ImpactTracking to UsageTracking\n [#1729](https://github.com/OpenFn/lightning/issues/1729)\n- Block github installation if there's a pending installation in another project\n [#1731](https://github.com/OpenFn/Lightning/issues/1731)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Expand work order button balloons randomly\n [#1737](https://github.com/OpenFn/Lightning/issues/1737)\n- Editing credentials doesn't work from project scope\n [#1743](https://github.com/OpenFn/Lightning/issues/1743)\n\n## [v2.0.0] - 2024-02-10\n\n> At the time of writing there are no more big changes planned and testing has\n> gone well. Thanks to everyone who's helped to kick the tyres during the \"rc\"\n> phase. There are still a _lot of **new features** coming_, so please:\n>\n> - watch our [**Public Roadmap**](https://github.com/orgs/OpenFn/projects/3) to\n> stay abreast of our core team's backlog,\n> - request a feature in the\n> [**Community Forum**](https://community.openfn.org),\n> - raise a\n> [**new issue**](https://github.com/OpenFn/lightning/issues/new/choose) if\n> you spot a bug,\n> - and head over to the\n> [**Contributing**](https://github.com/OpenFn/lightning/?tab=readme-ov-file#contribute-to-this-project)\n> section to lend a hand.\n>\n> Head to [**docs.openfn.org**](https://docs.openfn.org) for product\n> documentation and help with v1 to v2 migration.","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Bump `@openfn/worker` to `v0.8.1`\n- Only show GoogleSheets and Salesforce credential options if Oauth clients are\n registered with the instance via ENV\n [#1734](https://github.com/OpenFn/Lightning/issues/1734)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Use standard table type for webhook auth methods\n [#1514](https://github.com/OpenFn/Lightning/issues/1514)\n- Make disabled button for \"Connect to GitHub\" clear, add tooltip\n [#1732](https://github.com/OpenFn/Lightning/issues/1715)\n\n## [v2.0.0-rc12] - 2024-02-09","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add RunQueue extension to allow claim customization.\n [#1715](https://github.com/OpenFn/Lightning/issues/1715)\n- Add support for Salesforce OAuth2 credentials\n [#1633](https://github.com/OpenFn/Lightning/issues/1633)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Use `PAYLOAD_SIZE_KB` in k6 load testing script, set thresholds on wait time,\n set default payload size to `2kb`","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Adds more detail to work order states on dashboard\n [#1677](https://github.com/OpenFn/lightning/issues/1677)\n- Fix Output & Logs in inspector fails to show sometimes\n [#1702](https://github.com/OpenFn/lightning/issues/1702)\n\n## [v2.0.0-rc11] - 2024-02-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Bumped Phoenix LiveView from `0.20.4` to `0.20.5` to fix canvas selection\n issue [#1724](https://github.com/OpenFn/lightning/issues/1724)\n\n## [v2.0.0-rc10] - 2024-02-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Implemented safeguards to prevent deletion of jobs with associated run history\n [#1570](https://github.com/OpenFn/Lightning/issues/1570)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed inspector dataclip body not getting updated after dataclip is wiped\n [#1718](https://github.com/OpenFn/Lightning/issues/1718)\n- Fixed work orders getting retried despite having wiped dataclips\n [#1721](https://github.com/OpenFn/Lightning/issues/1721)\n\n## [v2.0.0-rc9] 2024-02-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Persist impact tracking configuration and reports\n [#1684](https://github.com/OpenFn/Lightning/issues/1684)\n- Add zero-persistence project setting\n [#1209](https://github.com/OpenFn/Lightning/issues/1209)\n- Wipe dataclip after use when zero-persistence is enabled\n [#1212](https://github.com/OpenFn/Lightning/issues/1212)\n- Show appropriate message when a wiped dataclip is viewed\n [#1211](https://github.com/OpenFn/Lightning/issues/1211)\n- Disable selecting work orders having wiped dataclips in the history page\n [#1210](https://github.com/OpenFn/Lightning/issues/1210)\n- Hide rerun button in inspector when the selected step has a wiped dataclip\n [#1639](https://github.com/OpenFn/Lightning/issues/1639)\n- Add rate limiter to webhook endpoints and runtime limiter for runs.\n [#639](https://github.com/OpenFn/Lightning/issues/639)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Prevented secret scrubber from over-eagerly adding \\*\\*\\* between all\n characters if an empty string secret was provided as a credential field value\n (e.g., {\"username\": \"come-on-in\", \"password\": \"\"})\n [#1585](https://github.com/OpenFn/Lightning/issues/1585)\n- Fixed permissions issue that allowed viewer/editor to modify webhook auth\n methods. These permissions only belong to project owners and admins\n [#1692](https://github.com/OpenFn/Lightning/issues/1692)\n- Fixed bug that was duplicating inbound http_requests, resulting in unnecessary\n data storage [#1695](https://github.com/OpenFn/Lightning/issues/1695)\n- Fixed permissions issue that allowed editors to set up new Github connections\n [#1703](https://github.com/OpenFn/Lightning/issues/1703)\n- Fixed permissions issue that allowed viewers to initiate syncs to github\n [#1704](https://github.com/OpenFn/Lightning/issues/1704)\n- Fixed inspector view stuck at processing when following a crashed run\n [#1711](https://github.com/OpenFn/Lightning/issues/1711)\n- Fixed inspector dataclip selector not getting updated after running manual run\n [#1714](https://github.com/OpenFn/Lightning/issues/1714)\n\n## [v2.0.0-rc8] - 2024-01-30","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Shim code to interact with the Impact Tracking service\n [#1671](https://github.com/OpenFn/Lightning/issues/1671)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Standardized naming of \"attempts\" to \"runs\". This had already been done in the\n front-end, but this change cleans up the backend, the database, and the\n interface with the worker. Make sure to **run migrations** and update your\n ENV/secrets to use `WORKER_RUNS_PRIVATE_KEY` rather than\n `WORKER_ATTEMPTS_PRIVATE_KEY`\n [#1657](https://github.com/OpenFn/Lightning/issues/1657)\n- Required `@openfn/ws-worker@0.8.0` or above.\n\n## [v2.0.0-rc7] - 2024-01-26","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Store webhook request headers in Dataclips for use in jobs.\n [#1638](https://github.com/OpenFn/Lightning/issues/1638)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Display `http_request` dataclips to the user as they will be provided to the\n worker as \"input\" state to avoid confusion while writing jobs.\n [1664](https://github.com/OpenFn/Lightning/issues/1664)\n- Named-spaced all worker environment variables with `WORKER_` and added\n documentation for how to configure them.\n [#1672](https://github.com/OpenFn/Lightning/pull/1672)\n- Bumped to `@openfn/ws-worker@0.6.0`\n- Bumped to `@openfn/cli@0.4.15`","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix Run via Docker [#1653](https://github.com/OpenFn/Lightning/issues/1653)\n- Fix remaining warnings, enable \"warnings as errors\"\n [#1642](https://github.com/OpenFn/Lightning/issues/1642)\n- Fix workflow dashboard bug when viewed for newly created workflows with only\n unfinished run steps. [#1674](https://github.com/OpenFn/Lightning/issues/1674)\n\n## [v2.0.0-rc5] - 2024-01-22","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Made two significant backend changes that don't impact UI/UX but **require\n migrations** and should make Lightning developer lives easier by updating\n parts of the backend to match terms now used in the frontend:\n - Renamed the `Runs` model and table to `Steps`\n [#1571](https://github.com/OpenFn/Lightning/issues/1571)\n - Renamed the `AttemptRuns` model and table to `AttemptSteps`\n [#1571](https://github.com/OpenFn/Lightning/issues/1571)\n\n## [v2.0.0-rc4] - 2024-01-19","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Scrub output dataclips in the UI to avoid unintentional secret exposure\n [#1606](https://github.com/OpenFn/Lightning/issues/1606)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Bump to `@openfn/cli@0.4.14`\n- Do not persist the active tab setting on the job editor\n [#1504](https://github.com/OpenFn/Lightning/issues/1504)\n- Make condition label optional\n [#1648](https://github.com/OpenFn/Lightning/issues/1648)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix credential body getting leaked to sentry incase of errors\n [#1600](https://github.com/OpenFn/Lightning/issues/1600)\n- Fixed validation on Javascript edge conditions\n [#1602](https://github.com/OpenFn/Lightning/issues/1602)\n- Removed unused code from `run_live` directory\n [#1625](https://github.com/OpenFn/Lightning/issues/1625)\n- Edge condition expressions not correctly being handled during provisioning\n [#openfn/kit#560](https://github.com/OpenFn/kit/pull/560)\n\n## [v2.0.0-rc3] 2024-01-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Custom metric to track stalled attempts\n [#1559](https://github.com/OpenFn/Lightning/issues/1559)\n- Dashboard with project and workflow stats\n [#755](https://github.com/OpenFn/Lightning/issues/755)\n- Add search by ID on the history page\n [#1468](https://github.com/OpenFn/Lightning/issues/1468)\n- Custom metric to support autoscaling\n [#1607](https://github.com/OpenFn/Lightning/issues/1607)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped CLI version to `0.4.13`\n- Bumped worker version to `0.5.0`\n- Give project editors and viewers read only access to project settings instead\n [#1477](https://github.com/OpenFn/Lightning/issues/1477)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Throw an error when Lightning.MetadataService.get_adaptor_path/1 returns an\n adaptor path that is nil\n [#1601](https://github.com/OpenFn/Lightning/issues/1601)\n- Fix failure due to creating work order from a newly created job\n [#1572](https://github.com/OpenFn/Lightning/issues/1572)\n- Fixes on the dashboard and links\n [#1610](https://github.com/OpenFn/Lightning/issues/1610) and\n [#1608](https://github.com/OpenFn/Lightning/issues/1608)\n\n## [2.0.0-rc2] - 2024-01-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Restored left-alignment for step list items on run detail and inspector\n [a6e4ada](https://github.com/OpenFn/Lightning/commit/a6e4adafd558269cfd690e7c4fdd8f9fe66c5f62)\n- Inspector: fixed attempt/run language for \"skipped\" tooltip\n [fd7dd0c](https://github.com/OpenFn/Lightning/commit/fd7dd0ca8128dfba2902e5aa6a2259e2073f0f10)\n- Inspector: fixed failure to save during \"save & run\" from inspector\n [#1596](https://github.com/OpenFn/Lightning/issues/1596)\n- Inspector: fixed key bindings for save & run (retry vs. new work order)\n getting overridden when user focuses on the Monaco editor\n [#1596](https://github.com/OpenFn/Lightning/issues/1596)\n\n## [2.0.0-rc1] - 2024-01-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Why does this repo go from `v0` to `v2.0`? - Changelog","doc":"Lightning is the _2nd version_ of the OpenFn platform. While much of the core\ntechnology is the same, there are breaking changes between `v1.105` (pre-2024)\nand `v2` (\"OpenFn Lightning\").\n\nFor customers using OpenFn `v1`, a migration guide will be provided at\n[docs.openfn.org](https://docs.openfn.org)","ref":"changelog.html#why-does-this-repo-go-from-v0-to-v2-0"},{"type":"extras","title":"Added - Changelog","doc":"- Link to the job inspctor for a selected run from the history interface\n [#1524](https://github.com/OpenFn/Lightning/issues/1524)\n- Reprocess an existing work order from the job inspector by default (instead of\n always creating a new work order)\n [#1524](https://github.com/OpenFn/Lightning/issues/1524)\n- Bumped worker to support edge conditions between trigger and first job\n `\"@openfn/ws-worker\": \"^0.4.0\"`","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Updated naming to prepare for v2 release\n [#1248](https://github.com/OpenFn/Lightning/issues/1248); the major change is\n that each time a work order (the typical unit of business value for an\n organization, e.g. \"execute workflow ABC for patient 123\") is executed, it is\n called a \"run\". Previously, it was called an \"attempt\". The hierarchy is now:\n\n ```\n Build-Time: Projects > Workflows > Steps\n Run-Time: Work Orders > Runs > Steps\n ```\n\n Note the name changes here are reflected in the UI, but not all tables/models\n will be changed until [1571](https://github.com/OpenFn/Lightning/issues/1571)\n is delivered.\n\n## [v0.12.2] - 2023-12-24","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Bumped worker to address occasional git install issue\n `\"@openfn/ws-worker\": \"^0.3.2\"`","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix RuntimeError: found duplicate ID \"google-sheets-inner-form\" for\n GoogleSheetsComponent [#1578](https://github.com/OpenFn/Lightning/issues/1578)\n- Extend export script to include new JS expression edge type\n [#1540](https://github.com/OpenFn/Lightning/issues/1540)\n- Fix regression for attempt viewer log line highlighting\n [#1589](https://github.com/OpenFn/Lightning/issues/1589)\n\n## [v0.12.1] - 2023-12-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Hide project security setting tab from non-authorized users\n [#1477](https://github.com/OpenFn/Lightning/issues/1477)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- History page crashes if job is removed from workflow after it's been run\n [#1568](https://github.com/OpenFn/Lightning/issues/1568)\n\n## [v0.12.0] - 2023-12-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add ellipsis for long job names on the canvas\n [#1217](https://github.com/OpenFn/Lightning/issues/1217)\n- Fix Credential Creation Page UI\n [#1064](https://github.com/OpenFn/Lightning/issues/1064)\n- Custom metric to track Attempt queue delay\n [#1556](https://github.com/OpenFn/Lightning/issues/1556)\n- Expand work order row when a `workorder_id` is specified in the filter\n [#1515](https://github.com/OpenFn/Lightning/issues/1515)\n- Allow Javascript expressions as conditions for edges\n [#1498](https://github.com/OpenFn/Lightning/issues/1498)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Derive dataclip in inspector from the attempt & step\n [#1551](https://github.com/OpenFn/Lightning/issues/1551)\n- Updated CLI to 0.4.10 (fixes logging)\n- Changed UserBackupToken model to use UTC timestamps (6563cb77)\n- Restore FK relationship between `work_orders` and `attempts` pending a\n decision re: further partitioning.\n [#1254](https://github.com/OpenFn/Lightning/issues/1254)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- New credential doesn't appear in inspector until refresh\n [#1531](https://github.com/OpenFn/Lightning/issues/1531)\n- Metadata not refreshing when credential is updated\n [#791](https://github.com/OpenFn/Lightning/issues/791)\n- Adjusted z-index for Monaco Editor's sibling element to resolve layout\n conflict [#1329](https://github.com/OpenFn/Lightning/issues/1329)\n- Demo script sets up example Runs with their log lines in a consistant order.\n [#1487](https://github.com/OpenFn/Lightning/issues/1487)\n- Initial credential creation `changes` show `after` as `null` rather a value\n [#1118](https://github.com/OpenFn/Lightning/issues/1118)\n- AttemptViewer flashing/rerendering when Jobs are running\n [#1550](https://github.com/OpenFn/Lightning/issues/1550)\n- Not able to create a new Job when clicking the Check icon on the placeholder\n [#1537](https://github.com/OpenFn/Lightning/issues/1537)\n- Improve selection logic on WorkflowDiagram\n [#1220](https://github.com/OpenFn/Lightning/issues/1220)\n\n## [v0.11.0] - 2023-12-06","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Improved UI when manually creating Attempts via the Job Editor\n [#1474](https://github.com/OpenFn/Lightning/issues/1474)\n- Increased the maximum inbound webhook request size to 10MB and added\n protection against _very large_ payloads with a 100MB \"max_skip_body_length\"\n [#1247](https://github.com/OpenFn/Lightning/issues/1247)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Use the internal port of the web container for the worker configuration in\n docker-compose setup. [#1485](https://github.com/OpenFn/Lightning/pull/1485)\n\n## [v0.10.6] - 2023-12-05","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Limit entries count on term work orders search\n [#1461](https://github.com/OpenFn/Lightning/issues/1461)\n- Scrub log lines using multiple credentials samples\n [#1519](https://github.com/OpenFn/Lightning/issues/1519)\n- Remove custom telemetry plumbing.\n [1259](https://github.com/OpenFn/Lightning/issues/1259)\n- Enhance UX to prevent modal closure when Monaco/Dataclip editor is focused\n [#1510](https://github.com/OpenFn/Lightning/pull/1510)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Use checkbox on boolean credential fields rather than a text input field\n [#1430](https://github.com/OpenFn/Lightning/issues/1430)\n- Allow users to retry work orders that failed before their first run was\n created [#1417](https://github.com/OpenFn/Lightning/issues/1417)\n- Fix to ensure webhook auth modal is closed when cancel or close are selected.\n [#1508](https://github.com/OpenFn/Lightning/issues/1508)\n- Enable user to reauthorize and obtain a new refresh token.\n [#1495](https://github.com/OpenFn/Lightning/issues/1495)\n- Save credential body with types declared on schema\n [#1518](https://github.com/OpenFn/Lightning/issues/1518)\n\n## [v0.10.5] - 2023-12-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Only add history page filters when needed for simpler multi-select status\n interface and shorter page URLs\n [#1331](https://github.com/OpenFn/Lightning/issues/1331)\n- Use dynamic Endpoint config only on prod\n [#1435](https://github.com/OpenFn/Lightning/issues/1435)\n- Validate schema field with any of expected values\n [#1502](https://github.com/OpenFn/Lightning/issues/1502)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix for liveview crash when token expires or gets deleted after mount\n [#1318](https://github.com/OpenFn/Lightning/issues/1318)\n- Remove two obsolete methods related to Run: `Lightning.Invocation.delete_run`\n and `Lightning.Invocation.Run.new_from`.\n [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Remove obsolete field `previous_id` from `runs` table.\n [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Fix for missing data in 'created' audit trail events for webhook auth methods\n [#1500](https://github.com/OpenFn/Lightning/issues/1500)\n\n## [v0.10.4] - 2023-11-30","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Increased History search timeout to 30s\n [#1461](https://github.com/OpenFn/Lightning/issues/1461)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Tooltip text clears later than the background\n [#1094](https://github.com/OpenFn/Lightning/issues/1094)\n- Temporary fix to superuser UI for managing project users\n [#1145](https://github.com/OpenFn/Lightning/issues/1145)\n- Fix for adding ellipses on credential info on job editor heading\n [#1428](https://github.com/OpenFn/Lightning/issues/1428)\n\n## [v0.10.3] - 2023-11-28","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Dimmed/greyed out triggers and edges on the canvas when they are disabled\n [#1464](https://github.com/OpenFn/Lightning/issues/1464)\n- Async loading on the history page to improve UX on long DB queries\n [#1279](https://github.com/OpenFn/Lightning/issues/1279)\n- Audit trail events for webhook auth (deletion method) change\n [#1165](https://github.com/OpenFn/Lightning/issues/1165)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Sort project collaborators by first name\n [#1326](https://github.com/OpenFn/Lightning/issues/1326)\n- Work orders will now be set in a \"pending\" state when retries are enqueued.\n [#1340](https://github.com/OpenFn/Lightning/issues/1340)\n- Avoid printing 2FA codes by default\n [#1322](https://github.com/OpenFn/Lightning/issues/1322)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Create new workflow button sizing regression\n [#1405](https://github.com/OpenFn/Lightning/issues/1405)\n- Google credential creation and automatic closing of oAuth tab\n [#1109](https://github.com/OpenFn/Lightning/issues/1109)\n- Exporting project breaks the navigation of the page\n [#1440](https://github.com/OpenFn/Lightning/issues/1440)\n\n## [v0.10.2] - 2023-11-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Added `max_frame_size` to the Cowboy websockets protocol options in an attempt\n to address [#1421](https://github.com/OpenFn/Lightning/issues/1421)\n\n## [v0.10.1] - 2023-11-21","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Work Order ID was not displayed properly in history page\n [#1423](https://github.com/OpenFn/Lightning/issues/1423)\n\n## [v0.10.0] - 2023-11-21","ref":"changelog.html#fixed"},{"type":"extras","title":"🚨 Breaking change warning! 🚨 - Changelog","doc":"This release will contain breaking changes as we've significantly improved both\nthe workflow building and execution systems.\n\n#### Nodes and edges\n\nBefore, workflows were represented as a list of jobs and triggers. For greater\nflexibility and control of complex workflows, we've moved towards a more robust\n\"nodes and edges\" approach. Where jobs in a workflow (a node) can be connected\nby edges.\n\nTriggers still exist, but live \"outside\" the directed acyclic graph (DAG) and\nare used to automatically create work orders and attempts.\n\nWe've provided migrations that bring `v0.9.3` workflows in line with the\n`v0.10.0` requirements.\n\n#### Scalable workers\n\nBefore, Lightning spawned child processes to execute attempts in sand-boxed\nNodeVMs on the same server. This created inefficiencies and security\nvulnerabilities. Now, the Lightning web server adds attempts to a queue and\nmultiple worker applications can pull from that queue to process work.\n\nIn dev mode, this all happens automatically and on one machine, but in most\nhigh-availability production environments the workers will be on another server.\n\nAttempts are now handled entirely by the workers, and they report back to\nLightning. Exit reasons, final attempt states, error types and error messages\nare either entirely new or handled differently now, but we have provided\nmigration scripts that will work to bring _most_ `v0.9.3` runs, attempts, and\nwork orders up to `v0.10.0`, though the granularity of `v0.9.3` states and exits\nwill be less than `v0.10.0` and the final states are not guaranteed to be\naccurate for workflows with multiple branches and leaf nodes with varying exit\nreasons.\n\nThe migration scripts can be run with a single function call in SetupUtils from\na connect `iex` session:\n\n```\nLightning.SetupUtils.approximate_state_for_attempts_and_workorders()\n```\n\nNote that (like lots of _other_ functionality in `SetupUtils`, calling this\nfunction is a destructive action and you should only do it if you've backed up\nyour data and you know what you're doing.)\n\nAs always, we recommend backing up your data before migrating. (And thanks for\nbearing with us as we move towards our first stable Lightning release.)","ref":"changelog.html#breaking-change-warning"},{"type":"extras","title":"Added - Changelog","doc":"- Fix flaky job name input behavior on error\n [#1218](https://github.com/OpenFn/Lightning/issues/1218)\n- Added a hover effect on copy and add button for adaptors examples\n [#1297](https://github.com/OpenFn/Lightning/issues/1297)\n- Migration helper code to move from `v0.9.3` to `v0.10.0` added to SetupUtils\n [#1363](https://github.com/OpenFn/Lightning/issues/1363)\n- Option to start with `RTM=false iex -S mix phx.server` for opting out of the\n dev-mode automatic runtime manager.\n- Webhook Authentication Methods database and CRUD operations\n [#1152](https://github.com/OpenFn/Lightning/issues/1152)\n- Creation and Edit of webhook webhook authentication methods UI\n [#1149](https://github.com/OpenFn/Lightning/issues/1149)\n- Add webhook authentication methods overview methods in the canvas\n [#1153](https://github.com/OpenFn/Lightning/issues/1153)\n- Add icon on the canvas for triggers that have authentication enabled\n [#1157](https://github.com/OpenFn/Lightning/issues/1157)\n- Require password/2FA code before showing password and API Key for webhook auth\n methods [#1200](https://github.com/OpenFn/Lightning/issues/1200)\n- Restrict live dashboard access to only superusers, enable DB information and\n OS information [#1170](https://github.com/OpenFn/Lightning/issues/1170) OS\n information [#1170](https://github.com/OpenFn/Lightning/issues/1170)\n- Expose additional metrics to LiveDashboard\n [#1171](https://github.com/OpenFn/Lightning/issues/1171)\n- Add plumbing to dump Lightning metrics during load testing\n [#1178](https://github.com/OpenFn/Lightning/issues/1178)\n- Allow for heavier payloads during load testing\n [#1179](https://github.com/OpenFn/Lightning/issues/1179)\n- Add dynamic delay to help mitigate flickering test\n [#1195](https://github.com/OpenFn/Lightning/issues/1195)\n- Add a OpenTelemetry trace example\n [#1189](https://github.com/OpenFn/Lightning/issues/1189)\n- Add plumbing to support the use of PromEx\n [#1199](https://github.com/OpenFn/Lightning/issues/1199)\n- Add warning text to PromEx config\n [#1222](https://github.com/OpenFn/Lightning/issues/1222)\n- Track and filter on webhook controller state in :telemetry metrics\n [#1192](https://github.com/OpenFn/Lightning/issues/1192)\n- Secure PromEx metrics endpoint by default\n [#1223](https://github.com/OpenFn/Lightning/issues/1223)\n- Partition `log_lines` table based on `attempt_id`\n [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Remove foreign key from `attempts` in preparation for partitioning\n `work_orders` [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Remove `Workflows.delete_workflow`. It is no longer in use and would require\n modification to not leave orphaned attempts given the removal of the foreign\n key from `attempts`. [#1254](https://github.com/OpenFn/Lightning/issues/1254)\n- Show tooltip for cloned runs in history page\n [#1327](https://github.com/OpenFn/Lightning/issues/1327)\n- Have user create workflow name before moving to the canvas\n [#1103](https://github.com/OpenFn/Lightning/issues/1103)\n- Allow PromEx authorization to be disabled\n [#1483](https://github.com/OpenFn/Lightning/issues/1483)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Updated vulnerable JS libraries, `postcss` and `semver`\n [#1176](https://github.com/OpenFn/Lightning/issues/1176)\n- Update \"Delete\" to \"Delete Job\" on Job panel and include javascript deletion\n confirmation [#1105](https://github.com/OpenFn/Lightning/issues/1105)\n- Move \"Enabled\" property from \"Jobs\" to \"Edges\"\n [#895](https://github.com/OpenFn/Lightning/issues/895)\n- Incorrect wording on the \"Delete\" tooltip\n [#1313](https://github.com/OpenFn/Lightning/issues/1313)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed janitor lost query calculation\n [#1400](https://github.com/OpenFn/Lightning/issues/1400)\n- Adaptor icons load gracefully\n [#1140](https://github.com/OpenFn/Lightning/issues/1140)\n- Selected dataclip gets lost when starting a manual work order from the\n inspector interface [#1283](https://github.com/OpenFn/Lightning/issues/1283)\n- Ensure that the whole edge when selected is highlighted\n [#1160](https://github.com/OpenFn/Lightning/issues/1160)\n- Fix \"Reconfigure Github\" button in Project Settings\n [#1386](https://github.com/OpenFn/Lightning/issues/1386)\n- Make janitor also clean up runs inside an attempt\n [#1348](https://github.com/OpenFn/Lightning/issues/1348)\n- Modify CompleteRun to return error changeset when run not found\n [#1393](https://github.com/OpenFn/Lightning/issues/1393)\n- Drop invocation reasons from DB\n [#1412](https://github.com/OpenFn/Lightning/issues/1412)\n- Fix inconsistency in ordering of child nodes in the workflow diagram\n [#1406](https://github.com/OpenFn/Lightning/issues/1406)\n\n## [v0.9.3] - 2023-09-27","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add ellipsis when adaptor name is longer than the container allows\n [#1095](https://github.com/OpenFn/Lightning/issues/1095)\n- Webhook Authentication Methods database and CRUD operations\n [#1152](https://github.com/OpenFn/Lightning/issues/1152)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Prevent deletion of first job of a workflow\n [#1097](https://github.com/OpenFn/Lightning/issues/1097)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix long name on workflow cards\n [#1102](https://github.com/OpenFn/Lightning/issues/1102)\n- Fix highlighted Edge can get out of sync with selected Edge\n [#1099](https://github.com/OpenFn/Lightning/issues/1099)\n- Creating a new user without a password fails and there is no user feedback\n [#731](https://github.com/OpenFn/Lightning/issues/731)\n- Crash when setting up version control\n [#1112](https://github.com/OpenFn/Lightning/issues/1112)\n\n## [v0.9.2] - 2023-09-20","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add \"esc\" key binding to close job inspector modal\n [#1069](https://github.com/OpenFn/Lightning/issues/1069)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Save icons from the `adaptors` repo locally and load them in the job editor\n [#943](https://github.com/OpenFn/Lightning/issues/943)\n\n## [v0.9.1] - 2023-09-19","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Modified audit trail to handle lots of different kind of audit events\n [#271](https://github.com/OpenFn/Lightning/issues/271)/[#44](https://github.com/OpenFn/Lightning/issues/44)\n- Fix randomly unresponsive job panel after job deletion\n [#1113](https://github.com/OpenFn/Lightning/issues/1113)\n\n## [v0.9.0] - 2023-09-15","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Add favicons [#1079](https://github.com/OpenFn/Lightning/issues/1079)\n- Validate job name in placeholder job node\n [#1021](https://github.com/OpenFn/Lightning/issues/1021)\n- Bring credential delete in line with new GDPR interpretation\n [#802](https://github.com/OpenFn/Lightning/issues/802)\n- Make job names unique per workflow\n [#1053](https://github.com/OpenFn/Lightning/issues/1053)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Enhanced the job editor/inspector interface\n [#1025](https://github.com/OpenFn/Lightning/issues/1025)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Finished run never appears in inspector when it fails\n [#1084](https://github.com/OpenFn/Lightning/issues/1084)\n- Cannot delete some credentials via web UI\n [#1072](https://github.com/OpenFn/Lightning/issues/1072)\n- Stopped the History table from jumping when re-running a job\n [#1100](https://github.com/OpenFn/Lightning/issues/1100)\n- Fixed the \"+\" button when adding a job to a workflow\n [#1093](https://github.com/OpenFn/Lightning/issues/1093)\n\n## [v0.8.3] - 2023-09-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Render error when workflow diagram node is invalid\n [#956](https://github.com/OpenFn/Lightning/issues/956)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Restyle history table [#1029](https://github.com/OpenFn/Lightning/issues/1029)\n- Moved Filter and Search controls to the top of the history page\n [#1027](https://github.com/OpenFn/Lightning/issues/1027)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Output incorrectly shows \"this run failed\" when the run hasn't yet finished\n [#1048](https://github.com/OpenFn/Lightning/issues/1048)\n- Wrong label for workflow card timestamp\n [#1022](https://github.com/OpenFn/Lightning/issues/1022)\n\n## [v0.8.2] - 2023-08-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Lack of differentiation between top of job editor modal and top menu was\n disorienting. Added shadow.\n\n## [v0.8.1] - 2023-08-31","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Moved Save and Run button to bottom of the Job edit modal\n [#1026](https://github.com/OpenFn/Lightning/issues/1026)\n- Allow a manual work order to save the workflow before creating the work order\n [#959](https://github.com/OpenFn/Lightning/issues/959)\n\n## [v0.8.0] - 2023-08-31","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Introduces Github sync feature, users can now setup our github app on their\n instance and sync projects using our latest portability spec\n [#970](https://github.com/OpenFn/Lightning/issues/970)\n- Support Backup Codes for Multi-Factor Authentication\n [937](https://github.com/OpenFn/Lightning/issues/937)\n- Log a warning in the console when the Editor/docs component is given latest\n [#958](https://github.com/OpenFn/Lightning/issues/958)\n- Improve feedback when a Workflow name is invalid\n [#961](https://github.com/OpenFn/Lightning/issues/961)\n- Show that the jobs' body is invalid\n [#957](https://github.com/OpenFn/Lightning/issues/957)\n- Reimplement skipped CredentialLive tests\n [#962](https://github.com/OpenFn/Lightning/issues/962)\n- Reimplement skipped WorkflowLive.IndexTest test\n [#964](https://github.com/OpenFn/Lightning/issues/964)\n- Show GitHub installation ID and repo link to help setup/debugging for version\n control [1059](https://github.com/OpenFn/Lightning/issues/1059)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed issue where job names were being incorrectly hyphenated during\n project.yaml export [#1050](https://github.com/OpenFn/Lightning/issues/1050)\n- Allows the demo script to set a project id during creation to help with cli\n deploy/pull/Github integration testing.\n- Fixed demo project_repo_connection failing after nightly demo resets\n [1058](https://github.com/OpenFn/Lightning/issues/1058)\n- Fixed an issue where the monaco suggestion tooltip was offset from the main\n editor [1030](https://github.com/OpenFn/Lightning/issues/1030)\n\n## [v0.7.3] - 2023-08-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Version control in project settings is now named Export your project\n [#1015](https://github.com/OpenFn/Lightning/issues/1015)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Tooltip for credential select in Job Edit form is cut off\n [#972](https://github.com/OpenFn/Lightning/issues/972)\n- Dataclip type and state assembly notice for creating new dataclip dropped\n during refactor [#975](https://github.com/OpenFn/Lightning/issues/975)\n\n## [v0.7.2] - 2023-08-10","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- NodeJs security patch [1009](https://github.com/OpenFn/Lightning/pull/1009)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"## [v0.7.1] - 2023-08-04","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed flickery icons on new workflow job creation.\n\n## [v0.7.0] - 2023-08-04","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Project owners can require MFA for their users\n [892](https://github.com/OpenFn/Lightning/issues/892)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Moved to Elixir 1.15 and Erlang 26.0.2 to sort our an annoying ElixirLS issue\n that was slowing down our engineers.\n- Update Debian base to use bookworm (Debian 12) for our Docker images\n- Change new credential modal to take up less space on the screen\n [#931](https://github.com/OpenFn/Lightning/issues/931)\n- Placeholder nodes are now purely handled client-side","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fix issue creating a new credential from the Job editor where the new\n credential was not being set on the job.\n [#951](https://github.com/OpenFn/Lightning/issues/951)\n- Fix issue where checking a credential type radio button shows as unchecked on\n first click. [#976](https://github.com/OpenFn/Lightning/issues/976)\n- Return the pre-filled workflow names\n [#971](https://github.com/OpenFn/Lightning/issues/971)\n- Fix version reporting and external reset_demo() call via\n Application.spec()[#1010](https://github.com/OpenFn/Lightning/issues/1010)\n- Fixed issue where entering a placeholder name through the form would result an\n in unsaveable workflow\n [#1001](https://github.com/OpenFn/Lightning/issues/1001)\n- Ensure the DownloadController checks for authentication and authorisation.\n\n## [v0.7.0-pre5] - 2023-07-28","ref":"changelog.html#fixed"},{"type":"extras","title":"Changed - Changelog","doc":"- Unless otherwise specified, only show work orders with activity in last 14\n days [#968](https://github.com/OpenFn/Lightning/issues/968)\n\n## [v0.7.0-pre4] - 2023-07-27","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- Don't add cast fragments if the search_term is nil\n [#968](https://github.com/OpenFn/Lightning/issues/968)\n\n## [v0.7.0-pre3] - 2023-07-26","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed an issue with newly created edges that prevented downstream jobs\n [977](https://github.com/OpenFn/Lightning/issues/977)\n\n## [v0.7.0-pre2] - 2023-07-26\n\nNote that this is a pre-release with a couple of known bugs that are tracked in\nthe Nodes and Edges [epic](https://github.com/OpenFn/Lightning/issues/793).","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added ability for a user to enable MFA on their account; using 2FA apps like\n Authy, Google Authenticator etc\n [#890](https://github.com/OpenFn/Lightning/issues/890)\n- Write/run sql script to convert triggers\n [#875](https://github.com/OpenFn/Lightning/issues/875)\n- Export projects as `.yaml` via UI\n [#249](https://github.com/OpenFn/Lightning/issues/249)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- In `v0.7.0` we change the underlying workflow building and execution\n infrastructure to align with a standard \"nodes and edges\" design for directed\n acyclic graphs (DAGs). Make sure to run the migrations!\n [793](https://github.com/OpenFn/Lightning/issues/793)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Propagate url pushState/changes to Workflow Diagram selection\n [#944](https://github.com/OpenFn/Lightning/issues/944)\n- Fix issue when deleting nodes from the workflow editor\n [#830](https://github.com/OpenFn/Lightning/issues/830)\n- Fix issue when clicking a trigger on a new/unsaved workflow\n [#954](https://github.com/OpenFn/Lightning/issues/954)\n\n## [0.6.7] - 2023-07-13","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add feature to bulk rerun work orders from a specific step in their workflow;\n e.g., \"rerun these 50 work orders, starting each at step 4.\"\n [#906](https://github.com/OpenFn/Lightning/pull/906)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Oban exception: \"value too long\" when log lines are longer than 255 chars\n [#929](https://github.com/OpenFn/Lightning/issues/929)\n\n## [0.6.6] - 2023-06-30","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add public API token to the demo site setup script\n- Check and renew OAuth credentials when running a job\n [#646](https://github.com/OpenFn/Lightning/issues/646)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Remove google sheets from adaptors list until supporting oauth flow\n [#792](https://github.com/OpenFn/Lightning/issues/792)\n- Remove duplicate google sheets adaptor display on credential type picklist\n [#663](https://github.com/OpenFn/Lightning/issues/663)\n- Fix demo setup script for calling from outside the app on Kubernetes\n deployments [#917](https://github.com/OpenFn/Lightning/issues/917)\n\n## [0.6.5] - 2023-06-22","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Ability to rerun work orders from start by selecting one of more of them from\n the History page and clicking the \"Rerun\" button.\n [#659](https://github.com/OpenFn/Lightning/issues/659)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Example runs for demo incorrect\n [#856](https://github.com/OpenFn/Lightning/issues/856)\n\n## [0.6.3] - 2023-06-15","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Prevent saving null log lines to the database, fix issue with run display\n [#866](https://github.com/OpenFn/Lightning/issues/866)\n\n## [0.6.2] - 2023-06-09","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed viewer permissions for delete workflow\n\n- Fixed bug with workflow cards\n [#859](https://github.com/OpenFn/Lightning/issues/859)\n\n## [0.6.1] - 2023-06-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed bug with run logs [#864](https://github.com/OpenFn/Lightning/issues/864)\n\n- Correctly stagger demo runs to maintain order\n [#856](https://github.com/OpenFn/Lightning/issues/856)\n- Remove `Timex` use from `SetupUtils` in favor of `DateTime` to fix issue when\n calling it in escript.\n\n## [0.6.0]- 2023-04-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Create sample runs when generating sample workflow\n [#821](https://github.com/OpenFn/Lightning/issues/821)\n- Added a provisioning api for creating and updating projects and their\n workflows See: [PROVISIONING.md](./PROVISIONING.md)\n [#641](https://github.com/OpenFn/Lightning/issues/641)\n- Add ability for a `superuser` to schedule deletion, cancel deletion, and\n delete projects [#757](https://github.com/OpenFn/Lightning/issues/757)\n- Add ability for a `project owner` to schedule deletion, cancel deletion, and\n delete projects [#746](https://github.com/OpenFn/Lightning/issues/746)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Ability to store run log lines as rows in a separate table\n [#514](https://github.com/OpenFn/Lightning/issues/514)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Incorrect project digest queries\n [#768](https://github.com/OpenFn/Lightning/issues/768)]\n- Fix issue when purging deleted users\n [#747](https://github.com/OpenFn/Lightning/issues/747)\n- Generate a random name for Workflows when creating one via the UI.\n [#828](https://github.com/OpenFn/Lightning/issues/828)\n- Handle error when deleting a job with runs.\n [#814](https://github.com/OpenFn/Lightning/issues/814)\n\n## [0.5.2]","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add `workflow_edges` table in preparation for new workflow editor\n implementation [#794](https://github.com/OpenFn/Lightning/issues/794)\n- Stamped `credential_id` on run directly for easier auditing of the history\n interface. Admins can now see which credential was used to run a run.\n [#800](https://github.com/OpenFn/Lightning/issues/800)\n- Better errors when using magic functions: \"no magic yet\" and \"check\n credential\" [#812](https://github.com/OpenFn/Lightning/issues/812)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- The `delete-project` function now delete all associated activities\n [#759](https://github.com/OpenFn/Lightning/issues/759)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"## [0.5.1] - 2023-04-12","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added ability to create and revoke personal API tokens\n [#147](https://github.com/OpenFn/Lightning/issues/147)\n- Add `last-used at` to API tokens\n [#722](https://github.com/OpenFn/Lightning/issues/722)\n- Improved \"save\" for job builder; users can now press `Ctrl + S` or `⌘ + S` to\n save new or updated jobs job panel will _not_ close. (Click elsewhere in the\n canvas or click the \"Close\" button to close.)\n [#568](https://github.com/OpenFn/Lightning/issues/568)\n- Add filtered search params to the history page URL\n [#660](https://github.com/OpenFn/Lightning/issues/660)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- The secret scrubber now ignores booleans\n [690](https://github.com/OpenFn/Lightning/issues/690)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- The secret scrubber now properly handles integer secrets from credentials\n [690](https://github.com/OpenFn/Lightning/issues/690)\n- Updated describe-package dependency, fixing sparkles in adaptor-docs\n [657](https://github.com/OpenFn/Lightning/issues/657)\n- Clicks on the workflow canvas were not lining up with the nodes users clicked\n on; they are now [733](https://github.com/OpenFn/Lightning/issues/733)\n- Job panel behaves better when collapsed\n [774](https://github.com/OpenFn/Lightning/issues/774)\n\n## [0.5.0] - 2023-04-03","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Magic functions that fetch real metadata from connected systems via\n `credentials` and suggest completions in the job builder (e.g., pressing\n `control-space` when setting the `orgUnit` attribute for a DHIS2 create\n operation will pull the _actual_ list of orgUnits with human readable labels\n and fill in their orgUnit codes upon\n enter.)[670](https://github.com/OpenFn/Lightning/issues/670)\n- A \"metadata explorer\" to browse actual system metadata for connected\n instances. [658](https://github.com/OpenFn/Lightning/issues/658)\n- Resizable job builder panel for the main canvas/workflow view.\n [681](https://github.com/OpenFn/Lightning/issues/681)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Display timezone for cron schedule—it is always UTC.\n [#716](https://github.com/OpenFn/Lightning/issues/716)\n- Instance administrators can now configure the interval between when a project\n owner or user requests deletion and when these records are purged from the\n database. It defaults to 7, but by providing a `PURGE_DELETED_AFTER_DAYS`\n environment variable the grace period can be altered. Note that setting this\n variable to `0` will make automatic purging _never_ occur but will still make\n \"deleted\" projects and users unavailable. This has been requested by certain\n organizations that must retain audit logs in a Lightning instance.\n [758](https://github.com/OpenFn/Lightning/issues/758)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Locked CLI version to `@openfn/cli@0.0.35`.\n [#761](https://github.com/OpenFn/Lightning/issues/761)\n\n## [0.4.8] - 2023-03-29","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added a test harness for monitoring critical parts of the app using Telemetry\n [#654](https://github.com/OpenFn/Lightning/issues/654)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Set log level to `info` for runs. Most of the `debug` logging is useful for\n the CLI, but not for Lightning. In the future the log level will be\n configurable at instance > project > job level by the `superuser` and any\n project `admin`.\n- Renamed license file so that automagic github icon is less confusing","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Broken links in failure alert email\n [#732](https://github.com/OpenFn/Lightning/issues/732)\n- Registration Submission on app.openfn.org shows internal server error in\n browser [#686](https://github.com/OpenFn/Lightning/issues/686)\n- Run the correct runtime install mix task in `Dockerfile-dev`\n [#541](https://github.com/OpenFn/Lightning/issues/541)\n- Users not disabled when scheduled for deletion\n [#719](https://github.com/OpenFn/Lightning/issues/719)\n\n## [0.4.6] - 2023-03-23","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Implement roles and permissions across entire app\n [#645](https://github.com/OpenFn/Lightning/issues/645)\n- Fix webhook URL\n (`https://< >/i/cae544ab-03dc-4ccc-a09c-fb4edb255d7a`) for the\n OpenHIE demo workflow [448](https://github.com/OpenFn/Lightning/issues/448)\n- Phoenix Storybook for improved component development\n- Load test for webhook endpoint performance\n [#645](https://github.com/OpenFn/Lightning/issues/634)\n- Notify user via email when they're added to a project\n [#306](https://github.com/OpenFn/Lightning/issues/306)\n- Added notify user via email when their account is created\n [#307](https://github.com/OpenFn/Lightning/issues/307)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Improved errors when decoding encryption keys for use with Cloak.\n [#684](https://github.com/OpenFn/Lightning/issues/684)\n- Allow users to run ANY job with a custom input.\n [#629](https://github.com/OpenFn/Lightning/issues/629)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Ensure JSON schema form inputs are in the same order as they are written in\n the schema [#685](https://github.com/OpenFn/Lightning/issues/685)\n\n## [0.4.4] - 2023-03-10","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Users can receive a digest email reporting on a specified project.\n [#638](https://github.com/OpenFn/Lightning/issues/638)\n [#585](https://github.com/OpenFn/Lightning/issues/585)\n\n## [0.4.3] - 2023-03-06","ref":"changelog.html#added"},{"type":"extras","title":"Added - Changelog","doc":"- Tooltips on Job Builder panel\n [#650](https://github.com/OpenFn/Lightning/issues/650)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Upgraded to Phoenix 1.7 (3945856)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Issue with FailureAlerter configuration missing in `prod` mode.\n\n## [0.4.2] - 2023-02-24","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- A user can change their own email\n [#247](https://github.com/OpenFn/Lightning/issues/247)\n- Added a `SCHEMAS_PATH` environment variable to override the default folder\n location for credential schemas\n [#604](https://github.com/OpenFn/Lightning/issues/604)\n- Added the ability to configure Google Sheets credentials\n [#536](https://github.com/OpenFn/Lightning/issues/536)\n- Function to import a project\n [#574](https://github.com/OpenFn/Lightning/issues/574)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Users cannot register if they have not selected the terms and conditions\n [#531](https://github.com/OpenFn/Lightning/issues/531)","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Jobs panel slow for first open after restart\n [#567](https://github.com/OpenFn/Lightning/issues/567)\n\n## [0.4.0] - 2023-02-08","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Added a Delete job button in Inspector\n- Filter workflow runs by text/value in run logs or input body\n- Drop \"configuration\" key from Run output dataclips after completion\n- Ability to 'rerun' a run from the Run list\n- Attempts and Runs update themselves in the Runs list\n- Configure a project and workflow for a new registering user\n- Run a job with a custom input\n- Added plausible analytics\n- Allow user to click on Webhook Trigger Node to copy webhook URL on workflow\n diagram\n- Allow any user to delete a credential that they own\n- Create any credential through a form except for OAuth\n- Refit all diagram nodes on browser and container resize\n- Enable distributed Erlang, allowing any number of redundant Lightning nodes to\n communicate with each other.\n- Users can set up realtime alerts for a project","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Better code-assist and intelliense in the Job Editor\n- Updated @openfn/workflow-diagram to 0.4.0\n- Make plus button part of job nodes in Workflow Diagram\n- Updated @openfn/adaptor-docs to 0.0.5\n- Updated @openfn/describe-package to 0.0.10\n- Create an follow a manual Run from the Job Inspector\n- View all workflows in a project on the workflows index page\n- Move @openfn/workflow-diagram into the application, the NPM module is now\n deprecated.\n- Remove workflow name from first node\n- Move the used parts of `@openfn/engine` into the application.\n- [BREAKING CHANGE] Ported `mix openfn.install.runtime` into application, use\n `mix lightning.install_runtime`.\n- [BREAKING CHANGE] Introduced `@openfn/cli` as the new runtime for Jobs\n- Rename a workflow through the page heading\n- Hide the dataclips tab for beta\n- Make adaptor default to common@latest\n- Remove jobs list page\n- Better error handling in the docs panel\n- Disable credential ownership transfer in dev and prod environments\n- Add project settings page\n- Change Work Order filters to apply to the aggregate state of the work order\n and not the run directly\n- Enable jobs by default\n- Set log level to info\n- Add Beta checkbox to register page\n- User roles and permissions","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Don't consider disabled jobs when calculating subsequent runs\n- Fixed overflow on Job Editor Tooltips\n- Fixed auto-scroll when adding a new snippet in the Job Editor\n- Fixed common operation typings in Job Editor\n\n## [0.3.1] - 2022-11-22","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed bug that tried to execute HTML scripts in dataclips\n- Fixed bug that prevented work orders from displaying in the order of their\n last run, descending.\n- Remove alerts after set timeout or close\n\n## [0.3.0] - 2022-11-21","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Add seed data for demo site\n- Create adaptor credentials through a form\n- Configure cron expressions through a form\n- View runs grouped by work orders and attempts\n- Run an existing Job with any dataclip uuid from the Job form","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Redirect users to projects list page when they click on Admin Settings menu\n- Move job, project, input and output Dataclips to Run table\n- Reverse the relationship between Jobs and Triggers. Triggers now can exist on\n their own; setting the stage for branching and merging workflows\n- Updated Elixir and frontend dependencies\n- [BREAKING CHANGE] Pipeline now uses Work Orders, previous data is not\n compatible.\n- Runs, Dataclips and Attempts now all correctly use `usec` resolution\n timestamps.\n- Upgraded LiveView to 0.18.0\n- Upgraded Elixir to 1.14.1 and OTP 25\n- Workflow Job editor now behaves like a panel\n- Split JobLive.InspectorFormComponent into different plug-able subcomponents\n- Ensure new jobs with cron triggers receive a default frequency\n- Webhooks are now referenced by the trigger id instead of job id.\n- Filter runs by status\n- Filter runs by workflow\n- Filter runs by date\n- View a job run from the runs history\n- View latest matching inputs to run a job with\n\n## [0.2.0] - 2022-09-12","ref":"changelog.html#changed"},{"type":"extras","title":"Changed - Changelog","doc":"- [BREAKING CHANGE] Add `Workflow` model, Jobs now belong to a Workflow This is\n a breaking change to the schema.\n- Use Node.js 18, soon to be in LTS.\n- Visualize success/fail triggers in workflow diagram.\n- Move WorkflowDiagram related actions from DashboardLive into WorkflowLive\n- Move WorkflowDiagram component into liveview, so that we can subscribe to\n channels (i.e. updating of the diagram when someone changes something).\n- Integrate `@openfn/workflow-diagram@0.0.8` and use the new Store interface for\n updating it.\n- Remove `component_mounted` event from WorkflowDiagram hook, using a\n MutationObserver and a Base64 encoded JSON payload.\n- Fixed an issue where the compiler component would try and load a 'nothing\n adaptor', added a condition to check an adaptor is actually selected.\n- Removed previous Workflow CTE queries, replaced by the introduction of the\n Workflow model, see\n (https://github.com/OpenFn/Lightning/blob/53da6883483e7d8d078783f348da327d1dd72d20/lib/lightning/workflows.ex#L111-L119).\n\n## [0.1.13] - 2022-08-29","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Allow administrators to configure OIDC providers for authentication (note that\n this is just for authenticating, not yet for creating new accounts via OIDC)\n- Add Monaco editor to the step/job panel\n- Allow users to delete their own accounts. Schedule their user and credentials\n data for deletion when they do.\n- Allow superusers to delete a user account. Schedule the user's credentials and\n user data for deletion when they do.\n- If a user is scheduled for deletion, disable their account and prevent them\n from logging in.\n- The 'User profile' and 'Credentials' page now have a sidebar menu","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Project users now have one of the following roles: viewer, editor, admin,\n owner\n- Users only have the following roles: user, superuser\n\n## [0.1.12] - 2022-08-15","ref":"changelog.html#changed"},{"type":"extras","title":"Added - Changelog","doc":"- Transfer credential ownership to another user.\n- Create credentials via a form interface\\*\n- Show \"projects with access\" in credentials list view.\n- Show job in runs list and run view.\n- Added roles and permissions to workflows and history page\n [#645](https://github.com/OpenFn/Lightning/issues/645)\n\n\\*The form is defined by a JSON schema provided by an adaptor, in most cases:\ne.g., `language-dhis2` provides a single schema which defines the required\nattributes for `state.configuration`, while `language-common` provides multiple\ncredential schemas like \"oauth\" or \"basic auth\" which define attributes for\n`state.configuration` and which might be used by lots of different jobs.)","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- User menu (top right) appears on top of all other components.\n- User profile screen integrated with the rest of the liveview app.\n\n## [0.1.11] - 2022-08-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed logging in Runner when `:debug` log level used; note that this caused\n crashes in Oban\n\n## [0.1.10] - 2022-08-05","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Credential auditing\n- Build/version information display for easier debugging","ref":"changelog.html#added"},{"type":"extras","title":"Fixed - Changelog","doc":"- Fixed a bug that enqueued cron-triggered jobs even when they were disabled\n\n## [0.1.9] - 2022-07-27","ref":"changelog.html#fixed"},{"type":"extras","title":"Added - Changelog","doc":"- Navigate to user profile or credentials page and log out through the user icon\n dropdown\n- Create and edit dataclips\n- Add a production tag to credentials\n- View a dropdown of operations and their description for the language-common\n `v2.0.0-rc2` adaptor (this pattern to be rolled out across adaptors)","ref":"changelog.html#added"},{"type":"extras","title":"Changed - Changelog","doc":"- Navigate between projects through a project picker on the navbar","ref":"changelog.html#changed"},{"type":"extras","title":"Fixed - Changelog","doc":"- Run Lightning with docker","ref":"changelog.html#fixed"},{"type":"extras","title":"Security - Changelog","doc":"- Sensitive credential values are scrubbed from run logs\n- All credentials are encrypted at REST\n\n## [0.1.7] - 2022-06-24","ref":"changelog.html#security"},{"type":"extras","title":"Added - Changelog","doc":"- Run a job with a cron trigger\n- Queue jobs via Oban/Postgres\n- Edit jobs via the workflow canvas\n\n## [0.1.6] - 2022-06-07","ref":"changelog.html#added"},{"type":"extras","title":"Added - Changelog","doc":"- Register, log in and log out of an account\n- Allow superusers and admin users to create projects\n- Allow admin users to create or disable a user’s account\n- Allow superusers for local deployments to create users and give them access to\n project spaces\n\n- Create and edit a job with a webhook, flow/fail or cron trigger\n- Create and edit credentials for a job\n- Copy a job's webhook URL\n- View all workflows in a project visually\n- Deploy lightning locally with Docker\n\n- Enable a job to automatically process incoming requests\n- Run a job with a webhook or flow/fail trigger\n- View job runs along with their logs, exit code, start and end time\n- View data clips that have initiated job runs (http requests for webhooks, run\n results)","ref":"changelog.html#added"}],"producer":{"name":"ex_doc","version":[48,46,51,52,46,50]},"content_type":"text/markdown"} \ No newline at end of file diff --git a/readme.html b/readme.html index 9b6e36ac4a..8fbf710561 100644 --- a/readme.html +++ b/readme.html @@ -399,7 +399,7 @@

    Problems with Debian

    If you're getting this error on debian

    ==> earmark_parser
-Compiling 1 file (.yrl)
+Compiling 1 file (.yrl)
 /usr/lib/erlang/lib/parsetools-2.3.1/include/yeccpre.hrl: no such file or directory
 could not compile dependency :earmark_parser, "mix compile" failed. You can recompile this dependency with "mix deps.compile earmark_parser", update it with "mix deps.update earmark_parser" or clean it with "mix deps.clean earmark_parser"

    You need to install erlang development environment sudo apt install erlang-dev refer to this issue

    @@ -422,12 +422,12 @@

    Versions

    The build may not work on old versions of Docker and Docker docker compose run --rm web mix ecto.migrate docker compose up -

    Apple Silicon

    When running docker compose up on Apple Silicon (M1, M2, M3), you might encounter the following error:

    > [web 20/20] RUN npm install --prefix assets:
+

    Apple Silicon

    When running docker compose up on Apple Silicon (M1, M2, M3), you might encounter the following error:

    > [web 20/20] RUN npm install --prefix assets:
 0.091 rosetta error: failed to open elf at /lib64/ld-linux-x86-64.so.2
 0.091  Trace/breakpoint trap
 ------
 failed to solve: process "/bin/sh -c npm install --prefix assets" did not complete successfully: exit code: 133

    You can solve this by setting the default docker platform to linux/amd64, i.e. DOCKER_DEFAULT_PLATFORM=linux/amd64. -You can read more on this here: https://stackoverflow.com/questions/71040681/qemu-x86-64-could-not-open-lib64-ld-linux-x86-64-so-2-no-such-file-or-direc

    You might also run into:

    [notice] Application ssl exited: exited in: :ssl_app.start(:normal, [])
+You can read more on this here: https://stackoverflow.com/questions/71040681/qemu-x86-64-could-not-open-lib64-ld-linux-x86-64-so-2-no-such-file-or-direc
    You might also run into:
    [notice] Application ssl exited: exited in: :ssl_app.start(:normal, [])
  ** (EXIT) an exception was raised:
      ** (ArgumentError) could not call Module.put_attribute/3 because the module Lightning.MixProject is already compiled
          (elixir 1.16.2) lib/module.ex:2360: Module.assert_not_readonly!/2
@@ -451,8 +451,8 @@ 
    Versions
    The build may not work on old versions of Docker and Docker
 
     lib/mix/tasks/compile.rambo.ex:89: Mix.Tasks.Compile.Rambo.compile!/0
     lib/mix/tasks/compile.rambo.ex:51: Mix.Tasks.Compile.Rambo.run/1
-    (mix 1.14.2) lib/mix/task.ex:421: anonymous fn/3 in Mix.Task.run_task/4
-    (mix 1.14.2) lib/mix/cli.ex:84: Mix.CLI.run_task/2
    You can resolve this error by installing the Rust compiler using Homebrew. Run
+    (mix 1.14.2) lib/mix/task.ex:421: anonymous fn/3 in Mix.Task.run_task/4
+    (mix 1.14.2) lib/mix/cli.ex:84: Mix.CLI.run_task/2

    You can resolve this error by installing the Rust compiler using Homebrew. Run the following command in your terminal: brew install rust

    If you have already compiled Rambo explicitly via mix compile.rambo, and you are still seeing the following error:

    sh: /path_to_directory/Lightning/_build/dev/lib/rambo/priv/rambo: No such file or directory
 sh: line 0: exec: /path_to_directory/Lightning/_build/dev/lib/rambo/priv/rambo: cannot execute: No such file or directory

    You can try renaming deps/rambo/priv/rambo-mac to deps/rambo/priv/rambo.

    If neither of the approaches above work, please raise an issue.

    diff --git a/search.html b/search.html index a948798ff8..cde193999a 100644 --- a/search.html +++ b/search.html @@ -132,7 +132,7 @@

    - +