Feat/authentication (#2)

* add ability to authneticate to pwpush and review active pushes

* add linting on errors

* catch error

* more info

.github/workflows/build.yml

@@ -16,7 +16,12 @@ jobs:
             - name: Install modules
               shell: pwsh
               run : |
-                Install-Module -Name ModuleBuilder -Force
+                Install-Module -Name ModuleBuilder, PSScriptAnalyzer -Force
+
+            - name: Lint
+              shell: pwsh
+              run : |
+                . ./test/lint.ps1
 
             - name: Build module
               shell: pwsh

src/public/Connect-Pwpush.ps1

@@ -1,4 +1,4 @@
-function Connect-Pwpush
+function Connect-Pwpush
 {
     <#
     .SYNOPSIS
@@ -8,23 +8,31 @@ function Connect-Pwpush
         defaults to pwpush.com server.
     .PARAMETER Server
         Server to connect to to
+    .PARAMETER Credential
+        User email and API token - token can be created at https://pwpush.com/en/users/token
     .EXAMPLE
         Connect-KpPwpush
         Connects to https://pwpush.com server
     #>
-
-
     [cmdletbinding()]
     param(
-        [string]$Server = "https://pwpush.com/"
+        [string]$Server = "https://pwpush.com/",
+
+        [pscredential]$Credential
     )
 
     if ($Server[-1] -eq "/")
     {
-        $Server = $server.Substring(0, $Server.Length - 1) 
+        $Server = $server.Substring(0, $Server.Length - 1)
     }
 
     $Script:Connection = @{
         Server = $server
     }
+
+    if ($PSBoundParameters.ContainsKey('Credential'))
+    {
+        $Script:Connection["userEmail"] = $Credential.UserName
+        $Script:Connection["userToken"] = $Credential.GetNetworkCredential().Password
+    }
 }

src/public/Get-Pwpush.ps1

@@ -1,4 +1,4 @@
-function Get-Pwpush
+function Get-Pwpush
 {
     <#
     .SYNOPSIS
@@ -18,12 +18,12 @@ function Get-Pwpush
         [Parameter(Mandatory)]
         [string]$UrlToken
     )
-    
+
     $endpoint = "p/$($UrlToken).json"
 
     $params = @{
-        Endpoint = $endpoint 
-        Method   = "Get" 
+        Endpoint = $endpoint
+        Method   = "Get"
     }
     Invoke-PwpushRequest @params
 }

src/public/Get-PwpushActive.ps1

@@ -0,0 +1,18 @@
+function Get-PwpushActive
+{
+    <#
+    .SYNOPSIS
+        Returns the list of password pushes that you previously pushed which are still active.
+    #>
+    [cmdletbinding()]
+    param (
+    )
+
+    $endpoint = "p/active.json"
+
+    $params = @{
+        Endpoint = $endpoint
+        Method   = "Get"
+    }
+    Invoke-PwpushRequest @params
+}

src/public/Get-PwpushExpired.ps1

@@ -0,0 +1,18 @@
+function Get-PwpushExpired
+{
+     <#
+    .SYNOPSIS
+        Returns the list of password pushes that you previously pushed which have expired.
+    #>
+    [cmdletbinding()]
+    param (
+    )
+
+    $endpoint = "p/expired.json"
+
+    $params = @{
+        Endpoint = $endpoint
+        Method   = "Get"
+    }
+    Invoke-PwpushRequest @params
+}

src/public/Get-PwpushPreview.ps1

@@ -1,4 +1,4 @@
-function Get-PwpushPreview
+function Get-PwpushPreview
 {
     <#
     .SYNOPSIS
@@ -18,12 +18,12 @@ function Get-PwpushPreview
         [Parameter(Mandatory)]
         [string]$UrlToken
     )
-    
+
     $endpoint = "p/$($UrlToken)/preview.json"
 
     $params = @{
-        Endpoint = $endpoint 
-        Method   = "Get" 
+        Endpoint = $endpoint
+        Method   = "Get"
     }
     Invoke-PwpushRequest @params
 }

src/public/Invoke-PwpushRequest.ps1

@@ -1,10 +1,10 @@
-function Invoke-PwpushRequest
+function Invoke-PwpushRequest
 {
     <#
     .SYNOPSIS
         Main function for interacting with pwpush API
     .DESCRIPTION
-        This function takes care of all headers, pagination, body formatting etc. for pwpush api calls. 
+        This function takes care of all headers, pagination, body formatting etc. for pwpush api calls.
     #>
     [cmdletbinding()]
     param(
@@ -38,7 +38,24 @@ function Invoke-PwpushRequest
         $params.Add("ContentType", "application/json")
     }
 
-    $reposne = Invoke-WebRequest @params
+    if ($Script:Connection.ContainsKey('userEmail'))
+    {
+        $headers = @{
+            "X-User-Email" = $Script:Connection.userEmail
+            "X-User-Token" = $Script:Connection.userToken
+        }
+        $params.Add("headers", $headers)
+    }
+
+    try
+    {
+        $reposne = Invoke-WebRequest @params
+    }
+    catch
+    {
+        throw
+    }
+
     if ($ReturnRaw.IsPresent)
     {
         return $reposne

src/public/New-Pwpush.ps1

@@ -1,4 +1,4 @@
-function New-Pwpush
+function New-Pwpush
 {
     <#
     .SYNOPSIS
@@ -11,26 +11,25 @@ function New-Pwpush
         New-KpPwpush -Payload mySecret
         Creates a new push with payload of mySecret
     #>
-
-
+
     [cmdletbinding()]
     param (
         [Parameter(Mandatory)]
         [string]$Payload,
 
         [string]$Note = "",
-            
+
         [ValidateRange(1, 90)]
         [int]$ExpireAfterDays = 7,
-        
+
         [ValidateRange(1, 100)]
         [int]$ExpireAfterViews = 5,
-        
+
         [bool]$DeletableByViewer = $true,
-        
+
         [bool]$RetrievalStep = $false
     )
-    
+
     $endpoint = "p.json"
 
     $body = @{
@@ -45,8 +44,8 @@ function New-Pwpush
     } | ConvertTo-Json
 
     $params = @{
-        Endpoint = $endpoint 
-        Method   = "Post" 
+        Endpoint = $endpoint
+        Method   = "Post"
         Body     = $body
     }
     Invoke-PwpushRequest @params

test/lint.ps1

@@ -0,0 +1 @@
+Invoke-ScriptAnalyzer -Path "$PSScriptRoot/../src" -Recurse -Severity @("Error")