module GlobalSession
  module Session
  end
end

require 'global_session/session/abstract'
require 'global_session/session/v1'
require 'global_session/session/v2'
require 'global_session/session/v3'

# Ladies and gentlemen: the one and only, star of the show, GLOBAL SESSION!
#
# Session is designed to act as much like a Hash as possible. You can use
# most of the methods you would use with Hash: [], has_key?, each, etc. It has a
# few additional methods that are specific to itself, mostly involving whether
# it's expired, valid, supports a certain key, etc.
#
# Global sessions are versioned, and each version may have its own encoding
# strategy. This module acts as a namespace for the different versions, each
# of which is represented by a class in the module. They all inherit
# from the abstract base class in order to ensure that they are internally
# compatible with other components of this gem.
#
# This module also acts as a façade for reading global session cookies generated
# by the different versions; it is responsible for detecting the version of
# a given cookie, then instantiating a suitable session object.
module GlobalSession::Session
  # Decode a global session cookie without checking signature or expiration. Good for debugging.
  def self.decode_cookie(cookie)
    guess_version(cookie).decode_cookie(cookie)
  end

  # Decode a global session cookie. Use a heuristic to determine the version.
  # @raise [GlobalSession::MalformedCookie] if the cookie is not a valid serialized global session
  def self.new(directory, cookie=nil, valid_signature_digest=nil)
    guess_version(cookie).new(directory, cookie)
  end

  def self.guess_version(cookie)
    case cookie
    when /^WzM/ # == "[3"
      V3
    when /^l9/  # == binary msgpack symbol for "beginning of array"
      V2
    when /^eN/  # == zlib-compressed form of "{"
      V1
    else
      V1        # due to zlib compression, there might be corner cases with the eN prefix
    end
  end
end