npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

vue3-session

v1.1.0

Published

A simplistic session plugin for VueJS backed by SessionStorage

Downloads

50

Readme

To install the plugin, do the following:


import VueSession from 'vue-session'
const app = createApp(App); // your normal Vue 3 app code
app.use(VueSession)

Now you can inject this inside your component.

const $session = inject('$vsession');
$session.get('your_key');

Options

VueSession can be started with some options that will change its behavior.

  • persist A Boolean value to determine whether the data stored in the session may persist between tabs and browser instances. Defaults to false.

Pass the options in the use method:

var options = {
    persist: true
}

app.use(VueSession, options)

Reference

  • $session.getAll(), returns all data stored in the Session.
  • $session.set(key,value), sets a single value to the Session.
  • $session.get(key), returns the value attributed to the given key.
  • $session.start(), initializes a session with a 'session-id'. If you attempt to save a value without having started a new session, the plugin will automatically start a new $session.
  • $session.exists(), checks whether a session has been initialized or not.
  • $session.has(key), checks whether the key exists in the Session
  • $session.remove(key), removes the given key from the Session
  • $session.clear(), clear all keys in the Session, except for 'session-id', keeping the Session alive
  • $session.destroy(), destroys the Session
  • $session.id(), returns the 'session-id'
  • $session.renew(session_id), allows a user to renew a previous session by manually inputting the session_id

Flash

Flash allows you to save data until you read them without having to start a regular Session.

  • $session.flash.set(key, value), sets a flash value
  • $session.flash.get(key), reads and removes a flash value
  • $session.flash.remove(key), removes a flash value

Example

Your login method could look like this:

import { inject } from "vue";

export default {
  setup(props, { emit }) { //props, context
    // Inside vue-session we are using provide, so you can inject it further
    // app.provide('$vsession', $vsession);

    const $session = inject('$vsession');
    const handleSubmit = () => {
      // your validation code
      // your method code
      // your API logics...
      
      // sample code
      axios.post(YOUR_API_URL + '?_format=json', JSON.stringify(YOUR_JSON), {
          headers: {
            'Content-Type': 'application/x-www-form-urlencoded',
            'X-CSRF-Token': sessionToken
          },
          withCredentials: true
        })
          .then(userResponse => {
            $session.start()
            $session.set('token', userResponse.csrf_token)
            $session.set('isLoggedIn', true);
            $session.set('uid', userResponse.uid)
            resolve(userResponse)
          })
          .catch(error => {
            // handle any errors
            if (error.response.status == 403) {
              console.log('User already logged in! ' + $session.get('token'))
            }
            let message = error.response.data.message
            reject(message)
          })
    }
    return {
      handleSubmit
    };
}

In your logged-in area, you can check whether or not a session is started and destroy it when the user wants to logout.

const $session = app.config.globalProperties.$vsession
let $uid = $session.get('uid'); // if you ar setting uid while log in action

// or another way
// Helper for checking route auth. Will check if auth is needed,
// redirects to login page is page is restricted.
export const requireAuth = (to, from, next) => {
  if ($session.exists()) {
    if (!$session.get('isLoggedIn')) {
      $session.destroy()
      next('/login')
    } else {
      next()
    }
  } else {
    next('/login')
  }
}

Hope this is helpful ! I am available for any support/consultancy :-)