// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT license.

using System;
using System.Diagnostics.CodeAnalysis;

namespace Microsoft.ClearScript.V8
{
    /// <summary>
    /// Represents a compiled script that can be executed multiple times without recompilation.
    /// </summary>
    public abstract class V8Script : IDisposable
    {
        internal V8Script(UniqueDocumentInfo documentInfo, UIntPtr codeDigest)
        {
            UniqueDocumentInfo = documentInfo;
            CodeDigest = codeDigest;
        }

        /// <summary>
        /// Gets the document name associated with the compiled script.
        /// </summary>
        [Obsolete("Use DocumentInfo instead.")]
        public string Name => UniqueDocumentInfo.UniqueName;

        /// <summary>
        /// Gets the document meta-information for the compiled script.
        /// </summary>
        public DocumentInfo DocumentInfo => UniqueDocumentInfo.Info;

        internal UniqueDocumentInfo UniqueDocumentInfo { get; }

        internal UIntPtr CodeDigest { get; }

        #region IDisposable implementation

        /// <summary>
        /// Releases all resources used by the compiled script.
        /// </summary>
        /// <remarks>
        /// Call <c>Dispose()</c> when you are finished using the compiled script. <c>Dispose()</c>
        /// leaves the compiled script in an unusable state. After calling <c>Dispose()</c>, you
        /// must release all references to the compiled script so the garbage collector can reclaim
        /// the memory that the compiled script was occupying.
        /// </remarks>
        [SuppressMessage("Microsoft.Design", "CA1063:ImplementIDisposableCorrectly", Justification = "This class is almost purely abstract; the implementation class implements disposal.")]
        public abstract void Dispose();

        #endregion
    }
}