package io.jawk;
   
   /*-
    * ╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲
    * Jawk
    * ჻჻჻჻჻჻
    * Copyright (C) 2006 - 2026 MetricsHub
    * ჻჻჻჻჻჻
    * This program is free software: you can redistribute it and/or modify
   * it under the terms of the GNU Lesser General Public License as
   * published by the Free Software Foundation, either version 3 of the
   * License, or (at your option) any later version.
   *
   * This program is distributed in the hope that it will be useful,
   * but WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   * GNU General Lesser Public License for more details.
   *
   * You should have received a copy of the GNU General Lesser Public
   * License along with this program.  If not, see
   * <http://www.gnu.org/licenses/lgpl-3.0.html>.
   * ╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱
   */
  
  import java.util.Collection;
  import java.util.List;
  import io.jawk.backend.AVM;
  import io.jawk.backend.SandboxedAVM;
  import io.jawk.ext.JawkExtension;
  import io.jawk.util.AwkSettings;
  import io.jawk.util.ScriptSource;
  
  /**
   * {@link Awk} variant that enforces sandbox restrictions by delegating to the
   * sandbox-specific tuple and runtime implementations.
   */
  public final class SandboxedAwk extends Awk {
  
  	/**
  	 * Creates a sandboxed AWK instance with default settings and no extensions.
  	 */
  	public SandboxedAwk() {
  		super();
  	}
  
  	/**
  	 * Creates a sandboxed AWK instance with the specified settings.
  	 *
  	 * @param settings behavioral configuration for this engine
  	 */
  	public SandboxedAwk(AwkSettings settings) {
  		super(settings);
  	}
  
  	/**
  	 * Creates a sandboxed AWK instance with the supplied extensions.
  	 *
  	 * @param extensions Extension instances to register
  	 */
  	public SandboxedAwk(Collection<? extends JawkExtension> extensions) {
  		super(extensions);
  	}
  
  	/**
  	 * Creates a sandboxed AWK instance with extensions and settings.
  	 *
  	 * @param extensions extension instances
  	 * @param settings behavioral configuration for this engine
  	 */
  	public SandboxedAwk(Collection<? extends JawkExtension> extensions, AwkSettings settings) {
  		super(extensions, settings);
  	}
  
  	/**
  	 * Creates a sandboxed AWK instance with the supplied extensions.
  	 *
  	 * @param extensions Extension instances to register
  	 */
  	@SafeVarargs
  	public SandboxedAwk(JawkExtension... extensions) {
  		super(extensions);
  	}
  
  	@Override
  	public AwkProgram compile(List<ScriptSource> scripts, boolean disableOptimizeParam) throws java.io.IOException {
  		return compileProgram(scripts, disableOptimizeParam, new SandboxedCompiledAwkProgram());
  	}
  
  	@Override
  	public AwkExpression compileExpression(String expression, boolean disableOptimizeParam) throws java.io.IOException {
  		return compileExpression(expression, disableOptimizeParam, new SandboxedCompiledAwkExpression());
  	}
  
  	@Override
  	protected boolean isSourceIncludeAllowed() {
  		return false;
  	}
  
  	@Override
 	public AVM createAvm() {
 		return createAvm(getSettings());
 	}
 
 	@Override
 	public AVM createAvm(boolean profilingEnabled) {
 		return createAvm(getSettings(), profilingEnabled);
 	}
 
 	@Override
 	protected AVM createAvm(AwkSettings settingsParam) {
 		return createAvm(settingsParam, false);
 	}
 
 	@Override
 	protected AVM createAvm(AwkSettings settingsParam, boolean profilingEnabled) {
 		return new SandboxedAVM(settingsParam, getExtensionInstances(), profilingEnabled);
 	}
 }
 
 final class SandboxedCompiledAwkProgram extends AwkProgram {
 	private static final long serialVersionUID = 1L;
 
 	@Override
 	public void printToFile(int numExprs, boolean append) {
 		deny("Output redirection is disabled in sandbox mode");
 	}
 
 	@Override
 	public void printToPipe(int numExprs) {
 		deny("Command execution through pipelines is disabled in sandbox mode");
 	}
 
 	@Override
 	public void printfToFile(int numExprs, boolean append) {
 		deny("Output redirection is disabled in sandbox mode");
 	}
 
 	@Override
 	public void printfToPipe(int numExprs) {
 		deny("Command execution through pipelines is disabled in sandbox mode");
 	}
 
 	@Override
 	public void system() {
 		deny("system() is disabled in sandbox mode");
 	}
 
 	@Override
 	public void useAsCommandInput() {
 		deny("Command execution through pipelines is disabled in sandbox mode");
 	}
 
 	@Override
 	public void useAsFileInput() {
 		deny("Input redirection is disabled in sandbox mode");
 	}
 
 	@Override
 	public void assignARGC() {
 		deny("Assigning to ARGC is disabled in sandbox mode");
 	}
 
 	@Override
 	public void argcOffset(int offset) {
 		// no-op: keep argcOffset at NULL_OFFSET; AVM.getARGC() returns the
 		// command-line argument count when ARGC is not materialized.
 	}
 
 	@Override
 	public void argvOffset(int offset) {
 		// no-op: keep argvOffset at NULL_OFFSET; AVM.getARGV() returns a
 		// synthetic AssocArray when ARGV is not materialized.
 	}
 
 	private static void deny(String message) {
 		throw new AwkSandboxException(message);
 	}
 }
 
 final class SandboxedCompiledAwkExpression extends AwkExpression {
 	private static final long serialVersionUID = 1L;
 
 	@Override
 	public void printToFile(int numExprs, boolean append) {
 		deny("Output redirection is disabled in sandbox mode");
 	}
 
 	@Override
 	public void printToPipe(int numExprs) {
 		deny("Command execution through pipelines is disabled in sandbox mode");
 	}
 
 	@Override
 	public void printfToFile(int numExprs, boolean append) {
 		deny("Output redirection is disabled in sandbox mode");
 	}
 
 	@Override
 	public void printfToPipe(int numExprs) {
 		deny("Command execution through pipelines is disabled in sandbox mode");
 	}
 
 	@Override
 	public void system() {
 		deny("system() is disabled in sandbox mode");
 	}
 
 	@Override
 	public void useAsCommandInput() {
 		deny("Command execution through pipelines is disabled in sandbox mode");
 	}
 
 	@Override
 	public void useAsFileInput() {
 		deny("Input redirection is disabled in sandbox mode");
 	}
 
 	@Override
 	public void assignARGC() {
 		deny("Assigning to ARGC is disabled in sandbox mode");
 	}
 
 	@Override
 	public void argcOffset(int offset) {
 		// no-op: keep argcOffset at NULL_OFFSET; AVM.getARGC() returns the
 		// command-line argument count when ARGC is not materialized.
 	}
 
 	@Override
 	public void argvOffset(int offset) {
 		// no-op: keep argvOffset at NULL_OFFSET; AVM.getARGV() returns a
 		// synthetic AssocArray when ARGV is not materialized.
 	}
 
 	private static void deny(String message) {
 		throw new AwkSandboxException(message);
 	}
 }