GPALUrl.cs

// =============================================================================
// GPAL - Generally Positive Automation Library
// Copyright © 2026 Software Decisions, Inc. All rights reserved.
//
// This file is part of GPAL.
// Licensed under the Business Source License 1.1
//
// Primary development, architecture, and vision by Michael B. Vederman,
// CEO of Software Decisions, Inc., Texas.
//
// Internal development maintained privately.
// Public releases appear on GitHub: https://github.com/SoftwareDecisionsInc/GPAL.
//
// See LICENSE for full terms, including Additional Use Grant.
// =============================================================================
 
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using static GenerallyPositive.Enums;
 
// written by grok, modified by mbv
namespace GenerallyPositive.Browser
{
    public class GPALUrl : IGPALUrl
    {
        private string _url;
        private readonly List<StorageAction> _actions = new List<StorageAction>();

        internal GPALUrl(string url = null)
        {
            _url = string.IsNullOrWhiteSpace(url) ? "https://google.com" : url;
        }

        public string Url => _url;

        IReadOnlyList<StorageAction> IGPALUrl.GetActions() => _actions.AsReadOnly();

        public static implicit operator string(GPALUrl url) => url?._url;
 
        private static int implicitCount = 0;

        public static implicit operator GPALUrl(string url)
        {
            GPAL.PublishSimpleEvent(GPALEventType.DEBUG, $"Implicit GPALUrl created for [{url}]");
 
            // emit warning once.
            if (0 == implicitCount++)
                GPAL.PublishSimpleEvent(GPALEventType.DEBUG, $"Implicit GPALUrl conversions lack equality, even if Urls match. Create instance using GPAL.Url for reuse.");
 
            return new GPALUrl(url);
        }

        public IAllowGPALUrlStorageType ForUrl(string url)
        {
            _url = string.IsNullOrWhiteSpace(url) ? "https://google.com" : url;
            return this;
        }

        public IAllowGPALUrlStorageItemConfig WithStorageType(WebsiteStorageType type)
        {
            _actions.Add(new StorageAction { StorageType = type });
            return this;
        }

        public IAllowGPALUrlStorageItemConfig WithStorageData(string data)
        {
            if (_actions.Count == 0 || string.IsNullOrWhiteSpace(data))
                return this;
 
            int lastIndex = _actions.Count - 1;
 
            _actions[lastIndex].Data = data;
 
            return this;
        }

        public IAllowGPALUrlStorageItemConfig WithStorageKey(string key)
        {
            if (_actions.Count == 0 || string.IsNullOrWhiteSpace(key))
                return this;
 
            int lastIndex = _actions.Count - 1;
 
            _actions[lastIndex].Key = key;
 
            return this;
        }

        public IAllowGPALUrlStorageItemConfig WithStoragePath(string path)
        {
            if (_actions.Count == 0 || string.IsNullOrWhiteSpace(path))
                return this;
 
            int lastIndex = _actions.Count - 1;
 
            _actions[lastIndex].Path = path;
 
            return this;
        }

        public IAllowGPALUrlStorageItemConfig WithStorageDomain(string domain)
        {
            if (_actions.Count == 0 || string.IsNullOrWhiteSpace(domain))
                return this;
 
            int lastIndex = _actions.Count - 1;
 
            _actions[lastIndex].Domain = domain;
 
            return this;
        }

        public IAllowGPALUrlStorageItemConfig WithStorageStoreName(string storeName)
        {
            if (_actions.Count == 0 || string.IsNullOrWhiteSpace(storeName))
                return this;
 
            int lastIndex = _actions.Count - 1;
 
            _actions[lastIndex].StoreName = storeName;
 
            return this;
        }

        public IAllowGPALUrlStorageItemConfig WithUserDefined(string userDefined)
        {
            if (_actions.Count == 0 || string.IsNullOrWhiteSpace(userDefined))
                return this;
 
            int lastIndex = _actions.Count - 1;
 
            _actions[lastIndex].UserDefined = userDefined;
 
            return this;
        }
 
        public IAllowGPALUrlStorageItemConfig WithDeleteAcrossOrigins(bool trueOrFalse)
        {
            if (_actions.Count == 0)
                return this;
 
            int lastIndex = _actions.Count - 1;
 
            _actions[lastIndex].DeleteAcrossOrigins = trueOrFalse;
 
            return this;
        }

        public List<StorageAction> Add(StorageAction storageAction)
        {
            _actions.Add(storageAction);
            return _actions;
        }

        public List<StorageAction> Add(List<StorageAction> storageActions)
        {
            _actions.AddRange(storageActions);
            return _actions;
        }

        public IGPALUrl ToGPALObject()
        {
            return this;
        }
    }

    public class StorageAction
    {
        public StorageAction()
        {
        }
 
        public StorageAction(StorageAction action)
        {
            Action = action.Action;
            StorageType = action.StorageType;
            Key = action.Key;
            Path = action.Path;
            Domain = action.Domain;
            StoreName = action.StoreName;
            Data = action.Data;
            IncludeProvenance = action.IncludeProvenance;
        }
        public WebsiteStorageAction Action { get; internal set; } = WebsiteStorageAction.notSet;

        public WebsiteStorageType StorageType { get; internal set; } = WebsiteStorageType.notSet;

        public string Key { get; internal set; }

        public string Path { get; internal set; }

        public string Domain { get; internal set; }

        public string StoreName { get; internal set; }
 
        internal string _data = null;

        public string Data 
        { 
            get => _data; 
            internal set => _data = value; 
        }
        
 
        public bool IncludeProvenance { get; internal set; }    // not currently used (correctly)

        public string UserDefined { get; internal set; }

        public bool DeleteAcrossOrigins { get; internal set; } = false;
    }
}