import org.jspecify.annotations.Nullable;

/**
 * A map containing {@code long} values that can be atomically updated. While writes to a
 * traditional {@code Map} rely on {@code put(K, V)}, the typical mechanism for writing to this map
 * is {@code addAndGet(K, long)}, which adds a {@code long} to the value currently associated with
 * {@code K}. If a key has not yet been associated with a value, its implicit value is zero.
 *

    }

    @Test
    @DisplayName("Should handle large session key")
    void testDeriveKeys_LargeSessionKey() {
        // Given
        byte[] largeSessionKey = new byte[256]; // Larger than typical 16-byte key
        new SecureRandom().nextBytes(largeSessionKey);
        int dialect = Smb2Constants.SMB2_DIALECT_0311;

        // When

   * iterable}. The iterator's {@code hasNext()} method returns {@code true} until {@code iterable}
   * is empty.
   *
   * <p><b>Warning:</b> Typical uses of the resulting iterator may produce an infinite loop. You
   * should use an explicit {@code break} or be certain that you will eventually remove all the
   * elements.
   *

        }

        @Test
        @DisplayName("Should work with real-world values")
        void testRealWorldValues() throws SMBProtocolDecodingException {
            // Typical server response after copying chunks
            byte[] buffer = createValidCopyChunkResponse(16, // 16 chunks written
                    1048576, // 1MB per chunk
                    16777216 // 16MB total
            );

 *      * response ([responseFailed])
 *        * headers ([responseHeadersStart], [responseHeadersEnd])
 *        * body ([responseBodyStart], [responseBodyEnd])
 *
 * This nesting is typical but not strict. For example, when calls use "Expect: continue" the
 * request body start and end events occur within the response header events. Similarly,

    /**
     * Sets this request's method to `QUERY`.
     *
     * By default, `QUERY` requests are not cached. You can use [cacheUrlOverride] to specify
     * how to cache them.
     *
     * A typical use case is to hash the request body:
     *
     * ```kotlin
     *     val hash = body.sha256().hex()
     *     val query = Request
     *         .Builder()
     *         .query(body)

     * <table class="striped">
     *   <caption>Output Directory by Scope</caption>
     *   <thead>
     *     <tr>
     *       <th>Scope Parameter</th>
     *       <th>Build Configuration</th>
     *       <th>Typical Path</th>
     *       <th>Contents</th>
     *     </tr>
     *   </thead>
     *   <tbody>
     *     <tr>
     *       <td>{@link ProjectScope#MAIN}</td>

          ),
        signatureValue =
          BitString(
            byteString = signatureBytes,
            unusedBitsCount = 0,
          ),
      ),
    )
  }

  @Test
  fun `decode typical certificate`() {
    val certificateBase64 =
      """
      |MIIHHTCCBgWgAwIBAgIRAL5oALmpH7l6AAAAAFTRMh0wDQYJKoZIhvcNAQELBQAw
      |gboxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQL

            assertArrayEquals(testFileId, emptyNameResponse.getFileId());

            // Test with long fileName
            String longFileName = "a".repeat(255); // Maximum typical filename length
            Smb2CloseResponse longNameResponse = new Smb2CloseResponse(mockConfig, testFileId, longFileName);
            assertEquals(longFileName, longNameResponse.getFileName());

        }
    }

    @Nested
    @DisplayName("Real-world Usage Scenarios")
    class RealWorldUsageTests {

        @Test
        @DisplayName("Should handle typical file system permission scenarios")
        void shouldHandleFileSystemPermissions() {
            // Read-only file access
            int readOnlyMask = ACE.FILE_READ_DATA | ACE.FILE_READ_ATTRIBUTES | ACE.READ_CONTROL;